instar 0.7.41 → 0.7.42

package/dist/commands/init.js

@@ -27,6 +27,7 @@
  * Existing project adds .instar/ and appends to CLAUDE.md.
  */
 import fs from 'node:fs';
+import os from 'node:os';
 import path from 'node:path';
 import pc from 'picocolors';
 import { randomUUID } from 'node:crypto';
@@ -2173,17 +2174,77 @@ function installClaudeSettings(projectDir) {
             hooks.Notification = filtered;
         }
     }
-    // MCP Servers: Playwright for browser automation (used by setup wizard, Telegram setup, etc.)
-    if (!settings.mcpServers) {
-        settings.mcpServers = {};
-    }
-    const mcpServers = settings.mcpServers;
-    if (!mcpServers.playwright) {
-        mcpServers.playwright = {
-            command: 'npx',
-            args: ['-y', '@playwright/mcp@latest'],
-        };
+    // Remove stale mcpServers from settings.json — MCP servers belong in
+    // ~/.claude.json (local scope) or .mcp.json, NOT .claude/settings.json
+    if (settings.mcpServers) {
+        delete settings.mcpServers;
     }
     fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+    // MCP Servers: Register Playwright in the correct locations
+    // Claude Code reads MCP servers from ~/.claude.json and .mcp.json, NOT .claude/settings.json
+    registerPlaywrightMcp(projectDir);
+}
+/**
+ * Register Playwright MCP server in the correct locations for Claude Code.
+ *
+ * Claude Code reads MCP servers from:
+ *   1. ~/.claude.json — local scope (projects["/path"].mcpServers) — no trust dialog
+ *   2. .mcp.json in project root — project scope — requires trust acceptance
+ *
+ * We register in both for robustness.
+ */
+function registerPlaywrightMcp(projectDir) {
+    const absDir = path.resolve(projectDir);
+    // ── 1. Register in ~/.claude.json at local scope ──
+    const claudeJsonPath = path.join(os.homedir(), '.claude.json');
+    try {
+        let claudeJson = {};
+        if (fs.existsSync(claudeJsonPath)) {
+            claudeJson = JSON.parse(fs.readFileSync(claudeJsonPath, 'utf-8'));
+        }
+        if (!claudeJson.projects || typeof claudeJson.projects !== 'object') {
+            claudeJson.projects = {};
+        }
+        const projects = claudeJson.projects;
+        if (!projects[absDir]) {
+            projects[absDir] = {};
+        }
+        const projectEntry = projects[absDir];
+        if (!projectEntry.mcpServers || typeof projectEntry.mcpServers !== 'object') {
+            projectEntry.mcpServers = {};
+        }
+        const mcpServers = projectEntry.mcpServers;
+        if (!mcpServers.playwright) {
+            mcpServers.playwright = {
+                command: 'npx',
+                args: ['-y', '@playwright/mcp@latest'],
+            };
+        }
+        projectEntry.hasTrustDialogAccepted = true;
+        const tmpPath = `${claudeJsonPath}.${process.pid}.tmp`;
+        fs.writeFileSync(tmpPath, JSON.stringify(claudeJson, null, 2));
+        fs.renameSync(tmpPath, claudeJsonPath);
+    }
+    catch {
+        // Non-fatal
+    }
+    // ── 2. Create .mcp.json in project root ──
+    const mcpJsonPath = path.join(projectDir, '.mcp.json');
+    if (!fs.existsSync(mcpJsonPath)) {
+        try {
+            const mcpConfig = {
+                mcpServers: {
+                    playwright: {
+                        command: 'npx',
+                        args: ['-y', '@playwright/mcp@latest'],
+                    },
+                },
+            };
+            fs.writeFileSync(mcpJsonPath, JSON.stringify(mcpConfig, null, 2));
+        }
+        catch {
+            // Non-fatal
+        }
+    }
 }
 //# sourceMappingURL=init.js.map

package/dist/commands/setup.js

@@ -144,35 +144,75 @@ export async function runSetup(opts) {
     });
 }
 /**
- * Ensure .claude/settings.json in the given directory has the Playwright MCP
- * server registered. This is critical for the setup wizard — Claude Code loads
- * MCP servers at startup, so the file must exist BEFORE spawning the session.
+ * Register the Playwright MCP server so Claude Code has browser automation
+ * available when spawned for the setup wizard.
  *
- * The .npmignore excludes .claude/settings*.json from the published package,
- * so this function creates it for fresh npx installations.
+ * Claude Code loads MCP servers from THREE places (NOT .claude/settings.json):
+ *   1. ~/.claude.json — user scope (top-level mcpServers) or local scope
+ *      (projects["/abs/path"].mcpServers) — NO trust dialog needed
+ *   2. .mcp.json in project root — project scope — requires trust acceptance
+ *
+ * We register in BOTH places for robustness:
+ *   - ~/.claude.json local scope: guaranteed to work, no trust dialog
+ *   - .mcp.json: works if trust is pre-accepted or enableAllProjectMcpServers
  */
 function ensurePlaywrightMcp(dir) {
-    const claudeDir = path.join(dir, '.claude');
-    fs.mkdirSync(claudeDir, { recursive: true });
-    const settingsPath = path.join(claudeDir, 'settings.json');
-    let settings = {};
-    if (fs.existsSync(settingsPath)) {
-        try {
-            settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+    const absDir = path.resolve(dir);
+    // ── 1. Register in ~/.claude.json at local scope (most reliable) ──
+    const claudeJsonPath = path.join(os.homedir(), '.claude.json');
+    try {
+        let claudeJson = {};
+        if (fs.existsSync(claudeJsonPath)) {
+            claudeJson = JSON.parse(fs.readFileSync(claudeJsonPath, 'utf-8'));
+        }
+        // Ensure projects map exists
+        if (!claudeJson.projects || typeof claudeJson.projects !== 'object') {
+            claudeJson.projects = {};
+        }
+        const projects = claudeJson.projects;
+        // Ensure project entry exists
+        if (!projects[absDir]) {
+            projects[absDir] = {};
+        }
+        const projectEntry = projects[absDir];
+        // Register Playwright MCP at local scope
+        if (!projectEntry.mcpServers || typeof projectEntry.mcpServers !== 'object') {
+            projectEntry.mcpServers = {};
+        }
+        const mcpServers = projectEntry.mcpServers;
+        if (!mcpServers.playwright) {
+            mcpServers.playwright = {
+                command: 'npx',
+                args: ['-y', '@playwright/mcp@latest'],
+            };
         }
-        catch { /* start fresh if corrupted */ }
+        // Pre-accept trust so .mcp.json servers also load without a dialog
+        projectEntry.hasTrustDialogAccepted = true;
+        // Write atomically
+        const tmpPath = `${claudeJsonPath}.${process.pid}.tmp`;
+        fs.writeFileSync(tmpPath, JSON.stringify(claudeJson, null, 2));
+        fs.renameSync(tmpPath, claudeJsonPath);
     }
-    // Register Playwright MCP server if not already present
-    if (!settings.mcpServers) {
-        settings.mcpServers = {};
+    catch {
+        // Non-fatal — .mcp.json fallback below
     }
-    const mcpServers = settings.mcpServers;
-    if (!mcpServers.playwright) {
-        mcpServers.playwright = {
-            command: 'npx',
-            args: ['-y', '@playwright/mcp@latest'],
-        };
-        fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+    // ── 2. Also create .mcp.json in the project root (belt-and-suspenders) ──
+    const mcpJsonPath = path.join(dir, '.mcp.json');
+    if (!fs.existsSync(mcpJsonPath)) {
+        try {
+            const mcpConfig = {
+                mcpServers: {
+                    playwright: {
+                        command: 'npx',
+                        args: ['-y', '@playwright/mcp@latest'],
+                    },
+                },
+            };
+            fs.writeFileSync(mcpJsonPath, JSON.stringify(mcpConfig, null, 2));
+        }
+        catch {
+            // Non-fatal
+        }
     }
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "0.7.41",
+  "version": "0.7.42",
   "description": "Persistent autonomy infrastructure for AI agents",
   "type": "module",
   "main": "dist/index.js",