@higherdev/cli 0.17.0 → 0.21.0

package/README.md

@@ -49,6 +49,7 @@ workspace-map config shapes are migrated automatically when they are read.
 | `hd env ls` | List workspace environment variable names |
 | `hd env set NAME=VALUE [NAME=VALUE...]` | Set workspace environment variables |
 | `hd env rm NAME` | Remove a workspace environment variable |
+| `hd host roll [--host HOST] [--address ADDR] [--checkout DIR]` | Pull, install, and restart a runner over SSH, then watch drain |
 | `hd host env ls` | List environment variable names on the workspace's default host |
 | `hd host env set NAME=VALUE [NAME=VALUE...]` | Set host-only environment variables |
 | `hd host env rm NAME` | Remove a host-only environment variable |
@@ -64,9 +65,15 @@ workspace-map config shapes are migrated automatically when they are read.
 | `hd upgrade --host HOST [--checkout DIR] [options]` | Refresh this host configuration |
 
 `hd init` uses `~/hdx` as its checkout by default. Pass `--checkout DIR` when the runner source is
-elsewhere. If the runner environment or service unit already exists, inspect the paths it prints and
+elsewhere. Pass `--address HOST` to store `RUNNER_SSH_ADDRESS` so `hd host roll` can SSH to that
+host. If the runner environment or service unit already exists, inspect the paths it prints and
 pass `--force` only when replacing that host configuration is intentional.
 
+`hd host roll` SSHes to the host address (`--address`, or `RUNNER_SSH_ADDRESS` from the host
+heartbeat), pulls the checkout, installs, and restarts the systemd unit. The runner drains live
+runs for up to 15 minutes (`RUNNER_DRAIN_TIMEOUT_MS`) before force-closing leftovers. The systemd
+unit `TimeoutStopSec` is one minute above that drain timeout.
+
 `hd workspace new` uses the operator's authenticated `gh`, defaults to the repository's real default
 branch, bootstraps an empty repository unless `--no-bootstrap` is set, and invites `mel-ilotus` with push
 access for user-owned repositories or admin for organization-owned repositories unless `--runner-user USER`

package/dist/api.js

@@ -75,6 +75,9 @@ export async function listTicketStory(key, config = loadConfig()) {
 export async function postMessage(fields, config = loadConfig()) {
     return request(config, "POST", `/api/w/${config.slug}/messages`, fields);
 }
+export async function getRun(id, config = loadConfig()) {
+    return request(config, "GET", `/api/w/${config.slug}/runs/${encodeURIComponent(id)}`);
+}
 export async function answerDecision(id, answer_md, config = loadConfig()) {
     return request(config, "POST", `/api/w/${config.slug}/decisions/${encodeURIComponent(id)}/answer`, { answer_md });
 }
@@ -128,6 +131,12 @@ export async function setHostEnv(host, name, value, config = loadConfig()) {
 export async function removeHostEnv(host, name, config = loadConfig()) {
     return request(config, "DELETE", `/api/hosts/${encodeURIComponent(host)}/env`, { name });
 }
+export async function getRoadmap(config = loadConfig()) {
+    return request(config, "GET", `/api/w/${config.slug}/roadmap`);
+}
+export async function updateRoadmap(vision_md, config = loadConfig()) {
+    return request(config, "PATCH", `/api/w/${config.slug}/roadmap`, { vision_md });
+}
 export async function listEpics(config = loadConfig()) {
     return request(config, "GET", `/api/w/${config.slug}/epics`);
 }
@@ -137,6 +146,9 @@ export async function createEpic(fields, config = loadConfig()) {
 export async function approveEpic(id, config = loadConfig()) {
     return request(config, "PATCH", `/api/w/${config.slug}/epics`, { id });
 }
+export async function updateEpic(id, fields, config = loadConfig()) {
+    return request(config, "PATCH", `/api/w/${config.slug}/epics`, { id, ...fields });
+}
 export async function deleteEpic(id, config = loadConfig()) {
     return request(config, "DELETE", `/api/w/${config.slug}/epics`, { id });
 }
@@ -152,6 +164,10 @@ export async function listMessages(options = {}, config = loadConfig()) {
         query.set("offset", String(options.offset));
     if (options.toRoles?.length)
         query.set("to_role", options.toRoles.join(","));
+    if (options.fromRoles?.length)
+        query.set("from_role", options.fromRoles.join(","));
+    if (options.unticketed)
+        query.set("unticketed", "true");
     if (options.undelivered)
         query.set("undelivered", "true");
     if (options.delivered)

package/dist/host.js

@@ -53,6 +53,35 @@ export function launchdPlist(opts) {
 </plist>
 `;
 }
+export const DEFAULT_DRAIN_TIMEOUT_MS = 15 * 60_000;
+export const HOST_ROLL_USAGE = "usage: hd host roll [--host HOST] [--address ADDR] [--checkout DIR]";
+export function systemdStopTimeoutSec(drainTimeoutMs = DEFAULT_DRAIN_TIMEOUT_MS) {
+    return Math.ceil(drainTimeoutMs / 1_000) + 60;
+}
+export function formatDrainStatus(live, until, now = Date.now()) {
+    const remaining = Date.parse(until) - now;
+    const minutes = Number.isFinite(remaining) ? Math.max(0, Math.ceil(remaining / 60_000)) : 0;
+    const runs = live === 1 ? "1 run" : `${live} runs`;
+    return `draining: ${runs}, up to ${minutes}m`;
+}
+export function hostDrainFromStats(stats) {
+    if (!stats || typeof stats !== "object" || Array.isArray(stats))
+        return null;
+    const draining = stats.draining;
+    if (!draining || typeof draining !== "object" || Array.isArray(draining))
+        return null;
+    const live = Number(draining.live);
+    const until = draining.until;
+    if (!Number.isFinite(live) || live < 0 || typeof until !== "string")
+        return null;
+    return { live, until };
+}
+export function sshAddressFromStats(stats) {
+    if (!stats || typeof stats !== "object" || Array.isArray(stats))
+        return null;
+    const value = stats.ssh_address;
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
 export function systemdUnit(opts) {
     return `[Unit]
 Description=HDX runner
@@ -65,6 +94,8 @@ WorkingDirectory=${opts.workDir}
 ExecStart=${opts.nodePath} --experimental-strip-types ${opts.runnerPath}
 Restart=always
 RestartSec=5
+TimeoutStopSec=${systemdStopTimeoutSec(opts.drainTimeoutMs)}
+KillMode=mixed
 
 [Install]
 WantedBy=default.target
@@ -85,6 +116,8 @@ export function parseHostFlags(argv) {
             flags.host = next();
         else if (arg === "--checkout")
             flags.checkout = next();
+        else if (arg === "--address")
+            flags.address = next();
         else if (arg === "--force")
             flags.force = true;
         else if (arg === "--env-out")
@@ -104,6 +137,45 @@ export function parseHostFlags(argv) {
     }
     return flags;
 }
+export function parseHostRollFlags(argv) {
+    const flags = {};
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        const next = () => {
+            const value = argv[i + 1];
+            if (!value || value.startsWith("--"))
+                throw new Error(`Missing value for ${arg}`);
+            i += 1;
+            return value;
+        };
+        if (arg === "--host")
+            flags.host = next();
+        else if (arg === "--address")
+            flags.address = next();
+        else if (arg === "--checkout")
+            flags.checkout = next();
+        else if (!arg.startsWith("-") && !flags.host)
+            flags.host = arg;
+        else
+            throw new Error(arg.startsWith("-") ? `Unknown option: ${arg}` : HOST_ROLL_USAGE);
+    }
+    return flags;
+}
+function shellQuote(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+export function hostRollCommand(checkout) {
+    return [
+        "set -e",
+        `cd ${shellQuote(checkout)}`,
+        "git pull --ff-only",
+        "pnpm install",
+        "systemctl --user restart hdx-runner.service",
+    ].join(" && ");
+}
+async function defaultSsh(address, command) {
+    return execFileAsync("ssh", ["-o", "BatchMode=yes", address, "bash", "-lc", command], { encoding: "utf8" });
+}
 async function exists(file) {
     try {
         await access(file);
@@ -159,6 +231,9 @@ export async function initHost(flags, env = process.env) {
         RUNNER_HOST: host,
         WORKTREE_ROOT: worktreeRoot,
         GH_TOKEN: env.GH_TOKEN || existing.GH_TOKEN || "",
+        ...(flags.address || env.RUNNER_SSH_ADDRESS || existing.RUNNER_SSH_ADDRESS
+            ? { RUNNER_SSH_ADDRESS: flags.address || env.RUNNER_SSH_ADDRESS || existing.RUNNER_SSH_ADDRESS }
+            : {}),
     };
     await mkdir(path.dirname(envFile), { recursive: true });
     await writeFile(envFile, formatEnvFile(merged), { encoding: "utf8", mode: 0o600 });
@@ -198,3 +273,48 @@ export async function initHost(flags, env = process.env) {
     lines.push("Start the runner service to register this host.");
     return lines.join("\n");
 }
+const ROLL_WAIT_MS = DEFAULT_DRAIN_TIMEOUT_MS + 2 * 60_000;
+export async function hostRoll(flags, deps = {}) {
+    const log = deps.log ?? ((line) => console.log(line));
+    const now = deps.now ?? Date.now;
+    const sleep = deps.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    const ssh = deps.ssh ?? defaultSsh;
+    const loadStatus = deps.getStatus ?? (await import("./api.js")).getStatus;
+    const snapshot = await loadStatus();
+    const host = flags.host ?? snapshot.workspace.default_host;
+    const address = flags.address ?? snapshot.host?.ssh_address ?? null;
+    if (!address) {
+        throw new Error(`hd host roll needs an SSH address for ${host}. Pass --address or set RUNNER_SSH_ADDRESS on the host.`);
+    }
+    const checkout = expandHome(flags.checkout ?? "~/hdx", homedir());
+    const command = hostRollCommand(checkout);
+    const lines = [`rolling ${host} at ${address}`];
+    log(lines[0]);
+    await ssh(address, command);
+    const restarted = `restarted ${host}; waiting for drain`;
+    lines.push(restarted);
+    log(restarted);
+    const before = snapshot.host?.last_seen_at ?? null;
+    const deadline = now() + (deps.waitMs ?? ROLL_WAIT_MS);
+    let lastDrain = "";
+    while (now() < deadline) {
+        const status = await loadStatus();
+        const drain = status.host?.draining ?? null;
+        if (drain) {
+            const line = formatDrainStatus(drain.live, drain.until, now());
+            if (line !== lastDrain) {
+                lastDrain = line;
+                lines.push(line);
+                log(line);
+            }
+        }
+        else if (status.host?.last_seen_at && status.host.last_seen_at !== before && status.host.runner_version) {
+            const line = `${host} runner ${status.host.runner_version}`;
+            lines.push(line);
+            log(line);
+            return lines;
+        }
+        await sleep(2_000);
+    }
+    throw new Error(`timed out waiting for ${host} to finish draining`);
+}

package/dist/index.js

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 import { realpathSync } from "node:fs";
 import { pathToFileURL } from "node:url";
-import { approveEpic, answerDecision, cancelTicket, createEpic, deleteAgent, deleteEpic, getStatus, getWorkspace, listAgents, listEpics, listHostEnv, listMessages, listWorkspaceEnv, listTicketRunEvents, listTickets, listWorkspaces, postMessage, queueTicket, removeWorkspaceEnv, removeHostEnv, setPaused, setWorkspaceEnv, setHostEnv, showTicket, updateAgent, updateCaps, } from "./api.js";
-import { initHost, parseHostFlags } from "./host.js";
+import { approveEpic, answerDecision, cancelTicket, createEpic, deleteAgent, deleteEpic, getStatus, getRoadmap, getWorkspace, listAgents, listEpics, listHostEnv, listMessages, listWorkspaceEnv, listTicketRunEvents, listTickets, listWorkspaces, postMessage, queueTicket, removeWorkspaceEnv, removeHostEnv, setPaused, setWorkspaceEnv, setHostEnv, showTicket, updateAgent, updateEpic, updateCaps, } from "./api.js";
+import { formatDrainStatus, hostRoll, initHost, parseHostFlags, parseHostRollFlags } from "./host.js";
 import { login, parseLoginFlags } from "./login.js";
 import { loadConfig } from "./config.js";
 import { epicProgressRows, readEpicSpec } from "./epics.js";
+import { roadmapText } from "./roadmap.js";
 import { banner, c, statusChip, table, truncate, usage } from "./out.js";
 import { ticketNew } from "./ticket-commands.js";
 import { ticketViewLines } from "./tui/ticket-view.js";
@@ -63,6 +64,9 @@ async function cmdStatus() {
     const data = await getStatus();
     const state = data.workspace.paused ? c.yellow("off") : c.green("on");
     console.log(`${c.bold(data.workspace.name)}  ${c.dim(data.workspace.repo)}  ${state}\n`);
+    if (data.host?.draining) {
+        console.log(`${c.yellow(formatDrainStatus(data.host.draining.live, data.host.draining.until))}\n`);
+    }
     const waiting = [...new Set(data.tickets.map((ticket) => ticket.stuck_reason
             ?.match(/^Waiting on (\w+) until (\d{1,2}:\d{2})\.$/)).filter(Boolean)
             .map((match) => `${match?.[1]} waiting until ${match?.[2]}`))];
@@ -175,7 +179,44 @@ async function cmdEpic(argv) {
         }
         return;
     }
-    fail("usage: hd epic new PATH [--title TITLE] | list | approve ID | rm ID");
+    if (action === "set") {
+        const parsed = flags(rest);
+        const id = parsed.rest[0];
+        const choices = ["after", "position", "depends-on"].filter((name) => parsed.opts[name] !== undefined);
+        if (!id || parsed.rest.length !== 1 || choices.length !== 1) {
+            fail("usage: hd epic set ID --after ID | --position N | --depends-on ID");
+        }
+        const position = parsed.opts.position ? Number(parsed.opts.position) : undefined;
+        if (position !== undefined && (!Number.isInteger(position) || position < 1)) {
+            fail("position must be a positive integer.");
+        }
+        const { epic } = await updateEpic(id, {
+            ...(parsed.opts.after ? { after: parsed.opts.after } : {}),
+            ...(position !== undefined ? { position } : {}),
+            ...(parsed.opts["depends-on"] ? { depends_on: [parsed.opts["depends-on"]] } : {}),
+        });
+        console.log(`${c.bold(epic.id)}  position ${epic.position}`);
+        return;
+    }
+    fail("usage: hd epic new PATH [--title TITLE] | list | approve ID | rm ID | set ID --position N");
+}
+async function cmdRoadmap(argv) {
+    const parsed = flags(argv);
+    if (parsed.rest.length || [...parsed.bools].some((name) => name !== "json") || Object.keys(parsed.opts).length) {
+        fail("usage: hd roadmap [--json]");
+    }
+    const data = await getRoadmap();
+    if (parsed.bools.has("json"))
+        return console.log(JSON.stringify(data));
+    if (!data.roadmap)
+        return console.log(c.dim("No roadmap."));
+    console.log(c.bold("Vision"));
+    console.log(data.roadmap.vision_md);
+    if (!data.epics.length)
+        return console.log(`\n${c.dim("No epics.")}`);
+    console.log("");
+    for (const line of roadmapText(data.epics))
+        console.log(line);
 }
 async function cmdPlan(argv) {
     if (argv.length)
@@ -423,12 +464,23 @@ function githubSecretMissing(error) {
     return /404|not found|does not exist/i.test(message);
 }
 export async function cmdEnv(argv, deps = {}) {
-    const [action, ...args] = argv;
-    if (action === "ls") {
-        const { env } = await listWorkspaceEnv();
+    const parsed = flags(argv);
+    const [rawAction, ...args] = parsed.rest;
+    const action = !rawAction && parsed.bools.has("vercel") ? "ls" : rawAction;
+    if (action === "ls" && !args.length && !Object.keys(parsed.opts).length
+        && [...parsed.bools].every((name) => name === "vercel")) {
+        const showVercel = parsed.bools.has("vercel");
+        const [{ env }, detail] = await Promise.all([listWorkspaceEnv(), showVercel ? getWorkspace() : null]);
         if (!env.length)
             return console.log(c.dim("No workspace environment variables."));
-        console.log(table(["NAME", "UPDATED"], env.map((row) => [row.name, row.updated_at])));
+        if (!showVercel)
+            console.log(table(["NAME", "UPDATED"], env.map((row) => [row.name, row.updated_at])));
+        else {
+            const production = new Set(detail?.workspace.settings?.vercel?.production_env ?? []);
+            console.log(table(["NAME", "UPDATED", "VERCEL"], env.map((row) => [
+                row.name, row.updated_at, production.has(row.name) ? "yes" : "no",
+            ])));
+        }
         return;
     }
     if (action === "set" && args.length) {
@@ -471,11 +523,15 @@ export async function cmdEnv(argv, deps = {}) {
         console.log(`synced removal of ${name} to ${repo}`);
         return;
     }
-    fail("usage: hd env ls | set NAME=VALUE [NAME=VALUE...] | rm NAME");
+    fail("usage: hd env ls [--vercel] | set NAME=VALUE [NAME=VALUE...] | rm NAME");
 }
-async function cmdHost(argv) {
+async function cmdHost(argv, deps = {}) {
     const [scope, action, ...args] = argv;
-    const usage = "usage: hd host env ls | set NAME=VALUE [NAME=VALUE...] | rm NAME";
+    if (scope === "roll") {
+        await hostRoll(parseHostRollFlags([action, ...args].filter((value) => Boolean(value))), deps);
+        return;
+    }
+    const usage = "usage: hd host roll [--host HOST] [--address ADDR] [--checkout DIR] | env ls | set NAME=VALUE [NAME=VALUE...] | rm NAME";
     if (scope !== "env")
         fail(usage);
     const host = (await getStatus()).workspace.default_host;
@@ -536,6 +592,10 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
             await cmdEpic(rest);
             return;
         }
+        if (cmd === "roadmap") {
+            await cmdRoadmap(rest);
+            return;
+        }
         if (cmd === "plan") {
             await cmdPlan(rest);
             return;
@@ -573,7 +633,7 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
             return;
         }
         if (cmd === "host") {
-            await cmdHost(rest);
+            await cmdHost(rest, deps);
             return;
         }
         if (cmd === "pause" || cmd === "off") {

package/dist/out.js

@@ -66,12 +66,13 @@ export function usage() {
         `  ${c.blue("hd status")}                         workspace overview`,
         `  ${c.blue("hd ticket list | show KEY [--json] | new [PATH] | queue | cancel")} ticket operations`,
         `  ${c.blue("hd epic new PATH | list | approve | rm")} epic operations`,
+        `  ${c.blue("hd roadmap [--json]")}               ordered workspace roadmap`,
         `  ${c.blue("hd plan")}                           use /architect in the TUI`,
         `  ${c.blue("hd workspace ls | use | new | set | rotate-key | grant-runner-access")} workspace operations`,
         `  ${c.blue("hd agents [add | rm | set]")}         manage agents`,
         `  ${c.blue("hd caps [set PROVIDER N]")}           provider concurrency`,
-        `  ${c.blue("hd env ls | set | rm")}               workspace environment`,
-        `  ${c.blue("hd host env ls | set | rm")}          host environment`,
+        `  ${c.blue("hd env ls [--vercel] | set | rm")}    workspace environment`,
+        `  ${c.blue("hd host roll | env ls | set | rm")}   roll a host or edit host env`,
         `  ${c.blue("hd logs KEY [-f]")}                  run events`,
         `  ${c.blue("hd msg KEY TEXT")}                   message a builder`,
         `  ${c.blue("hd inbox [--all] [--limit N] [--json]")} inbox messages`,

package/dist/roadmap.js

@@ -0,0 +1,23 @@
+export function currentRoadmapEpic(epics) {
+    const statuses = new Map(epics.map((epic) => [epic.id, epic.status]));
+    return [...epics].sort((a, b) => a.position - b.position).find((epic) => !["draft", "done"].includes(epic.status)
+        && epic.depends_on.every((id) => statuses.get(id) === "done")) ?? null;
+}
+export function progressBar(merged, total, width = 10) {
+    const complete = total > 0 ? Math.round((Math.max(0, Math.min(merged, total)) / total) * width) : 0;
+    return `${"█".repeat(complete)}${"░".repeat(Math.max(0, width - complete))}`;
+}
+export function roadmapText(epics) {
+    const names = new Map(epics.map((epic) => [epic.id, epic.title]));
+    const current = currentRoadmapEpic(epics);
+    return [...epics].sort((a, b) => a.position - b.position).flatMap((epic) => {
+        const dependencies = epic.depends_on.map((id) => names.get(id) ?? id);
+        const status = epic.status === "draft" ? "draft, awaiting approval" : epic.status;
+        return [
+            `${epic.id === current?.id ? "▶" : " "} ${epic.position}. ${epic.title} [${status}]`,
+            `  Outcome: ${epic.outcome_md || "Not described"}`,
+            `  Depends on: ${dependencies.length ? dependencies.join(", ") : "none"}`,
+            `  ${progressBar(epic.merged, epic.total)} ${epic.merged}/${epic.total} merged`,
+        ];
+    });
+}

package/dist/tui/App.js

@@ -9,20 +9,23 @@ import { agentAdd } from "../agent-commands.js";
 import { workspaceGrantRunnerAccess, workspaceNew, workspaceRotateKey, workspaceSet } from "../workspace-commands.js";
 import { Banner } from "./Banner.js";
 import { Bubble } from "./Bubble.js";
+import { ChatPanel } from "./Chat.js";
+import { chatAgentLabel, chatScrollOffset, chatViewLines, emptyThread, followShouldStop, leaveChat, mergeHydratedThread, pendingActivity, rehydrateThread, threadKey, } from "./chat-view.js";
 import { Cockpit, StreamPanel, boardTicketIds, nextCursor } from "./Dashboard.js";
 import { DecisionPanel, decisionRows } from "./Decision.js";
 import { COMMANDS, Help } from "./Help.js";
 import { AgentsPanel, BoardPanel, FeedPanel, InboxPanel, TicketPanel, inboxEntries } from "./Panels.js";
 import { sectionAt, ticketScrollOffset, ticketViewLines, toggleSection } from "./ticket-view.js";
 import { SettingsPanel } from "./Settings.js";
+import { RoadmapPanel, roadmapLines } from "./Roadmap.js";
 import { Splash } from "./Splash.js";
 import TextInput from "./TextInput.js";
 import { alertOnce } from "./alert.js";
 import { bubbleRows } from "./height.js";
 import { planLayout, splitPanels } from "./layout.js";
 import { parseLine } from "./parse.js";
-import { configuredSlugs, acknowledgeInbox, approveEpic, cancelTicket, createEpicFromFile, decisionOptions, deleteAgent, deleteEpic, loadLiveEvents, listWorkspaceEnv, loadTicketDetail, pollSnapshot, postAgentMessage, postTicketMessage, queueTicket, resolveDecision, selectDecision, setWorkspacePaused, switchWorkspace, updateAgent, updateProviderCap, updateWorkspace, waitForReply, } from "./data.js";
-import { inputActive, promptPlaceholder, QUEUED_STEP, REPLY_WAIT_MS, settleChatReply } from "./chat-wait.js";
+import { configuredSlugs, acknowledgeInbox, approveEpic, cancelTicket, createEpicFromFile, decisionOptions, deleteAgent, deleteEpic, followChat, loadChatMessages, loadLiveEvents, listWorkspaceEnv, loadTicketDetail, POLL_MS, pollSnapshot, postAgentMessage, postTicketMessage, queueTicket, resolveDecision, selectDecision, setWorkspacePaused, switchWorkspace, updateAgent, updateProviderCap, updateWorkspace, } from "./data.js";
+import { inputActive, NO_REPLY_NOTE, promptPlaceholder, REPLY_WAIT_MS } from "./chat-wait.js";
 import { answeredLine, decisionHeaderIndex, decisionIdAt, moveDecisionFocus, nextUnanswered, resolveDecisionAnswer, } from "./decide-nav.js";
 import { EARLIER_PAGE } from "./inbox.js";
 import { editFor, editableKeys, nextValue, seedFor, settingsRows } from "./settings-model.js";
@@ -46,11 +49,15 @@ export function App({ initial }) {
     const [view, setView] = useState("home");
     const [live, setLive] = useState("connecting");
     const [messages, setMessages] = useState([]);
+    const [threads, setThreads] = useState({});
+    const [chatOffset, setChatOffset] = useState(0);
+    const [now, setNow] = useState(Date.now());
     const [draft, setDraft] = useState("");
     const [busy, setBusy] = useState(false);
     const [notice, setNotice] = useState(null);
     const [ticketKey, setTicketKey] = useState(null);
     const [ticketOffset, setTicketOffset] = useState(0);
+    const [roadmapOffset, setRoadmapOffset] = useState(0);
     const [ticketCollapsed, setTicketCollapsed] = useState([]);
     const [ready, setReady] = useState(false);
     const [stream, setStream] = useState([]);
@@ -97,6 +104,12 @@ export function App({ initial }) {
         if (live.cockpit > 0)
             setStarted(true);
     }, [ready, rows, columns, width, board.decisions]);
+    useEffect(() => {
+        if (view !== "chat")
+            return;
+        const timer = setInterval(() => setNow(Date.now()), 1_000);
+        return () => clearInterval(timer);
+    }, [view]);
     const applySnapshot = useCallback((snapshot) => {
         const token = loads.current.start(snapshot.workspace.id);
         if (!loads.current.isCurrent(token))
@@ -302,27 +315,95 @@ export function App({ initial }) {
             setBusy(false);
         }
     }, [config, say]);
+    const agentName = useCallback((role) => chatAgentLabel(role, board.agents.find((agent) => agent.role === role)?.display_name), [board.agents]);
+    const setThread = useCallback((key, update) => {
+        setThreads((prior) => {
+            const current = prior[key] ?? emptyThread(key.split(":")[1], key.split(":")[0] ?? workspace.id);
+            return { ...prior, [key]: update(current) };
+        });
+    }, [workspace.id]);
+    const hydrateChat = useCallback(async (role) => {
+        const key = threadKey(workspace.id, role);
+        try {
+            const remote = rehydrateThread(await loadChatMessages(config, role), role, workspace.id);
+            setThreads((prior) => ({
+                ...prior,
+                [key]: mergeHydratedThread(prior[key] ?? null, remote),
+            }));
+        }
+        catch (error) {
+            setNotice(error instanceof Error ? error.message : String(error));
+        }
+    }, [config, workspace.id]);
+    const openAgentChat = useCallback((role) => {
+        setMode(role);
+        setView("chat");
+        setCursor(null);
+        selectedRef.current = null;
+        setChatOffset(10_000);
+        void hydrateChat(role);
+    }, [hydrateChat]);
     const askAgent = useCallback((role, text) => {
-        const id = nextId();
-        setMessages((prior) => [...prior, { id, speaker: role, body: "", pending: true }]);
+        const key = threadKey(workspace.id, role);
         const since = new Date().toISOString();
+        const youTurn = { id: nextId(), speaker: "you", body: text, at: since };
+        setMode(role);
+        setView("chat");
+        setChatOffset(10_000);
+        setThread(key, (current) => ({
+            ...current,
+            role,
+            workspaceId: workspace.id,
+            turns: [...current.turns, youTurn],
+            pending: { messageId: null, runId: null, startedAt: since, status: "queued", activity: [] },
+        }));
         void (async () => {
             try {
-                await postAgentMessage(role, text, config);
-                setMessages((prior) => prior.map((message) => message.id === id
-                    ? { ...message, steps: [QUEUED_STEP] }
-                    : message));
-                const reply = await waitForReply(config, role, since, REPLY_WAIT_MS);
-                setMessages((prior) => prior.map((message) => message.id === id
-                    ? { ...message, ...settleChatReply(reply) }
-                    : message));
+                const posted = await postAgentMessage(role, text, config);
+                const deadline = Date.now() + REPLY_WAIT_MS;
+                while (Date.now() <= deadline) {
+                    const follow = await followChat(config, role, posted.id, since);
+                    const activity = pendingActivity(follow.events, follow.run, agentName(role));
+                    setThread(key, (current) => ({
+                        ...current,
+                        pending: {
+                            messageId: posted.id,
+                            runId: follow.run?.id ?? null,
+                            startedAt: follow.run?.started_at ?? current.pending?.startedAt ?? since,
+                            status: follow.run?.status ?? "queued",
+                            activity: activity.lines,
+                        },
+                    }));
+                    if (followShouldStop(follow.run, follow.reply)) {
+                        const body = follow.reply ?? follow.run?.summary ?? NO_REPLY_NOTE;
+                        setThread(key, (current) => ({
+                            ...current,
+                            turns: [...current.turns, { id: `reply-${posted.id}`, speaker: role, body, at: new Date().toISOString() }],
+                            pending: null,
+                        }));
+                        setChatOffset(10_000);
+                        return;
+                    }
+                    await new Promise((resolve) => setTimeout(resolve, POLL_MS));
+                }
+                setThread(key, (current) => ({
+                    ...current,
+                    turns: [...current.turns, {
+                            id: `timeout-${posted.id}`, speaker: role, body: NO_REPLY_NOTE, at: new Date().toISOString(),
+                        }],
+                    pending: null,
+                }));
             }
             catch (error) {
                 const body = error instanceof Error ? error.message : String(error);
-                setMessages((prior) => prior.map((message) => message.id === id ? { ...message, body, pending: false, done: true } : message));
+                setThread(key, (current) => ({
+                    ...current,
+                    turns: [...current.turns, { id: nextId(), speaker: role, body, at: new Date().toISOString() }],
+                    pending: null,
+                }));
             }
         })();
-    }, [config]);
+    }, [agentName, config, setThread, workspace.id]);
     const openTicket = useCallback(async (key) => {
         setTicketKey(key);
         setView("ticket");
@@ -415,7 +496,6 @@ export function App({ initial }) {
         setNotice(null);
         const action = parseLine(text);
         if (action.kind === "say") {
-            say("you", text);
             if (mode !== "browse")
                 askAgent(mode, text);
             else
@@ -424,15 +504,12 @@ export function App({ initial }) {
         }
         switch (action.kind) {
             case "mode":
-                setMode(action.mode);
-                setCursor(null);
-                selectedRef.current = null;
-                say("system", action.mode === "architect"
-                    ? "Talking to the architect. Ask questions, refine the epic, then explicitly request a draft."
-                    : "Talking to the orchestrator. It moves work already in flight.");
+                openAgentChat(action.mode);
                 return;
             case "view":
                 setView(action.view);
+                if (action.view === "roadmap")
+                    setRoadmapOffset(0);
                 if (action.view === "inbox") {
                     const header = selectedDecisionId ? decisionHeaderIndex(inbox, selectedDecisionId) : 0;
                     setInboxFocus(header >= 0 ? header : 0);
@@ -736,9 +813,9 @@ export function App({ initial }) {
             default:
                 return;
         }
-    }, [view, settings, applyEdit, board, browsing, mode, say, askAgent, order, settingsOrder, changeWorkspace,
-        config, refresh, suspendTerminal, exit, inbox, inboxFocus, openTicket, answering, selectedDecisionId,
-        submitDecision, ticketKey, ticketCollapsed, ticketOffset, width]);
+    }, [view, settings, applyEdit, board, browsing, mode, say, askAgent, openAgentChat, order, settingsOrder,
+        changeWorkspace, config, refresh, suspendTerminal, exit, inbox, inboxFocus, openTicket, answering,
+        selectedDecisionId, submitDecision, ticketKey, ticketCollapsed, ticketOffset, width]);
     useInput((input, key) => {
         if (key.ctrl && input === "c")
             exit();
@@ -758,14 +835,21 @@ export function App({ initial }) {
     const settled = messages.filter((message) => message.done);
     const inFlight = messages.filter((message) => !message.done);
     const splash = !started;
+    const chatRole = view === "chat" && mode !== "browse" ? mode : null;
+    const activeThread = chatRole
+        ? threads[threadKey(workspace.id, chatRole)] ?? emptyThread(chatRole, workspace.id)
+        : null;
+    const chatLabel = chatRole ? agentName(chatRole) : "";
+    const chatLines = activeThread ? chatViewLines(activeThread, Math.max(20, width), chatLabel, now) : [];
     const scrollback = splash ? [] : [
         { key: "banner" },
         { key: "help", message: { id: "help", speaker: "system", body: "", panel: "help" } },
         ...settled.map((message) => ({ key: message.id, message })),
     ];
+    const chatting = view === "chat";
     const plan = planLayout({
-        rows, columns, width, splash, ready, decision: decisionRows(decisions),
-        inFlight: inFlight.reduce((total, message) => total + bubbleRows(message, width), 0),
+        rows, columns, width, splash, ready, decision: chatting ? 0 : decisionRows(decisions),
+        inFlight: chatting ? 0 : inFlight.reduce((total, message) => total + bubbleRows(message, width), 0),
         notice: Boolean(notice), home: view === "home",
     });
     const agentsView = splitPanels(plan.panels);
@@ -777,15 +861,15 @@ export function App({ initial }) {
                     if (item.message.panel === "help")
                         return _jsx(Help, { width: width }, item.key);
                     return _jsx(Bubble, { message: item.message, width: width }, item.key);
-                } }), splash ? (_jsx(Splash, { columns: columns, rows: rows, width: width, ready: ready, helpFull: plan.helpFull, animate: plan.fits, onDone: () => setReady(true) })) : null, _jsxs(Box, { flexDirection: "column", width: width, children: [view === "board" && plan.panels > 0 ? _jsx(BoardPanel, { board: board, width: width, rows: plan.panels, cursor: cursor }) : null, view === "agents" && plan.panels > 0 ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(AgentsPanel, { board: board, width: width, rows: agentsView.top }), agentsView.bottom > 0 ? _jsxs(_Fragment, { children: [_jsx(Box, { height: 1 }), _jsx(StreamPanel, { lines: stream, width: width, rows: agentsView.bottom, live: running > 0 })] }) : null] })) : null, view === "feed" && plan.panels > 0 ? _jsx(FeedPanel, { entries: feed, width: width, rows: plan.panels }) : null, view === "settings" && plan.panels > 0 ? _jsx(SettingsPanel, { entries: settings, width: width, rows: plan.panels, title: "Settings", cursor: field, editing: editing }) : null, view === "inbox" && plan.panels > 0 ? _jsx(InboxPanel, { board: board, width: width, rows: plan.panels, focus: inboxFocus, selectedId: selectedDecisionId, answeringId: answering }) : null, view === "ticket" && plan.panels > 0 ? ticket
+                } }), splash ? (_jsx(Splash, { columns: columns, rows: rows, width: width, ready: ready, helpFull: plan.helpFull, animate: plan.fits, onDone: () => setReady(true) })) : null, _jsxs(Box, { flexDirection: "column", width: width, children: [view === "board" && plan.panels > 0 ? _jsx(BoardPanel, { board: board, width: width, rows: plan.panels, cursor: cursor }) : null, view === "roadmap" && plan.panels > 0 ? (_jsx(RoadmapPanel, { board: board, width: width, rows: plan.panels, offset: roadmapOffset })) : null, view === "agents" && plan.panels > 0 ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(AgentsPanel, { board: board, width: width, rows: agentsView.top }), agentsView.bottom > 0 ? _jsxs(_Fragment, { children: [_jsx(Box, { height: 1 }), _jsx(StreamPanel, { lines: stream, width: width, rows: agentsView.bottom, live: running > 0 })] }) : null] })) : null, view === "feed" && plan.panels > 0 ? _jsx(FeedPanel, { entries: feed, width: width, rows: plan.panels }) : null, view === "settings" && plan.panels > 0 ? _jsx(SettingsPanel, { entries: settings, width: width, rows: plan.panels, title: "Settings", cursor: field, editing: editing }) : null, view === "inbox" && plan.panels > 0 ? _jsx(InboxPanel, { board: board, width: width, rows: plan.panels, focus: inboxFocus, selectedId: selectedDecisionId, answeringId: answering }) : null, view === "ticket" && plan.panels > 0 ? ticket
                         ? _jsx(TicketPanel, { ticket: ticket, width: width, rows: plan.panels, offset: ticketOffset, collapsed: ticketCollapsed })
-                        : _jsxs(Text, { color: UI.warn, children: ["No ticket ", ticketKey, " here."] }) : null, view === "home" && plan.cockpit > 0 ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Cockpit, { board: board, width: width, rows: plan.cockpit, cursor: cursor }), _jsx(Box, { height: 1 }), _jsx(StreamPanel, { lines: stream, width: width, rows: plan.stream, live: running > 0 })] })) : null, inFlight.map((message) => _jsx(Bubble, { message: message, width: width }, message.id)), _jsx(DecisionPanel, { decisions: decisions, board: board, width: width, rows: plan.decision, selectedId: selectedDecisionId }), notice ? _jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: UI.warn, children: notice }) }) : null, _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: UI.text, bold: true, children: workspace.slug }), _jsxs(Text, { color: UI.dim, children: [" ", workspace.repo, " "] }), _jsx(Text, { color: live === "live" ? UI.accent : UI.dim, children: "\u25CF " }), _jsxs(Text, { color: UI.dim, children: [live === "live" ? "5s poll" : live, " "] }), _jsx(Text, { color: UI.dim, children: running ? `${running} running ` : "" }), board.decisions.length ? _jsxs(Text, { color: UI.warn, children: [board.decisions.length, " decisions "] }) : null, workspace.paused ? _jsx(Text, { color: UI.warn, children: "paused " }) : null, logsFilter || rawLogs ? _jsxs(Text, { color: UI.warn, children: ["logs ", rawLogs ? "raw " : "", logsFilter ?? "all", " "] }) : null, _jsxs(Text, { color: UI.dim, wrap: "truncate", children: ["\u00B7 ", mode, answering ? " esc cancels" : view === "ticket" ? " ↑↓ scroll · pgup/pgdn · enter folds" : view === "inbox" ? " ↑↓ decisions · enter answers" : cursor && selected ? ` ${selected.key} ↑↓ move · enter opens · esc leaves` : ""] })] }), _jsx(Box, { children: _jsx(TextInput, { value: draft, onChange: (next) => {
+                        : _jsxs(Text, { color: UI.warn, children: ["No ticket ", ticketKey, " here."] }) : null, view === "home" && plan.cockpit > 0 ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Cockpit, { board: board, width: width, rows: plan.cockpit, cursor: cursor }), _jsx(Box, { height: 1 }), _jsx(StreamPanel, { lines: stream, width: width, rows: plan.stream, live: running > 0 })] })) : null, chatting && plan.panels > 0 && activeThread ? (_jsx(ChatPanel, { thread: activeThread, width: width, rows: plan.panels, offset: chatOffset, label: chatLabel, now: now })) : null, chatting ? null : _jsx(DecisionPanel, { decisions: decisions, board: board, width: width, rows: plan.decision, selectedId: selectedDecisionId }), notice ? _jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: UI.warn, children: notice }) }) : null, _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: UI.text, bold: true, children: workspace.slug }), _jsxs(Text, { color: UI.dim, children: [" ", workspace.repo, " "] }), _jsx(Text, { color: live === "live" ? UI.accent : UI.dim, children: "\u25CF " }), _jsxs(Text, { color: UI.dim, children: [live === "live" ? "5s poll" : live, " "] }), _jsx(Text, { color: UI.dim, children: running ? `${running} running ` : "" }), board.decisions.length ? _jsxs(Text, { color: UI.warn, children: [board.decisions.length, " decisions "] }) : null, workspace.paused ? _jsx(Text, { color: UI.warn, children: "paused " }) : null, logsFilter || rawLogs ? _jsxs(Text, { color: UI.warn, children: ["logs ", rawLogs ? "raw " : "", logsFilter ?? "all", " "] }) : null, _jsxs(Text, { color: UI.dim, wrap: "truncate", children: ["\u00B7 ", chatting ? chatLabel : mode, answering ? " esc cancels" : chatting ? " ↑↓ scroll · pgup/pgdn · esc hides" : view === "ticket" ? " ↑↓ scroll · pgup/pgdn · enter folds" : view === "roadmap" ? " ↑↓ scroll · pgup/pgdn" : view === "inbox" ? " ↑↓ decisions · enter answers" : cursor && selected ? ` ${selected.key} ↑↓ move · enter opens · esc leaves` : ""] })] }), _jsx(Box, { children: _jsx(TextInput, { value: draft, onChange: (next) => {
                                 setDraft(next);
                                 if (editingRef.current)
                                     setEditing({ key: editingRef.current.key, draft: next });
                             }, onSubmit: (value) => void run(value), isActive: inputActive({ busy, pendingChats: inFlight.length }), placeholder: answering
                                 ? (answeringOptions.length ? `1-${answeringOptions.length} or your answer` : "your answer")
-                                : promptPlaceholder({ busy, pendingChats: inFlight.length }), prompt: _jsx(Text, { color: answering || mode !== "browse" ? UI.cream : UI.dim, children: answering ? `answer ${answeringNumber}> ` : mode === "browse" ? "> " : `${mode}> ` }), color: UI.text, onCancel: () => {
+                                : promptPlaceholder({ busy, pendingChats: inFlight.length }), prompt: _jsx(Text, { color: answering || chatting || mode !== "browse" ? UI.cream : UI.dim, children: answering ? `answer ${answeringNumber}> ` : chatting ? `${chatLabel}> ` : mode === "browse" ? "> " : `${mode}> ` }), color: UI.text, onCancel: () => {
                                 if (answering) {
                                     setAnswering(null);
                                     setDraft("");
@@ -798,6 +882,14 @@ export function App({ initial }) {
                                     setNotice(null);
                                     return;
                                 }
+                                if (chatting || mode !== "browse") {
+                                    const left = leaveChat();
+                                    setMode(left.mode);
+                                    setView(left.view);
+                                    setDraft("");
+                                    setNotice(left.notice);
+                                    return;
+                                }
                                 if (view !== "home") {
                                     setView("home");
                                     setTicketKey(null);
@@ -806,6 +898,16 @@ export function App({ initial }) {
                                 setCursor(null);
                                 selectedRef.current = null;
                             }, onUp: () => {
+                                if (chatting && !draft) {
+                                    const overflow = chatLines.length > plan.panels;
+                                    const inner = overflow ? Math.max(0, plan.panels - 1) : Math.max(1, plan.panels);
+                                    setChatOffset((current) => chatScrollOffset(chatLines.length, inner, current - 1));
+                                    return;
+                                }
+                                if (view === "roadmap" && !draft) {
+                                    setRoadmapOffset((current) => Math.max(0, current - 1));
+                                    return;
+                                }
                                 if (view === "ticket" && !draft) {
                                     const count = ticket ? ticketViewLines(ticket, Math.max(20, width), ticketCollapsed).length : 0;
                                     setTicketOffset((current) => ticketScrollOffset(count, Math.max(1, plan.panels), current - 1));
@@ -824,6 +926,17 @@ export function App({ initial }) {
                                 historyAt.current = historyAt.current < 0 ? history.current.length - 1 : Math.max(0, historyAt.current - 1);
                                 setDraft(history.current[historyAt.current] ?? "");
                             }, onDown: () => {
+                                if (chatting && !draft) {
+                                    const overflow = chatLines.length > plan.panels;
+                                    const inner = overflow ? Math.max(0, plan.panels - 1) : Math.max(1, plan.panels);
+                                    setChatOffset((current) => chatScrollOffset(chatLines.length, inner, current + 1));
+                                    return;
+                                }
+                                if (view === "roadmap" && !draft) {
+                                    const max = Math.max(0, roadmapLines(board, width).length - Math.max(1, plan.panels - 1));
+                                    setRoadmapOffset((current) => Math.min(max, current + 1));
+                                    return;
+                                }
                                 if (view === "ticket" && !draft) {
                                     const count = ticket ? ticketViewLines(ticket, Math.max(20, width), ticketCollapsed).length : 0;
                                     setTicketOffset((current) => ticketScrollOffset(count, Math.max(1, plan.panels), current + 1));
@@ -847,11 +960,33 @@ export function App({ initial }) {
                                 }
                                 setDraft(history.current[historyAt.current] ?? "");
                             }, onPageUp: () => {
+                                if (chatting && !draft) {
+                                    const overflow = chatLines.length > plan.panels;
+                                    const inner = overflow ? Math.max(0, plan.panels - 1) : Math.max(1, plan.panels);
+                                    setChatOffset((current) => chatScrollOffset(chatLines.length, inner, current - Math.max(1, inner)));
+                                    return;
+                                }
+                                if (view === "roadmap" && !draft) {
+                                    setRoadmapOffset((current) => Math.max(0, current - Math.max(1, plan.panels - 1)));
+                                    return;
+                                }
                                 if (view === "ticket" && !draft) {
                                     const count = ticket ? ticketViewLines(ticket, Math.max(20, width), ticketCollapsed).length : 0;
                                     setTicketOffset((current) => ticketScrollOffset(count, Math.max(1, plan.panels), current - Math.max(1, plan.panels)));
                                 }
                             }, onPageDown: () => {
+                                if (chatting && !draft) {
+                                    const overflow = chatLines.length > plan.panels;
+                                    const inner = overflow ? Math.max(0, plan.panels - 1) : Math.max(1, plan.panels);
+                                    setChatOffset((current) => chatScrollOffset(chatLines.length, inner, current + Math.max(1, inner)));
+                                    return;
+                                }
+                                if (view === "roadmap" && !draft) {
+                                    const page = Math.max(1, plan.panels - 1);
+                                    const max = Math.max(0, roadmapLines(board, width).length - page);
+                                    setRoadmapOffset((current) => Math.min(max, current + page));
+                                    return;
+                                }
                                 if (view === "ticket" && !draft) {
                                     const count = ticket ? ticketViewLines(ticket, Math.max(20, width), ticketCollapsed).length : 0;
                                     setTicketOffset((current) => ticketScrollOffset(count, Math.max(1, plan.panels), current + Math.max(1, plan.panels)));

package/dist/tui/Chat.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { BoundedPanel as Panel } from "./bounded.js";
+import { chatScrollOffset, chatViewLines, } from "./chat-view.js";
+import { UI } from "./theme.js";
+export function ChatPanel({ thread, width = 80, rows = 24, offset = 0, label, now = Date.now(), }) {
+    const entries = chatViewLines(thread, Math.max(20, width), label, now);
+    const drawable = Math.max(0, rows);
+    const overflow = entries.length > drawable;
+    const inner = overflow ? Math.max(0, drawable - 1) : drawable;
+    const start = chatScrollOffset(entries.length, inner, offset);
+    const shown = entries.slice(start, start + inner);
+    const hiddenAbove = start;
+    const hiddenBelow = Math.max(0, entries.length - start - shown.length);
+    return (_jsx(Panel, { width: width, rows: drawable, children: [
+            ...(shown.length === 0
+                ? [
+                    _jsx(Text, { color: UI.dim, children: `No messages yet. Say something to ${label}.` }, "empty"),
+                ]
+                : shown.map((entry) => (_jsx(Text, { color: entry.kind === "status" ? UI.accent : entry.kind === "activity" ? UI.dim
+                        : entry.kind === "speaker" ? UI.warn : UI.text, wrap: "truncate", children: entry.text }, entry.key)))),
+            overflow ? (_jsxs(Text, { color: UI.dim, wrap: "truncate", children: [hiddenAbove ? `${hiddenAbove}↑ ` : "", hiddenBelow ? `${hiddenBelow}↓` : ""] }, "more")) : null,
+        ] }));
+}
+/** Thread stacked above a prompt, for layout tests. */
+export function ChatFrame({ thread, width = 80, rows = 12, offset = 0, label, prompt, now = Date.now(), }) {
+    return (_jsxs(Box, { flexDirection: "column", width: width, children: [_jsx(ChatPanel, { thread: thread, width: width, rows: rows, offset: offset, label: label, now: now }), _jsx(Text, { children: prompt })] }));
+}

package/dist/tui/Dashboard.js

@@ -6,6 +6,7 @@ import { inkColor } from "../out/theme.js";
 import { UI } from "./theme.js";
 import { BoundedPanel as Panel, Heading, More, contentRows } from "./bounded.js";
 import { agentDisplayRows } from "./agent-rows.js";
+import { currentRoadmapEpic } from "../roadmap.js";
 const DOT = "●";
 /**
  * The width at which the board and the agents stop competing for the same
@@ -117,10 +118,11 @@ export function AgentsColumn({ board, width, rows, }) {
                 ]
                 : []),
             ...shown.map((row) => {
-                const tone = row.run ? "blue" : row.state === "offline" || row.state === "limited" ? "warning" : "muted";
-                return (_jsxs(Box, { flexWrap: "nowrap", children: [_jsxs(Text, { color: inkColor(tone), children: [DOT, " "] }), _jsxs(Text, { color: UI.text, wrap: "truncate", children: [row.name, _jsx(Text, { color: UI.dim, children: row.run
+                const tone = row.run ? "blue" : row.state === "offline" || row.state === "limited" || row.state === "draining"
+                    ? "warning" : "muted";
+                return (_jsxs(Box, { flexWrap: "nowrap", children: [_jsxs(Text, { color: inkColor(tone), children: [DOT, " "] }), _jsxs(Text, { color: UI.text, wrap: "truncate", children: [row.name, row.state === "draining" ? null : (_jsx(Text, { color: UI.dim, children: row.run
                                         ? ` · ${row.ticket?.key ?? row.run.kind} ${elapsed(row.run.started_at ?? row.run.created_at)}`
-                                        : ` · ${row.limitedUntil ? `limited until ${row.limitedUntil}` : row.state}` })] })] }, row.key));
+                                        : ` · ${row.limitedUntil ? `limited until ${row.limitedUntil}` : row.state}` }))] })] }, row.key));
             }),
             _jsx(More, { count: displayRows.length - shown.length }, "more"),
         ] }));
@@ -156,8 +158,12 @@ export function epicsRows(board, cap = 3) {
     return open.length === 0 ? 0 : Math.min(open.length, cap) + 1;
 }
 export function nowEntries(board) {
-    return board.tickets.filter((ticket) => !["backlog", "merged", "cancelled"].includes(ticket.status))
-        .map((ticket) => ({ key: ticket.key, headline: ticket.latest_headline ?? `${ticket.key}: ${ticket.title}` }));
+    const current = currentRoadmapEpic(board.epics ?? []);
+    return [
+        ...(current ? [{ key: `epic:${current.id}`, headline: `Current epic: ${current.title}` }] : []),
+        ...board.tickets.filter((ticket) => !["backlog", "merged", "cancelled"].includes(ticket.status))
+            .map((ticket) => ({ key: ticket.key, headline: ticket.latest_headline ?? `${ticket.key}: ${ticket.title}` })),
+    ];
 }
 function NowStrip({ board, width, rows }) {
     const entries = nowEntries(board);

package/dist/tui/Help.js

@@ -6,6 +6,7 @@ export const HELP_FOOTER = "Anything not starting with / goes to whoever you are
 /** Everything you can type. The app is driven from here, not from flags. */
 export const COMMANDS = [
     { name: "/board", help: "the kanban board" },
+    { name: "/roadmap", help: "the vision and ordered epic progress" },
     { name: "/inbox", args: "[more]", help: "unread, earlier, and numbered decisions; Enter answers" },
     { name: "/ticket", args: "HD-12 | new [PATH.md]", help: "open a full ticket view or create one" },
     { name: "/queue", args: "HD-12", help: "queue a complete ticket now" },
@@ -14,7 +15,7 @@ export const COMMANDS = [
     { name: "/logs", args: "[raw] [HD-12]", help: "filter activity; raw reveals event JSON" },
     { name: "/epic", args: "new PATH | approve ID | rm ID", help: "create, approve, or remove a draft epic" },
     { name: "/epics", help: "list epics and ticket progress" },
-    { name: "/architect", help: "talk to the agent that shapes draft epics" },
+    { name: "/architect", help: "open a chat with the architect" },
     { name: "/plan", help: "alias for /architect" },
     { name: "/decide", args: "[N|ID] [answer]", help: "answer the selected or numbered decision" },
     { name: "/agents", args: "[add [ROLE] [flags] | rm ROLE|ID]", help: "view or manage named agents" },
@@ -24,7 +25,7 @@ export const COMMANDS = [
     { name: "/on", help: "turn on the current workspace" },
     { name: "/off", help: "turn off the current workspace" },
     { name: "/feed", help: "what just happened" },
-    { name: "/orchestrator", help: "talk to the agent that gets work in flight finished" },
+    { name: "/orchestrator", help: "open a chat with the orchestrator" },
     { name: "/refresh", help: "reload the board now" },
     { name: "/help", help: "this list" },
     { name: "/exit", help: "leave" },

package/dist/tui/Panels.js

@@ -28,8 +28,10 @@ export function AgentsPanel({ board, width = 80, rows = 12, }) {
                 ]
                 : []),
             ...shown.map((row) => {
-                const tone = row.run ? "blue" : row.state === "offline" || row.state === "limited" ? "warning" : "muted";
-                const state = row.limitedUntil ? `limited until ${row.limitedUntil}` : row.state;
+                const tone = row.run ? "blue" : row.state === "offline" || row.state === "limited" || row.state === "draining"
+                    ? "warning" : "muted";
+                const state = row.state === "draining" ? ""
+                    : row.limitedUntil ? `limited until ${row.limitedUntil}` : row.state;
                 return (_jsxs(Text, { wrap: "truncate", children: [_jsxs(Text, { color: inkColor(tone), children: [DOT, " "] }), _jsx(Text, { color: UI.text, children: pad(truncate(row.name, 13), 14) }), _jsx(Text, { color: UI.dim, children: pad(row.agent?.role ?? row.run?.kind ?? "", 13) }), _jsx(Text, { color: UI.dim, children: pad(truncate(row.agent?.model ?? "", 23), 24) }), _jsx(Text, { color: UI.text, children: pad(state, row.limitedUntil ? 22 : 9) }), _jsxs(Text, { color: UI.dim, children: [row.ticket ? `${row.ticket.key} ` : "", row.run ? elapsed(row.run.started_at ?? row.run.created_at) : ""] })] }, row.key));
             }),
             _jsx(More, { count: displayRows.length - shown.length }, "more"),

package/dist/tui/Roadmap.js

@@ -0,0 +1,38 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Text } from "ink";
+import { roadmapText } from "../roadmap.js";
+import { inkColor } from "../out/theme.js";
+import { epicProgress } from "./data.js";
+import { BoundedPanel as Panel, Heading } from "./bounded.js";
+import { wrapLines } from "./ticket-view.js";
+import { UI } from "./theme.js";
+export function roadmapLines(board, width) {
+    if (!board.roadmap)
+        return ["No roadmap yet. Talk to /architect to create one."];
+    const lines = ["Vision"];
+    lines.push(...wrapLines(board.roadmap.vision_md, Math.max(12, width - 2)));
+    lines.push("");
+    const progress = new Map(epicProgress(board).map((row) => [row.epic.id, row]));
+    lines.push(...roadmapText(board.epics.map((epic) => ({ ...epic,
+        merged: progress.get(epic.id)?.merged ?? 0,
+        total: progress.get(epic.id)?.total ?? 0,
+    }))));
+    return lines;
+}
+export function RoadmapPanel({ board, width = 80, rows = 12, offset = 0 }) {
+    const lines = roadmapLines(board, width);
+    const budget = Math.max(0, rows - 1);
+    const start = Math.max(0, Math.min(offset, Math.max(0, lines.length - budget)));
+    const shown = lines.slice(start, start + budget);
+    const note = `${board.epics.length} epics${start ? ` · ${start}↑` : ""}`
+        + `${start + budget < lines.length ? ` · ${lines.length - start - budget}↓` : ""}`;
+    return _jsx(Panel, { width: width, rows: rows, children: [
+            _jsx(Heading, { text: "Roadmap", note: note }, "h"),
+            ...shown.map((line, index) => {
+                const current = line.startsWith("▶");
+                const draft = line.includes("draft, awaiting approval");
+                return _jsx(Text, { color: current ? UI.accent
+                        : draft ? inkColor("warning") : line === "Vision" ? UI.text : UI.dim, bold: current || line === "Vision", inverse: current, wrap: "truncate", children: line || " " }, `${start + index}:${line}`);
+            }),
+        ] });
+}

package/dist/tui/agent-rows.js

@@ -1,3 +1,4 @@
+import { formatDrainStatus } from "../host.js";
 const LIMITED_UNTIL = /^(?:Waiting on )?(\w+) (?:limited )?until (\d{1,2}:\d{2})\.?$/;
 export function limitedUntilByProvider(tickets) {
     const limited = new Map();
@@ -22,7 +23,18 @@ function agentForRun(board, run) {
     return board.agents.find((agent) => agent.enabled && agent.role === role && agent.provider === run.provider) ?? null;
 }
 /** Expand live invocations into rows, then append enabled agents with no live run. */
-export function agentDisplayRows(board) {
+export function agentDisplayRows(board, now = Date.now()) {
+    const drain = board.hostDrain
+        ? [{
+                key: "drain",
+                name: formatDrainStatus(board.hostDrain.live, board.hostDrain.until, now),
+                agent: null,
+                run: null,
+                ticket: null,
+                state: "draining",
+                limitedUntil: null,
+            }]
+        : [];
     const activeAgents = new Set();
     const live = board.runs
         .filter((run) => run.status === "running" || run.status === "queued")
@@ -71,5 +83,5 @@ export function agentDisplayRows(board) {
             limitedUntil: until ?? null,
         };
     });
-    return [...live, ...idle];
+    return [...drain, ...live, ...idle];
 }

package/dist/tui/chat-view.js

@@ -0,0 +1,125 @@
+import { narrateEvents } from "./narrate.js";
+import { wrapLines } from "./ticket-view.js";
+/** Last 50 exchanges (a human turn and an agent turn) when rehydrating. */
+export const CHAT_EXCHANGE_LIMIT = 50;
+export const CHAT_MESSAGE_LIMIT = CHAT_EXCHANGE_LIMIT * 2;
+const HUMAN_ROLES = new Set(["human", "operator"]);
+const HUMAN_TARGETS = new Set(["human", "operator", "all"]);
+export function threadKey(workspaceId, role) {
+    return `${workspaceId}:${role}`;
+}
+export function emptyThread(role, workspaceId) {
+    return { role, workspaceId, turns: [], pending: null };
+}
+export function chatAgentLabel(role, displayName) {
+    const named = displayName?.trim();
+    if (named)
+        return named;
+    return role === "architect" ? "Architect" : "Orchestrator";
+}
+export function formatWorkingElapsed(ms) {
+    const seconds = Math.max(0, Math.floor(ms / 1000));
+    if (seconds < 60)
+        return `${seconds}s`;
+    return `${Math.floor(seconds / 60)}m ${seconds % 60}s`;
+}
+export function workingStatus(label, startedAt, now = Date.now()) {
+    const start = startedAt ? Date.parse(startedAt) : Number.NaN;
+    const elapsed = Number.isFinite(start) ? Math.max(0, now - start) : 0;
+    return `${label} is working (${formatWorkingElapsed(elapsed)})`;
+}
+export function isChatConversation(message, role) {
+    if (message.ticket_id)
+        return false;
+    const fromAgent = message.from_role === role && HUMAN_TARGETS.has(message.to_role);
+    const toAgent = HUMAN_ROLES.has(message.from_role) && message.to_role === role;
+    return fromAgent || toAgent;
+}
+export function rehydrateThread(messages, role, workspaceId) {
+    const conversation = messages
+        .filter((message) => isChatConversation(message, role))
+        .sort((left, right) => left.created_at.localeCompare(right.created_at) || left.id.localeCompare(right.id))
+        .slice(-CHAT_MESSAGE_LIMIT);
+    return {
+        role,
+        workspaceId,
+        turns: conversation.map((message) => ({
+            id: message.id,
+            speaker: message.from_role === role ? role : "you",
+            body: message.body_md,
+            at: message.created_at,
+        })),
+        pending: null,
+    };
+}
+export function restoreThread(threads, workspaceId, role) {
+    return threads[threadKey(workspaceId, role)] ?? null;
+}
+export function leaveChat() {
+    return { view: "home", mode: "browse", notice: "Back to browse." };
+}
+export function openChat(role) {
+    return { view: "chat", mode: role };
+}
+export function chatScrollOffset(count, rows, offset) {
+    if (count <= rows)
+        return 0;
+    return Math.max(0, Math.min(offset, count - rows));
+}
+export function chatWindow(count, rows, offset) {
+    const start = chatScrollOffset(count, rows, offset);
+    return { start, end: Math.min(count, start + Math.max(0, rows)) };
+}
+export function pendingActivity(events, run, label, now = Date.now()) {
+    const live = !run || ["queued", "running", ""].includes(run.status ?? "running");
+    return {
+        status: live ? workingStatus(label, run?.started_at ?? null, now) : "",
+        lines: narrateEvents(events).map((line) => line.title),
+    };
+}
+export function followShouldStop(run, reply) {
+    if (reply)
+        return true;
+    if (run && !["queued", "running"].includes(run.status))
+        return true;
+    return false;
+}
+export function chatViewLines(thread, width, label, now = Date.now()) {
+    const lines = [];
+    const bodyWidth = Math.max(8, width);
+    for (const turn of thread.turns) {
+        const speaker = turn.speaker === "you" ? "you" : label;
+        lines.push({ key: `${turn.id}:who`, kind: "speaker", text: speaker });
+        const body = turn.body.trim() || (turn.pending ? "" : "");
+        if (body) {
+            wrapLines(body, bodyWidth).forEach((text, index) => {
+                lines.push({ key: `${turn.id}:body:${index}`, kind: "body", text });
+            });
+        }
+    }
+    if (thread.pending) {
+        const live = pendingActivity([], { started_at: thread.pending.startedAt, status: thread.pending.status }, label, now);
+        const status = thread.pending.status && !["queued", "running", ""].includes(thread.pending.status)
+            ? ""
+            : live.status;
+        if (status)
+            lines.push({ key: "pending:status", kind: "status", text: status });
+        for (const [index, title] of thread.pending.activity.entries()) {
+            wrapLines(title, bodyWidth).forEach((text, line) => {
+                lines.push({ key: `pending:activity:${index}:${line}`, kind: "activity", text });
+            });
+        }
+    }
+    return lines;
+}
+export function mergeHydratedThread(local, remote) {
+    if (!local)
+        return remote;
+    const known = new Set(remote.turns.map((turn) => turn.id));
+    const extras = local.turns.filter((turn) => !known.has(turn.id));
+    return {
+        ...remote,
+        turns: [...remote.turns, ...extras],
+        pending: local.pending,
+    };
+}

package/dist/tui/data.js

@@ -1,4 +1,4 @@
-import { approveEpic as approveEpicNow, answerDecision, cancelTicket as cancelTicketNow, createAgent as postAgent, createEpic as postEpic, deleteEpic as removeEpic, getStatus, getWorkspace, listAgents, listEpics, listFeed, listMessages, markMessagesDelivered, listWorkspaceEnv as getWorkspaceEnv, listTicketRunEvents, listTickets, listWorkspaces, postMessage as sendMessage, queueTicket as queueTicketNow, setPaused as setPausedNow, showTicket, updateAgent as patchAgent, updateCaps, updateWorkspace as patchWorkspace, deleteAgent as removeAgent, } from "../api.js";
+import { approveEpic as approveEpicNow, answerDecision, cancelTicket as cancelTicketNow, createAgent as postAgent, createEpic as postEpic, deleteEpic as removeEpic, getStatus, getRoadmap, getRun, getWorkspace, listAgents, listFeed, listMessages, markMessagesDelivered, listWorkspaceEnv as getWorkspaceEnv, listTicketRunEvents, listTickets, listWorkspaces, postMessage as sendMessage, queueTicket as queueTicketNow, setPaused as setPausedNow, showTicket, updateAgent as patchAgent, updateCaps, updateWorkspace as patchWorkspace, deleteAgent as removeAgent, } from "../api.js";
 import { loadConfig, switchWorkspace as selectWorkspace, } from "../config.js";
 import { readEpicSpec } from "../epics.js";
 import { EARLIER_PAGE } from "./inbox.js";
@@ -31,12 +31,12 @@ function withTicketKeys(messages, tickets) {
 }
 export async function loadSnapshot(config = loadConfig(), options = {}) {
     const earlierLimit = options.earlierLimit ?? EARLIER_PAGE;
-    const [status, workspaceData, ticketData, agentData, epicData, feedData, unreadData, earlierData] = await Promise.all([
+    const [status, workspaceData, ticketData, agentData, roadmapData, feedData, unreadData, earlierData] = await Promise.all([
         getStatus(config),
         getWorkspace(config),
         listTickets(config),
         listAgents(config),
-        listEpics(config),
+        getRoadmap(config),
         listFeed(config),
         listMessages({ toRoles: ["human", "all"], undelivered: true, limit: 500 }, config),
         listMessages({
@@ -73,13 +73,15 @@ export async function loadSnapshot(config = loadConfig(), options = {}) {
         board: {
             tickets,
             agents: agentData.agents,
-            epics: epicData.epics,
+            epics: roadmapData.epics,
+            roadmap: roadmapData.roadmap,
             decisions: status.decisions,
             messages: withTicketKeys(unreadData.messages, tickets),
             earlier: earlier.slice(0, earlierLimit),
             earlierHasMore: earlier.length > earlierLimit,
             availability,
             runs: status.recent_runs ?? status.live_runs,
+            hostDrain: status.host?.draining ?? null,
         },
         feed: feedData.entries,
     };
@@ -122,7 +124,37 @@ export async function switchWorkspace(slug, config = loadConfig()) {
     return snapshot;
 }
 export async function postAgentMessage(role, body, config) {
-    await sendMessage({ body_md: body, to_role: role, delivery: "queue" }, config);
+    const { message } = await sendMessage({ body_md: body, to_role: role, delivery: "queue" }, config);
+    return message;
+}
+export async function loadChatMessages(config, role) {
+    const { messages } = await listMessages({
+        unticketed: true,
+        fromRoles: ["human", "operator", role],
+        limit: 200,
+        order: "desc",
+    }, config);
+    return messages.slice().reverse();
+}
+export async function followChat(config, role, messageId, since) {
+    const kind = role === "architect" ? "architect" : "orchestrate";
+    const status = await getStatus(config);
+    const runs = [...(status.live_runs ?? []), ...(status.recent_runs ?? [])];
+    const tagged = runs.find((run) => run.message_id === messageId);
+    const live = runs.find((run) => run.kind === kind && ["queued", "running"].includes(run.status));
+    const match = tagged ?? live ?? null;
+    let run = null;
+    let events = [];
+    if (match) {
+        const detail = await getRun(match.id, config);
+        run = detail.run;
+        events = detail.events;
+    }
+    const { messages } = await listMessages({ since, limit: 50 }, config);
+    const reply = messages.find((message) => message.from_role === role
+        && ["human", "operator", "all"].includes(message.to_role)
+        && (!run || !message.run_id || message.run_id === run.id));
+    return { run, events, reply: reply?.body_md ?? null };
 }
 export async function loadTicketDetail(config, key) {
     const { ticket, pr, events, runs, messages, decisions } = await showTicket(key, config);

package/dist/tui/parse.js

@@ -18,6 +18,7 @@ export function parseLine(raw) {
             return rest.length ? { kind: "unknown", command: `${word.toLowerCase()} takes no arguments` }
                 : { kind: "mode", mode: "architect" };
         case "board":
+        case "roadmap":
         case "feed":
         case "settings":
             return { kind: "view", view: word.toLowerCase() };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@higherdev/cli",
-  "version": "0.17.0",
+  "version": "0.21.0",
   "type": "module",
   "bin": {
     "hd": "dist/index.js"