harmony-mcp 1.10.0 → 1.11.0

package/dist/cli.js

@@ -14371,6 +14371,187 @@ function getMemoryDir() {
     return config.memoryDir;
   return join(homedir(), ".harmony", "memory");
 }
+// ../memory/src/graph-walk.ts
+async function discoverRelatedContext(client, startIds, maxDepth = 2, maxEntities = 20, minConfidence = 0.5) {
+  const visited = new Set;
+  const collectedEntities = [];
+  const collectedRelations = [];
+  let truncated = false;
+  const queue = startIds.map((id) => [id, 0]);
+  for (const id of startIds) {
+    visited.add(id);
+  }
+  while (queue.length > 0) {
+    const [entityId, depth] = queue.shift();
+    if (collectedEntities.length >= maxEntities) {
+      truncated = true;
+      break;
+    }
+    if (depth > maxDepth)
+      continue;
+    try {
+      const entityResult = await client.getMemoryEntity(entityId);
+      const entity = entityResult.entity;
+      if (entity) {
+        collectedEntities.push({
+          id: entity.id,
+          type: entity.type,
+          title: entity.title,
+          confidence: entity.confidence ?? 1,
+          memory_tier: entity.memory_tier || "reference"
+        });
+      }
+      if (depth >= maxDepth)
+        continue;
+      const related = await client.getRelatedEntities(entityId);
+      for (const raw of related.outgoing || []) {
+        const rel = raw;
+        const relConfidence = rel.confidence ?? 1;
+        if (relConfidence < minConfidence)
+          continue;
+        const target = rel.target;
+        const targetId = target?.id ?? rel.target_id;
+        if (targetId && !visited.has(targetId)) {
+          visited.add(targetId);
+          queue.push([targetId, depth + 1]);
+          collectedRelations.push({
+            id: rel.id,
+            source_id: entityId,
+            target_id: targetId,
+            relation_type: rel.relation_type,
+            confidence: relConfidence
+          });
+        }
+      }
+      for (const raw of related.incoming || []) {
+        const rel = raw;
+        const relConfidence = rel.confidence ?? 1;
+        if (relConfidence < minConfidence)
+          continue;
+        const source = rel.source;
+        const sourceId = source?.id ?? rel.source_id;
+        if (sourceId && !visited.has(sourceId)) {
+          visited.add(sourceId);
+          queue.push([sourceId, depth + 1]);
+          collectedRelations.push({
+            id: rel.id,
+            source_id: sourceId,
+            target_id: entityId,
+            relation_type: rel.relation_type,
+            confidence: relConfidence
+          });
+        }
+      }
+    } catch {}
+  }
+  return {
+    entities: collectedEntities,
+    relations: collectedRelations,
+    depth: maxDepth,
+    truncated
+  };
+}
+// ../memory/src/lifecycle.ts
+var DECAY_HALF_LIVES = {
+  draft: 7,
+  episode: 30,
+  reference: 180
+};
+var PROMOTION_RULES = {
+  draftToEpisode: {
+    minAccessCount: 5,
+    minConfidence: 0.8,
+    minAgeDays: 1
+  },
+  episodeToReference: {
+    minAccessCount: 10,
+    minConfidence: 0.9,
+    minAgeDays: 7
+  }
+};
+var ARCHIVE_THRESHOLD = 0.3;
+var STALE_DAYS = 90;
+var STALE_MIN_ACCESS = 3;
+function computeDecayScore(tier, lastAccessedAt, accessCount) {
+  const halfLife = DECAY_HALF_LIVES[tier];
+  const now = Date.now();
+  let daysSinceAccess = 0;
+  if (lastAccessedAt) {
+    daysSinceAccess = (now - new Date(lastAccessedAt).getTime()) / (1000 * 60 * 60 * 24);
+  }
+  const timeDecay = 0.5 ** (daysSinceAccess / halfLife);
+  const accessBonus = Math.log10(accessCount + 1) * 0.1;
+  const score = Math.min(timeDecay + accessBonus, 1);
+  return { score, daysSinceAccess, halfLife, accessBonus };
+}
+function checkPromotion(currentTier, accessCount, confidence, createdAt) {
+  const ageDays = (Date.now() - new Date(createdAt).getTime()) / (1000 * 60 * 60 * 24);
+  const base = {
+    eligible: false,
+    targetTier: null,
+    reason: null,
+    currentTier,
+    accessCount,
+    confidence,
+    ageDays
+  };
+  if (currentTier === "draft") {
+    const rules = PROMOTION_RULES.draftToEpisode;
+    if (accessCount >= rules.minAccessCount && confidence >= rules.minConfidence && ageDays >= rules.minAgeDays) {
+      return {
+        ...base,
+        eligible: true,
+        targetTier: "episode",
+        reason: `Accessed ${accessCount} times (≥${rules.minAccessCount}), confidence ${confidence} (≥${rules.minConfidence}), age ${Math.round(ageDays)}d (≥${rules.minAgeDays}d)`
+      };
+    }
+  }
+  if (currentTier === "episode") {
+    const rules = PROMOTION_RULES.episodeToReference;
+    if (accessCount >= rules.minAccessCount && confidence >= rules.minConfidence && ageDays >= rules.minAgeDays) {
+      return {
+        ...base,
+        eligible: true,
+        targetTier: "reference",
+        reason: `Accessed ${accessCount} times (≥${rules.minAccessCount}), confidence ${confidence} (≥${rules.minConfidence}), age ${Math.round(ageDays)}d (≥${rules.minAgeDays}d)`
+      };
+    }
+  }
+  return base;
+}
+function evaluateLifecycle(entity) {
+  const decay = computeDecayScore(entity.memory_tier, entity.last_accessed_at, entity.access_count);
+  const promotion = checkPromotion(entity.memory_tier, entity.access_count, entity.confidence, entity.created_at);
+  const shouldArchive = entity.confidence < ARCHIVE_THRESHOLD;
+  const archiveReason = shouldArchive ? `Confidence ${entity.confidence} below threshold ${ARCHIVE_THRESHOLD}` : undefined;
+  const shouldFlagForReview = decay.daysSinceAccess >= STALE_DAYS && entity.access_count < STALE_MIN_ACCESS;
+  const reviewReason = shouldFlagForReview ? `Not accessed in ${Math.round(decay.daysSinceAccess)} days with only ${entity.access_count} accesses` : undefined;
+  return {
+    decay,
+    promotion,
+    shouldArchive,
+    shouldFlagForReview,
+    archiveReason,
+    reviewReason
+  };
+}
+function buildContradictionQuery(type, tags) {
+  if (tags.length === 0)
+    return null;
+  return { type, tags };
+}
+// ../memory/src/sync.ts
+import { createHash } from "node:crypto";
+import {
+  existsSync as existsSync2,
+  mkdirSync as mkdirSync2,
+  readdirSync,
+  readFileSync as readFileSync2,
+  rmSync,
+  writeFileSync as writeFileSync2
+} from "node:fs";
+import { join as join2, relative, sep } from "node:path";
+
 // ../memory/src/sync-storage.ts
 function parseSyncMarkdown(markdown) {
   const trimmed = markdown.trim();
@@ -14486,17 +14667,8 @@ function parseYamlArray(value) {
     return [];
   return match[1].split(",").map((s) => s.trim()).filter(Boolean);
 }
+
 // ../memory/src/sync.ts
-import { createHash } from "node:crypto";
-import {
-  existsSync as existsSync2,
-  mkdirSync as mkdirSync2,
-  readdirSync,
-  readFileSync as readFileSync2,
-  rmSync,
-  writeFileSync as writeFileSync2
-} from "node:fs";
-import { join as join2, relative, sep } from "node:path";
 function computeFileHash(content) {
   return `sha256:${createHash("sha256").update(content).digest("hex")}`;
 }
@@ -14758,177 +14930,6 @@ async function syncFull(client, config, workspaceId, projectId) {
     errors: [...pullResult.errors, ...pushResult.errors]
   };
 }
-// ../memory/src/lifecycle.ts
-var DECAY_HALF_LIVES = {
-  draft: 7,
-  episode: 30,
-  reference: 180
-};
-var PROMOTION_RULES = {
-  draftToEpisode: {
-    minAccessCount: 5,
-    minConfidence: 0.8,
-    minAgeDays: 1
-  },
-  episodeToReference: {
-    minAccessCount: 10,
-    minConfidence: 0.9,
-    minAgeDays: 7
-  }
-};
-var ARCHIVE_THRESHOLD = 0.3;
-var STALE_DAYS = 90;
-var STALE_MIN_ACCESS = 3;
-function computeDecayScore(tier, lastAccessedAt, accessCount) {
-  const halfLife = DECAY_HALF_LIVES[tier];
-  const now = Date.now();
-  let daysSinceAccess = 0;
-  if (lastAccessedAt) {
-    daysSinceAccess = (now - new Date(lastAccessedAt).getTime()) / (1000 * 60 * 60 * 24);
-  }
-  const timeDecay = Math.pow(0.5, daysSinceAccess / halfLife);
-  const accessBonus = Math.log10(accessCount + 1) * 0.1;
-  const score = Math.min(timeDecay + accessBonus, 1);
-  return { score, daysSinceAccess, halfLife, accessBonus };
-}
-function checkPromotion(currentTier, accessCount, confidence, createdAt) {
-  const ageDays = (Date.now() - new Date(createdAt).getTime()) / (1000 * 60 * 60 * 24);
-  const base = {
-    eligible: false,
-    targetTier: null,
-    reason: null,
-    currentTier,
-    accessCount,
-    confidence,
-    ageDays
-  };
-  if (currentTier === "draft") {
-    const rules = PROMOTION_RULES.draftToEpisode;
-    if (accessCount >= rules.minAccessCount && confidence >= rules.minConfidence && ageDays >= rules.minAgeDays) {
-      return {
-        ...base,
-        eligible: true,
-        targetTier: "episode",
-        reason: `Accessed ${accessCount} times (≥${rules.minAccessCount}), confidence ${confidence} (≥${rules.minConfidence}), age ${Math.round(ageDays)}d (≥${rules.minAgeDays}d)`
-      };
-    }
-  }
-  if (currentTier === "episode") {
-    const rules = PROMOTION_RULES.episodeToReference;
-    if (accessCount >= rules.minAccessCount && confidence >= rules.minConfidence && ageDays >= rules.minAgeDays) {
-      return {
-        ...base,
-        eligible: true,
-        targetTier: "reference",
-        reason: `Accessed ${accessCount} times (≥${rules.minAccessCount}), confidence ${confidence} (≥${rules.minConfidence}), age ${Math.round(ageDays)}d (≥${rules.minAgeDays}d)`
-      };
-    }
-  }
-  return base;
-}
-function evaluateLifecycle(entity) {
-  const decay = computeDecayScore(entity.memory_tier, entity.last_accessed_at, entity.access_count);
-  const promotion = checkPromotion(entity.memory_tier, entity.access_count, entity.confidence, entity.created_at);
-  const shouldArchive = entity.confidence < ARCHIVE_THRESHOLD;
-  const archiveReason = shouldArchive ? `Confidence ${entity.confidence} below threshold ${ARCHIVE_THRESHOLD}` : undefined;
-  const shouldFlagForReview = decay.daysSinceAccess >= STALE_DAYS && entity.access_count < STALE_MIN_ACCESS;
-  const reviewReason = shouldFlagForReview ? `Not accessed in ${Math.round(decay.daysSinceAccess)} days with only ${entity.access_count} accesses` : undefined;
-  return {
-    decay,
-    promotion,
-    shouldArchive,
-    shouldFlagForReview,
-    archiveReason,
-    reviewReason
-  };
-}
-function buildContradictionQuery(type, tags) {
-  if (tags.length === 0)
-    return null;
-  return { type, tags };
-}
-// ../memory/src/graph-walk.ts
-async function discoverRelatedContext(client, startIds, maxDepth = 2, maxEntities = 20, minConfidence = 0.5) {
-  const visited = new Set;
-  const collectedEntities = [];
-  const collectedRelations = [];
-  let truncated = false;
-  const queue = startIds.map((id) => [id, 0]);
-  for (const id of startIds) {
-    visited.add(id);
-  }
-  while (queue.length > 0) {
-    const [entityId, depth] = queue.shift();
-    if (collectedEntities.length >= maxEntities) {
-      truncated = true;
-      break;
-    }
-    if (depth > maxDepth)
-      continue;
-    try {
-      const entityResult = await client.getMemoryEntity(entityId);
-      const entity = entityResult.entity;
-      if (entity) {
-        collectedEntities.push({
-          id: entity.id,
-          type: entity.type,
-          title: entity.title,
-          confidence: entity.confidence ?? 1,
-          memory_tier: entity.memory_tier || "reference"
-        });
-      }
-      if (depth >= maxDepth)
-        continue;
-      const related = await client.getRelatedEntities(entityId);
-      for (const raw of related.outgoing || []) {
-        const rel = raw;
-        const relConfidence = rel.confidence ?? 1;
-        if (relConfidence < minConfidence)
-          continue;
-        const target = rel.target;
-        const targetId = target?.id ?? rel.target_id;
-        if (targetId && !visited.has(targetId)) {
-          visited.add(targetId);
-          queue.push([targetId, depth + 1]);
-          collectedRelations.push({
-            id: rel.id,
-            source_id: entityId,
-            target_id: targetId,
-            relation_type: rel.relation_type,
-            confidence: relConfidence
-          });
-        }
-      }
-      for (const raw of related.incoming || []) {
-        const rel = raw;
-        const relConfidence = rel.confidence ?? 1;
-        if (relConfidence < minConfidence)
-          continue;
-        const source = rel.source;
-        const sourceId = source?.id ?? rel.source_id;
-        if (sourceId && !visited.has(sourceId)) {
-          visited.add(sourceId);
-          queue.push([sourceId, depth + 1]);
-          collectedRelations.push({
-            id: rel.id,
-            source_id: sourceId,
-            target_id: entityId,
-            relation_type: rel.relation_type,
-            confidence: relConfidence
-          });
-        }
-      }
-    } catch {
-      continue;
-    }
-  }
-  return {
-    entities: collectedEntities,
-    relations: collectedRelations,
-    depth: maxDepth,
-    truncated
-  };
-}
 // ../../node_modules/zod/v4/core/index.js
 var exports_core2 = {};
 __export(exports_core2, {
@@ -30731,7 +30732,7 @@ class StdioServerTransport {
   }
 }
 // src/graph-expansion.ts
-async function autoExpandGraph(client2, entityId, title, content, tags, workspaceId, projectId, maxRelations = 5) {
+async function autoExpandGraph(client2, entityId, title, content, _tags, workspaceId, projectId, maxRelations = 5) {
   try {
     const contentSnippet = content.slice(0, 200).trim();
     const query = [title, contentSnippet].filter(Boolean).join(" ");
@@ -30809,7 +30810,11 @@ Agent: ${session.agentName}`
       type: "lesson",
       tier: "episode",
       confidence: 0.7,
-      tags: ["auto-extracted", "session-summary", ...session.cardLabels.slice(0, 3)],
+      tags: [
+        "auto-extracted",
+        "session-summary",
+        ...session.cardLabels.slice(0, 3)
+      ],
       metadata: {
         source: "active_learning",
         card_id: session.cardId,
@@ -31003,7 +31008,7 @@ function isRetryableError(error48, status) {
   return msg.includes("ECONNRESET") || msg.includes("ETIMEDOUT") || msg.includes("fetch failed");
 }
 function getRetryDelay(attempt) {
-  const delay = Math.min(RETRY_CONFIG.baseDelayMs * Math.pow(2, attempt), RETRY_CONFIG.maxDelayMs);
+  const delay = Math.min(RETRY_CONFIG.baseDelayMs * 2 ** attempt, RETRY_CONFIG.maxDelayMs);
   return Math.round(delay + delay * 0.25 * (Math.random() * 2 - 1));
 }
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
@@ -31122,7 +31127,6 @@ class HarmonyApiClient {
           throw lastError;
         if (attempt < RETRY_CONFIG.maxRetries) {
           await sleep(getRetryDelay(attempt));
-          continue;
         }
       }
     }
@@ -31169,7 +31173,6 @@ class HarmonyApiClient {
           throw lastError;
         if (attempt < RETRY_CONFIG.maxRetries) {
           await sleep(getRetryDelay(attempt));
-          continue;
         }
       }
     }
@@ -31194,6 +31197,8 @@ class HarmonyApiClient {
       params.set("column_id", options.columnId);
     if (options?.summary)
       params.set("summary", "true");
+    if (options?.includeArchived)
+      params.set("include_archived", "true");
     const query = params.toString() ? `?${params.toString()}` : "";
     return this.request("GET", `/board/${projectId}${query}`);
   }
@@ -31209,6 +31214,12 @@ class HarmonyApiClient {
       position
     });
   }
+  async archiveCard(cardId) {
+    return this.updateCard(cardId, { archivedAt: new Date().toISOString() });
+  }
+  async unarchiveCard(cardId) {
+    return this.updateCard(cardId, { archivedAt: null });
+  }
   async deleteCard(cardId) {
     return this.request("DELETE", `/cards/${cardId}`);
   }
@@ -31567,7 +31578,7 @@ function computeRelevanceScore(entity, taskContext, cardLabels) {
   if (entity.last_accessed_at) {
     const daysSinceAccess = (Date.now() - new Date(entity.last_accessed_at).getTime()) / (1000 * 60 * 60 * 24);
     const halfLife = { draft: 7, episode: 30, reference: 180 }[entity.memory_tier];
-    const recencyScore = Math.pow(0.5, daysSinceAccess / halfLife) * 0.1;
+    const recencyScore = 0.5 ** (daysSinceAccess / halfLife) * 0.1;
     score += recencyScore;
     if (daysSinceAccess < 7)
       reasons.push("recently_accessed");
@@ -31644,7 +31655,11 @@ async function assembleContext(options) {
     episode: Math.floor(tokenBudget * TIER_BUDGET_ALLOCATION.episode),
     draft: Math.floor(tokenBudget * TIER_BUDGET_ALLOCATION.draft)
   };
-  const tierUsed = { reference: 0, episode: 0, draft: 0 };
+  const tierUsed = {
+    reference: 0,
+    episode: 0,
+    draft: 0
+  };
   const included = [];
   let totalUsed = 0;
   let referenceCount = 0;
@@ -31714,9 +31729,18 @@ ${text}`);
   }
   manifest.budgetUsed = totalUsed;
   manifest.tierBreakdown = {
-    reference: { count: included.filter((i) => i.entity.memory_tier === "reference").length, tokens: tierUsed.reference },
-    episode: { count: included.filter((i) => i.entity.memory_tier === "episode").length, tokens: tierUsed.episode },
-    draft: { count: included.filter((i) => i.entity.memory_tier === "draft").length, tokens: tierUsed.draft }
+    reference: {
+      count: included.filter((i) => i.entity.memory_tier === "reference").length,
+      tokens: tierUsed.reference
+    },
+    episode: {
+      count: included.filter((i) => i.entity.memory_tier === "episode").length,
+      tokens: tierUsed.episode
+    },
+    draft: {
+      count: included.filter((i) => i.entity.memory_tier === "draft").length,
+      tokens: tierUsed.draft
+    }
   };
   for (const item of included) {
     manifest.included.push({
@@ -32008,7 +32032,15 @@ ${lines.join(`
 `)}`;
 }
 function generatePrompt(options) {
-  const { card, column, variant, customConstraints, memories, assembledContext, assemblyId } = options;
+  const {
+    card,
+    column,
+    variant,
+    customConstraints,
+    memories,
+    assembledContext,
+    assemblyId
+  } = options;
   const contextOpts = {
     includeTitle: true,
     includeDescription: true,
@@ -32162,7 +32194,8 @@ var TOOLS = {
         description: { type: "string" },
         priority: { type: "string", enum: ["low", "medium", "high", "urgent"] },
         assigneeId: { type: "string", nullable: true },
-        dueDate: { type: "string", nullable: true }
+        dueDate: { type: "string", nullable: true },
+        done: { type: "boolean", description: "Mark card as done or not done" }
       },
       required: ["cardId"]
     }
@@ -32182,6 +32215,26 @@ var TOOLS = {
       required: ["cardId", "columnId"]
     }
   },
+  harmony_archive_card: {
+    description: "Archive a card (soft-delete). Card can be restored later with unarchive.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card ID to archive" }
+      },
+      required: ["cardId"]
+    }
+  },
+  harmony_unarchive_card: {
+    description: "Restore an archived card back to the board.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card ID to unarchive" }
+      },
+      required: ["cardId"]
+    }
+  },
   harmony_delete_card: {
     description: "Delete a card",
     inputSchema: {
@@ -32424,6 +32477,10 @@ var TOOLS = {
         summary: {
           type: "boolean",
           description: "Return only columns with card counts, no card details"
+        },
+        includeArchived: {
+          type: "boolean",
+          description: "Include archived cards in results (default: false). Archived cards are excluded by default."
         }
       }
     }
@@ -33482,7 +33539,8 @@ async function handleToolCall(name, args, deps) {
         description: args.description,
         priority: args.priority,
         assigneeId: args.assigneeId,
-        dueDate: args.dueDate
+        dueDate: args.dueDate,
+        done: args.done
       });
       return { success: true, ...result };
     }
@@ -33512,6 +33570,16 @@ async function handleToolCall(name, args, deps) {
       } catch {}
       return { success: true, sessionEnded, ...result };
     }
+    case "harmony_archive_card": {
+      const cardId = exports_external.string().uuid().parse(args.cardId);
+      const result = await client3.archiveCard(cardId);
+      return { success: true, ...result };
+    }
+    case "harmony_unarchive_card": {
+      const cardId = exports_external.string().uuid().parse(args.cardId);
+      const result = await client3.unarchiveCard(cardId);
+      return { success: true, ...result };
+    }
     case "harmony_delete_card": {
       const cardId = exports_external.string().uuid().parse(args.cardId);
       await client3.deleteCard(cardId);
@@ -33635,6 +33703,8 @@ async function handleToolCall(name, args, deps) {
         options.columnId = String(args.columnId);
       if (args.summary === true || args.summary === "true")
         options.summary = true;
+      if (args.includeArchived === true || args.includeArchived === "true")
+        options.includeArchived = true;
       const result = await client3.getBoard(projectId, options);
       return { success: true, board: result };
     }
@@ -34299,7 +34369,7 @@ async function handleToolCall(name, args, deps) {
               const card = cardResult.card;
               await client3.updatePlanTask(planId, task.id, { cardId: card.id });
               cardsCreated++;
-            } catch (e) {}
+            } catch (_e) {}
           }
           results.cardsCreated = cardsCreated;
         }
@@ -34783,7 +34853,7 @@ import {
   unlinkSync
 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
-import { dirname as dirname3, join as join4 } from "node:path";
+import { dirname as dirname2, join as join4 } from "node:path";
 
 // ../../node_modules/@clack/core/dist/index.mjs
 var import_sisteransi = __toESM(require_src(), 1);
@@ -35617,7 +35687,7 @@ function formatPath(path, homeDir) {
 // src/tui/writer.ts
 import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
-import { dirname as dirname2 } from "node:path";
+import { dirname } from "node:path";
 function ensureDir(dirPath) {
   if (!existsSync4(dirPath)) {
     mkdirSync3(dirPath, { recursive: true, mode: 493 });
@@ -35629,7 +35699,7 @@ function writeFile(filePath, content, options = {}) {
     return { path: filePath, action: "skip" };
   }
   try {
-    ensureDir(dirname2(filePath));
+    ensureDir(dirname(filePath));
     const mode = filePath.includes(".harmony-mcp") ? 384 : 420;
     writeFileSync3(filePath, content, { mode });
     return { path: filePath, action: exists ? "update" : "create" };
@@ -35645,7 +35715,7 @@ function mergeJsonFile(filePath, updates, options = {}) {
   const exists = existsSync4(filePath);
   if (!exists) {
     try {
-      ensureDir(dirname2(filePath));
+      ensureDir(dirname(filePath));
       writeFileSync3(filePath, JSON.stringify(updates, null, 2), {
         mode: 420
       });
@@ -35695,7 +35765,7 @@ function appendToToml(filePath, section, content, options = {}) {
   const exists = existsSync4(filePath);
   if (!exists) {
     try {
-      ensureDir(dirname2(filePath));
+      ensureDir(dirname(filePath));
       writeFileSync3(filePath, content, { mode: 420 });
       return { path: filePath, action: "create" };
     } catch (error48) {
@@ -36010,7 +36080,7 @@ async function registerMcpServer() {
 async function writeMcpConfigFallback(home) {
   const { readFileSync: readFileSync4, writeFileSync: writeFileSync4, mkdirSync: mkdirSync5, existsSync: existsSync6 } = await import("node:fs");
   const settingsPath = join4(home, ".claude", "settings.json");
-  const settingsDir = dirname3(settingsPath);
+  const settingsDir = dirname2(settingsPath);
   if (!existsSync6(settingsDir)) {
     mkdirSync5(settingsDir, { recursive: true });
   }
@@ -36578,7 +36648,7 @@ async function runSetup(options = {}) {
   if (allSymlinks.length > 0) {
     for (const symlink of allSymlinks) {
       try {
-        const linkDir = dirname3(symlink.link);
+        const linkDir = dirname2(symlink.link);
         if (!existsSync5(linkDir)) {
           mkdirSync4(linkDir, { recursive: true });
         }

package/dist/index.js

@@ -11946,6 +11946,187 @@ var require_dist = __commonJS((exports, module) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.default = formatsPlugin;
 });
+// ../memory/src/graph-walk.ts
+async function discoverRelatedContext(client, startIds, maxDepth = 2, maxEntities = 20, minConfidence = 0.5) {
+  const visited = new Set;
+  const collectedEntities = [];
+  const collectedRelations = [];
+  let truncated = false;
+  const queue = startIds.map((id) => [id, 0]);
+  for (const id of startIds) {
+    visited.add(id);
+  }
+  while (queue.length > 0) {
+    const [entityId, depth] = queue.shift();
+    if (collectedEntities.length >= maxEntities) {
+      truncated = true;
+      break;
+    }
+    if (depth > maxDepth)
+      continue;
+    try {
+      const entityResult = await client.getMemoryEntity(entityId);
+      const entity = entityResult.entity;
+      if (entity) {
+        collectedEntities.push({
+          id: entity.id,
+          type: entity.type,
+          title: entity.title,
+          confidence: entity.confidence ?? 1,
+          memory_tier: entity.memory_tier || "reference"
+        });
+      }
+      if (depth >= maxDepth)
+        continue;
+      const related = await client.getRelatedEntities(entityId);
+      for (const raw of related.outgoing || []) {
+        const rel = raw;
+        const relConfidence = rel.confidence ?? 1;
+        if (relConfidence < minConfidence)
+          continue;
+        const target = rel.target;
+        const targetId = target?.id ?? rel.target_id;
+        if (targetId && !visited.has(targetId)) {
+          visited.add(targetId);
+          queue.push([targetId, depth + 1]);
+          collectedRelations.push({
+            id: rel.id,
+            source_id: entityId,
+            target_id: targetId,
+            relation_type: rel.relation_type,
+            confidence: relConfidence
+          });
+        }
+      }
+      for (const raw of related.incoming || []) {
+        const rel = raw;
+        const relConfidence = rel.confidence ?? 1;
+        if (relConfidence < minConfidence)
+          continue;
+        const source = rel.source;
+        const sourceId = source?.id ?? rel.source_id;
+        if (sourceId && !visited.has(sourceId)) {
+          visited.add(sourceId);
+          queue.push([sourceId, depth + 1]);
+          collectedRelations.push({
+            id: rel.id,
+            source_id: sourceId,
+            target_id: entityId,
+            relation_type: rel.relation_type,
+            confidence: relConfidence
+          });
+        }
+      }
+    } catch {}
+  }
+  return {
+    entities: collectedEntities,
+    relations: collectedRelations,
+    depth: maxDepth,
+    truncated
+  };
+}
+// ../memory/src/lifecycle.ts
+var DECAY_HALF_LIVES = {
+  draft: 7,
+  episode: 30,
+  reference: 180
+};
+var PROMOTION_RULES = {
+  draftToEpisode: {
+    minAccessCount: 5,
+    minConfidence: 0.8,
+    minAgeDays: 1
+  },
+  episodeToReference: {
+    minAccessCount: 10,
+    minConfidence: 0.9,
+    minAgeDays: 7
+  }
+};
+var ARCHIVE_THRESHOLD = 0.3;
+var STALE_DAYS = 90;
+var STALE_MIN_ACCESS = 3;
+function computeDecayScore(tier, lastAccessedAt, accessCount) {
+  const halfLife = DECAY_HALF_LIVES[tier];
+  const now = Date.now();
+  let daysSinceAccess = 0;
+  if (lastAccessedAt) {
+    daysSinceAccess = (now - new Date(lastAccessedAt).getTime()) / (1000 * 60 * 60 * 24);
+  }
+  const timeDecay = 0.5 ** (daysSinceAccess / halfLife);
+  const accessBonus = Math.log10(accessCount + 1) * 0.1;
+  const score = Math.min(timeDecay + accessBonus, 1);
+  return { score, daysSinceAccess, halfLife, accessBonus };
+}
+function checkPromotion(currentTier, accessCount, confidence, createdAt) {
+  const ageDays = (Date.now() - new Date(createdAt).getTime()) / (1000 * 60 * 60 * 24);
+  const base = {
+    eligible: false,
+    targetTier: null,
+    reason: null,
+    currentTier,
+    accessCount,
+    confidence,
+    ageDays
+  };
+  if (currentTier === "draft") {
+    const rules = PROMOTION_RULES.draftToEpisode;
+    if (accessCount >= rules.minAccessCount && confidence >= rules.minConfidence && ageDays >= rules.minAgeDays) {
+      return {
+        ...base,
+        eligible: true,
+        targetTier: "episode",
+        reason: `Accessed ${accessCount} times (≥${rules.minAccessCount}), confidence ${confidence} (≥${rules.minConfidence}), age ${Math.round(ageDays)}d (≥${rules.minAgeDays}d)`
+      };
+    }
+  }
+  if (currentTier === "episode") {
+    const rules = PROMOTION_RULES.episodeToReference;
+    if (accessCount >= rules.minAccessCount && confidence >= rules.minConfidence && ageDays >= rules.minAgeDays) {
+      return {
+        ...base,
+        eligible: true,
+        targetTier: "reference",
+        reason: `Accessed ${accessCount} times (≥${rules.minAccessCount}), confidence ${confidence} (≥${rules.minConfidence}), age ${Math.round(ageDays)}d (≥${rules.minAgeDays}d)`
+      };
+    }
+  }
+  return base;
+}
+function evaluateLifecycle(entity) {
+  const decay = computeDecayScore(entity.memory_tier, entity.last_accessed_at, entity.access_count);
+  const promotion = checkPromotion(entity.memory_tier, entity.access_count, entity.confidence, entity.created_at);
+  const shouldArchive = entity.confidence < ARCHIVE_THRESHOLD;
+  const archiveReason = shouldArchive ? `Confidence ${entity.confidence} below threshold ${ARCHIVE_THRESHOLD}` : undefined;
+  const shouldFlagForReview = decay.daysSinceAccess >= STALE_DAYS && entity.access_count < STALE_MIN_ACCESS;
+  const reviewReason = shouldFlagForReview ? `Not accessed in ${Math.round(decay.daysSinceAccess)} days with only ${entity.access_count} accesses` : undefined;
+  return {
+    decay,
+    promotion,
+    shouldArchive,
+    shouldFlagForReview,
+    archiveReason,
+    reviewReason
+  };
+}
+function buildContradictionQuery(type, tags) {
+  if (tags.length === 0)
+    return null;
+  return { type, tags };
+}
+// ../memory/src/sync.ts
+import { createHash } from "node:crypto";
+import {
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  rmSync,
+  writeFileSync
+} from "node:fs";
+import { join, relative, sep } from "node:path";
+
 // ../memory/src/sync-storage.ts
 function parseSyncMarkdown(markdown) {
   const trimmed = markdown.trim();
@@ -12061,17 +12242,8 @@ function parseYamlArray(value) {
     return [];
   return match[1].split(",").map((s) => s.trim()).filter(Boolean);
 }
+
 // ../memory/src/sync.ts
-import { createHash } from "node:crypto";
-import {
-  existsSync,
-  mkdirSync,
-  readdirSync,
-  readFileSync,
-  rmSync,
-  writeFileSync
-} from "node:fs";
-import { join, relative, sep } from "node:path";
 function computeFileHash(content) {
   return `sha256:${createHash("sha256").update(content).digest("hex")}`;
 }
@@ -12333,177 +12505,6 @@ async function syncFull(client, config, workspaceId, projectId) {
     errors: [...pullResult.errors, ...pushResult.errors]
   };
 }
-// ../memory/src/lifecycle.ts
-var DECAY_HALF_LIVES = {
-  draft: 7,
-  episode: 30,
-  reference: 180
-};
-var PROMOTION_RULES = {
-  draftToEpisode: {
-    minAccessCount: 5,
-    minConfidence: 0.8,
-    minAgeDays: 1
-  },
-  episodeToReference: {
-    minAccessCount: 10,
-    minConfidence: 0.9,
-    minAgeDays: 7
-  }
-};
-var ARCHIVE_THRESHOLD = 0.3;
-var STALE_DAYS = 90;
-var STALE_MIN_ACCESS = 3;
-function computeDecayScore(tier, lastAccessedAt, accessCount) {
-  const halfLife = DECAY_HALF_LIVES[tier];
-  const now = Date.now();
-  let daysSinceAccess = 0;
-  if (lastAccessedAt) {
-    daysSinceAccess = (now - new Date(lastAccessedAt).getTime()) / (1000 * 60 * 60 * 24);
-  }
-  const timeDecay = Math.pow(0.5, daysSinceAccess / halfLife);
-  const accessBonus = Math.log10(accessCount + 1) * 0.1;
-  const score = Math.min(timeDecay + accessBonus, 1);
-  return { score, daysSinceAccess, halfLife, accessBonus };
-}
-function checkPromotion(currentTier, accessCount, confidence, createdAt) {
-  const ageDays = (Date.now() - new Date(createdAt).getTime()) / (1000 * 60 * 60 * 24);
-  const base = {
-    eligible: false,
-    targetTier: null,
-    reason: null,
-    currentTier,
-    accessCount,
-    confidence,
-    ageDays
-  };
-  if (currentTier === "draft") {
-    const rules = PROMOTION_RULES.draftToEpisode;
-    if (accessCount >= rules.minAccessCount && confidence >= rules.minConfidence && ageDays >= rules.minAgeDays) {
-      return {
-        ...base,
-        eligible: true,
-        targetTier: "episode",
-        reason: `Accessed ${accessCount} times (≥${rules.minAccessCount}), confidence ${confidence} (≥${rules.minConfidence}), age ${Math.round(ageDays)}d (≥${rules.minAgeDays}d)`
-      };
-    }
-  }
-  if (currentTier === "episode") {
-    const rules = PROMOTION_RULES.episodeToReference;
-    if (accessCount >= rules.minAccessCount && confidence >= rules.minConfidence && ageDays >= rules.minAgeDays) {
-      return {
-        ...base,
-        eligible: true,
-        targetTier: "reference",
-        reason: `Accessed ${accessCount} times (≥${rules.minAccessCount}), confidence ${confidence} (≥${rules.minConfidence}), age ${Math.round(ageDays)}d (≥${rules.minAgeDays}d)`
-      };
-    }
-  }
-  return base;
-}
-function evaluateLifecycle(entity) {
-  const decay = computeDecayScore(entity.memory_tier, entity.last_accessed_at, entity.access_count);
-  const promotion = checkPromotion(entity.memory_tier, entity.access_count, entity.confidence, entity.created_at);
-  const shouldArchive = entity.confidence < ARCHIVE_THRESHOLD;
-  const archiveReason = shouldArchive ? `Confidence ${entity.confidence} below threshold ${ARCHIVE_THRESHOLD}` : undefined;
-  const shouldFlagForReview = decay.daysSinceAccess >= STALE_DAYS && entity.access_count < STALE_MIN_ACCESS;
-  const reviewReason = shouldFlagForReview ? `Not accessed in ${Math.round(decay.daysSinceAccess)} days with only ${entity.access_count} accesses` : undefined;
-  return {
-    decay,
-    promotion,
-    shouldArchive,
-    shouldFlagForReview,
-    archiveReason,
-    reviewReason
-  };
-}
-function buildContradictionQuery(type, tags) {
-  if (tags.length === 0)
-    return null;
-  return { type, tags };
-}
-// ../memory/src/graph-walk.ts
-async function discoverRelatedContext(client, startIds, maxDepth = 2, maxEntities = 20, minConfidence = 0.5) {
-  const visited = new Set;
-  const collectedEntities = [];
-  const collectedRelations = [];
-  let truncated = false;
-  const queue = startIds.map((id) => [id, 0]);
-  for (const id of startIds) {
-    visited.add(id);
-  }
-  while (queue.length > 0) {
-    const [entityId, depth] = queue.shift();
-    if (collectedEntities.length >= maxEntities) {
-      truncated = true;
-      break;
-    }
-    if (depth > maxDepth)
-      continue;
-    try {
-      const entityResult = await client.getMemoryEntity(entityId);
-      const entity = entityResult.entity;
-      if (entity) {
-        collectedEntities.push({
-          id: entity.id,
-          type: entity.type,
-          title: entity.title,
-          confidence: entity.confidence ?? 1,
-          memory_tier: entity.memory_tier || "reference"
-        });
-      }
-      if (depth >= maxDepth)
-        continue;
-      const related = await client.getRelatedEntities(entityId);
-      for (const raw of related.outgoing || []) {
-        const rel = raw;
-        const relConfidence = rel.confidence ?? 1;
-        if (relConfidence < minConfidence)
-          continue;
-        const target = rel.target;
-        const targetId = target?.id ?? rel.target_id;
-        if (targetId && !visited.has(targetId)) {
-          visited.add(targetId);
-          queue.push([targetId, depth + 1]);
-          collectedRelations.push({
-            id: rel.id,
-            source_id: entityId,
-            target_id: targetId,
-            relation_type: rel.relation_type,
-            confidence: relConfidence
-          });
-        }
-      }
-      for (const raw of related.incoming || []) {
-        const rel = raw;
-        const relConfidence = rel.confidence ?? 1;
-        if (relConfidence < minConfidence)
-          continue;
-        const source = rel.source;
-        const sourceId = source?.id ?? rel.source_id;
-        if (sourceId && !visited.has(sourceId)) {
-          visited.add(sourceId);
-          queue.push([sourceId, depth + 1]);
-          collectedRelations.push({
-            id: rel.id,
-            source_id: sourceId,
-            target_id: entityId,
-            relation_type: rel.relation_type,
-            confidence: relConfidence
-          });
-        }
-      }
-    } catch {
-      continue;
-    }
-  }
-  return {
-    entities: collectedEntities,
-    relations: collectedRelations,
-    depth: maxDepth,
-    truncated
-  };
-}
 // ../../node_modules/zod/v4/core/index.js
 var exports_core2 = {};
 __export(exports_core2, {
@@ -28491,7 +28492,7 @@ function getMemoryDir() {
 }
 
 // src/graph-expansion.ts
-async function autoExpandGraph(client2, entityId, title, content, tags, workspaceId, projectId, maxRelations = 5) {
+async function autoExpandGraph(client2, entityId, title, content, _tags, workspaceId, projectId, maxRelations = 5) {
   try {
     const contentSnippet = content.slice(0, 200).trim();
     const query = [title, contentSnippet].filter(Boolean).join(" ");
@@ -28569,7 +28570,11 @@ Agent: ${session.agentName}`
       type: "lesson",
       tier: "episode",
       confidence: 0.7,
-      tags: ["auto-extracted", "session-summary", ...session.cardLabels.slice(0, 3)],
+      tags: [
+        "auto-extracted",
+        "session-summary",
+        ...session.cardLabels.slice(0, 3)
+      ],
       metadata: {
         source: "active_learning",
         card_id: session.cardId,
@@ -28763,7 +28768,7 @@ function isRetryableError(error48, status) {
   return msg.includes("ECONNRESET") || msg.includes("ETIMEDOUT") || msg.includes("fetch failed");
 }
 function getRetryDelay(attempt) {
-  const delay = Math.min(RETRY_CONFIG.baseDelayMs * Math.pow(2, attempt), RETRY_CONFIG.maxDelayMs);
+  const delay = Math.min(RETRY_CONFIG.baseDelayMs * 2 ** attempt, RETRY_CONFIG.maxDelayMs);
   return Math.round(delay + delay * 0.25 * (Math.random() * 2 - 1));
 }
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
@@ -28882,7 +28887,6 @@ class HarmonyApiClient {
           throw lastError;
         if (attempt < RETRY_CONFIG.maxRetries) {
           await sleep(getRetryDelay(attempt));
-          continue;
         }
       }
     }
@@ -28929,7 +28933,6 @@ class HarmonyApiClient {
           throw lastError;
         if (attempt < RETRY_CONFIG.maxRetries) {
           await sleep(getRetryDelay(attempt));
-          continue;
         }
       }
     }
@@ -28954,6 +28957,8 @@ class HarmonyApiClient {
       params.set("column_id", options.columnId);
     if (options?.summary)
       params.set("summary", "true");
+    if (options?.includeArchived)
+      params.set("include_archived", "true");
     const query = params.toString() ? `?${params.toString()}` : "";
     return this.request("GET", `/board/${projectId}${query}`);
   }
@@ -28969,6 +28974,12 @@ class HarmonyApiClient {
       position
     });
   }
+  async archiveCard(cardId) {
+    return this.updateCard(cardId, { archivedAt: new Date().toISOString() });
+  }
+  async unarchiveCard(cardId) {
+    return this.updateCard(cardId, { archivedAt: null });
+  }
   async deleteCard(cardId) {
     return this.request("DELETE", `/cards/${cardId}`);
   }
@@ -29327,7 +29338,7 @@ function computeRelevanceScore(entity, taskContext, cardLabels) {
   if (entity.last_accessed_at) {
     const daysSinceAccess = (Date.now() - new Date(entity.last_accessed_at).getTime()) / (1000 * 60 * 60 * 24);
     const halfLife = { draft: 7, episode: 30, reference: 180 }[entity.memory_tier];
-    const recencyScore = Math.pow(0.5, daysSinceAccess / halfLife) * 0.1;
+    const recencyScore = 0.5 ** (daysSinceAccess / halfLife) * 0.1;
     score += recencyScore;
     if (daysSinceAccess < 7)
       reasons.push("recently_accessed");
@@ -29404,7 +29415,11 @@ async function assembleContext(options) {
     episode: Math.floor(tokenBudget * TIER_BUDGET_ALLOCATION.episode),
     draft: Math.floor(tokenBudget * TIER_BUDGET_ALLOCATION.draft)
   };
-  const tierUsed = { reference: 0, episode: 0, draft: 0 };
+  const tierUsed = {
+    reference: 0,
+    episode: 0,
+    draft: 0
+  };
   const included = [];
   let totalUsed = 0;
   let referenceCount = 0;
@@ -29474,9 +29489,18 @@ ${text}`);
   }
   manifest.budgetUsed = totalUsed;
   manifest.tierBreakdown = {
-    reference: { count: included.filter((i) => i.entity.memory_tier === "reference").length, tokens: tierUsed.reference },
-    episode: { count: included.filter((i) => i.entity.memory_tier === "episode").length, tokens: tierUsed.episode },
-    draft: { count: included.filter((i) => i.entity.memory_tier === "draft").length, tokens: tierUsed.draft }
+    reference: {
+      count: included.filter((i) => i.entity.memory_tier === "reference").length,
+      tokens: tierUsed.reference
+    },
+    episode: {
+      count: included.filter((i) => i.entity.memory_tier === "episode").length,
+      tokens: tierUsed.episode
+    },
+    draft: {
+      count: included.filter((i) => i.entity.memory_tier === "draft").length,
+      tokens: tierUsed.draft
+    }
   };
   for (const item of included) {
     manifest.included.push({
@@ -29768,7 +29792,15 @@ ${lines.join(`
 `)}`;
 }
 function generatePrompt(options) {
-  const { card, column, variant, customConstraints, memories, assembledContext, assemblyId } = options;
+  const {
+    card,
+    column,
+    variant,
+    customConstraints,
+    memories,
+    assembledContext,
+    assemblyId
+  } = options;
   const contextOpts = {
     includeTitle: true,
     includeDescription: true,
@@ -29922,7 +29954,8 @@ var TOOLS = {
         description: { type: "string" },
         priority: { type: "string", enum: ["low", "medium", "high", "urgent"] },
         assigneeId: { type: "string", nullable: true },
-        dueDate: { type: "string", nullable: true }
+        dueDate: { type: "string", nullable: true },
+        done: { type: "boolean", description: "Mark card as done or not done" }
       },
       required: ["cardId"]
     }
@@ -29942,6 +29975,26 @@ var TOOLS = {
       required: ["cardId", "columnId"]
     }
   },
+  harmony_archive_card: {
+    description: "Archive a card (soft-delete). Card can be restored later with unarchive.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card ID to archive" }
+      },
+      required: ["cardId"]
+    }
+  },
+  harmony_unarchive_card: {
+    description: "Restore an archived card back to the board.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card ID to unarchive" }
+      },
+      required: ["cardId"]
+    }
+  },
   harmony_delete_card: {
     description: "Delete a card",
     inputSchema: {
@@ -30184,6 +30237,10 @@ var TOOLS = {
         summary: {
           type: "boolean",
           description: "Return only columns with card counts, no card details"
+        },
+        includeArchived: {
+          type: "boolean",
+          description: "Include archived cards in results (default: false). Archived cards are excluded by default."
         }
       }
     }
@@ -31242,7 +31299,8 @@ async function handleToolCall(name, args, deps) {
         description: args.description,
         priority: args.priority,
         assigneeId: args.assigneeId,
-        dueDate: args.dueDate
+        dueDate: args.dueDate,
+        done: args.done
       });
       return { success: true, ...result };
     }
@@ -31272,6 +31330,16 @@ async function handleToolCall(name, args, deps) {
       } catch {}
       return { success: true, sessionEnded, ...result };
     }
+    case "harmony_archive_card": {
+      const cardId = exports_external.string().uuid().parse(args.cardId);
+      const result = await client3.archiveCard(cardId);
+      return { success: true, ...result };
+    }
+    case "harmony_unarchive_card": {
+      const cardId = exports_external.string().uuid().parse(args.cardId);
+      const result = await client3.unarchiveCard(cardId);
+      return { success: true, ...result };
+    }
     case "harmony_delete_card": {
       const cardId = exports_external.string().uuid().parse(args.cardId);
       await client3.deleteCard(cardId);
@@ -31395,6 +31463,8 @@ async function handleToolCall(name, args, deps) {
         options.columnId = String(args.columnId);
       if (args.summary === true || args.summary === "true")
         options.summary = true;
+      if (args.includeArchived === true || args.includeArchived === "true")
+        options.includeArchived = true;
       const result = await client3.getBoard(projectId, options);
       return { success: true, board: result };
     }
@@ -32059,7 +32129,7 @@ async function handleToolCall(name, args, deps) {
               const card = cardResult.card;
               await client3.updatePlanTask(planId, task.id, { cardId: card.id });
               cardsCreated++;
-            } catch (e) {}
+            } catch (_e) {}
           }
           results.cardsCreated = cardsCreated;
         }

package/package.json

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