@gethmy/mcp 2.9.1 → 2.9.3

package/dist/cli.js

@@ -20,7 +20,6 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 // src/prompt-builder.ts
 var exports_prompt_builder = {};
 __export(exports_prompt_builder, {
-  proposePromptVariant: () => proposePromptVariant,
   inferCategoryFromLabels: () => inferCategoryFromLabels,
   getRoleFraming: () => getRoleFraming,
   getAvailableVariants: () => getAvailableVariants,
@@ -337,26 +336,7 @@ function getAvailableCategories() {
 function getAvailableVariants() {
   return ["analysis", "draft", "execute"];
 }
-async function proposePromptVariant(contentHash, fetchCohort) {
-  if (!contentHash)
-    return null;
-  const cohort = await fetchCohort(contentHash);
-  if (!cohort || cohort.length < VARIANT_MIN_COHORT)
-    return null;
-  const completed = cohort.filter((r) => r.status === "completed" && (r.progressPercent ?? 0) >= 100 && !r.hadBlockers).length;
-  const completionRate = completed / cohort.length;
-  if (completionRate >= VARIANT_COMPLETION_THRESHOLD)
-    return null;
-  const blockerRate = cohort.filter((r) => r.hadBlockers).length / cohort.length;
-  const framingHint = blockerRate >= 0.4 ? "Cohort hits frequent blockers — try a more diagnostic framing (require root-cause + repro before any fix)." : "Cohort frequently stalls without finishing — try a more action-forcing framing (smaller subtasks, explicit DoD checklist).";
-  return {
-    contentHash,
-    cohortSize: cohort.length,
-    completionRate,
-    framingHint
-  };
-}
-var PROMPT_TEMPLATE_VERSION = 1, LABEL_CATEGORY_MAP, DEFAULT_ROLE_FRAMINGS, VARIANT_INSTRUCTIONS, VARIANT_MIN_COHORT = 10, VARIANT_COMPLETION_THRESHOLD = 0.4;
+var PROMPT_TEMPLATE_VERSION = 1, LABEL_CATEGORY_MAP, DEFAULT_ROLE_FRAMINGS, VARIANT_INSTRUCTIONS;
 var init_prompt_builder = __esm(() => {
   LABEL_CATEGORY_MAP = {
     bug: "bug",
@@ -715,6 +695,10 @@ function getMemoryDir() {
     return config.memoryDir;
   return join(homedir(), ".harmony", "memory");
 }
+
+// src/server.ts
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
 // ../memory/dist/sync.js
 import { createHash } from "node:crypto";
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync2, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
@@ -1543,6 +1527,9 @@ class HarmonyApiClient {
   async getCardAttachments(cardId) {
     return this.request("GET", `/cards/${cardId}/attachments`);
   }
+  async uploadCardAttachment(cardId, data) {
+    return this.request("POST", `/cards/${cardId}/attachments`, data);
+  }
   async getCardExternalLinks(cardId) {
     return this.request("GET", `/cards/${cardId}/external-links`);
   }
@@ -1860,16 +1847,6 @@ class HarmonyApiClient {
   async recordPromptHistory(data) {
     return this.request("POST", "/prompt-history", data);
   }
-  async recordPromptHistoryFeedback(sessionId, outcome) {
-    return this.request("POST", "/prompt-history/feedback", {
-      sessionId,
-      outcome
-    });
-  }
-  async getPromptHistoryCohort(contentHash) {
-    const params = new URLSearchParams({ content_hash: contentHash });
-    return this.request("GET", `/prompt-history/cohort?${params.toString()}`);
-  }
   async generateCardPrompt(options) {
     const { generatePrompt: generatePrompt2 } = await loadPromptModules();
     const cardResult = await this.getCard(options.cardId);
@@ -1974,6 +1951,23 @@ ${section}`;
       const msg = err instanceof Error ? err.message : String(err);
       console.debug(`[generateCardPrompt] comments fetch failed: ${msg}`);
     }
+    if (cardData.plan_id) {
+      try {
+        const { plan } = await this.getPlan(cardData.plan_id);
+        const planContent = plan?.content;
+        if (planContent?.trim()) {
+          result.prompt = `${result.prompt}
+
+## Approved Plan
+This card has an approved implementation plan. Follow it unless you find a concrete reason it is wrong — if you must diverge, say so in a comment and explain why.
+
+${planContent.trim()}`;
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.debug(`[generateCardPrompt] plan fetch failed: ${msg}`);
+      }
+    }
     try {
       await this.recordPromptHistory({
         cardId: cardData.id,
@@ -1983,11 +1977,7 @@ ${section}`;
           assemblyId: result.assemblyId ?? null,
           tokenEstimate: result.tokenEstimate,
           contextSummary: result.contextSummary
-        },
-        sessionId: options.sessionId ?? null,
-        contentHash: result.contentHash,
-        templateVersion: result.version,
-        confidence: 0.5
+        }
       });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
@@ -3200,7 +3190,7 @@ var TOOLS = {
         title: { type: "string", description: "Card title" },
         columnId: {
           type: "string",
-          description: "Target column ID (optional, defaults to first column)"
+          description: "Target column ID (optional, defaults to the project's default column, or the first column if none is set)"
         },
         projectId: {
           type: "string",
@@ -3502,6 +3492,32 @@ var TOOLS = {
       required: ["cardId"]
     }
   },
+  harmony_upload_card_attachment: {
+    description: "Upload a file attachment to a card (e.g. a pasted screenshot or a document). Provide the file either as `filePath` (a local path the MCP server can read — works in local/stdio mode) or as `base64Data` (raw base64 bytes — works everywhere, including remote mode). Max 5MB. Allowed: PNG, JPEG, GIF, WebP, HEIC/HEIF, PDF, DOC/DOCX, XLS/XLSX, TXT. Returns the stored attachment with a short-lived signed URL.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card UUID" },
+        filePath: {
+          type: "string",
+          description: "Absolute path to a local file the MCP server process can read. Mutually exclusive with base64Data."
+        },
+        base64Data: {
+          type: "string",
+          description: "Base64-encoded file bytes (a `data:` URL prefix is accepted and stripped). Requires fileName. Mutually exclusive with filePath."
+        },
+        fileName: {
+          type: "string",
+          description: "File name including extension (e.g. 'screenshot.png'). Required with base64Data; defaults to the basename of filePath otherwise."
+        },
+        contentType: {
+          type: "string",
+          description: "Optional MIME type (e.g. 'image/png'). Inferred from the file extension when omitted."
+        }
+      },
+      required: ["cardId"]
+    }
+  },
   harmony_get_card_external_links: {
     description: "Get external URL references attached to a card (links to docs, gists, dashboards, etc.).",
     inputSchema: {
@@ -4920,6 +4936,38 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.getCardAttachments(cardId);
       return result;
     }
+    case "harmony_upload_card_attachment": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const filePath = args.filePath != null ? z.string().parse(args.filePath) : undefined;
+      const base64Data = args.base64Data != null ? z.string().parse(args.base64Data) : undefined;
+      let fileName = args.fileName != null ? z.string().parse(args.fileName) : undefined;
+      const contentType = args.contentType != null ? z.string().parse(args.contentType) : undefined;
+      if (filePath && base64Data) {
+        throw new Error("Provide either filePath or base64Data, not both.");
+      }
+      let data;
+      if (filePath) {
+        const bytes = await readFile(filePath);
+        if (bytes.byteLength === 0) {
+          throw new Error(`File is empty: ${filePath}`);
+        }
+        data = bytes.toString("base64");
+        fileName = fileName || basename(filePath);
+      } else if (base64Data) {
+        if (!fileName) {
+          throw new Error("fileName is required when using base64Data.");
+        }
+        data = base64Data;
+      } else {
+        throw new Error("Provide either filePath or base64Data.");
+      }
+      const result = await client3.uploadCardAttachment(cardId, {
+        fileName,
+        data,
+        fileType: contentType
+      });
+      return result;
+    }
     case "harmony_get_card_external_links": {
       const cardId = z.string().uuid().parse(args.cardId);
       const result = await client3.getCardExternalLinks(cardId);
@@ -5720,10 +5768,12 @@ async function handleToolCall(name, args, deps) {
         source: args.source || "agent",
         tasks: args.tasks
       });
-      const planUrl = `https://app.gethmy.com/plans/${result.plan.id}`;
+      const planId = result.plan.id;
+      const { workspaceSlug, projectSlug } = result;
+      const planUrl = workspaceSlug && projectSlug ? `https://app.gethmy.com/${workspaceSlug}/${projectSlug}/plans/${planId}` : `https://app.gethmy.com/plans/${planId}`;
       return {
         success: true,
-        planId: result.plan.id,
+        planId,
         planUrl,
         plan: result.plan,
         tasks: result.tasks

package/dist/index.js

@@ -20,7 +20,6 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 // src/prompt-builder.ts
 var exports_prompt_builder = {};
 __export(exports_prompt_builder, {
-  proposePromptVariant: () => proposePromptVariant,
   inferCategoryFromLabels: () => inferCategoryFromLabels,
   getRoleFraming: () => getRoleFraming,
   getAvailableVariants: () => getAvailableVariants,
@@ -337,26 +336,7 @@ function getAvailableCategories() {
 function getAvailableVariants() {
   return ["analysis", "draft", "execute"];
 }
-async function proposePromptVariant(contentHash, fetchCohort) {
-  if (!contentHash)
-    return null;
-  const cohort = await fetchCohort(contentHash);
-  if (!cohort || cohort.length < VARIANT_MIN_COHORT)
-    return null;
-  const completed = cohort.filter((r) => r.status === "completed" && (r.progressPercent ?? 0) >= 100 && !r.hadBlockers).length;
-  const completionRate = completed / cohort.length;
-  if (completionRate >= VARIANT_COMPLETION_THRESHOLD)
-    return null;
-  const blockerRate = cohort.filter((r) => r.hadBlockers).length / cohort.length;
-  const framingHint = blockerRate >= 0.4 ? "Cohort hits frequent blockers — try a more diagnostic framing (require root-cause + repro before any fix)." : "Cohort frequently stalls without finishing — try a more action-forcing framing (smaller subtasks, explicit DoD checklist).";
-  return {
-    contentHash,
-    cohortSize: cohort.length,
-    completionRate,
-    framingHint
-  };
-}
-var PROMPT_TEMPLATE_VERSION = 1, LABEL_CATEGORY_MAP, DEFAULT_ROLE_FRAMINGS, VARIANT_INSTRUCTIONS, VARIANT_MIN_COHORT = 10, VARIANT_COMPLETION_THRESHOLD = 0.4;
+var PROMPT_TEMPLATE_VERSION = 1, LABEL_CATEGORY_MAP, DEFAULT_ROLE_FRAMINGS, VARIANT_INSTRUCTIONS;
 var init_prompt_builder = __esm(() => {
   LABEL_CATEGORY_MAP = {
     bug: "bug",
@@ -526,6 +506,10 @@ var init_prompt_builder = __esm(() => {
     execute: `EXECUTE MODE: Implement this task completely. Write production-ready code following best practices. Include necessary tests and documentation.`
   };
 });
+
+// src/server.ts
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
 // ../memory/dist/sync.js
 import { createHash } from "node:crypto";
 import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
@@ -1539,6 +1523,9 @@ class HarmonyApiClient {
   async getCardAttachments(cardId) {
     return this.request("GET", `/cards/${cardId}/attachments`);
   }
+  async uploadCardAttachment(cardId, data) {
+    return this.request("POST", `/cards/${cardId}/attachments`, data);
+  }
   async getCardExternalLinks(cardId) {
     return this.request("GET", `/cards/${cardId}/external-links`);
   }
@@ -1856,16 +1843,6 @@ class HarmonyApiClient {
   async recordPromptHistory(data) {
     return this.request("POST", "/prompt-history", data);
   }
-  async recordPromptHistoryFeedback(sessionId, outcome) {
-    return this.request("POST", "/prompt-history/feedback", {
-      sessionId,
-      outcome
-    });
-  }
-  async getPromptHistoryCohort(contentHash) {
-    const params = new URLSearchParams({ content_hash: contentHash });
-    return this.request("GET", `/prompt-history/cohort?${params.toString()}`);
-  }
   async generateCardPrompt(options) {
     const { generatePrompt: generatePrompt2 } = await loadPromptModules();
     const cardResult = await this.getCard(options.cardId);
@@ -1970,6 +1947,23 @@ ${section}`;
       const msg = err instanceof Error ? err.message : String(err);
       console.debug(`[generateCardPrompt] comments fetch failed: ${msg}`);
     }
+    if (cardData.plan_id) {
+      try {
+        const { plan } = await this.getPlan(cardData.plan_id);
+        const planContent = plan?.content;
+        if (planContent?.trim()) {
+          result.prompt = `${result.prompt}
+
+## Approved Plan
+This card has an approved implementation plan. Follow it unless you find a concrete reason it is wrong — if you must diverge, say so in a comment and explain why.
+
+${planContent.trim()}`;
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.debug(`[generateCardPrompt] plan fetch failed: ${msg}`);
+      }
+    }
     try {
       await this.recordPromptHistory({
         cardId: cardData.id,
@@ -1979,11 +1973,7 @@ ${section}`;
           assemblyId: result.assemblyId ?? null,
           tokenEstimate: result.tokenEstimate,
           contextSummary: result.contextSummary
-        },
-        sessionId: options.sessionId ?? null,
-        contentHash: result.contentHash,
-        templateVersion: result.version,
-        confidence: 0.5
+        }
       });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
@@ -3196,7 +3186,7 @@ var TOOLS = {
         title: { type: "string", description: "Card title" },
         columnId: {
           type: "string",
-          description: "Target column ID (optional, defaults to first column)"
+          description: "Target column ID (optional, defaults to the project's default column, or the first column if none is set)"
         },
         projectId: {
           type: "string",
@@ -3498,6 +3488,32 @@ var TOOLS = {
       required: ["cardId"]
     }
   },
+  harmony_upload_card_attachment: {
+    description: "Upload a file attachment to a card (e.g. a pasted screenshot or a document). Provide the file either as `filePath` (a local path the MCP server can read — works in local/stdio mode) or as `base64Data` (raw base64 bytes — works everywhere, including remote mode). Max 5MB. Allowed: PNG, JPEG, GIF, WebP, HEIC/HEIF, PDF, DOC/DOCX, XLS/XLSX, TXT. Returns the stored attachment with a short-lived signed URL.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card UUID" },
+        filePath: {
+          type: "string",
+          description: "Absolute path to a local file the MCP server process can read. Mutually exclusive with base64Data."
+        },
+        base64Data: {
+          type: "string",
+          description: "Base64-encoded file bytes (a `data:` URL prefix is accepted and stripped). Requires fileName. Mutually exclusive with filePath."
+        },
+        fileName: {
+          type: "string",
+          description: "File name including extension (e.g. 'screenshot.png'). Required with base64Data; defaults to the basename of filePath otherwise."
+        },
+        contentType: {
+          type: "string",
+          description: "Optional MIME type (e.g. 'image/png'). Inferred from the file extension when omitted."
+        }
+      },
+      required: ["cardId"]
+    }
+  },
   harmony_get_card_external_links: {
     description: "Get external URL references attached to a card (links to docs, gists, dashboards, etc.).",
     inputSchema: {
@@ -4916,6 +4932,38 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.getCardAttachments(cardId);
       return result;
     }
+    case "harmony_upload_card_attachment": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const filePath = args.filePath != null ? z.string().parse(args.filePath) : undefined;
+      const base64Data = args.base64Data != null ? z.string().parse(args.base64Data) : undefined;
+      let fileName = args.fileName != null ? z.string().parse(args.fileName) : undefined;
+      const contentType = args.contentType != null ? z.string().parse(args.contentType) : undefined;
+      if (filePath && base64Data) {
+        throw new Error("Provide either filePath or base64Data, not both.");
+      }
+      let data;
+      if (filePath) {
+        const bytes = await readFile(filePath);
+        if (bytes.byteLength === 0) {
+          throw new Error(`File is empty: ${filePath}`);
+        }
+        data = bytes.toString("base64");
+        fileName = fileName || basename(filePath);
+      } else if (base64Data) {
+        if (!fileName) {
+          throw new Error("fileName is required when using base64Data.");
+        }
+        data = base64Data;
+      } else {
+        throw new Error("Provide either filePath or base64Data.");
+      }
+      const result = await client3.uploadCardAttachment(cardId, {
+        fileName,
+        data,
+        fileType: contentType
+      });
+      return result;
+    }
     case "harmony_get_card_external_links": {
       const cardId = z.string().uuid().parse(args.cardId);
       const result = await client3.getCardExternalLinks(cardId);
@@ -5716,10 +5764,12 @@ async function handleToolCall(name, args, deps) {
         source: args.source || "agent",
         tasks: args.tasks
       });
-      const planUrl = `https://app.gethmy.com/plans/${result.plan.id}`;
+      const planId = result.plan.id;
+      const { workspaceSlug, projectSlug } = result;
+      const planUrl = workspaceSlug && projectSlug ? `https://app.gethmy.com/${workspaceSlug}/${projectSlug}/plans/${planId}` : `https://app.gethmy.com/plans/${planId}`;
       return {
         success: true,
-        planId: result.plan.id,
+        planId,
         planUrl,
         plan: result.plan,
         tasks: result.tasks

package/dist/lib/api-client.js

@@ -17,7 +17,6 @@ var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 // src/prompt-builder.ts
 var exports_prompt_builder = {};
 __export(exports_prompt_builder, {
-  proposePromptVariant: () => proposePromptVariant,
   inferCategoryFromLabels: () => inferCategoryFromLabels,
   getRoleFraming: () => getRoleFraming,
   getAvailableVariants: () => getAvailableVariants,
@@ -334,26 +333,7 @@ function getAvailableCategories() {
 function getAvailableVariants() {
   return ["analysis", "draft", "execute"];
 }
-async function proposePromptVariant(contentHash, fetchCohort) {
-  if (!contentHash)
-    return null;
-  const cohort = await fetchCohort(contentHash);
-  if (!cohort || cohort.length < VARIANT_MIN_COHORT)
-    return null;
-  const completed = cohort.filter((r) => r.status === "completed" && (r.progressPercent ?? 0) >= 100 && !r.hadBlockers).length;
-  const completionRate = completed / cohort.length;
-  if (completionRate >= VARIANT_COMPLETION_THRESHOLD)
-    return null;
-  const blockerRate = cohort.filter((r) => r.hadBlockers).length / cohort.length;
-  const framingHint = blockerRate >= 0.4 ? "Cohort hits frequent blockers — try a more diagnostic framing (require root-cause + repro before any fix)." : "Cohort frequently stalls without finishing — try a more action-forcing framing (smaller subtasks, explicit DoD checklist).";
-  return {
-    contentHash,
-    cohortSize: cohort.length,
-    completionRate,
-    framingHint
-  };
-}
-var PROMPT_TEMPLATE_VERSION = 1, LABEL_CATEGORY_MAP, DEFAULT_ROLE_FRAMINGS, VARIANT_INSTRUCTIONS, VARIANT_MIN_COHORT = 10, VARIANT_COMPLETION_THRESHOLD = 0.4;
+var PROMPT_TEMPLATE_VERSION = 1, LABEL_CATEGORY_MAP, DEFAULT_ROLE_FRAMINGS, VARIANT_INSTRUCTIONS;
 var init_prompt_builder = __esm(() => {
   LABEL_CATEGORY_MAP = {
     bug: "bug",
@@ -1146,6 +1126,9 @@ class HarmonyApiClient {
   async getCardAttachments(cardId) {
     return this.request("GET", `/cards/${cardId}/attachments`);
   }
+  async uploadCardAttachment(cardId, data) {
+    return this.request("POST", `/cards/${cardId}/attachments`, data);
+  }
   async getCardExternalLinks(cardId) {
     return this.request("GET", `/cards/${cardId}/external-links`);
   }
@@ -1463,16 +1446,6 @@ class HarmonyApiClient {
   async recordPromptHistory(data) {
     return this.request("POST", "/prompt-history", data);
   }
-  async recordPromptHistoryFeedback(sessionId, outcome) {
-    return this.request("POST", "/prompt-history/feedback", {
-      sessionId,
-      outcome
-    });
-  }
-  async getPromptHistoryCohort(contentHash) {
-    const params = new URLSearchParams({ content_hash: contentHash });
-    return this.request("GET", `/prompt-history/cohort?${params.toString()}`);
-  }
   async generateCardPrompt(options) {
     const { generatePrompt: generatePrompt2 } = await loadPromptModules();
     const cardResult = await this.getCard(options.cardId);
@@ -1577,6 +1550,23 @@ ${section}`;
       const msg = err instanceof Error ? err.message : String(err);
       console.debug(`[generateCardPrompt] comments fetch failed: ${msg}`);
     }
+    if (cardData.plan_id) {
+      try {
+        const { plan } = await this.getPlan(cardData.plan_id);
+        const planContent = plan?.content;
+        if (planContent?.trim()) {
+          result.prompt = `${result.prompt}
+
+## Approved Plan
+This card has an approved implementation plan. Follow it unless you find a concrete reason it is wrong — if you must diverge, say so in a comment and explain why.
+
+${planContent.trim()}`;
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.debug(`[generateCardPrompt] plan fetch failed: ${msg}`);
+      }
+    }
     try {
       await this.recordPromptHistory({
         cardId: cardData.id,
@@ -1586,11 +1576,7 @@ ${section}`;
           assemblyId: result.assemblyId ?? null,
           tokenEstimate: result.tokenEstimate,
           contextSummary: result.contextSummary
-        },
-        sessionId: options.sessionId ?? null,
-        contentHash: result.contentHash,
-        templateVersion: result.version,
-        confidence: 0.5
+        }
       });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);

package/package.json

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

package/src/api-client.ts

@@ -486,10 +486,12 @@ export class HarmonyApiClient {
       description?: string;
       priority?: string;
       assigneeId?: string | null;
+      assignedAgentId?: string | null;
       dueDate?: string | null;
       done?: boolean;
       archivedAt?: string | null;
       planId?: string | null;
+      needsPlanRefresh?: boolean;
     },
   ): Promise<{ card: unknown }> {
     return this.request("PATCH", `/cards/${cardId}`, updates);
@@ -581,6 +583,13 @@ export class HarmonyApiClient {
     return this.request("GET", `/cards/${cardId}/attachments`);
   }
 
+  async uploadCardAttachment(
+    cardId: string,
+    data: { fileName: string; data: string; fileType?: string },
+  ): Promise<{ attachment: CardAttachment }> {
+    return this.request("POST", `/cards/${cardId}/attachments`, data);
+  }
+
   async getCardExternalLinks(
     cardId: string,
   ): Promise<{ external_links: CardExternalLinkRow[] }> {
@@ -734,6 +743,10 @@ export class HarmonyApiClient {
         | "budget"
         | "timeout"
         | "stale"
+        | "rate_limit"
+        | "out_of_credits"
+        | "usage_limit"
+        | "auth"
         | "other";
       failureSummary?: string;
       recoveryBranch?: string;
@@ -762,6 +775,10 @@ export class HarmonyApiClient {
         | "budget"
         | "timeout"
         | "stale"
+        | "rate_limit"
+        | "out_of_credits"
+        | "usage_limit"
+        | "auth"
         | "other";
       failureSummary?: string;
       recoveryBranch?: string;
@@ -1215,7 +1232,12 @@ export class HarmonyApiClient {
         status?: "pending" | "in_progress" | "completed";
       }>;
     },
-  ): Promise<{ plan: unknown; tasks?: unknown[] }> {
+  ): Promise<{
+    plan: unknown;
+    tasks?: unknown[];
+    projectSlug?: string | null;
+    workspaceSlug?: string | null;
+  }> {
     return this.request("POST", "/plans", { projectId, ...data });
   }
 
@@ -1322,37 +1344,12 @@ export class HarmonyApiClient {
     generatedPrompt: string;
     variant: "analysis" | "draft" | "execute";
     contextIncluded?: Record<string, unknown>;
-    sessionId?: string | null;
-    contentHash?: string;
-    templateVersion?: number;
-    confidence?: number;
     templateId?: string | null;
     isPinned?: boolean;
   }): Promise<{ entry: unknown }> {
     return this.request("POST", "/prompt-history", data);
   }
 
-  async recordPromptHistoryFeedback(
-    sessionId: string,
-    outcome: "success" | "blocker" | "neutral",
-  ): Promise<{ adjusted: number }> {
-    return this.request("POST", "/prompt-history/feedback", {
-      sessionId,
-      outcome,
-    });
-  }
-
-  async getPromptHistoryCohort(contentHash: string): Promise<{
-    cohort: Array<{
-      status: string | null;
-      progressPercent: number | null;
-      hadBlockers: boolean;
-    }>;
-  }> {
-    const params = new URLSearchParams({ content_hash: contentHash });
-    return this.request("GET", `/prompt-history/cohort?${params.toString()}`);
-  }
-
   // ============ PROMPT GENERATION ============
 
   /**
@@ -1373,8 +1370,6 @@ export class HarmonyApiClient {
       includeLinks: boolean;
       includeDescription: boolean;
     }>;
-    /** Optional active session ID to associate with the prompt snapshot. */
-    sessionId?: string | null;
   }): Promise<{
     prompt: string;
     variant: string;
@@ -1546,8 +1541,30 @@ export class HarmonyApiClient {
       console.debug(`[generateCardPrompt] comments fetch failed: ${msg}`);
     }
 
-    // AGP P2: persist a session-linked snapshot. Best-effort — never fail
-    // prompt generation just because logging didn't land.
+    // Surface a linked plan's full markdown (e.g. a plan the agent daemon
+    // produced and a human approved in gated mode, or any plan attached via
+    // cards.plan_id). This is the central injection point so EVERY caller —
+    // daemon implement run, Claude Code, in-app builder — sees the approved
+    // approach, not just a reference. Best-effort: never fail prompt generation
+    // on a plan fetch error.
+    if (cardData.plan_id) {
+      try {
+        const { plan } = await this.getPlan(cardData.plan_id);
+        const planContent = (plan as { content?: string | null } | null)
+          ?.content;
+        if (planContent?.trim()) {
+          result.prompt = `${result.prompt}\n\n## Approved Plan\nThis card has an approved implementation plan. Follow it unless you find a concrete reason it is wrong — if you must diverge, say so in a comment and explain why.\n\n${planContent.trim()}`;
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.debug(`[generateCardPrompt] plan fetch failed: ${msg}`);
+      }
+    }
+
+    // Persist a snapshot of the generated prompt. Best-effort — never fail
+    // prompt generation just because logging didn't land. (The AGP-era
+    // session_id / content_hash / template_version / confidence columns were
+    // dropped in migration 20260508000000 — card #329.)
     try {
       await this.recordPromptHistory({
         cardId: cardData.id,
@@ -1558,10 +1575,6 @@ export class HarmonyApiClient {
           tokenEstimate: result.tokenEstimate,
           contextSummary: result.contextSummary,
         },
-        sessionId: options.sessionId ?? null,
-        contentHash: result.contentHash,
-        templateVersion: result.version,
-        confidence: 0.5,
       });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
@@ -1610,6 +1623,8 @@ interface CardPromptData {
   }>;
   column_id?: string;
   project_id?: string;
+  /** Linked plan (e.g. an agent-approved plan). Surfaced in the prompt. */
+  plan_id?: string | null;
 }
 
 interface MemoryItem {

package/src/prompt-builder.ts

@@ -773,70 +773,3 @@ export function getAvailableCategories(): LabelCategory[] {
 export function getAvailableVariants(): PromptVariant[] {
   return ["analysis", "draft", "execute"];
 }
-
-// ─── Variant proposal (logged-only — no auto-commit) ──────────────────
-
-/** Cohort row shape consumed by {@link proposePromptVariant}. */
-export interface PromptCohortRow {
-  /** Final agent session status — only "completed" is treated as success. */
-  status: string | null;
-  /** Final progress percent recorded on the linked session, when present. */
-  progressPercent: number | null;
-  /** Whether the linked session ended with non-empty blockers. */
-  hadBlockers: boolean;
-}
-
-export interface PromptVariantSuggestion {
-  contentHash: string;
-  cohortSize: number;
-  completionRate: number;
-  framingHint: string;
-}
-
-const VARIANT_MIN_COHORT = 10;
-const VARIANT_COMPLETION_THRESHOLD = 0.4;
-
-/**
- * Propose an alternative framing for prompts with a given content hash, based
- * on observed session outcomes. Returns null when the cohort is too small or
- * the completion rate is acceptable.
- *
- * Per the AGP-P2 locked decision, this is logged-only — callers may surface
- * the suggestion to humans, but no auto-commit of new templates is allowed.
- *
- * @param fetchCohort — async loader that returns one row per session that
- *   consumed a prompt with this hash. Keeps this module decoupled from the
- *   API client so it stays pure-testable.
- */
-export async function proposePromptVariant(
-  contentHash: string,
-  fetchCohort: (hash: string) => Promise<PromptCohortRow[]>,
-): Promise<PromptVariantSuggestion | null> {
-  if (!contentHash) return null;
-  const cohort = await fetchCohort(contentHash);
-  if (!cohort || cohort.length < VARIANT_MIN_COHORT) return null;
-
-  const completed = cohort.filter(
-    (r) =>
-      r.status === "completed" &&
-      (r.progressPercent ?? 0) >= 100 &&
-      !r.hadBlockers,
-  ).length;
-  const completionRate = completed / cohort.length;
-
-  if (completionRate >= VARIANT_COMPLETION_THRESHOLD) return null;
-
-  const blockerRate =
-    cohort.filter((r) => r.hadBlockers).length / cohort.length;
-  const framingHint =
-    blockerRate >= 0.4
-      ? "Cohort hits frequent blockers — try a more diagnostic framing (require root-cause + repro before any fix)."
-      : "Cohort frequently stalls without finishing — try a more action-forcing framing (smaller subtasks, explicit DoD checklist).";
-
-  return {
-    contentHash,
-    cohortSize: cohort.length,
-    completionRate,
-    framingHint,
-  };
-}

package/src/server.ts

@@ -1,3 +1,5 @@
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
 import { syncFull, syncPull, syncPush } from "@harmony/memory";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -295,7 +297,8 @@ export const TOOLS = {
         title: { type: "string", description: "Card title" },
         columnId: {
           type: "string",
-          description: "Target column ID (optional, defaults to first column)",
+          description:
+            "Target column ID (optional, defaults to the project's default column, or the first column if none is set)",
         },
         projectId: {
           type: "string",
@@ -615,6 +618,37 @@ export const TOOLS = {
       required: ["cardId"],
     },
   },
+  harmony_upload_card_attachment: {
+    description:
+      "Upload a file attachment to a card (e.g. a pasted screenshot or a document). Provide the file either as `filePath` (a local path the MCP server can read — works in local/stdio mode) or as `base64Data` (raw base64 bytes — works everywhere, including remote mode). Max 5MB. Allowed: PNG, JPEG, GIF, WebP, HEIC/HEIF, PDF, DOC/DOCX, XLS/XLSX, TXT. Returns the stored attachment with a short-lived signed URL.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card UUID" },
+        filePath: {
+          type: "string",
+          description:
+            "Absolute path to a local file the MCP server process can read. Mutually exclusive with base64Data.",
+        },
+        base64Data: {
+          type: "string",
+          description:
+            "Base64-encoded file bytes (a `data:` URL prefix is accepted and stripped). Requires fileName. Mutually exclusive with filePath.",
+        },
+        fileName: {
+          type: "string",
+          description:
+            "File name including extension (e.g. 'screenshot.png'). Required with base64Data; defaults to the basename of filePath otherwise.",
+        },
+        contentType: {
+          type: "string",
+          description:
+            "Optional MIME type (e.g. 'image/png'). Inferred from the file extension when omitted.",
+        },
+      },
+      required: ["cardId"],
+    },
+  },
   harmony_get_card_external_links: {
     description:
       "Get external URL references attached to a card (links to docs, gists, dashboards, etc.).",
@@ -2343,6 +2377,48 @@ async function handleToolCall(
       return result;
     }
 
+    case "harmony_upload_card_attachment": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const filePath =
+        args.filePath != null ? z.string().parse(args.filePath) : undefined;
+      const base64Data =
+        args.base64Data != null ? z.string().parse(args.base64Data) : undefined;
+      let fileName =
+        args.fileName != null ? z.string().parse(args.fileName) : undefined;
+      const contentType =
+        args.contentType != null
+          ? z.string().parse(args.contentType)
+          : undefined;
+
+      if (filePath && base64Data) {
+        throw new Error("Provide either filePath or base64Data, not both.");
+      }
+
+      let data: string;
+      if (filePath) {
+        const bytes = await readFile(filePath);
+        if (bytes.byteLength === 0) {
+          throw new Error(`File is empty: ${filePath}`);
+        }
+        data = bytes.toString("base64");
+        fileName = fileName || basename(filePath);
+      } else if (base64Data) {
+        if (!fileName) {
+          throw new Error("fileName is required when using base64Data.");
+        }
+        data = base64Data;
+      } else {
+        throw new Error("Provide either filePath or base64Data.");
+      }
+
+      const result = await client.uploadCardAttachment(cardId, {
+        fileName: fileName as string,
+        data,
+        fileType: contentType,
+      });
+      return result;
+    }
+
     case "harmony_get_card_external_links": {
       const cardId = z.string().uuid().parse(args.cardId);
       const result = await client.getCardExternalLinks(cardId);
@@ -3644,12 +3720,22 @@ async function handleToolCall(
           | undefined,
       });
 
-      // Build URL for viewing the plan
-      const planUrl = `https://app.gethmy.com/plans/${(result.plan as { id: string }).id}`;
+      // Build URL for viewing the plan. The real route is project-scoped
+      // (/{workspaceSlug}/{projectSlug}/plans/{planId}); fall back to the flat
+      // path only if the API didn't return slugs (older deployments).
+      const planId = (result.plan as { id: string }).id;
+      const { workspaceSlug, projectSlug } = result as {
+        workspaceSlug?: string | null;
+        projectSlug?: string | null;
+      };
+      const planUrl =
+        workspaceSlug && projectSlug
+          ? `https://app.gethmy.com/${workspaceSlug}/${projectSlug}/plans/${planId}`
+          : `https://app.gethmy.com/plans/${planId}`;
 
       return {
         success: true,
-        planId: (result.plan as { id: string }).id,
+        planId,
         planUrl,
         plan: result.plan,
         tasks: result.tasks,