Implement West Virginia Child Care Assistance Program (CCAP)

changelog.d/wv-ccap.added.md

@@ -0,0 +1 @@
+Implement West Virginia Child Care Assistance Program (CCAP).

lessons/agent-lessons.md

@@ -0,0 +1,11 @@
+# Agent Lessons Learned
+
+Accumulated from /encode-policy-v2 and /backdate-program runs across all contributors.
+Loaded by implementation agents on future runs.
+
+## New Lessons from West Virginia CCAP (2026-04-08)
+
+### PARAMETER
+- When transcribing a multi-dimension lookup table (e.g., age group x quality tier x provider type), verify that row labels (age groups) are correctly aligned with their data columns; if one dimension's boundaries shift (e.g., age groups redefined), ALL rate values in that dimension must be re-read from the source — a wrong row-label mapping cascades to every value in the affected rows, not just one.
+- Never invent a parameter value when no source supports it; if the regulatory document does not specify a threshold (e.g., an initial FPL limit distinct from the ongoing limit), do not fabricate one — either use the documented value for both paths or flag the gap as unverifiable. A fabricated value that looks plausible (e.g., 150% vs 185%) passes casual review and is harder to catch than a missing value.
+- When a parameter represents a soft administrative guideline rather than a hard regulatory cutoff (e.g., "adults are defined as 18+" used as a general definition, not a strict eligibility bar), document this distinction in the parameter description; do not model it as a strict eligibility gate unless the regulation explicitly mandates denial for failing the criterion.

policyengine_us/parameters/gov/hhs/ccdf/child_care_subsidy_programs.yaml

@@ -11,6 +11,7 @@ values:
     - nh_child_care_subsidies  # New Hampshire Child Care Scholarship Program
     - pa_child_care_subsidies  # Pennsylvania Child Care Works
     - ri_child_care_subsidies  # Rhode Island Child Care Assistance Program
+    - wv_child_care_subsidies  # West Virginia Child Care Assistance Program
 
 metadata:
   unit: list

policyengine_us/parameters/gov/states/wv/dhhr/ccap/age_group/informal_months.yaml

@@ -0,0 +1,23 @@
+description: West Virginia defines these informal care age group boundaries in months under the Child Care Assistance Program.
+metadata:
+  type: single_amount
+  threshold_unit: month
+  amount_unit: /1
+  period: year
+  label: West Virginia CCAP informal care age group by months
+  reference:
+    - title: WV Child Care Subsidy Appendix B — Rate Structure (Oct 1, 2024)
+      href: https://bfa.wv.gov/media/6831/download?inline
+
+# Maps age in months to WVCCAPInformalAgeGroup enum index:
+# 0 = UNDER_2 (0-23 months)
+# 1 = AGE_2_AND_OVER (24+ months)
+brackets:
+  - threshold:
+      2024-01-01: 0
+    amount:
+      2024-01-01: 0
+  - threshold:
+      2024-01-01: 24
+    amount:
+      2024-01-01: 1

policyengine_us/parameters/gov/states/wv/dhhr/ccap/age_group/months.yaml

@@ -0,0 +1,33 @@
+description: West Virginia defines these child age group boundaries in months under the Child Care Assistance Program.
+metadata:
+  type: single_amount
+  threshold_unit: month
+  amount_unit: /1
+  period: year
+  label: West Virginia CCAP child age group by months
+  reference:
+    - title: WV Child Care Subsidy Appendix B — Rate Structure (Oct 1, 2024)
+      href: https://bfa.wv.gov/media/6831/download?inline
+
+# Maps age in months to WVCCAPChildAgeCategory enum index:
+# 0 = INFANT (0-24 months)
+# 1 = TODDLER (25-36 months)
+# 2 = PRESCHOOL (37-59 months)
+# 3 = SCHOOL_AGE (60+ months)
+brackets:
+  - threshold:
+      2024-01-01: 0
+    amount:
+      2024-01-01: 0
+  - threshold:
+      2024-01-01: 25
+    amount:
+      2024-01-01: 1
+  - threshold:
+      2024-01-01: 37
+    amount:
+      2024-01-01: 2
+  - threshold:
+      2024-01-01: 60
+    amount:
+      2024-01-01: 3

policyengine_us/parameters/gov/states/wv/dhhr/ccap/copayment/max_share.yaml

@@ -0,0 +1,11 @@
+description: West Virginia limits the co-payment to this share of gross family income under the Child Care Assistance Program.
+values:
+  2024-01-01: 0.07
+
+metadata:
+  unit: /1
+  period: year
+  label: West Virginia CCAP maximum co-payment share
+  reference:
+    - title: WV CCDF State Plan FFY 2025-2027, Section 3.1.1 — Family Co-payment (7%)
+      href: https://bfa.wv.gov/media/39915/download?inline#page=39

policyengine_us/parameters/gov/states/wv/dhhr/ccap/copayment/rate.yaml

@@ -0,0 +1,39 @@
+description: West Virginia sets this co-payment share of income by federal poverty level ratio under the Child Care Assistance Program.
+metadata:
+  type: single_amount
+  threshold_unit: /1
+  amount_unit: /1
+  period: year
+  label: West Virginia CCAP co-payment rate by FPL ratio
+  reference:
+    - title: WV Child Care Subsidy Appendix A — Sliding Fee Scale (Oct 1, 2024)
+      href: https://bfa.wv.gov/media/6826/download?inline
+    - title: WV CCDF State Plan FFY 2025-2027, Section 3.1.2 — Sliding Fee Scale
+      href: https://bfa.wv.gov/media/39915/download?inline#page=39
+
+# Simplified percentage approximation of the 176-cell sliding fee scale.
+# Derived from the 3-person family column in Appendix A as a representative
+# middle case. Actual daily dollar fees vary by family size; this percentage
+# approximation produces reasonable copay amounts across family sizes.
+# The 7% cap (max_share parameter) provides an upper bound per CCDF rules.
+brackets:
+  - threshold:
+      2024-10-01: 0
+    amount:
+      2024-10-01: 0
+  - threshold:
+      2024-10-01: 0.4001
+    amount:
+      2024-10-01: 0.025
+  - threshold:
+      2024-10-01: 0.7001
+    amount:
+      2024-10-01: 0.03
+  - threshold:
+      2024-10-01: 1.1001
+    amount:
+      2024-10-01: 0.035
+  - threshold:
+      2024-10-01: 1.5001
+    amount:
+      2024-10-01: 0.04

policyengine_us/parameters/gov/states/wv/dhhr/ccap/eligibility/activity_hours.yaml

@@ -0,0 +1,11 @@
+description: West Virginia sets this minimum weekly activity hours for parent eligibility under the Child Care Assistance Program.
+values:
+  2024-01-01: 20
+
+metadata:
+  unit: hour
+  period: week
+  label: West Virginia CCAP minimum weekly activity hours
+  reference:
+    - title: WV Child Care Subsidy Policy & Procedures Manual, Chapter 3, Section 3.6.1 — Working Recipients
+      href: https://bfa.wv.gov/media/6766/download?inline#page=32

policyengine_us/parameters/gov/states/wv/dhhr/ccap/eligibility/child_age_limit.yaml

@@ -0,0 +1,13 @@
+description: West Virginia limits child eligibility to under this age under the Child Care Assistance Program.
+values:
+  2024-01-01: 13
+
+metadata:
+  unit: year
+  period: year
+  label: West Virginia CCAP child age limit
+  reference:
+    - title: WV Child Care Subsidy Policy & Procedures Manual, Chapter 3, Section 3.1 — Child Age Requirement
+      href: https://bfa.wv.gov/media/6766/download?inline#page=25
+    - title: WV CCDF State Plan FFY 2025-2027, Section 2.2
+      href: https://bfa.wv.gov/media/39915/download?inline#page=16

policyengine_us/parameters/gov/states/wv/dhhr/ccap/eligibility/min_parent_age.yaml

@@ -0,0 +1,11 @@
+description: West Virginia sets this minimum parent age under the Child Care Assistance Program.
+values:
+  2024-01-01: 18
+
+metadata:
+  unit: year
+  period: year
+  label: West Virginia CCAP minimum parent age
+  reference:
+    - title: WV Child Care Subsidy Policy & Procedures Manual, Chapter 1, Section 1.1.2 — Adult Definition
+      href: https://bfa.wv.gov/media/6766/download?inline#page=8

policyengine_us/parameters/gov/states/wv/dhhr/ccap/eligibility/special_needs_child_age_limit.yaml

@@ -0,0 +1,13 @@
+description: West Virginia limits special needs child eligibility to under this age under the Child Care Assistance Program.
+values:
+  2024-01-01: 18
+
+metadata:
+  unit: year
+  period: year
+  label: West Virginia CCAP special needs child age limit
+  reference:
+    - title: WV Child Care Subsidy Policy & Procedures Manual, Chapter 3, Section 3.1.2 — Special Needs Children
+      href: https://bfa.wv.gov/media/6766/download?inline#page=25
+    - title: WV CCDF State Plan FFY 2025-2027, Section 2.2
+      href: https://bfa.wv.gov/media/39915/download?inline#page=16

policyengine_us/parameters/gov/states/wv/dhhr/ccap/income/countable_income/sources.yaml

@@ -0,0 +1,25 @@
+description: West Virginia counts these income sources under the Child Care Assistance Program.
+values:
+  2024-01-01:
+    - employment_income
+    - self_employment_income
+    - social_security
+    - ssi
+    - unemployment_compensation
+    - workers_compensation
+    - pension_income
+    - alimony_income
+    - child_support_received
+    - dividend_income
+    - interest_income
+    - rental_income
+    - veterans_benefits
+    - military_retirement_pay
+
+metadata:
+  unit: list
+  period: year
+  label: West Virginia CCAP countable income sources
+  reference:
+    - title: WV Child Care Subsidy Policy & Procedures Manual, Chapter 5, Sections 5.2.1-5.2.4 — Countable Income
+      href: https://bfa.wv.gov/media/6766/download?inline#page=49

policyengine_us/parameters/gov/states/wv/dhhr/ccap/income/fpl_limit/initial.yaml

@@ -0,0 +1,13 @@
+description: West Virginia limits initial applicant income to this share of the federal poverty level under the Child Care Assistance Program.
+values:
+  2019-10-01: 1.5
+
+metadata:
+  unit: /1
+  period: year
+  label: West Virginia CCAP initial FPL limit
+  reference:
+    - title: WV Child Care Subsidy Policy & Procedures Manual, Chapter 5, Section 5.0 — Overview
+      href: https://bfa.wv.gov/media/6766/download?inline#page=49
+    - title: WV Child Care Subsidy Appendix A — Sliding Fee Scale (Oct 1, 2024)
+      href: https://bfa.wv.gov/media/6826/download?inline

policyengine_us/parameters/gov/states/wv/dhhr/ccap/income/fpl_limit/ongoing.yaml

@@ -0,0 +1,13 @@
+description: West Virginia limits ongoing recipient income to this share of the federal poverty level under the Child Care Assistance Program.
+values:
+  2019-10-01: 1.85
+
+metadata:
+  unit: /1
+  period: year
+  label: West Virginia CCAP ongoing FPL limit
+  reference:
+    - title: WV Child Care Subsidy Policy & Procedures Manual, Chapter 5, Section 5.0 — Overview
+      href: https://bfa.wv.gov/media/6766/download?inline#page=49
+    - title: WV CCDF State Plan FFY 2025-2027, Section 2.2.3
+      href: https://bfa.wv.gov/media/39915/download?inline#page=20

policyengine_us/parameters/gov/states/wv/dhhr/ccap/income/smi_rate.yaml

@@ -0,0 +1,13 @@
+description: West Virginia limits income to this share of the state median income under the Child Care Assistance Program.
+values:
+  2024-01-01: 0.85
+
+metadata:
+  unit: /1
+  period: year
+  label: West Virginia CCAP SMI rate
+  reference:
+    - title: WV CCDF State Plan FFY 2025-2027, Section 2.2.4
+      href: https://bfa.wv.gov/media/39915/download?inline#page=20
+    - title: WV 2024 State Median Income Chart
+      href: https://bfa.wv.gov/media/6781/download?inline

policyengine_us/parameters/gov/states/wv/dhhr/ccap/rates/center.yaml

@@ -0,0 +1,39 @@
+description: West Virginia provides these daily reimbursement rates for child care centers under the Child Care Assistance Program.
+metadata:
+  period: day
+  unit: currency-USD
+  label: West Virginia CCAP child care center daily rates
+  breakdown:
+    - wv_ccap_quality_tier
+    - wv_ccap_child_age_category
+  reference:
+    - title: WV Child Care Subsidy Appendix B — Rate Structure (Oct 1, 2024)
+      href: https://bfa.wv.gov/media/6831/download?inline
+
+TIER_I:
+  INFANT:
+    2024-10-01: 39
+  TODDLER:
+    2024-10-01: 37
+  PRESCHOOL:
+    2024-10-01: 35
+  SCHOOL_AGE:
+    2024-10-01: 32
+TIER_II:
+  INFANT:
+    2024-10-01: 42
+  TODDLER:
+    2024-10-01: 40
+  PRESCHOOL:
+    2024-10-01: 38
+  SCHOOL_AGE:
+    2024-10-01: 35
+TIER_III:
+  INFANT:
+    2024-10-01: 45
+  TODDLER:
+    2024-10-01: 43
+  PRESCHOOL:
+    2024-10-01: 41
+  SCHOOL_AGE:
+    2024-10-01: 39

policyengine_us/parameters/gov/states/wv/dhhr/ccap/rates/family_facility.yaml

@@ -0,0 +1,39 @@
+description: West Virginia provides these daily reimbursement rates for family child care facilities under the Child Care Assistance Program.
+metadata:
+  period: day
+  unit: currency-USD
+  label: West Virginia CCAP family child care facility daily rates
+  breakdown:
+    - wv_ccap_quality_tier
+    - wv_ccap_child_age_category
+  reference:
+    - title: WV Child Care Subsidy Appendix B — Rate Structure (Oct 1, 2024)
+      href: https://bfa.wv.gov/media/6831/download?inline
+
+TIER_I:
+  INFANT:
+    2024-10-01: 35
+  TODDLER:
+    2024-10-01: 33
+  PRESCHOOL:
+    2024-10-01: 33
+  SCHOOL_AGE:
+    2024-10-01: 32
+TIER_II:
+  INFANT:
+    2024-10-01: 38
+  TODDLER:
+    2024-10-01: 36
+  PRESCHOOL:
+    2024-10-01: 36
+  SCHOOL_AGE:
+    2024-10-01: 35
+TIER_III:
+  INFANT:
+    2024-10-01: 41
+  TODDLER:
+    2024-10-01: 39
+  PRESCHOOL:
+    2024-10-01: 39
+  SCHOOL_AGE:
+    2024-10-01: 38

policyengine_us/parameters/gov/states/wv/dhhr/ccap/rates/family_home.yaml

@@ -0,0 +1,39 @@
+description: West Virginia provides these daily reimbursement rates for family child care homes under the Child Care Assistance Program.
+metadata:
+  period: day
+  unit: currency-USD
+  label: West Virginia CCAP family child care home daily rates
+  breakdown:
+    - wv_ccap_quality_tier
+    - wv_ccap_child_age_category
+  reference:
+    - title: WV Child Care Subsidy Appendix B — Rate Structure (Oct 1, 2024)
+      href: https://bfa.wv.gov/media/6831/download?inline
+
+TIER_I:
+  INFANT:
+    2024-10-01: 30
+  TODDLER:
+    2024-10-01: 30
+  PRESCHOOL:
+    2024-10-01: 29
+  SCHOOL_AGE:
+    2024-10-01: 26
+TIER_II:
+  INFANT:
+    2024-10-01: 33
+  TODDLER:
+    2024-10-01: 33
+  PRESCHOOL:
+    2024-10-01: 32
+  SCHOOL_AGE:
+    2024-10-01: 29
+TIER_III:
+  INFANT:
+    2024-10-01: 36
+  TODDLER:
+    2024-10-01: 36
+  PRESCHOOL:
+    2024-10-01: 35
+  SCHOOL_AGE:
+    2024-10-01: 32

policyengine_us/parameters/gov/states/wv/dhhr/ccap/rates/informal_relative.yaml

@@ -0,0 +1,15 @@
+description: West Virginia provides these daily reimbursement rates for informal or relative care under the Child Care Assistance Program.
+metadata:
+  period: day
+  unit: currency-USD
+  label: West Virginia CCAP informal relative care daily rates
+  breakdown:
+    - wv_ccap_informal_age_group
+  reference:
+    - title: WV Child Care Subsidy Appendix B — Rate Structure (Oct 1, 2024)
+      href: https://bfa.wv.gov/media/6831/download?inline
+
+UNDER_2:
+  2024-10-01: 7.5
+AGE_2_AND_OVER:
+  2024-10-01: 6

policyengine_us/parameters/gov/states/wv/dhhr/ccap/rates/out_of_school_time.yaml

@@ -0,0 +1,11 @@
+description: West Virginia provides this daily reimbursement rate for out of school time programs under the Child Care Assistance Program.
+values:
+  2024-10-01: 14.5
+
+metadata:
+  period: day
+  unit: currency-USD
+  label: West Virginia CCAP out of school time daily rate
+  reference:
+    - title: WV Child Care Subsidy Appendix B — Rate Structure (Oct 1, 2024)
+      href: https://bfa.wv.gov/media/6831/download?inline