context-mode 1.0.19 → 1.0.21

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Claude Code plugins by Mert Koseoğlu",
-    "version": "1.0.19"
+    "version": "1.0.21"
   },
   "plugins": [
     {
       "name": "context-mode",
       "source": "./",
       "description": "Claude Code MCP plugin that saves 98% of your context window. Sandboxed code execution in 11 languages, FTS5 knowledge base with BM25 ranking, and intent-driven search.",
-      "version": "1.0.19",
+      "version": "1.0.21",
       "author": {
         "name": "Mert Koseoğlu"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "description": "MCP server that saves 98% of your context window with session continuity. Sandboxed code execution in 11 languages, FTS5 knowledge base with BM25 ranking, and automatic state restore across compactions.",
   "author": {
     "name": "Mert Koseoğlu",

package/build/server.js

@@ -14,7 +14,7 @@ import { readBashPolicies, evaluateCommandDenyOnly, extractShellCommands, readTo
 import { detectRuntimes, getRuntimeSummary, getAvailableLanguages, hasBunRuntime, } from "./runtime.js";
 import { classifyNonZeroExit } from "./exit-classify.js";
 import { startLifecycleGuard } from "./lifecycle.js";
-const VERSION = "1.0.19";
+const VERSION = "1.0.21";
 // Prevent silent server death from unhandled async errors
 process.on("unhandledRejection", (err) => {
     process.stderr.write(`[context-mode] unhandledRejection: ${err}\n`);

package/cli.bundle.mjs

@@ -293,7 +293,7 @@ async function main() {
 main();
 `}async function sN(){let t=S0();t>0&&console.error(`Cleaned up ${t} stale DB file(s) from previous sessions`);let e=()=>{Ds.cleanupBackgrounded(),mo&&mo.cleanup()},r=async()=>{e(),process.exit(0)};process.on("exit",e),process.on("SIGINT",()=>{r()}),process.on("SIGTERM",()=>{r()}),N0({onShutdown:()=>r()});let n=new lc;await Qt.connect(n);try{let{detectPlatform:o,getAdapter:s}=await Promise.resolve().then(()=>(eu(),jh)),i=o(),a=await s(i.platform);if(!a.capabilities.sessionStart){let c=Bz(Ms(Am(import.meta.url)),".."),u=process.env.CLAUDE_PROJECT_DIR??process.env.CODEX_HOME??process.cwd(),l=a.writeRoutingInstructions(u,c);l&&console.error(`Wrote routing instructions: ${l}`)}}catch{}console.error(`Context Mode MCP server v${L0} running on stdio`),console.error(`Detected runtimes:
 ${Js(jm)}`),_o()||(console.error(`
-Performance tip: Install Bun for 3-5x faster JS/TS execution`),console.error("  curl -fsSL https://bun.sh/install | bash"))}var L0,jm,Kz,Qt,Ds,mo,Ye,Yz,Xz,Qz,eN,mc,$n,Om,tN,j0,M0,Cm,zm,H0=b(()=>{"use strict";o0();c0();$m();wm();k0();C0();Xs();z0();A0();L0="1.0.18";process.on("unhandledRejection",t=>{process.stderr.write(`[context-mode] unhandledRejection: ${t}
+Performance tip: Install Bun for 3-5x faster JS/TS execution`),console.error("  curl -fsSL https://bun.sh/install | bash"))}var L0,jm,Kz,Qt,Ds,mo,Ye,Yz,Xz,Qz,eN,mc,$n,Om,tN,j0,M0,Cm,zm,H0=b(()=>{"use strict";o0();c0();$m();wm();k0();C0();Xs();z0();A0();L0="1.0.20";process.on("unhandledRejection",t=>{process.stderr.write(`[context-mode] unhandledRejection: ${t}
 `)});process.on("uncaughtException",t=>{process.stderr.write(`[context-mode] uncaughtException: ${t?.message??t}
 `)});jm=wn(),Kz=Ys(jm),Qt=new cc({name:"context-mode",version:L0}),Ds=new js({runtimes:jm,projectRoot:process.env.CLAUDE_PROJECT_DIR}),mo=null;Ye={calls:{},bytesReturned:{},bytesIndexed:0,bytesSandboxed:0,sessionStart:Date.now()};Yz=Kz.join(", "),Xz=_o()?" (Bun detected \u2014 JS/TS runs 3-5x faster)":"",Qz="",eN="";Qt.registerTool("ctx_execute",{title:"Execute Code",description:`MANDATORY: Use for any command where output exceeds 20 lines. Execute code in a sandboxed subprocess. Only stdout enters context \u2014 raw data stays in the subprocess.${Xz} Available: ${Yz}.
 

package/hooks/core/formatters.mjs

@@ -9,7 +9,7 @@ export const formatters = {
       hookSpecificOutput: {
         hookEventName: "PreToolUse",
         permissionDecision: "deny",
-        reason,
+        permissionDecisionReason: reason,
       },
     }),
     ask: () => ({
@@ -21,6 +21,8 @@ export const formatters = {
     modify: (updatedInput) => ({
       hookSpecificOutput: {
         hookEventName: "PreToolUse",
+        permissionDecision: "allow",
+        permissionDecisionReason: "Routed to context-mode sandbox",
         updatedInput,
       },
     }),
@@ -46,7 +48,7 @@ export const formatters = {
   "vscode-copilot": {
     deny: (reason) => ({
       permissionDecision: "deny",
-      reason,
+      permissionDecisionReason: reason,
     }),
     ask: () => ({
       permissionDecision: "ask",
@@ -54,6 +56,8 @@ export const formatters = {
     modify: (updatedInput) => ({
       hookSpecificOutput: {
         hookEventName: "PreToolUse",
+        permissionDecision: "allow",
+        permissionDecisionReason: "Routed to context-mode sandbox",
         updatedInput,
       },
     }),

package/hooks/core/routing.mjs

@@ -11,6 +11,46 @@
  */
 
 import { ROUTING_BLOCK, READ_GUIDANCE, GREP_GUIDANCE, BASH_GUIDANCE } from "../routing-block.mjs";
+import { existsSync, mkdirSync, rmSync, openSync, closeSync, constants as fsConstants } from "node:fs";
+import { tmpdir } from "node:os";
+import { resolve } from "node:path";
+
+// Guidance throttle: show each advisory type at most once per session.
+// Hybrid approach:
+//   - In-memory Set for same-process (OpenCode ts-plugin, vitest)
+//   - File-based markers with O_EXCL for cross-process atomicity
+//     (Claude Code, Gemini, Cursor, VS Code Copilot)
+// Session scoped via process.ppid (= host PID, constant for session lifetime).
+const _guidanceShown = new Set();
+const _guidanceDir = resolve(tmpdir(), `context-mode-guidance-${process.ppid}`);
+
+function guidanceOnce(type, content) {
+  // Fast path: in-memory (same process)
+  if (_guidanceShown.has(type)) return null;
+
+  // Ensure marker directory exists
+  try { mkdirSync(_guidanceDir, { recursive: true }); } catch {}
+
+  // Atomic create-or-fail: O_CREAT | O_EXCL | O_WRONLY
+  // First process to create the file wins; others get EEXIST.
+  const marker = resolve(_guidanceDir, type);
+  try {
+    const fd = openSync(marker, fsConstants.O_CREAT | fsConstants.O_EXCL | fsConstants.O_WRONLY);
+    closeSync(fd);
+  } catch {
+    // EEXIST = another process already created it, or we did in-memory
+    _guidanceShown.add(type);
+    return null;
+  }
+
+  _guidanceShown.add(type);
+  return { action: "context", additionalContext: content };
+}
+
+export function resetGuidanceThrottle() {
+  _guidanceShown.clear();
+  try { rmSync(_guidanceDir, { recursive: true, force: true }); } catch {}
+}
 
 /**
  * Strip heredoc content from a shell command.
@@ -157,18 +197,18 @@ export function routePreToolUse(toolName, toolInput, projectDir) {
       };
     }
 
-    // allow all other Bash commands, but inject routing nudge
-    return { action: "context", additionalContext: BASH_GUIDANCE };
+    // allow all other Bash commands, but inject routing nudge (once per session)
+    return guidanceOnce("bash", BASH_GUIDANCE);
   }
 
-  // ─── Read: nudge toward execute_file ───
+  // ─── Read: nudge toward execute_file (once per session) ───
   if (canonical === "Read") {
-    return { action: "context", additionalContext: READ_GUIDANCE };
+    return guidanceOnce("read", READ_GUIDANCE);
   }
 
-  // ─── Grep: nudge toward execute ───
+  // ─── Grep: nudge toward execute (once per session) ───
   if (canonical === "Grep") {
-    return { action: "context", additionalContext: GREP_GUIDANCE };
+    return guidanceOnce("grep", GREP_GUIDANCE);
   }
 
   // ─── WebFetch: deny + redirect to sandbox ───

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "type": "module",
   "description": "MCP plugin that saves 98% of your context window. Works with Claude Code, Gemini CLI, VS Code Copilot, OpenCode, and Codex CLI. Sandboxed code execution, FTS5 knowledge base, and intent-driven search.",
   "author": "Mert Koseoğlu",

package/server.bundle.mjs

@@ -238,7 +238,7 @@ stdout:
 ${n}
 
 stderr:
-${o}`}}var rO=process.ppid;function nO(){let t=process.ppid;return!(t!==rO||t===0||t===1)}function Hy(t){let e=t.checkIntervalMs??3e4,r=t.isParentAlive??nO,n=!1,o=()=>{n||(n=!0,t.onShutdown())},s=setInterval(()=>{r()||o()},e);s.unref();let i=()=>o();process.stdin.resume(),process.stdin.on("end",i),process.stdin.on("close",i),process.stdin.on("error",i);let a=["SIGTERM","SIGINT"];process.platform!=="win32"&&a.push("SIGHUP");for(let c of a)process.on(c,o);return()=>{n=!0,clearInterval(s),process.stdin.removeListener("end",i),process.stdin.removeListener("close",i),process.stdin.removeListener("error",i);for(let c of a)process.removeListener(c,o)}}var Cv="1.0.18";process.on("unhandledRejection",t=>{process.stderr.write(`[context-mode] unhandledRejection: ${t}
+${o}`}}var rO=process.ppid;function nO(){let t=process.ppid;return!(t!==rO||t===0||t===1)}function Hy(t){let e=t.checkIntervalMs??3e4,r=t.isParentAlive??nO,n=!1,o=()=>{n||(n=!0,t.onShutdown())},s=setInterval(()=>{r()||o()},e);s.unref();let i=()=>o();process.stdin.resume(),process.stdin.on("end",i),process.stdin.on("close",i),process.stdin.on("error",i);let a=["SIGTERM","SIGINT"];process.platform!=="win32"&&a.push("SIGHUP");for(let c of a)process.on(c,o);return()=>{n=!0,clearInterval(s),process.stdin.removeListener("end",i),process.stdin.removeListener("close",i),process.stdin.removeListener("error",i);for(let c of a)process.removeListener(c,o)}}var Cv="1.0.20";process.on("unhandledRejection",t=>{process.stderr.write(`[context-mode] unhandledRejection: ${t}
 `)});process.on("uncaughtException",t=>{process.stderr.write(`[context-mode] uncaughtException: ${t?.message??t}
 `)});var $p=Yi(),DO=ky($p),Mt=new Gi({name:"context-mode",version:Cv}),ss=new Qi({runtimes:$p,projectRoot:process.env.CLAUDE_PROJECT_DIR}),Hn=null;function ZO(t){try{let e=da(Iv(),".claude","context-mode","sessions");if(!Ov(e))return;let r=zO(e).filter(n=>n.endsWith("-events.md"));for(let n of r){let o=da(e,n);try{t.index({path:o,source:"session-events"}),CO(o)}catch{}}}catch{}}function is(){return Hn||(Hn=new ea),ZO(Hn),Hn}var qe={calls:{},bytesReturned:{},bytesIndexed:0,bytesSandboxed:0,sessionStart:Date.now()};function G(t,e){let r=e.content.reduce((n,o)=>n+Buffer.byteLength(o.text),0);return qe.calls[t]=(qe.calls[t]||0)+1,qe.bytesReturned[t]=(qe.bytesReturned[t]||0)+r,e}function yr(t){qe.bytesIndexed+=t}function Tp(t,e){try{let r=Xd(process.env.CLAUDE_PROJECT_DIR),n=Qd(t,r);if(n.decision==="deny")return G(e,{content:[{type:"text",text:`Command blocked by security policy: matches deny pattern ${n.matchedPattern}`}],isError:!0})}catch{}return null}function zv(t,e,r){try{let n=qy(t,e);if(n.length===0)return null;let o=Xd(process.env.CLAUDE_PROJECT_DIR);for(let s of n){let i=Qd(s,o);if(i.decision==="deny")return G(r,{content:[{type:"text",text:`Command blocked by security policy: embedded shell command "${s}" matches deny pattern ${i.matchedPattern}`}],isError:!0})}}catch{}return null}function LO(t,e){try{let r=Ly("Read",process.env.CLAUDE_PROJECT_DIR),n=Uy(t,r);if(n.denied)return G(e,{content:[{type:"text",text:`File access blocked by security policy: path matches Read deny pattern ${n.matchedPattern}`}],isError:!0})}catch{}return null}var UO=DO.join(", "),qO=Gd()?" (Bun detected \u2014 JS/TS runs 3-5x faster)":"",HO="",FO="";function VO(t){let e=[],r=0,n=0;for(;n<t.length;)if(t[n]===HO){for(e.push(r),n++;n<t.length&&t[n]!==FO;)r++,n++;n<t.length&&n++}else r++,n++;return e}function Nv(t,e,r=1500,n){if(t.length<=r)return t;let o=[];if(n)for(let u of VO(n))o.push(u);if(o.length===0){let u=e.toLowerCase().split(/\s+/).filter(d=>d.length>2),l=t.toLowerCase();for(let d of u){let f=l.indexOf(d);for(;f!==-1;)o.push(f),f=l.indexOf(d,f+1)}}if(o.length===0)return t.slice(0,r)+`
 \u2026`;o.sort((u,l)=>u-l);let s=300,i=[];for(let u of o){let l=Math.max(0,u-s),d=Math.min(t.length,u+s);i.length>0&&l<=i[i.length-1][1]?i[i.length-1][1]=d:i.push([l,d])}let a=[],c=0;for(let[u,l]of i){if(c>=r)break;let d=t.slice(u,Math.min(l,u+(r-c)));a.push((u>0?"\u2026":"")+d+(l<t.length?"\u2026":"")),c+=d.length}return a.join(`

package/build/delegate.d.ts

@@ -1,48 +0,0 @@
-/**
- * ctx_delegate — Distributed analysis via `claude --print` sub-agents.
- *
- * Spawns parallel Claude CLI subprocesses with pre-read file contents
- * embedded in prompts. Each sub-agent performs single-turn analysis and
- * returns a compressed summary. Results are indexed into FTS5 for follow-up search.
- *
- * Zero dependencies — uses `claude --print` (installed with Claude Code).
- */
-export interface DelegateTask {
-    /** Human-readable label for this sub-agent's work */
-    name: string;
-    /** What the sub-agent should do — the analysis prompt */
-    prompt: string;
-    /** File paths to pre-read and embed. Directories are read recursively (.ts files). */
-    files?: string[];
-}
-export interface DelegateOptions {
-    tasks: DelegateTask[];
-    /** Model to use for sub-agents. Default: claude-sonnet-4-6 */
-    model?: string;
-    /** Per-task timeout in ms. Default: 90_000 (90s) */
-    timeout?: number;
-    /** Max concurrent sub-agents. Default: CPU count, max: 10 */
-    concurrency?: number;
-}
-export interface DelegateTaskResult {
-    name: string;
-    summary: string;
-    durationMs: number;
-    inputTokens: number;
-    outputTokens: number;
-    cacheReadTokens: number;
-    promptChars: number;
-    fileCount: number;
-    missingPaths: string[];
-    error?: string;
-}
-export interface DelegateResult {
-    results: DelegateTaskResult[];
-    wallTimeMs: number;
-    sequentialTimeMs: number;
-    speedup: number;
-    totalPromptTokens: number;
-    totalSummaryTokens: number;
-    compressionPct: number;
-}
-export declare function delegate(opts: DelegateOptions, projectRoot: string): Promise<DelegateResult>;

package/build/delegate.js

@@ -1,265 +0,0 @@
-/**
- * ctx_delegate — Distributed analysis via `claude --print` sub-agents.
- *
- * Spawns parallel Claude CLI subprocesses with pre-read file contents
- * embedded in prompts. Each sub-agent performs single-turn analysis and
- * returns a compressed summary. Results are indexed into FTS5 for follow-up search.
- *
- * Zero dependencies — uses `claude --print` (installed with Claude Code).
- */
-import { readFileSync, readdirSync, statSync } from "node:fs";
-import { join, relative } from "node:path";
-import { cpus } from "node:os";
-import { spawn } from "node:child_process";
-// ── File Reading ───────────────────────────────────────────────────────
-const CODE_EXTENSIONS = new Set([
-    ".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs",
-    ".py", ".rb", ".go", ".rs", ".java", ".c", ".cpp", ".h",
-    ".php", ".pl", ".r", ".ex", ".exs", ".sh", ".bash", ".zsh",
-    ".css", ".scss", ".html", ".json", ".yaml", ".yml", ".toml",
-    ".md", ".txt", ".sql", ".graphql", ".proto",
-]);
-function isCodeFile(path) {
-    const dot = path.lastIndexOf(".");
-    if (dot === -1)
-        return false;
-    return CODE_EXTENSIONS.has(path.slice(dot).toLowerCase());
-}
-/**
- * Read a file or directory, returning file contents keyed by relative path.
- * Directories are read recursively for code files.
- */
-function readFilesForTask(paths, projectRoot) {
-    const files = new Map();
-    const missingPaths = [];
-    for (const p of paths) {
-        const abs = p.startsWith("/") ? p : join(projectRoot, p);
-        try {
-            const stat = statSync(abs);
-            if (stat.isDirectory()) {
-                // Recursive directory read
-                const entries = readdirSync(abs, { recursive: true });
-                for (const entry of entries) {
-                    const entryAbs = join(abs, entry);
-                    try {
-                        if (!statSync(entryAbs).isFile())
-                            continue;
-                        if (!isCodeFile(entry))
-                            continue;
-                        const rel = relative(projectRoot, entryAbs);
-                        files.set(rel, readFileSync(entryAbs, "utf-8"));
-                    }
-                    catch { /* skip unreadable files */ }
-                }
-            }
-            else if (stat.isFile()) {
-                const rel = relative(projectRoot, abs);
-                files.set(rel, readFileSync(abs, "utf-8"));
-            }
-        }
-        catch {
-            missingPaths.push(p);
-        }
-    }
-    let content = "";
-    let totalChars = 0;
-    for (const [path, text] of files) {
-        content += `\n--- ${path} ---\n${text}\n`;
-        totalChars += text.length;
-    }
-    return { content, fileCount: files.size, totalChars, missingPaths };
-}
-// ── Sub-Agent Runner ───────────────────────────────────────────────────
-async function runSubAgent(task, projectRoot, model, timeout) {
-    // Pre-read files and embed in prompt
-    let fileContent = "";
-    let fileCount = 0;
-    let missingPaths = [];
-    if (task.files && task.files.length > 0) {
-        const read = readFilesForTask(task.files, projectRoot);
-        fileContent = read.content;
-        fileCount = read.fileCount;
-        missingPaths = read.missingPaths;
-        // Fail fast: if files were requested but NONE found, don't spawn sub-agent
-        if (fileCount === 0 && missingPaths.length > 0) {
-            return {
-                name: task.name,
-                summary: `ERROR: No files found. Missing paths: ${missingPaths.join(", ")}`,
-                durationMs: 0,
-                inputTokens: 0,
-                outputTokens: 0,
-                cacheReadTokens: 0,
-                promptChars: 0,
-                fileCount: 0,
-                missingPaths,
-                error: "FILES_NOT_FOUND",
-            };
-        }
-    }
-    const fullPrompt = fileContent
-        ? `${task.prompt}\n\n${fileContent}`
-        : task.prompt;
-    // Strip CLAUDECODE env to prevent recursion detection
-    const cleanEnv = { ...process.env };
-    delete cleanEnv.CLAUDECODE;
-    // Propagate depth guard
-    const currentDepth = parseInt(process.env.CTX_DELEGATE_DEPTH ?? "0", 10);
-    cleanEnv.CTX_DELEGATE_DEPTH = String(currentDepth + 1);
-    const startTime = Date.now();
-    // Spawn `claude --print` — single-turn, no tools, inherits OAuth session
-    const args = ["--print", "--model", model, "--max-turns", "1", fullPrompt];
-    return new Promise((resolve) => {
-        const child = spawn("claude", args, {
-            env: cleanEnv,
-            cwd: projectRoot,
-            stdio: ["ignore", "pipe", "pipe"],
-        });
-        let stdout = "";
-        let stderr = "";
-        child.stdout.on("data", (chunk) => { stdout += chunk.toString(); });
-        child.stderr.on("data", (chunk) => { stderr += chunk.toString(); });
-        // Timeout guard
-        const timer = setTimeout(() => {
-            child.kill("SIGTERM");
-            setTimeout(() => { if (!child.killed)
-                child.kill("SIGKILL"); }, 5000);
-        }, timeout);
-        child.on("close", (code) => {
-            clearTimeout(timer);
-            const durationMs = Date.now() - startTime;
-            const summary = stdout.trim();
-            if (code !== 0 && !summary) {
-                resolve({
-                    name: task.name,
-                    summary: `ERROR: claude --print exited with code ${code}. ${stderr.trim().slice(0, 200)}`,
-                    durationMs,
-                    inputTokens: 0,
-                    outputTokens: 0,
-                    cacheReadTokens: 0,
-                    promptChars: fullPrompt.length,
-                    fileCount,
-                    missingPaths,
-                    error: `EXIT_CODE_${code}`,
-                });
-                return;
-            }
-            resolve({
-                name: task.name,
-                summary: summary || "ERROR: Empty response from claude --print",
-                durationMs,
-                inputTokens: 0,
-                outputTokens: 0,
-                cacheReadTokens: 0,
-                promptChars: fullPrompt.length,
-                fileCount,
-                missingPaths,
-                error: summary ? undefined : "EMPTY_RESPONSE",
-            });
-        });
-        child.on("error", (err) => {
-            clearTimeout(timer);
-            resolve({
-                name: task.name,
-                summary: `ERROR: Failed to spawn claude CLI: ${err.message}. Is Claude Code installed?`,
-                durationMs: Date.now() - startTime,
-                inputTokens: 0,
-                outputTokens: 0,
-                cacheReadTokens: 0,
-                promptChars: fullPrompt.length,
-                fileCount: 0,
-                missingPaths,
-                error: "SPAWN_FAILED",
-            });
-        });
-    });
-}
-// ── Concurrency Limiter ────────────────────────────────────────────────
-async function runWithConcurrency(tasks, projectRoot, model, timeout, limit) {
-    const results = [];
-    const queue = [...tasks];
-    const running = new Set();
-    while (queue.length > 0 || running.size > 0) {
-        while (running.size < limit && queue.length > 0) {
-            const task = queue.shift();
-            const p = runSubAgent(task, projectRoot, model, timeout).then((r) => {
-                results.push(r);
-                running.delete(p);
-            });
-            running.add(p);
-        }
-        if (running.size > 0)
-            await Promise.race(running);
-    }
-    return results;
-}
-// ── Public API ─────────────────────────────────────────────────────────
-const MAX_CONCURRENCY = 10;
-const MAX_TASKS = 20;
-const MAX_DEPTH = 1;
-const DEFAULT_TIMEOUT = 90_000;
-const DEFAULT_MODEL = "claude-sonnet-4-6";
-export async function delegate(opts, projectRoot) {
-    // Depth guard — prevent infinite delegation loops
-    const depth = parseInt(process.env.CTX_DELEGATE_DEPTH ?? "0", 10);
-    if (depth >= MAX_DEPTH) {
-        return {
-            results: [{
-                    name: "depth-guard",
-                    summary: "ERROR: Delegation depth limit reached. Sub-agents cannot delegate further.",
-                    durationMs: 0,
-                    inputTokens: 0,
-                    outputTokens: 0,
-                    cacheReadTokens: 0,
-                    promptChars: 0,
-                    fileCount: 0,
-                    missingPaths: [],
-                    error: "DEPTH_LIMIT",
-                }],
-            wallTimeMs: 0,
-            sequentialTimeMs: 0,
-            speedup: 0,
-            totalPromptTokens: 0,
-            totalSummaryTokens: 0,
-            compressionPct: 0,
-        };
-    }
-    // Validate tasks
-    const tasks = opts.tasks.slice(0, MAX_TASKS);
-    if (tasks.length === 0) {
-        return {
-            results: [],
-            wallTimeMs: 0,
-            sequentialTimeMs: 0,
-            speedup: 0,
-            totalPromptTokens: 0,
-            totalSummaryTokens: 0,
-            compressionPct: 0,
-        };
-    }
-    const model = opts.model ?? DEFAULT_MODEL;
-    const timeout = Math.min(opts.timeout ?? DEFAULT_TIMEOUT, 300_000);
-    const concurrency = Math.min(opts.concurrency ?? cpus().length, MAX_CONCURRENCY);
-    const wallStart = Date.now();
-    const results = await runWithConcurrency(tasks, projectRoot, model, timeout, concurrency);
-    const wallTimeMs = Date.now() - wallStart;
-    // Reorder results to match input task order
-    const ordered = tasks.map((t) => results.find((r) => r.name === t.name) ?? results[0]);
-    // Compute metrics
-    const sequentialTimeMs = ordered.reduce((s, r) => s + r.durationMs, 0);
-    const totalPromptChars = ordered.reduce((s, r) => s + r.promptChars, 0);
-    const totalSummaryChars = ordered.reduce((s, r) => s + r.summary.length, 0);
-    const totalPromptTokens = Math.ceil(totalPromptChars / 4);
-    const totalSummaryTokens = Math.ceil(totalSummaryChars / 4);
-    const compressionPct = totalPromptTokens > 0
-        ? (1 - totalSummaryTokens / totalPromptTokens) * 100
-        : 0;
-    return {
-        results: ordered,
-        wallTimeMs,
-        sequentialTimeMs,
-        speedup: wallTimeMs > 0 ? sequentialTimeMs / wallTimeMs : 0,
-        totalPromptTokens,
-        totalSummaryTokens,
-        compressionPct,
-    };
-}

package/build/sync/batcher.d.ts

@@ -1,23 +0,0 @@
-import type { SanitizedEvent } from "./types.js";
-interface BatcherOpts {
-    batchSize: number;
-    flushIntervalMs: number;
-    maxBufferSize: number;
-    onFlush: (events: SanitizedEvent[]) => Promise<void>;
-}
-export declare class EventBatcher {
-    private opts;
-    private buffer;
-    private timer;
-    private inflightPromise;
-    private consecutiveFailures;
-    constructor(opts: BatcherOpts);
-    private startTimer;
-    push(event: SanitizedEvent): void;
-    flush(): Promise<void>;
-    resetCircuitBreaker(): void;
-    get bufferSize(): number;
-    get isCircuitOpen(): boolean;
-    destroy(): void;
-}
-export {};

package/build/sync/batcher.js

@@ -1,74 +0,0 @@
-const MAX_CONSECUTIVE_FAILURES = 5;
-export class EventBatcher {
-    opts;
-    buffer = [];
-    timer = null;
-    inflightPromise = null;
-    consecutiveFailures = 0;
-    constructor(opts) {
-        this.opts = opts;
-        this.startTimer();
-    }
-    startTimer() {
-        this.timer = setInterval(() => {
-            this.flush();
-        }, this.opts.flushIntervalMs);
-        // Don't keep process alive for sync
-        if (this.timer &&
-            typeof this.timer === "object" &&
-            "unref" in this.timer) {
-            this.timer.unref();
-        }
-    }
-    push(event) {
-        this.buffer.push(event);
-        // FIFO eviction
-        if (this.buffer.length > this.opts.maxBufferSize) {
-            this.buffer = this.buffer.slice(this.buffer.length - this.opts.maxBufferSize);
-        }
-        // Flush if batch size reached
-        if (this.buffer.length >= this.opts.batchSize) {
-            this.flush();
-        }
-    }
-    async flush() {
-        if (this.buffer.length === 0)
-            return;
-        if (this.inflightPromise)
-            return; // Don't overlap
-        // Circuit breaker
-        if (this.consecutiveFailures >= MAX_CONSECUTIVE_FAILURES) {
-            return;
-        }
-        const batch = this.buffer.splice(0, this.opts.batchSize);
-        this.inflightPromise = this.opts
-            .onFlush(batch)
-            .then(() => {
-            this.consecutiveFailures = 0;
-        })
-            .catch(() => {
-            this.consecutiveFailures++;
-            // Put events back at front
-            this.buffer.unshift(...batch);
-        })
-            .finally(() => {
-            this.inflightPromise = null;
-        });
-        return this.inflightPromise;
-    }
-    resetCircuitBreaker() {
-        this.consecutiveFailures = 0;
-    }
-    get bufferSize() {
-        return this.buffer.length;
-    }
-    get isCircuitOpen() {
-        return this.consecutiveFailures >= MAX_CONSECUTIVE_FAILURES;
-    }
-    destroy() {
-        if (this.timer) {
-            clearInterval(this.timer);
-            this.timer = null;
-        }
-    }
-}

package/build/sync/cloud-post.d.ts

@@ -1,12 +0,0 @@
-/**
- * Fire-and-forget: sanitize + POST a single event to cloud.
- * Never throws — all errors are silently swallowed.
- */
-export declare function cloudPostEvent(event: {
-    type: string;
-    category: string;
-    priority: number;
-    data: string;
-    source_hook: string;
-    created_at: string;
-}, projectDir: string, sessionId: string, gitRemote?: string): void;

package/build/sync/cloud-post.js

@@ -1,38 +0,0 @@
-import { loadSyncConfig } from "./config.js";
-import { sanitizeEvent, hashSessionId } from "./sanitizer.js";
-let _configCache;
-function getConfig() {
-    if (_configCache === undefined) {
-        _configCache = loadSyncConfig();
-    }
-    return _configCache;
-}
-/**
- * Fire-and-forget: sanitize + POST a single event to cloud.
- * Never throws — all errors are silently swallowed.
- */
-export function cloudPostEvent(event, projectDir, sessionId, gitRemote) {
-    const config = getConfig();
-    if (!config || !config.enabled || !config.api_token || !config.api_url)
-        return;
-    const sanitized = sanitizeEvent(event, projectDir, sessionId);
-    if (!sanitized)
-        return; // Blocked event
-    const hashedSession = hashSessionId(sessionId);
-    const url = `${config.api_url}/ingest/sessions/${hashedSession}/events`;
-    // Fire-and-forget — never block the caller
-    fetch(url, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/json",
-            Authorization: `Bearer ${config.api_token}`,
-        },
-        body: JSON.stringify({
-            events: [sanitized],
-            project_git_remote: gitRemote,
-        }),
-        signal: AbortSignal.timeout(5000),
-    }).catch(() => {
-        // Silently swallow — cloud sync must never break the plugin
-    });
-}

package/build/sync/config.d.ts

@@ -1,4 +0,0 @@
-import type { SyncConfig } from "./types.js";
-export declare function loadSyncConfig(): SyncConfig | null;
-export declare function isSyncEnabled(): boolean;
-export declare function saveSyncConfig(config: Partial<SyncConfig>): void;

package/build/sync/config.js

@@ -1,64 +0,0 @@
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
-import { join, dirname } from "node:path";
-import { homedir } from "node:os";
-const CONFIG_DIR = join(homedir(), ".context-mode");
-const CONFIG_PATH = join(CONFIG_DIR, "sync.json");
-const DEFAULT_API_URL = "https://api.context-mode.com";
-const DEFAULT_CONFIG = {
-    enabled: false,
-    api_url: DEFAULT_API_URL,
-    api_token: "",
-    organization_id: "",
-    batch_size: 50,
-    flush_interval_ms: 30000,
-};
-export function loadSyncConfig() {
-    // Env var overrides
-    const envToken = process.env.CONTEXT_MODE_API_TOKEN;
-    const envUrl = process.env.CONTEXT_MODE_API_URL;
-    const envOrgId = process.env.CONTEXT_MODE_ORG_ID;
-    let fileConfig = {};
-    let fileLoaded = false;
-    try {
-        if (existsSync(CONFIG_PATH)) {
-            const raw = readFileSync(CONFIG_PATH, "utf-8");
-            fileConfig = JSON.parse(raw);
-            fileLoaded = true;
-        }
-    }
-    catch {
-        // Config file corrupted or missing — fall through to env-only path
-    }
-    // Resolve final token: env takes precedence over file
-    const resolvedToken = envToken || fileConfig.api_token || "";
-    // If no token available from any source, sync is not possible
-    if (!resolvedToken) {
-        return null;
-    }
-    // Build the merged config
-    const config = {
-        ...DEFAULT_CONFIG,
-        ...fileConfig,
-        api_token: resolvedToken,
-        // Env vars take precedence over file values
-        ...(envUrl ? { api_url: envUrl } : {}),
-        ...(envOrgId ? { organization_id: envOrgId } : {}),
-    };
-    // Ensure api_url has a sensible default
-    if (!config.api_url) {
-        config.api_url = DEFAULT_API_URL;
-    }
-    // Resolve enabled flag
-    config.enabled = fileConfig.enabled ?? true;
-    return config;
-}
-export function isSyncEnabled() {
-    const config = loadSyncConfig();
-    return config !== null && !!config.api_token;
-}
-export function saveSyncConfig(config) {
-    const current = loadSyncConfig() ?? DEFAULT_CONFIG;
-    const merged = { ...current, ...config };
-    mkdirSync(dirname(CONFIG_PATH), { recursive: true });
-    writeFileSync(CONFIG_PATH, JSON.stringify(merged, null, 2), "utf-8");
-}

package/build/sync/index.d.ts

@@ -1,12 +0,0 @@
-export declare function initSync(sessionId: string, projectDir: string, gitRemote?: string): boolean;
-export declare function enqueueEvent(event: {
-    type: string;
-    category: string;
-    priority: number;
-    data: string;
-    source_hook: string;
-    created_at: string;
-}, projectDir: string, sessionId: string): void;
-export declare function flushSync(): Promise<void>;
-export declare function destroySync(): void;
-export declare function isSyncEnabled(): boolean;

package/build/sync/index.js

@@ -1,55 +0,0 @@
-import { EventBatcher } from "./batcher.js";
-import { EventSender } from "./sender.js";
-import { sanitizeEvent, hashSessionId } from "./sanitizer.js";
-import { loadSyncConfig } from "./config.js";
-let batcher = null;
-let sender = null;
-let config = null;
-export function initSync(sessionId, projectDir, gitRemote) {
-    const loadedConfig = loadSyncConfig();
-    if (!loadedConfig || !loadedConfig.enabled || !loadedConfig.api_token || !loadedConfig.api_url) {
-        return false;
-    }
-    const validConfig = loadedConfig;
-    config = validConfig;
-    const hashedSessionId = hashSessionId(sessionId);
-    sender = new EventSender({
-        apiUrl: validConfig.api_url,
-        apiToken: validConfig.api_token,
-        sessionId: hashedSessionId,
-        projectGitRemote: gitRemote,
-    });
-    batcher = new EventBatcher({
-        batchSize: validConfig.batch_size,
-        flushIntervalMs: validConfig.flush_interval_ms,
-        maxBufferSize: 5000,
-        onFlush: async (events) => {
-            await sender.send(events);
-        },
-    });
-    return true;
-}
-export function enqueueEvent(event, projectDir, sessionId) {
-    if (!batcher)
-        return;
-    const sanitized = sanitizeEvent(event, projectDir, sessionId);
-    if (!sanitized)
-        return; // Blocked event
-    batcher.push(sanitized);
-}
-export async function flushSync() {
-    if (batcher) {
-        await batcher.flush();
-    }
-}
-export function destroySync() {
-    if (batcher) {
-        batcher.destroy();
-        batcher = null;
-    }
-    sender = null;
-    config = null;
-}
-export function isSyncEnabled() {
-    return batcher !== null;
-}

package/build/sync/sanitizer.d.ts

@@ -1,13 +0,0 @@
-import type { SanitizedEvent } from "./types.js";
-export declare function isBlockedEvent(type: string, category: string): boolean;
-export declare function relativizePaths(data: string, projectDir: string): string;
-export declare function redactSecrets(data: string): string;
-export declare function hashSessionId(sessionId: string): string;
-export declare function sanitizeEvent(event: {
-    type: string;
-    category: string;
-    priority: number;
-    data: string;
-    source_hook: string;
-    created_at: string;
-}, projectDir: string, _sessionId: string): SanitizedEvent | null;

package/build/sync/sanitizer.js

@@ -1,86 +0,0 @@
-import { createHash } from "node:crypto";
-// Event types that must NEVER be sent to cloud
-const BLOCKED_TYPES = new Set([
-    "user_prompt",
-    "ai_response",
-    "clipboard_content",
-    "terminal_output",
-]);
-// Categories that must never be sent
-const BLOCKED_CATEGORIES = new Set(["prompt"]);
-// Secret patterns to redact
-const SECRET_PATTERNS = [
-    // AWS
-    [/AKIA[0-9A-Z]{16}/g, "[AWS_KEY]"],
-    [
-        /(aws_secret_access_key|AWS_SECRET_ACCESS_KEY)\s*[=:]\s*\S+/g,
-        "$1=[REDACTED]",
-    ],
-    // GitHub
-    [/gh[ps]_[A-Za-z0-9_]{36,}/g, "[GITHUB_TOKEN]"],
-    [/github_pat_[A-Za-z0-9_]{22,}/g, "[GITHUB_TOKEN]"],
-    // Stripe
-    [/sk_(test|live)_[A-Za-z0-9]{20,}/g, "[STRIPE_KEY]"],
-    // Generic KEY=VALUE (for export commands)
-    [/export\s+(\w+)=\S+/g, "export $1=[REDACTED]"],
-    // Generic tokens/passwords (negative lookahead avoids clobbering already-redacted values)
-    [/(password|secret|token|api_key)\s*[=:]\s*(?!\[)\S+/gi, "$1=[REDACTED]"],
-];
-export function isBlockedEvent(type, category) {
-    return BLOCKED_TYPES.has(type) || BLOCKED_CATEGORIES.has(category);
-}
-export function relativizePaths(data, projectDir) {
-    const home = process.env.HOME || process.env.USERPROFILE || "";
-    let result = data;
-    // Replace project dir first (more specific)
-    if (projectDir) {
-        result = result.replaceAll(projectDir, ".");
-    }
-    // Replace home dir
-    if (home) {
-        result = result.replaceAll(home, "~");
-    }
-    return result;
-}
-export function redactSecrets(data) {
-    let result = data;
-    for (const [pattern, replacement] of SECRET_PATTERNS) {
-        result = result.replace(pattern, replacement);
-    }
-    return result;
-}
-export function hashSessionId(sessionId) {
-    return createHash("sha256").update(sessionId).digest("hex").slice(0, 16);
-}
-export function sanitizeEvent(event, projectDir, _sessionId) {
-    // Block forbidden events
-    if (isBlockedEvent(event.type, event.category))
-        return null;
-    let data = event.data;
-    // Stage 1: Relativize paths
-    data = relativizePaths(data, projectDir);
-    // Stage 2: Redact secrets
-    data = redactSecrets(data);
-    // Stage 3: Strip rule_content
-    if (event.type === "rule_content") {
-        data = "[rule_content]";
-    }
-    // Stage 4: Truncate to 200 chars
-    if (data.length > 200) {
-        data = data.slice(0, 197) + "...";
-    }
-    // Stage 5: Hash for dedup
-    const data_hash = createHash("sha256")
-        .update(`${event.type}:${data}:${event.created_at}`)
-        .digest("hex")
-        .slice(0, 16);
-    return {
-        type: event.type,
-        category: event.category,
-        priority: event.priority,
-        data,
-        source_hook: event.source_hook,
-        created_at: event.created_at,
-        data_hash,
-    };
-}

package/build/sync/sender.d.ts

@@ -1,15 +0,0 @@
-import type { SanitizedEvent, IngestBatchResponse } from "./types.js";
-interface SenderOpts {
-    apiUrl: string;
-    apiToken: string;
-    sessionId: string;
-    projectGitRemote?: string;
-    machineId?: string;
-    timeoutMs?: number;
-}
-export declare class EventSender {
-    private opts;
-    constructor(opts: SenderOpts);
-    send(events: SanitizedEvent[]): Promise<IngestBatchResponse>;
-}
-export {};

package/build/sync/sender.js

@@ -1,30 +0,0 @@
-export class EventSender {
-    opts;
-    constructor(opts) {
-        this.opts = opts;
-    }
-    async send(events) {
-        const url = `${this.opts.apiUrl}/ingest/sessions/${this.opts.sessionId}/events`;
-        const fetchOpts = {
-            method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-                Authorization: `Bearer ${this.opts.apiToken}`,
-            },
-            body: JSON.stringify({
-                events,
-                project_git_remote: this.opts.projectGitRemote,
-                machine_id: this.opts.machineId,
-            }),
-        };
-        if (this.opts.timeoutMs) {
-            fetchOpts.signal = AbortSignal.timeout(this.opts.timeoutMs);
-        }
-        const response = await fetch(url, fetchOpts);
-        if (!response.ok) {
-            const text = await response.text().catch(() => "");
-            throw new Error(`Sync failed: ${response.status} ${text}`);
-        }
-        return response.json();
-    }
-}

package/build/sync/types.d.ts

@@ -1,31 +0,0 @@
-export interface SyncConfig {
-    enabled: boolean;
-    api_url: string;
-    api_token: string;
-    organization_id: string;
-    batch_size: number;
-    flush_interval_ms: number;
-}
-export interface SanitizedEvent {
-    type: string;
-    category: string;
-    priority: number;
-    data: string;
-    source_hook: string;
-    created_at: string;
-    data_hash: string;
-}
-export interface IngestBatchRequest {
-    events: SanitizedEvent[];
-    project_git_remote?: string;
-    machine_id?: string;
-}
-export interface IngestBatchResponse {
-    success: boolean;
-    data?: {
-        accepted: number;
-        duplicates: number;
-        session_id: string;
-    };
-    error?: string;
-}

package/build/sync/types.js

@@ -1 +0,0 @@
-export {};