@higherdev/cli 0.28.0 → 0.30.0

package/README.md

@@ -30,7 +30,7 @@ workspace-map config shapes are migrated automatically when they are read.
 | `hd ticket new --title TITLE [--acceptance TEXT] [options]` | Create a ticket non-interactively |
 | `hd ticket queue KEY` | Queue a complete ticket now |
 | `hd ticket cancel KEY` | Cancel a ticket |
-| `hd epic new PATH [--title TITLE]` | Create an epic from a Markdown spec |
+| `hd epic new PATH [--title TITLE] [--draft]` | Create an approved epic, or keep it as a draft |
 | `hd epic list` | List epics and ticket progress |
 | `hd epic approve ID` | Open a draft epic for orchestrator decomposition |
 | `hd epic rm ID` | Remove a draft epic |

package/dist/api.js

@@ -81,6 +81,9 @@ export async function postMessage(fields, config = loadConfig()) {
 export async function getRun(id, config = loadConfig()) {
     return request(config, "GET", `/api/w/${config.slug}/runs/${encodeURIComponent(id)}`);
 }
+export async function cancelRun(id, config = loadConfig()) {
+    return request(config, "POST", `/api/w/${config.slug}/runs/${encodeURIComponent(id)}/cancel`);
+}
 export async function answerDecision(id, answer_md, config = loadConfig()) {
     return request(config, "POST", `/api/w/${config.slug}/decisions/${encodeURIComponent(id)}/answer`, { answer_md });
 }

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { realpathSync } from "node:fs";
 import { pathToFileURL } from "node:url";
-import { approveEpic, answerDecision, cancelTicket, mergeTicket, 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 { approveEpic, answerDecision, cancelTicket, cancelRun, mergeTicket, 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";
@@ -89,6 +89,25 @@ async function cmdStatus() {
         console.log(`\n${c.bold("Chat replies")}  median ${seconds}s (last day)`);
     }
 }
+export function runAge(started, created, now = Date.now()) {
+    const seconds = Math.max(0, Math.floor((now - Date.parse(started ?? created)) / 1000));
+    return seconds < 60 ? `${seconds}s` : `${Math.floor(seconds / 60)}m ${seconds % 60}s`;
+}
+async function cmdRun(argv) {
+    if (argv[0] !== "cancel" || !argv[1] || argv.length !== 2)
+        fail("usage: hd run cancel ID");
+    const { run } = await cancelRun(argv[1]);
+    console.log(`${run.id}  cancellation requested`);
+}
+async function cmdRuns(argv) {
+    if (argv.length)
+        fail("usage: hd runs");
+    const [{ live_runs: runs }, { agents }] = await Promise.all([getStatus(), listAgents()]);
+    const names = new Map(agents.map((agent) => [agent.id, agent.display_name]));
+    console.log(table(["ID", "AGE", "KIND", "AGENT"], runs.map((run) => [
+        run.id, runAge(run.started_at, run.created_at), run.kind, names.get(run.agent_id ?? "") ?? run.provider,
+    ])));
+}
 async function cmdTicket(argv, deps = {}) {
     const [action, ...rest] = argv;
     if (action === "list") {
@@ -167,18 +186,19 @@ async function cmdEpic(argv) {
             return;
         }
         console.log(table(["KEY", "STATUS", "PROGRESS", "TITLE"], rows.map((epic) => [
-            epic.id, statusChip(epic.status), `${epic.merged}/${epic.total}`, epic.title,
+            epic.id, epic.status === "draft" ? c.yellow(`needs your approval; hd epic approve ${epic.id}`)
+                : statusChip(epic.status), `${epic.merged}/${epic.total}`, epic.title,
         ])));
         return;
     }
     if (action === "new") {
-        const { rest: paths, opts } = flags(rest);
+        const { rest: paths, opts, bools } = flags(rest);
         const path = paths.join(" ");
-        if (!path)
-            fail("usage: hd epic new PATH [--title TITLE]");
+        if (!path || [...bools].some((name) => name !== "draft"))
+            fail("usage: hd epic new PATH [--title TITLE] [--draft]");
         const input = await readEpicSpec(path, opts.title);
-        const { epic } = await createEpic(input);
-        console.log(`${c.bold(epic.id)}  ${statusChip(epic.status)}  ${epic.title}`);
+        const { epic, message } = await createEpic({ ...input, draft: bools.has("draft") });
+        console.log(`${c.bold(epic.id)}  ${message}`);
         return;
     }
     if (action === "approve" || action === "rm") {
@@ -214,7 +234,7 @@ async function cmdEpic(argv) {
         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");
+    fail("usage: hd epic new PATH [--title TITLE] [--draft] | list | approve ID | rm ID | set ID --position N");
 }
 async function cmdRoadmap(argv) {
     const parsed = flags(argv);
@@ -445,8 +465,10 @@ async function cmdAgents(argv, deps = {}) {
     };
     if (!Object.keys(fields).length)
         fail(agentUsage);
-    const { agent } = await updateAgent(current.id, fields);
+    const { agent, cancelled_runs = 0 } = await updateAgent(current.id, fields);
     console.log(`${agent.display_name}  ${agent.role}  ${agent.provider}  ${agent.model}  ${agent.enabled ? "on" : "off"}`);
+    if (cancelled_runs)
+        console.log(`cancellation requested for ${cancelled_runs} live run${cancelled_runs === 1 ? "" : "s"}`);
 }
 export function mailerCapsRow(auth) {
     if (auth === "smtp")
@@ -622,6 +644,14 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
             await cmdTicket(rest, deps);
             return;
         }
+        if (cmd === "run") {
+            await cmdRun(rest);
+            return;
+        }
+        if (cmd === "runs") {
+            await cmdRuns(rest);
+            return;
+        }
         if (cmd === "epic") {
             await cmdEpic(rest);
             return;
@@ -658,7 +688,7 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
             await cmdWorkspace(rest, deps);
             return;
         }
-        if (cmd === "agents") {
+        if (cmd === "agents" || cmd === "agent") {
             await cmdAgents(rest, deps);
             return;
         }

package/dist/out.js

@@ -65,7 +65,8 @@ export function usage() {
         c.bold("Usage"),
         `  ${c.blue("hd status")}                         workspace overview`,
         `  ${c.blue("hd ticket list | show KEY [--json] | new [PATH] | queue | cancel | merge")} ticket operations`,
-        `  ${c.blue("hd epic new PATH | list | approve | rm")} epic operations`,
+        `  ${c.blue("hd runs | hd run cancel ID")}          inspect or cancel live runs`,
+        `  ${c.blue("hd epic new PATH [--draft] | 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`,

package/dist/roadmap.js

@@ -1,7 +1,12 @@
 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;
+    const next = [...epics].sort((a, b) => a.position - b.position).find((epic) => epic.status !== "done" && epic.depends_on.every((id) => statuses.get(id) === "done"));
+    return next?.status === "draft" ? null : next ?? null;
+}
+export function orchestratorIdleReason(epics) {
+    const statuses = new Map(epics.map((epic) => [epic.id, epic.status]));
+    const next = [...epics].sort((a, b) => a.position - b.position).find((epic) => epic.status !== "done" && epic.depends_on.every((id) => statuses.get(id) === "done"));
+    return next?.status === "draft" ? `idle because ${next.title} is a draft and needs your approval` : null;
 }
 export function progressBar(merged, total, width = 10) {
     const complete = total > 0 ? Math.round((Math.max(0, Math.min(merged, total)) / total) * width) : 0;
@@ -12,7 +17,7 @@ export function roadmapText(epics) {
     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;
+        const status = epic.status === "draft" ? `needs your approval · /epic approve ${epic.id}` : epic.status;
         return [
             `${epic.id === current?.id ? "▶" : " "} ${epic.position}. ${epic.title} [${status}]`,
             `  Outcome: ${epic.outcome_md || "Not described"}`,

package/dist/tui/App.js

@@ -25,7 +25,7 @@ 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, mergeTicket, 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 { configuredSlugs, acknowledgeInbox, approveEpic, cancelTicket, cancelRun, mergeTicket, 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, promptPlaceholder, settleChatReply } from "./chat-wait.js";
 import { answeredLine, decisionHeaderIndex, decisionIdAt, moveDecisionFocus, nextUnanswered, resolveDecisionAnswer, } from "./decide-nav.js";
 import { EARLIER_PAGE } from "./inbox.js";
@@ -315,16 +315,20 @@ export function App({ initial, availableUpdate: initialUpdate = null, updateDeps
         }
         setBusy(true);
         try {
+            let message = null;
             if (edit.value.target === "cap") {
                 await updateProviderCap(config, edit.value.provider, edit.value.cap);
             }
             else if (edit.value.target === "agent") {
-                await updateAgent(config, edit.value.id, edit.value.fields);
+                const result = await updateAgent(config, edit.value.id, edit.value.fields);
+                const count = result.cancelled_runs ?? 0;
+                if (count)
+                    message = `Saved. Cancellation requested for ${count} live run${count === 1 ? "" : "s"}.`;
             }
             else {
                 await updateWorkspace(config, edit.value.fields);
             }
-            setNotice(null);
+            setNotice(message);
             await refresh();
         }
         catch (error) {
@@ -679,8 +683,8 @@ export function App({ initial, availableUpdate: initialUpdate = null, updateDeps
             case "epic-new":
                 setBusy(true);
                 try {
-                    const { epic } = await createEpicFromFile(config, action.path);
-                    say("system", `Created epic ${epic.id}: ${epic.title}`);
+                    const { epic, message } = await createEpicFromFile(config, action.path, action.draft);
+                    say("system", `Created epic ${epic.id}: ${message}`);
                     await refresh();
                 }
                 catch (error) {
@@ -721,7 +725,8 @@ export function App({ initial, availableUpdate: initialUpdate = null, updateDeps
             case "epics": {
                 const rows = epicProgressRows(board.epics, board.tickets);
                 say("system", rows.length
-                    ? rows.map((epic) => `${epic.id}  ${epic.status}  ${epic.merged}/${epic.total}  ${epic.title}`).join("\n")
+                    ? rows.map((epic) => `${epic.id}  ${epic.status === "draft"
+                        ? `needs your approval · /epic approve ${epic.id}` : epic.status}  ${epic.merged}/${epic.total}  ${epic.title}`).join("\n")
                     : "No epics.");
                 return;
             }
@@ -767,6 +772,20 @@ export function App({ initial, availableUpdate: initialUpdate = null, updateDeps
                     setBusy(false);
                 }
                 return;
+            case "cancel-run":
+                setBusy(true);
+                try {
+                    await cancelRun(config, action.id);
+                    say("system", `Cancellation requested for run ${action.id}.`);
+                    await refresh();
+                }
+                catch (error) {
+                    setNotice(error instanceof Error ? error.message : String(error));
+                }
+                finally {
+                    setBusy(false);
+                }
+                return;
             case "merge":
                 setBusy(true);
                 try {

package/dist/tui/Dashboard.js

@@ -122,7 +122,7 @@ export function AgentsColumn({ board, width, rows, }) {
                     ? "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.detail ?? row.state}` }))] })] }, row.key));
             }),
             _jsx(More, { count: displayRows.length - shown.length }, "more"),
         ] }));

package/dist/tui/Help.js

@@ -10,12 +10,12 @@ export const COMMANDS = [
     { 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" },
-    { name: "/cancel", args: "HD-12", help: "cancel a ticket" },
+    { name: "/cancel", args: "HD-12 | RUN-ID", help: "cancel a ticket or run" },
     { name: "/merge", args: "HD-12", help: "approve a reviewed PR over the reviewer's objections" },
     { name: "/msg", args: "HD-12 TEXT", help: "message a ticket's builder" },
     { name: "/attach", args: "PATH [HD-12]", help: "attach a file to the open or named ticket" },
     { 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: "/epic", args: "new PATH [--draft] | approve ID | rm ID", help: "create, approve, or remove an epic" },
     { name: "/epics", help: "list epics and ticket progress" },
     { name: "/architect", help: "open a chat with the architect" },
     { name: "/plan", help: "alias for /architect" },

package/dist/tui/Panels.js

@@ -93,14 +93,15 @@ export function InboxPanel({ board, width = 80, rows = 12, focus = 0, selectedId
     const entries = inboxEntries(board, width, answeringId);
     const unread = board.messages ?? [];
     const earlier = board.earlier ?? [];
+    const drafts = board.epics.filter((epic) => epic.status === "draft").length;
     const selected = selectedId ?? decisionIdAt(entries, focus);
     const inner = Math.max(0, rows - 1);
     const window = scrollWindow(entries.length, inner, focus);
     const hiddenAbove = window.start;
     const hiddenBelow = entries.length - window.end;
-    const note = `${board.decisions.length}d · ${unread.length} unread`
+    const note = `${drafts ? `${drafts} epic${drafts === 1 ? "" : "s"} · ` : ""}${board.decisions.length}d · ${unread.length} unread`
         + `${hiddenAbove ? `  ${hiddenAbove}↑` : ""}${hiddenBelow ? `  ${hiddenBelow}↓` : ""}`;
-    const empty = board.decisions.length === 0 && unread.length === 0 && earlier.length === 0;
+    const empty = drafts === 0 && board.decisions.length === 0 && unread.length === 0 && earlier.length === 0;
     return (_jsx(Panel, { width: width, rows: rows, children: [
             _jsx(Heading, { text: "Inbox", note: note }, "h"),
             ...(empty
@@ -122,6 +123,15 @@ export function inboxEntries(board, width, answeringId) {
     const bodyWidth = Math.max(12, width - 2);
     const unread = board.messages ?? [];
     const earlier = board.earlier ?? [];
+    const drafts = board.epics.filter((epic) => epic.status === "draft");
+    if (drafts.length) {
+        entries.push({ key: "drafts:section", kind: "section", text: "Draft epics" });
+        for (const epic of drafts) {
+            entries.push({ key: `draft:${epic.id}`, kind: "header", text: epic.title });
+            entries.push({ key: `draft:${epic.id}:action`, kind: "body",
+                text: `Needs your approval · /epic approve ${epic.id}` });
+        }
+    }
     board.decisions.forEach((decision, index) => {
         const ticket = board.tickets.find((row) => row.id === decision.ticket_id);
         entries.push({

package/dist/tui/Roadmap.js

@@ -30,7 +30,7 @@ export function RoadmapPanel({ board, width = 80, rows = 12, offset = 0 }) {
             _jsx(Heading, { text: "Roadmap", note: note }, "h"),
             ...shown.map((line, index) => {
                 const current = line.startsWith("▶");
-                const draft = line.includes("draft, awaiting approval");
+                const draft = line.includes("needs your 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,4 +1,5 @@
 import { formatDrainStatus } from "../host.js";
+import { orchestratorIdleReason } from "../roadmap.js";
 const LIMITED_UNTIL = /^(?:Waiting on )?(\w+) (?:limited )?until (\d{1,2}:\d{2})\.?$/;
 export function limitedUntilByProvider(tickets) {
     const limited = new Map();
@@ -33,6 +34,7 @@ export function agentDisplayRows(board, now = Date.now()) {
                 ticket: null,
                 state: "draining",
                 limitedUntil: null,
+                detail: null,
             }]
         : [];
     const activeAgents = new Set();
@@ -61,6 +63,7 @@ export function agentDisplayRows(board, now = Date.now()) {
             ticket,
             state: run.status,
             limitedUntil: null,
+            detail: null,
         };
     });
     const limited = limitedUntilByProvider(board.tickets);
@@ -81,6 +84,7 @@ export function agentDisplayRows(board, now = Date.now()) {
                     ? "offline"
                     : "idle",
             limitedUntil: until ?? null,
+            detail: agent.role === "orchestrator" ? orchestratorIdleReason(board.epics) : null,
         };
     });
     return [...drain, ...live, ...idle];

package/dist/tui/chat-view.js

@@ -96,7 +96,7 @@ export function followShouldStop(run, reply, tagged = false) {
         return true;
     if (!run)
         return false;
-    if (["failed", "killed"].includes(run.status))
+    if (["failed", "killed", "cancelled"].includes(run.status))
         return true;
     // The role's other runs may finish while ours is still queued; only the run
     // started for this message is definitive when it ends without a reply.

package/dist/tui/chat-wait.js

@@ -28,7 +28,7 @@ export function settleChatReply(reply, run) {
     if (reply) {
         return { body: reply, pending: false, steps: [], done: true, replyMs: run?.reply_ms ?? null };
     }
-    if (run && ["failed", "killed"].includes(run.status ?? "")) {
+    if (run && ["failed", "killed", "cancelled"].includes(run.status ?? "")) {
         return { body: failedChatNote(run.summary), pending: false, steps: [], done: true, replyMs: run.reply_ms ?? null };
     }
     if (run && run.status && !["queued", "running"].includes(run.status)) {

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, getRoadmap, getRun, getWorkspace, listAgents, listFeed, listMessages, markMessagesDelivered, listWorkspaceEnv as getWorkspaceEnv, listTicketRunEvents, listTickets, listWorkspaces, postMessage as sendMessage, mergeTicket as mergeTicketNow, 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, cancelRun as cancelRunNow, 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, mergeTicket as mergeTicketNow, 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";
@@ -70,6 +70,7 @@ export async function loadSnapshot(config = loadConfig(), options = {}) {
                 chat: Number(workspaceData.workspace.settings.max_turns?.chat ?? 8),
             },
             max_attempts: Number(workspaceData.workspace.settings.max_attempts ?? 3),
+            chat_timeout_ms: Number(workspaceData.workspace.settings.chat_timeout_ms ?? 600_000),
         },
         board: {
             tickets,
@@ -129,6 +130,9 @@ export async function postAgentMessage(role, body, config, attachmentIds = []) {
         attachment_ids: attachmentIds }, config);
     return message;
 }
+export async function cancelRun(config, id) {
+    await cancelRunNow(id, config);
+}
 export async function loadChatMessages(config, role) {
     const { messages } = await listMessages({
         unticketed: true,
@@ -173,8 +177,8 @@ export async function loadTicketDetail(config, key) {
         },
     };
 }
-export async function createEpicFromFile(config, path) {
-    return postEpic(await readEpicSpec(path), config);
+export async function createEpicFromFile(config, path, draft = false) {
+    return postEpic({ ...await readEpicSpec(path), draft }, config);
 }
 export async function approveEpic(config, id) {
     return approveEpicNow(id, config);

package/dist/tui/parse.js

@@ -61,7 +61,10 @@ export function parseLine(raw) {
                 : { kind: "unknown", command: "ticket needs a key" };
         case "epic":
             if (rest[0]?.toLowerCase() === "new" && rest.length > 1) {
-                return { kind: "epic-new", path: rest.slice(1).join(" ") };
+                const draft = rest.includes("--draft");
+                const path = rest.slice(1).filter((part) => part !== "--draft").join(" ");
+                return path ? { kind: "epic-new", path, draft }
+                    : { kind: "unknown", command: "epic needs new PATH, approve ID, or rm ID" };
             }
             return rest[0]?.toLowerCase() === "approve" && rest.length === 2
                 ? { kind: "epic-approve", id: rest[1] }
@@ -79,7 +82,9 @@ export function parseLine(raw) {
                 ? { kind: "queue", key: argument.toUpperCase() }
                 : { kind: "unknown", command: "queue needs a key" };
         case "cancel":
-            return argument ? { kind: "cancel", key: argument.toUpperCase() }
+            return argument ? /^HD-\d+$/i.test(argument)
+                ? { kind: "cancel", key: argument.toUpperCase() }
+                : { kind: "cancel-run", id: argument }
                 : { kind: "unknown", command: "cancel needs a key" };
         case "merge":
             return argument ? { kind: "merge", key: argument.toUpperCase() }

package/dist/tui/settings-model.js

@@ -12,6 +12,7 @@ export function settingsRows(workspace, agents) {
             value: String(workspace.max_turns[kind]), hint: "integer >= 1",
         })),
         { key: "w:max_attempts", kind: "number", label: "max attempts", value: String(workspace.max_attempts) },
+        { key: "w:chat_timeout_ms", kind: "number", label: "chat timeout ms", value: String(workspace.chat_timeout_ms ?? 600_000) },
     ];
     for (const provider of providers) {
         rows.push({
@@ -81,6 +82,12 @@ export function editFor(row, raw) {
                 return { ok: false, error: "max_attempts must be an integer >= 1." };
             return { ok: true, value: { target: "workspace", fields: { max_attempts: number } } };
         }
+        if (id === "chat_timeout_ms") {
+            const number = Number(value);
+            if (!Number.isInteger(number) || number < 1_000)
+                return { ok: false, error: "chat_timeout_ms must be an integer >= 1000." };
+            return { ok: true, value: { target: "workspace", fields: { chat_timeout_ms: number } } };
+        }
         if (id === "auto_merge")
             return { ok: true, value: { target: "workspace", fields: { auto_merge: value === "yes" } } };
         if (!value)

package/dist/tui/stream.js

@@ -39,7 +39,7 @@ export function toStreamLines(events, runs, raw = false) {
         const target = run.ticket ? ` on ${run.ticket}` : "";
         lines.push({ id: `${run.runId}:end`, sourceIds: [`${run.runId}:end`], runId: run.runId,
             agent: run.agent, at: run.endedAt ?? "", seq: Number.MAX_SAFE_INTEGER,
-            kind: run.status === "failed" || run.status === "killed" ? "error" : "status",
+            kind: ["failed", "killed", "cancelled"].includes(run.status) ? "error" : "status",
             title: `${run.agent} finished ${run.kind}${target}: ${run.summary}` });
     }
     return collapse(lines.sort((a, b) => a.at.localeCompare(b.at) || a.seq - b.seq), raw);

package/dist/workspace-commands.js

@@ -150,6 +150,12 @@ export async function workspaceSet(argv) {
             throw new Error("--max-attempts must be an integer >= 1");
         fields.max_attempts = value;
     }
+    if (opts["chat-timeout-ms"]) {
+        const value = Number(opts["chat-timeout-ms"]);
+        if (!Number.isInteger(value) || value < 1_000)
+            throw new Error("--chat-timeout-ms must be an integer >= 1000");
+        fields.chat_timeout_ms = value;
+    }
     if (!Object.keys(fields).length)
         throw new Error(WORKSPACE_USAGE);
     return (await updateWorkspace(fields)).workspace;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@higherdev/cli",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "type": "module",
   "repository": {
     "type": "git",