release: add README_FULL.md

README_FULL.md

@@ -375,18 +375,34 @@ a hard zero cannot become a NaN.
 
 ### Repository map
 
+> **Scope of this repository.** It contains the **documentation and the source code only**. It
+> deliberately does **not** contain: datasets, the `artifacts/` tree (trained weights, checkpoints,
+> evaluation outputs), Jupyter notebooks, the static frontend, logs, or any credential. The six
+> trained artifacts are published on the [Hugging Face Hub](https://huggingface.co/thundercode/SatQuery);
+> the frozen backbones are fetched from the Hub at run time. Some documents cite the source
+> repository's internal phase reports by filename as provenance — those files are not part of this
+> release.
+
 | Path | Contents |
 |---|---|
-| `app/` | FastAPI inference service and its composition root |
-| `core/` | Config registry, evidence engine, contracts |
-| `specialists/` | One module per specialist (vqa, caption, grounding, change, optical_sar) |
-| `router/` | MiniLM intent router |
-| `gateway/` | Render orchestration hub (`/api/*`, CORS, wake flow) |
-| `frontend/` | The static console (HTML/CSS/JS) |
-| `configs/base.yaml` | The frozen configuration registry — single source of truth |
-| `evaluation/`, `training/` | Evaluation harnesses and training entry points |
-| `artifacts/` | Trained heads, checkpoints, evaluation outputs, provenance |
-| `docs/` | Architecture, models, benchmarks, deployment, limitations |
+| `app/` | FastAPI inference service and its composition root (`build_space_app()`, `serving.py`) |
+| `core/` | The typed contracts, config registry + loader, nine-state controller, planner, registry, errors |
+| `router/` | The MiniLM intent router: encoder, five-head adapter, classifier, lexical fallback, label space, dataset, training |
+| `specialists/` | One module per specialist: `vqa/`, `grounding/`, `change/`, `optical_sar/`, plus `base.py` |
+| `evidence/` | The evidence engine (aggregation) and the confidence/calibration module |
+| `preprocessing/`, `geospatial/` | Raster handling, tiling, normalisation, sensor adapters |
+| `gateway/` | The orchestrator / gateway (`/api/*`, CORS, wake flow, error translation) |
+| `deploy/` | Deployment entrypoints: Codespace `serve.py` + `tunnel_agent.py`, Render blueprint |
+| `training/`, `evaluation/` | Training entry points and evaluation harnesses |
+| `scripts/` | Repository scripts (data prep, calibration fitting, packaging) |
+| `tests/` | The test suite |
+| `configs/base.yaml` | The frozen configuration registry — the single source of truth for every tunable |
+| `docs/` | Architecture, models, benchmarks, datasets, training, evaluation, deployment, security, testing, operations, performance, glossary, limitations |
+| `models/` | The **generated** artifact manifest and checksums (identities, not the weights) |
+| `tools/` | Verification tooling (metric verification, manifest generation, archive tools) |
+| `screenshots/` | Real live-run captures referenced by the documentation |
+
+Not in this repository: `artifacts/`, `data/`, `notebooks/`, `frontend/`, `logs/`, `reports/`.
 
 The component inventory in full (every path is the authoritative location):
 
@@ -1116,8 +1132,8 @@ The deployed stack is reachable. Note the authoring sandbox has a dead proxy, so
 `--noproxy '*'` (curl) or `ProxyHandler({})` (Python):
 
 ```bash
-curl --noproxy '*' https://satquery-backend-m4yv.onrender.com/api/health
-curl --noproxy '*' https://satquery-backend-m4yv.onrender.com/api/capabilities
+curl --noproxy '*' https://<backend-host>/api/health
+curl --noproxy '*' https://<backend-host>/api/capabilities
 ```
 
 `/api/capabilities` returns six tasks, all `available: true`. A live run requires the tunnel agent to be
@@ -1144,7 +1160,7 @@ Render → start the Codespace if stopped → poll `/v1/health` → surface *"Wa
 | Component | Repository | Visibility | Revision | Host |
 |---|---|---|---|---|
 | Frontend | `Anish-lab-blip/SatQuery-Frontend` | private | **`2d7ae53b482d`** | Cloudflare Pages → `satquery.pages.dev` |
-| Backend / orchestrator | `Anish-lab-blip/SatQuery-Backend` | private | **`89d80eaddec5`** | Render → `satquery-backend-m4yv.onrender.com` |
+| Backend / orchestrator | `Anish-lab-blip/SatQuery-Backend` | private | **`89d80eaddec5`** | Render → `<backend-host>` |
 | Inference | `Anish-lab-blip/SatQuery-Inference` | private | **`5a0936ace491`** | Codespace, port 8000, via outbound tunnel |
 | Public umbrella | `Anish-lab-blip/SatQuery-AI` | **public** | `3dcabd32da41` | this release home |