Repository navigation
Limit school meal categorical eligibility to each qualifying child - #10838
Merged
Merged
Conversation
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Congress defines a homeless child as one who lacks a fixed, regular and adequate nighttime residence (42 U.S.C. 11434a(2)(A)), so every child in a household that lacks one qualifies. is_homeless returns to the household-wide list, and the SPM unit's meal tier reads FREE for that household again. is_homeless_child stays the route for one child in a housed household. Move the child-specific categories into a parameter list. Congress added the foster clause in Pub. L. 111-296, effective October 1, 2010, so is_in_foster_care joins the list on that date. Cite uscode.house.gov and eCFR with section anchors, drop the dead FNS memo link, and restore the program-neutral is_in_foster_care label. Add cases for a homeless household and for a Head Start enrollee above the Head Start income limit. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
MaxGhenis
marked this pull request as ready for review
November 14, 2026 16:40
Core's Population passes decode_enums to calculate_add whenever a formula gives options=[ADD], and Microsimulation.calculate_add accepts no such argument. The child-category helper gave that option, so a Microsimulation that calculated school meal eligibility raised a TypeError. The helper now reads each listed input in its own definition period and counts every month of a monthly one. Core answers an annual request for a monthly true-or-false input such as is_in_foster_care with December's value, so a plain annual read would drop a placement that ends before December. Add a Microsimulation test on a six-person dataset and a YAML case with a foster placement in March and no other month. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Core carries a monthly input forward to later months that have none, so December read as true in the March case and in the July Microsimulation test, and both passed under a plain annual read of the input. Each now sets the next month to false, so the placement covers one month alone. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Congress limits automatic free school meals to a child whom a Head Start program enrolls on a determination under 42 U.S.C. 9840(a)(1)(B) (42 U.S.C. 1758(b)(12)(A)(iii)). USDA defines a Head Start child as any child enrolled in a Head Start program (7 CFR 245.2). The model counts every enrollee and has no input for the basis of enrollment. Record the question as an open candidate in source_conflicts/candidates.yaml for the project lead to rule on. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Contributor
Author
|
US + core hub merge audit, us#10838 at
🤖 Generated with Claude Code |
This was referenced Nov 16, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Limit school-meal child categories to each qualifying child and require Head Start enrollment. Main sums Head Start eligibility, past foster care, runaway status and migrant status across the SPM unit, which gives siblings free meals.
Congress and USDA separate household assistance from individual child categories in 42 U.S.C. 1758(b)(12)(A) and 7 CFR 245.6(b)(7)-(8):
snap,receives_snaptanf,receives_tanffdpiris_enrolled_in_head_startis_homeless_child;is_homelessfor a whole householdis_runaway_childis_migratory_childis_in_foster_careCongress qualifies a child whom Head Start enrolls on the basis of 42 U.S.C. 9840(a)(1)(B). Under 9840(a)(1)(B)(iii), programs may enroll children above the income limit, so the model applies no income test to an enrollee. The existing
is_enrolled_in_head_startinput records enrollment in Head Start or Early Head Start and defaults to false.is_head_start_eligiblecounts a family's SSI receipt as public assistance. Congress lists no SSI category in 1758(b)(12)(A), so a child in that family qualifies through Head Start only by enrolling.meets_school_meal_categorical_eligibilityholds the household-wide categories for the SPM unit, andschool_meal_tierreads it.is_school_meal_categorically_eligiblecombines that result with each person's own categories, which the newchild_categorical_eligibilityparameter lists.school_meal_child_breakfast_tierandschool_meal_child_lunch_tiergive the FREE tier to a child with an own category and the SPM unit's tier to every other child. The SPM unit's daily subsidy averages each K-12 child's rates, and its free and reduced-price values follow each child's tiers.is_school_meal_categorically_eligiblereads each listed input in that input's own period and counts every month of a monthly one. It passes Core no period option, because a population run fails on one: givenoptions=[ADD], Core 3.36.0'sPopulationpassesdecode_enumstoMicrosimulation.calculate_add, which accepts no such argument.For example, an Alabama household has wages of $26,000, rental income of $20,000 and children aged four and ten in 2026. School-meal income totals $46,000, between the three-person free limit of $35,516 and the reduced-price limit of $50,542. PolicyEngine's Head Start income test counts the wages and not the rental income, and the wages fall below the $27,320 poverty guideline. Main therefore treats the four-year-old as eligible for Head Start and gives the ten-year-old free meals worth (2.46 + 4.60 - 0.40 - 0.44) × 180 = $1,119.60 a year. Nobody in the household enrolls in Head Start, so the ten-year-old now receives reduced-price meals worth (2.16 + 4.20 - 0.40 - 0.44) × 180 = $993.60.
#9789 tracks broader school-meal coverage, and #10801 tracks countable income.
Invariants
policyengine_us/tests/core/test_school_meal_categorical_eligibility_invariants.pychecks these across generated sibling configurations and across every state and DC:YAML cases pin the foster start date:
is_in_foster_carequalifies a child in 2011 and not in 2010.Methodology choices
is_homelessdescribes the whole household.is_homelesstherefore stays in the household-wide list, as on main, and the SPM unit'sschool_meal_tierreads FREE for that household. USDA's definition also has a school district liaison or shelter director identify each homeless child (7 CFR 245.2), and the model assumes that step for a homeless household.is_homeless_child, a new input that defaults to false, qualifies one child in a housed household.us:school-meals-head-start-categorical-basis, for the project lead to rule on.takes_up_head_start_if_eligible, which defaults to true and describes hypothetical take-up.is_in_foster_caregives the child the annual category. Core answers an annual request for a monthly true-or-false input with December's value, so the formula reads all twelve months. The model reads each list on January 1, so the foster category starts in calendar 2011 although Congress made it effective on October 1, 2010 (Pub. L. 111-296, sections 102(b) and 445).is_in_foster_carekeeps its label and its other readers. The school-meal helper treats it as the agency or court placement that 1758(b)(12)(A)(vii) names.us:school-meals-head-start-categorical-basis.Overlapping work
Three open pull requests change the same school-meal files. #10834 adds take-up to
free_school_mealsandreduced_price_school_meals. #10766 changesfree_school_meals,reduced_price_school_meals,school_meal_daily_subsidyandschool_meal_tierfor qualifying months. #10264 changesschool_meal_tierfor the territories. Whichever lands later must keep both changes.Tests
Pull request run 43645292457 at
731e0b9440passed all 38 jobs on GitHub's merge with main94054aa57e.YAML cases cover each category's reach, the Alabama example, a homeless household above the income limits, a Head Start enrollee above the Head Start income limit, and a foster placement in March alone. The property tests check the invariants above. The YAML and property cases build household simulations, and in a population run Core routes a formula's variable calls through
Microsimulation's own methods. A Python test therefore builds a six-personMicrosimulationand checks each child's own category and meal tiers there, with a foster placement in July alone. In CI that test's call phase takes 0.08 s (Linux, run 43629025115), and on macOS a process that runs it alone peaks at 1.3 GB. In the full suite it runs in the Rest Pythoncoregroup. This change edits no partner contract test.Microsimulation impact
We estimate that this branch lowers the value of free school meals by $186.2m in 2026 on the default dataset, for 73 sampled SPM units (89,213 weighted). The value of reduced-price meals rises by $36.5m, and net school meal subsidies fall by $149.7m. We compared
mainat935b24ff4fwith this branch at731e0b9440.free_school_mealsreduced_price_school_mealsschool_meal_daily_subsidyschool_meal_net_subsidystate_income_taxincome_taxhousehold_benefitshousehold_net_incomeaxiom: TheAxiomFoundation/rulespec-us#2245 queued (42 U.S.C. 1758(b)(12)(A) and 7 CFR 245.2 and 245.6(b)(7)-(8); the corpus holds neither 42 U.S.C. 1758 nor 7 CFR part 245, so the signed encoder can't run yet)
🤖 Generated with Claude Code