Repository navigation
Conversation
A filer who can be claimed on another return is treated as having no dependents (IRC 152(b)(1); on a joint return either spouse counts) and has no personal exemption (IRC 151(d)(2)); one who is claimed gets no education credits (25A(g)(3)), student loan interest deduction (221(c)) or recovery rebate (6428(d)(2), 6428A(d)(2), 6428B(c)(2)). The model read none of these. Now the child tax credit and credit for other dependents, the under-13 child and dependent care qualifying person, exemptions_count and its RI, DE, OH, OR, WI, HI and NM readers, the recovery rebates, the education credits and the student loan interest deduction apply them symmetrically for joint returns. Georgia keeps its own counts; the HI, WI and Treasury exemption reforms follow the corrected count. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Child and dependent care: childcare expenses do not count on a return with a claimable filer unless a child under 13 still qualifies (IRC 21(b)(2)(A)(ii)). - Tuition and fees deduction: not allowed to a filer who can be claimed (IRC 222(c)(3)), so the education credit bar no longer makes such a filer eligible. - Recovery rebates: the Armed Forces exception waives the identification rule only, not the exclusion of a spouse who is another taxpayer's dependent. - Georgia: the contributed refundable credit and SB 520 reforms count the same children as ga_ctc_potential through a new ga_ctc_eligible_child. - Education credits and student loan interest read the claimed input directly, since IRC 25A(g)(3) and 221(c) turn on an actual claim. - One reference per source document; quote IRC 24(h)(4)(A) exactly. - Tests: mixed-recipient care, tuition deduction, military rebates, Georgia refund cap, and the swapped New Mexico rebate case; the property test now covers the state readers of the exemption count. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
# Conflicts: # policyengine_us/tests/policy/baseline/gov/states/oh/tax/income/exemptions/personal/oh_personal_exemptions_eligible.yaml
#10024 now separates three facts: is claimed, can be claimed, and the would-be claimant's filing exception. - IRC 152(b)(1) gates (child tax credit, credit for other dependents, under-13 care child and its expenses, dependents in exemptions_count, ARPA dependents, Ohio dependents, the Hawaii and Wisconsin reforms) read head_or_spouse_is_dependent_elsewhere_without_filing_exception, so a filer within the Publication 501 exception keeps their dependents. - Own exemptions, recovery rebates and the tuition deduction read claimability. - Education credits and student loan interest keep reading the claimed input. - Tests: the filing exception and a filer who can be claimed but is not. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
#10024's food/excise credit, Act 115 rebate and renters credit took claimable filers off exemptions_count themselves. exemptions_count now leaves them out (and, outside the filing exception, the return's dependents), so those credits read it as it is; the filing-exception cases were one exemption short. The renters credit also leaves out a dependent who can be claimed by another taxpayer (Schedule X counts only people who cannot be), as the food/excise credit already did. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Education credits: a dependent student is not eligible on a return whose filer can be claimed outside the filing exception (IRC 25A(f)(1)(A)(iii), 152(b)(1)); the filer's own eligibility still turns on an actual claim. - Recovery rebates: no credit when every filer is a dependent of another taxpayer (IRC 6428B(a)); the CARES and CAA child prerequisite is a spouse with a valid SSN, whether or not that spouse is an eligible individual. - Child and dependent care: cdcc_qualifying_childcare_expenses holds the expense rule, and the single-parent work requirement reform and California's expenses read it. - References: Georgia HB 136 page 3; one entry per recovery rebate statute; quote IRC 24(h)(4)(A) exactly in the test comment. - Tests: dependent students, the two rebate cases, the reform and California expenses, and the Hawaii, Wisconsin and Treasury reforms with a claimable filer under both labellings. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Education credits: is_barred_from_education_credits_by_dependency holds the claimed-filer and dependent-student rules; both eligibility formulas and the reconciliation SSN reform's Lifetime Learning Credit read it, so the reform no longer turns a barred student's tuition into that credit. - Child and dependent care: childcare counts when any child under 18 is still a qualifying individual, so an incapacitated child aged 13 to 17 keeps it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Setting meets_eitc_identification_requirements on one person made it an input for every person, so the other spouse lost their SSN too. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Contributor
Author
Hand-off to the US + core hub
Pending (not mine to do):
Follow-ups: listed in #10087 under "Follow-ups"; the hub holds the regional state PRs stacked on the federal branch. Session |
This was referenced Oct 11, 2026
Draft
MaxGhenis
added a commit
that referenced
this pull request
Oct 11, 2026
…anch The federal branch (#10087) now separates whether another taxpayer can claim a filer (`claimable_as_dependent_on_another_return`) from an actual claim (`claimed_as_dependent_on_another_return`), and adds the Publication 501 filing exception for the Dependent Taxpayer Test (`head_or_spouse_is_dependent_elsewhere_without_filing_exception`). - Rules that a return has no dependents (IRC 152(b)(1)) and the childless EITC bar read the filing-exception helper, as the federal formulas do. - Rules that turn on an actual claim read the claim input: Illinois' 2022 rebate (sec. 212.1, "who is claimed") and Georgia's HB 162 refund ("who was claimed"). - Rules that turn on being claimable read claimability: Georgia's low income credit ("claimed or ... eligible to be claimed") and Idaho's food tax credit ("can claim you"). DC Schedule H's "was a dependent" reads the person-level filing-exception helper. - New cases for a filer who can be claimed but is not, and for the filing exception. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
MaxGhenis
added a commit
that referenced
this pull request
Oct 11, 2026
…anch The federal branch (#10087) now separates whether another taxpayer can claim a filer (`claimable_as_dependent_on_another_return`) from an actual claim (`claimed_as_dependent_on_another_return`), and adds the Publication 501 filing exception for the Dependent Taxpayer Test (`head_or_spouse_is_dependent_elsewhere_without_filing_exception`). - Rules that a return has no dependents (IRC 152(b)(1)) and the childless EITC bar read the filing-exception helper, as the federal formulas do. - Rules that turn on an actual claim read the claim input: Illinois' 2022 rebate (sec. 212.1, "who is claimed") and Georgia's HB 162 refund ("who was claimed"). - Rules that turn on being claimable read claimability: Georgia's low income credit ("claimed or ... eligible to be claimed") and Idaho's food tax credit ("can claim you"). DC Schedule H's "was a dependent" reads the person-level filing-exception helper. - New cases for a filer who can be claimed but is not, and for the filing exception. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This was referenced Oct 11, 2026
Draft
This branch has not been deployed
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.
Summary
A filer who can be claimed as a dependent on another return is treated as having no dependents (unless the would-be claimant meets the filing exception below), has no personal exemption, and on a joint return either spouse being claimable has the same effect on the couple's dependents (IRS Publication 501, Dependent Taxpayer Test: "If you are filing a joint return and your spouse can be claimed as a dependent by another taxpayer, you and your spouse can't claim any dependents on your joint return"). The model has an input for this, but no formula below read it, so such a return kept its child tax credit, its child care credit for young children, its full exemption count, and its education credits.
Stacked on #10024 (which makes the existing readers label-free and adds the inputs and helpers used here). Base this PR on
head-dependent-elsewhere-swapuntil #10024 merges.#10024 gives the model three separate facts about a filer, and this stack reads the one each rule turns on:
claimed_as_dependent_on_another_returnclaimable_as_dependent_on_another_return(defaults to the input above)dependent_claimant_filing_exception, throughhead_or_spouse_is_dependent_elsewhere_without_filing_exceptionexemptions_count, ARPA dependentsctc_qualifying_child,ctc_adult_individual_maximumis_cdcc_eligible,cdcc_qualifying_childcare_expenses(new),cdcc_relevant_expensesca_cdcc_relevant_expensesread the same expense ruleexemptions_countrrc_adult_count_with_valid_ssn,rrc_arpa_dependents_with_valid_ssn,rrc_cares,rrc_caa,rrc_arpa(2020-2021 rebates)tuition_and_fees_deduction_eligible(repealed for 2021 on)is_barred_from_education_credits_by_dependency(new),is_eligible_for_american_opportunity_credit,is_eligible_for_lifetime_learning_creditstudent_loan_interest_ald_eligibleState readers of the corrected
exemptions_count, each checked against its own law:ri_exemptionsnm_low_and_middle_income_exemption,nm_low_income_comprehensive_tax_rebate_exemptionshi_regular_exemptionshi_food_excise_exemption_amount,hi_act_115_rebate,hi_low_income_household_renters_tax_creditde_personal_credit_potential,de_personal_credit_indvde_personal_credit_indvfor a return without a spouse now includes the dependents' credits ($220 for one filer and one child; it was $110). Only married couples use that column path (de_files_separately), so this does not change a single filer's taxoh_exemption_credit_potential,oh_personal_exemptions_eligible_personor_regular_exemptionswi_base_exemptionga_low_income_credit_potential,ga_ctc_potentialtax_unit_sizeand a newga_ctc_eligible_child(the IRC 24(c) child test), which the contributed refundable-credit and SB 520 reforms now share; Georgia's own claimable-filer rule is in #10050The Hawaii and Wisconsin dependent-exemption reforms and the Treasury dependent-exemption repeal reform, which recomputed the personal count from
exemptions_count, now use the filers' own exemptions so they stay consistent. The contributed state dependent-exemption repeal reform (repeal_state_dependent_exemptions) is not fixed here: its overrides still give a claimable filer their own exemption. A separate branch (repeal-state-dep-exemptions-claimable-filer) is changing them; that work is pending and must read the "can be claimed" input.Other readers that inherit the gated CTC child test are correct under their own law: North Carolina's child deduction and credit ("for whom the taxpayer is allowed the federal tax credit", G.S. 105-153.5), Utah's credit, Idaho's credit, New York's 2021-2024 Empire State child credit ("claimed as a dependent on your federal income tax return", IT-213), and Maine's fairness credits ("eligible to claim the federal child tax credit"). New York's 2025-2026 child credit uses its own child definition and is unchanged.
Not changed, deliberately: head of household and surviving-spouse status (Pub. 501 keeps both for a claimable filer in most routes; the remaining routes need their own change), the medical expense deduction (IRC 213(a) disregards 152(b)(1)), and the EITC (its childless gate is in #10024).
Known limits of the inputs
Readings for Max (queue via the US + core hub)
Invariants
These hold for every input:
ctc_maximum,ctc_qualifying_children,capped_count_cdcc_eligible,cdcc_relevant_expenses,exemptions_count,rrc_arpaor the state amounts that read the exemption count.exemptions_count=head_spouse_count_not_dependent_elsewhere+ (dependents, unless a filer is claimable outside the filing exception).de_personal_credit_indvfor a return without a spouse (see the Delaware row), and the Hawaii renters credit, which no longer counts a dependent who can be claimed elsewhere (two filers and such a child get $100, not $150). Georgia is unchanged in every case. The microsimulation below checks this on the default dataset, where nobody can be claimed.Tests
35a2cbcbb9: the changed YAML files and the test folders next to every changed variable (234 files): 1,452 passed, 0 failed.policyengine_us/tests/core/test_claimable_filer_federal_invariants.py(reusing Make rules for a filer claimed elsewhere independent of which spouse is labelled head #10024's household builders) in Texas, the seven states that read the federal count, and Georgia (which keeps its own count, as a control) for 2021-2026. Hypothesis batches check invariants 1, 3 and 4; a seeded population checks 1-4. Its outputs are the federal amounts above and the state amounts that read the exemption count. The population sets the "is claimed" input (so "can be claimed" follows it) and never the filing exception; the identities assume that. The generated adults have no tuition or student loan interest. So the filing exception, a filer who can be claimed but is not, the education credit, tuition deduction, student loan interest and the reforms are covered by YAML only. 7 tests passed, 0 failed, in 50 s with a peak memory footprint of 2.6 GB (/usr/bin/time -l).Microsimulation impact
Real microsimulations on the default dataset (
hf://datasets/policyengine/populace-us/populace_us_2024.h5@populace-us-2024-spm-20260909) for 2025 and 2026, compared record by record. In that dataset no person can be claimed as a dependent on another return (claimable_as_dependent_on_another_returnis true for 0 of 166,321 people), so every rule gated on it is inactive there; the runs check that nothing else moves.#10024's head (
c7f969f872) against this branch (35a2cbcbb9), 81 variables (federal and state income tax, household net income, and every credit, deduction and count changed here):Follow-ups (separate tasks)
Left for separate changes so this PR stays reviewable:
head_spouse_count.Axiom parity
axiom: us/statutes/26/24 + us/statutes/26/24/h + us/statutes/26/152 queued (F1: TheAxiomFoundation/rulespec-us#1684) | us/statutes/26/21 queued (F1: TheAxiomFoundation/rulespec-us#1684) | us/statutes/26/151 queued (F1: TheAxiomFoundation/rulespec-us#1684) | IRC 6428, 6428A, 6428B n/a: historical 2020–2021 provisions, no Axiom module found, final corrections recorded in F1 limits outside rebate encoding scope | us/statutes/26/25A queued (F1: TheAxiomFoundation/rulespec-us#1684) | us/statutes/26/221 queued (F1: TheAxiomFoundation/rulespec-us#1684) | IRC 222(c)(3) queued (F1: TheAxiomFoundation/rulespec-us#1684) | us-ri/statutes/44-30-2.6 + us-ri/policies/income_tax/resident_core_liability_pipeline queued (RI1: TheAxiomFoundation/rulespec-us#1691) | us-de/statutes/30/1110 queued (DE1: TheAxiomFoundation/rulespec-us#1683) | us-oh/statutes/5747/025 + us-oh/statutes/5747/022 queued (OH1: TheAxiomFoundation/rulespec-us#1689) | us-wi/statutes/71/05/23 + us-wi/policies/income_tax/2026_full_year_resident_core queued (WI1: TheAxiomFoundation/rulespec-us#1693) | us-or/statutes/316/085 queued (OR1: TheAxiomFoundation/rulespec-us#1690) | us-hi/statutes/235-54 queued (HI1: TheAxiomFoundation/rulespec-us#1685) | us-hi/statutes/235-55/85 queued (HI1: TheAxiomFoundation/rulespec-us#1685) | Act 115 (SLH 2022), §3 queued (HI1: TheAxiomFoundation/rulespec-us#1685) | us-hi/statutes/235-55/7 queued (HI1: TheAxiomFoundation/rulespec-us#1685) | us-nm/statutes/7-2-14 + us-nm/statutes/7-2-5/8 queued (NM1: TheAxiomFoundation/rulespec-us#1687) | contributed exemption reforms n/a: PE-only reform implementation, added tests preserve the eligibility contract, no corresponding Axiom reform module found | us-ga/statutes/48/48-7A-3 n/a: this branch only decouples its state count from the federal count; substantive Georgia eligibility is outside this stack | O.C.G.A. 48-7-29.27(a), IRC 24(c) n/a: this branch preserves Georgia's child-definition boundary through predicate decoupling; no Georgia CTC module found and substantive filer eligibility remains outside this stack | Hawaii mixed-spouse disability amount not filed: official sources conflict, see TheAxiomFoundation/rulespec-us#1685 | general no-return-required exception not filed beyond the single-filer case: see TheAxiomFoundation/rulespec-us#1684
Every
queueditem is ape-parityissue filed in TheAxiomFoundation/rulespec-us on 2026-10-12 (verbatim law, required outputs, review finding, companion tests).🤖 Generated with Claude Code