Let employers deduct less than the permitted state payroll premium, and apply Massachusetts' 2027 PFML cap swap by MaxGhenis · Pull Request #10285 · PolicyEngine/policyengine-us

MaxGhenis · 2026-10-19T18:33:14Z

What this changes

employee_state_payroll_tax was documented as "mandatory" employee payroll taxes, but for eight programs it counted the largest employee share the employer is allowed to deduct. In those programs the law caps what the employer may deduct from wages and leaves the amount to the employer. This PR:

Adds employer_state_payroll_premium_deduction_share (Person input, default 1). It is the share of the permitted employee premium the employer actually deducts. state_payroll_premium_deduction_share holds it between 0 and 1, because an employer may not deduct more than the permitted share. For each optional program the employee amount is now the permitted share times that share, and the employer-side variable carries the part it does not deduct, which each law makes the employer's (MN and NY employer costs are not modeled, so there the part goes nowhere). At the default every output is unchanged.
Encodes Acts 2026 c. 101 ss. 25–26 for Massachusetts from 2027-01-01. The deduction caps swap to 40% family / 100% medical, and DFML's 2027 rates swap at the same time (family 0.70%, medical 0.18%), so the 2027 employee share stays 0.46% and the employer share 0.42%. New parameter family_employee_share. The date decision is below.
Fixes the Connecticut citation. ct/tax/payroll/paid_leave/employee_rate cited CGS 31-49e, which is the definitions section. The contribution and its 0.5% ceiling are in 31-49g(b)(1).
Rewrites the documentation on employee_state_payroll_tax, employer_additional_state_payroll_tax, the employer-level aggregate and every touched program variable. Each now says which programs are mandatory withholding and which are optional employer pass-through, and cites the deduction rule.

Origin: the PolicyBench payroll audit of 2026-10-05 (evidence on PolicyEngine/policybench branch payroll-state-components-20261005, reference_audit/2026-10-05-payroll/; Max ruled d972, so PolicyBench excludes the four affected outputs and no PolicyBench reference depends on this PR).

Programs and the rule each follows

Program	Who owes the premium; what the employer may deduct	Employee amount	Employer side
CO FAMLI	Employer remits; "may deduct up to 50 percent" (C.R.S. 8-13.3-507(5)); a deduction not taken is an election to pay it (7 CCR 1107-1 §1.4(6)(A))	share × 0.44%	modeled: employer half (10+ employees) + undeducted
DE Paid Leave	Employer remits; "shall deduct not greater than 50%" and "may elect to pay all or any portion"; liable for the full amount (19 Del. C. §3705(d)–(g))	share × 50% of the size-based rate	modeled: rate × (1 − 50% × share)
MA PFML	Employer remits; may deduct up to 100% family / 40% medical, 40% / 100% from 2027 (M.G.L. c. 175M §6(c)–(d); Acts 2026 c. 101 §§25–26); employer pays the rest "in all instances" (458 CMR 2.05(5))	share × 0.46%	modeled: undeductible part (25+) + undeducted
ME PFML	Employer remits 100% (15+) or 50% (<15) and "may deduct up to 50%" (26 M.R.S. §850-F(5))	share × 0.5%	modeled: employer half (15+) + undeducted
MN Paid Leave	Premium payable by the employer, which pays at least half (a small employer at least a quarter of the full rate, 268B.14 subd. 5a(b)(1)); employees pay only "the remaining portion, if any" (Minn. Stat. 268B.14 subds. 1, 3, 5a)	share × 0.44%	not modeled (no MN employer variable exists)
NY PFL and DBL	Employer "is authorized to collect" up to the caps (WCL §209(3)–(4)) and pays DBL cost beyond what it collects (§210(1))	share × capped amount	not modeled (insurance premium)
VT Child Care Contribution	"Each employer shall pay"; may withhold up to a quarter; responsible for any unpaid amount (32 V.S.A. §10553(a)(1), (c)(2))	share × 0.11%	modeled: 0.33% + undeducted
WA PFML	Employer "may deduct ... up to" the employee share and "may elect to pay all or any portion" of it (RCW 50A.10.030(3)); a deduction not taken is an election to pay (WAC 192-510-065(2))	share × 1.13% × (1 − 28.57%)	modeled: employer portion (50+) + undeducted

Unchanged, because the statute puts the contribution on the worker and requires withholding (per the 2026-10-05 audit's statute review; CT and WA Cares re-read here): CA SDI (UIC 984, 986), CT Paid Leave (CGS 31-49g(b)(1), (3)), NJ TDI/FLI/UI/workforce, Paid Leave Oregon (ORS 657B.150), Oregon statewide transit tax, PA UC, RI TDI, WA Cares (RCW 50B.04.080).

The line between the two groups is the deduction text. The input covers programs whose law caps a permissive deduction ("may deduct up to", "shall deduct not greater than", "is authorized to collect", "may deduct and withhold ... not more than") and makes a deduction not taken the employer's. It excludes programs whose law requires a fixed deduction, even where the employer may also pay the worker's contribution for them.

WA PFML (the audit's "mixed" case). RCW 50A.10.030(1) and (7)(a) assess the premium on each worker and have the employer "collect from the employees". But (3)(a)–(b) make the deduction "may deduct ... up to", (3)(c) lets the employer "pay all or any portion" of the employee share, and WAC 192-510-065(2) makes a missed deduction the employer's. So it is in, and the default of 1 matches (7)(a).
Paid Leave Oregon. ORS 657B.150(2)(b) says the employer "shall deduct employee contributions ... in an amount that is equal to 60 percent" of the rate. Its (5) lets the employer pay "the required employee contributions" as an employer-offered benefit. That changes who pays a required contribution, not the deduction rule, so Oregon stays out. Neither the (5) election nor voluntary payment of WA Cares or CA SDI is modeled; the docstring says so.

Employer-level aggregate. employer_total_additional_state_payroll_tax applies the person's share to the employer's whole payroll, as if the employer deducts the same share from everyone. 458 CMR 2.05(5)(d) allows different shares for different groups, which a single per-person input can't express.

Massachusetts: why 2027-01-01 and not 2026-01-01

Acts 2026 c. 101 (approved 2026-06-12, an emergency law) §25 strikes "40" in lines 22, 33 and 39 of c. 175M §6 and inserts "100". §26 strikes "100" in lines 25, 33 and 43 and inserts "40". Each figure appears exactly three times in §6, in (c), (d) and (e), so the caps swap for employers, small employers and covered business entities. Three provisions bear on the date:

§45 says §§25 and 26, together with income tax sections 7, 13–15 and 21, "shall apply for taxable years beginning on or after January 1, 2026".
§43(a) directs EOLWD and DFML to issue guidance on "the impact for employers and employees in calendar year 2027", including "administrative adjustments ... to ensure the overall balance of employee and employer contribution levels remain unchanged". §43(b) ties those adjustments to "the annual contribution rates".
DFML applies the change from 2027-01-01. Its rates page (updated 2026-10-01) says the act "shifts employer contributions from medical leave to family leave, effective January 1, 2027". It publishes the 2027 split: up to 40% of family (0.28% of wages) and up to 100% of medical (0.18%), with 25+ employers paying the remaining 0.42%.

Counter-point. §49 of the same act says "Section 22 shall take effect on January 1, 2027", so the legislature could give a non-income-tax section a calendar 2027 start, and it left §§25–26 under §45 instead. That is the strongest textual case for 2026.

I encode 2027-01-01 (Max asked for the date to be decided and cited). PFML contributions have no taxable year: they accrue on wages paid, at rates "set annually for January 1–December 31" (DFML; c. 175M §7(e)). §45 is a shared applicability clause written for the act's income tax sections. Read literally, it would apply the swapped caps to 2026's rates (0.18% family, 0.70% medical). That gives a 0.772% employee maximum, which contradicts §43(a)'s instruction to keep the balance unchanged. It would also make lawful 2026 family-leave deductions above 40% unlawful after the fact. §43 and the agency that administers the program both say 2027, and in 2027 the swapped caps and swapped rates leave each worker's employee and employer amounts where they were in 2026 (property 6 below). A 2026 YAML case records that the literal reading would give $772 on $100,000 instead of $460.

Not modeled: federal tax on an employer-paid employee share. For state-run PFML funds, Rev. Rul. 2025-4 (Situation 4) treats an employer's voluntary payment of the employee's permitted share ("employer pick-up") as compensation: it is in the employee's gross income and FICA wages, and the employee may deduct it as a state tax. Notice 2026-6 ends the 2025 transition relief for 2026. The ruling doesn't address private or insured plans (its footnote 3), which covers New York, and Vermont's Child Care Contribution isn't a leave program. This PR lowers only the employee's payroll deduction when the share is below 1; it does not add the pick-up to wages. The input and aggregate docstrings say so.

Invariants

These hold for every worker, wage, employer size and share, in 2026 and 2027. They are checked by policyengine_us/tests/core/test_state_payroll_premium_deduction_share_invariants.py (Hypothesis; three copies of each drawn worker in one vectorized simulation):

Scaling. The employee amount of the optional programs equals clip(share, 0, 1) × the amount at the default. So the default is the full permitted share, and a share outside 0–1 acts as the nearer bound.
Mandatory parts are untouched. employee_state_payroll_tax minus the optional components doesn't depend on the share.
Conservation. Where the employer side is modeled (CO, DE, MA, ME, VT, WA), employee plus employer premium doesn't depend on the share: the employer pays exactly what it doesn't deduct. MN and NY employer amounts are zero at any share (not modeled).
Monotonicity. A larger share never lowers the employee amount or raises the employer amount.
Differential. For a one-worker employer (employer-level wage totals equal to the worker's wages, capped at the Social Security base as the worker's are), employer_total_additional_state_payroll_tax equals employer_additional_state_payroll_tax in every modeled state, at any share and employer size. This ties the employer-level path to the per-worker path.
MA balance across the swap. For wages under both years' wage bases, the 2027 employee and employer amounts equal the 2026 amounts.

All amounts are compared to float32 precision, within a cent. A second test, test_massachusetts_2027_swaps_deduction_caps_and_rates, pins the four 2027 MA parameter values, which the properties can't distinguish from carrying 2026 forward. A mutation check (mutants.py, 13 mutants: each breaks one formula, parameter, the clip or an aggregate's size threshold) kills 13 of 13 at 8ec5126, and the property test alone kills all 13 .

Cost (local, macOS, shared host; Linux CI not yet measured): the new test file runs in 5.0 s of test time, 23 s wall including the model import, with a peak memory footprint of 1.04 GB. It runs in the Rest Python core group (make group core, shard 2), which CI run 38141803955 measured at 13.3 GB / 11:51; this adds 8 small simulations of at most 150 people over two years.

Tests run locally

policyengine_us/tests/core/test_payroll_contributions.py and test_input_variable_definitions.py: 104 passed, unchanged. That covers the default-share outputs.
New policyengine_us/tests/policy/baseline/gov/states/tax/payroll/state_payroll_premium_deduction_share.yaml (16 cases) and four new cases in ma_employee_paid_leave_contribution.yaml: 26 passed. Expected values are computed by hand from the statutory and agency rates, in comments.
New invariant tests: 2 passed.

Targeted files only: a capacity reservation is in force on the shared host, so the full YAML shards are left to CI.

Review

Independent adversarial review r1 (Opus 5.5, in session, since the Subfleet lanes were closed by the US hub's disk pause) found no wrong number and requested four should-fix changes plus nits: the aggregate docstrings described NY and WA as employer premiums; the MN and NY employer side; the WA and Oregon line; and an employer-level branch the properties didn't reach. All are addressed in 8ec5126. Delta review r2 at 8ec5126: AGREE, with nits on the Rev. Rul. 2025-4 scope (now limited to the state PFML funds in 727ebcb) and on the Axiom issues (quotes and NY invariants added).

Hub review (Claude Opus 5.5, independent; served while the Codex lanes were closed): APPROVE at 3698893465, no P1/P2. Every program matches its statute and every changed expectation recomputes. Outputs at the default share are bit-identical to the merge base over 1,584 households × 23 variables for 2024–2028.
- Massachusetts date: the statute alone doesn't settle it. §45 says 2026, but §43(a) frames the change as calendar year 2027 and keeps each side's balance unchanged, and DFML administers it from January 1, 2027. The PR follows §43(a) and DFML, which leaves 2026 identical to main. The alternative would change main's 2026 numbers (employee $460 → $772 on $100k).
- Two P3s remain: the test module's docstring still carries the NY/WA wording that r1 fixed in the variables, and this body (fixed here).

Review of 2026-10-20 (DTrim99)

Addressed at 7cb554e630: the three descriptions follow the house template; the MA share references cite c. 175M s. 6(c)-(d) and carry a one-line comment on the 2027-01-01 date; the invariants docstring describes NY and WA as their statutes do; and two YAML cases cover a partial share above the 2027 MA wage cap (442.29 / 1,249.95) and the CO employer-level aggregate at share 0.5 (6,600). main is merged in, which brings #10295's 2027 rates and #10380's Delaware wage base (payroll_tax_gross_wages capped at the Social Security base); the two Delaware conflicts keep main's wage base and this PR's share.

62a9f63e69 then supplies the default share to #10380's test_donut_invariants, whose hand-built evaluator of the Delaware formulas didn't know the new input (Contrib other-shard-1 failed at 7cb554e630); CI is green at 62a9f63e69 (run 41407953599).

CI

The only failure at f160968 was nc_sa.yaml (North Carolina Special Assistance 2027 COLA: nc_sa_rate 1448 vs 1436). It was main's failure, fixed on main by #10279 (#10282 was closed). Main has since been merged in, and all 29 checks pass at 3698893465. Nothing here touches NC.

Not in this PR

CA SDI rate history and the pre-2024 wage limit are in Apply each year's California SDI rate and the pre-2024 SDI wage limit #10255; this PR doesn't touch CA.
Start CO FAMLI, Paid Leave Oregon and WA Cares at their program dates, and add 2019–2024 Washington PFML premiums #10154 (CO/OR/WA start dates and WA history) edits the CO/WA rate parameters and the CO/OR/WA state payroll YAML tests. This PR edits neither, so the two don't overlap.
MN employer premium and NY employer coverage cost aren't modeled. Here the undeducted part has no employer variable to land in, as documented on the variables.
2027 premium rates for CO, NY and WA come from Encode the published 2027 state paid leave premiums (CO, WA, NY, NJ) and cite the unchanged 2027 rates #10295, now merged in from main; they scale by the share like the 2026 rates. Encode the published 2027 state paid leave premiums (CO, WA, NY, NJ) and cite the unchanged 2027 rates #10295 doesn't touch the Massachusetts parameters, so this PR's 2027 swap applies alone.
Federal pick-up treatment of an employer-paid employee share (Rev. Rul. 2025-4; Notice 2026-6) isn't modeled; proposed as a follow-up issue.

Impact

None at the default share: every formula reduces to the previous one at share = 1, and MA's 2027 swap leaves each worker's employee and employer amounts unchanged (property 6). No national impact run is needed.

axiom: M.G.L. c. 175M s. 6 / Acts 2026 c. 101 → TheAxiomFoundation/rulespec-us#1817 queued; C.R.S. 8-13.3-507 → TheAxiomFoundation/rulespec-us#1818 queued; Minn. Stat. 268B.14 → TheAxiomFoundation/rulespec-us#1819 queued; N.Y. WCL 209 → TheAxiomFoundation/rulespec-us#1820 queued; 19 Del. C. 3705 → TheAxiomFoundation/rulespec-us#1821 queued; 26 M.R.S. 850-F → TheAxiomFoundation/rulespec-us#1822 queued; 32 V.S.A. 10553 → TheAxiomFoundation/rulespec-us#1823 queued; RCW 50A.10.030 → TheAxiomFoundation/rulespec-us#1824 queued (all blocked on corpus ingestion, TheAxiomFoundation/axiom-corpus#893); CGS 31-49g(b)(1) citation fix: n/a: reference-only change.

Generated by Claude Code

Add employer_state_payroll_premium_deduction_share (default 1) for the programs whose statute puts the premium on the employer and lets it deduct up to a share from wages: CO FAMLI, DE Paid Leave, ME and MA PFML, MN Paid Leave, NY PFL and DBL, the VT Child Care Contribution and WA PFML. The employee amount is the permitted share times the deduction share; the employer-side variables carry the part it does not deduct. Encode Acts 2026 c. 101 ss. 25-26 for Massachusetts from 2027-01-01, with DFML's 2027 family and medical rates, and cite CGS 31-49g(b)(1) for the Connecticut paid leave rate. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

…variants Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

codecov · 2026-10-19T19:22:03Z

Codecov Report

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

Additional details and impacted files

@@            Coverage Diff             @@
##              main    #10285    +/-   ##
==========================================
  Coverage   100.00%   100.00%            
==========================================
  Files            1         1            
  Lines           54       193   +139     
==========================================
+ Hits            54       193   +139

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 Harness.
📢 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.

Describe the deduction-share programs by the employer's choice, not by who owes the premium (NY and WA put the contribution on the worker), note that MN and NY employer costs are not modeled, state why WA PFML is in and Paid Leave Oregon is out, and note that Rev. Rul. 2025-4's treatment of an employer-paid employee share as wages is not modeled. Cap the one-worker employer's taxable total in the invariants so the employer-level path is checked for every modeled state and size, pin the 2027 Massachusetts parameter values, and add file-page anchors to the PDF references. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

MaxGhenis · 2026-10-19T20:35:15Z

Hand-off to the US + core hub.

Head: 727ebcb881094b80dbf111670a055b50e7e43875, based on main at 05b9da3e92.
Independent review: Opus 5.5 adversarial review, run in session because the US hub's disk pause Add tax parameters #9 holds Subfleet reviews.
- r1: REQUEST_CHANGES, no wrong number; four should-fix items, all fixed in 8ec5126.
- r2 at 8ec5126: AGREE with nits; fixed in 727ebcb and in the issues.
- r2b: AGREE at 727ebcb.
- Review files: ~/reviews/payroll-employer-deduction-share-2026-10-19/runs/review-r1.md and review-r2.md.
Passed locally (targeted files only, under the host's disk pause and release hold):
- tests/core/test_payroll_contributions.py and test_input_variable_definitions.py: 104 passed, unchanged at the default share.
- The new state_payroll_premium_deduction_share.yaml plus the MA cases: 26 passed.
- The new invariants file: 2 passed, 5.0 s of test time, 1.04 GB peak.
- Mutation check: 13 of 13 killed at 8ec5126, and the property test alone kills all 13. The only later change, 727ebcb, edits docstrings.
CI at f160968: the only failure was nc_sa.yaml (NC Special Assistance 2027 COLA). It fails the same way on main and Update the 2027 NC Special Assistance test case to the announced COLA #10282 fixes it. CI at 727ebcb is running.
Depends on: Update the 2027 NC Special Assistance test case to the announced COLA #10282 (merge it, then merge main into this branch). No file overlap with Start CO FAMLI, Paid Leave Oregon and WA Cares at their program dates, and add 2019–2024 Washington PFML premiums #10154 or Apply each year's California SDI rate and the pre-2024 SDI wage limit #10255.
Holds or decisions: none. Max asked for the Massachusetts date to be decided and cited; the body gives the reasons for 2027-01-01, including the s. 49 counter-point.
Axiom: Massachusetts PFML contributions: deduction caps, the Acts 2026 c. 101 swap from 2027, and the employer's undeducted share (PE-US #10285) TheAxiomFoundation/rulespec-us#1817 through NYC integration test #1824 are queued (pe-parity), all blocked on corpus ingestion, Ingest state paid-leave premium sources (MA, CO, MN, NY, DE, ME, VT, WA) for rulespec-us pe-parity (PE-US #10285) TheAxiomFoundation/axiom-corpus#893. The CT citation fix is n/a.
Follow-ups (proposed as separate sessions):
- encode the 2027 premium rates for CO, DE, ME, MN, NY, WA and the other paid-leave programs;
- model the Minnesota Paid Leave employer premium.
Evidence: ~/reviews/payroll-employer-deduction-share-2026-10-19/ holds the statute texts and excerpts, mutants.py with its results, the reviews and the Axiom issue generator.
Impact: none at the default share. The MA 2027 swap leaves each worker's employee and employer amounts unchanged.

Brings in main through 1661d71, including #10279's update to North Carolina SA Case 37, which was the only CI failure. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

MaxGhenis · 2026-10-19T22:37:43Z

Hand-off update: #10282 was closed because #10279 already landed the same NC Special Assistance test fix on main. The branch already had main merged in at 21:44Z (33b1f9091e, which includes #10279). At 22:37Z I also ran GitHub's update-branch, which added 3698893465ee80dd94199b0fad4606eaaf1318b5, a second main merge and now the head. Both commits only bring in main: none of this PR's files changed after 727ebcb, where the review agreed. There is no remaining dependency; what's left is CI.

Brings in main through c39af98 (#10185, #10199 and others) so CI runs on the combined tree. The two sides share no files. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

DTrim99 · 2026-10-20T20:56:04Z

PR Review: Let employers deduct less than the permitted state payroll premium, and apply Massachusetts' 2027 PFML cap swap

PR #10285 (author: MaxGhenis). Head 6ad174a080. The branch is 7 ahead of main and 16 behind. First review.

Summary

The PR adds employer_state_payroll_premium_deduction_share (Person input, default 1). It is the share of the permitted employee premium that the employer actually deducts, held to 0–1 by the new state_payroll_premium_deduction_share. It covers eight programs whose law caps a permissive deduction: CO FAMLI, DE Paid Leave, ME and MA PFML, MN Paid Leave, NY PFL and DBL, the VT Child Care Contribution and WA PFML. The employee amount becomes the permitted share times this input. In the six programs with an employer variable, that variable picks up the part not deducted. The PR also encodes the Massachusetts cap swap under Acts 2026 c. 101 §§25–26 from 2027-01-01, together with DFML's 2027 rate swap, and fixes the Connecticut citation to CGS 31-49g(b)(1).

I re-read the primary sources for all eight programs and for Connecticut. Each one matches the PR's split between the "may deduct up to" programs and the mandatory-withholding programs, and each matches its employer-pays-the-rest rule. The Acts 2026 c. 101 text and DFML's 2027 split confirm the Massachusetts values. Every formula reduces to the old one at the default share, so no existing result changes. Employee plus employer equals the required remittance at any share in all six modeled states. The code is vectorized, and the share is applied only inside the state-gated program variables.

I hand-checked all 20 new YAML cases and two existing capped Massachusetts cases. All eight axiom issues are OPEN, labelled pe-parity, dispatch-ready and consistent with the head. CI is 29/29 green. git merge-tree is clean against main (which now includes #10295), against #10154, and against both together.

One should-fix item remains: three parameter descriptions don't follow the house template. There are three optional suggestions.

Critical (must fix)

None.

Should address

1. Three parameter descriptions don't follow the house template.

Where (line 1 of each):
- parameters/gov/states/ma/tax/payroll/paid_leave/family_employee_share.yaml (new): "Largest share of the Massachusetts PFML family leave contribution an employer may deduct from wages."
- parameters/gov/states/ma/tax/payroll/paid_leave/medical_employee_share.yaml (rewritten): "Largest share of the Massachusetts PFML medical leave contribution an employer may deduct from wages."
- parameters/gov/states/de/tax/payroll/paid_leave/employee_share.yaml (rewritten): "Largest share of each Delaware Paid Leave contribution an employer may deduct from wages."
The template: "one sentence, spell the program out fully (no acronyms), [State] [verb] ... under the [Full Program Name] program."
- All three open with a noun phrase instead of "[State] [verb]".
- The two Massachusetts descriptions use the acronym "PFML".
- None has the "under the ... program" clause.
Fix, for example:
- "Massachusetts limits an employer's deduction from wages to this share of the family leave contribution under the Paid Family and Medical Leave program."
- The same sentence with "medical leave contribution" for medical_employee_share.
- "Delaware limits an employer's deduction from wages to this share of each contribution under the Paid Leave program."

Suggestions

1. Federal tax treatment of the part the employer pays (documented deferral; consider a follow-up issue).

What's missing. The input, employee_state_payroll_tax and the aggregate docstrings say the federal treatment of an employer's payment of the employee share is not modeled. That treatment is the "pick-up" in Rev. Rul. 2025-4. The citation is correct, and the relief has ended for 2026. Notice 2026-6, footnote 2: "This notice does not extend the third component of the transition relief announced in Revenue Ruling 2025-4 to an employer pick-up for calendar year 2026, and consequently, contemplates that employers will treat contribution amounts they voluntarily pay on behalf of their employees to a State PFML program as wages for Federal employment tax purposes under §§ 3121(a), 3306(b), and 3401(a)".
Effect. Take a share below 1 in CO, DE, ME, MA, MN or WA from 2026 on. The model raises net income by the full undeducted amount, but federal law adds that amount to W-2 wages for income tax and FICA. The employee can also deduct it as a state tax if itemizing.
- Example: CO 2026, $100,000 of wages, share 0.5. The employer picks up $220, and the model leaves out FICA of 7.65% × 220 = $16.83 plus the income tax on $220.
Why it isn't blocking. The default share is unaffected, and the limitation is stated in the docstrings.
Suggestion. File a follow-up issue and link it from the input's docstring, so users who lower the share see where the model stops.

2. Optional YAML cases for two paths that only the Hypothesis test reaches.

Wage cap with a partial share. No YAML case puts a partial share on wages above the Social Security base. MA 2027, $250,000 of wages, share 0.5:
- wages capped at $192,300
- permitted 0.46% × 192,300 = 884.58
- ma_employee_paid_leave_contribution = 442.29
- ma_employer_paid_leave_contribution = 0.42% × 192,300 + 442.29 = 807.66 + 442.29 = 1,249.95
- This also pins the 2027 cap together with the swapped parameters.
Employer aggregate with a share. employer_total_additional_state_payroll_tax is checked only by property 5 and by the existing default-share Python tests. A case: CO 2026, employer_total_taxable_earnings_for_social_security: 1_000_000, employer_state_payroll_premium_deduction_share: 0.5, default headcount. That gives 0.44% × 1,000,000 + 0.5 × 0.44% × 1,000,000 = 4,400 + 2,200 = 6,600.

3. Small text fixes.

PR body, "Not in this PR". "2027 premium rates for CO, DE, ME, MN, NY and WA still carry 2026 values forward" is out of date now that Encode the published 2027 state paid leave premiums (CO, WA, NY, NJ) and cite the unchanged 2027 rates #10295 is on main:
- It encodes CO 0.86%, WA 1.2% with a 29.3% employer share, and NY PFL 0.452% with a $451.81 maximum.
- It cites official confirmation that DE, ME and MN are unchanged.
- Drop or update that bullet.
Test-module docstring. test_state_payroll_premium_deduction_share_invariants.py:3-7 says these programs "put the premium on the employer". That is not true for:
- New York, where WCL §209(3)–(4) makes it an employee contribution the employer "is authorized to collect".
- Washington, where RCW 50A.10.030(1) assesses the premium "for each individual in employment".
- The variable docstrings were corrected in r1, and the hub review left this one open as a P3.
Reference titles. family_employee_share.yaml and medical_employee_share.yaml cite "Massachusetts General Laws Chapter 175M Section 6". The house style asks for the full subsection path, so "Section 6(c)-(d)" would point straight at the caps.
Optional comment on the date. Add a one-line comment beside the 2027-01-01 entries in the two share files explaining why the swap is not dated 2026-01-01 under §45's "taxable years" clause (§43(a) and DFML). Then the decision travels with the parameter and not only in the PR body.

Verified correct

Default behaviour is unchanged.
- Every touched employee formula is permitted × state_payroll_premium_deduction_share.
- Every touched employer formula adds (1 − share) × permitted, or for DE uses rate × (1 − 0.5 × share). At share = 1 each reduces exactly to the formula on main.
- The aggregate employer_total_additional_state_payroll_tax makes the same changes, applying the person's share to the whole payroll, as its docstring says.
- The share is clipped to 0–1 (clip(share, 0, 1)), and the YAML clip case pins 1.5 → 1 and −0.5 → 0.
- The code is vectorized throughout (clip, where, select, array arithmetic).
- The share variable has no defined_for. It is read only inside variables already gated by defined_for = StateCode.XX.
Conservation (employee + employer = required remittance, for any share):
- CO: 10+ employees remit 0.88% (= 0.44% + undeducted + deducted). Fewer than 10 remit 0.44%.
- DE: full rate at 25+, parental rate only at 10–24, 0 below 10.
- MA: 0.88% at 25+, 0.46% below 25.
- ME: 1.0% at 15+, 0.5% below 15.
- VT: 0.44%.
- WA: the full rate at 50+, the employee share below 50.
- MN and NY: employer cost not modeled, as the docstrings say.
Batch lessons:
- NH Add New Hampshire state supplementation for 2026 #10156 pattern: not applicable. No state-gated int or enum key variable is added.
- OK Add Oklahoma state supplementation for 2026 #10165 pattern: not applicable. No wage base or taxable-wage formula changes.
- Integrate modeled state unemployment insurance into income flows #9558 and Document disjoint health premium inputs and correct consumer treatment #10046: not touched.
Massachusetts swap (Acts 2026 c. 101, "Approved, June 12, 2026", emergency preamble):
- §25: "striking out, in lines 22, 33 and 39, the figure '40', each time it appears, and inserting ... 100".
- §26: "striking out, in lines 25, 33 and 43, the figure '100' ... 40".
- The lines. In c. 175M §6, "40" and "100" each appear three times: (c)(1) "shall not deduct more than 40 per cent" (medical), (c)(2) "may deduct not more than 100 per cent" (family), (d) the small-employer remittance, and (e)(1)–(2). So the swap reaches employers, small employers and covered business entities.
- §43(a): guidance on "the impact for employers and employees in calendar year 2027, including ... any administrative adjustments ... to ensure the overall balance of employee and employer contribution levels remain unchanged".
- §45: applies §§25–26 "for taxable years beginning on or after January 1, 2026".
- §49: "Section 22 shall take effect on January 1, 2027". The PR body cites this as the counter-point.
- DFML (search capture of the mass.gov rates page; the page itself returns 403 to automated requests):
  - 2027 family leave: "Up to 40% ... can be withheld (0.28% of eligible wages) ... the remaining 60% (0.42% of eligible wages)".
  - 2027 medical leave: "Up to 100% ... (0.18% of eligible wages)".
  - Small employers: "fewer than 25 covered individuals must send an effective contribution rate of 0.46%".
  - Effective date: "effective January 1, 2027".
  - These figures imply family 0.70% and medical 0.18%, which matches the parameters.
- Date assessment. I agree with 2027-01-01.
  - DFML administers calendar-year rates and applies the swap from 2027. §43(a) frames the change as calendar 2027.
  - A literal 2026 reading would apply swapped caps to the unswapped 2026 rates. That gives a 0.772% employee maximum, which no employer applied, and it would make lawful 2026 family-leave deductions above 40% excessive after the fact.
  - The PR documents both readings, and its 2026 cases pin the outcome.
- Effect on outputs. The swap leaves every household's amounts unchanged (2026 0.18 + 0.4 × 0.70 = 0.46; 2027 0.4 × 0.70 + 0.18 = 0.46). Only the Python parameter-pin test can tell the swap from carrying 2026 forward, and that justifies that test.
Statutory employee maximum and employer rule for each state (each re-read at the official source):
- CO: C.R.S. 8-13.3-507(5) (CRS 2025, file p. 222): "An employer with 10 or more employees may deduct up to 50 percent of the premium ... and shall remit 100 percent ... An employer with fewer than 10 employees may deduct up to 50 percent ... and shall remit 50 percent". 7 CCR 1107-1 §1.4(6) and (6)(A) (rule PDF, file pp. 7–8): "If an employer fails to deduct the maximum allowable employee share ... the employer is considered to have elected to pay that portion".
- DE: 19 Del. C. §3705(d)–(f): "an employer shall deduct not greater than 50% of the contribution required for the employee. However, an employer may elect to pay all or any portion of the employee's share". §3705(g): "the employer remains liable for the full amount of the contribution, including that amount not deducted".
- ME: 26 M.R.S. §850-F(5): 15 or more employees "may deduct up to 50% ... and shall remit 100%"; fewer than 15 "may deduct up to 50% ... and shall remit 50%".
- MN: Minn. Stat. 268B.14:
  - subd. 3: "employers must pay a minimum of 50 percent of the annual premiums ... Employees, through a deduction in their wages ... must pay the remaining portion, if any".
  - subd. 5a(b)(1): small employers "must pay a minimum of 25 percent of the rate calculated in subdivisions 6 and 7".
  - So the employee maximum is 0.44% for both regular and small employers, which matches employee_rate.
- NY: WCL §209(3)(a): DBL is "one-half of one per centum ... but not in excess of sixty cents per week". (3)(b): DFS sets the PFL maximum. (4): "the employer is authorized to collect from his or her employees ... through payroll deductions". §210(1): the employer pays "the cost of providing disability benefits in excess of the contributions collected".
- VT: 32 V.S.A. §10553(a)(1): "Each employer shall pay the Child Care Contribution ... may deduct and withhold ... not more than one quarter". (b): 0.44%. (c)(2): "Employers shall be responsible for the full amount of any unpaid contributions".
- WA: RCW 50A.10.030(3): "may deduct ... up to". (3)(c): "may elect to pay all or any portion of the employee's share". (7)(a): "must collect from the employees". WAC 192-510-065(2): a deduction not taken means "the employer is considered to have elected to pay that portion".
- MA employer rule: 458 CMR 2.05(5) (text checked on Cornell LII): "The employer ... in all instances shall be responsible for paying and remitting the remainder of any required contribution not lawfully deducted". It also allows "differing percentages" by group, which the aggregate docstring acknowledges. I couldn't check the #page=12 anchor on the mass.gov PDF because mass.gov blocks automated requests.
- CT fix: In CGS chapter 557, 31-49e is "Paid family and medical leave. Definitions". 31-49g(b)(1) says "each employee ... shall contribute ... provided that the percentage shall not exceed one-half of one per cent". The #sec_31-49g anchor exists. This is a valid reference-only n/a.
Hand checks (all 20 new cases; 2026 unless noted; $100,000 of wages; default headcount 100):
- CO default: 0.44% × 100,000 = 440 employee, 440 employer ✓.
- CO clip: share 1.5 → 1, giving 440 / 440. Share −0.5 → 0, giving 0 employee and 440 + 440 = 880 employer ✓.
- CO share 0.5: employee 220 (state and total also 220). Employer 440 + 220 = 660 ✓.
- CO 9 employees, share 0.25: employee 110. Employer 0 + 0.75 × 440 = 330 ✓.
- MA 2026 share 0.5: 0.5 × (0.18% + 0.4 × 0.70%) × 100,000 = 230. Employer 0.6 × 0.70% × 100,000 + 230 = 420 + 230 = 650 ✓.
- MA 2026, 24 employees, share 0: 0 / 460 ✓.
- MA 2026 default: 460 / 420 ✓.
- MA 2027 default: 0.4 × 0.70% + 1 × 0.18% = 0.46% → 460. Employer 0.6 × 0.70% = 0.42% → 420 ✓.
- MA 2027, 24 employees: 460 / 0 ✓.
- MA 2027 share 0.5: 230 / 650 ✓.
- ME share 0.5: 0.5 × 0.5% × 100,000 = 250. Employer 500 + 250 = 750 ✓. With 14 employees: 250 / 250 ✓.
- DE share 0.5: 0.8% × 0.5 × 0.5 × 100,000 = 200. Employer 0.8% × 0.75 × 100,000 = 600 ✓.
- DE 20 employees, share 0: 0. Employer 0.32% × 100,000 = 320 ✓.
- VT share 0.5: 0.11% × 100,000 × 0.5 = 55. Employer (0.33% + 0.055%) × 100,000 = 385 ✓.
- WA share 0.5:
  - employee 0.5 × 1.13% × 0.7143 × 100,000 = 403.5795
  - WA Cares 0.58% = 580
  - state total 983.5795
  - employer 1.13% × 0.2857 × 100,000 + 403.5795 = 322.841 + 403.5795 = 726.4205 ✓
- WA 49 employees, share 0: 0 / 807.159 ✓.
- MN share 0.5: 0.5 × 0.44% × 100,000 = 220 ✓.
- NY share 0.5:
  - PFL: min(0.432% × 100,000, 411.91) × 0.5 = 205.955
  - DBL: min(500, 31.20) × 0.5 = 15.60
  - total 221.555 ✓
- Mandatory withholding at share 0: CA SDI 1.3% = 1,300, CT 0.5% = 500, PA UC 0.07% = 70 ✓.
- Wage cap at the default share (existing MA cases, unchanged): 2025: 0.46% × 176,100 = 810.06. 2024: 0.46% × 168,600 = 775.56 ✓.
Callers.
- employee_state_payroll_tax feeds employee_payroll_tax, which feeds household_tax_before_refundable_credits, spm_unit_payroll_tax, spm_unit_paycheck_withholdings, taxsim_tfica, the FICA marginal-rate helper and Alabama's itemized-deduction sources.
- The employer variables feed employer_state_payroll_tax and employer_total_state_payroll_tax.
- At the default share all of these are unchanged.
Test design.
- The Hypothesis property test (8 examples, at most about 141 people, 2026–2027) checks multi-state structural invariants that YAML can't express. It doesn't re-implement a formula. Cost is reported (5.0 s test time, 1.04 GB local peak, core shard).
- The parameter-pin test reads the shared system without building a model.
- The YAML file is named after state_payroll_premium_deduction_share.
Changelog, references, partners.
- One top-level changelog.d/payroll-employer-deduction-share.added.md. added fits a new input.
- The variable references are single and valid. The multi-page CO rule href has a # PDF pages 7-8 comment, which follows the convention.
- No partner contract test is touched.

Axiom line assessment

Valid. The line has eight queued entries and one n/a.

Status. rulespec-us#1817 (MA), Added me_personal_exemption variable #1818 (CO), Use subsection deep links for DC code references #1819 (MN), Change in_nyc from ETERNITY to YEAR #1820 (NY), Populate in_nyc from ASEC #1821 (DE), Change all instances of ETERNITY to YEAR #1822 (ME), Toggling NYC residency breaks net income screen #1823 (VT) and NYC integration test #1824 (WA) are all OPEN and labelled pe-parity.
Dispatch-ready. Each body has:
- new-module targets with proposed corpus citations, for example us-ma/statutes/175M/6.yaml with the Acts 2026 c. 101 swap as a version dated 2027-01-01, and us-co/statutes/8/8-13.3-507.yaml with 7 CCR 1107-1 §1.4
- the verbatim law (statute, rule and agency text)
- required outputs that include employer_deduction_share as a leaf input in [0, 1]
- companion tests hand-computed from the statutory and agency rates
- a pasteable review_finding
Match with the head. I checked each table against the PR's YAML:
- MA: 460/420, 230/650, and the 2027 rows.
- CO: 440/440, 220/660, 110/330.
- MN: 220.
- NY: 443.11 and 221.555.
- DE: 200/600 and 0/320.
- ME: 250/750 and 250/250.
- VT: 55/385.
- WA: 403.5795/726.4205.
- Add IL to the state income tax list #1817 states the 2027-01-01 date reasoning and asks the encoder to flag a different reading on this PR rather than encode it silently.
Shared issues. Added me_personal_exemption variable #1818 and NYC integration test #1824 carry extension comments for Encode the published 2027 state paid leave premiums (CO, WA, NY, NJ) and cite the unchanged 2027 rates #10295 (2027) and Start CO FAMLI, Paid Leave Oregon and WA Cares at their program dates, and add 2019–2024 Washington PFML premiums #10154 (program start and 2019–2025 history). Use subsection deep links for DC code references #1819 is extended for Model the Minnesota Paid Leave employer premium #10294.
Queued is the right status.
- rulespec-us main (5796861e58) has no module under us-ma/statutes/175M, us-co/statutes/8, us-mn/statutes/268B, us-ny/statutes/wkc, us-de/statutes/19, us-me/statutes/26, us-vt/statutes/32 or us-wa/statutes/50A.
- The recorded blocker, axiom-corpus#893 ("Ingest state paid-leave premium sources ... for rulespec-us pe-parity"), is OPEN.
The n/a entry. "CGS 31-49g(b)(1) citation fix: n/a: reference-only change" is valid, because no value changes.

CI status

All 29 checks pass at head 6ad174a080 (gh pr checks 10285, re-checked at the end of this review). Nothing is pending.

The run. It tested the head merged into main as of about 05:30 UTC on 2026-10-20. That was before Encode the published 2027 state paid leave premiums (CO, WA, NY, NJ) and cite the unchanged 2027 rates #10295 merged at 13:05 UTC, so CI hasn't run this PR together with Encode the published 2027 state paid leave premiums (CO, WA, NY, NJ) and cite the unchanged 2027 rates #10295's 2027 values.
Why that's fine. The merged-tree analysis below shows they don't interact. Encode the published 2027 state paid leave premiums (CO, WA, NY, NJ) and cite the unchanged 2027 rates #10295 changed only parameters, the PR's formulas read those parameters, and at the default share every Encode the published 2027 state paid leave premiums (CO, WA, NY, NJ) and cite the unchanged 2027 rates #10295 expectation is unchanged.
Before merge. Updating the branch would confirm this in CI.
No local runs. CI is green and no merged-tree question needed a probe.

Branch status

Position: 16 behind main (461f78e1ee), 7 ahead. The last two commits are merges from main. None of the PR's files changed after 727ebcb881, the commit the author's reviews agreed.
Merge with main: git merge-tree --write-tree PolicyEngine/main 6ad174a080 is clean (tree aab5e4c388).
- The one shared file is ct/tax/payroll/paid_leave/employee_rate.yaml. The merged file has the PR's "Connecticut General Statutes Section 31-49g(b)(1)" (#sec_31-49g) alongside Encode the published 2027 state paid leave premiums (CO, WA, NY, NJ) and cite the unchanged 2027 rates #10295's board-minutes reference, and the value is unchanged (2021-01-01: 0.005).
- Every other touched file is identical to the head in the merged tree.
- Encode the published 2027 state paid leave premiums (CO, WA, NY, NJ) and cite the unchanged 2027 rates #10295's 2027 values reach the PR's formulas unchanged: CO 0.43% / 0.43%, WA 1.2% with a 0.293 employer share, NY PFL 0.452% with a $451.81 maximum. They scale by the share like the 2026 values. Encode the published 2027 state paid leave premiums (CO, WA, NY, NJ) and cite the unchanged 2027 rates #10295 doesn't touch the Massachusetts parameters, so the PR's 2027 swap applies alone.
Sibling PRs (a branch note only):
- Start CO FAMLI, Paid Leave Oregon and WA Cares at their program dates, and add 2019–2024 Washington PFML premiums #10154 (head b633c145e2) merges cleanly with this head (tree 2143422093). A three-way merge of main + Let employers deduct less than the permitted state payroll premium, and apply Massachusetts' 2027 PFML cap swap #10285 + Start CO FAMLI, Paid Leave Oregon and WA Cares at their program dates, and add 2019–2024 Washington PFML premiums #10154 is also clean (tree 3604ccfc2a). The pre-start zeros and 2019–2024 WA history in Start CO FAMLI, Paid Leave Oregon and WA Cares at their program dates, and add 2019–2024 Washington PFML premiums #10154 feed the new undeducted term as zero or historical rates, and the default share of 1 leaves Start CO FAMLI, Paid Leave Oregon and WA Cares at their program dates, and add 2019–2024 Washington PFML premiums #10154's expectations intact.
- Model the Minnesota Paid Leave employer premium #10294 (head a19c04c83c) contains this PR's commits up to 3698893465 and merges cleanly with this head (tree e37ce35c6f). Merge Let employers deduct less than the permitted state payroll premium, and apply Massachusetts' 2027 PFML cap swap #10285 first. Model the Minnesota Paid Leave employer premium #10294 then adds the MN employer side and updates the invariant test's MN/NY expectation.

Verdict: REQUEST_CHANGES

DTrim99

The mechanism, the statutes for all eight states and the Massachusetts 2027 change all check out, the default share of 1 leaves every existing output unchanged, and all 20 new cases hand-check. One should-address item: three parameter descriptions (MA family and medical employee shares, DE employee share) don't follow the house template. Three suggestions, and a note to update the branch past #10295 before merging. Full report in the comment above.

MaxGhenis · 2026-11-02T05:50:13Z

Picking this up for the US hub. I'll post a hand-off comment here when it's ready.

Generated by Claude Code

Brings in #10295's 2027 premium rates and #10380's Delaware wage base (payroll_tax_gross_wages capped at the Social Security base). The two Delaware conflicts keep main's wage base and references and this branch's deduction share. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Rewrite the MA family and medical and DE employee-share descriptions to the house template; cite c. 175M s. 6(c)-(d) and say beside the MA 2027-01-01 entries why the swap is dated 2027; fix the invariants test docstring's description of NY and WA, which the statute does not put on the employer; and add YAML cases for a partial share above the 2027 wage cap (MA) and for the employer-level aggregate at a partial share (CO), paths only the property test reached. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

test_donut_invariants evaluates the Delaware paid leave formulas with a hand-built person() that supplies their inputs. Since main's merge the formulas also read state_payroll_premium_deduction_share, which it didn't supply (KeyError in Contrib other-shard-1). Supply the default share of 1, under which the contributions are the ones the reform must preserve. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

MaxGhenis · 2026-11-02T09:03:50Z

Ready for hub review

Head: 62a9f63e6970896ee993fe119305d71036af81ca

Picked up at 6ad174a080 (unchanged since 2026-10-20, so no new commits to read). Three commits on top:

bc830d69c7: merge of main (343 commits behind; brings Encode the published 2027 state paid leave premiums (CO, WA, NY, NJ) and cite the unchanged 2027 rates #10295's 2027 rates and Fix Social Security secondary earnings threshold reform #10380).
7cb554e630: the review changes.
62a9f63e69: a fix for a CI failure the merge exposed (below).

What the item asked for

Merge current main. Done as a merge commit. Two conflicts, both in Delaware: #10380 changed the wage base in de_employee_paid_leave_contribution.py and de_employer_paid_leave_contribution.py to min_(payroll_tax_gross_wages, social_security.cap) and replaced the references.

Resolved to keep main's wage base and references and this PR's share: de_employee_paid_leave_contribution.py:22-33 (permitted * state_payroll_premium_deduction_share) and de_employer_paid_leave_contribution.py:22-35 (rate * (1 - employee_share * share)).
Encode the published 2027 state paid leave premiums (CO, WA, NY, NJ) and cite the unchanged 2027 rates #10295's 2027 rates (CO 0.43% / 0.43%, WA 1.2% with a 0.293 employer share, NY PFL 0.452% / $451.81) reach this PR's formulas unchanged. state_paid_leave_premiums_2027.yaml passes (12).
No MA parameter is touched by Encode the published 2027 state paid leave premiums (CO, WA, NY, NJ) and cite the unchanged 2027 rates #10295, so the MA 2027 swap applies alone.

Should address: the three descriptions (house template).

ma/tax/payroll/paid_leave/family_employee_share.yaml:1: "Massachusetts limits an employer's deduction from wages to this share of the family leave contribution under the Paid Family and Medical Leave program."
ma/tax/payroll/paid_leave/medical_employee_share.yaml:1: the same with "medical leave contribution".
de/tax/payroll/paid_leave/employee_share.yaml:1: "Delaware limits an employer's deduction from wages to this share of each contribution under the Paid Leave program."

Suggestion 2: two YAML cases, hand-checked:

ma_employee_paid_leave_contribution.yaml, last case: MA 2027, $250,000, share 0.5. Wages cap at the 2027 Social Security base, 192,300. Permitted 0.46% × 192,300 = 884.58; employee 0.5 × 884.58 = 442.29; employer 0.42% × 192,300 + 442.29 = 807.66 + 442.29 = 1,249.95.
New tests/policy/baseline/gov/states/tax/payroll/employer_total_additional_state_payroll_tax.yaml (named after the variable): CO 2026, employer_total_taxable_earnings_for_social_security 1,000,000, share 0.5, default headcount 100. 0.44% × 1,000,000 + 0.5 × 0.44% × 1,000,000 = 4,400 + 2,200 = 6,600.

Suggestion 3: text fixes.

PR body, "Not in this PR": the 2027-rates bullet now says Encode the published 2027 state paid leave premiums (CO, WA, NY, NJ) and cite the unchanged 2027 rates #10295 is merged in. Its replacement bullet says the federal pick-up isn't modeled and is proposed as a follow-up.
test_state_payroll_premium_deduction_share_invariants.py:3-9: the docstring now uses employee_state_payroll_tax's wording. NY is "authorized but not required to collect"; WA's employee share is one the employer "may deduct up to and may pay in any part"; only CO, DE, ME, MA, MN and VT premiums are described as the employer's.
Reference titles: both MA share files now cite "Massachusetts General Laws Chapter 175M Section 6(c)-(d)".
Date comment: family_employee_share.yaml:6 and medical_employee_share.yaml:6. "Dated 2027-01-01, not 2026-01-01: s. 45 applies ss. 25-26 to taxable years from 2026, but s. 43(a) frames the change as calendar year 2027, and the Department of Family and Medical Leave applies it from January 1, 2027."

Suggestion 1 (federal pick-up): not modeled, per the item. It is listed as a follow-up below.

CI failure the merge exposed, and its fix

The first run at 7cb554e630 (run 41400200144) failed one job, Contrib other-shard-1. test_increase_taxable_earnings_for_social_security.py::test_donut_invariants (from #10380 on main) raised KeyError: 'state_payroll_premium_deduction_share'.

Why. That test evaluates the Delaware formulas with a hand-built person() that supplies their inputs. Since the merge, those formulas also read the share.
The fix (62a9f63e69). test_increase_taxable_earnings_for_social_security.py:204-206 supplies the default share of 1, under which the Delaware contributions are the ones the CBO reform must preserve.
What else I checked. The reform itself (reforms/cbo/payroll/increase_taxable_earnings_for_social_security.py) doesn't redefine the Delaware variables, so no model change is needed. The file passes locally (4).

Tests run (one file per process)

state_payroll_premium_deduction_share.yaml: 16 passed.
ma_employee_paid_leave_contribution.yaml: 11 passed (1 new).
employer_total_additional_state_payroll_tax.yaml: 1 passed (new).
state_paid_leave_premiums_2027.yaml (Encode the published 2027 state paid leave premiums (CO, WA, NY, NJ) and cite the unchanged 2027 rates #10295's): 12 passed.
contrib/cbo/payroll/de_employee_paid_leave_contribution.yaml (Fix Social Security secondary earnings threshold reform #10380's): 1 passed.
test_state_payroll_premium_deduction_share_invariants.py: 2 passed.
test_payroll_contributions.py: 100 passed.
test_input_variable_definitions.py: 4 passed.
test_increase_taxable_earnings_for_social_security.py: 4 passed (after the fix).
test_source_conflicts.py: 103 passed.

Mutants: none. This round changes descriptions, comments and tests, plus the merge resolution, which keeps both sides' formulas verbatim.

CI

Pull request run 41407953599 at 62a9f63e69: success, all 34 jobs passed. That includes Contrib other-shard-1, which failed at 7cb554e630.

Judgment calls

The date comment paraphrases §§ 43(a) and 45 from the review's quotes. I couldn't reach malegislature.gov from this session, so that reading is unverified by me; the review quotes the text.
Possible source-conflict entry. The MA 2027 date follows § 43(a) and DFML over § 45's literal "taxable years" clause. I worded the comment so it doesn't trip the source-conflict ratchet. If the hub treats it as a statute-versus-agency reading, it belongs in the register with a marker on those two lines; I didn't add one, because the register lives in rulespec-us.
"(c)-(d)" in the reference titles comes from the review's reading of § 6 (subsection (c) holds the caps, (d) the small-employer rule). I couldn't open the section to confirm the lettering.
The new aggregate case is in a new variable-named file, not in state_payroll_premium_deduction_share.yaml, per CLAUDE.md's variable-named YAML rule.
PR body. I also removed two local review-file paths from the body.

Proposed follow-up issue

Model the federal wage treatment of an employer's pick-up of state PFML employee premiums (Rev. Rul. 2025-4; Notice 2026-6)
When employer_state_payroll_premium_deduction_share < 1 in CO, DE, ME, MA, MN or WA from 2026, the undeducted employee premium should count as the employee's W-2 wages for income tax and FICA, and be deductible as a state tax if itemizing. Today the model raises net income by the full amount: CO 2026, $100,000 at share 0.5 omits 7.65% × $220 = $16.83 of FICA plus the income tax on $220.

Reply to DTrim99

Thanks for the review. Taking each item in turn:

Should address, three descriptions. Rewritten to the template, using your wording: ma/.../family_employee_share.yaml:1, ma/.../medical_employee_share.yaml:1 and de/.../employee_share.yaml:1.
Suggestion 1, the federal pick-up. Not modeled in this PR. It is proposed as a follow-up issue (Rev. Rul. 2025-4; Notice 2026-6), with your CO example as the witness, and the PR body says so. The input's docstring already states the limitation; the issue link can be added once the issue exists.
Suggestion 2, YAML cases. Both added with your numbers, which I re-derived:
- MA 2027, $250,000, share 0.5 → 442.29 / 1,249.95 (ma_employee_paid_leave_contribution.yaml, last case).
- CO employer aggregate at share 0.5 → 6,600 (new employer_total_additional_state_payroll_tax.yaml).
Suggestion 3, text fixes.
- The "Not in this PR" bullet is updated.
- The invariants docstring no longer says NY and WA put the premium on the employer (test_state_payroll_premium_deduction_share_invariants.py:3-9).
- Both MA references now cite "Section 6(c)-(d)".
- The one-line date comment sits beside each 2027-01-01 entry.
Branch. main is merged in. The Delaware conflicts with Fix Social Security secondary earnings threshold reform #10380 keep main's wage base and this PR's share.
- The merged tree exposed one failure: Fix Social Security secondary earnings threshold reform #10380's test_donut_invariants hand-supplies the DE formulas' inputs and lacked the share.
- 62a9f63e69 supplies the default share of 1. The reform itself needs no change.

Generated by Claude Code

MaxGhenis · 2026-11-03T20:37:43Z

Hub review in progress

Head under review: 62a9f63e6970896ee993fe119305d71036af81ca (unchanged since the hand-off).

Firm so far:

Merge. The Delaware resolutions keep main's (Fix Social Security secondary earnings threshold reform #10380) wage base and references verbatim and this PR's share verbatim (diffed against each parent). The head merges cleanly with current main (6145ad4513).
Hand values recompute from the parameters: MA 2027 884.58 permitted → 442.29 / 1,249.95; CO aggregate 6,600.
Tests pass at the head, one file per process: share YAML 16, aggregate YAML 1, MA YAML 11, 2027 premiums YAML 12, CBO contrib DE YAML 1, invariants 2, CBO donut 4, payroll contributions 100, input definitions 4, source conflicts 103.
CI run 41407953599 at the head: 34/34 jobs passed.
Possible P2. source_conflicts/candidates.yaml on main already holds us-ma:pfml-cap-swap-effective-date (state open, follows: conflicting-source, code: []) for this PR's MA date. The PR doesn't update it, and the hand-off says no register entry was needed.
No law source reachable from this VM (the proxy blocks malegislature.gov, mass.gov, hklaw.com, govinfo.gov, ecfr.gov and irs.gov).

Mutants and the default-share comparison against main: running.

Generated by Claude Code

MaxGhenis · 2026-11-03T21:40:46Z

Ready for hub review
VERDICT: APPROVE
62a9f63
METHODOLOGY_CHOICE: yes

Delta review of 6ad174a080..62a9f63e69: the merge of main at bc830d69c7 (main side 97b6d5135c), the review changes at 7cb554e630, and the CI fix at 62a9f63e69. The head hasn't moved since the hand-off. It merges cleanly with current main (6145ad4513, 95 commits later), and none of those commits touches a payroll path.

I found no P1. At the default share, outputs are bit-identical to current main. Every new expected value recomputes. All six mutants are killed. DTrim99's should-address item is resolved. There is one P2 (a stale source-conflict backlog item for the MA date, which the hand-off missed) and three P3s.

Findings

P2-1. The MA 2027 date is an open source-conflict backlog item that this PR leaves stale

Where: source_conflicts/candidates.yaml:3636-3666 (on main since 2026-10-20, so it reaches this branch through the merge). The deciding lines are policyengine_us/parameters/gov/states/ma/tax/payroll/paid_leave/family_employee_share.yaml:5-7 and medical_employee_share.yaml:5-7.
What it says: item us-ma:pfml-cap-swap-effective-date has state: open, pe_us.follows: conflicting-source and code: []. Its note says "the open PR follows the 2027 reading, while main has no cap swap. Code not yet on main". The file's own legend defines conflicting-source as "against the statute; the 2026-10-19 rule calls for a model change".
What the hand-off says: "If the hub treats it as a statute-versus-agency reading, it belongs in the register ... I didn't add one, because the register lives in rulespec-us." It also says the comment was "worded ... so it doesn't trip the source-conflict ratchet". The in-repo backlog item already exists, and the PR neither cites nor updates it.
Failure scenario: once this merges, the backlog says no code implements the reading (code: [], "not yet on main"), which is false. It also still says the code follows a source against the statute, with the conflict open. Under CLAUDE.md's 2026-10-19/20 rule, that classification calls for a model change. No output is wrong, but a reader of the register is told the shipped 2027 date is undecided and contrary to statute.
Command: sed -n 3636,3667p source_conflicts/candidates.yaml at the head prints the entry above. uv run pytest -q policyengine_us/tests/code_health/test_source_conflicts.py gives 103 passed: the check doesn't catch this, because code: [] lists nothing.

Fix (before merge; the classification is the hub's call):

Decide the reading. In my view §43(a) is itself statute, so this is a tie between §45 and §43(a) that DFML's practice breaks. That is CONTRIBUTING's "the agency breaks true ties" case, not "against the statute". If Max's "decide and cite" stands as the ruling, record it.

Replace the item's pe_us, state and note with:

  pe_us:
    follows: statute
    code:
    - policyengine_us/parameters/gov/states/ma/tax/payroll/paid_leave/family_employee_share.yaml
    - policyengine_us/parameters/gov/states/ma/tax/payroll/paid_leave/medical_employee_share.yaml
    - policyengine_us/parameters/gov/states/ma/tax/payroll/paid_leave/family_rate.yaml
    - policyengine_us/parameters/gov/states/ma/tax/payroll/paid_leave/medical_rate.yaml
    prs:
    - https://github.com/PolicyEngine/policyengine-us/pull/10285
  state: ruled
  note: The code follows s. 43(a) and DFML, dating the swap 2027-01-01; the 2026 cases in
    ma_employee_paid_leave_contribution.yaml pin 460 on $100,000 against 772 under the literal s. 45 reading.

If the hub doesn't treat it as ruled, keep state: open and follows: conflicting-source, but still fill in code: and correct the note.

P3-1. The MA reference titles say "Section 6(c)-(d)", but the comment two lines above names (e)

Where: family_employee_share.yaml:14 and medical_employee_share.yaml:14.
The mismatch: the same files' comments (line 5) say §26 and §25 strike the figure in "s. 6(c)(2), (d) and (e)(2)" and "(c)(1), (d) and (e)(1)". DTrim99's report says the swap reaches covered business entities through (e).
Failure scenario: a reader following the title goes straight past the covered-business-entity caps.
Fix: - title: Massachusetts General Laws Chapter 175M Section 6(c)-(e) in both files.
Caveat: I couldn't open c. 175M §6 from this VM (see below), so this rests on the PR's own comment and DTrim99's quote.

P3-2. The body has no `impact:` line

Where: PR body, "## Impact". It has a heading and prose, but no literal impact: line next to axiom:.
Fix: add impact: none at the default share; outputs bit-identical to main in a 480-household × 8-variable × 2025–2027 comparison; no population run needed.

P3-3. The CI fix pins the share to 1 where it could draw it

Where: test_increase_taxable_earnings_for_social_security.py:204-206.
Does it still check Fix Social Security secondary earnings threshold reform #10380's claim? Yes. test_donut_invariants asserts that the CBO reform leaves the DE contributions equal to baseline, with the same inputs in both runs. The reform doesn't override any DE variable (grep -rl for the DE contribution variables and the share in policyengine_us/reforms finds nothing), so the claim is the same for any share, and supplying 1 doesn't weaken it.
What it no longer covers: the share now varies on the baseline path but not in this test. Drawing it as deduction_share=st.floats(min_value=0, max_value=1), passed in place of the literal 1, would cover the reform at a partial share at no extra model cost. Optional.

DTrim99's review, item by item

Item	Status at the head
Should address: three descriptions	Resolved. `de/.../employee_share.yaml:1`, `ma/.../family_employee_share.yaml:1` and `ma/.../medical_employee_share.yaml:1` each read "[State] limits ... under the [...] program" with no acronym, using his suggested wording verbatim.
Should address (implied): merge main for #10295	Resolved. Merged at `bc830d69c7`. `state_paid_leave_premiums_2027.yaml` (#10295) passes 12/12 at the head.
Suggestion 1: federal pick-up (Rev. Rul. 2025-4; Notice 2026-6)	Left unmodeled. The reason holds, and this is a follow-up, not a defect this PR adds. At the default share nothing moves. At a share below 1, main had no way to express the case: it overstated the employee's deduction by the whole undeducted amount (CO 2026, $100k, share 0.5: main 440, the law about 220). The head gets the deduction right and omits only the federal add-back (DTrim99's figure: $16.83 of FICA, plus income tax on $220). The limitation is in the docstrings. The follow-up issue is proposed in the hand-off but not filed; the hub raises it.
Suggestion 2: two YAML cases	Resolved. MA 2027 $250k at share 0.5 gives 442.29 / 1,249.95 (`ma_employee_paid_leave_contribution.yaml`, last case). CO aggregate gives 6,600 (new `employer_total_additional_state_payroll_tax.yaml`). Both recompute (below), and both are mutant-tested.
Suggestion 3a: "Not in this PR" bullet	Resolved. The body now says #10295 is merged in.
Suggestion 3b: test-module docstring (NY, WA)	Resolved. `test_state_payroll_premium_deduction_share_invariants.py:3-9` describes NY as "authorized but not required to collect" and WA as an employee share the employer "may deduct up to and may pay in any part".
Suggestion 3c: full subsection path in titles	Resolved as asked ("6(c)-(d)"). See P3-1 for (e).
Suggestion 3d: date comment	Resolved. One line at `family_employee_share.yaml:6` and `medical_employee_share.yaml:6`. Its wording matches the §45 and §43(a) quotes in DTrim99's report; I couldn't fetch the act itself.

Every should-address item is resolved, so the hub can dismiss the CHANGES_REQUESTED review (5591620322) with a note. P2-1 is new and not one of his items.

Checked and sound

Delaware merge.
- I diffed each DE file against both parents.
- Against main's side (97b6d5135c), the only changes are this PR's docstring and the share: permitted * state_payroll_premium_deduction_share (de_employee_paid_leave_contribution.py:22-33) and * (1 - deducted) with deducted = p.employee_share * share (de_employer_paid_leave_contribution.py:22-35).
- Against the PR's side (6ad174a080), the only changes are Fix Social Security secondary earnings threshold reform #10380's min_(payroll_tax_gross_wages, social_security.cap) wage base and its two references.
- Both sides are kept verbatim.
- The employer aggregate's DE branch uses employer_total_taxable_earnings_for_social_security both here and on main, so Fix Social Security secondary earnings threshold reform #10380 didn't change it and the merge doesn't either.
Hand values, from the parameters at the head (system.parameters). The 2027 SS cap is 192,300; MA 2027 family is 0.007 and medical 0.0018, with caps 0.4 / 1; CO 2026 is 0.0044 / 0.0044.
- MA permitted = (0.4 × 0.007 + 0.0018) × 192,300 = 884.58. Employee = 0.5 × 884.58 = 442.29. Employer = 0.6 × 0.007 × 192,300 + 442.29 = 807.66 + 442.29 = 1,249.95.
- CO = 0.0044 × 1,000,000 + 0.5 × 0.0044 × 1,000,000 = 6,600.
- I computed these with exact fractions before reading the formulas.
Impact at the default share.
- Setup: one script run once per tree, against current main (6145ad4513). The grid is 16 states × 5 wage levels (0 to 250k) × 6 employer sizes (5 to 100) = 480 one-person households, for 2025, 2026 and 2027.
- Variables: employee_state_payroll_tax, employer_state_payroll_tax, employer_additional_state_payroll_tax, employer_total_additional_state_payroll_tax, employer_total_state_payroll_tax, employee_payroll_tax, household_net_income and income_tax.
- Result: all 24 arrays are bit-identical (np.array_equal). The diff can't move a baseline output, so no population check is needed beyond what the hub already runs.
The defect at main. grep -rl employer_state_payroll_premium_deduction_share on main finds nothing, so main can't express a partial deduction. A CO worker at $100k shows employee_state_payroll_tax = 440 in 2026 whatever the employer deducts.

Tests at the head (one file per process, thread caps at 4):

File	Result
`state_payroll_premium_deduction_share.yaml`	16 passed
`employer_total_additional_state_payroll_tax.yaml`	1 passed
`ma_employee_paid_leave_contribution.yaml`	11 passed
`state_paid_leave_premiums_2027.yaml`	12 passed
`contrib/cbo/payroll/de_employee_paid_leave_contribution.yaml`	1 passed
`test_state_payroll_premium_deduction_share_invariants.py`	2 passed
`test_increase_taxable_earnings_for_social_security.py`	4 passed
`test_payroll_contributions.py`	100 passed
`test_input_variable_definitions.py`	4 passed
`code_health/test_source_conflicts.py`	103 passed

Mutants. The hand-off lists none for this round. I ran six, each in its own process on the review checkout, restoring after each; git status is clean at 62a9f63e69.

Mutant	Killed by
M1: the DE employee formula drops the share (a merge that kept main's `return`)	`state_payroll_premium_deduction_share.yaml` (2 cases) and the invariants test (AssertionError at :177)
M2: the DE employer formula reverts to main's `(1 - p.employee_share)`	the same YAML (2 cases) and the invariants test (:185)
M3: the MA 2027 family cap is left at 1	`ma_employee_paid_leave_contribution.yaml` (4 cases)
M4: the aggregate's CO branch drops the undeducted term	`employer_total_additional_state_payroll_tax.yaml` (the new case)
M5 (mine): the MA employer formula uses uncapped `employment_income`	`ma_employee_paid_leave_contribution.yaml` (1 of 11 cases fails; 10 pass)
M6: the CI fix reverted	`test_donut_invariants`, `KeyError: 'state_payroll_premium_deduction_share'`

Readers.
- state_payroll_premium_deduction_share is read by 16 state-gated program variables (CO, DE, MA, ME, VT, WA on both sides; MN and the two NY employee sides) and by the employer aggregate.
- employer_state_payroll_premium_deduction_share is read by the clip variable and named in the docstrings of employee_state_payroll_tax and employer_additional_state_payroll_tax.
- family_employee_share and medical_employee_share are read by the two MA variables and the aggregate.
- The DE variables are read by de_employee_state_payroll_tax and de_employer_additional_state_payroll_tax.
- No reform reads or overrides any of them. Nothing becomes reachable and worse at the default share.
CI. Run 41407953599 at the head passed 34/34 jobs, including Contrib other-shard-1, which failed at 7cb554e630.
Scope and overlap.
- Nothing under .github/ or tests/policy/baseline/partners/.
- Open PRs that name the changed files: Model the Minnesota Paid Leave employer premium #10294 (MN employer premium, which builds on this PR) and Zero a separate filer's whole standard deduction and exclude dependent care benefits from wages #10579. Both merge cleanly with this head (git merge-tree). Start CO FAMLI, Paid Leave Oregon and WA Cares at their program dates, and add 2019–2024 Washington PFML premiums #10154 is closed.
Body and hand-off claims checked: the test counts, "34 jobs passed", the file:line pointers, the 2027 rates passing 12, and that the reform doesn't redefine the DE variables. The axiom: line is present (eight queued and one n/a). I didn't recheck the rulespec issues, which are outside this session's repository scope.

What I couldn't check

Law sources. This VM's proxy blocks malegislature.gov, mass.gov, hklaw.com, govinfo.gov, ecfr.gov, uscode.house.gov, irs.gov and delcode.delaware.gov. I couldn't read M.G.L. c. 175M §6(c)–(e), Acts 2026 c. 101 §§25, 26, 43, 45 and 49, DFML's 2027 rates page, or Rev. Rul. 2025-4 and Notice 2026-6.
- So the 2027 date note at family_employee_share.yaml:6 agrees with the quotes in DTrim99's report and the earlier hub review, but I haven't confirmed it against the act.
- The same goes for the 2027 MA rates (0.70% / 0.18%) and the 2027 SS base (192,300), which I took from the parameters.
- One web-search summary paraphrased Bloomberg Government as saying employers "pay 40% of the family leave contribution" and "withhold 60%". That is the reverse of DFML's split as quoted in both reviews ("Up to 40% ... can be withheld (0.28% of eligible wages)"). I couldn't open either page to settle it, and I read the summary as a paraphrase error. The hub may want to confirm against DFML before merge.
Population data. I ran no microsimulation. The household comparison above is the impact check.
Linux CI memory for the new YAML files: not measured; CI's green run covers them.
The author's 13 earlier mutants (mutants.py on the hub's machine): not rerun. The formulas they targeted are unchanged in this round except the DE merge, which M1 and M2 cover.

Generated by Claude Code

MaxGhenis · 2026-11-03T22:54:50Z

Picking this up for the US hub. I'll post a hand-off comment here when it's ready.

Generated by Claude Code

…ction-share

The backlog item still said no code implemented the 2027 date. List the four parameter files that carry it and say the code follows DFML's 2027-01-01 date while keeping 2026 on the old split, as main does. The 2026 question under s. 45 stays open, so state and follows are unchanged. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LwQq6HsvgHCDJEA9psAheP

Acts 2026 c. 101 ss. 25-26 change the figures in s. 6(c)(1)-(2), (d) and (e)(1)-(2), so the title should reach (e), where the covered business entity caps sit. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LwQq6HsvgHCDJEA9psAheP

MaxGhenis · 2026-11-04T00:22:06Z

Ready for hub review

Head: b68dbc4c8291f3d014fc7d34e035c3d923401b0b

This round fixes P2-1 the hub's way and fixes P3-1 from the round 2 review. P3-2 (the impact: line) and P3-3 (drawing the share in the donut test) are left for the hub, and the PR body is unchanged.

Commits

be044affc4: merge origin/main (9f0242f6de) into the branch, as a merge commit. No conflicts. Of the 540 files it brings in, two overlap this round's work: source_conflicts/candidates.yaml and policyengine_us/tests/code_health/test_source_conflicts.py.
7aaffd1e89: update the MA cap-swap backlog item to match the code.
b68dbc4c82: cite c. 175M § 6(c)-(e) in the two MA employee-share titles.

What was asked and how I resolved it

Pick-up and merge. Pick-up comment posted. Merged origin/main with a merge commit (no rebase); no files conflicted. I reran the PR's test files after the merge (see Tests).
P2-1: us-ma:pfml-cap-swap-effective-date (source_conflicts/candidates.yaml:3694).
- state: open and pe_us.follows: conflicting-source are kept (:3717, :3725). It isn't marked ruled.
- pe_us.code lists four files. All four carry the 2027-01-01 date.
  - family_employee_share.yaml:7 and medical_employee_share.yaml:7 carry the cap swap.
  - family_rate.yaml:6 and medical_rate.yaml:6 carry DFML's matching rate swap.
- prs: was already on this item on main, holding this PR's URL only. It's unchanged, and the test accepts it.
- The note now says what the code does (:3726-3728), with no decision number.
- Command: uv run pytest -q policyengine_us/tests/code_health/test_source_conflicts.py gives 103 passed.
P3-1: titles. family_employee_share.yaml:14 and medical_employee_share.yaml:14 now read Massachusetts General Laws Chapter 175M Section 6(c)-(e). I didn't fetch c. 175M § 6 or Acts 2026 c. 101 myself. The subsection list comes from the hub's 2026-11-03 reading of those sources and matches the files' own line-5 comments.
Left for the hub: P3-2 and P3-3, as instructed. The body is not edited.

`candidates.yaml` diff

   pe_us:
     follows: conflicting-source
-    code: []
+    code:
+    - policyengine_us/parameters/gov/states/ma/tax/payroll/paid_leave/family_employee_share.yaml
+    - policyengine_us/parameters/gov/states/ma/tax/payroll/paid_leave/medical_employee_share.yaml
+    - policyengine_us/parameters/gov/states/ma/tax/payroll/paid_leave/family_rate.yaml
+    - policyengine_us/parameters/gov/states/ma/tax/payroll/paid_leave/medical_rate.yaml
     prs:
     - https://github.com/PolicyEngine/policyengine-us/pull/10285
   state: open
-  note: 'A rule-required model change depends on resolving the two statutes; the open PR follows the 2027 reading,
-    while main has no cap swap. Code not yet on main: policyengine_us/variables/.../employee_state_payroll_tax,
-    ma_employee_paid_leave_contribution (YAML).'
+  note: The code follows DFML's January 1, 2027 date for the cap and rate swap and keeps 2026 on the old split, as
+    main does. Whether §45's 2026 date governs stays open. At $100,000 of 2026 wages the code gives a $460
+    employee contribution; applying the swap in 2026 under §45 would give $772.

Hand computation of the 2026 witness

The 2026 parameters at the head are family rate 0.0018, medical rate 0.007, family share 1 and medical share 0.4.

Head: (0.0018 × 1 + 0.007 × 0.4) × 100,000 = 460.
§ 45 reading (shares swapped to 0.4 and 1 in 2026, 2026 rates kept): (0.0018 × 0.4 + 0.007 × 1) × 100,000 = 772.

I computed both with exact fractions. The model agrees: ma_employee_paid_leave_contribution for 2026 gives 460 at the head and 772 under a reform that sets the two shares to 0.4 and 1 for 2026. The figures match the item's existing example: line.

Tests at the head

One file per process, after the merge.

File	Result
`ma_employee_paid_leave_contribution.yaml`	11 passed
`employer_total_additional_state_payroll_tax.yaml`	1 passed
`state_paid_leave_premiums_2027.yaml`	12 passed
`state_payroll_premium_deduction_share.yaml`	16 passed
`contrib/cbo/payroll/de_employee_paid_leave_contribution.yaml`	1 passed
`test_input_variable_definitions.py`	4 passed
`test_payroll_contributions.py`	100 passed
`test_state_payroll_premium_deduction_share_invariants.py`	2 passed
`test_increase_taxable_earnings_for_social_security.py`	4 passed
`code_health/test_source_conflicts.py`	103 passed

The two Python files that use hypothesis first failed to collect, because the VM's environment lacked that dev dependency. After uv pip install hypothesis they passed as listed.

Mutants

None. This round changes no formula or value: one YAML metadata title per file and the backlog item. A mutant to the backlog item's paths would fail its tracked-file check, but I didn't run one.

CI

Pull request run 41738540327 at b68dbc4c82 was still in progress 60 minutes after the push (00:21Z). 34 jobs had succeeded and none had failed. Two were still running: Contrib other-shard-1 and Contrib other-shard-3. The hub should confirm the final conclusion before landing.

Judgment calls

The two rate files are in code:. They carry 2027-01-01 rather than a share. The 460-versus-772 witness depends on the shares, but under the § 45 reading the 2026 rates would also have to move with them to keep the totals. So the rates are part of the dated decision. Drop them if the hub wants only the deciding lines.
The note says "cap and rate swap". It says that because the code dates both at 2027-01-01.
No # Source conflict marker is added. The item isn't registered, and markers must name registered entries.

Proposed follow-up

None beyond those already raised in round 2. The hub has the federal pick-up issue.

Generated by Claude Code

MaxGhenis and others added 2 commits October 19, 2026 14:33

Seed small-employer and capped-wage workers in the deduction share in…

f160968

…variants Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

MaxGhenis marked this pull request as ready for review October 19, 2026 19:06

Scope the Rev. Rul. 2025-4 note to the state paid leave funds

727ebcb

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

MaxGhenis mentioned this pull request Oct 19, 2026

Model the Minnesota Paid Leave employer premium #10294

Open

MaxGhenis and others added 2 commits October 19, 2026 17:44

Merge main into payroll-employer-deduction-share

33b1f90

Brings in main through 1661d71, including #10279's update to North Carolina SA Case 37, which was the only CI failure. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Merge branch 'main' into payroll-employer-deduction-share

3698893

MaxGhenis mentioned this pull request Oct 19, 2026

Encode the published 2027 state paid leave premiums (CO, WA, NY, NJ) and cite the unchanged 2027 rates #10295

Merged

Merge main into payroll-employer-deduction-share

6ad174a

Brings in main through c39af98 (#10185, #10199 and others) so CI runs on the combined tree. The two sides share no files. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

PavelMakarchuk mentioned this pull request Oct 20, 2026

Start CO FAMLI, Paid Leave Oregon and WA Cares at their program dates, and add 2019–2024 Washington PFML premiums #10154

Merged

DTrim99 requested changes Oct 20, 2026

View reviewed changes

This was referenced Oct 22, 2026

Point the IN-MT source-conflict candidates at their code on main #10351

Merged

Fix Social Security secondary earnings threshold reform #10380

Merged

Apply each year's California SDI rate and the pre-2024 SDI wage limit #10255

Merged

claude added 2 commits November 2, 2026 06:29

claude added 3 commits November 3, 2026 22:55

Merge remote-tracking branch 'origin/main' into payroll-employer-dedu…

be044af

…ction-share

This was referenced Nov 6, 2026

Add Maryland FAMLI payroll contributions #10674

Draft

Give state employee payroll taxes their 2018-2027 histories #10695

Open

Give state employer unemployment taxes their 2018-2026 histories #10700

Draft

Navigation Menu

Repository navigation

Let employers deduct less than the permitted state payroll premium, and apply Massachusetts' 2027 PFML cap swap - #10285

Let employers deduct less than the permitted state payroll premium, and apply Massachusetts' 2027 PFML cap swap#10285
MaxGhenis wants to merge 13 commits into
mainfrom
payroll-employer-deduction-share

MaxGhenis commented Oct 19, 2026 •

edited

Loading

Uh oh!

codecov Bot commented Oct 19, 2026 •

edited

Loading

Uh oh!

MaxGhenis commented Oct 19, 2026

Uh oh!

MaxGhenis commented Oct 19, 2026 •

edited

Loading

Uh oh!

DTrim99 commented Oct 20, 2026

Uh oh!

DTrim99 left a comment

Uh oh!

MaxGhenis commented Nov 2, 2026

Uh oh!

MaxGhenis commented Nov 2, 2026

Uh oh!

MaxGhenis commented Nov 3, 2026 •

edited

Loading

Uh oh!

MaxGhenis commented Nov 3, 2026

Uh oh!

MaxGhenis commented Nov 3, 2026 •

edited

Loading

Uh oh!

MaxGhenis commented Nov 4, 2026

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

MaxGhenis commented Oct 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What this changes

Programs and the rule each follows

Massachusetts: why 2027-01-01 and not 2026-01-01

Invariants

Tests run locally

Review

Review of 2026-10-20 (DTrim99)

CI

Not in this PR

Impact

Uh oh!

codecov Bot commented Oct 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

MaxGhenis commented Oct 19, 2026

Uh oh!

MaxGhenis commented Oct 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

DTrim99 commented Oct 20, 2026

PR Review: Let employers deduct less than the permitted state payroll premium, and apply Massachusetts' 2027 PFML cap swap

Summary

Critical (must fix)

Should address

Suggestions

Verified correct

Axiom line assessment

CI status

Branch status

Uh oh!

DTrim99 left a comment

Choose a reason for hiding this comment

Uh oh!

MaxGhenis commented Nov 2, 2026

Uh oh!

MaxGhenis commented Nov 2, 2026

What the item asked for

CI failure the merge exposed, and its fix

Tests run (one file per process)

CI

Judgment calls

Proposed follow-up issue

Reply to DTrim99

Uh oh!

MaxGhenis commented Nov 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

MaxGhenis commented Nov 3, 2026

Findings

P2-1. The MA 2027 date is an open source-conflict backlog item that this PR leaves stale

P3-1. The MA reference titles say "Section 6(c)-(d)", but the comment two lines above names (e)

P3-2. The body has no impact: line

P3-3. The CI fix pins the share to 1 where it could draw it

DTrim99's review, item by item

Checked and sound

What I couldn't check

Uh oh!

MaxGhenis commented Nov 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

MaxGhenis commented Nov 4, 2026

Commits

What was asked and how I resolved it

candidates.yaml diff

Hand computation of the 2026 witness

Tests at the head

Mutants

CI

Judgment calls

Proposed follow-up

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

MaxGhenis commented Oct 19, 2026 •

edited

Loading

codecov Bot commented Oct 19, 2026 •

edited

Loading

MaxGhenis commented Oct 19, 2026 •

edited

Loading

MaxGhenis commented Nov 3, 2026 •

edited

Loading

P3-2. The body has no `impact:` line

MaxGhenis commented Nov 3, 2026 •

edited

Loading

`candidates.yaml` diff