Draft consultation shape

TLA-Perf — Living performance KPIs

Draft orbit: living-system performance KPIs with measurement method beside the spine.

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

Purpose

Define a portable living-performance pack so projects can declare KPI targets, units, measurement method, reporting period, and TLA-185 field links for sustainability claims.

This orbit packages how living performance is stated and measured. Carbon accounting methodologies and statutory filings stay in specialist protocols and TLA-EVID evidence.

Out of scope

Not this orbit	Where it lives
GHG inventory methodology	Specialist carbon protocols
Legal / statutory filings	Jurisdiction-specific compliance
Archive Seal	Commercial attestation
Second field dictionary	Spine — TLA-185

Enumerations (draft — freeze later)

Field	Allowed values (draft)
`kpis[].metric_class`	`canopy_cover \| survival_rate \| water_use \| biodiversity_proxy \| heat_mitigation \| other`
`measurement.method_class`	`survey \| sensor \| model \| professional_judgement \| mixed \| other`

Normative intent (when elevated from Draft)

When elevated from draft: performance claims in interchange metadata should be linkable to KPI rows and measurement method notes.
Targets without measurement method must carry explicit professional_judgement or unknown posture.
Reporting period bounds accompany KPI rows where a time window applies.

Foundation vs Archive

Foundation	Archive
Publishes the open KPI shape for teaching and sustainability disclosure language.	May implement richer monitoring integrations and paid analytics.
Does not certify outcome achievement.	Verified performance stays in evidence packs and operations.

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.living-performance.v1",
  "schema_version": 1,
  "pack_id": "perf-ex-001",
  "created_at": "2026-07-26T00:00:00.000Z",
  "kpis": [
    {
      "kpi_id": "kpi-survival-001",
      "metric_class": "survival_rate",
      "target": ">= 90%",
      "unit": "percent",
      "scope_note": "Street trees year 3 post-installation"
    }
  ],
  "measurement": {
    "method_class": "survey",
    "reporting_period": "2026-07-01/2029-06-30",
    "method_note": "Annual arborist inspection with tagged instances"
  },
  "tla185_refs": {
    "record_id": null,
    "field_paths": ["sustainability.performance_claim"]
  }
}