@lzehrung/codegraph 2.3.21 → 2.3.22

package/dist/worker/native-extract-worker.d.ts

@@ -0,0 +1,77 @@
+import type { CompactQueryResults, NativeBinding, NativeFallbackReason, NativeQueryResults, NativeSyntaxTree, NativeWorkerBindingHandoff } from "../native/contracts.js";
+import type { NativeBindingLoadResult } from "../native/binding-loader.js";
+export type NativeBloomFilterPayload = {
+    bits: Uint8Array;
+    size: number;
+    hashCount: number;
+    itemCount: number;
+};
+export type NativeExtractLimits = {
+    /** Maximum UTF-8 source bytes accepted before native parsing. Default: 8 MiB. */
+    maxSourceBytes?: number | undefined;
+};
+export type NativeExtractTask = {
+    filePath: string;
+    languageId: string;
+    source?: string | undefined;
+    /** Omit the source from the result only when the caller supplied the exact source above. */
+    includeSourceInResult?: boolean | undefined;
+    includeBloomFilter?: boolean | undefined;
+    importsQuery: string;
+    exportsQuery: string;
+    localsQuery: string;
+    importBindingsQuery: string;
+    compact?: boolean | undefined;
+    limits?: NativeExtractLimits | undefined;
+};
+export type NativeExtractResult = {
+    filePath: string;
+    languageId: string;
+    source?: string | undefined;
+    nativeResults: NativeQueryResults | null;
+    compactResults: CompactQueryResults | null;
+    syntaxTree: NativeSyntaxTree | null;
+    bloomFilter?: NativeBloomFilterPayload;
+    fallbackReason?: NativeFallbackReason;
+    error?: string;
+};
+export type NativeExtractBatchTask = {
+    tasks: NativeExtractTask[];
+};
+export type NativeExtractBatchResult = {
+    results: NativeExtractResult[];
+};
+export declare const NATIVE_WORKER_BATCH_SIZE = 32;
+export { REQUIRED_NATIVE_EXTRACTION_VERSION } from "../native/tree-shape.js";
+/**
+ * Default source byte cap before native parse/projection.
+ * 8 MiB is above virtually all hand-written sources while preventing a single
+ * generated/minified file from OOM-ing a long-lived extraction worker.
+ */
+export declare const DEFAULT_NATIVE_SOURCE_MAX_BYTES: number;
+/**
+ * Mirrored documentation of native projection defaults (enforced in Rust).
+ * 250k nodes / depth 512: far above ordinary ASTs; fail closed on pathological trees.
+ */
+export declare const DEFAULT_NATIVE_MAX_PROJECTED_NODES = 250000;
+export declare const DEFAULT_NATIVE_MAX_PROJECTED_DEPTH = 512;
+type NativeExtractorDeps = {
+    loadBinding: () => NativeBindingLoadResult<NativeBinding>;
+    readFile: (filePath: string, encoding: BufferEncoding) => Promise<string>;
+    statFile?: (filePath: string) => Promise<{
+        size: number;
+    }>;
+};
+export type NativeExtractor = (task: NativeExtractTask) => Promise<NativeExtractResult>;
+/**
+ * The addon the parent thread already resolved, verified, and loaded, if it passed one.
+ *
+ * Absent when this module is imported outside a worker (tests, direct use), or by a parent that
+ * had no loaded binding to offer. Both cases fall through to the full resolution below.
+ */
+export declare function readWorkerBindingHandoff(source?: unknown): NativeWorkerBindingHandoff | null;
+export declare function loadProductionBinding(handoffSource?: unknown): NativeBindingLoadResult<NativeBinding>;
+export declare function createNativeExtractor(deps: NativeExtractorDeps): NativeExtractor;
+export declare function runExtractionBatch(batch: NativeExtractBatchTask, extract?: NativeExtractor): Promise<NativeExtractBatchResult>;
+export default function runWorkerTask(task: NativeExtractTask | NativeExtractBatchTask): Promise<NativeExtractResult | NativeExtractBatchResult>;
+//# sourceMappingURL=native-extract-worker.d.ts.map

package/dist/worker/native-extract-worker.d.ts.map

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

package/dist/worker/native-extract-worker.js

@@ -0,0 +1,272 @@
+import fsp from "node:fs/promises";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { isMainThread, workerData } from "node:worker_threads";
+import { loadNativeBinding } from "../native/binding-loader.js";
+import { isColumnarSyntaxTree, nativeShapeMismatchMessage, REQUIRED_NATIVE_EXTRACTION_VERSION, } from "../native/tree-shape.js";
+import { supportById } from "../languages.js";
+import { buildBloomFilterFromSource } from "../util/bloom-filter.js";
+function buildBloomFilterPayload(source, languageId) {
+    const support = supportById(languageId);
+    if (!support)
+        return undefined;
+    const filter = buildBloomFilterFromSource(source, support);
+    const { size, hashCount } = filter.getMetadata();
+    return {
+        bits: filter.toBuffer(),
+        size,
+        hashCount,
+        itemCount: filter.getItemCount(),
+    };
+}
+export const NATIVE_WORKER_BATCH_SIZE = 32;
+export { REQUIRED_NATIVE_EXTRACTION_VERSION } from "../native/tree-shape.js";
+/**
+ * Default source byte cap before native parse/projection.
+ * 8 MiB is above virtually all hand-written sources while preventing a single
+ * generated/minified file from OOM-ing a long-lived extraction worker.
+ */
+export const DEFAULT_NATIVE_SOURCE_MAX_BYTES = 8 * 1024 * 1024;
+/**
+ * Mirrored documentation of native projection defaults (enforced in Rust).
+ * 250k nodes / depth 512: far above ordinary ASTs; fail closed on pathological trees.
+ */
+export const DEFAULT_NATIVE_MAX_PROJECTED_NODES = 250_000;
+export const DEFAULT_NATIVE_MAX_PROJECTED_DEPTH = 512;
+const require = createRequire(import.meta.url);
+const localNativePackageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../packages/codegraph-native");
+/**
+ * The addon the parent thread already resolved, verified, and loaded, if it passed one.
+ *
+ * Absent when this module is imported outside a worker (tests, direct use), or by a parent that
+ * had no loaded binding to offer. Both cases fall through to the full resolution below.
+ */
+export function readWorkerBindingHandoff(source = isMainThread ? undefined : workerData) {
+    if (!source || typeof source !== "object")
+        return null;
+    const candidate = source.nativeBinding;
+    if (!candidate || typeof candidate !== "object")
+        return null;
+    const { loadedPath, origin } = candidate;
+    if (typeof loadedPath !== "string" || !loadedPath)
+        return null;
+    if (!origin || typeof origin !== "object" || typeof origin.packageName !== "string")
+        return null;
+    return { loadedPath, origin };
+}
+export function loadProductionBinding(handoffSource = isMainThread ? undefined : workerData) {
+    const handoff = readWorkerBindingHandoff(handoffSource);
+    if (handoff) {
+        try {
+            // path.resolve puts the separators back in the platform's form; the parent normalizes
+            // them to forward slashes when it builds the origin.
+            return { binding: require(path.resolve(handoff.loadedPath)), origin: handoff.origin };
+        }
+        catch {
+            // A handoff that will not load is a bug worth surviving rather than failing the build on:
+            // fall through and resolve the addon the long way, exactly as before.
+        }
+    }
+    return loadNativeBinding({
+        packageName: "@lzehrung/codegraph-native",
+        localPackageRoot: localNativePackageRoot,
+        requireFn: require,
+        resolveFn: require.resolve,
+    });
+}
+function resolveSourceMaxBytes(task) {
+    const configured = task.limits?.maxSourceBytes;
+    if (typeof configured === "number" && Number.isFinite(configured) && configured > 0) {
+        return Math.floor(configured);
+    }
+    return DEFAULT_NATIVE_SOURCE_MAX_BYTES;
+}
+function resourceLimitFallback(task, source, error, bloomFilter) {
+    const includeSource = task.includeSourceInResult ?? true;
+    return {
+        filePath: task.filePath,
+        languageId: task.languageId,
+        ...(includeSource ? { source } : {}),
+        nativeResults: null,
+        compactResults: null,
+        syntaxTree: null,
+        ...(bloomFilter ? { bloomFilter } : {}),
+        fallbackReason: "queryFailure",
+        error,
+    };
+}
+export function createNativeExtractor(deps) {
+    let binding = null;
+    let supportedIds = null;
+    let loadError;
+    function ensureBinding() {
+        if (binding || loadError)
+            return;
+        const loaded = deps.loadBinding();
+        if (loaded.binding) {
+            if (typeof loaded.binding.extractLanguage !== "function") {
+                loadError =
+                    `@lzehrung/codegraph-native >= ${REQUIRED_NATIVE_EXTRACTION_VERSION} is required; ` +
+                        "the installed native binary does not provide extractLanguage. Reinstall the native package.";
+                return;
+            }
+            binding = loaded.binding;
+            supportedIds = new Set(binding.supportedLanguageIds());
+            return;
+        }
+        loadError =
+            "native addon not available in worker" +
+                (loaded.error ? `: ${loaded.error instanceof Error ? loaded.error.message : String(loaded.error)}` : "");
+    }
+    async function loadSource(task) {
+        const maxSourceBytes = resolveSourceMaxBytes(task);
+        if (task.source !== undefined) {
+            const bytes = Buffer.byteLength(task.source, "utf8");
+            if (bytes > maxSourceBytes) {
+                return {
+                    ok: false,
+                    source: task.source,
+                    error: `source exceeds native byte limit (${bytes} > ${maxSourceBytes})`,
+                };
+            }
+            return { ok: true, source: task.source };
+        }
+        if (deps.statFile) {
+            const stat = await deps.statFile(task.filePath);
+            if (stat.size > maxSourceBytes) {
+                return {
+                    ok: false,
+                    source: "",
+                    error: `source exceeds native byte limit (${stat.size} > ${maxSourceBytes})`,
+                };
+            }
+        }
+        const source = await deps.readFile(task.filePath, "utf8");
+        const bytes = Buffer.byteLength(source, "utf8");
+        if (bytes > maxSourceBytes) {
+            return {
+                ok: false,
+                source: "",
+                error: `source exceeds native byte limit (${bytes} > ${maxSourceBytes})`,
+            };
+        }
+        return { ok: true, source };
+    }
+    return async function runExtraction(task) {
+        ensureBinding();
+        const loaded = await loadSource(task);
+        if (!loaded.ok) {
+            return resourceLimitFallback(task, loaded.source, loaded.error);
+        }
+        const includeSource = task.includeSourceInResult ?? true;
+        const source = loaded.source;
+        const bloomFilter = task.includeBloomFilter ? buildBloomFilterPayload(source, task.languageId) : undefined;
+        if (!binding || !supportedIds) {
+            return {
+                filePath: task.filePath,
+                languageId: task.languageId,
+                ...(includeSource ? { source } : {}),
+                nativeResults: null,
+                compactResults: null,
+                syntaxTree: null,
+                ...(bloomFilter ? { bloomFilter } : {}),
+                fallbackReason: "unavailable",
+                ...(loadError ? { error: loadError } : {}),
+            };
+        }
+        if (!supportedIds.has(task.languageId)) {
+            return {
+                filePath: task.filePath,
+                languageId: task.languageId,
+                ...(includeSource ? { source } : {}),
+                nativeResults: null,
+                compactResults: null,
+                syntaxTree: null,
+                ...(bloomFilter ? { bloomFilter } : {}),
+                fallbackReason: "unsupportedLanguage",
+            };
+        }
+        try {
+            if (task.compact && binding.runImportsQueryCompact) {
+                const compactResults = binding.runImportsQueryCompact(source, task.languageId, task.importsQuery);
+                return {
+                    filePath: task.filePath,
+                    languageId: task.languageId,
+                    ...(includeSource ? { source } : {}),
+                    nativeResults: null,
+                    compactResults,
+                    syntaxTree: null,
+                    ...(bloomFilter ? { bloomFilter } : {}),
+                };
+            }
+            const extraction = binding.extractLanguage(source, task.languageId, task.importsQuery, task.exportsQuery, task.localsQuery, task.importBindingsQuery);
+            // A missing tree is a tolerated state downstream; a present-but-legacy tree is a
+            // version mismatch this build cannot read, so only the latter fails the task. The
+            // query results came from the same extractLanguage call and are unaffected by the
+            // tree's shape, so they still come back -- matching getNativeExtractionExecution's
+            // handling of the same mismatch on the non-worker path.
+            const syntaxTree = extraction.syntaxTree ?? null;
+            if (syntaxTree !== null && !isColumnarSyntaxTree(syntaxTree)) {
+                loadError = nativeShapeMismatchMessage();
+                return {
+                    filePath: task.filePath,
+                    languageId: task.languageId,
+                    ...(includeSource ? { source } : {}),
+                    nativeResults: extraction.results,
+                    compactResults: null,
+                    syntaxTree: null,
+                    ...(bloomFilter ? { bloomFilter } : {}),
+                    fallbackReason: "unavailable",
+                    error: loadError,
+                };
+            }
+            return {
+                filePath: task.filePath,
+                languageId: task.languageId,
+                ...(includeSource ? { source } : {}),
+                nativeResults: extraction.results,
+                compactResults: null,
+                syntaxTree,
+                ...(bloomFilter ? { bloomFilter } : {}),
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (/max (node|depth) limit/i.test(message)) {
+                return resourceLimitFallback(task, source, message, bloomFilter);
+            }
+            return {
+                filePath: task.filePath,
+                languageId: task.languageId,
+                ...(includeSource ? { source } : {}),
+                nativeResults: null,
+                compactResults: null,
+                syntaxTree: null,
+                ...(bloomFilter ? { bloomFilter } : {}),
+                fallbackReason: "queryFailure",
+                error: message,
+            };
+        }
+    };
+}
+const runExtraction = createNativeExtractor({
+    loadBinding: loadProductionBinding,
+    readFile: fsp.readFile,
+    statFile: async (filePath) => {
+        const stat = await fsp.stat(filePath);
+        return { size: stat.size };
+    },
+});
+export async function runExtractionBatch(batch, extract = runExtraction) {
+    const results = [];
+    for (const task of batch.tasks)
+        results.push(await extract(task));
+    return { results };
+}
+export default async function runWorkerTask(task) {
+    if ("tasks" in task)
+        return await runExtractionBatch(task);
+    return await runExtraction(task);
+}
+//# sourceMappingURL=native-extract-worker.js.map

package/dist/worker/native-extract-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-extract-worker.js","sourceRoot":"","sources":["../../src/worker/native-extract-worker.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,kBAAkB,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAU/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,kCAAkC,GACnC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AASrE,SAAS,uBAAuB,CAAC,MAAc,EAAE,UAAkB;IACjE,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,MAAM,GAAG,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3D,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACjD,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE;QACvB,IAAI;QACJ,SAAS;QACT,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE;KACjC,CAAC;AACJ,CAAC;AA2CD,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAC3C,OAAO,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAC;AAE7E;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/D;;;GAGG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,OAAO,CAAC;AAC1D,MAAM,CAAC,MAAM,kCAAkC,GAAG,GAAG,CAAC;AAEtD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,sBAAsB,GAAG,IAAI,CAAC,OAAO,CACzC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAC5C,iCAAiC,CAClC,CAAC;AAUF;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,SAAkB,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;IAEvD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,SAAS,GAAI,MAAsC,CAAC,aAAa,CAAC;IACxE,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7D,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,SAAgD,CAAC;IAChF,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC/D,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjG,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,gBAAyB,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;IAE9D,MAAM,OAAO,GAAG,wBAAwB,CAAC,aAAa,CAAC,CAAC;IACxD,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,sFAAsF;YACtF,qDAAqD;YACrD,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAkB,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACzG,CAAC;QAAC,MAAM,CAAC;YACP,0FAA0F;YAC1F,sEAAsE;QACxE,CAAC;IACH,CAAC;IACD,OAAO,iBAAiB,CAAgB;QACtC,WAAW,EAAE,4BAA4B;QACzC,gBAAgB,EAAE,sBAAsB;QACxC,SAAS,EAAE,OAAO;QAClB,SAAS,EAAE,OAAO,CAAC,OAAO;KAC3B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAuB;IACpD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC;IAC/C,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACpF,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,+BAA+B,CAAC;AACzC,CAAC;AAED,SAAS,qBAAqB,CAC5B,IAAuB,EACvB,MAAc,EACd,KAAa,EACb,WAAsC;IAEtC,MAAM,aAAa,GAAG,IAAI,CAAC,qBAAqB,IAAI,IAAI,CAAC;IACzD,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,IAAI;QACpB,UAAU,EAAE,IAAI;QAChB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,cAAc,EAAE,cAAc;QAC9B,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAyB;IAC7D,IAAI,OAAO,GAAyB,IAAI,CAAC;IACzC,IAAI,YAAY,GAAuB,IAAI,CAAC;IAC5C,IAAI,SAA6B,CAAC;IAElC,SAAS,aAAa;QACpB,IAAI,OAAO,IAAI,SAAS;YAAE,OAAO;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAClC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,OAAO,MAAM,CAAC,OAAO,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;gBACzD,SAAS;oBACP,iCAAiC,kCAAkC,gBAAgB;wBACnF,6FAA6F,CAAC;gBAChG,OAAO;YACT,CAAC;YACD,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YACzB,YAAY,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;YACvD,OAAO;QACT,CAAC;QACD,SAAS;YACP,sCAAsC;gBACtC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7G,CAAC;IAED,KAAK,UAAU,UAAU,CACvB,IAAuB;QAEvB,MAAM,cAAc,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACrD,IAAI,KAAK,GAAG,cAAc,EAAE,CAAC;gBAC3B,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,KAAK,EAAE,qCAAqC,KAAK,MAAM,cAAc,GAAG;iBACzE,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3C,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAChD,IAAI,IAAI,CAAC,IAAI,GAAG,cAAc,EAAE,CAAC;gBAC/B,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,qCAAqC,IAAI,CAAC,IAAI,MAAM,cAAc,GAAG;iBAC7E,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChD,IAAI,KAAK,GAAG,cAAc,EAAE,CAAC;YAC3B,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,qCAAqC,KAAK,MAAM,cAAc,GAAG;aACzE,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO,KAAK,UAAU,aAAa,CAAC,IAAuB;QACzD,aAAa,EAAE,CAAC;QAEhB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,aAAa,GAAG,IAAI,CAAC,qBAAqB,IAAI,IAAI,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE3G,IAAI,CAAC,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;YAC9B,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpC,aAAa,EAAE,IAAI;gBACnB,cAAc,EAAE,IAAI;gBACpB,UAAU,EAAE,IAAI;gBAChB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvC,cAAc,EAAE,aAAa;gBAC7B,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3C,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACvC,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpC,aAAa,EAAE,IAAI;gBACnB,cAAc,EAAE,IAAI;gBACpB,UAAU,EAAE,IAAI;gBAChB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvC,cAAc,EAAE,qBAAqB;aACtC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;gBACnD,MAAM,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;gBAClG,OAAO;oBACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpC,aAAa,EAAE,IAAI;oBACnB,cAAc;oBACd,UAAU,EAAE,IAAI;oBAChB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxC,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,GAAG,OAAO,CAAC,eAAe,CACxC,MAAM,EACN,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,mBAAmB,CACzB,CAAC;YACF,iFAAiF;YACjF,kFAAkF;YAClF,kFAAkF;YAClF,mFAAmF;YACnF,wDAAwD;YACxD,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,IAAI,IAAI,CAAC;YACjD,IAAI,UAAU,KAAK,IAAI,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC7D,SAAS,GAAG,0BAA0B,EAAE,CAAC;gBACzC,OAAO;oBACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpC,aAAa,EAAE,UAAU,CAAC,OAAO;oBACjC,cAAc,EAAE,IAAI;oBACpB,UAAU,EAAE,IAAI;oBAChB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvC,cAAc,EAAE,aAAa;oBAC7B,KAAK,EAAE,SAAS;iBACjB,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpC,aAAa,EAAE,UAAU,CAAC,OAAO;gBACjC,cAAc,EAAE,IAAI;gBACpB,UAAU;gBACV,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxC,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,IAAI,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5C,OAAO,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;YACnE,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpC,aAAa,EAAE,IAAI;gBACnB,cAAc,EAAE,IAAI;gBACpB,UAAU,EAAE,IAAI;gBAChB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvC,cAAc,EAAE,cAAc;gBAC9B,KAAK,EAAE,OAAO;aACf,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,aAAa,GAAG,qBAAqB,CAAC;IAC1C,WAAW,EAAE,qBAAqB;IAClC,QAAQ,EAAE,GAAG,CAAC,QAAQ;IACtB,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;QAC3B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAA6B,EAC7B,UAA2B,aAAa;IAExC,MAAM,OAAO,GAA0B,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,aAAa,CACzC,IAAgD;IAEhD,IAAI,OAAO,IAAI,IAAI;QAAE,OAAO,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/dist/worker/native-worker-pool.d.ts

@@ -0,0 +1,16 @@
+import { Piscina } from "piscina";
+import type { NativeExtractTask, NativeExtractResult } from "./native-extract-worker.js";
+export type { NativeExtractTask, NativeExtractResult };
+export type NativeWorkerPoolOptions = {
+    threads?: number | undefined;
+    maxQueue?: number | undefined;
+    /** Upper bound applied after the usual sizing policy, e.g. the number of files to parse. */
+    maxThreads?: number | undefined;
+    /** Passed through to each worker as node's `workerData`. */
+    workerData?: unknown;
+};
+export declare function defaultNativeWorkerThreadCount(availableParallelism?: number): number;
+export declare function resolveNativeWorkerThreadCount(requested?: number, availableParallelism?: number): number;
+export declare function resolveNativeWorkerPath(): string;
+export declare function createNativeWorkerPool(opts?: NativeWorkerPoolOptions): Piscina;
+//# sourceMappingURL=native-worker-pool.d.ts.map

package/dist/worker/native-worker-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-worker-pool.d.ts","sourceRoot":"","sources":["../../src/worker/native-worker-pool.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIlC,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEzF,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,CAAC;AAEvD,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAKF,wBAAgB,8BAA8B,CAAC,oBAAoB,SAA4B,GAAG,MAAM,CAEvG;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,CAAC,EAAE,MAAM,EAClB,oBAAoB,SAA4B,GAC/C,MAAM,CAMR;AAMD,wBAAgB,uBAAuB,IAAI,MAAM,CAahD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAiB9E"}

package/dist/worker/native-worker-pool.js

@@ -0,0 +1,54 @@
+import os from "node:os";
+import fs from "node:fs";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+import { Piscina } from "piscina";
+import { resolveWorkerThreadCount } from "../util/worker-threads.js";
+import { markWindowsProcessDrainRequired } from "../util/windows-process-drain.js";
+const HARD_MAX_THREADS = 64;
+const DEFAULT_NATIVE_THREAD_CAP = 8;
+export function defaultNativeWorkerThreadCount(availableParallelism = os.availableParallelism()) {
+    return Math.min(DEFAULT_NATIVE_THREAD_CAP, Math.max(1, Math.floor(availableParallelism * 0.75)));
+}
+export function resolveNativeWorkerThreadCount(requested, availableParallelism = os.availableParallelism()) {
+    return resolveWorkerThreadCount({
+        requested,
+        defaultCount: defaultNativeWorkerThreadCount(availableParallelism),
+        max: HARD_MAX_THREADS,
+    });
+}
+function resolveThreadCount(requested) {
+    return resolveNativeWorkerThreadCount(requested);
+}
+export function resolveNativeWorkerPath() {
+    const selfDir = path.dirname(fileURLToPath(import.meta.url));
+    // When running from dist/, the sibling .js file exists directly
+    const sibling = path.resolve(selfDir, "native-extract-worker.js");
+    if (fs.existsSync(sibling))
+        return sibling;
+    // When running from src/ (e.g. vitest), resolve to the compiled dist/ worker
+    const projectRoot = path.resolve(selfDir, "../..");
+    const distWorker = path.resolve(projectRoot, "dist", "worker", "native-extract-worker.js");
+    if (fs.existsSync(distWorker))
+        return distWorker;
+    throw new Error(`Native worker file not found. Expected at "${sibling}" or "${distWorker}". ` +
+        `Ensure the project has been built (dist/worker/native-extract-worker.js).`);
+}
+export function createNativeWorkerPool(opts) {
+    const requestedMax = opts?.maxThreads;
+    const bounded = typeof requestedMax === "number" && Number.isFinite(requestedMax) && requestedMax > 0
+        ? Math.max(1, Math.floor(requestedMax))
+        : HARD_MAX_THREADS;
+    const threads = Math.min(resolveThreadCount(opts?.threads), bounded);
+    const workerPath = resolveNativeWorkerPath();
+    markWindowsProcessDrainRequired();
+    return new Piscina({
+        filename: workerPath,
+        minThreads: 1,
+        maxThreads: threads,
+        maxQueue: opts?.maxQueue ?? threads * 4,
+        idleTimeout: 30_000,
+        ...(opts?.workerData === undefined ? {} : { workerData: opts.workerData }),
+    });
+}
+//# sourceMappingURL=native-worker-pool.js.map

package/dist/worker/native-worker-pool.js.map

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

package/docs/mcp.md

@@ -74,7 +74,7 @@ Run `codegraph doctor` in the installed release to inspect `native.origin`, `nat
 The server exposes the same bounded primitives as the CLI and library session layer:
 
 - `orient`: compact first-turn repo context.
-- `search`: deterministic ranked search across paths, symbols, chunks, SQL objects, and graph context.
+- `search`: deterministic ranked search across paths, symbols, chunks, SQL objects, and graph context. Its response separates `omittedCounts.results` from bounded indexed-text retrieval through `limits.indexedTextChunks`, `candidateCounts.indexedTextChunks`, and `omittedCounts.indexedTextChunks`; `candidateCounts.indexedTextChunksLowerBound` marks lower-bound candidate counts.
 - `explore`: one hybrid search plus context from top results; not a first-step planner.
 - `packet_get`: bounded evidence packet by file path, symbol name, SQL object name, or stable target.
 - `workspace_symbols`: deterministic symbol-identity lookup with exact locations and composable filters; use `search` for hybrid path, prose, SQL, snippet, or graph evidence.
@@ -90,7 +90,7 @@ The server exposes the same bounded primitives as the CLI and library session la
 - `file_deps`, `path`: dependency navigation; pass `direction: "deps"` or `"rdeps"` to `file_deps`. `file_deps` uses the same collection `limit` default 25 / max 500 as `refs`. `file_deps.file` accepts a portable symbol handle or qualified symbol path and traverses its declaring file. `dependencies`/`reverseDependencies` carry the same `limit`/`totalSeen`/`truncated`/`omitted` metadata as `refs`, so a capped prefix is always distinguishable from a complete result; when truncated, `totalSeen` and `omitted` are lower bounds from the bounded probe, not full graph-wide counts.
 - `impact`: compact git-range impact analysis (`format: "compact"`, `impacted`, diagnostics). Bounded by default.
 - `review`: git-range review report (`riskSummary`, `reviewTasks`, candidate tests). MCP is a bounded transport: `projectFiles`, `changedFiles` (including per-file `symbols`), `graphDelta`, and `candidateTests` are capped at the response's `limits` with exact per-collection `omittedCounts`, and `summary` totals stay accurate for the full report. Library callers that need the complete unbounded report call `buildReviewReport` directly instead of going through MCP.
-- `query_sqlite`: bounded read-only SQLite artifact query with freshness metadata. Row `limit` defaults to 100 and caps at 500 (`src/sqlite/rowBounds.ts`).
+- `query_sqlite`: bounded read-only SQLite artifact query with freshness metadata. Row `limit` defaults to 100 and caps at 500 (`src/sqlite/row-bounds.ts`).
 - `refresh_index`: invalidate the in-memory session and optionally rebuild the base or symbol snapshot.
 - `artifact_build`: artifact creation, available only with write access enabled.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lzehrung/codegraph",
-  "version": "2.3.21",
+  "version": "2.3.22",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -49,7 +49,7 @@
     "codegraph-skill",
     "THIRD_PARTY_NOTICES",
     "docs/mcp.md",
-    "docs/graph-visualization"
+    "src/viewer"
   ],
   "repository": {
     "type": "git",
@@ -82,7 +82,7 @@
   "license": "MIT",
   "description": "Multi-language repository map for agents and humans: MCP tools, dependency graphs, symbol indexes, impact review, and bounded source evidence.",
   "dependencies": {
-    "@lzehrung/codegraph-core": "2.3.21",
+    "@lzehrung/codegraph-core": "2.3.22",
     "@modelcontextprotocol/node": "^2.0.0",
     "@modelcontextprotocol/server": "^2.0.0",
     "fast-glob": "^3.3.3",
@@ -99,6 +99,6 @@
     "@emnapi/runtime": "1.11.3"
   },
   "optionalDependencies": {
-    "@lzehrung/codegraph-native": "^1.12.21"
+    "@lzehrung/codegraph-native": "^1.12.22"
   }
 }

package/dist/agent/callHierarchy.d.ts

@@ -1,28 +0,0 @@
-import { type CallHierarchyDirection } from "../indexer/call-hierarchy.js";
-import type { BuildOptions } from "../indexer/types.js";
-import type { SemanticLocation, SemanticProvenance, SemanticResponseEnvelope, SemanticSymbol } from "./semantic.js";
-import { type AgentSession } from "./session.js";
-export type CallHierarchyRequest = {
-    root: string;
-    handle: string;
-    depth?: number;
-    limit?: number;
-    includeHeuristic?: boolean;
-    buildOptions?: BuildOptions;
-};
-export type CallHierarchyEntry = {
-    symbol: SemanticSymbol;
-    callsites: SemanticLocation[];
-    depth: number;
-    provenance: SemanticProvenance;
-};
-export type CallHierarchyResponse = SemanticResponseEnvelope & {
-    target: SemanticSymbol;
-    direction: CallHierarchyDirection;
-    entries: CallHierarchyEntry[];
-};
-export declare function findCallers(request: CallHierarchyRequest): Promise<CallHierarchyResponse>;
-export declare function findCallees(request: CallHierarchyRequest): Promise<CallHierarchyResponse>;
-export declare function findCallersWithSession(session: AgentSession, request: CallHierarchyRequest): Promise<CallHierarchyResponse>;
-export declare function findCalleesWithSession(session: AgentSession, request: CallHierarchyRequest): Promise<CallHierarchyResponse>;
-//# sourceMappingURL=callHierarchy.d.ts.map

package/dist/agent/callHierarchy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"callHierarchy.d.ts","sourceRoot":"","sources":["../../src/agent/callHierarchy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC9F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpH,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAGtB,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,kBAAkB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,GAAG;IAC7D,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,sBAAsB,CAAC;IAClC,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B,CAAC;AAEF,wBAAsB,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAE/F;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAE/F;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAEhC"}

package/dist/agent/callHierarchy.js

@@ -1,82 +0,0 @@
-import { findCallHierarchy } from "../indexer/call-hierarchy.js";
-import { normalizeAgentFilePath } from "./normalize.js";
-import { requireSemanticSymbol, semanticSymbolFromDef } from "./semanticSymbols.js";
-import { createAgentSession, } from "./session.js";
-import { buildSymbolLookup } from "./symbolLookup.js";
-export async function findCallers(request) {
-    return await runCallHierarchy(createSession(request), request, "incoming");
-}
-export async function findCallees(request) {
-    return await runCallHierarchy(createSession(request), request, "outgoing");
-}
-export async function findCallersWithSession(session, request) {
-    return await runCallHierarchy(session, request, "incoming");
-}
-export async function findCalleesWithSession(session, request) {
-    return await runCallHierarchy(session, request, "outgoing");
-}
-async function runCallHierarchy(session, request, direction) {
-    const freshness = session.checkFreshness ? await session.checkFreshness() : { state: "fresh" };
-    const snapshot = await session.loadProject();
-    const resolved = requireSemanticSymbol(snapshot, request.handle);
-    const result = findCallHierarchy(snapshot.symbolGraph, resolved.id, direction, {
-        ...(request.depth !== undefined ? { depth: request.depth } : {}),
-        ...(request.limit !== undefined ? { limit: request.limit } : {}),
-    });
-    if (result.status !== "ok")
-        throw new Error(result.reason);
-    const lookup = buildSymbolLookup(snapshot);
-    const provenance = callProvenance(snapshot);
-    const entries = result.entries.flatMap((match) => {
-        const def = lookup.defById.get(match.symbolId);
-        if (!def)
-            return [];
-        return [
-            {
-                symbol: semanticSymbolFromDef(snapshot, def),
-                callsites: match.callsites.map((site) => ({
-                    file: normalizeAgentFilePath(snapshot.root, site.file),
-                    range: site.range,
-                })),
-                depth: match.depth,
-                provenance,
-            },
-        ];
-    });
-    return {
-        ...callResponseEnvelope(snapshot, freshness, result.limit, result.callsiteLimit, {
-            symbols: result.omittedSymbols,
-            callsites: result.omittedCallsites,
-            unresolvedSites: result.unresolvedEdges,
-        }),
-        target: semanticSymbolFromDef(snapshot, resolved.def),
-        direction,
-        entries,
-    };
-}
-function createSession(request) {
-    return createAgentSession({
-        root: request.root,
-        ...(request.buildOptions ? { buildOptions: request.buildOptions } : {}),
-    });
-}
-function callProvenance(snapshot) {
-    const reduced = snapshot.analysis.mode === "reduced";
-    return {
-        capability: reduced ? "graph" : "semantic",
-        backend: snapshot.analysis.backend,
-        confidence: reduced ? "medium" : "high",
-        ...(reduced ? { reason: snapshot.analysis.label } : {}),
-    };
-}
-function callResponseEnvelope(snapshot, freshness, symbolLimit, callsiteLimit, omittedCounts) {
-    return {
-        schemaVersion: 1,
-        root: snapshot.root,
-        analysis: snapshot.analysis,
-        freshness,
-        limits: { symbols: symbolLimit, callsitesPerSymbol: callsiteLimit },
-        omittedCounts,
-    };
-}
-//# sourceMappingURL=callHierarchy.js.map

package/dist/agent/callHierarchy.js.map

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

package/dist/agent/candidateTests.d.ts

@@ -1,12 +0,0 @@
-import type { ProjectIndex, SymbolHandle } from "../indexer/types.js";
-export type RenameCandidateTest = {
-    file: string;
-    confidence: "high" | "medium" | "low";
-    reason: string;
-};
-export type CandidateTestShapingResult = {
-    candidateTests: RenameCandidateTest[];
-    omittedCandidateTests: number;
-};
-export declare function shapeCandidateTests(index: ProjectIndex, projectRoot: string, files: readonly string[], definitionHandles: readonly (SymbolHandle | string)[], limit?: number): CandidateTestShapingResult;
-//# sourceMappingURL=candidateTests.d.ts.map