@fodx/codelens 1.0.0

package/build/src/obs/usage.js

@@ -0,0 +1,136 @@
+import DatabaseSync from "better-sqlite3";
+import { createHash } from "node:crypto";
+import { mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/**
+ * Usage tracking — GLOBAL (per-user, not per-repo).
+ *
+ * Stored in a single ~/.codelens/usage.db so switching repos doesn't
+ * hide your real usage. Each row is keyed by (tool, repo_id), so the snapshot
+ * can show both totals and a per-repo breakdown.
+ *
+ * "bytes_saved" is a defensible estimate for DISCOVERY tools (cl_search,
+ * cl_related): the agent would otherwise grep + read ~N files at ~avg file
+ * size; instead it got compact handles. saved ≈ max(0, N*AVG_FILE_BYTES -
+ * bytesServed). Non-discovery tools record calls + bytes_served but claim no
+ * savings.
+ */
+const AVG_FILE_BYTES = 4096;
+export const DISCOVERY_TOOLS = new Set(["cl_search", "cl_related"]);
+/** Tools that count as "usage" (retrieval + context management). Operational
+ *  tools (refresh/doctor/stats/prune/drop/current/usage) are NOT tracked — they
+ *  are maintenance, not the agent using the retrieval system. */
+export const TRACKED_TOOLS = new Set(["cl_search", "cl_related", "cl_expand", "cl_save", "cl_load"]);
+function usageDbPath() {
+    const dir = join(homedir(), ".codelens");
+    mkdirSync(dir, { recursive: true });
+    return join(dir, "usage.db");
+}
+export function repoId(repoRoot) {
+    return createHash("sha256").update(repoRoot).digest("hex").slice(0, 16);
+}
+/** Open the global usage DB (creates the table if missing). */
+export function initUsageTable(db) {
+    db.exec(`CREATE TABLE IF NOT EXISTS tool_usage (
+    tool           TEXT NOT NULL,
+    repo_id        TEXT NOT NULL,
+    calls          INTEGER NOT NULL DEFAULT 0,
+    last_called_at INTEGER,
+    bytes_served   INTEGER NOT NULL DEFAULT 0,
+    bytes_saved    INTEGER NOT NULL DEFAULT 0,
+    PRIMARY KEY (tool, repo_id)
+  )`);
+}
+export function openGlobalUsageDb() {
+    const db = new DatabaseSync(usageDbPath());
+    db.pragma("journal_mode = WAL");
+    initUsageTable(db);
+    return db;
+}
+export class UsageTracker {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Record one tool call. `repoRoot` scopes the row; `resultText` is the JSON
+     * returned. `savedOverride` (when provided) is a precomputed savings estimate
+     * from actual indexed file sizes — used by the server wrapper for discovery
+     * tools. When omitted, falls back to the flat `handles × AVG_FILE_BYTES` proxy.
+     */
+    record(tool, repoRoot, resultText, isError = false, savedOverride) {
+        if (isError)
+            return;
+        const bytesServed = Buffer.byteLength(resultText, "utf-8");
+        let bytesSaved;
+        if (savedOverride !== undefined) {
+            bytesSaved = Math.max(0, savedOverride);
+        }
+        else if (DISCOVERY_TOOLS.has(tool)) {
+            const handles = countHandles(tool, resultText);
+            bytesSaved = Math.max(0, handles * AVG_FILE_BYTES - bytesServed);
+        }
+        else {
+            bytesSaved = 0;
+        }
+        const now = Date.now();
+        const rid = repoId(repoRoot);
+        this.db.prepare(`INSERT INTO tool_usage (tool, repo_id, calls, last_called_at, bytes_served, bytes_saved)
+       VALUES (?, ?, 1, ?, ?, ?)
+       ON CONFLICT(tool, repo_id) DO UPDATE SET
+         calls = calls + 1,
+         last_called_at = excluded.last_called_at,
+         bytes_served = bytes_served + excluded.bytes_served,
+         bytes_saved = bytes_saved + excluded.bytes_saved`).run(tool, rid, now, bytesServed, bytesSaved);
+    }
+    snapshot() {
+        // Only report tracked (retrieval/context) tools — operational tools
+        // (refresh/doctor/stats/...) are never usage even if stale rows exist.
+        const tracked = [...TRACKED_TOOLS].map((t) => `'${t}'`).join(",");
+        const perTool = this.db.prepare(`SELECT tool, SUM(calls) AS calls, MAX(last_called_at) AS last_called_at,
+              SUM(bytes_served) AS bytes_served, SUM(bytes_saved) AS bytes_saved
+       FROM tool_usage WHERE tool IN (${tracked}) GROUP BY tool ORDER BY calls DESC`).all();
+        const perRepo = this.db.prepare(`SELECT repo_id, SUM(calls) AS calls, SUM(bytes_served) AS bytes_served, SUM(bytes_saved) AS bytes_saved
+       FROM tool_usage WHERE tool IN (${tracked}) GROUP BY repo_id ORDER BY calls DESC`).all();
+        const totals = perTool.reduce((a, r) => ({ calls: a.calls + r.calls, bytes_served: a.bytes_served + r.bytes_served, bytes_saved: a.bytes_saved + r.bytes_saved }), { calls: 0, bytes_served: 0, bytes_saved: 0 });
+        return { perTool, perRepo, totals };
+    }
+    reset() { this.db.prepare("DELETE FROM tool_usage").run(); }
+}
+function countHandles(tool, resultText) {
+    void tool;
+    try {
+        const obj = JSON.parse(resultText);
+        return Array.isArray(obj.results) ? obj.results.length : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Estimate context saved for a discovery call using ACTUAL indexed file sizes.
+ * saved = max(0, sum(distinct result files' sizes) − bytesServed).
+ * Capped at `cap` distinct files so a 100-neighbor `cl_related` result doesn't
+ * inflate the total (the agent wouldn't read all 100 without the tool).
+ */
+export function estimateSavedFromPaths(db, indexId, paths, bytesServed, cap = 50) {
+    const distinct = [...new Set(paths)].slice(0, cap);
+    if (distinct.length === 0)
+        return 0;
+    const placeholders = distinct.map(() => "?").join(",");
+    const row = db.prepare(`SELECT COALESCE(SUM(size), 0) AS total FROM files WHERE index_id = ? AND path IN (${placeholders})`).get(indexId, ...distinct);
+    return Math.max(0, (row.total ?? 0) - bytesServed);
+}
+/** Extract distinct result paths from a discovery tool's JSON result. */
+export function extractDiscoveryPaths(resultText) {
+    try {
+        const obj = JSON.parse(resultText);
+        return (obj.results ?? []).map((r) => r.path).filter((p) => typeof p === "string");
+    }
+    catch {
+        return [];
+    }
+}
+export { AVG_FILE_BYTES };
+//# sourceMappingURL=usage.js.map

package/build/src/obs/usage.js.map

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

package/build/src/search/rank.js

@@ -0,0 +1,70 @@
+/**
+ * Hybrid ranking.
+ *
+ * Combines lexical FTS, symbol name match, graph proximity, and recency into
+ * one ranked list via deterministic weighted fusion (tunable later).
+ *
+ * Default weights (sum to 1):
+ *   FTS 0.45 / symbol 0.25 / graph 0.30
+ * (recency 0 — reserved for future use; weight stays in the schema but unused
+ * until a recency signal is populated.)
+ */
+export const DEFAULT_WEIGHTS = {
+    fts: 0.40,
+    symbol: 0.22,
+    graph: 0.28,
+    code: 0.10, // modest code-over-prose boost for code-discovery queries
+    recency: 0.0,
+};
+/** Normalize a raw score to 0-1 using a min-max against the batch (or clamp). */
+export function normalize(values) {
+    if (values.length === 0)
+        return [];
+    const max = Math.max(...values);
+    const min = Math.min(...values);
+    if (max === min)
+        return values.map(() => 1);
+    return values.map((v) => (v - min) / (max - min));
+}
+/**
+ * Fuse signal scores into ranked results. Missing signals (undefined) are
+ * treated as 0. Weights for absent signals are redistributed proportionally
+ * across the present ones so the active weights always sum to 1.
+ */
+export function rank(signals, weights = DEFAULT_WEIGHTS) {
+    if (signals.length === 0)
+        return [];
+    const present = ["fts", "symbol", "graph", "code", "recency"].filter((k) => signals.some((s) => s[k] !== undefined));
+    const w = { ...weights };
+    const absent = ["fts", "symbol", "graph", "code", "recency"].filter((k) => !present.includes(k));
+    const presentTotal = present.reduce((sum, k) => sum + w[k], 0);
+    if (absent.length > 0 && presentTotal > 0) {
+        const absentTotal = absent.reduce((sum, k) => sum + w[k], 0);
+        for (const k of present)
+            w[k] = w[k] + (absentTotal * (w[k] / presentTotal));
+        for (const k of absent)
+            w[k] = 0;
+    }
+    const fused = signals.map((s) => {
+        const score = (s.fts ?? 0) * w.fts +
+            (s.symbol ?? 0) * w.symbol +
+            (s.graph ?? 0) * w.graph +
+            (s.code ?? 0) * w.code +
+            (s.recency ?? 0) * w.recency;
+        const why = [];
+        if (s.fts)
+            why.push("fts");
+        if (s.symbol)
+            why.push("symbol");
+        if (s.graph)
+            why.push("graph");
+        if (s.code)
+            why.push("code");
+        if (s.recency)
+            why.push("recency");
+        return { path: s.path, startLine: s.startLine, endLine: s.endLine, chunkId: s.chunkId, score, why };
+    });
+    fused.sort((a, b) => b.score - a.score);
+    return fused;
+}
+//# sourceMappingURL=rank.js.map

package/build/src/search/rank.js.map

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

package/build/src/search/snippet.js

@@ -0,0 +1,66 @@
+/**
+ * Snippet + dedent helpers for agent-facing output.
+ *
+ * Best practice for agent-consumable tool output: compact, minimal redundant
+ * whitespace, relative code structure preserved. `dedent` strips the COMMON
+ * leading whitespace across non-blank lines so a deeply-nested function body
+ * isn't padded by its base indent — lossless for understanding, fewer tokens.
+ */
+const STOPWORDS = new Set(["the", "a", "an", "and", "or", "of", "to", "in", "for", "is", "on"]);
+function tokenize(query) {
+    return query.toLowerCase().split(/[^a-z0-9_]+/i).filter((t) => t.length > 1 && !STOPWORDS.has(t));
+}
+/** Strip the common leading whitespace from non-blank lines (Python-style dedent). */
+export function dedent(text) {
+    const lines = text.split("\n");
+    let minIndent = Infinity;
+    for (const line of lines) {
+        if (line.trim().length === 0)
+            continue; // ignore blank lines
+        const indent = line.match(/^[ \t]*/)?.[0]?.length ?? 0;
+        if (indent < minIndent)
+            minIndent = indent;
+    }
+    if (!Number.isFinite(minIndent) || minIndent === 0)
+        return text;
+    return lines.map((l) => (l.length >= minIndent ? l.slice(minIndent) : l)).join("\n");
+}
+/** Extract a windowed snippet around the first matched term, highlight, dedent. */
+export function extractSnippet(content, query, maxChars = 1500) {
+    const terms = tokenize(query);
+    let snippet;
+    if (terms.length === 0) {
+        snippet = content.length > maxChars ? content.slice(0, maxChars) + "\n…" : content;
+    }
+    else {
+        const lower = content.toLowerCase();
+        let bestIdx = -1;
+        for (const t of terms) {
+            const idx = lower.indexOf(t);
+            if (idx >= 0 && (bestIdx === -1 || idx < bestIdx))
+                bestIdx = idx;
+        }
+        if (bestIdx === -1) {
+            snippet = content.length > maxChars ? content.slice(0, maxChars) + "\n…" : content;
+        }
+        else {
+            const half = Math.floor(maxChars / 2);
+            const start = Math.max(0, bestIdx - half);
+            const end = Math.min(content.length, start + maxChars);
+            let s = content.slice(start, end);
+            if (start > 0)
+                s = "…" + s;
+            if (end < content.length)
+                s = s + "\n…";
+            snippet = s;
+        }
+    }
+    snippet = dedent(snippet);
+    // Highlight matched terms (on the dedented text).
+    for (const t of terms) {
+        const re = new RegExp(`(${t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")})`, "ig");
+        snippet = snippet.replace(re, "**$1**");
+    }
+    return snippet;
+}
+//# sourceMappingURL=snippet.js.map

package/build/src/search/snippet.js.map

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

package/build/src/server.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { resolveReal } from "./util/paths.js";
+import { openDb, openMemoryDb, CorruptDb } from "./db/db.js";
+import { openContextDb, openMemoryContextDb } from "./context/store.js";
+import { TOOLS } from "./tools/registry.js";
+import { UsageTracker, openGlobalUsageDb, DISCOVERY_TOOLS, TRACKED_TOOLS, estimateSavedFromPaths, extractDiscoveryPaths } from "./obs/usage.js";
+import { getActiveIndexId } from "./index/manager.js";
+import { scheduleAutoPrune } from "./index/autoprune.js";
+import { FileWatcher } from "./index/watcher.js";
+import { cli } from "./cli.js";
+import { registerWatcher } from "./index/reindex.js";
+import { VERSION } from "./version.js";
+import { createHash } from "node:crypto";
+import { mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/**
+ * CodeLens MCP server (Step 24 wiring).
+ *
+ * Resolves the repo root from cwd, opens the core index DB and the contexts DB
+ * (separate file), registers all 10 tools from the registry, and starts the
+ * stdio transport. Auto-prune runs on startup + periodic idle timer.
+ */
+function createServer(ctx) {
+    const server = new McpServer({ name: "codelens", version: VERSION });
+    for (const tool of TOOLS) {
+        server.tool(tool.name, tool.description, tool.schema, async (args) => {
+            const usage = new UsageTracker(openGlobalUsageDb());
+            try {
+                const result = await tool.handler(ctx, args);
+                const text = JSON.stringify(result, null, 2);
+                let savedOverride;
+                if (DISCOVERY_TOOLS.has(tool.name)) {
+                    try {
+                        const indexId = getActiveIndexId();
+                        if (indexId)
+                            savedOverride = estimateSavedFromPaths(ctx.coreDb, indexId, extractDiscoveryPaths(text), Buffer.byteLength(text));
+                    }
+                    catch { /* fall back to flat proxy */ }
+                }
+                try {
+                    if (TRACKED_TOOLS.has(tool.name))
+                        usage.record(tool.name, ctx.repoRoot, text, false, savedOverride);
+                }
+                catch { /* usage best-effort */ }
+                return { content: [{ type: "text", text }] };
+            }
+            catch (err) {
+                const text = `Error: ${err instanceof Error ? err.message : String(err)}`;
+                try {
+                    if (TRACKED_TOOLS.has(tool.name))
+                        usage.record(tool.name, ctx.repoRoot, text, true);
+                }
+                catch { /* usage best-effort */ }
+                return { content: [{ type: "text", text }], isError: true };
+            }
+        });
+    }
+    return server;
+}
+function repoRootFromCwd() {
+    return resolveReal(process.cwd());
+}
+const CLI_COMMANDS = new Set(["current", "index", "refresh", "search", "related", "stats", "usage", "doctor", "install", "uninstall", "upgrade", "version", "--print-config", "-v", "--version", "--help", "-h"]);
+export async function main() {
+    // CLI dispatch: if the first arg is a known subcommand (bare word like
+    // `install` or a flag-style one like `--print-config`/`--version`), run the
+    // CLI with the FULL arg list so --target/--command/--yes are preserved.
+    // Otherwise start the MCP stdio server.
+    const fullArgs = process.argv.slice(2);
+    const head = fullArgs[0];
+    if (head && CLI_COMMANDS.has(head)) {
+        const code = await cli(fullArgs);
+        process.exit(code);
+        return;
+    }
+    // Smoke mode: register tools against an in-memory context and print names.
+    if (process.argv.includes("--smoke")) {
+        const ctx = { coreDb: openMemoryDb(), ctxDb: openMemoryContextDb(), repoRoot: "/tmp" };
+        const server = createServer(ctx);
+        void server;
+        console.log(JSON.stringify({ ok: true, tools: TOOLS.map((t) => t.name) }));
+        return;
+    }
+    const repoRoot = repoRootFromCwd();
+    let coreDb;
+    try {
+        coreDb = openDb(dbPathFor(repoRoot));
+    }
+    catch (err) {
+        if (err instanceof CorruptDb) {
+            // Production recovery: delete the corrupt DB file and rebuild on next refresh.
+            const { rmSync } = await import("node:fs");
+            try {
+                rmSync(dbPathFor(repoRoot));
+            }
+            catch { /* ignore */ }
+            coreDb = openDb(dbPathFor(repoRoot));
+        }
+        else {
+            throw err;
+        }
+    }
+    const ctxDb = openContextDb(repoRoot);
+    const ctx = { coreDb, ctxDb, repoRoot };
+    scheduleAutoPrune(coreDb);
+    const watcher = new FileWatcher(repoRoot);
+    watcher.start();
+    registerWatcher(watcher);
+    const server = createServer(ctx);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+function dbPathFor(repoRoot) {
+    const dir = join(homedir(), ".codelens", "indexes");
+    mkdirSync(dir, { recursive: true });
+    const rid = createHash("sha256").update(repoRoot).digest("hex").slice(0, 16);
+    return join(dir, `index-${rid}.db`);
+}
+main().catch((err) => {
+    console.error("codelens server error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/build/src/server.js.map

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

package/build/src/tools/current.js

@@ -0,0 +1,32 @@
+import { detectScope } from "../git/scope.js";
+import { getActiveIndexId, getIndex } from "../index/manager.js";
+export function ctxCurrent(db, repoRoot, scope) {
+    const s = scope ?? detectScope(repoRoot);
+    if (!s) {
+        return {
+            repo: repoRoot,
+            branch: "",
+            headSha: "",
+            indexId: null,
+            status: "missing",
+            dirtyFiles: 0,
+            lastIndexedAt: null,
+            indexStatus: null,
+            inGitRepo: false,
+        };
+    }
+    const activeId = getActiveIndexId();
+    const row = activeId ? getIndex(db, activeId) : undefined;
+    return {
+        repo: s.repoRoot,
+        branch: s.branch,
+        headSha: s.headSha,
+        indexId: activeId,
+        status: row ? (row.status === "active" ? "active" : "stale") : "missing",
+        dirtyFiles: s.dirtyFiles.length,
+        lastIndexedAt: row?.last_accessed_at ?? null,
+        indexStatus: row?.status ?? null,
+        inGitRepo: true,
+    };
+}
+//# sourceMappingURL=current.js.map

package/build/src/tools/current.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"current.js","sourceRoot":"","sources":["../../../src/tools/current.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAiB,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAoBjE,MAAM,UAAU,UAAU,CAAC,EAAqB,EAAE,QAAgB,EAAE,KAAuB;IACzF,MAAM,CAAC,GAAG,KAAK,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,SAAS;YACjB,UAAU,EAAE,CAAC;YACb,aAAa,EAAE,IAAI;YACnB,WAAW,EAAE,IAAI;YACjB,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1D,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,QAAQ;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;QACxE,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM;QAC/B,aAAa,EAAE,GAAG,EAAE,gBAAgB,IAAI,IAAI;QAC5C,WAAW,EAAE,GAAG,EAAE,MAAM,IAAI,IAAI;QAChC,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC"}

package/build/src/tools/expand.js

@@ -0,0 +1,54 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { resolveReal, repoRelative } from "../util/paths.js";
+import { getActiveIndexId } from "../index/manager.js";
+import { dedent } from "../search/snippet.js";
+const DEFAULT_BUDGET = 4000; // ~1000 tokens
+export function ctxExpand(db, repoRoot, opts) {
+    const indexId = getActiveIndexId();
+    if (!indexId)
+        throw new Error("no active index — call cl_refresh first");
+    void db;
+    let path;
+    let startLine = opts.startLine;
+    let endLine = opts.endLine;
+    if (opts.handle) {
+        // Resolve handle → chunk row to get path + range.
+        const row = db
+            .prepare("SELECT path, start_line, end_line FROM chunks WHERE id = ? AND index_id = ?")
+            .get(opts.handle, indexId);
+        if (!row)
+            throw new Error(`handle not found in current index: ${opts.handle}`);
+        path = row.path;
+        if (startLine === undefined)
+            startLine = row.start_line;
+        if (endLine === undefined)
+            endLine = row.end_line;
+    }
+    else if (opts.path) {
+        // Normalize the path to repo-relative POSIX; throws on traversal.
+        path = repoRelative(repoRoot, opts.path);
+    }
+    else {
+        throw new Error("cl_expand requires path or handle");
+    }
+    // (path is set in both branches above; TS needs a definite assignment)
+    path = path;
+    const root = resolveReal(repoRoot);
+    const abs = join(root, path);
+    // Security: ensure resolved path stays inside repo.
+    repoRelative(repoRoot, abs);
+    const text = readFileSync(abs, "utf-8");
+    const lines = text.split("\n");
+    const s = Math.max(1, startLine ?? 1);
+    const e = Math.min(lines.length, endLine ?? lines.length);
+    const slice = lines.slice(s - 1, e).join("\n");
+    const budget = opts.budget ?? DEFAULT_BUDGET;
+    const truncated = slice.length > budget;
+    const trimmed = truncated ? slice.slice(0, budget) + "\n…[truncated — increase budget]" : slice;
+    // Dedent (strip common leading whitespace) for compact agent reading. Use
+    // raw read for exact bytes when editing — line numbers stay accurate.
+    const content = dedent(trimmed);
+    return { path, startLine: s, endLine: e, content, truncated, chars: content.length };
+}
+//# sourceMappingURL=expand.js.map

package/build/src/tools/expand.js.map

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

package/build/src/tools/prune.js

@@ -0,0 +1,46 @@
+import { getActiveIndexId, getIndex, getOrCreateIndex } from "../index/manager.js";
+import { pruneIndexes } from "../index/ttl.js";
+/**
+ * cl_prune + cl_drop tools (Step 23).
+ *
+ * `cl_prune` runs the TTL sweep manually. `cl_drop` deletes a specific
+ * branch/index by id, refusing to drop the currently active index.
+ */
+export function ctxPrune(db) {
+    return pruneIndexes(db);
+}
+/** Drop a specific index by id or branch name. Refuses the active index. */
+export function ctxDrop(db, target) {
+    const active = getActiveIndexId();
+    let indexId = target.indexId;
+    if (!indexId && target.branch) {
+        // Prefer an exact (branch, worktree) match; fall back to the most-recently-
+        // accessed index on that branch so same-branch worktrees don't collide.
+        const row = (target.worktreePath
+            ? db.prepare("SELECT id FROM indexes WHERE branch_name = ? AND worktree_path = ? ORDER BY last_accessed_at DESC LIMIT 1").get(target.branch, target.worktreePath)
+            : db.prepare("SELECT id FROM indexes WHERE branch_name = ? ORDER BY last_accessed_at DESC LIMIT 1").get(target.branch));
+        indexId = row?.id;
+    }
+    if (!indexId)
+        return { deleted: false, indexId: "", reason: "not found" };
+    if (indexId === active)
+        return { deleted: false, indexId, reason: "refused: active index" };
+    const row = getIndex(db, indexId);
+    if (!row)
+        return { deleted: false, indexId, reason: "not found" };
+    if (row.pinned)
+        return { deleted: false, indexId, reason: "refused: pinned" };
+    const tx = db.transaction(() => {
+        db.prepare("DELETE FROM chunks_fts WHERE index_id = ?").run(indexId);
+        db.prepare("DELETE FROM chunks WHERE index_id = ?").run(indexId);
+        db.prepare("DELETE FROM symbols WHERE index_id = ?").run(indexId);
+        db.prepare("DELETE FROM edges WHERE index_id = ?").run(indexId);
+        db.prepare("DELETE FROM files WHERE index_id = ?").run(indexId);
+        db.prepare("DELETE FROM index_locks WHERE index_id = ?").run(indexId);
+        db.prepare("DELETE FROM indexes WHERE id = ?").run(indexId);
+    });
+    tx();
+    return { deleted: true, indexId };
+}
+void getOrCreateIndex;
+//# sourceMappingURL=prune.js.map

package/build/src/tools/prune.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.js","sourceRoot":"","sources":["../../../src/tools/prune.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,YAAY,EAAoB,MAAM,iBAAiB,CAAC;AAEjE;;;;;GAKG;AAEH,MAAM,UAAU,QAAQ,CAAC,EAAqB;IAC5C,OAAO,YAAY,CAAC,EAAE,CAAC,CAAC;AAC1B,CAAC;AAQD,4EAA4E;AAC5E,MAAM,UAAU,OAAO,CAAC,EAAqB,EAAE,MAAoE;IACjH,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,IAAI,OAAO,GAAuB,MAAM,CAAC,OAAO,CAAC;IAEjD,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAC9B,4EAA4E;QAC5E,wEAAwE;QACxE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,YAAY;YAC9B,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,2GAA2G,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC;YACjK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,qFAAqF,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAA+B,CAAC;QACxJ,OAAO,GAAG,GAAG,EAAE,EAAE,CAAC;IACpB,CAAC;IACD,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC1E,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAE5F,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAClE,IAAI,GAAG,CAAC,MAAM;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAE9E,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QAC7B,EAAE,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrE,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjE,EAAE,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClE,EAAE,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5D,EAAE,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACpE,EAAE,CAAC,OAAO,CAAC,4CAA4C,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtE,EAAE,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IACH,EAAE,EAAE,CAAC;IACL,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC;AAED,KAAK,gBAAgB,CAAC"}

package/build/src/tools/refresh.js

@@ -0,0 +1,14 @@
+import { buildIndex } from "../index/indexer.js";
+export function ctxRefresh(db, scope) {
+    const r = buildIndex(db, scope);
+    return {
+        indexId: r.indexId,
+        branch: scope.branch,
+        headSha: scope.headSha,
+        indexedFiles: r.indexedFiles,
+        totalChunks: r.totalChunks,
+        skipped: r.skipped,
+        status: "ready",
+    };
+}
+//# sourceMappingURL=refresh.js.map

package/build/src/tools/refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh.js","sourceRoot":"","sources":["../../../src/tools/refresh.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAmBjD,MAAM,UAAU,UAAU,CAAC,EAAqB,EAAE,KAAe;IAC/D,MAAM,CAAC,GAAG,UAAU,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAChC,OAAO;QACL,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,MAAM,EAAE,OAAO;KAChB,CAAC;AACJ,CAAC"}