[pruuk]

Summary

Quest and dialogue arc (epic #375), phase 0: one menu primitive that every fixed choice in the game uses, plus the arc's requirements, roadmap, phase 0 spec and plan.

• Menu core (internal/menu): render, resolve, confirm, label lint, close reasons, interrupt and follow lines. Game menus match only a number, Enter, or an exact label, id or alias; prefix matching is builder-only (owner-approved change from the spec, so n and l stay movement and look).
• Game menu session (internal/users): OpenMenu/RouteMenuInput with a busy gate (combat, casting/crafting/salvaging, dead, asleep, quitting, controlled, off feet). State machines got RegisterObserver; characters push busy changes; conditions and room changes close menus. OpenMenu has no production caller until phase 1 (talk).
• Prompts (internal/prompt): menu questions (AskMenu, AskConfirm). Player flows (character, guild, mail, rename, picklock, auctions, deletecharacter) are non-modal: a typed command that is not a choice closes the menu and runs. They close only on a NEW interrupt (OpenedUnder), so mail while sitting still works; room changes and follow pulls always close them. Mail says "You set your unsent mail aside." when a draft is dropped. Builders and start stay modal.
• Typed input only: new events.CmdTyped. Engine-queued commands (follow steps, scripts, admin command forcing a player, web-client Char.Action.Try) can no longer answer a menu or prompt. A player's own macros still can.
• Follow pulls: a leader pulling a follower out of a menu tells the follower, the leader and the room, judged with the leader's own light.
• Builders: every admin numbered list renders through the menu (two columns for long lists, [x] toggles, 0 still finishes a toggle list). Room-editing builders are cancelled when the admin moves (RoomBound). Picking server config entries by number now works; "new" recipe by number now creates one.
• Confirms: two entries, Enter is No, irreversible actions name the action ("Yes, disband it").
• Web client: new GMCP Char.Menu {open} (queued ahead of the menu text, resent on spawn). Ticks and triggers queue while a menu or prompt is open and release one per round after; nothing fires during login (timers cleared on disconnect). Char.Action.Try replies deferred / menu open as a backstop. Queue audit found no defects.
• Both numbered-list templates are deleted; a guard test keeps numbered-menu code inside internal/menu.

Known gaps (filed)

• PvP defender never enters combat, so a menu survives a player's attack; Control is nil for loaded players. Added to One shared busy check: combat, activity, life, position, control, sleep, quitting #640.
• Free-text prompt steps still swallow typed commands (pre-existing): Free-text prompt steps swallow typed commands (mail body becomes 'north') #641.

Test plan

• go build ./..., gofmt -l clean
• go test ./... (all packages; root guards fixed and re-run)
• golangci-lint run --new-from-merge-base=origin/master: 0 issues
• all tools/jstest/*.test.js pass (queue audit 31 checks, automation pause)
• boot check in a detached worktree on private ports: Server Ready, 0 panics
• race detector (needs gcc; not available locally, CI if configured)
• playtest: talk-free menus in play (character, guild, mail, picklock), follow pull, web-client tick pause

Every task had an implementer plus spec and quality reviews; review fixes are in follow-up commits.

🤖 Generated with Claude Code

[pruuk]

Owner ruling 2026-10-20 applied (96b9253): being off your feet (sitting, prone) is not a gate for audio interactions. The menu gate no longer refuses or closes menus for position; combat, busy, dead, asleep, quitting and grapple control still gate. CloseOffFeet and its line are removed; tests prove seated and prone players can open menus and that sitting down keeps one open.