Skip to content

Populate remaining US tax-input and reported-observation layers #38

Description

@MaxGhenis

Summary

Track the remaining US input-layer work as source/profile work in live Populace, independent of any incumbent comparison surface.

Inputs to populate or explicitly classify

Pure tax inputs that should be sourced from the PUF donor/impute stage:

  • amt_foreign_tax_credit
  • general_business_credit
  • excess_withheld_payroll_tax
  • prior_year_minimum_tax_credit
  • early_withdrawal_penalty
  • other_credits

Formula-owned output with missing upstream support:

  • self_employed_health_insurance_ald should not be persisted directly. Populate the upstream self-employed health-premium inputs needed for the PolicyEngine-US formula.

Reported/comparison observations to classify:

  • spm_unit_net_income_reported
  • spm_unit_total_income_reported
  • ssi_reported

These are not formula-consumed benefits/taxes; decide whether Populace should carry them as reported observations or document their absence as named exclusions.

Acceptance criteria

  • The source/profile inventory records each variable as populated, upstream-populated, carried as reported observation, or reviewed-excluded.
  • The writer still rejects formula-owned outputs as final inputs.
  • Tests cover at least one populated PUF-derived credit, the SE-health upstream path, and the reported-observation classification.
  • Release diagnostics expose any reviewed exclusions.

Supersedes live Populace issue #26, which framed this as an incumbent-comparison gap. Benchmark/incumbent comparison discussion now belongs in PolicyEngine/populace-benchmarks.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions