기존 월정산 초안 lifecycle을 종합 정산으로 확장하고 여섯 총계·명시적 cashflow 정책·당시 근거를 같은 run에 원자적으로 고정 저장합니다.
환급월의 음수 지출, 명시적 저축 분류 목록, 대출상환 지출, 이체/상품권 충전 제외 우선, 미분류 승인 차단을 공통 service에서 처리합니다.
저장 헤더/양 상세/근거를 승인 결과와 대조하고 불일치·중간 실패를 전체 롤백합니다. 불변 replay와 append-only 정정, exact-run 조회를 유지합니다.
schema 14의 additive/idempotent 이관은 legacy 미보존 총계를 NULL로 남깁니다. 기존 자산 직접 API의 세 총계와 live 보고 의미는 유지합니다.
MCP 신규 도구와 인증된 Dashboard는 같은 service/read model을 사용합니다. 읽기 no-create/auth-before-DB와 민감 근거 allowlist를 유지합니다.
문서와 계약
승인된 다섯 문서를 update-in-place했습니다. 기존 38개 요구/AC ID와 9개 global 의미 단위, Issue의 12개 포함 항목을 대응했고 AC18–27을 추가했습니다. 구현 PR 번호 #19를 canonical requirement metadata와 두 계약 테스트에 정확히 반영했습니다.
command/exit/output/environment/timeout/termination/source 결속은 위 manifest의 claim pointers로 확인합니다. Same-UID read-only reviewer 접근은 reviewer-access-receipt.json으로 확인하며, 다른 host/UID의 공개 다운로드 권한은 주장하지 않습니다.
4개 skip은 기존 sample PDF/password 부재입니다. 1개 warning은 기존 Starlette/httpx deprecation입니다. AppTest를 실제 Chromium 검증과 동등하다고 주장하지 않습니다.
전달 경계
Issue 전용 branch의 non-force 전달입니다. PR merge, Issue close, release/deploy는 수행하지 않습니다. 원격 branch/PR head는 별도 authoritative readback으로 기록합니다.
F-002: 저장 헤더의 제외·이월·승인 근거를 기존 strict public projection으로 additive 반환하고, 월정산 저장 패널에 표시했습니다. 실제 schema-13 기준 commit API로 생성한 조건부 마감 DB를 이관하여 원래 asset report 보존·exact/latest 일치·조회 no-write를 검증했습니다.
기존 507개 test ID 보존, 6개 추가; 삭제·skip/xfail 변경 없음. 계약 보존 inventory 113개 의미 단위. 최종 독립 specification/code-security 정적 검토 및 source hash 대조: 차단 지적 없음. Privacy 문서 지적은 named RED→GREEN으로 해결했습니다.
ZIP SHA-256: 8633cab871737f4f950d85cf65f38b4f9456db306310c525bd2f5071fe669ee1; 인증된 원격 다운로드 readback 일치.
manifest SHA-256: ab19e42dd541060c5dd7c0cdcf48fa0b2b82bb33df2dc3460c767607ea0b04fa; plan SHA-256: fcb48c89681403bdb029924290621773334ac8e2281d6761ca71aa5e653b0b5b. ZIP의 exact/evidence-manifest.json에 full SHA·실제 argv·exit·환경·출력·timeout·termination이 결속되어 있습니다.
AppTest/실제 SQLite/MCP 검증이며 실제 Chromium 완료를 주장하지 않습니다. 기존 4개 skip 및 1개 deprecation warning은 실행 기록에 보존했습니다.
기존 REQUEST_CHANGES review는 유지되며 최종 head의 새 검토가 필요합니다. Merge, Issue 변경, release/deploy는 하지 않습니다.
Closes #18
## 구현
- 기존 월정산 초안 lifecycle을 종합 정산으로 확장하고 여섯 총계·명시적 cashflow 정책·당시 근거를 같은 run에 원자적으로 고정 저장합니다.
- 환급월의 음수 지출, 명시적 저축 분류 목록, 대출상환 지출, 이체/상품권 충전 제외 우선, 미분류 승인 차단을 공통 service에서 처리합니다.
- 저장 헤더/양 상세/근거를 승인 결과와 대조하고 불일치·중간 실패를 전체 롤백합니다. 불변 replay와 append-only 정정, exact-run 조회를 유지합니다.
- schema 14의 additive/idempotent 이관은 legacy 미보존 총계를 NULL로 남깁니다. 기존 자산 직접 API의 세 총계와 live 보고 의미는 유지합니다.
- MCP 신규 도구와 인증된 Dashboard는 같은 service/read model을 사용합니다. 읽기 no-create/auth-before-DB와 민감 근거 allowlist를 유지합니다.
## 문서와 계약
승인된 다섯 문서를 update-in-place했습니다. 기존 38개 요구/AC ID와 9개 global 의미 단위, Issue의 12개 포함 항목을 대응했고 AC18–27을 추가했습니다. 구현 PR 번호 #19를 canonical requirement metadata와 두 계약 테스트에 정확히 반영했습니다.
## 기존 구현 검증 — 이전 head 기록
- source SHA: `616bb7a744bf5cb200f5aa367a0555db49bd84ed`; strict clean checkout, 169 Git-bound source files.
- 전체 suite: **496 passed, 4 skipped, 1 warning**, exit 0. 기존 435개 test ID/skip/xfail 상태 보존; 현재 500개 ID의 Git source-binding 통과.
- 실제 MCP stdio lifecycle 및 synthetic 인증 seam을 사용하는 실제 Dashboard AppTest 포함. 저장 결과/후속 원장 변경/멱등 replay를 실제 SQLite로 검증했습니다.
- `ruff check --no-cache .`, base-to-head `git diff --check`: exit 0.
- 독립 spec/code-security 검토의 유효 지적은 named RED→GREEN으로 해결했고, lint-only delta도 독립 검토했습니다. 정본 guard에 19개 재현 case와 최종 exact-head GREEN을 결속했습니다.
- 정본 `evidence_manifest.py run` / `validate`: exit 0, schema `evidence-manifest/v3`.
검증 명령(실제 argv):
```text
/opt/data/gitea-agent/repositories/jsfamily/jarca-ledger-mcp/worktrees/issue-18/runtime/i18impl-20261013T001703Z/venv/bin/python -B -m pytest -o addopts= -p no:cacheprovider --basetemp /tmp/issue18-final-trace-d3h6_45g/pytest -ra -q tests
/opt/data/gitea-agent/repositories/jsfamily/jarca-ledger-mcp/worktrees/issue-18/runtime/i18impl-20261013T001703Z/venv/bin/python -B -m ruff check --no-cache .
```
## 검증 기록과 접근 경계
- stage/run: `i18-final-head-2`
- artifact root: `/opt/data/gitea-agent/repositories/jsfamily/jarca-ledger-mcp/worktrees/issue-18/verification/i18-final-head-2`
- manifest: `evidence-manifest.json`, SHA-256 `20817a3e11a8e0527f6902b1ec1d7c30b78608d40bab3aa946147651b3d4933a`
- plan: `evidence-plan.json`, SHA-256 `49586f48b0b5ef901167070570aaa3a8644f289ab230110b6cbb059c6ac722a4`
- command/exit/output/environment/timeout/termination/source 결속은 위 manifest의 claim pointers로 확인합니다. Same-UID read-only reviewer 접근은 `reviewer-access-receipt.json`으로 확인하며, 다른 host/UID의 공개 다운로드 권한은 주장하지 않습니다.
- 4개 skip은 기존 sample PDF/password 부재입니다. 1개 warning은 기존 Starlette/httpx deprecation입니다. AppTest를 실제 Chromium 검증과 동등하다고 주장하지 않습니다.
## 전달 경계
Issue 전용 branch의 non-force 전달입니다. PR merge, Issue close, release/deploy는 수행하지 않습니다. 원격 branch/PR head는 별도 authoritative readback으로 기록합니다.
## 검토 재작업 — review 76
- Reviewed head: `616bb7a744bf5cb200f5aa367a0555db49bd84ed`
- Final head: `ae4383ca2cf5cf576d9b370f6d62828b616d9418`
- C11-F01: Dashboard blocker transaction ID/reason, 저장 snapshot 및 자산/close 근거를 안전 allowlist와 fallback으로 표시.
- D02-F02: schema 14/legacy NULL과 저장 read-model 계약 보강.
- D03-F03: cashflow 정책 validator와 positional API/public response 예시 보강.
- D04-F04: private cashflow service의 소유권과 test mapping 명시.
- 승인된 113개 의미 단위와 500개 baseline test ID 보존; final collection 507개.
- 최종 독립 specification/code-security 검토에서 차단 지적 없음. 기존 REQUEST_CHANGES는 유지되며 새 head 재검토 대기입니다.
### 새 exact-head 검증
- 전체: 503 passed, 4 skipped, 1 warning; adversarial: 70 passed; Ruff: 통과. 모두 exit 0.
- 직접 실행 argv·환경·source/file hashes·timeout·termination·출력은 첨부의 product/evidence-manifest.json과 product/evidence-plan.json에 결합했습니다.
- manifest SHA-256: `99e30de8b894cee65c1826d0b4d39709d7ab62c6cb42353534947d221e20ab42`
- [검증 증빙 ZIP](https://gitea.jsfamily.quest/attachments/927929a5-fd71-4d24-817a-1801e3eaa59c)
- ZIP SHA-256: `f285326a63ead0efafe05b5681461d2ceb458e27cce869bec1bcf65ae8ad38fd` (authenticated download readback 일치).
- AppTest/실제 SQLite 및 MCP 검증이며 Chromium browser 완료로 표현하지 않습니다. 4 skip과 1 warning은 기존 조건입니다.
- Source Issue metadata/comments 보존. Merge, Issue close, release/deploy, review 작성은 하지 않습니다.
## 검토 재작업 — review 78
- Reviewed head: `ae4383ca2cf5cf576d9b370f6d62828b616d9418`
- Final head: `10201cdb7573546daaa11a4e3df2a8f628a1493e`
- F-001: 비활성 카테고리 JOIN을 활성 authority와 일치시켜 legacy fallback·환급·이동·당시 provenance를 보존했습니다.
- F-002: 저장 헤더의 제외·이월·승인 근거를 기존 strict public projection으로 additive 반환하고, 월정산 저장 패널에 표시했습니다. 실제 schema-13 기준 commit API로 생성한 조건부 마감 DB를 이관하여 원래 asset report 보존·exact/latest 일치·조회 no-write를 검증했습니다.
- 최종 exact-commit 전체 suite: **509 passed, 4 skipped, 1 warning**, exit 0. Ruff `check --no-cache .`: exit 0. 정본 manifest validation: exit 0.
- 기존 507개 test ID 보존, 6개 추가; 삭제·skip/xfail 변경 없음. 계약 보존 inventory 113개 의미 단위. 최종 독립 specification/code-security 정적 검토 및 source hash 대조: 차단 지적 없음. Privacy 문서 지적은 named RED→GREEN으로 해결했습니다.
- [해당 commit 검증 증빙 ZIP](https://gitea.jsfamily.quest/attachments/584e7f9a-91d4-46bb-9e1d-c33bd980f6e3)
- ZIP SHA-256: `8633cab871737f4f950d85cf65f38b4f9456db306310c525bd2f5071fe669ee1`; 인증된 원격 다운로드 readback 일치.
- manifest SHA-256: `ab19e42dd541060c5dd7c0cdcf48fa0b2b82bb33df2dc3460c767607ea0b04fa`; plan SHA-256: `fcb48c89681403bdb029924290621773334ac8e2281d6761ca71aa5e653b0b5b`. ZIP의 exact/evidence-manifest.json에 full SHA·실제 argv·exit·환경·출력·timeout·termination이 결속되어 있습니다.
- AppTest/실제 SQLite/MCP 검증이며 실제 Chromium 완료를 주장하지 않습니다. 기존 4개 skip 및 1개 deprecation warning은 실행 기록에 보존했습니다.
- 기존 REQUEST_CHANGES review는 유지되며 최종 head의 새 검토가 필요합니다. Merge, Issue 변경, release/deploy는 하지 않습니다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_draft_correction_contract.py
판정 근거: 재시도는 live review 전에 저장 응답을 반환한다. 정정의 최신 parent 및 unique child 경계를 유지하며 최초와 정정 상세는 run으로 분리된다.
C10 — satisfied
계약: additive idempotent 이관은 미보존 구버전 총계를 NULL로 남기고 소급 backfill이나 fake zero를 하지 않는다. 기존 미마감 초안은 종합 검토 재승인 후 마감한다.
구현 근거: jarca_ledger_mcp/infrastructure/sqlite/migrations.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; schema13 fixture를 실제 baseline DDL과 대조했다. migrations.py nullable header additions; test_legacy_migration_is_idempotent_and_keeps_unstored_totals_null 및 test_legacy_asset_approval_requires_comprehensive_review_before_close를 확인했다.
테스트 근거: tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement.py
판정 근거: 기존 초안과 자산 마감을 유지하며 asset-only 과거 지문은 새 종합 지문과 다르므로 마감할 수 없다. old-column reader는 조회 중 migrate하지 않는다.
C11-F01 — unsatisfied
계약: MCP 및 인증된 Dashboard에서 종합 초안과 저장 마감 결과를 제공하고 현재 보고와 구분하며 구버전 부분 자료 누락 제외를 표시한다. Dashboard는 목록 입력 경고 및 승인 불가 사유를 전달 표시한다.
구현 근거: dashboard/page_views/settlement_drafts.py, dashboard/page_views/monthly_settlement.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/adapters/mcp/server.py, jarca_ledger_mcp/adapters/mcp/tool_contracts.py, jarca_ledger_mcp/adapters/streamlit/settlement_gateway.py; F01: settlement_cashflow_service.py 98-103은 transaction_id와 reason을 반환하지만 settlement_drafts.py 212-227은 존재하지 않는 code만 읽어 모든 사유를 cashflow_blocked로 표시한다. monthly_settlement.py 271-283의 저장 조회는 run과 버전 및 여섯 총계와 현금흐름만 표시하고 반환된 close_status, legacy, 자산 items의 누락 제외와 사유를 표시하지 않는다. adapter tests는 happy-path 저장 조회와 auth/no-write를 검사하며 이 실패 및 부분 마감 UI를 검사하지 않는다.
테스트 근거: tests/test_comprehensive_settlement_adapters.py
판정 근거: 공통 service와 인증 순서는 유지되지만 미분류 환급 통화 차단 원인과 해결할 거래를 식별할 수 없고 부분 자료 총계의 누락 제외가 화면에서 숨겨진다. 안전한 차단 사유 및 관련 항목을 표시하고 저장 조회에 구버전 부분 상태와 자산 누락 제외를 표시해야 한다. 기존 계약 범위의 해당 UI 회귀만 보완하면 된다.
C12 — satisfied
계약: synthetic 검증으로 여섯 식 정책 drift 재시도 동시성 롤백 역사 불변 정정 분리 NULL 이관 기존 API MCP Dashboard 호환을 검증한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; 정본 i18-final-head-2 manifest와 plan digest, 169개 exact-head Git blob, command argv/exit/output/termination을 독립 대조했다. 구현자 결과는 496 passed, 4 skipped, 1 warning이다. real MCP stdio와 synthetic-auth Dashboard AppTest의 호출과 SQLite/no-write assertions를 확인했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py, tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement_adapters.py
판정 근거: 필수 service 및 transport 검증의 구현자 기록을 채택한다. reviewer 제품 테스트 실행이나 CI 성공으로 표현하지 않는다. F01 UI 누락은 현 suite가 차단하지 못하며 C11에서 별도 판정했다.
C13 — satisfied
계약: 정수 정밀도 NULL과 zero KRW 권위 verified 평가 대표 부채 및 투자 중복 합산 금지 읽기 no-create auth-before-DB credential 비노출을 유지한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/application/shared.py, dashboard/app.py; 기존 자산 authority source는 변경되지 않았고 new reader는 read_db를 사용한다. KRW blocker 101-103과 recursive saved projection 228-244 및 authentication before database ordering을 확인했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement_adapters.py, tests/test_settlement_draft_policy_consistency.py
판정 근거: 동일 통화 권위와 기존 자산 승인 정책을 유지한다. 실제 credential 없이 synthetic 인수 기록만 읽었으며 unknown output field를 allowlist로 제거한다.
C14 — satisfied
계약: 독립 정산 lifecycle 원장 자동 재작성 소급 집계 새 FX 가격 인증 메뉴 변경과 별도 현금흐름 조건부 승인을 도입하지 않는다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/adapters/mcp/server.py; 30개 changed-file set과 61개 API hunk를 exact base/head blob에 대조했다. 새 module은 기존 draft policy 집계의 private supporting service이며 auth/menu/asset direct-close/live cashflow report 구현은 변경되지 않았다.
테스트 근거: 없음
판정 근거: 모든 변경은 approved extension, 필수 문서 또는 검증에 대응한다. 설명할 수 없는 범위 초과와 새 제품 요구사항은 발견하지 않았다.
D01 — satisfied
계약: REQ-003의 ID 경로 제목을 유지하고 revision을 올려 기존 계약과 전체 baseline AC 의미를 보존하며 Issue 18과 실제 구현 PR 19를 기존 traceability에 추가한다.
구현 근거: docs/requirements/req-003_account-valuation-history.md; REQ-003 1-16,175-197,199-849,863-880. baseline의 38개 requirement/AC ID와 의미를 모두 대조했고 10개 새 AC를 추가했다. 11개 정본 섹션과 순번을 확인했다. read-only AC classification helper는 기존 10개 inline classification 때문에 exit 2이므로 자동 구조 PASS를 주장하지 않는다. 각 inline 블록의 level/backend/Cases/State Invariants와 신규 flat 블록을 직접 대조했다.
테스트 근거: tests/test_requirement_docs.py, tests/test_settlement_draft_docs.py
판정 근거: 기존 인수 의미 손실은 없고 새 정책과 저장 계약 및 실제 PR 19가 명시됐다. 기존 혼합 분류 형식의 구조 검사 한계는 문서 정규화 참고 사항이며 제품 동작 결함이나 새 mandatory gate로 승격하지 않는다.
D02-F02 — unsatisfied
계약: 데이터 모델은 확정 헤더 추가 필드별 타입 NULL legacy 의미 필수성과 초안 정책 집계 버전 JSON 재현 입력 신규 상세 전체 필드와 제약을 명세한다.
구현 근거: docs/data-model.md, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; F02: docs/data-model.md 196-202는 요약 3문단뿐이다. 여섯 INTEGER 총계 외에 settlement_month와 currency 및 policy/version/source 열의 타입 필수성 NULL 의미, draft cashflow_policy_json과 aggregation_version의 실제 NOT NULL default를 명세하지 않는다. 상세도 필드 이름과 일부 제약만 있으며 id/run/kind/currency 타입 및 필수성을 빠뜨렸다. migrations.py 36,145-171은 이를 구체적으로 구현한다.
테스트 근거: tests/test_settlement_cashflow_schema.py
판정 근거: 승인된 필드별 데이터 계약 산출물 의무가 누락됐다. 구현된 header/draft/detail 열을 실제 DDL에 맞춰 타입 nullable/default 및 신규 마감 필수성까지 update-in-place하고 정책과 당시 근거의 실제 재현 입력을 연결해야 한다. 새 저장 형식이나 새 문서는 요구하지 않는다.
D03-F03 — unsatisfied
계약: 인터페이스 계약은 기존 초안 operation의 정책 버전 여섯 총계 카테고리 상세 누락 경고 입력 출력과 필수성, 저축 목록 편집 환급 음수 및 미분류 차단 오류 재검토를 정의하고 실제 함수 도구 시그니처와 응답 예시를 구현에 대조한다.
구현 근거: docs/interface-contract.md, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; F03: docs/interface-contract.md 437-473 전체 draft 및 신규 계약에는 income_total, expense_total, savings_categories, category_decisions, cashflow_blockers가 없다. 469에는 함수의 인자 이름만 있고 cashflow_policy의 두 목록 entry schema, six-total output 필드 타입 및 필수성, signed refund 출력과 blocker error/review contract 및 신규 응답 예시가 없다. 실제 정책 validator는 settlement_cashflow_service.py 13-43이고 출력은 draft 149-157과 saved reader 251이다.
테스트 근거: tests/test_comprehensive_settlement_adapters.py, tests/test_settlement_cashflow_policy.py
판정 근거: 버전 거부와 기존 envelope 설명은 있으나 승인된 공개 입력 출력 계약을 소비자가 구성할 수 없다. 실제 list entry fields와 valid kinds 및 사유, 정책 변경 version/승인 무효화, 여섯 총계와 상세/blocker 반환 필수성, 음수 환급 및 승인 차단 재검토 오류와 synthetic 응답 예시를 기존 정본에 명세해야 한다.
D04-F04 — unsatisfied
계약: 프로젝트 구조 문서는 기존 service 책임과 실시간 보고의 구분 공통 business 집계 계층 및 실제 필요한 새 모듈 경로와 검증 책임을 구현 결과에 결속한다.
구현 근거: docs/project-structure.md, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py; F04: docs/project-structure.md 251-255는 grouped computation과 category-pair selection을 settlement_draft_service.py 책임으로만 적는다. 실제 cashflow SQL mapping refund/savings/exclusion/unknown 판단은 신규 settlement_cashflow_service.py 13-126에 있지만 전체 정본 문서에 이 모듈 경로와 책임 및 draft와의 호출 관계가 없다.
테스트 근거: tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement_adapters.py
판정 근거: 승인된 실제 새 모듈 경로와 공통 집계 responsibility mapping이 누락됐다. 새 directory를 요구하지 않고 현재 존재하는 private aggregation module과 draft caller, 관련 synthetic test 책임만 기존 문서에 정확히 연결해야 한다.
D05 — satisfied
계약: 런타임 흐름은 명시적 정책 설정 현재 재집계 종합 지문 승인 트랜잭션 재검증 여섯 식과 원자 저장 저장 조회 및 정책별 제외 음수 차단 재검토 롤백 동시 replay 정정 흐름을 명세한다.
구현 근거: docs/runtime-flow.md; docs/runtime-flow.md 276-280와 기존 lifecycle/no-create/privacy/correction 절을 함께 대조했다. 월 범위 정책 mapping unresolved blocker approval 재검증 same transaction rollback persisted replay latest parent append 및 stored/live 구분을 모두 기록한다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
판정 근거: 원래 source authority와 credential 비노출 및 관찰 metadata의 기존 계약을 유지한다. F01의 실제 Dashboard 표현 누락은 런타임 설명의 존재만으로 해소되지 않는다.
범위 판정
누락: F01 Dashboard가 거래별 차단 사유와 저장 마감의 구버전 부분 누락 제외 상태를 표시하지 않는다., F02 데이터 모델의 지정 신규 필드별 타입 필수성 nullable default 및 재현 입력 계약이 누락됐다., F03 인터페이스 정본의 정책 entry schema 여섯 총계와 경고 출력 필수성 환급 차단 오류 및 신규 응답 예시가 누락됐다., F04 프로젝트 구조 정본에 실제 신규 공통 현금흐름 집계 모듈 경로 책임 호출 관계가 누락됐다.
범위 초과: 없음
명세 모순: 없음
결론
승인된 저장 집계 승인 롤백 불변성 호환성의 구현과 exact-head 구현자 실행 근거는 확인했다. 그러나 F01의 필수 화면 표시와 F02-F04의 필수 정본 문서 계약이 누락되어 request_changes다. 각 finding에 적은 기존 계약 범위의 최소 보완만 요청하며 새 기능 새 증빙 commit 새 CI 또는 일괄 제품 테스트 재실행을 요구하지 않는다. 제품 테스트는 구현자가 실행했고 reviewer는 고정 source 및 기록을 read-only 검토했다. 이전 native finding은 없으므로 해소 잔여는 해당 없음이며 네 항목은 이번 신규 finding이다.
## 구현 명세 적합성 검토
- Source Issue: #18
- Pull Request: #19
- Reviewed head: `616bb7a744bf5cb200f5aa367a0555db49bd84ed`
- Contract SHA-256: `7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6`
- Verdict: `request_changes`
### Acceptance criteria 판정
- `C01` — `satisfied`
- 계약: 기존 초안 생성 수정 검토 승인 최종 마감을 확장하고 정책과 집계 버전을 보존하며 여섯 총계와 양 영역 상세 및 경고를 제공한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py; settlement_draft_service.py 133-157,160-171,240-250,349-357; migrations.py 36. test_draft_previews_six_totals_without_creating_run, test_policy_setter_persists_explicit_lists_and_changes_review_fingerprint의 호출과 assertions를 직접 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 별도 초안 현금흐름 테이블 없이 기존 lifecycle과 durable 정책을 확장하며 완료 조회는 저장 응답을 사용한다.
- `C02` — `satisfied`
- 계약: asset_snapshot_runs에 지정된 월 통화 여섯 총계 정책 집계 버전 저장 구조 버전 당시 근거를 추가하고 기존 연결과 승인 정보를 유지한다.
- 구현 근거: jarca_ledger_mcp/infrastructure/sqlite/schema.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py, jarca_ledger_mcp/application/settlement_draft_service.py; schema.py 193-213; migrations.py 145-171; settlement_draft_service.py 413. test_closed_header_persists_six_totals_policy_and_versions와 legacy migration test를 확인했다.
- 테스트 근거: tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement.py
- 판정 근거: 새 종합 run은 모든 지정 필드를 쓰며 자산 전용 기존 API는 그대로다. 구버전은 nullable 열을 추가하고 소급 집계를 하지 않는다.
- `C03` — `satisfied`
- 계약: 자산 상세의 기존 run 연결과 자산 부채 구분 금액 평가일 평가자료 ID exact 이월 대체 포함 제외 및 사유를 고정 근거와 반환 계약에 보존한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/application/assets_service.py; settlement_draft_service.py 75-144,405-418,429-459; monthly_settlement_service.py 221-244. asset authority와 mixed-sign liability tests 및 date_metadata_public_contract_names test의 실제 assertions를 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_draft_contract_scenarios.py
- 판정 근거: 원본 부채 금액과 적용 기여도를 구분하고 기존 abs of raw loan sum 의미를 유지한다. 제외 항목의 적용 금액은 NULL이며 기존 고정 자산 근거를 연결한다.
- `C04` — `satisfied`
- 계약: settlement_cashflow_snapshots의 지정 8개 필드 헤더 외래키 5요소 유일 제약 run 인덱스 및 빈 분류의 명시적 보존을 제공한다.
- 구현 근거: jarca_ledger_mcp/infrastructure/sqlite/schema.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; schema.py 217-228; migrations.py 158-171. test_cashflow_detail_constraints_preserve_blank_categories는 음수 저장, FK, NULL, kind, count, unique5, blank 보존 및 헤더 삭제 거부를 검사한다.
- 테스트 근거: tests/test_settlement_cashflow_schema.py
- 판정 근거: signed INTEGER와 positive count를 검증하고 category와 subcategory는 NOT NULL이다. 외래키 RESTRICT와 run 조회 인덱스가 존재한다.
- `C05` — `satisfied`
- 계약: 활성 거래의 월초 이상 다음 월초 미만을 집계하고 월말 평가를 사용한다. 환급월 음수 지출 명시적 저축 목록 대출상환 지출 이체 초기잔액 상품권 제외 우선 및 미결정 분류 승인 차단을 적용한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py; settlement_cashflow_service.py 46-126; approval 371, finalize 398. movement_precedence, month_boundaries_refund_month_negative_total_and_fx_blocker, refund_reduces_debt_payment_and_selected_savings, unknown_classification_blocks_and_explicit_exclusion_unblocks를 호출 인수와 assertions까지 확인했다.
- 테스트 근거: tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement.py
- 판정 근거: 선택한 investment pair만 저축으로 지출 처리하고 일반 이체 및 명시적 충전 제외가 우선한다. 환급은 음수로 남고 unknown은 확정 제외로 위장하지 않는다. 자산 조건부 플래그로 차단을 우회하지 못한다.
- `C06` — `satisfied`
- 계약: 당시 거래 날짜 금액 통화 유형 분류 원래 및 적용 구분 정책 판단과 자산 원본 평가자료 적용 금액 출처 이월 대체 누락 제외를 보존한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; cashflow source projection 104-109; draft asset source 140-145; header policy and source write 413; saved reader 225-250. source_snapshot_preserves_reproducible_values_without_raw_secrets와 stored_reader_keeps_required_transaction_date를 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 거래 ID만 남기지 않고 계산 입력을 고정한다. 자산 고정 근거와 source_snapshot이 같은 run에 연결되며 당시 정책은 헤더에 저장된다.
- `C07` — `satisfied`
- 계약: 검토 승인 지문에 거래 집합 당시 값 분류 정책 버전 결과 여섯 총계 평가자료 포함 제외 미확정 상태를 결속하고 관련 drift와 승인 저장 결과 불일치를 거부한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py; draft review serial 148; approval 368-376; finalize 395-445. source_policy_and_category_drift_invalidate_approval, policy_edit_persists_versions_and_invalidates_approval, stored_aggregation_version_drift_invalidates_approval와 persisted tampering tests를 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 거래 집합 전체와 정책 및 집계 결과가 지문에 포함된다. 정책 변경은 version 증가와 승인 무효화이며 최종 저장값도 승인 결과와 대조한다.
- `C08` — `satisfied`
- 계약: 한 DB 트랜잭션에서 헤더 양 상세 근거 초안 완료 연결과 저장 응답을 기록하고 여섯 계산식 및 실제 저장 일치를 검증하며 불일치와 중간 실패는 전부 롤백한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py; BEGIN IMMEDIATE 385; persisted group/header/evidence/asset comparison 421-445; completed response write 462. header/assets/cashflow/completion injection과 header_total/asset_amount/asset_currency/header_source/header_policy/header_version tampering assertions를 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py
- 판정 근거: 수입 지출 합계와 차 및 자산 부채 합계와 차를 같은 run에서 대조한다. 오류는 context-manager transaction 밖으로 전달되어 완료 상태도 남기지 않는다.
- `C09` — `satisfied`
- 계약: 동일 멱등 키와 동일 승인 요청은 동일 run과 저장 응답을 반환하고 다른 요청은 충돌한다. 과거 마감은 불변이고 최신 parent 단일 child 정정은 append하며 각각 exact run으로 조회한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; finalize replay 386-400; initial and correction unique indexes; exact reader 164-201. concurrent_close_retries_return_one_saved_result, replay_and_correction_keep_each_run_immutable, completed_get_and_saved_snapshot_ignore_later_live_ledger_changes의 실제 assertions를 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_draft_correction_contract.py
- 판정 근거: 재시도는 live review 전에 저장 응답을 반환한다. 정정의 최신 parent 및 unique child 경계를 유지하며 최초와 정정 상세는 run으로 분리된다.
- `C10` — `satisfied`
- 계약: additive idempotent 이관은 미보존 구버전 총계를 NULL로 남기고 소급 backfill이나 fake zero를 하지 않는다. 기존 미마감 초안은 종합 검토 재승인 후 마감한다.
- 구현 근거: jarca_ledger_mcp/infrastructure/sqlite/migrations.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; schema13 fixture를 실제 baseline DDL과 대조했다. migrations.py nullable header additions; test_legacy_migration_is_idempotent_and_keeps_unstored_totals_null 및 test_legacy_asset_approval_requires_comprehensive_review_before_close를 확인했다.
- 테스트 근거: tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement.py
- 판정 근거: 기존 초안과 자산 마감을 유지하며 asset-only 과거 지문은 새 종합 지문과 다르므로 마감할 수 없다. old-column reader는 조회 중 migrate하지 않는다.
- `C11-F01` — `unsatisfied`
- 계약: MCP 및 인증된 Dashboard에서 종합 초안과 저장 마감 결과를 제공하고 현재 보고와 구분하며 구버전 부분 자료 누락 제외를 표시한다. Dashboard는 목록 입력 경고 및 승인 불가 사유를 전달 표시한다.
- 구현 근거: dashboard/page_views/settlement_drafts.py, dashboard/page_views/monthly_settlement.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/adapters/mcp/server.py, jarca_ledger_mcp/adapters/mcp/tool_contracts.py, jarca_ledger_mcp/adapters/streamlit/settlement_gateway.py; F01: settlement_cashflow_service.py 98-103은 transaction_id와 reason을 반환하지만 settlement_drafts.py 212-227은 존재하지 않는 code만 읽어 모든 사유를 cashflow_blocked로 표시한다. monthly_settlement.py 271-283의 저장 조회는 run과 버전 및 여섯 총계와 현금흐름만 표시하고 반환된 close_status, legacy, 자산 items의 누락 제외와 사유를 표시하지 않는다. adapter tests는 happy-path 저장 조회와 auth/no-write를 검사하며 이 실패 및 부분 마감 UI를 검사하지 않는다.
- 테스트 근거: tests/test_comprehensive_settlement_adapters.py
- 판정 근거: 공통 service와 인증 순서는 유지되지만 미분류 환급 통화 차단 원인과 해결할 거래를 식별할 수 없고 부분 자료 총계의 누락 제외가 화면에서 숨겨진다. 안전한 차단 사유 및 관련 항목을 표시하고 저장 조회에 구버전 부분 상태와 자산 누락 제외를 표시해야 한다. 기존 계약 범위의 해당 UI 회귀만 보완하면 된다.
- `C12` — `satisfied`
- 계약: synthetic 검증으로 여섯 식 정책 drift 재시도 동시성 롤백 역사 불변 정정 분리 NULL 이관 기존 API MCP Dashboard 호환을 검증한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; 정본 i18-final-head-2 manifest와 plan digest, 169개 exact-head Git blob, command argv/exit/output/termination을 독립 대조했다. 구현자 결과는 496 passed, 4 skipped, 1 warning이다. real MCP stdio와 synthetic-auth Dashboard AppTest의 호출과 SQLite/no-write assertions를 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py, tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement_adapters.py
- 판정 근거: 필수 service 및 transport 검증의 구현자 기록을 채택한다. reviewer 제품 테스트 실행이나 CI 성공으로 표현하지 않는다. F01 UI 누락은 현 suite가 차단하지 못하며 C11에서 별도 판정했다.
- `C13` — `satisfied`
- 계약: 정수 정밀도 NULL과 zero KRW 권위 verified 평가 대표 부채 및 투자 중복 합산 금지 읽기 no-create auth-before-DB credential 비노출을 유지한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/application/shared.py, dashboard/app.py; 기존 자산 authority source는 변경되지 않았고 new reader는 read_db를 사용한다. KRW blocker 101-103과 recursive saved projection 228-244 및 authentication before database ordering을 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement_adapters.py, tests/test_settlement_draft_policy_consistency.py
- 판정 근거: 동일 통화 권위와 기존 자산 승인 정책을 유지한다. 실제 credential 없이 synthetic 인수 기록만 읽었으며 unknown output field를 allowlist로 제거한다.
- `C14` — `satisfied`
- 계약: 독립 정산 lifecycle 원장 자동 재작성 소급 집계 새 FX 가격 인증 메뉴 변경과 별도 현금흐름 조건부 승인을 도입하지 않는다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/adapters/mcp/server.py; 30개 changed-file set과 61개 API hunk를 exact base/head blob에 대조했다. 새 module은 기존 draft policy 집계의 private supporting service이며 auth/menu/asset direct-close/live cashflow report 구현은 변경되지 않았다.
- 테스트 근거: 없음
- 판정 근거: 모든 변경은 approved extension, 필수 문서 또는 검증에 대응한다. 설명할 수 없는 범위 초과와 새 제품 요구사항은 발견하지 않았다.
- `D01` — `satisfied`
- 계약: REQ-003의 ID 경로 제목을 유지하고 revision을 올려 기존 계약과 전체 baseline AC 의미를 보존하며 Issue 18과 실제 구현 PR 19를 기존 traceability에 추가한다.
- 구현 근거: docs/requirements/req-003_account-valuation-history.md; REQ-003 1-16,175-197,199-849,863-880. baseline의 38개 requirement/AC ID와 의미를 모두 대조했고 10개 새 AC를 추가했다. 11개 정본 섹션과 순번을 확인했다. read-only AC classification helper는 기존 10개 inline classification 때문에 exit 2이므로 자동 구조 PASS를 주장하지 않는다. 각 inline 블록의 level/backend/Cases/State Invariants와 신규 flat 블록을 직접 대조했다.
- 테스트 근거: tests/test_requirement_docs.py, tests/test_settlement_draft_docs.py
- 판정 근거: 기존 인수 의미 손실은 없고 새 정책과 저장 계약 및 실제 PR 19가 명시됐다. 기존 혼합 분류 형식의 구조 검사 한계는 문서 정규화 참고 사항이며 제품 동작 결함이나 새 mandatory gate로 승격하지 않는다.
- `D02-F02` — `unsatisfied`
- 계약: 데이터 모델은 확정 헤더 추가 필드별 타입 NULL legacy 의미 필수성과 초안 정책 집계 버전 JSON 재현 입력 신규 상세 전체 필드와 제약을 명세한다.
- 구현 근거: docs/data-model.md, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; F02: docs/data-model.md 196-202는 요약 3문단뿐이다. 여섯 INTEGER 총계 외에 settlement_month와 currency 및 policy/version/source 열의 타입 필수성 NULL 의미, draft cashflow_policy_json과 aggregation_version의 실제 NOT NULL default를 명세하지 않는다. 상세도 필드 이름과 일부 제약만 있으며 id/run/kind/currency 타입 및 필수성을 빠뜨렸다. migrations.py 36,145-171은 이를 구체적으로 구현한다.
- 테스트 근거: tests/test_settlement_cashflow_schema.py
- 판정 근거: 승인된 필드별 데이터 계약 산출물 의무가 누락됐다. 구현된 header/draft/detail 열을 실제 DDL에 맞춰 타입 nullable/default 및 신규 마감 필수성까지 update-in-place하고 정책과 당시 근거의 실제 재현 입력을 연결해야 한다. 새 저장 형식이나 새 문서는 요구하지 않는다.
- `D03-F03` — `unsatisfied`
- 계약: 인터페이스 계약은 기존 초안 operation의 정책 버전 여섯 총계 카테고리 상세 누락 경고 입력 출력과 필수성, 저축 목록 편집 환급 음수 및 미분류 차단 오류 재검토를 정의하고 실제 함수 도구 시그니처와 응답 예시를 구현에 대조한다.
- 구현 근거: docs/interface-contract.md, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; F03: docs/interface-contract.md 437-473 전체 draft 및 신규 계약에는 income_total, expense_total, savings_categories, category_decisions, cashflow_blockers가 없다. 469에는 함수의 인자 이름만 있고 cashflow_policy의 두 목록 entry schema, six-total output 필드 타입 및 필수성, signed refund 출력과 blocker error/review contract 및 신규 응답 예시가 없다. 실제 정책 validator는 settlement_cashflow_service.py 13-43이고 출력은 draft 149-157과 saved reader 251이다.
- 테스트 근거: tests/test_comprehensive_settlement_adapters.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 버전 거부와 기존 envelope 설명은 있으나 승인된 공개 입력 출력 계약을 소비자가 구성할 수 없다. 실제 list entry fields와 valid kinds 및 사유, 정책 변경 version/승인 무효화, 여섯 총계와 상세/blocker 반환 필수성, 음수 환급 및 승인 차단 재검토 오류와 synthetic 응답 예시를 기존 정본에 명세해야 한다.
- `D04-F04` — `unsatisfied`
- 계약: 프로젝트 구조 문서는 기존 service 책임과 실시간 보고의 구분 공통 business 집계 계층 및 실제 필요한 새 모듈 경로와 검증 책임을 구현 결과에 결속한다.
- 구현 근거: docs/project-structure.md, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py; F04: docs/project-structure.md 251-255는 grouped computation과 category-pair selection을 settlement_draft_service.py 책임으로만 적는다. 실제 cashflow SQL mapping refund/savings/exclusion/unknown 판단은 신규 settlement_cashflow_service.py 13-126에 있지만 전체 정본 문서에 이 모듈 경로와 책임 및 draft와의 호출 관계가 없다.
- 테스트 근거: tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement_adapters.py
- 판정 근거: 승인된 실제 새 모듈 경로와 공통 집계 responsibility mapping이 누락됐다. 새 directory를 요구하지 않고 현재 존재하는 private aggregation module과 draft caller, 관련 synthetic test 책임만 기존 문서에 정확히 연결해야 한다.
- `D05` — `satisfied`
- 계약: 런타임 흐름은 명시적 정책 설정 현재 재집계 종합 지문 승인 트랜잭션 재검증 여섯 식과 원자 저장 저장 조회 및 정책별 제외 음수 차단 재검토 롤백 동시 replay 정정 흐름을 명세한다.
- 구현 근거: docs/runtime-flow.md; docs/runtime-flow.md 276-280와 기존 lifecycle/no-create/privacy/correction 절을 함께 대조했다. 월 범위 정책 mapping unresolved blocker approval 재검증 same transaction rollback persisted replay latest parent append 및 stored/live 구분을 모두 기록한다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 원래 source authority와 credential 비노출 및 관찰 metadata의 기존 계약을 유지한다. F01의 실제 Dashboard 표현 누락은 런타임 설명의 존재만으로 해소되지 않는다.
### 범위 판정
- 누락: F01 Dashboard가 거래별 차단 사유와 저장 마감의 구버전 부분 누락 제외 상태를 표시하지 않는다., F02 데이터 모델의 지정 신규 필드별 타입 필수성 nullable default 및 재현 입력 계약이 누락됐다., F03 인터페이스 정본의 정책 entry schema 여섯 총계와 경고 출력 필수성 환급 차단 오류 및 신규 응답 예시가 누락됐다., F04 프로젝트 구조 정본에 실제 신규 공통 현금흐름 집계 모듈 경로 책임 호출 관계가 누락됐다.
- 범위 초과: 없음
- 명세 모순: 없음
### 결론
승인된 저장 집계 승인 롤백 불변성 호환성의 구현과 exact-head 구현자 실행 근거는 확인했다. 그러나 F01의 필수 화면 표시와 F02-F04의 필수 정본 문서 계약이 누락되어 request_changes다. 각 finding에 적은 기존 계약 범위의 최소 보완만 요청하며 새 기능 새 증빙 commit 새 CI 또는 일괄 제품 테스트 재실행을 요구하지 않는다. 제품 테스트는 구현자가 실행했고 reviewer는 고정 source 및 기록을 read-only 검토했다. 이전 native finding은 없으므로 해소 잔여는 해당 없음이며 네 항목은 이번 신규 finding이다.
<!-- gitea-agent:implementation-spec-review/v1 owner=jsfamily repository=jarca-ledger-mcp issue=18 pr=19 head=616bb7a744bf5cb200f5aa367a0555db49bd84ed contract-sha256=7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6 result-sha256=78e625b5a56e04e4f4c4989b47c6d2f4cdd3c123dc8f7e9f6f22ba71bd3c2984 correlation=32411c8ba49e6fcdf9980855b310bede76629bd26a71cbe24b81ffa99ce2669a -->
근거: review 76의 승인 계약 누락을 보강했고 기존 lifecycle/FX 및 baseline 의미를 보존했습니다.
최종 검증
Local checks: Exact head full pytest: 503 passed, 4 skipped, 1 warning, exit 0; adversarial: 70 passed, exit 0; ruff check --no-cache . exit 0. 원격 PR19 첨부 issue18-rework-ae4383ca2cf5-evidence.zip의 product/evidence-manifest.json 및 product/evidence-plan.json에 실제 argv/output/environment/source를 기록. ZIP sha256 f285326a63ead0efafe05b5681461d2ceb458e27cce869bec1bcf65ae8ad38fd
Runtime/browser: Actual SQLite, MCP stdio and Dashboard AppTest in full suite. AppTest is not Chromium browser evidence. 113 contract semantics and 500 baseline IDs preserved; 507 collected.
Commit status: 없음
Actions runs: 없음
다음 단계
Reviewer가 rework head를 새 snapshot으로 다시 검토해야 하며 이 comment는 기존 REQUEST_CHANGES를 해제하거나 승인을 의미하지 않는다.
## 구현 재작업 결과
- Source Issue: 18
- Pull Request: 19
- Source Review: 76
- Reviewed head: `616bb7a744bf5cb200f5aa367a0555db49bd84ed`
- Rework head: `ae4383ca2cf5cf576d9b370f6d62828b616d9418`
- Contract SHA-256: `7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6`
- Result: `rework_delivered`
### 지적 처리
- C11-F01 — `resolved`
- 분류: valid_fix
- 변경: dashboard/page_views/settlement_drafts.py, dashboard/page_views/monthly_settlement.py
- 검증: tests/test_comprehensive_settlement_adapters.py::test_draft_cashflow_blocker_renders_safe_transaction_id_and_reason; tests/test_comprehensive_settlement_adapters.py::test_saved_monthly_snapshot_renders_close_legacy_and_asset_evidence; exact-head adversarial exit 0, 70 passed
- 근거: review 76의 승인 계약 누락을 보강했고 기존 lifecycle/FX 및 baseline 의미를 보존했습니다.
- D02-F02 — `resolved`
- 분류: valid_fix
- 변경: docs/data-model.md
- 검증: tests/test_settlement_draft_docs.py::test_settlement_cashflow_model_documents_schema_and_legacy_reproduction; exact-head adversarial exit 0, 70 passed
- 근거: review 76의 승인 계약 누락을 보강했고 기존 lifecycle/FX 및 baseline 의미를 보존했습니다.
- D03-F03 — `resolved`
- 분류: valid_fix
- 변경: docs/interface-contract.md
- 검증: tests/test_settlement_draft_docs.py::test_settlement_cashflow_interface_specifies_valid_policy_review_and_response_examples; exact-head adversarial exit 0, 70 passed
- 근거: review 76의 승인 계약 누락을 보강했고 기존 lifecycle/FX 및 baseline 의미를 보존했습니다.
- D04-F04 — `resolved`
- 분류: valid_fix
- 변경: docs/project-structure.md
- 검증: tests/test_settlement_draft_docs.py::test_settlement_cashflow_private_service_has_explicit_ownership_and_test_mapping; exact-head adversarial exit 0, 70 passed
- 근거: review 76의 승인 계약 누락을 보강했고 기존 lifecycle/FX 및 baseline 의미를 보존했습니다.
### 최종 검증
- Local checks: Exact head full pytest: 503 passed, 4 skipped, 1 warning, exit 0; adversarial: 70 passed, exit 0; ruff check --no-cache . exit 0. 원격 PR19 첨부 issue18-rework-ae4383ca2cf5-evidence.zip의 product/evidence-manifest.json 및 product/evidence-plan.json에 실제 argv/output/environment/source를 기록. ZIP sha256 f285326a63ead0efafe05b5681461d2ceb458e27cce869bec1bcf65ae8ad38fd
- Runtime/browser: Actual SQLite, MCP stdio and Dashboard AppTest in full suite. AppTest is not Chromium browser evidence. 113 contract semantics and 500 baseline IDs preserved; 507 collected.
- Commit status: 없음
- Actions runs: 없음
### 다음 단계
Reviewer가 rework head를 새 snapshot으로 다시 검토해야 하며 이 comment는 기존 `REQUEST_CHANGES`를 해제하거나 승인을 의미하지 않는다.
<!-- gitea-agent:implementation-rework/v1 owner=jsfamily repository=jarca-ledger-mcp issue=18 pr=19 review=76 reviewed-head=616bb7a744bf5cb200f5aa367a0555db49bd84ed head=ae4383ca2cf5cf576d9b370f6d62828b616d9418 contract-sha256=7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6 result-sha256=5fe8566b2a14377d9df2bd271b35b519f7a38604b71b3de53bdc7f4493d0df73 correlation=e7bd2145dd2c8b9182b46623fe2fef18c659001010e6bd9e6175e21610842cb3 -->
계약: 기존 초안 생성 수정 검토 승인 최종 마감을 확장하고 정책과 집계 버전을 보존하며 여섯 총계와 양 영역 상세 및 경고를 제공한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py; settlement_draft_service.py 133-157,160-171,240-250,349-357; migrations.py 36. test_draft_previews_six_totals_without_creating_run, test_policy_setter_persists_explicit_lists_and_changes_review_fingerprint의 호출과 assertions를 직접 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
판정 근거: 별도 초안 현금흐름 테이블 없이 기존 lifecycle과 durable 정책을 확장하며 완료 조회는 저장 응답을 사용한다.
C02 — satisfied
계약: asset_snapshot_runs에 지정된 월 통화 여섯 총계 정책 집계 버전 저장 구조 버전 당시 근거를 추가하고 기존 연결과 승인 정보를 유지한다.
구현 근거: jarca_ledger_mcp/infrastructure/sqlite/schema.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py, jarca_ledger_mcp/application/settlement_draft_service.py; schema.py 193-213; migrations.py 145-171; settlement_draft_service.py 413. test_closed_header_persists_six_totals_policy_and_versions와 legacy migration test를 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
테스트 근거: tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement.py
판정 근거: 새 종합 run은 모든 지정 필드를 쓰며 자산 전용 기존 API는 그대로다. 구버전은 nullable 열을 추가하고 소급 집계를 하지 않는다.
C03 — satisfied
계약: 자산 상세의 기존 run 연결과 자산 부채 구분 금액 평가일 평가자료 ID exact 이월 대체 포함 제외 및 사유를 고정 근거와 반환 계약에 보존한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/application/assets_service.py; settlement_draft_service.py 75-144,405-418,429-459; monthly_settlement_service.py 221-244. asset authority와 mixed-sign liability tests 및 date_metadata_public_contract_names test의 실제 assertions를 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_draft_contract_scenarios.py
판정 근거: 원본 부채 금액과 적용 기여도를 구분하고 기존 abs of raw loan sum 의미를 유지한다. 제외 항목의 적용 금액은 NULL이며 기존 고정 자산 근거를 연결한다.
C04 — satisfied
계약: settlement_cashflow_snapshots의 지정 8개 필드 헤더 외래키 5요소 유일 제약 run 인덱스 및 빈 분류의 명시적 보존을 제공한다.
구현 근거: jarca_ledger_mcp/infrastructure/sqlite/schema.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; schema.py 217-228; migrations.py 158-171. test_cashflow_detail_constraints_preserve_blank_categories는 음수 저장, FK, NULL, kind, count, unique5, blank 보존 및 헤더 삭제 거부를 검사한다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
테스트 근거: tests/test_settlement_cashflow_schema.py
판정 근거: signed INTEGER와 positive count를 검증하고 category와 subcategory는 NOT NULL이다. 외래키 RESTRICT와 run 조회 인덱스가 존재한다.
C05 — satisfied
계약: 활성 거래의 월초 이상 다음 월초 미만을 집계하고 월말 평가를 사용한다. 환급월 음수 지출 명시적 저축 목록 대출상환 지출 이체 초기잔액 상품권 제외 우선 및 미결정 분류 승인 차단을 적용한다.
구현 근거: jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py; settlement_cashflow_service.py 46-126; approval 371, finalize 398. movement_precedence, month_boundaries_refund_month_negative_total_and_fx_blocker, refund_reduces_debt_payment_and_selected_savings, unknown_classification_blocks_and_explicit_exclusion_unblocks를 호출 인수와 assertions까지 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
테스트 근거: tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement.py
판정 근거: 선택한 investment pair만 저축으로 지출 처리하고 일반 이체 및 명시적 충전 제외가 우선한다. 환급은 음수로 남고 unknown은 확정 제외로 위장하지 않는다. 자산 조건부 플래그로 차단을 우회하지 못한다.
C06 — satisfied
계약: 당시 거래 날짜 금액 통화 유형 분류 원래 및 적용 구분 정책 판단과 자산 원본 평가자료 적용 금액 출처 이월 대체 누락 제외를 보존한다.
구현 근거: jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; cashflow source projection 104-109; draft asset source 140-145; header policy and source write 413; saved reader 225-250. source_snapshot_preserves_reproducible_values_without_raw_secrets와 stored_reader_keeps_required_transaction_date를 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
판정 근거: 거래 ID만 남기지 않고 계산 입력을 고정한다. 자산 고정 근거와 source_snapshot이 같은 run에 연결되며 당시 정책은 헤더에 저장된다.
C07 — satisfied
계약: 검토 승인 지문에 거래 집합 당시 값 분류 정책 버전 결과 여섯 총계 평가자료 포함 제외 미확정 상태를 결속하고 관련 drift와 승인 저장 결과 불일치를 거부한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py; draft review serial 148; approval 368-376; finalize 395-445. source_policy_and_category_drift_invalidate_approval, policy_edit_persists_versions_and_invalidates_approval, stored_aggregation_version_drift_invalidates_approval와 persisted tampering tests를 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
판정 근거: 거래 집합 전체와 정책 및 집계 결과가 지문에 포함된다. 정책 변경은 version 증가와 승인 무효화이며 최종 저장값도 승인 결과와 대조한다.
C08 — satisfied
계약: 한 DB 트랜잭션에서 헤더 양 상세 근거 초안 완료 연결과 저장 응답을 기록하고 여섯 계산식 및 실제 저장 일치를 검증하며 불일치와 중간 실패는 전부 롤백한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py; BEGIN IMMEDIATE 385; persisted group/header/evidence/asset comparison 421-445; completed response write 462. header/assets/cashflow/completion injection과 header_total/asset_amount/asset_currency/header_source/header_policy/header_version tampering assertions를 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
테스트 근거: tests/test_comprehensive_settlement.py
판정 근거: 수입 지출 합계와 차 및 자산 부채 합계와 차를 같은 run에서 대조한다. 오류는 context-manager transaction 밖으로 전달되어 완료 상태도 남기지 않는다.
C09 — satisfied
계약: 동일 멱등 키와 동일 승인 요청은 동일 run과 저장 응답을 반환하고 다른 요청은 충돌한다. 과거 마감은 불변이고 최신 parent 단일 child 정정은 append하며 각각 exact run으로 조회한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; finalize replay 386-400; initial and correction unique indexes; exact reader 164-201. concurrent_close_retries_return_one_saved_result, replay_and_correction_keep_each_run_immutable, completed_get_and_saved_snapshot_ignore_later_live_ledger_changes의 실제 assertions를 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_draft_correction_contract.py
판정 근거: 재시도는 live review 전에 저장 응답을 반환한다. 정정의 최신 parent 및 unique child 경계를 유지하며 최초와 정정 상세는 run으로 분리된다.
C10 — satisfied
계약: additive idempotent 이관은 미보존 구버전 총계를 NULL로 남기고 소급 backfill이나 fake zero를 하지 않는다. 기존 미마감 초안은 종합 검토 재승인 후 마감한다.
구현 근거: jarca_ledger_mcp/infrastructure/sqlite/migrations.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; schema13 fixture를 실제 baseline DDL과 대조했다. migrations.py nullable header additions; test_legacy_migration_is_idempotent_and_keeps_unstored_totals_null 및 test_legacy_asset_approval_requires_comprehensive_review_before_close를 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
테스트 근거: tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement.py
판정 근거: 기존 초안과 자산 마감을 유지하며 asset-only 과거 지문은 새 종합 지문과 다르므로 마감할 수 없다. old-column reader는 조회 중 migrate하지 않는다.
C11-F01 — satisfied
계약: MCP 및 인증된 Dashboard에서 종합 초안과 저장 마감 결과를 제공하고 현재 보고와 구분하며 구버전 부분 자료 누락 제외를 표시한다. Dashboard는 목록 입력 경고 및 승인 불가 사유를 전달 표시한다.
구현 근거: dashboard/page_views/settlement_drafts.py, dashboard/page_views/monthly_settlement.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/adapters/mcp/server.py, jarca_ledger_mcp/adapters/mcp/tool_contracts.py, jarca_ledger_mcp/adapters/streamlit/settlement_gateway.py; F01 해소: settlement_drafts.py 212-223은 transaction_id와 reason을 표시하고 blocker가 있으면 승인 버튼을 막는다. monthly_settlement.py 275-302는 close_status legacy is_comprehensive와 NULL 미보존 및 안전 필드의 저장 자산 근거와 source assets의 missing/excluded를 표시한다. test_draft_cashflow_blocker_renders_safe_transaction_id_and_reason 및 두 parameter의 test_saved_monthly_snapshot_renders_close_legacy_and_asset_evidence는 실제 표시 값과 승인 disabled 및 비공개 필드 비노출 assertions를 확인했다.
테스트 근거: tests/test_comprehensive_settlement_adapters.py
판정 근거: 서비스의 차단 원인과 대상 거래가 표시되고 부분 또는 구버전 마감이 완전한 현재 보고로 오인되지 않는다. 기존 인증과 읽기 no-write 근거를 유지한다.
C12 — satisfied
계약: synthetic 검증으로 여섯 식 정책 drift 재시도 동시성 롤백 역사 불변 정정 분리 NULL 이관 기존 API MCP Dashboard 호환을 검증한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; 새 exact-head i18-message-exact-ae4383ca2cf5 manifest digest 99e30de8b894cee65c1826d0b4d39709d7ab62c6cb42353534947d221e20ab42와 plan 및 169개 Git blob을 독립 대조했다. 구현자 전체 503 passed 4 skipped 1 warning, adversarial 70 passed, Ruff exit 0이다. 이전 collection 500개와 current 507개 ID 및 status의 source-binding과 check-tests가 통과했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py, tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement_adapters.py
판정 근거: 필수 service와 transport 검증의 구현자 실행을 채택한다. 신규 UI 및 문서 회귀의 호출 인수와 assertions를 직접 대조했고 reviewer 제품 테스트 실행이나 Chromium browser 또는 CI 성공으로 표현하지 않는다.
C13 — satisfied
계약: 정수 정밀도 NULL과 zero KRW 권위 verified 평가 대표 부채 및 투자 중복 합산 금지 읽기 no-create auth-before-DB credential 비노출을 유지한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/application/shared.py, dashboard/app.py; 기존 자산 authority source는 변경되지 않았고 new reader는 read_db를 사용한다. KRW blocker 101-103과 recursive saved projection 228-244 및 authentication before database ordering을 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement_adapters.py, tests/test_settlement_draft_policy_consistency.py
판정 근거: 동일 통화 권위와 기존 자산 승인 정책을 유지한다. 실제 credential 없이 synthetic 인수 기록만 읽었으며 unknown output field를 allowlist로 제거한다.
C14 — satisfied
계약: 독립 정산 lifecycle 원장 자동 재작성 소급 집계 새 FX 가격 인증 메뉴 변경과 별도 현금흐름 조건부 승인을 도입하지 않는다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/adapters/mcp/server.py; 30개 변경 파일과 62개 API hunk를 exact base/head Git blob에 대조했다. 이전 검토 이후 7개 변경 파일은 두 화면, 세 정본 문서 및 두 회귀 테스트 파일이며 private service와 저장 lifecycle은 이전 reviewed head와 byte-identical이다.
테스트 근거: 없음
판정 근거: 모든 변경은 승인된 extension 또는 필수 문서와 지적 보완 검증에 대응한다. 독립 정산 FX 인증 메뉴 변경이나 범위 초과는 없다.
D01 — satisfied
계약: REQ-003의 ID 경로 제목을 유지하고 revision을 올려 기존 계약과 전체 baseline AC 의미를 보존하며 Issue 18과 실제 구현 PR 19를 기존 traceability에 추가한다.
구현 근거: docs/requirements/req-003_account-valuation-history.md; REQ-003 1-16,175-197,199-849,863-880. baseline의 38개 requirement/AC ID와 의미를 모두 대조했고 10개 새 AC를 추가했다. 11개 정본 섹션과 순번을 확인했다. read-only AC classification helper는 기존 10개 inline classification 때문에 exit 2이므로 자동 구조 PASS를 주장하지 않는다. 각 inline 블록의 level/backend/Cases/State Invariants와 신규 flat 블록을 직접 대조했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
테스트 근거: tests/test_requirement_docs.py, tests/test_settlement_draft_docs.py
판정 근거: 기존 인수 의미 손실은 없고 새 정책과 저장 계약 및 실제 PR 19가 명시됐다. 기존 혼합 분류 형식의 구조 검사 한계는 문서 정규화 참고 사항이며 제품 동작 결함이나 새 mandatory gate로 승격하지 않는다.
D02-F02 — satisfied
계약: 데이터 모델은 확정 헤더 추가 필드별 타입 NULL legacy 의미 필수성과 초안 정책 집계 버전 JSON 재현 입력 신규 상세 전체 필드와 제약을 명세한다.
구현 근거: docs/data-model.md, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; F02 해소: docs/data-model.md 198-243의 세 필드 표와 재현 입력을 migrations.py 36,145-170 및 schema.py 193-228과 대조했다. 열 타입 nullability default와 logical identifier 필수성, 신규 종합 마감의 모든 열 제공, legacy NULL, 원래 양수 환급과 적용 음수 및 당시 자산 입력이 명시됐다. test_settlement_cashflow_model_documents_schema_and_legacy_reproduction는 실제 PRAGMA 표와 전체 지정 필드를 비교한다.
테스트 근거: tests/test_settlement_cashflow_schema.py
판정 근거: 헤더 초안 상세의 필드별 계약과 정책 버전 당시 입력을 통한 재현 경계가 보완됐다. 정본 기존 승인 완료 지문 응답 및 원자성 계약은 유지된다.
D03-F03 — satisfied
계약: 인터페이스 계약은 기존 초안 operation의 정책 버전 여섯 총계 카테고리 상세 누락 경고 입력 출력과 필수성, 저축 목록 편집 환급 음수 및 미분류 차단 오류 재검토를 정의하고 실제 함수 도구 시그니처와 응답 예시를 구현에 대조한다.
테스트 근거: tests/test_comprehensive_settlement_adapters.py, tests/test_settlement_cashflow_policy.py
판정 근거: 공개 정책 입력과 출력 필수성 및 승인 차단 재검토를 소비자가 구성할 수 있다. 예시는 선택 필드라는 한계를 명시하고 root review와 saved reader를 구분한다. 기존 자산 플래그로 차단 우회 금지와 확정 제외 및 기존 envelope 계약은 유지된다.
D04-F04 — satisfied
계약: 프로젝트 구조 문서는 기존 service 책임과 실시간 보고의 구분 공통 business 집계 계층 및 실제 필요한 새 모듈 경로와 검증 책임을 구현 결과에 결속한다.
구현 근거: docs/project-structure.md, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py; F04 해소: docs/project-structure.md 248-250의 실제 private settlement_cashflow_service.py 책임 표는 _normalize_cashflow_policy와 _review_cashflow 및 settlement_draft_service.py caller와 두 test 경로를 연결한다. test_settlement_cashflow_private_service_has_explicit_ownership_and_test_mapping의 단일 책임 행과 필수 symbol assertions를 확인했다.
테스트 근거: tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement_adapters.py
판정 근거: 실제 공통 집계의 소유권과 호출 및 검증 관계를 정본에 보완했다. transport에 SQL 또는 별도 정책을 복제하지 않는다.
D05 — satisfied
계약: 런타임 흐름은 명시적 정책 설정 현재 재집계 종합 지문 승인 트랜잭션 재검증 여섯 식과 원자 저장 저장 조회 및 정책별 제외 음수 차단 재검토 롤백 동시 replay 정정 흐름을 명세한다.
구현 근거: docs/runtime-flow.md; docs/runtime-flow.md 276-280와 기존 lifecycle/no-create/privacy/correction 절을 함께 대조했다. 월 범위 정책 mapping unresolved blocker approval 재검증 same transaction rollback persisted replay latest parent append 및 stored/live 구분을 모두 기록한다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
판정 근거: 원래 source authority와 credential 비노출 및 관찰 metadata의 기존 계약을 유지한다. F01의 실제 Dashboard 표현 누락은 런타임 설명의 존재만으로 해소되지 않는다.
범위 판정
누락: 없음
범위 초과: 없음
명세 모순: 없음
결론
승인 계약의 19개 criterion이 모두 충족돼 approve다. Review 76의 F01-F04는 현재 head의 화면 필드와 저장 상태 표시, 필드별 데이터 모델, 공개 정책 응답 오류 계약, 실제 private module 책임 및 named 회귀 assertions로 해소됐다. 잔여 finding과 신규 finding은 해당 없음이다. 문서 보완은 필수 승인 계약의 누락 해소이며 별도 새 요구사항이나 blocker를 추가하지 않았다. Product 실행은 구현자의 exact-head 기록이고 reviewer는 제품 테스트를 실행하지 않았다. 기존 혼합 AC 분류는 자동 구조 검사의 비지원 범위라 직접 대조했으며 CI와 Chromium 성공은 주장하지 않는다.
## 구현 명세 적합성 검토
- Source Issue: #18
- Pull Request: #19
- Reviewed head: `ae4383ca2cf5cf576d9b370f6d62828b616d9418`
- Contract SHA-256: `7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6`
- Verdict: `approve`
### Acceptance criteria 판정
- `C01` — `satisfied`
- 계약: 기존 초안 생성 수정 검토 승인 최종 마감을 확장하고 정책과 집계 버전을 보존하며 여섯 총계와 양 영역 상세 및 경고를 제공한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py; settlement_draft_service.py 133-157,160-171,240-250,349-357; migrations.py 36. test_draft_previews_six_totals_without_creating_run, test_policy_setter_persists_explicit_lists_and_changes_review_fingerprint의 호출과 assertions를 직접 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 별도 초안 현금흐름 테이블 없이 기존 lifecycle과 durable 정책을 확장하며 완료 조회는 저장 응답을 사용한다.
- `C02` — `satisfied`
- 계약: asset_snapshot_runs에 지정된 월 통화 여섯 총계 정책 집계 버전 저장 구조 버전 당시 근거를 추가하고 기존 연결과 승인 정보를 유지한다.
- 구현 근거: jarca_ledger_mcp/infrastructure/sqlite/schema.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py, jarca_ledger_mcp/application/settlement_draft_service.py; schema.py 193-213; migrations.py 145-171; settlement_draft_service.py 413. test_closed_header_persists_six_totals_policy_and_versions와 legacy migration test를 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
- 테스트 근거: tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement.py
- 판정 근거: 새 종합 run은 모든 지정 필드를 쓰며 자산 전용 기존 API는 그대로다. 구버전은 nullable 열을 추가하고 소급 집계를 하지 않는다.
- `C03` — `satisfied`
- 계약: 자산 상세의 기존 run 연결과 자산 부채 구분 금액 평가일 평가자료 ID exact 이월 대체 포함 제외 및 사유를 고정 근거와 반환 계약에 보존한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/application/assets_service.py; settlement_draft_service.py 75-144,405-418,429-459; monthly_settlement_service.py 221-244. asset authority와 mixed-sign liability tests 및 date_metadata_public_contract_names test의 실제 assertions를 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_draft_contract_scenarios.py
- 판정 근거: 원본 부채 금액과 적용 기여도를 구분하고 기존 abs of raw loan sum 의미를 유지한다. 제외 항목의 적용 금액은 NULL이며 기존 고정 자산 근거를 연결한다.
- `C04` — `satisfied`
- 계약: settlement_cashflow_snapshots의 지정 8개 필드 헤더 외래키 5요소 유일 제약 run 인덱스 및 빈 분류의 명시적 보존을 제공한다.
- 구현 근거: jarca_ledger_mcp/infrastructure/sqlite/schema.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; schema.py 217-228; migrations.py 158-171. test_cashflow_detail_constraints_preserve_blank_categories는 음수 저장, FK, NULL, kind, count, unique5, blank 보존 및 헤더 삭제 거부를 검사한다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
- 테스트 근거: tests/test_settlement_cashflow_schema.py
- 판정 근거: signed INTEGER와 positive count를 검증하고 category와 subcategory는 NOT NULL이다. 외래키 RESTRICT와 run 조회 인덱스가 존재한다.
- `C05` — `satisfied`
- 계약: 활성 거래의 월초 이상 다음 월초 미만을 집계하고 월말 평가를 사용한다. 환급월 음수 지출 명시적 저축 목록 대출상환 지출 이체 초기잔액 상품권 제외 우선 및 미결정 분류 승인 차단을 적용한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py; settlement_cashflow_service.py 46-126; approval 371, finalize 398. movement_precedence, month_boundaries_refund_month_negative_total_and_fx_blocker, refund_reduces_debt_payment_and_selected_savings, unknown_classification_blocks_and_explicit_exclusion_unblocks를 호출 인수와 assertions까지 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
- 테스트 근거: tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement.py
- 판정 근거: 선택한 investment pair만 저축으로 지출 처리하고 일반 이체 및 명시적 충전 제외가 우선한다. 환급은 음수로 남고 unknown은 확정 제외로 위장하지 않는다. 자산 조건부 플래그로 차단을 우회하지 못한다.
- `C06` — `satisfied`
- 계약: 당시 거래 날짜 금액 통화 유형 분류 원래 및 적용 구분 정책 판단과 자산 원본 평가자료 적용 금액 출처 이월 대체 누락 제외를 보존한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; cashflow source projection 104-109; draft asset source 140-145; header policy and source write 413; saved reader 225-250. source_snapshot_preserves_reproducible_values_without_raw_secrets와 stored_reader_keeps_required_transaction_date를 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 거래 ID만 남기지 않고 계산 입력을 고정한다. 자산 고정 근거와 source_snapshot이 같은 run에 연결되며 당시 정책은 헤더에 저장된다.
- `C07` — `satisfied`
- 계약: 검토 승인 지문에 거래 집합 당시 값 분류 정책 버전 결과 여섯 총계 평가자료 포함 제외 미확정 상태를 결속하고 관련 drift와 승인 저장 결과 불일치를 거부한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py; draft review serial 148; approval 368-376; finalize 395-445. source_policy_and_category_drift_invalidate_approval, policy_edit_persists_versions_and_invalidates_approval, stored_aggregation_version_drift_invalidates_approval와 persisted tampering tests를 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 거래 집합 전체와 정책 및 집계 결과가 지문에 포함된다. 정책 변경은 version 증가와 승인 무효화이며 최종 저장값도 승인 결과와 대조한다.
- `C08` — `satisfied`
- 계약: 한 DB 트랜잭션에서 헤더 양 상세 근거 초안 완료 연결과 저장 응답을 기록하고 여섯 계산식 및 실제 저장 일치를 검증하며 불일치와 중간 실패는 전부 롤백한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py; BEGIN IMMEDIATE 385; persisted group/header/evidence/asset comparison 421-445; completed response write 462. header/assets/cashflow/completion injection과 header_total/asset_amount/asset_currency/header_source/header_policy/header_version tampering assertions를 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
- 테스트 근거: tests/test_comprehensive_settlement.py
- 판정 근거: 수입 지출 합계와 차 및 자산 부채 합계와 차를 같은 run에서 대조한다. 오류는 context-manager transaction 밖으로 전달되어 완료 상태도 남기지 않는다.
- `C09` — `satisfied`
- 계약: 동일 멱등 키와 동일 승인 요청은 동일 run과 저장 응답을 반환하고 다른 요청은 충돌한다. 과거 마감은 불변이고 최신 parent 단일 child 정정은 append하며 각각 exact run으로 조회한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; finalize replay 386-400; initial and correction unique indexes; exact reader 164-201. concurrent_close_retries_return_one_saved_result, replay_and_correction_keep_each_run_immutable, completed_get_and_saved_snapshot_ignore_later_live_ledger_changes의 실제 assertions를 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_draft_correction_contract.py
- 판정 근거: 재시도는 live review 전에 저장 응답을 반환한다. 정정의 최신 parent 및 unique child 경계를 유지하며 최초와 정정 상세는 run으로 분리된다.
- `C10` — `satisfied`
- 계약: additive idempotent 이관은 미보존 구버전 총계를 NULL로 남기고 소급 backfill이나 fake zero를 하지 않는다. 기존 미마감 초안은 종합 검토 재승인 후 마감한다.
- 구현 근거: jarca_ledger_mcp/infrastructure/sqlite/migrations.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; schema13 fixture를 실제 baseline DDL과 대조했다. migrations.py nullable header additions; test_legacy_migration_is_idempotent_and_keeps_unstored_totals_null 및 test_legacy_asset_approval_requires_comprehensive_review_before_close를 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
- 테스트 근거: tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement.py
- 판정 근거: 기존 초안과 자산 마감을 유지하며 asset-only 과거 지문은 새 종합 지문과 다르므로 마감할 수 없다. old-column reader는 조회 중 migrate하지 않는다.
- `C11-F01` — `satisfied`
- 계약: MCP 및 인증된 Dashboard에서 종합 초안과 저장 마감 결과를 제공하고 현재 보고와 구분하며 구버전 부분 자료 누락 제외를 표시한다. Dashboard는 목록 입력 경고 및 승인 불가 사유를 전달 표시한다.
- 구현 근거: dashboard/page_views/settlement_drafts.py, dashboard/page_views/monthly_settlement.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/adapters/mcp/server.py, jarca_ledger_mcp/adapters/mcp/tool_contracts.py, jarca_ledger_mcp/adapters/streamlit/settlement_gateway.py; F01 해소: settlement_drafts.py 212-223은 transaction_id와 reason을 표시하고 blocker가 있으면 승인 버튼을 막는다. monthly_settlement.py 275-302는 close_status legacy is_comprehensive와 NULL 미보존 및 안전 필드의 저장 자산 근거와 source assets의 missing/excluded를 표시한다. test_draft_cashflow_blocker_renders_safe_transaction_id_and_reason 및 두 parameter의 test_saved_monthly_snapshot_renders_close_legacy_and_asset_evidence는 실제 표시 값과 승인 disabled 및 비공개 필드 비노출 assertions를 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement_adapters.py
- 판정 근거: 서비스의 차단 원인과 대상 거래가 표시되고 부분 또는 구버전 마감이 완전한 현재 보고로 오인되지 않는다. 기존 인증과 읽기 no-write 근거를 유지한다.
- `C12` — `satisfied`
- 계약: synthetic 검증으로 여섯 식 정책 drift 재시도 동시성 롤백 역사 불변 정정 분리 NULL 이관 기존 API MCP Dashboard 호환을 검증한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; 새 exact-head i18-message-exact-ae4383ca2cf5 manifest digest 99e30de8b894cee65c1826d0b4d39709d7ab62c6cb42353534947d221e20ab42와 plan 및 169개 Git blob을 독립 대조했다. 구현자 전체 503 passed 4 skipped 1 warning, adversarial 70 passed, Ruff exit 0이다. 이전 collection 500개와 current 507개 ID 및 status의 source-binding과 check-tests가 통과했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py, tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement_adapters.py
- 판정 근거: 필수 service와 transport 검증의 구현자 실행을 채택한다. 신규 UI 및 문서 회귀의 호출 인수와 assertions를 직접 대조했고 reviewer 제품 테스트 실행이나 Chromium browser 또는 CI 성공으로 표현하지 않는다.
- `C13` — `satisfied`
- 계약: 정수 정밀도 NULL과 zero KRW 권위 verified 평가 대표 부채 및 투자 중복 합산 금지 읽기 no-create auth-before-DB credential 비노출을 유지한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/application/shared.py, dashboard/app.py; 기존 자산 authority source는 변경되지 않았고 new reader는 read_db를 사용한다. KRW blocker 101-103과 recursive saved projection 228-244 및 authentication before database ordering을 확인했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement_adapters.py, tests/test_settlement_draft_policy_consistency.py
- 판정 근거: 동일 통화 권위와 기존 자산 승인 정책을 유지한다. 실제 credential 없이 synthetic 인수 기록만 읽었으며 unknown output field를 allowlist로 제거한다.
- `C14` — `satisfied`
- 계약: 독립 정산 lifecycle 원장 자동 재작성 소급 집계 새 FX 가격 인증 메뉴 변경과 별도 현금흐름 조건부 승인을 도입하지 않는다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/adapters/mcp/server.py; 30개 변경 파일과 62개 API hunk를 exact base/head Git blob에 대조했다. 이전 검토 이후 7개 변경 파일은 두 화면, 세 정본 문서 및 두 회귀 테스트 파일이며 private service와 저장 lifecycle은 이전 reviewed head와 byte-identical이다.
- 테스트 근거: 없음
- 판정 근거: 모든 변경은 승인된 extension 또는 필수 문서와 지적 보완 검증에 대응한다. 독립 정산 FX 인증 메뉴 변경이나 범위 초과는 없다.
- `D01` — `satisfied`
- 계약: REQ-003의 ID 경로 제목을 유지하고 revision을 올려 기존 계약과 전체 baseline AC 의미를 보존하며 Issue 18과 실제 구현 PR 19를 기존 traceability에 추가한다.
- 구현 근거: docs/requirements/req-003_account-valuation-history.md; REQ-003 1-16,175-197,199-849,863-880. baseline의 38개 requirement/AC ID와 의미를 모두 대조했고 10개 새 AC를 추가했다. 11개 정본 섹션과 순번을 확인했다. read-only AC classification helper는 기존 10개 inline classification 때문에 exit 2이므로 자동 구조 PASS를 주장하지 않는다. 각 inline 블록의 level/backend/Cases/State Invariants와 신규 flat 블록을 직접 대조했다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
- 테스트 근거: tests/test_requirement_docs.py, tests/test_settlement_draft_docs.py
- 판정 근거: 기존 인수 의미 손실은 없고 새 정책과 저장 계약 및 실제 PR 19가 명시됐다. 기존 혼합 분류 형식의 구조 검사 한계는 문서 정규화 참고 사항이며 제품 동작 결함이나 새 mandatory gate로 승격하지 않는다.
- `D02-F02` — `satisfied`
- 계약: 데이터 모델은 확정 헤더 추가 필드별 타입 NULL legacy 의미 필수성과 초안 정책 집계 버전 JSON 재현 입력 신규 상세 전체 필드와 제약을 명세한다.
- 구현 근거: docs/data-model.md, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; F02 해소: docs/data-model.md 198-243의 세 필드 표와 재현 입력을 migrations.py 36,145-170 및 schema.py 193-228과 대조했다. 열 타입 nullability default와 logical identifier 필수성, 신규 종합 마감의 모든 열 제공, legacy NULL, 원래 양수 환급과 적용 음수 및 당시 자산 입력이 명시됐다. test_settlement_cashflow_model_documents_schema_and_legacy_reproduction는 실제 PRAGMA 표와 전체 지정 필드를 비교한다.
- 테스트 근거: tests/test_settlement_cashflow_schema.py
- 판정 근거: 헤더 초안 상세의 필드별 계약과 정책 버전 당시 입력을 통한 재현 경계가 보완됐다. 정본 기존 승인 완료 지문 응답 및 원자성 계약은 유지된다.
- `D03-F03` — `satisfied`
- 계약: 인터페이스 계약은 기존 초안 operation의 정책 버전 여섯 총계 카테고리 상세 누락 경고 입력 출력과 필수성, 저축 목록 편집 환급 음수 및 미분류 차단 오류 재검토를 정의하고 실제 함수 도구 시그니처와 응답 예시를 구현에 대조한다.
- 구현 근거: docs/interface-contract.md, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; F03 해소: docs/interface-contract.md 475-514의 normalized policy entry schema, positional setter, six-total type/presence/legacy 표 및 response nesting, cashflow detail와 blocker 필드, 음수 환급 JSON 예시 및 validation_error 재검토 계약을 정책 validator와 review/finalize/saved reader에 대조했다. test_settlement_cashflow_interface_specifies_valid_policy_review_and_response_examples와 test_cashflow_policy_documented_signature_matches_public_api의 validator 인수와 assertions를 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement_adapters.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 공개 정책 입력과 출력 필수성 및 승인 차단 재검토를 소비자가 구성할 수 있다. 예시는 선택 필드라는 한계를 명시하고 root review와 saved reader를 구분한다. 기존 자산 플래그로 차단 우회 금지와 확정 제외 및 기존 envelope 계약은 유지된다.
- `D04-F04` — `satisfied`
- 계약: 프로젝트 구조 문서는 기존 service 책임과 실시간 보고의 구분 공통 business 집계 계층 및 실제 필요한 새 모듈 경로와 검증 책임을 구현 결과에 결속한다.
- 구현 근거: docs/project-structure.md, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py; F04 해소: docs/project-structure.md 248-250의 실제 private settlement_cashflow_service.py 책임 표는 _normalize_cashflow_policy와 _review_cashflow 및 settlement_draft_service.py caller와 두 test 경로를 연결한다. test_settlement_cashflow_private_service_has_explicit_ownership_and_test_mapping의 단일 책임 행과 필수 symbol assertions를 확인했다.
- 테스트 근거: tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement_adapters.py
- 판정 근거: 실제 공통 집계의 소유권과 호출 및 검증 관계를 정본에 보완했다. transport에 SQL 또는 별도 정책을 복제하지 않는다.
- `D05` — `satisfied`
- 계약: 런타임 흐름은 명시적 정책 설정 현재 재집계 종합 지문 승인 트랜잭션 재검증 여섯 식과 원자 저장 저장 조회 및 정책별 제외 음수 차단 재검토 롤백 동시 replay 정정 흐름을 명세한다.
- 구현 근거: docs/runtime-flow.md; docs/runtime-flow.md 276-280와 기존 lifecycle/no-create/privacy/correction 절을 함께 대조했다. 월 범위 정책 mapping unresolved blocker approval 재검증 same transaction rollback persisted replay latest parent append 및 stored/live 구분을 모두 기록한다. 이전 reviewed head와 해당 구현 및 기존 테스트의 Git blob 또는 함수 AST가 동일한 범위를 확인했고 current exact-head 구현자 실행에 결합했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 원래 source authority와 credential 비노출 및 관찰 metadata의 기존 계약을 유지한다. F01의 실제 Dashboard 표현 누락은 런타임 설명의 존재만으로 해소되지 않는다.
### 범위 판정
- 누락: 없음
- 범위 초과: 없음
- 명세 모순: 없음
### 결론
승인 계약의 19개 criterion이 모두 충족돼 approve다. Review 76의 F01-F04는 현재 head의 화면 필드와 저장 상태 표시, 필드별 데이터 모델, 공개 정책 응답 오류 계약, 실제 private module 책임 및 named 회귀 assertions로 해소됐다. 잔여 finding과 신규 finding은 해당 없음이다. 문서 보완은 필수 승인 계약의 누락 해소이며 별도 새 요구사항이나 blocker를 추가하지 않았다. Product 실행은 구현자의 exact-head 기록이고 reviewer는 제품 테스트를 실행하지 않았다. 기존 혼합 AC 분류는 자동 구조 검사의 비지원 범위라 직접 대조했으며 CI와 Chromium 성공은 주장하지 않는다.
<!-- gitea-agent:implementation-spec-review/v1 owner=jsfamily repository=jarca-ledger-mcp issue=18 pr=19 head=ae4383ca2cf5cf576d9b370f6d62828b616d9418 contract-sha256=7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6 result-sha256=2fda3c9e12cfb6e581eb07d13b885f81abcce05ff06874402fc8ff4ff2aff1ae correlation=9991d5f40d249503f2b00370b4adcd91c44ff1ed97332e516bda296b515169df -->
발생 조건: 카테고리가 exclude로 등록되어 거래에 사용된 뒤 공개 delete_ledger_category(..., force=True)로 비활성화된다. 그 거래는 여전히 active이고 초안에 별도 제외 정책 판단은 없다.
실패: 신규 JOIN은 lc.active=1 조건 없이 비활성 행의 cashflow_kind를 읽는다. 해당 지출은 excluded로 집계되고 blocker 없이 승인/저장된다. 동시에 sourceprovenance는 fallback이라 기록하지만 실제 원래 분류는 비활성 행의 exclude다. 기존 활성 분류 기반 보고의 fallback과 계산 근거가 불일치한다.
직접 재현: synthetic 거래 50원에 대해 현재 live 보고 expenses=50, 종합 마감 expense_total=0; 저장 source는 category_active=0, originalcashflow_kind=exclude, cashflow_kind=excluded, sourceprovenance=fallback. 공개 API 생성·비활성화·검토·승인·마감까지 실제 SQLite로 수행했다.
계약 관계/영향: Issue의 기존 cashflow 분류 일관성, 당시 적용 분류와 판단의 재현 및 C05/C06에 해당한다. 승인된 환급/저축/대출상환 mapping과 다른, 비활성 분류를 금액 권위로 쓰는 변경은 승인 정책에 없다. 거래가 명시적 판단 없이 지출에서 빠져 불변 재무 마감에 고정되므로 별도 기술부채로 미룰 수 없다.
제한된 수정 방향: 종합 JOIN도 기존 활성 카테고리 권위 경계에 맞추고, 실제 적용한 category/fallback과 저장 provenance가 일치하도록 한다. 비활성 expense/income/transfer/exclude/unknown 분류와 공개 soft-delete 경로를 named synthetic 회귀로 검증한다. live 보고 정책을 변경해 차이를 숨기지 않는다.
F-002 — 구버전 조건부 마감의 헤더에 저장된 누락·제외 근거가 신규 저장 조회에서 사라짐
발생 조건: 지원 baseline의 실제 close_asset_snapshot(..., allow_missing_exclusions=True, approved_by=..., approval_reason=..., approval_reference=...)로 누락 계좌를 명시 승인한 자산 전용 조건부 마감을 만든다. 이 기존 API는 반영 항목만 상세 row로 쓰고 누락·제외는 헤더 excluded_evidence에 보존한다 (assets_service.py:864-920).
실패: 신규 reader는 _snapshot_rows_for_run에서 이미 읽은 metadata의 excluded_evidence/carried_evidence를 반환에 반영하지 않는다. legacy에서는 source_snapshot={}이고 items는 반영 상세 row만 남는다. 따라서 누락 계좌 ID와 missing_verified_exact_valuation 사유가 전체 신규 응답에서 사라진다. 신규 저장 패널도 items와 source_snapshot.assets만 사용하므로 해당 근거를 표시할 수 없다. close_status=conditional만으로 어떤 항목이 빠졌는지 알 수 없다.
직접 재현: baseline full SHA의 Git blob을 메모리 import하여 실제 공개 API로 schema13 fixture를 생성한 뒤 현재 init_db로 이관했다. 기존 get_asset_snapshot_report는 전후 완전히 같고 누락 계좌 ID/사유를 반환한다. 신규 get_monthly_settlement_snapshot은 성공/legacy/conditional이지만 해당 ID/사유를 반환하지 않는다. 조회 전후 DB dump는 동일하다.
계약 관계/영향: C03/C10/C11과 Issue의 구버전·부분 자료·누락/제외 표시 의무다. 저장된 근거가 있는데도 정확한 historical run 조회에서 사라져 부분 마감의 해석과 확인을 막는다. spec review 76의 UI 수정은 mock items에 제외 항목이 있는 경우를 검증하지만 실제 기존 직접 마감은 그 행을 쓰지 않는다. 이 미검증 경로는 현재 요구 범위이며 별도 개선으로 미룰 수 없다.
제한된 수정 방향: 기존 safe public evidence projection을 재사용하여 exact run의 헤더 누락·제외·이월/평가일 근거를 additive 반환하고 저장 패널에 표시한다. raw JSON/메모/인증정보를 노출하거나 legacy 총계를 backfill/0으로 만들지 않는다. 실제 baseline public API fixture로 reader와 Dashboard의 누락 ID/사유·당시 평가일을 named 회귀 검증한다.
검토 범위와 실행 근거
30개 변경 파일의 전체 base-to-head diff, 관련 classifier/자산 권위/DB read-write context/기존 소비자/adapter/UI 및 테스트 assertion을 검토했다. 코드 reviewer의 이번 head 첫 리뷰이며 spec 수정 F01-F04도 현재 diff에서 확인했다. 코드·문서·테스트 수정, commit/push/merge/Issue 변경은 하지 않았다. 위임 근거는 사용하지 않았다 (mode=none).
Reviewer 직접 실행: 8개 관련 test module 94 passed, exit 0. 정책/음수 환급/unknown·FX 차단, drift, 상세/헤더 변조와 롤백, 동시 replay·정정, migration constraints, 실제 MCP stdio 및 synthetic-auth AppTest 포함.
Reviewer 별도 semantic probe: 실제 baseline 공개 write API fixture의 기존 자산 보고/완료 응답 보존, legacy NULL, additive/idempotent migration, 종합 재승인과 append-only 정정 통과. 추가 boundary probe가 F-001/F-002를 확인했다. Probe는 위반 동작을 관측하도록 작성되어 exit 0이며, 제품 수정의 TDD RED/GREEN으로 주장하지 않는다.
두 reviewer manifest는 evidence-manifest/v3; command/exit/output/environment/timeout/termination/source 결속과 validate exit 0 확인. 모든 child 종료/reap/group cleanup 확인. git diff --check exit 0.
구현자 exact-head 기록은 별도 재사용 근거: 503 passed, 4 skipped, 1 warning, adversarial 70 passed, Ruff exit 0. Manifest SHA-256 99e30de8b894cee65c1826d0b4d39709d7ab62c6cb42353534947d221e20ab42, 169개 Git blob digest를 독립 대조/validate했다. Baseline/current collection 435/507 ID의 source-binding 및 check-tests 통과, 기존 ID/status 보존을 확인했다. 이 전체 suite를 reviewer 재실행으로 표현하지 않는다.
Remote head CI/status 항목은 비어 있다. 실제 Chromium·운영 원장 검증은 하지 않았으며 AppTest와 동일시하지 않는다. 지원 환경의 Python 3.13.5, pytest 9.1.1, MCP 1.28.0, Streamlit 1.58.0, Starlette 1.3.1, httpx 0.28.1을 확인했다.
이관 전 schema13 활성 draft get는 새 aggregation_version 부재로 db_error를 반환하지만 명시 init_db 이관 후 재검토/재승인은 가능했다. 이관 선행 제한으로 기록하며 별도 blocker로 승격하지 않는다.
위험 matrix: 정책/분류·공개 historical 근거 경계 실패(F-001/F-002); 승인 drift·원자성·멱등/정정·schema·privacy/no-create·기존 자산 소비자·테스트 보존은 위 근거 범위에서 통과. Chromium은 선택적 미검증이다.
증빙 위치 및 결론
/opt/data/gitea-agent/repositories/jsfamily/jarca-ledger-mcp/worktrees/issue-18/verification/의 review-20261013_214000_556c6ef9와 review-boundary-20261013_214000_556c6ef9에 main 결과·위험 matrix·실제 명령과 출력·source binding을 보존했다. Same-UID local evidence이며 다른 host 공개 접근을 주장하지 않는다.
F-001/F-002의 제한된 수정과 해당 회귀 검증 후, 새 exact head의 spec pass → 독립 code 재리뷰가 필요하다. merge/release 승인이 아니다.
<!-- gitea-agent:code-review/v1 owner=jsfamily repository=jarca-ledger-mcp issue=18 pr=19 head=ae4383ca2cf5cf576d9b370f6d62828b616d9418 contract-sha256=7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6 -->
## 독립 코드 리뷰
- Verdict: `request_changes`
- Source Issue: #18 / Pull Request: #19
- Reviewed head: `ae4383ca2cf5cf576d9b370f6d62828b616d9418`
- Base: `f67c07adf01d1f17415bf7cf836f46997ca6f21c`
- Contract SHA-256: `7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6`
- 현재 head의 spec 승인: review #77, `gitea-spec-agent`, APPROVED / nonstale / nondismissed.
- 사용 스킬: 실제 하네스 `harness/agents/review/skills/gitea-code-review/SKILL.md`.
### F-001 — 비활성 카테고리 분류를 적용하여 지출을 조용히 제외함
- 심각도: 높음 / 승인 전 수정 필요.
- 위치: `jarca_ledger_mcp/application/settlement_cashflow_service.py:50-56,76-77,104-108`.
- 발생 조건: 카테고리가 `exclude`로 등록되어 거래에 사용된 뒤 공개 `delete_ledger_category(..., force=True)`로 비활성화된다. 그 거래는 여전히 active이고 초안에 별도 제외 정책 판단은 없다.
- 실패: 신규 JOIN은 `lc.active=1` 조건 없이 비활성 행의 `cashflow_kind`를 읽는다. 해당 지출은 excluded로 집계되고 blocker 없이 승인/저장된다. 동시에 `sourceprovenance`는 `fallback`이라 기록하지만 실제 원래 분류는 비활성 행의 `exclude`다. 기존 활성 분류 기반 보고의 fallback과 계산 근거가 불일치한다.
- 직접 재현: synthetic 거래 50원에 대해 현재 live 보고 `expenses=50`, 종합 마감 `expense_total=0`; 저장 source는 `category_active=0`, `originalcashflow_kind=exclude`, `cashflow_kind=excluded`, `sourceprovenance=fallback`. 공개 API 생성·비활성화·검토·승인·마감까지 실제 SQLite로 수행했다.
- 계약 관계/영향: Issue의 기존 cashflow 분류 일관성, 당시 적용 분류와 판단의 재현 및 C05/C06에 해당한다. 승인된 환급/저축/대출상환 mapping과 다른, 비활성 분류를 금액 권위로 쓰는 변경은 승인 정책에 없다. 거래가 명시적 판단 없이 지출에서 빠져 불변 재무 마감에 고정되므로 별도 기술부채로 미룰 수 없다.
- 제한된 수정 방향: 종합 JOIN도 기존 활성 카테고리 권위 경계에 맞추고, 실제 적용한 category/fallback과 저장 provenance가 일치하도록 한다. 비활성 expense/income/transfer/exclude/unknown 분류와 공개 soft-delete 경로를 named synthetic 회귀로 검증한다. live 보고 정책을 변경해 차이를 숨기지 않는다.
### F-002 — 구버전 조건부 마감의 헤더에 저장된 누락·제외 근거가 신규 저장 조회에서 사라짐
- 심각도: 중간 / 승인 전 수정 필요.
- 위치: `jarca_ledger_mcp/application/monthly_settlement_service.py:221-225,251`, `dashboard/page_views/monthly_settlement.py:284-302`.
- 발생 조건: 지원 baseline의 실제 `close_asset_snapshot(..., allow_missing_exclusions=True, approved_by=..., approval_reason=..., approval_reference=...)`로 누락 계좌를 명시 승인한 자산 전용 조건부 마감을 만든다. 이 기존 API는 반영 항목만 상세 row로 쓰고 누락·제외는 헤더 `excluded_evidence`에 보존한다 (`assets_service.py:864-920`).
- 실패: 신규 reader는 `_snapshot_rows_for_run`에서 이미 읽은 metadata의 `excluded_evidence`/`carried_evidence`를 반환에 반영하지 않는다. legacy에서는 `source_snapshot={}`이고 `items`는 반영 상세 row만 남는다. 따라서 누락 계좌 ID와 `missing_verified_exact_valuation` 사유가 전체 신규 응답에서 사라진다. 신규 저장 패널도 `items`와 `source_snapshot.assets`만 사용하므로 해당 근거를 표시할 수 없다. `close_status=conditional`만으로 어떤 항목이 빠졌는지 알 수 없다.
- 직접 재현: baseline full SHA의 Git blob을 메모리 import하여 실제 공개 API로 schema13 fixture를 생성한 뒤 현재 `init_db`로 이관했다. 기존 `get_asset_snapshot_report`는 전후 완전히 같고 누락 계좌 ID/사유를 반환한다. 신규 `get_monthly_settlement_snapshot`은 성공/legacy/conditional이지만 해당 ID/사유를 반환하지 않는다. 조회 전후 DB dump는 동일하다.
- 계약 관계/영향: C03/C10/C11과 Issue의 구버전·부분 자료·누락/제외 표시 의무다. 저장된 근거가 있는데도 정확한 historical run 조회에서 사라져 부분 마감의 해석과 확인을 막는다. spec review 76의 UI 수정은 mock `items`에 제외 항목이 있는 경우를 검증하지만 실제 기존 직접 마감은 그 행을 쓰지 않는다. 이 미검증 경로는 현재 요구 범위이며 별도 개선으로 미룰 수 없다.
- 제한된 수정 방향: 기존 safe public evidence projection을 재사용하여 exact run의 헤더 누락·제외·이월/평가일 근거를 additive 반환하고 저장 패널에 표시한다. raw JSON/메모/인증정보를 노출하거나 legacy 총계를 backfill/0으로 만들지 않는다. 실제 baseline public API fixture로 reader와 Dashboard의 누락 ID/사유·당시 평가일을 named 회귀 검증한다.
### 검토 범위와 실행 근거
- 30개 변경 파일의 전체 base-to-head diff, 관련 classifier/자산 권위/DB read-write context/기존 소비자/adapter/UI 및 테스트 assertion을 검토했다. 코드 reviewer의 이번 head 첫 리뷰이며 spec 수정 F01-F04도 현재 diff에서 확인했다. 코드·문서·테스트 수정, commit/push/merge/Issue 변경은 하지 않았다. 위임 근거는 사용하지 않았다 (`mode=none`).
- Reviewer 직접 실행: 8개 관련 test module **94 passed**, exit 0. 정책/음수 환급/unknown·FX 차단, drift, 상세/헤더 변조와 롤백, 동시 replay·정정, migration constraints, 실제 MCP stdio 및 synthetic-auth AppTest 포함.
- Reviewer 별도 semantic probe: 실제 baseline 공개 write API fixture의 기존 자산 보고/완료 응답 보존, legacy NULL, additive/idempotent migration, 종합 재승인과 append-only 정정 통과. 추가 boundary probe가 F-001/F-002를 확인했다. Probe는 위반 동작을 관측하도록 작성되어 exit 0이며, 제품 수정의 TDD RED/GREEN으로 주장하지 않는다.
- 두 reviewer manifest는 `evidence-manifest/v3`; command/exit/output/environment/timeout/termination/source 결속과 validate exit 0 확인. 모든 child 종료/reap/group cleanup 확인. `git diff --check` exit 0.
- 구현자 exact-head 기록은 별도 재사용 근거: **503 passed, 4 skipped, 1 warning**, adversarial **70 passed**, Ruff exit 0. Manifest SHA-256 `99e30de8b894cee65c1826d0b4d39709d7ab62c6cb42353534947d221e20ab42`, 169개 Git blob digest를 독립 대조/validate했다. Baseline/current collection **435/507 ID**의 source-binding 및 `check-tests` 통과, 기존 ID/status 보존을 확인했다. 이 전체 suite를 reviewer 재실행으로 표현하지 않는다.
- Remote head CI/status 항목은 비어 있다. 실제 Chromium·운영 원장 검증은 하지 않았으며 AppTest와 동일시하지 않는다. 지원 환경의 Python 3.13.5, pytest 9.1.1, MCP 1.28.0, Streamlit 1.58.0, Starlette 1.3.1, httpx 0.28.1을 확인했다.
- 이관 전 schema13 활성 draft get는 새 aggregation_version 부재로 db_error를 반환하지만 명시 `init_db` 이관 후 재검토/재승인은 가능했다. 이관 선행 제한으로 기록하며 별도 blocker로 승격하지 않는다.
- 위험 matrix: 정책/분류·공개 historical 근거 경계 실패(F-001/F-002); 승인 drift·원자성·멱등/정정·schema·privacy/no-create·기존 자산 소비자·테스트 보존은 위 근거 범위에서 통과. Chromium은 선택적 미검증이다.
### 증빙 위치 및 결론
`/opt/data/gitea-agent/repositories/jsfamily/jarca-ledger-mcp/worktrees/issue-18/verification/`의 `review-20261013_214000_556c6ef9`와 `review-boundary-20261013_214000_556c6ef9`에 main 결과·위험 matrix·실제 명령과 출력·source binding을 보존했다. Same-UID local evidence이며 다른 host 공개 접근을 주장하지 않는다.
F-001/F-002의 제한된 수정과 해당 회귀 검증 후, 새 exact head의 spec pass → 독립 code 재리뷰가 필요하다. merge/release 승인이 아니다.
변경: application/settlement_cashflow_service.py and tests/test_settlement_cashflow_policy.py: active-category authority and persisted fallback provenance
검증: Named inactive-category public-close regression RED then GREEN; final exact-head full suite exit 0
근거: Inactive classifications no longer override existing legacy fallback; refund, movement and explicit decision semantics retained
검증: Actual baseline schema-13 public API fixture migrated; original asset report preserved, exact/latest agreement and no-write assertions passed; actual gateway AppTest RED then GREEN
근거: Excluded, carried and approval evidence retained without reconstructing it from snapshot rows
최종 검증
Local checks: Exact head full pytest: 509 passed, 4 skipped, 1 warning; exit 0. Ruff --no-cache: exit 0. Canonical manifest validation: exit 0. Remote ZIP attachment 584e7f9a-91d4-46bb-9e1d-c33bd980f6e3, SHA-256 8633cab871737f4f950d85cf65f38b4f9456db306310c525bd2f5071fe669ee1. PR body payload reflected; publication verification remains partial because content_version changed 4 to 5 outside current allowed-field contract.
Runtime/browser: Actual SQLite, MCP tests and framework AppTest verified; no claim of actual Chromium validation. Prior PR-patch partial receipt preserved; this handoff does not promote that operation to verified.
Commit status: 조회 불가
Actions runs: 조회 불가
다음 단계
Reviewer가 rework head를 새 snapshot으로 다시 검토해야 하며 이 comment는 기존 REQUEST_CHANGES를 해제하거나 승인을 의미하지 않는다.
## 구현 재작업 결과
- Source Issue: 18
- Pull Request: 19
- Source Review: 78
- Reviewed head: `ae4383ca2cf5cf576d9b370f6d62828b616d9418`
- Rework head: `10201cdb7573546daaa11a4e3df2a8f628a1493e`
- Contract SHA-256: `7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6`
- Result: `partial`
### 지적 처리
- F-001 — `resolved`
- 분류: valid_fix
- 변경: application/settlement_cashflow_service.py and tests/test_settlement_cashflow_policy.py: active-category authority and persisted fallback provenance
- 검증: Named inactive-category public-close regression RED then GREEN; final exact-head full suite exit 0
- 근거: Inactive classifications no longer override existing legacy fallback; refund, movement and explicit decision semantics retained
- F-002 — `resolved`
- 분류: valid_fix
- 변경: application/monthly_settlement_service.py, dashboard/page_views/monthly_settlement.py, comprehensive tests and docs/interface-contract.md: persisted header evidence projection
- 검증: Actual baseline schema-13 public API fixture migrated; original asset report preserved, exact/latest agreement and no-write assertions passed; actual gateway AppTest RED then GREEN
- 근거: Excluded, carried and approval evidence retained without reconstructing it from snapshot rows
### 최종 검증
- Local checks: Exact head full pytest: 509 passed, 4 skipped, 1 warning; exit 0. Ruff --no-cache: exit 0. Canonical manifest validation: exit 0. Remote ZIP attachment 584e7f9a-91d4-46bb-9e1d-c33bd980f6e3, SHA-256 8633cab871737f4f950d85cf65f38b4f9456db306310c525bd2f5071fe669ee1. PR body payload reflected; publication verification remains partial because content_version changed 4 to 5 outside current allowed-field contract.
- Runtime/browser: Actual SQLite, MCP tests and framework AppTest verified; no claim of actual Chromium validation. Prior PR-patch partial receipt preserved; this handoff does not promote that operation to verified.
- Commit status: 조회 불가
- Actions runs: 조회 불가
### 다음 단계
Reviewer가 rework head를 새 snapshot으로 다시 검토해야 하며 이 comment는 기존 `REQUEST_CHANGES`를 해제하거나 승인을 의미하지 않는다.
<!-- gitea-agent:implementation-rework/v1 owner=jsfamily repository=jarca-ledger-mcp issue=18 pr=19 review=78 reviewed-head=ae4383ca2cf5cf576d9b370f6d62828b616d9418 head=10201cdb7573546daaa11a4e3df2a8f628a1493e contract-sha256=7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6 result-sha256=739e7e7fa45d60e61e4c9875c60cd88007b427a21f6ca84951dc17b2c95c54ad correlation=0d4dc80544fb026a4afeec24828948c31c0c2a8d6021f88eacae81b841d0517b -->
테스트 근거: tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement.py
판정 근거: 새 종합 run은 모든 지정 필드를 쓰며 자산 전용 기존 API는 그대로다. 구버전은 nullable 열을 추가하고 소급 집계를 하지 않는다.
C03 — satisfied
계약: 자산 상세의 기존 run 연결과 자산 부채 구분 금액 평가일 평가자료 ID exact 이월 대체 포함 제외 및 사유를 고정 근거와 반환 계약에 보존한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/application/assets_service.py; settlement_draft_service.py 75-145 및 monthly_settlement_service.py 221-254와 assets_service.py 424-463을 대조했다. Review 78 F-002의 헤더 제외 이월 적용 승인 근거는 기존 strict public projection으로 반환된다. test_schema_thirteen_saved_reader_retains_real_conditional_header_without_writes는 pinned schema13 public API fixture 생성과 이관 후 기존 보고 동일성, exact와 latest 동일성, legacy NULL, 누락 ID와 사유 및 이월 평가일, approval, DB dump 불변을 검사한다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_draft_contract_scenarios.py
판정 근거: 원본 부채 금액과 적용 기여도를 구분하고 기존 abs of raw loan sum 의미를 유지한다. 제외 항목의 적용 금액은 NULL이며 기존 고정 자산 근거를 연결한다.
C04 — satisfied
계약: settlement_cashflow_snapshots의 지정 8개 필드 헤더 외래키 5요소 유일 제약 run 인덱스 및 빈 분류의 명시적 보존을 제공한다.
판정 근거: signed INTEGER와 positive count를 검증하고 category와 subcategory는 NOT NULL이다. 외래키 RESTRICT와 run 조회 인덱스가 존재한다.
C05 — satisfied
계약: 활성 거래의 월초 이상 다음 월초 미만을 집계하고 월말 평가를 사용한다. 환급월 음수 지출 명시적 저축 목록 대출상환 지출 이체 초기잔액 상품권 제외 우선 및 미결정 분류 승인 차단을 적용한다.
구현 근거: jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py; settlement_cashflow_service.py 46-126은 활성 카테고리 JOIN과 기존 CASHFLOW_KIND_SQL fallback으로 분류하며 제외 우선, 환급 음수, 선택 investment와 debt_payment 지출, unknown 및 FX blocker를 적용한다. Review 78 F-001 해소를 test_inactive_category_uses_raw_fallback_through_public_close의 9개 비활성 분류 사례, 공개 force 삭제 및 승인 마감과 저장 provenance assertions에 대조했다. test_explicit_decision_classifies_only_unresolved_inactive_fallback은 unknown의 명시 판단을 검사한다. 기존 정책 test의 인수와 assertions도 확인했다.
테스트 근거: tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement.py
판정 근거: 선택한 investment pair만 저축으로 지출 처리하고 일반 이체 및 명시적 충전 제외가 우선한다. 환급은 음수로 남고 unknown은 확정 제외로 위장하지 않는다. 자산 조건부 플래그로 차단을 우회하지 못한다.
C06 — satisfied
계약: 당시 거래 날짜 금액 통화 유형 분류 원래 및 적용 구분 정책 판단과 자산 원본 평가자료 적용 금액 출처 이월 대체 누락 제외를 보존한다.
구현 근거: jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; cashflow source 104-109와 draft source 140-145 및 header 413은 거래 당시 입력과 자산 원본 적용 값을 고정한다. 월 조회 228-254는 안전 projection과 헤더 근거를 반환한다. F-001의 fallback 원래 분류와 실제 적용 및 provenance가 일치하며 F-002의 historical 제외와 이월 근거가 반환된다. test_stored_reader_keeps_required_transaction_date와 test_saved_reader_projects_safe_header_exclusion_carry_and_approval_evidence의 날짜 보존과 unknown nested key 차단 및 DB dump 불변 assertions를 확인했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
판정 근거: 거래 ID만 남기지 않고 계산 입력을 고정한다. 자산 고정 근거와 source_snapshot이 같은 run에 연결되며 당시 정책은 헤더에 저장된다.
C07 — satisfied
계약: 검토 승인 지문에 거래 집합 당시 값 분류 정책 버전 결과 여섯 총계 평가자료 포함 제외 미확정 상태를 결속하고 관련 drift와 승인 저장 결과 불일치를 거부한다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_draft_correction_contract.py
판정 근거: 재시도는 live review 전에 저장 응답을 반환한다. 정정의 최신 parent 및 unique child 경계를 유지하며 최초와 정정 상세는 run으로 분리된다.
C10 — satisfied
계약: additive idempotent 이관은 미보존 구버전 총계를 NULL로 남기고 소급 backfill이나 fake zero를 하지 않는다. 기존 미마감 초안은 종합 검토 재승인 후 마감한다.
구현 근거: jarca_ledger_mcp/infrastructure/sqlite/migrations.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; nullable header 이관과 schema13 fixture DDL 및 실제 baseline public API fixture를 독립 pinned base blob에 대조했다. legacy migration 반복 NULL 보존 및 original header without migration, legacy asset approval 재승인 tests를 확인했다. Review 78 F-002의 실제 조건부 마감은 기존 자산 보고를 보존하면서 새 조회에서도 누락 및 이월 근거를 반환한다.
테스트 근거: tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement.py
판정 근거: 기존 초안과 자산 마감을 유지하며 asset-only 과거 지문은 새 종합 지문과 다르므로 마감할 수 없다. old-column reader는 조회 중 migrate하지 않는다.
C11-F01 — satisfied
계약: MCP 및 인증된 Dashboard에서 종합 초안과 저장 마감 결과를 제공하고 현재 보고와 구분하며 구버전 부분 자료 누락 제외를 표시한다. Dashboard는 목록 입력 경고 및 승인 불가 사유를 전달 표시한다.
구현 근거: dashboard/page_views/settlement_drafts.py, dashboard/page_views/monthly_settlement.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/adapters/mcp/server.py, jarca_ledger_mcp/adapters/mcp/tool_contracts.py, jarca_ledger_mcp/adapters/streamlit/settlement_gateway.py; Review 76 F01 해소를 settlement_drafts.py 212-223의 거래 ID 사유 및 승인 disabled, monthly_settlement.py 279-297의 상태 NULL 상세 표시에 확인했다. Review 78 F-002는 287-288에서 기존 evidence renderer로 헤더 excluded_items carried_items approval을 표시하여 해소했다. test_saved_monthly_panel_renders_real_conditional_exclusion_carry_and_approval 261-294는 실제 baseline API fixture와 현재 gateway를 사용하고 저장 response는 mock하지 않는다. 누락 ID 사유 이월 ID 평가일 승인자 사유 참조 표시 assertions를 확인했다. 이 page test는 live 요약 부분을 mock하며 실제 인증 통과 증명은 기존 synthetic-auth app test에 한정한다.
테스트 근거: tests/test_comprehensive_settlement_adapters.py
판정 근거: 서비스의 차단 원인과 대상 거래가 표시되고 부분 또는 구버전 마감이 완전한 현재 보고로 오인되지 않는다. 기존 인증과 읽기 no-write 근거를 유지한다.
C12 — satisfied
계약: synthetic 검증으로 여섯 식 정책 drift 재시도 동시성 롤백 역사 불변 정정 분리 NULL 이관 기존 API MCP Dashboard 호환을 검증한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; exact-head 구현자 manifest ab19e42dd541060c5dd7c0cdcf48fa0b2b82bb33df2dc3460c767607ea0b04fa와 plan fcb48c89681403bdb029924290621773334ac8e2281d6761ca71aa5e653b0b5b 및 169개 Git blob을 독립 대조했다. 전체 suite 509 passed 4 skipped 1 warning, Ruff exit 0이며 completed와 timeout 종료 기록이 결속된다. 이전 507개와 현재 513개 collection ID 및 status, 각 원래 revision과 stage의 source-binding 및 check-tests 통과를 확인했다. 현재 3개 변경 test file의 기존 함수 AST는 이전 reviewed head와 동일하고 6개 regression이 추가됐다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py, tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement_adapters.py
판정 근거: 필수 service와 transport 검증의 구현자 실행을 채택한다. 신규 UI 및 문서 회귀의 호출 인수와 assertions를 직접 대조했고 reviewer 제품 테스트 실행이나 Chromium browser 또는 CI 성공으로 표현하지 않는다.
C13 — satisfied
계약: 정수 정밀도 NULL과 zero KRW 권위 verified 평가 대표 부채 및 투자 중복 합산 금지 읽기 no-create auth-before-DB credential 비노출을 유지한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/application/shared.py, dashboard/app.py; 기존 자산 authority source는 변경되지 않았고 new reader는 read_db를 사용한다. KRW blocker 101-103과 recursive saved projection 228-244 및 authentication before database ordering을 확인했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement_adapters.py, tests/test_settlement_draft_policy_consistency.py
판정 근거: 동일 통화 권위와 기존 자산 승인 정책을 유지한다. 실제 credential 없이 synthetic 인수 기록만 읽었으며 unknown output field를 allowlist로 제거한다.
C14 — satisfied
계약: 독립 정산 lifecycle 원장 자동 재작성 소급 집계 새 FX 가격 인증 메뉴 변경과 별도 현금흐름 조건부 승인을 도입하지 않는다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/adapters/mcp/server.py; 30개 authoritative changed file과 62개 API hunk를 immutable base/head blob에 대조했다. 이전 approved head 이후 7개 파일 변경은 두 service, 저장 page, interface 문서와 세 test 파일이다. 기존 자산 직접 API, live report, 인증 및 메뉴 source는 변경되지 않았다. 모든 파일은 계약 criterion 또는 required supporting test로 연결했다.
테스트 근거: 없음
판정 근거: 모든 변경은 승인된 extension 또는 필수 문서와 지적 보완 검증에 대응한다. 독립 정산 FX 인증 메뉴 변경이나 범위 초과는 없다.
D01 — satisfied
계약: REQ-003의 ID 경로 제목을 유지하고 revision을 올려 기존 계약과 전체 baseline AC 의미를 보존하며 Issue 18과 실제 구현 PR 19를 기존 traceability에 추가한다.
구현 근거: docs/requirements/req-003_account-valuation-history.md; REQ-003 revision 1.2와 정확한 ID 경로 제목 및 기존 12와 15 이슈, 13과 16 PR, 새 Issue 18과 PR 19 traceability를 확인했다. pinned base의 38개 requirement와 AC 블록 및 global 계약 전체를 current 48개 블록과 대조했다. 34개 블록은 exact 동일하며 4개 변경은 승인된 schema14 additive 및 title 확장이다. 기존 검증 판정 및 불변 의미 손실은 없다. 기존 inline 분류 10개는 flat 구조 helper 비지원 범위이므로 분류 필드를 직접 대조했고 신규 AC18-27의 검증 경로와 assertions를 확인했다.
테스트 근거: tests/test_requirement_docs.py, tests/test_settlement_draft_docs.py
판정 근거: 기존 인수 의미 손실은 없고 새 정책과 저장 계약 및 실제 PR 19가 명시됐다. 기존 혼합 분류 형식의 구조 검사 한계는 문서 정규화 참고 사항이며 제품 동작 결함이나 새 mandatory gate로 승격하지 않는다.
D02-F02 — satisfied
계약: 데이터 모델은 확정 헤더 추가 필드별 타입 NULL legacy 의미 필수성과 초안 정책 집계 버전 JSON 재현 입력 신규 상세 전체 필드와 제약을 명세한다.
구현 근거: docs/data-model.md, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; F02 해소: docs/data-model.md 198-243의 세 필드 표와 재현 입력을 migrations.py 36,145-170 및 schema.py 193-228과 대조했다. 열 타입 nullability default와 logical identifier 필수성, 신규 종합 마감의 모든 열 제공, legacy NULL, 원래 양수 환급과 적용 음수 및 당시 자산 입력이 명시됐다. test_settlement_cashflow_model_documents_schema_and_legacy_reproduction는 실제 PRAGMA 표와 전체 지정 필드를 비교한다.
테스트 근거: tests/test_settlement_cashflow_schema.py
판정 근거: 헤더 초안 상세의 필드별 계약과 정책 버전 당시 입력을 통한 재현 경계가 보완됐다. 정본 기존 승인 완료 지문 응답 및 원자성 계약은 유지된다.
D03-F03 — satisfied
계약: 인터페이스 계약은 기존 초안 operation의 정책 버전 여섯 총계 카테고리 상세 누락 경고 입력 출력과 필수성, 저축 목록 편집 환급 음수 및 미분류 차단 오류 재검토를 정의하고 실제 함수 도구 시그니처와 응답 예시를 구현에 대조한다.
구현 근거: docs/interface-contract.md, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; docs/interface-contract.md 469-529에서 기존 정책 인수 exact entry schema 및 타입 중복 거부, 여섯 총계와 상세 blocker 필수성, version guard, 음수 환급 및 오류 재검토, response nesting과 synthetic examples를 구현에 대조했다. F03 보완은 유지된다. 신규 saved-reader additive metadata 503-516은 excluded_items carried_items applied_evidence approval의 타입 및 optional evidence key, recursive allowlist가 content redactor가 아닌 점, immutable header origin과 row-only legacy empty defaults를 실제 _closed_run_metadata 및 current reader에 맞게 명시한다.
테스트 근거: tests/test_comprehensive_settlement_adapters.py, tests/test_settlement_cashflow_policy.py
판정 근거: 공개 정책 입력과 출력 필수성 및 승인 차단 재검토를 소비자가 구성할 수 있다. 예시는 선택 필드라는 한계를 명시하고 root review와 saved reader를 구분한다. 기존 자산 플래그로 차단 우회 금지와 확정 제외 및 기존 envelope 계약은 유지된다.
D04-F04 — satisfied
계약: 프로젝트 구조 문서는 기존 service 책임과 실시간 보고의 구분 공통 business 집계 계층 및 실제 필요한 새 모듈 경로와 검증 책임을 구현 결과에 결속한다.
구현 근거: docs/project-structure.md, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py; F04 해소: docs/project-structure.md 248-250의 실제 private settlement_cashflow_service.py 책임 표는 _normalize_cashflow_policy와 _review_cashflow 및 settlement_draft_service.py caller와 두 test 경로를 연결한다. test_settlement_cashflow_private_service_has_explicit_ownership_and_test_mapping의 단일 책임 행과 필수 symbol assertions를 확인했다.
테스트 근거: tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement_adapters.py
판정 근거: 실제 공통 집계의 소유권과 호출 및 검증 관계를 정본에 보완했다. transport에 SQL 또는 별도 정책을 복제하지 않는다.
D05 — satisfied
계약: 런타임 흐름은 명시적 정책 설정 현재 재집계 종합 지문 승인 트랜잭션 재검증 여섯 식과 원자 저장 저장 조회 및 정책별 제외 음수 차단 재검토 롤백 동시 replay 정정 흐름을 명세한다.
구현 근거: docs/runtime-flow.md; docs/runtime-flow.md 276-280와 기존 lifecycle/no-create/privacy/correction 절을 함께 대조했다. 월 범위 정책 mapping unresolved blocker approval 재검증 same transaction rollback persisted replay latest parent append 및 stored/live 구분을 모두 기록한다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
판정 근거: 원래 source authority와 credential 비노출 및 관찰 metadata와 lifecycle 경계를 유지한다. 실제 Dashboard의 표시 및 헤더 근거 연결은 별도 C11 criterion에서 확인했다.
범위 판정
누락: 없음
범위 초과: 없음
명세 모순: 없음
결론
승인 계약의 19개 criterion이 모두 satisfied여서 approve다. Review 76의 F01-F04 보완은 유지되며 Review 78 F-001의 활성 카테고리 권위와 fallback provenance 및 F-002의 구버전 조건부 마감 헤더 근거 반환과 화면 표시를 현재 source 및 named regression assertions와 구현자 exact-head 실행으로 확인했다. 잔여 및 신규 finding은 해당 없음이다. 문서 보완은 additive metadata의 타입과 privacy 경계를 정확히 설명하며 새 산출물 의무를 만들지 않는다. Reviewer는 제품 테스트를 실행하지 않았다. AppTest를 실제 Chromium 또는 CI 성공으로 표현하지 않는다. 기존 혼합 AC 형식은 자동 검사 비지원 범위라 직접 검토했다. Merge release 승인이 아니다.
## 구현 명세 적합성 검토
- Source Issue: #18
- Pull Request: #19
- Reviewed head: `10201cdb7573546daaa11a4e3df2a8f628a1493e`
- Contract SHA-256: `7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6`
- Verdict: `approve`
### Acceptance criteria 판정
- `C01` — `satisfied`
- 계약: 기존 초안 생성 수정 검토 승인 최종 마감을 확장하고 정책과 집계 버전을 보존하며 여섯 총계와 양 영역 상세 및 경고를 제공한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py; settlement_draft_service.py 133-157,160-171,240-250,349-357; migrations.py 36. test_draft_previews_six_totals_without_creating_run, test_policy_setter_persists_explicit_lists_and_changes_review_fingerprint의 호출과 assertions를 직접 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 별도 초안 현금흐름 테이블 없이 기존 lifecycle과 durable 정책을 확장하며 완료 조회는 저장 응답을 사용한다.
- `C02` — `satisfied`
- 계약: asset_snapshot_runs에 지정된 월 통화 여섯 총계 정책 집계 버전 저장 구조 버전 당시 근거를 추가하고 기존 연결과 승인 정보를 유지한다.
- 구현 근거: jarca_ledger_mcp/infrastructure/sqlite/schema.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py, jarca_ledger_mcp/application/settlement_draft_service.py; schema.py 193-213; migrations.py 145-171; settlement_draft_service.py 413. test_closed_header_persists_six_totals_policy_and_versions와 legacy migration test를 확인했다.
- 테스트 근거: tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement.py
- 판정 근거: 새 종합 run은 모든 지정 필드를 쓰며 자산 전용 기존 API는 그대로다. 구버전은 nullable 열을 추가하고 소급 집계를 하지 않는다.
- `C03` — `satisfied`
- 계약: 자산 상세의 기존 run 연결과 자산 부채 구분 금액 평가일 평가자료 ID exact 이월 대체 포함 제외 및 사유를 고정 근거와 반환 계약에 보존한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/application/assets_service.py; settlement_draft_service.py 75-145 및 monthly_settlement_service.py 221-254와 assets_service.py 424-463을 대조했다. Review 78 F-002의 헤더 제외 이월 적용 승인 근거는 기존 strict public projection으로 반환된다. test_schema_thirteen_saved_reader_retains_real_conditional_header_without_writes는 pinned schema13 public API fixture 생성과 이관 후 기존 보고 동일성, exact와 latest 동일성, legacy NULL, 누락 ID와 사유 및 이월 평가일, approval, DB dump 불변을 검사한다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_draft_contract_scenarios.py
- 판정 근거: 원본 부채 금액과 적용 기여도를 구분하고 기존 abs of raw loan sum 의미를 유지한다. 제외 항목의 적용 금액은 NULL이며 기존 고정 자산 근거를 연결한다.
- `C04` — `satisfied`
- 계약: settlement_cashflow_snapshots의 지정 8개 필드 헤더 외래키 5요소 유일 제약 run 인덱스 및 빈 분류의 명시적 보존을 제공한다.
- 구현 근거: jarca_ledger_mcp/infrastructure/sqlite/schema.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; schema.py 217-228; migrations.py 158-171. test_cashflow_detail_constraints_preserve_blank_categories는 음수 저장, FK, NULL, kind, count, unique5, blank 보존 및 헤더 삭제 거부를 검사한다.
- 테스트 근거: tests/test_settlement_cashflow_schema.py
- 판정 근거: signed INTEGER와 positive count를 검증하고 category와 subcategory는 NOT NULL이다. 외래키 RESTRICT와 run 조회 인덱스가 존재한다.
- `C05` — `satisfied`
- 계약: 활성 거래의 월초 이상 다음 월초 미만을 집계하고 월말 평가를 사용한다. 환급월 음수 지출 명시적 저축 목록 대출상환 지출 이체 초기잔액 상품권 제외 우선 및 미결정 분류 승인 차단을 적용한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py; settlement_cashflow_service.py 46-126은 활성 카테고리 JOIN과 기존 CASHFLOW_KIND_SQL fallback으로 분류하며 제외 우선, 환급 음수, 선택 investment와 debt_payment 지출, unknown 및 FX blocker를 적용한다. Review 78 F-001 해소를 test_inactive_category_uses_raw_fallback_through_public_close의 9개 비활성 분류 사례, 공개 force 삭제 및 승인 마감과 저장 provenance assertions에 대조했다. test_explicit_decision_classifies_only_unresolved_inactive_fallback은 unknown의 명시 판단을 검사한다. 기존 정책 test의 인수와 assertions도 확인했다.
- 테스트 근거: tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement.py
- 판정 근거: 선택한 investment pair만 저축으로 지출 처리하고 일반 이체 및 명시적 충전 제외가 우선한다. 환급은 음수로 남고 unknown은 확정 제외로 위장하지 않는다. 자산 조건부 플래그로 차단을 우회하지 못한다.
- `C06` — `satisfied`
- 계약: 당시 거래 날짜 금액 통화 유형 분류 원래 및 적용 구분 정책 판단과 자산 원본 평가자료 적용 금액 출처 이월 대체 누락 제외를 보존한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; cashflow source 104-109와 draft source 140-145 및 header 413은 거래 당시 입력과 자산 원본 적용 값을 고정한다. 월 조회 228-254는 안전 projection과 헤더 근거를 반환한다. F-001의 fallback 원래 분류와 실제 적용 및 provenance가 일치하며 F-002의 historical 제외와 이월 근거가 반환된다. test_stored_reader_keeps_required_transaction_date와 test_saved_reader_projects_safe_header_exclusion_carry_and_approval_evidence의 날짜 보존과 unknown nested key 차단 및 DB dump 불변 assertions를 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 거래 ID만 남기지 않고 계산 입력을 고정한다. 자산 고정 근거와 source_snapshot이 같은 run에 연결되며 당시 정책은 헤더에 저장된다.
- `C07` — `satisfied`
- 계약: 검토 승인 지문에 거래 집합 당시 값 분류 정책 버전 결과 여섯 총계 평가자료 포함 제외 미확정 상태를 결속하고 관련 drift와 승인 저장 결과 불일치를 거부한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py; draft review serial 148; approval 368-376; finalize 395-445. source_policy_and_category_drift_invalidate_approval, policy_edit_persists_versions_and_invalidates_approval, stored_aggregation_version_drift_invalidates_approval와 persisted tampering tests를 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 거래 집합 전체와 정책 및 집계 결과가 지문에 포함된다. 정책 변경은 version 증가와 승인 무효화이며 최종 저장값도 승인 결과와 대조한다.
- `C08` — `satisfied`
- 계약: 한 DB 트랜잭션에서 헤더 양 상세 근거 초안 완료 연결과 저장 응답을 기록하고 여섯 계산식 및 실제 저장 일치를 검증하며 불일치와 중간 실패는 전부 롤백한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py; BEGIN IMMEDIATE 385; persisted group/header/evidence/asset comparison 421-445; completed response write 462. header/assets/cashflow/completion injection과 header_total/asset_amount/asset_currency/header_source/header_policy/header_version tampering assertions를 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py
- 판정 근거: 수입 지출 합계와 차 및 자산 부채 합계와 차를 같은 run에서 대조한다. 오류는 context-manager transaction 밖으로 전달되어 완료 상태도 남기지 않는다.
- `C09` — `satisfied`
- 계약: 동일 멱등 키와 동일 승인 요청은 동일 run과 저장 응답을 반환하고 다른 요청은 충돌한다. 과거 마감은 불변이고 최신 parent 단일 child 정정은 append하며 각각 exact run으로 조회한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; finalize replay 386-400; initial and correction unique indexes; exact reader 164-201. concurrent_close_retries_return_one_saved_result, replay_and_correction_keep_each_run_immutable, completed_get_and_saved_snapshot_ignore_later_live_ledger_changes의 실제 assertions를 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_draft_correction_contract.py
- 판정 근거: 재시도는 live review 전에 저장 응답을 반환한다. 정정의 최신 parent 및 unique child 경계를 유지하며 최초와 정정 상세는 run으로 분리된다.
- `C10` — `satisfied`
- 계약: additive idempotent 이관은 미보존 구버전 총계를 NULL로 남기고 소급 backfill이나 fake zero를 하지 않는다. 기존 미마감 초안은 종합 검토 재승인 후 마감한다.
- 구현 근거: jarca_ledger_mcp/infrastructure/sqlite/migrations.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; nullable header 이관과 schema13 fixture DDL 및 실제 baseline public API fixture를 독립 pinned base blob에 대조했다. legacy migration 반복 NULL 보존 및 original header without migration, legacy asset approval 재승인 tests를 확인했다. Review 78 F-002의 실제 조건부 마감은 기존 자산 보고를 보존하면서 새 조회에서도 누락 및 이월 근거를 반환한다.
- 테스트 근거: tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement.py
- 판정 근거: 기존 초안과 자산 마감을 유지하며 asset-only 과거 지문은 새 종합 지문과 다르므로 마감할 수 없다. old-column reader는 조회 중 migrate하지 않는다.
- `C11-F01` — `satisfied`
- 계약: MCP 및 인증된 Dashboard에서 종합 초안과 저장 마감 결과를 제공하고 현재 보고와 구분하며 구버전 부분 자료 누락 제외를 표시한다. Dashboard는 목록 입력 경고 및 승인 불가 사유를 전달 표시한다.
- 구현 근거: dashboard/page_views/settlement_drafts.py, dashboard/page_views/monthly_settlement.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/adapters/mcp/server.py, jarca_ledger_mcp/adapters/mcp/tool_contracts.py, jarca_ledger_mcp/adapters/streamlit/settlement_gateway.py; Review 76 F01 해소를 settlement_drafts.py 212-223의 거래 ID 사유 및 승인 disabled, monthly_settlement.py 279-297의 상태 NULL 상세 표시에 확인했다. Review 78 F-002는 287-288에서 기존 evidence renderer로 헤더 excluded_items carried_items approval을 표시하여 해소했다. test_saved_monthly_panel_renders_real_conditional_exclusion_carry_and_approval 261-294는 실제 baseline API fixture와 현재 gateway를 사용하고 저장 response는 mock하지 않는다. 누락 ID 사유 이월 ID 평가일 승인자 사유 참조 표시 assertions를 확인했다. 이 page test는 live 요약 부분을 mock하며 실제 인증 통과 증명은 기존 synthetic-auth app test에 한정한다.
- 테스트 근거: tests/test_comprehensive_settlement_adapters.py
- 판정 근거: 서비스의 차단 원인과 대상 거래가 표시되고 부분 또는 구버전 마감이 완전한 현재 보고로 오인되지 않는다. 기존 인증과 읽기 no-write 근거를 유지한다.
- `C12` — `satisfied`
- 계약: synthetic 검증으로 여섯 식 정책 drift 재시도 동시성 롤백 역사 불변 정정 분리 NULL 이관 기존 API MCP Dashboard 호환을 검증한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; exact-head 구현자 manifest ab19e42dd541060c5dd7c0cdcf48fa0b2b82bb33df2dc3460c767607ea0b04fa와 plan fcb48c89681403bdb029924290621773334ac8e2281d6761ca71aa5e653b0b5b 및 169개 Git blob을 독립 대조했다. 전체 suite 509 passed 4 skipped 1 warning, Ruff exit 0이며 completed와 timeout 종료 기록이 결속된다. 이전 507개와 현재 513개 collection ID 및 status, 각 원래 revision과 stage의 source-binding 및 check-tests 통과를 확인했다. 현재 3개 변경 test file의 기존 함수 AST는 이전 reviewed head와 동일하고 6개 regression이 추가됐다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py, tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement_adapters.py
- 판정 근거: 필수 service와 transport 검증의 구현자 실행을 채택한다. 신규 UI 및 문서 회귀의 호출 인수와 assertions를 직접 대조했고 reviewer 제품 테스트 실행이나 Chromium browser 또는 CI 성공으로 표현하지 않는다.
- `C13` — `satisfied`
- 계약: 정수 정밀도 NULL과 zero KRW 권위 verified 평가 대표 부채 및 투자 중복 합산 금지 읽기 no-create auth-before-DB credential 비노출을 유지한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/application/shared.py, dashboard/app.py; 기존 자산 authority source는 변경되지 않았고 new reader는 read_db를 사용한다. KRW blocker 101-103과 recursive saved projection 228-244 및 authentication before database ordering을 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement_adapters.py, tests/test_settlement_draft_policy_consistency.py
- 판정 근거: 동일 통화 권위와 기존 자산 승인 정책을 유지한다. 실제 credential 없이 synthetic 인수 기록만 읽었으며 unknown output field를 allowlist로 제거한다.
- `C14` — `satisfied`
- 계약: 독립 정산 lifecycle 원장 자동 재작성 소급 집계 새 FX 가격 인증 메뉴 변경과 별도 현금흐름 조건부 승인을 도입하지 않는다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/adapters/mcp/server.py; 30개 authoritative changed file과 62개 API hunk를 immutable base/head blob에 대조했다. 이전 approved head 이후 7개 파일 변경은 두 service, 저장 page, interface 문서와 세 test 파일이다. 기존 자산 직접 API, live report, 인증 및 메뉴 source는 변경되지 않았다. 모든 파일은 계약 criterion 또는 required supporting test로 연결했다.
- 테스트 근거: 없음
- 판정 근거: 모든 변경은 승인된 extension 또는 필수 문서와 지적 보완 검증에 대응한다. 독립 정산 FX 인증 메뉴 변경이나 범위 초과는 없다.
- `D01` — `satisfied`
- 계약: REQ-003의 ID 경로 제목을 유지하고 revision을 올려 기존 계약과 전체 baseline AC 의미를 보존하며 Issue 18과 실제 구현 PR 19를 기존 traceability에 추가한다.
- 구현 근거: docs/requirements/req-003_account-valuation-history.md; REQ-003 revision 1.2와 정확한 ID 경로 제목 및 기존 12와 15 이슈, 13과 16 PR, 새 Issue 18과 PR 19 traceability를 확인했다. pinned base의 38개 requirement와 AC 블록 및 global 계약 전체를 current 48개 블록과 대조했다. 34개 블록은 exact 동일하며 4개 변경은 승인된 schema14 additive 및 title 확장이다. 기존 검증 판정 및 불변 의미 손실은 없다. 기존 inline 분류 10개는 flat 구조 helper 비지원 범위이므로 분류 필드를 직접 대조했고 신규 AC18-27의 검증 경로와 assertions를 확인했다.
- 테스트 근거: tests/test_requirement_docs.py, tests/test_settlement_draft_docs.py
- 판정 근거: 기존 인수 의미 손실은 없고 새 정책과 저장 계약 및 실제 PR 19가 명시됐다. 기존 혼합 분류 형식의 구조 검사 한계는 문서 정규화 참고 사항이며 제품 동작 결함이나 새 mandatory gate로 승격하지 않는다.
- `D02-F02` — `satisfied`
- 계약: 데이터 모델은 확정 헤더 추가 필드별 타입 NULL legacy 의미 필수성과 초안 정책 집계 버전 JSON 재현 입력 신규 상세 전체 필드와 제약을 명세한다.
- 구현 근거: docs/data-model.md, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; F02 해소: docs/data-model.md 198-243의 세 필드 표와 재현 입력을 migrations.py 36,145-170 및 schema.py 193-228과 대조했다. 열 타입 nullability default와 logical identifier 필수성, 신규 종합 마감의 모든 열 제공, legacy NULL, 원래 양수 환급과 적용 음수 및 당시 자산 입력이 명시됐다. test_settlement_cashflow_model_documents_schema_and_legacy_reproduction는 실제 PRAGMA 표와 전체 지정 필드를 비교한다.
- 테스트 근거: tests/test_settlement_cashflow_schema.py
- 판정 근거: 헤더 초안 상세의 필드별 계약과 정책 버전 당시 입력을 통한 재현 경계가 보완됐다. 정본 기존 승인 완료 지문 응답 및 원자성 계약은 유지된다.
- `D03-F03` — `satisfied`
- 계약: 인터페이스 계약은 기존 초안 operation의 정책 버전 여섯 총계 카테고리 상세 누락 경고 입력 출력과 필수성, 저축 목록 편집 환급 음수 및 미분류 차단 오류 재검토를 정의하고 실제 함수 도구 시그니처와 응답 예시를 구현에 대조한다.
- 구현 근거: docs/interface-contract.md, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; docs/interface-contract.md 469-529에서 기존 정책 인수 exact entry schema 및 타입 중복 거부, 여섯 총계와 상세 blocker 필수성, version guard, 음수 환급 및 오류 재검토, response nesting과 synthetic examples를 구현에 대조했다. F03 보완은 유지된다. 신규 saved-reader additive metadata 503-516은 excluded_items carried_items applied_evidence approval의 타입 및 optional evidence key, recursive allowlist가 content redactor가 아닌 점, immutable header origin과 row-only legacy empty defaults를 실제 _closed_run_metadata 및 current reader에 맞게 명시한다.
- 테스트 근거: tests/test_comprehensive_settlement_adapters.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 공개 정책 입력과 출력 필수성 및 승인 차단 재검토를 소비자가 구성할 수 있다. 예시는 선택 필드라는 한계를 명시하고 root review와 saved reader를 구분한다. 기존 자산 플래그로 차단 우회 금지와 확정 제외 및 기존 envelope 계약은 유지된다.
- `D04-F04` — `satisfied`
- 계약: 프로젝트 구조 문서는 기존 service 책임과 실시간 보고의 구분 공통 business 집계 계층 및 실제 필요한 새 모듈 경로와 검증 책임을 구현 결과에 결속한다.
- 구현 근거: docs/project-structure.md, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py; F04 해소: docs/project-structure.md 248-250의 실제 private settlement_cashflow_service.py 책임 표는 _normalize_cashflow_policy와 _review_cashflow 및 settlement_draft_service.py caller와 두 test 경로를 연결한다. test_settlement_cashflow_private_service_has_explicit_ownership_and_test_mapping의 단일 책임 행과 필수 symbol assertions를 확인했다.
- 테스트 근거: tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement_adapters.py
- 판정 근거: 실제 공통 집계의 소유권과 호출 및 검증 관계를 정본에 보완했다. transport에 SQL 또는 별도 정책을 복제하지 않는다.
- `D05` — `satisfied`
- 계약: 런타임 흐름은 명시적 정책 설정 현재 재집계 종합 지문 승인 트랜잭션 재검증 여섯 식과 원자 저장 저장 조회 및 정책별 제외 음수 차단 재검토 롤백 동시 replay 정정 흐름을 명세한다.
- 구현 근거: docs/runtime-flow.md; docs/runtime-flow.md 276-280와 기존 lifecycle/no-create/privacy/correction 절을 함께 대조했다. 월 범위 정책 mapping unresolved blocker approval 재검증 same transaction rollback persisted replay latest parent append 및 stored/live 구분을 모두 기록한다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 원래 source authority와 credential 비노출 및 관찰 metadata와 lifecycle 경계를 유지한다. 실제 Dashboard의 표시 및 헤더 근거 연결은 별도 C11 criterion에서 확인했다.
### 범위 판정
- 누락: 없음
- 범위 초과: 없음
- 명세 모순: 없음
### 결론
승인 계약의 19개 criterion이 모두 satisfied여서 approve다. Review 76의 F01-F04 보완은 유지되며 Review 78 F-001의 활성 카테고리 권위와 fallback provenance 및 F-002의 구버전 조건부 마감 헤더 근거 반환과 화면 표시를 현재 source 및 named regression assertions와 구현자 exact-head 실행으로 확인했다. 잔여 및 신규 finding은 해당 없음이다. 문서 보완은 additive metadata의 타입과 privacy 경계를 정확히 설명하며 새 산출물 의무를 만들지 않는다. Reviewer는 제품 테스트를 실행하지 않았다. AppTest를 실제 Chromium 또는 CI 성공으로 표현하지 않는다. 기존 혼합 AC 형식은 자동 검사 비지원 범위라 직접 검토했다. Merge release 승인이 아니다.
<!-- gitea-agent:implementation-spec-review/v1 owner=jsfamily repository=jarca-ledger-mcp issue=18 pr=19 head=10201cdb7573546daaa11a4e3df2a8f628a1493e contract-sha256=7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6 result-sha256=b345b61e5be6052fd1cdf0016224c277a925f51c3f23ce7b2298b9cebf85dedd correlation=f3fa8341597e6a87509da83e69e069ce4c33fdbbf4b294fcd4da0a1e7f70bb9f -->
사용 스킬: 실제 하네스 harness/agents/review/skills/gitea-code-review/SKILL.md (0.1.4).
이전 review #78의 수정 확인
F-001 해결:settlement_cashflow_service.py:53-54의 JOIN이 lc.active=1로 기존 활성 카테고리 권위 경계를 따릅니다. 공개 soft-delete → 검토 → 승인 → 마감 → 저장 조회를 독립 재현한 결과, synthetic 지출 50원은 live/saved 모두 50원이고 저장 provenance는 fallback, category 값은 null, original kind는 expense입니다. 카테고리를 다시 활성화한 뒤 기존 승인으로 마감하면 conflict: review/approval stale로 거부되고 run은 추가되지 않았습니다. 신규 named 회귀는 여러 비활성 분류·환급·이동·명시적 미분류 판단도 검증합니다.
F-002 정상 데이터 경로 해결:monthly_settlement_service.py:251-254가 strict public projection으로 헤더의 제외/이월/적용/승인 근거를 additive 반환하고, monthly_settlement.py:287-288가 저장 패널에 표시합니다. 실제 baseline schema-13 공개 API로 조건부 마감 fixture를 생성하여 독립 검증했습니다. 누락 source ID/당시 사유·이월 평가일·승인 정보가 보존되고 exact/latest, 이관 전/후 신규 조회가 같습니다. 기존 자산 보고와 legacy NULL 총계 및 조회 no-write를 유지했습니다. 실제 gateway/DB를 쓰는 신규 AppTest도 통과했습니다.
F-003 — 손상된 저장 헤더 근거를 빈 배열로 위장하여 성공 반환
심각도: 중간 / 승인 전 수정 필요.
위치:jarca_ledger_mcp/application/monthly_settlement_service.py:251-254 및 이 경로의 _snapshot_rows_for_run 호출 :165-168,199-201.
발생 조건: run 헤더의 excluded_evidence, carried_evidence, applied_evidence 중 하나에 malformed JSON 또는 객체 등 배열이 아닌 JSON이 저장되어 있습니다. 정상 public API 경로가 이 값을 생성한다고 주장하지 않습니다. 저장 기록 손상/직접 변경 시의 읽기 무결성 경계입니다.
실패 원인: 공유 loader는 assets_service.py:272-281,312-334에서 이를 탐지하여 evidence_integrity_error=True로 표시하고 파싱 실패 값은 내부적으로 []로 치환합니다. 신규 reader는 이 플래그를 검사하지 않은 채 _closed_run_metadata(metadata)와 ok(**header_evidence, ...)를 호출합니다. 결과적으로 실제로 읽을 수 없는 저장 근거가 “항목 없음”이라는 성공 응답이 됩니다. 기존 get_asset_snapshot_report는 같은 run에 대해 assets_service.py:1004-1006에서 data_integrity_error로 fail closed합니다.
직접 근거: 실제 공개 API로 누락 계좌가 있는 synthetic 조건부 자산 마감을 생성한 뒤, 3개 헤더 필드 각각에 invalid JSON({) 및 wrong JSON shape(객체)를 주입했습니다. 6개 case 모두 loader의 integrity flag는 true이고 기존 자산 reader는 실패하지만, 신규 exact/latest reader는 서로 동일한 success=true, close_status=conditional을 반환했습니다. 손상된 해당 collection은 []이며, excluded_evidence case에서는 원래 있던 누락 계좌 ID/사유가 사라졌습니다. 조회 전후 DB dump는 같았습니다. integrity-evidence-manifest.json#/commands/0의 실제 실행/출력과 header_integrity_probe.py에 결속했습니다.
계약 관계/영향과 새 차단 근거: C03/C10/C11/C13의 당시 저장 근거·누락/제외 표시 및 안전한 공통 read model 경계에 해당합니다. 이번 F-002 재작업이 바로 해당 헤더 근거의 신규 public 반환을 추가했으므로 delta/영향 경로 안에 있습니다. 합법적인 legacy 미보존 값과 이미 손상됐다고 탐지한 저장 근거를 같은 빈 배열로 합치는 것은 승인된 재현/해석 계약을 지키지 못합니다. 조건부 마감의 근거를 정상적으로 조회했다는 잘못된 성공 상태를 MCP/Dashboard에 전파하므로 단순 선택적 robustness 개선으로 미룰 수 없습니다. 기존 공유 loader의 탐지 정책을 재사용하라는 요청이며 새로운 마이그레이션·검증 기능을 요구하지 않습니다.
제한된 수정·종료 조건: strict public projection/성공 반환 전에 loader의 evidence_integrity_error를 검사하여 안전한 실패 envelope로 반환합니다. raw 손상 JSON을 응답/로그에 노출하지 않고 조회 no-write를 유지합니다. exact/latest의 3필드 × malformed JSON/wrong-shape named 회귀를 추가하고, 정상 헤더의 빈 배열·정상 조건부 근거·헤더 없는 schema-11 legacy의 empty defaults/NULL 총계가 계속 성공하는 것을 확인합니다. F-001/F-002의 이미 통과한 정상 경로와 기존 자산 reader를 변경해 차이를 숨기지 않습니다.
검토 범위와 실행 근거
이전 #78의 전체 base-to-head 검토와 현재 7파일 재작업 delta를 결합했습니다. 변하지 않은 162개 Git blob에 한정해 이전 검토를 재사용하며, 변경된 classifier/reader/UI/문서/세 test module의 전체 delta와 관련 공유 loader/projection/승인 경로를 직접 검토했습니다. 위임 근거 없음 (mode=none).
Reviewer 직접 실행: 관련 8개 test module 100 passed, exit 0. 분류·음수 환급·unknown/FX·승인 drift·중간 실패 rollback·동시 close/replay·append-only 정정·schema/legacy·실제 MCP stdio·synthetic-auth AppTest를 포함합니다. evidence-manifest.json#/commands/0.
Reviewer 독립 probes: 정상 public API 경계 probe exit 0 (boundary-evidence-manifest.json); 손상 헤더 6case 관측 probe exit 0 (integrity-evidence-manifest.json). 후자의 exit 0은 제품 결함 관측 성공이며 수정의 GREEN이나 TDD를 주장하지 않습니다.
첫 정상 probe는 as_of fixture에 exact 정책의 사유 문자열을 잘못 hard-code하여 실패했습니다. baseline 원래 보고의 실제 사유와 비교하도록 reviewer assertion만 수정했고, 최초 실패 기록을 덮어쓰지 않고 별도 canonical manifest에 재실행을 보존했습니다. 제품 코드/테스트는 수정하지 않았습니다.
구현자 exact-head 재사용: full suite 509 passed, 4 skipped, 1 warning, Ruff exit 0. Manifest SHA-256 ab19e42dd541060c5dd7c0cdcf48fa0b2b82bb33df2dc3460c767607ea0b04fa; 169개 Git blob과 계획 digest 및 정본 validate를 독립 확인했습니다. 이 전체 suite를 reviewer 재실행으로 표현하지 않습니다. 기존 4 skip은 sample/password 부재, 1 warning은 기존 Starlette/httpx deprecation입니다.
Baseline/previous/current collection 435/507/513 ID, 기존 507 ID 보존 및 6개 추가, skip/xfail marker 변화 없음. Git source-binding과 collection 실행/collector hash 검토, check-tests exit 0. git diff --check exit 0. Canonical reviewer manifest 검증과 실제 child reap/group cleanup 확인.
Remote head CI/status 항목은 비어 있습니다. 실제 Chromium·운영 원장 검증은 하지 않았고 AppTest와 동일시하지 않습니다. Strict key projection은 content-based secret redactor가 아니며 이 한계는 현재 문서에 정확히 명시돼 있습니다.
Source/test/ref/state 수정, commit/push/merge, Issue 수정, 기존 review dismiss 또는 자동 implementation handoff는 하지 않았습니다. F-003은 새 public header projection의 실패 경계이고, 반복적인 미변경-code late-blocker가 재차 발생했다고 단정하지 않습니다. 다음 closure 범위는 위 F-003의 제한된 수정/회귀와 새 exact-head spec pass → code 재리뷰입니다.
증빙 위치와 결론
/opt/data/gitea-agent/repositories/jsfamily/jarca-ledger-mcp/worktrees/issue-18/verification/review-r2-20261013_214000_556c6ef9-m4536/에 위험 matrix, main 결과, complete snapshot/delta, 세 canonical manifest와 source/inventory 검증을 보존했습니다. Same-UID local evidence이며 다른 host의 공개 접근을 주장하지 않습니다.
F-001/F-002 정상 경로는 해결됐으나 F-003으로 REQUEST_CHANGES입니다. 이는 merge/release 승인이 아닙니다.
<!-- gitea-agent:code-review/v1 owner=jsfamily repository=jarca-ledger-mcp issue=18 pr=19 head=10201cdb7573546daaa11a4e3df2a8f628a1493e contract-sha256=7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6 -->
## 독립 코드 재리뷰
- Verdict: `request_changes`
- Source Issue: #18 / Pull Request: #19
- Reviewed head: `10201cdb7573546daaa11a4e3df2a8f628a1493e`
- Base: `f67c07adf01d1f17415bf7cf836f46997ca6f21c`
- Contract SHA-256: `7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6`
- Spec pass: review #79, `gitea-spec-agent`, APPROVED / exact head / nonstale / nondismissed.
- 사용 스킬: 실제 하네스 `harness/agents/review/skills/gitea-code-review/SKILL.md` (0.1.4).
### 이전 review #78의 수정 확인
- **F-001 해결:** `settlement_cashflow_service.py:53-54`의 JOIN이 `lc.active=1`로 기존 활성 카테고리 권위 경계를 따릅니다. 공개 soft-delete → 검토 → 승인 → 마감 → 저장 조회를 독립 재현한 결과, synthetic 지출 50원은 live/saved 모두 50원이고 저장 provenance는 `fallback`, category 값은 null, original kind는 `expense`입니다. 카테고리를 다시 활성화한 뒤 기존 승인으로 마감하면 `conflict: review/approval stale`로 거부되고 run은 추가되지 않았습니다. 신규 named 회귀는 여러 비활성 분류·환급·이동·명시적 미분류 판단도 검증합니다.
- **F-002 정상 데이터 경로 해결:** `monthly_settlement_service.py:251-254`가 strict public projection으로 헤더의 제외/이월/적용/승인 근거를 additive 반환하고, `monthly_settlement.py:287-288`가 저장 패널에 표시합니다. 실제 baseline schema-13 공개 API로 조건부 마감 fixture를 생성하여 독립 검증했습니다. 누락 source ID/당시 사유·이월 평가일·승인 정보가 보존되고 exact/latest, 이관 전/후 신규 조회가 같습니다. 기존 자산 보고와 legacy NULL 총계 및 조회 no-write를 유지했습니다. 실제 gateway/DB를 쓰는 신규 AppTest도 통과했습니다.
### F-003 — 손상된 저장 헤더 근거를 빈 배열로 위장하여 성공 반환
- **심각도: 중간 / 승인 전 수정 필요.**
- **위치:** `jarca_ledger_mcp/application/monthly_settlement_service.py:251-254` 및 이 경로의 `_snapshot_rows_for_run` 호출 `:165-168,199-201`.
- **발생 조건:** run 헤더의 `excluded_evidence`, `carried_evidence`, `applied_evidence` 중 하나에 malformed JSON 또는 객체 등 배열이 아닌 JSON이 저장되어 있습니다. 정상 public API 경로가 이 값을 생성한다고 주장하지 않습니다. 저장 기록 손상/직접 변경 시의 읽기 무결성 경계입니다.
- **실패 원인:** 공유 loader는 `assets_service.py:272-281,312-334`에서 이를 탐지하여 `evidence_integrity_error=True`로 표시하고 파싱 실패 값은 내부적으로 `[]`로 치환합니다. 신규 reader는 이 플래그를 검사하지 않은 채 `_closed_run_metadata(metadata)`와 `ok(**header_evidence, ...)`를 호출합니다. 결과적으로 실제로 읽을 수 없는 저장 근거가 “항목 없음”이라는 성공 응답이 됩니다. 기존 `get_asset_snapshot_report`는 같은 run에 대해 `assets_service.py:1004-1006`에서 `data_integrity_error`로 fail closed합니다.
- **직접 근거:** 실제 공개 API로 누락 계좌가 있는 synthetic 조건부 자산 마감을 생성한 뒤, 3개 헤더 필드 각각에 invalid JSON(`{`) 및 wrong JSON shape(객체)를 주입했습니다. **6개 case 모두** loader의 integrity flag는 true이고 기존 자산 reader는 실패하지만, 신규 exact/latest reader는 서로 동일한 `success=true`, `close_status=conditional`을 반환했습니다. 손상된 해당 collection은 `[]`이며, `excluded_evidence` case에서는 원래 있던 누락 계좌 ID/사유가 사라졌습니다. 조회 전후 DB dump는 같았습니다. `integrity-evidence-manifest.json#/commands/0`의 실제 실행/출력과 `header_integrity_probe.py`에 결속했습니다.
- **계약 관계/영향과 새 차단 근거:** C03/C10/C11/C13의 당시 저장 근거·누락/제외 표시 및 안전한 공통 read model 경계에 해당합니다. 이번 F-002 재작업이 바로 해당 헤더 근거의 신규 public 반환을 추가했으므로 delta/영향 경로 안에 있습니다. 합법적인 legacy 미보존 값과 이미 손상됐다고 탐지한 저장 근거를 같은 빈 배열로 합치는 것은 승인된 재현/해석 계약을 지키지 못합니다. 조건부 마감의 근거를 정상적으로 조회했다는 잘못된 성공 상태를 MCP/Dashboard에 전파하므로 단순 선택적 robustness 개선으로 미룰 수 없습니다. 기존 공유 loader의 탐지 정책을 재사용하라는 요청이며 새로운 마이그레이션·검증 기능을 요구하지 않습니다.
- **제한된 수정·종료 조건:** strict public projection/성공 반환 전에 loader의 `evidence_integrity_error`를 검사하여 안전한 실패 envelope로 반환합니다. raw 손상 JSON을 응답/로그에 노출하지 않고 조회 no-write를 유지합니다. exact/latest의 3필드 × malformed JSON/wrong-shape named 회귀를 추가하고, 정상 헤더의 빈 배열·정상 조건부 근거·헤더 없는 schema-11 legacy의 empty defaults/NULL 총계가 계속 성공하는 것을 확인합니다. F-001/F-002의 이미 통과한 정상 경로와 기존 자산 reader를 변경해 차이를 숨기지 않습니다.
### 검토 범위와 실행 근거
- 이전 #78의 전체 base-to-head 검토와 현재 7파일 재작업 delta를 결합했습니다. 변하지 않은 162개 Git blob에 한정해 이전 검토를 재사용하며, 변경된 classifier/reader/UI/문서/세 test module의 전체 delta와 관련 공유 loader/projection/승인 경로를 직접 검토했습니다. 위임 근거 없음 (`mode=none`).
- **Reviewer 직접 실행:** 관련 8개 test module **100 passed**, exit 0. 분류·음수 환급·unknown/FX·승인 drift·중간 실패 rollback·동시 close/replay·append-only 정정·schema/legacy·실제 MCP stdio·synthetic-auth AppTest를 포함합니다. `evidence-manifest.json#/commands/0`.
- **Reviewer 독립 probes:** 정상 public API 경계 probe exit 0 (`boundary-evidence-manifest.json`); 손상 헤더 6case 관측 probe exit 0 (`integrity-evidence-manifest.json`). 후자의 exit 0은 제품 결함 관측 성공이며 수정의 GREEN이나 TDD를 주장하지 않습니다.
- 첫 정상 probe는 `as_of` fixture에 `exact` 정책의 사유 문자열을 잘못 hard-code하여 실패했습니다. baseline 원래 보고의 실제 사유와 비교하도록 reviewer assertion만 수정했고, 최초 실패 기록을 덮어쓰지 않고 별도 canonical manifest에 재실행을 보존했습니다. 제품 코드/테스트는 수정하지 않았습니다.
- **구현자 exact-head 재사용:** full suite **509 passed, 4 skipped, 1 warning**, Ruff exit 0. Manifest SHA-256 `ab19e42dd541060c5dd7c0cdcf48fa0b2b82bb33df2dc3460c767607ea0b04fa`; 169개 Git blob과 계획 digest 및 정본 validate를 독립 확인했습니다. 이 전체 suite를 reviewer 재실행으로 표현하지 않습니다. 기존 4 skip은 sample/password 부재, 1 warning은 기존 Starlette/httpx deprecation입니다.
- Baseline/previous/current collection **435/507/513 ID**, 기존 507 ID 보존 및 6개 추가, skip/xfail marker 변화 없음. Git source-binding과 collection 실행/collector hash 검토, `check-tests` exit 0. `git diff --check` exit 0. Canonical reviewer manifest 검증과 실제 child reap/group cleanup 확인.
- Remote head CI/status 항목은 비어 있습니다. 실제 Chromium·운영 원장 검증은 하지 않았고 AppTest와 동일시하지 않습니다. Strict key projection은 content-based secret redactor가 아니며 이 한계는 현재 문서에 정확히 명시돼 있습니다.
- Source/test/ref/state 수정, commit/push/merge, Issue 수정, 기존 review dismiss 또는 자동 implementation handoff는 하지 않았습니다. F-003은 새 public header projection의 실패 경계이고, 반복적인 미변경-code late-blocker가 재차 발생했다고 단정하지 않습니다. 다음 closure 범위는 위 F-003의 제한된 수정/회귀와 새 exact-head spec pass → code 재리뷰입니다.
### 증빙 위치와 결론
`/opt/data/gitea-agent/repositories/jsfamily/jarca-ledger-mcp/worktrees/issue-18/verification/review-r2-20261013_214000_556c6ef9-m4536/`에 위험 matrix, main 결과, complete snapshot/delta, 세 canonical manifest와 source/inventory 검증을 보존했습니다. Same-UID local evidence이며 다른 host의 공개 접근을 주장하지 않습니다.
F-001/F-002 정상 경로는 해결됐으나 F-003으로 **REQUEST_CHANGES**입니다. 이는 merge/release 승인이 아닙니다.
검증: test_saved_reader_rejects_corrupt_header_evidence_without_writes: 12 named cases RED assertion exit 1 to exact-commit GREEN exit 0; service, Streamlit gateway and actual MCP tool forwarding preserve the existing safe assets-reader error envelope; normal empty and headerless legacy reads retain no-write/NULL defaults. Full-suite and integrated adversarial execution evidence in attachment.
근거: Checks the existing shared loader evidence_integrity_error before successful public projection, without exposing corrupt raw JSON or changing schema, migration, UI, classifier or existing tests.
Runtime/browser: Actual synthetic SQLite and MCP stdio/tool paths plus framework AppTest in full suite; not real Chromium browser evidence. Headerless legacy correction metadata differs pre-existingly by exact/latest lookup and was not changed outside F003. PR body not rewritten; earlier failed publication and first ordering-only preflight remain preserved, not promoted. Separate user-approved resume normalized only unique commit.files order; same PR branch non-force push and fresh head readback verified.
Commit status: 없음
Actions runs: 없음
다음 단계
Reviewer가 rework head를 새 snapshot으로 다시 검토해야 하며 이 comment는 기존 REQUEST_CHANGES를 해제하거나 승인을 의미하지 않는다.
## 구현 재작업 결과
- Source Issue: 18
- Pull Request: 19
- Source Review: 80
- Reviewed head: `10201cdb7573546daaa11a4e3df2a8f628a1493e`
- Rework head: `53ce20956d9085c5d9a8e61770886863a38ac08c`
- Contract SHA-256: `7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6`
- Result: `rework_delivered`
### 지적 처리
- F-003 — `resolved`
- 분류: valid_fix
- 변경: jarca_ledger_mcp/application/monthly_settlement_service.py; tests/test_comprehensive_settlement.py
- 검증: test_saved_reader_rejects_corrupt_header_evidence_without_writes: 12 named cases RED assertion exit 1 to exact-commit GREEN exit 0; service, Streamlit gateway and actual MCP tool forwarding preserve the existing safe assets-reader error envelope; normal empty and headerless legacy reads retain no-write/NULL defaults. Full-suite and integrated adversarial execution evidence in attachment.
- 근거: Checks the existing shared loader evidence_integrity_error before successful public projection, without exposing corrupt raw JSON or changing schema, migration, UI, classifier or existing tests.
### 최종 검증
- Local checks: Full suite: 525 passed, 4 skipped, 1 warning; exit 0. Exact argv: /opt/data/gitea-agent/repositories/jsfamily/jarca-ledger-mcp/worktrees/issue-18/runtime/i18impl-20261013T001703Z/venv/bin/python -B -m pytest -o addopts= -p no:cacheprovider --color=no --basetemp /tmp/rework80-final-53ce20956d90 -rA tests. Lint exit 0: /opt/data/gitea-agent/repositories/jsfamily/jarca-ledger-mcp/worktrees/issue-18/runtime/i18impl-20261013T001703Z/venv/bin/python -B -m ruff check --no-cache .; Canonical manifest validation exit 0. 513 baseline IDs retained, 16 added, 113 contract meanings preserved; final independent static specification/code-security review no blockers. Evidence ZIP PR attachment UUID fde5986b-9282-4129-9a82-2a4701ac624d; SHA-256 beaf4af88634463b436b54ff126769f22a87a9d608964b351ff5e3771ed4316e; final/evidence-manifest.json and final/evidence-plan.json bind actual source/argv/environment/output/exit/termination, baseline-development/f003-contract-red.json binds RED. Manifest SHA-256 b117579aa15e25382b89ada59fa3281e5547a109c29e93f013a022986c63fbed.
- Runtime/browser: Actual synthetic SQLite and MCP stdio/tool paths plus framework AppTest in full suite; not real Chromium browser evidence. Headerless legacy correction metadata differs pre-existingly by exact/latest lookup and was not changed outside F003. PR body not rewritten; earlier failed publication and first ordering-only preflight remain preserved, not promoted. Separate user-approved resume normalized only unique commit.files order; same PR branch non-force push and fresh head readback verified.
- Commit status: 없음
- Actions runs: 없음
### 다음 단계
Reviewer가 rework head를 새 snapshot으로 다시 검토해야 하며 이 comment는 기존 `REQUEST_CHANGES`를 해제하거나 승인을 의미하지 않는다.
<!-- gitea-agent:implementation-rework/v1 owner=jsfamily repository=jarca-ledger-mcp issue=18 pr=19 review=80 reviewed-head=10201cdb7573546daaa11a4e3df2a8f628a1493e head=53ce20956d9085c5d9a8e61770886863a38ac08c contract-sha256=7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6 result-sha256=08d9ed4224d0cd7c44506c1c865d05c31d3e1e2107ffa4f3425b889c0de5bf6b correlation=80ead9696a8a220ddd3eb0fe1b9afd75496e9a1abdbc8e8e3d259eaa3ab88e34 -->
계약: 기존 초안 생성 수정 검토 승인 최종 마감을 확장하고 정책과 집계 버전을 보존하며 여섯 총계와 양 영역 상세 및 경고를 제공한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. settlement_draft_service.py 133-157,160-171,240-250,349-357; migrations.py 36. test_draft_previews_six_totals_without_creating_run, test_policy_setter_persists_explicit_lists_and_changes_review_fingerprint의 호출과 assertions를 직접 확인했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
판정 근거: 별도 초안 현금흐름 테이블 없이 기존 lifecycle과 durable 정책을 확장하며 완료 조회는 저장 응답을 사용한다.
C02 — satisfied
계약: asset_snapshot_runs에 지정된 월 통화 여섯 총계 정책 집계 버전 저장 구조 버전 당시 근거를 추가하고 기존 연결과 승인 정보를 유지한다.
구현 근거: jarca_ledger_mcp/infrastructure/sqlite/schema.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py, jarca_ledger_mcp/application/settlement_draft_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. schema.py 193-213; migrations.py 145-171; settlement_draft_service.py 413. test_closed_header_persists_six_totals_policy_and_versions와 legacy migration test를 확인했다.
테스트 근거: tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement.py
판정 근거: 새 종합 run은 모든 지정 필드를 쓰며 자산 전용 기존 API는 그대로다. 구버전은 nullable 열을 추가하고 소급 집계를 하지 않는다.
C03 — satisfied
계약: 자산 상세의 기존 run 연결과 자산 부채 구분 금액 평가일 평가자료 ID exact 이월 대체 포함 제외 및 사유를 고정 근거와 반환 계약에 보존한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/application/assets_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. settlement_draft_service.py 75-145 및 monthly_settlement_service.py 221-254와 assets_service.py 424-463을 대조했다. Review 78 F-002의 헤더 제외 이월 적용 승인 근거는 기존 strict public projection으로 반환된다. test_schema_thirteen_saved_reader_retains_real_conditional_header_without_writes는 pinned schema13 public API fixture 생성과 이관 후 기존 보고 동일성, exact와 latest 동일성, legacy NULL, 누락 ID와 사유 및 이월 평가일, approval, DB dump 불변을 검사한다. 이번 F-003 보완은 monthly_settlement_service.py 208-209의 기존 loader 무결성 플래그 검사다. 성공 projection 전에 기존 자산 reader와 같은 data_integrity_error 및 run 식별자를 반환한다. 정상 빈 근거와 headerless legacy NULL 의미 및 no-write 경계는 유지된다. 신규 test의 실제 인수와 assertions를 직접 확인했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_draft_contract_scenarios.py
판정 근거: 원본 부채 금액과 적용 기여도를 구분하고 기존 abs of raw loan sum 의미를 유지한다. 제외 항목의 적용 금액은 NULL이며 기존 고정 자산 근거를 연결한다.
C04 — satisfied
계약: settlement_cashflow_snapshots의 지정 8개 필드 헤더 외래키 5요소 유일 제약 run 인덱스 및 빈 분류의 명시적 보존을 제공한다.
구현 근거: jarca_ledger_mcp/infrastructure/sqlite/schema.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. schema.py 217-228; migrations.py 158-171. test_cashflow_detail_constraints_preserve_blank_categories는 음수 저장, FK, NULL, kind, count, unique5, blank 보존 및 헤더 삭제 거부를 검사한다.
테스트 근거: tests/test_settlement_cashflow_schema.py
판정 근거: signed INTEGER와 positive count를 검증하고 category와 subcategory는 NOT NULL이다. 외래키 RESTRICT와 run 조회 인덱스가 존재한다.
C05 — satisfied
계약: 활성 거래의 월초 이상 다음 월초 미만을 집계하고 월말 평가를 사용한다. 환급월 음수 지출 명시적 저축 목록 대출상환 지출 이체 초기잔액 상품권 제외 우선 및 미결정 분류 승인 차단을 적용한다.
구현 근거: jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. settlement_cashflow_service.py 46-126은 활성 카테고리 JOIN과 기존 CASHFLOW_KIND_SQL fallback으로 분류하며 제외 우선, 환급 음수, 선택 investment와 debt_payment 지출, unknown 및 FX blocker를 적용한다. Review 78 F-001 해소를 test_inactive_category_uses_raw_fallback_through_public_close의 9개 비활성 분류 사례, 공개 force 삭제 및 승인 마감과 저장 provenance assertions에 대조했다. test_explicit_decision_classifies_only_unresolved_inactive_fallback은 unknown의 명시 판단을 검사한다. 기존 정책 test의 인수와 assertions도 확인했다.
테스트 근거: tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement.py
판정 근거: 선택한 investment pair만 저축으로 지출 처리하고 일반 이체 및 명시적 충전 제외가 우선한다. 환급은 음수로 남고 unknown은 확정 제외로 위장하지 않는다. 자산 조건부 플래그로 차단을 우회하지 못한다.
C06 — satisfied
계약: 당시 거래 날짜 금액 통화 유형 분류 원래 및 적용 구분 정책 판단과 자산 원본 평가자료 적용 금액 출처 이월 대체 누락 제외를 보존한다.
구현 근거: jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. cashflow source 104-109와 draft source 140-145 및 header 413은 거래 당시 입력과 자산 원본 적용 값을 고정한다. 월 조회 228-254는 안전 projection과 헤더 근거를 반환한다. F-001의 fallback 원래 분류와 실제 적용 및 provenance가 일치하며 F-002의 historical 제외와 이월 근거가 반환된다. test_stored_reader_keeps_required_transaction_date와 test_saved_reader_projects_safe_header_exclusion_carry_and_approval_evidence의 날짜 보존과 unknown nested key 차단 및 DB dump 불변 assertions를 확인했다. 이번 F-003 보완은 monthly_settlement_service.py 208-209의 기존 loader 무결성 플래그 검사다. 성공 projection 전에 기존 자산 reader와 같은 data_integrity_error 및 run 식별자를 반환한다. 정상 빈 근거와 headerless legacy NULL 의미 및 no-write 경계는 유지된다. 신규 test의 실제 인수와 assertions를 직접 확인했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
판정 근거: 거래 ID만 남기지 않고 계산 입력을 고정한다. 자산 고정 근거와 source_snapshot이 같은 run에 연결되며 당시 정책은 헤더에 저장된다.
C07 — satisfied
계약: 검토 승인 지문에 거래 집합 당시 값 분류 정책 버전 결과 여섯 총계 평가자료 포함 제외 미확정 상태를 결속하고 관련 drift와 승인 저장 결과 불일치를 거부한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. draft review serial 148; approval 368-376; finalize 395-445. source_policy_and_category_drift_invalidate_approval, policy_edit_persists_versions_and_invalidates_approval, stored_aggregation_version_drift_invalidates_approval와 persisted tampering tests를 확인했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
판정 근거: 거래 집합 전체와 정책 및 집계 결과가 지문에 포함된다. 정책 변경은 version 증가와 승인 무효화이며 최종 저장값도 승인 결과와 대조한다.
C08 — satisfied
계약: 한 DB 트랜잭션에서 헤더 양 상세 근거 초안 완료 연결과 저장 응답을 기록하고 여섯 계산식 및 실제 저장 일치를 검증하며 불일치와 중간 실패는 전부 롤백한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. BEGIN IMMEDIATE 385; persisted group/header/evidence/asset comparison 421-445; completed response write 462. header/assets/cashflow/completion injection과 header_total/asset_amount/asset_currency/header_source/header_policy/header_version tampering assertions를 확인했다.
테스트 근거: tests/test_comprehensive_settlement.py
판정 근거: 수입 지출 합계와 차 및 자산 부채 합계와 차를 같은 run에서 대조한다. 오류는 context-manager transaction 밖으로 전달되어 완료 상태도 남기지 않는다.
C09 — satisfied
계약: 동일 멱등 키와 동일 승인 요청은 동일 run과 저장 응답을 반환하고 다른 요청은 충돌한다. 과거 마감은 불변이고 최신 parent 단일 child 정정은 append하며 각각 exact run으로 조회한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. finalize replay 386-400; initial and correction unique indexes; exact reader 164-201. concurrent_close_retries_return_one_saved_result, replay_and_correction_keep_each_run_immutable, completed_get_and_saved_snapshot_ignore_later_live_ledger_changes의 실제 assertions를 확인했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_draft_correction_contract.py
판정 근거: 재시도는 live review 전에 저장 응답을 반환한다. 정정의 최신 parent 및 unique child 경계를 유지하며 최초와 정정 상세는 run으로 분리된다.
C10 — satisfied
계약: additive idempotent 이관은 미보존 구버전 총계를 NULL로 남기고 소급 backfill이나 fake zero를 하지 않는다. 기존 미마감 초안은 종합 검토 재승인 후 마감한다.
구현 근거: jarca_ledger_mcp/infrastructure/sqlite/migrations.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. nullable header 이관과 schema13 fixture DDL 및 실제 baseline public API fixture를 독립 pinned base blob에 대조했다. legacy migration 반복 NULL 보존 및 original header without migration, legacy asset approval 재승인 tests를 확인했다. Review 78 F-002의 실제 조건부 마감은 기존 자산 보고를 보존하면서 새 조회에서도 누락 및 이월 근거를 반환한다. 이번 F-003 보완은 monthly_settlement_service.py 208-209의 기존 loader 무결성 플래그 검사다. 성공 projection 전에 기존 자산 reader와 같은 data_integrity_error 및 run 식별자를 반환한다. 정상 빈 근거와 headerless legacy NULL 의미 및 no-write 경계는 유지된다. 신규 test의 실제 인수와 assertions를 직접 확인했다.
테스트 근거: tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement.py
판정 근거: 기존 초안과 자산 마감을 유지하며 asset-only 과거 지문은 새 종합 지문과 다르므로 마감할 수 없다. old-column reader는 조회 중 migrate하지 않는다.
C11-F01 — satisfied
계약: MCP 및 인증된 Dashboard에서 종합 초안과 저장 마감 결과를 제공하고 현재 보고와 구분하며 구버전 부분 자료 누락 제외를 표시한다. Dashboard는 목록 입력 경고 및 승인 불가 사유를 전달 표시한다.
구현 근거: dashboard/page_views/settlement_drafts.py, dashboard/page_views/monthly_settlement.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/adapters/mcp/server.py, jarca_ledger_mcp/adapters/mcp/tool_contracts.py, jarca_ledger_mcp/adapters/streamlit/settlement_gateway.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. Review 76 F01 해소를 settlement_drafts.py 212-223의 거래 ID 사유 및 승인 disabled, monthly_settlement.py 279-297의 상태 NULL 상세 표시에 확인했다. Review 78 F-002는 287-288에서 기존 evidence renderer로 헤더 excluded_items carried_items approval을 표시하여 해소했다. test_saved_monthly_panel_renders_real_conditional_exclusion_carry_and_approval 261-294는 실제 baseline API fixture와 현재 gateway를 사용하고 저장 response는 mock하지 않는다. 누락 ID 사유 이월 ID 평가일 승인자 사유 참조 표시 assertions를 확인했다. 이 page test는 live 요약 부분을 mock하며 실제 인증 통과 증명은 기존 synthetic-auth app test에 한정한다. 이번 F-003 보완은 monthly_settlement_service.py 208-209의 기존 loader 무결성 플래그 검사다. 성공 projection 전에 기존 자산 reader와 같은 data_integrity_error 및 run 식별자를 반환한다. 정상 빈 근거와 headerless legacy NULL 의미 및 no-write 경계는 유지된다. 신규 test의 실제 인수와 assertions를 직접 확인했다.
테스트 근거: tests/test_comprehensive_settlement_adapters.py
판정 근거: 서비스의 차단 원인과 대상 거래가 표시되고 부분 또는 구버전 마감이 완전한 현재 보고로 오인되지 않는다. 기존 인증과 읽기 no-write 근거를 유지한다.
C12 — satisfied
계약: synthetic 검증으로 여섯 식 정책 drift 재시도 동시성 롤백 역사 불변 정정 분리 NULL 이관 기존 API MCP Dashboard 호환을 검증한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; 현재 head manifest b117579aa15e25382b89ada59fa3281e5547a109c29e93f013a022986c63fbed, plan f52b8156b193a6f0c35f385e372e857bdf0f7acd50199219d7960f44537be2d5와 169개 exact Git blob 및 실제 argv exit output timeout termination을 대조했다. 구현자 전체 suite 525 passed 4 skipped 1 warning 및 Ruff exit 0이다. 현재 수집 실행의 529개 ID를 source-binding하고 baseline 513개 및 기존 skip 상태 보존과 16개 추가를 check-tests로 확인했다. 신규 손상 회귀는 3필드와 2손상 형태 및 exact latest 12조합에서 service gateway 실제 MCP tool 전달을 대조하고 raw marker 비노출 및 전체 DB dump 불변을 검사한다. 정상 빈 배열 3조합과 headerless schema11 1개 회귀의 인수와 assertions도 직접 확인했다. Reviewer는 제품 테스트를 실행하지 않았다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py, tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement_adapters.py
판정 근거: 필수 service와 transport 검증의 구현자 실행을 채택한다. 신규 UI 및 문서 회귀의 호출 인수와 assertions를 직접 대조했고 reviewer 제품 테스트 실행이나 Chromium browser 또는 CI 성공으로 표현하지 않는다.
C13 — satisfied
계약: 정수 정밀도 NULL과 zero KRW 권위 verified 평가 대표 부채 및 투자 중복 합산 금지 읽기 no-create auth-before-DB credential 비노출을 유지한다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/application/shared.py, dashboard/app.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. 기존 자산 authority source는 변경되지 않았고 new reader는 read_db를 사용한다. KRW blocker 101-103과 recursive saved projection 228-244 및 authentication before database ordering을 확인했다. 이번 F-003 보완은 monthly_settlement_service.py 208-209의 기존 loader 무결성 플래그 검사다. 성공 projection 전에 기존 자산 reader와 같은 data_integrity_error 및 run 식별자를 반환한다. 정상 빈 근거와 headerless legacy NULL 의미 및 no-write 경계는 유지된다. 신규 test의 실제 인수와 assertions를 직접 확인했다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement_adapters.py, tests/test_settlement_draft_policy_consistency.py
판정 근거: 동일 통화 권위와 기존 자산 승인 정책을 유지한다. 실제 credential 없이 synthetic 인수 기록만 읽었으며 unknown output field를 allowlist로 제거한다.
C14 — satisfied
계약: 독립 정산 lifecycle 원장 자동 재작성 소급 집계 새 FX 가격 인증 메뉴 변경과 별도 현금흐름 조건부 승인을 도입하지 않는다.
구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/adapters/mcp/server.py; 전체 30개 changed file과 62개 API hunk를 immutable base/head에 대조했다. 이전 승인 head 이후 변경은 monthly_settlement_service.py의 무결성 flag 검사 두 줄과 tests/test_comprehensive_settlement.py의 3개 test 함수뿐이다. 167개 blob 및 기존 test 함수 AST는 동일하다. 새 변경은 기존 저장 근거와 안전한 read model 계약에 대응하며 schema UI classifier 문서 및 기존 자산 reader를 바꾸지 않는다.
테스트 근거: 없음
판정 근거: 모든 변경은 승인된 extension 또는 필수 문서와 지적 보완 검증에 대응한다. 독립 정산 FX 인증 메뉴 변경이나 범위 초과는 없다.
D01 — satisfied
계약: REQ-003의 ID 경로 제목을 유지하고 revision을 올려 기존 계약과 전체 baseline AC 의미를 보존하며 Issue 18과 실제 구현 PR 19를 기존 traceability에 추가한다.
구현 근거: docs/requirements/req-003_account-valuation-history.md; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. REQ-003 revision 1.2와 정확한 ID 경로 제목 및 기존 12와 15 이슈, 13과 16 PR, 새 Issue 18과 PR 19 traceability를 확인했다. pinned base의 38개 requirement와 AC 블록 및 global 계약 전체를 current 48개 블록과 대조했다. 34개 블록은 exact 동일하며 4개 변경은 승인된 schema14 additive 및 title 확장이다. 기존 검증 판정 및 불변 의미 손실은 없다. 기존 inline 분류 10개는 flat 구조 helper 비지원 범위이므로 분류 필드를 직접 대조했고 신규 AC18-27의 검증 경로와 assertions를 확인했다.
테스트 근거: tests/test_requirement_docs.py, tests/test_settlement_draft_docs.py
판정 근거: 기존 인수 의미 손실은 없고 새 정책과 저장 계약 및 실제 PR 19가 명시됐다. 기존 혼합 분류 형식의 구조 검사 한계는 문서 정규화 참고 사항이며 제품 동작 결함이나 새 mandatory gate로 승격하지 않는다.
D02-F02 — satisfied
계약: 데이터 모델은 확정 헤더 추가 필드별 타입 NULL legacy 의미 필수성과 초안 정책 집계 버전 JSON 재현 입력 신규 상세 전체 필드와 제약을 명세한다.
구현 근거: docs/data-model.md, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. F02 해소: docs/data-model.md 198-243의 세 필드 표와 재현 입력을 migrations.py 36,145-170 및 schema.py 193-228과 대조했다. 열 타입 nullability default와 logical identifier 필수성, 신규 종합 마감의 모든 열 제공, legacy NULL, 원래 양수 환급과 적용 음수 및 당시 자산 입력이 명시됐다. test_settlement_cashflow_model_documents_schema_and_legacy_reproduction는 실제 PRAGMA 표와 전체 지정 필드를 비교한다.
테스트 근거: tests/test_settlement_cashflow_schema.py
판정 근거: 헤더 초안 상세의 필드별 계약과 정책 버전 당시 입력을 통한 재현 경계가 보완됐다. 정본 기존 승인 완료 지문 응답 및 원자성 계약은 유지된다.
D03-F03 — satisfied
계약: 인터페이스 계약은 기존 초안 operation의 정책 버전 여섯 총계 카테고리 상세 누락 경고 입력 출력과 필수성, 저축 목록 편집 환급 음수 및 미분류 차단 오류 재검토를 정의하고 실제 함수 도구 시그니처와 응답 예시를 구현에 대조한다.
구현 근거: docs/interface-contract.md, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. docs/interface-contract.md 469-529에서 기존 정책 인수 exact entry schema 및 타입 중복 거부, 여섯 총계와 상세 blocker 필수성, version guard, 음수 환급 및 오류 재검토, response nesting과 synthetic examples를 구현에 대조했다. F03 보완은 유지된다. 신규 saved-reader additive metadata 503-516은 excluded_items carried_items applied_evidence approval의 타입 및 optional evidence key, recursive allowlist가 content redactor가 아닌 점, immutable header origin과 row-only legacy empty defaults를 실제 _closed_run_metadata 및 current reader에 맞게 명시한다. 이번 F-003 보완은 monthly_settlement_service.py 208-209의 기존 loader 무결성 플래그 검사다. 성공 projection 전에 기존 자산 reader와 같은 data_integrity_error 및 run 식별자를 반환한다. 정상 빈 근거와 headerless legacy NULL 의미 및 no-write 경계는 유지된다. 신규 test의 실제 인수와 assertions를 직접 확인했다.
테스트 근거: tests/test_comprehensive_settlement_adapters.py, tests/test_settlement_cashflow_policy.py
판정 근거: 공개 정책 입력과 출력 필수성 및 승인 차단 재검토를 소비자가 구성할 수 있다. 예시는 선택 필드라는 한계를 명시하고 root review와 saved reader를 구분한다. 기존 자산 플래그로 차단 우회 금지와 확정 제외 및 기존 envelope 계약은 유지된다.
D04-F04 — satisfied
계약: 프로젝트 구조 문서는 기존 service 책임과 실시간 보고의 구분 공통 business 집계 계층 및 실제 필요한 새 모듈 경로와 검증 책임을 구현 결과에 결속한다.
구현 근거: docs/project-structure.md, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. F04 해소: docs/project-structure.md 248-250의 실제 private settlement_cashflow_service.py 책임 표는 _normalize_cashflow_policy와 _review_cashflow 및 settlement_draft_service.py caller와 두 test 경로를 연결한다. test_settlement_cashflow_private_service_has_explicit_ownership_and_test_mapping의 단일 책임 행과 필수 symbol assertions를 확인했다.
테스트 근거: tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement_adapters.py
판정 근거: 실제 공통 집계의 소유권과 호출 및 검증 관계를 정본에 보완했다. transport에 SQL 또는 별도 정책을 복제하지 않는다.
D05 — satisfied
계약: 런타임 흐름은 명시적 정책 설정 현재 재집계 종합 지문 승인 트랜잭션 재검증 여섯 식과 원자 저장 저장 조회 및 정책별 제외 음수 차단 재검토 롤백 동시 replay 정정 흐름을 명세한다.
구현 근거: docs/runtime-flow.md; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. docs/runtime-flow.md 276-280와 기존 lifecycle/no-create/privacy/correction 절을 함께 대조했다. 월 범위 정책 mapping unresolved blocker approval 재검증 same transaction rollback persisted replay latest parent append 및 stored/live 구분을 모두 기록한다.
테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
판정 근거: 원래 source authority와 credential 비노출 및 관찰 metadata와 lifecycle 경계를 유지한다. 실제 Dashboard의 표시 및 헤더 근거 연결은 별도 C11 criterion에서 확인했다.
범위 판정
누락: 없음
범위 초과: 없음
명세 모순: 없음
결론
승인 계약의 19개 criterion이 모두 satisfied여서 approve다. 이전 Review 76과 78의 보완은 불변 source와 이전 판정을 결합해 유지됨을 확인했다. Review 80 F-003은 기존 loader의 손상 표시를 성공 반환 전에 검사하여 해소됐으며 named 회귀의 exact latest 오류 응답 전달 raw 비노출 no-write와 정상 빈 근거 및 headerless legacy 호환 assertions를 직접 확인했다. 잔여 및 신규 finding과 문서 보완은 해당 없음이다. 구현자 exact-head 전체 suite는 525 passed 4 skipped 1 warning이고 Ruff는 성공이다. Reviewer 제품 실행 및 Chromium 또는 CI 성공을 주장하지 않는다. 기존 혼합 AC 형식은 자동 구조 검사 비지원 한계를 유지한다. Merge release 승인이 아니다.
## 구현 명세 적합성 검토
- Source Issue: #18
- Pull Request: #19
- Reviewed head: `53ce20956d9085c5d9a8e61770886863a38ac08c`
- Contract SHA-256: `7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6`
- Verdict: `approve`
### Acceptance criteria 판정
- `C01` — `satisfied`
- 계약: 기존 초안 생성 수정 검토 승인 최종 마감을 확장하고 정책과 집계 버전을 보존하며 여섯 총계와 양 영역 상세 및 경고를 제공한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. settlement_draft_service.py 133-157,160-171,240-250,349-357; migrations.py 36. test_draft_previews_six_totals_without_creating_run, test_policy_setter_persists_explicit_lists_and_changes_review_fingerprint의 호출과 assertions를 직접 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 별도 초안 현금흐름 테이블 없이 기존 lifecycle과 durable 정책을 확장하며 완료 조회는 저장 응답을 사용한다.
- `C02` — `satisfied`
- 계약: asset_snapshot_runs에 지정된 월 통화 여섯 총계 정책 집계 버전 저장 구조 버전 당시 근거를 추가하고 기존 연결과 승인 정보를 유지한다.
- 구현 근거: jarca_ledger_mcp/infrastructure/sqlite/schema.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py, jarca_ledger_mcp/application/settlement_draft_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. schema.py 193-213; migrations.py 145-171; settlement_draft_service.py 413. test_closed_header_persists_six_totals_policy_and_versions와 legacy migration test를 확인했다.
- 테스트 근거: tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement.py
- 판정 근거: 새 종합 run은 모든 지정 필드를 쓰며 자산 전용 기존 API는 그대로다. 구버전은 nullable 열을 추가하고 소급 집계를 하지 않는다.
- `C03` — `satisfied`
- 계약: 자산 상세의 기존 run 연결과 자산 부채 구분 금액 평가일 평가자료 ID exact 이월 대체 포함 제외 및 사유를 고정 근거와 반환 계약에 보존한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/application/assets_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. settlement_draft_service.py 75-145 및 monthly_settlement_service.py 221-254와 assets_service.py 424-463을 대조했다. Review 78 F-002의 헤더 제외 이월 적용 승인 근거는 기존 strict public projection으로 반환된다. test_schema_thirteen_saved_reader_retains_real_conditional_header_without_writes는 pinned schema13 public API fixture 생성과 이관 후 기존 보고 동일성, exact와 latest 동일성, legacy NULL, 누락 ID와 사유 및 이월 평가일, approval, DB dump 불변을 검사한다. 이번 F-003 보완은 monthly_settlement_service.py 208-209의 기존 loader 무결성 플래그 검사다. 성공 projection 전에 기존 자산 reader와 같은 data_integrity_error 및 run 식별자를 반환한다. 정상 빈 근거와 headerless legacy NULL 의미 및 no-write 경계는 유지된다. 신규 test의 실제 인수와 assertions를 직접 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_draft_contract_scenarios.py
- 판정 근거: 원본 부채 금액과 적용 기여도를 구분하고 기존 abs of raw loan sum 의미를 유지한다. 제외 항목의 적용 금액은 NULL이며 기존 고정 자산 근거를 연결한다.
- `C04` — `satisfied`
- 계약: settlement_cashflow_snapshots의 지정 8개 필드 헤더 외래키 5요소 유일 제약 run 인덱스 및 빈 분류의 명시적 보존을 제공한다.
- 구현 근거: jarca_ledger_mcp/infrastructure/sqlite/schema.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. schema.py 217-228; migrations.py 158-171. test_cashflow_detail_constraints_preserve_blank_categories는 음수 저장, FK, NULL, kind, count, unique5, blank 보존 및 헤더 삭제 거부를 검사한다.
- 테스트 근거: tests/test_settlement_cashflow_schema.py
- 판정 근거: signed INTEGER와 positive count를 검증하고 category와 subcategory는 NOT NULL이다. 외래키 RESTRICT와 run 조회 인덱스가 존재한다.
- `C05` — `satisfied`
- 계약: 활성 거래의 월초 이상 다음 월초 미만을 집계하고 월말 평가를 사용한다. 환급월 음수 지출 명시적 저축 목록 대출상환 지출 이체 초기잔액 상품권 제외 우선 및 미결정 분류 승인 차단을 적용한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. settlement_cashflow_service.py 46-126은 활성 카테고리 JOIN과 기존 CASHFLOW_KIND_SQL fallback으로 분류하며 제외 우선, 환급 음수, 선택 investment와 debt_payment 지출, unknown 및 FX blocker를 적용한다. Review 78 F-001 해소를 test_inactive_category_uses_raw_fallback_through_public_close의 9개 비활성 분류 사례, 공개 force 삭제 및 승인 마감과 저장 provenance assertions에 대조했다. test_explicit_decision_classifies_only_unresolved_inactive_fallback은 unknown의 명시 판단을 검사한다. 기존 정책 test의 인수와 assertions도 확인했다.
- 테스트 근거: tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement.py
- 판정 근거: 선택한 investment pair만 저축으로 지출 처리하고 일반 이체 및 명시적 충전 제외가 우선한다. 환급은 음수로 남고 unknown은 확정 제외로 위장하지 않는다. 자산 조건부 플래그로 차단을 우회하지 못한다.
- `C06` — `satisfied`
- 계약: 당시 거래 날짜 금액 통화 유형 분류 원래 및 적용 구분 정책 판단과 자산 원본 평가자료 적용 금액 출처 이월 대체 누락 제외를 보존한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. cashflow source 104-109와 draft source 140-145 및 header 413은 거래 당시 입력과 자산 원본 적용 값을 고정한다. 월 조회 228-254는 안전 projection과 헤더 근거를 반환한다. F-001의 fallback 원래 분류와 실제 적용 및 provenance가 일치하며 F-002의 historical 제외와 이월 근거가 반환된다. test_stored_reader_keeps_required_transaction_date와 test_saved_reader_projects_safe_header_exclusion_carry_and_approval_evidence의 날짜 보존과 unknown nested key 차단 및 DB dump 불변 assertions를 확인했다. 이번 F-003 보완은 monthly_settlement_service.py 208-209의 기존 loader 무결성 플래그 검사다. 성공 projection 전에 기존 자산 reader와 같은 data_integrity_error 및 run 식별자를 반환한다. 정상 빈 근거와 headerless legacy NULL 의미 및 no-write 경계는 유지된다. 신규 test의 실제 인수와 assertions를 직접 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 거래 ID만 남기지 않고 계산 입력을 고정한다. 자산 고정 근거와 source_snapshot이 같은 run에 연결되며 당시 정책은 헤더에 저장된다.
- `C07` — `satisfied`
- 계약: 검토 승인 지문에 거래 집합 당시 값 분류 정책 버전 결과 여섯 총계 평가자료 포함 제외 미확정 상태를 결속하고 관련 drift와 승인 저장 결과 불일치를 거부한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. draft review serial 148; approval 368-376; finalize 395-445. source_policy_and_category_drift_invalidate_approval, policy_edit_persists_versions_and_invalidates_approval, stored_aggregation_version_drift_invalidates_approval와 persisted tampering tests를 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 거래 집합 전체와 정책 및 집계 결과가 지문에 포함된다. 정책 변경은 version 증가와 승인 무효화이며 최종 저장값도 승인 결과와 대조한다.
- `C08` — `satisfied`
- 계약: 한 DB 트랜잭션에서 헤더 양 상세 근거 초안 완료 연결과 저장 응답을 기록하고 여섯 계산식 및 실제 저장 일치를 검증하며 불일치와 중간 실패는 전부 롤백한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. BEGIN IMMEDIATE 385; persisted group/header/evidence/asset comparison 421-445; completed response write 462. header/assets/cashflow/completion injection과 header_total/asset_amount/asset_currency/header_source/header_policy/header_version tampering assertions를 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py
- 판정 근거: 수입 지출 합계와 차 및 자산 부채 합계와 차를 같은 run에서 대조한다. 오류는 context-manager transaction 밖으로 전달되어 완료 상태도 남기지 않는다.
- `C09` — `satisfied`
- 계약: 동일 멱등 키와 동일 승인 요청은 동일 run과 저장 응답을 반환하고 다른 요청은 충돌한다. 과거 마감은 불변이고 최신 parent 단일 child 정정은 append하며 각각 exact run으로 조회한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. finalize replay 386-400; initial and correction unique indexes; exact reader 164-201. concurrent_close_retries_return_one_saved_result, replay_and_correction_keep_each_run_immutable, completed_get_and_saved_snapshot_ignore_later_live_ledger_changes의 실제 assertions를 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_draft_correction_contract.py
- 판정 근거: 재시도는 live review 전에 저장 응답을 반환한다. 정정의 최신 parent 및 unique child 경계를 유지하며 최초와 정정 상세는 run으로 분리된다.
- `C10` — `satisfied`
- 계약: additive idempotent 이관은 미보존 구버전 총계를 NULL로 남기고 소급 backfill이나 fake zero를 하지 않는다. 기존 미마감 초안은 종합 검토 재승인 후 마감한다.
- 구현 근거: jarca_ledger_mcp/infrastructure/sqlite/migrations.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. nullable header 이관과 schema13 fixture DDL 및 실제 baseline public API fixture를 독립 pinned base blob에 대조했다. legacy migration 반복 NULL 보존 및 original header without migration, legacy asset approval 재승인 tests를 확인했다. Review 78 F-002의 실제 조건부 마감은 기존 자산 보고를 보존하면서 새 조회에서도 누락 및 이월 근거를 반환한다. 이번 F-003 보완은 monthly_settlement_service.py 208-209의 기존 loader 무결성 플래그 검사다. 성공 projection 전에 기존 자산 reader와 같은 data_integrity_error 및 run 식별자를 반환한다. 정상 빈 근거와 headerless legacy NULL 의미 및 no-write 경계는 유지된다. 신규 test의 실제 인수와 assertions를 직접 확인했다.
- 테스트 근거: tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement.py
- 판정 근거: 기존 초안과 자산 마감을 유지하며 asset-only 과거 지문은 새 종합 지문과 다르므로 마감할 수 없다. old-column reader는 조회 중 migrate하지 않는다.
- `C11-F01` — `satisfied`
- 계약: MCP 및 인증된 Dashboard에서 종합 초안과 저장 마감 결과를 제공하고 현재 보고와 구분하며 구버전 부분 자료 누락 제외를 표시한다. Dashboard는 목록 입력 경고 및 승인 불가 사유를 전달 표시한다.
- 구현 근거: dashboard/page_views/settlement_drafts.py, dashboard/page_views/monthly_settlement.py, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/adapters/mcp/server.py, jarca_ledger_mcp/adapters/mcp/tool_contracts.py, jarca_ledger_mcp/adapters/streamlit/settlement_gateway.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. Review 76 F01 해소를 settlement_drafts.py 212-223의 거래 ID 사유 및 승인 disabled, monthly_settlement.py 279-297의 상태 NULL 상세 표시에 확인했다. Review 78 F-002는 287-288에서 기존 evidence renderer로 헤더 excluded_items carried_items approval을 표시하여 해소했다. test_saved_monthly_panel_renders_real_conditional_exclusion_carry_and_approval 261-294는 실제 baseline API fixture와 현재 gateway를 사용하고 저장 response는 mock하지 않는다. 누락 ID 사유 이월 ID 평가일 승인자 사유 참조 표시 assertions를 확인했다. 이 page test는 live 요약 부분을 mock하며 실제 인증 통과 증명은 기존 synthetic-auth app test에 한정한다. 이번 F-003 보완은 monthly_settlement_service.py 208-209의 기존 loader 무결성 플래그 검사다. 성공 projection 전에 기존 자산 reader와 같은 data_integrity_error 및 run 식별자를 반환한다. 정상 빈 근거와 headerless legacy NULL 의미 및 no-write 경계는 유지된다. 신규 test의 실제 인수와 assertions를 직접 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement_adapters.py
- 판정 근거: 서비스의 차단 원인과 대상 거래가 표시되고 부분 또는 구버전 마감이 완전한 현재 보고로 오인되지 않는다. 기존 인증과 읽기 no-write 근거를 유지한다.
- `C12` — `satisfied`
- 계약: synthetic 검증으로 여섯 식 정책 drift 재시도 동시성 롤백 역사 불변 정정 분리 NULL 이관 기존 API MCP Dashboard 호환을 검증한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; 현재 head manifest b117579aa15e25382b89ada59fa3281e5547a109c29e93f013a022986c63fbed, plan f52b8156b193a6f0c35f385e372e857bdf0f7acd50199219d7960f44537be2d5와 169개 exact Git blob 및 실제 argv exit output timeout termination을 대조했다. 구현자 전체 suite 525 passed 4 skipped 1 warning 및 Ruff exit 0이다. 현재 수집 실행의 529개 ID를 source-binding하고 baseline 513개 및 기존 skip 상태 보존과 16개 추가를 check-tests로 확인했다. 신규 손상 회귀는 3필드와 2손상 형태 및 exact latest 12조합에서 service gateway 실제 MCP tool 전달을 대조하고 raw marker 비노출 및 전체 DB dump 불변을 검사한다. 정상 빈 배열 3조합과 headerless schema11 1개 회귀의 인수와 assertions도 직접 확인했다. Reviewer는 제품 테스트를 실행하지 않았다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py, tests/test_settlement_cashflow_schema.py, tests/test_comprehensive_settlement_adapters.py
- 판정 근거: 필수 service와 transport 검증의 구현자 실행을 채택한다. 신규 UI 및 문서 회귀의 호출 인수와 assertions를 직접 대조했고 reviewer 제품 테스트 실행이나 Chromium browser 또는 CI 성공으로 표현하지 않는다.
- `C13` — `satisfied`
- 계약: 정수 정밀도 NULL과 zero KRW 권위 verified 평가 대표 부채 및 투자 중복 합산 금지 읽기 no-create auth-before-DB credential 비노출을 유지한다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/application/shared.py, dashboard/app.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. 기존 자산 authority source는 변경되지 않았고 new reader는 read_db를 사용한다. KRW blocker 101-103과 recursive saved projection 228-244 및 authentication before database ordering을 확인했다. 이번 F-003 보완은 monthly_settlement_service.py 208-209의 기존 loader 무결성 플래그 검사다. 성공 projection 전에 기존 자산 reader와 같은 data_integrity_error 및 run 식별자를 반환한다. 정상 빈 근거와 headerless legacy NULL 의미 및 no-write 경계는 유지된다. 신규 test의 실제 인수와 assertions를 직접 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement_adapters.py, tests/test_settlement_draft_policy_consistency.py
- 판정 근거: 동일 통화 권위와 기존 자산 승인 정책을 유지한다. 실제 credential 없이 synthetic 인수 기록만 읽었으며 unknown output field를 allowlist로 제거한다.
- `C14` — `satisfied`
- 계약: 독립 정산 lifecycle 원장 자동 재작성 소급 집계 새 FX 가격 인증 메뉴 변경과 별도 현금흐름 조건부 승인을 도입하지 않는다.
- 구현 근거: jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py, jarca_ledger_mcp/adapters/mcp/server.py; 전체 30개 changed file과 62개 API hunk를 immutable base/head에 대조했다. 이전 승인 head 이후 변경은 monthly_settlement_service.py의 무결성 flag 검사 두 줄과 tests/test_comprehensive_settlement.py의 3개 test 함수뿐이다. 167개 blob 및 기존 test 함수 AST는 동일하다. 새 변경은 기존 저장 근거와 안전한 read model 계약에 대응하며 schema UI classifier 문서 및 기존 자산 reader를 바꾸지 않는다.
- 테스트 근거: 없음
- 판정 근거: 모든 변경은 승인된 extension 또는 필수 문서와 지적 보완 검증에 대응한다. 독립 정산 FX 인증 메뉴 변경이나 범위 초과는 없다.
- `D01` — `satisfied`
- 계약: REQ-003의 ID 경로 제목을 유지하고 revision을 올려 기존 계약과 전체 baseline AC 의미를 보존하며 Issue 18과 실제 구현 PR 19를 기존 traceability에 추가한다.
- 구현 근거: docs/requirements/req-003_account-valuation-history.md; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. REQ-003 revision 1.2와 정확한 ID 경로 제목 및 기존 12와 15 이슈, 13과 16 PR, 새 Issue 18과 PR 19 traceability를 확인했다. pinned base의 38개 requirement와 AC 블록 및 global 계약 전체를 current 48개 블록과 대조했다. 34개 블록은 exact 동일하며 4개 변경은 승인된 schema14 additive 및 title 확장이다. 기존 검증 판정 및 불변 의미 손실은 없다. 기존 inline 분류 10개는 flat 구조 helper 비지원 범위이므로 분류 필드를 직접 대조했고 신규 AC18-27의 검증 경로와 assertions를 확인했다.
- 테스트 근거: tests/test_requirement_docs.py, tests/test_settlement_draft_docs.py
- 판정 근거: 기존 인수 의미 손실은 없고 새 정책과 저장 계약 및 실제 PR 19가 명시됐다. 기존 혼합 분류 형식의 구조 검사 한계는 문서 정규화 참고 사항이며 제품 동작 결함이나 새 mandatory gate로 승격하지 않는다.
- `D02-F02` — `satisfied`
- 계약: 데이터 모델은 확정 헤더 추가 필드별 타입 NULL legacy 의미 필수성과 초안 정책 집계 버전 JSON 재현 입력 신규 상세 전체 필드와 제약을 명세한다.
- 구현 근거: docs/data-model.md, jarca_ledger_mcp/infrastructure/sqlite/migrations.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. F02 해소: docs/data-model.md 198-243의 세 필드 표와 재현 입력을 migrations.py 36,145-170 및 schema.py 193-228과 대조했다. 열 타입 nullability default와 logical identifier 필수성, 신규 종합 마감의 모든 열 제공, legacy NULL, 원래 양수 환급과 적용 음수 및 당시 자산 입력이 명시됐다. test_settlement_cashflow_model_documents_schema_and_legacy_reproduction는 실제 PRAGMA 표와 전체 지정 필드를 비교한다.
- 테스트 근거: tests/test_settlement_cashflow_schema.py
- 판정 근거: 헤더 초안 상세의 필드별 계약과 정책 버전 당시 입력을 통한 재현 경계가 보완됐다. 정본 기존 승인 완료 지문 응답 및 원자성 계약은 유지된다.
- `D03-F03` — `satisfied`
- 계약: 인터페이스 계약은 기존 초안 operation의 정책 버전 여섯 총계 카테고리 상세 누락 경고 입력 출력과 필수성, 저축 목록 편집 환급 음수 및 미분류 차단 오류 재검토를 정의하고 실제 함수 도구 시그니처와 응답 예시를 구현에 대조한다.
- 구현 근거: docs/interface-contract.md, jarca_ledger_mcp/application/settlement_draft_service.py, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/monthly_settlement_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. docs/interface-contract.md 469-529에서 기존 정책 인수 exact entry schema 및 타입 중복 거부, 여섯 총계와 상세 blocker 필수성, version guard, 음수 환급 및 오류 재검토, response nesting과 synthetic examples를 구현에 대조했다. F03 보완은 유지된다. 신규 saved-reader additive metadata 503-516은 excluded_items carried_items applied_evidence approval의 타입 및 optional evidence key, recursive allowlist가 content redactor가 아닌 점, immutable header origin과 row-only legacy empty defaults를 실제 _closed_run_metadata 및 current reader에 맞게 명시한다. 이번 F-003 보완은 monthly_settlement_service.py 208-209의 기존 loader 무결성 플래그 검사다. 성공 projection 전에 기존 자산 reader와 같은 data_integrity_error 및 run 식별자를 반환한다. 정상 빈 근거와 headerless legacy NULL 의미 및 no-write 경계는 유지된다. 신규 test의 실제 인수와 assertions를 직접 확인했다.
- 테스트 근거: tests/test_comprehensive_settlement_adapters.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 공개 정책 입력과 출력 필수성 및 승인 차단 재검토를 소비자가 구성할 수 있다. 예시는 선택 필드라는 한계를 명시하고 root review와 saved reader를 구분한다. 기존 자산 플래그로 차단 우회 금지와 확정 제외 및 기존 envelope 계약은 유지된다.
- `D04-F04` — `satisfied`
- 계약: 프로젝트 구조 문서는 기존 service 책임과 실시간 보고의 구분 공통 business 집계 계층 및 실제 필요한 새 모듈 경로와 검증 책임을 구현 결과에 결속한다.
- 구현 근거: docs/project-structure.md, jarca_ledger_mcp/application/settlement_cashflow_service.py, jarca_ledger_mcp/application/settlement_draft_service.py; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. F04 해소: docs/project-structure.md 248-250의 실제 private settlement_cashflow_service.py 책임 표는 _normalize_cashflow_policy와 _review_cashflow 및 settlement_draft_service.py caller와 두 test 경로를 연결한다. test_settlement_cashflow_private_service_has_explicit_ownership_and_test_mapping의 단일 책임 행과 필수 symbol assertions를 확인했다.
- 테스트 근거: tests/test_settlement_cashflow_policy.py, tests/test_comprehensive_settlement_adapters.py
- 판정 근거: 실제 공통 집계의 소유권과 호출 및 검증 관계를 정본에 보완했다. transport에 SQL 또는 별도 정책을 복제하지 않는다.
- `D05` — `satisfied`
- 계약: 런타임 흐름은 명시적 정책 설정 현재 재집계 종합 지문 승인 트랜잭션 재검증 여섯 식과 원자 저장 저장 조회 및 정책별 제외 음수 차단 재검토 롤백 동시 replay 정정 흐름을 명세한다.
- 구현 근거: docs/runtime-flow.md; 동일 계약과 이전 Review 79의 검토를 재사용했다. 새 head까지 전체 delta와 167개 불변 Git blob 및 기존 test 함수 AST 보존을 확인했다. docs/runtime-flow.md 276-280와 기존 lifecycle/no-create/privacy/correction 절을 함께 대조했다. 월 범위 정책 mapping unresolved blocker approval 재검증 same transaction rollback persisted replay latest parent append 및 stored/live 구분을 모두 기록한다.
- 테스트 근거: tests/test_comprehensive_settlement.py, tests/test_settlement_cashflow_policy.py
- 판정 근거: 원래 source authority와 credential 비노출 및 관찰 metadata와 lifecycle 경계를 유지한다. 실제 Dashboard의 표시 및 헤더 근거 연결은 별도 C11 criterion에서 확인했다.
### 범위 판정
- 누락: 없음
- 범위 초과: 없음
- 명세 모순: 없음
### 결론
승인 계약의 19개 criterion이 모두 satisfied여서 approve다. 이전 Review 76과 78의 보완은 불변 source와 이전 판정을 결합해 유지됨을 확인했다. Review 80 F-003은 기존 loader의 손상 표시를 성공 반환 전에 검사하여 해소됐으며 named 회귀의 exact latest 오류 응답 전달 raw 비노출 no-write와 정상 빈 근거 및 headerless legacy 호환 assertions를 직접 확인했다. 잔여 및 신규 finding과 문서 보완은 해당 없음이다. 구현자 exact-head 전체 suite는 525 passed 4 skipped 1 warning이고 Ruff는 성공이다. Reviewer 제품 실행 및 Chromium 또는 CI 성공을 주장하지 않는다. 기존 혼합 AC 형식은 자동 구조 검사 비지원 한계를 유지한다. Merge release 승인이 아니다.
<!-- gitea-agent:implementation-spec-review/v1 owner=jsfamily repository=jarca-ledger-mcp issue=18 pr=19 head=53ce20956d9085c5d9a8e61770886863a38ac08c contract-sha256=7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6 result-sha256=d38ef93d0775be496f9b6e7a86ea48df6538b10ba2daaa7a2f721ceafac75508 correlation=110b3b699d011fb25edb53d1074c40ab2a60d1f816d3d1f85ca49bc43a69db35 -->
현재 head의 spec 승인: review 81, gitea-spec-agent, APPROVED / nonstale / nondismissed. Authenticated reviewer: gitea-review-agent, account ID 7.
사용 스킬: 실제 하네스 harness/agents/review/skills/gitea-code-review/SKILL.md.
이전 지적과 결론
F-003 해결 — jarca_ledger_mcp/application/monthly_settlement_service.py:208-209에서 기존 loader의 evidence_integrity_error를 성공 응답/근거 projection 전에 검사한다. 손상된 applied_evidence, excluded_evidence, carried_evidence를 빈 정상 근거로 오인하지 않고, 기존 자산 reader와 같은 data_integrity_error 및 run ID만 반환한다.
손상 JSON, 잘못된 root object 및 배열 내부 null을 자산 전용 조건부 마감과 종합 마감에 각각 주입했다. exact/latest 조회, Streamlit gateway, MCP tool 함수가 같은 안전한 오류를 전달하고 조회 전후 DB가 불변임을 직접 확인했다. 정상 근거 복원 및 []는 허용된다.
F-001/F-002 해결 유지 — 활성 카테고리 권위/fallback provenance, 저장된 누락·제외·이월·승인 근거 및 legacy NULL 반환을 현재 focused 회귀로 확인했다. 실제 baseline 공개 API로 만든 schema13 조건부 마감 fixture의 이관 전후 기존 자산 응답 보존과 exact/latest/no-write 검증도 통과했다.
새 중요 결함이나 승인 전 필수 검증 공백은 발견하지 못했다. 경미한 신규 변경 요청도 없다. 이는 검토 범위 내 clean review이며 무결함의 증명이나 merge/release 승인이 아니다.
범위와 근거
이전 review 80의 head 10201cdb7573546daaa11a4e3df2a8f628a1493e부터 현재 head까지 2개 파일의 전체 delta와 loader/호출자/공개 응답/테스트를 직접 검토했다. 신규 production 변경은 위 guard이며, 테스트는 기존 파일 끝에 추가됐다. 기존 함수 AST와 이전 파일 바이트 prefix가 보존됐다.
전체 base-to-head 변경은 30개 파일이다. 이전 독립 리뷰의 전체 diff/주변 코드 검토를 재사용하되, 후속 delta와 167개 불변 Git blob을 독립 대조했다. 문서·schema·정책·승인·저장·UI 변경의 이전 판단을 현재 검증 결과와 결합했다. 미변경 코드의 새 개선 탐색으로 범위를 확대하지 않았다.
리뷰어 직접 실행: 관련 8개 module 116 passed, exit 0. 환급/저축/미분류/통화, 승인 drift, 원자 저장·롤백, concurrent replay/정정, migration, 실제 MCP stdio 및 synthetic-auth AppTest 회귀를 포함한다. 별도 integrity probe 18 case 통과, exit 0. git diff --check exit 0.
Reviewer evidence-manifest/v3의 command/exit/output/environment/source/deadline/termination과 canonical validate exit 0을 확인했다. 모든 실행은 completed, direct child reap 및 process-group cleanup 완료, timeout/출력 초과 없음이다. Probe는 사전 합의한 REVIEW_RESULT single-record framing으로 검증했다.
구현자 exact-head 실행 재사용: 전체 525 passed, 4 skipped, 1 warning, Ruff exit 0. Manifest SHA-256 b117579aa15e25382b89ada59fa3281e5547a109c29e93f013a022986c63fbed; source 169개 blob 및 plan/output/claim 결속과 canonical validate를 독립 확인했다. 전체 suite를 reviewer 재실행으로 표현하지 않는다.
Baseline/previous/current inventory 435/513/529 ID의 Git source-binding 및 check-tests 통과. 기존 ID/skip/xfail 상태 보존, 이번 16개 추가를 실제 collection 출력과 대조했다. Reviewer inventory 검증에서 pytest summary 문구를 잘못 가정한 준비 오류 1건은 실제 enumerated ID 대조로 수정했으며 원래 실패 기록을 보존했다. 제품 실패나 TDD RED로 분류하지 않는다.
Remote head CI/status 항목은 비어 있다. 기존 4개 skip은 sample PDF/password 부재, 1 warning은 Starlette/httpx deprecation이다. 실제 Chromium과 운영 원장은 검증하지 않았으며 AppTest와 동일시하지 않는다.
기존 승인 환경 Python 3.13.5, pytest 9.1.1, MCP 1.28.0, Streamlit 1.58.0, Starlette 1.3.1, httpx 0.28.1을 실제 확인했다. 신규 환경 설치나 dependency 변경은 하지 않았다.
Strict projection은 key allowlist이며 allowlisted scalar의 content-based secret sanitizer가 아니다. Headerless schema11 correction metadata의 조회 방식별 기존 차이는 이번 수정 범위 밖이며 그대로 보존한다.
위임 근거는 사용하지 않았다 (mode=none). Source/test/ref/state 수정, commit/push/merge, Issue 변경, 기존 review dismiss 또는 자동 implementation handoff는 수행하지 않았다.
증빙: /opt/data/gitea-agent/repositories/jsfamily/jarca-ledger-mcp/worktrees/issue-18/verification/review-20261014_051653_216e56d5/의 main-result.json, rework.diff, evidence-manifest.json, inventory-summary.json, source/계약 snapshot. Same-UID local evidence이며 다른 host의 공개 접근은 주장하지 않는다.
<!-- gitea-agent:code-review/v1 owner=jsfamily repository=jarca-ledger-mcp issue=18 pr=19 head=53ce20956d9085c5d9a8e61770886863a38ac08c contract-sha256=7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6 -->
## 독립 코드 재리뷰
- Verdict: `approve`
- 대상: jsfamily/jarca-ledger-mcp, Issue #18 / PR #19
- Reviewed head: `53ce20956d9085c5d9a8e61770886863a38ac08c`
- Base: `f67c07adf01d1f17415bf7cf836f46997ca6f21c`
- Contract SHA-256: `7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6`
- 현재 head의 spec 승인: review 81, gitea-spec-agent, APPROVED / nonstale / nondismissed. Authenticated reviewer: gitea-review-agent, account ID 7.
- 사용 스킬: 실제 하네스 `harness/agents/review/skills/gitea-code-review/SKILL.md`.
### 이전 지적과 결론
- **F-003 해결** — `jarca_ledger_mcp/application/monthly_settlement_service.py:208-209`에서 기존 loader의 `evidence_integrity_error`를 성공 응답/근거 projection 전에 검사한다. 손상된 `applied_evidence`, `excluded_evidence`, `carried_evidence`를 빈 정상 근거로 오인하지 않고, 기존 자산 reader와 같은 `data_integrity_error` 및 run ID만 반환한다.
- 손상 JSON, 잘못된 root object 및 배열 내부 `null`을 자산 전용 조건부 마감과 종합 마감에 각각 주입했다. exact/latest 조회, Streamlit gateway, MCP tool 함수가 같은 안전한 오류를 전달하고 조회 전후 DB가 불변임을 직접 확인했다. 정상 근거 복원 및 `[]`는 허용된다.
- **F-001/F-002 해결 유지** — 활성 카테고리 권위/fallback provenance, 저장된 누락·제외·이월·승인 근거 및 legacy NULL 반환을 현재 focused 회귀로 확인했다. 실제 baseline 공개 API로 만든 schema13 조건부 마감 fixture의 이관 전후 기존 자산 응답 보존과 exact/latest/no-write 검증도 통과했다.
- 새 중요 결함이나 승인 전 필수 검증 공백은 발견하지 못했다. 경미한 신규 변경 요청도 없다. 이는 검토 범위 내 clean review이며 무결함의 증명이나 merge/release 승인이 아니다.
### 범위와 근거
- 이전 review 80의 head `10201cdb7573546daaa11a4e3df2a8f628a1493e`부터 현재 head까지 **2개 파일의 전체 delta**와 loader/호출자/공개 응답/테스트를 직접 검토했다. 신규 production 변경은 위 guard이며, 테스트는 기존 파일 끝에 추가됐다. 기존 함수 AST와 이전 파일 바이트 prefix가 보존됐다.
- 전체 base-to-head 변경은 30개 파일이다. 이전 독립 리뷰의 전체 diff/주변 코드 검토를 재사용하되, 후속 delta와 **167개 불변 Git blob**을 독립 대조했다. 문서·schema·정책·승인·저장·UI 변경의 이전 판단을 현재 검증 결과와 결합했다. 미변경 코드의 새 개선 탐색으로 범위를 확대하지 않았다.
- **리뷰어 직접 실행:** 관련 8개 module **116 passed**, exit 0. 환급/저축/미분류/통화, 승인 drift, 원자 저장·롤백, concurrent replay/정정, migration, 실제 MCP stdio 및 synthetic-auth AppTest 회귀를 포함한다. 별도 integrity probe **18 case 통과**, exit 0. `git diff --check` exit 0.
- Reviewer `evidence-manifest/v3`의 command/exit/output/environment/source/deadline/termination과 canonical validate exit 0을 확인했다. 모든 실행은 completed, direct child reap 및 process-group cleanup 완료, timeout/출력 초과 없음이다. Probe는 사전 합의한 `REVIEW_RESULT ` single-record framing으로 검증했다.
- **구현자 exact-head 실행 재사용:** 전체 **525 passed, 4 skipped, 1 warning**, Ruff exit 0. Manifest SHA-256 `b117579aa15e25382b89ada59fa3281e5547a109c29e93f013a022986c63fbed`; source 169개 blob 및 plan/output/claim 결속과 canonical validate를 독립 확인했다. 전체 suite를 reviewer 재실행으로 표현하지 않는다.
- Baseline/previous/current inventory **435/513/529 ID**의 Git source-binding 및 `check-tests` 통과. 기존 ID/skip/xfail 상태 보존, 이번 16개 추가를 실제 collection 출력과 대조했다. Reviewer inventory 검증에서 pytest summary 문구를 잘못 가정한 준비 오류 1건은 실제 enumerated ID 대조로 수정했으며 원래 실패 기록을 보존했다. 제품 실패나 TDD RED로 분류하지 않는다.
- 위험 matrix의 필수 경계(근거 손상 fail-closed, 정상/legacy 호환, adapter/privacy, 정책/승인 drift, 원자성/불변성/멱등, 이관, 계약·테스트 보존, 자원/성능)는 위 직접·정적·검증된 재사용 근거 범위에서 통과했다.
### 한계 및 보존
- Remote head CI/status 항목은 비어 있다. 기존 4개 skip은 sample PDF/password 부재, 1 warning은 Starlette/httpx deprecation이다. 실제 Chromium과 운영 원장은 검증하지 않았으며 AppTest와 동일시하지 않는다.
- 기존 승인 환경 Python 3.13.5, pytest 9.1.1, MCP 1.28.0, Streamlit 1.58.0, Starlette 1.3.1, httpx 0.28.1을 실제 확인했다. 신규 환경 설치나 dependency 변경은 하지 않았다.
- Strict projection은 key allowlist이며 allowlisted scalar의 content-based secret sanitizer가 아니다. Headerless schema11 correction metadata의 조회 방식별 기존 차이는 이번 수정 범위 밖이며 그대로 보존한다.
- 위임 근거는 사용하지 않았다 (`mode=none`). Source/test/ref/state 수정, commit/push/merge, Issue 변경, 기존 review dismiss 또는 자동 implementation handoff는 수행하지 않았다.
- 증빙: `/opt/data/gitea-agent/repositories/jsfamily/jarca-ledger-mcp/worktrees/issue-18/verification/review-20261014_051653_216e56d5/`의 `main-result.json`, `rework.diff`, `evidence-manifest.json`, `inventory-summary.json`, source/계약 snapshot. Same-UID local evidence이며 다른 host의 공개 접근은 주장하지 않는다.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
gitea-spec-agent
gitea-review-agent
Closes #18
구현
문서와 계약
승인된 다섯 문서를 update-in-place했습니다. 기존 38개 요구/AC ID와 9개 global 의미 단위, Issue의 12개 포함 항목을 대응했고 AC18–27을 추가했습니다. 구현 PR 번호 #19를 canonical requirement metadata와 두 계약 테스트에 정확히 반영했습니다.
기존 구현 검증 — 이전 head 기록
616bb7a744bf5cb200f5aa367a0555db49bd84ed; strict clean checkout, 169 Git-bound source files.ruff check --no-cache ., base-to-headgit diff --check: exit 0.evidence_manifest.py run/validate: exit 0, schemaevidence-manifest/v3.검증 명령(실제 argv):
검증 기록과 접근 경계
i18-final-head-2/opt/data/gitea-agent/repositories/jsfamily/jarca-ledger-mcp/worktrees/issue-18/verification/i18-final-head-2evidence-manifest.json, SHA-25620817a3e11a8e0527f6902b1ec1d7c30b78608d40bab3aa946147651b3d4933aevidence-plan.json, SHA-25649586f48b0b5ef901167070570aaa3a8644f289ab230110b6cbb059c6ac722a4reviewer-access-receipt.json으로 확인하며, 다른 host/UID의 공개 다운로드 권한은 주장하지 않습니다.전달 경계
Issue 전용 branch의 non-force 전달입니다. PR merge, Issue close, release/deploy는 수행하지 않습니다. 원격 branch/PR head는 별도 authoritative readback으로 기록합니다.
검토 재작업 — review 76
616bb7a744bf5cb200f5aa367a0555db49bd84edae4383ca2cf5cf576d9b370f6d62828b616d9418새 exact-head 검증
99e30de8b894cee65c1826d0b4d39709d7ab62c6cb42353534947d221e20ab42f285326a63ead0efafe05b5681461d2ceb458e27cce869bec1bcf65ae8ad38fd(authenticated download readback 일치).검토 재작업 — review 78
ae4383ca2cf5cf576d9b370f6d62828b616d941810201cdb7573546daaa11a4e3df2a8f628a1493echeck --no-cache .: exit 0. 정본 manifest validation: exit 0.8633cab871737f4f950d85cf65f38b4f9456db306310c525bd2f5071fe669ee1; 인증된 원격 다운로드 readback 일치.ab19e42dd541060c5dd7c0cdcf48fa0b2b82bb33df2dc3460c767607ea0b04fa; plan SHA-256:fcb48c89681403bdb029924290621773334ac8e2281d6761ca71aa5e653b0b5b. ZIP의 exact/evidence-manifest.json에 full SHA·실제 argv·exit·환경·출력·timeout·termination이 결속되어 있습니다.구현 명세 적합성 검토
616bb7a744bf5cb200f5aa367a0555db49bd84ed7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6request_changesAcceptance criteria 판정
C01—satisfiedC02—satisfiedC03—satisfiedC04—satisfiedC05—satisfiedC06—satisfiedC07—satisfiedC08—satisfiedC09—satisfiedC10—satisfiedC11-F01—unsatisfiedC12—satisfiedC13—satisfiedC14—satisfiedD01—satisfiedD02-F02—unsatisfiedD03-F03—unsatisfiedD04-F04—unsatisfiedD05—satisfied범위 판정
결론
승인된 저장 집계 승인 롤백 불변성 호환성의 구현과 exact-head 구현자 실행 근거는 확인했다. 그러나 F01의 필수 화면 표시와 F02-F04의 필수 정본 문서 계약이 누락되어 request_changes다. 각 finding에 적은 기존 계약 범위의 최소 보완만 요청하며 새 기능 새 증빙 commit 새 CI 또는 일괄 제품 테스트 재실행을 요구하지 않는다. 제품 테스트는 구현자가 실행했고 reviewer는 고정 source 및 기록을 read-only 검토했다. 이전 native finding은 없으므로 해소 잔여는 해당 없음이며 네 항목은 이번 신규 finding이다.
구현 재작업 결과
616bb7a744bf5cb200f5aa367a0555db49bd84edae4383ca2cf5cf576d9b370f6d62828b616d94187cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6rework_delivered지적 처리
resolvedresolvedresolvedresolved최종 검증
다음 단계
Reviewer가 rework head를 새 snapshot으로 다시 검토해야 하며 이 comment는 기존
REQUEST_CHANGES를 해제하거나 승인을 의미하지 않는다.구현 명세 적합성 검토
ae4383ca2cf5cf576d9b370f6d62828b616d94187cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6approveAcceptance criteria 판정
C01—satisfiedC02—satisfiedC03—satisfiedC04—satisfiedC05—satisfiedC06—satisfiedC07—satisfiedC08—satisfiedC09—satisfiedC10—satisfiedC11-F01—satisfiedC12—satisfiedC13—satisfiedC14—satisfiedD01—satisfiedD02-F02—satisfiedD03-F03—satisfiedD04-F04—satisfiedD05—satisfied범위 판정
결론
승인 계약의 19개 criterion이 모두 충족돼 approve다. Review 76의 F01-F04는 현재 head의 화면 필드와 저장 상태 표시, 필드별 데이터 모델, 공개 정책 응답 오류 계약, 실제 private module 책임 및 named 회귀 assertions로 해소됐다. 잔여 finding과 신규 finding은 해당 없음이다. 문서 보완은 필수 승인 계약의 누락 해소이며 별도 새 요구사항이나 blocker를 추가하지 않았다. Product 실행은 구현자의 exact-head 기록이고 reviewer는 제품 테스트를 실행하지 않았다. 기존 혼합 AC 분류는 자동 구조 검사의 비지원 범위라 직접 대조했으며 CI와 Chromium 성공은 주장하지 않는다.
독립 코드 리뷰
request_changesae4383ca2cf5cf576d9b370f6d62828b616d9418f67c07adf01d1f17415bf7cf836f46997ca6f21c7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6gitea-spec-agent, APPROVED / nonstale / nondismissed.harness/agents/review/skills/gitea-code-review/SKILL.md.F-001 — 비활성 카테고리 분류를 적용하여 지출을 조용히 제외함
jarca_ledger_mcp/application/settlement_cashflow_service.py:50-56,76-77,104-108.exclude로 등록되어 거래에 사용된 뒤 공개delete_ledger_category(..., force=True)로 비활성화된다. 그 거래는 여전히 active이고 초안에 별도 제외 정책 판단은 없다.lc.active=1조건 없이 비활성 행의cashflow_kind를 읽는다. 해당 지출은 excluded로 집계되고 blocker 없이 승인/저장된다. 동시에sourceprovenance는fallback이라 기록하지만 실제 원래 분류는 비활성 행의exclude다. 기존 활성 분류 기반 보고의 fallback과 계산 근거가 불일치한다.expenses=50, 종합 마감expense_total=0; 저장 source는category_active=0,originalcashflow_kind=exclude,cashflow_kind=excluded,sourceprovenance=fallback. 공개 API 생성·비활성화·검토·승인·마감까지 실제 SQLite로 수행했다.F-002 — 구버전 조건부 마감의 헤더에 저장된 누락·제외 근거가 신규 저장 조회에서 사라짐
jarca_ledger_mcp/application/monthly_settlement_service.py:221-225,251,dashboard/page_views/monthly_settlement.py:284-302.close_asset_snapshot(..., allow_missing_exclusions=True, approved_by=..., approval_reason=..., approval_reference=...)로 누락 계좌를 명시 승인한 자산 전용 조건부 마감을 만든다. 이 기존 API는 반영 항목만 상세 row로 쓰고 누락·제외는 헤더excluded_evidence에 보존한다 (assets_service.py:864-920)._snapshot_rows_for_run에서 이미 읽은 metadata의excluded_evidence/carried_evidence를 반환에 반영하지 않는다. legacy에서는source_snapshot={}이고items는 반영 상세 row만 남는다. 따라서 누락 계좌 ID와missing_verified_exact_valuation사유가 전체 신규 응답에서 사라진다. 신규 저장 패널도items와source_snapshot.assets만 사용하므로 해당 근거를 표시할 수 없다.close_status=conditional만으로 어떤 항목이 빠졌는지 알 수 없다.init_db로 이관했다. 기존get_asset_snapshot_report는 전후 완전히 같고 누락 계좌 ID/사유를 반환한다. 신규get_monthly_settlement_snapshot은 성공/legacy/conditional이지만 해당 ID/사유를 반환하지 않는다. 조회 전후 DB dump는 동일하다.items에 제외 항목이 있는 경우를 검증하지만 실제 기존 직접 마감은 그 행을 쓰지 않는다. 이 미검증 경로는 현재 요구 범위이며 별도 개선으로 미룰 수 없다.검토 범위와 실행 근거
mode=none).evidence-manifest/v3; command/exit/output/environment/timeout/termination/source 결속과 validate exit 0 확인. 모든 child 종료/reap/group cleanup 확인.git diff --checkexit 0.99e30de8b894cee65c1826d0b4d39709d7ab62c6cb42353534947d221e20ab42, 169개 Git blob digest를 독립 대조/validate했다. Baseline/current collection 435/507 ID의 source-binding 및check-tests통과, 기존 ID/status 보존을 확인했다. 이 전체 suite를 reviewer 재실행으로 표현하지 않는다.init_db이관 후 재검토/재승인은 가능했다. 이관 선행 제한으로 기록하며 별도 blocker로 승격하지 않는다.증빙 위치 및 결론
/opt/data/gitea-agent/repositories/jsfamily/jarca-ledger-mcp/worktrees/issue-18/verification/의review-20261013_214000_556c6ef9와review-boundary-20261013_214000_556c6ef9에 main 결과·위험 matrix·실제 명령과 출력·source binding을 보존했다. Same-UID local evidence이며 다른 host 공개 접근을 주장하지 않는다.F-001/F-002의 제한된 수정과 해당 회귀 검증 후, 새 exact head의 spec pass → 독립 code 재리뷰가 필요하다. merge/release 승인이 아니다.
구현 재작업 결과
ae4383ca2cf5cf576d9b370f6d62828b616d941810201cdb7573546daaa11a4e3df2a8f628a1493e7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6partial지적 처리
resolvedresolved최종 검증
다음 단계
Reviewer가 rework head를 새 snapshot으로 다시 검토해야 하며 이 comment는 기존
REQUEST_CHANGES를 해제하거나 승인을 의미하지 않는다.구현 명세 적합성 검토
10201cdb7573546daaa11a4e3df2a8f628a1493e7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6approveAcceptance criteria 판정
C01—satisfiedC02—satisfiedC03—satisfiedC04—satisfiedC05—satisfiedC06—satisfiedC07—satisfiedC08—satisfiedC09—satisfiedC10—satisfiedC11-F01—satisfiedC12—satisfiedC13—satisfiedC14—satisfiedD01—satisfiedD02-F02—satisfiedD03-F03—satisfiedD04-F04—satisfiedD05—satisfied범위 판정
결론
승인 계약의 19개 criterion이 모두 satisfied여서 approve다. Review 76의 F01-F04 보완은 유지되며 Review 78 F-001의 활성 카테고리 권위와 fallback provenance 및 F-002의 구버전 조건부 마감 헤더 근거 반환과 화면 표시를 현재 source 및 named regression assertions와 구현자 exact-head 실행으로 확인했다. 잔여 및 신규 finding은 해당 없음이다. 문서 보완은 additive metadata의 타입과 privacy 경계를 정확히 설명하며 새 산출물 의무를 만들지 않는다. Reviewer는 제품 테스트를 실행하지 않았다. AppTest를 실제 Chromium 또는 CI 성공으로 표현하지 않는다. 기존 혼합 AC 형식은 자동 검사 비지원 범위라 직접 검토했다. Merge release 승인이 아니다.
독립 코드 재리뷰
request_changes10201cdb7573546daaa11a4e3df2a8f628a1493ef67c07adf01d1f17415bf7cf836f46997ca6f21c7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6gitea-spec-agent, APPROVED / exact head / nonstale / nondismissed.harness/agents/review/skills/gitea-code-review/SKILL.md(0.1.4).이전 review #78의 수정 확인
settlement_cashflow_service.py:53-54의 JOIN이lc.active=1로 기존 활성 카테고리 권위 경계를 따릅니다. 공개 soft-delete → 검토 → 승인 → 마감 → 저장 조회를 독립 재현한 결과, synthetic 지출 50원은 live/saved 모두 50원이고 저장 provenance는fallback, category 값은 null, original kind는expense입니다. 카테고리를 다시 활성화한 뒤 기존 승인으로 마감하면conflict: review/approval stale로 거부되고 run은 추가되지 않았습니다. 신규 named 회귀는 여러 비활성 분류·환급·이동·명시적 미분류 판단도 검증합니다.monthly_settlement_service.py:251-254가 strict public projection으로 헤더의 제외/이월/적용/승인 근거를 additive 반환하고,monthly_settlement.py:287-288가 저장 패널에 표시합니다. 실제 baseline schema-13 공개 API로 조건부 마감 fixture를 생성하여 독립 검증했습니다. 누락 source ID/당시 사유·이월 평가일·승인 정보가 보존되고 exact/latest, 이관 전/후 신규 조회가 같습니다. 기존 자산 보고와 legacy NULL 총계 및 조회 no-write를 유지했습니다. 실제 gateway/DB를 쓰는 신규 AppTest도 통과했습니다.F-003 — 손상된 저장 헤더 근거를 빈 배열로 위장하여 성공 반환
jarca_ledger_mcp/application/monthly_settlement_service.py:251-254및 이 경로의_snapshot_rows_for_run호출:165-168,199-201.excluded_evidence,carried_evidence,applied_evidence중 하나에 malformed JSON 또는 객체 등 배열이 아닌 JSON이 저장되어 있습니다. 정상 public API 경로가 이 값을 생성한다고 주장하지 않습니다. 저장 기록 손상/직접 변경 시의 읽기 무결성 경계입니다.assets_service.py:272-281,312-334에서 이를 탐지하여evidence_integrity_error=True로 표시하고 파싱 실패 값은 내부적으로[]로 치환합니다. 신규 reader는 이 플래그를 검사하지 않은 채_closed_run_metadata(metadata)와ok(**header_evidence, ...)를 호출합니다. 결과적으로 실제로 읽을 수 없는 저장 근거가 “항목 없음”이라는 성공 응답이 됩니다. 기존get_asset_snapshot_report는 같은 run에 대해assets_service.py:1004-1006에서data_integrity_error로 fail closed합니다.{) 및 wrong JSON shape(객체)를 주입했습니다. 6개 case 모두 loader의 integrity flag는 true이고 기존 자산 reader는 실패하지만, 신규 exact/latest reader는 서로 동일한success=true,close_status=conditional을 반환했습니다. 손상된 해당 collection은[]이며,excluded_evidencecase에서는 원래 있던 누락 계좌 ID/사유가 사라졌습니다. 조회 전후 DB dump는 같았습니다.integrity-evidence-manifest.json#/commands/0의 실제 실행/출력과header_integrity_probe.py에 결속했습니다.evidence_integrity_error를 검사하여 안전한 실패 envelope로 반환합니다. raw 손상 JSON을 응답/로그에 노출하지 않고 조회 no-write를 유지합니다. exact/latest의 3필드 × malformed JSON/wrong-shape named 회귀를 추가하고, 정상 헤더의 빈 배열·정상 조건부 근거·헤더 없는 schema-11 legacy의 empty defaults/NULL 총계가 계속 성공하는 것을 확인합니다. F-001/F-002의 이미 통과한 정상 경로와 기존 자산 reader를 변경해 차이를 숨기지 않습니다.검토 범위와 실행 근거
mode=none).evidence-manifest.json#/commands/0.boundary-evidence-manifest.json); 손상 헤더 6case 관측 probe exit 0 (integrity-evidence-manifest.json). 후자의 exit 0은 제품 결함 관측 성공이며 수정의 GREEN이나 TDD를 주장하지 않습니다.as_offixture에exact정책의 사유 문자열을 잘못 hard-code하여 실패했습니다. baseline 원래 보고의 실제 사유와 비교하도록 reviewer assertion만 수정했고, 최초 실패 기록을 덮어쓰지 않고 별도 canonical manifest에 재실행을 보존했습니다. 제품 코드/테스트는 수정하지 않았습니다.ab19e42dd541060c5dd7c0cdcf48fa0b2b82bb33df2dc3460c767607ea0b04fa; 169개 Git blob과 계획 digest 및 정본 validate를 독립 확인했습니다. 이 전체 suite를 reviewer 재실행으로 표현하지 않습니다. 기존 4 skip은 sample/password 부재, 1 warning은 기존 Starlette/httpx deprecation입니다.check-testsexit 0.git diff --checkexit 0. Canonical reviewer manifest 검증과 실제 child reap/group cleanup 확인.증빙 위치와 결론
/opt/data/gitea-agent/repositories/jsfamily/jarca-ledger-mcp/worktrees/issue-18/verification/review-r2-20261013_214000_556c6ef9-m4536/에 위험 matrix, main 결과, complete snapshot/delta, 세 canonical manifest와 source/inventory 검증을 보존했습니다. Same-UID local evidence이며 다른 host의 공개 접근을 주장하지 않습니다.F-001/F-002 정상 경로는 해결됐으나 F-003으로 REQUEST_CHANGES입니다. 이는 merge/release 승인이 아닙니다.
구현 재작업 결과
10201cdb7573546daaa11a4e3df2a8f628a1493e53ce20956d9085c5d9a8e61770886863a38ac08c7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6rework_delivered지적 처리
resolved최종 검증
다음 단계
Reviewer가 rework head를 새 snapshot으로 다시 검토해야 하며 이 comment는 기존
REQUEST_CHANGES를 해제하거나 승인을 의미하지 않는다.구현 명세 적합성 검토
53ce20956d9085c5d9a8e61770886863a38ac08c7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6approveAcceptance criteria 판정
C01—satisfiedC02—satisfiedC03—satisfiedC04—satisfiedC05—satisfiedC06—satisfiedC07—satisfiedC08—satisfiedC09—satisfiedC10—satisfiedC11-F01—satisfiedC12—satisfiedC13—satisfiedC14—satisfiedD01—satisfiedD02-F02—satisfiedD03-F03—satisfiedD04-F04—satisfiedD05—satisfied범위 판정
결론
승인 계약의 19개 criterion이 모두 satisfied여서 approve다. 이전 Review 76과 78의 보완은 불변 source와 이전 판정을 결합해 유지됨을 확인했다. Review 80 F-003은 기존 loader의 손상 표시를 성공 반환 전에 검사하여 해소됐으며 named 회귀의 exact latest 오류 응답 전달 raw 비노출 no-write와 정상 빈 근거 및 headerless legacy 호환 assertions를 직접 확인했다. 잔여 및 신규 finding과 문서 보완은 해당 없음이다. 구현자 exact-head 전체 suite는 525 passed 4 skipped 1 warning이고 Ruff는 성공이다. Reviewer 제품 실행 및 Chromium 또는 CI 성공을 주장하지 않는다. 기존 혼합 AC 형식은 자동 구조 검사 비지원 한계를 유지한다. Merge release 승인이 아니다.
독립 코드 재리뷰
approve53ce20956d9085c5d9a8e61770886863a38ac08cf67c07adf01d1f17415bf7cf836f46997ca6f21c7cfff2b1a9ee284fca1b4397bc8cf23a77752f6da914ca547830ae6ec49266d6harness/agents/review/skills/gitea-code-review/SKILL.md.이전 지적과 결론
jarca_ledger_mcp/application/monthly_settlement_service.py:208-209에서 기존 loader의evidence_integrity_error를 성공 응답/근거 projection 전에 검사한다. 손상된applied_evidence,excluded_evidence,carried_evidence를 빈 정상 근거로 오인하지 않고, 기존 자산 reader와 같은data_integrity_error및 run ID만 반환한다.null을 자산 전용 조건부 마감과 종합 마감에 각각 주입했다. exact/latest 조회, Streamlit gateway, MCP tool 함수가 같은 안전한 오류를 전달하고 조회 전후 DB가 불변임을 직접 확인했다. 정상 근거 복원 및[]는 허용된다.범위와 근거
10201cdb7573546daaa11a4e3df2a8f628a1493e부터 현재 head까지 2개 파일의 전체 delta와 loader/호출자/공개 응답/테스트를 직접 검토했다. 신규 production 변경은 위 guard이며, 테스트는 기존 파일 끝에 추가됐다. 기존 함수 AST와 이전 파일 바이트 prefix가 보존됐다.git diff --checkexit 0.evidence-manifest/v3의 command/exit/output/environment/source/deadline/termination과 canonical validate exit 0을 확인했다. 모든 실행은 completed, direct child reap 및 process-group cleanup 완료, timeout/출력 초과 없음이다. Probe는 사전 합의한REVIEW_RESULTsingle-record framing으로 검증했다.b117579aa15e25382b89ada59fa3281e5547a109c29e93f013a022986c63fbed; source 169개 blob 및 plan/output/claim 결속과 canonical validate를 독립 확인했다. 전체 suite를 reviewer 재실행으로 표현하지 않는다.check-tests통과. 기존 ID/skip/xfail 상태 보존, 이번 16개 추가를 실제 collection 출력과 대조했다. Reviewer inventory 검증에서 pytest summary 문구를 잘못 가정한 준비 오류 1건은 실제 enumerated ID 대조로 수정했으며 원래 실패 기록을 보존했다. 제품 실패나 TDD RED로 분류하지 않는다.한계 및 보존
mode=none). Source/test/ref/state 수정, commit/push/merge, Issue 변경, 기존 review dismiss 또는 자동 implementation handoff는 수행하지 않았다./opt/data/gitea-agent/repositories/jsfamily/jarca-ledger-mcp/worktrees/issue-18/verification/review-20261014_051653_216e56d5/의main-result.json,rework.diff,evidence-manifest.json,inventory-summary.json, source/계약 snapshot. Same-UID local evidence이며 다른 host의 공개 접근은 주장하지 않는다.