@lzehrung/codegraph 2.1.0

package/dist/indexer/build-cache/options.js

@@ -0,0 +1,276 @@
+import crypto from "node:crypto";
+import path from "node:path";
+import { normalizeLanguageExtensions } from "../../languages.js";
+import { getAllLanguages } from "../../languages/registry.js";
+import { normalizePath, normalizeResolutionHints } from "../../util/paths.js";
+import { getCodegraphVersion } from "../../util/packageInfo.js";
+import {} from "../../util/projectFiles.js";
+import { getNativeRuntimeFingerprint } from "../../native/treeSitterNative.js";
+let cachedImplementationFingerprint;
+function functionSource(value) {
+    return typeof value === "function" ? Function.prototype.toString.call(value) : undefined;
+}
+function languageDefinitionFingerprintDescriptor(definition) {
+    const native = definition.native;
+    const nativeNormalizeQuery = functionSource(native?.normalizeQuery);
+    const classifyDefinition = functionSource(definition.classifyDefinition);
+    const isDeclarationName = functionSource(definition.isDeclarationName);
+    const scopeDeclarationNames = definition.scopeDeclarationNames === "all" ? "all" : functionSource(definition.scopeDeclarationNames);
+    const normalizeIdentifier = functionSource(definition.normalizeIdentifier);
+    const createsBlockScope = functionSource(definition.createsBlockScope);
+    const createsFunctionScope = functionSource(definition.createsFunctionScope);
+    const isTypeOnly = functionSource(definition.isTypeOnly);
+    return {
+        id: definition.id,
+        extensions: [...definition.extensions].sort(),
+        structure: definition.structure,
+        graph: definition.graph,
+        ...(definition.nodeTypes ? { nodeTypes: definition.nodeTypes } : {}),
+        supportsCrossModuleSymbols: definition.supportsCrossModuleSymbols ?? false,
+        ...(native
+            ? {
+                native: {
+                    authoritativeKinds: [...(native.authoritativeKinds ?? [])].sort(),
+                    notes: [...(native.notes ?? [])],
+                    ...(nativeNormalizeQuery ? { normalizeQuery: nativeNormalizeQuery } : {}),
+                },
+            }
+            : {}),
+        behavior: {
+            grammar: functionSource(definition.grammar) ?? "",
+            // Booleans serialize under the same defaults adaptDefinition applies, so the
+            // fingerprint tracks effective behavior rather than incidental optionality.
+            usesQueryDrivenLocals: definition.usesQueryDrivenLocals ?? false,
+            membersAreImplicitlyInScope: definition.membersAreImplicitlyInScope ?? true,
+            ...(classifyDefinition ? { classifyDefinition } : {}),
+            ...(isDeclarationName ? { isDeclarationName } : {}),
+            ...(scopeDeclarationNames ? { scopeDeclarationNames } : {}),
+            ...(normalizeIdentifier ? { normalizeIdentifier } : {}),
+            ...(createsBlockScope ? { createsBlockScope } : {}),
+            ...(createsFunctionScope ? { createsFunctionScope } : {}),
+            ...(isTypeOnly ? { isTypeOnly } : {}),
+        },
+    };
+}
+/**
+ * Structural guard against fingerprint drift: every LanguageDefinition key must be
+ * covered by languageDefinitionFingerprintDescriptor above. Record exhaustiveness
+ * makes adding a field to LanguageDefinition without descriptor coverage a
+ * typecheck error, and the runtime check in tests/cache-invalidation.test.ts
+ * rejects definition objects carrying keys outside this set. Coverage here means
+ * the field participates in the fingerprint; if a future field genuinely cannot
+ * affect indexing results, serialize a stable placeholder for it in the
+ * descriptor and keep its entry below.
+ */
+export const languageDefinitionFingerprintCoverage = {
+    id: true,
+    extensions: true,
+    grammar: true,
+    structure: true,
+    graph: true,
+    usesQueryDrivenLocals: true,
+    classifyDefinition: true,
+    isDeclarationName: true,
+    scopeDeclarationNames: true,
+    normalizeIdentifier: true,
+    createsBlockScope: true,
+    createsFunctionScope: true,
+    membersAreImplicitlyInScope: true,
+    supportsCrossModuleSymbols: true,
+    isTypeOnly: true,
+    nodeTypes: true,
+    native: true,
+};
+/**
+ * Changes whenever this package version or a loaded language definition changes.
+ * The descriptor serializes every LanguageDefinition field (guarded by
+ * languageDefinitionFingerprintCoverage): structure and graph queries, plus the
+ * source text of every behavior hook, so editing a definition or its queries
+ * cannot silently outlive an on-disk index. Changes to the code that interprets
+ * definitions — the import resolver, the chunker, scope construction — are NOT
+ * covered by this descriptor; they invalidate only via the package-version
+ * component, so same-version installs and dev iteration must bump the version or
+ * clear the cache for those to take effect.
+ */
+export function getImplementationFingerprint() {
+    if (cachedImplementationFingerprint)
+        return cachedImplementationFingerprint;
+    const definitions = getAllLanguages()
+        .map(languageDefinitionFingerprintDescriptor)
+        .sort((left, right) => left.id.localeCompare(right.id));
+    const hash = crypto.createHash("sha256");
+    hash.update("codegraph-implementation-fingerprint-v1");
+    hash.update("\0");
+    hash.update(getCodegraphVersion());
+    hash.update("\0");
+    hash.update(JSON.stringify(definitions));
+    cachedImplementationFingerprint = hash.digest("hex");
+    return cachedImplementationFingerprint;
+}
+export function clearImplementationFingerprintCache() {
+    cachedImplementationFingerprint = undefined;
+}
+function normalizeManifestBuildOptions(opts) {
+    const languageExtensions = normalizeLanguageExtensions(opts?.languageExtensions);
+    return {
+        cache: opts?.cache ?? "off",
+        cacheStrict: opts?.cacheStrict ?? true,
+        useBloomFilters: opts?.useBloomFilters ?? true,
+        incrementalStrict: opts?.incrementalStrict ?? false,
+        ...(opts?.nativeRuntimeFingerprint ? { nativeRuntimeFingerprint: opts.nativeRuntimeFingerprint } : {}),
+        ...(opts?.implementationFingerprint ? { implementationFingerprint: opts.implementationFingerprint } : {}),
+        ...(opts?.discovery ? { discovery: opts.discovery } : {}),
+        ...(languageExtensions ? { languageExtensions } : {}),
+    };
+}
+function normalizeDiscoveryOptions(discovery) {
+    if (!discovery)
+        return undefined;
+    const normalizeGlob = (glob) => glob.trim().replace(/\\/g, "/");
+    const includeGlobs = Array.from(new Set((discovery.includeGlobs ?? []).map(normalizeGlob).filter(Boolean))).sort();
+    const ignoreGlobs = Array.from(new Set((discovery.ignoreGlobs ?? []).map(normalizeGlob).filter(Boolean))).sort();
+    const globRoot = discovery.globRoot ? normalizePath(path.resolve(discovery.globRoot)) : undefined;
+    const gitignoreRoot = discovery.gitignoreRoot ? normalizePath(path.resolve(discovery.gitignoreRoot)) : undefined;
+    const useGitignore = discovery.useGitignore ?? true;
+    if (!includeGlobs.length && !ignoreGlobs.length && !globRoot && !gitignoreRoot && useGitignore) {
+        return undefined;
+    }
+    return {
+        ...(includeGlobs.length ? { includeGlobs } : {}),
+        ...(ignoreGlobs.length ? { ignoreGlobs } : {}),
+        ...(globRoot ? { globRoot } : {}),
+        ...(gitignoreRoot ? { gitignoreRoot } : {}),
+        useGitignore,
+    };
+}
+export { normalizeLanguageExtensions } from "../../languages.js";
+function normalizeBuildOptions(opts) {
+    const discovery = normalizeDiscoveryOptions(opts?.discovery);
+    const languageExtensions = normalizeLanguageExtensions(opts?.languageExtensions);
+    return {
+        cache: opts?.cache ?? "off",
+        cacheStrict: opts?.cacheStrict ?? true,
+        useBloomFilters: opts?.useBloomFilters ?? true,
+        incrementalStrict: opts?.incrementalStrict ?? false,
+        nativeRuntimeFingerprint: getNativeRuntimeFingerprint(opts?.native),
+        implementationFingerprint: getImplementationFingerprint(),
+        ...(discovery ? { discovery } : {}),
+        ...(languageExtensions ? { languageExtensions } : {}),
+    };
+}
+export function summarizeBuildOptions(opts) {
+    return normalizeBuildOptions(opts);
+}
+function normalizeLanguageList(list) {
+    const out = [];
+    const seen = new Set();
+    for (const entry of list ?? []) {
+        const normalized = entry.trim().toLowerCase();
+        if (!normalized || seen.has(normalized))
+            continue;
+        seen.add(normalized);
+        out.push(normalized);
+    }
+    out.sort();
+    return out;
+}
+function orderedListsEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+function normalizedDiscoveryOptionsEqual(a, b) {
+    const normalizedA = a ?? { useGitignore: true };
+    const normalizedB = b ?? { useGitignore: true };
+    if (normalizedA.useGitignore !== normalizedB.useGitignore)
+        return false;
+    if (normalizedA.globRoot !== normalizedB.globRoot)
+        return false;
+    if (normalizedA.gitignoreRoot !== normalizedB.gitignoreRoot)
+        return false;
+    if (!orderedListsEqual(normalizedA.includeGlobs ?? [], normalizedB.includeGlobs ?? []))
+        return false;
+    if (!orderedListsEqual(normalizedA.ignoreGlobs ?? [], normalizedB.ignoreGlobs ?? []))
+        return false;
+    return true;
+}
+function normalizedLanguageExtensionsEqual(a, b) {
+    const normalizedA = normalizeLanguageExtensions(a) ?? {};
+    const normalizedB = normalizeLanguageExtensions(b) ?? {};
+    const keys = Array.from(new Set([...Object.keys(normalizedA), ...Object.keys(normalizedB)])).sort();
+    for (const key of keys) {
+        if (normalizedA[key] !== normalizedB[key])
+            return false;
+    }
+    return true;
+}
+export function diffBuildOptions(manifestOpts, currentOpts) {
+    if (!manifestOpts)
+        return ["native"];
+    const normalizedManifest = normalizeManifestBuildOptions(manifestOpts);
+    const normalizedCurrent = normalizeBuildOptions(currentOpts);
+    const diffs = [];
+    if (normalizedManifest.cache !== normalizedCurrent.cache)
+        diffs.push("cache");
+    if (normalizedManifest.cacheStrict !== normalizedCurrent.cacheStrict) {
+        diffs.push("cacheStrict");
+    }
+    if (normalizedManifest.useBloomFilters !== normalizedCurrent.useBloomFilters) {
+        diffs.push("useBloomFilters");
+    }
+    if (normalizedManifest.incrementalStrict !== normalizedCurrent.incrementalStrict) {
+        diffs.push("incrementalStrict");
+    }
+    if (normalizedManifest.nativeRuntimeFingerprint !== normalizedCurrent.nativeRuntimeFingerprint) {
+        diffs.push("native");
+    }
+    if (normalizedManifest.implementationFingerprint !== normalizedCurrent.implementationFingerprint) {
+        diffs.push("implementation");
+    }
+    if (!normalizedDiscoveryOptionsEqual(normalizedManifest.discovery, normalizedCurrent.discovery)) {
+        diffs.push("discovery");
+    }
+    if (!normalizedLanguageExtensionsEqual(normalizedManifest.languageExtensions, normalizedCurrent.languageExtensions)) {
+        diffs.push("languageExtensions");
+    }
+    return diffs;
+}
+export function normalizeGraphOptions(opts) {
+    const resolutionHints = normalizeResolutionHints(opts?.resolutionHints);
+    const fastRegexDisabledLanguages = normalizeLanguageList(opts?.fastRegexDisabledLanguages);
+    return {
+        fast: !!opts?.fast,
+        ...(fastRegexDisabledLanguages.length ? { fastRegexDisabledLanguages } : {}),
+        resolveNodeModules: !!opts?.resolveNodeModules,
+        dynamicImportHeuristics: !!opts?.dynamicImportHeuristics,
+        ...(resolutionHints.length ? { resolutionHints } : {}),
+    };
+}
+export function graphOptionsEqual(a, b) {
+    if (!a && !b)
+        return true;
+    if (!a || !b)
+        return false;
+    const normalizedA = normalizeGraphOptions(a);
+    const normalizedB = normalizeGraphOptions(b);
+    if (!!normalizedA.fast !== !!normalizedB.fast)
+        return false;
+    if (!!normalizedA.resolveNodeModules !== !!normalizedB.resolveNodeModules) {
+        return false;
+    }
+    if (!!normalizedA.dynamicImportHeuristics !== !!normalizedB.dynamicImportHeuristics) {
+        return false;
+    }
+    if (!orderedListsEqual(normalizedA.fastRegexDisabledLanguages ?? [], normalizedB.fastRegexDisabledLanguages ?? [])) {
+        return false;
+    }
+    if (!orderedListsEqual(normalizedA.resolutionHints ?? [], normalizedB.resolutionHints ?? [])) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=options.js.map

package/dist/indexer/build-cache/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/indexer/build-cache/options.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,2BAA2B,EAA6B,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAoC,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AA8C/E,IAAI,+BAAmD,CAAC;AAExD,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3F,CAAC;AAED,SAAS,uCAAuC,CAC9C,UAA8B;IAE9B,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IACjC,MAAM,oBAAoB,GAAG,cAAc,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACpE,MAAM,kBAAkB,GAAG,cAAc,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IACzE,MAAM,iBAAiB,GAAG,cAAc,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;IACvE,MAAM,qBAAqB,GACzB,UAAU,CAAC,qBAAqB,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;IACxG,MAAM,mBAAmB,GAAG,cAAc,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;IAC3E,MAAM,iBAAiB,GAAG,cAAc,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;IACvE,MAAM,oBAAoB,GAAG,cAAc,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC7E,MAAM,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IACzD,OAAO;QACL,EAAE,EAAE,UAAU,CAAC,EAAE;QACjB,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE;QAC7C,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,0BAA0B,EAAE,UAAU,CAAC,0BAA0B,IAAI,KAAK;QAC1E,GAAG,CAAC,MAAM;YACR,CAAC,CAAC;gBACE,MAAM,EAAE;oBACN,kBAAkB,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;oBACjE,KAAK,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;oBAChC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1E;aACF;YACH,CAAC,CAAC,EAAE,CAAC;QACP,QAAQ,EAAE;YACR,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE;YACjD,6EAA6E;YAC7E,4EAA4E;YAC5E,qBAAqB,EAAE,UAAU,CAAC,qBAAqB,IAAI,KAAK;YAChE,2BAA2B,EAAE,UAAU,CAAC,2BAA2B,IAAI,IAAI;YAC3E,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAqD;IACrG,EAAE,EAAE,IAAI;IACR,UAAU,EAAE,IAAI;IAChB,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,IAAI;IACX,qBAAqB,EAAE,IAAI;IAC3B,kBAAkB,EAAE,IAAI;IACxB,iBAAiB,EAAE,IAAI;IACvB,qBAAqB,EAAE,IAAI;IAC3B,mBAAmB,EAAE,IAAI;IACzB,iBAAiB,EAAE,IAAI;IACvB,oBAAoB,EAAE,IAAI;IAC1B,2BAA2B,EAAE,IAAI;IACjC,0BAA0B,EAAE,IAAI;IAChC,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,IAAI;IACf,MAAM,EAAE,IAAI;CACb,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,4BAA4B;IAC1C,IAAI,+BAA+B;QAAE,OAAO,+BAA+B,CAAC;IAC5E,MAAM,WAAW,GAAG,eAAe,EAAE;SAClC,GAAG,CAAC,uCAAuC,CAAC;SAC5C,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,yCAAyC,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClB,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;IACzC,+BAA+B,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrD,OAAO,+BAA+B,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,mCAAmC;IACjD,+BAA+B,GAAG,SAAS,CAAC;AAC9C,CAAC;AAED,SAAS,6BAA6B,CAAC,IAA2B;IAChE,MAAM,kBAAkB,GAAG,2BAA2B,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IACjF,OAAO;QACL,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,KAAK;QAC3B,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,IAAI;QACtC,eAAe,EAAE,IAAI,EAAE,eAAe,IAAI,IAAI;QAC9C,iBAAiB,EAAE,IAAI,EAAE,iBAAiB,IAAI,KAAK;QACnD,GAAG,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,wBAAwB,EAAE,IAAI,CAAC,wBAAwB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtG,GAAG,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC,CAAC,EAAE,yBAAyB,EAAE,IAAI,CAAC,yBAAyB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzG,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,SAAuC;IACxE,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACxE,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnH,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjH,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClG,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjH,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,IAAI,IAAI,CAAC;IACpD,IAAI,CAAC,YAAY,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,IAAI,CAAC,QAAQ,IAAI,CAAC,aAAa,IAAI,YAAY,EAAE,CAAC;QAC/F,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,YAAY;KACb,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAEjE,SAAS,qBAAqB,CAAC,IAAmB;IAChD,MAAM,SAAS,GAAG,yBAAyB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC7D,MAAM,kBAAkB,GAAG,2BAA2B,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IACjF,OAAO;QACL,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,KAAK;QAC3B,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,IAAI;QACtC,eAAe,EAAE,IAAI,EAAE,eAAe,IAAI,IAAI;QAC9C,iBAAiB,EAAE,IAAI,EAAE,iBAAiB,IAAI,KAAK;QACnD,wBAAwB,EAAE,2BAA2B,CAAC,IAAI,EAAE,MAAM,CAAC;QACnE,yBAAyB,EAAE,4BAA4B,EAAE;QACzD,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAmB;IACvD,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAe;IAC5C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QAClD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrB,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,CAAC;IACD,GAAG,CAAC,IAAI,EAAE,CAAC;IACX,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,iBAAiB,CAAC,CAAoB,EAAE,CAAoB;IACnE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,+BAA+B,CACtC,CAAoC,EACpC,CAAoC;IAEpC,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAChD,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAChD,IAAI,WAAW,CAAC,YAAY,KAAK,WAAW,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IACxE,IAAI,WAAW,CAAC,QAAQ,KAAK,WAAW,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChE,IAAI,WAAW,CAAC,aAAa,KAAK,WAAW,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC;IAC1E,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,YAAY,IAAI,EAAE,EAAE,WAAW,CAAC,YAAY,IAAI,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IACrG,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,WAAW,IAAI,EAAE,EAAE,WAAW,CAAC,WAAW,IAAI,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IACnG,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,iCAAiC,CACxC,CAAqC,EACrC,CAAqC;IAErC,MAAM,WAAW,GAAG,2BAA2B,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,MAAM,WAAW,GAAG,2BAA2B,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACpG,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,WAAW,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,YAA8C,EAC9C,WAAqC;IAErC,IAAI,CAAC,YAAY;QAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,kBAAkB,GAAG,6BAA6B,CAAC,YAAY,CAAC,CAAC;IACvE,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,kBAAkB,CAAC,KAAK,KAAK,iBAAiB,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9E,IAAI,kBAAkB,CAAC,WAAW,KAAK,iBAAiB,CAAC,WAAW,EAAE,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,kBAAkB,CAAC,eAAe,KAAK,iBAAiB,CAAC,eAAe,EAAE,CAAC;QAC7E,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,kBAAkB,CAAC,iBAAiB,KAAK,iBAAiB,CAAC,iBAAiB,EAAE,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,kBAAkB,CAAC,wBAAwB,KAAK,iBAAiB,CAAC,wBAAwB,EAAE,CAAC;QAC/F,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,kBAAkB,CAAC,yBAAyB,KAAK,iBAAiB,CAAC,yBAAyB,EAAE,CAAC;QACjG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC,+BAA+B,CAAC,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;QAChG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,CAAC,iCAAiC,CAAC,kBAAkB,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACpH,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAwB;IAC5D,MAAM,eAAe,GAAG,wBAAwB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IACxE,MAAM,0BAA0B,GAAG,qBAAqB,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAAC;IAC3F,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI;QAClB,GAAG,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,0BAA0B,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,kBAAkB,EAAE,CAAC,CAAC,IAAI,EAAE,kBAAkB;QAC9C,uBAAuB,EAAE,CAAC,CAAC,IAAI,EAAE,uBAAuB;QACxD,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,CAAqB,EAAE,CAAqB;IAC5E,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3B,MAAM,WAAW,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC7C,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5D,IAAI,CAAC,CAAC,WAAW,CAAC,kBAAkB,KAAK,CAAC,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC;QAC1E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC,CAAC,WAAW,CAAC,uBAAuB,KAAK,CAAC,CAAC,WAAW,CAAC,uBAAuB,EAAE,CAAC;QACpF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,0BAA0B,IAAI,EAAE,EAAE,WAAW,CAAC,0BAA0B,IAAI,EAAE,CAAC,EAAE,CAAC;QACnH,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,eAAe,IAAI,EAAE,EAAE,WAAW,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE,CAAC;QAC7F,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/indexer/build-cache/project-snapshot.d.ts

@@ -0,0 +1,30 @@
+import { BloomFilterCache } from "../../util/bloomFilter.js";
+import type { BackendReport, BuildOptions, GraphReport, ProjectIndex } from "../types.js";
+import { type SymbolGraph } from "../../graphs/symbol-graph.js";
+import type { ManifestFileEntry } from "./manifest.js";
+type SnapshotAnalysisReport = {
+    backend?: BackendReport;
+    graph?: GraphReport;
+};
+export type LoadedProjectIndexSnapshot = {
+    index: ProjectIndex;
+    analysisReport?: SnapshotAnalysisReport;
+};
+export declare function projectSnapshotFilesSignature(entries: ReadonlyMap<string, ManifestFileEntry>): string;
+export declare function createProjectSnapshotIdentity(filesSignature: string, opts: BuildOptions | undefined): string;
+export declare function tryLoadProjectIndexSnapshot(projectRoot: string, opts: BuildOptions | undefined, manifestEntries: ReadonlyMap<string, ManifestFileEntry>): Promise<LoadedProjectIndexSnapshot | null>;
+/**
+ * Load only the bloom-filter section of the last-written project snapshot, without requiring
+ * the whole snapshot to match this build's files signature or native runtime fingerprint.
+ * Bloom filters are a pure function of a file's text, so a filter persisted for a given file
+ * is safe to reuse after its snapshot's root and implementation fingerprints are validated.
+ * Only the bloom section is then read, so a corrupt payload is rejected without walking
+ * `graph.edges` / `modules`. Returns `null` when disk caching is off, `useBloomFilters` is
+ * disabled, or no valid snapshot with bloom data exists.
+ */
+export declare function tryLoadPersistedBloomFilters(projectRoot: string, opts: BuildOptions | undefined): Promise<BloomFilterCache | null>;
+export declare function writeProjectIndexSnapshot(projectRoot: string, opts: BuildOptions | undefined, index: ProjectIndex, filesSignature: string): Promise<void>;
+export declare function tryLoadDetailedSymbolGraphSnapshot(projectRoot: string, opts: BuildOptions | undefined, index: ProjectIndex): Promise<SymbolGraph | null>;
+export declare function writeDetailedSymbolGraphSnapshot(projectRoot: string, opts: BuildOptions | undefined, index: ProjectIndex, graph: SymbolGraph): Promise<void>;
+export {};
+//# sourceMappingURL=project-snapshot.d.ts.map

package/dist/indexer/build-cache/project-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-snapshot.d.ts","sourceRoot":"","sources":["../../../src/indexer/build-cache/project-snapshot.ts"],"names":[],"mappings":"AAQA,OAAO,EAAe,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAM1E,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EAEZ,WAAW,EAGX,YAAY,EAEb,MAAM,aAAa,CAAC;AACrB,OAAO,EAGL,KAAK,WAAW,EAIjB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAqDvD,KAAK,sBAAsB,GAAG;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,KAAK,EAAE,YAAY,CAAC;IACpB,cAAc,CAAC,EAAE,sBAAsB,CAAC;CACzC,CAAC;AAoBF,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,MAAM,CAarG;AACD,wBAAgB,6BAA6B,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,CAY5G;AA2ID,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACtD,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAqD5C;AAED;;;;;;;;GAQG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,YAAY,GAAG,SAAS,GAC7B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAUlC;AAqBD,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,KAAK,EAAE,YAAY,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CA0Cf;AAMD,wBAAsB,kCAAkC,CACtD,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAuC7B;AAED,wBAAsB,gCAAgC,CACpD,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAgCf"}