@kaddo/cli 3.10.1 → 3.11.0

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.");
 }
 
@@ -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.");
 }
 
@@ -6217,6 +6260,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.0",
   "description": "Knowledge Driven Development toolkit",
   "license": "MIT",
   "repository": {