@kaddo/cli 3.8.0 → 3.9.0

package/dist/index.js

@@ -725,6 +725,17 @@ async function runScan() {
 }
 
 // src/core/knowledge-levels.ts
+var WORK_ITEM_TYPES = ["feature", "bugfix", "hotfix", "spike", "chore"];
+var TYPE_ALIASES = {
+  setup: "chore",
+  maintenance: "chore",
+  tooling: "chore",
+  infrastructure: "chore",
+  infra: "chore",
+  config: "chore",
+  configuration: "chore",
+  refactor: "chore"
+};
 var LEVELS = {
   K0: {
     level: "K0",
@@ -879,7 +890,9 @@ var TYPE_TO_LEVEL = {
   hotfix: "K1",
   bugfix: "K2",
   feature: "K2",
-  spike: "K3"
+  spike: "K3",
+  // Chores are maintenance/config/tooling work — low ceremony (problem + expected result).
+  chore: "K1"
 };
 function getLevel(level) {
   return LEVELS[level];
@@ -888,7 +901,13 @@ function getLevelForType(type) {
   return TYPE_TO_LEVEL[type];
 }
 function isValidType(type) {
-  return ["feature", "bugfix", "hotfix", "spike"].includes(type);
+  return WORK_ITEM_TYPES.includes(type);
+}
+function normalizeType(raw) {
+  if (!raw) return null;
+  const t = raw.trim().toLowerCase();
+  if (isValidType(t)) return t;
+  return TYPE_ALIASES[t] ?? null;
 }
 
 // src/modules/adr.ts
@@ -1832,6 +1851,9 @@ Produce a roadmap where each initiative includes:
 7. Dependencies.
 8. Why this comes now.
 9. Candidate work items (each with type, suggested knowledge level, expected value, notes).
+   Use only the official Work Item types: \`feature\`, \`bugfix\`, \`hotfix\`, \`spike\`, \`chore\`.
+   Use \`chore\` for technical/maintenance/tooling/config/infra work (e.g. "Initialize
+   TypeScript project", "Configure Vitest", "Setup CI") \u2014 do not label such work \`feature\`.
 10. Open questions.
 
 Then add a suggested execution order, risks and constraints, a "Not Now" list, and the
@@ -2133,12 +2155,14 @@ A refined Work Item intended to be saved under the lifecycle workspace:
 
 1. Restate the problem in one clear sentence.
 2. Split the candidate if it is too large for a single Work Item.
-3. Validate the Knowledge Level (K0\u2013K4) and propose a different one if needed.
-4. Propose acceptance criteria.
-5. Propose Out of scope and Validation sections.
-6. Propose a Definition of Done.
-7. Identify open questions and assumptions.
-8. Suggest ownership candidates (code globs) if evident.
+3. Preserve the candidate's type (\`feature\`, \`bugfix\`, \`hotfix\`, \`spike\`, \`chore\`).
+   Keep \`chore\` for maintenance/tooling/config/infra work \u2014 never upgrade a chore to a feature.
+4. Validate the Knowledge Level (K0\u2013K4) and propose a different one if needed.
+5. Propose acceptance criteria.
+6. Propose Out of scope and Validation sections.
+7. Propose a Definition of Done.
+8. Identify open questions and assumptions.
+9. Suggest ownership candidates (code globs) if evident.
 
 ## Constraints
 
@@ -3675,20 +3699,21 @@ async function runCreate(type, opts = {}) {
   }
   if (!type) {
     console.error("Missing work item type.");
-    console.error("Usage: kaddo create <feature|bugfix|hotfix|spike> [--from roadmap]");
+    console.error("Usage: kaddo create <feature|bugfix|hotfix|spike|chore> [--from roadmap]");
     process.exit(1);
   }
   const modWorkItemType = findWorkItemType(type);
   if (modWorkItemType) {
     return runCreateModule(dir, modWorkItemType);
   }
-  if (!isValidType(type)) {
+  const workItemType = normalizeType(type);
+  if (!workItemType) {
     console.error(`Unknown work item type: "${type}"`);
-    console.error("Valid types: feature, bugfix, hotfix, spike");
+    console.error("Valid types: feature, bugfix, hotfix, spike, chore");
+    console.error("Aliases: setup, maintenance, tooling, infrastructure, refactor \u2192 chore");
     console.error("Module types: adr, incident, rfc, migration, legacy (run `kaddo add <module>` first)");
     process.exit(1);
   }
-  const workItemType = type;
   const level = getLevelForType(workItemType);
   const levelDef = getLevel(level);
   intro2(`kaddo create ${workItemType}`);
@@ -3696,7 +3721,7 @@ async function runCreate(type, opts = {}) {
   printStateGuidance(dir);
   const title = await text2({
     message: "Title for this work item",
-    placeholder: `e.g. ${workItemType === "feature" ? "Add email verification to checkout" : workItemType === "hotfix" ? "Fix null pointer in payment handler" : workItemType === "bugfix" ? "Fix broken pagination on orders list" : "Explore caching strategies for API responses"}`,
+    placeholder: `e.g. ${workItemType === "feature" ? "Add email verification to checkout" : workItemType === "hotfix" ? "Fix null pointer in payment handler" : workItemType === "bugfix" ? "Fix broken pagination on orders list" : workItemType === "chore" ? "Configure Vitest and CI pipeline" : "Explore caching strategies for API responses"}`,
     validate: (v) => v.trim().length === 0 ? "Title is required." : void 0
   });
   const answers = {};
@@ -3765,9 +3790,7 @@ ${body}`;
 }
 var K_LEVEL_RE = /^K[0-4]$/;
 function resolveCandidateType(candidate, cliType) {
-  if (candidate.type && isValidType(candidate.type)) return candidate.type;
-  if (cliType && isValidType(cliType)) return cliType;
-  return null;
+  return normalizeType(candidate.type) ?? normalizeType(cliType);
 }
 function resolveCandidateLevel(candidate, type) {
   const suggested = candidate.suggestedKnowledgeLevel?.trim().toUpperCase();
@@ -3929,7 +3952,8 @@ async function runCreateFromRoadmap(dir, cliType) {
         { value: "feature", label: "feature" },
         { value: "bugfix", label: "bugfix" },
         { value: "hotfix", label: "hotfix" },
-        { value: "spike", label: "spike" }
+        { value: "spike", label: "spike" },
+        { value: "chore", label: "chore" }
       ]
     });
   }
@@ -4725,7 +4749,7 @@ var STRUCTURED_TYPES = {
   ]),
   Delivery: /* @__PURE__ */ new Set([])
 };
-var WORK_ITEM_TYPES = /* @__PURE__ */ new Set([
+var WORK_ITEM_TYPES2 = /* @__PURE__ */ new Set([
   "work-item",
   "feature",
   "bugfix",
@@ -4738,7 +4762,7 @@ function layerForType(type) {
   if (type === CONSOLIDATED_TYPE.Product || STRUCTURED_TYPES.Product.has(type)) return "Product";
   if (type === CONSOLIDATED_TYPE.Tech || STRUCTURED_TYPES.Tech.has(type) || type === "knowledge")
     return "Tech";
-  if (type === "roadmap" || WORK_ITEM_TYPES.has(type)) return "Delivery";
+  if (type === "roadmap" || WORK_ITEM_TYPES2.has(type)) return "Delivery";
   return null;
 }
 function layerFromPath(filePath) {
@@ -4769,7 +4793,7 @@ function discoverLayers(dir) {
     slot.detected.add(basename(a.filePath));
     if (layer === "Delivery") {
       if (type === "roadmap" || basename(a.filePath) === "roadmap.md") slot.hasRoadmap = true;
-      if (WORK_ITEM_TYPES.has(type) || a.filePath.replace(/\\/g, "/").includes("/delivery/work-items/")) {
+      if (WORK_ITEM_TYPES2.has(type) || a.filePath.replace(/\\/g, "/").includes("/delivery/work-items/")) {
         if (a.filePath.replace(/\\/g, "/").includes("/delivery/work-items/")) slot.hasWorkItem = true;
       }
       continue;
@@ -4989,6 +5013,7 @@ function buildProjectExplanation(dir) {
   const items = workItemArtifacts.map((a) => ({
     id: a.id || a.title,
     title: a.title,
+    type: a.type,
     status: a.status,
     lifecycle: lifecycleStateOf({ status: a.status, filePath: a.filePath }),
     initiative: a.initiative,
@@ -4997,6 +5022,11 @@ function buildProjectExplanation(dir) {
     domains: a.domains
   }));
   const byState = lifecycleCounts(items.map((i) => i.lifecycle));
+  const byType = {};
+  for (const i of items) {
+    const t = i.type || "unknown";
+    byType[t] = (byType[t] ?? 0) + 1;
+  }
   const initiativeMap = /* @__PURE__ */ new Map();
   for (const i of items) {
     const name = i.initiative || "Unassigned";
@@ -5010,6 +5040,7 @@ function buildProjectExplanation(dir) {
     done: items.filter((i) => i.status === "done").length,
     cancelled: items.filter((i) => i.status === "cancelled").length,
     byState,
+    byType,
     initiatives,
     items
   };
@@ -5079,6 +5110,10 @@ function buildProjectExplanation(dir) {
 function stateLabel(state) {
   return state === "pre-ai" ? "pre-ai" : state;
 }
+function typeLabel(type) {
+  const cap = type.charAt(0).toUpperCase() + type.slice(1);
+  return cap.endsWith("s") ? cap : `${cap}s`;
+}
 var LIFECYCLE_LABEL = {
   draft: "Draft",
   ready: "Ready",
@@ -5140,6 +5175,12 @@ function renderExplanationHuman(exp) {
       lines.push(`- ${LIFECYCLE_LABEL[s]}: ${exp.workItems.byState[s]}`);
     }
     lines.push("");
+    const typeEntries = Object.entries(exp.workItems.byType).sort((a, b) => b[1] - a[1]);
+    if (typeEntries.length > 0) {
+      lines.push("## Work Items by Type");
+      for (const [t, n] of typeEntries) lines.push(`- ${typeLabel(t)}: ${n}`);
+      lines.push("");
+    }
     const grouped = exp.workItems.initiatives.filter(
       (g) => LIFECYCLE_STATES.some((s) => g.states[s] > 0)
     );
@@ -5512,6 +5553,13 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
     (a) => a.filePath.replace(/\\/g, "/").includes("/delivery/work-items/") && Boolean(a.type)
   ).length;
   const roadmap = roadmapStats(exists(roadmapPath) ? readFile(roadmapPath) : null, materialized);
+  const deliveryMix = {};
+  for (const a of allArtifacts) {
+    const p2 = a.filePath.replace(/\\/g, "/");
+    if (!a.type || !p2.includes("/delivery/work-items/")) continue;
+    if (!isActiveState(lifecycleStateOf({ status: a.status, filePath: a.filePath }))) continue;
+    deliveryMix[a.type] = (deliveryMix[a.type] ?? 0) + 1;
+  }
   const mappedModules = loadMappedModules(dir);
   const layers = knowledgeLayers(dir);
   return {
@@ -5542,6 +5590,7 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
     },
     layers,
     roadmap,
+    deliveryMix,
     mappedModules,
     missing,
     handoff: {
@@ -5643,6 +5692,16 @@ function renderContextPack(pack) {
   } else {
     parts.push("No active work items found.\n");
   }
+  const mixEntries = Object.entries(pack.deliveryMix).sort((a, b) => b[1] - a[1]);
+  if (mixEntries.length > 0) {
+    parts.push("## Delivery Mix\n");
+    parts.push("Active Work Items by type:\n");
+    const label = (t) => {
+      const c = t.charAt(0).toUpperCase() + t.slice(1);
+      return c.endsWith("s") ? c : `${c}s`;
+    };
+    parts.push(mixEntries.map(([t, n]) => `- ${label(t)}: ${n}`).join("\n") + "\n");
+  }
   parts.push("## Artifacts and Ownership\n");
   if (knowledge.artifacts.length > 0) {
     const lines = knowledge.artifacts.map(
@@ -8745,7 +8804,7 @@ program.command("scan").description("Detect project stack and suggest domains").
 program.command("bootstrap").description("Build the initial knowledge base for a new project (Business \u2192 Product \u2192 Tech \u2192 Delivery)").action(async () => {
   await runBootstrap();
 });
-program.command("create [type]").description("Create a work item (feature, bugfix, hotfix, spike). Use --from roadmap to create from a roadmap candidate.").option("--from <source>", "Create from a source artifact (currently: roadmap)").action(async (type, opts) => {
+program.command("create [type]").description("Create a work item (feature, bugfix, hotfix, spike, chore). Use --from roadmap to create from a roadmap candidate.").option("--from <source>", "Create from a source artifact (currently: roadmap)").action(async (type, opts) => {
   await runCreate(type ?? "", opts);
 });
 program.command("guard").description("Check if modified code has related artifacts that were not updated").option("--staged", "Check only staged files").option("--no-interactive", "Disable interactive ignore prompts").option("--ci", "CI mode: output JSON, no prompts, non-blocking").option("--json", "Output JSON (alias for --ci)").option("--workspace", "Also check local mapped module repos from .kaddo/modules.yml (opt-in)").action(async (opts) => {

package/package.json

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