@optave/codegraph 3.1.0 → 3.1.2

package/src/commands/audit.js

@@ -0,0 +1,88 @@
+import { auditData } from '../audit.js';
+import { outputResult } from '../infrastructure/result-formatter.js';
+import { kindIcon } from '../queries.js';
+
+/**
+ * CLI formatter for the audit command.
+ */
+export function audit(target, customDbPath, opts = {}) {
+  const data = auditData(target, customDbPath, opts);
+
+  if (outputResult(data, null, opts)) return;
+
+  if (data.functions.length === 0) {
+    console.log(`No ${data.kind === 'file' ? 'file' : 'function/symbol'} matching "${target}"`);
+    return;
+  }
+
+  console.log(`\n# Audit: ${target} (${data.kind})`);
+  console.log(`  ${data.functions.length} function(s) analyzed\n`);
+
+  for (const fn of data.functions) {
+    const lineRange = fn.endLine ? `${fn.line}-${fn.endLine}` : `${fn.line}`;
+    const roleTag = fn.role ? ` [${fn.role}]` : '';
+    console.log(`## ${kindIcon(fn.kind)} ${fn.name} (${fn.kind})${roleTag}`);
+    console.log(`  ${fn.file}:${lineRange}${fn.lineCount ? ` (${fn.lineCount} lines)` : ''}`);
+    if (fn.summary) console.log(`  ${fn.summary}`);
+    if (fn.signature) {
+      if (fn.signature.params != null) console.log(`  Parameters: (${fn.signature.params})`);
+      if (fn.signature.returnType) console.log(`  Returns: ${fn.signature.returnType}`);
+    }
+
+    // Health metrics
+    if (fn.health.cognitive != null) {
+      console.log(`\n  Health:`);
+      console.log(
+        `    Cognitive: ${fn.health.cognitive}  Cyclomatic: ${fn.health.cyclomatic}  Nesting: ${fn.health.maxNesting}`,
+      );
+      console.log(`    MI: ${fn.health.maintainabilityIndex}`);
+      if (fn.health.halstead.volume) {
+        console.log(
+          `    Halstead: vol=${fn.health.halstead.volume} diff=${fn.health.halstead.difficulty} effort=${fn.health.halstead.effort} bugs=${fn.health.halstead.bugs}`,
+        );
+      }
+      if (fn.health.loc) {
+        console.log(
+          `    LOC: ${fn.health.loc}  SLOC: ${fn.health.sloc}  Comments: ${fn.health.commentLines}`,
+        );
+      }
+    }
+
+    // Threshold breaches
+    if (fn.health.thresholdBreaches.length > 0) {
+      console.log(`\n  Threshold Breaches:`);
+      for (const b of fn.health.thresholdBreaches) {
+        const icon = b.level === 'fail' ? 'FAIL' : 'WARN';
+        console.log(`    [${icon}] ${b.metric}: ${b.value} >= ${b.threshold}`);
+      }
+    }
+
+    // Impact
+    console.log(`\n  Impact: ${fn.impact.totalDependents} transitive dependent(s)`);
+    for (const [level, nodes] of Object.entries(fn.impact.levels)) {
+      console.log(`    Level ${level}: ${nodes.map((n) => n.name).join(', ')}`);
+    }
+
+    // Call edges
+    if (fn.callees.length > 0) {
+      console.log(`\n  Calls (${fn.callees.length}):`);
+      for (const c of fn.callees) {
+        console.log(`    ${kindIcon(c.kind)} ${c.name}  ${c.file}:${c.line}`);
+      }
+    }
+    if (fn.callers.length > 0) {
+      console.log(`\n  Called by (${fn.callers.length}):`);
+      for (const c of fn.callers) {
+        console.log(`    ${kindIcon(c.kind)} ${c.name}  ${c.file}:${c.line}`);
+      }
+    }
+    if (fn.relatedTests.length > 0) {
+      console.log(`\n  Tests (${fn.relatedTests.length}):`);
+      for (const t of fn.relatedTests) {
+        console.log(`    ${t.file}`);
+      }
+    }
+
+    console.log();
+  }
+}

package/src/commands/batch.js

@@ -0,0 +1,26 @@
+import { batchData, multiBatchData } from '../batch.js';
+
+/**
+ * CLI wrapper — calls batchData and prints JSON to stdout.
+ */
+export function batch(command, targets, customDbPath, opts = {}) {
+  const data = batchData(command, targets, customDbPath, opts);
+  console.log(JSON.stringify(data, null, 2));
+}
+
+/**
+ * CLI wrapper for batch-query — detects multi-command mode (objects with .command)
+ * or falls back to single-command batchData (default: 'where').
+ */
+export function batchQuery(targets, customDbPath, opts = {}) {
+  const { command: defaultCommand = 'where', ...rest } = opts;
+  const isMulti = targets.length > 0 && typeof targets[0] === 'object' && targets[0].command;
+
+  let data;
+  if (isMulti) {
+    data = multiBatchData(targets, customDbPath, rest);
+  } else {
+    data = batchData(defaultCommand, targets, customDbPath, rest);
+  }
+  console.log(JSON.stringify(data, null, 2));
+}

package/src/commands/branch-compare.js

@@ -0,0 +1,97 @@
+import { branchCompareData, branchCompareMermaid } from '../branch-compare.js';
+import { outputResult } from '../infrastructure/result-formatter.js';
+import { kindIcon } from '../queries.js';
+
+// ─── Text Formatting ────────────────────────────────────────────────────
+
+function formatText(data) {
+  if (data.error) return `Error: ${data.error}`;
+
+  const lines = [];
+  const shortBase = data.baseSha.slice(0, 7);
+  const shortTarget = data.targetSha.slice(0, 7);
+
+  lines.push(`branch-compare: ${data.baseRef}..${data.targetRef}`);
+  lines.push(`  Base:   ${data.baseRef} (${shortBase})`);
+  lines.push(`  Target: ${data.targetRef} (${shortTarget})`);
+  lines.push(`  Files changed: ${data.changedFiles.length}`);
+
+  if (data.added.length > 0) {
+    lines.push('');
+    lines.push(`  + Added (${data.added.length} symbol${data.added.length !== 1 ? 's' : ''}):`);
+    for (const sym of data.added) {
+      lines.push(`    [${kindIcon(sym.kind)}] ${sym.name} -- ${sym.file}:${sym.line}`);
+    }
+  }
+
+  if (data.removed.length > 0) {
+    lines.push('');
+    lines.push(
+      `  - Removed (${data.removed.length} symbol${data.removed.length !== 1 ? 's' : ''}):`,
+    );
+    for (const sym of data.removed) {
+      lines.push(`    [${kindIcon(sym.kind)}] ${sym.name} -- ${sym.file}:${sym.line}`);
+      if (sym.impact && sym.impact.length > 0) {
+        lines.push(
+          `      ^ ${sym.impact.length} transitive caller${sym.impact.length !== 1 ? 's' : ''} affected`,
+        );
+      }
+    }
+  }
+
+  if (data.changed.length > 0) {
+    lines.push('');
+    lines.push(
+      `  ~ Changed (${data.changed.length} symbol${data.changed.length !== 1 ? 's' : ''}):`,
+    );
+    for (const sym of data.changed) {
+      const parts = [];
+      if (sym.changes.lineCount !== 0) {
+        parts.push(`lines: ${sym.base.lineCount} -> ${sym.target.lineCount}`);
+      }
+      if (sym.changes.fanIn !== 0) {
+        parts.push(`fan_in: ${sym.base.fanIn} -> ${sym.target.fanIn}`);
+      }
+      if (sym.changes.fanOut !== 0) {
+        parts.push(`fan_out: ${sym.base.fanOut} -> ${sym.target.fanOut}`);
+      }
+      const detail = parts.length > 0 ? `  (${parts.join(', ')})` : '';
+      lines.push(
+        `    [${kindIcon(sym.kind)}] ${sym.name} -- ${sym.file}:${sym.base.line}${detail}`,
+      );
+      if (sym.impact && sym.impact.length > 0) {
+        lines.push(
+          `      ^ ${sym.impact.length} transitive caller${sym.impact.length !== 1 ? 's' : ''} affected`,
+        );
+      }
+    }
+  }
+
+  const s = data.summary;
+  lines.push('');
+  lines.push(
+    `  Summary: +${s.added} added, -${s.removed} removed, ~${s.changed} changed` +
+      ` -> ${s.totalImpacted} caller${s.totalImpacted !== 1 ? 's' : ''} impacted` +
+      (s.filesAffected > 0
+        ? ` across ${s.filesAffected} file${s.filesAffected !== 1 ? 's' : ''}`
+        : ''),
+  );
+
+  return lines.join('\n');
+}
+
+// ─── CLI Display Function ───────────────────────────────────────────────
+
+export async function branchCompare(baseRef, targetRef, opts = {}) {
+  const data = await branchCompareData(baseRef, targetRef, opts);
+
+  if (opts.format === 'json') opts = { ...opts, json: true };
+  if (outputResult(data, null, opts)) return;
+
+  if (opts.format === 'mermaid') {
+    console.log(branchCompareMermaid(data));
+    return;
+  }
+
+  console.log(formatText(data));
+}

package/src/commands/cfg.js

@@ -0,0 +1,55 @@
+import { cfgData, cfgToDOT, cfgToMermaid } from '../cfg.js';
+import { outputResult } from '../infrastructure/result-formatter.js';
+
+/**
+ * CLI display for cfg command.
+ */
+export function cfg(name, customDbPath, opts = {}) {
+  const data = cfgData(name, customDbPath, opts);
+
+  if (outputResult(data, 'results', opts)) return;
+
+  if (data.warning) {
+    console.log(`\u26A0  ${data.warning}`);
+    return;
+  }
+  if (data.results.length === 0) {
+    console.log(`No symbols matching "${name}".`);
+    return;
+  }
+
+  const format = opts.format || 'text';
+  if (format === 'dot') {
+    console.log(cfgToDOT(data));
+    return;
+  }
+  if (format === 'mermaid') {
+    console.log(cfgToMermaid(data));
+    return;
+  }
+
+  // Text format
+  for (const r of data.results) {
+    console.log(`\n${r.kind} ${r.name}  (${r.file}:${r.line})`);
+    console.log('\u2500'.repeat(60));
+    console.log(`  Blocks: ${r.summary.blockCount}  Edges: ${r.summary.edgeCount}`);
+
+    if (r.blocks.length > 0) {
+      console.log('\n  Blocks:');
+      for (const b of r.blocks) {
+        const loc = b.startLine
+          ? ` L${b.startLine}${b.endLine && b.endLine !== b.startLine ? `-${b.endLine}` : ''}`
+          : '';
+        const label = b.label ? ` (${b.label})` : '';
+        console.log(`    [${b.index}] ${b.type}${label}${loc}`);
+      }
+    }
+
+    if (r.edges.length > 0) {
+      console.log('\n  Edges:');
+      for (const e of r.edges) {
+        console.log(`    B${e.source} \u2192 B${e.target}  [${e.kind}]`);
+      }
+    }
+  }
+}

package/src/commands/check.js

@@ -0,0 +1,82 @@
+import { checkData } from '../check.js';
+import { outputResult } from '../infrastructure/result-formatter.js';
+
+/**
+ * CLI formatter — prints check results and exits with code 1 on failure.
+ */
+export function check(customDbPath, opts = {}) {
+  const data = checkData(customDbPath, opts);
+
+  if (data.error) {
+    console.error(data.error);
+    process.exit(1);
+  }
+
+  if (outputResult(data, null, opts)) {
+    if (!data.passed) process.exit(1);
+    return;
+  }
+
+  console.log('\n# Check Results\n');
+
+  if (data.predicates.length === 0) {
+    console.log('  No changes detected.\n');
+    return;
+  }
+
+  console.log(
+    `  Changed files: ${data.summary.changedFiles}  New files: ${data.summary.newFiles}\n`,
+  );
+
+  for (const pred of data.predicates) {
+    const icon = pred.passed ? 'PASS' : 'FAIL';
+    console.log(`  [${icon}] ${pred.name}`);
+
+    if (!pred.passed) {
+      if (pred.name === 'cycles' && pred.cycles) {
+        for (const cycle of pred.cycles.slice(0, 10)) {
+          console.log(`         ${cycle.join(' -> ')}`);
+        }
+        if (pred.cycles.length > 10) {
+          console.log(`         ... and ${pred.cycles.length - 10} more`);
+        }
+      }
+      if (pred.name === 'blast-radius' && pred.violations) {
+        for (const v of pred.violations.slice(0, 10)) {
+          console.log(
+            `         ${v.name} (${v.kind}) at ${v.file}:${v.line} — ${v.transitiveCallers} callers (max: ${pred.threshold})`,
+          );
+        }
+        if (pred.violations.length > 10) {
+          console.log(`         ... and ${pred.violations.length - 10} more`);
+        }
+      }
+      if (pred.name === 'signatures' && pred.violations) {
+        for (const v of pred.violations.slice(0, 10)) {
+          console.log(`         ${v.name} (${v.kind}) at ${v.file}:${v.line}`);
+        }
+        if (pred.violations.length > 10) {
+          console.log(`         ... and ${pred.violations.length - 10} more`);
+        }
+      }
+      if (pred.name === 'boundaries' && pred.violations) {
+        for (const v of pred.violations.slice(0, 10)) {
+          console.log(`         ${v.from} -> ${v.to} (${v.edgeKind})`);
+        }
+        if (pred.violations.length > 10) {
+          console.log(`         ... and ${pred.violations.length - 10} more`);
+        }
+      }
+    }
+    if (pred.note) {
+      console.log(`         ${pred.note}`);
+    }
+  }
+
+  const s = data.summary;
+  console.log(`\n  ${s.total} predicates | ${s.passed} passed | ${s.failed} failed\n`);
+
+  if (!data.passed) {
+    process.exit(1);
+  }
+}

package/src/commands/cochange.js

@@ -0,0 +1,37 @@
+/**
+ * Format co-change data for CLI output (single file).
+ */
+export function formatCoChange(data) {
+  if (data.error) return data.error;
+  if (data.partners.length === 0) return `No co-change partners found for ${data.file}`;
+
+  const lines = [`\nCo-change partners for ${data.file}:\n`];
+  for (const p of data.partners) {
+    const pct = `${(p.jaccard * 100).toFixed(0)}%`.padStart(4);
+    const commits = `${p.commitCount} commits`.padStart(12);
+    lines.push(`  ${pct}  ${commits}  ${p.file}`);
+  }
+  if (data.meta?.analyzedAt) {
+    lines.push(`\n  Analyzed: ${data.meta.analyzedAt} | Window: ${data.meta.since || 'all'}`);
+  }
+  return lines.join('\n');
+}
+
+/**
+ * Format top co-change pairs for CLI output (global view).
+ */
+export function formatCoChangeTop(data) {
+  if (data.error) return data.error;
+  if (data.pairs.length === 0) return 'No co-change pairs found.';
+
+  const lines = ['\nTop co-change pairs:\n'];
+  for (const p of data.pairs) {
+    const pct = `${(p.jaccard * 100).toFixed(0)}%`.padStart(4);
+    const commits = `${p.commitCount} commits`.padStart(12);
+    lines.push(`  ${pct}  ${commits}  ${p.fileA}  <->  ${p.fileB}`);
+  }
+  if (data.meta?.analyzedAt) {
+    lines.push(`\n  Analyzed: ${data.meta.analyzedAt} | Window: ${data.meta.since || 'all'}`);
+  }
+  return lines.join('\n');
+}

package/src/commands/communities.js

@@ -0,0 +1,69 @@
+import { communitiesData } from '../communities.js';
+import { outputResult } from '../infrastructure/result-formatter.js';
+
+/**
+ * CLI entry point: run community detection and print results.
+ */
+export function communities(customDbPath, opts = {}) {
+  const data = communitiesData(customDbPath, opts);
+
+  if (outputResult(data, 'communities', opts)) return;
+
+  if (data.summary.communityCount === 0) {
+    console.log(
+      '\nNo communities detected. The graph may be too small or disconnected.\n' +
+        'Run "codegraph build" first to populate the graph.\n',
+    );
+    return;
+  }
+
+  const mode = opts.functions ? 'Function' : 'File';
+  console.log(`\n# ${mode}-Level Communities\n`);
+  console.log(
+    `  ${data.summary.communityCount} communities | ${data.summary.nodeCount} nodes | modularity: ${data.summary.modularity} | drift: ${data.summary.driftScore}%\n`,
+  );
+
+  if (!opts.drift) {
+    for (const c of data.communities) {
+      const dirs = Object.entries(c.directories)
+        .sort((a, b) => b[1] - a[1])
+        .map(([d, n]) => `${d} (${n})`)
+        .join(', ');
+      console.log(`  Community ${c.id} (${c.size} members): ${dirs}`);
+      if (c.members) {
+        const shown = c.members.slice(0, 8);
+        for (const m of shown) {
+          const kind = m.kind ? ` [${m.kind}]` : '';
+          console.log(`    - ${m.name}${kind}  ${m.file}`);
+        }
+        if (c.members.length > 8) {
+          console.log(`    ... and ${c.members.length - 8} more`);
+        }
+      }
+    }
+  }
+
+  // Drift analysis
+  const d = data.drift;
+  if (d.splitCandidates.length > 0 || d.mergeCandidates.length > 0) {
+    console.log(`\n# Drift Analysis (score: ${data.summary.driftScore}%)\n`);
+
+    if (d.splitCandidates.length > 0) {
+      console.log('  Split candidates (directories spanning multiple communities):');
+      for (const s of d.splitCandidates.slice(0, 10)) {
+        console.log(`    - ${s.directory} → ${s.communityCount} communities`);
+      }
+    }
+
+    if (d.mergeCandidates.length > 0) {
+      console.log('  Merge candidates (communities spanning multiple directories):');
+      for (const m of d.mergeCandidates.slice(0, 10)) {
+        console.log(
+          `    - Community ${m.communityId} (${m.size} members) → ${m.directoryCount} dirs: ${m.directories.join(', ')}`,
+        );
+      }
+    }
+  }
+
+  console.log();
+}

package/src/commands/complexity.js

@@ -0,0 +1,77 @@
+import { complexityData } from '../complexity.js';
+import { outputResult } from '../infrastructure/result-formatter.js';
+
+/**
+ * Format complexity output for CLI display.
+ */
+export function complexity(customDbPath, opts = {}) {
+  const data = complexityData(customDbPath, opts);
+
+  if (outputResult(data, 'functions', opts)) return;
+
+  if (data.functions.length === 0) {
+    if (data.summary === null) {
+      if (data.hasGraph) {
+        console.log(
+          '\nNo complexity data found, but a graph exists. Run "codegraph build --no-incremental" to populate complexity metrics.\n',
+        );
+      } else {
+        console.log(
+          '\nNo complexity data found. Run "codegraph build" first to analyze your codebase.\n',
+        );
+      }
+    } else {
+      console.log('\nNo functions match the given filters.\n');
+    }
+    return;
+  }
+
+  const header = opts.aboveThreshold ? 'Functions Above Threshold' : 'Function Complexity';
+  console.log(`\n# ${header}\n`);
+
+  if (opts.health) {
+    // Health-focused view with Halstead + MI columns
+    console.log(
+      `  ${'Function'.padEnd(35)} ${'File'.padEnd(25)} ${'MI'.padStart(5)} ${'Vol'.padStart(7)} ${'Diff'.padStart(6)} ${'Effort'.padStart(9)} ${'Bugs'.padStart(6)} ${'LOC'.padStart(5)} ${'SLOC'.padStart(5)}`,
+    );
+    console.log(
+      `  ${'─'.repeat(35)} ${'─'.repeat(25)} ${'─'.repeat(5)} ${'─'.repeat(7)} ${'─'.repeat(6)} ${'─'.repeat(9)} ${'─'.repeat(6)} ${'─'.repeat(5)} ${'─'.repeat(5)}`,
+    );
+
+    for (const fn of data.functions) {
+      const name = fn.name.length > 33 ? `${fn.name.slice(0, 32)}…` : fn.name;
+      const file = fn.file.length > 23 ? `…${fn.file.slice(-22)}` : fn.file;
+      const miWarn = fn.exceeds?.includes('maintainabilityIndex') ? '!' : ' ';
+      console.log(
+        `  ${name.padEnd(35)} ${file.padEnd(25)} ${String(fn.maintainabilityIndex).padStart(5)}${miWarn}${String(fn.halstead.volume).padStart(7)} ${String(fn.halstead.difficulty).padStart(6)} ${String(fn.halstead.effort).padStart(9)} ${String(fn.halstead.bugs).padStart(6)} ${String(fn.loc).padStart(5)} ${String(fn.sloc).padStart(5)}`,
+      );
+    }
+  } else {
+    // Default view with MI column appended
+    console.log(
+      `  ${'Function'.padEnd(40)} ${'File'.padEnd(30)} ${'Cog'.padStart(4)} ${'Cyc'.padStart(4)} ${'Nest'.padStart(5)} ${'MI'.padStart(5)}`,
+    );
+    console.log(
+      `  ${'─'.repeat(40)} ${'─'.repeat(30)} ${'─'.repeat(4)} ${'─'.repeat(4)} ${'─'.repeat(5)} ${'─'.repeat(5)}`,
+    );
+
+    for (const fn of data.functions) {
+      const name = fn.name.length > 38 ? `${fn.name.slice(0, 37)}…` : fn.name;
+      const file = fn.file.length > 28 ? `…${fn.file.slice(-27)}` : fn.file;
+      const warn = fn.exceeds ? ' !' : '';
+      const mi = fn.maintainabilityIndex > 0 ? String(fn.maintainabilityIndex) : '-';
+      console.log(
+        `  ${name.padEnd(40)} ${file.padEnd(30)} ${String(fn.cognitive).padStart(4)} ${String(fn.cyclomatic).padStart(4)} ${String(fn.maxNesting).padStart(5)} ${mi.padStart(5)}${warn}`,
+      );
+    }
+  }
+
+  if (data.summary) {
+    const s = data.summary;
+    const miPart = s.avgMI != null ? ` | avg MI: ${s.avgMI}` : '';
+    console.log(
+      `\n  ${s.analyzed} functions analyzed | avg cognitive: ${s.avgCognitive} | avg cyclomatic: ${s.avgCyclomatic}${miPart} | ${s.aboveWarn} above threshold`,
+    );
+  }
+  console.log();
+}

package/src/commands/dataflow.js

@@ -0,0 +1,110 @@
+import { dataflowData, dataflowImpactData } from '../dataflow.js';
+import { outputResult } from '../infrastructure/result-formatter.js';
+
+/**
+ * CLI display for dataflow command.
+ */
+export function dataflow(name, customDbPath, opts = {}) {
+  if (opts.impact) {
+    return dataflowImpact(name, customDbPath, opts);
+  }
+
+  const data = dataflowData(name, customDbPath, opts);
+
+  if (outputResult(data, 'results', opts)) return;
+
+  if (data.warning) {
+    console.log(`⚠  ${data.warning}`);
+    return;
+  }
+  if (data.results.length === 0) {
+    console.log(`No symbols matching "${name}".`);
+    return;
+  }
+
+  for (const r of data.results) {
+    console.log(`\n${r.kind} ${r.name}  (${r.file}:${r.line})`);
+    console.log('─'.repeat(60));
+
+    if (r.flowsTo.length > 0) {
+      console.log('\n  Data flows TO:');
+      for (const f of r.flowsTo) {
+        const conf = f.confidence < 1.0 ? ` [${(f.confidence * 100).toFixed(0)}%]` : '';
+        console.log(`    → ${f.target} (${f.file}:${f.line}) arg[${f.paramIndex}]${conf}`);
+      }
+    }
+
+    if (r.flowsFrom.length > 0) {
+      console.log('\n  Data flows FROM:');
+      for (const f of r.flowsFrom) {
+        const conf = f.confidence < 1.0 ? ` [${(f.confidence * 100).toFixed(0)}%]` : '';
+        console.log(`    ← ${f.source} (${f.file}:${f.line}) arg[${f.paramIndex}]${conf}`);
+      }
+    }
+
+    if (r.returns.length > 0) {
+      console.log('\n  Return value consumed by:');
+      for (const c of r.returns) {
+        console.log(`    → ${c.consumer} (${c.file}:${c.line})  ${c.expression}`);
+      }
+    }
+
+    if (r.returnedBy.length > 0) {
+      console.log('\n  Uses return value of:');
+      for (const p of r.returnedBy) {
+        console.log(`    ← ${p.producer} (${p.file}:${p.line})  ${p.expression}`);
+      }
+    }
+
+    if (r.mutates.length > 0) {
+      console.log('\n  Mutates:');
+      for (const m of r.mutates) {
+        console.log(`    ✎ ${m.expression}  (line ${m.line})`);
+      }
+    }
+
+    if (r.mutatedBy.length > 0) {
+      console.log('\n  Mutated by:');
+      for (const m of r.mutatedBy) {
+        console.log(`    ✎ ${m.source} — ${m.expression}  (line ${m.line})`);
+      }
+    }
+  }
+}
+
+/**
+ * CLI display for dataflow --impact.
+ */
+function dataflowImpact(name, customDbPath, opts = {}) {
+  const data = dataflowImpactData(name, customDbPath, {
+    noTests: opts.noTests,
+    depth: opts.depth ? Number(opts.depth) : 5,
+    file: opts.file,
+    kind: opts.kind,
+    limit: opts.limit,
+    offset: opts.offset,
+  });
+
+  if (outputResult(data, 'results', opts)) return;
+
+  if (data.warning) {
+    console.log(`⚠  ${data.warning}`);
+    return;
+  }
+  if (data.results.length === 0) {
+    console.log(`No symbols matching "${name}".`);
+    return;
+  }
+
+  for (const r of data.results) {
+    console.log(
+      `\n${r.kind} ${r.name}  (${r.file}:${r.line})  — ${r.totalAffected} data-dependent consumer${r.totalAffected !== 1 ? 's' : ''}`,
+    );
+    for (const [level, items] of Object.entries(r.levels)) {
+      console.log(`  Level ${level}:`);
+      for (const item of items) {
+        console.log(`    ${item.name} (${item.file}:${item.line})`);
+      }
+    }
+  }
+}