@nanonets/graft 0.9.1 → 0.10.0

package/dist/graph/generic.js

@@ -0,0 +1,320 @@
+/**
+ * Generic "breadth" extractor tier — one language-agnostic extractor over any
+ * tree-sitter grammar + its `tags.scm` (the standard tree-sitter tags convention). This is how
+ * graft covers the long tail of languages for ~one registry row each, instead of
+ * a hand-written extractor per language (the depth tier in extract.ts).
+ *
+ * Grammars are WASM (`tree-sitter-wasms` bundle) loaded via `web-tree-sitter`, so
+ * a new language needs no native node-gyp build. Loading is async (WASM init), so
+ * callers MUST `await warmGenericGrammars([...])` once before the synchronous
+ * `extractGeneric()` is used in a build/check loop. If a grammar isn't warmed,
+ * `extractGeneric` degrades to a file node only (never throws).
+ *
+ * What it emits (signature-only): a file node + one node per `@definition.<kind>`
+ * capture, and bare-name `calls` raw edges from `@reference.call` attributed to
+ * the innermost enclosing definition. resolve.ts then resolves those calls by
+ * name for free (same-file → extracted, unique-global → inferred). Member-call
+ * receiver typing (recvType) is NOT produced here — that needs a per-language
+ * binding pass; the opt-in LSP tier fills that gap for popular languages.
+ */
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { createRequire } from "node:module";
+import { contentHash } from "../util/id.js";
+const HERE = dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+// queries/ ships beside the compiled JS (copied by the build); fall back to src.
+const QUERY_DIRS = [join(HERE, "queries"), join(HERE, "..", "..", "src", "graph", "queries")];
+/** The breadth registry. Add a row + a queries/<name>.scm to support a language.
+ * Extensions here must NOT collide with the depth tier's EXTENSIONS (extract.ts). */
+export const GENERIC_LANGS = [
+    { name: "rust", exts: [".rs"], wasm: "rust" },
+    { name: "java", exts: [".java"], wasm: "java" },
+    { name: "c", exts: [".c", ".h"], wasm: "c" },
+    { name: "cpp", exts: [".cpp", ".cc", ".cxx", ".hpp", ".hh"], wasm: "cpp" },
+    { name: "ruby", exts: [".rb"], wasm: "ruby" },
+    { name: "php", exts: [".php"], wasm: "php" },
+    { name: "c_sharp", exts: [".cs"], wasm: "c_sharp" },
+    // These ship a tags.scm (calls + symbols); ocaml/zig have none and use the
+    // node-kind walker fallback (symbols only) — still one row, zero query.
+    { name: "kotlin", exts: [".kt", ".kts"], wasm: "kotlin" },
+    { name: "scala", exts: [".scala", ".sc"], wasm: "scala" },
+    { name: "swift", exts: [".swift"], wasm: "swift" },
+    { name: "elixir", exts: [".ex", ".exs"], wasm: "elixir" },
+    { name: "solidity", exts: [".sol"], wasm: "solidity" },
+    { name: "ocaml", exts: [".ml", ".mli"], wasm: "ocaml" },
+    { name: "zig", exts: [".zig"], wasm: "zig" },
+    { name: "dart", exts: [".dart"], wasm: "dart" }, // surfaced by PR #38 (@muneebshere)
+];
+const byExt = new Map();
+for (const l of GENERIC_LANGS)
+    for (const e of l.exts)
+        byExt.set(e, l);
+/** The generic language for a path, or null if no breadth grammar claims it. */
+export function genericLangOf(path) {
+    const lower = path.toLowerCase();
+    for (const [ext, l] of byExt)
+        if (lower.endsWith(ext))
+            return l;
+    return null;
+}
+// tags.scm @definition.<X>  →  graft Kind (types.ts). Unmapped → "function".
+const KIND = {
+    function: "function", method: "method", class: "class", interface: "interface",
+    type: "type", struct: "struct", enum: "enum", module: "module",
+    constant: "constant", variable: "variable", field: "variable",
+    object: "class", property: "variable", // Scala object; Swift/Scala property
+};
+const loaded = new Map();
+let tsMod = null;
+let initPromise = null;
+function requireWasm(wasm) {
+    // Resolve the grammar wasm from the tree-sitter-wasms bundle.
+    try {
+        const p = require.resolve(`tree-sitter-wasms/out/tree-sitter-${wasm}.wasm`);
+        return readFileSync(p);
+    }
+    catch {
+        return null;
+    }
+}
+function loadQuery(name) {
+    for (const dir of QUERY_DIRS) {
+        try {
+            const raw = readFileSync(join(dir, `${name}.scm`), "utf8");
+            // Sanitize editor-specific query predicates the tree-sitter Query compiler rejects.
+            return raw.replace(/\(#(?:strip!|set!|set-adjacent!|select-adjacent!|make-range!|offset!|gsub!)[^()]*\)/g, "");
+        }
+        catch {
+            /* try next dir */
+        }
+    }
+    return null;
+}
+/** Warm the WASM grammars for the given graft lang names. Idempotent; must be
+ * awaited once before extractGeneric is used in a sync loop. Unknown/unavailable
+ * grammars are silently skipped (their files then extract as file-only). */
+export async function warmGenericGrammars(langNames) {
+    const want = new Set(langNames);
+    const need = [...want].filter((n) => !loaded.has(n) && GENERIC_LANGS.some((l) => l.name === n));
+    if (need.length === 0)
+        return;
+    if (!tsMod) {
+        tsMod = await import("web-tree-sitter");
+        initPromise = initPromise ?? tsMod.Parser.init();
+    }
+    await initPromise;
+    const { Language, Query } = tsMod;
+    for (const name of need) {
+        const row = GENERIC_LANGS.find((l) => l.name === name);
+        const bytes = requireWasm(row.wasm);
+        if (!bytes)
+            continue;
+        try {
+            const language = await Language.load(bytes);
+            const scm = loadQuery(name);
+            let query = null;
+            if (scm) {
+                try {
+                    query = new Query(language, scm);
+                }
+                catch {
+                    query = null;
+                }
+            }
+            loaded.set(name, { language, query });
+        }
+        catch {
+            /* grammar failed to instantiate — skip; files extract as file-only */
+        }
+    }
+}
+/** True if a grammar has been warmed for this lang (else extractGeneric is file-only). */
+export function isWarm(langName) {
+    return loaded.has(langName);
+}
+const PARSE_CHUNK = 16384; // <32KB slices — same tree-sitter limit workaround as extract.ts
+function fileNode(rel, source) {
+    return {
+        id: rel, name: rel.split("/").pop() ?? rel, kind: "file", path: rel,
+        span: `L1-L${Math.max(1, source.split("\n").length)}`, signature: null,
+        exported: true, origin: "generic", body_hash: contentHash(source),
+        chars: Buffer.byteLength(source), summary_state: "pending", summary: null, crux: null,
+    };
+}
+/** Extract a single generic-tier file. Synchronous; needs the grammar pre-warmed.
+ * Uses the grammar's compiled tags.scm when present (symbols + call edges);
+ * otherwise falls back to a node-kind tree walker (symbols only) so ANY warmed
+ * grammar yields a graph even with no vendored query. */
+export function extractGeneric(rel, source, langName) {
+    const nodes = [fileNode(rel, source)];
+    const rawEdges = [];
+    const entry = loaded.get(langName);
+    if (!entry || !tsMod)
+        return { nodes, rawEdges };
+    let tree;
+    try {
+        const parser = new tsMod.Parser();
+        parser.setLanguage(entry.language);
+        tree = parser.parse((i) => source.slice(i, i + PARSE_CHUNK));
+    }
+    catch {
+        return { nodes, rawEdges };
+    }
+    if (!tree)
+        return { nodes, rawEdges };
+    const minted = new Set([rel]);
+    const lines = source.split("\n");
+    const defs = [];
+    // One definition per source span: a grammar's tags.scm can capture the same node
+    // under two @definition kinds (Swift `func` is method AND function), and the
+    // walker can revisit a nested match — both would emit near-duplicate nodes.
+    const spanSeen = new Set();
+    // Mint one definition node from a whole-definition tree node. Shared by both
+    // the tags.scm path and the walker fallback so id/span/signature/body_text are
+    // built identically.
+    const mkDef = (name, kind, whole) => {
+        if (spanSeen.has(whole.startIndex))
+            return;
+        spanSeen.add(whole.startIndex);
+        const idBase = `${rel}#${name}`;
+        let id = idBase, n = 2;
+        while (minted.has(id))
+            id = `${idBase}~${n++}`;
+        minted.add(id);
+        const startRow = whole.startPosition.row, endRow = whole.endPosition.row;
+        const sigLine = (lines[startRow] ?? "").trim().replace(/\s*\{?\s*$/, "");
+        nodes.push({
+            id, name, kind, path: rel,
+            span: `L${startRow + 1}-L${endRow + 1}`,
+            signature: sigLine || null, exported: true, origin: "generic",
+            body_hash: contentHash(source.slice(whole.startIndex, whole.endIndex)),
+            body_text: source.slice(whole.startIndex, whole.endIndex).replace(/\s+/g, " ").slice(0, 5000),
+            summary_state: "pending", summary: null, crux: null,
+        });
+        defs.push({ id, startIndex: whole.startIndex, endIndex: whole.endIndex });
+    };
+    if (entry.query) {
+        tagsExtract(entry.query, tree.rootNode, rel, mkDef, defs, rawEdges);
+    }
+    else {
+        walkExtract(tree.rootNode, mkDef); // no tags.scm → symbols only
+    }
+    return { nodes, rawEdges };
+}
+/** tags.scm path: @definition.<kind> → nodes, @reference.call/@reference.send →
+ * bare-name call edges attributed to the innermost enclosing definition. */
+function tagsExtract(query, root, rel, mkDef, defs, rawEdges) {
+    const q = query;
+    const matches = q.matches(root);
+    // Some grammars' tags.scm capture a definition's own NAME token as a
+    // @reference.call too (Ruby tags `def foo`'s `foo` as both @name and a call),
+    // producing bogus self-loops (foo→foo). Skip any call at a definition's name token.
+    const defNameAt = new Set();
+    const calls = [];
+    for (const m of matches) {
+        const cap = {};
+        for (const c of m.captures)
+            cap[c.name] = c.node;
+        const defKey = Object.keys(cap).find((k) => k.startsWith("definition."));
+        if (defKey && cap.name) {
+            defNameAt.add(cap.name.startIndex);
+            mkDef(cap.name.text, KIND[defKey.slice("definition.".length)] ?? "function", defScope(cap[defKey]));
+        }
+        if (("reference.call" in cap || "reference.send" in cap) && cap.name)
+            calls.push({ name: cap.name.text, at: cap.name.startIndex });
+    }
+    for (const c of calls) {
+        if (defNameAt.has(c.at))
+            continue;
+        const enc = defs
+            .filter((d) => d.startIndex <= c.at && c.at < d.endIndex)
+            .sort((a, b) => (a.endIndex - a.startIndex) - (b.endIndex - b.startIndex))[0];
+        rawEdges.push({ source: enc ? enc.id : rel, relation: "calls", file: rel, name: c.name });
+    }
+}
+// Node-type → Kind for the walker fallback. A node is a definition when its type
+// ends with a declaration-ish suffix AND names a construct — matched most-specific
+// first (method before function). Covers the common tree-sitter grammar vocab
+// without any per-language query.
+const DEF_SUFFIX = /(declaration|definition|_item|_specifier|_decl|_def|_binding)$/;
+function classifyKind(type) {
+    const t = type.toLowerCase();
+    if (!DEF_SUFFIX.test(t) && !/^(class|struct|enum|interface|trait|module|namespace)/.test(t))
+        return null;
+    if (/method|constructor/.test(t))
+        return "method";
+    if (/func|function|def\b|subroutine|procedure/.test(t))
+        return "function";
+    if (/class/.test(t))
+        return "class";
+    if (/struct|record/.test(t))
+        return "struct";
+    if (/interface|trait|protocol/.test(t))
+        return "interface";
+    if (/enum/.test(t))
+        return "enum";
+    if (/module|namespace|package|mod_/.test(t))
+        return "module";
+    if (/const/.test(t))
+        return "constant";
+    if (/typedef|type_alias|type_def|alias/.test(t))
+        return "type";
+    if (/type/.test(t))
+        return "type";
+    if (/(^|_)(val|var|let|field|property)/.test(t))
+        return "variable";
+    return null;
+}
+/** The declared name of a node: its `name` field, else the first identifier-ish
+ * descendant within a couple of levels. */
+function nodeName(node) {
+    const byField = node.childForFieldName?.("name");
+    if (byField?.text)
+        return byField.text;
+    const stack = [{ n: node, d: 0 }];
+    while (stack.length) {
+        const { n, d } = stack.shift();
+        if (d > 0 && /identifier|name/.test(n.type) && n.text && !n.text.includes("\n"))
+            return n.text;
+        if (d < 3)
+            for (let i = 0; i < (n.namedChildCount ?? 0); i++) {
+                const c = n.namedChild?.(i);
+                if (c)
+                    stack.push({ n: c, d: d + 1 });
+            }
+    }
+    return null;
+}
+/** Walker fallback: DFS every named node, emit a def for each classified one
+ * (symbols only — no call resolution without a query). */
+function walkExtract(root, mkDef) {
+    const visit = (n) => {
+        const kind = classifyKind(n.type);
+        if (kind) {
+            const name = nodeName(n);
+            if (name)
+                mkDef(name, kind, n);
+        }
+        for (let i = 0; i < (n.namedChildCount ?? 0); i++) {
+            const c = n.namedChild?.(i);
+            if (c)
+                visit(c);
+        }
+    };
+    visit(root);
+}
+// Some grammars' tags.scm put @definition.<X> on a narrow node (C tags the
+// `function_declarator`, not the whole `function_definition` with its body), so
+// the capture's span stops before the body and calls inside it can't be
+// attributed to the function. Expand up to the outermost enclosing
+// declaration/definition node so a def's span covers its body.
+const DEF_CONTAINER = /(definition|declaration|specifier|_item)$/;
+function defScope(node) {
+    let n = node;
+    while (n.parent && DEF_CONTAINER.test(n.parent.type))
+        n = n.parent;
+    return n;
+}
+//# sourceMappingURL=generic.js.map

package/dist/graph/generic.js.map

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

package/dist/graph/lsp/client.d.ts

@@ -0,0 +1,43 @@
+export interface LspPosition {
+    line: number;
+    character: number;
+}
+export interface LspRange {
+    start: LspPosition;
+    end: LspPosition;
+}
+export interface CallHierarchyItem {
+    name: string;
+    kind: number;
+    uri: string;
+    range: LspRange;
+    selectionRange: LspRange;
+}
+export declare class LspClient {
+    private readonly root;
+    private readonly languageId;
+    private readonly callTimeoutMs;
+    private proc;
+    private conn;
+    private opened;
+    private ready;
+    private spawnFailed;
+    constructor(command: string, args: string[], root: string, languageId: string, callTimeoutMs?: number);
+    /** Safe to write to the server's stdin right now? */
+    private canWrite;
+    /** A request with a timeout so a wedged server can't hang the whole build. */
+    private call;
+    initialize(): Promise<boolean>;
+    /** Open a document (idempotent). Servers resolve cross-file refs from disk, but
+     * the LSP spec wants the queried document opened first. */
+    didOpen(abs: string): void;
+    /** Poll one probe position until call-hierarchy returns something — servers
+     * like rust-analyzer/clangd index AFTER `initialized` and answer empty until
+     * ready. Returns true once ready (or false at the cap). */
+    waitUntilReady(abs: string, pos: LspPosition, maxMs?: number): Promise<boolean>;
+    prepareCallHierarchy(abs: string, pos: LspPosition): Promise<CallHierarchyItem[]>;
+    /** The callees of an item — returns each outgoing call's `to` target. */
+    outgoingCalls(item: CallHierarchyItem): Promise<CallHierarchyItem[]>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/graph/lsp/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/graph/lsp/client.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,WAAW;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAChE,MAAM,WAAW,QAAQ;IAAG,KAAK,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,WAAW,CAAA;CAAE;AAClE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,QAAQ,CAAC;IAChB,cAAc,EAAE,QAAQ,CAAC;CAC1B;AAID,qBAAa,SAAS;IAUlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAXhC,OAAO,CAAC,IAAI,CAAiC;IAC7C,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,WAAW,CAAS;gBAG1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACG,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,aAAa,SAAQ;IAkCxC,qDAAqD;IACrD,OAAO,CAAC,QAAQ;IAIhB,8EAA8E;IAC9E,OAAO,CAAC,IAAI;IAYN,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IA6BpC;+DAC2D;IAC3D,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAY1B;;+DAE2D;IACrD,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,SAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAW9E,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IASvF,yEAAyE;IACnE,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAMpE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAS/B"}

package/dist/graph/lsp/client.js

@@ -0,0 +1,179 @@
+/**
+ * A minimal LSP client for the opt-in `--lsp` enrichment pass — just enough to
+ * pull compiler-grade call edges out of a language server: spawn it over stdio,
+ * initialize, open documents, and run the call-hierarchy requests. Built on
+ * `vscode-jsonrpc` (we don't hand-roll the framing). Everything is best-effort:
+ * a server that is missing, slow, or errors degrades to "no enrichment", never a
+ * crash — the AST graph stands on its own.
+ */
+import { spawn } from "node:child_process";
+import { pathToFileURL } from "node:url";
+import { readFileSync } from "node:fs";
+import { createMessageConnection, StreamMessageReader, StreamMessageWriter, } from "vscode-jsonrpc/node.js";
+const uriOf = (abs) => pathToFileURL(abs).toString();
+export class LspClient {
+    root;
+    languageId;
+    callTimeoutMs;
+    proc;
+    conn;
+    opened = new Set();
+    ready = false;
+    spawnFailed = false;
+    constructor(command, args, root, languageId, callTimeoutMs = 15000) {
+        this.root = root;
+        this.languageId = languageId;
+        this.callTimeoutMs = callTimeoutMs;
+        this.proc = spawn(command, args, { cwd: root, stdio: ["pipe", "pipe", "pipe"] });
+        // ENOENT (bad path) OR an immediate exit (e.g. a rustup shim whose component
+        // isn't installed) must fail fast, not hang a request for the full timeout.
+        this.proc.on("error", () => { this.spawnFailed = true; });
+        // An immediate exit (shim without its component, crash on startup) must fail
+        // fast so initialize bails instead of waiting out the timeout; once we've
+        // marked !ready, in-flight queries no-op. Firing during dispose is harmless.
+        this.proc.on("exit", () => { this.spawnFailed = true; this.ready = false; });
+        this.proc.stderr.resume(); // drain; servers are chatty on stderr
+        // Swallow write-after-destroy (EPIPE / ERR_STREAM_DESTROYED) when the server
+        // closes its stdin during/after shutdown — otherwise it surfaces as an
+        // unhandled stream error and taints the process exit code.
+        this.proc.stdin.on("error", () => { });
+        this.conn = createMessageConnection(new StreamMessageReader(this.proc.stdout), new StreamMessageWriter(this.proc.stdin));
+        // Answer the reverse-RPC requests every server makes during startup so it
+        // doesn't block waiting on us; we take defaults for all of them.
+        this.conn.onRequest("workspace/configuration", (p) => (p.items ?? []).map(() => ({})));
+        this.conn.onRequest("client/registerCapability", () => null);
+        this.conn.onRequest("window/workDoneProgress/create", () => null);
+        this.conn.onRequest("workspace/applyEdit", () => ({ applied: false }));
+        this.conn.onNotification(() => { }); // swallow all notifications (diagnostics, progress, logs)
+        // The connection/streams can error or close asynchronously (server exits,
+        // stdin destroyed) — absorb both so a late write never becomes an unhandled
+        // exception that taints the build's exit code.
+        this.conn.onError(() => { this.ready = false; });
+        this.conn.onClose(() => { this.ready = false; });
+        this.conn.listen();
+    }
+    /** Safe to write to the server's stdin right now? */
+    canWrite() {
+        return this.ready && this.proc.stdin.writable && !this.proc.stdin.destroyed;
+    }
+    /** A request with a timeout so a wedged server can't hang the whole build. */
+    call(method, params) {
+        if (!this.canWrite())
+            return Promise.resolve(null);
+        return new Promise((resolve) => {
+            let done = false;
+            const t = setTimeout(() => { if (!done) {
+                done = true;
+                resolve(null);
+            } }, this.callTimeoutMs);
+            this.conn.sendRequest(method, params).then((r) => { if (!done) {
+                done = true;
+                clearTimeout(t);
+                resolve(r);
+            } }, () => { if (!done) {
+                done = true;
+                clearTimeout(t);
+                resolve(null);
+            } });
+        });
+    }
+    async initialize() {
+        // Let a synchronous spawn failure (ENOENT) surface before we wait on a
+        // response that will never come.
+        await new Promise((r) => setTimeout(r, 50));
+        if (this.spawnFailed || this.proc.pid === undefined)
+            return false;
+        const rootUri = uriOf(this.root);
+        // Cold-workspace load (rust-analyzer/clangd index the project) can take a
+        // while — give initialize a generous timeout, separate from per-request.
+        const init = await new Promise((resolve) => {
+            const t = setTimeout(() => resolve(null), 120000);
+            this.conn.sendRequest("initialize", {
+                processId: process.pid,
+                rootUri,
+                workspaceFolders: [{ uri: rootUri, name: "root" }],
+                capabilities: {
+                    textDocument: {
+                        callHierarchy: { dynamicRegistration: false },
+                        synchronization: { dynamicRegistration: false },
+                    },
+                    workspace: { workspaceFolders: true, configuration: true },
+                },
+            }).then((r) => { clearTimeout(t); resolve(r); }, () => { clearTimeout(t); resolve(null); });
+        });
+        if (!init)
+            return false;
+        this.conn.sendNotification("initialized", {});
+        this.ready = true;
+        return true;
+    }
+    /** Open a document (idempotent). Servers resolve cross-file refs from disk, but
+     * the LSP spec wants the queried document opened first. */
+    didOpen(abs) {
+        if (!this.canWrite() || this.opened.has(abs))
+            return;
+        let text = "";
+        try {
+            text = readFileSync(abs, "utf8");
+        }
+        catch {
+            return;
+        }
+        this.opened.add(abs);
+        try {
+            this.conn.sendNotification("textDocument/didOpen", {
+                textDocument: { uri: uriOf(abs), languageId: this.languageId, version: 1, text },
+            });
+        }
+        catch { /* stream closed mid-write */ }
+    }
+    /** Poll one probe position until call-hierarchy returns something — servers
+     * like rust-analyzer/clangd index AFTER `initialized` and answer empty until
+     * ready. Returns true once ready (or false at the cap). */
+    async waitUntilReady(abs, pos, maxMs = 90000) {
+        this.didOpen(abs);
+        const deadline = Date.now() + maxMs;
+        while (Date.now() < deadline) {
+            const items = await this.prepareCallHierarchy(abs, pos);
+            if (items.length)
+                return true;
+            await new Promise((r) => setTimeout(r, 2000));
+        }
+        return false;
+    }
+    async prepareCallHierarchy(abs, pos) {
+        if (!this.ready)
+            return [];
+        const r = await this.call("textDocument/prepareCallHierarchy", {
+            textDocument: { uri: uriOf(abs) },
+            position: pos,
+        });
+        return r ?? [];
+    }
+    /** The callees of an item — returns each outgoing call's `to` target. */
+    async outgoingCalls(item) {
+        if (!this.ready)
+            return [];
+        const r = await this.call("callHierarchy/outgoingCalls", { item });
+        return (r ?? []).map((c) => c.to).filter(Boolean);
+    }
+    async dispose() {
+        // Skip the graceful LSP shutdown/exit handshake: writing `exit` to a server
+        // that has already closed its stdin throws ERR_STREAM_DESTROYED and taints
+        // the exit code. The graph is already built; just tear the process down.
+        this.ready = false;
+        try {
+            this.conn.dispose();
+        }
+        catch { /* ignore */ }
+        try {
+            this.proc.stdin.destroy();
+        }
+        catch { /* ignore */ }
+        try {
+            this.proc.kill("SIGKILL");
+        }
+        catch { /* ignore */ }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/graph/lsp/client.js.map

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

package/dist/graph/lsp/enrich.d.ts

@@ -0,0 +1,11 @@
+import type { GraphV1 } from "../types.js";
+export interface LspEnrichResult {
+    added: number;
+    queried: number;
+    server: string | null;
+}
+export declare function enrichWithLsp(graph: GraphV1, root: string, opts?: {
+    onProgress?: (done: number, total: number) => void;
+    maxNodes?: number;
+}): Promise<LspEnrichResult>;
+//# sourceMappingURL=enrich.d.ts.map

package/dist/graph/lsp/enrich.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich.d.ts","sourceRoot":"","sources":["../../../src/graph/lsp/enrich.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,aAAa,CAAC;AAe3D,MAAM,WAAW,eAAe;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE;AAE1F,wBAAsB,aAAa,CACjC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GACnF,OAAO,CAAC,eAAe,CAAC,CAqG1B"}