docs(modules): phase 7b as built — configuration from the site, and the undo that makes it safe #260

Merged
whitlocktech merged 2 commits from docs/rust-phase-7b into main 2026-09-22 15:01:28 +00:00
Member

Phase 7b of the module-rust plan (R18), documented as built.

  • rust-link/PROTOCOL.md §11 — protocol 5: the recursive walk rooted at the framework's own config directory (never a literal, never the data directory), the version a write must present back, the set-shaped write, the watched reload, and the automatic restore. Plus the two rules that shaped it: config.list hashes nothing, and the website composes the bytes because JavaScript cannot tell 1 from 1.0.
  • modules/rust/PLAN.md §21 — the phase as built. Four org-lead decisions (D35–D38), what avoiding the float trap cost, the arithmetic behind the four-second window, and four defects a browser found that 179 green tests did not — the worst being that every save of the bridge's own config was refused while the page said otherwise.
  • rust-link/PLAYER_WALK.md — the configuration walk, because the acceptance line needs the sidecar and the game on one host and the rig still cannot reach one.
  • rust-link/INTEGRATION.md — the four things an operator should know before editing a plugin's settings from a web page, including why their data directory is deliberately absent.

The phase table's 7b row is marked built, with what is and is not proven.

  • AI-assisted: Claude Code

🤖 Generated with Claude Code

https://claude.ai/code/session_01PMH6bw1jXMgbyF3ZWGEzSM

Phase 7b of the module-rust plan (R18), documented as built. - **`rust-link/PROTOCOL.md` §11** — protocol 5: the recursive walk rooted at the framework's own config directory (never a literal, never the data directory), the version a write must present back, the set-shaped write, the watched reload, and the automatic restore. Plus the two rules that shaped it: `config.list` hashes nothing, and the website composes the bytes because JavaScript cannot tell `1` from `1.0`. - **`modules/rust/PLAN.md` §21** — the phase as built. Four org-lead decisions (D35–D38), what avoiding the float trap cost, the arithmetic behind the four-second window, and **four defects a browser found that 179 green tests did not** — the worst being that every save of the bridge's own config was refused while the page said otherwise. - **`rust-link/PLAYER_WALK.md`** — the configuration walk, because the acceptance line needs the sidecar and the game on one host and the rig still cannot reach one. - **`rust-link/INTEGRATION.md`** — the four things an operator should know before editing a plugin's settings from a web page, including why their data directory is deliberately absent. The phase table's 7b row is marked built, with what is and is not proven. - [x] AI-assisted: Claude Code 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01PMH6bw1jXMgbyF3ZWGEzSM
wtclaude added 1 commit 2026-09-22 13:57:19 +00:00
PROTOCOL.md §11 specifies protocol 5: the walk rooted at the framework's own
config directory, the version a write must present back, the set-shaped write,
the watched reload and the automatic restore. PLAN.md §21 is the phase as built
— four org-lead decisions, the float trap and what avoiding it cost, and four
defects a browser found that 179 green tests did not.

PLAYER_WALK.md gains the configuration walk, because the acceptance line needs
the sidecar and the game on one host and the rig cannot reach one yet.
INTEGRATION.md gains the four things an operator should know before they edit a
plugin's settings from a web page.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PMH6bw1jXMgbyF3ZWGEzSM
wtclaude added 1 commit 2026-09-22 13:58:27 +00:00
R19's byte-identical plugin now carries protocol 5 on both frameworks:
`framework=oxide root=/home/container/oxide/config` on one rig and
`framework=carbon root=/home/container/carbon/configs` on the other, from the
same file. That is R18's amendment proven rather than argued — a literal
`oxide/config/` in this editor would have missed every config on half of all
installs.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PMH6bw1jXMgbyF3ZWGEzSM
whitlocktech merged commit 15d64b28fe into main 2026-09-22 15:01:28 +00:00
whitlocktech deleted branch docs/rust-phase-7b 2026-09-22 15:01:29 +00:00
Sign in to join this conversation.
No description provided.