Flexible goal funded amount annual

Dollars delivered to flexible goals during the projection year.

Field: flexibleGoalFundedAmount Unit: US dollars Basis: nominal dollars Computed by: Engine Status: Complete chain

Appears in: csv (flexibleGoalFundedAmount)

Calculation records

• Annual flexible-goal outcomes: four counts and two amounts Model record, justified by derivation

  Purpose: What the goal scheduler decided this year, as the six numbers the year row publishes.

  Statement: spending/flexibleGoals.ts#createGoalScheduler visits unresolved goals by classification rank (required, target, ideal, excess), then explicit priority, then plan order, and resolves each against a hard flexible-goal budget. A fixed goal funds its inflated amount unconditionally in its target year and does NOT consume the budget. A movable or skippable goal funds fully when budget + 0.005 is at or above the inflated amount; else, when partial funding is allowed and the budget clears minFundingPct of the INFLATED amount, it partially funds for the remaining budget; else it defers while the year is before latestYear and is skipped at latestYear. projection/internal/annualOneTimeGoalFundingPhase.ts#annualOneTimeGoalFundingPhase folds those outcomes into the six counts and amounts published as projection/internal/types/result.ts#YearResult.flexibleGoals: funded and partiallyFunded both add fundedNominal to fundedAmount and unfundedNominal to unfundedAmount, a deferred goal only increments deferred, and a skipped goal adds its whole amountNominal to unfundedAmount and to its classification's skipped total. Outside guardrail mode the scheduler is absent and all six publish exactly 0 while every goal still funds in its target year. Units: counts, and nominal USD per year. Rounding: none.

  Formula: funded/partiallyFunded/deferred/skipped are outcome counts; fundedAmount = sum of fundedNominal over funded and partially funded goals; unfundedAmount = sum of unfundedNominal over those goals plus amountNominal of every skipped goal

  • amountNominal: Goal amount inflated to the year, amountTodayDollars x inflFactor (unit: usd) (domain: nonnegative)
  • budget: Hard flexible-goal budget for the year; null is unlimited (unit: usd) (domain: nonnegative or null)
  • minFundingPct: Minimum share of the inflated amount a partial funding must clear (unit: percent) (domain: 0..100)
  • EPSILON: Half-cent slack in the budget comparisons (unit: usd) (domain: 0.005)

  Timing: once per projection year, before the funding fixed point

  Rounding: none

  Limits:

  • Movable and skippable goals end the same way: one still unfunded at latestYear is skipped and its amount is folded into the layer totals, so neither is dropped from them. The model/plan.ts#GoalFlexibility comment once promised a movable goal a layer shortfall and a skippable goal a silent drop; decision D-GOAL-FLEXIBILITY (2026-09-25) kept the scheduler, and the comment now describes it. This record follows the scheduler, as the worksheet does
  • The worksheet's two cases are states annualOneTimeGoalFundingPhase produces, and the evidence drives the real phase and the real createGoalScheduler with no seam: a pull-forward year (not cutting, goals may be pulled forward), where the phase hands the scheduler the $1,700 remaining upside budget and the budget constrains the goals pulled forward before their target year; and a cutting year, where the budget is 0, goals not yet in the schedule have no outcome, and the skippable goal at its latest year skips. The first derivation paired a cutting year with a positive budget, which the completed YearResult.flexibleGoals comment rules out; it was re-derived on 2026-09-22 and re-approved by the reviewer
  • The zero-guardrail case is asserted on a real simulatePlan run instead, where the scheduler is absent: all six fields publish exactly 0 while the goal still funds and shows up in expenses.oneTimeGoals
  • A fixed goal does not consume the flexible budget; letting it do so changes every later goal's outcome, which is the worksheet's first wrong reading

  Provenance: derived by codex, implemented by claude.

  Independent review: cursor

  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: flexible-goal-outcomes-annual.md Mutation receipt: flexible-goal-outcomes-annual.mutation.md

  Evidence tests: annualOneTimeGoalFundingPhase.evidence.test.ts

  Implemented in: flexibleGoals.ts; annualOneTimeGoalFundingPhase.ts; result.ts

  Is the number of: flexible-goals-funded-count-annual, flexible-goals-partially-funded-count-annual, flexible-goals-deferred-count-annual, flexible-goals-skipped-count-annual, flexible-goal-funded-amount-annual, flexible-goal-unfunded-amount-annual

  Feeds: spending-intended-annual

Records that feed this number

• Flexible goal scheduling Model record, justified by derivation

  Purpose: Schedule and fund flexible goals within their timing, priority and budget rules.

  Statement: spending/flexibleGoals.ts#createGoalScheduler resolves each goal at most once, ordering candidates by classification, explicit priority, then original order, inflating today's-dollar cost and permitting partial funding only when its minimum percentage and budget rules are met.

  Formula: A = costToday * inflation; minimum = A * minFundingPct/100; funded = min(A,budget); unfunded = A - funded

  • costToday: Goal cost (unit: today USD) (domain: nonnegative)
  • inflation: Cumulative inflation factor (unit: nominal/today) (domain: positive)
  • budget: Available flexible funding (unit: nominal USD) (domain: nonnegative)
  • minFundingPct: Partial funding minimum (unit: percent) (domain: 0..100)

  Timing: annual scheduling; each goal resolves once

  Rounding: none; budget comparisons use half-cent epsilon

  Limits:

  • The test uses a flexible target goal during a cut so the stated budget binds. At or after target without a cut, resolveBudget returns unlimited funding; fixed goals also ignore the flexible budget. projection/internal/annualOneTimeGoalFundingPhase.ts sums per-goal funded and unfunded amounts and counts outcomes; all seven annual families are downstream aggregates, not this record's individual amounts.

  Provenance: derived by codex, implemented by codex.

  Independent review: cursor

  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: flexible-goal-scheduling.md Mutation receipt: flexible-goal-scheduling.mutation.md

  Evidence tests: flexibleGoals.evidence.test.ts

  Implemented in: flexibleGoals.ts

  Feeds: flexible-goal-funded-amount-annual, flexible-goal-unfunded-amount-annual, flexible-goals-funded-count-annual, flexible-goals-partially-funded-count-annual, flexible-goals-deferred-count-annual, flexible-goals-skipped-count-annual, spending-one-time-goals-annual

Engine source: engine/src/projection/internal/types/result.ts (YearResult.flexibleGoals.fundedAmount)