@higherdev/cli 0.14.5 → 0.15.2

package/README.md

@@ -39,6 +39,7 @@ workspace-map config shapes are migrated automatically when they are read.
 | `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...]` |
 | `hd workspace rotate-key` | Rotate the shared API key and save it locally |
+| `hd workspace grant-runner-access [--runner-user USER]` | Grant and confirm write-or-better access for the workspace runner |
 | `hd agents` | List agents |
 | `hd agents add ROLE --provider P --model M [options]` | Add an agent |
 | `hd agents rm ROLE\|ID` | Remove an unambiguous agent |
@@ -47,6 +48,9 @@ workspace-map config shapes are migrated automatically when they are read.
 | `hd env ls` | List workspace environment variable names |
 | `hd env set NAME=VALUE [NAME=VALUE...]` | Set workspace environment variables |
 | `hd env rm NAME` | Remove a workspace environment variable |
+| `hd host env ls` | List environment variable names on the workspace's default host |
+| `hd host env set NAME=VALUE [NAME=VALUE...]` | Set host-only environment variables |
+| `hd host env rm NAME` | Remove a host-only environment variable |
 | `hd logs KEY [-f]` | Show or follow run events |
 | `hd msg KEY "message" [--interrupt]` | Message a builder |
 | `hd decide` | List open decisions |
@@ -62,15 +66,25 @@ elsewhere. If the runner environment or service unit already exists, inspect the
 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
-`--runner-user USER` overrides it. On a terminal, missing name or repo flags start a guided wizard. If
+branch, bootstraps an empty repository unless `--no-bootstrap` is set, and invites `mel-ilotus` with push
+access for user-owned repositories or admin for organization-owned repositories unless `--runner-user USER`
+overrides it. On a terminal, missing name or repo flags start a guided wizard. If
 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.
 
+For workspaces created before runner access was wired automatically, run
+`hd workspace grant-runner-access`. It uses the operator's authenticated `gh` account, defaults to
+`mel-ilotus`, grants push on user-owned repositories or admin on organization-owned repositories, and
+confirms write-or-better access through GitHub's collaborator permission endpoint. The old
+`grant-runner-admin` name remains an alias.
+
 `hd env set` and `hd env rm` also update GitHub Actions secrets on the current workspace repository.
 They require the operator's authenticated `gh` account to have repository admin permission. Secret values are sent
 to `gh` through stdin and are never printed.
 
+Use `hd host env set SUPABASE_ACCESS_TOKEN=... SUPABASE_ORG_ID=...` once to let the runner provision
+Supabase for workspaces assigned to that host. Host values are never passed to builder processes.
+
 Inside the TUI, use `/board`, `/inbox`, `/ticket`, `/queue`, `/cancel`, `/epic new`,
 `/epic approve`, `/epics`, `/architect` (or `/plan`), `/decide`, `/agents add`, `/agents rm`, `/env`, `/settings`, `/workspace`,
 `/workspace new`, `/workspace set`, `/workspace rotate-key`, `/feed`,

package/dist/api.js

@@ -114,6 +114,15 @@ export async function setWorkspaceEnv(name, value, config = loadConfig()) {
 export async function removeWorkspaceEnv(name, config = loadConfig()) {
     return request(config, "DELETE", `/api/w/${config.slug}/env`, { name });
 }
+export async function listHostEnv(host, config = loadConfig()) {
+    return request(config, "GET", `/api/hosts/${encodeURIComponent(host)}/env`);
+}
+export async function setHostEnv(host, name, value, config = loadConfig()) {
+    return request(config, "PUT", `/api/hosts/${encodeURIComponent(host)}/env`, { name, value });
+}
+export async function removeHostEnv(host, name, config = loadConfig()) {
+    return request(config, "DELETE", `/api/hosts/${encodeURIComponent(host)}/env`, { name });
+}
 export async function listEpics(config = loadConfig()) {
     return request(config, "GET", `/api/w/${config.slug}/epics`);
 }

package/dist/index.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import { realpathSync } from "node:fs";
 import { pathToFileURL } from "node:url";
-import { approveEpic, answerDecision, cancelTicket, createAgent, createEpic, createTicket, deleteAgent, deleteEpic, getStatus, listAgents, listEpics, listWorkspaceEnv, listTicketEvents, listTickets, listWorkspaces, postMessage, queueTicket, removeWorkspaceEnv, setPaused, setWorkspaceEnv, showTicket, updateAgent, updateCaps, } from "./api.js";
+import { approveEpic, answerDecision, cancelTicket, createAgent, createEpic, createTicket, deleteAgent, deleteEpic, getStatus, listAgents, listEpics, listHostEnv, listWorkspaceEnv, listTicketEvents, listTickets, listWorkspaces, postMessage, queueTicket, removeWorkspaceEnv, removeHostEnv, setPaused, setWorkspaceEnv, setHostEnv, 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 { WORKSPACE_USAGE, workspaceNew, workspaceRotateKey, workspaceSet, workspaceUse } from "./workspace-commands.js";
-import { defaultGh, requireAdminRepo } from "./workspace-preflight.js";
+import { WORKSPACE_USAGE, workspaceGrantRunnerAccess, workspaceNew, workspaceRotateKey, workspaceSet, workspaceUse } from "./workspace-commands.js";
+import { defaultGh, hasWriteRepoPermission, HDX_RUNNER_GH_USER, requireAdminRepo, runnerRepoPermission } from "./workspace-preflight.js";
 function fail(message) {
     console.error(message);
     process.exit(1);
@@ -258,6 +258,11 @@ async function cmdWorkspace(argv, deps = {}) {
         console.log(`${workspace.slug}  ${workspace.name}  ${workspace.repo}`);
         return;
     }
+    if (action === "grant-runner-access" || action === "grant-runner-admin") {
+        const result = await workspaceGrantRunnerAccess(rest, deps);
+        console.log(`${result.runnerUser}  ${result.permission}  ${result.repo}`);
+        return;
+    }
     if (action === "rotate-key") {
         if (rest.length)
             fail(WORKSPACE_USAGE);
@@ -269,6 +274,13 @@ async function cmdWorkspace(argv, deps = {}) {
     if (action === "set") {
         const workspace = await workspaceSet(rest);
         console.log(`${workspace.slug}  ${workspace.name}  ${workspace.repo}`);
+        try {
+            const permission = await runnerRepoPermission(workspace.repo, HDX_RUNNER_GH_USER, deps.gh ?? defaultGh);
+            if (!hasWriteRepoPermission(permission)) {
+                console.log(`hint: runner ${HDX_RUNNER_GH_USER} has ${permission} permission; run hd workspace grant-runner-access`);
+            }
+        }
+        catch { }
         return;
     }
     if (action !== "new")
@@ -412,6 +424,36 @@ export async function cmdEnv(argv, deps = {}) {
     }
     fail("usage: hd env ls | set NAME=VALUE [NAME=VALUE...] | rm NAME");
 }
+async function cmdHost(argv) {
+    const [scope, action, ...args] = argv;
+    const usage = "usage: hd host env ls | set NAME=VALUE [NAME=VALUE...] | rm NAME";
+    if (scope !== "env")
+        fail(usage);
+    const host = (await getStatus()).workspace.default_host;
+    if (action === "ls") {
+        const { env } = await listHostEnv(host);
+        if (!env.length)
+            return console.log(c.dim(`No environment variables for host ${host}.`));
+        console.log(table(["NAME", "UPDATED"], env.map((row) => [row.name, row.updated_at])));
+        return;
+    }
+    if (action === "set" && args.length) {
+        for (const assignment of args) {
+            const at = assignment.indexOf("=");
+            if (at < 1)
+                fail(usage);
+            await setHostEnv(host, assignment.slice(0, at), assignment.slice(at + 1));
+        }
+        console.log(`set ${args.length} host variable${args.length === 1 ? "" : "s"} on ${host}`);
+        return;
+    }
+    if (action === "rm" && args.length === 1) {
+        await removeHostEnv(host, args[0]);
+        console.log(`removed ${args[0]} from ${host}`);
+        return;
+    }
+    fail(usage);
+}
 export async function main(argv = process.argv.slice(2), deps = {}) {
     const [cmd, ...rest] = argv;
     try {
@@ -477,6 +519,10 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
             await cmdEnv(rest, deps);
             return;
         }
+        if (cmd === "host") {
+            await cmdHost(rest);
+            return;
+        }
         if (cmd === "pause" || cmd === "off") {
             await setPaused(true);
             console.log(cmd === "off" ? "off" : "paused");

package/dist/out.js

@@ -67,10 +67,11 @@ export function usage() {
         `  ${c.blue("hd ticket list | show | new | queue | cancel")} ticket operations`,
         `  ${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 | use | new | set | rotate-key")} workspace operations`,
+        `  ${c.blue("hd workspace ls | use | new | set | rotate-key | grant-runner-access")} workspace operations`,
         `  ${c.blue("hd agents [add | rm | set]")}         manage agents`,
         `  ${c.blue("hd caps [set PROVIDER N]")}           provider concurrency`,
         `  ${c.blue("hd env ls | set | rm")}               workspace environment`,
+        `  ${c.blue("hd host env ls | set | rm")}          host environment`,
         `  ${c.blue("hd logs KEY [-f]")}                  run events`,
         `  ${c.blue("hd msg KEY TEXT")}                   message a builder`,
         `  ${c.blue("hd decide [ID --answer TEXT]")}      decisions`,

package/dist/workspace-commands.js

@@ -1,8 +1,8 @@
 import { createWorkspace, listWorkspaces, rotateWorkspaceApiKey, updateWorkspace } from "./api.js";
 import { loadConfig, switchWorkspace, 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 | use SLUG | new --name NAME --repo OWNER/NAME [--create|--no-create] [flags] | set [flags] | rotate-key";
+import { defaultGh, hasWriteRepoPermission, HDX_RUNNER_GH_USER, preflightWorkspace, runnerAccessForRepoOwner, runnerRepoPermission } from "./workspace-preflight.js";
+export const WORKSPACE_USAGE = "usage: hd workspace ls | use SLUG | new --name NAME --repo OWNER/NAME [--create|--no-create] [flags] | set [flags] | rotate-key | grant-runner-access [--runner-user USER]";
 function flags(argv) {
     const opts = {};
     const bools = new Set();
@@ -165,6 +165,33 @@ export async function workspaceUse(argv) {
     switchWorkspace(selected.slug);
     return selected;
 }
+export async function workspaceGrantRunnerAccess(argv, deps = {}) {
+    const { opts, bools, rest } = flags(argv);
+    if (rest.length || bools.size || Object.keys(opts).some((name) => name !== "runner-user")) {
+        throw new Error(WORKSPACE_USAGE);
+    }
+    const runnerUser = opts["runner-user"] ?? HDX_RUNNER_GH_USER;
+    const current = loadConfig().slug;
+    const workspace = (await listWorkspaces()).find((item) => item.slug === current);
+    if (!workspace)
+        throw new Error(`No workspace ${current}.`);
+    const gh = deps.gh ?? defaultGh;
+    try {
+        await gh(["--version"]);
+    }
+    catch {
+        throw new Error("GitHub CLI is unavailable. Install it if needed, then run `gh auth login`.");
+    }
+    const access = await runnerAccessForRepoOwner(workspace.repo, gh);
+    await gh(["api", "-X", "PUT", `repos/${workspace.repo}/collaborators/${runnerUser}`,
+        "-f", `permission=${access}`]);
+    const permission = await runnerRepoPermission(workspace.repo, runnerUser, gh);
+    if (!hasWriteRepoPermission(permission)) {
+        throw new Error(`Runner ${runnerUser} has ${permission} permission on ${workspace.repo}, expected write or better.`);
+    }
+    return { repo: workspace.repo, runnerUser, permission, requestedPermission: access };
+}
+export const workspaceGrantRunnerAdmin = workspaceGrantRunnerAccess;
 export async function workspaceRotateKey() {
     const config = loadConfig();
     const { api_key } = await rotateWorkspaceApiKey(config);

package/dist/workspace-preflight.js

@@ -52,12 +52,28 @@ export async function requireAdminRepo(repo, gh = defaultGh) {
         throw new Error(`Repository admin permission is required; viewer has ${permission || "none"}.`);
     }
 }
-async function repoView(repo, gh) {
-    return JSON.parse(await gh(["repo", "view", repo, "--json", "defaultBranchRef,isEmpty,viewerPermission"]));
+export async function runnerRepoPermission(repo, runnerUser = HDX_RUNNER_GH_USER, gh = defaultGh) {
+    try {
+        const result = JSON.parse(await gh(["api", `repos/${repo}/collaborators/${runnerUser}/permission`]));
+        return result.permission ?? "none";
+    }
+    catch (error) {
+        if (/404|not found/i.test(errorMessage(error)))
+            return "none";
+        throw error;
+    }
 }
-function canPush(permission) {
+export function hasWriteRepoPermission(permission) {
     return ["admin", "maintain", "write", "push"].includes(permission.toLowerCase());
 }
+export async function runnerAccessForRepoOwner(repo, gh = defaultGh) {
+    const owner = repo.split("/")[0];
+    const ownerType = (await gh(["api", `users/${owner}`, "--jq", ".type"])).trim();
+    return ownerType.toLowerCase() === "organization" ? "admin" : "push";
+}
+async function repoView(repo, gh) {
+    return JSON.parse(await gh(["repo", "view", repo, "--json", "defaultBranchRef,isEmpty,viewerPermission"]));
+}
 export async function preflightWorkspace(input, gh = defaultGh) {
     try {
         await gh(["--version"]);
@@ -85,18 +101,11 @@ export async function preflightWorkspace(input, gh = defaultGh) {
     if (!branch)
         throw new Error(`GitHub repository ${input.repo} has no default branch.`);
     const runnerUser = input.runnerUser || HDX_RUNNER_GH_USER;
-    let permission = "none";
-    try {
-        const result = JSON.parse(await gh(["api", `repos/${input.repo}/collaborators/${runnerUser}/permission`]));
-        permission = result.permission ?? "none";
-    }
-    catch (error) {
-        if (!/404|not found/i.test(errorMessage(error)))
-            throw error;
-    }
-    const invitationPending = !canPush(permission);
+    const permission = await runnerRepoPermission(input.repo, runnerUser, gh);
+    const invitationPending = !hasWriteRepoPermission(permission);
     if (invitationPending) {
-        await gh(["api", "-X", "PUT", `repos/${input.repo}/collaborators/${runnerUser}`, "-f", "permission=push"]);
+        const access = await runnerAccessForRepoOwner(input.repo, gh);
+        await gh(["api", "-X", "PUT", `repos/${input.repo}/collaborators/${runnerUser}`, "-f", `permission=${access}`]);
     }
     return { branch, invitationPending };
 }

package/package.json

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