erne-universal 0.12.8 → 0.13.0

package/README.md

@@ -13,19 +13,28 @@
 
 > **Prerequisite:** [Claude Code](https://claude.ai/claude-code) is required for the full experience (13 agents, pipeline orchestration, dashboard, hooks). Other IDEs receive adaptive rules and configuration — see [IDE Support](#%EF%B8%8F-ide--editor-support).
 
-### Install & Setup
+### Install
+
+```bash
+# Install globally (recommended)
+npm i -g erne-universal
+```
+
+### Setup
 
 ```bash
 # One-time setup in your React Native / Expo project
-npx erne-universal init
+erne init
 
 # Launch the dashboard
-npx erne-universal dashboard
+erne dashboard
 
 # Or do both at once
-npx erne-universal start
+erne start
 ```
 
+> **Without global install:** use `npx erne-universal` instead of `erne` (slower — downloads each time).
+
 ### What `init` does:
 
 1. 🔍 **Deep-scans your project** — detects 15 stack dimensions (state management, navigation, styling, lists, images, forms, storage, testing, build system, component style, monorepo, New Architecture, and more)
@@ -36,14 +45,15 @@ npx erne-universal start
 ### CLI Commands
 
 ```bash
-npx erne-universal init                  # Setup ERNE in your project
-npx erne-universal dashboard             # Launch dashboard
-npx erne-universal start                 # Init + dashboard
-npx erne-universal doctor                # Health check (22 checks)
-npx erne-universal audit                 # Generate project documentation
-npx erne-universal worker --config w.json  # Start autonomous worker
-npx erne-universal sync-configs          # Export rules to other IDEs
-npx erne-universal uninstall             # Clean removal
+erne init                  # Setup ERNE in your project
+erne dashboard             # Launch dashboard
+erne start                 # Init + dashboard
+erne doctor                # Health check (22 checks)
+erne audit                 # Generate project documentation
+erne worker --config w.json  # Start autonomous worker
+erne sync-configs          # Export rules to other IDEs
+erne update                # Update to latest version
+erne uninstall             # Clean removal
 ```
 
 ---
@@ -54,7 +64,7 @@ npx erne-universal uninstall             # Clean removal
 | -------------------- | ----- | -------------------------------------------------------------------------------------------- |
 | 🤖 Agents            | 13    | Specialized AI agents incl. visual debugger, doc generator, smart routing                    |
 | 🔀 Agent variants    | 9     | Stack-adaptive agent configurations (StyleSheet vs NativeWind, Zustand vs Redux, etc.)       |
-| ⚡ Commands          | 23    | Slash commands for every React Native workflow (incl. /erne-debug-video)                     |
+| ⚡ Commands          | 24    | Slash commands for every React Native workflow (incl. /erne-debug-video, /erne-update)       |
 | 📏 Rule layers       | 5     | Conditional rules: common, expo, bare-rn, native-ios, native-android                         |
 | 🎯 Rule variants     | 15    | Stack-specific rules selected by deep detection (state, navigation, styling, security, etc.) |
 | 📚 Knowledge rules   | 29    | Expo SDK 55, RN 0.84, React 19.2, Reanimated, Skia, Gesture Handler, SVG, ExecuTorch, more   |
@@ -74,9 +84,9 @@ npx erne-universal uninstall             # Clean removal
 ERNE includes a real-time dashboard with 6 pages, pixel-art agent HQ, and adaptive fix integration.
 
 ```bash
-npx erne-universal dashboard              # Start on port 3333, open browser
-npx erne-universal dashboard --port 4444  # Custom port
-npx erne-universal start                  # Init + dashboard in one command
+erne dashboard              # Start on auto-detected port, open browser
+erne dashboard --port 4444  # Custom port
+erne start                  # Init + dashboard in one command
 ```
 
 ### Command Center

package/lib/claude-md.js

@@ -217,7 +217,7 @@ function generateFullClaudeMd(cwd, detection, ruleLayers, profile) {
     '',
     '## Dashboard',
     'ERNE includes a visual dashboard for monitoring agents, project health, worker status, and documentation.',
-    'Launch: `npx erne-universal dashboard`',
+    'Launch: `erne dashboard`',
     'The dashboard shows 6 tabs: HQ (pixel-art agent office), Worker (autonomous tickets), Health (doctor score), Docs (generated documentation), Project (stack & MCP), Insights (analytics).',
     '',
     '## Rules',
@@ -270,7 +270,7 @@ function generateAppendSection(ruleLayers, profile) {
     AVAILABLE_COMMANDS,
     '',
     '## Dashboard',
-    'ERNE includes a visual dashboard. Launch: `npx erne-universal dashboard`',
+    'ERNE includes a visual dashboard. Launch: `erne dashboard`',
     '',
   );
 

package/lib/dashboard.js

@@ -274,14 +274,22 @@ async function dashboard() {
   } catch {
     if (explicitPort) {
       console.error(`  Error: Port ${port} is already in use`);
+      console.error(`  Try a different port: erne dashboard --port ${port + 1}`);
       process.exit(1);
     }
     console.log(`  Port ${port} is busy, finding a free port...`);
-    try {
-      port = await findFreePort();
-      await checkPort(port);
-    } catch (err) {
-      console.error(`  Error: ${err.message}`);
+    // Scan ports directly instead of relying on registry
+    let found = false;
+    for (let candidate = port + 1; candidate <= 3399; candidate++) {
+      try {
+        await checkPort(candidate);
+        port = candidate;
+        found = true;
+        break;
+      } catch { continue; }
+    }
+    if (!found) {
+      console.error(`  Error: No free ports in range ${port}-3399`);
       process.exit(1);
     }
   }

package/lib/doctor.js

@@ -353,7 +353,7 @@ function checkVariants(cwd) {
       if (hasVariantHint) {
         return { pass: true, message: `Variants: stack-tailored rules applied (${state})` };
       }
-      return { pass: false, message: `Variants: state-management.md may be generic (expected ${state} variant). Re-run: npx erne-universal init` };
+      return { pass: false, message: `Variants: state-management.md may be generic (expected ${state} variant). Re-run: erne init` };
     }
     return { pass: true, message: 'Variants: no state management detected' };
   } catch {

package/lib/init.js

@@ -61,7 +61,7 @@ const frameworkLabels = {
 
 function parseArgs() {
   const args = process.argv.slice(3); // skip node, cli.js, init
-  const opts = { profile: null, mcp: null, yes: false, noMcp: false };
+  const opts = { profile: null, mcp: null, yes: false, noMcp: false, fresh: false };
 
   for (let i = 0; i < args.length; i++) {
     switch (args[i]) {
@@ -80,6 +80,9 @@ function parseArgs() {
       case '-y':
         opts.yes = true;
         break;
+      case '--fresh':
+        opts.fresh = true;
+        break;
     }
   }
 
@@ -171,7 +174,20 @@ module.exports = async function init() {
   const cwd = process.cwd();
 
   try {
-    console.log(`\n  ${c.bold}erne${c.reset} ${c.dim}\u2014 Setting up AI agent harness for React Native & Expo${c.reset}\n`);
+    // ─── Check for existing installation ───
+    const settingsPath = path.join(cwd, '.claude', 'settings.json');
+    let existingSettings = null;
+    try {
+      existingSettings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+    } catch { /* no existing installation */ }
+
+    const isUpdate = existingSettings && existingSettings.erneVersion && !opts.fresh;
+
+    if (isUpdate) {
+      console.log(`\n  ${c.bold}erne${c.reset} ${c.dim}\u2014 Updating ERNE (${existingSettings.erneVersion} → ${require('../package.json').version})${c.reset}\n`);
+    } else {
+      console.log(`\n  ${c.bold}erne${c.reset} ${c.dim}\u2014 Setting up AI agent harness for React Native & Expo${c.reset}\n`);
+    }
 
     // ─── Step 1: Detect project type ───
     console.log(`  ${c.bold}Step 1:${c.reset} Deep-scanning project...`);
@@ -179,8 +195,8 @@ module.exports = async function init() {
     printDetectionReport(detection);
 
     if (!detection.isRNProject) {
-      if (nonInteractive) {
-        console.log(`\n  ${warn} No React Native project detected \u2014 continuing (non-interactive mode).`);
+      if (nonInteractive || isUpdate) {
+        console.log(`\n  ${warn} No React Native project detected \u2014 continuing.`);
       } else {
         console.log(`\n  ${warn} No React Native project detected in current directory.`);
         const proceed = await rl.question('  Continue anyway? (y/N) ');
@@ -198,6 +214,9 @@ module.exports = async function init() {
     if (opts.profile && validProfiles.includes(opts.profile)) {
       profile = opts.profile;
       console.log(`\n  ${c.bold}Step 2:${c.reset} Hook profile \u2192 ${c.cyan}${profile}${c.reset}`);
+    } else if (isUpdate && existingSettings.profile && validProfiles.includes(existingSettings.profile)) {
+      profile = existingSettings.profile;
+      console.log(`\n  ${c.bold}Step 2:${c.reset} Hook profile \u2192 ${c.cyan}${profile}${c.reset} ${c.dim}(preserved)${c.reset}`);
     } else if (nonInteractive) {
       profile = 'standard';
       console.log(`\n  ${c.bold}Step 2:${c.reset} Hook profile \u2192 ${c.cyan}standard${c.reset}`);
@@ -222,6 +241,13 @@ module.exports = async function init() {
     if (opts.noMcp) {
       console.log(`\n  ${c.bold}Step 3:${c.reset} MCP servers \u2192 ${c.dim}none${c.reset}`);
       for (const key of allMcpKeys) mcpSelections[key] = false;
+    } else if (isUpdate && existingSettings.mcpSelections) {
+      // Preserve existing MCP selections on update
+      const preserved = existingSettings.mcpSelections;
+      for (const key of allMcpKeys) mcpSelections[key] = Array.isArray(preserved) ? preserved.includes(key) : !!preserved[key];
+      const enabledNames = allMcpKeys.filter(k => mcpSelections[k]);
+      const mcpDisplay = enabledNames.length > 0 ? enabledNames.join(', ') : 'none';
+      console.log(`\n  ${c.bold}Step 3:${c.reset} MCP servers \u2192 ${c.cyan}${mcpDisplay}${c.reset} ${c.dim}(preserved)${c.reset}`);
     } else if (opts.mcp !== null) {
       const mcpDisplay = opts.mcp.length > 0 ? opts.mcp.join(', ') : 'none';
       console.log(`\n  ${c.bold}Step 3:${c.reset} MCP servers \u2192 ${c.cyan}${mcpDisplay}${c.reset}`);
@@ -309,7 +335,7 @@ module.exports = async function init() {
 
     // ─── Footer ───
     console.log();
-    console.log(`  ${info} Dashboard: run ${c.cyan}npx erne-universal dashboard${c.reset} to launch`);
+    console.log(`  ${info} Dashboard: run ${c.cyan}erne dashboard${c.reset} to launch`);
     console.log();
     console.log(`  ${c.green}${c.bold}Done!${c.reset}`);
     console.log();

package/lib/update.js

@@ -19,7 +19,7 @@ module.exports = async function update() {
   // Check if ERNE is installed in this project
   if (!fs.existsSync(settingsPath)) {
     console.log('  ⚠ ERNE not found in this project.');
-    console.log('  Run "npx erne-universal init" to set up.');
+    console.log('  Run "erne init" to set up.');
     return;
   }
 
@@ -70,6 +70,6 @@ module.exports = async function update() {
     });
   } catch (err) {
     console.error('  Update failed:', err.message);
-    console.error('  Manual update: npm install -g erne-universal@latest && erne init');
+    console.error('  Manual update: npm i -g erne-universal@latest && erne init');
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "erne-universal",
-  "version": "0.12.8",
+  "version": "0.13.0",
   "description": "Complete AI coding agent harness for React Native and Expo \u2014 13 specialized agents, autonomous worker mode, visual debugging, smart routing",
   "keywords": [
     "react-native",