@higherdev/cli 0.1.0 → 0.1.1

package/README.md

@@ -63,11 +63,23 @@ addenda, conventions, budgets. Creating an epic fires `epic.created`, which the
 orchestrator already triggers on, so the handoff needs no glue.
 
 ```bash
-hd connect                                 # ChatGPT OAuth, once per machine
-hd doctor                                  # what a run would cost, before it runs
+hd connect     # ChatGPT OAuth, once per machine
+hd doctor      # what a run would cost, before it runs
+hd plan        # a conversation: type, it answers, keep going
+```
+
+Bare `hd plan` on a terminal is a back-and-forth. Every turn after the first
+continues the same Codex session, so it remembers what you already said. A blank
+line or `/exit` leaves, and `hd plan --resume "..."` picks the thread back up
+later.
+
+Give it a request on the command line instead and it runs one turn and exits,
+which is what a script wants:
+
+```bash
 hd plan "assess the call-intel code and plan what is missing"
 hd plan --read-only "what would you change about the agent lineup?"
-hd plan --resume "split the third ticket, it is too big"
+hd plan --once "file the epic we discussed"
 ```
 
 ### The subscription is checked, not assumed

package/dist/index.js

@@ -1190,11 +1190,17 @@ function str(value) {
 }
 function assistantText(payload) {
   if (typeof payload.text === "string") return payload.text;
+  const item = asRecord(payload.item);
+  if (typeof item.text === "string") return item.text;
+  if (Array.isArray(item.content)) {
+    const joined = item.content.map((entry) => str(asRecord(entry).text)).filter(Boolean).join("\n");
+    if (joined) return joined;
+  }
   const message = asRecord(payload.message);
   const content = message.content;
   if (Array.isArray(content)) {
-    return content.map((item) => {
-      const row = asRecord(item);
+    return content.map((item2) => {
+      const row = asRecord(item2);
       return str(row.text);
     }).filter(Boolean).join("\n");
   }
@@ -1224,10 +1230,56 @@ function resultTail(payload) {
 ${tail}`;
   return prefix || tail;
 }
+function codexItemLine(event, item) {
+  const kind = str(item.type);
+  if (!kind || kind === "agent_message") return null;
+  if (kind === "mcp_tool_call") {
+    const server = str(item.server);
+    const tool = str(item.tool);
+    const status = str(item.status);
+    if (status === "in_progress") return SKIP;
+    const failed = status === "failed" || Boolean(item.error);
+    const name = [server, tool].filter(Boolean).join("/") || "tool";
+    const args = item.arguments && Object.keys(asRecord(item.arguments)).length > 0 ? ` ${JSON.stringify(item.arguments)}` : "";
+    return {
+      id: event.id,
+      kind: failed ? "error" : "tool",
+      title: `${name}${clip2(args, 120)}${status && status !== "completed" ? ` (${status})` : ""}`,
+      body: failed ? clip2(str(asRecord(item.error).message ?? item.error), 400) || void 0 : void 0
+    };
+  }
+  if (kind === "command_execution") {
+    const command = clip2(str(item.command ?? item.cmd), 120);
+    const code = item.exit_code ?? item.exitCode;
+    return {
+      id: event.id,
+      kind: code != null && Number(code) !== 0 ? "error" : "tool",
+      title: `${command || "command"}${code == null ? "" : ` (exit ${code})`}`
+    };
+  }
+  if (kind === "file_change" || kind === "patch_apply") {
+    const files = Array.isArray(item.changes) ? item.changes.map((change) => str(asRecord(change).path)).filter(Boolean) : [str(item.path)].filter(Boolean);
+    return { id: event.id, kind: "tool", title: `edited ${files.join(", ") || "a file"}` };
+  }
+  if (kind === "reasoning" || kind === "todo_list") return SKIP;
+  return { id: event.id, kind: "status", title: kind.replaceAll("_", " ") };
+}
+function clip2(text, max) {
+  const flat = String(text ?? "").trim();
+  return flat.length <= max ? flat : `${flat.slice(0, Math.max(0, max - 3))}...`;
+}
 function transcriptLines(events) {
   const lines = [];
   for (const event of events) {
     const payload = asRecord(event.payload);
+    if (payload.item) {
+      const line = codexItemLine(event, asRecord(payload.item));
+      if (line === SKIP) continue;
+      if (line) {
+        lines.push(line);
+        continue;
+      }
+    }
     if (event.type === "error") {
       lines.push({
         id: event.id,
@@ -1277,9 +1329,11 @@ function transcriptLines(events) {
   }
   return lines;
 }
+var SKIP;
 var init_transcript = __esm({
   "../../packages/db/src/transcript.ts"() {
     "use strict";
+    SKIP = "skip";
   }
 });
 
@@ -4533,7 +4587,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { z as z3 } from "zod";
 
 // src/version.ts
-var VERSION = "0.1.0";
+var VERSION = "0.1.1";
 
 // src/architect/tools.ts
 init_src();
@@ -5313,19 +5367,19 @@ function mcpConfigArgs(endpoint, extraArgs = []) {
   ];
 }
 function buildCodexArgs(opts) {
-  const base = [
+  const shared = [
     "--json",
     "-c",
     `model_reasoning_effort="${opts.effort}"`,
-    "--sandbox",
-    "read-only",
+    "-c",
+    'sandbox_mode="read-only"',
     "--skip-git-repo-check",
     ...opts.mcp
   ];
   if (opts.resumeSessionId) {
-    return ["exec", "resume", opts.resumeSessionId, ...base, opts.prompt];
+    return ["exec", "resume", opts.resumeSessionId, ...shared, opts.prompt];
   }
-  return ["exec", "--model", opts.model, ...base, "-C", opts.cwd, opts.prompt];
+  return ["exec", "--model", opts.model, "--sandbox", "read-only", ...shared, "-C", opts.cwd, opts.prompt];
 }
 function spawnArchitect(opts) {
   const args = buildCodexArgs(opts);
@@ -5536,9 +5590,11 @@ ${howToFix(connection) ?? ""}`.trim());
     pending.push({ run_id: runRow.id, seq: seq++, type: event.type, payload: event.payload });
     const [line] = transcriptLines([{ id: String(seq), type: event.type, payload: event.payload }]);
     if (!line) continue;
+    if (line.kind === "status" && line.title === "init") continue;
     if (line.kind === "text") opts.onLine(line.title);
     else if (line.kind === "error") opts.onLine(c.red(line.title));
     else opts.onLine(c.dim(`  ${line.title}`));
+    if (line.body) opts.onLine(c.dim(`    ${line.body}`));
   }
   clearInterval(ticker);
   await flush();
@@ -5563,6 +5619,20 @@ ${howToFix(connection) ?? ""}`.trim());
 function slugOf6(command) {
   return command.optsWithGlobals().workspace;
 }
+async function askLine(prompt2) {
+  const rl = createInterface3({ input: process.stdin, output: process.stderr });
+  try {
+    return await new Promise((resolve) => {
+      rl.once("close", () => resolve(""));
+      rl.question(prompt2).then(
+        (answer) => resolve(answer.trim()),
+        () => resolve("")
+      );
+    });
+  } finally {
+    rl.close();
+  }
+}
 function report(connection) {
   emit(
     { codex: connection },
@@ -5571,39 +5641,57 @@ ${howToFix(connection) ?? ""}`.trim()
   );
 }
 function registerArchitectCommands(program) {
-  program.command("plan").argument("[request...]", "what to plan, assess, or change").description("the architect: assess the repo, shape the work, tune the platform").option("--read-only", "let it look and propose, but change nothing").option("--resume", "continue the last architect session in this workspace").option("--allow-api-billing", "run even when Codex would bill per token instead of the subscription").action(async function(request) {
+  program.command("plan").argument("[request...]", "what to plan, assess, or change; omit for a conversation").description("the architect: assess the repo, shape the work, tune the platform").option("--read-only", "let it look and propose, but change nothing").option("--resume", "continue the last architect session in this workspace").option("--once", "run a single turn and exit, even without a request").option("--allow-api-billing", "run even when Codex would bill per token instead of the subscription").action(async function(request) {
     const opts = this.opts();
     const ctx = await requireWorkspace(slugOf6(this));
-    let ask = request.join(" ").trim();
-    if (!ask) {
-      if (!process.stdin.isTTY) fail("Give the architect something to do.");
-      const rl = createInterface3({ input: process.stdin, output: process.stderr });
-      try {
-        ask = (await rl.question(c.blue("plan> "))).trim();
-      } finally {
-        rl.close();
+    const first = request.join(" ").trim();
+    const conversational = !first && !opts.once && process.stdin.isTTY && !isJsonMode();
+    const turn = async (ask, resume2) => {
+      const lines = [];
+      const result = await runArchitect({
+        ctx,
+        request: ask,
+        readOnly: Boolean(opts.readOnly),
+        resume: resume2,
+        allowApiBilling: Boolean(opts.allowApiBilling),
+        onLine: (text) => {
+          lines.push(text);
+          if (!isJsonMode()) out(text);
+        }
+      });
+      return { result, lines };
+    };
+    if (!conversational) {
+      let ask = first;
+      if (!ask) {
+        if (!process.stdin.isTTY) fail("Give the architect something to do.");
+        ask = await askLine("plan> ");
+        if (!ask) fail("Nothing asked.");
       }
-      if (!ask) fail("Nothing asked.");
-    }
-    const lines = [];
-    const result = await runArchitect({
-      ctx,
-      request: ask,
-      readOnly: Boolean(opts.readOnly),
-      resume: Boolean(opts.resume),
-      allowApiBilling: Boolean(opts.allowApiBilling),
-      onLine: (text) => {
-        lines.push(text);
-        if (!isJsonMode()) out(text);
+      const { result, lines } = await turn(ask, Boolean(opts.resume));
+      if (isJsonMode()) {
+        emit(
+          { ok: result.exitCode === 0, run_id: result.runId, session_id: result.sessionId, output: lines },
+          () => ""
+        );
+        return;
+      }
+      if (result.sessionId) {
+        out(c.dim(`
+Continue with \`hd plan --resume "..."\`. Run ${result.runId.slice(0, 8)}.`));
       }
-    });
-    if (isJsonMode()) {
-      emit({ ok: result.exitCode === 0, run_id: result.runId, session_id: result.sessionId, output: lines }, () => "");
       return;
     }
-    if (result.sessionId) {
-      out(c.dim(`
-Continue with \`hd plan --resume "..."\`. Run ${result.runId.slice(0, 8)}.`));
+    out(c.dim("Talking to the architect. Enter sends, blank line or /exit leaves, ctrl-c stops a turn."));
+    let resume = Boolean(opts.resume);
+    for (; ; ) {
+      const ask = await askLine("\nplan> ");
+      if (!ask || ask === "/exit" || ask === "/quit") {
+        out(c.dim('Left the architect. `hd plan --resume "..."` picks the thread back up.'));
+        return;
+      }
+      const { result } = await turn(ask, resume);
+      if (result.sessionId) resume = true;
     }
   });
   program.command("mcp").description("serve the platform as MCP tools on stdio, for Codex, Claude Code, or Mel").option("--read-only", "expose only the tools that change nothing").option("--list", "print the tools instead of serving them").action(async function() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@higherdev/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "HigherDEV in your terminal. Full control of the board, live.",
   "bin": {