@higherdev/cli 0.18.0 → 0.21.0

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

@@ -95,6 +95,7 @@ ExecStart=${opts.nodePath} --experimental-strip-types ${opts.runnerPath}
 Restart=always
 RestartSec=5
 TimeoutStopSec=${systemdStopTimeoutSec(opts.drainTimeoutMs)}
+KillMode=mixed
 
 [Install]
 WantedBy=default.target

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 { 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";
@@ -178,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)
@@ -554,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;

package/dist/out.js

@@ -66,6 +66,7 @@ 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`,

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
@@ -157,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/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/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,7 +73,8 @@ 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),
@@ -123,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.18.0",
+  "version": "0.21.0",
   "type": "module",
   "bin": {
     "hd": "dist/index.js"