@fodx/codelens 1.0.0

package/build/src/db/schema.sql

@@ -0,0 +1,111 @@
+-- Context Expert — schema v1
+-- All tables scoped by index_id (branch/worktree/head namespace).
+-- Managed by src/db/migrations.ts; do not edit in place — add migrations.
+
+CREATE TABLE IF NOT EXISTS schema_version (
+  version INTEGER PRIMARY KEY,
+  applied_at INTEGER NOT NULL
+);
+
+-- Index namespace: repo + worktree + branch + head
+CREATE TABLE IF NOT EXISTS indexes (
+  id           TEXT PRIMARY KEY,
+  repo_root     TEXT NOT NULL,
+  worktree_path TEXT NOT NULL,
+  branch_name   TEXT NOT NULL,
+  head_sha      TEXT NOT NULL,
+  created_at    INTEGER NOT NULL,
+  last_accessed_at INTEGER NOT NULL,
+  expires_at    INTEGER,          -- NULL = active, never expire
+  pinned        INTEGER NOT NULL DEFAULT 0,
+  status        TEXT NOT NULL DEFAULT 'active'  -- active|stale|deleted
+);
+
+CREATE INDEX IF NOT EXISTS idx_indexes_branch ON indexes(branch_name);
+
+-- File records within an index
+CREATE TABLE IF NOT EXISTS files (
+  id            TEXT PRIMARY KEY,
+  index_id      TEXT NOT NULL,
+  path          TEXT NOT NULL,       -- POSIX repo-relative
+  language      TEXT,
+  size          INTEGER NOT NULL,
+  mtime_ms      INTEGER NOT NULL,
+  content_hash  TEXT,                 -- xxhash of content
+  git_blob_sha  TEXT,
+  deleted       INTEGER NOT NULL DEFAULT 0,
+  last_indexed_at INTEGER NOT NULL,
+  FOREIGN KEY (index_id) REFERENCES indexes(id) ON DELETE CASCADE
+);
+CREATE INDEX IF NOT EXISTS idx_files_index_path ON files(index_id, path);
+
+-- Symbols (functions/classes/methods/types/exports/imports)
+CREATE TABLE IF NOT EXISTS symbols (
+  id          TEXT PRIMARY KEY,
+  index_id    TEXT NOT NULL,
+  file_id     TEXT NOT NULL,
+  path        TEXT NOT NULL,
+  name        TEXT NOT NULL,
+  kind        TEXT NOT NULL,          -- function|class|method|type|interface|constant|import|export
+  signature   TEXT,
+  start_line  INTEGER NOT NULL,
+  end_line    INTEGER NOT NULL,
+  exported    INTEGER NOT NULL DEFAULT 0,
+  doc         TEXT,
+  FOREIGN KEY (index_id) REFERENCES indexes(id) ON DELETE CASCADE,
+  FOREIGN KEY (file_id) REFERENCES files(id) ON DELETE CASCADE
+);
+CREATE INDEX IF NOT EXISTS idx_symbols_index_name ON symbols(index_id, name);
+CREATE INDEX IF NOT EXISTS idx_symbols_index_file ON symbols(index_id, file_id);
+
+-- Chunks (text slices for FTS + embedding)
+CREATE TABLE IF NOT EXISTS chunks (
+  id            TEXT PRIMARY KEY,
+  index_id      TEXT NOT NULL,
+  file_id       TEXT NOT NULL,
+  symbol_id     TEXT,
+  path          TEXT NOT NULL,
+  start_line    INTEGER NOT NULL,
+  end_line      INTEGER NOT NULL,
+  content       TEXT NOT NULL,
+  content_hash  TEXT,
+  content_type  TEXT NOT NULL DEFAULT 'prose', -- prose|code
+  FOREIGN KEY (index_id) REFERENCES indexes(id) ON DELETE CASCADE,
+  FOREIGN KEY (file_id) REFERENCES files(id) ON DELETE CASCADE
+);
+CREATE INDEX IF NOT EXISTS idx_chunks_index_file ON chunks(index_id, file_id);
+CREATE INDEX IF NOT EXISTS idx_chunks_symbol ON chunks(symbol_id);
+
+-- FTS5 virtual table over chunk content (content-less external content via rowid map)
+CREATE VIRTUAL TABLE IF NOT EXISTS chunks_fts USING fts5(
+  content,
+  path,
+  index_id UNINDEXED,
+  chunk_id UNINDEXED,
+  tokenize = 'porter'
+);
+
+-- Graph edges
+CREATE TABLE IF NOT EXISTS edges (
+  id          TEXT PRIMARY KEY,
+  index_id    TEXT NOT NULL,
+  from_id     TEXT,
+  to_id       TEXT,
+  from_path   TEXT,
+  to_path     TEXT,
+  type        TEXT NOT NULL,          -- imports|imported_by|defines|exports|references|calls|tests|belongs_to
+  confidence  REAL NOT NULL DEFAULT 1.0,
+  FOREIGN KEY (index_id) REFERENCES indexes(id) ON DELETE CASCADE
+);
+CREATE INDEX IF NOT EXISTS idx_edges_index_from ON edges(index_id, from_id);
+CREATE INDEX IF NOT EXISTS idx_edges_index_to ON edges(index_id, to_id);
+CREATE INDEX IF NOT EXISTS idx_edges_index_type ON edges(index_id, type);
+
+
+-- Advisory write locks (cross-process, leased)
+CREATE TABLE IF NOT EXISTS index_locks (
+  index_id    TEXT NOT NULL,
+  owner       TEXT NOT NULL,
+  expires_at  INTEGER NOT NULL,
+  PRIMARY KEY (index_id)
+);

package/build/src/git/scope.js

@@ -0,0 +1,68 @@
+import { spawnSync } from "node:child_process";
+import { resolveReal, toPosix } from "../util/paths.js";
+function git(cwd, args) {
+    const r = spawnSync("git", args, { cwd, encoding: "utf-8" });
+    if (r.error || r.status !== 0)
+        return { ok: false, stdout: r.stdout ?? "" };
+    return { ok: true, stdout: r.stdout.trim() };
+}
+/** Detect the git scope for `cwd`. Returns null if not inside a git repo. */
+export function detectScope(cwd) {
+    const root = git(cwd, ["rev-parse", "--show-toplevel"]);
+    if (!root.ok || root.stdout.length === 0)
+        return null;
+    const repoRoot = resolveReal(root.stdout);
+    // --show-toplevel returns the main repo for worktrees; use --show-cdup + pwd
+    // for the actual checkout path. git worktree list --porcelain would be heavier.
+    const commonDir = git(cwd, ["rev-parse", "--git-common-dir"]);
+    const gitDir = git(cwd, ["rev-parse", "--absolute-git-dir"]);
+    // worktreePath = the checkout root (where .git link points). For a linked
+    // worktree, --show-toplevel already returns the worktree path, not the main.
+    const worktreePath = resolveReal(root.stdout);
+    const head = git(cwd, ["rev-parse", "HEAD"]);
+    if (!head.ok || head.stdout.length === 0) {
+        // Fresh repo with no commits — treat as detached with empty head.
+        return {
+            repoRoot,
+            worktreePath,
+            branch: "DETACHED",
+            headSha: "",
+            dirtyFiles: listDirty(cwd),
+            detached: true,
+        };
+    }
+    const headSha = head.stdout;
+    const branchOut = git(cwd, ["branch", "--show-current"]);
+    const detached = !branchOut.ok || branchOut.stdout.length === 0;
+    const branch = detached ? "DETACHED" : branchOut.stdout;
+    // commonDir/gitDir unused for now but validated to keep git presence robust.
+    void commonDir;
+    void gitDir;
+    return {
+        repoRoot,
+        worktreePath,
+        branch,
+        headSha,
+        dirtyFiles: listDirty(cwd),
+        detached,
+    };
+}
+/** List repo-relative posix paths that are changed or untracked (not ignored). */
+export function listDirty(cwd) {
+    const r = spawnSync("git", ["status", "--porcelain", "-z"], { cwd, encoding: "utf-8" });
+    if (r.error || r.status !== 0)
+        return [];
+    // -z separates records by NUL; each record is "XY path" (or "XY orig -> path" for renames).
+    const out = r.stdout ?? "";
+    const files = [];
+    for (const rec of out.split("\0")) {
+        if (rec.length === 0)
+            continue;
+        // status code is 2 chars, then a space, then path (possibly "orig -> path").
+        const path = rec.slice(3);
+        const finalPath = path.includes(" -> ") ? path.split(" -> ")[1] ?? path : path;
+        files.push(toPosix(finalPath));
+    }
+    return files;
+}
+//# sourceMappingURL=scope.js.map

package/build/src/git/scope.js.map

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

package/build/src/graph/edges.js

@@ -0,0 +1,76 @@
+import { randomUUID } from "node:crypto";
+import { makeParser } from "./grammars.js";
+import { resolveImportFs, resolveImport } from "./resolve.js";
+// Node types that carry an import spec, per grammar.
+const IMPORT_SPEC_FIELDS = ["source", "module_name", "name", "path"];
+function importSpec(node) {
+    // Try named fields first.
+    for (const f of IMPORT_SPEC_FIELDS) {
+        const child = node.childForFieldName?.(f);
+        if (child)
+            return stripQuotes(child.text);
+    }
+    // Walk for string literals.
+    for (const c of iterAll(node)) {
+        if (c.type === "string" || c.type === "string_fragment")
+            return stripQuotes(c.text);
+    }
+    return null;
+}
+function* iterAll(node) {
+    yield node;
+    for (const c of node.children)
+        yield* iterAll(c);
+}
+function stripQuotes(s) {
+    return s.replace(/^["'`]|["'`]$/g, "");
+}
+/**
+ * Extract edges for a single file. `knownFiles` (repo-relative POSIX set) is
+ * used to resolve imports to indexed files; falls back to the filesystem.
+ */
+export function extractEdges(path, lang, source, repoRoot, knownFiles) {
+    const parser = makeParser(lang);
+    if (!parser)
+        return [];
+    let tree;
+    try {
+        tree = parser.parse(source);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    const root = tree.rootNode;
+    // Walk for import statements.
+    for (const node of iterAll(root)) {
+        if (node.type === "import_statement" || node.type === "import_declaration" || node.type === "import_from_statement") {
+            const spec = importSpec(node);
+            if (!spec)
+                continue;
+            const target = resolveImportFs(repoRoot, path, spec) ?? resolveImport(path, spec, knownFiles);
+            out.push({
+                fromPath: path,
+                toPath: target,
+                fromSymbol: null,
+                toSymbol: null,
+                type: "imports",
+                confidence: target ? 0.9 : 0.0,
+            });
+            if (!target) {
+                // unresolved — keep no-edge policy (confidence 0 filtered on insert)
+            }
+        }
+    }
+    return out;
+}
+/** Insert extracted edges into the edges table (skips unresolved imports). */
+export function insertEdges(db, indexId, edges) {
+    const stmt = db.prepare(`INSERT INTO edges (id, index_id, from_id, to_id, from_path, to_path, type, confidence) VALUES (?, ?, NULL, NULL, ?, ?, ?, ?)`);
+    for (const e of edges) {
+        if (e.type === "imports" && !e.toPath)
+            continue; // unresolved → no edge
+        stmt.run("edge_" + randomUUID(), indexId, e.fromPath, e.toPath, e.type, e.confidence);
+    }
+}
+//# sourceMappingURL=edges.js.map

package/build/src/graph/edges.js.map

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

package/build/src/graph/grammars.js

@@ -0,0 +1,57 @@
+import Parser from "tree-sitter";
+import { createRequire } from "node:module";
+const _require = createRequire(import.meta.url);
+const GRAMMAR_LOADERS = {
+    typescript: () => _require("tree-sitter-typescript").typescript,
+    javascript: () => _require("tree-sitter-javascript"),
+    python: () => _require("tree-sitter-python"),
+    go: () => _require("tree-sitter-go"),
+    rust: () => _require("tree-sitter-rust"),
+    java: () => _require("tree-sitter-java"),
+    ruby: () => _require("tree-sitter-ruby"),
+    php: () => _require("tree-sitter-php").php,
+    c: () => _require("tree-sitter-c"),
+    cpp: () => _require("tree-sitter-cpp"),
+};
+const cache = new Map();
+/** Get the tree-sitter Language for a language name, or null if unavailable. */
+export function loadGrammar(lang) {
+    if (cache.has(lang))
+        return cache.get(lang) ?? null;
+    const loader = GRAMMAR_LOADERS[lang];
+    if (!loader) {
+        cache.set(lang, null);
+        return null;
+    }
+    try {
+        const grammar = loader();
+        cache.set(lang, grammar);
+        return grammar;
+    }
+    catch {
+        cache.set(lang, null);
+        return null;
+    }
+}
+/** Whether a language has a usable tree-sitter grammar. */
+export function isSupported(lang) {
+    if (!lang)
+        return false;
+    return loadGrammar(lang) !== null;
+}
+/** Create a configured Parser for a language, or null if unavailable. */
+export function makeParser(lang) {
+    const grammar = loadGrammar(lang);
+    if (!grammar)
+        return null;
+    try {
+        const parser = new Parser();
+        // setLanguage signature varies across bindings; the grammar object is the Language.
+        parser.setLanguage(grammar);
+        return parser;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=grammars.js.map

package/build/src/graph/grammars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammars.js","sourceRoot":"","sources":["../../../src/graph/grammars.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAYhD,MAAM,eAAe,GAAmC;IACtD,UAAU,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC,UAAsB;IAC3E,UAAU,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAa;IAChE,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAa;IACxD,EAAE,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAa;IAChD,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAa;IACpD,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAa;IACpD,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAa;IACpD,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,GAAe;IACtD,CAAC,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAa;IAC9C,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAa;CACnD,CAAC;AAEF,MAAM,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEjD,gFAAgF;AAChF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IACpD,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC;QACzB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACzB,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,WAAW,CAAC,IAA+B;IACzD,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;AACpC,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAC5B,oFAAoF;QACnF,MAA2D,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAClF,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/build/src/graph/query.js

@@ -0,0 +1,52 @@
+const EDGE_TYPES_ALL = ["imports", "imported_by", "defines", "exports", "references", "calls", "tests", "belongs_to"];
+const MAX_DEPTH = 3;
+/** Recursive CTE neighbors of `startPath`, filtered by edge types, bounded by depth. */
+export function neighbors(db, indexId, startPath, opts = {}) {
+    const types = opts.types ?? EDGE_TYPES_ALL;
+    const depth = Math.min(opts.depth ?? 2, MAX_DEPTH);
+    const direction = opts.direction ?? "both";
+    // Direction determines which edge column must equal the current node, and
+    // which end is the neighbor.
+    //   out: match e.from_path = node → neighbor = e.to_path
+    //   in:  match e.to_path   = node → neighbor = e.from_path
+    //   both: either end matches → neighbor is the other end
+    const matchClause = direction === "out" ? "e.from_path = w.node" :
+        direction === "in" ? "e.to_path = w.node" :
+            "(e.from_path = w.node OR e.to_path = w.node)";
+    const neighborExpr = direction === "out" ? "e.to_path" :
+        direction === "in" ? "e.from_path" :
+            "CASE WHEN e.from_path = w.node THEN e.to_path ELSE e.from_path END";
+    const typePlaceholders = types.map(() => "?").join(",");
+    const seenGuard = `instr(w.seen, ',' || ${neighborExpr} || ',') = 0`;
+    const sql = `
+    WITH RECURSIVE walk(node, edge_type, hops, confidence, seen) AS (
+      SELECT ?, NULL, 0, 1.0, ',' || ? || ','
+      UNION
+      SELECT
+        ${neighborExpr},
+        e.type,
+        w.hops + 1,
+        e.confidence,
+        w.seen || ${neighborExpr} || ','
+      FROM edges e
+      JOIN walk w ON ${matchClause}
+      WHERE e.index_id = ?
+        AND e.type IN (${typePlaceholders})
+        AND w.hops < ?
+        AND ${seenGuard}
+    )
+    SELECT node AS path, edge_type AS edgeType, MIN(hops) AS hops, MAX(confidence) AS confidence
+    FROM walk
+    WHERE node != ? AND edge_type IS NOT NULL
+    GROUP BY node, edge_type
+    ORDER BY hops ASC, confidence DESC
+  `;
+    const rows = db.prepare(sql).all(startPath, startPath, indexId, ...types, depth, startPath);
+    return rows.map((r) => ({ path: r.path, edgeType: r.edgeType, hops: r.hops, confidence: r.confidence }));
+}
+/** Files that emit `tests` edges pointing at `sourcePath`. */
+export function testsFor(db, indexId, sourcePath) {
+    const rows = db.prepare(`SELECT from_path AS path, confidence FROM edges WHERE index_id = ? AND type = 'tests' AND to_path = ?`).all(indexId, sourcePath);
+    return rows.map((r) => ({ path: r.path, edgeType: "tests", hops: 1, confidence: r.confidence }));
+}
+//# sourceMappingURL=query.js.map

package/build/src/graph/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/graph/query.ts"],"names":[],"mappings":"AAcA,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;AACtH,MAAM,SAAS,GAAG,CAAC,CAAC;AAEpB,wFAAwF;AACxF,MAAM,UAAU,SAAS,CACvB,EAAqB,EACrB,OAAe,EACf,SAAiB,EACjB,OAAgF,EAAE;IAElF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,cAAc,CAAC;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC;IAE3C,0EAA0E;IAC1E,6BAA6B;IAC7B,yDAAyD;IACzD,2DAA2D;IAC3D,yDAAyD;IACzD,MAAM,WAAW,GACf,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC;QAC9C,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;YAC3C,8CAA8C,CAAC;IACjD,MAAM,YAAY,GAChB,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QACnC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;YACpC,oEAAoE,CAAC;IAEvE,MAAM,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,wBAAwB,YAAY,cAAc,CAAC;IAErE,MAAM,GAAG,GAAG;;;;;UAKJ,YAAY;;;;oBAIF,YAAY;;uBAET,WAAW;;yBAET,gBAAgB;;cAE3B,SAAS;;;;;;;GAOpB,CAAC;IAEF,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAC9B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,SAAS,CACsC,CAAC;IAE5E,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;AAC3G,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,QAAQ,CAAC,EAAqB,EAAE,OAAe,EAAE,UAAkB;IACjF,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CACrB,uGAAuG,CACxG,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAA2C,CAAC;IACrE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;AACnG,CAAC"}

package/build/src/graph/resolve.js

@@ -0,0 +1,68 @@
+import { posix, join } from "node:path";
+import { existsSync, statSync } from "node:fs";
+/**
+ * Import resolution (Step 14).
+ *
+ * Resolves a relative import spec to a candidate repo-relative file path,
+ * trying extension substitution (incl. TS ESM `.js`→`.ts`), extension
+ * fallbacks, and index files. Returns null if unresolved (no edge — better to
+ * emit no edge than a wrong one).
+ */
+const EXT_FALLBACKS = [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs", ".d.ts", ".py", ".go", ".rs", ".java", ".rb", ".php", ".c", ".cpp"];
+const INDEX_FILES = ["index.ts", "index.tsx", "index.js", "index.jsx", "index.mjs", "index.py", "__init__.py"];
+// TS ESM convention: `import x from "./foo.js"` resolves to `./foo.ts`.
+const JS_TO_TS = {
+    ".js": [".ts", ".tsx", ".d.ts", ".mts", ".cts"],
+    ".jsx": [".tsx", ".d.ts"],
+    ".mjs": [".mts", ".ts"],
+    ".cjs": [".cts", ".ts"],
+};
+function isRelative(spec) {
+    return spec.startsWith("./") || spec.startsWith("../") || spec.startsWith(".");
+}
+/** Ordered candidate repo-relative paths to try for a resolved target. */
+function* candidates(target) {
+    yield target;
+    // TS extension substitution: "./foo.js" → "./foo.ts" etc.
+    for (const [jsExt, tsExts] of Object.entries(JS_TO_TS)) {
+        if (target.endsWith(jsExt)) {
+            const stem = target.slice(0, -jsExt.length);
+            for (const ts of tsExts)
+                yield stem + ts;
+        }
+    }
+    // Append fallback extensions (only when target has no extension, to avoid
+    // producing "./foo.js.ts").
+    if (posix.extname(target) === "") {
+        for (const ext of EXT_FALLBACKS)
+            yield target + ext;
+    }
+    // Directory + index files.
+    for (const idx of INDEX_FILES)
+        yield posix.join(target, idx);
+}
+/** Resolve a relative import from `fromPath` (repo-relative POSIX) to a repo-relative target path. */
+export function resolveImport(fromPath, spec, knownFiles) {
+    if (!isRelative(spec))
+        return null; // bare specifier (npm/builtin) — not a repo file
+    const base = posix.dirname(fromPath);
+    const target = posix.normalize(posix.join(base, spec));
+    for (const cand of candidates(target))
+        if (knownFiles.has(cand))
+            return cand;
+    return null;
+}
+/** Filesystem-backed resolution when knownFiles is incomplete. */
+export function resolveImportFs(repoRoot, fromPath, spec) {
+    if (!isRelative(spec))
+        return null;
+    const base = posix.dirname(fromPath);
+    const target = posix.normalize(posix.join(base, spec));
+    for (const cand of candidates(target)) {
+        const abs = join(repoRoot, cand);
+        if (existsSync(abs) && statSync(abs).isFile())
+            return cand;
+    }
+    return null;
+}
+//# sourceMappingURL=resolve.js.map

package/build/src/graph/resolve.js.map

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

package/build/src/graph/symbols.js

@@ -0,0 +1,84 @@
+import { makeParser } from "./grammars.js";
+// Node types → symbol kind. Covers TS/JS/Python/Go/Rust/Java/Ruby/PHP/C/C++.
+const SYMBOL_TYPES = {
+    function_declaration: "function",
+    function_definition: "function",
+    method_definition: "method",
+    method_declaration: "method",
+    function_signature: "function",
+    class_declaration: "class",
+    class_definition: "class",
+    interface_declaration: "interface",
+    interface_statement: "interface",
+    type_alias_declaration: "type",
+    type_definition: "type",
+    enum_declaration: "type",
+    enum_statement: "type",
+    lexical_declaration: "constant",
+    variable_declaration: "constant",
+    import_statement: "import",
+    import_declaration: "import",
+    import_from_statement: "import",
+    export_statement: "export",
+    export_declaration: "export",
+};
+// Node types that indicate an export (TS/JS).
+const EXPORT_WRAPPERS = new Set(["export_statement", "export_declaration"]);
+export function extractSymbols(path, lang, source) {
+    const parser = makeParser(lang);
+    if (!parser)
+        return [];
+    let tree;
+    try {
+        tree = parser.parse(source);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    const root = tree.rootNode;
+    function nodeName(node) {
+        const nameNode = node.childForFieldName?.("name");
+        if (nameNode)
+            return nameNode.text;
+        for (const c of node.namedChildren) {
+            if (c.type === "identifier" || c.type === "property_identifier")
+                return c.text;
+        }
+        return null;
+    }
+    function isExported(node) {
+        if (EXPORT_WRAPPERS.has(node.type))
+            return true;
+        if (node.parent && EXPORT_WRAPPERS.has(node.parent.type))
+            return true;
+        const text = node.text;
+        const name = nodeName(node) ?? "";
+        const head = text.slice(0, text.indexOf(name));
+        return /\bexport\b/.test(head);
+    }
+    function walk(node) {
+        const kind = SYMBOL_TYPES[node.type];
+        if (kind && kind !== "import" && kind !== "export") {
+            const name = nodeName(node);
+            if (name) {
+                out.push({
+                    name,
+                    kind,
+                    startLine: node.startPosition.row + 1,
+                    endLine: node.endPosition.row + 1,
+                    signature: firstLine(node.text),
+                    exported: isExported(node),
+                });
+            }
+        }
+        for (const child of node.namedChildren)
+            walk(child);
+    }
+    walk(root);
+    return out;
+}
+function firstLine(text) {
+    return text.split("\n")[0] ?? text;
+}
+//# sourceMappingURL=symbols.js.map

package/build/src/graph/symbols.js.map

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

package/build/src/graph/tests.js

@@ -0,0 +1,73 @@
+import { posix, basename, dirname } from "node:path";
+/**
+ * Test heuristics (Step 15).
+ *
+ * Infers test-to-source relationships from filename/path conventions:
+ *   foo.test.ts   → foo.ts
+ *   foo.spec.ts   → foo.ts
+ *   __tests__/foo.test.ts → ../foo.ts (or same-dir foo.ts)
+ *   tests/foo.ts  → ../src/foo.ts (best-effort)
+ *   foo_test.go   → foo.go
+ *   test_foo.py   → foo.py
+ * Returns candidate target paths; only emitted as a `tests` edge if the
+ * target exists in the indexed file set (no wrong edges).
+ */
+const TEST_SUFFIXES = [/\.test\.[a-z]+$/i, /\.spec\.[a-z]+$/i, /_test\.[a-z]+$/i, /\.test$/i, /\.spec$/i];
+const TEST_PREFIXES = [/^test_/i];
+const TEST_DIRS = ["__tests__", "tests", "test", "__test__"];
+/** Is this path a test file by name? */
+export function isTestFile(path) {
+    const base = basename(path);
+    if (TEST_SUFFIXES.some((re) => re.test(base)))
+        return true;
+    if (TEST_PREFIXES.some((re) => re.test(base)))
+        return true;
+    const dir = dirname(path);
+    return TEST_DIRS.some((d) => dir.split("/").includes(d));
+}
+/** Map a test file to candidate source file paths (repo-relative POSIX). */
+export function inferTestTargets(testPath) {
+    const base = basename(testPath);
+    const dir = dirname(testPath);
+    const candidates = new Set();
+    // Strip test suffix: foo.test.ts → foo.ts
+    for (const re of TEST_SUFFIXES) {
+        if (re.test(base)) {
+            const stripped = base.replace(re, "");
+            // Re-add a likely source extension: foo.test.ts → foo.ts
+            const ext = extOf(base);
+            candidates.add(posix.join(dir, stripped + (ext ? "." + ext : "")));
+            candidates.add(posix.join(dir, stripped));
+        }
+    }
+    // Strip test prefix: test_foo.py → foo.py
+    for (const re of TEST_PREFIXES) {
+        if (re.test(base)) {
+            const stripped = base.replace(re, "");
+            candidates.add(posix.join(dir, stripped));
+        }
+    }
+    // __tests__/foo.test.ts → ../foo.ts  and  ../src/foo.ts
+    const segs = dir.split("/");
+    if (segs.includes("__tests__") || segs.includes("tests") || segs.includes("test")) {
+        const base2 = base.replace(/\.test\.|\.spec\.|_test\./, ".");
+        const stripped = base2.replace(/\.[a-z]+$/, "");
+        const ext = extOf(base);
+        const parent = segs.slice(0, -1).join("/");
+        candidates.add(posix.join(parent, stripped + (ext ? "." + ext : "")));
+        candidates.add(posix.join(parent, "src", stripped + (ext ? "." + ext : "")));
+    }
+    return [...candidates];
+}
+function extOf(name) {
+    const m = name.match(/\.([a-z0-9]+)$/i);
+    return m ? m[1] : "";
+}
+/**
+ * Given the set of indexed files, return the source paths this test file
+ * likely tests (only those present in the file set).
+ */
+export function resolveTestTargets(testPath, knownFiles) {
+    return inferTestTargets(testPath).filter((p) => knownFiles.has(p));
+}
+//# sourceMappingURL=tests.js.map

package/build/src/graph/tests.js.map

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