@contextstream/mcp-server 0.3.59 → 0.3.62

package/dist/index.js

@@ -7426,9 +7426,11 @@ If context still feels missing, increase \`max_tokens\` and/or call \`session_re
 
 ### Search, Graphs, and Code Intelligence (ContextStream-first)
 
+- Default order: \`session_smart_search\` -> \`search_hybrid\`/\`search_keyword\`/\`search_semantic\` -> graph tools -> local repo scans (rg/ls/find) only if ContextStream returns no results.
 - Use \`session_smart_search\` before scanning the repo or grepping.
 - Use \`search_semantic\`/\`search_hybrid\`/\`search_keyword\` for targeted queries.
 - For dependencies/impact/call paths, use \`graph_dependencies\`, \`graph_impact\`, and \`graph_call_path\`.
+- If the toolset is complete (Elite), prefer \`graph_call_path\` and \`graph_path\` for call relationships instead of manual searches.
 - If the graph is missing or stale, run \`graph_ingest\` (async by default with \`wait: false\`). Tell the user it can take a few minutes; optionally call \`projects_statistics\` to estimate time.
 
 ---
@@ -7508,8 +7510,8 @@ var CONTEXTSTREAM_RULES_MINIMAL = `
 - Every user message: \`context_smart(user_message="<user_message>", format="minified", max_tokens=400)\` BEFORE answering.
   - Use \`max_tokens=200\` for trivial/local edits, \`max_tokens=800\` for deep debugging/architecture.
 - Before risky/non-trivial work: check \`session_get_lessons(query="<topic>")\`; use \`session_get_user_context\` when preferences/style matter.
-- For discovery: use \`session_smart_search\` first; use \`search_semantic\`/\`search_hybrid\`/\`search_keyword\` for targeted lookups.
-- For code intelligence: use \`graph_dependencies\`/\`graph_impact\`/\`graph_call_path\`; run \`graph_ingest\` if the graph is missing (async by default, can take a few minutes).
+- For discovery: use \`session_smart_search\` first; use \`search_semantic\`/\`search_hybrid\`/\`search_keyword\` for targeted lookups; avoid local scans until ContextStream returns no results.
+- For code intelligence: use \`graph_dependencies\`/\`graph_impact\`/\`graph_call_path\`; if the toolset is complete (Elite), prefer \`graph_call_path\`/\`graph_path\` for call relationships; run \`graph_ingest\` if the graph is missing (async by default, can take a few minutes).
 - For distillation: use \`session_summary\` for quick context; use \`session_compress\` for long chats; use \`memory_summary\` or \`memory_distill_event\` to condense memory.
 - After meaningful work/decisions/preferences: \`session_capture(event_type=decision|preference|task|insight, title="...", content="...")\`.
 - On frustration/corrections/tool mistakes: \`session_capture_lesson(...)\`.
@@ -11580,6 +11582,136 @@ function globalRulesPathForEditor(editor) {
       return null;
   }
 }
+async function anyPathExists(paths) {
+  for (const candidate of paths) {
+    if (await fileExists(candidate)) return true;
+  }
+  return false;
+}
+async function isCodexInstalled() {
+  const home = homedir3();
+  const envHome = process.env.CODEX_HOME;
+  const candidates = [
+    envHome,
+    path6.join(home, ".codex"),
+    path6.join(home, ".codex", "config.toml"),
+    path6.join(home, ".config", "codex")
+  ].filter((candidate) => Boolean(candidate));
+  return anyPathExists(candidates);
+}
+async function isClaudeInstalled() {
+  const home = homedir3();
+  const candidates = [
+    path6.join(home, ".claude"),
+    path6.join(home, ".config", "claude")
+  ];
+  const desktopConfig = claudeDesktopConfigPath();
+  if (desktopConfig) candidates.push(desktopConfig);
+  if (process.platform === "darwin") {
+    candidates.push(path6.join(home, "Library", "Application Support", "Claude"));
+  } else if (process.platform === "win32") {
+    const appData = process.env.APPDATA;
+    if (appData) candidates.push(path6.join(appData, "Claude"));
+  }
+  return anyPathExists(candidates);
+}
+async function isWindsurfInstalled() {
+  const home = homedir3();
+  const candidates = [
+    path6.join(home, ".codeium"),
+    path6.join(home, ".codeium", "windsurf"),
+    path6.join(home, ".config", "codeium")
+  ];
+  if (process.platform === "darwin") {
+    candidates.push(path6.join(home, "Library", "Application Support", "Windsurf"));
+    candidates.push(path6.join(home, "Library", "Application Support", "Codeium"));
+  } else if (process.platform === "win32") {
+    const appData = process.env.APPDATA;
+    if (appData) {
+      candidates.push(path6.join(appData, "Windsurf"));
+      candidates.push(path6.join(appData, "Codeium"));
+    }
+  }
+  return anyPathExists(candidates);
+}
+async function isClineInstalled() {
+  const home = homedir3();
+  const candidates = [
+    path6.join(home, "Documents", "Cline"),
+    path6.join(home, ".cline"),
+    path6.join(home, ".config", "cline")
+  ];
+  return anyPathExists(candidates);
+}
+async function isKiloInstalled() {
+  const home = homedir3();
+  const candidates = [
+    path6.join(home, ".kilocode"),
+    path6.join(home, ".config", "kilocode")
+  ];
+  return anyPathExists(candidates);
+}
+async function isRooInstalled() {
+  const home = homedir3();
+  const candidates = [
+    path6.join(home, ".roo"),
+    path6.join(home, ".config", "roo")
+  ];
+  return anyPathExists(candidates);
+}
+async function isAiderInstalled() {
+  const home = homedir3();
+  const candidates = [
+    path6.join(home, ".aider.conf.yml"),
+    path6.join(home, ".config", "aider")
+  ];
+  return anyPathExists(candidates);
+}
+async function isCursorInstalled() {
+  const home = homedir3();
+  const candidates = [path6.join(home, ".cursor")];
+  if (process.platform === "darwin") {
+    candidates.push("/Applications/Cursor.app");
+    candidates.push(path6.join(home, "Applications", "Cursor.app"));
+    candidates.push(path6.join(home, "Library", "Application Support", "Cursor"));
+  } else if (process.platform === "win32") {
+    const localApp = process.env.LOCALAPPDATA;
+    const programFiles = process.env.ProgramFiles;
+    const programFilesX86 = process.env["ProgramFiles(x86)"];
+    if (localApp) candidates.push(path6.join(localApp, "Programs", "Cursor", "Cursor.exe"));
+    if (localApp) candidates.push(path6.join(localApp, "Cursor", "Cursor.exe"));
+    if (programFiles) candidates.push(path6.join(programFiles, "Cursor", "Cursor.exe"));
+    if (programFilesX86) candidates.push(path6.join(programFilesX86, "Cursor", "Cursor.exe"));
+  } else {
+    candidates.push("/usr/bin/cursor");
+    candidates.push("/usr/local/bin/cursor");
+    candidates.push("/opt/Cursor");
+    candidates.push("/opt/cursor");
+  }
+  return anyPathExists(candidates);
+}
+async function isEditorInstalled(editor) {
+  switch (editor) {
+    case "codex":
+      return isCodexInstalled();
+    case "claude":
+      return isClaudeInstalled();
+    case "cursor":
+      return isCursorInstalled();
+    case "windsurf":
+      return isWindsurfInstalled();
+    case "cline":
+      return isClineInstalled();
+    case "kilo":
+      return isKiloInstalled();
+    case "roo":
+      return isRooInstalled();
+    case "aider":
+      return isAiderInstalled();
+    default:
+      return false;
+  }
+}
 function buildContextStreamMcpServer(params) {
   const env = {
     CONTEXTSTREAM_API_URL: params.apiUrl,
@@ -11965,16 +12097,24 @@ Created API key: ${maskedNewKey}
     console.log("  2) Enhanced \u2014 more guidance + examples (higher token overhead)");
     const modeChoice = normalizeInput(await rl.question("Choose [1/2] (default 1): ")) || "1";
     const mode = modeChoice === "2" ? "full" : "minimal";
+    const detectedPlanName = await client.getPlanName();
+    const detectedGraphTier = await client.getGraphTier();
+    const graphTierLabel = detectedGraphTier === "full" ? "full graph" : detectedGraphTier === "lite" ? "graph-lite" : "none";
+    const planLabel = detectedPlanName ?? "unknown";
+    console.log(`
+Detected plan: ${planLabel} (graph: ${graphTierLabel})`);
     console.log("\nMCP toolset (which tools to expose to the AI):");
     console.log("  1) Light \u2014 core session, project, and basic memory/graph tools (~30 tools)");
     console.log("     Best for: faster responses, simpler workflows, resource-constrained environments");
     console.log("  2) Standard (recommended) \u2014 adds workspace, memory CRUD, graph analysis, search (~50 tools)");
-    console.log("     Best for: most users, full development workflow with memory and code analysis");
-    console.log("  3) Complete \u2014 all tools including AI, GitHub, Slack integrations (~86 tools)");
-    console.log("     Best for: power users needing integrations and advanced features");
+    console.log("     Best for: most users, full development workflow with memory + code analysis");
+    console.log("  3) Complete \u2014 all tools including full graph + AI, GitHub, Slack integrations (~86 tools)");
+    console.log("     Best for: Elite users or power users needing full graph + integrations");
     console.log("");
+    console.log("  Tip: Elite users should choose Complete to unlock full graph tools (call path, path, circular, unused).");
     console.log("  Tip: Change later by setting CONTEXTSTREAM_TOOLSET=light|standard|complete");
-    const toolsetChoice = normalizeInput(await rl.question("Choose [1/2/3] (default 2): ")) || "2";
+    const toolsetDefault = detectedGraphTier === "full" ? "3" : "2";
+    const toolsetChoice = normalizeInput(await rl.question(`Choose [1/2/3] (default ${toolsetDefault}): `)) || toolsetDefault;
     const toolset = toolsetChoice === "1" ? "light" : toolsetChoice === "3" ? "complete" : "standard";
     const editors = ["codex", "claude", "cursor", "windsurf", "cline", "kilo", "roo", "aider"];
     console.log('\nSelect editors to configure (comma-separated numbers, or "all"):');
@@ -11982,8 +12122,34 @@ Created API key: ${maskedNewKey}
     const selectedRaw = normalizeInput(await rl.question("Editors [all]: ")) || "all";
     const selectedNums = parseNumberList(selectedRaw, editors.length);
     const selectedEditors = selectedNums.length ? selectedNums.map((n) => editors[n - 1]) : editors;
-    const hasCodex = selectedEditors.includes("codex");
-    const hasProjectMcpEditors = selectedEditors.some((e) => supportsProjectMcpConfig(e));
+    const editorDetected = /* @__PURE__ */ new Map();
+    for (const editor of selectedEditors) {
+      editorDetected.set(editor, await isEditorInstalled(editor));
+    }
+    if (process.env.CODEX_CLI || process.env.CODEX_HOME) {
+      editorDetected.set("codex", true);
+    }
+    const undetectedEditors = selectedEditors.filter((editor) => !editorDetected.get(editor));
+    let allowUndetectedEditors = false;
+    if (undetectedEditors.length) {
+      console.log("\nEditors not detected on this system:");
+      undetectedEditors.forEach((editor) => console.log(`- ${EDITOR_LABELS[editor]}`));
+      console.log('If your editor is installed but not detected, choose "yes" to force config.');
+      const confirm = normalizeInput(await rl.question("Configure these anyway? [y/N]: ")).toLowerCase();
+      allowUndetectedEditors = confirm === "y" || confirm === "yes";
+    }
+    const configuredEditors = allowUndetectedEditors ? selectedEditors : selectedEditors.filter((editor) => editorDetected.get(editor));
+    const skippedEditors = selectedEditors.filter((editor) => !configuredEditors.includes(editor));
+    if (skippedEditors.length) {
+      console.log("\nSkipping editor setup:");
+      skippedEditors.forEach((editor) => console.log(`- ${EDITOR_LABELS[editor]}`));
+    }
+    if (configuredEditors.length) {
+      console.log("\nConfiguring editors:");
+      configuredEditors.forEach((editor) => console.log(`- ${EDITOR_LABELS[editor]}`));
+    }
+    const hasCodex = configuredEditors.includes("codex");
+    const hasProjectMcpEditors = configuredEditors.some((e) => supportsProjectMcpConfig(e));
     console.log("\nInstall rules as:");
     console.log("  1) Global");
     console.log("  2) Project");
@@ -12012,7 +12178,7 @@ Created API key: ${maskedNewKey}
     const needsGlobalMcpConfig = mcpScope === "global" || mcpScope === "both" || mcpScope === "project" && hasCodex;
     if (needsGlobalMcpConfig) {
       console.log("\nInstalling global MCP config...");
-      for (const editor of selectedEditors) {
+      for (const editor of configuredEditors) {
         if (mcpScope === "project" && editor !== "codex") continue;
         try {
           if (editor === "codex") {
@@ -12092,7 +12258,7 @@ Created API key: ${maskedNewKey}
     }
     if (scope === "global" || scope === "both") {
       console.log("\nInstalling global rules...");
-      for (const editor of selectedEditors) {
+      for (const editor of configuredEditors) {
         const filePath = globalRulesPathForEditor(editor);
         if (!filePath) {
           console.log(`- ${EDITOR_LABELS[editor]}: global rules need manual setup (project rules supported).`);
@@ -12176,7 +12342,7 @@ Applying to ${projects.length} project(s)...`);
         writeActions.push({ kind: "workspace-config", target: path6.join(projectPath, ".contextstream", "config.json"), status: "dry-run" });
       }
       if (mcpScope === "project" || mcpScope === "both") {
-        for (const editor of selectedEditors) {
+        for (const editor of configuredEditors) {
           try {
             if (editor === "cursor") {
               const cursorPath = path6.join(projectPath, ".cursor", "mcp.json");
@@ -12230,6 +12396,7 @@ Applying to ${projects.length} project(s)...`);
       }
       for (const editor of selectedEditors) {
         if (scope !== "project" && scope !== "both") continue;
+        if (!configuredEditors.includes(editor)) continue;
         const rule = generateRuleContent(editor, {
           workspaceName,
           workspaceId: workspaceId && workspaceId !== "dry-run" ? workspaceId : void 0,
@@ -12267,6 +12434,7 @@ Applying to ${projects.length} project(s)...`);
     console.log("- Prefer ContextStream search first: use session_smart_search (or mcp__contextstream__session_smart_search) before raw repo scans (rg/ls/find).");
     console.log("- If any tools require UI-based MCP setup (e.g. Cline/Kilo/Roo global), follow https://contextstream.io/docs/mcp.");
     if (toolset === "complete") {
+      console.log("- For full graph tools, run graph_ingest once per project (async; can take a few minutes).");
       console.log("- Note: Claude Code/Desktop may warn about large tool contexts. This is expected with the complete toolset.");
     }
   } finally {

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@contextstream/mcp-server",
-  "version": "0.3.59",
+  "mcpName": "io.github.contextstreamio/mcp-server",
+  "version": "0.3.62",
   "description": "MCP server exposing ContextStream public API - code context, memory, search, and AI tools for developers",
   "type": "module",
   "license": "MIT",