@kaddo/mcp 3.124.3 → 3.124.5

package/dist/index.js

@@ -10406,16 +10406,25 @@ function buildGuardHistory(dir) {
 // ../cli/src/core/reporting-evidence.ts
 function graphHintFinding(hint) {
   const affected = [hint.artifact_id, ...hint.path ? [hint.path] : []];
+  const semantics = {
+    "work-item": { classification: "coverage_gap", priority: "medium", action: "Review whether the active Work Item needs the missing declared relationship." },
+    decision: { classification: "coverage_gap", priority: "low", action: "Review whether this decision should declare governed code paths." },
+    capability: { classification: "coverage_gap", priority: "low", action: "Review whether this capability should connect to existing Work Items; the relationship is optional." },
+    "knowledge-capsule": { classification: "review_hint", priority: "low", action: "Confirm whether this capsule is intended for direct contextual use or Work Item relationships." }
+  };
+  const semantic = semantics[hint.artifact_type];
   return {
     id: `graph-hint:${hint.artifact_id}:${hint.missing.join(",")}`,
     category: "topology",
+    classification: semantic.classification,
+    resolution_status: "open",
     source: "graph-hints",
     affected_artifacts: affected,
-    // Graph Hints are intentionally informational; review is useful but not a blocking error.
-    priority: "medium",
+    // Graph Hints are intentionally non-blocking; their type determines priority and meaning.
+    priority: semantic.priority,
     evidence: hint.reason,
     explanation: hint.message,
-    suggested_action: `Review the declared relationships for ${hint.artifact_id}${hint.path ? ` at ${hint.path}` : ""}.`
+    suggested_action: semantic.action
   };
 }
 function reportingProjectContext(dir) {
@@ -10635,9 +10644,11 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
     findings.push({
       id: `knowledge-health:${layer2.toLowerCase()}`,
       category: "knowledge",
+      classification: "coverage_gap",
+      resolution_status: "open",
       source: "knowledge-health",
       affected_artifacts: [layer2],
-      priority: status === "Missing" ? "high" : "medium",
+      priority: status === "Missing" ? "medium" : "low",
       evidence: `${layer2} knowledge maturity is ${status}.`,
       explanation: `This assesses documented ${layer2} knowledge, not the quality of the product or implementation.`,
       suggested_action: `Review ${layer2} knowledge coverage and the artifacts or relationships available for it.`
@@ -10647,12 +10658,29 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
     findings.push({
       id: `ownership:${gap.id}`,
       category: "delivery",
+      classification: "coverage_gap",
+      resolution_status: "open",
       source: "work-item-ownership",
       affected_artifacts: [gap.id, gap.path],
       priority: "medium",
       evidence: "A corrective Work Item has no declared code ownership.",
       explanation: gap.title,
-      suggested_action: gap.suggested_action
+      suggested_action: "Review and add relevant code ownership declarations."
+    });
+  }
+  for (const wi of completedWis) {
+    if (!wi.validationStatus || !["not-started", "in-progress", "partial", "failed", "blocked"].includes(wi.validationStatus)) continue;
+    findings.push({
+      id: `completion-validation:${wi.id || wi.title}`,
+      category: "delivery",
+      classification: "review_hint",
+      resolution_status: "open",
+      source: "work-item-lifecycle",
+      affected_artifacts: [wi.id || wi.title, wi.relPath],
+      priority: "medium",
+      evidence: `Lifecycle is completed while persisted validation is ${wi.validationStatus}.`,
+      explanation: "This requires review against the Work Item completion contract; it is not automatically a failed or invalid completion.",
+      suggested_action: "Review the validation evidence and confirm whether the completed lifecycle state is consistent with the Work Item completion contract."
     });
   }
   findings.push(...graphHintEntries.map(graphHintFinding));
@@ -10695,7 +10723,6 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
   else if (g.scope === "active" && g.quality === "empty") actions.push("Run `kaddo impact --scope all` to measure accumulated knowledge impact.");
   if (exp.roadmap.remaining > 0) actions.push(`Materialize the ${exp.roadmap.remaining} remaining roadmap candidate(s) with \`kaddo create --from roadmap\`.`);
   for (const a2 of [
-    groupedAction(gaps.missing_code_ownership, "Add `code:` ownership to"),
     groupedAction(gaps.missing_source, "Add `source`/`source_id` to")
   ]) if (a2) actions.push(a2);
   if (gaps.broad_ownership_globs.length > 0) actions.push(`Narrow ${gaps.broad_ownership_globs.length} broad ownership glob(s) into specific paths.`);
@@ -10783,7 +10810,7 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
 function ratio(have, total) {
   return `${have}/${total}`;
 }
-function renderImpactMarkdown(r2) {
+function renderImpactMarkdown(r2, opts = {}) {
   const L = [];
   L.push("# Kaddo Knowledge Impact Report", "");
   L.push(`Generated at: ${r2.generated_at}`);
@@ -10805,10 +10832,10 @@ function renderImpactMarkdown(r2) {
   if (r2.findings.length === 0) L.push("No current findings detected by the executed deterministic checks.");
   if (r2.findings.length > 0) {
     const cell = (value) => value.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
-    L.push("| Priority | Source | Affected | Finding | Suggested action |");
-    L.push("|---|---|---|---|---|");
+    L.push("| Classification | Priority | Status | Source | Affected | Finding | Suggested action |");
+    L.push("|---|---|---|---|---|---|---|");
     for (const finding of r2.findings) {
-      L.push(`| ${finding.priority} | ${cell(finding.source)} | ${cell(finding.affected_artifacts.join(", ") || "not available")} | ${cell(finding.explanation)} Evidence: ${cell(finding.evidence)} | ${cell(finding.suggested_action)} |`);
+      L.push(`| ${finding.classification} | ${finding.priority} | ${finding.resolution_status} | ${cell(finding.source)} | ${cell(finding.affected_artifacts.join(", ") || "not available")} | ${cell(finding.explanation)} Evidence: ${cell(finding.evidence)} | ${cell(finding.suggested_action)} |`);
     }
   }
   L.push("");
@@ -10920,9 +10947,9 @@ function renderImpactMarkdown(r2) {
     }
     L.push("");
   };
-  gapSection("Work Items missing source", gp.missing_source);
-  gapSection("Work Items missing code ownership", gp.missing_code_ownership);
-  if (gp.broad_ownership_globs.length > 0) {
+  if (opts.details) gapSection("Work Items missing source", gp.missing_source);
+  if (opts.details) gapSection("Work Items missing code ownership", gp.missing_code_ownership);
+  if (opts.details && gp.broad_ownership_globs.length > 0) {
     L.push("### Broad ownership globs", "");
     for (const b2 of gp.broad_ownership_globs) {
       L.push(`- ${b2.id} \u2014 ${b2.title}`);
@@ -10933,16 +10960,26 @@ function renderImpactMarkdown(r2) {
   }
   if (gp.ownership_overlaps.length > 0) {
     L.push("### Shared code-path history (review only)", "");
-    for (const o2 of gp.ownership_overlaps) {
-      L.push(`- \`${o2.code_path}\``);
-      L.push(`  - Owned by: ${o2.work_items.join(", ")}`);
-      L.push(`  - Suggested action: ${o2.suggested_action}`);
+    if (opts.details) {
+      for (const o2 of gp.ownership_overlaps) {
+        L.push(`- \`${o2.code_path}\``);
+        L.push(`  - Owned by: ${o2.work_items.join(", ")}`);
+        L.push(`  - Suggested action: ${o2.suggested_action}`);
+      }
+    } else {
+      L.push(`- ${gp.ownership_overlaps.length} shared path declaration(s) detected. These are historical relationships, not necessarily ownership conflicts.`);
+      const areas = gp.ownership_overlaps.slice(0, 3).map((o2) => `\`${o2.code_path}\``);
+      if (areas.length > 0) L.push(`- Most involved paths: ${areas.join(", ")}.`);
+      L.push("- Run `kaddo impact --details` for the complete shared-path inventory.");
     }
     L.push("");
   }
   const anyGaps = gp.missing_source.length + gp.missing_code_ownership.length + gp.broad_ownership_globs.length;
   if (anyGaps === 0) {
     L.push("No actionable knowledge gaps detected. \u{1F389}", "");
+  } else if (!opts.details) {
+    L.push("- Current actionable items are listed in Key Findings. Run `kaddo impact --details` for the full artifact inventory.");
+    L.push("");
   }
   const historical = [
     ["knowledge level", gp.missing_knowledge_level],
@@ -11205,7 +11242,7 @@ function renderSavingsMarkdown(r2) {
   L.push("");
   L.push("## Evidence Used", "");
   const e = r2.evidence;
-  L.push(`- Knowledge Impact Score: ${e.knowledge_impact_score ?? "not available"}${e.knowledge_impact_score !== null ? "/100" : ""}`);
+  L.push(`- Legacy Knowledge Impact Score: ${e.knowledge_impact_score ?? "not available"}${e.knowledge_impact_score !== null ? "/100" : ""} (deprecated; informational only and not used for confidence)`);
   L.push(`- Completed Work Items: ${e.completed_work_items}`);
   L.push(`- Ownership coverage: ${e.ownership_coverage_percent}%`);
   L.push(`- Work Items with Acceptance Criteria: ${e.work_items_with_acceptance_criteria}`);
@@ -11280,7 +11317,15 @@ function buildDriftReport(dir, now = /* @__PURE__ */ new Date()) {
   const workItems = discoverWorkItems(dir);
   const verificationEvidence = workItems.filter((wi) => wi.validationStatus && wi.validationStatus !== "not-started");
   const plans = getDeprecationPlans(dir);
-  const deprecationFindings = plans.flatMap((plan) => getDeprecationPlan(dir, plan.id)?.targets.flatMap(validateTarget) ?? []);
+  const planDetails = plans.map((plan) => getDeprecationPlan(dir, plan.id)).filter((plan) => plan !== null);
+  const plansWithoutTargets = planDetails.filter((plan) => plan.targets.length === 0);
+  const plansWithTargets = planDetails.filter((plan) => plan.targets.length > 0);
+  const targetFindingsByPlan = new Map(plansWithTargets.map((plan) => [
+    plan.id,
+    plan.targets.flatMap(validateTarget)
+  ]));
+  const deprecationFindings = [...targetFindingsByPlan.values()].flat();
+  const plansWithoutStructuralFindings = plansWithTargets.filter((plan) => (targetFindingsByPlan.get(plan.id) ?? []).length === 0);
   const config = loadConfig(dir);
   const topology = config ? buildGraph(dir, config, { scope: "all" }, now) : null;
   const graphHints = topology ? buildGraphHints(dir, topology, now) : null;
@@ -11290,13 +11335,27 @@ function buildDriftReport(dir, now = /* @__PURE__ */ new Date()) {
     ...deprecationFindings.map((finding, index) => ({
       id: `deprecation-target:${index + 1}`,
       category: "consistency",
+      classification: "consistency_violation",
+      resolution_status: "open",
       source: "deprecation-target-validation",
-      affected_artifacts: [],
-      priority: "medium",
-      evidence: String(finding),
+      affected_artifacts: finding.target ? [finding.target] : [],
+      priority: finding.severity === "error" ? "high" : "medium",
+      evidence: finding.message,
       explanation: "A deterministic deprecation target consistency check reported a finding.",
       suggested_action: "Review the affected deprecation target and its declared lifecycle evidence."
-    }))
+    })),
+    ...h2.available && h2.total_runs >= 2 ? h2.threads.filter((thread) => thread.status === "open").map((thread) => ({
+      id: `guard-history:${thread.code_path}`,
+      category: "consistency",
+      classification: "historical_drift",
+      resolution_status: "open",
+      source: "guard-history",
+      affected_artifacts: [thread.code_path, ...thread.related_artifacts],
+      priority: "medium",
+      evidence: `Recorded Guard observations from ${thread.first_detected} through ${thread.last_seen} remain unresolved.`,
+      explanation: "Comparable Guard runs observed a possible code/knowledge drift thread over time.",
+      suggested_action: "Review the recorded drift thread and update the relevant knowledge or ownership evidence."
+    })) : []
   ];
   const actions = [];
   if (!h2.available) {
@@ -11313,12 +11372,17 @@ function buildDriftReport(dir, now = /* @__PURE__ */ new Date()) {
     consistency_evidence: [
       { id: "guard-current-consistency", label: "Current Guard consistency", classification: h2.available ? "observed" : "unknown", reason: h2.available ? `${h2.total_runs} recorded Guard run(s) provide deterministic consistency evidence.` : "No recorded Guard history is available." },
       { id: "lifecycle-consistency", label: "Lifecycle evidence consistency", classification: verificationEvidence.length > 0 ? "observed" : "unknown", reason: verificationEvidence.length > 0 ? `${verificationEvidence.length} Work Item(s) persist an implementation validation status.` : "No persisted Work Item validation status is available." },
-      { id: "deprecation-consistency", label: "Deprecation consistency", classification: plans.length === 0 ? "not_applicable" : deprecationFindings.length === 0 ? "derived" : "observed", reason: plans.length === 0 ? "No deprecation plans exist in this project." : deprecationFindings.length === 0 ? `${plans.length} plan(s) passed deterministic target consistency checks.` : `${deprecationFindings.length} deterministic deprecation consistency finding(s) were detected.` },
+      { id: "deprecation-consistency", label: "Deprecation consistency", classification: plans.length === 0 ? "not_applicable" : plansWithTargets.length === 0 ? "unknown" : deprecationFindings.length === 0 ? "derived" : "observed", reason: plans.length === 0 ? "No deprecation plans exist in this project." : plansWithTargets.length === 0 ? `${plansWithoutTargets.length} plan(s) have no targets, so target consistency was not evaluated.` : deprecationFindings.length === 0 ? `${plansWithTargets.length} plan(s) with targets passed deterministic target consistency checks; ${plansWithoutTargets.length} plan(s) remain unevaluated because they have no targets.` : `${deprecationFindings.length} deterministic deprecation consistency finding(s) were detected.` },
       { id: "topology-consistency", label: "Knowledge topology consistency", classification: topology === null ? "unknown" : topologyHints === 0 ? "derived" : "observed", reason: topology === null ? "No project configuration is available to construct the topology." : topologyHints === 0 ? `The in-memory topology has ${topology.nodes.length} node(s) and no open deterministic hints.` : `The in-memory topology has ${topologyHints} open deterministic hint(s).` }
     ],
     current_consistency_findings: currentConsistencyFindings,
     structural_consistency: {
-      deprecation_target_checks: plans.length === 0 ? "not_applicable" : deprecationFindings.length === 0 ? "passed" : "findings_detected",
+      deprecation_target_checks: plans.length === 0 ? "not_applicable" : plansWithTargets.length === 0 ? "not_evaluated" : deprecationFindings.length === 0 ? "passed" : "findings_detected",
+      plans_discovered: plans.length,
+      plans_without_targets: plansWithoutTargets.length,
+      plans_with_targets_evaluated: plansWithTargets.length,
+      structural_findings: deprecationFindings.length,
+      plans_without_structural_findings: plansWithoutStructuralFindings.length,
       note: plans.length === 0 ? "No deprecation plans exist in this project." : "Target consistency checks validate declared structural state only; they do not verify operational removal from infrastructure, production or external consumers."
     },
     guard_history: {
@@ -11346,22 +11410,41 @@ function renderDriftMarkdown(r2) {
   L.push("## Consistency Evidence", "");
   for (const item of r2.consistency_evidence) L.push(`- ${item.label}: ${item.classification} \u2014 ${item.reason}`);
   L.push("");
-  L.push("## Current Consistency Findings", "");
-  if (r2.current_consistency_findings.length === 0) {
-    L.push("No findings detected by the executed consistency checks.");
-    L.push("");
+  const findingGroups = [
+    { classification: "consistency_violation", title: "Consistency Violations" },
+    { classification: "coverage_gap", title: "Coverage Gaps" },
+    { classification: "review_hint", title: "Review Hints" },
+    { classification: "historical_drift", title: "Historical Drift" }
+  ];
+  L.push("## Current Findings Summary", "");
+  for (const group of findingGroups) {
+    const count = r2.current_consistency_findings.filter((finding) => finding.classification === group.classification).length;
+    const unavailable = group.classification === "historical_drift" && !r2.guard_history.available;
+    L.push(`- ${group.title}: ${unavailable ? "not available \u2014 no recorded Guard runs" : count}`);
   }
-  if (r2.current_consistency_findings.length > 0) {
-    const cell = (value) => value.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
-    L.push("| Priority | Source | Affected | Finding | Suggested action |");
-    L.push("|---|---|---|---|---|");
-    for (const finding of r2.current_consistency_findings) {
-      L.push(`| ${finding.priority} | ${cell(finding.source)} | ${cell(finding.affected_artifacts.join(", ") || "not available")} | ${cell(finding.explanation)} Evidence: ${cell(finding.evidence)} | ${cell(finding.suggested_action)} |`);
+  L.push("");
+  L.push("## Current Consistency Findings", "");
+  if (r2.current_consistency_findings.length === 0) L.push("No findings detected by the executed consistency checks.", "");
+  const cell = (value) => value.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+  for (const group of findingGroups) {
+    const findings = r2.current_consistency_findings.filter((finding) => finding.classification === group.classification);
+    if (findings.length === 0) continue;
+    L.push(`### ${group.title}`, "");
+    L.push("| Classification | Priority | Status | Source | Affected | Finding | Suggested action |");
+    L.push("|---|---|---|---|---|---|---|");
+    for (const finding of findings) {
+      L.push(`| ${finding.classification} | ${finding.priority} | ${finding.resolution_status} | ${cell(finding.source)} | ${cell(finding.affected_artifacts.join(", ") || "not available")} | ${cell(finding.explanation)} Evidence: ${cell(finding.evidence)} | ${cell(finding.suggested_action)} |`);
     }
     L.push("");
   }
   L.push("## Structural Consistency Boundaries", "");
   L.push(`- Deprecation target checks: ${r2.structural_consistency.deprecation_target_checks}`);
+  L.push(`- Plans discovered: ${r2.structural_consistency.plans_discovered}`);
+  L.push(`- Plans without targets: ${r2.structural_consistency.plans_without_targets}`);
+  L.push(`- Plans with targets evaluated: ${r2.structural_consistency.plans_with_targets_evaluated}`);
+  L.push(`- Structural findings: ${r2.structural_consistency.structural_findings}`);
+  L.push(`- Plans without structural findings: ${r2.structural_consistency.plans_without_structural_findings}`);
+  if (r2.structural_consistency.plans_without_targets > 0) L.push("- Target consistency for plans without targets: not evaluated \u2014 no targets defined.");
   L.push(`- Note: ${r2.structural_consistency.note}`);
   L.push("");
   if (!r2.guard_history.available) {
@@ -12038,7 +12121,7 @@ function getPrompt(root, name) {
 }
 
 // src/tools.ts
-import matter20 from "gray-matter";
+import matter21 from "gray-matter";
 
 // ../cli/dist/core.js
 import fs3 from "fs";
@@ -12065,21 +12148,23 @@ 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";
 function exists2(p) {
   return fs3.existsSync(p);
 }
@@ -18396,6 +18481,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",
@@ -18582,7 +18670,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." }] };
   }
@@ -18801,7 +18889,7 @@ function parseOriginalSnapshot(fm) {
 function readBody(filePath) {
   try {
     const raw = readFile2(filePath);
-    return matter112(raw).content;
+    return matter122(raw).content;
   } catch {
     return "";
   }
@@ -19086,7 +19174,7 @@ function ensureH1(body, title) {
 ${trimmed}`;
 }
 function serialize2(data, body) {
-  return matter122.stringify(`
+  return matter132.stringify(`
 ${body.trim()}
 `, data);
 }
@@ -20000,7 +20088,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)) {
@@ -20022,7 +20110,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 {
@@ -20119,7 +20207,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;
@@ -20835,7 +20923,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 };
@@ -21014,7 +21102,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.");
@@ -21038,10 +21126,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.");
@@ -21051,7 +21139,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);
@@ -21059,7 +21147,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.");
@@ -21069,7 +21157,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();
@@ -21079,7 +21167,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.");
@@ -21097,10 +21185,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.");
@@ -21169,7 +21257,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);
@@ -21186,13 +21274,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.");
@@ -21306,7 +21394,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 matter19 from "gray-matter";
 var RESOURCES_DIR = "knowledge/tech/resources";
 var ResourceWriteError = class extends Error {
   constructor(code, message) {
@@ -21386,7 +21474,7 @@ function buildFrontmatter(id, input, base = {}) {
   return data;
 }
 function serialize(data, body) {
-  return matter18.stringify(`
+  return matter19.stringify(`
 ${body.trim()}
 `, data);
 }
@@ -21426,7 +21514,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 = matter19(raw);
   const base = parsed.data ?? {};
   const data = buildFrontmatter(match.id || id, input, base);
   let body = parsed.content.trim();
@@ -21659,7 +21747,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 matter20 from "gray-matter";
 var DeprecationWriteError = class extends Error {
   constructor(code, message) {
     super(message);
@@ -21677,7 +21765,7 @@ function atomicWrite2(filePath, content) {
   fs7.renameSync(tmp, filePath);
 }
 function serialize3(data, body) {
-  return matter19.stringify(`
+  return matter20.stringify(`
 ${body.trim()}
 `, data);
 }
@@ -21743,7 +21831,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 = matter20(readFile(match.filePath));
   const data = { ...parsed.data ?? {} };
   return { filePath: match.filePath, data, body: parsed.content.trim() };
 }
@@ -21931,12 +22019,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 = matter21(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 = matter21.stringify(parsed.content, data);
   const posixPath = item.path.replace(/\\/g, "/");
   let newRelPath = item.path;
   if (posixPath.includes("/work-items/draft/")) {
@@ -22231,8 +22319,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 matter23 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) {
@@ -22268,7 +22356,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;
@@ -22383,7 +22471,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 = matter23(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) : [] })) : [];
@@ -22436,7 +22524,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 = matter23(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) : [] })) : [];
@@ -22522,7 +22610,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 = matter23(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) : [] })) : [];
@@ -22695,7 +22783,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;
@@ -22768,7 +22856,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";
@@ -22815,7 +22903,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." }] };
   }
@@ -23282,14 +23370,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 matter25 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 matter24 from "gray-matter";
 var SECTION_ORDER2 = [
   "Actor",
   "Outcome",
@@ -24164,7 +24252,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: [] };
   }
@@ -24337,7 +24425,7 @@ async function integrationsWorkItemTool(root, args) {
 }
 
 // ../cli/src/core/context-pack.ts
-import matter25 from "gray-matter";
+import matter26 from "gray-matter";
 var CONTEXT_PACK_VERSION = "1";
 var ARCH_DIR4 = "knowledge";
 function readScanJson(dir) {
@@ -24350,7 +24438,7 @@ function readScanJson(dir) {
   }
 }
 function firstParagraph4(markdown) {
-  const body = matter25(markdown).content.trim();
+  const body = matter26(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.3",
+  "version": "3.124.5",
   "description": "MCP server for Kaddo project knowledge: read-only resources/tools/prompts plus safe derived generation under .kaddo/.",
   "license": "MIT",
   "repository": {