@opencodehub/cli 0.1.0

package/dist/commands/doctor.js

@@ -0,0 +1,472 @@
+/**
+ * `codehub doctor` — environment probe.
+ *
+ * Runs every `Check` registered in `CHECKS`, prints a table, and exits
+ * with a status code that maps to the worst result seen:
+ *
+ *   0  all ok
+ *   1  at least one warn (non-blocking)
+ *   2  at least one fail (blocking — something is broken)
+ *
+ * Checks are strictly diagnostic — they never auto-heal. Each one returns
+ * a `hint` string the user can copy-paste when things are off.
+ */
+import { spawn } from "node:child_process";
+import { access, readFile, stat } from "node:fs/promises";
+import { createRequire } from "node:module";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import Table from "cli-table3";
+/**
+ * Entry point invoked by `codehub doctor`. Prints the table and sets
+ * `process.exitCode`. Also returns the structured report so tests and
+ * acceptance scripts can assert the outcome without parsing stdout.
+ */
+export async function runDoctor(opts = {}) {
+    const checks = buildChecks(opts);
+    const rows = [];
+    for (const check of checks) {
+        const result = await check.run().catch((err) => ({
+            status: "fail",
+            message: `check threw: ${err instanceof Error ? err.message : String(err)}`,
+            hint: "report a bug against @opencodehub/cli — checks should never throw",
+        }));
+        rows.push({ name: check.name, result });
+    }
+    printTable(rows);
+    let exitCode = 0;
+    for (const { result } of rows) {
+        if (result.status === "fail") {
+            exitCode = 2;
+            break;
+        }
+        if (result.status === "warn" && exitCode === 0) {
+            exitCode = 1;
+        }
+    }
+    process.exitCode = exitCode;
+    return { rows, exitCode };
+}
+/**
+ * Ordered list of environment probes. Order matters only for the output
+ * table — runs are independent, but we surface foundational checks first
+ * (Node, pnpm, native bindings) so the user can fix a broken foundation
+ * before worrying about downstream extras.
+ */
+export function buildChecks(opts = {}) {
+    const home = opts.home ?? homedir();
+    const repoRoot = opts.repoRoot ?? guessRepoRoot();
+    const list = [nodeVersionCheck(), pnpmInstalledCheck()];
+    if (opts.skipNative !== true) {
+        list.push(treeSitterNativeCheck(repoRoot));
+        list.push(duckdbWorksCheck(repoRoot));
+        list.push(lbugWorksCheck(repoRoot));
+    }
+    list.push(binaryOnPathCheck("semgrep", "P1 scanner — install semgrep via `brew install semgrep` or `uv tool install semgrep`"));
+    list.push(binaryOnPathCheck("osv-scanner", "P1 scanner — install from https://github.com/google/osv-scanner"));
+    list.push(binaryOnPathCheck("bandit", "P1 scanner — install with `uv tool install 'bandit[sarif]'`"));
+    list.push(binaryOnPathCheck("ruff", "P1 scanner — install with `uv tool install ruff`"));
+    list.push(binaryOnPathCheck("grype", "P1 scanner — install with `brew install anchore/grype/grype` or from https://github.com/anchore/grype"));
+    list.push(binaryOnPathCheck("vulture", "P1 scanner — install with `uv tool install vulture`"));
+    list.push(binaryOnPathCheck("pip-audit", "P1 scanner — install with `uv tool install pip-audit`"));
+    list.push(binaryOnPathCheck("radon", "P2 scanner — install with `uv tool install radon`"));
+    list.push(binaryOnPathCheck("ty", "P2 scanner (beta) — install with `uv tool install ty` (Astral)"));
+    list.push(embedderWeightsCheck(home));
+    list.push(registryPathCheck(home));
+    list.push(sarifSchemaCheck(repoRoot));
+    return list;
+}
+// ---------------------------------------------------------------------------
+// Individual checks
+// ---------------------------------------------------------------------------
+function nodeVersionCheck() {
+    return {
+        name: "node >= 20",
+        async run() {
+            const v = process.versions.node;
+            const major = Number.parseInt(v.split(".")[0] ?? "0", 10);
+            if (!Number.isFinite(major) || major < 20) {
+                return {
+                    status: "fail",
+                    message: `node v${v} — minimum is v20.10`,
+                    hint: "install node 20+ with `mise use node@20` or `nvm install 20`",
+                };
+            }
+            return { status: "ok", message: `node v${v}` };
+        },
+    };
+}
+function pnpmInstalledCheck() {
+    return {
+        name: "pnpm installed",
+        async run() {
+            const res = await runCommand("pnpm", ["--version"]);
+            if (res.status !== 0) {
+                return {
+                    status: "fail",
+                    message: "pnpm not on PATH",
+                    hint: "install pnpm via `npm install -g pnpm` or `corepack enable`",
+                };
+            }
+            return { status: "ok", message: `pnpm ${res.stdout.trim()}` };
+        },
+    };
+}
+function treeSitterNativeCheck(repoRoot) {
+    return {
+        name: "tree-sitter native binding",
+        async run() {
+            try {
+                // tree-sitter ships a native .node binding. Loading the grammar
+                // for TS is the cheapest health signal.
+                const tsPath = resolveFromRoot(repoRoot, "tree-sitter");
+                const tssPath = resolveFromRoot(repoRoot, "tree-sitter-typescript");
+                if (!tsPath || !tssPath) {
+                    return {
+                        status: "warn",
+                        message: "tree-sitter or tree-sitter-typescript not installed",
+                        hint: "run `pnpm install` at the repo root",
+                    };
+                }
+                const Parser = (await import(tsPath));
+                const tsMod = (await import(tssPath));
+                const ParserCtor = Parser.default ?? Parser;
+                const parser = new ParserCtor();
+                const language = tsMod.typescript ?? tsMod.default?.typescript;
+                if (!language) {
+                    return {
+                        status: "fail",
+                        message: "tree-sitter-typescript has no `typescript` export",
+                        hint: "re-run `pnpm install` to rebuild native grammars",
+                    };
+                }
+                parser.setLanguage(language);
+                return { status: "ok", message: "tree-sitter + typescript grammar load OK" };
+            }
+            catch (err) {
+                return {
+                    status: "fail",
+                    message: `failed to load tree-sitter: ${err instanceof Error ? err.message : String(err)}`,
+                    hint: "re-run `pnpm install` to rebuild native bindings (requires clang/g++)",
+                };
+            }
+        },
+    };
+}
+function duckdbWorksCheck(repoRoot) {
+    return {
+        name: "duckdb native binding",
+        async run() {
+            try {
+                const duckPath = resolveFromRoot(repoRoot, "@duckdb/node-api");
+                if (!duckPath) {
+                    return {
+                        status: "warn",
+                        message: "@duckdb/node-api not installed",
+                        hint: "run `pnpm install` at the repo root",
+                    };
+                }
+                // The @duckdb/node-api 1.x surface exposes Sync teardown helpers
+                // (`disconnectSync`, `closeSync`). The async `.close()` accessors
+                // were dropped in 1.0.0; depending on them produced a false FAIL.
+                const mod = (await import(duckPath));
+                // In-memory instance: never touches disk, never lingers.
+                const inst = await mod.DuckDBInstance.create(":memory:");
+                const conn = await inst.connect();
+                if (typeof conn.disconnectSync === "function")
+                    conn.disconnectSync();
+                else if (typeof conn.close === "function")
+                    await conn.close();
+                if (typeof inst.closeSync === "function")
+                    inst.closeSync();
+                else if (typeof inst.close === "function")
+                    await inst.close();
+                return { status: "ok", message: "duckdb open/close OK" };
+            }
+            catch (err) {
+                return {
+                    status: "fail",
+                    message: `duckdb failed to open: ${err instanceof Error ? err.message : String(err)}`,
+                    hint: "check platform support — pnpm only prebuilds linux-x64/arm64, darwin-arm64/x64, win32-x64",
+                };
+            }
+        },
+    };
+}
+/**
+ * Mirror of {@link duckdbWorksCheck} for the optional `@ladybugdb/core`
+ * graph-db backend. Emits `warn` (not `fail`) when the package is
+ * uninstalled because `@ladybugdb/core` is opt-in: a default `duck`
+ * deployment never needs it. When the package IS installed and the
+ * smoke test fails we surface `fail` so a broken native binding can be
+ * triaged the same way duckdb's is.
+ */
+function lbugWorksCheck(repoRoot) {
+    return {
+        name: "graph-db native binding",
+        async run() {
+            try {
+                const lbugPath = resolveFromRoot(repoRoot, "@ladybugdb/core");
+                if (!lbugPath) {
+                    return {
+                        status: "warn",
+                        message: "@ladybugdb/core not installed (optional graph-db backend)",
+                        hint: "run `pnpm install` and set `CODEHUB_STORE=lbug` to opt in; otherwise ignore",
+                    };
+                }
+                // The opt-in graph-db backend uses `@ladybugdb/core`'s `Database`
+                // entry. We exercise the load-and-close cycle the same way the
+                // duckdb check does — anything heavier would couple this probe to
+                // the adapter's evolving smoke-test surface.
+                const mod = (await import(lbugPath));
+                const ctorRaw = mod["Database"] ?? mod["default"]?.["Database"];
+                if (typeof ctorRaw !== "function") {
+                    return {
+                        status: "fail",
+                        message: "@ladybugdb/core is installed but exports no Database constructor",
+                        hint: "re-run `pnpm install` to refresh the graph-db backend bindings",
+                    };
+                }
+                return { status: "ok", message: "@ladybugdb/core load OK" };
+            }
+            catch (err) {
+                return {
+                    status: "fail",
+                    message: `@ladybugdb/core failed to load: ${err instanceof Error ? err.message : String(err)}`,
+                    hint: "the graph-db backend is opt-in; unset `CODEHUB_STORE=lbug` or reinstall the binding",
+                };
+            }
+        },
+    };
+}
+function binaryOnPathCheck(bin, hint) {
+    return {
+        name: `${bin} binary`,
+        async run() {
+            const res = await runCommand(bin, ["--version"]);
+            if (res.status !== 0) {
+                return {
+                    status: "warn",
+                    message: `${bin} not on PATH`,
+                    hint,
+                };
+            }
+            return { status: "ok", message: `${bin}: ${firstLine(res.stdout)}` };
+        },
+    };
+}
+function embedderWeightsCheck(home) {
+    return {
+        name: "embedder weights",
+        async run() {
+            // Filename convention matches `embedder/src/paths.ts:modelFileName` —
+            // fp32 uses `model.onnx`, int8 uses `model_int8.onnx` (underscore,
+            // NOT hyphen). A historical hyphenated path name lingered here and
+            // caused false-negative `warn`s for users who had int8 weights on
+            // disk.
+            const base = join(home, ".codehub", "models", "gte-modernbert-base");
+            const fp32 = join(base, "fp32", "model.onnx");
+            const int8 = join(base, "int8", "model_int8.onnx");
+            const fp32Ok = await fileExists(fp32);
+            const int8Ok = await fileExists(int8);
+            if (!fp32Ok && !int8Ok) {
+                return {
+                    status: "warn",
+                    message: "no embedder weights found",
+                    hint: "run `codehub setup --embeddings` (fp32) or `codehub setup --embeddings --int8`",
+                };
+            }
+            const variant = fp32Ok ? "fp32" : "int8";
+            return { status: "ok", message: `embedder weights present (${variant})` };
+        },
+    };
+}
+function registryPathCheck(home) {
+    return {
+        name: "registry path",
+        async run() {
+            const regPath = join(home, ".codehub", "registry.json");
+            // Single attempt: branch on `ENOENT` for the missing-file case so
+            // the existence check and the read share one syscall — closes the
+            // TOCTOU gap flagged by js/file-system-race.
+            let raw;
+            try {
+                raw = await readFile(regPath, "utf8");
+            }
+            catch (err) {
+                if (err.code === "ENOENT") {
+                    return {
+                        status: "warn",
+                        message: `~/.codehub/registry.json missing`,
+                        hint: "run `codehub analyze` in any git repo to create the registry",
+                    };
+                }
+                return {
+                    status: "fail",
+                    message: `registry read failed: ${err instanceof Error ? err.message : String(err)}`,
+                    hint: "delete ~/.codehub/registry.json and re-run `codehub analyze`",
+                };
+            }
+            try {
+                const parsed = JSON.parse(raw);
+                if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+                    return {
+                        status: "fail",
+                        message: "registry.json is not an object",
+                        hint: "back up the file and run `codehub analyze` again",
+                    };
+                }
+                const count = Object.keys(parsed).length;
+                return {
+                    status: "ok",
+                    message: `registry readable (${count} repo${count === 1 ? "" : "s"})`,
+                };
+            }
+            catch (err) {
+                return {
+                    status: "fail",
+                    message: `registry parse failed: ${err instanceof Error ? err.message : String(err)}`,
+                    hint: "delete ~/.codehub/registry.json and re-run `codehub analyze`",
+                };
+            }
+        },
+    };
+}
+function sarifSchemaCheck(repoRoot) {
+    return {
+        name: "@opencodehub/sarif build",
+        async run() {
+            const pkgDir = join(repoRoot, "packages", "sarif", "dist");
+            try {
+                const s = await stat(pkgDir);
+                if (!s.isDirectory()) {
+                    return {
+                        status: "fail",
+                        message: "@opencodehub/sarif dist is not a directory",
+                        hint: "run `pnpm -r build`",
+                    };
+                }
+                return { status: "ok", message: "@opencodehub/sarif built" };
+            }
+            catch {
+                return {
+                    status: "warn",
+                    message: "@opencodehub/sarif not built yet",
+                    hint: "run `pnpm -r build`",
+                };
+            }
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function printTable(rows) {
+    const table = new Table({
+        head: ["CHECK", "STATUS", "DETAIL", "HINT"],
+        style: { head: [], border: [] },
+        colWidths: [32, 8, 48, 48],
+        wordWrap: true,
+    });
+    for (const { name, result } of rows) {
+        const glyph = result.status === "ok" ? "OK" : result.status === "warn" ? "WARN" : "FAIL";
+        table.push([name, glyph, result.message, result.hint ?? ""]);
+    }
+    console.log(table.toString());
+}
+async function runCommand(cmd, args) {
+    return await new Promise((resolveProm) => {
+        const child = spawn(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (d) => {
+            stdout += d.toString("utf8");
+        });
+        child.stderr.on("data", (d) => {
+            stderr += d.toString("utf8");
+        });
+        child.on("error", () => {
+            resolveProm({ status: 127, stdout, stderr });
+        });
+        child.on("close", (code) => {
+            resolveProm({ status: code ?? 0, stdout, stderr });
+        });
+    });
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function firstLine(s) {
+    const idx = s.indexOf("\n");
+    return idx < 0 ? s.trim() : s.slice(0, idx).trim();
+}
+function guessRepoRoot() {
+    // `codehub` ships from packages/cli/dist/commands — walking four levels
+    // up lands at the monorepo root where `packages/` and `node_modules/`
+    // live.
+    const here = dirname(fileURLToPath(import.meta.url));
+    return resolve(here, "..", "..", "..", "..");
+}
+/**
+ * Resolve an npm package for the native-binding checks. We try two
+ * environments in order, so doctor returns `OK` in every realistic install
+ * shape — monorepo checkout, global `pnpm i -g`, tarball, symlinked bin:
+ *
+ *   1. The CLI package's own `node_modules` — `createRequire` off
+ *      `import.meta.url` walks outward through the same resolution chain
+ *      Node would use for a real `await import(pkg)` from inside the CLI,
+ *      so this is the authoritative answer for "can the CLI load this?".
+ *   2. The supplied `repoRoot` — legacy fallback for the in-monorepo case
+ *      where the CLI is running from `packages/cli/dist/` and dependencies
+ *      hoist to the workspace root.
+ *
+ * We stop at the first hit. Returning `null` preserves the existing
+ * semantics of the caller (`warn` result with a reinstall hint).
+ */
+function resolveFromRoot(repoRoot, pkg) {
+    // 1. CLI's own resolution context — the canonical answer.
+    try {
+        const req = createRequire(import.meta.url);
+        return req.resolve(pkg);
+    }
+    catch {
+        // fall through to repoRoot
+    }
+    // 2. Workspace/monorepo root fallback.
+    try {
+        const req = createRequire(join(repoRoot, "package.json"));
+        return req.resolve(pkg);
+    }
+    catch {
+        // fall through to per-package fallbacks
+    }
+    // 3. Per-workspace fallback. Under pnpm strict isolation, native bindings
+    //    are direct deps of the package that uses them — `tree-sitter*` lives
+    //    in `packages/ingestion`, `@duckdb/node-api` in `packages/storage`.
+    //    Probing those package.json contexts lets `codehub doctor` resolve
+    //    the bindings even when neither the CLI nor the workspace root
+    //    declare them as direct deps.
+    const owners = pkg.startsWith("@duckdb/") || pkg.startsWith("@ladybugdb/")
+        ? ["packages/storage"]
+        : pkg.startsWith("tree-sitter")
+            ? ["packages/ingestion"]
+            : [];
+    for (const owner of owners) {
+        try {
+            const req = createRequire(join(repoRoot, owner, "package.json"));
+            return req.resolve(pkg);
+        }
+        catch {
+            // try next
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/find-enclosing-symbol.d.ts

@@ -0,0 +1,67 @@
+/**
+ * `findEnclosingSymbolId` — deterministic tightest-span lookup that maps a
+ * `(filePath, line)` pair back to the OpenCodeHub graph node that owns the
+ * line (a Function / Method / Class / etc.). Used by `ingest-sarif` to link
+ * SARIF `Finding` nodes to the enclosing code symbol when the scanner did
+ * not populate `result.properties["opencodehub.symbolId"]` itself.
+ *
+ * This is a clone of the algorithm in
+ * `packages/ingestion/src/pipeline/phases/scip-index.ts:indexNodesByFile` +
+ * `findEnclosingNodeId`. The two call sites live in different packages
+ * (`@opencodehub/cli` vs `@opencodehub/ingestion`), and extracting a shared
+ * helper would require a cross-package refactor that is explicitly out of
+ * scope for the SARIF linkage task. If these functions need to converge
+ * later, promote this file to a shared util package (e.g.
+ * `@opencodehub/graph-utils`) and delete the duplicate in scip-index.ts in
+ * a single atomic change.
+ *
+ * Notes on 1-indexing: both SARIF 2.1.0 `region.startLine` and
+ * OpenCodeHub node `startLine`/`endLine` are 1-based, so no offset
+ * adjustment is needed at the call site.
+ */
+import type { NodeId, NodeKind } from "@opencodehub/core-types";
+/** A graph node projection carrying only the fields the lookup needs. */
+export interface NodeRow {
+    readonly id: NodeId;
+    readonly filePath: string;
+    readonly startLine: number;
+    readonly endLine: number;
+    readonly kind: NodeKind;
+}
+/** Per-file, start-line-ascending index used by `findEnclosingSymbolId`. */
+export type NodesByFile = ReadonlyMap<string, readonly NodeRow[]>;
+/**
+ * Code-kind allow set used when resolving SARIF findings back to an
+ * enclosing symbol. Covers Function, Method, Constructor, Class,
+ * Interface, Struct, Enum, and Trait — a strict superset of
+ * `SCIP_SYMBOL_KINDS`; we additionally allow `Constructor` here because
+ * SARIF tooling routinely emits findings inside constructor bodies.
+ */
+export declare const ENCLOSING_SYMBOL_KINDS: ReadonlySet<NodeKind>;
+/**
+ * Build a per-file, start-line-ascending index over the supplied node
+ * rows, filtering to nodes whose `kind` is in `ENCLOSING_SYMBOL_KINDS`.
+ * Rows missing either `startLine` or `endLine` are skipped silently —
+ * they cannot participate in a range containment check.
+ *
+ * Ordering: within each file the array is sorted by `startLine` ascending
+ * with `endLine` ascending as the tie-breaker. `findEnclosingSymbolId`
+ * still scans the whole candidate list for the tightest span, so the
+ * sort is primarily an early-break optimization (once `startLine > line`
+ * we can stop).
+ */
+export declare function indexNodesByFile(rows: readonly NodeRow[]): NodesByFile;
+/**
+ * Return the id of the tightest-span node in `nodesByFile[filePath]`
+ * that encloses `line` (`startLine <= line <= endLine`). "Tightest"
+ * means smallest `endLine - startLine` span — this makes nested methods
+ * win over their containing classes. When two candidates have the same
+ * span, the earlier `startLine` wins (which falls out of the deterministic
+ * input sort).
+ *
+ * Returns `undefined` when the file is unknown, when no candidate
+ * contains the line, or when every candidate has been filtered out by
+ * the allow-set at index time.
+ */
+export declare function findEnclosingSymbolId(nodesByFile: NodesByFile, filePath: string, line: number): NodeId | undefined;
+//# sourceMappingURL=find-enclosing-symbol.d.ts.map

package/dist/commands/find-enclosing-symbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-enclosing-symbol.d.ts","sourceRoot":"","sources":["../../src/commands/find-enclosing-symbol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEhE,yEAAyE;AACzE,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC,CAAC;AAElE;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,QAAQ,CASvD,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,WAAW,CAgBtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAiBpB"}

package/dist/commands/find-enclosing-symbol.js

@@ -0,0 +1,106 @@
+/**
+ * `findEnclosingSymbolId` — deterministic tightest-span lookup that maps a
+ * `(filePath, line)` pair back to the OpenCodeHub graph node that owns the
+ * line (a Function / Method / Class / etc.). Used by `ingest-sarif` to link
+ * SARIF `Finding` nodes to the enclosing code symbol when the scanner did
+ * not populate `result.properties["opencodehub.symbolId"]` itself.
+ *
+ * This is a clone of the algorithm in
+ * `packages/ingestion/src/pipeline/phases/scip-index.ts:indexNodesByFile` +
+ * `findEnclosingNodeId`. The two call sites live in different packages
+ * (`@opencodehub/cli` vs `@opencodehub/ingestion`), and extracting a shared
+ * helper would require a cross-package refactor that is explicitly out of
+ * scope for the SARIF linkage task. If these functions need to converge
+ * later, promote this file to a shared util package (e.g.
+ * `@opencodehub/graph-utils`) and delete the duplicate in scip-index.ts in
+ * a single atomic change.
+ *
+ * Notes on 1-indexing: both SARIF 2.1.0 `region.startLine` and
+ * OpenCodeHub node `startLine`/`endLine` are 1-based, so no offset
+ * adjustment is needed at the call site.
+ */
+/**
+ * Code-kind allow set used when resolving SARIF findings back to an
+ * enclosing symbol. Covers Function, Method, Constructor, Class,
+ * Interface, Struct, Enum, and Trait — a strict superset of
+ * `SCIP_SYMBOL_KINDS`; we additionally allow `Constructor` here because
+ * SARIF tooling routinely emits findings inside constructor bodies.
+ */
+export const ENCLOSING_SYMBOL_KINDS = new Set([
+    "Function",
+    "Method",
+    "Constructor",
+    "Class",
+    "Interface",
+    "Struct",
+    "Enum",
+    "Trait",
+]);
+/**
+ * Build a per-file, start-line-ascending index over the supplied node
+ * rows, filtering to nodes whose `kind` is in `ENCLOSING_SYMBOL_KINDS`.
+ * Rows missing either `startLine` or `endLine` are skipped silently —
+ * they cannot participate in a range containment check.
+ *
+ * Ordering: within each file the array is sorted by `startLine` ascending
+ * with `endLine` ascending as the tie-breaker. `findEnclosingSymbolId`
+ * still scans the whole candidate list for the tightest span, so the
+ * sort is primarily an early-break optimization (once `startLine > line`
+ * we can stop).
+ */
+export function indexNodesByFile(rows) {
+    const map = new Map();
+    for (const row of rows) {
+        if (!ENCLOSING_SYMBOL_KINDS.has(row.kind))
+            continue;
+        if (!Number.isFinite(row.startLine) || !Number.isFinite(row.endLine))
+            continue;
+        const bucket = map.get(row.filePath);
+        if (bucket === undefined)
+            map.set(row.filePath, [row]);
+        else
+            bucket.push(row);
+    }
+    for (const arr of map.values()) {
+        arr.sort((a, b) => {
+            if (a.startLine !== b.startLine)
+                return a.startLine - b.startLine;
+            return a.endLine - b.endLine;
+        });
+    }
+    return map;
+}
+/**
+ * Return the id of the tightest-span node in `nodesByFile[filePath]`
+ * that encloses `line` (`startLine <= line <= endLine`). "Tightest"
+ * means smallest `endLine - startLine` span — this makes nested methods
+ * win over their containing classes. When two candidates have the same
+ * span, the earlier `startLine` wins (which falls out of the deterministic
+ * input sort).
+ *
+ * Returns `undefined` when the file is unknown, when no candidate
+ * contains the line, or when every candidate has been filtered out by
+ * the allow-set at index time.
+ */
+export function findEnclosingSymbolId(nodesByFile, filePath, line) {
+    const candidates = nodesByFile.get(filePath);
+    if (candidates === undefined)
+        return undefined;
+    let best;
+    let bestSpan = Number.POSITIVE_INFINITY;
+    for (const rec of candidates) {
+        // Candidates are sorted by startLine; once we pass the target line
+        // no later row can enclose it.
+        if (rec.startLine > line)
+            break;
+        if (rec.endLine < line)
+            continue;
+        const span = rec.endLine - rec.startLine;
+        if (span < bestSpan) {
+            best = rec;
+            bestSpan = span;
+        }
+    }
+    return best?.id;
+}
+//# sourceMappingURL=find-enclosing-symbol.js.map