@kaddo/mcp 3.31.0 → 3.33.0

package/dist/index.js

@@ -2991,6 +2991,24 @@ function serializeDriftJson(r) {
 }
 
 // ../cli/src/core/open-questions.ts
+var RESOLUTION_TOKENS = {
+  open: "open",
+  resolved: "resolved",
+  assumed: "assumed",
+  deferred: "deferred",
+  abierta: "open",
+  resuelta: "resolved",
+  asumida: "assumed",
+  diferida: "deferred"
+};
+function parseResolution(line) {
+  const m = line.match(/^\[([a-zA-Záéí]+)\]\s*(.*)$/);
+  if (m) {
+    const status = RESOLUTION_TOKENS[m[1].toLowerCase()];
+    if (status) return { text: m[2].trim(), resolution_status: status };
+  }
+  return { text: line.trim(), resolution_status: "open" };
+}
 var SOURCES = [
   "knowledge/business/business.md",
   "knowledge/product/product.md",
@@ -3082,10 +3100,17 @@ function extractFromMarkdown(md) {
   for (let i = start + 1; i < lines.length; i++) {
     const line = lines[i];
     if (/^#{1,6}\s+/.test(line)) break;
+    const meta = line.match(/^\s+(?:[-*])\s+(\w+)\s*:\s*(.+?)\s*$/);
+    if (meta && out.length > 0) {
+      if (meta[1].toLowerCase() === "note") out[out.length - 1].resolution_note = meta[2].trim();
+      continue;
+    }
     const m = line.match(/^\s*(?:[-*]|\d+\.)\s+(.+?)\s*$/);
     if (m) {
-      const q = m[1].trim();
-      if (q && !/^_.*_$/.test(q)) out.push(q);
+      const raw = m[1].trim();
+      if (!raw || /^_.*_$/.test(raw)) continue;
+      const { text: text2, resolution_status } = parseResolution(raw);
+      if (text2) out.push({ text: text2, resolution_status });
     }
   }
   return out;
@@ -3119,29 +3144,37 @@ function buildOpenQuestionsReport(dir, now = /* @__PURE__ */ new Date()) {
     } catch {
       continue;
     }
-    for (const q of extractFromMarkdown(md)) {
+    for (const eq of extractFromMarkdown(md)) {
       seq += 1;
-      const { classification, reason } = classifyQuestion(q);
+      const { classification, reason } = classifyQuestion(eq.text);
       questions.push({
         id: `OQ-${String(seq).padStart(3, "0")}`,
         source,
         section: "Open Questions",
-        question: q,
+        question: eq.text,
         classification,
+        resolution_status: eq.resolution_status,
         reason,
-        ...classification === "blocking" ? { suggested_assumption: suggestedAssumption(q) } : {}
+        ...eq.resolution_note ? { resolution_note: eq.resolution_note } : {},
+        ...classification === "blocking" && eq.resolution_status === "open" ? { suggested_assumption: suggestedAssumption(eq.text) } : {}
       });
     }
   }
   const blocking = questions.filter((q) => q.classification === "blocking");
   const important = questions.filter((q) => q.classification === "important");
   const deferred = questions.filter((q) => q.classification === "deferred");
+  const blockingOpen = blocking.filter((q) => q.resolution_status === "open");
+  const importantOpen = important.filter((q) => q.resolution_status === "open");
+  const byStatus = (s) => questions.filter((q) => q.resolution_status === s);
+  const resolved = byStatus("resolved");
+  const assumed = byStatus("assumed");
+  const deferredStatus = byStatus("deferred");
   let readiness;
   if (questions.length === 0) readiness = "unknown";
-  else if (blocking.length > 0) readiness = "needs_decisions";
+  else if (blockingOpen.length > 0) readiness = "needs_decisions";
   else readiness = "ready";
-  const suggested_assumptions = blocking.map((q) => q.suggested_assumption).filter(Boolean);
-  const recommended_next_step = readiness === "needs_decisions" ? "Confirm suggested assumptions with the user (resolve, assume or defer blocking questions) before generating the roadmap." : readiness === "ready" ? "No blocking questions \u2014 you can proceed to the roadmap (review important questions when convenient)." : "No open questions found. Run `kaddo bootstrap` to capture early questions, or proceed.";
+  const suggested_assumptions = blockingOpen.map((q) => q.suggested_assumption).filter(Boolean);
+  const recommended_next_step = readiness === "needs_decisions" ? "Confirm suggested assumptions with the user (resolve, assume or defer blocking open questions) before generating the roadmap." : readiness === "ready" ? "No blocking open questions \u2014 you can proceed to the roadmap. Surfaced assumptions/deferred items are informational." : "No open questions found. Run `kaddo bootstrap` to capture early questions, or proceed.";
   return {
     generated_at: now.toISOString(),
     project,
@@ -3150,12 +3183,23 @@ function buildOpenQuestionsReport(dir, now = /* @__PURE__ */ new Date()) {
       roadmap_readiness: readiness,
       blocking: blocking.length,
       important: important.length,
-      deferred: deferred.length
+      deferred: deferred.length,
+      blocking_open: blockingOpen.length,
+      important_open: importantOpen.length,
+      resolution: {
+        open: byStatus("open").length,
+        resolved: resolved.length,
+        assumed: assumed.length,
+        deferred: deferredStatus.length
+      }
     },
     questions,
     blocking_questions: blocking,
     important_questions: important,
     deferred_questions: deferred,
+    resolved_questions: resolved,
+    assumed_questions: assumed,
+    deferred_status_questions: deferredStatus,
     suggested_assumptions,
     recommended_next_step
   };
@@ -3169,18 +3213,18 @@ function renderOpenQuestionsMarkdown(r) {
   L.push("## Summary", "");
   L.push(`- Open questions found: ${r.summary.open_questions}`);
   L.push(`- Roadmap readiness: ${r.summary.roadmap_readiness}`);
-  L.push(`- Blocking: ${r.summary.blocking}`);
-  L.push(`- Important: ${r.summary.important}`);
-  L.push(`- Deferred: ${r.summary.deferred}`);
+  L.push(`- By resolution \u2014 open: ${r.summary.resolution.open}, resolved: ${r.summary.resolution.resolved}, assumed: ${r.summary.resolution.assumed}, deferred: ${r.summary.resolution.deferred}`);
+  L.push(`- Blocking open: ${r.summary.blocking_open}, important open: ${r.summary.important_open}`);
   L.push("");
   if (r.summary.open_questions === 0) {
     L.push("No `## Open Questions` sections found in business / product / codebase / roadmap.", "");
     L.push("## Recommended Next Step", "", r.recommended_next_step, "");
     return L.join("\n");
   }
-  L.push("## Blocking Questions", "");
-  if (r.blocking_questions.length === 0) L.push("_None._", "");
-  for (const q of r.blocking_questions) {
+  const blockingOpen = r.blocking_questions.filter((q) => q.resolution_status === "open");
+  L.push("## Blocking Open Questions", "");
+  if (blockingOpen.length === 0) L.push("_None \u2014 nothing blocks readiness._", "");
+  for (const q of blockingOpen) {
     L.push(`### ${q.id}`, "");
     L.push(`- Source: \`${q.source}\``);
     L.push(`- Question: ${q.question}`);
@@ -3188,13 +3232,18 @@ function renderOpenQuestionsMarkdown(r) {
     if (q.suggested_assumption) L.push(`- Suggested assumption: ${q.suggested_assumption}`);
     L.push("");
   }
+  const renderStatusList = (title, items) => {
+    L.push(`## ${title}`, "");
+    if (items.length === 0) L.push("_None._");
+    for (const q of items) L.push(`- ${q.question}${q.resolution_note ? ` \u2014 _${q.resolution_note}_` : ""}`);
+    L.push("");
+  };
+  renderStatusList("Resolved", r.resolved_questions);
+  renderStatusList("Assumed (decisions to revisit)", r.assumed_questions);
+  renderStatusList("Deferred (out of current scope)", r.deferred_status_questions);
   L.push("## Important Questions", "");
   if (r.important_questions.length === 0) L.push("_None._");
-  for (const q of r.important_questions) L.push(`- ${q.question}`);
-  L.push("");
-  L.push("## Deferred Questions", "");
-  if (r.deferred_questions.length === 0) L.push("_None._");
-  for (const q of r.deferred_questions) L.push(`- ${q.question}`);
+  for (const q of r.important_questions) L.push(`- [${q.resolution_status}] ${q.question}`);
   L.push("");
   if (r.suggested_assumptions.length > 0) {
     L.push("## Suggested Assumptions", "");
@@ -3212,10 +3261,12 @@ function roadmapReadinessSummary(dir) {
   return {
     roadmap_readiness: r.summary.roadmap_readiness,
     blocking_questions: r.summary.blocking,
+    blocking_open: r.summary.blocking_open,
     important_questions: r.summary.important,
     deferred_questions: r.summary.deferred,
+    resolution: r.summary.resolution,
     suggested_assumptions: r.suggested_assumptions,
-    recommended_next_step: r.summary.roadmap_readiness === "needs_decisions" ? "Resolve, assume, or defer blocking questions before generating roadmap." : r.recommended_next_step
+    recommended_next_step: r.summary.roadmap_readiness === "needs_decisions" ? "Resolve, assume, or defer blocking open questions before generating roadmap." : r.recommended_next_step
   };
 }
 

package/package.json

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