Draft consultation shape

TLA-Hydro — Hydrozone / water budget

Draft orbit: hydrozone identity and water-budget metadata beside the spine.

Schema id: la.archive.hydrozone.v1 · Spine: TLA-185

Purpose

Define a portable hydrozone pack so projects can declare zone identity, annual water budget, irrigation method, and TLA-185 climate / site field links.

This orbit packages water-demand assumptions for living performance review. Detailed hydraulic engineering models stay in specialist tools and evidence packs.

Out of scope

Not this orbit	Where it lives
Hydraulic pipe network BIM	Engineering authoring environments
Utility billing / meter integration	Operations systems
Archive Seal	Commercial attestation
Second field dictionary	Spine — TLA-185

Enumerations (draft — freeze later)

Field	Allowed values (draft)
`hydrozone.irrigation_method`	`none \| drip \| spray \| subsurface \| passive \| mixed \| other`
`hydrozone.water_source`	`municipal \| harvested \| recycled \| groundwater \| other \| unknown`

Normative intent (when elevated from Draft)

When elevated from draft: sustainability or performance claims that assume a water budget should be linkable from this pack.
Budget figures carry method notes and reporting period where available.
Passive and mixed irrigation methods are first-class enum values.

Foundation vs Archive

Foundation	Archive
Publishes the open hydrozone shape for teaching and water-stewardship language.	May implement richer irrigation design tools and paid workflows.
Does not guarantee water savings outcomes.	Measured performance stays in operations and evidence packs.

Golden example (illustrative)

Minimal worked example for consultation. Not a production product API. Download JSON · Required-keys schema (Draft). Repo smoke: npm run validate:orbits.

{
  "schema_id": "la.archive.hydrozone.v1",
  "schema_version": 1,
  "pack_id": "hydro-ex-001",
  "created_at": "2026-07-26T00:00:00.000Z",
  "hydrozone": {
    "zone_id": "hz-public-lawn-a",
    "irrigation_method": "spray",
    "water_source": "municipal",
    "water_budget": {
      "annual_mm": 420,
      "source_note": "Derived from local ET reference and species mix"
    }
  },
  "tla185_refs": {
    "record_id": null,
    "field_paths": ["climate.water_demand", "site.irrigation_zone"]
  }
}