@allocator-one/harness-cli 1.3.0 → 1.4.0

package/README.md

@@ -2,8 +2,8 @@
 
 CLI and MCP server for [Harness](https://harness.infra.one), allocator.one's
 issue tracker. A standalone Node client — no backend checkout, no Erlang
-toolchain — that shares credentials with the Elixir escript (`bin/harness`
-in the `allocator-one` repo).
+toolchain, and no local issue state: issues live server-side, so there is
+nothing to commit or sync.
 
 ## Install
 
@@ -27,8 +27,8 @@ Requires Node >= 20.
 No setup needed: commands target `https://harness.infra.one` and start the
 browser login the first time. One login covers every shell, worktree, and
 agent slot on a machine — credentials are stored at
-`~/.config/harness/credentials.json` (0600), byte-compatible with the
-escript's, so either client can log in or out without breaking the other.
+`~/.config/harness/credentials.json` (0600) as a single `{url, token}` pair,
+and a token is only ever sent to the host that minted it.
 
 - `harness login` — browser flow (PKCE loopback); `--no-browser` prints the
   URL and prompts for a pasted token instead.
@@ -88,8 +88,7 @@ from the working directory, gives every clone of a repo its defaults:
 | `url` | Target host. `HARNESS_API_URL` wins. Tokens stay host-bound: a stored login only serves the host that minted it, an env `HARNESS_API_TOKEN` refuses to pair with a repo-named host (set `HARNESS_API_URL` explicitly), and before the interactive auto-login opens a browser at a host named only by the repo, the CLI asks once per host (remembered in `~/.config/harness/trusted-hosts.json`). |
 | `org` | Reserved for Harness org-scoping; parsed today, `url` wins meanwhile. |
 
-This is config, not state — issues stay server-side. The escript does not
-read this file (TS-CLI-only).
+This is config, not state — issues stay server-side.
 
 ## Development
 

package/dist/{chunk-3WR6YFU6.js → chunk-MF7MQ2L6.js}

@@ -557,13 +557,14 @@ async function list(ctx, opts) {
 }
 async function search(ctx, queryWords, opts) {
   if (queryWords.length === 0) throw new UsageError("usage: harness search <query>");
-  const params = {
-    search: queryWords.join(" "),
-    page_size: opts.limit ?? 50,
-    page: opts.page ?? 1
-  };
-  const { records, notice } = await fetchIssues(ctx, params, opts);
-  return { json: records, human: issuesTable(records), notice };
+  const deprecation = opts.page !== void 0 || opts.all === true ? "--page/--all are ignored: search returns one ranked list, capped at 20" : void 0;
+  let params = { q: queryWords.join(" ") };
+  if (opts.limit !== void 0) params = { ...params, limit: opts.limit };
+  const body = await ctx.client.get("/api/v1/issues/search", params);
+  const meta = body.meta ?? {};
+  const degraded = meta["mode"] === "lexical" ? "semantic search unavailable \u2014 showing lexical matches only" : void 0;
+  const notice = [deprecation, degraded].filter(Boolean).join("; ") || void 0;
+  return { json: body.data, human: issuesTable(body.data), notice };
 }
 async function show(ctx, identifier, opts) {
   requireIdentifiers([identifier]);

package/dist/cli.js

@@ -59,7 +59,7 @@ import {
   version,
   workflowStates,
   writeCredentials
-} from "./chunk-3WR6YFU6.js";
+} from "./chunk-MF7MQ2L6.js";
 
 // src/cli.ts
 import { createInterface as createInterface2 } from "readline";
@@ -935,7 +935,7 @@ program.command("blocked").description("issues waiting on a blocker").option("--
 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("full-text search").argument("[query...]").option("--limit <n>", "page size", integer).option("--page <n>", "page number", integer).option("--all", "follow every page").option("--json", "emit JSON").action(async (query, 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) => {
@@ -1123,7 +1123,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-TK2KFAOQ.js");
+  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) => {

package/dist/{server-TK2KFAOQ.js → server-LJXJLWNK.js}

@@ -30,6 +30,7 @@ import {
   projectUpdate,
   ready,
   resolveConfig,
+  search,
   show,
   stats,
   teamCreate,
@@ -38,7 +39,7 @@ import {
   upload,
   userList,
   workflowStates
-} from "./chunk-3WR6YFU6.js";
+} from "./chunk-MF7MQ2L6.js";
 
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -116,6 +117,19 @@ var TOOLS = [
       return list(ctx, args);
     }
   },
+  {
+    name: "issue_search",
+    description: "Search issues by meaning: ranked results across a lexical and a semantic signal, so describing a problem in your own words finds issues that share none of them. Pass the question as asked \u2014 plain language works better than keywords. An exact identifier always ranks first. Returns at most 20 results, no pagination; use issue_list with search for paginated lexical filtering.",
+    readOnly: true,
+    shape: {
+      query: z.string().describe("the question or phrase to search for"),
+      limit: z.number().int().optional().describe("maximum results (default 10, capped at 20)")
+    },
+    handler: (ctx, args) => {
+      const limit = args["limit"] === void 0 ? {} : { limit: args["limit"] };
+      return search(ctx, [String(args["query"])], limit);
+    }
+  },
   {
     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.",

package/package.json

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

package/spec/openapi.json

@@ -517,6 +517,55 @@
         "tags": []
       }
     },
+    "/api/v1/issues/search": {
+      "get": {
+        "callbacks": {},
+        "deprecated": false,
+        "description": "Requires the `harness:read` scope. Ranked hybrid search: an exact identifier always comes first, then results ordered by relevance across a lexical and a semantic (embedding) signal — a query can match issues that share none of its words. Returns at most 20 results; there is no pagination. `meta.mode` is `hybrid` when the semantic side ran and `lexical` when it degraded (embeddings disabled or the provider unavailable). Unarchived issues only. For paginated, filterable listings use `GET /api/v1/issues` instead.",
+        "parameters": [
+          {
+            "description": "The question or phrase to search for — plain language works better than keywords",
+            "in": "query",
+            "name": "q",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "description": "Maximum results (default 10, capped at 20)",
+            "in": "query",
+            "name": "limit",
+            "required": false,
+            "schema": {
+              "type": "integer"
+            }
+          }
+        ],
+        "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": "Search issues by meaning",
+        "tags": []
+      }
+    },
     "/api/v1/issues/{identifier}": {
       "get": {
         "callbacks": {},
@@ -524,7 +573,7 @@
         "description": "Requires the `harness:read` scope. The payload always carries `blocked` and `blocked_by` (identifiers of open blockers); `include` embeds relations (direction-aware), children, and recent comments in one response.",
         "parameters": [
           {
-            "description": "Issue identifier, e.g. IO-10001 (minted) or ALL-4223 (imported)",
+            "description": "Issue identifier, e.g. ALL-4901 or CLI-12 (issues minted before team-prefixed numbering carry IO-)",
             "in": "path",
             "name": "identifier",
             "required": true,
@@ -571,7 +620,7 @@
         "description": "Requires the `harness:write` scope.",
         "parameters": [
           {
-            "description": "Issue identifier, e.g. IO-10001 (minted) or ALL-4223 (imported)",
+            "description": "Issue identifier, e.g. ALL-4901 or CLI-12 (issues minted before team-prefixed numbering carry IO-)",
             "in": "path",
             "name": "identifier",
             "required": true,
@@ -656,7 +705,7 @@
         "description": "Requires the `harness:write` scope.",
         "parameters": [
           {
-            "description": "Issue identifier, e.g. IO-10001 (minted) or ALL-4223 (imported)",
+            "description": "Issue identifier, e.g. ALL-4901 or CLI-12 (issues minted before team-prefixed numbering carry IO-)",
             "in": "path",
             "name": "identifier",
             "required": true,
@@ -711,7 +760,7 @@
         "description": "Requires the `harness:write` scope. Atomic compare-and-swap: assigns the caller and moves the issue to the team's first started-type state. Idempotent for the current claimant.",
         "parameters": [
           {
-            "description": "Issue identifier, e.g. IO-10001 (minted) or ALL-4223 (imported)",
+            "description": "Issue identifier, e.g. ALL-4901 or CLI-12 (issues minted before team-prefixed numbering carry IO-)",
             "in": "path",
             "name": "identifier",
             "required": true,
@@ -754,7 +803,7 @@
         "description": "Requires the `harness:write` scope. Moves the issue to the team's first completed-type state (canceled-type with `cancel`), posting `reason` as a comment first. The response's `unblocked` lists identifiers of issues that became ready because this one closed.",
         "parameters": [
           {
-            "description": "Issue identifier, e.g. IO-10001 (minted) or ALL-4223 (imported)",
+            "description": "Issue identifier, e.g. ALL-4901 or CLI-12 (issues minted before team-prefixed numbering carry IO-)",
             "in": "path",
             "name": "identifier",
             "required": true,
@@ -818,7 +867,7 @@
         "description": "Requires the `harness:read` scope.",
         "parameters": [
           {
-            "description": "Issue identifier, e.g. IO-10001 (minted) or ALL-4223 (imported)",
+            "description": "Issue identifier, e.g. ALL-4901 or CLI-12 (issues minted before team-prefixed numbering carry IO-)",
             "in": "path",
             "name": "identifier",
             "required": true,
@@ -856,7 +905,7 @@
         "description": "Requires the `harness:write` scope.",
         "parameters": [
           {
-            "description": "Issue identifier, e.g. IO-10001 (minted) or ALL-4223 (imported)",
+            "description": "Issue identifier, e.g. ALL-4901 or CLI-12 (issues minted before team-prefixed numbering carry IO-)",
             "in": "path",
             "name": "identifier",
             "required": true,
@@ -915,7 +964,7 @@
         "description": "Requires the `harness:write` scope.",
         "parameters": [
           {
-            "description": "Issue identifier, e.g. IO-10001 (minted) or ALL-4223 (imported)",
+            "description": "Issue identifier, e.g. ALL-4901 or CLI-12 (issues minted before team-prefixed numbering carry IO-)",
             "in": "path",
             "name": "identifier",
             "required": true,
@@ -973,7 +1022,7 @@
         "description": "Requires the `harness:read` scope.",
         "parameters": [
           {
-            "description": "Issue identifier, e.g. IO-10001 (minted) or ALL-4223 (imported)",
+            "description": "Issue identifier, e.g. ALL-4901 or CLI-12 (issues minted before team-prefixed numbering carry IO-)",
             "in": "path",
             "name": "identifier",
             "required": true,
@@ -1011,7 +1060,7 @@
         "description": "Requires the `harness:write` scope.",
         "parameters": [
           {
-            "description": "Issue identifier, e.g. IO-10001 (minted) or ALL-4223 (imported)",
+            "description": "Issue identifier, e.g. ALL-4901 or CLI-12 (issues minted before team-prefixed numbering carry IO-)",
             "in": "path",
             "name": "identifier",
             "required": true,
@@ -1070,7 +1119,7 @@
         "description": "Requires the `harness:write` scope.",
         "parameters": [
           {
-            "description": "Issue identifier, e.g. IO-10001 (minted) or ALL-4223 (imported)",
+            "description": "Issue identifier, e.g. ALL-4901 or CLI-12 (issues minted before team-prefixed numbering carry IO-)",
             "in": "path",
             "name": "identifier",
             "required": true,
@@ -1119,7 +1168,7 @@
         "description": "Requires the `harness:read` scope.",
         "parameters": [
           {
-            "description": "Issue identifier, e.g. IO-10001 (minted) or ALL-4223 (imported)",
+            "description": "Issue identifier, e.g. ALL-4901 or CLI-12 (issues minted before team-prefixed numbering carry IO-)",
             "in": "path",
             "name": "identifier",
             "required": true,
@@ -1157,7 +1206,7 @@
         "description": "Requires the `harness:write` scope.",
         "parameters": [
           {
-            "description": "Issue identifier, e.g. IO-10001 (minted) or ALL-4223 (imported)",
+            "description": "Issue identifier, e.g. ALL-4901 or CLI-12 (issues minted before team-prefixed numbering carry IO-)",
             "in": "path",
             "name": "identifier",
             "required": true,
@@ -1225,7 +1274,7 @@
         "description": "Requires the `harness:write` scope.",
         "parameters": [
           {
-            "description": "Issue identifier, e.g. IO-10001 (minted) or ALL-4223 (imported)",
+            "description": "Issue identifier, e.g. ALL-4901 or CLI-12 (issues minted before team-prefixed numbering carry IO-)",
             "in": "path",
             "name": "identifier",
             "required": true,
@@ -1274,7 +1323,7 @@
         "description": "Requires the `harness:write` scope.",
         "parameters": [
           {
-            "description": "Issue identifier, e.g. IO-10001 (minted) or ALL-4223 (imported)",
+            "description": "Issue identifier, e.g. ALL-4901 or CLI-12 (issues minted before team-prefixed numbering carry IO-)",
             "in": "path",
             "name": "identifier",
             "required": true,
@@ -1870,7 +1919,7 @@
       "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.",
+        "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 and must match `^[A-Z][A-Z0-9]*$`; numbering starts above any issues that already carry the key as their prefix.",
         "parameters": [],
         "requestBody": {
           "content": {
@@ -1878,7 +1927,7 @@
               "schema": {
                 "properties": {
                   "key": {
-                    "description": "Identifier prefix for issues imported under the team (e.g. ALL). Upcased; create-only.",
+                    "description": "Identifier prefix for the team's issues (e.g. ALL in ALL-4901). Upcased; create-only.",
                     "type": "string"
                   },
                   "name": {
@@ -2143,4 +2192,4 @@
   ],
   "servers": [],
   "tags": []
-}
+}