Implement Rhode Island CCAP

changelog.d/ri-ccap.added.md

@@ -0,0 +1 @@
+Add Rhode Island Child Care Assistance Program (CCAP).

lessons/agent-lessons.md

@@ -0,0 +1,16 @@
+# 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 Rhode Island CCAP (2026-03-09)
+
+### PARAMETER
+- When a regulation references a composite benefit acronym (e.g., "RSDI" = Retirement + Survivors + Disability Insurance), enumerate and include ALL component income types in the sources list; do not map the acronym to only its most common component.
+- **Rules as code**: Parameter values MUST match the legal text exactly. If the law says "up through eighteen (18)", the parameter value is 18 — never adjust it to 19 to compensate for a wrong comparison operator. Fix the formula operator (`<=` vs `<`) instead. Parameters store what the law says; formulas encode the logic.
+
+### TEST
+- When tests were written to match a buggy parameter or formula, fixing the root cause requires a sweep of ALL test files that reference the affected variable; stale expected outputs silently mask regressions.
+
+### FORMULA
+- When a review finding identifies a boundary operator mismatch (strict `<` vs inclusive `<=`) against regulation text, resolve it before approving; boundary bugs affect exactly one threshold-value row and are invisible in typical test cases that avoid exact boundaries.

policyengine_us/parameters/gov/states/ri/dhs/ccap/age_group/center/infant_max.yaml

@@ -0,0 +1,11 @@
+description: Rhode Island defines the licensed center infant age group as children younger than this age under the Child Care Assistance Program.
+values:
+  2025-07-01: 2
+
+metadata:
+  unit: year
+  period: year
+  label: Rhode Island CCAP licensed center infant age maximum
+  reference:
+    - title: RI DHS CCAP Licensed Center Child Care Weekly Rates, Effective July 1, 2025
+      href: https://dhs.ri.gov/media/9356/download?language=en

policyengine_us/parameters/gov/states/ri/dhs/ccap/age_group/center/toddler_max.yaml

@@ -0,0 +1,11 @@
+description: Rhode Island defines the licensed center toddler age group as children younger than this age under the Child Care Assistance Program.
+values:
+  2025-07-01: 3
+
+metadata:
+  unit: year
+  period: year
+  label: Rhode Island CCAP licensed center toddler age maximum
+  reference:
+    - title: RI DHS CCAP Licensed Center Child Care Weekly Rates, Effective July 1, 2025
+      href: https://dhs.ri.gov/media/9356/download?language=en

policyengine_us/parameters/gov/states/ri/dhs/ccap/age_group/family/infant_toddler_max.yaml

@@ -0,0 +1,13 @@
+description: Rhode Island defines the licensed family and exempt infant/toddler age group as children younger than this age under the Child Care Assistance Program.
+values:
+  2024-07-01: 3
+
+metadata:
+  unit: year
+  period: year
+  label: Rhode Island CCAP licensed family infant/toddler age maximum
+  reference:
+    - title: RI DHS CCAP Licensed Family Child Care Weekly Rates, Effective July 1, 2024
+      href: https://dhs.ri.gov/media/7481/download?language=en
+    - title: RI DHS CCAP Licensed Exempt Child Care Weekly Rates, Effective January 1, 2022
+      href: https://dhs.ri.gov/media/3556/download?language=en

policyengine_us/parameters/gov/states/ri/dhs/ccap/age_threshold/child.yaml

@@ -0,0 +1,11 @@
+description: Rhode Island limits the Child Care Assistance Program to children younger than this age.
+values:
+  2020-01-01: 13
+
+metadata:
+  unit: year
+  period: year
+  label: Rhode Island CCAP child age threshold
+  reference:
+    - title: 218-RICR-20-00-4, Section 4.3.1.A.1
+      href: https://rules.sos.ri.gov/regulations/part/218-20-00-4#4.3.1

policyengine_us/parameters/gov/states/ri/dhs/ccap/age_threshold/disabled_child.yaml

@@ -0,0 +1,11 @@
+description: Rhode Island limits the Child Care Assistance Program to disabled children up through this age.
+values:
+  2020-01-01: 18
+
+metadata:
+  unit: year
+  period: year
+  label: Rhode Island CCAP disabled child age threshold
+  reference:
+    - title: 218-RICR-20-00-4, Section 4.3.1.A.1
+      href: https://rules.sos.ri.gov/regulations/part/218-20-00-4#4.3.1

policyengine_us/parameters/gov/states/ri/dhs/ccap/assets/limit.yaml

@@ -0,0 +1,11 @@
+description: Rhode Island limits assets to this amount under the Child Care Assistance Program.
+values:
+  2020-01-01: 1_000_000
+
+metadata:
+  unit: currency-USD
+  period: year
+  label: Rhode Island CCAP asset limit
+  reference:
+    - title: 218-RICR-20-00-4, Section 4.6.1.B
+      href: https://rules.sos.ri.gov/regulations/part/218-20-00-4#4.6.1

policyengine_us/parameters/gov/states/ri/dhs/ccap/assets/sources.yaml

@@ -0,0 +1,18 @@
+description: Rhode Island counts these asset sources under the Child Care Assistance Program.
+values:
+  2020-01-01:
+    - spm_unit_cash_assets
+    # Assets include vehicles (excl. primary), real estate (excl. primary
+    # residence), cash, bank accounts, investments.
+    # Assets exclude educational savings, retirement accounts, joint
+    # accounts with non-household adults.
+    # assessed_property_value is person-level; not included because
+    # it includes primary residence which is excluded.
+
+metadata:
+  unit: list
+  period: year
+  label: Rhode Island CCAP asset sources
+  reference:
+    - title: 218-RICR-20-00-4, Section 4.6.1.B
+      href: https://rules.sos.ri.gov/regulations/part/218-20-00-4#4.6.1

policyengine_us/parameters/gov/states/ri/dhs/ccap/copay/rate.yaml

@@ -0,0 +1,30 @@
+description: Rhode Island sets this co-share percentage of gross income under the Child Care Assistance Program.
+metadata:
+  type: single_amount
+  threshold_unit: /1
+  amount_unit: /1
+  period: year
+  label: Rhode Island CCAP co-share rate by FPL ratio
+  reference:
+    - title: 218-RICR-20-00-4, Section 4.6.1.C
+      href: https://rules.sos.ri.gov/regulations/part/218-20-00-4#4.6.1
+    - title: RI DHS CCAP Co-Pay Chart effective 02/15/2026
+      href: https://dhs.ri.gov/media/10606/download?language=en
+
+brackets:
+  - threshold:
+      2020-01-01: 0
+    amount:
+      2020-01-01: 0
+  - threshold:
+      2020-01-01: 1.0001
+    amount:
+      2020-01-01: 0.02
+  - threshold:
+      2020-01-01: 1.2501
+    amount:
+      2020-01-01: 0.05
+  - threshold:
+      2020-01-01: 1.5001
+    amount:
+      2020-01-01: 0.07

policyengine_us/parameters/gov/states/ri/dhs/ccap/income/countable_income/sources.yaml

@@ -0,0 +1,40 @@
+description: Rhode Island counts these income sources under the Child Care Assistance Program.
+values:
+  2020-01-01:
+    - employment_income
+    - self_employment_income
+    - social_security_retirement
+    - social_security_disability
+    - social_security_survivors
+    - ssi
+    - dividend_income
+    - interest_income
+    - rental_income
+    - pension_income
+    - veterans_benefits
+    - military_retirement_pay
+    - unemployment_compensation
+    - workers_compensation
+    - alimony_income
+    - child_support_received
+    # The following are counted per 218-RICR-20-00-4, Section 4.2,
+    # Definition 30 (Income) but have no matching variables:
+    # - adoption_subsidy
+    # - strike_benefits
+    # - royalties
+    # - temporary_disability_insurance
+    # - in-kind assistance
+    # - non-citizen sponsor income
+    # - room and board income
+    # - cash payouts for waiving health insurance
+    # - foster care payments when child in unit
+    # - VA educational benefits (separate from veterans_benefits)
+    # - Americorps payments (non-VISTA)
+
+metadata:
+  unit: list
+  period: year
+  label: Rhode Island CCAP countable income sources
+  reference:
+    - title: 218-RICR-20-00-4, Section 4.2, Definition 30 (Income)
+      href: https://rules.sos.ri.gov/regulations/part/218-20-00-4#4.2

policyengine_us/parameters/gov/states/ri/dhs/ccap/income/fpl_rate/initial_eligibility.yaml

@@ -0,0 +1,11 @@
+description: Rhode Island limits the Child Care Assistance Program to new applicants with income at or below this share of the federal poverty level.
+values:
+  2020-01-01: 2.61
+
+metadata:
+  unit: /1
+  period: year
+  label: Rhode Island CCAP initial eligibility FPL rate
+  reference:
+    - title: 218-RICR-20-00-4, Section 4.6.1.A
+      href: https://rules.sos.ri.gov/regulations/part/218-20-00-4#4.6.1

policyengine_us/parameters/gov/states/ri/dhs/ccap/income/fpl_rate/transitional.yaml

@@ -0,0 +1,11 @@
+description: Rhode Island limits the Child Care Assistance Program to enrolled families with income at or below this share of the federal poverty level.
+values:
+  2020-01-01: 3
+
+metadata:
+  unit: /1
+  period: year
+  label: Rhode Island CCAP transitional eligibility FPL rate
+  reference:
+    - title: 218-RICR-20-00-4, Section 4.6.1.A.1
+      href: https://rules.sos.ri.gov/regulations/part/218-20-00-4#4.6.1

policyengine_us/parameters/gov/states/ri/dhs/ccap/qualified_immigration_statuses.yaml

@@ -0,0 +1,19 @@
+description: Rhode Island limits the Child Care Assistance Program to children of these immigration statuses.
+values:
+  2020-01-01:
+    - CITIZEN
+    - LEGAL_PERMANENT_RESIDENT
+    - REFUGEE
+    - ASYLEE
+    - DEPORTATION_WITHHELD
+    - CUBAN_HAITIAN_ENTRANT
+    - CONDITIONAL_ENTRANT
+    - PAROLED_ONE_YEAR
+
+metadata:
+  unit: list
+  period: year
+  label: Rhode Island CCAP qualified immigration statuses
+  reference:
+    - title: 218-RICR-20-00-4, Section 4.3.1.A.4
+      href: https://rules.sos.ri.gov/regulations/part/218-20-00-4#4.3.1