Preserve claiming state through disability conversion

[MaxGhenis]

Disability conversions and people already marked as claimed can currently receive a new behavioral claiming-age draw when their planned age is missing. Add an explicitly imported successor adapter that partitions those people out before any PMF lookup or random draw. A conversion retains a missing behavioral plan, enters claimed state, and keeps that state after its annual event flag clears; existing plans and previously claimed years remain intact.

Callers can inject populace_dynamics.engine.claiming.apply_claiming through the existing PeriodModules.claiming interface. The historical function and registered assembly remain unchanged. An exact source exclusion and reachability assertions keep this separate module outside the historical birth-evidence identity while retaining engine.steps in that identity.

The schedule, age-50 threshold, nearest-year selection, and per-person random streams are unchanged. Eligible keyed draws match the historical adapter; the batch fallback is reproducible but can shift other people's same-seed draws because excluded people no longer consume randomness. This does not establish statutory conversion timing, insured status, PIA, benefit correctness, or a new scientific acceptance result.

Validation: 31 focused tests passed (17 new synthetic cases, 11 existing engine-step cases, and three exact source-identity/reachability selectors); Black at 79 columns, Ruff, and git diff --check passed. The real annual projection loop is exercised with an injected successor and synthetic other steps. Full local collection was not run. The test-tier baseline adds the 17 new unit cases, for 5,775 total cases. Independent source review covers the adapter, tests, documentation, and historical identity boundary.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
social-security-model	Ready	Preview	Sep 9, 2026 5:14pm UTC