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 byclaude.Independent review:
codexGates (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.