Body
Build the CZ cycle-1 population synthesis review bundle for internal research review.
Project root: /home/synthestat
Country: CZ
Target geography: finest available official geography that the current code/source layer can support without fabricating precision.
Release mode: internal research review.
Required contract:
- Follow /home/synthestat/docs/contracts/population_review_bundle.md exactly.
- Emit a reviewable bundle under /home/synthestat/output/runs/CZ/<deterministic_run_id>/ containing all required files or unavailable.json with explicit reasons.
- Include 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.
Population ambition:
- Best possible 1:1 synthetic population for CZ: persons in households, households in dwellings, dwellings in real houses/buildings where available.
- Include explicit separate uncertainty-aware overlays for hidden or weakly measured populations where evidence supports them: homelessness, refugees/asylum seekers, Ukrainian displaced people, Syrian refugees, undocumented/seasonal populations, students, institutional populations.
- Include family composition, parent/child age gaps, school attendance, work/school assignment, and dwelling/building realism where evidence supports it; otherwise mark unavailable/weak/modelled explicitly.
Guardrails:
- HARD constraints must not break. Do not silently relax or rewrite de jure constraints.
- Model-based estimates without uncertainty bounds are invalid.
- Hidden-population overlays must not silently alter de jure/core population constraints.
- Fine-geography occupation/industry/work-school/building assignments are model-driven unless measured and must be flagged.
- Every missing source, relaxed constraint, degraded zone, failed download, unsupported variable, modelled estimate, and quality caveat must be explicit in outputs.
- Reuse existing Synthestat modules and country-slice/generator patterns; do not duplicate country-specific synthesis logic.
- Maintain provenance: source IDs, URLs or catalogue references, retrieval timestamps if live-retrieved, geography levels, reference periods, quality flags.
Allowed write paths:
- /home/synthestat/output/runs/CZ/** for the bundle.
- /home/synthestat/workspace/manager_handoffs/modeller/** for concise handoff/status notes.
- If and only if needed for a durable memo, /home/synthestat/docs/wiki/outputs/**.
Do not write to config/sources.yaml, output/catalogue, or production registries unless the task finds an existing approved generator path that is explicitly part of producing the review bundle.
Definition of done:
- Bundle path and run_id are reported in the handoff.
- Required contract files are present or replaced by explicit unavailable.json where allowed.
- HARD residual status is stated.
- Known limitations and evidence gaps are explicit enough for synth-reviewer to return one of the official routing verdicts.
- Include commands/tests run and any failures/degradations.