@lzehrung/codegraph 2.1.1 → 2.2.0

package/dist/native/runtime.js

@@ -1,17 +1,22 @@
+import fs from "node:fs";
 import path from "node:path";
 import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
 import { stringifyUnknown } from "../util/ast.js";
-import { loadNativeBinding } from "./bindingLoader.js";
+import { currentNativeTargetSuffix, findLocalNativeBinary, loadNativeBinding, nativeTargetSuffixFor, readPlatformPackage, } from "./bindingLoader.js";
+import { lookupNativeRuntimeCacheEntry, recordNativeRuntimeCacheIdentity } from "./runtimeCache.js";
 const require = createRequire(import.meta.url);
 const localNativePackageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../packages/codegraph-native");
 const NATIVE_REQUIRED_ERROR_PREFIX = "native tree-sitter required by explicit option but unavailable";
 let bindingState;
 let loadedRuntimeFingerprint;
 const disabledRuntimeFingerprints = new Map();
+const cachedRuntimeFingerprints = new Map();
+const cachedRuntimeIdentityValidations = new WeakMap();
 export function __resetNativeTreeSitterBindingForTests() {
     bindingState = undefined;
     loadedRuntimeFingerprint = undefined;
+    cachedRuntimeFingerprints.clear();
 }
 export function isNativeTreeSitterDisabledByEnv(env = process.env) {
     const rawValue = env.CODEGRAPH_DISABLE_NATIVE;
@@ -27,6 +32,7 @@ export function normalizeNativeRuntimeMode(mode) {
 export function loadBinding() {
     if (bindingState)
         return bindingState;
+    cachedRuntimeFingerprints.clear();
     const loaded = loadNativeBinding({
         packageName: "@lzehrung/codegraph-native",
         localPackageRoot: localNativePackageRoot,
@@ -34,12 +40,31 @@ export function loadBinding() {
         resolveFn: require.resolve,
     });
     if (loaded.binding) {
+        const supportedLanguageIds = new Set(loaded.binding.supportedLanguageIds());
         bindingState = {
             loaded: true,
             binding: loaded.binding,
-            supportedLanguageIds: new Set(loaded.binding.supportedLanguageIds()),
+            supportedLanguageIds,
             origin: loaded.origin,
         };
+        // Now, and only now, every fact a later process needs to skip this work is known: the files
+        // were hashed and verified, the addon loaded, and it reported its languages. Recording only
+        // a verified load keeps the re-verification TTL honest - a fast-path hit must not renew it.
+        if (loaded.cacheEntry?.verified) {
+            recordNativeRuntimeCacheIdentity({
+                sourcePath: loaded.cacheEntry.sourcePath,
+                loadedPath: loaded.cacheEntry.loadedPath,
+                cacheKey: loaded.cacheEntry.cacheKey,
+                sha256: loaded.cacheEntry.sha256,
+                sourceSize: loaded.cacheEntry.sourceSize,
+                sourceMtimeMs: loaded.cacheEntry.sourceMtimeMs,
+                cachedSize: loaded.cacheEntry.cachedSize,
+                cachedMtimeMs: loaded.cacheEntry.cachedMtimeMs,
+                verifiedAt: new Date().toISOString(),
+                supportedLanguageIds: Array.from(supportedLanguageIds).sort(),
+                origin: loaded.origin,
+            });
+        }
         return bindingState;
     }
     bindingState = {
@@ -65,14 +90,48 @@ export function resolveNativeBindingState(mode, env = process.env) {
     }
     return loadBinding();
 }
-function serializeNativeRuntimeFingerprint(requestedMode, envDisabled, state) {
-    const supportedLanguageIds = state.loaded ? Array.from(state.supportedLanguageIds).sort() : [];
-    const origin = state.origin;
+function identityFromState(state) {
+    return {
+        available: state.loaded,
+        supportedLanguageIds: state.loaded ? Array.from(state.supportedLanguageIds).sort() : [],
+        origin: state.origin,
+    };
+}
+function cacheFingerprintFilesMatch(validation) {
+    try {
+        const sourcePath = fs.realpathSync.native(validation.sourcePath);
+        if (sourcePath !== validation.sourcePath)
+            return false;
+        const sourceStats = fs.statSync(sourcePath);
+        if (!sourceStats.isFile() ||
+            sourceStats.size !== validation.sourceSize ||
+            sourceStats.mtimeMs !== validation.sourceMtimeMs) {
+            return false;
+        }
+        const loadedPath = fs.realpathSync.native(validation.loadedPath);
+        if (loadedPath !== validation.loadedPath)
+            return false;
+        const cachedStats = fs.lstatSync(loadedPath);
+        return (cachedStats.isFile() &&
+            !cachedStats.isSymbolicLink() &&
+            cachedStats.size === validation.cachedSize &&
+            cachedStats.mtimeMs === validation.cachedMtimeMs);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Takes the binding-derived facts rather than a NativeBindingState, because the cache fast path
+ * below reconstructs those facts from a recorded identity and has no binding to hand.
+ */
+export function serializeNativeRuntimeFingerprint(requestedMode, envDisabled, identity) {
+    const { available, supportedLanguageIds, origin } = identity;
     return JSON.stringify({
         version: 1,
         requestedMode,
         envDisabled,
-        available: state.loaded,
+        available,
         supportedLanguageIds,
         ...(origin
             ? {
@@ -90,6 +149,52 @@ function serializeNativeRuntimeFingerprint(requestedMode, envDisabled, state) {
             : {}),
     });
 }
+export function resolveCachedRuntimeIdentity(options = {}) {
+    // A workspace binary wins in loadNativeBinding, so its fingerprint must not be answered from
+    // a cache entry describing the installed package.
+    if (findLocalNativeBinary(options.localPackageRoot ?? localNativePackageRoot))
+        return undefined;
+    if ((options.platform ?? process.platform) !== "win32")
+        return undefined;
+    // currentNativeTargetSuffix reads the real process; when a platform is injected the suffix has
+    // to be derived from it, or a Linux test box would look for its own target under a win32 root.
+    const target = options.platform
+        ? nativeTargetSuffixFor(options.platform, options.arch ?? process.arch)
+        : currentNativeTargetSuffix();
+    if (!target)
+        return undefined;
+    try {
+        const platformPackage = readPlatformPackage("@lzehrung/codegraph-native", target, options.resolveFn ?? require.resolve);
+        const hit = lookupNativeRuntimeCacheEntry({
+            sourcePath: platformPackage.sourcePath,
+            packageName: `@lzehrung/codegraph-native-${target}`,
+            packageVersion: platformPackage.packageVersion,
+            target,
+            ...(options.cacheRoot !== undefined ? { cacheRoot: options.cacheRoot } : {}),
+            ...(options.now !== undefined ? { now: options.now } : {}),
+        });
+        if (!hit)
+            return undefined;
+        const identity = {
+            available: true,
+            supportedLanguageIds: hit.identity.supportedLanguageIds,
+            origin: hit.identity.origin,
+            cacheIdentityRevalidateAt: hit.revalidateAt,
+        };
+        cachedRuntimeIdentityValidations.set(identity, {
+            sourcePath: hit.identity.sourcePath,
+            sourceSize: hit.identity.sourceSize,
+            sourceMtimeMs: hit.identity.sourceMtimeMs,
+            loadedPath: hit.identity.loadedPath,
+            cachedSize: hit.identity.cachedSize,
+            cachedMtimeMs: hit.identity.cachedMtimeMs,
+        });
+        return identity;
+    }
+    catch {
+        return undefined;
+    }
+}
 export function getNativeRuntimeFingerprint(mode, env = process.env) {
     const requestedMode = normalizeNativeRuntimeMode(mode);
     const envDisabled = isNativeTreeSitterDisabledByEnv(env);
@@ -99,17 +204,42 @@ export function getNativeRuntimeFingerprint(mode, env = process.env) {
         const cached = disabledRuntimeFingerprints.get(key);
         if (cached)
             return cached;
-        const fingerprint = serializeNativeRuntimeFingerprint(requestedMode, envDisabled, resolveNativeBindingState(mode, env));
+        const fingerprint = serializeNativeRuntimeFingerprint(requestedMode, envDisabled, identityFromState(resolveNativeBindingState(mode, env)));
         disabledRuntimeFingerprints.set(key, fingerprint);
         return fingerprint;
     }
+    // A cached identity is valid only while its current source and cache stats match and its
+    // re-verification window has not elapsed. Recheck it on every fingerprint request; the probe
+    // stays cheap (one directory read and two stats) and avoids extending stat-only trust.
+    if (!bindingState) {
+        const cacheKey = `${requestedMode}:${envDisabled}`;
+        const now = Date.now();
+        const memoized = cachedRuntimeFingerprints.get(cacheKey);
+        if (memoized && now < memoized.revalidateAt && cacheFingerprintFilesMatch(memoized.validation)) {
+            return memoized.value;
+        }
+        const cachedIdentity = resolveCachedRuntimeIdentity();
+        const validation = cachedIdentity ? cachedRuntimeIdentityValidations.get(cachedIdentity) : undefined;
+        if (cachedIdentity?.cacheIdentityRevalidateAt !== undefined &&
+            validation &&
+            cacheFingerprintFilesMatch(validation)) {
+            const value = serializeNativeRuntimeFingerprint(requestedMode, envDisabled, cachedIdentity);
+            cachedRuntimeFingerprints.set(cacheKey, {
+                value,
+                revalidateAt: cachedIdentity.cacheIdentityRevalidateAt,
+                validation,
+            });
+            return value;
+        }
+        cachedRuntimeFingerprints.delete(cacheKey);
+    }
     const state = loadBinding();
     if (loadedRuntimeFingerprint?.state === state &&
         loadedRuntimeFingerprint.requestedMode === requestedMode &&
         loadedRuntimeFingerprint.envDisabled === envDisabled) {
         return loadedRuntimeFingerprint.value;
     }
-    const value = serializeNativeRuntimeFingerprint(requestedMode, envDisabled, state);
+    const value = serializeNativeRuntimeFingerprint(requestedMode, envDisabled, identityFromState(state));
     loadedRuntimeFingerprint = { state, requestedMode, envDisabled, value };
     return value;
 }
@@ -126,6 +256,19 @@ export function getNativeBindingOrigin() {
 export function getCurrentNativeBindingOrigin() {
     return bindingState?.origin;
 }
+/**
+ * The resolved addon path for a binding this process has already loaded, for handing to worker
+ * threads. Undefined unless a load succeeded, so a worker is never pointed at a path that did
+ * not work here.
+ */
+export function getNativeWorkerBindingHandoff() {
+    if (!bindingState?.loaded)
+        return undefined;
+    const loadedPath = bindingState.origin.loadedPath;
+    if (!loadedPath)
+        return undefined;
+    return { loadedPath, origin: bindingState.origin };
+}
 export function getNativeTreeSitterSupportedLanguageIds(mode) {
     const state = resolveNativeBindingState(mode);
     return state.loaded ? Array.from(state.supportedLanguageIds).sort() : [];

package/dist/native/runtime.js.map

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

package/dist/native/runtimeCache.d.ts

@@ -1,3 +1,4 @@
+import type { NativeBindingOrigin } from "./contracts.js";
 export type NativeCacheManifestV1 = {
     schemaVersion: 1;
     packageName: string;
@@ -8,12 +9,57 @@ export type NativeCacheManifestV1 = {
     sourceSha256: string;
     cachedAt: string;
 };
+/**
+ * Written as a path-keyed record beside `manifest.json` after a process has successfully
+ * loaded the cached binary. `manifest.json` is content-addressed and published once,
+ * immutably; these records are mutable (the TTL refreshes them) and carry facts that only exist
+ * after the addon loads. One record per source realpath lets projects sharing the binary retain
+ * their own origin without invalidating each other's fast path.
+ */
+export type NativeCacheIdentityV1 = {
+    version: 1;
+    /** Size and mtime of the installed source binary at the last full verification. */
+    sourceSize: number;
+    sourceMtimeMs: number;
+    /** Size and mtime of the cached copy that was verified and then loaded. */
+    cachedSize: number;
+    cachedMtimeMs: number;
+    sha256: string;
+    cacheKey: string;
+    sourcePath: string;
+    loadedPath: string;
+    verifiedAt: string;
+    /**
+     * The runtime that proved this file loadable. The stat fields say the bytes are unchanged;
+     * they say nothing about whether this Node can still load them. A major Node upgrade changes
+     * the ABI, so the same bytes stop loading while every other check still matches, and the fast
+     * path would report an addon as available that the build then falls back away from.
+     */
+    runtime: {
+        abi: string;
+        platform: string;
+        arch: string;
+    };
+    /**
+     * Recorded so a cache-hit command can answer "which languages does the addon support"
+     * without loading it. Present only once a load has succeeded for this exact file.
+     */
+    supportedLanguageIds: string[];
+    /**
+     * The origin the loading process reported, stored whole rather than rebuilt field by field.
+     * The runtime fingerprint embeds this object verbatim, so replaying it is what guarantees a
+     * fast-path fingerprint is byte-identical to the one a full load produces.
+     */
+    origin: NativeBindingOrigin;
+};
 export type PrepareNativeRuntimeCacheRequest = {
     sourcePath: string;
     packageName: string;
     packageVersion: string;
     target: string;
     cacheRoot?: string | undefined;
+    /** Injected in tests so the identity TTL branch is reachable without waiting a day. */
+    now?: number | undefined;
 };
 export type PrepareNativeRuntimeCacheResult = {
     status: "cached" | "reused";
@@ -21,6 +67,17 @@ export type PrepareNativeRuntimeCacheResult = {
     loadedPath: string;
     cacheKey: string;
     sha256: string;
+    /** Verified stat snapshots used to reject a source/cache replacement before identity recording. */
+    sourceSize: number;
+    sourceMtimeMs: number;
+    cachedSize: number;
+    cachedMtimeMs: number;
+    /**
+     * True when this call hashed the files rather than trusting a recorded identity. Only a
+     * verified result may refresh the identity record, otherwise each fast-path hit would
+     * push the re-verification TTL out and the entry would never be hashed again.
+     */
+    verified: boolean;
 } | {
     status: "unavailable";
     sourcePath: string;
@@ -29,8 +86,43 @@ export type PrepareNativeRuntimeCacheResult = {
 type FileHash = {
     sha256: string;
     size: number;
+    mtimeMs: number;
 };
 export declare function hashFileStreaming(filePath: string, onChunk?: (bytesRead: number) => void): FileHash;
+export type NativeCacheLookupRequest = {
+    sourcePath: string;
+    packageName: string;
+    packageVersion: string;
+    target: string;
+    cacheRoot?: string | undefined;
+    /** Injected in tests so the TTL branch is reachable without waiting a day. */
+    now?: number | undefined;
+};
+export type NativeCacheLookupHit = {
+    entryPath: string;
+    identity: NativeCacheIdentityV1;
+    revalidateAt: number;
+};
+/**
+ * Find a cache entry for this (package version, target) whose recorded identity still matches
+ * the files on disk, without hashing either of them.
+ *
+ * The entry directory is named `<packageVersion>-<sha256>`, so locating it the normal way means
+ * hashing the source first. Scanning the target directory for the version prefix and comparing
+ * the stat fields recorded at the last full verification reaches the same entry with bounded
+ * metadata reads. A miss - no entry, no identity file, a stat mismatch, or an expired
+ * TTL - returns null, and every caller then does the full hash-and-verify pass.
+ */
+export declare function lookupNativeRuntimeCacheEntry(request: NativeCacheLookupRequest): NativeCacheLookupHit | null;
+/**
+ * Record what a successful load proved about this entry, so the next process can skip both
+ * SHA-256 passes and the addon load itself. Called only after the binary at `loadedPath` has
+ * been fully verified and then loaded, so every field describes a state known to work.
+ *
+ * Replaces any previous record atomically: the TTL refresh rewrites it, unlike the immutable
+ * `manifest.json` beside it.
+ */
+export declare function recordNativeRuntimeCacheIdentity(identity: Omit<NativeCacheIdentityV1, "version" | "runtime">): void;
 export declare function prepareNativeRuntimeCache(request: PrepareNativeRuntimeCacheRequest): PrepareNativeRuntimeCacheResult;
 export {};
 //# sourceMappingURL=runtimeCache.d.ts.map

package/dist/native/runtimeCache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeCache.d.ts","sourceRoot":"","sources":["../../src/native/runtimeCache.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,qBAAqB,GAAG;IAClC,aAAa,EAAE,CAAC,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,+BAA+B,GACvC;IACE,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEN,KAAK,QAAQ,GAAG;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AA8DF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,QAAQ,CA0BnG;AAgGD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gCAAgC,GAAG,+BAA+B,CAoDpH"}
+{"version":3,"file":"runtimeCache.d.ts","sourceRoot":"","sources":["../../src/native/runtimeCache.ts"],"names":[],"mappings":"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"}