@kaddo/mcp 3.40.0 → 3.41.0

package/dist/index.js

@@ -2434,18 +2434,31 @@ function buildReadinessReport(dir, now = /* @__PURE__ */ new Date()) {
 }
 
 // ../cli/src/core/decisions.ts
-var CANDIDATES_PATH = "knowledge/tech/decision-candidates.md";
+var CANDIDATES_DISCOVERY = "knowledge/tech/discovery/decision-candidates.md";
+var CANDIDATES_LEGACY = "knowledge/tech/decision-candidates.md";
 var DECISIONS_DIR = "knowledge/tech/decisions";
+function resolveCandidatesPath(dir) {
+  const discovery = exists(join(dir, CANDIDATES_DISCOVERY));
+  const legacy = exists(join(dir, CANDIDATES_LEGACY));
+  if (discovery) return { path: CANDIDATES_DISCOVERY, legacy: false, bothExist: legacy };
+  if (legacy) return { path: CANDIDATES_LEGACY, legacy: true, bothExist: false };
+  return { path: null, legacy: false, bothExist: false };
+}
+function cleanCandidateTitle(title) {
+  return title.replace(/^\s*#{1,6}\s+/, "").replace(/^\s*[-*]\s+/, "").replace(/^\s*\(?\d+\)?[.):]\s+/, "").trim();
+}
 function slugify(s) {
-  return s.toLowerCase().normalize("NFD").replace(/[̀-ͯ]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60);
+  return cleanCandidateTitle(s).toLowerCase().normalize("NFD").replace(/[̀-ͯ]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/-+/g, "-").replace(/^-+|-+$/g, "").slice(0, 70).replace(/-+$/g, "");
 }
 function parseDecisionCandidates(md) {
   const out = [];
   for (const line of md.split(/\r?\n/)) {
     const m = line.match(/^##\s+(.+?)\s*$/);
     if (m) {
-      const t = m[1].trim();
-      if (t && !/^_.*_$/.test(t)) out.push(t);
+      const raw = m[1].trim();
+      if (!raw || /^_.*_$/.test(raw)) continue;
+      const t = cleanCandidateTitle(raw);
+      if (t) out.push(t);
     }
   }
   return out;
@@ -2474,11 +2487,11 @@ function countAdrs(dir) {
   return { total, draft, accepted };
 }
 function buildTechDecisions(dir) {
-  const candFile = join(dir, CANDIDATES_PATH);
+  const resolved = resolveCandidatesPath(dir);
   let titles = [];
-  if (exists(candFile)) {
+  if (resolved.path) {
     try {
-      titles = parseDecisionCandidates(readFile(candFile));
+      titles = parseDecisionCandidates(readFile(join(dir, resolved.path)));
     } catch {
       titles = [];
     }
@@ -2486,7 +2499,7 @@ function buildTechDecisions(dir) {
   const { total, draft, accepted } = countAdrs(dir);
   const candidate_list = titles.map((title, i) => {
     const n = String(total + i + 1).padStart(3, "0");
-    return { title, source: CANDIDATES_PATH, suggestedAdrFile: `${DECISIONS_DIR}/ADR-${n}-${slugify(title)}.md` };
+    return { title, source: resolved.path, suggestedAdrFile: `${DECISIONS_DIR}/ADR-${n}-${slugify(title)}.md` };
   });
   let status;
   if (accepted > 0) status = "accepted-adrs";
@@ -2499,7 +2512,10 @@ function buildTechDecisions(dir) {
     adrs: total,
     draft_adrs: draft,
     accepted_adrs: accepted,
-    candidate_list
+    candidate_list,
+    candidates_source: resolved.path,
+    candidates_legacy_location: resolved.legacy,
+    candidates_both_exist: resolved.bothExist
   };
 }
 
@@ -2715,7 +2731,18 @@ function buildProjectExplanation(dir) {
     suggestedNextSteps,
     readiness,
     nextStepRecommendation: readiness.nextStepRecommendation,
-    techDecisions: buildTechDecisions(dir)
+    techDecisions: buildTechDecisions(dir),
+    techKnowledge: {
+      core: {
+        currentState: exists(join(dir, "knowledge/tech/current-state.md")),
+        codebase: exists(join(dir, "knowledge/tech/codebase.md"))
+      },
+      discovery: {
+        architectureNotes: exists(join(dir, "knowledge/tech/discovery/architecture-notes.md")) || exists(join(dir, "knowledge/tech/architecture-notes.md")),
+        decisionCandidates: exists(join(dir, "knowledge/tech/discovery/decision-candidates.md")) || exists(join(dir, "knowledge/tech/decision-candidates.md")),
+        legacyLocation: exists(join(dir, "knowledge/tech/architecture-notes.md")) || exists(join(dir, "knowledge/tech/decision-candidates.md"))
+      }
+    }
   };
 }
 function stateLabel(state) {
@@ -2930,15 +2957,26 @@ function renderExplanationHuman(exp) {
   lines.push(r.recommended_next_step.label);
   lines.push("");
   const td = exp.techDecisions;
-  lines.push("## Tech Decisions");
-  lines.push(`- Decision candidates: ${td.candidates}`);
-  lines.push(`- ADRs: ${td.adrs} (draft: ${td.draft_adrs}, accepted: ${td.accepted_adrs})`);
-  lines.push(`- Status: ${td.status}`);
+  const tk = exp.techKnowledge;
+  const mark = (b) => b ? "\u2713" : "\u2717";
+  lines.push("## Tech Knowledge");
+  lines.push("Core:");
+  lines.push(`- ${mark(tk.core.currentState)} current-state.md`);
+  lines.push(`- ${mark(tk.core.codebase)} codebase.md`);
+  lines.push("Decisions:");
+  lines.push(`- ADRs: ${td.adrs} (draft: ${td.draft_adrs}, accepted: ${td.accepted_adrs}) \xB7 status: ${td.status}`);
+  lines.push("Discovery:");
+  lines.push(`- ${mark(tk.discovery.architectureNotes)} architecture-notes.md`);
+  lines.push(`- ${mark(tk.discovery.decisionCandidates)} decision-candidates.md`);
+  lines.push("");
   if (td.candidates > 0 && td.adrs === 0) {
-    lines.push("");
     lines.push("Use the adr-writing skill to materialize decision candidates into ADRs (`kaddo adr`) before implementing related technical Work Items.");
+    lines.push("");
+  }
+  if (tk.discovery.legacyLocation) {
+    lines.push("Tech discovery files are in the legacy `knowledge/tech/` root. Suggested cleanup: run `kaddo tech organize`.");
+    lines.push("");
   }
-  lines.push("");
   return lines.join("\n").trimEnd() + "\n";
 }
 function renderExplanationAgent(exp) {
@@ -4125,6 +4163,18 @@ var RESOURCES = [
       }
       return [{ uri: "kaddo://roadmap-readiness", text: JSON.stringify(roadmapReadinessSummary(root), null, 2), mimeType: "application/json" }];
     }
+  },
+  {
+    uri: "kaddo://tech-decisions",
+    name: "Kaddo tech decisions",
+    description: "Technical decision candidates vs materialized ADRs (status, counts, candidate list with suggested ADR filenames). Read-only; shares buildTechDecisions with `kaddo adr`.",
+    mimeType: "application/json",
+    read: (root) => {
+      if (!hasKnowledge(root)) {
+        return text("kaddo://tech-decisions", "Knowledge repository not found. Run `kaddo bootstrap` first.", "text/plain");
+      }
+      return [{ uri: "kaddo://tech-decisions", text: JSON.stringify(buildTechDecisions(root), null, 2), mimeType: "application/json" }];
+    }
   }
 ];
 
@@ -4398,6 +4448,22 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
   if (techDecisions.candidates > 0 && techDecisions.adrs === 0) {
     missing.push(`${techDecisions.candidates} technical decision candidate(s) not yet materialized as ADRs (run \`kaddo adr\`).`);
   }
+  const techFile = (rel) => exists(join(dir, ARCH_DIR3, rel));
+  const techKnowledge = {
+    core: {
+      "current-state.md": techFile("tech/current-state.md"),
+      "codebase.md": techFile("tech/codebase.md")
+    },
+    decisions: { adrs: techDecisions.adrs, dir: exists(join(dir, ARCH_DIR3, "tech/decisions")) },
+    discovery: {
+      "architecture-notes.md": techFile("tech/discovery/architecture-notes.md") || techFile("tech/architecture-notes.md"),
+      "decision-candidates.md": techFile("tech/discovery/decision-candidates.md") || techFile("tech/decision-candidates.md"),
+      legacyLocation: techFile("tech/architecture-notes.md") || techFile("tech/decision-candidates.md")
+    }
+  };
+  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 unifiedPhase = {
     ...phase,
     nextStep: nextStepRecommendation.label,
@@ -4436,6 +4502,7 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
     phase: unifiedPhase,
     nextStepRecommendation,
     techDecisions,
+    techKnowledge,
     deliveryMix,
     external: loadExternalCapsules(dir),
     graph: loadGraphSummary(dir),

package/package.json

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