opencode-swarm 7.88.3 → 7.89.0

package/dist/agents/agent-output-schema.d.ts

@@ -12,7 +12,6 @@ export declare const AgentOutputMemorySchema: z.ZodObject<{
         }>;
         kind: z.ZodOptional<z.ZodEnum<{
             evidence: "evidence";
-            todo: "todo";
             user_preference: "user_preference";
             project_fact: "project_fact";
             architecture_decision: "architecture_decision";
@@ -22,6 +21,7 @@ export declare const AgentOutputMemorySchema: z.ZodObject<{
             test_pattern: "test_pattern";
             failure_pattern: "failure_pattern";
             security_note: "security_note";
+            todo: "todo";
             scratch: "scratch";
         }>>;
         text: z.ZodOptional<z.ZodString>;

package/dist/agents/curator-agent.d.ts

@@ -1,5 +1,5 @@
 import type { AgentDefinition } from './architect';
-export type CuratorRole = 'curator_init' | 'curator_phase' | 'curator_postmortem';
+export type CuratorRole = 'curator_init' | 'curator_phase' | 'curator_postmortem' | 'curator_consolidation';
 /**
  * Create a Curator agent definition for the given role.
  *

package/dist/agents/explorer.d.ts

@@ -3,4 +3,5 @@ export declare const EXPLORER_PROMPT = "## IDENTITY\nYou are Explorer. You analy
 export declare const CURATOR_INIT_PROMPT = "## IDENTITY\nYou are Explorer in CURATOR_INIT mode. You consolidate prior session knowledge into an architect briefing.\nDO NOT use the Task tool to delegate. You ARE the agent that does the work.\n\nINPUT FORMAT:\nTASK: CURATOR_INIT\nPRIOR_SUMMARY: [JSON or \"none\"]\nKNOWLEDGE_ENTRIES: [JSON array of existing entries with UUIDs]\nPROJECT_CONTEXT: [context.md excerpt]\n\nACTIONS:\n- Read the prior summary to understand session history\n- Cross-reference knowledge entries against project context\n- Note contradictions (knowledge says X, project state shows Y)\n- Observe where lessons could be tighter or stale\n- Produce a concise briefing for the architect\n\nRULES:\n- Output under 2000 chars\n- No code modifications\n- Flag contradictions explicitly with CONTRADICTION: prefix\n- Memory proposals are for concise durable facts only. Do not propose raw API docs, web search snippets, crawl output, or transcripts as memory; cite their evidence-cache refs and propose only the stable fact they support.\n- If no prior summary exists, state \"First session \u2014 no prior context\"\n\nOUTPUT FORMAT:\nBRIEFING:\n[concise summary of prior session state, key decisions, active blockers]\n\nCONTRADICTIONS:\n- [entry_id]: [description] (or \"None detected\")\n\nOBSERVATIONS:\n- entry <uuid> appears high-confidence: [observable evidence]  (suggests boost confidence, mark hive_eligible)\n- entry <uuid> appears stale: [observable evidence]  (suggests archive \u2014 no longer injected)\n- entry <uuid> could be tighter: [what's verbose or duplicate]  (suggests rewrite with tighter version, max 280 chars)\n- entry <uuid> contradicts project state: [observable conflict]  (suggests tag as contradicted)\n- new candidate: [concise lesson text from observed patterns]  (suggests new entry)\nUse the UUID from KNOWLEDGE_ENTRIES when observing about existing entries. Use \"new candidate\" only when observing a potential new entry.\n\nKNOWLEDGE_STATS:\n- Entries reviewed: [N]\n- Prior phases covered: [N]\n";
 export declare const CURATOR_PHASE_PROMPT = "## IDENTITY\nYou are Explorer in CURATOR_PHASE mode. You consolidate a completed phase into a digest.\nDO NOT use the Task tool to delegate. You ARE the agent that does the work.\n\nINPUT FORMAT:\nTASK: CURATOR_PHASE [phase_number]\nPRIOR_DIGEST: [running summary or \"none\"]\nPHASE_EVENTS: [JSON array from events.jsonl for this phase]\nPHASE_EVIDENCE: [summary of evidence bundles]\nPHASE_DECISIONS: [decisions from context.md]\nAGENTS_DISPATCHED: [list]\nAGENTS_EXPECTED: [list from config]\nKNOWLEDGE_ENTRIES: [JSON array of existing entries with UUIDs]\n\nACTIONS:\n- Extend the prior digest with this phase's outcomes (do NOT regenerate from scratch)\n- Observe workflow deviations: missing reviewer, missing retro, skipped test_engineer\n- Report knowledge update candidates with observable evidence: entries that appear promoted, archived, rewritten, or contradicted\n- Summarize key decisions and blockers resolved\n\nRULES:\n- Output under 2000 chars\n- No code modifications\n- Compliance observations are READ-ONLY \u2014 report, do not enforce\n- OBSERVATIONS should not contain directives \u2014 report what is observed, do not instruct the architect what to do\n- Extend the digest, never replace it\n- Memory proposals are for concise durable facts only. Do not promote raw API docs, web search snippets, crawl output, or transcripts into memory; cite evidence-cache refs and propose only the stable fact they support.\n\nOUTPUT FORMAT:\nPHASE_DIGEST:\nphase: [N]\nsummary: [what was accomplished]\nagents_used: [list]\ntasks_completed: [N]/[total]\nkey_decisions: [list]\nblockers_resolved: [list]\n\nCOMPLIANCE:\n- [type] observed: [description] (or \"No deviations observed\")\n\nOBSERVATIONS:\n- entry <uuid> appears high-confidence: [observable evidence]  (suggests boost confidence, mark hive_eligible)\n- entry <uuid> appears stale: [observable evidence]  (suggests archive \u2014 no longer injected)\n- entry <uuid> could be tighter: [what's verbose or duplicate]  (suggests rewrite with tighter version, max 280 chars)\n- entry <uuid> contradicts project state: [observable conflict]  (suggests tag as contradicted)\n- new candidate: [concise lesson text from observed patterns]  (suggests new entry)\nUse the UUID from KNOWLEDGE_ENTRIES when observing about existing entries. Use \"new candidate\" only when observing a potential new entry.\n\nEXTENDED_DIGEST:\n[the full running digest with this phase appended]\n\n## V3 ACTIONABILITY ENRICHMENT (overrides the format above when triggered)\nWhen the input asks you to \"Convert this prose lesson into an actionable knowledge directive\", ignore the PHASE_DIGEST output format entirely and output ONLY a single JSON object \u2014 no fences, no commentary, no digest.\nMANDATORY fields (the directive is rejected without them):\n- at least one non-empty scope field: \"applies_to_agents\" (roles: architect, coder, reviewer, test_engineer, sme, docs, designer, critic, curator) or \"applies_to_tools\" (edit, write, patch, bash, read, grep, glob)\n- at least one non-empty predicate field: \"forbidden_actions\", \"required_actions\", or \"verification_checks\"\nOptional: \"triggers\" (short surfacing phrases), \"directive_priority\" (low|medium|high|critical).\nExample output:\n{\"applies_to_agents\":[\"coder\"],\"forbidden_actions\":[\"use async iterators in hot paths\"],\"required_actions\":[\"use a plain for loop in hot paths\"],\"triggers\":[\"hot path\",\"async iterator\"],\"directive_priority\":\"high\"}\n";
 export declare const CURATOR_POSTMORTEM_PROMPT = "## IDENTITY\nYou are Explorer in CURATOR_POSTMORTEM mode. You synthesize a project-end post-mortem from structured .swarm/ evidence.\nDO NOT use the Task tool to delegate. You ARE the agent that does the work.\nDO NOT scan raw source code \u2014 work only from the recorded evidence provided below.\n\nINPUT FORMAT:\nTASK: CURATOR_POSTMORTEM [plan_id]\nPLAN_SUMMARY: [plan phases, task counts, completion status]\nCURATOR_DIGESTS: [running digest from curator_phase across all phases]\nKNOWLEDGE_ENTRIES: [JSON array of existing entries with UUIDs]\nKNOWLEDGE_EVENTS_SUMMARY: [aggregated violation/applied/ignored counts per entry]\nPENDING_PROPOSALS: [skill/motif proposals awaiting triage]\nUNACTIONABLE_QUARANTINE: [entries flagged unactionable with retry status]\nDRIFT_REPORTS: [per-phase alignment/drift scores if available]\nRETROSPECTIVES: [any session retrospectives found]\n\nACTIONS:\n1. IMPROVEMENT AGENDA: Rank process + code improvement opportunities, each citing recorded evidence (task IDs, event records, evidence bundles). Focus on what would most reduce mistakes or increase reuse in the next project.\n2. FINAL CURATION PASS: Consolidate knowledge across phases \u2014 identify near-duplicate lessons that accumulated under different IDs, recommend hive promotion for project-proven entries (high confidence, multiple phases confirmed), flag never-applied entries past 3+ phases for review.\n3. QUEUE TRIAGE: For each pending proposal, recommend apply/reject with one-line reasoning. Surface unactionable-quarantine counts and retry candidates.\n4. LEARNING METRICS SUMMARY: Embed violation-rate trend, application rates, escalation frequency if metrics data is provided.\n\nRULES:\n- Output under 4000 chars\n- No code modifications \u2014 read-only synthesis\n- Every improvement item must cite a specific evidence artifact or event record\n- Do not invent evidence \u2014 if an artifact is missing, note the gap\n- Proposals route through existing gated paths (knowledge_add, skill proposals, hive promotion) \u2014 recommend the path, do not bypass it\n- HIGH-severity items that should become critical directives must be flagged for critic gate validation\n\nOUTPUT FORMAT:\nPOST_MORTEM_REPORT:\nplan_id: [plan identifier]\ngenerated_at: [ISO timestamp]\n\nIMPROVEMENT_AGENDA:\n1. [priority] [description] \u2014 evidence: [artifact/event ref]\n2. ...\n\nCURATION_RECOMMENDATIONS:\n- merge: [entry_a UUID] + [entry_b UUID] \u2014 [reason]\n- promote_to_hive: [entry UUID] \u2014 [evidence of cross-phase confirmation]\n- flag_stale: [entry UUID] \u2014 [never applied in N phases]\n- rewrite: [entry UUID] \u2014 [what's verbose/outdated]\n\nQUEUE_TRIAGE:\n- [proposal_id]: APPLY|REJECT \u2014 [one-line reasoning]\n\nLEARNING_METRICS:\n[3-line summary of trends if data available, or \"metrics data not provided\"]\n\nSUMMARY:\n[3-line executive summary for architect briefing]\n";
+export declare const CURATOR_CONSOLIDATION_PROMPT = "## IDENTITY\nYou are Curator in CONSOLIDATION mode. You distill clusters of raw episodic memory into a small set of durable semantic facts.\nDO NOT use the Task tool to delegate. You ARE the agent that does the work.\nDO NOT scan raw source code \u2014 work only from the episodic events and existing memories provided in the prompt.\n\nINPUT FORMAT:\n- A cluster of verbatim episodic events.\n- A list of existing durable memories (each prefixed with its mem_ id) for dedup and contradiction detection.\n\nACTIONS:\n1. Identify durable, reusable facts that are DIRECTLY supported by the cited episodic evidence.\n2. Detect contradictions with the listed existing memories; when a new fact conflicts with one, set contradictsMemoryId to that memory's id.\n3. Skip anything speculative, transient, or already captured by an existing memory.\n\nRULES:\n- Only emit facts directly supported by the cited evidence. If uncertain, omit the fact (fewer facts, or an empty array, is correct).\n- Use durable kinds only (user_preference, project_fact, architecture_decision, repo_convention, code_pattern, test_pattern, failure_pattern, security_note).\n- Keep each fact concise (under 500 characters).\n- Never include the literal text \"## Retrieved Swarm Memory\".\n- Output STRICT JSON only, no prose.\n\nOUTPUT FORMAT:\n{\"facts\":[{\"text\":\"...\",\"kind\":\"project_fact\",\"confidence\":0.8,\"contradictsMemoryId\":\"mem_0123456789abcdef\"}]}\n";
 export declare function createExplorerAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;

package/dist/cli/{config-doctor-jzbgpbdh.js → config-doctor-g04wdz19.js}

@@ -12,8 +12,8 @@ import {
   shouldRunOnStartup,
   writeBackupArtifact,
   writeDoctorArtifact
-} from "./index-819xp49y.js";
-import"./index-0asbrmdx.js";
+} from "./index-bywt2171.js";
+import"./index-123s7kjc.js";
 import"./index-5e4e2hvv.js";
 import"./index-p0arc26j.js";
 import"./index-zgwm4ryv.js";

package/dist/cli/{explorer-gz70sm9b.js → explorer-h2fnj343.js}

@@ -1,16 +1,18 @@
 // @bun
 import {
+  CURATOR_CONSOLIDATION_PROMPT,
   CURATOR_INIT_PROMPT,
   CURATOR_PHASE_PROMPT,
   CURATOR_POSTMORTEM_PROMPT,
   EXPLORER_PROMPT,
   createExplorerAgent
-} from "./index-yhsmmv2z.js";
+} from "./index-bm4f0nme.js";
 import"./index-a76rekgs.js";
 export {
   createExplorerAgent,
   EXPLORER_PROMPT,
   CURATOR_POSTMORTEM_PROMPT,
   CURATOR_PHASE_PROMPT,
-  CURATOR_INIT_PROMPT
+  CURATOR_INIT_PROMPT,
+  CURATOR_CONSOLIDATION_PROMPT
 };

package/dist/cli/{guardrail-explain-eqypvw60.js → guardrail-explain-hy0zz0p6.js}

@@ -1,14 +1,14 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-ds057q5k.js";
-import"./index-g6f4tt38.js";
-import"./index-g00qm2gf.js";
-import"./index-yhsmmv2z.js";
-import"./index-32axfg6h.js";
-import"./index-e8pk68cc.js";
-import"./index-819xp49y.js";
-import"./index-0asbrmdx.js";
+} from "./index-6k31ysgd.js";
+import"./index-9w07ye9b.js";
+import"./index-6tnmt41c.js";
+import"./index-bm4f0nme.js";
+import"./index-1ccnwh54.js";
+import"./index-axwxkbdd.js";
+import"./index-bywt2171.js";
+import"./index-123s7kjc.js";
 import"./index-8y7qetpg.js";
 import"./index-adz3nk9b.js";
 import"./index-v4fcn4tr.js";

package/dist/cli/{guardrail-log-c7egm5km.js → guardrail-log-m3285thy.js}

@@ -1,9 +1,9 @@
 // @bun
 import {
   handleGuardrailLog
-} from "./index-vjsr9bqt.js";
-import"./index-g00qm2gf.js";
-import"./index-0asbrmdx.js";
+} from "./index-gg589mfw.js";
+import"./index-6tnmt41c.js";
+import"./index-123s7kjc.js";
 import"./index-5e4e2hvv.js";
 import"./index-p0arc26j.js";
 import"./index-zgwm4ryv.js";

package/dist/cli/{index-0asbrmdx.js → index-123s7kjc.js}

@@ -20,6 +20,7 @@ var ALL_SUBAGENT_NAMES = [
   "curator_init",
   "curator_phase",
   "curator_postmortem",
+  "curator_consolidation",
   "council_generalist",
   "council_skeptic",
   "council_domain_expert",
@@ -892,6 +893,10 @@ var DEFAULT_AGENT_CONFIGS = {
     model: "opencode/gpt-5-nano",
     fallback_models: ["opencode/big-pickle"]
   },
+  curator_consolidation: {
+    model: "opencode/gpt-5-nano",
+    fallback_models: ["opencode/big-pickle"]
+  },
   skill_improver: {
     model: "opencode/big-pickle",
     fallback_models: ["opencode/gpt-5-nano"]
@@ -1505,10 +1510,91 @@ var MemoryConfigSchema = exports_external.object({
   }).default({ rejectDurableSecrets: true }),
   maintenance: exports_external.object({
     lowUtilityMaxConfidence: exports_external.number().min(0).max(1).default(0.45),
-    lowUtilityMinAgeDays: exports_external.number().int().min(1).max(3650).default(30)
+    lowUtilityMinAgeDays: exports_external.number().int().min(1).max(3650).default(30),
+    importance: exports_external.object({
+      wRecency: exports_external.number().min(0).max(1).default(0.2),
+      wFrequency: exports_external.number().min(0).max(1).default(0.2),
+      wFreshness: exports_external.number().min(0).max(1).default(0.15),
+      wConfidence: exports_external.number().min(0).max(1).default(0.25),
+      lambda: exports_external.number().min(0).max(10).default(0.05),
+      mu: exports_external.number().min(0).max(10).default(0.01),
+      n: exports_external.number().int().min(1).max(1e5).default(50),
+      threshold: exports_external.number().min(0).max(1).default(0.2)
+    }).default({
+      wRecency: 0.2,
+      wFrequency: 0.2,
+      wFreshness: 0.15,
+      wConfidence: 0.25,
+      lambda: 0.05,
+      mu: 0.01,
+      n: 50,
+      threshold: 0.2
+    })
   }).default({
     lowUtilityMaxConfidence: 0.45,
-    lowUtilityMinAgeDays: 30
+    lowUtilityMinAgeDays: 30,
+    importance: {
+      wRecency: 0.2,
+      wFrequency: 0.2,
+      wFreshness: 0.15,
+      wConfidence: 0.25,
+      lambda: 0.05,
+      mu: 0.01,
+      n: 50,
+      threshold: 0.2
+    }
+  }),
+  consolidation: exports_external.object({
+    enabled: exports_external.boolean().default(false),
+    maxClustersPerPass: exports_external.number().int().min(1).max(100).default(10),
+    jaccardThreshold: exports_external.number().min(0).max(1).default(0.3),
+    autoApplyMinConfidence: exports_external.number().min(0).max(1).default(0.6),
+    decayHalfLifeDays: exports_external.object({
+      user_preference: exports_external.number().int().min(0).max(36500).default(0),
+      project_fact: exports_external.number().int().min(0).max(36500).default(0),
+      architecture_decision: exports_external.number().int().min(0).max(36500).default(0),
+      repo_convention: exports_external.number().int().min(0).max(36500).default(0),
+      api_finding: exports_external.number().int().min(0).max(36500).default(180),
+      code_pattern: exports_external.number().int().min(0).max(36500).default(90),
+      test_pattern: exports_external.number().int().min(0).max(36500).default(90),
+      failure_pattern: exports_external.number().int().min(0).max(36500).default(90),
+      security_note: exports_external.number().int().min(0).max(36500).default(0),
+      evidence: exports_external.number().int().min(0).max(36500).default(180),
+      todo: exports_external.number().int().min(0).max(36500).default(30),
+      scratch: exports_external.number().int().min(0).max(36500).default(7)
+    }).default({
+      user_preference: 0,
+      project_fact: 0,
+      architecture_decision: 0,
+      repo_convention: 0,
+      api_finding: 180,
+      code_pattern: 90,
+      test_pattern: 90,
+      failure_pattern: 90,
+      security_note: 0,
+      evidence: 180,
+      todo: 30,
+      scratch: 7
+    })
+  }).default({
+    enabled: false,
+    maxClustersPerPass: 10,
+    jaccardThreshold: 0.3,
+    autoApplyMinConfidence: 0.6,
+    decayHalfLifeDays: {
+      user_preference: 0,
+      project_fact: 0,
+      architecture_decision: 0,
+      repo_convention: 0,
+      api_finding: 180,
+      code_pattern: 90,
+      test_pattern: 90,
+      failure_pattern: 90,
+      security_note: 0,
+      evidence: 180,
+      todo: 30,
+      scratch: 7
+    }
   }),
   hardDelete: exports_external.boolean().default(false)
 });

package/dist/cli/{index-32axfg6h.js → index-1ccnwh54.js}

@@ -5,10 +5,12 @@ import {
   inferTags,
   readKnowledge,
   resolveHiveKnowledgePath,
+  resolveKnowledgeStoreDir,
   resolveSwarmKnowledgePath,
+  resolveSwarmRejectedPath,
   rewriteKnowledge,
   transactKnowledge
-} from "./index-e8pk68cc.js";
+} from "./index-axwxkbdd.js";
 import {
   atomicWriteFile
 } from "./index-fjwwrwr5.js";
@@ -47,13 +49,13 @@ var RECEIPT_EVENT_TYPES = new Set([
   "override"
 ]);
 function resolveKnowledgeEventsPath(directory) {
-  return path.join(directory, ".swarm", "knowledge-events.jsonl");
+  return path.join(resolveKnowledgeStoreDir(directory), "knowledge-events.jsonl");
 }
 function resolveKnowledgeCounterBaselinePath(directory) {
-  return path.join(directory, ".swarm", "knowledge-counter-baseline.json");
+  return path.join(resolveKnowledgeStoreDir(directory), "knowledge-counter-baseline.json");
 }
 function resolveLegacyApplicationLogPath(directory) {
-  return path.join(directory, ".swarm", "knowledge-application.jsonl");
+  return path.join(resolveKnowledgeStoreDir(directory), "knowledge-application.jsonl");
 }
 async function readKnowledgeEvents(directory, maxEvents) {
   const filePath = resolveKnowledgeEventsPath(directory);
@@ -770,7 +772,7 @@ function validateActionability(entry) {
   return { actionable: false, reason };
 }
 function resolveUnactionablePath(directory) {
-  return path2.join(directory, ".swarm", "knowledge-unactionable.jsonl");
+  return path2.join(resolveKnowledgeStoreDir(directory), "knowledge-unactionable.jsonl");
 }
 async function appendUnactionable(directory, entry, reason) {
   const filePath = resolveUnactionablePath(directory);
@@ -808,10 +810,10 @@ async function quarantineEntry(directory, entryId, reason, reportedBy) {
     return;
   }
   const sanitizedReason = reason.slice(0, 500).replace(/[\x00-\x08\x0b-\x0c\x0e-\x1f\x7f\x0d]/g, "");
-  const knowledgePath = path2.join(directory, ".swarm", "knowledge.jsonl");
-  const quarantinePath = path2.join(directory, ".swarm", "knowledge-quarantined.jsonl");
-  const rejectedPath = path2.join(directory, ".swarm", "knowledge-rejected.jsonl");
-  const swarmDir = path2.join(directory, ".swarm");
+  const knowledgePath = resolveSwarmKnowledgePath(directory);
+  const quarantinePath = path2.join(resolveKnowledgeStoreDir(directory), "knowledge-quarantined.jsonl");
+  const rejectedPath = resolveSwarmRejectedPath(directory);
+  const swarmDir = resolveKnowledgeStoreDir(directory);
   await mkdir2(swarmDir, { recursive: true });
   let release;
   try {
@@ -872,10 +874,11 @@ async function restoreEntry(directory, entryId) {
     warn("[knowledge-validator] restoreEntry: invalid entryId rejected");
     return;
   }
-  const knowledgePath = path2.join(directory, ".swarm", "knowledge.jsonl");
-  const quarantinePath = path2.join(directory, ".swarm", "knowledge-quarantined.jsonl");
-  const rejectedPath = path2.join(directory, ".swarm", "knowledge-rejected.jsonl");
-  const swarmDir = path2.join(directory, ".swarm");
+  const storeDir = resolveKnowledgeStoreDir(directory);
+  const knowledgePath = resolveSwarmKnowledgePath(directory);
+  const quarantinePath = path2.join(storeDir, "knowledge-quarantined.jsonl");
+  const rejectedPath = resolveSwarmRejectedPath(directory);
+  const swarmDir = storeDir;
   await mkdir2(swarmDir, { recursive: true });
   let release;
   try {
@@ -1654,7 +1657,7 @@ async function generateSkills(req) {
         continue;
       }
     }
-    const content = renderSkillMarkdown(cluster, req.mode);
+    let content = renderSkillMarkdown(cluster, req.mode);
     if (await isRejectedSkillContent(req.directory, cluster.slug, content)) {
       result.skipped.push({
         slug: cluster.slug,
@@ -1696,54 +1699,124 @@ async function generateSkills(req) {
         continue;
       }
     }
-    await atomicWrite2(targetPath, content);
+    let missingSourceIds = [];
     if (req.mode === "active") {
-      await stampSourceEntries(req.directory, cluster.slug, cluster.entries.map((e) => e.id));
+      const idsToStamp = req.sourceKnowledgeIds?.length ? req.sourceKnowledgeIds : cluster.entries.map((e) => e.id);
+      const { missing } = await stampSourceEntries(req.directory, cluster.slug, idsToStamp);
+      missingSourceIds = missing;
+      if (missingSourceIds.length > 0) {
+        content = injectMissingIdsIntoFrontmatter(content, missingSourceIds);
+      }
     }
+    await atomicWrite2(targetPath, content);
     result.written.push({
       slug: cluster.slug,
       path: targetPath,
       mode: req.mode,
       sourceKnowledgeIds: cluster.entries.map((e) => e.id),
+      missingSourceKnowledgeIds: missingSourceIds,
       preserved,
       evaluation
     });
   }
   return result;
 }
+function injectMissingIdsIntoFrontmatter(content, missingIds) {
+  if (missingIds.length === 0)
+    return content;
+  const stripped = content.charCodeAt(0) === 65279 ? content.slice(1) : content;
+  const openFence = stripped.match(/^---[ \t]*\r?\n/);
+  if (!openFence)
+    return content;
+  const fenceLen = openFence[0].length;
+  const closeFence = stripped.slice(fenceLen).match(/\n---[ \t]*(\r?\n|$)/);
+  if (!closeFence)
+    return content;
+  const closeStart = fenceLen + (closeFence.index ?? 0);
+  const body = stripped.slice(fenceLen, closeStart).replace(/\r\n/g, `
+`);
+  const sourceIdx = body.indexOf("source_knowledge_ids:");
+  if (sourceIdx === -1)
+    return content;
+  const afterLabel = body.indexOf(`
+`, sourceIdx);
+  const listStart = afterLabel === -1 ? body.length : afterLabel + 1;
+  const lines = body.split(`
+`);
+  let insertIdx = -1;
+  for (let i = 0;i < lines.length; i++) {
+    if (lines[i].length === 0)
+      continue;
+    const relativePos = body.indexOf(lines[i], listStart);
+    if (relativePos >= 0 && relativePos < listStart + 2)
+      continue;
+    if (body.slice(listStart, body.indexOf(lines[i], listStart)).match(/^\s+-/)) {
+      continue;
+    }
+    insertIdx = body.indexOf(lines[i], listStart);
+    break;
+  }
+  if (insertIdx === -1)
+    insertIdx = body.length;
+  const missingBlock = [
+    "missing_source_knowledge_ids:",
+    ...missingIds.map((id) => `  - ${id}`),
+    ""
+  ].join(`
+`);
+  const newBody = body.slice(0, insertIdx) + missingBlock + body.slice(insertIdx);
+  const prefix = stripped.slice(0, fenceLen);
+  const suffix = stripped.slice(closeStart);
+  return prefix + newBody + suffix;
+}
 async function stampSourceEntries(directory, slug, ids) {
   if (!ids || ids.length === 0)
-    return;
+    return { stamped: [], missing: [] };
   const swarmPath = resolveSwarmKnowledgePath(directory);
   const swarm = await readKnowledge(swarmPath);
   const idSet = new Set(ids);
-  let touched = false;
+  const stamped = [];
+  const missing = [];
+  const found = new Set;
   const repoRel = activeRepoRelativePath(slug);
   for (const e of swarm) {
     if (!idSet.has(e.id))
       continue;
+    found.add(e.id);
     e.generated_skill_slug = slug;
     e.generated_skill_path = repoRel;
     e.updated_at = new Date().toISOString();
-    touched = true;
   }
-  if (touched)
+  if (found.size > 0)
     await rewriteKnowledge(swarmPath, swarm);
+  stamped.push(...found);
   const hivePath = resolveHiveKnowledgePath();
-  if (!existsSync3(hivePath))
-    return;
+  if (!existsSync3(hivePath)) {
+    for (const id of ids) {
+      if (!found.has(id))
+        missing.push(id);
+    }
+    return { stamped, missing };
+  }
   const hive = await readKnowledge(hivePath);
-  let touchedHive = false;
+  const foundHive = new Set;
   for (const e of hive) {
     if (!idSet.has(e.id))
       continue;
+    foundHive.add(e.id);
     e.generated_skill_slug = slug;
     e.generated_skill_path = repoRel;
     e.updated_at = new Date().toISOString();
-    touchedHive = true;
   }
-  if (touchedHive)
+  if (foundHive.size > 0)
     await rewriteKnowledge(hivePath, hive);
+  stamped.push(...foundHive);
+  const allFound = new Set([...found, ...foundHive]);
+  for (const id of ids) {
+    if (!allFound.has(id))
+      missing.push(id);
+  }
+  return { stamped, missing };
 }
 function parseDraftFrontmatter(content) {
   const stripped = content.charCodeAt(0) === 65279 ? content.slice(1) : content;

package/dist/cli/{index-ds057q5k.js → index-6k31ysgd.js}

@@ -12,14 +12,14 @@ import {
   detectPosixWrites,
   detectWindowsWrites,
   resolveWriteTargets
-} from "./index-g6f4tt38.js";
+} from "./index-9w07ye9b.js";
 import {
   checkFileAuthority,
   classifyFile,
   isInDeclaredScope,
   redactPath,
   redactShellCommand
-} from "./index-g00qm2gf.js";
+} from "./index-6tnmt41c.js";
 
 // src/services/guardrail-explain-service.ts
 import path from "path";

package/dist/cli/{index-g00qm2gf.js → index-6tnmt41c.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   stripKnownSwarmPrefix
-} from "./index-0asbrmdx.js";
+} from "./index-123s7kjc.js";
 import {
   init_logger,
   warn