@kaddo/mcp 3.63.0 → 3.65.0

package/dist/index.js

@@ -693,6 +693,34 @@ function firstUnrefinedLayerAgent(layers) {
   return { agent: "architecture-agent", step: "Use architecture-agent to complete knowledge/tech/current-state.md" };
 }
 function assessPhase(input) {
+  if (input.isModuleRepo) {
+    const techStatus = layer(input.layers, "Tech");
+    const techReady = !NOT_READY_LAYER.includes(techStatus);
+    if (techReady) {
+      return {
+        phase: "Ready for Core Orchestration",
+        reasons: ["Module repo \u2014 Tech layer ready", "Business/Product managed by core"],
+        recommendedAgents: [],
+        nextStep: "Module knowledge is ready for core orchestration.",
+        llmInstructions: [
+          "This is a module repo. Business, Product, and Delivery are managed by the core repo.",
+          "Do not create business, product, roadmap or Work Items here."
+        ]
+      };
+    }
+    return {
+      phase: "Knowledge Refinement",
+      reasons: ["Module repo \u2014 Tech layer incomplete", "Business/Product managed by core"],
+      recommendedAgents: ["module-context-agent"],
+      nextStep: "Use module-context-agent to refine knowledge/tech/module/module-context.md",
+      llmInstructions: [
+        "Use the module-context-agent to refine the module context.",
+        "Do not create business, product, roadmap or Work Items in this module.",
+        "Do not install agents or skills.",
+        "Do not write application code."
+      ]
+    };
+  }
   const phase = determinePhase(input);
   const reasons = buildReasons(input);
   const bs = input.workItems.byState;
@@ -3009,6 +3037,21 @@ function layerQuality(dir, layer2) {
   return worst;
 }
 function knowledgeLayers(dir) {
+  const config = loadConfig(dir);
+  if (config && isModule(config)) {
+    return [
+      { layer: "Business", status: "Not applicable", detected: [] },
+      { layer: "Product", status: "Not applicable", detected: [] },
+      ...discoverLayers(dir).filter((l2) => l2.layer === "Tech").map((l2) => {
+        if (l2.status !== "Consolidated" && l2.status !== "Structured") return l2;
+        const q3 = layerQuality(dir, l2.layer);
+        if (q3 === "placeholder") return { ...l2, status: "Placeholder" };
+        if (q3 === "weak") return { ...l2, status: "Weak" };
+        return l2;
+      }),
+      { layer: "Delivery", status: "Managed by core", detected: [] }
+    ];
+  }
   return discoverLayers(dir).map((l2) => {
     if (l2.status !== "Consolidated" && l2.status !== "Structured") return l2;
     const q3 = layerQuality(dir, l2.layer);
@@ -3918,6 +3961,13 @@ function resolveNextStep(dir, now = /* @__PURE__ */ new Date()) {
   }
   const state = config.project.state;
   const q3 = (rel) => analyzeKnowledgeArtifact(dir, rel);
+  const resolveAgent = (agent) => {
+    const file = agent.endsWith(".md") ? agent : `${agent}.md`;
+    const path4 = agentInstallPath(file);
+    const installed = isFile(join(dir, path4));
+    const group = agentGroupOf(file);
+    return { agentPath: path4, agentInstalled: installed, installCommand: installed ? void 0 : `kaddo add agents --group ${group}` };
+  };
   const moduleRepo = isModule(config);
   const coreRepo = isCore(config);
   const MC = exists(join(dir, "knowledge/tech/module/module-context.md")) ? "knowledge/tech/module/module-context.md" : "knowledge/module/module-context.md";
@@ -3933,15 +3983,26 @@ function resolveNextStep(dir, now = /* @__PURE__ */ new Date()) {
       return { id: "context", phase: "Discovery", label: "Run `kaddo context` to prepare the LLM context pack.", command: "kaddo context", reason: "No context pack has been generated yet." };
     }
     if (qMC !== "useful") {
+      const ar = resolveAgent("module-context-agent");
       return {
         id: "refine-module-context",
         phase: "Knowledge Refinement",
-        label: "Use module-context-agent to refine `knowledge/module/module-context.md`.",
+        label: "Use module-context-agent to refine `knowledge/tech/module/module-context.md`.",
         agent: "module-context-agent",
         skill: "module-context-refinement",
         target: MC,
+        agentPath: ar.agentPath,
+        agentInstalled: ar.agentInstalled,
+        installCommand: ar.installCommand,
         reason: "Module context is still a placeholder.",
-        instructions: ["Refine the module context with real knowledge about this module.", "Do not create business.md or product.md.", "Do not write code."]
+        instructions: [
+          "Refine the module context using evidence from this repository.",
+          "Use the parent system context when available.",
+          "Do not create business, product, roadmap or Work Items in this module.",
+          "Do not install agents or skills in this module.",
+          "Do not write application code.",
+          "Preserve frontmatter and record unknowns as open questions."
+        ]
       };
     }
     const qCurrentState2 = q3(CS), qCodebase2 = q3(CB);
@@ -3970,7 +4031,7 @@ function resolveNextStep(dir, now = /* @__PURE__ */ new Date()) {
     if (!exists(join(dir, ".kaddo", "understand.md"))) {
       return { id: "understand", phase: "Discovery", label: "Run `kaddo understand` to summarize the project context.", command: "kaddo understand", reason: "No understand handoff has been generated yet." };
     }
-    return { id: "module-ready", phase: "Active Delivery", label: "Module context is complete. Create and manage Work Items from the core repository.", reason: "This module's knowledge is ready. Work Items are created and tracked in the core." };
+    return { id: "module-ready", phase: "Ready for Core Orchestration", label: "Module knowledge is complete. Create and manage Work Items from the core repository.", reason: "This module's knowledge is ready for core orchestration. Work Items are created and tracked in the core." };
   }
   const qBusiness = q3(B2), qProduct = q3(P2), qCap = q3(CAP), qCurrentState = q3(CS), qCodebase = q3(CB);
   if (!coreRepo && (qBusiness === "missing" || qProduct === "missing")) {
@@ -3996,13 +4057,6 @@ function resolveNextStep(dir, now = /* @__PURE__ */ new Date()) {
     return { id: "context", phase: "Discovery", label: "Run `kaddo context` to prepare the LLM context pack.", command: "kaddo context", reason: "No context pack has been generated yet." };
   }
   const discovery = state === "pre-ai" || state === "legacy";
-  const resolveAgent = (agent) => {
-    const file = agent.endsWith(".md") ? agent : `${agent}.md`;
-    const path4 = agentInstallPath(file);
-    const installed = isFile(join(dir, path4));
-    const group = agentGroupOf(file);
-    return { agentPath: path4, agentInstalled: installed, installCommand: installed ? void 0 : `kaddo add agents --group ${group}` };
-  };
   const refine = (id, agent, target, quality, verb = "complete") => {
     const ar = resolveAgent(agent);
     return {
@@ -4236,6 +4290,47 @@ function buildReadinessReport(dir, now = /* @__PURE__ */ new Date()) {
   if (!config) return stub("not-initialized", rec.label, rec.command);
   if (config.project.state === "new") return stub("not-applicable", "This project uses the standard new-project Kaddo flow.");
   if (config.project.state === "legacy") return stub("legacy-project", "Use the legacy project flow.");
+  if (isModule(config)) {
+    const scan2 = exists(join(dir, ".kaddo", "scan.json")) ? "available" : "missing";
+    const understand2 = exists(join(dir, ".kaddo", "understand.md")) ? "available" : "missing";
+    const mcNew = "knowledge/tech/module/module-context.md";
+    const mcLegacy = "knowledge/module/module-context.md";
+    const mcPath = exists(join(dir, mcNew)) ? mcNew : mcLegacy;
+    const qMC = analyzeKnowledgeArtifact(dir, mcPath);
+    const qCS = analyzeKnowledgeArtifact(dir, "knowledge/tech/current-state.md");
+    const qCB = analyzeKnowledgeArtifact(dir, "knowledge/tech/codebase.md");
+    const moduleBaseline = qMC !== "missing" && qCS !== "missing" && qCB !== "missing" ? "complete" : "incomplete";
+    const moduleReady = qMC === "useful" && qCS === "useful" && qCB === "useful";
+    const overall2 = moduleReady ? "ready-for-core-orchestration" : moduleBaseline === "incomplete" ? "bootstrap-incomplete" : "knowledge-incomplete";
+    return {
+      project_name: config.project.name,
+      project_type: config.project.state,
+      project_role: "module",
+      overall: overall2,
+      signals: {
+        scan: scan2,
+        understand: understand2,
+        bootstrap_baseline: moduleBaseline,
+        agents: "managed-by-core",
+        skills: "managed-by-core",
+        current_state: qCS,
+        codebase: qCB,
+        module_context: qMC,
+        capabilities: "managed-by-core",
+        product: "not-applicable",
+        business: "not-applicable",
+        roadmap: "managed-by-core",
+        work_items: "managed-by-core",
+        adapters: [],
+        blocking_open_questions: 0,
+        assumed_questions: 0,
+        resolved_questions: 0,
+        deferred_questions: 0
+      },
+      recommended_next_step: { label: rec.label, ...rec.command ? { command: rec.command } : {} },
+      nextStepRecommendation: rec
+    };
+  }
   const scan = exists(join(dir, ".kaddo", "scan.json")) ? "available" : "missing";
   const understand = exists(join(dir, ".kaddo", "understand.md")) ? "available" : "missing";
   const presence = Object.fromEntries(KNOWLEDGE_FILES.map((f3) => [f3.key, analyzeKnowledgeArtifact(dir, f3.path)]));
@@ -7602,6 +7697,67 @@ var identifyRisks = {
     return { status: hasLegacy ? "done" : "pending", agent: hasLegacy ? void 0 : "legacy-agent" };
   }
 };
+var refineModuleContext = {
+  id: "refine-module-context",
+  label: "Refine module context",
+  evaluate: (ctx) => {
+    const newPath = join(ctx.dir, "knowledge/tech/module/module-context.md");
+    const legacyPath = join(ctx.dir, "knowledge/module/module-context.md");
+    const mcPath = exists(newPath) ? "knowledge/tech/module/module-context.md" : exists(legacyPath) ? "knowledge/module/module-context.md" : null;
+    if (!mcPath) return { status: "pending", agent: "module-context-agent", skill: "module-context-refinement" };
+    const q3 = analyzeKnowledgeArtifact(ctx.dir, mcPath);
+    if (q3 === "useful") return { status: "done", evidence: [mcPath] };
+    return { status: "current", agent: "module-context-agent", skill: "module-context-refinement", evidence: [mcPath], reason: "Module context is still a placeholder." };
+  }
+};
+var describeModuleCurrentState = {
+  id: "describe-current-state",
+  label: "Describe current state",
+  evaluate: (ctx) => ({
+    status: isUseful(ctx.qCurrentState) ? "done" : "pending",
+    evidence: isUseful(ctx.qCurrentState) ? ["knowledge/tech/current-state.md"] : void 0,
+    agent: isUseful(ctx.qCurrentState) ? void 0 : "architecture-agent"
+  })
+};
+var mapModuleCodebase = {
+  id: "map-codebase",
+  label: "Map codebase",
+  evaluate: (ctx) => ({
+    status: isUseful(ctx.qCodebase) ? "done" : "pending",
+    evidence: isUseful(ctx.qCodebase) ? ["knowledge/tech/codebase.md"] : void 0,
+    agent: isUseful(ctx.qCodebase) ? void 0 : "architecture-agent"
+  })
+};
+var validateModuleKnowledge = {
+  id: "validate-module-knowledge",
+  label: "Validate module knowledge",
+  evaluate: (ctx) => {
+    const hasUnderstand = exists(join(ctx.dir, ".kaddo/understand.md"));
+    if (hasUnderstand) return { status: "done", evidence: [".kaddo/understand.md"] };
+    return { status: "pending", command: "kaddo understand" };
+  }
+};
+var readyForCoreOrchestration = {
+  id: "ready-for-core-orchestration",
+  label: "Ready for core orchestration",
+  evaluate: (ctx) => {
+    const newPath = join(ctx.dir, "knowledge/tech/module/module-context.md");
+    const legacyPath = join(ctx.dir, "knowledge/module/module-context.md");
+    const mcPath = exists(newPath) ? "knowledge/tech/module/module-context.md" : exists(legacyPath) ? "knowledge/module/module-context.md" : null;
+    const mcUseful = mcPath ? analyzeKnowledgeArtifact(ctx.dir, mcPath) === "useful" : false;
+    const allDone = mcUseful && isUseful(ctx.qCurrentState) && isUseful(ctx.qCodebase);
+    return { status: allDone ? "done" : "pending", reason: allDone ? void 0 : "Module knowledge is not yet complete." };
+  }
+};
+var MODULE_STEPS = [
+  enableKaddo,
+  scanRepository,
+  refineModuleContext,
+  describeModuleCurrentState,
+  mapModuleCodebase,
+  validateModuleKnowledge,
+  readyForCoreOrchestration
+];
 var NEW_STEPS = [
   enableKaddo,
   defineBusiness,
@@ -7742,10 +7898,10 @@ function mapNextStepId(id) {
     "review-work-item": "refine-work-item",
     "prepare-implementation": "prepare-implementation",
     "implement-work-item": "prepare-implementation",
-    "refine-module-context": "refine-work-item",
+    "refine-module-context": "refine-module-context",
     "init-module-context": "enable-kaddo",
-    "module-ready": "prepare-implementation",
-    "validate-work-item-modules": "prepare-implementation",
+    "module-ready": "ready-for-core-orchestration",
+    "validate-work-item-modules": "validate-module-knowledge",
     "modules-discover": "enable-kaddo"
   };
   return MAP[id] ?? id;
@@ -7753,7 +7909,7 @@ function mapNextStepId(id) {
 function buildProjectRoute(dir) {
   const config = loadConfig(dir);
   const state = config?.project.state ?? "pre-ai";
-  const defs = stepsForState(state);
+  const defs = config && isModule(config) ? MODULE_STEPS : stepsForState(state);
   const ctx = buildRouteContext(dir);
   const steps = defs.map((d3) => {
     const result = d3.evaluate(ctx);
@@ -8054,51 +8210,73 @@ function buildProjectExplanation(dir) {
   const roadmapMd = exists(roadmapPath) ? readFile(roadmapPath) : null;
   const roadmap = roadmapStats(roadmapMd, items.length);
   const mappedModules = loadMappedModules(dir);
+  const moduleRepo = config != null && isModule(config);
   const missingKnowledge = [];
-  if (!knowledge.hasScan) missingKnowledge.push("Scan baseline (.kaddo/scan.json)");
-  if (!knowledge.hasContextPack) missingKnowledge.push("Context pack (.kaddo/context-pack.md)");
-  if (!knowledge.hasInventory) missingKnowledge.push("Inventory (knowledge/inventory.md)");
-  if (!knowledge.hasCapabilities) missingKnowledge.push("Product knowledge (knowledge/product/)");
-  if (!knowledge.hasArchitecture) missingKnowledge.push("Tech knowledge (knowledge/tech/)");
-  if (!knowledge.hasRoadmap) missingKnowledge.push("Roadmap (knowledge/delivery/roadmap.md)");
-  if (!knowledge.hasAgents) missingKnowledge.push("Agents (knowledge/agents/)");
-  if (items.length === 0) missingKnowledge.push("Work items (knowledge/delivery/work-items/)");
-  const suggestedNextSteps = [];
-  const baselineIncomplete = !knowledge.hasBusiness || !knowledge.hasProduct;
-  if (baselineIncomplete) {
-    suggestedNextSteps.push("Run `kaddo bootstrap` to create the project knowledge baseline.");
-    if (!knowledge.hasAgents) suggestedNextSteps.push("Then run `kaddo add agents`.");
-    if (!knowledge.hasSkills) suggestedNextSteps.push("Then run `kaddo add skills`.");
-    suggestedNextSteps.push("Then run `kaddo context`.");
-    suggestedNextSteps.push("Then run `kaddo understand`.");
+  if (moduleRepo) {
+    if (!knowledge.hasScan) missingKnowledge.push("Scan baseline (.kaddo/scan.json)");
+    if (!knowledge.hasContextPack) missingKnowledge.push("Context pack (.kaddo/context-pack.md)");
+    if (!knowledge.hasArchitecture) missingKnowledge.push("Tech knowledge (knowledge/tech/)");
   } else {
+    if (!knowledge.hasScan) missingKnowledge.push("Scan baseline (.kaddo/scan.json)");
+    if (!knowledge.hasContextPack) missingKnowledge.push("Context pack (.kaddo/context-pack.md)");
+    if (!knowledge.hasInventory) missingKnowledge.push("Inventory (knowledge/inventory.md)");
+    if (!knowledge.hasCapabilities) missingKnowledge.push("Product knowledge (knowledge/product/)");
+    if (!knowledge.hasArchitecture) missingKnowledge.push("Tech knowledge (knowledge/tech/)");
+    if (!knowledge.hasRoadmap) missingKnowledge.push("Roadmap (knowledge/delivery/roadmap.md)");
+    if (!knowledge.hasAgents) missingKnowledge.push("Agents (knowledge/agents/)");
+    if (items.length === 0) missingKnowledge.push("Work items (knowledge/delivery/work-items/)");
+  }
+  const suggestedNextSteps = [];
+  if (moduleRepo) {
     if (!knowledge.hasScan) {
       suggestedNextSteps.push("Run `kaddo scan` to detect the technical stack.");
     } else if (!knowledge.hasContextPack) {
       suggestedNextSteps.push("Run `kaddo context` to prepare an LLM context pack.");
+    } else if (!knowledge.hasArchitecture) {
+      suggestedNextSteps.push("Use module-context-agent to refine knowledge/tech/module/module-context.md.");
+    } else {
+      suggestedNextSteps.push("Return to the core repository.");
+      suggestedNextSteps.push("Create or continue the Work Item from the core.");
+      suggestedNextSteps.push("Add this module to `affected_modules` when the change touches it.");
+      suggestedNextSteps.push("Re-run `kaddo context` and `kaddo understand` from the core.");
     }
-    if (!knowledge.hasAgents) {
-      suggestedNextSteps.push("Run `kaddo add agents` to install knowledge agents.");
-    }
-    if (!knowledge.hasCapabilities) {
-      suggestedNextSteps.push("Use capability-agent to generate knowledge/product/capabilities.md.");
-    }
-    if (!knowledge.hasArchitecture) {
-      suggestedNextSteps.push("Use architecture-agent to generate knowledge/tech/current-state.md.");
-    }
-    if (!knowledge.hasRoadmap) {
-      suggestedNextSteps.push("Use roadmap-agent to generate knowledge/delivery/roadmap.md.");
-    } else if (roadmap.remaining > 0) {
-      suggestedNextSteps.push(
-        `Materialize ${roadmap.remaining} roadmap candidate(s) with \`kaddo create --from roadmap\`.`
-      );
-    }
-    if (items.length === 0 && !roadmap.present) {
-      suggestedNextSteps.push("Create your first Work Item with `kaddo create`.");
-    } else if (ownership.workItemsMissingOwnership > 0) {
-      suggestedNextSteps.push(
-        "Run `kaddo owners suggest` for Work Items without code ownership."
-      );
+  } else {
+    const baselineIncomplete = !knowledge.hasBusiness || !knowledge.hasProduct;
+    if (baselineIncomplete) {
+      suggestedNextSteps.push("Run `kaddo bootstrap` to create the project knowledge baseline.");
+      if (!knowledge.hasAgents) suggestedNextSteps.push("Then run `kaddo add agents`.");
+      if (!knowledge.hasSkills) suggestedNextSteps.push("Then run `kaddo add skills`.");
+      suggestedNextSteps.push("Then run `kaddo context`.");
+      suggestedNextSteps.push("Then run `kaddo understand`.");
+    } else {
+      if (!knowledge.hasScan) {
+        suggestedNextSteps.push("Run `kaddo scan` to detect the technical stack.");
+      } else if (!knowledge.hasContextPack) {
+        suggestedNextSteps.push("Run `kaddo context` to prepare an LLM context pack.");
+      }
+      if (!knowledge.hasAgents) {
+        suggestedNextSteps.push("Run `kaddo add agents` to install knowledge agents.");
+      }
+      if (!knowledge.hasCapabilities) {
+        suggestedNextSteps.push("Use capability-agent to generate knowledge/product/capabilities.md.");
+      }
+      if (!knowledge.hasArchitecture) {
+        suggestedNextSteps.push("Use architecture-agent to generate knowledge/tech/current-state.md.");
+      }
+      if (!knowledge.hasRoadmap) {
+        suggestedNextSteps.push("Use roadmap-agent to generate knowledge/delivery/roadmap.md.");
+      } else if (roadmap.remaining > 0) {
+        suggestedNextSteps.push(
+          `Materialize ${roadmap.remaining} roadmap candidate(s) with \`kaddo create --from roadmap\`.`
+        );
+      }
+      if (items.length === 0 && !roadmap.present) {
+        suggestedNextSteps.push("Create your first Work Item with `kaddo create`.");
+      } else if (ownership.workItemsMissingOwnership > 0) {
+        suggestedNextSteps.push(
+          "Run `kaddo owners suggest` for Work Items without code ownership."
+        );
+      }
     }
   }
   const readiness = buildReadinessReport(dir);
@@ -8140,7 +8318,8 @@ function buildProjectExplanation(dir) {
     roadmapQuality: buildRoadmapQuality(dir),
     projectRoute: buildProjectRoute(dir),
     scanSignals: loadScanSignals(dir),
-    metadataHealth: analyzeMetadataHealth(dir)
+    metadataHealth: analyzeMetadataHealth(dir),
+    isModuleRepo: config != null && isModule(config)
   };
 }
 function stateLabel(state) {
@@ -8193,11 +8372,19 @@ function renderExplanationHuman(exp) {
   lines.push("## Knowledge Status");
   lines.push(`- Inventory: ${exp.knowledge.hasInventory ? "available" : "missing"}`);
   lines.push(`- Context pack: ${exp.knowledge.hasContextPack ? "available" : "missing"}`);
-  lines.push(`- Business: ${ls("Business")}`);
-  lines.push(`- Product: ${ls("Product")}`);
-  lines.push(`- Tech: ${ls("Tech")}`);
-  lines.push(`- Delivery: ${ls("Delivery")}`);
-  lines.push(`- Agents: ${exp.knowledge.hasAgents ? "available" : "missing"}`);
+  if (exp.isModuleRepo) {
+    lines.push("- Business: Not applicable");
+    lines.push("- Product: Not applicable");
+    lines.push(`- Tech: ${ls("Tech")}`);
+    lines.push("- Delivery: Managed by core");
+    lines.push("- Agents: Managed by core");
+  } else {
+    lines.push(`- Business: ${ls("Business")}`);
+    lines.push(`- Product: ${ls("Product")}`);
+    lines.push(`- Tech: ${ls("Tech")}`);
+    lines.push(`- Delivery: ${ls("Delivery")}`);
+    lines.push(`- Agents: ${exp.knowledge.hasAgents ? "available" : "missing"}`);
+  }
   if (exp.roadmap.present) {
     lines.push(`- Roadmap initiatives: ${exp.roadmap.initiatives}`);
     lines.push(`- Work Item candidates: ${exp.roadmap.work_item_candidates}`);
@@ -8358,14 +8545,27 @@ function renderExplanationHuman(exp) {
     lines.push(`- understand: ${s.understand}`);
     lines.push(`- agents: ${s.agents}`);
     lines.push(`- skills: ${s.skills}`);
-    lines.push(`- business: ${s.business}`);
-    lines.push(`- product: ${s.product}`);
+    if (exp.isModuleRepo) {
+      lines.push("- business: not-applicable");
+      lines.push("- product: not-applicable");
+    } else {
+      lines.push(`- business: ${s.business}`);
+      lines.push(`- product: ${s.product}`);
+    }
     lines.push(`- capabilities: ${s.capabilities}`);
     lines.push(`- current-state: ${s.current_state}`);
     lines.push(`- codebase: ${s.codebase}`);
-    lines.push(`- roadmap: ${s.roadmap}`);
-    lines.push(`- work-items: ${s.work_items}`);
-    lines.push(`- adapters: ${s.adapters.length > 0 ? s.adapters.join(", ") + " installed" : "none installed"}`);
+    if (s.module_context != null) {
+      lines.push(`- module-context: ${s.module_context}`);
+    }
+    if (!exp.isModuleRepo) {
+      lines.push(`- roadmap: ${s.roadmap}`);
+      lines.push(`- work-items: ${s.work_items}`);
+      lines.push(`- adapters: ${s.adapters.length > 0 ? s.adapters.join(", ") + " installed" : "none installed"}`);
+    } else {
+      lines.push("- roadmap: managed-by-core");
+      lines.push("- work-items: managed-by-core");
+    }
     lines.push(`- blocking open questions: ${s.blocking_open_questions}`);
     lines.push(`- assumptions: ${s.assumed_questions}`);
     lines.push(`- deferred: ${s.deferred_questions}`);
@@ -9834,7 +10034,7 @@ function projectStatus(root) {
     return fail("Project status needs `.kaddo/explain.json`. Run `kaddo explain` first.");
   }
   const maturity = (explain.layers ?? []).map((l2) => `${l2.layer}: ${l2.status}`);
-  return ok({
+  const result = {
     project: explain.project?.name ?? "unknown",
     state: explain.project?.state ?? "unknown",
     knowledgeMaturity: maturity,
@@ -9854,7 +10054,17 @@ function projectStatus(root) {
       hints: hints?.summary?.hints ?? 0
     },
     capsules: capsules.length
-  });
+  };
+  if (explain.isModuleRepo) {
+    result.isModuleRepo = true;
+    result.readiness = {
+      overall: explain.readiness?.overall ?? "unknown",
+      project_role: explain.readiness?.project_role ?? "module",
+      agents: "managed-by-core",
+      skills: "managed-by-core"
+    };
+  }
+  return ok(result);
 }
 function listWorkItemsTool(root, filter = {}) {
   let items = listWorkItems(root);
@@ -10584,19 +10794,20 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
   if (!inventoryAvailable) {
     missing.push("No technical inventory found. Run `kaddo scan` to generate it.");
   }
+  const moduleRepo = config != null && isModule(config);
   const knowledgeSummary = readMarkdownSummary(dir, "knowledge.md") ?? "";
-  if (!knowledgeSummary) {
+  if (!knowledgeSummary && !moduleRepo) {
     missing.push("No project knowledge summary found yet.");
   }
   const roadmapSummary = readMarkdownSummary(dir, "delivery/roadmap.md") ?? "";
-  if (!roadmapSummary) {
+  if (!roadmapSummary && !moduleRepo) {
     missing.push("No roadmap baseline found.");
   }
   const allArtifacts = discoverKnowledge(dir);
   const workItems = allArtifacts.filter(
     (a2) => isDeliveryWorkItem(a2) && isActiveState(lifecycleStateOf({ status: a2.status, filePath: a2.filePath }))
   );
-  if (workItems.length === 0) {
+  if (workItems.length === 0 && !moduleRepo) {
     missing.push("No work items found.");
   }
   const state = config.project.state;
@@ -10628,8 +10839,8 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
     tech: { status: layerStatusOf("Tech"), artifacts: { "knowledge/tech/codebase.md": qCodebase, "knowledge/tech/current-state.md": qCurrentState } },
     delivery: { status: layerStatusOf("Delivery"), artifacts: { "knowledge/delivery/roadmap.md": qRoadmap } }
   };
-  if (qBusiness === "placeholder") missing.push("Business context exists but still looks like a bootstrap placeholder.");
-  if (qProduct === "placeholder" || qCapabilities === "placeholder") missing.push("Product capabilities exist but still look like a bootstrap placeholder.");
+  if (qBusiness === "placeholder" && !moduleRepo) missing.push("Business context exists but still looks like a bootstrap placeholder.");
+  if ((qProduct === "placeholder" || qCapabilities === "placeholder") && !moduleRepo) missing.push("Product capabilities exist but still look like a bootstrap placeholder.");
   if (qCurrentState === "placeholder") missing.push("Current state exists but still looks like a bootstrap placeholder.");
   if (qCodebase === "placeholder") missing.push("Codebase map exists but still looks like a bootstrap placeholder.");
   const allWorkItems = allArtifacts.filter((a2) => a2.isWorkItem);
@@ -10652,7 +10863,8 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
       workItemsTotal: allWorkItems.length,
       workItemsWithOwnership: wiWithOwnership,
       workItemsMissingOwnership: allWorkItems.length - wiWithOwnership
-    }
+    },
+    isModuleRepo: config != null && isModule(config)
   });
   const nextStepRecommendation = resolveNextStep(dir, now);
   const techDecisions = buildTechDecisions(dir);
@@ -10760,11 +10972,12 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
       }
       return contexts;
     })(),
+    isModuleRepo: moduleRepo,
     missing,
     // 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: isBootstrap ? [] : unifiedPhase.recommendedAgents.length > 0 ? unifiedPhase.recommendedAgents : recommendedAgentsForState(state),
+      recommendedAgents: isBootstrap ? [] : unifiedPhase.recommendedAgents.length > 0 ? unifiedPhase.recommendedAgents : moduleRepo ? [] : recommendedAgentsForState(state),
       nextSteps: [nextStepRecommendation.label],
       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
@@ -11075,7 +11288,11 @@ function renderContextPack(pack) {
     }
   }
   parts.push("## Recommended Agent Handoff\n");
-  if (isBootstrapIncomplete) {
+  if (pack.isModuleRepo && handoff.recommendedAgents.length === 0) {
+    parts.push("No local agent action is required.\n");
+    parts.push("This module is ready for core orchestration.\n");
+    parts.push("Business, Product, Delivery, Agents and Skills are managed by the core repository.\n");
+  } else if (isBootstrapIncomplete) {
     parts.push("No agent handoff yet.\n");
     parts.push("Run `kaddo bootstrap` first to create the baseline files.\n");
   } else if (rec.agent && rec.agentInstalled === false) {
@@ -11134,6 +11351,16 @@ function flowForState(state) {
 }
 function buildUnderstandPlan(dir, config) {
   const state = config.project.state;
+  if (isModule(config)) {
+    return {
+      project: { name: config.project.name, state, teamSize: config.team.size, structure: config.project.structure, language: "English" },
+      steps: [],
+      missingAgents: [],
+      agentsInstalled: true,
+      scanAvailable: exists(join(dir, ".kaddo", "scan.json")),
+      contextPackPath: ".kaddo/context-pack.md"
+    };
+  }
   const flow = flowForState(state).filter((s) => !exists(join(dir, s.output)));
   const steps = flow.map((s) => {
     const installed = agentIsInstalled(dir, s.agent);

package/package.json

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