[raiseCatError]

Draft, do not merge before v0.21 ships. Docs only, but a later dev → release/v0.21.0 sync (for a QA fix) would carry anything merged into dev before the release.

Starts v0.22 (#431) with a durable design and ledger, mirroring how v0.21 was run (#410, v021-ledger.md).

• docs/design/v022-daily-use.md — goal, baseline and the v0.21 boundary (v0.22 PRs stay draft until v0.21 ships; nothing touches release/v0.21.0, its QA evidence, master or publishing), scope tiers, and per-slice behavior, boundaries, tests, performance and physical QA:
  • Required reliability: Under heavy load, a reply typed right after a prompt-less read starts can be queued instead of answering it #426 (draft Input ownership: keys wait for the look, however long a loaded machine makes it (#426) #433), Flaky: Fish can lose keys typed right after a handed-over read returns #356 (investigation under load).
  • From accepted issues: Workflow integrations: external editors, search, preview tools and shell utilities #366 /view → your editor (draft /view: o opens the file shown in your own editor, at the line on screen (#366) #434).
  • Decided by the maintainer (2026-10-18): D1 Composer history: advance past multiline recalls consistently and show position on a free edge #389 approved (draft Composer history: a recalled command is one step, however many lines it has (#389) #438, indicator draft Composer history: History n/N on a free composer rule while browsing (#389) #441), D2 Natural-language command suggestions in Ask: optional, reviewed, never auto-run (proposal) #432 approved as optional with the local model first (draft Ask: optional command suggestions from the local model, Copy/Insert only (#432) #440), D3 editor choice approved (draft /open: choose a terminal editor when VISUAL and EDITOR are unset (#366) #439).
  • Deferred, status unchanged: Terminal-first workspace: sidebars, external workspace navigation and developer control surfaces #330–Contextual right panel: keyboard-first diff, detail and review presentation #332, /worktrees: terminal-first Git worktree discovery, navigation and safe management #337–Future research: Claude Remote Control compatibility and per-profile launch policy #340, /tmux Studio: status, appearance, Context modules and workspace integration #333–Configurable semantic keymap and terminal-host conflict guidance #335, Future security/runtime: enforced isolation for executable NMSh Portable Mods #341, Future: contextual NMSh Learn — interactive guide to using notMyShell #398, Terminal Settings: safe Ghostty + kitty config editor in /appearance #399, Theme Bridge and semantic terminal integration #304, Future: hosted SSH demo for NMSh #296, Investigate NMSh interoperability with Supacode and agent-oriented terminal hosts #15.
• docs/design/v022-natural-language-commands.md — the design, now with the decisions and the first slice's scope (Ask: optional command suggestions from the local model, Copy/Insert only (#432) #440): one optional, off-by-default suggestion outcome inside the existing Ask, entered through an NMSh surface (never shell syntax), labelled by NMSh's own classifier, run only by the person's Enter; minimal context by default; providers local first, bring-your-own-key remote only if approved; cost and token estimates; the five decisions, answered.
• docs/development/v022-ledger.md — baseline SHAs, worktree and scratch locations, every slice with its PR (Input ownership: keys wait for the look, however long a loaded machine makes it (#426) #433–Composer history: History n/N on a free composer rule while browsing (#389) #441), decisions (why Input ownership: keys wait for the look, however long a loaded machine makes it (#426) #433 holds keys until the owner is known and a timeout never routes them, the two Flaky under parallel load: a command typed right after Ctrl+C on a waiting read can fail to run #436 mechanisms, D2's conservative label, Setup coverage), a verification table per PR, environment caveats, open risks.
• docs/testing/v022-physical-qa.md — the physical checklist: input ownership with the held-input states, /view → editor, type-ahead after Ctrl+C and slow prompt hooks, history browsing and History n/N, terminal editor choice, Ask command suggestions. Nothing has had a physical pass yet.

No code, no ROADMAP change (its status lines belong to the v0.21 release; they move at reconciliation).

Refs #431
Refs #432