Calculation catalog › Insights
Insight impact ending after tax estate delta
Estimated change in ending after-tax estate from an insight action.
Field: endingAfterTaxEstateDelta Unit: US dollars Basis: nominal dollars Computed by: Engine Status: Complete chain
Appears in: insights (InsightCardView "Ending estate delta" after Preview impact; rough "≈ ... estate delta" when no qualitative text)
Calculation records
-
Insight impact: ending after-tax estate and lifetime tax deltas Formula record, justified by derivation
Purpose: What an insight's modeled action does to the estate and to lifetime taxes, as candidate minus baseline.
Statement: decisions/evaluateCandidate.ts#evaluateCandidate prices the candidate on its own full year-by-year projection and subtracts the shared baseline in the same direction for both fields: endingAfterTaxEstateDelta = candidateSummary.endingAfterTaxEstate - baselineSummary.endingAfterTaxEstate, and lifetimeTaxDelta = candidateSummary.lifetimeTaxesAndPenalties - baselineSummary.lifetimeTaxesAndPenalties. The estate field's comment states that order outright and the lifetime-tax field defines a negative value as savings, which is the same convention: an estate improvement is positive and a tax saving is negative. Units: nominal dollars, not today's: the estate delta is in dollars of the plan's last year (both runs end in that year), and the lifetime tax delta sums each year's own dollars. Rounding: none.
Formula:
estateDelta = E_candidate - E_baseline; taxDelta = T_candidate - T_baseline-
E: Ending after-tax estate of a run's summary (unit: usd) (domain: finite) -
T: Lifetime taxes and penalties of a run's summary (unit: usd) (domain: nonnegative)
Timing: once per evaluated candidate, against the context's single shared baseline
Rounding: none
Limits:
- Beyond the worksheet's inputs the evidence plan fixes two real one-year projections that land on the worksheet's four summary figures exactly: a 1963-born single filer (over 59.5 so no early-distribution rule, under 65 so no Medicare premium) with one $1,800,000 traditional account, a flat 25% tax double, heirTaxRatePct 50, zero return and zero inflation, and base spending of $600,000 in the baseline against $555,000 in the candidate scenario. At a flat rate r the withdrawal funding spending S is S / (1 - r) and the tax is r x that, and the estate is the remaining balance net of the heir rate
- The flat calculator is a test double, never the shipped stack: it exists so the test can name exact dollars without recomputing federal law, and it must not be read as a tax result
- Both deltas are differences of SUMMARIES, so they inherit every convention of summarizeProjection: the heir-tax haircut, charity carve-outs, and the fact that property, debts and ladder face ride through net worth without per-account estate rows
- The irmaa-tier-edge Insight writes its annual premium cliff into endingAfterTaxEstateDelta as an avoidance signal rather than an estate change; that exception belongs to that Insight’s own record and the evidence here does not exercise it
Provenance: derived by
codex, implemented byclaude.Independent review:
grokGates (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: insight-impact-estate-and-lifetime-tax-deltas.md Mutation receipt: insight-impact-estate-and-lifetime-tax-deltas.mutation.md
Evidence tests: evaluateCandidate.evidence.test.ts
Implemented in: evaluateCandidate.ts; types.ts; insightsAdapter.ts
Is the number of: insight-impact-ending-after-tax-estate-delta, insight-impact-lifetime-tax-delta
-
Records that feed this number
-
IRMAA tier-edge household Medicare premium cliff Model record, justified by derivation
Purpose: The extra annual Medicare premium a MAGI just over an IRMAA threshold triggers two years later, versus MAGI one dollar under it.
Statement: For a selected IRMAA edge with n Medicare enrollees in the charge year (lookback MAGI year + 2): cliff = n × ((Part B + Part D surcharge)_just-above − (Part B + Part D surcharge)_one-dollar-below), using the healthcare-premium scale for the charge year. Units: nominal dollars per year. Rounding: none; the card floors a negative difference at 0.
Formula:
cliff = n (P_above − P_below); P = partBAnnual + partDSurchargeAnnual-
n: Medicare enrollees (alive, age 65+) in the charge year (unit: people) (domain: integer n >= 1) -
P_above: Per-person annual Part B + Part D premium just above the MAGI threshold, already resolved (unit: usd/year) (domain: finite) -
P_below: Per-person annual Part B + Part D premium one dollar below the threshold, already resolved (unit: usd/year) (domain: finite)
Timing: charge year = MAGI year + 2 (the statutory lookback)
Rounding: a negative (P_above − P_below) is floored at 0 before multiplying by n; the card publishes whole-dollar strings (formatWholeUsd, Math.round) and the evidence asserts the published figure
Limits:
- A rough avoidance signal, not a claim that reducing current-year income changes a premium already charged
- The worksheet supplies the already-resolved per-person premiums; the evidence passes those through rather than recomputing medicareAnnualPremiumPerPerson
- The Insight only fires when MAGI is at most $5,000 over the next threshold; that proximity window is a screen, not part of the cliff identity
Provenance: derived by
codex, implemented bygrok.Independent review:
cursorGates (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: insight-irmaa-tier-edge-premium-cliff.md Mutation receipt: insight-irmaa-tier-edge-premium-cliff.mutation.md
Evidence tests: irmaaTierEdge.evidence.test.ts
Implemented in: irmaaTierEdge.ts
Is the number of: insight-irmaa-tier-edge-premium-cliff
-
Engine source: engine/src/insights/types.ts
(InsightImpact.endingAfterTaxEstateDelta)
The evidence links on this page (each record's worksheet, mutation receipt, evidence tests
and implementation, and the source links) are pinned to engine commit
2624dbdba9fd, committed 2026-10-11.
The live calculation index and
output-family census links point at the repository's main
branch, so you can check this snapshot against them.