@higherdev/cli 0.11.0 → 0.12.0

package/README.md

@@ -14,7 +14,8 @@ Create `~/.config/hd/config.json` with an existing workspace API key:
 {
   "url": "https://hdx-higher-ops.vercel.app",
   "api_key": "hdx_...",
-  "current": "workspace"
+  "current": "workspace",
+  "repos": {}
 }
 ```
 
@@ -35,7 +36,9 @@ workspace-map config shapes are migrated automatically when they are read.
 | `hd ticket cancel KEY` | Cancel a ticket |
 | `hd epic new PATH [--title TITLE]` | Create an epic from a Markdown spec |
 | `hd epic list` | List epics and ticket progress |
-| `hd plan [--repo DIR]` | Hand the terminal to Codex to author an epic spec |
+| `hd epic approve ID` | Open a draft epic for orchestrator decomposition |
+| `hd epic rm ID` | Remove a draft epic |
+| `hd plan` | Point to the TUI `/architect` conversation |
 | `hd workspace ls` | List every workspace available to the configured key |
 | `hd workspace new --name NAME --repo OWNER/NAME [options]` | Preflight GitHub, wire the runner, and create a paused workspace |
 | `hd workspace set [options]` | Update settings; max turns uses `--max-turns KIND=N[,KIND=N...]` |
@@ -61,7 +64,7 @@ the repository is missing, approve private creation interactively, use `--create
 `--no-create` to fail. Fully flagged calls remain non-interactive for scripts and Mel.
 
 Inside the TUI, use `/board`, `/inbox`, `/ticket`, `/queue`, `/cancel`, `/epic new`,
-`/epics`, `/plan`, `/decide`, `/agents add`, `/agents rm`, `/settings`, `/workspace`,
+`/epic approve`, `/epics`, `/architect` (or `/plan`), `/decide`, `/agents add`, `/agents rm`, `/settings`, `/workspace`,
 `/workspace new`, `/workspace set`, `/workspace rotate-key`, `/feed`,
-`/orchestrator`, `/refresh`, `/help`, or `/exit`. The display refreshes from
+`/on`, `/off`, `/orchestrator`, `/refresh`, `/help`, or `/exit`. The display refreshes from
 the HDX API every five seconds.

package/dist/api.js

@@ -4,7 +4,7 @@ export function apiErrorMessage(status, parsed, fallback) {
     const raw = parsed && typeof parsed === "object" && "error" in parsed
         && typeof parsed.error === "string"
         ? parsed.error : fallback;
-    const duplicate = raw.match(/agents_one_enabled_(orchestrator|reviewer)_idx/i)?.[1]?.toLowerCase();
+    const duplicate = raw.match(/agents_one_enabled_(architect|orchestrator|reviewer)_idx/i)?.[1]?.toLowerCase();
     if (duplicate) {
         return `hd: ${status} Only one enabled ${duplicate} is allowed per workspace. Disable the current ${duplicate} before enabling another.`;
     }
@@ -111,6 +111,12 @@ export async function listEpics(config = loadConfig()) {
 export async function createEpic(fields, config = loadConfig()) {
     return request(config, "POST", `/api/w/${config.slug}/epics`, fields);
 }
+export async function approveEpic(id, config = loadConfig()) {
+    return request(config, "PATCH", `/api/w/${config.slug}/epics`, { id });
+}
+export async function deleteEpic(id, config = loadConfig()) {
+    return request(config, "DELETE", `/api/w/${config.slug}/epics`, { id });
+}
 export async function listMessages(options = {}, config = loadConfig()) {
     const query = new URLSearchParams();
     if (options.ticketId)

package/dist/config.js

@@ -16,6 +16,11 @@ function normalizeConnection(value) {
 function missing(path) {
     return new Error(`missing ${path}\nWrite { "url": "https://hdx-higher-ops.vercel.app", "api_key": "hdx_...", "current": "workspace" }`);
 }
+function normalizeRepos(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return {};
+    return Object.fromEntries(Object.entries(value).filter((entry) => Boolean(entry[0]) && typeof entry[1] === "string" && Boolean(entry[1])));
+}
 export function loadStoredConfig(path = configPath()) {
     let raw;
     try {
@@ -27,13 +32,14 @@ export function loadStoredConfig(path = configPath()) {
     const parsed = JSON.parse(raw);
     const connection = normalizeConnection(parsed);
     const current = typeof parsed.current === "string" ? parsed.current : "";
+    const repos = normalizeRepos(parsed.repos);
     if (connection && current)
-        return { ...connection, current };
+        return { ...connection, current, repos };
     // 0.4 stored one workspace at the top level with `slug` rather than
     // `current`. One key can now reach every workspace, so only the selected
     // slug needs to survive.
     if (connection && typeof parsed.slug === "string" && parsed.slug) {
-        const migrated = { ...connection, current: parsed.slug };
+        const migrated = { ...connection, current: parsed.slug, repos };
         writeStoredConfig(migrated, path);
         return migrated;
     }
@@ -46,7 +52,7 @@ export function loadStoredConfig(path = configPath()) {
     const selected = normalizeConnection(source[current]);
     if (!selected)
         throw new Error(`${path} current workspace ${current} is not configured`);
-    const migrated = { ...selected, current };
+    const migrated = { ...selected, current, repos };
     writeStoredConfig(migrated, path);
     return migrated;
 }
@@ -62,10 +68,16 @@ export function writeStoredConfig(config, path = configPath()) {
 }
 /** Store one operator connection and make its selected workspace current. */
 export function writeHdConfig(config, path = configPath()) {
+    let repos = {};
+    try {
+        repos = loadStoredConfig(path).repos;
+    }
+    catch { }
     writeStoredConfig({
         url: config.url.replace(/\/$/, ""),
         api_key: config.api_key,
         current: config.slug,
+        repos,
     }, path);
 }
 export function switchWorkspace(slug, path = configPath()) {
@@ -73,3 +85,7 @@ export function switchWorkspace(slug, path = configPath()) {
     writeStoredConfig({ ...stored, current: slug }, path);
     return { url: stored.url, api_key: stored.api_key, slug };
 }
+export function rememberWorkspaceRepo(slug, directory, path = configPath()) {
+    const stored = loadStoredConfig(path);
+    writeStoredConfig({ ...stored, repos: { ...stored.repos, [slug]: directory } }, path);
+}

package/dist/index.js

@@ -1,12 +1,11 @@
 #!/usr/bin/env node
 import { realpathSync } from "node:fs";
 import { pathToFileURL } from "node:url";
-import { answerDecision, cancelTicket, createAgent, createEpic, createTicket, deleteAgent, getStatus, listAgents, listEpics, listTicketEvents, listTickets, listWorkspaces, postMessage, queueTicket, setPaused, showTicket, updateAgent, updateCaps, } from "./api.js";
+import { approveEpic, answerDecision, cancelTicket, createAgent, createEpic, createTicket, deleteAgent, deleteEpic, getStatus, listAgents, listEpics, listTicketEvents, listTickets, listWorkspaces, postMessage, queueTicket, setPaused, showTicket, updateAgent, updateCaps, } from "./api.js";
 import { initHost, parseHostFlags } from "./host.js";
 import { loadConfig } from "./config.js";
 import { epicProgressRows, readEpicSpec } from "./epics.js";
 import { banner, c, statusChip, table, truncate, usage } from "./out.js";
-import { launchArchitect } from "./plan.js";
 import { WORKSPACE_USAGE, workspaceNew, workspaceRotateKey, workspaceSet } from "./workspace-commands.js";
 function fail(message) {
     console.error(message);
@@ -153,15 +152,26 @@ async function cmdEpic(argv) {
         console.log(`${c.bold(epic.id)}  ${statusChip(epic.status)}  ${epic.title}`);
         return;
     }
-    fail("usage: hd epic new PATH [--title TITLE] | list");
+    if (action === "approve" || action === "rm") {
+        const id = rest[0];
+        if (!id || rest.length !== 1)
+            fail(`usage: hd epic ${action} ID`);
+        if (action === "approve") {
+            const { epic } = await approveEpic(id);
+            console.log(`${c.bold(epic.id)}  ${statusChip(epic.status)}  ${epic.title}`);
+        }
+        else {
+            await deleteEpic(id);
+            console.log(`removed ${id}`);
+        }
+        return;
+    }
+    fail("usage: hd epic new PATH [--title TITLE] | list | approve ID | rm ID");
 }
 async function cmdPlan(argv) {
-    const { rest, opts, bools } = flags(argv);
-    if (rest.length || bools.size || Object.keys(opts).some((key) => key !== "repo")) {
-        fail("usage: hd plan [--repo DIR]");
-    }
-    const { workspace } = await getStatus();
-    await launchArchitect({ workspaceRepo: workspace.repo, repo: opts.repo });
+    if (argv.length)
+        fail("usage: hd plan");
+    console.log("Open the HDX TUI and use /architect (or /plan).");
 }
 async function cmdLogs(argv) {
     const { rest, bools } = flags(argv);

package/dist/out.js

@@ -65,8 +65,8 @@ export function usage() {
         c.bold("Usage"),
         `  ${c.blue("hd status")}                         workspace overview`,
         `  ${c.blue("hd ticket list | show | new | queue | cancel")} ticket operations`,
-        `  ${c.blue("hd epic new PATH | list")}            epic operations`,
-        `  ${c.blue("hd plan [--repo DIR]")}               author an epic with Codex`,
+        `  ${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 | new | set | rotate-key")} workspace operations`,
         `  ${c.blue("hd agents [add | rm | set]")}         manage agents`,
         `  ${c.blue("hd caps [set PROVIDER N]")}           provider concurrency`,

package/dist/prompt.js

@@ -0,0 +1,13 @@
+import { createInterface } from "node:readline/promises";
+export async function promptOnStdin(question, resumeStdin = false) {
+    const prompt = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        return await prompt.question(question);
+    }
+    finally {
+        prompt.close();
+        // Ink restores raw mode and listeners, but it cannot read a paused stream.
+        if (resumeStdin)
+            process.stdin.resume();
+    }
+}

package/dist/tui/App.js

@@ -3,7 +3,7 @@ import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Box, Static, Text, useApp, useInput, useStdout } from "ink";
 import { loadConfig } from "../config.js";
 import { epicProgressRows } from "../epics.js";
-import { launchArchitect } from "../plan.js";
+import { promptOnStdin } from "../prompt.js";
 import { workspaceNew, workspaceRotateKey, workspaceSet } from "../workspace-commands.js";
 import { Banner } from "./Banner.js";
 import { Bubble } from "./Bubble.js";
@@ -18,13 +18,14 @@ import { alertOnce } from "./alert.js";
 import { bubbleRows } from "./height.js";
 import { planLayout, splitPanels } from "./layout.js";
 import { parseLine } from "./parse.js";
-import { configuredSlugs, cancelTicket, createAgent, createEpicFromFile, decisionOptions, deleteAgent, loadLiveEvents, loadTicketDetail, pollSnapshot, postOrchestrator, queueTicket, resolveDecision, switchWorkspace, updateAgent, updateProviderCap, updateWorkspace, } from "./data.js";
+import { configuredSlugs, approveEpic, cancelTicket, createAgent, createEpicFromFile, decisionOptions, deleteAgent, loadLiveEvents, loadTicketDetail, pollSnapshot, postAgentMessage, queueTicket, resolveDecision, setWorkspacePaused, switchWorkspace, updateAgent, updateProviderCap, updateWorkspace, } from "./data.js";
 import { editFor, editableKeys, nextValue, seedFor, settingsRows } from "./settings-model.js";
 import { appendLines, runLabels, toStreamLines } from "./stream.js";
 import { UI } from "./theme.js";
 import { WorkspaceLoads } from "./workspace-load.js";
 let messageSeq = 0;
 const nextId = () => `m${messageSeq++}`;
+const tuiPrompt = (question) => promptOnStdin(question, true);
 export function App({ initial }) {
     const { exit, suspendTerminal } = useApp();
     const { stdout } = useStdout();
@@ -191,18 +192,18 @@ export function App({ initial }) {
             setBusy(false);
         }
     }, [config, say]);
-    const askOrchestrator = useCallback(async (text) => {
+    const askAgent = useCallback(async (role, text) => {
         setBusy(true);
         const id = nextId();
-        setMessages((prior) => [...prior, { id, speaker: "orchestrator", body: "", pending: true }]);
+        setMessages((prior) => [...prior, { id, speaker: role, body: "", pending: true }]);
         const since = new Date().toISOString();
         try {
-            await postOrchestrator(text, config);
+            await postAgentMessage(role, text, config);
             setMessages((prior) => prior.map((message) => message.id === id
                 ? { ...message, steps: ["· queued, it answers on the next tick"] }
                 : message));
             const { waitForReply } = await import("./data.js");
-            const reply = await waitForReply(config, since, 180_000);
+            const reply = await waitForReply(config, role, since, 180_000);
             setMessages((prior) => prior.map((message) => message.id === id
                 ? { ...message, body: reply ?? "No reply yet. It will land in /inbox.", pending: false, steps: [] }
                 : message));
@@ -256,18 +257,20 @@ export function App({ initial }) {
         const action = parseLine(text);
         if (action.kind === "say") {
             say("you", text);
-            if (mode === "orchestrator")
-                await askOrchestrator(text);
+            if (mode !== "browse")
+                await askAgent(mode, text);
             else
-                setNotice("Use /orchestrator before sending a message.");
+                setNotice("Use /architect or /orchestrator before sending a message.");
             return;
         }
         switch (action.kind) {
             case "mode":
-                setMode("orchestrator");
+                setMode(action.mode);
                 setCursor(null);
                 selectedRef.current = null;
-                say("system", "Talking to the orchestrator. It moves work already in flight.");
+                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.");
                 return;
             case "view":
                 setView(action.view);
@@ -305,7 +308,7 @@ export function App({ initial }) {
                 try {
                     if (action.command === "new") {
                         let created;
-                        await suspendTerminal(async () => { created = await workspaceNew(action.args); });
+                        await suspendTerminal(async () => { created = await workspaceNew(action.args, { prompt: tuiPrompt }); });
                         if (!created)
                             throw new Error("Workspace wizard did not finish.");
                         await changeWorkspace(created.slug, loadConfig());
@@ -361,6 +364,20 @@ export function App({ initial }) {
                     setBusy(false);
                 }
                 return;
+            case "epic-approve":
+                setBusy(true);
+                try {
+                    const { epic } = await approveEpic(config, action.id);
+                    say("system", `Approved epic ${epic.id}: ${epic.title}`);
+                    await refresh();
+                }
+                catch (error) {
+                    setNotice(error instanceof Error ? error.message : String(error));
+                }
+                finally {
+                    setBusy(false);
+                }
+                return;
             case "epics": {
                 const rows = epicProgressRows(board.epics, board.tickets);
                 say("system", rows.length
@@ -368,6 +385,20 @@ export function App({ initial }) {
                     : "No epics.");
                 return;
             }
+            case "paused":
+                setBusy(true);
+                try {
+                    await setWorkspacePaused(config, action.paused);
+                    say("system", `${workspace.slug} is now ${action.paused ? "off" : "on"}.`);
+                    await refresh();
+                }
+                catch (error) {
+                    setNotice(error instanceof Error ? error.message : String(error));
+                }
+                finally {
+                    setBusy(false);
+                }
+                return;
             case "queue":
                 setBusy(true);
                 try {
@@ -431,20 +462,6 @@ export function App({ initial }) {
                 }
                 return;
             }
-            case "plan":
-                setBusy(true);
-                try {
-                    await suspendTerminal(() => launchArchitect({ workspaceRepo: workspace.repo }));
-                    say("system", "Architect session ended. Review the spec, then run /epic new PATH.");
-                    await refresh();
-                }
-                catch (error) {
-                    setNotice(error instanceof Error ? error.message : String(error));
-                }
-                finally {
-                    setBusy(false);
-                }
-                return;
             case "decide": {
                 const decision = board.decisions[0];
                 if (!decision) {
@@ -491,8 +508,8 @@ export function App({ initial }) {
             default:
                 return;
         }
-    }, [view, settings, applyEdit, board, browsing, mode, say, askOrchestrator, order, settingsOrder, changeWorkspace,
-        config, workspace.repo, refresh, suspendTerminal, exit]);
+    }, [view, settings, applyEdit, board, browsing, mode, say, askAgent, order, settingsOrder, changeWorkspace,
+        config, refresh, suspendTerminal, exit]);
     useInput((input, key) => {
         if (key.ctrl && input === "c")
             exit();
@@ -534,7 +551,7 @@ export function App({ initial }) {
                                 setDraft(next);
                                 if (editingRef.current)
                                     setEditing({ key: editingRef.current.key, draft: next });
-                            }, onSubmit: (value) => void run(value), isActive: !busy, placeholder: busy ? "working…" : "message, or /help", prompt: _jsx(Text, { color: mode === "browse" ? UI.dim : UI.cream, children: mode === "orchestrator" ? "orchestrator> " : "> " }), color: UI.text, onCancel: () => {
+                            }, onSubmit: (value) => void run(value), isActive: !busy, placeholder: busy ? "working…" : "message, or /help", prompt: _jsx(Text, { color: mode === "browse" ? UI.dim : UI.cream, children: mode === "browse" ? "> " : `${mode}> ` }), color: UI.text, onCancel: () => {
                                 if (editing) {
                                     setEditing(null);
                                     setDraft("");

package/dist/tui/Help.js

@@ -10,13 +10,16 @@ export const COMMANDS = [
     { name: "/ticket", args: "HD-12", help: "open one ticket" },
     { name: "/queue", args: "HD-12", help: "queue a complete ticket now" },
     { name: "/cancel", args: "HD-12", help: "cancel a ticket" },
-    { name: "/epic", args: "new PATH", help: "create an epic from a Markdown spec" },
+    { name: "/epic", args: "new PATH | approve ID", help: "create or approve a draft epic" },
     { name: "/epics", help: "list epics and ticket progress" },
-    { name: "/plan", help: "author an epic with your Codex CLI" },
+    { name: "/architect", help: "talk to the agent that shapes draft epics" },
+    { name: "/plan", help: "alias for /architect" },
     { name: "/decide", args: "2 | text", help: "answer the decision on screen" },
     { name: "/agents", args: "[add ... | rm ROLE|ID]", help: "view or manage agents" },
     { name: "/settings", help: "change provider caps and agent settings" },
     { name: "/workspace", args: "[slug | new | set | rotate-key]", help: "list, switch, create, or configure" },
+    { 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: "/refresh", help: "reload the board now" },

package/dist/tui/data.js

@@ -1,4 +1,4 @@
-import { answerDecision, cancelTicket as cancelTicketNow, createAgent as postAgent, createEpic as postEpic, getStatus, getWorkspace, listAgents, listEpics, listFeed, listMessages, listTicketEvents, listTickets, listWorkspaces, postMessage as sendMessage, queueTicket as queueTicketNow, 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, getStatus, getWorkspace, listAgents, listEpics, listFeed, listMessages, listTicketEvents, 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";
 export const POLL_MS = 5_000;
@@ -106,8 +106,8 @@ export async function switchWorkspace(slug, config = loadConfig()) {
     selectWorkspace(slug);
     return snapshot;
 }
-export async function postOrchestrator(body, config) {
-    await sendMessage({ body_md: body, to_role: "orchestrator", delivery: "queue" }, config);
+export async function postAgentMessage(role, body, config) {
+    await sendMessage({ body_md: body, to_role: role, delivery: "queue" }, config);
 }
 export async function loadTicketDetail(config, key) {
     return showTicket(key, config);
@@ -115,23 +115,29 @@ export async function loadTicketDetail(config, key) {
 export async function createEpicFromFile(config, path) {
     return postEpic(await readEpicSpec(path), config);
 }
+export async function approveEpic(config, id) {
+    return approveEpicNow(id, config);
+}
 export async function queueTicket(config, key) {
     return queueTicketNow(key, config);
 }
 export async function cancelTicket(config, key) {
     return cancelTicketNow(key, config);
 }
+export async function setWorkspacePaused(config, paused) {
+    return setPausedNow(paused, config);
+}
 export async function createAgent(config, fields) {
     return postAgent(fields, config);
 }
 export async function deleteAgent(config, id) {
     return removeAgent(id, config);
 }
-export async function waitForReply(config, since, timeoutMs) {
+export async function waitForReply(config, role, since, timeoutMs) {
     const deadline = Date.now() + timeoutMs;
     while (Date.now() <= deadline) {
         const { messages } = await listMessages({ since, limit: 50 }, config);
-        const reply = messages.find((message) => ["orchestrator", "reviewer"].includes(message.from_role) &&
+        const reply = messages.find((message) => message.from_role === role &&
             ["human", "operator", "all"].includes(message.to_role));
         if (reply)
             return reply.body_md;

package/dist/tui/parse.js

@@ -13,6 +13,10 @@ export function parseLine(raw) {
     switch (word.toLowerCase()) {
         case "orchestrator":
             return { kind: "mode", mode: "orchestrator" };
+        case "architect":
+        case "plan":
+            return rest.length ? { kind: "unknown", command: `${word.toLowerCase()} takes no arguments` }
+                : { kind: "mode", mode: "architect" };
         case "board":
         case "feed":
         case "inbox":
@@ -48,11 +52,18 @@ export function parseLine(raw) {
                 ? { kind: "ticket", key: argument.toUpperCase() }
                 : { kind: "unknown", command: "ticket needs a key" };
         case "epic":
-            return rest[0]?.toLowerCase() === "new" && rest.length > 1
-                ? { kind: "epic-new", path: rest.slice(1).join(" ") }
-                : { kind: "unknown", command: "epic needs new PATH" };
+            if (rest[0]?.toLowerCase() === "new" && rest.length > 1) {
+                return { kind: "epic-new", path: rest.slice(1).join(" ") };
+            }
+            return rest[0]?.toLowerCase() === "approve" && rest.length === 2
+                ? { kind: "epic-approve", id: rest[1] }
+                : { kind: "unknown", command: "epic needs new PATH or approve ID" };
         case "epics":
             return { kind: "epics" };
+        case "on":
+        case "off":
+            return rest.length ? { kind: "unknown", command: `${word.toLowerCase()} takes no arguments` }
+                : { kind: "paused", paused: word.toLowerCase() === "off" };
         case "queue":
             return argument
                 ? { kind: "queue", key: argument.toUpperCase() }
@@ -60,8 +71,6 @@ export function parseLine(raw) {
         case "cancel":
             return argument ? { kind: "cancel", key: argument.toUpperCase() }
                 : { kind: "unknown", command: "cancel needs a key" };
-        case "plan":
-            return argument ? { kind: "unknown", command: "plan takes no arguments" } : { kind: "plan" };
         case "decide": {
             const dismiss = /(^|\s)--(skip|dismiss)(\s|$)/.test(argument);
             return {

package/dist/tui/theme.js

@@ -40,11 +40,12 @@ export function speakerStyle(speaker) {
         case "you":
             return { borderStyle: DOTTED, borderColor: UI.cream, label: "you" };
         case "orchestrator":
+        case "architect":
             return {
                 borderStyle: THIN,
                 borderColor: UI.orchestratorBorder,
                 backgroundColor: UI.orchestratorBg,
-                label: "orchestrator",
+                label: speaker,
             };
         default:
             return { borderStyle: DOTTED, borderColor: UI.dim, label: "" };

package/dist/workspace-commands.js

@@ -1,6 +1,6 @@
-import { createInterface } from "node:readline/promises";
 import { createWorkspace, rotateWorkspaceApiKey, updateWorkspace } from "./api.js";
 import { loadConfig, writeHdConfig } from "./config.js";
+import { promptOnStdin } from "./prompt.js";
 import { defaultGh, HDX_RUNNER_GH_USER, preflightWorkspace } from "./workspace-preflight.js";
 export const WORKSPACE_USAGE = "usage: hd workspace ls | new --name NAME --repo OWNER/NAME [--create|--no-create] [flags] | set [flags] | rotate-key";
 function flags(argv) {
@@ -44,12 +44,7 @@ async function repoState(repo, gh) {
     }
 }
 function lazyPrompt(deps) {
-    let readline;
-    const ask = deps.prompt ?? (async (question) => {
-        readline ??= createInterface({ input: process.stdin, output: process.stdout });
-        return readline.question(question);
-    });
-    return { ask, close: () => readline?.close() };
+    return deps.prompt ?? promptOnStdin;
 }
 async function askDefault(ask, label, fallback = "") {
     const answer = (await ask(`${label}${fallback ? ` [${fallback}]` : ""}: `)).trim();
@@ -65,7 +60,7 @@ export async function workspaceNew(argv, deps = {}) {
         throw new Error(WORKSPACE_USAGE);
     const gh = deps.gh ?? defaultGh;
     const prompt = lazyPrompt(deps);
-    try {
+    {
         let name = opts.name ?? "";
         let repo = opts.repo ?? "";
         let branch = opts.branch;
@@ -79,7 +74,7 @@ export async function workspaceNew(argv, deps = {}) {
             }
         }
         if (guided) {
-            name = await askDefault(prompt.ask, "Name", name);
+            name = await askDefault(prompt, "Name", name);
             if (!name)
                 throw new Error("Name is required.");
             let defaultRepo = repo;
@@ -87,7 +82,7 @@ export async function workspaceNew(argv, deps = {}) {
                 const owner = (await gh(["api", "user", "--jq", ".login"])).trim();
                 defaultRepo = `${owner}/${workspaceSlug(name)}`;
             }
-            repo = await askDefault(prompt.ask, "Repo", defaultRepo);
+            repo = await askDefault(prompt, "Repo", defaultRepo);
             if (!repo)
                 throw new Error("Repo is required.");
         }
@@ -97,17 +92,17 @@ export async function workspaceNew(argv, deps = {}) {
         if (state && !state.found) {
             if (bools.has("no-create"))
                 throw new Error(`GitHub repository ${repo} does not exist and --no-create was set.`);
-            const create = bools.has("create") || (interactive && yes(await prompt.ask(`Create ${repo} as a private GitHub repo? [Y/n] `)));
+            const create = bools.has("create") || (interactive && yes(await prompt(`Create ${repo} as a private GitHub repo? [Y/n] `)));
             if (!create)
                 throw new Error(`GitHub repository ${repo} was not created.`);
             await gh(["repo", "create", repo, "--private"]);
             state = { found: true, branch: "main" };
         }
         if (guided) {
-            branch = await askDefault(prompt.ask, "Branch", branch ?? state?.branch ?? "main");
-            host = await askDefault(prompt.ask, "Host", host);
+            branch = await askDefault(prompt, "Branch", branch ?? state?.branch ?? "main");
+            host = await askDefault(prompt, "Host", host);
             const summary = `${name} | ${repo} | ${branch} | host ${host}`;
-            if (!yes(await prompt.ask(`Create ${summary}. Proceed? [Y/n] `)))
+            if (!yes(await prompt(`Create ${summary}. Proceed? [Y/n] `)))
                 throw new Error("Workspace creation cancelled.");
         }
         const preflight = await (deps.preflightWorkspace ?? preflightWorkspace)({
@@ -122,9 +117,6 @@ export async function workspaceNew(argv, deps = {}) {
             runnerUser: opts["runner-user"] ?? HDX_RUNNER_GH_USER,
             initCommand: `hd init --url ${result.url} --api-key ${result.api_key} --slug ${result.workspace.slug}` };
     }
-    finally {
-        prompt.close();
-    }
 }
 export async function workspaceSet(argv) {
     const { opts, bools, rest } = flags(argv);

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@higherdev/cli",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "type": "module",
   "bin": {
     "hd": "dist/index.js"
   },
   "main": "dist/index.js",
   "files": [
-    "dist",
-    "prompts"
+    "dist"
   ],
   "scripts": {
     "build": "tsc",
     "test": "pnpm build && node --experimental-strip-types --test test/*.test.ts",
+    "test:pty": "pnpm build && expect test/tui-prompt.expect",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {

package/dist/plan.js

@@ -1,94 +0,0 @@
-import { spawn, spawnSync } from "node:child_process";
-import { readFile } from "node:fs/promises";
-import { homedir } from "node:os";
-import { isAbsolute, join, resolve } from "node:path";
-import { createInterface } from "node:readline/promises";
-const ARCHITECT_PROMPT = new URL("../prompts/architect.md", import.meta.url);
-function gitOutput(cwd, args) {
-    const result = spawnSync("git", args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
-    return result.status === 0 ? result.stdout.trim() : null;
-}
-export function remoteRepo(remote) {
-    const trimmed = remote.trim().replace(/\/$/, "").replace(/\.git$/, "");
-    const scp = trimmed.match(/^[^@]+@[^:]+:(.+)$/);
-    if (scp)
-        return scp[1] ?? null;
-    try {
-        const url = new URL(trimmed);
-        return url.pathname.replace(/^\//, "") || null;
-    }
-    catch {
-        return trimmed.includes("/") ? trimmed : null;
-    }
-}
-function expanded(path) {
-    const value = path.trim();
-    if (value === "~")
-        return homedir();
-    if (value.startsWith("~/"))
-        return join(homedir(), value.slice(2));
-    return isAbsolute(value) ? value : resolve(value);
-}
-export function matchingWorkspaceRepo(directory, workspaceRepo) {
-    const root = gitOutput(expanded(directory), ["rev-parse", "--show-toplevel"]);
-    if (!root)
-        return null;
-    const origin = gitOutput(root, ["remote", "get-url", "origin"]);
-    return origin && remoteRepo(origin)?.toLowerCase() === workspaceRepo.toLowerCase() ? root : null;
-}
-async function askForRepo(workspaceRepo) {
-    if (!process.stdin.isTTY || !process.stdout.isTTY) {
-        throw new Error(`Current directory is not ${workspaceRepo}. Pass --repo DIR.`);
-    }
-    const prompt = createInterface({ input: process.stdin, output: process.stdout });
-    try {
-        return (await prompt.question(`Repository directory for ${workspaceRepo}: `)).trim();
-    }
-    finally {
-        prompt.close();
-    }
-}
-export async function resolveWorkspaceRepo(workspaceRepo, requested) {
-    if (requested) {
-        const match = matchingWorkspaceRepo(requested, workspaceRepo);
-        if (!match)
-            throw new Error(`${requested} is not a checkout of ${workspaceRepo}.`);
-        return match;
-    }
-    const current = matchingWorkspaceRepo(process.cwd(), workspaceRepo);
-    if (current)
-        return current;
-    const answer = await askForRepo(workspaceRepo);
-    if (!answer)
-        throw new Error("A repository directory is required.");
-    const match = matchingWorkspaceRepo(answer, workspaceRepo);
-    if (!match)
-        throw new Error(`${answer} is not a checkout of ${workspaceRepo}.`);
-    return match;
-}
-export function verifyCodex(checkVersion = () => spawnSync("codex", ["--version"], { stdio: "ignore" })) {
-    const check = checkVersion();
-    if (check.error || check.status !== 0) {
-        throw new Error("Codex CLI is unavailable. Install it if needed, then run `codex login`.");
-    }
-}
-function runCodex(cwd, prompt) {
-    return new Promise((resolveRun, rejectRun) => {
-        const child = spawn("codex", [prompt], { cwd, stdio: "inherit" });
-        child.once("error", rejectRun);
-        child.once("exit", (code, signal) => {
-            if (code === 0)
-                resolveRun();
-            else
-                rejectRun(new Error(`codex exited ${signal ? `with signal ${signal}` : `with status ${code ?? "unknown"}`}.`));
-        });
-    });
-}
-export async function launchArchitect(options, runtime = {}) {
-    (runtime.verifyCodex ?? verifyCodex)();
-    const [cwd, prompt] = await Promise.all([
-        resolveWorkspaceRepo(options.workspaceRepo, options.repo),
-        readFile(ARCHITECT_PROMPT, "utf8"),
-    ]);
-    await (runtime.invokeCodex ?? runCodex)(cwd, prompt);
-}

package/prompts/architect.md

@@ -1,23 +0,0 @@
-You are helping the operator author an HDX epic for this repository.
-
-Start by interviewing the operator about the goal. Ask focused questions until the intended outcome, boundaries, and important tradeoffs are clear. Read the repository as needed so the plan reflects the code that actually exists.
-
-Draft the epic in this exact structure:
-
-# <title>
-
-## Goal
-
-## Scope
-
-## Out of scope
-
-## Acceptance
-
-## Constraints
-
-The operator is the author. Let them review and revise the draft before saving it. Do not submit the epic to HDX yourself.
-
-Once the operator accepts the spec, write it to `docs/epics/<slug>.md`, where `<slug>` is a concise kebab-case name for the epic. End by printing the exact next command, with the real path substituted:
-
-`hd epic new docs/epics/<slug>.md`