Latest summary
Rebuilt the XK national candidate with age-aware adult-reference household assignment, capped private 10+ households, explicit unresolved residual buckets, recomputed household diagnostics, consistent +12 dwelling residual documentation, and reconciled provenance hash semantics. The rebuilt bundle at /home/synthestat/output/runs/XK/xk_population_national_candidate_2024_muni_bf4a4f87_seed420987 now has 0 all-child/single-child/underage-reference failures and a reviewer follow-up card t_efd44c77.
Body
Reviewer verdict for XK national candidate xk_population_national_candidate_2024_muni_bf4a4f87_seed420987: NEEDS_MODEL_FIX. Report: /home/synthestat/workspace/manager_handoffs/reviewer/2026-05-19_183030Z_XK_population_review_national_gap_closure.md
Acceptance criteria:
- Rebuild household/person assignment with age-aware, family/role-aware constraints: children must not be placed alone or made reference persons unless a separately sourced institutional/exceptional category is emitted.
- Replace unbounded 10+ top-code overflow allocation. Current review found households up to size 2,802; cap plausible private-household size or route residuals to explicit unresolved/institutional/degraded bucket with quantified residual.
- Recompute household diagnostics including member count vs household.size, all-child households, underage reference persons, household size percentiles/max, municipality residuals, and unresolved residual bucket.
- Fix diagnostics consistency: model_notes says conventional dwelling FIRM residual 0 but constraint_residuals and row counts show +12 against 556,779.
- Reconcile source_provenance records_used hashes with top-level source_files hashes or document why they refer to different canonical artefacts.
- Add numeric uncertainty/tolerance statements for modelled internal household sizes and any other model-driven fields.
Important review evidence: bundle is no longer fixture-scale (1,602,515 persons; 366,595 households; 556,791 dwellings), source_files hashes on disk verify, but household/family structure is invalid at scale (125,638 all-under-15 households; 25,535 single-under-15 households; 144,336 under-18 reference persons; 13 households >500 persons).