@kaddo/mcp 3.39.1 → 3.40.1

package/dist/index.js

@@ -2433,6 +2433,81 @@ function buildReadinessReport(dir, now = /* @__PURE__ */ new Date()) {
   };
 }
 
+// ../cli/src/core/decisions.ts
+var CANDIDATES_PATH = "knowledge/tech/decision-candidates.md";
+var DECISIONS_DIR = "knowledge/tech/decisions";
+function cleanCandidateTitle(title) {
+  return title.replace(/^\s*#{1,6}\s+/, "").replace(/^\s*[-*]\s+/, "").replace(/^\s*\(?\d+\)?[.):]\s+/, "").trim();
+}
+function slugify(s) {
+  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 raw = m[1].trim();
+      if (!raw || /^_.*_$/.test(raw)) continue;
+      const t = cleanCandidateTitle(raw);
+      if (t) out.push(t);
+    }
+  }
+  return out;
+}
+function countAdrs(dir) {
+  const base = join(dir, DECISIONS_DIR);
+  if (!exists(base)) return { total: 0, draft: 0, accepted: 0 };
+  let total = 0;
+  let draft = 0;
+  let accepted = 0;
+  for (const entry of readDir(base)) {
+    if (!entry.endsWith(".md") || entry === ".gitkeep") continue;
+    const full = join(base, entry);
+    if (!isFile(full)) continue;
+    total += 1;
+    let content = "";
+    try {
+      content = readFile(full);
+    } catch {
+      continue;
+    }
+    const status = content.match(/^\s*status:\s*([a-z-]+)/im)?.[1]?.toLowerCase();
+    if (status === "accepted") accepted += 1;
+    else draft += 1;
+  }
+  return { total, draft, accepted };
+}
+function buildTechDecisions(dir) {
+  const candFile = join(dir, CANDIDATES_PATH);
+  let titles = [];
+  if (exists(candFile)) {
+    try {
+      titles = parseDecisionCandidates(readFile(candFile));
+    } catch {
+      titles = [];
+    }
+  }
+  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` };
+  });
+  let status;
+  if (accepted > 0) status = "accepted-adrs";
+  else if (total > 0) status = "draft-adrs";
+  else if (titles.length > 0) status = "candidates";
+  else status = "none";
+  return {
+    status,
+    candidates: titles.length,
+    adrs: total,
+    draft_adrs: draft,
+    accepted_adrs: accepted,
+    candidate_list
+  };
+}
+
 // ../cli/src/core/project-explain.ts
 var ARCH_DIR2 = "knowledge";
 function normalizeTitle(t) {
@@ -2644,7 +2719,8 @@ function buildProjectExplanation(dir) {
     missingKnowledge,
     suggestedNextSteps,
     readiness,
-    nextStepRecommendation: readiness.nextStepRecommendation
+    nextStepRecommendation: readiness.nextStepRecommendation,
+    techDecisions: buildTechDecisions(dir)
   };
 }
 function stateLabel(state) {
@@ -2858,6 +2934,16 @@ function renderExplanationHuman(exp) {
   lines.push("### Recommended next step");
   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}`);
+  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("");
   return lines.join("\n").trimEnd() + "\n";
 }
 function renderExplanationAgent(exp) {
@@ -4044,6 +4130,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" }];
+    }
   }
 ];
 
@@ -4313,6 +4411,10 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
     }
   });
   const nextStepRecommendation = resolveNextStep(dir, now);
+  const techDecisions = buildTechDecisions(dir);
+  if (techDecisions.candidates > 0 && techDecisions.adrs === 0) {
+    missing.push(`${techDecisions.candidates} technical decision candidate(s) not yet materialized as ADRs (run \`kaddo adr\`).`);
+  }
   const unifiedPhase = {
     ...phase,
     nextStep: nextStepRecommendation.label,
@@ -4350,6 +4452,7 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
     roadmap,
     phase: unifiedPhase,
     nextStepRecommendation,
+    techDecisions,
     deliveryMix,
     external: loadExternalCapsules(dir),
     graph: loadGraphSummary(dir),

package/package.json

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