Encode HI CCAP copay regime change: tier applies to gross income from August 2021

changelog.d/hi-ccap-copay-income-base.fixed.md

@@ -0,0 +1 @@
+Hawaii CCAP co-payments follow HAR 17-798.3-14 beginning August 2021, applying the sliding-scale tier to the family's monthly gross income; the prior HAR 17-798.2-14(b)(4) provider-rate method is preserved for earlier periods.

policyengine_us/parameters/gov/states/hi/bessd/ccap/copay/income_based_in_effect.yaml

@@ -0,0 +1,24 @@
+description: Hawaii computes the Child Care Subsidy co-payment as a percentage of the family's monthly gross income when this is in effect, and as a percentage of the department's maximum rate allowable otherwise.
+
+values:
+  2020-01-01: false
+  2021-08-06: true
+
+metadata:
+  unit: bool
+  period: year
+  label: Hawaii CCAP income-based co-payment in effect
+  reference:
+    # HAR chapter 17-798.3 (effective August 6, 2021) replaced the
+    # payment provisions of chapter 17-798.2; its section -14 multiplies
+    # the co-payment tier by the family unit's monthly gross income,
+    # where the superseded 17-798.2-14(b)(4) multiplied it by the
+    # department's maximum rate allowable. Monthly formulas read this
+    # parameter as of the first day of the month, so the model applies
+    # the income-based method from September 2021 onward; August 2021,
+    # which straddles the effective date, still uses the maximum-rate
+    # method.
+    - title: HAR 17-798.3-14, co-payment tier multiplied by the family unit's monthly gross income (eff. 2021-08-06)
+      href: https://humanservices.hawaii.gov/bessd/files/2021/09/CHAPTER-17-798.3-Child-Care-Payments.pdf#page=35
+    - title: HAR 17-798.2-14(b)(4), co-payment tier multiplied by the department's maximum rate allowable (superseded)
+      href: https://humanservices.hawaii.gov/bessd/files/2013/01/HAR-17-798.2-Child-Care-Services-Rules.pdf#page=29

policyengine_us/parameters/gov/states/hi/bessd/ccap/copay/rate.yaml

@@ -1,4 +1,4 @@
-description: Hawaii sets this co-payment percentage of the department's maximum rate allowable under the Child Care Subsidy program, by the family's gross income as a share of the federal poverty guidelines.
+description: Hawaii sets this co-payment percentage under the Child Care Subsidy program, by the family's gross income as a share of the federal poverty guidelines.
 
 metadata:
   type: single_amount
@@ -7,18 +7,18 @@ metadata:
   period: year
   label: Hawaii CCAP co-payment rate by FPG ratio
   reference:
-    # HAR 17-798.2-14(b)(4): co-payment = (percentage of the department's
-    # maximum rate allowable) based on the family's monthly gross income.
-    # The rule's attached scale is "Exhibit III (dated Oct 1, 2009)", which has
-    # been superseded by the 2020 sliding-fee scale below; the implemented
-    # 0-9% percentages come from that 2020 scale, the operative source.
-    - title: HAR 17-798.2-14(b)(4)
-      href: https://humanservices.hawaii.gov/bessd/files/2013/01/HAR-17-798.2-Child-Care-Services-Rules.pdf#page=29
-    # Operative sliding fee scale (single-page scanned chart, eff 2020-01-02)
-    # mapping each FPG band to its co-payment percentage. The standalone PDF
-    # labels itself "Exhibit II" in its own footer, which is its internal
-    # numbering and differs from the HAR's exhibit numbering (Exhibit III).
-    - title: Hawaii DHS Child Care Gross Income Eligibility Limits and Sliding Fee Scale (PDF "Exhibit II"), effective 2020-01-02
+    # HAR 17-798.3-14(3) (eff. 2021-08-06, page 35 of the chapter PDF)
+    # determines the co-payment tier from Exhibit II, dated January 2,
+    # 2020, attached at the end of the chapter; step (4) multiplies the
+    # tier by the family unit's monthly gross income. The percentages
+    # below are the Exhibit II column headings. The superseded
+    # 17-798.2-14(b)(4) used the same tier scale but multiplied it by the
+    # department's maximum rate allowable (see income_based_in_effect.yaml).
+    - title: HAR 17-798.3, Exhibit II Child Care Gross Income Eligibility Limits and Sliding Fee Scale (dated January 2, 2020), applied under 17-798.3-14(3) (tier selection; the multiply is step (4))
+      href: https://humanservices.hawaii.gov/bessd/files/2021/09/CHAPTER-17-798.3-Child-Care-Payments.pdf#page=73
+    # The same Exhibit II scale as a standalone scanned chart (eff
+    # 2020-01-02), mapping each FPG band to its co-payment percentage.
+    - title: Hawaii DHS Child Care Gross Income Eligibility Limits and Sliding Fee Scale (Exhibit II), effective 2020-01-02
       href: https://childcaresubsidyapplication.dhs.hawaii.gov/Child-Care-Gross-Income-Eligibility-Limits-and-Sliding-Fee-Scale
 
 # Bands are "above X%" boundaries (e.g., 101-115% means above 100% up to

policyengine_us/parameters/gov/states/hi/bessd/ccap/income/countable_income/sources.yaml

@@ -48,6 +48,12 @@ metadata:
   period: year
   label: Hawaii CCAP countable income sources
   reference:
+    # Chapter 17-798.3 (eff. 2021-08-06) carries the same source list in
+    # 17-798.3-10(b) and the same exclusions in 17-798.3-11 (page 29);
+    # "gross income" is defined in 17-798.3-2 as all non-excluded earned
+    # and unearned income.
+    - title: HAR 17-798.3-10(b) and 17-798.3-11
+      href: https://humanservices.hawaii.gov/bessd/files/2021/09/CHAPTER-17-798.3-Child-Care-Payments.pdf#page=24
     - title: HAR 17-798.2-10(b)
       href: https://humanservices.hawaii.gov/bessd/files/2013/01/HAR-17-798.2-Child-Care-Services-Rules.pdf#page=19
     - title: HAR 17-798.2-11

policyengine_us/tests/policy/baseline/gov/states/hi/bessd/ccap/copay/hi_ccap_copay.yaml

@@ -1,12 +1,11 @@
-# HI CCAP family co-payment (HAR 17-798.2-14(b)(4)).
-# Co-payment = (department's maximum rate allowable) x (co-pay percentage).
-# The percentage multiplies the PROVIDER MAX RATE, not gross income. This is
-# the HI-specific difference from income-times-percent designs.
+# HI CCAP family co-payment (HAR 17-798.3-14, eff. 2021-08-06).
+# Co-payment = (co-payment tier from Exhibit II) x (monthly gross income
+# for the family unit), assessed once per family unit.
 #
 # Family of 2, HI 2025 (FPG family of 2 = 24,320/year = 2,026.67/month).
 # Children are full-time (childcare_hours_per_week 30 -> ~130 monthly hours).
 
-- name: Case 1, worked example 740 rate times 9 percent.
+- name: Case 1, worked example gross income times 9 percent.
   period: 2025-01
   absolute_error_margin: 0.01
   input:
@@ -31,11 +30,11 @@
         members: [person1, person2]
         state_code: HI
   output:
-    # Max rate (licensed center or group home, full-time) = 795; copay rate 9%
-    # copay = 795 x 0.09 = 71.55
-    hi_ccap_copay: 71.55
+    # Monthly gross income = 56,000 / 12 = 4,666.67; copay tier 9%
+    # copay = 4,666.67 x 0.09 = 420.00
+    hi_ccap_copay: 420
 
-- name: Case 2, infant/toddler rate 1733 times 5 percent.
+- name: Case 2, gross income times 5 percent.
   period: 2025-01
   absolute_error_margin: 0.01
   input:
@@ -60,9 +59,9 @@
         members: [person1, person2]
         state_code: HI
   output:
-    # Max rate (licensed center infant/toddler, full-time) = 1,733; copay rate 5%
-    # copay = 1,733 x 0.05 = 86.65
-    hi_ccap_copay: 86.65
+    # Monthly gross income = 40,800 / 12 = 3,400; copay tier 5%
+    # copay = 3,400 x 0.05 = 170.00 (the provider rate does not enter)
+    hi_ccap_copay: 170
 
 - name: Case 3, zero copay percent gives zero copay.
   period: 2025-01
@@ -89,5 +88,214 @@
         members: [person1, person2]
         state_code: HI
   output:
-    # 795 x 0.00 = 0
+    # 1,000 x 0.00 = 0
     hi_ccap_copay: 0
+
+# The FFY2025-2027 CCDF plan (section 3.1.2) shows a family unit of 1 at
+# monthly income 3,632 paying a 327 co-payment: ratio far above 230% FPG
+# -> 9% tier, and 3,632 x 0.09 = 326.88, which rounds to the plan's 327.
+- name: Case 4, CCDF plan worked example, family of 1 at 3632 per month.
+  period: 2025-01
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 25
+        employment_income: 43_584  # 3,632/mo
+        immigration_status: CITIZEN
+    tax_units:
+      tax_unit:
+        members: [person1]
+    spm_units:
+      spm_unit:
+        members: [person1]
+    households:
+      household:
+        members: [person1]
+        state_code: HI
+  output:
+    hi_ccap_copay_rate: 0.09
+    hi_ccap_copay: 326.88
+
+# === Effective-date boundary: HAR 17-798.3 replaced 17-798.2's payment
+# provisions on August 6, 2021. Before then the co-payment was the tier
+# percentage of the department's maximum rate allowable, per child
+# (17-798.2-14(b)(4)); since then it is the tier percentage of monthly
+# gross income, per family unit (17-798.3-14). ===
+
+- name: Case 5, before August 2021 the tier applies to the provider maximum rate.
+  period: 2021-01
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 30
+        employment_income: 56_000  # 4,666.67/mo, far above 230% FPG -> 9%
+        immigration_status: CITIZEN
+      person2:
+        age: 4
+        immigration_status: CITIZEN
+        childcare_hours_per_week: 30
+        hi_ccap_provider_category: LICENSED_CENTER_OR_GROUP_HOME
+    tax_units:
+      tax_unit:
+        members: [person1, person2]
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+    households:
+      household:
+        members: [person1, person2]
+        state_code: HI
+  output:
+    # Max rate (licensed center or group home, full-time) = 795
+    # copay = 795 x 0.09 = 71.55
+    hi_ccap_copay: 71.55
+
+- name: Case 6, from the 2021 rule change the tier applies to gross income.
+  period: 2022-01
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 30
+        employment_income: 56_000  # 4,666.67/mo, far above 230% FPG -> 9%
+        immigration_status: CITIZEN
+      person2:
+        age: 4
+        immigration_status: CITIZEN
+        childcare_hours_per_week: 30
+        hi_ccap_provider_category: LICENSED_CENTER_OR_GROUP_HOME
+    tax_units:
+      tax_unit:
+        members: [person1, person2]
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+    households:
+      household:
+        members: [person1, person2]
+        state_code: HI
+  output:
+    # copay = 4,666.67 x 0.09 = 420.00 (same household as Case 5)
+    hi_ccap_copay: 420
+
+# The August 6, 2021 effective date falls mid-month. Monthly formulas read
+# income_based_in_effect as of the first day of the month, so August 2021
+# is the last month on the maximum-rate method and September 2021 the
+# first on the gross-income method. HI 2021 FPG family of 2 =
+# 20,040/year = 1,670/month, so 4,666.67 is 2.79 x FPG -> 9% tier.
+
+- name: Case 7, August 2021 still uses the maximum-rate method and September 2021 is the first month on the gross-income method.
+  period: 2021
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 30
+        employment_income: 56_000  # 4,666.67/mo, FPG ratio 2.79 -> 9%
+        immigration_status: CITIZEN
+      person2:
+        age: 4
+        immigration_status: CITIZEN
+        childcare_hours_per_week: 30
+        hi_ccap_provider_category: LICENSED_CENTER_OR_GROUP_HOME
+    tax_units:
+      tax_unit:
+        members: [person1, person2]
+    spm_units:
+      spm_unit:
+        members: [person1, person2]
+    households:
+      household:
+        members: [person1, person2]
+        state_code: HI
+  output:
+    # The toggle is still false on August 1, 2021 and true on September 1:
+    # August copay = 795 (max rate) x 0.09 = 71.55
+    # September copay = 4,666.67 (gross income) x 0.09 = 420.00
+    hi_ccap_copay_rate:
+      2021-08: 0.09
+      2021-09: 0.09
+    hi_ccap_copay:
+      2021-08: 71.55
+      2021-09: 420
+
+# Two children in care: the old method summed each child's maximum rate
+# before applying the tier; the new method charges the tier on the family's
+# income once, regardless of how many children are in care. Family of 3,
+# 66,000/year = 5,500/month. HI FPG family of 3: 2021 = 25,260/year =
+# 2,105/month (ratio 2.61); 2022 = 26,490/year = 2,207.50/month
+# (ratio 2.49). Both years land in the 9% tier.
+
+- name: Case 8, before August 2021 two children sum their maximum rates.
+  period: 2021-01
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 30
+        employment_income: 66_000  # 5,500/mo, FPG ratio 2.61 -> 9%
+        immigration_status: CITIZEN
+      person2:
+        age: 1  # < 36 months -> INFANT_TODDLER rate
+        immigration_status: CITIZEN
+        childcare_hours_per_week: 30
+        hi_ccap_provider_category: LICENSED_CENTER_OR_GROUP_HOME
+      person3:
+        age: 4  # >= 36 months -> OLDER rate
+        immigration_status: CITIZEN
+        childcare_hours_per_week: 30
+        hi_ccap_provider_category: LICENSED_CENTER_OR_GROUP_HOME
+    tax_units:
+      tax_unit:
+        members: [person1, person2, person3]
+    spm_units:
+      spm_unit:
+        members: [person1, person2, person3]
+    households:
+      household:
+        members: [person1, person2, person3]
+        state_code: HI
+  output:
+    # Licensed center full-time rates: infant/toddler 1,733 + older 795
+    # = 2,528; copay = 2,528 x 0.09 = 227.52
+    hi_ccap_maximum_monthly_rate: [0, 1_733, 795]
+    hi_ccap_copay_rate: 0.09
+    hi_ccap_copay: 227.52
+
+- name: Case 9, from the 2021 rule change two children still pay the tier on income once.
+  period: 2022-01
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 30
+        employment_income: 66_000  # 5,500/mo, FPG ratio 2.49 -> 9%
+        immigration_status: CITIZEN
+      person2:
+        age: 1  # < 36 months -> INFANT_TODDLER rate
+        immigration_status: CITIZEN
+        childcare_hours_per_week: 30
+        hi_ccap_provider_category: LICENSED_CENTER_OR_GROUP_HOME
+      person3:
+        age: 4  # >= 36 months -> OLDER rate
+        immigration_status: CITIZEN
+        childcare_hours_per_week: 30
+        hi_ccap_provider_category: LICENSED_CENTER_OR_GROUP_HOME
+    tax_units:
+      tax_unit:
+        members: [person1, person2, person3]
+    spm_units:
+      spm_unit:
+        members: [person1, person2, person3]
+    households:
+      household:
+        members: [person1, person2, person3]
+        state_code: HI
+  output:
+    # Same household and rates as Case 8, but the rates no longer enter:
+    # copay = 5,500 (gross income) x 0.09 = 495.00, not 227.52
+    hi_ccap_maximum_monthly_rate: [0, 1_733, 795]
+    hi_ccap_copay_rate: 0.09
+    hi_ccap_copay: 495

policyengine_us/tests/policy/baseline/gov/states/hi/bessd/ccap/copay/hi_ccap_copay_rate.yaml

@@ -1,4 +1,4 @@
-# HI CCAP co-payment rate by FPG band (Exhibit II, HAR 17-798.2-14(b)(4)).
+# HI CCAP co-payment rate by FPG band (Exhibit II, HAR 17-798.3-14(3)).
 # The rate is a function of monthly gross income as a share of the federal
 # poverty guidelines, independent of family size. Bands (income above X%):
 #   0-100% -> 0%, 101-115% -> 1%, 116-130% -> 2%, 131-145% -> 3%,