@higherdev/cli 0.29.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/index.js

@@ -186,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") {
@@ -233,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);

package/dist/out.js

@@ -66,7 +66,7 @@ export function 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 runs | hd run cancel ID")}          inspect or cancel live runs`,
-        `  ${c.blue("hd epic new PATH | list | approve | rm")} epic operations`,
+        `  ${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

@@ -683,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) {
@@ -725,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;
             }

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

@@ -15,7 +15,7 @@ export const COMMANDS = [
     { 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/data.js

@@ -177,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] }

package/package.json

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