@kaddo/cli 3.2.0 → 3.3.0

package/README.md

@@ -434,6 +434,7 @@ create --from roadmap → owners → guard → explain`.
 | v3.0 | Knowledge-centric realignment: `architecture/` → `knowledge/` with layers Business → Product → Tech → Delivery; context/explain by layer (breaking) |
 | v3.1 | Minimum Sufficient Knowledge: bootstrap one consolidated file per layer; progressive `add agents` by group (state default, `--all`, `--group`) |
 | v3.2 | New-project flow hardening: agents in per-layer folders; `new` recommends capability+architecture agents; explain Work Item parser fix; intent vs reality (codebase vs current-state) |
+| v3.3 | Work Item delivery lifecycle: `understand` shows branch → scan → ownership → guard → knowledge → commit for active Work Items (suggestions only; Kaddo never runs git) |
 
 **Optional modules (installed with `kaddo add`):**
 

package/dist/index.js

@@ -5185,6 +5185,66 @@ function renderUnderstandTerminal(plan) {
   return lines.join("\n");
 }
 
+// src/core/delivery.ts
+function slugify2(s) {
+  return s.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function isWorkItem(a) {
+  return a.filePath.replace(/\\/g, "/").includes("/delivery/work-items/") && Boolean(a.type);
+}
+function activeWorkItems(dir) {
+  const archDir = join(dir, "knowledge");
+  if (!exists(archDir)) return [];
+  return readArtifacts(archDir).filter((a) => isWorkItem(a) && a.status === "in-progress").map((a) => {
+    const id = a.id || a.title || "WI";
+    return { id, title: a.title || id, type: a.type, slug: slugify2(a.title || id) };
+  });
+}
+function branchPrefix(type) {
+  switch (type) {
+    case "bugfix":
+      return "bugfix";
+    case "hotfix":
+      return "hotfix";
+    case "spike":
+      return "spike";
+    default:
+      return "feature";
+  }
+}
+function commitPrefix(type) {
+  switch (type) {
+    case "bugfix":
+    case "hotfix":
+      return "fix";
+    case "spike":
+      return "chore";
+    default:
+      return "feat";
+  }
+}
+function suggestedBranch(wi) {
+  return `${branchPrefix(wi.type)}/${wi.id}-${wi.slug}`;
+}
+function suggestedCommit(wi) {
+  return `${commitPrefix(wi.type)}: ${wi.title.toLowerCase()}`;
+}
+function renderDeliveryLifecycle(wi) {
+  return [
+    `Active work item: ${wi.id} \u2014 ${wi.title}`,
+    "",
+    "Delivery lifecycle (Kaddo never runs git for you):",
+    `  1. Create a branch          e.g. ${suggestedBranch(wi)}`,
+    "  2. Implement the work item",
+    "  3. Run `kaddo scan`         (after new modules/migrations/contracts)",
+    "  4. Run `kaddo owners suggest`  \u2192 confirm code: globs",
+    "  5. Run `kaddo guard`        before committing (detect knowledge drift)",
+    "  6. Update knowledge         ADR / capabilities.md / current-state.md as needed",
+    "  7. Review (human)",
+    `  8. Commit                   e.g. ${suggestedCommit(wi)}`
+  ];
+}
+
 // src/commands/understand.ts
 function runUnderstand() {
   const dir = cwd();
@@ -5247,6 +5307,15 @@ function runUnderstand() {
   if (groupAgents.length > 0) {
     console.log(`Agents for this phase: ${groupAgents.join(", ")}`);
   }
+  const active = activeWorkItems(dir);
+  if (active.length > 0) {
+    console.log("");
+    for (const line of renderDeliveryLifecycle(active[0])) console.log(line);
+    if (active.length > 1) {
+      console.log("");
+      console.log(`Other active work items: ${active.slice(1).map((w) => w.id).join(", ")}`);
+    }
+  }
   writeFile(join(dir, ".kaddo", "understand.md"), renderUnderstand(plan));
   log2.success("Wrote .kaddo/understand.md");
   outro2("Handoff ready. CLI prepares context \u2014 your LLM creates the understanding.");
@@ -7638,7 +7707,7 @@ var MODULE_TYPES = [
   "data",
   "unknown"
 ];
-function slugify2(name) {
+function slugify3(name) {
   return name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
 function readModulesDescriptor(dir) {
@@ -7658,7 +7727,7 @@ function moduleDir(id) {
   return `knowledge/tech/modules/${id}`;
 }
 function buildModule(input) {
-  const id = slugify2(input.name);
+  const id = slugify3(input.name);
   const base = moduleDir(id);
   return {
     id,
@@ -7925,7 +7994,7 @@ async function runBootstrap(dir = cwd()) {
 
 // src/index.ts
 var program = new Command();
-program.name("kaddo").description("Knowledge Driven Development toolkit").version("3.2.0");
+program.name("kaddo").description("Knowledge Driven Development toolkit").version("3.3.0");
 program.command("init").description("Initialize Kaddo in the current project").action(async () => {
   await runInit();
 });

package/package.json

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