opencode-swarm 7.55.0 → 7.56.0

package/dist/cli/index.js

@@ -52,7 +52,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.55.0",
+    version: "7.56.0",
     description: "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
     main: "dist/index.js",
     types: "dist/index.d.ts",
@@ -36811,7 +36811,7 @@ function clusterEntries(entries) {
 function uniqueStrings(arr) {
   return [...new Set(arr.filter((s) => typeof s === "string" && s.length > 0))];
 }
-function renderSkillMarkdown(cluster, mode = "active") {
+function renderSkillMarkdown(cluster, mode = "active", generatedAt = new Date().toISOString()) {
   const description = cluster.title.length > 200 ? `${cluster.title.slice(0, 197)}\u2026` : cluster.title;
   const ids = cluster.entries.map((e) => `  - ${e.id}`).join(`
 `);
@@ -36821,6 +36821,9 @@ function renderSkillMarkdown(cluster, mode = "active") {
   lines.push(`description: ${escapeYaml(description)}`);
   lines.push("generated_from_knowledge:");
   lines.push(ids);
+  lines.push("source_knowledge_ids:");
+  lines.push(ids);
+  lines.push(`generated_at: ${generatedAt}`);
   lines.push(`confidence: ${cluster.avgConfidence.toFixed(2)}`);
   lines.push(`status: ${mode === "active" ? "active" : "draft"}`);
   lines.push("---");
@@ -37009,6 +37012,62 @@ async function stampSourceEntries(directory, slug, ids) {
   if (touchedHive)
     await rewriteKnowledge(hivePath, hive);
 }
+function parseDraftFrontmatter(content) {
+  const stripped = content.charCodeAt(0) === 65279 ? content.slice(1) : content;
+  const openFence = stripped.match(/^---[ \t]*\r?\n/);
+  if (!openFence)
+    return null;
+  const fenceLen = openFence[0].length;
+  const closeFence = stripped.slice(fenceLen).match(/\n---[ \t]*(\r?\n|$)/);
+  if (!closeFence)
+    return null;
+  const closeStart = fenceLen + (closeFence.index ?? 0);
+  const body = stripped.slice(fenceLen, closeStart).replace(/\r\n/g, `
+`);
+  const lines = body.split(`
+`);
+  const out = {
+    sourceKnowledgeIds: []
+  };
+  let inLegacyIdsList = false;
+  let inSourceIdsList = false;
+  for (const raw of lines) {
+    const line = raw;
+    if (inLegacyIdsList || inSourceIdsList) {
+      const m = line.match(/^\s+-\s+(\S{1,64})\s*$/);
+      if (m) {
+        out.sourceKnowledgeIds.push(m[1]);
+        continue;
+      }
+      inLegacyIdsList = false;
+      inSourceIdsList = false;
+    }
+    const nm = line.match(/^name:\s*(\S+)\s*$/);
+    if (nm) {
+      out.name = nm[1];
+      continue;
+    }
+    const st = line.match(/^status:\s*(\S+)\s*$/);
+    if (st) {
+      out.status = st[1];
+      continue;
+    }
+    const ga = line.match(/^generated_at:\s*(\S+)\s*$/);
+    if (ga) {
+      out.generatedAt = ga[1];
+      continue;
+    }
+    if (/^generated_from_knowledge:\s*$/.test(line)) {
+      inLegacyIdsList = true;
+      continue;
+    }
+    if (/^source_knowledge_ids:\s*$/.test(line)) {
+      out.sourceKnowledgeIds = [];
+      inSourceIdsList = true;
+    }
+  }
+  return out;
+}
 async function listSkills(directory) {
   const result = {
     proposals: [],
@@ -38338,7 +38397,7 @@ var init_skill_improver_quota = __esm(() => {
 
 // src/services/skill-improver.ts
 import { existsSync as existsSync12 } from "fs";
-import { mkdir as mkdir7, rename as rename5, writeFile as writeFile6 } from "fs/promises";
+import { mkdir as mkdir7, readFile as readFile7, rename as rename5, writeFile as writeFile6 } from "fs/promises";
 import * as path18 from "path";
 function timestampSlug(d) {
   return d.toISOString().replace(/[:.]/g, "-");
@@ -38355,15 +38414,63 @@ async function gatherInventory(directory) {
   const hive = existsSync12(hivePath) ? await readKnowledge(hivePath) : [];
   const archived = [...swarm, ...hive].filter((e) => e.status === "archived").length;
   const skills = await listSkills(directory);
+  const knowledgeById = new Map([...swarm, ...hive].map((entry) => [entry.id, entry]));
+  const staleActiveSkills = [];
+  let metadataReadable = 0;
+  for (const skill of skills.active) {
+    let content;
+    try {
+      content = await readFile7(skill.path, "utf-8");
+    } catch {
+      continue;
+    }
+    const fm = parseDraftFrontmatter(content);
+    if (!fm)
+      continue;
+    metadataReadable += 1;
+    const reasons = [];
+    if (fm.sourceKnowledgeIds.length === 0) {
+      reasons.push("missing_source_knowledge_ids");
+    }
+    if (!fm.generatedAt) {
+      reasons.push("missing_generated_at");
+    } else {
+      const generatedAtMs = Date.parse(fm.generatedAt);
+      if (!Number.isFinite(generatedAtMs)) {
+        reasons.push("invalid_generated_at");
+      } else {
+        for (const id of fm.sourceKnowledgeIds) {
+          const source = knowledgeById.get(id);
+          if (!source) {
+            reasons.push(`missing_source:${id}`);
+            continue;
+          }
+          const updatedAtMs = Date.parse(source.updated_at);
+          if (Number.isFinite(updatedAtMs) && updatedAtMs > generatedAtMs) {
+            reasons.push(`updated_after_generation:${id}`);
+          }
+        }
+      }
+    }
+    if (reasons.length > 0) {
+      staleActiveSkills.push({
+        slug: skill.slug,
+        reasons: reasons.slice(0, 6)
+      });
+    }
+  }
   const matureCandidates = swarm.concat(hive).filter((e) => e.status !== "archived" && e.confidence >= 0.85 && !e.generated_skill_slug && (e.confirmed_by ?? []).length >= 2);
   return {
     knowledge: { swarm: swarm.length, hive: hive.length, archived },
     skills: {
       proposals: skills.proposals.length,
-      active: skills.active.length
+      active: skills.active.length,
+      stale: staleActiveSkills.length,
+      metadataReadable
     },
     highConfidenceClusters: matureCandidates.length,
-    matureCandidates
+    matureCandidates,
+    staleActiveSkills
   };
 }
 function buildSystemPrompt(targets, cfg) {
@@ -38387,10 +38494,16 @@ hive_entries: ${inv.knowledge.hive}
 archived: ${inv.knowledge.archived}
 draft_skills: ${inv.skills.proposals}
 active_skills: ${inv.skills.active}
+active_skills_with_readable_metadata: ${inv.skills.metadataReadable}
+stale_active_skills: ${inv.skills.stale}
 mature_uncompiled_clusters: ${inv.highConfidenceClusters}
 
 TOP MATURE CANDIDATES (first 25):
 ${matureRows || "(none)"}
+
+STALE ACTIVE SKILLS (first 10):
+${inv.staleActiveSkills.slice(0, 10).map((s) => `- ${s.slug} | ${s.reasons.join(", ")}`).join(`
+`) || "(none)"}
 `;
 }
 function isAbortError(err) {
@@ -38419,7 +38532,11 @@ function buildDeterministicProposal(args) {
   lines.push("## Inventory snapshot");
   lines.push(`- Knowledge entries: swarm=${args.inventory.knowledge.swarm}, hive=${args.inventory.knowledge.hive}, archived=${args.inventory.knowledge.archived}`);
   lines.push(`- Generated skills: proposals=${args.inventory.skills.proposals}, active=${args.inventory.skills.active}`);
+  lines.push(`- Active skills with readable metadata: ${args.inventory.skills.metadataReadable} (stale=${args.inventory.skills.stale})`);
   lines.push(`- High-confidence un-skill'd clusters: ${args.inventory.highConfidenceClusters}`);
+  if (args.inventory.staleActiveSkills.length > 0) {
+    lines.push(`- Stale active skills: ${args.inventory.staleActiveSkills.map((s) => s.slug).join(", ")}`);
+  }
   lines.push("");
   lines.push("## Recommendations");
   if (args.inventory.highConfidenceClusters > 0) {
@@ -39914,7 +40031,7 @@ var init_curate = __esm(() => {
 // src/tools/co-change-analyzer.ts
 import * as child_process3 from "child_process";
 import { randomUUID as randomUUID2 } from "crypto";
-import { readdir, readFile as readFile7, stat as stat2 } from "fs/promises";
+import { readdir, readFile as readFile8, stat as stat2 } from "fs/promises";
 import * as path21 from "path";
 import { promisify } from "util";
 function getExecFileAsync() {
@@ -40041,7 +40158,7 @@ async function getStaticEdges(directory) {
   const sourceFiles = await scanSourceFiles(directory);
   for (const sourceFile of sourceFiles) {
     try {
-      const content = await readFile7(sourceFile, "utf-8");
+      const content = await readFile8(sourceFile, "utf-8");
       const importRegex = /(?:import|require)\s*(?:\(?\s*['"`]|.*?from\s+['"`])([^'"`]+)['"`]/g;
       for (let match = importRegex.exec(content);match !== null; match = importRegex.exec(content)) {
         const importPath = match[1].trim();
@@ -40825,11 +40942,11 @@ var init_version_check = __esm(() => {
 
 // src/services/knowledge-diagnostics.ts
 import { existsSync as existsSync14 } from "fs";
-import { readFile as readFile8 } from "fs/promises";
+import { readFile as readFile9 } from "fs/promises";
 async function readRawLines(filePath) {
   if (!existsSync14(filePath))
     return { entries: [], corrupt: 0 };
-  const content = await readFile8(filePath, "utf-8");
+  const content = await readFile9(filePath, "utf-8");
   const entries = [];
   let corrupt = 0;
   for (const line of content.split(`
@@ -46049,7 +46166,7 @@ var KNOWLEDGE_SCHEMA_VERSION = 2;
 // src/hooks/knowledge-migrator.ts
 import { randomUUID as randomUUID3 } from "crypto";
 import { existsSync as existsSync19, readFileSync as readFileSync13 } from "fs";
-import { mkdir as mkdir8, readFile as readFile9, writeFile as writeFile7 } from "fs/promises";
+import { mkdir as mkdir8, readFile as readFile10, writeFile as writeFile7 } from "fs/promises";
 import * as path29 from "path";
 async function migrateKnowledgeToExternal(_directory, _config) {
   return {
@@ -46082,7 +46199,7 @@ async function migrateContextToKnowledge(directory, config3) {
       skippedReason: "no-context-file"
     };
   }
-  const contextContent = await readFile9(contextPath, "utf-8");
+  const contextContent = await readFile10(contextPath, "utf-8");
   if (contextContent.trim().length === 0) {
     return {
       migrated: false,
@@ -47331,7 +47448,7 @@ import { existsSync as existsSync20 } from "fs";
 import {
   appendFile as appendFile5,
   mkdir as mkdir9,
-  readFile as readFile10,
+  readFile as readFile11,
   rename as rename6,
   writeFile as writeFile8
 } from "fs/promises";
@@ -47680,7 +47797,7 @@ function validateLoadedProposals(values, config3) {
 async function readJsonl(filePath) {
   if (!existsSync20(filePath))
     return [];
-  const content = await readFile10(filePath, "utf-8");
+  const content = await readFile11(filePath, "utf-8");
   const records = [];
   for (const line of content.split(`
 `)) {
@@ -47765,7 +47882,7 @@ var init_prompt_block = __esm(() => {
 
 // src/memory/jsonl-migration.ts
 import { existsSync as existsSync21 } from "fs";
-import { copyFile, mkdir as mkdir10, readFile as readFile11, stat as stat3, writeFile as writeFile9 } from "fs/promises";
+import { copyFile, mkdir as mkdir10, readFile as readFile12, stat as stat3, writeFile as writeFile9 } from "fs/promises";
 import * as path31 from "path";
 function resolveMemoryStorageDir(rootDirectory, config3 = {}) {
   const resolved = resolveConfig(config3);
@@ -47829,7 +47946,7 @@ async function readMigrationReport(rootDirectory, config3 = {}) {
   if (!existsSync21(reportPath))
     return null;
   try {
-    return JSON.parse(await readFile11(reportPath, "utf-8"));
+    return JSON.parse(await readFile12(reportPath, "utf-8"));
   } catch {
     return null;
   }
@@ -47930,7 +48047,7 @@ async function readJsonlRows(filePath) {
   if (!existsSync21(filePath)) {
     return { rows: [], invalidRows: [], totalRows: 0 };
   }
-  const content = await readFile11(filePath, "utf-8");
+  const content = await readFile12(filePath, "utf-8");
   const rows = [];
   const invalidRows = [];
   let totalRows = 0;

package/dist/index.js

@@ -69,7 +69,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.55.0",
+    version: "7.56.0",
     description: "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
     main: "dist/index.js",
     types: "dist/index.d.ts",
@@ -57856,7 +57856,7 @@ function clusterEntries(entries) {
 function uniqueStrings(arr) {
   return [...new Set(arr.filter((s) => typeof s === "string" && s.length > 0))];
 }
-function renderSkillMarkdown(cluster, mode = "active") {
+function renderSkillMarkdown(cluster, mode = "active", generatedAt = new Date().toISOString()) {
   const description = cluster.title.length > 200 ? `${cluster.title.slice(0, 197)}…` : cluster.title;
   const ids = cluster.entries.map((e) => `  - ${e.id}`).join(`
 `);
@@ -57866,6 +57866,9 @@ function renderSkillMarkdown(cluster, mode = "active") {
   lines.push(`description: ${escapeYaml(description)}`);
   lines.push("generated_from_knowledge:");
   lines.push(ids);
+  lines.push("source_knowledge_ids:");
+  lines.push(ids);
+  lines.push(`generated_at: ${generatedAt}`);
   lines.push(`confidence: ${cluster.avgConfidence.toFixed(2)}`);
   lines.push(`status: ${mode === "active" ? "active" : "draft"}`);
   lines.push("---");
@@ -58071,16 +58074,18 @@ function parseDraftFrontmatter(content) {
   const out2 = {
     sourceKnowledgeIds: []
   };
-  let inIdsList = false;
+  let inLegacyIdsList = false;
+  let inSourceIdsList = false;
   for (const raw of lines) {
     const line = raw;
-    if (inIdsList) {
+    if (inLegacyIdsList || inSourceIdsList) {
       const m = line.match(/^\s+-\s+(\S{1,64})\s*$/);
       if (m) {
         out2.sourceKnowledgeIds.push(m[1]);
         continue;
       }
-      inIdsList = false;
+      inLegacyIdsList = false;
+      inSourceIdsList = false;
     }
     const nm = line.match(/^name:\s*(\S+)\s*$/);
     if (nm) {
@@ -58092,8 +58097,18 @@ function parseDraftFrontmatter(content) {
       out2.status = st[1];
       continue;
     }
+    const ga = line.match(/^generated_at:\s*(\S+)\s*$/);
+    if (ga) {
+      out2.generatedAt = ga[1];
+      continue;
+    }
     if (/^generated_from_knowledge:\s*$/.test(line)) {
-      inIdsList = true;
+      inLegacyIdsList = true;
+      continue;
+    }
+    if (/^source_knowledge_ids:\s*$/.test(line)) {
+      out2.sourceKnowledgeIds = [];
+      inSourceIdsList = true;
     }
   }
   return out2;
@@ -60763,7 +60778,7 @@ var init_skill_improver_quota = __esm(() => {
 
 // src/services/skill-improver.ts
 import { existsSync as existsSync18 } from "node:fs";
-import { mkdir as mkdir8, rename as rename5, writeFile as writeFile6 } from "node:fs/promises";
+import { mkdir as mkdir8, readFile as readFile9, rename as rename5, writeFile as writeFile6 } from "node:fs/promises";
 import * as path31 from "node:path";
 function timestampSlug(d) {
   return d.toISOString().replace(/[:.]/g, "-");
@@ -60780,15 +60795,63 @@ async function gatherInventory(directory) {
   const hive = existsSync18(hivePath) ? await readKnowledge(hivePath) : [];
   const archived = [...swarm, ...hive].filter((e) => e.status === "archived").length;
   const skills = await listSkills(directory);
+  const knowledgeById = new Map([...swarm, ...hive].map((entry) => [entry.id, entry]));
+  const staleActiveSkills = [];
+  let metadataReadable = 0;
+  for (const skill of skills.active) {
+    let content;
+    try {
+      content = await readFile9(skill.path, "utf-8");
+    } catch {
+      continue;
+    }
+    const fm = parseDraftFrontmatter(content);
+    if (!fm)
+      continue;
+    metadataReadable += 1;
+    const reasons = [];
+    if (fm.sourceKnowledgeIds.length === 0) {
+      reasons.push("missing_source_knowledge_ids");
+    }
+    if (!fm.generatedAt) {
+      reasons.push("missing_generated_at");
+    } else {
+      const generatedAtMs = Date.parse(fm.generatedAt);
+      if (!Number.isFinite(generatedAtMs)) {
+        reasons.push("invalid_generated_at");
+      } else {
+        for (const id of fm.sourceKnowledgeIds) {
+          const source = knowledgeById.get(id);
+          if (!source) {
+            reasons.push(`missing_source:${id}`);
+            continue;
+          }
+          const updatedAtMs = Date.parse(source.updated_at);
+          if (Number.isFinite(updatedAtMs) && updatedAtMs > generatedAtMs) {
+            reasons.push(`updated_after_generation:${id}`);
+          }
+        }
+      }
+    }
+    if (reasons.length > 0) {
+      staleActiveSkills.push({
+        slug: skill.slug,
+        reasons: reasons.slice(0, 6)
+      });
+    }
+  }
   const matureCandidates = swarm.concat(hive).filter((e) => e.status !== "archived" && e.confidence >= 0.85 && !e.generated_skill_slug && (e.confirmed_by ?? []).length >= 2);
   return {
     knowledge: { swarm: swarm.length, hive: hive.length, archived },
     skills: {
       proposals: skills.proposals.length,
-      active: skills.active.length
+      active: skills.active.length,
+      stale: staleActiveSkills.length,
+      metadataReadable
     },
     highConfidenceClusters: matureCandidates.length,
-    matureCandidates
+    matureCandidates,
+    staleActiveSkills
   };
 }
 function buildSystemPrompt(targets, cfg) {
@@ -60812,10 +60875,16 @@ hive_entries: ${inv.knowledge.hive}
 archived: ${inv.knowledge.archived}
 draft_skills: ${inv.skills.proposals}
 active_skills: ${inv.skills.active}
+active_skills_with_readable_metadata: ${inv.skills.metadataReadable}
+stale_active_skills: ${inv.skills.stale}
 mature_uncompiled_clusters: ${inv.highConfidenceClusters}
 
 TOP MATURE CANDIDATES (first 25):
 ${matureRows || "(none)"}
+
+STALE ACTIVE SKILLS (first 10):
+${inv.staleActiveSkills.slice(0, 10).map((s) => `- ${s.slug} | ${s.reasons.join(", ")}`).join(`
+`) || "(none)"}
 `;
 }
 function isAbortError(err2) {
@@ -60844,7 +60913,11 @@ function buildDeterministicProposal(args2) {
   lines.push("## Inventory snapshot");
   lines.push(`- Knowledge entries: swarm=${args2.inventory.knowledge.swarm}, hive=${args2.inventory.knowledge.hive}, archived=${args2.inventory.knowledge.archived}`);
   lines.push(`- Generated skills: proposals=${args2.inventory.skills.proposals}, active=${args2.inventory.skills.active}`);
+  lines.push(`- Active skills with readable metadata: ${args2.inventory.skills.metadataReadable} (stale=${args2.inventory.skills.stale})`);
   lines.push(`- High-confidence un-skill'd clusters: ${args2.inventory.highConfidenceClusters}`);
+  if (args2.inventory.staleActiveSkills.length > 0) {
+    lines.push(`- Stale active skills: ${args2.inventory.staleActiveSkills.map((s) => s.slug).join(", ")}`);
+  }
   lines.push("");
   lines.push("## Recommendations");
   if (args2.inventory.highConfidenceClusters > 0) {
@@ -62350,7 +62423,7 @@ __export(exports_co_change_analyzer, {
 });
 import * as child_process3 from "node:child_process";
 import { randomUUID as randomUUID5 } from "node:crypto";
-import { readdir as readdir2, readFile as readFile9, stat as stat3 } from "node:fs/promises";
+import { readdir as readdir2, readFile as readFile10, stat as stat3 } from "node:fs/promises";
 import * as path34 from "node:path";
 import { promisify } from "node:util";
 function getExecFileAsync() {
@@ -62477,7 +62550,7 @@ async function getStaticEdges(directory) {
   const sourceFiles = await scanSourceFiles(directory);
   for (const sourceFile of sourceFiles) {
     try {
-      const content = await readFile9(sourceFile, "utf-8");
+      const content = await readFile10(sourceFile, "utf-8");
       const importRegex = /(?:import|require)\s*(?:\(?\s*['"`]|.*?from\s+['"`])([^'"`]+)['"`]/g;
       for (let match = importRegex.exec(content);match !== null; match = importRegex.exec(content)) {
         const importPath = match[1].trim();
@@ -63239,11 +63312,11 @@ var init_version_check = __esm(() => {
 
 // src/services/knowledge-diagnostics.ts
 import { existsSync as existsSync20 } from "node:fs";
-import { readFile as readFile10 } from "node:fs/promises";
+import { readFile as readFile11 } from "node:fs/promises";
 async function readRawLines(filePath) {
   if (!existsSync20(filePath))
     return { entries: [], corrupt: 0 };
-  const content = await readFile10(filePath, "utf-8");
+  const content = await readFile11(filePath, "utf-8");
   const entries = [];
   let corrupt = 0;
   for (const line of content.split(`
@@ -68601,7 +68674,7 @@ var KNOWLEDGE_SCHEMA_VERSION = 2;
 // src/hooks/knowledge-migrator.ts
 import { randomUUID as randomUUID6 } from "node:crypto";
 import { existsSync as existsSync25, readFileSync as readFileSync14 } from "node:fs";
-import { mkdir as mkdir9, readFile as readFile11, writeFile as writeFile7 } from "node:fs/promises";
+import { mkdir as mkdir9, readFile as readFile12, writeFile as writeFile7 } from "node:fs/promises";
 import * as path42 from "node:path";
 async function migrateKnowledgeToExternal(_directory, _config) {
   return {
@@ -68634,7 +68707,7 @@ async function migrateContextToKnowledge(directory, config3) {
       skippedReason: "no-context-file"
     };
   }
-  const contextContent = await readFile11(contextPath, "utf-8");
+  const contextContent = await readFile12(contextPath, "utf-8");
   if (contextContent.trim().length === 0) {
     return {
       migrated: false,
@@ -69912,7 +69985,7 @@ import { existsSync as existsSync26 } from "node:fs";
 import {
   appendFile as appendFile6,
   mkdir as mkdir10,
-  readFile as readFile12,
+  readFile as readFile13,
   rename as rename6,
   writeFile as writeFile8
 } from "node:fs/promises";
@@ -70261,7 +70334,7 @@ function validateLoadedProposals(values, config3) {
 async function readJsonl(filePath) {
   if (!existsSync26(filePath))
     return [];
-  const content = await readFile12(filePath, "utf-8");
+  const content = await readFile13(filePath, "utf-8");
   const records = [];
   for (const line of content.split(`
 `)) {
@@ -70420,7 +70493,7 @@ var init_prompt_block = __esm(() => {
 
 // src/memory/jsonl-migration.ts
 import { existsSync as existsSync27 } from "node:fs";
-import { copyFile, mkdir as mkdir11, readFile as readFile13, stat as stat4, writeFile as writeFile9 } from "node:fs/promises";
+import { copyFile, mkdir as mkdir11, readFile as readFile14, stat as stat4, writeFile as writeFile9 } from "node:fs/promises";
 import * as path44 from "node:path";
 function resolveMemoryStorageDir(rootDirectory, config3 = {}) {
   const resolved = resolveConfig(config3);
@@ -70484,7 +70557,7 @@ async function readMigrationReport(rootDirectory, config3 = {}) {
   if (!existsSync27(reportPath))
     return null;
   try {
-    return JSON.parse(await readFile13(reportPath, "utf-8"));
+    return JSON.parse(await readFile14(reportPath, "utf-8"));
   } catch {
     return null;
   }
@@ -70585,7 +70658,7 @@ async function readJsonlRows(filePath) {
   if (!existsSync27(filePath)) {
     return { rows: [], invalidRows: [], totalRows: 0 };
   }
-  const content = await readFile13(filePath, "utf-8");
+  const content = await readFile14(filePath, "utf-8");
   const rows = [];
   const invalidRows = [];
   let totalRows = 0;
@@ -91719,7 +91792,7 @@ import * as fs65 from "node:fs";
 import {
   mkdir as mkdir16,
   readdir as readdir6,
-  readFile as readFile16,
+  readFile as readFile17,
   realpath as realpath3,
   stat as stat7,
   writeFile as writeFile12
@@ -91797,7 +91870,7 @@ async function scanDocIndex(directory) {
   ];
   const allPatterns = [...defaultPatterns, ...extraPatterns];
   try {
-    const manifestContent = await readFile16(manifestPath, "utf-8");
+    const manifestContent = await readFile17(manifestPath, "utf-8");
     const existingManifest = JSON.parse(manifestContent);
     if (existingManifest.schema_version === 1 && existingManifest.files) {
       let cacheValid = true;
@@ -91878,7 +91951,7 @@ async function scanDocIndex(directory) {
       }
       let content;
       try {
-        content = await readFile16(fullPath, "utf-8");
+        content = await readFile17(fullPath, "utf-8");
       } catch {
         continue;
       }
@@ -91961,7 +92034,7 @@ async function extractDocConstraints(directory, taskFiles, taskDescription) {
   const manifestPath = path102.join(directory, ".swarm", "doc-manifest.json");
   let manifest;
   try {
-    const content = await readFile16(manifestPath, "utf-8");
+    const content = await readFile17(manifestPath, "utf-8");
     manifest = JSON.parse(content);
   } catch {
     const result = await scanDocIndex(directory);
@@ -91984,7 +92057,7 @@ async function extractDocConstraints(directory, taskFiles, taskDescription) {
     }
     let fullContent;
     try {
-      fullContent = await readFile16(path102.join(directory, docFile.path), "utf-8");
+      fullContent = await readFile17(path102.join(directory, docFile.path), "utf-8");
     } catch {
       skippedCount++;
       continue;
@@ -92134,7 +92207,7 @@ var init_doc_scan = __esm(() => {
 
 // src/hooks/knowledge-reader.ts
 import { existsSync as existsSync57 } from "node:fs";
-import { readFile as readFile17 } from "node:fs/promises";
+import { readFile as readFile18 } from "node:fs/promises";
 import * as path103 from "node:path";
 function inferCategoriesFromPhase(phaseDescription) {
   const lower = phaseDescription.toLowerCase();
@@ -92184,7 +92257,7 @@ async function transactShownFile(shownFile, mutate) {
     if (!existsSync57(filePath))
       return {};
     try {
-      const content = await readFile17(filePath, "utf-8");
+      const content = await readFile18(filePath, "utf-8");
       return JSON.parse(content);
     } catch {
       return {};
@@ -92311,7 +92384,7 @@ async function updateRetrievalOutcome(directory, phaseInfo, phaseSucceeded) {
     }
     let shownIds;
     try {
-      const content = await readFile17(shownFile, "utf-8");
+      const content = await readFile18(shownFile, "utf-8");
       const shownData = JSON.parse(content);
       shownIds = shownData[phaseInfo];
     } catch {
@@ -104427,7 +104500,7 @@ init_logger();
 init_knowledge_store();
 var import_proper_lockfile8 = __toESM(require_proper_lockfile(), 1);
 import { existsSync as existsSync61 } from "node:fs";
-import { appendFile as appendFile9, mkdir as mkdir17, readFile as readFile18 } from "node:fs/promises";
+import { appendFile as appendFile9, mkdir as mkdir17, readFile as readFile19 } from "node:fs/promises";
 import * as path107 from "node:path";
 function resolveApplicationLogPath(directory) {
   return path107.join(directory, ".swarm", "knowledge-application.jsonl");

package/dist/services/skill-generator.d.ts

@@ -42,7 +42,7 @@ export declare function selectCandidateEntries(directory: string, opts: Candidat
  */
 declare function jaccardSimilarity(setA: string[], setB: string[]): number;
 export declare function clusterEntries(entries: KnowledgeEntryBase[]): KnowledgeCluster[];
-export declare function renderSkillMarkdown(cluster: KnowledgeCluster, mode?: GenerateMode): string;
+export declare function renderSkillMarkdown(cluster: KnowledgeCluster, mode?: GenerateMode, generatedAt?: string): string;
 export type GenerateMode = 'draft' | 'active';
 export interface GenerateRequest {
     directory: string;
@@ -84,6 +84,7 @@ declare function stampSourceEntries(directory: string, slug: string, ids: string
 export declare function parseDraftFrontmatter(content: string): {
     name?: string;
     status?: string;
+    generatedAt?: string;
     sourceKnowledgeIds: string[];
 } | null;
 export declare function activateProposal(directory: string, slug: string, force?: boolean): Promise<{

package/dist/services/skill-improver.d.ts

@@ -72,9 +72,15 @@ interface InventorySnapshot {
     skills: {
         proposals: number;
         active: number;
+        stale: number;
+        metadataReadable: number;
     };
     highConfidenceClusters: number;
     matureCandidates: SwarmKnowledgeEntry[];
+    staleActiveSkills: Array<{
+        slug: string;
+        reasons: string[];
+    }>;
 }
 declare function gatherInventory(directory: string): Promise<InventorySnapshot>;
 declare function buildSystemPrompt(targets: SkillImproverTarget[], cfg: SkillImproverConfigInput): string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.55.0",
+	"version": "7.56.0",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",