docs: record mode system review lane

Record the portable branch, pull request, implementation checkpoint,
verification, and cross-machine recovery command for mode-system wiring.
This commit is contained in:
Levi Neuwirth 2026-07-21 20:27:03 -04:00
parent 99cd7ec240
commit 692c3c5fdc
1 changed files with 32 additions and 5 deletions

View File

@ -14,7 +14,8 @@ backlog.
machine-local: `origin` may name this canonical URL, a release mirror,
or something else, and therefore has no authority by name alone.
- Canonical base at this snapshot:
`githubsucks/main` @ `2e37c04` (#127 merged; protocol v18).
`githubsucks/main` @ `f1a2f75` (#128 documentation merge; runtime remains
config registry #127 at protocol v18).
- On the transfer source, `origin/main` named a release mirror at
`d3fa632` and lagged badly. On the current destination, `origin` names
the canonical URL. This difference is why all recovery begins by
@ -48,18 +49,44 @@ git worktree list
git status --short --branch
```
The first command must expose `2e37c04` or a newer intentional main.
The first command must expose `f1a2f75` or a newer intentional main.
If it does not, stop and repair the remote/fetch configuration.
## Mode system wiring lane
- Portable branch: `githubsucks/mode-system-wiring`
- PR: #129, <https://github.com/levineuwirth/pmacs/pull/129>
- Base: canonical `main` @ `f1a2f75` (protocol v18).
- Approved framing commit: `424f82b`
- Implementation checkpoint: `99cd7ec`
- State: implementation complete and awaiting user review. One detected major
mode is stored per buffer; dispatch, describe-key, show-key, and encoded
help links resolve it; after-load initializes it once; explicit overrides
and clears survive switches; the existing statusline provider path renders
it per window. No protocol change.
- Verification at `99cd7ec`: formatting and Clippy clean; 1,742 default +
1,918 CRDT library tests; 8 default + 9 CRDT touched acceptance tests; 114
M4 tests; 109 required-GPU tests; workspace sweep 2,867 passed across 81
suites (19 ignored, 1 filtered); diff check clean.
Recovery worktree on a machine that does not already own the branch:
```sh
git worktree add --track \
-b mode-system-wiring \
../pmacs-mode-system \
githubsucks/mode-system-wiring
```
## Vterm Stage 2 framing lane
- Portable branch: `githubsucks/vterm-framing`
- Approved framing head: `fb4f8f0`
- Base: canonical `main` @ `643d1e1` (Vterm Stage 1 / PR #126 merged).
`main` has since advanced to `2e37c04` (config registry #127, no
runtime overlap with vterm); cut the Stage 2 lane from current `main`,
not from `643d1e1`.
`main` has since advanced to `f1a2f75` (config registry #127 plus the #128
documentation merge, with no runtime overlap with vterm); cut the Stage 2
lane from current `main`, not from `643d1e1`.
- State: `docs/vterm-framing.md` Revision 7 is framing-only, reviewed, and
approved for implementation. It closes the final `at_bottom`, terminal
`C-c` binding-reachability, and context-implicit Lua failure-mode findings.