Calculation catalog › Social Security

Social security computation summary counts

How many years were averaged into AIME and how many of them are $0.

Field: AIME computation year counts Unit: count Basis: no dollar basis Computed by: UI-native Status: Complete chain

Appears in: ss-page (SocialSecuritySection "Averages your top N earning years ... M of those years are $0")

Calculation records

  • Zero years in the averaged earnings Formula record, justified by derivation

    Purpose: Count how many of the years averaged into a worker's AIME have no earnings.

    Statement: socialSecurity/piaFromEarnings.ts#computePiaFromEarnings publishes zeroYearsInAime, the number of entries of yearsUsedInAime, the indexed amounts it averaged into the AIME, that are 0, beside computationYearCount, the number of those years. Units: years. Rounding: none; integers.

    Formula: zeroYearsInAime = count of v in yearsUsedInAime with v = 0

    • yearsUsedInAime: Indexed earnings of the benefit computation years, the largest after the dropout (unit: usd/year) (domain: nonnegative)

    Timing: once per earnings history

    Rounding: none

    Limits:

    • Counts the years this computation averaged, so it follows its computation-year window: always 35 years for a worker whose window has 40, the base years from 22 to 61 (usc-42-415-b-2-b-ii-iii-initial-computation-base-window)

    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: aime-zero-year-count.md Mutation receipt: aime-zero-year-count.mutation.md

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

    Implemented in: piaFromEarnings.ts

    Is the number of: social-security-computation-summary-counts

Transformations

  • socialSecurity/piaFromEarnings.ts#computePiaFromEarnings publishes computationYearCount and zeroYearsInAime, the number of averaged years whose indexed earnings are $0; the explainer prints both.

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.