harmony-mcp 1.13.1 → 1.13.2

package/dist/cli.js

@@ -25371,6 +25371,31 @@ async function extractMidSessionLearnings(client2, ctx) {
   const now = Date.now();
   const entityIds = [];
   const history = sessionTaskHistory.get(ctx.cardId);
+  if (ctx.currentTask) {
+    const previousTask = history?.lastTask || "";
+    const similarity = levenshteinSimilarity(previousTask, ctx.currentTask);
+    const existingSteps = history?.steps || [];
+    if (existingSteps.length === 0 || similarity < 0.6 && previousTask.length > 0) {
+      const newStep = {
+        task: ctx.currentTask,
+        progress: ctx.progressPercent ?? 0,
+        timestamp: now
+      };
+      if (existingSteps.length === 0 && previousTask.length > 0) {
+        existingSteps.push({
+          task: previousTask,
+          progress: 0,
+          timestamp: history?.lastExtractionAt ?? now
+        });
+      }
+      existingSteps.push(newStep);
+      sessionTaskHistory.set(ctx.cardId, {
+        lastTask: ctx.currentTask,
+        lastExtractionAt: history?.lastExtractionAt ?? 0,
+        steps: existingSteps
+      });
+    }
+  }
   if (history && now - history.lastExtractionAt < MID_SESSION_RATE_LIMIT_MS) {
     if (ctx.status !== "blocked" || !ctx.blockers?.length) {
       return { count: 0, entityIds: [] };
@@ -25408,7 +25433,8 @@ Progress: ${ctx.progressPercent ?? "unknown"}%`,
     }
     sessionTaskHistory.set(ctx.cardId, {
       lastTask: ctx.currentTask || "",
-      lastExtractionAt: now
+      lastExtractionAt: now,
+      steps: history?.steps || []
     });
     return { count: entityIds.length, entityIds };
   }
@@ -25444,9 +25470,11 @@ Progress: ${ctx.progressPercent ?? "unknown"}%`,
           entityIds.push(entity.id);
       } catch {}
     }
+    const currentHistory = sessionTaskHistory.get(ctx.cardId);
     sessionTaskHistory.set(ctx.cardId, {
       lastTask: ctx.currentTask,
-      lastExtractionAt: entityIds.length > 0 ? now : history?.lastExtractionAt ?? 0
+      lastExtractionAt: entityIds.length > 0 ? now : currentHistory?.lastExtractionAt ?? 0,
+      steps: currentHistory?.steps || []
     });
   }
   return { count: entityIds.length, entityIds };
@@ -25454,6 +25482,128 @@ Progress: ${ctx.progressPercent ?? "unknown"}%`,
 function clearMidSessionTracking(cardId) {
   sessionTaskHistory.delete(cardId);
 }
+function enrichSteps(steps) {
+  return steps.map((step, i) => {
+    const prevProgress = i > 0 ? steps[i - 1].progress : 0;
+    const prevTimestamp = i > 0 ? steps[i - 1].timestamp : step.timestamp;
+    const progressDelta = step.progress - prevProgress;
+    return {
+      task: step.task,
+      progress: step.progress,
+      progressDelta,
+      durationMs: step.timestamp - prevTimestamp,
+      isKeyDecision: progressDelta >= 20
+    };
+  });
+}
+function buildProcedureContent(session, enrichedSteps, wikiLinksLine) {
+  const triggerLabels = session.cardLabels.length > 0 ? `Labels: ${session.cardLabels.join(", ")}` : "";
+  const stepsMarkdown = enrichedSteps.map((s, i) => {
+    const marker = s.isKeyDecision ? " **[key step]**" : "";
+    const duration3 = s.durationMs > 0 ? ` (~${Math.round(s.durationMs / 60000)}min)` : "";
+    return `${i + 1}. ${s.task} (${s.progress}%, +${s.progressDelta}%)${marker}${duration3}`;
+  }).join(`
+`);
+  const subtaskSection = session.cardSubtasks && session.cardSubtasks.length > 0 ? [
+    "",
+    "## Subtasks Completed",
+    ...session.cardSubtasks.map((s) => `- [${s.done ? "x" : " "}] ${s.title}`)
+  ].join(`
+`) : "";
+  const durationInfo = session.sessionDurationMs ? `
+Duration: ${Math.round(session.sessionDurationMs / 60000)} minutes` : "";
+  return [
+    "## Trigger",
+    `When working on: "${session.cardTitle}"`,
+    triggerLabels,
+    "",
+    "## Steps",
+    stepsMarkdown,
+    subtaskSection,
+    "",
+    "## Outcome",
+    `Completed at ${session.progressPercent ?? "unknown"}%`,
+    session.currentTask ? `Final state: ${session.currentTask}` : "",
+    `Agent: ${session.agentName}`,
+    durationInfo,
+    wikiLinksLine
+  ].filter((line) => line !== undefined).join(`
+`);
+}
+async function extractOrReinforceProcedure(client2, session, steps, workspaceId, projectId, wikiLinksLine = "") {
+  const enrichedSteps = enrichSteps(steps);
+  const newContent = buildProcedureContent(session, enrichedSteps, wikiLinksLine);
+  const tags = [
+    "auto-extracted",
+    "procedure",
+    ...session.cardLabels.slice(0, 3)
+  ];
+  try {
+    const similar = await findSimilarEntities(client2, `Procedure: ${session.cardTitle}`, newContent, workspaceId, { projectId, limit: 5, minRrfScore: 0.03 });
+    const matchingProcedure = similar.find((e) => e.type === "procedure" && (e.rrf_score ?? 0) >= 0.05);
+    if (matchingProcedure) {
+      const { entity: rawEntity } = await client2.getMemoryEntity(matchingProcedure.id);
+      const fullEntity = rawEntity;
+      const currentMeta = fullEntity.metadata || {};
+      const sourceCards = (currentMeta.source_cards || []).slice();
+      if (!sourceCards.includes(session.cardId)) {
+        sourceCards.push(session.cardId);
+      }
+      const reuseCount = (currentMeta.reuse_count || 0) + 1;
+      const currentConfidence = fullEntity.confidence ?? 0.7;
+      const newConfidence = Math.min(0.95, currentConfidence + 0.05);
+      const stepsAppendix = enrichedSteps.map((s, i) => `${i + 1}. ${s.task} (${s.progress}%)`).join(`
+`);
+      const appendix = `
+
+---
+### Execution ${reuseCount + 1}: ${session.cardTitle}
+${stepsAppendix}
+Agent: ${session.agentName} | ${new Date().toISOString().split("T")[0]}`;
+      const updatedMeta = {
+        ...currentMeta,
+        reuse_count: reuseCount,
+        source_cards: sourceCards,
+        last_reinforced_at: new Date().toISOString(),
+        step_count: Math.max(currentMeta.step_count || 0, steps.length)
+      };
+      const shouldPromote = reuseCount >= 2 && fullEntity.memory_tier !== "reference";
+      await client2.updateMemoryEntity(fullEntity.id, {
+        content: (fullEntity.content || "") + appendix,
+        confidence: newConfidence,
+        metadata: {
+          ...updatedMeta,
+          ...shouldPromote ? {
+            promoted_reason: `Reinforced by ${reuseCount + 1} successful sessions`,
+            promoted_at: new Date().toISOString()
+          } : {}
+        },
+        ...shouldPromote ? { memory_tier: "reference" } : {}
+      });
+      return { mode: "reinforced", entityId: fullEntity.id };
+    }
+  } catch {}
+  return {
+    mode: "created",
+    learning: {
+      title: `Procedure: ${session.cardTitle}`,
+      content: newContent,
+      type: "procedure",
+      tier: "episode",
+      confidence: 0.7,
+      tags,
+      metadata: {
+        source: "active_learning",
+        card_id: session.cardId,
+        source_cards: [session.cardId],
+        step_count: steps.length,
+        key_step_count: enrichedSteps.filter((s) => s.isKeyDecision).length,
+        reuse_count: 0,
+        review_status: "pending"
+      }
+    }
+  };
+}
 async function extractLearnings(client2, session) {
   const workspaceId = getActiveWorkspaceId();
   if (!workspaceId) {
@@ -25554,6 +25704,19 @@ Agent: ${session.agentName}`,
     });
   }
   const entityIds = [];
+  const stepHistory = sessionTaskHistory.get(session.cardId);
+  const hasEnoughSteps = stepHistory && stepHistory.steps.length >= 2;
+  const isSuccessful = session.status === "completed" && (session.progressPercent === undefined || session.progressPercent >= 85) && !session.blockers?.length;
+  if (isSuccessful && hasEnoughSteps) {
+    const procedureResult = await extractOrReinforceProcedure(client2, session, stepHistory.steps, workspaceId, projectId, wikiLinksLine);
+    if (procedureResult) {
+      if (procedureResult.mode === "created") {
+        learnings.push(procedureResult.learning);
+      } else {
+        entityIds.push(procedureResult.entityId);
+      }
+    }
+  }
   const createdPairs = [];
   for (const learning of learnings) {
     try {
@@ -29088,11 +29251,18 @@ async function handleToolCall(name, args, deps) {
       let learningsExtracted = 0;
       let cardTitle = "";
       let cardLabels = [];
+      let cardDescription = "";
+      let cardSubtasks = [];
       try {
         const { card } = await client3.getCard(cardId);
         const typedCard = card;
         cardTitle = typedCard.title || "";
         cardLabels = (typedCard.labels || []).map((l) => l.name);
+        cardDescription = typedCard.description || "";
+        cardSubtasks = (typedCard.subtasks || []).map((s) => ({
+          title: s.title,
+          done: s.done
+        }));
         const projectId = typedCard.project_id;
         if (moveToColumn && projectId) {
           const board = await client3.getBoard(projectId, {
@@ -29108,6 +29278,13 @@ async function handleToolCall(name, args, deps) {
       } catch {}
       try {
         const session = result.session;
+        let sessionDurationMs;
+        if (session?.created_at) {
+          const startTime = new Date(session.created_at).getTime();
+          if (!Number.isNaN(startTime)) {
+            sessionDurationMs = Date.now() - startTime;
+          }
+        }
         const sessionContext = {
           cardId,
           cardTitle,
@@ -29117,7 +29294,10 @@ async function handleToolCall(name, args, deps) {
           status: sessionStatus,
           progressPercent: endProgressPercent,
           blockers: session?.blockers || undefined,
-          currentTask: session?.current_task || undefined
+          currentTask: session?.current_task || undefined,
+          sessionDurationMs,
+          cardDescription: cardDescription || undefined,
+          cardSubtasks: cardSubtasks.length > 0 ? cardSubtasks : undefined
         };
         const learningResult = await extractLearnings(client3, sessionContext);
         learningsExtracted = learningResult.count;

package/dist/index.js

@@ -23131,6 +23131,31 @@ async function extractMidSessionLearnings(client2, ctx) {
   const now = Date.now();
   const entityIds = [];
   const history = sessionTaskHistory.get(ctx.cardId);
+  if (ctx.currentTask) {
+    const previousTask = history?.lastTask || "";
+    const similarity = levenshteinSimilarity(previousTask, ctx.currentTask);
+    const existingSteps = history?.steps || [];
+    if (existingSteps.length === 0 || similarity < 0.6 && previousTask.length > 0) {
+      const newStep = {
+        task: ctx.currentTask,
+        progress: ctx.progressPercent ?? 0,
+        timestamp: now
+      };
+      if (existingSteps.length === 0 && previousTask.length > 0) {
+        existingSteps.push({
+          task: previousTask,
+          progress: 0,
+          timestamp: history?.lastExtractionAt ?? now
+        });
+      }
+      existingSteps.push(newStep);
+      sessionTaskHistory.set(ctx.cardId, {
+        lastTask: ctx.currentTask,
+        lastExtractionAt: history?.lastExtractionAt ?? 0,
+        steps: existingSteps
+      });
+    }
+  }
   if (history && now - history.lastExtractionAt < MID_SESSION_RATE_LIMIT_MS) {
     if (ctx.status !== "blocked" || !ctx.blockers?.length) {
       return { count: 0, entityIds: [] };
@@ -23168,7 +23193,8 @@ Progress: ${ctx.progressPercent ?? "unknown"}%`,
     }
     sessionTaskHistory.set(ctx.cardId, {
       lastTask: ctx.currentTask || "",
-      lastExtractionAt: now
+      lastExtractionAt: now,
+      steps: history?.steps || []
     });
     return { count: entityIds.length, entityIds };
   }
@@ -23204,9 +23230,11 @@ Progress: ${ctx.progressPercent ?? "unknown"}%`,
           entityIds.push(entity.id);
       } catch {}
     }
+    const currentHistory = sessionTaskHistory.get(ctx.cardId);
     sessionTaskHistory.set(ctx.cardId, {
       lastTask: ctx.currentTask,
-      lastExtractionAt: entityIds.length > 0 ? now : history?.lastExtractionAt ?? 0
+      lastExtractionAt: entityIds.length > 0 ? now : currentHistory?.lastExtractionAt ?? 0,
+      steps: currentHistory?.steps || []
     });
   }
   return { count: entityIds.length, entityIds };
@@ -23214,6 +23242,128 @@ Progress: ${ctx.progressPercent ?? "unknown"}%`,
 function clearMidSessionTracking(cardId) {
   sessionTaskHistory.delete(cardId);
 }
+function enrichSteps(steps) {
+  return steps.map((step, i) => {
+    const prevProgress = i > 0 ? steps[i - 1].progress : 0;
+    const prevTimestamp = i > 0 ? steps[i - 1].timestamp : step.timestamp;
+    const progressDelta = step.progress - prevProgress;
+    return {
+      task: step.task,
+      progress: step.progress,
+      progressDelta,
+      durationMs: step.timestamp - prevTimestamp,
+      isKeyDecision: progressDelta >= 20
+    };
+  });
+}
+function buildProcedureContent(session, enrichedSteps, wikiLinksLine) {
+  const triggerLabels = session.cardLabels.length > 0 ? `Labels: ${session.cardLabels.join(", ")}` : "";
+  const stepsMarkdown = enrichedSteps.map((s, i) => {
+    const marker = s.isKeyDecision ? " **[key step]**" : "";
+    const duration3 = s.durationMs > 0 ? ` (~${Math.round(s.durationMs / 60000)}min)` : "";
+    return `${i + 1}. ${s.task} (${s.progress}%, +${s.progressDelta}%)${marker}${duration3}`;
+  }).join(`
+`);
+  const subtaskSection = session.cardSubtasks && session.cardSubtasks.length > 0 ? [
+    "",
+    "## Subtasks Completed",
+    ...session.cardSubtasks.map((s) => `- [${s.done ? "x" : " "}] ${s.title}`)
+  ].join(`
+`) : "";
+  const durationInfo = session.sessionDurationMs ? `
+Duration: ${Math.round(session.sessionDurationMs / 60000)} minutes` : "";
+  return [
+    "## Trigger",
+    `When working on: "${session.cardTitle}"`,
+    triggerLabels,
+    "",
+    "## Steps",
+    stepsMarkdown,
+    subtaskSection,
+    "",
+    "## Outcome",
+    `Completed at ${session.progressPercent ?? "unknown"}%`,
+    session.currentTask ? `Final state: ${session.currentTask}` : "",
+    `Agent: ${session.agentName}`,
+    durationInfo,
+    wikiLinksLine
+  ].filter((line) => line !== undefined).join(`
+`);
+}
+async function extractOrReinforceProcedure(client2, session, steps, workspaceId, projectId, wikiLinksLine = "") {
+  const enrichedSteps = enrichSteps(steps);
+  const newContent = buildProcedureContent(session, enrichedSteps, wikiLinksLine);
+  const tags = [
+    "auto-extracted",
+    "procedure",
+    ...session.cardLabels.slice(0, 3)
+  ];
+  try {
+    const similar = await findSimilarEntities(client2, `Procedure: ${session.cardTitle}`, newContent, workspaceId, { projectId, limit: 5, minRrfScore: 0.03 });
+    const matchingProcedure = similar.find((e) => e.type === "procedure" && (e.rrf_score ?? 0) >= 0.05);
+    if (matchingProcedure) {
+      const { entity: rawEntity } = await client2.getMemoryEntity(matchingProcedure.id);
+      const fullEntity = rawEntity;
+      const currentMeta = fullEntity.metadata || {};
+      const sourceCards = (currentMeta.source_cards || []).slice();
+      if (!sourceCards.includes(session.cardId)) {
+        sourceCards.push(session.cardId);
+      }
+      const reuseCount = (currentMeta.reuse_count || 0) + 1;
+      const currentConfidence = fullEntity.confidence ?? 0.7;
+      const newConfidence = Math.min(0.95, currentConfidence + 0.05);
+      const stepsAppendix = enrichedSteps.map((s, i) => `${i + 1}. ${s.task} (${s.progress}%)`).join(`
+`);
+      const appendix = `
+
+---
+### Execution ${reuseCount + 1}: ${session.cardTitle}
+${stepsAppendix}
+Agent: ${session.agentName} | ${new Date().toISOString().split("T")[0]}`;
+      const updatedMeta = {
+        ...currentMeta,
+        reuse_count: reuseCount,
+        source_cards: sourceCards,
+        last_reinforced_at: new Date().toISOString(),
+        step_count: Math.max(currentMeta.step_count || 0, steps.length)
+      };
+      const shouldPromote = reuseCount >= 2 && fullEntity.memory_tier !== "reference";
+      await client2.updateMemoryEntity(fullEntity.id, {
+        content: (fullEntity.content || "") + appendix,
+        confidence: newConfidence,
+        metadata: {
+          ...updatedMeta,
+          ...shouldPromote ? {
+            promoted_reason: `Reinforced by ${reuseCount + 1} successful sessions`,
+            promoted_at: new Date().toISOString()
+          } : {}
+        },
+        ...shouldPromote ? { memory_tier: "reference" } : {}
+      });
+      return { mode: "reinforced", entityId: fullEntity.id };
+    }
+  } catch {}
+  return {
+    mode: "created",
+    learning: {
+      title: `Procedure: ${session.cardTitle}`,
+      content: newContent,
+      type: "procedure",
+      tier: "episode",
+      confidence: 0.7,
+      tags,
+      metadata: {
+        source: "active_learning",
+        card_id: session.cardId,
+        source_cards: [session.cardId],
+        step_count: steps.length,
+        key_step_count: enrichedSteps.filter((s) => s.isKeyDecision).length,
+        reuse_count: 0,
+        review_status: "pending"
+      }
+    }
+  };
+}
 async function extractLearnings(client2, session) {
   const workspaceId = getActiveWorkspaceId();
   if (!workspaceId) {
@@ -23314,6 +23464,19 @@ Agent: ${session.agentName}`,
     });
   }
   const entityIds = [];
+  const stepHistory = sessionTaskHistory.get(session.cardId);
+  const hasEnoughSteps = stepHistory && stepHistory.steps.length >= 2;
+  const isSuccessful = session.status === "completed" && (session.progressPercent === undefined || session.progressPercent >= 85) && !session.blockers?.length;
+  if (isSuccessful && hasEnoughSteps) {
+    const procedureResult = await extractOrReinforceProcedure(client2, session, stepHistory.steps, workspaceId, projectId, wikiLinksLine);
+    if (procedureResult) {
+      if (procedureResult.mode === "created") {
+        learnings.push(procedureResult.learning);
+      } else {
+        entityIds.push(procedureResult.entityId);
+      }
+    }
+  }
   const createdPairs = [];
   for (const learning of learnings) {
     try {
@@ -26848,11 +27011,18 @@ async function handleToolCall(name, args, deps) {
       let learningsExtracted = 0;
       let cardTitle = "";
       let cardLabels = [];
+      let cardDescription = "";
+      let cardSubtasks = [];
       try {
         const { card } = await client3.getCard(cardId);
         const typedCard = card;
         cardTitle = typedCard.title || "";
         cardLabels = (typedCard.labels || []).map((l) => l.name);
+        cardDescription = typedCard.description || "";
+        cardSubtasks = (typedCard.subtasks || []).map((s) => ({
+          title: s.title,
+          done: s.done
+        }));
         const projectId = typedCard.project_id;
         if (moveToColumn && projectId) {
           const board = await client3.getBoard(projectId, {
@@ -26868,6 +27038,13 @@ async function handleToolCall(name, args, deps) {
       } catch {}
       try {
         const session = result.session;
+        let sessionDurationMs;
+        if (session?.created_at) {
+          const startTime = new Date(session.created_at).getTime();
+          if (!Number.isNaN(startTime)) {
+            sessionDurationMs = Date.now() - startTime;
+          }
+        }
         const sessionContext = {
           cardId,
           cardTitle,
@@ -26877,7 +27054,10 @@ async function handleToolCall(name, args, deps) {
           status: sessionStatus,
           progressPercent: endProgressPercent,
           blockers: session?.blockers || undefined,
-          currentTask: session?.current_task || undefined
+          currentTask: session?.current_task || undefined,
+          sessionDurationMs,
+          cardDescription: cardDescription || undefined,
+          cardSubtasks: cardSubtasks.length > 0 ? cardSubtasks : undefined
         };
         const learningResult = await extractLearnings(client3, sessionContext);
         learningsExtracted = learningResult.count;

package/package.json

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