롱텀 코파일럿 (Longterm Copilot) — Changelog

본 문서는 PRD 본문 변경과 별도로 구현 정착 history를 박제합니다. PRD docs/PRD.md 문서 이력과 1:1 mirror.

v0.0.15.3 — 2026-05-20

• SEO 종합 보강: 네이버 서치어드바이저·Bing Webmaster 인증 메타 박제 + 4 페이지 title/description/keywords 분화 + JSON-LD 3종 (SoftwareApplication/Organization/FAQPage) + 방문요양 키워드 자연 증강 + AI 크롤러 옵션 3 적용 (GPTBot/ClaudeBot/Google-Extended/PerplexityBot Allow)
• changelog 레이아웃 신설: MarkdownLayout.astro 신규 생성으로 changelog 페이지 SEO 메타 박제 (기존 layout 부재 결함 해소)
• h1 시맨틱 추가: beginner-guide 페이지 .sr-only h1 추가 (시각 디자인 변경 0)

v0.0.15.2 — 2026-05-20

• 도메인 URL 일괄 갱신: longterm-copilot.pages.dev → longterm-copilot.co.kr 전체 치환 (코드·카피·OG 메타태그·CLI 상수 모두 포함)
• CLI cache-busting hotfix: fetchLatestVersion() 버전 조회 URL에 ?t=<unix> 쿼리 부착 — CF edge cache stale로 인한 ltc update 구버전 표시 미세 이슈 해소. vitest 단위 테스트 2 case 추가.
• OG canonical 갱신: og:url / og:image / twitter:image 3종 .co.kr 박제
• 무중단 보장: pages.dev CF Pages 병행 서빙 유지 → 기존 사용자 자동 업데이트 정상 동작

v0.0.15.1 — 2026-05-19 (hotfix)

• install.sh / install.ps1 stale tarball 정리 hotfix: v0.0.15.0의 한 줄 설치 명령이 ~/ltc-bridge/ 내 이전 버전 tarball을 정리하지 않아 npm glob이 구버전을 resolve하던 Critical UX 버그 해소
• 수정 범위: unzip / Expand-Archive 직전 ltc-*.tgz 정리 1줄 추가. 백업 디렉토리 원본 보존 → 롤백 안전
• 사용자 영향: v0.0.15.0 → v0.0.15.1로 한 줄 명령으로 갱신 시 자동으로 stale tarball 정리됨

v0.0.15.0 — 2026-05-19

• 한 줄 설치/업데이트: curl -fsSL https://longterm-copilot.co.kr/install.sh | bash (macOS/Linux) / iex ((iwr https://longterm-copilot.co.kr/install.ps1 -UseBasicParsing).Content) (Windows) — 5단계 수동 절차를 1줄로 대체
• ltc update --apply: 이미 CLI가 설치된 사용자는 이 명령 한 줄로 업데이트 완료. 무옵션 ltc update older 분기에도 “한 줄 업데이트: ltc update —apply” 안내 추가
• auth-bridge binary 자동 동기화: install.sh/ps1가 sha256 검증 + 4 tarball npm install -g 까지 자동 처리
• Claude Desktop 재시작 안내: 설치/업데이트 완료 시 재시작 안내 메시지 자동 출력
• v0.0.15.0 binary 빌드: 4 타겟 (darwin-arm64 / darwin-amd64 / linux-amd64 / windows-amd64) ldflag 박제

v0.0.14.0 — 2026-05-19

• 두 명령 확정 제거 완료: ltc billing / ltc claim-summary CLI 명령 완전 제거 + MCP billing / claim-summary tool 완전 제거 (v0.0.13.0 정식 통지 약속 이행)
• 대체 명령: claim-list, claim-receipt, claim-bill (v0.0.11.1부터 정식 지원)
• rule-engine 비영향: check-billing-readiness, ltc check billing, export --include-billing 정상 동작 유지 — rule-engine 내부 billing mode는 보존됨
• 회귀 0건: claim-detail (scan path buildClaimSummaryBody 보존), check-billing-readiness (rule-engine r3/r4/r5 보존) 정상 동작 확인

v0.0.13.0 — 2026-05-15

• deprecation 강화: ltc billing / ltc claim-summary 경고 텍스트 갱신 — v0.0.14.0에서 확정 제거. 대체: claim-list, claim-receipt, claim-bill
• landing 동기화: claim-summary 예시를 claim-list로 교체 (SectionHowItWorks, install 시나리오)
• MCP tool description: [DEPRECATED v0.0.13.0 — v0.0.14.0 제거 예정] prefix 부착 (Claude Desktop 등 외부 클라이언트 인식)

v0.0.12.0 — 2026-05-15 (기관현황 6탭 + 급여제공기록지 + 직원 디테일 신규)

npra402m01 6탭 통합 + npsb200m01 급여제공기록지 2탭 + staff-detail 신규 + Bug A2 흡수 + M-1/M-2

신규 명령

• ltc institution-info --tab <basic|general|staff|facility|doctor|partner>: 장기요양기관현황 6탭 단일 진입점 (npra402m01). 기본/일반/인력/시설/계약의사/협약기관 탭별 응답.
  • basic: 기관명·대표자·주소·연락처·예금주명 등 기본 정보
  • staff: 직원 1인 1row — 자격증·입사일·퇴직일·복직일·치매교육이수 등
  • facility: 시설 현황 (차량·침실·치매설비, 재가 B01 기관은 일부 빈 응답 정상)
• ltc staff-detail: 직원 디테일 (자격증·입사·퇴직·복직일·치매교육이수 등). --name / --qlf-no 필터 지원.
• ltc service-record --tab <record|print>: npsb200m01 급여제공기록지. 기록 탭(수급자×서비스일자 목록) / 출력 탭(월 단위·서명 확인).

버그 분석 및 Minor 수정

• Bug A2: npra402 전체 14 dataset에 계좌번호 컬럼 미발견 → ltc account는 npja202 단독 유지(Path B). ltc institution-info --tab basic에 예금주명 노출.
• M-1: runClaimStaffDetail RateLimiter 통합 — query-runner 일관성 확보.
• M-2: ltc claim-staff table에 리더기번호/RFID관리번호 컬럼 추가 — claim-staff-detail 2단계 워크플로우 동선 개선.
• 정량: vitest ≥529건 PASS, Go test ≥93건 PASS, 회귀 0건

v0.0.11.2 — 2026-05-15 (hotfix H-1~H-4 closure)

hotfix 4건 처리: claim-staff-detail 신규 명령 + care-plan-mgmt-list fnm fix + care-plan-history Dataset id 확정 + limit-check 인증 패턴 통일

신규 명령

• ltc claim-staff-detail: RFID 특정내역 상세 단건 조회 (npfc624p21 팝업, H-1 closure)
  • 2단계 워크플로우: ltc claim-staff --format json → tag_id/ltcp_offr_yyyymm/reader_no/rfid_adm_no 확인 → ltc claim-staff-detail --tag-id <ID> --offr-yyyymm <YM> --reader-no <NO> --rfid-adm-no <NO>
  • 응답: 17필드 (급여종류, 시작/종료시각, 항목별 제공시간 8종, 특이사항 등)

버그 수정

• H-2: ltc care-plan-mgmt-list “수급자” 컬럼이 실제 수급자명으로 교체 + “급여종류명” 컬럼 분리 노출
• H-3: ltc care-plan-history Dataset id 3-fallback 제거 → ds_npba50 단일 확정 (라이브 확인 2026-05-15)
• H-4: ltc limit-check 요청 본문 ahnlabFlag=Y → N 자동 통일 (14개 endpoint 패턴 일관성 확보)
• 정량: vitest 529건 PASS, Go test ≥73건 PASS, 회귀 0건

v0.0.11.1 — 2026-05-15 (NPBS 인증 세션 본질 fix + 청구 도메인 재설계 + care-plan chain)

사이클 ID: 2026-05-14_v0011-1-expand-claim-chain 목적: NPBS 인증 세션 인프라 재설계(S0’) + 청구 도메인 B/C/D chain 신설(S1/S2) + v0.0.11.0 통합 (publish 보류) 비고: v0.0.11.0은 publish 보류됨 — v0.0.11.1이 첫 공개 배포 버전

주요 변경

• NPBS 인증 세션 본질 fix: selectLoginChk.do 자동 호출, UserContext 35 Col, _USER_IP append, ahnlabFlag N
• 신규 9개 명령: claim-list, claim-receipt, claim-staff, claim-service, claim-pay-data, claim-detail-v2, claim-bill, care-plan-mgmt-list, care-plan-history
• BREAKING: ltc billing / ltc claim-summary deprecate 경고 (v0.0.12.0 제거 예정) — 대체: claim-list, claim-bill
• BREAKING: ltc claim-detail V2 교체 (--recv-no 필수, 구 N+1 스캔 제거)
• claim-receipt 재설계: staff/bill/service/pay-data/detail 통합 view
• check-revenue 5축: claim-progress 신규 추가 — 당월 청구 진행 상태 자동 진단
• D-1: revenue LTCP_CLSFC_CD 한국어 매핑 (방문요양 등 10개 코드)
• D-2: formatDaysUntil NaN 가드 → "-" 반환
• 정량: vitest 526건 PASS, Go test ≥73건 PASS, 회귀 0건

v0.0.11.0 — 2026-05-14 (DEPRECATED — v0.0.11.1로 통합)

사이클 ID: 2026-05-14_v0011-0-expand-claim-chain 목적: 청구 N+1 스캔 제거 + claim 4-chain 신설 + care-plan-mgmt 2 신규 + check-revenue 5축 확장

주요 변경

• 신규 9개 명령: claim-list, claim-receipt, claim-staff, claim-service, claim-pay-data, claim-detail-v2, claim-bill, care-plan-mgmt-list, care-plan-history
• BREAKING: ltc billing / ltc claim-summary deprecate 경고 (v0.0.12.0 제거 예정) — 대체: claim-list, claim-bill
• BREAKING: ltc claim-detail V2 교체 (--recv-no 필수, 구 N+1 스캔 제거)
• check-revenue 5축: claim-progress 신규 추가 — 당월 청구 진행 상태 자동 진단
• D-1: revenue LTCP_CLSFC_CD 한국어 매핑 (방문요양 등 10개 코드)
• D-2: formatDaysUntil NaN 가드 → "-" 반환

v0.0.10.3 — 2026-05-14 (P0 hotfix: NPBS xfdl.js spec 전수 정합 Bug A1~A6 + BREAKING CHANGE)

사이클 ID: 2026-05-14_v0010-3-hotfix-bug-a-eval-schedule 목적: NPBS xfdl.js 직접 추출로 확정된 정답 spec 100% 박제 — revenue/account/debt/refund/eval-result/eval-schedule-regular 6 endpoint 전수 정합

주요 변경

• Bug A1: buildRevenueRequestBody FY → TAX_YYYY — revenue 조회 정상화
• Bug A2: buildAccountRequestBody LTC_ADMIN_SYM → LTCO_MGMT_SYM — account 기관기호 불일치 해소
• Bug A3: buildDebtRequestBody 단일 월 → 기간 범위 (PAY_FR_DT/PAY_TO_DT) BREAKING CHANGE (--year → --from/--to)
• Bug A4: buildRefundRequestBody 단일 월 → 기간 + 페이지네이션 6컬럼 BREAKING CHANGE (--year → --from/--to/--page/--page-size/--first-count)
• Bug A5: buildEvalResultListRequestBody + buildEvalGradeDetailRequestBody 2→7컬럼 정합
• Bug A6: buildEvalScheduleRegularRequestBody 2→4컬럼 정합
• D11 (claim-details N+1): v0.0.11.0 이월 — 본 버전 미변경
• 정량: vitest 505 PASS, Go fixture +6건, 회귀 0건

v0.0.10.2 — 2026-05-13 (P0 hotfix: revenue 3중 결함 + NPBS 비즈니스 에러 처리)

사이클 ID: 2026-05-13_revenue-endpoint-diagnose 목적: revenue 빈 응답 root-cause 진단 + Bug A (LTCO_MGMT_SYM) / Bug B (NPBSBusinessError + 34 mode) / Bug C (4 Dataset ID 정합) 일괄 hotfix

주요 변경

• Bug A: buildRevenueRequestBody / buildRefundRequestBody LTC_ADMIN_SYM → LTCO_MGMT_SYM — NPBS ErrorCode -2 해소
• Bug B: NPBSBusinessError 타입 신설 + fetchAPI ErrorCode 검사 + 34 mode handleFetchError 일괄 적용 + check-* 3룰 NPBS_REJECTED 12분기 + CLI 4 command 한국어 stderr
• Bug C: ParseRevenueXML/AccountXML/DebtXML/RefundXML Dataset ID 정합 (ds_ltcoFyrPayDescList / ds_ltcoPayAct / ds_crditAttaPayDescList / ds_ltcoPayList)
• SectionError: "NPBS_REJECTED" union 추가 (forward-compatible)
• 정량: +549줄/-101줄, 17파일, vitest 489→496 (+7), Go test 21→29 (+8), 회귀 0

v0.0.10.1 — 2026-05-13 (P0 hotfix: parser nil-slice + silent-catch 정책)

사이클 ID: 2026-05-13_v0010-1-parser-silent-fallback 목적: parser.go nil-slice 36건 fix + check-* 3룰 SCHEMA_MISMATCH/NETWORK silent-catch 정책 개선

주요 변경

• parser.go: nil-slice → 빈 슬라이스 초기화 36건 일괄 교체 (NPBS 0행 응답 시 null 직렬화 → [] 보장)
• check- 3룰*: SCHEMA_MISMATCH/NETWORK 12분기 silent-catch + SectionError 타입 신규 + 12 섹션 error? 필드
• 정량: vitest 483→489 PASS (+6), Go test 9→21건 (+12 ZeroRow), 회귀 0

v1.0.5 — 2026-04-30 (V1 출시 정합 사이클)

사이클 ID: 2026-04-30_v1-release-prep (단일 sprint S1) 베이스 commit: 7b04753 (Phase 4.5 hot-fix R2 정착) 목적: Phase 4.5 사이클에서 발견된 V1 출시 차단 4건 일괄 closure → Lite 정식 출시 정합

변경 사항

1. --format hwp|pdf → --ext hwp|pdf + 출력 확장자 자동 추론

• 위치: PRD §4-1-2 L278 / apps/ltc-cli/src/commands/draft.ts:108~150
• 사유: commander 12 sub-command 옵션 propagation 충돌 — parent draft --format hwp|pdf와 sub list-templates --format table|json|csv가 동일 옵션 이름 충돌. parent의 parseDraftFormat parser가 sub의 --format json 입력을 가로채 INVALID_ARG throw.
• 해결: parent의 --format 을 --ext로 rename + --output 확장자에서 자동 추론 (.pdf → pdf, .hwp → hwp). 명시 --ext 옵션도 fallback으로 지원.
• UX 영향: 동등 — ltc draft care-plan L123 --output /tmp/x.pdf 가 자동 PDF 출력. --ext pdf 명시도 가능.
• PRD 정정 entry: §4-1-2 amendment 박제

2. MCP tool 카운트 22→32 → 31 정정

• 위치: PRD §4-1-3 / apps/ltc-mcp/src/tools/registry.ts
• 사유: v1.0.4 명시 22→32은 baseline 22를 가정한 산수 오류. v1.0.3 baseline 21 (Phase 1·2·3 누계: whoami + doctor + 19 read-only) + Phase 4 5 룰 점검 + Phase 4.5 5 문서 입출력 = 31 정착.
• 해결: PRD §4-1-3 31로 정정 + 박제 (tools.length === 31 vitest 박제됨, tools-document.test.ts 검증 PASS)

3. mcp:write-document audit umbrella maskRecursive 적용

• 위치: apps/ltc-mcp/src/tools/write-document.ts umbrella audit args_json 빌드
• 사유: variable-resolver layer는 runQuery 호출 시 자동 마스킹 (Phase 1 S4) but umbrella audit는 별도 layer라 raw ltc_mgmt_no 노출. ~/.ltc/audit.sqlite 또는 ltc audit list/export 간접 노출 경로 박제됨.
• 해결: JSON.stringify(maskRecursive({ template_id, ltc_mgmt_no, format, output_path })) 적용. PII 4 키 정책 정합 (ltc_mgmt_no snake_case 매칭 → maskLtcMgmtNo).
• vitest: tools-document.test.ts +1 케이스 (umbrella audit args 마스킹 박제)

4. pii-detector RRN regex boundary 강화

• 위치: packages/ltc-core/src/document/pii-detector.ts:33~37
• 사유: actual_start / actual_end 응답이 20240409123045 형식 14자리 datetime인데 RRN 정규식 /\d{6}-?[1-4]\d{6}\b/g이 앞 13자리에 false positive 매칭. 라이브 검증에서 박제 (실제시작: 2XXXXXX-X******).
• 해결: lookbehind/lookahead boundary (?<!\d)\d{6}-?[1-4]\d{6}(?!\d) 적용. datetime 14자리는 매칭 회피, 정상 RRN 13자리는 매칭 보존.
• 호환성: Node 8.10+ lookbehind 지원, Node 22.17 정합.
• vitest: pii-detector.test.ts +2 케이스 (datetime 0 매칭 / 정상 RRN 1 매칭 회귀)

5. variable-resolver schema-driven npbs_dependencies 마이그레이션

• 위치: packages/ltc-types/src/index.ts Template.npbs_dependencies? 필드 추가 + packages/ltc-core/src/templates/variable-resolver.ts 리팩터
• 사유: Phase 4.5 hot-fix R2에서 PLAN_ID_USING_ENDPOINTS / PLAN_ID_REQUIRED_ENDPOINTS set을 hardcoded로 도입. T6 (claim-detail receipt-no), V1.5+ 확장 시 코드 변경 필요.
• 해결: Template schema에 npbs_dependencies: NpbsDependency[] 필드 추가. variable-resolver가 정의 lookup → prefetch + 인자 자동 주입 chain 자동 생성.
• 마이그레이션: T1 care-plan + T9 service-record-visit-nurse 정의에 npbs_dependencies 박제. 다른 11 정의는 영향 0.
• 하위 호환: hot-fix R2 5 vitest 케이스 mock 갱신 후 모두 PASS.

정량 결과

• vitest: 301 → ~305+ PASS (+4 신규 hot-fix 케이스)
• CLI: 32 (변경 0)
• MCP: 31 (변경 0, 카운트 정정만)
• 회귀: 0건
• commit 1건 정착: b65fe14 (feat: V1 출시 정합 — 차단 4건 closure)

다음 단계

• Phase 5 진입 (Bedrock + RAG KB) — 외부 게이트 4건 (Bedrock 가용성 / 개보법 자문 / 도메인 / 코드사이닝) 추적 후 진입
• 랜딩페이지 정적 사이트 구현 (선택, claude.ai/design 시안 정착 후)

v1.0.4 — 2026-04-30 (Phase 4.5 마감)

자세한 내용은 PRD docs/PRD.md 문서 이력 v1.0.4 entry 참조. 핵심:

• HWP/PDF 입출력 + 105 서식 템플릿 Lite 영역 통합
• CLI 5종 + MCP 5 tool + Phase 4.5 신설 (3 sprint)
• rhwp@0.7.8 + pdf-parse + pdf-lib 통합 (Mac arm64 + Node 22 검증)
• 신규 위험 2건 (첨부 문서 PII / rhwp 라이선스)

정착 commits

• d41a249 Phase 4.5 S1 — HWP/PDF 라이브러리 통합 + PII detector
• 4735832 Phase 4.5 NotoSansKR-Regular.ttf 폰트 통합 + OFL 라이선스
• 9415292 Phase 4.5 S2 — 105 서식 카탈로그 + V1 13종 + variable-resolver
• de808ea Phase 4.5 S3 — CLI 4 + MCP 5 tool + 강화된 개보법 고지 (consent v2)
• 7b04753 Phase 4.5 S3 R2 hot-fix — variable-resolver multi-step + 본문 직접 작성

v1.0.3 — 2026-04-27

PRD §4-1-2 조회 명령 18→22 확장, 룰 5→9개, draft 5→6종. RAG KB 2026 신수가표 통합. 외부 게이트에 급여자료 보존기한 확인 추가.

v1.0.2 — 2026-04-27

Codex CLI MCP 공식 지원 확인 후 리스크 강등 (🟡→🟢).

v1.0.1 — 2026-04-27

Lite의 BYOL(Bring Your Own LLM) 정책 명시. MCP 클라이언트 1차/2차 지원 등급 도입.

v1.0 — 2026-04-23

초안 작성. PRD docs/PRD.md 본문 참조.

본 CHANGELOG는 /dev-cycle 사이클 종료 시 자동 갱신 (사이클 commit 정착 시점에 entry 추가).