@contextstream/mcp-server 0.4.20 → 0.4.21

package/dist/index.js

@@ -7482,6 +7482,7 @@ var CONTEXTSTREAM_TOOL_NAMES = [
   "session_init",
   "context_smart",
   "context_feedback",
+  "generate_rules",
   // Consolidated domain tools (v0.4.x default)
   "search",
   // Modes: semantic, hybrid, keyword, pattern
@@ -7518,7 +7519,7 @@ Rules Version: ${RULES_VERSION}
 
 | Message | What to Call |
 |---------|--------------|
-| **1st message** | \`session_init(folder_path="...", context_hint="<user's message>")\` |
+| **1st message** | \`session_init(folder_path="...", context_hint="<user's message>")\`, then \`context_smart(user_message="<user's message>", format="minified", max_tokens=400)\` |
 | **2nd+ messages** | \`context_smart(user_message="<user's message>", format="minified", max_tokens=400)\` |
 | **Before risky/non-trivial work** | \`session(action="get_lessons", query="<topic>")\` |
 | **After completing task** | \`session(action="capture", event_type="decision", ...)\` - MUST capture |
@@ -7527,6 +7528,8 @@ Rules Version: ${RULES_VERSION}
 
 **NO EXCEPTIONS.** Do not skip even if you think you have enough context.
 
+**First message rule:** After \`session_init\`, always call \`context_smart\` before any other tool or response.
+
 **Context Pack (Pro+):** If enabled, use \`context_smart(..., mode="pack", distill=true)\` for code/file queries. If unavailable or disabled, omit \`mode\` and proceed with standard \`context_smart\` (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.
@@ -7539,7 +7542,7 @@ v0.4.x consolidates ~58 individual tools into ~11 domain tools with action/mode
 
 ### Standalone Tools (Always Call)
 - **\`session_init\`** - Initialize session with workspace detection + context
-- **\`context_smart\`** - Semantic search for relevant context (CALL EVERY MESSAGE)
+- **\`context_smart\`** - Semantic search for relevant context (CALL EVERY MESSAGE, including immediately after \`session_init\`)
 
 ### Domain Tools (Use action/mode parameter)
 
@@ -7588,7 +7591,7 @@ If context still feels missing, use \`session(action="recall", query="...")\` fo
 
 ### Rules Update Notices
 
-- If you see **[RULES_NOTICE]**, update rules via \`generate_editor_rules(folder_path="<cwd>")\` (or rerun setup).
+- If you see **[RULES_NOTICE]**, update rules via \`generate_rules()\` (or rerun setup).
 - If you see **[VERSION_NOTICE]**, tell the user to update MCP using the provided command.
 
 ---
@@ -7709,7 +7712,7 @@ Rules Version: ${RULES_VERSION}
 
 | Message | What to Call |
 |---------|--------------|
-| **1st message** | \`session_init(folder_path="<cwd>", context_hint="<user_message>")\` |
+| **1st message** | \`session_init(folder_path="<cwd>", context_hint="<user_message>")\`, then \`context_smart(user_message="<user_message>", format="minified", max_tokens=400)\` |
 | **2nd+ messages** | \`context_smart(user_message="<user_message>", format="minified", max_tokens=400)\` |
 | **Capture decisions** | \`session(action="capture", event_type="decision", title="...", content="...")\` |
 | **Before risky work** | \`session(action="get_lessons", query="<topic>")\` |
@@ -7734,14 +7737,14 @@ Rules Version: ${RULES_VERSION}
 
 ### Behavior Rules
 
-- **First message**: Always call \`session_init\` with context_hint
+- **First message**: Call \`session_init\` with context_hint, then call \`context_smart\` before any other tool or response
 - **Every message after**: Always call \`context_smart\` BEFORE responding (semantic search for relevant context)
 - **Before searching files/code**: Check \`project(action="index_status")\`; if missing/stale run \`project(action="ingest_local", path="<cwd>")\` or \`project(action="index")\`, and use \`graph(action="ingest")\` if needed
 - **For discovery**: Use \`session(action="smart_search")\` or \`search(mode="hybrid")\` before any local repo scans
 - **For file/function/config lookups**: Use \`search\`/\`graph\` first; only fall back to rg/ls/find if ContextStream returns no results
 - **If ContextStream returns results**: Do NOT use local Search/Explore/Read; only open specific files when needed for exact edits
 - **For code analysis**: Use \`graph(action="dependencies")\` or \`graph(action="impact")\` for call/dependency analysis
-- **On [RULES_NOTICE]**: Use \`generate_editor_rules(folder_path="<cwd>")\` to update rules
+- **On [RULES_NOTICE]**: Use \`generate_rules()\` to update rules
 - **After completing work**: Always capture decisions/insights with \`session(action="capture")\`
 - **On mistakes/corrections**: Immediately capture lessons with \`session(action="capture_lesson")\`
 
@@ -8174,12 +8177,12 @@ function getRulesNotice(folderPath, clientName) {
   const candidates = resolveRulesCandidatePaths(folderPath, editorKey);
   const existing = candidates.filter((filePath) => fs3.existsSync(filePath));
   if (existing.length === 0) {
-    const updateCommand2 = folderPath ? `generate_editor_rules(folder_path="${folderPath}")` : 'generate_editor_rules(folder_path="<cwd>")';
+    const updateCommand2 = "generate_rules()";
     const notice2 = {
       status: "missing",
       latest: RULES_VERSION,
       files_checked: candidates,
-      update_tool: "generate_editor_rules",
+      update_tool: "generate_rules",
       update_args: {
         ...folderPath ? { folder_path: folderPath } : {},
         editors: editorKey ? [editorKey] : ["all"]
@@ -8213,7 +8216,7 @@ function getRulesNotice(folderPath, clientName) {
     return null;
   }
   const current = versions.sort(compareVersions2).at(-1);
-  const updateCommand = folderPath ? `generate_editor_rules(folder_path="${folderPath}")` : 'generate_editor_rules(folder_path="<cwd>")';
+  const updateCommand = "generate_rules()";
   const notice = {
     status: filesOutdated.length > 0 ? "behind" : "unknown",
     current,
@@ -8221,7 +8224,7 @@ function getRulesNotice(folderPath, clientName) {
     files_checked: existing,
     ...filesOutdated.length > 0 ? { files_outdated: filesOutdated } : {},
     ...filesMissingVersion.length > 0 ? { files_missing_version: filesMissingVersion } : {},
-    update_tool: "generate_editor_rules",
+    update_tool: "generate_rules",
     update_args: {
       ...folderPath ? { folder_path: folderPath } : {},
       editors: editorKey ? [editorKey] : ["all"]
@@ -8444,6 +8447,55 @@ async function writeEditorRules(options) {
   }
   return results;
 }
+function listGlobalRuleTargets(editors) {
+  const targets = [];
+  for (const editor of editors) {
+    const globalPaths = RULES_GLOBAL_FILES[editor];
+    if (!globalPaths || globalPaths.length === 0) {
+      continue;
+    }
+    for (const filePath of globalPaths) {
+      targets.push({ editor, filePath });
+    }
+  }
+  return targets;
+}
+async function writeGlobalRules(options) {
+  const results = [];
+  for (const editor of options.editors) {
+    const rule = generateRuleContent(editor, {
+      mode: options.mode
+    });
+    if (!rule) {
+      results.push({ editor, filename: "", status: "unknown editor", scope: "global" });
+      continue;
+    }
+    const globalPaths = RULES_GLOBAL_FILES[editor] ?? [];
+    if (globalPaths.length === 0) {
+      results.push({ editor, filename: rule.filename, status: "skipped (no global path)", scope: "global" });
+      continue;
+    }
+    for (const filePath of globalPaths) {
+      if (fs3.existsSync(filePath) && !options.overwriteExisting) {
+        results.push({ editor, filename: filePath, status: "skipped (exists)", scope: "global" });
+        continue;
+      }
+      try {
+        const status = await upsertRuleFile(filePath, rule.content);
+        results.push({ editor, filename: filePath, status, scope: "global" });
+      } catch (err) {
+        results.push({
+          editor,
+          filename: filePath,
+          status: `error: ${err.message}`,
+          scope: "global"
+        });
+      }
+    }
+  }
+  rulesNoticeCache.clear();
+  return results;
+}
 var WRITE_VERBS = /* @__PURE__ */ new Set([
   "create",
   "update",
@@ -8645,6 +8697,7 @@ var LIGHT_TOOLSET = /* @__PURE__ */ new Set([
   "session_delta",
   // Setup and configuration (3)
   "generate_editor_rules",
+  "generate_rules",
   "workspace_associate",
   "workspace_bootstrap",
   // Project management (5)
@@ -8690,6 +8743,7 @@ var STANDARD_TOOLSET = /* @__PURE__ */ new Set([
   "session_delta",
   // Setup and configuration (3)
   "generate_editor_rules",
+  "generate_rules",
   "workspace_associate",
   "workspace_bootstrap",
   // Workspace management (2)
@@ -8898,7 +8952,8 @@ var TOOL_BUNDLES = {
     "session_compress",
     "session_delta",
     "decision_trace",
-    "generate_editor_rules"
+    "generate_editor_rules",
+    "generate_rules"
   ]),
   // Memory bundle (~12 tools) - full memory CRUD operations
   memory: /* @__PURE__ */ new Set([
@@ -9033,7 +9088,7 @@ function inferOperationCategory(name) {
   if (name.startsWith("reminder")) return "Reminders";
   if (name.startsWith("slack_") || name.startsWith("github_") || name.startsWith("integration")) return "Integrations";
   if (name.startsWith("ai_")) return "AI";
-  if (name === "auth_me" || name === "mcp_server_version" || name === "generate_editor_rules") return "Utility";
+  if (name === "auth_me" || name === "mcp_server_version" || name === "generate_editor_rules" || name === "generate_rules") return "Utility";
   if (name === "tools_enable_bundle" || name === "contextstream" || name === "contextstream_help") return "Meta";
   return "Other";
 }
@@ -9107,6 +9162,8 @@ var CONSOLIDATED_TOOLS = /* @__PURE__ */ new Set([
   // Standalone - complex initialization
   "context_smart",
   // Standalone - called every message
+  "generate_rules",
+  // Standalone - rule generation helper
   "search",
   // Consolidates search_semantic, search_hybrid, search_keyword, search_pattern
   "session",
@@ -11819,6 +11876,98 @@ Example: "What were the auth decisions?" or "What are my TypeScript preferences?
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
+  registerTool(
+    "generate_rules",
+    {
+      title: "Generate ContextStream rules",
+      description: `Generate AI rule files for editors (Windsurf, Cursor, Cline, Kilo Code, Roo Code, Claude Code, Aider).
+Defaults to the current project folder; no folder_path required when run from a project.
+Supported editors: ${getAvailableEditors().join(", ")}`,
+      inputSchema: external_exports.object({
+        folder_path: external_exports.string().optional().describe("Absolute path to the project folder (defaults to IDE root/cwd)"),
+        editors: external_exports.array(external_exports.enum(["codex", "windsurf", "cursor", "cline", "kilo", "roo", "claude", "aider", "all"])).optional().describe("Which editors to generate rules for. Defaults to all."),
+        workspace_name: external_exports.string().optional().describe("Workspace name to include in rules"),
+        workspace_id: external_exports.string().uuid().optional().describe("Workspace ID to include in rules"),
+        project_name: external_exports.string().optional().describe("Project name to include in rules"),
+        additional_rules: external_exports.string().optional().describe("Additional project-specific rules to append"),
+        mode: external_exports.enum(["minimal", "full"]).optional().describe("Rule verbosity mode (default: minimal)"),
+        overwrite_existing: external_exports.boolean().optional().describe("Allow overwriting existing rule files (ContextStream block only)"),
+        apply_global: external_exports.boolean().optional().describe("Also write global rule files for supported editors"),
+        dry_run: external_exports.boolean().optional().describe("If true, return content without writing files")
+      })
+    },
+    async (input) => {
+      const folderPath = resolveFolderPath(input.folder_path, sessionManager);
+      if (!folderPath) {
+        return errorResult("Error: folder_path is required. Provide folder_path or run from a project directory.");
+      }
+      const editors = input.editors?.includes("all") || !input.editors ? getAvailableEditors() : input.editors.filter((e) => e !== "all");
+      const results = [];
+      if (input.dry_run) {
+        for (const editor of editors) {
+          const rule = generateRuleContent(editor, {
+            workspaceName: input.workspace_name,
+            workspaceId: input.workspace_id,
+            projectName: input.project_name,
+            additionalRules: input.additional_rules,
+            mode: input.mode
+          });
+          if (!rule) {
+            results.push({ editor, filename: "", status: "unknown editor" });
+            continue;
+          }
+          results.push({
+            editor,
+            filename: rule.filename,
+            status: "dry run - would update"
+          });
+        }
+      } else {
+        const writeResults = await writeEditorRules({
+          folderPath,
+          editors,
+          workspaceName: input.workspace_name,
+          workspaceId: input.workspace_id,
+          projectName: input.project_name,
+          additionalRules: input.additional_rules,
+          mode: input.mode,
+          overwriteExisting: input.overwrite_existing
+        });
+        results.push(...writeResults);
+      }
+      const globalTargets = listGlobalRuleTargets(editors);
+      let globalResults;
+      if (input.apply_global) {
+        if (input.dry_run) {
+          globalResults = globalTargets.map((target) => ({
+            editor: target.editor,
+            filename: target.filePath,
+            status: "dry run - would update",
+            scope: "global"
+          }));
+        } else {
+          globalResults = await writeGlobalRules({
+            editors,
+            mode: input.mode,
+            overwriteExisting: input.overwrite_existing
+          });
+        }
+      }
+      const createdCount = results.filter((r) => r.status === "created" || r.status === "updated" || r.status === "appended").length;
+      const skippedCount = results.filter((r) => r.status.startsWith("skipped")).length;
+      const baseMessage = input.dry_run ? "Dry run complete. Use dry_run: false to write files." : skippedCount > 0 ? `Generated ${createdCount} rule files. ${skippedCount} skipped (existing files). Re-run with overwrite_existing: true to replace ContextStream blocks.` : `Generated ${createdCount} rule files.`;
+      const globalPrompt = input.apply_global ? "Global rule update complete." : globalTargets.length > 0 ? "Apply rules globally too? Re-run with apply_global: true." : "No global rule locations are known for these editors.";
+      const summary = {
+        folder: folderPath,
+        results,
+        ...globalResults ? { global_results: globalResults } : {},
+        ...globalTargets.length > 0 ? { global_targets: globalTargets } : {},
+        message: baseMessage,
+        global_prompt: globalPrompt
+      };
+      return { content: [{ type: "text", text: formatContent(summary) }], structuredContent: toStructured(summary) };
+    }
+  );
   registerTool(
     "generate_editor_rules",
     {
@@ -15169,7 +15318,8 @@ function registerPrompts(server) {
               "- Otherwise ask me for an absolute folder path.",
               "- Ask which editor(s) (windsurf,cursor,cline,kilo,roo,claude,aider) or default to all.",
               "",
-              "Then call `generate_editor_rules` and confirm which files were created/updated."
+              "Then call `generate_rules` and confirm which files were created/updated.",
+              "Ask if the user also wants to apply rules globally (pass apply_global: true)."
             ].join("\n")
           }
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@contextstream/mcp-server",
   "mcpName": "io.github.contextstreamio/mcp-server",
-  "version": "0.4.20",
+  "version": "0.4.21",
   "description": "ContextStream MCP server - v0.4.x with consolidated domain tools (~11 tools, ~75% token reduction). Code context, memory, search, and AI tools.",
   "type": "module",
   "license": "MIT",