@kaddo/cli 3.66.0 → 3.67.0

package/dist/index.js

@@ -6939,17 +6939,27 @@ function analyzeCrossRepoEvidence(input) {
       }
     }
   }
+  if (validationStatus === "accepted-with-exceptions") {
+    const hasExceptions = exceptions.length > 0;
+    const hasValidationGate = releaseGates.some(
+      (g) => (g.status === "pending" || g.status === "blocked") && (g.id.includes("validation") || g.id.includes("test"))
+    );
+    if (!hasExceptions && !hasValidationGate) {
+      findings.push({ id, severity: "warning", message: "Validation status is accepted-with-exceptions, but no exception evidence was found." });
+    }
+  }
   if (raw.status === "done") {
     findings.push({ id, severity: "warning", message: "Legacy status `done` detected. Canonical status is `completed`." });
   }
   if (raw.refined_by && raw.implemented_by && raw.refined_by === raw.implemented_by) {
     findings.push({ id, severity: "fyi", message: "refined_by and implemented_by point to the same agent." });
   }
+  const historicalDefault = lifecycle === "completed" || lifecycle === "archived" ? "not-assessed" : "not-started";
   return {
     id,
     lifecycle,
-    implementationStatus: implementationStatus || "not-started",
-    validationStatus: validationStatus || "not-started",
+    implementationStatus: implementationStatus || historicalDefault,
+    validationStatus: validationStatus || historicalDefault,
     releaseStatus: releaseStatus || "not-assessed",
     affectedModules,
     findings,
@@ -11741,6 +11751,8 @@ function workItemsSignal(dir) {
   if (wis.length === 0) return "none";
   if (wis.some((w) => w.lifecycle === "in-progress")) return "in-progress";
   if (wis.some((w) => w.lifecycle === "ready")) return "ready";
+  const hasActive = wis.some((w) => w.lifecycle === "draft" || w.lifecycle === "blocked");
+  if (!hasActive && wis.some((w) => w.lifecycle === "completed" || w.lifecycle === "archived")) return "completed-only";
   return "none-ready";
 }
 function installedAdapters(dir) {
@@ -12169,6 +12181,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";
@@ -12181,6 +12195,16 @@ function buildReadinessReport(dir, now = /* @__PURE__ */ new Date()) {
     nextStepRecommendation: rec
   };
 }
+function deriveDeliveryCompletedStatus(dir) {
+  const wis = discoverWorkItems(dir);
+  const completed = wis.filter((w) => lifecycleStateOf({ status: w.status, filePath: w.filePath }) === "completed");
+  if (completed.length === 0) return "delivery-completed";
+  const hasReleaseBlocked = completed.some((w) => w.releaseStatus === "blocked");
+  const hasReleaseReady = completed.some((w) => w.releaseStatus === "ready" || w.releaseStatus === "released");
+  if (hasReleaseBlocked) return "delivery-completed-release-blocked";
+  if (hasReleaseReady) return "delivery-completed-release-ready";
+  return "delivery-completed";
+}
 
 // src/core/assets.ts
 import matter5 from "gray-matter";
@@ -12544,7 +12568,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",
@@ -12795,7 +12819,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,
@@ -13210,6 +13236,20 @@ function buildProjectExplanation(dir) {
     scanSignals: loadScanSignals(dir),
     metadataHealth: analyzeMetadataHealth(dir),
     isModuleRepo: config != null && isModule(config),
+    deliverySummary: (() => {
+      const completed = workItemArtifacts.filter((a) => lifecycleStateOf({ status: a.status, filePath: a.filePath }) === "completed");
+      const archived = workItemArtifacts.filter((a) => lifecycleStateOf({ status: a.status, filePath: a.filePath }) === "archived");
+      const active = workItemArtifacts.filter((a) => isActiveState(lifecycleStateOf({ status: a.status, filePath: a.filePath })));
+      if (completed.length === 0 && archived.length === 0) return null;
+      return {
+        completedWorkItems: completed.length,
+        archivedWorkItems: archived.length,
+        activeWorkItems: active.length,
+        implementationCompleted: completed.filter((a) => a.implementationStatus === "completed").length,
+        releaseBlocked: completed.filter((a) => a.releaseStatus === "blocked").length,
+        releaseReady: completed.filter((a) => a.releaseStatus === "ready" || a.releaseStatus === "released").length
+      };
+    })(),
     implementationEvidence: workItemArtifacts.filter((a) => a.affectedModules.length > 0).map((a) => {
       const fm2 = a.rawFrontmatter;
       const evidence = fm2.implementation_evidence;
@@ -13221,11 +13261,13 @@ function buildProjectExplanation(dir) {
           status: String(data.status ?? "unknown")
         };
       }
+      const lc = lifecycleStateOf({ status: a.status, filePath: a.filePath });
+      const historicalDefault = lc === "completed" || lc === "archived" ? "not-assessed" : "not-started";
       return {
         id: a.id || a.title,
-        lifecycle: lifecycleStateOf({ status: a.status, filePath: a.filePath }),
-        implementationStatus: a.implementationStatus || "not-started",
-        validationStatus: a.validationStatus || "not-started",
+        lifecycle: lc,
+        implementationStatus: a.implementationStatus || historicalDefault,
+        validationStatus: a.validationStatus || historicalDefault,
         releaseStatus: a.releaseStatus || "not-assessed",
         affectedModules: a.affectedModules,
         releaseGates: Array.isArray(fm2.release_gates) ? fm2.release_gates : [],
@@ -13470,6 +13512,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;
@@ -13504,6 +13557,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");
@@ -13845,19 +13902,21 @@ var OPERATING_RULES = [
   "Kaddo itself never calls an LLM and never runs git \u2014 every git action is the human\u2019s."
 ];
 function toContextWorkItem(a) {
+  const lifecycle = lifecycleStateOf({ status: a.status, filePath: a.filePath });
+  const isHistorical = lifecycle === "completed" || lifecycle === "archived";
   const wi = {
     id: a.id,
     type: a.type,
     title: a.title,
     status: a.status,
-    lifecycle: lifecycleStateOf({ status: a.status, filePath: a.filePath }),
+    lifecycle,
     knowledgeLevel: a.knowledgeLevel,
     domains: a.domains,
     source: parseWorkItemSource(a.rawFrontmatter)
   };
-  if (a.implementationStatus) wi.implementationStatus = a.implementationStatus;
-  if (a.validationStatus) wi.validationStatus = a.validationStatus;
-  if (a.releaseStatus) wi.releaseStatus = a.releaseStatus;
+  wi.implementationStatus = a.implementationStatus || (isHistorical ? "not-assessed" : void 0);
+  wi.validationStatus = a.validationStatus || (isHistorical ? "not-assessed" : void 0);
+  wi.releaseStatus = a.releaseStatus || (isHistorical ? "not-assessed" : void 0);
   if (a.affectedModules.length > 0) wi.affectedModules = a.affectedModules;
   return wi;
 }
@@ -13888,10 +13947,17 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
     missing.push("No roadmap baseline found.");
   }
   const allArtifacts = discoverKnowledge(dir);
-  const workItems = allArtifacts.filter(
-    (a) => isDeliveryWorkItem(a) && isActiveState(lifecycleStateOf({ status: a.status, filePath: a.filePath }))
+  const allWorkItemArtifacts = allArtifacts.filter((a) => isDeliveryWorkItem(a));
+  const workItems = allWorkItemArtifacts.filter(
+    (a) => isActiveState(lifecycleStateOf({ status: a.status, filePath: a.filePath }))
+  );
+  const completedWorkItems = allWorkItemArtifacts.filter(
+    (a) => lifecycleStateOf({ status: a.status, filePath: a.filePath }) === "completed"
   );
-  if (workItems.length === 0 && !moduleRepo) {
+  const archivedWorkItems = allWorkItemArtifacts.filter(
+    (a) => lifecycleStateOf({ status: a.status, filePath: a.filePath }) === "archived"
+  );
+  if (allWorkItemArtifacts.length === 0 && !moduleRepo) {
     missing.push("No work items found.");
   }
   const state = config.project.state;
@@ -14006,6 +14072,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((a) => a.codeGlobs.length > 0).map(toContextArtifact)
     },
     layers,
@@ -14022,6 +14092,30 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
       const compact = (a) => ({ total: a.total, installed: a.total - a.missing, outdated: a.outdated, unknown_version: a.unknown_version, modified: a.modified });
       return { version: s.version, agents: compact(s.agents), skills: compact(s.skills) };
     })(),
+    workItemSummary: (() => {
+      const lc = (s) => allWorkItemArtifacts.filter(
+        (a) => lifecycleStateOf({ status: a.status, filePath: a.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),
@@ -14950,6 +15044,16 @@ function runUnderstand() {
     } else if (rec.agentPath) {
       console.log(`  Agent prompt: ${rec.agentPath}`);
     }
+    if (exp.deliverySummary) {
+      const ds2 = exp.deliverySummary;
+      console.log("");
+      console.log("Previous delivery:");
+      console.log(`  - Completed Work Items: ${ds2.completedWorkItems}`);
+      if (ds2.implementationCompleted > 0) console.log(`  - Implementation completed: ${ds2.implementationCompleted}`);
+      if (ds2.releaseBlocked > 0) console.log(`  - Release blocked: ${ds2.releaseBlocked}`);
+      if (ds2.releaseReady > 0) console.log(`  - Release ready: ${ds2.releaseReady}`);
+      console.log(`  - Current active work: ${ds2.activeWorkItems > 0 ? ds2.activeWorkItems : "none"}`);
+    }
     if (rec.skill) console.log(`Recommended skill: ${rec.skill}`);
     console.log(`Next step: ${rec.label}`);
     if (rec.reason) console.log(`Why: ${rec.reason}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaddo/cli",
-  "version": "3.66.0",
+  "version": "3.67.0",
   "description": "Knowledge Driven Development toolkit",
   "license": "MIT",
   "repository": {