@kaddo/mcp 3.66.0 → 3.67.0

package/dist/index.js

@@ -3963,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) {
@@ -4391,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";
@@ -4403,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";
@@ -7627,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",
@@ -7878,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,
@@ -8368,6 +8384,20 @@ function buildProjectExplanation(dir) {
     scanSignals: loadScanSignals(dir),
     metadataHealth: analyzeMetadataHealth(dir),
     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;
@@ -8379,11 +8409,13 @@ function buildProjectExplanation(dir) {
           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: lifecycleStateOf({ status: a2.status, filePath: a2.filePath }),
-        implementationStatus: a2.implementationStatus || "not-started",
-        validationStatus: a2.validationStatus || "not-started",
+        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 : [],
@@ -8628,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;
@@ -8662,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");
@@ -10173,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);
 }
@@ -10876,19 +10930,21 @@ var OPERATING_RULES = [
   "Kaddo itself never calls an LLM and never runs git \u2014 every git action is the human\u2019s."
 ];
 function toContextWorkItem(a2) {
+  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)
   };
-  if (a2.implementationStatus) wi.implementationStatus = a2.implementationStatus;
-  if (a2.validationStatus) wi.validationStatus = a2.validationStatus;
-  if (a2.releaseStatus) wi.releaseStatus = a2.releaseStatus;
+  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;
 }
@@ -10919,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 }))
   );
-  if (workItems.length === 0 && !moduleRepo) {
+  const completedWorkItems = allWorkItemArtifacts.filter(
+    (a2) => lifecycleStateOf({ status: a2.status, filePath: a2.filePath }) === "completed"
+  );
+  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;
@@ -11037,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,
@@ -11053,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.66.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": {