docs(meta): D-255 body-map-viewer stepped render architecture + deprecation sweep

D-255 filed (server-determines-content / client map-art function / stepped
six-level ladder Global+Region→Chunk / tagged-envelope wire discharging D-225 /
three-tier cache with distinct staleness-storage axes / cache-accelerated-pure-
function seed-chaining / lakes from settled hydrology, endorheic cue =
outflow-course presence). Twelve in-place amendments: D-166 corollary repoint,
D-192 persistent-cache boundary, D-225 deferral discharged, D-226 consolidated
(ceiling re-scope, select_rung→step-index, stepped transport, item-(d)
per-request + retention cap + chunk-floor partial restore, courses gloss +
cliff sparse-list), D-227 four-part (TTL-split, version tag, seed-chaining,
lakes), D-243 gridunit vocabulary. Clerk-audit fixes: atlas-zoom-ladder-t1143
superseded banner, CLAUDE.md Phase-4 cascade row updated to the stepped model,
Q-093 prior-art cross-ref. river-courses-t1170 carrier gloss. governance
README index regenerated (109 decisions through D-255); validate clean, sync
1344 refs 0 broken. Ticket chain T-1181–T-1185 + reconciliations in changelog.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-24 10:58:02 +02:00
co-authored by Claude Fable 5
parent 29c22cb728
commit 18c731a5de
6 changed files with 70 additions and 9 deletions
+1 -1
View File
@@ -41,7 +41,7 @@ Development follows a strict cascade. Each phase has a concrete deliverable. **D
| 1 | Wiki content complete — all planets, moons, stations, heightmaps, artwork | Implant-ready Godot map of the Reach with click-throughs + wiki/GTTR popups |
| 2 | Economics layer — supply/demand, transport, political/social pressure, corporations, supply chains | Economics spreadsheets/graphs with runtime-tweakable simulation |
| 3 | Planetary/moon maps & station layouts — cities, rivers, mountains, roads, biomes, rail | Atlas of the Reach (implant app) |
| 4 | World generation (tile/chunk/block) — deterministic multilayer seed→tile cascade; each layer above the tile fill viewed as a **map in the implant Atlas** (no in-world rendering; chunk/tile/voxel output is harness-verified, never Atlas-mapped D-226 amendment 2026-07-13) | Deterministic walkable-world data + per-layer Atlas maps + asset catalog + **seamless Atlas zoom ladder** (planetary map → tile scale, every level fully derived and sampled at canvas resolution — heightmap PNGs are invisible derivation input, never displayed; no zoom over/undersampling — D-166 amendment 2026-07-21) |
| 4 | World generation (tile/chunk/block) — deterministic multilayer seed→tile cascade; each layer above the tile fill viewed as a **map in the implant Atlas** (no in-world rendering; tile/voxel output is harness-verified, never Atlas-mapped; **chunk (64 m) is the deepest Atlas rung** — D-255, narrowing the D-226 amendment 2026-07-13) | Deterministic walkable-world data + per-layer Atlas maps + asset catalog + the **stepped Atlas ladder** (D-255: six levels — the Global body-surface opener (rung 0, variable extent, always kept) + five fixed rungs Region→District→Quarter→Block→Chunk; every step a server-derived data canvas at its native gridunit spacing, drawn texel-exact by the client map-art function — heightmap PNGs remain invisible derivation input, never displayed) |
| 5 | Player control & in-world rendering — character, walls/stairs/doors, lighting, drawn on **generated** tiles (no test map) | Player viewport with final-version assets on the generated world |
| 6 | Detail coloring — room-level NPC population, cultural room grammar | Only when the world is walkable |
+16 -1
View File
@@ -2,13 +2,28 @@
title: "Atlas Zoom Ladder — T-1143 Design Pass"
description: Continuous-derivation zoom ladder from planetary map to tile scale, per D-166's 2026-07-21 amendment + corollary
type: design
status: draft — pending Jeroen decisions
status: superseded — by D-255 (body-map-viewer stepped render architecture)
round: T-1143
created: 2026-07-21
superseded: 2026-07-24
---
# Atlas Zoom Ladder — T-1143 Design Pass
> **SUPERSEDED (2026-07-24) by [D-255](../../governance/decisions/architecture.md#d-255)
> — the body-map-viewer stepped render architecture** (workshop:
> `docs/workshops/body-map-viewer/`). The continuous canvas-resolution-sampling
> model, the `select_rung`/`MAX_COVERAGE_M` coverage-ceiling walk, the
> granularity-parameter serving sketch, and the "down to tile scale" floor this
> pass designed are all replaced: zoom is **stepped** (six levels — the Global
> body-surface opener + five fixed rungs Region→District→Quarter→Block→Chunk,
> chunk 64 m the deepest; tile/voxel re-closed for the Atlas), content
> determination is server-side per-step data canvases on a tagged-envelope
> carrier, and the client is a map-art function (RTT terrain + screen-space
> annotations — no zoom-scaled canvas). This document remains as the historical
> record of the design pass and the measured §7 cost tables it produced (which
> the D-255 measurement appendix extends). Do not implement from this file.
Contributors: Tyre (architecture), Dudley (derivation/cost), Araminta (encoding), Troblum (adversarial critique), Qatux (synthesis). Grounded in D-166 (+ 2026-07-21 amendment & corollary), D-226 (+ T-1112/T-1124/T-1145 amendments), D-227 (+ T-1125), D-243, D-201, T-1143 full ticket text.
---
+2
View File
@@ -7,6 +7,8 @@ round: T-1170
created: 2026-07-23
---
> **Note (2026-07-24, body-map-viewer workshop — D-255):** the carrier three-way rule below (Ruling 1c / Ruling 6) survives unchanged in substance. Two terminology/scope updates from D-255: **(1)** "the windowed payload" is repointed to "the per-step data-canvas payload — formerly the `district_window` field, now the tagged step-canvas envelope" (D-226 2026-07-23 amendment / D-255 §c). **(2)** Rule (iii) — *rung-indexed invented detail rides the windowed payload regardless of geometric kind* — gains a second vector member alongside `courses`: **`cliffs: Vec<CliffSegment>`** (carved-gorge geometry: dominant `elevation` + per-segment `channel_depth` + `cliff_edge`), a sparse list zero-length when nothing is carved (T-1177 population survey: zero carved cells across all 267 real bodies), Phase-4 Atlas scope. Governance capture is in the D-226 and D-227 body-map-viewer amendments; this note only glosses the design doc so its "windowed payload" language stays current.
*cracks knuckles* — I've read both tickets in full, the D-226 amendment block (wave-1 carrier note, two-waterline note, T-1137 queue ruling, windowed-family ceiling), D-227, D-243, and the T-1143 zoom-ladder serving model. The audits are code-true and the tension called out in point 1 is real — I created it, and it resolves cleanly once the carrier rule is split on the right axis. Ruling follows.
---
+1
View File
@@ -320,6 +320,7 @@ line in place — keep the Q-record for the audit trail rather than deleting it.
- [D-252: Facing is view-only — movement no longer writes Facing; NPC gaze is intent](decisions/architecture.md#d-252-facing-is-view-only--movement-no-longer-writes-facing-npc-gaze-is-intent) — _architecture_
- [D-253: Region transient state model — seasonal/tidal/weather/snow phase functions (resolves Q-105)](decisions/architecture.md#d-253-region-transient-state-model--seasonaltidalweathersnow-phase-functions-resolves-q-105) — _architecture_
- [D-254: Standalone Atlas companion app — `make atlas`, dual-connection reader](decisions/architecture.md#d-254-standalone-atlas-companion-app--make-atlas-dual-connection-reader) — _architecture_
- [D-255: Body Map Viewer — stepped Atlas render architecture (supersedes the T-1143 continuous-ladder mechanism)](decisions/architecture.md#d-255-body-map-viewer--stepped-atlas-render-architecture-supersedes-the-t-1143-continuous-ladder-mechanism) — _architecture_
## Open questions
File diff suppressed because one or more lines are too long
+1 -1
View File
@@ -322,7 +322,7 @@ Technical foundation questions: engine, protocols, data structures, performance,
### Q-093: Tile-based exploration map in player insert (Google Maps for the implant)
- **Status:** Open (high interest)
- **Question:** Reference: MapTileProvider (https://github.com/AngryMeenky/MapTileProvider) — lazy-loading tile map provider. Concept: the player's insert has a map that works like Google Maps — pan, zoom, tile-based rendering. Server generates map tiles from ECS exploration data (what the player has seen). Explored areas show room layouts, corridors, points of interest. Unexplored areas are blank/fogged. Zoom levels: room detail → building → district → zone → station overview. Knowledge-graph-driven overlays: NPC last-known positions (if the player tracked them), quest markers, danger zones, faction territories. Map tiles are server-authoritative (can't see what you haven't explored) and cached on the client. The tile pyramid approach means the map scales to any world size without loading everything at once.
- **Cross-reference:** Information boundary (D-011), insert/minimap UI, knowledge graph (D-041), T-732 (minimap ticket)
- **Cross-reference:** Information boundary (D-011), insert/minimap UI, knowledge graph (D-041), T-732 (minimap ticket). See also [D-255](../decisions/architecture.md#d-255) (body-map-viewer stepped Atlas render architecture, 2026-07-24) — a different system (Phase-4 world-generation Atlas, not the player exploration insert), but its server-authoritative per-step data canvases, tagged-envelope carrier, and client cache tiers are shipped prior art for exactly the tile-pyramid/lazy-load/server-authoritative-cache architecture this question sketches.
---