@lzehrung/codegraph 2.1.0

package/dist/impact/providers/base.js

@@ -0,0 +1,239 @@
+import { spawn } from "node:child_process";
+import { Readable } from "node:stream";
+import { parseUnifiedDiff, parseUnifiedDiffStreaming } from "../parse.js";
+import { gitDiffArgs } from "../../util/git.js";
+import { errorMessage } from "../../util/errors.js";
+const LARGE_DIFF_LINE_WARNING_THRESHOLD = 50_000;
+const DEFAULT_GITHUB_DIFF_TIMEOUT_MS = 30_000;
+const DEFAULT_GITHUB_DIFF_MAX_BYTES = 10 * 1024 * 1024;
+const DEFAULT_GITHUB_DIFF_MAX_LINES = 100_000;
+const GITHUB_REPO_PATTERN = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
+export async function getDiff(opts) {
+    const provider = createProvider(opts.provider);
+    return await provider.getDiff(opts);
+}
+export function parseGitHubRepo(repo) {
+    if (!GITHUB_REPO_PATTERN.test(repo)) {
+        throw new Error(`Invalid GitHub repo "${repo}". Expected owner/name.`);
+    }
+    const [owner, repoName] = repo.split("/");
+    if (!owner || !repoName) {
+        throw new Error(`Invalid GitHub repo "${repo}". Expected owner/name.`);
+    }
+    return { owner, repo: repoName };
+}
+function createProvider(providerType) {
+    switch (providerType) {
+        case "git":
+            return new GitDiffProvider();
+        case "github":
+            return new GitHubDiffProvider();
+        case "raw":
+            return new RawDiffProvider();
+        default:
+            throw new Error(`Unknown diff provider: ${providerType}`);
+    }
+}
+function changedDiffLineCount(diff) {
+    let count = 0;
+    for (const file of diff.files) {
+        for (const hunk of file.hunks) {
+            for (const line of hunk.lines) {
+                if (line.startsWith("+") || line.startsWith("-"))
+                    count++;
+            }
+        }
+    }
+    return count;
+}
+// Forward declarations - will be implemented in separate files
+class GitDiffProvider {
+    async getDiff(opts) {
+        const cwd = opts.cwd || process.cwd();
+        const args = gitDiffArgs(opts.base, opts.head, ["--no-ext-diff", "--unified=0"]);
+        try {
+            const child = spawn("git", args, { cwd });
+            let stderr = "";
+            child.stderr.on("data", (data) => {
+                stderr += String(data);
+            });
+            const { promise: completion, resolve, reject } = Promise.withResolvers();
+            child.on("error", reject);
+            child.on("close", resolve);
+            const [diff, code] = await Promise.all([parseUnifiedDiffStreaming(child.stdout), completion]);
+            if (code !== 0) {
+                throw new Error(`Git diff failed with code ${code}: ${stderr}`);
+            }
+            const changedLines = changedDiffLineCount(diff);
+            if (changedLines > LARGE_DIFF_LINE_WARNING_THRESHOLD) {
+                diff.warning = `Large diff detected (${changedLines.toLocaleString()} lines). Impact analysis may be incomplete or slow.`;
+            }
+            return diff;
+        }
+        catch (error) {
+            throw new Error(`Git diff failed: ${errorMessage(error)}`);
+        }
+    }
+}
+class GitHubDiffProvider {
+    async getDiff(opts) {
+        const { owner, repo } = parseGitHubRepo(opts.repo);
+        const url = `https://api.github.com/repos/${owner}/${repo}/pulls/${opts.pr}`;
+        const timeoutMs = opts.timeoutMs ?? DEFAULT_GITHUB_DIFF_TIMEOUT_MS;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const res = await fetch(url, {
+                headers: {
+                    Accept: "application/vnd.github.v3.diff",
+                    ...(opts.token ? { Authorization: `Bearer ${opts.token}` } : {}),
+                    "User-Agent": "codegraph-impact",
+                },
+                signal: controller.signal,
+            });
+            if (!res.ok)
+                throw new Error(`GitHub PR diff failed: ${res.status} ${res.statusText}`);
+            return await parseGitHubDiffResponse(res, {
+                maxBytes: opts.maxBytes ?? DEFAULT_GITHUB_DIFF_MAX_BYTES,
+                maxLines: opts.maxLines ?? DEFAULT_GITHUB_DIFF_MAX_LINES,
+            });
+        }
+        catch (error) {
+            if (controller.signal.aborted) {
+                throw new Error(`GitHub PR diff timed out after ${timeoutMs}ms.`);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+async function parseGitHubDiffResponse(res, limits) {
+    if (!res.body) {
+        const diffText = await res.text();
+        const limited = limitDiffText(diffText, limits);
+        const diff = parseUnifiedDiff(limited.text);
+        if (limited.truncated)
+            diff.warning = githubDiffLimitWarning(limits);
+        return diff;
+    }
+    const limited = limitDiffReadable(Readable.fromWeb(res.body), limits);
+    const diff = await parseUnifiedDiffStreaming(Readable.from(limited.stream));
+    if (limited.truncated()) {
+        diff.warning = githubDiffLimitWarning(limits);
+    }
+    return diff;
+}
+function limitDiffText(diffText, limits) {
+    const buffer = Buffer.from(diffText, "utf8");
+    const end = byteEndForLimits(buffer, 0, limits);
+    if (end >= buffer.length)
+        return { text: diffText, truncated: false };
+    return { text: buffer.subarray(0, safeUtf8End(buffer, end)).toString("utf8"), truncated: true };
+}
+function limitDiffReadable(stream, limits) {
+    let truncated = false;
+    async function* generate() {
+        let bytesRead = 0;
+        let newlinesRead = 0;
+        for await (const chunk of stream) {
+            const buffer = bufferFromStreamChunk(chunk);
+            const end = byteEndForLimits(buffer, bytesRead, limits, newlinesRead);
+            if (end > 0) {
+                const next = buffer.subarray(0, safeUtf8End(buffer, end));
+                bytesRead += next.length;
+                newlinesRead += countNewlines(next);
+                yield next;
+            }
+            if (end < buffer.length) {
+                truncated = true;
+                break;
+            }
+        }
+    }
+    return {
+        stream: generate(),
+        truncated: () => truncated,
+    };
+}
+function bufferFromStreamChunk(chunk) {
+    if (Buffer.isBuffer(chunk))
+        return chunk;
+    if (chunk instanceof Uint8Array)
+        return Buffer.from(chunk);
+    return Buffer.from(String(chunk));
+}
+function byteEndForLimits(buffer, bytesRead, limits, newlinesRead = 0) {
+    const remainingBytes = Math.max(0, limits.maxBytes - bytesRead);
+    const byteLimitEnd = Math.min(buffer.length, remainingBytes);
+    const allowedNewlines = Math.max(0, limits.maxLines - 1);
+    const remainingNewlines = Math.max(0, allowedNewlines - newlinesRead);
+    const lineLimitEnd = byteEndBeforeForbiddenNewline(buffer, remainingNewlines);
+    if (lineLimitEnd === undefined)
+        return byteLimitEnd;
+    return Math.min(byteLimitEnd, lineLimitEnd);
+}
+function byteEndBeforeForbiddenNewline(buffer, remainingNewlines) {
+    let newlines = 0;
+    for (let index = 0; index < buffer.length; index++) {
+        if (buffer[index] === 10) {
+            if (newlines >= remainingNewlines)
+                return index;
+            newlines++;
+        }
+    }
+    return undefined;
+}
+function safeUtf8End(buffer, end) {
+    if (end >= buffer.length)
+        return buffer.length;
+    if (end <= 0)
+        return 0;
+    let characterStart = end;
+    while (characterStart > 0 && isUtf8ContinuationByte(buffer[characterStart])) {
+        characterStart--;
+    }
+    if (characterStart === end)
+        return end;
+    const leadByte = buffer[characterStart];
+    const expectedLength = utf8SequenceLength(leadByte);
+    if (expectedLength === undefined)
+        return characterStart;
+    if (characterStart + expectedLength <= end)
+        return end;
+    return characterStart;
+}
+function isUtf8ContinuationByte(byte) {
+    return byte !== undefined && (byte & 0xc0) === 0x80;
+}
+function utf8SequenceLength(byte) {
+    if (byte === undefined)
+        return undefined;
+    if ((byte & 0x80) === 0)
+        return 1;
+    if ((byte & 0xe0) === 0xc0)
+        return 2;
+    if ((byte & 0xf0) === 0xe0)
+        return 3;
+    if ((byte & 0xf8) === 0xf0)
+        return 4;
+    return undefined;
+}
+function countNewlines(buffer) {
+    let count = 0;
+    for (const byte of buffer) {
+        if (byte === 10)
+            count++;
+    }
+    return count;
+}
+function githubDiffLimitWarning(limits) {
+    return `GitHub PR diff exceeded ${limits.maxBytes.toLocaleString()} bytes or ${limits.maxLines.toLocaleString()} lines and was truncated. Impact analysis may be incomplete.`;
+}
+class RawDiffProvider {
+    async getDiff(opts) {
+        return Promise.resolve(parseUnifiedDiff(opts.diffText));
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/impact/providers/base.js.map

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

package/dist/impact/referenceCache.d.ts

@@ -0,0 +1,12 @@
+import type { FindReferencesResult, ProjectIndex, SymbolDef } from "../indexer/types.js";
+export type CachedReferenceOptions = {
+    maxReferences?: number;
+    context?: "line" | "block";
+    lines?: number;
+    blockMaxLines?: number;
+};
+export type ReferenceLookupCache = {
+    get(index: ProjectIndex, def: SymbolDef, options?: CachedReferenceOptions): Promise<FindReferencesResult>;
+};
+export declare function createReferenceLookupCache(): ReferenceLookupCache;
+//# sourceMappingURL=referenceCache.d.ts.map

package/dist/impact/referenceCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referenceCache.d.ts","sourceRoot":"","sources":["../../src/impact/referenceCache.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAa,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKpG,MAAM,MAAM,sBAAsB,GAAG;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAOF,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC3G,CAAC;AAEF,wBAAgB,0BAA0B,IAAI,oBAAoB,CAajE"}

package/dist/impact/referenceCache.js

@@ -0,0 +1,101 @@
+import { findReferences } from "../indexer/navigation.js";
+import { ensureParsedContext } from "../indexer/parse-context.js";
+import { extractEnclosingBlock, extractLineContext } from "../indexer/reference-context.js";
+import { DEFAULT_REF_CONTEXT_LINES } from "../indexer/shared.js";
+import { fileIdentityKey } from "../util/paths.js";
+export function createReferenceLookupCache() {
+    const cachesByIndex = new WeakMap();
+    return {
+        async get(index, def, options) {
+            const maxReferences = normalizeMaxReferences(options?.maxReferences);
+            const indexCache = getIndexReferenceCache(cachesByIndex, index);
+            const baseResult = await getBaseReferences(index, def, maxReferences, indexCache);
+            const bounded = cloneReferenceResult(baseResult, maxReferences);
+            if (bounded.status !== "ok" || options?.context === undefined)
+                return bounded;
+            await attachReferenceContext(index, bounded.references, options);
+            return bounded;
+        },
+    };
+}
+function getIndexReferenceCache(cachesByIndex, index) {
+    let cache = cachesByIndex.get(index);
+    if (!cache) {
+        cache = new Map();
+        cachesByIndex.set(index, cache);
+    }
+    return cache;
+}
+function getBaseReferences(index, def, maxReferences, cache) {
+    const key = referenceLookupKey(def);
+    const entries = cache.get(key) ?? [];
+    const reusable = entries.find((entry) => canReuseEntry(entry.maxReferences, maxReferences));
+    if (reusable)
+        return reusable.refs;
+    const refs = findReferences(index, { def }, maxReferences === undefined ? undefined : { maxReferences });
+    entries.push({ maxReferences, refs });
+    cache.set(key, entries);
+    return refs;
+}
+function canReuseEntry(existingLimit, requestedLimit) {
+    if (existingLimit === undefined)
+        return true;
+    if (requestedLimit === undefined)
+        return false;
+    return existingLimit >= requestedLimit;
+}
+function normalizeMaxReferences(maxReferences) {
+    if (maxReferences === undefined || maxReferences <= 0)
+        return undefined;
+    return maxReferences;
+}
+function cloneReferenceResult(result, maxReferences) {
+    if (result.status !== "ok")
+        return result;
+    const references = result.references.slice(0, maxReferences).map(cloneReference);
+    return {
+        status: "ok",
+        definition: result.definition,
+        references,
+        ...(result.provenance ? { provenance: result.provenance } : {}),
+    };
+}
+function cloneReference(reference) {
+    return {
+        file: reference.file,
+        range: reference.range,
+        ...(reference.context !== undefined ? { context: reference.context } : {}),
+        ...(reference.via !== undefined ? { via: reference.via } : {}),
+        ...(reference.provenance !== undefined ? { provenance: reference.provenance } : {}),
+    };
+}
+async function attachReferenceContext(index, references, options) {
+    const perFileCache = new Map();
+    for (const ref of references) {
+        const fileKey = fileIdentityKey(ref.file);
+        let cached = perFileCache.get(fileKey);
+        if (!cached) {
+            const parsedEntry = index.parsed?.get(fileKey);
+            const parsed = await ensureParsedContext(ref.file, parsedEntry);
+            cached = { source: parsed.source, tree: parsed.tree, sup: parsed.sup };
+            perFileCache.set(fileKey, cached);
+        }
+        if (options.context === "line") {
+            ref.context = extractLineContext(cached.source, ref.range.start.line, options.lines ?? DEFAULT_REF_CONTEXT_LINES);
+        }
+        else if (options.context === "block") {
+            ref.context = extractEnclosingBlock(cached.source, cached.tree, ref.range, options.blockMaxLines ?? 60, cached.sup);
+        }
+    }
+}
+function referenceLookupKey(def) {
+    return JSON.stringify({
+        file: def.file,
+        name: def.localName,
+        kind: def.kind,
+        line: def.range.start.line,
+        column: def.range.start.column,
+        index: def.range.start.index,
+    });
+}
+//# sourceMappingURL=referenceCache.js.map

package/dist/impact/referenceCache.js.map

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

package/dist/impact/report-suggestions.d.ts

@@ -0,0 +1,4 @@
+import { type ProjectIndex } from "../indexer/types.js";
+import type { ChangedSymbol, FileChange, ImpactOptions, ImpactSuggestion } from "./types.js";
+export declare function collectImpactReportSuggestions(projectRoot: string, index: ProjectIndex, options: ImpactOptions, normalizedChanges: FileChange[], changedSymbols: ChangedSymbol[]): Promise<ImpactSuggestion[]>;
+//# sourceMappingURL=report-suggestions.d.ts.map

package/dist/impact/report-suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-suggestions.d.ts","sourceRoot":"","sources":["../../src/impact/report-suggestions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAUpE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA86B7F,wBAAsB,8BAA8B,CAClD,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,aAAa,EACtB,iBAAiB,EAAE,UAAU,EAAE,EAC/B,cAAc,EAAE,aAAa,EAAE,GAC9B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAuB7B"}