@fodx/codelens 1.0.0

package/build/src/index/autoprune.js

@@ -0,0 +1,29 @@
+import { pruneIndexes } from "./ttl.js";
+import { enqueue } from "./queue.js";
+/**
+ * Automatic pruning scheduler (Step 23).
+ *
+ * Runs pruneIndexes on server startup, after index creation, and on a periodic
+ * idle timer. All pruning goes through the single-writer queue so it never
+ * blocks queries (WAL lets readers see the prior snapshot).
+ */
+const IDLE_INTERVAL_MS = 10 * 60 * 1000; // 10 minutes
+let timer = null;
+/** Run an immediate prune (queued, non-blocking). */
+export function pruneNow(db) {
+    void enqueue(() => pruneIndexes(db));
+}
+/** Schedule startup + periodic idle pruning. Returns a stop() function. */
+export function scheduleAutoPrune(db) {
+    pruneNow(db);
+    if (timer)
+        clearInterval(timer);
+    timer = setInterval(() => pruneNow(db), IDLE_INTERVAL_MS);
+    return () => {
+        if (timer) {
+            clearInterval(timer);
+            timer = null;
+        }
+    };
+}
+//# sourceMappingURL=autoprune.js.map

package/build/src/index/autoprune.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoprune.js","sourceRoot":"","sources":["../../../src/index/autoprune.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;GAMG;AAEH,MAAM,gBAAgB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAEtD,IAAI,KAAK,GAA0C,IAAI,CAAC;AAExD,qDAAqD;AACrD,MAAM,UAAU,QAAQ,CAAC,EAAqB;IAC5C,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAAC,EAAqB;IACrD,QAAQ,CAAC,EAAE,CAAC,CAAC;IACb,IAAI,KAAK;QAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAChC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAC1D,OAAO,GAAG,EAAE;QACV,IAAI,KAAK,EAAE,CAAC;YAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAAC,KAAK,GAAG,IAAI,CAAC;QAAC,CAAC;IACpD,CAAC,CAAC;AACJ,CAAC"}

package/build/src/index/deny.js

@@ -0,0 +1,40 @@
+/**
+ * Heuristic deny list (Design Decisions #3 + Section 16 risk 5).
+ *
+ * Even when a path is untracked (not gitignored), deny generated/build output
+ * so it never pollutes the index. Configurable later via .contextignore.
+ */
+const DENY_DIRS = [
+    "node_modules/",
+    "build/",
+    "dist/",
+    "out/",
+    "coverage/",
+    ".cache/",
+    ".next/",
+    ".nuxt/",
+    ".turbo/",
+    ".svelte-kit/",
+    ".gradle/",
+    "target/", // Rust
+    "__pycache__/",
+    ".venv/",
+    "venv/",
+    ".mypy_cache/",
+    ".pytest_cache/",
+];
+const DENY_GLOBS = [
+    /\.min\.js$/,
+    /\.min\.css$/,
+    /\.map$/,
+    /(^|\/)vendor\//,
+    /\.bundle\.[a-z]+$/,
+];
+/** True if a POSIX repo-relative path should be denied (excluded from indexing). */
+export function shouldDeny(posixPath) {
+    if (DENY_DIRS.some((d) => posixPath.includes("/" + d)) || DENY_DIRS.some((d) => posixPath.startsWith(d))) {
+        return true;
+    }
+    return DENY_GLOBS.some((re) => re.test(posixPath));
+}
+//# sourceMappingURL=deny.js.map

package/build/src/index/deny.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deny.js","sourceRoot":"","sources":["../../../src/index/deny.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,SAAS,GAAG;IAChB,eAAe;IACf,QAAQ;IACR,OAAO;IACP,MAAM;IACN,WAAW;IACX,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,cAAc;IACd,UAAU;IACV,SAAS,EAAE,OAAO;IAClB,cAAc;IACd,QAAQ;IACR,OAAO;IACP,cAAc;IACd,gBAAgB;CACjB,CAAC;AAEF,MAAM,UAAU,GAAG;IACjB,YAAY;IACZ,aAAa;IACb,QAAQ;IACR,gBAAgB;IAChB,mBAAmB;CACpB,CAAC;AAEF,oFAAoF;AACpF,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC1C,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzG,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/build/src/index/freshness.js

@@ -0,0 +1,60 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { resolveReal } from "../util/paths.js";
+import { contentHash } from "../util/hash.js";
+/** Load indexed file rows for an index, keyed by POSIX path. */
+function loadStored(db, indexId) {
+    const rows = db
+        .prepare("SELECT id, path, size, mtime_ms, content_hash FROM files WHERE index_id = ? AND deleted = 0")
+        .all(indexId);
+    return new Map(rows.map((r) => [r.path, r]));
+}
+/**
+ * Diff scanned files vs stored rows. Fast path: skip hashing when size AND
+ * mtime match. Changed/new files are flagged for reindex (hashing happens
+ * inside indexFile in Step 10).
+ */
+export function diffFiles(db, indexId, scanned, repoRoot) {
+    const stored = loadStored(db, indexId);
+    const scannedByPath = new Map(scanned.map((f) => [f.path, f]));
+    const unchanged = [];
+    const changed = [];
+    const newFiles = [];
+    const deleted = [];
+    for (const f of scanned) {
+        const s = stored.get(f.path);
+        if (!s) {
+            newFiles.push(f);
+        }
+        else if (s.size === f.size && s.mtime_ms === f.mtimeMs) {
+            unchanged.push(f);
+        }
+        else {
+            changed.push(f);
+        }
+    }
+    for (const [path, s] of stored) {
+        if (!scannedByPath.has(path))
+            deleted.push({ path, id: s.id });
+    }
+    void repoRoot;
+    return { unchanged, changed, newFiles, deleted };
+}
+/**
+ * Strong check: recompute content hash and compare to stored. Used when mtime
+ * is ambiguous (e.g. after a checkout that resets mtime). Returns true if the
+ * file's content actually differs from what's indexed.
+ */
+export function contentChanged(repoRoot, file, storedHash) {
+    if (!storedHash)
+        return true;
+    try {
+        const root = resolveReal(repoRoot);
+        const text = readFileSync(join(root, file.path), "utf-8");
+        return contentHash(text) !== storedHash;
+    }
+    catch {
+        return true; // unreadable → treat as changed (will be re-skipped by indexer)
+    }
+}
+//# sourceMappingURL=freshness.js.map

package/build/src/index/freshness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.js","sourceRoot":"","sources":["../../../src/index/freshness.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA0B9C,gEAAgE;AAChE,SAAS,UAAU,CAAC,EAAqB,EAAE,OAAe;IACxD,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CAAC,6FAA6F,CAAC;SACtG,GAAG,CAAC,OAAO,CAAiB,CAAC;IAChC,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,EAAqB,EAAE,OAAe,EAAE,OAAsB,EAAE,QAAgB;IACxG,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAkB,EAAE,CAAC;IACpC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,MAAM,OAAO,GAAmC,EAAE,CAAC;IAEnD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;YACzD,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC;QAC/B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,KAAK,QAAQ,CAAC;IACd,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,IAAiB,EAAE,UAAyB;IAC3F,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAC1D,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,gEAAgE;IAC/E,CAAC;AACH,CAAC"}

package/build/src/index/fts.js

@@ -0,0 +1,125 @@
+import { randomUUID } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { resolveReal } from "../util/paths.js";
+import { contentHash } from "../util/hash.js";
+import { extractSymbols } from "../graph/symbols.js";
+import { extractEdges, insertEdges } from "../graph/edges.js";
+import { isTestFile, resolveTestTargets } from "../graph/tests.js";
+/**
+ * FTS5 chunk indexer (Step 7).
+ *
+ * Chunks a file into line-bounded slices (~500 "tokens" approximated as chars/4),
+ * stores a files row + chunks rows + FTS5 rows. Per-file transactional. Symbols
+ * and edges come in Steps 13-15.
+ */
+const CHUNK_CHARS = 2000; // ~500 tokens at ~4 chars/token
+/** Read a file's text (UTF-8). Throws on read failure — caller handles. */
+function readFileText(absPath) {
+    return readFileSync(absPath, "utf-8");
+}
+/** Split text into line-bounded chunks of roughly CHUNK_CHARS characters. */
+export function chunkText(text) {
+    const lines = text.split("\n");
+    const chunks = [];
+    let buf = [];
+    let bufChars = 0;
+    let startLine = 1;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        buf.push(line);
+        bufChars += line.length + 1;
+        if (bufChars >= CHUNK_CHARS) {
+            chunks.push({ startLine, endLine: i + 1, content: buf.join("\n") });
+            buf = [];
+            bufChars = 0;
+            startLine = i + 2;
+        }
+    }
+    if (buf.length > 0) {
+        chunks.push({ startLine, endLine: lines.length, content: buf.join("\n") });
+    }
+    return chunks;
+}
+/**
+ * Index a single file into files + chunks + chunks_fts. Transactional.
+ * Caller must pass the active indexId and the scanned file metadata.
+ */
+export function indexFile(db, indexId, repoRoot, file, knownFiles = new Set()) {
+    const root = resolveReal(repoRoot);
+    const abs = join(root, file.path);
+    const text = readFileText(abs);
+    const hash = contentHash(text);
+    const fileId = "file_" + randomUUID();
+    const chunks = chunkText(text);
+    const symbols = extractSymbols(file.path, file.language ?? "", text);
+    const edges = extractEdges(file.path, file.language ?? "", text, root, knownFiles);
+    const tx = db.transaction(() => {
+        // Remove ALL prior rows for this path+index so reindexing a changed file
+        // does not leave stale symbols/edges. Without this, incremental reindex
+        // would accumulate duplicate symbols + stale graph edges.
+        db.prepare("DELETE FROM chunks_fts WHERE index_id = ? AND path = ?").run(indexId, file.path);
+        db.prepare("DELETE FROM chunks WHERE index_id = ? AND path = ?").run(indexId, file.path);
+        db.prepare("DELETE FROM symbols WHERE index_id = ? AND path = ?").run(indexId, file.path);
+        // Only clear THIS file's outbound edges (from_path = file.path). Inbound edges
+        // from other files (e.g. Y imports X) stay valid since X still exists; they
+        // are only removed when X is deleted (deleteFileFromIndex uses from OR to).
+        db.prepare("DELETE FROM edges WHERE index_id = ? AND from_path = ?").run(indexId, file.path);
+        db.prepare("DELETE FROM files WHERE index_id = ? AND path = ?").run(indexId, file.path);
+        db.prepare(`INSERT INTO files (id, index_id, path, language, size, mtime_ms, content_hash, git_blob_sha, deleted, last_indexed_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, NULL, 0, ?)`).run(fileId, indexId, file.path, file.language, file.size, file.mtimeMs, hash, Date.now());
+        const insertChunk = db.prepare(`INSERT INTO chunks (id, index_id, file_id, symbol_id, path, start_line, end_line, content, content_hash, content_type)
+       VALUES (?, ?, ?, NULL, ?, ?, ?, ?, ?, ?)`);
+        const insertFts = db.prepare(`INSERT INTO chunks_fts (content, path, index_id, chunk_id) VALUES (?, ?, ?, ?)`);
+        for (const c of chunks) {
+            const chunkId = "chk_" + randomUUID();
+            const cHash = contentHash(c.content);
+            const ctype = file.language && ["typescript", "javascript", "python", "go", "rust", "java", "c", "cpp"].includes(file.language)
+                ? "code"
+                : "prose";
+            insertChunk.run(chunkId, indexId, fileId, file.path, c.startLine, c.endLine, c.content, cHash, ctype);
+            insertFts.run(c.content, file.path, indexId, chunkId);
+        }
+        // Symbols (Step 13)
+        const insertSymbol = db.prepare(`INSERT INTO symbols (id, index_id, file_id, path, name, kind, signature, start_line, end_line, exported, doc)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, NULL)`);
+        for (const sym of symbols) {
+            insertSymbol.run("sym_" + randomUUID(), indexId, fileId, file.path, sym.name, sym.kind, sym.signature ?? null, sym.startLine, sym.endLine, sym.exported ? 1 : 0);
+        }
+        // Edges: imports (file→file) from extractEdges; defines/belongs_to
+        // (file↔symbol); exports (file→exported symbol).
+        insertEdges(db, indexId, edges);
+        const insertEdge = db.prepare(`INSERT INTO edges (id, index_id, from_id, to_id, from_path, to_path, type, confidence) VALUES (?, ?, NULL, NULL, ?, ?, ?, ?)`);
+        for (const sym of symbols) {
+            // file defines symbol (file→symbol via path; symbol_id kept NULL for path-based edges)
+            insertEdge.run("edge_" + randomUUID(), indexId, file.path, file.path, "defines", 1.0);
+            // symbol belongs_to file
+            insertEdge.run("edge_" + randomUUID(), indexId, file.path, file.path, "belongs_to", 1.0);
+            if (sym.exported) {
+                insertEdge.run("edge_" + randomUUID(), indexId, file.path, file.path, "exports", 1.0);
+            }
+        }
+        // Test edges (Step 15): if this file is a test, emit `tests` edges to
+        // resolved source files present in the index.
+        if (isTestFile(file.path)) {
+            const targets = resolveTestTargets(file.path, knownFiles);
+            for (const t of targets) {
+                insertEdge.run("edge_" + randomUUID(), indexId, file.path, t, "tests", 0.8);
+            }
+        }
+    });
+    tx();
+    return { fileId, chunkCount: chunks.length, contentHash: hash, symbols, edges };
+}
+/** Mark a file as deleted (remove its rows) for an index. Transactional. */
+export function deleteFileFromIndex(db, indexId, path) {
+    const tx = db.transaction(() => {
+        db.prepare("DELETE FROM chunks_fts WHERE index_id = ? AND path = ?").run(indexId, path);
+        db.prepare("DELETE FROM chunks WHERE index_id = ? AND path = ?").run(indexId, path);
+        db.prepare("DELETE FROM symbols WHERE index_id = ? AND path = ?").run(indexId, path);
+        db.prepare("DELETE FROM edges WHERE index_id = ? AND (from_path = ? OR to_path = ?)").run(indexId, path, path);
+        db.prepare("DELETE FROM files WHERE index_id = ? AND path = ?").run(indexId, path);
+    });
+    tx();
+}
+//# sourceMappingURL=fts.js.map

package/build/src/index/fts.js.map

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

package/build/src/index/identity.js

@@ -0,0 +1,21 @@
+import { createHash } from "node:crypto";
+/**
+ * Index identity (Design Decisions: branch isolation).
+ *
+ * index_id = sha256(repoRoot | worktreePath | branch | headSha)
+ *
+ * Every stored row carries index_id; every query filters by the active id so
+ * branch A never returns branch B results by default.
+ */
+export function computeIndexId(scope) {
+    if (!scope.repoRoot)
+        throw new Error("computeIndexId: missing repoRoot");
+    if (!scope.headSha && !scope.detached) {
+        // Allow empty head only for detached/fresh repos. A normal branch with no
+        // head is a caller bug.
+        throw new Error("computeIndexId: missing headSha on non-detached scope");
+    }
+    const key = [scope.repoRoot, scope.worktreePath, scope.branch, scope.headSha].join("|");
+    return "idx_" + createHash("sha256").update(key).digest("hex").slice(0, 32);
+}
+//# sourceMappingURL=identity.js.map

package/build/src/index/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../src/index/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;;;;GAOG;AAEH,MAAM,UAAU,cAAc,CAAC,KAAe;IAC5C,IAAI,CAAC,KAAK,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACzE,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACtC,0EAA0E;QAC1E,wBAAwB;QACxB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxF,OAAO,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC9E,CAAC"}

package/build/src/index/indexer.js

@@ -0,0 +1,32 @@
+import { getOrCreateIndex, getActiveIndexId } from "./manager.js";
+import { scanFiles } from "./scanner.js";
+import { indexFile } from "./fts.js";
+export function buildIndex(db, scope) {
+    const row = getOrCreateIndex(db, scope);
+    const indexId = row.id;
+    const files = scanFiles(scope.repoRoot);
+    const knownFiles = new Set(files.map((f) => f.path));
+    let indexedFiles = 0;
+    let totalChunks = 0;
+    let skipped = 0;
+    for (const f of files) {
+        try {
+            const r = indexFile(db, indexId, scope.repoRoot, f, knownFiles);
+            indexedFiles++;
+            totalChunks += r.chunkCount;
+        }
+        catch {
+            skipped++;
+        }
+    }
+    return { indexId, indexedFiles, totalChunks, skipped };
+}
+/** Convenience: ensure active index id is set after build. */
+export function activeIndex(db) {
+    const id = getActiveIndexId();
+    if (!id)
+        throw new Error("no active index — call buildIndex or getOrCreateIndex first");
+    void db;
+    return id;
+}
+//# sourceMappingURL=indexer.js.map

package/build/src/index/indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.js","sourceRoot":"","sources":["../../../src/index/indexer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,SAAS,EAAoB,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAiBrC,MAAM,UAAU,UAAU,CAAC,EAAqB,EAAE,KAAe;IAC/D,MAAM,GAAG,GAAG,gBAAgB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;YAChE,YAAY,EAAE,CAAC;YACf,WAAW,IAAI,CAAC,CAAC,UAAU,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AACzD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,WAAW,CAAC,EAAqB;IAC/C,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAC9B,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACxF,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/build/src/index/manager.js

@@ -0,0 +1,48 @@
+import { computeIndexId } from "./identity.js";
+let activeIndexId = null;
+/** Get or create the index row for the current git scope; touch access time. */
+export function getOrCreateIndex(db, scope) {
+    const id = computeIndexId(scope);
+    const now = Date.now();
+    const existing = db
+        .prepare("SELECT * FROM indexes WHERE id = ?")
+        .get(id);
+    if (existing) {
+        db.prepare("UPDATE indexes SET last_accessed_at = ?, status = 'active', expires_at = NULL WHERE id = ?")
+            .run(now, id);
+        activeIndexId = id;
+        return { ...existing, last_accessed_at: now, status: "active", expires_at: null };
+    }
+    db.prepare(`INSERT INTO indexes (id, repo_root, worktree_path, branch_name, head_sha, created_at, last_accessed_at, expires_at, pinned, status)
+     VALUES (?, ?, ?, ?, ?, ?, ?, NULL, 0, 'active')`).run(id, scope.repoRoot, scope.worktreePath, scope.branch, scope.headSha, now, now);
+    activeIndexId = id;
+    return {
+        id,
+        repo_root: scope.repoRoot,
+        worktree_path: scope.worktreePath,
+        branch_name: scope.branch,
+        head_sha: scope.headSha,
+        created_at: now,
+        last_accessed_at: now,
+        expires_at: null,
+        pinned: 0,
+        status: "active",
+    };
+}
+/** Bump last_accessed_at for an index (used on every query). */
+export function touchIndex(db, indexId) {
+    db.prepare("UPDATE indexes SET last_accessed_at = ? WHERE id = ?").run(Date.now(), indexId);
+}
+/** Set the active index for the current process. */
+export function setActiveIndex(indexId) {
+    activeIndexId = indexId;
+}
+/** Current active index id (null if none activated yet). */
+export function getActiveIndexId() {
+    return activeIndexId;
+}
+/** Fetch an index row by id. */
+export function getIndex(db, indexId) {
+    return db.prepare("SELECT * FROM indexes WHERE id = ?").get(indexId);
+}
+//# sourceMappingURL=manager.js.map

package/build/src/index/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../src/index/manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAoB/C,IAAI,aAAa,GAAkB,IAAI,CAAC;AAExC,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAAC,EAAqB,EAAE,KAAe;IACrE,MAAM,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,EAAE;SAChB,OAAO,CAAC,oCAAoC,CAAC;SAC7C,GAAG,CAAC,EAAE,CAAyB,CAAC;IACnC,IAAI,QAAQ,EAAE,CAAC;QACb,EAAE,CAAC,OAAO,CAAC,4FAA4F,CAAC;aACrG,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAChB,aAAa,GAAG,EAAE,CAAC;QACnB,OAAO,EAAE,GAAG,QAAQ,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IACpF,CAAC;IACD,EAAE,CAAC,OAAO,CACR;qDACiD,CAClD,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACrF,aAAa,GAAG,EAAE,CAAC;IACnB,OAAO;QACL,EAAE;QACF,SAAS,EAAE,KAAK,CAAC,QAAQ;QACzB,aAAa,EAAE,KAAK,CAAC,YAAY;QACjC,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,QAAQ,EAAE,KAAK,CAAC,OAAO;QACvB,UAAU,EAAE,GAAG;QACf,gBAAgB,EAAE,GAAG;QACrB,UAAU,EAAE,IAAI;QAChB,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,QAAQ;KACjB,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,UAAU,CAAC,EAAqB,EAAE,OAAe;IAC/D,EAAE,CAAC,OAAO,CAAC,sDAAsD,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;AAC9F,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,aAAa,GAAG,OAAO,CAAC;AAC1B,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,gBAAgB;IAC9B,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,QAAQ,CAAC,EAAqB,EAAE,OAAe;IAC7D,OAAO,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAyB,CAAC;AAC/F,CAAC"}

package/build/src/index/queue.js

@@ -0,0 +1,47 @@
+/**
+ * Single-writer queue (Design Decisions #4 + Section 16 risk 2).
+ *
+ * Serializes all index writes through one promise chain per process so two
+ * agent processes never corrupt rows. Readers (search/expand) bypass the queue
+ * and read the prior committed snapshot (WAL allows this).
+ *
+ * Cross-process safety: index_locks table holds an advisory lease. If another
+ * process holds a non-expired lease, writes skip (return a "locked" result) and
+ * the caller surfaces partial freshness rather than blocking.
+ */
+import { randomUUID } from "node:crypto";
+const state = { tail: Promise.resolve(), active: false };
+/** Enqueue a write task; runs after all prior writes complete. */
+export function enqueue(task) {
+    const run = state.tail.then(task, task);
+    state.tail = run.catch(() => { });
+    return run;
+}
+/** Whether a write is currently executing. */
+export function isWriteActive() {
+    return state.active;
+}
+/**
+ * Acquire an advisory cross-process write lease for an index. Returns true if
+ * acquired (or already held by this process), false if another process holds a
+ * non-expired lease. Releases on the next ensureFreshIndex completion.
+ */
+export function acquireWriteLease(db, indexId, owner = process.pid.toString(), leaseMs = 30000) {
+    const now = Date.now();
+    const existing = db.prepare("SELECT owner, expires_at FROM index_locks WHERE index_id = ?").get(indexId);
+    if (existing && existing.expires_at > now && existing.owner !== owner) {
+        return false; // another process holds it
+    }
+    db.prepare("INSERT INTO index_locks (index_id, owner, expires_at) VALUES (?, ?, ?) " +
+        "ON CONFLICT(index_id) DO UPDATE SET owner = excluded.owner, expires_at = excluded.expires_at").run(indexId, owner, now + leaseMs);
+    return true;
+}
+/** Release the write lease if owned by this process. */
+export function releaseWriteLease(db, indexId, owner = process.pid.toString()) {
+    db.prepare("DELETE FROM index_locks WHERE index_id = ? AND owner = ?").run(indexId, owner);
+}
+/** Generate a unique owner id (for tests that want isolation). */
+export function newOwnerId() {
+    return "own_" + randomUUID();
+}
+//# sourceMappingURL=queue.js.map

package/build/src/index/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../src/index/queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AASzC,MAAM,KAAK,GAAe,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAErE,kEAAkE;AAClE,MAAM,UAAU,OAAO,CAAI,IAAa;IACtC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAe,CAAC;IACtD,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,GAAqC,CAAC,CAAC,CAAC;IACpE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,CAAC,MAAM,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAqB,EAAE,OAAe,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,GAAG,KAAK;IACvH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CAAC,8DAA8D,CAAC,CAAC,GAAG,CAAC,OAAO,CAClD,CAAC;IACtD,IAAI,QAAQ,IAAI,QAAQ,CAAC,UAAU,GAAG,GAAG,IAAI,QAAQ,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC,CAAC,2BAA2B;IAC3C,CAAC;IACD,EAAE,CAAC,OAAO,CACR,yEAAyE;QACvE,8FAA8F,CACjG,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,iBAAiB,CAAC,EAAqB,EAAE,OAAe,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE;IACtG,EAAE,CAAC,OAAO,CAAC,0DAA0D,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC7F,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,UAAU;IACxB,OAAO,MAAM,GAAG,UAAU,EAAE,CAAC;AAC/B,CAAC"}

package/build/src/index/recovery.js

@@ -0,0 +1,51 @@
+import { copyFileSync, existsSync } from "node:fs";
+/** Fast integrity check via PRAGMA quick_check. */
+export function checkIntegrity(db) {
+    try {
+        const rows = db.prepare("PRAGMA quick_check").all();
+        const msg = rows.map((r) => r.quick_check).join(" ");
+        return { ok: msg === "ok", message: msg };
+    }
+    catch (err) {
+        return { ok: false, message: err instanceof Error ? err.message : String(err) };
+    }
+}
+/** Copy the DB file to `<path>.backup-v<version>` for restore-on-migration-failure. */
+export function backupBeforeMigration(dbPath, version) {
+    const backup = `${dbPath}.backup-v${version}`;
+    copyFileSync(dbPath, backup);
+    return backup;
+}
+/** Restore a backup over the DB file (used if migration fails). Caller closes DB first. */
+export function restoreBackup(dbPath, version) {
+    const backup = `${dbPath}.backup-v${version}`;
+    if (!existsSync(backup))
+        return false;
+    copyFileSync(backup, dbPath);
+    return true;
+}
+/**
+ * Drop core index tables (keep indexes rows + schema_version) so the caller can
+ * re-scan + reindex from scratch. saved_contexts are in a separate DB (Step 21)
+ * and are untouched. This is the recovery path on corruption.
+ */
+export function dropCoreTables(db) {
+    // Order matters for FK: drop dependents first.
+    db.exec(`
+    DROP TABLE IF EXISTS embeddings;
+    DROP TABLE IF EXISTS edges;
+    DROP TABLE IF EXISTS chunks_fts;
+    DROP TABLE IF EXISTS chunks;
+    DROP TABLE IF EXISTS symbols;
+    DROP TABLE IF EXISTS files;
+    DROP TABLE IF EXISTS index_locks;
+  `);
+}
+/** True if a thrown error looks like SQLite corruption. */
+export function isCorruptionError(err) {
+    if (!(err instanceof Error))
+        return false;
+    const msg = err.message.toLowerCase();
+    return msg.includes("corrupt") || msg.includes("database disk image is malformed") || msg.includes("not a database");
+}
+//# sourceMappingURL=recovery.js.map

package/build/src/index/recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../../../src/index/recovery.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAmBnD,mDAAmD;AACnD,MAAM,UAAU,cAAc,CAAC,EAAqB;IAClD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,GAAG,EAA+B,CAAC;QACjF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrD,OAAO,EAAE,EAAE,EAAE,GAAG,KAAK,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAClF,CAAC;AACH,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,qBAAqB,CAAC,MAAc,EAAE,OAAe;IACnE,MAAM,MAAM,GAAG,GAAG,MAAM,YAAY,OAAO,EAAE,CAAC;IAC9C,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,OAAe;IAC3D,MAAM,MAAM,GAAG,GAAG,MAAM,YAAY,OAAO,EAAE,CAAC;IAC9C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACtC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAqB;IAClD,+CAA+C;IAC/C,EAAE,CAAC,IAAI,CAAC;;;;;;;;GAQP,CAAC,CAAC;AACL,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACtC,OAAO,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,kCAAkC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;AACvH,CAAC"}

package/build/src/index/reindex.js

@@ -0,0 +1,70 @@
+import { scanFiles } from "./scanner.js";
+import { diffFiles } from "./freshness.js";
+import { indexFile, deleteFileFromIndex } from "./fts.js";
+import { getOrCreateIndex } from "./manager.js";
+import { acquireWriteLease, releaseWriteLease, newOwnerId } from "./queue.js";
+const DEFAULT_BUDGET_MS = 500;
+const FULL_SCAN_INTERVAL_MS = 5000;
+let lastFullScanAt = 0;
+let activeWatcher = null;
+/** Register the process file watcher (called on server startup). */
+export function registerWatcher(w) { activeWatcher = w; }
+export function ensureFreshIndex(db, scope, opts) {
+    const row = getOrCreateIndex(db, scope);
+    const indexId = row.id;
+    const start = Date.now();
+    const budget = opts?.budgetMs ?? DEFAULT_BUDGET_MS;
+    const watcher = opts?.watcher ?? activeWatcher;
+    // Watcher short-circuit: if a watcher is active, it has reported no changes
+    // since the last full scan, and we scanned recently, skip the re-scan
+    // entirely (the quiet-period optimization). A periodic full scan
+    // (FULL_SCAN_INTERVAL_MS) catches anything the watcher missed.
+    if (watcher?.active && watcher.dirty.size === 0 && (Date.now() - lastFullScanAt) < FULL_SCAN_INTERVAL_MS) {
+        return { refreshed: 0, deleted: 0, pending: 0, durationMs: 0 };
+    }
+    // Cross-process write lease: skip if another process is mid-reindex.
+    const owner = newOwnerId();
+    // Lease duration must cover the full operation so a long-budget reindex isn't
+    // stolen mid-flight by another process. >= 3x budget, minimum 30s.
+    const leaseMs = Math.max(30000, budget * 3);
+    if (!acquireWriteLease(db, indexId, owner, leaseMs)) {
+        return { refreshed: 0, deleted: 0, pending: 0, durationMs: 0, locked: true };
+    }
+    try {
+        lastFullScanAt = Date.now();
+        // Always full-scan for correct changed/new/deleted detection. The watcher's
+        // value is the quiet-period short-circuit above (skip the scan entirely when
+        // nothing changed); a narrow "only dirty paths" path was removed because it
+        // mis-classified every non-dirty stored file as deleted.
+        if (watcher?.active)
+            watcher.consume(); // drain any dirty set
+        const scanned = scanFiles(scope.repoRoot);
+        const diff = diffFiles(db, indexId, scanned, scope.repoRoot);
+        const toProcess = [...diff.changed, ...diff.newFiles];
+        let refreshed = 0;
+        let pending = 0;
+        for (const f of toProcess) {
+            if (Date.now() - start > budget) {
+                pending = toProcess.length - refreshed;
+                break;
+            }
+            try {
+                indexFile(db, indexId, scope.repoRoot, f);
+                refreshed++;
+            }
+            catch {
+                // skip unreadable
+            }
+        }
+        let deleted = 0;
+        for (const d of diff.deleted) {
+            deleteFileFromIndex(db, indexId, d.path);
+            deleted++;
+        }
+        return { refreshed, deleted, pending, durationMs: Date.now() - start };
+    }
+    finally {
+        releaseWriteLease(db, indexId, owner);
+    }
+}
+//# sourceMappingURL=reindex.js.map

package/build/src/index/reindex.js.map

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