@kaddo/mcp 3.50.0 → 3.51.0

package/dist/index.js

@@ -8213,10 +8213,14 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
   if (techKnowledge.discovery.legacyLocation) {
     missing.push("Tech discovery files are in the legacy `knowledge/tech/` root. Run `kaddo tech organize` to move them to `knowledge/tech/discovery/`.");
   }
+  const isBootstrap = nextStepRecommendation.id === "bootstrap";
   const unifiedPhase = {
     ...phase,
+    phase: isBootstrap ? "Setup" : phase.phase,
+    reasons: isBootstrap ? ["The knowledge baseline is incomplete."] : phase.reasons,
     nextStep: nextStepRecommendation.label,
-    recommendedAgents: nextStepRecommendation.agent ? [nextStepRecommendation.agent] : phase.recommendedAgents
+    recommendedAgents: isBootstrap ? [] : nextStepRecommendation.agent ? [nextStepRecommendation.agent] : phase.recommendedAgents,
+    llmInstructions: isBootstrap ? ["Run `kaddo bootstrap` before using agent handoff.", "Do not ask an LLM to generate baseline knowledge until bootstrap files exist."] : phase.llmInstructions
   };
   const deliveryState = { ...buildDeliveryState(dir), phase: nextStepRecommendation.phase };
   return {
@@ -8272,9 +8276,9 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
     // VS-052/VS-073.2: the handoff is driven by the unified next step, so the pack never contradicts
     // the Current Phase block above it.
     handoff: {
-      recommendedAgents: unifiedPhase.recommendedAgents.length > 0 ? unifiedPhase.recommendedAgents : recommendedAgentsForState(state),
+      recommendedAgents: isBootstrap ? [] : unifiedPhase.recommendedAgents.length > 0 ? unifiedPhase.recommendedAgents : recommendedAgentsForState(state),
       nextSteps: [nextStepRecommendation.label],
-      instructions: unifiedPhase.llmInstructions.length > 0 ? unifiedPhase.llmInstructions : LLM_INSTRUCTIONS,
+      instructions: isBootstrap ? ["No agent handoff yet.", "Run `kaddo bootstrap` first to create the baseline files."] : unifiedPhase.llmInstructions.length > 0 ? unifiedPhase.llmInstructions : LLM_INSTRUCTIONS,
       operatingRules: OPERATING_RULES
     }
   };
@@ -8736,75 +8740,87 @@ function renderUnderstand(plan) {
   const scanNote = plan.scanAvailable ? "" : " (incomplete \u2014 run `kaddo scan` first for a richer baseline)";
   parts.push(`Use \`${plan.contextPackPath}\` as the primary input${scanNote}.
 `);
-  const agentPaths = [];
-  if (plan.recommendedPaths && plan.recommendedPaths.length > 0) {
-    agentPaths.push(...plan.recommendedPaths);
-  } else if (steps.length > 0) {
-    agentPaths.push(...steps.map((s) => agentInstallPath(s.agent)));
-  }
-  if (plan.recommendedSkillPaths && plan.recommendedSkillPaths.length > 0) {
-    agentPaths.push(...plan.recommendedSkillPaths);
-  }
-  agentPaths.push(plan.contextPackPath);
-  parts.push("## Agent Prompts\n");
-  if (agentPaths.length > 1) {
-    parts.push("Use:\n");
-    parts.push(agentPaths.map((p) => `- \`${p}\``).join("\n") + "\n");
-  } else {
-    parts.push(`- \`${plan.contextPackPath}\`
+  if (!isBootstrap) {
+    const agentPaths = [];
+    if (plan.recommendedPaths && plan.recommendedPaths.length > 0) {
+      agentPaths.push(...plan.recommendedPaths);
+    } else if (steps.length > 0) {
+      agentPaths.push(...steps.map((s) => agentInstallPath(s.agent)));
+    }
+    if (plan.recommendedSkillPaths && plan.recommendedSkillPaths.length > 0) {
+      agentPaths.push(...plan.recommendedSkillPaths);
+    }
+    agentPaths.push(plan.contextPackPath);
+    parts.push("## Agent Prompts\n");
+    if (agentPaths.length > 1) {
+      parts.push("Use:\n");
+      parts.push(agentPaths.map((p) => `- \`${p}\``).join("\n") + "\n");
+    } else {
+      parts.push(`- \`${plan.contextPackPath}\`
 `);
-  }
-  if (steps.length > 0) {
-    parts.push("## Expected Outputs\n");
-    parts.push(steps.map((s) => `- \`${s.output}\``).join("\n") + "\n");
-  } else if (rec) {
-    parts.push("## Expected Outputs\n");
-    const outputs = [];
-    if (rec.target) outputs.push(`- \`${rec.target}\``);
-    if (rec.id === "refine-work-item" || rec.id === "resolve-blocker")
-      outputs.push("- Refined Work Item content.");
-    if (rec.id === "create-work-item")
-      outputs.push("- A new Work Item under `knowledge/delivery/work-items/`.");
-    if (rec.id === "implement")
-      outputs.push("- Implementation plan or code changes guided by the Work Item.");
-    if (rec.id === "guard")
-      outputs.push("- Updated knowledge artifacts reflecting recent code changes.");
-    if (rec.id === "install-adapter")
-      outputs.push("- An adapter configured and injected (`kaddo adapters list`).");
-    if (outputs.length > 0) {
-      parts.push("The LLM should produce:\n");
-      parts.push(outputs.join("\n") + "\n");
+    }
+    if (steps.length > 0) {
+      parts.push("## Expected Outputs\n");
+      parts.push(steps.map((s) => `- \`${s.output}\``).join("\n") + "\n");
+    } else if (rec) {
+      parts.push("## Expected Outputs\n");
+      const outputs = [];
+      if (rec.target) outputs.push(`- \`${rec.target}\``);
+      if (rec.id === "refine-work-item" || rec.id === "resolve-blocker")
+        outputs.push("- Refined Work Item content.");
+      if (rec.id === "create-work-item")
+        outputs.push("- A new Work Item under `knowledge/delivery/work-items/`.");
+      if (rec.id === "implement")
+        outputs.push("- Implementation plan or code changes guided by the Work Item.");
+      if (rec.id === "guard")
+        outputs.push("- Updated knowledge artifacts reflecting recent code changes.");
+      if (rec.id === "install-adapter")
+        outputs.push("- An adapter configured and injected (`kaddo adapters list`).");
+      if (outputs.length > 0) {
+        parts.push("The LLM should produce:\n");
+        parts.push(outputs.join("\n") + "\n");
+      } else {
+        parts.push("_See the primary recommendation above._\n");
+      }
+    }
+    parts.push("## Copy/Paste Instructions\n");
+    if (steps.length > 0) {
+      const first2 = steps[0];
+      parts.push(
+        [
+          `Start with **${agentName(first2.agent)}**:`,
+          "",
+          "1. Open your preferred LLM chat (Claude, ChatGPT, Cursor, Copilot, Windsurf\u2026).",
+          `2. Paste the context pack: \`${plan.contextPackPath}\``,
+          `3. Paste the agent prompt: \`${agentInstallPath(first2.agent)}\``,
+          `4. Ask the LLM to produce: \`${first2.output}\``,
+          `5. Save the result in: \`${first2.output}\``
+        ].join("\n") + "\n"
+      );
+    } else if (agentPaths.length > 1) {
+      parts.push("Paste the following into your LLM chat:\n");
+      parts.push(agentPaths.map((p, i) => `${i + 1}. \`${p}\``).join("\n") + "\n");
+      if (rec?.agent) {
+        parts.push(`Ask the LLM to follow the ${agentName(rec.agent)} instructions.
+`);
+      }
     } else {
-      parts.push("_See the primary recommendation above._\n");
+      parts.push(`Paste \`${plan.contextPackPath}\` into your LLM chat.
+`);
     }
   }
-  parts.push("## Copy/Paste Instructions\n");
-  if (steps.length > 0) {
-    const first2 = steps[0];
+  parts.push("## Next Steps\n");
+  if (isBootstrap) {
     parts.push(
       [
-        `Start with **${agentName(first2.agent)}**:`,
-        "",
-        "1. Open your preferred LLM chat (Claude, ChatGPT, Cursor, Copilot, Windsurf\u2026).",
-        `2. Paste the context pack: \`${plan.contextPackPath}\``,
-        `3. Paste the agent prompt: \`${agentInstallPath(first2.agent)}\``,
-        `4. Ask the LLM to produce: \`${first2.output}\``,
-        `5. Save the result in: \`${first2.output}\``
+        "1. Run `kaddo bootstrap`.",
+        "2. Run `kaddo add agents`.",
+        "3. Run `kaddo add skills`.",
+        "4. Run `kaddo context`.",
+        "5. Run `kaddo understand`."
       ].join("\n") + "\n"
     );
-  } else if (agentPaths.length > 1) {
-    parts.push("Paste the following into your LLM chat:\n");
-    parts.push(agentPaths.map((p, i) => `${i + 1}. \`${p}\``).join("\n") + "\n");
-    if (rec?.agent) {
-      parts.push(`Ask the LLM to follow the ${agentName(rec.agent)} instructions.
-`);
-    }
-  } else {
-    parts.push(`Paste \`${plan.contextPackPath}\` into your LLM chat.
-`);
-  }
-  parts.push("## Next Steps\n");
-  if (rec) {
+  } else if (rec) {
     const nextLines = [];
     nextLines.push(`1. ${rec.label}`);
     let n = 2;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaddo/mcp",
-  "version": "3.50.0",
+  "version": "3.51.0",
   "description": "MCP server for Kaddo project knowledge: read-only resources/tools/prompts plus safe derived generation under .kaddo/.",
   "license": "MIT",
   "repository": {