@gethmy/mcp 2.4.0 → 2.4.1

package/dist/cli.js

@@ -28087,7 +28087,7 @@ function isBoilerplate(title, content) {
   }
   return false;
 }
-function scoreEntity(entity, relationCount, archiveBelow, deleteBelow) {
+function scoreEntity(entity, relationCount, archiveBelow, deleteBelow, staleDraftAgeDays) {
   const now = Date.now();
   const ageDays = (now - Date.parse(entity.created_at)) / MS_PER_DAY;
   const effectiveLastAccess = entity.last_accessed_at ?? entity.created_at;
@@ -28172,6 +28172,7 @@ function scoreEntity(entity, relationCount, archiveBelow, deleteBelow) {
     bucket = "review";
   else
     bucket = "keep";
+  const staleDraft = entity.memory_tier === "draft" && (entity.access_count || 0) === 0 && ageDays > staleDraftAgeDays;
   return {
     id: entity.id,
     title: entity.title,
@@ -28183,6 +28184,7 @@ function scoreEntity(entity, relationCount, archiveBelow, deleteBelow) {
     reasons,
     legacy,
     legacyReasons,
+    staleDraft,
     subScores: {
       confidence: Math.round(confidence),
       decay: Math.round(decay),
@@ -28198,6 +28200,7 @@ async function runMemoryAudit(client3, workspaceId, projectId, options) {
   const archiveBelow = options?.archiveBelow ?? 40;
   const deleteBelow = options?.deleteBelow ?? 20;
   const limit = options?.limit ?? 500;
+  const staleDraftAgeDays = options?.staleDraftAgeDays ?? 7;
   const report = {
     success: true,
     dryRun,
@@ -28210,7 +28213,8 @@ async function runMemoryAudit(client3, workspaceId, projectId, options) {
       review: 0,
       archive: 0,
       delete: 0,
-      legacyCount: 0
+      legacyCount: 0,
+      staleDraftCount: 0
     },
     actionsTaken: { flaggedReview: 0, archived: 0, deleted: 0 },
     distribution: { "0-20": 0, "20-40": 0, "40-70": 0, "70-100": 0 },
@@ -28221,6 +28225,7 @@ async function runMemoryAudit(client3, workspaceId, projectId, options) {
       noGraphPresence: 0
     },
     lowest: [],
+    staleDrafts: [],
     errors: [],
     healthReport: ""
   };
@@ -28270,12 +28275,14 @@ async function runMemoryAudit(client3, workspaceId, projectId, options) {
   const audits = [];
   for (const entity of entities) {
     const relCount = relationCounts.get(entity.id) ?? 0;
-    const audit = scoreEntity(entity, relCount, archiveBelow, deleteBelow);
+    const audit = scoreEntity(entity, relCount, archiveBelow, deleteBelow, staleDraftAgeDays);
     audits.push(audit);
     report.summary.scanned++;
     report.summary[audit.bucket]++;
     if (audit.legacy)
       report.summary.legacyCount++;
+    if (audit.staleDraft)
+      report.summary.staleDraftCount++;
     if (audit.score < 20)
       report.distribution["0-20"]++;
     else if (audit.score < 40)
@@ -28296,6 +28303,7 @@ async function runMemoryAudit(client3, workspaceId, projectId, options) {
     }
   }
   report.lowest = [...audits].sort((a, b) => a.score - b.score).slice(0, 10);
+  report.staleDrafts = audits.filter((a) => a.staleDraft).sort((a, b) => b.ageDays - a.ageDays);
   if (!dryRun) {
     for (const audit of audits) {
       try {
@@ -28341,7 +28349,7 @@ function renderReport(report) {
   const lines = [
     `# Memory Quality Audit
 `,
-    `**Mode:** ${mode} | **Scanned:** ${s.scanned}/${s.totalEntities} | **Legacy:** ${s.legacyCount}`,
+    `**Mode:** ${mode} | **Scanned:** ${s.scanned}/${s.totalEntities} | **Legacy:** ${s.legacyCount} | **Stale drafts:** ${s.staleDraftCount}`,
     "",
     "## Distribution",
     `- 70-100 (keep):    ${report.distribution["70-100"]}`,
@@ -28365,6 +28373,17 @@ function renderReport(report) {
     lines.push(`- No tags + no relations:              ${l.noGraphPresence}`);
     lines.push("");
   }
+  if (report.staleDrafts.length > 0) {
+    lines.push("## Stale Drafts (promote-or-drop candidates)");
+    lines.push("Filter: `tier=draft AND access=0 AND age>threshold`");
+    lines.push("| Age | Score | Title |");
+    lines.push("|-----|-------|-------|");
+    for (const a of report.staleDrafts.slice(0, 20)) {
+      const titleTrunc = a.title.length > 50 ? `${a.title.slice(0, 47)}...` : a.title;
+      lines.push(`| ${a.ageDays}d | ${a.score} | ${titleTrunc} |`);
+    }
+    lines.push("");
+  }
   if (report.lowest.length > 0) {
     lines.push("## Lowest-Scoring (top 10)");
     lines.push("| Score | Bucket | Tier | Age | Title | Reasons |");
@@ -30459,6 +30478,10 @@ var TOOLS = {
         limit: {
           type: "number",
           description: "Max number of entities to audit (default: 500). Paginated fetch."
+        },
+        staleDraftAgeDays: {
+          type: "number",
+          description: "Age threshold (days) for the stale-draft filter: flags drafts with 0 accesses older than this. Reported separately from bucket scoring — surfaces promote-or-drop candidates the thresholds miss. Default: 7."
         }
       },
       required: []
@@ -32038,7 +32061,8 @@ async function handleToolCall(name, args, deps) {
         dryRun: args.dryRun,
         archiveBelow: args.archiveBelow,
         deleteBelow: args.deleteBelow,
-        limit: args.limit
+        limit: args.limit,
+        staleDraftAgeDays: args.staleDraftAgeDays
       });
       return {
         success: report.success,
@@ -32048,6 +32072,7 @@ async function handleToolCall(name, args, deps) {
         legacyBreakdown: report.legacyBreakdown,
         actionsTaken: report.actionsTaken,
         lowest: report.lowest,
+        staleDrafts: report.staleDrafts,
         errors: report.errors,
         healthReport: report.healthReport
       };

package/dist/index.js

@@ -25847,7 +25847,7 @@ function isBoilerplate(title, content) {
   }
   return false;
 }
-function scoreEntity(entity, relationCount, archiveBelow, deleteBelow) {
+function scoreEntity(entity, relationCount, archiveBelow, deleteBelow, staleDraftAgeDays) {
   const now = Date.now();
   const ageDays = (now - Date.parse(entity.created_at)) / MS_PER_DAY;
   const effectiveLastAccess = entity.last_accessed_at ?? entity.created_at;
@@ -25932,6 +25932,7 @@ function scoreEntity(entity, relationCount, archiveBelow, deleteBelow) {
     bucket = "review";
   else
     bucket = "keep";
+  const staleDraft = entity.memory_tier === "draft" && (entity.access_count || 0) === 0 && ageDays > staleDraftAgeDays;
   return {
     id: entity.id,
     title: entity.title,
@@ -25943,6 +25944,7 @@ function scoreEntity(entity, relationCount, archiveBelow, deleteBelow) {
     reasons,
     legacy,
     legacyReasons,
+    staleDraft,
     subScores: {
       confidence: Math.round(confidence),
       decay: Math.round(decay),
@@ -25958,6 +25960,7 @@ async function runMemoryAudit(client3, workspaceId, projectId, options) {
   const archiveBelow = options?.archiveBelow ?? 40;
   const deleteBelow = options?.deleteBelow ?? 20;
   const limit = options?.limit ?? 500;
+  const staleDraftAgeDays = options?.staleDraftAgeDays ?? 7;
   const report = {
     success: true,
     dryRun,
@@ -25970,7 +25973,8 @@ async function runMemoryAudit(client3, workspaceId, projectId, options) {
       review: 0,
       archive: 0,
       delete: 0,
-      legacyCount: 0
+      legacyCount: 0,
+      staleDraftCount: 0
     },
     actionsTaken: { flaggedReview: 0, archived: 0, deleted: 0 },
     distribution: { "0-20": 0, "20-40": 0, "40-70": 0, "70-100": 0 },
@@ -25981,6 +25985,7 @@ async function runMemoryAudit(client3, workspaceId, projectId, options) {
       noGraphPresence: 0
     },
     lowest: [],
+    staleDrafts: [],
     errors: [],
     healthReport: ""
   };
@@ -26030,12 +26035,14 @@ async function runMemoryAudit(client3, workspaceId, projectId, options) {
   const audits = [];
   for (const entity of entities) {
     const relCount = relationCounts.get(entity.id) ?? 0;
-    const audit = scoreEntity(entity, relCount, archiveBelow, deleteBelow);
+    const audit = scoreEntity(entity, relCount, archiveBelow, deleteBelow, staleDraftAgeDays);
     audits.push(audit);
     report.summary.scanned++;
     report.summary[audit.bucket]++;
     if (audit.legacy)
       report.summary.legacyCount++;
+    if (audit.staleDraft)
+      report.summary.staleDraftCount++;
     if (audit.score < 20)
       report.distribution["0-20"]++;
     else if (audit.score < 40)
@@ -26056,6 +26063,7 @@ async function runMemoryAudit(client3, workspaceId, projectId, options) {
     }
   }
   report.lowest = [...audits].sort((a, b) => a.score - b.score).slice(0, 10);
+  report.staleDrafts = audits.filter((a) => a.staleDraft).sort((a, b) => b.ageDays - a.ageDays);
   if (!dryRun) {
     for (const audit of audits) {
       try {
@@ -26101,7 +26109,7 @@ function renderReport(report) {
   const lines = [
     `# Memory Quality Audit
 `,
-    `**Mode:** ${mode} | **Scanned:** ${s.scanned}/${s.totalEntities} | **Legacy:** ${s.legacyCount}`,
+    `**Mode:** ${mode} | **Scanned:** ${s.scanned}/${s.totalEntities} | **Legacy:** ${s.legacyCount} | **Stale drafts:** ${s.staleDraftCount}`,
     "",
     "## Distribution",
     `- 70-100 (keep):    ${report.distribution["70-100"]}`,
@@ -26125,6 +26133,17 @@ function renderReport(report) {
     lines.push(`- No tags + no relations:              ${l.noGraphPresence}`);
     lines.push("");
   }
+  if (report.staleDrafts.length > 0) {
+    lines.push("## Stale Drafts (promote-or-drop candidates)");
+    lines.push("Filter: `tier=draft AND access=0 AND age>threshold`");
+    lines.push("| Age | Score | Title |");
+    lines.push("|-----|-------|-------|");
+    for (const a of report.staleDrafts.slice(0, 20)) {
+      const titleTrunc = a.title.length > 50 ? `${a.title.slice(0, 47)}...` : a.title;
+      lines.push(`| ${a.ageDays}d | ${a.score} | ${titleTrunc} |`);
+    }
+    lines.push("");
+  }
   if (report.lowest.length > 0) {
     lines.push("## Lowest-Scoring (top 10)");
     lines.push("| Score | Bucket | Tier | Age | Title | Reasons |");
@@ -28219,6 +28238,10 @@ var TOOLS = {
         limit: {
           type: "number",
           description: "Max number of entities to audit (default: 500). Paginated fetch."
+        },
+        staleDraftAgeDays: {
+          type: "number",
+          description: "Age threshold (days) for the stale-draft filter: flags drafts with 0 accesses older than this. Reported separately from bucket scoring — surfaces promote-or-drop candidates the thresholds miss. Default: 7."
         }
       },
       required: []
@@ -29798,7 +29821,8 @@ async function handleToolCall(name, args, deps) {
         dryRun: args.dryRun,
         archiveBelow: args.archiveBelow,
         deleteBelow: args.deleteBelow,
-        limit: args.limit
+        limit: args.limit,
+        staleDraftAgeDays: args.staleDraftAgeDays
       });
       return {
         success: report.success,
@@ -29808,6 +29832,7 @@ async function handleToolCall(name, args, deps) {
         legacyBreakdown: report.legacyBreakdown,
         actionsTaken: report.actionsTaken,
         lowest: report.lowest,
+        staleDrafts: report.staleDrafts,
         errors: report.errors,
         healthReport: report.healthReport
       };

package/package.json

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

package/src/__tests__/memory-audit.test.ts

@@ -282,6 +282,96 @@ describe("runMemoryAudit", () => {
     ).toBe(0.25);
   });
 
+  test("stale-draft filter flags draft+0access+age>threshold separately from bucket", async () => {
+    const { client } = makeMockClient(
+      [
+        // Stale draft — should be flagged by the filter, but otherwise healthy
+        // enough to bucket as "review" (not archive).
+        {
+          id: "stale-draft",
+          type: "context",
+          title:
+            "Task transition: feature work started but never touched again",
+          content:
+            "This draft has enough content and tags to score reasonably, " +
+            "but nobody ever accessed it after creation — classic promote-or-drop candidate.",
+          confidence: 0.4,
+          memory_tier: "draft",
+          access_count: 0,
+          last_accessed_at: null,
+          created_at: daysAgo(10),
+          tags: ["task"],
+          embedding: [0.1],
+        },
+        // Fresh draft — same shape but under the age threshold, must NOT flag.
+        {
+          id: "fresh-draft",
+          type: "context",
+          title: "Task transition: a fresh draft still within the grace window",
+          content:
+            "Content long enough to not be thin at all, really properly sized.",
+          confidence: 0.4,
+          memory_tier: "draft",
+          access_count: 0,
+          last_accessed_at: null,
+          created_at: daysAgo(3),
+          tags: ["task"],
+          embedding: [0.1],
+        },
+        // Non-draft old zero-access — must NOT flag (filter is draft-only).
+        {
+          id: "old-episode",
+          type: "pattern",
+          title: "Episode entity that is old and unaccessed but not a draft",
+          content:
+            "Sometimes reference/episode tier entities sit unaccessed; " +
+            "they're not draft-promotion candidates so the filter should skip them.",
+          confidence: 0.8,
+          memory_tier: "episode",
+          access_count: 0,
+          last_accessed_at: null,
+          created_at: daysAgo(30),
+          tags: ["pat"],
+          embedding: [0.1],
+        },
+      ],
+      { "stale-draft": 1, "fresh-draft": 1, "old-episode": 2 },
+    );
+
+    const report = await runMemoryAudit(client, "ws-1");
+    expect(report.summary.staleDraftCount).toBe(1);
+    expect(report.staleDrafts).toHaveLength(1);
+    expect(report.staleDrafts[0].id).toBe("stale-draft");
+    expect(report.healthReport).toContain("Stale Drafts");
+  });
+
+  test("staleDraftAgeDays option tunes the filter threshold", async () => {
+    const { client } = makeMockClient([
+      {
+        id: "draft-5d",
+        type: "context",
+        title: "Five-day-old untouched draft",
+        content:
+          "Content long enough to pass the thin-content check, absolutely.",
+        confidence: 0.4,
+        memory_tier: "draft",
+        access_count: 0,
+        last_accessed_at: null,
+        created_at: daysAgo(5),
+        tags: ["x"],
+        embedding: [0.1],
+      },
+    ]);
+
+    const defaultRun = await runMemoryAudit(client, "ws-1");
+    expect(defaultRun.summary.staleDraftCount).toBe(0);
+
+    const tightRun = await runMemoryAudit(client, "ws-1", undefined, {
+      staleDraftAgeDays: 3,
+    });
+    expect(tightRun.summary.staleDraftCount).toBe(1);
+  });
+
   test("fetch error surfaces as report.success=false", async () => {
     const client = {
       listMemoryEntities: mock(async () => {

package/src/memory-audit.ts

@@ -46,6 +46,14 @@ export interface AuditOptions {
   deleteBelow?: number;
   includeLegacyFlag?: boolean;
   limit?: number;
+  /**
+   * Age threshold (days) for the stale-draft filter. A memory is flagged
+   * stale when `tier=draft AND access_count=0 AND age > staleDraftAgeDays`.
+   * Stale drafts are reported separately — they don't change scoring or
+   * bucketing, just surface promote-or-drop candidates the thresholds miss.
+   * Default: 7.
+   */
+  staleDraftAgeDays?: number;
 }
 
 interface EntityAudit {
@@ -59,6 +67,7 @@ interface EntityAudit {
   reasons: string[];
   legacy: boolean;
   legacyReasons: string[];
+  staleDraft: boolean;
   subScores: {
     confidence: number;
     decay: number;
@@ -82,6 +91,7 @@ export interface AuditReport {
     archive: number;
     delete: number;
     legacyCount: number;
+    staleDraftCount: number;
   };
   actionsTaken: {
     flaggedReview: number;
@@ -101,6 +111,7 @@ export interface AuditReport {
     noGraphPresence: number;
   };
   lowest: EntityAudit[];
+  staleDrafts: EntityAudit[];
   errors: Array<{ entityId?: string; step: string; message: string }>;
   healthReport: string;
 }
@@ -128,6 +139,7 @@ function scoreEntity(
   relationCount: number,
   archiveBelow: number,
   deleteBelow: number,
+  staleDraftAgeDays: number,
 ): EntityAudit {
   const now = Date.now();
   const ageDays = (now - Date.parse(entity.created_at)) / MS_PER_DAY;
@@ -232,6 +244,14 @@ function scoreEntity(
   else if (score < 70) bucket = "review";
   else bucket = "keep";
 
+  // Stale-draft filter — orthogonal to bucketing. A draft that's aged past
+  // the threshold without a single access is a promote-or-drop candidate
+  // regardless of its composite score.
+  const staleDraft =
+    entity.memory_tier === "draft" &&
+    (entity.access_count || 0) === 0 &&
+    ageDays > staleDraftAgeDays;
+
   return {
     id: entity.id,
     title: entity.title,
@@ -243,6 +263,7 @@ function scoreEntity(
     reasons,
     legacy,
     legacyReasons,
+    staleDraft,
     subScores: {
       confidence: Math.round(confidence),
       decay: Math.round(decay),
@@ -264,6 +285,7 @@ export async function runMemoryAudit(
   const archiveBelow = options?.archiveBelow ?? 40;
   const deleteBelow = options?.deleteBelow ?? 20;
   const limit = options?.limit ?? 500;
+  const staleDraftAgeDays = options?.staleDraftAgeDays ?? 7;
 
   const report: AuditReport = {
     success: true,
@@ -278,6 +300,7 @@ export async function runMemoryAudit(
       archive: 0,
       delete: 0,
       legacyCount: 0,
+      staleDraftCount: 0,
     },
     actionsTaken: { flaggedReview: 0, archived: 0, deleted: 0 },
     distribution: { "0-20": 0, "20-40": 0, "40-70": 0, "70-100": 0 },
@@ -288,6 +311,7 @@ export async function runMemoryAudit(
       noGraphPresence: 0,
     },
     lowest: [],
+    staleDrafts: [],
     errors: [],
     healthReport: "",
   };
@@ -345,11 +369,18 @@ export async function runMemoryAudit(
   const audits: EntityAudit[] = [];
   for (const entity of entities) {
     const relCount = relationCounts.get(entity.id) ?? 0;
-    const audit = scoreEntity(entity, relCount, archiveBelow, deleteBelow);
+    const audit = scoreEntity(
+      entity,
+      relCount,
+      archiveBelow,
+      deleteBelow,
+      staleDraftAgeDays,
+    );
     audits.push(audit);
     report.summary.scanned++;
     report.summary[audit.bucket]++;
     if (audit.legacy) report.summary.legacyCount++;
+    if (audit.staleDraft) report.summary.staleDraftCount++;
 
     // Distribution bin
     if (audit.score < 20) report.distribution["0-20"]++;
@@ -373,6 +404,11 @@ export async function runMemoryAudit(
   // Top 10 lowest-scoring
   report.lowest = [...audits].sort((a, b) => a.score - b.score).slice(0, 10);
 
+  // All stale drafts — oldest first (most overdue for promote-or-drop)
+  report.staleDrafts = audits
+    .filter((a) => a.staleDraft)
+    .sort((a, b) => b.ageDays - a.ageDays);
+
   // Execute actions
   if (!dryRun) {
     for (const audit of audits) {
@@ -420,7 +456,7 @@ function renderReport(report: AuditReport): string {
   const s = report.summary;
   const lines: string[] = [
     "# Memory Quality Audit\n",
-    `**Mode:** ${mode} | **Scanned:** ${s.scanned}/${s.totalEntities} | **Legacy:** ${s.legacyCount}`,
+    `**Mode:** ${mode} | **Scanned:** ${s.scanned}/${s.totalEntities} | **Legacy:** ${s.legacyCount} | **Stale drafts:** ${s.staleDraftCount}`,
     "",
     "## Distribution",
     `- 70-100 (keep):    ${report.distribution["70-100"]}`,
@@ -446,6 +482,19 @@ function renderReport(report: AuditReport): string {
     lines.push("");
   }
 
+  if (report.staleDrafts.length > 0) {
+    lines.push("## Stale Drafts (promote-or-drop candidates)");
+    lines.push("Filter: `tier=draft AND access=0 AND age>threshold`");
+    lines.push("| Age | Score | Title |");
+    lines.push("|-----|-------|-------|");
+    for (const a of report.staleDrafts.slice(0, 20)) {
+      const titleTrunc =
+        a.title.length > 50 ? `${a.title.slice(0, 47)}...` : a.title;
+      lines.push(`| ${a.ageDays}d | ${a.score} | ${titleTrunc} |`);
+    }
+    lines.push("");
+  }
+
   if (report.lowest.length > 0) {
     lines.push("## Lowest-Scoring (top 10)");
     lines.push("| Score | Bucket | Tier | Age | Title | Reasons |");

package/src/server.ts

@@ -1709,11 +1709,13 @@ const TOOLS = {
         },
         auditArchiveBelow: {
           type: "number",
-          description: "Audit: archive entities scoring below this (default: 40)",
+          description:
+            "Audit: archive entities scoring below this (default: 40)",
         },
         auditDeleteBelow: {
           type: "number",
-          description: "Audit: delete entities scoring below this (default: 20)",
+          description:
+            "Audit: delete entities scoring below this (default: 20)",
         },
       },
       required: [],
@@ -1753,6 +1755,11 @@ const TOOLS = {
           description:
             "Max number of entities to audit (default: 500). Paginated fetch.",
         },
+        staleDraftAgeDays: {
+          type: "number",
+          description:
+            "Age threshold (days) for the stale-draft filter: flags drafts with 0 accesses older than this. Reported separately from bucket scoring — surfaces promote-or-drop candidates the thresholds miss. Default: 7.",
+        },
       },
       required: [],
     },
@@ -4165,6 +4172,7 @@ async function handleToolCall(
         archiveBelow: args.archiveBelow as number | undefined,
         deleteBelow: args.deleteBelow as number | undefined,
         limit: args.limit as number | undefined,
+        staleDraftAgeDays: args.staleDraftAgeDays as number | undefined,
       });
 
       return {
@@ -4175,6 +4183,7 @@ async function handleToolCall(
         legacyBreakdown: report.legacyBreakdown,
         actionsTaken: report.actionsTaken,
         lowest: report.lowest,
+        staleDrafts: report.staleDrafts,
         errors: report.errors,
         healthReport: report.healthReport,
       };
@@ -4210,7 +4219,14 @@ async function handleToolCall(
       const report = await runMemoryCleanup(client, workspaceId, projectId, {
         dryRun: args.dryRun as boolean | undefined,
         steps: steps as
-          | ("prune" | "consolidate" | "orphans" | "duplicates" | "backfill" | "audit")[]
+          | (
+              | "prune"
+              | "consolidate"
+              | "orphans"
+              | "duplicates"
+              | "backfill"
+              | "audit"
+            )[]
           | undefined,
         maxAgeDays: args.maxAgeDays as number | undefined,
         minClusterSize: args.minClusterSize as number | undefined,