@eduardo-afonso/codebase-intelligence 0.1.0 → 2.0.0

package/dist/diff/GitChangeSetProvider.js

@@ -0,0 +1,297 @@
+import { execFile as execFileCb } from 'node:child_process';
+import { promisify } from 'node:util';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { GitCommandError, GitNotAvailableError, InvalidGitRefError, NotAGitRepositoryError, } from './errors.js';
+const execFile = promisify(execFileCb);
+// ---------------------------------------------------------------------------
+// GitChangeSetProvider
+// ---------------------------------------------------------------------------
+/**
+ * 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 class GitChangeSetProvider {
+    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) {
+        this.codebaseRoot = codebaseRoot;
+    }
+    async getChanges(options = {}) {
+        await this.ensureGitAvailable();
+        const gitRoot = await this.resolveGitRoot();
+        this.validateOptions(options);
+        if (options.since !== undefined)
+            await this.validateRef(options.since, gitRoot);
+        if (options.until !== undefined)
+            await this.validateRef(options.until, gitRoot);
+        let changes;
+        if (options.staged) {
+            changes = await this.getStagedChanges(gitRoot);
+        }
+        else if (options.uncommitted) {
+            changes = await this.getUncommittedChanges(gitRoot);
+        }
+        else if (options.since !== undefined) {
+            changes = await this.getChangesSince(gitRoot, options.since, options.until ?? 'HEAD');
+        }
+        else {
+            // Default: uncommitted (staged + working tree)
+            changes = await this.getUncommittedChanges(gitRoot);
+        }
+        // Normalise all paths to be relative to the codebase root and sort
+        return this.normaliseAndSort(changes, gitRoot);
+    }
+    // ---- Git modes ----------------------------------------------------------
+    /** Returns only staged (index) changes: `git diff --cached`. */
+    async getStagedChanges(gitRoot) {
+        const stdout = await this.runGit(['diff', '--name-status', '-M', '-z', '--cached'], gitRoot);
+        return this.parseDiffOutput(stdout);
+    }
+    /**
+     * Returns all uncommitted changes (staged + working tree) plus untracked
+     * files. This is the most useful default for local development.
+     */
+    async getUncommittedChanges(gitRoot) {
+        // Check whether HEAD exists (fresh repos before first commit have no HEAD)
+        const hasHead = await this.headExists(gitRoot);
+        let diffChanges = [];
+        if (hasHead) {
+            // staged + unstaged changes vs HEAD
+            const diffStdout = await this.runGit(['diff', '--name-status', '-M', '-z', 'HEAD'], gitRoot);
+            diffChanges = this.parseDiffOutput(diffStdout);
+        }
+        // untracked files (not ignored)
+        const untrackedStdout = await this.runGit(['ls-files', '--others', '--exclude-standard', '-z'], gitRoot);
+        const untrackedChanges = this.parseUntrackedOutput(untrackedStdout);
+        return [...diffChanges, ...untrackedChanges];
+    }
+    /**
+     * Returns changes introduced by the current branch relative to `since`.
+     * Uses three-dot merge-base semantics so only commits not in `since` are
+     * included.
+     */
+    async getChangesSince(gitRoot, since, until) {
+        // Verify merge-base is reachable (fails on shallow clones without full history)
+        try {
+            await this.runGit(['merge-base', '--is-ancestor', since, until], gitRoot);
+        }
+        catch {
+            // merge-base failure — check if this is a shallow clone
+            const isShallow = await this.isShallowRepository(gitRoot);
+            if (isShallow) {
+                throw new GitCommandError('git', ['merge-base', since, until], `Repository is a shallow clone. The merge-base between "${since}" and "${until}" cannot be determined.\n` +
+                    'In GitHub Actions, add `fetch-depth: 0` to the checkout step. ' +
+                    'Locally, run `git fetch --unshallow`.', 1);
+            }
+            // Not shallow — just proceed; three-dot diff handles this gracefully
+        }
+        const stdout = await this.runGit(['diff', '--name-status', '-M', '-z', `${since}...${until}`], gitRoot);
+        return this.parseDiffOutput(stdout);
+    }
+    // ---- Output parsers -----------------------------------------------------
+    /**
+     * 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`
+     */
+    parseDiffOutput(raw) {
+        if (!raw.trim())
+            return [];
+        const changes = [];
+        // Split on NUL; filter empty trailing entries
+        const tokens = raw.split('\0').filter((t, i, arr) => {
+            // The last token after a trailing NUL is always empty — drop it
+            return !(i === arr.length - 1 && t === '');
+        });
+        let i = 0;
+        while (i < tokens.length) {
+            const statusToken = tokens[i];
+            if (!statusToken) {
+                i++;
+                continue;
+            }
+            const statusCode = statusToken[0] ?? '';
+            i++;
+            if (statusCode === 'R' || statusCode === 'C') {
+                // rename / copy: next two tokens are old-path and new-path
+                const oldPath = tokens[i] ?? '';
+                const newPath = tokens[i + 1] ?? '';
+                i += 2;
+                changes.push({
+                    path: newPath,
+                    oldPath,
+                    status: statusCode === 'R' ? 'renamed' : 'copied',
+                });
+            }
+            else {
+                const filePath = tokens[i] ?? '';
+                i++;
+                const status = this.mapStatusCode(statusCode);
+                if (status !== null) {
+                    changes.push({ path: filePath, status });
+                }
+            }
+        }
+        return changes;
+    }
+    /** Parses NUL-delimited output of `git ls-files --others -z`. */
+    parseUntrackedOutput(raw) {
+        if (!raw.trim())
+            return [];
+        return raw
+            .split('\0')
+            .filter(p => p.length > 0)
+            .map(p => ({ path: p, status: 'added' }));
+    }
+    mapStatusCode(code) {
+        switch (code) {
+            case 'A': return 'added';
+            case 'M': return 'modified';
+            case 'D': return 'deleted';
+            case 'T': return 'typechange';
+            default: return null;
+        }
+    }
+    // ---- Path normalisation -------------------------------------------------
+    /**
+     * 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`.
+     */
+    normaliseAndSort(changes, gitRoot) {
+        // Resolve gitRoot and codebaseRoot to their real absolute paths
+        // This is crucial on Windows where git might return short paths (e.g. MIRANT~1)
+        let realGitRoot = path.resolve(gitRoot);
+        let realCbRoot = path.resolve(this.codebaseRoot);
+        try {
+            realGitRoot = fs.realpathSync.native(realGitRoot);
+        }
+        catch { /* ignore */ }
+        try {
+            realCbRoot = fs.realpathSync.native(realCbRoot);
+        }
+        catch { /* ignore */ }
+        const normalised = changes.map(change => {
+            // Resolve path using path.resolve (Windows-aware) relative to realGitRoot
+            const absolutePath = path.resolve(realGitRoot, change.path);
+            const relativeToCb = path.relative(realCbRoot, absolutePath).replace(/\\/g, '/');
+            const normalisedChange = { ...change, path: relativeToCb };
+            if (change.oldPath !== undefined) {
+                const absOld = path.resolve(realGitRoot, change.oldPath);
+                normalisedChange.oldPath = path.relative(realCbRoot, absOld).replace(/\\/g, '/');
+            }
+            return normalisedChange;
+        });
+        return normalised.sort((a, b) => a.path.localeCompare(b.path));
+    }
+    // ---- Validation ---------------------------------------------------------
+    validateOptions(options) {
+        const modes = [
+            options.since !== undefined,
+            options.staged === true,
+            options.uncommitted === true,
+        ].filter(Boolean).length;
+        if (modes > 1) {
+            throw new Error('GitChangeSetProvider: options `since`, `staged`, and `uncommitted` are mutually exclusive. ' +
+                'Provide at most one.');
+        }
+    }
+    /**
+     * 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.
+     */
+    async validateRef(ref, gitRoot) {
+        if (!ref || ref.startsWith('-')) {
+            throw new InvalidGitRefError(ref);
+        }
+        try {
+            await this.runGit(['rev-parse', '--verify', '--quiet', `${ref}^{commit}`], gitRoot);
+        }
+        catch {
+            throw new InvalidGitRefError(ref);
+        }
+    }
+    // ---- Git helpers --------------------------------------------------------
+    /** Resolves the root of the Git repository containing `codebaseRoot`. */
+    async resolveGitRoot() {
+        try {
+            const stdout = await this.runGit(['rev-parse', '--show-toplevel'], this.codebaseRoot);
+            return stdout.trim();
+        }
+        catch {
+            throw new NotAGitRepositoryError(this.codebaseRoot);
+        }
+    }
+    /** Returns `true` when the repository is a shallow clone. */
+    async isShallowRepository(gitRoot) {
+        try {
+            const stdout = await this.runGit(['rev-parse', '--is-shallow-repository'], gitRoot);
+            return stdout.trim() === 'true';
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Returns `true` if HEAD resolves to a commit (repo has at least one commit). */
+    async headExists(gitRoot) {
+        try {
+            await this.runGit(['rev-parse', '--verify', 'HEAD'], gitRoot);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Throws `GitNotAvailableError` if `git --version` fails. */
+    async ensureGitAvailable() {
+        try {
+            await execFile('git', ['--version']);
+        }
+        catch {
+            throw new GitNotAvailableError();
+        }
+    }
+    /**
+     * 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.
+     */
+    async runGit(args, cwd) {
+        try {
+            const { stdout } = await execFile('git', args, { cwd, maxBuffer: 50 * 1024 * 1024 });
+            return stdout;
+        }
+        catch (err) {
+            const e = err;
+            throw new GitCommandError('git', args, e.stderr ?? e.message ?? '', typeof e.code === 'number' ? e.code : 1);
+        }
+    }
+}
+//# sourceMappingURL=GitChangeSetProvider.js.map

package/dist/diff/GitChangeSetProvider.js.map

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

package/dist/diff/errors.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Diff Impact — Git-specific Errors
+ *
+ * These errors are specific to the Git layer and should not be caught by
+ * general application code unless the caller is explicitly handling Git
+ * failures.
+ *
+ * Library consumers who inject a custom `ChangeSetProvider` will never see
+ * these errors unless their provider chooses to re-use them.
+ */
+/**
+ * Thrown when `git` is not found in PATH or returns a non-zero exit code
+ * during the availability check.
+ */
+export declare class GitNotAvailableError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Thrown when the target directory (or any ancestor) is not a Git repository.
+ *
+ * Typically triggered when `git rev-parse --git-dir` fails.
+ */
+export declare class NotAGitRepositoryError extends Error {
+    readonly directory: string;
+    constructor(directory: string);
+}
+/**
+ * Thrown when a Git ref (branch, tag, commit SHA) provided by the caller
+ * cannot be resolved in the current repository.
+ */
+export declare class InvalidGitRefError extends Error {
+    readonly ref: string;
+    constructor(ref: string);
+}
+/**
+ * Thrown when a `git` sub-command exits with a non-zero status code.
+ *
+ * The `command` and `args` fields allow callers to log or display the
+ * exact invocation that failed.
+ */
+export declare class GitCommandError extends Error {
+    readonly command: string;
+    readonly args: string[];
+    readonly stderr: string;
+    readonly exitCode: number;
+    constructor(command: string, args: string[], stderr: string, exitCode: number);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/diff/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAO,SAAkC,EAGpD;CACF;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;aACnB,SAAS,EAAE,MAAM;IAA7C,YAA4B,SAAS,EAAE,MAAM,EAM5C;CACF;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aACf,GAAG,EAAE,MAAM;IAAvC,YAA4B,GAAG,EAAE,MAAM,EAOtC;CACF;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,OAAO,EAAE,MAAM;aACf,IAAI,EAAE,MAAM,EAAE;aACd,MAAM,EAAE,MAAM;aACd,QAAQ,EAAE,MAAM;IAJlC,YACkB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAOjC;CACF"}

package/dist/diff/errors.js

@@ -0,0 +1,70 @@
+/**
+ * Diff Impact — Git-specific Errors
+ *
+ * These errors are specific to the Git layer and should not be caught by
+ * general application code unless the caller is explicitly handling Git
+ * failures.
+ *
+ * Library consumers who inject a custom `ChangeSetProvider` will never see
+ * these errors unless their provider chooses to re-use them.
+ */
+/**
+ * Thrown when `git` is not found in PATH or returns a non-zero exit code
+ * during the availability check.
+ */
+export class GitNotAvailableError extends Error {
+    constructor(message = 'git is not available in PATH.') {
+        super(message);
+        this.name = 'GitNotAvailableError';
+    }
+}
+/**
+ * Thrown when the target directory (or any ancestor) is not a Git repository.
+ *
+ * Typically triggered when `git rev-parse --git-dir` fails.
+ */
+export class NotAGitRepositoryError extends Error {
+    directory;
+    constructor(directory) {
+        super(`"${directory}" is not inside a Git repository. ` +
+            'Run `git init` or specify a path that is part of a repository.');
+        this.directory = directory;
+        this.name = 'NotAGitRepositoryError';
+    }
+}
+/**
+ * Thrown when a Git ref (branch, tag, commit SHA) provided by the caller
+ * cannot be resolved in the current repository.
+ */
+export class InvalidGitRefError extends Error {
+    ref;
+    constructor(ref) {
+        super(`Git ref "${ref}" could not be resolved. ` +
+            'Make sure the ref exists and that the repository has been fetched. ' +
+            'In CI environments, use `fetch-depth: 0` to include all history.');
+        this.ref = ref;
+        this.name = 'InvalidGitRefError';
+    }
+}
+/**
+ * Thrown when a `git` sub-command exits with a non-zero status code.
+ *
+ * The `command` and `args` fields allow callers to log or display the
+ * exact invocation that failed.
+ */
+export class GitCommandError extends Error {
+    command;
+    args;
+    stderr;
+    exitCode;
+    constructor(command, args, stderr, exitCode) {
+        super(`git ${args.join(' ')} failed with exit code ${exitCode}.\n` +
+            (stderr ? `stderr: ${stderr}` : ''));
+        this.command = command;
+        this.args = args;
+        this.stderr = stderr;
+        this.exitCode = exitCode;
+        this.name = 'GitCommandError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/diff/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/diff/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAO,GAAG,+BAA+B;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACnB,SAAS;IAArC,YAA4B,SAAiB;QAC3C,KAAK,CACH,IAAI,SAAS,oCAAoC;YAC/C,gEAAgE,CACnE,CAAC;yBAJwB,SAAS;QAKnC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACf,GAAG;IAA/B,YAA4B,GAAW;QACrC,KAAK,CACH,YAAY,GAAG,2BAA2B;YACxC,qEAAqE;YACrE,kEAAkE,CACrE,CAAC;mBALwB,GAAG;QAM7B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAEtB,OAAO;IACP,IAAI;IACJ,MAAM;IACN,QAAQ;IAJ1B,YACkB,OAAe,EACf,IAAc,EACd,MAAc,EACd,QAAgB;QAEhC,KAAK,CACH,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,0BAA0B,QAAQ,KAAK;YAC1D,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACtC,CAAC;uBARc,OAAO;oBACP,IAAI;sBACJ,MAAM;wBACN,QAAQ;QAMxB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/diff/types.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Diff Impact — Core Types
+ *
+ * Defines all public-facing types for the git-diff-based impact analysis
+ * feature. No business logic lives here.
+ */
+/**
+ * Git status codes mapped to a human-readable union.
+ * Mirrors the single-letter codes from `git diff --name-status`.
+ */
+export type ChangeStatus = 'added' | 'modified' | 'deleted' | 'renamed' | 'copied' | 'typechange';
+/**
+ * A single file change as reported by a `ChangeSetProvider`.
+ */
+export interface FileChange {
+    /** Current path, relative to the codebase root. */
+    path: string;
+    /**
+     * Original path before a rename or copy.
+     * Only present when `status` is `'renamed'` or `'copied'`.
+     */
+    oldPath?: string;
+    status: ChangeStatus;
+}
+/**
+ * Options controlling how a `ChangeSetProvider` collects file changes.
+ *
+ * **Mutual exclusivity**:
+ * - `since` may be combined with `until` but not with `staged` or `uncommitted`.
+ * - `staged` and `uncommitted` are mutually exclusive with each other.
+ *
+ * **Default (no options)**:
+ * Returns uncommitted changes (staged + working tree vs HEAD), which is the
+ * most useful default for a local development workflow.
+ */
+export interface ChangeSetOptions {
+    /**
+     * Base ref for a branch/PR comparison.
+     * The provider will use `git diff <since>...<until>` (three-dot, merge-base
+     * semantics) so only commits introduced by the branch are considered.
+     */
+    since?: string;
+    /**
+     * Head ref for the comparison.
+     * @default 'HEAD'
+     */
+    until?: string;
+    /**
+     * When `true`, return only staged (index) changes (`git diff --cached`).
+     */
+    staged?: boolean;
+    /**
+     * When `true`, return all uncommitted changes — staged and unstaged — plus
+     * untracked files. This is the equivalent of what a developer sees before
+     * committing.
+     */
+    uncommitted?: boolean;
+}
+/**
+ * Contract for any source of file changes.
+ *
+ * The core library ships `GitChangeSetProvider` as the default implementation.
+ * Alternative implementations (e.g. a GitHub PR API client, a Mercurial
+ * adapter, or a test stub) can be injected via `codebase.impactOfChanges()`.
+ */
+export interface ChangeSetProvider {
+    /**
+     * Returns the list of changed files according to the provider's source.
+     * The returned list is ordered by `path` (deterministic).
+     */
+    getChanges(options?: ChangeSetOptions): Promise<FileChange[]>;
+}
+/**
+ * Explains why a changed file could not be traced through the dependency graph.
+ *
+ * The analyser is honest: it never invents relationships it cannot prove.
+ * Files that cannot be analysed are reported explicitly here instead of being
+ * silently omitted.
+ */
+export type UnanalyzableReason = 
+/** The file path is outside the codebase root that was loaded. */
+'outside-codebase'
+/** The file extension has no registered parser (e.g. `.md`, `.css`). */
+ | 'unsupported-language'
+/**
+ * The file exists on disk but was not indexed (e.g. it was added after
+ * `codebase.analyze()` was called, or it is excluded by ignore rules).
+ */
+ | 'not-in-index'
+/**
+ * The file was deleted and the graph cannot prove which files depended on
+ * it (no recorded `unresolved` edges matching the old path).
+ */
+ | 'deleted-unprovable';
+/**
+ * The complete result of a change-set impact analysis.
+ *
+ * **Important — granularity**: the result operates at file granularity, not
+ * symbol granularity. A single line change in a file marks *all* dependents
+ * of that file as potentially affected. The result is therefore a
+ * **conservative upper bound**, not a minimal set.
+ */
+export interface ChangeSetImpact {
+    /** The raw list of file changes as provided by the `ChangeSetProvider`. */
+    changed: FileChange[];
+    /**
+     * Files that directly import/depend on at least one changed file.
+     * The changed files themselves are excluded from this list.
+     *
+     * If a file is both a direct dependent of one change and an indirect
+     * dependent of another, it is classified as **direct** (highest priority).
+     */
+    direct: string[];
+    /**
+     * All transitive dependents, minus the files already in `direct`.
+     * Ordered alphabetically.
+     */
+    indirect: string[];
+    /**
+     * Test files related to any changed or dependent file, discovered by
+     * naming convention (e.g. `AuthService.test.ts`). Union across all changes.
+     * Ordered alphabetically.
+     */
+    tests: string[];
+    /**
+     * Configuration and infrastructure files that are outside the import graph
+     * but whose modification can affect the entire codebase.
+     *
+     * Examples: `package.json`, `tsconfig.json`, `vite.config.*`, lockfiles.
+     * These are reported separately because the graph cannot model their impact.
+     */
+    globalChanges: string[];
+    /**
+     * Files that could not be fully traced through the dependency graph,
+     * along with the reason why.
+     */
+    unanalyzable: {
+        path: string;
+        reason: UnanalyzableReason;
+    }[];
+    /**
+     * Specifiers that appear as `unresolved` edges in the dependency graph
+     * (i.e. imports whose absolute path the parser could not determine).
+     * Reported for transparency; not treated as errors.
+     */
+    unresolvedDependencies: string[];
+    metadata: {
+        /**
+         * The analyser operates at file granularity.
+         * Every dependent of every changed file is considered potentially affected.
+         */
+        granularity: 'file';
+        /** The base ref used for the comparison, if any. */
+        base?: string;
+        /** The head ref used for the comparison, if any. */
+        head?: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/diff/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,UAAU,GACV,SAAS,GACT,SAAS,GACT,QAAQ,GACR,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACtB;AAMD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CAC/D;AAMD;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB;AAC5B,kEAAkE;AAChE,kBAAkB;AACpB,wEAAwE;GACtE,sBAAsB;AACxB;;;GAGG;GACD,cAAc;AAChB;;;GAGG;GACD,oBAAoB,CAAC;AAMzB;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,OAAO,EAAE,UAAU,EAAE,CAAC;IAEtB;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;;OAGG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;OAIG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB;;;;;;OAMG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB;;;OAGG;IACH,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,kBAAkB,CAAA;KAAE,EAAE,CAAC;IAE7D;;;;OAIG;IACH,sBAAsB,EAAE,MAAM,EAAE,CAAC;IAEjC,QAAQ,EAAE;QACR;;;WAGG;QACH,WAAW,EAAE,MAAM,CAAC;QACpB,oDAAoD;QACpD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,oDAAoD;QACpD,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH"}

package/dist/diff/types.js

@@ -0,0 +1,8 @@
+/**
+ * Diff Impact — Core Types
+ *
+ * Defines all public-facing types for the git-diff-based impact analysis
+ * feature. No business logic lives here.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/diff/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/diff/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/explorer/SnapshotBuilder.d.ts

@@ -0,0 +1,22 @@
+import type { Codebase } from '../core/Codebase.js';
+import type { ExplorerSnapshot } from './types.js';
+/**
+ * Builds an {@link ExplorerSnapshot} from an analysed {@link Codebase}.
+ *
+ * Rules:
+ * - The codebase MUST have been analysed (`analyze()` called) before calling
+ *   `build()`. If not, edges will be empty because the graph will be empty.
+ * - IDs are stable POSIX relative paths (e.g. `src/auth/AuthService.ts`).
+ * - External / unresolved graph nodes (not present in `codebase.files()`)
+ *   are silently skipped — we never invent nodes that the analysis cannot prove.
+ * - The resulting snapshot is fully JSON-serialisable with no circular refs.
+ */
+export declare class SnapshotBuilder {
+    /**
+     * @param codebase   The analysed codebase instance.
+     * @param rootPath   The absolute path that was passed to `Codebase.load()`.
+     *                   Used as `ExplorerSnapshot.rootPath`.
+     */
+    static build(codebase: Codebase, rootPath: string): ExplorerSnapshot;
+}
+//# sourceMappingURL=SnapshotBuilder.d.ts.map

package/dist/explorer/SnapshotBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapshotBuilder.d.ts","sourceRoot":"","sources":["../../src/explorer/SnapshotBuilder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EACV,gBAAgB,EAKjB,MAAM,YAAY,CAAC;AAsDpB;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAC1B;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CA6KnE;CACF"}