@gethmy/mcp 2.2.3 → 2.3.0

package/src/server.ts

@@ -58,6 +58,7 @@ import {
 } from "./context-assembly.js";
 import { autoExpandGraph } from "./graph-expansion.js";
 import { runLifecycleMaintenance } from "./lifecycle-maintenance.js";
+import { runMemoryCleanup } from "./memory-cleanup.js";
 import { onboardNewUser } from "./onboard.js";
 import type { PromptVariant } from "./prompt-builder.js";
 
@@ -1637,6 +1638,51 @@ const TOOLS = {
       required: [],
     },
   },
+
+  harmony_cleanup_memories: {
+    description:
+      "Run a unified memory cleanup: prune stale drafts, consolidate similar memories, detect orphans and duplicates, and backfill embeddings. Returns a health report. Dry-run by default — run with dryRun=false to execute.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        workspaceId: {
+          type: "string",
+          description: "Workspace ID (optional if context set)",
+        },
+        projectId: {
+          type: "string",
+          description: "Project ID (optional)",
+        },
+        dryRun: {
+          type: "boolean",
+          description:
+            "Preview cleanup without executing changes (default: true)",
+        },
+        steps: {
+          type: "array",
+          items: {
+            type: "string",
+            enum: ["prune", "consolidate", "orphans", "duplicates", "backfill"],
+          },
+          description:
+            "Which cleanup steps to run (default: all). Options: prune, consolidate, orphans, duplicates, backfill.",
+        },
+        maxAgeDays: {
+          type: "number",
+          description: "Max age in days for stale draft pruning (default: 30)",
+        },
+        minClusterSize: {
+          type: "number",
+          description: "Min cluster size for consolidation (default: 3)",
+        },
+        orphanAgeDays: {
+          type: "number",
+          description: "Min age in days for orphan detection (default: 14)",
+        },
+      },
+      required: [],
+    },
+  },
 };
 
 // Resource URIs
@@ -3967,6 +4013,34 @@ async function handleToolCall(
       };
     }
 
+    case "harmony_cleanup_memories": {
+      const workspaceId =
+        (args.workspaceId as string) || deps.getActiveWorkspaceId();
+      if (!workspaceId) {
+        throw new Error(
+          "No workspace specified. Use harmony_set_workspace_context or provide workspaceId.",
+        );
+      }
+      const projectId =
+        (args.projectId as string) || deps.getActiveProjectId() || undefined;
+
+      const report = await runMemoryCleanup(client, workspaceId, projectId, {
+        dryRun: args.dryRun as boolean | undefined,
+        steps: args.steps as string[] | undefined,
+        maxAgeDays: args.maxAgeDays as number | undefined,
+        minClusterSize: args.minClusterSize as number | undefined,
+        orphanAgeDays: args.orphanAgeDays as number | undefined,
+      });
+
+      return {
+        success: report.success,
+        dryRun: report.dryRun,
+        summary: report.summary,
+        errors: report.errors,
+        healthReport: report.healthReport,
+      };
+    }
+
     default:
       throw new Error(`Unknown tool: ${name}`);
   }

package/src/skills.ts

@@ -2,7 +2,7 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
 import { areSkillsInstalled } from "./config.js";
 
-export const SKILLS_VERSION = "3";
+export const SKILLS_VERSION = "4";
 
 const VERSION_MARKER_PREFIX = "<!-- skills-version:";
 
@@ -206,6 +206,30 @@ Do not start an agent session.
 
 ---
 
+## Step E: Auto-Detect Card for Implementation Tasks
+
+**IMPORTANT:** This step applies when you are about to implement a plan, feature, or fix
+that was NOT started via /hmy. Before writing any code, check if the work maps to an
+existing Harmony card.
+
+### When to run this check
+- User says "implement this plan", "build this feature", "fix this bug" (without /hmy)
+- You are about to execute a plan file
+- Skip if: the user already started with /hmy, or no Harmony MCP tools are available
+
+### Detection steps
+1. Call \`harmony_search_cards\` with keywords from the plan title or task description
+2. If a card matches (same feature/fix described), tell the user:
+   "This maps to card #N — starting a session to track progress."
+3. Call \`harmony_start_agent_session\` with \`moveToColumn: "In Progress"\`, \`addLabels: ["agent"]\`
+4. Track progress with \`harmony_update_agent_progress\` at milestones
+5. When done, call \`harmony_end_agent_session\` with \`status: "completed"\`, \`moveToColumn: "Review"\`
+
+### If no match
+Proceed normally without a session. No action needed.
+
+---
+
 ## Key Tools Reference
 
 **Cards:** \`harmony_get_card\`, \`harmony_get_card_by_short_id\`, \`harmony_search_cards\`, \`harmony_create_card\`, \`harmony_update_card\`, \`harmony_move_card\`, \`harmony_delete_card\`, \`harmony_assign_card\`

package/src/tui/setup.ts

@@ -299,6 +299,17 @@ When given a card reference (e.g., #42 or a card name), follow this workflow:
 7. Update progress periodically with \`harmony_update_agent_progress\`
 8. When done, call \`harmony_end_agent_session\` and move to "Review"
 
+## Auto-Detect Card for Implementation Tasks
+
+Before implementing a plan or feature, check if it maps to an existing Harmony card:
+
+1. Use \`harmony_search_cards\` with keywords from the task description
+2. If a match is found, call \`harmony_start_agent_session\` (agentIdentifier: "claude-code", agentName: "Claude Code", moveToColumn: "In Progress", addLabels: ["agent"])
+3. Update progress with \`harmony_update_agent_progress\` at milestones
+4. When done, call \`harmony_end_agent_session\` with status: "completed", moveToColumn: "Review"
+
+Skip if: work was already started with a card reference, or no matching card exists.
+
 ## Available Harmony Tools
 
 - \`harmony_get_card\`, \`harmony_get_card_by_short_id\`, \`harmony_search_cards\` - Find cards