@kaddo/cli 3.10.1 → 3.11.1

package/dist/index.js

@@ -603,6 +603,46 @@ function describeProject(config) {
   return `${stateLabel4} ${config.project.structure}`;
 }
 
+// src/core/command-help.ts
+var COMMAND_HELP = {
+  init: { question: "How do I start a Kaddo project?", next: "kaddo bootstrap" },
+  bootstrap: {
+    question: "What minimum knowledge should exist?",
+    next: "kaddo add agents, then kaddo context"
+  },
+  scan: {
+    question: "What technical signals exist in the repository?",
+    next: "kaddo explain (inspect) or kaddo context (package for an LLM)"
+  },
+  context: {
+    question: "What should I give to an LLM?",
+    next: "Use the recommended agent \u2014 run kaddo understand to pick it"
+  },
+  understand: {
+    question: "What should I do now?",
+    next: "Execute the recommended action shown above"
+  },
+  explain: { question: "What does Kaddo know?", next: "kaddo understand" },
+  create: {
+    question: "How do roadmap candidates become Work Items?",
+    next: "Refine it with the work-item-agent"
+  },
+  "owners suggest": { question: "Who owns this code?", next: "kaddo guard" },
+  guard: {
+    question: "Is knowledge drifting from code?",
+    next: "Update the affected knowledge, then commit"
+  },
+  "add agents": { question: "Which agents are available?", next: "kaddo understand" }
+};
+function commandFooterLines(name) {
+  const help = COMMAND_HELP[name];
+  if (!help) return [];
+  return ["", `Question answered: ${help.question}`, `Suggested next:    ${help.next}`];
+}
+function printCommandFooter(name) {
+  for (const line of commandFooterLines(name)) console.log(line);
+}
+
 // src/commands/scan.ts
 function printResult(result) {
   console.log("");
@@ -721,6 +761,7 @@ async function runScan() {
     log2.warn("No .kaddo/config.yml found. Run `kaddo init` first to record project context.");
   }
   printStateAwareNextStep(dir);
+  printCommandFooter("scan");
   outro2("Scan complete.");
 }
 
@@ -2760,7 +2801,7 @@ Conventional Commit message \u2014 as suggestions, never executed.
 
 1. **Suggest a branch first** (do not run it). Follow the Git strategy
    (\`.kaddo/git.yml\` \u2192 \`branchNaming.pattern\`, default \`feature/<work-item-id>-<slug>\`;
-   also \`bugfix/\`, \`hotfix/\`, \`spike/\`). If no strategy exists, suggest the default and say so.
+   also \`bugfix/\`, \`hotfix/\`, \`spike/\`, \`chore/\`). If no strategy exists, suggest the default and say so.
 2. Implement the change with tests.
 3. Suggest running \`kaddo scan\` after adding modules, migrations, contracts or significant
    structure.
@@ -5554,6 +5595,7 @@ function runExplain(opts) {
     explainForAgent(dir, artifacts, opts);
   } else {
     explainForHuman(dir, artifacts, opts);
+    printCommandFooter("explain");
   }
 }
 
@@ -5944,6 +5986,7 @@ function runContext(opts = {}) {
     log2.warn(`Some context is missing (${pack.missing.length} item(s)) \u2014 see the pack's "Missing Context" section.`);
   }
   log2.info("Paste .kaddo/context-pack.md into your LLM chat alongside a Kaddo agent prompt.");
+  printCommandFooter("context");
   outro2("Context pack ready.");
 }
 
@@ -6123,6 +6166,8 @@ function branchPrefix(type) {
       return "hotfix";
     case "spike":
       return "spike";
+    case "chore":
+      return "chore";
     default:
       return "feature";
   }
@@ -6133,6 +6178,7 @@ function commitPrefix(type) {
     case "hotfix":
       return "fix";
     case "spike":
+    case "chore":
       return "chore";
     default:
       return "feat";
@@ -6217,6 +6263,7 @@ function runUnderstand() {
   }
   writeFile(join(dir, ".kaddo", "understand.md"), renderUnderstand(plan));
   log2.success("Wrote .kaddo/understand.md");
+  printCommandFooter("understand");
   outro2("Handoff ready. CLI prepares context \u2014 your LLM creates the understanding.");
 }
 

package/package.json

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