diff --git a/README.md b/README.md index d53d4cb..6c0bd7b 100644 --- a/README.md +++ b/README.md @@ -145,7 +145,7 @@ convention. See [`docs/CLONING.md`](docs/CLONING.md). The FAO delivery reads Appwrite connection settings from the environment. The required names are **declared** in `unfao/appwrite_env.py` and validated fail-loud before any store is constructed — a missing or empty variable raises, naming every one that is absent, -rather than half-configuring a client. Coordinates come from the PLATFORM-001 registry +rather than half-configuring a client. Coordinates come from the Appwrite Seam Contract registry (referenced by URL, never copied); the API key is an operator slot: ```bash @@ -157,9 +157,7 @@ APPWRITE_DATASTORE_API_KEY=... # Production-forecasts store (input) APPWRITE_PROD_FORECASTS_BUCKET_ID=production_forecasts APPWRITE_PROD_FORECASTS_BUCKET_NAME=Production Forecasts -APPWRITE_PROD_FORECASTS_COLLECTION_ID=... # TODO: verify against live Appwrite — the - # previously-documented `forecasts_metadata` - # was found NOT to exist (un_fao postmortem) +APPWRITE_PROD_FORECASTS_COLLECTION_ID=production_forecasts APPWRITE_PROD_FORECASTS_COLLECTION_NAME=Production Forecasts # UN FAO store (output) diff --git a/docs/ADRs/013_sampled_forecast_wire_contract.md b/docs/ADRs/013_sampled_forecast_wire_contract.md index 0b34d9b..7d2cf02 100644 --- a/docs/ADRs/013_sampled_forecast_wire_contract.md +++ b/docs/ADRs/013_sampled_forecast_wire_contract.md @@ -689,7 +689,7 @@ a "simplification." this contract governs the **data** crossing the Appwrite seam; the **identity/config** crossing the same seam (which key, which coordinates, sourced from where, named how) is governed by - **[PLATFORM-001 — Identity, Secrets & Configuration Contract (VIEWS Appwrite seam)](https://github.com/views-platform/views-appwrite/blob/main/docs/ADRs/platform/PLATFORM-001_identity_secrets_configuration_contract.md)**, + **[the Appwrite Seam Contract — Identity, Secrets & Configuration Contract (VIEWS Appwrite seam)](https://github.com/views-platform/views-appwrite/blob/main/docs/ADRs/platform/the Appwrite Seam Contract_identity_secrets_configuration_contract.md)**, homed in views-appwrite and referenced here **by URL, never by copy** — with its coordinate registry ([`coordinate_registry.toml`](https://github.com/views-platform/views-appwrite/blob/main/docs/ADRs/platform/coordinate_registry.toml)) @@ -1105,7 +1105,7 @@ record execution progress against it. assignment and the concrete period remain OPEN and are deliberately deferred — they must close before the first full-S production run, not before. - **2026-07-28 — þing-01 verdict executed in this repo (seam's other half - contracted).** The platform ratified **PLATFORM-001** (identity/secrets/ + contracted).** The platform ratified **the Appwrite Seam Contract** (identity/secrets/ configuration for the Appwrite seam, homed in views-appwrite) — the plumbing half of the seam whose data half this ADR seals. This repo's follow-through, all merged: **P1/#134** — the implicit ensemble-dotenv borrow @@ -1114,7 +1114,7 @@ record execution progress against it. every store construction (PR #137). **P2/#135** — delivery-log/provenance redaction audit: CLEAN; guards pin the wire/delivery packages credential-blind and the provenance keyset closed (PR #136). **P3/#138** — §7(d) added: this ADR - now cross-references PLATFORM-001 by URL, never by copy. + now cross-references the Appwrite Seam Contract by URL, never by copy. - **2026-07-31 — the Hop-A LEGACY READER IS RETIRED; §11.4's transition is over on this side (#149, epic #148).** §11.4 required a type-aware guard live at each diff --git a/docs/CLONING.md b/docs/CLONING.md index ae0c005..e149ce0 100644 --- a/docs/CLONING.md +++ b/docs/CLONING.md @@ -35,7 +35,7 @@ Four declarations, and nothing may be inferred: ### 2. Your store coordinates — `unfao/appwrite_env.py` The env-var names your delivery requires, validated fail-loud before any store is -constructed. Names come from the **PLATFORM-001 coordinate registry** (homed in +constructed. Names come from the **Appwrite Seam Contract's coordinate registry** (homed in views-appwrite) and are referenced **by URL at a pinned commit, never copied**. The secret stays an operator slot. @@ -53,7 +53,7 @@ defect became three (register C-40); pipeline-core declines to offer the surface that refusal is deliberate. Write a thin client against the SDK, as views-faoapi did. **Get your own key before the first run, not after.** -Free at t=0, a migration later. One key per identity per environment (PLATFORM-001 +Free at t=0, a migration later. One key per identity per environment (the Appwrite Seam Contract §5.3). Do not reuse another service's key — this repository ran for months under a key named for pipeline-core, and nobody could state its scopes from evidence.