harmony-mcp 1.9.4 → 1.9.6

package/dist/cli.js

@@ -30470,6 +30470,9 @@ class HarmonyApiClient {
   async deleteMemoryEntity(entityId) {
     return this.request("DELETE", `/memory/entities/${entityId}`);
   }
+  async touchMemoryEntity(entityId) {
+    return this.request("POST", `/memory/entities/${entityId}/touch`);
+  }
   async createMemoryRelation(data) {
     return this.request("POST", "/memory/relations", data);
   }
@@ -30577,6 +30580,9 @@ class HarmonyApiClient {
   async updatePlan(planId, updates) {
     return this.request("PATCH", `/plans/${planId}`, updates);
   }
+  async updatePlanTask(planId, taskId, updates) {
+    return this.request("PATCH", `/plans/${planId}/tasks/${taskId}`, updates);
+  }
 }
 var client = null;
 function getClient() {
@@ -31056,6 +31062,11 @@ function evaluateLifecycle(entity) {
     reviewReason
   };
 }
+function buildContradictionQuery(type, tags) {
+  if (tags.length === 0)
+    return null;
+  return { type, tags };
+}
 // ../memory/src/graph-walk.ts
 async function discoverRelatedContext(client2, startIds, maxDepth = 2, maxEntities = 20, minConfidence = 0.5) {
   const visited = new Set;
@@ -31735,15 +31746,7 @@ function mapToContextEntity(raw) {
   };
 }
 async function incrementAccessCounts(client3, entityIds) {
-  for (const id of entityIds) {
-    try {
-      await client3.updateMemoryEntity(id, {
-        metadata: {
-          _last_context_load: new Date().toISOString()
-        }
-      });
-    } catch {}
-  }
+  await Promise.allSettled(entityIds.map((id) => client3.touchMemoryEntity(id)));
 }
 var manifestCache = new Map;
 var MAX_CACHE_SIZE = 50;
@@ -32770,6 +32773,11 @@ var TOOLS = {
           enum: ["user", "agent", "imported"],
           description: "Plan source: agent for AI-generated plans (default: agent)"
         },
+        workflowPhase: {
+          type: "string",
+          enum: ["plan", "execute", "verify", "done"],
+          description: "GSD workflow phase (default: plan)"
+        },
         tasks: {
           type: "array",
           items: {
@@ -32810,7 +32818,7 @@ var TOOLS = {
     }
   },
   harmony_update_plan: {
-    description: "Update an existing plan. Can update title, content, or status.",
+    description: "Update an existing plan. Can update title, content, status, or workflow phase.",
     inputSchema: {
       type: "object",
       properties: {
@@ -32824,11 +32832,35 @@ var TOOLS = {
           type: "string",
           enum: ["draft", "active", "archived"],
           description: "New status"
+        },
+        workflowPhase: {
+          type: "string",
+          enum: ["plan", "execute", "verify", "done"],
+          description: "GSD workflow phase"
         }
       },
       required: ["planId"]
     }
   },
+  harmony_advance_plan: {
+    description: "Advance a plan to the next GSD workflow phase with side effects. plan→execute: auto-creates cards from tasks, sets plan active. execute→verify: checks card status. verify→done: archives plan. Creates memory entities at each transition.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        planId: { type: "string", description: "Plan ID to advance" },
+        phase: {
+          type: "string",
+          enum: ["execute", "verify", "done"],
+          description: "Target phase to advance to"
+        },
+        summary: {
+          type: "string",
+          description: "Summary of what happened in the current phase. Stored as a memory entity (decision/pattern/lesson)."
+        }
+      },
+      required: ["planId", "phase"]
+    }
+  },
   harmony_review_learnings: {
     description: "List pending auto-extracted memories awaiting human review. These are memories automatically created from agent work sessions.",
     inputSchema: {
@@ -33553,6 +33585,7 @@ class HarmonyMCPServer {
           throw new Error("No workspace specified. Use harmony_set_workspace_context or provide workspaceId.");
         }
         const entityType = args.type || "context";
+        const entityTags = args.tags || [];
         const result = await client3.createMemoryEntity({
           workspace_id: workspaceId,
           project_id: args.projectId || getActiveProjectId() || undefined,
@@ -33563,10 +33596,39 @@ class HarmonyMCPServer {
           content,
           metadata: args.metadata,
           confidence: args.confidence,
-          tags: args.tags,
+          tags: entityTags.length > 0 ? entityTags : undefined,
           agent_identifier: "claude-code"
         });
-        return { success: true, ...result };
+        const contradictionQuery = buildContradictionQuery(entityType, entityTags);
+        let potentialContradictions = [];
+        if (contradictionQuery) {
+          try {
+            const newEntityId = result.entity?.id;
+            const { entities: candidates } = await client3.listMemoryEntities({
+              workspace_id: workspaceId,
+              type: contradictionQuery.type,
+              tags: contradictionQuery.tags,
+              limit: 10
+            });
+            potentialContradictions = candidates.filter((c) => c.id !== newEntityId).map((c) => ({ id: c.id, title: c.title, tags: c.tags || [] }));
+            if (newEntityId && potentialContradictions.length > 0) {
+              Promise.all(potentialContradictions.map((c) => client3.createMemoryRelation({
+                source_id: newEntityId,
+                target_id: c.id,
+                relation_type: "contradicts",
+                confidence: 0.5
+              }).catch(() => {}))).catch(() => {});
+            }
+          } catch {}
+        }
+        return {
+          success: true,
+          ...result,
+          ...potentialContradictions.length > 0 && {
+            potentialContradictions,
+            contradictionNote: `Found ${potentialContradictions.length} existing memor${potentialContradictions.length === 1 ? "y" : "ies"} with same type and overlapping tags. 'contradicts' relations created automatically. Review these to resolve or confirm.`
+          }
+        };
       }
       case "harmony_recall": {
         const workspaceId = args.workspaceId || getActiveWorkspaceId();
@@ -33750,6 +33812,7 @@ class HarmonyMCPServer {
           title,
           content: args.content,
           source: args.source || "agent",
+          workflowPhase: args.workflowPhase || "plan",
           tasks: args.tasks
         });
         const planUrl = `https://gethmy.com/plans/${result.plan.id}`;
@@ -33796,9 +33859,114 @@ class HarmonyMCPServer {
         if (args.status !== undefined) {
           updates.status = exports_external.enum(["draft", "active", "archived"]).parse(args.status);
         }
+        if (args.workflowPhase !== undefined) {
+          updates.workflowPhase = exports_external.enum(["plan", "execute", "verify", "done"]).parse(args.workflowPhase);
+        }
         const result = await client3.updatePlan(planId, updates);
         return { success: true, plan: result.plan };
       }
+      case "harmony_advance_plan": {
+        const planId = exports_external.string().uuid().parse(args.planId);
+        const targetPhase = exports_external.enum(["execute", "verify", "done"]).parse(args.phase);
+        const summary = args.summary;
+        const planResult = await client3.getPlan(planId);
+        const plan = planResult.plan;
+        const tasks = planResult.tasks;
+        const currentPhase = plan.workflow_phase || "plan";
+        const validTransitions = {
+          plan: "execute",
+          execute: "verify",
+          verify: "done"
+        };
+        if (validTransitions[currentPhase] !== targetPhase) {
+          throw new Error(`Invalid transition: cannot advance from "${currentPhase}" to "${targetPhase}". Expected "${validTransitions[currentPhase]}".`);
+        }
+        const results = {};
+        const workspaceId = getActiveWorkspaceId() || "";
+        if (targetPhase === "execute") {
+          const projectId = plan.project_id;
+          const boardResult = await client3.getBoard(projectId, { summary: true });
+          const columns = boardResult.columns || [];
+          const todoColumn = columns.find((c) => c.name.toLowerCase().includes("to do") || c.name.toLowerCase() === "todo") || columns[0];
+          if (todoColumn && tasks.length > 0) {
+            let cardsCreated = 0;
+            for (const task of tasks) {
+              if (task.card_id)
+                continue;
+              try {
+                const cardResult = await client3.createCard(projectId, {
+                  title: task.content,
+                  columnId: todoColumn.id,
+                  description: `From plan: ${plan.title}`,
+                  priority: task.priority || "medium"
+                });
+                const card = cardResult.card;
+                await client3.updatePlanTask(planId, task.id, { cardId: card.id });
+                cardsCreated++;
+              } catch (e) {}
+            }
+            results.cardsCreated = cardsCreated;
+          }
+          await client3.updatePlan(planId, { status: "active", workflowPhase: "execute" });
+          results.planStatus = "active";
+          if (summary && workspaceId) {
+            try {
+              const memResult = await client3.createMemoryEntity({
+                title: `Decision: ${plan.title}`,
+                content: summary,
+                type: "decision",
+                scope: "project",
+                workspaceId,
+                projectId,
+                tags: ["gsd", "plan"],
+                confidence: 0.8
+              });
+              results.memoryEntityId = memResult.entity?.id;
+            } catch (_) {}
+          }
+        } else if (targetPhase === "verify") {
+          await client3.updatePlan(planId, { workflowPhase: "verify" });
+          if (summary && workspaceId) {
+            try {
+              const memResult = await client3.createMemoryEntity({
+                title: `Pattern: ${plan.title}`,
+                content: summary,
+                type: "pattern",
+                scope: "project",
+                workspaceId,
+                projectId: plan.project_id,
+                tags: ["gsd", "execute"],
+                confidence: 0.8
+              });
+              results.memoryEntityId = memResult.entity?.id;
+            } catch (_) {}
+          }
+        } else if (targetPhase === "done") {
+          await client3.updatePlan(planId, { status: "archived", workflowPhase: "done" });
+          results.planStatus = "archived";
+          if (summary && workspaceId) {
+            try {
+              const memResult = await client3.createMemoryEntity({
+                title: `Lesson: ${plan.title}`,
+                content: summary,
+                type: "lesson",
+                scope: "project",
+                workspaceId,
+                projectId: plan.project_id,
+                tags: ["gsd", "verify"],
+                confidence: 0.8
+              });
+              results.memoryEntityId = memResult.entity?.id;
+            } catch (_) {}
+          }
+        }
+        return {
+          success: true,
+          previousPhase: currentPhase,
+          newPhase: targetPhase,
+          ...results
+        };
+      }
       case "harmony_debug_context": {
         const entityId = exports_external.string().uuid().parse(args.entityId);
         const taskContext = exports_external.string().min(1).parse(args.taskContext);

package/dist/index.js

@@ -28230,6 +28230,9 @@ class HarmonyApiClient {
   async deleteMemoryEntity(entityId) {
     return this.request("DELETE", `/memory/entities/${entityId}`);
   }
+  async touchMemoryEntity(entityId) {
+    return this.request("POST", `/memory/entities/${entityId}/touch`);
+  }
   async createMemoryRelation(data) {
     return this.request("POST", "/memory/relations", data);
   }
@@ -28337,6 +28340,9 @@ class HarmonyApiClient {
   async updatePlan(planId, updates) {
     return this.request("PATCH", `/plans/${planId}`, updates);
   }
+  async updatePlanTask(planId, taskId, updates) {
+    return this.request("PATCH", `/plans/${planId}/tasks/${taskId}`, updates);
+  }
 }
 var client = null;
 function getClient() {
@@ -28816,6 +28822,11 @@ function evaluateLifecycle(entity) {
     reviewReason
   };
 }
+function buildContradictionQuery(type, tags) {
+  if (tags.length === 0)
+    return null;
+  return { type, tags };
+}
 // ../memory/src/graph-walk.ts
 async function discoverRelatedContext(client2, startIds, maxDepth = 2, maxEntities = 20, minConfidence = 0.5) {
   const visited = new Set;
@@ -29495,15 +29506,7 @@ function mapToContextEntity(raw) {
   };
 }
 async function incrementAccessCounts(client3, entityIds) {
-  for (const id of entityIds) {
-    try {
-      await client3.updateMemoryEntity(id, {
-        metadata: {
-          _last_context_load: new Date().toISOString()
-        }
-      });
-    } catch {}
-  }
+  await Promise.allSettled(entityIds.map((id) => client3.touchMemoryEntity(id)));
 }
 var manifestCache = new Map;
 var MAX_CACHE_SIZE = 50;
@@ -30530,6 +30533,11 @@ var TOOLS = {
           enum: ["user", "agent", "imported"],
           description: "Plan source: agent for AI-generated plans (default: agent)"
         },
+        workflowPhase: {
+          type: "string",
+          enum: ["plan", "execute", "verify", "done"],
+          description: "GSD workflow phase (default: plan)"
+        },
         tasks: {
           type: "array",
           items: {
@@ -30570,7 +30578,7 @@ var TOOLS = {
     }
   },
   harmony_update_plan: {
-    description: "Update an existing plan. Can update title, content, or status.",
+    description: "Update an existing plan. Can update title, content, status, or workflow phase.",
     inputSchema: {
       type: "object",
       properties: {
@@ -30584,11 +30592,35 @@ var TOOLS = {
           type: "string",
           enum: ["draft", "active", "archived"],
           description: "New status"
+        },
+        workflowPhase: {
+          type: "string",
+          enum: ["plan", "execute", "verify", "done"],
+          description: "GSD workflow phase"
         }
       },
       required: ["planId"]
     }
   },
+  harmony_advance_plan: {
+    description: "Advance a plan to the next GSD workflow phase with side effects. plan→execute: auto-creates cards from tasks, sets plan active. execute→verify: checks card status. verify→done: archives plan. Creates memory entities at each transition.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        planId: { type: "string", description: "Plan ID to advance" },
+        phase: {
+          type: "string",
+          enum: ["execute", "verify", "done"],
+          description: "Target phase to advance to"
+        },
+        summary: {
+          type: "string",
+          description: "Summary of what happened in the current phase. Stored as a memory entity (decision/pattern/lesson)."
+        }
+      },
+      required: ["planId", "phase"]
+    }
+  },
   harmony_review_learnings: {
     description: "List pending auto-extracted memories awaiting human review. These are memories automatically created from agent work sessions.",
     inputSchema: {
@@ -31313,6 +31345,7 @@ class HarmonyMCPServer {
           throw new Error("No workspace specified. Use harmony_set_workspace_context or provide workspaceId.");
         }
         const entityType = args.type || "context";
+        const entityTags = args.tags || [];
         const result = await client3.createMemoryEntity({
           workspace_id: workspaceId,
           project_id: args.projectId || getActiveProjectId() || undefined,
@@ -31323,10 +31356,39 @@ class HarmonyMCPServer {
           content,
           metadata: args.metadata,
           confidence: args.confidence,
-          tags: args.tags,
+          tags: entityTags.length > 0 ? entityTags : undefined,
           agent_identifier: "claude-code"
         });
-        return { success: true, ...result };
+        const contradictionQuery = buildContradictionQuery(entityType, entityTags);
+        let potentialContradictions = [];
+        if (contradictionQuery) {
+          try {
+            const newEntityId = result.entity?.id;
+            const { entities: candidates } = await client3.listMemoryEntities({
+              workspace_id: workspaceId,
+              type: contradictionQuery.type,
+              tags: contradictionQuery.tags,
+              limit: 10
+            });
+            potentialContradictions = candidates.filter((c) => c.id !== newEntityId).map((c) => ({ id: c.id, title: c.title, tags: c.tags || [] }));
+            if (newEntityId && potentialContradictions.length > 0) {
+              Promise.all(potentialContradictions.map((c) => client3.createMemoryRelation({
+                source_id: newEntityId,
+                target_id: c.id,
+                relation_type: "contradicts",
+                confidence: 0.5
+              }).catch(() => {}))).catch(() => {});
+            }
+          } catch {}
+        }
+        return {
+          success: true,
+          ...result,
+          ...potentialContradictions.length > 0 && {
+            potentialContradictions,
+            contradictionNote: `Found ${potentialContradictions.length} existing memor${potentialContradictions.length === 1 ? "y" : "ies"} with same type and overlapping tags. 'contradicts' relations created automatically. Review these to resolve or confirm.`
+          }
+        };
       }
       case "harmony_recall": {
         const workspaceId = args.workspaceId || getActiveWorkspaceId();
@@ -31510,6 +31572,7 @@ class HarmonyMCPServer {
           title,
           content: args.content,
           source: args.source || "agent",
+          workflowPhase: args.workflowPhase || "plan",
           tasks: args.tasks
         });
         const planUrl = `https://gethmy.com/plans/${result.plan.id}`;
@@ -31556,9 +31619,114 @@ class HarmonyMCPServer {
         if (args.status !== undefined) {
           updates.status = exports_external.enum(["draft", "active", "archived"]).parse(args.status);
         }
+        if (args.workflowPhase !== undefined) {
+          updates.workflowPhase = exports_external.enum(["plan", "execute", "verify", "done"]).parse(args.workflowPhase);
+        }
         const result = await client3.updatePlan(planId, updates);
         return { success: true, plan: result.plan };
       }
+      case "harmony_advance_plan": {
+        const planId = exports_external.string().uuid().parse(args.planId);
+        const targetPhase = exports_external.enum(["execute", "verify", "done"]).parse(args.phase);
+        const summary = args.summary;
+        const planResult = await client3.getPlan(planId);
+        const plan = planResult.plan;
+        const tasks = planResult.tasks;
+        const currentPhase = plan.workflow_phase || "plan";
+        const validTransitions = {
+          plan: "execute",
+          execute: "verify",
+          verify: "done"
+        };
+        if (validTransitions[currentPhase] !== targetPhase) {
+          throw new Error(`Invalid transition: cannot advance from "${currentPhase}" to "${targetPhase}". Expected "${validTransitions[currentPhase]}".`);
+        }
+        const results = {};
+        const workspaceId = getActiveWorkspaceId() || "";
+        if (targetPhase === "execute") {
+          const projectId = plan.project_id;
+          const boardResult = await client3.getBoard(projectId, { summary: true });
+          const columns = boardResult.columns || [];
+          const todoColumn = columns.find((c) => c.name.toLowerCase().includes("to do") || c.name.toLowerCase() === "todo") || columns[0];
+          if (todoColumn && tasks.length > 0) {
+            let cardsCreated = 0;
+            for (const task of tasks) {
+              if (task.card_id)
+                continue;
+              try {
+                const cardResult = await client3.createCard(projectId, {
+                  title: task.content,
+                  columnId: todoColumn.id,
+                  description: `From plan: ${plan.title}`,
+                  priority: task.priority || "medium"
+                });
+                const card = cardResult.card;
+                await client3.updatePlanTask(planId, task.id, { cardId: card.id });
+                cardsCreated++;
+              } catch (e) {}
+            }
+            results.cardsCreated = cardsCreated;
+          }
+          await client3.updatePlan(planId, { status: "active", workflowPhase: "execute" });
+          results.planStatus = "active";
+          if (summary && workspaceId) {
+            try {
+              const memResult = await client3.createMemoryEntity({
+                title: `Decision: ${plan.title}`,
+                content: summary,
+                type: "decision",
+                scope: "project",
+                workspaceId,
+                projectId,
+                tags: ["gsd", "plan"],
+                confidence: 0.8
+              });
+              results.memoryEntityId = memResult.entity?.id;
+            } catch (_) {}
+          }
+        } else if (targetPhase === "verify") {
+          await client3.updatePlan(planId, { workflowPhase: "verify" });
+          if (summary && workspaceId) {
+            try {
+              const memResult = await client3.createMemoryEntity({
+                title: `Pattern: ${plan.title}`,
+                content: summary,
+                type: "pattern",
+                scope: "project",
+                workspaceId,
+                projectId: plan.project_id,
+                tags: ["gsd", "execute"],
+                confidence: 0.8
+              });
+              results.memoryEntityId = memResult.entity?.id;
+            } catch (_) {}
+          }
+        } else if (targetPhase === "done") {
+          await client3.updatePlan(planId, { status: "archived", workflowPhase: "done" });
+          results.planStatus = "archived";
+          if (summary && workspaceId) {
+            try {
+              const memResult = await client3.createMemoryEntity({
+                title: `Lesson: ${plan.title}`,
+                content: summary,
+                type: "lesson",
+                scope: "project",
+                workspaceId,
+                projectId: plan.project_id,
+                tags: ["gsd", "verify"],
+                confidence: 0.8
+              });
+              results.memoryEntityId = memResult.entity?.id;
+            } catch (_) {}
+          }
+        }
+        return {
+          success: true,
+          previousPhase: currentPhase,
+          newPhase: targetPhase,
+          ...results
+        };
+      }
       case "harmony_debug_context": {
         const entityId = exports_external.string().uuid().parse(args.entityId);
         const taskContext = exports_external.string().min(1).parse(args.taskContext);