erne-universal 0.6.0 → 0.6.2

package/README.md

@@ -8,7 +8,7 @@
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)
 
 <p align="center">
-  <video src="https://github.com/JubaKitiashvili/everything-react-native-expo/raw/main/demo-dashboard.mp4" autoplay loop muted playsinline width="800"></video>
+  <video src="https://github.com/user-attachments/assets/08e578e9-1bbd-49af-bac4-0b18365137af" autoplay loop muted playsinline width="800"></video>
 </p>
 
 ---

package/dashboard/activity-history.json

@@ -117,6 +117,32 @@
       "task": "Design navigation stack with tab bar and modal routes",
       "timestamp": "2026-03-11T15:49:36.120Z",
       "durationMs": 9690
+    },
+    {
+      "type": "planning",
+      "task": "Design navigation architecture for profile feature",
+      "timestamp": "2026-03-13T07:43:37.547Z"
+    },
+    {
+      "type": "complete",
+      "task": "Navigation architecture designed",
+      "timestamp": "2026-03-13T07:45:24.549Z",
+      "durationMs": null
+    },
+    {
+      "type": "planning",
+      "task": "Design navigation architecture for profile feature",
+      "timestamp": "2026-03-13T07:46:03.674Z"
+    },
+    {
+      "type": "planning",
+      "task": "Planning authentication flow with biometrics",
+      "timestamp": "2026-03-13T07:48:50.155Z"
+    },
+    {
+      "type": "planning",
+      "task": "Sprint planning — designing v2.0 architecture",
+      "timestamp": "2026-03-13T07:50:26.185Z"
     }
   ],
   "native-bridge-builder": [
@@ -167,6 +193,27 @@
       "task": "Configure push notification native module",
       "timestamp": "2026-03-11T15:49:44.129Z",
       "durationMs": 16888
+    },
+    {
+      "type": "start",
+      "task": "Building camera Turbo Module",
+      "timestamp": "2026-03-13T07:43:37.606Z"
+    },
+    {
+      "type": "complete",
+      "task": "Camera Turbo Module ready",
+      "timestamp": "2026-03-13T07:46:46.399Z",
+      "durationMs": 188793
+    },
+    {
+      "type": "start",
+      "task": "Creating haptic feedback native module",
+      "timestamp": "2026-03-13T07:48:50.180Z"
+    },
+    {
+      "type": "planning",
+      "task": "Sprint planning — designing v2.0 architecture",
+      "timestamp": "2026-03-13T07:50:26.185Z"
     }
   ],
   "expo-config-resolver": [
@@ -184,6 +231,32 @@
       "type": "planning",
       "task": "Design navigation architecture for the app",
       "timestamp": "2026-03-11T15:49:21.419Z"
+    },
+    {
+      "type": "planning",
+      "task": "Design navigation architecture for profile feature",
+      "timestamp": "2026-03-13T07:43:37.547Z"
+    },
+    {
+      "type": "complete",
+      "task": "Config resolved for Expo SDK 52",
+      "timestamp": "2026-03-13T07:45:24.557Z",
+      "durationMs": null
+    },
+    {
+      "type": "planning",
+      "task": "Design navigation architecture for profile feature",
+      "timestamp": "2026-03-13T07:46:03.674Z"
+    },
+    {
+      "type": "planning",
+      "task": "Planning authentication flow with biometrics",
+      "timestamp": "2026-03-13T07:48:50.155Z"
+    },
+    {
+      "type": "planning",
+      "task": "Sprint planning — designing v2.0 architecture",
+      "timestamp": "2026-03-13T07:50:26.185Z"
     }
   ],
   "ui-designer": [
@@ -270,6 +343,21 @@
       "task": "Create design system tokens and component library",
       "timestamp": "2026-03-11T15:49:40.625Z",
       "durationMs": 13588
+    },
+    {
+      "type": "start",
+      "task": "Create responsive card layout with NativeWind",
+      "timestamp": "2026-03-13T07:43:37.574Z"
+    },
+    {
+      "type": "start",
+      "task": "Design bottom sheet with gesture handler",
+      "timestamp": "2026-03-13T07:48:50.188Z"
+    },
+    {
+      "type": "planning",
+      "task": "Sprint planning — designing v2.0 architecture",
+      "timestamp": "2026-03-13T07:50:26.185Z"
     }
   ],
   "code-reviewer": [
@@ -336,6 +424,21 @@
       "task": "Review PR #42: navigation refactor",
       "timestamp": "2026-03-11T15:49:45.733Z",
       "durationMs": 18087
+    },
+    {
+      "type": "start",
+      "task": "Review authentication module",
+      "timestamp": "2026-03-13T07:43:37.591Z"
+    },
+    {
+      "type": "start",
+      "task": "Review payment integration module",
+      "timestamp": "2026-03-13T07:48:50.195Z"
+    },
+    {
+      "type": "planning",
+      "task": "Sprint planning — designing v2.0 architecture",
+      "timestamp": "2026-03-13T07:50:26.185Z"
     }
   ],
   "upgrade-assistant": [
@@ -353,6 +456,21 @@
       "type": "planning",
       "task": "Design navigation architecture for the app",
       "timestamp": "2026-03-11T15:49:21.419Z"
+    },
+    {
+      "type": "start",
+      "task": "Migrating to Expo SDK 52",
+      "timestamp": "2026-03-13T07:43:37.614Z"
+    },
+    {
+      "type": "start",
+      "task": "Migrate from React Navigation 6 to 7",
+      "timestamp": "2026-03-13T07:48:50.203Z"
+    },
+    {
+      "type": "planning",
+      "task": "Sprint planning — designing v2.0 architecture",
+      "timestamp": "2026-03-13T07:50:26.185Z"
     }
   ],
   "tdd-guide": [
@@ -424,6 +542,21 @@
       "task": "Write unit tests for auth service layer",
       "timestamp": "2026-03-11T15:49:44.931Z",
       "durationMs": 17489
+    },
+    {
+      "type": "start",
+      "task": "Writing test suite for auth service",
+      "timestamp": "2026-03-13T07:43:37.582Z"
+    },
+    {
+      "type": "start",
+      "task": "Writing E2E tests for checkout flow",
+      "timestamp": "2026-03-13T07:48:50.210Z"
+    },
+    {
+      "type": "planning",
+      "task": "Sprint planning — designing v2.0 architecture",
+      "timestamp": "2026-03-13T07:50:26.185Z"
     }
   ],
   "performance-profiler": [
@@ -474,6 +607,21 @@
       "task": "Profile app startup time and optimize TTI",
       "timestamp": "2026-03-11T15:49:46.535Z",
       "durationMs": 18686
+    },
+    {
+      "type": "start",
+      "task": "Analyze re-renders in feed screen",
+      "timestamp": "2026-03-13T07:43:37.598Z"
+    },
+    {
+      "type": "start",
+      "task": "Profiling Hermes bundle size",
+      "timestamp": "2026-03-13T07:48:50.218Z"
+    },
+    {
+      "type": "planning",
+      "task": "Sprint planning — designing v2.0 architecture",
+      "timestamp": "2026-03-13T07:50:26.185Z"
     }
   ],
   "senior-developer": [
@@ -555,6 +703,43 @@
       "task": "Implement authentication flow with biometric login",
       "timestamp": "2026-03-11T15:49:37.623Z",
       "durationMs": 10991
+    },
+    {
+      "type": "start",
+      "task": "Implement ProfileScreen with avatar and stats",
+      "timestamp": "2026-03-13T07:43:37.556Z"
+    },
+    {
+      "type": "complete",
+      "task": "ProfileScreen implemented",
+      "timestamp": "2026-03-13T07:45:24.565Z",
+      "durationMs": 107009
+    },
+    {
+      "type": "start",
+      "task": "Implement ProfileScreen with avatar and stats",
+      "timestamp": "2026-03-13T07:46:03.682Z"
+    },
+    {
+      "type": "complete",
+      "task": "ProfileScreen implemented",
+      "timestamp": "2026-03-13T07:46:46.383Z",
+      "durationMs": 42701
+    },
+    {
+      "type": "start",
+      "task": "Implement settings screen with dark mode toggle",
+      "timestamp": "2026-03-13T07:46:46.916Z"
+    },
+    {
+      "type": "start",
+      "task": "Build chat screen with real-time messaging",
+      "timestamp": "2026-03-13T07:48:50.163Z"
+    },
+    {
+      "type": "planning",
+      "task": "Sprint planning — designing v2.0 architecture",
+      "timestamp": "2026-03-13T07:50:26.185Z"
     }
   ],
   "feature-builder": [
@@ -636,6 +821,43 @@
       "task": "Build onboarding carousel with animations",
       "timestamp": "2026-03-11T15:49:39.125Z",
       "durationMs": 12290
+    },
+    {
+      "type": "start",
+      "task": "Build user onboarding flow",
+      "timestamp": "2026-03-13T07:43:37.566Z"
+    },
+    {
+      "type": "complete",
+      "task": "Onboarding flow complete",
+      "timestamp": "2026-03-13T07:45:24.573Z",
+      "durationMs": 107007
+    },
+    {
+      "type": "start",
+      "task": "Build user onboarding flow",
+      "timestamp": "2026-03-13T07:46:03.689Z"
+    },
+    {
+      "type": "complete",
+      "task": "Onboarding flow complete",
+      "timestamp": "2026-03-13T07:46:46.391Z",
+      "durationMs": 42702
+    },
+    {
+      "type": "start",
+      "task": "Add push notification handler",
+      "timestamp": "2026-03-13T07:46:46.924Z"
+    },
+    {
+      "type": "start",
+      "task": "Implement deep linking for shared content",
+      "timestamp": "2026-03-13T07:48:50.171Z"
+    },
+    {
+      "type": "planning",
+      "task": "Sprint planning — designing v2.0 architecture",
+      "timestamp": "2026-03-13T07:50:26.185Z"
     }
   ]
 }

package/dashboard/server.js

@@ -344,6 +344,9 @@ const server = http.createServer(async (req, res) => {
 wss = new WebSocketServer({ server, maxPayload: 65536 });
 
 wss.on('connection', (ws) => {
+  ws.isAlive = true;
+  ws.on('pong', () => { ws.isAlive = true; });
+
   ws.send(JSON.stringify({
     type: 'init',
     agents: agentState,
@@ -366,6 +369,15 @@ wss.on('connection', (ws) => {
   });
 });
 
+// Heartbeat: ping every 30s, terminate dead connections
+setInterval(() => {
+  for (const ws of wss.clients) {
+    if (!ws.isAlive) { ws.terminate(); continue; }
+    ws.isAlive = false;
+    ws.ping();
+  }
+}, 30000);
+
 server.listen(PORT, () => {
   console.log(`ERNE Dashboard running on http://localhost:${PORT}`);
 });

package/docs/getting-started.md

@@ -23,7 +23,7 @@ ERNE's `init` command deep-scans your project across 15 stack dimensions — nav
 ```
 .claude/
   agents/       # 11 specialized AI agents
-  rules/        # 25 coding standard rules (layered by platform)
+  rules/        # 26 coding standard rules (layered by platform)
   commands/     # 19 slash commands
   contexts/     # 3 behavior modes (dev, review, vibe)
   hooks.json    # Git-style hooks for quality enforcement
@@ -56,9 +56,35 @@ Control quality enforcement level:
 
 Change profile: set `ERNE_PROFILE=minimal|standard|strict` in your environment.
 
+## Multi-Agent Orchestration
+
+Use `/orchestrate` to coordinate agents through a 5-phase pipeline:
+
+```
+/orchestrate "build user profile screen"
+```
+
+The pipeline orchestrator decomposes the task, dispatches agents (some in parallel), and validates results. See [Pipeline Documentation](pipeline.md) for details.
+
+## Memory Integration
+
+ERNE agents build persistent knowledge about your project across sessions. Patterns learned by one agent (e.g., architect discovering a naming convention) are available to all other agents in future sessions. See [Memory Integration](memory-integration.md) for details.
+
+## Troubleshooting
+
+| Problem | Solution |
+|---------|----------|
+| `init` fails with "No React Native project detected" | Make sure `package.json` has `react-native` or `expo` in dependencies |
+| Hooks not running | Check `ERNE_PROFILE` env var and `.claude/hooks.json` |
+| Wrong variant selected | Re-run `npx erne-universal init` — it's safe to run multiple times |
+| Dashboard won't start | Run `erne doctor` to check setup, ensure port 3333 is free |
+| MCP server errors | Verify required tools are installed (Xcode for agent-device, etc.) |
+
 ## Learn More
 
-- [Agents](agents.md) — How specialized agents work
+- [Agents](agents.md) — How 11 specialized agents work
 - [Commands](commands.md) — All 19 slash commands
+- [Pipeline & Orchestration](pipeline.md) — Multi-agent workflow coordination
+- [Memory Integration](memory-integration.md) — Cross-session learning
 - [Hook Profiles](hooks-profiles.md) — Quality enforcement system
 - [Creating Skills](creating-skills.md) — Extend ERNE with custom knowledge

package/lib/doctor.js

@@ -38,6 +38,9 @@ async function doctor() {
   // 8. Check node_modules
   results.push(checkNodeModules(cwd));
 
+  // 9. Check variant files were applied
+  results.push(checkVariants(cwd));
+
   // Print
   console.log('\n  ERNE Doctor — Project Health Check\n');
   for (const r of results) {
@@ -215,4 +218,37 @@ function checkNodeModules(cwd) {
   return { pass: false, message: 'node_modules not found (run npm install)' };
 }
 
+function checkVariants(cwd) {
+  const settingsPath = path.join(cwd, '.claude', 'settings.json');
+  if (!fs.existsSync(settingsPath)) {
+    return { pass: true, message: 'Variants: cannot check (no settings.json)' };
+  }
+  try {
+    const data = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+    const detection = data.detection;
+    if (!detection || !detection.stack) {
+      return { pass: true, message: 'Variants: no detection data in settings' };
+    }
+
+    // Check a key variant file — if state-management was detected, the variant should differ from generic
+    const stateMgmt = path.join(cwd, '.claude', 'rules', 'common', 'state-management.md');
+    if (!fs.existsSync(stateMgmt)) {
+      return { pass: true, message: 'Variants: rules not installed (run erne init)' };
+    }
+
+    const content = fs.readFileSync(stateMgmt, 'utf8');
+    const state = detection.stack.state;
+    if (state && state !== 'none') {
+      const hasVariantHint = content.includes(state) || content.includes('Zustand') || content.includes('Redux') || content.includes('MobX');
+      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: true, message: 'Variants: no state management detected' };
+  } catch {
+    return { pass: true, message: 'Variants: could not verify (settings parse error)' };
+  }
+}
+
 module.exports = doctor;

package/lib/generate.js

@@ -249,7 +249,7 @@ function generateConfig(erneRoot, targetDir, detection, profile, mcpSelections)
     if (!targetPath.startsWith('rules/')) continue;
     const variantName = selectVariant(targetPath, detection);
     if (!variantName) continue;
-    const variantSrc = path.join(erneRoot, 'variants', variantName);
+    const variantSrc = path.join(erneRoot, 'rules', 'variants', variantName);
     if (fs.existsSync(variantSrc)) {
       const destFile = path.join(targetDir, targetPath);
       fs.mkdirSync(path.dirname(destFile), { recursive: true });
@@ -284,7 +284,7 @@ function generateConfig(erneRoot, targetDir, detection, profile, mcpSelections)
     if (!targetPath.startsWith('agents/')) continue;
     const variantName = selectVariant(targetPath, detection);
     if (!variantName) continue;
-    const variantSrc = path.join(erneRoot, 'variants', variantName);
+    const variantSrc = path.join(erneRoot, 'agents', 'variants', variantName);
     if (fs.existsSync(variantSrc)) {
       const destFile = path.join(targetDir, targetPath);
       fs.mkdirSync(path.dirname(destFile), { recursive: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "erne-universal",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Complete AI coding agent harness for React Native and Expo development",
   "keywords": [
     "react-native",
@@ -11,11 +11,15 @@
     "coding-assistant"
   ],
   "license": "MIT",
+  "author": "Juba Kitiashvili",
   "repository": {
     "type": "git",
-    "url": "https://github.com/JubaKitiashvili/everything-react-native-expo"
+    "url": "git+https://github.com/JubaKitiashvili/everything-react-native-expo.git"
   },
   "homepage": "https://erne.dev",
+  "bugs": {
+    "url": "https://github.com/JubaKitiashvili/everything-react-native-expo/issues"
+  },
   "bin": {
     "erne": "./bin/cli.js"
   },