@kaddo/mcp 3.124.4 → 3.125.0

package/dist/index.js

@@ -12121,7 +12121,7 @@ function getPrompt(root, name) {
 }
 
 // src/tools.ts
-import matter20 from "gray-matter";
+import matter23 from "gray-matter";
 
 // ../cli/dist/core.js
 import fs3 from "fs";
@@ -12148,21 +12148,24 @@ import { dirname as dirname2, join as join22, parse as parse2 } from "path";
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
 import matter92 from "gray-matter";
 import matter102 from "gray-matter";
+import { parse as parseYaml82 } from "yaml";
 import matter112 from "gray-matter";
-import { parse as parseYaml82, stringify as stringifyYaml52 } from "yaml";
+import matter122 from "gray-matter";
+import { parse as parseYaml92, stringify as stringifyYaml52 } from "yaml";
 import fs4 from "fs";
 import path4 from "path";
 import crypto2 from "crypto";
-import matter122 from "gray-matter";
+import matter132 from "gray-matter";
 import crypto3 from "crypto";
 import fs5 from "fs";
-import matter132 from "gray-matter";
 import matter142 from "gray-matter";
-import { parse as parseYaml92, stringify as stringifyYaml6 } from "yaml";
-import { parse as parseYaml102, stringify as stringifyYaml7 } from "yaml";
 import matter15 from "gray-matter";
+import { parse as parseYaml102, stringify as stringifyYaml6 } from "yaml";
+import { parse as parseYaml11, stringify as stringifyYaml7 } from "yaml";
 import matter16 from "gray-matter";
 import matter17 from "gray-matter";
+import matter18 from "gray-matter";
+import matter19 from "gray-matter";
 function exists2(p) {
   return fs3.existsSync(p);
 }
@@ -12281,8 +12284,8 @@ function loadConfig2(dir) {
   const parsed = configSchema2.safeParse(raw ?? {});
   if (!parsed.success) {
     const issues = parsed.error.issues.map((i) => {
-      const path62 = i.path.join(".");
-      return path62 ? `  - ${path62}: ${i.message}` : `  - ${i.message}`;
+      const path82 = i.path.join(".");
+      return path82 ? `  - ${path82}: ${i.message}` : `  - ${i.message}`;
     }).join("\n");
     throw new ConfigError2(`Invalid .kaddo/config.yml:
 ${issues}`);
@@ -12486,11 +12489,11 @@ function moduleArtifactCoverage2(dir, id) {
   };
 }
 function loadMappedModules2(dir) {
-  const path62 = join3(dir, DESCRIPTOR_PATH2);
-  if (!exists2(path62)) return [];
+  const path82 = join3(dir, DESCRIPTOR_PATH2);
+  if (!exists2(path82)) return [];
   let parsed;
   try {
-    parsed = parseYaml32(readFile2(path62));
+    parsed = parseYaml32(readFile2(path82));
   } catch {
     return [];
   }
@@ -14223,9 +14226,9 @@ function buildGraph2(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
   ];
   const presentLayers = [];
   for (const layer2 of layerDocs) {
-    const path62 = layer2.files.map((f3) => `${KNOWLEDGE22}/${f3}`).find((rel) => exists2(join3(dir, rel)));
-    if (path62) {
-      addNode({ id: layer2.id, type: layer2.type, label: layer2.label, path: path62 });
+    const path82 = layer2.files.map((f3) => `${KNOWLEDGE22}/${f3}`).find((rel) => exists2(join3(dir, rel)));
+    if (path82) {
+      addNode({ id: layer2.id, type: layer2.type, label: layer2.label, path: path82 });
       presentLayers.push(layer2.id);
     }
   }
@@ -14704,13 +14707,13 @@ function meaningful2(text22) {
   });
 }
 function readPocSummary2(dir) {
-  const path62 = join3(dir, POC_ARTIFACT_PATH2);
-  if (!exists2(path62)) {
+  const path82 = join3(dir, POC_ARTIFACT_PATH2);
+  if (!exists2(path82)) {
     return { exists: false, hypothesisDefined: false, successCriteriaCount: 0, constraintsDefined: false, nonGoalsDefined: false, conclusion: "pending" };
   }
   let markdown = "";
   try {
-    markdown = readFile2(path62);
+    markdown = readFile2(path82);
   } catch {
     return { exists: false, hypothesisDefined: false, successCriteriaCount: 0, constraintsDefined: false, nonGoalsDefined: false, conclusion: "pending" };
   }
@@ -14741,11 +14744,11 @@ function redactSecrets2(value) {
     return line.replace(/([:=]\s*)\S+.*/, "$1[redacted]");
   }).join("\n");
 }
-function source2(dir, path62, kind) {
-  const absolute = join3(dir, path62);
+function source2(dir, path82, kind) {
+  const absolute = join3(dir, path82);
   if (!exists2(absolute)) return null;
   const raw = readFile2(absolute);
-  return { path: posix2(path62), kind, digest: sha2(raw), content: redactSecrets2(raw) };
+  return { path: posix2(path82), kind, digest: sha2(raw), content: redactSecrets2(raw) };
 }
 function reportFiles2(dir) {
   const delivery = join3(dir, "knowledge", "delivery");
@@ -14785,9 +14788,9 @@ function buildPocReportContext2(dir) {
     };
   }
   const sources = [];
-  const add = (path62, kind) => {
-    if (sources.some((item2) => item2.path === posix2(path62))) return;
-    const item = source2(dir, path62, kind);
+  const add = (path82, kind) => {
+    if (sources.some((item2) => item2.path === posix2(path82))) return;
+    const item = source2(dir, path82, kind);
     if (item) sources.push(item);
   };
   add(POC_ARTIFACT_PATH2, "poc");
@@ -14815,7 +14818,7 @@ function buildPocReportContext2(dir) {
   const sourceFingerprint = sha2(sources.map((item) => `${item.path}\0${item.digest}`).join("\n"));
   const status = !latestReport ? "missing" : latestReport.sourceFingerprint === sourceFingerprint ? "current" : "stale";
   const currentManifest = Object.fromEntries(sources.map((item) => [item.path, item.digest]));
-  const changesSinceLatest = status === "stale" ? [.../* @__PURE__ */ new Set([...Object.keys(currentManifest), ...Object.keys(latestReport?.sourceManifest ?? {})])].filter((path62) => currentManifest[path62] !== latestReport?.sourceManifest[path62]).sort() : [];
+  const changesSinceLatest = status === "stale" ? [.../* @__PURE__ */ new Set([...Object.keys(currentManifest), ...Object.keys(latestReport?.sourceManifest ?? {})])].filter((path82) => currentManifest[path82] !== latestReport?.sourceManifest[path82]).sort() : [];
   const sourceList = sources.map((item) => `- ${item.path} (${item.kind})`).join("\n") || "- No sources selected.";
   return {
     eligible: true,
@@ -15968,8 +15971,8 @@ function withResponsibilityTrace2(fileName, content) {
   const skills = renderSkillsSection2(agent);
   const skillsBlock = skills ? `${skills}
 ` : "";
-  const frontmatter = renderFrontmatterRules2(agent);
-  const frontmatterBlock = frontmatter ? `${frontmatter}
+  const frontmatter2 = renderFrontmatterRules2(agent);
+  const frontmatterBlock = frontmatter2 ? `${frontmatter2}
 ` : "";
   return `${content.trimEnd()}
 
@@ -18161,23 +18164,23 @@ var VALID_SOURCES3 = [
 function isValidSource2(s) {
   return VALID_SOURCES3.includes(s);
 }
-function parseWorkItemSource2(frontmatter) {
-  const rawSource = frontmatter.source;
+function parseWorkItemSource2(frontmatter2) {
+  const rawSource = frontmatter2.source;
   if (rawSource != null && typeof rawSource === "object" && !Array.isArray(rawSource)) {
     const obj = rawSource;
     const t = optStr22(obj.type);
     const type = t && isValidSource2(t) ? t : "unknown";
     return {
       type,
-      id: optStr22(obj.id) ?? optStr22(frontmatter.source_id),
-      title: optStr22(obj.title) ?? optStr22(frontmatter.source_title),
-      context: optStr22(obj.context) ?? optStr22(frontmatter.source_context),
-      provider: optStr22(obj.provider) ?? optStr22(frontmatter.source_provider),
-      integration: optStr22(obj.integration) ?? optStr22(frontmatter.source_integration),
-      url: optStr22(obj.url) ?? optStr22(frontmatter.source_url),
-      imported_at: optStr22(obj.imported_at) ?? optStr22(frontmatter.source_imported_at),
-      external_updated_at: optStr22(obj.external_updated_at) ?? optStr22(frontmatter.source_external_updated_at),
-      synced_at: optStr22(obj.synced_at) ?? optStr22(frontmatter.source_synced_at),
+      id: optStr22(obj.id) ?? optStr22(frontmatter2.source_id),
+      title: optStr22(obj.title) ?? optStr22(frontmatter2.source_title),
+      context: optStr22(obj.context) ?? optStr22(frontmatter2.source_context),
+      provider: optStr22(obj.provider) ?? optStr22(frontmatter2.source_provider),
+      integration: optStr22(obj.integration) ?? optStr22(frontmatter2.source_integration),
+      url: optStr22(obj.url) ?? optStr22(frontmatter2.source_url),
+      imported_at: optStr22(obj.imported_at) ?? optStr22(frontmatter2.source_imported_at),
+      external_updated_at: optStr22(obj.external_updated_at) ?? optStr22(frontmatter2.source_external_updated_at),
+      synced_at: optStr22(obj.synced_at) ?? optStr22(frontmatter2.source_synced_at),
       inferred: obj.inferred === true || obj.inferred === "true",
       reason: t && !isValidSource2(t) ? `Invalid source type in object: "${t}".` : void 0
     };
@@ -18186,45 +18189,45 @@ function parseWorkItemSource2(frontmatter) {
   if (raw && isValidSource2(raw)) {
     return {
       type: raw,
-      id: optStr22(frontmatter.source_id),
-      title: optStr22(frontmatter.source_title),
-      context: optStr22(frontmatter.source_context),
-      provider: optStr22(frontmatter.source_provider),
-      url: optStr22(frontmatter.source_url),
-      imported_at: optStr22(frontmatter.source_imported_at),
-      external_updated_at: optStr22(frontmatter.source_external_updated_at),
-      synced_at: optStr22(frontmatter.source_synced_at),
+      id: optStr22(frontmatter2.source_id),
+      title: optStr22(frontmatter2.source_title),
+      context: optStr22(frontmatter2.source_context),
+      provider: optStr22(frontmatter2.source_provider),
+      url: optStr22(frontmatter2.source_url),
+      imported_at: optStr22(frontmatter2.source_imported_at),
+      external_updated_at: optStr22(frontmatter2.source_external_updated_at),
+      synced_at: optStr22(frontmatter2.source_synced_at),
       inferred: false
     };
   }
   if (raw && !isValidSource2(raw)) {
     return {
       type: "unknown",
-      id: optStr22(frontmatter.source_id),
-      title: optStr22(frontmatter.source_title),
-      context: optStr22(frontmatter.source_context),
-      provider: optStr22(frontmatter.source_provider),
-      url: optStr22(frontmatter.source_url),
-      imported_at: optStr22(frontmatter.source_imported_at),
-      external_updated_at: optStr22(frontmatter.source_external_updated_at),
-      synced_at: optStr22(frontmatter.source_synced_at),
+      id: optStr22(frontmatter2.source_id),
+      title: optStr22(frontmatter2.source_title),
+      context: optStr22(frontmatter2.source_context),
+      provider: optStr22(frontmatter2.source_provider),
+      url: optStr22(frontmatter2.source_url),
+      imported_at: optStr22(frontmatter2.source_imported_at),
+      external_updated_at: optStr22(frontmatter2.source_external_updated_at),
+      synced_at: optStr22(frontmatter2.source_synced_at),
       inferred: true,
       reason: `Invalid source value: "${raw}".`
     };
   }
-  if (frontmatter.source_work_item_candidate || frontmatter.source_roadmap_initiative) {
+  if (frontmatter2.source_work_item_candidate || frontmatter2.source_roadmap_initiative) {
     return {
       type: "roadmap",
-      id: optStr22(frontmatter.source_id) ?? optStr22(frontmatter.source_work_item_candidate),
-      title: optStr22(frontmatter.source_initiative_title),
+      id: optStr22(frontmatter2.source_id) ?? optStr22(frontmatter2.source_work_item_candidate),
+      title: optStr22(frontmatter2.source_initiative_title),
       inferred: true,
       reason: "Inferred from legacy roadmap fields."
     };
   }
-  if (frontmatter.source_id) {
+  if (frontmatter2.source_id) {
     return {
       type: "unknown",
-      id: optStr22(frontmatter.source_id),
+      id: optStr22(frontmatter2.source_id),
       inferred: true,
       reason: "Has source_id but no source type."
     };
@@ -18479,6 +18482,9 @@ var LEGACY_STEPS2 = [
   runGuard2,
   captureLearning2
 ];
+var HISTORY_DIR2 = ".kaddo/history";
+var RUNS_PATH2 = `${HISTORY_DIR2}/guard-runs.jsonl`;
+var SUMMARY_PATH2 = `${HISTORY_DIR2}/guard-summary.json`;
 var USER_FACING_KEYWORDS_EN = [
   "user",
   "visitor",
@@ -18665,7 +18671,7 @@ function loadSystemTopology(dir) {
 function parseTopologyContent(raw, dir) {
   let parsed;
   try {
-    parsed = parseYaml82(raw) ?? {};
+    parsed = parseYaml92(raw) ?? {};
   } catch {
     return { entities: [], relationships: [], findings: [{ level: "blocking", message: "The topology could not be parsed." }] };
   }
@@ -18828,8 +18834,8 @@ function parseGraphReason(v) {
   if (!v || typeof v !== "object") return null;
   const o2 = v;
   const relationship = typeof o2.relationship === "string" && o2.relationship.trim() ? o2.relationship.trim() : null;
-  const path62 = Array.isArray(o2.path) ? o2.path.map(String).filter(Boolean) : [];
-  return relationship || path62.length ? { relationship, path: path62 } : null;
+  const path82 = Array.isArray(o2.path) ? o2.path.map(String).filter(Boolean) : [];
+  return relationship || path82.length ? { relationship, path: path82 } : null;
 }
 function parseExplain(o2) {
   const refs = Array.isArray(o2.evidence) ? o2.evidence : Array.isArray(o2.evidence_refs) ? o2.evidence_refs : [];
@@ -18884,7 +18890,7 @@ function parseOriginalSnapshot(fm) {
 function readBody(filePath) {
   try {
     const raw = readFile2(filePath);
-    return matter112(raw).content;
+    return matter122(raw).content;
   } catch {
     return "";
   }
@@ -19084,7 +19090,7 @@ function slugify22(s) {
 function nextWorkItemId(dir) {
   const wiDir = join3(dir, WORK_ITEMS_DIR);
   let max = 0;
-  const walk = (d3) => {
+  const walk2 = (d3) => {
     if (!exists2(d3)) return;
     for (const entry of fs4.readdirSync(d3)) {
       const full = join3(d3, entry);
@@ -19092,11 +19098,11 @@ function nextWorkItemId(dir) {
         const m2 = entry.match(/WI-(\d+)/);
         if (m2) max = Math.max(max, parseInt(m2[1], 10));
       } else if (!entry.startsWith(".")) {
-        walk(full);
+        walk2(full);
       }
     }
   };
-  walk(wiDir);
+  walk2(wiDir);
   return `WI-${String(max + 1).padStart(3, "0")}`;
 }
 function atomicWrite3(filePath, content) {
@@ -19169,7 +19175,7 @@ function ensureH1(body, title) {
 ${trimmed}`;
 }
 function serialize2(data, body) {
-  return matter122.stringify(`
+  return matter132.stringify(`
 ${body.trim()}
 `, data);
 }
@@ -20083,7 +20089,7 @@ function detectFormat(raw) {
   if (!trimmed) throw new ImportError("EMPTY_INPUT", "Import content is empty.");
   if (trimmed.startsWith("---")) {
     try {
-      const { data } = matter132(trimmed);
+      const { data } = matter142(trimmed);
       if (data && typeof data === "object" && Object.keys(data).length > 0) {
         const d3 = data;
         if (d3.type === "work-item" || d3.id && typeof d3.id === "string" && /^WI-\d+/.test(d3.id)) {
@@ -20105,7 +20111,7 @@ function parseContent(raw) {
   let bodyText = trimmed;
   if (format === "kaddo-frontmatter" || format === "markdown-frontmatter") {
     try {
-      const parsed = matter132(trimmed);
+      const parsed = matter142(trimmed);
       frontmatterFields = parsed.data ?? {};
       bodyText = parsed.content.trim();
     } catch {
@@ -20202,7 +20208,7 @@ function findDuplicateByHash(dir, hash) {
     const raw = readFile2(item.filePath);
     if (!raw) continue;
     try {
-      const { data } = matter132(raw);
+      const { data } = matter142(raw);
       const source22 = data?.source;
       if (source22 && typeof source22 === "object" && !Array.isArray(source22)) {
         const s = source22;
@@ -20711,8 +20717,8 @@ async function handleJiraResponse(res) {
   }
   return await res.json();
 }
-async function jiraFetch(baseUrl, path62, auth, timeoutMs, params) {
-  const url = new URL(path62, baseUrl + "/");
+async function jiraFetch(baseUrl, path82, auth, timeoutMs, params) {
+  const url = new URL(path82, baseUrl + "/");
   if (params) for (const [k2, v] of Object.entries(params)) url.searchParams.set(k2, v);
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), timeoutMs);
@@ -20730,8 +20736,8 @@ async function jiraFetch(baseUrl, path62, auth, timeoutMs, params) {
     clearTimeout(timer);
   }
 }
-async function jiraPost(baseUrl, path62, auth, timeoutMs, body) {
-  const url = new URL(path62, baseUrl + "/");
+async function jiraPost(baseUrl, path82, auth, timeoutMs, body) {
+  const url = new URL(path82, baseUrl + "/");
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), timeoutMs);
   try {
@@ -20918,7 +20924,7 @@ function persistConsent(dir, consent) {
   const configPath = join3(dir, ".kaddo", "config.yml");
   if (!exists2(configPath)) return;
   const raw = readFile2(configPath);
-  const doc = parseYaml102(raw) ?? {};
+  const doc = parseYaml11(raw) ?? {};
   const prev = doc.telemetry ?? {};
   delete prev.enabled;
   doc.telemetry = { ...prev, consent, consentVersion: CURRENT_CONSENT_VERSION };
@@ -21097,7 +21103,7 @@ function buildInitiativeContent(id, input) {
   if (input.priority) data.priority = input.priority;
   if (input.source) data.source = input.source;
   if (input.sourceId) data.source_id = input.sourceId;
-  return matter15.stringify("\n" + (input.body ?? defaultBody(input.title.trim())), data);
+  return matter16.stringify("\n" + (input.body ?? defaultBody(input.title.trim())), data);
 }
 function createInitiative(dir, input) {
   if (!input.title?.trim()) throw new InitiativeWriteError("Initiative title is required.");
@@ -21121,10 +21127,10 @@ function transitionInitiative(dir, id, to) {
     throw new InitiativeWriteError(`Invalid transition ${ini.status} \u2192 ${to}.`);
   }
   const raw = readFile2(ini.filePath);
-  const { data, content } = matter15(raw, {});
+  const { data, content } = matter16(raw, {});
   data.status = to;
   if (to === "completed") data.completed_at = today2();
-  const newContent = matter15.stringify(content, data);
+  const newContent = matter16.stringify(content, data);
   writeFile2(ini.filePath, newContent);
   const updated = parseInitiative2(dir, ini.filePath, newContent);
   if (!updated) throw new InitiativeWriteError("Failed to parse the Initiative after transition.");
@@ -21134,7 +21140,7 @@ function addCandidate(dir, id, candidate) {
   const ini = getInitiative(dir, id);
   if (!ini) throw new InitiativeWriteError(`Initiative ${id} not found.`);
   const raw = readFile2(ini.filePath);
-  const { data, content } = matter15(raw, {});
+  const { data, content } = matter16(raw, {});
   const existing = Array.isArray(data.candidates) ? data.candidates : [];
   const fallbackId = `WI-CANDIDATE-${String(existing.length + 1).padStart(3, "0")}`;
   const normalized = normalizeCandidate(candidate, fallbackId);
@@ -21142,7 +21148,7 @@ function addCandidate(dir, id, candidate) {
     throw new InitiativeWriteError(`Candidate ${normalized.id} already exists in ${id}.`);
   }
   data.candidates = [...existing, candidateToData(normalized)];
-  const newContent = matter15.stringify(content, data);
+  const newContent = matter16.stringify(content, data);
   writeFile2(ini.filePath, newContent);
   const updated = parseInitiative2(dir, ini.filePath, newContent);
   if (!updated) throw new InitiativeWriteError("Failed to parse the Initiative after adding a candidate.");
@@ -21152,7 +21158,7 @@ function updateInitiative(dir, id, patch) {
   const ini = getInitiative(dir, id);
   if (!ini) throw new InitiativeWriteError(`Initiative ${id} not found.`);
   const raw = readFile2(ini.filePath);
-  const { data, content } = matter15(raw, {});
+  const { data, content } = matter16(raw, {});
   if (patch.title !== void 0) {
     if (!patch.title.trim()) throw new InitiativeWriteError("Initiative title cannot be empty.");
     data.title = patch.title.trim();
@@ -21162,7 +21168,7 @@ function updateInitiative(dir, id, patch) {
   if (patch.knowledgeLevel !== void 0) data.knowledge_level = patch.knowledgeLevel;
   if (patch.domains !== void 0) data.domains = patch.domains;
   if (patch.relatedCapabilities !== void 0) data.related_capabilities = patch.relatedCapabilities;
-  const newContent = matter15.stringify(content, data);
+  const newContent = matter16.stringify(content, data);
   writeFile2(ini.filePath, newContent);
   const updated = parseInitiative2(dir, ini.filePath, newContent);
   if (!updated) throw new InitiativeWriteError("Failed to parse the Initiative after update.");
@@ -21180,10 +21186,10 @@ function addExternalLink(dir, id, link) {
     throw new InitiativeWriteError(`External link ${link.integration}:${link.externalId} already exists on ${id}.`);
   }
   const raw = readFile2(ini.filePath);
-  const { data, content } = matter15(raw, {});
+  const { data, content } = matter16(raw, {});
   const existing = Array.isArray(data.external_links) ? data.external_links : [];
   data.external_links = [...existing, externalLinkToData(link)];
-  const newContent = matter15.stringify(content, data);
+  const newContent = matter16.stringify(content, data);
   writeFile2(ini.filePath, newContent);
   const updated = parseInitiative2(dir, ini.filePath, newContent);
   if (!updated) throw new InitiativeWriteError("Failed to parse the Initiative after adding an external link.");
@@ -21192,7 +21198,7 @@ function addExternalLink(dir, id, link) {
 function nextWorkItemId2(dir) {
   const wiDir = join3(dir, WORK_ITEMS_DIR2);
   let max = 0;
-  const walk = (d3) => {
+  const walk2 = (d3) => {
     if (!exists2(d3)) return;
     for (const entry of readDir2(d3)) {
       const full = join3(d3, entry);
@@ -21200,11 +21206,11 @@ function nextWorkItemId2(dir) {
         const m2 = entry.match(/WI-(\d+)/);
         if (m2) max = Math.max(max, parseInt(m2[1], 10));
       } else if (!entry.startsWith(".")) {
-        walk(full);
+        walk2(full);
       }
     }
   };
-  walk(wiDir);
+  walk2(wiDir);
   return `WI-${String(max + 1).padStart(3, "0")}`;
 }
 function buildWorkItemContent(wiId, iniId, candidate) {
@@ -21252,7 +21258,7 @@ function buildWorkItemContent(wiId, iniId, candidate) {
     "_What did we learn? Update after completion._",
     ""
   ].join("\n");
-  return matter15.stringify("\n" + body, data);
+  return matter16.stringify("\n" + body, data);
 }
 function materializeCandidate(dir, id, candidateId) {
   const ini = getInitiative(dir, id);
@@ -21269,13 +21275,13 @@ function materializeCandidate(dir, id, candidateId) {
   ensureDir2(join3(dir, DRAFT_DIR));
   writeFile2(join3(dir, DRAFT_DIR, fileName), buildWorkItemContent(wiId, ini.id, candidate));
   const raw = readFile2(ini.filePath);
-  const { data, content } = matter15(raw, {});
+  const { data, content } = matter16(raw, {});
   const cands = Array.isArray(data.candidates) ? data.candidates : [];
   for (const c of cands) {
     if (c && typeof c === "object" && String(c.id) === candidateId) c.materialized_as = wiId;
   }
   data.candidates = cands;
-  const newContent = matter15.stringify(content, data);
+  const newContent = matter16.stringify(content, data);
   writeFile2(ini.filePath, newContent);
   const updated = parseInitiative2(dir, ini.filePath, newContent);
   if (!updated) throw new InitiativeWriteError("Failed to parse the Initiative after materialization.");
@@ -21389,7 +21395,7 @@ function evaluateInitiativeCompletion(dir, ini) {
 // ../cli/src/core/resource-write.ts
 import fs6 from "fs";
 import path5 from "path";
-import matter18 from "gray-matter";
+import matter20 from "gray-matter";
 var RESOURCES_DIR = "knowledge/tech/resources";
 var ResourceWriteError = class extends Error {
   constructor(code, message) {
@@ -21469,7 +21475,7 @@ function buildFrontmatter(id, input, base = {}) {
   return data;
 }
 function serialize(data, body) {
-  return matter18.stringify(`
+  return matter20.stringify(`
 ${body.trim()}
 `, data);
 }
@@ -21509,7 +21515,7 @@ function updateResource(dir, id, input) {
     throw new ResourceWriteError("VALIDATION_FAILED", findings.filter((f3) => f3.level === "error").map((f3) => f3.message).join("; "));
   }
   const raw = readFile(match.filePath);
-  const parsed = matter18(raw);
+  const parsed = matter20(raw);
   const base = parsed.data ?? {};
   const data = buildFrontmatter(match.id || id, input, base);
   let body = parsed.content.trim();
@@ -21742,7 +21748,7 @@ var CANDIDATE_DISCOVERY_GUIDANCE2 = [
 // ../cli/src/core/deprecation-write.ts
 import fs7 from "fs";
 import path6 from "path";
-import matter19 from "gray-matter";
+import matter21 from "gray-matter";
 var DeprecationWriteError = class extends Error {
   constructor(code, message) {
     super(message);
@@ -21760,7 +21766,7 @@ function atomicWrite2(filePath, content) {
   fs7.renameSync(tmp, filePath);
 }
 function serialize3(data, body) {
-  return matter19.stringify(`
+  return matter21.stringify(`
 ${body.trim()}
 `, data);
 }
@@ -21826,7 +21832,7 @@ function validateTargetInput(dir, raw) {
 function loadPlanRaw(dir, planId) {
   const match = allPlanArtifacts(dir).find((a2) => a2.id === planId || a2.title === planId);
   if (!match) throw new DeprecationWriteError("NOT_FOUND", `Deprecation Plan "${planId}" not found.`);
-  const parsed = matter19(readFile(match.filePath));
+  const parsed = matter21(readFile(match.filePath));
   const data = { ...parsed.data ?? {} };
   return { filePath: match.filePath, data, body: parsed.content.trim() };
 }
@@ -22014,12 +22020,12 @@ function markWorkItemReady(root, id, confirm2) {
   }
   const raw = readText(root, item.path);
   if (!raw) return fail(`Could not read Work Item file: ${item.path}`);
-  const parsed = matter20(raw);
+  const parsed = matter23(raw);
   const data = { ...parsed.data };
   const today3 = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   data.status = "ready";
   data.ready_at = today3;
-  const newContent = matter20.stringify(parsed.content, data);
+  const newContent = matter23.stringify(parsed.content, data);
   const posixPath = item.path.replace(/\\/g, "/");
   let newRelPath = item.path;
   if (posixPath.includes("/work-items/draft/")) {
@@ -22314,8 +22320,8 @@ function removeDeprecationTargetTool(root, planId, targetId, confirm2) {
 // src/multirepo.ts
 import fs8 from "fs";
 import path7 from "path";
-import matter21 from "gray-matter";
-import { parse as parseYaml11, stringify as stringifyYaml8 } from "yaml";
+import matter24 from "gray-matter";
+import { parse as parseYaml12, stringify as stringifyYaml8 } from "yaml";
 var ok2 = (data) => ({ ok: true, data });
 var fail2 = (message) => ({ ok: false, message });
 function moduleRepoPath(m2) {
@@ -22351,7 +22357,7 @@ function detectModuleStatus2(root, repoPath) {
   }
   let parsed = null;
   try {
-    parsed = parseYaml11(fs8.readFileSync(configPath, "utf-8"));
+    parsed = parseYaml12(fs8.readFileSync(configPath, "utf-8"));
   } catch {
   }
   const role = parsed?.project?.role ?? parsed?.multirepo?.role;
@@ -22466,7 +22472,7 @@ function validateWorkItemModulesTool(root, args) {
   if (!wi) return fail2(`Work Item "${args.workItemId}" not found.`);
   const raw = readText(root, wi.path);
   if (!raw) return fail2(`Could not read Work Item file.`);
-  const parsed = matter21(raw);
+  const parsed = matter24(raw);
   const data = parsed.data;
   const affectedModules = Array.isArray(data.affected_modules) ? data.affected_modules.map(String) : [];
   const codeEntries = Array.isArray(data.code) ? data.code.filter((c) => typeof c === "object" && c !== null).map((c) => ({ repo: typeof c.repo === "string" ? c.repo : void 0, paths: Array.isArray(c.paths) ? c.paths.map(String) : [] })) : [];
@@ -22519,7 +22525,7 @@ function getWorkItemContextTool(root, args) {
   if (!wi) return fail2(`Work Item "${args.workItemId}" not found.`);
   const raw = readText(root, wi.path);
   if (!raw) return fail2(`Could not read Work Item file.`);
-  const parsed = matter21(raw);
+  const parsed = matter24(raw);
   const data = parsed.data;
   const affectedModules = Array.isArray(data.affected_modules) ? data.affected_modules.map(String) : [];
   const codeEntries = Array.isArray(data.code) ? data.code.filter((c) => typeof c === "object" && c !== null).map((c) => ({ repo: typeof c.repo === "string" ? c.repo : void 0, paths: Array.isArray(c.paths) ? c.paths.map(String) : [] })) : [];
@@ -22605,7 +22611,7 @@ function suggestBranchStrategyTool(root, args) {
   if (!wi) return fail2(`Work Item "${args.workItemId}" not found.`);
   const raw = readText(root, wi.path);
   if (!raw) return fail2(`Could not read Work Item file.`);
-  const parsed = matter21(raw);
+  const parsed = matter24(raw);
   const data = parsed.data;
   const affectedModules = Array.isArray(data.affected_modules) ? data.affected_modules.map(String) : [];
   const codeEntries = Array.isArray(data.code) ? data.code.filter((c) => typeof c === "object" && c !== null).map((c) => ({ repo: typeof c.repo === "string" ? c.repo : void 0, paths: Array.isArray(c.paths) ? c.paths.map(String) : [] })) : [];
@@ -22778,7 +22784,7 @@ function modulesDiscoverTool(root, args) {
       }
       let parsed = null;
       try {
-        parsed = parseYaml11(fs8.readFileSync(cfgPath, "utf-8"));
+        parsed = parseYaml12(fs8.readFileSync(cfgPath, "utf-8"));
       } catch {
       }
       const role = parsed?.project?.role ?? parsed?.multirepo?.role;
@@ -22851,7 +22857,7 @@ ${list3(data.owners)}
 }
 
 // ../cli/src/core/system-topology.ts
-import { parse as parseYaml12, stringify as stringifyYaml9 } from "yaml";
+import { parse as parseYaml13, stringify as stringifyYaml9 } from "yaml";
 import fs9 from "fs";
 import path8 from "path";
 import crypto from "crypto";
@@ -22898,7 +22904,7 @@ function loadSystemTopology2(dir) {
 function parseTopologyContent2(raw, dir) {
   let parsed;
   try {
-    parsed = parseYaml12(raw) ?? {};
+    parsed = parseYaml13(raw) ?? {};
   } catch {
     return { entities: [], relationships: [], findings: [{ level: "blocking", message: "The topology could not be parsed." }] };
   }
@@ -23365,14 +23371,14 @@ function systemImpactCandidatesTool(root, args) {
 }
 
 // ../cli/src/services/integrations.ts
-import matter24 from "gray-matter";
-import { parse as parseYaml13, stringify as stringifyYaml10 } from "yaml";
+import matter26 from "gray-matter";
+import { parse as parseYaml14, stringify as stringifyYaml10 } from "yaml";
 
 // ../cli/src/core/work-item-write.ts
 import fs10 from "fs";
 import path9 from "path";
 import crypto4 from "crypto";
-import matter23 from "gray-matter";
+import matter25 from "gray-matter";
 var SECTION_ORDER2 = [
   "Actor",
   "Outcome",
@@ -24247,7 +24253,7 @@ function loadRaw(dir) {
   const abs = join(dir, INTEGRATIONS_FILE);
   if (!exists(abs)) return { integrations: [] };
   try {
-    return parseYaml13(readFile(abs)) ?? { integrations: [] };
+    return parseYaml14(readFile(abs)) ?? { integrations: [] };
   } catch {
     return { integrations: [] };
   }
@@ -24420,7 +24426,7 @@ async function integrationsWorkItemTool(root, args) {
 }
 
 // ../cli/src/core/context-pack.ts
-import matter25 from "gray-matter";
+import matter27 from "gray-matter";
 var CONTEXT_PACK_VERSION = "1";
 var ARCH_DIR4 = "knowledge";
 function readScanJson(dir) {
@@ -24433,7 +24439,7 @@ function readScanJson(dir) {
   }
 }
 function firstParagraph4(markdown) {
-  const body = matter25(markdown).content.trim();
+  const body = matter27(markdown).content.trim();
   const para = body.split("\n\n").map((p) => p.trim()).find((p) => p && !p.startsWith("#"));
   return para ?? "";
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaddo/mcp",
-  "version": "3.124.4",
+  "version": "3.125.0",
   "description": "MCP server for Kaddo project knowledge: read-only resources/tools/prompts plus safe derived generation under .kaddo/.",
   "license": "MIT",
   "repository": {