chore(jarca-ledger): finalize approved batch docs, dashboard, and CI smoke updates

docs/interface-contract.md

@@ -4,7 +4,7 @@
 - Baseline Seed: `.stage-pilot/bootstrap/baseline.yaml`
 - Status: draft
 - Owner: Jarca / project maintainer
-- Last Updated (KST): 2026-06-27 10:17
+- Last Updated (KST): 2026-06-29
 - Source Discovery / Batch: bootstrap-baseline
 
 ## Project Summary
@@ -23,12 +23,13 @@
 ### Representative Tool Groups
 - Health: `ledger_health_check`, `get_ledger_db_status`
 - Operational backup: `create_ledger_backup`, `list_ledger_backups`, `get_ledger_backup_status` (restore is intentionally not exposed as MCP)
-- Accounts: `create_ledger_account`, `list_ledger_accounts`
+- Accounts: `create_ledger_account`, `list_ledger_accounts`, `update_ledger_account`; account payloads include additive `liquidity_bucket` for asset-liquidity reporting.
 - Transactions: `create_ledger_transaction`, `list_ledger_transactions`, `update_ledger_transaction`, `delete_ledger_transaction`
-- Budgets/reports: `create_ledger_budget`, `list_ledger_budgets`, monthly/category/fixed/budget/investable reports
+- Budgets/reports: `create_ledger_budget`, `list_ledger_budgets`, monthly/category/fixed/budget/investable reports, `get_asset_liquidity_report`
 - Imports: KB Bank PDF, Toss Bank PDF, Toss Securities PDF, SeoulPay XLSX, CSV preview/import where implemented
 - Categories/rules: category CRUD, rule CRUD, categorization preview/apply, uncategorized summaries
 - Reconciliation: cross-account preview/run/review queue, self-transfer candidates/linking, cancel-original candidates/linking
+- Manual balance reconciliation: `get_balance_reconciliation_report` returns preview-only account reconciliation for `manual_only`/`partial_import` accounts.
 
 ### Inputs
 - Structured MCP tool arguments as declared in `server.py` signatures.
@@ -75,12 +76,17 @@
 
 ### Outputs
 - Tables, charts, dialogs, previews, import results, and transaction/category updates.
+- Browser evidence runs produce local PNG screenshots, DOM snapshot HTML files, and a manifest JSON for QC review.
 
 ### UI Contract Rules
 - Surface `cashflow_kind` where classification affects actual cashflow interpretation.
 - Keep actual income/expense separated from account movement summaries.
 - Rule page should support create/edit/delete and condition fields `amount_min`, `amount_max`, `day_of_month`.
 - Dialog-based triage actions should avoid losing context where possible.
+- Account page should display/edit `statement_status` and show a minimal manual balance reconciliation report without adding an automatic schedule or dedicated workbench.
+- Account page should display/edit `liquidity_bucket`; overview uses it with `last_balance` for asset liquidity/composition/debt/net-worth sections.
+- Overview top priority is KST current-month actual income/expense/net cashflow/savings rate based on `transaction_date` and `cashflow_kind`.
+- UI/dashboard-impacting batches require browser screenshot/snapshot evidence from synthetic/validation DBs. Non-UI batches may omit browser evidence, and docs-only batches do not require it.
 
 ## Interface: File Import Contracts
 - KB Bank PDF: encrypted/password-protected PDF account history; preserve transaction datetime, counterparty, balance, branch, raw summary, and raw payload.
@@ -95,13 +101,19 @@
 - Import batch metadata should support rollback and audit.
 - Broad mutation workflows should capture metadata-only DB status and backup evidence before/after risky operations.
 - Restore execution is limited to script/runbook workflows and explicit approval, not MCP tools.
+- Manual balance reconciliation is preview/report-first. `REVIEW_NEEDED` suggests manual decision values (`계좌이동`, `실지출`, `실수입`, `투자이동`, `분석제외`, `확인필요`) but does not auto-confirm mutations.
+- Asset liquidity reporting is account-based: `liquidity_bucket='loan'` is debt/net-worth only, and missing `last_balance` rows must not be inferred from transaction totals.
+- Browser evidence screenshots/snapshots must use synthetic or validation DBs only and must not include real account identifiers, source financial filenames, passwords, or raw payloads.
 - Financial data and passwords are sensitive runtime inputs and should not be committed.
 
 ## Current Gaps / Planned Changes
 - Formal versioning for MCP response contracts is not yet defined.
-- Browser-level UI acceptance criteria for Streamlit flows are not yet captured as REQ documents.
+- Browser-level UI evidence criteria are captured in REQ-004; broader CI automation is still not present.
 - CI contract for tests/lint is not yet present.
 
 ## Change Log
 - 2026-06-26 22:24 KST: Created by `bootstrap-baseline` from repository observation.
 - 2026-06-27 10:17 KST: BAT-002/REQ-002 기준으로 backup/status/list/hash MCP contract와 restore 비노출 정책 추가.
+- 2026-06-29 KST: REQ-003/BAT-003 기준으로 account statement status update와 balance reconciliation report contract 추가.
+- 2026-06-29 KST: REQ-004/BAT-004 기준으로 Streamlit browser evidence 산출물과 UI evidence gate 규칙 추가.
+- 2026-06-29 KST: REQ-005/BAT-005 기준으로 account `liquidity_bucket`, `get_asset_liquidity_report`, dashboard operations hub contract 추가.