erne-universal 0.12.2 → 0.12.4

package/CLAUDE.md

@@ -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`, `/erne-hig` 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-debug-video`, `/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)
 
@@ -224,7 +224,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-plan, /erne-code-review, /erne-tdd, /erne-build-fix, /erne-perf, /erne-upgrade, /erne-native-module, /erne-debug, /erne-debug-visual, /erne-debug-video, /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-hig
 
 ## Dashboard

package/commands/erne-debug-video.md

@@ -0,0 +1,79 @@
+---
+name: erne-debug-video
+description: ERNE — Video-based visual debugging using frame extraction and temporal analysis
+---
+
+# /erne-debug-video — Video Debugging
+
+You are executing the `/erne-debug-video` command. Analyze screen recordings to detect animation glitches, race conditions, gesture issues, scroll jank, keyboard overlap, and navigation transitions that screenshots cannot capture.
+
+## Arguments
+
+```
+/debug-video <file>                    — analyze a screen recording (.mp4, .mov, .webm)
+/debug-video <file> --focus <area>     — focus analysis on a specific UI area or interaction
+/debug-video <file> --fps              — include frame rate analysis for animation smoothness
+```
+
+## Process
+
+### Step 1: Extract Key Frames
+1. Use the `extract-video-frames.js` script to extract frames at key moments
+2. Focus on: transition starts/ends, gesture interactions, state changes, animation keyframes
+3. Extract at higher density during rapid visual changes
+
+### Step 2: Temporal Analysis
+1. Apply multimodal vision to extracted frames in sequence
+2. Identify temporal issues across the recording timeline:
+
+| Category | Examples |
+|----------|---------|
+| **Animation** | jank, stutter, dropped frames, wrong easing |
+| **Gesture** | unresponsive touch, wrong drag behavior, gesture conflict |
+| **Transition** | flash of wrong content, layout shift, z-order issues |
+| **Race Condition** | loading state flicker, stale data flash, double render |
+| **Keyboard** | content overlap, scroll jump, input hidden behind keyboard |
+| **Scroll** | jank, blank areas, recycling artifacts, momentum issues |
+
+Severity: `critical` · `major` · `minor`
+
+### Step 3: Root Cause Analysis
+1. Read the relevant component and animation source files
+2. Correlate visual issues with code patterns
+3. Present findings with frame-by-frame evidence
+
+### Step 4: Interactive Fix
+1. User picks issue numbers to fix
+2. Apply the fix (minimal change, match project style)
+3. If possible, re-record and compare before/after
+4. Ask: "Does this look correct? Any remaining issues?"
+
+### Step 5: Summary
+- Issues detected (count by severity and category)
+- Frame evidence for each issue (timestamps + descriptions)
+- Fixes applied with code diffs
+- Remaining issues (if any deferred by user)
+- Save findings to memory for future reference
+
+## Output
+```
+## Video Debug Report
+
+### Recording
+[File path, duration, resolution]
+
+### Issues Found
+1. [Category · Severity] Description
+   Frame evidence: [timestamp] → [timestamp]
+2. [Category · Severity] Description
+   Frame evidence: [timestamp] → [timestamp]
+...
+
+### Fixes Applied
+**Issue 1** — [ComponentName.tsx]
+Root cause: [brief description]
+Fix: [brief description]
+
+### Remaining Issues
+[None | list of deferred items]
+```

package/docs/commands.md

@@ -7,39 +7,42 @@ Commands are slash-prefixed actions that orchestrate agents for specific tasks.
 ### Core Workflow
 | Command | Purpose | Agents |
 |---------|---------|--------|
-| `/plan` | Design feature architecture | architect |
-| `/code` | Implement features | senior-developer |
-| `/feature` | Build focused feature unit | feature-builder |
-| `/code-review` | Full code review | code-reviewer + performance-profiler |
-| `/tdd` | Test-first development | tdd-guide |
-| `/build-fix` | Fix build failures | expo-config-resolver |
-| `/perf` | Performance profiling | performance-profiler |
-| `/upgrade` | Version migration | upgrade-assistant |
-| `/native-module` | Create native modules | native-bridge-builder → code-reviewer |
-| `/navigate` | Navigation design | architect |
+| `/erne-plan` | Design feature architecture | architect |
+| `/erne-code` | Implement features | senior-developer |
+| `/erne-feature` | Build focused feature unit | feature-builder |
+| `/erne-code-review` | Full code review | code-reviewer + performance-profiler |
+| `/erne-tdd` | Test-first development | tdd-guide |
+| `/erne-build-fix` | Fix build failures | expo-config-resolver |
+| `/erne-perf` | Performance profiling | performance-profiler |
+| `/erne-upgrade` | Version migration | upgrade-assistant |
+| `/erne-native-module` | Create native modules | native-bridge-builder → code-reviewer |
+| `/erne-navigate` | Navigation design | architect |
 
 ### Extended
 | Command | Purpose | Agents |
 |---------|---------|--------|
-| `/animate` | Implement animations | ui-designer |
-| `/deploy` | Validate and submit | expo-config-resolver + code-reviewer |
-| `/component` | Design + test component | ui-designer + tdd-guide |
-| `/debug` | Systematic diagnosis | performance-profiler |
-| `/quality-gate` | Pre-merge checks | code-reviewer + performance-profiler |
-| `/orchestrate` | Run multi-agent pipeline | pipeline-orchestrator |
+| `/erne-animate` | Implement animations | ui-designer |
+| `/erne-deploy` | Validate and submit | expo-config-resolver + code-reviewer |
+| `/erne-component` | Design + test component | ui-designer + tdd-guide |
+| `/erne-debug` | Systematic diagnosis | performance-profiler |
+| `/erne-debug-visual` | Screenshot-based visual debugging | visual-debugger |
+| `/erne-debug-video` | Video-based temporal analysis | visual-debugger (frame extraction) |
+| `/erne-quality-gate` | Pre-merge checks | code-reviewer + performance-profiler |
+| `/erne-orchestrate` | Run multi-agent pipeline | pipeline-orchestrator |
+| `/erne-hig` | Apple HIG design intelligence | ui-designer (HIG rules) |
 
 ### Script-Driven
 | Command | Purpose | What It Runs |
 |---------|---------|-------------|
-| `/learn` | Generate skills from patterns | continuous-learning-v2 scripts |
-| `/retrospective` | Session analysis | evaluate-session.js |
-| `/setup-device` | Install agent-device MCP | Setup script |
+| `/erne-learn` | Generate skills from patterns | continuous-learning-v2 scripts |
+| `/erne-retrospective` | Session analysis | evaluate-session.js |
+| `/erne-setup-device` | Install agent-device MCP | Setup script |
 
 ## Using Commands
 
 Type any command in Claude Code:
 ```
-/plan Add user authentication with biometric login
+/erne-plan Add user authentication with biometric login
 ```
 
 Commands that use multiple agents show combined output. Parallel agents run simultaneously for speed.
@@ -50,7 +53,7 @@ When agent-device MCP is installed, several commands gain visual capabilities:
 
 | Command | Without | With agent-device |
 |---------|---------|------------------|
-| `/debug` | Log analysis | + Screenshots, tap through steps |
-| `/perf` | Code analysis | + Actual FPS measurement |
-| `/component` | Generate code | + Render and screenshot |
-| `/deploy` | Config validation | + Preview build verification |
+| `/erne-debug` | Log analysis | + Screenshots, tap through steps |
+| `/erne-perf` | Code analysis | + Actual FPS measurement |
+| `/erne-component` | Generate code | + Render and screenshot |
+| `/erne-deploy` | Config validation | + Preview build verification |

package/lib/detect.js

@@ -44,15 +44,19 @@ function detectProject(cwd) {
     return result;
   }
 
-  const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+  let deps = { ...pkg.dependencies, ...pkg.devDependencies };
 
   // --- Framework detection ---
-  const hasExpo = !!deps['expo'];
-  const hasRN = !!deps['react-native'];
+  let hasExpo = !!deps['expo'];
+  let hasRN = !!deps['react-native'];
+
+  // Track the effective project directory for stack detection.
+  // In a monorepo, this may point to a workspace package instead of the root.
+  let projectDir = cwd;
+  let projectPkg = pkg;
 
   if (hasExpo) {
     result.isRNProject = true;
-    // Check for native code to distinguish bare vs managed
     if (hasNativeCode(cwd)) {
       result.framework = 'expo-bare';
     } else {
@@ -61,11 +65,39 @@ function detectProject(cwd) {
   } else if (hasRN) {
     result.isRNProject = true;
     result.framework = 'bare-rn';
-  } else {
+  }
+
+  // --- Monorepo detection (runs regardless of root RN presence) ---
+  const monorepoInfo = detectMonorepo(cwd, pkg);
+  result.hasMonorepo = monorepoInfo !== null;
+  result.monorepo = monorepoInfo;
+
+  // If root has no RN/Expo but a workspace package does, use that package for detection
+  if (!result.isRNProject && monorepoInfo) {
+    const rnPkg = monorepoInfo.packages.find(p => p.hasExpo || p.hasReactNative);
+    if (rnPkg) {
+      projectDir = path.join(cwd, rnPkg.path);
+      try {
+        projectPkg = JSON.parse(fs.readFileSync(path.join(projectDir, 'package.json'), 'utf8'));
+        deps = { ...projectPkg.dependencies, ...projectPkg.devDependencies };
+        hasExpo = !!deps['expo'];
+        hasRN = !!deps['react-native'];
+
+        result.isRNProject = true;
+        if (hasExpo) {
+          result.framework = hasNativeCode(projectDir) ? 'expo-bare' : 'expo-managed';
+        } else {
+          result.framework = 'bare-rn';
+        }
+      } catch { /* workspace package.json unreadable, remain non-RN */ }
+    }
+  }
+
+  if (!result.isRNProject) {
     return result;
   }
 
-  // --- Stack detection ---
+  // --- Stack detection (uses deps from the effective project) ---
   // State
   if (deps['zustand']) result.stack.state = 'zustand';
   else if (deps['@reduxjs/toolkit']) result.stack.state = 'redux-toolkit';
@@ -105,27 +137,22 @@ function detectProject(cwd) {
   if (deps['@testing-library/react-native']) result.stack.testing = 'jest-rntl';
   else if (deps['detox']) result.stack.testing = 'jest-detox';
 
-  // Build
-  if (fs.existsSync(path.join(cwd, 'eas.json'))) result.stack.build = 'eas';
-  else if (fs.existsSync(path.join(cwd, 'fastlane'))) result.stack.build = 'fastlane';
+  // Build — check both root and project dir for build configs
+  if (fs.existsSync(path.join(cwd, 'eas.json')) || fs.existsSync(path.join(projectDir, 'eas.json'))) result.stack.build = 'eas';
+  else if (fs.existsSync(path.join(cwd, 'fastlane')) || fs.existsSync(path.join(projectDir, 'fastlane'))) result.stack.build = 'fastlane';
 
   // --- Metadata ---
-  // Monorepo
-  const monorepoInfo = detectMonorepo(cwd, pkg);
-  result.hasMonorepo = monorepoInfo !== null;
-  result.monorepo = monorepoInfo;
-
-  // TypeScript
-  result.hasTypescript = fs.existsSync(path.join(cwd, 'tsconfig.json'));
+  // TypeScript — check both root and project dir
+  result.hasTypescript = fs.existsSync(path.join(cwd, 'tsconfig.json')) || fs.existsSync(path.join(projectDir, 'tsconfig.json'));
 
   // Existing CLAUDE.md
   result.existingClaudeMd = fs.existsSync(path.join(cwd, 'CLAUDE.md'));
 
-  // New Architecture
-  result.hasNewArch = detectNewArch(cwd, pkg);
+  // New Architecture — check against the effective project
+  result.hasNewArch = detectNewArch(projectDir, projectPkg);
 
-  // Component style
-  result.componentStyle = detectComponentStyle(cwd);
+  // Component style — scan the effective project dir
+  result.componentStyle = detectComponentStyle(projectDir);
 
   return result;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "erne-universal",
-  "version": "0.12.2",
+  "version": "0.12.4",
   "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', 22, 'commands/'); // 22 command files
+validateCount('commands', '.md', 23, 'commands/'); // 23 command files
 const cmdFiles = fs.readdirSync('commands').filter((f) => f.endsWith('.md'));
 for (const f of cmdFiles) {
   validateFrontmatter(path.join('commands', f), ['name', 'description']);