erne-universal 0.5.0 → 0.5.1

package/.cursorrules

@@ -32,7 +32,7 @@ You are an expert React Native and Expo developer working in an ERNE-powered pro
 - Never hardcode secrets — use env vars
 - Validate all deep link parameters
 - SSL pinning for sensitive APIs
-- `expo-secure-store` for tokens, never AsyncStorage
+- Use secure storage for tokens (expo-secure-store, react-native-keychain, etc.)
 
 # State Management
 - Zustand: UI state, preferences, navigation state

package/.windsurfrules

@@ -32,7 +32,7 @@ You are an expert React Native and Expo developer working in an ERNE-powered pro
 - Never hardcode secrets — use env vars
 - Validate all deep link parameters
 - SSL pinning for sensitive APIs
-- `expo-secure-store` for tokens, never AsyncStorage
+- Use secure storage for tokens (expo-secure-store, react-native-keychain, etc.)
 
 # State Management
 - Zustand: UI state, preferences, navigation state

package/AGENTS.md

@@ -40,7 +40,7 @@ You are an expert React Native and Expo developer. Follow these conventions stri
 - Environment variables for all secrets (never hardcode)
 - Validate and sanitize deep link parameters
 - SSL certificate pinning for sensitive endpoints
-- `expo-secure-store` for tokens — never use AsyncStorage for secrets
+- Use secure storage for tokens (expo-secure-store, react-native-keychain, etc.)
 - Enable ProGuard/R8 for Android release builds
 
 ### Git Workflow

package/GEMINI.md

@@ -34,7 +34,7 @@ You are an expert React Native and Expo developer working in an ERNE-powered pro
 - Never hardcode secrets — use env vars
 - Validate all deep link parameters
 - SSL pinning for sensitive APIs
-- `expo-secure-store` for tokens, never AsyncStorage
+- Use secure storage for tokens (expo-secure-store, react-native-keychain, etc.)
 
 ## State Management
 - Zustand: UI state, preferences, navigation state

package/agents/architect.md

@@ -13,7 +13,7 @@ Design feature architectures, navigation flows, and system structure for React N
 
 - **Feature decomposition**: Break complex features into implementable units with clear interfaces
 - **Navigation design**: Design Expo Router file-based layouts, tab structures, modal patterns, deep linking
-- **State management selection**: Recommend Zustand (client), TanStack Query (server), or Jotai (atomic) based on requirements
+- **State management selection**: Recommend Zustand (client) + TanStack Query (server), or Redux Toolkit for complex state requirements
 - **API layer planning**: Design data fetching patterns, caching strategies, optimistic updates
 - **Monorepo structure**: Organize shared packages, platform-specific code, config management
 

package/agents/variants/architect/monorepo.md

@@ -13,7 +13,7 @@ Design feature architectures, navigation flows, and system structure for React N
 
 - **Feature decomposition**: Break complex features into implementable units with clear interfaces
 - **Navigation design**: Design Expo Router file-based layouts, tab structures, modal patterns, deep linking
-- **State management selection**: Zustand for client state, TanStack Query for server state — no other state management libraries
+- **State management selection**: Recommend appropriate state management for the project (Zustand, Redux Toolkit, etc.) with TanStack Query for server state
 - **API layer planning**: Design data fetching patterns, caching strategies, optimistic updates
 - **Monorepo architecture**: Design workspace structure, shared packages, cross-package boundaries
 

package/agents/variants/architect/redux.md

@@ -13,7 +13,7 @@ Design feature architectures, navigation flows, and system structure for React N
 
 - **Feature decomposition**: Break complex features into implementable units with clear interfaces
 - **Navigation design**: Design navigation flows, tab structures, modal patterns, deep linking
-- **State management**: Redux Toolkit for all state — `createSlice` for domain state, `createAsyncThunk` for async operations, `createSelector` for derived data
+- **State management**: Redux Toolkit for state management. Use RTK Query for server state, or Redux Saga for complex async flows. `createSlice` for domain state, `createSelector` for derived data.
 - **API layer planning**: Design data fetching patterns with RTK createAsyncThunk, caching with RTK Query (optional), optimistic updates in reducers
 - **Monorepo structure**: Organize shared packages, platform-specific code, config management
 

package/dashboard/public/agents.js

@@ -393,6 +393,7 @@
   };
 
   const drawAgentSprites = (ctx) => {
+    if (!ctx) return;
     for (const [name, sprite] of Object.entries(agentSprites)) {
       // Use moving row while walking, otherwise status row
       const row = sprite.isMoving

package/dashboard/public/canvas.js

@@ -662,6 +662,7 @@
   };
 
   const drawOffice = (ctx, agents) => {
+    if (!ctx) return;
     // Background
     ctx.fillStyle = '#0a0a1a';
     ctx.fillRect(0, 0, CANVAS_W, CANVAS_H);

package/dashboard/public/overlay.js

@@ -114,15 +114,20 @@
     }
 
     var html = '';
+    var validTypes = { start: 1, complete: 1, planning: 1, timeout: 1 };
     for (var i = entries.length - 1; i >= 0; i--) {
       var e = entries[i];
+      var dotClass = validTypes[e.type] ? e.type : 'unknown';
+      var typeLabel = e.type === 'complete' ? 'Completed '
+        : e.type === 'timeout' ? 'Timed out '
+        : 'Started ';
       html +=
         '<div class="history-entry">' +
-          '<div class="history-dot ' + e.type + '"></div>' +
+          '<div class="history-dot ' + dotClass + '"></div>' +
           '<div class="history-info">' +
             '<div class="history-task">' + escapeHtml(e.task || 'Unknown task') + '</div>' +
             '<div class="history-time">' +
-              (e.type === 'complete' ? 'Completed ' : 'Started ') +
+              typeLabel +
               History.formatRelativeTime(e.timestamp) +
               ' at ' + History.formatTime(e.timestamp) +
             '</div>' +

package/dashboard/public/styles.css

@@ -83,8 +83,8 @@ canvas {
 .connection-dot.live { background: var(--green); }
 
 .panel-agents {
-  display: flex;
-  flex-wrap: wrap;
+  display: grid;
+  grid-template-columns: repeat(5, 1fr);
   overflow-y: auto;
   scrollbar-width: thin;
   scrollbar-color: var(--border) transparent;
@@ -99,9 +99,6 @@ canvas {
   cursor: pointer;
   transition: background 0.15s;
   border-radius: 4px;
-  min-width: 200px;
-  flex: 1 1 200px;
-  max-width: 300px;
 }
 
 .agent-row:hover { background: rgba(255,255,255,0.05); }

package/dashboard/server.js

@@ -32,6 +32,38 @@ const AGENT_DEFINITIONS = [
   { name: 'feature-builder', room: 'development' },
 ];
 
+// Rate limiting — 60 requests per minute per IP
+const RATE_LIMIT_WINDOW_MS = 60 * 1000;
+const RATE_LIMIT_MAX = 60;
+const rateLimitMap = new Map();
+
+const isRateLimited = (ip) => {
+  const now = Date.now();
+  const entry = rateLimitMap.get(ip);
+  if (!entry) {
+    rateLimitMap.set(ip, { timestamps: [now] });
+    return false;
+  }
+  // Prune timestamps outside the window
+  entry.timestamps = entry.timestamps.filter((t) => now - t < RATE_LIMIT_WINDOW_MS);
+  if (entry.timestamps.length >= RATE_LIMIT_MAX) {
+    return true;
+  }
+  entry.timestamps.push(now);
+  return false;
+};
+
+// Periodically clean up stale rate limit entries
+setInterval(() => {
+  const now = Date.now();
+  for (const [ip, entry] of rateLimitMap) {
+    entry.timestamps = entry.timestamps.filter((t) => now - t < RATE_LIMIT_WINDOW_MS);
+    if (entry.timestamps.length === 0) {
+      rateLimitMap.delete(ip);
+    }
+  }
+}, RATE_LIMIT_WINDOW_MS);
+
 const agentState = {};
 
 const initAgentState = () => {
@@ -185,6 +217,12 @@ setInterval(() => {
     if (agent.status !== 'idle' && agent.lastEvent) {
       const elapsed = now - new Date(agent.lastEvent).getTime();
       if (elapsed > AGENT_TIMEOUT_MS) {
+        const timeoutNow = new Date().toISOString();
+        addHistoryEntry(name, {
+          type: 'timeout',
+          task: agent.task,
+          timestamp: timeoutNow,
+        });
         agent.status = 'idle';
         agent.task = null;
         agent.startedAt = null;
@@ -193,14 +231,26 @@ setInterval(() => {
     }
   }
   if (changed) {
+    persistHistory();
     broadcastState();
   }
 }, TIMEOUT_CHECK_INTERVAL_MS);
 
+const MAX_PAYLOAD_BYTES = 64 * 1024; // 64KB
+
 const parseBody = (req) =>
   new Promise((resolve, reject) => {
     const chunks = [];
-    req.on('data', (chunk) => chunks.push(chunk));
+    let totalBytes = 0;
+    req.on('data', (chunk) => {
+      totalBytes += chunk.length;
+      if (totalBytes > MAX_PAYLOAD_BYTES) {
+        req.destroy();
+        reject(new RangeError('Payload too large'));
+        return;
+      }
+      chunks.push(chunk);
+    });
     req.on('end', () => {
       try {
         resolve(JSON.parse(Buffer.concat(chunks).toString()));
@@ -253,6 +303,12 @@ const server = http.createServer(async (req, res) => {
   }
 
   if (req.method === 'POST' && req.url === '/api/events') {
+    const clientIp = req.socket.remoteAddress || 'unknown';
+    if (isRateLimited(clientIp)) {
+      res.writeHead(429, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ error: 'Too many requests' }));
+      return;
+    }
     try {
       const body = await parseBody(req);
       const result = handleEvent(body);
@@ -265,8 +321,13 @@ const server = http.createServer(async (req, res) => {
         res.end(JSON.stringify(result));
       }
     } catch (e) {
-      res.writeHead(400, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({ error: 'Invalid JSON' }));
+      if (e instanceof RangeError && e.message === 'Payload too large') {
+        res.writeHead(413, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'Payload too large' }));
+      } else {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'Invalid JSON' }));
+      }
     }
     return;
   }

package/docs/agents.md

@@ -14,6 +14,8 @@ Agents are specialized AI personas with focused expertise. Each agent has specif
 | expo-config-resolver | EAS, app.config, build fixes | /build-fix, /deploy |
 | ui-designer | NativeWind, Reanimated, components | /animate, /component |
 | upgrade-assistant | Version migrations, breaking changes | /upgrade |
+| senior-developer | End-to-end feature implementation, screens, hooks, API, state | /code, /feature, /plan |
+| feature-builder | Focused feature units, works in parallel with senior-developer | /code, /feature, /component |
 
 ## How Agents Work
 

package/docs/getting-started.md

@@ -14,11 +14,15 @@ The installer will:
 3. Let you select MCP integrations (agent-device, GitHub, etc.)
 4. Generate all configuration files in `.claude/`
 
+### Adaptive Init System
+
+ERNE's `init` command deep-scans your project across 15 stack dimensions — navigation, state management, styling, lists, images, forms, storage, testing, and more. Based on what it finds, it selects from 24 variant templates to generate rules, agents, and hooks tailored to your exact stack. This means a Zustand + Expo Router project gets different guidance than a Redux Toolkit + React Navigation one, with no manual configuration required.
+
 ## What Gets Installed
 
 ```
 .claude/
-  agents/       # 8 specialized AI agents
+  agents/       # 10 specialized AI agents
   rules/        # 25 coding standard rules (layered by platform)
   commands/     # 16 slash commands
   contexts/     # 3 behavior modes (dev, review, vibe)

package/lib/claude-md.js

@@ -297,6 +297,22 @@ function handleClaudeMd(cwd, detection, profile, ruleLayers) {
     return 'regenerated';
   }
 
+  // Check if ERNE section was already appended (double-run protection)
+  if (existingContent.includes('# ERNE Configuration') || existingContent.includes('@import .claude/rules/')) {
+    // Treat as regenerate: strip old ERNE section and re-append
+    const erneSeparator = existingContent.indexOf('\n---\n\n# ERNE Configuration');
+    if (erneSeparator !== -1) {
+      const originalContent = existingContent.substring(0, erneSeparator);
+      const appendSection = generateAppendSection(ruleLayers);
+      fs.writeFileSync(claudeMdPath, originalContent + appendSection);
+      return 'regenerated';
+    }
+    // If we can't find the separator cleanly, regenerate fully
+    const content = generateFullClaudeMd(cwd, detection, ruleLayers);
+    fs.writeFileSync(claudeMdPath, content);
+    return 'regenerated';
+  }
+
   // Scenario B: Existing non-ERNE CLAUDE.md — backup + append
   if (!fs.existsSync(backupPath)) {
     fs.writeFileSync(backupPath, existingContent);

package/lib/dashboard.js

@@ -9,7 +9,7 @@ const path = require('path');
 const readline = require('readline/promises');
 const { stdin, stdout } = require('process');
 
-const HOOKS_PATH = path.resolve(__dirname, '..', 'hooks', 'hooks.json');
+const HOOKS_PATH = path.join(process.cwd(), '.claude', 'hooks.json');
 const SERVER_PATH = path.resolve(__dirname, '..', 'dashboard', 'server.js');
 
 function parseArgs(argv) {
@@ -104,6 +104,10 @@ function openBrowser(url) {
       execFileSync('open', [url]);
     } else if (platform === 'linux') {
       execFileSync('xdg-open', [url]);
+    } else if (platform === 'win32') {
+      execFileSync('cmd', ['/c', 'start', url]);
+    } else {
+      console.log('  Open in browser: ' + url);
     }
   } catch {
     // Silently ignore — browser open is best-effort

package/lib/generate.js

@@ -144,10 +144,17 @@ function selectVariant(targetPath, detection) {
 
 // ─── determineRuleLayers ───────────────────────────────────────────────────────
 
-function determineRuleLayers(detection) {
+function determineRuleLayers(detection, cwd) {
   const layers = ['common'];
   if (detection.framework === 'expo-managed' || detection.framework === 'expo-bare') layers.push('expo');
   if (detection.framework === 'bare-rn' || detection.framework === 'expo-bare') layers.push('bare-rn');
+
+  // Add native rule layers for bare projects with native directories
+  if (cwd && (detection.framework === 'bare-rn' || detection.framework === 'expo-bare')) {
+    if (fs.existsSync(path.join(cwd, 'ios'))) layers.push('native-ios');
+    if (fs.existsSync(path.join(cwd, 'android'))) layers.push('native-android');
+  }
+
   return layers;
 }
 
@@ -178,15 +185,30 @@ function mergeHookProfile(masterHooks, profileHooks, profileName) {
 // ─── Helper: copyDir ───────────────────────────────────────────────────────────
 
 function copyDir(src, dest) {
-  fs.mkdirSync(dest, { recursive: true });
-  const entries = fs.readdirSync(src, { withFileTypes: true });
+  try {
+    fs.mkdirSync(dest, { recursive: true });
+  } catch (err) {
+    console.error(`  ✗ Failed to create directory ${dest}: ${err.message}`);
+    return;
+  }
+  let entries;
+  try {
+    entries = fs.readdirSync(src, { withFileTypes: true });
+  } catch (err) {
+    console.error(`  ✗ Failed to read ${src}: ${err.message}`);
+    return;
+  }
   for (const entry of entries) {
     const srcPath = path.join(src, entry.name);
     const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
+    try {
+      if (entry.isDirectory()) {
+        copyDir(srcPath, destPath);
+      } else {
+        fs.copyFileSync(srcPath, destPath);
+      }
+    } catch (err) {
+      console.error(`  ✗ Failed to copy ${srcPath}: ${err.message}`);
     }
   }
 }
@@ -200,7 +222,9 @@ function safeDelete(filePath) {
 // ─── generateConfig ────────────────────────────────────────────────────────────
 
 function generateConfig(erneRoot, targetDir, detection, profile, mcpSelections) {
-  const ruleLayers = determineRuleLayers(detection);
+  // Derive project root (cwd) from targetDir (.claude dir is one level inside project)
+  const cwd = path.dirname(targetDir);
+  const ruleLayers = determineRuleLayers(detection, cwd);
   let mcpCount = 0;
 
   // 1. Copy universal content (commands, contexts, skills, hook scripts)
@@ -288,7 +312,7 @@ function generateConfig(erneRoot, targetDir, detection, profile, mcpSelections)
 
   // 7. Copy MCP configs
   if (mcpSelections && mcpSelections.length > 0) {
-    const mcpSrc = path.join(erneRoot, 'mcp');
+    const mcpSrc = path.join(erneRoot, 'mcp-configs');
     const mcpDest = path.join(targetDir, 'mcp');
     if (fs.existsSync(mcpSrc)) {
       fs.mkdirSync(mcpDest, { recursive: true });
@@ -305,6 +329,7 @@ function generateConfig(erneRoot, targetDir, detection, profile, mcpSelections)
   // 8. Write settings.json with full detection profile
   const settingsPath = path.join(targetDir, 'settings.json');
   const settings = {
+    erneVersion: require('../package.json').version,
     detection,
     profile,
     ruleLayers,

package/lib/init.js

@@ -64,6 +64,23 @@ function parseArgs() {
     }
   }
 
+  // Validate --profile value
+  const validProfileValues = ['minimal', 'standard', 'strict'];
+  if (opts.profile && !validProfileValues.includes(opts.profile)) {
+    console.error(`Invalid profile: "${opts.profile}". Valid profiles: ${validProfileValues.join(', ')}`);
+    process.exit(1);
+  }
+
+  // Validate --mcp values
+  const validMcpKeys = ['agent-device', 'github', 'supabase', 'firebase', 'figma', 'sentry'];
+  if (opts.mcp !== null && Array.isArray(opts.mcp)) {
+    const invalid = opts.mcp.filter(k => !validMcpKeys.includes(k));
+    if (invalid.length > 0) {
+      console.error(`Invalid MCP server(s): ${invalid.join(', ')}. Valid options: ${validMcpKeys.join(', ')}`);
+      process.exit(1);
+    }
+  }
+
   return opts;
 }
 
@@ -119,121 +136,122 @@ module.exports = async function init() {
 
   const cwd = process.cwd();
 
-  console.log('\n  erne — Setting up AI agent harness for React Native & Expo\n');
-
-  // ─── Step 1: Detect project type ───
-  console.log('  Scanning project...');
-  const detection = detectProject(cwd);
-  printDetectionReport(detection);
-
-  if (!detection.isRNProject) {
-    if (nonInteractive) {
-      console.log('\n  ⚠ No React Native project detected — continuing (non-interactive mode).');
-    } else {
-      console.log('\n  ⚠ No React Native project detected in current directory.');
-      const proceed = await rl.question('  Continue anyway? (y/N) ');
-      if (proceed.toLowerCase() !== 'y') {
-        console.log('  Aborted.');
-        rl.close();
-        return;
+  try {
+    console.log('\n  erne — Setting up AI agent harness for React Native & Expo\n');
+
+    // ─── Step 1: Detect project type ───
+    console.log('  Scanning project...');
+    const detection = detectProject(cwd);
+    printDetectionReport(detection);
+
+    if (!detection.isRNProject) {
+      if (nonInteractive) {
+        console.log('\n  ⚠ No React Native project detected — continuing (non-interactive mode).');
+      } else {
+        console.log('\n  ⚠ No React Native project detected in current directory.');
+        const proceed = await rl.question('  Continue anyway? (y/N) ');
+        if (proceed.toLowerCase() !== 'y') {
+          console.log('  Aborted.');
+          return;
+        }
       }
     }
-  }
 
-  // ─── Step 2: Choose hook profile ───
-  let profile;
-  const validProfiles = ['minimal', 'standard', 'strict'];
-
-  if (opts.profile && validProfiles.includes(opts.profile)) {
-    profile = opts.profile;
-    console.log(`\n  Step 2: Hook profile: ${profile} (from --profile flag)`);
-  } else if (nonInteractive) {
-    profile = 'standard';
-    console.log('\n  Step 2: Hook profile: standard (default)');
-  } else {
-    console.log('\n  Step 2: Select hook profile:\n');
-    console.log('    (a) minimal  — fast iteration, minimal checks');
-    console.log('    (b) standard — balanced quality + speed [recommended]');
-    console.log('    (c) strict   — production-grade enforcement');
-    console.log();
-
-    let profileChoice = await rl.question('  Profile (a/b/c) [b]: ');
-    profileChoice = profileChoice.toLowerCase() || 'b';
-    const profileMap = { a: 'minimal', b: 'standard', c: 'strict' };
-    profile = profileMap[profileChoice] || 'standard';
-  }
+    // ─── Step 2: Choose hook profile ───
+    let profile;
+    const validProfiles = ['minimal', 'standard', 'strict'];
 
-  // ─── Step 3: Select MCP integrations ───
-  const mcpSelections = {};
-  const allMcpKeys = ['agent-device', 'github', 'supabase', 'firebase', 'figma', 'sentry'];
-  const defaultMcpKeys = ['agent-device', 'github'];
-
-  if (opts.noMcp) {
-    console.log('\n  Step 3: MCP servers: none (--no-mcp)');
-    for (const key of allMcpKeys) mcpSelections[key] = false;
-  } else if (opts.mcp !== null) {
-    console.log(`\n  Step 3: MCP servers: ${opts.mcp.join(', ') || 'none'} (from --mcp flag)`);
-    for (const key of allMcpKeys) mcpSelections[key] = opts.mcp.includes(key);
-  } else if (opts.yes) {
-    console.log(`\n  Step 3: MCP servers: ${defaultMcpKeys.join(', ')} (defaults)`);
-    for (const key of allMcpKeys) mcpSelections[key] = defaultMcpKeys.includes(key);
-  } else {
-    console.log('\n  Step 3: MCP server integrations:\n');
-
-    // Recommended servers
-    console.log('  Recommended:');
-    const agentDevice = await rl.question('    [Y/n] agent-device — Control iOS Simulator & Android Emulator: ');
-    mcpSelections['agent-device'] = agentDevice.toLowerCase() !== 'n';
-
-    const github = await rl.question('    [Y/n] GitHub — PR management, issue tracking: ');
-    mcpSelections['github'] = github.toLowerCase() !== 'n';
-
-    // Optional servers
-    console.log('\n  Optional (press Enter to skip):');
-    const optionalServers = [
-      { key: 'supabase', label: 'Supabase — Database & auth' },
-      { key: 'firebase', label: 'Firebase — Analytics & push' },
-      { key: 'figma', label: 'Figma — Design token sync' },
-      { key: 'sentry', label: 'Sentry — Error tracking' },
-    ];
-
-    for (const server of optionalServers) {
-      const answer = await rl.question(`    [y/N] ${server.label}: `);
-      mcpSelections[server.key] = answer.toLowerCase() === 'y';
+    if (opts.profile && validProfiles.includes(opts.profile)) {
+      profile = opts.profile;
+      console.log(`\n  Step 2: Hook profile: ${profile} (from --profile flag)`);
+    } else if (nonInteractive) {
+      profile = 'standard';
+      console.log('\n  Step 2: Hook profile: standard (default)');
+    } else {
+      console.log('\n  Step 2: Select hook profile:\n');
+      console.log('    (a) minimal  — fast iteration, minimal checks');
+      console.log('    (b) standard — balanced quality + speed [recommended]');
+      console.log('    (c) strict   — production-grade enforcement');
+      console.log();
+
+      let profileChoice = await rl.question('  Profile (a/b/c) [b]: ');
+      profileChoice = profileChoice.toLowerCase() || 'b';
+      const profileMap = { a: 'minimal', b: 'standard', c: 'strict' };
+      profile = profileMap[profileChoice] || 'standard';
     }
-  }
 
-  if (rl) rl.close();
+    // ─── Step 3: Select MCP integrations ───
+    const mcpSelections = {};
+    const allMcpKeys = ['agent-device', 'github', 'supabase', 'firebase', 'figma', 'sentry'];
+    const defaultMcpKeys = ['agent-device', 'github'];
+
+    if (opts.noMcp) {
+      console.log('\n  Step 3: MCP servers: none (--no-mcp)');
+      for (const key of allMcpKeys) mcpSelections[key] = false;
+    } else if (opts.mcp !== null) {
+      console.log(`\n  Step 3: MCP servers: ${opts.mcp.join(', ') || 'none'} (from --mcp flag)`);
+      for (const key of allMcpKeys) mcpSelections[key] = opts.mcp.includes(key);
+    } else if (opts.yes) {
+      console.log(`\n  Step 3: MCP servers: ${defaultMcpKeys.join(', ')} (defaults)`);
+      for (const key of allMcpKeys) mcpSelections[key] = defaultMcpKeys.includes(key);
+    } else {
+      console.log('\n  Step 3: MCP server integrations:\n');
+
+      // Recommended servers
+      console.log('  Recommended:');
+      const agentDevice = await rl.question('    [Y/n] agent-device — Control iOS Simulator & Android Emulator: ');
+      mcpSelections['agent-device'] = agentDevice.toLowerCase() !== 'n';
+
+      const github = await rl.question('    [Y/n] GitHub — PR management, issue tracking: ');
+      mcpSelections['github'] = github.toLowerCase() !== 'n';
+
+      // Optional servers
+      console.log('\n  Optional (press Enter to skip):');
+      const optionalServers = [
+        { key: 'supabase', label: 'Supabase — Database & auth' },
+        { key: 'firebase', label: 'Firebase — Analytics & push' },
+        { key: 'figma', label: 'Figma — Design token sync' },
+        { key: 'sentry', label: 'Sentry — Error tracking' },
+      ];
+
+      for (const server of optionalServers) {
+        const answer = await rl.question(`    [y/N] ${server.label}: `);
+        mcpSelections[server.key] = answer.toLowerCase() === 'y';
+      }
+    }
 
-  // ─── Step 4: Generate config ───
-  console.log('\n  Step 4: Generating configuration...\n');
+    // ─── Step 4: Generate config ───
+    console.log('\n  Step 4: Generating configuration...\n');
 
-  const erneRoot = path.resolve(__dirname, '..');
-  const claudeDir = path.join(cwd, '.claude');
+    const erneRoot = path.resolve(__dirname, '..');
+    const claudeDir = path.join(cwd, '.claude');
 
-  // Convert mcpSelections object to array of enabled keys
-  const enabledMcp = Object.entries(mcpSelections)
-    .filter(([, enabled]) => enabled)
-    .map(([key]) => key);
+    // Convert mcpSelections object to array of enabled keys
+    const enabledMcp = Object.entries(mcpSelections)
+      .filter(([, enabled]) => enabled)
+      .map(([key]) => key);
 
-  const { ruleLayers, mcpCount } = generateConfig(erneRoot, claudeDir, detection, profile, enabledMcp);
+    const { ruleLayers, mcpCount } = generateConfig(erneRoot, claudeDir, detection, profile, enabledMcp);
 
-  // Print what was generated
-  console.log(`    ✓ .claude/ (agents, commands, rules, skills, contexts, hooks)`);
-  console.log(`    ✓ .claude/rules/ (layers: ${ruleLayers.join(', ')})`);
-  console.log(`    ✓ .claude/hooks.json (${profile} profile)`);
-  console.log(`    ✓ .claude/mcp/ (${mcpCount} servers)`);
-  console.log('    ✓ .claude/settings.json');
+    // Print what was generated
+    console.log(`    ✓ .claude/ (agents, commands, rules, skills, contexts, hooks)`);
+    console.log(`    ✓ .claude/rules/ (layers: ${ruleLayers.join(', ')})`);
+    console.log(`    ✓ .claude/hooks.json (${profile} profile)`);
+    console.log(`    ✓ .claude/mcp/ (${mcpCount} servers)`);
+    console.log('    ✓ .claude/settings.json');
 
-  // Handle CLAUDE.md
-  const claudeMdResult = handleClaudeMd(cwd, detection, profile, ruleLayers);
+    // Handle CLAUDE.md
+    const claudeMdResult = handleClaudeMd(cwd, detection, profile, ruleLayers);
 
-  const claudeMdMessages = {
-    appended: 'CLAUDE.md (appended — original backed up to CLAUDE.md.pre-erne)',
-    regenerated: 'CLAUDE.md (regenerated for detected stack)',
-    generated: 'CLAUDE.md (generated for detected stack)',
-  };
-  console.log(`    ✓ ${claudeMdMessages[claudeMdResult]}`);
+    const claudeMdMessages = {
+      appended: 'CLAUDE.md (appended — original backed up to CLAUDE.md.pre-erne)',
+      regenerated: 'CLAUDE.md (regenerated for detected stack)',
+      generated: 'CLAUDE.md (generated for detected stack)',
+    };
+    console.log(`    ✓ ${claudeMdMessages[claudeMdResult]}`);
 
-  console.log('\n  Done! Run /plan to start your first feature.\n');
+    console.log('\n  Done! Run /plan to start your first feature.\n');
+  } finally {
+    if (rl) rl.close();
+  }
 };