diff --git a/README.md b/README.md
index 0125092..8656899 100644
--- a/README.md
+++ b/README.md
@@ -2,17 +2,25 @@
 
 A cross-platform, non-destructive RAW photo editor for Linux and Android.
 
-**Status:** early. v0.1 is a remote library viewer — see
-[docs/milestone-v0.1.md](docs/milestone-v0.1.md).
+**Status:** 0.9.0, and no longer a spike. A library opens, culls, develops and
+exports on both platforms, across eight tagged releases. What is *not*
+built is written down rather than merely absent — see
+[docs/outstanding.md](docs/outstanding.md) for the requirements that have no
+implementation and why, and [docs/technical-debt.md](docs/technical-debt.md)
+for the compromises that were chosen.
 
 ## Documentation
 
 | Document | Contents |
 |---|---|
-| [requirements.md](docs/requirements.md) | What the software must do — 122 numbered requirements |
+| [CONTRIBUTING.md](CONTRIBUTING.md) | How to land a first change without reading the rest |
+| [requirements.md](docs/requirements.md) | What the software must do — 179 numbered requirements |
 | [architecture.md](docs/architecture.md) | How it is built — crates, GPU pipeline, data model, sync |
-| [milestone-v0.1.md](docs/milestone-v0.1.md) | The first buildable milestone |
-| [faces.md](docs/faces.md) | Face detection and identity — the models, the licence problem, and what S14 measures |
+| [technical-debt.md](docs/technical-debt.md) | Compromises taken deliberately, each with the condition that retires it |
+| [outstanding.md](docs/outstanding.md) | What is not built, and whether that is a decision or a gap |
+| [code-health.md](docs/code-health.md) | What a contribution costs, per seam, measured |
+| [traceability.md](docs/traceability.md) | Generated: which requirement is claimed by which file |
+| [faces.md](docs/faces.md) | Face detection and identity — the models, the licence problem, and what S14 measured |
 
 ## Building
 
@@ -28,21 +36,48 @@ Android (containerised toolchain, see [docker/android](docker/android/README.md)
 ./docker/android/build.sh cargo ndk -t arm64-v8a build --release
 ```
 
+Git LFS is required for the model weights, and the toolchain pins itself.
+[CONTRIBUTING.md](CONTRIBUTING.md) has the details and the four commands CI
+will run against what you send.
+
 ## Current state
 
-Working: workspace, GPU context and compute pass, adaptive Slint shell, Android
-cross-compilation of the core crates.
+**Working.** A catalog over a local folder, a Nextcloud account, or a folder a
+sync client keeps in virtual-files mode — where a placeholder is treated as the
+photograph rather than as a one-byte file. A virtualised library grid with a
+capture-time timeline, ratings, labels, keywords, collections and a trash that
+survives a crash mid-operation. Card ingest. Face detection and identity, with
+the index syncing between devices. A develop pipeline of fifteen declared
+operations fused into a single compute dispatch, plus the neighbourhood
+operations that cannot be — clarity, texture, capture sharpening, noise
+reduction, lens correction, spectral film simulation. Crop, straighten, spot
+removal, gradient and subject-segmentation masks, named presets, and a
+generated panel that no operation in `ui/` is allowed to name. Export to JPEG,
+PNG and 8- or 16-bit TIFF with resize and output sharpening.
 
-**Not yet working:** the zero-copy display path. The build currently uploads
-frames through the CPU, which is exactly what
-[ARCH §6.1](docs/architecture.md) forbids — measured at 96% of frame time at
-4K. Replacing it is spike S1, the project's highest priority.
+**The zero-copy display path works on desktop.** The compute pass writes a
+texture that Slint composites directly, which is what
+[ARCH §6.1](docs/architecture.md) requires; the readback it forbids costs 96%
+of frame time at 4K, and
 
-```
+```bash
 cargo run -p dr-gpu --example bench --features readback
 ```
 
-reproduces that measurement.
+still reproduces that measurement. **The one exception is the Android develop
+view**, which reads the frame back through the CPU because zero-copy there
+needs wgpu's Vulkan swapchain, and that tears a portrait window on a tablet
+whose panel is mounted landscape. It is debt, not a revision of the rule: the
+reasoning, the on-device measurements that forced it, and the three separate
+things any one of which would remove it are in
+[technical-debt.md TD-1](docs/technical-debt.md).
+
+**Not built.** Plugins, compare and survey culling, focus peaking, burst
+grouping, AI denoise, tiled and progressive rendering, and most of the Android
+platform integration beyond running. The performance targets in §4.1 are
+unverified rather than unmet — the per-commit benchmark suite §8 requires does
+not exist, so nothing fails a build on a regression.
+[docs/outstanding.md](docs/outstanding.md) is the list, with the reasoning.
 
 ## Licence