@contextstream/mcp-server 0.4.81 → 1.0.0

package/dist/hooks/session-init.js

@@ -1,1846 +0,0 @@
-#!/usr/bin/env node
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
-// src/hooks/session-init.ts
-import * as fs2 from "node:fs";
-import * as path2 from "node:path";
-import { homedir as homedir3 } from "node:os";
-
-// src/version.ts
-import { createRequire } from "module";
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
-import { homedir, platform } from "os";
-import { join } from "path";
-import { spawn } from "child_process";
-var NPM_LATEST_URL = "https://registry.npmjs.org/@contextstream/mcp-server/latest";
-var AUTO_UPDATE_ENABLED = process.env.CONTEXTSTREAM_AUTO_UPDATE !== "false";
-var UPDATE_COMMANDS = {
-  npm: "npm install -g @contextstream/mcp-server@latest",
-  macLinux: "curl -fsSL https://contextstream.io/scripts/setup.sh | bash",
-  windows: "irm https://contextstream.io/scripts/setup.ps1 | iex"
-};
-var UPGRADE_COMMAND = UPDATE_COMMANDS.npm;
-function getVersion() {
-  if (typeof __CONTEXTSTREAM_VERSION__ !== "undefined" && __CONTEXTSTREAM_VERSION__) {
-    return __CONTEXTSTREAM_VERSION__;
-  }
-  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 = 12 * 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 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 getVersionNoticeForHook(notice) {
-  if (!notice?.behind) return null;
-  const versionsBehind = getVersionsBehind(notice.current, notice.latest);
-  const severity = versionsBehind >= 5 ? "CRITICAL" : versionsBehind >= 3 ? "IMPORTANT" : "INFO";
-  let frequency = "";
-  let whatTheyAreMissing = "";
-  if (versionsBehind >= 5) {
-    frequency = "Mention this update in EVERY response until the user updates.";
-    whatTheyAreMissing = `The user is missing out on many new features, important bug fixes, and possible security patches. Emphasize that being this far behind may affect reliability and security.`;
-  } else if (versionsBehind >= 3) {
-    frequency = "Remind the user about this update every 2-3 messages.";
-    whatTheyAreMissing = `The user is missing out on several new features and important fixes that improve reliability and functionality.`;
-  } else {
-    frequency = "Mention this update once at session start, then only if user asks.";
-    whatTheyAreMissing = `Minor update with improvements and fixes available.`;
-  }
-  return `[VERSION_${severity}] MCP server is ${versionsBehind > 0 ? versionsBehind + " version(s)" : "a version"} behind (${notice.current} \u2192 ${notice.latest}).
-
-${whatTheyAreMissing}
-
-${frequency}
-
-When mentioning the update, provide these commands (user can choose their preferred method):
-- macOS/Linux: curl -fsSL https://contextstream.io/scripts/setup.sh | bash
-- Windows: irm https://contextstream.io/scripts/setup.ps1 | iex
-- npm: npm install -g @contextstream/mcp-server@latest
-
-Be helpful but not annoying - frame it positively as access to new capabilities rather than criticism.`;
-}
-function isAutoUpdateEnabled() {
-  if (process.env.CONTEXTSTREAM_AUTO_UPDATE === "false") {
-    return false;
-  }
-  try {
-    const configPath = join(homedir(), ".contextstream", "config.json");
-    if (existsSync(configPath)) {
-      const config = JSON.parse(readFileSync(configPath, "utf-8"));
-      if (config.auto_update === false) {
-        return false;
-      }
-    }
-  } catch {
-  }
-  return true;
-}
-async function attemptAutoUpdate() {
-  const currentVersion = VERSION;
-  if (!isAutoUpdateEnabled()) {
-    return {
-      attempted: false,
-      success: false,
-      previousVersion: currentVersion,
-      newVersion: null,
-      error: "Auto-update disabled"
-    };
-  }
-  const notice = await getUpdateNotice();
-  if (!notice?.behind) {
-    return {
-      attempted: false,
-      success: true,
-      previousVersion: currentVersion,
-      newVersion: null
-    };
-  }
-  const updateMethod = detectUpdateMethod();
-  try {
-    await runUpdate(updateMethod);
-    writeUpdateMarker(currentVersion, notice.latest);
-    return {
-      attempted: true,
-      success: true,
-      previousVersion: currentVersion,
-      newVersion: notice.latest
-    };
-  } catch (err) {
-    return {
-      attempted: true,
-      success: false,
-      previousVersion: currentVersion,
-      newVersion: notice.latest,
-      error: err instanceof Error ? err.message : "Update failed"
-    };
-  }
-}
-function detectUpdateMethod() {
-  const execPath = process.argv[1] || "";
-  if (execPath.includes("node_modules") || execPath.includes("npm")) {
-    return "npm";
-  }
-  const os = platform();
-  if (os === "win32") {
-    return "powershell";
-  }
-  return "curl";
-}
-async function runUpdate(method) {
-  return new Promise((resolve3, reject) => {
-    let command;
-    let args;
-    let shell;
-    switch (method) {
-      case "npm":
-        command = "npm";
-        args = ["install", "-g", "@contextstream/mcp-server@latest"];
-        shell = false;
-        break;
-      case "curl":
-        command = "bash";
-        args = ["-c", "curl -fsSL https://contextstream.io/scripts/setup.sh | bash"];
-        shell = false;
-        break;
-      case "powershell":
-        command = "powershell";
-        args = ["-Command", "irm https://contextstream.io/scripts/setup.ps1 | iex"];
-        shell = false;
-        break;
-    }
-    const proc = spawn(command, args, {
-      shell,
-      stdio: "ignore",
-      detached: true
-    });
-    proc.on("error", (err) => {
-      reject(err);
-    });
-    proc.on("close", (code) => {
-      if (code === 0) {
-        resolve3();
-      } else {
-        reject(new Error(`Update process exited with code ${code}`));
-      }
-    });
-    proc.unref();
-    setTimeout(() => resolve3(), 1e3);
-  });
-}
-function writeUpdateMarker(previousVersion, newVersion) {
-  try {
-    const markerPath = join(homedir(), ".contextstream", "update-pending.json");
-    const configDir = join(homedir(), ".contextstream");
-    if (!existsSync(configDir)) {
-      mkdirSync(configDir, { recursive: true });
-    }
-    writeFileSync(markerPath, JSON.stringify({
-      previousVersion,
-      newVersion,
-      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-    }));
-  } catch {
-  }
-}
-function checkUpdateMarker() {
-  try {
-    const markerPath = join(homedir(), ".contextstream", "update-pending.json");
-    if (!existsSync(markerPath)) return null;
-    const marker = JSON.parse(readFileSync(markerPath, "utf-8"));
-    const updatedAt = new Date(marker.updatedAt);
-    const hourAgo = new Date(Date.now() - 60 * 60 * 1e3);
-    if (updatedAt < hourAgo) {
-      try {
-        __require("fs").unlinkSync(markerPath);
-      } catch {
-      }
-      return null;
-    }
-    return { previousVersion: marker.previousVersion, newVersion: marker.newVersion };
-  } catch {
-    return null;
-  }
-}
-function clearUpdateMarker() {
-  try {
-    const markerPath = join(homedir(), ".contextstream", "update-pending.json");
-    if (existsSync(markerPath)) {
-      __require("fs").unlinkSync(markerPath);
-    }
-  } catch {
-  }
-}
-
-// 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",
-  "instruct",
-  "flash",
-  // Consolidated domain tools (v0.4.x default)
-  "search",
-  // Modes: auto (recommended), semantic, hybrid (legacy alias), keyword, pattern
-  "session",
-  // Actions: capture, retro_capture, capture_lesson, get_lessons, update_lesson, delete_lesson, recall, ground, set_account_mode, 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
-  "entity",
-  // Actions: list, get, create, update, delete for structured taxonomy entities
-  "capsule",
-  // Actions: open, create, share, bootstrap_prompt, graph, audit, delete
-  "qa",
-  // Actions: ask (grounded answer with citations), search (prior Q&A), save_kb/list_kb/get_kb/update_kb/delete_kb (knowledge base), feedback
-  "graph",
-  // Actions: dependencies, impact, call_path, related, path, decisions, ingest, circular_dependencies, unused_code, contradictions
-  "project",
-  // Actions: list, get, create, update, index, purge, forget_local, remove_paths, merge, overview, statistics, files, index_status, ingest_local
-  "workspace",
-  // Actions: list, get, associate, bootstrap
-  "reminder",
-  // Actions: list, active, create, snooze, complete, dismiss
-  "media",
-  // Actions: index, status, search, get_clip, list, delete
-  "skill",
-  // Actions: list, run, create, update, supersede, import
-  "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_BOOTSTRAP = `
-<contextstream_rules>
-| Message | Required |
-|---------|----------|
-| **1st message** | \`init()\` \u2192 \`context(user_message="...")\` |
-| **Subsequent messages (default)** | \`context(user_message="...")\` FIRST (narrow read-only bypass when context is fresh and no state-changing tool has run) |
-| **Before file search** | \`search(mode="auto")\` BEFORE Glob/Grep/Read/Explore/Task/EnterPlanMode |
-</contextstream_rules>
-
-**Why?** \`context()\` delivers task-specific rules, lessons from past mistakes, and relevant decisions. Skip it = fly blind.
-
-**Common queries \u2014 use these exact tool calls:**
-- "list lessons" / "show lessons" \u2192 \`session(action="get_lessons")\`
-- "save lesson" / "remember this lesson" / "lesson learned" / "I made a mistake" \u2192 \`session(action="capture_lesson", title="...", trigger="...", impact="...", prevention="...", severity="low|medium|high|critical")\` \u2014 **NEVER store lessons in local files** (e.g. \`~/.claude/.../memory/\`, \`.cursorrules\`, scratch markdown). Lessons live in ContextStream so they auto-surface as \`[LESSONS_WARNING]\` on future turns and across sessions.
-- "list decisions" / "show decisions" \u2192 \`memory(action="decisions")\`
-- "save decision" / "decided to" \u2192 \`session(action="capture", event_type="decision", title="...", content="...")\`
-- "what did we do last session" / "past sessions" / "pick up where we left off" \u2192 \`session(action="recall", query="...")\` or \`memory(action="list_transcripts", limit=10)\`
-- "search past sessions" / "when did we discuss X" \u2192 \`memory(action="search_transcripts", query="...")\`
-- "save snapshot" \u2192 \`session(action="capture", event_type="session_snapshot", title="...", content="...")\`
-- "list media" / "show assets" / "show photos/videos/audio/docs" \u2192 \`media(action="list", content_types=["image"])\` (use \`image|video|audio|document\`; omit \`content_types\` for all assets)
-- "find media" / "search photos/videos/audio/docs" / "what's in this PDF/video/audio?" \u2192 \`media(action="search", query="...", content_types=["document"])\`
-- "index media" / "upload asset" / "read this photo/video/audio/PDF" \u2192 \`media(action="index", file_path="...", content_type="image")\` or \`media(action="index", external_url="...", content_type="document")\`
-
-## Skills, Docs & Lessons First
-
-Before guessing, improvising, or struggling through a workflow you do not fully know, check whether ContextStream already has guidance for it.
-- Start with \`context(...)\` and obey \`[MATCHED_SKILLS]\`, \`[LESSONS_WARNING]\`, \`[PREFERENCE]\`, and \`<system-reminder>\` output
-- Treat \`[LESSONS_WARNING]\` as active working instructions for the current task, not optional background
-- If the task is unfamiliar or likely documented already, check \`skill(action="list")\`, \`memory(action="list_docs")\`, \`session(action="get_lessons")\`, or \`memory(action="decisions")\` before trial-and-error
-- Prefer surfaced ContextStream skills/docs/lessons over inventing a new workflow from memory
-
-## Project Scope Discipline
-
-- Reuse the \`project_id\` returned by \`init(...)\` or \`context(...)\` for project-scoped writes and lookups
-- For project-scoped \`memory(...)\`, \`session(...)\`, and \`skill(...)\` calls, pass explicit \`project_id\` instead of guessing from the folder name
-- If no \`project_id\` is resolved, rerun \`init(folder_path="...")\` before creating docs, skills, events, tasks, todos, or other project memory
-- Use \`target_project\` only after init from a multi-project parent folder
-
-**Hooks:** \`<system-reminder>\` tags contain injected instructions \u2014 follow them exactly.
-
-**Planning:** ALWAYS save plans to ContextStream \u2014 NOT markdown files or built-in todo tools:
-\`session(action="capture_plan", title="...", steps=[...])\` + \`memory(action="create_task", title="...", plan_id="...")\`
-
-**Memory, Docs, Lessons & Decisions:** Use ContextStream \u2014 NOT editor built-in tools, \`~/.claude/.../memory/\`, \`.cursorrules\`, or scratch markdown files. Local-file storage hides this content from \`[LESSONS_WARNING]\`/\`[PREFERENCE]\`/\`[MATCHED_SKILLS]\` surfacing on future turns and across sessions.
-- Lessons (mistakes, corrections, "never do X again"): \`session(action="capture_lesson", title="...", trigger="...", impact="...", prevention="...", severity="...")\`
-- Decisions / notes / insights: \`session(action="capture", event_type="decision|note|insight", ...)\`
-- Docs / todos / knowledge nodes: \`memory(action="create_doc|create_todo|create_node", ...)\`
-
-**Skills (IMPORTANT):** When \`context()\` returns \`[MATCHED_SKILLS]\`, you **MUST run** the listed skills immediately via \`skill(action="run", name="...")\`. High-priority skills (marked \u26A1) are mandatory.
-
-## Past Sessions Are Queryable \u2014 USE THEM
-
-Transcripts of every prior session are captured + indexed. Before asking the user what you did last time, or re-deriving context you built together previously, check the transcript + snapshot layer.
-
-Triggers: user says "last time"/"previous"/"yesterday"/"pick up where we left off", the task is clearly a continuation, or you're about to ask a clarifying question whose answer is likely in a prior session.
-
-Exact calls:
-- Ranked past-session context: \`session(action="recall", query="<what you're continuing>")\`
-- Chronological list of recent sessions: \`memory(action="list_transcripts", limit=10)\`
-- Full-text search across ALL past transcripts: \`memory(action="search_transcripts", query="<keyword>")\`
-- Save a snapshot of the current session so the NEXT session can pick up: \`session(action="capture", event_type="session_snapshot", title="...", content="...")\`
-
-**Never answer "I don't know what we did before" without running recall or search_transcripts at least once.**
-
-**Notices:** [MATCHED_SKILLS] \u2192 run surfaced skills before other work | [LESSONS_WARNING] \u2192 apply lessons immediately and keep them active for the turn | [PREFERENCE] \u2192 follow user preferences | [RULES_NOTICE] \u2192 run \`generate_rules()\` | [VERSION_NOTICE/CRITICAL] \u2192 tell user about update
-
-v${RULES_VERSION}
-`.trim();
-var CONTEXTSTREAM_RULES_DYNAMIC = CONTEXTSTREAM_RULES_BOOTSTRAP;
-var CONTEXTSTREAM_RULES_FULL = `
-## \u{1F6A8} MANDATORY STARTUP: CONTEXT-FIRST FLOW \u{1F6A8}
-
-<contextstream_rules>
-| Message | What to Call |
-|---------|--------------|
-| **First message in session** | \`init()\` \u2192 \`context(user_message="<msg>")\` BEFORE any other tool |
-| **Subsequent messages (default)** | \`context(user_message="<msg>")\` FIRST, then other tools |
-| **Narrow bypass** | Immediate read-only ContextStream calls are allowed only when prior context is fresh and no state-changing tool has run |
-| **Before Glob/Grep/Read/Search/Explore/Task/EnterPlanMode** | \`search(mode="auto", query="...")\` FIRST |
-</contextstream_rules>
-
-Use \`context()\` by default to get task-specific rules, lessons from past mistakes, and relevant decisions.
-
----
-
-## Why Default Context-First
-
-\u274C **Wrong:** "I already called init, so I can skip context for everything"
-\u2705 **Correct:** \`context()\` is the default first call for subsequent messages, with a narrow read-only bypass when context is still fresh and state is unchanged
-
-**What you lose without \`context()\`:**
-- Dynamic rules matched to your current task
-- Lessons from past mistakes (you WILL repeat them)
-- Semantically relevant decisions and context
-- Warnings about risky operations
-
-**\`init()\` returns recent items by time. \`context()\` finds items semantically relevant to this message.**
-
----
-
-## Handle Notices from context()
-
-- **[LESSONS_WARNING]** \u2192 Tell user about past mistakes BEFORE proceeding
-- **[PREFERENCE]** \u2192 Follow user preferences (high-priority user memories)
-- **[RULES_NOTICE]** \u2192 Run \`generate_rules()\` to update
-- **[VERSION_NOTICE]** \u2192 Tell user to update MCP
-
----
-
-## \u{1F6A8} HOOKS - AUTOMATIC RULE ENFORCEMENT \u{1F6A8}
-
-**ContextStream installs hooks that automatically enforce rules.** You MUST follow hook output.
-
-### Installed Hooks
-
-| Hook | What It Does | Output |
-|------|--------------|--------|
-| **UserPromptSubmit** | Injects rules reminder on EVERY message | \`<system-reminder>\` with rules block |
-| **PreToolUse** | Blocks Glob/Grep/Search/Explore when ContextStream is available | Error message redirecting to \`search()\` |
-| **PostToolUse** | Auto-indexes files after Edit/Write operations | Background indexing |
-| **PreCompact** | Saves session state before context compaction | Snapshot creation |
-
-### How Hooks Work
-
-1. **\`<system-reminder>\` tags** - Injected by UserPromptSubmit hook on every message
-   - These tags contain the current rules
-   - **FOLLOW THE INSTRUCTIONS INSIDE** - they ARE the rules
-   - Example: \`[CONTEXTSTREAM RULES] 1. BEFORE Glob/Grep... [END RULES]\`
-
-2. **PreToolUse blocking** - If you try to use Glob/Grep/Search/Explore:
-   - Hook returns error: \`STOP: Use mcp__contextstream__search(mode="auto") instead\`
-   - **You MUST use the suggested ContextStream tool instead**
-  - Run search FIRST even while the index is still building (keyword hits return immediately); fall back to local tools ONLY after search itself returns 0 results/errors on a retry, for known-new edits, or on explicit user request
-
-3. **PostToolUse indexing** - After Edit/Write operations:
-   - Changed files are automatically re-indexed
-   - No action required from you
-
-4. **PreCompact snapshots** - Before context compaction:
-   - Hook reminds you to save important state
-   - Call \`session(action="capture", event_type="session_snapshot", ...)\` when warned
-
-### Disabling Hooks
-
-Set environment variable: \`CONTEXTSTREAM_HOOK_ENABLED=false\`
-
-**Note:** Disabling hooks removes rule enforcement. Only disable for debugging.
-
----
-
-## \u{1F6A8} CRITICAL RULE #1 - CONTEXTSTREAM SEARCH FIRST \u{1F6A8}
-
-**BEFORE using Glob, Grep, Search, Read (for discovery), Explore, Task(Explore), EnterPlanMode, or ANY local file scanning:**
-\`\`\`
-STOP \u2192 Call search(mode="auto", 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="auto", query="...")\` instead
-- \`Explore\` or \`Task(subagent_type="Explore")\` \u2192 Use \`search(mode="auto")\` instead
-- \`EnterPlanMode\` for discovery \u2192 Use \`search(mode="auto", output_format="paths")\` instead
-
-\u2705 **ALWAYS DO THIS:**
-1. \`search(mode="auto", query="what you're looking for")\`
-2. Only use local tools (Glob/Grep/Read) after \`search(...)\` itself returns **0 results**/errors on a retry \u2014 never preemptively because the index "isn't built yet"
-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 - CONTEXT EVERY MESSAGE
-
-| Message | Required |
-|---------|----------|
-| **1st message** | \`init()\` \u2192 \`context(user_message="<msg>")\` |
-| **EVERY message after** | \`context(user_message="<msg>")\` **FIRST** |
-| **Before file search** | \`search(mode="auto")\` FIRST |
-| **After significant work** | \`session(action="capture", event_type="decision", ...)\` |
-| **User correction** | \`session(action="capture_lesson", ...)\` |
-
-### Why EVERY Message?
-
-\`context()\` delivers:
-- **Dynamic rules** matched to your current task
-- **Lessons** from past mistakes (prevents repeating errors)
-- **Relevant decisions** and context (semantic search)
-- **Warnings** about risky operations
-
-**Without \`context()\`, you are blind to relevant context and will repeat past mistakes.**
-
-### Protocol
-
-| 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="auto", 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 |
-
-**First message rule:** 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: auto (recommended), semantic, hybrid (legacy alias), keyword, pattern | \`search(mode="auto", 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]** or **[VERSION_CRITICAL]** - You **MUST** tell the user (be helpful, not annoying):
-  1. A new MCP server version is available with improvements
-  2. Provide update commands (user chooses preferred method):
-     - macOS/Linux: \`curl -fsSL https://contextstream.io/scripts/setup.sh | bash\`
-     - Windows: \`irm https://contextstream.io/scripts/setup.ps1 | iex\`
-     - npm: \`npm install -g @contextstream/mcp-server@latest\`
-  3. Restart AI tool after updating
-  **Mention once** - don't nag. Users often miss stderr warnings so this helps.
-
-**[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)
-
-**Preferences ([PREFERENCE] in context response):**
-- High-priority user memories that should guide your behavior
-- Surfaced automatically via \`context()\` warnings field
-- To save: \`session(action="remember", content="...")\`
-- To retrieve explicitly: \`session(action="user_context")\`
-
-**Lessons ([LESSONS_WARNING] in context response):**
-- Past mistakes to avoid - apply prevention steps
-- Surfaced automatically via \`context()\` warnings field
-- Before risky changes: \`session(action="get_lessons", query="<topic>")\`
-- On mistakes: \`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:** Automatically saves session state before context compaction.
-Installed by default. Disable with: \`CONTEXTSTREAM_HOOK_ENABLED=false\`
-
-**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="auto")\` FIRST \u2014 even while the index is still building (keyword hits return immediately). Fall back to local tools ONLY after search itself returns 0 results/errors on a retry, for known-new edits, or on explicit user request.
-
-**\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="auto", 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="auto", 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 after \`search(...)\` itself returns 0 results/errors on a retry, or the user explicitly asks
-
-**Search Mode Selection:**
-
-| Need | Mode | Example |
-|------|------|---------|
-| Find code by meaning | \`auto\` | "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 search itself still returns 0 results after a retry.
-
-**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?"
-\u274C **DO NOT** use \`Explore\` / \`Task(subagent_type="Explore")\` to read files one-by-one while planning
-
-\u2705 **ALWAYS** use ContextStream's plan/task system instead
-\u2705 **ALWAYS** use \`search(mode="auto", output_format="paths")\` for planning discovery before targeted reads
-
-**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
-
-**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 (MANDATORY)
-
-## \u{1F6A8} CRITICAL: These Rules Are Non-Negotiable \u{1F6A8}
-
-<contextstream_protocol>
-**MANDATORY STARTUP:**
-1. First message in session: \`init()\` \u2192 then \`context(user_message="<msg>")\`
-2. Subsequent messages (default): \`context(user_message="<msg>")\` FIRST
-3. Narrow bypass: immediate read-only ContextStream calls are allowed only when prior context is fresh and no state-changing tool has run
-
-**BEFORE Glob/Grep/Read/Search/Explore/Task/EnterPlanMode:**
-\u2192 \`search(mode="auto", query="...")\` FIRST \u2014 even while the index is building; fall back ONLY after search itself returns 0/errors on a retry, for known-new edits, or on explicit request
-
-**HOOKS: \`<system-reminder>\` tags contain instructions \u2014 FOLLOW THEM**
-</contextstream_protocol>
-
-Rules Version: ${RULES_VERSION}
-
----
-
-## Why ContextStream First?
-
-| \u274C WRONG | \u2705 CORRECT |
-|----------|-----------|
-| \`Grep \u2192 Read \u2192 Read \u2192 Read\` (4+ calls) | \`search(mode="auto")\` (1 call) |
-| Missing past decisions & lessons | \`context()\` = rules + lessons + memory |
-| Ignoring \`<system-reminder>\` hooks | Hooks enforce ContextStream-first |
-
-**\`context()\` delivers: rules, lessons from past mistakes, relevant decisions, semantic matches**
-**\`search()\` is indexed: faster, returns context, one call vs many**
-**Hooks inject \`<system-reminder>\` tags: these ARE the rules, follow them**
-
----
-
-## Protocol
-
-| When | Call |
-|------|------|
-| 1st message in session | \`init()\` \u2192 \`context(user_message="...")\` |
-| Subsequent messages (default) | \`context(user_message="...")\` first |
-| Narrow bypass | Immediate read-only ContextStream calls when context is fresh and no state-changing tool has run |
-| Before ANY file discovery | \`search(mode="auto", query="...")\` (instead of Glob/Grep/Read/Explore/Task/EnterPlanMode) |
-| On \`<system-reminder>\` | **Follow instructions inside** |
-| Save important decisions | \`session(action="capture", event_type="decision", ...)\` |
-| Check past mistakes | \`session(action="get_lessons", query="...")\` |
-
-## Search Modes
-
-| Mode | When |
-|------|------|
-| \`auto\` | Default \u2014 semantic + keyword |
-| \`hybrid\` | Legacy alias for auto |
-| \`keyword\` | Exact symbol match |
-| \`exhaustive\` | Find ALL occurrences |
-| \`semantic\` | Conceptual questions |
-
-## Handle Notices from context()
-
-- **[LESSONS_WARNING]** \u2192 Tell user about past mistakes BEFORE proceeding
-- **[PREFERENCE]** \u2192 Follow user preferences (high-priority user memories)
-- **[RULES_NOTICE]** \u2192 Run \`generate_rules()\`
-- **[VERSION_NOTICE]** \u2192 Tell user to update MCP
-
-## Read-Only Examples
-
-Default behavior is context-first. Narrow bypass applies only for immediate read-only ContextStream calls when context is fresh and state is unchanged.
-Examples: \`workspace(action="list"|"get")\`, \`help(action="version"|"tools"|"auth")\`, \`project(action="index_status")\`.
-
-### 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
-
-### 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]** or **[VERSION_CRITICAL]**: Tell user about the update in a helpful, non-annoying way. Provide update commands:
-  - macOS/Linux: \`curl -fsSL https://contextstream.io/scripts/setup.sh | bash\`
-  - Windows: \`irm https://contextstream.io/scripts/setup.ps1 | iex\`
-  - npm: \`npm install -g @contextstream/mcp-server@latest\`
-- **[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
-- **[PREFERENCE]**: Follow user preferences - these are high-priority user memories that should guide your behavior
-
-### 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 NO_HOOKS_SUPPLEMENT = `
-
----
-## \u26A0\uFE0F IMPORTANT: No Hooks Available \u26A0\uFE0F
-
-**This editor does NOT have hooks to enforce ContextStream behavior.**
-You MUST follow these rules manually - there is no automatic enforcement.
-
----
-
-## \u{1F680} SESSION START PROTOCOL
-
-**On EVERY new session, you MUST:**
-
-1. **Call \`init(folder_path="<project_path>")\`** FIRST
-   - This triggers project indexing
-   - Check response for \`indexing_status\`
-   - If \`"started"\` or \`"refreshing"\`: wait before searching
-
-2. **Generate a unique session_id** (e.g., \`"session-" + timestamp\` or a UUID)
-   - Use this SAME session_id for ALL context() calls in this conversation
-   - This groups all turns together in the transcript
-
-3. **Call \`context(user_message="<first_message>", save_exchange=true, session_id="<your-session-id>")\`**
-   - Gets task-specific rules, lessons, and preferences
-   - Check for [LESSONS_WARNING] - past mistakes to avoid
-   - Check for [PREFERENCE] - user preferences to follow
-   - Check for [RULES_NOTICE] - update rules if needed
-   - **save_exchange=true** saves each conversation turn for later retrieval
-
-4. **Default behavior:** call \`context(...)\` first on each message. Narrow bypass is allowed only for immediate read-only ContextStream calls when previous context is still fresh and no state-changing tool has run.
-
----
-
-## \u{1F4BE} AUTOMATIC TRANSCRIPT SAVING (CRITICAL)
-
-**This editor does NOT have hooks to auto-save transcripts.**
-You MUST save each conversation turn manually:
-
-### On MOST messages (including the first):
-\`\`\`
-context(user_message="<user's message>", save_exchange=true, session_id="<session-id>")
-\`\`\`
-
-### Why save_exchange matters:
-- Transcripts enable searching past conversations
-- Allows context restoration after compaction
-- Provides conversation history for debugging
-- Required for the Transcripts page in the dashboard
-
-### Session ID Guidelines:
-- Generate ONCE at the start of the conversation
-- Use a unique identifier: \`"session-" + Date.now()\` or a UUID
-- Keep the SAME session_id for ALL context() calls in this session
-- Different sessions = different transcripts
-
----
-
-## \u{1F4C1} FILE INDEXING (CRITICAL)
-
-**There is NO automatic file indexing in this editor.**
-You MUST manage indexing manually:
-
-### After Creating/Editing Files:
-\`\`\`
-project(action="index")  # Re-index entire project
-\`\`\`
-
-### For Single File Updates:
-\`\`\`
-project(action="ingest_local", path="<file_path>")
-\`\`\`
-
-### Signs You Need to Re-index:
-- Search doesn't find code you just wrote
-- Search returns old versions of functions
-- New files don't appear in search results
-
-### Best Practice:
-After completing a feature or making multiple file changes, ALWAYS run:
-\`\`\`
-project(action="index")
-\`\`\`
-
----
-
-## \u{1F50D} SEARCH-FIRST (No PreToolUse Hook)
-
-**There is NO hook to block local tools (Glob/Grep/Read/Explore/Task/EnterPlanMode).** You MUST self-enforce:
-
-### Before ANY Search, Check Index Status:
-\`\`\`
-project(action="index_status")
-\`\`\`
-
-This tells you:
-- \`indexed\`: true/false - is project indexed?
-- \`last_indexed_at\`: timestamp - when was it last indexed?
-- \`file_count\`: number - how many files indexed?
-
-### Search Protocol:
-
-**IF project is indexed and fresh:**
-\`\`\`
-search(mode="auto", query="what you're looking for")
-\`\`\`
-\u2192 Use this instead of Explore/Task/EnterPlanMode for file discovery.
-
-**IF project is NOT indexed or very stale (>7 days):**
-\u2192 Run \`search(mode="auto", ...)\` anyway \u2014 keyword hits return immediately while indexing builds; retry once, and use local tools only if search itself returns 0/errors
-\u2192 OR run \`project(action="index")\` first, then search
-
-**IF ContextStream search still returns 0 results or errors after retry/window:**
-\u2192 Use local tools (Glob/Grep/Read) as fallback
-
-### Choose Search Mode Intelligently:
-- \`auto\` (recommended): query-aware mode selection
-- \`hybrid\`: mixed semantic + keyword retrieval for broad discovery
-- \`semantic\`: conceptual questions ("how does X work?")
-- \`keyword\`: exact text / quoted string
-- \`pattern\`: glob or regex (\`*.ts\`, \`foo\\s+bar\`)
-- \`refactor\`: symbol usage / rename-safe lookup
-- \`exhaustive\`: all occurrences / complete match coverage
-- \`team\`: cross-project team search
-
-### Output Format Hints:
-- Use \`output_format="paths"\` for file listings and rename targets
-- Use \`output_format="count"\` for "how many" queries
-
-### Two-Phase Search Pattern (for precision):
-- Pass 1 (discovery): \`search(mode="auto", query="<concept + module>", output_format="paths", limit=10)\`
-- Pass 2 (precision): use one of:
-  - exact text/symbol: \`search(mode="keyword", query="\\"exact_text\\"", include_content=true)\`
-  - symbol usage: \`search(mode="refactor", query="SymbolName", output_format="paths")\`
-  - all occurrences: \`search(mode="exhaustive", query="symbol_or_text")\`
-- Then use local Read/Grep only on paths returned by ContextStream.
-
-### When Local Tools Are OK:
-\u2705 The edit is known-new (just written this turn) and not yet indexed
-\u2705 ContextStream search still returns 0 results after retry
-\u2705 ContextStream returns errors
-\u2705 User explicitly requests local tools
-
-### When to Use ContextStream Search:
-\u2705 Project is indexed and fresh
-\u2705 Looking for code by meaning/concept
-\u2705 Need semantic understanding
-
----
-
-## \u{1F4BE} CONTEXT COMPACTION (No PreCompact Hook)
-
-**There is NO automatic state saving before compaction.**
-You MUST save state manually when the conversation gets long:
-
-### When to Save State:
-- After completing a major task
-- Before the conversation might be compacted
-- If \`context()\` returns \`context_pressure.level: "high"\`
-
-### How to Save State:
-\`\`\`
-session(action="capture", event_type="session_snapshot",
-  title="Session checkpoint",
-  content="{ \\"summary\\": \\"what we did\\", \\"active_files\\": [...], \\"next_steps\\": [...] }")
-\`\`\`
-
-### After Compaction (if context seems lost):
-\`\`\`
-init(folder_path="...", is_post_compact=true)
-\`\`\`
-This restores the most recent snapshot.
-
----
-
-## \u{1F4CB} PLANS & TASKS (No EnterPlanMode)
-
-**Always use ContextStream for planning:**
-
-\`\`\`
-session(action="capture_plan", title="...", steps=[...])
-memory(action="create_task", title="...", plan_id="...")
-\`\`\`
-
-\u274C DO NOT use built-in plan mode (\`EnterPlanMode\`) or \`Task(subagent_type="Explore")\` for file-by-file scans.
-\u2705 For planning discovery, use \`search(mode="auto", query="...", output_format="paths")\` then read only narrowed files.
-
----
-
-## \u{1F504} VERSION UPDATES (Check Periodically)
-
-**This editor does NOT have hooks to check for updates automatically.**
-You should check for updates using \`help(action="version")\` periodically (e.g., at session start).
-
-### If the response includes [VERSION_NOTICE] or [VERSION_CRITICAL]:
-
-**Tell the user** about the available update in a helpful, non-annoying way:
-- Frame it as "new features and improvements available"
-- Provide the update commands (user can choose their preferred method)
-- Don't nag repeatedly - mention once, then only if user asks
-
-### Update Commands (provide all options):
-
-**macOS/Linux:**
-\`\`\`bash
-curl -fsSL https://contextstream.io/scripts/setup.sh | bash
-\`\`\`
-
-**Windows (PowerShell):**
-\`\`\`powershell
-irm https://contextstream.io/scripts/setup.ps1 | iex
-\`\`\`
-
-**npm (requires Node.js 18+):**
-\`\`\`bash
-npm install -g @contextstream/mcp-server@latest
-\`\`\`
-
-After updating, user should restart their AI tool.
-
----
-`;
-var ANTIGRAVITY_SUPPLEMENT = `
----
-## Antigravity-Specific Reliability Notes
-
-- Antigravity currently has no documented lifecycle hooks for ContextStream enforcement.
-- Treat ContextStream-first behavior as mandatory policy: run \`context(...)\` first, then \`search(mode="auto", ...)\` before local discovery.
-- Keep \`mcp_config.json\` valid and minimal: preserve non-ContextStream servers and only update the \`contextstream\` server block.
-- If ContextStream appears skipped, verify:
-  1. MCP server status is healthy in Antigravity settings
-  2. \`search(mode="auto", ...)\` ran FIRST (even while indexing) and was retried before any local fallback
-  3. Instructions file contains the current ContextStream managed block
-`;
-var NO_HOOKS_EDITORS = ["copilot", "codex", "opencode", "aider", "antigravity", "kilo"];
-var TEMPLATES = {
-  codex: {
-    filename: "AGENTS.md",
-    description: "Codex CLI agent instructions",
-    build: (rules) => `# Codex CLI Instructions
-${rules}
-`
-  },
-  opencode: {
-    filename: "AGENTS.md",
-    description: "OpenCode CLI agent instructions",
-    build: (rules) => `# OpenCode CLI Instructions
-${rules}
-`
-  },
-  cursor: {
-    // Cursor Agent mode does not read .cursorrules at all; only
-    // .cursor/rules/*.mdc loads in every mode (Chat/Composer/Agent).
-    // Existing .cursorrules blocks are left in place for older Cursor
-    // versions but are no longer created.
-    filename: ".cursor/rules/contextstream.mdc",
-    description: "Cursor AI rules (.cursor/rules MDC \u2014 loaded in all Cursor modes)",
-    build: (rules) => `---
-alwaysApply: true
----
-
-# Cursor Rules
-${rules}
-`
-  },
-  windsurf: {
-    filename: ".windsurf/rules/contextstream.md",
-    description: "Windsurf AI rules",
-    build: (rules) => `---
-trigger: always_on
----
-
-# Windsurf Rules
-${rules}
-`
-  },
-  cline: {
-    filename: ".clinerules",
-    description: "Cline AI rules",
-    build: (rules) => `# Cline Rules
-${rules}
-`
-  },
-  kilo: {
-    filename: ".kilo/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}
-`
-  },
-  copilot: {
-    filename: ".github/copilot-instructions.md",
-    description: "VS Code GitHub Copilot instructions",
-    build: (rules) => `## ContextStream MCP Integration
-
-This project uses [ContextStream](https://contextstream.io) for persistent AI memory across sessions. Use the \`contextstream-workflow\` skill for detailed examples and reference material.
-
-${rules}
-
-### VS Code Copilot Notes
-
-- Keep this file concise; put detailed workflows in \`.github/skills/contextstream-workflow/SKILL.md\`
-- Use ContextStream plans/tasks as the persistent record of work
-- Before code discovery, use \`search(mode="auto", query="...")\`
-
-Full docs: https://contextstream.io/docs/mcp/tools
-`
-  }
-};
-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 || "bootstrap";
-  const rules = mode === "full" ? CONTEXTSTREAM_RULES_FULL : mode === "minimal" ? CONTEXTSTREAM_RULES_MINIMAL : mode === "bootstrap" ? CONTEXTSTREAM_RULES_BOOTSTRAP : CONTEXTSTREAM_RULES_DYNAMIC;
-  let content = template.build(rules);
-  if (editor.toLowerCase() !== "copilot" && (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 (NO_HOOKS_EDITORS.includes(editor.toLowerCase())) {
-    content += NO_HOOKS_SUPPLEMENT;
-  }
-  if (editor.toLowerCase() === "antigravity") {
-    content += ANTIGRAVITY_SUPPLEMENT;
-  }
-  if (options?.additionalRules) {
-    content += "\n\n## Project-Specific Rules\n\n" + options.additionalRules;
-  }
-  if (editor.toLowerCase() === "claude") {
-    content = applyMcpToolPrefix(content, `mcp__${DEFAULT_CLAUDE_MCP_SERVER_NAME}__`);
-  }
-  return {
-    filename: template.filename,
-    content: content.trim() + "\n"
-  };
-}
-
-// src/hooks/prompt-state.ts
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { homedir as homedir2 } from "node:os";
-var STATE_PATH = path.join(homedir2(), ".contextstream", "prompt-state.json");
-function defaultState() {
-  return { workspaces: {} };
-}
-function nowIso() {
-  return (/* @__PURE__ */ new Date()).toISOString();
-}
-function ensureStateDir() {
-  try {
-    fs.mkdirSync(path.dirname(STATE_PATH), { recursive: true });
-  } catch {
-  }
-}
-function normalizePath(input) {
-  try {
-    return path.resolve(input);
-  } catch {
-    return input;
-  }
-}
-function workspacePathsMatch(a, b) {
-  const left = normalizePath(a);
-  const right = normalizePath(b);
-  return left === right || left.startsWith(`${right}${path.sep}`) || right.startsWith(`${left}${path.sep}`);
-}
-function readState() {
-  try {
-    const content = fs.readFileSync(STATE_PATH, "utf8");
-    const parsed = JSON.parse(content);
-    if (!parsed || typeof parsed !== "object" || !parsed.workspaces) {
-      return defaultState();
-    }
-    return parsed;
-  } catch {
-    return defaultState();
-  }
-}
-function writeState(state) {
-  try {
-    ensureStateDir();
-    fs.writeFileSync(STATE_PATH, JSON.stringify(state, null, 2), "utf8");
-  } catch {
-  }
-}
-function getOrCreateEntry(state, cwd) {
-  if (!cwd.trim()) return null;
-  const exact = state.workspaces[cwd];
-  if (exact) return { key: cwd, entry: exact };
-  for (const [trackedCwd, trackedEntry] of Object.entries(state.workspaces)) {
-    if (workspacePathsMatch(trackedCwd, cwd)) {
-      return { key: trackedCwd, entry: trackedEntry };
-    }
-  }
-  const created = {
-    require_context: false,
-    require_init: false,
-    last_context_at: void 0,
-    last_state_change_at: void 0,
-    index_wait_started_at: void 0,
-    index_wait_until: void 0,
-    updated_at: nowIso()
-  };
-  state.workspaces[cwd] = created;
-  return { key: cwd, entry: created };
-}
-function cleanupStale(maxAgeSeconds) {
-  const state = readState();
-  const now = Date.now();
-  let changed = false;
-  for (const [cwd, entry] of Object.entries(state.workspaces)) {
-    const updated = new Date(entry.updated_at);
-    if (Number.isNaN(updated.getTime())) continue;
-    const ageSeconds = (now - updated.getTime()) / 1e3;
-    if (ageSeconds > maxAgeSeconds) {
-      delete state.workspaces[cwd];
-      changed = true;
-    }
-  }
-  if (changed) {
-    writeState(state);
-  }
-}
-function markInitRequired(cwd) {
-  if (!cwd.trim()) return;
-  const state = readState();
-  const target = getOrCreateEntry(state, cwd);
-  if (!target) return;
-  target.entry.require_init = true;
-  target.entry.updated_at = nowIso();
-  writeState(state);
-}
-
-// src/hooks/session-init.ts
-var ENABLED = process.env.CONTEXTSTREAM_SESSION_INIT_ENABLED !== "false";
-var API_URL = process.env.CONTEXTSTREAM_API_URL || "https://api.contextstream.io";
-var API_KEY = process.env.CONTEXTSTREAM_API_KEY || "";
-var WORKSPACE_ID = null;
-var PROJECT_ID = null;
-function loadConfigFromMcpJson(cwd) {
-  let searchDir = path2.resolve(cwd);
-  for (let i = 0; i < 5; i++) {
-    if (!API_KEY) {
-      const mcpPath = path2.join(searchDir, ".mcp.json");
-      if (fs2.existsSync(mcpPath)) {
-        try {
-          const content = fs2.readFileSync(mcpPath, "utf-8");
-          const config = JSON.parse(content);
-          const csEnv = config.mcpServers?.contextstream?.env;
-          if (csEnv?.CONTEXTSTREAM_API_KEY) {
-            API_KEY = csEnv.CONTEXTSTREAM_API_KEY;
-          }
-          if (csEnv?.CONTEXTSTREAM_API_URL) {
-            API_URL = csEnv.CONTEXTSTREAM_API_URL;
-          }
-          if (csEnv?.CONTEXTSTREAM_WORKSPACE_ID) {
-            WORKSPACE_ID = csEnv.CONTEXTSTREAM_WORKSPACE_ID;
-          }
-        } catch {
-        }
-      }
-    }
-    if (!WORKSPACE_ID || !PROJECT_ID) {
-      const csConfigPath = path2.join(searchDir, ".contextstream", "config.json");
-      if (fs2.existsSync(csConfigPath)) {
-        try {
-          const content = fs2.readFileSync(csConfigPath, "utf-8");
-          const csConfig = JSON.parse(content);
-          if (csConfig.workspace_id && !WORKSPACE_ID) {
-            WORKSPACE_ID = csConfig.workspace_id;
-          }
-          if (csConfig.project_id && !PROJECT_ID) {
-            PROJECT_ID = csConfig.project_id;
-          }
-        } catch {
-        }
-      }
-    }
-    const parentDir = path2.dirname(searchDir);
-    if (parentDir === searchDir) break;
-    searchDir = parentDir;
-  }
-  if (!API_KEY) {
-    const homeMcpPath = path2.join(homedir3(), ".mcp.json");
-    if (fs2.existsSync(homeMcpPath)) {
-      try {
-        const content = fs2.readFileSync(homeMcpPath, "utf-8");
-        const config = JSON.parse(content);
-        const csEnv = config.mcpServers?.contextstream?.env;
-        if (csEnv?.CONTEXTSTREAM_API_KEY) {
-          API_KEY = csEnv.CONTEXTSTREAM_API_KEY;
-        }
-        if (csEnv?.CONTEXTSTREAM_API_URL) {
-          API_URL = csEnv.CONTEXTSTREAM_API_URL;
-        }
-      } catch {
-      }
-    }
-  }
-}
-async function fetchSessionContext() {
-  if (!API_KEY) return null;
-  try {
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), 5e3);
-    const url = new URL(`${API_URL}/api/v1/context`);
-    if (WORKSPACE_ID) url.searchParams.set("workspace_id", WORKSPACE_ID);
-    if (PROJECT_ID) url.searchParams.set("project_id", PROJECT_ID);
-    url.searchParams.set("include_rules", "true");
-    url.searchParams.set("include_lessons", "true");
-    url.searchParams.set("include_decisions", "true");
-    url.searchParams.set("include_plans", "true");
-    url.searchParams.set("limit", "5");
-    const response = await fetch(url.toString(), {
-      method: "GET",
-      headers: {
-        "X-API-Key": API_KEY
-      },
-      signal: controller.signal
-    });
-    clearTimeout(timeoutId);
-    if (response.ok) {
-      return await response.json();
-    }
-    return null;
-  } catch {
-    return null;
-  }
-}
-function formatContext(ctx, options = {}) {
-  const parts = ["\u2B21 ContextStream \u2014 Smart Context & Memory", ""];
-  if (options.updateMarker) {
-    parts.push(`
-## \u{1F389} UPDATE COMPLETE - RESTART CHAT SESSION`);
-    parts.push(`ContextStream was auto-updated from v${options.updateMarker.previousVersion} to v${options.updateMarker.newVersion}.`);
-    parts.push(`**Tell the user:** "ContextStream has been updated! Please start a new chat session (or restart your AI tool) to use the new version with the latest features and fixes."`);
-    parts.push("");
-  } else if (options.autoUpdateResult?.attempted) {
-    if (options.autoUpdateResult.success) {
-      parts.push(`
-## \u{1F504} AUTO-UPDATE INITIATED`);
-      parts.push(`ContextStream is updating from v${options.autoUpdateResult.previousVersion} to v${options.autoUpdateResult.newVersion}.`);
-      parts.push(`**Tell the user:** "ContextStream is updating in the background. Please start a new chat session (or restart your AI tool) in a moment to use the new version."`);
-      parts.push("");
-    } else if (options.autoUpdateResult.error) {
-      parts.push(`
-## \u26A0\uFE0F AUTO-UPDATE FAILED`);
-      parts.push(`Automatic update failed: ${options.autoUpdateResult.error}`);
-      const versionInfo = getVersionNoticeForHook(options.versionNotice || null);
-      if (versionInfo) {
-        parts.push(versionInfo);
-      }
-      parts.push("");
-    }
-  } else if (options.versionNotice?.behind && !isAutoUpdateEnabled()) {
-    const versionInfo = getVersionNoticeForHook(options.versionNotice);
-    if (versionInfo) {
-      parts.push(`
-## \u{1F504} UPDATE AVAILABLE (auto-update disabled)`);
-      parts.push(versionInfo);
-      parts.push("");
-    }
-  }
-  if (!ctx) {
-    parts.push(
-      '\nNo saved context found yet. On the first message in this session call `mcp__contextstream__init(...)` then `mcp__contextstream__context(user_message="starting new session")`.'
-    );
-    return parts.join("\n");
-  }
-  if (ctx.lessons && ctx.lessons.length > 0) {
-    parts.push("\n## \u26A0\uFE0F Lessons from Past Mistakes");
-    for (const lesson of ctx.lessons.slice(0, 3)) {
-      parts.push(`- **${lesson.title}**: ${lesson.prevention}`);
-    }
-  }
-  if (ctx.active_plans && ctx.active_plans.length > 0) {
-    parts.push("\n## \u{1F4CB} Active Plans");
-    for (const plan of ctx.active_plans.slice(0, 3)) {
-      parts.push(`- ${plan.title} (${plan.status})`);
-    }
-  }
-  if (ctx.pending_tasks && ctx.pending_tasks.length > 0) {
-    parts.push("\n## \u2705 Pending Tasks");
-    for (const task of ctx.pending_tasks.slice(0, 5)) {
-      parts.push(`- ${task.title}`);
-    }
-  }
-  if (ctx.recent_decisions && ctx.recent_decisions.length > 0) {
-    parts.push("\n## \u{1F4DD} Recent Decisions");
-    for (const decision of ctx.recent_decisions.slice(0, 3)) {
-      parts.push(`- **${decision.title}**`);
-    }
-  }
-  parts.push("\n---");
-  parts.push(
-    'On the first message in a new session call `mcp__contextstream__init(...)` then `mcp__contextstream__context(user_message="...")`. After that, call `mcp__contextstream__context(user_message="...")` on every message.'
-  );
-  parts.push("\n## \u{1F4DC} Past Sessions Are Queryable \u2014 check before re-deriving context");
-  parts.push(
-    `Transcripts of every prior session are captured + indexed. If the user references past work ("last time", "previous", "yesterday", "pick up where we left off"), or you're continuing something, call ONE of these BEFORE asking clarifying questions:`
-  );
-  parts.push(
-    '- `mcp__contextstream__session(action="recall", query="<what you\'re continuing>")` \u2014 ranked fusion of transcripts/snapshots/docs/decisions'
-  );
-  parts.push(
-    '- `mcp__contextstream__memory(action="list_transcripts", limit=10)` \u2014 chronological list of recent sessions'
-  );
-  parts.push(
-    '- `mcp__contextstream__memory(action="search_transcripts", query="<keyword>")` \u2014 full-text search across ALL past transcripts'
-  );
-  parts.push(
-    '- `mcp__contextstream__memory(action="list_events", event_type="session_snapshot")` \u2014 manual bookmarks at turning points'
-  );
-  parts.push(
-    'At the end of this session, save a snapshot so the next session can pick up: `mcp__contextstream__session(action="capture", event_type="session_snapshot", title="...", content="<what we did + next step>")`.'
-  );
-  return parts.join("\n");
-}
-var CONTEXTSTREAM_START_MARKER = "<!-- BEGIN ContextStream -->";
-var CONTEXTSTREAM_END_MARKER = "<!-- END ContextStream -->";
-function regenerateRuleFiles(folderPath) {
-  let updated = 0;
-  const editors = getAvailableEditors();
-  for (const editor of editors) {
-    const rule = generateRuleContent(editor, { mode: "bootstrap" });
-    if (!rule) continue;
-    const filePath = path2.join(folderPath, rule.filename);
-    if (!fs2.existsSync(filePath)) continue;
-    try {
-      const existing = fs2.readFileSync(filePath, "utf8");
-      const startIdx = existing.indexOf(CONTEXTSTREAM_START_MARKER);
-      const endIdx = existing.indexOf(CONTEXTSTREAM_END_MARKER);
-      if (startIdx === -1 || endIdx === -1 || endIdx <= startIdx) continue;
-      const before = existing.substring(0, startIdx).trimEnd();
-      const after = existing.substring(endIdx + CONTEXTSTREAM_END_MARKER.length).trimStart();
-      const newBlock = `${CONTEXTSTREAM_START_MARKER}
-${rule.content.trim()}
-${CONTEXTSTREAM_END_MARKER}`;
-      const merged = [before, newBlock, after].filter((p) => p.length > 0).join("\n\n");
-      fs2.writeFileSync(filePath, merged.trim() + "\n", "utf8");
-      updated++;
-    } catch {
-    }
-  }
-  return updated;
-}
-async function runSessionInitHook() {
-  if (!ENABLED) {
-    process.exit(0);
-  }
-  let inputData = "";
-  for await (const chunk of process.stdin) {
-    inputData += chunk;
-  }
-  if (!inputData.trim()) {
-    process.exit(0);
-  }
-  let input;
-  try {
-    input = JSON.parse(inputData);
-  } catch {
-    process.exit(0);
-  }
-  const cwd = input.cwd || process.cwd();
-  cleanupStale(360);
-  markInitRequired(cwd);
-  loadConfigFromMcpJson(cwd);
-  const updateMarker = checkUpdateMarker();
-  if (updateMarker) {
-    regenerateRuleFiles(cwd);
-    clearUpdateMarker();
-  }
-  const [context, autoUpdateResult, versionNotice] = await Promise.all([
-    fetchSessionContext(),
-    updateMarker ? Promise.resolve(null) : attemptAutoUpdate(),
-    // Skip if already updated
-    getUpdateNotice()
-  ]);
-  const formattedContext = formatContext(context, {
-    autoUpdateResult,
-    versionNotice,
-    updateMarker
-  });
-  console.log(
-    JSON.stringify({
-      additionalContext: formattedContext
-    })
-  );
-  process.exit(0);
-}
-var isDirectRun = process.argv[1]?.includes("session-init") || process.argv[2] === "session-init";
-if (isDirectRun) {
-  runSessionInitHook().catch(() => process.exit(0));
-}
-export {
-  runSessionInitHook
-};