@allocator-one/harness-cli 1.4.1 → 1.5.0

package/dist/{chunk-MF7MQ2L6.js → chunk-FGBXAAKW.js}

@@ -1238,8 +1238,13 @@ async function linkRm(ctx, issue, idOrUrl) {
 async function labelList(ctx) {
   const body = await ctx.client.get("/api/v1/labels");
   const human = body.data.length === 0 ? "No labels.\n" : table(
-    ["NAME", "COLOR", "ID"],
-    body.data.map((label) => [str3(label["name"]), str3(label["color"]) || "-", str3(label["id"])])
+    ["NAME", "COLOR", "ISSUES", "ID"],
+    body.data.map((label) => [
+      str3(label["name"]),
+      str3(label["color"]) || "-",
+      str3(label["issue_count"] ?? 0),
+      str3(label["id"])
+    ])
   );
   return { json: body.data, human };
 }
@@ -1272,8 +1277,13 @@ async function teamCreate(ctx, opts) {
 async function teamList(ctx) {
   const body = await ctx.client.get("/api/v1/teams");
   const human = body.data.length === 0 ? "No teams.\n" : table(
-    ["KEY", "NAME"],
-    body.data.map((team) => [str3(team["key"]), str3(team["name"])])
+    ["KEY", "NAME", "ISSUES", "DEFAULT"],
+    body.data.map((team) => [
+      str3(team["key"]),
+      str3(team["name"]),
+      str3(team["issue_count"] ?? 0),
+      team["is_default"] === true ? "yes" : ""
+    ])
   );
   return { json: body.data, human };
 }
@@ -1281,8 +1291,13 @@ async function workflowStates(ctx, team) {
   const key = requiredTeam({ client: ctx.client, config: ctx.config }, team);
   const body = await ctx.client.get(`/api/v1/teams/${key}/workflow_states`);
   const human = body.data.length === 0 ? "No workflow states.\n" : table(
-    ["NAME", "TYPE"],
-    body.data.map((state) => [str3(state["name"]), str3(state["type"])])
+    ["NAME", "TYPE", "COLOR", "ID"],
+    body.data.map((state) => [
+      str3(state["name"]),
+      str3(state["type"]),
+      str3(state["color"]) || "-",
+      str3(state["id"])
+    ])
   );
   return { json: body.data, human };
 }
@@ -1294,6 +1309,128 @@ async function userList(ctx) {
   );
   return { json: body.data, human };
 }
+async function teamRename(ctx, key, name) {
+  if (key === void 0 || name === void 0) {
+    throw new UsageError("usage: harness team rename <key> --name <name>");
+  }
+  const body = await ctx.client.patch(`/api/v1/teams/${encodeURIComponent(key)}`, { name });
+  return { json: body.data, human: `Renamed ${str3(body.data["key"])} to ${clean(body.data["name"])}
+` };
+}
+async function teamSetDefault(ctx, key) {
+  if (key === void 0) throw new UsageError("usage: harness team set-default <key>");
+  const body = await ctx.client.put(`/api/v1/teams/${encodeURIComponent(key)}/default`, {});
+  return {
+    json: body.data,
+    human: `${str3(body.data["key"])} is now the default filing target
+`
+  };
+}
+async function stateAdd(ctx, opts) {
+  const key = requiredTeam({ client: ctx.client, config: ctx.config }, opts.team);
+  if (opts.name === void 0 || opts.type === void 0) {
+    throw new UsageError("usage: harness state add --name <name> --type <type> [--color <color>] [--team <key>]");
+  }
+  let payload = { name: opts.name, type: opts.type };
+  payload = putOpt2(payload, "color", opts.color);
+  const body = await ctx.client.post(`/api/v1/teams/${key}/workflow_states`, payload);
+  return { json: body.data, human: `Added ${clean(body.data["name"])} to ${key}
+` };
+}
+async function stateUpdate(ctx, id, opts) {
+  const key = requiredTeam({ client: ctx.client, config: ctx.config }, opts.team);
+  if (id === void 0) throw new UsageError("usage: harness state update <id> [--name <name>] [--type <type>] [--color <color>]");
+  if (opts.name === void 0 && opts.type === void 0 && opts.color === void 0) {
+    throw new UsageError("nothing to change \u2014 pass at least one of --name, --type, --color");
+  }
+  let payload = {};
+  payload = putOpt2(payload, "name", opts.name);
+  payload = putOpt2(payload, "type", opts.type);
+  payload = putOpt2(payload, "color", opts.color);
+  const body = await ctx.client.patch(`/api/v1/teams/${key}/workflow_states/${encodeURIComponent(id)}`, payload);
+  return { json: body.data, human: `Updated ${clean(body.data["name"])}
+` };
+}
+async function stateOrder(ctx, ids, opts) {
+  const key = requiredTeam({ client: ctx.client, config: ctx.config }, opts.team);
+  if (ids === void 0) {
+    throw new UsageError("usage: harness state order <id,id,id> [--team <key>] \u2014 every state id, in the order you want");
+  }
+  const state_ids = ids.split(",").map((id) => id.trim()).filter((id) => id !== "");
+  if (state_ids.length === 0) throw new UsageError("no state ids given");
+  const body = await ctx.client.put(`/api/v1/teams/${key}/workflow_states/order`, { state_ids });
+  const human = table(
+    ["NAME", "TYPE"],
+    body.data.map((state) => [str3(state["name"]), str3(state["type"])])
+  );
+  return { json: body.data, human };
+}
+async function stateDelete(ctx, id, opts) {
+  const key = requiredTeam({ client: ctx.client, config: ctx.config }, opts.team);
+  if (id === void 0) throw new UsageError("usage: harness state delete <id> --yes [--team <key>]");
+  requireYes("state delete", id, opts.yes);
+  await ctx.client.delete(`/api/v1/teams/${key}/workflow_states/${encodeURIComponent(id)}`);
+  return { json: { deleted: id }, human: `Deleted workflow state ${id}
+` };
+}
+async function labelUpdate(ctx, id, opts) {
+  if (id === void 0) throw new UsageError("usage: harness label update <id> [--name <name>] [--color <color>]");
+  if (opts.name === void 0 && opts.color === void 0) {
+    throw new UsageError("nothing to change \u2014 pass --name, --color, or both");
+  }
+  let payload = {};
+  payload = putOpt2(payload, "name", opts.name);
+  payload = putOpt2(payload, "color", opts.color);
+  const body = await ctx.client.patch(`/api/v1/labels/${encodeURIComponent(id)}`, payload);
+  return { json: body.data, human: `Updated label ${clean(body.data["name"])}
+` };
+}
+async function labelDelete(ctx, id, opts) {
+  if (id === void 0) throw new UsageError("usage: harness label delete <id> --yes");
+  requireYes("label delete", id, opts.yes);
+  await ctx.client.delete(`/api/v1/labels/${encodeURIComponent(id)}`);
+  return { json: { deleted: id }, human: `Deleted label ${id}
+` };
+}
+async function memberList(ctx) {
+  const body = await ctx.client.get("/api/v1/members");
+  const human = body.data.length === 0 ? "No members.\n" : table(
+    ["NAME", "EMAIL", "RANK", "STANDING", "ID"],
+    body.data.map((member) => [
+      str3(field(member, "user", "name")),
+      str3(field(member, "user", "email")),
+      str3(member["role"]) || "-",
+      str3(member["standing"]),
+      str3(field(member, "user", "id"))
+    ])
+  );
+  return { json: body.data, human };
+}
+async function memberAdd(ctx, opts) {
+  if (opts.email === void 0 || opts.role === void 0) {
+    throw new UsageError("usage: harness member add --email <email> --role <admin|staff|collaborator>");
+  }
+  const body = await ctx.client.post("/api/v1/members", { email: opts.email, role: opts.role });
+  return {
+    json: body.data,
+    human: `Added ${str3(field(body.data, "user", "email"))} as ${str3(body.data["role"])}
+`
+  };
+}
+async function memberSetRole(ctx, userId, opts) {
+  if (userId === void 0 || opts.role === void 0) {
+    throw new UsageError("usage: harness member set-role <user-id> --role <admin|staff|collaborator|none>");
+  }
+  const body = await ctx.client.put(`/api/v1/members/${encodeURIComponent(userId)}/role`, { role: opts.role });
+  const rank = str3(body.data["role"]);
+  const human = rank === "" ? `Revoked the rank for ${str3(field(body.data, "user", "email"))}
+` : `${str3(field(body.data, "user", "email"))} is now ${rank}
+`;
+  return { json: body.data, human };
+}
+function requireYes(command, id, yes) {
+  if (yes !== true) throw new UsageError(`${command} ${id} is destructive \u2014 pass --yes to confirm`);
+}
 async function upload(ctx, path2) {
   return attachImage(ctx, path2);
 }
@@ -1586,6 +1723,17 @@ export {
   teamList,
   workflowStates,
   userList,
+  teamRename,
+  teamSetDefault,
+  stateAdd,
+  stateUpdate,
+  stateOrder,
+  stateDelete,
+  labelUpdate,
+  labelDelete,
+  memberList,
+  memberAdd,
+  memberSetRole,
   upload,
   defaultCredentialsPath,
   readCredentials,

package/dist/cli.js

@@ -28,12 +28,17 @@ import {
   isHostTrusted,
   json,
   labelCreate,
+  labelDelete,
   labelList,
+  labelUpdate,
   linkAdd,
   linkList,
   linkRm,
   list,
   loginHelp,
+  memberAdd,
+  memberList,
+  memberSetRole,
   milestoneCreate,
   milestoneList,
   prime,
@@ -48,9 +53,15 @@ import {
   resolveConfig,
   search,
   show,
+  stateAdd,
+  stateDelete,
+  stateOrder,
+  stateUpdate,
   stats,
   teamCreate,
   teamList,
+  teamRename,
+  teamSetDefault,
   trustHost,
   update,
   upload,
@@ -59,7 +70,7 @@ import {
   version,
   workflowStates,
   writeCredentials
-} from "./chunk-MF7MQ2L6.js";
+} from "./chunk-FGBXAAKW.js";
 
 // src/cli.ts
 import { createInterface as createInterface2 } from "readline";
@@ -150,7 +161,7 @@ function isSet(value) {
 }
 async function loopbackLogin(baseUrl, options) {
   const notify = options.notify ?? defaultNotify;
-  const state = generateState();
+  const state2 = generateState();
   const verifier = generateVerifier();
   const challenge = challengeFor(verifier);
   const server = createServer();
@@ -165,13 +176,13 @@ async function loopbackLogin(baseUrl, options) {
     return { ok: false, message: "could not open a loopback port for the browser handoff" };
   }
   try {
-    const query = new URLSearchParams({ port: String(port), state, challenge });
+    const query = new URLSearchParams({ port: String(port), state: state2, challenge });
     const url = `${baseUrl}/cli/login?${query.toString()}`;
     const openBrowser = options.openBrowser ?? defaultOpenBrowser;
     openBrowser(url);
     notify(`Opening ${url}`);
     notify("Waiting for the browser authorization (Ctrl-C to abort)\u2026");
-    const code = await awaitCallback(server, state, options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+    const code = await awaitCallback(server, state2, options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
     if (!code.ok) return code;
     const token = await exchangeCode(baseUrl, code.code, verifier, options);
     if (!token.ok) return token;
@@ -181,7 +192,7 @@ async function loopbackLogin(baseUrl, options) {
     server.close();
   }
 }
-function awaitCallback(server, state, timeoutMs) {
+function awaitCallback(server, state2, timeoutMs) {
   return new Promise((resolve) => {
     const timer = setTimeout(() => {
       resolve({ ok: false, message: "timed out waiting for the browser authorization" });
@@ -203,7 +214,7 @@ function awaitCallback(server, state, timeoutMs) {
         return;
       }
       const code = url.searchParams.get("code");
-      if (url.searchParams.get("state") === state && code !== null && code !== "") {
+      if (url.searchParams.get("state") === state2 && code !== null && code !== "") {
         respond(200, "Signed in \u2014 you can close this tab and return to the terminal.");
         clearTimeout(timer);
         resolve({ ok: true, code });
@@ -1297,6 +1308,12 @@ label.command("create").argument("[name]").option("--color <color>", "label colo
     );
   }
 );
+label.command("update").description("rename or recolor a label").argument("[id]").option("--name <name>", "new name").option("--color <color>", "swatch name (red, blue, \u2026) or a hex code").option("--json", "emit JSON").action(async (id, opts) => {
+  await withConfig(opts.json === true, true, (ctx) => labelUpdate(ctx, id, opts));
+});
+label.command("delete").description("delete a label (refused while issues carry it)").argument("[id]").option("--yes", "confirm the deletion").option("--json", "emit JSON").action(async (id, opts) => {
+  await withConfig(opts.json === true, true, (ctx) => labelDelete(ctx, id, opts));
+});
 var team = program.command("team").description("teams");
 team.command("list").option("--json", "emit JSON").action(async (opts) => {
   await withConfig(
@@ -1315,7 +1332,41 @@ team.command("create").description("create a team, seeded with the default workf
     (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) => {
+team.command("rename").description("rename a team (the key is create-only)").argument("[key]").option("--name <name>", "new display name").option("--json", "emit JSON").action(async (key, opts) => {
+  await withConfig(opts.json === true, true, (ctx) => teamRename(ctx, key, opts.name));
+});
+team.command("set-default").description("make this team the organization's default filing target").argument("[key]").option("--json", "emit JSON").action(async (key, opts) => {
+  await withConfig(opts.json === true, true, (ctx) => teamSetDefault(ctx, key));
+});
+var state = program.command("state").description("a team's workflow states");
+state.command("list").description("list 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));
+});
+state.command("add").description("add a workflow state, appended after the team's existing ones").option("--team <key>", "team key (or HARNESS_TEAM)").option("--name <name>", "display name (required)").option("--type <type>", "backlog | unstarted | started | completed | canceled (required)").option("--color <color>", "swatch name").option("--json", "emit JSON").action(async (opts) => {
+  await withConfig(opts.json === true, true, (ctx) => stateAdd(ctx, opts));
+});
+state.command("update").description("rename, retype or recolor a workflow state").argument("[id]").option("--team <key>", "team key (or HARNESS_TEAM)").option("--name <name>", "new name").option("--type <type>", "new type").option("--color <color>", "new swatch name").option("--json", "emit JSON").action(
+  async (id, opts) => {
+    await withConfig(opts.json === true, true, (ctx) => stateUpdate(ctx, id, opts));
+  }
+);
+state.command("order").description("reorder a team's states \u2014 pass EVERY state id, comma separated, in the order you want").argument("[ids]").option("--team <key>", "team key (or HARNESS_TEAM)").option("--json", "emit JSON").action(async (ids, opts) => {
+  await withConfig(opts.json === true, true, (ctx) => stateOrder(ctx, ids, opts));
+});
+state.command("delete").description("delete a workflow state (refused while issues sit in it)").argument("[id]").option("--team <key>", "team key (or HARNESS_TEAM)").option("--yes", "confirm the deletion").option("--json", "emit JSON").action(async (id, opts) => {
+  await withConfig(opts.json === true, true, (ctx) => stateDelete(ctx, id, opts));
+});
+var member = program.command("member").description("the organization's tracker roster");
+member.command("list").description("who can reach this organization's tracker, and at what rank").option("--json", "emit JSON").action(async (opts) => {
+  await withConfig(opts.json === true, false, (ctx) => memberList(ctx));
+});
+member.command("add").description("grant a rank to an existing account, minting the membership").option("--email <email>", "address of an existing account (required)").option("--role <role>", "admin | staff | collaborator (required)").option("--json", "emit JSON").action(async (opts) => {
+  await withConfig(opts.json === true, true, (ctx) => memberAdd(ctx, opts));
+});
+member.command("set-role").description("change or revoke a member's rank; none revokes").argument("[user-id]").option("--role <role>", "admin | staff | collaborator | none (required)").option("--json", "emit JSON").action(async (userId, opts) => {
+  await withConfig(opts.json === true, true, (ctx) => memberSetRole(ctx, userId, opts));
+});
+program.command("states").description("a team's workflow states (alias of `state list`)").option("--team <key>", "team key (or HARNESS_TEAM)").option("--json", "emit JSON").action(async (opts) => {
   await withConfig(
     opts.json === true,
     false,
@@ -1340,7 +1391,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-LJXJLWNK.js");
+  const { startMcpServer } = await import("./server-ZRD4RTFU.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-LJXJLWNK.js → server-ZRD4RTFU.js}

@@ -17,11 +17,16 @@ import {
   docShow,
   docUpdate,
   labelCreate,
+  labelDelete,
   labelList,
+  labelUpdate,
   linkAdd,
   linkList,
   linkRm,
   list,
+  memberAdd,
+  memberList,
+  memberSetRole,
   milestoneCreate,
   milestoneList,
   projectCreate,
@@ -32,14 +37,20 @@ import {
   resolveConfig,
   search,
   show,
+  stateAdd,
+  stateDelete,
+  stateOrder,
+  stateUpdate,
   stats,
   teamCreate,
   teamList,
+  teamRename,
+  teamSetDefault,
   update,
   upload,
   userList,
   workflowStates
-} from "./chunk-MF7MQ2L6.js";
+} from "./chunk-FGBXAAKW.js";
 
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -416,6 +427,120 @@ var TOOLS = [
     shape: { team: z.string().optional().describe("team key; defaults to HARNESS_TEAM") },
     handler: (ctx, args) => workflowStates(ctx, args["team"])
   },
+  {
+    name: "team_rename",
+    description: "Rename a team. The key is create-only \u2014 it is the identifier prefix of every issue filed under the team \u2014 so this changes the display name only. Needs Harness administrator standing.",
+    readOnly: false,
+    shape: {
+      key: z.string().describe("team key, e.g. IOS"),
+      name: z.string().describe("new display name")
+    },
+    handler: (ctx, args) => teamRename(ctx, args["key"], args["name"])
+  },
+  {
+    name: "team_set_default",
+    description: "Make a team the organization's default filing target, clearing the previous default. Needs Harness administrator standing.",
+    readOnly: false,
+    shape: { key: z.string().describe("team key") },
+    handler: (ctx, args) => teamSetDefault(ctx, args["key"])
+  },
+  {
+    name: "state_add",
+    description: "Add a workflow state to a team, appended after its existing states. Type is one of backlog, unstarted, started, completed, canceled. Needs Harness administrator standing.",
+    readOnly: false,
+    shape: {
+      name: z.string().describe("display name"),
+      type: z.string().describe("backlog | unstarted | started | completed | canceled"),
+      color: z.string().optional().describe("swatch name"),
+      team: z.string().optional().describe("team key; defaults to HARNESS_TEAM")
+    },
+    handler: (ctx, args) => stateAdd(ctx, { team: args["team"], name: args["name"], type: args["type"], color: args["color"] })
+  },
+  {
+    name: "state_update",
+    description: "Rename, retype or recolor one of a team's workflow states. Pass at least one of name, type, color. Needs Harness administrator standing.",
+    readOnly: false,
+    shape: {
+      id: z.string().describe("workflow state id (from workflow_states)"),
+      name: z.string().optional(),
+      type: z.string().optional().describe("backlog | unstarted | started | completed | canceled"),
+      color: z.string().optional().describe("swatch name"),
+      team: z.string().optional().describe("team key; defaults to HARNESS_TEAM")
+    },
+    handler: (ctx, args) => stateUpdate(ctx, args["id"], {
+      team: args["team"],
+      name: args["name"],
+      type: args["type"],
+      color: args["color"]
+    })
+  },
+  {
+    name: "state_order",
+    description: "Reorder a team's workflow states. Send EVERY state id, in the order you want them \u2014 a partial list is refused rather than half-applied, because renumbering part of the order would collide with the positions it left alone. Call workflow_states first to get the ids. Needs Harness administrator standing.",
+    readOnly: false,
+    shape: {
+      state_ids: z.string().describe("comma-separated state ids, in the desired order \u2014 all of them"),
+      team: z.string().optional().describe("team key; defaults to HARNESS_TEAM")
+    },
+    handler: (ctx, args) => stateOrder(ctx, args["state_ids"], { team: args["team"] })
+  },
+  {
+    name: "state_delete",
+    description: "Delete a workflow state. Refused while issues still sit in it \u2014 move them out first. Needs Harness administrator standing.",
+    readOnly: false,
+    shape: {
+      id: z.string().describe("workflow state id"),
+      team: z.string().optional().describe("team key; defaults to HARNESS_TEAM")
+    },
+    // `yes` is the CLI's typo guard for a human at a shell; an MCP call is
+    // already an explicit, named request to delete this id.
+    handler: (ctx, args) => stateDelete(ctx, args["id"], { team: args["team"], yes: true })
+  },
+  {
+    name: "label_update",
+    description: "Rename or recolor a label. Color is a swatch name (purple, green, red, yellow, pink, blue, orange, gray) or a hex code. Needs Harness administrator standing.",
+    readOnly: false,
+    shape: {
+      id: z.string().describe("label id (from label_list)"),
+      name: z.string().optional(),
+      color: z.string().optional().describe("swatch name or hex code")
+    },
+    handler: (ctx, args) => labelUpdate(ctx, args["id"], { name: args["name"], color: args["color"] })
+  },
+  {
+    name: "label_delete",
+    description: "Delete a label. Refused while issues still carry it, or while other labels are nested under it. Needs Harness administrator standing.",
+    readOnly: false,
+    shape: { id: z.string().describe("label id") },
+    handler: (ctx, args) => labelDelete(ctx, args["id"], { yes: true })
+  },
+  {
+    name: "member_list",
+    description: "Who can reach THIS organization's tracker, and at what rank \u2014 its grant holders plus its own admins. Not the same as user_list, which is the deployment-wide assignee picker and never lists a collaborator. Each entry carries both role (the granted rank, absent for an org admin) and standing (what that rank resolves to). Needs Harness administrator standing.",
+    readOnly: true,
+    shape: {},
+    handler: (ctx) => memberList(ctx)
+  },
+  {
+    name: "member_add",
+    description: "Grant a tracker rank to an existing account by email, minting the organization membership if they have none. The account must already exist. Refused if they are already on the roster \u2014 use member_set_role to change a rank. Needs Harness administrator standing.",
+    readOnly: false,
+    shape: {
+      email: z.string().describe("address of an existing account"),
+      role: z.string().describe("admin | staff | collaborator")
+    },
+    handler: (ctx, args) => memberAdd(ctx, { email: args["email"], role: args["role"] })
+  },
+  {
+    name: "member_set_role",
+    description: "Change or revoke a member's tracker rank; 'none' revokes. Refused when it would remove the organization's last Harness administrator. Needs Harness administrator standing.",
+    readOnly: false,
+    shape: {
+      user_id: z.string().describe("the member's user id (from member_list)"),
+      role: z.string().describe("admin | staff | collaborator | none")
+    },
+    handler: (ctx, args) => memberSetRole(ctx, args["user_id"], { role: args["role"] })
+  },
   {
     name: "user_list",
     description: "List users (for assignee resolution).",

package/package.json

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