context-mode 1.0.110 → 1.0.112

package/configs/antigravity/GEMINI.md

@@ -53,9 +53,6 @@ GitHub API rate-limit: cap at 4 for `gh` calls.
 
 ## Output
 
-Terse like caveman. Technical substance exact. Only fluff die.
-Drop: articles, filler (just/really/basically), pleasantries, hedging. Fragments OK. Short synonyms. Code unchanged.
-Pattern: [thing] [action] [reason]. [next step]. Auto-expand for: security warnings, irreversible actions, user confusion.
 Write artifacts to FILES — never inline. Return: file path + 1-line description.
 Descriptive source labels for `search(source: "label")`.
 

package/configs/claude-code/CLAUDE.md

@@ -28,7 +28,7 @@ Otherwise: `ctx_batch_execute(commands, queries)` or `ctx_execute(language: "she
 ### Read (for analysis)
 Reading to **Edit** → Read correct. Reading to **analyze/explore/summarize** → `ctx_execute_file(path, language, code)`.
 
-### Grep (large results)
+### Grep — may flood context
 Use `ctx_execute(language: "shell", code: "grep ...")` in sandbox.
 
 ## Tool selection
@@ -57,9 +57,6 @@ Routing block auto-injected into subagent prompts. Bash-type subagents upgraded
 
 ## Output
 
-Terse like caveman. Technical substance exact. Only fluff die.
-Drop: articles, filler (just/really/basically), pleasantries, hedging. Fragments OK. Short synonyms. Code unchanged.
-Pattern: [thing] [action] [reason]. [next step]. Auto-expand for: security warnings, irreversible actions, user confusion.
 Write artifacts to FILES — never inline. Return: file path + 1-line description.
 Descriptive source labels for `ctx_search(source: "label")`.
 

package/configs/codex/AGENTS.md

@@ -1,6 +1,6 @@
 # context-mode — MANDATORY routing rules
 
-context-mode MCP tools available. Rules protect context window from flooding. One unrouted command dumps 56 KB into context. Codex CLI has NO hooks — these instructions are ONLY enforcement. Follow strictly.
+context-mode MCP tools available. Rules protect context window from flooding. One unrouted command dumps 56 KB into context. Codex CLI hooks provide runtime enforcement when `[features].hooks = true`; these instructions remain mandatory model-side enforcement. Follow strictly.
 
 ## Think in Code — MANDATORY
 
@@ -54,9 +54,6 @@ GitHub API rate-limit: cap at 4 for `gh` calls.
 
 ## Output
 
-Terse like caveman. Technical substance exact. Only fluff die.
-Drop: articles, filler (just/really/basically), pleasantries, hedging. Fragments OK. Short synonyms. Code unchanged.
-Pattern: [thing] [action] [reason]. [next step]. Auto-expand for: security warnings, irreversible actions, user confusion.
 Write artifacts to FILES — never inline. Return: file path + 1-line description.
 Descriptive source labels for `ctx_search(source: "label")`.
 

package/configs/codex/config.toml

@@ -1,5 +1,8 @@
 # Codex CLI — context-mode MCP server configuration
 # Add this to ~/.codex/config.toml
 
+[features]
+hooks = true
+
 [mcp_servers.context-mode]
 command = "context-mode"

package/configs/codex/hooks.json

@@ -2,6 +2,7 @@
   "hooks": {
     "PreToolUse": [
       {
+        "matcher": "local_shell|shell|shell_command|exec_command|container.exec|functions\\.exec_command|Bash|Shell|apply_patch|functions\\.apply_patch|Edit|Write|grep_files|ctx_execute|ctx_execute_file|ctx_batch_execute|ctx_fetch_and_index|ctx_search|ctx_index|mcp__.*__ctx_execute|mcp__.*__ctx_execute_file|mcp__.*__ctx_batch_execute|mcp__.*__ctx_fetch_and_index|mcp__.*__ctx_search|mcp__.*__ctx_index",
         "hooks": [
           { "type": "command", "command": "context-mode hook codex pretooluse" }
         ]
@@ -21,6 +22,13 @@
         ]
       }
     ],
+    "PreCompact": [
+      {
+        "hooks": [
+          { "type": "command", "command": "context-mode hook codex precompact" }
+        ]
+      }
+    ],
     "UserPromptSubmit": [
       {
         "hooks": [

package/configs/cursor/context-mode.mdc

@@ -46,9 +46,6 @@ ALWAYS use native file editing tools to create/modify files. NEVER use `ctx_exec
 
 ## Output
 
-Terse like caveman. Technical substance exact. Only fluff die.
-Drop: articles, filler (just/really/basically), pleasantries, hedging. Fragments OK. Short synonyms. Code unchanged.
-Pattern: [thing] [action] [reason]. [next step]. Auto-expand for: security warnings, irreversible actions, user confusion.
 Write artifacts to FILES — never inline. Return: file path + 1-line description.
 
 ## Session Continuity

package/configs/gemini-cli/GEMINI.md

@@ -53,9 +53,6 @@ GitHub API rate-limit: cap at 4 for `gh` calls.
 
 ## Output
 
-Terse like caveman. Technical substance exact. Only fluff die.
-Drop: articles, filler (just/really/basically), pleasantries, hedging. Fragments OK. Short synonyms. Code unchanged.
-Pattern: [thing] [action] [reason]. [next step]. Auto-expand for: security warnings, irreversible actions, user confusion.
 Write artifacts to FILES — never inline. Return: file path + 1-line description.
 Descriptive source labels for `search(source: "label")`.
 

package/configs/jetbrains-copilot/copilot-instructions.md

@@ -45,9 +45,6 @@ Pass `concurrency: 4-8` to `ctx_batch_execute` and `ctx_fetch_and_index` for net
 
 ## Output
 
-Terse like caveman. Technical substance exact. Only fluff die.
-Drop: articles, filler (just/really/basically), pleasantries, hedging. Fragments OK. Short synonyms. Code unchanged.
-Pattern: [thing] [action] [reason]. [next step]. Auto-expand for: security warnings, irreversible actions, user confusion.
 Write artifacts to FILES — never inline. Return: file path + 1-line description.
 Descriptive source labels for `ctx_search(source: "label")`.
 

package/configs/kilo/AGENTS.md

@@ -53,9 +53,6 @@ GitHub API rate-limit: cap at 4 for `gh` calls.
 
 ## Output
 
-Terse like caveman. Technical substance exact. Only fluff die.
-Drop: articles, filler (just/really/basically), pleasantries, hedging. Fragments OK. Short synonyms. Code unchanged.
-Pattern: [thing] [action] [reason]. [next step]. Auto-expand for: security warnings, irreversible actions, user confusion.
 Write artifacts to FILES — never inline. Return: file path + 1-line description.
 Descriptive source labels for `context-mode_ctx_search(source: "label")`.
 

package/configs/kiro/KIRO.md

@@ -53,9 +53,6 @@ GitHub API rate-limit: cap at 4 for `gh` calls.
 
 ## Output
 
-Terse like caveman. Technical substance exact. Only fluff die.
-Drop: articles, filler (just/really/basically), pleasantries, hedging. Fragments OK. Short synonyms. Code unchanged.
-Pattern: [thing] [action] [reason]. [next step]. Auto-expand for: security warnings, irreversible actions, user confusion.
 Write artifacts to FILES — never inline. Return: file path + 1-line description.
 Descriptive source labels for `search(source: "label")`.
 

package/configs/omp/SYSTEM.md

@@ -0,0 +1,85 @@
+# context-mode — MANDATORY routing rules
+
+context-mode MCP tools available. Rules protect context window from flooding. One unrouted command dumps 56 KB into context. context-mode delivers via MCP for OMP; native OMP `pre`/`post` tool-call hooks are not yet wired by this adapter, so these rules are the only enforcement path. Treat them as MUST.
+
+## Think in Code — MANDATORY
+
+Analyze/count/filter/compare/search/parse/transform data: **write code** via `ctx_execute(language, code)`, `console.log()` only the answer. Do NOT read raw data into context. PROGRAM the analysis, not COMPUTE it. Pure JavaScript — Node.js built-ins only (`fs`, `path`, `child_process`). `try/catch`, handle `null`/`undefined`. One script replaces ten tool calls.
+
+## BLOCKED — do NOT use
+
+### curl / wget — FORBIDDEN
+Dumps raw HTTP into context. No hook fallback for OMP today; rule-only enforcement.
+Use: `ctx_fetch_and_index(url, source)` or `ctx_execute(language: "javascript", code: "const r = await fetch(...)")`
+
+### Inline HTTP — FORBIDDEN
+No `node -e "fetch(..."`, `python -c "requests.get(..."`. Bypasses sandbox.
+Use: `ctx_execute(language, code)` — only stdout enters context
+
+### Direct web fetching — FORBIDDEN
+Raw HTML can exceed 100 KB.
+Use: `ctx_fetch_and_index(url, source)` then `ctx_search(queries)`
+
+## REDIRECTED — use sandbox
+
+### shell (>20 lines output)
+`shell` ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`.
+Otherwise: `ctx_batch_execute(commands, queries)` or `ctx_execute(language: "shell", code: "...")`
+
+### read (for analysis)
+Reading to **edit** → `read` correct. Reading to **analyze/explore/summarize** → `ctx_execute_file(path, language, code)`.
+
+### grep / find (large results)
+Use `ctx_execute(language: "shell", code: "grep ...")` in sandbox.
+
+## Tool selection
+
+0. **MEMORY**: `ctx_search(sort: "timeline")` — after resume, check prior context before asking user.
+1. **GATHER**: `ctx_batch_execute(commands, queries)` — runs all commands, auto-indexes, returns search. ONE call replaces 30+. Each command: `{label: "header", command: "..."}`.
+2. **FOLLOW-UP**: `ctx_search(queries: ["q1", "q2", ...])` — all questions as array, ONE call (default relevance mode).
+3. **PROCESSING**: `ctx_execute(language, code)` | `ctx_execute_file(path, language, code)` — sandbox, only stdout enters context.
+4. **WEB**: `ctx_fetch_and_index(url, source)` then `ctx_search(queries)` — raw HTML never enters context.
+5. **INDEX**: `ctx_index(content, source)` — store in FTS5 for later search.
+
+## Parallel I/O batches
+
+For multi-URL fetches or multi-API calls, **always** include `concurrency: N` (1-8):
+
+- `ctx_batch_execute(commands: [3+ network commands], concurrency: 5)` — gh, curl, dig, docker inspect, multi-region cloud queries
+- `ctx_fetch_and_index(requests: [{url, source}, ...], concurrency: 5)` — multi-URL batch fetch
+
+**Use concurrency 4-8** for I/O-bound work (network calls, API queries). **Keep concurrency 1** for CPU-bound (npm test, build, lint) or commands sharing state (ports, lock files, same-repo writes).
+
+GitHub API rate-limit: cap at 4 for `gh` calls.
+
+## Output
+
+Write artifacts to FILES — never inline. Return: file path + 1-line description.
+Descriptive source labels for `search(source: "label")`.
+
+## Session Continuity
+
+Skills, roles, and decisions persist for the entire session. Do not abandon them as the conversation grows.
+
+## Memory
+
+Session history is persistent and searchable. On resume, search BEFORE asking the user:
+
+| Need | Command |
+|------|---------|
+| What did we decide? | `ctx_search(queries: ["decision"], source: "decision", sort: "timeline")` |
+| What constraints exist? | `ctx_search(queries: ["constraint"], source: "constraint")` |
+
+DO NOT ask "what were we working on?" — SEARCH FIRST.
+If search returns 0 results, proceed as a fresh session.
+
+## ctx commands
+
+| Command | Action |
+|---------|--------|
+| `ctx stats` | Call `stats` MCP tool, display full output verbatim |
+| `ctx doctor` | Call `doctor` MCP tool, run returned shell command, display as checklist |
+| `ctx upgrade` | Call `upgrade` MCP tool, run returned shell command, display as checklist |
+| `ctx purge` | Call `purge` MCP tool with confirm: true. Warns before wiping knowledge base. |
+
+After /clear or /compact: knowledge base and session stats preserved. Use `ctx purge` to start fresh.

package/configs/omp/mcp.json

@@ -0,0 +1,7 @@
+{
+  "mcpServers": {
+    "context-mode": {
+      "command": "context-mode"
+    }
+  }
+}

package/configs/openclaw/AGENTS.md

@@ -53,9 +53,6 @@ GitHub API rate-limit: cap at 4 for `gh` calls.
 
 ## Output
 
-Terse like caveman. Technical substance exact. Only fluff die.
-Drop: articles, filler (just/really/basically), pleasantries, hedging. Fragments OK. Short synonyms. Code unchanged.
-Pattern: [thing] [action] [reason]. [next step]. Auto-expand for: security warnings, irreversible actions, user confusion.
 Write artifacts to FILES — never inline. Return: file path + 1-line description.
 Descriptive source labels for `context-mode__ctx_search(source: "label")`.
 

package/configs/opencode/AGENTS.md

@@ -53,9 +53,6 @@ GitHub API rate-limit: cap at 4 for `gh` calls.
 
 ## Output
 
-Terse like caveman. Technical substance exact. Only fluff die.
-Drop: articles, filler (just/really/basically), pleasantries, hedging. Fragments OK. Short synonyms. Code unchanged.
-Pattern: [thing] [action] [reason]. [next step]. Auto-expand for: security warnings, irreversible actions, user confusion.
 Write artifacts to FILES — never inline. Return: file path + 1-line description.
 Descriptive source labels for `search(source: "label")`.
 

package/configs/pi/AGENTS.md

@@ -54,9 +54,6 @@ GitHub API rate-limit: cap at 4 for `gh` calls.
 
 ## Output
 
-Terse like caveman. Technical substance exact. Only fluff die.
-Drop: articles, filler (just/really/basically), pleasantries, hedging. Fragments OK. Short synonyms. Code unchanged.
-Pattern: [thing] [action] [reason]. [next step]. Auto-expand for: security warnings, irreversible actions, user confusion.
 Write artifacts to FILES — never inline. Return: file path + 1-line description.
 Descriptive source labels for `search(source: "label")`.
 

package/configs/qwen-code/QWEN.md

@@ -28,7 +28,7 @@ Otherwise: `mcp__context-mode__ctx_batch_execute(commands, queries)` or `mcp__co
 ### Read (for analysis)
 Reading to **Edit** → Read correct. Reading to **analyze/explore/summarize** → `mcp__context-mode__ctx_execute_file(path, language, code)`.
 
-### Grep (large results)
+### Grep — may flood context
 Use `mcp__context-mode__ctx_execute(language: "shell", code: "grep ...")` in sandbox.
 
 ## Tool selection
@@ -57,9 +57,6 @@ Routing block auto-injected into subagent prompts. Bash-type subagents upgraded
 
 ## Output
 
-Terse like caveman. Technical substance exact. Only fluff die.
-Drop: articles, filler (just/really/basically), pleasantries, hedging. Fragments OK. Short synonyms. Code unchanged.
-Pattern: [thing] [action] [reason]. [next step]. Auto-expand for: security warnings, irreversible actions, user confusion.
 Write artifacts to FILES — never inline. Return: file path + 1-line description.
 Descriptive source labels for `mcp__context-mode__ctx_search(source: "label")`.
 

package/configs/vscode-copilot/copilot-instructions.md

@@ -45,9 +45,6 @@ Pass `concurrency: 4-8` to `ctx_batch_execute` and `ctx_fetch_and_index` for net
 
 ## Output
 
-Terse like caveman. Technical substance exact. Only fluff die.
-Drop: articles, filler (just/really/basically), pleasantries, hedging. Fragments OK. Short synonyms. Code unchanged.
-Pattern: [thing] [action] [reason]. [next step]. Auto-expand for: security warnings, irreversible actions, user confusion.
 Write artifacts to FILES — never inline. Return: file path + 1-line description.
 Descriptive source labels for `ctx_search(source: "label")`.
 

package/configs/zed/AGENTS.md

@@ -53,9 +53,6 @@ GitHub API rate-limit: cap at 4 for `gh` calls.
 
 ## Output
 
-Terse like caveman. Technical substance exact. Only fluff die.
-Drop: articles, filler (just/really/basically), pleasantries, hedging. Fragments OK. Short synonyms. Code unchanged.
-Pattern: [thing] [action] [reason]. [next step]. Auto-expand for: security warnings, irreversible actions, user confusion.
 Write artifacts to FILES — never inline. Return: file path + 1-line description.
 Descriptive source labels for `search(source: "label")`.
 

package/hooks/codex/posttooluse.mjs

@@ -15,7 +15,8 @@ const { loadSessionDB, loadExtract, loadProjectAttribution } = createSessionLoad
 const OPTS = CODEX_OPTS;
 
 function normalizeToolName(toolName) {
-  // Codex CLI tool_name is always "Bash" (single tool type)
+  // Keep Codex-native tool names like apply_patch intact; only normalize
+  // legacy shell aliases that should route through the Bash extractors.
   if (toolName === "Shell") return "Bash";
   return toolName;
 }
@@ -29,7 +30,7 @@ try {
   const { resolveProjectAttributions } = await loadProjectAttribution();
   const { SessionDB } = await loadSessionDB();
 
-  const dbPath = getSessionDBPath(OPTS);
+  const dbPath = getSessionDBPath(OPTS, projectDir);
   const db = new SessionDB({ dbPath });
   const sessionId = getSessionId(input, OPTS);
 
@@ -41,6 +42,12 @@ try {
     tool_response: typeof input.tool_response === "string"
       ? input.tool_response
       : JSON.stringify(input.tool_response ?? ""),
+    tool_output: input.tool_output
+      ? {
+        ...input.tool_output,
+        isError: input.tool_output.isError === true || input.tool_output.is_error === true,
+      }
+      : undefined,
   };
 
   const events = extractEvents(normalizedInput);

package/hooks/codex/precompact.mjs

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+import "../suppress-stderr.mjs";
+import "../ensure-deps.mjs";
+/**
+ * Codex CLI PreCompact hook - snapshot generation.
+ */
+
+import {
+  readStdin,
+  parseStdin,
+  getSessionId,
+  getSessionDBPath,
+  getInputProjectDir,
+  resolveConfigDir,
+  CODEX_OPTS,
+} from "../session-helpers.mjs";
+import { createSessionLoaders } from "../session-loaders.mjs";
+import { appendFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const HOOK_DIR = dirname(fileURLToPath(import.meta.url));
+const { loadSessionDB, loadSnapshot } = createSessionLoaders(HOOK_DIR);
+const OPTS = CODEX_OPTS;
+const DEBUG_LOG = join(resolveConfigDir(OPTS), "context-mode", "precompact-debug.log");
+
+try {
+  const raw = await readStdin();
+  const input = parseStdin(raw);
+  const projectDir = getInputProjectDir(input, OPTS);
+
+  const { buildResumeSnapshot } = await loadSnapshot();
+  const { SessionDB } = await loadSessionDB();
+
+  const dbPath = getSessionDBPath(OPTS, projectDir);
+  const db = new SessionDB({ dbPath });
+  const sessionId = getSessionId(input, OPTS);
+
+  const events = db.getEvents(sessionId);
+
+  if (events.length > 0) {
+    const stats = db.getSessionStats(sessionId);
+    const snapshot = buildResumeSnapshot(events, {
+      compactCount: (stats?.compact_count ?? 0) + 1,
+    });
+
+    db.upsertResume(sessionId, snapshot, events.length);
+    db.incrementCompactCount(sessionId);
+
+    const fileEvents = events.filter((event) => event.category === "file");
+    db.insertEvent(sessionId, {
+      type: "compaction_summary",
+      category: "compaction",
+      data: `Session compacted. ${events.length} events, ${fileEvents.length} files touched.`,
+      priority: 1,
+    }, "PreCompact");
+  }
+
+  db.close();
+} catch (err) {
+  try {
+    appendFileSync(DEBUG_LOG, `[${new Date().toISOString()}] ${err?.message || err}\n`);
+  } catch {
+    // Hook errors must not break Codex compaction.
+  }
+}
+
+// Codex PreCompact accepts universal hook fields only; no hookSpecificOutput.
+process.stdout.write(JSON.stringify({}) + "\n");

package/hooks/codex/sessionstart.mjs

@@ -43,17 +43,18 @@ try {
 
   if (source === "compact" || source === "resume") {
     const { SessionDB } = await loadSessionDB();
-    const dbPath = getSessionDBPath(OPTS);
+    const dbPath = getSessionDBPath(OPTS, projectDir);
     const db = new SessionDB({ dbPath });
+    const sessionId = getSessionId(input, OPTS);
+    let resumeSnapshot = null;
 
     if (source === "compact") {
-      const sessionId = getSessionId(input, OPTS);
-      const resume = db.getResume(sessionId);
+      const resume = sessionId ? db.getResume(sessionId) : null;
       if (resume && !resume.consumed) {
-        db.markResumeConsumed(sessionId);
+        resumeSnapshot = resume.snapshot;
       }
     } else {
-      try { unlinkSync(getCleanupFlagPath(OPTS)); } catch { /* no flag */ }
+      try { unlinkSync(getCleanupFlagPath(OPTS, projectDir)); } catch { /* no flag */ }
     }
 
     // Filter events to the session being resumed/compacted. Falling back to
@@ -61,19 +62,22 @@ try {
     // session whose session_meta.started_at is more recent — observed
     // cross-session bleed when a different session started after this one
     // and before the resume.
-    const sessionId = getSessionId(input, OPTS);
     const events = sessionId ? getSessionEvents(db, sessionId) : [];
     if (events.length > 0) {
-      const eventMeta = writeSessionEventsFile(events, getSessionEventsPath(OPTS));
+      const eventMeta = writeSessionEventsFile(events, getSessionEventsPath(OPTS, projectDir));
       additionalContext += buildSessionDirective(source, eventMeta, toolNamer);
     }
+    if (resumeSnapshot) {
+      additionalContext += `\n\n${resumeSnapshot}`;
+      db.markResumeConsumed(sessionId);
+    }
 
     db.close();
   } else if (source === "startup") {
     const { SessionDB } = await loadSessionDB();
-    const dbPath = getSessionDBPath(OPTS);
+    const dbPath = getSessionDBPath(OPTS, projectDir);
     const db = new SessionDB({ dbPath });
-    try { unlinkSync(getSessionEventsPath(OPTS)); } catch { /* no stale file */ }
+    try { unlinkSync(getSessionEventsPath(OPTS, projectDir)); } catch { /* no stale file */ }
 
     db.cleanupOldSessions(7);
     db.db.exec(`DELETE FROM session_events WHERE session_id NOT IN (SELECT session_id FROM session_meta)`);

package/hooks/codex/stop.mjs

@@ -20,7 +20,7 @@ try {
   const projectDir = getInputProjectDir(input, OPTS);
 
   const { SessionDB } = await loadSessionDB();
-  const dbPath = getSessionDBPath(OPTS);
+  const dbPath = getSessionDBPath(OPTS, projectDir);
   const db = new SessionDB({ dbPath });
   const sessionId = getSessionId(input, OPTS);
 
@@ -40,4 +40,3 @@ try {
 }
 
 process.stdout.write("{}\n");
-

package/hooks/codex/userpromptsubmit.mjs

@@ -31,7 +31,7 @@ try {
     const { SessionDB } = await loadSessionDB();
     const { extractUserEvents } = await loadExtract();
     const { resolveProjectAttributions } = await loadProjectAttribution();
-    const dbPath = getSessionDBPath(OPTS);
+    const dbPath = getSessionDBPath(OPTS, projectDir);
     const db = new SessionDB({ dbPath });
     const sessionId = getSessionId(input, OPTS);
 
@@ -72,4 +72,3 @@ try {
 process.stdout.write(JSON.stringify({
   hookSpecificOutput: { hookEventName: "UserPromptSubmit", additionalContext: "" },
 }) + "\n");
-