@higherdev/cli 0.11.1 → 0.12.1

package/README.md

@@ -8,15 +8,10 @@ Operator controls for HDX workspaces, tickets, agents, and runner hosts.
 npm install --global @higherdev/cli
 ```
 
-Create `~/.config/hd/config.json` with an existing workspace API key:
+Configure this client with an existing workspace API key:
 
-```json
-{
-  "url": "https://hdx-higher-ops.vercel.app",
-  "api_key": "hdx_...",
-  "current": "workspace",
-  "repos": {}
-}
+```sh
+hd login --url https://hdx-higher-ops.vercel.app --api-key hdx_... --slug workspace
 ```
 
 One workspace key reaches every workspace. Previous single-workspace and
@@ -36,7 +31,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...]` |
@@ -52,8 +49,13 @@ workspace-map config shapes are migrated automatically when they are read.
 | `hd decide ID --answer TEXT` | Answer a decision |
 | `hd on` / `hd off` | Turn the workspace on or off |
 | `hd pause` / `hd resume` | Pause or resume the workspace |
-| `hd init [options]` | Configure this host and runner service |
-| `hd upgrade [options]` | Refresh this host configuration |
+| `hd login --url URL --api-key KEY [--slug S]` | Configure only this operator client |
+| `hd init --host HOST [--checkout DIR] [options]` | Configure this host and runner service |
+| `hd upgrade --host HOST [--checkout DIR] [options]` | Refresh this host configuration |
+
+`hd init` uses `~/hdx` as its checkout by default. Pass `--checkout DIR` when the runner source is
+elsewhere. If the runner environment or service unit already exists, inspect the paths it prints and
+pass `--force` only when replacing that host configuration is intentional.
 
 `hd workspace new` uses the operator's authenticated `gh`, defaults to the repository's real default
 branch, bootstraps an empty repository unless `--no-bootstrap` is set, and invites `mel-ilotus` unless
@@ -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/host.js

@@ -1,16 +1,11 @@
 import { execFile } from "node:child_process";
-import { chmod, mkdir, readFile, writeFile } from "node:fs/promises";
-import { homedir, hostname } from "node:os";
+import { access, chmod, mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
 import { promisify } from "node:util";
-import { writeHdConfig } from "./config.js";
 const execFileAsync = promisify(execFile);
 export const LAUNCHD_LABEL = "io.higherops.hdx-runner";
 export const SYSTEMD_UNIT = "hdx-runner.service";
-export function repoRootFrom(fileUrl = import.meta.url) {
-    return path.resolve(path.dirname(fileURLToPath(fileUrl)), "../../..");
-}
 export function parseEnvFile(text) {
     const out = {};
     for (const line of text.split(/\r?\n/)) {
@@ -88,6 +83,10 @@ export function parseHostFlags(argv) {
         };
         if (arg === "--host")
             flags.host = next();
+        else if (arg === "--checkout")
+            flags.checkout = next();
+        else if (arg === "--force")
+            flags.force = true;
         else if (arg === "--env-out")
             flags.envFile = next();
         else if (arg === "--worktree-root")
@@ -96,12 +95,6 @@ export function parseHostFlags(argv) {
             flags.installLaunchd = true;
         else if (arg === "--install-systemd")
             flags.installSystemd = true;
-        else if (arg === "--url")
-            flags.url = next();
-        else if (arg === "--api-key")
-            flags.apiKey = next();
-        else if (arg === "--slug")
-            flags.slug = next();
         else if (arg === "--plist-out")
             flags.plistOut = next();
         else if (arg === "--unit-out")
@@ -111,14 +104,47 @@ export function parseHostFlags(argv) {
     }
     return flags;
 }
+async function exists(file) {
+    try {
+        await access(file);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function expandHome(value, home) {
+    if (value === "~")
+        return home;
+    if (value.startsWith("~/"))
+        return path.join(home, value.slice(2));
+    return value;
+}
 export async function initHost(flags, env = process.env) {
     const home = homedir();
-    const host = flags.host || env.RUNNER_HOST || hostname().replace(/\..*$/, "").toLowerCase();
     const envFile = flags.envFile || path.join(home, ".config/hdx/runner.env");
     const worktreeRoot = flags.worktreeRoot || env.WORKTREE_ROOT || path.join(home, "hdx-worktrees");
-    const repo = repoRootFrom();
+    const repo = path.resolve(expandHome(flags.checkout ?? path.join(home, "hdx"), home));
     const runnerPath = path.join(repo, "apps/runner/src/index.ts");
     const nodePath = process.execPath;
+    const plistPath = flags.plistOut || path.join(home, "Library/LaunchAgents", `${LAUNCHD_LABEL}.plist`);
+    const unitPath = flags.unitOut || path.join(home, ".config/systemd/user", SYSTEMD_UNIT);
+    const targets = [envFile];
+    if (process.platform === "darwin" || flags.plistOut || flags.installLaunchd)
+        targets.push(plistPath);
+    if (process.platform === "linux" || flags.unitOut || flags.installSystemd)
+        targets.push(unitPath);
+    const existingTargets = (await Promise.all(targets.map(async (target) => ({ target, exists: await exists(target) })))).filter((entry) => entry.exists).map((entry) => entry.target);
+    if (existingTargets.length && !flags.force) {
+        throw new Error([
+            "hd init refused to overwrite existing runner files:",
+            ...existingTargets.map((target) => `  ${target}`),
+            "Re-run with --force to overwrite them.",
+        ].join("\n"));
+    }
+    if (!flags.host)
+        throw new Error("hd init requires --host HOST.");
+    const host = flags.host;
     let existing = {};
     try {
         existing = parseEnvFile(await readFile(envFile, "utf8"));
@@ -137,13 +163,9 @@ export async function initHost(flags, env = process.env) {
     await mkdir(path.dirname(envFile), { recursive: true });
     await writeFile(envFile, formatEnvFile(merged), { encoding: "utf8", mode: 0o600 });
     await chmod(envFile, 0o600);
-    if (flags.url && flags.apiKey && flags.slug) {
-        writeHdConfig({ url: flags.url.replace(/\/$/, ""), api_key: flags.apiKey, slug: flags.slug });
-    }
     const lines = [`hd init host=${host}`, `env: ${envFile}`];
     const workDir = repo;
     if (process.platform === "darwin" || flags.plistOut || flags.installLaunchd) {
-        const plistPath = flags.plistOut || path.join(home, "Library/LaunchAgents", `${LAUNCHD_LABEL}.plist`);
         const logPath = path.join(home, "Library/Logs/hdx-runner.log");
         await mkdir(path.dirname(plistPath), { recursive: true });
         await writeFile(plistPath, launchdPlist({ nodePath, runnerPath, envFile, logPath, workDir }), "utf8");
@@ -163,7 +185,6 @@ export async function initHost(flags, env = process.env) {
         lines.push(`launchd plist: ${plistPath}${loaded ? " (loaded)" : ""}`);
     }
     if (process.platform === "linux" || flags.unitOut || flags.installSystemd) {
-        const unitPath = flags.unitOut || path.join(home, ".config/systemd/user", SYSTEMD_UNIT);
         await mkdir(path.dirname(unitPath), { recursive: true });
         await writeFile(unitPath, systemdUnit({ nodePath, runnerPath, envFile, workDir }), "utf8");
         let loaded = false;

package/dist/index.js

@@ -1,12 +1,12 @@
 #!/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 { 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 { launchArchitect } from "./plan.js";
 import { WORKSPACE_USAGE, workspaceNew, workspaceRotateKey, workspaceSet } from "./workspace-commands.js";
 function fail(message) {
     console.error(message);
@@ -153,18 +153,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);
@@ -249,7 +257,7 @@ async function cmdWorkspace(argv, deps = {}) {
             fail(WORKSPACE_USAGE);
         const result = await workspaceRotateKey();
         console.log(`api key: ${result.apiKey}`);
-        console.log("saved locally; update Mel's hd init configuration on the box.");
+        console.log("saved locally; run hd login with the new key on other machines.");
         return;
     }
     if (action === "set") {
@@ -264,7 +272,7 @@ async function cmdWorkspace(argv, deps = {}) {
         console.log(`invitation pending for ${result.runnerUser}`);
     console.log(`workspace: ${result.slug}`);
     console.log("saved and switched; configure another machine with:");
-    console.log(result.initCommand);
+    console.log(result.loginCommand);
 }
 function selectAgent(agents, target, provider) {
     const exact = agents.find((agent) => agent.id === target);
@@ -407,6 +415,13 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
             console.log(cmd === "on" ? "on" : "resumed");
             return;
         }
+        if (cmd === "login") {
+            const config = login(parseLoginFlags(rest));
+            console.log(`logged in to ${config.slug}`);
+            const { launchApp } = await import("./tui/launch.js");
+            await launchApp(config.slug);
+            return;
+        }
         if (cmd === "init" || cmd === "upgrade") {
             const report = await initHost(parseHostFlags(rest));
             console.log(report);

package/dist/login.js

@@ -0,0 +1,41 @@
+import { loadStoredConfig, writeHdConfig } from "./config.js";
+export function parseLoginFlags(argv) {
+    const flags = {};
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        const next = () => {
+            const value = argv[i + 1];
+            if (!value || value.startsWith("--"))
+                throw new Error(`Missing value for ${arg}`);
+            i += 1;
+            return value;
+        };
+        if (arg === "--url")
+            flags.url = next();
+        else if (arg === "--api-key")
+            flags.apiKey = next();
+        else if (arg === "--slug")
+            flags.slug = next();
+        else
+            throw new Error(`Unknown option: ${arg}`);
+    }
+    return flags;
+}
+/** Configure the operator client without touching runner host files. */
+export function login(flags, path) {
+    if (!flags.url || !flags.apiKey) {
+        throw new Error("usage: hd login --url URL --api-key KEY [--slug S]");
+    }
+    let current = "workspace";
+    try {
+        current = loadStoredConfig(path).current;
+    }
+    catch { }
+    const config = {
+        url: flags.url,
+        api_key: flags.apiKey,
+        slug: flags.slug ?? current,
+    };
+    writeHdConfig(config, path);
+    return config;
+}

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`,
@@ -74,6 +74,8 @@ export function usage() {
         `  ${c.blue("hd msg KEY TEXT")}                   message a builder`,
         `  ${c.blue("hd decide [ID --answer TEXT]")}      decisions`,
         `  ${c.blue("hd on | hd off")}                    workspace switch`,
-        `  ${c.blue("hd init | hd upgrade")}              host setup`,
+        `  ${c.blue("hd login --url URL --api-key KEY")}  client setup`,
+        `  ${c.blue("hd init --host HOST [options]")}     host setup`,
+        `  ${c.blue("hd upgrade --host HOST [options]")}  refresh host setup`,
     ].join("\n");
 }

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);
@@ -311,7 +312,7 @@ export function App({ initial }) {
                         if (!created)
                             throw new Error("Workspace wizard did not finish.");
                         await changeWorkspace(created.slug, loadConfig());
-                        say("system", `Created ${created.slug}. Configure the box with: ${created.initCommand}`);
+                        say("system", `Created ${created.slug}. Configure another machine with: ${created.loginCommand}`);
                     }
                     else if (action.command === "set") {
                         const updated = await workspaceSet(action.args);
@@ -321,7 +322,7 @@ export function App({ initial }) {
                     else {
                         const rotated = await workspaceRotateKey();
                         setConfig(loadConfig());
-                        say("system", `API key: ${rotated.apiKey}\nSaved locally. Update Mel's hd init configuration on the box.`);
+                        say("system", `API key: ${rotated.apiKey}\nSaved locally. Run hd login with the new key on other machines.`);
                     }
                 }
                 catch (error) {
@@ -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/dist/workspace-commands.js

@@ -115,7 +115,7 @@ export async function workspaceNew(argv, deps = {}) {
         return { slug: result.workspace.slug, repo: result.workspace.repo,
             invitationPending: preflight.invitationPending,
             runnerUser: opts["runner-user"] ?? HDX_RUNNER_GH_USER,
-            initCommand: `hd init --url ${result.url} --api-key ${result.api_key} --slug ${result.workspace.slug}` };
+            loginCommand: `hd login --url ${result.url} --api-key ${result.api_key} --slug ${result.workspace.slug}` };
     }
 }
 export async function workspaceSet(argv) {

package/package.json

@@ -1,14 +1,13 @@
 {
   "name": "@higherdev/cli",
-  "version": "0.11.1",
+  "version": "0.12.1",
   "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`