@allocator-one/harness-cli 1.0.0 → 1.1.0

package/README.md

@@ -56,7 +56,7 @@ tool — issue_list, issue_show, issue_create, issue_update, issue_claim,
 issue_close, issue_comment, relation_add/rm, link_list/add/rm,
 project_list/show/create/update, milestone_list/create,
 document_list/show/create/update, label_list/create, team_list,
-workflow_states, user_list, stats, upload. Read-only tools carry
+team_create, workflow_states, user_list, stats, upload. Read-only tools carry
 `readOnlyHint`. Results are compact JSON of the data envelope.
 
 Register it with Claude Code:

package/dist/{chunk-KN5ILZSA.js → chunk-JOT3TGQQ.js}

@@ -108,7 +108,11 @@ var Client = class {
   async getBytes(path2) {
     const response = await this.raw("GET", path2, {});
     if (!response.ok) throw await this.toHttpError(response);
-    return new Uint8Array(await response.arrayBuffer());
+    try {
+      return new Uint8Array(await response.arrayBuffer());
+    } catch (error) {
+      throw new TransportError(transportMessage(error));
+    }
   }
   /**
    * The server's API version, for `version`'s server side. The header rides
@@ -155,7 +159,12 @@ var Client = class {
   }
   async json(response) {
     if (!response.ok) throw await this.toHttpError(response);
-    const text = await response.text();
+    let text;
+    try {
+      text = await response.text();
+    } catch (error) {
+      throw new TransportError(transportMessage(error));
+    }
     if (text === "") return { data: void 0 };
     try {
       return JSON.parse(text);
@@ -505,7 +514,7 @@ function pageCount(meta) {
 function dedupe(records) {
   const seen = /* @__PURE__ */ new Set();
   return records.filter((record) => {
-    const key = record["id"] ?? record;
+    const key = record["id"] ?? JSON.stringify(record);
     if (seen.has(key)) return false;
     seen.add(key);
     return true;
@@ -1016,7 +1025,7 @@ function str2(value) {
 }
 
 // src/commands/extended.ts
-var SAFE_ID = /^[A-Za-z0-9._-]+$/;
+var SAFE_ID = /^(?!\.{1,2}$)[A-Za-z0-9._-]+$/;
 function requireSafeId(kind, id) {
   if (!SAFE_ID.test(id)) throw new UsageError(`not a ${kind} id: ${id}`);
 }
@@ -1219,7 +1228,7 @@ async function linkRm(ctx, issue, idOrUrl) {
   const body = await ctx.client.get(`/api/v1/issues/${issue}/links`);
   const link = body.data.find((candidate) => candidate["id"] === idOrUrl || candidate["url"] === idOrUrl);
   if (link === void 0) {
-    throw new UsageError(`no link on ${issue} matches ${idOrUrl} (by id or exact URL)`);
+    throw new CommandError(`no link on ${issue} matches ${idOrUrl} (by id or exact URL)`);
   }
   await ctx.client.delete(`/api/v1/issues/${issue}/links/${str3(link["id"])}`);
   return { json: { deleted: link["id"] }, human: `Removed ${clean(link["url"])} from ${issue}
@@ -1241,6 +1250,24 @@ async function labelCreate(ctx, name, color) {
   return { json: response.data, human: `Created label ${clean(response.data["name"])}
 ` };
 }
+var TEAM_CREATE_KEY = /^[A-Za-z][A-Za-z0-9]*$/;
+async function teamCreate(ctx, opts) {
+  if (opts.key === void 0 || opts.name === void 0) {
+    throw new UsageError("usage: harness team create --key <key> --name <name>");
+  }
+  if (!TEAM_CREATE_KEY.test(opts.key)) {
+    throw new UsageError(`not a team key: ${opts.key} (expected e.g. ALL \u2014 letters and digits, letter first)`);
+  }
+  const created = await ctx.client.post("/api/v1/teams", { key: opts.key, name: opts.name });
+  const team = created.data;
+  const states = await ctx.client.get(`/api/v1/teams/${str3(team["key"])}/workflow_states`);
+  const human = `Created team ${str3(team["key"])} \u2014 ${clean(team["name"])}
+` + table(
+    ["NAME", "TYPE"],
+    states.data.map((state) => [str3(state["name"]), str3(state["type"])])
+  );
+  return { json: { ...team, workflow_states: states.data }, human };
+}
 async function teamList(ctx) {
   const body = await ctx.client.get("/api/v1/teams");
   const human = body.data.length === 0 ? "No teams.\n" : table(
@@ -1371,6 +1398,9 @@ function validateBaseUrl(baseUrl) {
   if (parsed.username !== "" || parsed.password !== "") {
     return { ok: false, message: "HARNESS_API_URL must not embed credentials (user:pass@) \u2014 use HARNESS_API_TOKEN" };
   }
+  if (parsed.search !== "" || parsed.hash !== "") {
+    return { ok: false, message: `HARNESS_API_URL must not carry a query or fragment, got: ${baseUrl}` };
+  }
   if (parsed.protocol === "https:" && parsed.hostname !== "") return { ok: true };
   if (parsed.protocol === "http:") {
     if (["localhost", "127.0.0.1", "[::1]"].includes(parsed.hostname)) return { ok: true };
@@ -1444,6 +1474,7 @@ export {
   linkRm,
   labelList,
   labelCreate,
+  teamCreate,
   teamList,
   workflowStates,
   userList,

package/dist/cli.js

@@ -45,6 +45,7 @@ import {
   search,
   show,
   stats,
+  teamCreate,
   teamList,
   update,
   upload,
@@ -53,7 +54,7 @@ import {
   version,
   workflowStates,
   writeCredentials
-} from "./chunk-KN5ILZSA.js";
+} from "./chunk-JOT3TGQQ.js";
 
 // src/cli.ts
 import { Command, CommanderError, InvalidArgumentError } from "commander";
@@ -640,6 +641,9 @@ 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));
 });
+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));
 });
@@ -654,7 +658,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-PI2AZOVY.js");
+  const { startMcpServer } = await import("./server-GYP5FUKD.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) => {

package/dist/{server-PI2AZOVY.js → server-GYP5FUKD.js}

@@ -4,6 +4,7 @@ import {
   Client,
   HttpError,
   TransportError,
+  UsageError,
   archive,
   blocked,
   close,
@@ -31,12 +32,13 @@ import {
   resolveConfig,
   show,
   stats,
+  teamCreate,
   teamList,
   update,
   upload,
   userList,
   workflowStates
-} from "./chunk-KN5ILZSA.js";
+} from "./chunk-JOT3TGQQ.js";
 
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -105,6 +107,9 @@ var TOOLS = [
       scope: z.enum(["all", "archived"]).optional()
     },
     handler: (ctx, args) => {
+      if (args["ready"] === true && args["blocked"] === true) {
+        throw new UsageError("ready and blocked are mutually exclusive \u2014 pass one, not both");
+      }
       if (args["ready"] === true) return ready(ctx, args);
       if (args["blocked"] === true) return blocked(ctx, args);
       return list(ctx, args);
@@ -379,6 +384,16 @@ var TOOLS = [
     shape: {},
     handler: (ctx) => teamList(ctx)
   },
+  {
+    name: "team_create",
+    description: "Create a team. The key becomes the identifier prefix for issues imported under it (upcased, letters/digits, letter first; IO is reserved). The server seeds the default workflow states, so the team is immediately usable.",
+    readOnly: false,
+    shape: {
+      key: z.string().describe("team key, e.g. IOS"),
+      name: z.string().describe("display name")
+    },
+    handler: (ctx, args) => teamCreate(ctx, { key: args["key"], name: args["name"] })
+  },
   {
     name: "workflow_states",
     description: "A team's workflow states (name + type).",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allocator-one/harness-cli",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "CLI and MCP server for Harness, allocator.one's issue tracker",
   "type": "module",
   "license": "MIT",
@@ -24,6 +24,7 @@
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit",
+    "pretest": "npm run build",
     "test": "vitest run",
     "codegen": "openapi-typescript spec/openapi.json -o src/generated/api.ts",
     "spec:refresh": "node scripts/spec-refresh.mjs",

package/spec/openapi.json

@@ -1866,6 +1866,53 @@
         },
         "summary": "List teams",
         "tags": []
+      },
+      "post": {
+        "callbacks": {},
+        "deprecated": false,
+        "description": "Requires the `harness:write` scope. Creates a team seeded with the default workflow states (Backlog, Todo, In Progress, Done, Canceled), so it is immediately usable for the full issue lifecycle. The key is upcased, must match `^[A-Z][A-Z0-9]*$`, and `IO` is reserved for the issues Harness mints.",
+        "parameters": [],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "properties": {
+                  "key": {
+                    "description": "Identifier prefix for issues imported under the team (e.g. ALL). Upcased; create-only.",
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success"
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Missing or invalid token"
+          },
+          "403": {
+            "description": "Token not permitted (org-scoped, non-admin, or missing scope)"
+          },
+          "404": {
+            "description": "Not found"
+          },
+          "422": {
+            "description": "Validation error"
+          }
+        },
+        "summary": "Create a team",
+        "tags": []
       }
     },
     "/api/v1/teams/{team_key}/issues": {