cadrumo.application.ledger.workspace_reader module

Read one Ledger workspace projection from an authenticated profile’s stores.

cadrumo.application.ledger.workspace is deliberately pure: it joins already-loaded canonical facts. Something still has to LOAD those facts for an installed session, and doing it inside the projector would put persistence inside a pure join. This module is that reader, and it is the only one — the installed workbench and any other host resolve the same door rather than each assembling the fact set their own way.

The reader performs local reads only. It opens no network client, starts no operation, and never widens the caller’s bucket: every fact is read through the repositories the caller already bound to one authenticated profile.

read_ledger_workspace_projection(*, bucket_id, ports, calculation_revisions, work_units, transactions=None, invoices=None)[source]

Load one profile’s ledger facts once and project the workspace snapshot.

transactions and invoices let a caller that has already read this bucket hand those exact catalogues in, so the snapshot it later re-reads to check for a mid-capture write is the same one the projection was built from. Omitted, they are read here.

The preflight report is left to the projector’s own period-free default: tax readiness is a period-bound question, and the landing view is not scoped to a period, so asserting readiness here would answer a question the operator has not yet asked.

Core types: CalculationRevision, InvoiceCatalogue, TransactionCatalogue.

Return type:

LedgerWorkspaceProjectionV1

Parameters: