codegraph-java 0.1.0

package/dist/extraction/kernel/index.js.map

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

package/dist/extraction/kernel/layout.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Native-kernel buffer layout — TS mirror of codegraph-kernel/src/buffers.rs.
+ *
+ * The kernel returns five Buffers per file: meta, nodes, edges, refs, arena.
+ * Rows are fixed-width little-endian; strings are (offset, len) pairs into
+ * the UTF-8 arena; `offset === NONE` means "field absent".
+ *
+ * THIS FILE AND buffers.rs MUST MATCH BYTE FOR BYTE. Any layout change bumps
+ * KERNEL_ABI_VERSION on both sides — the loader refuses a version it doesn't
+ * know and the extraction path falls back to wasm.
+ *
+ * NodeKind / EdgeKind / provenance / visibility cross the boundary as indexes
+ * into NODE_KINDS / EDGE_KINDS (src/types.ts) and the small tables below, so
+ * those array orders are part of the contract (append, never reorder). The
+ * loader additionally verifies the kernel's own kind tables against
+ * NODE_KINDS/EDGE_KINDS at load time, so a stale .node degrades to the wasm
+ * path instead of mis-decoding.
+ */
+export declare const KERNEL_ABI_VERSION = 2;
+/** Sentinel for "absent" in u32 slots and string-ref offsets. */
+export declare const NONE = 4294967295;
+export declare const META_SIZE = 36;
+export declare const NODE_ROW_SIZE = 96;
+export declare const EDGE_ROW_SIZE = 44;
+export declare const REF_ROW_SIZE = 40;
+/** meta byte offsets */
+export declare const META: {
+    readonly version: 0;
+    readonly nodeCount: 4;
+    readonly edgeCount: 8;
+    readonly refCount: 12;
+    readonly arenaLen: 16;
+    readonly errorsOff: 20;
+    readonly errorsLen: 24;
+    readonly durationMs: 28;
+};
+/** node row byte offsets */
+export declare const NODE: {
+    readonly kind: 0;
+    readonly visibility: 1;
+    readonly flags: 2;
+    readonly startLine: 4;
+    readonly endLine: 8;
+    readonly startColumn: 12;
+    readonly endColumn: 16;
+    readonly name: 20;
+    readonly qualifiedName: 28;
+    readonly id: 36;
+    readonly docstring: 44;
+    readonly signature: 52;
+    readonly decorators: 60;
+    readonly typeParameters: 68;
+    readonly returnType: 76;
+    readonly extraJson: 84;
+    readonly metrics: 92;
+};
+/** edge row byte offsets */
+export declare const EDGE: {
+    readonly sourceIdx: 0;
+    readonly targetIdx: 4;
+    readonly kind: 8;
+    readonly provenance: 9;
+    readonly line: 12;
+    readonly column: 16;
+    readonly metadataJson: 20;
+    readonly sourceIdStr: 28;
+    readonly targetIdStr: 36;
+};
+/** ref row byte offsets */
+export declare const REF: {
+    readonly fromIdx: 0;
+    readonly kind: 4;
+    readonly flags: 5;
+    readonly line: 8;
+    readonly column: 12;
+    readonly referenceName: 16;
+    readonly candidates: 24;
+    readonly fromIdStr: 32;
+};
+/** ReferenceKind wire code for the internal-only `function_ref` (#756). */
+export declare const FUNCTION_REF_CODE = 200;
+/**
+ * Ref-row flag bits (v2). FILE_PATH: the ref carries `filePath` = the
+ * extracted file — the ruby/php visitNode hooks set `filePath: ctx.filePath`
+ * on their mixin/trait `implements` refs (unlike every other extraction ref,
+ * which the store denormalizes); decode re-attaches its own filePath
+ * parameter, which is byte-identical.
+ */
+export declare const REF_FLAG_FILE_PATH = 1;
+/** Node bool-flag bit pairs: bit(2n) = present, bit(2n+1) = value. */
+export declare const FLAG: {
+    readonly isExported: 0;
+    readonly isAsync: 1;
+    readonly isStatic: 2;
+    readonly isAbstract: 3;
+};
+/** visibility byte values (0 = absent). */
+export declare const VISIBILITIES: readonly [undefined, "public", "private", "protected", "internal"];
+/** provenance byte values (0 = absent). */
+export declare const PROVENANCES: readonly [undefined, "tree-sitter", "scip", "heuristic"];
+//# sourceMappingURL=layout.d.ts.map

package/dist/extraction/kernel/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/extraction/kernel/layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,iEAAiE;AACjE,eAAO,MAAM,IAAI,aAAa,CAAC;AAE/B,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B,wBAAwB;AACxB,eAAO,MAAM,IAAI;;;;;;;;;CASP,CAAC;AAEX,4BAA4B;AAC5B,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;CAkBP,CAAC;AAEX,4BAA4B;AAC5B,eAAO,MAAM,IAAI;;;;;;;;;;CAUP,CAAC;AAEX,2BAA2B;AAC3B,eAAO,MAAM,GAAG;;;;;;;;;CASN,CAAC;AAEX,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,sEAAsE;AACtE,eAAO,MAAM,IAAI;;;;;CAKP,CAAC;AAEX,2CAA2C;AAC3C,eAAO,MAAM,YAAY,oEAAqE,CAAC;AAE/F,2CAA2C;AAC3C,eAAO,MAAM,WAAW,0DAA2D,CAAC"}

package/dist/extraction/kernel/layout.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Native-kernel buffer layout — TS mirror of codegraph-kernel/src/buffers.rs.
+ *
+ * The kernel returns five Buffers per file: meta, nodes, edges, refs, arena.
+ * Rows are fixed-width little-endian; strings are (offset, len) pairs into
+ * the UTF-8 arena; `offset === NONE` means "field absent".
+ *
+ * THIS FILE AND buffers.rs MUST MATCH BYTE FOR BYTE. Any layout change bumps
+ * KERNEL_ABI_VERSION on both sides — the loader refuses a version it doesn't
+ * know and the extraction path falls back to wasm.
+ *
+ * NodeKind / EdgeKind / provenance / visibility cross the boundary as indexes
+ * into NODE_KINDS / EDGE_KINDS (src/types.ts) and the small tables below, so
+ * those array orders are part of the contract (append, never reorder). The
+ * loader additionally verifies the kernel's own kind tables against
+ * NODE_KINDS/EDGE_KINDS at load time, so a stale .node degrades to the wasm
+ * path instead of mis-decoding.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROVENANCES = exports.VISIBILITIES = exports.FLAG = exports.REF_FLAG_FILE_PATH = exports.FUNCTION_REF_CODE = exports.REF = exports.EDGE = exports.NODE = exports.META = exports.REF_ROW_SIZE = exports.EDGE_ROW_SIZE = exports.NODE_ROW_SIZE = exports.META_SIZE = exports.NONE = exports.KERNEL_ABI_VERSION = void 0;
+exports.KERNEL_ABI_VERSION = 2;
+/** Sentinel for "absent" in u32 slots and string-ref offsets. */
+exports.NONE = 0xffffffff;
+exports.META_SIZE = 36;
+exports.NODE_ROW_SIZE = 96;
+exports.EDGE_ROW_SIZE = 44;
+exports.REF_ROW_SIZE = 40;
+/** meta byte offsets */
+exports.META = {
+    version: 0, // u8
+    nodeCount: 4, // u32
+    edgeCount: 8, // u32
+    refCount: 12, // u32
+    arenaLen: 16, // u32
+    errorsOff: 20, // u32 (NONE = no errors)
+    errorsLen: 24, // u32
+    durationMs: 28, // f64 (kernel-side wall; introspection only)
+};
+/** node row byte offsets */
+exports.NODE = {
+    kind: 0, // u8 — NODE_KINDS index
+    visibility: 1, // u8 — VISIBILITIES index (0 = absent)
+    flags: 2, // u16 — (present, value) bit pairs, see FLAG
+    startLine: 4, // u32
+    endLine: 8, // u32
+    startColumn: 12, // u32
+    endColumn: 16, // u32
+    name: 20, // str
+    qualifiedName: 28, // str
+    id: 36, // str — kernel-computed node id
+    docstring: 44, // str
+    signature: 52, // str
+    decorators: 60, // str — NUL-joined list
+    typeParameters: 68, // str — NUL-joined list
+    returnType: 76, // str
+    extraJson: 84, // str — JSON of any extra Node props (escape hatch)
+    metrics: 92, // u32 — reserved (Arc 3.2 per-node code metrics)
+};
+/** edge row byte offsets */
+exports.EDGE = {
+    sourceIdx: 0, // u32 (NONE → sourceIdStr)
+    targetIdx: 4, // u32 (NONE → targetIdStr)
+    kind: 8, // u8 — EDGE_KINDS index
+    provenance: 9, // u8 — PROVENANCES index (0 = absent)
+    line: 12, // u32 (NONE = absent)
+    column: 16, // u32 (NONE = absent)
+    metadataJson: 20, // str
+    sourceIdStr: 28, // str
+    targetIdStr: 36, // str
+};
+/** ref row byte offsets */
+exports.REF = {
+    fromIdx: 0, // u32 (NONE → fromIdStr)
+    kind: 4, // u8 — EDGE_KINDS index, or FUNCTION_REF_CODE
+    flags: 5, // u8 — REF_FLAGS bits (v2)
+    line: 8, // u32
+    column: 12, // u32
+    referenceName: 16, // str
+    candidates: 24, // str — NUL-joined list
+    fromIdStr: 32, // str
+};
+/** ReferenceKind wire code for the internal-only `function_ref` (#756). */
+exports.FUNCTION_REF_CODE = 200;
+/**
+ * Ref-row flag bits (v2). FILE_PATH: the ref carries `filePath` = the
+ * extracted file — the ruby/php visitNode hooks set `filePath: ctx.filePath`
+ * on their mixin/trait `implements` refs (unlike every other extraction ref,
+ * which the store denormalizes); decode re-attaches its own filePath
+ * parameter, which is byte-identical.
+ */
+exports.REF_FLAG_FILE_PATH = 1;
+/** Node bool-flag bit pairs: bit(2n) = present, bit(2n+1) = value. */
+exports.FLAG = {
+    isExported: 0,
+    isAsync: 1,
+    isStatic: 2,
+    isAbstract: 3,
+};
+/** visibility byte values (0 = absent). */
+exports.VISIBILITIES = [undefined, 'public', 'private', 'protected', 'internal'];
+/** provenance byte values (0 = absent). */
+exports.PROVENANCES = [undefined, 'tree-sitter', 'scip', 'heuristic'];
+//# sourceMappingURL=layout.js.map

package/dist/extraction/kernel/layout.js.map

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

package/dist/extraction/kernel/loader.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Native-kernel loader — finds, loads, and contract-verifies the
+ * codegraph-kernel .node addon.
+ *
+ * The kernel is OPTIONAL everywhere. Every failure mode here (no binary for
+ * this platform, dlopen error, ABI/kind-table mismatch) resolves to `null`
+ * and the extraction path silently keeps using the wasm pipeline — a missing
+ * or stale kernel must never break indexing, only skip the speedup. Set
+ * CODEGRAPH_KERNEL_DEBUG=1 to see why a kernel didn't load.
+ *
+ * Kill switch: CODEGRAPH_KERNEL=0 disables the kernel entirely (checked per
+ * call so tests and embedders can flip it at runtime).
+ *
+ * Search order:
+ *   1. CODEGRAPH_KERNEL_PATH — explicit .node path (dev/testing override)
+ *   2. <up3>/kernel/codegraph-kernel.node — the release bundle layout
+ *      (lib/dist/** next to lib/kernel/; see scripts/build-bundle.sh)
+ *   3. <up3>/codegraph-kernel/prebuilds/<platform>-<arch>/codegraph-kernel.node
+ *      — from-source runs and tests (staged by scripts/build-kernel.sh)
+ *
+ * "up3" = three directories above this file, which is the package root both
+ * from src/extraction/kernel/ and from dist/extraction/kernel/.
+ */
+/** Raw buffer tables for one file — see layout.ts for the byte layout. */
+export interface KernelBuffers {
+    meta: Buffer;
+    nodes: Buffer;
+    edges: Buffer;
+    refs: Buffer;
+    arena: Buffer;
+}
+export interface KernelContractInfo {
+    abiVersion: number;
+    kernelVersion: string;
+    nodeKinds: string[];
+    edgeKinds: string[];
+    languages: string[];
+}
+export interface KernelGrammarInfo {
+    abiVersion: number;
+    nodeKindCount: number;
+    fieldCount: number;
+    nodeKinds: string[];
+    fieldNames: string[];
+}
+/** Input to the cFnPtr extraction sweep: one file's raw text + its struct
+ *  node extents (`endLine ?? startLine` applied by the caller). */
+export interface CfnptrFileIn {
+    text: string;
+    structs: {
+        id: string;
+        startLine: number;
+        endLine: number;
+    }[];
+}
+/** Per-file facts from the native cFnPtr extraction sweep — mirror of the
+ *  Rust `CfnptrFacts` (see codegraph-kernel/src/cfnptr.rs); semantics match
+ *  the JS sweep in src/resolution/c-fnptr-synthesizer.ts. */
+export interface CfnptrFactsOut {
+    fnPtrTypedefs: string[];
+    fnTypeTypedefs: string[];
+    structs: {
+        id: string;
+        parsed: boolean;
+        fields: {
+            name: string;
+            index: number;
+            ptr: boolean;
+            type: string;
+        }[];
+    }[];
+    inlinePtr: boolean;
+    inlineTypes: string[];
+    inlineTags: string[];
+    initTokens: string[];
+    arrayElems: string[];
+    aliasNames: string[];
+    dPairs: string[];
+    dispatchFields: string[];
+    arrayDispatchNames: string[];
+    includes: string[];
+}
+export interface KernelModule {
+    extractFile(filePath: string, content: string, language: string): KernelBuffers;
+    contractInfo(): KernelContractInfo;
+    grammarInfo(language: string): KernelGrammarInfo | null;
+    /** Batched cFnPtr extraction sweep (task #5 step 2). OPTIONAL: absent on
+     *  older binaries — callers feature-detect and keep their JS path. */
+    cfnptrScanFiles?(files: CfnptrFileIn[]): CfnptrFactsOut[];
+    /** Native `stripCommentsForRegex(text, 'c')` — differential-oracle hook. */
+    cfnptrStripC?(text: string): string;
+}
+/**
+ * Load (once per process) and return the kernel module, or null when
+ * unavailable. The kill switch is NOT checked here — callers route through
+ * `kernelAvailable()` / `tryKernelExtract()` which check it per call.
+ */
+export declare function getKernel(): KernelModule | null;
+/** True when the kill switch is off, a verified binary is loaded, and it supports `language`. */
+export declare function kernelSupports(language: string): boolean;
+/** Test hook: forget the loaded module so a changed env is re-evaluated. */
+export declare function resetKernelForTests(): void;
+//# sourceMappingURL=loader.d.ts.map

package/dist/extraction/kernel/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/extraction/kernel/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAQH,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;mEACmE;AACnE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/D;AAED;;6DAE6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,OAAO,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,EAAE,CAAC;IAClH,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC;IAChF,YAAY,IAAI,kBAAkB,CAAC;IACnC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAAC;IACxD;0EACsE;IACtE,eAAe,CAAC,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,cAAc,EAAE,CAAC;IAC1D,4EAA4E;IAC5E,YAAY,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACrC;AAgDD;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,YAAY,GAAG,IAAI,CAuB/C;AAED,iGAAiG;AACjG,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C"}

package/dist/extraction/kernel/loader.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * Native-kernel loader — finds, loads, and contract-verifies the
+ * codegraph-kernel .node addon.
+ *
+ * The kernel is OPTIONAL everywhere. Every failure mode here (no binary for
+ * this platform, dlopen error, ABI/kind-table mismatch) resolves to `null`
+ * and the extraction path silently keeps using the wasm pipeline — a missing
+ * or stale kernel must never break indexing, only skip the speedup. Set
+ * CODEGRAPH_KERNEL_DEBUG=1 to see why a kernel didn't load.
+ *
+ * Kill switch: CODEGRAPH_KERNEL=0 disables the kernel entirely (checked per
+ * call so tests and embedders can flip it at runtime).
+ *
+ * Search order:
+ *   1. CODEGRAPH_KERNEL_PATH — explicit .node path (dev/testing override)
+ *   2. <up3>/kernel/codegraph-kernel.node — the release bundle layout
+ *      (lib/dist/** next to lib/kernel/; see scripts/build-bundle.sh)
+ *   3. <up3>/codegraph-kernel/prebuilds/<platform>-<arch>/codegraph-kernel.node
+ *      — from-source runs and tests (staged by scripts/build-kernel.sh)
+ *
+ * "up3" = three directories above this file, which is the package root both
+ * from src/extraction/kernel/ and from dist/extraction/kernel/.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getKernel = getKernel;
+exports.kernelSupports = kernelSupports;
+exports.resetKernelForTests = resetKernelForTests;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const module_1 = require("module");
+const types_1 = require("../../types");
+const layout_1 = require("./layout");
+const debugEnabled = () => process.env.CODEGRAPH_KERNEL_DEBUG === '1';
+function debug(msg) {
+    if (debugEnabled())
+        process.stderr.write(`[codegraph-kernel] ${msg}\n`);
+}
+/** Languages the loaded binary supports (contract-verified). Empty when no kernel. */
+let kernelLanguages = new Set();
+/** undefined = not attempted yet; null = attempted and unavailable. */
+let cached;
+function candidatePaths() {
+    const candidates = [];
+    if (process.env.CODEGRAPH_KERNEL_PATH)
+        candidates.push(process.env.CODEGRAPH_KERNEL_PATH);
+    const packageRoot = path.resolve(__dirname, '..', '..', '..');
+    candidates.push(path.join(packageRoot, 'kernel', 'codegraph-kernel.node'));
+    candidates.push(path.join(packageRoot, 'codegraph-kernel', 'prebuilds', `${process.platform}-${process.arch}`, 'codegraph-kernel.node'));
+    return candidates;
+}
+/**
+ * Verify the binary speaks our wire contract: same ABI version and byte-equal
+ * NodeKind/EdgeKind tables (kinds cross the boundary as indexes into these).
+ */
+function verifyContract(mod, from) {
+    const info = mod.contractInfo();
+    if (info.abiVersion !== layout_1.KERNEL_ABI_VERSION) {
+        debug(`${from}: ABI ${info.abiVersion} != expected ${layout_1.KERNEL_ABI_VERSION} — ignoring kernel`);
+        return false;
+    }
+    const sameTable = (a, b) => a.length === b.length && a.every((v, i) => v === b[i]);
+    if (!sameTable(info.nodeKinds, types_1.NODE_KINDS) || !sameTable(info.edgeKinds, types_1.EDGE_KINDS)) {
+        debug(`${from}: NodeKind/EdgeKind tables differ from src/types.ts — ignoring kernel`);
+        return false;
+    }
+    return true;
+}
+/**
+ * Load (once per process) and return the kernel module, or null when
+ * unavailable. The kill switch is NOT checked here — callers route through
+ * `kernelAvailable()` / `tryKernelExtract()` which check it per call.
+ */
+function getKernel() {
+    if (cached !== undefined)
+        return cached;
+    cached = null;
+    for (const candidate of candidatePaths()) {
+        try {
+            if (!fs.existsSync(candidate))
+                continue;
+            // createRequire: works identically from CJS output and future ESM.
+            const req = (0, module_1.createRequire)(__filename);
+            const mod = req(candidate);
+            if (typeof mod.extractFile !== 'function' || typeof mod.contractInfo !== 'function') {
+                debug(`${candidate}: missing expected exports — ignoring`);
+                continue;
+            }
+            if (!verifyContract(mod, candidate))
+                continue;
+            kernelLanguages = new Set(mod.contractInfo().languages);
+            debug(`loaded ${candidate} (languages: ${[...kernelLanguages].join(', ')})`);
+            cached = mod;
+            break;
+        }
+        catch (err) {
+            debug(`${candidate}: failed to load — ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return cached;
+}
+/** True when the kill switch is off, a verified binary is loaded, and it supports `language`. */
+function kernelSupports(language) {
+    if (process.env.CODEGRAPH_KERNEL === '0')
+        return false;
+    return getKernel() !== null && kernelLanguages.has(language);
+}
+/** Test hook: forget the loaded module so a changed env is re-evaluated. */
+function resetKernelForTests() {
+    cached = undefined;
+    kernelLanguages = new Set();
+}
+//# sourceMappingURL=loader.js.map

package/dist/extraction/kernel/loader.js.map

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

package/dist/extraction/languages/c-cpp.d.ts

@@ -0,0 +1,124 @@
+import type { LanguageExtractor } from '../tree-sitter-types';
+/**
+ * Normalize a C++ return type to the bare class name a method could be called
+ * on. Unwraps smart-pointer / optional wrappers to their element type
+ * (`std::unique_ptr<Widget>` → `Widget`) so a factory's `->method()` resolves on
+ * the pointee. Strips cv-qualifiers, `&`/`*`, namespace qualifiers, and other
+ * template args. Returns undefined for primitives / void / `auto` / empty.
+ */
+export declare function normalizeCppReturnType(raw: string): string | undefined;
+/**
+ * Strip C++ template arguments from a base-type reference name so it matches the
+ * bare class/struct the template was DEFINED as. `template<typename T> class
+ * Base { … }` is indexed as a node named `Base`, but a derived class
+ * `class D : public Base<int>` records its base as the full `Base<int>` (and
+ * `class Q : public ns::Tpl<int>` as `ns::Tpl<int>`) — neither name-matches
+ * `Base` / `ns::Tpl`, so the `extends` edge never resolves and the derived class
+ * looks like it inherits from nothing (#1043).
+ *
+ * Removes every balanced `<…>` group regardless of nesting or position, so
+ * `Base<int>` → `Base`, `ns::Tpl<Foo<int>>` → `ns::Tpl`, and the rare
+ * `Outer<int>::Inner` → `Outer::Inner`. The remaining qualified head is exactly
+ * what the non-templated base case already produces, so resolution treats them
+ * identically. A name with no template args passes through unchanged.
+ */
+export declare function stripCppTemplateArgs(name: string): string;
+export declare const cExtractor: LanguageExtractor;
+/**
+ * Blank an export/visibility macro in a `class/struct EXPORT_MACRO Name …`
+ * *definition* header before parsing. Not knowing the macro, tree-sitter reads
+ * `class EXPORT_MACRO` as an elaborated type specifier and the rest as a
+ * function, so the whole class — its name, base clause, and members — drops out
+ * of the index (#946 catches the resulting phantom function but can't recover
+ * the class), which silently breaks type-hierarchy / inheritance-impact queries
+ * for effectively every Unreal-Engine (`*_API`), Qt/Boost (`*_EXPORT`), LLVM
+ * (`*_ABI`), … class. Replacing the macro with equal-length spaces preserves
+ * every byte offset (and thus line/column), so the declaration then parses as a
+ * normal class_specifier and the existing extraction emits the node, members,
+ * and `extends` edge. (#1061, follow-up to #946.)
+ *
+ * Matched tightly so it can't touch the same macro used as an ordinary value
+ * elsewhere (`int x = SOME_API;`): the macro is the ALL-CAPS token sitting
+ * *between* `class`/`struct` and the type name, and the trailing `[:{]`
+ * definition-guard fires only when a base clause or body follows — the only
+ * shape that misparses. That guard also leaves elaborated-type variable
+ * declarations (`struct FOO var;`, `class FOO obj = …`) untouched, since those
+ * end in `;` / `=` / `[`, never `:` / `{`. C++-only (wired into cppExtractor),
+ * so C's heavier use of `struct TAG var;` never reaches it.
+ */
+export declare function blankCppExportMacros(source: string): string;
+export declare function blankCppInlineMacros(source: string): string;
+/**
+ * Universal fallback (any macro, no list) for a C/C++ function name still mangled
+ * because a macro we don't blank sat in front of the return type: `MACRO Ret
+ * name(…)` / `Ret MACRO name(…)` misparse so the return type is glued onto the
+ * name ("Ret name", "char_t* to_str(double v)"). Recover the real identifier —
+ * the token immediately before the parameter list (or the last token). This runs
+ * AFTER the curated pre-parse blank, so it only ever sees the residual tail that
+ * blanking didn't already fix cleanly (which also recovers the return type).
+ *
+ * Safe by construction: only touches an ALREADY-mangled name — one with an
+ * internal space that isn't a legit `operator …`/destructor — so a well-formed
+ * name is returned unchanged. Guarded against the two ways it could mis-pick:
+ * the `Ret (name)` parenthesized-name idiom (left as-is, ambiguous), and a token
+ * that is a bare primitive/keyword rather than a real identifier.
+ */
+export declare function recoverMangledCppName(name: string): string;
+export declare function blankMetalAttributes(source: string): string;
+/**
+ * Blank annotation-style macro invocations that decorate a declaration but carry
+ * NO terminating semicolon — the pervasive Unreal-Engine reflection markup
+ * (`UPROPERTY(...)`, `UFUNCTION(...)`, `UCLASS(...)`, `GENERATED_BODY()`,
+ * `UE_DEPRECATED_FORGAME(...)`, `DECLARE_DELEGATE_*(...)`, …) that sits on its
+ * own line right before a member/type. tree-sitter's C++ grammar doesn't know
+ * these are macros, so each one drops into error recovery; in a big reflected
+ * class (`CharacterMovementComponent.h` has ~240 of them) the errors accumulate
+ * until the enclosing `class_specifier` can't close and collapses into an ERROR
+ * node — the whole class definition, its members, and its `extends` edges vanish
+ * from the graph. Neither `blankCppExportMacros` (class-header export macros) nor
+ * `blankCppInlineMacros` (return-type inline specifiers) touches these in-body
+ * markup macros. Replacing each with equal-length spaces preserves every byte
+ * offset (so line/column stay exact) and the class then parses normally.
+ *
+ * Deliberately name-list-FREE — UE alone has hundreds of such macros and projects
+ * add their own — so it keys on structure, not a curated list, matched tightly to
+ * avoid touching legitimate C++:
+ *  - the macro must be the FIRST non-whitespace token on its line (`^[ \t]*`),
+ *    which is where declaration markup lives — so a macro used inside an
+ *    expression or condition (`if (CHECK(x))`, `x = MACRO(a) + b`) is never
+ *    matched (it isn't line-leading);
+ *  - the name must be ALL-CAPS (`[A-Z][A-Z0-9_]{2,}`), since ordinary
+ *    function/type names called at line start are lower/mixed case;
+ *  - the char after the balanced `(...)` must START A DECLARATION — a letter,
+ *    `_`, `~` (destructor), or `#` (a following directive). Declaration markup is
+ *    always followed by the thing it decorates (`UPROPERTY(...)\n float X;`,
+ *    `UE_DEPRECATED(...) UPROPERTY(...)`), whereas a statement call is followed by
+ *    `;` (`FOO(x);`), an init-list item by `,`/`{`, and an expression fragment by
+ *    an operator (`MAKE(a) + 1`) — all rejected. String/char literals inside the
+ *    args are skipped so an embedded `)` can't mis-close the balance.
+ *
+ * C++-only (wired into cppExtractor). A blanked macro inside a block comment is
+ * harmless (comments don't parse), and the rare line-leading no-semicolon
+ * ALL-CAPS call that isn't markup only loses that one annotation, never a whole
+ * class.
+ */
+export declare function blankCppAnnotationMacroCalls(source: string): string;
+export declare function blankLoneMacroLines(source: string): string;
+export declare function blankCppApiPrefixMacros(source: string): string;
+export declare function blankCppInlineAnnotationMacros(source: string): string;
+export declare function blankCudaConstructs(source: string): string;
+export declare function blankCLeadingAttrMacros(source: string): string;
+export declare function blankCCplusplusGuardBodies(source: string): string;
+export declare function blankCStatementMacroCalls(source: string): string;
+export declare function blankCSandwichedAnnotations(source: string): string;
+export declare function blankCAutoInference(source: string): string;
+export declare function blankCTrailingParamAttrMacros(source: string): string;
+export declare function blankCKernelAnnotations(source: string): string;
+export declare function blankCParameterizedAnnotationMacros(source: string): string;
+export declare function blankCTypeKeywordArgs(source: string): string;
+export declare function blankCFileScopePrefixedDeclMacros(source: string): string;
+export declare function rewriteCPrefixedDeclMacroInitializers(source: string): string;
+export declare function blankCVaArgQualifiedTypeArgs(source: string): string;
+export declare function blankCNamedVariadicDefineDots(source: string): string;
+export declare const cppExtractor: LanguageExtractor;
+//# sourceMappingURL=c-cpp.d.ts.map

package/dist/extraction/languages/c-cpp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"c-cpp.d.ts","sourceRoot":"","sources":["../../../src/extraction/languages/c-cpp.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAgH9D;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkBtE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUzD;AAaD,eAAO,MAAM,UAAU,EAAE,iBAiExB,CAAC;AAoCF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAM3D;AA8ED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG3D;AAWD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ1D;AAyBD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAwCnE;AA8BD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA2B1D;AA4BD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG9D;AAuBD,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAiCrE;AAiDD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAmB1D;AAuGD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK9D;AAoCD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAwBjE;AAgCD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAyGhE;AAoBD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQlE;AAWD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1D;AAmBD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUpE;AA+CD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAkB9D;AA8BD,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAwB1E;AAwCD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAsE5D;AAyBD,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqCxE;AAoBD,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAyB5E;AAaD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOnE;AAiBD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAapE;AAwCD,eAAO,MAAM,YAAY,EAAE,iBA+F1B,CAAC"}