@allocator-one/harness-cli 1.5.2 → 1.7.0

package/dist/cli.js

@@ -6,6 +6,8 @@ import {
   DEFAULT_BASE_URL,
   HttpError,
   LocalError,
+  RELATION_CREATE_TYPES,
+  RELATION_UPDATE_TYPES,
   TransportError,
   UpgradeRequiredError,
   UsageError,
@@ -18,12 +20,14 @@ import {
   comments,
   create,
   defaultCredentialsPath,
+  deleteComment,
   deleteCredentials,
   dep,
   docCreate,
   docList,
   docShow,
   docUpdate,
+  editComment,
   findRepoConfig,
   isHostTrusted,
   json,
@@ -34,6 +38,7 @@ import {
   linkAdd,
   linkList,
   linkRm,
+  linkUpdate,
   list,
   loginHelp,
   memberAdd,
@@ -48,6 +53,11 @@ import {
   projectUpdate,
   readCredentials,
   ready,
+  relationAdd,
+  relationList,
+  relationRm,
+  relationUpdate,
+  requireCommentId,
   requireIdentifiers,
   resolveCacheHome,
   resolveConfig,
@@ -70,7 +80,7 @@ import {
   version,
   workflowStates,
   writeCredentials
-} from "./chunk-CIW4OU5G.js";
+} from "./chunk-ZHFW6PRC.js";
 
 // src/cli.ts
 import { createInterface as createInterface2 } from "readline";
@@ -1000,6 +1010,23 @@ function integer(value) {
 function collect(value, previous) {
   return [...previous, value];
 }
+function resolvedCommentBody(text, bodyFile, action = "post") {
+  if (bodyFile !== void 0 && text.length > 0) {
+    throw new UsageError(
+      "comment text and --body-file both given \u2014 pass one; there is no precedence between them"
+    );
+  }
+  const fromFile = resolveTextSources([
+    { name: "body", inline: void 0, file: bodyFile }
+  ]).body;
+  const body = fromFile === void 0 ? text : [fromFile];
+  if (body.join(" ").trim() === "") {
+    throw new UsageError(
+      bodyFile === void 0 ? `the comment text is empty \u2014 nothing to ${action}` : `--body-file ${bodyFile} produced an empty comment \u2014 nothing to ${action}`
+    );
+  }
+  return body;
+}
 var requireIdentifiers2 = requireIdentifiers;
 function interactive() {
   const ci = process.env["CI"];
@@ -1208,10 +1235,15 @@ function requireNonBlankTitle(text, titleFile) {
     titleFile === void 0 ? "--title is empty \u2014 an issue needs a title" : `--title-file ${titleFile} produced an empty title`
   );
 }
-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("--title-file <path>", 'read the title from a file ("-" for stdin)').option("--description-file <path>", 'read the description from a file ("-" for stdin)').option("--design-file <path>", 'read the design notes from a file ("-" for stdin)').option("--notes-file <path>", 'read the notes from a file ("-" for stdin)').option("--acceptance-file <path>", 'read the acceptance criteria from a file ("-" for stdin)').option(
+program.command("create").description("create an issue atomically after resolving requested labels").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("--title-file <path>", 'read the title from a file ("-" for stdin)').option("--description-file <path>", 'read the description from a file ("-" for stdin)').option("--design-file <path>", 'read the design notes from a file ("-" for stdin)').option("--notes-file <path>", 'read the notes from a file ("-" for stdin)').option("--acceptance-file <path>", 'read the acceptance criteria from a file ("-" for stdin)').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) => {
+).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>",
+  "resolve team-first, then workspace; create missing workspace labels before the issue (repeatable)",
+  collect,
+  []
+).option("--json", "emit JSON").action(async (opts) => {
   await withConfig(opts.json === true, true, (ctx) => {
     if (opts.title === void 0 && opts.titleFile === void 0) {
       throw new UsageError(
@@ -1227,6 +1259,16 @@ program.command("create").description("create an issue").option("--title <text>"
 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("--title-file <path>", 'read the title from a file ("-" for stdin)').option("--description-file <path>", 'read the description from a file ("-" for stdin)').option("--design-file <path>", 'read the design notes from a file ("-" for stdin)').option("--notes-file <path>", 'replace the notes from a file ("-" for stdin)').option("--append-notes-file <path>", 'append to the notes from a file ("-" for stdin)').option("--acceptance-file <path>", 'read the acceptance criteria from a file ("-" for stdin)').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(
+  "--add-label <name-or-id>",
+  "add a label without replacing existing labels (repeatable)",
+  collect,
+  []
+).option(
+  "--remove-label <name-or-id>",
+  "remove an attached label without replacing others (repeatable)",
+  collect,
+  []
 ).option("--json", "emit JSON").action(
   async (id, opts) => {
     await withConfig(opts.json === true, true, (ctx) => {
@@ -1298,7 +1340,42 @@ program.command("dep").description("blocking dependencies: dep add|rm <issue> <b
     });
   }
 );
-program.command("comment").description("comment on an issue").argument("[id]").argument("[text...]").option("--body-file <path>", 'read the comment body from a file ("-" for stdin)').option("--mention <name>", "notify a person (repeatable)", collect, []).option("--json", "emit JSON").action(
+var relation = program.command("relation").description("typed issue relations; dep remains the blocking-dependency shorthand");
+relation.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 relation list <issue>");
+    return relationList(ctx, issue);
+  });
+});
+relation.command("add").argument("[issue]").argument("[related-issue]").requiredOption("--type <type>", `relation type: ${RELATION_CREATE_TYPES.join(", ")}`).option("--json", "emit JSON").action(
+  async (issue, relatedIssue, opts) => {
+    await withConfig(opts.json === true, true, (ctx) => {
+      if (issue === void 0 || relatedIssue === void 0) {
+        throw new UsageError("usage: harness relation add <issue> <related-issue> --type <type>");
+      }
+      return relationAdd(ctx, issue, relatedIssue, opts.type);
+    });
+  }
+);
+relation.command("update").argument("[issue]").argument("[id-or-issue]").requiredOption("--type <type>", `relation type: ${RELATION_UPDATE_TYPES.join(", ")}`).option("--json", "emit JSON").action(
+  async (issue, idOrIssue, opts) => {
+    await withConfig(opts.json === true, true, (ctx) => {
+      if (issue === void 0 || idOrIssue === void 0) {
+        throw new UsageError("usage: harness relation update <issue> <relation-id-or-issue> --type <type>");
+      }
+      return relationUpdate(ctx, issue, idOrIssue, opts.type);
+    });
+  }
+);
+relation.command("rm").argument("[issue]").argument("[id-or-issue]").option("--json", "emit JSON").action(async (issue, idOrIssue, opts) => {
+  await withConfig(opts.json === true, true, (ctx) => {
+    if (issue === void 0 || idOrIssue === void 0) {
+      throw new UsageError("usage: harness relation rm <issue> <relation-id-or-issue>");
+    }
+    return relationRm(ctx, issue, idOrIssue);
+  });
+});
+var commentCommand = program.command("comment").description("comment on an issue").argument("[id]").argument("[text...]").option("--body-file <path>", 'read the comment body from a file ("-" for stdin)').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 || opts.bodyFile === void 0 && text.length === 0) {
@@ -1307,25 +1384,39 @@ program.command("comment").description("comment on an issue").argument("[id]").a
         );
       }
       requireIdentifiers2([id]);
-      if (opts.bodyFile !== void 0 && text.length > 0) {
-        throw new UsageError(
-          "comment text and --body-file both given \u2014 pass one; there is no precedence between them"
-        );
-      }
-      const fromFile = resolveTextSources([
-        { name: "body", inline: void 0, file: opts.bodyFile }
-      ]).body;
-      const body = fromFile === void 0 ? text : [fromFile];
-      if (body.join(" ").trim() === "") {
+      const body = resolvedCommentBody(text, opts.bodyFile);
+      const mentions = opts.mention.filter((name) => name.trim() !== "");
+      return comment(ctx, id, body, mentions);
+    });
+  }
+);
+commentCommand.command("edit").description("edit one of your issue comments").argument("[issue]").argument("[comment-id]").argument("[text...]").option("--body-file <path>", 'read the replacement body from a file ("-" for stdin)').option("--json", "emit JSON").action(
+  async (issue, commentId, text, opts) => {
+    const parentOpts = commentCommand.opts();
+    const bodyFile = opts.bodyFile ?? parentOpts.bodyFile;
+    await withConfig(opts.json === true || parentOpts.json === true, true, (ctx) => {
+      if (issue === void 0 || commentId === void 0 || bodyFile === void 0 && text.length === 0) {
         throw new UsageError(
-          opts.bodyFile === void 0 ? "the comment text is empty \u2014 nothing to post" : `--body-file ${opts.bodyFile} produced an empty comment \u2014 nothing to post`
+          "usage: harness comment edit <issue> <comment-id> <text> | harness comment edit <issue> <comment-id> --body-file <path>"
         );
       }
-      const mentions = opts.mention.filter((name) => name.trim() !== "");
-      return comment(ctx, id, body, mentions);
+      requireIdentifiers2([issue]);
+      requireCommentId(commentId);
+      return editComment(ctx, issue, commentId, resolvedCommentBody(text, bodyFile, "edit"));
     });
   }
 );
+commentCommand.command("delete").alias("rm").description("delete one of your issue comments").argument("[issue]").argument("[comment-id]").option("--json", "emit JSON").action(async (issue, commentId, opts) => {
+  const parentOpts = commentCommand.opts();
+  await withConfig(opts.json === true || parentOpts.json === true, true, (ctx) => {
+    if (issue === void 0 || commentId === void 0) {
+      throw new UsageError("usage: harness comment delete <issue> <comment-id>");
+    }
+    requireIdentifiers2([issue]);
+    requireCommentId(commentId);
+    return deleteComment(ctx, issue, commentId);
+  });
+});
 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) {
@@ -1439,6 +1530,18 @@ link.command("add").argument("[issue]").argument("[url]").option("--title <title
     });
   }
 );
+link.command("update").argument("[issue]").argument("[id-or-url]").option("--url <url>", "replacement URL").option("--title <title>", "replacement title; pass an empty value to clear").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 update <issue> <link-id-or-url> --url <url> | --title <title>"
+        );
+      }
+      return linkUpdate(ctx, issue, idOrUrl, opts);
+    });
+  }
+);
 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) => {
@@ -1552,7 +1655,7 @@ program.command("upload").description("upload a file; prints markdown to referen
   });
 });
 program.command("mcp").description("run the MCP server over stdio (for agents)").action(async () => {
-  const { startMcpServer } = await import("./server-J2V5JXFY.js");
+  const { startMcpServer } = await import("./server-J6FQFVBJ.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(

package/dist/{server-J2V5JXFY.js → server-J6FQFVBJ.js}

@@ -3,6 +3,8 @@ import {
   CLI_VERSION,
   Client,
   HttpError,
+  RELATION_CREATE_TYPES,
+  RELATION_UPDATE_TYPES,
   TransportError,
   UsageError,
   archive,
@@ -11,11 +13,13 @@ import {
   comment,
   comments,
   create,
+  deleteComment,
   dep,
   docCreate,
   docList,
   docShow,
   docUpdate,
+  editComment,
   labelCreate,
   labelDelete,
   labelList,
@@ -23,6 +27,7 @@ import {
   linkAdd,
   linkList,
   linkRm,
+  linkUpdate,
   list,
   memberAdd,
   memberList,
@@ -34,6 +39,10 @@ import {
   projectShow,
   projectUpdate,
   ready,
+  relationAdd,
+  relationList,
+  relationRm,
+  relationUpdate,
   resolveConfig,
   search,
   show,
@@ -50,7 +59,7 @@ import {
   upload,
   userList,
   workflowStates
-} from "./chunk-CIW4OU5G.js";
+} from "./chunk-ZHFW6PRC.js";
 
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -98,6 +107,7 @@ var page = {
   all: z.boolean().optional().describe("follow every page")
 };
 var identifier = z.string().describe("issue identifier, e.g. IO-123");
+var commentId = z.string().uuid().describe("comment UUID from issue_show or comment_list");
 var dateField = z.string().optional().describe('YYYY-MM-DD; "" clears the date');
 var TOOLS = [
   // ── Issues ──
@@ -189,13 +199,17 @@ var TOOLS = [
       due_date: dateField,
       state: z.string().optional().describe("workflow state by name or type"),
       parent: z.string().optional(),
-      assignee: z.string().optional().describe('"" unassigns')
+      assignee: z.string().optional().describe('"" unassigns'),
+      add_labels: z.array(z.string()).optional().describe("label names or ids to add without replacing existing labels"),
+      remove_labels: z.array(z.string()).optional().describe("attached label names or ids to remove without replacing others")
     },
     handler: (ctx, args) => update(ctx, args["id"], {
       ...args,
       acceptance: args["acceptance_criteria"],
       appendNotes: args["append_notes"],
-      dueDate: args["due_date"]
+      dueDate: args["due_date"],
+      addLabel: args["add_labels"],
+      removeLabel: args["remove_labels"]
     })
   },
   {
@@ -227,6 +241,27 @@ var TOOLS = [
     },
     handler: (ctx, args) => comment(ctx, args["id"], [args["body"]], args["mentions"] ?? [])
   },
+  {
+    name: "issue_comment_edit",
+    description: "Edit one of your issue comments within its edit window.",
+    readOnly: false,
+    shape: {
+      id: identifier,
+      comment_id: commentId,
+      body: z.string().min(1).refine((body) => body.trim() !== "", "comment body must not be blank")
+    },
+    handler: (ctx, args) => editComment(ctx, args["id"], args["comment_id"], [args["body"]])
+  },
+  {
+    name: "issue_comment_delete",
+    description: "Delete one of your issue comments.",
+    readOnly: false,
+    shape: {
+      id: identifier,
+      comment_id: commentId
+    },
+    handler: (ctx, args) => deleteComment(ctx, args["id"], args["comment_id"])
+  },
   {
     name: "issue_archive",
     description: "Archive issues (or restore them with restore=true). Archived issues show up under scope=archived.",
@@ -241,7 +276,7 @@ var TOOLS = [
     shape: { id: identifier },
     handler: (ctx, args) => comments(ctx, args["id"])
   },
-  // ── Relations (blocking dependencies) ──
+  // ── Relations ──
   {
     name: "relation_add",
     description: "Add a blocking dependency: blocker blocks issue.",
@@ -256,6 +291,42 @@ var TOOLS = [
     shape: { issue: identifier, blocker: identifier },
     handler: (ctx, args) => dep(ctx, "rm", args["issue"], args["blocker"])
   },
+  {
+    name: "relation_list",
+    description: "List every typed relation on an issue, including stable relation ids.",
+    readOnly: true,
+    shape: { issue: identifier },
+    handler: (ctx, args) => relationList(ctx, args["issue"])
+  },
+  {
+    name: "relation_create",
+    description: "Create a typed relation between two issues.",
+    readOnly: false,
+    shape: {
+      issue: identifier,
+      related_issue: identifier,
+      type: z.enum(RELATION_CREATE_TYPES)
+    },
+    handler: (ctx, args) => relationAdd(ctx, args["issue"], args["related_issue"], args["type"])
+  },
+  {
+    name: "relation_update",
+    description: "Change a relation's direction, resolving it by relation id or unique related issue.",
+    readOnly: false,
+    shape: {
+      issue: identifier,
+      id_or_issue: z.string(),
+      type: z.enum(RELATION_UPDATE_TYPES)
+    },
+    handler: (ctx, args) => relationUpdate(ctx, args["issue"], args["id_or_issue"], args["type"])
+  },
+  {
+    name: "relation_delete",
+    description: "Remove a typed relation by relation id or unique related issue.",
+    readOnly: false,
+    shape: { issue: identifier, id_or_issue: z.string() },
+    handler: (ctx, args) => relationRm(ctx, args["issue"], args["id_or_issue"])
+  },
   // ── Links (URLs on an issue) ──
   {
     name: "link_list",
@@ -271,6 +342,20 @@ var TOOLS = [
     shape: { issue: identifier, url: z.string(), title: z.string().optional() },
     handler: (ctx, args) => linkAdd(ctx, args["issue"], args["url"], args["title"])
   },
+  {
+    name: "link_update",
+    description: "Edit a link by link id or exact URL.",
+    readOnly: false,
+    shape: {
+      issue: identifier,
+      id_or_url: z.string(),
+      change: z.union([
+        z.object({ url: z.string(), title: z.string().optional() }),
+        z.object({ title: z.string(), url: z.string().optional() })
+      ])
+    },
+    handler: (ctx, args) => linkUpdate(ctx, args["issue"], args["id_or_url"], args["change"])
+  },
   {
     name: "link_rm",
     description: "Remove a link from an issue, by link id or exact URL.",

package/package.json

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