context-mode 1.0.70 → 1.0.72

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Claude Code plugins by Mert Koseoğlu",
-    "version": "1.0.70"
+    "version": "1.0.72"
   },
   "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.70",
+      "version": "1.0.72",
       "author": {
         "name": "Mert Koseoğlu"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.70",
+  "version": "1.0.72",
   "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/.openclaw-plugin/openclaw.plugin.json

@@ -3,7 +3,7 @@
   "name": "Context Mode",
   "kind": "tool",
   "description": "OpenClaw 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.70",
+  "version": "1.0.72",
   "sandbox": {
     "mode": "permissive",
     "filesystem_access": "full",

package/.openclaw-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.70",
+  "version": "1.0.72",
   "description": "OpenClaw plugin that saves 98% of your context window. Sandboxed code execution in 11 languages, FTS5 knowledge base with BM25 ranking, and intent-driven search.",
   "author": {
     "name": "Mert Koseoğlu",

package/build/server.js

@@ -3,7 +3,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { createRequire } from "node:module";
 import { createHash } from "node:crypto";
-import { existsSync, unlinkSync, readdirSync, readFileSync, rmSync, mkdirSync } from "node:fs";
+import { existsSync, unlinkSync, readdirSync, readFileSync, writeFileSync, rmSync, mkdirSync } from "node:fs";
 import { join, dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { homedir, tmpdir } from "node:os";
@@ -56,6 +56,14 @@ const executor = new PolyglotExecutor({
     runtimes,
     projectRoot: process.env.CLAUDE_PROJECT_DIR,
 });
+// ─────────────────────────────────────────────────────────
+// FS read tracking preload for batch_execute
+// ─────────────────────────────────────────────────────────
+// NODE_OPTIONS is denied by the executor's #buildSafeEnv (security).
+// Instead, we inject it as an inline shell env prefix in each batch command.
+// This temp file is loaded via --require when batch commands spawn Node processes.
+const CM_FS_PRELOAD = join(tmpdir(), `cm-fs-preload-${process.pid}.js`);
+writeFileSync(CM_FS_PRELOAD, `(function(){var __cm_fs=0;process.on('exit',function(){if(__cm_fs>0)try{process.stderr.write('__CM_FS__:'+__cm_fs+'\\n')}catch(e){}});try{var f=require('fs');var ors=f.readFileSync;f.readFileSync=function(){var r=ors.apply(this,arguments);if(Buffer.isBuffer(r))__cm_fs+=r.length;else if(typeof r==='string')__cm_fs+=Buffer.byteLength(r);return r;};}catch(e){}})();\n`);
 // Lazy singleton — no DB overhead unless index/search is used
 let _store = null;
 /**
@@ -531,6 +539,19 @@ server.registerTool("ctx_execute", {
             // The closure approach (function(__cm_req){ var require=...; })(require) correctly
             // shadows the CJS require for all code inside, including __cm_main().
             instrumentedCode = `
+// FS read instrumentation — count bytes read via fs.readFileSync/readFile
+let __cm_fs=0;
+process.on('exit',()=>{if(__cm_fs>0)try{process.stderr.write('__CM_FS__:'+__cm_fs+'\\n')}catch{}});
+(function(){
+  try{
+    var f=typeof require!=='undefined'?require('fs'):null;
+    if(!f)return;
+    var ors=f.readFileSync;
+    f.readFileSync=function(){var r=ors.apply(this,arguments);if(Buffer.isBuffer(r))__cm_fs+=r.length;else if(typeof r==='string')__cm_fs+=Buffer.byteLength(r);return r;};
+    var orf=f.readFile;
+    if(orf)f.readFile=function(){var a=Array.from(arguments),cb=a.pop();orf.apply(this,a.concat([function(e,d){if(!e&&d){if(Buffer.isBuffer(d))__cm_fs+=d.length;else if(typeof d==='string')__cm_fs+=Buffer.byteLength(d);}cb(e,d);}]));};
+  }catch{}
+})();
 let __cm_net=0;
 // Report network bytes on process exit — works with both promise and callback patterns.
 // process.on('exit') fires after all I/O completes, unlike .finally() which fires
@@ -585,6 +606,12 @@ __cm_main().catch(e=>{console.error(e);process.exitCode=1});${background ? '\nse
             // Clean the metric line from stderr
             result.stderr = result.stderr.replace(/\n?__CM_NET__:\d+\n?/g, "");
         }
+        // Parse sandbox FS read metrics from stderr
+        const fsMatch = result.stderr?.match(/__CM_FS__:(\d+)/);
+        if (fsMatch) {
+            sessionStats.bytesSandboxed += parseInt(fsMatch[1]);
+            result.stderr = result.stderr.replace(/\n?__CM_FS__:\d+\n?/g, "");
+        }
         if (result.timedOut) {
             const partialOutput = result.stdout?.trim();
             if (result.backgrounded && partialOutput) {
@@ -1390,6 +1417,10 @@ server.registerTool("ctx_batch_execute", {
         const perCommandOutputs = [];
         const startTime = Date.now();
         let timedOut = false;
+        // Inject NODE_OPTIONS for FS read tracking in spawned Node processes.
+        // The executor denies NODE_OPTIONS in its env (security), so we set it
+        // as an inline shell prefix. This only affects child `node` invocations.
+        const nodeOptsPrefix = `NODE_OPTIONS="--require ${CM_FS_PRELOAD}" `;
         for (const cmd of commands) {
             const elapsed = Date.now() - startTime;
             const remaining = timeout - elapsed;
@@ -1400,10 +1431,20 @@ server.registerTool("ctx_batch_execute", {
             }
             const result = await executor.execute({
                 language: "shell",
-                code: `${cmd.command} 2>&1`,
+                code: `${nodeOptsPrefix}${cmd.command} 2>&1`,
                 timeout: remaining,
             });
-            const output = result.stdout || "(no output)";
+            let output = result.stdout || "(no output)";
+            // Parse and strip __CM_FS__ markers emitted by the preload script.
+            // Because 2>&1 merges stderr into stdout, markers appear in output.
+            const fsMatches = output.matchAll(/__CM_FS__:(\d+)/g);
+            let cmdFsBytes = 0;
+            for (const m of fsMatches)
+                cmdFsBytes += parseInt(m[1]);
+            if (cmdFsBytes > 0) {
+                sessionStats.bytesSandboxed += cmdFsBytes;
+                output = output.replace(/__CM_FS__:\d+\n?/g, "");
+            }
             perCommandOutputs.push(`# ${cmd.label}\n\n${output}\n`);
             if (result.timedOut) {
                 timedOut = true;
@@ -1517,7 +1558,7 @@ server.registerTool("ctx_stats", {
             try {
                 const engine = new AnalyticsEngine(sdb);
                 const report = engine.queryAll(sessionStats);
-                text = formatReport(report);
+                text = formatReport(report, VERSION, _latestVersion);
             }
             finally {
                 sdb.close();
@@ -1527,14 +1568,14 @@ server.registerTool("ctx_stats", {
             // No session DB — build a minimal report from runtime stats only
             const engine = new AnalyticsEngine(createMinimalDb());
             const report = engine.queryAll(sessionStats);
-            text = formatReport(report);
+            text = formatReport(report, VERSION, _latestVersion);
         }
     }
     catch {
         // Session DB not available or incompatible — build minimal report from runtime stats
         const engine = new AnalyticsEngine(createMinimalDb());
         const report = engine.queryAll(sessionStats);
-        text = formatReport(report);
+        text = formatReport(report, VERSION, _latestVersion);
     }
     return trackResponse("ctx_stats", {
         content: [{ type: "text", text }],
@@ -1808,11 +1849,15 @@ async function main() {
     if (cleaned > 0) {
         console.error(`Cleaned up ${cleaned} stale DB file(s) from previous sessions`);
     }
-    // Clean up own DB + backgrounded processes on shutdown
+    // Clean up own DB + backgrounded processes + preload script on shutdown
     const shutdown = () => {
         executor.cleanupBackgrounded();
         if (_store)
             _store.close(); // persist DB for --continue sessions
+        try {
+            unlinkSync(CM_FS_PRELOAD);
+        }
+        catch { /* best effort */ }
     };
     const gracefulShutdown = async () => {
         shutdown();

package/build/session/analytics.d.ts

@@ -1,13 +1,8 @@
 /**
- * AnalyticsEngine — All 27 metrics from SessionDB.
+ * AnalyticsEngine — Runtime savings + session continuity reporting.
  *
- * Computes session-level and cross-session analytics using SQL queries
- * and JavaScript post-processing. Groups:
- *
- *  Group 1 (SQL Direct):    17 metrics — direct SQL against session tables
- *  Group 2 (JS Computed):    3 metrics — SQL + JS post-processing
- *  Group 3 (Runtime):        4 metrics — stubs for server.ts tracking
- *  Group 4 (New Extractor):  3 metrics — stubs for future extractors
+ * Computes context-window savings from runtime stats and queries
+ * session continuity data from SessionDB.
  *
  * Usage:
  *   const engine = new AnalyticsEngine(sessionDb);
@@ -21,46 +16,6 @@ export interface DatabaseAdapter {
         all(...params: unknown[]): unknown[];
     };
 }
-/** Weekly trend data point */
-export interface WeeklyTrendRow {
-    day: string;
-    sessions: number;
-}
-/** Category distribution row */
-export interface ContinuityRow {
-    category: string;
-    count: number;
-}
-/** Hourly productivity row */
-export interface HourlyRow {
-    hour: string;
-    count: number;
-}
-/** Project distribution row */
-export interface ProjectRow {
-    project_dir: string;
-    sessions: number;
-}
-/** CLAUDE.md freshness row */
-export interface FreshnessRow {
-    data: string;
-    last_updated: string;
-}
-/** Rework rate row */
-export interface ReworkRow {
-    data: string;
-    edits: number;
-}
-/** Subagent usage row */
-export interface SubagentRow {
-    data: string;
-    total: number;
-}
-/** Skill usage row */
-export interface SkillRow {
-    data: string;
-    invocations: number;
-}
 /** Context savings result (#1) */
 export interface ContextSavings {
     rawBytes: number;
@@ -86,11 +41,6 @@ export interface SandboxIO {
     inputBytes: number;
     outputBytes: number;
 }
-/** Pattern insight result (#6) */
-export interface PatternInsight {
-    pattern: string;
-    confidence: number;
-}
 /** Runtime stats tracked by server.ts during a live session. */
 export interface RuntimeStats {
     bytesReturned: Record<string, number>;
@@ -131,56 +81,8 @@ export interface FullReport {
     /** Session metadata from SessionDB */
     session: {
         id: string;
-        duration_min: number | null;
-        tool_calls: number;
         uptime_min: string;
     };
-    /** Activity metrics */
-    activity: {
-        commits: number;
-        errors: number;
-        error_rate_pct: number;
-        tool_diversity: number;
-        efficiency_score: number;
-        commits_per_session_avg: number;
-        session_outcome: string;
-        productive_pct: number;
-        exploratory_pct: number;
-    };
-    /** Pattern metrics */
-    patterns: {
-        hourly_commits: number[];
-        weekly_trend: Array<{
-            day: string;
-            sessions: number;
-        }>;
-        iteration_cycles: number;
-        rework: Array<{
-            file: string;
-            edits: number;
-        }>;
-    };
-    /** Health metrics */
-    health: {
-        claude_md_freshness: Array<{
-            project: string;
-            days_ago: number | null;
-        }>;
-        compactions_this_week: number;
-        weekly_sessions: number;
-        permission_denials: number;
-    };
-    /** Agent metrics */
-    agents: {
-        subagents: Array<{
-            type: string;
-            count: number;
-        }>;
-        skills: Array<{
-            name: string;
-            count: number;
-        }>;
-    };
     /** Session continuity data */
     continuity: {
         total_events: number;
@@ -209,117 +111,6 @@ export declare class AnalyticsEngine {
      * or any object with a prepare() method for direct usage.
      */
     constructor(db: DatabaseAdapter);
-    /**
-     * #5 Weekly Trend — sessions started per day over the last 7 days.
-     * Returns an array of { day, sessions } sorted by day.
-     */
-    weeklyTrend(): WeeklyTrendRow[];
-    /**
-     * #7 Session Continuity — event category distribution for a session.
-     * Shows what the session focused on (file ops, git, errors, etc.).
-     */
-    sessionContinuity(sessionId: string): ContinuityRow[];
-    /**
-     * #8 Commit Count — number of git commits made during a session.
-     * Matches events where category='git' and data contains 'commit'.
-     */
-    commitCount(sessionId: string): number;
-    /**
-     * #9 Error Count — total error events in a session.
-     */
-    errorCount(sessionId: string): number;
-    /**
-     * #10 Session Duration — elapsed minutes from session start to last event.
-     * Returns null if last_event_at is not set (session still initializing).
-     */
-    sessionDuration(sessionId: string): number | null;
-    /**
-     * #11 Error Rate — percentage of events that are errors in a session.
-     * Returns 0 for sessions with no events (division by zero protection).
-     */
-    errorRate(sessionId: string): number;
-    /**
-     * #12 Tool Diversity — number of distinct MCP tools used in a session.
-     * Higher diversity suggests more sophisticated tool usage.
-     */
-    toolDiversity(sessionId: string): number;
-    /**
-     * #14 Hourly Productivity — event distribution by hour of day.
-     * Optionally scoped to a session; omit sessionId for all sessions.
-     */
-    hourlyProductivity(sessionId?: string): HourlyRow[];
-    /**
-     * #15 Project Distribution — session count per project directory.
-     * Sorted descending by session count.
-     */
-    projectDistribution(): ProjectRow[];
-    /**
-     * #16 Compaction Count — number of snapshot compactions for a session.
-     * Higher counts indicate longer/more active sessions.
-     */
-    compactionCount(sessionId: string): number;
-    /**
-     * #17 Weekly Session Count — total sessions started in the last 7 days.
-     */
-    weeklySessionCount(): number;
-    /**
-     * #18 Commits Per Session — average commits across all sessions.
-     * Returns 0 when no sessions exist (NULLIF prevents division by zero).
-     */
-    commitsPerSession(): number;
-    /**
-     * #22 CLAUDE.md Freshness — last update timestamp for each rule file.
-     * Helps identify stale configuration files.
-     */
-    claudeMdFreshness(): FreshnessRow[];
-    /**
-     * #24 Rework Rate — files edited more than once (indicates iteration/rework).
-     * Sorted descending by edit count.
-     */
-    reworkRate(sessionId?: string): ReworkRow[];
-    /**
-     * #25 Session Outcome — classify a session as 'productive' or 'exploratory'.
-     * Productive: has at least one commit AND last event is not an error.
-     */
-    sessionOutcome(sessionId: string): "productive" | "exploratory";
-    /**
-     * #26 Subagent Usage — subagent spawn counts grouped by type/purpose.
-     */
-    subagentUsage(sessionId: string): SubagentRow[];
-    /**
-     * #27 Skill Usage — skill/slash-command invocation frequency.
-     * Sorted descending by invocation count.
-     */
-    skillUsage(sessionId: string): SkillRow[];
-    /**
-     * #4 Session Mix — percentage of sessions classified as productive.
-     * Iterates all sessions and uses #25 (sessionOutcome) to classify each.
-     */
-    sessionMix(): {
-        productive: number;
-        exploratory: number;
-    };
-    /**
-     * #13 / #20 Efficiency Score — composite score (0-100) measuring session productivity.
-     *
-     * Components:
-     *  - Error rate (lower = better): weight 30%
-     *  - Tool diversity (higher = better): weight 20%
-     *  - Commit presence (boolean bonus): weight 25%
-     *  - Rework rate (lower = better): weight 15%
-     *  - Session duration efficiency (moderate = better): weight 10%
-     *
-     * Formula: score = 100 - errorPenalty + diversityBonus + commitBonus - reworkPenalty + durationBonus - 40
-     * The -40 baseline prevents empty sessions from scoring 100.
-     */
-    efficiencyScore(sessionId: string): number;
-    /**
-     * #23 Iteration Cycles — counts edit-error-fix sequences in a session.
-     *
-     * Walks events chronologically and detects patterns where a file event
-     * is followed by an error event, then another file event.
-     */
-    iterationCycles(sessionId: string): number;
     /**
      * #1 Context Savings Total — bytes kept out of context window.
      *
@@ -350,32 +141,21 @@ export declare class AnalyticsEngine {
      */
     static sandboxIO(inputBytes: number, outputBytes: number): SandboxIO;
     /**
-     * #6 Pattern Detected — identifies recurring patterns in a session.
-     *
-     * Analyzes category distribution and detects dominant patterns
-     * (>60% threshold). Falls back to combination detection and
-     * "balanced" for evenly distributed sessions.
-     */
-    patternDetected(sessionId: string): string;
-    /**
-     * #21 Permission Denials — count of tool calls blocked by security rules.
-     *
-     * Filters error events containing "denied", "blocked", or "permission".
-     * Stub: ideally requires a dedicated extractor in extract.ts.
-     */
-    permissionDenials(sessionId: string): number;
-    /**
-     * Build a complete FullReport by merging runtime stats (passed in)
-     * with all 27 DB-backed metrics and continuity data.
+     * Build a FullReport by merging runtime stats (passed in)
+     * with continuity data from the DB.
      *
      * This is the ONE call that ctx_stats should use.
      */
     queryAll(runtimeStats: RuntimeStats): FullReport;
 }
 /**
- * Render a FullReport as the same markdown output ctx_stats has always produced.
+ * Render a FullReport as a before/after comparison developers instantly understand.
  *
- * Preserves the exact output format: Context Window Protection table,
- * TTL Cache section, Session Continuity table, and Analytics JSON block.
+ * Design rules:
+ * - If no savings, show "fresh session" format (no fake percentages)
+ * - Active session shows BEFORE vs AFTER -- what would have flooded your conversation vs what actually did
+ * - Per-tool table only if 2+ different tools were called
+ * - Time gained is the hero metric
+ * - Under 15 lines for typical sessions
  */
-export declare function formatReport(report: FullReport): string;
+export declare function formatReport(report: FullReport, version?: string, latestVersion?: string | null): string;