opencode-swarm 7.109.4 → 7.110.1

package/dist/cli/{index-p5vm9gy9.js → index-5rfxzgmt.js}

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

package/dist/cli/{index-41fgssqr.js → index-c483hnn4.js}

@@ -6,10 +6,10 @@ import {
   resolveSwarmKnowledgePath,
   resolveSwarmRejectedPath,
   transactKnowledge
-} from "./index-8f10r7ay.js";
+} from "./index-v8pk35h7.js";
 import {
   resolveKnowledgeStoreDir
-} from "./index-2nt4mq9n.js";
+} from "./index-40h0yp9e.js";
 import {
   init_logger,
   warn

package/dist/cli/{index-b15qbvph.js → index-cmjq1kg7.js}

@@ -1,19 +1,22 @@
 // @bun
-import {
-  effectiveRetrievalOutcomes,
-  readKnowledgeCounterRollups
-} from "./index-y5z2qdvk.js";
 import {
   ALLOWED_SKILL_PATH_PREFIXES,
   validateSkillPath
-} from "./index-41fgssqr.js";
+} from "./index-c483hnn4.js";
+import {
+  effectiveRetrievalOutcomes,
+  readKnowledgeCounterRollups
+} from "./index-yhmt3dw3.js";
 import {
   computeOutcomeSignal,
   readKnowledge,
   resolveHiveKnowledgePath,
   resolveSwarmKnowledgePath,
   transactKnowledge
-} from "./index-8f10r7ay.js";
+} from "./index-v8pk35h7.js";
+import {
+  isActiveStatus
+} from "./index-bfwt3abw.js";
 import {
   init_logger,
   warn
@@ -587,31 +590,33 @@ function clusterEntries(entries) {
     if (c.members.length < MIN_CLUSTER_SIZE && !isSkillSingletonEligible(c.members[0])) {
       continue;
     }
-    const arr = c.members;
-    const triggers = uniqueStrings(arr.flatMap((e) => e.triggers ?? []));
-    const required = uniqueStrings(arr.flatMap((e) => e.required_actions ?? []));
-    const forbidden = uniqueStrings(arr.flatMap((e) => e.forbidden_actions ?? []));
-    const agents = uniqueStrings(arr.flatMap((e) => e.applies_to_agents ?? []));
-    const checks = uniqueStrings(arr.flatMap((e) => e.verification_checks ?? []));
-    const avgConf = arr.reduce((s, e) => s + e.confidence, 0) / Math.max(1, arr.length);
-    const slugSeed = triggers[0] ?? required[0] ?? arr[0]?.tags?.[0] ?? arr[0]?.category ?? "lesson";
-    const slug = sanitizeSlug(slugSeed);
-    const title = triggers[0] ?? required[0] ?? `Lessons: ${arr[0]?.category ?? "general"} (${arr.length})`;
-    result.push({
-      slug: isValidSlug2(slug) ? slug : sanitizeSlug(`cluster-${slugSeed.slice(0, 12)}`),
-      title,
-      entries: arr,
-      triggers,
-      required_actions: required,
-      forbidden_actions: forbidden,
-      target_agents: agents,
-      verification_checks: checks,
-      avgConfidence: avgConf
-    });
+    result.push(buildKnowledgeCluster(c.members));
   }
   result.sort((a, b) => b.entries.length - a.entries.length || b.avgConfidence - a.avgConfidence || a.slug.localeCompare(b.slug));
   return result;
 }
+function buildKnowledgeCluster(entries) {
+  const triggers = uniqueStrings(entries.flatMap((e) => e.triggers ?? []));
+  const required = uniqueStrings(entries.flatMap((e) => e.required_actions ?? []));
+  const forbidden = uniqueStrings(entries.flatMap((e) => e.forbidden_actions ?? []));
+  const agents = uniqueStrings(entries.flatMap((e) => e.applies_to_agents ?? []));
+  const checks = uniqueStrings(entries.flatMap((e) => e.verification_checks ?? []));
+  const avgConf = entries.reduce((s, e) => s + e.confidence, 0) / Math.max(1, entries.length);
+  const slugSeed = triggers[0] ?? required[0] ?? entries[0]?.tags?.[0] ?? entries[0]?.category ?? "lesson";
+  const slug = sanitizeSlug(slugSeed);
+  const title = triggers[0] ?? required[0] ?? `Lessons: ${entries[0]?.category ?? "general"} (${entries.length})`;
+  return {
+    slug: isValidSlug2(slug) ? slug : sanitizeSlug(`cluster-${slugSeed.slice(0, 12)}`),
+    title,
+    entries,
+    triggers,
+    required_actions: required,
+    forbidden_actions: forbidden,
+    target_agents: agents,
+    verification_checks: checks,
+    avgConfidence: avgConf
+  };
+}
 function isSkillSingletonEligible(entry) {
   if (!entry)
     return false;
@@ -734,20 +739,24 @@ async function generateSkills(req) {
     minConfirmations
   });
   let pool;
+  let clusters;
   if (req.sourceKnowledgeIds && req.sourceKnowledgeIds.length > 0) {
-    const idSet = new Set(req.sourceKnowledgeIds);
+    const requestedIds = [...new Set(req.sourceKnowledgeIds)];
+    const idSet = new Set(requestedIds);
+    const idOrder = new Map(requestedIds.map((id, index) => [id, index]));
     const swarm = await readKnowledge(resolveSwarmKnowledgePath(req.directory));
     const hivePath = resolveHiveKnowledgePath();
     const hive = existsSync2(hivePath) ? await readKnowledge(hivePath) : [];
     const rollups = await readKnowledgeCounterRollups(req.directory);
-    pool = [...swarm, ...hive].filter((e) => idSet.has(e.id) && e.status !== "archived").map((e) => ({
+    pool = [...swarm, ...hive].filter((e) => idSet.has(e.id) && isActiveStatus(e.status)).sort((a, b) => (idOrder.get(a.id) ?? 0) - (idOrder.get(b.id) ?? 0)).map((e) => ({
       ...e,
       retrieval_outcomes: effectiveRetrievalOutcomes(e.retrieval_outcomes, rollups.get(e.id))
     }));
+    clusters = pool.length > 0 ? [buildKnowledgeCluster(pool)] : [];
   } else {
     pool = candidates;
+    clusters = clusterEntries(pool);
   }
-  const clusters = clusterEntries(pool);
   const result = { written: [], skipped: [] };
   for (let i = 0;i < clusters.length; i++) {
     const cluster = clusters[i];
@@ -1655,16 +1664,16 @@ async function regenerateSkill(directory, slug, options = {}) {
     }
   }
   if (matchedEntries.length > 0) {
-    const activeEntries = matchedEntries.filter((e) => e.status !== "archived");
+    const activeEntries = matchedEntries.filter((e) => isActiveStatus(e.status));
     if (activeEntries.length === 0) {
       try {
-        await _internals.retireSkill(directory, cleanSlug, "auto-retire: all matched source knowledge entries archived at regeneration time");
+        await _internals.retireSkill(directory, cleanSlug, "auto-retire: all matched source knowledge entries inactive at regeneration time");
       } catch {}
       return {
         regenerated: false,
         path: skillPath,
         entryCount: 0,
-        reason: "all matched source knowledge archived \u2014 skill retired",
+        reason: "all matched source knowledge inactive \u2014 skill retired",
         retired: true
       };
     }
@@ -1806,4 +1815,4 @@ var _internals = {
   clearRetiredSkillLinks
 };
 
-export { appendSkillChangelog, evaluateSkillChange, appendRejectedSkillEdit, sanitizeSlug, isValidSlug2 as isValidSlug, proposalPath, activePath, activeRepoRelativePath, proposalRepoRelativePath, generateEvalStub, writeEvalStub, 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, clearDraftSkillLinks, clearRetiredSkillLinks, markSkillStale, clearSkillStale, retireOrMarkStale, regenerateSkill, _internals };
+export { appendSkillChangelog, evaluateSkillChange, appendRejectedSkillEdit, sanitizeSlug, isValidSlug2 as isValidSlug, proposalPath, activePath, activeRepoRelativePath, proposalRepoRelativePath, generateEvalStub, writeEvalStub, DEFAULT_SKILL_MIN_CONFIDENCE, DEFAULT_SKILL_MIN_CONFIRMATIONS, STRONG_SKILL_OUTCOME_COUNT, HIGH_PRIORITY_SKILL_MIN_CONFIDENCE, selectCandidateEntries, isSkillMaturityEligible, clusterEntries, buildKnowledgeCluster, renderSkillMarkdown, generateSkills, parseDraftFrontmatter, activateProposal, findSkillsBySourceKnowledgeId, findStaleSkillsBySourceKnowledgeId, listSkills, autoApplyProposals, inspectSkill, retireSkill, clearDraftSkillLinks, clearRetiredSkillLinks, markSkillStale, clearSkillStale, retireOrMarkStale, regenerateSkill, _internals };

package/dist/cli/{index-09xpycan.js → index-jt58s751.js}

@@ -382,7 +382,7 @@ Append exactly one fenced JSON block after SUMMARY. This block is the executable
 {
   "summary": "3-line executive summary for architect briefing",
   "curation_recommendations": [
-    {"action": "promote", "entry_id": "<uuid or omit for new>", "lesson": "concise lesson text", "reason": "evidence-backed reason", "category": "process", "confidence": 0.8}
+    {"action": "promote", "entry_id": "<full uuid, unique 8+ hex prefix, or omit for new>", "lesson": "concise lesson text", "reason": "evidence-backed reason", "category": "process", "confidence": 0.8, "applies_to_agents": ["coder"], "required_actions": ["concrete required action"], "triggers": ["short trigger phrase"], "directive_priority": "medium"}
   ],
   "queue_triage": [
     {"proposal_id": "proposal-slug", "action": "apply", "reason": "one-line reason"}

package/dist/cli/{index-mtzjbaaa.js → index-mvg66d9n.js}

@@ -4,7 +4,7 @@ import {
   countEntryViolationsInWindow,
   readKnowledgeEvents,
   recordKnowledgeEvent
-} from "./index-y5z2qdvk.js";
+} from "./index-yhmt3dw3.js";
 import {
   jaccardBigram,
   readKnowledge,
@@ -12,7 +12,7 @@ import {
   resolveSwarmKnowledgePath,
   transactKnowledge,
   wordBigrams
-} from "./index-8f10r7ay.js";
+} from "./index-v8pk35h7.js";
 import {
   isActiveStatus
 } from "./index-bfwt3abw.js";
@@ -188,7 +188,7 @@ async function maybeQuarantineOnContradiction(directory, entryId, threshold, win
         alreadyInactive: true
       };
     }
-    const { quarantineEntry } = await import("./knowledge-validator-b9nvmzjc.js");
+    const { quarantineEntry } = await import("./knowledge-validator-bqr936sg.js");
     await quarantineEntry(directory, entryId, `repeat_contradiction: ${count} contradicted events in ${windowDays}d`, "auto");
     return { quarantined: true, entryId, contradictionsInWindow: count };
   } catch {

package/dist/cli/{index-nvmy7xmj.js → index-r3ck99jh.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-zh3qh6m7.js";
+} from "./index-1k5arp07.js";
 import {
   handleGuardrailLog
-} from "./index-p5vm9gy9.js";
+} from "./index-5rfxzgmt.js";
 import {
   COMMAND_REGISTRY,
   SWARM_COMMAND_TOOL_ALLOWLIST,
@@ -80,27 +80,27 @@ import {
   handleWriteRetroCommand,
   normalizeSwarmCommandInput,
   resolveCommand
-} from "./index-y3nx3ss0.js";
-import"./index-d3txrx5q.js";
-import"./index-mtzjbaaa.js";
+} from "./index-5d0t7npd.js";
+import"./index-53z1afgh.js";
 import"./index-c8s9a3zh.js";
-import"./index-zjh648z4.js";
-import"./index-j2v3w1ds.js";
-import"./index-scww5b77.js";
-import"./index-yw8qpf51.js";
-import"./index-85bacexr.js";
-import"./index-09xpycan.js";
+import"./index-xddysq89.js";
 import {
   AGENT_TOOL_MAP,
   ORCHESTRATOR_NAME,
   stripKnownSwarmPrefix
-} from "./index-18690p15.js";
-import"./index-b15qbvph.js";
-import"./index-y5z2qdvk.js";
-import"./index-41fgssqr.js";
-import"./index-8f10r7ay.js";
-import"./index-2nt4mq9n.js";
+} from "./index-0g5xsrp4.js";
+import"./index-j2v3w1ds.js";
+import"./index-scww5b77.js";
+import"./index-yw8qpf51.js";
+import"./index-85bacexr.js";
+import"./index-cmjq1kg7.js";
+import"./index-c483hnn4.js";
+import"./index-mvg66d9n.js";
+import"./index-yhmt3dw3.js";
+import"./index-v8pk35h7.js";
 import"./index-bfwt3abw.js";
+import"./index-40h0yp9e.js";
+import"./index-jt58s751.js";
 import"./index-wvrj16f0.js";
 import"./index-q1exe2b3.js";
 import"./index-x2q0gnt8.js";

package/dist/cli/{index-8f10r7ay.js → index-v8pk35h7.js}

@@ -1,10 +1,10 @@
 // @bun
-import {
-  resolveKnowledgeStoreDir
-} from "./index-2nt4mq9n.js";
 import {
   isActiveStatus
 } from "./index-bfwt3abw.js";
+import {
+  resolveKnowledgeStoreDir
+} from "./index-40h0yp9e.js";
 import {
   readCachedParsedFile
 } from "./index-jtqkh8jf.js";
@@ -525,7 +525,7 @@ async function applyConfidenceFloorAction(directory, touched, options) {
   const recovered = touched.filter((e) => e.confidence > CONFIDENCE_FLOOR + FLOOR_EPSILON && e.confidence_floor_demoted);
   if (atFloor.length === 0 && recovered.length === 0)
     return;
-  const { readKnowledgeCounterRollups, effectiveRetrievalOutcomes } = await import("./knowledge-events-ymysgtrr.js");
+  const { readKnowledgeCounterRollups, effectiveRetrievalOutcomes } = await import("./knowledge-events-bckbj6ah.js");
   const rollups = await readKnowledgeCounterRollups(directory);
   const flagIds = new Set;
   for (const e of atFloor) {
@@ -592,7 +592,7 @@ async function applyConfidenceFloorAction(directory, touched, options) {
     });
   }
   if (action === "quarantine" && toQuarantine.length > 0) {
-    const { quarantineEntry } = await import("./knowledge-validator-b9nvmzjc.js");
+    const { quarantineEntry } = await import("./knowledge-validator-bqr936sg.js");
     for (const { id } of toQuarantine) {
       await quarantineEntry(directory, id, "confidence_floor_negative_outcome", "auto").catch((err) => {
         console.warn("[knowledge-store] confidence-floor quarantine failed (best-effort):", err instanceof Error ? err.message : String(err));

package/dist/cli/{index-zjh648z4.js → index-xddysq89.js}

@@ -5,7 +5,7 @@ import {
   GateConfigSchema,
   PluginConfigSchema,
   stripKnownSwarmPrefix
-} from "./index-18690p15.js";
+} from "./index-0g5xsrp4.js";
 import {
   log
 } from "./index-zgwm4ryv.js";

package/dist/cli/{index-y5z2qdvk.js → index-yhmt3dw3.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   resolveKnowledgeStoreDir
-} from "./index-2nt4mq9n.js";
+} from "./index-40h0yp9e.js";
 import {
   init_logger,
   warn
@@ -594,7 +594,7 @@ async function applyKnowledgeVerdictFeedback(directory, options) {
       deltas.push({ id, delta });
     }
     if (deltas.length > 0) {
-      const { bumpKnowledgeConfidenceBatch } = await import("./knowledge-store-562fefjy.js");
+      const { bumpKnowledgeConfidenceBatch } = await import("./knowledge-store-dvjbdn00.js");
       await bumpKnowledgeConfidenceBatch(directory, deltas, options?.floorOptions);
     }
     return {

package/dist/cli/index.js

@@ -7,25 +7,25 @@ import {
   getPluginLockFilePaths,
   package_default,
   resolveCommand
-} from "./index-y3nx3ss0.js";
-import"./index-d3txrx5q.js";
-import"./index-mtzjbaaa.js";
+} from "./index-5d0t7npd.js";
+import"./index-53z1afgh.js";
 import"./index-c8s9a3zh.js";
-import"./index-zjh648z4.js";
+import"./index-xddysq89.js";
+import {
+  DEFAULT_AGENT_CONFIGS
+} from "./index-0g5xsrp4.js";
 import"./index-j2v3w1ds.js";
 import"./index-scww5b77.js";
 import"./index-yw8qpf51.js";
 import"./index-85bacexr.js";
-import"./index-09xpycan.js";
-import {
-  DEFAULT_AGENT_CONFIGS
-} from "./index-18690p15.js";
-import"./index-b15qbvph.js";
-import"./index-y5z2qdvk.js";
-import"./index-41fgssqr.js";
-import"./index-8f10r7ay.js";
-import"./index-2nt4mq9n.js";
+import"./index-cmjq1kg7.js";
+import"./index-c483hnn4.js";
+import"./index-mvg66d9n.js";
+import"./index-yhmt3dw3.js";
+import"./index-v8pk35h7.js";
 import"./index-bfwt3abw.js";
+import"./index-40h0yp9e.js";
+import"./index-jt58s751.js";
 import"./index-wvrj16f0.js";
 import"./index-q1exe2b3.js";
 import"./index-x2q0gnt8.js";

package/dist/cli/{knowledge-escalator-9ksrgq7h.js → knowledge-escalator-0dkkenp2.js}

@@ -8,11 +8,11 @@ import {
   maybeEscalateOnViolation,
   maybeQuarantineOnContradiction,
   readRecentEscalations
-} from "./index-mtzjbaaa.js";
-import"./index-y5z2qdvk.js";
-import"./index-8f10r7ay.js";
-import"./index-2nt4mq9n.js";
+} from "./index-mvg66d9n.js";
+import"./index-yhmt3dw3.js";
+import"./index-v8pk35h7.js";
 import"./index-bfwt3abw.js";
+import"./index-40h0yp9e.js";
 import"./index-jtqkh8jf.js";
 import"./index-zgwm4ryv.js";
 import"./index-1cn967sa.js";

package/dist/cli/{knowledge-events-ymysgtrr.js → knowledge-events-bckbj6ah.js}

@@ -25,8 +25,8 @@ import {
   resolveKnowledgeCounterBaselinePath,
   resolveKnowledgeEventsPath,
   resolveLegacyApplicationLogPath
-} from "./index-y5z2qdvk.js";
-import"./index-2nt4mq9n.js";
+} from "./index-yhmt3dw3.js";
+import"./index-40h0yp9e.js";
 import"./index-zgwm4ryv.js";
 import"./index-1cn967sa.js";
 import"./index-5mkc2f9z.js";

package/dist/cli/{knowledge-store-562fefjy.js → knowledge-store-dvjbdn00.js}

@@ -32,10 +32,11 @@ import {
   transactFile,
   transactKnowledge,
   wordBigrams
-} from "./index-8f10r7ay.js";
-import"./index-2nt4mq9n.js";
+} from "./index-v8pk35h7.js";
 import"./index-bfwt3abw.js";
+import"./index-40h0yp9e.js";
 import"./index-jtqkh8jf.js";
+import"./index-zgwm4ryv.js";
 import"./index-1cn967sa.js";
 import"./index-5mkc2f9z.js";
 import"./index-vn263hqt.js";

package/dist/cli/{knowledge-validator-b9nvmzjc.js → knowledge-validator-bqr936sg.js}

@@ -22,10 +22,10 @@ import {
   validateLesson,
   validateSkillCandidatePath,
   validateSkillPath
-} from "./index-41fgssqr.js";
-import"./index-8f10r7ay.js";
-import"./index-2nt4mq9n.js";
+} from "./index-c483hnn4.js";
+import"./index-v8pk35h7.js";
 import"./index-bfwt3abw.js";
+import"./index-40h0yp9e.js";
 import"./index-jtqkh8jf.js";
 import"./index-zgwm4ryv.js";
 import"./index-1cn967sa.js";

package/dist/cli/{schema-5vmb5dh8.js → schema-s48je8zt.js}

@@ -86,7 +86,7 @@ import {
   resolveGeneratedAgentRole,
   resolveGuardrailsConfig,
   stripKnownSwarmPrefix
-} from "./index-18690p15.js";
+} from "./index-0g5xsrp4.js";
 import"./index-bfwt3abw.js";
 import"./index-p0arc26j.js";
 import"./index-293f68mj.js";

package/dist/cli/{skill-generator-mjfqvnn0.js → skill-generator-5rsjmmfq.js}

@@ -9,6 +9,7 @@ import {
   activePath,
   activeRepoRelativePath,
   autoApplyProposals,
+  buildKnowledgeCluster,
   clearDraftSkillLinks,
   clearRetiredSkillLinks,
   clearSkillStale,
@@ -32,12 +33,12 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-b15qbvph.js";
-import"./index-y5z2qdvk.js";
-import"./index-41fgssqr.js";
-import"./index-8f10r7ay.js";
-import"./index-2nt4mq9n.js";
+} from "./index-cmjq1kg7.js";
+import"./index-c483hnn4.js";
+import"./index-yhmt3dw3.js";
+import"./index-v8pk35h7.js";
 import"./index-bfwt3abw.js";
+import"./index-40h0yp9e.js";
 import"./index-jtqkh8jf.js";
 import"./index-zgwm4ryv.js";
 import"./index-1cn967sa.js";
@@ -70,6 +71,7 @@ export {
   clearSkillStale,
   clearRetiredSkillLinks,
   clearDraftSkillLinks,
+  buildKnowledgeCluster,
   autoApplyProposals,
   activeRepoRelativePath,
   activePath,

package/dist/config/bundled-skills.d.ts

@@ -1,4 +1,4 @@
-export declare const BUNDLED_PROJECT_SKILLS: readonly ["brainstorm", "specify", "clarify-spec", "resume", "clarify", "discover", "consult", "pre-phase-briefing", "council", "deep-dive", "deep-research", "codebase-review-swarm", "swarm-implement", "design-docs", "swarm-pr-review", "swarm-pr-feedback", "swarm-pr-subscribe", "issue-ingest", "plan", "critic-gate", "execute", "phase-wrap", "loop", "writing-tests", "running-tests", "engineering-conventions", "commit-pr", "worktree-retry-cleanup", "skill-edit-validation", "merge-queue-readiness", "gate-attribution", "ci-failure-batching"];
+export declare const BUNDLED_PROJECT_SKILLS: readonly ["brainstorm", "specify", "clarify-spec", "resume", "clarify", "discover", "consult", "pre-phase-briefing", "council", "deep-dive", "deep-research", "codebase-review-swarm", "swarm-implement", "design-docs", "swarm-pr-review", "swarm", "swarm-pr-feedback", "swarm-pr-subscribe", "swarm-ci-monitor", "issue-ingest", "plan", "critic-gate", "execute", "phase-wrap", "loop", "writing-tests", "running-tests", "engineering-conventions", "commit-pr", "worktree-retry-cleanup", "skill-edit-validation", "merge-queue-readiness", "gate-attribution", "ci-failure-batching"];
 interface CopyState {
     files: number;
     bytes: number;

package/dist/hooks/curator-postmortem.d.ts

@@ -11,7 +11,7 @@
  * Outputs route through existing gated paths (knowledge_add, skill proposals,
  * hive promotion) — no new ungated injection source.
  */
-import type { CuratorLLMDelegate } from './curator.js';
+import { type CuratorLLMDelegate } from './curator.js';
 import type { KnowledgeRecommendation } from './curator-types.js';
 import type { KnowledgeConfig, SwarmKnowledgeEntry } from './knowledge-types.js';
 export interface PostMortemResult {
@@ -49,6 +49,14 @@ interface ParsedPostMortemActions {
     }>;
     diagnostics: string[];
 }
+type KnowledgeActionVerificationStatus = 'new_entry' | 'exact_match' | 'prefix_match' | 'not_found' | 'ambiguous_prefix' | 'missing_entry_id';
+interface KnowledgeActionVerification {
+    action: KnowledgeRecommendation['action'];
+    input_entry_id: string | null;
+    resolved_entry_id: string | null;
+    status: KnowledgeActionVerificationStatus;
+    reason: string;
+}
 export interface PostMortemActionResult {
     knowledge_applied: number;
     knowledge_skipped: number;
@@ -65,6 +73,22 @@ declare function executePostMortemActions(directory: string, parsed: ParsedPostM
     result: PostMortemActionResult;
     warnings: string[];
 }>;
+declare function verifyPostMortemKnowledgeActions(directory: string, recommendations: KnowledgeRecommendation[]): Promise<KnowledgeActionVerification[]>;
+declare function buildStateFreshnessSection(args: {
+    planId: string;
+    scope: 'session' | 'project';
+    sessionID?: string;
+    planLoaded: boolean;
+    knowledgeSummary: KnowledgeEventSummary[];
+    proposals: Array<{
+        source: string;
+        content: string;
+    }>;
+    unactionable: unknown[];
+    retrospectives: string[];
+    driftReports: string[];
+}): string;
+declare function buildActionVerificationSection(verification: KnowledgeActionVerification[]): string;
 declare function repairPostMortemActions(llmOutput: string, diagnostics: string[], options: PostMortemOptions): Promise<ParsedPostMortemActions | null>;
 declare function readJsonlFile(filePath: string, maxLines?: number): unknown[];
 declare function collectRetrospectives(directory: string): string[];
@@ -81,7 +105,11 @@ declare function acquirePostMortemLock(directory: string, planId: string): Promi
 declare function buildDataOnlyReport(planId: string, planSummary: string, knowledgeSummary: KnowledgeEventSummary[], curatorDigest: string | null, proposals: Array<{
     source: string;
     content: string;
-}>, unactionable: unknown[], retrospectives: string[], driftReports: string[]): string;
+}>, unactionable: unknown[], retrospectives: string[], driftReports: string[], context?: {
+    scope: 'session' | 'project';
+    sessionID?: string;
+    planLoaded: boolean;
+}): string;
 declare function assembleLLMInput(planId: string, scope: 'session' | 'project', sessionID: string | undefined, planSummary: string, knowledgeSummary: KnowledgeEventSummary[], curatorDigest: string | null, proposals: Array<{
     source: string;
     content: string;
@@ -96,9 +124,12 @@ export declare const _internals: {
     readJsonlFile: typeof readJsonlFile;
     buildDataOnlyReport: typeof buildDataOnlyReport;
     assembleLLMInput: typeof assembleLLMInput;
+    buildStateFreshnessSection: typeof buildStateFreshnessSection;
+    buildActionVerificationSection: typeof buildActionVerificationSection;
     isReportValid: typeof isReportValid;
     parsePostMortemActions: typeof parsePostMortemActions;
     executePostMortemActions: typeof executePostMortemActions;
+    verifyPostMortemKnowledgeActions: typeof verifyPostMortemKnowledgeActions;
     repairPostMortemActions: typeof repairPostMortemActions;
     loadDefaultKnowledgeConfig: () => Promise<KnowledgeConfig>;
     applyCuratorKnowledgeUpdates: (directory: string, recommendations: KnowledgeRecommendation[], knowledgeConfig: KnowledgeConfig) => Promise<{

package/dist/hooks/curator-types.d.ts

@@ -2,7 +2,7 @@
  * Curator types — phase context consolidation and drift detection.
  * No runtime logic. Types only.
  */
-import type { KnowledgeCategory } from './knowledge-types.js';
+import type { ActionableDirectiveFields, KnowledgeCategory } from './knowledge-types.js';
 /** Curator summary — anchored iterative format. Persisted to .swarm/curator-summary.json */
 export interface CuratorSummary {
     schema_version: 1;
@@ -35,7 +35,7 @@ export interface ComplianceObservation {
     description: string;
     severity: 'info' | 'warning';
 }
-export interface KnowledgeRecommendation {
+export interface KnowledgeRecommendation extends Pick<ActionableDirectiveFields, 'triggers' | 'required_actions' | 'forbidden_actions' | 'applies_to_agents' | 'applies_to_tools' | 'verification_checks' | 'directive_priority'> {
     action: 'promote' | 'archive' | 'flag_contradiction' | 'rewrite';
     entry_id?: string;
     lesson: string;

package/dist/hooks/curator.d.ts

@@ -58,10 +58,11 @@ export declare const _internals: {
     readLatestPostMortemDigest: (directory: string) => string | null;
 };
 export interface RecommendationParseDiagnostic {
-    section: 'OBSERVATIONS';
+    section: 'OBSERVATIONS' | 'RECOMMENDATION_ID';
     line: string;
     reason: string;
 }
+export declare function normalizeRecommendationEntryIdToken(token: string): string | undefined;
 /**
  * Auto-retire generated skills whose violation rate exceeds 30% or
  * whose source knowledge entries are all archived.

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

@@ -37,6 +37,13 @@ export interface LinkPointer {
     /** How the link was established. */
     source: 'manual' | 'auto';
 }
+export interface LinkedLocalKnowledgeStatus {
+    linked: boolean;
+    orphaned: boolean;
+    localKnowledgePath: string;
+    resolvedKnowledgePath: string;
+    reason?: 'not_linked' | 'local_missing' | 'local_symlink' | 'local_regular_file';
+}
 export declare const LINK_POINTER_FILENAME = "link.json";
 /** Root directory under which all shared link stores live: `<dataDir>/links`. */
 export declare function resolveLinkBaseDir(): string;
@@ -50,6 +57,7 @@ export declare function resolveLinkDir(linkId: string): string;
 export declare function sanitizeLinkId(name: string): string | null;
 /** Read and validate the link pointer for a worktree. Null if absent/invalid. */
 export declare function readLinkPointer(directory: string): LinkPointer | null;
+export declare function getLinkedLocalKnowledgeStatus(directory: string): LinkedLocalKnowledgeStatus;
 /** Write the link pointer atomically and invalidate the resolution cache. */
 export declare function writeLinkPointer(directory: string, pointer: LinkPointer): Promise<void>;
 /** Remove the link pointer (idempotent) and invalidate the resolution cache. */
@@ -75,6 +83,7 @@ export declare const _internals: {
     readLinkPointer: typeof readLinkPointer;
     writeLinkPointer: typeof writeLinkPointer;
     removeLinkPointer: typeof removeLinkPointer;
+    getLinkedLocalKnowledgeStatus: typeof getLinkedLocalKnowledgeStatus;
     invalidateKnowledgeStoreDirCache: typeof invalidateKnowledgeStoreDirCache;
     resolveLinkDir: typeof resolveLinkDir;
     resolveLinkBaseDir: typeof resolveLinkBaseDir;

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

@@ -19,6 +19,20 @@ export interface RankedEntry extends KnowledgeEntryBase {
     };
     finalScore: number;
     coldStartBoost?: number;
+    score_breakdown?: {
+        text_score: number;
+        metadata_score: number;
+        directive_score: number;
+        confidence_boost: number;
+        generated_skill_boost: number;
+        outcome_boost: number;
+        cold_start_boost: number;
+        synonym_boost: number;
+        trigger_recall_boost: number;
+        status_boost: number;
+        final_score: number;
+        synonym_matches?: string[];
+    };
 }
 declare function transactShownFile(shownFile: string, mutate: (data: Record<string, string[]>) => Record<string, string[]> | null): Promise<boolean>;
 export declare function readMergedKnowledge(directory: string, config: KnowledgeConfig, context?: ProjectContext, opts?: {