@gethmy/mcp 2.9.7 → 2.9.9

package/README.md

@@ -5,8 +5,8 @@ Enables AI coding agents (Claude Code, OpenAI Codex, Cursor) to interact with yo
 
 ## Features
 
-- **69 MCP Tools** for full board control, knowledge graph, and workflow plans
-- **5 Global Skills** — `/hmy`, `/hmy-plan`, `/hmy-cleanup`, `/hmy-standup`, `/hmy-memory-prune`, served from the DB-backed [skill hub](../../docs/skills.md) with auto-update and admin-managed versioning
+- **70 MCP Tools** for full board control, knowledge graph, and workflow plans
+- **7 Global Skills** — `/hmy`, `/hmy-plan`, `/hmy-cleanup`, `/hmy-standup`, `/hmy-memory-prune`, `/hmy-upgrade`, `/hmy-review`, 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
 - **Card Linking** - create relationships between cards (blocks, relates_to, duplicates, is_part_of)
@@ -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 56 Harmony tools become available in your conversation
+4. All 70 Harmony tools become available in your conversation
 
 **Session management** is automatic - sessions have a 1-hour TTL and are created/renewed transparently.
 
@@ -150,7 +150,7 @@ npx @gethmy/mcp serve              # Start MCP server
 
 ## Skills
 
-Five global skills ship with the MCP server and are installed automatically by `npx @gethmy/mcp setup`. They live in the `skill_resource` Postgres table, are fetched via `GET /v1/skills/<name>`, and render-time composed with a shared auto-update preamble.
+Seven global skills ship with the MCP server and are installed automatically by `npx @gethmy/mcp setup`. They live in the `skill_resource` Postgres table, are fetched via `GET /v1/skills/<name>`, and render-time composed with a shared auto-update preamble.
 
 For the full skill hub architecture (storage, versioning, auto-update, admin management), see [docs/skills.md](../../docs/skills.md).
 

package/dist/cli.js

@@ -1385,7 +1385,6 @@ import {
   ReadResourceRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
 import { z } from "zod";
-
 // ../harmony-shared/dist/cardLinks.js
 var LINK_TYPE_INVERSES = {
   relates_to: "relates_to",
@@ -1859,6 +1858,9 @@ class HarmonyApiClient {
   async getCardExternalLinks(cardId) {
     return this.request("GET", `/cards/${cardId}/external-links`);
   }
+  async classifyCard(cardId) {
+    return this.request("POST", `/cards/${cardId}/classify`);
+  }
   async createColumn(projectId, name) {
     return this.request("POST", "/columns", { projectId, name });
   }
@@ -1920,9 +1922,15 @@ class HarmonyApiClient {
   async flushActivityLog(cardId, data) {
     return this.request("POST", `/cards/${cardId}/agent-activity-log`, data);
   }
+  async appendAgentRunEvents(cardId, data) {
+    return this.request("POST", `/cards/${cardId}/agent-run-events`, data);
+  }
   async getActivityLog(cardId, sessionId) {
     return this.request("GET", `/cards/${cardId}/agent-activity-log?sessionId=${sessionId}`);
   }
+  async getPendingUserMessages(cardId, sessionId, sinceSeq) {
+    return this.request("GET", `/cards/${cardId}/agent-messages?sessionId=${sessionId}&sinceSeq=${sinceSeq}`);
+  }
   async getAgentSession(cardId, options) {
     const params = new URLSearchParams;
     if (options?.includeEnded)
@@ -3882,6 +3890,16 @@ var TOOLS = {
       required: ["cardId"]
     }
   },
+  harmony_classify_card: {
+    description: "Classify a card with the LLM classifier: sets `intent` (plan/think/implement/review), `complexity_score` (0-10), and `model_tier` (simple/advanced/research), stamps `classified_at`, and applies the canonical type label (feature/bug/idea). Use this right after creating a card (e.g. in the `hmy-new` flow) so it's classified in-flow instead of waiting for it to surface on the web board. Idempotent — safe to re-run. Never touches the user-owned `model_override`.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card UUID" }
+      },
+      required: ["cardId"]
+    }
+  },
   harmony_get_card_external_links: {
     description: "Get external URL references attached to a card (links to docs, gists, dashboards, etc.).",
     inputSchema: {
@@ -5349,6 +5367,11 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.getCardExternalLinks(cardId);
       return result;
     }
+    case "harmony_classify_card": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const result = await client3.classifyCard(cardId);
+      return result;
+    }
     case "harmony_create_subtask": {
       const cardId = z.string().uuid().parse(args.cardId);
       const title = z.string().min(1).max(500).parse(args.title);
@@ -7821,12 +7844,13 @@ only for unattended CI where you accept that risk.`));
         options: [
           {
             value: "browser",
-            label: "Sign in with your browser",
-            hint: "recommended — secure, no key handling"
+            label: "Sign in or create an account in your browser",
+            hint: "recommended — new or existing users, no key handling"
           },
           {
             value: "create",
-            label: "Create a free account"
+            label: "Create an account here in the terminal",
+            hint: "no browser"
           },
           {
             value: "apikey",
@@ -8378,6 +8402,11 @@ Specify the workspace with --workspace <id>, or select one below.`);
       console.log(`    ${colors.brand("Cursor:")} MCP tools available automatically`);
     }
     console.log("");
+    console.log(`  ${colors.bold("Next steps:")}`);
+    console.log(`    1. Open Claude Code and say: ${colors.highlight('"Show me my board"')}`);
+    console.log(`    2. Create a card: ${colors.highlight('"Create a card called Auth token refresh"')}`);
+    console.log(`    3. Start the daemon: ${colors.highlight("npx @gethmy/agent")}`);
+    console.log("");
     console.log(`  ${colors.dim("Add to new project: npx @gethmy/mcp setup")}`);
     console.log(`  ${colors.dim("Need help? Visit https://app.gethmy.com/docs/mcp")}`);
   }

package/dist/index.js

@@ -1380,7 +1380,6 @@ import {
   ReadResourceRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
 import { z } from "zod";
-
 // ../harmony-shared/dist/cardLinks.js
 var LINK_TYPE_INVERSES = {
   relates_to: "relates_to",
@@ -1854,6 +1853,9 @@ class HarmonyApiClient {
   async getCardExternalLinks(cardId) {
     return this.request("GET", `/cards/${cardId}/external-links`);
   }
+  async classifyCard(cardId) {
+    return this.request("POST", `/cards/${cardId}/classify`);
+  }
   async createColumn(projectId, name) {
     return this.request("POST", "/columns", { projectId, name });
   }
@@ -1915,9 +1917,15 @@ class HarmonyApiClient {
   async flushActivityLog(cardId, data) {
     return this.request("POST", `/cards/${cardId}/agent-activity-log`, data);
   }
+  async appendAgentRunEvents(cardId, data) {
+    return this.request("POST", `/cards/${cardId}/agent-run-events`, data);
+  }
   async getActivityLog(cardId, sessionId) {
     return this.request("GET", `/cards/${cardId}/agent-activity-log?sessionId=${sessionId}`);
   }
+  async getPendingUserMessages(cardId, sessionId, sinceSeq) {
+    return this.request("GET", `/cards/${cardId}/agent-messages?sessionId=${sessionId}&sinceSeq=${sinceSeq}`);
+  }
   async getAgentSession(cardId, options) {
     const params = new URLSearchParams;
     if (options?.includeEnded)
@@ -3877,6 +3885,16 @@ var TOOLS = {
       required: ["cardId"]
     }
   },
+  harmony_classify_card: {
+    description: "Classify a card with the LLM classifier: sets `intent` (plan/think/implement/review), `complexity_score` (0-10), and `model_tier` (simple/advanced/research), stamps `classified_at`, and applies the canonical type label (feature/bug/idea). Use this right after creating a card (e.g. in the `hmy-new` flow) so it's classified in-flow instead of waiting for it to surface on the web board. Idempotent — safe to re-run. Never touches the user-owned `model_override`.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card UUID" }
+      },
+      required: ["cardId"]
+    }
+  },
   harmony_get_card_external_links: {
     description: "Get external URL references attached to a card (links to docs, gists, dashboards, etc.).",
     inputSchema: {
@@ -5344,6 +5362,11 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.getCardExternalLinks(cardId);
       return result;
     }
+    case "harmony_classify_card": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const result = await client3.classifyCard(cardId);
+      return result;
+    }
     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

@@ -833,7 +833,6 @@ var init_oauth_refresh = __esm(() => {
   init_config();
   init_oauth_login();
 });
-
 // ../harmony-shared/dist/cardLinks.js
 var LINK_TYPE_INVERSES = {
   relates_to: "relates_to",
@@ -1307,6 +1306,9 @@ class HarmonyApiClient {
   async getCardExternalLinks(cardId) {
     return this.request("GET", `/cards/${cardId}/external-links`);
   }
+  async classifyCard(cardId) {
+    return this.request("POST", `/cards/${cardId}/classify`);
+  }
   async createColumn(projectId, name) {
     return this.request("POST", "/columns", { projectId, name });
   }
@@ -1368,9 +1370,15 @@ class HarmonyApiClient {
   async flushActivityLog(cardId, data) {
     return this.request("POST", `/cards/${cardId}/agent-activity-log`, data);
   }
+  async appendAgentRunEvents(cardId, data) {
+    return this.request("POST", `/cards/${cardId}/agent-run-events`, data);
+  }
   async getActivityLog(cardId, sessionId) {
     return this.request("GET", `/cards/${cardId}/agent-activity-log?sessionId=${sessionId}`);
   }
+  async getPendingUserMessages(cardId, sessionId, sinceSeq) {
+    return this.request("GET", `/cards/${cardId}/agent-messages?sessionId=${sessionId}&sinceSeq=${sinceSeq}`);
+  }
   async getAgentSession(cardId, options) {
     const params = new URLSearchParams;
     if (options?.includeEnded)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gethmy/mcp",
-  "version": "2.9.7",
+  "version": "2.9.9",
   "description": "MCP server for Harmony Kanban board - enables AI coding agents to manage your boards",
   "publishConfig": {
     "access": "public"

package/src/api-client.ts

@@ -1,4 +1,5 @@
 import {
+  type AgentRunEventDraft,
   type Comment,
   getDisplayLinkType,
   serializeCommentThread,
@@ -151,6 +152,18 @@ export interface CardExternalLinkRow {
   created_at: string;
 }
 
+/** 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;
@@ -668,6 +681,12 @@ export class HarmonyApiClient {
     return this.request("GET", `/cards/${cardId}/external-links`);
   }
 
+  async classifyCard(
+    cardId: string,
+  ): Promise<{ classification: CardClassificationResult }> {
+    return this.request("POST", `/cards/${cardId}/classify`);
+  }
+
   // ============ COLUMN OPERATIONS ============
 
   async createColumn(
@@ -880,6 +899,20 @@ export class HarmonyApiClient {
     return this.request("POST", `/cards/${cardId}/agent-activity-log`, data);
   }
 
+  /**
+   * Append events to a run's agent_run_events stream (card #417). Send drafts in
+   * chronological order — the server's seq trigger assigns the monotonic per-run order.
+   */
+  async appendAgentRunEvents(
+    cardId: string,
+    data: {
+      sessionId: string;
+      events: (AgentRunEventDraft & { createdAt?: string })[];
+    },
+  ): Promise<{ inserted: number }> {
+    return this.request("POST", `/cards/${cardId}/agent-run-events`, data);
+  }
+
   async getActivityLog(
     cardId: string,
     sessionId: string,
@@ -900,6 +933,31 @@ export class HarmonyApiClient {
     );
   }
 
+  /**
+   * Drain queued chat-steering messages for a run (card #417). Returns `user_message`
+   * events with `seq` greater than `sinceSeq`, oldest first, so the daemon can continue
+   * the run via `claude --resume` at a turn boundary.
+   */
+  async getPendingUserMessages(
+    cardId: string,
+    sessionId: string,
+    sinceSeq: number,
+  ): Promise<{
+    messages: {
+      id: string;
+      seq: number;
+      text: string;
+      authorName?: string;
+      authorUserId?: string;
+      createdAt: string;
+    }[];
+  }> {
+    return this.request(
+      "GET",
+      `/cards/${cardId}/agent-messages?sessionId=${sessionId}&sinceSeq=${sinceSeq}`,
+    );
+  }
+
   async getAgentSession(
     cardId: string,
     options?: { includeEnded?: boolean },

package/src/server.ts

@@ -686,6 +686,17 @@ export const TOOLS = {
       required: ["cardId"],
     },
   },
+  harmony_classify_card: {
+    description:
+      "Classify a card with the LLM classifier: sets `intent` (plan/think/implement/review), `complexity_score` (0-10), and `model_tier` (simple/advanced/research), stamps `classified_at`, and applies the canonical type label (feature/bug/idea). Use this right after creating a card (e.g. in the `hmy-new` flow) so it's classified in-flow instead of waiting for it to surface on the web board. Idempotent — safe to re-run. Never touches the user-owned `model_override`.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card UUID" },
+      },
+      required: ["cardId"],
+    },
+  },
   harmony_get_card_external_links: {
     description:
       "Get external URL references attached to a card (links to docs, gists, dashboards, etc.).",
@@ -2484,6 +2495,12 @@ async function handleToolCall(
       return result;
     }
 
+    case "harmony_classify_card": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const result = await client.classifyCard(cardId);
+      return result;
+    }
+
     // Subtask operations
     case "harmony_create_subtask": {
       const cardId = z.string().uuid().parse(args.cardId);

package/src/tui/setup.ts

@@ -783,12 +783,13 @@ export async function runSetup(options: SetupOptions = {}): Promise<void> {
         options: [
           {
             value: "browser",
-            label: "Sign in with your browser",
-            hint: "recommended — secure, no key handling",
+            label: "Sign in or create an account in your browser",
+            hint: "recommended — new or existing users, no key handling",
           },
           {
             value: "create",
-            label: "Create a free account",
+            label: "Create an account here in the terminal",
+            hint: "no browser",
           },
           {
             value: "apikey",
@@ -1599,6 +1600,18 @@ export async function runSetup(options: SetupOptions = {}): Promise<void> {
       );
     }
 
+    console.log("");
+    console.log(`  ${colors.bold("Next steps:")}`);
+    console.log(
+      `    1. Open Claude Code and say: ${colors.highlight('"Show me my board"')}`,
+    );
+    console.log(
+      `    2. Create a card: ${colors.highlight('"Create a card called Auth token refresh"')}`,
+    );
+    console.log(
+      `    3. Start the daemon: ${colors.highlight("npx @gethmy/agent")}`,
+    );
+
     console.log("");
     console.log(`  ${colors.dim("Add to new project: npx @gethmy/mcp setup")}`);
     console.log(