@fodx/codelens 1.0.0

package/build/src/tools/registry.js

@@ -0,0 +1,176 @@
+import { z } from "zod";
+import { ctxCurrent } from "./current.js";
+import { ctxRefresh } from "./refresh.js";
+import { ctxSearch } from "./search.js";
+import { ctxRelated } from "./related.js";
+import { ctxExpand } from "./expand.js";
+import { ctxSave, ctxLoad } from "./save.js";
+import { ctxPrune, ctxDrop } from "./prune.js";
+import { gatherStats } from "../obs/stats.js";
+import { runDoctor } from "../obs/doctor.js";
+import { UsageTracker, openGlobalUsageDb } from "../obs/usage.js";
+import { detectScope } from "../git/scope.js";
+import { getOrCreateIndex, getActiveIndexId } from "../index/manager.js";
+import { buildIndex } from "../index/indexer.js";
+function withScope(ctx) {
+    return detectScope(ctx.repoRoot);
+}
+/** Ensure an active index exists for the current repo scope before query tools. */
+function ensureActive(ctx) {
+    const scope = withScope(ctx);
+    if (!scope)
+        throw new Error("not inside a git repo (or plain dir support not enabled)");
+    // build the index if none active for this scope
+    if (!getActiveIndexId()) {
+        buildIndex(ctx.coreDb, scope);
+    }
+    else {
+        getOrCreateIndex(ctx.coreDb, scope);
+    }
+    return getActiveIndexId();
+}
+export const TOOLS = [
+    {
+        name: "cl_current",
+        description: "Report current repo/branch/index status with freshness fields. Use first to check if an index is ready.\n\nRETURNS: {repo, branch, headSha, indexId, status, dirtyFiles, lastIndexedAt, inGitRepo}\n\nEXAMPLE: cl_current",
+        schema: {},
+        handler: (ctx) => ctxCurrent(ctx.coreDb, ctx.repoRoot),
+    },
+    {
+        name: "cl_refresh",
+        description: "Create or update the current branch/worktree index. Scans files, indexes FTS, extracts symbols, builds graph.\n\nRETURNS: {indexId, branch, indexedFiles, totalChunks, skipped, status}\n\nEXAMPLE: cl_refresh",
+        schema: {},
+        handler: (ctx) => {
+            const scope = withScope(ctx);
+            if (!scope)
+                throw new Error("not inside a git repo");
+            return ctxRefresh(ctx.coreDb, scope);
+        },
+    },
+    {
+        name: "cl_search",
+        description: "Hybrid search over the current branch index: FTS5 BM25 + symbol-name match + graph proximity, fused via weighted ranking. Compact ranked handles, cursor pagination. Use BEFORE grep/find/read for code discovery. Pass related:true to also get graph neighbors of the top result in one call.\n\nRETURNS: {indexId, results:[{handle,path,startLine,endLine,score,snippet,why}], nextCursor, freshness, pendingFiles}\n\nWHEN NOT: editing exact files (use cl_expand or read instead).\n\nEXAMPLE: cl_search(query: \"session validation\", limit: 5)",
+        schema: {
+            query: z.string().describe("Search query (2-4 specific technical terms recommended)."),
+            limit: z.coerce.number().optional().default(5).describe("Results per page (default 5)."),
+            cursor: z.string().optional().describe("Pagination cursor from a prior result's nextCursor."),
+            contentType: z.enum(["code", "prose"]).optional().describe("Filter by chunk type: 'code' (source) or 'prose' (docs/markdown). Omit for all, with a modest code boost."),
+            related: z.boolean().optional().describe("If true, also return graph neighbors (imports/importers/tests) of the top result — one-call find+explore."),
+        },
+        handler: (ctx, args) => {
+            ensureActive(ctx);
+            return ctxSearch(ctx.coreDb, args.query, {
+                limit: args.limit,
+                cursor: args.cursor,
+                scope: withScope(ctx) ?? undefined,
+                contentType: args.contentType,
+                related: args.related,
+            });
+        },
+    },
+    {
+        name: "cl_related",
+        description: "Graph expansion: neighbors of a file (imports/imported_by/tests/callers) within the current index, bounded by depth. Compact handles.\n\nRETURNS: {indexId, results:[{handle,path,edgeType,hops,confidence}]}\n\nEXAMPLE: cl_related(path: \"src/auth/auth.ts\", types: [\"imports\"], depth: 2)",
+        schema: {
+            path: z.string().describe("Repo-relative POSIX path to expand from."),
+            types: z.array(z.string()).optional().describe("Edge types: imports|imported_by|tests|calls|references|defines|exports|belongs_to."),
+            depth: z.coerce.number().optional().default(2).describe("Max hops (capped at 3)."),
+            direction: z.enum(["out", "in", "both"]).optional().describe("Edge direction. Default 'both'."),
+        },
+        handler: (ctx, args) => {
+            ensureActive(ctx);
+            return ctxRelated(ctx.coreDb, args.path, {
+                types: args.types,
+                depth: args.depth,
+                direction: args.direction,
+            });
+        },
+    },
+    {
+        name: "cl_expand",
+        description: "Return exact current local file content by path/range. Reads from disk — never stale stored text. Use after cl_search/cl_related to read target snippets before editing.\n\nRETURNS: {path, startLine, endLine, content, truncated, chars}\n\nEXAMPLE: cl_expand(path: \"src/auth/session.ts\", startLine: 12, endLine: 58, budget: 1200)",
+        schema: {
+            path: z.string().optional().describe("Repo-relative POSIX path to read."),
+            handle: z.string().optional().describe("Handle from cl_search/cl_related to resolve to a path+range."),
+            startLine: z.coerce.number().optional().describe("1-indexed start line (default: file start)."),
+            endLine: z.coerce.number().optional().describe("1-indexed end line (default: file end)."),
+            budget: z.coerce.number().optional().describe("Max chars to return (default ~4000)."),
+            targets: z.array(z.object({
+                path: z.string().optional(), handle: z.string().optional(),
+                startLine: z.coerce.number().optional(), endLine: z.coerce.number().optional(), budget: z.coerce.number().optional(),
+            })).optional().describe("Batch: read multiple targets in one call (cuts round-trips). Returns {results:[...]}."),
+        },
+        handler: (ctx, args) => {
+            ensureActive(ctx);
+            if (args.targets && Array.isArray(args.targets)) {
+                return { results: args.targets.map((t) => ctxExpand(ctx.coreDb, ctx.repoRoot, t)) };
+            }
+            return ctxExpand(ctx.coreDb, ctx.repoRoot, {
+                path: args.path,
+                handle: args.handle,
+                startLine: args.startLine,
+                endLine: args.endLine,
+                budget: args.budget,
+            });
+        },
+    },
+    {
+        name: "cl_save",
+        description: "Save a named working-context set (handles/paths + notes) in a separate DB that survives core-index rebuilds. Pin to prevent TTL deletion.\n\nRETURNS: {id, name, pinned, itemCount}\n\nEXAMPLE: cl_save(name: \"auth-investigation\", items: [{path: \"src/auth/session.ts\"}], notes: \"wip\", pinned: true)",
+        schema: {
+            name: z.string().describe("Context name (unique per repo)."),
+            items: z.array(z.object({
+                handle: z.string().optional(),
+                path: z.string().optional(),
+                symbol_id: z.string().optional(),
+                chunk_id: z.string().optional(),
+            })).describe("Handles/paths to remember."),
+            notes: z.string().optional().describe("Free-form notes."),
+            pinned: z.boolean().optional().describe("Pin to prevent TTL deletion."),
+        },
+        handler: (ctx, args) => ctxSave(ctx.ctxDb, ctx.repoRoot, args.name, args.items, {
+            notes: args.notes,
+            pinned: args.pinned,
+        }),
+    },
+    {
+        name: "cl_load",
+        description: "Load a saved working-context by name. Returns items (path/symbol-based, stable across reindex).\n\nRETURNS: {context, items}\n\nEXAMPLE: cl_load(name: \"auth-investigation\")",
+        schema: { name: z.string().describe("Context name to load.") },
+        handler: (ctx, args) => ctxLoad(ctx.ctxDb, ctx.repoRoot, args.name),
+    },
+    {
+        name: "cl_stats",
+        description: "Index statistics: file/symbol/chunk/edge/index counts, total indexes, last indexed. Scoped to active index.\n\nRETURNS: {active, indexId, branch, counts, lastIndexedAt, totalIndexes}\n\nEXAMPLE: cl_stats",
+        schema: {},
+        handler: (ctx) => gatherStats(ctx.coreDb),
+    },
+    {
+        name: "cl_doctor",
+        description: "Health check: node version, better-sqlite3, git, schema version, integrity (PRAGMA quick_check), WAL mode. No PII.\n\nRETURNS: diagnostic booleans + integrityOk\n\nEXAMPLE: cl_doctor",
+        schema: {},
+        handler: (ctx) => runDoctor(ctx.coreDb, ctx.repoRoot),
+    },
+    {
+        name: "cl_usage",
+        description: "Global usage statistics across all repos: per-tool call counts, bytes served, estimated context bytes saved, and a per-repo breakdown. Use to see how much the index tools are being used.\n\nRETURNS: {perTool:[...], perRepo:[...], totals:{calls,bytes_served,bytes_saved}}\n\nEXAMPLE: cl_usage",
+        schema: {},
+        handler: () => new UsageTracker(openGlobalUsageDb()).snapshot(),
+    },
+    {
+        name: "cl_prune",
+        description: "Run a manual TTL sweep: delete expired inactive indexes. Never deletes active/pinned/locked/grace-window indexes.\n\nRETURNS: {deletedIndexes, skipped}\n\nEXAMPLE: cl_prune",
+        schema: {},
+        handler: (ctx) => ctxPrune(ctx.coreDb),
+    },
+    {
+        name: "cl_drop",
+        description: "Delete a specific branch/index explicitly. Refuses the active or pinned index.\n\nRETURNS: {deleted, indexId, reason?}\n\nEXAMPLE: cl_drop(branch: \"old-feature\")",
+        schema: {
+            indexId: z.string().optional().describe("Index id to drop."),
+            branch: z.string().optional().describe("Branch name to drop (resolves to latest index)."),
+        },
+        handler: (ctx, args) => ctxDrop(ctx.coreDb, { indexId: args.indexId, branch: args.branch }),
+    },
+];
+//# sourceMappingURL=registry.js.map

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

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

package/build/src/tools/related.js

@@ -0,0 +1,28 @@
+import { getActiveIndexId, getIndex } from "../index/manager.js";
+import { neighbors as graphNeighbors, testsFor } from "../graph/query.js";
+export function ctxRelated(db, path, opts) {
+    const indexId = getActiveIndexId();
+    if (!indexId || !getIndex(db, indexId))
+        throw new Error("no active index — call cl_refresh first");
+    const ns = graphNeighbors(db, indexId, path, opts ?? {});
+    const results = ns.map((n) => ({
+        handle: `rel:${n.path}`,
+        path: n.path,
+        edgeType: n.edgeType,
+        hops: n.hops,
+        confidence: n.confidence,
+    }));
+    return { indexId, results };
+}
+/** cl_related variant: tests for a given source path. */
+export function ctxRelatedTests(db, sourcePath) {
+    const indexId = getActiveIndexId();
+    if (!indexId || !getIndex(db, indexId))
+        throw new Error("no active index — call cl_refresh first");
+    const ns = testsFor(db, indexId, sourcePath);
+    return {
+        indexId,
+        results: ns.map((n) => ({ handle: `rel:${n.path}`, path: n.path, edgeType: n.edgeType, hops: n.hops, confidence: n.confidence })),
+    };
+}
+//# sourceMappingURL=related.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"related.js","sourceRoot":"","sources":["../../../src/tools/related.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,QAAQ,EAAsB,MAAM,mBAAmB,CAAC;AAoB9F,MAAM,UAAU,UAAU,CACxB,EAAqB,EACrB,IAAY,EACZ,IAA8E;IAE9E,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACnG,MAAM,EAAE,GAAoB,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAoB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9C,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE;QACvB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,UAAU,EAAE,CAAC,CAAC,UAAU;KACzB,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,eAAe,CAAC,EAAqB,EAAE,UAAkB;IACvE,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACnG,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAC7C,OAAO;QACL,OAAO;QACP,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,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;KAClI,CAAC;AACJ,CAAC"}

package/build/src/tools/save.js

@@ -0,0 +1,15 @@
+import { saveContext, loadContext, listContexts, deleteContext } from "../context/store.js";
+export function ctxSave(ctxDb, repoRoot, name, items, opts) {
+    const c = saveContext(ctxDb, repoRoot, name, items, opts);
+    return { id: c.id, name: c.name, pinned: c.pinned, itemCount: items.length };
+}
+export function ctxLoad(ctxDb, repoRoot, name) {
+    return loadContext(ctxDb, repoRoot, name);
+}
+export function ctxListContexts(ctxDb, repoRoot) {
+    return listContexts(ctxDb, repoRoot);
+}
+export function ctxDeleteContext(ctxDb, repoRoot, name) {
+    return deleteContext(ctxDb, repoRoot, name);
+}
+//# sourceMappingURL=save.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"save.js","sourceRoot":"","sources":["../../../src/tools/save.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAA4C,MAAM,qBAAqB,CAAC;AAiBtI,MAAM,UAAU,OAAO,CACrB,KAAwB,EACxB,QAAgB,EAChB,IAAY,EACZ,KAAyB,EACzB,IAA2C;IAE3C,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1D,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;AAC/E,CAAC;AAOD,MAAM,UAAU,OAAO,CAAC,KAAwB,EAAE,QAAgB,EAAE,IAAY;IAC9E,OAAO,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAwB,EAAE,QAAgB;IACxE,OAAO,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAwB,EAAE,QAAgB,EAAE,IAAY;IACvF,OAAO,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC9C,CAAC"}

package/build/src/tools/search.js

@@ -0,0 +1,124 @@
+import { getActiveIndexId, touchIndex, getIndex } from "../index/manager.js";
+import { extractSnippet } from "../search/snippet.js";
+import { rank, normalize } from "../search/rank.js";
+import { neighbors } from "../graph/query.js";
+import { ensureFreshIndex } from "../index/reindex.js";
+const DEFAULT_LIMIT = 5;
+function ftsQuery(query) {
+    const terms = query.split(/[^A-Za-z0-9_]+/i).filter((t) => t.length > 0);
+    if (terms.length === 0)
+        return "";
+    return terms.map((t) => `"${t}"`).join(" OR ");
+}
+function gatherFts(db, indexId, fts, limit, contentType) {
+    const typeClause = contentType ? " AND c.content_type = ?" : "";
+    const params = contentType ? [fts, indexId, contentType, limit] : [fts, indexId, limit];
+    return db
+        .prepare(`SELECT c.path AS path, c.start_line AS startLine, c.end_line AS endLine,
+              c.content AS content, c.id AS chunkId, c.content_type AS contentType,
+              bm25(chunks_fts) AS rank
+       FROM chunks_fts
+       JOIN chunks c ON c.id = chunks_fts.chunk_id
+       WHERE chunks_fts MATCH ? AND chunks_fts.index_id = ?${typeClause}
+       ORDER BY rank ASC LIMIT ?`)
+        .all(...params);
+}
+/** Build hybrid signals (FTS + symbol + graph). */
+function buildSignals(db, indexId, query, ftsRows) {
+    const ftsNorm = normalize(ftsRows.map((r) => -r.rank));
+    const terms = query.toLowerCase().split(/[^a-z0-9_]+/i).filter((t) => t.length > 1);
+    const symbolStmt = db.prepare(`SELECT 1 FROM symbols WHERE index_id = ? AND path = ? AND lower(name) LIKE ? LIMIT 1`);
+    const topPaths = new Set(ftsRows.slice(0, 8).map((r) => r.path));
+    const graphPaths = new Set();
+    for (const p of topPaths) {
+        try {
+            const ns = neighbors(db, indexId, p, { depth: 1 });
+            graphPaths.add(p);
+            for (const n of ns)
+                graphPaths.add(n.path);
+        }
+        catch { /* ignore */ }
+    }
+    return ftsRows.map((r, i) => {
+        const symMatch = terms.some((t) => !!symbolStmt.get(indexId, r.path, "%" + t + "%"));
+        return {
+            path: r.path,
+            startLine: r.startLine,
+            endLine: r.endLine,
+            chunkId: r.chunkId,
+            fts: ftsNorm[i],
+            symbol: symMatch ? 1 : 0,
+            graph: graphPaths.has(r.path) ? 1 : 0,
+            code: r.contentType === "code" ? 1 : 0,
+        };
+    });
+}
+function prelude(db, opts) {
+    let freshness = "fresh";
+    let pendingFiles;
+    if (opts?.scope) {
+        const r = ensureFreshIndex(db, opts.scope, { budgetMs: opts?.refreshBudgetMs });
+        if (r.pending > 0) {
+            freshness = "partial";
+            pendingFiles = r.pending;
+        }
+    }
+    return { freshness, pendingFiles };
+}
+export function ctxSearch(db, query, opts) {
+    const indexId = getActiveIndexId();
+    if (!indexId || !getIndex(db, indexId))
+        throw new Error("no active index — call cl_refresh first");
+    touchIndex(db, indexId);
+    const { freshness, pendingFiles } = prelude(db, opts);
+    const limit = opts?.limit ?? DEFAULT_LIMIT;
+    const offset = decodeCursor(opts?.cursor);
+    const fts = ftsQuery(query);
+    if (fts.length === 0)
+        return { indexId, results: [], nextCursor: null, freshness: "fresh" };
+    const ftsRows = gatherFts(db, indexId, fts, limit * 4, opts?.contentType);
+    const signals = buildSignals(db, indexId, query, ftsRows);
+    const ranked = rank(signals);
+    const page = ranked.slice(offset, offset + limit);
+    const hasMore = offset + limit < ranked.length;
+    const byChunk = new Map(ftsRows.map((r) => [r.chunkId, r]));
+    const results = page.map((r, i) => {
+        const src = r.chunkId ? byChunk.get(r.chunkId) : undefined;
+        const rankOffset = offset + i;
+        return {
+            handle: r.chunkId ?? "",
+            path: r.path,
+            startLine: r.startLine,
+            endLine: r.endLine,
+            score: r.score,
+            snippet: src ? extractSnippet(src.content, query) : r.path,
+            cursor: encodeCursor(rankOffset, r.chunkId ?? `${rankOffset}`),
+            why: r.why,
+        };
+    });
+    const nextCursor = hasMore && results.length > 0 ? encodeCursor(offset + results.length, results[results.length - 1].handle || `${offset}`) : null;
+    const out = { indexId, results, nextCursor, freshness, pendingFiles };
+    if (opts?.related && results[0]) {
+        try {
+            out.related = neighbors(db, indexId, results[0].path, { types: ["imports", "imported_by", "tests"], depth: 1 });
+        }
+        catch { /* graph best-effort */ }
+    }
+    return out;
+}
+function encodeCursor(rank, tiebreaker) {
+    return Buffer.from(`${rank}|${tiebreaker}`, "utf-8").toString("base64url");
+}
+function decodeCursor(cursor) {
+    if (!cursor)
+        return 0;
+    try {
+        const dec = Buffer.from(cursor, "base64url").toString("utf-8");
+        const rank = parseInt(dec.split("|")[0] ?? "0", 10);
+        return Number.isFinite(rank) ? rank : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=search.js.map

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

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

package/build/src/upgrade.js

@@ -0,0 +1,74 @@
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { VERSION } from "./version.js";
+/**
+ * Upgrade check + perform (mirrors codegraph's `upgrade --check` / `upgrade`).
+ *
+ * Detects the app install dir (the repo root that contains package.json and
+ * is a git checkout), then:
+ *   - `checkUpgrade()`: git fetch + compare HEAD vs origin/main (or the tag of
+ *     the latest release) and report whether an update is available.
+ *   - `performUpgrade()`: git pull + npm install + npm run build.
+ *
+ * If not installed from a git checkout (e.g. a future npm-global install), it
+ * reports accordingly and suggests `npm i -g codelens`.
+ */
+function appRoot() {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        // build/src/upgrade.js → repo root (../../package.json); src/upgrade.ts → ../package.json
+        const candidates = [
+            join(here, "..", "..", "package.json"),
+            join(here, "..", "package.json"),
+            join(process.cwd(), "package.json"),
+        ];
+        for (const cand of candidates) {
+            if (existsSync(cand))
+                return dirname(cand);
+        }
+    }
+    catch { /* ignore */ }
+    return null;
+}
+function git(root, args) {
+    const r = spawnSync("git", args, { cwd: root, encoding: "utf-8" });
+    return { ok: r.status === 0, stdout: (r.stdout ?? "").trim(), stderr: (r.stderr ?? "").trim() };
+}
+export async function checkUpgrade() {
+    const root = appRoot();
+    if (!root)
+        return { upToDate: true, message: `codelens ${VERSION} (not a git checkout; use \`npm i -g codelens\` to upgrade if installed via npm)` };
+    if (!existsSync(join(root, ".git")))
+        return { upToDate: true, message: `codelens ${VERSION} (installed without git; re-run your installer to update)` };
+    const branch = git(root, ["rev-parse", "--abbrev-ref", "HEAD"]).stdout || "main";
+    const fetch = git(root, ["fetch", "--quiet", "origin", branch]);
+    if (!fetch.ok)
+        return { upToDate: true, message: `codelens ${VERSION} (could not fetch upstream: ${fetch.stderr || "unknown"})` };
+    const local = git(root, ["rev-parse", "HEAD"]).stdout.slice(0, 12);
+    const remote = git(root, ["rev-parse", `origin/${branch}`]).stdout.slice(0, 12);
+    if (local === remote)
+        return { upToDate: true, message: `codelens ${VERSION} is up to date (${local}).` };
+    const behind = git(root, ["rev-list", "--count", `HEAD..origin/${branch}`]).stdout;
+    return { upToDate: false, message: `codelens ${VERSION}: update available (${behind} commit(s) behind origin/${branch}). Run \`codelens upgrade\` to update.`, local, remote };
+}
+export async function performUpgrade(_version) {
+    const root = appRoot();
+    if (!root)
+        return { ok: false, message: "could not locate the install dir; re-run the installer script." };
+    if (!existsSync(join(root, ".git")))
+        return { ok: false, message: "not a git checkout; re-run the installer script to update." };
+    const branch = git(root, ["rev-parse", "--abbrev-ref", "HEAD"]).stdout || "main";
+    const pull = git(root, ["pull", "--ff-only", "origin", branch]);
+    if (!pull.ok)
+        return { ok: false, message: `git pull failed: ${pull.stderr || pull.stdout}` };
+    const inst = spawnSync("npm", ["install", "--legacy-peer-deps"], { cwd: root, encoding: "utf-8" });
+    if (inst.status !== 0)
+        return { ok: false, message: `npm install failed: ${(inst.stderr ?? inst.stdout ?? "").slice(-500)}` };
+    const build = spawnSync("npm", ["run", "build"], { cwd: root, encoding: "utf-8" });
+    if (build.status !== 0)
+        return { ok: false, message: `npm run build failed: ${(build.stderr ?? build.stdout ?? "").slice(-500)}` };
+    return { ok: true, message: `upgraded to ${VERSION} (pulled origin/${branch}, rebuilt). Restart your agent(s) to pick up changes.` };
+}
+//# sourceMappingURL=upgrade.js.map

package/build/src/upgrade.js.map

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

package/build/src/util/hash.js

@@ -0,0 +1,15 @@
+import { createHash } from "node:crypto";
+/**
+ * Content hash for files/chunks (Design Decision: freshness).
+ *
+ * Uses SHA-256 from node:crypto — synchronous, no extra native dep. Non-crypto
+ * would be faster (xxhash) but requires async WASM init; SHA-256 is fast enough
+ * at 5MB cap and only hashes changed/suspicious files.
+ */
+export function contentHash(text) {
+    return createHash("sha256").update(text, "utf-8").digest("hex");
+}
+export function contentHashBuffer(buf) {
+    return createHash("sha256").update(buf).digest("hex");
+}
+//# sourceMappingURL=hash.js.map

package/build/src/util/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../src/util/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;GAMG;AAEH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC"}

package/build/src/util/paths.js

@@ -0,0 +1,67 @@
+import { relative, isAbsolute, posix } from "node:path";
+import { realpathSync, existsSync } from "node:fs";
+/**
+ * Path normalization (Design Decision #11):
+ *   - Store paths as POSIX internally (forward slashes).
+ *   - Resolve symlinks to real paths at index time.
+ *   - Case-preserving (no lowercasing).
+ *   - Repo-relative for storage; reject traversal outside repo root.
+ */
+/** Convert any OS path to POSIX forward-slash form (always replaces backslashes, even on POSIX hosts). */
+export function toPosix(p) {
+    return p.split("\\").join("/");
+}
+/** Resolve symlinks to the real path; returns POSIX. Falls back to input if unreachable. */
+export function resolveReal(p) {
+    try {
+        return toPosix(realpathSync(p));
+    }
+    catch {
+        // Symlink target missing or not a symlink — normalize the literal path.
+        return toPosix(isAbsolute(p) ? p : resolveReal(".") + "/" + toPosix(p));
+    }
+}
+/**
+ * Return the POSIX repo-relative path for `absOrRel` under `root`.
+ * Throws PathOutsideRepo if the resolved path escapes root.
+ */
+export function repoRelative(root, absOrRel) {
+    const rootReal = resolveReal(root);
+    const abs = isAbsolute(absOrRel) ? absOrRel : posix.join(rootReal, absOrRel);
+    const targetReal = resolveReal(abs);
+    if (!targetReal.startsWith(rootReal + "/") && targetReal !== rootReal) {
+        throw new PathOutsideRepo(targetReal, rootReal);
+    }
+    const rel = relative(rootReal, targetReal);
+    return toPosix(rel);
+}
+/** True if `absOrRel` resolves inside `root`. */
+export function isInsideRepo(root, absOrRel) {
+    try {
+        repoRelative(root, absOrRel);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Assert a path is inside the repo; throw PathOutsideRepo otherwise. */
+export function assertInsideRepo(root, absOrRel) {
+    repoRelative(root, absOrRel); // throws on escape
+}
+export class PathOutsideRepo extends Error {
+    path;
+    root;
+    constructor(path, root) {
+        super(`path "${path}" escapes repo root "${root}"`);
+        this.path = path;
+        this.root = root;
+        this.name = "PathOutsideRepo";
+    }
+}
+/** True if a repo-relative path exists on disk under root. */
+export function existsRelative(root, rel) {
+    const full = posix.join(resolveReal(root), rel);
+    return existsSync(full);
+}
+//# sourceMappingURL=paths.js.map

package/build/src/util/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/util/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;;GAMG;AAEH,0GAA0G;AAC1G,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;QACxE,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,QAAgB;IACzD,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC7E,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,GAAG,GAAG,CAAC,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QACtE,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC3C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,QAAgB;IACzD,IAAI,CAAC;QACH,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAgB;IAC7D,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,mBAAmB;AACnD,CAAC;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACrB;IAAqB;IAAxC,YAAmB,IAAY,EAAS,IAAY;QAClD,KAAK,CAAC,SAAS,IAAI,wBAAwB,IAAI,GAAG,CAAC,CAAC;QADnC,SAAI,GAAJ,IAAI,CAAQ;QAAS,SAAI,GAAJ,IAAI,CAAQ;QAElD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,8DAA8D;AAC9D,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,GAAW;IACtD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/build/src/version.js

@@ -0,0 +1,27 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+/**
+ * Version constant. Read from package.json at module load. Resolves the repo
+ * root from this module's location (build/src/ or src/ → ../../package.json),
+ * falling back to cwd.
+ */
+function readVersion() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        join(here, "..", "..", "package.json"), // build/src/ or src/ → repo root
+        join(here, "..", "package.json"),
+        join(process.cwd(), "package.json"),
+    ];
+    for (const p of candidates) {
+        try {
+            const pkg = JSON.parse(readFileSync(p, "utf-8"));
+            if (pkg.version)
+                return pkg.version;
+        }
+        catch { /* try next */ }
+    }
+    return "0.0.0-unknown";
+}
+export const VERSION = readVersion();
+//# sourceMappingURL=version.js.map

package/build/src/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;GAIG;AAEH,SAAS,WAAW;IAClB,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,iCAAiC;QACzE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC;KACpC,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAyB,CAAC;YACzE,IAAI,GAAG,CAAC,OAAO;gBAAE,OAAO,GAAG,CAAC,OAAO,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAW,WAAW,EAAE,CAAC"}

package/docs/agent-guide.md

@@ -0,0 +1,47 @@
+# Agent Guide — CodeLens
+
+End-to-end workflow for a coding agent using codelens.
+
+## Typical session
+
+```
+1. cl_current
+   → { status: "missing" }   # first run on this branch
+
+2. cl_refresh
+   → { indexedFiles: 812, totalChunks: 2400, status: "ready" }
+
+3. cl_search(query: "session validation")
+   → results: [
+       { handle: "chk_…", path: "src/auth/session.ts", symbol: "validateSession",
+         startLine: 12, endLine: 58, score: 0.92, why: ["fts","symbol","graph"] }
+     ]
+
+4. cl_related(path: "src/auth/session.ts", types: ["tests","imported_by"])
+   → results: [
+       { handle: "rel:src/auth/session.test.ts", path: "…", edgeType: "tests", hops: 1 },
+       { handle: "rel:src/routes/login.ts", path: "…", edgeType: "imported_by", hops: 1 }
+     ]
+
+5. cl_expand(path: "src/auth/session.ts", startLine: 12, endLine: 58, budget: 1200)
+   → { content: "export function validateSession(...) { … }", truncated: false }
+
+6. # edit the file with your normal edit tool now that you know the target
+
+7. cl_save(name: "auth-investigation", items: [{path: "src/auth/session.ts"}], pinned: true)
+8. cl_load(name: "auth-investigation")   # after compaction
+```
+
+## Branch switch
+
+```
+git checkout feature-b
+cl_current   → detects new branch, may say "missing"
+cl_refresh   → builds feature-b index; main's results no longer leak in
+```
+
+
+## Saving context across compaction
+
+`cl_save` / `cl_load` persist named handle sets in a **separate** DB that
+survives core-index rebuilds. Pin important contexts to prevent TTL deletion.