@eduardo-afonso/codebase-intelligence 0.1.0 → 2.0.0

package/dist/core/Codebase.js

@@ -11,6 +11,11 @@ import { CodeSearch } from '../search/CodeSearch.js';
 import { DependencyAnalyzer } from '../analysis/DependencyAnalyzer.js';
 import { ImpactAnalyzer } from '../analysis/ImpactAnalyzer.js';
 import { AnalysisCache } from './AnalysisCache.js';
+import { ContextEngine } from '../context/ContextEngine.js';
+import { SemanticChunker } from '../context/SemanticChunker.js';
+import { CodebaseWithAI } from '../ai/CodebaseWithAI.js';
+import { GitChangeSetProvider } from '../diff/GitChangeSetProvider.js';
+import { ChangeSetImpactAnalyzer } from '../diff/ChangeSetImpactAnalyzer.js';
 export class Codebase {
     _files = [];
     _projectInfo = null;
@@ -107,9 +112,108 @@ export class Codebase {
     impact(file) {
         return new ImpactAnalyzer(this._graph).impact(file);
     }
+    /**
+     * Analyzes the impact of a specific list of files without querying a VCS.
+     * Treats all given files as 'modified'.
+     *
+     * @throws if called before `analyze()`.
+     */
+    impactOfFiles(paths) {
+        if (!this._analyzed) {
+            throw new Error('Codebase.impactOfFiles() requires the codebase to be analysed first. ' +
+                'Call await codebase.analyze() before calling impactOfFiles().');
+        }
+        const changes = paths.map(p => ({
+            path: p,
+            status: 'modified',
+        }));
+        const analyzer = new ChangeSetImpactAnalyzer(this._graph, this._fileIndex, this.cwd);
+        return {
+            changed: changes,
+            ...analyzer.analyze(changes),
+            metadata: { granularity: 'file' },
+        };
+    }
+    /**
+     * Analyzes the impact of a set of changes obtained from a `ChangeSetProvider`.
+     * Defaults to querying the local Git repository for changes.
+     *
+     * @throws if called before `analyze()`.
+     */
+    async impactOfChanges(options, provider) {
+        if (!this._analyzed) {
+            throw new Error('Codebase.impactOfChanges() requires the codebase to be analysed first. ' +
+                'Call await codebase.analyze() before calling impactOfChanges().');
+        }
+        const actualProvider = provider ?? new GitChangeSetProvider(this.cwd);
+        const changes = await actualProvider.getChanges(options);
+        const metadata = {
+            granularity: 'file'
+        };
+        if (options?.since !== undefined)
+            metadata.base = options.since;
+        if (options?.until !== undefined)
+            metadata.head = options.until;
+        const analyzer = new ChangeSetImpactAnalyzer(this._graph, this._fileIndex, this.cwd);
+        return {
+            changed: changes,
+            ...analyzer.analyze(changes),
+            metadata,
+        };
+    }
     isAnalyzed() {
         return this._analyzed;
     }
+    /**
+     * Returns a `ContextEngine` pre-configured with this codebase's graph,
+     * symbol index, and file index.
+     *
+     * Use the returned engine to build LLM-ready context payloads:
+     * ```ts
+     * const payload = await codebase.context().forFile('src/auth/AuthService.ts');
+     * ```
+     *
+     * @throws if called before `analyze()`.
+     */
+    context() {
+        if (!this._analyzed) {
+            throw new Error('Codebase.context() requires the codebase to be analysed first. ' +
+                'Call await codebase.analyze() before calling context().');
+        }
+        return new ContextEngine(this._graph, this._symbolIndex, this._fileIndex, this.cwd);
+    }
+    /**
+     * Returns a `CodebaseWithAI` instance that pairs this codebase with the
+     * given AI provider, exposing the `explain` and `ask` high-level APIs.
+     *
+     * ```ts
+     * const answer = await codebase
+     *   .withAI(new OpenAIProvider())
+     *   .ask('Como funciona a autenticação?');
+     * ```
+     *
+     * @throws if called before `analyze()`.
+     */
+    withAI(provider) {
+        if (!this._analyzed) {
+            throw new Error('Codebase.withAI() requires the codebase to be analysed first. ' +
+                'Call await codebase.analyze() before calling withAI().');
+        }
+        return new CodebaseWithAI(this, provider);
+    }
+    /**
+     * Dividir ficheiros em chunks semânticos (baseados em AST, não em caracteres).
+     *
+     * @throws se chamado antes de `analyze()`.
+     */
+    async chunks(options) {
+        if (!this._analyzed) {
+            throw new Error('Codebase.chunks() requires the codebase to be analysed first. ' +
+                'Call await codebase.analyze() before calling chunks().');
+        }
+        const chunker = new SemanticChunker();
+        return chunker.chunk(this._files, options);
+    }
     /**
      * Deletes the on-disk cache for this codebase.
      * Subsequent calls to analyze() will re-parse all files.

package/dist/core/Codebase.js.map

@@ -1 +1 @@
-{"version":3,"file":"Codebase.js","sourceRoot":"","sources":["../../src/core/Codebase.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Codebase.js","sourceRoot":"","sources":["../../src/core/Codebase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAS7E,MAAM,OAAO,QAAQ;IACX,MAAM,GAAmB,EAAE,CAAC;IAC5B,YAAY,GAAuB,IAAI,CAAC;IACxC,UAAU,GAAG,IAAI,SAAS,EAAE,CAAC;IAC7B,YAAY,GAAG,IAAI,WAAW,EAAE,CAAC;IACjC,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IAC/B,SAAS,GAAG,KAAK,CAAC;IAClB,MAAM,GAAyB,IAAI,CAAC;IAE3B,GAAG,CAAS;IACZ,OAAO,CAAkB;IAE1C,YAAoB,GAAW,EAAE,OAAwB;QACvD,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,wEAAwE;IAEjE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,OAAO,GAAoB,EAAE;QACjE,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAE5C,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM;YACnC,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE;YACrD,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,cAAc,CAAC,CAAC;QAChD,QAAQ,CAAC,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QAEvC,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpE,QAAQ,CAAC,YAAY,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC;QAEhD,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAE5C,8CAA8C;QAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC;QACzC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,wEAAwE;IAEjE,KAAK,CAAC,OAAO;QAClB,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;QACtC,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAC;QAE1C,MAAM,eAAe,GAAqB,EAAE,CAAC;QAE7C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjD,IAAI,CAAC,MAAM;gBAAE,SAAS;YAEtB,aAAa;YACb,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;YACnD,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACzC,eAAe,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;gBAC7C,SAAS;YACX,CAAC;YAED,sCAAsC;YACtC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC7C,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACzC,eAAe,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;gBAE7C,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE;oBAC1B,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,YAAY,EAAE,MAAM,CAAC,YAAY;iBAClC,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,uDAAuD;YACzD,CAAC;QACH,CAAC;QAED,6CAA6C;QAC7C,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAE1D,wCAAwC;QACxC,MAAM,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QAE3B,MAAM,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAE7C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,wEAAwE;IAEjE,KAAK;QACV,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;IAC/B,CAAC;IAEM,OAAO;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAEM,KAAK;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAEM,MAAM,CAAC,KAAa,EAAE,OAAO,GAAkB,EAAE;QACtD,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9D,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAEM,YAAY,CAAC,IAAY;QAC9B,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;IAEM,UAAU,CAAC,IAAY;QAC5B,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;IAEM,MAAM,CAAC,IAAY;QACxB,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAED;;;;;OAKG;IACI,aAAa,CAAC,KAAe;QAClC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,uEAAuE;gBACrE,+DAA+D,CAClE,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAiB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC5C,IAAI,EAAE,CAAC;YACP,MAAM,EAAE,UAAU;SACnB,CAAC,CAAC,CAAC;QAEJ,MAAM,QAAQ,GAAG,IAAI,uBAAuB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACrF,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC;YAC5B,QAAQ,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE;SAClC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,eAAe,CAC1B,OAA0B,EAC1B,QAA4B;QAE5B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,yEAAyE;gBACvE,iEAAiE,CACpE,CAAC;QACJ,CAAC;QAED,MAAM,cAAc,GAAG,QAAQ,IAAI,IAAI,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAEzD,MAAM,QAAQ,GAA0D;YACtE,WAAW,EAAE,MAAM;SACpB,CAAC;QACF,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS;YAAE,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;QAChE,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS;YAAE,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;QAEhE,MAAM,QAAQ,GAAG,IAAI,uBAAuB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACrF,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC;YAC5B,QAAQ;SACT,CAAC;IACJ,CAAC;IAEM,UAAU;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;;;;;;;;OAUG;IACI,OAAO;QACZ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,iEAAiE;gBAC/D,yDAAyD,CAC5D,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,aAAa,CACtB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,GAAG,CACT,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACI,MAAM,CAAC,QAAoB;QAChC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,gEAAgE;gBAC9D,wDAAwD,CAC3D,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,MAAM,CAAC,OAAwB;QAC1C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,gEAAgE;gBAC9D,wDAAwD,CAC3D,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;QACtC,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACI,eAAe;QACpB,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;CACF"}

package/dist/diff/ChangeSetImpactAnalyzer.d.ts

@@ -0,0 +1,19 @@
+import type { DependencyGraph } from '../graph/DependencyGraph.js';
+import type { FileIndex } from '../index/FileIndex.js';
+import type { ChangeSetImpact, FileChange } from './types.js';
+export declare class ChangeSetImpactAnalyzer {
+    private readonly graph;
+    private readonly fileIndex;
+    private readonly codebaseRoot;
+    private readonly impactAnalyzer;
+    private readonly globalPatterns;
+    private readonly supportedExtensions;
+    constructor(graph: DependencyGraph, fileIndex: FileIndex, codebaseRoot: string);
+    /**
+     * Analyzes a list of file changes and correlates them with the dependency
+     * graph to produce a consolidated impact result.
+     */
+    analyze(changes: FileChange[]): Omit<ChangeSetImpact, 'metadata' | 'changed'>;
+    private toRel;
+}
+//# sourceMappingURL=ChangeSetImpactAnalyzer.d.ts.map

package/dist/diff/ChangeSetImpactAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChangeSetImpactAnalyzer.d.ts","sourceRoot":"","sources":["../../src/diff/ChangeSetImpactAnalyzer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EAEX,MAAM,YAAY,CAAC;AAEpB,qBAAa,uBAAuB;IA0BhC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IA3B/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAGhD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAQ7B;IAGF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAQjC;IAEH,YACmB,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,MAAM,EAGtC;IAED;;;OAGG;IACI,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,SAAS,CAAC,CAqFnF;IAED,OAAO,CAAC,KAAK;CAGd"}

package/dist/diff/ChangeSetImpactAnalyzer.js

@@ -0,0 +1,121 @@
+import * as path from 'node:path';
+import { ImpactAnalyzer } from '../analysis/ImpactAnalyzer.js';
+export class ChangeSetImpactAnalyzer {
+    graph;
+    fileIndex;
+    codebaseRoot;
+    impactAnalyzer;
+    // Configuration and infrastructure files that can affect the whole codebase
+    globalPatterns = [
+        /^package\.json$/,
+        /^tsconfig.*\.json$/,
+        /^vite\.config\..*$/,
+        /^nest-cli\.json$/,
+        /^next\.config\..*$/,
+        /.*lock.*/,
+        /^\.env.*/,
+    ];
+    // Language extensions supported by the parsers
+    supportedExtensions = new Set([
+        '.ts',
+        '.tsx',
+        '.js',
+        '.jsx',
+        '.mjs',
+        '.cjs',
+        '.json',
+    ]);
+    constructor(graph, fileIndex, codebaseRoot) {
+        this.graph = graph;
+        this.fileIndex = fileIndex;
+        this.codebaseRoot = codebaseRoot;
+        this.impactAnalyzer = new ImpactAnalyzer(this.graph);
+    }
+    /**
+     * Analyzes a list of file changes and correlates them with the dependency
+     * graph to produce a consolidated impact result.
+     */
+    analyze(changes) {
+        const directSet = new Set();
+        const indirectSet = new Set();
+        const testsSet = new Set();
+        const globalChanges = new Set();
+        const unanalyzable = [];
+        const unresolvedDependencies = new Set();
+        const changedPaths = new Set(changes.map(c => c.path));
+        for (const change of changes) {
+            // 1. Outside codebase?
+            if (change.path.startsWith('../') || change.path.startsWith('..\\')) {
+                unanalyzable.push({ path: change.path, reason: 'outside-codebase' });
+                continue;
+            }
+            // 2. Global change?
+            const basename = path.basename(change.path);
+            if (this.globalPatterns.some(p => p.test(basename))) {
+                globalChanges.add(change.path);
+            }
+            const absPath = path.resolve(this.codebaseRoot, change.path).replace(/\\/g, '/');
+            const inIndex = this.fileIndex.getByPath(absPath) !== undefined;
+            const isSupported = this.supportedExtensions.has(path.extname(change.path));
+            // 3. Deleted file
+            if (change.status === 'deleted') {
+                // If it's deleted and not in the index, we can't prove who depended on it
+                // unless there are explicit unresolved edges (not currently modeled backwards well)
+                if (!inIndex) {
+                    unanalyzable.push({ path: change.path, reason: 'deleted-unprovable' });
+                    continue;
+                }
+            }
+            // 4. Added / Modified / Renamed file not in index
+            if (!inIndex && change.status !== 'deleted') {
+                if (!isSupported) {
+                    unanalyzable.push({ path: change.path, reason: 'unsupported-language' });
+                }
+                else {
+                    unanalyzable.push({ path: change.path, reason: 'not-in-index' });
+                }
+                continue;
+            }
+            // 5. Impact analysis
+            const impact = this.impactAnalyzer.impact(absPath);
+            for (const d of impact.direct)
+                directSet.add(d);
+            for (const i of impact.indirect)
+                indirectSet.add(i);
+            for (const t of impact.tests)
+                testsSet.add(t);
+            // Collect unresolved dependencies originating from the changed file
+            if (this.graph.hasNode(absPath)) {
+                for (const depTarget of this.graph.dependenciesOf(absPath)) {
+                    const edge = this.graph.getEdge(absPath, depTarget);
+                    if (edge && edge.type === 'unresolved') {
+                        unresolvedDependencies.add(depTarget);
+                    }
+                }
+            }
+        }
+        // Process sets (priority: direct > indirect)
+        for (const d of directSet) {
+            if (changedPaths.has(this.toRel(d))) {
+                directSet.delete(d);
+            }
+        }
+        for (const i of indirectSet) {
+            if (directSet.has(i) || changedPaths.has(this.toRel(i))) {
+                indirectSet.delete(i);
+            }
+        }
+        return {
+            direct: Array.from(directSet).map(p => this.toRel(p)).sort(),
+            indirect: Array.from(indirectSet).map(p => this.toRel(p)).sort(),
+            tests: Array.from(testsSet).map(p => this.toRel(p)).sort(),
+            globalChanges: Array.from(globalChanges).sort(),
+            unanalyzable: unanalyzable.sort((a, b) => a.path.localeCompare(b.path)),
+            unresolvedDependencies: Array.from(unresolvedDependencies).sort(),
+        };
+    }
+    toRel(absPath) {
+        return path.relative(this.codebaseRoot, absPath).replace(/\\/g, '/');
+    }
+}
+//# sourceMappingURL=ChangeSetImpactAnalyzer.js.map

package/dist/diff/ChangeSetImpactAnalyzer.js.map

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

package/dist/diff/GitChangeSetProvider.d.ts

@@ -0,0 +1,86 @@
+import type { ChangeSetOptions, ChangeSetProvider, FileChange } from './types.js';
+/**
+ * A `ChangeSetProvider` implementation that reads file changes from a local
+ * Git repository using the `git` CLI.
+ *
+ * **Safety guarantees**:
+ * - All git calls use `execFile` with an args array (never `exec` with a
+ *   shell-interpolated string). This prevents shell injection.
+ * - Refs provided by callers are validated and rejected if they begin with
+ *   `-` or cannot be resolved in the repository.
+ * - Output is parsed using NUL (`\0`) as the field separator (`-z` flag),
+ *   which correctly handles file names containing spaces, tabs, or newlines.
+ *
+ * @example
+ * ```ts
+ * const provider = new GitChangeSetProvider('/path/to/codebase');
+ * const changes = await provider.getChanges({ since: 'main' });
+ * ```
+ */
+export declare class GitChangeSetProvider implements ChangeSetProvider {
+    private readonly codebaseRoot;
+    /**
+     * @param codebaseRoot - Absolute path to the codebase root as passed to
+     *   `Codebase.load()`. May differ from the Git repository root (e.g. when
+     *   the codebase is a sub-directory of a monorepo).
+     */
+    constructor(codebaseRoot: string);
+    getChanges(options?: ChangeSetOptions): Promise<FileChange[]>;
+    /** Returns only staged (index) changes: `git diff --cached`. */
+    private getStagedChanges;
+    /**
+     * Returns all uncommitted changes (staged + working tree) plus untracked
+     * files. This is the most useful default for local development.
+     */
+    private getUncommittedChanges;
+    /**
+     * Returns changes introduced by the current branch relative to `since`.
+     * Uses three-dot merge-base semantics so only commits not in `since` are
+     * included.
+     */
+    private getChangesSince;
+    /**
+     * Parses the NUL-delimited output of `git diff --name-status -M -z`.
+     *
+     * The `-z` flag makes git output fields separated by NUL bytes instead of
+     * newlines. For most statuses the format is:
+     *   `<status> NUL <path> NUL`
+     * For renames and copies it is:
+     *   `R<score> NUL <old-path> NUL <new-path> NUL`
+     */
+    private parseDiffOutput;
+    /** Parses NUL-delimited output of `git ls-files --others -z`. */
+    private parseUntrackedOutput;
+    private mapStatusCode;
+    /**
+     * Converts absolute-or-git-root-relative paths to codebase-root-relative
+     * paths. Paths that fall outside the codebase root are kept with their
+     * original path so the analyser can mark them as `outside-codebase`.
+     */
+    private normaliseAndSort;
+    private validateOptions;
+    /**
+     * Validates a git ref string.
+     * Rejects empty strings and strings beginning with `-` (which could be
+     * interpreted as flags by git).
+     * Uses `git rev-parse --verify --quiet <ref>^{commit}` to confirm the ref
+     * resolves to a commit object in the repository.
+     */
+    private validateRef;
+    /** Resolves the root of the Git repository containing `codebaseRoot`. */
+    private resolveGitRoot;
+    /** Returns `true` when the repository is a shallow clone. */
+    private isShallowRepository;
+    /** Returns `true` if HEAD resolves to a commit (repo has at least one commit). */
+    private headExists;
+    /** Throws `GitNotAvailableError` if `git --version` fails. */
+    private ensureGitAvailable;
+    /**
+     * Runs a git command in the given working directory.
+     * Always uses `execFile` with an args array — never `exec` with a string.
+     *
+     * @throws `GitCommandError` on non-zero exit.
+     */
+    private runGit;
+}
+//# sourceMappingURL=GitChangeSetProvider.d.ts.map

package/dist/diff/GitChangeSetProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitChangeSetProvider.d.ts","sourceRoot":"","sources":["../../src/diff/GitChangeSetProvider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAgB,UAAU,EAAE,MAAM,YAAY,CAAC;AAchG;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,oBAAqB,YAAW,iBAAiB;IAMhD,OAAO,CAAC,QAAQ,CAAC,YAAY;IALzC;;;;OAIG;IACH,YAA6B,YAAY,EAAE,MAAM,EAAI;IAExC,UAAU,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAwB7E;IAID,gEAAgE;YAClD,gBAAgB;IAQ9B;;;OAGG;YACW,qBAAqB;IAwBnC;;;;OAIG;YACW,eAAe;IAiC7B;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAyCvB,iEAAiE;IACjE,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,aAAa;IAYrB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAgCxB,OAAO,CAAC,eAAe;IAevB;;;;;;OAMG;YACW,WAAW;IAazB,yEAAyE;YAC3D,cAAc;IAY5B,6DAA6D;YAC/C,mBAAmB;IAYjC,kFAAkF;YACpE,UAAU;IASxB,8DAA8D;YAChD,kBAAkB;IAQhC;;;;;OAKG;YACW,MAAM;CAcrB"}