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

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

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 추가).