Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 2 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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)
Expand Down
6 changes: 3 additions & 3 deletions docs/ADRs/013_sampled_forecast_wire_contract.md
Original file line number Diff line number Diff line change
Expand Up @@ -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))
Expand Down Expand Up @@ -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
Expand All @@ -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
Expand Down
4 changes: 2 additions & 2 deletions docs/CLONING.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -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.

Expand Down
Loading
Loading