u-foo 2.3.31 → 2.4.0

package/src/{daemon → runtime/daemon}/run.js

@@ -1,6 +1,7 @@
 const path = require("path");
 const { startDaemon, stopDaemon, isRunning } = require("./index");
-const { loadConfig, defaultAgentModelForProvider } = require("../config");
+const { loadConfig, defaultAgentModelForProvider } = require("../../config");
+const { resolveNodeExecutable } = require("../process/nodeExecutable");
 
 function runDaemonCli(argv) {
   const cmd = argv[1] || "start";
@@ -19,7 +20,7 @@ function runDaemonCli(argv) {
     if (isRunning(projectRoot)) return;
     if (!process.env.UFOO_DAEMON_CHILD) {
       const { spawn } = require("child_process");
-      const child = spawn(process.execPath, [path.join(__dirname, "..", "..", "bin", "ufoo.js"), "daemon", "start"], {
+      const child = spawn(resolveNodeExecutable(), [path.join(__dirname, "..", "..", "..", "bin", "ufoo.js"), "daemon", "start"], {
         detached: true,
         stdio: "ignore",
         env: { ...process.env, UFOO_DAEMON_CHILD: "1" },
@@ -32,25 +33,31 @@ function runDaemonCli(argv) {
     return;
   }
   if (cmd === "stop" || cmd === "--stop") {
-    stopDaemon(projectRoot);
+    if (!stopDaemon(projectRoot, { source: process.env.UFOO_DAEMON_STOP_SOURCE || `daemon-cli:${cmd} pid=${process.pid}` })) {
+      process.exitCode = 1;
+    }
     return;
   }
   if (cmd === "restart" || cmd === "--restart") {
     // Stop if running
     if (isRunning(projectRoot)) {
-      stopDaemon(projectRoot);
+      const stopped = stopDaemon(projectRoot, { source: process.env.UFOO_DAEMON_STOP_SOURCE || `daemon-cli:${cmd} pid=${process.pid}` });
       // Wait for clean shutdown
       let attempts = 0;
       while (isRunning(projectRoot) && attempts < 50) {
         attempts++;
         require("child_process").spawnSync("sleep", ["0.1"]);
       }
+      if (!stopped && isRunning(projectRoot)) {
+        process.exitCode = 1;
+        return;
+      }
     }
     // Start fresh daemon
     if (!process.env.UFOO_DAEMON_CHILD) {
       const { spawn } = require("child_process");
       const childEnv = { ...process.env, UFOO_DAEMON_CHILD: "1" };
-      const child = spawn(process.execPath, [path.join(__dirname, "..", "..", "bin", "ufoo.js"), "daemon", "start"], {
+      const child = spawn(resolveNodeExecutable(), [path.join(__dirname, "..", "..", "..", "bin", "ufoo.js"), "daemon", "start"], {
         detached: true,
         stdio: "ignore",
         env: childEnv,

package/src/{daemon → runtime/daemon}/soloBootstrap.js

@@ -1,24 +1,24 @@
 "use strict";
 
 const path = require("path");
-const EventBus = require("../bus");
-const { prepareUcodeBootstrap } = require("../agent/ucodeBootstrap");
-const { isMetaActive } = require("../bus/utils");
-const { getUfooPaths } = require("../ufoo/paths");
+const EventBus = require("../../coordination/bus");
+const { prepareUcodeBootstrap } = require("../../code/launcher/ucodeBootstrap");
+const { isMetaActive } = require("../../coordination/bus/utils");
+const { getUfooPaths } = require("../../coordination/state/paths");
 const {
   applyProjectNicknamePrefix,
   resolveDisplayNickname,
   resolveScopedNickname,
 } = require("./nicknameScope");
-const { loadAgentsData, saveAgentsData } = require("../ufoo/agentsStore");
+const { loadAgentsData, saveAgentsData } = require("../../coordination/state/agentsStore");
 const {
   loadPromptProfileRegistry,
   resolvePromptProfileReference,
-} = require("../group/promptProfiles");
+} = require("../../orchestration/groups/promptProfiles");
 const {
   buildSoloPromptMetadata,
   composeSoloBootstrapPrompt,
-} = require("../group/bootstrap");
+} = require("../../orchestration/groups/bootstrap");
 
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));

package/src/{daemon → runtime/daemon}/status.js

@@ -1,10 +1,10 @@
 const fs = require("fs");
 const path = require("path");
-const { getUfooPaths } = require("../ufoo/paths");
-const { isMetaActive } = require("../bus/utils");
+const { getUfooPaths } = require("../../coordination/state/paths");
+const { isMetaActive } = require("../../coordination/bus/utils");
 const { resolveDisplayNickname, resolveScopedNickname } = require("./nicknameScope");
-const { readReportSummary, countControllerInboxEntries } = require("../report/store");
-const { readRecentLoopSummary } = require("../agent/loopObservability");
+const { readReportSummary, countControllerInboxEntries } = require("../../coordination/report/store");
+const { readRecentLoopSummary } = require("../../agents/controller/loopObservability");
 
 function readBus(projectRoot) {
   const busPath = getUfooPaths(projectRoot).agentsFile;
@@ -16,7 +16,7 @@ function readBus(projectRoot) {
 }
 
 function readDecisions(projectRoot) {
-  const DecisionsManager = require("../context/decisions");
+  const DecisionsManager = require("../../coordination/context/decisions");
   const manager = new DecisionsManager(projectRoot);
   const dir = manager.decisionsDir;
   let open = 0;

package/src/runtime/index.js

@@ -0,0 +1,10 @@
+"use strict";
+
+module.exports = {
+  projects: require("./projects"),
+  terminal: require("./terminal"),
+  contracts: {
+    ...require("./contracts/eventContract"),
+    ...require("./contracts/ptySocketContract"),
+  },
+};

package/src/runtime/process/nodeExecutable.js

@@ -0,0 +1,26 @@
+"use strict";
+
+const fs = require("fs");
+
+function resolveNodeExecutable(options = {}) {
+  const {
+    execPath = process.execPath,
+    env = process.env,
+    fsModule = fs,
+  } = options;
+  const override = String((env && env.UFOO_NODE_EXECUTABLE) || "").trim();
+  if (override) return override;
+  const current = String(execPath || "").trim();
+  if (current) {
+    try {
+      if (fsModule.existsSync(current)) return current;
+    } catch {
+      // Fall through to PATH lookup.
+    }
+  }
+  return "node";
+}
+
+module.exports = {
+  resolveNodeExecutable,
+};

package/src/{projects → runtime/projects}/registry.js

@@ -2,7 +2,7 @@ const fs = require("fs");
 const os = require("os");
 const path = require("path");
 const { canonicalProjectRoot, buildProjectId, trimTrailingSlashes } = require("./projectId");
-const { getUfooPaths } = require("../ufoo/paths");
+const { getUfooPaths } = require("../../coordination/state/paths");
 
 const DEFAULT_STALE_TTL_MS = 30 * 1000;
 const DEFAULT_TMP_CLEANUP_AGE_MS = 5 * 60 * 1000;

package/src/{projects → runtime/projects}/runtimes.js

@@ -17,7 +17,7 @@ function filterVisibleProjectRuntimes(rows = []) {
   const sourceRows = Array.isArray(rows) ? rows : [];
   return sourceRows.filter((row) => {
     const status = String((row && row.status) || "").trim().toLowerCase();
-    return status !== "stopped";
+    return status === "running";
   });
 }
 

package/src/{terminal → runtime/terminal}/adapterRouter.js

@@ -5,7 +5,6 @@ const {
 const { createTerminalAdapter } = require("./adapters/terminalAdapter");
 const { createTmuxAdapter } = require("./adapters/tmuxAdapter");
 const { createInternalQueueAdapter } = require("./adapters/internalQueueAdapter");
-const { createInternalPtyAdapter } = require("./adapters/internalPtyAdapter");
 const { createHostAdapter } = require("./adapters/hostAdapter");
 
 function createTerminalAdapterRouter(options = {}) {
@@ -65,15 +64,6 @@ function createTerminalAdapterRouter(options = {}) {
       });
     }
 
-    if (launchMode === "internal-pty") {
-      return createInternalPtyAdapter({
-        sendRaw,
-        sendResize,
-        requestSnapshot,
-        createAdapter,
-      });
-    }
-
     if (launchMode === "internal") {
       return createInternalQueueAdapter({
         sendRaw,

package/src/{terminal → runtime/terminal}/adapters/internalAdapter.js

@@ -1,10 +1,6 @@
-const { createInternalPtyAdapter } = require("./internalPtyAdapter");
 const { createInternalQueueAdapter } = require("./internalQueueAdapter");
 
 function createInternalAdapter(options = {}) {
-  if (options.usePty) {
-    return createInternalPtyAdapter(options);
-  }
   return createInternalQueueAdapter(options);
 }
 

package/src/tools/handlers/common.js

@@ -1,4 +1,4 @@
-const EventBus = require("../../bus");
+const EventBus = require("../../coordination/bus");
 const { CALLER_TIERS, normalizeCallerTier } = require("../types");
 
 function extractAuditFields(ctx = {}) {

package/src/tools/handlers/listAgents.js

@@ -1,4 +1,4 @@
-const { buildStatus } = require("../../daemon/status");
+const { buildStatus } = require("../../runtime/daemon/status");
 
 function listAgentsHandler(ctx = {}) {
   const status = buildStatus(ctx.projectRoot);

package/src/tools/handlers/memory.js

@@ -1,6 +1,6 @@
-const MemoryManager = require("../../memory");
-const { estimateTokens } = require("../../memory");
-const { searchHistory } = require("../../memory/historySearch");
+const MemoryManager = require("../../coordination/memory");
+const { estimateTokens } = require("../../coordination/memory");
+const { searchHistory } = require("../../coordination/memory/historySearch");
 const { buildToolError, extractAuditFields, requireSubscriber } = require("./common");
 
 const BANNED_TIME_PATTERNS = [

package/src/tools/handlers/readBusSummary.js

@@ -1,4 +1,4 @@
-const { buildStatus } = require("../../daemon/status");
+const { buildStatus } = require("../../runtime/daemon/status");
 
 function readBusSummaryHandler(ctx = {}) {
   const status = buildStatus(ctx.projectRoot);

package/src/tools/handlers/readOpenDecisions.js

@@ -1,4 +1,4 @@
-const DecisionsManager = require("../../context/decisions");
+const DecisionsManager = require("../../coordination/context/decisions");
 
 function readOpenDecisionsHandler(ctx = {}, args = {}) {
   const limit = Number.isFinite(Number(args.limit)) && Number(args.limit) > 0

package/src/tools/handlers/readProjectRegistry.js

@@ -1,4 +1,4 @@
-const { listProjectRuntimes } = require("../../projects/registry");
+const { listProjectRuntimes } = require("../../runtime/projects/registry");
 
 function readProjectRegistryHandler(_ctx = {}, args = {}) {
   const validate = args.validate !== false;

package/src/tools/handlers/readPromptHistory.js

@@ -1,8 +1,8 @@
 const fs = require("fs");
 const path = require("path");
 
-const { buildStatus } = require("../../daemon/status");
-const { getUfooPaths } = require("../../ufoo/paths");
+const { buildStatus } = require("../../runtime/daemon/status");
+const { getUfooPaths } = require("../../coordination/state/paths");
 
 function clipPromptText(value = "", maxChars = 240) {
   const text = String(value || "").replace(/\s+/g, " ").trim();

package/src/tools/schemaFixtures.js

@@ -456,7 +456,7 @@ const LAUNCH_AGENT_SCHEMA = Object.freeze({
     properties: Object.freeze({
       agent: Object.freeze({
         type: "string",
-        enum: Object.freeze(["codex", "claude", "ucode"]),
+        enum: Object.freeze(["codex", "claude", "ucode", "agy"]),
       }),
       count: Object.freeze({ type: "integer", minimum: 1 }),
       nickname: Object.freeze({ type: "string" }),

package/src/ui/MIGRATION.md

@@ -0,0 +1,336 @@
+# Ink TUI Migration Plan
+
+Status: Ink is the only TUI for chat and ucode. The legacy blessed renderer
+has been removed after the parity close-out.
+
+## Why
+
+The removed legacy chat, ucode and internal-agent TUIs used blessed. Blessed
+is an unmaintained imperative widget tree with no modern equivalent of
+React's component model, and it was awkward to extend (manual layout math,
+manual redraws, no useful test harness).
+
+ink (the React-for-terminals library, what Claude Code, Codex CLI fronts
+and the Gemini CLI all use) gives us declarative components, flexbox
+layout, hooks, and proper isolation of pure logic from rendering.
+
+## Approach
+
+- Ink is the renderer for both chat and ucode.
+- Pure helpers live in `src/ui/format/`, so behaviour parity is enforced by
+  test rather than copy/paste.
+- Components live in `src/ui/ink/`, written in plain JS via
+  `React.createElement` (no JSX, no build step) so jest stays vanilla.
+- ink is loaded through `src/ui/runInk.js`, a thin CJS→ESM bridge so the
+  rest of the codebase stays CommonJS.
+
+## Progress
+
+- **P0** ✅ ink + react deps, runtime bridge, `<InkDemo>` smoke harness,
+  pure helpers extracted to `src/ui/format/`.
+- **P1** ✅ ucode TUI ported to ink.
+- **P2** ✅ folded into P3.6 (internal agent view).
+- **P3** ✅ chat TUI ported to ink. Daemon
+  connection, dashboard (5 views), tool-merge, status spinner, history,
+  agent selection, raw-PTY mirror and internal bus agent view are wired.
+- **P4** ✅ parity close-out complete: full `commandExecutor` dispatch,
+  `daemonMessageRouter` callback coverage, persisted history, BUS streams,
+  transient agent state, loop summary, project rail switching, cron/settings
+  dashboard actions, completion popup, and default Ink entrypoints.
+
+## P1 ucode TUI — what's wired
+
+| Feature | Status |
+|---|---|
+| Banner + version + session id header | ✅ |
+| Scrolling `<Static>` log (1000 line cap) | ✅ |
+| Multiline input (cursor math, Ctrl+A/E/B/F/D/H/K/U/W, Meta+B/F/D, `\\\n` continuation, Alt+Enter newline, CJK wrap) | ✅ |
+| Up/Down history walk + agent-selection mode | ✅ |
+| Ctrl+C exit, Ctrl+O expand last tool group | ✅ |
+| Tool merge/freeze/expand state machine | ✅ |
+| Spinner + phase status line (request/thinking/text/tool labels) | ✅ |
+| Esc abort with `AbortController` and "Cancelling..." status | ✅ |
+| Agents footer with single-line truncation + `+N more` hint | ✅ |
+| `runSingleCommand` empty/exit/probe/help/error/tool/nl/ubus/resume/nl_bg kinds | ✅ |
+| Background tasks ("BG x/y/z" suffix) | ✅ |
+| ubus / resume / nl_bg branches | ✅ |
+| autoBus polling | ✅ |
+
+## Real-TTY checklist
+
+```sh
+./bin/ucode.js
+```
+
+### Editor
+
+- [ ] Type, see characters appear with the cursor on the next cell.
+- [ ] Backspace deletes one cell back; cursor stays correct on CJK.
+- [ ] Left/Right arrows move the cursor; resetting preferred col.
+- [ ] Up/Down on a single line walks input history.
+- [ ] Up/Down on a multiline value moves between visual rows.
+- [ ] `\` followed by Enter inserts a newline; Enter alone submits.
+- [ ] Alt+Enter inserts a newline.
+- [ ] Ctrl+A / Ctrl+E jump to row start / end.
+- [ ] Ctrl+W deletes the previous word (also Meta+Backspace).
+- [ ] Long pasted text doesn't lock up the renderer.
+- [ ] Resize the terminal — input frame and footer span the new width.
+
+### Status line
+
+- [ ] Shows `UCODE · Ready` while idle.
+- [ ] Shows a spinning indicator + phase ("Waiting for model...",
+  "Thinking...", "Generating response...", "Calling X...") during
+  `runNaturalLanguageTask`.
+- [ ] Appends `(<elapsed> s, esc cancel)` when a task is in flight.
+- [ ] Esc on a running task flips to "Cancelling..." then back to Ready.
+
+### Tool calls
+
+- [ ] Single tool call renders one line (`· tool · detail`).
+- [ ] Two+ consecutive tool calls collapse to one row + `(Ctrl+O expand)`.
+- [ ] Ctrl+O expands the most recent group with `│`/`└` branch markers
+  and only fires once per group.
+- [ ] When text arrives between tool calls, the previous group freezes
+  into the log and a fresh group starts on the next tool call.
+
+### Agents footer
+
+- [ ] Shows `Agents: none  │ No target agents` when nothing's online.
+- [ ] Shows `Agents: @x @y ...  │ ↓ select target · ←/→ switch` otherwise.
+- [ ] At narrow widths, the row stays single-line, drops trailing chips
+  and emits ` +N more`.
+- [ ] Down enters selection mode (first chip inverse). Left/Right cycle.
+  Up exits. Prompt prefix changes to `›@<name> ` when locked.
+
+### Smoke
+
+- [ ] `node scripts/ucode-app-smoke.js` exits 0.
+- [ ] `npx jest --silent` shows the pre-existing 5 OAuth failures only;
+  every ink suite passes.
+
+## Decision log
+
+- **Don't fork ink.** Claude-code-fixed inlines a customised ink under
+  `src/ink/`; we don't need React 19 / ConcurrentRoot / IDE bridging,
+  so depending on the public `ink@5` keeps maintenance cost low.
+- **Don't add JSX.** `React.createElement` keeps jest CJS happy and
+  avoids a build step. We can revisit if any single component grows
+  past ~600 lines and readability suffers.
+- **Don't enable `--experimental-vm-modules` for jest.** The risk of
+  surprise ESM behaviour across the existing 1800-test suite is too
+  high. Render coverage stays in `scripts/*-smoke.js`; component logic
+  is exercised by pure-function tests.
+- **Codex isn't a useful reference.** Its TUI is a Rust ratatui app
+  (`codex-rs/tui`), not React-based. The architectural principle worth
+  borrowing is its hard split between TUI and core protocol.
+
+## P2 dropped, folded into P3
+
+The internal-agent view in chat is not an independent program. It is now
+an Ink chat sub-mode, so the earlier plan to mount a separate subtree was
+folded into P3.6.
+
+## P3 audit (chat TUI surface)
+
+Source: the current Ink host in `src/ui/ink/ChatApp.js`, with
+shared daemon and command helpers under `src/app/chat/`. Highlights:
+
+### Lifecycle
+- Public entrypoint `runChat(projectRoot, { globalMode })` from
+  `src/app/chat/index.js`; it delegates directly to the Ink ChatApp.
+- Runners injected via closures: `daemonCoordinator.send`,
+  `executeCommand`, `inputSubmitHandler.handleSubmit`,
+  `daemonMessageRouter.handleMessage`.
+
+### View state machine
+- `dashboardView` ∈ `projects | agents | mode | provider | cron`
+- `focusMode` ∈ `input | dashboard` — toggled by Tab and arrow keys
+- `globalMode` (boolean) + `globalScope` ∈ `controller | project` —
+  `globalMode=true` enables a multi-project rail; Esc/Enter walk the
+  scope ladder.
+- `enterDashboardMode()` / `exitDashboardMode()` are the two transition
+  points; `setGlobalScope()` runs an async, debounced project switch.
+
+### Input
+- Submit accepts `@mention`, `@target`, `/command`, plain text and
+  numeric disambiguation (when `pending.disambiguate` is set).
+- Editor keys cover Ctrl+A/E/B/F/D/H/K/U/W, Meta+B/F/D, arrows
+  (cursor + history when empty), Esc (3-layer: clear @target →
+  exit project scope → cancel input), bracketed paste, Tab (toggle
+  dashboard), PgUp/PgDn (scroll log).
+- Completion fires on `/` and `@` with sources from command registry,
+  group templates, solo profiles and agent mentions; Up arrow jumps to
+  the latest suggestion.
+- History is per-project, persisted to `input-history.jsonl` with
+  draft restoration on project switch.
+
+### Daemon stack
+- `daemonTransport` owns the socket path and retry policy.
+- `daemonConnection` owns the queue + lifecycle (`connect`, `send`,
+  `requestStatus`, `close`, `markExit`, `switchConnection`,
+  `getState`).
+- `daemonCoordinator` orchestrates project switches with a serialised
+  Promise chain.
+- `daemonMessageRouter.handleMessage(msg)` is a stateless dispatcher
+  that turns daemon responses into log appends, dashboard updates, PTY
+  writes and transient agent state changes.
+- `daemonReconnect.restartDaemonFlow()` provides a per-project lock for
+  daemon restarts.
+
+### Shared helpers
+- `cronScheduler` — `/cron start|stop|list` + the cron dashboard view.
+- `settingsController` — launch mode / agent provider,
+  with daemon restart on mode/provider change. `autoResume` stays config/command-driven.
+- `transientAgentState` — TTL-bounded `working / waiting_input /
+  blocked` markers per agent.
+- `projectCloseController` — `requestCloseProject(index)` runs daemon
+  stop + project switch.
+- `agentDirectory` — agent label resolution + window clamping (pure).
+- `internalAgentLogHistory` — bus log replay for internal agents.
+
+### Internal-agent sub-view
+- Ink owns the agent sub-view inside ChatApp.
+- PTY mirror mode uses `agentSockets.connectOutput/Input` and
+  `requestSnapshot`.
+- Embedded bus mode keeps its own input value, cursor, log and status.
+- `agentSockets.createAgentSockets` owns the PTY/bus socket
+  lifecycle.
+
+### Layout (Ink)
+- `ChatApp` owns the chat surface as a React tree under
+  `src/ui/ink/`.
+- Dashboard, log, status, completion, internal-agent panes and input are
+  rendered from React state with ink flex layout. No blessed widget geometry
+  or controller layer remains.
+
+### Commands
+`/bus`, `/ctx`, `/daemon`, `/doctor`, `/cron`, `/group`, `/init`,
+`/open`, `/launch`, `/project`, `/role`, `/solo`, `/settings`,
+`/help`, plus nested subcommands (`/bus activate|list|rename|send|status`,
+`/cron start|list|stop`, etc.). `commandExecutor.executeCommand(text)`
+is the single dispatch point. `parseCommand(text)`, `parseAtTarget(text)`
+and `shouldEchoCommandInChat(text)` are pure.
+
+### Cross-cutting
+- `text.js`: `escapeBlessed`, `stripBlessedTags`, `stripAnsi`,
+  `truncateAnsi`, `decodeEscapedNewlines`. The blessed-tag helpers are now
+  compatibility shims for older daemon/router log strings; ink call sites
+  strip or normalize those tags before rendering. The ANSI helpers stay
+  relevant.
+- `rawKeyMap.keyToRaw(ch, key)`: converts ink-style key events to
+  PTY bytes for the agent view. Stays as-is.
+- `transport.js`: `startDaemon`, `stopDaemon`, `connectWithRetry`.
+  Framework-agnostic, no migration needed.
+
+### Removal notes
+1. **Entry**: `src/app/chat/index.js` delegates directly to `runChatInk()`.
+2. **ucode**: `src/code/tui.js` is a compatibility export wrapper around
+   `src/ui/format/` and `runUcodeInkTui()`.
+3. **Controllers**: the blessed widget controllers and their tests were
+   removed with the fallback path.
+4. **Markup**: old brace-tag helpers remain only where shared daemon/chat
+   helpers still emit or sanitize legacy log markup.
+
+### P3 phase plan
+
+| Step | Goal | Status |
+|---|---|---|
+| P3.1 | This audit | ✅ |
+| P3.2 | Ink-only `runChat()` entrypoint | ✅ |
+| P3.3 | ChatApp shell (banner + log + input + status) | ✅ |
+| P3.4 | Five dashboard views as React components | ✅ |
+| P3.5 | Daemon connection + PROMPT/BUS_SEND wiring | ✅ |
+| P3.6 | Raw-PTY internal agent view as a ChatApp mode | ✅ |
+| P3.7 | Real-TTY checklist | ✅ |
+
+## P3 chat TUI — what's wired
+
+| Feature | Status |
+|---|---|
+| Banner header (project + global mode + scope) | ✅ |
+| Scrolling `<Static>` log (1000 line cap) | ✅ |
+| Multiline input (P1 MultilineInput component) | ✅ |
+| 5 dashboard views (projects/agents/mode/provider/cron) | ✅ |
+| Tab toggles input/dashboard focus | ✅ |
+| Up/Down history walk + agent selection mode | ✅ |
+| Left/Right cycle agents while selected | ✅ |
+| Spinner + phase status line | ✅ |
+| Tool-merge state machine + Ctrl+O expand | ✅ |
+| Daemon connect / send / status poll | ✅ |
+| `PROMPT` for free text, `BUS_SEND` for `@target` | ✅ |
+| `BUS_SEND_OK` / `RESPONSE` / `ERROR` / `STATUS` / `BUS` envelopes | ✅ |
+| Raw PTY agent mirror (Enter on selected agent, Esc to leave) | ✅ |
+| `daemonMessageRouter` (markdown streams, transient state, bus subview) | ✅ |
+| `commandExecutor` full slash-command dispatch (`/cron`, `/group`, `/role`, `/settings` …) | ✅ |
+| Slash + `@` autocomplete | ✅ |
+| Input history persisted file load/save | ✅ |
+| Cron dashboard actions | ✅ |
+| Settings dashboard actions (launch mode, provider) | ✅ |
+
+## Real-TTY checklist for chat
+
+```sh
+./bin/ufoo.js chat                   # project mode
+./bin/ufoo.js chat --global          # global controller mode
+```
+
+### Layout
+- [ ] Banner shows the active project + global/project tag.
+- [ ] `Agents:` footer, status line above input, log fills the rest.
+- [ ] Resize the terminal — input frame and footer stay single-line.
+
+### Input + history
+- [ ] Type, Enter sends a `PROMPT`. Backspace, arrows, Ctrl+A/E etc.
+  behave the same as the ucode editor.
+- [ ] Up/Down on an empty draft walks the in-memory history.
+- [ ] `\` + Enter inserts a newline.
+- [ ] Esc clears any active agent selection.
+
+### Daemon
+- [ ] On launch the daemon spawns automatically (look for the socket
+  under `~/.ufoo` or your project's `.ufoo`).
+- [ ] Send a free-text message — daemon answers, status flips to
+  `Working on task...` and back to Ready.
+- [ ] Type `@<agent> hi` (or select with arrow keys) — message is
+  sent via `BUS_SEND`, ack arrives as `✓ Message delivered`.
+
+### Agents footer
+- [ ] Tab into the dashboard, ↓ enters agent selection (first item
+  inverse), ←/→ cycles, ↑ exits.
+- [ ] Enter on a selected agent attaches to its PTY (cleared screen +
+  scroll region + bottom hint bar). Esc returns to chat without
+  losing the previous draft or log.
+
+### Tool-merge
+- [ ] Daemon-driven tool calls collapse and `(Ctrl+O expand)` works
+  the same as ucode.
+
+### Smoke
+- [ ] `node scripts/chat-app-smoke.js` exits 0.
+- [ ] `node scripts/ucode-app-smoke.js` exits 0.
+- [ ] `npx jest --silent` shows the pre-existing 5 OAuth failures
+  only; every ink suite passes.
+
+## P4 close-out
+
+- **STATUS handler fix** — chat now reads `msg.data.active` /
+  `msg.data.active_meta` / `msg.data.cron.tasks` so the agents and cron
+  counts in the footer actually update.
+- **Slash command dispatch** — `createCommandExecutor` is wired in Ink
+  with daemon stop/start/restart, cron IPC, project switching and agent
+  activation callbacks.
+- **Input history persistence** — `<projectRoot>/.ufoo/chat/input-history.jsonl`
+  is loaded on mount and appended on every submit.
+- **Daemon message routing** — Ink routes daemon envelopes through
+  `daemonMessageRouter`, including BUS phase status, transient states,
+  pending delivery markers, streams, close/launch refreshes and loop
+  summary dashboard display.
+- **Inline completion popup** — `/<prefix>` matches commands from
+  `COMMAND_REGISTRY`; `@<prefix>` matches the live agents list. Tab
+  accepts the top suggestion. Pure helper `buildCompletions` lives in
+  `src/ui/format` with full jest coverage.
+- **Exit hygiene** — Ctrl+C now flushes `\x1b[2J\x1b[H` so the shell
+  prompt comes back to a clean screen instead of sitting under the
+  final ink frame; `runUcodeInkTui` returns `{ code: 0 }` so
+  `agent.js`'s `process.exit(res.code)` no longer crashes.