@optave/codegraph 3.1.4 → 3.2.0

package/src/presentation/brief.js

@@ -0,0 +1,51 @@
+import { briefData } from '../domain/analysis/brief.js';
+import { outputResult } from './result-formatter.js';
+
+/**
+ * Format a compact brief for hook context injection.
+ * Single-block, token-efficient output.
+ *
+ * Example:
+ *   src/domain/graph/builder.js [HIGH RISK]
+ *   Symbols: buildGraph [core, 12 callers], collectFiles [leaf, 2 callers]
+ *   Imports: src/db/index.js, src/domain/parser.js
+ *   Imported by: src/cli/commands/build.js (+8 transitive)
+ */
+export function brief(file, customDbPath, opts = {}) {
+  const data = briefData(file, customDbPath, opts);
+  if (outputResult(data, 'results', opts)) return;
+
+  if (data.results.length === 0) {
+    console.log(`No file matching "${file}" in graph`);
+    return;
+  }
+
+  for (const r of data.results) {
+    console.log(`${r.file} [${r.risk.toUpperCase()} RISK]`);
+
+    // Symbols line
+    if (r.symbols.length > 0) {
+      const parts = r.symbols.map((s) => {
+        const tags = [];
+        if (s.role) tags.push(s.role);
+        tags.push(`${s.callerCount} caller${s.callerCount !== 1 ? 's' : ''}`);
+        return `${s.name} [${tags.join(', ')}]`;
+      });
+      console.log(`  Symbols: ${parts.join(', ')}`);
+    }
+
+    // Imports line
+    if (r.imports.length > 0) {
+      console.log(`  Imports: ${r.imports.join(', ')}`);
+    }
+
+    // Imported by line with transitive count
+    if (r.importedBy.length > 0) {
+      const transitive = r.totalImporterCount - r.importedBy.length;
+      const suffix = transitive > 0 ? ` (+${transitive} transitive)` : '';
+      console.log(`  Imported by: ${r.importedBy.join(', ')}${suffix}`);
+    } else if (r.totalImporterCount > 0) {
+      console.log(`  Imported by: ${r.totalImporterCount} transitive importers`);
+    }
+  }
+}

package/src/{commands → presentation}/cfg.js

@@ -1,4 +1,4 @@
-import { cfgData, cfgToDOT, cfgToMermaid } from '../cfg.js';
+import { cfgData, cfgToDOT, cfgToMermaid } from '../features/cfg.js';
 import { outputResult } from '../infrastructure/result-formatter.js';
 
 /**

package/src/{commands → presentation}/check.js

@@ -1,6 +1,6 @@
-import { checkData } from '../check.js';
-import { AnalysisError } from '../errors.js';
+import { checkData } from '../features/check.js';
 import { outputResult } from '../infrastructure/result-formatter.js';
+import { AnalysisError } from '../shared/errors.js';
 
 /**
  * CLI formatter — prints check results and sets exitCode 1 on failure.

package/src/{commands → presentation}/communities.js

@@ -1,4 +1,4 @@
-import { communitiesData } from '../communities.js';
+import { communitiesData } from '../features/communities.js';
 import { outputResult } from '../infrastructure/result-formatter.js';
 
 /**

package/src/{commands → presentation}/complexity.js

@@ -1,4 +1,4 @@
-import { complexityData } from '../complexity.js';
+import { complexityData } from '../features/complexity.js';
 import { outputResult } from '../infrastructure/result-formatter.js';
 
 /**

package/src/{commands → presentation}/dataflow.js

@@ -1,4 +1,4 @@
-import { dataflowData, dataflowImpactData } from '../dataflow.js';
+import { dataflowData, dataflowImpactData } from '../features/dataflow.js';
 import { outputResult } from '../infrastructure/result-formatter.js';
 
 /**

package/src/{commands → presentation}/flow.js

@@ -1,6 +1,6 @@
-import { flowData, listEntryPointsData } from '../flow.js';
+import { kindIcon } from '../domain/queries.js';
+import { flowData, listEntryPointsData } from '../features/flow.js';
 import { outputResult } from '../infrastructure/result-formatter.js';
-import { kindIcon } from '../queries.js';
 
 /**
  * CLI formatter — text or JSON output.

package/src/{commands → presentation}/manifesto.js

@@ -1,5 +1,5 @@
+import { manifestoData } from '../features/manifesto.js';
 import { outputResult } from '../infrastructure/result-formatter.js';
-import { manifestoData } from '../manifesto.js';
 
 /**
  * CLI formatter — prints manifesto results and sets exitCode 1 on failure.

package/src/{commands → presentation}/owners.js

@@ -1,5 +1,5 @@
+import { ownersData } from '../features/owners.js';
 import { outputResult } from '../infrastructure/result-formatter.js';
-import { ownersData } from '../owners.js';
 
 /**
  * CLI display function for the `owners` command.

package/src/presentation/queries-cli/exports.js

@@ -0,0 +1,53 @@
+import { exportsData, kindIcon } from '../../domain/queries.js';
+import { outputResult } from '../../infrastructure/result-formatter.js';
+
+function printExportHeader(data, opts) {
+  if (opts.unused) {
+    console.log(
+      `\n# ${data.file} — ${data.totalUnused} unused export${data.totalUnused !== 1 ? 's' : ''} (of ${data.totalExported} exported)\n`,
+    );
+  } else {
+    const unusedNote = data.totalUnused > 0 ? ` (${data.totalUnused} unused)` : '';
+    console.log(
+      `\n# ${data.file} — ${data.totalExported} exported${unusedNote}, ${data.totalInternal} internal\n`,
+    );
+  }
+}
+
+function printExportSymbols(results) {
+  for (const sym of results) {
+    const icon = kindIcon(sym.kind);
+    const sig = sym.signature?.params ? `(${sym.signature.params})` : '';
+    const role = sym.role ? ` [${sym.role}]` : '';
+    console.log(`  ${icon} ${sym.name}${sig}${role} :${sym.line}`);
+    if (sym.consumers.length === 0) {
+      console.log('    (no consumers)');
+    } else {
+      for (const c of sym.consumers) {
+        console.log(`    <- ${c.name} (${c.file}:${c.line})`);
+      }
+    }
+  }
+}
+
+export function fileExports(file, customDbPath, opts = {}) {
+  const data = exportsData(file, customDbPath, opts);
+  if (outputResult(data, 'results', opts)) return;
+
+  if (data.results.length === 0) {
+    if (opts.unused) {
+      console.log(`No unused exports found for "${file}".`);
+    } else {
+      console.log(`No exported symbols found for "${file}". Run "codegraph build" first.`);
+    }
+    return;
+  }
+
+  printExportHeader(data, opts);
+  printExportSymbols(data.results);
+
+  if (data.reexports.length > 0) {
+    console.log(`\n  Re-exports: ${data.reexports.map((r) => r.file).join(', ')}`);
+  }
+  console.log();
+}

package/src/presentation/queries-cli/impact.js

@@ -0,0 +1,214 @@
+import {
+  diffImpactData,
+  diffImpactMermaid,
+  fileDepsData,
+  fnDepsData,
+  fnImpactData,
+  impactAnalysisData,
+  kindIcon,
+} from '../../domain/queries.js';
+import { outputResult } from '../../infrastructure/result-formatter.js';
+
+export function fileDeps(file, customDbPath, opts = {}) {
+  const data = fileDepsData(file, customDbPath, opts);
+  if (outputResult(data, 'results', opts)) return;
+
+  if (data.results.length === 0) {
+    console.log(`No file matching "${file}" in graph`);
+    return;
+  }
+
+  for (const r of data.results) {
+    console.log(`\n# ${r.file}\n`);
+    console.log(`  -> Imports (${r.imports.length}):`);
+    for (const i of r.imports) {
+      const typeTag = i.typeOnly ? ' (type-only)' : '';
+      console.log(`    -> ${i.file}${typeTag}`);
+    }
+    console.log(`\n  <- Imported by (${r.importedBy.length}):`);
+    for (const i of r.importedBy) console.log(`    <- ${i.file}`);
+    if (r.definitions.length > 0) {
+      console.log(`\n  Definitions (${r.definitions.length}):`);
+      for (const d of r.definitions.slice(0, 30))
+        console.log(`    ${kindIcon(d.kind)} ${d.name} :${d.line}`);
+      if (r.definitions.length > 30) console.log(`    ... and ${r.definitions.length - 30} more`);
+    }
+    console.log();
+  }
+}
+
+export function fnDeps(name, customDbPath, opts = {}) {
+  const data = fnDepsData(name, customDbPath, opts);
+  if (outputResult(data, 'results', opts)) return;
+
+  if (data.results.length === 0) {
+    console.log(`No function/method/class matching "${name}"`);
+    return;
+  }
+
+  for (const r of data.results) {
+    console.log(`\n${kindIcon(r.kind)} ${r.name} (${r.kind}) -- ${r.file}:${r.line}\n`);
+    if (r.callees.length > 0) {
+      console.log(`  -> Calls (${r.callees.length}):`);
+      for (const c of r.callees)
+        console.log(`    -> ${kindIcon(c.kind)} ${c.name}  ${c.file}:${c.line}`);
+    }
+    if (r.callers.length > 0) {
+      console.log(`\n  <- Called by (${r.callers.length}):`);
+      for (const c of r.callers) {
+        const via = c.viaHierarchy ? ` (via ${c.viaHierarchy})` : '';
+        console.log(`    <- ${kindIcon(c.kind)} ${c.name}  ${c.file}:${c.line}${via}`);
+      }
+    }
+    for (const [d, fns] of Object.entries(r.transitiveCallers)) {
+      console.log(
+        `\n  ${'<-'.repeat(parseInt(d, 10))} Transitive callers (depth ${d}, ${fns.length}):`,
+      );
+      for (const n of fns.slice(0, 20))
+        console.log(
+          `    ${'  '.repeat(parseInt(d, 10) - 1)}<- ${kindIcon(n.kind)} ${n.name}  ${n.file}:${n.line}`,
+        );
+      if (fns.length > 20) console.log(`    ... and ${fns.length - 20} more`);
+    }
+    if (r.callees.length === 0 && r.callers.length === 0) {
+      console.log(`  (no call edges found -- may be invoked dynamically or via re-exports)`);
+    }
+    console.log();
+  }
+}
+
+export function impactAnalysis(file, customDbPath, opts = {}) {
+  const data = impactAnalysisData(file, customDbPath, opts);
+  if (outputResult(data, 'sources', opts)) return;
+
+  if (data.sources.length === 0) {
+    console.log(`No file matching "${file}" in graph`);
+    return;
+  }
+
+  console.log(`\nImpact analysis for files matching "${file}":\n`);
+  for (const s of data.sources) console.log(`  # ${s} (source)`);
+
+  const levels = data.levels;
+  if (Object.keys(levels).length === 0) {
+    console.log(`  No dependents found.`);
+  } else {
+    for (const level of Object.keys(levels).sort((a, b) => a - b)) {
+      const nodes = levels[level];
+      console.log(
+        `\n  ${'--'.repeat(parseInt(level, 10))} Level ${level} (${nodes.length} files):`,
+      );
+      for (const n of nodes.slice(0, 30))
+        console.log(`    ${'  '.repeat(parseInt(level, 10))}^ ${n.file}`);
+      if (nodes.length > 30) console.log(`    ... and ${nodes.length - 30} more`);
+    }
+  }
+  console.log(`\n  Total: ${data.totalDependents} files transitively depend on "${file}"\n`);
+}
+
+export function fnImpact(name, customDbPath, opts = {}) {
+  const data = fnImpactData(name, customDbPath, opts);
+  if (outputResult(data, 'results', opts)) return;
+
+  if (data.results.length === 0) {
+    console.log(`No function/method/class matching "${name}"`);
+    return;
+  }
+
+  for (const r of data.results) {
+    console.log(`\nFunction impact: ${kindIcon(r.kind)} ${r.name} -- ${r.file}:${r.line}\n`);
+    if (Object.keys(r.levels).length === 0) {
+      console.log(`  No callers found.`);
+    } else {
+      for (const [level, fns] of Object.entries(r.levels).sort((a, b) => a[0] - b[0])) {
+        const l = parseInt(level, 10);
+        console.log(`  ${'--'.repeat(l)} Level ${level} (${fns.length} functions):`);
+        for (const f of fns.slice(0, 20))
+          console.log(`    ${'  '.repeat(l)}^ ${kindIcon(f.kind)} ${f.name}  ${f.file}:${f.line}`);
+        if (fns.length > 20) console.log(`    ... and ${fns.length - 20} more`);
+      }
+    }
+    console.log(`\n  Total: ${r.totalDependents} functions transitively depend on ${r.name}\n`);
+  }
+}
+
+function printDiffFunctions(data) {
+  console.log(`\ndiff-impact: ${data.changedFiles} files changed\n`);
+  console.log(`  ${data.affectedFunctions.length} functions changed:\n`);
+  for (const fn of data.affectedFunctions) {
+    console.log(`  ${kindIcon(fn.kind)} ${fn.name} -- ${fn.file}:${fn.line}`);
+    if (fn.transitiveCallers > 0) console.log(`    ^ ${fn.transitiveCallers} transitive callers`);
+  }
+}
+
+function printDiffCoupled(data) {
+  if (!data.historicallyCoupled?.length) return;
+  console.log('\n  Historically coupled (not in static graph):\n');
+  for (const c of data.historicallyCoupled) {
+    const pct = `${(c.jaccard * 100).toFixed(0)}%`;
+    console.log(
+      `    ${c.file}  <- coupled with ${c.coupledWith} (${pct}, ${c.commitCount} commits)`,
+    );
+  }
+}
+
+function printDiffOwnership(data) {
+  if (!data.ownership) return;
+  console.log(`\n  Affected owners: ${data.ownership.affectedOwners.join(', ')}`);
+  console.log(`  Suggested reviewers: ${data.ownership.suggestedReviewers.join(', ')}`);
+}
+
+function printDiffBoundaries(data) {
+  if (!data.boundaryViolations?.length) return;
+  console.log(`\n  Boundary violations (${data.boundaryViolationCount}):\n`);
+  for (const v of data.boundaryViolations) {
+    console.log(`    [${v.name}] ${v.file} -> ${v.targetFile}`);
+    if (v.message) console.log(`      ${v.message}`);
+  }
+}
+
+function printDiffSummary(summary) {
+  if (!summary) return;
+  let line = `\n  Summary: ${summary.functionsChanged} functions changed -> ${summary.callersAffected} callers affected across ${summary.filesAffected} files`;
+  if (summary.historicallyCoupledCount > 0) {
+    line += `, ${summary.historicallyCoupledCount} historically coupled`;
+  }
+  if (summary.ownersAffected > 0) {
+    line += `, ${summary.ownersAffected} owners affected`;
+  }
+  if (summary.boundaryViolationCount > 0) {
+    line += `, ${summary.boundaryViolationCount} boundary violations`;
+  }
+  console.log(`${line}\n`);
+}
+
+export function diffImpact(customDbPath, opts = {}) {
+  if (opts.format === 'mermaid') {
+    console.log(diffImpactMermaid(customDbPath, opts));
+    return;
+  }
+  const data = diffImpactData(customDbPath, opts);
+  if (opts.format === 'json') opts = { ...opts, json: true };
+  if (outputResult(data, 'affectedFunctions', opts)) return;
+
+  if (data.error) {
+    console.log(data.error);
+    return;
+  }
+  if (data.changedFiles === 0) {
+    console.log('No changes detected.');
+    return;
+  }
+  if (data.affectedFunctions.length === 0) {
+    console.log(
+      '  No function-level changes detected (changes may be in imports, types, or config).',
+    );
+    return;
+  }
+
+  printDiffFunctions(data);
+  printDiffCoupled(data);
+  printDiffOwnership(data);
+  printDiffBoundaries(data);
+  printDiffSummary(data.summary);
+}

package/src/presentation/queries-cli/index.js

@@ -0,0 +1,5 @@
+export { fileExports } from './exports.js';
+export { diffImpact, fileDeps, fnDeps, fnImpact, impactAnalysis } from './impact.js';
+export { children, context, explain, queryName, where } from './inspect.js';
+export { moduleMap, roles, stats } from './overview.js';
+export { symbolPath } from './path.js';