@kaddo/mcp 3.65.0 → 3.67.0

package/dist/index.js

@@ -521,7 +521,14 @@ function parseArtifact(filePath, raw) {
       sourceId: String(data.source_id ?? ""),
       rawFrontmatter: data,
       decisions: Array.isArray(data.decisions) ? data.decisions.map(String).filter(Boolean) : [],
-      capsules: Array.isArray(data.capsules) ? data.capsules.map(String).filter(Boolean) : []
+      capsules: Array.isArray(data.capsules) ? data.capsules.map(String).filter(Boolean) : [],
+      implementationStatus: String(data.implementation_status ?? ""),
+      validationStatus: String(data.validation_status ?? ""),
+      releaseStatus: String(data.release_status ?? ""),
+      affectedModules: Array.isArray(data.affected_modules) ? data.affected_modules.map(String).filter(Boolean) : [],
+      refinedBy: String(data.refined_by ?? ""),
+      implementedBy: String(data.implemented_by ?? ""),
+      closedBy: String(data.closed_by ?? "")
     };
   } catch {
     return null;
@@ -2413,6 +2420,7 @@ function buildGraph(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
   const selectedWIs = workItems.filter((a2) => a2.lifecycle && includedSet.has(a2.lifecycle));
   for (const wi of selectedWIs) {
     const id = wi.id || wi.title;
+    if (!id || !id.trim()) continue;
     const wiNodeId = `wi:${id}`;
     addNode({
       id: wiNodeId,
@@ -2423,16 +2431,19 @@ function buildGraph(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
       knowledge_level: wi.knowledgeLevel || void 0
     });
     for (const glob of wi.codeGlobs) {
+      if (!glob || !glob.trim()) continue;
       const codeId = `code:${glob}`;
       addNode({ id: codeId, type: "code-glob", label: glob });
       addEdge(wiNodeId, codeId, "owns");
     }
     for (const cap of wi.capabilities) {
+      if (!cap || !cap.trim()) continue;
       const capId = `capability:${slug(cap) || cap}`;
       addNode({ id: capId, type: "capability", label: cap });
       addEdge(wiNodeId, capId, "implements");
     }
     for (const dec of wi.decisions) {
+      if (!dec || !dec.trim()) continue;
       const adrId = `adr:${dec}`;
       addNode({ id: adrId, type: "decision", label: dec });
       addEdge(wiNodeId, adrId, "depends_on");
@@ -2449,16 +2460,19 @@ function buildGraph(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
     }
   }
   for (const adr of all.filter(isAdr)) {
-    const adrId = `adr:${adr.id || adr.title}`;
+    const adrLabel = adr.id || adr.title;
+    if (!adrLabel || !adrLabel.trim()) continue;
+    const adrId = `adr:${adrLabel}`;
     const referenced = nodes.has(adrId);
     if (scope === "all" || referenced) {
       nodes.set(adrId, {
         id: adrId,
         type: "decision",
-        label: `${adr.id} ${adr.title}`.trim() || adr.id || adr.title,
+        label: `${adr.id} ${adr.title}`.trim() || adrLabel,
         path: adr.relPath
       });
       for (const glob of adr.codeGlobs) {
+        if (!glob || !glob.trim()) continue;
         const codeId = `code:${glob}`;
         addNode({ id: codeId, type: "code-glob", label: glob });
         addEdge(adrId, codeId, "governs");
@@ -2514,13 +2528,20 @@ function renderGraphMermaid(graph) {
     safeIds.set(id, candidate);
     return candidate;
   };
-  const escapeLabel = (s) => s.replace(/"/g, "'");
+  const escapeLabel = (s) => s.replace(/"/g, "'").replace(/\[/g, "(").replace(/\]/g, ")").replace(/\n/g, " ");
+  const validNodes = graph.nodes.filter(
+    (n) => n.id && n.id.trim() !== "" && n.label && n.label.trim() !== ""
+  );
+  const validNodeIds = new Set(validNodes.map((n) => n.id));
   const lines = ["flowchart LR"];
-  for (const node of graph.nodes) {
+  for (const node of validNodes) {
     lines.push(`  ${safe(node.id)}["${escapeLabel(node.label)}"]`);
   }
-  if (graph.edges.length > 0) lines.push("");
-  for (const edge of graph.edges) {
+  const validEdges = graph.edges.filter(
+    (e) => validNodeIds.has(e.from) && validNodeIds.has(e.to)
+  );
+  if (validEdges.length > 0) lines.push("");
+  for (const edge of validEdges) {
     lines.push(`  ${safe(edge.from)} -->|${edge.type}| ${safe(edge.to)}`);
   }
   return lines.join("\n") + "\n";
@@ -3942,6 +3963,8 @@ function workItemsSignal(dir) {
   if (wis.length === 0) return "none";
   if (wis.some((w3) => w3.lifecycle === "in-progress")) return "in-progress";
   if (wis.some((w3) => w3.lifecycle === "ready")) return "ready";
+  const hasActive = wis.some((w3) => w3.lifecycle === "draft" || w3.lifecycle === "blocked");
+  if (!hasActive && wis.some((w3) => w3.lifecycle === "completed" || w3.lifecycle === "archived")) return "completed-only";
   return "none-ready";
 }
 function installedAdapters(dir) {
@@ -4370,6 +4393,8 @@ function buildReadinessReport(dir, now = /* @__PURE__ */ new Date()) {
   else if (understand === "missing") overall = "scanned";
   else if (firstWeak) overall = "knowledge-incomplete";
   else if (oq.summary.blocking_open > 0) overall = "needs-decisions";
+  else if (work_items === "in-progress") overall = "active-implementation";
+  else if (work_items === "completed-only") overall = deriveDeliveryCompletedStatus(dir);
   else if (roadmap !== "has-candidates") overall = "ready-for-roadmap";
   else if (work_items === "none" || work_items === "none-ready") overall = "ready-for-work-item";
   else overall = "ready-for-implementation";
@@ -4382,6 +4407,16 @@ function buildReadinessReport(dir, now = /* @__PURE__ */ new Date()) {
     nextStepRecommendation: rec
   };
 }
+function deriveDeliveryCompletedStatus(dir) {
+  const wis = discoverWorkItems(dir);
+  const completed = wis.filter((w3) => lifecycleStateOf({ status: w3.status, filePath: w3.filePath }) === "completed");
+  if (completed.length === 0) return "delivery-completed";
+  const hasReleaseBlocked = completed.some((w3) => w3.releaseStatus === "blocked");
+  const hasReleaseReady = completed.some((w3) => w3.releaseStatus === "ready" || w3.releaseStatus === "released");
+  if (hasReleaseBlocked) return "delivery-completed-release-blocked";
+  if (hasReleaseReady) return "delivery-completed-release-ready";
+  return "delivery-completed";
+}
 
 // ../cli/src/core/assets.ts
 import matter6 from "gray-matter";
@@ -7606,7 +7641,7 @@ var refineWorkItem = {
   id: "refine-work-item",
   label: "Refine Work Item",
   evaluate: (ctx) => {
-    if (ctx.readyWorkItems > 0 || ctx.inProgressWorkItems > 0) return { status: "done" };
+    if (ctx.readyWorkItems > 0 || ctx.inProgressWorkItems > 0 || ctx.blockedWorkItems > 0 || ctx.completedWorkItems > 0 || ctx.archivedWorkItems > 0) return { status: "done" };
     if (ctx.draftWorkItems > 0) {
       return {
         status: "current",
@@ -7857,7 +7892,9 @@ function buildRouteContext(dir) {
     draftWorkItems: byState("draft"),
     readyWorkItems: byState("ready"),
     inProgressWorkItems: byState("in-progress"),
+    blockedWorkItems: byState("blocked"),
     completedWorkItems: byState("completed"),
+    archivedWorkItems: byState("archived"),
     ownershipCoverage: `${withOwnership}/${total}`,
     ownershipComplete: total > 0 && withOwnership >= total,
     decisionCandidates: td.candidates,
@@ -8030,6 +8067,33 @@ function analyzeMetadataHealth(dir) {
     if (fileDrifted) drifted++;
     else healthy++;
   }
+  const wiDir = join(dir, "knowledge/delivery/work-items");
+  if (exists(wiDir)) {
+    const walkWIs = (d3) => {
+      for (const entry of readDir(d3)) {
+        const p = join(d3, entry);
+        if (isFile(p) && entry.endsWith(".md")) {
+          try {
+            const raw = readFile(p);
+            const fm = matter7(raw).data;
+            if (fm.status === "done") {
+              const rel = p.replace(dir + "/", "").replace(dir + "\\", "").replace(/\\/g, "/");
+              findings.push({
+                file: rel,
+                field: "status",
+                issue: "inconsistent",
+                detail: "Legacy status `done` detected. Canonical status is `completed`."
+              });
+            }
+          } catch {
+          }
+        } else if (!isFile(p) && !entry.startsWith(".")) {
+          walkWIs(p);
+        }
+      }
+    };
+    walkWIs(wiDir);
+  }
   return { findings, healthy, drifted };
 }
 
@@ -8319,7 +8383,46 @@ function buildProjectExplanation(dir) {
     projectRoute: buildProjectRoute(dir),
     scanSignals: loadScanSignals(dir),
     metadataHealth: analyzeMetadataHealth(dir),
-    isModuleRepo: config != null && isModule(config)
+    isModuleRepo: config != null && isModule(config),
+    deliverySummary: (() => {
+      const completed = workItemArtifacts.filter((a2) => lifecycleStateOf({ status: a2.status, filePath: a2.filePath }) === "completed");
+      const archived = workItemArtifacts.filter((a2) => lifecycleStateOf({ status: a2.status, filePath: a2.filePath }) === "archived");
+      const active = workItemArtifacts.filter((a2) => isActiveState(lifecycleStateOf({ status: a2.status, filePath: a2.filePath })));
+      if (completed.length === 0 && archived.length === 0) return null;
+      return {
+        completedWorkItems: completed.length,
+        archivedWorkItems: archived.length,
+        activeWorkItems: active.length,
+        implementationCompleted: completed.filter((a2) => a2.implementationStatus === "completed").length,
+        releaseBlocked: completed.filter((a2) => a2.releaseStatus === "blocked").length,
+        releaseReady: completed.filter((a2) => a2.releaseStatus === "ready" || a2.releaseStatus === "released").length
+      };
+    })(),
+    implementationEvidence: workItemArtifacts.filter((a2) => a2.affectedModules.length > 0).map((a2) => {
+      const fm = a2.rawFrontmatter;
+      const evidence = fm.implementation_evidence;
+      const repos = evidence?.repositories ?? {};
+      const repoEvidence = {};
+      for (const [repoId, data] of Object.entries(repos)) {
+        repoEvidence[repoId] = {
+          role: String(data.role ?? (repoId === "core" ? "core" : "module")),
+          status: String(data.status ?? "unknown")
+        };
+      }
+      const lc = lifecycleStateOf({ status: a2.status, filePath: a2.filePath });
+      const historicalDefault = lc === "completed" || lc === "archived" ? "not-assessed" : "not-started";
+      return {
+        id: a2.id || a2.title,
+        lifecycle: lc,
+        implementationStatus: a2.implementationStatus || historicalDefault,
+        validationStatus: a2.validationStatus || historicalDefault,
+        releaseStatus: a2.releaseStatus || "not-assessed",
+        affectedModules: a2.affectedModules,
+        releaseGates: Array.isArray(fm.release_gates) ? fm.release_gates : [],
+        completionExceptions: Array.isArray(fm.completion_exceptions) ? fm.completion_exceptions : [],
+        repoEvidence
+      };
+    })
   };
 }
 function stateLabel(state) {
@@ -8445,6 +8548,36 @@ function renderExplanationHuman(exp) {
     }
     lines.push("");
   }
+  if (exp.implementationEvidence.length > 0) {
+    lines.push("## Implementation Evidence");
+    for (const ev of exp.implementationEvidence) {
+      lines.push("");
+      lines.push(`### ${ev.id}`);
+      lines.push(`- Lifecycle: ${ev.lifecycle.charAt(0).toUpperCase() + ev.lifecycle.slice(1)}`);
+      lines.push(`- Implementation: ${ev.implementationStatus}`);
+      lines.push(`- Validation: ${ev.validationStatus}`);
+      lines.push(`- Release: ${ev.releaseStatus}`);
+      if (Object.keys(ev.repoEvidence).length > 0) {
+        lines.push("Repositories:");
+        for (const [repoId, info] of Object.entries(ev.repoEvidence)) {
+          lines.push(`- ${repoId} \u2014 ${info.status}`);
+        }
+      } else if (ev.affectedModules.length > 0) {
+        lines.push(`Affected modules: ${ev.affectedModules.join(", ")}`);
+      }
+      const pendingGates = ev.releaseGates.filter((g) => g.status === "blocked" || g.status === "pending");
+      if (pendingGates.length > 0) {
+        lines.push("Pending release gates:");
+        for (const g of pendingGates) lines.push(`- ${g.id}${g.reason ? ` \u2014 ${g.reason}` : ""}`);
+      }
+      const acceptedExceptions = ev.completionExceptions.filter((e) => e.status === "accepted" || e.status === "deferred");
+      if (acceptedExceptions.length > 0) {
+        lines.push("Completion exceptions:");
+        for (const e of acceptedExceptions) lines.push(`- ${e.id}: ${e.status}${e.reason ? ` \u2014 ${e.reason}` : ""}`);
+      }
+    }
+    lines.push("");
+  }
   if (exp.domains.length > 0) {
     lines.push("## Domains");
     lines.push(`- ${exp.domains.join(", ")}`);
@@ -8527,6 +8660,17 @@ function renderExplanationHuman(exp) {
   }
   lines.push(`- Next step: ${exp.readiness.recommended_next_step.label}`);
   lines.push("");
+  if (exp.deliverySummary) {
+    const ds = exp.deliverySummary;
+    lines.push("## Delivery Summary");
+    lines.push(`- Completed Work Items: ${ds.completedWorkItems}`);
+    if (ds.archivedWorkItems > 0) lines.push(`- Archived Work Items: ${ds.archivedWorkItems}`);
+    lines.push(`- Active Work Items: ${ds.activeWorkItems}`);
+    if (ds.implementationCompleted > 0) lines.push(`- Implementation completed: ${ds.implementationCompleted}`);
+    if (ds.releaseBlocked > 0) lines.push(`- Release blocked: ${ds.releaseBlocked}`);
+    if (ds.releaseReady > 0) lines.push(`- Release ready: ${ds.releaseReady}`);
+    lines.push("");
+  }
   const rec = exp.nextStepRecommendation;
   const secondary = rec.secondary ?? [];
   const steps = secondary.length > 0 || /Delivery|Active|Maintenance/.test(rec.phase) ? [rec.label, ...secondary.map((s2) => s2.label)] : exp.suggestedNextSteps;
@@ -8561,6 +8705,10 @@ function renderExplanationHuman(exp) {
     if (!exp.isModuleRepo) {
       lines.push(`- roadmap: ${s.roadmap}`);
       lines.push(`- work-items: ${s.work_items}`);
+      if (exp.deliverySummary) {
+        lines.push(`- work-items completed: ${exp.deliverySummary.completedWorkItems}`);
+        lines.push(`- work-items active: ${exp.deliverySummary.activeWorkItems}`);
+      }
       lines.push(`- adapters: ${s.adapters.length > 0 ? s.adapters.join(", ") + " installed" : "none installed"}`);
     } else {
       lines.push("- roadmap: managed-by-core");
@@ -9641,7 +9789,16 @@ function listWorkItems(root) {
       capsules: strArray(data.capsules),
       source,
       domains,
-      readiness
+      readiness,
+      ...data.implementation_status ? { implementation_status: String(data.implementation_status) } : {},
+      ...data.validation_status ? { validation_status: String(data.validation_status) } : {},
+      ...data.release_status ? { release_status: String(data.release_status) } : {},
+      ...Array.isArray(data.affected_modules) && data.affected_modules.length > 0 ? { affected_modules: data.affected_modules.map(String) } : {},
+      ...data.refined_by ? { refined_by: String(data.refined_by) } : {},
+      ...data.implemented_by ? { implemented_by: String(data.implemented_by) } : {},
+      ...data.closed_by ? { closed_by: String(data.closed_by) } : {},
+      ...Array.isArray(data.release_gates) && data.release_gates.length > 0 ? { release_gates: data.release_gates } : {},
+      ...Array.isArray(data.completion_exceptions) && data.completion_exceptions.length > 0 ? { completion_exceptions: data.completion_exceptions } : {}
     });
   }
   return items.sort((a2, b2) => a2.id.localeCompare(b2.id));
@@ -10063,6 +10220,13 @@ function projectStatus(root) {
       agents: "managed-by-core",
       skills: "managed-by-core"
     };
+  } else {
+    result.readiness = {
+      overall: explain.readiness?.overall ?? "unknown"
+    };
+  }
+  if (explain.deliverySummary) {
+    result.deliverySummary = explain.deliverySummary;
   }
   return ok(result);
 }
@@ -10766,16 +10930,23 @@ var OPERATING_RULES = [
   "Kaddo itself never calls an LLM and never runs git \u2014 every git action is the human\u2019s."
 ];
 function toContextWorkItem(a2) {
-  return {
+  const lifecycle = lifecycleStateOf({ status: a2.status, filePath: a2.filePath });
+  const isHistorical = lifecycle === "completed" || lifecycle === "archived";
+  const wi = {
     id: a2.id,
     type: a2.type,
     title: a2.title,
     status: a2.status,
-    lifecycle: lifecycleStateOf({ status: a2.status, filePath: a2.filePath }),
+    lifecycle,
     knowledgeLevel: a2.knowledgeLevel,
     domains: a2.domains,
     source: parseWorkItemSource(a2.rawFrontmatter)
   };
+  wi.implementationStatus = a2.implementationStatus || (isHistorical ? "not-assessed" : void 0);
+  wi.validationStatus = a2.validationStatus || (isHistorical ? "not-assessed" : void 0);
+  wi.releaseStatus = a2.releaseStatus || (isHistorical ? "not-assessed" : void 0);
+  if (a2.affectedModules.length > 0) wi.affectedModules = a2.affectedModules;
+  return wi;
 }
 function toContextArtifact(a2) {
   return { id: a2.id, type: a2.type, title: a2.title, summary: a2.summary, codeGlobs: a2.codeGlobs };
@@ -10804,10 +10975,17 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
     missing.push("No roadmap baseline found.");
   }
   const allArtifacts = discoverKnowledge(dir);
-  const workItems = allArtifacts.filter(
-    (a2) => isDeliveryWorkItem(a2) && isActiveState(lifecycleStateOf({ status: a2.status, filePath: a2.filePath }))
+  const allWorkItemArtifacts = allArtifacts.filter((a2) => isDeliveryWorkItem(a2));
+  const workItems = allWorkItemArtifacts.filter(
+    (a2) => isActiveState(lifecycleStateOf({ status: a2.status, filePath: a2.filePath }))
+  );
+  const completedWorkItems = allWorkItemArtifacts.filter(
+    (a2) => lifecycleStateOf({ status: a2.status, filePath: a2.filePath }) === "completed"
   );
-  if (workItems.length === 0 && !moduleRepo) {
+  const archivedWorkItems = allWorkItemArtifacts.filter(
+    (a2) => lifecycleStateOf({ status: a2.status, filePath: a2.filePath }) === "archived"
+  );
+  if (allWorkItemArtifacts.length === 0 && !moduleRepo) {
     missing.push("No work items found.");
   }
   const state = config.project.state;
@@ -10922,6 +11100,10 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
       roadmapSummary,
       inventoryAvailable,
       workItems: workItems.map(toContextWorkItem),
+      activeWorkItems: workItems.map(toContextWorkItem),
+      completedWorkItems: completedWorkItems.map(toContextWorkItem),
+      archivedWorkItems: archivedWorkItems.map(toContextWorkItem),
+      allWorkItems: allWorkItemArtifacts.map(toContextWorkItem),
       artifacts: allArtifacts.filter((a2) => a2.codeGlobs.length > 0).map(toContextArtifact)
     },
     layers,
@@ -10938,6 +11120,30 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
       const compact = (a2) => ({ total: a2.total, installed: a2.total - a2.missing, outdated: a2.outdated, unknown_version: a2.unknown_version, modified: a2.modified });
       return { version: s.version, agents: compact(s.agents), skills: compact(s.skills) };
     })(),
+    workItemSummary: (() => {
+      const lc = (s) => allWorkItemArtifacts.filter(
+        (a2) => lifecycleStateOf({ status: a2.status, filePath: a2.filePath }) === s
+      ).length;
+      const draft = lc("draft");
+      const ready = lc("ready");
+      const inProgress = lc("in-progress");
+      const blocked = lc("blocked");
+      const completed = lc("completed");
+      const archived = lc("archived");
+      const active = draft + ready + inProgress + blocked;
+      const total = allWorkItemArtifacts.length;
+      let summary = "none";
+      if (total === 0) summary = "none";
+      else if (active === 0 && completed > 0 && archived === 0) summary = "completed-only";
+      else if (active === 0 && archived > 0 && completed === 0) summary = "archived-only";
+      else if (active === 0 && completed + archived > 0) summary = "historical-only";
+      else if (inProgress > 0) summary = "active";
+      else if (blocked > 0 && ready === 0 && inProgress === 0) summary = "blocked";
+      else if (ready > 0) summary = "ready";
+      else if (draft > 0 && ready === 0) summary = "draft-only";
+      else summary = "mixed-active";
+      return { total, active, draft, ready, in_progress: inProgress, blocked, completed, archived, summary };
+    })(),
     deliveryMix,
     external: loadExternalCapsules(dir),
     graph: loadGraphSummary(dir),

package/package.json

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