contextpro-mcp 0.0.0-stage → 1.4.0

package/build/core/walker.js

@@ -0,0 +1,152 @@
+// Gitignore-aware recursive directory walker with nested ignore support
+// Returns filtered file paths respecting project and per-directory ignore patterns
+import { readdir, readFile, lstat, open } from "fs/promises";
+import { constants } from "node:fs";
+import { basename, dirname, join, relative, resolve } from "path";
+import ignore from "ignore";
+import { resolveProjectPath } from "./path-guard.js";
+import { isAlwaysIgnoredDir } from "./ignore-dirs.js";
+// These dot-directories contain authored workflows, tests and public web metadata, not runtime
+// state. Keep other hidden entries excluded and honor ordinary ignore layers.
+const SOURCE_DOT_DIRECTORIES = new Set([".github", ".maestro", ".well-known"]);
+/** Recognize Graft's generated wiring cards, rather than excluding every
+ * authored package/directory named graft. Never follow a marker symlink. */
+async function isGeneratedGraftDirectory(dir) {
+    if (basename(dir) !== "graft")
+        return false;
+    const marker = join(dir, "INDEX.md");
+    const stats = await lstat(marker).catch(() => null);
+    if (!stats?.isFile() || stats.isSymbolicLink())
+        return false;
+    let handle;
+    try {
+        handle = await open(marker, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+        if (!(await handle.stat()).isFile())
+            return false;
+        const prefix = Buffer.alloc(1024);
+        const { bytesRead } = await handle.read(prefix, 0, prefix.length, 0);
+        return /^# graft [—-] repo map\r?\n/.test(prefix.subarray(0, bytesRead).toString("utf8"));
+    }
+    catch {
+        return false;
+    }
+    finally {
+        await handle?.close();
+    }
+}
+// The comprehensive, framework-aware ignore set lives in ./ignore-dirs.ts so it can
+// be reused and tested independently. The walker also honors `.gitignore` layers.
+async function loadIgnoreFile(filePath) {
+    try {
+        return await readFile(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+async function buildLocalLayer(dir) {
+    const ig = ignore();
+    let hasRules = false;
+    const gitignoreContent = await loadIgnoreFile(join(dir, ".gitignore"));
+    if (gitignoreContent) {
+        ig.add(gitignoreContent);
+        hasRules = true;
+    }
+    const contextProIgnore = await loadIgnoreFile(join(dir, ".contextproignore"));
+    if (contextProIgnore) {
+        ig.add(contextProIgnore);
+        hasRules = true;
+    }
+    const legacyContextPlusIgnore = await loadIgnoreFile(join(dir, ".contextplusignore"));
+    if (legacyContextPlusIgnore) {
+        ig.add(legacyContextPlusIgnore);
+        hasRules = true;
+    }
+    return hasRules ? { ig, dir } : null;
+}
+function isIgnoredByLayers(fullPath, isDir, layers) {
+    for (const layer of layers) {
+        const relToLayer = relative(layer.dir, fullPath).replace(/\\/g, "/");
+        if (layer.ig.ignores(relToLayer))
+            return true;
+        if (isDir && layer.ig.ignores(relToLayer + "/"))
+            return true;
+    }
+    return false;
+}
+async function walkRecursive(dir, rootDir, parentLayers, depth, maxDepth, results, includeHidden) {
+    if (maxDepth > 0 && depth > maxDepth)
+        return;
+    const layers = [...parentLayers];
+    const localLayer = await buildLocalLayer(dir);
+    if (localLayer)
+        layers.push(localLayer);
+    const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+    for (const entry of entries) {
+        // Discovery only admits recognized hidden source directories. Evidence can
+        // include hidden inputs, while still honoring ignore layers and cache policy.
+        if (isAlwaysIgnoredDir(entry.name)
+            || (!includeHidden && entry.name.startsWith(".") && !(entry.isDirectory() && SOURCE_DOT_DIRECTORIES.has(entry.name))))
+            continue;
+        const fullPath = join(dir, entry.name);
+        const stats = await lstat(fullPath).catch(() => null);
+        if (!stats || stats.isSymbolicLink() || (!stats.isFile() && !stats.isDirectory()))
+            continue;
+        const isDir = entry.isDirectory();
+        if (isDir && await isGeneratedGraftDirectory(fullPath))
+            continue;
+        if (isIgnoredByLayers(fullPath, isDir, layers))
+            continue;
+        const relPath = relative(rootDir, fullPath).replace(/\\/g, "/");
+        results.push({ path: fullPath, relativePath: relPath, isDirectory: isDir, depth });
+        if (isDir)
+            await walkRecursive(fullPath, rootDir, layers, depth + 1, maxDepth, results, includeHidden);
+    }
+}
+export async function walkDirectory(options) {
+    const rootDir = resolve(options.rootDir);
+    const startDir = options.targetPath ? resolveProjectPath(rootDir, options.targetPath, "targetPath") : rootDir;
+    const results = [];
+    const stats = await lstat(startDir).catch(() => null);
+    if (!stats)
+        return results;
+    // A scoped walk must apply the same cache policy to its ancestors, even when
+    // it starts at a cache file or a directory below graft/.
+    for (let dir = stats.isDirectory() ? startDir : dirname(startDir); dir !== rootDir;) {
+        if (await isGeneratedGraftDirectory(dir))
+            return results;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    if (stats.isFile()) {
+        const relPath = relative(rootDir, startDir).replace(/\\/g, "/");
+        results.push({ path: startDir, relativePath: relPath, isDirectory: false, depth: 0 });
+        return results;
+    }
+    // If a caller scopes the walk INTO an always-ignored directory (e.g.
+    // targetPath="vendor" or ".venv"), honor the ignore policy for the start dir
+    // itself — walkRecursive only filters children, so without this a scoped
+    // reindex/grep would still traverse the heavy folder. The project root is
+    // exempt (never refuse to scan the project just because its folder name
+    // collides with an ignored name).
+    if (startDir !== rootDir && isAlwaysIgnoredDir(basename(startDir))) {
+        return results;
+    }
+    await walkRecursive(startDir, rootDir, [], 0, options.depthLimit ?? 0, results, options.includeHidden ?? false);
+    return results;
+}
+export function groupByDirectory(entries) {
+    const groups = new Map();
+    for (const entry of entries) {
+        const dir = entry.relativePath.includes("/")
+            ? entry.relativePath.substring(0, entry.relativePath.lastIndexOf("/"))
+            : ".";
+        const existing = groups.get(dir) ?? [];
+        existing.push(entry);
+        groups.set(dir, existing);
+    }
+    return groups;
+}
+//# sourceMappingURL=walker.js.map

package/build/core/walker.js.map

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

package/build/core/workspace-router.d.ts

@@ -0,0 +1,28 @@
+export interface ResolvedWorkspace {
+    /** The working-tree root this request targets (a worktree or the main checkout). */
+    rootDir: string;
+    /** The main checkout that owns the shared git object store and base index. */
+    baseRoot: string;
+    /** Absolute path to the shared .git directory. */
+    gitCommonDir: string;
+    /** True when rootDir is a linked worktree rather than the main checkout. */
+    isWorktree: boolean;
+    /** When this workspace was first resolved (ISO 8601). */
+    resolvedAt: string;
+}
+/**
+ * Resolve the workspace a request belongs to. Lazy and cached: the first request
+ * for a given worktree pays git-detection cost; later requests reuse the entry.
+ *
+ * Precedence: explicit `requestRoot` (e.g. a tool's `root` argument or the MCP
+ * client's roots capability) → `defaultRoot` (the server's boot root). The result
+ * is validated through the same unsafe-root guard used at startup.
+ */
+export declare function resolveWorkspace(requestRoot: string | undefined, defaultRoot?: string, beforeInitialize?: (workspace: ResolvedWorkspace) => Promise<void>): Promise<ResolvedWorkspace>;
+/** All workspaces resolved so far this process, de-duplicated by rootDir. */
+export declare function listActiveWorkspaces(): ResolvedWorkspace[];
+/** Drop a single workspace from the cache (e.g. on worktree teardown). */
+export declare function forgetWorkspace(rootDir: string): void;
+/** Clear the entire router cache. Intended for tests. */
+export declare function resetWorkspaceRouter(): void;
+//# sourceMappingURL=workspace-router.d.ts.map

package/build/core/workspace-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-router.d.ts","sourceRoot":"","sources":["../../src/core/workspace-router.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,iBAAiB;IAChC,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,UAAU,EAAE,OAAO,CAAC;IACpB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;CACpB;AAYD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,GACjE,OAAO,CAAC,iBAAiB,CAAC,CA8C5B;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,IAAI,iBAAiB,EAAE,CAM1D;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAMrD;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/build/core/workspace-router.js

@@ -0,0 +1,93 @@
+// Per-request workspace resolution for multi-worktree support.
+// FEATURE: One MCP process serves many git worktrees — resolve the workspace a
+// request belongs to (its own root + the shared base checkout) lazily and cache it,
+// so parallel agents in different worktrees each hit the correct index.
+import { resolve } from "path";
+import { realpath } from "fs/promises";
+import { detectWorktreeInfo } from "./project-config.js";
+import { validateSelectedRoot } from "./root-guard.js";
+import { seedWorktreeFromBase } from "./worktree-seed.js";
+const workspaces = new Map();
+function normalizeRequestRoot(requestRoot, defaultRoot) {
+    const candidate = requestRoot && requestRoot.trim().length > 0 ? requestRoot : defaultRoot;
+    if (!candidate || candidate.trim().length === 0) {
+        throw new Error("workspace-router: no request root and no default root provided");
+    }
+    return resolve(candidate);
+}
+/**
+ * Resolve the workspace a request belongs to. Lazy and cached: the first request
+ * for a given worktree pays git-detection cost; later requests reuse the entry.
+ *
+ * Precedence: explicit `requestRoot` (e.g. a tool's `root` argument or the MCP
+ * client's roots capability) → `defaultRoot` (the server's boot root). The result
+ * is validated through the same unsafe-root guard used at startup.
+ */
+export async function resolveWorkspace(requestRoot, defaultRoot, beforeInitialize) {
+    const requested = normalizeRequestRoot(requestRoot, defaultRoot);
+    // Startup canonicalizes symlinks too. Keep one identity/cache entry for an
+    // alias and its real directory, including projects without Git metadata.
+    const normalized = await realpath(requested).catch(() => requested);
+    const cached = workspaces.get(normalized);
+    if (cached) {
+        // Routing must be checked for every request: worktrees may have appeared
+        // since this metadata was cached, or the prior caller passed an explicit root.
+        if (beforeInitialize)
+            await beforeInitialize(cached);
+        workspaces.set(requested, cached);
+        return cached;
+    }
+    // Guard before touching git or the filesystem for storage.
+    validateSelectedRoot({ rootDir: normalized, source: requestRoot ? "flag" : "cwd" });
+    const info = await detectWorktreeInfo(normalized);
+    const workspace = {
+        rootDir: info.worktreeRoot,
+        baseRoot: info.baseRoot,
+        gitCommonDir: info.gitCommonDir,
+        isWorktree: info.isWorktree,
+        resolvedAt: new Date().toISOString(),
+    };
+    // A rejected request must not create or copy an index into a guessed checkout.
+    if (beforeInitialize)
+        await beforeInitialize(workspace);
+    // Stage-2 churn optimization: a brand-new worktree clones the base checkout's
+    // already-built index so the follow-up incremental reindex only touches its
+    // diff. Best-effort — failure just means the worktree reindexes from scratch.
+    if (info.isWorktree) {
+        try {
+            await seedWorktreeFromBase(info.worktreeRoot, info.baseRoot);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            process.stderr.write(`[contextpro/workspace-router] base-index seed failed for ${info.worktreeRoot}: ${message}\n`);
+        }
+    }
+    // Cache under the request path, canonical path and resolved worktree root,
+    // since git may realpath the toplevel to a different string than the request.
+    workspaces.set(requested, workspace);
+    workspaces.set(normalized, workspace);
+    workspaces.set(workspace.rootDir, workspace);
+    return workspace;
+}
+/** All workspaces resolved so far this process, de-duplicated by rootDir. */
+export function listActiveWorkspaces() {
+    const byRoot = new Map();
+    for (const ws of workspaces.values()) {
+        byRoot.set(ws.rootDir, ws);
+    }
+    return [...byRoot.values()];
+}
+/** Drop a single workspace from the cache (e.g. on worktree teardown). */
+export function forgetWorkspace(rootDir) {
+    const requested = resolve(rootDir);
+    const normalized = workspaces.get(requested)?.rootDir ?? requested;
+    for (const [key, ws] of workspaces) {
+        if (key === normalized || ws.rootDir === normalized)
+            workspaces.delete(key);
+    }
+}
+/** Clear the entire router cache. Intended for tests. */
+export function resetWorkspaceRouter() {
+    workspaces.clear();
+}
+//# sourceMappingURL=workspace-router.js.map

package/build/core/workspace-router.js.map

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

package/build/core/worktree-gc.d.ts

@@ -0,0 +1,16 @@
+export interface WorktreeGcResult {
+    removedWorkspaces: number;
+    removedDirs: string[];
+}
+/**
+ * Live worktree roots reported by git (`git worktree list --porcelain`), including
+ * the main checkout. Paths are realpath-resolved to match how the router keys them.
+ */
+export declare function listLiveWorktrees(baseRoot: string): Promise<string[]>;
+/**
+ * Remove indexes for worktrees the router knows about but git no longer lists.
+ * The main checkout is never removed. Best-effort and idempotent: a worktree
+ * whose directory is already gone simply has its router entry dropped.
+ */
+export declare function garbageCollectDeadWorktrees(baseRoot: string): Promise<WorktreeGcResult>;
+//# sourceMappingURL=worktree-gc.d.ts.map

package/build/core/worktree-gc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-gc.d.ts","sourceRoot":"","sources":["../../src/core/worktree-gc.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgB3E;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA0B7F"}

package/build/core/worktree-gc.js

@@ -0,0 +1,69 @@
+// Garbage-collect indexes for worktrees that no longer exist.
+// FEATURE: Stage-2 churn cleanup — Claude Code creates and destroys worktrees
+// constantly. When a worktree is gone, drop it from the in-process router and
+// remove its on-disk .contextpro/ overlay so stale indexes don't accumulate.
+import { execFile } from "child_process";
+import { rm } from "fs/promises";
+import { join, resolve } from "path";
+import { promisify } from "util";
+import { CONTEXTPRO_DIR } from "./data-dir.js";
+import { closeDB } from "./db.js";
+import { forgetWorkspace, listActiveWorkspaces } from "./workspace-router.js";
+import { forgetReconcileStatCache } from "./index-reconcile.js";
+const execFileAsync = promisify(execFile);
+/**
+ * Live worktree roots reported by git (`git worktree list --porcelain`), including
+ * the main checkout. Paths are realpath-resolved to match how the router keys them.
+ */
+export async function listLiveWorktrees(baseRoot) {
+    try {
+        const { stdout } = await execFileAsync("git", ["worktree", "list", "--porcelain"], {
+            cwd: baseRoot,
+            timeout: 8000,
+        });
+        const roots = [];
+        for (const line of stdout.split("\n")) {
+            if (line.startsWith("worktree ")) {
+                roots.push(resolve(line.slice("worktree ".length).trim()));
+            }
+        }
+        return roots;
+    }
+    catch {
+        return [resolve(baseRoot)];
+    }
+}
+/**
+ * Remove indexes for worktrees the router knows about but git no longer lists.
+ * The main checkout is never removed. Best-effort and idempotent: a worktree
+ * whose directory is already gone simply has its router entry dropped.
+ */
+export async function garbageCollectDeadWorktrees(baseRoot) {
+    const base = resolve(baseRoot);
+    const live = new Set(await listLiveWorktrees(base));
+    const removedDirs = [];
+    let removedWorkspaces = 0;
+    for (const ws of listActiveWorkspaces()) {
+        if (!ws.isWorktree)
+            continue; // never GC the base checkout
+        if (ws.baseRoot !== base)
+            continue; // only this repo family
+        if (live.has(ws.rootDir))
+            continue; // still alive
+        // Dead worktree: close its DB handle, forget it, and reclaim its overlay dir.
+        closeDB(ws.rootDir);
+        forgetWorkspace(ws.rootDir);
+        forgetReconcileStatCache(ws.rootDir);
+        removedWorkspaces += 1;
+        const overlayDir = join(ws.rootDir, CONTEXTPRO_DIR);
+        try {
+            await rm(overlayDir, { recursive: true, force: true });
+            removedDirs.push(overlayDir);
+        }
+        catch {
+            // The worktree directory may already be gone; nothing to reclaim.
+        }
+    }
+    return { removedWorkspaces, removedDirs };
+}
+//# sourceMappingURL=worktree-gc.js.map

package/build/core/worktree-gc.js.map

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

package/build/core/worktree-overlay.d.ts

@@ -0,0 +1,22 @@
+export interface WorktreeDiffSet {
+    /** Tracked files that differ from the base checkout's HEAD (modified). */
+    changed: string[];
+    /** Files present in the worktree but not in the base index (added/untracked). */
+    added: string[];
+    /** Files deleted in the worktree relative to base (to drop from the overlay). */
+    deleted: string[];
+}
+/**
+ * Compute the set of files in `worktreeRoot` that diverge from `baseRoot`'s
+ * committed tree. Combines three git views:
+ *  - committed-on-branch divergence: `git diff --name-status <base HEAD>...HEAD`
+ *  - uncommitted working-tree changes: `git status --porcelain`
+ *  - untracked files: surfaced by porcelain `??`
+ *
+ * Paths are returned worktree-relative (POSIX separators), matching how the
+ * indexer keys files.
+ */
+export declare function computeWorktreeDiffSet(worktreeRoot: string, baseRoot: string): Promise<WorktreeDiffSet>;
+/** Worktree-relative paths to (re)index into the overlay: changed ∪ added. */
+export declare function overlayFiles(set: WorktreeDiffSet): string[];
+//# sourceMappingURL=worktree-overlay.d.ts.map

package/build/core/worktree-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-overlay.d.ts","sourceRoot":"","sources":["../../src/core/worktree-overlay.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iFAAiF;IACjF,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iFAAiF;IACjF,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAeD;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA4C7G;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,EAAE,CAE3D"}

package/build/core/worktree-overlay.js

@@ -0,0 +1,84 @@
+// Worktree overlay diff computation for Stage-2 shared-base indexing.
+// FEATURE: Constant worktree churn — instead of re-indexing every file in a new
+// worktree (≈95% identical to the base checkout), index only the files that
+// actually differ. This computes that diff set; the base index supplies the rest.
+import { execFile } from "child_process";
+import { promisify } from "util";
+const execFileAsync = promisify(execFile);
+async function git(cwd, args) {
+    try {
+        const { stdout } = await execFileAsync("git", args, { cwd, timeout: 8000, maxBuffer: 16 * 1024 * 1024 });
+        return stdout;
+    }
+    catch {
+        return "";
+    }
+}
+function nonEmptyLines(raw) {
+    return raw.split("\n").map((line) => line.trim()).filter((line) => line.length > 0);
+}
+/**
+ * Compute the set of files in `worktreeRoot` that diverge from `baseRoot`'s
+ * committed tree. Combines three git views:
+ *  - committed-on-branch divergence: `git diff --name-status <base HEAD>...HEAD`
+ *  - uncommitted working-tree changes: `git status --porcelain`
+ *  - untracked files: surfaced by porcelain `??`
+ *
+ * Paths are returned worktree-relative (POSIX separators), matching how the
+ * indexer keys files.
+ */
+export async function computeWorktreeDiffSet(worktreeRoot, baseRoot) {
+    const changed = new Set();
+    const added = new Set();
+    const deleted = new Set();
+    // Base HEAD to diff branch commits against. Empty when base has no commits.
+    const baseHead = (await git(baseRoot, ["rev-parse", "HEAD"])).trim();
+    if (baseHead.length > 0) {
+        // Three-dot: changes on the worktree branch since it forked from base HEAD.
+        const branchDiff = await git(worktreeRoot, ["diff", "--name-status", `${baseHead}...HEAD`]);
+        for (const line of nonEmptyLines(branchDiff)) {
+            const [status, ...rest] = line.split(/\s+/);
+            const path = rest[rest.length - 1];
+            if (!path)
+                continue;
+            if (status.startsWith("D"))
+                deleted.add(path);
+            else if (status.startsWith("A"))
+                added.add(path);
+            else
+                changed.add(path);
+        }
+    }
+    // Uncommitted + untracked working-tree state.
+    const porcelain = await git(worktreeRoot, ["status", "--porcelain", "--untracked-files=all"]);
+    for (const line of porcelain.split("\n")) {
+        if (line.length < 4)
+            continue;
+        const code = line.slice(0, 2);
+        const path = line.slice(3).trim();
+        if (!path)
+            continue;
+        if (code === "??")
+            added.add(path);
+        else if (code.includes("D"))
+            deleted.add(path);
+        else
+            added.has(path) || changed.add(path);
+    }
+    // Deleted wins: a file deleted then re-added is "added", but a pure delete
+    // must not also appear as changed.
+    for (const path of deleted) {
+        changed.delete(path);
+        added.delete(path);
+    }
+    return {
+        changed: [...changed],
+        added: [...added],
+        deleted: [...deleted],
+    };
+}
+/** Worktree-relative paths to (re)index into the overlay: changed ∪ added. */
+export function overlayFiles(set) {
+    return [...new Set([...set.changed, ...set.added])];
+}
+//# sourceMappingURL=worktree-overlay.js.map

package/build/core/worktree-overlay.js.map

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

package/build/core/worktree-root-guard.d.ts

@@ -0,0 +1,8 @@
+import type { ResolvedWorkspace } from "./workspace-router.js";
+/**
+ * Inspect Git's small worktree registry, not the source tree. Do not cache its
+ * contents: another agent can add/remove a worktree while the MCP stays alive.
+ * Explicit-root requests never call this function.
+ */
+export declare function requireExplicitRootForSharedWorktrees(workspace: ResolvedWorkspace): Promise<void>;
+//# sourceMappingURL=worktree-root-guard.d.ts.map

package/build/core/worktree-root-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-root-guard.d.ts","sourceRoot":"","sources":["../../src/core/worktree-root-guard.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAU/D;;;;GAIG;AACH,wBAAsB,qCAAqC,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyDvG"}

package/build/core/worktree-root-guard.js

@@ -0,0 +1,82 @@
+// Shared MCP connections cannot infer which subagent worktree made a request.
+import { opendir, readFile, realpath, stat } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+const MAX_ADMIN_ENTRIES = 64;
+const MAX_DISPLAY_ROOTS = 4;
+const MAX_DISPLAY_PATH = 240;
+function displayPath(path) {
+    return path.length <= MAX_DISPLAY_PATH ? path : `${path.slice(0, MAX_DISPLAY_PATH - 3)}...`;
+}
+/**
+ * Inspect Git's small worktree registry, not the source tree. Do not cache its
+ * contents: another agent can add/remove a worktree while the MCP stays alive.
+ * Explicit-root requests never call this function.
+ */
+export async function requireExplicitRootForSharedWorktrees(workspace) {
+    // Linked checkouts always require explicit routing. The main checkout cannot
+    // be located reliably from a separate Git store (or a bare repository), so
+    // the absence of another registered path does not prove this root is intended.
+    if (workspace.isWorktree) {
+        throw new Error(`Ambiguous worktree: this MCP connection would use ${displayPath(workspace.rootDir)}. `
+            + "Linked worktrees require an explicit root, including checkouts attached to separate or bare Git stores. "
+            + "Pass root as the absolute directory of the checkout you are editing on every tool call.");
+    }
+    const roots = new Set([workspace.rootDir]);
+    let registry;
+    try {
+        registry = await opendir(join(workspace.gitCommonDir, "worktrees"));
+    }
+    catch (error) {
+        if (["ENOENT", "ENOTDIR"].includes(error.code ?? ""))
+            return;
+        throw new Error(`Cannot verify worktree routing for ${displayPath(workspace.rootDir)}. Pass root as the absolute working directory for this request.`);
+    }
+    let inspected = 0;
+    let bounded = false;
+    try {
+        for await (const entry of registry) {
+            if (++inspected > MAX_ADMIN_ENTRIES) {
+                bounded = true;
+                break;
+            }
+            if (!entry.isDirectory())
+                continue;
+            const adminDir = join(workspace.gitCommonDir, "worktrees", entry.name);
+            try {
+                const gitFile = (await readFile(join(adminDir, "gitdir"), "utf8")).trim();
+                if (!gitFile)
+                    continue;
+                const resolvedGitFile = resolve(adminDir, gitFile);
+                // Ignore prunable registry entries after a checkout was removed manually.
+                const checkoutGit = await stat(resolvedGitFile);
+                if (!checkoutGit.isFile())
+                    continue;
+                const checkout = await realpath(dirname(resolvedGitFile));
+                roots.add(checkout);
+                if (roots.size >= MAX_DISPLAY_ROOTS) {
+                    bounded = true;
+                    break;
+                }
+            }
+            catch (error) {
+                if (["ENOENT", "ENOTDIR"].includes(error.code ?? ""))
+                    continue;
+                // Unreadable registry metadata cannot prove this connection unambiguous.
+                bounded = true;
+                break;
+            }
+        }
+    }
+    catch {
+        bounded = true;
+    }
+    if (roots.size <= 1 && !bounded)
+        return;
+    const candidates = [...roots].slice(0, MAX_DISPLAY_ROOTS).map(displayPath).join(" | ");
+    throw new Error(`Ambiguous worktree: this MCP connection would use ${displayPath(workspace.rootDir)}, `
+        + "but this repository has other or unverified linked worktrees. "
+        + "Pass root as the absolute directory of the checkout you are editing on every tool call; "
+        + "reindexing without root could refresh a different checkout. "
+        + `Candidates: ${candidates}${bounded ? " | ..." : ""}`);
+}
+//# sourceMappingURL=worktree-root-guard.js.map

package/build/core/worktree-root-guard.js.map

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

package/build/core/worktree-seed.d.ts

@@ -0,0 +1,14 @@
+export interface SeedResult {
+    seeded: boolean;
+    reason?: "same-root" | "no-base-index" | "worktree-index-exists";
+    bytesCopied?: number;
+}
+/**
+ * SQLite's online backup includes committed WAL pages and yields a consistent
+ * snapshot even if the base is open in another process. Initialize the private
+ * snapshot before an exclusive hard-link publication: readers never see a
+ * partial database, and concurrent first requests cannot overwrite one another
+ * or a database initialized by getDB in the meantime.
+ */
+export declare function seedWorktreeFromBase(worktreeRoot: string, baseRoot: string): Promise<SeedResult>;
+//# sourceMappingURL=worktree-seed.d.ts.map

package/build/core/worktree-seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-seed.d.ts","sourceRoot":"","sources":["../../src/core/worktree-seed.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,GAAG,eAAe,GAAG,uBAAuB,CAAC;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAgBD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAgEtG"}