@allocator-one/harness-cli 1.4.0 → 1.4.1

package/dist/cli.js

@@ -372,6 +372,16 @@ function defaultOpenBrowser(url) {
   }
 }
 
+// src/core/stdio.ts
+var BROKEN_PIPE_CODES = /* @__PURE__ */ new Set(["EPIPE", "ERR_STREAM_DESTROYED"]);
+function guardBrokenPipes(streams = [process.stdout, process.stderr]) {
+  for (const stream of streams) {
+    stream.on("error", (error) => {
+      if (!BROKEN_PIPE_CODES.has(error.code ?? "")) throw error;
+    });
+  }
+}
+
 // src/core/upgrade.ts
 import { spawn, spawnSync } from "child_process";
 import {
@@ -390,6 +400,7 @@ import {
 import { basename, dirname, join as join2, parse, sep } from "path";
 import { fileURLToPath } from "url";
 var PACKAGE_NAME = "@allocator-one/harness-cli";
+var UPGRADE_INSTALL_SPEC = `${PACKAGE_NAME}@latest`;
 var UPDATE_CHECK_COMMAND = "__update-check";
 var REEXEC_SENTINEL = "HARNESS_UPGRADED";
 var DEFAULT_REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
@@ -399,7 +410,11 @@ var NPM_ROOT_TIMEOUT_MS = 15e3;
 var INSTALL_TIMEOUT_MS = 12e4;
 var LOCK_STALE_MS = NPM_ROOT_TIMEOUT_MS + INSTALL_TIMEOUT_MS + 6e4;
 function detectInstall(from = fileURLToPath(import.meta.url)) {
-  const unknown = { kind: "unknown", packageRoot: null, nodeModules: null };
+  const unknown = {
+    kind: "unknown",
+    packageRoot: null,
+    nodeModules: null
+  };
   if (from.split(sep).includes("_npx")) return { ...unknown, kind: "npx" };
   const packageRoot = findPackageRoot(from);
   if (packageRoot === null) return unknown;
@@ -432,7 +447,9 @@ function packageNameAt(path) {
 }
 function versionAt(packageRoot) {
   try {
-    const parsed = JSON.parse(readFileSync(join2(packageRoot, "package.json"), "utf8"));
+    const parsed = JSON.parse(
+      readFileSync(join2(packageRoot, "package.json"), "utf8")
+    );
     if (typeof parsed !== "object" || parsed === null) return null;
     const version2 = parsed["version"];
     return typeof version2 === "string" ? version2 : null;
@@ -463,7 +480,8 @@ function isNewer(candidate, current) {
   const b = parseVersion(current);
   if (a === null || b === null) return false;
   for (let index = 0; index < 3; index++) {
-    if (a.parts[index] !== b.parts[index]) return a.parts[index] > b.parts[index];
+    if (a.parts[index] !== b.parts[index])
+      return a.parts[index] > b.parts[index];
   }
   if (a.pre === b.pre) return false;
   if (a.pre === null) return true;
@@ -499,7 +517,8 @@ function readStamp(env = process.env) {
     if (typeof parsed !== "object" || parsed === null) return null;
     const record = parsed;
     const checkedAt = record["checkedAt"];
-    if (typeof checkedAt !== "number" || !Number.isFinite(checkedAt)) return null;
+    if (typeof checkedAt !== "number" || !Number.isFinite(checkedAt))
+      return null;
     const latest = record["latest"];
     return { checkedAt, latest: typeof latest === "string" ? latest : null };
   } catch {
@@ -571,7 +590,8 @@ async function fetchLatestVersion(env) {
     const parsed = await response.json();
     if (typeof parsed !== "object" || parsed === null) return null;
     const version2 = parsed["version"];
-    if (typeof version2 !== "string" || parseVersion(version2) === null) return null;
+    if (typeof version2 !== "string" || parseVersion(version2) === null)
+      return null;
     return version2;
   } catch {
     return null;
@@ -581,10 +601,18 @@ function selfHeal(options = {}) {
   const env = options.env ?? process.env;
   const argv2 = options.argv ?? process.argv;
   if (truthy(env[REEXEC_SENTINEL])) {
-    return { kind: "skipped", reason: "already upgraded once for this command" };
+    return {
+      kind: "skipped",
+      reason: "already upgraded once for this command"
+    };
   }
-  if (!autoUpgradeEnabled(env)) return { kind: "skipped", reason: "automatic upgrades are off" };
-  if (argv2[2] === "mcp") return { kind: "skipped", reason: "an MCP session must not be replaced mid-stream" };
+  if (!autoUpgradeEnabled(env))
+    return { kind: "skipped", reason: "automatic upgrades are off" };
+  if (argv2[2] === "mcp")
+    return {
+      kind: "skipped",
+      reason: "an MCP session must not be replaced mid-stream"
+    };
   const install = options.install ?? detectInstall();
   if (install.kind !== "global" || install.packageRoot === null) {
     return { kind: "skipped", reason: describeInstall(install.kind) };
@@ -595,17 +623,27 @@ function selfHeal(options = {}) {
     return { kind: "upgraded", code: reexec(options, env, argv2) };
   }
   const lock = takeLock(env);
-  if (lock === null) return { kind: "skipped", reason: "another harness process is already upgrading" };
+  if (lock === null)
+    return {
+      kind: "skipped",
+      reason: "another harness process is already upgrading"
+    };
   try {
     const stillHeld = () => readHolder(lock.path)?.pid === lock.pid;
     const result = (options.runInstall ?? npmInstallGlobal)(install, stillHeld);
     if (!result.ok) return { kind: "failed", reason: result.detail };
     const after = versionAt(packageRoot);
     if (after !== null && after === installed) {
-      return { kind: "failed", reason: `still ${after} after upgrading \u2014 no newer release is published` };
+      return {
+        kind: "failed",
+        reason: `still ${after} after upgrading \u2014 no newer release is published`
+      };
     }
     if (after !== null && installed !== null && !isNewer(after, installed)) {
-      return { kind: "failed", reason: `npm left ${after} installed, which is not newer than ${installed}` };
+      return {
+        kind: "failed",
+        reason: `npm left ${after} installed, which is not newer than ${installed}`
+      };
     }
   } finally {
     releaseLock(lock);
@@ -613,7 +651,10 @@ function selfHeal(options = {}) {
   return { kind: "upgraded", code: reexec(options, env, argv2) };
 }
 function reexec(options, env, argv2) {
-  return (options.reexec ?? reexecSelf)({ ...env, [REEXEC_SENTINEL]: "1" }, argv2);
+  return (options.reexec ?? reexecSelf)(
+    { ...env, [REEXEC_SENTINEL]: "1" },
+    argv2
+  );
 }
 function describeInstall(kind) {
   switch (kind) {
@@ -629,9 +670,13 @@ function describeInstall(kind) {
 }
 function npmInstallGlobal(install, stillHeld) {
   const globalRoot = npmGlobalRoot();
-  if (globalRoot === null) return { ok: false, detail: "npm did not say where its global root is" };
+  if (globalRoot === null)
+    return { ok: false, detail: "npm did not say where its global root is" };
   if (globalRoot.includes("***")) {
-    return { ok: false, detail: "npm redacted its own global root, so this copy's location cannot be confirmed" };
+    return {
+      ok: false,
+      detail: "npm redacted its own global root, so this copy's location cannot be confirmed"
+    };
   }
   if (install.nodeModules === null || !samePath(globalRoot, install.nodeModules)) {
     return {
@@ -642,10 +687,16 @@ function npmInstallGlobal(install, stillHeld) {
   try {
     accessSync2(globalRoot, constants.W_OK);
   } catch {
-    return { ok: false, detail: `${globalRoot} is not writable \u2014 upgrade it yourself` };
+    return {
+      ok: false,
+      detail: `${globalRoot} is not writable \u2014 upgrade it yourself`
+    };
   }
   if (!stillHeld()) {
-    return { ok: false, detail: "lost the upgrade lock while preparing \u2014 another process took over" };
+    return {
+      ok: false,
+      detail: "lost the upgrade lock while preparing \u2014 another process took over"
+    };
   }
   process.stderr.write(`harness: upgrading ${PACKAGE_NAME} \u2026
 `);
@@ -657,7 +708,7 @@ function npmInstallGlobal(install, stillHeld) {
     "--no-fund",
     "--no-update-notifier",
     "--loglevel=error",
-    `${PACKAGE_NAME}@latest`
+    UPGRADE_INSTALL_SPEC
   ];
   const result = spawnSync(npmCommand(), args, {
     // npm's diagnostics belong on stderr with ours; stdout stays the
@@ -666,9 +717,13 @@ function npmInstallGlobal(install, stillHeld) {
     timeout: INSTALL_TIMEOUT_MS,
     ...npmSpawnOptions()
   });
-  if (result.error !== void 0) return { ok: false, detail: result.error.message };
+  if (result.error !== void 0)
+    return { ok: false, detail: result.error.message };
   if (result.status !== 0) {
-    return { ok: false, detail: `npm install exited ${result.status ?? `on ${String(result.signal)}`}` };
+    return {
+      ok: false,
+      detail: `npm install exited ${result.status ?? `on ${String(result.signal)}`}`
+    };
   }
   return { ok: true, detail: "" };
 }
@@ -710,8 +765,10 @@ function reexecSelf(env, argv2) {
     env
   });
   if (result.error !== void 0) {
-    process.stderr.write(`harness: upgraded, but re-running failed: ${result.error.message}
-`);
+    process.stderr.write(
+      `harness: upgraded, but re-running failed: ${result.error.message}
+`
+    );
     return 1;
   }
   return result.status ?? 1;
@@ -794,7 +851,10 @@ function autoUpgradeEnabled(env) {
 
 // src/cli.ts
 function promptLine(question) {
-  const readline = createInterface2({ input: process.stdin, output: process.stderr });
+  const readline = createInterface2({
+    input: process.stdin,
+    output: process.stderr
+  });
   return new Promise((resolve) => {
     readline.question(question, (answer) => {
       readline.close();
@@ -804,15 +864,19 @@ function promptLine(question) {
 }
 function exitWith(code) {
   const drain = (stream) => new Promise((resolve) => stream.write("", () => resolve()));
-  return Promise.all([drain(process.stdout), drain(process.stderr)]).then(() => process.exit(code));
+  return Promise.all([drain(process.stdout), drain(process.stderr)]).then(
+    () => process.exit(code)
+  );
 }
+guardBrokenPipes();
 var program = new Command();
 program.name("harness").description("issue tracking for humans and agents (harness.infra.one)").exitOverride().configureOutput({
   writeOut: (text) => process.stdout.write(text),
   writeErr: (text) => process.stderr.write(text)
 });
 function integer(value) {
-  if (!/^\d+$/.test(value)) throw new InvalidArgumentError("expected a non-negative integer");
+  if (!/^\d+$/.test(value))
+    throw new InvalidArgumentError("expected a non-negative integer");
   return Number.parseInt(value, 10);
 }
 function collect(value, previous) {
@@ -858,8 +922,10 @@ async function withConfig(jsonFlag, mutating, run) {
     process.stderr.write(loginResult.human);
     const again = resolveConfig();
     if (again.kind !== "ok") {
-      process.stderr.write(`harness: still not signed in to ${resolved.baseUrl} after logging in
-`);
+      process.stderr.write(
+        `harness: still not signed in to ${resolved.baseUrl} after logging in
+`
+      );
       return exitWith(1);
     }
     return execute(again.config, jsonFlag, mutating, run);
@@ -891,16 +957,20 @@ async function fail(error, hostNotice) {
     return exitWith(1);
   }
   if (error instanceof TransportError) {
-    process.stderr.write(hostNotice + `harness: cannot reach the API: ${clean(error.message)}
-`);
+    process.stderr.write(
+      hostNotice + `harness: cannot reach the API: ${clean(error.message)}
+`
+    );
     return exitWith(3);
   }
   if (error instanceof UpgradeRequiredError) {
     const healed = selfHeal();
     if (healed.kind === "upgraded") return exitWith(healed.code);
     const why = healed.kind === "failed" ? ` (tried to upgrade: ${clean(healed.reason)})` : "";
-    process.stderr.write(hostNotice + `harness: ${clean(error.message)} (HTTP 426)${why}
-`);
+    process.stderr.write(
+      hostNotice + `harness: ${clean(error.message)} (HTTP 426)${why}
+`
+    );
     return exitWith(1);
   }
   if (error instanceof HttpError) {
@@ -919,7 +989,8 @@ async function fail(error, hostNotice) {
 }
 function errorDetails(body) {
   const details = body["details"];
-  if (typeof details !== "object" || details === null || Array.isArray(details)) return "";
+  if (typeof details !== "object" || details === null || Array.isArray(details))
+    return "";
   return Object.entries(details).map(([field, messages]) => {
     const text = Array.isArray(messages) ? messages.map(String).join("; ") : String(messages);
     return `
@@ -927,24 +998,53 @@ function errorDetails(body) {
   }).join("");
 }
 program.command("ready").description("issues ready to work, highest priority first").option("--claim", "atomically claim the first claimable issue").option("--team <key>", "team filter").option("--limit <n>", "page size", integer).option("--page <n>", "page number", integer).option("--all", "follow every page").option("--json", "emit JSON").action(async (opts) => {
-  await withConfig(opts.json === true, opts.claim === true, (ctx) => ready(ctx, opts));
+  await withConfig(
+    opts.json === true,
+    opts.claim === true,
+    (ctx) => ready(ctx, opts)
+  );
 });
 program.command("blocked").description("issues waiting on a blocker").option("--team <key>", "team filter").option("--limit <n>", "page size", integer).option("--page <n>", "page number", integer).option("--all", "follow every page").option("--json", "emit JSON").action(async (opts) => {
-  await withConfig(opts.json === true, false, (ctx) => blocked(ctx, opts));
-});
-program.command("list").description("list issues with filters").option("--status <status>", "open | in_progress | closed").option("--assignee <who>", 'me, a user id, an email, or a full name; "" for unassigned').option("--priority <name>", "urgent | high | medium | low | none").option("--label <name>", "label filter").option("--type <type>", "task | bug | feature | epic").option("--search <query>", "full-text search").option("--team <key>", "team filter").option("--parent <id>", "children of an epic").option("--scope <scope>", "all | archived").option("--limit <n>", "page size", integer).option("--page <n>", "page number", integer).option("--all", "follow every page").option("--json", "emit JSON").action(async (opts) => {
-  await withConfig(opts.json === true, false, (ctx) => list(ctx, opts));
+  await withConfig(
+    opts.json === true,
+    false,
+    (ctx) => blocked(ctx, opts)
+  );
 });
-program.command("search").description("search by meaning \u2014 ranked, exact identifier first; use list --search for paginated filtering").argument("[query...]").option("--limit <n>", "maximum results (default 10, capped at 20)", integer).option("--page <n>", "(deprecated, ignored \u2014 results are ranked and capped)", integer).option("--all", "(deprecated, ignored \u2014 results are ranked and capped)").option("--json", "emit JSON").action(async (query, opts) => {
-  await withConfig(opts.json === true, false, (ctx) => search(ctx, query, opts));
-});
-program.command("show").description("full issue detail; downloads attached images locally").argument("[id]").option("--no-images", "skip attachment downloads").option("--json", "emit JSON").action(async (id, opts) => {
-  await withConfig(opts.json === true, false, (ctx) => {
-    if (id === void 0) throw new UsageError("usage: harness show <id>");
-    requireIdentifiers2([id]);
-    return show(ctx, id, opts);
-  });
+program.command("list").description("list issues with filters").option("--status <status>", "open | in_progress | closed").option(
+  "--assignee <who>",
+  'me, a user id, an email, or a full name; "" for unassigned'
+).option("--priority <name>", "urgent | high | medium | low | none").option("--label <name>", "label filter").option("--type <type>", "task | bug | feature | epic").option("--search <query>", "full-text search").option("--team <key>", "team filter").option("--parent <id>", "children of an epic").option("--scope <scope>", "all | archived").option("--limit <n>", "page size", integer).option("--page <n>", "page number", integer).option("--all", "follow every page").option("--json", "emit JSON").action(async (opts) => {
+  await withConfig(
+    opts.json === true,
+    false,
+    (ctx) => list(ctx, opts)
+  );
 });
+program.command("search").description(
+  "search by meaning \u2014 ranked, exact identifier first; use list --search for paginated filtering"
+).argument("[query...]").option("--limit <n>", "maximum results (default 10, capped at 20)", integer).option(
+  "--page <n>",
+  "(deprecated, ignored \u2014 results are ranked and capped)",
+  integer
+).option("--all", "(deprecated, ignored \u2014 results are ranked and capped)").option("--json", "emit JSON").action(
+  async (query, opts) => {
+    await withConfig(
+      opts.json === true,
+      false,
+      (ctx) => search(ctx, query, opts)
+    );
+  }
+);
+program.command("show").description("full issue detail; downloads attached images locally").argument("[id]").option("--no-images", "skip attachment downloads").option("--json", "emit JSON").action(
+  async (id, opts) => {
+    await withConfig(opts.json === true, false, (ctx) => {
+      if (id === void 0) throw new UsageError("usage: harness show <id>");
+      requireIdentifiers2([id]);
+      return show(ctx, id, opts);
+    });
+  }
+);
 program.command("stats").description("per-team and total counts").option("--json", "emit JSON").action(async (opts) => {
   await withConfig(opts.json === true, false, (ctx) => stats(ctx));
 });
@@ -956,169 +1056,286 @@ program.command("version").description("print CLI and server API versions").opti
   let config = null;
   if (resolved.kind === "ok") config = resolved.config;
   else if (resolved.kind === "needs-login") {
-    config = { baseUrl: resolved.baseUrl, token: "", actor: null, team: null, cacheDir: "" };
+    config = {
+      baseUrl: resolved.baseUrl,
+      token: "",
+      actor: null,
+      team: null,
+      cacheDir: ""
+    };
   }
   const output = await version(config);
-  process.stdout.write(opts.json === true ? json(output.json) : output.human);
+  process.stdout.write(
+    opts.json === true ? json(output.json) : output.human
+  );
   await exitWith(0);
 });
-program.command("create").description("create an issue").option("--title <text>", "issue title (required)").option("--description <text>", "problem statement").option("--design <text>", "design notes").option("--notes <text>", "working notes").option("--acceptance <text>", "acceptance criteria").option("--type <type>", "task | bug | feature | epic (applied as a type/ label)").option("--priority <name>", "urgent | high | medium | low | none").option("--due-date <date>", "YYYY-MM-DD").option("--parent <id>", "parent epic").option("--assignee <who>", "me, a user id, an email, or a full name").option("--team <key>", "team key (or HARNESS_TEAM)").option("--label <name>", "label to apply (repeatable)", collect, []).option("--json", "emit JSON").action(async (opts) => {
-  await withConfig(opts.json === true, true, (ctx) => create(ctx, opts));
-});
-program.command("update").description("update an issue; --claim takes it atomically").argument("[id]").option("--claim", "claim atomically and move to the first started state").option("--state <name>", "workflow state by name or type").option("--title <text>").option("--description <text>").option("--design <text>").option("--notes <text>", "replace the notes").option("--append-notes <text>", "append to the notes").option("--acceptance <text>").option("--priority <name>", "urgent | high | medium | low | none").option("--due-date <date>", 'YYYY-MM-DD; "" clears').option("--parent <id>").option("--assignee <who>", 'me, a user id, an email, or a full name; "" unassigns').option("--json", "emit JSON").action(async (id, opts) => {
-  await withConfig(opts.json === true, true, (ctx) => {
-    if (id === void 0) {
-      throw new UsageError("usage: harness update <id> --claim | --title \u2026 | --state <name> | \u2026");
-    }
-    requireIdentifiers2([id]);
-    return update(ctx, id, opts);
-  });
-});
-program.command("close").description("close issues; the response lists newly unblocked issues").argument("[ids...]").option("--reason <text>", "why it is done (e.g. the commit hash)").option("--cancel", "close as canceled instead of completed").option("--json", "emit JSON").action(async (ids, opts) => {
-  await withConfig(opts.json === true, true, (ctx) => {
-    if (ids.length === 0) {
-      throw new UsageError("usage: harness close <id> [<id>\u2026] [--reason <text>] [--cancel]");
-    }
-    requireIdentifiers2(ids);
-    return close(ctx, ids, opts);
-  });
-});
-program.command("archive").description("archive issues; --restore brings them back").argument("[ids...]").option("--restore", "restore instead of archive").option("--json", "emit JSON").action(async (ids, opts) => {
-  await withConfig(opts.json === true, true, (ctx) => {
-    if (ids.length === 0) throw new UsageError("usage: harness archive <id> [<id>\u2026] [--restore]");
-    requireIdentifiers2(ids);
-    return archive(ctx, ids, opts);
-  });
+program.command("create").description("create an issue").option("--title <text>", "issue title (required)").option("--description <text>", "problem statement").option("--design <text>", "design notes").option("--notes <text>", "working notes").option("--acceptance <text>", "acceptance criteria").option(
+  "--type <type>",
+  "task | bug | feature | epic (applied as a type/ label)"
+).option("--priority <name>", "urgent | high | medium | low | none").option("--due-date <date>", "YYYY-MM-DD").option("--parent <id>", "parent epic").option("--assignee <who>", "me, a user id, an email, or a full name").option("--team <key>", "team key (or HARNESS_TEAM)").option("--label <name>", "label to apply (repeatable)", collect, []).option("--json", "emit JSON").action(async (opts) => {
+  await withConfig(
+    opts.json === true,
+    true,
+    (ctx) => create(ctx, opts)
+  );
 });
+program.command("update").description("update an issue; --claim takes it atomically").argument("[id]").option("--claim", "claim atomically and move to the first started state").option("--state <name>", "workflow state by name or type").option("--title <text>").option("--description <text>").option("--design <text>").option("--notes <text>", "replace the notes").option("--append-notes <text>", "append to the notes").option("--acceptance <text>").option("--priority <name>", "urgent | high | medium | low | none").option("--due-date <date>", 'YYYY-MM-DD; "" clears').option("--parent <id>").option(
+  "--assignee <who>",
+  'me, a user id, an email, or a full name; "" unassigns'
+).option("--json", "emit JSON").action(
+  async (id, opts) => {
+    await withConfig(opts.json === true, true, (ctx) => {
+      if (id === void 0) {
+        throw new UsageError(
+          "usage: harness update <id> --claim | --title \u2026 | --state <name> | \u2026"
+        );
+      }
+      requireIdentifiers2([id]);
+      return update(ctx, id, opts);
+    });
+  }
+);
+program.command("close").description("close issues; the response lists newly unblocked issues").argument("[ids...]").option("--reason <text>", "why it is done (e.g. the commit hash)").option("--cancel", "close as canceled instead of completed").option("--json", "emit JSON").action(
+  async (ids, opts) => {
+    await withConfig(opts.json === true, true, (ctx) => {
+      if (ids.length === 0) {
+        throw new UsageError(
+          "usage: harness close <id> [<id>\u2026] [--reason <text>] [--cancel]"
+        );
+      }
+      requireIdentifiers2(ids);
+      return close(ctx, ids, opts);
+    });
+  }
+);
+program.command("archive").description("archive issues; --restore brings them back").argument("[ids...]").option("--restore", "restore instead of archive").option("--json", "emit JSON").action(
+  async (ids, opts) => {
+    await withConfig(opts.json === true, true, (ctx) => {
+      if (ids.length === 0)
+        throw new UsageError(
+          "usage: harness archive <id> [<id>\u2026] [--restore]"
+        );
+      requireIdentifiers2(ids);
+      return archive(ctx, ids, opts);
+    });
+  }
+);
 program.command("comments").description("an issue's full comment thread, untruncated").argument("[id]").option("--json", "emit JSON").action(async (id, opts) => {
   await withConfig(opts.json === true, false, (ctx) => {
-    if (id === void 0) throw new UsageError("usage: harness comments <id>");
+    if (id === void 0)
+      throw new UsageError("usage: harness comments <id>");
     requireIdentifiers2([id]);
     return comments(ctx, id);
   });
 });
-program.command("dep").description("blocking dependencies: dep add|rm <issue> <blocker>").argument("[verb]").argument("[issue]").argument("[blocker]").option("--json", "emit JSON").action(async (verb, issue, blocker, opts) => {
-  await withConfig(opts.json === true, true, (ctx) => {
-    if (verb === void 0 || issue === void 0 || blocker === void 0) {
-      throw new UsageError("usage: harness dep add|rm <issue> <blocker>");
-    }
-    requireIdentifiers2([issue, blocker]);
-    return dep(ctx, verb, issue, blocker);
-  });
-});
-program.command("comment").description("comment on an issue").argument("[id]").argument("[text...]").option("--mention <name>", "notify a person (repeatable)", collect, []).option("--json", "emit JSON").action(async (id, text, opts) => {
-  await withConfig(opts.json === true, true, (ctx) => {
-    if (id === void 0 || text.length === 0) {
-      throw new UsageError("usage: harness comment <id> <text> [--mention NAME]\u2026");
-    }
-    requireIdentifiers2([id]);
-    const mentions = opts.mention.filter((name) => name.trim() !== "");
-    return comment(ctx, id, text, mentions);
-  });
-});
+program.command("dep").description("blocking dependencies: dep add|rm <issue> <blocker>").argument("[verb]").argument("[issue]").argument("[blocker]").option("--json", "emit JSON").action(
+  async (verb, issue, blocker, opts) => {
+    await withConfig(opts.json === true, true, (ctx) => {
+      if (verb === void 0 || issue === void 0 || blocker === void 0) {
+        throw new UsageError("usage: harness dep add|rm <issue> <blocker>");
+      }
+      requireIdentifiers2([issue, blocker]);
+      return dep(ctx, verb, issue, blocker);
+    });
+  }
+);
+program.command("comment").description("comment on an issue").argument("[id]").argument("[text...]").option("--mention <name>", "notify a person (repeatable)", collect, []).option("--json", "emit JSON").action(
+  async (id, text, opts) => {
+    await withConfig(opts.json === true, true, (ctx) => {
+      if (id === void 0 || text.length === 0) {
+        throw new UsageError(
+          "usage: harness comment <id> <text> [--mention NAME]\u2026"
+        );
+      }
+      requireIdentifiers2([id]);
+      const mentions = opts.mention.filter((name) => name.trim() !== "");
+      return comment(ctx, id, text, mentions);
+    });
+  }
+);
 program.command("attach-image").description("upload an image; prints markdown to reference it").argument("[path]").option("--json", "emit JSON").action(async (path, opts) => {
   await withConfig(opts.json === true, true, (ctx) => {
     if (path === void 0) {
-      throw new UsageError("usage: harness attach-image <path>  (one png, jpg, webp or gif, up to 25 MB)");
+      throw new UsageError(
+        "usage: harness attach-image <path>  (one png, jpg, webp or gif, up to 25 MB)"
+      );
     }
     return attachImage(ctx, path);
   });
 });
 var project = program.command("project").description("projects");
 project.command("list").option("--search <query>", "full-text search").option("--state <state>", "project state filter").option("--limit <n>", "page size", integer).option("--page <n>", "page number", integer).option("--all", "follow every page").option("--json", "emit JSON").action(async (opts) => {
-  await withConfig(opts.json === true, false, (ctx) => projectList(ctx, opts));
+  await withConfig(
+    opts.json === true,
+    false,
+    (ctx) => projectList(ctx, opts)
+  );
 });
 project.command("show").argument("[id]").option("--json", "emit JSON").action(async (id, opts) => {
   await withConfig(opts.json === true, false, (ctx) => {
-    if (id === void 0) throw new UsageError("usage: harness project show <id>");
+    if (id === void 0)
+      throw new UsageError("usage: harness project show <id>");
     return projectShow(ctx, id);
   });
 });
 project.command("create").option("--name <name>", "project name (required)").option("--description <text>").option("--summary <text>").option("--state <state>").option("--lead <user-id>", "lead by user id").option("--start-date <date>", "YYYY-MM-DD").option("--target-date <date>", "YYYY-MM-DD").option("--json", "emit JSON").action(async (opts) => {
-  await withConfig(opts.json === true, true, (ctx) => projectCreate(ctx, opts));
-});
-project.command("update").argument("[id]").option("--name <name>").option("--description <text>").option("--summary <text>").option("--state <state>").option("--lead <user-id>", "lead by user id").option("--start-date <date>", 'YYYY-MM-DD; "" clears').option("--target-date <date>", 'YYYY-MM-DD; "" clears').option("--json", "emit JSON").action(async (id, opts) => {
-  await withConfig(opts.json === true, true, (ctx) => {
-    if (id === void 0) throw new UsageError("usage: harness project update <id> --name \u2026 | --state \u2026 | \u2026");
-    return projectUpdate(ctx, id, opts);
-  });
+  await withConfig(
+    opts.json === true,
+    true,
+    (ctx) => projectCreate(ctx, opts)
+  );
 });
+project.command("update").argument("[id]").option("--name <name>").option("--description <text>").option("--summary <text>").option("--state <state>").option("--lead <user-id>", "lead by user id").option("--start-date <date>", 'YYYY-MM-DD; "" clears').option("--target-date <date>", 'YYYY-MM-DD; "" clears').option("--json", "emit JSON").action(
+  async (id, opts) => {
+    await withConfig(opts.json === true, true, (ctx) => {
+      if (id === void 0)
+        throw new UsageError(
+          "usage: harness project update <id> --name \u2026 | --state \u2026 | \u2026"
+        );
+      return projectUpdate(ctx, id, opts);
+    });
+  }
+);
 var milestone = program.command("milestone").description("project milestones");
 milestone.command("list").option("--project <id>", "project id (required)").option("--json", "emit JSON").action(async (opts) => {
-  await withConfig(opts.json === true, false, (ctx) => milestoneList(ctx, opts.project));
+  await withConfig(
+    opts.json === true,
+    false,
+    (ctx) => milestoneList(ctx, opts.project)
+  );
 });
 milestone.command("create").option("--project <id>", "project id (required)").option("--name <name>", "milestone name (required)").option("--description <text>").option("--target-date <date>", "YYYY-MM-DD").option("--json", "emit JSON").action(async (opts) => {
-  await withConfig(opts.json === true, true, (ctx) => milestoneCreate(ctx, opts));
+  await withConfig(
+    opts.json === true,
+    true,
+    (ctx) => milestoneCreate(ctx, opts)
+  );
 });
 var doc = program.command("doc").description("documents");
 doc.command("list").option("--search <query>", "full-text search").option("--limit <n>", "page size", integer).option("--page <n>", "page number", integer).option("--all", "follow every page").option("--json", "emit JSON").action(async (opts) => {
-  await withConfig(opts.json === true, false, (ctx) => docList(ctx, opts));
+  await withConfig(
+    opts.json === true,
+    false,
+    (ctx) => docList(ctx, opts)
+  );
 });
 doc.command("show").argument("[id]").option("--json", "emit JSON").action(async (id, opts) => {
   await withConfig(opts.json === true, false, (ctx) => {
-    if (id === void 0) throw new UsageError("usage: harness doc show <id>");
+    if (id === void 0)
+      throw new UsageError("usage: harness doc show <id>");
     return docShow(ctx, id);
   });
 });
 doc.command("create").option("--title <title>", "document title (required)").option("--content <text>").option("--project <id>", "attach to a project").option("--json", "emit JSON").action(async (opts) => {
-  await withConfig(opts.json === true, true, (ctx) => docCreate(ctx, opts));
-});
-doc.command("update").argument("[id]").option("--title <title>").option("--content <text>").option("--project <id>").option("--json", "emit JSON").action(async (id, opts) => {
-  await withConfig(opts.json === true, true, (ctx) => {
-    if (id === void 0) throw new UsageError("usage: harness doc update <id> --title \u2026 | --content \u2026 | --project \u2026");
-    return docUpdate(ctx, id, opts);
-  });
+  await withConfig(
+    opts.json === true,
+    true,
+    (ctx) => docCreate(ctx, opts)
+  );
 });
+doc.command("update").argument("[id]").option("--title <title>").option("--content <text>").option("--project <id>").option("--json", "emit JSON").action(
+  async (id, opts) => {
+    await withConfig(opts.json === true, true, (ctx) => {
+      if (id === void 0)
+        throw new UsageError(
+          "usage: harness doc update <id> --title \u2026 | --content \u2026 | --project \u2026"
+        );
+      return docUpdate(ctx, id, opts);
+    });
+  }
+);
 var link = program.command("link").description("URLs attached to an issue (distinct from dep relations)");
 link.command("list").argument("[issue]").option("--json", "emit JSON").action(async (issue, opts) => {
   await withConfig(opts.json === true, false, (ctx) => {
-    if (issue === void 0) throw new UsageError("usage: harness link list <issue>");
+    if (issue === void 0)
+      throw new UsageError("usage: harness link list <issue>");
     requireIdentifiers2([issue]);
     return linkList(ctx, issue);
   });
 });
-link.command("add").argument("[issue]").argument("[url]").option("--title <title>", "link title").option("--json", "emit JSON").action(async (issue, url, opts) => {
-  await withConfig(opts.json === true, true, (ctx) => {
-    if (issue === void 0 || url === void 0) {
-      throw new UsageError("usage: harness link add <issue> <url> [--title <title>]");
-    }
-    requireIdentifiers2([issue]);
-    return linkAdd(ctx, issue, url, opts.title);
-  });
-});
-link.command("rm").argument("[issue]").argument("[id-or-url]").option("--json", "emit JSON").action(async (issue, idOrUrl, opts) => {
-  await withConfig(opts.json === true, true, (ctx) => {
-    if (issue === void 0 || idOrUrl === void 0) {
-      throw new UsageError("usage: harness link rm <issue> <link-id-or-url>");
-    }
-    requireIdentifiers2([issue]);
-    return linkRm(ctx, issue, idOrUrl);
-  });
-});
+link.command("add").argument("[issue]").argument("[url]").option("--title <title>", "link title").option("--json", "emit JSON").action(
+  async (issue, url, opts) => {
+    await withConfig(opts.json === true, true, (ctx) => {
+      if (issue === void 0 || url === void 0) {
+        throw new UsageError(
+          "usage: harness link add <issue> <url> [--title <title>]"
+        );
+      }
+      requireIdentifiers2([issue]);
+      return linkAdd(ctx, issue, url, opts.title);
+    });
+  }
+);
+link.command("rm").argument("[issue]").argument("[id-or-url]").option("--json", "emit JSON").action(
+  async (issue, idOrUrl, opts) => {
+    await withConfig(opts.json === true, true, (ctx) => {
+      if (issue === void 0 || idOrUrl === void 0) {
+        throw new UsageError(
+          "usage: harness link rm <issue> <link-id-or-url>"
+        );
+      }
+      requireIdentifiers2([issue]);
+      return linkRm(ctx, issue, idOrUrl);
+    });
+  }
+);
 var label = program.command("label").description("labels");
 label.command("list").option("--json", "emit JSON").action(async (opts) => {
-  await withConfig(opts.json === true, false, (ctx) => labelList(ctx));
-});
-label.command("create").argument("[name]").option("--color <color>", "label color").option("--json", "emit JSON").action(async (name, opts) => {
-  await withConfig(opts.json === true, true, (ctx) => labelCreate(ctx, name, opts.color));
+  await withConfig(
+    opts.json === true,
+    false,
+    (ctx) => labelList(ctx)
+  );
 });
+label.command("create").argument("[name]").option("--color <color>", "label color").option("--json", "emit JSON").action(
+  async (name, opts) => {
+    await withConfig(
+      opts.json === true,
+      true,
+      (ctx) => labelCreate(ctx, name, opts.color)
+    );
+  }
+);
 var team = program.command("team").description("teams");
 team.command("list").option("--json", "emit JSON").action(async (opts) => {
-  await withConfig(opts.json === true, false, (ctx) => teamList(ctx));
+  await withConfig(
+    opts.json === true,
+    false,
+    (ctx) => teamList(ctx)
+  );
 });
-team.command("create").description("create a team, seeded with the default workflow states").option("--key <key>", "identifier prefix for the team's issues, e.g. IOS (required)").option("--name <name>", "display name (required)").option("--json", "emit JSON").action(async (opts) => {
-  await withConfig(opts.json === true, true, (ctx) => teamCreate(ctx, opts));
+team.command("create").description("create a team, seeded with the default workflow states").option(
+  "--key <key>",
+  "identifier prefix for the team's issues, e.g. IOS (required)"
+).option("--name <name>", "display name (required)").option("--json", "emit JSON").action(async (opts) => {
+  await withConfig(
+    opts.json === true,
+    true,
+    (ctx) => teamCreate(ctx, opts)
+  );
 });
 program.command("states").description("a team's workflow states").option("--team <key>", "team key (or HARNESS_TEAM)").option("--json", "emit JSON").action(async (opts) => {
-  await withConfig(opts.json === true, false, (ctx) => workflowStates(ctx, opts.team));
+  await withConfig(
+    opts.json === true,
+    false,
+    (ctx) => workflowStates(ctx, opts.team)
+  );
 });
 var user = program.command("user").description("users");
 user.command("list").option("--json", "emit JSON").action(async (opts) => {
-  await withConfig(opts.json === true, false, (ctx) => userList(ctx));
+  await withConfig(
+    opts.json === true,
+    false,
+    (ctx) => userList(ctx)
+  );
 });
 program.command("upload").description("upload a file; prints markdown to reference it").argument("[path]").option("--json", "emit JSON").action(async (path, opts) => {
   await withConfig(opts.json === true, true, (ctx) => {
-    if (path === void 0) throw new UsageError("usage: harness upload <path>  (png/jpg/webp/gif, up to 25 MB)");
+    if (path === void 0)
+      throw new UsageError(
+        "usage: harness upload <path>  (png/jpg/webp/gif, up to 25 MB)"
+      );
     return upload(ctx, path);
   });
 });
@@ -1126,25 +1343,35 @@ program.command("mcp").description("run the MCP server over stdio (for agents)")
   const { startMcpServer } = await import("./server-LJXJLWNK.js");
   await startMcpServer();
 });
-program.command("login").description("sign in via the browser (infra.one session)").option("--url <url>", "host to sign in to").option("--no-browser", "print the URL and prompt for a pasted token instead").option("--timeout <ms>", "how long to wait for the browser callback", integer).option("--json", "emit JSON").action(async (opts) => {
-  const repoLookup = findRepoConfig();
-  for (const warning of repoLookup.warnings) process.stderr.write(warning + "\n");
-  const repoUrl = repoLookup.config?.url;
-  const url = opts.url ?? blankToUndefined(process.env["HARNESS_API_URL"]) ?? repoUrl ?? storedLoginUrl() ?? DEFAULT_BASE_URL;
-  if (url === repoUrl && opts.url === void 0 && blankToUndefined(process.env["HARNESS_API_URL"]) === void 0) {
-    process.stderr.write(`harness: host ${url} comes from ${repoLookup.config?.path}
-`);
+program.command("login").description("sign in via the browser (infra.one session)").option("--url <url>", "host to sign in to").option("--no-browser", "print the URL and prompt for a pasted token instead").option(
+  "--timeout <ms>",
+  "how long to wait for the browser callback",
+  integer
+).option("--json", "emit JSON").action(
+  async (opts) => {
+    const repoLookup = findRepoConfig();
+    for (const warning of repoLookup.warnings)
+      process.stderr.write(warning + "\n");
+    const repoUrl = repoLookup.config?.url;
+    const url = opts.url ?? blankToUndefined(process.env["HARNESS_API_URL"]) ?? repoUrl ?? storedLoginUrl() ?? DEFAULT_BASE_URL;
+    if (url === repoUrl && opts.url === void 0 && blankToUndefined(process.env["HARNESS_API_URL"]) === void 0) {
+      process.stderr.write(
+        `harness: host ${url} comes from ${repoLookup.config?.path}
+`
+      );
+    }
+    const options = { noBrowser: !opts.browser };
+    if (opts.timeout !== void 0) options.timeoutMs = opts.timeout;
+    await finishAuth(await login(url, options), opts.json === true);
   }
-  const options = { noBrowser: !opts.browser };
-  if (opts.timeout !== void 0) options.timeoutMs = opts.timeout;
-  await finishAuth(await login(url, options), opts.json === true);
-});
+);
 program.command("logout").description("revoke and forget the stored login").option("--json", "emit JSON").action(async (opts) => {
   await finishAuth(await logout(), opts.json === true);
 });
 program.command("whoami").description("show the resolved host and credential source").option("--json", "emit JSON").action(async (opts) => {
   const resolved = resolveConfig();
-  for (const warning of resolved.warnings) process.stderr.write(warning + "\n");
+  for (const warning of resolved.warnings)
+    process.stderr.write(warning + "\n");
   if (resolved.kind === "error") {
     process.stderr.write(`harness: ${resolved.message}
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allocator-one/harness-cli",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "CLI and MCP server for Harness, allocator.one's issue tracker",
   "type": "module",
   "license": "MIT",