model_notes.md
# PT scope declaration — non-national fixture only
Created at: 2026-05-19T18:34:54Z
Run ID: `pt_scope_declared_non_national_20260519_1834Z`
Verdict/action: NARROWED_SCOPE_DECLARED_NON_NATIONAL.
The current Portugal artefacts under `/home/synthestat/output/PT` and the latest PT review bundle are explicitly not national-scale, not national-core complete, and not release-ready national microdata. They are a seeded internal review fixture over two test zones only (`SEC_PT_TEST_001`, `SEC_PT_TEST_002`).
## Observed fixture scale
- persons: 8
- households: 8
- dwellings: 8
- seeded cadastro-style buildings: 3
- zones: 2
## National targets that remain unmet
- Eurostat `demo_pjan` 2025 PT population: 10,749,635; current shortfall: 10,749,627 persons.
- INE `0008273` 2023 population cross-check: 10,639,726; current shortfall: 10,639,718 persons.
- Eurostat `cens_21hhcs_r3` 2021 PT private households: 4,149,096; current shortfall: 4,149,088 households.
## Allowed interpretation
This fixture may be used only for internal pipeline smoke testing, review-bundle packaging checks, and PT source/model gap diagnosis. It must not be relabelled as a national Portugal population, national core, PT PASS, or national dwelling/building/work/school assignment layer.
## Required before any national PT claim can be reopened
1. Freeze/catalogue national PT population and age-sex source payloads with retrieval timestamps, checksums, licences, code lists, geography levels, and reference periods.
2. Freeze/catalogue Eurostat/INE household total/composition sources and declare whether the selected household universe is HARD or FIRM.
3. Integrate national PT dwelling/building/address stock sources, or explicitly mark the layer unavailable/degraded with quantified coverage and uncertainty.
4. Build a new national runner whose person count equals the declared official national universe and whose household count fits the declared household constraint.
5. Emit a full population review bundle contract with national `build_manifest.json`, `constraint_residuals.json`, diagnostics, uncertainty, provenance, geography tiers, explicit unavailable overlays, and model notes.
Reference reviewer report: `/home/synthestat/workspace/manager_handoffs/reviewer/2026-05-19_183154Z_PT_national_scale_gap_closure_review.md`.