Implement Virginia Child Care Subsidy Program (CCSP)

[hua7450]

Summary

Implements Virginia's Child Care Subsidy Program (CCSP) in PolicyEngine, including eligibility determination, locality-grouped income tests, copayment calculation (both current 2023 and new 2025-07-01 scales), maximum reimbursement rates (MRR) by provider type/region/age group, and benefit computation.

Closes #7932

Regulatory Authority

• 8VAC20-790 — Virginia Administrative Code, Child Care Program
• CCSP Guidance Manual (Oct 2025) — Operational guidance including Appendix Z (locality groups)
• CCSP Copayment Scale (Effective July 1, 2025) — New copay schedule
• HB30 Item 126 #2h — Budget amendment enacting copay changes
• VDOE MRR Rates — Maximum reimbursement rates by region

Program Overview

• Official name: Child Care Subsidy Program (CCSP)
• Oversight: Virginia Department of Education (VDOE)
• Administration: Virginia Department of Social Services (VDSS) through local departments
• Funding: Federal CCDBG/CCDF block grant + state funds

Eligibility

Requirement	Source	How Modeled
Child under 13	8VAC20-790-20(A)	va_ccsp_child_eligible: age < p.child (13)
Extended age under 18 (disabled)	8VAC20-790-20(B)	where(is_disabled, p.disabled_child, p.child)
Child citizenship/immigration	8VAC20-790-40(B)(1)	Reuses is_ccdf_immigration_eligible_child
Virginia residency	8VAC20-790-40(A)	defined_for = StateCode.VA
Asset test ($1M)	8VAC20-790-40(C)(4)	Reuses is_ccdf_asset_eligible
Activity test	8VAC20-790-30	Work hours >= 8/wk, student, disabled, or meets_ccdf_activity_test fallback
12-month eligibility period	8VAC20-790-40(D)	va_ccsp_enrolled input switches to SMI exit limit

Income Eligibility

Virginia uses a dual FPG/SMI income test with locality-based thresholds.

New applicants: income must not exceed FPG rate by locality group (derived from county via Appendix Z):

Locality Group	FPG Rate	Example Localities
Group I (81 localities)	150% FPG	Accomack, Lynchburg, Roanoke
Group II (30 localities)	160% FPG	Henrico, Norfolk, Chesapeake
Group III (16 localities)	185% FPG	Arlington, Fairfax, Loudoun

Fairfax/Alexandria exception: 250% FPG capped at 85% SMI (Appendix Z footnote).

Young child exception: families with child age ≤ 5 qualify at max(FPG limit, 85% SMI).

Enrolled families: 85% SMI regardless of locality group.

Categorical waivers: TANF, Medicaid, and WIC recipients are automatically income-eligible.

Copayment

Current Scale (2023–June 2025)

Income as % FPG	Per-Child Monthly
0–100%	$0
101–200%	$60
201–300%	$120
301%+	$180

Max 3 children assessed · 7% income cap · TANF exempt

New Scale (July 2025+)

Income as % FPG	Per-Child Monthly
$0	$0
>0–100%	$5
101–150%	$125
151–200%	$175
201–250%	$225
251–300%	$275
301–350%	$325
351%+	$375

Max 3 children assessed · 5% income cap · TANF exempt

Copay counts only children actually attending care (childcare_attending_days_per_month > 0), not all eligible siblings.

Maximum Reimbursement Rates (MRR)

Rates vary by 9 Ready Regions × provider type (center vs family day home) × 5 age groups (infant/toddler/2yr/preschool/school-age). Part-day = 70% of full-day.

Age group cutoffs use month-based thresholds: infant < 16mo, toddler 16–23mo, 2yr 24–35mo, preschool 36–59mo, school-age 60mo+.

Benefit formula: min(max(expenses - copay, 0), monthly_mrr)

Known Limitations

What	Why
9 VA independent cities (e.g., Manassas, Covington) commented out	Not in PolicyEngine's county_enum; fall through to defaults
September 30 kindergarten cutoff	Requires birth month input; approximated with 60-month threshold
Locality group default for unlisted counties	Falls through to Group I (most conservative)

Files

parameters/gov/states/va/dss/ccsp/
  activity/, age_threshold/, copay/, income/, localities/,
  maximum_reimbursement_rate/ (center, family_day_home, ready_region/)

variables/gov/states/va/dss/ccsp/
  va_ccsp.py, va_ccsp_locality_group.py, va_child_care_subsidies.py
  eligibility/ (eligible, child_eligible, income_eligible, activity_eligible,
                income_test_waived, enrolled)
  income/ (countable_income)
  copay/ (copay)
  rates/ (daily_mrr, care_age_group, provider_type, is_full_day, ready_region)

tests/policy/baseline/gov/states/va/dss/ccsp/
  15 test files + 7 edge case files

Test Plan

• 156 test assertions pass
• Unit tests for all variables with logic
• Edge cases: threshold boundaries, locality groups, Fairfax exception, TANF/Medicaid/WIC waivers, month-based age cutoffs, copay cap binding, disabled parent activity test
• Integration tests: full pipeline from inputs through eligibility, copay, MRR, and benefit
• Ready region coverage: all 9 regions tested
• CI passes

🤖 Generated with Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (30cb6e5) to head (98a0c82).
⚠️ Report is 42 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##              main     #7933    +/-   ##
==========================================
  Coverage   100.00%   100.00%            
==========================================
  Files            1        17    +16     
  Lines           15       293   +278     
  Branches         1         0     -1     
==========================================
+ Hits            15       293   +278     

Flag	Coverage Δ
unittests	100.00% <100.00%> (ø)

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.