@gethmy/mcp 2.15.0 → 2.16.0

package/dist/cli.js

@@ -1826,6 +1826,10 @@ class HarmonyApiClient {
   async updateCard(cardId, updates) {
     return this.request("PATCH", `/cards/${cardId}`, updates);
   }
+  async claimCard(cardId, agentId) {
+    const res = await this.request("PATCH", `/cards/${cardId}`, { assignedAgentId: agentId, ifAssignedAgentNull: true });
+    return { claimed: res.claimed !== false };
+  }
   async moveCard(cardId, columnId, position) {
     return this.request("POST", `/cards/${cardId}/move`, {
       columnId,
@@ -6335,11 +6339,11 @@ async function handleToolCall(name, args, deps) {
     }
     case "harmony_generate_prompt": {
       let cardId;
+      const projectId = args.projectId || deps.getActiveProjectId() || undefined;
       if (args.cardId) {
         cardId = z.string().uuid().parse(args.cardId);
       } else if (args.shortId !== undefined) {
         const shortId = z.number().int().positive().parse(args.shortId);
-        const projectId = args.projectId || deps.getActiveProjectId();
         if (!projectId) {
           throw new Error("Project ID required when using shortId. Use harmony_set_project_context or provide projectId.");
         }
@@ -6348,23 +6352,40 @@ async function handleToolCall(name, args, deps) {
       } else {
         throw new Error("Either cardId or shortId must be provided");
       }
-      let cardTitle = "";
-      let cardDescription = "";
+      const variant = args.variant || undefined;
+      const customConstraints = typeof args.customConstraints === "string" ? args.customConstraints : undefined;
+      const contextOptions = {
+        includeSubtasks: args.includeSubtasks !== false,
+        includeLinks: args.includeLinks !== false,
+        includeDescription: args.includeDescription !== false
+      };
       try {
-        const { card } = await client3.getCard(cardId);
-        const typedCard = card;
-        cardTitle = typedCard.title || "";
-        cardDescription = typedCard.description || "";
-      } catch {}
-      const taskBlock = [cardTitle, cardDescription].filter(Boolean).join(`
+        const result = await client3.generateCardPrompt({
+          cardId,
+          workspaceId: deps.getActiveWorkspaceId() || "",
+          projectId,
+          variant,
+          customConstraints,
+          contextOptions
+        });
+        return { success: true, ...result };
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.debug(`[harmony_generate_prompt] falling back: ${msg}`);
+        let cardTitle = "";
+        let cardDescription = "";
+        try {
+          const { card } = await client3.getCard(cardId);
+          const typedCard = card;
+          cardTitle = typedCard.title || "";
+          cardDescription = typedCard.description || "";
+        } catch {}
+        const taskBlock = [cardTitle, cardDescription].filter(Boolean).join(`
 
 `);
-      const prompt = `Here is the task: ${taskBlock || "(no description available)"}`;
-      return {
-        success: true,
-        prompt,
-        cardId
-      };
+        const prompt = `Here is the task: ${taskBlock || "(no description available)"}`;
+        return { success: true, prompt, cardId };
+      }
     }
     case "harmony_remember": {
       const title = z.string().min(1).max(300).parse(args.title);

package/dist/index.js

@@ -1821,6 +1821,10 @@ class HarmonyApiClient {
   async updateCard(cardId, updates) {
     return this.request("PATCH", `/cards/${cardId}`, updates);
   }
+  async claimCard(cardId, agentId) {
+    const res = await this.request("PATCH", `/cards/${cardId}`, { assignedAgentId: agentId, ifAssignedAgentNull: true });
+    return { claimed: res.claimed !== false };
+  }
   async moveCard(cardId, columnId, position) {
     return this.request("POST", `/cards/${cardId}/move`, {
       columnId,
@@ -6330,11 +6334,11 @@ async function handleToolCall(name, args, deps) {
     }
     case "harmony_generate_prompt": {
       let cardId;
+      const projectId = args.projectId || deps.getActiveProjectId() || undefined;
       if (args.cardId) {
         cardId = z.string().uuid().parse(args.cardId);
       } else if (args.shortId !== undefined) {
         const shortId = z.number().int().positive().parse(args.shortId);
-        const projectId = args.projectId || deps.getActiveProjectId();
         if (!projectId) {
           throw new Error("Project ID required when using shortId. Use harmony_set_project_context or provide projectId.");
         }
@@ -6343,23 +6347,40 @@ async function handleToolCall(name, args, deps) {
       } else {
         throw new Error("Either cardId or shortId must be provided");
       }
-      let cardTitle = "";
-      let cardDescription = "";
+      const variant = args.variant || undefined;
+      const customConstraints = typeof args.customConstraints === "string" ? args.customConstraints : undefined;
+      const contextOptions = {
+        includeSubtasks: args.includeSubtasks !== false,
+        includeLinks: args.includeLinks !== false,
+        includeDescription: args.includeDescription !== false
+      };
       try {
-        const { card } = await client3.getCard(cardId);
-        const typedCard = card;
-        cardTitle = typedCard.title || "";
-        cardDescription = typedCard.description || "";
-      } catch {}
-      const taskBlock = [cardTitle, cardDescription].filter(Boolean).join(`
+        const result = await client3.generateCardPrompt({
+          cardId,
+          workspaceId: deps.getActiveWorkspaceId() || "",
+          projectId,
+          variant,
+          customConstraints,
+          contextOptions
+        });
+        return { success: true, ...result };
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.debug(`[harmony_generate_prompt] falling back: ${msg}`);
+        let cardTitle = "";
+        let cardDescription = "";
+        try {
+          const { card } = await client3.getCard(cardId);
+          const typedCard = card;
+          cardTitle = typedCard.title || "";
+          cardDescription = typedCard.description || "";
+        } catch {}
+        const taskBlock = [cardTitle, cardDescription].filter(Boolean).join(`
 
 `);
-      const prompt = `Here is the task: ${taskBlock || "(no description available)"}`;
-      return {
-        success: true,
-        prompt,
-        cardId
-      };
+        const prompt = `Here is the task: ${taskBlock || "(no description available)"}`;
+        return { success: true, prompt, cardId };
+      }
     }
     case "harmony_remember": {
       const title = z.string().min(1).max(300).parse(args.title);

package/dist/lib/api-client.js

@@ -1273,6 +1273,10 @@ class HarmonyApiClient {
   async updateCard(cardId, updates) {
     return this.request("PATCH", `/cards/${cardId}`, updates);
   }
+  async claimCard(cardId, agentId) {
+    const res = await this.request("PATCH", `/cards/${cardId}`, { assignedAgentId: agentId, ifAssignedAgentNull: true });
+    return { claimed: res.claimed !== false };
+  }
   async moveCard(cardId, columnId, position) {
     return this.request("POST", `/cards/${cardId}/move`, {
       columnId,

package/package.json

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

package/src/api-client.ts

@@ -625,6 +625,25 @@ export class HarmonyApiClient {
     return this.request("PATCH", `/cards/${cardId}`, updates);
   }
 
+  /**
+   * Compare-and-set claim of a card for a virtual agent: sets assigned_agent_id
+   * only if it is currently NULL (server-side guard). Returns `{ claimed: false }`
+   * when another daemon already owns it. Used by the agent-agnostic review pickup.
+   */
+  async claimCard(
+    cardId: string,
+    agentId: string,
+  ): Promise<{ claimed: boolean }> {
+    const res = await this.request<{ card?: unknown; claimed?: boolean }>(
+      "PATCH",
+      `/cards/${cardId}`,
+      { assignedAgentId: agentId, ifAssignedAgentNull: true },
+    );
+    // Success body is `{ card }` (no `claimed` key) → won. Lost-race body is
+    // `{ claimed: false }`.
+    return { claimed: res.claimed !== false };
+  }
+
   async moveCard(
     cardId: string,
     columnId: string,

package/src/server.ts

@@ -3824,17 +3824,16 @@ async function handleToolCall(
     }
 
     // Prompt generation
-    // TODO Phase 1: rebuild full context assembly per docs/superpowers/plans/2026-05-07-memory-architecture-v2.md §10
     case "harmony_generate_prompt": {
       // Resolve card ID — either directly or via short ID
       let cardId: string;
+      const projectId =
+        (args.projectId as string) || deps.getActiveProjectId() || undefined;
 
       if (args.cardId) {
         cardId = z.string().uuid().parse(args.cardId);
       } else if (args.shortId !== undefined) {
         const shortId = z.number().int().positive().parse(args.shortId);
-        const projectId =
-          (args.projectId as string) || deps.getActiveProjectId();
         if (!projectId) {
           throw new Error(
             "Project ID required when using shortId. Use harmony_set_project_context or provide projectId.",
@@ -3846,29 +3845,58 @@ async function handleToolCall(
         throw new Error("Either cardId or shortId must be provided");
       }
 
-      // Phase 0: minimal placeholder prompt with no context assembly.
-      // Fetch just the card title/description so the agent has the basics.
-      let cardTitle = "";
-      let cardDescription = "";
+      const variant =
+        (args.variant as "analysis" | "draft" | "execute") || undefined;
+      const customConstraints =
+        typeof args.customConstraints === "string"
+          ? args.customConstraints
+          : undefined;
+
+      // Context toggles default ON — a card's reference fields (linked cards,
+      // external URLs, attachments) are hydrated inside generateCardPrompt so
+      // the prompt carries the links the agent needs to fetch related content.
+      const contextOptions = {
+        includeSubtasks: args.includeSubtasks !== false,
+        includeLinks: args.includeLinks !== false,
+        includeDescription: args.includeDescription !== false,
+      };
+
       try {
-        const { card } = await client.getCard(cardId);
-        const typedCard = card as { title?: string; description?: string };
-        cardTitle = typedCard.title || "";
-        cardDescription = typedCard.description || "";
-      } catch {
-        // Card fetch failed; return an empty task description.
-      }
+        const result = await client.generateCardPrompt({
+          cardId,
+          workspaceId: deps.getActiveWorkspaceId() || "",
+          projectId,
+          variant,
+          customConstraints,
+          contextOptions,
+        });
+        return { success: true, ...result };
+      } catch (err) {
+        // Graceful fallback: if full context assembly fails (e.g. an offline
+        // sub-fetch), still return a usable title/description prompt so the
+        // Harmony command never dead-ends. The reference-link hydration is
+        // best-effort inside generateCardPrompt and won't reach here.
+        const msg = err instanceof Error ? err.message : String(err);
+        console.debug(`[harmony_generate_prompt] falling back: ${msg}`);
+
+        let cardTitle = "";
+        let cardDescription = "";
+        try {
+          const { card } = await client.getCard(cardId);
+          const typedCard = card as { title?: string; description?: string };
+          cardTitle = typedCard.title || "";
+          cardDescription = typedCard.description || "";
+        } catch {
+          // Card fetch failed; return an empty task description.
+        }
 
-      const taskBlock = [cardTitle, cardDescription]
-        .filter(Boolean)
-        .join("\n\n");
-      const prompt = `Here is the task: ${taskBlock || "(no description available)"}`;
+        const taskBlock = [cardTitle, cardDescription]
+          .filter(Boolean)
+          .join("\n\n");
+        const prompt = `Here is the task: ${taskBlock || "(no description available)"}`;
 
-      return {
-        success: true,
-        prompt,
-        cardId,
-      };
+        return { success: true, prompt, cardId };
+      }
     }
 
     // Memory / Knowledge Graph operations