release: add docs/CHANGELOG.md

docs/CHANGELOG.md

@@ -0,0 +1,137 @@
+# Changelog
+
+All notable changes to SatQuery AI. Dates are ISO-8601. This changelog records **what changed and
+what was verified**, and marks unresolved items honestly rather than omitting them.
+
+Status tags: `RESOLVED` · `OPEN` · `CLOSED` · `DEFERRED` · `REJECTED`.
+
+---
+
+## [1.0.0] — 2026-09-25 — Final documentation, model release and archival freeze
+
+The release that makes the project legible and citable: repository documentation, research
+documentation, model documentation, a Hugging Face model release, a curated public repository, and a
+verified evidence archive.
+
+### Added
+- **Repository README** (27 sections) — motivation through citation, with the deployed topology, the
+  six supported tasks, routing, the eight execution events, measured results, live validation, and
+  known limitations.
+- **Research documentation set** — `ARCHITECTURE.md`, `MODELS.md`, `BENCHMARKS.md`, `DATASETS.md`,
+  `TRAINING.md`, `EVALUATION.md`, `DEPLOYMENT.md`, `REPRODUCIBILITY.md`, `LIMITATIONS.md`,
+  `RESEARCH_NOTES.md`, `CHANGELOG.md`.
+- **Model documentation** — `MODEL_CARD.md`, generated `models/manifest.json` and
+  `models/checksums.sha256`.
+- **Hugging Face release** of the six trained artifacts to `thundercode/SatQuery`, with a verification
+  record.
+- **Curated public repository** at `Anish-lab-blip/SatQuery-AI` with a release manifest.
+- **Evidence archive** (ZIP64, artifacts verbatim) with an integrity-verified extraction and a
+  documented remote location.
+- **Metric verification tool** — `tools/verify_readme_metrics.py`, checking all 20 quoted metrics and
+  the status assertions against their artifacts.
+
+### Changed
+- The monorepo `README.md` was **materially stale** and is superseded by this release's README. The
+  stale version called the frontend "hermetic — no backend calls", put Render/Codespace as
+  "in progress", described a `/v1/*` contract, and pointed at the untracked `deploy/` as the
+  deployment source. All four were wrong.
+- `hf/` documentation was **stale** — it asserted the project "does not own any model weights … ships
+  no weights, no binaries, and no large artifacts" and "has no Hugging Face credentials". Both were
+  false at release time and are corrected.
+
+### Fixed
+- **Router defect** — *"Where are the built-up areas in this image?"* collapsed to `vqa` and answered
+  "River". Fixed in the dispatch path and validated across three independent live passes (8/8 each).
+  `RESOLVED`.
+- **Live-validation harness false positive** — synthetic CDP key events were silently dropped when the
+  window lacked OS focus, so the harness dispatched the page's default query and recorded a false
+  pass. Fixed with pre-dispatch form-state assertions. `RESOLVED`.
+- **Bundled EO change pair** — the demo pair differed in shape (726² vs 736²) and errored. Replaced
+  with a same-shape pair (both 720×720). `RESOLVED` (supersedes `FINAL_DELIVERY_REPORT.md` §6).
+- **B-01 (Hugging Face header link)** — previously `BLOCKED`; the link is now live on all 11 pages.
+  `CLOSED`.
+
+### Known issues at this release
+- **B-07** — transient tunnel-agent gaps; a request can hang or return 504. Patch prepared, **NOT
+  deployed**. `OPEN`.
+- **B-02** — `/api/health` `codespace_name` carries a trailing `\n`. Cosmetic. `OPEN`.
+- **No `LICENSE` file** exists. `OPEN`.
+- **No system-level end-to-end benchmark** exists. `NOT RUN`.
+- **Router test split** never scored. `NOT RUN`.
+- **Calibration** worsened ECE (0.013755 → 0.014929). Retained as part of the frozen config only.
+- **VLM adapter** is `ACCEPTANCE-REJECTED` despite usable metrics; the deployed path uses the
+  unadapted model.
+- **optical-SAR** and **change-VQA** rulings remain `OPEN`.
+
+### Deployment revisions at this release
+| Component | Revision |
+|---|---|
+| Frontend | `2d7ae53b482d` |
+| Backend | `89d80eaddec5` |
+| Inference | `5a0936ace491` |
+| Public umbrella | `3dcabd32da41` |
+
+---
+
+## [0.9.0] — 2026-09-25 — Router-defect sprint
+
+- Diagnosed and fixed the router misroute (region queries → `vqa`).
+- Deployed three commits to the frontend.
+- Ran **3 independent live validation passes**, 8/8 each — 24 live runs, 24 correct dispatches,
+  0 mock nodes, trace fill 94.4444 %.
+- Wrote the delivery report and handoff.
+
+---
+
+## [0.8.0] — 2026-09-24/25 — Deployment hardening
+
+- Live topology settled on **Cloudflare Pages → Render → outbound tunnel → Codespace** (CPU).
+- Closed the five historical backend blockers (ASGI stack in requirements; `$PORT` read; `OPTIONS`
+  preflight; fail-fast app construction; adapter integrity compared against an expected digest).
+- Documented cold start; `transport_mode: auto` fallthrough recorded.
+
+---
+
+## [0.7.0] — Grounding and change heads
+
+- Grounding: trainable head over frozen RemoteCLIP ViT-B/32. Resolution **224 chosen, 448 rejected**
+  by a pre-registered paired test.
+- Change: STANet-style Siamese detector on LEVIR-CD-256 — the only `VERIFIED` headline metric.
+- Optical-SAR: CROMA-base fusion head, seed sweep, pre-registered 115-class metric.
+
+---
+
+## [0.6.0] — VLM adaptation
+
+- SmolVLM-500M LoRA adapter trained (PEFT 0.19.1, r = 16, α = 32).
+- Metrics usable (exact_match 0.963) but **acceptance-rejected** for promotion. `REJECTED`.
+- Findings F5-1/F5-2/F5-3 recorded (loader class, ~17× processor overrun, chat-template requirement).
+
+---
+
+## [0.5.0] — Router
+
+- 50,822-parameter adapter over frozen MiniLM; cached embeddings; CPU-only training (0.28 s for 20
+  epochs / 4,096 vectors).
+- Group-based splits with hard negatives in the test split.
+
+---
+
+## [0.1.0] — Foundation
+
+- Monorepo, frozen configuration registry (`configs/base.yaml`), config-hash freeze
+  (`78f1e3700da15aa1`), nine-state controller, four-endpoint inference contract, evidence schema
+  (`Region` / `ChangeRegion`), eight frontend execution events.
+
+---
+
+## Unreleased / open
+
+| Item | State |
+|---|---|
+| Deploy the B-07 tunnel-fallthrough fix | prepared, **NOT deployed** |
+| Score the router test split | **NOT RUN** |
+| Build a system-level end-to-end benchmark | **NOT RUN** |
+| Select a licence | **OPEN** |
+| Resolve the optical-SAR and change-VQA rulings | **OPEN** |
+| Plot the calibrated reliability curve | **NOT RUN** |