docs(design): add final validation evidence

PROJECT_STATE.md

@@ -263,3 +263,43 @@ claimed.
 ## Known blockers
 
 None. External service credentials may be absent; use the documented demo/degraded providers. The n8n workflow-activation steps are a one-time manual setup requirement in this environment (owner-account creation via n8n's own `/setup` UI cannot be scripted safely), fully documented in `docs/17-runbook.md` and scripted where possible (`make n8n-setup`). RAGcore and the ITWorx MCP Hub itself were never reachable in this environment — both integrations are implemented and directly tested/curl-verified against MobilityOps's own API, but neither a real RAGcore instance nor a real Hub round trip was available to confirm end-to-end.
+
+## Premium Control Rail UI transformation (2026-08-02)
+
+- Branch: `design/mobilityops-premium-ui`, branched from verified deployed revision
+  `dfabb41582e302f45a3de826f85f531bf23dfc8b`; master history was not rewritten.
+- Audited every route at 1440, 1280, 768 and 390 px. Baseline findings and captures are
+  in `docs/design/current-ux-audit.md` and `artifacts/design-validation/current/`.
+- Authored three twelve-screen product directions and generated representative Stitch
+  anchors in project `17018847755558569017`: Control Rail, Dispatch Ledger and Service
+  Atelier. Control Rail was selected and refined twice for hierarchy, accessibility and
+  responsive implementation. Decision, screen inventory, tokens and exact Stitch IDs
+  are in `docs/design/design-directions.md`, `docs/design/design-system.md` and
+  `docs/design/stitch-manifest.md`.
+- Rebuilt the complete React interface around a responsive Control Rail shell: inline SVG
+  icon/brand system, desktop rail, named landmarks, skip link, top bar, mobile bottom
+  navigation, shared loading/error/empty states and reduced-motion support.
+- Redesigned all shipped pages. The dashboard now prioritizes persisted readiness,
+  Attention and today's movements; booking results paginate at 25 rows; every responsive
+  table retains field labels; integrations distinguish n8n evidence, live RAGcore health
+  and the unconfigured MCP adapter without inventing status.
+- Return registration is now capture → review → result. A regression test proves the
+  return endpoint is not called before confirmation; the existing idempotency and local
+  commit/outbox contract is unchanged.
+- Final browser captures are in `artifacts/design-validation/implementation/`. DOM
+  measurements and Playwright both prove no horizontal overflow at 390, 768, 1280 and
+  1440 px. See `docs/design/implementation-validation.md`.
+- Final validation commands from this branch:
+  - `docker compose run --rm api pytest -q` — **66 passed**.
+  - `docker compose run --rm api ruff check .` — **All checks passed**.
+  - `docker compose run --rm api mypy app` — **0 issues in 44 files**.
+  - `cd frontend && npm run lint` — clean TypeScript check.
+  - `cd frontend && npm run build` — production build succeeded (59 modules; 238.66 kB JS,
+    36.54 kB CSS before gzip).
+  - `cd frontend && playwright test --reporter=line` — **18 passed** including the full
+    five-minute demo, every interactive route, return review semantics and four viewport
+    overflow checks.
+- Exact next action after this record: commit this evidence set, push
+  `design/mobilityops-premium-ui`, and deploy that branch to the
+  existing Unraid review stack without touching master or persistent volumes; verify live
+  health and responsive UI.