@optave/codegraph 3.1.5 → 3.3.0

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

@@ -2,6 +2,8 @@ import {
   childrenData,
   contextData,
   explainData,
+  implementationsData,
+  interfacesData,
   kindIcon,
   queryNameData,
   whereData,
@@ -96,117 +98,232 @@ export function context(name, customDbPath, opts = {}) {
   }
 
   for (const r of data.results) {
-    const lineRange = r.endLine ? `${r.line}-${r.endLine}` : `${r.line}`;
-    const roleTag = r.role ? ` [${r.role}]` : '';
-    console.log(`\n# ${r.name} (${r.kind})${roleTag} — ${r.file}:${lineRange}\n`);
-
-    // Signature
-    if (r.signature) {
-      console.log('## Type/Shape Info');
-      if (r.signature.params != null) console.log(`  Parameters: (${r.signature.params})`);
-      if (r.signature.returnType) console.log(`  Returns: ${r.signature.returnType}`);
-      console.log();
-    }
+    renderContextResult(r);
+  }
+}
+
+export function children(name, customDbPath, opts = {}) {
+  const data = childrenData(name, customDbPath, opts);
+  if (outputResult(data, 'results', opts)) return;
 
-    // Children
-    if (r.children && r.children.length > 0) {
-      console.log(`## Children (${r.children.length})`);
+  if (data.results.length === 0) {
+    console.log(`No symbol matching "${name}"`);
+    return;
+  }
+  for (const r of data.results) {
+    console.log(`\n${kindIcon(r.kind)} ${r.name}  ${r.file}:${r.line}`);
+    if (r.children.length === 0) {
+      console.log('  (no children)');
+    } else {
       for (const c of r.children) {
         console.log(`  ${kindIcon(c.kind)} ${c.name}  :${c.line}`);
       }
-      console.log();
     }
+  }
+}
+
+function renderContextResult(r) {
+  const lineRange = r.endLine ? `${r.line}-${r.endLine}` : `${r.line}`;
+  const roleTag = r.role ? ` [${r.role}]` : '';
+  console.log(`\n# ${r.name} (${r.kind})${roleTag} — ${r.file}:${lineRange}\n`);
 
-    // Complexity
-    if (r.complexity) {
-      const cx = r.complexity;
-      const miPart = cx.maintainabilityIndex ? ` | MI: ${cx.maintainabilityIndex}` : '';
-      console.log('## Complexity');
-      console.log(
-        `  Cognitive: ${cx.cognitive} | Cyclomatic: ${cx.cyclomatic} | Max Nesting: ${cx.maxNesting}${miPart}`,
-      );
-      console.log();
+  if (r.signature) {
+    console.log('## Type/Shape Info');
+    if (r.signature.params != null) console.log(`  Parameters: (${r.signature.params})`);
+    if (r.signature.returnType) console.log(`  Returns: ${r.signature.returnType}`);
+    console.log();
+  }
+
+  if (r.children && r.children.length > 0) {
+    console.log(`## Children (${r.children.length})`);
+    for (const c of r.children) {
+      console.log(`  ${kindIcon(c.kind)} ${c.name}  :${c.line}`);
     }
+    console.log();
+  }
 
-    // Source
-    if (r.source) {
-      console.log('## Source');
-      for (const line of r.source.split('\n')) {
-        console.log(`  ${line}`);
-      }
-      console.log();
+  if (r.complexity) {
+    const cx = r.complexity;
+    const miPart = cx.maintainabilityIndex ? ` | MI: ${cx.maintainabilityIndex}` : '';
+    console.log('## Complexity');
+    console.log(
+      `  Cognitive: ${cx.cognitive} | Cyclomatic: ${cx.cyclomatic} | Max Nesting: ${cx.maxNesting}${miPart}`,
+    );
+    console.log();
+  }
+
+  if (r.source) {
+    console.log('## Source');
+    for (const line of r.source.split('\n')) {
+      console.log(`  ${line}`);
     }
+    console.log();
+  }
 
-    // Callees
-    if (r.callees.length > 0) {
-      console.log(`## Direct Dependencies (${r.callees.length})`);
-      for (const c of r.callees) {
-        const summary = c.summary ? ` — ${c.summary}` : '';
-        console.log(`  ${kindIcon(c.kind)} ${c.name}  ${c.file}:${c.line}${summary}`);
-        if (c.source) {
-          for (const line of c.source.split('\n').slice(0, 10)) {
-            console.log(`    | ${line}`);
-          }
+  if (r.callees.length > 0) {
+    console.log(`## Direct Dependencies (${r.callees.length})`);
+    for (const c of r.callees) {
+      const summary = c.summary ? ` — ${c.summary}` : '';
+      console.log(`  ${kindIcon(c.kind)} ${c.name}  ${c.file}:${c.line}${summary}`);
+      if (c.source) {
+        for (const line of c.source.split('\n').slice(0, 10)) {
+          console.log(`    | ${line}`);
         }
       }
-      console.log();
     }
+    console.log();
+  }
 
-    // Callers
-    if (r.callers.length > 0) {
-      console.log(`## Callers (${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}`);
-      }
-      console.log();
+  if (r.callers.length > 0) {
+    console.log(`## Callers (${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}`);
     }
+    console.log();
+  }
 
-    // Related tests
-    if (r.relatedTests.length > 0) {
-      console.log('## Related Tests');
-      for (const t of r.relatedTests) {
-        console.log(`  ${t.file} — ${t.testCount} tests`);
-        for (const tn of t.testNames) {
-          console.log(`    - ${tn}`);
-        }
-        if (t.source) {
-          console.log('    Source:');
-          for (const line of t.source.split('\n').slice(0, 20)) {
-            console.log(`    | ${line}`);
-          }
+  if (r.implementors && r.implementors.length > 0) {
+    console.log(`## Implementors (${r.implementors.length})`);
+    for (const impl of r.implementors) {
+      console.log(`  ${kindIcon(impl.kind)} ${impl.name}  ${impl.file}:${impl.line}`);
+    }
+    console.log();
+  }
+
+  if (r.implements && r.implements.length > 0) {
+    console.log(`## Implements (${r.implements.length})`);
+    for (const iface of r.implements) {
+      console.log(`  ${kindIcon(iface.kind)} ${iface.name}  ${iface.file}:${iface.line}`);
+    }
+    console.log();
+  }
+
+  if (r.relatedTests.length > 0) {
+    console.log('## Related Tests');
+    for (const t of r.relatedTests) {
+      console.log(`  ${t.file} — ${t.testCount} tests`);
+      for (const tn of t.testNames) {
+        console.log(`    - ${tn}`);
+      }
+      if (t.source) {
+        console.log('    Source:');
+        for (const line of t.source.split('\n').slice(0, 20)) {
+          console.log(`    | ${line}`);
         }
       }
-      console.log();
     }
+    console.log();
+  }
 
-    if (r.callees.length === 0 && r.callers.length === 0 && r.relatedTests.length === 0) {
-      console.log(
-        '  (no call edges or tests found — may be invoked dynamically or via re-exports)',
-      );
-      console.log();
+  if (r.callees.length === 0 && r.callers.length === 0 && r.relatedTests.length === 0) {
+    console.log('  (no call edges or tests found — may be invoked dynamically or via re-exports)');
+    console.log();
+  }
+}
+
+function renderFileExplain(r) {
+  const publicCount = r.publicApi.length;
+  const internalCount = r.internal.length;
+  const lineInfo = r.lineCount ? `${r.lineCount} lines, ` : '';
+  console.log(`\n# ${r.file}`);
+  console.log(
+    `  ${lineInfo}${r.symbolCount} symbols (${publicCount} exported, ${internalCount} internal)`,
+  );
+
+  if (r.imports.length > 0) {
+    console.log(`  Imports: ${r.imports.map((i) => i.file).join(', ')}`);
+  }
+  if (r.importedBy.length > 0) {
+    console.log(`  Imported by: ${r.importedBy.map((i) => i.file).join(', ')}`);
+  }
+
+  if (r.publicApi.length > 0) {
+    console.log(`\n## Exported`);
+    for (const s of r.publicApi) {
+      const sig = s.signature?.params != null ? `(${s.signature.params})` : '';
+      const roleTag = s.role ? ` [${s.role}]` : '';
+      const summary = s.summary ? `  -- ${s.summary}` : '';
+      console.log(`  ${kindIcon(s.kind)} ${s.name}${sig}${roleTag} :${s.line}${summary}`);
     }
   }
+
+  if (r.internal.length > 0) {
+    console.log(`\n## Internal`);
+    for (const s of r.internal) {
+      const sig = s.signature?.params != null ? `(${s.signature.params})` : '';
+      const roleTag = s.role ? ` [${s.role}]` : '';
+      const summary = s.summary ? `  -- ${s.summary}` : '';
+      console.log(`  ${kindIcon(s.kind)} ${s.name}${sig}${roleTag} :${s.line}${summary}`);
+    }
+  }
+
+  if (r.dataFlow.length > 0) {
+    console.log(`\n## Data Flow`);
+    for (const df of r.dataFlow) {
+      console.log(`  ${df.caller} -> ${df.callees.join(', ')}`);
+    }
+  }
+  console.log();
 }
 
-export function children(name, customDbPath, opts = {}) {
-  const data = childrenData(name, customDbPath, opts);
-  if (outputResult(data, 'results', opts)) return;
+function renderFunctionExplain(r, indent = '') {
+  const lineRange = r.endLine ? `${r.line}-${r.endLine}` : `${r.line}`;
+  const lineInfo = r.lineCount ? `${r.lineCount} lines` : '';
+  const summaryPart = r.summary ? ` | ${r.summary}` : '';
+  const roleTag = r.role ? ` [${r.role}]` : '';
+  const depthLevel = r._depth || 0;
+  const heading = depthLevel === 0 ? '#' : '##'.padEnd(depthLevel + 2, '#');
+  console.log(`\n${indent}${heading} ${r.name} (${r.kind})${roleTag}  ${r.file}:${lineRange}`);
+  if (lineInfo || r.summary) {
+    console.log(`${indent}  ${lineInfo}${summaryPart}`);
+  }
+  if (r.signature) {
+    if (r.signature.params != null) console.log(`${indent}  Parameters: (${r.signature.params})`);
+    if (r.signature.returnType) console.log(`${indent}  Returns: ${r.signature.returnType}`);
+  }
 
-  if (data.results.length === 0) {
-    console.log(`No symbol matching "${name}"`);
-    return;
+  if (r.complexity) {
+    const cx = r.complexity;
+    const miPart = cx.maintainabilityIndex ? ` MI=${cx.maintainabilityIndex}` : '';
+    console.log(
+      `${indent}  Complexity: cognitive=${cx.cognitive} cyclomatic=${cx.cyclomatic} nesting=${cx.maxNesting}${miPart}`,
+    );
   }
-  for (const r of data.results) {
-    console.log(`\n${kindIcon(r.kind)} ${r.name}  ${r.file}:${r.line}`);
-    if (r.children.length === 0) {
-      console.log('  (no children)');
-    } else {
-      for (const c of r.children) {
-        console.log(`  ${kindIcon(c.kind)} ${c.name}  :${c.line}`);
-      }
+
+  if (r.callees.length > 0) {
+    console.log(`\n${indent}  Calls (${r.callees.length}):`);
+    for (const c of r.callees) {
+      console.log(`${indent}    ${kindIcon(c.kind)} ${c.name}  ${c.file}:${c.line}`);
+    }
+  }
+
+  if (r.callers.length > 0) {
+    console.log(`\n${indent}  Called by (${r.callers.length}):`);
+    for (const c of r.callers) {
+      console.log(`${indent}    ${kindIcon(c.kind)} ${c.name}  ${c.file}:${c.line}`);
+    }
+  }
+
+  if (r.relatedTests.length > 0) {
+    const label = r.relatedTests.length === 1 ? 'file' : 'files';
+    console.log(`\n${indent}  Tests (${r.relatedTests.length} ${label}):`);
+    for (const t of r.relatedTests) {
+      console.log(`${indent}    ${t.file}`);
+    }
+  }
+
+  if (r.callees.length === 0 && r.callers.length === 0) {
+    console.log(`${indent}  (no call edges found -- may be invoked dynamically or via re-exports)`);
+  }
+
+  if (r.depDetails && r.depDetails.length > 0) {
+    console.log(`\n${indent}  --- Dependencies (depth ${depthLevel + 1}) ---`);
+    for (const dep of r.depDetails) {
+      renderFunctionExplain(dep, `${indent}  `);
     }
   }
+  console.log();
 }
 
 export function explain(target, customDbPath, opts = {}) {
@@ -220,115 +337,57 @@ export function explain(target, customDbPath, opts = {}) {
 
   if (data.kind === 'file') {
     for (const r of data.results) {
-      const publicCount = r.publicApi.length;
-      const internalCount = r.internal.length;
-      const lineInfo = r.lineCount ? `${r.lineCount} lines, ` : '';
-      console.log(`\n# ${r.file}`);
-      console.log(
-        `  ${lineInfo}${r.symbolCount} symbols (${publicCount} exported, ${internalCount} internal)`,
-      );
-
-      if (r.imports.length > 0) {
-        console.log(`  Imports: ${r.imports.map((i) => i.file).join(', ')}`);
-      }
-      if (r.importedBy.length > 0) {
-        console.log(`  Imported by: ${r.importedBy.map((i) => i.file).join(', ')}`);
-      }
-
-      if (r.publicApi.length > 0) {
-        console.log(`\n## Exported`);
-        for (const s of r.publicApi) {
-          const sig = s.signature?.params != null ? `(${s.signature.params})` : '';
-          const roleTag = s.role ? ` [${s.role}]` : '';
-          const summary = s.summary ? `  -- ${s.summary}` : '';
-          console.log(`  ${kindIcon(s.kind)} ${s.name}${sig}${roleTag} :${s.line}${summary}`);
-        }
-      }
-
-      if (r.internal.length > 0) {
-        console.log(`\n## Internal`);
-        for (const s of r.internal) {
-          const sig = s.signature?.params != null ? `(${s.signature.params})` : '';
-          const roleTag = s.role ? ` [${s.role}]` : '';
-          const summary = s.summary ? `  -- ${s.summary}` : '';
-          console.log(`  ${kindIcon(s.kind)} ${s.name}${sig}${roleTag} :${s.line}${summary}`);
-        }
-      }
-
-      if (r.dataFlow.length > 0) {
-        console.log(`\n## Data Flow`);
-        for (const df of r.dataFlow) {
-          console.log(`  ${df.caller} -> ${df.callees.join(', ')}`);
-        }
-      }
-      console.log();
+      renderFileExplain(r);
     }
   } else {
-    function printFunctionExplain(r, indent = '') {
-      const lineRange = r.endLine ? `${r.line}-${r.endLine}` : `${r.line}`;
-      const lineInfo = r.lineCount ? `${r.lineCount} lines` : '';
-      const summaryPart = r.summary ? ` | ${r.summary}` : '';
-      const roleTag = r.role ? ` [${r.role}]` : '';
-      const depthLevel = r._depth || 0;
-      const heading = depthLevel === 0 ? '#' : '##'.padEnd(depthLevel + 2, '#');
-      console.log(`\n${indent}${heading} ${r.name} (${r.kind})${roleTag}  ${r.file}:${lineRange}`);
-      if (lineInfo || r.summary) {
-        console.log(`${indent}  ${lineInfo}${summaryPart}`);
-      }
-      if (r.signature) {
-        if (r.signature.params != null)
-          console.log(`${indent}  Parameters: (${r.signature.params})`);
-        if (r.signature.returnType) console.log(`${indent}  Returns: ${r.signature.returnType}`);
-      }
+    for (const r of data.results) {
+      renderFunctionExplain(r);
+    }
+  }
+}
 
-      if (r.complexity) {
-        const cx = r.complexity;
-        const miPart = cx.maintainabilityIndex ? ` MI=${cx.maintainabilityIndex}` : '';
-        console.log(
-          `${indent}  Complexity: cognitive=${cx.cognitive} cyclomatic=${cx.cyclomatic} nesting=${cx.maxNesting}${miPart}`,
-        );
-      }
+export function implementations(name, customDbPath, opts = {}) {
+  const data = implementationsData(name, customDbPath, opts);
+  if (outputResult(data, 'results', opts)) return;
 
-      if (r.callees.length > 0) {
-        console.log(`\n${indent}  Calls (${r.callees.length}):`);
-        for (const c of r.callees) {
-          console.log(`${indent}    ${kindIcon(c.kind)} ${c.name}  ${c.file}:${c.line}`);
-        }
-      }
+  if (data.results.length === 0) {
+    console.log(`No symbol matching "${name}"`);
+    return;
+  }
 
-      if (r.callers.length > 0) {
-        console.log(`\n${indent}  Called by (${r.callers.length}):`);
-        for (const c of r.callers) {
-          console.log(`${indent}    ${kindIcon(c.kind)} ${c.name}  ${c.file}:${c.line}`);
-        }
+  for (const r of data.results) {
+    console.log(`\n${kindIcon(r.kind)} ${r.name}  ${r.file}:${r.line}`);
+    if (r.implementors.length === 0) {
+      console.log('  (no implementors found)');
+    } else {
+      console.log(`  Implementors (${r.implementors.length}):`);
+      for (const impl of r.implementors) {
+        console.log(`    ${kindIcon(impl.kind)} ${impl.name}  ${impl.file}:${impl.line}`);
       }
+    }
+  }
+  console.log();
+}
 
-      if (r.relatedTests.length > 0) {
-        const label = r.relatedTests.length === 1 ? 'file' : 'files';
-        console.log(`\n${indent}  Tests (${r.relatedTests.length} ${label}):`);
-        for (const t of r.relatedTests) {
-          console.log(`${indent}    ${t.file}`);
-        }
-      }
+export function interfaces(name, customDbPath, opts = {}) {
+  const data = interfacesData(name, customDbPath, opts);
+  if (outputResult(data, 'results', opts)) return;
 
-      if (r.callees.length === 0 && r.callers.length === 0) {
-        console.log(
-          `${indent}  (no call edges found -- may be invoked dynamically or via re-exports)`,
-        );
-      }
+  if (data.results.length === 0) {
+    console.log(`No symbol matching "${name}"`);
+    return;
+  }
 
-      // Render recursive dependency details
-      if (r.depDetails && r.depDetails.length > 0) {
-        console.log(`\n${indent}  --- Dependencies (depth ${depthLevel + 1}) ---`);
-        for (const dep of r.depDetails) {
-          printFunctionExplain(dep, `${indent}  `);
-        }
+  for (const r of data.results) {
+    console.log(`\n${kindIcon(r.kind)} ${r.name}  ${r.file}:${r.line}`);
+    if (r.interfaces.length === 0) {
+      console.log('  (no interfaces/traits found)');
+    } else {
+      console.log(`  Implements (${r.interfaces.length}):`);
+      for (const iface of r.interfaces) {
+        console.log(`    ${kindIcon(iface.kind)} ${iface.name}  ${iface.file}:${iface.line}`);
       }
-      console.log();
-    }
-
-    for (const r of data.results) {
-      printFunctionExplain(r);
     }
   }
+  console.log();
 }

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

@@ -2,64 +2,42 @@ import path from 'node:path';
 import { kindIcon, moduleMapData, rolesData, statsData } from '../../domain/queries.js';
 import { outputResult } from '../../infrastructure/result-formatter.js';
 
-export async function stats(customDbPath, opts = {}) {
-  const data = statsData(customDbPath, { noTests: opts.noTests });
-
-  // Community detection summary (async import for lazy-loading)
-  try {
-    const { communitySummaryForStats } = await import('../../features/communities.js');
-    data.communities = communitySummaryForStats(customDbPath, { noTests: opts.noTests });
-  } catch {
-    /* graphology may not be available */
-  }
-
-  if (outputResult(data, null, opts)) return;
-
-  // Human-readable output
-  console.log('\n# Codegraph Stats\n');
-
-  // Nodes
-  console.log(`Nodes:     ${data.nodes.total} total`);
-  const kindEntries = Object.entries(data.nodes.byKind).sort((a, b) => b[1] - a[1]);
-  const kindParts = kindEntries.map(([k, v]) => `${k} ${v}`);
-  for (let i = 0; i < kindParts.length; i += 3) {
-    const row = kindParts
+function printCountGrid(entries, padWidth) {
+  const parts = entries.map(([k, v]) => `${k} ${v}`);
+  for (let i = 0; i < parts.length; i += 3) {
+    const row = parts
       .slice(i, i + 3)
-      .map((p) => p.padEnd(18))
+      .map((p) => p.padEnd(padWidth))
       .join('');
     console.log(`  ${row}`);
   }
+}
 
-  // Edges
+function printNodes(data) {
+  console.log(`Nodes:     ${data.nodes.total} total`);
+  const kindEntries = Object.entries(data.nodes.byKind).sort((a, b) => b[1] - a[1]);
+  printCountGrid(kindEntries, 18);
+}
+
+function printEdges(data) {
   console.log(`\nEdges:     ${data.edges.total} total`);
   const edgeEntries = Object.entries(data.edges.byKind).sort((a, b) => b[1] - a[1]);
-  const edgeParts = edgeEntries.map(([k, v]) => `${k} ${v}`);
-  for (let i = 0; i < edgeParts.length; i += 3) {
-    const row = edgeParts
-      .slice(i, i + 3)
-      .map((p) => p.padEnd(18))
-      .join('');
-    console.log(`  ${row}`);
-  }
+  printCountGrid(edgeEntries, 18);
+}
 
-  // Files
+function printFiles(data) {
   console.log(`\nFiles:     ${data.files.total} (${data.files.languages} languages)`);
   const langEntries = Object.entries(data.files.byLanguage).sort((a, b) => b[1] - a[1]);
-  const langParts = langEntries.map(([k, v]) => `${k} ${v}`);
-  for (let i = 0; i < langParts.length; i += 3) {
-    const row = langParts
-      .slice(i, i + 3)
-      .map((p) => p.padEnd(18))
-      .join('');
-    console.log(`  ${row}`);
-  }
+  printCountGrid(langEntries, 18);
+}
 
-  // Cycles
+function printCycles(data) {
   console.log(
     `\nCycles:    ${data.cycles.fileLevel} file-level, ${data.cycles.functionLevel} function-level`,
   );
+}
 
-  // Hotspots
+function printHotspots(data) {
   if (data.hotspots.length > 0) {
     console.log(`\nTop ${data.hotspots.length} coupling hotspots:`);
     for (let i = 0; i < data.hotspots.length; i++) {
@@ -69,8 +47,9 @@ export async function stats(customDbPath, opts = {}) {
       );
     }
   }
+}
 
-  // Embeddings
+function printEmbeddings(data) {
   if (data.embeddings) {
     const e = data.embeddings;
     console.log(
@@ -79,8 +58,9 @@ export async function stats(customDbPath, opts = {}) {
   } else {
     console.log('\nEmbeddings: not built');
   }
+}
 
-  // Quality
+function printQuality(data) {
   if (data.quality) {
     const q = data.quality;
     const cc = q.callerCoverage;
@@ -99,24 +79,18 @@ export async function stats(customDbPath, opts = {}) {
       }
     }
   }
+}
 
-  // Roles
+function printRoles(data) {
   if (data.roles && Object.keys(data.roles).length > 0) {
     const total = Object.values(data.roles).reduce((a, b) => a + b, 0);
     console.log(`\nRoles:     ${total} classified symbols`);
-    const roleParts = Object.entries(data.roles)
-      .sort((a, b) => b[1] - a[1])
-      .map(([k, v]) => `${k} ${v}`);
-    for (let i = 0; i < roleParts.length; i += 3) {
-      const row = roleParts
-        .slice(i, i + 3)
-        .map((p) => p.padEnd(18))
-        .join('');
-      console.log(`  ${row}`);
-    }
+    const roleEntries = Object.entries(data.roles).sort((a, b) => b[1] - a[1]);
+    printCountGrid(roleEntries, 18);
   }
+}
 
-  // Complexity
+function printComplexity(data) {
   if (data.complexity) {
     const cx = data.complexity;
     const miPart = cx.avgMI != null ? ` | avg MI: ${cx.avgMI} | min MI: ${cx.minMI}` : '';
@@ -124,15 +98,40 @@ export async function stats(customDbPath, opts = {}) {
       `\nComplexity: ${cx.analyzed} functions | avg cognitive: ${cx.avgCognitive} | avg cyclomatic: ${cx.avgCyclomatic} | max cognitive: ${cx.maxCognitive}${miPart}`,
     );
   }
+}
 
-  // Communities
+function printCommunities(data) {
   if (data.communities) {
     const cm = data.communities;
     console.log(
       `\nCommunities: ${cm.communityCount} detected | modularity: ${cm.modularity} | drift: ${cm.driftScore}%`,
     );
   }
+}
+
+export async function stats(customDbPath, opts = {}) {
+  const data = statsData(customDbPath, { noTests: opts.noTests });
+
+  try {
+    const { communitySummaryForStats } = await import('../../features/communities.js');
+    data.communities = communitySummaryForStats(customDbPath, { noTests: opts.noTests });
+  } catch {
+    /* graphology may not be available */
+  }
 
+  if (outputResult(data, null, opts)) return;
+
+  console.log('\n# Codegraph Stats\n');
+  printNodes(data);
+  printEdges(data);
+  printFiles(data);
+  printCycles(data);
+  printHotspots(data);
+  printEmbeddings(data);
+  printQuality(data);
+  printRoles(data);
+  printComplexity(data);
+  printCommunities(data);
   console.log();
 }