@higherdev/cli 0.15.4 → 0.17.0

package/README.md

@@ -25,7 +25,7 @@ workspace-map config shapes are migrated automatically when they are read.
 | `hd --help` | Show the HigherDEV banner and usage |
 | `hd status` | Show workspace, ticket, run, and decision status |
 | `hd ticket list` | List tickets |
-| `hd ticket show KEY` | Show one ticket |
+| `hd ticket show KEY [--json]` | Show one ticket (body, acceptance, timeline, messages, PR, runs, decisions) |
 | `hd ticket new [PATH.md]` | Create a ticket from the guided form or a Markdown spec |
 | `hd ticket new --title TITLE [--acceptance TEXT] [options]` | Create a ticket non-interactively |
 | `hd ticket queue KEY` | Queue a complete ticket now |
@@ -54,6 +54,7 @@ workspace-map config shapes are migrated automatically when they are read.
 | `hd host env rm NAME` | Remove a host-only environment variable |
 | `hd logs KEY [-f]` | Show or follow run events |
 | `hd msg KEY "message" [--interrupt]` | Message a builder |
+| `hd inbox [--all] [--limit N] [--json]` | List unread inbox messages, or earlier history with `--all` |
 | `hd decide` | List open decisions |
 | `hd decide ID --answer TEXT` | Answer a decision |
 | `hd on` / `hd off` | Turn the workspace on or off |
@@ -95,7 +96,7 @@ Use `hd host env set VERCEL_TOKEN=... VERCEL_TEAM_ID=...` to let the runner adop
 Vercel project. It syncs `NEXT_PUBLIC_*`, names listed in `settings.vercel.env`, and existing Vercel-held names
 to production and preview. Later `hd env set` changes wake the orchestrator to update matching Vercel variables.
 
-Inside the TUI, use `/board`, `/inbox`, `/ticket`, `/ticket new [PATH.md]`, `/queue`, `/cancel`, `/msg`, `/logs`, `/epic new`,
+Inside the TUI, use `/board`, `/inbox`, `/inbox more`, `/ticket`, `/ticket new [PATH.md]`, `/queue`, `/cancel`, `/msg`, `/logs`, `/epic new`,
 `/epic approve`, `/epic rm`, `/epics`, `/architect` (or `/plan`), `/decide`, `/agents add`, `/agents rm`, `/env`, `/settings`, `/workspace`,
 `/workspace new`, `/workspace set`, `/workspace rotate-key`, `/workspace grant-runner-access`, `/feed`,
 `/on`, `/off`, `/orchestrator`, `/refresh`, `/help`, or `/exit`. The display refreshes from

package/dist/agent-commands.js

@@ -0,0 +1,80 @@
+import { createAgent, getStatus, listAgents } from "./api.js";
+import { promptOnStdin } from "./prompt.js";
+export const AGENT_ADD_USAGE = "usage: hd agents add [ROLE] --name NAME --provider P --model M --effort E";
+const EFFORTS = ["low", "medium", "high"];
+const ROLES = ["architect", "orchestrator", "reviewer", "builder"];
+function parse(argv) {
+    const opts = {};
+    const rest = [];
+    const missingValues = [];
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (!arg.startsWith("--")) {
+            rest.push(arg);
+            continue;
+        }
+        const name = arg.slice(2);
+        const value = argv[index + 1];
+        if (!value || value.startsWith("--")) {
+            missingValues.push(name);
+            continue;
+        }
+        opts[name] = value;
+        index += 1;
+    }
+    return { opts, rest, missingValues };
+}
+export function nextBuilderName(agents) {
+    return `Builder ${agents.filter((agent) => agent.role === "builder").length + 1}`;
+}
+export function availableProvider(capabilities, requested) {
+    const capability = capabilities.find((item) => item.provider === requested);
+    if (!capability?.available)
+        throw new Error(capability?.reason ?? `Unsupported provider ${requested}.`);
+    return capability;
+}
+function choose(answer, choices) {
+    if (!answer)
+        return choices[0];
+    return /^\d+$/.test(answer) ? choices[Number(answer) - 1] : answer;
+}
+export async function agentAdd(argv, deps = {}) {
+    const { opts, rest, missingValues } = parse(argv);
+    if (missingValues.length || rest.length > 1 || Object.keys(opts).some((key) => !["name", "provider", "model", "effort"].includes(key)))
+        throw new Error(AGENT_ADD_USAGE);
+    const role = rest[0] ?? "builder";
+    if (!ROLES.includes(role))
+        throw new Error(AGENT_ADD_USAGE);
+    const interactive = deps.isTTY ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
+    const needsForm = ["name", "provider", "model", "effort"].some((field) => !opts[field]);
+    if (needsForm && !interactive)
+        throw new Error(AGENT_ADD_USAGE);
+    const [{ agents }, status] = await Promise.all([
+        (deps.listAgents ?? listAgents)(deps.config), (deps.getStatus ?? getStatus)(deps.config),
+    ]);
+    const prompt = deps.prompt ?? promptOnStdin;
+    const defaultName = nextBuilderName(agents);
+    const name = opts.name?.trim() || (await prompt(`Name [${defaultName}]: `)).trim() || defaultName;
+    const capabilities = status.workspace.provider_capabilities ?? [];
+    if (opts.provider?.trim())
+        availableProvider(capabilities, opts.provider.trim());
+    const providers = capabilities.filter((item) => item.available).map((item) => item.provider);
+    if (!providers.length && !opts.provider) {
+        throw new Error(`No providers are available on runner host ${status.workspace.default_host}.`);
+    }
+    const providerAnswer = opts.provider?.trim() || (await prompt(`Provider (${providers.map((item, index) => `${index + 1}=${item}`).join(", ")}) [${providers[0]}]: `)).trim();
+    const provider = choose(providerAnswer, providers);
+    if (!provider)
+        throw new Error("Provider is required.");
+    availableProvider(capabilities, provider);
+    const model = opts.model?.trim() || (await prompt("Model: ")).trim();
+    if (!model)
+        throw new Error("Model is required.");
+    const effortAnswer = opts.effort?.trim() || (await prompt("Effort (1=low, 2=medium, 3=high) [high]: ")).trim();
+    const effort = choose(effortAnswer || "high", [...EFFORTS]);
+    if (!effort || !EFFORTS.includes(effort)) {
+        throw new Error(`Choose effort from: ${EFFORTS.join(", ")}.`);
+    }
+    return (deps.createAgent ?? createAgent)({ role, provider, model, effort,
+        display_name: name }, deps.config);
+}

package/dist/api.js

@@ -58,14 +58,19 @@ export async function queueTicket(key, config = loadConfig()) {
 export async function cancelTicket(key, config = loadConfig()) {
     return request(config, "POST", `/api/w/${config.slug}/tickets/${encodeURIComponent(key)}/cancel`);
 }
-export async function listTicketEvents(key, afterAt, afterId, config = loadConfig()) {
+export async function listTicketRunEvents(key, afterAt, afterId, config = loadConfig()) {
     const query = new URLSearchParams();
     if (afterAt)
         query.set("after_at", afterAt);
     if (afterId)
         query.set("after_id", afterId);
-    const suffix = query.size ? `?${query.toString()}` : "";
-    return request(config, "GET", `/api/w/${config.slug}/tickets/${encodeURIComponent(key)}/events${suffix}`);
+    const suffix = query.size ? `&${query.toString()}` : "";
+    const result = await request(config, "GET", `/api/w/${config.slug}/tickets/${encodeURIComponent(key)}/events?stream=1${suffix}`);
+    const runs = new Map((result.runs ?? []).map((run) => [run.id, run]));
+    return { ...result, events: result.events.map((event) => ({ ...event, run: runs.get(event.run_id) })) };
+}
+export async function listTicketStory(key, config = loadConfig()) {
+    return request(config, "GET", `/api/w/${config.slug}/tickets/${encodeURIComponent(key)}/events`);
 }
 export async function postMessage(fields, config = loadConfig()) {
     return request(config, "POST", `/api/w/${config.slug}/messages`, fields);
@@ -143,10 +148,16 @@ export async function listMessages(options = {}, config = loadConfig()) {
         query.set("since", options.since);
     if (options.limit)
         query.set("limit", String(options.limit));
+    if (options.offset)
+        query.set("offset", String(options.offset));
     if (options.toRoles?.length)
         query.set("to_role", options.toRoles.join(","));
     if (options.undelivered)
         query.set("undelivered", "true");
+    if (options.delivered)
+        query.set("delivered", "true");
+    if (options.order)
+        query.set("order", options.order);
     const suffix = query.size ? `?${query.toString()}` : "";
     return request(config, "GET", `/api/w/${config.slug}/messages${suffix}`);
 }

package/dist/index.js

@@ -1,13 +1,15 @@
 #!/usr/bin/env node
 import { realpathSync } from "node:fs";
 import { pathToFileURL } from "node:url";
-import { approveEpic, answerDecision, cancelTicket, createAgent, createEpic, deleteAgent, deleteEpic, getStatus, listAgents, listEpics, listHostEnv, listWorkspaceEnv, listTicketEvents, listTickets, listWorkspaces, postMessage, queueTicket, removeWorkspaceEnv, removeHostEnv, setPaused, setWorkspaceEnv, setHostEnv, showTicket, updateAgent, updateCaps, } from "./api.js";
+import { approveEpic, answerDecision, cancelTicket, createEpic, deleteAgent, deleteEpic, getStatus, getWorkspace, listAgents, listEpics, listHostEnv, listMessages, listWorkspaceEnv, listTicketRunEvents, listTickets, listWorkspaces, postMessage, queueTicket, removeWorkspaceEnv, removeHostEnv, setPaused, setWorkspaceEnv, setHostEnv, showTicket, updateAgent, updateCaps, } from "./api.js";
 import { initHost, parseHostFlags } from "./host.js";
 import { login, parseLoginFlags } from "./login.js";
 import { loadConfig } from "./config.js";
 import { epicProgressRows, readEpicSpec } from "./epics.js";
 import { banner, c, statusChip, table, truncate, usage } from "./out.js";
 import { ticketNew } from "./ticket-commands.js";
+import { ticketViewLines } from "./tui/ticket-view.js";
+import { agentAdd, AGENT_ADD_USAGE } from "./agent-commands.js";
 import { WORKSPACE_USAGE, workspaceGrantRunnerAccess, workspaceNew, workspaceRotateKey, workspaceSet, workspaceUse } from "./workspace-commands.js";
 import { defaultGh, hasWriteRepoPermission, HDX_RUNNER_GH_USER, requireAdminRepo, runnerRepoPermission } from "./workspace-preflight.js";
 function fail(message) {
@@ -53,13 +55,19 @@ function printTickets(tickets) {
     }
     console.log(table(["KEY", "STATUS", "PROVIDER", "TITLE", "WHY"], tickets.map((ticket) => [
         c.bold(ticket.key), statusChip(ticket.status), ticket.provider ?? c.dim("-"),
-        truncate(ticket.title, 48), ticket.stuck_reason ? c.yellow(truncate(ticket.stuck_reason, 40)) : "",
+        truncate(ticket.title, 48), ticket.latest_headline ? c.yellow(truncate(ticket.latest_headline, 40))
+            : ticket.stuck_reason ? c.yellow(truncate(ticket.stuck_reason, 40)) : "",
     ])));
 }
 async function cmdStatus() {
     const data = await getStatus();
     const state = data.workspace.paused ? c.yellow("off") : c.green("on");
     console.log(`${c.bold(data.workspace.name)}  ${c.dim(data.workspace.repo)}  ${state}\n`);
+    const waiting = [...new Set(data.tickets.map((ticket) => ticket.stuck_reason
+            ?.match(/^Waiting on (\w+) until (\d{1,2}:\d{2})\.$/)).filter(Boolean)
+            .map((match) => `${match?.[1]} waiting until ${match?.[2]}`))];
+    if (waiting.length)
+        console.log(`${c.bold("Providers")}  ${waiting.map((line) => c.yellow(line)).join(", ")}\n`);
     printTickets(data.tickets);
     if (data.live_runs.length > 0) {
         console.log(`\n${c.bold("Live runs")}`);
@@ -79,23 +87,31 @@ async function cmdTicket(argv, deps = {}) {
         return;
     }
     if (action === "show") {
-        const key = rest[0];
-        if (!key)
-            fail("usage: hd ticket show KEY");
-        const { ticket } = await showTicket(key);
-        console.log(`${c.bold(ticket.key)}  ${statusChip(ticket.status)}  ${ticket.title}`);
-        if (ticket.stuck_reason)
-            console.log(`stuck: ${ticket.stuck_reason}`);
-        if (ticket.provider)
-            console.log(`provider: ${ticket.provider}`);
-        if (ticket.area)
-            console.log(`area: ${ticket.area}`);
-        if (ticket.pr_url)
-            console.log(`pr: ${ticket.pr_url}`);
-        if (ticket.branch)
-            console.log(`branch: ${ticket.branch}`);
-        if (ticket.body_md)
-            console.log(`\n${ticket.body_md}`);
+        const parsed = flags(rest);
+        const key = parsed.rest[0];
+        if (!key || parsed.rest.length !== 1)
+            fail("usage: hd ticket show KEY [--json]");
+        const data = await showTicket(key.toUpperCase());
+        if (parsed.bools.has("json")) {
+            console.log(JSON.stringify(data));
+            return;
+        }
+        const { ticket, pr, events, runs, messages, decisions } = data;
+        const width = process.stdout.columns && process.stdout.columns > 0 ? process.stdout.columns : 80;
+        for (const line of ticketViewLines({
+            ...ticket,
+            stuck: ticket.stuck_reason,
+            pr,
+            timeline: events,
+            messages,
+            runs: runs.map((run) => ({
+                id: run.id, kind: run.kind, provider: run.provider, status: run.status,
+                summary: run.summary, elapsed_ms: run.elapsed_ms,
+            })),
+            decisions,
+        }, width)) {
+            console.log(line.text);
+        }
         return;
     }
     if (action === "new") {
@@ -176,7 +192,7 @@ async function cmdLogs(argv) {
     let afterId;
     const follow = bools.has("follow");
     async function tick() {
-        const { events } = await listTicketEvents(key, afterAt, afterId);
+        const { events } = await listTicketRunEvents(key, afterAt, afterId);
         let printed = false;
         for (const event of events) {
             if (seen.has(event.id))
@@ -209,6 +225,36 @@ async function cmdMsg(argv) {
     });
     console.log(`sent ${message.id}`);
 }
+async function cmdInbox(argv) {
+    const { rest, opts, bools } = flags(argv);
+    if (rest.length || (bools.has("limit") && !opts.limit))
+        fail("usage: hd inbox [--all] [--limit N] [--json]");
+    const all = bools.has("all");
+    const json = bools.has("json");
+    const limit = opts.limit ? Number(opts.limit) : 50;
+    if (!Number.isInteger(limit) || limit < 1 || limit > 500)
+        fail("usage: hd inbox [--all] [--limit N] [--json]");
+    const { messages } = await listMessages({
+        toRoles: ["human", "all"],
+        limit,
+        ...(all ? { order: "desc" } : { undelivered: true }),
+    });
+    if (json) {
+        console.log(JSON.stringify({ messages }));
+        return;
+    }
+    if (!messages.length) {
+        console.log(all ? "No messages." : "No unread messages.");
+        return;
+    }
+    for (const message of messages) {
+        const sender = message.from_name?.trim() || message.from_role;
+        const ticket = message.ticket_key?.trim();
+        console.log([message.created_at, sender, ticket].filter(Boolean).join("  "));
+        console.log(message.body_md);
+        console.log("");
+    }
+}
 async function cmdDecide(argv) {
     const { rest, opts } = flags(argv);
     if (rest.length === 0) {
@@ -293,7 +339,7 @@ function selectAgent(agents, target, provider) {
         fail(`No unambiguous agent ${target}${provider ? ` for provider ${provider}` : ""}.`);
     return selected;
 }
-async function cmdAgents(argv) {
+async function cmdAgents(argv, deps = {}) {
     const [action, ...rest] = argv;
     if (!action) {
         const { agents } = await listAgents();
@@ -307,14 +353,11 @@ async function cmdAgents(argv) {
         ])));
         return;
     }
-    const agentUsage = "usage: hd agents add ROLE --provider P --model M [--effort E] [--name N] | rm ROLE|ID | set ROLE|ID [flags]";
+    const agentUsage = `${AGENT_ADD_USAGE} | hd agents rm ROLE|ID | hd agents set ROLE|ID [flags]`;
     const { rest: args, opts, bools } = flags(rest);
     const target = args[0];
     if (action === "add") {
-        if (!target || !opts.provider || !opts.model)
-            fail(agentUsage);
-        const { agent } = await createAgent({ role: target, provider: opts.provider, model: opts.model,
-            effort: opts.effort, display_name: opts.name ?? opts.provider });
+        const { agent } = await agentAdd(rest, deps);
         console.log(`${agent.id}  ${agent.display_name}  ${agent.role}  ${agent.provider}`);
         return;
     }
@@ -339,11 +382,26 @@ async function cmdAgents(argv) {
     const { agent } = await updateAgent(current.id, fields);
     console.log(`${agent.display_name}  ${agent.role}  ${agent.provider}  ${agent.model}  ${agent.enabled ? "on" : "off"}`);
 }
+export function mailerCapsRow(auth) {
+    if (auth === "smtp")
+        return "mailer: custom SMTP";
+    if (auth === "built-in" || auth === "configured")
+        return "mailer: built-in (2/h)";
+    return null;
+}
+export function previewCapsRow(preview) {
+    return `preview: ${preview === "bypass" ? "bypass" : "protected"}`;
+}
 async function cmdCaps(argv) {
     const [action, provider, raw, ...extra] = argv;
     if (!action) {
-        const caps = (await getStatus()).workspace.provider_caps;
+        const [status, detail] = await Promise.all([getStatus(), getWorkspace()]);
+        const caps = status.workspace.provider_caps ?? {};
         console.log(table(["PROVIDER", "CAP"], Object.entries(caps).sort().map(([name, cap]) => [name, String(cap)])));
+        const mailer = mailerCapsRow(detail.workspace.settings?.infra?.auth);
+        if (mailer)
+            console.log(mailer);
+        console.log(previewCapsRow(detail.workspace.settings?.infra?.vercel_preview));
         return;
     }
     const cap = Number(raw);
@@ -490,6 +548,10 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
             await cmdMsg(rest);
             return;
         }
+        if (cmd === "inbox") {
+            await cmdInbox(rest);
+            return;
+        }
         if (cmd === "decide") {
             await cmdDecide(rest);
             return;
@@ -499,7 +561,7 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
             return;
         }
         if (cmd === "agents") {
-            await cmdAgents(rest);
+            await cmdAgents(rest, deps);
             return;
         }
         if (cmd === "caps") {

package/dist/out.js

@@ -64,7 +64,7 @@ export function usage() {
     return [
         c.bold("Usage"),
         `  ${c.blue("hd status")}                         workspace overview`,
-        `  ${c.blue("hd ticket list | show | new [PATH] | queue | cancel")} ticket operations`,
+        `  ${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 plan")}                           use /architect in the TUI`,
         `  ${c.blue("hd workspace ls | use | new | set | rotate-key | grant-runner-access")} workspace operations`,
@@ -74,6 +74,7 @@ export function usage() {
         `  ${c.blue("hd host env ls | set | rm")}          host environment`,
         `  ${c.blue("hd logs KEY [-f]")}                  run events`,
         `  ${c.blue("hd msg KEY TEXT")}                   message a builder`,
+        `  ${c.blue("hd inbox [--all] [--limit N] [--json]")} inbox messages`,
         `  ${c.blue("hd decide [ID --answer TEXT]")}      decisions`,
         `  ${c.blue("hd on | hd off")}                    workspace switch`,
         `  ${c.blue("hd login --url URL --api-key KEY")}  client setup`,