feat(console): easier navigation — real Back, one name per page, /ruflo go, instant refresh (0.43.0)

[socrates6969]

Draft until a manual check in a live console: menu → Swarm → an agent → "◂ Back" ×2 lands on the menu, at 40 and at 160 columns; y/n on the Timeline page with a confirm card showing; /ruflo go catalog; /ruflo learning lab.

Problem

Moving around ruflo-console 0.42 is harder than it needs to be:

• Back only worked out of the agent drill-down; everywhere else it jumped to the menu.
• On Timeline, n ("later") is drawn after the confirm card's Cancel n, so pressing n to cancel pans the timeline instead.
• Key hints were stale ("Swarm (2)" — Swarm is 3; "Cost (9)" — Cost is c, 9 is Memory); the Terminal help taught s/o/z keys that do not exist; help said "b back" as if it worked on every page.
• Three different group schemes (nav, menu, help) and pages with two names ("Learning Lab"/"Neural", "Claims Board", "Plugins & Mods").
• viewOf matched only an id, key, exact label or id prefix, so "catalog" at the menu prompt found nothing; /ruflo catalog and /ruflo mission are other commands.
• Refresh replayed the 5–8 s boot screen; below 44 columns the pane armed no page keys and no p/x/r/h.

Changes (0.43.0)

• History: a trail of the pages you visited (cap 20; each agent entry remembers which agent was open; stale pages and vanished agents are skipped). Back returns through it; the agent page keeps "b goes back to …".
• ◂ Back button in the breadcrumb (mouse; no hotkey). A global back key was not possible: pane hotkeys accept one digit or lowercase letter, and ui.close cannot tell Esc from the close mark, so Esc and the close mark are unchanged.
• Confirm card keys win: while an ask is pending, page buttons lose y/n hotkeys (withoutAnswerKeys), so y/n always answer the card (checked for every view).
• Key hints from one table (keyLabel(id) from VIEWS), terminal/help wording fixed.
• One group scheme: NAV_GROUPS drives the menu, tabs and the help index; each page has one label everywhere ("Neural Lab", "Claims", "Plugins", "Room"). Old names still work at the menu prompt and with /ruflo (RETIRED_NAMES).
• Find a page by name: viewOf precedence exact id/key/label → retired name → id prefix (3+) → label prefix → all words; ambiguity → none (a single letter is only ever a key). New /ruflo go <page> (answers with close matches when nothing or several match). /ruflo verbs always win over page names (VERBS, checked against the switch), so /ruflo swarm topology and /ruflo agent <id> keep their meaning. The palette lists pages and ranks a page whose label starts with the query first. /ruflo dump takes a full page name.
• Refresh is instant (re-read + probe, missing-file cache cleared); the boot screen moved to Settings → Replay boot.
• Narrow panes (< 44 columns) keep the digit page keys, the core-tab page keys and p/x/r/h via hidden buttons (drawn before the page, so a page's own key still wins).
• Removed the unreachable flat tab bar.

Tests

New specs: history, back-button, key-shadow, key-labels, group-scheme, commands-verbs, find-by-name, refresh-instant — 132+ tests, each written red first where it pins a fix. Related nav/menu/help/palette specs pass. On this Windows checkout the full vitest suite fails the same set before and after (environment-only: sparse checkout without sibling plugins, symlink EPERM, Windows path bugs fixed separately in #4036, claude-code/testing not importable under vitest); events-sweep hotkey tests occasionally time out under full-suite load and pass alone. claude plugin validate plugins/ruflo-console passes.

Known follow-ups

• plugin.json description still says "The Room lists the sessions…" (page is "Room").
• Words of retired names take part in word matching (/ruflo go agent opens Timeline via "agent timeline"); the typed side is not tokenised like page names (what's new with a straight apostrophe → close-matches list).
• Letter page keys outside the core tabs still only work on their group's tab strip (unchanged).
• Conflicts with fix(console): ruflo-console works on Windows (project paths, home folder, disk writes) — 0.42.2 #4036 (Windows fixes) in register.ts/pane.ts and the version are resolved by whichever merges second.

🤖 Generated with Claude Code

[proffesor-for-testing]

Adversarial review at cf30550cb

Verdict: closest of the three open console PRs to mergeable. No functional defects found. It is blocked by the 500-line smoke check and merge conflicts.

How this was tested: the PR head, plus a trial merge onto current main (keeping main's side of the version files): vitest 3166 pass, kit suite all 247 pass, scripts/typecheck.sh unchanged (7 errors, same as main). gh pr checks reports no checks, so CI has not run.

Checked: no navigation route skips the confirm cards; go, Back and the palette only call setView or drill. Stale trail entries (a gone agent, an unknown page id) are skipped. There are no URLs, so no open redirect.

Findings

1. smoke.sh step 11 fails: controller.ts is 502 lines (the limit is 500), so all-plugins-smoke will be red.
2. Conflicts. It conflicts with main (console is at 0.42.6 there: plugin.json, CHANGELOG.md, hooks/version.ts, scripts/smoke.sh). It also conflicts with feat(console): Chat with Claude — read and talk to the live session from the console (0.44.0) #4041 in nav-state.ts, self-check.ts, views/menu.ts and views/pane.ts. This PR makes NAV_GROUPS the single source for the menu and renames area labels, while feat(console): Chat with Claude — read and talk to the live session from the console (0.44.0) #4041 adds Chat to the old structure. Whichever lands second needs a real rebase, not just conflict fixes.
3. Behaviour changes not mentioned in the description:
   • bindings.ts:271: r at the menu prompt now refreshes instead of replaying the boot.
   • commands.ts:44-47: any multi-word /ruflo <words> whose first word isn't a verb now opens a page by fuzzy match, before the old "Unknown:" reply.
   • Palette ranking (PAGE_LEAD/PAGE_NAMED) can change which entry Enter runs. It only promotes page-open entries, so this is harmless, but users will notice.
4. Nits:
   • The Back trail (history.ts) is in memory only and is lost on restart.
   • b goes back only on the agent page; elsewhere it's the breadcrumb button. The help text says so.