contextpro-mcp 0.0.0-stage → 1.5.0

package/build/core/reconcile-scheduler.d.ts

@@ -0,0 +1,20 @@
+import type { ReconcileResult } from "./index-reconcile.js";
+export interface ReconcileSchedulerOptions {
+    rootDir: string;
+    /** Force a deep sweep every Nth idle tick even with no signalled activity. */
+    forceEverySweeps?: number;
+    /** The actual reconcile pass; injectable for tests. */
+    sweep: (rootDir: string) => Promise<ReconcileResult>;
+    /** Max files to reconcile per sweep, forwarded into the default sweep. */
+    maxFilesPerSweep?: number;
+}
+export interface ReconcileScheduler {
+    /** Mark that the watcher observed file activity since the last sweep. */
+    signalActivity: () => void;
+    /** Run one scheduling tick; sweeps only when the policy says to. */
+    tick: () => Promise<void>;
+    /** True while a capped backlog is still draining (caller may tick sooner). */
+    isDraining: () => boolean;
+}
+export declare function createReconcileScheduler(options: ReconcileSchedulerOptions): ReconcileScheduler;
+//# sourceMappingURL=reconcile-scheduler.d.ts.map

package/build/core/reconcile-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-scheduler.d.ts","sourceRoot":"","sources":["../../src/core/reconcile-scheduler.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACrD,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,oEAAoE;IACpE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,8EAA8E;IAC9E,UAAU,EAAE,MAAM,OAAO,CAAC;CAC3B;AAID,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CA8C/F"}

package/build/core/reconcile-scheduler.js

@@ -0,0 +1,58 @@
+// Reconcile sweep scheduler — decides WHEN the self-healing reconcile runs.
+//
+// FEATURE: Separates the "when to sweep" policy from the "how to sweep" diff
+// (index-reconcile.ts) so the policy is unit-testable without real timers, a real
+// repo, or the FS watcher. Policy:
+//   - Sweep when activity has been signalled since the last sweep (the watcher
+//     saw file changes) — fresh edits get reconciled promptly.
+//   - Skip the sweep while idle, keeping background cost near-zero between edits.
+//   - Force a deep sweep every Nth idle tick anyway, to catch out-of-band changes
+//     the watcher cannot see (git checkout/rebase, atomic renames, missed events).
+//   - Keep sweeping promptly while a capped backlog is still draining.
+//   - Never run two sweeps concurrently.
+const DEFAULT_FORCE_EVERY_SWEEPS = 10;
+export function createReconcileScheduler(options) {
+    const forceEverySweeps = Math.max(1, Math.floor(options.forceEverySweeps ?? DEFAULT_FORCE_EVERY_SWEEPS));
+    let dirty = false;
+    let draining = false;
+    let running = false;
+    let idleTicks = 0;
+    const runSweep = async () => {
+        running = true;
+        try {
+            const result = await options.sweep(options.rootDir);
+            // Keep hot while a capped backlog remains so it drains over the next ticks.
+            draining = result.pending > 0;
+        }
+        catch (error) {
+            // A failed sweep must not wedge the scheduler; the next tick retries.
+            console.error("Reconcile sweep failed:", error);
+            draining = false;
+        }
+        finally {
+            running = false;
+        }
+    };
+    return {
+        signalActivity: () => {
+            dirty = true;
+        },
+        tick: async () => {
+            if (running)
+                return; // serialize — never overlap sweeps
+            const shouldSweep = dirty || draining;
+            if (!shouldSweep) {
+                idleTicks += 1;
+                if (idleTicks < forceEverySweeps)
+                    return;
+                // Forced deep sweep: fall through and sweep this idle tick.
+            }
+            // Consume the activity signal and reset the idle counter for this sweep.
+            dirty = false;
+            idleTicks = 0;
+            await runSweep();
+        },
+        isDraining: () => draining,
+    };
+}
+//# sourceMappingURL=reconcile-scheduler.js.map

package/build/core/reconcile-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-scheduler.js","sourceRoot":"","sources":["../../src/core/reconcile-scheduler.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,EAAE;AACF,6EAA6E;AAC7E,kFAAkF;AAClF,mCAAmC;AACnC,+EAA+E;AAC/E,+DAA+D;AAC/D,kFAAkF;AAClF,kFAAkF;AAClF,mFAAmF;AACnF,uEAAuE;AACvE,yCAAyC;AAuBzC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAEtC,MAAM,UAAU,wBAAwB,CAAC,OAAkC;IACzE,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,gBAAgB,IAAI,0BAA0B,CAAC,CAAC,CAAC;IAEzG,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,MAAM,QAAQ,GAAG,KAAK,IAAmB,EAAE;QACzC,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACpD,4EAA4E;YAC5E,QAAQ,GAAG,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,sEAAsE;YACtE,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;YAChD,QAAQ,GAAG,KAAK,CAAC;QACnB,CAAC;gBAAS,CAAC;YACT,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,cAAc,EAAE,GAAS,EAAE;YACzB,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QAED,IAAI,EAAE,KAAK,IAAmB,EAAE;YAC9B,IAAI,OAAO;gBAAE,OAAO,CAAC,mCAAmC;YAExD,MAAM,WAAW,GAAG,KAAK,IAAI,QAAQ,CAAC;YACtC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,SAAS,IAAI,CAAC,CAAC;gBACf,IAAI,SAAS,GAAG,gBAAgB;oBAAE,OAAO;gBACzC,4DAA4D;YAC9D,CAAC;YAED,yEAAyE;YACzE,KAAK,GAAG,KAAK,CAAC;YACd,SAAS,GAAG,CAAC,CAAC;YACd,MAAM,QAAQ,EAAE,CAAC;QACnB,CAAC;QAED,UAAU,EAAE,GAAY,EAAE,CAAC,QAAQ;KACpC,CAAC;AACJ,CAAC"}

package/build/core/request-context.d.ts

@@ -0,0 +1,7 @@
+import type { IndexFreshnessResult } from "./index-freshness.js";
+/** Run `fn` with `rootDir` as the active request root. */
+export declare function runWithRequestRoot<T>(rootDir: string, fn: () => Promise<T>): Promise<T>;
+export declare const requestFreshness: () => Map<string, Promise<IndexFreshnessResult>> | undefined;
+/** The active request root, or `fallback` when no request context is established. */
+export declare function currentRoot(fallback: string): string;
+//# sourceMappingURL=request-context.d.ts.map

package/build/core/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/core/request-context.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AASjE,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEvF;AAED,eAAO,MAAM,gBAAgB,QAAO,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC,GAAG,SAA0C,CAAC;AAE5H,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/build/core/request-context.js

@@ -0,0 +1,17 @@
+// Per-request root context using AsyncLocalStorage.
+// FEATURE: Multi-worktree routing — withRequestActivity establishes the resolved
+// root for the duration of a tool call so handlers read it without threading the
+// value through every signature. Falls back to the server's boot root when no
+// request context is active (CLI paths, tests, direct calls).
+import { AsyncLocalStorage } from "async_hooks";
+const storage = new AsyncLocalStorage();
+/** Run `fn` with `rootDir` as the active request root. */
+export function runWithRequestRoot(rootDir, fn) {
+    return storage.run({ rootDir, freshness: new Map() }, fn);
+}
+export const requestFreshness = () => storage.getStore()?.freshness;
+/** The active request root, or `fallback` when no request context is established. */
+export function currentRoot(fallback) {
+    return storage.getStore()?.rootDir ?? fallback;
+}
+//# sourceMappingURL=request-context.js.map

package/build/core/request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../../src/core/request-context.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,iFAAiF;AACjF,iFAAiF;AACjF,8EAA8E;AAC9E,8DAA8D;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAQhD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAkB,CAAC;AAExD,0DAA0D;AAC1D,MAAM,UAAU,kBAAkB,CAAI,OAAe,EAAE,EAAoB;IACzE,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAA2D,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,CAAC;AAE5H,qFAAqF;AACrF,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,OAAO,IAAI,QAAQ,CAAC;AACjD,CAAC"}

package/build/core/request-root.d.ts

@@ -0,0 +1,19 @@
+import { type ResolvedWorkspace } from "./workspace-router.js";
+import { type RootsProvider } from "./roots-detect.js";
+export interface RequestRootResolution extends ResolvedWorkspace {
+    /** Original args minus the `root` field, ready to forward to the handler. */
+    handlerArgs: Record<string, unknown>;
+}
+export interface ResolveRequestRootOptions {
+    /** Queries the MCP client's advertised workspace roots for auto-detection. */
+    rootsProvider?: RootsProvider;
+    /** The cwd to attribute the request to when several client roots exist. */
+    requestCwd?: string;
+}
+/**
+ * Resolve the workspace a request targets. Precedence:
+ *   explicit `args.root` → MCP client roots (auto-detected) → server boot root.
+ * The returned `handlerArgs` has `root` removed so existing handlers are unaffected.
+ */
+export declare function resolveRequestRoot(args: Record<string, unknown> | undefined, defaultRoot: string, options?: ResolveRequestRootOptions): Promise<RequestRootResolution>;
+//# sourceMappingURL=request-root.d.ts.map

package/build/core/request-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-root.d.ts","sourceRoot":"","sources":["../../src/core/request-root.ts"],"names":[],"mappings":"AAKA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGxE,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,yBAAyB;IACxC,8EAA8E;IAC9E,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACzC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,qBAAqB,CAAC,CAgBhC"}

package/build/core/request-root.js

@@ -0,0 +1,26 @@
+// Resolve the effective project root for a single tool request.
+// FEATURE: Multi-worktree routing — a tool may carry an optional `root` argument
+// (or inherit the server's boot root); this resolves it to a workspace and hands
+// back the args with `root` stripped so handlers see their normal shape.
+import { resolveWorkspace } from "./workspace-router.js";
+import { resolveAutoRoot } from "./roots-detect.js";
+import { requireExplicitRootForSharedWorktrees } from "./worktree-root-guard.js";
+/**
+ * Resolve the workspace a request targets. Precedence:
+ *   explicit `args.root` → MCP client roots (auto-detected) → server boot root.
+ * The returned `handlerArgs` has `root` removed so existing handlers are unaffected.
+ */
+export async function resolveRequestRoot(args, defaultRoot, options = {}) {
+    const safeArgs = args ?? {};
+    const rawRoot = safeArgs.root;
+    const explicitRoot = typeof rawRoot === "string" && rawRoot.trim().length > 0 ? rawRoot : undefined;
+    // Auto-detect from the client's roots only when no explicit root was passed and
+    // a provider is available; otherwise fall straight through to the boot root.
+    const effectiveRoot = options.rootsProvider
+        ? await resolveAutoRoot(explicitRoot, defaultRoot, options.rootsProvider, options.requestCwd ?? defaultRoot)
+        : explicitRoot;
+    const workspace = await resolveWorkspace(effectiveRoot, defaultRoot, explicitRoot ? undefined : requireExplicitRootForSharedWorktrees);
+    const { root: _omit, ...handlerArgs } = safeArgs;
+    return { ...workspace, handlerArgs };
+}
+//# sourceMappingURL=request-root.js.map

package/build/core/request-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-root.js","sourceRoot":"","sources":["../../src/core/request-root.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,iFAAiF;AACjF,iFAAiF;AACjF,yEAAyE;AAEzE,OAAO,EAAE,gBAAgB,EAA0B,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAsB,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,qCAAqC,EAAE,MAAM,0BAA0B,CAAC;AAcjF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAyC,EACzC,WAAmB,EACnB,UAAqC,EAAE;IAEvC,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC9B,MAAM,YAAY,GAAG,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAEpG,gFAAgF;IAChF,6EAA6E;IAC7E,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa;QACzC,CAAC,CAAC,MAAM,eAAe,CAAC,YAAY,EAAE,WAAW,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,UAAU,IAAI,WAAW,CAAC;QAC5G,CAAC,CAAC,YAAY,CAAC;IAEjB,MAAM,SAAS,GAAG,MAAM,gBAAgB,CACtC,aAAa,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,qCAAqC,CAC7F,CAAC;IACF,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,WAAW,EAAE,GAAG,QAAQ,CAAC;IACjD,OAAO,EAAE,GAAG,SAAS,EAAE,WAAW,EAAE,CAAC;AACvC,CAAC"}

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

@@ -0,0 +1,9 @@
+export interface RootSelection {
+    rootDir: string;
+    source: "cwd" | "positional" | "flag";
+}
+export declare function isUnexpandedVariable(pathValue: string): boolean;
+export declare function selectRootDir(cwd: string, positional: string[], flagRoot?: string): RootSelection;
+export declare function isUnsafeRoot(rootDir: string): boolean;
+export declare function validateSelectedRoot(selection: RootSelection): RootSelection;
+//# sourceMappingURL=root-guard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"root-guard.d.ts","sourceRoot":"","sources":["../../src/core/root-guard.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,GAAG,YAAY,GAAG,MAAM,CAAC;CACvC;AAiBD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,CAQjG;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAUrD;AAaD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,aAAa,GAAG,aAAa,CAQ5E"}

package/build/core/root-guard.js

@@ -0,0 +1,64 @@
+// Root selection and guardrails — keep one MCP process pinned to one safe project root
+// FEATURE: Multi-project trust — reject dangerous cwd fallbacks and support explicit --root binding
+import { homedir } from "os";
+import { existsSync, realpathSync } from "fs";
+import { join, relative, resolve } from "path";
+function normalize(pathValue) {
+    const resolved = resolve(pathValue);
+    try {
+        return realpathSync(resolved);
+    }
+    catch {
+        return resolved;
+    }
+}
+function isInside(parent, child) {
+    const rel = relative(parent, child);
+    return rel === "" || (!rel.startsWith("..") && rel !== "..");
+}
+// A client that does not expand ${workspaceFolder} passes it literally; the launch directory is a better guess.
+export function isUnexpandedVariable(pathValue) {
+    return /\$\{[^}]+\}/.test(pathValue);
+}
+export function selectRootDir(cwd, positional, flagRoot) {
+    if (flagRoot && flagRoot.trim().length > 0 && !isUnexpandedVariable(flagRoot)) {
+        return { rootDir: normalize(flagRoot), source: "flag" };
+    }
+    if (positional.length > 0) {
+        return { rootDir: normalize(positional[0]), source: "positional" };
+    }
+    return { rootDir: normalize(cwd), source: "cwd" };
+}
+export function isUnsafeRoot(rootDir) {
+    const normalized = normalize(rootDir);
+    const home = normalize(homedir());
+    if (normalized === "/")
+        return true;
+    if (normalized === home)
+        return true;
+    if (isInside(home, normalized) && normalized !== home) {
+        const rel = relative(home, normalized);
+        return rel.split("/").filter(Boolean).length <= 1;
+    }
+    return false;
+}
+// A Git repository directly in the home folder (~/myapp) is a project; ~/Downloads is not.
+function isHomeChildRepository(rootDir) {
+    const normalized = normalize(rootDir);
+    return normalized !== "/" && normalized !== normalize(homedir()) && existsSync(join(normalized, ".git"));
+}
+function allowUnsafeRootEnabled() {
+    const raw = (process.env.CONTEXTPRO_ALLOW_UNSAFE_ROOT ?? process.env.CONTEXTPLUS_ALLOW_UNSAFE_ROOT ?? "").trim().toLowerCase();
+    return raw === "1" || raw === "true" || raw === "yes";
+}
+export function validateSelectedRoot(selection) {
+    if (!isUnsafeRoot(selection.rootDir))
+        return selection;
+    if (allowUnsafeRootEnabled())
+        return selection;
+    if (isHomeChildRepository(selection.rootDir))
+        return selection;
+    const sourceHint = selection.source === "flag" ? "--root" : selection.source === "positional" ? "positional argument" : "process.cwd()";
+    throw new Error(`Unsafe project root "${selection.rootDir}" (source: ${sourceHint}). ContextPro refuses to start at the filesystem root, your home folder, or a folder directly inside it that is not a Git repository, because it would create .contextpro/ and SQLite databases there. Pass --root <project-path> to a real project, or set CONTEXTPRO_ALLOW_UNSAFE_ROOT=true to override.`);
+}
+//# sourceMappingURL=root-guard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"root-guard.js","sourceRoot":"","sources":["../../src/core/root-guard.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,oGAAoG;AAEpG,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAO/C,SAAS,SAAS,CAAC,SAAiB;IAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,MAAc,EAAE,KAAa;IAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpC,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED,gHAAgH;AAChH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,UAAoB,EAAE,QAAiB;IAChF,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9E,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IACrE,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IAClC,IAAI,UAAU,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACvC,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,2FAA2F;AAC3F,SAAS,qBAAqB,CAAC,OAAe;IAC5C,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAC3G,CAAC;AAED,SAAS,sBAAsB;IAC7B,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/H,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,KAAK,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAwB;IAC3D,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACvD,IAAI,sBAAsB,EAAE;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,qBAAqB,CAAC,SAAS,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/D,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,eAAe,CAAC;IACxI,MAAM,IAAI,KAAK,CACb,wBAAwB,SAAS,CAAC,OAAO,cAAc,UAAU,4SAA4S,CAC9W,CAAC;AACJ,CAAC"}

package/build/core/roots-detect.d.ts

@@ -0,0 +1,17 @@
+/** A function that returns the client's advertised root URIs (file:// strings). */
+export type RootsProvider = () => Promise<string[]>;
+/**
+ * Choose the workspace root a request belongs to from the client's advertised list.
+ *  - 0 roots → undefined (caller falls back to boot root).
+ *  - 1 root  → that root (the common single-workspace / single-worktree case).
+ *  - N roots → the one whose directory contains `requestCwd`; undefined if none,
+ *    since guessing the wrong worktree is worse than falling back.
+ */
+export declare function selectRootFromList(rootUris: string[], requestCwd: string): string | undefined;
+/**
+ * Resolve the effective root for a request. Precedence:
+ *   explicit `root` arg → client roots (via provider) → boot root.
+ * Provider errors and empty results both fall through to the boot root.
+ */
+export declare function resolveAutoRoot(explicitRoot: string | undefined, bootRoot: string, rootsProvider: RootsProvider, requestCwd: string): Promise<string>;
+//# sourceMappingURL=roots-detect.d.ts.map

package/build/core/roots-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roots-detect.d.ts","sourceRoot":"","sources":["../../src/core/roots-detect.ts"],"names":[],"mappings":"AASA,mFAAmF;AACnF,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAkBpD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAU7F;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAUjB"}

package/build/core/roots-detect.js

@@ -0,0 +1,63 @@
+// Auto-detect the request's worktree root from the MCP client's `roots` capability.
+// FEATURE: Zero-config multi-worktree routing — when an agent does not pass an
+// explicit `root`, ask the client which workspace roots it has open and pick the
+// one this request belongs to. Degrades silently to the server's boot root when
+// the client advertises no usable roots (or lacks the capability entirely).
+import { resolve } from "path";
+import { fileURLToPath } from "url";
+function fileUriToPath(uri) {
+    if (!uri.startsWith("file://"))
+        return null;
+    try {
+        return resolve(fileURLToPath(uri));
+    }
+    catch {
+        return null;
+    }
+}
+function isInside(parent, child) {
+    const p = resolve(parent);
+    const c = resolve(child);
+    if (c === p)
+        return true;
+    return c.startsWith(p.endsWith("/") ? p : `${p}/`);
+}
+/**
+ * Choose the workspace root a request belongs to from the client's advertised list.
+ *  - 0 roots → undefined (caller falls back to boot root).
+ *  - 1 root  → that root (the common single-workspace / single-worktree case).
+ *  - N roots → the one whose directory contains `requestCwd`; undefined if none,
+ *    since guessing the wrong worktree is worse than falling back.
+ */
+export function selectRootFromList(rootUris, requestCwd) {
+    const paths = rootUris.map(fileUriToPath).filter((p) => p !== null);
+    if (paths.length === 0)
+        return undefined;
+    if (paths.length === 1)
+        return paths[0];
+    // Multiple roots: pick the most specific one that contains the request cwd.
+    const containing = paths
+        .filter((p) => isInside(p, requestCwd))
+        .sort((a, b) => b.length - a.length);
+    return containing[0];
+}
+/**
+ * Resolve the effective root for a request. Precedence:
+ *   explicit `root` arg → client roots (via provider) → boot root.
+ * Provider errors and empty results both fall through to the boot root.
+ */
+export async function resolveAutoRoot(explicitRoot, bootRoot, rootsProvider, requestCwd) {
+    if (explicitRoot && explicitRoot.trim().length > 0)
+        return explicitRoot;
+    try {
+        const uris = await rootsProvider();
+        const picked = selectRootFromList(uris, requestCwd);
+        if (picked)
+            return picked;
+    }
+    catch {
+        // Client lacks the roots capability or the request failed — use the boot root.
+    }
+    return bootRoot;
+}
+//# sourceMappingURL=roots-detect.js.map

package/build/core/roots-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roots-detect.js","sourceRoot":"","sources":["../../src/core/roots-detect.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,+EAA+E;AAC/E,iFAAiF;AACjF,gFAAgF;AAChF,4EAA4E;AAE5E,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAKpC,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,MAAc,EAAE,KAAa;IAC7C,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACzB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAkB,EAAE,UAAkB;IACvE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IACjF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAExC,4EAA4E;IAC5E,MAAM,UAAU,GAAG,KAAK;SACrB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;SACtC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,YAAgC,EAChC,QAAgB,EAChB,aAA4B,EAC5B,UAAkB;IAElB,IAAI,YAAY,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,YAAY,CAAC;IACxE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,aAAa,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACpD,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,+EAA+E;IACjF,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/build/core/runtime-session.d.ts

@@ -0,0 +1,5 @@
+export declare const runtimeSessionId: `${string}-${string}-${string}-${string}-${string}`;
+export declare const runtimeSessionStartedAt: number;
+export declare function setToolSchemaTokens(tokens: number): void;
+export declare function getToolSchemaTokens(): number;
+//# sourceMappingURL=runtime-session.d.ts.map

package/build/core/runtime-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-session.d.ts","sourceRoot":"","sources":["../../src/core/runtime-session.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB,qDAAe,CAAC;AAC7C,eAAO,MAAM,uBAAuB,QAAa,CAAC;AAElD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAExD;AACD,wBAAgB,mBAAmB,IAAI,MAAM,CAA6B"}

package/build/core/runtime-session.js

@@ -0,0 +1,10 @@
+// One identity per MCP process; separate concurrently active agents in shared history.
+import { randomUUID } from "node:crypto";
+export const runtimeSessionId = randomUUID();
+export const runtimeSessionStartedAt = Date.now();
+let toolSchemaTokens = 0;
+export function setToolSchemaTokens(tokens) {
+    toolSchemaTokens = Math.max(0, Math.ceil(tokens));
+}
+export function getToolSchemaTokens() { return toolSchemaTokens; }
+//# sourceMappingURL=runtime-session.js.map

package/build/core/runtime-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-session.js","sourceRoot":"","sources":["../../src/core/runtime-session.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,EAAE,CAAC;AAC7C,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAClD,IAAI,gBAAgB,GAAG,CAAC,CAAC;AACzB,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACpD,CAAC;AACD,MAAM,UAAU,mBAAmB,KAAa,OAAO,gBAAgB,CAAC,CAAC,CAAC"}

package/build/core/scip-index.d.ts

@@ -0,0 +1,71 @@
+export declare const DEFAULT_SCIP_CACHE_PATH = ".contextpro/scip-index.json";
+export interface NormalizedScipRelationship {
+    targetSymbol: string;
+    isReference: boolean;
+    isImplementation: boolean;
+    isTypeDefinition: boolean;
+    isDefinition: boolean;
+}
+export interface NormalizedScipSymbol {
+    symbol: string;
+    name: string;
+    kind?: string;
+    file?: string;
+    line?: number;
+    documentation?: string;
+    signature?: string;
+    relationships: NormalizedScipRelationship[];
+}
+export interface NormalizedScipOccurrence {
+    file: string;
+    symbol: string;
+    name: string;
+    line: number;
+    column: number;
+    endLine?: number;
+    endColumn?: number;
+    role: "definition" | "reference";
+    syntaxKind?: string;
+}
+export interface NormalizedScipIndex {
+    version: 1;
+    sourcePath: string;
+    importedAt: string;
+    documents: number;
+    symbols: NormalizedScipSymbol[];
+    occurrences: NormalizedScipOccurrence[];
+}
+export interface ScipExactReference {
+    file: string;
+    line: number;
+    column: number;
+    context: string;
+    isDefinition: boolean;
+    confidence: "SCIP_RESOLVED";
+    symbol: string;
+}
+export interface ScipReferenceResult {
+    total: number;
+    symbol: string;
+    symbols: string[];
+    confidence: "SCIP_RESOLVED";
+    references: ScipExactReference[];
+}
+export interface ScipImportResult {
+    cachePath: string;
+    index: NormalizedScipIndex;
+}
+export declare function scipSymbolDisplayName(symbol: string): string;
+export declare function normalizeScipIndex(raw: unknown, sourcePath: string): NormalizedScipIndex;
+export declare function importScipIndex(rootDir: string, indexPath: string): Promise<ScipImportResult>;
+export declare function loadScipIndex(rootDir: string, indexPath?: string): Promise<NormalizedScipIndex | null>;
+export declare function scipSymbolNodeId(symbol: string): string;
+export declare function findScipReferences(options: {
+    rootDir: string;
+    symbolName: string;
+    file?: string;
+    line?: number;
+    limit?: number;
+    indexPath?: string;
+}): Promise<ScipReferenceResult | null>;
+//# sourceMappingURL=scip-index.d.ts.map

package/build/core/scip-index.d.ts.map

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