Split the Schedule D route of capital gain distributions out of long-term gains (US)#282
Open
MaxGhenis wants to merge 1 commit into
Open
Split the Schedule D route of capital gain distributions out of long-term gains (US)#282MaxGhenis wants to merge 1 commit into
MaxGhenis wants to merge 1 commit into
Conversation
Adds a capital_gain_distributions US source stage producing schedule_d_capital_gain_distributions as a memo component of long-term gains. No by-AGI CGD series exists in published SOI data (the SOCA study reports distributions only nationally and merges them into 'Other asset types' in its AGI cross-tab), so the v1 split applies the national Schedule-D share of LT net gains — $68.1B over $690.7B (TY2015, 9.85%) — proportionally within eligible records. Records with direct-route distributions (non_sch_d_capital_gains, PUF E01100) are excluded: the two reporting routes are mutually exclusive on a real return. New split_component_by_share manifest operation kind + US handler; the packaged resource carries the anchor arithmetic (re-derived at load), the by-AGI tables that do exist (direct-route TY2015/22/23, the 'other assets' envelope), and documented follow-ups (participation margin, AGI tilt, year-specific ICI levels, RIC/REIT split). Part of #274. Engine-side variable: PolicyEngine/policyengine-us#8850. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Part of #274. Engine-side variable: PolicyEngine/policyengine-us#8850 (the column this stage fills). Companion engine fix: PolicyEngine/policyengine-us#8839.
What
Adds a
capital_gain_distributionsUS source stage (afterpuf_tax_detail) producingschedule_d_capital_gain_distributions— the Schedule D line 13 route of capital gain distributions, as a memo component of long-term gains. This is the column that lets reforms treating fund distributions differently from other realized gains (the GROWTH Act, H.R. 2089 / S. 1839) act on the data.The data reality that shapes the design
The IRS publishes no by-AGI series for capital gain distributions. The Sales of Capital Assets study (latest: TY2015; discontinued since) reports a standalone CGD line only nationally — its by-AGI cross-tab merges CGD into "Other asset types." The only AGI-resolved CGD series anywhere (Pub 1304 Table 1.4) covers only the direct-1040 route (
E01100=non_sch_d_capital_gains, already a PUF-stage output), ~15% of the dollars.So v1 is deliberately deterministic and proportional — no fabricated band parameters:
long_term_capital_gains_before_responseand no direct-route distributions — the two reporting routes are mutually exclusive on a real return (this also prevents the impossible-overlap class flagged in Impute the Schedule-D-routed share of capital gain distributions within long_term_capital_gains (US) #274 from propagating into the new column).Pieces
split_component_by_sharemanifest operation kind (allowlisted) + US runtime handler with strict parameter/column validation (unknown params, unknown resource/share-field, overwrite, missing columns all refuse).us/soca_capital_gain_distribution_shares.jsonresource — generated programmatically from the downloaded SOI tables, never hand-transcribed; anchor arithmetic re-derived and refused on drift at every load.source_stages.json+ donor citation inUS_DONORS+ stage order.packages/populace-build: 694 passed, 6 skipped; ruff clean.Documented follow-ups (in the resource caveats)
Participation margin and AGI-band tilt (no published series pins them); year-specific levels via the ICI Fact Book Table 30 paid/reinvested series; the RIC vs REIT split (Schedule D line 13 includes REIT capital gain dividends, which the GROWTH Act does not cover) — sourced series for both now attached to #274.
🤖 Generated with Claude Code