opencode-swarm 7.93.1 → 7.94.1

package/dist/cli/{index-ne4g3mk1.js → index-dgjsa6hy.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   stripKnownSwarmPrefix
-} from "./index-xsbtbffr.js";
+} from "./index-79dcqsg9.js";
 import {
   init_logger,
   warn

package/dist/cli/{index-5hrexm02.js → index-fjxjb66n.js}

@@ -10,7 +10,7 @@ import {
   resolveSwarmRejectedPath,
   rewriteKnowledge,
   transactKnowledge
-} from "./index-w7gkpmq8.js";
+} from "./index-hb10a2g8.js";
 import {
   atomicWriteFile
 } from "./index-kv4dd5c5.js";
@@ -28,7 +28,7 @@ import {
 
 // src/services/skill-generator.ts
 import { existsSync as existsSync3, unlinkSync } from "fs";
-import { mkdir as mkdir5, readFile as readFile4, rename as rename2, writeFile as writeFile3 } from "fs/promises";
+import { mkdir as mkdir5, readFile as readFile4, rename as rename2, unlink, writeFile as writeFile3 } from "fs/promises";
 import * as path5 from "path";
 
 // src/hooks/knowledge-events.ts
@@ -2045,10 +2045,81 @@ async function activateProposal(directory, slug, force = false, options = {}) {
     };
   }
 }
+async function findSkillsBySourceKnowledgeId(directory, sourceId) {
+  const activeDir = path5.join(directory, ".opencode", "skills", "generated");
+  const fs = await import("fs/promises");
+  if (!existsSync3(activeDir))
+    return [];
+  const entries = await fs.readdir(activeDir, { withFileTypes: true });
+  const matches = [];
+  for (const e of entries) {
+    if (!e.isDirectory())
+      continue;
+    const skillDir = path5.join(activeDir, e.name);
+    const retiredMarker = path5.join(skillDir, "retired.marker");
+    if (existsSync3(retiredMarker))
+      continue;
+    const staleMarker = path5.join(skillDir, "stale.marker");
+    if (existsSync3(staleMarker))
+      continue;
+    const skillPath = path5.join(skillDir, "SKILL.md");
+    if (!existsSync3(skillPath))
+      continue;
+    let content;
+    try {
+      content = await fs.readFile(skillPath, "utf-8");
+    } catch {
+      continue;
+    }
+    const fm = parseDraftFrontmatter(content);
+    if (fm?.sourceKnowledgeIds.includes(sourceId)) {
+      matches.push(skillDir);
+    }
+  }
+  return matches;
+}
+async function findStaleSkillsBySourceKnowledgeId(directory, archivedIds) {
+  const activeDir = path5.join(directory, ".opencode", "skills", "generated");
+  if (!existsSync3(activeDir))
+    return [];
+  const fs = await import("fs/promises");
+  const entries = await fs.readdir(activeDir, { withFileTypes: true });
+  const matches = [];
+  for (const e of entries) {
+    if (!e.isDirectory())
+      continue;
+    const skillDir = path5.join(activeDir, e.name);
+    const retiredMarker = path5.join(skillDir, "retired.marker");
+    if (existsSync3(retiredMarker))
+      continue;
+    const staleMarker = path5.join(skillDir, "stale.marker");
+    if (!existsSync3(staleMarker))
+      continue;
+    const skillPath = path5.join(skillDir, "SKILL.md");
+    if (!existsSync3(skillPath))
+      continue;
+    let content;
+    try {
+      content = await fs.readFile(skillPath, "utf-8");
+    } catch {
+      continue;
+    }
+    const fm = parseDraftFrontmatter(content);
+    const sourceIds = fm?.sourceKnowledgeIds ?? [];
+    if (sourceIds.length === 0)
+      continue;
+    const allArchived = sourceIds.every((id) => archivedIds.has(id));
+    if (allArchived) {
+      matches.push(skillDir);
+    }
+  }
+  return matches;
+}
 async function listSkills(directory) {
   const result = {
     proposals: [],
-    active: []
+    active: [],
+    stale: []
   };
   const proposalsDir = path5.join(directory, ".swarm", "skills", "proposals");
   const activeDir = path5.join(directory, ".opencode", "skills", "generated");
@@ -2073,6 +2144,16 @@ async function listSkills(directory) {
       const retiredMarker = path5.join(activeDir, e.name, "retired.marker");
       if (existsSync3(retiredMarker))
         continue;
+      const staleMarker = path5.join(activeDir, e.name, "stale.marker");
+      if (existsSync3(staleMarker)) {
+        let reason = "stale";
+        try {
+          const content = await fs.readFile(staleMarker, "utf-8");
+          reason = content.trim() || "stale";
+        } catch {}
+        result.stale.push({ slug: e.name, reason });
+        continue;
+      }
       const skillPath = path5.join(activeDir, e.name, "SKILL.md");
       if (existsSync3(skillPath)) {
         result.active.push({
@@ -2159,7 +2240,34 @@ async function inspectSkill(directory, slug, prefer = "auto") {
   for (const c of candidates) {
     if (existsSync3(c.p)) {
       const content = await readFile4(c.p, "utf-8");
-      return { found: true, path: c.p, content, mode: c.m };
+      const result = { found: true, path: c.p, content, mode: c.m };
+      const fm = parseDraftFrontmatter(content);
+      if (fm && fm.sourceKnowledgeIds.length > 0) {
+        const swarm = await readKnowledge(resolveSwarmKnowledgePath(directory));
+        const hivePath = resolveHiveKnowledgePath();
+        const hive = existsSync3(hivePath) ? await readKnowledge(hivePath) : [];
+        const allEntries = [...swarm, ...hive];
+        const entryMap = new Map(allEntries.map((e) => [e.id, e]));
+        result.source_knowledge_status = fm.sourceKnowledgeIds.map((id) => {
+          const entry = entryMap.get(id);
+          if (!entry)
+            return { id, status: "deleted" };
+          if (entry.status === "archived" || entry.status === "quarantined") {
+            return { id, status: "archived" };
+          }
+          return { id, status: "active" };
+        });
+      }
+      if (c.m === "active") {
+        const skillDir = path5.join(directory, ".opencode", "skills", "generated", cleanSlug);
+        const staleMarker = path5.join(skillDir, "stale.marker");
+        if (existsSync3(staleMarker)) {
+          try {
+            result.stale_reason = await readFile4(staleMarker, "utf-8");
+          } catch {}
+        }
+      }
+      return result;
     }
   }
   return { found: false };
@@ -2198,6 +2306,54 @@ async function retireSkill(directory, slug, reason) {
     reason
   };
 }
+async function markSkillStale(skillDir, reason) {
+  await mkdir5(skillDir, { recursive: true });
+  await writeFile3(path5.join(skillDir, "stale.marker"), reason, "utf-8");
+}
+async function clearSkillStale(skillDir) {
+  const markerPath = path5.join(skillDir, "stale.marker");
+  try {
+    await unlink(markerPath);
+  } catch (err) {
+    if (err instanceof Error && "code" in err && err.code === "ENOENT") {
+      return;
+    }
+    warn(`[skill-generator] failed to remove stale.marker at ${markerPath}: ${err instanceof Error ? err.message : String(err)}`);
+  }
+}
+async function retireOrMarkStale(directory, skillDir, archivedKnowledgeIds) {
+  const fs = await import("fs/promises");
+  const skillPath = path5.join(skillDir, "SKILL.md");
+  if (!existsSync3(skillPath)) {
+    await markSkillStale(skillDir, "source knowledge archived, SKILL.md missing");
+    const slug2 = path5.basename(skillDir);
+    return { action: "stale", slug: slug2, skillDir };
+  }
+  let content;
+  try {
+    content = await fs.readFile(skillPath, "utf-8");
+  } catch {
+    await markSkillStale(skillDir, "source knowledge archived, SKILL.md unreadable");
+    const slug2 = path5.basename(skillDir);
+    return { action: "stale", slug: slug2, skillDir };
+  }
+  const fm = parseDraftFrontmatter(content);
+  const sourceIds = fm?.sourceKnowledgeIds ?? [];
+  if (sourceIds.length === 0) {
+    await markSkillStale(skillDir, "source knowledge archived, no source_knowledge_ids in frontmatter");
+    const slug2 = path5.basename(skillDir);
+    return { action: "stale", slug: slug2, skillDir };
+  }
+  const allArchived = sourceIds.every((id) => archivedKnowledgeIds.has(id));
+  const slug = path5.basename(skillDir);
+  if (allArchived) {
+    await retireSkill(directory, slug, "all source knowledge entries archived or deleted");
+    return { action: "retire", slug, skillDir };
+  } else {
+    await markSkillStale(skillDir, "one or more source knowledge entries archived");
+    return { action: "stale", slug, skillDir };
+  }
+}
 async function regenerateSkill(directory, slug, options = {}) {
   const cleanSlug = sanitizeSlug(slug);
   if (!isValidSlug2(cleanSlug)) {
@@ -2357,6 +2513,7 @@ async function regenerateSkill(directory, slug, options = {}) {
   try {
     await atomicWrite2(skillPath, content);
     await stampSourceEntries(directory, cleanSlug, matchedEntries.map((e) => e.id));
+    await clearSkillStale(path5.dirname(activePath(directory, cleanSlug)));
   } catch (writeErr) {
     return {
       regenerated: false,
@@ -2391,13 +2548,17 @@ var _internals = {
   generateSkills,
   activateProposal,
   listSkills,
+  findSkillsBySourceKnowledgeId,
+  findStaleSkillsBySourceKnowledgeId,
   inspectSkill,
   stampSourceEntries,
   parseDraftFrontmatter,
   retireSkill,
+  retireOrMarkStale,
   regenerateSkill,
+  clearSkillStale,
   autoApplyProposals,
   unlinkSync
 };
 
-export { resolveKnowledgeEventsPath, readKnowledgeEvents, readKnowledgeCounterRollups, effectiveRetrievalOutcomes, validateLesson, validateActionableFields, validateActionability, resolveUnactionablePath, appendUnactionable, quarantineEntry, restoreEntry, sanitizeSlug, isValidSlug2 as isValidSlug, proposalPath, activePath, activeRepoRelativePath, DEFAULT_SKILL_MIN_CONFIDENCE, DEFAULT_SKILL_MIN_CONFIRMATIONS, STRONG_SKILL_OUTCOME_COUNT, HIGH_PRIORITY_SKILL_MIN_CONFIDENCE, selectCandidateEntries, isSkillMaturityEligible, clusterEntries, renderSkillMarkdown, generateSkills, parseDraftFrontmatter, activateProposal, listSkills, autoApplyProposals, inspectSkill, retireSkill, regenerateSkill, _internals };
+export { resolveKnowledgeEventsPath, readKnowledgeEvents, readKnowledgeCounterRollups, effectiveRetrievalOutcomes, validateLesson, validateActionableFields, validateActionability, resolveUnactionablePath, appendUnactionable, quarantineEntry, restoreEntry, sanitizeSlug, isValidSlug2 as isValidSlug, proposalPath, activePath, activeRepoRelativePath, DEFAULT_SKILL_MIN_CONFIDENCE, DEFAULT_SKILL_MIN_CONFIRMATIONS, STRONG_SKILL_OUTCOME_COUNT, HIGH_PRIORITY_SKILL_MIN_CONFIDENCE, selectCandidateEntries, isSkillMaturityEligible, clusterEntries, renderSkillMarkdown, generateSkills, parseDraftFrontmatter, activateProposal, findSkillsBySourceKnowledgeId, findStaleSkillsBySourceKnowledgeId, listSkills, autoApplyProposals, inspectSkill, retireSkill, markSkillStale, clearSkillStale, retireOrMarkStale, regenerateSkill, _internals };

package/dist/cli/{index-w7gkpmq8.js → index-hb10a2g8.js}

@@ -386,6 +386,38 @@ async function transactKnowledge(filePath, mutate) {
     await atomicWriteFile(fp, content);
   }, mutate);
 }
+async function getArchivedKnowledgeIds(directory) {
+  const archived = new Set;
+  const swarmPath = resolveSwarmKnowledgePath(directory);
+  try {
+    const content = await readFile(swarmPath, "utf-8");
+    const lines = content.split(`
+`).filter((l) => l.trim());
+    for (const line of lines) {
+      try {
+        const entry = JSON.parse(line);
+        if (entry.status === "archived" || entry.status === "quarantined" || entry.status === "quarantined_unactionable") {
+          archived.add(entry.id);
+        }
+      } catch {}
+    }
+  } catch {}
+  const hivePath = resolveHiveKnowledgePath();
+  try {
+    const content = await readFile(hivePath, "utf-8");
+    const lines = content.split(`
+`).filter((l) => l.trim());
+    for (const line of lines) {
+      try {
+        const entry = JSON.parse(line);
+        if (entry.status === "archived" || entry.status === "quarantined" || entry.status === "quarantined_unactionable") {
+          archived.add(entry.id);
+        }
+      } catch {}
+    }
+  } catch {}
+  return archived;
+}
 async function appendKnowledgeWithCapEnforcement(filePath, entry, maxEntries) {
   return transactKnowledge(filePath, (entries) => {
     const updated = [...entries, entry];
@@ -677,7 +709,8 @@ var _internals = {
   computeOutcomeSignal,
   selectKnowledgeCapSurvivors,
   inferTags,
-  bumpKnowledgeConfidenceBatch
+  bumpKnowledgeConfidenceBatch,
+  getArchivedKnowledgeIds
 };
 
-export { resolveLinkDir, sanitizeLinkId, readLinkPointer, writeLinkPointer, removeLinkPointer, resolveKnowledgeStoreDir, isLinked, getPlatformConfigDir, resolveSwarmKnowledgePath, resolveSwarmRejectedPath, resolveSwarmRetractionsPath, resolveHiveKnowledgePath, resolveHiveRejectedPath, resolveHiveEventsPath, readKnowledge, normalizeEntry, readRejectedLessons, readRetractionRecords, appendRetractionRecord, appendKnowledge, rewriteKnowledge, transactFile, transactKnowledge, appendKnowledgeWithCapEnforcement, enforceKnowledgeCap, sweepAgedEntries, sweepStaleTodos, appendRejectedLesson, normalize, wordBigrams, jaccardBigram, findNearDuplicate, computeConfidence, OUTCOME_SIGNAL_SMOOTHING, computeOutcomeSignal, inferTags, bumpKnowledgeConfidenceBatch, _internals };
+export { resolveLinkDir, sanitizeLinkId, readLinkPointer, writeLinkPointer, removeLinkPointer, resolveKnowledgeStoreDir, isLinked, getPlatformConfigDir, resolveSwarmKnowledgePath, resolveSwarmRejectedPath, resolveSwarmRetractionsPath, resolveHiveKnowledgePath, resolveHiveRejectedPath, resolveHiveEventsPath, readKnowledge, normalizeEntry, readRejectedLessons, readRetractionRecords, appendRetractionRecord, appendKnowledge, rewriteKnowledge, transactFile, transactKnowledge, getArchivedKnowledgeIds, appendKnowledgeWithCapEnforcement, enforceKnowledgeCap, sweepAgedEntries, sweepStaleTodos, appendRejectedLesson, normalize, wordBigrams, jaccardBigram, findNearDuplicate, computeConfidence, OUTCOME_SIGNAL_SMOOTHING, computeOutcomeSignal, inferTags, bumpKnowledgeConfidenceBatch, _internals };

package/dist/cli/{index-dy6zs70b.js → index-jv0bz96v.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-9j1xvd8m.js";
+} from "./index-q8qx8p47.js";
 import {
   handleGuardrailLog
-} from "./index-yykcmn6m.js";
+} from "./index-tx5czwpd.js";
 import {
   COMMAND_REGISTRY,
   SWARM_COMMAND_TOOL_ALLOWLIST,
@@ -78,17 +78,17 @@ import {
   handleWriteRetroCommand,
   normalizeSwarmCommandInput,
   resolveCommand
-} from "./index-mv27v975.js";
-import"./index-ne4g3mk1.js";
-import"./index-1x2608ga.js";
-import"./index-5hrexm02.js";
-import"./index-w7gkpmq8.js";
-import"./index-2jpbaedv.js";
+} from "./index-a59fjg9v.js";
+import"./index-dgjsa6hy.js";
+import"./index-2a6ppa65.js";
+import"./index-fjxjb66n.js";
+import"./index-hb10a2g8.js";
+import"./index-vqg905es.js";
 import {
   AGENT_TOOL_MAP,
   ORCHESTRATOR_NAME,
   stripKnownSwarmPrefix
-} from "./index-xsbtbffr.js";
+} from "./index-79dcqsg9.js";
 import"./index-y1z6yaq4.js";
 import"./index-adz3nk9b.js";
 import"./index-v4fcn4tr.js";

package/dist/cli/{index-9j1xvd8m.js → index-q8qx8p47.js}

@@ -12,14 +12,14 @@ import {
   detectPosixWrites,
   detectWindowsWrites,
   resolveWriteTargets
-} from "./index-mv27v975.js";
+} from "./index-a59fjg9v.js";
 import {
   checkFileAuthority,
   classifyFile,
   isInDeclaredScope,
   redactPath,
   redactShellCommand
-} from "./index-ne4g3mk1.js";
+} from "./index-dgjsa6hy.js";
 
 // src/services/guardrail-explain-service.ts
 import path from "path";

package/dist/cli/{index-yykcmn6m.js → index-tx5czwpd.js}

@@ -2,7 +2,7 @@
 import {
   redactPath,
   redactShellCommand
-} from "./index-ne4g3mk1.js";
+} from "./index-dgjsa6hy.js";
 
 // src/services/guardrail-log-service.ts
 import * as fs from "fs/promises";

package/dist/cli/{index-2jpbaedv.js → index-vqg905es.js}

@@ -3,7 +3,7 @@ import {
   ALL_AGENT_NAMES,
   PluginConfigSchema,
   stripKnownSwarmPrefix
-} from "./index-xsbtbffr.js";
+} from "./index-79dcqsg9.js";
 import {
   log
 } from "./index-zgwm4ryv.js";

package/dist/cli/index.js

@@ -7,15 +7,15 @@ import {
   getPluginLockFilePaths,
   package_default,
   resolveCommand
-} from "./index-mv27v975.js";
-import"./index-ne4g3mk1.js";
-import"./index-1x2608ga.js";
-import"./index-5hrexm02.js";
-import"./index-w7gkpmq8.js";
-import"./index-2jpbaedv.js";
+} from "./index-a59fjg9v.js";
+import"./index-dgjsa6hy.js";
+import"./index-2a6ppa65.js";
+import"./index-fjxjb66n.js";
+import"./index-hb10a2g8.js";
+import"./index-vqg905es.js";
 import {
   DEFAULT_AGENT_CONFIGS
-} from "./index-xsbtbffr.js";
+} from "./index-79dcqsg9.js";
 import"./index-y1z6yaq4.js";
 import"./index-adz3nk9b.js";
 import"./index-v4fcn4tr.js";

package/dist/cli/{knowledge-store-eqans52j.js → knowledge-store-pa58msy5.js}

@@ -11,6 +11,7 @@ import {
   computeOutcomeSignal,
   enforceKnowledgeCap,
   findNearDuplicate,
+  getArchivedKnowledgeIds,
   getPlatformConfigDir,
   inferTags,
   jaccardBigram,
@@ -31,7 +32,7 @@ import {
   transactFile,
   transactKnowledge,
   wordBigrams
-} from "./index-w7gkpmq8.js";
+} from "./index-hb10a2g8.js";
 import"./index-kv4dd5c5.js";
 import"./index-jtqkh8jf.js";
 import"./index-91qtsbce.js";
@@ -59,6 +60,7 @@ export {
   jaccardBigram,
   inferTags,
   getPlatformConfigDir,
+  getArchivedKnowledgeIds,
   findNearDuplicate,
   enforceKnowledgeCap,
   computeOutcomeSignal,

package/dist/cli/{schema-1kndsf0c.js → schema-jy18ftky.js}

@@ -81,7 +81,7 @@ import {
   resolveGeneratedAgentRole,
   resolveGuardrailsConfig,
   stripKnownSwarmPrefix
-} from "./index-xsbtbffr.js";
+} from "./index-79dcqsg9.js";
 import"./index-p0arc26j.js";
 import"./index-293f68mj.js";
 import"./index-a76rekgs.js";

package/dist/cli/{skill-generator-d0jzw6n2.js → skill-generator-3tkwcg4x.js}

@@ -9,21 +9,26 @@ import {
   activePath,
   activeRepoRelativePath,
   autoApplyProposals,
+  clearSkillStale,
   clusterEntries,
+  findSkillsBySourceKnowledgeId,
+  findStaleSkillsBySourceKnowledgeId,
   generateSkills,
   inspectSkill,
   isSkillMaturityEligible,
   isValidSlug,
   listSkills,
+  markSkillStale,
   parseDraftFrontmatter,
   proposalPath,
   regenerateSkill,
   renderSkillMarkdown,
+  retireOrMarkStale,
   retireSkill,
   sanitizeSlug,
   selectCandidateEntries
-} from "./index-5hrexm02.js";
-import"./index-w7gkpmq8.js";
+} from "./index-fjxjb66n.js";
+import"./index-hb10a2g8.js";
 import"./index-kv4dd5c5.js";
 import"./index-jtqkh8jf.js";
 import"./index-zgwm4ryv.js";
@@ -35,16 +40,21 @@ export {
   selectCandidateEntries,
   sanitizeSlug,
   retireSkill,
+  retireOrMarkStale,
   renderSkillMarkdown,
   regenerateSkill,
   proposalPath,
   parseDraftFrontmatter,
+  markSkillStale,
   listSkills,
   isValidSlug,
   isSkillMaturityEligible,
   inspectSkill,
   generateSkills,
+  findStaleSkillsBySourceKnowledgeId,
+  findSkillsBySourceKnowledgeId,
   clusterEntries,
+  clearSkillStale,
   autoApplyProposals,
   activeRepoRelativePath,
   activePath,

package/dist/hooks/curator.d.ts

@@ -24,10 +24,10 @@
  * This dual dispatch means agent lists are incomplete — they capture factory-dispatched
  * curators but omit hook-dispatched ones. This is by design for hook-internal operations.
  */
-import { listSkills, parseDraftFrontmatter, retireSkill } from '../services/skill-generator.js';
+import { listSkills, parseDraftFrontmatter, retireOrMarkStale, retireSkill } from '../services/skill-generator.js';
 import { getSkillVersion, reviseSkill } from '../services/skill-reviser.js';
 import type { ComplianceObservation, CuratorConfig, CuratorInitResult, CuratorPhaseResult, CuratorSummary, KnowledgeRecommendation } from './curator-types.js';
-import { readKnowledge } from './knowledge-store.js';
+import { getArchivedKnowledgeIds, readKnowledge } from './knowledge-store.js';
 import type { KnowledgeConfig } from './knowledge-types.js';
 import { readSkillUsageEntries } from './skill-usage-log.js';
 /**
@@ -48,7 +48,9 @@ export declare const _internals: {
     readSkillUsageEntries: typeof readSkillUsageEntries;
     listSkills: typeof listSkills;
     parseDraftFrontmatter: typeof parseDraftFrontmatter;
+    retireOrMarkStale: typeof retireOrMarkStale;
     retireSkill: typeof retireSkill;
+    getArchivedKnowledgeIds: typeof getArchivedKnowledgeIds;
     readFileAsync: (filePath: string, encoding: string) => Promise<string>;
     readKnowledge: typeof readKnowledge;
     reviseSkill: typeof reviseSkill;
@@ -63,10 +65,13 @@ export interface RecommendationParseDiagnostic {
  * Auto-retire generated skills whose violation rate exceeds 30% or
  * whose source knowledge entries are all archived.
  *
+ * Also marks skills stale when some (but not all) source knowledge entries
+ * are archived.
+ *
  * Non-blocking: errors are caught and logged but never propagated.
  * Returns an array of observation strings to include in the phase digest.
  */
-declare function autoRetireSkills(directory: string, curatorKnowledgePath: string, excludeSlugs?: ReadonlySet<string>): Promise<string[]>;
+declare function autoRetireSkills(directory: string, _curatorKnowledgePath: string, excludeSlugs?: ReadonlySet<string>): Promise<string[]>;
 /**
  * Parse OBSERVATIONS section from curator LLM output.
  * Expected format per line: "- entry <uuid> (<observable>): [text]"

package/dist/hooks/knowledge-events.d.ts

@@ -132,7 +132,18 @@ export interface EscalationEvent {
     reason: string;
     enforcement_mode?: string;
 }
-export type KnowledgeEvent = RetrievedEvent | ReceiptEvent | OutcomeEvent | ArchivedEvent | EscalationEvent;
+/** A batch of skills were invalidated after a knowledge entry was archived/purged. */
+export interface SkillStaleBatchEvent {
+    type: 'skill-stale-batch';
+    schema_version?: number;
+    event_id?: string;
+    timestamp?: string;
+    skillIds: string[];
+    archivedIds: string[];
+    retiredCount: number;
+    staleCount: number;
+}
+export type KnowledgeEvent = RetrievedEvent | ReceiptEvent | OutcomeEvent | ArchivedEvent | EscalationEvent | SkillStaleBatchEvent;
 export type KnowledgeEventType = KnowledgeEvent['type'];
 /**
  * Event shape accepted by {@link appendKnowledgeEvent} / {@link recordKnowledgeEvent}.

package/dist/hooks/knowledge-store.d.ts

@@ -26,6 +26,7 @@ export declare function appendKnowledge<T>(filePath: string, entry: T): Promise<
 export declare function rewriteKnowledge<T>(filePath: string, entries: T[]): Promise<void>;
 export declare function transactFile<T>(filePath: string, read: (filePath: string) => Promise<T>, write: (filePath: string, data: T) => Promise<void>, mutate: (data: T) => T | null): Promise<boolean>;
 export declare function transactKnowledge<T>(filePath: string, mutate: (entries: T[]) => T[] | null): Promise<boolean>;
+export declare function getArchivedKnowledgeIds(directory: string): Promise<Set<string>>;
 export declare function appendKnowledgeWithCapEnforcement<T>(filePath: string, entry: T, maxEntries: number): Promise<boolean>;
 export declare function enforceKnowledgeCap<T>(filePath: string, maxEntries: number): Promise<void>;
 declare function selectKnowledgeCapSurvivors<T>(entries: T[], maxEntries: number): T[];
@@ -95,5 +96,6 @@ export declare const _internals: {
     selectKnowledgeCapSurvivors: typeof selectKnowledgeCapSurvivors;
     inferTags: typeof inferTags;
     bumpKnowledgeConfidenceBatch: typeof bumpKnowledgeConfidenceBatch;
+    getArchivedKnowledgeIds: typeof getArchivedKnowledgeIds;
 };
 export {};