context-mode 1.0.69 → 1.0.71

package/.claude-plugin/marketplace.json

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

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.69",
+  "version": "1.0.71",
   "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.69",
+  "version": "1.0.71",
   "sandbox": {
     "mode": "permissive",
     "filesystem_access": "full",

package/.openclaw-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.69",
+  "version": "1.0.71",
   "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

@@ -7,6 +7,7 @@ import { existsSync, unlinkSync, readdirSync, readFileSync, rmSync, mkdirSync }
 import { join, dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { homedir, tmpdir } from "node:os";
+import { request as httpsRequest } from "node:https";
 import { z } from "zod";
 import { PolyglotExecutor } from "./executor.js";
 import { ContentStore, cleanupStaleDBs, cleanupStaleContentDBs } from "./store.js";
@@ -180,7 +181,72 @@ const sessionStats = {
     cacheBytesSaved: 0, // bytes avoided by TTL cache hits
     sessionStart: Date.now(),
 };
+// ── Version outdated warning ──────────────────────────────────────────────
+// Non-blocking npm check at startup. trackResponse prepends warning
+// using a burst cadence: 3 warnings → 1h silent → 3 warnings → repeat.
+let _latestVersion = null;
+let _warningBurstCount = 0;
+let _lastBurstStart = 0;
+const VERSION_BURST_SIZE = 3;
+const VERSION_SILENT_MS = 60 * 60 * 1000; // 1 hour
+async function fetchLatestVersion() {
+    return new Promise((res) => {
+        const req = httpsRequest("https://registry.npmjs.org/context-mode/latest", { headers: { Connection: "close" } }, (resp) => {
+            let raw = "";
+            resp.on("data", (chunk) => { raw += chunk; });
+            resp.on("end", () => {
+                try {
+                    const data = JSON.parse(raw);
+                    res(data.version ?? "unknown");
+                }
+                catch {
+                    res("unknown");
+                }
+            });
+        });
+        req.on("error", () => res("unknown"));
+        req.setTimeout(5000, () => { req.destroy(); res("unknown"); });
+        req.end();
+    });
+}
+function getUpgradeHint() {
+    const name = _detectedAdapter?.name;
+    if (name === "Claude Code")
+        return "/ctx-upgrade";
+    if (name === "OpenClaw")
+        return "npm run install:openclaw";
+    if (name === "Pi")
+        return "npm run build";
+    return "npm update -g context-mode";
+}
+function isOutdated() {
+    if (!_latestVersion || _latestVersion === "unknown")
+        return false;
+    return _latestVersion !== VERSION;
+}
+function shouldShowVersionWarning() {
+    if (!isOutdated())
+        return false;
+    const now = Date.now();
+    // Start of a new burst?
+    if (_warningBurstCount >= VERSION_BURST_SIZE) {
+        if (now - _lastBurstStart < VERSION_SILENT_MS)
+            return false; // still silent
+        _warningBurstCount = 0; // silence over, reset burst
+    }
+    if (_warningBurstCount === 0)
+        _lastBurstStart = now;
+    _warningBurstCount++;
+    return true;
+}
 function trackResponse(toolName, response) {
+    // Prepend version outdated warning if needed
+    if (shouldShowVersionWarning() && response.content.length > 0) {
+        const hint = getUpgradeHint();
+        response.content[0].text =
+            `⚠️ context-mode v${VERSION} outdated → v${_latestVersion} available. Upgrade: ${hint}\n\n` +
+                response.content[0].text;
+    }
     const bytes = response.content.reduce((sum, c) => sum + Buffer.byteLength(c.text), 0);
     sessionStats.calls[toolName] = (sessionStats.calls[toolName] || 0) + 1;
     sessionStats.bytesReturned[toolName] =
@@ -465,6 +531,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
@@ -519,6 +598,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) {
@@ -1770,6 +1855,9 @@ async function main() {
         }
     }
     catch { /* best effort — _detectedAdapter stays null, falls back to .claude */ }
+    // Non-blocking version check — result stored for trackResponse warnings
+    fetchLatestVersion().then(v => { if (v !== "unknown")
+        _latestVersion = v; });
     console.error(`Context Mode MCP server v${VERSION} running on stdio`);
     console.error(`Detected runtimes:\n${getRuntimeSummary(runtimes)}`);
     if (!hasBunRuntime()) {

package/build/session/analytics.d.ts

@@ -373,9 +373,9 @@ export declare class AnalyticsEngine {
     queryAll(runtimeStats: RuntimeStats): FullReport;
 }
 /**
- * Render a FullReport as the same markdown output ctx_stats has always produced.
+ * Render a FullReport as a marketing-friendly, outcome-focused session story.
  *
- * Preserves the exact output format: Context Window Protection table,
- * TTL Cache section, Session Continuity table, and Analytics JSON block.
+ * Framework: Persona -> Metric -> Evidence -> Action -> ROI
+ * The output tells a narrative instead of dumping raw numbers.
  */
 export declare function formatReport(report: FullReport): string;

package/build/session/analytics.js

@@ -613,62 +613,95 @@ function kb(b) {
     return `${(b / 1024).toFixed(1)}KB`;
 }
 /**
- * Render a FullReport as the same markdown output ctx_stats has always produced.
+ * Render a FullReport as a marketing-friendly, outcome-focused session story.
  *
- * Preserves the exact output format: Context Window Protection table,
- * TTL Cache section, Session Continuity table, and Analytics JSON block.
+ * Framework: Persona -> Metric -> Evidence -> Action -> ROI
+ * The output tells a narrative instead of dumping raw numbers.
  */
 export function formatReport(report) {
-    const lines = [
-        `## context-mode \u2014 Session Report (${report.session.uptime_min} min)`,
-    ];
-    // ── Feature 1: Context Window Protection ──
-    lines.push("", `### Context Window Protection`, "");
+    const lines = [];
+    // ── Hero: headline story ──
+    lines.push(`## Think in Code -- Session Report`);
     if (report.savings.total_calls === 0) {
-        lines.push(`No context-mode tool calls yet. Use \`batch_execute\`, \`execute\`, or \`fetch_and_index\` to keep raw output out of your context window.`);
-    }
-    else {
-        lines.push(`| Metric | Value |`, `|--------|------:|`, `| Total data processed | **${kb(report.savings.total_processed)}** |`, `| Kept in sandbox (never entered context) | **${kb(report.savings.kept_out)}** |`, `| Entered context | ${kb(report.savings.total_bytes_returned)} |`, `| Estimated tokens saved | ~${Math.round(report.savings.kept_out / 4).toLocaleString()} |`, `| **Context savings** | **${report.savings.savings_ratio.toFixed(1)}x (${report.savings.pct}% reduction)** |`);
-        // Per-tool breakdown
-        if (report.savings.by_tool.length > 0) {
-            lines.push("", `| Tool | Calls | Context | Tokens |`, `|------|------:|--------:|-------:|`);
-            for (const t of report.savings.by_tool) {
-                lines.push(`| ${t.tool} | ${t.calls} | ${kb(t.calls > 0 ? (t.tokens * 4) : 0)} | ~${t.tokens.toLocaleString()} |`);
-            }
-            lines.push(`| **Total** | **${report.savings.total_calls}** | **${kb(report.savings.total_bytes_returned)}** | **~${Math.round(report.savings.total_bytes_returned / 4).toLocaleString()}** |`);
-        }
-        if (report.savings.kept_out > 0) {
-            lines.push("", `Without context-mode, **${kb(report.savings.total_processed)}** of raw output would flood your context window. Instead, **${report.savings.pct}%** stayed in sandbox.`);
-        }
-        // Cache savings section
-        if (report.cache) {
-            lines.push("", `### TTL Cache`, "", `| Metric | Value |`, `|--------|------:|`, `| Cache hits | **${report.cache.hits}** |`, `| Data avoided by cache | **${kb(report.cache.bytes_saved)}** |`, `| Network requests saved | **${report.cache.hits}** |`, `| TTL remaining | **~${report.cache.ttl_hours_left}h** |`, "", `Content was already indexed in the knowledge base \u2014 ${report.cache.hits} fetch${report.cache.hits > 1 ? "es" : ""} skipped entirely. **${kb(report.cache.bytes_saved)}** of network I/O avoided. Search results served directly from local FTS5 index.`);
-            if (report.cache.total_savings_ratio > report.savings.savings_ratio) {
-                lines.push("", `**Total context savings (sandbox + cache): ${report.cache.total_savings_ratio.toFixed(1)}x** \u2014 ${kb(report.cache.total_with_cache)} processed, only ${kb(report.savings.total_bytes_returned)} entered context.`);
-            }
+        lines.push("", "No sandbox activity yet. Use ctx_execute or ctx_batch_execute to start saving context.", "", "---", "_Display this entire report as-is in your response. Do NOT summarize, collapse, or paraphrase any section._");
+        return lines.join("\n");
+    }
+    const totalProcessed = report.savings.kept_out + (report.cache ? report.cache.bytes_saved : 0);
+    const totalReturned = report.savings.total_bytes_returned;
+    const grandTotal = totalProcessed + totalReturned;
+    const savingsPercent = grandTotal > 0
+        ? ((1 - totalReturned / grandTotal) * 100).toFixed(1)
+        : "0.0";
+    // Rough estimate: 4 bytes per token, ~2 min reading time per 1000 tokens
+    const tokensSaved = Math.round(totalProcessed / 4);
+    const extraMinutes = Math.round((tokensSaved / 1000) * 2);
+    lines.push("", `Your agent processed ${kb(totalProcessed)} of data.`, `Only ${kb(totalReturned)} entered your context window.`, "", `**Context saved: ${savingsPercent}% -- session extended by ~${extraMinutes} minutes**`);
+    // ── What happened ──
+    lines.push("", "### What happened", "");
+    // Count per-tool categories
+    const toolCallMap = new Map();
+    for (const t of report.savings.by_tool) {
+        toolCallMap.set(t.tool, t.calls);
+    }
+    const executeCount = (toolCallMap.get("ctx_execute") ?? 0) +
+        (toolCallMap.get("ctx_execute_file") ?? 0);
+    const batchCount = toolCallMap.get("ctx_batch_execute") ?? 0;
+    const searchCount = toolCallMap.get("ctx_search") ?? 0;
+    const fetchCount = toolCallMap.get("ctx_fetch_and_index") ?? 0;
+    const fileCount = executeCount + batchCount;
+    const networkCount = fetchCount;
+    const cacheCount = report.cache ? report.cache.hits : 0;
+    if (fileCount > 0) {
+        lines.push(`-> ${fileCount} file${fileCount !== 1 ? "s" : ""} analyzed in sandbox (never entered context)`);
+    }
+    if (networkCount > 0) {
+        lines.push(`-> ${networkCount} API call${networkCount !== 1 ? "s" : ""} sandboxed (responses indexed, not dumped)`);
+    }
+    if (searchCount > 0) {
+        lines.push(`-> ${searchCount} search quer${searchCount !== 1 ? "ies" : "y"} served from index`);
+    }
+    if (cacheCount > 0) {
+        lines.push(`-> ${cacheCount} repeat fetch${cacheCount !== 1 ? "es" : ""} avoided (TTL cache)`);
+    }
+    // ── Per-tool breakdown ──
+    const activatedTools = report.savings.by_tool.filter((t) => t.calls > 0);
+    if (activatedTools.length > 0) {
+        lines.push("", "### Per-tool breakdown", "", "| Tool | Calls | Data processed | Context used | Saved |", "|------|------:|---------------:|-------------:|------:|");
+        for (const t of activatedTools) {
+            const processed = t.tokens * 4; // bytes approximation from tokens
+            const contextUsed = t.context_kb * 1024;
+            const savedPct = processed > 0
+                ? (((processed - contextUsed) / processed) *
+                    100).toFixed(0)
+                : "--";
+            lines.push(`| ${t.tool} | ${t.calls} | ${kb(processed)} | ${kb(contextUsed)} | ${savedPct}% |`);
         }
     }
-    // ── Session Continuity ──
+    // ── Session continuity ──
     if (report.continuity.total_events > 0) {
-        lines.push("", "### Session Continuity", "", "| What's preserved | Count | I remember... | Why it matters |", "|------------------|------:|---------------|----------------|");
-        for (const row of report.continuity.by_category) {
-            lines.push(`| ${row.label} | ${row.count} | ${row.preview} | ${row.why} |`);
+        lines.push("", "### Session continuity", "");
+        const parts = [];
+        if (report.continuity.compact_count > 0) {
+            parts.push(`${report.continuity.compact_count} compaction${report.continuity.compact_count !== 1 ? "s" : ""}`);
+        }
+        parts.push(`${report.continuity.total_events} event${report.continuity.total_events !== 1 ? "s" : ""} preserved`);
+        // Count tasks from continuity categories
+        const taskRow = report.continuity.by_category.find((c) => c.category === "task" || c.category === "tasks");
+        if (taskRow && taskRow.count > 0) {
+            parts.push(`${taskRow.count} task${taskRow.count !== 1 ? "s" : ""} tracked`);
         }
-        lines.push(`| **Total** | **${report.continuity.total_events}** | | **Zero knowledge lost on compact** |`);
-        lines.push("");
+        lines.push(parts.join(" | "));
         if (report.continuity.compact_count > 0) {
-            lines.push(`Context has been compacted **${report.continuity.compact_count} time(s)** \u2014 session knowledge was preserved each time.`);
+            lines.push("", `Session knowledge preserved across ${report.continuity.compact_count} compaction${report.continuity.compact_count !== 1 ? "s" : ""} -- zero context lost.`);
         }
         else {
-            lines.push(`When your context compacts, all of this will restore Claude's awareness \u2014 no starting from scratch.`);
+            lines.push("", "When your context compacts, all of this will restore awareness -- no starting from scratch.");
         }
         if (report.continuity.resume_ready) {
-            lines.push(`Resume snapshot ready for the next compaction.`);
+            lines.push("Resume snapshot ready for the next compaction.");
         }
-        lines.push("");
-        lines.push(`> **Note:** Previous session data is loaded when you start a new session. Without \`--continue\`, old session history is cleaned up to keep the database lean.`);
     }
-    // ── Analytics JSON ──
+    // ── Analytics JSON (for power users) ──
     const analyticsJson = {
         session: {
             duration_min: report.session.duration_min,
@@ -702,7 +735,7 @@ export function formatReport(report) {
         continuity: { total_events: report.continuity.total_events },
     };
     lines.push("", "### Analytics (27 metrics)", "", "```json", JSON.stringify(analyticsJson, null, 2), "```");
-    // Formatting directive
-    lines.push("", "---", "_Display this entire report as-is in your response. Do NOT summarize, collapse, or paraphrase any section._");
+    // Footer
+    lines.push("", "---", "context-mode -- github.com/mksglu/context-mode", "", "_Display this entire report as-is in your response. Do NOT summarize, collapse, or paraphrase any section._");
     return lines.join("\n");
 }