erne-universal 0.10.17 → 0.10.19

package/commands/erne-init.md

@@ -1,54 +1,58 @@
 ---
 name: erne-init
-description: ERNE — Initialize the AI agent harness in this project. Sets up 13 agents, hooks, rules, MCP servers, and dashboard. Use when user says "set up erne", "initialize erne", "install erne", or first time setup.
+description: Initialize ERNE — the AI agent harness for React Native & Expo projects. Sets up 13 specialized agents, hook-based code quality enforcement, MCP server integrations, and a visual dashboard. Triggers on "set up erne", "initialize erne", "install erne", "configure agents", "add erne to project", or any first-time ERNE setup request. Always use this skill when the user wants to set up ERNE, even if they don't say "init" explicitly.
 ---
 
-# /erne-init — Initialize ERNE
+# Initialize ERNE
 
-You are executing the `/erne-init` command. This sets up ERNE in the current project.
+ERNE is an AI agent harness for React Native and Expo. Setting it up involves choosing a few preferences and then running a single CLI command. The reason you need to ask the user before running is that the CLI's interactive prompts don't work reliably in Claude Code — so you handle the interaction here in conversation instead.
 
-## Before Running
+## Step 1: Ask preferences
 
-You MUST ask the user these questions before proceeding. Do NOT skip this step. Do NOT default silently.
+Before running anything, ask the user two things in a single message:
 
-### Question 1: Hook Profile
+**Profile:** ERNE uses hook profiles to control how much code quality checking happens automatically. Ask which one they'd like:
+- **minimal** — Almost no automated checks. Good for quick prototyping or when you just want the agents without guardrails.
+- **standard** — Catches common issues (formatting, console.logs, platform-specific bugs) without slowing things down. This is what most people pick.
+- **strict** — Adds security scanning, accessibility checks, and test gates. Good for production apps or teams.
 
-Ask the user:
+**MCP servers:** ERNE can configure agent-device (controls iOS Simulator and Android Emulator for screenshots, taps, navigation) and GitHub integration. Ask if they want these set up now or later.
 
-> Which hook profile would you like?
->
-> **a) minimal** — Fast iteration, minimal checks. For rapid prototyping.
-> **b) standard** (recommended) — Balanced quality and speed. For most projects.
-> **c) strict** — Production-grade enforcement. For teams requiring CI-level quality.
+Wait for the user to respond before continuing.
 
-Wait for their response.
+## Step 2: Run the init command
 
-### Question 2: MCP Servers
+Once you have their preferences, run this in Bash:
 
-Ask the user:
+```bash
+npx erne-universal@latest init --yes --profile <profile> [--no-mcp]
+```
 
-> ERNE can configure MCP servers for device control and GitHub integration. Configure now?
->
-> **a) Yes** — Set up agent-device (simulator/emulator control) + GitHub
-> **b) No** — Skip MCP setup, configure later
+Replace `<profile>` with their choice (minimal, standard, or strict). Add `--no-mcp` only if they said no to MCP servers.
 
-Wait for their response.
+The `--yes` flag is important — it tells the CLI to skip its own interactive prompts since you already gathered the preferences.
 
-## Run Init
+## Step 3: Launch the dashboard
 
-Based on their answers, construct and run the command:
+After init completes, start the dashboard:
 
 ```bash
-npx erne-universal init --yes --profile <chosen-profile> [--no-mcp if they chose no]
+npx erne-universal dashboard &
 ```
 
-Examples:
-- User chose standard + yes to MCP: `npx erne-universal init --yes --profile standard`
-- User chose strict + no to MCP: `npx erne-universal init --yes --profile strict --no-mcp`
-- User chose minimal + yes to MCP: `npx erne-universal init --yes --profile minimal`
+The dashboard runs in the background. Read the output to find which port it started on (usually 3333, but it auto-selects a free port if 3333 is taken).
+
+If the dashboard needs to install dependencies on first run (takes about 2 minutes), tell the user it's installing and will open in the browser when ready.
 
-## After Init
+## Step 4: Tell the user what happened
 
-1. Tell the user to **restart the Claude Code session** to activate MCP servers and hooks
-2. Mention they can run `npx erne-universal dashboard` to launch the visual dashboard
-3. List available commands: `/erne-plan`, `/erne-perf`, `/erne-doctor`, etc.
+Summarize in a clear message:
+- What was set up (agents, hooks, rules, skills, MCP servers)
+- The dashboard URL (e.g., http://localhost:3333)
+- That they need to **restart this Claude Code session** for MCP servers and hooks to activate
+- A few commands they can try after restart:
+  - `/erne-plan` — plan a new feature
+  - `/erne-perf` — profile performance issues
+  - `/erne-doctor` — check project health
+  - `/erne-code-review` — review code quality
+  - Type `/erne-` and press Tab to see all commands

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "erne-universal",
-  "version": "0.10.17",
+  "version": "0.10.19",
   "description": "Complete AI coding agent harness for React Native and Expo development",
   "keywords": [
     "react-native",

package/scripts/hooks/session-start.js

@@ -68,7 +68,41 @@ if (hasAndroidDir && findFilesWithExt('android', '.kt')) {
 
 const hasSignals = layers.length > 1;
 
-console.log(`ERNE: Project layers: ${layers.join(', ')}`);
+// Read ERNE settings for richer session info
+let profile = 'unknown';
+let agentCount = 0;
+let version = '';
+try {
+  const settings = JSON.parse(fs.readFileSync(path.join(projectDir, '.claude', 'settings.json'), 'utf8'));
+  profile = settings.profile || 'standard';
+  version = settings.erneVersion || '';
+} catch { /* no settings */ }
+
+// Count agents
+try {
+  const agentDir = path.join(projectDir, '.claude', 'agents');
+  if (fs.existsSync(agentDir)) {
+    agentCount = fs.readdirSync(agentDir).filter(f => f.endsWith('.md')).length;
+  }
+} catch { /* skip */ }
+
+// Find dashboard port
+let dashboardInfo = '';
+try {
+  const { resolveDashboardPort } = require('./lib/port-registry');
+  const port = resolveDashboardPort(projectDir);
+  if (port) dashboardInfo = ` | Dashboard: http://localhost:${port}`;
+} catch { /* no registry */ }
+
+// Build status line
+const parts = [];
+if (version) parts.push(`v${version}`);
+parts.push(`${profile} profile`);
+if (agentCount > 0) parts.push(`${agentCount} agents`);
+parts.push(`layers: ${layers.join(', ')}`);
+
+console.log(`ERNE ${parts.join(' | ')}${dashboardInfo}`);
+console.log(`Use /erne- commands (e.g. /erne-plan, /erne-perf, /erne-doctor)`);
 
 if (!hasSignals) {
   process.exit(2); // warn