@allocator-one/harness-cli 1.0.0

package/dist/server-PI2AZOVY.js

@@ -0,0 +1,434 @@
+#!/usr/bin/env node
+import {
+  CLI_VERSION,
+  Client,
+  HttpError,
+  TransportError,
+  archive,
+  blocked,
+  close,
+  comment,
+  comments,
+  create,
+  dep,
+  docCreate,
+  docList,
+  docShow,
+  docUpdate,
+  labelCreate,
+  labelList,
+  linkAdd,
+  linkList,
+  linkRm,
+  list,
+  milestoneCreate,
+  milestoneList,
+  projectCreate,
+  projectList,
+  projectShow,
+  projectUpdate,
+  ready,
+  resolveConfig,
+  show,
+  stats,
+  teamList,
+  update,
+  upload,
+  userList,
+  workflowStates
+} from "./chunk-KN5ILZSA.js";
+
+// src/mcp/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+var NeedsLoginError = class extends Error {
+};
+function context() {
+  const resolved = resolveConfig();
+  if (resolved.kind === "error") throw new NeedsLoginError(resolved.message);
+  if (resolved.kind === "needs-login") {
+    throw new NeedsLoginError(
+      `Not signed in to ${resolved.baseUrl}. Run \`harness login\` in a terminal (or set HARNESS_API_TOKEN for headless use) \u2014 the MCP server never opens a browser itself.`
+    );
+  }
+  return { client: new Client(resolved.config), config: resolved.config };
+}
+function toolError(message) {
+  return { content: [{ type: "text", text: message }], isError: true };
+}
+async function run(work) {
+  try {
+    const output = await work(context());
+    const content = [{ type: "text", text: JSON.stringify(output.json) }];
+    if (output.notice !== void 0 && output.notice !== "") {
+      content.push({ type: "text", text: output.notice.trimEnd() });
+    }
+    if (output.partial === true) {
+      content.push({ type: "text", text: "partial failure \u2014 inspect the JSON entries for per-item errors" });
+      return { content, isError: true };
+    }
+    return { content };
+  } catch (error) {
+    if (error instanceof NeedsLoginError) return toolError(error.message);
+    if (error instanceof HttpError) return toolError(`${error.message} (HTTP ${error.status})`);
+    if (error instanceof TransportError) return toolError(`cannot reach the API: ${error.message}`);
+    if (error instanceof Error) return toolError(error.message);
+    throw error;
+  }
+}
+var page = {
+  limit: z.number().int().positive().optional().describe("page size (server may cap it)"),
+  page: z.number().int().positive().optional().describe("page number, 1-based"),
+  all: z.boolean().optional().describe("follow every page")
+};
+var identifier = z.string().describe("issue identifier, e.g. IO-123");
+var dateField = z.string().optional().describe('YYYY-MM-DD; "" clears the date');
+var TOOLS = [
+  // ── Issues ──
+  {
+    name: "issue_list",
+    description: "List issues with filters. ready=true \u2192 unblocked open issues; blocked=true \u2192 issues waiting on a blocker.",
+    readOnly: true,
+    shape: {
+      ...page,
+      ready: z.boolean().optional(),
+      blocked: z.boolean().optional(),
+      status: z.enum(["open", "in_progress", "closed"]).optional(),
+      assignee: z.string().optional().describe('me, a user id, an email, or a full name; "" for unassigned'),
+      priority: z.enum(["urgent", "high", "medium", "low", "none"]).optional(),
+      label: z.string().optional(),
+      type: z.enum(["task", "bug", "feature", "epic"]).optional(),
+      search: z.string().optional(),
+      team: z.string().optional(),
+      parent: z.string().optional().describe("list children of this epic"),
+      scope: z.enum(["all", "archived"]).optional()
+    },
+    handler: (ctx, args) => {
+      if (args["ready"] === true) return ready(ctx, args);
+      if (args["blocked"] === true) return blocked(ctx, args);
+      return list(ctx, args);
+    }
+  },
+  {
+    name: "issue_show",
+    description: "Full issue detail: fields, relations, children, comments. images=true downloads attached images to the local cache and includes their paths as local_images.",
+    readOnly: true,
+    shape: { id: identifier, images: z.boolean().optional() },
+    handler: (ctx, args) => show(ctx, args["id"], { images: args["images"] === true })
+  },
+  {
+    name: "issue_create",
+    description: "Create an issue. type becomes a type/ label.",
+    readOnly: false,
+    shape: {
+      title: z.string(),
+      team: z.string().optional().describe("team key; defaults to HARNESS_TEAM"),
+      description: z.string().optional(),
+      design: z.string().optional(),
+      notes: z.string().optional(),
+      acceptance_criteria: z.string().optional(),
+      type: z.enum(["task", "bug", "feature", "epic"]).optional(),
+      priority: z.enum(["urgent", "high", "medium", "low", "none"]).optional(),
+      due_date: dateField,
+      parent: z.string().optional(),
+      assignee: z.string().optional(),
+      labels: z.array(z.string()).optional()
+    },
+    handler: (ctx, args) => create(ctx, {
+      ...args,
+      acceptance: args["acceptance_criteria"],
+      dueDate: args["due_date"],
+      label: args["labels"]
+    })
+  },
+  {
+    name: "issue_update",
+    description: "Update issue fields or workflow state. To take an issue, use issue_claim instead of assignee.",
+    readOnly: false,
+    shape: {
+      id: identifier,
+      title: z.string().optional(),
+      description: z.string().optional(),
+      design: z.string().optional(),
+      notes: z.string().optional().describe("replaces the notes"),
+      append_notes: z.string().optional().describe("appends to the notes"),
+      acceptance_criteria: z.string().optional(),
+      priority: z.enum(["urgent", "high", "medium", "low", "none"]).optional(),
+      due_date: dateField,
+      state: z.string().optional().describe("workflow state by name or type"),
+      parent: z.string().optional(),
+      assignee: z.string().optional().describe('"" unassigns')
+    },
+    handler: (ctx, args) => update(ctx, args["id"], {
+      ...args,
+      acceptance: args["acceptance_criteria"],
+      appendNotes: args["append_notes"],
+      dueDate: args["due_date"]
+    })
+  },
+  {
+    name: "issue_claim",
+    description: "Atomically claim an issue: assigns it and moves it to the team's first started state. A conflict means someone else holds it.",
+    readOnly: false,
+    shape: { id: identifier },
+    handler: (ctx, args) => update(ctx, args["id"], { claim: true })
+  },
+  {
+    name: "issue_close",
+    description: "Close issues. The result lists newly unblocked issues \u2014 surface them.",
+    readOnly: false,
+    shape: {
+      ids: z.array(identifier).min(1),
+      reason: z.string().optional().describe("why it is done, e.g. the commit hash"),
+      cancel: z.boolean().optional().describe("close as canceled instead of completed")
+    },
+    handler: (ctx, args) => close(ctx, args["ids"], args)
+  },
+  {
+    name: "issue_comment",
+    description: "Comment on an issue. Mentions resolve server-side and notify the mentioned people.",
+    readOnly: false,
+    shape: {
+      id: identifier,
+      body: z.string(),
+      mentions: z.array(z.string()).optional()
+    },
+    handler: (ctx, args) => comment(ctx, args["id"], [args["body"]], args["mentions"] ?? [])
+  },
+  {
+    name: "issue_archive",
+    description: "Archive issues (or restore them with restore=true). Archived issues show up under scope=archived.",
+    readOnly: false,
+    shape: { ids: z.array(identifier).min(1), restore: z.boolean().optional() },
+    handler: (ctx, args) => archive(ctx, args["ids"], { restore: args["restore"] === true })
+  },
+  {
+    name: "comment_list",
+    description: "An issue's full comment thread, untruncated.",
+    readOnly: true,
+    shape: { id: identifier },
+    handler: (ctx, args) => comments(ctx, args["id"])
+  },
+  // ── Relations (blocking dependencies) ──
+  {
+    name: "relation_add",
+    description: "Add a blocking dependency: blocker blocks issue.",
+    readOnly: false,
+    shape: { issue: identifier, blocker: identifier },
+    handler: (ctx, args) => dep(ctx, "add", args["issue"], args["blocker"])
+  },
+  {
+    name: "relation_rm",
+    description: "Remove a blocking dependency.",
+    readOnly: false,
+    shape: { issue: identifier, blocker: identifier },
+    handler: (ctx, args) => dep(ctx, "rm", args["issue"], args["blocker"])
+  },
+  // ── Links (URLs on an issue) ──
+  {
+    name: "link_list",
+    description: "URLs attached to an issue (distinct from blocking relations).",
+    readOnly: true,
+    shape: { issue: identifier },
+    handler: (ctx, args) => linkList(ctx, args["issue"])
+  },
+  {
+    name: "link_add",
+    description: "Attach a URL to an issue.",
+    readOnly: false,
+    shape: { issue: identifier, url: z.string(), title: z.string().optional() },
+    handler: (ctx, args) => linkAdd(ctx, args["issue"], args["url"], args["title"])
+  },
+  {
+    name: "link_rm",
+    description: "Remove a link from an issue, by link id or exact URL.",
+    readOnly: false,
+    shape: { issue: identifier, id_or_url: z.string() },
+    handler: (ctx, args) => linkRm(ctx, args["issue"], args["id_or_url"])
+  },
+  // ── Projects ──
+  {
+    name: "project_list",
+    description: "List projects.",
+    readOnly: true,
+    shape: { ...page, search: z.string().optional(), state: z.string().optional() },
+    handler: (ctx, args) => projectList(ctx, args)
+  },
+  {
+    name: "project_show",
+    description: "Project detail including milestones.",
+    readOnly: true,
+    shape: { id: z.string() },
+    handler: (ctx, args) => projectShow(ctx, args["id"])
+  },
+  {
+    name: "project_create",
+    description: "Create a project.",
+    readOnly: false,
+    shape: {
+      name: z.string(),
+      description: z.string().optional(),
+      summary: z.string().optional(),
+      state: z.string().optional(),
+      lead_id: z.string().optional(),
+      start_date: dateField,
+      target_date: dateField
+    },
+    handler: (ctx, args) => projectCreate(ctx, {
+      ...args,
+      lead: args["lead_id"],
+      startDate: args["start_date"],
+      targetDate: args["target_date"]
+    })
+  },
+  {
+    name: "project_update",
+    description: "Update a project.",
+    readOnly: false,
+    shape: {
+      id: z.string(),
+      name: z.string().optional(),
+      description: z.string().optional(),
+      summary: z.string().optional(),
+      state: z.string().optional(),
+      lead_id: z.string().optional(),
+      start_date: dateField,
+      target_date: dateField
+    },
+    handler: (ctx, args) => projectUpdate(ctx, args["id"], {
+      ...args,
+      lead: args["lead_id"],
+      startDate: args["start_date"],
+      targetDate: args["target_date"]
+    })
+  },
+  // ── Milestones ──
+  {
+    name: "milestone_list",
+    description: "List a project's milestones.",
+    readOnly: true,
+    shape: { project_id: z.string() },
+    handler: (ctx, args) => milestoneList(ctx, args["project_id"])
+  },
+  {
+    name: "milestone_create",
+    description: "Create a milestone in a project.",
+    readOnly: false,
+    shape: {
+      project_id: z.string(),
+      name: z.string(),
+      description: z.string().optional(),
+      target_date: dateField
+    },
+    handler: (ctx, args) => milestoneCreate(ctx, { project: args["project_id"], name: args["name"], description: args["description"], targetDate: args["target_date"] })
+  },
+  // ── Documents ──
+  {
+    name: "document_list",
+    description: "List documents.",
+    readOnly: true,
+    shape: { ...page, search: z.string().optional() },
+    handler: (ctx, args) => docList(ctx, args)
+  },
+  {
+    name: "document_show",
+    description: "Document detail including full content.",
+    readOnly: true,
+    shape: { id: z.string() },
+    handler: (ctx, args) => docShow(ctx, args["id"])
+  },
+  {
+    name: "document_create",
+    description: "Create a document.",
+    readOnly: false,
+    shape: { title: z.string(), content: z.string().optional(), project_id: z.string().optional() },
+    handler: (ctx, args) => docCreate(ctx, { title: args["title"], content: args["content"], project: args["project_id"] })
+  },
+  {
+    name: "document_update",
+    description: "Update a document.",
+    readOnly: false,
+    shape: {
+      id: z.string(),
+      title: z.string().optional(),
+      content: z.string().optional(),
+      project_id: z.string().optional()
+    },
+    handler: (ctx, args) => docUpdate(ctx, args["id"], { title: args["title"], content: args["content"], project: args["project_id"] })
+  },
+  // ── Labels, teams, states, users, stats ──
+  {
+    name: "label_list",
+    description: "List labels.",
+    readOnly: true,
+    shape: {},
+    handler: (ctx) => labelList(ctx)
+  },
+  {
+    name: "label_create",
+    description: "Create a label.",
+    readOnly: false,
+    shape: { name: z.string(), color: z.string().optional() },
+    handler: (ctx, args) => labelCreate(ctx, args["name"], args["color"])
+  },
+  {
+    name: "team_list",
+    description: "List teams.",
+    readOnly: true,
+    shape: {},
+    handler: (ctx) => teamList(ctx)
+  },
+  {
+    name: "workflow_states",
+    description: "A team's workflow states (name + type).",
+    readOnly: true,
+    shape: { team: z.string().optional().describe("team key; defaults to HARNESS_TEAM") },
+    handler: (ctx, args) => workflowStates(ctx, args["team"])
+  },
+  {
+    name: "user_list",
+    description: "List users (for assignee resolution).",
+    readOnly: true,
+    shape: {},
+    handler: (ctx) => userList(ctx)
+  },
+  {
+    name: "stats",
+    description: "Per-team and total issue counts.",
+    readOnly: true,
+    shape: {},
+    handler: (ctx) => stats(ctx)
+  },
+  // ── Uploads ──
+  {
+    name: "upload",
+    description: "Upload an image file (png/jpg/webp/gif, \u2264 25 MB) from a local path; returns markdown to reference it in issue fields or comments.",
+    readOnly: false,
+    shape: { path: z.string().describe("local file path") },
+    handler: (ctx, args) => upload(ctx, args["path"])
+  }
+];
+function buildServer() {
+  const server = new McpServer({ name: "harness", version: CLI_VERSION });
+  for (const tool of TOOLS) {
+    server.registerTool(
+      tool.name,
+      {
+        description: tool.description,
+        inputSchema: tool.shape,
+        annotations: { readOnlyHint: tool.readOnly }
+      },
+      ((args) => run((ctx) => tool.handler(ctx, args)))
+    );
+  }
+  return server;
+}
+async function startMcpServer() {
+  const server = buildServer();
+  await server.connect(new StdioServerTransport());
+}
+export {
+  buildServer,
+  startMcpServer
+};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@allocator-one/harness-cli",
+  "version": "1.0.0",
+  "description": "CLI and MCP server for Harness, allocator.one's issue tracker",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/allocator-one/harness-cli.git"
+  },
+  "bin": {
+    "harness": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "spec/openapi.json"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "codegen": "openapi-typescript spec/openapi.json -o src/generated/api.ts",
+    "spec:refresh": "node scripts/spec-refresh.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "commander": "^14.0.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "openapi-typescript": "^7.8.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  }
+}