@contextstream/mcp-server 0.4.74 → 0.4.81

package/dist/hooks/session-init.js

@@ -342,21 +342,33 @@ var CONTEXTSTREAM_TOOL_NAMES = [
   // 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, capture_lesson, get_lessons, recall, remember, user_context, summary, compress, delta, smart_search, decision_trace
+  // 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, overview, statistics, files, index_status, ingest_local
+  // 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"
@@ -378,9 +390,60 @@ var CONTEXTSTREAM_RULES_BOOTSTRAP = `
 
 **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.
 
-**Notices:** [LESSONS_WARNING] \u2192 apply lessons | [PREFERENCE] \u2192 follow user preferences | [RULES_NOTICE] \u2192 run \`generate_rules()\` | [VERSION_NOTICE/CRITICAL] \u2192 tell user about update
+**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();
@@ -448,7 +511,7 @@ Use \`context()\` by default to get task-specific rules, lessons from past mista
 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**
-  - For stale/not-indexed projects, wait for background refresh (up to ~20s), retry search, then allow local tools only after the grace window
+  - 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
@@ -485,7 +548,7 @@ STOP \u2192 Call search(mode="auto", query="...") FIRST
 
 \u2705 **ALWAYS DO THIS:**
 1. \`search(mode="auto", query="what you're looking for")\`
-2. Only use local tools (Glob/Grep/Read) after stale/not-indexed refresh grace window elapses (~20s) or ContextStream still returns **0 results** after retry
+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.
@@ -748,7 +811,7 @@ session(action="capture", event_type="session_snapshot", title="Pre-compaction s
 
 ### Search & Code Intelligence (ContextStream-first)
 
-\u26A0\uFE0F **STOP: Before using Search/Glob/Grep/Read/Explore** \u2192 Call \`search(mode="auto")\` FIRST. For stale/not-indexed projects, wait ~20s for background refresh and retry search before local fallback.
+\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):**
 \`\`\`
@@ -767,7 +830,7 @@ search(mode="auto", query="function implementation") \u2192 done (results includ
 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 refresh grace window/retry still yields no results/errors, or the user explicitly asks
+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:**
 
@@ -798,7 +861,7 @@ search(mode="auto", query="function implementation") \u2192 done (results includ
 
 **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 refresh grace window + retry still returns 0 results.
+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="...")\`
@@ -927,7 +990,7 @@ var CONTEXTSTREAM_RULES_MINIMAL = `
 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 for stale/not-indexed, wait ~20s for refresh then retry before local fallback
+\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>
@@ -1150,7 +1213,7 @@ 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 Wait up to ~20s for background refresh, retry \`search(mode="auto", ...)\`, then allow local tools only after the grace window
+\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:**
@@ -1179,7 +1242,7 @@ search(mode="auto", query="what you're looking for")
 - Then use local Read/Grep only on paths returned by ContextStream.
 
 ### When Local Tools Are OK:
-\u2705 Stale/not-indexed grace window has elapsed (~20s default, configurable)
+\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
@@ -1272,7 +1335,7 @@ var ANTIGRAVITY_SUPPLEMENT = `
 - 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. Project is indexed and \`search(mode="auto", ...)\` is retried before local fallbacks
+  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"];
@@ -1292,9 +1355,17 @@ ${rules}
 `
   },
   cursor: {
-    filename: ".cursorrules",
-    description: "Cursor AI rules",
-    build: (rules) => `# Cursor Rules
+    // 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}
 `
   },
@@ -1673,6 +1744,25 @@ function formatContext(ctx, options = {}) {
   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 -->";

package/dist/hooks/user-prompt-submit.js

@@ -298,14 +298,13 @@ var FULL_REMINDER = `[CONTEXTSTREAM RULES - MANDATORY]
    - On subsequent messages, default to context() first. Narrow bypass: immediate read-only ContextStream calls when context is fresh and no state-changing tool has run.
 
 2. FOR CODE SEARCH: Check index status, then search appropriately
-   \u26A0\uFE0F BEFORE searching: mcp__contextstream__project(action="index_status")
-   \u2705 IF indexed & fresh: Use mcp__contextstream__search(mode="auto", query="...") BEFORE Glob/Grep/Read/Explore/Task/EnterPlanMode
-   \u2705 IF NOT indexed OR stale: wait for background refresh up to ~20s, retry mcp__contextstream__search(mode="auto", query="..."), then allow local tools only after the grace window
-   \u2705 IF search still returns 0 results after retry/window: fallback to local tools (Glob/Grep/Read)
+   \u2705 Use mcp__contextstream__search(mode="auto", query="...") BEFORE Glob/Grep/Read/Explore/Task/EnterPlanMode
+   \u2705 Run search even while the index is still building \u2014 keyword hits return immediately, results fill in as you work
+   \u2705 IF search itself returns 0 results/errors: retry once, THEN fall back to local tools (Glob/Grep/Read)
 
 3. WHEN LOCAL TOOLS (Glob/Grep/Read) ARE OK:
-   \u2705 Stale/not-indexed grace window has elapsed (~20s default, configurable)
    \u2705 ContextStream search still returns 0 results or errors after retry
+   \u2705 The file was just written this turn (known-new, not yet indexed)
    \u2705 User explicitly requests local tools
 
 4. FOR PLANS & TASKS: Use ContextStream, not file-based plans
@@ -728,8 +727,8 @@ Returns: \`indexed\` (true/false), \`last_indexed_at\`, \`file_count\`
 \u2192 Use \`search(mode="auto", query="...")\`
 
 **IF indexed=false OR last_indexed_at is stale (>7 days):**
-\u2192 Wait up to ~20s for background refresh, retry \`search(mode="auto", query="...")\`
-\u2192 After grace window: local tools are allowed if search still misses
+\u2192 Run \`search(mode="auto", query="...")\` anyway \u2014 keyword hits return immediately while indexing builds
+\u2192 Local tools only if search itself returns 0 results/errors on a retry
 
 **IF search still returns 0 results or errors after retry/window:**
 \u2192 Fallback to local tools (Glob/Grep/Read)