@higherdev/cli 0.11.1 → 0.12.0

package/README.md

@@ -36,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] [--clone-root 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,12 +63,8 @@ branch, bootstraps an empty repository unless `--no-bootstrap` is set, and invit
 the repository is missing, approve private creation interactively, use `--create` to force it, or
 `--no-create` to fail. Fully flagged calls remain non-interactive for scripts and Mel.
 
-`hd plan` remembers a matching checkout per workspace. If none exists, it offers to clone into
-`~/HigherDEV/<slug>`; change the parent with `--clone-root DIR`. An explicit `--repo DIR` is saved
-after its Git origin is verified.
-
 Inside the TUI, use `/board`, `/inbox`, `/ticket`, `/queue`, `/cancel`, `/epic new`,
-`/epics`, `/plan [--repo DIR]`, `/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/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,18 +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) => !["repo", "clone-root"].includes(key))) {
-        fail("usage: hd plan [--repo DIR] [--clone-root DIR]");
-    }
-    const { workspace } = await getStatus();
-    const result = await launchArchitect({ workspaceRepo: workspace.repo, workspaceSlug: workspace.slug,
-        repo: opts.repo, cloneRoot: opts["clone-root"] });
-    if (result.cloneCommand)
-        console.log(`Clone it with: ${result.cloneCommand}`);
+    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] [--clone-root 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/tui/App.js

@@ -3,7 +3,6 @@ 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";
@@ -19,7 +18,7 @@ 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";
@@ -193,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));
@@ -258,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);
@@ -363,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
@@ -370,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 {
@@ -433,32 +462,6 @@ export function App({ initial }) {
                 }
                 return;
             }
-            case "plan":
-                setBusy(true);
-                try {
-                    let result;
-                    await suspendTerminal(async () => {
-                        result = await launchArchitect({
-                            workspaceRepo: workspace.repo, workspaceSlug: workspace.slug,
-                            repo: action.repo, cloneRoot: action.cloneRoot,
-                        }, { prompt: tuiPrompt });
-                    });
-                    if (!result)
-                        throw new Error("Architect did not finish.");
-                    if (result.cloneCommand)
-                        say("system", `Clone it with: ${result.cloneCommand}`);
-                    else {
-                        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) {
@@ -505,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();
@@ -548,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", args: "[--repo DIR]", 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,20 +71,6 @@ export function parseLine(raw) {
         case "cancel":
             return argument ? { kind: "cancel", key: argument.toUpperCase() }
                 : { kind: "unknown", command: "cancel needs a key" };
-        case "plan": {
-            const opts = {};
-            for (let i = 0; i < rest.length; i += 2) {
-                if (!rest[i]?.startsWith("--") || !rest[i + 1]) {
-                    return { kind: "unknown", command: "plan accepts --repo DIR and --clone-root DIR" };
-                }
-                opts[rest[i].slice(2)] = rest[i + 1];
-            }
-            if (Object.keys(opts).some((key) => !["repo", "clone-root"].includes(key))) {
-                return { kind: "unknown", command: "plan accepts --repo DIR and --clone-root DIR" };
-            }
-            return { kind: "plan", ...(opts.repo ? { repo: opts.repo } : {}),
-                ...(opts["clone-root"] ? { cloneRoot: opts["clone-root"] } : {}) };
-        }
         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/package.json

@@ -1,14 +1,13 @@
 {
   "name": "@higherdev/cli",
-  "version": "0.11.1",
+  "version": "0.12.0",
   "type": "module",
   "bin": {
     "hd": "dist/index.js"
   },
   "main": "dist/index.js",
   "files": [
-    "dist",
-    "prompts"
+    "dist"
   ],
   "scripts": {
     "build": "tsc",

package/dist/plan.js

@@ -1,118 +0,0 @@
-import { spawn, spawnSync } from "node:child_process";
-import { mkdirSync } from "node:fs";
-import { readFile } from "node:fs/promises";
-import { homedir } from "node:os";
-import { isAbsolute, join, resolve } from "node:path";
-import { loadStoredConfig, rememberWorkspaceRepo } from "./config.js";
-import { promptOnStdin } from "./prompt.js";
-import { defaultGh } from "./workspace-preflight.js";
-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, home = homedir(), cwd = process.cwd()) {
-    const value = path.trim();
-    if (value === "~")
-        return home;
-    if (value.startsWith("~/"))
-        return join(home, value.slice(2));
-    return isAbsolute(value) ? value : resolve(cwd, 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;
-}
-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"}`}.`));
-        });
-    });
-}
-function shellPath(path) {
-    return /^[A-Za-z0-9_./~-]+$/.test(path) ? path : `'${path.replaceAll("'", "'\\''")}'`;
-}
-export async function resolveWorkspaceRepo(options, runtime = {}) {
-    const matchRepo = runtime.matchRepo ?? matchingWorkspaceRepo;
-    const cwd = runtime.cwd?.() ?? process.cwd();
-    const home = runtime.home?.() ?? homedir();
-    const saveRepo = runtime.saveRepo ?? rememberWorkspaceRepo;
-    const accept = (directory) => {
-        saveRepo(options.workspaceSlug, directory);
-        return { directory };
-    };
-    if (options.repo) {
-        const match = matchRepo(options.repo, options.workspaceRepo);
-        if (!match)
-            throw new Error(`${options.repo} is not a checkout of ${options.workspaceRepo}.`);
-        return accept(match);
-    }
-    const saved = (runtime.savedRepo ?? ((slug) => loadStoredConfig().repos[slug]))(options.workspaceSlug);
-    if (saved) {
-        const match = matchRepo(saved, options.workspaceRepo);
-        if (match)
-            return { directory: match };
-    }
-    const current = matchRepo(cwd, options.workspaceRepo);
-    if (current)
-        return accept(current);
-    const defaultRoot = "~/HigherDEV";
-    const rootInput = options.cloneRoot ?? defaultRoot;
-    const root = expanded(rootInput, home, cwd);
-    const destination = join(root, options.workspaceSlug);
-    const shownDestination = join(rootInput, options.workspaceSlug);
-    const cloneCommand = `gh repo clone ${options.workspaceRepo} ${shellPath(shownDestination)}`;
-    const interactive = runtime.isTTY ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
-    if (!interactive || ["n", "no"].includes((await (runtime.prompt ?? promptOnStdin)(`Clone ${options.workspaceRepo} to ${shownDestination}? [Y/n] `)).trim().toLowerCase()))
-        return { cloneCommand };
-    const gh = runtime.gh ?? defaultGh;
-    try {
-        await gh(["--version"]);
-    }
-    catch {
-        throw new Error("GitHub CLI is unavailable. Install it if needed, then run `gh auth login`.");
-    }
-    (runtime.mkdir ?? ((path) => mkdirSync(path, { recursive: true })))(root);
-    await gh(["repo", "clone", options.workspaceRepo, destination]);
-    const cloned = matchRepo(destination, options.workspaceRepo);
-    if (!cloned)
-        throw new Error(`Clone completed but ${destination} is not a checkout of ${options.workspaceRepo}.`);
-    return accept(cloned);
-}
-export async function launchArchitect(options, runtime = {}) {
-    const resolved = await resolveWorkspaceRepo(options, runtime);
-    if ("cloneCommand" in resolved)
-        return { launched: false, cloneCommand: resolved.cloneCommand };
-    (runtime.verifyCodex ?? verifyCodex)();
-    const prompt = await readFile(ARCHITECT_PROMPT, "utf8");
-    await (runtime.invokeCodex ?? runCodex)(resolved.directory, prompt);
-    return { launched: true };
-}

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`