@kaddo/mcp 3.117.0 → 3.118.0

package/dist/index.js

@@ -4450,7 +4450,7 @@ function resolveNextStep(dir, now = /* @__PURE__ */ new Date()) {
   if (projectMode(config) === "poc") {
     const poc = readPocSummary(dir);
     if (!poc.exists) {
-      return { id: "bootstrap", phase: "Setup", label: "Run `kaddo bootstrap` to create the POC knowledge baseline.", command: "kaddo bootstrap", reason: `Missing ${POC_ARTIFACT_PATH}.` };
+      return { id: "poc-artifact", phase: "POC Definition", label: "Create or restore the POC artifact.", command: "kaddo project mode poc", target: POC_ARTIFACT_PATH, reason: `Missing ${POC_ARTIFACT_PATH}.` };
     }
     if (!poc.hypothesisDefined) {
       return { id: "poc-hypothesis", phase: "POC Definition", label: "Define the POC hypothesis.", target: POC_ARTIFACT_PATH, reason: "The POC needs a testable hypothesis before work begins." };
@@ -4460,12 +4460,9 @@ function resolveNextStep(dir, now = /* @__PURE__ */ new Date()) {
     }
     const qCurrentState2 = analyzeKnowledgeArtifact(dir, CS);
     const qCodebase2 = analyzeKnowledgeArtifact(dir, CB);
-    if (qCurrentState2 !== "useful" || qCodebase2 !== "useful") {
+    if (exists(join(dir, ".kaddo", "scan.json")) && (qCurrentState2 !== "useful" || qCodebase2 !== "useful")) {
       return { id: "poc-technical-context", phase: "POC Discovery", label: "Document the minimal technical context for the experiment.", target: qCurrentState2 !== "useful" ? CS : CB, agent: "architecture-agent", reason: "The experiment surface and constraints are not yet sufficiently documented." };
     }
-    if (!exists(join(dir, "knowledge", "resources"))) {
-      return { id: "poc-resources", phase: "POC Discovery", label: "Identify the project resources relevant to the experiment.", command: "kaddo resources list", reason: "No project resource catalog is available for the experiment context." };
-    }
     const delivery = buildDeliveryState(dir);
     if (delivery.total_work_items === 0) {
       return { id: "poc-create-experiment", phase: "Experiment", label: "Create the first experiment Work Item (prefer `spike`).", command: "kaddo create spike", reason: "The POC has no Work Item to produce evidence." };
@@ -8740,6 +8737,11 @@ var definePocHypothesis = {
     return { status: poc.hypothesisDefined ? "done" : "current", evidence: poc.hypothesisDefined ? [POC_ARTIFACT_PATH] : void 0, reason: poc.hypothesisDefined ? void 0 : "A POC starts with one testable hypothesis." };
   }
 };
+var ensurePocArtifact = {
+  id: "poc-artifact",
+  label: "Create POC artifact",
+  evaluate: (ctx) => exists(join(ctx.dir, POC_ARTIFACT_PATH)) ? { status: "done", evidence: [POC_ARTIFACT_PATH] } : { status: "current", command: "kaddo project mode poc", reason: "Create the canonical POC artifact before defining the experiment." }
+};
 var definePocCriteria = {
   id: "poc-success-criteria",
   label: "Define success criteria",
@@ -8748,11 +8750,15 @@ var definePocCriteria = {
     return { status: poc.successCriteriaCount > 0 ? "done" : "pending", evidence: poc.successCriteriaCount > 0 ? [POC_ARTIFACT_PATH] : void 0, reason: poc.successCriteriaCount > 0 ? void 0 : "Define observable evidence for the hypothesis." };
   }
 };
-var describePocTech = { ...describeArchitecture, id: "poc-technical-context", label: "Document minimal technical context" };
+var describePocTech = {
+  id: "poc-technical-context",
+  label: "Document minimal technical context",
+  evaluate: (ctx) => ctx.hasScan ? describeArchitecture.evaluate(ctx) : { status: "optional", command: "kaddo scan", reason: "Add technical context only when the experiment needs to inspect existing code." }
+};
 var identifyPocResources = {
   id: "poc-resources",
   label: "Identify relevant resources",
-  evaluate: (ctx) => exists(join(ctx.dir, "knowledge/resources")) ? { status: "done", evidence: ["knowledge/resources/"] } : { status: "pending", command: "kaddo resources list" }
+  evaluate: (ctx) => exists(join(ctx.dir, "knowledge/resources")) ? { status: "done", evidence: ["knowledge/resources/"] } : { status: "optional", command: "kaddo resources list", reason: "Add Project Resources only when the experiment depends on external systems." }
 };
 var createPocExperiment = {
   id: "poc-create-experiment",
@@ -8772,7 +8778,7 @@ var concludePoc = {
     return conclusion === "pending" ? { status: "pending", reason: "Record validated, rejected, or inconclusive from the evidence." } : { status: "done", evidence: [POC_ARTIFACT_PATH], reason: `Conclusion: ${conclusion}.` };
   }
 };
-var POC_STEPS = [enableKaddo, bootstrapBaseline, definePocHypothesis, definePocCriteria, describePocTech, identifyPocResources, createPocExperiment, capturePocEvidence, concludePoc];
+var POC_STEPS = [enableKaddo, ensurePocArtifact, definePocHypothesis, definePocCriteria, describePocTech, identifyPocResources, createPocExperiment, capturePocEvidence, concludePoc];
 function stepsForState(state) {
   switch (state) {
     case "new":
@@ -10965,7 +10971,7 @@ var RESOURCES = [
       root,
       "kaddo://poc",
       "knowledge/delivery/poc.md",
-      "POC artifact not found. Set `project.mode: poc` and run `kaddo bootstrap` first."
+      "POC artifact not found. Initialize in POC mode or switch with `kaddo project mode poc`."
     )
   },
   {
@@ -17138,7 +17144,6 @@ var LEGACY_STEPS2 = [
   runGuard2,
   captureLearning2
 ];
-var describePocTech2 = { ...describeArchitecture2, id: "poc-technical-context", label: "Document minimal technical context" };
 var USER_FACING_KEYWORDS_EN = [
   "user",
   "visitor",

package/package.json

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