@kaddo/mcp 3.107.0 → 3.109.0

package/dist/index.js

@@ -386,7 +386,7 @@ function join(...parts) {
 }
 
 // ../cli/src/core/impact-report.ts
-import matter8 from "gray-matter";
+import matter9 from "gray-matter";
 
 // ../cli/src/core/config.ts
 import { z } from "zod";
@@ -2472,6 +2472,124 @@ function loadExternalCapsules(dir) {
   return out;
 }
 
+// ../cli/src/core/initiative.ts
+import matter5 from "gray-matter";
+var INITIATIVES_DIR = "knowledge/delivery/initiatives";
+var INITIATIVE_STATES = [
+  "candidate",
+  "planned",
+  "in-progress",
+  "completed",
+  "deferred",
+  "cancelled"
+];
+var STATUS_SET = new Set(INITIATIVE_STATES);
+function isValidInitiativeStatus(s) {
+  return STATUS_SET.has(s);
+}
+function toPosix3(p) {
+  return p.replace(/\\/g, "/");
+}
+function optStr(v) {
+  if (typeof v === "string" && v.trim()) return v.trim();
+  if (typeof v === "number") return String(v);
+  return void 0;
+}
+function strList(v) {
+  if (!Array.isArray(v)) return [];
+  return v.map((x2) => typeof x2 === "string" ? x2.trim() : String(x2)).filter(Boolean);
+}
+function parseCandidates(data) {
+  const raw = data.candidates;
+  if (!Array.isArray(raw)) return [];
+  const out = [];
+  for (const entry of raw) {
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) continue;
+    const o2 = entry;
+    const id = optStr(o2.id);
+    const title = optStr(o2.title);
+    if (!id || !title) continue;
+    out.push({
+      id,
+      title,
+      type: optStr(o2.type),
+      suggestedKnowledgeLevel: optStr(o2.suggested_knowledge_level ?? o2.knowledge_level),
+      expectedValue: optStr(o2.expected_value),
+      notes: optStr(o2.notes),
+      sourceSignals: strList(o2.source_signals),
+      dependencies: strList(o2.dependencies),
+      materializedAs: optStr(o2.materialized_as) ?? null
+    });
+  }
+  return out;
+}
+function parseExternalLinks(data) {
+  const raw = data.external_links;
+  if (!Array.isArray(raw)) return [];
+  const out = [];
+  for (const entry of raw) {
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) continue;
+    const o2 = entry;
+    const integration = optStr(o2.integration);
+    const externalId = optStr(o2.external_id);
+    if (!integration || !externalId) continue;
+    out.push({
+      integration,
+      externalId,
+      externalType: optStr(o2.external_type),
+      url: optStr(o2.url),
+      externalStatus: optStr(o2.external_status)
+    });
+  }
+  return out;
+}
+function parseInitiative(dir, filePath, raw) {
+  let parsed;
+  try {
+    parsed = matter5(raw, {});
+  } catch {
+    return null;
+  }
+  const data = parsed.data;
+  if (optStr(data.type) !== "initiative") return null;
+  const id = optStr(data.id);
+  if (!id) return null;
+  const statusRaw = optStr(data.status) ?? "planned";
+  const status = isValidInitiativeStatus(statusRaw) ? statusRaw : "planned";
+  return {
+    id,
+    title: optStr(data.title) ?? id,
+    status,
+    horizon: optStr(data.horizon) ?? null,
+    priority: optStr(data.priority) ?? null,
+    knowledgeLevel: optStr(data.knowledge_level) ?? null,
+    domains: strList(data.domains),
+    relatedCapabilities: strList(data.related_capabilities),
+    source: optStr(data.source) ?? null,
+    sourceId: optStr(data.source_id) ?? null,
+    createdAt: optStr(data.created_at) ?? null,
+    externalLinks: parseExternalLinks(data),
+    candidates: parseCandidates(data),
+    filePath,
+    relPath: toPosix3(filePath).startsWith(toPosix3(dir) + "/") ? toPosix3(filePath).slice(toPosix3(dir).length + 1) : toPosix3(filePath),
+    body: parsed.content.trim(),
+    rawFrontmatter: data
+  };
+}
+function discoverInitiatives(dir) {
+  const iniDir = join(dir, INITIATIVES_DIR);
+  if (!exists(iniDir)) return [];
+  const out = [];
+  for (const entry of readDir(iniDir)) {
+    if (!entry.endsWith(".md")) continue;
+    const full = join(iniDir, entry);
+    if (!isFile(full)) continue;
+    const ini = parseInitiative(dir, full, readFile(full));
+    if (ini) out.push(ini);
+  }
+  return out.sort((a2, b2) => a2.id.localeCompare(b2.id));
+}
+
 // ../cli/src/core/graph.ts
 var KNOWLEDGE3 = "knowledge";
 var ACTIVE_STATUSES = ["draft", "ready", "in-progress", "blocked"];
@@ -2479,14 +2597,14 @@ var ALL_STATUSES = ["draft", "ready", "in-progress", "blocked", "completed"];
 function scopeStatuses(scope) {
   return scope === "all" ? { included: ALL_STATUSES, excluded: ["archived"] } : { included: ACTIVE_STATUSES, excluded: ["completed", "archived"] };
 }
-function toPosix3(p) {
+function toPosix4(p) {
   return p.replace(/\\/g, "/");
 }
 function slug(s) {
   return s.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
 function isAdr(a2) {
-  return toPosix3(a2.filePath).includes("/tech/decisions/") && Boolean(a2.type);
+  return toPosix4(a2.filePath).includes("/tech/decisions/") && Boolean(a2.type);
 }
 function buildGraph(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
   const scope = opts.scope ?? "active";
@@ -2525,6 +2643,33 @@ function buildGraph(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
   const includedSet = new Set(included);
   const activeWICount = workItems.filter((a2) => a2.lifecycle && isActiveState(a2.lifecycle)).length;
   const selectedWIs = workItems.filter((a2) => a2.lifecycle && includedSet.has(a2.lifecycle));
+  for (const ini of discoverInitiatives(dir)) {
+    const iniNodeId = `initiative:${slug(ini.id) || ini.id}`;
+    addNode({
+      id: iniNodeId,
+      type: "initiative",
+      label: `${ini.id} ${ini.title}`.trim(),
+      path: ini.relPath,
+      status: ini.status
+    });
+    for (const cap of ini.relatedCapabilities) {
+      if (!cap.trim()) continue;
+      const capId = `capability:${slug(cap) || cap}`;
+      addNode({ id: capId, type: "capability", label: cap });
+      addEdge(iniNodeId, capId, "targets");
+    }
+    for (const link of ini.externalLinks) {
+      const extId = `external-item:${slug(link.integration) || link.integration}:${slug(link.externalId) || link.externalId}`;
+      addNode({ id: extId, type: "external-item", label: `${link.integration}:${link.externalId}`, path: link.url });
+      addEdge(iniNodeId, extId, "references_external");
+    }
+    for (const cand of ini.candidates) {
+      const candId = `candidate:${cand.id}`;
+      addNode({ id: candId, type: "roadmap-candidate", label: cand.id });
+      addEdge(candId, iniNodeId, "belongs_to");
+      if (cand.materializedAs) addEdge(candId, `wi:${cand.materializedAs}`, "materialized_as");
+    }
+  }
   for (const wi of selectedWIs) {
     const id = wi.id || wi.title;
     if (!id || !id.trim()) continue;
@@ -2685,14 +2830,14 @@ function loadGraphSummary(dir) {
 
 // ../cli/src/core/graph-hints.ts
 var KNOWLEDGE4 = "knowledge";
-function toPosix4(p) {
+function toPosix5(p) {
   return p.replace(/\\/g, "/");
 }
 function slug2(s) {
   return s.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
 function isAdr2(a2) {
-  return toPosix4(a2.filePath).includes("/tech/decisions/") && Boolean(a2.type);
+  return toPosix5(a2.filePath).includes("/tech/decisions/") && Boolean(a2.type);
 }
 function capabilityHeadings(dir) {
   const p = join(dir, KNOWLEDGE4, "product", "capabilities.md");
@@ -2927,7 +3072,7 @@ function loadGraphHints(dir) {
 }
 
 // ../cli/src/services/installed-skills.ts
-import matter5 from "gray-matter";
+import matter6 from "gray-matter";
 var SKILLS_DIR = join("knowledge", "skills");
 function discoverInstalledSkills(dir) {
   const base = join(dir, SKILLS_DIR);
@@ -2937,7 +3082,7 @@ function discoverInstalledSkills(dir) {
     const skillFile = join(base, entry, "skill.md");
     if (!isFile(skillFile)) continue;
     try {
-      const { data } = matter5(readFile(skillFile));
+      const { data } = matter6(readFile(skillFile));
       if (data.type && String(data.type) !== "skill") continue;
       const id = String(data.id ?? entry);
       out.push({
@@ -4526,7 +4671,7 @@ function deriveDeliveryCompletedStatus(dir) {
 }
 
 // ../cli/src/core/assets.ts
-import matter6 from "gray-matter";
+import matter7 from "gray-matter";
 
 // ../cli/src/core/version.ts
 import { fileURLToPath } from "url";
@@ -7732,7 +7877,7 @@ function canonicalSkills() {
 }
 function versionOf(content) {
   try {
-    const v = matter6(content).data.version;
+    const v = matter7(content).data.version;
     return v === void 0 || v === null ? null : String(v);
   } catch {
     return null;
@@ -7924,19 +8069,19 @@ function parseWorkItemSource(frontmatter) {
   const rawSource = frontmatter.source;
   if (rawSource != null && typeof rawSource === "object" && !Array.isArray(rawSource)) {
     const obj = rawSource;
-    const t = optStr(obj.type);
+    const t = optStr2(obj.type);
     const type = t && isValidSource(t) ? t : "unknown";
     return {
       type,
-      id: optStr(obj.id) ?? optStr(frontmatter.source_id),
-      title: optStr(obj.title) ?? optStr(frontmatter.source_title),
-      context: optStr(obj.context) ?? optStr(frontmatter.source_context),
-      provider: optStr(obj.provider) ?? optStr(frontmatter.source_provider),
-      integration: optStr(obj.integration) ?? optStr(frontmatter.source_integration),
-      url: optStr(obj.url) ?? optStr(frontmatter.source_url),
-      imported_at: optStr(obj.imported_at) ?? optStr(frontmatter.source_imported_at),
-      external_updated_at: optStr(obj.external_updated_at) ?? optStr(frontmatter.source_external_updated_at),
-      synced_at: optStr(obj.synced_at) ?? optStr(frontmatter.source_synced_at),
+      id: optStr2(obj.id) ?? optStr2(frontmatter.source_id),
+      title: optStr2(obj.title) ?? optStr2(frontmatter.source_title),
+      context: optStr2(obj.context) ?? optStr2(frontmatter.source_context),
+      provider: optStr2(obj.provider) ?? optStr2(frontmatter.source_provider),
+      integration: optStr2(obj.integration) ?? optStr2(frontmatter.source_integration),
+      url: optStr2(obj.url) ?? optStr2(frontmatter.source_url),
+      imported_at: optStr2(obj.imported_at) ?? optStr2(frontmatter.source_imported_at),
+      external_updated_at: optStr2(obj.external_updated_at) ?? optStr2(frontmatter.source_external_updated_at),
+      synced_at: optStr2(obj.synced_at) ?? optStr2(frontmatter.source_synced_at),
       inferred: obj.inferred === true || obj.inferred === "true",
       reason: t && !isValidSource(t) ? `Invalid source type in object: "${t}".` : void 0
     };
@@ -7945,28 +8090,28 @@ function parseWorkItemSource(frontmatter) {
   if (raw && isValidSource(raw)) {
     return {
       type: raw,
-      id: optStr(frontmatter.source_id),
-      title: optStr(frontmatter.source_title),
-      context: optStr(frontmatter.source_context),
-      provider: optStr(frontmatter.source_provider),
-      url: optStr(frontmatter.source_url),
-      imported_at: optStr(frontmatter.source_imported_at),
-      external_updated_at: optStr(frontmatter.source_external_updated_at),
-      synced_at: optStr(frontmatter.source_synced_at),
+      id: optStr2(frontmatter.source_id),
+      title: optStr2(frontmatter.source_title),
+      context: optStr2(frontmatter.source_context),
+      provider: optStr2(frontmatter.source_provider),
+      url: optStr2(frontmatter.source_url),
+      imported_at: optStr2(frontmatter.source_imported_at),
+      external_updated_at: optStr2(frontmatter.source_external_updated_at),
+      synced_at: optStr2(frontmatter.source_synced_at),
       inferred: false
     };
   }
   if (raw && !isValidSource(raw)) {
     return {
       type: "unknown",
-      id: optStr(frontmatter.source_id),
-      title: optStr(frontmatter.source_title),
-      context: optStr(frontmatter.source_context),
-      provider: optStr(frontmatter.source_provider),
-      url: optStr(frontmatter.source_url),
-      imported_at: optStr(frontmatter.source_imported_at),
-      external_updated_at: optStr(frontmatter.source_external_updated_at),
-      synced_at: optStr(frontmatter.source_synced_at),
+      id: optStr2(frontmatter.source_id),
+      title: optStr2(frontmatter.source_title),
+      context: optStr2(frontmatter.source_context),
+      provider: optStr2(frontmatter.source_provider),
+      url: optStr2(frontmatter.source_url),
+      imported_at: optStr2(frontmatter.source_imported_at),
+      external_updated_at: optStr2(frontmatter.source_external_updated_at),
+      synced_at: optStr2(frontmatter.source_synced_at),
       inferred: true,
       reason: `Invalid source value: "${raw}".`
     };
@@ -7974,8 +8119,8 @@ function parseWorkItemSource(frontmatter) {
   if (frontmatter.source_work_item_candidate || frontmatter.source_roadmap_initiative) {
     return {
       type: "roadmap",
-      id: optStr(frontmatter.source_id) ?? optStr(frontmatter.source_work_item_candidate),
-      title: optStr(frontmatter.source_initiative_title),
+      id: optStr2(frontmatter.source_id) ?? optStr2(frontmatter.source_work_item_candidate),
+      title: optStr2(frontmatter.source_initiative_title),
       inferred: true,
       reason: "Inferred from legacy roadmap fields."
     };
@@ -7983,7 +8128,7 @@ function parseWorkItemSource(frontmatter) {
   if (frontmatter.source_id) {
     return {
       type: "unknown",
-      id: optStr(frontmatter.source_id),
+      id: optStr2(frontmatter.source_id),
       inferred: true,
       reason: "Has source_id but no source type."
     };
@@ -7999,7 +8144,7 @@ function renderSourceCompact(source) {
   if (source.id) parts.push(source.id);
   return parts.join(" \xB7 ");
 }
-function optStr(v) {
+function optStr2(v) {
   if (typeof v === "string" && v.trim()) return v.trim();
   return void 0;
 }
@@ -8504,7 +8649,7 @@ function renderRouteCompact(route) {
 }
 
 // ../cli/src/core/metadata-health.ts
-import matter7 from "gray-matter";
+import matter8 from "gray-matter";
 var KNOWLEDGE_FILES2 = [
   "knowledge/business/business.md",
   "knowledge/product/product.md",
@@ -8524,7 +8669,7 @@ function analyzeMetadataHealth(dir) {
     let data;
     try {
       const raw = readFile(p);
-      data = matter7(raw).data;
+      data = matter8(raw).data;
     } catch {
       continue;
     }
@@ -8556,7 +8701,7 @@ function analyzeMetadataHealth(dir) {
         if (isFile(p) && entry.endsWith(".md")) {
           try {
             const raw = readFile(p);
-            const fm = matter7(raw).data;
+            const fm = matter8(raw).data;
             if (fm.status === "done") {
               const rel = p.replace(dir + "/", "").replace(dir + "\\", "").replace(/\\/g, "/");
               findings.push({
@@ -9323,7 +9468,7 @@ function renderExplanationAgent(exp) {
 var HISTORY_DIR = ".kaddo/history";
 var RUNS_PATH = `${HISTORY_DIR}/guard-runs.jsonl`;
 var SUMMARY_PATH = `${HISTORY_DIR}/guard-summary.json`;
-function toPosix5(p) {
+function toPosix6(p) {
   return p.replace(/\\/g, "/");
 }
 function loadGuardRuns(dir) {
@@ -9360,7 +9505,7 @@ function resolveDriftThreads(runs) {
     let resolvedAt;
     for (const r2 of sorted) {
       if (r2.generated_at <= lastWarn) continue;
-      const touched = r2.touched_files.some((f3) => toPosix5(f3) === codePath);
+      const touched = r2.touched_files.some((f3) => toPosix6(f3) === codePath);
       const warnedHere = r2.warnings.some((x2) => x2.code_path === codePath);
       const updatedRelated = r2.updated_artifacts.some((a2) => related.has(a2));
       if (touched && updatedRelated && !warnedHere) {
@@ -9511,7 +9656,7 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
       }
     }
     try {
-      const body = matter8(readFile(wi.filePath)).content;
+      const body = matter9(readFile(wi.filePath)).content;
       if (hasSection(body, /acceptance|criterios de aceptaci/i)) withAcceptance++;
       else gaps.missing_acceptance_criteria.push(gapItem(wi, "Add an `## Acceptance Criteria` section."));
       if (hasSection(body, /definition of done|^#{1,6}\s*dod\b|definici[oó]n de (terminado|hecho)/i)) withDoD++;
@@ -10224,25 +10369,25 @@ function serializeDriftJson(r2) {
 }
 
 // src/workitems.ts
-import matter9 from "gray-matter";
+import matter10 from "gray-matter";
 var VALID_SOURCES2 = /* @__PURE__ */ new Set(["manual", "roadmap", "jira", "github", "notion", "xlsx", "csv", "api", "external", "unknown"]);
-function optStr2(v) {
+function optStr3(v) {
   return typeof v === "string" && v.trim() ? v.trim() : void 0;
 }
 function parseSource(data) {
   const rawSource = data.source;
   if (rawSource != null && typeof rawSource === "object" && !Array.isArray(rawSource)) {
     const obj = rawSource;
-    const t = optStr2(obj.type);
+    const t = optStr3(obj.type);
     const type = t && VALID_SOURCES2.has(t) ? t : "unknown";
-    return { type, id: optStr2(obj.id) ?? optStr2(data.source_id), title: optStr2(obj.title) ?? optStr2(data.source_title), url: optStr2(obj.url) ?? optStr2(data.source_url), provider: optStr2(obj.provider) ?? optStr2(data.source_provider), inferred: obj.inferred === true || obj.inferred === "true" };
+    return { type, id: optStr3(obj.id) ?? optStr3(data.source_id), title: optStr3(obj.title) ?? optStr3(data.source_title), url: optStr3(obj.url) ?? optStr3(data.source_url), provider: optStr3(obj.provider) ?? optStr3(data.source_provider), inferred: obj.inferred === true || obj.inferred === "true" };
   }
   const raw = rawSource ? String(rawSource) : "";
   if (raw && VALID_SOURCES2.has(raw)) {
-    return { type: raw, id: optStr2(data.source_id), title: optStr2(data.source_title), url: optStr2(data.source_url), provider: optStr2(data.source_provider), inferred: false };
+    return { type: raw, id: optStr3(data.source_id), title: optStr3(data.source_title), url: optStr3(data.source_url), provider: optStr3(data.source_provider), inferred: false };
   }
   if (data.source_work_item_candidate || data.source_roadmap_initiative) {
-    return { type: "roadmap", id: optStr2(data.source_id) ?? optStr2(data.source_work_item_candidate), title: optStr2(data.source_initiative_title), inferred: true };
+    return { type: "roadmap", id: optStr3(data.source_id) ?? optStr3(data.source_work_item_candidate), title: optStr3(data.source_initiative_title), inferred: true };
   }
   return { type: "unknown", inferred: true };
 }
@@ -10315,7 +10460,7 @@ function listWorkItems(root) {
     if (raw === null) continue;
     let parsed;
     try {
-      parsed = matter9(raw);
+      parsed = matter10(raw);
     } catch {
       continue;
     }
@@ -10790,7 +10935,7 @@ import fs3 from "fs";
 import path3 from "path";
 import { z as z3 } from "zod";
 import { parse as parseYaml10 } from "yaml";
-import matter10 from "gray-matter";
+import matter11 from "gray-matter";
 import matter22 from "gray-matter";
 import { parse as parseYaml62, stringify as stringifyYaml32 } from "yaml";
 import { parse as parseYaml22 } from "yaml";
@@ -10798,26 +10943,26 @@ import { parse as parseYaml32 } from "yaml";
 import { parse as parseYaml52, stringify as stringifyYaml22 } from "yaml";
 import { parse as parseYaml42, stringify as stringifyYaml4 } from "yaml";
 import matter32 from "gray-matter";
-import { parse as parseYaml72 } from "yaml";
 import matter42 from "gray-matter";
+import { parse as parseYaml72 } from "yaml";
+import matter52 from "gray-matter";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { dirname as dirname2, join as join22, parse as parse2 } from "path";
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
-import matter52 from "gray-matter";
 import matter62 from "gray-matter";
+import matter72 from "gray-matter";
 import { parse as parseYaml82, stringify as stringifyYaml42 } from "yaml";
 import fs32 from "fs";
 import path32 from "path";
 import crypto2 from "crypto";
-import matter72 from "gray-matter";
+import matter82 from "gray-matter";
 import crypto3 from "crypto";
 import fs4 from "fs";
-import matter82 from "gray-matter";
 import matter92 from "gray-matter";
+import matter102 from "gray-matter";
 import { parse as parseYaml92, stringify as stringifyYaml5 } from "yaml";
 import { parse as parseYaml102, stringify as stringifyYaml6 } from "yaml";
-import matter102 from "gray-matter";
-import matter11 from "gray-matter";
+import matter112 from "gray-matter";
 function exists2(p) {
   return fs3.existsSync(p);
 }
@@ -10985,7 +11130,7 @@ function parseImpactAnalysis2(data) {
 }
 function parseArtifact2(filePath, raw) {
   try {
-    const { data } = matter10(raw);
+    const { data } = matter11(raw);
     const globs = Array.isArray(data.code) ? data.code.filter(Boolean) : [];
     return {
       filePath,
@@ -11078,16 +11223,16 @@ function emptyLifecycleCounts2() {
   return Object.fromEntries(LIFECYCLE_STATES2.map((s) => [s, 0]));
 }
 var ARCH_DIR3 = "knowledge";
-function toPosix6(p) {
+function toPosix7(p) {
   return p.replace(/\\/g, "/");
 }
 function relativeTo2(dir, filePath) {
-  const base = toPosix6(dir).replace(/\/+$/, "");
-  const full = toPosix6(filePath);
+  const base = toPosix7(dir).replace(/\/+$/, "");
+  const full = toPosix7(filePath);
   return full.startsWith(base + "/") ? full.slice(base.length + 1) : full;
 }
 function isWorkItemArtifact2(a2) {
-  return toPosix6(a2.filePath).includes("/delivery/work-items/") && Boolean(a2.type);
+  return toPosix7(a2.filePath).includes("/delivery/work-items/") && Boolean(a2.type);
 }
 function classifyLayer2(posixPath) {
   if (posixPath.includes("/knowledge/business/")) return "business";
@@ -11099,7 +11244,7 @@ function classifyLayer2(posixPath) {
   return "unknown";
 }
 function enrich2(dir, a2) {
-  const posix = toPosix6(a2.filePath);
+  const posix = toPosix7(a2.filePath);
   const isWi = isWorkItemArtifact2(a2);
   return {
     ...a2,
@@ -12333,20 +12478,226 @@ function loadExternalRegistry2(dir) {
     return [];
   }
 }
+var INITIATIVES_DIR2 = "knowledge/delivery/initiatives";
+var INITIATIVE_STATES2 = [
+  "candidate",
+  "planned",
+  "in-progress",
+  "completed",
+  "deferred",
+  "cancelled"
+];
+var INITIATIVE_TRANSITIONS = {
+  candidate: ["planned", "cancelled"],
+  planned: ["in-progress", "deferred", "cancelled"],
+  "in-progress": ["completed", "deferred", "cancelled"],
+  deferred: ["planned", "cancelled"],
+  completed: [],
+  cancelled: []
+};
+var STATUS_SET2 = new Set(INITIATIVE_STATES2);
+function isValidInitiativeStatus2(s) {
+  return STATUS_SET2.has(s);
+}
+function isValidInitiativeTransition(from, to) {
+  return INITIATIVE_TRANSITIONS[from].includes(to);
+}
+function toPosix22(p) {
+  return p.replace(/\\/g, "/");
+}
+function optStr4(v) {
+  if (typeof v === "string" && v.trim()) return v.trim();
+  if (typeof v === "number") return String(v);
+  return void 0;
+}
+function strList2(v) {
+  if (!Array.isArray(v)) return [];
+  return v.map((x2) => typeof x2 === "string" ? x2.trim() : String(x2)).filter(Boolean);
+}
+function parseCandidates2(data) {
+  const raw = data.candidates;
+  if (!Array.isArray(raw)) return [];
+  const out = [];
+  for (const entry of raw) {
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) continue;
+    const o2 = entry;
+    const id = optStr4(o2.id);
+    const title = optStr4(o2.title);
+    if (!id || !title) continue;
+    out.push({
+      id,
+      title,
+      type: optStr4(o2.type),
+      suggestedKnowledgeLevel: optStr4(o2.suggested_knowledge_level ?? o2.knowledge_level),
+      expectedValue: optStr4(o2.expected_value),
+      notes: optStr4(o2.notes),
+      sourceSignals: strList2(o2.source_signals),
+      dependencies: strList2(o2.dependencies),
+      materializedAs: optStr4(o2.materialized_as) ?? null
+    });
+  }
+  return out;
+}
+function parseExternalLinks2(data) {
+  const raw = data.external_links;
+  if (!Array.isArray(raw)) return [];
+  const out = [];
+  for (const entry of raw) {
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) continue;
+    const o2 = entry;
+    const integration = optStr4(o2.integration);
+    const externalId = optStr4(o2.external_id);
+    if (!integration || !externalId) continue;
+    out.push({
+      integration,
+      externalId,
+      externalType: optStr4(o2.external_type),
+      url: optStr4(o2.url),
+      externalStatus: optStr4(o2.external_status)
+    });
+  }
+  return out;
+}
+function parseInitiative2(dir, filePath, raw) {
+  let parsed;
+  try {
+    parsed = matter32(raw, {});
+  } catch {
+    return null;
+  }
+  const data = parsed.data;
+  if (optStr4(data.type) !== "initiative") return null;
+  const id = optStr4(data.id);
+  if (!id) return null;
+  const statusRaw = optStr4(data.status) ?? "planned";
+  const status = isValidInitiativeStatus2(statusRaw) ? statusRaw : "planned";
+  return {
+    id,
+    title: optStr4(data.title) ?? id,
+    status,
+    horizon: optStr4(data.horizon) ?? null,
+    priority: optStr4(data.priority) ?? null,
+    knowledgeLevel: optStr4(data.knowledge_level) ?? null,
+    domains: strList2(data.domains),
+    relatedCapabilities: strList2(data.related_capabilities),
+    source: optStr4(data.source) ?? null,
+    sourceId: optStr4(data.source_id) ?? null,
+    createdAt: optStr4(data.created_at) ?? null,
+    externalLinks: parseExternalLinks2(data),
+    candidates: parseCandidates2(data),
+    filePath,
+    relPath: toPosix22(filePath).startsWith(toPosix22(dir) + "/") ? toPosix22(filePath).slice(toPosix22(dir).length + 1) : toPosix22(filePath),
+    body: parsed.content.trim(),
+    rawFrontmatter: data
+  };
+}
+function discoverInitiatives2(dir) {
+  const iniDir = join3(dir, INITIATIVES_DIR2);
+  if (!exists2(iniDir)) return [];
+  const out = [];
+  for (const entry of readDir2(iniDir)) {
+    if (!entry.endsWith(".md")) continue;
+    const full = join3(iniDir, entry);
+    if (!isFile2(full)) continue;
+    const ini = parseInitiative2(dir, full, readFile2(full));
+    if (ini) out.push(ini);
+  }
+  return out.sort((a2, b2) => a2.id.localeCompare(b2.id));
+}
+function getInitiative(dir, id) {
+  const want = id.trim().toLowerCase();
+  return discoverInitiatives2(dir).find((i) => i.id.toLowerCase() === want) ?? null;
+}
+function nextInitiativeId(dir) {
+  const iniDir = join3(dir, INITIATIVES_DIR2);
+  let max = 0;
+  if (exists2(iniDir)) {
+    for (const entry of readDir2(iniDir)) {
+      const m2 = entry.match(/INI-(\d+)/);
+      if (m2) max = Math.max(max, parseInt(m2[1], 10));
+    }
+  }
+  return `INI-${String(max + 1).padStart(3, "0")}`;
+}
+function workItemBelongsToInitiative(workItemInitiative, iniId) {
+  const v = (workItemInitiative ?? "").trim().toLowerCase();
+  return v !== "" && v === iniId.trim().toLowerCase();
+}
+function associatedWorkItems(dir, iniId) {
+  return discoverWorkItems2(dir).filter((wi) => workItemBelongsToInitiative(wi.initiative, iniId)).map((wi) => ({
+    id: wi.id,
+    title: wi.title,
+    status: wi.lifecycle ?? "ready"
+  })).sort((a2, b2) => a2.id.localeCompare(b2.id));
+}
+function computeInitiativeProgress(dir, ini) {
+  const totalCandidates = ini.candidates.length;
+  const materialized = ini.candidates.filter((c) => c.materializedAs).length;
+  const byState = emptyLifecycleCounts2();
+  const associated = associatedWorkItems(dir, ini.id);
+  for (const wi of associated) byState[wi.status]++;
+  return {
+    initiative: ini.id,
+    status: ini.status,
+    planning: {
+      totalCandidates,
+      materialized,
+      remaining: Math.max(0, totalCandidates - materialized)
+    },
+    delivery: {
+      total: associated.length,
+      byState
+    }
+  };
+}
+function getInitiativeContext(dir, ini) {
+  return {
+    initiative: {
+      id: ini.id,
+      title: ini.title,
+      status: ini.status,
+      horizon: ini.horizon,
+      priority: ini.priority,
+      knowledgeLevel: ini.knowledgeLevel,
+      domains: ini.domains,
+      relatedCapabilities: ini.relatedCapabilities,
+      source: ini.source,
+      sourceId: ini.sourceId
+    },
+    progress: computeInitiativeProgress(dir, ini),
+    candidates: {
+      total: ini.candidates.length,
+      materialized: ini.candidates.filter((c) => c.materializedAs),
+      pending: ini.candidates.filter((c) => !c.materializedAs)
+    },
+    workItems: associatedWorkItems(dir, ini.id),
+    externalLinks: ini.externalLinks
+  };
+}
+function suggestInitiativesForExternalItem(dir, integration, externalId) {
+  const wantIntegration = integration.trim().toLowerCase();
+  const wantId = externalId.trim().toLowerCase();
+  if (!wantIntegration || !wantId) return [];
+  return discoverInitiatives2(dir).filter(
+    (ini) => ini.externalLinks.some(
+      (l2) => l2.integration.trim().toLowerCase() === wantIntegration && l2.externalId.trim().toLowerCase() === wantId
+    )
+  );
+}
 var KNOWLEDGE22 = "knowledge";
 var ACTIVE_STATUSES2 = ["draft", "ready", "in-progress", "blocked"];
 var ALL_STATUSES2 = ["draft", "ready", "in-progress", "blocked", "completed"];
 function scopeStatuses2(scope) {
   return scope === "all" ? { included: ALL_STATUSES2, excluded: ["archived"] } : { included: ACTIVE_STATUSES2, excluded: ["completed", "archived"] };
 }
-function toPosix22(p) {
+function toPosix32(p) {
   return p.replace(/\\/g, "/");
 }
 function slug3(s) {
   return s.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
 function isAdr3(a2) {
-  return toPosix22(a2.filePath).includes("/tech/decisions/") && Boolean(a2.type);
+  return toPosix32(a2.filePath).includes("/tech/decisions/") && Boolean(a2.type);
 }
 function buildGraph2(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
   const scope = opts.scope ?? "active";
@@ -12385,6 +12736,33 @@ function buildGraph2(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
   const includedSet = new Set(included);
   const activeWICount = workItems.filter((a2) => a2.lifecycle && isActiveState2(a2.lifecycle)).length;
   const selectedWIs = workItems.filter((a2) => a2.lifecycle && includedSet.has(a2.lifecycle));
+  for (const ini of discoverInitiatives2(dir)) {
+    const iniNodeId = `initiative:${slug3(ini.id) || ini.id}`;
+    addNode({
+      id: iniNodeId,
+      type: "initiative",
+      label: `${ini.id} ${ini.title}`.trim(),
+      path: ini.relPath,
+      status: ini.status
+    });
+    for (const cap of ini.relatedCapabilities) {
+      if (!cap.trim()) continue;
+      const capId = `capability:${slug3(cap) || cap}`;
+      addNode({ id: capId, type: "capability", label: cap });
+      addEdge(iniNodeId, capId, "targets");
+    }
+    for (const link of ini.externalLinks) {
+      const extId = `external-item:${slug3(link.integration) || link.integration}:${slug3(link.externalId) || link.externalId}`;
+      addNode({ id: extId, type: "external-item", label: `${link.integration}:${link.externalId}`, path: link.url });
+      addEdge(iniNodeId, extId, "references_external");
+    }
+    for (const cand of ini.candidates) {
+      const candId = `candidate:${cand.id}`;
+      addNode({ id: candId, type: "roadmap-candidate", label: cand.id });
+      addEdge(candId, iniNodeId, "belongs_to");
+      if (cand.materializedAs) addEdge(candId, `wi:${cand.materializedAs}`, "materialized_as");
+    }
+  }
   for (const wi of selectedWIs) {
     const id = wi.id || wi.title;
     if (!id || !id.trim()) continue;
@@ -12478,14 +12856,14 @@ function buildGraph2(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
   };
 }
 var KNOWLEDGE32 = "knowledge";
-function toPosix32(p) {
+function toPosix42(p) {
   return p.replace(/\\/g, "/");
 }
 function slug22(s) {
   return s.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
 function isAdr22(a2) {
-  return toPosix32(a2.filePath).includes("/tech/decisions/") && Boolean(a2.type);
+  return toPosix42(a2.filePath).includes("/tech/decisions/") && Boolean(a2.type);
 }
 function capabilityHeadings2(dir) {
   const p = join3(dir, KNOWLEDGE32, "product", "capabilities.md");
@@ -15950,19 +16328,19 @@ function parseWorkItemSource2(frontmatter) {
   const rawSource = frontmatter.source;
   if (rawSource != null && typeof rawSource === "object" && !Array.isArray(rawSource)) {
     const obj = rawSource;
-    const t = optStr3(obj.type);
+    const t = optStr22(obj.type);
     const type = t && isValidSource2(t) ? t : "unknown";
     return {
       type,
-      id: optStr3(obj.id) ?? optStr3(frontmatter.source_id),
-      title: optStr3(obj.title) ?? optStr3(frontmatter.source_title),
-      context: optStr3(obj.context) ?? optStr3(frontmatter.source_context),
-      provider: optStr3(obj.provider) ?? optStr3(frontmatter.source_provider),
-      integration: optStr3(obj.integration) ?? optStr3(frontmatter.source_integration),
-      url: optStr3(obj.url) ?? optStr3(frontmatter.source_url),
-      imported_at: optStr3(obj.imported_at) ?? optStr3(frontmatter.source_imported_at),
-      external_updated_at: optStr3(obj.external_updated_at) ?? optStr3(frontmatter.source_external_updated_at),
-      synced_at: optStr3(obj.synced_at) ?? optStr3(frontmatter.source_synced_at),
+      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),
       inferred: obj.inferred === true || obj.inferred === "true",
       reason: t && !isValidSource2(t) ? `Invalid source type in object: "${t}".` : void 0
     };
@@ -15971,28 +16349,28 @@ function parseWorkItemSource2(frontmatter) {
   if (raw && isValidSource2(raw)) {
     return {
       type: raw,
-      id: optStr3(frontmatter.source_id),
-      title: optStr3(frontmatter.source_title),
-      context: optStr3(frontmatter.source_context),
-      provider: optStr3(frontmatter.source_provider),
-      url: optStr3(frontmatter.source_url),
-      imported_at: optStr3(frontmatter.source_imported_at),
-      external_updated_at: optStr3(frontmatter.source_external_updated_at),
-      synced_at: optStr3(frontmatter.source_synced_at),
+      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),
       inferred: false
     };
   }
   if (raw && !isValidSource2(raw)) {
     return {
       type: "unknown",
-      id: optStr3(frontmatter.source_id),
-      title: optStr3(frontmatter.source_title),
-      context: optStr3(frontmatter.source_context),
-      provider: optStr3(frontmatter.source_provider),
-      url: optStr3(frontmatter.source_url),
-      imported_at: optStr3(frontmatter.source_imported_at),
-      external_updated_at: optStr3(frontmatter.source_external_updated_at),
-      synced_at: optStr3(frontmatter.source_synced_at),
+      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),
       inferred: true,
       reason: `Invalid source value: "${raw}".`
     };
@@ -16000,8 +16378,8 @@ function parseWorkItemSource2(frontmatter) {
   if (frontmatter.source_work_item_candidate || frontmatter.source_roadmap_initiative) {
     return {
       type: "roadmap",
-      id: optStr3(frontmatter.source_id) ?? optStr3(frontmatter.source_work_item_candidate),
-      title: optStr3(frontmatter.source_initiative_title),
+      id: optStr22(frontmatter.source_id) ?? optStr22(frontmatter.source_work_item_candidate),
+      title: optStr22(frontmatter.source_initiative_title),
       inferred: true,
       reason: "Inferred from legacy roadmap fields."
     };
@@ -16009,7 +16387,7 @@ function parseWorkItemSource2(frontmatter) {
   if (frontmatter.source_id) {
     return {
       type: "unknown",
-      id: optStr3(frontmatter.source_id),
+      id: optStr22(frontmatter.source_id),
       inferred: true,
       reason: "Has source_id but no source type."
     };
@@ -16020,7 +16398,7 @@ function parseWorkItemSource2(frontmatter) {
     reason: "No source metadata found."
   };
 }
-function optStr3(v) {
+function optStr22(v) {
   if (typeof v === "string" && v.trim()) return v.trim();
   return void 0;
 }
@@ -16438,7 +16816,7 @@ var PROVENANCE = /* @__PURE__ */ new Set(["declared", "derived", "agent-reviewed
 function isRelative(p) {
   return typeof p === "string" && p.trim() !== "" && !/^([a-zA-Z]:[\\/]|\/)/.test(p) && !p.includes("..");
 }
-function strList(v) {
+function strList22(v) {
   return Array.isArray(v) ? v.map((x2) => typeof x2 === "string" ? x2.trim() : "").filter(Boolean) : [];
 }
 function loadSystemTopology(dir) {
@@ -16479,7 +16857,7 @@ function parseTopologyContent(raw, dir) {
     const moduleRaw = typeof e.module === "string" ? e.module.trim() : void 0;
     if (moduleRaw && !validModules.has(moduleRaw)) findings.push({ level: "warning", message: `Entity "${id}" references unregistered module "${moduleRaw}".` });
     const rawImpl = e.implementation ?? e.implementation_refs;
-    const implementation = strList(rawImpl).filter((p) => {
+    const implementation = strList22(rawImpl).filter((p) => {
       if (isRelative(p)) return true;
       findings.push({ level: "warning", message: `Entity "${id}" implementation ref "${p}" is not a safe relative path and was dropped.` });
       return false;
@@ -16487,7 +16865,7 @@ function parseTopologyContent(raw, dir) {
     const prov = e.provenance;
     const provOrigin = typeof prov === "string" ? prov : prov && typeof prov === "object" && typeof prov.origin === "string" ? String(prov.origin) : void 0;
     const provenance = provOrigin && PROVENANCE.has(provOrigin) ? provOrigin : void 0;
-    const evidence = strList(e.evidence ?? (prov && typeof prov === "object" ? prov.evidence_refs : void 0)).filter(isRelative);
+    const evidence = strList22(e.evidence ?? (prov && typeof prov === "object" ? prov.evidence_refs : void 0)).filter(isRelative);
     seenIds.add(id);
     entities.push({
       id,
@@ -16496,7 +16874,7 @@ function parseTopologyContent(raw, dir) {
       ...typeof e.purpose === "string" && e.purpose.trim() ? { purpose: e.purpose.trim() } : {},
       ...moduleRaw && validModules.has(moduleRaw) ? { moduleId: moduleRaw } : {},
       implementationRefs: implementation,
-      knowledgeRefs: strList(e.knowledge ?? e.knowledge_refs),
+      knowledgeRefs: strList22(e.knowledge ?? e.knowledge_refs),
       ...provenance ? { provenance } : {},
       evidence
     });
@@ -16530,7 +16908,7 @@ function parseTopologyContent(raw, dir) {
     }
     seenRels.add(key);
     const prov = r2.provenance;
-    relationships.push({ from, to, type, evidence: strList(r2.evidence ?? prov?.evidence_refs).filter(isRelative) });
+    relationships.push({ from, to, type, evidence: strList22(r2.evidence ?? prov?.evidence_refs).filter(isRelative) });
   }
   return { entities, relationships, findings, ...sourceRevision ? { sourceRevision } : {} };
 }
@@ -16663,7 +17041,7 @@ function parseOriginalSnapshot(fm) {
 function readBody(filePath) {
   try {
     const raw = readFile2(filePath);
-    return matter62(raw).content;
+    return matter72(raw).content;
   } catch {
     return "";
   }
@@ -16747,7 +17125,7 @@ function normalizeImpact(ia) {
     ...v.question ? { question: v.question } : {}
   }));
 }
-function optStr22(v) {
+function optStr32(v) {
   if (typeof v === "string" && v.trim()) return v.trim();
   return void 0;
 }
@@ -16762,13 +17140,13 @@ function parseEvidence(fm) {
     const validations = Array.isArray(d3.validations) ? d3.validations.map((v) => ({
       command: String(v.command ?? ""),
       status: String(v.status ?? "unknown"),
-      ...optStr22(v.reason) ? { reason: optStr22(v.reason) } : {}
+      ...optStr32(v.reason) ? { reason: optStr32(v.reason) } : {}
     })) : [];
     const migrations = Array.isArray(d3.migrations) ? d3.migrations.map((m2) => ({
       id: String(m2.id ?? ""),
       environment: String(m2.environment ?? ""),
       status: String(m2.status ?? "unknown"),
-      ...optStr22(m2.reason) ? { reason: optStr22(m2.reason) } : {}
+      ...optStr32(m2.reason) ? { reason: optStr32(m2.reason) } : {}
     })) : [];
     out.push({
       module,
@@ -16786,8 +17164,8 @@ function parseReleaseGates(fm) {
   return fm.release_gates.filter((g) => g && typeof g === "object").map((g) => ({
     id: String(g.id ?? ""),
     status: String(g.status ?? "pending"),
-    ...optStr22(g.reason) ? { reason: optStr22(g.reason) } : {},
-    ...optStr22(g.required_for) ? { requiredFor: optStr22(g.required_for) } : {}
+    ...optStr32(g.reason) ? { reason: optStr32(g.reason) } : {},
+    ...optStr32(g.required_for) ? { requiredFor: optStr32(g.required_for) } : {}
   }));
 }
 function parseExceptions(fm) {
@@ -16795,9 +17173,9 @@ function parseExceptions(fm) {
   return fm.completion_exceptions.filter((e) => e && typeof e === "object").map((e) => ({
     id: String(e.id ?? ""),
     status: String(e.status ?? "proposed"),
-    ...optStr22(e.reason) ? { reason: optStr22(e.reason) } : {},
-    ...optStr22(e.category) ? { category: optStr22(e.category) } : {},
-    ...optStr22(e.impact) ? { impact: optStr22(e.impact) } : {}
+    ...optStr32(e.reason) ? { reason: optStr32(e.reason) } : {},
+    ...optStr32(e.category) ? { category: optStr32(e.category) } : {},
+    ...optStr32(e.impact) ? { impact: optStr32(e.impact) } : {}
   }));
 }
 function parseDecisions(decisions, knowledgeById) {
@@ -16940,7 +17318,7 @@ ${out.join("\n\n")}
 `.replace(/\n{3,}/g, "\n\n");
 }
 function serialize(data, body) {
-  return matter72.stringify(`
+  return matter82.stringify(`
 ${body.trim()}
 `, data);
 }
@@ -17692,7 +18070,7 @@ function detectFormat(raw) {
   if (!trimmed) throw new ImportError("EMPTY_INPUT", "Import content is empty.");
   if (trimmed.startsWith("---")) {
     try {
-      const { data } = matter82(trimmed);
+      const { data } = matter92(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)) {
@@ -17714,7 +18092,7 @@ function parseContent(raw) {
   let bodyText = trimmed;
   if (format === "kaddo-frontmatter" || format === "markdown-frontmatter") {
     try {
-      const parsed = matter82(trimmed);
+      const parsed = matter92(trimmed);
       frontmatterFields = parsed.data ?? {};
       bodyText = parsed.content.trim();
     } catch {
@@ -17805,7 +18183,7 @@ function findDuplicateByHash(dir, hash) {
     const raw = readFile2(item.filePath);
     if (!raw) continue;
     try {
-      const { data } = matter82(raw);
+      const { data } = matter92(raw);
       const source = data?.source;
       if (source && typeof source === "object" && !Array.isArray(source)) {
         const s = source;
@@ -18587,201 +18965,6 @@ function getStatus(dir) {
     lastError: null
   };
 }
-var INITIATIVES_DIR = "knowledge/delivery/initiatives";
-var INITIATIVE_STATES = [
-  "candidate",
-  "planned",
-  "in-progress",
-  "completed",
-  "deferred",
-  "cancelled"
-];
-var INITIATIVE_TRANSITIONS = {
-  candidate: ["planned", "cancelled"],
-  planned: ["in-progress", "deferred", "cancelled"],
-  "in-progress": ["completed", "deferred", "cancelled"],
-  deferred: ["planned", "cancelled"],
-  completed: [],
-  cancelled: []
-};
-var STATUS_SET = new Set(INITIATIVE_STATES);
-function isValidInitiativeStatus(s) {
-  return STATUS_SET.has(s);
-}
-function isValidInitiativeTransition(from, to) {
-  return INITIATIVE_TRANSITIONS[from].includes(to);
-}
-function toPosix42(p) {
-  return p.replace(/\\/g, "/");
-}
-function optStr32(v) {
-  if (typeof v === "string" && v.trim()) return v.trim();
-  if (typeof v === "number") return String(v);
-  return void 0;
-}
-function strList2(v) {
-  if (!Array.isArray(v)) return [];
-  return v.map((x2) => typeof x2 === "string" ? x2.trim() : String(x2)).filter(Boolean);
-}
-function parseCandidates(data) {
-  const raw = data.candidates;
-  if (!Array.isArray(raw)) return [];
-  const out = [];
-  for (const entry of raw) {
-    if (!entry || typeof entry !== "object" || Array.isArray(entry)) continue;
-    const o2 = entry;
-    const id = optStr32(o2.id);
-    const title = optStr32(o2.title);
-    if (!id || !title) continue;
-    out.push({
-      id,
-      title,
-      type: optStr32(o2.type),
-      suggestedKnowledgeLevel: optStr32(o2.suggested_knowledge_level ?? o2.knowledge_level),
-      expectedValue: optStr32(o2.expected_value),
-      notes: optStr32(o2.notes),
-      sourceSignals: strList2(o2.source_signals),
-      dependencies: strList2(o2.dependencies),
-      materializedAs: optStr32(o2.materialized_as) ?? null
-    });
-  }
-  return out;
-}
-function parseExternalLinks(data) {
-  const raw = data.external_links;
-  if (!Array.isArray(raw)) return [];
-  const out = [];
-  for (const entry of raw) {
-    if (!entry || typeof entry !== "object" || Array.isArray(entry)) continue;
-    const o2 = entry;
-    const integration = optStr32(o2.integration);
-    const externalId = optStr32(o2.external_id);
-    if (!integration || !externalId) continue;
-    out.push({
-      integration,
-      externalId,
-      externalType: optStr32(o2.external_type),
-      url: optStr32(o2.url)
-    });
-  }
-  return out;
-}
-function parseInitiative(dir, filePath, raw) {
-  let parsed;
-  try {
-    parsed = matter102(raw, {});
-  } catch {
-    return null;
-  }
-  const data = parsed.data;
-  if (optStr32(data.type) !== "initiative") return null;
-  const id = optStr32(data.id);
-  if (!id) return null;
-  const statusRaw = optStr32(data.status) ?? "planned";
-  const status = isValidInitiativeStatus(statusRaw) ? statusRaw : "planned";
-  return {
-    id,
-    title: optStr32(data.title) ?? id,
-    status,
-    horizon: optStr32(data.horizon) ?? null,
-    priority: optStr32(data.priority) ?? null,
-    knowledgeLevel: optStr32(data.knowledge_level) ?? null,
-    domains: strList2(data.domains),
-    relatedCapabilities: strList2(data.related_capabilities),
-    source: optStr32(data.source) ?? null,
-    sourceId: optStr32(data.source_id) ?? null,
-    createdAt: optStr32(data.created_at) ?? null,
-    externalLinks: parseExternalLinks(data),
-    candidates: parseCandidates(data),
-    filePath,
-    relPath: toPosix42(filePath).startsWith(toPosix42(dir) + "/") ? toPosix42(filePath).slice(toPosix42(dir).length + 1) : toPosix42(filePath),
-    body: parsed.content.trim(),
-    rawFrontmatter: data
-  };
-}
-function discoverInitiatives(dir) {
-  const iniDir = join3(dir, INITIATIVES_DIR);
-  if (!exists2(iniDir)) return [];
-  const out = [];
-  for (const entry of readDir2(iniDir)) {
-    if (!entry.endsWith(".md")) continue;
-    const full = join3(iniDir, entry);
-    if (!isFile2(full)) continue;
-    const ini = parseInitiative(dir, full, readFile2(full));
-    if (ini) out.push(ini);
-  }
-  return out.sort((a2, b2) => a2.id.localeCompare(b2.id));
-}
-function getInitiative(dir, id) {
-  const want = id.trim().toLowerCase();
-  return discoverInitiatives(dir).find((i) => i.id.toLowerCase() === want) ?? null;
-}
-function nextInitiativeId(dir) {
-  const iniDir = join3(dir, INITIATIVES_DIR);
-  let max = 0;
-  if (exists2(iniDir)) {
-    for (const entry of readDir2(iniDir)) {
-      const m2 = entry.match(/INI-(\d+)/);
-      if (m2) max = Math.max(max, parseInt(m2[1], 10));
-    }
-  }
-  return `INI-${String(max + 1).padStart(3, "0")}`;
-}
-function workItemBelongsToInitiative(workItemInitiative, iniId) {
-  const v = (workItemInitiative ?? "").trim().toLowerCase();
-  return v !== "" && v === iniId.trim().toLowerCase();
-}
-function associatedWorkItems(dir, iniId) {
-  return discoverWorkItems2(dir).filter((wi) => workItemBelongsToInitiative(wi.initiative, iniId)).map((wi) => ({
-    id: wi.id,
-    title: wi.title,
-    status: wi.lifecycle ?? "ready"
-  })).sort((a2, b2) => a2.id.localeCompare(b2.id));
-}
-function computeInitiativeProgress(dir, ini) {
-  const totalCandidates = ini.candidates.length;
-  const materialized = ini.candidates.filter((c) => c.materializedAs).length;
-  const byState = emptyLifecycleCounts2();
-  const associated = associatedWorkItems(dir, ini.id);
-  for (const wi of associated) byState[wi.status]++;
-  return {
-    initiative: ini.id,
-    status: ini.status,
-    planning: {
-      totalCandidates,
-      materialized,
-      remaining: Math.max(0, totalCandidates - materialized)
-    },
-    delivery: {
-      total: associated.length,
-      byState
-    }
-  };
-}
-function getInitiativeContext(dir, ini) {
-  return {
-    initiative: {
-      id: ini.id,
-      title: ini.title,
-      status: ini.status,
-      horizon: ini.horizon,
-      priority: ini.priority,
-      knowledgeLevel: ini.knowledgeLevel,
-      domains: ini.domains,
-      relatedCapabilities: ini.relatedCapabilities,
-      source: ini.source,
-      sourceId: ini.sourceId
-    },
-    progress: computeInitiativeProgress(dir, ini),
-    candidates: {
-      total: ini.candidates.length,
-      materialized: ini.candidates.filter((c) => c.materializedAs),
-      pending: ini.candidates.filter((c) => !c.materializedAs)
-    },
-    workItems: associatedWorkItems(dir, ini.id),
-    externalLinks: ini.externalLinks
-  };
-}
 var WORK_ITEMS_DIR2 = "knowledge/delivery/work-items";
 var DRAFT_DIR = `${WORK_ITEMS_DIR2}/draft`;
 var InitiativeWriteError = class extends Error {
@@ -18811,6 +18994,7 @@ function externalLinkToData(l2) {
   const out = { integration: l2.integration, external_id: l2.externalId };
   if (l2.externalType) out.external_type = l2.externalType;
   if (l2.url) out.url = l2.url;
+  if (l2.externalStatus) out.external_status = l2.externalStatus;
   return out;
 }
 function normalizeCandidate(input, fallbackId) {
@@ -18870,7 +19054,7 @@ function defaultBody(title) {
 }
 function buildInitiativeContent(id, input) {
   const status = input.status ?? "planned";
-  if (!isValidInitiativeStatus(status)) {
+  if (!isValidInitiativeStatus2(status)) {
     throw new InitiativeWriteError(`Invalid initiative status: ${status}.`);
   }
   const candidates = (input.candidates ?? []).map(
@@ -18892,36 +19076,36 @@ 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 matter11.stringify("\n" + (input.body ?? defaultBody(input.title.trim())), data);
+  return matter112.stringify("\n" + (input.body ?? defaultBody(input.title.trim())), data);
 }
 function createInitiative(dir, input) {
   if (!input.title?.trim()) throw new InitiativeWriteError("Initiative title is required.");
   const id = nextInitiativeId(dir);
   const fileName = `${id}-${slugify3(input.title)}.md`;
-  const iniDir = join3(dir, INITIATIVES_DIR);
+  const iniDir = join3(dir, INITIATIVES_DIR2);
   ensureDir2(iniDir);
   const filePath = join3(iniDir, fileName);
   const content = buildInitiativeContent(id, input);
   writeFile2(filePath, content);
-  const ini = parseInitiative(dir, filePath, content);
+  const ini = parseInitiative2(dir, filePath, content);
   if (!ini) throw new InitiativeWriteError("Failed to parse the Initiative just written.");
   return ini;
 }
 function transitionInitiative(dir, id, to) {
   const ini = getInitiative(dir, id);
   if (!ini) throw new InitiativeWriteError(`Initiative ${id} not found.`);
-  if (!isValidInitiativeStatus(to)) throw new InitiativeWriteError(`Invalid status: ${to}.`);
+  if (!isValidInitiativeStatus2(to)) throw new InitiativeWriteError(`Invalid status: ${to}.`);
   if (ini.status === to) return ini;
   if (!isValidInitiativeTransition(ini.status, to)) {
     throw new InitiativeWriteError(`Invalid transition ${ini.status} \u2192 ${to}.`);
   }
   const raw = readFile2(ini.filePath);
-  const { data, content } = matter11(raw, {});
+  const { data, content } = matter112(raw, {});
   data.status = to;
   if (to === "completed") data.completed_at = today2();
-  const newContent = matter11.stringify(content, data);
+  const newContent = matter112.stringify(content, data);
   writeFile2(ini.filePath, newContent);
-  const updated = parseInitiative(dir, ini.filePath, newContent);
+  const updated = parseInitiative2(dir, ini.filePath, newContent);
   if (!updated) throw new InitiativeWriteError("Failed to parse the Initiative after transition.");
   return updated;
 }
@@ -18929,7 +19113,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 } = matter11(raw, {});
+  const { data, content } = matter112(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);
@@ -18937,9 +19121,9 @@ function addCandidate(dir, id, candidate) {
     throw new InitiativeWriteError(`Candidate ${normalized.id} already exists in ${id}.`);
   }
   data.candidates = [...existing, candidateToData(normalized)];
-  const newContent = matter11.stringify(content, data);
+  const newContent = matter112.stringify(content, data);
   writeFile2(ini.filePath, newContent);
-  const updated = parseInitiative(dir, ini.filePath, newContent);
+  const updated = parseInitiative2(dir, ini.filePath, newContent);
   if (!updated) throw new InitiativeWriteError("Failed to parse the Initiative after adding a candidate.");
   return updated;
 }
@@ -18947,7 +19131,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 } = matter11(raw, {});
+  const { data, content } = matter112(raw, {});
   if (patch.title !== void 0) {
     if (!patch.title.trim()) throw new InitiativeWriteError("Initiative title cannot be empty.");
     data.title = patch.title.trim();
@@ -18957,12 +19141,33 @@ 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 = matter11.stringify(content, data);
+  const newContent = matter112.stringify(content, data);
   writeFile2(ini.filePath, newContent);
-  const updated = parseInitiative(dir, ini.filePath, newContent);
+  const updated = parseInitiative2(dir, ini.filePath, newContent);
   if (!updated) throw new InitiativeWriteError("Failed to parse the Initiative after update.");
   return updated;
 }
+function addExternalLink(dir, id, link) {
+  const ini = getInitiative(dir, id);
+  if (!ini) throw new InitiativeWriteError(`Initiative ${id} not found.`);
+  if (!link.integration?.trim() || !link.externalId?.trim()) {
+    throw new InitiativeWriteError("External link requires integration and externalId.");
+  }
+  if (ini.externalLinks.some(
+    (l2) => l2.integration.trim().toLowerCase() === link.integration.trim().toLowerCase() && l2.externalId.trim().toLowerCase() === link.externalId.trim().toLowerCase()
+  )) {
+    throw new InitiativeWriteError(`External link ${link.integration}:${link.externalId} already exists on ${id}.`);
+  }
+  const raw = readFile2(ini.filePath);
+  const { data, content } = matter112(raw, {});
+  const existing = Array.isArray(data.external_links) ? data.external_links : [];
+  data.external_links = [...existing, externalLinkToData(link)];
+  const newContent = matter112.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.");
+  return updated;
+}
 function nextWorkItemId2(dir) {
   const wiDir = join3(dir, WORK_ITEMS_DIR2);
   let max = 0;
@@ -19026,7 +19231,7 @@ function buildWorkItemContent(wiId, iniId, candidate) {
     "_What did we learn? Update after completion._",
     ""
   ].join("\n");
-  return matter11.stringify("\n" + body, data);
+  return matter112.stringify("\n" + body, data);
 }
 function materializeCandidate(dir, id, candidateId) {
   const ini = getInitiative(dir, id);
@@ -19043,15 +19248,15 @@ 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 } = matter11(raw, {});
+  const { data, content } = matter112(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 = matter11.stringify(content, data);
+  const newContent = matter112.stringify(content, data);
   writeFile2(ini.filePath, newContent);
-  const updated = parseInitiative(dir, ini.filePath, newContent);
+  const updated = parseInitiative2(dir, ini.filePath, newContent);
   if (!updated) throw new InitiativeWriteError("Failed to parse the Initiative after materialization.");
   return { workItemId: wiId, fileName, initiative: updated };
 }
@@ -22665,7 +22870,7 @@ function generateCapsuleDraft(root) {
 var ok5 = (data) => ({ ok: true, data });
 var fail4 = (message) => ({ ok: false, message });
 function listInitiativesTool(root) {
-  const all = discoverInitiatives(root).map((ini) => {
+  const all = discoverInitiatives2(root).map((ini) => {
     const p = computeInitiativeProgress(root, ini);
     return {
       id: ini.id,
@@ -22777,6 +22982,36 @@ function materializeInitiativeCandidateTool(root, args) {
     () => materializeCandidate(root, args.id, args.candidateId)
   );
 }
+function addInitiativeExternalLinkTool(root, args) {
+  if (!args.integration?.trim() || !args.externalId?.trim()) {
+    return fail4("integration and externalId are required.");
+  }
+  if (!getInitiative(root, args.id)) return fail4(`Initiative ${args.id} not found.`);
+  return previewOrApply(
+    args.confirm,
+    "add-initiative-external-link",
+    `A provider-neutral reference ${args.integration}:${args.externalId} will be added to ${args.id}. An external status is stored as a signal only and never changes the Initiative lifecycle.`,
+    () => addExternalLink(root, args.id, {
+      integration: args.integration,
+      externalId: args.externalId,
+      externalType: args.externalType,
+      url: args.url,
+      externalStatus: args.externalStatus
+    })
+  );
+}
+function suggestInitiativeForExternalItemTool(root, args) {
+  if (!args.integration?.trim() || !args.externalId?.trim()) {
+    return fail4("integration and externalId are required.");
+  }
+  const matches = suggestInitiativesForExternalItem(root, args.integration, args.externalId);
+  return ok5({
+    integration: args.integration,
+    externalId: args.externalId,
+    suggestions: matches.map((i) => ({ id: i.id, title: i.title, status: i.status })),
+    note: "Suggestion only \u2014 associating a Work Item with an Initiative requires human confirmation."
+  });
+}
 function analyzeInitiativeTool(root, id) {
   const ini = getInitiative(root, id);
   if (!ini) return fail4(`Initiative ${id} not found.`);
@@ -23284,6 +23519,32 @@ function createServer(root) {
     },
     async (args) => toolText(guarded(root, () => materializeInitiativeCandidateTool(root, args)))
   );
+  server.registerTool(
+    "kaddo_add_initiative_external_link",
+    {
+      title: "Add initiative external link",
+      description: `Add a provider-neutral external planning reference (Jira/ADO/GitHub/\u2026) to an initiative. An external status is stored as a signal only and never changes the Initiative lifecycle. ${INITIATIVE_WRITE_NOTE}`,
+      inputSchema: {
+        id: z4.string(),
+        integration: z4.string(),
+        externalId: z4.string(),
+        externalType: z4.string().optional(),
+        url: z4.string().optional(),
+        externalStatus: z4.string().optional(),
+        confirm: z4.boolean().optional()
+      }
+    },
+    async (args) => toolText(guarded(root, () => addInitiativeExternalLinkTool(root, args)))
+  );
+  server.registerTool(
+    "kaddo_suggest_initiative_for_external_item",
+    {
+      title: "Suggest initiative for external item",
+      description: `Given an external planning item (e.g. an imported Work Item's parent epic), suggest Initiatives whose external links reference it. Suggestion only \u2014 association requires human confirmation. ${INITIATIVE_READ_NOTE}`,
+      inputSchema: { integration: z4.string(), externalId: z4.string() }
+    },
+    async (args) => toolText(guarded(root, () => suggestInitiativeForExternalItemTool(root, args)))
+  );
   server.registerTool(
     "kaddo_analyze_initiative",
     {