erne-universal 0.12.1 → 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/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.1",
+  "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`.