Cash flow line amount

Dollar amount carried by a source-to-use line in the selected year cash-flow drilldown.

Field: Cash-flow line amount Unit: US dollars Basis: as displayed Computed by: UI transformation Status: Complete chain

Appears in: cash-flow-drilldown (Sankey link and node amount labels)

Calculation records

• Cash-flow drilldown amounts Composition record, justified by derivation

  Purpose: Where each amount on the selected year's cash-flow chart comes from: published lines and the ledger's own reconciliation totals.

  Statement: In the selected-year cash-flow chart each link amount is one published line's Plan-dollar amount; the Household cash node is the cash identity's source total, reconciliation.cash.sourceTotalPlanDollars, and the Unfunded node the use identity's unfunded total, reconciliation.uses.unfundedUsesPlanDollars, both published by projection/annualCashFlowReconciliation.ts#reconcileYearCashFlow; the Unfunded node appears when that total is above 0. The source total is (spendable sources + portfolio funding) + loan proceeds, each a sum by role in line order, so for source lines of 41,234.11 (spendable), 17,890.20 (portfolio), 3,000.30 (spendable), 0 (loan) and 12.07 (spendable) it is 62,136.68000000001, where adding the lines in order gives 62,136.68; both print $62,137. The transfer view's in and out totals and the grouped Other node add engine lines by the chart's own grouping and stay in the planner as chart aggregation (decision R18). Units: nominal Plan dollars, shown through the page's dollar basis. Rounding: none.

  Formula: hub = (spendable + portfolioFunding) + loanProceeds; unfunded = sum of unfundedPlanDollars over use lines; link = line amount

  • spendable, portfolioFunding, loanProceeds: Source line amounts summed by role, in line order (unit: USD, nominal of the year) (domain: >= 0)
  • unfundedPlanDollars: Each use line's unfunded part (unit: USD, nominal of the year) (domain: >= 0)

  Timing: once per captured year

  Rounding: none

  Limits:

  • The transfer view's in and out totals and the Other node's amount printed on the chart are sums of engine lines by the chart's grouping and have no engine record; the Other threshold is a layout rule.
  • The hub differs from the line-order sum the chart used to add only in the last binary digit (32 of 1,210 example years, at most 5.82e-11); no printed whole dollar changes.
  • A year whose report is not reconciled is refused by the chart before any amount is read.

  Provenance: derived by claude, implemented by claude-subagent.

  Independent review: codex

  Gates (6 of 6 pass): fixture registers a test: pass; pins resolve: pass; families exist: pass; worksheet exists: pass; mutation receipt exists: pass; provenance independent: pass

  Worksheet: cash-flow-line-amount.md Mutation receipt: cash-flow-line-amount.mutation.md

  Evidence tests: annualCashFlowReconciliation.drilldown.evidence.test.ts

  Implemented in: annualCashFlowReconciliation.ts

  Is the number of: cash-flow-line-amount

Transformations

• Links are published lines; the Household cash and Unfunded nodes read reconciliation.cash.sourceTotalPlanDollars and reconciliation.uses.unfundedUsesPlanDollars (projection/annualCashFlowReconciliation.ts#reconcileYearCashFlow); transfer-endpoint in and out sums and Other sums are chart aggregation (R18); every amount is shown through the dollar basis.