feat: add reconciliations to the ledger facade

[jfrench9]

Summary

Adds reconciliations to the ledger facade, so a script or an agent can list them, run them, record a statement balance, change a block's policy and sign a period off. Regenerated against robosystems main (ed9f4cf2), which carries the reconciliation surface from robosystems #1646, #1649, #1652, #1653 and booked_on from #1655. The TypeScript twin is robosystems-typescript-client #243.

Release order: cut the client release only after the robosystems release that contains #1652 and #1653 is deployed. list_reconciliations selects GraphQL fields that only exist from that release (ledgerBalance, independentBalance, balanceAsOf, components, notes), so the query fails validation against an older server. Merging is safe at any time, and no existing method is affected: the two fields added to the fiscal calendar query are already served.

Changes

Facade (clients/ledger_client.py), stable tier, additive

• list_reconciliations(graph_id, period): every reconciliation block's standing for a period.
• preview_reconciliations(graph_id, period, *, method, include_tied): one comparison, nothing recorded.
• refresh_reconciliations(graph_id, period): run every check that applies and record the results. notes names a check that could not run.
• record_statement_balance(graph_id, *, element_id, as_of, balance, document_id, note).
• set_reconciliation_policy(graph_id, structure_id, *, required_for_close, materiality, review_required, separate_reviewer): an omitted field keeps its value.
• sign_off_reconciliation(graph_id, structure_id, period, note).
• close_period takes allow_unreconciled_accounts; create_schedule takes booked_on.
• get_fiscal_calendar carries unreconciled_account_count and unreconciled_account_sample.
• download_report_bundle now defaults to the holon (format="holon-jsonld"), which carries the whole report. Pass format="tavi" for the compiled model.

GraphQL

• operations/ledger/ListLedgerReconciliations.graphql (new); GetLedgerFiscalCalendar.graphql selects the two unreconciled-account fields. schema.graphql refreshed and generated/ regenerated from it.

Generated tier (api/, models/)

• Five new operations: preview_reconciliations, refresh_reconciliations, record_statement_balance, set_reconciliation_policy, sign_off_reconciliation, with their request and response models.
• allow_unreconciled_accounts on the close and backfill requests; reconciliation as a block type; ReconciliationMechanics; booked_on on the schedule metadata request.
• The sync path is what the facade uses; the generated async functions come with the regeneration and were not exercised.

Compatibility

ADDITIVE, plus one facade default that moved: download_report_bundle returns the holon unless a format is named. A caller that relied on the default now gets a different file and passes format="tavi" to keep the old one. That rides this minor and belongs in the release notes.

Otherwise: new facade methods, two new optional keyword arguments, and new generated operations and models. I compared the emitted models: no file was deleted, and no field was removed or became required. The only removed lines are docstrings. A minor.

Testing

• just test-all: 609 passed, 17 skipped; format, lint and typecheck clean.
• Twelve new facade tests: the read and its variables, a graph with no ledger, the request body of each write (including that unset options are left off), an unknown check being refused, a refusal carrying the server's response, and the two new options on close_period and create_schedule.
• Regenerated against a local stack serving robosystems main; booked_on and the reconciliation operations were confirmed present in its /openapi.json first. An earlier regeneration in this checkout had run against a stale stack and lacked booked_on; it was redone.
• Not run against a deployed server.

🤖 Generated with Claude Code

https://claude.ai/code/session_01N4VGnvrpE2cwbBZykz4yGd