Body
Build the Slovenia (SI) population synthesis QA cycle 1 review bundle.
Project root: /home/synthestat
Country: SI
Target geography: finest available official geography
Release mode: internal research review
Parent orchestration task: t_4c5698ab
Mandatory contract:
- Follow /home/synthestat/docs/contracts/population_review_bundle.md exactly.
- Output under /home/synthestat/output/runs/SI/<run_id>/ using a deterministic run_id and seed.
- Required artifacts include synthetic_persons, synthetic_households, synthetic_dwellings or unavailable.json, synthetic_building_assignments or unavailable.json, hidden_population_overlays or unavailable.json, work_school_assignments or unavailable.json, build_manifest.json, constraint_residuals.json, distribution_diagnostics.json, household_diagnostics.json, dwelling_building_diagnostics.json, assignment_diagnostics.json, geography_quality_tiers.json, uncertainty_summary.json, source_provenance.json, and model_notes.md.
Scope goal:
Build the best available 1:1 synthetic population for SI: persons in households, households in dwellings, dwellings in real houses/buildings where evidence supports it. Include separate uncertainty-aware overlays where evidence supports hidden or weakly measured populations: homelessness, refugees/asylum seekers, Ukrainian displaced people, Syrian refugees, undocumented/seasonal populations, students, and institutional populations. Include family composition, parent/child age gaps, school attendance, work/school assignment, and dwelling/building realism where supported by evidence.
Non-negotiables:
- HARD constraints must match exactly. Do not relax HARD constraints.
- Hidden-population overlays must not silently rewrite de jure population constraints.
- Modelled estimates must carry uncertainty bounds; no fake precision.
- Fine-geography occupation/industry/family/assignment estimates are model-driven unless directly measured and must be flagged.
- Every missing source, degraded zone, relaxation, unavailable layer, failed download, and modelled estimate must be explicit in manifest/diagnostics/provenance/model_notes.
- Reuse existing Synthestat modules and country-slice patterns; do not duplicate country-specific synthesis logic.
Allowed writes:
- /home/synthestat/output/runs/SI/<run_id>/
- /home/synthestat/workspace/manager_handoffs/modeller/ for handoff/status notes
- Minimal docs/wiki/outputs note only if useful for durable review context
Definition of done:
- A contract-complete bundle exists at /home/synthestat/output/runs/SI/<run_id>/.
- The handoff names run_id, output path, row counts for persons/households/dwellings/buildings if available, HARD/FIRM/SOFT/GUIDE residual status, unavailable/degraded layers, source/provenance caveats, and exact commands/tests run.
- If a valid bundle cannot be produced, produce a precise blocked/invalid-output handoff instead of silently degrading.