@higherdev/cli 0.5.0 → 0.6.0

package/README.md

@@ -12,17 +12,14 @@ Create `~/.config/hd/config.json` with an existing workspace API key:
 
 ```json
 {
-  "current": "workspace",
-  "workspaces": {
-    "workspace": {
-      "url": "https://hdx-higher-ops.vercel.app",
-      "api_key": "hdx_..."
-    }
-  }
+  "url": "https://hdx-higher-ops.vercel.app",
+  "api_key": "hdx_...",
+  "current": "workspace"
 }
 ```
 
-The previous single-workspace config shape is migrated automatically when it is read.
+One workspace key reaches every workspace. Previous single-workspace and
+workspace-map config shapes are migrated automatically when they are read.
 
 ## Commands
 
@@ -34,6 +31,7 @@ The previous single-workspace config shape is migrated automatically when it is
 | `hd ticket list` | List tickets |
 | `hd ticket show KEY` | Show one ticket |
 | `hd ticket new --title TITLE [options]` | Create a ticket |
+| `hd workspace ls` | List every workspace available to the configured key |
 | `hd workspace new --name NAME --repo OWNER/NAME [options]` | Create a paused workspace |
 | `hd agents` | List agents |
 | `hd agents set ROLE --provider P --model M [--effort E]` | Update an agent |

package/dist/api.js

@@ -1,4 +1,19 @@
 import { loadConfig } from "./config.js";
+export const MAX_API_ERROR_BODY = 500;
+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();
+    if (duplicate) {
+        return `hd: ${status} Only one enabled ${duplicate} is allowed per workspace. Disable the current ${duplicate} before enabling another.`;
+    }
+    const trimmed = raw.trim();
+    const body = trimmed.length > MAX_API_ERROR_BODY
+        ? `${trimmed.slice(0, MAX_API_ERROR_BODY)}... [truncated ${trimmed.length - MAX_API_ERROR_BODY} chars]`
+        : trimmed;
+    return `hd: ${status} ${body}`;
+}
 async function request(config, method, path, body) {
     const response = await fetch(`${config.url}${path}`, {
         method,
@@ -14,11 +29,10 @@ async function request(config, method, path, body) {
         parsed = text ? JSON.parse(text) : null;
     }
     catch {
-        throw new Error(`hd: ${response.status} ${text || response.statusText}`);
+        throw new Error(apiErrorMessage(response.status, null, text || response.statusText));
     }
     if (!response.ok) {
-        const err = parsed;
-        throw new Error(`hd: ${response.status} ${err.error ?? text}`);
+        throw new Error(apiErrorMessage(response.status, parsed, text || response.statusText));
     }
     return parsed;
 }
@@ -57,6 +71,9 @@ export async function createWorkspace(fields, config = loadConfig()) {
     const result = await request(config, "POST", "/api/workspaces", fields);
     return { ...result, url: config.url };
 }
+export async function listWorkspaces(config = loadConfig()) {
+    return request(config, "GET", "/api/workspaces");
+}
 export async function listAgents(config = loadConfig()) {
     return request(config, "GET", `/api/w/${config.slug}/agents`);
 }

package/dist/config.js

@@ -1,10 +1,10 @@
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
-import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { chmodSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 export function configPath() {
     return process.env.HD_CONFIG ?? join(homedir(), ".config/hd/config.json");
 }
-function normalizeWorkspace(value) {
+function normalizeConnection(value) {
     if (!value || typeof value !== "object" || Array.isArray(value))
         return null;
     const row = value;
@@ -14,7 +14,7 @@ function normalizeWorkspace(value) {
     return { url: row.url.replace(/\/$/, ""), api_key: row.api_key };
 }
 function missing(path) {
-    return new Error(`missing ${path}\nWrite { "current": "workspace", "workspaces": { "workspace": { "url": "https://hdx-higher-ops.vercel.app", "api_key": "hdx_..." } } }`);
+    return new Error(`missing ${path}\nWrite { "url": "https://hdx-higher-ops.vercel.app", "api_key": "hdx_...", "current": "workspace" }`);
 }
 export function loadStoredConfig(path = configPath()) {
     let raw;
@@ -25,56 +25,51 @@ export function loadStoredConfig(path = configPath()) {
         throw missing(path);
     }
     const parsed = JSON.parse(raw);
-    // 0.4 and earlier stored one workspace at the top level. Rewrite it once so
-    // every later read sees the multi-workspace format.
-    const legacy = normalizeWorkspace(parsed);
-    if (legacy && typeof parsed.slug === "string" && parsed.slug) {
-        const migrated = { current: parsed.slug, workspaces: { [parsed.slug]: legacy } };
+    const connection = normalizeConnection(parsed);
+    const current = typeof parsed.current === "string" ? parsed.current : "";
+    if (connection && current)
+        return { ...connection, current };
+    // 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 };
         writeStoredConfig(migrated, path);
         return migrated;
     }
-    const current = typeof parsed.current === "string" ? parsed.current : "";
+    // 0.5 stored one connection per workspace. Keep the current workspace's
+    // credentials as the shared operator connection and discard the duplicates.
     const source = parsed.workspaces;
     if (!current || !source || typeof source !== "object" || Array.isArray(source)) {
-        throw new Error(`${path} needs current and workspaces`);
-    }
-    const workspaces = {};
-    for (const [slug, value] of Object.entries(source)) {
-        const workspace = normalizeWorkspace(value);
-        if (workspace)
-            workspaces[slug] = workspace;
+        throw new Error(`${path} needs url, api_key, and current`);
     }
-    if (!workspaces[current])
+    const selected = normalizeConnection(source[current]);
+    if (!selected)
         throw new Error(`${path} current workspace ${current} is not configured`);
-    return { current, workspaces };
+    const migrated = { ...selected, current };
+    writeStoredConfig(migrated, path);
+    return migrated;
 }
 export function loadConfig(slug) {
     const stored = loadStoredConfig();
     const selected = slug ?? stored.current;
-    const workspace = stored.workspaces[selected];
-    if (!workspace)
-        throw new Error(`No configured workspace ${selected}.`);
-    return { ...workspace, slug: selected };
+    return { url: stored.url, api_key: stored.api_key, slug: selected };
 }
 export function writeStoredConfig(config, path = configPath()) {
     mkdirSync(dirname(path), { recursive: true });
     writeFileSync(path, `${JSON.stringify(config, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
     chmodSync(path, 0o600);
 }
-/** Store credentials for a workspace and make it current. */
+/** Store one operator connection and make its selected workspace current. */
 export function writeHdConfig(config, path = configPath()) {
-    const stored = existsSync(path)
-        ? loadStoredConfig(path)
-        : { current: config.slug, workspaces: {} };
-    stored.workspaces[config.slug] = { url: config.url.replace(/\/$/, ""), api_key: config.api_key };
-    stored.current = config.slug;
-    writeStoredConfig(stored, path);
+    writeStoredConfig({
+        url: config.url.replace(/\/$/, ""),
+        api_key: config.api_key,
+        current: config.slug,
+    }, path);
 }
 export function switchWorkspace(slug, path = configPath()) {
     const stored = loadStoredConfig(path);
-    const workspace = stored.workspaces[slug];
-    if (!workspace)
-        throw new Error(`No configured workspace ${slug}.`);
     writeStoredConfig({ ...stored, current: slug }, path);
-    return { ...workspace, slug };
+    return { url: stored.url, api_key: stored.api_key, slug };
 }

package/dist/index.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { realpathSync } from "node:fs";
 import { pathToFileURL } from "node:url";
-import { answerDecision, createTicket, createWorkspace, getStatus, listAgents, listTicketEvents, listTickets, postMessage, setPaused, showTicket, updateAgent, } from "./api.js";
+import { answerDecision, createTicket, createWorkspace, getStatus, listAgents, listTicketEvents, listTickets, listWorkspaces, postMessage, setPaused, showTicket, updateAgent, } from "./api.js";
 import { initHost, parseHostFlags } from "./host.js";
-import { writeHdConfig } from "./config.js";
+import { loadConfig, writeHdConfig } from "./config.js";
 import { banner, c, statusChip, table, truncate, usage } from "./out.js";
 function fail(message) {
     console.error(message);
@@ -176,8 +176,20 @@ async function cmdDecide(argv) {
 }
 async function cmdWorkspace(argv) {
     const [action, ...rest] = argv;
+    if (action === "ls") {
+        const current = loadConfig().slug;
+        const workspaces = await listWorkspaces();
+        console.log(table(["", "SLUG", "NAME", "REPO", "STATE"], workspaces.map((workspace) => [
+            workspace.slug === current ? "*" : "",
+            workspace.slug,
+            workspace.name,
+            workspace.repo,
+            workspace.on ? c.green("on") : c.dim("off"),
+        ])));
+        return;
+    }
     if (action !== "new")
-        fail("usage: hd workspace new --name NAME --repo OWNER/NAME [--slug S] [--branch main] [--host box]");
+        fail("usage: hd workspace ls | new --name NAME --repo OWNER/NAME [--slug S] [--branch main] [--host box]");
     const { opts } = flags(rest);
     if (!opts.name || !opts.repo) {
         fail("usage: hd workspace new --name NAME --repo OWNER/NAME [--slug S] [--branch main] [--host box]");

package/dist/out.js

@@ -65,7 +65,7 @@ export function usage() {
         c.bold("Usage"),
         `  ${c.blue("hd status")}                         workspace overview`,
         `  ${c.blue("hd ticket list | show | new")}       ticket operations`,
-        `  ${c.blue("hd workspace new")}                  create a paused workspace`,
+        `  ${c.blue("hd workspace ls | new")}             list or create workspaces`,
         `  ${c.blue("hd agents [set]")}                   inspect or update agents`,
         `  ${c.blue("hd logs KEY [-f]")}                  run events`,
         `  ${c.blue("hd msg KEY TEXT")}                   message a builder`,

package/dist/tui/App.js

@@ -57,6 +57,23 @@ export function App({ initial }) {
         if (messages.length > 0 || view !== "home")
             setStarted(true);
     }, [messages.length, view]);
+    useEffect(() => {
+        if (!ready)
+            return;
+        const live = planLayout({
+            rows,
+            columns,
+            width,
+            splash: false,
+            ready: true,
+            decision: decisionRows(board.decisions),
+            inFlight: 0,
+            notice: false,
+            home: true,
+        });
+        if (live.cockpit > 0)
+            setStarted(true);
+    }, [ready, rows, columns, width, board.decisions]);
     const applySnapshot = useCallback((snapshot) => {
         const token = loads.current.start(snapshot.workspace.id);
         if (!loads.current.isCurrent(token))
@@ -144,13 +161,9 @@ export function App({ initial }) {
         }
     }, [settings, config, refresh]);
     const changeWorkspace = useCallback(async (slug) => {
-        if (!configuredSlugs().includes(slug)) {
-            setNotice(`No configured workspace ${slug}. You can reach: ${configuredSlugs().join(", ")}.`);
-            return;
-        }
         setBusy(true);
         try {
-            const snapshot = await switchWorkspace(slug);
+            const snapshot = await switchWorkspace(slug, config);
             loads.current.switchTo(snapshot.workspace.id);
             setConfig(snapshot.config);
             setWorkspace(snapshot.workspace);
@@ -265,10 +278,20 @@ export function App({ initial }) {
                 }
                 return;
             case "workspace":
-                if (!action.slug)
-                    say("system", `Workspaces: ${configuredSlugs().join(", ")}.`);
-                else
+                if (action.slug)
                     await changeWorkspace(action.slug);
+                else {
+                    setBusy(true);
+                    try {
+                        say("system", `Workspaces: ${(await configuredSlugs(config)).join(", ")}.`);
+                    }
+                    catch (error) {
+                        setNotice(error instanceof Error ? error.message : String(error));
+                    }
+                    finally {
+                        setBusy(false);
+                    }
+                }
                 return;
             case "ticket":
                 setTicketKey(action.key);

package/dist/tui/Dashboard.js

@@ -130,7 +130,7 @@ export function AgentsColumn({ board, width, rows, }) {
                 const name = Math.max(8, Math.min(22, width - 14));
                 return (_jsxs(Box, { flexWrap: "nowrap", children: [_jsxs(Text, { color: inkColor(tone), children: [DOT, " "] }), _jsx(Box, { width: name, flexShrink: 0, children: _jsx(Text, { color: UI.text, wrap: "truncate", children: truncate(agent.display_name, name - 1) }) }), _jsx(Text, { color: UI.dim, wrap: "truncate", children: run
                                 ? `${ticket ? `${ticket.key} ` : ""}${elapsed(run.started_at ?? run.created_at)}`
-                                : blocked || (agent.enabled ? "idle" : "off") })] }, agent.id));
+                                : blocked || (agent.enabled ? "idle" : "offline") })] }, agent.id));
             }),
             _jsx(More, { count: ordered.length - shown.length }, "more"),
         ] }));

package/dist/tui/data.js

@@ -1,5 +1,5 @@
-import { answerDecision, getStatus, listAgents, listEpics, listFeed, listMessages, listTicketEvents, listTickets, postMessage as sendMessage, showTicket, updateAgent as patchAgent, updateCaps, } from "../api.js";
-import { loadConfig, loadStoredConfig, switchWorkspace as selectWorkspace, } from "../config.js";
+import { answerDecision, getStatus, listAgents, listEpics, listFeed, listMessages, listTicketEvents, listTickets, listWorkspaces, postMessage as sendMessage, showTicket, updateAgent as patchAgent, updateCaps, } from "../api.js";
+import { loadConfig, switchWorkspace as selectWorkspace, } from "../config.js";
 export const POLL_MS = 5_000;
 export const providers = ["claude", "codex", "gemini", "grok"];
 export const efforts = ["low", "medium", "high"];
@@ -17,8 +17,8 @@ export const BOARD_COLUMNS = [
     "merged",
     "cancelled",
 ];
-export function configuredSlugs() {
-    return Object.keys(loadStoredConfig().workspaces).sort();
+export async function configuredSlugs(config = loadConfig()) {
+    return (await listWorkspaces(config)).map((workspace) => workspace.slug).sort();
 }
 export async function loadSnapshot(config = loadConfig()) {
     const [status, ticketData, agentData, epicData, feedData] = await Promise.all([
@@ -83,8 +83,14 @@ export function pollSnapshot(config, onSnapshot, onState, onError) {
     void refresh();
     return { refresh, close: () => { closed = true; clearInterval(timer); } };
 }
-export async function switchWorkspace(slug) {
-    return loadSnapshot(selectWorkspace(slug));
+export async function switchWorkspace(slug, config = loadConfig()) {
+    const slugs = await configuredSlugs(config);
+    if (!slugs.includes(slug)) {
+        throw new Error(`No workspace ${slug}. You can reach: ${slugs.join(", ")}.`);
+    }
+    const snapshot = await loadSnapshot({ ...config, slug });
+    selectWorkspace(slug);
+    return snapshot;
 }
 export async function postOrchestrator(body, config) {
     await sendMessage({ body_md: body, to_role: "orchestrator", delivery: "queue" }, config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@higherdev/cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "bin": {
     "hd": "dist/index.js"