wotann 0.5.0 → 0.5.39

package/dist/intelligence/blast-radius.js

@@ -0,0 +1,536 @@
+/**
+ * blast-radius — port of contextplus's `get_blast_radius` tool.
+ *
+ * Goal: For a given symbol (function/class/variable name), return every
+ * cross-file usage site, plus a "LOW USAGE" warning when usage is
+ * suspiciously low (≤1 hit — likely dead code or unused export).
+ *
+ * Strategy (preferred order):
+ *   1. tree-sitter via `src/intelligence/code-graph.ts`. We re-use the
+ *      auto-detect parser registry to walk identifier nodes whose text
+ *      matches the requested symbol. Tree-sitter gives whole-word
+ *      identity matching without regex pitfalls.
+ *   2. ripgrep (`rg`) if available — fast word-boundary text search.
+ *   3. Pure Node regex fallback — walks files and matches `\bsymbol\b`.
+ *
+ * All subprocess calls go through `src/utils/execFileNoThrow.ts`, which
+ * uses execFile (argv-based) — no shell, no injection surface.
+ *
+ * Honest failure modes (never throws):
+ *   - missing `rootDir` → empty `usages`, `warning: "engine unavailable: ..."`
+ *   - all engines fail (rare, e.g. unreadable dir) → same shape
+ *   - empty repo → `warning` carries the "LOW USAGE: ≤1 usage" hint
+ *
+ * Skipped directories by default: node_modules, .git, dist, dist-cjs,
+ * build, coverage. These are the canonical noise generators for symbol
+ * searches in a TS monorepo and align with the existing code-graph
+ * walker (extended with `dist-cjs` and `coverage` because WOTANN ships
+ * a CJS mirror and a vitest coverage tree).
+ *
+ * No new dependencies. No throws. Read-only.
+ *
+ * Quality bars honored:
+ *   - QB#7 stateless (no module-global mutation after init).
+ *   - QB#6 honest "engine unavailable" stub instead of silent zero.
+ *   - QB#13 strict equality + NODE_ENV-free behavior (deterministic
+ *     production path even under test).
+ *   - QB#19 zombie-instance check: every entry point in this module is
+ *     called from the public function — no dead-code branches.
+ */
+import { readFile, readdir, stat } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { extname, join, relative, sep } from "node:path";
+import { buildWithTreeSitter, } from "./code-graph.js";
+import { execFileNoThrow } from "../utils/execFileNoThrow.js";
+// ── Constants ─────────────────────────────────────────────────
+const DEFAULT_MAX_USAGES = 200;
+const DEFAULT_SKIP_DIRS = [
+    "node_modules",
+    ".git",
+    "dist",
+    "dist-cjs",
+    "build",
+    "coverage",
+];
+/**
+ * Map a `Language` to the extensions we'll search. Kept as a single
+ * source of truth so callers can pass `languages: ["typescript"]` and
+ * get just `.ts`/`.tsx`.
+ */
+const LANG_EXTENSIONS = {
+    typescript: [".ts", ".tsx"],
+    javascript: [".js", ".jsx", ".mjs", ".cjs"],
+    python: [".py"],
+    rust: [".rs"],
+    go: [".go"],
+    swift: [".swift"],
+};
+const ALL_DEFAULT_EXTS = Object.values(LANG_EXTENSIONS).flat();
+// ── Public API ────────────────────────────────────────────────
+export async function getBlastRadius(opts) {
+    const symbol = opts.symbol;
+    const rootDir = opts.rootDir;
+    const maxUsages = opts.maxUsages ?? DEFAULT_MAX_USAGES;
+    const exts = extensionsFor(opts.languages);
+    // Symbol guard — empty / whitespace-only symbols are nonsensical here
+    // and would produce wildcard noise.
+    if (symbol.trim().length === 0) {
+        return Object.freeze({
+            symbol,
+            usages: Object.freeze([]),
+            truncated: false,
+            warning: "engine unavailable: empty symbol",
+        });
+    }
+    // Validate rootDir up front — every backend would otherwise fail
+    // silently, masking the real problem.
+    if (!existsSync(rootDir)) {
+        return Object.freeze({
+            symbol,
+            usages: Object.freeze([]),
+            truncated: false,
+            warning: `engine unavailable: rootDir does not exist: ${rootDir}`,
+        });
+    }
+    // 1. Tree-sitter path. Only meaningful for JS/TS — Python/Rust/Go/Swift
+    //    grammars are not bundled by code-graph. For any non-JS/TS request
+    //    we skip directly to ripgrep/grep.
+    const tsApplicable = exts.some((e) => e === ".ts" || e === ".tsx" || e === ".js" || e === ".jsx");
+    if (tsApplicable) {
+        const tsResult = await tryTreeSitter(symbol, rootDir, exts, maxUsages);
+        if (tsResult !== null)
+            return finalize(symbol, tsResult.usages, tsResult.truncated, maxUsages);
+    }
+    // 2. ripgrep path. We probe `which rg` rather than try-execute so we
+    //    can report a clean "engine unavailable" string when both paths
+    //    fail downstream.
+    const rgAvailable = await hasRipgrep();
+    if (rgAvailable) {
+        const rgResult = await tryRipgrep(symbol, rootDir, exts, maxUsages);
+        if (rgResult !== null)
+            return finalize(symbol, rgResult.usages, rgResult.truncated, maxUsages);
+    }
+    // 3. Pure Node fallback.
+    const grepResult = await tryNodeGrep(symbol, rootDir, exts, maxUsages);
+    if (grepResult !== null)
+        return finalize(symbol, grepResult.usages, grepResult.truncated, maxUsages);
+    // 4. Every engine failed — emit honest stub.
+    return Object.freeze({
+        symbol,
+        usages: Object.freeze([]),
+        truncated: false,
+        warning: "engine unavailable: tree-sitter, ripgrep, and node-grep all failed",
+    });
+}
+/**
+ * Tree-sitter adapter. Returns null when the parser registry can't be
+ * loaded (no tree-sitter installed, or no .ts/.tsx/.js/.jsx grammar
+ * was registered). Returns RawHits otherwise.
+ *
+ * We re-use buildWithTreeSitter's auto-detect path, then re-walk the
+ * source files ourselves to collect IDENTIFIER nodes by text. The
+ * code-graph walker emits only declarations; for blast-radius we need
+ * every reference.
+ */
+async function tryTreeSitter(symbol, rootDir, exts, maxUsages) {
+    // Probe whether tree-sitter is installed by calling buildWithTreeSitter
+    // and checking the failure mode. If it's "not-installed", bail to
+    // ripgrep. Anything else (success or per-file parse errors) is fine.
+    const probe = await buildWithTreeSitter(rootDir);
+    if (!probe.ok && probe.error === "tree-sitter-not-installed")
+        return null;
+    if (!probe.ok)
+        return null; // Other tree-sitter errors → fall back
+    return await collectViaTreeSitter(symbol, rootDir, exts, maxUsages, probe.graph);
+}
+/**
+ * Walk the file list embedded in a successful tree-sitter graph,
+ * re-parse each file via a shim borrowed from the cache, and emit
+ * UsageSite entries for every identifier node whose text matches the
+ * symbol.
+ */
+async function collectViaTreeSitter(symbol, rootDir, exts, maxUsages, graph) {
+    // Distinct files from the graph (modules are emitted once per file).
+    const seen = new Set();
+    const files = [];
+    for (const node of graph.nodes) {
+        if (node.kind !== "module")
+            continue;
+        if (seen.has(node.path))
+            continue;
+        seen.add(node.path);
+        if (!exts.includes(extname(node.path).toLowerCase()))
+            continue;
+        files.push(node.path);
+    }
+    if (files.length === 0)
+        return { usages: Object.freeze([]), truncated: false };
+    let shim;
+    try {
+        shim = await loadShimsInline();
+    }
+    catch {
+        return null;
+    }
+    if (shim.javascript === null && shim.typescript === null && shim.tsx === null) {
+        return null;
+    }
+    const hits = [];
+    let truncated = false;
+    for (const rel of files) {
+        if (hits.length >= maxUsages) {
+            truncated = true;
+            break;
+        }
+        const ext = extname(rel).toLowerCase();
+        const chosen = pickShim(ext, shim);
+        if (chosen === null)
+            continue;
+        const abs = join(rootDir, rel);
+        let content;
+        try {
+            content = await readFile(abs, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        let tree;
+        try {
+            tree = chosen.parse(content);
+        }
+        catch {
+            continue;
+        }
+        const lines = content.split(/\r?\n/);
+        walkIdentifiers(tree.rootNode, symbol, rel, lines, hits, maxUsages);
+        if (hits.length >= maxUsages) {
+            truncated = true;
+            break;
+        }
+    }
+    return { usages: Object.freeze(hits), truncated };
+}
+/**
+ * Best-effort inline loader. Mirrors the same dynamic-import surface as
+ * code-graph but returns nothing on failure. Cached at module scope.
+ */
+let _inlineShims = null;
+// Indirection wrapper around `await import()`. Calling `import()` with a
+// variable specifier means TypeScript doesn't try to statically resolve
+// the target — which is exactly what we want for an optional peer dep.
+// Mirrors `dynImport()` in code-graph.ts.
+async function dynImport(specifier) {
+    return import(specifier);
+}
+async function loadShimsInline() {
+    if (_inlineShims !== null)
+        return _inlineShims;
+    let ParserCtor = null;
+    try {
+        const mod = (await dynImport("tree-sitter"));
+        ParserCtor = mod.default ?? mod;
+    }
+    catch {
+        ParserCtor = null;
+    }
+    let jsLang = null;
+    try {
+        const mod = (await dynImport("tree-sitter-javascript"));
+        jsLang = mod.default ?? mod;
+    }
+    catch {
+        jsLang = null;
+    }
+    let tsLang = null;
+    let tsxLang = null;
+    try {
+        const mod = (await dynImport("tree-sitter-typescript"));
+        const root = (mod.default ?? mod);
+        tsLang = root.typescript ?? null;
+        tsxLang = root.tsx ?? null;
+    }
+    catch {
+        tsLang = null;
+        tsxLang = null;
+    }
+    const buildShim = (lang, name) => {
+        if (ParserCtor === null || lang === null)
+            return null;
+        const Ctor = ParserCtor;
+        const p = new Ctor();
+        p.setLanguage(lang);
+        return Object.freeze({
+            languageName: name,
+            parse: (source) => p.parse(source),
+        });
+    };
+    const built = {
+        javascript: buildShim(jsLang, "javascript"),
+        typescript: buildShim(tsLang, "typescript"),
+        tsx: buildShim(tsxLang, "tsx"),
+    };
+    _inlineShims = built;
+    return built;
+}
+function pickShim(ext, shim) {
+    if (ext === ".js" || ext === ".jsx" || ext === ".mjs" || ext === ".cjs")
+        return shim.javascript;
+    if (ext === ".ts")
+        return shim.typescript;
+    if (ext === ".tsx")
+        return shim.tsx ?? shim.typescript;
+    return null;
+}
+/**
+ * Test-only seam. Resetting the inline shim cache lets tests start
+ * from a clean process state. Not part of the public API.
+ *
+ * @internal
+ */
+export function __resetInlineShimsForTests() {
+    _inlineShims = null;
+}
+function walkIdentifiers(root, symbol, rel, lines, hits, maxUsages) {
+    const stack = [root];
+    while (stack.length > 0) {
+        if (hits.length >= maxUsages)
+            return;
+        const cur = stack.pop();
+        if (!cur)
+            break;
+        const t = cur.type;
+        if ((t === "identifier" ||
+            t === "property_identifier" ||
+            t === "type_identifier" ||
+            t === "shorthand_property_identifier" ||
+            t === "shorthand_property_identifier_pattern") &&
+            cur.text === symbol) {
+            const line = cur.startPosition.row + 1;
+            const column = cur.startPosition.column + 1;
+            const lineText = lines[cur.startPosition.row] ?? "";
+            hits.push(Object.freeze({
+                path: rel,
+                line,
+                column,
+                preview: trimPreview(lineText),
+            }));
+        }
+        for (let i = cur.children.length - 1; i >= 0; i--) {
+            const c = cur.children[i];
+            if (c)
+                stack.push(c);
+        }
+    }
+}
+// ── ripgrep adapter ──────────────────────────────────────────
+async function hasRipgrep() {
+    const probe = await execFileNoThrow("which", ["rg"]);
+    return probe.exitCode === 0 && probe.stdout.trim().length > 0;
+}
+async function tryRipgrep(symbol, rootDir, exts, maxUsages) {
+    // -w: word boundary
+    // --no-heading: file:line:col:text format
+    // --column / -n: line numbers + column
+    // --color=never: clean output
+    // --glob: include only the requested extensions, exclude skip dirs
+    // -F: literal string (avoid regex escape footguns in `symbol`)
+    const args = ["-w", "-n", "--column", "--no-heading", "--color=never", "-F"];
+    for (const dir of DEFAULT_SKIP_DIRS) {
+        args.push("--glob", `!${dir}`);
+    }
+    for (const ext of exts) {
+        args.push("--glob", `*${ext}`);
+    }
+    args.push("--", symbol, rootDir);
+    const out = await execFileNoThrow("rg", args);
+    // rg exits 1 when no matches — we treat that as empty, not failure.
+    if (out.exitCode !== 0 && out.exitCode !== 1)
+        return null;
+    return parseRipgrepOutput(out.stdout, rootDir, maxUsages);
+}
+function parseRipgrepOutput(stdout, rootDir, maxUsages) {
+    const lines = stdout.split("\n");
+    const hits = [];
+    let truncated = false;
+    for (const raw of lines) {
+        if (raw.length === 0)
+            continue;
+        if (hits.length >= maxUsages) {
+            truncated = true;
+            break;
+        }
+        const parts = splitRgLine(raw);
+        if (parts === null)
+            continue;
+        const { path: abs, line, column, text } = parts;
+        const rel = relative(rootDir, abs).split(sep).join("/");
+        hits.push(Object.freeze({
+            path: rel,
+            line,
+            column,
+            preview: trimPreview(text),
+        }));
+    }
+    return { usages: Object.freeze(hits), truncated };
+}
+function splitRgLine(raw) {
+    // Format: PATH:LINE:COLUMN:TEXT
+    // POSIX paths don't usually contain colons; we anchor on `:N:M:`
+    // pattern from the right so the LAST two numeric colons are line+col.
+    const m = raw.match(/^(.+?):(\d+):(\d+):(.*)$/);
+    if (!m)
+        return null;
+    const path = m[1] ?? "";
+    const lineStr = m[2] ?? "";
+    const colStr = m[3] ?? "";
+    const text = m[4] ?? "";
+    const line = Number(lineStr);
+    const column = Number(colStr);
+    if (!Number.isFinite(line) || !Number.isFinite(column))
+        return null;
+    return { path, line, column, text };
+}
+// ── Node-grep adapter (pure fallback) ────────────────────────
+async function tryNodeGrep(symbol, rootDir, exts, maxUsages) {
+    let files;
+    try {
+        files = await walkAsync(rootDir, exts);
+    }
+    catch {
+        return null;
+    }
+    const hits = [];
+    let truncated = false;
+    const pattern = new RegExp(`\\b${escapeRegex(symbol)}\\b`, "g");
+    for (const abs of files) {
+        if (hits.length >= maxUsages) {
+            truncated = true;
+            break;
+        }
+        let content;
+        try {
+            content = await readFile(abs, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        const lines = content.split(/\r?\n/);
+        for (let i = 0; i < lines.length; i++) {
+            const lineText = lines[i] ?? "";
+            pattern.lastIndex = 0;
+            let m;
+            while ((m = pattern.exec(lineText)) !== null) {
+                if (hits.length >= maxUsages) {
+                    truncated = true;
+                    break;
+                }
+                const column = m.index + 1;
+                const rel = relative(rootDir, abs).split(sep).join("/");
+                hits.push(Object.freeze({
+                    path: rel,
+                    line: i + 1,
+                    column,
+                    preview: trimPreview(lineText),
+                }));
+            }
+            if (truncated)
+                break;
+        }
+    }
+    return { usages: Object.freeze(hits), truncated };
+}
+async function walkAsync(root, exts) {
+    const out = [];
+    const stack = [root];
+    const extSet = new Set(exts.map((e) => e.toLowerCase()));
+    const skipDirs = new Set(DEFAULT_SKIP_DIRS);
+    while (stack.length > 0) {
+        const dir = stack.pop();
+        if (!dir)
+            break;
+        let entries;
+        try {
+            entries = await readdir(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const name of entries) {
+            // Skip dotfiles / dot-dirs (parallels code-graph's walker).
+            if (name.startsWith("."))
+                continue;
+            if (skipDirs.has(name))
+                continue;
+            const full = join(dir, name);
+            let s;
+            try {
+                s = await stat(full);
+            }
+            catch {
+                continue;
+            }
+            if (s.isDirectory()) {
+                stack.push(full);
+            }
+            else if (s.isFile() && extSet.has(extname(full).toLowerCase())) {
+                out.push(full);
+            }
+        }
+    }
+    return out;
+}
+// ── Helpers ─────────────────────────────────────────────────
+function extensionsFor(languages) {
+    if (!languages || languages.length === 0)
+        return ALL_DEFAULT_EXTS;
+    const out = [];
+    for (const lang of languages) {
+        for (const ext of LANG_EXTENSIONS[lang]) {
+            if (!out.includes(ext))
+                out.push(ext);
+        }
+    }
+    return out;
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function trimPreview(line) {
+    // Trim outer whitespace then cap to 120 cells. We measure by code
+    // units, not grapheme cells — full Unicode width is out of scope here
+    // but the cap keeps console output from wrapping on terminal widths
+    // we care about (80-160 cols).
+    //
+    // Slice-then-trim because a 120-char slice can land on a space (e.g.
+    // when the trimmed source is `x x x x ...` and char 120 is a space).
+    // Trimming again guarantees `preview === preview.trim()` regardless
+    // of where the slice point lands.
+    const trimmed = line.trim();
+    if (trimmed.length <= 120)
+        return trimmed;
+    return trimmed.slice(0, 120).trim();
+}
+/**
+ * Wrap the raw engine output in the public BlastRadiusResult shape.
+ * This is where the "LOW USAGE" warning rule fires.
+ */
+function finalize(symbol, usages, truncated, maxUsages) {
+    const fileCount = countDistinctFiles(usages);
+    const warning = usages.length <= 1 ? `LOW USAGE: ≤ 1 usage of ${symbol} across ${fileCount} files` : null;
+    // Apply the maxUsages cap defensively in case an engine forgot.
+    const safeUsages = usages.length > maxUsages ? Object.freeze(usages.slice(0, maxUsages)) : usages;
+    const safeTruncated = truncated || usages.length > maxUsages;
+    return Object.freeze({
+        symbol,
+        usages: safeUsages,
+        truncated: safeTruncated,
+        warning,
+    });
+}
+function countDistinctFiles(usages) {
+    const set = new Set();
+    for (const u of usages)
+        set.add(u.path);
+    return set.size;
+}
+//# sourceMappingURL=blast-radius.js.map

package/dist/intelligence/blast-radius.js.map

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

package/dist/intelligence/code-graph.d.ts

@@ -2,14 +2,44 @@
  * code-graph — port of abhigyanpatwari/GitNexus.
  *
  * GitNexus parses a repo into a `{nodes, edges}` symbol graph using
- * tree-sitter. Tree-sitter is not in the WOTANN dep set, so this
- * module ships two paths:
- *   - buildWithTreeSitter(): caller-supplied parser. Honest stub when
- *     no parser is given (QB#6 — typed failure with hint).
+ * tree-sitter. Tree-sitter is an OPTIONAL peer dep — this module
+ * ships three paths:
+ *   - buildWithTreeSitter() with `parser === undefined`: auto-detect.
+ *     Dynamic-imports `tree-sitter`, `tree-sitter-javascript`,
+ *     `tree-sitter-typescript`. If any is missing, returns
+ *     `{ok:false, error:"tree-sitter-not-installed", ...}`.
+ *     Enable by running:
+ *       npm install --save-optional tree-sitter tree-sitter-javascript tree-sitter-typescript
+ *   - buildWithTreeSitter() with explicit shim: caller-supplied parser
+ *     (back-compat — host environments can plug in any tree-sitter
+ *     binding without WOTANN owning the dep).
+ *   - buildWithTreeSitter() with `parser === null`: honest "not
+ *     supplied" stub (QB#6 — typed failure with hint).
  *   - buildWithGrep(): pure-Node regex fallback for TS/JS/Py/Go.
+ *
+ * Tree-sitter API references (cited so future maintainers can find
+ * the surface we depend on without re-reading the bindings):
+ *   - node-tree-sitter (main JS binding):
+ *       https://github.com/tree-sitter/node-tree-sitter
+ *       https://www.npmjs.com/package/tree-sitter
+ *     Public surface used here: `new Parser()`, `parser.setLanguage(lang)`,
+ *     `parser.parse(source) -> Tree`, `tree.rootNode -> SyntaxNode`.
+ *   - tree-sitter-javascript: https://github.com/tree-sitter/tree-sitter-javascript
+ *   - tree-sitter-typescript: https://github.com/tree-sitter/tree-sitter-typescript
+ *     Exports two languages: `typescript` and `tsx`. Both consumed below.
+ *   - SyntaxNode docs:
+ *       https://tree-sitter.github.io/tree-sitter/using-parsers#syntax-nodes
+ *     Properties used: `type`, `text`, `startPosition.{row,column}`,
+ *     `children`, `childForFieldName(name)`, `namedChildren`.
+ *   - Grammar node-type taxonomy (the type strings we match against):
+ *       https://github.com/tree-sitter/tree-sitter-javascript/blob/master/src/node-types.json
+ *       https://github.com/tree-sitter/tree-sitter-typescript/blob/master/typescript/src/node-types.json
+ *
  * Persistence: `~/.wotann/code-graph.json` via atomicWriteJson.
  *
- * Quality bars: stateless (Bar #7), wired persistence (Bar #19).
+ * Quality bars: stateless (Bar #7), wired persistence (Bar #19),
+ * immutable cache (set-once parser registry), honest per-file failure
+ * (one parse throw does not abort the whole build).
  */
 export type SymbolKind = "function" | "class" | "type" | "interface" | "module";
 export type EdgeKind = "imports" | "calls" | "extends" | "implements" | "contains";
@@ -71,8 +101,29 @@ export interface TreeSitterNode {
     readonly children: readonly TreeSitterNode[];
 }
 export declare function buildWithGrep(rootDir: string, options?: BuildOptions): BuildResult;
-/** Tree-sitter path. Caller supplies a parser; honest stub when null (QB#6). */
-export declare function buildWithTreeSitter(_rootDir: string, parser: TreeSitterShim | null, _options?: BuildOptions): BuildResult;
+/**
+ * Reset the parser cache. Test-only seam so a clean process state can
+ * be simulated. NOT part of the public API contract.
+ *
+ * @internal
+ */
+export declare function __resetTreeSitterCacheForTests(): void;
+/**
+ * Tree-sitter path.
+ *
+ * Modes (chosen by the value of `parser`):
+ *   - `undefined` (omitted): auto-detect via dynamic import. If
+ *     tree-sitter and its grammar packages are not installed,
+ *     returns `{ok:false, error:"tree-sitter-not-installed"}`.
+ *   - `null`: honest "not supplied" stub (QB#6, preserved for
+ *     back-compat with callers that pass an explicit null).
+ *   - `TreeSitterShim`: caller-supplied parser (host plugs in any
+ *     binding satisfying our minimal shim interface).
+ *
+ * To enable the auto-detect path:
+ *   npm install --save-optional tree-sitter tree-sitter-javascript tree-sitter-typescript
+ */
+export declare function buildWithTreeSitter(rootDir: string, parser?: TreeSitterShim | null, options?: BuildOptions): Promise<BuildResult>;
 /** Default file path used by save/load. Honors WOTANN_HOME. */
 export declare function defaultGraphPath(): string;
 export declare function saveCodeGraph(graph: CodeGraph, path?: string): Promise<string>;

package/dist/intelligence/code-graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-graph.d.ts","sourceRoot":"","sources":["../../src/intelligence/code-graph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"code-graph.d.ts","sourceRoot":"","sources":["../../src/intelligence/code-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AASH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAChF,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,UAAU,CAAC;AAEnF,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC;KACjC,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AACD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AACD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAI7C,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,cAAc,CAAA;KAAE,CAAC;CACrD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;CAC9C;AA+ID,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,WAAW,CAuBtF;AA2GD;;;;;GAKG;AACH,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AAiJD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,EAC9B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CAqEtB;AAID,+DAA+D;AAC/D,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIpF;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAS7D"}