Implement Maryland State Supplementary Payment (SSP)

[hua7450]

Summary

Implements Maryland's State Supplementary Payment (SSP), officially Public Assistance to Adults (PAA), for eligible Maryland residents in CARE Homes, Licensed Assisted Living, or MDH Rehabilitative Residences.

This implementation models PAA as a prospective SSI state-supplement cascade: each modeled PAA recipient is treated as applying for federal SSI, federal SSI is imputed from the person's federal SSI rules, and Maryland PAA fills the remaining gap to the applicable PAA need amount.

Closes #1137.

Regulatory Authority

• COMAR 07.03.07.03 — Eligibility Criteria
• COMAR 07.03.07.04 — Need Requirements
• COMAR 07.03.07.09 — Amount of Grant and Payee
• PAA Manual §300 — Technical Eligibility
• PAA Manual §900 — Calculation of Benefits
• DHS-FIA Action Transmittal 23-02 — PAA Rates and Per Diems table
• DHS-FIA Information Memo 26-04 — 2025 PNA increase to $106
• 42 USC § 1382(e)(1)(A) — federal SSI medical-treatment-facility cap

Calculation

For each eligible person, per month:

combined_need = provider_rate + personal_needs_allowance
imputed_federal_ssi = max(uncapped_ssi, 0)
md_paa = max(combined_need - ssi_countable_income - imputed_federal_ssi, 0)

This makes the modeled resources reconcile to the PAA need amount:

imputed federal SSI + Maryland PAA + SSI countable income = combined need

For zero-countable-income cases:

imputed federal SSI + Maryland PAA = combined need

Examples in 2026:

• CARE Home Level C: $1,173 provider rate + $106 PNA = $1,279; $994 imputed SSI + $285 PAA = $1,279.
• REHAB residence: $106 PNA; $30 imputed medical-facility SSI + $76 PAA = $106.
• Married SSI couple: imputed federal SSI follows federal SSI couple rules (couple_FBR / 2 = $745.50 per spouse in 2026), so PAA fills from that imputed federal amount to each person's PAA need.

Eligibility

Requirement	Source	How Modeled
Receives SSI, SSDI, or qualifying OASI on the basis of age/blindness/disability	COMAR 07.03.07.03(A)(2)	(ssi > 0) | (ssdi > 0) | (oasi > 0 & is_ssi_aged_blind_disabled)
Pending federal-benefit pathway	PAA Manual §300.5; COMAR 07.03.07.03	md_paa_pending_federal_benefit and is_ssi_aged_blind_disabled
Resources ≤ $2,000	PAA Manual §500	ssi_countable_resources <= ssi.individual_limit
Maryland resident	COMAR 07.03.07.03	defined_for = StateCode.MD
Resides in a PAA facility	PAA Manual §300 / §400	md_paa_living_arrangement enum
REHAB ⇄ SSI medical-facility consistency	42 USC § 1382(e)(1)(A)	Bidirectional check between REHAB_RESIDENCE and ssi_federal_living_arrangement == MEDICAL_TREATMENT_FACILITY

Benefit Amounts

Provider rates are parameterized from COMAR 07.03.07.04 and DHS-FIA AT 23-02:

Tier	2009-01-01	2021-01-01
CARE Home Level A	$740	$776
CARE Home Level B	$849	$875
CARE Home Level C	$1,137	$1,173
CARE Home Level D	$1,340	$1,376
Licensed Assisted Living	$858	$894
MDH Rehabilitative Residence	$0	$0

Personal Needs Allowance is parameterized from COMAR and DHS-FIA memoranda:

Effective Date	Amount
2009-01-01	$82
2022-07-01	$93
2023-07-01	$98
2024-07-01	$102
2025-07-01	$106

Architecture

• md_paa.py — state PAA amount using the prospective SSI cascade.
• md_paa_imputed_federal_ssi.py — imputed federal SSI, max(uncapped_ssi, 0), for PAA calculation.
• md_paa_eligible.py — eligibility gates for federal cash receipt or pending pathway, resources, facility residence, and REHAB medical-facility consistency.
• md_paa_living_arrangement.py — PAA facility enum.
• md_paa_provider_rate.py — provider-rate lookup by living arrangement.
• md_paa_personal_needs_allowance.py — PNA parameter passthrough.
• md_paa_total_cost_of_care.py — provider rate plus PNA.
• Registry entries in programs.yaml, household_state_benefits.yaml, and spm_unit_benefits.py.

Not Modeled / Known Limitations

• PAA-specific income details beyond the federal SSI countable-income approximation, including lump sums, parent contributions, and irregular-income exclusions.
• Private mental institution carve-out and 30-day absence disqualification.
• Per-diem prorating for fractional-month entry.
• REHAB $54/day allowable-cost threshold is not separately modeled; REHAB PAA is modeled as the PNA gap after imputed federal SSI and countable income.
• Original source transmittals for some intermediate PNA updates are not located; adjacent DHS-FIA documents corroborate the values.

Files

policyengine_us/parameters/gov/states/md/dhs/fia/paa/
├── personal_needs_allowance.yaml
└── provider_rate.yaml

policyengine_us/variables/gov/states/md/dhs/fia/paa/
├── md_paa.py
├── md_paa_eligible.py
├── md_paa_imputed_federal_ssi.py
├── md_paa_living_arrangement.py
├── md_paa_pending_federal_benefit.py
├── md_paa_personal_needs_allowance.py
├── md_paa_provider_rate.py
└── md_paa_total_cost_of_care.py

policyengine_us/tests/policy/baseline/gov/states/md/dhs/fia/paa/
├── integration.yaml
├── md_paa.yaml
├── md_paa_eligible.yaml
├── md_paa_imputed_federal_ssi.yaml
├── md_paa_personal_needs_allowance.yaml
└── md_paa_provider_rate.yaml

Test Plan

• python -m policyengine_core.scripts.policyengine_command test policyengine_us/tests/policy/baseline/gov/states/md/dhs/fia/paa -c policyengine_us — 61 passed
• ruff format policyengine_us/variables/gov/states/md/dhs/fia/paa/md_paa.py policyengine_us/variables/gov/states/md/dhs/fia/paa/md_paa_imputed_federal_ssi.py
• ruff check policyengine_us/variables/gov/states/md/dhs/fia/paa/md_paa.py policyengine_us/variables/gov/states/md/dhs/fia/paa/md_paa_imputed_federal_ssi.py
• CI passes

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.16%. Comparing base (8cb60e7) to head (9b6d171).
⚠️ Report is 10 commits behind head on main.

Additional details and impacted files

@@             Coverage Diff             @@
##              main    #8184      +/-   ##
===========================================
- Coverage   100.00%   95.16%   -4.84%     
===========================================
  Files            3        9       +6     
  Lines           63      124      +61     
  Branches         0        2       +2     
===========================================
+ Hits            63      118      +55     
- Misses           0        6       +6     

Flag	Coverage Δ
unittests	95.16% <100.00%> (-4.84%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.