docs(ui): finalize MVP plan structure and de-archaeologize topic docs

MVP web client (Phases 1-30) is complete; reorganize planning + living docs around that.

- PLAN.md kept as the staged MVP record (1-30) with a status block + pointers; removed the 31-36 stages, regression scenarios, and deferred-TODO section (moved out); fixed a stale cross-machine plan path.

- ui/PLAN-finalize.md (new): active web-finalization plan in 8 stages (visual system, a11y, i18n, error UX, PWA, build hygiene, docs, owner manual-QA loop); absorbs former Phases 33 and 35.

- ui/ROADMAP.md (new): post-MVP (Wails, Capacitor, realistic projection, acceptance + regression scenarios) and triaged deferred follow-ups.

- ui/docs/README.md (new): grouped topic-doc index.

- De-archaeologized all 20 ui/docs topic docs + ui/README.md + ui/core/README.md: stripped Phase-N build history, rewritten as current-state; deferred work now points at ROADMAP.md / PLAN-finalize.md. Docs-only; no code change.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

ui/core/README.md

@@ -4,8 +4,9 @@
 Galaxy cross-platform UI client. It carries v1 transport-envelope
 canonical bytes, signature verification, and Ed25519 keypair
 helpers. Network I/O and persistent storage live elsewhere on
-purpose: this module compiles unchanged to WASM (Phase 5),
-gomobile (Phase 32), and Wails-embedded native (Phase 31).
+purpose: this module compiles unchanged to WASM (the web target today)
+and is designed to also compile to gomobile (mobile) and Wails-embedded
+native (desktop) — both planned, see [`../ROADMAP.md`](../ROADMAP.md).
 
 The authoritative byte contract is defined in
 [`docs/ARCHITECTURE.md` §15](../../docs/ARCHITECTURE.md). The gateway
@@ -39,8 +40,11 @@ parity and round-trip sign/verify are exercised by
 ```text
 ui/core/
 ├── go.mod               module galaxy/core (Go 1.26.0)
-├── calc/                ship-math wrappers over `pkg/calc/ship.go`
-│   └── ship.go          Phase 18 designer preview bridge
+├── calc/                thin wrappers over `pkg/calc/` (no math here)
+│   ├── ship.go          ship geometry, mass, speed, combat
+│   ├── planet.go        ship build cost / per-turn production
+│   ├── solve.go         goal-seek inverse solvers
+│   └── number.go        display rounding (Ceil3)
 ├── canon/               canonical-bytes builders and verifiers
 │   ├── canon.go         length-prefix helpers
 │   ├── request.go       galaxy-request-v1 fields and signing input
@@ -92,20 +96,16 @@ ui/core/
 
 ### `galaxy/core/calc`
 
-Thin Go bridge over `pkg/calc/ship.go`, surfaced via WASM to the
-Phase 18 ship-class designer preview. Each function is a one-line
-passthrough — no math lives here.
+Thin Go bridges over `pkg/calc/`, surfaced via WASM to the ship-class
+calculator and the ship-group inspector. Each function is a one-line
+passthrough — no math lives here. Coverage spans ship geometry / mass /
+speed / cargo, combat (attack, defence, bombing), block-upgrade and
+per-turn ship-build cost, the single-target goal-seek inverse solvers,
+and display rounding (`Ceil3`).
 
-- `DriveEffective(drive, driveTech float64) float64`
-- `EmptyMass(drive, weapons float64, armament uint, shields, cargo float64) (float64, bool)`
-- `WeaponsBlockMass(weapons float64, armament uint) (float64, bool)`
-- `FullMass(emptyMass, carryingMass float64) float64`
-- `Speed(driveEffective, fullMass float64) float64`
-- `CargoCapacity(cargo, cargoTech float64) float64`
-- `CarryingMass(load, cargoTech float64) float64`
-
-The full audit trail (which UI feature uses what, what is still
-deferred) lives in [`ui/docs/calc-bridge.md`](../docs/calc-bridge.md).
+The authoritative function surface (which UI feature uses what, parity
+rules, what is still deferred) lives in
+[`ui/docs/calc-bridge.md`](../docs/calc-bridge.md).
 
 ### `galaxy/core/types`
 
@@ -146,14 +146,15 @@ versa) is enforced from
 ## What this module is **not**
 
 - Not a network client. ConnectRPC over `@connectrpc/connect-web`
-  on the TypeScript side is the only network surface (Phase 5+).
-- Not a key store. Per-platform secure storage lives in Phase 6.
+  on the TypeScript side is the only network surface.
+- Not a key store. Per-platform secure storage lives in the platform
+  `KeyStore` / `Cache` layer on the TypeScript side.
 - Not a freshness gate. Server-side `±5 min` freshness checks
   remain in `gateway/internal/grpcapi/freshness_replay.go`. The
   client is expected to stamp its own `timestamp_ms` accurately
   via `time.Now`, but does not enforce a window.
-- Not a FlatBuffers codec — that lands in a later phase, so the
-  module today is small on purpose.
+- Not a FlatBuffers codec — report decoding lives on the TypeScript
+  side, so this module stays small on purpose.
 
 ## Cross-references
 
@@ -161,5 +162,5 @@ versa) is enforced from
   authoritative byte contract.
 - [`../../gateway/authn`](../../gateway/authn) — server mirror of
   the same canonical bytes.
-- [`../PLAN.md`](../PLAN.md) Phase 3 — the staged plan that
-  describes how this module fits into the wider client.
+- [`../PLAN.md`](../PLAN.md) — the staged plan that describes how this
+  module fits into the wider client.