@kaddo/cli 3.23.1 → 3.23.2

package/README.md

@@ -512,6 +512,7 @@ create --from roadmap → owners → guard → explain`.
 | v3.22.1 | Guard project-root path normalization: matches `code:` globs when the project is a subfolder of the Git root |
 | v3.23 | Knowledge Impact Report: `kaddo report impact` (Markdown/JSON, `--output`); evidence-first health/coverage/traceability/readiness/signals; MCP resource + tool |
 | v3.23.1 | Impact report Actionable Gaps: per-Work-Item missing source/initiative/ownership/level/acceptance/DoD/validation, broad globs, overlaps; Work-Item-specific Suggested Actions + Score Breakdown |
+| v3.23.2 | Impact report defaults to `all` scope (accumulated impact), graph built in memory; `--scope active`; `scope_source`/`default_scope` in JSON |
 
 **Optional modules (installed with `kaddo add`):**
 

package/dist/index.js

@@ -10933,6 +10933,8 @@ function hasSection(body, re) {
   return body.split(/\r?\n/).some((l) => /^#{1,6}\s+/.test(l) && re.test(l));
 }
 function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
+  const resolvedScope = opts.scope ?? "all";
+  const scopeSource = opts.scopeSource ?? (opts.scope ? "explicit" : "default");
   const exp = buildProjectExplanation(dir);
   const wis = discoverWorkItems(dir);
   const total = wis.length;
@@ -11003,19 +11005,13 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
   }
   const ownershipOverlaps = gaps.ownership_overlaps.length;
   let g;
-  if (opts.scope) {
-    const config = loadConfig(dir);
-    if (config) {
-      const graph = buildGraph(dir, config, { scope: opts.scope }, now);
-      const hints = buildGraphHints(dir, graph, now);
-      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: opts.scope, scopeReason: "", nodes: 0, edges: 0, quality: "unknown", hints: 0, generatedAt: "" };
-    }
-  } else if (exp.graph) {
-    g = { available: true, scope: exp.graph.scope, scopeReason: exp.graph.scopeReason, nodes: exp.graph.nodes, edges: exp.graph.edges, quality: exp.graphHints?.quality ?? "unknown", hints: exp.graphHints?.totalHints ?? 0, generatedAt: exp.graph.generatedAt };
+  const config = loadConfig(dir);
+  if (config) {
+    const graph = buildGraph(dir, config, { scope: resolvedScope }, now);
+    const hints = buildGraphHints(dir, graph, now);
+    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: "n/a", scopeReason: "", nodes: 0, edges: 0, quality: "unknown", hints: 0, generatedAt: "" };
+    g = { available: false, scope: resolvedScope, scopeReason: "", nodes: 0, edges: 0, quality: "unknown", hints: 0, generatedAt: "" };
   }
   const layerStatus = (name) => exp.layers.find((l) => l.layer === name)?.status ?? "Missing";
   const byState = exp.workItems.byState;
@@ -11113,7 +11109,7 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
   };
   const actions = [];
   if (!g.available) actions.push("Run `kaddo graph export --scope all` to inspect full traceability.");
-  else if (g.scope === "active" && g.quality === "empty") actions.push("Run `kaddo graph export --scope all` to include completed Work Items.");
+  else if (g.scope === "active" && g.quality === "empty") actions.push("Run `kaddo impact --scope all` to measure accumulated knowledge impact.");
   if (exp.roadmap.remaining > 0) actions.push(`Materialize the ${exp.roadmap.remaining} remaining roadmap candidate(s) with \`kaddo create --from roadmap\`.`);
   for (const a of [
     groupedAction(gaps.missing_code_ownership, "Add `code:` ownership to"),
@@ -11138,6 +11134,8 @@ function buildImpactReport(dir, opts = {}, now = /* @__PURE__ */ new Date()) {
     generated_at: now.toISOString(),
     project: exp.project.name,
     scope: g.scope,
+    default_scope: "all",
+    scope_source: scopeSource,
     executive_summary: summary,
     knowledge_health,
     knowledge_coverage,
@@ -11192,6 +11190,11 @@ function renderImpactMarkdown(r) {
   L.push(`Scope: ${r.scope}`);
   if (r.score !== null) L.push(`Knowledge Impact Score: ${r.score}/100`);
   else L.push("Knowledge Impact Score: not available");
+  if (r.scope_source === "default") {
+    L.push("Scope note: Impact reports use `all` by default to measure accumulated knowledge impact.");
+  } else if (r.scope === "active" && r.graph_quality.available === false) {
+    L.push("Tip: Run `kaddo impact --scope all` to inspect accumulated knowledge impact.");
+  }
   L.push("");
   L.push("## Executive Summary", "");
   for (const s2 of r.executive_summary) L.push(`- ${s2}`);
@@ -11248,6 +11251,9 @@ function renderImpactMarkdown(r) {
     L.push(`- Hints: ${gq.hints}`);
     if (gq.reason) L.push(`- Reason: ${gq.reason}`);
     if (gq.last_exported) L.push(`- Last exported: ${gq.last_exported}`);
+    if (gq.scope === "active" && gq.quality === "empty") {
+      L.push("- Tip: Run `kaddo impact --scope all` to inspect accumulated knowledge impact.");
+    }
   } else {
     L.push("- Graph data not available.");
     L.push(`- Tip: ${r.graph_quality.suggestion}`);
@@ -11331,7 +11337,8 @@ function serializeImpactJson(r) {
 function runReportImpact(opts = {}) {
   const dir = cwd();
   requireConfig(dir);
-  const report = buildImpactReport(dir);
+  const scope = opts.scope === "active" ? "active" : opts.scope === "all" ? "all" : void 0;
+  const report = buildImpactReport(dir, { scope });
   const content = opts.json ? serializeImpactJson(report) : renderImpactMarkdown(report);
   if (opts.output) {
     intro2("kaddo report impact");
@@ -11374,10 +11381,10 @@ graphCmd.command("export").description("Write the knowledge graph to .kaddo/grap
   runGraphExport(opts);
 });
 var reportCmd = program.command("report").description("Generate Kaddo reports");
-reportCmd.command("impact").description("Knowledge Impact Report: knowledge health, coverage, traceability, readiness (deterministic, no LLM)").option("--json", "Output JSON instead of Markdown").option("--output <path>", "Write the report to a file (e.g. .kaddo/reports/impact-report.md)").action((opts) => {
+reportCmd.command("impact").description("Knowledge Impact Report: knowledge health, coverage, traceability, readiness (deterministic, no LLM)").option("--json", "Output JSON instead of Markdown").option("--scope <scope>", "Scope: all (default \u2014 accumulated impact) or active").option("--output <path>", "Write the report to a file (e.g. .kaddo/reports/impact-report.md)").action((opts) => {
   runReportImpact(opts);
 });
-program.command("impact").description("Alias for `kaddo report impact`").option("--json", "Output JSON instead of Markdown").option("--output <path>", "Write the report to a file").action((opts) => {
+program.command("impact").description("Alias for `kaddo report impact`").option("--json", "Output JSON instead of Markdown").option("--scope <scope>", "Scope: all (default \u2014 accumulated impact) or active").option("--output <path>", "Write the report to a file").action((opts) => {
   runReportImpact(opts);
 });
 program.command("guard").description("Check if modified code has related artifacts that were not updated").option("--staged", "Check only staged files").option("--no-interactive", "Disable interactive ignore prompts").option("--ci", "CI mode: output JSON, no prompts, non-blocking").option("--json", "Output JSON (alias for --ci)").option("--workspace", "Also check local mapped module repos from .kaddo/modules.yml (opt-in)").option("--include-archived", "Include archived Work Items in ownership matching (excluded by default)").action(async (opts) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaddo/cli",
-  "version": "3.23.1",
+  "version": "3.23.2",
   "description": "Knowledge Driven Development toolkit",
   "license": "MIT",
   "repository": {