docs(folding): framing rev 5 — record approval + keybinding decision

Q#FD4 settled: the user chose Emacs hideshow parity, so Stage 1 ships the
`C-c @` prefix set (`C-c <letter>` is fully taken by the LSP surface; the
hs-minor-mode prefix collides with nothing). §6/§9 now list the five
bindings; §0 records the rev 4 -> rev 5 approval note; §14 records the
rebase onto canonical `main` @ 96d0bae at implementation start. Bet B1
accepted as framed. active-work.md folding lane flipped to APPROVED /
Stage 1 implementing.

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

docs/active-work.md

@@ -55,24 +55,26 @@ If it does not, stop and repair the remote/fetch configuration.
 ## Folding framing lane (Arc 6)
 
 - Portable branch: `githubsucks/folding`; worktree `../pmacs-folding`.
-- Base: canonical `main` @ `cac4961` (post Vterm Stage 3 #135).
+- Base: **rebased onto canonical `main` @ `96d0bae`** at implementation
-- Framing head: revision 4 of `docs/folding-framing.md` (this commit; rev 1
+  start (was `cac4961`; the earlier base fell behind the docs + tab-width
-  `ee6c77f` → rev 2 `7898b8f` → rev 3 `944b42b` → rev 4).
+  housekeeping).
-- State: **framing only; three review rounds absorbed (rev 4), awaiting
+- Framing head: revision 5 of `docs/folding-framing.md` (rev 1 → … → rev 4
-  approval.** No implementation.
+  absorbed three review rounds; rev 5 records approval + the Q#FD4 binding
+  decision).
+- State: **APPROVED; Stage 1 (fold engine, headless) implementing on this
+  branch.** Bindings decided (Q#FD4 → Emacs hideshow `C-c @` set); Bet B1
+  accepted as framed.
   Load-bearing decision (Q#FD1): the bundled grammars ship no fold query and
-  no `folds.scm`, so the roadmap's "tree-sitter fold ranges" is not free; the
+  no `folds.scm`, so the roadmap's "tree-sitter fold ranges" is not free; v1
-  draft recommends structural node folding (nearest enclosing block-like node
+  is structural node folding (block-like node ≥2 source lines, derived head
-  >= 2 rows), with indentation fallback and curated queries deferred.
+  line, closer-aware tail), with indentation fallback and curated queries
-  `FoldState` already exists in the protocol, declared-but-unproduced (a test
+  deferred. `FoldState` already exists in the protocol, declared-but-unproduced
-  pins it is never emitted); no frontend consumes it; gutter markers are
+  (a test pins it is never emitted); no frontend consumes it yet; gutter
-  frontend-derived like the diagnostic sign bars, so no new wire type. Staged
+  markers are frontend-derived like the diagnostic sign bars, so no new wire
-  like vterm: Stage 1 engine (headless), Stage 2 TUI, Stage 3 GPU.
+  type. Staged like vterm: Stage 1 engine (headless), Stage 2 TUI, Stage 3 GPU.
-- PR: none yet — framing is committed to the branch for review, not opened as
+- PR: Stage 1 opens as the first folding PR once the gate suite is green.
-  a PR. Stage 1 implements on this same branch after approval.
+- Next: land Stage 1; Stages 2/3 are separate branches/PRs, each re-framed
-- Next: user approval of rev 4 (or a round-4 review). Bindings (Q#FD4)
+  in detail after the prior stage lands.
-  remain the user's call; the block-kind heuristic stays Bet B1 with
-  curated Tier-1 queries as fallback.
 
 Recovery worktree:
 

docs/folding-framing.md

@@ -1,10 +1,11 @@
 # Folding — framing (Arc 6)
 
-**Revision 4 — 2026-07-23. Status: framing only, on branch `folding`
+**Revision 5 — 2026-07-23. Status: APPROVED; Stage 1 implementing on branch
-(off canonical `main` @ `cac4961`); no implementation.** Rev 1 passed a
+`folding` (rebased onto canonical `main` @ `96d0bae`).** Rev 1 passed a
 ground-truth review; rev 2 fixed round 1's seven findings; rev 3 fixed round
 2's five majors and four minors; rev 4 fixes round 3's one major, three
-minors, and a nit. See §0 for the per-round changelog.
+minors, and a nit; rev 5 records the settled keybinding decision (Q#FD4) and
+approval. See §0 for the per-round changelog.
 
 ## 0. Revision history
 
@@ -88,6 +89,17 @@ minors, and a nit. See §0 for the per-round changelog.
   end-inclusive** with the matching `View` boundary bias, so typing at the
   end of a head line neither unfolds nor lands hidden (§5; acceptance 6).
 
+### Approval + keybindings (rev 4 → rev 5)
+
+- **Q#FD4 keybindings decided.** rev 4 deferred the binding to the user; the
+  user chose **Emacs hideshow parity**, so Stage 1 ships the `C-c @` prefix
+  set (§6, §9) — `C-c <letter>` is fully taken by the LSP surface, and the
+  `C-c @` hs-minor-mode prefix collides with nothing. This follows the
+  M-;/M-% precedent of shipping faithful Emacs-idiom defaults.
+- **Bet B1 accepted as framed** (block-kind target heuristic; curated Tier-1
+  queries the named fallback). rev 4's architecture is **approved**; Stage 1
+  implements on this branch, rebased onto canonical `main` @ `96d0bae`.
+
 ## 1. Problem and what ships
 
 Pmacs cannot fold. `FoldState` was declared in the M11.1 semantic-frontend
@@ -321,7 +333,19 @@ from the last clause (minor c): `(0,0)` on an empty terminal identity buffer
 is technically in-bounds, but it normalizes to zero hidden lines and is
 rejected — no special case.
 
-Bindings remain the user's call (Emacs has no single convention).
+**Default bindings (Q#FD4) — Emacs hideshow parity.** Stage 1 ships the
+`C-c @` prefix set. `C-c <letter>` is fully taken by the LSP surface, so the
+Emacs hs-minor-mode prefix `C-c @` is the one faithful choice that collides
+with nothing:
+
+- `C-c @ C-c` → `fold.toggle` (org-TAB-style cycle)
+- `C-c @ C-h` → `fold.close`
+- `C-c @ C-s` → `fold.open`
+- `C-c @ C-M-h` → `fold.close-all`
+- `C-c @ C-M-s` → `fold.open-all`
+
+These follow the M-;/M-% precedent of shipping faithful Emacs-idiom
+defaults; users rebind through `pmacs.keymap` as usual.
 
 ## 7. Frontend collapse + gutter marker (Q#FD7)
 
@@ -379,8 +403,8 @@ lands. This framing asks approval for the architecture and Stage 1's detail.
 - **Q#FD4** Interactive commands (invoking frontend's buffer; shared head
   lines use **state-aware ordering** — close innermost-open, open
   outermost-closed, toggle cycles); data API takes an explicit buffer, no
-  ambient resolution, with the §6 arbitrary-range normalization; bindings
+  ambient resolution, with the §6 arbitrary-range normalization; **default
-  decided by the user. (§6)
+  bindings = the Emacs hideshow `C-c @` prefix set** (§6), rebindable. (§6)
 - **Q#FD5** The store `View` translates + drops only (provenance-blind); the
   **pre-edit interactive unfold** lives at the dispatch layer, keyed on the
   authenticated source frontend's point (not transport), unfolding **every**
@@ -491,11 +515,11 @@ acceptance is bite-verified with `scripts/bite`.
 
 ## 14. Branch and PR plan
 
-Branch `folding`, worktree `../pmacs-folding`, off canonical `main` @
+Branch `folding`, worktree `../pmacs-folding`. This framing (rev 1 → rev 5)
-`cac4961`. This framing (rev 1 → rev 4) is its opening commits. Canonical
+is its opening commits; the branch was **rebased onto canonical `main` @
-`main` has since advanced past the base (documentation + tab-width #137);
+`96d0bae`** when implementation started (the earlier base `cac4961` was
-Stage 1's instance-side scope does not overlap that work — rebase onto
+behind after the documentation + tab-width #137 housekeeping; Stage 1's
-current `main` when implementation starts. After approval, Stage 1
+instance-side scope does not overlap that work). Stage 1 implements on this
-implements on this same branch and opens as the first folding PR. Stages 2
+same branch and opens as the first folding PR. Stages 2 and 3 are separate
-and 3 are separate branches/PRs off the main resulting from the prior
+branches/PRs off the main resulting from the prior stage, each with its own
-stage, each with its own detailed framing.
+detailed framing.