@kaddo/mcp 3.124.1 → 3.124.3

package/dist/index.js

@@ -10404,6 +10404,20 @@ function buildGuardHistory(dir) {
 }
 
 // ../cli/src/core/reporting-evidence.ts
+function graphHintFinding(hint) {
+  const affected = [hint.artifact_id, ...hint.path ? [hint.path] : []];
+  return {
+    id: `graph-hint:${hint.artifact_id}:${hint.missing.join(",")}`,
+    category: "topology",
+    source: "graph-hints",
+    affected_artifacts: affected,
+    // Graph Hints are intentionally informational; review is useful but not a blocking error.
+    priority: "medium",
+    evidence: hint.reason,
+    explanation: hint.message,
+    suggested_action: `Review the declared relationships for ${hint.artifact_id}${hint.path ? ` at ${hint.path}` : ""}.`
+  };
+}
 function reportingProjectContext(dir) {
   const config = loadConfig(dir);
   if (!config) return { state: "unknown", mode: "unknown", repository_structure: "unknown" };
@@ -10458,7 +10472,11 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
   const projectContext = reportingProjectContext(dir);
   const wis = discoverWorkItems(dir);
   const total = wis.length;
-  const verifiedWorkItems = wis.filter((wi) => wi.validationStatus === "passed").length;
+  const completedWis = wis.filter((wi) => wi.lifecycle === "completed");
+  const verifiedWorkItems = completedWis.filter((wi) => wi.validationStatus === "passed").length;
+  const failedValidationWorkItems = completedWis.filter((wi) => wi.validationStatus === "failed").length;
+  const pendingValidationWorkItems = completedWis.filter((wi) => Boolean(wi.validationStatus) && !["passed", "failed"].includes(wi.validationStatus)).length;
+  const notRecordedValidationWorkItems = completedWis.length - verifiedWorkItems - failedValidationWorkItems - pendingValidationWorkItems;
   let withOwnership = 0;
   let withSource = 0;
   let withInitiative = 0;
@@ -10466,7 +10484,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 +10508,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,18 +10540,21 @@ 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;
   let g;
+  let graphHintEntries = [];
   const config = loadConfig(dir);
   if (config) {
     const graph = buildGraph(dir, config, { scope: resolvedScope }, now);
     const hints = buildGraphHints(dir, graph, now);
+    graphHintEntries = hints.hints;
     g = { available: true, scope: graph.scope, scopeReason: graph.scope_reason, nodes: graph.nodes.length, edges: graph.edges.length, quality: hints.quality, hints: hints.summary.hints, generatedAt: graph.generated_at };
   } else {
     g = { available: false, scope: resolvedScope, scopeReason: "", nodes: 0, edges: 0, quality: "unknown", hints: 0, generatedAt: "" };
@@ -10593,28 +10618,62 @@ 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,
     maintenance_readiness: levelFromRatio((coverageRatio(withOwnership) + (deliveryTraceable ? 1 : 0)) / 2)
   };
+  const baselineLayers = projectContext.mode === "poc" ? ["Tech", "Delivery"] : ["Business", "Product", "Tech", "Delivery"];
+  const findings = [];
+  for (const layer2 of baselineLayers) {
+    const status = layerStatus(layer2);
+    if (status !== "Weak" && status !== "Missing") continue;
+    findings.push({
+      id: `knowledge-health:${layer2.toLowerCase()}`,
+      category: "knowledge",
+      source: "knowledge-health",
+      affected_artifacts: [layer2],
+      priority: status === "Missing" ? "high" : "medium",
+      evidence: `${layer2} knowledge maturity is ${status}.`,
+      explanation: `This assesses documented ${layer2} knowledge, not the quality of the product or implementation.`,
+      suggested_action: `Review ${layer2} knowledge coverage and the artifacts or relationships available for it.`
+    });
+  }
+  for (const gap of gaps.missing_code_ownership) {
+    findings.push({
+      id: `ownership:${gap.id}`,
+      category: "delivery",
+      source: "work-item-ownership",
+      affected_artifacts: [gap.id, gap.path],
+      priority: "medium",
+      evidence: "A corrective Work Item has no declared code ownership.",
+      explanation: gap.title,
+      suggested_action: gap.suggested_action
+    });
+  }
+  findings.push(...graphHintEntries.map(graphHintFinding));
+  const priorityOrder = { high: 0, medium: 1, low: 2, unknown: 3 };
+  findings.sort((a2, b2) => priorityOrder[a2.priority] - priorityOrder[b2.priority] || a2.id.localeCompare(b2.id));
   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 +10682,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) => {
@@ -10636,16 +10696,18 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
   if (exp.roadmap.remaining > 0) actions.push(`Materialize the ${exp.roadmap.remaining} remaining roadmap candidate(s) with \`kaddo create --from roadmap\`.`);
   for (const a2 of [
     groupedAction(gaps.missing_code_ownership, "Add `code:` ownership to"),
-    groupedAction(gaps.missing_source, "Add `source`/`source_id` to"),
-    groupedAction(gaps.missing_acceptance_criteria, "Add Acceptance Criteria to"),
-    groupedAction(gaps.missing_definition_of_done, "Add a Definition of Done to"),
-    groupedAction(gaps.missing_validation, "Add a validation (How to test it) section to")
+    groupedAction(gaps.missing_source, "Add `source`/`source_id` to")
   ]) if (a2) actions.push(a2);
   if (gaps.broad_ownership_globs.length > 0) actions.push(`Narrow ${gaps.broad_ownership_globs.length} broad ownership glob(s) into specific paths.`);
-  if (g.available && g.hints > 0) actions.push("Review graph hints (`kaddo://graph-hints` or `.kaddo/graph-hints.md`).");
+  for (const finding of findings) {
+    if (!actions.includes(finding.suggested_action)) actions.push(finding.suggested_action);
+  }
   if (skills.length === 0) actions.push("Install reusable skills with `kaddo add skills`.");
   actions.push("Run `kaddo guard` before committing to catch knowledge drift.");
   const summary = [];
+  if (completedWis.length > 0) {
+    summary.push(`Delivery evidence: ${completedWis.length} completed; ${verifiedWorkItems} validation passed; ${notRecordedValidationWorkItems} not confirmed by persisted validation.`);
+  }
   if (total > 0) summary.push(`${withOwnership}/${total} Work Items include code ownership.`);
   if (g.available) summary.push(`The knowledge graph is ${g.quality} with ${g.nodes} nodes and ${g.edges} edges (${g.scope} scope).`);
   else summary.push("The knowledge graph has not been exported yet.");
@@ -10661,12 +10723,21 @@ 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",
     scope_source: scopeSource,
     executive_summary: summary,
+    delivery_evidence: {
+      completed: completedWis.length,
+      validation_passed: verifiedWorkItems,
+      validation_failed: failedValidationWorkItems,
+      validation_pending: pendingValidationWorkItems,
+      validation_not_recorded: notRecordedValidationWorkItems,
+      completion_with_passed_validation_percent: completedWis.length > 0 ? Math.round(verifiedWorkItems / completedWis.length * 1e3) / 10 : null
+    },
+    findings,
     knowledge_health,
     knowledge_coverage,
     ownership_coverage: {
@@ -10699,7 +10770,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,
@@ -10730,6 +10801,27 @@ function renderImpactMarkdown(r2) {
   L.push("## Executive Summary", "");
   for (const s2 of r2.executive_summary) L.push(`- ${s2}`);
   L.push("");
+  L.push("## Key Findings", "");
+  if (r2.findings.length === 0) L.push("No current findings detected by the executed deterministic checks.");
+  if (r2.findings.length > 0) {
+    const cell = (value) => value.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+    L.push("| Priority | Source | Affected | Finding | Suggested action |");
+    L.push("|---|---|---|---|---|");
+    for (const finding of r2.findings) {
+      L.push(`| ${finding.priority} | ${cell(finding.source)} | ${cell(finding.affected_artifacts.join(", ") || "not available")} | ${cell(finding.explanation)} Evidence: ${cell(finding.evidence)} | ${cell(finding.suggested_action)} |`);
+    }
+  }
+  L.push("");
+  L.push("## Delivery Evidence", "");
+  const de = r2.delivery_evidence;
+  L.push(`- Completed Work Items: ${de.completed}`);
+  L.push(`- Validation passed: ${de.validation_passed}`);
+  L.push(`- Validation failed: ${de.validation_failed}`);
+  L.push(`- Validation pending: ${de.validation_pending}`);
+  L.push(`- Validation not recorded: ${de.validation_not_recorded}`);
+  L.push(`- Completion with passed validation: ${de.completion_with_passed_validation_percent === null ? "not available" : `${de.completion_with_passed_validation_percent}%`}`);
+  L.push("- \u201CNot recorded\u201D means persisted evidence is absent; it does not prove validation never happened.");
+  L.push("");
   L.push("## Evidence and Applicability", "");
   for (const item of r2.evidence) L.push(`- ${item.label}: ${item.classification} \u2014 ${item.reason}`);
   L.push("");
@@ -10810,7 +10902,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}`);
@@ -10829,12 +10921,7 @@ function renderImpactMarkdown(r2) {
     L.push("");
   };
   gapSection("Work Items missing source", gp.missing_source);
-  gapSection("Work Items missing initiative", gp.missing_initiative);
   gapSection("Work Items missing code ownership", gp.missing_code_ownership);
-  gapSection("Work Items missing knowledge level", gp.missing_knowledge_level);
-  gapSection("Work Items missing acceptance criteria", gp.missing_acceptance_criteria);
-  gapSection("Work Items missing Definition of Done", gp.missing_definition_of_done);
-  gapSection("Work Items missing validation", gp.missing_validation);
   if (gp.broad_ownership_globs.length > 0) {
     L.push("### Broad ownership globs", "");
     for (const b2 of gp.broad_ownership_globs) {
@@ -10845,7 +10932,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,10 +10940,26 @@ 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_code_ownership.length + gp.broad_ownership_globs.length;
   if (anyGaps === 0) {
     L.push("No actionable knowledge gaps detected. \u{1F389}", "");
   }
+  const historical = [
+    ["knowledge level", gp.missing_knowledge_level],
+    ["Acceptance Criteria", gp.missing_acceptance_criteria],
+    ["Definition of Done", gp.missing_definition_of_done],
+    ["validation section", gp.missing_validation]
+  ];
+  L.push("## Historical Documentation Completeness", "");
+  for (const [label, items] of historical) {
+    const completed = items.filter((item) => item.status === "completed");
+    if (completed.length > 0) L.push(`- Completed Work Items without detected ${label}: ${completed.length}`);
+  }
+  if (!historical.some(([, items]) => items.some((item) => item.status === "completed"))) {
+    L.push("No historical documentation completeness gaps were detected.");
+  }
+  L.push("- This is an inventory for review, not a recommendation to rewrite historical Work Items merely to increase a metric.");
+  L.push("");
   if (r2.score_breakdown) {
     L.push("## Score Breakdown", "");
     const b2 = r2.score_breakdown;
@@ -11006,6 +11109,16 @@ function buildSavingsReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
   } else {
     actions.push("Use drift history to calibrate `rework_hours_avoided_per_resolved_drift`.");
   }
+  const calibrationOpportunities = !a2.calibrated_at ? {
+    available: true,
+    reason: source3 === "default" ? "Default assumptions are uncalibrated estimates." : "Project assumptions are not marked as calibrated.",
+    opportunities: [
+      { area: "Context preparation", suggested_evidence: "Compare preparation effort on comparable tasks before and after using the knowledge artifacts." },
+      { area: "Review effort", suggested_evidence: "Record a baseline for comparable reviews with similar ownership coverage." },
+      { area: "Clarification reduction", suggested_evidence: "Estimate effort spent resolving repeated scope or context questions." },
+      { area: "Architecture discovery", suggested_evidence: "Compare discovery time for similar dependency or relationship analyses." }
+    ]
+  } : { available: false, reason: `Assumptions are marked as calibrated on ${a2.calibrated_at}.`, opportunities: [] };
   return {
     generated_at: now.toISOString(),
     project: impact.project,
@@ -11057,6 +11170,7 @@ function buildSavingsReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
     },
     total: { estimated_hours_saved: observedHours, estimated_value: observedValue, currency: a2.currency },
     confidence: { level, reasons },
+    calibration_opportunities: calibrationOpportunities,
     suggested_actions: actions
   };
 }
@@ -11138,6 +11252,17 @@ function renderSavingsMarkdown(r2) {
   L.push(`Confidence: ${r2.confidence.level}`, "", "Reason:");
   for (const reason of r2.confidence.reasons) L.push(`- ${reason}`);
   L.push("");
+  L.push("## Calibration Opportunities", "");
+  if (!r2.calibration_opportunities.available) {
+    L.push(`- ${r2.calibration_opportunities.reason}`);
+  } else {
+    L.push(`- ${r2.calibration_opportunities.reason}`);
+    L.push("- Use external, aggregate project observations; do not collect or store personal data.");
+    for (const opportunity of r2.calibration_opportunities.opportunities) {
+      L.push(`- ${opportunity.area}: ${opportunity.suggested_evidence}`);
+    }
+  }
+  L.push("");
   L.push("## Suggested Actions", "");
   r2.suggested_actions.forEach((act, i) => L.push(`${i + 1}. ${act}`));
   L.push("");
@@ -11158,10 +11283,24 @@ function buildDriftReport(dir, now = /* @__PURE__ */ new Date()) {
   const deprecationFindings = plans.flatMap((plan) => getDeprecationPlan(dir, plan.id)?.targets.flatMap(validateTarget) ?? []);
   const config = loadConfig(dir);
   const topology = config ? buildGraph(dir, config, { scope: "all" }, now) : null;
-  const topologyHints = topology ? buildGraphHints(dir, topology, now).summary.hints : null;
+  const graphHints = topology ? buildGraphHints(dir, topology, now) : null;
+  const topologyHints = graphHints?.summary.hints ?? null;
+  const currentConsistencyFindings = [
+    ...graphHints?.hints.map(graphHintFinding) ?? [],
+    ...deprecationFindings.map((finding, index) => ({
+      id: `deprecation-target:${index + 1}`,
+      category: "consistency",
+      source: "deprecation-target-validation",
+      affected_artifacts: [],
+      priority: "medium",
+      evidence: String(finding),
+      explanation: "A deterministic deprecation target consistency check reported a finding.",
+      suggested_action: "Review the affected deprecation target and its declared lifecycle evidence."
+    }))
+  ];
   const actions = [];
   if (!h2.available) {
-    actions.push("Run `kaddo guard --record` to start recording guard history.");
+    actions.push("Start recording Guard runs at relevant delivery checkpoints with `kaddo guard --record`; one run creates an observation, while multiple comparable runs are needed for a historical trend.");
   } else {
     if (h2.open > 0) actions.push("Review open drift warnings and update related Work Items or ownership.");
     actions.push("Run `kaddo guard --record` before important commits.");
@@ -11177,6 +11316,11 @@ function buildDriftReport(dir, now = /* @__PURE__ */ new Date()) {
       { id: "deprecation-consistency", label: "Deprecation consistency", classification: plans.length === 0 ? "not_applicable" : deprecationFindings.length === 0 ? "derived" : "observed", reason: plans.length === 0 ? "No deprecation plans exist in this project." : deprecationFindings.length === 0 ? `${plans.length} plan(s) passed deterministic target consistency checks.` : `${deprecationFindings.length} deterministic deprecation consistency finding(s) were detected.` },
       { id: "topology-consistency", label: "Knowledge topology consistency", classification: topology === null ? "unknown" : topologyHints === 0 ? "derived" : "observed", reason: topology === null ? "No project configuration is available to construct the topology." : topologyHints === 0 ? `The in-memory topology has ${topology.nodes.length} node(s) and no open deterministic hints.` : `The in-memory topology has ${topologyHints} open deterministic hint(s).` }
     ],
+    current_consistency_findings: currentConsistencyFindings,
+    structural_consistency: {
+      deprecation_target_checks: plans.length === 0 ? "not_applicable" : deprecationFindings.length === 0 ? "passed" : "findings_detected",
+      note: plans.length === 0 ? "No deprecation plans exist in this project." : "Target consistency checks validate declared structural state only; they do not verify operational removal from infrastructure, production or external consumers."
+    },
     guard_history: {
       available: h2.available,
       total_runs: h2.total_runs,
@@ -11202,10 +11346,31 @@ function renderDriftMarkdown(r2) {
   L.push("## Consistency Evidence", "");
   for (const item of r2.consistency_evidence) L.push(`- ${item.label}: ${item.classification} \u2014 ${item.reason}`);
   L.push("");
+  L.push("## Current Consistency Findings", "");
+  if (r2.current_consistency_findings.length === 0) {
+    L.push("No findings detected by the executed consistency checks.");
+    L.push("");
+  }
+  if (r2.current_consistency_findings.length > 0) {
+    const cell = (value) => value.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+    L.push("| Priority | Source | Affected | Finding | Suggested action |");
+    L.push("|---|---|---|---|---|");
+    for (const finding of r2.current_consistency_findings) {
+      L.push(`| ${finding.priority} | ${cell(finding.source)} | ${cell(finding.affected_artifacts.join(", ") || "not available")} | ${cell(finding.explanation)} Evidence: ${cell(finding.evidence)} | ${cell(finding.suggested_action)} |`);
+    }
+    L.push("");
+  }
+  L.push("## Structural Consistency Boundaries", "");
+  L.push(`- Deprecation target checks: ${r2.structural_consistency.deprecation_target_checks}`);
+  L.push(`- Note: ${r2.structural_consistency.note}`);
+  L.push("");
   if (!r2.guard_history.available) {
     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", "");
@@ -11270,6 +11435,8 @@ function serializeDriftJson(r2) {
     project: r2.project,
     project_context: r2.project_context,
     consistency_evidence: r2.consistency_evidence,
+    current_consistency_findings: r2.current_consistency_findings,
+    structural_consistency: r2.structural_consistency,
     guard_history: r2.guard_history,
     drift_warnings: r2.drift_warnings,
     hotspots: r2.hotspots,

package/package.json

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