@everstateai/mcp 1.3.14 → 1.3.15

package/src/setup.ts

@@ -551,6 +551,81 @@ async function installHooks(projectDir: string, force: boolean = false) {
   logSuccess("Everstate tools added to approved commands");
 }
 
+// ============================================================================
+// Stack detection
+// ============================================================================
+
+const STACK_DETECT: Array<{ id: string; name: string; checks: Array<{ file: string; contains?: string }> }> = [
+  {
+    id: 'react',
+    name: 'React',
+    checks: [
+      { file: 'package.json', contains: '"react"' },
+      { file: 'vite.config.ts' },
+      { file: 'vite.config.js' },
+      { file: 'next.config.js' },
+      { file: 'next.config.mjs' },
+      { file: 'next.config.ts' },
+    ],
+  },
+  {
+    id: 'node',
+    name: 'Node.js',
+    checks: [
+      { file: 'package.json', contains: '"express"' },
+      { file: 'package.json', contains: '"fastify"' },
+      { file: 'package.json', contains: '"@nestjs/core"' },
+    ],
+  },
+  {
+    id: 'python',
+    name: 'Python',
+    checks: [
+      { file: 'pyproject.toml' },
+      { file: 'requirements.txt' },
+      { file: 'setup.py' },
+      { file: 'Pipfile' },
+      { file: 'manage.py' },
+    ],
+  },
+];
+
+function detectProjectStack(projectDir: string): { id: string; name: string } | null {
+  for (const stack of STACK_DETECT) {
+    for (const check of stack.checks) {
+      const filePath = path.join(projectDir, check.file);
+      if (!fs.existsSync(filePath)) continue;
+
+      if (check.contains) {
+        try {
+          const content = fs.readFileSync(filePath, 'utf8');
+          if (content.includes(check.contains)) {
+            return { id: stack.id, name: stack.name };
+          }
+        } catch {
+          continue;
+        }
+      } else {
+        return { id: stack.id, name: stack.name };
+      }
+    }
+  }
+  return null;
+}
+
+async function applyStackTemplate(apiKey: string, projectId: string, stackId: string): Promise<boolean> {
+  try {
+    const response = await httpPost(
+      "https://www.everstate.ai/api/projects/apply-stack-template",
+      { projectId, stack: stackId },
+      apiKey
+    );
+    return response && !response.error;
+  } catch {
+    return false;
+  }
+}
+
 // ============================================================================
 // Project config
 // ============================================================================
@@ -559,7 +634,7 @@ async function createProjectConfig(
   projectDir: string,
   apiKey: string,
   existingProjectId: string | null
-): Promise<{ projectId: string; projectName: string }> {
+): Promise<{ projectId: string; projectName: string; stack?: string }> {
   const configPath = path.join(projectDir, ".everstate.json");
 
   const existingConfig = readJsonFile(configPath);
@@ -586,16 +661,26 @@ async function createProjectConfig(
     }
   }
 
-  const config = {
+  // Detect project stack
+  const detectedStack = detectProjectStack(projectDir);
+
+  const config: Record<string, unknown> = {
     projectId: projectId || `proj_${Date.now()}`,
     projectName,
     createdAt: new Date().toISOString(),
     version: "1.0.0",
   };
 
+  if (detectedStack) {
+    config.stack = detectedStack.id;
+  }
+
   writeJsonFile(configPath, config);
   logSuccess(`Project configured: ${config.projectName}`);
-  return config;
+  if (detectedStack) {
+    logSuccess(`Detected stack: ${detectedStack.name}`);
+  }
+  return config as { projectId: string; projectName: string; stack?: string };
 }
 
 // ============================================================================
@@ -604,7 +689,7 @@ async function createProjectConfig(
 
 function updateGitignore(projectDir: string) {
   const gitignorePath = path.join(projectDir, ".gitignore");
-  const entries = ["# Everstate", ".claude/settings.local.json", ".claude/hooks/", ".claude/rules/"];
+  const entries = ["# Everstate", ".claude/settings.local.json", ".claude/hooks/", ".claude/rules/", ".cursor/rules/everstate.mdc", ".windsurf/rules/everstate.md"];
 
   let content = fs.existsSync(gitignorePath) ? fs.readFileSync(gitignorePath, "utf8") : "";
   const toAdd = entries.filter((e) => !content.includes(e.replace("# Everstate", "")));
@@ -665,6 +750,104 @@ function ensureClaudeMd(projectDir: string) {
   }
 }
 
+// ============================================================================
+// Cursor Rules (.cursor/rules/everstate.mdc)
+// ============================================================================
+
+const CURSOR_RULES_CONTENT = `---
+description: Everstate project memory - persistent context across sessions
+globs: "**/*"
+alwaysApply: true
+---
+
+# Everstate - Project Memory
+
+This project uses [Everstate](https://www.everstate.ai) for persistent memory across sessions.
+
+## MCP Tools Available
+
+You have Everstate MCP tools. Use them:
+
+| Tool | When to Use |
+|------|-------------|
+| \`sync\` | **Call at the START of every conversation** to load project context |
+| \`done\` | **Call BEFORE ending** to save session summary for next time |
+| \`recall\` | Search past sessions: \`recall({ query: "what did we try for X?" })\` |
+| \`log\` | Record progress: \`log({ type: "achievement", message: "..." })\` |
+| \`everstate\` | All 100+ actions: \`everstate({ action: "help" })\` |
+
+## Session Workflow
+
+1. **Start**: Call \`sync()\` first thing to load context (gotchas, tasks, last session)
+2. **During**: Use \`log()\` for progress, \`recall()\` to search memory
+3. **End**: Call \`done({ summary: "...", nextSteps: [...] })\` to save context
+`;
+
+function ensureCursorRules(projectDir: string) {
+  const rulesDir = path.join(projectDir, ".cursor", "rules");
+  const rulesPath = path.join(rulesDir, "everstate.mdc");
+
+  if (!fs.existsSync(rulesDir)) {
+    fs.mkdirSync(rulesDir, { recursive: true });
+  }
+  fs.writeFileSync(rulesPath, CURSOR_RULES_CONTENT);
+  logSuccess("Created .cursor/rules/everstate.mdc");
+}
+
+// ============================================================================
+// Windsurf Rules (.windsurf/rules/everstate.md)
+// ============================================================================
+
+const WINDSURF_RULES_CONTENT = `# Everstate - Project Memory
+
+This project uses [Everstate](https://www.everstate.ai) for persistent memory across sessions.
+
+## MCP Tools Available
+
+You have Everstate MCP tools. Use them:
+
+| Tool | When to Use |
+|------|-------------|
+| \`sync\` | **Call at the START of every conversation** to load project context |
+| \`done\` | **Call BEFORE ending** to save session summary for next time |
+| \`recall\` | Search past sessions: \`recall({ query: "what did we try for X?" })\` |
+| \`log\` | Record progress: \`log({ type: "achievement", message: "..." })\` |
+| \`everstate\` | All 100+ actions: \`everstate({ action: "help" })\` |
+
+## Session Workflow
+
+1. **Start**: Call \`sync()\` first thing to load context (gotchas, tasks, last session)
+2. **During**: Use \`log()\` for progress, \`recall()\` to search memory
+3. **End**: Call \`done({ summary: "...", nextSteps: [...] })\` to save context
+`;
+
+function ensureWindsurfRules(projectDir: string) {
+  const rulesDir = path.join(projectDir, ".windsurf", "rules");
+  const rulesPath = path.join(rulesDir, "everstate.md");
+
+  if (!fs.existsSync(rulesDir)) {
+    fs.mkdirSync(rulesDir, { recursive: true });
+  }
+  fs.writeFileSync(rulesPath, WINDSURF_RULES_CONTENT);
+  logSuccess("Created .windsurf/rules/everstate.md");
+}
+
+// ============================================================================
+// Install rules for detected non-Claude tools
+// ============================================================================
+
+function installToolRules(projectDir: string, configResults: ConfigureResult[]) {
+  for (const result of configResults) {
+    if (result.status !== "configured") continue;
+
+    if (result.id === "cursor") {
+      ensureCursorRules(projectDir);
+    } else if (result.id === "windsurf") {
+      ensureWindsurfRules(projectDir);
+    }
+  }
+}
+
 // ============================================================================
 // Setup summary
 // ============================================================================
@@ -673,6 +856,7 @@ function printSetupSummary(
   configResults: ConfigureResult[],
   projectDir: string,
   apiKey: string,
+  detectedStack?: string,
 ) {
   console.log("");
   console.log(c("green", "╔═══════════════════════════════════════════════════════════╗"));
@@ -708,6 +892,19 @@ function printSetupSummary(
   console.log(c("green", "    ✓ ") + "Project config".padEnd(22) + c("dim", ".everstate.json"));
   console.log(c("green", "    ✓ ") + "Session hooks".padEnd(22) + c("dim", ".claude/hooks/"));
   console.log(c("green", "    ✓ ") + "Permissions".padEnd(22) + c("dim", ".claude/settings.local.json"));
+  // Show rules files for detected tools
+  for (const result of configResults) {
+    if (result.status !== "configured") continue;
+    if (result.id === "cursor") {
+      console.log(c("green", "    ✓ ") + "Cursor rules".padEnd(22) + c("dim", ".cursor/rules/everstate.mdc"));
+    } else if (result.id === "windsurf") {
+      console.log(c("green", "    ✓ ") + "Windsurf rules".padEnd(22) + c("dim", ".windsurf/rules/everstate.md"));
+    }
+  }
+  if (detectedStack) {
+    const stackName = STACK_DETECT.find(s => s.id === detectedStack)?.name || detectedStack;
+    console.log(c("green", "    ✓ ") + "Stack template".padEnd(22) + c("dim", `${stackName} (gotchas + tasks)`));
+  }
   console.log("");
 
   // Next steps
@@ -775,8 +972,9 @@ async function runUpgrade(args: SetupArgs) {
       }
     }
 
-    logInfo("Updating hooks...");
+    logInfo("Updating hooks and rules...");
     await installHooks(projectDir, true);
+    installToolRules(projectDir, configResults);
 
     // Also run auto-update to install any new hook types (gotcha-check, implicit-progress)
     try {
@@ -937,6 +1135,30 @@ export async function runSetup(argv: string[]) {
     logInfo(`Project directory: ${shortenPath(projectDir)}`);
     const projectConfig = await createProjectConfig(projectDir, apiKey, args.projectId);
 
+    // ── Step 5b: Apply stack template if detected ──────────────────
+    if (projectConfig.stack) {
+      const stackName = STACK_DETECT.find(s => s.id === projectConfig.stack)?.name || projectConfig.stack;
+      let shouldApply = true;
+
+      if (!args.nonInteractive) {
+        const answer = await askQuestion(
+          `  Apply ${c("bold", stackName)} starter template (gotchas + tasks)? [Y/n] `,
+          "y"
+        );
+        shouldApply = answer.toLowerCase() !== "n";
+      }
+
+      if (shouldApply) {
+        logInfo(`Applying ${stackName} stack template...`);
+        const applied = await applyStackTemplate(apiKey, projectConfig.projectId, projectConfig.stack);
+        if (applied) {
+          logSuccess(`${stackName} gotchas and task template seeded`);
+        } else {
+          logSkip("Stack template will be available via: everstate({ action: 'project.apply_stack_template', params: { stack: '" + projectConfig.stack + "' } })");
+        }
+      }
+    }
+
     // ── Step 6: Install hooks ────────────────────────────────────────
     if (!args.skipHooks) {
       await installHooks(projectDir, args.force);
@@ -945,8 +1167,9 @@ export async function runSetup(argv: string[]) {
     // ── Step 7: Update .gitignore ────────────────────────────────────
     updateGitignore(projectDir);
 
-    // ── Step 8: Create .claude/rules/everstate.md ─────────────────────
+    // ── Step 8: Create rules files for detected tools ──────────────────
     ensureClaudeMd(projectDir);
+    installToolRules(projectDir, configResults);
 
     // ── Step 9: Write version file ───────────────────────────────────
     const versionFile = createVersionFile("setup");
@@ -974,7 +1197,7 @@ export async function runSetup(argv: string[]) {
     }
 
     // ── Summary ──────────────────────────────────────────────────────
-    printSetupSummary(configResults, projectDir, apiKey);
+    printSetupSummary(configResults, projectDir, apiKey, projectConfig.stack);
   } catch (error: any) {
     logError(`Setup failed: ${error.message}`);
     process.exit(1);