Session handoff — 2026-06-16 (73)

Short, focused handover. Continues from handoff-72 (which completed the H2 hint-corpus verification pass). This session shipped one small feature — a Ctrl-G demo-mode alias for F1 — plus follow-on doc hygiene. Commit 4016c3e.

§1. State

Branch: main, clean, all committed (local; push pending — your step; the backlog now spans the CI merge, H2, the hint-corpus fixes, handoffs 71/72/73, and this Ctrl-G commit). 2503 pass / 0 fail / 1 ignored (the long-standing friendly doctest), clippy clean (nursery, all targets). Open Gitea issues unchanged: #35–#38.

§2. Why Ctrl-G (the problem)

Casts are recorded with autocast (ADR-0047 demo mode: --demo / RDBMS_PLAYGROUND_DEMO). The contextual hint overlay (ADR-0053 / H2) opens on F1 — but F1 reaches the app only as a terminal escape sequence (\eOP / \e[11~), and autocast cannot emit escape sequences. So the single most teaching-relevant overlay was unreachable in recordings (and in presenter/teacher sessions, which also run --demo). Same wall that pushed step-captions onto Ctrl+] (a single control byte) rather than Ctrl+!.

Chord choice — why Ctrl-G, why not Ctrl-1

The user's first instinct was Ctrl-1 (mnemonic, near F1). Not possible: in a legacy terminal Ctrl+digit has no control byte — Ctrl-1 arrives as a bare 1 (would type "1" into the buffer). The kitty keyboard protocol would encode it, but only as an escape sequence (the very thing autocast can't send), and this app deliberately does not push KeyboardEnhancementFlags (runtime.rs does only enable_raw_mode + EnterAlternateScreen). So the usable space is exactly Ctrl+letter (single legacy control bytes). After excluding taken chords (Ctrl-C quit, Ctrl-O nav, Ctrl+] caption, Ctrl-A/E/W/K/U readline per ADR-0049), byte-collisions (Ctrl-H/I/J/M/[), flow-control (Ctrl-S/Q), and likely-future (Ctrl-R/P/N/Y/L/V), Ctrl-G is the clean survivor (BEL/"abort" in line editors — nothing destructive to shadow).

§3. What shipped (commit `4016c3e`)

ADR-0047 Amendment 1. In demo mode only, Ctrl-G aliases F1:

Runs the exact F1 hint logic (hint_key guard in App::handle_key, src/app.rs ~line 1226 — key.code == F(1) || (self.demo_mode && Ctrl-G)), so live-input → form hint, empty input → recent-error / getting-started.
Badges as [F1] (not [CTRL-G]): demo_badge_label maps Ctrl-G → Some("[F1]") (consulted only in demo mode — the caller gates). So a recorded cast is visually identical to a real F1 press.
Demo-gated: the shipped keymap stays F1-only. Outside demo mode Ctrl-G falls through to the inert catch-all (the Char(c) insert arm excludes CONTROL, so no g is typed).
The keybinding strip (ADR-0051) is not changed — F1 stays the advertised key; Ctrl-G is a recorder aid and the badge already reads [F1].

Tests (test-first, src/app.rs Tier-1): ctrl_g_in_demo_mode_- aliases_f1_on_input, …_on_empty_input, ctrl_g_outside_demo_mode_- is_inert, plus a Ctrl-G → [F1] assertion added to demo_badge_label_maps_the_invisible_keys. All confirmed red→green; the "inert" test passed on the pre-change code, proving the demo-gate.

Using it in a cast

With --demo active, send Ctrl-G in the autocast script wherever you want the hint overlay to appear; the viewer sees the [F1] badge.

§4. Doc hygiene done alongside (same commit)

ADR-0047 file: removed two stray </content> / </invoke> lines (tool-call residue accidentally committed when the ADR was authored).
CLAUDE.md "Things deliberately deferred": dropped three stale entries — I1b readline shortcuts (done, ADR-0049), I3 tab completion, and I4 syntax highlighting (both done; requirements.md even carries a 2026-06-07 reconciliation note that I3/I4 were "shipped but marked not yet"). Only I1 (multi-line input) remains — it is genuinely still open ([ ] in requirements.md). (This follows the handoff-72 cleanup that removed the equally-stale m:n/C4 + project-storage entries.)

§5. Open / next (unchanged from handoff-72 §5)

The hint corpus is trustworthy and the cast-F1 gap is closed. Roadmap:

Push (your step).
#35 (cargo fmt gate) — precondition (CI merged) is met; the user wants it done once, before first publication. Needs a rustfmt.toml- vs-defaults decision first; tree is ~1800 hunks dirty.
Other open requirements.md items: I1 multi-line input, I5/B3 in-flight cancellation, TT4 PTY tier-4 (unwired), DOC1/E2 user docs (partial), TT5 Windows-execution + Tier-4-in-CI, D3 packaging manifests. Design-first ([~]): V4 session journal, TU1 tutorial, C3a, V3.
Hint follow-ups if wanted: #36 help advanced-SQL, #37 hint clause-concepts, #38 hint diagnostic route.

§6. How to take over

Read handoffs 71 → 72 → 73, CLAUDE.md, docs/requirements.md.
Confirm green: cargo test (2503 / 1 ignored) + cargo clippy --all-targets (clean).
For demo-mode / casting, read ADR-0047 (+ its Amendment 1); for the hint overlay it aliases, ADR-0053.
Workflow unchanged: phased, test-first, /runda + DA before commits, ADR amendment + README index-upkeep for decided-area changes, confirm commit messages with the user.
Consider a cargo sweep at this milestone (target/ grows; see CLAUDE.md "Build hygiene").

5.5 KiB Raw Blame History Unescape Escape