@promptwheel/core 0.7.13 → 0.7.17

package/dist/codebase-index/dead-code.js

@@ -0,0 +1,158 @@
+/**
+ * Dead code detection and structural issue analysis.
+ *
+ * Cross-module export-import matching to find unused exports and
+ * structural anti-patterns. Pure functions — no I/O.
+ */
+// ---------------------------------------------------------------------------
+// Dead export detection
+// ---------------------------------------------------------------------------
+/**
+ * Detect potentially dead exports by comparing each module's exported names
+ * against what other modules import. Uses name-based matching (no type
+ * resolution) — sufficient for high-confidence identification.
+ *
+ * Returns at most `maxResults` entries to keep prompt token count bounded.
+ */
+export function detectDeadExports(modules, edges, exportsByModule, importsByModule, maxResults = 30) {
+    // Build a set of all imported names across all modules
+    const allImportedNames = new Set();
+    for (const imports of Object.values(importsByModule)) {
+        for (const spec of imports) {
+            // Extract the imported name from the specifier
+            // For relative imports like './foo', the actual imported names come from
+            // import { X } statements — we only have specifiers, not destructured names.
+            // So we use a heuristic: mark the last segment of the path as "used"
+            const parts = spec.split('/');
+            const lastPart = parts[parts.length - 1];
+            if (lastPart)
+                allImportedNames.add(lastPart);
+            // Also add the full specifier for exact matches
+            allImportedNames.add(spec);
+        }
+    }
+    // For each module with exports, check if any export name is never imported
+    const dead = [];
+    for (const mod of modules) {
+        if (dead.length >= maxResults)
+            break;
+        const exports = exportsByModule[mod.path];
+        if (!exports || exports.length === 0)
+            continue;
+        // Skip if this module has no dependents (everything would be "dead")
+        // — the whole module might be an entrypoint
+        const hasImporters = Object.values(edges).some(deps => deps.includes(mod.path));
+        if (!hasImporters)
+            continue;
+        for (const exp of exports) {
+            if (dead.length >= maxResults)
+                break;
+            // Skip 'default' — too noisy, often used implicitly
+            if (exp.name === 'default')
+                continue;
+            // Skip type exports — they're erased at runtime and aren't a real concern
+            if (exp.kind === 'type' || exp.kind === 'interface')
+                continue;
+            // Check if this name appears in any import specifier
+            if (!allImportedNames.has(exp.name)) {
+                dead.push({ module: mod.path, name: exp.name, kind: exp.kind });
+            }
+        }
+    }
+    return dead;
+}
+// ---------------------------------------------------------------------------
+// Structural issue detection
+// ---------------------------------------------------------------------------
+/**
+ * Detect structural anti-patterns from dependency graph topology.
+ *
+ * Patterns detected:
+ * - god-module: fan_in > 5 AND file_count > 20
+ * - excessive-fan-out: fan_out > 8
+ * - barrel-only: 1 file that exists only to re-export
+ * - orphan: zero in/out edges, not an entrypoint
+ *
+ * Returns at most `maxResults` entries.
+ */
+export function detectStructuralIssues(modules, edges, reverseEdges, cycles, entrypoints = [], maxResults = 15) {
+    const issues = [];
+    const entrypointDirs = new Set(entrypoints.map(e => e.split('/').slice(0, -1).join('/')));
+    // Circular dependencies (from pre-computed cycles)
+    for (const cycle of cycles) {
+        if (issues.length >= maxResults)
+            break;
+        const display = cycle.join(' → ');
+        issues.push({
+            kind: 'circular-dep',
+            module: cycle[0],
+            detail: display,
+            severity: 'warning',
+        });
+    }
+    for (const mod of modules) {
+        if (issues.length >= maxResults)
+            break;
+        const fanIn = (reverseEdges[mod.path] ?? []).length;
+        const fanOut = (edges[mod.path] ?? []).length;
+        // God module: many dependents + many files
+        if (fanIn > 5 && mod.file_count > 20) {
+            issues.push({
+                kind: 'god-module',
+                module: mod.path,
+                detail: `fan-in: ${fanIn}, ${mod.file_count} files`,
+                severity: 'warning',
+            });
+        }
+        // Excessive fan-out
+        if (fanOut > 8) {
+            issues.push({
+                kind: 'excessive-fan-out',
+                module: mod.path,
+                detail: `imports ${fanOut} modules`,
+                severity: 'info',
+            });
+        }
+        // Barrel-only: 1 file, has exports but is just re-exporting
+        if (mod.file_count === 1 && fanOut > 0 && fanIn > 0 && (mod.export_count ?? 0) > 0) {
+            // Heuristic: barrel if export_count > 0 and it imports from multiple modules
+            if (fanOut >= 2) {
+                issues.push({
+                    kind: 'barrel-only',
+                    module: mod.path,
+                    detail: `1 file, re-exports from ${fanOut} modules`,
+                    severity: 'info',
+                });
+            }
+        }
+        // Orphan: no edges, not an entrypoint
+        if (fanIn === 0 && fanOut === 0 && !entrypointDirs.has(mod.path) && mod.production) {
+            issues.push({
+                kind: 'orphan',
+                module: mod.path,
+                detail: 'no dependencies',
+                severity: 'info',
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * Compute Robert C. Martin's instability metric per module.
+ * I = Ce / (Ca + Ce) where:
+ * - Ca (afferent coupling) = fan_in (who depends on me)
+ * - Ce (efferent coupling) = fan_out (who I depend on)
+ * - I = 0: maximally stable (many dependents, no dependencies)
+ * - I = 1: maximally unstable (no dependents, many dependencies)
+ */
+export function computeCouplingMetrics(modules, edges, reverseEdges) {
+    const instability = {};
+    for (const mod of modules) {
+        const ca = (reverseEdges[mod.path] ?? []).length; // afferent
+        const ce = (edges[mod.path] ?? []).length; // efferent
+        const total = ca + ce;
+        instability[mod.path] = total > 0 ? ce / total : 0;
+    }
+    return { instability };
+}
+//# sourceMappingURL=dead-code.js.map

package/dist/codebase-index/dead-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-code.js","sourceRoot":"","sources":["../../src/codebase-index/dead-code.ts"],"names":[],"mappings":"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"}

package/dist/codebase-index/format-analysis.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Format analysis data (dead exports, structural issues, graph insights,
+ * TS analysis) into a compact prompt block for the scout.
+ *
+ * Rotates sections by cycle number to stay within ~800 token budget per cycle.
+ * Pure function — no I/O.
+ */
+import type { CodebaseIndex } from './shared.js';
+/**
+ * Format analysis data for scout prompt injection.
+ *
+ * Rotates which sections are included based on `scoutCycle` to keep token
+ * count bounded (~800 tokens max). Each cycle shows 2-3 sections.
+ *
+ * Returns `null` if no analysis data is available.
+ */
+export declare function formatAnalysisForPrompt(index: CodebaseIndex, scoutCycle: number): string | null;
+//# sourceMappingURL=format-analysis.d.ts.map

package/dist/codebase-index/format-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-analysis.d.ts","sourceRoot":"","sources":["../../src/codebase-index/format-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,aAAa,EAId,MAAM,aAAa,CAAC;AAuIrB;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CA0Df"}

package/dist/codebase-index/format-analysis.js

@@ -0,0 +1,191 @@
+/**
+ * Format analysis data (dead exports, structural issues, graph insights,
+ * TS analysis) into a compact prompt block for the scout.
+ *
+ * Rotates sections by cycle number to stay within ~800 token budget per cycle.
+ * Pure function — no I/O.
+ */
+// ---------------------------------------------------------------------------
+// Section renderers
+// ---------------------------------------------------------------------------
+function formatDeadExports(dead) {
+    if (dead.length === 0)
+        return '';
+    // Group by module
+    const byModule = new Map();
+    for (const d of dead) {
+        const names = byModule.get(d.module) ?? [];
+        names.push(d.name);
+        byModule.set(d.module, names);
+    }
+    const lines = [`### Dead Exports (${dead.length} potentially unused)`];
+    for (const [mod, names] of byModule) {
+        lines.push(`${mod}: ${names.join(', ')}`);
+    }
+    return lines.join('\n');
+}
+function formatStructuralIssues(issues) {
+    if (issues.length === 0)
+        return '';
+    const lines = ['### Structural Issues'];
+    for (const issue of issues) {
+        lines.push(`- ${issue.kind}: ${issue.module} — ${issue.detail} (${issue.severity})`);
+    }
+    return lines.join('\n');
+}
+function formatGraphInsights(index) {
+    const parts = [];
+    if (index.graph_metrics) {
+        const { hub_modules, orphan_modules, leaf_modules } = index.graph_metrics;
+        if (hub_modules.length > 0) {
+            parts.push(`Hub modules (3+ dependents): ${hub_modules.join(', ')}`);
+        }
+        if (leaf_modules.length > 0) {
+            parts.push(`Leaf modules (no dependents): ${leaf_modules.slice(0, 8).join(', ')}`);
+        }
+        if (orphan_modules.length > 0) {
+            parts.push(`Orphan modules: ${orphan_modules.slice(0, 5).join(', ')}`);
+        }
+    }
+    if (index.dependency_cycles && index.dependency_cycles.length > 0) {
+        const formatted = index.dependency_cycles
+            .slice(0, 5)
+            .map(c => c.join(' → '));
+        parts.push(`Circular dependencies: ${formatted.join('; ')}`);
+    }
+    if (parts.length === 0)
+        return '';
+    return ['### Graph Topology', ...parts].join('\n');
+}
+function formatCouplingInsights(index) {
+    // Extract instability extremes from modules
+    const modules = index.modules;
+    const edges = index.dependency_edges;
+    const reverse = index.reverse_edges ?? {};
+    const unstable = [];
+    const stable = [];
+    for (const mod of modules) {
+        if (!mod.production)
+            continue;
+        const ca = (reverse[mod.path] ?? []).length;
+        const ce = (edges[mod.path] ?? []).length;
+        const total = ca + ce;
+        if (total === 0)
+            continue;
+        const instability = ce / total;
+        if (instability >= 0.9)
+            unstable.push(mod.path);
+        else if (instability <= 0.1 && ca >= 2)
+            stable.push(mod.path);
+    }
+    if (unstable.length === 0 && stable.length === 0)
+        return '';
+    const parts = ['### Coupling Analysis'];
+    if (unstable.length > 0) {
+        parts.push(`Most unstable (easy to change, few dependents): ${unstable.slice(0, 5).join(', ')}`);
+    }
+    if (stable.length > 0) {
+        parts.push(`Most stable (many dependents, hard to change safely): ${stable.slice(0, 5).join(', ')}`);
+    }
+    return parts.join('\n');
+}
+function formatTypeScriptAnalysis(ts) {
+    const parts = ['### TypeScript Quality'];
+    parts.push(`any-count: ${ts.any_count}, type assertions: ${ts.unchecked_type_assertions}`);
+    if (ts.any_propagation_paths.length > 0) {
+        const worst = ts.any_propagation_paths
+            .sort((a, b) => b.length - a.length)
+            .slice(0, 3);
+        for (const p of worst) {
+            parts.push(`any propagation: ${p.source} → ${p.reaches.join(', ')} (${p.length} hop${p.length !== 1 ? 's' : ''})`);
+        }
+    }
+    // API surface summary — just top 5 by export count
+    const surfaceEntries = Object.entries(ts.api_surface)
+        .sort(([, a], [, b]) => b - a)
+        .slice(0, 5);
+    if (surfaceEntries.length > 0) {
+        parts.push(`Largest API surfaces: ${surfaceEntries.map(([m, c]) => `${m} (${c})`).join(', ')}`);
+    }
+    return parts.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * All available analysis sections, in display priority order.
+ */
+const SECTIONS = [
+    'dead-exports',
+    'structural',
+    'graph',
+    'coupling',
+    'typescript',
+];
+/**
+ * Format analysis data for scout prompt injection.
+ *
+ * Rotates which sections are included based on `scoutCycle` to keep token
+ * count bounded (~800 tokens max). Each cycle shows 2-3 sections.
+ *
+ * Returns `null` if no analysis data is available.
+ */
+export function formatAnalysisForPrompt(index, scoutCycle) {
+    // Render all sections
+    const rendered = new Map();
+    if (index.dead_exports && index.dead_exports.length > 0) {
+        const s = formatDeadExports(index.dead_exports);
+        if (s)
+            rendered.set('dead-exports', s);
+    }
+    if (index.structural_issues && index.structural_issues.length > 0) {
+        const s = formatStructuralIssues(index.structural_issues);
+        if (s)
+            rendered.set('structural', s);
+    }
+    {
+        const s = formatGraphInsights(index);
+        if (s)
+            rendered.set('graph', s);
+    }
+    {
+        const s = formatCouplingInsights(index);
+        if (s)
+            rendered.set('coupling', s);
+    }
+    if (index.typescript_analysis && (index.typescript_analysis.any_count > 0 || index.typescript_analysis.unchecked_type_assertions > 0)) {
+        const s = formatTypeScriptAnalysis(index.typescript_analysis);
+        if (s)
+            rendered.set('typescript', s);
+    }
+    if (rendered.size === 0)
+        return null;
+    // If 3 or fewer sections, show all (fits in budget)
+    if (rendered.size <= 3) {
+        const parts = ['## Codebase Analysis'];
+        for (const key of SECTIONS) {
+            const content = rendered.get(key);
+            if (content)
+                parts.push(content);
+        }
+        return parts.join('\n\n');
+    }
+    // Rotate: show 3 sections per cycle
+    const available = SECTIONS.filter(k => rendered.has(k));
+    const windowSize = 3;
+    const start = (scoutCycle * windowSize) % available.length;
+    const selected = new Set();
+    for (let i = 0; i < windowSize && i < available.length; i++) {
+        selected.add(available[(start + i) % available.length]);
+    }
+    const parts = ['## Codebase Analysis'];
+    for (const key of SECTIONS) {
+        if (selected.has(key)) {
+            const content = rendered.get(key);
+            if (content)
+                parts.push(content);
+        }
+    }
+    return parts.join('\n\n');
+}
+//# sourceMappingURL=format-analysis.js.map

package/dist/codebase-index/format-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-analysis.js","sourceRoot":"","sources":["../../src/codebase-index/format-analysis.ts"],"names":[],"mappings":"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"}

package/dist/codebase-index/index.d.ts

@@ -9,15 +9,19 @@
  *
  * Single source of truth — imported by both @promptwheel/cli and @promptwheel/mcp.
  */
-export { type CodebaseIndex, type ClassificationConfidence, type ModuleEntry, type LargeFileEntry, type ClassifyResult, SOURCE_EXTENSIONS, PURPOSE_HINT, NON_PRODUCTION_PURPOSES, CHUNK_SIZE, purposeHintFromDirName, sampleEvenly, countNonProdFiles, classifyModule, extractImports, resolveImportToModule, formatIndexForPrompt, } from './shared.js';
+export { type AstGrepModule } from './ast-analysis.js';
+export { mapExtensionToLang, analyzeFileAst } from './ast-analysis.js';
+export { type CodebaseIndex, type ClassificationConfidence, type ModuleEntry, type LargeFileEntry, type ClassifyResult, type GraphMetrics, type ExportEntry, type AstAnalysisResult, type DeadExportEntry, type StructuralIssue, type TypeScriptAnalysis, SOURCE_EXTENSIONS, PURPOSE_HINT, NON_PRODUCTION_PURPOSES, CHUNK_SIZE, purposeHintFromDirName, sampleEvenly, countNonProdFiles, classifyModule, extractImports, resolveImportToModule, formatIndexForPrompt, computeReverseEdges, detectCycles, computeGraphMetrics, } from './shared.js';
 import type { CodebaseIndex } from './shared.js';
+import type { AstGrepModule as AstGrepModuleType } from './ast-analysis.js';
+export { formatAnalysisForPrompt } from './format-analysis.js';
 /**
  * Use `git ls-files` to discover which top-level directories contain tracked
  * (or unignored) files. Returns null if git is unavailable or the project
  * is not a git repo — callers should fall back to hardcoded excludes.
  */
 export declare function getTrackedDirectories(projectRoot: string): Set<string> | null;
-export declare function buildCodebaseIndex(projectRoot: string, excludeDirs?: string[], useGitTracking?: boolean): CodebaseIndex;
-export declare function refreshCodebaseIndex(_existing: CodebaseIndex, projectRoot: string, excludeDirs?: string[], useGitTracking?: boolean): CodebaseIndex;
+export declare function buildCodebaseIndex(projectRoot: string, excludeDirs?: string[], useGitTracking?: boolean, astGrepModule?: AstGrepModuleType | null): CodebaseIndex;
+export declare function refreshCodebaseIndex(_existing: CodebaseIndex, projectRoot: string, excludeDirs?: string[], useGitTracking?: boolean, astGrepModule?: AstGrepModuleType | null): CodebaseIndex;
 export declare function hasStructuralChanges(index: CodebaseIndex, projectRoot: string): boolean;
 //# sourceMappingURL=index.d.ts.map

package/dist/codebase-index/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codebase-index/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,iBAAiB,EACjB,YAAY,EACZ,uBAAuB,EACvB,UAAU,EACV,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,aAAa,EAA+B,MAAM,aAAa,CAAC;AAyC9E;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAe7E;AAMD,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAAM,EAAO,EAC1B,cAAc,UAAO,GACpB,aAAa,CAkPf;AAMD,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,aAAa,EACxB,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAAM,EAAO,EAC1B,cAAc,UAAO,GACpB,aAAa,CAEf;AAMD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,MAAM,GAClB,OAAO,CAuCT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codebase-index/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGvE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,iBAAiB,EACjB,YAAY,EACZ,uBAAuB,EACvB,UAAU,EACV,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,aAAa,EAA4C,MAAM,aAAa,CAAC;AAW3F,OAAO,KAAK,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAM5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAkC/D;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAe7E;AAMD,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAAM,EAAO,EAC1B,cAAc,UAAO,EACrB,aAAa,CAAC,EAAE,iBAAiB,GAAG,IAAI,GACvC,aAAa,CA6Vf;AAMD,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,aAAa,EACxB,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAAM,EAAO,EAC1B,cAAc,UAAO,EACrB,aAAa,CAAC,EAAE,iBAAiB,GAAG,IAAI,GACvC,aAAa,CAEf;AAMD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,MAAM,GAClB,OAAO,CAuCT"}

package/dist/codebase-index/index.js

@@ -12,9 +12,15 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { execFileSync } from 'node:child_process';
+export { mapExtensionToLang, analyzeFileAst } from './ast-analysis.js';
 // Re-export everything from shared (pure algorithms + types + constants)
-export { SOURCE_EXTENSIONS, PURPOSE_HINT, NON_PRODUCTION_PURPOSES, CHUNK_SIZE, purposeHintFromDirName, sampleEvenly, countNonProdFiles, classifyModule, extractImports, resolveImportToModule, formatIndexForPrompt, } from './shared.js';
-import { SOURCE_EXTENSIONS, sampleEvenly, classifyModule, extractImports, resolveImportToModule, } from './shared.js';
+export { SOURCE_EXTENSIONS, PURPOSE_HINT, NON_PRODUCTION_PURPOSES, CHUNK_SIZE, purposeHintFromDirName, sampleEvenly, countNonProdFiles, classifyModule, extractImports, resolveImportToModule, formatIndexForPrompt, computeReverseEdges, detectCycles, computeGraphMetrics, } from './shared.js';
+import { SOURCE_EXTENSIONS, sampleEvenly, classifyModule, extractImports, resolveImportToModule, computeReverseEdges, detectCycles, computeGraphMetrics, } from './shared.js';
+import { analyzeFileAst, mapExtensionToLang } from './ast-analysis.js';
+import { loadAstCache, saveAstCache, isEntryCurrent } from './ast-cache.js';
+import { detectDeadExports, detectStructuralIssues } from './dead-code.js';
+// Re-export format-analysis
+export { formatAnalysisForPrompt } from './format-analysis.js';
 // ---------------------------------------------------------------------------
 // I/O helpers
 // ---------------------------------------------------------------------------
@@ -72,7 +78,7 @@ export function getTrackedDirectories(projectRoot) {
 // ---------------------------------------------------------------------------
 // buildCodebaseIndex
 // ---------------------------------------------------------------------------
-export function buildCodebaseIndex(projectRoot, excludeDirs = [], useGitTracking = true) {
+export function buildCodebaseIndex(projectRoot, excludeDirs = [], useGitTracking = true, astGrepModule) {
     const excludeSet = new Set(excludeDirs.map(d => d.toLowerCase()));
     // Git-aware filtering: only walk directories that contain tracked files
     const trackedDirs = useGitTracking ? getTrackedDirectories(projectRoot) : null;
@@ -198,6 +204,73 @@ export function buildCodebaseIndex(projectRoot, excludeDirs = [], useGitTracking
         mod.production_file_count = productionFileCount;
         mod.classification_confidence = confidence;
     }
+    // Step 2c: AST analysis — when ast-grep is available, extract exports and complexity
+    let analysisBackend = 'regex';
+    if (astGrepModule) {
+        analysisBackend = 'ast-grep';
+        const astCache = loadAstCache(projectRoot);
+        const updatedCache = { ...astCache };
+        const allCurrentFiles = new Set();
+        // Per-module: aggregate exports and complexity from individual files
+        for (const mod of modules) {
+            const files = sourceFilesByModule.get(mod.path) ?? [];
+            const moduleExports = [];
+            let totalComplexity = 0;
+            let filesAnalyzed = 0;
+            for (const filePath of files) {
+                const relFile = path.relative(projectRoot, filePath);
+                allCurrentFiles.add(relFile);
+                const ext = path.extname(filePath);
+                const langKey = mapExtensionToLang(ext);
+                if (!langKey)
+                    continue;
+                // Check cache first
+                let stat;
+                try {
+                    stat = fs.statSync(filePath);
+                }
+                catch {
+                    continue;
+                }
+                const cached = updatedCache[relFile];
+                if (isEntryCurrent(cached, stat.mtimeMs, stat.size)) {
+                    moduleExports.push(...cached.exports);
+                    totalComplexity += cached.complexity;
+                    filesAnalyzed++;
+                    continue;
+                }
+                // Read full file content for AST analysis
+                try {
+                    const content = fs.readFileSync(filePath, 'utf-8');
+                    const result = analyzeFileAst(content, filePath, langKey, astGrepModule);
+                    if (result) {
+                        moduleExports.push(...result.exports);
+                        totalComplexity += result.complexity;
+                        filesAnalyzed++;
+                        // Update cache
+                        updatedCache[relFile] = {
+                            mtime: stat.mtimeMs,
+                            size: stat.size,
+                            imports: result.imports,
+                            exports: result.exports,
+                            complexity: result.complexity,
+                        };
+                    }
+                }
+                catch {
+                    // File read error — skip this file for AST analysis
+                }
+            }
+            // Populate module-level AST metrics
+            if (filesAnalyzed > 0) {
+                mod.export_count = moduleExports.length;
+                mod.exported_names = moduleExports.slice(0, 20).map(e => e.name);
+                mod.avg_complexity = totalComplexity / filesAnalyzed;
+            }
+        }
+        // Save updated cache (pruning stale entries)
+        saveAstCache(projectRoot, updatedCache, allCurrentFiles);
+    }
     // Step 3: Test coverage — find untested modules
     const untestedModules = [];
     for (const mod of modules) {
@@ -284,21 +357,57 @@ export function buildCodebaseIndex(projectRoot, excludeDirs = [], useGitTracking
             }
         }
     }
+    // Step 6: Graph analysis — reverse edges, cycle detection, topology metrics
+    const reverseEdges = computeReverseEdges(dependencyEdges);
+    const dependencyCycles = detectCycles(dependencyEdges);
+    const graphMetrics = computeGraphMetrics(modules, dependencyEdges, reverseEdges);
+    // Populate per-module fan_in / fan_out
+    for (const mod of modules) {
+        mod.fan_in = (reverseEdges[mod.path] ?? []).length;
+        mod.fan_out = (dependencyEdges[mod.path] ?? []).length;
+    }
+    // Step 7: Dead code + structural analysis
+    // Dead exports require AST data (exportsByModule). Structural issues use graph metrics.
+    let deadExports;
+    if (analysisBackend === 'ast-grep') {
+        // Build per-module export/import maps from AST cache
+        const exportsByModule = {};
+        const importsByModule = {};
+        for (const mod of modules) {
+            if (mod.exported_names && mod.exported_names.length > 0) {
+                // Reconstruct ExportEntry from module data (kind is lost, use 'other')
+                exportsByModule[mod.path] = mod.exported_names.map(name => ({ name, kind: 'other' }));
+            }
+            // Use dependency edges as import proxy
+            const deps = dependencyEdges[mod.path];
+            if (deps)
+                importsByModule[mod.path] = deps;
+        }
+        deadExports = detectDeadExports(modules, dependencyEdges, exportsByModule, importsByModule);
+    }
+    // Structural issues only need graph data (no AST required)
+    const structuralIssues = detectStructuralIssues(modules, dependencyEdges, reverseEdges, dependencyCycles, entrypoints);
     return {
         built_at: new Date().toISOString(),
         modules,
         dependency_edges: dependencyEdges,
+        reverse_edges: reverseEdges,
+        dependency_cycles: dependencyCycles,
+        graph_metrics: graphMetrics,
         untested_modules: untestedModules,
         large_files: largeFiles,
         entrypoints,
         sampled_file_mtimes: sampledFileMtimes,
+        analysis_backend: analysisBackend,
+        dead_exports: deadExports,
+        structural_issues: structuralIssues,
     };
 }
 // ---------------------------------------------------------------------------
 // refreshCodebaseIndex
 // ---------------------------------------------------------------------------
-export function refreshCodebaseIndex(_existing, projectRoot, excludeDirs = [], useGitTracking = true) {
-    return buildCodebaseIndex(projectRoot, excludeDirs, useGitTracking);
+export function refreshCodebaseIndex(_existing, projectRoot, excludeDirs = [], useGitTracking = true, astGrepModule) {
+    return buildCodebaseIndex(projectRoot, excludeDirs, useGitTracking, astGrepModule);
 }
 // ---------------------------------------------------------------------------
 // hasStructuralChanges