@gethmy/mcp 2.9.1 → 2.9.2

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",
@@ -1860,16 +1840,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 +1944,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 +1970,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 +3183,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",
@@ -5720,10 +5703,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",
@@ -1856,16 +1836,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 +1940,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 +1966,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 +3179,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",
@@ -5716,10 +5699,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",
@@ -1463,16 +1443,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 +1547,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 +1573,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.2",
   "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);
@@ -734,6 +736,10 @@ export class HarmonyApiClient {
         | "budget"
         | "timeout"
         | "stale"
+        | "rate_limit"
+        | "out_of_credits"
+        | "usage_limit"
+        | "auth"
         | "other";
       failureSummary?: string;
       recoveryBranch?: string;
@@ -762,6 +768,10 @@ export class HarmonyApiClient {
         | "budget"
         | "timeout"
         | "stale"
+        | "rate_limit"
+        | "out_of_credits"
+        | "usage_limit"
+        | "auth"
         | "other";
       failureSummary?: string;
       recoveryBranch?: string;
@@ -1215,7 +1225,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 +1337,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 +1363,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 +1534,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 +1568,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 +1616,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

@@ -295,7 +295,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",
@@ -3644,12 +3645,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,