docs(rust): plan fixes — the first player walk's findings, gating the cutover #282

wtclaude · 2026-09-26T21:21:25Z

wtclaude commented

2026-09-26 21:21:25 +00:00

What & why

The first walk of rust-link/PLAYER_WALK.md with a real player (the Oxide pass, org lead in game, 2026-09-26) found fifteen places where the bridge or the site does something other than modules/rust/PLAN.md and rust-link/PROTOCOL.md say. The org lead also took fourteen decisions during and after the walk. This PR plans them in a new companion document, modules/rust/PLAN_FIXES.md, and links it from PLAN.md (status line and a new §35) and the rust README. Plan only — no code until it is approved (CLAUDE.md).

What the plan covers:

§1 Decisions D159–D172, continuing PLAN.md's numbering.
- D159: "gathered" counts everything harvested, including ground pickups.
- D160 reverses D31: the site owns every permission and group, not only those it authored.
- D161: the per-server in-game-change policy, defaulting to auto-adopt.
- D162, D163: the PermissionsManager-style permission screen.
- D164: the kit-weekend template (a lease plus a use credit).
- D165: per-type map markers, defaulting to major monuments.
- D166: ZoneManager's flags on the zone step.
- D167: ZoneDomes as an optional dependency.
- D168: we may write a helper plugin when a dependency lacks an API.
- D169: every fix and redesign lands before Module-Rust's cutover (phase 19).
- D170: an expired zone is marked expired on the site.
- D171: Steam sign-in moves to the website's own plan.
- D172: chat titles use all 23 listed conditions under new names.
§2 Fixes F1–F15. The two to do first:
- F15 — the plugin decodes site-to-game bytes as Latin-1, which corrupts every non-ASCII announcement, title and name, and every config save.
- F9/F10 — the 4-second config-reload window loses to a cold Oxide compile and rolls back valid edits.
- Also F12, F13, F14, F5/F6, F1, F3, F8, F11, F7, F2, F4.
§3 Interface corrections U-1–U-6, and the walk-doc corrections.
§4 The redesigns, scoped:
- the permission manager, rebuilt around the game's real state;
- the kit-weekend template;
- the event step editor;
- zones (options and domes);
- map marker types;
- the chat titles table: 23 conditions, a new title for each, and the hook that feeds each;
- NPC research;
- Steam sign-in, now only a pointer to the website's plan.
§5 Protocol 13 carries every wire change in one bump.
§6 The order: F15 and F9 first, then protocol 13, then the redesigns, then the cutover.
§7 Where helper plugins are already indicated.
§8 The re-walk, on both frameworks.
§9 The answered questions, and four detail questions left for the redesigns' own plans.

How it was tested

Docs only. Every finding was observed on the rig during the walk, with the console, the sidecar feed and the walk core's rust_events / run records as evidence. The file and line references were checked against Rust-Plugins v0.1.1, Module-Rust at phase 17, and website main. Every hook named in §4.6 was checked against modules/rust/HOOKS.md.

Checklist

I have read CONTRIBUTING.md.
The change builds and existing tests/checks pass locally. (No CI in this repo; links are relative and resolve.)
I have added or updated tests/docs where it makes sense.
My commits are reasonably scoped with clear messages.

AI-assisted contributions (required)

No AI tools were used to produce this contribution.
AI tools were used. Tool(s): Claude Code (Claude Opus 5.5). I have reviewed and understand every change, and take responsibility for it. AI-authored commits are marked with a Co-Authored-By / Assisted-By trailer.

License

I agree that my contribution is licensed under this project's license (GNU GPL v3.0 or later), and I have the right to contribute it.

🤖 Generated with Claude Code

https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

## What & why The first walk of `rust-link/PLAYER_WALK.md` with a real player (the Oxide pass, org lead in game, 2026-09-26) found fifteen places where the bridge or the site does something other than `modules/rust/PLAN.md` and `rust-link/PROTOCOL.md` say. The org lead also took fourteen decisions during and after the walk. This PR plans them in a new companion document, **`modules/rust/PLAN_FIXES.md`**, and links it from PLAN.md (status line and a new §35) and the rust README. **Plan only — no code until it is approved** (CLAUDE.md). **What the plan covers:** - **§1 Decisions D159–D172**, continuing PLAN.md's numbering. - **D159:** "gathered" counts everything harvested, including ground pickups. - **D160 reverses D31:** the site owns every permission and group, not only those it authored. - D161: the per-server in-game-change policy, defaulting to auto-adopt. - D162, D163: the PermissionsManager-style permission screen. - D164: the kit-weekend template (a lease plus a use credit). - D165: per-type map markers, defaulting to major monuments. - D166: ZoneManager's flags on the zone step. - D167: ZoneDomes as an optional dependency. - D168: we may write a helper plugin when a dependency lacks an API. - **D169: every fix and redesign lands before Module-Rust's cutover (phase 19).** - D170: an expired zone is marked expired on the site. - D171: Steam sign-in moves to the website's own plan. - D172: chat titles use all 23 listed conditions under new names. - **§2 Fixes F1–F15.** The two to do first: - **F15** — the plugin decodes site-to-game bytes as Latin-1, which corrupts every non-ASCII announcement, title and name, and every config save. - **F9/F10** — the 4-second config-reload window loses to a cold Oxide compile and rolls back valid edits. - Also F12, F13, F14, F5/F6, F1, F3, F8, F11, F7, F2, F4. - **§3** Interface corrections U-1–U-6, and the walk-doc corrections. - **§4** The redesigns, scoped: - the permission manager, rebuilt around the game's real state; - the kit-weekend template; - the event step editor; - zones (options and domes); - map marker types; - **the chat titles table:** 23 conditions, a new title for each, and the hook that feeds each; - NPC research; - Steam sign-in, now only a pointer to the website's plan. - **§5** Protocol 13 carries every wire change in one bump. - **§6** The order: F15 and F9 first, then protocol 13, then the redesigns, then the cutover. - **§7** Where helper plugins are already indicated. - **§8** The re-walk, on both frameworks. - **§9** The answered questions, and four detail questions left for the redesigns' own plans. ## How it was tested Docs only. Every finding was observed on the rig during the walk, with the console, the sidecar feed and the walk core's `rust_events` / run records as evidence. The file and line references were checked against Rust-Plugins v0.1.1, Module-Rust at phase 17, and website `main`. Every hook named in §4.6 was checked against `modules/rust/HOOKS.md`. ## Checklist - [x] I have read [CONTRIBUTING.md](CONTRIBUTING.md). - [x] The change builds and existing tests/checks pass locally. (No CI in this repo; links are relative and resolve.) - [x] I have added or updated tests/docs where it makes sense. - [x] My commits are reasonably scoped with clear messages. ## AI-assisted contributions (required) - [ ] No AI tools were used to produce this contribution. - [x] AI tools were used. Tool(s): `Claude Code (Claude Opus 5.5)`. I have reviewed and understand every change, and take responsibility for it. AI-authored commits are marked with a `Co-Authored-By` / `Assisted-By` trailer. ## License - [x] I agree that my contribution is licensed under this project's license (**GNU GPL v3.0 or later**), and I have the right to contribute it. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

wtclaude added 1 commit 2026-09-26 21:21:27 +00:00

docs(rust): plan fixes — the first player walk's findings, gating the cutover c0d6cab0e9

PLAN_FIXES.md plans what the Oxide pass of PLAYER_WALK.md found on
2026-09-26: fifteen fixes (F1-F15, F15 corrupts every non-ASCII
site-to-game string including config saves; F9 rolls back valid config
edits on a cold compile), the interface and walk-doc corrections, and the
org lead's decisions D159-D168 (D160 reverses D31: the site owns every
permission and group). Recommends the fixes land before Module-Rust's
cutover (phase 19) and the redesigns follow it.

PLAN.md gains a pointer in its status line and §35; the rust README lists
the new file.

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

whitlocktech merged commit dc6c5a72fd into main

2026-09-26 21:26:51 +00:00

whitlocktech referenced this issue from a commit

2026-09-26 21:26:52 +00:00

Merge pull request 'docs(rust): plan fixes — the first player walk's findings, gating the cutover' (#282) from docs/rust-plan-fixes into main

whitlocktech deleted branch docs/rust-plan-fixes

2026-09-26 21:26:52 +00:00

wtclaude referenced this pull request

2026-09-26 21:28:16 +00:00

docs(rust): plan fixes — D169-D172, the org lead's answers #283

Sign in to join this conversation.