@eduardo-afonso/codebase-intelligence 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,243 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import * as path from 'path';
+import * as fs from 'fs';
+import { Codebase } from '../index.js';
+import { CACHE_DIR_NAME } from '../core/AnalysisCache.js';
+import { Watcher } from './Watcher.js';
+const program = new Command();
+program
+    .name('codebase-intelligence')
+    .description('CLI to analyze and understand codebases')
+    .version('0.1.0');
+// ---- Shared helpers --------------------------------------------------
+const printJson = (data) => {
+    console.log(JSON.stringify(data, null, 2));
+};
+const resolveTarget = (rawPath) => path.resolve(rawPath || '.');
+const findFile = (codebase, file) => codebase.files().find(f => f.path.endsWith(file) || f.relativePath === file);
+const loadAndAnalyze = async (targetPath) => {
+    const codebase = await Codebase.load(targetPath);
+    await codebase.analyze();
+    return codebase;
+};
+/** Register SIGINT handler that shuts down the watcher cleanly. */
+const handleCtrlC = (watcher) => {
+    const cleanup = () => {
+        watcher.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', cleanup);
+    process.on('SIGTERM', cleanup);
+};
+/**
+ * Start a watch loop: run `action` immediately, then re-run on any change.
+ * Prints a separator and timestamp before each re-run.
+ */
+const startWatch = async (targetPath, action) => {
+    // Initial run
+    let codebase = await loadAndAnalyze(targetPath);
+    await action(codebase, new Set());
+    console.error('\n[watch] Watching for changes… (Ctrl+C to stop)\n');
+    const watcher = new Watcher({
+        debounceMs: 300,
+        onChanged: async (changedFiles) => {
+            const ts = new Date().toLocaleTimeString();
+            console.error(`\n[watch ${ts}] ${changedFiles.size} file(s) changed — re-analysing…`);
+            try {
+                codebase = await loadAndAnalyze(targetPath);
+                await action(codebase, changedFiles);
+            }
+            catch (err) {
+                console.error('[watch] Error during re-analysis:', err.message);
+            }
+        }
+    });
+    handleCtrlC(watcher);
+    watcher.start(targetPath);
+};
+// ---- Commands --------------------------------------------------------
+program
+    .command('analyze')
+    .description('Analyze the codebase and output a summary')
+    .argument('[path]', 'Path to the codebase', '.')
+    .option('-w, --watch', 'Watch for changes and re-analyse automatically')
+    .action(async (rawPath, opts) => {
+    const targetPath = resolveTarget(rawPath);
+    const run = (codebase, changedFiles) => {
+        const result = {
+            project: codebase.projectInfo(),
+            filesCount: codebase.files().length,
+            symbolsCount: codebase.symbols().length
+        };
+        if (changedFiles.size > 0) {
+            result['reanalysed'] = Array.from(changedFiles);
+        }
+        printJson(result);
+    };
+    try {
+        if (opts.watch) {
+            await startWatch(targetPath, run);
+        }
+        else {
+            const codebase = await loadAndAnalyze(targetPath);
+            run(codebase, new Set());
+        }
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+program
+    .command('search')
+    .description('Search for a symbol or file')
+    .argument('<query>', 'The search query')
+    .argument('[path]', 'Path to the codebase', '.')
+    .option('-w, --watch', 'Watch for changes and re-run automatically')
+    .action(async (query, rawPath, opts) => {
+    const targetPath = resolveTarget(rawPath);
+    const run = (codebase) => {
+        printJson(codebase.search(query));
+    };
+    try {
+        if (opts.watch) {
+            await startWatch(targetPath, (c) => run(c));
+        }
+        else {
+            run(await loadAndAnalyze(targetPath));
+        }
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+program
+    .command('dependencies')
+    .description('List dependencies of a specific file')
+    .argument('<file>', 'File path (relative or suffix match)')
+    .argument('[path]', 'Path to the codebase', '.')
+    .option('-w, --watch', 'Watch for changes and re-run automatically')
+    .action(async (file, rawPath, opts) => {
+    const targetPath = resolveTarget(rawPath);
+    const run = (codebase) => {
+        const cf = findFile(codebase, file);
+        if (!cf) {
+            console.error(`Error: File "${file}" not found.`);
+            return;
+        }
+        printJson(codebase.dependencies(cf.path));
+    };
+    try {
+        if (opts.watch) {
+            await startWatch(targetPath, (c) => run(c));
+        }
+        else {
+            const codebase = await loadAndAnalyze(targetPath);
+            const cf = findFile(codebase, file);
+            if (!cf) {
+                console.error(`Error: File "${file}" not found.`);
+                process.exit(1);
+            }
+            printJson(codebase.dependencies(cf.path));
+        }
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+program
+    .command('dependents')
+    .description('List files that depend on a specific file')
+    .argument('<file>', 'File path')
+    .argument('[path]', 'Path to the codebase', '.')
+    .option('-w, --watch', 'Watch for changes and re-run automatically')
+    .action(async (file, rawPath, opts) => {
+    const targetPath = resolveTarget(rawPath);
+    const run = (codebase) => {
+        const cf = findFile(codebase, file);
+        if (!cf) {
+            console.error(`Error: File "${file}" not found.`);
+            return;
+        }
+        printJson(codebase.dependents(cf.path));
+    };
+    try {
+        if (opts.watch) {
+            await startWatch(targetPath, (c) => run(c));
+        }
+        else {
+            const codebase = await loadAndAnalyze(targetPath);
+            const cf = findFile(codebase, file);
+            if (!cf) {
+                console.error(`Error: File "${file}" not found.`);
+                process.exit(1);
+            }
+            printJson(codebase.dependents(cf.path));
+        }
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+program
+    .command('impact')
+    .description('Analyze the impact of changing a file')
+    .argument('<file>', 'File path')
+    .argument('[path]', 'Path to the codebase', '.')
+    .option('-w, --watch', 'Watch for changes and re-run automatically')
+    .action(async (file, rawPath, opts) => {
+    const targetPath = resolveTarget(rawPath);
+    const run = (codebase) => {
+        const cf = findFile(codebase, file);
+        if (!cf) {
+            console.error(`Error: File "${file}" not found.`);
+            return;
+        }
+        printJson(codebase.impact(cf.path));
+    };
+    try {
+        if (opts.watch) {
+            await startWatch(targetPath, (c) => run(c));
+        }
+        else {
+            const codebase = await loadAndAnalyze(targetPath);
+            const cf = findFile(codebase, file);
+            if (!cf) {
+                console.error(`Error: File "${file}" not found.`);
+                process.exit(1);
+            }
+            printJson(codebase.impact(cf.path));
+        }
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+program
+    .command('clear-cache')
+    .description('Clear the analysis cache for the given codebase directory')
+    .argument('[path]', 'Path to the codebase', '.')
+    .action(async (targetPath) => {
+    try {
+        const resolvedPath = path.resolve(targetPath);
+        const cacheDir = path.join(resolvedPath, CACHE_DIR_NAME);
+        if (fs.existsSync(cacheDir)) {
+            fs.rmSync(cacheDir, { recursive: true, force: true });
+            console.log(`Cache cleared: ${cacheDir}`);
+        }
+        else {
+            console.log('No cache found — nothing to clear.');
+        }
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/core/AnalysisCache.d.ts

@@ -0,0 +1,43 @@
+import type { CodeSymbol, CodeDependency } from './types.js';
+export declare const CACHE_DIR_NAME = ".codebase-intelligence-cache";
+export interface CachedEntry {
+    /** sha256 of the file content at the time it was cached */
+    contentHash: string;
+    /** mtime in ms — fast fingerprint used before hashing */
+    mtimeMs: number;
+    /** size in bytes */
+    size: number;
+    /** When this cache entry was written (for racy git detection) */
+    cachedAtMs: number;
+    symbols: CodeSymbol[];
+    dependencies: CodeDependency[];
+}
+export declare class AnalysisCache {
+    private store;
+    private readonly cacheFile;
+    private dirty;
+    constructor(projectRoot: string);
+    /** Compute file fingerprint — mtime+size first (cheap), hash only if needed */
+    static fingerprint(filePath: string): {
+        mtimeMs: number;
+        size: number;
+    };
+    static contentHash(filePath: string): string;
+    /**
+     * Returns a cached entry if the file hasn't changed (verified by mtime+size
+     * first, then content hash on mismatch-unlikely path).
+     */
+    get(filePath: string): CachedEntry | null;
+    set(filePath: string, data: {
+        symbols: CodeSymbol[];
+        dependencies: CodeDependency[];
+    }): void;
+    /** Removes entries for files that are no longer part of the project */
+    prune(activeFiles: Set<string>): void;
+    /** Persist updated entries to disk. No-op if nothing changed. */
+    flush(): Promise<void>;
+    /** Remove all cached entries for this project and delete the cache file. */
+    invalidate(): void;
+    private load;
+}
+//# sourceMappingURL=AnalysisCache.d.ts.map

package/dist/core/AnalysisCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalysisCache.d.ts","sourceRoot":"","sources":["../../src/core/AnalysisCache.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE7D,eAAO,MAAM,cAAc,iCAAiC,CAAC;AAG7D,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,EAAE,cAAc,EAAE,CAAC;CAChC;AAUD,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,KAAK,CAAS;IAEtB,YAAY,WAAW,EAAE,MAAM,EAI9B;IAID,+EAA+E;IAC/E,OAAc,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAG7E;IAED,OAAc,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGlD;IAID;;;OAGG;IACI,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAgC/C;IAEM,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,UAAU,EAAE,CAAC;QAAC,YAAY,EAAE,cAAc,EAAE,CAAA;KAAE,GAAG,IAAI,CAWlG;IAED,uEAAuE;IAChE,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAO3C;IAED,iEAAiE;IACpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAMlC;IAED,4EAA4E;IACrE,UAAU,IAAI,IAAI,CAQxB;IAID,OAAO,CAAC,IAAI;CAYb"}

package/dist/core/AnalysisCache.js

@@ -0,0 +1,120 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as crypto from 'crypto';
+import { fileURLToPath } from 'url';
+export const CACHE_DIR_NAME = '.codebase-intelligence-cache';
+const CACHE_FILE_NAME = 'analysis.json';
+// Bump this when parser logic changes to invalidate old caches
+const CACHE_SCHEMA_VERSION = 'v2-parser';
+export class AnalysisCache {
+    store;
+    cacheFile;
+    dirty = false;
+    constructor(projectRoot) {
+        const cacheDir = path.join(projectRoot, CACHE_DIR_NAME);
+        this.cacheFile = path.join(cacheDir, CACHE_FILE_NAME);
+        this.store = this.load(cacheDir);
+    }
+    // ---- Static helpers --------------------------------------------------
+    /** Compute file fingerprint — mtime+size first (cheap), hash only if needed */
+    static fingerprint(filePath) {
+        const stat = fs.statSync(filePath);
+        return { mtimeMs: stat.mtimeMs, size: stat.size };
+    }
+    static contentHash(filePath) {
+        const content = fs.readFileSync(filePath);
+        return crypto.createHash('sha256').update(content).digest('hex');
+    }
+    // ---- Core API --------------------------------------------------------
+    /**
+     * Returns a cached entry if the file hasn't changed (verified by mtime+size
+     * first, then content hash on mismatch-unlikely path).
+     */
+    get(filePath) {
+        const entry = this.store.entries[filePath];
+        if (!entry)
+            return null;
+        let stat;
+        try {
+            stat = fs.statSync(filePath);
+        }
+        catch {
+            return null; // file deleted
+        }
+        // Fast path: mtime and size match → trust the cache
+        if (stat.mtimeMs === entry.mtimeMs && stat.size === entry.size) {
+            // Racy git mitigation: if the file was modified very close to when it was cached,
+            // the mtime resolution might hide a subsequent quick write. Force hash check.
+            const isRacy = Math.abs(stat.mtimeMs - entry.cachedAtMs) < 2000;
+            if (!isRacy) {
+                return entry;
+            }
+        }
+        // Slow path: mtime changed (e.g. save without content change) → verify hash
+        const currentHash = AnalysisCache.contentHash(filePath);
+        if (currentHash === entry.contentHash) {
+            // Update fingerprint so next hit is fast again
+            entry.mtimeMs = stat.mtimeMs;
+            entry.size = stat.size;
+            this.dirty = true;
+            return entry;
+        }
+        return null; // content changed — cache miss
+    }
+    set(filePath, data) {
+        const { mtimeMs, size } = AnalysisCache.fingerprint(filePath);
+        const contentHash = AnalysisCache.contentHash(filePath);
+        this.store.entries[filePath] = {
+            contentHash,
+            mtimeMs,
+            size,
+            cachedAtMs: Date.now(),
+            ...data
+        };
+        this.dirty = true;
+    }
+    /** Removes entries for files that are no longer part of the project */
+    prune(activeFiles) {
+        for (const filePath of Object.keys(this.store.entries)) {
+            if (!activeFiles.has(filePath)) {
+                delete this.store.entries[filePath];
+                this.dirty = true;
+            }
+        }
+    }
+    /** Persist updated entries to disk. No-op if nothing changed. */
+    async flush() {
+        if (!this.dirty)
+            return;
+        const cacheDir = path.dirname(this.cacheFile);
+        fs.mkdirSync(cacheDir, { recursive: true });
+        fs.writeFileSync(this.cacheFile, JSON.stringify(this.store, null, 2), 'utf8');
+        this.dirty = false;
+    }
+    /** Remove all cached entries for this project and delete the cache file. */
+    invalidate() {
+        this.store = { version: CACHE_SCHEMA_VERSION, entries: {} };
+        this.dirty = false;
+        try {
+            fs.rmSync(path.dirname(this.cacheFile), { recursive: true, force: true });
+        }
+        catch {
+            // ignore — might not exist yet
+        }
+    }
+    // ---- Private ---------------------------------------------------------
+    load(cacheDir) {
+        try {
+            const raw = fs.readFileSync(this.cacheFile, 'utf8');
+            const parsed = JSON.parse(raw);
+            if (parsed.version !== CACHE_SCHEMA_VERSION) {
+                return { version: CACHE_SCHEMA_VERSION, entries: {} };
+            }
+            return parsed;
+        }
+        catch {
+            return { version: CACHE_SCHEMA_VERSION, entries: {} };
+        }
+    }
+}
+//# sourceMappingURL=AnalysisCache.js.map

package/dist/core/AnalysisCache.js.map

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

package/dist/core/Codebase.d.ts

@@ -0,0 +1,39 @@
+import { DependencyGraph } from '../graph/DependencyGraph.js';
+import type { CodebaseFile, CodeSymbol } from './types.js';
+import type { ProjectInfo } from '../discovery/ProjectDetector.js';
+import type { SearchResult, SearchOptions } from '../search/CodeSearch.js';
+import type { ImpactResult } from '../analysis/ImpactAnalyzer.js';
+export interface CodebaseOptions {
+    ignore?: string[];
+    /** Enable on-disk caching of parse results. Defaults to true. */
+    cache?: boolean;
+}
+export declare class Codebase {
+    private _files;
+    private _projectInfo;
+    private _fileIndex;
+    private _symbolIndex;
+    private _graph;
+    private _analyzed;
+    private _cache;
+    private readonly cwd;
+    private readonly options;
+    private constructor();
+    static load(cwd: string, options?: CodebaseOptions): Promise<Codebase>;
+    analyze(): Promise<void>;
+    files(): CodebaseFile[];
+    symbols(): CodeSymbol[];
+    projectInfo(): ProjectInfo | null;
+    graph(): DependencyGraph;
+    search(query: string, options?: SearchOptions): SearchResult[];
+    dependencies(file: string): string[];
+    dependents(file: string): string[];
+    impact(file: string): ImpactResult;
+    isAnalyzed(): boolean;
+    /**
+     * Deletes the on-disk cache for this codebase.
+     * Subsequent calls to analyze() will re-parse all files.
+     */
+    invalidateCache(): void;
+}
+//# sourceMappingURL=Codebase.d.ts.map

package/dist/core/Codebase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Codebase.d.ts","sourceRoot":"","sources":["../../src/core/Codebase.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAkB,MAAM,YAAY,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAGlE,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAA8B;IAE5C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAE1C,OAAO,eAGN;IAID,OAAoB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqBtF;IAIY,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CA2CpC;IAIM,KAAK,IAAI,YAAY,EAAE,CAE7B;IAEM,OAAO,IAAI,UAAU,EAAE,CAE7B;IAEM,WAAW,IAAI,WAAW,GAAG,IAAI,CAEvC;IAEM,KAAK,IAAI,eAAe,CAE9B;IAEM,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY,EAAE,CAGxE;IAEM,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAE1C;IAEM,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAExC;IAEM,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAExC;IAEM,UAAU,IAAI,OAAO,CAE3B;IAED;;;OAGG;IACI,eAAe,IAAI,IAAI,CAG7B;CACF"}

package/dist/core/Codebase.js

@@ -0,0 +1,122 @@
+import * as path from 'path';
+import { FileScanner } from '../discovery/FileScanner.js';
+import { ProjectDetector } from '../discovery/ProjectDetector.js';
+import { TypeScriptParser } from '../parsers/typescript/TypeScriptParser.js';
+import { ParserRegistry } from '../parsers/ParserRegistry.js';
+import { FileIndex } from '../index/FileIndex.js';
+import { SymbolIndex } from '../index/SymbolIndex.js';
+import { DependencyGraph } from '../graph/DependencyGraph.js';
+import { GraphBuilder } from '../graph/GraphBuilder.js';
+import { CodeSearch } from '../search/CodeSearch.js';
+import { DependencyAnalyzer } from '../analysis/DependencyAnalyzer.js';
+import { ImpactAnalyzer } from '../analysis/ImpactAnalyzer.js';
+import { AnalysisCache } from './AnalysisCache.js';
+export class Codebase {
+    _files = [];
+    _projectInfo = null;
+    _fileIndex = new FileIndex();
+    _symbolIndex = new SymbolIndex();
+    _graph = new DependencyGraph();
+    _analyzed = false;
+    _cache = null;
+    cwd;
+    options;
+    constructor(cwd, options) {
+        this.cwd = path.resolve(cwd);
+        this.options = options;
+    }
+    // ---- Factory --------------------------------------------------------
+    static async load(cwd, options = {}) {
+        const instance = new Codebase(cwd, options);
+        const scannerOptions = options.ignore
+            ? { cwd: instance.cwd, extraIgnores: options.ignore }
+            : { cwd: instance.cwd };
+        const scanner = new FileScanner(scannerOptions);
+        instance._files = await scanner.scan();
+        const detector = new ProjectDetector(instance.cwd, instance._files);
+        instance._projectInfo = await detector.detect();
+        instance._fileIndex.addAll(instance._files);
+        // Initialise cache unless explicitly disabled
+        const useCache = options.cache !== false;
+        if (useCache) {
+            instance._cache = new AnalysisCache(instance.cwd);
+        }
+        return instance;
+    }
+    // ---- Analysis -------------------------------------------------------
+    async analyze() {
+        const registry = new ParserRegistry();
+        registry.register(new TypeScriptParser());
+        const allDependencies = [];
+        for (const file of this._files) {
+            const parser = registry.getParser(file.language);
+            if (!parser)
+                continue;
+            // Cache hit?
+            const cached = this._cache?.get(file.path) ?? null;
+            if (cached) {
+                this._symbolIndex.addAll(cached.symbols);
+                allDependencies.push(...cached.dependencies);
+                continue;
+            }
+            // Cache miss — parse and store result
+            try {
+                const parsed = await parser.parse(file.path);
+                this._symbolIndex.addAll(parsed.symbols);
+                allDependencies.push(...parsed.dependencies);
+                this._cache?.set(file.path, {
+                    symbols: parsed.symbols,
+                    dependencies: parsed.dependencies
+                });
+            }
+            catch {
+                // Skip files that fail to parse (e.g., invalid syntax)
+            }
+        }
+        // Prune deleted/renamed files from the cache
+        this._cache?.prune(new Set(this._files.map(f => f.path)));
+        // Persist updated cache entries to disk
+        await this._cache?.flush();
+        const builder = new GraphBuilder();
+        this._graph = builder.build(allDependencies);
+        this._analyzed = true;
+    }
+    // ---- Public API -----------------------------------------------------
+    files() {
+        return this._fileIndex.all();
+    }
+    symbols() {
+        return this._symbolIndex.findSymbols({});
+    }
+    projectInfo() {
+        return this._projectInfo;
+    }
+    graph() {
+        return this._graph;
+    }
+    search(query, options = {}) {
+        const searcher = new CodeSearch(this.files(), this.symbols());
+        return searcher.search(query, options);
+    }
+    dependencies(file) {
+        return new DependencyAnalyzer(this._graph).dependencies(file);
+    }
+    dependents(file) {
+        return new DependencyAnalyzer(this._graph).dependents(file);
+    }
+    impact(file) {
+        return new ImpactAnalyzer(this._graph).impact(file);
+    }
+    isAnalyzed() {
+        return this._analyzed;
+    }
+    /**
+     * Deletes the on-disk cache for this codebase.
+     * Subsequent calls to analyze() will re-parse all files.
+     */
+    invalidateCache() {
+        this._cache?.invalidate();
+        this._cache = null;
+    }
+}
+//# sourceMappingURL=Codebase.js.map

package/dist/core/Codebase.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,15 @@
+export declare class FileNotFoundError extends Error {
+    readonly filePath: string;
+    constructor(filePath: string);
+}
+export declare class ParseError extends Error {
+    readonly filePath: string;
+    readonly originalError: Error | unknown;
+    constructor(filePath: string, originalError: Error | unknown);
+}
+export declare class UnresolvedDependencyError extends Error {
+    readonly dependencyPath: string;
+    readonly sourceFile: string;
+    constructor(dependencyPath: string, sourceFile: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAkB,SAAQ,KAAK;aACd,QAAQ,EAAE,MAAM;IAA5C,YAA4B,QAAQ,EAAE,MAAM,EAG3C;CACF;AAED,qBAAa,UAAW,SAAQ,KAAK;aACP,QAAQ,EAAE,MAAM;aAAkB,aAAa,EAAE,KAAK,GAAG,OAAO;IAA5F,YAA4B,QAAQ,EAAE,MAAM,EAAkB,aAAa,EAAE,KAAK,GAAG,OAAO,EAG3F;CACF;AAED,qBAAa,yBAA0B,SAAQ,KAAK;aACtB,cAAc,EAAE,MAAM;aAAkB,UAAU,EAAE,MAAM;IAAtF,YAA4B,cAAc,EAAE,MAAM,EAAkB,UAAU,EAAE,MAAM,EAGrF;CACF"}

package/dist/core/errors.js

@@ -0,0 +1,29 @@
+export class FileNotFoundError extends Error {
+    filePath;
+    constructor(filePath) {
+        super(`File not found: ${filePath}`);
+        this.filePath = filePath;
+        this.name = 'FileNotFoundError';
+    }
+}
+export class ParseError extends Error {
+    filePath;
+    originalError;
+    constructor(filePath, originalError) {
+        super(`Failed to parse file: ${filePath}`);
+        this.filePath = filePath;
+        this.originalError = originalError;
+        this.name = 'ParseError';
+    }
+}
+export class UnresolvedDependencyError extends Error {
+    dependencyPath;
+    sourceFile;
+    constructor(dependencyPath, sourceFile) {
+        super(`Could not resolve dependency '${dependencyPath}' from file: ${sourceFile}`);
+        this.dependencyPath = dependencyPath;
+        this.sourceFile = sourceFile;
+        this.name = 'UnresolvedDependencyError';
+    }
+}
+//# sourceMappingURL=errors.js.map