[PavelMakarchuk]

Summary

ms_tanf_countable_income added gross earned and unearned income with no deductions, and ms_tanf paid any positive amount.

The MDHS TANF Policy Manual (July 2019), Volume III and its current codified copy, Miss. Admin. Code Title 18, Part 13 (PDF dated 2024-12-05), say (page numbers are PDF file pages):

• Chapter 6, "Budgeting Net Monthly Earned Income" (2019 manual page 470; Part 13 page 469): for families that pass the gross income test, disregard from the monthly earned income of each individual in the budget (a) a "Standard deduction of $90 for work expenses", then (b) the actual cost of care for each dependent child or incapacitated adult in the budget, with no cap. Chapter 4, "Earned Income Disregards" (2019 manual page 370; Part 13 page 362), lists the same disregards.
• Chapter 6, "Minimum Benefit" (2019 manual page 459; Part 13 page 459), and Chapter 15, Table II (2019 manual page 888; Part 13 page 970): no benefit is issued when the monthly amount is less than $10.

Changes:

• New parameter gov.states.ms.dhs.tanf.income.deductions.work_expense ($90 a month, per earner).
• New parameter gov.states.ms.dhs.tanf.minimum_payment ($10 a month).
• New variable ms_tanf_countable_earned_income: the sum of each earner's max(gross earnings − $90, 0), minus childcare_expenses and care_expenses, floored at zero. Dependent care reduces only earned income. The manual deducts care from the earnings of the individual who pays it; PolicyEngine does not record which earner pays, so the unit's care comes off the unit's earnings after the per-earner $90.
• ms_tanf_countable_income now adds ms_tanf_countable_earned_income and tanf_gross_unearned_income.
• ms_tanf returns 0 when the benefit is under $10.

The gross income test (185% of the need standard) still uses gross income, as the manual requires. These cases are still not modeled: the 6-month and 3-month total disregards, the special student disregard (#10490), and the dependent care exceptions (care by the payee's child under 21, or care paid by a third party).

Benefit formula: deferred to #10269

ms_tanf still pays the maximum benefit less countable income. MDHS pays 60% of the deficit (need standard less net income), up to the maximum (Chapter 6, "Computing Benefit", Part 13 pages 458-459; Chapter 15, Table II). #10269 tracks that change. This PR does not make it, because PolicyEngine's need standard for May 2021 to June 2025 is the 2019 manual's Table I ($368 for 3). With that value, the 60% rule would pay a family of 3 with no income floor(0.6 × 368) = $220, not the $260 maximum MDHS has paid since May 2021. The 2021-2024 Table I needs to be found first (#10269, uncertainty 2).

The new tests therefore pin PolicyEngine's current formula, and their comments give the 60% amounts. Under the 60% rule, both integration cases below pay min(floor(0.6 × (581 − net income)), 260) × 12 = $3,120. The $10 minimum applies to whichever benefit ms_tanf computes, so it will apply to the 60% amount once #10269 lands.

Tests

• New ms_tanf_countable_earned_income.yaml (8 cases): no earnings (control); $200 a month gives 200 − 90 = $110; $50 a month of child care gives $60; two earners at $500 and $300 with $100 of care give 410 + 210 − 100 = $520; earnings under $90 give $0; care above earnings does not reduce unearned income (countable income $50); two earners at $60 and $300 give 0 + 210 = $210 (the $90 is floored per earner); and $100 a month of care_expenses for a spouse gives (500 − 90) − 100 = $310.
• ms_tanf.yaml: a $5 benefit is not issued (the existing case that expected $5 now expects $0), and a $10 benefit is issued. The file header and both cases note the inputs the 60% rule would need (Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269).
• integration.yaml: the issue's case is a parent of two with $2,400 a year of earnings. ms_tanf = 12 × (260 − 110) = $1,800 (main: $720; 60% rule: $3,120). With $600 a year of child care, ms_tanf = 12 × (260 − 60) = $2,400 (60% rule: $3,120).

Against main's code, all 11 new or changed earnings and minimum assertions fail. With this PR, policyengine_us/tests/policy/baseline/gov/states/ms/dhs/tanf passes (77 tests), as do gov/hhs/tanf/cash (36) and the parameter, registry, reference URL and source-conflict checks (1,025).

Fixes #10209

axiom: TheAxiomFoundation/rulespec-us#1946 queued

🤖 Generated with Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (909176a) to head (b197592).
⚠️ Report is 712 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##              main    #10258   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files            4         3    -1     
  Lines           76        44   -32     
  Branches         2         0    -2     
=========================================
- Hits            76        44   -32     

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 Harness.
📢 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.

[DTrim99]

PR Review: Apply Mississippi TANF's $90 work expense and dependent care deductions and $10 minimum payment

Summary

The PR makes three changes to Mississippi TANF:

• Countable earned income. A new SPMUnit MONTH variable, ms_tanf_countable_earned_income, sums each member's max(tanf_gross_earned_income − $90, 0). It then subtracts childcare_expenses and care_expenses and floors the result at zero. ms_tanf_countable_income now adds this variable instead of gross earnings.
• Minimum payment. ms_tanf returns 0 when the monthly benefit is under $10.
• Parameters. It adds income/deductions/work_expense ($90) and minimum_payment ($10), both from 2017-01-01.

It also adds 6 + 2 + 2 YAML cases and a fixed changelog fragment.

• Law. The three provisions the PR adds are right in every claimed year:
  • The July 2019 MDHS manual and the current codified copy (Miss. Admin. Code Title 18, Part 13, PDF dated 2024-12-05) both disregard, "in the order set forth below from the monthly earned income of each individual", (a) "Standard deduction of $90 for work expenses", then (b) "the actual cost for the care of each dependent child or incapacitated adult".
  • The deduction has no cap. Mississippi has no $175/$200 dependent care maximum.
  • Both editions bar monthly benefits "of less than $10".
• Order of operations.
  • The gross income test (185%) still uses gross income, as required ("For families who qualify on the gross income test").
  • The $90 applies per earner and is floored per earner, and dependent care comes after it.
  • Care reduces only earned income.
• What stays out of scope. The 6-month and 3-month total disregards are one-time and depend on job-start timing, and the body says so.
• Code. The new code is vectorized. It has no state-gated key lookups, so the NH Add New Hampshire state supplementation for 2026 #10156 pattern doesn't apply. It creates no circular dependency through childcare_expenses, because MS CCPP reads receives_tanf, which is an input.
• Tests. I hand-checked 13 expectations, and they are arithmetically right under PE's formula.
• CI and branch. All 29 checks pass, and the merge with main is clean.

Three things need fixing:

1. The new ms_tanf expectations ($1,800 and $2,400 in 2026) and the PR body present "maximum less countable income" as the benefit. The Admin Code pays 60% of the deficit (need standard less net income), up to the maximum. Under that rule both cases get $3,120. The author's own open issue Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269 records this, but neither the PR body nor the tests mention it.
2. The 2019-manual anchor for the $90 and dependent care text points one page early, and the reference titles carry printed page numbers.
3. The axiom: line is missing. rulespec-us has no Mississippi TANF module, so a queued line is needed (see "Axiom line assessment").

Critical (must fix)

None.

Should address

1. The new ms_tanf expectations pin a benefit formula the governing rule contradicts. Fold #10269 in, or document the deferral.

ms_tanf.py (unchanged core, lines 19-21 at head) pays min_(max_(maximum_benefit − countable_income, 0), maximum_benefit). The PR adds the $10 minimum on top of that and adds new ms_tanf expectations in integration.yaml Cases 9-10 (2026), whose comments read (260 - 110) * 12 = 1_800 and (260 - 60) * 12 = 2_400. The body repeats "ms_tanf = 12 × (260 − 110) = $1,800 (main: $720)".

The codified rule computes the benefit differently:

• Computing Benefit. Admin Code Title 18, Part 13, Chapter 6, "Computing Benefit" (file pages 458-459): the benefit is controlled by "1. The budgetary deficit, which is secured by subtracting the net income from the requirements of the budget group. 2. The legal maximum benefit ... 3. The percentage, or ratable, reduction". "The benefit will be the percent of the budgetary deficit or the maximum benefit for the number of individuals in the budget, whichever is less."
• Table II. Chapter 15, Table II (file page 970, revised 12-01-24): "60% of unmet need (deficit) up through but not exceeding legal maximums". The maximum is $200 / $36 / $24, so $260 for 3, and the monthly minimum is $10.
• Same text in 2019. The 2019 manual has the same text (file page 458) and the same 60% (Table II, file page 888).
• Net income test. The budget also tests "net income ... against 100% of the standard of need" (Part 13, file page 445). The deficit rule builds that test in.

With the 2026 need standard of $581 for 3, already in need_standard/amount.yaml:

Case (2026)	Net monthly income	PR / PE formula	Admin Code rule
Integration Case 9	110	(260 − 110) × 12 = 1,800	min(⌊0.6 × 471⌋ = 282, 260) × 12 = 3,120
Integration Case 10	60	(260 − 60) × 12 = 2,400	min(⌊0.6 × 521⌋ = 312, 260) × 12 = 3,120
Size 3, $500 earnings (net 410)	410	0	⌊0.6 × 171⌋ = 102 a month
Size 3, countable income 255	255	5 → 0 under the new minimum	⌊0.6 × 326⌋ = 195 a month

The formula is pre-existing, and the PR's own provisions move most families toward the rule (Case 9: main $720, PR $1,800, rule $3,120). Two things still need attention:

• The new tests and the body present known-wrong amounts as the expected result. The author's issue Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269 (2026-10-19) computes the same $3,120 for this PR's case and notes that it "changes the same file and the same test expectations".
• The new minimum compounds the wrong base. It applies to "maximum less income", so a unit whose maximum less income is under $10 now gets $0. The rule pays that unit about $195.

Fix (either):

• (a) Preferred: implement Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269 here. The two changes rewrite the same lines and expectations.
  • Add gov.states.ms.dhs.tanf.payment_percentage = 0.6 (Part 13 Table II).
  • Move the need standard lookup into a shared variable.
  • Compute deficit = max_(need_standard − countable_income, 0) and benefit = min_(floor(0.6 × deficit), maximum_benefit), then apply the $10 minimum. Benefits are rounded down: Part 13, file page 459, "rounded down ... to the next lower whole dollar amount".
  • Cases 9-10 become 3,120.
  • ms_tanf.yaml Cases 11-12 need inputs near the need standard. For size 3, countable income 570 gives ⌊0.6 × 11⌋ = 6, so 0. Countable income 564 gives ⌊0.6 × 17⌋ = 10, which is issued.
• (b) Keep the scope and document the deferral.
  • In the body, change the integration bullet to say that ms_tanf still pays the maximum less countable income and that MDHS pays 60% of the deficit (Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269).
  • In Cases 9-10, add a comment such as # Admin Code rule (60% of the deficit, #10269): min(floor(0.6 * (581 - 110)), 260) * 12 = 3_120.
  • Update the stale header line in integration.yaml ("Benefit: Maximum Payment Standard - Countable Income").

2. Fix the 2019-manual page anchor for the $90 and dependent care text, and drop printed page numbers from the reference titles.

The anchor:

• work_expense.yaml (second reference) and the ms_tanf_countable_earned_income.py reference tuple point at TANF-Manual-Revised_7.19.pdf#page=469.
• In that PDF, file page 469 (printed 6025) has only the "BUDGETING NET MONTHLY EARNED INCOME" heading and the special student disregard. The $90 and the dependent care rule ("2. Disregards for wage earners other than students ... a. Standard deduction of $90 for work expenses. b. Dependent care deduction which is the actual cost ...") are on file page 470 (printed 6026).
• So the work_expense anchor doesn't show the $90. In the codified Part 13 PDF the same text is on file page 469, which may be where the 469 came from.

The titles:

• The titles cite printed pages: "page 4104", "pages 6025-6026", "page 6015" and "page 15001".
• CLAUDE.md says: "One cited page: #page=57 in the href only, no page in the title". It also says page numbers are file pages, not printed pages.

Fix:

• work_expense.yaml.
  • Change the second href to #page=470 and the title to MDHS TANF Policy Manual, Volume III, Chapter 6 - Budgeting Net Monthly Earned Income.
  • Retitle the first reference ... Chapter 4 - Earned Income Disregards. Its href, #page=370, is correct: it shows "Standard $90 deduction for work expenses".
• minimum_payment.yaml. Drop "page 6015" and "page 15001" from the titles. Both hrefs (#page=459 and #page=888) are correct.
• ms_tanf_countable_earned_income.py. Change #page=469 to #page=470. Change the comment's "pages 6025-6026" to the file page, or drop it.

3. Add the axiom: line to the PR body.

The body (head c748d85307, last edited 2026-10-23) has no line starting with axiom in any format. Pavel is staff and this is a policy change, so the line is required, and axiom: needed isn't available. encoded-correct isn't available either, because rulespec-us has no Mississippi TANF module. See "Axiom line assessment" for the queued line and the issue contents.

Suggestions

1. Cite the current codified rule. Miss. Admin. Code Title 18, Part 13 (TANF Policy Manual, Volume III; the PDF linked from the MDHS administrative codes page, dated 2024-12-05) has the same text and values as the 2019 manual:

   • the disregard list on file page 362;
   • the $90, then dependent care, on file page 469;
   • "Minimum Benefit" on file page 459;
   • Table II, "Monthly Minimum Payments $10", on file page 970.

   Adding it alongside the 2019 manual shows the values still apply in 2026. ms_tanf_countable_income's references (the 2018 flyer and the Part 19 State Plan) don't contain the deductions.

2. Two more cases for ms_tanf_countable_earned_income.yaml:

   • The per-earner floor with one earner under $90. Use earnings of 720 and 3,600 a year ($60 and $300 a month), with no care: max(60 − 90, 0) + (300 − 90) = 210. A floor on the pooled amount would give 360 − 180 = 180. Cases 4 and 5 test per-earner and under-$90 separately, never together.
   • The care_expenses branch, which no test reaches. Use a parent earning 6,000 a year and a spouse with care_expenses: 1_200: (500 − 90) − 100 = 310.

3. Special student disregard (follow-up). The rule disregards "all of the earned income in both the gross and 100% test of each TANF dependent child (but not of a TANF payee)" who is a full-time student, or a part-time student who isn't a full-time employee (2019 manual file page 469; Part 13 file page 469).

   • Today a working teenager's earnings get only the $90, and they also count in the 185% test.
   • PE has is_in_k12_school, which MS CCPP already uses for its own student exclusion, so this can be modeled.
   • The body lists it as not modeled, so a follow-up issue is fine.

4. Say that pooling dependent care is an approximation. The rule deducts care "from the monthly earned income of each individual". The formula subtracts the unit's care from the unit's total after the per-earner $90, so care above one earner's earnings can offset another's. PE doesn't record which earner pays, so pooling is reasonable. A one-line comment at ms_tanf_countable_earned_income.py:26 would make that explicit.

Verified correct

• Rule text (2019 manual file page 470, revised 08-01-18; Part 13 file page 469, revised 12-01-17):
  • "Disregard in the order set forth below from the monthly earned income of each individual, other than the students discussed above, whose needs are included in the eligibility determination: a. Standard deduction of $90 for work expenses. b. Dependent care deduction which is the actual cost for the care of each dependent child or incapacitated adult living in the same home and included in the assistance budget."
  • The exceptions: care by "the payee's child or stepchild under age 21", or "paid by a third party". "Any amount above what the third party pays can be allowed as a deduction."
  • The deduction is actual cost, with no maximum.
• Years.
  • The disregard list ("Standard $90 deduction for work expenses", 2019 manual file page 370) is marked revised 11-01-11.
  • Table II's $10 minimum is marked revised 04-01-06.
  • The 2024-12-05 Part 13 keeps both, so the 2017-01-01 start and the values through 2026 are supported. I found no later change.
• Minimum benefit. 2019 manual file page 459: "prohibits monthly benefits to individuals or families who qualify for benefits of less than $10 monthly". where(benefit >= p.minimum_payment, benefit, 0) issues exactly $10, which is right. The two exceptions, recoupment and corrective payments, can't be modeled.
• Order of operations.
  • The gross test comes first: "For families who qualify on the gross income test" (file page 469). ms_tanf_income_eligible still reads gross income, and the existing integration Case 3 ($1,074 against $1,074.85) still passes.
  • The $90 is per earner and floored per earner, then dependent care comes off the earned total and is floored at zero.
  • Unearned income is added afterwards, so care never reduces it (new Case 6).
  • MS has no ongoing percentage disregard. The 6-month total disregard (35+ hours, once) and the 3-month disregard (at closure, 25+ hours) depend on job-start timing. The NOTE keeps saying they aren't modeled.
• Wage definition (OK Add Oklahoma state supplementation for 2026 #10165 / Document disjoint health premium inputs and correct consumer treatment #10046 family). The manual counts cafeteria-plan diversions as income: "Money which is diverted from an employee's gross earnings through a cafeteria plan ... is counted as income" (2019 manual file page 369). tanf_gross_earned_income sums employment_income_before_lsr and self-employment without netting pre-tax premiums, which is consistent with that.
• Third-party payments. childcare_expenses is pre-subsidy care less child_care_subsidies (floored), so the subsidized part is excluded and the excess is allowed, as the note requires. The same pattern is used by AL, AZ, DC, GA, IL, TX and other state TANF deductions.
• No cycle. childcare_expenses → child_care_subsidies → ms_child_care_subsidies. MS CCPP's categorical eligibility and co-pay waiver read is_tanf_enrolled, which defaults to receives_tanf, an input. CCPP's income lists don't include TANF.
• Code.
  • spm_unit.sum(max_(gross_earned − p.work_expense, 0)) and where(...) are vectorized.
  • The new parameters are scalars, and no state-gated variable is used as a key (NH Add New Hampshire state supplementation for 2026 #10156 doesn't apply).
  • YEAR inputs requested monthly convert by /12; Case 3's 600 → 50 confirms it in CI.
  • The 88-character line is within ruff's default.
  • defined_for = StateCode.MS is set on the new variable.
• Callers. Only ms_tanf reads ms_tanf_countable_income. ms_tanf feeds tanf_if_takes_up and the programs registry entry. No other caller changes.
• Hand-checked expectations (13), all correct under PE's formula:
  • ms_tanf_countable_earned_income.yaml (2026-01):
    • Case 1: 0.
    • Case 2: 2,400 / 12 = 200, and 200 − 90 = 110.
    • Case 3: 110 − 600 / 12 = 60.
    • Case 4: (500 − 90) + (300 − 90) − 1,200 / 12 = 520.
    • Case 5: max(60 − 90, 0) = 0.
    • Case 6: max(110 − 300, 0) = 0, and countable income 0 + 600 / 12 = 50 (alimony_income is a TANF unearned source).
  • ms_tanf.yaml:
    • Case 11: 260 − 255 = 5 < 10, so 0.
    • Case 12: 260 − 250 = 10 ≥ 10, so 10.
  • integration.yaml (2026):
    • Case 9: countable 110 × 12 = 1,320. ms_tanf (260 − 110) × 12 = 1,800. Eligible: 200 ≤ 1.85 × 581 = 1,074.85, and assets 0 ≤ 2,000.
    • Case 10: 60 × 12 = 720, and (260 − 60) × 12 = 2,400. Under the Admin Code rule both are 3,120 (Should 1).
    • Existing Case 3: the gross test at $1,074 stays true, which confirms the gross test still ignores the deductions.
• PR body. "All 9 new or changed earnings and minimum assertions fail on main" is right. The 9 are: earned income 110, 60 and 520, Case 6's countable income 50, ms_tanf Case 11, and the four integration outputs. The zero cases and the $10 case match main.
• Source-conflict ratchet (Tie source-conflict markers to the register shared with Axiom #10287). The added or edited comments ("MDHS TANF Policy Manual, Volume III, page 6015: no benefit is issued ...", "... pages 6025-6026: from the monthly earned income ..." and "does not apply those time-limited disregards") match neither CONFLICT_COMMENT_RE nor ATTEMPT_RE. No MS file is in KNOWN_UNMARKED. The test YAML is outside the scanned roots.
• Changelog. changelog.d/fix-10209-ms-tanf-deductions.fixed.md is a top-level fragment with the fixed type.
• Parameters. The descriptions follow the house template, and period: month and the labels are set.
• Partner tests. No files under tests/policy/baseline/partners/** are touched, and Household API Partners passes.
• Issue closure. Fixes #10209 is right: Mississippi TANF omits the $90 work expense and dependent care deductions and pays grants under $10 #10209 asks for exactly the $90, the dependent care deduction and the $10 minimum. The 60% rule is tracked separately in Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269.

Axiom line assessment

The line is missing (Should 3), and encoded-correct isn't available:

• No module. rulespec-us holds only us-ms/policies/cms/... (CHIP, Medicaid) and us-ms/policies/income_tax/.... There is no Mississippi TANF module.
• No issue. Searches of rulespec-us issues for "Mississippi TANF", "us-ms TANF", "10209", "10258" and "10269" find no parity issue. The only Mississippi benefit issue is Add AMT parameters for 2020-2023 #1467, for LIHEAP.

Recommended line. File a dispatch-ready pe-parity issue and use axiom: TheAxiomFoundation/rulespec-us#<n> queued. Following #1467's us-ms/regulations/title-18/part-24/... layout, the issue should have:

• Modules.
  • us-ms/regulations/title-18/part-13/chapter-6/budgeting-net-monthly-earned-income: the $90, dependent care and their order (file page 469).
  • us-ms/regulations/title-18/part-13/chapter-6/amount-of-benefit: computing benefit, minimum benefit and rounding (file pages 458-459).
  • us-ms/regulations/title-18/part-13/chapter-15/table-ii: 60%, the legal maximums and the $10 minimum (file page 970).
  • Optionally .../chapter-4/earned-income-disregards (file page 362).
• Corpus. It's already ingested. axiom-corpus us-ms/manual/2026-09-10-tanf-state-policy-manual holds us-ms-mdhs-tanf-policy-manual.pdf with sha256 ac33028a…fd771, the same file as the 2024-12-05 Part 13 PDF. So the only blocker is approval of the billed encoder run.
• Law. The verbatim text from file page 469 (items 2a-2b with the exceptions and the third-party note), the "Minimum Benefit" and "Computing Benefit" paragraphs, and Table II.
• Required outputs. Each individual's net monthly earned income, the unit's countable income, and the monthly benefit with the $10 minimum.
• Divergence note. PE's benefit formula differs from the Admin Code's 60% rule until Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269 is fixed, so the oracle comparison will diverge on ms_tanf until then.
• Companion cases. Take them from the rule text, not from PolicyEngine output:
  • $200 of monthly earnings gives $110 of net earned income.
  • The same earnings with $50 of care give $60.
  • Two earners at $500 and $300 with $100 of care give $520.
  • $60 of earnings gives $0.
  • A computed benefit of $5 is not issued, and $10 is issued.
  • Table II: the size-3 maximum is $260.

CI status

All 29 checks pass at c748d85307 (gh pr checks 10258). The workflow run on that SHA was created 2026-10-23 18:44 UTC, after #10287 and #10334. That includes:

• the 11 Baseline shards (incl. states shards 1-4);
• the 9 Contrib shards;
• Household API Partners;
• PR validation (lock, guard tests, lint, changelog);
• Microsimulation;
• Quick Feedback;
• codecov patch and project (100%).

None is pending or failing.

Branch status

The branch is 2 commits ahead of main (the change on 2026-10-16 and a merge of main on 2026-10-23) and 48 behind. git merge-tree --write-tree PolicyEngine/main c748d85307 merges cleanly.

• Main's changes to Mississippi since the merge base touch only income tax files (ms_other_additions, ms_other_subtractions and the related parameters).
• Main's only change to test_source_conflicts.py edits unrelated KNOWN_UNMARKED rows (CA premium subsidy, QBI, local sales tax).
• No other open PR touches Mississippi TANF. Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269 is an open issue, not a PR.

Verdict: REQUEST_CHANGES

[DTrim99]

The new rules match the 2019 manual and Admin Code T18 Pt13 ($90 per earner, then actual dependent care with no cap, and no benefit under $10), and all 13 expectations hand-check. Three should-address items: (1) the new ms_tanf Cases 9-10 pin 'max less income' ($1,800/$2,400), but the Admin Code pays min(60% x (need - net), max), which gives $3,120 for both; fold in your #10269 or document the deferral in the body and tests; (2) the 2019-manual anchor #page=469 doesn't show the $90/dependent-care text (file page 470), and the titles carry printed page numbers; (3) there's no axiom line. Four suggestions. Full report in the comment above.

[PavelMakarchuk]

Thanks for the review. Changes are in 9cdc151. Each item and its disposition:

Should address

1. Benefit formula: deferral documented (option b), not folded in.

• I did not implement Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269 here. PolicyEngine's need standard for May 2021 to June 2025 is the 2019 manual's Table I ($368 for 3, revised 10-01-06). With that value, 60% of the deficit pays a family of 3 with no income floor(0.6 × 368) = $220, not the $260 maximum MDHS has paid since May 2021. So the 60% rule needs the 2021-2024 Table I first (Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269, uncertainty 2). I did not find that table.
• PR body: a new "Benefit formula: deferred to Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269" section says ms_tanf still pays the maximum less countable income, gives the reason, and gives $3,120 for both integration cases under the 60% rule. It also says the $10 minimum applies to whichever benefit ms_tanf computes.
• integration.yaml: the header now describes the deductions and the minimum, and says the benefit formula is PolicyEngine's current one, with a pointer to Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269. Cases 9 and 10 give both amounts, for example # 60% of the deficit (#10269): min(floor(0.6 * (581 - 110)), 260) * 12 = min(282, 260) * 12 = 3_120.
• ms_tanf.yaml: the header says the cases test the current formula and that Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269 will change them. Cases 11 and 12 give the inputs the 60% rule would need (570 gives 6, so 0; 564 gives 10, issued).
• ms_tanf.py: a comment above the formula says the Admin Code pays 60% of the deficit up to the maximum and that Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269 tracks the change.

2. Page anchor and reference titles: fixed.

• The $90 and dependent care citation now opens 2019 manual file page 470 (work_expense.yaml and the ms_tanf_countable_earned_income.py reference). I checked the pages with pdftotext: 469 has the heading and the student disregard; 470 has items 2a and 2b.
• The titles no longer carry printed page numbers. The repo rule also asks for one reference entry per source document, so I merged the two 2019-manual entries in each parameter into one entry with the file pages at the end of the title: #page 370,470 (work_expense.yaml) and #page 459,888 (minimum_payment.yaml). The hrefs open 370 and 459.
• The variable comments now name the chapter and section ("Chapter 6, Budgeting Net Monthly Earned Income", "Chapter 6, Minimum Benefit, and Chapter 15, Table II") instead of printed pages.

3. axiom: line: added.

• Filed Encode Mississippi TANF's $90 work expense and dependent care disregards, 60% benefit computation and $10 minimum (Miss. Admin. Code tit. 18, pt. 13, ch. 6 and ch. 15 Tables I-II) (PE-US #10258) TheAxiomFoundation/rulespec-us#1946 (pe-parity): module paths under us-ms/regulations/title-18/part-13/ (chapter 6 net earned income and amount of benefit, chapter 15 Tables I-II), corpus us-ms/manual/mdhs/tanf/volume-iii (I checked that the manifest's PDF has the same sha256, ac33028a…fd771, as the Secretary of State copy), verbatim text, required outputs, 14 companion cases from the rule text, and the Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269 divergence note. Blocker: no approved billed encoder run.
• PR body: axiom: TheAxiomFoundation/rulespec-us#1946 queued.

Suggestions

1. Cite the codified rule: done. work_expense.yaml cites Part 13 #page 362,469, and minimum_payment.yaml cites Part 13 #page 459,970. ms_tanf_countable_earned_income.py cites Part 13 page 469, ms_tanf.py cites Part 13 pages 459 and 970, and ms_tanf_countable_income.py now cites Part 13 page 469.
2. Two more cases: added to ms_tanf_countable_earned_income.yaml. Case 7: earners at $60 and $300 a month give 0 + 210 = 210 (the pooled floor would give 180). Case 8: a spouse with care_expenses: 1_200 and a parent earning $500 a month give (500 − 90) − 100 = 310.
3. Special student disregard: follow-up filed as Mississippi TANF counts a student child's earnings; MDHS disregards them in the gross and net income tests #10490 (law text, an example household, and notes on is_in_k12_school and the 130-hour test). The ms_tanf_countable_income NOTE and the PR body now point to it.
4. Pooled dependent care: comment added in ms_tanf_countable_earned_income.py: the manual deducts care from the earnings of the individual who pays it, and PolicyEngine pools the unit's care against the unit's earnings after the per-earner $90 because it does not record which earner pays. The PR body says the same.

Checks

• policyengine_us/tests/policy/baseline/gov/states/ms/dhs/tanf: 77 passed (75 + the 2 new cases).
• gov/hhs/tanf/cash: 36 passed.
• test_source_conflicts.py, the reference URL checks, test_parameter_yaml_keys.py, test_parameter_files.py and test_programs_registry.py: 1,025 passed, 10 skipped.
• make format: no changes. The changelog fragment is unchanged and still accurate.

🤖 Generated with Claude Code

[DTrim99]

PR Review (round 2): Apply Mississippi TANF's $90 work expense and dependent care deductions and $10 minimum payment

Summary

Round 1 (head c748d85307, 2026-10-26) requested changes on three points. The author's one new commit, 9cdc151cd7, deals with all three and with all four suggestions:

• Should 1 (benefit formula). The author chose option (b): document the deferral to Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269 rather than fold it in. The deferral is now stated in the PR body, in both test file headers, in the comments on Cases 9-12 and in a comment in ms_tanf.py. The stated reason holds. PE's need standard from May 2021 to June 2025 is the 2019 manual's Table I ($368 for 3), so the 60% rule would pay floor(0.6 × 368) = $220. That is below the $260 maximum MDHS has paid since SB 2759 (2021). The 2021-2024 Table I has to be found first.
• Should 2 (anchors and titles). Fixed. I checked every href against the PDFs.
• Should 3 (axiom line). Fixed. axiom: TheAxiomFoundation/rulespec-us#1946 queued points to an OPEN, pe-parity-labelled issue that is dispatch-ready and matches the head.

The new commit changes no expected value. It adds two cases, Case 7 (210) and Case 8 (310), and comments that give the 60% amounts. I hand-checked both new cases and every 60% figure in the new comments, and all are right.

The governing law is unchanged from round 1:

• Statute. Miss. Code § 43-17-5(1), as amended by SB 2759 (2021), sets only the legal maximums ($200 / $36 / $24) and leaves the computation to MDHS rules. It says nothing about the $90 deduction, dependent care, the 60% or the $10 minimum.
• Admin Code. Title 18, Part 13 therefore governs those points, and it fills the statute's gap without conflicting with it. No source-conflict marker is needed.

The branch is 3 ahead and 70 behind main, and it merges cleanly. CI tests the merge commit with current main:

• All 488 Mississippi YAML tests pass, including the PR's 10 + 12 + 8 cases, with 100% patch coverage.
• The source-conflict, unemployment-compensation and military-retirement guards pass.
• One check fails, and main causes it. The Montana AGI property test fails identically on main's own push run at c2785f63. Check Montana's pension exemption in the Montana AGI pooling test #10496 has the fix.
• When I last checked, 12 checks were still pending, most of them Contrib shards that had just started (see "CI status").

Prior findings

Finding	Status	Evidence
Should 1. The new ms_tanf expectations ($1,800 / $2,400) and the body pin "maximum less countable income", while Part 13 pays min(60% of the deficit, maximum) ($3,120 for both). Fold in #10269 or document the deferral.	Declined with reason (accepted)	Option (b) is done in full. The body has a new "Benefit formula: deferred to #10269" section. The integration.yaml header is updated, and the stale "Benefit: Maximum Payment Standard - Countable Income" line now adds "; no benefit under $10" and a paragraph on the 60% rule. Cases 9-10 give both amounts ("min(282, 260) * 12 = 3_120", "min(312, 260) * 12 = 3_120"). The ms_tanf.yaml header says #10269 will change these expectations. Cases 11-12 give the 60%-rule inputs (570 → 6, so 0; 564 → 10, issued). ms_tanf.py lines 24-28 carry a comment. The reason holds: need_standard/amount.yaml has 3: 2017-01-01: 368, 2025-07-01: 581. The 2019 manual's Table I (file page 887, revised 10-01-06) shows "100% Requirements ... 368" for 3. payment_standard/first_person.yaml has $200 from 2021-05-01. So for those months, floor(0.6 × 368) = 220 < 260. Part 13's Table I (file page 969) shows $581 but is marked "Revised 12-01-2-4", so it doesn't cover 2021-2024. The house severity rules treat a documented, reasoned deferral as a suggestion, so this is no longer blocking. Non-blocking note for #10269: PE's need standard matches Part 13 from 2025-07-01, so the 60% rule could start with those months even before the 2021-2024 table turns up.
Should 2. The 2019-manual anchor #page=469 doesn't show the $90 or dependent care text, and the titles carry printed page numbers.	Fixed	work_expense.yaml now has one entry per source document. The 2019 manual entry's href is #page=370 and its title ends #page 370,470. The Part 13 entry's href is #page=362 and its title ends #page 362,469. Both titles are quoted. minimum_payment.yaml: #page=459 with "#page 459,888", and Part 13 #page=459 with "#page 459,970". ms_tanf_countable_earned_income.py uses #page=470 and Part 13 #page=469. ms_tanf.py puts # PDF pages 459, 888 and # PDF pages 459, 970 above its multi-page hrefs, which is the CLAUDE.md format. Every cited file page shows its text (pdftotext): 2019 p. 370 ("Standard $90 deduction for work expenses"), p. 459 ("Minimum Benefit ... less than $10"), p. 470 (items 2a-2b) and p. 888 (Table II, "$10, except when making corrective payments"). Part 13 p. 362 (the disregard list), p. 459 ("Minimum Benefit"; "Computing Benefit" starts on p. 458), p. 469 (items 2a-2b) and p. 970 (Table II, "60% of unmet need", "Monthly Minimum Payments $10"). No title carries a printed page number.
Should 3. No axiom: line.	Fixed	The body ends with axiom: TheAxiomFoundation/rulespec-us#1946 queued. See "Axiom line assessment".
Suggestion 1. Cite the codified Part 13 rule.	Fixed	Part 13 (00000330c.pdf, sha256 ac33028a…fd771, the same file as the axiom-corpus manifest) is now cited in both parameters, in ms_tanf.py, in ms_tanf_countable_earned_income.py and in ms_tanf_countable_income.py (#page=469).
Suggestion 2. Add a mixed-earner per-earner-floor case and a care_expenses case.	Fixed	ms_tanf_countable_earned_income.yaml Case 7 gives 210, and Case 8 gives 310 (hand-checked below). Case 8 reaches the care_expenses branch, whose variable is labelled "Care expenses for a disabled adult dependent or spouse".
Suggestion 3. Special student disregard follow-up.	Fixed	#10490 (OPEN, filed 2026-10-27) records the item 1 rule (Part 13 p. 469: "disregard all of the earned income in both the gross and 100% test of each TANF dependent child"). The ms_tanf_countable_income NOTE and the body point to it.
Suggestion 4. Say that pooling dependent care is an approximation.	Fixed	ms_tanf_countable_earned_income.py lines 26-29 explain the pooling ("PolicyEngine does not record which earner pays, so the unit's care costs come off the unit's earnings after the per-earner $90"), and the body says the same.

New findings

None. No critical, should or suggestion items.

Verified

• Hand-checked expectations. These are the new cases and every new figure in the comments. All are right.
  • ms_tanf_countable_earned_income.yaml Case 7 (2026-01): 720 / 12 = 60 and 3,600 / 12 = 300, so max(60 − 90, 0) + (300 − 90) = 210. A floor on the pooled amount would give (60 + 300) − 180 = 180, so the case tells the two apart.
  • Case 8: 6,000 / 12 = 500 and care_expenses 1,200 / 12 = 100, so (500 − 90) − 100 = 310.
  • integration.yaml Case 9 comment: 0.6 × (581 − 110) = 282.6 → 282, and min(282, 260) × 12 = 3,120. The pinned value stays (260 − 110) × 12 = 1,800.
  • Case 10 comment: 0.6 × (581 − 60) = 312.6 → 312, and min(312, 260) × 12 = 3,120. The pinned value stays (260 − 60) × 12 = 2,400.
  • ms_tanf.yaml Case 11 comment: 0.6 × (581 − 255) = 195.6 → 195. With income 570, 0.6 × 11 = 6.6 → 6 < 10, so 0. The pinned value stays 260 − 255 = 5 < 10, so 0.
  • Case 12 comment: with income 564, 0.6 × 17 = 10.2 → 10, issued. The pinned value stays 260 − 250 = 10, issued.
  • The 2026 need standard of $581 for 3 matches Part 13 Table I, and the $260 maximum matches Table II.
• Law.
  • Statute. § 43-17-5(1) as sent to the Governor in SB 2759 (2021) says the amount "shall be determined by the county department ... in accordance with the rules and regulations made by the Department of Human Services". It caps the first member at "Two Hundred Dollars ($200.00)", the second at $36 and each additional member at $24. It doesn't address the disregards, the percentage reduction or a minimum.
  • Admin Code. Part 13 (PDF dated 2024-12-05) has the $90, then actual dependent care, in order (p. 469). It has Computing Benefit and the $10 Minimum Benefit (pp. 458-459), and Table II with the 60%, the maximums and the $10 (p. 970).
  • Federal rules. 45 CFR 260-265 set no federal rule for state benefit computation or minimum payments, so nothing federal conflicts.
• Source-conflict ratchet (Tie source-conflict markers to the register shared with Axiom #10287) on the merged tree.
  • I ran CONFLICT_COMMENT_RE and ATTEMPT_RE, taken from main's test_source_conflicts.py, over every comment in the PR's variable and parameter files on the merged tree: there are no hits.
  • The new wording ("Title 18, Part 13 ... pay 60% of the deficit", "The manual deducts dependent care from the earnings of the individual who pays it") matches no pattern. "manual deducts" isn't one of the (says|states|uses|tells) verbs.
  • No Mississippi file is in KNOWN_UNMARKED, and the test YAML is outside the scanned roots.
  • No source-conflict choice is made: the statute is silent on these points, so the Admin Code fills the gap.
  • CI confirms it: test_conflict_sounding_comments_do_not_grow passes on the merge commit (Rest Python shard 1).
• Other main-side guards on the merged tree. None of the PR's files names unemployment_compensation (Integrate modeled state unemployment insurance into income flows #9558), military_retirement_pay (Count military SBP annuities in state benefit income lists #10317) or any social_security variable. Income enters only through tanf_gross_earned_income and tanf_gross_unearned_income. Count each Social Security benefit once in Pennsylvania CCW countable income #10408's source-list guard is still an open PR and not on main. The PR adds no list it would scan. The Integrate modeled state unemployment insurance into income flows #9558 and Count military SBP annuities in state benefit income lists #10317 reader guards pass in CI on the merge commit.
• Code. The formulas haven't changed since round 1, apart from comments and references. They are vectorized, have no state-gated key lookups (NH Add New Hampshire state supplementation for 2026 #10156 doesn't apply) and have no CCPP cycle. The changelog fragment is unchanged and still accurate.
• PR body. "All 11 new or changed earnings and minimum assertions fail" against main is right: round 1's 9, plus Cases 7 and 8. The test counts (8 / 12 / 10) match the files.
• Partner tests. The PR doesn't touch tests/policy/baseline/partners/**.

Axiom line assessment

axiom: TheAxiomFoundation/rulespec-us#1946 queued is valid:

• Status. The issue is OPEN and labelled pe-parity. It was created 2026-10-27 15:01 UTC, alongside the head commit.
• Dispatch-ready, on the Add AMT parameters for 2020-2023 #1467 model:
  • Module paths. Four, under us-ms/regulations/title-18/part-13/: chapter 6 budgeting net monthly earned income, chapter 6 amount of benefit, chapter 15 table II, and a table I import.
  • Corpus citation. us-ms/manual/mdhs/tanf/volume-iii. I confirmed it in the axiom-corpus manifest us-ms-tanf-state-policy-manual.yaml: same source URL, expression date 2024-12-05, page-level extraction.
  • Verbatim law. Part 13 pp. 458-459, 469, 969 and 970. It matches the pdftotext output above.
  • Required outputs. All three variables.
  • Companion tests. 14 cases, taken from the rule text and Tables I-II, not from PE output. I checked cases 8-14 by hand: 260, 260, 102, 0, 10, 0, and 200 / 236 / 284.
• Blocker. The billed encoder run has not been approved.
• Matches the head. It describes the head's variables and parameters, including the 8 / 12 / 10 test counts. It states the known divergence on ms_tanf until Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269 lands, with PE's values (150, 0, 0, 0) for the diverging cases. It records the 2021-2024 need standard gap.

CI status

Run 40527339046 is on head 9cdc151cd7. It was created 2026-10-27 15:04 UTC, after #10287 and #10334, and it tests the merge commit with current main (6bce356f, main c2785f63). My last check (gh pr checks 10258, 15:33 UTC) showed 21 passed, 1 failed and 12 pending.

Passed:

• PR validation (lock, lint, changelog);
• Package and compatibility;
• Quick Feedback: gov/states/ms, 488 passed; then integration.yaml 10, ms_tanf.yaml 12 and ms_tanf_countable_earned_income.yaml 8 passed, with 100% coverage of the three changed variables;
• all 11 Baseline shards (incl. states shards 1-4);
• Household API Partners;
• Rest Python shards 1, 4 and 6. Shard 1 includes test_source_conflicts.py::test_conflict_sounding_comments_do_not_grow, the unemployment-compensation and military-retirement reader guards, and the reference URL checks;
• Plan Rest Python shards;
• codecov patch and project.

Failed: Rest Python shard 3. Main causes this, so it is a CI note and not a finding.

• One test fails out of 1,946: tests/core/test_mt_state_agi_invariants.py::test_drawn_batches.
• It is a Hypothesis draw for Montana in 2021. A unit with a $12,000 pension reports MT AGI of 7,600 where the pooling invariant expects federal AGI of 12,000.
• The cause is main's Add Montana's 2021–2023 partial pension, annuity, and IRA income exemption #10392 (Montana's 2021-2023 partial pension exemption, merged 2026-10-27 12:34 UTC). The invariant from Report Montana's TAXSIM state AGI for the filing path used, and federal AGI from 2024 #9942 doesn't know about that exemption.
• Main's own push run on c2785f63 (run 40525467763) fails the same test in the same shard.
• Open Check Montana's pension exemption in the Montana AGI pooling test #10496 ("Check Montana's pension exemption in the Montana AGI pooling test") fixes it.
• The PR touches no Montana or tax code. Once Check Montana's pension exemption in the Montana AGI pooling test #10496 lands, merge main and re-run.

Pending:

• the 9 Contrib shards, which had just started;
• Microsimulation;
• Rest Python shards 2 and 5.

The PR's own YAML and the guards have passed on the merged tree. Even so, the pending shards need to finish green before merge.

Branch status

The branch is 3 commits ahead of main (the change, a merge of main on 2026-10-23, and this round's commit) and 70 behind. git merge-tree --write-tree PolicyEngine/main 9cdc151cd7 merges cleanly (tree 15c8bc9a18).

• Main's Mississippi changes since the merge base touch only income tax files.
• No other open PR touches Mississippi TANF. Mississippi TANF pays the maximum benefit less income; MDHS pays 60% of the deficit (need standard less net income) up to the maximum #10269 and Mississippi TANF counts a student child's earnings; MDHS disregards them in the gross and net income tests #10490 are open issues.

Verdict: APPROVE

[DTrim99]

Approving round 2: 0 critical, 0 should. Full report in the comment above. CI note: the one failure (Rest shard 3, test_mt_state_agi_invariants) comes from main and is fixed by #10496; re-run after it lands. Some contrib shards were still pending.

[hua7450]

Approving the ordinary deductions and minimum-payment corrections in #10209. The separate existing grant-formula/table problem remains tracked in #10269; this approval does not close that follow-up.