erne-universal 0.12.6 → 0.12.8

package/commands/erne-update.md

@@ -0,0 +1,36 @@
+---
+name: erne-update
+description: ERNE — Update ERNE itself to the latest version and re-initialize the project
+---
+
+# /erne-update — Update ERNE
+
+You are executing the `/erne-update` command. This updates the ERNE harness to the latest npm version and re-applies configuration to the current project.
+
+## Process
+
+Run the following command:
+
+```bash
+npx erne-universal@latest update
+```
+
+This will:
+1. Check npm for the latest `erne-universal` version
+2. Compare with the currently installed version
+3. If newer, re-run `erne init` preserving existing profile and MCP selections
+4. Update agents, skills, rules, hooks, and commands to the latest versions
+
+## When No Update Available
+
+If already on the latest version, inform the user and show the current version.
+
+## Manual Alternative
+
+If the update command fails, suggest:
+
+```bash
+npx erne-universal@latest init
+```
+
+This does a fresh init that preserves user choices (profile, MCP servers).

package/dashboard/server.js

@@ -1315,9 +1315,6 @@ async function resolvePort() {
 resolvePort().then((resolvedPort) => {
   PORT = resolvedPort;
 
-  // Register port in ~/.erne/ports.json
-  registerPort(projectDir, PORT, process.pid);
-
   // Cleanup on exit
   const cleanupRegistry = () => {
     unregisterPort(projectDir);
@@ -1332,7 +1329,13 @@ resolvePort().then((resolvedPort) => {
     process.exit(0);
   });
 
-  server.listen(PORT, () => {
+  // Retry with next free port on EADDRINUSE
+  let retries = 0;
+  const MAX_RETRIES = 10;
+
+  function startServer(port) {
+    PORT = port;
+    server.listen(PORT, () => {
     console.log(`ERNE Dashboard running on http://localhost:${PORT}`);
 
     // Wire tab handlers
@@ -1369,5 +1372,30 @@ resolvePort().then((resolvedPort) => {
         ecosystemHandler.autoRefresh(projectDir, broadcast);
       if (insightsHandler && insightsHandler.autoSnapshot) insightsHandler.autoSnapshot(projectDir);
     }, 5000);
+
+    // Register port after successful listen
+    registerPort(projectDir, PORT, process.pid);
+  });
+  }
+
+  server.on('error', (err) => {
+    if (err.code === 'EADDRINUSE' && retries < MAX_RETRIES) {
+      retries++;
+      // Find next free port
+      findFreePort().then((nextPort) => {
+        startServer(nextPort);
+      }).catch(() => {
+        console.error(`Error: No free ports available in range 3333-3399.`);
+        process.exit(1);
+      });
+    } else if (err.code === 'EADDRINUSE') {
+      console.error(`Error: All ports in range 3333-3399 are in use.`);
+      process.exit(1);
+    } else {
+      console.error(`Server error: ${err.message}`);
+      process.exit(1);
+    }
   });
+
+  startServer(PORT);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "erne-universal",
-  "version": "0.12.6",
+  "version": "0.12.8",
   "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",

package/scripts/validate-all.js

@@ -76,7 +76,7 @@ for (const f of agentFiles) {
 
 // Commands
 console.log('  Commands:');
-validateCount('commands', '.md', 23, 'commands/'); // 23 command files
+validateCount('commands', '.md', 24, 'commands/'); // 24 command files
 const cmdFiles = fs.readdirSync('commands').filter((f) => f.endsWith('.md'));
 for (const f of cmdFiles) {
   validateFrontmatter(path.join('commands', f), ['name', 'description']);