@fodx/codelens 1.0.0

package/build/src/index/scanner.js

@@ -0,0 +1,147 @@
+import { spawnSync } from "node:child_process";
+import { statSync, openSync, readSync, closeSync, readdirSync, readFileSync } from "node:fs";
+import { join, posix } from "node:path";
+import { resolveReal, toPosix } from "../util/paths.js";
+import { shouldDeny } from "./deny.js";
+import ignore from "ignore";
+/**
+ * File scanner (Design Decisions #2, #3, #11).
+ *
+ * Honors .gitignore via `git ls-files` (includes untracked, excludes ignored).
+ * Applies heuristic deny (build/dist/out/coverage + generated patterns) even
+ * for untracked files. Skips files >5MB. Skips binary files (NUL in first 8KB).
+ * Returns POSIX repo-relative paths.
+ */
+export const MAX_FILE_BYTES = 5 * 1024 * 1024; // 5MB
+const EXT_LANG = {
+    ".ts": "typescript", ".tsx": "typescript", ".js": "javascript", ".jsx": "javascript",
+    ".mjs": "javascript", ".cjs": "javascript", ".py": "python", ".go": "go", ".rs": "rust",
+    ".java": "java", ".rb": "ruby", ".php": "php", ".c": "c", ".h": "c", ".cpp": "cpp",
+    ".cc": "cpp", ".hpp": "cpp", ".cs": "csharp", ".swift": "swift", ".kt": "kotlin",
+    ".scala": "scala", ".sh": "bash", ".md": "markdown", ".json": "json", ".yaml": "yaml",
+    ".yml": "yaml", ".toml": "toml", ".sql": "sql",
+};
+function inferLanguage(posixPath) {
+    const ext = posix.extname(posixPath).toLowerCase();
+    return EXT_LANG[ext] ?? null;
+}
+/** True if file starts with a NUL byte or non-UTF8 bytes in first 8KB (binary heuristic). */
+export function isBinary(absPath) {
+    let fd = null;
+    try {
+        fd = openSync(absPath, "r");
+        const buf = Buffer.alloc(8192);
+        const n = readSync(fd, buf, 0, 8192, 0);
+        for (let i = 0; i < n; i++) {
+            const b = buf[i];
+            // NUL byte → binary. Allow common text bytes (incl. tab/cr/lf).
+            if (b === 0)
+                return true;
+        }
+        // Heuristic: if >10% of bytes are non-text control chars (excluding \t \n \r), treat as binary.
+        let controls = 0;
+        for (let i = 0; i < n; i++) {
+            const b = buf[i];
+            if (b < 9 || (b > 13 && b < 32))
+                controls++;
+        }
+        return n > 0 && controls / n > 0.1;
+    }
+    catch {
+        return true; // unreadable → treat as binary/skip
+    }
+    finally {
+        if (fd !== null)
+            try {
+                closeSync(fd);
+            }
+            catch { /* ignore */ }
+    }
+}
+/**
+ * Scan the repo at `repoRoot`. Uses `git ls-files` when inside a git repo
+ * (honors .gitignore: untracked included, ignored excluded). Falls back to a
+ * plain directory walk for non-git dirs.
+ */
+export function scanFiles(repoRoot) {
+    const root = resolveReal(repoRoot);
+    const relPaths = gitLsFiles(root) ?? walkDir(root);
+    const out = [];
+    for (const rel of relPaths) {
+        const p = toPosix(rel);
+        if (shouldDeny(p))
+            continue;
+        const abs = join(root, p);
+        let st;
+        try {
+            const s = statSync(abs);
+            if (!s.isFile())
+                continue;
+            st = { size: s.size, mtimeMs: s.mtimeMs };
+        }
+        catch {
+            continue;
+        }
+        if (st.size > MAX_FILE_BYTES)
+            continue;
+        if (isBinary(abs))
+            continue;
+        out.push({ path: p, size: st.size, mtimeMs: st.mtimeMs, language: inferLanguage(p) });
+    }
+    return out;
+}
+/** `git ls-files --others --exclude-standard --cached -z` → untracked+tracked, ignored excluded. */
+function gitLsFiles(root) {
+    const r = spawnSync("git", ["ls-files", "-z", "--cached", "--others", "--exclude-standard"], {
+        cwd: root,
+        encoding: "utf-8",
+    });
+    if (r.error || r.status !== 0)
+        return null;
+    return (r.stdout ?? "").split("\0").filter((s) => s.length > 0);
+}
+/** Plain directory walk fallback for non-git dirs. Honors nested .gitignore. */
+function walkDir(root) {
+    const out = [];
+    // Each stack frame carries the cumulative .gitignore pattern lines from all
+    // ancestor dirs (gitignore patterns without a slash match in any subdir, so
+    // concatenating lines approximates git's nested semantics for the fallback).
+    const stack = [{ dir: root, patterns: [] }];
+    while (stack.length) {
+        const { dir: cur, patterns } = stack.pop();
+        let entries;
+        try {
+            entries = readdirSync(cur, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        // Inherit ancestor patterns and add this dir's .gitignore lines (if present).
+        let dirPatterns = patterns;
+        let dirIg = ignore().add(patterns);
+        try {
+            const gi = readFileSync(posix.join(cur, ".gitignore"), "utf-8");
+            dirPatterns = [...patterns, ...gi.split(/\r?\n/).filter((l) => l.trim().length > 0)];
+            dirIg = ignore().add(dirPatterns);
+        }
+        catch { /* no .gitignore here */ }
+        for (const e of entries) {
+            if (e.name === ".gitignore" || e.name.startsWith(".git"))
+                continue;
+            const full = posix.join(cur, e.name);
+            const rel = toPosix(full.slice(root.length + 1));
+            if (e.isDirectory()) {
+                if (dirIg.ignores(rel + "/"))
+                    continue;
+                stack.push({ dir: full, patterns: dirPatterns });
+            }
+            else if (e.isFile()) {
+                if (dirIg.ignores(rel))
+                    continue;
+                out.push(rel);
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=scanner.js.map

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

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

package/build/src/index/ttl.js

@@ -0,0 +1,87 @@
+import { getActiveIndexId } from "./manager.js";
+/**
+ * TTL pruner (Step 22).
+ *
+ * Deletes inactive indexes per retention policy. NEVER deletes:
+ *   - the active index
+ *   - pinned indexes
+ *   - indexes with an active (non-expired) write lease
+ *   - indexes accessed within the grace window
+ *
+ * Default retention:
+ *   active index: never (expires_at NULL)
+ *   inactive branch: 14 days since last_access
+ *   detached: 3 days
+ *   temp worktree: 48h
+ * Grace window: 1h (don't prune if accessed in the last hour even if expired).
+ */
+export const RETENTION = {
+    inactiveBranchDays: 14,
+    detachedDays: 3,
+    worktreeHours: 48,
+    graceMs: 3600_000,
+};
+/** Compute an expires_at timestamp for an index row (ms since epoch). */
+export function computeExpiry(row, _now = Date.now()) {
+    if (row.pinned)
+        return null;
+    // Explicit expires_at wins; NULL means "compute from last_accessed_at".
+    // The currently-active index is guarded in pruneIndexes, not here: status='active'
+    // just means "was active once", not "currently in use", so it must NOT bypass TTL
+    // or no index would ever expire (every index is created with status='active').
+    if (row.expires_at !== null)
+        return row.expires_at;
+    if (row.branch_name === "DETACHED")
+        return row.last_accessed_at + RETENTION.detachedDays * 86400_000;
+    if (row.worktree_path && row.worktree_path !== row.repo_root) {
+        return row.last_accessed_at + RETENTION.worktreeHours * 3600_000;
+    }
+    return row.last_accessed_at + RETENTION.inactiveBranchDays * 86400_000;
+}
+/** Prune expired inactive indexes. Respects never-delete guards. */
+export function pruneIndexes(db, now = Date.now()) {
+    const active = getActiveIndexId();
+    // Exclude indexes with an active (non-expired) write lease via NOT EXISTS.
+    const rows = db.prepare(`SELECT i.id AS id, i.pinned AS pinned, i.status AS status, i.branch_name AS branch,
+            i.last_accessed_at AS last, i.expires_at AS expires_at, i.worktree_path AS wpath, i.repo_root AS root
+     FROM indexes i
+     WHERE NOT EXISTS (
+       SELECT 1 FROM index_locks l WHERE l.index_id = i.id AND l.expires_at > ?
+     )`).all(now);
+    const deleted = [];
+    let skipped = 0;
+    for (const r of rows) {
+        // Never-delete guards.
+        if (r.id === active) {
+            skipped++;
+            continue;
+        }
+        if (r.pinned) {
+            skipped++;
+            continue;
+        }
+        if (now - r.last < RETENTION.graceMs) {
+            skipped++;
+            continue;
+        }
+        const expiry = r.expires_at ?? computeExpiry({ pinned: r.pinned, status: r.status, branch_name: r.branch, head_sha: "", last_accessed_at: r.last, expires_at: r.expires_at, worktree_path: r.wpath }, now);
+        if (expiry === null || now < expiry) {
+            skipped++;
+            continue;
+        }
+        // Delete scoped rows across all tables, transactionally.
+        const tx = db.transaction(() => {
+            db.prepare("DELETE FROM chunks_fts WHERE index_id = ?").run(r.id);
+            db.prepare("DELETE FROM chunks WHERE index_id = ?").run(r.id);
+            db.prepare("DELETE FROM symbols WHERE index_id = ?").run(r.id);
+            db.prepare("DELETE FROM edges WHERE index_id = ?").run(r.id);
+            db.prepare("DELETE FROM files WHERE index_id = ?").run(r.id);
+            db.prepare("DELETE FROM index_locks WHERE index_id = ?").run(r.id);
+            db.prepare("DELETE FROM indexes WHERE id = ?").run(r.id);
+        });
+        tx();
+        deleted.push(r.id);
+    }
+    return { deletedIndexes: deleted, skipped, bytesFreed: 0 };
+}
+//# sourceMappingURL=ttl.js.map

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

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

package/build/src/index/watcher.js

@@ -0,0 +1,74 @@
+import { watch } from "node:fs";
+import { resolveReal, toPosix } from "../util/paths.js";
+import { relative, posix } from "node:path";
+/**
+ * File watcher (Gap #6).
+ *
+ * Maintains a set of repo-relative POSIX paths that changed since the last
+ * consume(), via recursive fs.watch where supported. Used by ensureFreshIndex
+ * to skip re-scanning during quiet periods (the main per-query cost) while
+ * still catching edits promptly.
+ *
+ * Platform note: recursive fs.watch is supported on macOS and Windows. On
+ * Linux it falls back to a non-recursive watch of the repo root only — callers
+ * must not rely on completeness; ensureFreshIndex periodically does a full
+ * scan as a safety net (FULL_SCAN_INTERVAL_MS) so missed changes are caught.
+ *
+ * Always non-fatal: if watching fails (unsupported FS, permissions), the
+ * watcher stays empty and the tool falls back to full-scan-per-query (the
+ * original behavior).
+ */
+export class FileWatcher {
+    repoRoot;
+    watcher = null;
+    dirty = new Set();
+    started = false;
+    constructor(repoRoot) {
+        this.repoRoot = resolveReal(repoRoot);
+    }
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        try {
+            this.watcher = watch(this.repoRoot, { recursive: true }, (_event, filename) => {
+                if (!filename)
+                    return;
+                const abs = posix.join(this.repoRoot, toPosix(filename));
+                try {
+                    const rel = toPosix(relative(this.repoRoot, abs));
+                    if (rel && !rel.startsWith(".."))
+                        this.dirty.add(rel);
+                }
+                catch { /* ignore */ }
+            });
+            this.watcher.on("error", () => { });
+        }
+        catch {
+            this.watcher = null; // unsupported → degrade to full-scan
+        }
+    }
+    stop() {
+        try {
+            this.watcher?.close();
+        }
+        catch { /* ignore */ }
+        this.watcher = null;
+        this.started = false;
+    }
+    /** True if the watcher is active (may still be partial on Linux). */
+    get active() {
+        return this.watcher !== null;
+    }
+    /** Snapshot + clear the dirty set. Returns repo-relative POSIX paths. */
+    consume() {
+        const out = [...this.dirty];
+        this.dirty.clear();
+        return out;
+    }
+    /** Mark a path dirty manually (e.g. after an in-process index write). */
+    markDirty(rel) {
+        this.dirty.add(rel);
+    }
+}
+//# sourceMappingURL=watcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../../src/index/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAE5C;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,OAAO,WAAW;IACd,QAAQ,CAAS;IACjB,OAAO,GAAqB,IAAI,CAAC;IAChC,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAC3B,OAAO,GAAG,KAAK,CAAC;IAExB,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;gBAC5E,IAAI,CAAC,QAAQ;oBAAE,OAAO;gBACtB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACzD,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;oBAClD,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;wBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACxD,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YAC1B,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAmD,CAAC,CAAC,CAAC;QACtF,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,qCAAqC;QAC5D,CAAC;IACH,CAAC;IAED,IAAI;QACF,IAAI,CAAC;YAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,qEAAqE;IACrE,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;IAC/B,CAAC;IAED,yEAAyE;IACzE,OAAO;QACL,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,yEAAyE;IACzE,SAAS,CAAC,GAAW;QACnB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;CACF"}