NZ source packages, wave 3: local geography (TA / SA2)

Open

#178 opened on Aug 18, 2026 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language: Python
Stars: 0
Forks: 1
Avg merge: 11h 48m
Merged PRs (30d): 45

Description

Lanes: packages under ledger-source-ingestor; the sa2 geography level under ledger-contract-maintainer
Depends on: conventions from #175/#176; not started until epic microcosm#343 opens local-area scope (v0 doctrine: national first; local areas filter one national dataset)

Context

Filed for scope visibility, mirroring UK wave 3 (#134). NZ local-area calibration would back TA/SA2-grain targets. Unlike the UK there is no local target profile declared yet — profile extension follows the packages.

Candidate packages

Backing	Package(s)	Source mechanics
Census 2023 totals by topic at SA2	`stats_nz/census_2023_individuals_sa2`, `stats_nz/census_2023_households_sa2`	ArcGIS hub CSV part-files; ~2,300 SA2s — whole-table orientation mandatory, `rows:` geometry only
MBIE quarterly rents at SA2	`mbie/tenancy_bond_rents_sa2`	`detailed-quarterly-tenancy-2020-to-2026.csv` (11 MB, SA2 grain), `selected_rows` restriction
LEED earnings by TA	`stats_nz/leed_earnings_by_ta`	ADE curated extract (mean/median earnings, filled jobs by TA, quarterly)
HUD dashboard TLA cuts	extend `hud/housing_dashboard_*` (#177)	Social-housing register + AS by TLA
Subnational projections (2023-base)	`stats_nz/subnational_projections_2023_base`	Only if populace targets forward local years; `assertion: source_projection`

Contract dependency

A first-class sa2 geography level (deliberately not statistical_scope — SA2 is a general statistical geography like msoa), with vintage sa2_2023. One small contract-lane PR, the msoa precedent.

Acceptance

Every declared local family resolves from a consumer artifact at its geography level with full lineage; the first SA2 package settles the row-spec form for ~2,300-row tables and documents it in docs/agent-source-package-harness.md if not already covered; coverage vs the (future) local profile enumerated with signed exclusions — no silent drops.

Sizing

~5–6 packages ≈ 2–3 PRs + 1 contract PR. The SA2 census packages are the expensive ones — budget as UK wave 3 did.

Contributor guide

Open the contributing guide

First steps

Read the whole issue, then the project's contributing guide.
Comment on the issue to say you are picking it up — it saves two people doing the same work.
Fork the repository and make your change on a branch.
Open a pull request that references the issue number.

Research direction

Start by reading the conventions from #175 and #176, then check microcosm#343 for the local-area scope and the sa2 contract-lane precedent. Review the packages under ledger-source-ingestor and the sa2 level under ledger-contract-maintainer, including the first SA2 row-spec and docs/agent-source-package-harness.md. Done means the declared local families resolve from consumer artifacts with full lineage, signed coverage exclusions, and the required contract support.

Written by the indexing model from the issue text.

Assessment

Tech stack: python
Domain: data-engineering
Issue type: Feature
Difficulty: 5/5
Estimated time: Over a week
Activity status: Quiet
Clarity: Mostly clear
Newbie friendliness: 28/100