docs(rust): phase 14 plan of record — the live map (PLAN.md §30) #271

wtclaude · 2026-09-25T04:39:54Z

wtclaude commented

2026-09-25 04:39:54 +00:00

The plan for module-rust phase 14, written before any code.

§30.0, a rig probe that rewrote R9's first half. The .map file R9 names is the world's terrain data, not a picture.
- The game's own renderer (MapImageRenderer.Render) blocks the main thread for 8.5 s on a 3000 map, and 21 s at full scale.
- Rust+ already caches the same JPEG: CompanionServer.Handlers.Map.ImageData, 2500×2500 and 360 KB, byte-identical to a fresh render, and free to read.
§30.1, D109–D118, from the org lead on 2026-09-24:
- The picture comes from the Rust+ cache. When there is none, an admin button renders one.
- The site fetches a new map by itself, which amends R9's "no import on boot".
- The live layers are request/reply, and positions never touch disk.
- Four layers ship, each with a fleet default and a per-server override.
- The players layer is capped by the presence audience.
- A linked viewer sees their own position and their online clan mates, and only members of that clan see those mates.
- The map is drawn with Leaflet.
§30.2: what each of the three repos builds. Protocol 11.
§30.3: how a world position becomes a pixel.
§30.4: the eight-step walk that says the phase is done.
§30.5, six readings nobody asked about, for review to overrule:
- the picture and monuments are public at every setting;
- the picture is stored in the database, not in /uploads;
- the own dot includes the viewer's sleeper;
- bases carry positions only;
- the map polls every 10 s and the module caches for 5 s;
- the world events share one switch.
R9 amended, and the phase 14 row updated.

Code starts after review, on feat/phase-14-map in Rust-Plugins, Rust-Link and Module-Rust, into edge.

AI-assisted: Claude Code (Claude Opus 5.5)

🤖 Generated with Claude Code

https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

The plan for module-rust phase 14, written before any code. - **§30.0, a rig probe that rewrote R9's first half.** The `.map` file R9 names is the world's terrain data, not a picture. - The game's own renderer (`MapImageRenderer.Render`) blocks the main thread for **8.5 s** on a 3000 map, and 21 s at full scale. - **Rust+ already caches the same JPEG**: `CompanionServer.Handlers.Map.ImageData`, 2500×2500 and 360 KB, byte-identical to a fresh render, and free to read. - **§30.1, D109–D118**, from the org lead on 2026-09-24: - The picture comes from the Rust+ cache. When there is none, an admin button renders one. - The site fetches a new map by itself, which amends R9's "no import on boot". - The live layers are request/reply, and positions never touch disk. - Four layers ship, each with a fleet default and a per-server override. - The players layer is capped by the presence audience. - A linked viewer sees their own position and their online clan mates, and only members of that clan see those mates. - The map is drawn with Leaflet. - **§30.2**: what each of the three repos builds. Protocol 11. - **§30.3**: how a world position becomes a pixel. - **§30.4**: the eight-step walk that says the phase is done. - **§30.5, six readings nobody asked about**, for review to overrule: - the picture and monuments are public at every setting; - the picture is stored in the database, not in `/uploads`; - the own dot includes the viewer's sleeper; - bases carry positions only; - the map polls every 10 s and the module caches for 5 s; - the world events share one switch. - R9 amended, and the phase 14 row updated. Code starts after review, on `feat/phase-14-map` in Rust-Plugins, Rust-Link and Module-Rust, into `edge`. - [x] AI-assisted: Claude Code (Claude Opus 5.5) 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

wtclaude added 1 commit 2026-09-25 04:39:56 +00:00

docs(rust): phase 14 plan of record — the live map (PLAN.md §30) 0222adb49a

A rig probe found that R9's .map file is terrain data, not a picture,
and that Rust+ already caches the rendered JPEG, while the game's own
render stalls the main thread for 8.5 s. D109-D118 from the org lead;
R9 amended by D110; phase 14 row updated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

whitlocktech merged commit 1538b4e9cd into main

2026-09-25 05:08:04 +00:00

whitlocktech referenced this issue from a commit

2026-09-25 05:08:05 +00:00

Merge pull request 'docs(rust): phase 14 plan of record — the live map (PLAN.md §30)' (#271) from docs/rust-phase-14 into main

whitlocktech deleted branch docs/rust-phase-14

2026-09-25 05:08:05 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: RunicGateway/docs#271