Prepend roadmap warning block — Section 4 is stale, rewrite pending

docs/roadmap.md

@@ -1,3 +1,44 @@
+> ⚠ **THIS ROADMAP NEEDS REWRITING — 2026-04-27**
+>
+> The vision (Sections 1–3) and design principles (Section 5) remain
+> valid. **Section 4 ("What exists today") is stale and must not be
+> treated as current.** Specifically:
+>
+> **1. The global tessera.db no longer exists on a reachable server.**
+> The Dell pipeline node has been decommissioned. The TESSERA 4.0
+> architecture replaces the global database with a per-hex pipeline
+> that writes directly to `data/otivm.sqlite3`. New hexes are added
+> one H5 at a time by the dataset assistant as the game expands.
+> References to "TESSERA global pipeline", "Stage 05 running",
+> "assembling on Dell pipeline node" are all obsolete.
+>
+> **2. The roadmap does not mention the restoration layer.**
+> `terrain` in `data/otivm.sqlite3` is modern WorldCover 2021 data.
+> It is wrong for any historical period. The Mediterranean was 60–70%
+> forested in Roman times and Mesolithic times. The restoration layer
+> (HYDE 3.3 + KK10 datasets) will correct terrain to historically
+> appropriate values when it is built. Until then, no release may
+> present terrain data as historically accurate. This is a significant
+> gap in the roadmap that affects the scope of OTIVM-III through
+> OTIVM-VI.
+>
+> **3. Release numbering is out of date.**
+> OTIVM-III in this roadmap describes "The Factor" (NPC model). The
+> actual next release must first establish the SQLite server connection
+> and replace the placeholder map coastline. The Factor is deferred
+> until after the database and map work is complete. Discuss with the
+> project owner before acting on any release scope in this document.
+>
+> **The roadmap rewrite is the first task for the game development
+> assistant. Do not write code until the roadmap is current and
+> approved by the project owner.**
+>
+> Current state is accurately described in `docs/handover-game-dev.md`.
+> Dataset state is in `docs/handover-dataset.md`.
+> Full dataset inventory and triage is in `docs/TESSERA-dataset-registry.md`.
+
+---
+
 # OTIVM — Roadmap
 
 *otium · Latin: leisure, rest, creative withdrawal. The condition under which civilisation advances.*
@@ -101,9 +142,7 @@ TESSERA is a globally consistent, immutable, academically grounded encoding of E
 | 5 | Geology deposit | USGS MRDS |
 | 6–7 | Occupation evidence | RFC-TESSERA-3.0-OCC-001 |
 
-Every field value is traceable to a named, versioned, citable source dataset. Every tile, once generated, is content-addressed by its SHA-256 hash. The global pipeline covers the interaction sphere 15N–72N, 15W–75E: 8,591,961 H7 tiles, 421,006,081 H9 cells, zero errors across all completed stages.
+Every field value is traceable to a named, versioned, citable source dataset. Every tile, once generated, is content-addressed by its SHA-256 hash. H9 resolution (~180m) is the primary data resolution. H7 is the tile unit. H3's hierarchical structure means any OTIVM location encoded as an H3 ID at any resolution can be mapped to its TESSERA physical properties without coordinate transformation.
-
-H9 resolution (~180m) is the primary data resolution. H7 is the tile unit. H3's hierarchical structure means any OTIVM location encoded as an H3 ID at any resolution can be mapped to its TESSERA physical properties without coordinate transformation.
 
 ### The simulation layer — CIVICVS
 
@@ -125,17 +164,21 @@ Azgaar's Fantasy Map Generator produces GeoJSON and SVG exports of political geo
 
 ## 4. What exists today
 
-These are verifiable claims about what is built and running as of April 2026.
+> ⚠ **This section is stale as of 2026-04-27. See warning at top of
+> document. Do not treat as current. The roadmap rewrite will replace
+> this section.**
 
-**TESSERA global pipeline:** Stages 00–04 complete. Elevation, terrain, hydrology, geology flag, and geology deposit encoded for 8,591,961 H7 tiles. Stage 05 (geology assembly) running as of 2026-04-25. Phase 1 ~80% complete, ETA phase 2 complete ~2026-04-27. Stage 06 (culture sampling, four Mesolithic cultures) not yet written — this is the byte that OTIVM-VIII depends on for tracing goods to Mesolithic cultures. Global SpatiaLite database assembling on Dell pipeline node.
+These are verifiable claims about what was built and running as of April 2026 — before the architecture change to TESSERA 4.0 per-hex pipeline.
 
-**TESSERA v3.0 scoped dataset:** Not yet assembled. Depends on stages 05 and 06. Target: four-culture bounding box, <10 GB, fits Proliant local-lvm.
+**TESSERA global pipeline:** Stages 00–04 complete. Elevation, terrain, hydrology, geology flag, and geology deposit encoded for 8,591,961 H7 tiles. Stage 05 (geology assembly) crashed at 97.3% and was abandoned. Stage 06 (culture sampling) not written. Global SpatiaLite database (tessera.db) on Dell pipeline node — decommissioned.
 
-**TESSERA API:** Code exists. Not yet deployed to production container.
+**TESSERA 4.0 scoped dataset:** `data/otivm.sqlite3` — 12,005 H9 rows across five Mediterranean waypoints, all `status=2`. `paleo_epochs` table populated with 9 epochs. Per-hex pipeline not yet built — see `docs/handover-dataset.md`.
+
+**TESSERA API:** Not yet deployed.
 
 **CIVICVS Simulator:** Shell API operational. Corpus in ChromaDB. Map and Scene containers in development. Real weather integration specified, not yet running continuously.
 
-**OTIVM:** Container provisioned on srv-a (LXC 1105, otivm-dev). React 19 + Vite frontend scaffold committed. PM2 serving built output on port 3000. Nginx on wg-pk proxying `otium.civicus.us`. SSL active. Game code: not yet written.
+**OTIVM:** Live at `otium.civicus.us`. OTIVM-I and OTIVM-II complete. See `docs/handover-game-dev.md` for current state.
 
 ---
 
@@ -144,4 +187,13 @@ These are verifiable claims about what is built and running as of April 2026.
 - **H3 from day one.** Every location in OTIVM is an H3 cell ID. Never a coordinate pair, never a string name alone. This enables TESSERA queries at any future release without data migration.
 - **One screen, one loop.** OTIVM-I ships when the core loop is fun. Complexity is added in named releases, not incrementally bolted on.
 - **Physical reality only in the data layer.** TESSERA encodes what is physically true. OTIVM encodes what the merchant knows. These are separate layers and must never be conflated.
-- **No vaporware in public documentation.** Section 4 of this document is the template. Every public claim is either running, committed, or explicitly marked as planned.- **The data warehouse is the product.** The game is the public interface. The substrate is the value.- **Real weather only.** DWD data always. No simulated weather.- **JSON flat files for local state.** No database on the OTIVM container. Save files are per-player JSON. A shared database is a future convergence-layer problem.- **BSD 2-Clause license.** The code is open. The data pipeline methodology is open. Academic scrutiny is welcome.---*OTIVM is part of TheRON — The Residential Owner-operated Network.*  *Single contributor: project owner. AI assistants implement, document, flag — do not direct.*
+- **No vaporware in public documentation.** Section 4 of this document is the template. Every public claim is either running, committed, or explicitly marked as planned.
+- **The data warehouse is the product.** The game is the public interface. The substrate is the value.
+- **Real weather only.** DWD data always. No simulated weather.
+- **JSON flat files for local state.** No database on the OTIVM container for player saves. Save files are per-player JSON. A shared database is a future convergence-layer problem.
+- **BSD 2-Clause license.** The code is open. The data pipeline methodology is open. Academic scrutiny is welcome.
+
+---
+
+*OTIVM is part of TheRON — The Residential Owner-operated Network.*
+*Single contributor: project owner. AI assistants implement, document, flag — do not direct.*