Calculation catalog › Social Security

Social security PIA annualized

A claimant's monthly primary insurance amount (the full-retirement-age benefit, in the plan's first year) times twelve, as the couple primer prints it.

Field: PIA annualized Unit: US dollars Basis: today's dollars (real) Computed by: UI transformation Status: Complete chain

Appears in: ss-page (CoupleStrategyPanel couple primer "full-retirement-age benefit (PIA): $X/yr against $Y/yr")

Calculation records

  • The PIA a Social Security stream is paid from Composition record, justified by derivation

    Purpose: Resolve a stream's monthly PIA once, for the projection, its insights and the Social Security pages.

    Statement: socialSecurity/piaFromEarnings.ts#resolveStreamPiaMonthly returns the entered PIA as entered; otherwise, for a stream with an earnings history, the PIA #computePiaFromEarnings gives on the history and its projection (#streamPiaFromEarningsInput, the projection defaulting to the person's retirement age), raised by #piaWithCostOfLivingIncreases from the eligibility year through the year before the projection starts, with the years whose increase SSA has not announced; otherwise no PIA, with the reason: no PIA and no earnings history, or the computation's error. projection/simulate.ts#simulatePlan, the claim-milestone insight and the planner's Social Security pages all call it. The couple primer prints the resolved PIA x 12. Units: dollars a month. Rounding: the PIA's own, to the dime.

    Limits:

    • An entered PIA is taken to be in the first year's dollars already, as a PIA shown on a current SSA statement is
    • The yearly figure the couple primer prints is PIA x 12, the benefit at full retirement age, not the benefit at the claim age

    Provenance: derived by claude, implemented by claude.

    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: social-security-pia-resolution.md Mutation receipt: social-security-pia-resolution.mutation.md

    Evidence tests: piaFromEarnings.resolution.evidence.test.ts

    Implemented in: piaFromEarnings.ts; simulate.ts

    Is the number of: social-security-pia-annualized

    Feeds: social-security-benefit-annual

Transformations

  • × 12 of the engine's resolved monthly PIA (socialSecurity/piaFromEarnings.ts#resolveStreamPiaMonthly), a unit conversion.

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.