docs: Task 69 README + AIRGAP_INSTALL — v2.0 React UI quickstart

- README.md: quickstart now leads with `uvicorn runtime.api:get_app`
  (backend that also serves the SPA) + `cd web && npm run dev` for
  the Vite dev path. Streamlit demoted to "legacy / deprecated".
  Status block calls out v2.0.0-rc1 and points to RELEASE.md +
  REACT_UI_PARITY.md.
- docs/AIRGAP_INSTALL.md: new "v2.0 — React UI in the air-gap payload"
  section. Describes the build + package_airgap.py flow, the
  dist/airgap/ layout, and ASR_WEB_DIST env var resolution.

Author: aksOps

README.md

@@ -33,7 +33,17 @@ uv run pytest tests/ -x
 # Run the incident-management app via the CLI entrypoint
 uv run python -m runtime --config config/incident_management.yaml
 
-# Streamlit UI
+# Backend API (serves the React SPA at / when web/dist exists)
+uv run uvicorn runtime.api:get_app --factory --port 8000
+
+# React UI (Vite dev server; proxy /api/v1 -> :8000)
+cd web && npm ci && npm run dev    # http://localhost:5173
+
+# Production: build once, then the backend serves it at http://localhost:8000
+cd web && npm run build && cd ..
+uv run uvicorn runtime.api:get_app --factory --port 8000
+
+# Legacy Streamlit UI (deprecated in v2; banner inside)
 ASR_LOG_LEVEL=INFO uv run streamlit run src/runtime/ui.py --server.port 37777
 ```
 
@@ -50,10 +60,16 @@ Set provider keys in `.env` (`OLLAMA_API_KEY`, `OPENROUTER_API_KEY`,
   contributor loop: setup, regenerating `dist/`, adding a runtime
   module.
 - **[`docs/AIRGAP_INSTALL.md`](docs/AIRGAP_INSTALL.md)** —
-  air-gapped / internal-mirror install procedure.
+  air-gapped / internal-mirror install procedure (includes the v2
+  React UI air-gap layout).
+- **[`docs/RELEASE.md`](docs/RELEASE.md)** — cutting a release
+  candidate; `npm run build` + `scripts/package_airgap.py` + git tag.
 
 ## Status
 
-`main` carries v1.0 → v1.5. v2.0 (React UI replacing the Streamlit
-prototype) is the next big move. See `docs/DESIGN.md` § 13 for the
-milestone history and § 14 for the pending list.
+`main` carries v1.0 → v1.5. **v2.0.0-rc1** ships the React UI
+(Vite + React 19 + TS + Tailwind v4 + Radix primitives) in `web/`
+which replaces the Streamlit prototype. The legacy Streamlit UI
+remains shippable behind a deprecation banner until parity is
+verified (`docs/REACT_UI_PARITY.md`). See `docs/DESIGN.md` § 13
+for the milestone history.

docs/AIRGAP_INSTALL.md

@@ -51,3 +51,38 @@ uv lock --check    # exit 0 = in sync; non-zero = regenerate with `uv lock`
   installs on any host (HARD-02 / CONCERNS C2).
 - Ship vendored wheels as a separate tarball if your host has no mirror at
   all; populate `~/.cache/uv` (or `UV_CACHE_DIR`) before running step 3.
+
+## v2.0 — React UI in the air-gap payload
+
+The React SPA in `web/` is built ahead of time and shipped as static
+assets alongside the Python bundle. The backend serves it from `/`
+via `runtime.api_static.mount_static_assets` so there is no separate
+Node process on the deploy host.
+
+```bash
+# On a host with internet (one time, or each release):
+cd web && npm ci && npm run build
+cd ..
+uv run python scripts/build_single_file.py    # framework + app bundles
+uv run python scripts/package_airgap.py       # composes dist/airgap/
+
+# Ship dist/airgap/ to the air-gap host. Layout:
+#   dist/airgap/
+#     app.py           # flattened framework + incident-management
+#     ui.py            # legacy Streamlit (deprecation banner)
+#     web/             # built React SPA (Vite output)
+#     README.txt
+```
+
+On the air-gap host:
+
+```bash
+ASR_WEB_DIST=./web \
+  python -m uvicorn app:get_app --factory --port 8000
+# open http://<host>:8000/
+```
+
+`ASR_WEB_DIST` is read by `runtime.api_static.mount_static_assets`.
+If unset, the backend falls back to `<bundle>/web/dist` (legacy dev
+layout). When neither resolves, the SPA mount is skipped silently and
+the API still serves on `/api/v1/*`.