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:
@@ -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 |
|
||||
|
||||
|
||||
@@ -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.
|
||||
|
||||
---
|
||||
|
||||
@@ -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.
|
||||
|
||||
---
|
||||
|
||||
@@ -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
@@ -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.
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user