Skip to content

Conversation

@MaxGhenis
Copy link
Contributor

Summary

Moves the Social Security contribution and benefit base (wage cap) from gov.irs.payroll.social_security.cap to gov.ssa.social_security.contribution_and_benefit_base to reflect its statutory location.

Rationale

The wage base is defined in the Social Security Act (42 U.S.C. § 430), not the Internal Revenue Code. Both FICA and SECA reference this single SSA-defined value:

  • 42 U.S.C. § 430 (SSA) - Defines the "contribution and benefit base"
  • 26 U.S.C. § 3121(a)(1) (IRC/FICA) - References the SSA-defined base for payroll taxes
  • 26 U.S.C. § 1402(b)(1) (IRC/SECA) - References the same base for self-employment taxes

Having it under irs/payroll/ was misleading since:

  1. It's not an IRS-defined parameter
  2. It's not payroll-specific (applies equally to self-employment)

Changes

Before After
gov.irs.payroll.social_security.cap gov.ssa.social_security.contribution_and_benefit_base

Files updated

  • New: parameters/gov/ssa/social_security/contribution_and_benefit_base.yaml
  • Deleted: parameters/gov/irs/payroll/social_security/cap.yaml
  • Updated: taxable_earnings_for_social_security.py (payroll)
  • Updated: social_security_taxable_self_employment_income.py (self-employment)
  • Updated: increase_taxable_earnings_for_social_security.py (CBO reform)
  • Updated: nawi.yaml (comment reference)

Test plan

  • All references updated to new parameter path
  • No functional changes - same values, just reorganized

Fixes #669

🤖 Generated with Claude Code

The contribution and benefit base (Social Security wage cap) is defined in
the Social Security Act (42 U.S.C. § 430), not the Internal Revenue Code.
Both FICA (26 U.S.C. § 3121) and SECA (26 U.S.C. § 1402) reference this
single SSA-defined value.

Changes:
- Moved cap.yaml from gov/irs/payroll/social_security/ to
  gov/ssa/social_security/contribution_and_benefit_base.yaml
- Renamed to use the statutory term "contribution and benefit base"
- Updated description to clarify it applies to both FICA and SECA
- Added 26 U.S.C. § 1402(b)(1) reference (SECA statute)
- Updated all code references to use new parameter path

Fixes #669

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@codecov
Copy link

codecov bot commented Jan 25, 2026

Codecov Report

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

Additional details and impacted files
@@            Coverage Diff             @@
##              main     #7245    +/-   ##
==========================================
  Coverage   100.00%   100.00%            
==========================================
  Files           12         2    -10     
  Lines          205        22   -183     
==========================================
- Hits           205        22   -183     
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.

@PavelMakarchuk
Copy link
Collaborator

Please do not merge until CRFB project is complete,

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.

Move Social Security maximum taxable earnings parameter out of payroll folder

3 participants