context-mode 1.0.97 → 1.0.99

package/configs/codex/AGENTS.md

@@ -46,7 +46,7 @@ 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")`.
+Descriptive source labels for `ctx_search(source: "label")`.
 
 ## ctx commands
 

package/configs/codex/hooks.json

@@ -20,6 +20,20 @@
           { "type": "command", "command": "context-mode hook codex sessionstart" }
         ]
       }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          { "type": "command", "command": "context-mode hook codex userpromptsubmit" }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          { "type": "command", "command": "context-mode hook codex stop" }
+        ]
+      }
     ]
   }
 }

package/configs/kilo/AGENTS.md

@@ -45,7 +45,7 @@ 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")`.
+Descriptive source labels for `ctx_search(source: "label")`.
 
 ## ctx commands
 

package/configs/openclaw/AGENTS.md

@@ -45,7 +45,7 @@ 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")`.
+Descriptive source labels for `ctx_search(source: "label")`.
 
 ## ctx commands
 

package/hooks/codex/stop.mjs

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import "../suppress-stderr.mjs";
+import "../ensure-deps.mjs";
+/**
+ * Codex CLI Stop hook — record turn/session end state for continuity.
+ */
+
+import { readStdin, parseStdin, getSessionId, getSessionDBPath, getInputProjectDir, CODEX_OPTS } from "../session-helpers.mjs";
+import { createSessionLoaders } from "../session-loaders.mjs";
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const HOOK_DIR = dirname(fileURLToPath(import.meta.url));
+const { loadSessionDB } = createSessionLoaders(HOOK_DIR);
+const OPTS = CODEX_OPTS;
+
+try {
+  const raw = await readStdin();
+  const input = parseStdin(raw);
+  const projectDir = getInputProjectDir(input, OPTS);
+
+  const { SessionDB } = await loadSessionDB();
+  const dbPath = getSessionDBPath(OPTS);
+  const db = new SessionDB({ dbPath });
+  const sessionId = getSessionId(input, OPTS);
+
+  db.ensureSession(sessionId, projectDir);
+  db.insertEvent(sessionId, {
+    type: "session_end",
+    status: "completed",
+    stop_hook_active: input.stop_hook_active ?? false,
+    last_assistant_message: typeof input.last_assistant_message === "string"
+      ? input.last_assistant_message.slice(0, 2000)
+      : null,
+  }, "Stop");
+
+  db.close();
+} catch {
+  // Codex hooks must not block the session.
+}
+
+process.stdout.write("{}\n");
+

package/hooks/codex/userpromptsubmit.mjs

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+import "../suppress-stderr.mjs";
+import "../ensure-deps.mjs";
+/**
+ * Codex CLI UserPromptSubmit hook — capture user prompts for continuity.
+ */
+
+import { readStdin, parseStdin, getSessionId, getSessionDBPath, getInputProjectDir, CODEX_OPTS } from "../session-helpers.mjs";
+import { createSessionLoaders, attributeAndInsertEvents } from "../session-loaders.mjs";
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const HOOK_DIR = dirname(fileURLToPath(import.meta.url));
+const { loadSessionDB, loadExtract, loadProjectAttribution } = createSessionLoaders(HOOK_DIR);
+const OPTS = CODEX_OPTS;
+
+try {
+  const raw = await readStdin();
+  const input = parseStdin(raw);
+  const projectDir = getInputProjectDir(input, OPTS);
+
+  const prompt = input.prompt ?? input.message ?? "";
+  const trimmed = (prompt || "").trim();
+
+  const isSystemMessage = trimmed.startsWith("<task-notification>")
+    || trimmed.startsWith("<system-reminder>")
+    || trimmed.startsWith("<context_guidance>")
+    || trimmed.startsWith("<tool-result>");
+
+  if (trimmed.length > 0 && !isSystemMessage) {
+    const { SessionDB } = await loadSessionDB();
+    const { extractUserEvents } = await loadExtract();
+    const { resolveProjectAttributions } = await loadProjectAttribution();
+    const dbPath = getSessionDBPath(OPTS);
+    const db = new SessionDB({ dbPath });
+    const sessionId = getSessionId(input, OPTS);
+
+    db.ensureSession(sessionId, projectDir);
+
+    const promptEvent = {
+      type: "user_prompt",
+      category: "prompt",
+      data: prompt,
+      priority: 1,
+    };
+    const promptAttributions = attributeAndInsertEvents(
+      db, sessionId, [promptEvent], input, projectDir, "UserPromptSubmit", resolveProjectAttributions,
+    );
+
+    const userEvents = extractUserEvents(trimmed);
+    const savedLastKnown = promptAttributions[0]?.projectDir || null;
+    const sessionStats = db.getSessionStats(sessionId);
+    const lastKnownProjectDir = typeof db.getLatestAttributedProjectDir === "function"
+      ? db.getLatestAttributedProjectDir(sessionId)
+      : null;
+    const userAttributions = resolveProjectAttributions(userEvents, {
+      sessionOriginDir: sessionStats?.project_dir || projectDir,
+      inputProjectDir: projectDir,
+      workspaceRoots: Array.isArray(input.workspace_roots) ? input.workspace_roots : [],
+      lastKnownProjectDir: savedLastKnown || lastKnownProjectDir,
+    });
+    for (let i = 0; i < userEvents.length; i++) {
+      db.insertEvent(sessionId, userEvents[i], "UserPromptSubmit", userAttributions[i]);
+    }
+
+    db.close();
+  }
+} catch {
+  // Codex hooks must not block the session.
+}
+
+process.stdout.write(JSON.stringify({
+  hookSpecificOutput: { hookEventName: "UserPromptSubmit", additionalContext: "" },
+}) + "\n");
+

package/hooks/core/mcp-ready.mjs

@@ -1,30 +1,73 @@
 /**
  * MCP readiness sentinel — checks if MCP server has started.
- * Server writes sentinel (containing its PID) after connect(),
- * hooks check before denying tools that redirect to MCP alternatives.
  *
- * Sentinel path: ${tmpdir()}/context-mode-mcp-ready-${process.ppid}
- * Both hooks and MCP server share the same ppid (Claude Code process).
+ * Server writes sentinel (containing its PID) after connect().
+ * Hooks scan for any live sentinel to detect MCP readiness.
+ *
+ * Fix for #347: Claude Code spawns hooks via `bash -c "node ..."` on Linux/WSL2.
+ * The intermediate shell makes process.ppid point to a transient bash PID, not
+ * Claude Code. Directory-scan + PID liveness probe works regardless of spawn topology.
+ *
+ * Sentinel path: <tmpRoot>/context-mode-mcp-ready-<MCP_PID>
+ * Scan: glob all context-mode-mcp-ready-* files, probe each PID.
  */
-import { readFileSync } from "node:fs";
+import { readFileSync, readdirSync, unlinkSync } from "node:fs";
 import { tmpdir } from "node:os";
-import { resolve } from "node:path";
+import { join } from "node:path";
+
+const SENTINEL_PREFIX = "context-mode-mcp-ready-";
+
+/** Resolve the temp root — hardcoded /tmp on Unix to avoid TMPDIR mismatch. */
+export function sentinelDir() {
+  return process.platform === "win32" ? tmpdir() : "/tmp";
+}
+
+/**
+ * Build sentinel path for a given PID.
+ * Used by server.ts to write its own sentinel.
+ */
+export function sentinelPathForPid(pid) {
+  return join(sentinelDir(), `${SENTINEL_PREFIX}${pid}`);
+}
 
-/** Compute the sentinel file path, scoped to session via parent PID. */
+/**
+ * @deprecated Use sentinelPathForPid(process.pid) from server.ts.
+ * Kept for backward compat during migration — tests that still
+ * write sentinels with process.ppid will work for one release cycle.
+ */
 export function sentinelPath() {
-  return resolve(tmpdir(), `context-mode-mcp-ready-${process.ppid}`);
+  return join(sentinelDir(), `${SENTINEL_PREFIX}${process.ppid}`);
 }
 
 /**
- * Check if MCP server is alive by reading sentinel PID and probing it.
- * Handles stale sentinels from crashed servers (SIGKILL, OOM) — if the
- * PID in the sentinel is dead, returns false so hooks allow fallback.
+ * Check if any MCP server is alive by scanning sentinel files.
+ *
+ * Scans sentinelDir() for context-mode-mcp-ready-* files, reads the PID
+ * from each, and probes with kill(pid, 0). Cleans up stale sentinels
+ * from crashed servers.
+ *
+ * Handles:
+ * - PPID mismatch (WSL2 shell wrappers) — no ppid dependency
+ * - Stale sentinels (SIGKILL, OOM) — PID liveness check
+ * - TMPDIR mismatch — hardcoded /tmp on Unix
  */
 export function isMCPReady() {
   try {
-    const pid = parseInt(readFileSync(sentinelPath(), "utf8"), 10);
-    process.kill(pid, 0); // throws if process doesn't exist
-    return true;
+    const dir = sentinelDir();
+    const files = readdirSync(dir).filter(f => f.startsWith(SENTINEL_PREFIX));
+    for (const f of files) {
+      const fullPath = join(dir, f);
+      try {
+        const pid = parseInt(readFileSync(fullPath, "utf8"), 10);
+        if (isNaN(pid)) continue;
+        process.kill(pid, 0); // throws if process doesn't exist
+        return true;
+      } catch {
+        // Dead PID or unreadable — clean up stale sentinel
+        try { unlinkSync(fullPath); } catch {}
+      }
+    }
+    return false;
   } catch {
     return false;
   }

package/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.97",
+  "version": "1.0.99",
   "sandbox": {
     "mode": "permissive",
     "filesystem_access": "full",

package/package.json

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