@contextstream/mcp-server 0.4.46 → 0.4.47

package/dist/index.js

@@ -38,181 +38,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// src/version.ts
-import { createRequire } from "module";
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
-import { homedir } from "os";
-import { join } from "path";
-function getVersion() {
-  try {
-    const require2 = createRequire(import.meta.url);
-    const pkg = require2("../package.json");
-    const version = pkg?.version;
-    if (typeof version === "string" && version.trim()) return version.trim();
-  } catch {
-  }
-  return "unknown";
-}
-function compareVersions(v1, v2) {
-  const parts1 = v1.split(".").map(Number);
-  const parts2 = v2.split(".").map(Number);
-  for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
-    const p1 = parts1[i] ?? 0;
-    const p2 = parts2[i] ?? 0;
-    if (p1 < p2) return -1;
-    if (p1 > p2) return 1;
-  }
-  return 0;
-}
-function getCacheFilePath() {
-  return join(homedir(), ".contextstream", "version-cache.json");
-}
-function readCache() {
-  try {
-    const cacheFile = getCacheFilePath();
-    if (!existsSync(cacheFile)) return null;
-    const data = JSON.parse(readFileSync(cacheFile, "utf-8"));
-    if (Date.now() - data.checkedAt > CACHE_TTL_MS) return null;
-    return data;
-  } catch {
-    return null;
-  }
-}
-function writeCache(latestVersion) {
-  try {
-    const configDir = join(homedir(), ".contextstream");
-    if (!existsSync(configDir)) {
-      mkdirSync(configDir, { recursive: true });
-    }
-    const cacheFile = getCacheFilePath();
-    writeFileSync(
-      cacheFile,
-      JSON.stringify({
-        latestVersion,
-        checkedAt: Date.now()
-      })
-    );
-  } catch {
-  }
-}
-async function fetchLatestVersion() {
-  try {
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), 5e3);
-    const response = await fetch(NPM_LATEST_URL, {
-      signal: controller.signal,
-      headers: { Accept: "application/json" }
-    });
-    clearTimeout(timeout);
-    if (!response.ok) return null;
-    const data = await response.json();
-    return typeof data.version === "string" ? data.version : null;
-  } catch {
-    return null;
-  }
-}
-async function resolveLatestVersion() {
-  const cached = readCache();
-  if (cached) return cached.latestVersion;
-  if (!latestVersionPromise) {
-    latestVersionPromise = fetchLatestVersion().finally(() => {
-      latestVersionPromise = null;
-    });
-  }
-  const latestVersion = await latestVersionPromise;
-  if (latestVersion) {
-    writeCache(latestVersion);
-  }
-  return latestVersion;
-}
-async function checkForUpdates() {
-  const notice = await getUpdateNotice();
-  if (notice?.behind) {
-    showUpdateWarning(notice.current, notice.latest);
-  }
-}
-function showUpdateWarning(currentVersion, latestVersion) {
-  console.error("");
-  console.error("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
-  console.error(`\u26A0\uFE0F  Update available: v${currentVersion} \u2192 v${latestVersion}`);
-  console.error("");
-  console.error(`   Run: ${UPGRADE_COMMAND}`);
-  console.error("");
-  console.error("   Then restart your AI tool to use the new version.");
-  console.error("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
-  console.error("");
-}
-async function getUpdateNotice() {
-  const currentVersion = VERSION;
-  if (currentVersion === "unknown") return null;
-  try {
-    const latestVersion = await resolveLatestVersion();
-    if (!latestVersion) return null;
-    if (compareVersions(currentVersion, latestVersion) < 0) {
-      return {
-        current: currentVersion,
-        latest: latestVersion,
-        behind: true,
-        upgrade_command: UPGRADE_COMMAND
-      };
-    }
-  } catch {
-  }
-  return null;
-}
-function getVersionsBehind(current, latest) {
-  try {
-    const currentParts = current.split(".").map(Number);
-    const latestParts = latest.split(".").map(Number);
-    if ((latestParts[0] ?? 0) > (currentParts[0] ?? 0)) {
-      return 10 + ((latestParts[1] ?? 0) - (currentParts[1] ?? 0));
-    }
-    const minorDiff = (latestParts[1] ?? 0) - (currentParts[1] ?? 0);
-    const patchDiff = (latestParts[2] ?? 0) - (currentParts[2] ?? 0);
-    if (minorDiff > 0) {
-      return minorDiff;
-    } else if (minorDiff === 0 && patchDiff > 0) {
-      return 1;
-    }
-    return 0;
-  } catch {
-    return 0;
-  }
-}
-function getVersionWarning(notice) {
-  if (!notice?.behind) return null;
-  const versionsBehind = getVersionsBehind(notice.current, notice.latest);
-  if (versionsBehind >= 3) {
-    return `[VERSION_CRITICAL] MCP server is ${versionsBehind} versions behind (${notice.current} \u2192 ${notice.latest}). Update immediately: ${notice.upgrade_command}`;
-  } else if (versionsBehind >= 1) {
-    return `[VERSION_NOTICE] MCP server update available (${notice.current} \u2192 ${notice.latest}). Run: ${notice.upgrade_command}`;
-  }
-  return null;
-}
-function getVersionInstructions(notice) {
-  if (!notice?.behind) return null;
-  const versionsBehind = getVersionsBehind(notice.current, notice.latest);
-  if (versionsBehind >= 5) {
-    return `\u26A0\uFE0F CRITICAL: User's MCP is ${versionsBehind} versions behind. Mention update in EVERY response until updated.`;
-  } else if (versionsBehind >= 3) {
-    return `\u26A0\uFE0F User's MCP is ${versionsBehind} versions behind. Remind about update every 2-3 messages.`;
-  } else if (versionsBehind >= 1) {
-    return `Note: MCP update available (${notice.current}\u2192${notice.latest}). Mention once at session start.`;
-  }
-  return null;
-}
-var UPGRADE_COMMAND, NPM_LATEST_URL, VERSION, CACHE_TTL_MS, latestVersionPromise;
-var init_version = __esm({
-  "src/version.ts"() {
-    "use strict";
-    UPGRADE_COMMAND = "npm install -g @contextstream/mcp-server@latest";
-    NPM_LATEST_URL = "https://registry.npmjs.org/@contextstream/mcp-server/latest";
-    VERSION = getVersion();
-    CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
-    latestVersionPromise = null;
-  }
-});
-
 // node_modules/ignore/index.js
 var require_ignore = __commonJS({
   "node_modules/ignore/index.js"(exports, module) {
@@ -670,776 +495,1489 @@ var require_ignore = __commonJS({
   }
 });
 
-// src/rules-templates.ts
-var rules_templates_exports = {};
-__export(rules_templates_exports, {
-  RULES_VERSION: () => RULES_VERSION,
-  TEMPLATES: () => TEMPLATES,
-  generateAllRuleFiles: () => generateAllRuleFiles,
-  generateRuleContent: () => generateRuleContent,
-  getAvailableEditors: () => getAvailableEditors,
-  getTemplate: () => getTemplate
+// src/hooks-config.ts
+var hooks_config_exports = {};
+__export(hooks_config_exports, {
+  CLINE_POSTTOOLUSE_HOOK_SCRIPT: () => CLINE_POSTTOOLUSE_HOOK_SCRIPT,
+  CLINE_PRETOOLUSE_HOOK_SCRIPT: () => CLINE_PRETOOLUSE_HOOK_SCRIPT,
+  CLINE_USER_PROMPT_HOOK_SCRIPT: () => CLINE_USER_PROMPT_HOOK_SCRIPT,
+  CURSOR_BEFORE_SUBMIT_HOOK_SCRIPT: () => CURSOR_BEFORE_SUBMIT_HOOK_SCRIPT,
+  CURSOR_PRETOOLUSE_HOOK_SCRIPT: () => CURSOR_PRETOOLUSE_HOOK_SCRIPT,
+  MEDIA_AWARE_HOOK_SCRIPT: () => MEDIA_AWARE_HOOK_SCRIPT,
+  PRECOMPACT_HOOK_SCRIPT: () => PRECOMPACT_HOOK_SCRIPT,
+  PRETOOLUSE_HOOK_SCRIPT: () => PRETOOLUSE_HOOK_SCRIPT,
+  USER_PROMPT_HOOK_SCRIPT: () => USER_PROMPT_HOOK_SCRIPT,
+  buildHooksConfig: () => buildHooksConfig,
+  generateAllHooksDocumentation: () => generateAllHooksDocumentation,
+  generateHooksDocumentation: () => generateHooksDocumentation,
+  getClaudeSettingsPath: () => getClaudeSettingsPath,
+  getClineHooksDir: () => getClineHooksDir,
+  getCursorHooksConfigPath: () => getCursorHooksConfigPath,
+  getCursorHooksDir: () => getCursorHooksDir,
+  getHooksDir: () => getHooksDir,
+  getIndexStatusPath: () => getIndexStatusPath,
+  getKiloCodeHooksDir: () => getKiloCodeHooksDir,
+  getRooCodeHooksDir: () => getRooCodeHooksDir,
+  installAllEditorHooks: () => installAllEditorHooks,
+  installClaudeCodeHooks: () => installClaudeCodeHooks,
+  installClineHookScripts: () => installClineHookScripts,
+  installCursorHookScripts: () => installCursorHookScripts,
+  installEditorHooks: () => installEditorHooks,
+  installHookScripts: () => installHookScripts,
+  installKiloCodeHookScripts: () => installKiloCodeHookScripts,
+  installRooCodeHookScripts: () => installRooCodeHookScripts,
+  markProjectIndexed: () => markProjectIndexed,
+  mergeHooksIntoSettings: () => mergeHooksIntoSettings,
+  readClaudeSettings: () => readClaudeSettings,
+  readCursorHooksConfig: () => readCursorHooksConfig,
+  readIndexStatus: () => readIndexStatus,
+  unmarkProjectIndexed: () => unmarkProjectIndexed,
+  writeClaudeSettings: () => writeClaudeSettings,
+  writeCursorHooksConfig: () => writeCursorHooksConfig,
+  writeIndexStatus: () => writeIndexStatus
 });
-function applyMcpToolPrefix(markdown, toolPrefix) {
-  const toolPattern = CONTEXTSTREAM_TOOL_NAMES.join("|");
-  const toolRegex = new RegExp(`(?<!__)\\b(${toolPattern})\\b(?=\\s*\\()`, "g");
-  return markdown.replace(toolRegex, `${toolPrefix}$1`);
-}
-function getAvailableEditors() {
-  return Object.keys(TEMPLATES);
-}
-function getTemplate(editor) {
-  return TEMPLATES[editor.toLowerCase()] || null;
-}
-function generateRuleContent(editor, options) {
-  const template = getTemplate(editor);
-  if (!template) return null;
-  const mode = options?.mode || "dynamic";
-  const rules = mode === "full" ? CONTEXTSTREAM_RULES_FULL : mode === "minimal" ? CONTEXTSTREAM_RULES_MINIMAL : CONTEXTSTREAM_RULES_DYNAMIC;
-  let content = template.build(rules);
-  if (options?.workspaceName || options?.projectName) {
-    const header = `
-# Workspace: ${options.workspaceName || "Unknown"}
-${options.projectName ? `# Project: ${options.projectName}` : ""}
-${options.workspaceId ? `# Workspace ID: ${options.workspaceId}` : ""}
-
-`;
-    content = header + content;
-  }
-  if (options?.additionalRules) {
-    content += "\n\n## Project-Specific Rules\n\n" + options.additionalRules;
+import * as fs4 from "node:fs/promises";
+import * as path5 from "node:path";
+import { homedir as homedir2 } from "node:os";
+function getClaudeSettingsPath(scope, projectPath) {
+  if (scope === "user") {
+    return path5.join(homedir2(), ".claude", "settings.json");
   }
-  if (editor.toLowerCase() === "claude") {
-    content = applyMcpToolPrefix(content, `mcp__${DEFAULT_CLAUDE_MCP_SERVER_NAME}__`);
+  if (!projectPath) {
+    throw new Error("projectPath required for project scope");
   }
-  return {
-    filename: template.filename,
-    content: content.trim() + "\n"
-  };
+  return path5.join(projectPath, ".claude", "settings.json");
 }
-function generateAllRuleFiles(options) {
-  return getAvailableEditors().map((editor) => {
-    const result = generateRuleContent(editor, options);
-    if (!result) return null;
-    return { editor, ...result };
-  }).filter((r) => r !== null);
+function getHooksDir() {
+  return path5.join(homedir2(), ".claude", "hooks");
+}
+function buildHooksConfig(options) {
+  const userPromptHooks = [
+    {
+      matcher: "*",
+      hooks: [
+        {
+          type: "command",
+          command: "npx @contextstream/mcp-server hook user-prompt-submit",
+          timeout: 5
+        }
+      ]
+    }
+  ];
+  if (options?.includeMediaAware !== false) {
+    userPromptHooks.push({
+      matcher: "*",
+      hooks: [
+        {
+          type: "command",
+          command: "npx @contextstream/mcp-server hook media-aware",
+          timeout: 5
+        }
+      ]
+    });
+  }
+  const config = {
+    PreToolUse: [
+      {
+        matcher: "Glob|Grep|Search|Task|EnterPlanMode",
+        hooks: [
+          {
+            type: "command",
+            command: "npx @contextstream/mcp-server hook pre-tool-use",
+            timeout: 5
+          }
+        ]
+      }
+    ],
+    UserPromptSubmit: userPromptHooks
+  };
+  if (options?.includePreCompact) {
+    config.PreCompact = [
+      {
+        // Match both manual (/compact) and automatic compaction
+        matcher: "*",
+        hooks: [
+          {
+            type: "command",
+            command: "npx @contextstream/mcp-server hook pre-compact",
+            timeout: 10
+          }
+        ]
+      }
+    ];
+  }
+  const postToolUseHooks = [];
+  if (options?.includePostWrite !== false) {
+    postToolUseHooks.push({
+      matcher: "Edit|Write|NotebookEdit",
+      hooks: [
+        {
+          type: "command",
+          command: "npx @contextstream/mcp-server hook post-write",
+          timeout: 10
+        }
+      ]
+    });
+  }
+  if (options?.includeAutoRules !== false) {
+    postToolUseHooks.push({
+      matcher: "mcp__contextstream__init|mcp__contextstream__context",
+      hooks: [
+        {
+          type: "command",
+          command: "npx @contextstream/mcp-server hook auto-rules",
+          timeout: 15
+        }
+      ]
+    });
+  }
+  if (postToolUseHooks.length > 0) {
+    config.PostToolUse = postToolUseHooks;
+  }
+  return config;
+}
+async function installHookScripts(options) {
+  const hooksDir = getHooksDir();
+  await fs4.mkdir(hooksDir, { recursive: true });
+  const result = {
+    preToolUse: "npx @contextstream/mcp-server hook pre-tool-use",
+    userPrompt: "npx @contextstream/mcp-server hook user-prompt-submit"
+  };
+  if (options?.includePreCompact) {
+    result.preCompact = "npx @contextstream/mcp-server hook pre-compact";
+  }
+  if (options?.includeMediaAware !== false) {
+    result.mediaAware = "npx @contextstream/mcp-server hook media-aware";
+  }
+  if (options?.includeAutoRules !== false) {
+    result.autoRules = "npx @contextstream/mcp-server hook auto-rules";
+  }
+  return result;
+}
+async function readClaudeSettings(scope, projectPath) {
+  const settingsPath = getClaudeSettingsPath(scope, projectPath);
+  try {
+    const content = await fs4.readFile(settingsPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return {};
+  }
+}
+async function writeClaudeSettings(settings, scope, projectPath) {
+  const settingsPath = getClaudeSettingsPath(scope, projectPath);
+  const dir = path5.dirname(settingsPath);
+  await fs4.mkdir(dir, { recursive: true });
+  await fs4.writeFile(settingsPath, JSON.stringify(settings, null, 2));
+}
+function mergeHooksIntoSettings(existingSettings, newHooks) {
+  const settings = { ...existingSettings };
+  const existingHooks = settings.hooks || {};
+  for (const [hookType, matchers] of Object.entries(newHooks || {})) {
+    if (!matchers) continue;
+    const existing = existingHooks?.[hookType] || [];
+    const filtered = existing.filter((m) => {
+      return !m.hooks?.some((h) => h.command?.includes("contextstream"));
+    });
+    existingHooks[hookType] = [...filtered, ...matchers];
+  }
+  settings.hooks = existingHooks;
+  return settings;
+}
+async function installClaudeCodeHooks(options) {
+  const result = { scripts: [], settings: [] };
+  result.scripts.push(
+    "npx @contextstream/mcp-server hook pre-tool-use",
+    "npx @contextstream/mcp-server hook user-prompt-submit"
+  );
+  if (options.includePreCompact) {
+    result.scripts.push("npx @contextstream/mcp-server hook pre-compact");
+  }
+  if (options.includeMediaAware !== false) {
+    result.scripts.push("npx @contextstream/mcp-server hook media-aware");
+  }
+  if (options.includePostWrite !== false) {
+    result.scripts.push("npx @contextstream/mcp-server hook post-write");
+  }
+  if (options.includeAutoRules !== false) {
+    result.scripts.push("npx @contextstream/mcp-server hook auto-rules");
+  }
+  const hooksConfig = buildHooksConfig({
+    includePreCompact: options.includePreCompact,
+    includeMediaAware: options.includeMediaAware,
+    includePostWrite: options.includePostWrite,
+    includeAutoRules: options.includeAutoRules
+  });
+  if (options.scope === "user" || options.scope === "both") {
+    const settingsPath = getClaudeSettingsPath("user");
+    if (!options.dryRun) {
+      const existing = await readClaudeSettings("user");
+      const merged = mergeHooksIntoSettings(existing, hooksConfig);
+      await writeClaudeSettings(merged, "user");
+    }
+    result.settings.push(settingsPath);
+  }
+  if ((options.scope === "project" || options.scope === "both") && options.projectPath) {
+    const settingsPath = getClaudeSettingsPath("project", options.projectPath);
+    if (!options.dryRun) {
+      const existing = await readClaudeSettings("project", options.projectPath);
+      const merged = mergeHooksIntoSettings(existing, hooksConfig);
+      await writeClaudeSettings(merged, "project", options.projectPath);
+    }
+    result.settings.push(settingsPath);
+  }
+  return result;
+}
+function generateHooksDocumentation() {
+  return `
+## Claude Code Hooks (ContextStream)
+
+ContextStream installs hooks to enforce ContextStream-first behavior.
+All hooks run via Node.js - no Python dependency required.
+
+### PreToolUse Hook
+- **Command:** \`npx @contextstream/mcp-server hook pre-tool-use\`
+- **Purpose:** Blocks Glob/Grep/Search/EnterPlanMode and redirects to ContextStream
+- **Blocked tools:** Glob, Grep, Search, Task(Explore), Task(Plan), EnterPlanMode
+- **Disable:** Set \`CONTEXTSTREAM_HOOK_ENABLED=false\` environment variable
+
+### UserPromptSubmit Hook
+- **Command:** \`npx @contextstream/mcp-server hook user-prompt-submit\`
+- **Purpose:** Injects a reminder about ContextStream rules on every message
+- **Disable:** Set \`CONTEXTSTREAM_REMINDER_ENABLED=false\` environment variable
+
+### Media-Aware Hook
+- **Command:** \`npx @contextstream/mcp-server hook media-aware\`
+- **Purpose:** Detects media-related prompts and injects media tool guidance
+- **Triggers:** Patterns like video, clips, Remotion, image, audio, creative assets
+- **Disable:** Set \`CONTEXTSTREAM_MEDIA_HOOK_ENABLED=false\` environment variable
+
+When Media-Aware hook detects media patterns, it injects context about:
+- How to search indexed media assets
+- How to get clips for Remotion (with frame-based props)
+- How to index new media files
+
+### PreCompact Hook (Optional)
+- **Command:** \`npx @contextstream/mcp-server hook pre-compact\`
+- **Purpose:** Saves conversation state before context compaction
+- **Triggers:** Both manual (/compact) and automatic compaction
+- **Disable:** Set \`CONTEXTSTREAM_PRECOMPACT_ENABLED=false\` environment variable
+- **Note:** Enable with \`generate_rules(include_pre_compact=true)\` to activate
+
+When PreCompact runs, it:
+1. Parses the transcript for active files and tool calls
+2. Saves a session_snapshot to ContextStream API
+3. Injects context about using \`session_init(is_post_compact=true)\` after compaction
+
+### PostToolUse Hook (Real-time Indexing)
+- **Command:** \`npx @contextstream/mcp-server hook post-write\`
+- **Purpose:** Indexes files immediately after Edit/Write/NotebookEdit operations
+- **Matcher:** Edit|Write|NotebookEdit
+- **Disable:** Set \`CONTEXTSTREAM_POSTWRITE_ENABLED=false\` environment variable
+
+### Why Hooks?
+Claude Code has strong built-in behaviors to use its default tools (Grep, Glob, Read)
+and its built-in plan mode. CLAUDE.md instructions decay over long conversations.
+Hooks provide:
+1. **Physical enforcement** - Blocked tools can't be used
+2. **Continuous reminders** - Rules stay in recent context
+3. **Better UX** - Faster searches via indexed ContextStream
+4. **Persistent plans** - ContextStream plans survive across sessions
+5. **Compaction awareness** - Save state before context is compacted
+6. **Real-time indexing** - Files indexed immediately after writes
+
+### Manual Configuration
+If you prefer to configure manually, add to \`~/.claude/settings.json\`:
+\`\`\`json
+{
+  "hooks": {
+    "PreToolUse": [{
+      "matcher": "Glob|Grep|Search|Task|EnterPlanMode",
+      "hooks": [{"type": "command", "command": "npx @contextstream/mcp-server hook pre-tool-use"}]
+    }],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [{"type": "command", "command": "npx @contextstream/mcp-server hook user-prompt-submit"}]
+      },
+      {
+        "matcher": "*",
+        "hooks": [{"type": "command", "command": "npx @contextstream/mcp-server hook media-aware"}]
+      }
+    ],
+    "PreCompact": [{
+      "matcher": "*",
+      "hooks": [{"type": "command", "command": "npx @contextstream/mcp-server hook pre-compact", "timeout": 10}]
+    }],
+    "PostToolUse": [{
+      "matcher": "Edit|Write|NotebookEdit",
+      "hooks": [{"type": "command", "command": "npx @contextstream/mcp-server hook post-write", "timeout": 10}]
+    }]
+  }
 }
-var DEFAULT_CLAUDE_MCP_SERVER_NAME, RULES_VERSION, CONTEXTSTREAM_TOOL_NAMES, CONTEXTSTREAM_RULES_DYNAMIC, CONTEXTSTREAM_RULES_FULL, CONTEXTSTREAM_RULES_MINIMAL, TEMPLATES;
-var init_rules_templates = __esm({
-  "src/rules-templates.ts"() {
-    "use strict";
-    init_version();
-    DEFAULT_CLAUDE_MCP_SERVER_NAME = "contextstream";
-    RULES_VERSION = VERSION === "unknown" ? "0.0.0" : VERSION;
-    CONTEXTSTREAM_TOOL_NAMES = [
-      // Standalone tools (always present)
-      "init",
-      // Renamed from session_init - initialize conversation session
-      "context",
-      // Renamed from context_smart - get relevant context every message
-      "context_feedback",
-      "generate_rules",
-      // Consolidated domain tools (v0.4.x default)
-      "search",
-      // Modes: semantic, hybrid, keyword, pattern
-      "session",
-      // Actions: capture, capture_lesson, get_lessons, recall, remember, user_context, summary, compress, delta, smart_search, decision_trace
-      "memory",
-      // Actions: create_event, get_event, update_event, delete_event, list_events, distill_event, create_node, get_node, update_node, delete_node, list_nodes, supersede_node, search, decisions, timeline, summary
-      "graph",
-      // Actions: dependencies, impact, call_path, related, path, decisions, ingest, circular_dependencies, unused_code, contradictions
-      "project",
-      // Actions: list, get, create, update, index, overview, statistics, files, index_status, ingest_local
-      "workspace",
-      // Actions: list, get, associate, bootstrap
-      "reminder",
-      // Actions: list, active, create, snooze, complete, dismiss
-      "integration",
-      // Provider: slack, github, all; Actions: status, search, stats, activity, contributors, knowledge, summary, channels, discussions, sync_users, repos, issues
-      "help"
-      // Actions: tools, auth, version, editor_rules, enable_bundle
-    ];
-    CONTEXTSTREAM_RULES_DYNAMIC = `
-## ContextStream Dynamic Rules (Powered by our SmartRouter)
-
-All rules are served dynamically via \`context\`. This file is minimal by design.
-
-### Every Message Protocol
-
-| Message | What to Call |
-|---------|--------------|
-| **1st message** | \`init()\` then \`context(user_message="<msg>")\` |
-| **2nd+ messages** | \`context(user_message="<msg>")\` |
-
-Note: \`init()\` auto-detects folder from IDE. Only pass \`folder_path\` if auto-detection fails.
-
-### Follow the Instructions Field
-
-The \`context\` response includes an \`instructions\` field with context-aware guidance.
-**Follow these instructions.** They are dynamically matched to your query and include:
-- Search guidance (when/how to search)
-- Git workflow rules (commit, PR, safety)
-- Planning rules (use ContextStream plans, not file-based)
-- Media/code analysis guidance
-- Lessons from past mistakes
-- And more...
-
-### Notices
-
-Handle notices from \`context\` response:
-- **[VERSION_NOTICE]**: Tell user to update MCP
-- **[RULES_NOTICE]**: Run \`generate_rules()\`
-- **[LESSONS_WARNING]**: Apply lessons immediately
-
-Rules Version: ${RULES_VERSION}
-`.trim();
-    CONTEXTSTREAM_RULES_FULL = `
-## ContextStream Rules
-
-<contextstream_rules>
-1. **SIMPLE UTILITY?** (list/show/version) \u2192 Just execute, skip context calls
-2. **CODING TASK?** \u2192 init \u2192 context \u2192 work \u2192 capture
-3. **SEARCH FIRST:** Before Glob/Grep/Read \u2192 \`search(mode="hybrid")\` FIRST
-</contextstream_rules>
-
-**Display this block at the start of responses to keep rules in context.**
-
----
-
-## \u{1F6A8} CRITICAL RULE #1 - CONTEXTSTREAM SEARCH FIRST \u{1F6A8}
-
-**BEFORE using Glob, Grep, Search, Read (for discovery), Explore, or ANY local file scanning:**
-\`\`\`
-STOP \u2192 Call search(mode="hybrid", query="...") FIRST
 \`\`\`
+`.trim();
+}
+function getIndexStatusPath() {
+  return path5.join(homedir2(), ".contextstream", "indexed-projects.json");
+}
+async function readIndexStatus() {
+  const statusPath = getIndexStatusPath();
+  try {
+    const content = await fs4.readFile(statusPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return { version: 1, projects: {} };
+  }
+}
+async function writeIndexStatus(status) {
+  const statusPath = getIndexStatusPath();
+  const dir = path5.dirname(statusPath);
+  await fs4.mkdir(dir, { recursive: true });
+  await fs4.writeFile(statusPath, JSON.stringify(status, null, 2));
+}
+async function markProjectIndexed(projectPath, options) {
+  const status = await readIndexStatus();
+  const resolvedPath = path5.resolve(projectPath);
+  status.projects[resolvedPath] = {
+    indexed_at: (/* @__PURE__ */ new Date()).toISOString(),
+    project_id: options?.project_id,
+    project_name: options?.project_name
+  };
+  await writeIndexStatus(status);
+}
+async function unmarkProjectIndexed(projectPath) {
+  const status = await readIndexStatus();
+  const resolvedPath = path5.resolve(projectPath);
+  delete status.projects[resolvedPath];
+  await writeIndexStatus(status);
+}
+function getClineHooksDir(scope, projectPath) {
+  if (scope === "global") {
+    return path5.join(homedir2(), "Documents", "Cline", "Rules", "Hooks");
+  }
+  if (!projectPath) {
+    throw new Error("projectPath required for project scope");
+  }
+  return path5.join(projectPath, ".clinerules", "hooks");
+}
+async function installClineHookScripts(options) {
+  const hooksDir = getClineHooksDir(options.scope, options.projectPath);
+  await fs4.mkdir(hooksDir, { recursive: true });
+  const preToolUsePath = path5.join(hooksDir, "PreToolUse");
+  const userPromptPath = path5.join(hooksDir, "UserPromptSubmit");
+  const postToolUsePath = path5.join(hooksDir, "PostToolUse");
+  await fs4.writeFile(preToolUsePath, CLINE_HOOK_WRAPPER("pre-tool-use"), { mode: 493 });
+  await fs4.writeFile(userPromptPath, CLINE_HOOK_WRAPPER("user-prompt-submit"), { mode: 493 });
+  const result = {
+    preToolUse: preToolUsePath,
+    userPromptSubmit: userPromptPath
+  };
+  if (options.includePostWrite !== false) {
+    await fs4.writeFile(postToolUsePath, CLINE_HOOK_WRAPPER("post-write"), { mode: 493 });
+    result.postToolUse = postToolUsePath;
+  }
+  return result;
+}
+function getRooCodeHooksDir(scope, projectPath) {
+  if (scope === "global") {
+    return path5.join(homedir2(), ".roo", "hooks");
+  }
+  if (!projectPath) {
+    throw new Error("projectPath required for project scope");
+  }
+  return path5.join(projectPath, ".roo", "hooks");
+}
+async function installRooCodeHookScripts(options) {
+  const hooksDir = getRooCodeHooksDir(options.scope, options.projectPath);
+  await fs4.mkdir(hooksDir, { recursive: true });
+  const preToolUsePath = path5.join(hooksDir, "PreToolUse");
+  const userPromptPath = path5.join(hooksDir, "UserPromptSubmit");
+  const postToolUsePath = path5.join(hooksDir, "PostToolUse");
+  await fs4.writeFile(preToolUsePath, CLINE_HOOK_WRAPPER("pre-tool-use"), { mode: 493 });
+  await fs4.writeFile(userPromptPath, CLINE_HOOK_WRAPPER("user-prompt-submit"), { mode: 493 });
+  const result = {
+    preToolUse: preToolUsePath,
+    userPromptSubmit: userPromptPath
+  };
+  if (options.includePostWrite !== false) {
+    await fs4.writeFile(postToolUsePath, CLINE_HOOK_WRAPPER("post-write"), { mode: 493 });
+    result.postToolUse = postToolUsePath;
+  }
+  return result;
+}
+function getKiloCodeHooksDir(scope, projectPath) {
+  if (scope === "global") {
+    return path5.join(homedir2(), ".kilocode", "hooks");
+  }
+  if (!projectPath) {
+    throw new Error("projectPath required for project scope");
+  }
+  return path5.join(projectPath, ".kilocode", "hooks");
+}
+async function installKiloCodeHookScripts(options) {
+  const hooksDir = getKiloCodeHooksDir(options.scope, options.projectPath);
+  await fs4.mkdir(hooksDir, { recursive: true });
+  const preToolUsePath = path5.join(hooksDir, "PreToolUse");
+  const userPromptPath = path5.join(hooksDir, "UserPromptSubmit");
+  const postToolUsePath = path5.join(hooksDir, "PostToolUse");
+  await fs4.writeFile(preToolUsePath, CLINE_HOOK_WRAPPER("pre-tool-use"), { mode: 493 });
+  await fs4.writeFile(userPromptPath, CLINE_HOOK_WRAPPER("user-prompt-submit"), { mode: 493 });
+  const result = {
+    preToolUse: preToolUsePath,
+    userPromptSubmit: userPromptPath
+  };
+  if (options.includePostWrite !== false) {
+    await fs4.writeFile(postToolUsePath, CLINE_HOOK_WRAPPER("post-write"), { mode: 493 });
+    result.postToolUse = postToolUsePath;
+  }
+  return result;
+}
+function getCursorHooksConfigPath(scope, projectPath) {
+  if (scope === "global") {
+    return path5.join(homedir2(), ".cursor", "hooks.json");
+  }
+  if (!projectPath) {
+    throw new Error("projectPath required for project scope");
+  }
+  return path5.join(projectPath, ".cursor", "hooks.json");
+}
+function getCursorHooksDir(scope, projectPath) {
+  if (scope === "global") {
+    return path5.join(homedir2(), ".cursor", "hooks");
+  }
+  if (!projectPath) {
+    throw new Error("projectPath required for project scope");
+  }
+  return path5.join(projectPath, ".cursor", "hooks");
+}
+async function readCursorHooksConfig(scope, projectPath) {
+  const configPath = getCursorHooksConfigPath(scope, projectPath);
+  try {
+    const content = await fs4.readFile(configPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return { version: 1, hooks: {} };
+  }
+}
+async function writeCursorHooksConfig(config, scope, projectPath) {
+  const configPath = getCursorHooksConfigPath(scope, projectPath);
+  const dir = path5.dirname(configPath);
+  await fs4.mkdir(dir, { recursive: true });
+  await fs4.writeFile(configPath, JSON.stringify(config, null, 2));
+}
+async function installCursorHookScripts(options) {
+  const hooksDir = getCursorHooksDir(options.scope, options.projectPath);
+  await fs4.mkdir(hooksDir, { recursive: true });
+  const existingConfig = await readCursorHooksConfig(options.scope, options.projectPath);
+  const filterContextStreamHooks = (hooks) => {
+    if (!hooks) return [];
+    return hooks.filter((h) => {
+      const hook = h;
+      return !hook.command?.includes("contextstream");
+    });
+  };
+  const filteredPreToolUse = filterContextStreamHooks(existingConfig.hooks.preToolUse);
+  const filteredBeforeSubmit = filterContextStreamHooks(existingConfig.hooks.beforeSubmitPrompt);
+  const config = {
+    version: 1,
+    hooks: {
+      ...existingConfig.hooks,
+      preToolUse: [
+        ...filteredPreToolUse,
+        {
+          command: "npx @contextstream/mcp-server hook pre-tool-use",
+          type: "command",
+          timeout: 5,
+          matcher: { tool_name: "Glob|Grep|search_files|list_files|ripgrep" }
+        }
+      ],
+      beforeSubmitPrompt: [
+        ...filteredBeforeSubmit,
+        {
+          command: "npx @contextstream/mcp-server hook user-prompt-submit",
+          type: "command",
+          timeout: 5
+        }
+      ]
+    }
+  };
+  await writeCursorHooksConfig(config, options.scope, options.projectPath);
+  const configPath = getCursorHooksConfigPath(options.scope, options.projectPath);
+  return {
+    preToolUse: "npx @contextstream/mcp-server hook pre-tool-use",
+    beforeSubmitPrompt: "npx @contextstream/mcp-server hook user-prompt-submit",
+    config: configPath
+  };
+}
+async function installEditorHooks(options) {
+  const { editor, scope, projectPath, includePreCompact, includePostWrite } = options;
+  switch (editor) {
+    case "claude": {
+      if (scope === "project" && !projectPath) {
+        throw new Error("projectPath required for project scope");
+      }
+      const scripts = await installHookScripts({ includePreCompact });
+      const hooksConfig = buildHooksConfig({ includePreCompact, includePostWrite });
+      const settingsScope = scope === "global" ? "user" : "project";
+      const existing = await readClaudeSettings(settingsScope, projectPath);
+      const merged = mergeHooksIntoSettings(existing, hooksConfig);
+      await writeClaudeSettings(merged, settingsScope, projectPath);
+      const installed = [scripts.preToolUse, scripts.userPrompt];
+      if (scripts.preCompact) installed.push(scripts.preCompact);
+      return {
+        editor: "claude",
+        installed,
+        hooksDir: getHooksDir()
+      };
+    }
+    case "cline": {
+      const scripts = await installClineHookScripts({ scope, projectPath, includePostWrite });
+      const installed = [scripts.preToolUse, scripts.userPromptSubmit];
+      if (scripts.postToolUse) installed.push(scripts.postToolUse);
+      return {
+        editor: "cline",
+        installed,
+        hooksDir: getClineHooksDir(scope, projectPath)
+      };
+    }
+    case "roo": {
+      const scripts = await installRooCodeHookScripts({ scope, projectPath, includePostWrite });
+      const installed = [scripts.preToolUse, scripts.userPromptSubmit];
+      if (scripts.postToolUse) installed.push(scripts.postToolUse);
+      return {
+        editor: "roo",
+        installed,
+        hooksDir: getRooCodeHooksDir(scope, projectPath)
+      };
+    }
+    case "kilo": {
+      const scripts = await installKiloCodeHookScripts({ scope, projectPath, includePostWrite });
+      const installed = [scripts.preToolUse, scripts.userPromptSubmit];
+      if (scripts.postToolUse) installed.push(scripts.postToolUse);
+      return {
+        editor: "kilo",
+        installed,
+        hooksDir: getKiloCodeHooksDir(scope, projectPath)
+      };
+    }
+    case "cursor": {
+      const scripts = await installCursorHookScripts({ scope, projectPath });
+      return {
+        editor: "cursor",
+        installed: [scripts.preToolUse, scripts.beforeSubmitPrompt],
+        hooksDir: getCursorHooksDir(scope, projectPath)
+      };
+    }
+    default:
+      throw new Error(`Unsupported editor: ${editor}`);
+  }
+}
+async function installAllEditorHooks(options) {
+  const editors = options.editors || ["claude", "cline", "roo", "kilo", "cursor"];
+  const results = [];
+  for (const editor of editors) {
+    try {
+      const result = await installEditorHooks({
+        editor,
+        scope: options.scope,
+        projectPath: options.projectPath,
+        includePreCompact: options.includePreCompact,
+        includePostWrite: options.includePostWrite
+      });
+      results.push(result);
+    } catch (error) {
+      console.error(`Failed to install hooks for ${editor}:`, error);
+    }
+  }
+  return results;
+}
+function generateAllHooksDocumentation() {
+  return `
+## Editor Hooks Support (ContextStream)
 
-**Note:** PreToolUse hooks block these tools when ContextStream is available.
-**Claude Code users:** Your tool names are \`mcp__contextstream__search\`, \`mcp__contextstream__init\`, etc.
-
-\u274C **NEVER DO THIS:**
-- \`Glob("**/*.ts")\` \u2192 Use \`search(mode="pattern", query="*.ts")\` instead
-- \`Grep("functionName")\` \u2192 Use \`search(mode="keyword", query="functionName")\` instead
-- \`Read(file)\` for discovery \u2192 Use \`search(mode="hybrid", query="...")\` instead
-- \`Task(subagent_type="Explore")\` \u2192 Use \`search(mode="hybrid")\` instead
-
-\u2705 **ALWAYS DO THIS:**
-1. \`search(mode="hybrid", query="what you're looking for")\`
-2. Only use local tools (Glob/Grep/Read) if ContextStream returns **0 results**
-3. Use Read ONLY for exact file edits after you know the file path
-
-This applies to **EVERY search** throughout the **ENTIRE conversation**, not just the first message.
-
----
-
-## \u{1F6A8} CRITICAL RULE #2 - AUTO-INDEXING \u{1F6A8}
-
-**ContextStream auto-indexes your project on \`init\`.** You do NOT need to:
-- Ask the user to index
-- Manually trigger ingestion
-- Check index_status before every search
-
-**When \`init\` returns \`indexing_status: "started"\` or \`"refreshing"\`:**
-- Background indexing is running automatically
-- Search results will be available within seconds to minutes
-- **DO NOT fall back to local tools** - wait for ContextStream search to work
-- If search returns 0 results initially, try again after a moment
-
-**Only manually trigger indexing if:**
-- \`init\` returned \`ingest_recommendation.recommended: true\` (rare edge case)
-- User explicitly asks to re-index
-
----
-
-## \u{1F6A8} CRITICAL RULE #3 - LESSONS (PAST MISTAKES) \u{1F6A8}
-
-**Lessons are past mistakes that MUST inform your work.** Ignoring lessons leads to repeated failures.
-
-### On \`init\`:
-- Check for \`lessons\` and \`lessons_warning\` in the response
-- If present, **READ THEM IMMEDIATELY** before doing any work
-- These are high-priority lessons (critical/high severity) relevant to your context
-- **Apply the prevention steps** from each lesson to avoid repeating mistakes
-
-### On \`context\`:
-- Check for \`[LESSONS_WARNING]\` tag in the response
-- If present, you **MUST** tell the user about the lessons before proceeding
-- Lessons are proactively fetched when risky actions are detected (refactor, migrate, deploy, etc.)
-- **Do not skip or bury this warning** - lessons represent real past mistakes
-
-### Before ANY Non-Trivial Work:
-**ALWAYS call \`session(action="get_lessons", query="<topic>")\`** where \`<topic>\` matches what you're about to do:
-- Before refactoring \u2192 \`session(action="get_lessons", query="refactoring")\`
-- Before API changes \u2192 \`session(action="get_lessons", query="API changes")\`
-- Before database work \u2192 \`session(action="get_lessons", query="database migrations")\`
-- Before deployments \u2192 \`session(action="get_lessons", query="deployment")\`
-
-### When Lessons Are Found:
-1. **Summarize the lessons** to the user before proceeding
-2. **Explicitly state how you will avoid the past mistakes**
-3. If a lesson conflicts with the current approach, **warn the user**
-
-**Failing to check lessons before risky work is a critical error.**
-
----
-
-## ContextStream v0.4.x Integration (Enhanced)
-
-You have access to ContextStream MCP tools for persistent memory and context.
-v0.4.x uses **~11 consolidated domain tools** for ~75% token reduction vs previous versions.
-Rules Version: ${RULES_VERSION}
-
-## TL;DR - WHEN TO USE CONTEXT
-
-| Request Type | What to Do |
-|--------------|------------|
-| **\u{1F680} Simple utility** (list workspaces, show version) | **Just execute directly** - skip init, context, capture |
-| **\u{1F4BB} Coding task** (edit, create, refactor) | Full context: init \u2192 context \u2192 work \u2192 capture |
-| **\u{1F50D} Code search/discovery** | init \u2192 context \u2192 search() |
-| **\u26A0\uFE0F Risky work** (deploy, migrate, refactor) | Check lessons first: \`session(action="get_lessons")\` |
-| **User frustration/correction** | Capture lesson: \`session(action="capture_lesson", ...)\` |
-
-### Simple Utility Operations - FAST PATH
-
-**For simple queries, just execute and respond:**
-- "list workspaces" \u2192 \`workspace(action="list")\` \u2192 done
-- "list projects" \u2192 \`project(action="list")\` \u2192 done
-- "show version" \u2192 \`help(action="version")\` \u2192 done
-- "what reminders do I have" \u2192 \`reminder(action="list")\` \u2192 done
-
-**No init. No context. No capture.** These add noise, not value.
-
-### Coding Tasks - FULL CONTEXT
-
-| Step | What to Call |
-|------|--------------|
-| **1st message** | \`init(folder_path="...", context_hint="<msg>")\`, then \`context(...)\` |
-| **2nd+ messages** | \`context(user_message="<msg>", format="minified", max_tokens=400)\` |
-| **Code search** | \`search(mode="hybrid", query="...")\` \u2014 BEFORE Glob/Grep/Read |
-| **After significant work** | \`session(action="capture", event_type="decision", ...)\` |
-| **User correction** | \`session(action="capture_lesson", ...)\` |
-| **\u26A0\uFE0F When warnings received** | **STOP**, acknowledge, explain mitigation, then proceed |
-
-**How to detect simple utility operations:**
-- Single-word commands: "list", "show", "version", "help"
-- Data retrieval with no context dependency: "list my workspaces", "what projects do I have"
-- Status checks: "am I authenticated?", "what's the server version?"
-
-**First message rule (for coding tasks):** After \`init\`:
-1. Check for \`lessons\` in response - if present, READ and SUMMARIZE them to user
-2. Then call \`context\` before any other tool or response
-
-**Context Pack (Pro+):** If enabled, use \`context(..., mode="pack", distill=true)\` for code/file queries. If unavailable or disabled, omit \`mode\` and proceed with standard \`context\` (the API will fall back).
-
-**Tool naming:** Use the exact tool names exposed by your MCP client. Claude Code typically uses \`mcp__<server>__<tool>\` where \`<server>\` matches your MCP config (often \`contextstream\`). If a tool call fails with "No such tool available", refresh rules and match the tool list.
-
----
-
-## Consolidated Domain Tools Architecture
-
-v0.4.x consolidates ~58 individual tools into ~11 domain tools with action/mode dispatch:
-
-### Standalone Tools
-- **\`init\`** - Initialize session with workspace detection + context (skip for simple utility operations)
-- **\`context\`** - Semantic search for relevant context (skip for simple utility operations)
-
-### Domain Tools (Use action/mode parameter)
-
-| Domain | Actions/Modes | Example |
-|--------|---------------|---------|
-| **\`search\`** | mode: semantic, hybrid, keyword, pattern | \`search(mode="hybrid", query="auth implementation", limit=3)\` |
-| **\`session\`** | action: capture, capture_lesson, get_lessons, recall, remember, user_context, summary, compress, delta, smart_search, decision_trace | \`session(action="capture", event_type="decision", title="Use JWT", content="...")\` |
-| **\`memory\`** | action: create_event, get_event, update_event, delete_event, list_events, distill_event, create_node, get_node, update_node, delete_node, list_nodes, supersede_node, search, decisions, timeline, summary | \`memory(action="list_events", limit=10)\` |
-| **\`graph\`** | action: dependencies, impact, call_path, related, path, decisions, ingest, circular_dependencies, unused_code, contradictions | \`graph(action="impact", symbol_name="AuthService")\` |
-| **\`project\`** | action: list, get, create, update, index, overview, statistics, files, index_status, ingest_local | \`project(action="statistics")\` |
-| **\`workspace\`** | action: list, get, associate, bootstrap | \`workspace(action="list")\` |
-| **\`reminder\`** | action: list, active, create, snooze, complete, dismiss | \`reminder(action="active")\` |
-| **\`integration\`** | provider: slack/github/all; action: status, search, stats, activity, contributors, knowledge, summary, channels, discussions, sync_users, repos, issues | \`integration(provider="github", action="search", query="...")\` |
-| **\`help\`** | action: tools, auth, version, editor_rules, enable_bundle | \`help(action="tools")\` |
-
----
-
-### Why context is Required (Even After init)
-
-**Common mistake:** "init already gave me context, I don't need context"
-
-**This is WRONG. Here's why:**
-- \`init\` returns the last ~10 items **BY TIME** (chronological)
-- \`context\` **SEARCHES** for items **RELEVANT to THIS message** (semantic)
-
-**Example failure:**
-- User asks: "how should I implement authentication?"
-- Auth decisions were made 20 conversations ago
-- \`init\` won't have it (too old, not in recent 10)
-- \`context\` FINDS it via semantic search
-
-**Without context, you WILL miss relevant older context.**
-
----
-
-### Recommended Token Budgets
-
-- For trivial/local edits: \`context(..., max_tokens=200)\`
-- Default: \`context(..., max_tokens=400)\`
-- Deep debugging/architecture: \`context(..., max_tokens=800)\`
-- Keep \`format="minified"\` (default) unless debugging
-
-If context still feels missing, use \`session(action="recall", query="...")\` for focused deep lookup.
-
----
-
-### Rules, Version & Lessons Notices
-
-**[RULES_NOTICE]** - Update rules via \`generate_rules()\` (or rerun setup).
-
-**[VERSION_NOTICE]** - You **MUST IMMEDIATELY** tell the user:
-  1. A new MCP server version is available
-  2. The exact update command to run
-  3. That they need to restart their AI tool after updating
-  **Do not skip this** - users often miss stderr warnings.
-
-**[LESSONS_WARNING]** - You **MUST** before proceeding:
-  1. Read all lessons listed
-  2. Tell the user about relevant lessons
-  3. Explain how you will avoid each past mistake
-  **This is critical** - ignoring lessons leads to repeated failures.
-
----
-
-### Preferences & Lessons (Use Early)
-
-- If preferences/style matter: \`session(action="user_context")\`
-- Before risky changes: \`session(action="get_lessons", query="<topic>")\`
-- On frustration/corrections: \`session(action="capture_lesson", title="...", trigger="...", impact="...", prevention="...")\`
-
----
-
-### Context Pressure & Compaction Awareness
-
-ContextStream tracks context pressure to help you stay ahead of conversation compaction:
-
-**Automatic tracking:** Token usage is tracked automatically. \`context\` returns \`context_pressure\` when usage is high.
-
-**When \`context\` returns \`context_pressure\` with high/critical level:**
-1. Review the \`suggested_action\` field:
-   - \`prepare_save\`: Start thinking about saving important state
-   - \`save_now\`: Immediately call \`session(action="capture", event_type="session_snapshot")\` to preserve state
-
-**PreCompact Hook (Optional):** If enabled, Claude Code will inject a reminder to save state before compaction.
-Enable with: \`generate_rules(install_hooks=true, include_pre_compact=true)\`
-
-**Before compaction happens (when warned):**
-\`\`\`
-session(action="capture", event_type="session_snapshot", title="Pre-compaction snapshot", content="{
-  \\"conversation_summary\\": \\"<summarize what we've been doing>\\",
-  \\"current_goal\\": \\"<the main task>\\",
-  \\"active_files\\": [\\"file1.ts\\", \\"file2.ts\\"],
-  \\"recent_decisions\\": [{title: \\"...\\", rationale: \\"...\\"}],
-  \\"unfinished_work\\": [{task: \\"...\\", status: \\"...\\", next_steps: \\"...\\"}]
-}")
-\`\`\`
-
-**After compaction (when context seems lost):**
-1. Call \`init(folder_path="...", is_post_compact=true)\` - this auto-restores the most recent snapshot
-2. Or call \`session_restore_context()\` directly to get the saved state
-3. Review the \`restored_context\` to understand prior work
-4. Acknowledge to the user what was restored and continue
-
----
-
-### Index Status (Auto-Managed)
-
-**Indexing is automatic.** After \`init\`, the project is auto-indexed in the background.
-
-**You do NOT need to manually check index_status before every search.** Just use \`search()\`.
-
-**If search returns 0 results and you expected matches:**
-1. Check if \`init\` returned \`indexing_status: "started"\` - indexing may still be in progress
-2. Wait a moment and retry \`search()\`
-3. Only as a last resort: \`project(action="index_status")\` to check
-
-**Graph data:** If graph queries (\`dependencies\`, \`impact\`) return empty, run \`graph(action="ingest")\` once.
-
-**NEVER fall back to local tools (Glob/Grep/Read) just because search returned 0 results on first try.** Retry first.
-
-### Enhanced Context (Server-Side Warnings)
-
-\`context\` now includes **intelligent server-side filtering** that proactively surfaces relevant warnings:
-
-**Response fields:**
-- \`warnings\`: Array of warning strings (displayed with \u26A0\uFE0F prefix)
-
-**What triggers warnings:**
-- **Lessons**: Past mistakes relevant to the current query (via semantic matching)
-- **Risky actions**: Detected high-risk operations (deployments, migrations, destructive commands)
-- **Breaking changes**: When modifications may impact other parts of the codebase
-
-**When you receive warnings:**
-1. **STOP** and read each warning carefully
-2. **Acknowledge** the warning to the user
-3. **Explain** how you will avoid the issue
-4. Only proceed after addressing the warnings
-
-### Search & Code Intelligence (ContextStream-first)
-
-\u26A0\uFE0F **STOP: Before using Search/Glob/Grep/Read/Explore** \u2192 Call \`search(mode="hybrid")\` FIRST. Use local tools ONLY if ContextStream returns 0 results.
-
-**\u274C WRONG workflow (wastes tokens, slow):**
-\`\`\`
-Grep "function" \u2192 Read file1.ts \u2192 Read file2.ts \u2192 Read file3.ts \u2192 finally understand
-\`\`\`
-
-**\u2705 CORRECT workflow (fast, complete):**
-\`\`\`
-search(mode="hybrid", query="function implementation") \u2192 done (results include context)
-\`\`\`
-
-**Why?** ContextStream search returns semantic matches + context + file locations in ONE call. Local tools require multiple round-trips.
-
-**Search order:**
-1. \`session(action="smart_search", query="...")\` - context-enriched
-2. \`search(mode="hybrid", query="...", limit=3)\` or \`search(mode="keyword", query="<filename>", limit=3)\`
-3. \`project(action="files")\` - file tree/list (only when needed)
-4. \`graph(action="dependencies", ...)\` - code structure
-5. Local repo scans (rg/ls/find) - ONLY if ContextStream returns no results, errors, or the user explicitly asks
-
-**Search Mode Selection:**
-
-| Need | Mode | Example |
-|------|------|---------|
-| Find code by meaning | \`hybrid\` | "authentication logic", "error handling" |
-| Exact string/symbol | \`keyword\` | "UserAuthService", "API_KEY" |
-| File patterns | \`pattern\` | "*.sql", "test_*.py" |
-| ALL matches (grep-like) | \`exhaustive\` | "TODO", "FIXME" (find all occurrences) |
-| Symbol renaming | \`refactor\` | "oldFunctionName" (word-boundary matching) |
-| Conceptual search | \`semantic\` | "how does caching work" |
-
-**Token Efficiency:** Use \`output_format\` to reduce response size:
-- \`full\` (default): Full content for understanding code
-- \`paths\`: File paths only (80% token savings) - use for file listings
-- \`minimal\`: Compact format (60% savings) - use for refactoring
-- \`count\`: Match counts only (90% savings) - use for quick checks
-
-**When to use \`output_format=count\`:**
-- User asks "how many X" or "count of X" \u2192 \`search(..., output_format="count")\`
-- Checking if something exists \u2192 count > 0 is sufficient
-- Large exhaustive searches \u2192 get count first, then fetch if needed
-
-**Auto-suggested formats:** Search responses include \`query_interpretation.suggested_output_format\` when the API detects an optimal format:
-- Symbol queries (e.g., "authOptions") \u2192 suggests \`minimal\` (path + line + snippet)
-- Count queries (e.g., "how many") \u2192 suggests \`count\`
-**USE the suggested format** on subsequent searches for best token efficiency.
-
-**Search defaults:** \`search\` returns the top 3 results with compact snippets. Use \`limit\` + \`offset\` for pagination, and \`content_max_chars\` to expand snippets when needed.
-
-If ContextStream returns results, stop and use them. NEVER use local Search/Explore/Read unless you need exact code edits or ContextStream returned 0 results.
-
-**Code Analysis:**
-- Dependencies: \`graph(action="dependencies", file_path="...")\`
-- Change impact: \`graph(action="impact", symbol_name="...")\`
-- Call path: \`graph(action="call_path", from_symbol="...", to_symbol="...")\`
-- Build graph: \`graph(action="ingest")\` - async, can take a few minutes
-
----
-
-### Distillation & Memory Hygiene
-
-- Quick context: \`session(action="summary")\`
-- Long chat: \`session(action="compress", content="...")\`
-- Memory summary: \`memory(action="summary")\`
-- Condense noisy entries: \`memory(action="distill_event", event_id="...")\`
-
----
-
-### When to Capture
-
-| When | Call | Example |
-|------|------|---------|
-| User makes decision | \`session(action="capture", event_type="decision", ...)\` | "Let's use PostgreSQL" |
-| User states preference | \`session(action="capture", event_type="preference", ...)\` | "I prefer TypeScript" |
-| Complete significant task | \`session(action="capture", event_type="task", ...)\` | Capture what was done |
-| Need past context | \`session(action="recall", query="...")\` | "What did we decide about X?" |
-
-**DO NOT capture utility operations:**
-- \u274C "Listed workspaces" - not meaningful context
-- \u274C "Showed version" - not a decision
-- \u274C "Listed projects" - just data retrieval
-
-**DO capture meaningful work:**
-- \u2705 Decisions, preferences, completed features
-- \u2705 Lessons from mistakes
-- \u2705 Insights about architecture or patterns
-
----
-
-### \u{1F6A8} Plans & Tasks - USE CONTEXTSTREAM, NOT FILE-BASED PLANS \u{1F6A8}
+ContextStream can install hooks for multiple AI code editors to enforce ContextStream-first behavior.
 
-**CRITICAL: When the user requests planning, implementation plans, roadmaps, task breakdowns, or step-by-step approaches:**
+### Supported Editors
 
-\u274C **DO NOT** use built-in plan mode (EnterPlanMode tool)
-\u274C **DO NOT** write plans to markdown files or plan documents
-\u274C **DO NOT** ask "should I create a plan file?"
+| Editor | Hooks Location | Hook Types |
+|--------|---------------|------------|
+| **Claude Code** | \`~/.claude/hooks/\` | PreToolUse, UserPromptSubmit, PreCompact |
+| **Cursor** | \`~/.cursor/hooks/\` | preToolUse, beforeSubmit |
+| **Cline** | \`~/Documents/Cline/Rules/Hooks/\` | PreToolUse, UserPromptSubmit |
+| **Roo Code** | \`~/.roo/hooks/\` | PreToolUse, UserPromptSubmit |
+| **Kilo Code** | \`~/.kilocode/hooks/\` | PreToolUse, UserPromptSubmit |
 
-\u2705 **ALWAYS** use ContextStream's plan/task system instead
+### Claude Code Hooks
 
-**Trigger phrases to detect (use ContextStream immediately):**
-- "create a plan", "make a plan", "plan this", "plan for"
-- "implementation plan", "roadmap", "milestones"
-- "break down", "breakdown", "break this into steps"
-- "what are the steps", "step by step", "outline the approach"
-- "task list", "todo list", "action items"
-- "how should we approach", "implementation strategy"
+${generateHooksDocumentation()}
 
-**When detected, immediately:**
+### Cursor Hooks
 
-1. **Create the plan in ContextStream:**
-\`\`\`
-session(action="capture_plan", title="<descriptive title>", description="<what this plan accomplishes>", goals=["goal1", "goal2"], steps=[{id: "1", title: "Step 1", order: 1, description: "..."}, ...])
-\`\`\`
+Cursor uses a \`hooks.json\` configuration file:
+- **preToolUse**: Blocks discovery tools before execution
+- **beforeSubmitPrompt**: Injects ContextStream rules reminder
 
-2. **Create tasks for each step:**
+#### Output Format
+\`\`\`json
+{ "decision": "allow" }
 \`\`\`
-memory(action="create_task", title="<task title>", plan_id="<plan_id from step 1>", priority="high|medium|low", description="<detailed task description>")
+or
+\`\`\`json
+{ "decision": "deny", "reason": "Use ContextStream search instead" }
 \`\`\`
 
-**Why ContextStream plans are better:**
-- Plans persist across sessions and are searchable
-- Tasks track status (pending/in_progress/completed/blocked)
-- Context is preserved with workspace/project association
-- Can be retrieved with \`session(action="get_plan", plan_id="...", include_tasks=true)\`
-- Future sessions can continue from where you left off
+### Cline/Roo/Kilo Code Hooks
 
-**Managing plans/tasks:**
-- List plans: \`session(action="list_plans")\`
-- Get plan with tasks: \`session(action="get_plan", plan_id="<uuid>", include_tasks=true)\`
-- List tasks: \`memory(action="list_tasks", plan_id="<uuid>")\` or \`memory(action="list_tasks")\` for all
-- Update task status: \`memory(action="update_task", task_id="<uuid>", task_status="pending|in_progress|completed|blocked")\`
-- Link task to plan: \`memory(action="update_task", task_id="<uuid>", plan_id="<plan_uuid>")\`
-- Unlink task from plan: \`memory(action="update_task", task_id="<uuid>", plan_id=null)\`
-- Delete: \`memory(action="delete_task", task_id="<uuid>")\` or \`memory(action="delete_event", event_id="<plan_uuid>")\`
+These editors use the same hook format (JSON output):
+- **PreToolUse**: Blocks discovery tools, redirects to ContextStream search
+- **UserPromptSubmit**: Injects ContextStream rules reminder
 
----
+Hooks are executable scripts named after the hook type (no extension).
 
-### Complete Action Reference
+#### Output Format
+\`\`\`json
+{
+  "cancel": true,
+  "errorMessage": "Use ContextStream search instead",
+  "contextModification": "[CONTEXTSTREAM] Use search tool first"
+}
+\`\`\`
 
-**session actions:**
-- \`capture\` - Save decision/insight/task (requires: event_type, title, content)
-- \`capture_lesson\` - Save lesson from mistake (requires: title, category, trigger, impact, prevention)
-- \`get_lessons\` - Retrieve relevant lessons (optional: query, category, severity)
-- \`recall\` - Natural language memory recall (requires: query)
-- \`remember\` - Quick save to memory (requires: content)
-- \`user_context\` - Get user preferences/style
-- \`summary\` - Workspace summary
-- \`compress\` - Compress long conversation
-- \`delta\` - Changes since timestamp
-- \`smart_search\` - Context-enriched search
-- \`decision_trace\` - Trace decision provenance
+### Installation
 
-**memory actions:**
-- Event CRUD: \`create_event\`, \`get_event\`, \`update_event\`, \`delete_event\`, \`list_events\`, \`distill_event\`
-- Node CRUD: \`create_node\`, \`get_node\`, \`update_node\`, \`delete_node\`, \`list_nodes\`, \`supersede_node\`
-- Query: \`search\`, \`decisions\`, \`timeline\`, \`summary\`
+Use \`generate_rules(install_hooks=true, editors=["claude", "cursor", "cline", "roo", "kilo"])\` to install hooks for specific editors, or omit \`editors\` to install for all.
 
-**graph actions:**
-- Analysis: \`dependencies\`, \`impact\`, \`call_path\`, \`related\`, \`path\`
-- Quality: \`circular_dependencies\`, \`unused_code\`, \`contradictions\`
-- Management: \`ingest\`, \`decisions\`
+### Disabling Hooks
 
-See full documentation: https://contextstream.io/docs/mcp/tools
+Set environment variables:
+- \`CONTEXTSTREAM_HOOK_ENABLED=false\` - Disable PreToolUse blocking
+- \`CONTEXTSTREAM_REMINDER_ENABLED=false\` - Disable UserPromptSubmit reminders
 `.trim();
-    CONTEXTSTREAM_RULES_MINIMAL = `
-## ContextStream Rules
-
-<contextstream_rules>
-1. **SIMPLE UTILITY?** (list/show/version) \u2192 Just execute, skip context calls
-2. **CODING TASK?** \u2192 init \u2192 context \u2192 work \u2192 capture
-3. **SEARCH FIRST:** Before Glob/Grep/Read \u2192 \`search(mode="hybrid")\` FIRST
-</contextstream_rules>
-
-**Display this block at the start of responses to keep rules in context.**
-
----
-
-## ContextStream v0.4.x (Hooks Enforced)
-
-Rules Version: ${RULES_VERSION}
-**Note:** PreToolUse hooks block Glob/Grep/Search when ContextStream is available.
-
-### For Coding Tasks
-
-| Action | Tool Call |
-|--------|-----------|
-| **1st message** | \`init(folder_path="<cwd>", context_hint="<msg>")\` then \`context(...)\` |
-| **2nd+ messages** | \`context(user_message="<msg>", format="minified", max_tokens=400)\` |
-| **Code search** | \`search(mode="hybrid", query="...")\` \u2014 BEFORE any local tools |
-| **Save decisions** | \`session(action="capture", event_type="decision", ...)\` |
-
-### Search Modes
-
-| Mode | Use Case |
-|------|----------|
-| \`hybrid\` | General code search (default) |
-| \`keyword\` | Exact symbol/string match |
-| \`exhaustive\` | Find ALL matches (grep-like) |
-| \`semantic\` | Conceptual questions |
-
-### Why ContextStream First?
-
-\u274C **WRONG:** \`Grep \u2192 Read \u2192 Read \u2192 Read\` (4+ tool calls, slow)
-\u2705 **CORRECT:** \`search(mode="hybrid")\` (1 call, returns context)
-
-ContextStream search is **indexed** and returns semantic matches + context in ONE call.
-
-### Quick Reference
-
-| Tool | Example |
-|------|---------|
-| \`search\` | \`search(mode="hybrid", query="auth", limit=3)\` |
-| \`session\` | \`session(action="capture", event_type="decision", title="...", content="...")\` |
-| \`memory\` | \`memory(action="list_events", limit=10)\` |
-| \`graph\` | \`graph(action="dependencies", file_path="...")\` |
-
-### \u{1F680} FAST PATH: Simple Utility Operations
-
-**For simple utility commands, SKIP the ceremony and just execute directly:**
-
-| Command Type | Just Call | Skip |
-|--------------|-----------|------|
-| List workspaces | \`workspace(action="list")\` | init, context, capture |
-| List projects | \`project(action="list")\` | init, context, capture |
-| Show version | \`help(action="version")\` | init, context, capture |
-| List reminders | \`reminder(action="list")\` | init, context, capture |
-| Check auth | \`help(action="auth")\` | init, context, capture |
-
-**Detect simple operations by these patterns:**
-- "list ...", "show ...", "what are my ...", "get ..."
-- Single-action queries with no context dependency
-- User just wants data, not analysis or coding help
-
-**DO NOT add overhead for utility operations:**
-- \u274C Don't call init just to list workspaces
-- \u274C Don't call context for simple queries
-- \u274C Don't capture "listed workspaces" as an event (that's noise)
-
-**Use full context ceremony ONLY for:**
-- Coding tasks (edit, create, refactor, debug)
-- Search/discovery (finding code, understanding architecture)
-- Tasks where past decisions or lessons matter
-
-### Lessons (Past Mistakes)
+}
+var PRETOOLUSE_HOOK_SCRIPT, USER_PROMPT_HOOK_SCRIPT, MEDIA_AWARE_HOOK_SCRIPT, PRECOMPACT_HOOK_SCRIPT, CLINE_PRETOOLUSE_HOOK_SCRIPT, CLINE_USER_PROMPT_HOOK_SCRIPT, CLINE_POSTTOOLUSE_HOOK_SCRIPT, CLINE_HOOK_WRAPPER, CURSOR_PRETOOLUSE_HOOK_SCRIPT, CURSOR_BEFORE_SUBMIT_HOOK_SCRIPT;
+var init_hooks_config = __esm({
+  "src/hooks-config.ts"() {
+    "use strict";
+    PRETOOLUSE_HOOK_SCRIPT = `#!/usr/bin/env python3
+"""
+ContextStream PreToolUse Hook for Claude Code
+Blocks Grep/Glob/Search/Task(Explore)/EnterPlanMode and redirects to ContextStream.
+
+Only blocks if the current project is indexed in ContextStream.
+If not indexed, allows local tools through with a suggestion to index.
+"""
+
+import json
+import sys
+import os
+from pathlib import Path
+from datetime import datetime, timedelta
+
+ENABLED = os.environ.get("CONTEXTSTREAM_HOOK_ENABLED", "true").lower() == "true"
+INDEX_STATUS_FILE = Path.home() / ".contextstream" / "indexed-projects.json"
+# Consider index stale after 7 days
+STALE_THRESHOLD_DAYS = 7
+
+DISCOVERY_PATTERNS = ["**/*", "**/", "src/**", "lib/**", "app/**", "components/**"]
+
+def is_discovery_glob(pattern):
+    pattern_lower = pattern.lower()
+    for p in DISCOVERY_PATTERNS:
+        if p in pattern_lower:
+            return True
+    if pattern_lower.startswith("**/*.") or pattern_lower.startswith("**/"):
+        return True
+    if "**" in pattern or "*/" in pattern:
+        return True
+    return False
+
+def is_discovery_grep(file_path):
+    if not file_path or file_path in [".", "./", "*", "**"]:
+        return True
+    if "*" in file_path or "**" in file_path:
+        return True
+    return False
+
+def is_project_indexed(cwd: str) -> tuple[bool, bool]:
+    """
+    Check if the current directory is in an indexed project.
+    Returns (is_indexed, is_stale).
+    """
+    if not INDEX_STATUS_FILE.exists():
+        return False, False
+
+    try:
+        with open(INDEX_STATUS_FILE, "r") as f:
+            data = json.load(f)
+    except:
+        return False, False
+
+    projects = data.get("projects", {})
+    cwd_path = Path(cwd).resolve()
+
+    # Check if cwd is within any indexed project
+    for project_path, info in projects.items():
+        try:
+            indexed_path = Path(project_path).resolve()
+            # Check if cwd is the project or a subdirectory
+            if cwd_path == indexed_path or indexed_path in cwd_path.parents:
+                # Check if stale
+                indexed_at = info.get("indexed_at")
+                if indexed_at:
+                    try:
+                        indexed_time = datetime.fromisoformat(indexed_at.replace("Z", "+00:00"))
+                        if datetime.now(indexed_time.tzinfo) - indexed_time > timedelta(days=STALE_THRESHOLD_DAYS):
+                            return True, True  # Indexed but stale
+                    except:
+                        pass
+                return True, False  # Indexed and fresh
+        except:
+            continue
+
+    return False, False
+
+def main():
+    if not ENABLED:
+        sys.exit(0)
+
+    try:
+        data = json.load(sys.stdin)
+    except:
+        sys.exit(0)
+
+    tool = data.get("tool_name", "")
+    inp = data.get("tool_input", {})
+    cwd = data.get("cwd", os.getcwd())
+
+    # Check if project is indexed
+    is_indexed, is_stale = is_project_indexed(cwd)
+
+    if not is_indexed:
+        # Project not indexed - allow local tools but suggest indexing
+        # Don't block, just exit successfully
+        sys.exit(0)
+
+    if is_stale:
+        # Index is stale - allow with warning (printed but not blocking)
+        # Still allow the tool but remind about re-indexing
+        pass  # Continue to blocking logic but could add warning
+
+    if tool == "Glob":
+        pattern = inp.get("pattern", "")
+        if is_discovery_glob(pattern):
+            print(f"STOP: Use mcp__contextstream__search(mode=\\"hybrid\\", query=\\"{pattern}\\") instead of Glob.", file=sys.stderr)
+            sys.exit(2)
+
+    elif tool == "Grep" or tool == "Search":
+        # Block ALL Grep/Search operations - use ContextStream search or Read for specific files
+        pattern = inp.get("pattern", "")
+        path = inp.get("path", "")
+        if pattern:
+            if path and not is_discovery_grep(path):
+                # Specific file - suggest Read instead
+                print(f"STOP: Use Read(\\"{path}\\") to view file content, or mcp__contextstream__search(mode=\\"keyword\\", query=\\"{pattern}\\") for codebase search.", file=sys.stderr)
+            else:
+                print(f"STOP: Use mcp__contextstream__search(mode=\\"hybrid\\", query=\\"{pattern}\\") instead of {tool}.", file=sys.stderr)
+            sys.exit(2)
+
+    elif tool == "Task":
+        if inp.get("subagent_type", "").lower() == "explore":
+            print("STOP: Use mcp__contextstream__search(mode=\\"hybrid\\") instead of Task(Explore).", file=sys.stderr)
+            sys.exit(2)
+        if inp.get("subagent_type", "").lower() == "plan":
+            print("STOP: Use mcp__contextstream__session(action=\\"capture_plan\\") for planning. ContextStream plans persist across sessions.", file=sys.stderr)
+            sys.exit(2)
+
+    elif tool == "EnterPlanMode":
+        print("STOP: Use mcp__contextstream__session(action=\\"capture_plan\\", title=\\"...\\", steps=[...]) instead of EnterPlanMode. ContextStream plans persist across sessions and are searchable.", file=sys.stderr)
+        sys.exit(2)
+
+    sys.exit(0)
+
+if __name__ == "__main__":
+    main()
+`;
+    USER_PROMPT_HOOK_SCRIPT = `#!/usr/bin/env python3
+"""
+ContextStream UserPromptSubmit Hook - Injects reminder on every message.
+"""
 
-- After \`init\`: Check for \`lessons\` field and apply before work
-- Before risky work: \`session(action="get_lessons", query="<topic>")\`
-- On mistakes: \`session(action="capture_lesson", title="...", trigger="...", impact="...", prevention="...")\`
+import json
+import sys
+import os
 
-### Context Pressure & Compaction
+ENABLED = os.environ.get("CONTEXTSTREAM_REMINDER_ENABLED", "true").lower() == "true"
 
-- If \`context\` returns high/critical \`context_pressure\`: call \`session(action="capture", ...)\` to save state
-- PreCompact hooks automatically save snapshots before compaction (if installed)
+REMINDER = """[CONTEXTSTREAM RULES]
+1. BEFORE Glob/Grep/Read/Search: mcp__contextstream__search(mode="hybrid") FIRST
+2. Call context_smart at start of EVERY response
+3. Local tools ONLY if ContextStream returns 0 results
+[END RULES]"""
 
-### Enhanced Context (Warnings)
+def main():
+    if not ENABLED:
+        sys.exit(0)
 
-\`context\` returns server-side \`warnings\` for lessons, risky actions, and breaking changes.
-When warnings are present: **STOP**, acknowledge them, explain mitigation, then proceed.
+    try:
+        json.load(sys.stdin)
+    except:
+        sys.exit(0)
 
-### Automatic Context Restoration
+    print(json.dumps({"hookSpecificOutput": {"hookEventName": "UserPromptSubmit", "additionalContext": REMINDER}}))
+    sys.exit(0)
 
-**Context restoration is now enabled by default.** Every \`init\` call automatically:
-- Restores context from recent snapshots (if available)
-- Returns \`restored_context\` field with snapshot data
-- Sets \`is_post_compact=true\` in response when restoration occurs
+if __name__ == "__main__":
+    main()
+`;
+    MEDIA_AWARE_HOOK_SCRIPT = `#!/usr/bin/env python3
+"""
+ContextStream Media-Aware Hook for Claude Code
 
-**No special handling needed after compaction** - just call \`init\` normally.
+Detects media-related prompts and injects context about the media tool.
+"""
 
-To disable automatic restoration:
-- Pass \`is_post_compact=false\` in the API call
-- Or set \`CONTEXTSTREAM_RESTORE_CONTEXT=false\` environment variable
+import json
+import sys
+import os
+import re
 
-### Notices - MUST HANDLE IMMEDIATELY
+ENABLED = os.environ.get("CONTEXTSTREAM_MEDIA_HOOK_ENABLED", "true").lower() == "true"
 
-- **[VERSION_NOTICE]**: Tell the user about the update and command to run
-- **[RULES_NOTICE]**: Run \`generate_rules(overwrite_existing=true)\` to update
-- **[LESSONS_WARNING]**: Read lessons, tell user about them, explain how you'll avoid past mistakes
+# Media patterns (case-insensitive)
+PATTERNS = [
+    r"\\b(video|videos|clip|clips|footage|keyframe)s?\\b",
+    r"\\b(remotion|timeline|video\\s*edit)\\b",
+    r"\\b(image|images|photo|photos|picture|thumbnail)s?\\b",
+    r"\\b(audio|podcast|transcript|transcription|voice)\\b",
+    r"\\b(media|asset|assets|creative|b-roll)\\b",
+    r"\\b(find|search|show).*(clip|video|image|audio|footage|media)\\b",
+]
 
-### Plans & Tasks
+COMPILED = [re.compile(p, re.IGNORECASE) for p in PATTERNS]
 
-When user asks for a plan, use ContextStream (not EnterPlanMode):
-1. \`session(action="capture_plan", title="...", steps=[...])\`
-2. \`memory(action="create_task", title="...", plan_id="<id>")\`
+MEDIA_CONTEXT = """[MEDIA TOOLS AVAILABLE]
+Your workspace may have indexed media. Use ContextStream media tools:
 
-### Workspace-Only Mode (Multi-Project Folders)
+- **Search**: \`mcp__contextstream__media(action="search", query="description")\`
+- **Get clip**: \`mcp__contextstream__media(action="get_clip", content_id="...", start="1:34", end="2:15", output_format="remotion|ffmpeg|raw")\`
+- **List assets**: \`mcp__contextstream__media(action="list")\`
+- **Index**: \`mcp__contextstream__media(action="index", file_path="...", content_type="video|audio|image|document")\`
 
-If working in a parent folder containing multiple projects:
-\`\`\`
-init(folder_path="...", skip_project_creation=true)
-\`\`\`
+For Remotion: use \`output_format="remotion"\` to get frame-based props.
+[END MEDIA TOOLS]"""
+
+def matches(text):
+    return any(p.search(text) for p in COMPILED)
+
+def main():
+    if not ENABLED:
+        sys.exit(0)
+
+    try:
+        data = json.load(sys.stdin)
+    except:
+        sys.exit(0)
+
+    prompt = data.get("prompt", "")
+    if not prompt:
+        session = data.get("session", {})
+        for msg in reversed(session.get("messages", [])):
+            if msg.get("role") == "user":
+                content = msg.get("content", "")
+                prompt = content if isinstance(content, str) else ""
+                if isinstance(content, list):
+                    for b in content:
+                        if isinstance(b, dict) and b.get("type") == "text":
+                            prompt = b.get("text", "")
+                            break
+                break
+
+    if not prompt or not matches(prompt):
+        sys.exit(0)
+
+    print(json.dumps({"hookSpecificOutput": {"hookEventName": "UserPromptSubmit", "additionalContext": MEDIA_CONTEXT}}))
+    sys.exit(0)
+
+if __name__ == "__main__":
+    main()
+`;
+    PRECOMPACT_HOOK_SCRIPT = `#!/usr/bin/env python3
+"""
+ContextStream PreCompact Hook for Claude Code
+
+Runs BEFORE conversation context is compacted (manual via /compact or automatic).
+Automatically saves conversation state to ContextStream by parsing the transcript.
+
+Input (via stdin):
+{
+  "session_id": "...",
+  "transcript_path": "/path/to/transcript.jsonl",
+  "permission_mode": "default",
+  "hook_event_name": "PreCompact",
+  "trigger": "manual" | "auto",
+  "custom_instructions": "..."
+}
+
+Output (to stdout):
+{
+  "hookSpecificOutput": {
+    "hookEventName": "PreCompact",
+    "additionalContext": "... status message ..."
+  }
+}
+"""
+
+import json
+import sys
+import os
+import re
+import urllib.request
+import urllib.error
+
+ENABLED = os.environ.get("CONTEXTSTREAM_PRECOMPACT_ENABLED", "true").lower() == "true"
+AUTO_SAVE = os.environ.get("CONTEXTSTREAM_PRECOMPACT_AUTO_SAVE", "true").lower() == "true"
+API_URL = os.environ.get("CONTEXTSTREAM_API_URL", "https://api.contextstream.io")
+API_KEY = os.environ.get("CONTEXTSTREAM_API_KEY", "")
+
+WORKSPACE_ID = None
+
+def load_config_from_mcp_json(cwd):
+    """Load API config from .mcp.json if env vars not set."""
+    global API_URL, API_KEY, WORKSPACE_ID
+
+    # Try to find .mcp.json and .contextstream/config.json in cwd or parent directories
+    search_dir = cwd
+    for _ in range(5):  # Search up to 5 levels
+        # Load API config from .mcp.json
+        if not API_KEY:
+            mcp_path = os.path.join(search_dir, ".mcp.json")
+            if os.path.exists(mcp_path):
+                try:
+                    with open(mcp_path, 'r') as f:
+                        config = json.load(f)
+                    servers = config.get("mcpServers", {})
+                    cs_config = servers.get("contextstream", {})
+                    env = cs_config.get("env", {})
+                    if env.get("CONTEXTSTREAM_API_KEY"):
+                        API_KEY = env["CONTEXTSTREAM_API_KEY"]
+                    if env.get("CONTEXTSTREAM_API_URL"):
+                        API_URL = env["CONTEXTSTREAM_API_URL"]
+                except:
+                    pass
+
+        # Load workspace_id from .contextstream/config.json
+        if not WORKSPACE_ID:
+            cs_config_path = os.path.join(search_dir, ".contextstream", "config.json")
+            if os.path.exists(cs_config_path):
+                try:
+                    with open(cs_config_path, 'r') as f:
+                        cs_config = json.load(f)
+                    if cs_config.get("workspace_id"):
+                        WORKSPACE_ID = cs_config["workspace_id"]
+                except:
+                    pass
+
+        parent = os.path.dirname(search_dir)
+        if parent == search_dir:
+            break
+        search_dir = parent
+
+def parse_transcript(transcript_path):
+    """Parse transcript to extract active files, decisions, and context."""
+    active_files = set()
+    recent_messages = []
+    tool_calls = []
+
+    try:
+        with open(transcript_path, 'r') as f:
+            for line in f:
+                try:
+                    entry = json.loads(line.strip())
+                    msg_type = entry.get("type", "")
+
+                    # Extract files from tool calls
+                    if msg_type == "tool_use":
+                        tool_name = entry.get("name", "")
+                        tool_input = entry.get("input", {})
+                        tool_calls.append({"name": tool_name, "input": tool_input})
+
+                        # Extract file paths from common tools
+                        if tool_name in ["Read", "Write", "Edit", "NotebookEdit"]:
+                            file_path = tool_input.get("file_path") or tool_input.get("notebook_path")
+                            if file_path:
+                                active_files.add(file_path)
+                        elif tool_name == "Glob":
+                            pattern = tool_input.get("pattern", "")
+                            if pattern:
+                                active_files.add(f"[glob:{pattern}]")
+
+                    # Collect recent assistant messages for summary
+                    if msg_type == "assistant" and entry.get("content"):
+                        content = entry.get("content", "")
+                        if isinstance(content, str) and len(content) > 50:
+                            recent_messages.append(content[:500])
+
+                except json.JSONDecodeError:
+                    continue
+    except Exception as e:
+        pass
 
-This enables workspace-level memory and context without project-specific indexing.
-Use for monorepos or folders with multiple independent projects.
+    return {
+        "active_files": list(active_files)[-20:],  # Last 20 files
+        "tool_call_count": len(tool_calls),
+        "message_count": len(recent_messages),
+        "last_tools": [t["name"] for t in tool_calls[-10:]],  # Last 10 tool names
+    }
+
+def save_snapshot(session_id, transcript_data, trigger):
+    """Save snapshot to ContextStream API."""
+    if not API_KEY:
+        return False, "No API key configured"
+
+    snapshot_content = {
+        "session_id": session_id,
+        "trigger": trigger,
+        "captured_at": None,  # API will set timestamp
+        "active_files": transcript_data.get("active_files", []),
+        "tool_call_count": transcript_data.get("tool_call_count", 0),
+        "last_tools": transcript_data.get("last_tools", []),
+        "auto_captured": True,
+    }
+
+    payload = {
+        "event_type": "session_snapshot",
+        "title": f"Auto Pre-compaction Snapshot ({trigger})",
+        "content": json.dumps(snapshot_content),
+        "importance": "high",
+        "tags": ["session_snapshot", "pre_compaction", "auto_captured"],
+        "source_type": "hook",
+    }
+
+    # Add workspace_id if available
+    if WORKSPACE_ID:
+        payload["workspace_id"] = WORKSPACE_ID
+
+    try:
+        req = urllib.request.Request(
+            f"{API_URL}/api/v1/memory/events",
+            data=json.dumps(payload).encode('utf-8'),
+            headers={
+                "Content-Type": "application/json",
+                "X-API-Key": API_KEY,
+            },
+            method="POST"
+        )
+        with urllib.request.urlopen(req, timeout=5) as resp:
+            return True, "Snapshot saved"
+    except urllib.error.URLError as e:
+        return False, str(e)
+    except Exception as e:
+        return False, str(e)
+
+def main():
+    if not ENABLED:
+        sys.exit(0)
+
+    try:
+        data = json.load(sys.stdin)
+    except:
+        sys.exit(0)
+
+    # Load config from .mcp.json if env vars not set
+    cwd = data.get("cwd", os.getcwd())
+    load_config_from_mcp_json(cwd)
+
+    session_id = data.get("session_id", "unknown")
+    transcript_path = data.get("transcript_path", "")
+    trigger = data.get("trigger", "unknown")
+    custom_instructions = data.get("custom_instructions", "")
+
+    # Parse transcript for context
+    transcript_data = {}
+    if transcript_path and os.path.exists(transcript_path):
+        transcript_data = parse_transcript(transcript_path)
+
+    # Auto-save snapshot if enabled
+    auto_save_status = ""
+    if AUTO_SAVE and API_KEY:
+        success, msg = save_snapshot(session_id, transcript_data, trigger)
+        if success:
+            auto_save_status = f"\\n[ContextStream: Auto-saved snapshot with {len(transcript_data.get('active_files', []))} active files]"
+        else:
+            auto_save_status = f"\\n[ContextStream: Auto-save failed - {msg}]"
+
+    # Build context injection for the AI (backup in case auto-save fails)
+    files_list = ", ".join(transcript_data.get("active_files", [])[:5]) or "none detected"
+    context = f"""[CONTEXT COMPACTION - {trigger.upper()}]{auto_save_status}
+
+Active files detected: {files_list}
+Tool calls in session: {transcript_data.get('tool_call_count', 0)}
+
+After compaction, call session_init(is_post_compact=true) to restore context.
+{f"User instructions: {custom_instructions}" if custom_instructions else ""}"""
+
+    output = {
+        "hookSpecificOutput": {
+            "hookEventName": "PreCompact",
+            "additionalContext": context
+        }
+    }
+
+    print(json.dumps(output))
+    sys.exit(0)
+
+if __name__ == "__main__":
+    main()
+`;
+    CLINE_PRETOOLUSE_HOOK_SCRIPT = `#!/usr/bin/env python3
+"""
+ContextStream PreToolUse Hook for Cline
+Blocks discovery tools and redirects to ContextStream search.
+
+Cline hooks use JSON output format:
+{
+  "cancel": true/false,
+  "errorMessage": "optional error description",
+  "contextModification": "optional text to inject"
+}
+"""
+
+import json
+import sys
+import os
+from pathlib import Path
+from datetime import datetime, timedelta
+
+ENABLED = os.environ.get("CONTEXTSTREAM_HOOK_ENABLED", "true").lower() == "true"
+INDEX_STATUS_FILE = Path.home() / ".contextstream" / "indexed-projects.json"
+STALE_THRESHOLD_DAYS = 7
+
+DISCOVERY_PATTERNS = ["**/*", "**/", "src/**", "lib/**", "app/**", "components/**"]
+
+def is_discovery_glob(pattern):
+    pattern_lower = pattern.lower()
+    for p in DISCOVERY_PATTERNS:
+        if p in pattern_lower:
+            return True
+    if pattern_lower.startswith("**/*.") or pattern_lower.startswith("**/"):
+        return True
+    if "**" in pattern or "*/" in pattern:
+        return True
+    return False
+
+def is_discovery_grep(file_path):
+    if not file_path or file_path in [".", "./", "*", "**"]:
+        return True
+    if "*" in file_path or "**" in file_path:
+        return True
+    return False
+
+def is_project_indexed(workspace_roots):
+    """Check if any workspace root is in an indexed project."""
+    if not INDEX_STATUS_FILE.exists():
+        return False, False
+
+    try:
+        with open(INDEX_STATUS_FILE, "r") as f:
+            data = json.load(f)
+    except:
+        return False, False
+
+    projects = data.get("projects", {})
+
+    for workspace in workspace_roots:
+        cwd_path = Path(workspace).resolve()
+        for project_path, info in projects.items():
+            try:
+                indexed_path = Path(project_path).resolve()
+                if cwd_path == indexed_path or indexed_path in cwd_path.parents:
+                    indexed_at = info.get("indexed_at")
+                    if indexed_at:
+                        try:
+                            indexed_time = datetime.fromisoformat(indexed_at.replace("Z", "+00:00"))
+                            if datetime.now(indexed_time.tzinfo) - indexed_time > timedelta(days=STALE_THRESHOLD_DAYS):
+                                return True, True
+                        except:
+                            pass
+                    return True, False
+            except:
+                continue
+    return False, False
+
+def output_allow(context_mod=None):
+    result = {"cancel": False}
+    if context_mod:
+        result["contextModification"] = context_mod
+    print(json.dumps(result))
+    sys.exit(0)
+
+def output_block(error_msg, context_mod=None):
+    result = {"cancel": True, "errorMessage": error_msg}
+    if context_mod:
+        result["contextModification"] = context_mod
+    print(json.dumps(result))
+    sys.exit(0)
+
+def main():
+    if not ENABLED:
+        output_allow()
+
+    try:
+        data = json.load(sys.stdin)
+    except:
+        output_allow()
+
+    hook_name = data.get("hookName", "")
+    if hook_name != "PreToolUse":
+        output_allow()
+
+    tool = data.get("toolName", "")
+    params = data.get("toolParameters", {})
+    workspace_roots = data.get("workspaceRoots", [])
+
+    # Check if project is indexed
+    is_indexed, is_stale = is_project_indexed(workspace_roots)
+    if not is_indexed:
+        output_allow()
+
+    # Check for discovery patterns
+    if tool == "list_files" or tool == "search_files":
+        pattern = params.get("path", "") or params.get("regex", "")
+        if is_discovery_glob(pattern) or is_discovery_grep(pattern):
+            output_block(
+                f"Use mcp__contextstream__search(mode=\\"hybrid\\", query=\\"{pattern}\\") instead of {tool}. "
+                "ContextStream search is indexed and faster. Only use local tools if ContextStream returns 0 results.",
+                "[CONTEXTSTREAM] Use ContextStream search for code discovery."
+            )
+
+    elif tool == "read_file":
+        # Allow read_file by default - blocking discovery at search level is enough
+        pass
+
+    output_allow()
+
+if __name__ == "__main__":
+    main()
+`;
+    CLINE_USER_PROMPT_HOOK_SCRIPT = `#!/usr/bin/env python3
+"""
+ContextStream UserPromptSubmit Hook for Cline
+Injects reminder about ContextStream rules on every message.
+"""
 
-Full docs: https://contextstream.io/docs/mcp/tools
-`.trim();
-    TEMPLATES = {
-      codex: {
-        filename: "AGENTS.md",
-        description: "Codex CLI agent instructions",
-        build: (rules) => `# Codex CLI Instructions
-${rules}
-`
-      },
-      cursor: {
-        filename: ".cursorrules",
-        description: "Cursor AI rules",
-        build: (rules) => `# Cursor Rules
-${rules}
-`
-      },
-      cline: {
-        filename: ".clinerules",
-        description: "Cline AI rules",
-        build: (rules) => `# Cline Rules
-${rules}
-`
-      },
-      kilo: {
-        filename: ".kilocode/rules/contextstream.md",
-        description: "Kilo Code AI rules",
-        build: (rules) => `# Kilo Code Rules
-${rules}
-`
-      },
-      roo: {
-        filename: ".roo/rules/contextstream.md",
-        description: "Roo Code AI rules",
-        build: (rules) => `# Roo Code Rules
-${rules}
-`
-      },
-      claude: {
-        filename: "CLAUDE.md",
-        description: "Claude Code instructions",
-        build: (rules) => `# Claude Code Instructions
-${rules}
-`
-      },
-      aider: {
-        filename: ".aider.conf.yml",
-        description: "Aider configuration with system prompt",
-        build: (rules) => `# Aider Configuration
-# Note: Aider uses different config format - this adds to the system prompt
+import json
+import sys
+import os
 
-# Add ContextStream guidance to conventions
-conventions: |
-${rules.split("\n").map((line) => "  " + line).join("\n")}
-`
-      },
-      antigravity: {
-        filename: "GEMINI.md",
-        description: "Google Antigravity AI rules",
-        build: (rules) => `# Antigravity Agent Rules
-${rules}
-`
-      }
-    };
+ENABLED = os.environ.get("CONTEXTSTREAM_REMINDER_ENABLED", "true").lower() == "true"
+
+REMINDER = """[CONTEXTSTREAM RULES]
+1. BEFORE list_files/search_files/read_file: mcp__contextstream__search(mode="hybrid") FIRST
+2. Call context_smart at start of EVERY response
+3. Local tools ONLY if ContextStream returns 0 results
+[END RULES]"""
+
+def main():
+    if not ENABLED:
+        print(json.dumps({"cancel": False}))
+        sys.exit(0)
+
+    try:
+        json.load(sys.stdin)
+    except:
+        print(json.dumps({"cancel": False}))
+        sys.exit(0)
+
+    print(json.dumps({
+        "cancel": False,
+        "contextModification": REMINDER
+    }))
+    sys.exit(0)
+
+if __name__ == "__main__":
+    main()
+`;
+    CLINE_POSTTOOLUSE_HOOK_SCRIPT = `#!/bin/bash
+# ContextStream PostToolUse Hook for Cline/Roo/Kilo Code
+# Indexes files after Edit/Write/NotebookEdit operations for real-time search updates.
+#
+# The hook receives JSON on stdin with tool_name and toolParameters.
+# Only runs for write operations (write_to_file, edit_file).
+
+TOOL_NAME=$(cat | python3 -c "import sys, json; d=json.load(sys.stdin); print(d.get('toolName', d.get('tool_name', '')))" 2>/dev/null)
+
+case "$TOOL_NAME" in
+  write_to_file|edit_file|Write|Edit|NotebookEdit)
+    npx @contextstream/mcp-server hook post-write
+    ;;
+esac
+
+exit 0
+`;
+    CLINE_HOOK_WRAPPER = (hookName) => `#!/bin/bash
+# ContextStream ${hookName} Hook Wrapper for Cline/Roo/Kilo Code
+# Calls the Node.js hook via npx
+exec npx @contextstream/mcp-server hook ${hookName}
+`;
+    CURSOR_PRETOOLUSE_HOOK_SCRIPT = `#!/usr/bin/env python3
+"""
+ContextStream PreToolUse Hook for Cursor
+Blocks discovery tools and redirects to ContextStream search.
+
+Cursor hooks use JSON output format:
+{
+  "decision": "allow" | "deny",
+  "reason": "optional error description"
+}
+"""
+
+import json
+import sys
+import os
+from pathlib import Path
+from datetime import datetime, timedelta
+
+ENABLED = os.environ.get("CONTEXTSTREAM_HOOK_ENABLED", "true").lower() == "true"
+INDEX_STATUS_FILE = Path.home() / ".contextstream" / "indexed-projects.json"
+STALE_THRESHOLD_DAYS = 7
+
+DISCOVERY_PATTERNS = ["**/*", "**/", "src/**", "lib/**", "app/**", "components/**"]
+
+def is_discovery_glob(pattern):
+    pattern_lower = pattern.lower()
+    for p in DISCOVERY_PATTERNS:
+        if p in pattern_lower:
+            return True
+    if pattern_lower.startswith("**/*.") or pattern_lower.startswith("**/"):
+        return True
+    if "**" in pattern or "*/" in pattern:
+        return True
+    return False
+
+def is_discovery_grep(file_path):
+    if not file_path or file_path in [".", "./", "*", "**"]:
+        return True
+    if "*" in file_path or "**" in file_path:
+        return True
+    return False
+
+def is_project_indexed(workspace_roots):
+    """Check if any workspace root is in an indexed project."""
+    if not INDEX_STATUS_FILE.exists():
+        return False, False
+
+    try:
+        with open(INDEX_STATUS_FILE, "r") as f:
+            data = json.load(f)
+    except:
+        return False, False
+
+    projects = data.get("projects", {})
+
+    for workspace in workspace_roots:
+        cwd_path = Path(workspace).resolve()
+        for project_path, info in projects.items():
+            try:
+                indexed_path = Path(project_path).resolve()
+                if cwd_path == indexed_path or indexed_path in cwd_path.parents:
+                    indexed_at = info.get("indexed_at")
+                    if indexed_at:
+                        try:
+                            indexed_time = datetime.fromisoformat(indexed_at.replace("Z", "+00:00"))
+                            if datetime.now(indexed_time.tzinfo) - indexed_time > timedelta(days=STALE_THRESHOLD_DAYS):
+                                return True, True
+                        except:
+                            pass
+                    return True, False
+            except:
+                continue
+    return False, False
+
+def output_allow():
+    print(json.dumps({"decision": "allow"}))
+    sys.exit(0)
+
+def output_deny(reason):
+    print(json.dumps({"decision": "deny", "reason": reason}))
+    sys.exit(0)
+
+def main():
+    if not ENABLED:
+        output_allow()
+
+    try:
+        data = json.load(sys.stdin)
+    except:
+        output_allow()
+
+    hook_name = data.get("hook_event_name", "")
+    if hook_name != "preToolUse":
+        output_allow()
+
+    tool = data.get("tool_name", "")
+    params = data.get("tool_input", {}) or data.get("parameters", {})
+    workspace_roots = data.get("workspace_roots", [])
+
+    # Check if project is indexed
+    is_indexed, _ = is_project_indexed(workspace_roots)
+    if not is_indexed:
+        output_allow()
+
+    # Check for Cursor tools
+    if tool in ["Glob", "glob", "list_files"]:
+        pattern = params.get("pattern", "") or params.get("path", "")
+        if is_discovery_glob(pattern):
+            output_deny(
+                f"Use mcp__contextstream__search(mode=\\"hybrid\\", query=\\"{pattern}\\") instead of {tool}. "
+                "ContextStream search is indexed and faster."
+            )
+
+    elif tool in ["Grep", "grep", "search_files", "ripgrep"]:
+        pattern = params.get("pattern", "") or params.get("regex", "")
+        file_path = params.get("path", "")
+        if is_discovery_grep(file_path):
+            output_deny(
+                f"Use mcp__contextstream__search(mode=\\"keyword\\", query=\\"{pattern}\\") instead of {tool}. "
+                "ContextStream search is indexed and faster."
+            )
+
+    output_allow()
+
+if __name__ == "__main__":
+    main()
+`;
+    CURSOR_BEFORE_SUBMIT_HOOK_SCRIPT = `#!/usr/bin/env python3
+"""
+ContextStream BeforeSubmitPrompt Hook for Cursor
+Injects reminder about ContextStream rules.
+"""
+
+import json
+import sys
+import os
+
+ENABLED = os.environ.get("CONTEXTSTREAM_REMINDER_ENABLED", "true").lower() == "true"
+
+def main():
+    if not ENABLED:
+        print(json.dumps({"continue": True}))
+        sys.exit(0)
+
+    try:
+        json.load(sys.stdin)
+    except:
+        print(json.dumps({"continue": True}))
+        sys.exit(0)
+
+    print(json.dumps({
+        "continue": True,
+        "user_message": "[CONTEXTSTREAM] Search with mcp__contextstream__search before using Glob/Grep/Read"
+    }))
+    sys.exit(0)
+
+if __name__ == "__main__":
+    main()
+`;
   }
 });
 
@@ -2502,14 +3040,49 @@ function extractCwd3(input) {
   if (input.cwd) return input.cwd;
   return process.cwd();
 }
-async function generateRulesForFolder(folderPath) {
-  const { generateAllRuleFiles: generateAllRuleFiles2 } = await Promise.resolve().then(() => (init_rules_templates(), rules_templates_exports));
-  await generateAllRuleFiles2({
-    folderPath,
-    editors: ["cursor", "cline", "kilo", "roo", "claude", "aider", "codex"],
-    overwriteExisting: true,
-    mode: "minimal"
-    // Use minimal mode for auto-updates
+function hasPythonHooks(settingsPath) {
+  try {
+    if (!fs11.existsSync(settingsPath)) return false;
+    const content = fs11.readFileSync(settingsPath, "utf-8");
+    const settings = JSON.parse(content);
+    const hooks = settings.hooks;
+    if (!hooks) return false;
+    for (const hookType of Object.keys(hooks)) {
+      const matchers = hooks[hookType];
+      if (!Array.isArray(matchers)) continue;
+      for (const matcher of matchers) {
+        const hookList = matcher.hooks;
+        if (!Array.isArray(hookList)) continue;
+        for (const hook of hookList) {
+          const cmd = hook.command || "";
+          if (cmd.includes("python3") && cmd.includes("contextstream")) {
+            return true;
+          }
+        }
+      }
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+function detectPythonHooks(cwd) {
+  const globalSettingsPath = path12.join(homedir9(), ".claude", "settings.json");
+  const projectSettingsPath = path12.join(cwd, ".claude", "settings.json");
+  return {
+    global: hasPythonHooks(globalSettingsPath),
+    project: hasPythonHooks(projectSettingsPath)
+  };
+}
+async function upgradeHooksForFolder(folderPath) {
+  const { installClaudeCodeHooks: installClaudeCodeHooks3 } = await Promise.resolve().then(() => (init_hooks_config(), hooks_config_exports));
+  await installClaudeCodeHooks3({
+    scope: "both",
+    projectPath: folderPath,
+    includePreCompact: true,
+    includeMediaAware: true,
+    includePostWrite: true,
+    includeAutoRules: true
   });
 }
 async function runAutoRulesHook() {
@@ -2537,14 +3110,17 @@ async function runAutoRulesHook() {
   if (!isContextTool) {
     process.exit(0);
   }
+  const cwd = extractCwd3(input);
+  const pythonHooks = detectPythonHooks(cwd);
+  const hasPythonHooksToUpgrade = pythonHooks.global || pythonHooks.project;
   const rulesNotice = extractRulesNotice(input);
-  if (!rulesNotice || rulesNotice.status === "current") {
+  const rulesNeedUpdate = rulesNotice && rulesNotice.status !== "current";
+  if (!hasPythonHooksToUpgrade && !rulesNeedUpdate) {
     process.exit(0);
   }
-  const cwd = extractCwd3(input);
-  const folderPath = rulesNotice.update_args?.folder_path || cwd;
+  const folderPath = rulesNotice?.update_args?.folder_path || cwd;
   try {
-    await generateRulesForFolder(folderPath);
+    await upgradeHooksForFolder(folderPath);
     markAsRan();
   } catch {
   }
@@ -6611,8 +7187,176 @@ var coerce = {
 };
 var NEVER = INVALID;
 
+// src/version.ts
+import { createRequire } from "module";
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var UPGRADE_COMMAND = "npm install -g @contextstream/mcp-server@latest";
+var NPM_LATEST_URL = "https://registry.npmjs.org/@contextstream/mcp-server/latest";
+function getVersion() {
+  try {
+    const require2 = createRequire(import.meta.url);
+    const pkg = require2("../package.json");
+    const version = pkg?.version;
+    if (typeof version === "string" && version.trim()) return version.trim();
+  } catch {
+  }
+  return "unknown";
+}
+var VERSION = getVersion();
+function compareVersions(v1, v2) {
+  const parts1 = v1.split(".").map(Number);
+  const parts2 = v2.split(".").map(Number);
+  for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+    const p1 = parts1[i] ?? 0;
+    const p2 = parts2[i] ?? 0;
+    if (p1 < p2) return -1;
+    if (p1 > p2) return 1;
+  }
+  return 0;
+}
+var CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
+var latestVersionPromise = null;
+function getCacheFilePath() {
+  return join(homedir(), ".contextstream", "version-cache.json");
+}
+function readCache() {
+  try {
+    const cacheFile = getCacheFilePath();
+    if (!existsSync(cacheFile)) return null;
+    const data = JSON.parse(readFileSync(cacheFile, "utf-8"));
+    if (Date.now() - data.checkedAt > CACHE_TTL_MS) return null;
+    return data;
+  } catch {
+    return null;
+  }
+}
+function writeCache(latestVersion) {
+  try {
+    const configDir = join(homedir(), ".contextstream");
+    if (!existsSync(configDir)) {
+      mkdirSync(configDir, { recursive: true });
+    }
+    const cacheFile = getCacheFilePath();
+    writeFileSync(
+      cacheFile,
+      JSON.stringify({
+        latestVersion,
+        checkedAt: Date.now()
+      })
+    );
+  } catch {
+  }
+}
+async function fetchLatestVersion() {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5e3);
+    const response = await fetch(NPM_LATEST_URL, {
+      signal: controller.signal,
+      headers: { Accept: "application/json" }
+    });
+    clearTimeout(timeout);
+    if (!response.ok) return null;
+    const data = await response.json();
+    return typeof data.version === "string" ? data.version : null;
+  } catch {
+    return null;
+  }
+}
+async function resolveLatestVersion() {
+  const cached = readCache();
+  if (cached) return cached.latestVersion;
+  if (!latestVersionPromise) {
+    latestVersionPromise = fetchLatestVersion().finally(() => {
+      latestVersionPromise = null;
+    });
+  }
+  const latestVersion = await latestVersionPromise;
+  if (latestVersion) {
+    writeCache(latestVersion);
+  }
+  return latestVersion;
+}
+async function checkForUpdates() {
+  const notice = await getUpdateNotice();
+  if (notice?.behind) {
+    showUpdateWarning(notice.current, notice.latest);
+  }
+}
+function showUpdateWarning(currentVersion, latestVersion) {
+  console.error("");
+  console.error("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+  console.error(`\u26A0\uFE0F  Update available: v${currentVersion} \u2192 v${latestVersion}`);
+  console.error("");
+  console.error(`   Run: ${UPGRADE_COMMAND}`);
+  console.error("");
+  console.error("   Then restart your AI tool to use the new version.");
+  console.error("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+  console.error("");
+}
+async function getUpdateNotice() {
+  const currentVersion = VERSION;
+  if (currentVersion === "unknown") return null;
+  try {
+    const latestVersion = await resolveLatestVersion();
+    if (!latestVersion) return null;
+    if (compareVersions(currentVersion, latestVersion) < 0) {
+      return {
+        current: currentVersion,
+        latest: latestVersion,
+        behind: true,
+        upgrade_command: UPGRADE_COMMAND
+      };
+    }
+  } catch {
+  }
+  return null;
+}
+function getVersionsBehind(current, latest) {
+  try {
+    const currentParts = current.split(".").map(Number);
+    const latestParts = latest.split(".").map(Number);
+    if ((latestParts[0] ?? 0) > (currentParts[0] ?? 0)) {
+      return 10 + ((latestParts[1] ?? 0) - (currentParts[1] ?? 0));
+    }
+    const minorDiff = (latestParts[1] ?? 0) - (currentParts[1] ?? 0);
+    const patchDiff = (latestParts[2] ?? 0) - (currentParts[2] ?? 0);
+    if (minorDiff > 0) {
+      return minorDiff;
+    } else if (minorDiff === 0 && patchDiff > 0) {
+      return 1;
+    }
+    return 0;
+  } catch {
+    return 0;
+  }
+}
+function getVersionWarning(notice) {
+  if (!notice?.behind) return null;
+  const versionsBehind = getVersionsBehind(notice.current, notice.latest);
+  if (versionsBehind >= 3) {
+    return `[VERSION_CRITICAL] MCP server is ${versionsBehind} versions behind (${notice.current} \u2192 ${notice.latest}). Update immediately: ${notice.upgrade_command}`;
+  } else if (versionsBehind >= 1) {
+    return `[VERSION_NOTICE] MCP server update available (${notice.current} \u2192 ${notice.latest}). Run: ${notice.upgrade_command}`;
+  }
+  return null;
+}
+function getVersionInstructions(notice) {
+  if (!notice?.behind) return null;
+  const versionsBehind = getVersionsBehind(notice.current, notice.latest);
+  if (versionsBehind >= 5) {
+    return `\u26A0\uFE0F CRITICAL: User's MCP is ${versionsBehind} versions behind. Mention update in EVERY response until updated.`;
+  } else if (versionsBehind >= 3) {
+    return `\u26A0\uFE0F User's MCP is ${versionsBehind} versions behind. Remind about update every 2-3 messages.`;
+  } else if (versionsBehind >= 1) {
+    return `Note: MCP update available (${notice.current}\u2192${notice.latest}). Mention once at session start.`;
+  }
+  return null;
+}
+
 // src/config.ts
-init_version();
 var DEFAULT_API_URL = "https://api.contextstream.io";
 function parseBooleanEnv(value) {
   if (value === void 0) return void 0;
@@ -7471,7 +8215,6 @@ var CacheKeys = {
 var globalCache = new MemoryCache();
 
 // src/client.ts
-init_version();
 var uuidSchema = external_exports.string().uuid();
 function unwrapApiResponse(result) {
   if (!result || typeof result !== "object") return result;
@@ -8915,6 +9658,19 @@ var ContextStreamClient = class {
           }
         } catch {
         }
+        try {
+          const rememberItems = await this.getHighPriorityRememberItems({
+            workspace_id: workspaceId,
+            project_id: projectId,
+            context_hint: params.context_hint,
+            limit: 5
+          });
+          if (rememberItems.length > 0) {
+            context.remember_items = rememberItems;
+            context.remember_warning = `\u{1F4CC} ${rememberItems.length} user preference(s) to remember. ALWAYS check these before making changes.`;
+          }
+        } catch {
+        }
       } catch (e) {
         console.error(
           "[ContextStream] Batched endpoint failed, falling back to individual calls:",
@@ -9879,18 +10635,38 @@ ${context2}`;
         context_hint: params.user_message,
         limit: 3
       });
-      for (const lesson of lessons) {
-        const prefix = lesson.severity === "critical" ? "\u26A0\uFE0F " : "";
+      for (const lesson of lessons) {
+        const prefix = lesson.severity === "critical" ? "\u26A0\uFE0F " : "";
+        items.push({
+          type: "L",
+          key: "lesson",
+          value: `${prefix}${lesson.title}: ${lesson.prevention.slice(0, 100)}`,
+          relevance: lesson.severity === "critical" ? 1 : 0.9
+          // Lessons are high priority
+        });
+      }
+    } catch (e) {
+      errors.push(`lessons: ${e?.message || "fetch failed"}`);
+    }
+    try {
+      const rememberItems = await this.getHighPriorityRememberItems({
+        workspace_id: withDefaults.workspace_id,
+        project_id: withDefaults.project_id,
+        context_hint: params.user_message,
+        limit: 5
+      });
+      for (const item of rememberItems) {
+        const prefix = item.importance === "critical" ? "\u{1F6A8} " : "\u{1F4CC} ";
         items.push({
-          type: "L",
-          key: "lesson",
-          value: `${prefix}${lesson.title}: ${lesson.prevention.slice(0, 100)}`,
-          relevance: lesson.severity === "critical" ? 1 : 0.9
-          // Lessons are high priority
+          type: "R",
+          key: "remember",
+          value: `${prefix}${item.content.slice(0, 150)}`,
+          relevance: 1
+          // Remember items are ALWAYS highest priority
         });
       }
     } catch (e) {
-      errors.push(`lessons: ${e?.message || "fetch failed"}`);
+      errors.push(`remember: ${e?.message || "fetch failed"}`);
     }
     if (errors.length > 0) {
       console.error("[ContextStream] context_smart errors:", errors.join(", "));
@@ -10044,6 +10820,38 @@ ${context}`;
       return [];
     }
   }
+  /**
+   * Get high-priority remember items that should be surfaced proactively.
+   * These are user-flagged important items that should always be checked.
+   */
+  async getHighPriorityRememberItems(params) {
+    const limit = params.limit || 5;
+    try {
+      const searchQuery = params.context_hint ? `${params.context_hint} user preference remember important` : "user preference remember important always_surface";
+      const searchResult = await this.memorySearch({
+        query: searchQuery,
+        workspace_id: params.workspace_id,
+        project_id: params.project_id,
+        limit: limit * 2
+        // Fetch more to filter
+      });
+      if (!searchResult?.results) return [];
+      const rememberItems = searchResult.results.filter((item) => {
+        const tags = item.metadata?.tags || [];
+        return tags.includes("user_remember") || tags.includes("always_surface");
+      }).slice(0, limit).map((item) => {
+        const importance = item.metadata?.importance || "high";
+        return {
+          content: item.content || item.title || "",
+          importance,
+          created_at: item.occurred_at
+        };
+      });
+      return rememberItems;
+    } catch {
+      return [];
+    }
+  }
   /**
    * Extract keywords from a message for relevance matching
    */
@@ -11254,659 +12062,951 @@ ${context}`;
   }
 };
 
-// src/tools.ts
-import * as fs5 from "node:fs";
-import * as path6 from "node:path";
-import { homedir as homedir3 } from "node:os";
-init_rules_templates();
-init_version();
+// src/tools.ts
+import * as fs5 from "node:fs";
+import * as path6 from "node:path";
+import { homedir as homedir3 } from "node:os";
+
+// src/rules-templates.ts
+var DEFAULT_CLAUDE_MCP_SERVER_NAME = "contextstream";
+var RULES_VERSION = VERSION === "unknown" ? "0.0.0" : VERSION;
+var CONTEXTSTREAM_TOOL_NAMES = [
+  // Standalone tools (always present)
+  "init",
+  // Renamed from session_init - initialize conversation session
+  "context",
+  // Renamed from context_smart - get relevant context every message
+  "context_feedback",
+  "generate_rules",
+  // Consolidated domain tools (v0.4.x default)
+  "search",
+  // Modes: semantic, hybrid, keyword, pattern
+  "session",
+  // Actions: capture, capture_lesson, get_lessons, recall, remember, user_context, summary, compress, delta, smart_search, decision_trace
+  "memory",
+  // Actions: create_event, get_event, update_event, delete_event, list_events, distill_event, create_node, get_node, update_node, delete_node, list_nodes, supersede_node, search, decisions, timeline, summary
+  "graph",
+  // Actions: dependencies, impact, call_path, related, path, decisions, ingest, circular_dependencies, unused_code, contradictions
+  "project",
+  // Actions: list, get, create, update, index, overview, statistics, files, index_status, ingest_local
+  "workspace",
+  // Actions: list, get, associate, bootstrap
+  "reminder",
+  // Actions: list, active, create, snooze, complete, dismiss
+  "integration",
+  // Provider: slack, github, all; Actions: status, search, stats, activity, contributors, knowledge, summary, channels, discussions, sync_users, repos, issues
+  "help"
+  // Actions: tools, auth, version, editor_rules, enable_bundle
+];
+function applyMcpToolPrefix(markdown, toolPrefix) {
+  const toolPattern = CONTEXTSTREAM_TOOL_NAMES.join("|");
+  const toolRegex = new RegExp(`(?<!__)\\b(${toolPattern})\\b(?=\\s*\\()`, "g");
+  return markdown.replace(toolRegex, `${toolPrefix}$1`);
+}
+var CONTEXTSTREAM_RULES_DYNAMIC = `
+## ContextStream Dynamic Rules (Powered by our SmartRouter)
+
+All rules are served dynamically via \`context\`. This file is minimal by design.
+
+### Every Message Protocol
+
+| Message | What to Call |
+|---------|--------------|
+| **1st message** | \`init()\` then \`context(user_message="<msg>")\` |
+| **2nd+ messages** | \`context(user_message="<msg>")\` |
+
+Note: \`init()\` auto-detects folder from IDE. Only pass \`folder_path\` if auto-detection fails.
+
+### Follow the Instructions Field
+
+The \`context\` response includes an \`instructions\` field with context-aware guidance.
+**Follow these instructions.** They are dynamically matched to your query and include:
+- Search guidance (when/how to search)
+- Git workflow rules (commit, PR, safety)
+- Planning rules (use ContextStream plans, not file-based)
+- Media/code analysis guidance
+- Lessons from past mistakes
+- And more...
+
+### Notices
+
+Handle notices from \`context\` response:
+- **[VERSION_NOTICE]**: Tell user to update MCP
+- **[RULES_NOTICE]**: Run \`generate_rules()\`
+- **[LESSONS_WARNING]**: Apply lessons immediately
+
+Rules Version: ${RULES_VERSION}
+`.trim();
+var CONTEXTSTREAM_RULES_FULL = `
+## ContextStream Rules
+
+<contextstream_rules>
+1. **SIMPLE UTILITY?** (list/show/version) \u2192 Just execute, skip context calls
+2. **CODING TASK?** \u2192 init \u2192 context \u2192 work \u2192 capture
+3. **SEARCH FIRST:** Before Glob/Grep/Read \u2192 \`search(mode="hybrid")\` FIRST
+</contextstream_rules>
+
+**Display this block at the start of responses to keep rules in context.**
+
+---
+
+## \u{1F6A8} CRITICAL RULE #1 - CONTEXTSTREAM SEARCH FIRST \u{1F6A8}
+
+**BEFORE using Glob, Grep, Search, Read (for discovery), Explore, or ANY local file scanning:**
+\`\`\`
+STOP \u2192 Call search(mode="hybrid", query="...") FIRST
+\`\`\`
+
+**Note:** PreToolUse hooks block these tools when ContextStream is available.
+**Claude Code users:** Your tool names are \`mcp__contextstream__search\`, \`mcp__contextstream__init\`, etc.
+
+\u274C **NEVER DO THIS:**
+- \`Glob("**/*.ts")\` \u2192 Use \`search(mode="pattern", query="*.ts")\` instead
+- \`Grep("functionName")\` \u2192 Use \`search(mode="keyword", query="functionName")\` instead
+- \`Read(file)\` for discovery \u2192 Use \`search(mode="hybrid", query="...")\` instead
+- \`Task(subagent_type="Explore")\` \u2192 Use \`search(mode="hybrid")\` instead
+
+\u2705 **ALWAYS DO THIS:**
+1. \`search(mode="hybrid", query="what you're looking for")\`
+2. Only use local tools (Glob/Grep/Read) if ContextStream returns **0 results**
+3. Use Read ONLY for exact file edits after you know the file path
+
+This applies to **EVERY search** throughout the **ENTIRE conversation**, not just the first message.
+
+---
+
+## \u{1F6A8} CRITICAL RULE #2 - AUTO-INDEXING \u{1F6A8}
+
+**ContextStream auto-indexes your project on \`init\`.** You do NOT need to:
+- Ask the user to index
+- Manually trigger ingestion
+- Check index_status before every search
+
+**When \`init\` returns \`indexing_status: "started"\` or \`"refreshing"\`:**
+- Background indexing is running automatically
+- Search results will be available within seconds to minutes
+- **DO NOT fall back to local tools** - wait for ContextStream search to work
+- If search returns 0 results initially, try again after a moment
+
+**Only manually trigger indexing if:**
+- \`init\` returned \`ingest_recommendation.recommended: true\` (rare edge case)
+- User explicitly asks to re-index
+
+---
+
+## \u{1F6A8} CRITICAL RULE #3 - LESSONS (PAST MISTAKES) \u{1F6A8}
+
+**Lessons are past mistakes that MUST inform your work.** Ignoring lessons leads to repeated failures.
+
+### On \`init\`:
+- Check for \`lessons\` and \`lessons_warning\` in the response
+- If present, **READ THEM IMMEDIATELY** before doing any work
+- These are high-priority lessons (critical/high severity) relevant to your context
+- **Apply the prevention steps** from each lesson to avoid repeating mistakes
+
+### On \`context\`:
+- Check for \`[LESSONS_WARNING]\` tag in the response
+- If present, you **MUST** tell the user about the lessons before proceeding
+- Lessons are proactively fetched when risky actions are detected (refactor, migrate, deploy, etc.)
+- **Do not skip or bury this warning** - lessons represent real past mistakes
+
+### Before ANY Non-Trivial Work:
+**ALWAYS call \`session(action="get_lessons", query="<topic>")\`** where \`<topic>\` matches what you're about to do:
+- Before refactoring \u2192 \`session(action="get_lessons", query="refactoring")\`
+- Before API changes \u2192 \`session(action="get_lessons", query="API changes")\`
+- Before database work \u2192 \`session(action="get_lessons", query="database migrations")\`
+- Before deployments \u2192 \`session(action="get_lessons", query="deployment")\`
+
+### When Lessons Are Found:
+1. **Summarize the lessons** to the user before proceeding
+2. **Explicitly state how you will avoid the past mistakes**
+3. If a lesson conflicts with the current approach, **warn the user**
+
+**Failing to check lessons before risky work is a critical error.**
+
+---
+
+## ContextStream v0.4.x Integration (Enhanced)
+
+You have access to ContextStream MCP tools for persistent memory and context.
+v0.4.x uses **~11 consolidated domain tools** for ~75% token reduction vs previous versions.
+Rules Version: ${RULES_VERSION}
+
+## TL;DR - WHEN TO USE CONTEXT
+
+| Request Type | What to Do |
+|--------------|------------|
+| **\u{1F680} Simple utility** (list workspaces, show version) | **Just execute directly** - skip init, context, capture |
+| **\u{1F4BB} Coding task** (edit, create, refactor) | Full context: init \u2192 context \u2192 work \u2192 capture |
+| **\u{1F50D} Code search/discovery** | init \u2192 context \u2192 search() |
+| **\u26A0\uFE0F Risky work** (deploy, migrate, refactor) | Check lessons first: \`session(action="get_lessons")\` |
+| **User frustration/correction** | Capture lesson: \`session(action="capture_lesson", ...)\` |
+
+### Simple Utility Operations - FAST PATH
+
+**For simple queries, just execute and respond:**
+- "list workspaces" \u2192 \`workspace(action="list")\` \u2192 done
+- "list projects" \u2192 \`project(action="list")\` \u2192 done
+- "show version" \u2192 \`help(action="version")\` \u2192 done
+- "what reminders do I have" \u2192 \`reminder(action="list")\` \u2192 done
+
+**No init. No context. No capture.** These add noise, not value.
+
+### Coding Tasks - FULL CONTEXT
+
+| Step | What to Call |
+|------|--------------|
+| **1st message** | \`init(folder_path="...", context_hint="<msg>")\`, then \`context(...)\` |
+| **2nd+ messages** | \`context(user_message="<msg>", format="minified", max_tokens=400)\` |
+| **Code search** | \`search(mode="hybrid", query="...")\` \u2014 BEFORE Glob/Grep/Read |
+| **After significant work** | \`session(action="capture", event_type="decision", ...)\` |
+| **User correction** | \`session(action="capture_lesson", ...)\` |
+| **\u26A0\uFE0F When warnings received** | **STOP**, acknowledge, explain mitigation, then proceed |
+
+**How to detect simple utility operations:**
+- Single-word commands: "list", "show", "version", "help"
+- Data retrieval with no context dependency: "list my workspaces", "what projects do I have"
+- Status checks: "am I authenticated?", "what's the server version?"
+
+**First message rule (for coding tasks):** After \`init\`:
+1. Check for \`lessons\` in response - if present, READ and SUMMARIZE them to user
+2. Then call \`context\` before any other tool or response
+
+**Context Pack (Pro+):** If enabled, use \`context(..., mode="pack", distill=true)\` for code/file queries. If unavailable or disabled, omit \`mode\` and proceed with standard \`context\` (the API will fall back).
+
+**Tool naming:** Use the exact tool names exposed by your MCP client. Claude Code typically uses \`mcp__<server>__<tool>\` where \`<server>\` matches your MCP config (often \`contextstream\`). If a tool call fails with "No such tool available", refresh rules and match the tool list.
+
+---
+
+## Consolidated Domain Tools Architecture
+
+v0.4.x consolidates ~58 individual tools into ~11 domain tools with action/mode dispatch:
+
+### Standalone Tools
+- **\`init\`** - Initialize session with workspace detection + context (skip for simple utility operations)
+- **\`context\`** - Semantic search for relevant context (skip for simple utility operations)
+
+### Domain Tools (Use action/mode parameter)
+
+| Domain | Actions/Modes | Example |
+|--------|---------------|---------|
+| **\`search\`** | mode: semantic, hybrid, keyword, pattern | \`search(mode="hybrid", query="auth implementation", limit=3)\` |
+| **\`session\`** | action: capture, capture_lesson, get_lessons, recall, remember, user_context, summary, compress, delta, smart_search, decision_trace | \`session(action="capture", event_type="decision", title="Use JWT", content="...")\` |
+| **\`memory\`** | action: create_event, get_event, update_event, delete_event, list_events, distill_event, create_node, get_node, update_node, delete_node, list_nodes, supersede_node, search, decisions, timeline, summary | \`memory(action="list_events", limit=10)\` |
+| **\`graph\`** | action: dependencies, impact, call_path, related, path, decisions, ingest, circular_dependencies, unused_code, contradictions | \`graph(action="impact", symbol_name="AuthService")\` |
+| **\`project\`** | action: list, get, create, update, index, overview, statistics, files, index_status, ingest_local | \`project(action="statistics")\` |
+| **\`workspace\`** | action: list, get, associate, bootstrap | \`workspace(action="list")\` |
+| **\`reminder\`** | action: list, active, create, snooze, complete, dismiss | \`reminder(action="active")\` |
+| **\`integration\`** | provider: slack/github/all; action: status, search, stats, activity, contributors, knowledge, summary, channels, discussions, sync_users, repos, issues | \`integration(provider="github", action="search", query="...")\` |
+| **\`help\`** | action: tools, auth, version, editor_rules, enable_bundle | \`help(action="tools")\` |
+
+---
+
+### Why context is Required (Even After init)
+
+**Common mistake:** "init already gave me context, I don't need context"
+
+**This is WRONG. Here's why:**
+- \`init\` returns the last ~10 items **BY TIME** (chronological)
+- \`context\` **SEARCHES** for items **RELEVANT to THIS message** (semantic)
+
+**Example failure:**
+- User asks: "how should I implement authentication?"
+- Auth decisions were made 20 conversations ago
+- \`init\` won't have it (too old, not in recent 10)
+- \`context\` FINDS it via semantic search
+
+**Without context, you WILL miss relevant older context.**
+
+---
+
+### Recommended Token Budgets
+
+- For trivial/local edits: \`context(..., max_tokens=200)\`
+- Default: \`context(..., max_tokens=400)\`
+- Deep debugging/architecture: \`context(..., max_tokens=800)\`
+- Keep \`format="minified"\` (default) unless debugging
+
+If context still feels missing, use \`session(action="recall", query="...")\` for focused deep lookup.
+
+---
+
+### Rules, Version & Lessons Notices
+
+**[RULES_NOTICE]** - Update rules via \`generate_rules()\` (or rerun setup).
+
+**[VERSION_NOTICE]** - You **MUST IMMEDIATELY** tell the user:
+  1. A new MCP server version is available
+  2. The exact update command to run
+  3. That they need to restart their AI tool after updating
+  **Do not skip this** - users often miss stderr warnings.
+
+**[LESSONS_WARNING]** - You **MUST** before proceeding:
+  1. Read all lessons listed
+  2. Tell the user about relevant lessons
+  3. Explain how you will avoid each past mistake
+  **This is critical** - ignoring lessons leads to repeated failures.
+
+---
+
+### Preferences & Lessons (Use Early)
+
+- If preferences/style matter: \`session(action="user_context")\`
+- Before risky changes: \`session(action="get_lessons", query="<topic>")\`
+- On frustration/corrections: \`session(action="capture_lesson", title="...", trigger="...", impact="...", prevention="...")\`
+
+---
+
+### Context Pressure & Compaction Awareness
+
+ContextStream tracks context pressure to help you stay ahead of conversation compaction:
+
+**Automatic tracking:** Token usage is tracked automatically. \`context\` returns \`context_pressure\` when usage is high.
+
+**When \`context\` returns \`context_pressure\` with high/critical level:**
+1. Review the \`suggested_action\` field:
+   - \`prepare_save\`: Start thinking about saving important state
+   - \`save_now\`: Immediately call \`session(action="capture", event_type="session_snapshot")\` to preserve state
+
+**PreCompact Hook (Optional):** If enabled, Claude Code will inject a reminder to save state before compaction.
+Enable with: \`generate_rules(install_hooks=true, include_pre_compact=true)\`
+
+**Before compaction happens (when warned):**
+\`\`\`
+session(action="capture", event_type="session_snapshot", title="Pre-compaction snapshot", content="{
+  \\"conversation_summary\\": \\"<summarize what we've been doing>\\",
+  \\"current_goal\\": \\"<the main task>\\",
+  \\"active_files\\": [\\"file1.ts\\", \\"file2.ts\\"],
+  \\"recent_decisions\\": [{title: \\"...\\", rationale: \\"...\\"}],
+  \\"unfinished_work\\": [{task: \\"...\\", status: \\"...\\", next_steps: \\"...\\"}]
+}")
+\`\`\`
+
+**After compaction (when context seems lost):**
+1. Call \`init(folder_path="...", is_post_compact=true)\` - this auto-restores the most recent snapshot
+2. Or call \`session_restore_context()\` directly to get the saved state
+3. Review the \`restored_context\` to understand prior work
+4. Acknowledge to the user what was restored and continue
+
+---
+
+### Index Status (Auto-Managed)
+
+**Indexing is automatic.** After \`init\`, the project is auto-indexed in the background.
+
+**You do NOT need to manually check index_status before every search.** Just use \`search()\`.
+
+**If search returns 0 results and you expected matches:**
+1. Check if \`init\` returned \`indexing_status: "started"\` - indexing may still be in progress
+2. Wait a moment and retry \`search()\`
+3. Only as a last resort: \`project(action="index_status")\` to check
+
+**Graph data:** If graph queries (\`dependencies\`, \`impact\`) return empty, run \`graph(action="ingest")\` once.
+
+**NEVER fall back to local tools (Glob/Grep/Read) just because search returned 0 results on first try.** Retry first.
+
+### Enhanced Context (Server-Side Warnings)
+
+\`context\` now includes **intelligent server-side filtering** that proactively surfaces relevant warnings:
+
+**Response fields:**
+- \`warnings\`: Array of warning strings (displayed with \u26A0\uFE0F prefix)
+
+**What triggers warnings:**
+- **Lessons**: Past mistakes relevant to the current query (via semantic matching)
+- **Risky actions**: Detected high-risk operations (deployments, migrations, destructive commands)
+- **Breaking changes**: When modifications may impact other parts of the codebase
+
+**When you receive warnings:**
+1. **STOP** and read each warning carefully
+2. **Acknowledge** the warning to the user
+3. **Explain** how you will avoid the issue
+4. Only proceed after addressing the warnings
+
+### Search & Code Intelligence (ContextStream-first)
+
+\u26A0\uFE0F **STOP: Before using Search/Glob/Grep/Read/Explore** \u2192 Call \`search(mode="hybrid")\` FIRST. Use local tools ONLY if ContextStream returns 0 results.
+
+**\u274C WRONG workflow (wastes tokens, slow):**
+\`\`\`
+Grep "function" \u2192 Read file1.ts \u2192 Read file2.ts \u2192 Read file3.ts \u2192 finally understand
+\`\`\`
+
+**\u2705 CORRECT workflow (fast, complete):**
+\`\`\`
+search(mode="hybrid", query="function implementation") \u2192 done (results include context)
+\`\`\`
+
+**Why?** ContextStream search returns semantic matches + context + file locations in ONE call. Local tools require multiple round-trips.
+
+**Search order:**
+1. \`session(action="smart_search", query="...")\` - context-enriched
+2. \`search(mode="hybrid", query="...", limit=3)\` or \`search(mode="keyword", query="<filename>", limit=3)\`
+3. \`project(action="files")\` - file tree/list (only when needed)
+4. \`graph(action="dependencies", ...)\` - code structure
+5. Local repo scans (rg/ls/find) - ONLY if ContextStream returns no results, errors, or the user explicitly asks
+
+**Search Mode Selection:**
+
+| Need | Mode | Example |
+|------|------|---------|
+| Find code by meaning | \`hybrid\` | "authentication logic", "error handling" |
+| Exact string/symbol | \`keyword\` | "UserAuthService", "API_KEY" |
+| File patterns | \`pattern\` | "*.sql", "test_*.py" |
+| ALL matches (grep-like) | \`exhaustive\` | "TODO", "FIXME" (find all occurrences) |
+| Symbol renaming | \`refactor\` | "oldFunctionName" (word-boundary matching) |
+| Conceptual search | \`semantic\` | "how does caching work" |
+
+**Token Efficiency:** Use \`output_format\` to reduce response size:
+- \`full\` (default): Full content for understanding code
+- \`paths\`: File paths only (80% token savings) - use for file listings
+- \`minimal\`: Compact format (60% savings) - use for refactoring
+- \`count\`: Match counts only (90% savings) - use for quick checks
+
+**When to use \`output_format=count\`:**
+- User asks "how many X" or "count of X" \u2192 \`search(..., output_format="count")\`
+- Checking if something exists \u2192 count > 0 is sufficient
+- Large exhaustive searches \u2192 get count first, then fetch if needed
+
+**Auto-suggested formats:** Search responses include \`query_interpretation.suggested_output_format\` when the API detects an optimal format:
+- Symbol queries (e.g., "authOptions") \u2192 suggests \`minimal\` (path + line + snippet)
+- Count queries (e.g., "how many") \u2192 suggests \`count\`
+**USE the suggested format** on subsequent searches for best token efficiency.
+
+**Search defaults:** \`search\` returns the top 3 results with compact snippets. Use \`limit\` + \`offset\` for pagination, and \`content_max_chars\` to expand snippets when needed.
+
+If ContextStream returns results, stop and use them. NEVER use local Search/Explore/Read unless you need exact code edits or ContextStream returned 0 results.
+
+**Code Analysis:**
+- Dependencies: \`graph(action="dependencies", file_path="...")\`
+- Change impact: \`graph(action="impact", symbol_name="...")\`
+- Call path: \`graph(action="call_path", from_symbol="...", to_symbol="...")\`
+- Build graph: \`graph(action="ingest")\` - async, can take a few minutes
+
+---
+
+### Distillation & Memory Hygiene
+
+- Quick context: \`session(action="summary")\`
+- Long chat: \`session(action="compress", content="...")\`
+- Memory summary: \`memory(action="summary")\`
+- Condense noisy entries: \`memory(action="distill_event", event_id="...")\`
+
+---
+
+### When to Capture
+
+| When | Call | Example |
+|------|------|---------|
+| User makes decision | \`session(action="capture", event_type="decision", ...)\` | "Let's use PostgreSQL" |
+| User states preference | \`session(action="capture", event_type="preference", ...)\` | "I prefer TypeScript" |
+| Complete significant task | \`session(action="capture", event_type="task", ...)\` | Capture what was done |
+| Need past context | \`session(action="recall", query="...")\` | "What did we decide about X?" |
+
+**DO NOT capture utility operations:**
+- \u274C "Listed workspaces" - not meaningful context
+- \u274C "Showed version" - not a decision
+- \u274C "Listed projects" - just data retrieval
+
+**DO capture meaningful work:**
+- \u2705 Decisions, preferences, completed features
+- \u2705 Lessons from mistakes
+- \u2705 Insights about architecture or patterns
+
+---
+
+### \u{1F6A8} Plans & Tasks - USE CONTEXTSTREAM, NOT FILE-BASED PLANS \u{1F6A8}
+
+**CRITICAL: When the user requests planning, implementation plans, roadmaps, task breakdowns, or step-by-step approaches:**
+
+\u274C **DO NOT** use built-in plan mode (EnterPlanMode tool)
+\u274C **DO NOT** write plans to markdown files or plan documents
+\u274C **DO NOT** ask "should I create a plan file?"
+
+\u2705 **ALWAYS** use ContextStream's plan/task system instead
+
+**Trigger phrases to detect (use ContextStream immediately):**
+- "create a plan", "make a plan", "plan this", "plan for"
+- "implementation plan", "roadmap", "milestones"
+- "break down", "breakdown", "break this into steps"
+- "what are the steps", "step by step", "outline the approach"
+- "task list", "todo list", "action items"
+- "how should we approach", "implementation strategy"
+
+**When detected, immediately:**
+
+1. **Create the plan in ContextStream:**
+\`\`\`
+session(action="capture_plan", title="<descriptive title>", description="<what this plan accomplishes>", goals=["goal1", "goal2"], steps=[{id: "1", title: "Step 1", order: 1, description: "..."}, ...])
+\`\`\`
+
+2. **Create tasks for each step:**
+\`\`\`
+memory(action="create_task", title="<task title>", plan_id="<plan_id from step 1>", priority="high|medium|low", description="<detailed task description>")
+\`\`\`
+
+**Why ContextStream plans are better:**
+- Plans persist across sessions and are searchable
+- Tasks track status (pending/in_progress/completed/blocked)
+- Context is preserved with workspace/project association
+- Can be retrieved with \`session(action="get_plan", plan_id="...", include_tasks=true)\`
+- Future sessions can continue from where you left off
+
+**Managing plans/tasks:**
+- List plans: \`session(action="list_plans")\`
+- Get plan with tasks: \`session(action="get_plan", plan_id="<uuid>", include_tasks=true)\`
+- List tasks: \`memory(action="list_tasks", plan_id="<uuid>")\` or \`memory(action="list_tasks")\` for all
+- Update task status: \`memory(action="update_task", task_id="<uuid>", task_status="pending|in_progress|completed|blocked")\`
+- Link task to plan: \`memory(action="update_task", task_id="<uuid>", plan_id="<plan_uuid>")\`
+- Unlink task from plan: \`memory(action="update_task", task_id="<uuid>", plan_id=null)\`
+- Delete: \`memory(action="delete_task", task_id="<uuid>")\` or \`memory(action="delete_event", event_id="<plan_uuid>")\`
+
+---
+
+### Complete Action Reference
 
-// src/tool-catalog.ts
-var TOOL_CATALOG = [
-  {
-    name: "Session",
-    tools: [
-      { name: "init", hint: "start-conv" },
-      { name: "smart", hint: "each-msg" },
-      { name: "capture", hint: "save" },
-      { name: "recall", hint: "find" },
-      { name: "remember", hint: "quick" },
-      { name: "compress", hint: "end" },
-      { name: "summary", hint: "brief" },
-      { name: "delta", hint: "changes" },
-      { name: "get_lessons", hint: "learn" },
-      { name: "capture_lesson", hint: "mistake" },
-      { name: "get_user_context", hint: "prefs" },
-      { name: "smart_search", hint: "deep-find" },
-      // Plan actions
-      { name: "capture_plan", hint: "save-plan" },
-      { name: "get_plan", hint: "get-plan" },
-      { name: "update_plan", hint: "edit-plan" },
-      { name: "list_plans", hint: "list-plans" }
-    ]
-  },
-  {
-    name: "Search",
-    tools: [
-      { name: "semantic", hint: "meaning" },
-      { name: "hybrid", hint: "combo" },
-      { name: "keyword", hint: "exact" },
-      { name: "pattern", hint: "code" }
-    ]
-  },
-  {
-    name: "Memory",
-    tools: [
-      { name: "create_event", hint: "new" },
-      { name: "list_events", hint: "list" },
-      { name: "get_event", hint: "get" },
-      { name: "update_event", hint: "edit" },
-      { name: "delete_event", hint: "rm" },
-      { name: "search", hint: "find" },
-      { name: "decisions", hint: "choices" },
-      { name: "timeline", hint: "history" },
-      { name: "distill_event", hint: "extract" },
-      // Task actions
-      { name: "create_task", hint: "new-task" },
-      { name: "get_task", hint: "get-task" },
-      { name: "update_task", hint: "edit-task" },
-      { name: "delete_task", hint: "rm-task" },
-      { name: "list_tasks", hint: "list-tasks" },
-      { name: "reorder_tasks", hint: "sort-tasks" }
-    ]
-  },
-  {
-    name: "Knowledge",
-    tools: [
-      { name: "create_node", hint: "new" },
-      { name: "list_nodes", hint: "list" },
-      { name: "get_node", hint: "get" },
-      { name: "update_node", hint: "edit" },
-      { name: "delete_node", hint: "rm" },
-      { name: "supersede_node", hint: "replace" }
-    ]
-  },
-  {
-    name: "Graph",
-    tools: [
-      { name: "related", hint: "links" },
-      { name: "path", hint: "trace" },
-      { name: "decisions", hint: "choices" },
-      { name: "dependencies", hint: "deps" },
-      { name: "ingest", hint: "build" },
-      { name: "impact", hint: "changes" },
-      { name: "contradictions", hint: "conflicts" }
-    ]
-  },
-  {
-    name: "Media",
-    tools: [
-      { name: "index", hint: "add-media" },
-      { name: "status", hint: "progress" },
-      { name: "search", hint: "find-clip" },
-      { name: "get_clip", hint: "get-segment" },
-      { name: "list", hint: "browse" },
-      { name: "delete", hint: "remove" }
-    ]
-  },
-  {
-    name: "Workspace",
-    tools: [
-      { name: "list", hint: "" },
-      { name: "get", hint: "" },
-      { name: "create", hint: "" },
-      { name: "associate", hint: "link-folder" },
-      { name: "bootstrap", hint: "new-ws" }
-    ]
-  },
-  {
-    name: "Project",
-    tools: [
-      { name: "list", hint: "" },
-      { name: "get", hint: "" },
-      { name: "create", hint: "" },
-      { name: "index", hint: "scan-code" },
-      { name: "files", hint: "list-files" },
-      { name: "overview", hint: "summary" }
-    ]
-  },
-  {
-    name: "AI",
-    tools: [
-      { name: "context", hint: "smart-ctx" },
-      { name: "plan", hint: "generate" },
-      { name: "tasks", hint: "breakdown" },
-      { name: "embeddings", hint: "vectors" }
-    ]
-  },
-  {
-    name: "Notion",
-    tools: [
-      { name: "create_page", hint: "new-page" },
-      { name: "search_pages", hint: "find" },
-      { name: "list_databases", hint: "list-dbs" },
-      { name: "get_page", hint: "get" },
-      { name: "query_database", hint: "query-db" },
-      { name: "update_page", hint: "edit" },
-      { name: "stats", hint: "overview" },
-      { name: "activity", hint: "recent" },
-      { name: "knowledge", hint: "insights" },
-      { name: "summary", hint: "brief" }
-    ]
-  }
-];
-function generateToolCatalog(format = "grouped", category) {
-  let categories = TOOL_CATALOG;
-  if (category) {
-    const filtered = TOOL_CATALOG.filter((c) => c.name.toLowerCase() === category.toLowerCase());
-    if (filtered.length > 0) {
-      categories = filtered;
-    }
-  }
-  switch (format) {
-    case "minimal":
-      return generateMinimal(categories);
-    case "full":
-      return generateFull(categories);
-    case "grouped":
-    default:
-      return generateGrouped(categories);
-  }
-}
-function generateGrouped(categories) {
-  return categories.map((cat) => {
-    const tools = cat.tools.map((t) => t.hint ? `${t.name}(${t.hint})` : t.name).join(" ");
-    return `${cat.name}: ${tools}`;
-  }).join("\n");
-}
-function generateMinimal(categories) {
-  return categories.map((cat) => {
-    const tools = cat.tools.map((t) => t.name).join("|");
-    return `${cat.name}:${tools}`;
-  }).join("\n");
-}
-function generateFull(categories) {
-  const lines = [];
-  for (const cat of categories) {
-    lines.push(`## ${cat.name}`);
-    for (const tool of cat.tools) {
-      const prefix = cat.name.toLowerCase().replace(/\s+/g, "_");
-      const fullName = `${prefix}_${tool.name}`;
-      lines.push(`- ${fullName}: ${tool.hint || "standard CRUD"}`);
-    }
-  }
-  return lines.join("\n");
-}
-function getCoreToolsHint() {
-  return `Session: init(start) smart(each-msg) capture(save) recall(find) remember(quick)`;
-}
+**session actions:**
+- \`capture\` - Save decision/insight/task (requires: event_type, title, content)
+- \`capture_lesson\` - Save lesson from mistake (requires: title, category, trigger, impact, prevention)
+- \`get_lessons\` - Retrieve relevant lessons (optional: query, category, severity)
+- \`recall\` - Natural language memory recall (requires: query)
+- \`remember\` - Quick save to memory (requires: content)
+- \`user_context\` - Get user preferences/style
+- \`summary\` - Workspace summary
+- \`compress\` - Compress long conversation
+- \`delta\` - Changes since timestamp
+- \`smart_search\` - Context-enriched search
+- \`decision_trace\` - Trace decision provenance
+
+**memory actions:**
+- Event CRUD: \`create_event\`, \`get_event\`, \`update_event\`, \`delete_event\`, \`list_events\`, \`distill_event\`
+- Node CRUD: \`create_node\`, \`get_node\`, \`update_node\`, \`delete_node\`, \`list_nodes\`, \`supersede_node\`
+- Query: \`search\`, \`decisions\`, \`timeline\`, \`summary\`
+
+**graph actions:**
+- Analysis: \`dependencies\`, \`impact\`, \`call_path\`, \`related\`, \`path\`
+- Quality: \`circular_dependencies\`, \`unused_code\`, \`contradictions\`
+- Management: \`ingest\`, \`decisions\`
+
+See full documentation: https://contextstream.io/docs/mcp/tools
+`.trim();
+var CONTEXTSTREAM_RULES_MINIMAL = `
+## ContextStream Rules
+
+<contextstream_rules>
+1. **SIMPLE UTILITY?** (list/show/version) \u2192 Just execute, skip context calls
+2. **CODING TASK?** \u2192 init \u2192 context \u2192 work \u2192 capture
+3. **SEARCH FIRST:** Before Glob/Grep/Read \u2192 \`search(mode="hybrid")\` FIRST
+</contextstream_rules>
+
+**Display this block at the start of responses to keep rules in context.**
+
+---
+
+## ContextStream v0.4.x (Hooks Enforced)
+
+Rules Version: ${RULES_VERSION}
+**Note:** PreToolUse hooks block Glob/Grep/Search when ContextStream is available.
+
+### For Coding Tasks
+
+| Action | Tool Call |
+|--------|-----------|
+| **1st message** | \`init(folder_path="<cwd>", context_hint="<msg>")\` then \`context(...)\` |
+| **2nd+ messages** | \`context(user_message="<msg>", format="minified", max_tokens=400)\` |
+| **Code search** | \`search(mode="hybrid", query="...")\` \u2014 BEFORE any local tools |
+| **Save decisions** | \`session(action="capture", event_type="decision", ...)\` |
+
+### Search Modes
+
+| Mode | Use Case |
+|------|----------|
+| \`hybrid\` | General code search (default) |
+| \`keyword\` | Exact symbol/string match |
+| \`exhaustive\` | Find ALL matches (grep-like) |
+| \`semantic\` | Conceptual questions |
+
+### Why ContextStream First?
+
+\u274C **WRONG:** \`Grep \u2192 Read \u2192 Read \u2192 Read\` (4+ tool calls, slow)
+\u2705 **CORRECT:** \`search(mode="hybrid")\` (1 call, returns context)
+
+ContextStream search is **indexed** and returns semantic matches + context in ONE call.
+
+### Quick Reference
+
+| Tool | Example |
+|------|---------|
+| \`search\` | \`search(mode="hybrid", query="auth", limit=3)\` |
+| \`session\` | \`session(action="capture", event_type="decision", title="...", content="...")\` |
+| \`memory\` | \`memory(action="list_events", limit=10)\` |
+| \`graph\` | \`graph(action="dependencies", file_path="...")\` |
 
-// src/hooks-config.ts
-import * as fs4 from "node:fs/promises";
-import * as path5 from "node:path";
-import { homedir as homedir2 } from "node:os";
-function getClaudeSettingsPath(scope, projectPath) {
-  if (scope === "user") {
-    return path5.join(homedir2(), ".claude", "settings.json");
-  }
-  if (!projectPath) {
-    throw new Error("projectPath required for project scope");
-  }
-  return path5.join(projectPath, ".claude", "settings.json");
-}
-function getHooksDir() {
-  return path5.join(homedir2(), ".claude", "hooks");
-}
-function buildHooksConfig(options) {
-  const userPromptHooks = [
-    {
-      matcher: "*",
-      hooks: [
-        {
-          type: "command",
-          command: "npx @contextstream/mcp-server hook user-prompt-submit",
-          timeout: 5
-        }
-      ]
-    }
-  ];
-  if (options?.includeMediaAware !== false) {
-    userPromptHooks.push({
-      matcher: "*",
-      hooks: [
-        {
-          type: "command",
-          command: "npx @contextstream/mcp-server hook media-aware",
-          timeout: 5
-        }
-      ]
-    });
-  }
-  const config = {
-    PreToolUse: [
-      {
-        matcher: "Glob|Grep|Search|Task|EnterPlanMode",
-        hooks: [
-          {
-            type: "command",
-            command: "npx @contextstream/mcp-server hook pre-tool-use",
-            timeout: 5
-          }
-        ]
-      }
-    ],
-    UserPromptSubmit: userPromptHooks
-  };
-  if (options?.includePreCompact) {
-    config.PreCompact = [
-      {
-        // Match both manual (/compact) and automatic compaction
-        matcher: "*",
-        hooks: [
-          {
-            type: "command",
-            command: "npx @contextstream/mcp-server hook pre-compact",
-            timeout: 10
-          }
-        ]
-      }
-    ];
-  }
-  const postToolUseHooks = [];
-  if (options?.includePostWrite !== false) {
-    postToolUseHooks.push({
-      matcher: "Edit|Write|NotebookEdit",
-      hooks: [
-        {
-          type: "command",
-          command: "npx @contextstream/mcp-server hook post-write",
-          timeout: 10
-        }
-      ]
-    });
-  }
-  if (options?.includeAutoRules !== false) {
-    postToolUseHooks.push({
-      matcher: "mcp__contextstream__init|mcp__contextstream__context",
-      hooks: [
-        {
-          type: "command",
-          command: "npx @contextstream/mcp-server hook auto-rules",
-          timeout: 15
-        }
-      ]
-    });
-  }
-  if (postToolUseHooks.length > 0) {
-    config.PostToolUse = postToolUseHooks;
-  }
-  return config;
-}
-async function installHookScripts(options) {
-  const hooksDir = getHooksDir();
-  await fs4.mkdir(hooksDir, { recursive: true });
-  const result = {
-    preToolUse: "npx @contextstream/mcp-server hook pre-tool-use",
-    userPrompt: "npx @contextstream/mcp-server hook user-prompt-submit"
-  };
-  if (options?.includePreCompact) {
-    result.preCompact = "npx @contextstream/mcp-server hook pre-compact";
-  }
-  if (options?.includeMediaAware !== false) {
-    result.mediaAware = "npx @contextstream/mcp-server hook media-aware";
-  }
-  if (options?.includeAutoRules !== false) {
-    result.autoRules = "npx @contextstream/mcp-server hook auto-rules";
-  }
-  return result;
-}
-async function readClaudeSettings(scope, projectPath) {
-  const settingsPath = getClaudeSettingsPath(scope, projectPath);
-  try {
-    const content = await fs4.readFile(settingsPath, "utf-8");
-    return JSON.parse(content);
-  } catch {
-    return {};
-  }
-}
-async function writeClaudeSettings(settings, scope, projectPath) {
-  const settingsPath = getClaudeSettingsPath(scope, projectPath);
-  const dir = path5.dirname(settingsPath);
-  await fs4.mkdir(dir, { recursive: true });
-  await fs4.writeFile(settingsPath, JSON.stringify(settings, null, 2));
-}
-function mergeHooksIntoSettings(existingSettings, newHooks) {
-  const settings = { ...existingSettings };
-  const existingHooks = settings.hooks || {};
-  for (const [hookType, matchers] of Object.entries(newHooks || {})) {
-    if (!matchers) continue;
-    const existing = existingHooks?.[hookType] || [];
-    const filtered = existing.filter((m) => {
-      return !m.hooks?.some((h) => h.command?.includes("contextstream"));
-    });
-    existingHooks[hookType] = [...filtered, ...matchers];
-  }
-  settings.hooks = existingHooks;
-  return settings;
-}
-async function installClaudeCodeHooks(options) {
-  const result = { scripts: [], settings: [] };
-  result.scripts.push(
-    "npx @contextstream/mcp-server hook pre-tool-use",
-    "npx @contextstream/mcp-server hook user-prompt-submit"
-  );
-  if (options.includePreCompact) {
-    result.scripts.push("npx @contextstream/mcp-server hook pre-compact");
-  }
-  if (options.includeMediaAware !== false) {
-    result.scripts.push("npx @contextstream/mcp-server hook media-aware");
-  }
-  if (options.includePostWrite !== false) {
-    result.scripts.push("npx @contextstream/mcp-server hook post-write");
-  }
-  if (options.includeAutoRules !== false) {
-    result.scripts.push("npx @contextstream/mcp-server hook auto-rules");
-  }
-  const hooksConfig = buildHooksConfig({
-    includePreCompact: options.includePreCompact,
-    includeMediaAware: options.includeMediaAware,
-    includePostWrite: options.includePostWrite,
-    includeAutoRules: options.includeAutoRules
-  });
-  if (options.scope === "user" || options.scope === "both") {
-    const settingsPath = getClaudeSettingsPath("user");
-    if (!options.dryRun) {
-      const existing = await readClaudeSettings("user");
-      const merged = mergeHooksIntoSettings(existing, hooksConfig);
-      await writeClaudeSettings(merged, "user");
-    }
-    result.settings.push(settingsPath);
-  }
-  if ((options.scope === "project" || options.scope === "both") && options.projectPath) {
-    const settingsPath = getClaudeSettingsPath("project", options.projectPath);
-    if (!options.dryRun) {
-      const existing = await readClaudeSettings("project", options.projectPath);
-      const merged = mergeHooksIntoSettings(existing, hooksConfig);
-      await writeClaudeSettings(merged, "project", options.projectPath);
-    }
-    result.settings.push(settingsPath);
-  }
-  return result;
-}
-function getIndexStatusPath() {
-  return path5.join(homedir2(), ".contextstream", "indexed-projects.json");
-}
-async function readIndexStatus() {
-  const statusPath = getIndexStatusPath();
-  try {
-    const content = await fs4.readFile(statusPath, "utf-8");
-    return JSON.parse(content);
-  } catch {
-    return { version: 1, projects: {} };
+### \u{1F680} FAST PATH: Simple Utility Operations
+
+**For simple utility commands, SKIP the ceremony and just execute directly:**
+
+| Command Type | Just Call | Skip |
+|--------------|-----------|------|
+| List workspaces | \`workspace(action="list")\` | init, context, capture |
+| List projects | \`project(action="list")\` | init, context, capture |
+| Show version | \`help(action="version")\` | init, context, capture |
+| List reminders | \`reminder(action="list")\` | init, context, capture |
+| Check auth | \`help(action="auth")\` | init, context, capture |
+
+**Detect simple operations by these patterns:**
+- "list ...", "show ...", "what are my ...", "get ..."
+- Single-action queries with no context dependency
+- User just wants data, not analysis or coding help
+
+**DO NOT add overhead for utility operations:**
+- \u274C Don't call init just to list workspaces
+- \u274C Don't call context for simple queries
+- \u274C Don't capture "listed workspaces" as an event (that's noise)
+
+**Use full context ceremony ONLY for:**
+- Coding tasks (edit, create, refactor, debug)
+- Search/discovery (finding code, understanding architecture)
+- Tasks where past decisions or lessons matter
+
+### Lessons (Past Mistakes)
+
+- After \`init\`: Check for \`lessons\` field and apply before work
+- Before risky work: \`session(action="get_lessons", query="<topic>")\`
+- On mistakes: \`session(action="capture_lesson", title="...", trigger="...", impact="...", prevention="...")\`
+
+### Context Pressure & Compaction
+
+- If \`context\` returns high/critical \`context_pressure\`: call \`session(action="capture", ...)\` to save state
+- PreCompact hooks automatically save snapshots before compaction (if installed)
+
+### Enhanced Context (Warnings)
+
+\`context\` returns server-side \`warnings\` for lessons, risky actions, and breaking changes.
+When warnings are present: **STOP**, acknowledge them, explain mitigation, then proceed.
+
+### Automatic Context Restoration
+
+**Context restoration is now enabled by default.** Every \`init\` call automatically:
+- Restores context from recent snapshots (if available)
+- Returns \`restored_context\` field with snapshot data
+- Sets \`is_post_compact=true\` in response when restoration occurs
+
+**No special handling needed after compaction** - just call \`init\` normally.
+
+To disable automatic restoration:
+- Pass \`is_post_compact=false\` in the API call
+- Or set \`CONTEXTSTREAM_RESTORE_CONTEXT=false\` environment variable
+
+### Notices - MUST HANDLE IMMEDIATELY
+
+- **[VERSION_NOTICE]**: Tell the user about the update and command to run
+- **[RULES_NOTICE]**: Run \`generate_rules(overwrite_existing=true)\` to update
+- **[LESSONS_WARNING]**: Read lessons, tell user about them, explain how you'll avoid past mistakes
+
+### Plans & Tasks
+
+When user asks for a plan, use ContextStream (not EnterPlanMode):
+1. \`session(action="capture_plan", title="...", steps=[...])\`
+2. \`memory(action="create_task", title="...", plan_id="<id>")\`
+
+### Workspace-Only Mode (Multi-Project Folders)
+
+If working in a parent folder containing multiple projects:
+\`\`\`
+init(folder_path="...", skip_project_creation=true)
+\`\`\`
+
+This enables workspace-level memory and context without project-specific indexing.
+Use for monorepos or folders with multiple independent projects.
+
+Full docs: https://contextstream.io/docs/mcp/tools
+`.trim();
+var TEMPLATES = {
+  codex: {
+    filename: "AGENTS.md",
+    description: "Codex CLI agent instructions",
+    build: (rules) => `# Codex CLI Instructions
+${rules}
+`
+  },
+  cursor: {
+    filename: ".cursorrules",
+    description: "Cursor AI rules",
+    build: (rules) => `# Cursor Rules
+${rules}
+`
+  },
+  cline: {
+    filename: ".clinerules",
+    description: "Cline AI rules",
+    build: (rules) => `# Cline Rules
+${rules}
+`
+  },
+  kilo: {
+    filename: ".kilocode/rules/contextstream.md",
+    description: "Kilo Code AI rules",
+    build: (rules) => `# Kilo Code Rules
+${rules}
+`
+  },
+  roo: {
+    filename: ".roo/rules/contextstream.md",
+    description: "Roo Code AI rules",
+    build: (rules) => `# Roo Code Rules
+${rules}
+`
+  },
+  claude: {
+    filename: "CLAUDE.md",
+    description: "Claude Code instructions",
+    build: (rules) => `# Claude Code Instructions
+${rules}
+`
+  },
+  aider: {
+    filename: ".aider.conf.yml",
+    description: "Aider configuration with system prompt",
+    build: (rules) => `# Aider Configuration
+# Note: Aider uses different config format - this adds to the system prompt
+
+# Add ContextStream guidance to conventions
+conventions: |
+${rules.split("\n").map((line) => "  " + line).join("\n")}
+`
+  },
+  antigravity: {
+    filename: "GEMINI.md",
+    description: "Google Antigravity AI rules",
+    build: (rules) => `# Antigravity Agent Rules
+${rules}
+`
   }
+};
+function getAvailableEditors() {
+  return Object.keys(TEMPLATES);
 }
-async function writeIndexStatus(status) {
-  const statusPath = getIndexStatusPath();
-  const dir = path5.dirname(statusPath);
-  await fs4.mkdir(dir, { recursive: true });
-  await fs4.writeFile(statusPath, JSON.stringify(status, null, 2));
-}
-async function markProjectIndexed(projectPath, options) {
-  const status = await readIndexStatus();
-  const resolvedPath = path5.resolve(projectPath);
-  status.projects[resolvedPath] = {
-    indexed_at: (/* @__PURE__ */ new Date()).toISOString(),
-    project_id: options?.project_id,
-    project_name: options?.project_name
-  };
-  await writeIndexStatus(status);
-}
-function getClineHooksDir(scope, projectPath) {
-  if (scope === "global") {
-    return path5.join(homedir2(), "Documents", "Cline", "Rules", "Hooks");
-  }
-  if (!projectPath) {
-    throw new Error("projectPath required for project scope");
-  }
-  return path5.join(projectPath, ".clinerules", "hooks");
+function getTemplate(editor) {
+  return TEMPLATES[editor.toLowerCase()] || null;
 }
-var CLINE_HOOK_WRAPPER = (hookName) => `#!/bin/bash
-# ContextStream ${hookName} Hook Wrapper for Cline/Roo/Kilo Code
-# Calls the Node.js hook via npx
-exec npx @contextstream/mcp-server hook ${hookName}
+function generateRuleContent(editor, options) {
+  const template = getTemplate(editor);
+  if (!template) return null;
+  const mode = options?.mode || "dynamic";
+  const rules = mode === "full" ? CONTEXTSTREAM_RULES_FULL : mode === "minimal" ? CONTEXTSTREAM_RULES_MINIMAL : CONTEXTSTREAM_RULES_DYNAMIC;
+  let content = template.build(rules);
+  if (options?.workspaceName || options?.projectName) {
+    const header = `
+# Workspace: ${options.workspaceName || "Unknown"}
+${options.projectName ? `# Project: ${options.projectName}` : ""}
+${options.workspaceId ? `# Workspace ID: ${options.workspaceId}` : ""}
+
 `;
-async function installClineHookScripts(options) {
-  const hooksDir = getClineHooksDir(options.scope, options.projectPath);
-  await fs4.mkdir(hooksDir, { recursive: true });
-  const preToolUsePath = path5.join(hooksDir, "PreToolUse");
-  const userPromptPath = path5.join(hooksDir, "UserPromptSubmit");
-  const postToolUsePath = path5.join(hooksDir, "PostToolUse");
-  await fs4.writeFile(preToolUsePath, CLINE_HOOK_WRAPPER("pre-tool-use"), { mode: 493 });
-  await fs4.writeFile(userPromptPath, CLINE_HOOK_WRAPPER("user-prompt-submit"), { mode: 493 });
-  const result = {
-    preToolUse: preToolUsePath,
-    userPromptSubmit: userPromptPath
-  };
-  if (options.includePostWrite !== false) {
-    await fs4.writeFile(postToolUsePath, CLINE_HOOK_WRAPPER("post-write"), { mode: 493 });
-    result.postToolUse = postToolUsePath;
-  }
-  return result;
-}
-function getRooCodeHooksDir(scope, projectPath) {
-  if (scope === "global") {
-    return path5.join(homedir2(), ".roo", "hooks");
-  }
-  if (!projectPath) {
-    throw new Error("projectPath required for project scope");
-  }
-  return path5.join(projectPath, ".roo", "hooks");
-}
-async function installRooCodeHookScripts(options) {
-  const hooksDir = getRooCodeHooksDir(options.scope, options.projectPath);
-  await fs4.mkdir(hooksDir, { recursive: true });
-  const preToolUsePath = path5.join(hooksDir, "PreToolUse");
-  const userPromptPath = path5.join(hooksDir, "UserPromptSubmit");
-  const postToolUsePath = path5.join(hooksDir, "PostToolUse");
-  await fs4.writeFile(preToolUsePath, CLINE_HOOK_WRAPPER("pre-tool-use"), { mode: 493 });
-  await fs4.writeFile(userPromptPath, CLINE_HOOK_WRAPPER("user-prompt-submit"), { mode: 493 });
-  const result = {
-    preToolUse: preToolUsePath,
-    userPromptSubmit: userPromptPath
-  };
-  if (options.includePostWrite !== false) {
-    await fs4.writeFile(postToolUsePath, CLINE_HOOK_WRAPPER("post-write"), { mode: 493 });
-    result.postToolUse = postToolUsePath;
+    content = header + content;
   }
-  return result;
-}
-function getKiloCodeHooksDir(scope, projectPath) {
-  if (scope === "global") {
-    return path5.join(homedir2(), ".kilocode", "hooks");
+  if (options?.additionalRules) {
+    content += "\n\n## Project-Specific Rules\n\n" + options.additionalRules;
   }
-  if (!projectPath) {
-    throw new Error("projectPath required for project scope");
+  if (editor.toLowerCase() === "claude") {
+    content = applyMcpToolPrefix(content, `mcp__${DEFAULT_CLAUDE_MCP_SERVER_NAME}__`);
   }
-  return path5.join(projectPath, ".kilocode", "hooks");
-}
-async function installKiloCodeHookScripts(options) {
-  const hooksDir = getKiloCodeHooksDir(options.scope, options.projectPath);
-  await fs4.mkdir(hooksDir, { recursive: true });
-  const preToolUsePath = path5.join(hooksDir, "PreToolUse");
-  const userPromptPath = path5.join(hooksDir, "UserPromptSubmit");
-  const postToolUsePath = path5.join(hooksDir, "PostToolUse");
-  await fs4.writeFile(preToolUsePath, CLINE_HOOK_WRAPPER("pre-tool-use"), { mode: 493 });
-  await fs4.writeFile(userPromptPath, CLINE_HOOK_WRAPPER("user-prompt-submit"), { mode: 493 });
-  const result = {
-    preToolUse: preToolUsePath,
-    userPromptSubmit: userPromptPath
+  return {
+    filename: template.filename,
+    content: content.trim() + "\n"
   };
-  if (options.includePostWrite !== false) {
-    await fs4.writeFile(postToolUsePath, CLINE_HOOK_WRAPPER("post-write"), { mode: 493 });
-    result.postToolUse = postToolUsePath;
-  }
-  return result;
 }
-function getCursorHooksConfigPath(scope, projectPath) {
-  if (scope === "global") {
-    return path5.join(homedir2(), ".cursor", "hooks.json");
-  }
-  if (!projectPath) {
-    throw new Error("projectPath required for project scope");
-  }
-  return path5.join(projectPath, ".cursor", "hooks.json");
+function generateAllRuleFiles(options) {
+  return getAvailableEditors().map((editor) => {
+    const result = generateRuleContent(editor, options);
+    if (!result) return null;
+    return { editor, ...result };
+  }).filter((r) => r !== null);
 }
-function getCursorHooksDir(scope, projectPath) {
-  if (scope === "global") {
-    return path5.join(homedir2(), ".cursor", "hooks");
+
+// src/tool-catalog.ts
+var TOOL_CATALOG = [
+  {
+    name: "Session",
+    tools: [
+      { name: "init", hint: "start-conv" },
+      { name: "smart", hint: "each-msg" },
+      { name: "capture", hint: "save" },
+      { name: "recall", hint: "find" },
+      { name: "remember", hint: "quick" },
+      { name: "compress", hint: "end" },
+      { name: "summary", hint: "brief" },
+      { name: "delta", hint: "changes" },
+      { name: "get_lessons", hint: "learn" },
+      { name: "capture_lesson", hint: "mistake" },
+      { name: "get_user_context", hint: "prefs" },
+      { name: "smart_search", hint: "deep-find" },
+      // Plan actions
+      { name: "capture_plan", hint: "save-plan" },
+      { name: "get_plan", hint: "get-plan" },
+      { name: "update_plan", hint: "edit-plan" },
+      { name: "list_plans", hint: "list-plans" }
+    ]
+  },
+  {
+    name: "Search",
+    tools: [
+      { name: "semantic", hint: "meaning" },
+      { name: "hybrid", hint: "combo" },
+      { name: "keyword", hint: "exact" },
+      { name: "pattern", hint: "code" }
+    ]
+  },
+  {
+    name: "Memory",
+    tools: [
+      { name: "create_event", hint: "new" },
+      { name: "list_events", hint: "list" },
+      { name: "get_event", hint: "get" },
+      { name: "update_event", hint: "edit" },
+      { name: "delete_event", hint: "rm" },
+      { name: "search", hint: "find" },
+      { name: "decisions", hint: "choices" },
+      { name: "timeline", hint: "history" },
+      { name: "distill_event", hint: "extract" },
+      // Task actions
+      { name: "create_task", hint: "new-task" },
+      { name: "get_task", hint: "get-task" },
+      { name: "update_task", hint: "edit-task" },
+      { name: "delete_task", hint: "rm-task" },
+      { name: "list_tasks", hint: "list-tasks" },
+      { name: "reorder_tasks", hint: "sort-tasks" }
+    ]
+  },
+  {
+    name: "Knowledge",
+    tools: [
+      { name: "create_node", hint: "new" },
+      { name: "list_nodes", hint: "list" },
+      { name: "get_node", hint: "get" },
+      { name: "update_node", hint: "edit" },
+      { name: "delete_node", hint: "rm" },
+      { name: "supersede_node", hint: "replace" }
+    ]
+  },
+  {
+    name: "Graph",
+    tools: [
+      { name: "related", hint: "links" },
+      { name: "path", hint: "trace" },
+      { name: "decisions", hint: "choices" },
+      { name: "dependencies", hint: "deps" },
+      { name: "ingest", hint: "build" },
+      { name: "impact", hint: "changes" },
+      { name: "contradictions", hint: "conflicts" }
+    ]
+  },
+  {
+    name: "Media",
+    tools: [
+      { name: "index", hint: "add-media" },
+      { name: "status", hint: "progress" },
+      { name: "search", hint: "find-clip" },
+      { name: "get_clip", hint: "get-segment" },
+      { name: "list", hint: "browse" },
+      { name: "delete", hint: "remove" }
+    ]
+  },
+  {
+    name: "Workspace",
+    tools: [
+      { name: "list", hint: "" },
+      { name: "get", hint: "" },
+      { name: "create", hint: "" },
+      { name: "associate", hint: "link-folder" },
+      { name: "bootstrap", hint: "new-ws" }
+    ]
+  },
+  {
+    name: "Project",
+    tools: [
+      { name: "list", hint: "" },
+      { name: "get", hint: "" },
+      { name: "create", hint: "" },
+      { name: "index", hint: "scan-code" },
+      { name: "files", hint: "list-files" },
+      { name: "overview", hint: "summary" }
+    ]
+  },
+  {
+    name: "AI",
+    tools: [
+      { name: "context", hint: "smart-ctx" },
+      { name: "plan", hint: "generate" },
+      { name: "tasks", hint: "breakdown" },
+      { name: "embeddings", hint: "vectors" }
+    ]
+  },
+  {
+    name: "Notion",
+    tools: [
+      { name: "create_page", hint: "new-page" },
+      { name: "search_pages", hint: "find" },
+      { name: "list_databases", hint: "list-dbs" },
+      { name: "get_page", hint: "get" },
+      { name: "query_database", hint: "query-db" },
+      { name: "update_page", hint: "edit" },
+      { name: "stats", hint: "overview" },
+      { name: "activity", hint: "recent" },
+      { name: "knowledge", hint: "insights" },
+      { name: "summary", hint: "brief" }
+    ]
   }
-  if (!projectPath) {
-    throw new Error("projectPath required for project scope");
+];
+function generateToolCatalog(format = "grouped", category) {
+  let categories = TOOL_CATALOG;
+  if (category) {
+    const filtered = TOOL_CATALOG.filter((c) => c.name.toLowerCase() === category.toLowerCase());
+    if (filtered.length > 0) {
+      categories = filtered;
+    }
   }
-  return path5.join(projectPath, ".cursor", "hooks");
-}
-async function readCursorHooksConfig(scope, projectPath) {
-  const configPath = getCursorHooksConfigPath(scope, projectPath);
-  try {
-    const content = await fs4.readFile(configPath, "utf-8");
-    return JSON.parse(content);
-  } catch {
-    return { version: 1, hooks: {} };
+  switch (format) {
+    case "minimal":
+      return generateMinimal(categories);
+    case "full":
+      return generateFull(categories);
+    case "grouped":
+    default:
+      return generateGrouped(categories);
   }
 }
-async function writeCursorHooksConfig(config, scope, projectPath) {
-  const configPath = getCursorHooksConfigPath(scope, projectPath);
-  const dir = path5.dirname(configPath);
-  await fs4.mkdir(dir, { recursive: true });
-  await fs4.writeFile(configPath, JSON.stringify(config, null, 2));
+function generateGrouped(categories) {
+  return categories.map((cat) => {
+    const tools = cat.tools.map((t) => t.hint ? `${t.name}(${t.hint})` : t.name).join(" ");
+    return `${cat.name}: ${tools}`;
+  }).join("\n");
 }
-async function installCursorHookScripts(options) {
-  const hooksDir = getCursorHooksDir(options.scope, options.projectPath);
-  await fs4.mkdir(hooksDir, { recursive: true });
-  const existingConfig = await readCursorHooksConfig(options.scope, options.projectPath);
-  const filterContextStreamHooks = (hooks) => {
-    if (!hooks) return [];
-    return hooks.filter((h) => {
-      const hook = h;
-      return !hook.command?.includes("contextstream");
-    });
-  };
-  const filteredPreToolUse = filterContextStreamHooks(existingConfig.hooks.preToolUse);
-  const filteredBeforeSubmit = filterContextStreamHooks(existingConfig.hooks.beforeSubmitPrompt);
-  const config = {
-    version: 1,
-    hooks: {
-      ...existingConfig.hooks,
-      preToolUse: [
-        ...filteredPreToolUse,
-        {
-          command: "npx @contextstream/mcp-server hook pre-tool-use",
-          type: "command",
-          timeout: 5,
-          matcher: { tool_name: "Glob|Grep|search_files|list_files|ripgrep" }
-        }
-      ],
-      beforeSubmitPrompt: [
-        ...filteredBeforeSubmit,
-        {
-          command: "npx @contextstream/mcp-server hook user-prompt-submit",
-          type: "command",
-          timeout: 5
-        }
-      ]
-    }
-  };
-  await writeCursorHooksConfig(config, options.scope, options.projectPath);
-  const configPath = getCursorHooksConfigPath(options.scope, options.projectPath);
-  return {
-    preToolUse: "npx @contextstream/mcp-server hook pre-tool-use",
-    beforeSubmitPrompt: "npx @contextstream/mcp-server hook user-prompt-submit",
-    config: configPath
-  };
+function generateMinimal(categories) {
+  return categories.map((cat) => {
+    const tools = cat.tools.map((t) => t.name).join("|");
+    return `${cat.name}:${tools}`;
+  }).join("\n");
 }
-async function installEditorHooks(options) {
-  const { editor, scope, projectPath, includePreCompact, includePostWrite } = options;
-  switch (editor) {
-    case "claude": {
-      if (scope === "project" && !projectPath) {
-        throw new Error("projectPath required for project scope");
-      }
-      const scripts = await installHookScripts({ includePreCompact });
-      const hooksConfig = buildHooksConfig({ includePreCompact, includePostWrite });
-      const settingsScope = scope === "global" ? "user" : "project";
-      const existing = await readClaudeSettings(settingsScope, projectPath);
-      const merged = mergeHooksIntoSettings(existing, hooksConfig);
-      await writeClaudeSettings(merged, settingsScope, projectPath);
-      const installed = [scripts.preToolUse, scripts.userPrompt];
-      if (scripts.preCompact) installed.push(scripts.preCompact);
-      return {
-        editor: "claude",
-        installed,
-        hooksDir: getHooksDir()
-      };
-    }
-    case "cline": {
-      const scripts = await installClineHookScripts({ scope, projectPath, includePostWrite });
-      const installed = [scripts.preToolUse, scripts.userPromptSubmit];
-      if (scripts.postToolUse) installed.push(scripts.postToolUse);
-      return {
-        editor: "cline",
-        installed,
-        hooksDir: getClineHooksDir(scope, projectPath)
-      };
-    }
-    case "roo": {
-      const scripts = await installRooCodeHookScripts({ scope, projectPath, includePostWrite });
-      const installed = [scripts.preToolUse, scripts.userPromptSubmit];
-      if (scripts.postToolUse) installed.push(scripts.postToolUse);
-      return {
-        editor: "roo",
-        installed,
-        hooksDir: getRooCodeHooksDir(scope, projectPath)
-      };
-    }
-    case "kilo": {
-      const scripts = await installKiloCodeHookScripts({ scope, projectPath, includePostWrite });
-      const installed = [scripts.preToolUse, scripts.userPromptSubmit];
-      if (scripts.postToolUse) installed.push(scripts.postToolUse);
-      return {
-        editor: "kilo",
-        installed,
-        hooksDir: getKiloCodeHooksDir(scope, projectPath)
-      };
-    }
-    case "cursor": {
-      const scripts = await installCursorHookScripts({ scope, projectPath });
-      return {
-        editor: "cursor",
-        installed: [scripts.preToolUse, scripts.beforeSubmitPrompt],
-        hooksDir: getCursorHooksDir(scope, projectPath)
-      };
+function generateFull(categories) {
+  const lines = [];
+  for (const cat of categories) {
+    lines.push(`## ${cat.name}`);
+    for (const tool of cat.tools) {
+      const prefix = cat.name.toLowerCase().replace(/\s+/g, "_");
+      const fullName = `${prefix}_${tool.name}`;
+      lines.push(`- ${fullName}: ${tool.hint || "standard CRUD"}`);
     }
-    default:
-      throw new Error(`Unsupported editor: ${editor}`);
   }
+  return lines.join("\n");
 }
-async function installAllEditorHooks(options) {
-  const editors = options.editors || ["claude", "cline", "roo", "kilo", "cursor"];
-  const results = [];
-  for (const editor of editors) {
-    try {
-      const result = await installEditorHooks({
-        editor,
-        scope: options.scope,
-        projectPath: options.projectPath,
-        includePreCompact: options.includePreCompact,
-        includePostWrite: options.includePostWrite
-      });
-      results.push(result);
-    } catch (error) {
-      console.error(`Failed to install hooks for ${editor}:`, error);
-    }
-  }
-  return results;
+function getCoreToolsHint() {
+  return `Session: init(start) smart(each-msg) capture(save) recall(find) remember(quick)`;
 }
 
+// src/tools.ts
+init_hooks_config();
+
 // src/token-savings.ts
 var TOKEN_SAVINGS_FORMULA_VERSION = 1;
 var MAX_CHARS_PER_EVENT = 2e7;
@@ -12122,6 +13222,28 @@ ${LESSONS_REMINDER_PREFIX}
 ${lessonLines.join("\n")}
 \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501`;
 }
+var REMEMBER_REMINDER_PREFIX = `
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+\u{1F4CC} USER PREFERENCES - MUST FOLLOW
+These are user-specified preferences that MUST be checked and followed.
+\u26A0\uFE0F IMPORTANT: Always verify your actions align with these preferences.
+`;
+function generateRememberReminder(result) {
+  const rememberItems = result.remember_items;
+  if (!rememberItems || rememberItems.length === 0) {
+    return "";
+  }
+  const itemLines = rememberItems.slice(0, 5).map((item, i) => {
+    const importance = item.importance === "critical" ? "\u{1F6A8}" : "\u{1F4CC}";
+    const content = item.content || "";
+    return `${i + 1}. ${importance} ${content.slice(0, 150)}`;
+  });
+  return `
+
+${REMEMBER_REMINDER_PREFIX}
+${itemLines.join("\n")}
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501`;
+}
 function generateRulesUpdateWarning(rulesNotice) {
   if (!rulesNotice || rulesNotice.status !== "behind" && rulesNotice.status !== "missing") {
     return "";
@@ -15925,6 +17047,10 @@ ${noticeLines.filter(Boolean).join("\n")}`;
       if (lessonsReminder) {
         text = `${text}${lessonsReminder}`;
       }
+      const rememberReminder = generateRememberReminder(result);
+      if (rememberReminder) {
+        text = `${text}${rememberReminder}`;
+      }
       if (SEARCH_RULES_REMINDER_ENABLED) {
         text = `${text}
 
@@ -23495,7 +24621,6 @@ import { createServer } from "node:http";
 import { randomUUID as randomUUID2 } from "node:crypto";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
-init_version();
 var HOST = process.env.MCP_HTTP_HOST || "0.0.0.0";
 var PORT = Number.parseInt(process.env.MCP_HTTP_PORT || "8787", 10);
 var MCP_PATH = process.env.MCP_HTTP_PATH || "/mcp";
@@ -23774,7 +24899,6 @@ async function runHttpGateway() {
 }
 
 // src/index.ts
-init_version();
 import { existsSync as existsSync8, mkdirSync as mkdirSync5, writeFileSync as writeFileSync5 } from "fs";
 import { homedir as homedir10 } from "os";
 import { join as join14 } from "path";
@@ -23785,8 +24909,6 @@ import * as path8 from "node:path";
 import { homedir as homedir5 } from "node:os";
 import { stdin, stdout } from "node:process";
 import { createInterface } from "node:readline/promises";
-init_rules_templates();
-init_version();
 
 // src/credentials.ts
 import * as fs6 from "node:fs/promises";
@@ -23851,6 +24973,7 @@ async function writeSavedCredentials(input) {
 }
 
 // src/setup.ts
+init_hooks_config();
 var EDITOR_LABELS = {
   codex: "Codex CLI",
   claude: "Claude Code",