Body
Review the Luxembourg (LU) population synthesis QA cycle 1 bundle produced by parent modeler task t_c006b7d1.
Project root: /home/synthestat
Country: LU
Release mode: internal research review
Parent orchestrator: t_59cdb7d9
Modeler parent task: t_c006b7d1
Required context:
- Read /home/synthestat/docs/SOUL.md and /home/synthestat/docs/contracts/population_review_bundle.md before reviewing.
- Use the parent modeler handoff and the bundle path/run_id in its kanban metadata or comments.
- Do not fix, rerun, research, download, or modify model outputs yourself. Review only.
Review scope:
Validate the review bundle contract and Synthestat guardrails for LU:
1. Required file completeness under output/runs/LU/<run_id>/, allowing unavailable.json only where the contract permits and only with explicit reason.
2. HARD/FIRM/SOFT/GUIDE constraint semantics: HARD exact, FIRM/SOFT within declared tolerances or explicitly relaxed, GUIDE not presented as measured truth.
3. Provenance: source IDs/URLs or catalogue links, retrieval timestamps where applicable, geography levels, reference periods, source quality flags, and source_catalogue/geography/crosswalk versions or explicit unknowns.
4. Uncertainty: no model-based estimates without uncertainty bounds or clear quality/degradation flags.
5. Geography: finest available official geography is used where supported; degraded zones are explicit.
6. Hidden/weakly measured populations: homelessness, refugees/asylum seekers, Ukrainian displaced people, Syrian refugees, undocumented/seasonal populations, students, institutional populations are included only as evidence-supported overlays or marked unavailable/unknown; overlays do not silently rewrite de jure constraints.
7. Household/dwelling/building/work-school realism: check diagnostics, unavailable-layer reasons, and overclaiming.
8. No silent degradation: missing sources, failed probes/downloads, relaxed constraints, unavailable layers, and modelled sparse variables are visible.
Return exactly one routing verdict in metadata.verdict:
- PASS
- NEEDS_MODEL_FIX
- NEEDS_MORE_SOURCES
- BLOCKED_INVALID_OUTPUT
- EVIDENCE_EXHAUSTED_HUMAN_REVIEW
- MODEL_IMPROVEMENT_EXHAUSTED_HUMAN_REVIEW
Allowed write paths:
- /home/synthestat/workspace/manager_handoffs/reviewer/
- optional durable QA memo under /home/synthestat/docs/wiki/outputs/
Definition of done:
1. Write a reviewer handoff/memo naming bundle_path, run_id, verdict, blocking findings, non-blocking findings, evidence gaps, and recommended next branch.
2. Complete this card with structured metadata containing verdict, bundle_path, run_id, blocking_findings, recommended_next_branch, and whether the bundle is contract_complete.
3. If verdict is NEEDS_MORE_SOURCES, name concrete source families/variables/geographies needed for marginals vs distributions vs downloader freeze so the manager can route narrowly.
4. If verdict is NEEDS_MODEL_FIX or BLOCKED_INVALID_OUTPUT, name exact files/diagnostics that failed and the minimum fix/rerun scope.
5. If verdict is PASS, state release limitations clearly for final human review.