@gethmy/mcp 2.26.0 → 3.1.0

package/README.md

@@ -5,7 +5,7 @@ Claude Code, OpenAI Codex, Cursor, and any MCP client claim cards, report progre
 
 ## Features
 
-- **78 MCP Tools** for full board control, knowledge graph, and workflow plans
+- **77 MCP Tools** for full board control, knowledge graph, and workflow plans
 - **Global Skills** — installable in one command, served from the DB-backed [skill hub](../../docs/skills.md) with auto-update and admin-managed versioning
 - **Knowledge Graph Memory** — Phase 1 surface: hybrid retrieval (vector + lexical + RRF), session-scoped working memory, activity feed. See [docs/memory.md](../../docs/memory.md)
 - **GSD Workflow Plans** - plan/execute/verify/done lifecycle with auto card creation
@@ -89,7 +89,7 @@ If you prefer to configure manually (e.g., in Claude.ai's UI):
 1. Get an API key from [Harmony](https://gethmy.com/user/keys)
 2. In Claude.ai, add a remote MCP server with URL `https://mcp.gethmy.com/mcp`
 3. Set the Authorization header to `Bearer hmy_your_key_here`
-4. All 78 Harmony tools become available in your conversation
+4. All 77 Harmony tools become available in your conversation
 
 **Session management** is automatic - sessions have a 1-hour TTL and are created/renewed transparently.
 

package/dist/cli.js

@@ -1598,6 +1598,8 @@ function referencedGateMetrics(def) {
   }
   return out;
 }
+// ../harmony-shared/dist/realtimeChannel.js
+var inFlightDetach = new WeakMap;
 // ../harmony-shared/dist/reviewTools.js
 var REVIEW_DISALLOWED_TOOLS = [
   ...STAGE_DAEMON_OWNED_TOOLS,
@@ -2053,9 +2055,6 @@ class HarmonyApiClient {
       expires_at: expiresAt
     });
   }
-  async classifyCard(cardId) {
-    return this.request("POST", `/cards/${cardId}/classify`);
-  }
   async createColumn(projectId, name) {
     return this.request("POST", "/columns", { projectId, name });
   }
@@ -3780,7 +3779,8 @@ function warnDeprecatedTool(oldName) {
 }
 var DEPRECATED_REMOVED_TOOLS = {
   harmony_run_playbook: "Playbooks are stage models run by the board and agent daemon as a card moves through their stages — there is no server-side macro to trigger. This tool no longer runs anything.",
-  harmony_save_card_as_playbook: "The steps_version=1 automation macro was removed. Build a stage playbook with harmony_create_playbook instead."
+  harmony_save_card_as_playbook: "The steps_version=1 automation macro was removed. Build a stage playbook with harmony_create_playbook instead.",
+  harmony_classify_card: "Card classification was retired. Run sizing happens at daemon pickup and is run-scoped, and the cards.intent / complexity_score / model_tier / classified_at columns it wrote have been dropped. The feature/bug/idea label — the only output anything read — is applied at card creation, so there is nothing left to trigger."
 };
 var _warnedRemovedTools = new Set;
 function deprecatedRemovedToolResult(name) {
@@ -4488,16 +4488,6 @@ var TOOLS = {
       required: ["target", "storagePath"]
     }
   },
-  harmony_classify_card: {
-    description: "DEPRECATED — run sizing now happens at daemon pickup and is run-scoped, so nothing reads `model_tier`, `intent` or `complexity_score` any more; this tool still writes them, but only the type label has an effect. Prefer letting card creation apply the type label. Sets `intent` (plan/think/implement/review), `complexity_score` (0-10), `model_tier` (simple/advanced/research), stamps `classified_at`, and applies the type label (feature/bug/idea). Idempotent; never touches the user-owned `model_override`.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        cardId: { type: "string", description: "Card UUID" }
-      },
-      required: ["cardId"]
-    }
-  },
   harmony_share_artifact: {
     description: "Create a public, unauthenticated share link for a hosted artifact. Anyone with the link can view the rendered HTML without a Harmony account. Returns the share token and the full public URL. Only needed for a recipient OUTSIDE the workspace — for a teammate, hand over the `app_url` the upload already returned instead of exposing the document publicly.",
     inputSchema: {
@@ -5563,7 +5553,7 @@ var TOOLS = {
         },
         autoBind: {
           type: "object",
-          description: "Auto-bind rule: {priority?: number, mode?: 'all'|'any', when: [{path, op, value}]}. Conditions are evaluated against the card's labels (lowercased), intent, complexity_score and priority with the gate operators eq/neq/gte/gt/lte/lt/contains/exists; 'contains' on labels is membership. Stored even while triggerType is 'manual', so a rule can be armed later without re-authoring it."
+          description: "Auto-bind rule: {priority?: number, mode?: 'all'|'any', when: [{path, op, value}]}. Conditions are evaluated against the card's labels (lowercased) and priority with the gate operators eq/neq/gte/gt/lte/lt/contains/exists; 'contains' on labels is membership. `intent` and `complexity_score` are NOT addressable — run sizing is run-scoped and those card columns were dropped, so a rule naming either fails closed and never binds. Stored even while triggerType is 'manual', so a rule can be armed later without re-authoring it."
         },
         catalogId: {
           type: "string",
@@ -6369,11 +6359,8 @@ ${list}
       const result = await client3.addExternalLink(cardId, url, title);
       return { success: true, ...result };
     }
-    case "harmony_classify_card": {
-      const cardId = z.string().uuid().parse(args.cardId);
-      const result = await client3.classifyCard(cardId);
-      return result;
-    }
+    case "harmony_classify_card":
+      return deprecatedRemovedToolResult("harmony_classify_card");
     case "harmony_create_subtask": {
       const cardId = z.string().uuid().parse(args.cardId);
       const title = z.string().min(1).max(500).parse(args.title);

package/dist/index.js

@@ -1593,6 +1593,8 @@ function referencedGateMetrics(def) {
   }
   return out;
 }
+// ../harmony-shared/dist/realtimeChannel.js
+var inFlightDetach = new WeakMap;
 // ../harmony-shared/dist/reviewTools.js
 var REVIEW_DISALLOWED_TOOLS = [
   ...STAGE_DAEMON_OWNED_TOOLS,
@@ -2048,9 +2050,6 @@ class HarmonyApiClient {
       expires_at: expiresAt
     });
   }
-  async classifyCard(cardId) {
-    return this.request("POST", `/cards/${cardId}/classify`);
-  }
   async createColumn(projectId, name) {
     return this.request("POST", "/columns", { projectId, name });
   }
@@ -3775,7 +3774,8 @@ function warnDeprecatedTool(oldName) {
 }
 var DEPRECATED_REMOVED_TOOLS = {
   harmony_run_playbook: "Playbooks are stage models run by the board and agent daemon as a card moves through their stages — there is no server-side macro to trigger. This tool no longer runs anything.",
-  harmony_save_card_as_playbook: "The steps_version=1 automation macro was removed. Build a stage playbook with harmony_create_playbook instead."
+  harmony_save_card_as_playbook: "The steps_version=1 automation macro was removed. Build a stage playbook with harmony_create_playbook instead.",
+  harmony_classify_card: "Card classification was retired. Run sizing happens at daemon pickup and is run-scoped, and the cards.intent / complexity_score / model_tier / classified_at columns it wrote have been dropped. The feature/bug/idea label — the only output anything read — is applied at card creation, so there is nothing left to trigger."
 };
 var _warnedRemovedTools = new Set;
 function deprecatedRemovedToolResult(name) {
@@ -4483,16 +4483,6 @@ var TOOLS = {
       required: ["target", "storagePath"]
     }
   },
-  harmony_classify_card: {
-    description: "DEPRECATED — run sizing now happens at daemon pickup and is run-scoped, so nothing reads `model_tier`, `intent` or `complexity_score` any more; this tool still writes them, but only the type label has an effect. Prefer letting card creation apply the type label. Sets `intent` (plan/think/implement/review), `complexity_score` (0-10), `model_tier` (simple/advanced/research), stamps `classified_at`, and applies the type label (feature/bug/idea). Idempotent; never touches the user-owned `model_override`.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        cardId: { type: "string", description: "Card UUID" }
-      },
-      required: ["cardId"]
-    }
-  },
   harmony_share_artifact: {
     description: "Create a public, unauthenticated share link for a hosted artifact. Anyone with the link can view the rendered HTML without a Harmony account. Returns the share token and the full public URL. Only needed for a recipient OUTSIDE the workspace — for a teammate, hand over the `app_url` the upload already returned instead of exposing the document publicly.",
     inputSchema: {
@@ -5558,7 +5548,7 @@ var TOOLS = {
         },
         autoBind: {
           type: "object",
-          description: "Auto-bind rule: {priority?: number, mode?: 'all'|'any', when: [{path, op, value}]}. Conditions are evaluated against the card's labels (lowercased), intent, complexity_score and priority with the gate operators eq/neq/gte/gt/lte/lt/contains/exists; 'contains' on labels is membership. Stored even while triggerType is 'manual', so a rule can be armed later without re-authoring it."
+          description: "Auto-bind rule: {priority?: number, mode?: 'all'|'any', when: [{path, op, value}]}. Conditions are evaluated against the card's labels (lowercased) and priority with the gate operators eq/neq/gte/gt/lte/lt/contains/exists; 'contains' on labels is membership. `intent` and `complexity_score` are NOT addressable — run sizing is run-scoped and those card columns were dropped, so a rule naming either fails closed and never binds. Stored even while triggerType is 'manual', so a rule can be armed later without re-authoring it."
         },
         catalogId: {
           type: "string",
@@ -6364,11 +6354,8 @@ ${list}
       const result = await client3.addExternalLink(cardId, url, title);
       return { success: true, ...result };
     }
-    case "harmony_classify_card": {
-      const cardId = z.string().uuid().parse(args.cardId);
-      const result = await client3.classifyCard(cardId);
-      return result;
-    }
+    case "harmony_classify_card":
+      return deprecatedRemovedToolResult("harmony_classify_card");
     case "harmony_create_subtask": {
       const cardId = z.string().uuid().parse(args.cardId);
       const title = z.string().min(1).max(500).parse(args.title);

package/dist/lib/api-client.js

@@ -963,6 +963,8 @@ var STAGE_DAEMON_OWNED_TOOLS = [
   "mcp__harmony__harmony_start_agent_session",
   "mcp__harmony__harmony_move_card"
 ];
+// ../harmony-shared/dist/realtimeChannel.js
+var inFlightDetach = new WeakMap;
 // ../harmony-shared/dist/reviewTools.js
 var REVIEW_DISALLOWED_TOOLS = [
   ...STAGE_DAEMON_OWNED_TOOLS,
@@ -1418,9 +1420,6 @@ class HarmonyApiClient {
       expires_at: expiresAt
     });
   }
-  async classifyCard(cardId) {
-    return this.request("POST", `/cards/${cardId}/classify`);
-  }
   async createColumn(projectId, name) {
     return this.request("POST", "/columns", { projectId, name });
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gethmy/mcp",
-  "version": "2.26.0",
+  "version": "3.1.0",
   "description": "MCP server for Harmony, the shared surface for human–agent teams — agents claim cards, report progress, and move work on your board.",
   "publishConfig": {
     "access": "public"
@@ -80,7 +80,7 @@
   },
   "devDependencies": {
     "@harmony/memory": "workspace:*",
-    "@types/bun": "^1.3.13",
+    "@types/bun": "^1.4.0",
     "@types/node": "^25.5.0",
     "typescript": "^6.0.1"
   }

package/src/api-client.ts

@@ -227,18 +227,6 @@ export type ResolveCardApiResult =
       candidates: ResolveCardCandidate[];
     };
 
-/** Result of the classify-card classifier (card #415). Any field may be null
- * if the LLM didn't return a usable value. `model_override` is never touched. */
-export interface CardClassificationResult {
-  type: "feature" | "bug" | "idea" | null;
-  intent: "plan" | "think" | "implement" | "review" | null;
-  complexity_score: number | null;
-  model_tier: "simple" | "advanced" | "research" | null;
-  classified_at: string;
-  applied_type_label_id: string | null;
-  reasoning: string | null;
-}
-
 export class HarmonyApiClient {
   private apiKey: string;
   private apiUrl: string;
@@ -986,12 +974,6 @@ export class HarmonyApiClient {
     });
   }
 
-  async classifyCard(
-    cardId: string,
-  ): Promise<{ classification: CardClassificationResult }> {
-    return this.request("POST", `/cards/${cardId}/classify`);
-  }
-
   // ============ COLUMN OPERATIONS ============
 
   async createColumn(
@@ -1133,6 +1115,19 @@ export class HarmonyApiClient {
        * NULL until the terminal cost frame reported the observed model.
        */
       modelName?: string;
+      /**
+       * Which side of the daemon's pipeline opened this session (card #950):
+       * `implement` (`worker.ts`) or `review` (`review-worker.ts`). Persisted to
+       * `card_agent_context.session_kind`, which is what lets the board name the
+       * model the card's WORK ran on rather than the newest model reported —
+       * review always runs last, so without this the review model (often the
+       * bare alias `sonnet`) passed as the card's model.
+       *
+       * Omit it from an `/hmy` or other MCP session: NULL means "unattributed"
+       * and reads as "not a review" everywhere, which is the right default for a
+       * session that is doing the card's actual work.
+       */
+      sessionKind?: "implement" | "review";
       /**
        * Who is calling (Task 5, "the drivers"): `daemon` (the local agent
        * daemon), `interactive` (a human-driven `/hmy` session), or `script`
@@ -1306,6 +1301,12 @@ export class HarmonyApiClient {
        * deferred the respawn by 10 minutes (#770). Reply carries `stopped: true`.
        */
       implicitCreate?: boolean;
+      /**
+       * Which driver holds this session. `"notice"` marks a row that is not a
+       * run at all but a pool-level hold reason (#947) — instantly yieldable,
+       * so a real run displaces it instead of meeting a 409.
+       */
+      driver?: "daemon" | "interactive" | "script" | "notice";
       /**
        * Set while the session waits for a human budget decision (#915),
        * cleared (null) once one arrives. Exempts the row from the daemon's

package/src/server.ts

@@ -167,6 +167,8 @@ const DEPRECATED_REMOVED_TOOLS: Record<string, string> = {
     "Playbooks are stage models run by the board and agent daemon as a card moves through their stages — there is no server-side macro to trigger. This tool no longer runs anything.",
   harmony_save_card_as_playbook:
     "The steps_version=1 automation macro was removed. Build a stage playbook with harmony_create_playbook instead.",
+  harmony_classify_card:
+    "Card classification was retired. Run sizing happens at daemon pickup and is run-scoped, and the cards.intent / complexity_score / model_tier / classified_at columns it wrote have been dropped. The feature/bug/idea label — the only output anything read — is applied at card creation, so there is nothing left to trigger.",
 };
 const _warnedRemovedTools = new Set<string>();
 function deprecatedRemovedToolResult(name: string): {
@@ -1205,17 +1207,6 @@ export const TOOLS = {
       required: ["target", "storagePath"],
     },
   },
-  harmony_classify_card: {
-    description:
-      "DEPRECATED — run sizing now happens at daemon pickup and is run-scoped, so nothing reads `model_tier`, `intent` or `complexity_score` any more; this tool still writes them, but only the type label has an effect. Prefer letting card creation apply the type label. Sets `intent` (plan/think/implement/review), `complexity_score` (0-10), `model_tier` (simple/advanced/research), stamps `classified_at`, and applies the type label (feature/bug/idea). Idempotent; never touches the user-owned `model_override`.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        cardId: { type: "string", description: "Card UUID" },
-      },
-      required: ["cardId"],
-    },
-  },
   harmony_share_artifact: {
     description:
       "Create a public, unauthenticated share link for a hosted artifact. Anyone with the link can view the rendered HTML without a Harmony account. Returns the share token and the full public URL. Only needed for a recipient OUTSIDE the workspace — for a teammate, hand over the `app_url` the upload already returned instead of exposing the document publicly.",
@@ -2390,7 +2381,7 @@ export const TOOLS = {
         autoBind: {
           type: "object",
           description:
-            "Auto-bind rule: {priority?: number, mode?: 'all'|'any', when: [{path, op, value}]}. Conditions are evaluated against the card's labels (lowercased), intent, complexity_score and priority with the gate operators eq/neq/gte/gt/lte/lt/contains/exists; 'contains' on labels is membership. Stored even while triggerType is 'manual', so a rule can be armed later without re-authoring it.",
+            "Auto-bind rule: {priority?: number, mode?: 'all'|'any', when: [{path, op, value}]}. Conditions are evaluated against the card's labels (lowercased) and priority with the gate operators eq/neq/gte/gt/lte/lt/contains/exists; 'contains' on labels is membership. `intent` and `complexity_score` are NOT addressable — run sizing is run-scoped and those card columns were dropped, so a rule naming either fails closed and never binds. Stored even while triggerType is 'manual', so a rule can be armed later without re-authoring it.",
         },
         catalogId: {
           type: "string",
@@ -3628,11 +3619,11 @@ async function handleToolCall(
       return { success: true, ...result };
     }
 
-    case "harmony_classify_card": {
-      const cardId = z.string().uuid().parse(args.cardId);
-      const result = await client.classifyCard(cardId);
-      return result;
-    }
+    // Removed — dropped from the advertised TOOLS list; the case remains so an
+    // older `hmy-new` install that still calls it gets a legible notice rather
+    // than an unknown-tool error.
+    case "harmony_classify_card":
+      return deprecatedRemovedToolResult("harmony_classify_card");
 
     // Subtask operations
     case "harmony_create_subtask": {