@kaddo/cli 3.10.0 → 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.");
 }
 
@@ -5976,7 +6019,7 @@ function flowForState(state) {
 }
 function buildUnderstandPlan(dir, config) {
   const state = config.project.state;
-  const flow = flowForState(state);
+  const flow = flowForState(state).filter((s) => !exists(join(dir, s.output)));
   const steps = flow.map((s) => {
     const installed = agentIsInstalled(dir, s.agent);
     return { agent: s.agent, output: s.output, installed };
@@ -6077,24 +6120,26 @@ function renderUnderstandTerminal(plan) {
   lines.push(`Team: ${project.teamSize}`);
   lines.push(`Structure: ${project.structure}`);
   lines.push("");
-  lines.push("Recommended flow:");
-  steps.forEach((s, i) => {
-    const flag = s.installed ? "" : "  (not installed)";
-    lines.push(`  ${i + 1}. ${agentName(s.agent)} \u2192 ${s.output}${flag}`);
-  });
-  lines.push("");
   const first2 = steps[0];
   if (first2) {
+    lines.push("Foundational knowledge still needed:");
+    steps.forEach((s, i) => {
+      const flag = s.installed ? "" : "  (not installed)";
+      lines.push(`  ${i + 1}. ${agentName(s.agent)} \u2192 ${s.output}${flag}`);
+    });
+    lines.push("");
     lines.push(`First step: use ${agentName(first2.agent)}.`);
     lines.push("");
     lines.push(`  Context:         ${plan.contextPackPath}`);
     lines.push(`  Agent prompt:    knowledge/agents/${first2.agent}`);
     lines.push(`  Expected output: ${first2.output}`);
     lines.push("");
+    lines.push("Instructions:");
+    lines.push("  Open your preferred LLM chat, paste the context pack, then paste the agent");
+    lines.push("  prompt. Ask the LLM to generate the expected output and save it in the target file.");
+  } else {
+    lines.push("Foundational knowledge looks complete \u2014 see the phase recommendation below.");
   }
-  lines.push("Instructions:");
-  lines.push("  Open your preferred LLM chat, paste the context pack, then paste the agent");
-  lines.push("  prompt. Ask the LLM to generate the expected output and save it in the target file.");
   lines.push("");
   lines.push("Kaddo does not call an LLM. You stay in control of the interpretation.");
   lines.push("");
@@ -6215,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.0",
+  "version": "3.11.0",
   "description": "Knowledge Driven Development toolkit",
   "license": "MIT",
   "repository": {