Skip to content

Record Louisiana's claimable-filer dependent exemption reading - #10833

Merged
MaxGhenis merged 9 commits into
mainfrom
record-la-dependent-exemption-reading
Nov 16, 2026
Merged

MaxGhenis merged 9 commits into
mainfrom
record-la-dependent-exemption-reading

Conversation

@MaxGhenis

@MaxGhenis MaxGhenis commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Record Louisiana's 2021–2024 exemption treatment for claimable filers whose would-be claimants meet the refund-only filing exception. Preserve the formulas and parameters, and document the competing readings in a candidate that awaits project-lead confirmation.

In pre-2025 R.S. 47:294, the legislature required filers to claim the same exemptions as on their federal return. Congress zeroed a claimable individual's exemption amount in 26 U.S.C. 151(d)(2). Under one reading, claimable filers allocate the child's exemption to subsection A before claiming any additional amount under B. Under the reading the model retains, filers distinguish exemption counts from amounts and retain their own exemption for A.

In its 2021, 2022, 2023 and 2024 instructions, LDR requires the federal number of exemptions unless “you are listed as a dependent on someone else’s return” or another listed condition applies. LDR also tells each filer to claim an exemption for themselves on Line 6A, even when someone else claimed them, and to list on Line 6C the dependents claimed on their federal return.

LDR builds $4,500 plus $1,000 per exemption over one into the single-filer tables for 2022, 2023 and 2024. LDR quotes the pre-2025 personal and dependent amounts, including those used for the 2021 case, in Revenue Ruling 18-001, page 2. LDR states its ruling on page 4. LDR distinguishes exemption counts from amounts under section 151(d)(5) without addressing section 151(d)(2) or this filer class.

For example, the IRS lets a claimable single filer claim a child as a dependent when the would-be claimant files only for a refund (Publication 501). Under the retained reading, a single filer with one child counts (1 + 1 − 1) × $1,000 = $1,000 for the child. Adding $4,500 personal, $0 blind and $0 aged exemptions gives $5,500. Under the competing reading, the child's exemption fills subsection A, and the filer's exemptions total $4,500.

Add complete captures of the eight cited LDR pages under source_conflicts/sources/us-la/, each headed by its URL, page, extraction method and PDF hash. Keep interpretation in the candidate note, and cite each year's sources in the YAML cases.

Invariants and validation

  • A claimable filer receives no dependent exemption without the claimant filing exception. With the exception, the filer receives $1,000 per dependent throughout 2021–2024.
  • Dependent exemptions stay between zero and $1,000 times the dependent count. Each added dependent adds $1,000, except on a return with a claimable filer whose claimant doesn't meet the filing exception, where it adds nothing.
  • Claimability leaves the filing-status personal amount unchanged. Without blind or aged allowances, total exemptions equal personal plus dependent exemptions.
  • Joint-spouse cases preserve main's treatment by analogy with the head. The cited Louisiana instructions do not directly resolve the claimable spouse's Line 6B exemption.
  • Source captures retain complete, unedited page text; regression checks reject missing extraction metadata and altered page text.

This PR adds 4 composition YAML cases, 4 invariant cases and 9 capture checks, and leaves the 10 existing dependent-exemption YAML cases unchanged.

The invariant matrix compares 85 households per year across all five filing statuses, zero through four dependents, and the claimability and filing-exception variants.

Pull request run 43771332855 at 127ad4403a passed all 38 jobs on GitHub's merge with main f77af2899d.

Methodology choices

  • Retain main's agency tie-break treatment while the question stays open. Record it in source_conflicts/candidates.yaml as us-la:dependent-exemption-of-a-claimable-filer-with-filing-exception, with state unreviewed until the project lead confirms a reading. No cited LDR ruling or court holding resolves this class.
  • Start coverage in 2021 because that year supplies the earliest cited instructions. This scope does not establish when the statute first applied.
  • End coverage in 2024 because the legislature applied the replacement from 2025 under Act 11, section 6.
  • Preserve the joint-spouse amount by analogy; do not present it as an express LDR allocation.
  • Capture Revenue Ruling 18-001 page 2 for the historical statute, avoiding Act 11's strikethrough extraction ambiguity.
  • Quote the words of LDR's exception that all four years' instructions share. LDR introduces its list of conditions with “unless:” in 2021–2023 and “unless the following apply:” in 2024.
  • Parametrize the household matrix by year, with fixed ages under 65. With dependency roles and filing status fixed, ages below 65 do not affect these exemption outputs.
  • Defer deciding-line markers until the shared register holds the entry, following CONTRIBUTING.md. The candidate has no shared-register entry yet.

In Buras/Milner, the Louisiana Board of Tax Appeals addresses mixed-residency spouses' filing status. The Board does not resolve this exemption question.

Source PDF hashes

Official document SHA256
Act 11 637e00003a4737a4e5884c20042d8f40e93b10aae808f46270d2e55b0f7d1dcc
2021 IT-540 instructions 777ce4dd542226418b04549bb0d89203889c6c3e87b15e1e5497517b4eb31d37
2022 IT-540 instructions a02c635da8a06257d33a3963883fa54d472536eca8299478f5547e408f1da1b0
2023 IT-540 instructions dea50c5fcfa7530dd535ffc39aeff7a105d7a8f32db27c7c40761717d78df07b
2024 IT-540 instructions b455baa84d406c7f4e6375c652bf7026c710947eb944d66f10b7e67902ed6d1f
2022 tax tables 93f832dafaafffcd4ce0a0dd8f88c6b94d08922cbb0b6171e45359dfbde62d4f
2023 tax tables e183a0b67b92519e1b36ed7bba9ab56a89c5d5bc24d087334efe27fef9e8fa39
Revenue Ruling 18-001 76e5deb1ac6dd7eb6f3f349a8b1c608d7f77df28d0f33d5525dc14235d33171b
26 U.S.C. 151, 2024 edition 5d940a94a55b44244779939e7c47bce83595e16c85ae99a1b02f4a6ecdb5408e
Publication 501, 2024 e94ffe4312d220792b11a7dfe092f9daf782b797a6591f90b521b2a9aa9eb352
Buras/Milner opinion bd3e64de0f68de5d8f2b64160c289cf07c655bfad7fdea2672ff8f88ff32533f

Microsimulation impact

This PR changes no formula, parameter or existing test expectation, so no household's result changes.

Axiom parity

axiom: TheAxiomFoundation/rulespec-us#2289 queued (pre-2025 La. R.S. 47:294(A) and (B) for a claimable filer whose claimant meets the filing exception, 2021–2024; the corpus lacks the pre-2025 text, and the reading awaits project-lead confirmation) | TheAxiomFoundation/rulespec-us#2158 queued (pre-2025 La. R.S. 47:294(B) for the other 2021–2024 returns; this PR leaves its companion cases in la_dependents_exemption.yaml unchanged)

🤖 Generated with Claude Code

MaxGhenis and others added 9 commits November 12, 2026 00:52
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>
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
In its 2021-2024 Lines 6A and 6B instructions, LDR requires the federal
number of exemptions unless someone else's return lists the filer as a
dependent or another listed condition applies. The candidate said LDR
departs from the federal count except for those filers.

Name pre-2025 R.S. 47:294 in the statute reading, cite the 2022-2024
single-filer tables, and replace the note's references to main with
PE-US.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Remove the assertion that two capture file names stay absent. Main
never held either file.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@MaxGhenis

Copy link
Copy Markdown
Contributor Author

US + core hub merge audit, us#10833 at 127ad4403afca7f103be4f7eafdb2951a5210677 (squash): Record Louisiana's claimable-filer dependent exemption reading.

  • Reviews:
    • The PR has no GitHub reviews. Three independent review rounds ran outside GitHub, with a fix round after each of the first two.
    • The first round, at 6180a02257, read Act 11 of the 2024 Third Extraordinary Session, the 2021 to 2024 IT-540 instructions and the 2022 and 2023 tax tables. It also read Revenue Ruling 18-001, 26 U.S.C. 151, Publication 501 (2024), a Board of Tax Appeals opinion and the current section 47:294. It ran the new YAML and property tests and the source-conflict guard, and all passed. It ran 8 households on the head and on the merge base 935b24ff4f, and got identical outputs. A mutant that applied the competing reading failed all 4 YAML cases and all 4 property cases, with 24 of 85 rows per year differing.
    • It found that the two new source captures held word fragments and the author's own commentary, where source_conflicts/sources/README.md asks for official page text. It also listed eight minor findings. The readings left out the textual hinge on each side, and the property test extended the reading to a joint spouse without a source. The years started in 2021 with no stated reason, and the Revenue Ruling citation stopped at page 3, though the ruling sits on page 4. The entry's state, ruled, named no source for a ruling. The 2021 to 2023 cases relied on table wording cited only for 2024, the changelog fragment said fixed, and the property test drew only ages that no output depends on.
    • The first fix round, through e04fad5ad4, replaced the two files with complete captures of eight LDR pages. Each capture opens with its URL, page, extraction method and PDF hash, and the new test_la_source_captures.py checks them. The round moved interpretation into the candidate's note, named the statute's introductory clause and section 151(d)(2), and quoted LDR's exception. It labeled the joint spouse an analogy, explained the 2021 start, cited pages 1 to 4 and set the state to unreviewed. It also cited the 2022 and 2023 tables, renamed the fragment .added.md and parametrized the property test by year.
    • The second round, at e04fad5ad4, fetched the official PDFs again. Each capture matched pdftotext output for its page byte for byte, and every hash matched the description. That fix round left no logs, so the reviewer checked each claim it reported against the code and the arithmetic. A three-way merge of candidates.yaml with main came out clean. This round ran no tests.
    • It found that the candidate's agency reading reversed LDR's exception. LDR keeps the federal count unless someone else's return lists the filer as a dependent, and the entry said the reverse. It also listed three minor findings: a misplaced clause in the statute reading, a note that referred to "main", and a capture-test assertion about files that existed only on the branch.
    • The second fix round merged main at f77af2899d in 778b45b23a, which keeps main's 482 register entries and this PR's one, 483 unique ids. In ab478ebe3c it rewrote the agency reading from the four captures and fixed the clause and the note. In 127ad4403a it removed the branch-only assertion and kept the header and hash checks. A check of that round's report against the code found no wrong value, lost case or failing check.
    • The third round approved 127ad4403a with no blocking finding. It accounted for every commit in the range and confirmed that the merge kept both sides' register entries. It found the Louisiana formulas, parameters, captures, expected values and invariant assertions unchanged, and the role-inference changes the merge brought in leave the supplied household roles alone. git merge-tree against main at aead96b524 found no conflict, and CI's 38 checks at the head succeeded. Its one finding, a P3, asked for the CI result in the description.
    • The first two rounds listed corrections to the description. The fix rounds made each except the impact line and the CI result, which I added before merge, and I made more corrections against the head. The description now says the Line 6A instruction covers every filer, gives the competing reading's $4,500 total and stops calling the retained reading "the alternative". It limits the $1,000-per-dependent invariant to returns that the claimability gate doesn't block. It drops two mutant results that no review ran at this head, names the open candidate under Methodology choices and gives the CI result. Its axiom: line adds the new parity issue.
  • Methodology choices for maintainers:
    • The PR keeps main's agency tie-break reading and records the question as the open candidate us-la:dependent-exemption-of-a-claimable-filer-with-filing-exception. Its state stays unreviewed until the project lead confirms a reading. Pre-2025 R.S. 47:294 required the same exemptions as on the federal return, and section 151(d)(2) sets a claimable filer's exemption amount to zero. LDR's 2021 to 2024 instructions count the filer on Line 6A even when someone else claimed them, and federal dependents on Line 6C. For a single filer with one child, the retained reading gives $1,000 for the child and $5,500 in all. Under the competing reading, the child's exemption fills subsection (A), for $4,500 in all. No cited LDR ruling or court holding resolves this class, and Revenue Ruling 18-001 doesn't address section 151(d)(2).
    • A claimable spouse on a joint return follows the head by analogy, at $9,000 plus $1,000 per dependent. The cited instructions don't say whether that spouse counts on Line 6B. If the spouse doesn't count, a return with a dependent loses $1,000 of dependent exemption. The property test's joint-spouse rows pin the analogy, and no YAML case does.
    • Coverage starts in 2021, the year of the earliest instructions the PR cites, and ends in 2024, since section 6 of Act 11 applies the replacement from 2025. The model gives the same $5,500 in 2020, and no claimable-filer case pins an earlier year.
    • The PR captures Revenue Ruling 18-001, page 2, which quotes the pre-2025 section, in place of Act 11, page 7, where pdftotext merges struck and added words.
    • The PR adds no deciding-line marker, since CONTRIBUTING.md adds markers after the shared register holds the entry.
  • Gates checked live at merge:
    • gh pr checks exits 0;
    • the latest Pull request run at the head, 43771332855, passed and tested this head merged into main at f77af2899d;
    • MERGEABLE;
    • not a draft;
    • no reviewer's latest review requests changes;
    • the semantic-overlap guard: since f77af2899d, main has changed no area this PR touches. This head merged main at f77af2899d. Between f77af2899d and main at aead96b524, main changed 57 files in 33 commits, none of this PR's 13 files and nothing under states/la or source_conflicts. Build omitted household marital units from explicit couples and the tax-role fallback #10000 builds marital units that a situation omits and edits comments in is_tax_unit_head and is_tax_unit_spouse. No Louisiana exemption formula reads marital units, and every new case and matrix row sets roles and filing status as inputs. The branch merges into main at aead96b524 without conflict;
    • the merge pins the head.
  • Impact: This PR changes no formula, parameter or existing test expectation, so no household's result changes.
  • Next:
    • The candidate needs a reading from the project lead and then its entry in the rulespec-us register, pinned to this squash. A follow-up PR then marks the deciding lines, refreshes the pin and deletes the candidate.
    • A register excerpt from these captures needs whitespace normalization in rulespec-us verify. On each of the four captured instruction pages, LDR's exception and the Line 6C phrase break across a line.
    • Nobody has run the competing-reading mutant or a capture mutant at 127ad4403a. The first should fail all 4 property cases and all 4 YAML cases, and the second 2 of the 9 capture checks.
    • rulespec-us#2158 and the new parity issue target the same pre-2025 version of us-la/statutes/47:294.yaml, so the encoder should take them together.
  • Axiom: Encode Louisiana's 2021-2024 exemptions for a claimable filer whose would-be claimant files only for a refund (pre-2025 La. R.S. 47:294(A) and (B); IRC 151(d)(2)) (PE-US #10833) TheAxiomFoundation/rulespec-us#2289 queued, a new pe-parity issue for pre-2025 R.S. 47:294(A) and (B) and 26 U.S.C. 151(d)(2), with companion rows from this PR's YAML. It covers single and separate returns from 2021 to 2024 where someone else can claim the filer and the would-be claimant files only for a refund. The signed encoder can't run yet: the corpus holds no pre-2025 text of section 47:294, and the reading awaits project-lead confirmation. [pe-parity] LA2: apply IRC 152(b)(1) to Louisiana's 2021-2024 dependent exemption (R.S. 47:294(B)) TheAxiomFoundation/rulespec-us#2158 stays queued as filed, since this PR leaves la_dependents_exemption.yaml, the source of its rows, unchanged.

🤖 Generated with Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant