@kaddo/cli 3.74.0 → 3.74.1

package/dist/core.js

@@ -7724,6 +7724,194 @@ import fs2 from "fs";
 import path2 from "path";
 import crypto from "crypto";
 import matter7 from "gray-matter";
+
+// src/core/knowledge-levels.ts
+var WORK_ITEM_TYPES2 = ["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",
+    description: "Trivial change. No formal knowledge required.",
+    questions: [],
+    qualityGate: []
+  },
+  K1: {
+    level: "K1",
+    description: "Simple fix or hotfix.",
+    questions: [
+      {
+        id: "problem",
+        prompt: "What problem does this fix?",
+        placeholder: "e.g. Button is not clickable on mobile",
+        frontMatterField: "problem",
+        required: true
+      },
+      {
+        id: "expected_result",
+        prompt: "What is the expected result after the fix?",
+        placeholder: "e.g. Button works correctly on all screen sizes",
+        frontMatterField: "expected_result",
+        required: true
+      }
+    ],
+    qualityGate: ["Problem is clear.", "Expected result is defined."]
+  },
+  K2: {
+    level: "K2",
+    description: "Feature or bugfix with functional impact.",
+    questions: [
+      {
+        id: "problem",
+        prompt: "What problem does this solve?",
+        placeholder: "e.g. Users cannot complete checkout without email verification",
+        frontMatterField: "problem",
+        required: true
+      },
+      {
+        id: "expected_result",
+        prompt: "What is the expected result?",
+        placeholder: "e.g. Users can verify email inline during checkout",
+        frontMatterField: "expected_result",
+        required: true
+      },
+      {
+        id: "impact",
+        prompt: "What is the impact if this is not done?",
+        placeholder: "e.g. ~30% of users drop off at checkout",
+        frontMatterField: "impact",
+        required: true
+      },
+      {
+        id: "acceptance_criteria",
+        prompt: "What are the acceptance criteria? (one per line, press Enter twice to finish)",
+        placeholder: "e.g. Email is verified before payment step",
+        frontMatterField: "acceptance_criteria",
+        required: true
+      }
+    ],
+    qualityGate: [
+      "Problem is clear.",
+      "Expected result is defined.",
+      "Impact of not doing it is stated.",
+      "Acceptance criteria are verifiable."
+    ]
+  },
+  K3: {
+    level: "K3",
+    description: "Capability, integration, or significant functional change.",
+    questions: [
+      {
+        id: "problem",
+        prompt: "What problem does this solve?",
+        placeholder: "e.g. Payments need to support multiple providers",
+        frontMatterField: "problem",
+        required: true
+      },
+      {
+        id: "impact",
+        prompt: "What is the impact if this is not done?",
+        placeholder: "e.g. We are locked into a single provider with no fallback",
+        frontMatterField: "impact",
+        required: true
+      },
+      {
+        id: "acceptance_criteria",
+        prompt: "What are the acceptance criteria?",
+        placeholder: "e.g. System routes to provider B when provider A fails",
+        frontMatterField: "acceptance_criteria",
+        required: true
+      },
+      {
+        id: "design",
+        prompt: "What is the proposed design or approach?",
+        placeholder: "e.g. Abstract provider interface + strategy pattern",
+        frontMatterField: "design",
+        required: true
+      }
+    ],
+    qualityGate: [
+      "Problem is clear.",
+      "Impact is stated.",
+      "Acceptance criteria are verifiable.",
+      "Design is sufficient to start."
+    ]
+  },
+  K4: {
+    level: "K4",
+    description: "Architecture change, migration, or high-risk decision.",
+    questions: [
+      {
+        id: "problem",
+        prompt: "What problem does this solve?",
+        placeholder: "e.g. Current auth system does not support SSO",
+        frontMatterField: "problem",
+        required: true
+      },
+      {
+        id: "impact",
+        prompt: "What is the impact if this is not done?",
+        placeholder: "e.g. Enterprise clients cannot onboard",
+        frontMatterField: "impact",
+        required: true
+      },
+      {
+        id: "design",
+        prompt: "What is the proposed design or approach?",
+        placeholder: "e.g. Replace JWT-only auth with OIDC + JWT hybrid",
+        frontMatterField: "design",
+        required: true
+      },
+      {
+        id: "risks",
+        prompt: "What are the main risks?",
+        placeholder: "e.g. Existing sessions may be invalidated during migration",
+        frontMatterField: "risks",
+        required: true
+      }
+    ],
+    qualityGate: [
+      "Problem is clear.",
+      "Impact is stated.",
+      "Design is documented.",
+      "Risks are identified.",
+      "ADR is created or linked if applicable."
+    ]
+  }
+};
+var TYPE_TO_LEVEL = {
+  hotfix: "K1",
+  bugfix: "K2",
+  feature: "K2",
+  spike: "K3",
+  // Chores are maintenance/config/tooling work — low ceremony (problem + expected result).
+  chore: "K1"
+};
+function getLevel(level) {
+  return LEVELS[level];
+}
+function getLevelForType(type) {
+  return TYPE_TO_LEVEL[type];
+}
+function isValidType(type) {
+  return WORK_ITEM_TYPES2.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/core/work-item-write.ts
 var WORK_ITEMS_DIR = "knowledge/delivery/work-items";
 var WorkItemWriteError = class extends Error {
   constructor(code, message) {
@@ -8032,8 +8220,8 @@ function captureBody(title, type, answers) {
 function createWorkItem(dir, opts) {
   const intent = opts.intent.trim();
   if (!intent) throw new WorkItemWriteError("INVALID_INPUT", "An intent or summary is required.");
-  const type = opts.type.trim() || "feature";
-  if (!WORK_ITEM_TYPES.has(type)) throw new WorkItemWriteError("INVALID_INPUT", `Unknown Work Item type "${type}".`);
+  const type = normalizeType(opts.type.trim()) ?? "";
+  if (!type) throw new WorkItemWriteError("INVALID_INPUT", `Unknown Work Item type "${opts.type}".`);
   const id = nextWorkItemId(dir);
   const title = intent.split(/\r?\n/)[0].trim().slice(0, 120);
   const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
@@ -8073,7 +8261,7 @@ function createWorkItem(dir, opts) {
 }
 function validateInput(input) {
   if (!input.title.trim()) throw new WorkItemWriteError("INVALID_INPUT", "Title is required.");
-  if (!WORK_ITEM_TYPES.has(input.type)) throw new WorkItemWriteError("INVALID_INPUT", `Unknown Work Item type "${input.type}".`);
+  if (!isValidType(input.type)) throw new WorkItemWriteError("INVALID_INPUT", `Unknown Work Item type "${input.type}".`);
 }
 function updateWorkItem(dir, id, input, expectedRevision) {
   validateInput(input);
@@ -8152,173 +8340,6 @@ function transitionWorkItem(dir, id, to, expectedRevision) {
   return { revision: revisionOf(nextRaw), status: to, path: targetRel };
 }
 
-// src/core/knowledge-levels.ts
-var WORK_ITEM_TYPES2 = ["feature", "bugfix", "hotfix", "spike", "chore"];
-var LEVELS = {
-  K0: {
-    level: "K0",
-    description: "Trivial change. No formal knowledge required.",
-    questions: [],
-    qualityGate: []
-  },
-  K1: {
-    level: "K1",
-    description: "Simple fix or hotfix.",
-    questions: [
-      {
-        id: "problem",
-        prompt: "What problem does this fix?",
-        placeholder: "e.g. Button is not clickable on mobile",
-        frontMatterField: "problem",
-        required: true
-      },
-      {
-        id: "expected_result",
-        prompt: "What is the expected result after the fix?",
-        placeholder: "e.g. Button works correctly on all screen sizes",
-        frontMatterField: "expected_result",
-        required: true
-      }
-    ],
-    qualityGate: ["Problem is clear.", "Expected result is defined."]
-  },
-  K2: {
-    level: "K2",
-    description: "Feature or bugfix with functional impact.",
-    questions: [
-      {
-        id: "problem",
-        prompt: "What problem does this solve?",
-        placeholder: "e.g. Users cannot complete checkout without email verification",
-        frontMatterField: "problem",
-        required: true
-      },
-      {
-        id: "expected_result",
-        prompt: "What is the expected result?",
-        placeholder: "e.g. Users can verify email inline during checkout",
-        frontMatterField: "expected_result",
-        required: true
-      },
-      {
-        id: "impact",
-        prompt: "What is the impact if this is not done?",
-        placeholder: "e.g. ~30% of users drop off at checkout",
-        frontMatterField: "impact",
-        required: true
-      },
-      {
-        id: "acceptance_criteria",
-        prompt: "What are the acceptance criteria? (one per line, press Enter twice to finish)",
-        placeholder: "e.g. Email is verified before payment step",
-        frontMatterField: "acceptance_criteria",
-        required: true
-      }
-    ],
-    qualityGate: [
-      "Problem is clear.",
-      "Expected result is defined.",
-      "Impact of not doing it is stated.",
-      "Acceptance criteria are verifiable."
-    ]
-  },
-  K3: {
-    level: "K3",
-    description: "Capability, integration, or significant functional change.",
-    questions: [
-      {
-        id: "problem",
-        prompt: "What problem does this solve?",
-        placeholder: "e.g. Payments need to support multiple providers",
-        frontMatterField: "problem",
-        required: true
-      },
-      {
-        id: "impact",
-        prompt: "What is the impact if this is not done?",
-        placeholder: "e.g. We are locked into a single provider with no fallback",
-        frontMatterField: "impact",
-        required: true
-      },
-      {
-        id: "acceptance_criteria",
-        prompt: "What are the acceptance criteria?",
-        placeholder: "e.g. System routes to provider B when provider A fails",
-        frontMatterField: "acceptance_criteria",
-        required: true
-      },
-      {
-        id: "design",
-        prompt: "What is the proposed design or approach?",
-        placeholder: "e.g. Abstract provider interface + strategy pattern",
-        frontMatterField: "design",
-        required: true
-      }
-    ],
-    qualityGate: [
-      "Problem is clear.",
-      "Impact is stated.",
-      "Acceptance criteria are verifiable.",
-      "Design is sufficient to start."
-    ]
-  },
-  K4: {
-    level: "K4",
-    description: "Architecture change, migration, or high-risk decision.",
-    questions: [
-      {
-        id: "problem",
-        prompt: "What problem does this solve?",
-        placeholder: "e.g. Current auth system does not support SSO",
-        frontMatterField: "problem",
-        required: true
-      },
-      {
-        id: "impact",
-        prompt: "What is the impact if this is not done?",
-        placeholder: "e.g. Enterprise clients cannot onboard",
-        frontMatterField: "impact",
-        required: true
-      },
-      {
-        id: "design",
-        prompt: "What is the proposed design or approach?",
-        placeholder: "e.g. Replace JWT-only auth with OIDC + JWT hybrid",
-        frontMatterField: "design",
-        required: true
-      },
-      {
-        id: "risks",
-        prompt: "What are the main risks?",
-        placeholder: "e.g. Existing sessions may be invalidated during migration",
-        frontMatterField: "risks",
-        required: true
-      }
-    ],
-    qualityGate: [
-      "Problem is clear.",
-      "Impact is stated.",
-      "Design is documented.",
-      "Risks are identified.",
-      "ADR is created or linked if applicable."
-    ]
-  }
-};
-var TYPE_TO_LEVEL = {
-  hotfix: "K1",
-  bugfix: "K2",
-  feature: "K2",
-  spike: "K3",
-  // Chores are maintenance/config/tooling work — low ceremony (problem + expected result).
-  chore: "K1"
-};
-function getLevel(level) {
-  return LEVELS[level];
-}
-function getLevelForType(type) {
-  return TYPE_TO_LEVEL[type];
-}
-
 // src/core/work-item-refinement.ts
 function toCapture(q) {
   return { id: q.id, prompt: q.prompt, placeholder: q.placeholder, field: q.frontMatterField, required: q.required };

package/package.json

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