Update New Jersey 2025 Individual Income Tax Model

[DTrim99]

Summary

• Fixes Update New Jersey 2025 Individual Income Tax Model #7124
• Updates New Jersey income tax parameters with 2025 references
• Adds ANCHOR property tax relief program
• Adds Stay NJ senior property tax reimbursement program

Programs Added

ANCHOR Property Tax Relief

The Affordable New Jersey Communities for Homeowners and Renters (ANCHOR) program provides property tax relief based on income, tenure, and age.

Category	Income Range	Senior (65+)	Non-Senior
Homeowner (Lower)	<= $150,000	$1,750	$1,500
Homeowner (Upper)	$150,001-$250,000	$1,250	$1,000
Renter	<= $150,000	$700	$450

Stay NJ (Effective 2026)

Senior property tax reimbursement program for homeowners age 65+.

Parameter	Value
Benefit Rate	50% of property taxes paid
Maximum Benefit	$6,500
Age Threshold	65+
Income Limit	< $500,000 (strict less than)

Regulatory Authority

• NJ Division of Taxation: https://www.nj.gov/treasury/taxation/
• ANCHOR Program: https://www.nj.gov/treasury/taxation/anchor/
• ANCHOR Benefit Calculation: https://www.nj.gov/treasury/taxation/anchor/calculated.shtml
• Stay NJ: https://www.nj.gov/treasury/taxation/staynj/
• P.L. 2023, c.75 - Stay NJ Act: https://pub.njleg.state.nj.us/Bills/2022/PL23/75_.HTM

Test Coverage

• ANCHOR: 53 tests (eligibility, benefit calculation, integration, edge cases)
• Stay NJ: 49 tests (eligibility, benefit calculation, integration, edge cases)

Files Changed

• 33 NJ income tax parameter files updated with 2025 references
• 10 new ANCHOR parameter files
• 4 new Stay NJ parameter files
• 2 new ANCHOR variable files
• 2 new Stay NJ variable files
• 6 new test files (3 ANCHOR + 3 Stay NJ)

🤖 Generated with Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (fc2b613) to head (0c4b97b).
⚠️ Report is 45 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##              main     #7125   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           10         4    -6     
  Lines          144        74   -70     
=========================================
- Hits           144        74   -70     

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 Sentry.
📢 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: New Jersey 2025 Income Tax Update with ANCHOR and Stay NJ Programs

🟢 No Critical Issues Found

This is a well-implemented PR adding two new property tax relief programs with comprehensive test coverage. All 15 regulatory parameters verified against official sources.

---

Program Verification

ANCHOR Program ✅ All Values Match Official Sources

Parameter	PR Value	Status
Senior Homeowner (≤$150K)	$1,750	✅ Verified
Non-Senior Homeowner (≤$150K)	$1,500	✅ Verified
Senior Homeowner ($150K-$250K)	$1,250	✅ Verified
Non-Senior Homeowner ($150K-$250K)	$1,000	✅ Verified
Senior Renter	$700	✅ Verified
Non-Senior Renter	$450	✅ Verified
Income thresholds	$150K / $250K	✅ Verified
Age threshold	65	✅ Verified

Stay NJ Program ✅ All Values Match Statute (P.L. 2023, c.75)

Parameter	PR Value	Status
Benefit rate	50%	✅ Verified
Maximum benefit (2026)	$6,500	✅ Verified per statute
Age threshold	65	✅ Verified
Income limit	<$500,000	✅ Verified (strict less-than)
Effective date	2026-01-01	✅ Verified

---

🟡 Should Address

1. Label Fix in Tax Rate Schedule Files

The PR fixes several incorrect labels in existing files:

• head_of_household.yaml - Fixed "joint filers" → "head of household filers"
• separate.yaml - Fixed "single filers" → "married filing separately filers"
• surviving_spouse.yaml - Fixed "joint filers" → "surviving spouse filers"

Good catch! These are improvements.

---

🟢 Suggestions

1. Consider Adding Year 2025 Test for Stay NJ

Since Stay NJ begins 2026-01-01, consider adding a test verifying $0 benefit for tax year 2025 to confirm the effective date works correctly.

2. Minor: Income Boundary Test $149,999 for ANCHOR

Tests cover $150,000 exactly and $150,001, but no explicit $149,999 test. Would be nice-to-have.

---

Validation Summary

Check	Result
Regulatory Accuracy	✅ All 15 parameters match official sources
Reference Quality	✅ All parameters have proper references
Code Patterns	✅ No hard-coded values, proper vectorization
Test Coverage	✅ 102 tests (53 ANCHOR + 49 Stay NJ)
CI Status	✅ All checks passing

Code Quality Highlights

• Excellent separation: Eligibility logic in *_eligible variables, benefit logic in main variables
• Proper parameter usage: All policy values from parameters, no hard-coding
• Comprehensive edge cases: Income boundaries, age boundaries, tenure combinations
• Correct income handling: Uses add(tax_unit, period, ["nj_gross_income"]) pattern

Files Changed

• 33 NJ income tax parameters updated with 2025 references
• 10 new ANCHOR parameters + 2 variables
• 4 new Stay NJ parameters + 2 variables
• 6 test files with 102 total test cases

---

Recommendation: Ready for merge. The implementation is thorough and well-tested.

[hua7450]

We should add this to the credit list right?
Not sure if we should apply the same on nj_anchor

[hua7450]

I filed an issue for this, no need to fix it in this PR.