erne-universal 0.12.0 → 0.12.2

package/CLAUDE.md

@@ -122,7 +122,7 @@ When a user's message matches these signals, automatically use the corresponding
 | `expo-config-resolver`    | build error, red screen, crash, "won't start", error, "build failed", metro, babel, "config issue", "EAS build", "can't build", "module not found", "pod install", gradle, "Xcode error", "Android build", "iOS build", "linking error", prebuild, "app.json", "app.config", "plugin not working", "white screen", "blank screen"                                            |
 | `native-bridge-builder`   | "native module", bridge, "turbo module", Swift, Kotlin, Java, "Objective-C", "native code", "platform specific", "expo module", JSI, Fabric, "New Architecture", codegen, "C++", "native view", Nitro, "expo-modules-core"                                                                                                                                                   |
 | `upgrade-assistant`       | upgrade, update, version, migration, "breaking change", deprecated, "Expo SDK", "React Native version", bump, migrate, changelog, compatibility, "peer dependency", outdated, "npx expo install --fix"                                                                                                                                                                       |
-| `ui-designer`             | component, button, modal, form, screen, page, tab, "navigation UI", "build UI", "design system", styled, theme, icon, animation, transition, gesture, "bottom sheet", drawer, header, card, skeleton, loading, toast                                                                                                                                                         |
+| `ui-designer`             | component, button, modal, form, screen, page, tab, "navigation UI", "build UI", "design system", styled, theme, icon, animation, transition, gesture, "bottom sheet", drawer, header, card, skeleton, loading, toast, "apple style", "HIG", "iOS native feel", "apple design", "human interface"                                                                              |
 | `pipeline-orchestrator`   | deploy, publish, EAS, "app store", "play store", "CI/CD", release, "OTA update", submit, distribution, TestFlight, "internal testing", "code signing", provisioning, certificate, keystore, fastlane, "GitHub Actions"                                                                                                                                                       |
 | `senior-developer`        | "what do you think", opinion, advice, approach, tradeoff, "not sure how", mentor, "help me decide", "best way to", "should I", "pros and cons", "compare options", "which is better", "common pitfall", "production ready", scalable                                                                                                                                         |
 | `documentation-generator` | "generate docs", "document this", "write documentation", "project overview", "architecture docs", "what does this project do", "onboard me", "explain codebase", "project structure", "how does this work"                                                                                                                                                                   |
@@ -143,7 +143,7 @@ When a user's message matches these signals, automatically use the corresponding
 
 ## Available Commands
 
-Use `/erne-plan`, `/erne-code-review`, `/erne-tdd`, `/erne-build-fix`, `/erne-perf`, `/erne-upgrade`, `/erne-native-module`, `/erne-navigate`, `/erne-animate`, `/erne-deploy`, `/erne-component`, `/erne-debug`, `/erne-debug-visual`, `/erne-audit`, `/erne-quality-gate`, `/erne-code`, `/erne-feature`, `/erne-learn`, `/erne-retrospective`, `/erne-setup-device` for guided workflows.
+Use `/erne-plan`, `/erne-code-review`, `/erne-tdd`, `/erne-build-fix`, `/erne-perf`, `/erne-upgrade`, `/erne-native-module`, `/erne-navigate`, `/erne-animate`, `/erne-deploy`, `/erne-component`, `/erne-debug`, `/erne-debug-visual`, `/erne-audit`, `/erne-quality-gate`, `/erne-code`, `/erne-feature`, `/erne-learn`, `/erne-retrospective`, `/erne-setup-device`, `/erne-hig` for guided workflows.
 
 ## Worker Mode (Autonomous Ticket Execution)
 
@@ -206,6 +206,7 @@ Skills in `skills/` activate automatically:
 - `native-module-scaffold` — Create Turbo/Expo modules
 - `upgrade-workflow` — Version migration guide
 - `continuous-learning-v2` — Pattern extraction and learning
+- `hig` — Apple HIG design intelligence (build, review, animate, analyze)
 
 ---
 
@@ -224,7 +225,7 @@ Skills in `skills/` activate automatically:
 ## Available Commands
 
 /erne-plan, /erne-code-review, /erne-tdd, /erne-build-fix, /erne-perf, /erne-upgrade, /erne-native-module, /erne-debug, /erne-debug-visual, /erne-deploy,
-/erne-component, /erne-navigate, /erne-animate, /erne-orchestrate, /erne-quality-gate, /erne-code, /erne-feature, /erne-worker, /erne-audit, /erne-learn, /erne-retrospective, /erne-setup-device
+/erne-component, /erne-navigate, /erne-animate, /erne-orchestrate, /erne-quality-gate, /erne-code, /erne-feature, /erne-worker, /erne-audit, /erne-learn, /erne-retrospective, /erne-setup-device, /erne-hig
 
 ## Dashboard
 

package/README.md

@@ -7,26 +7,44 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)
 
-<p align="center">
-  <video src="https://github.com/user-attachments/assets/08e578e9-1bbd-49af-bac4-0b18365137af" autoplay loop muted playsinline width="800"></video>
-</p>
-
 ---
 
 ## ⚡ Quick Start
 
 > **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
+
 ```bash
+# One-time setup in your React Native / Expo project
 npx erne-universal init
+
+# Launch the dashboard
+npx erne-universal dashboard
+
+# Or do both at once
+npx erne-universal start
 ```
 
-This will:
+### What `init` does:
 
-1. 🔍 **Deep-scan your project** — detects 15 stack dimensions (state management, navigation, styling, lists, images, forms, storage, testing, build system, component style, monorepo, New Architecture, and more)
-2. 🎚️ Let you choose a hook profile (minimal / standard / strict)
+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)
+2. 🎚️ Lets you choose a hook profile (minimal / standard / strict)
 3. 🔌 Select MCP integrations (simulator control, GitHub, etc.)
-4. ⚙️ **Generate adaptive configuration** — selects from 24 variant templates matched to your exact stack (Zustand vs Redux, Expo Router vs React Navigation, NativeWind vs StyleSheet, etc.)
+4. ⚙️ **Generates adaptive configuration** — selects from 24 variant templates matched to your exact stack (Zustand vs Redux, Expo Router vs React Navigation, NativeWind vs StyleSheet, etc.)
+
+### 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
+```
 
 ---
 
@@ -56,10 +74,9 @@ This will:
 ERNE includes a real-time dashboard with 6 pages, pixel-art agent HQ, and adaptive fix integration.
 
 ```bash
-erne dashboard              # Start on port 3333, open browser
-erne dashboard --port 4444  # Custom port
-erne dashboard --no-open    # Don't open browser
-erne start                  # Init project + dashboard in background
+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
 ```
 
 ### Command Center

package/dashboard/lib/api/agents.js

@@ -70,6 +70,30 @@ function handleAgents(req, res, urlPath, body, staticDefs, agentState, activityH
       });
     }
 
+    // Discover agents from .claude/agents/ that aren't in static or custom lists
+    const projectDir = process.env.ERNE_PROJECT_DIR || process.cwd();
+    const agentsDir = path.join(projectDir, '.claude', 'agents');
+    try {
+      if (fs.existsSync(agentsDir)) {
+        const knownNames = new Set(merged.map((a) => a.name));
+        const files = fs.readdirSync(agentsDir).filter((f) => f.endsWith('.md'));
+        for (const file of files) {
+          const name = path.basename(file, '.md');
+          if (!knownNames.has(name)) {
+            merged.push({
+              name,
+              room: 'development',
+              displayName: config.agents[name]?.displayName || null,
+              enabled: config.agents[name]?.enabled !== false,
+              custom: false,
+            });
+          }
+        }
+      }
+    } catch {
+      // Silent — discovery is best-effort
+    }
+
     res.writeHead(200, { 'Content-Type': 'application/json' });
     res.end(JSON.stringify({ agents: merged }));
     return true;

package/dashboard/server.js

@@ -148,6 +148,29 @@ const initAgentState = () => {
       lastEvent: null,
     };
   }
+
+  // Discover agents from .claude/agents/ so init-generated agents appear on dashboard
+  const projectDir = process.env.ERNE_PROJECT_DIR || process.cwd();
+  const agentsDir = path.join(projectDir, '.claude', 'agents');
+  try {
+    if (fs.existsSync(agentsDir)) {
+      const files = fs.readdirSync(agentsDir).filter((f) => f.endsWith('.md'));
+      for (const file of files) {
+        const name = path.basename(file, '.md');
+        if (!agentState[name]) {
+          agentState[name] = {
+            status: 'idle',
+            task: null,
+            room: 'development',
+            startedAt: null,
+            lastEvent: null,
+          };
+        }
+      }
+    }
+  } catch {
+    // Silent — agent discovery is best-effort
+  }
 };
 
 initAgentState();
@@ -366,8 +389,22 @@ const handleEvent = (event) => {
     return { ok: true };
   }
 
-  if (!agent || !agentState[agent]) {
-    return { error: `Unknown agent: ${agent}` };
+  if (!agent) {
+    return { error: 'Missing agent name' };
+  }
+
+  // Auto-register unknown agents so dynamically generated agents show up
+  if (!agentState[agent]) {
+    agentState[agent] = {
+      status: 'idle',
+      task: null,
+      room: 'development',
+      startedAt: null,
+      lastEvent: null,
+    };
+    if (!activityHistory[agent]) {
+      activityHistory[agent] = [];
+    }
   }
 
   const now = new Date().toISOString();

package/lib/generate.js

@@ -209,7 +209,7 @@ function convertToClaudeCodeHooks(erneHooks, profileName, targetDir) {
       if (pattern) entry.matcher = pattern;
       entry.hooks = patternHooks.map((h) => ({
         type: 'command',
-        command: `node "${path.join(targetDir, '.claude/hooks/scripts/run-with-flags.js')}" ${h.script}`,
+        command: `node "${path.join(targetDir, 'hooks/scripts/run-with-flags.js')}" ${h.script}`,
         timeout: HOOK_TIMEOUTS[h.script] || DEFAULT_HOOK_TIMEOUT,
       }));
       result[event].push(entry);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "erne-universal",
-  "version": "0.12.0",
+  "version": "0.12.2",
   "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/skills/hig/SKILL.md

@@ -0,0 +1,93 @@
+---
+name: hig
+description: Apple HIG design intelligence — build, review, animate, and analyze with Apple Human Interface Guidelines for React Native/Expo
+---
+
+# Apple HIG Design Intelligence
+
+## When to Use
+
+- Building UI components with Apple-quality design (spring physics, semantic colors, 8pt grid)
+- Reviewing existing code for HIG compliance
+- Implementing animations with proper physics (not linear/ease-in-out)
+- Analyzing reference videos to extract motion specs
+- Generating design tokens for a project
+
+## Intent Router
+
+Detect intent from the user's message and route to the appropriate mode:
+
+| Intent Keywords | Mode | What Happens |
+|---|---|---|
+| `build`, `create`, `make`, `design`, `component` | **Build** | Apply HIG rules while creating UI |
+| `review`, `check`, `scan`, `audit`, `compliance` | **Review** | Run HIG scanner on source files |
+| `animate`, `motion`, `spring`, `gesture`, `transition` | **Animate** | Implement animations with HIG physics |
+| `video` + file path | **Analyze** | Extract motion spec from reference video |
+| `tokens`, `theme`, `design system` | **Tokens** | Generate HIG design tokens |
+| No clear intent | **Interactive** | Ask what the user wants |
+
+## Build Mode
+
+When building UI, load and apply these rules from `design/hig/rules/`:
+
+1. **Always**: `design-system.md` (typography, colors, spacing, corners)
+2. **If animation involved**: `animation.md` + `craft.md` (spring physics)
+3. **If navigation/modals**: `patterns.md` (sheets, tabs, transitions)
+
+**Non-negotiable requirements:**
+- `borderCurve: 'continuous'` on all rounded elements
+- Semantic color tokens, never hardcoded hex
+- 4pt grid spacing, prefer 8pt
+- 44pt minimum touch targets
+- `useReducedMotion` with any animation
+- `expo-haptics` on key interactions
+- Dark mode support via `useColorScheme`
+- Spring physics via `withSpring`, never `withTiming` with linear easing
+
+**Spring presets** (use from `design/hig/index.ts`):
+- `smooth`: default for most transitions
+- `snappy`: button presses, toggles
+- `bouncy`: playful elements, celebrations
+- `gentle`: background, ambient motion
+
+## Review Mode
+
+Run the HIG scanner from `design/scanner/`:
+
+```
+/erne-hig review ./src/screens/
+/erne-hig review ./src/components/Button.tsx
+```
+
+Output: violations grouped by severity (critical → low), HIG score (0-100), grade (A-F), and fix suggestions.
+
+Integrate with `/erne-quality-gate` — scanner runs automatically alongside code-reviewer and performance-profiler.
+
+## Animate Mode
+
+Load `craft.md` + `animation.md` rules. Key patterns:
+
+- **Enter/Exit**: `FadeIn.duration(300).springify()` — never abrupt appear/disappear
+- **Gesture-driven**: Pan + `withDecay` for momentum, snap points with `withSpring`
+- **Scroll-linked**: `useAnimatedScrollHandler` + `interpolate` with `Extrapolation.CLAMP`
+- **Choreography**: parent first, children staggered 50ms, simultaneous for related
+
+## Analyze Mode
+
+Process reference video through `design/video/`:
+
+```
+/erne-hig video ./reference.mp4
+```
+
+Auto-detects project stack, generates Reanimated/Gesture Handler code matching the video's motion patterns.
+
+## Tokens Mode
+
+Generate typed design tokens from `design/tokens/`:
+
+```
+/erne-hig tokens
+```
+
+Creates `theme/hig-tokens.ts` with colors, typography, spacing, shadows — ready for `useColorScheme` and `StyleSheet.create`.