Repository navigation
Add Arkansas's claim of right deduction (Ark. Code § 26-51-457) - #10203
Conversation
G.S. 105-153.5(a)(2)d, added by S.L. 2016-5 for 2014 and later, lets North Carolina itemizers deduct repayments of income included in AGI in an earlier year under a claim of right (Form D-400 Schedule A line 8). Repayments above $3,000 are deductible in full; smaller ones are reduced by 2% of federal AGI less other miscellaneous itemized deductions, which the 2016 and 2025 NCDOR worksheets both reproduce. PE had no input for these repayments, so it adds claim_of_right_repayment (person level; only the head's and spouse's count) and moves North Carolina's uncapped itemized items into a parameter list. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…C taxed Review r1 (subfleet 20261009-090558-nc-itemized-review): - S.L. 2026-31 section 1.8 rewrites G.S. 105-153.5(a)(2)d for taxable years beginning on or after January 1, 2026: the repaid amount must have been included in AGI "as modified in G.S. 105-153.5 and G.S. 105-153.6" in the earlier year. New person input nc_claim_of_right_repayment_excluded_from_income (the part NC deducted when received, such as repaid Social Security) and a dated parameter apply it. - Count only the head's and spouse's other miscellaneous expenses against the pre-2018 floor; a dependent's are on the dependent's return. - The property grid now varies property taxes (so the $20,000 cap binds) and adds a 2026 grid for the excluded part. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…h Carolina's 1341(a)(5) bar and G.S. 105-266.2 payment (WIP) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…es that exclude them (AZ, KS, WI, MO, OR, VA); property tests Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…fragment Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…to keep it at two seconds Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…urn-level prior-year inputs, California and Montana flows - The branches that fix the claim of right method start from inputs only, and the itemization branches settle the method in the parent first, so a tax liability calculated before the method is known cannot leak into them. - Ties are compared to the cent, so a one-cent difference picks the credit. - The prior-year federal decrease and NC increase are return-level inputs defined on chapter 1 and Article 4 tax. - California leaves out the federal deduction (Schedule CA Part II line 16); Montana deducts it through 2023 (Form 2 itemized line 18). - Section 67(g) is now 67(h); document the Arizona and NC coverage limits. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Review r2 found that with itemization branching off, tax_liability_if_not_itemizing used the parent's method when calculated first but chose its own after income_tax. The itemizing branches now take the method as an input. A branch keeps its parent's cache when an override equals the value the parent already holds, so ordinary simulations still share it. Adds the review's Texas household as an order test under both itemization settings. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… branches only when someone qualifies Review r3 showed that keeping a parent's cache when an override equals the parent's current value can reuse tax calculated before another input changed. Branches again drop inherited values whenever the parent knows an overridden variable. The itemizing branches add the claim of right method as an override only when some tax unit repays more than $3,000, so simulations without a qualifying repayment keep sharing the parent's cache. Adds the review's stale-parent sequence as a test. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…th use tax Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…eral credit Reviews of #10195, #10196 and #10198 found that reading own-rule states from variable names weakened the cross-state test: North Carolina and Montana lost their exact check, nothing asserted that a state's own relief actually lowered its tax, and any future <state>_claim_of_right_ input would exempt a state. Now an explicit, sourced map names each state whose relief applies under the federal credit method and the variable that carries it. Under that method each listed state whose variable is in the model must lower the household's tax by more than $1, and every other state's tax must not change. The same commit is on every state branch, so they still merge in any order. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Act 1284 of 2013 adopts 26 U.S.C. § 1341(a)(1)-(3) but not the federal choice of a credit, and allows "a deduction in the tax year the taxpayer restores the amount". A repayment over $3,000 of income Arkansas taxed is now an itemized deduction whichever federal method applies. Ark. Code § 26-51-437(b) does not list it among the deductions that are not miscellaneous, so it joins a new list of the miscellaneous pool that the 2% floor applies to (statute reading; decision d1477 may move it outside). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Resolves the add/add conflicts with #10028's squash (557b539) by keeping this branch's 26 U.S.C. 1341(a)(5) bar on the North Carolina deduction, its added NC cases and the method fixture in the NC property grid, and keeps both sides' Arizona itemized deduction cases. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…repayments are unresolved Review r1 of #10203: case 5 could not tell whether the exclusion reduces the deduction or only the threshold test. New case 6 repays $10,000 with $2,000 never taxed and expects $8,000. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…rom 2024 From 2024 Montana Form 2 line 2 takes the federal itemized deductions (2024 instructions, Worksheet A line 1: Form 1040 line 12), which include Schedule A line 16. The miscellaneous list was empty from 2024, so a Montana itemizer lost the federal claim of right deduction. Review r5b (P3-1) found it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…anch Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
Hand-off to the US + core hub (Arkansas; state claim of right lane, session local_d0c92ac9).
|
|
Update to the hand-off (2026-10-14): main moved, and this PR conflicts in two places.
#10196, #10198, #10195 and #10200 have only the inherited conflict. |
Resolves the conflict in ar_misc_deduction_joint.py with main's #9585: the miscellaneous pool keeps this branch's sources list, and Arkansas AGI keeps main's floor at zero. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
Hand-off update (2026-10-14): new head |
Conflicts resolved: - Wisconsin itemized deduction credit: keep main's explicit Schedule 1 component list (#10311) and add claim_of_right_deduction to it, so the section 1341 repayment stays in the credit base as this PR intends under Wis. Stat. 71.07(5)(a)6-7. - Alabama and Wisconsin YAML tests: keep both sides' cases. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… 2025 The 2024 Form 2 Worksheet A reduces the federal deduction by the capped state-income-tax addback before line 3's zero floor. The 2025 form stops adjusting line 2 and reports the addback on Schedule I line 4, a Montana addition after the floor, as MCA 15-30-2120(1) treats the (2)(j) item alongside the other additions. A new boolean parameter is true in 2024 and false from 2025 (2026 follows the 2025 form by convention), and both mt_taxable_income_joint and mt_federal_deductions read it. Adds 2025 and 2026 YAML witnesses (the review's AGI 10,000 / itemized 20,000 household gives 4,250 in 2025), keeps the 2024 pre-floor witnesses, limits the property test to 2024, and points the misc_deductions comment at mt_taxable_income_joint, which is what reads the federal base. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Ala. Admin. Code r. 810-3-15-.20(1)(d)2 subtracts all credits shown as payments on the federal return, and its current text dates from a 2010 amendment, so it governs every year the parameter covers, not only 2021 on. The legacy pre-2021 list (total AOC, no section 1341 credit or net PTC) is dropped, and the 2020 case that pinned it now expects 5,000 - 1,000 - 1,500 - 1,000 - 750 = 750. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
main's backlog still described the code before this PR: AL, MO and WI as following the worksheets and OR as unknown. The head follows the statute or regulation in all four, so set pe_us.follows to statute and state to ruled, replace the notes that said a model change was still needed, start AL's years in 2015 (the corrected credit list now applies from the parameter's first year), and cite ORS 316.685(1)(b), the EITC-only disregard the OR code follows. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The 2017 Montana Form 2 with Legal References now 404s at its original address; cite the Wayback Machine copy of 2024-01-07, whose PDF p. 6 Schedule III lines 25, 26 and 28 the reviewer confirmed. Drop the "2023 HB 109" reference: its URL mixes HB0199 and HB0109, returns 404, and what it was meant to support could not be confirmed; MCA 15-30-2120 is already cited for the deduction. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Both cases set claim_of_right_credit as an input that neither formula reads, so they only checked that income_tax passes through. They now use the federal integration case 4 household (2025, $40,000 wages, $10,000 repayment, $2,200 prior-year decrease), where the credit method wins and flows through income_tax: 2,671.50 - 2,200 = 471.50. Missouri deducts 25% x 471.50 = 117.875 and Oregon subtracts 471.50. Adding the credit back in either formula fails its case. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
main's #10186 made the 2020 itemization choice compare two branches with different AGI (the 2020 above-the-line charitable deduction), and no invariant in this file ran on that path. Add 2020 to YEARS (last, so the tests that read YEARS[0] and YEARS[1] keep 2025 and 2026) and run the calculation-order test in 2020 as well. Every existing assertion is kept; all 58 tests pass. Locally the file went from 182 s to 220 s and its peak RSS from 3.2 GB to 3.5 GB. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The claim-of-right fragment described the Montana work as repayment treatment, but from 2024 every Montana filer's taxable income now starts from the federal base (all six mt_taxable_income_joint cases changed), and every Alabama AOC claimant now subtracts only the refundable part. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…6 case The old 2025 case supplied a positive QBI deduction at a binding floor, which the model can't produce before 2026. From 2026 the 199A(i) $400 minimum can exceed taxable income, so a derived household now pins the order: MCA 15-30-2101(22) and 15-30-2120(2)(i) add the deduction back to federal taxable income before Form 2's line 7 floor, giving 0, not 400. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LwQq6JfLQkf8A2aNSw51a4
Once #10093 nets the premium tax credit in Oregon's subtraction, this household's modeled credit would zero the subtraction. Pinning it keeps the case isolating the section 1341 credit at 471.50. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LwQq6JfLQkf8A2aNSw51a4
YEARS is (2024,), so the Schedule 1-A draw and the year >= 2025 branches never ran; YAML cases cover 2025 and 2026. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LwQq6JfLQkf8A2aNSw51a4
mt_taxable_income_joint computes its own deduction term from taxable_income_deductions, which also holds the QBI deduction and the Schedule 1-A deductions, so the two differ (e.g. 15,750 against 21,750 in the 2025 tip case) and the formula can't read this variable. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LwQq6JfLQkf8A2aNSw51a4
The code applies the regulation's list from 2015, but worksheets before 2018 went unchecked, so the item can't claim a conflict for 2015-2017. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LwQq6JfLQkf8A2aNSw51a4
The comment argued from federal taxable income having no floor, which would also remove the line 3 floor the code keeps for Montana's other additions. The order follows the form: line 2 leaves the QBI deduction out, and line 3 floors line 1 minus line 2 at zero. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LwQq6K4hbmpvP2YevFmELw
Main removed gov.household.household_refundable_credits and gov.household.household_tax_before_refundable_credits, which no formula read after it dropped the abolish-tax structural reforms. This branch had added North Carolina to both. The merge keeps the removal; this branch's North Carolina entries stay in gov.household.household_refundable_state_credits and the gov.states.household lists. Main's new North Carolina use tax case under the payroll tax repeal enters nc_income_tax, which this branch's state list no longer reads: the list now counts North Carolina tax before refundable credits. The case now enters nc_income_tax_before_refundable_credits, and its totals stay at 1,020. 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>
#10094 also adds an entry to source_conflicts/candidates.yaml. Git merges the two cleanly, and the merged register keeps unique ids. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The shared property test keeps main's two-state deduction list and its Alabama, Missouri and Oregon case, and this branch's relief-state map. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Main carries the federal section 1341 work, so its changelog fragments leave this branch. The Oregon files and the candidate list follow main. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## main #10203 +/- ##
=========================================
Coverage 100.00% 100.00%
=========================================
Files 1 4 +3
Lines 37 56 +19
=========================================
+ Hits 37 56 +19
Flags with carried forward coverage won't be shown. Click here to find out more. ☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
The backlog items now give the code and the readings this PR takes. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
David, 7d826f3 resolves each item:
- Should 1: the description's Axiom section carries the queued line for rulespec-us#1797.
- Suggestion 1: the household table now shows the amounts with the tax table bands and rounding ($1,795 to $1,550, and $2,669 to $2,361).
- Suggestion 2: "Placement under the 2% floor" gives Act 708 of 1991, Act 1452 of 2013 and DFA's 2018 catalogue.
- Suggestion 3: case 12 of
ar_claim_of_right_deduction.yamlasserts the separate-filing path with your amounts ($8,400, then $6,300 and $2,100). - Suggestion 4 (optional): each state keeps its own input, as North Carolina's merged rule does.
- The California item from #10038:
maincarries that fix, and this branch includes it.
|
Merging at
|
Summary
Since 2013 Arkansas has allowed a deduction, in the year of repayment, for restoring more than $3,000 of income taxed in an earlier year under a claim of right (Ark. Code § 26-51-457). It adopts 26 U.S.C. § 1341(a)(1)-(3) but not the federal choice of a credit, so the deduction applies whichever federal method governs. PolicyEngine had none of this, so a repayment changed nothing in Arkansas. This PR adds it as an itemized deduction that counts toward the 2% floor on miscellaneous itemized deductions.
ar_claim_of_right_deduction(tax unit): the head's and spouse's repayments of income Arkansas taxed, when their total exceedsgov.states.ar.tax.income.deductions.itemized.claim_of_right.threshold($3,000 from 2013).ar_claim_of_right_repayment_excluded_from_income(person input): the part ofclaim_of_right_repaymentthat Arkansas left out of gross income when received.gov.states.ar.tax.income.deductions.itemized.misc.sources(total_misc_deductions, plus the new deduction from 2013), whichar_misc_deduction_jointandar_misc_deduction_indivadd before applying the 2% floor.The law
Placement under the 2% floor
No DFA form, instruction or rule names the deduction or a line for it. DFA's 2018 tax-exemption catalogue, PDF p. 13 lists the deduction separately under § 26-51-457 and doesn't address the floor. The 2025 AR3 has an open "list type and amount" line both inside the floor (line 21) and outside it (line 28). The model puts the deduction inside the floor, following § 26-51-437(b), whose list has no exception for § 26-51-457. The legislature has written express exceptions elsewhere: Act 708 of 1991, §§ 1 and 3 (PDF pp. 1–2) grants the disabled-child deduction in addition to other deductions, then excludes it from § 26-51-437's miscellaneous itemized deductions.
Two other readings would put it outside the floor. One treats a repayment deductible as a loss as excepted by § 26-51-437(b)(5), which
claim_of_right_repaymentcan't separate from one deductible as an unreimbursed employee expense. The other follows DFA's treatment of the volunteer firefighter deduction, enacted in the same 2013 session and claimed on AR3 line 26, under "Other miscellaneous deductions", outside the 2% limitation (2014 booklet, PDF p. 6; 2014 AR3). Act 1452 of 2013, § 2 (PDF pp. 1–2) allows that deduction in addition to other deductions, and the claim of right provision has no such wording. For a filer with $60,000 of wages who repays $10,000, the placement changes the deduction by $1,200 ($8,800 against $10,000), or about $47 of Arkansas tax at 3.9%.Filers therefore get no benefit unless itemizing beats the standard deduction: with $60,000 of wages and a $3,001 repayment, the $1,801 of miscellaneous deductions falls short of the $2,470 standard deduction.
Design notes
ar_itemized_deductions_indivalready splits itemized deductions by each spouse's share of Arkansas AGI, as AR3 lines 31-35 do. For married filing separately on the same return (status 4), the model tests $3,000 against the couple's combined repayment, matching the one combined AR3 with a floor on combined AGI (line 23).Illinois and Ohio (#10195), Indiana, Massachusetts and West Virginia (#10196), New Jersey (#10198) and Hawaii (#10200) use the same federal input in their own PRs.
Not modeled:
claim_of_right_repaymentexcludes them.policyengine_us/system.py), so the deduction also reaches tax in 2015–2020. We haven't checked those years against each year's law.Household examples (2025, single, age 40)
Arkansas figures include the tax-table bands and rounding.
Tests
gov/states/ar/tax/income/deductions/itemized/claim_of_right/ar_claim_of_right_deduction.yaml, 12 cases, with expected values from the cited sources:ar_misc_deduction_indiv = 8_400after the combined-AGI floor andar_itemized_deductions_indiv = [6_300, 2_100]after the 75% / 25% AGI split.The PR adds no Python test file: YAML exercises the policy rules, and the shared property file checks the state interactions.
Invariants
We ran these with a script outside the repository, which CI doesn't run, over a grid of 192 returns for each of 2021 and 2025. The grid crosses repayments from $0 to $80,000, wages of $20,000 to $150,000, charity of $0 or $20,000, and $0 or $4,000 never taxed by Arkansas, for single filers and for joint filers with a spouse repaying $1,500. The joint spouse has $10,000 of wages, and only the head has income Arkansas never taxed. All four hold in both years, and the deduction stays positive on 108 returns of each grid.
Making the threshold inclusive fails 1 YAML case, gating the deduction on the federal deduction method fails 1, and counting dependents fails 1. Ignoring the Arkansas exclusion fails 2, applying the exclusion only to the threshold test fails 1, and leaving the deduction out of the 2% pool fails 5.
test_claim_of_right_section_1341_properties.pynow holds an explicit, sourced map of the states whose own relief applies under the federal credit method, including Arkansas asar_claim_of_right_deduction. Each listed state whose variable exists must lower the household's tax by more than $1, and every other state stays unchanged, apart from the three that deduct federal tax. #10195, #10196, #10198 and #10200 carry the identical file, so they merge in any order.Microsimulation impact
We estimate no change in 2025. No record in the default dataset carries
claim_of_right_repayment, and the deduction needs a repayment, so no record changes inar_misc_deduction_joint,ar_misc_deduction_indiv,ar_itemized_deductions_indiv,ar_income_tax,state_income_tax,income_taxorhousehold_net_income.Axiom
axiom: TheAxiomFoundation/rulespec-us#1797 queued
rulespec-us has no Arkansas statute modules yet, and the corpus still needs Act 1284 of 2013 ingested for § 26-51-457. The 2% floor placement belongs with TheAxiomFoundation/rulespec-us#1411, which covers § 26-51-437.
impact: none in 2025; no record in the default dataset carries
claim_of_right_repayment🤖 Generated with Claude Code