@kaddo/mcp 3.124.0 → 3.124.2

package/dist/index.js

@@ -10466,7 +10466,7 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
   let withAcceptance = 0;
   let withDoD = 0;
   let withValidation = 0;
-  let connectedRoadmap = 0;
+  const connectedRoadmapCandidates = /* @__PURE__ */ new Set();
   const globCounts = /* @__PURE__ */ new Map();
   const globOwners = /* @__PURE__ */ new Map();
   const gaps = {
@@ -10490,13 +10490,17 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
   for (const wi of wis) {
     const id = wi.id || wi.title;
     if (wi.codeGlobs.length > 0) withOwnership++;
-    else gaps.missing_code_ownership.push(gapItem(wi, "Add `code:` globs to connect this Work Item to source paths (`kaddo owners suggest`)."));
-    const hasSource = Boolean(wi.sourceId) || wi.source === "roadmap";
+    else if (wi.type === "bugfix" || wi.type === "hotfix") {
+      gaps.missing_code_ownership.push(gapItem(wi, "Add `code:` globs to connect this corrective Work Item to source paths (`kaddo owners suggest`)."));
+    }
+    const roadmapOrigin = wi.source === "roadmap";
+    const hasSource = Boolean(wi.source) || Boolean(wi.sourceId);
     if (hasSource) withSource++;
-    else gaps.missing_source.push(gapItem(wi, "Add `source` or `source_id` if this Work Item came from the roadmap."));
-    if (hasSource || wi.initiative) connectedRoadmap++;
+    if (roadmapOrigin && !wi.sourceId) {
+      gaps.missing_source.push(gapItem(wi, "Add `source_id` for this roadmap-originated Work Item."));
+    }
+    if (roadmapOrigin && wi.sourceId) connectedRoadmapCandidates.add(wi.sourceId);
     if (wi.initiative) withInitiative++;
-    else gaps.missing_initiative.push(gapItem(wi, "Add `initiative` to connect this Work Item to a delivery initiative."));
     if (wi.knowledgeLevel) withLevel++;
     else gaps.missing_knowledge_level.push(gapItem(wi, "Add `knowledge_level` (K0\u2013K4) to the front matter."));
     for (const g2 of wi.codeGlobs) {
@@ -10518,10 +10522,11 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
     }
   }
   const ownedCodePaths = [...globCounts.values()].reduce((a2, b2) => a2 + b2, 0);
+  const connectedRoadmap = connectedRoadmapCandidates.size;
   const broadGlobs = [...globCounts.keys()].filter((g2) => isBroadGlob(g2)).length;
   for (const [glob, owners] of globOwners) {
     if (owners.length > 1) {
-      gaps.ownership_overlaps.push({ code_path: glob, work_items: [...new Set(owners)], suggested_action: "Review whether the overlap is expected or should be narrowed." });
+      gaps.ownership_overlaps.push({ code_path: glob, work_items: [...new Set(owners)], suggested_action: "Shared historical modification path; it is not a conflict unless incompatible ownership is documented." });
     }
   }
   const ownershipOverlaps = gaps.ownership_overlaps.length;
@@ -10593,9 +10598,10 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
   const deliveryTrace = levelFromRatio(
     coverageRatio(withOwnership) * 0.5 + (g.available && g.edges > 0 ? 1 : 0) * 0.25 + (exp.roadmap.present ? 1 : 0) * 0.25
   );
+  const guardHistory = buildGuardHistory(dir);
   const impact_signals = {
     ambiguity_reduction: levelFromRatio(ambiguityRatio),
-    drift_prevention: withOwnership > 0 ? "Active" : "Limited",
+    drift_prevention: guardHistory.available && guardHistory.resolved > 0 ? "Observed" : "Unknown",
     onboarding_support: onboarding,
     delivery_traceability: deliveryTrace,
     ai_context_readiness: aiReady,
@@ -10604,17 +10610,19 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
   let score = null;
   let score_breakdown = null;
   if (total > 0) {
-    const healthPts = [layerStatus("Business"), layerStatus("Product"), layerStatus("Tech"), layerStatus("Delivery")].filter((s) => s !== "Missing").length / 4 * 20;
+    const layerMaturity = { Consolidated: 1, Structured: 0.8, Traceable: 0.75, Weak: 0.4, Missing: 0 };
+    const healthPts = [layerStatus("Business"), layerStatus("Product"), layerStatus("Tech"), layerStatus("Delivery")].reduce((sum, status) => sum + (layerMaturity[status] ?? 0), 0) / 4 * 20;
     const applicableCoverage = knowledge_coverage.filter((c) => c.label !== "Work Items using optional initiatives");
     const covAvg = applicableCoverage.reduce((a2, c) => a2 + coverageRatio(c.have), 0) / applicableCoverage.length;
     const coveragePts = covAvg * 20;
     const ownPts = coverageRatio(withOwnership) * 15;
-    const traceBlend = (exp.roadmap.candidates > 0 ? exp.roadmap.materialized / exp.roadmap.candidates : 1) * 0.5 + coverageRatio(withOwnership) * 0.5;
+    const roadmapTraceRatio = exp.roadmap.candidates > 0 ? Math.min(connectedRoadmap, exp.roadmap.candidates) / exp.roadmap.candidates : null;
+    const traceSignals = [coverageRatio(withOwnership), ...roadmapTraceRatio === null ? [] : [roadmapTraceRatio]];
+    const traceBlend = traceSignals.reduce((sum, value) => sum + value, 0) / traceSignals.length;
     const tracePts = traceBlend * 20;
     const qualityMap = { good: 1, partial: 0.6, sparse: 0.3, empty: 0, unknown: 0 };
     const graphPts = (g.available ? qualityMap[g.quality] ?? 0 : 0) * 15;
     const ctxPts = { Low: 0.25, Medium: 0.5, High: 0.8, "Very High": 1 }[ctxLevel] * 10;
-    score = Math.round(healthPts + coveragePts + ownPts + tracePts + graphPts + ctxPts);
     score_breakdown = {
       knowledge_health: { points: Math.round(healthPts), max: 20 },
       knowledge_coverage: { points: Math.round(coveragePts), max: 20 },
@@ -10623,6 +10631,7 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
       graph_quality: { points: Math.round(graphPts), max: 15 },
       context_readiness: { points: Math.round(ctxPts), max: 10 }
     };
+    score = Object.values(score_breakdown).reduce((sum, component) => sum + component.points, 0);
   }
   const idsOf = (items) => items.map((i) => i.id);
   const groupedAction = (items, verb) => {
@@ -10661,7 +10670,7 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
       { id: "work-items.lifecycle", label: "Work Item lifecycle", classification: total > 0 ? "observed" : "unknown", reason: total > 0 ? `${total} Work Item artifact(s) were discovered.` : "No Work Item artifacts were discovered." },
       { id: "delivery.verification", label: "Verified delivery outcomes", classification: verifiedWorkItems > 0 ? "observed" : "unknown", reason: verifiedWorkItems > 0 ? `${verifiedWorkItems} Work Item(s) have persisted validation_status: passed.` : "Acceptance Criteria and Definition of Done sections show declared intent, not completed verification evidence." },
       ...deliveryCapabilityEvidence(dir, projectContext),
-      { id: "guard-history", label: "Guard consistency history", classification: buildGuardHistory(dir).available ? "observed" : "unknown", reason: buildGuardHistory(dir).available ? "Recorded Guard runs provide current consistency evidence." : "No recorded Guard history is available." }
+      { id: "guard-history", label: "Guard consistency history", classification: guardHistory.available ? "observed" : "unknown", reason: guardHistory.available ? "Recorded Guard runs provide current consistency evidence." : "No recorded Guard history is available." }
     ],
     scope: g.scope,
     default_scope: "all",
@@ -10699,7 +10708,7 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
     },
     graph_quality: g.available ? { available: true, scope: g.scope, quality: g.quality, nodes: g.nodes, edges: g.edges, hints: g.hints, reason: g.scopeReason, last_exported: g.generatedAt } : { available: false, suggestion: "Run `kaddo graph export --scope all`." },
     guard_activity: (() => {
-      const gh = buildGuardHistory(dir);
+      const gh = guardHistory;
       return gh.available ? { available: true, runs_recorded: gh.total_runs, detected: gh.detected, open: gh.open, resolved: gh.resolved, resolution_rate: gh.resolution_rate } : { available: false, note: "Guard history is not persisted. Run `kaddo guard --record` to record runs for trend analysis." };
     })(),
     impact_signals,
@@ -10810,7 +10819,7 @@ function renderImpactMarkdown(r2) {
   L.push("## Impact Signals", "");
   const s = r2.impact_signals;
   L.push(`- Ambiguity reduction: ${s.ambiguity_reduction}`);
-  L.push(`- Drift prevention: ${s.drift_prevention}`);
+  L.push(`- Drift prevention evidence: ${s.drift_prevention}`);
   L.push(`- Onboarding support: ${s.onboarding_support}`);
   L.push(`- Delivery traceability: ${s.delivery_traceability}`);
   L.push(`- AI context readiness: ${s.ai_context_readiness}`);
@@ -10845,7 +10854,7 @@ function renderImpactMarkdown(r2) {
     L.push("");
   }
   if (gp.ownership_overlaps.length > 0) {
-    L.push("### Ownership overlaps", "");
+    L.push("### Shared code-path history (review only)", "");
     for (const o2 of gp.ownership_overlaps) {
       L.push(`- \`${o2.code_path}\``);
       L.push(`  - Owned by: ${o2.work_items.join(", ")}`);
@@ -10853,7 +10862,7 @@ function renderImpactMarkdown(r2) {
     }
     L.push("");
   }
-  const anyGaps = gp.missing_source.length + gp.missing_initiative.length + gp.missing_code_ownership.length + gp.missing_knowledge_level.length + gp.missing_acceptance_criteria.length + gp.missing_definition_of_done.length + gp.missing_validation.length + gp.broad_ownership_globs.length + gp.ownership_overlaps.length;
+  const anyGaps = gp.missing_source.length + gp.missing_initiative.length + gp.missing_code_ownership.length + gp.missing_knowledge_level.length + gp.missing_acceptance_criteria.length + gp.missing_definition_of_done.length + gp.missing_validation.length + gp.broad_ownership_globs.length;
   if (anyGaps === 0) {
     L.push("No actionable knowledge gaps detected. \u{1F389}", "");
   }
@@ -11206,6 +11215,9 @@ function renderDriftMarkdown(r2) {
     L.push("## Guard History", "");
     L.push("No guard history recorded yet.");
     L.push("");
+    L.push("## Historical Drift Trend", "");
+    L.push("Not available \u2014 no recorded Guard runs.");
+    L.push("");
     L.push("Run `kaddo guard --record` to start recording drift evidence.");
     L.push("");
     L.push("## Suggested Actions", "");

package/package.json

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