erne-universal 0.9.0 → 0.10.0

package/CLAUDE.md

@@ -125,6 +125,54 @@ When a user's message matches these signals, automatically use the corresponding
 
 Use `/plan`, `/code-review`, `/tdd`, `/build-fix`, `/perf`, `/upgrade`, `/native-module`, `/navigate`, `/animate`, `/deploy`, `/component`, `/debug`, `/debug-visual`, `/audit`, `/quality-gate`, `/code`, `/feature`, `/learn`, `/retrospective`, `/setup-device` for guided workflows.
 
+## Worker Mode (Autonomous Ticket Execution)
+
+ERNE can run as an autonomous worker that polls a ticket provider, picks up ready tasks, and executes the full pipeline without human intervention.
+
+### Quick Start
+
+```bash
+erne worker --config worker.json
+```
+
+### How It Works
+
+1. Polls a configured provider (ClickUp, GitHub Issues, Linear, Jira, or local JSON) for tickets marked as ready
+2. Validates each ticket has sufficient detail (title, description, acceptance criteria)
+3. Scores confidence (0-100) — skips tickets below the configured threshold
+4. Generates an implementation plan from ticket context + project audit data
+5. Executes in an isolated git worktree to avoid disrupting the main branch
+6. Runs the test suite and verifies no regressions
+7. Performs automated self-review against ERNE coding standards
+8. Compares audit health score before and after changes
+9. Creates a pull request with summary, test results, and ticket link
+
+### Quality Gates
+
+Each ticket must pass these gates before a PR is created:
+- Confidence score above threshold (default: 70)
+- All existing tests pass
+- No audit score regression
+- Self-review finds no critical issues
+
+### Configuration
+
+See `worker.example.json` for a full template. Key options:
+- `provider.type` — clickup, github, linear, jira, local
+- `provider.poll_interval_seconds` — How often to check for new tickets (default: 60)
+- `erne.min_confidence` — Minimum confidence score to attempt a ticket (default: 70)
+- `erne.hook_profile` — ERNE hook profile to use (minimal, standard, strict)
+- `repo.path` — Absolute path to the local repository
+- `repo.base_branch` — Branch to create worktrees from (default: main)
+
+### CLI Options
+
+| Flag | Description |
+|------|-------------|
+| `--config <path>` | Path to worker config JSON (required) |
+| `--dry-run` | Fetch and display tickets without executing |
+| `--once` | Process one ticket then exit |
+
 ## Available Skills
 
 Skills in `skills/` activate automatically:

package/bin/cli.js

@@ -18,6 +18,7 @@ const COMMANDS = {
   doctor: () => require('../lib/doctor'),
   status: () => require('../lib/status'),
   audit: () => require('../lib/audit-cli'),
+  worker: () => require('../lib/worker'),
   'sync-configs': () => require('../lib/sync-configs'),
   sync: () => require('../lib/sync-configs'),
   version: () => {
@@ -41,10 +42,16 @@ const COMMANDS = {
     start       Init project and start dashboard
     doctor      Check project health and ERNE setup
     status      Show current ERNE configuration
+    worker      Run autonomous ticket execution agent
     sync-configs Sync IDE config files from CLAUDE.md (alias: sync)
     version     Show installed version
     help        Show this help message
 
+  Worker options:
+    --config <path>        Path to worker config JSON (required)
+    --dry-run              Fetch tickets without executing
+    --once                 Process one ticket and exit
+
   Add-agent options:
     --room <name>   Agent room: development, code-review, testing, conference (default: development)
 
@@ -63,6 +70,8 @@ const COMMANDS = {
     npx erne-universal init -p minimal --no-mcp -y
     npx erne-universal add-agent api-specialist
     npx erne-universal add-agent database-expert --room testing
+    npx erne-universal worker --config worker.json
+    npx erne-universal worker --config worker.json --dry-run
 
   Website: https://erne.dev
     `);

package/commands/worker.md

@@ -0,0 +1,63 @@
+---
+name: worker
+description: Autonomous ticket execution — polls a provider, picks up ready tickets, and runs the full ERNE pipeline (validate, plan, code, test, review, PR).
+---
+
+# /worker — Autonomous Ticket Execution
+
+## Usage
+
+```bash
+erne worker --config <path-to-worker.json>
+```
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `--config <path>` | Path to worker configuration JSON (required) |
+| `--dry-run` | Fetch tickets and print them without executing |
+| `--once` | Process one ticket and exit |
+
+## Pipeline Steps
+
+1. **Poll** — Fetch ready tickets from the configured provider
+2. **Validate** — Check ticket has enough detail (title, description, acceptance criteria)
+3. **Confidence Score** — Estimate likelihood of autonomous success (0-100)
+4. **Context Resolve** — Load project stack, audit data, and relevant files
+5. **Plan** — Generate implementation plan from ticket + context
+6. **Execute** — Run Claude Code in an isolated git worktree
+7. **Test** — Run test suite, verify no regressions
+8. **Self-Review** — Automated code review against ERNE standards
+9. **Health Delta** — Compare audit score before/after
+10. **PR** — Create pull request with full summary and link to ticket
+
+## Supported Providers
+
+- **clickup** — ClickUp tasks (API token + list ID)
+- **github** — GitHub Issues (repo + labels)
+- **linear** — Linear issues (API key + team)
+- **jira** — Jira issues (API token + project)
+- **local** — JSON file with ticket definitions (for testing)
+
+## Configuration Reference
+
+See `worker.example.json` at the project root for a full example. Key sections:
+
+- `provider` — Type, credentials, poll interval, filters
+- `repo` — Local path, base branch, remote
+- `erne` — Hook profile, quality gates, confidence threshold
+- `log` — File path and log level
+
+## Examples
+
+```bash
+# Dry run to see available tickets
+erne worker --config worker.json --dry-run
+
+# Process one ticket and stop
+erne worker --config worker.json --once
+
+# Continuous polling mode
+erne worker --config worker.json
+```

package/dashboard/server.js

@@ -176,6 +176,7 @@ const persistHistory = () => {
 
 let lastActiveAgent = null;
 let lastAudit = null;
+let lastWorkerState = null;
 
 const handleEvent = (event) => {
   const { type, agent, agents: agentList, task } = event;
@@ -213,6 +214,35 @@ const handleEvent = (event) => {
     return { ok: true };
   }
 
+  // Worker events — update worker state and broadcast
+  if (type && type.startsWith('worker:')) {
+    const now = new Date().toISOString();
+    if (type === 'worker:start') {
+      lastWorkerState = { status: 'polling', provider: event.provider, repo: event.repo, interval: event.interval, startedAt: now, lastEvent: now, currentTicket: null };
+    } else if (type === 'worker:task-start') {
+      if (lastWorkerState) {
+        lastWorkerState.status = 'working';
+        lastWorkerState.currentTicket = { identifier: event.identifier, title: event.title, startedAt: now };
+        lastWorkerState.lastEvent = now;
+      }
+    } else if (type === 'worker:task-complete') {
+      if (lastWorkerState) {
+        lastWorkerState.status = 'polling';
+        lastWorkerState.currentTicket = null;
+        lastWorkerState.lastEvent = now;
+        lastWorkerState.lastCompleted = { identifier: event.identifier, title: event.title, result: event.result, completedAt: now };
+      }
+    } else if (type === 'worker:idle') {
+      if (lastWorkerState) {
+        lastWorkerState.status = 'polling';
+        lastWorkerState.lastEvent = now;
+      }
+    } else if (lastWorkerState) {
+      lastWorkerState.lastEvent = now;
+    }
+    return { ok: true };
+  }
+
   if (!agent || !agentState[agent]) {
     return { error: `Unknown agent: ${agent}` };
   }
@@ -603,6 +633,12 @@ const server = http.createServer(async (req, res) => {
     return;
   }
 
+  if (req.method === 'GET' && req.url === '/api/worker') {
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify(lastWorkerState || { status: 'offline' }));
+    return;
+  }
+
   if (req.method === 'POST' && req.url === '/api/audit/run') {
     try {
       const projectDir = process.env.ERNE_PROJECT_DIR || process.cwd();
@@ -702,7 +738,8 @@ wss.on('connection', (ws) => {
 
     // Validate event shape before processing
     if (!data || typeof data !== 'object' || typeof data.type !== 'string') return;
-    const VALID_TYPES = ['agent:start', 'agent:complete', 'planning:start', 'planning:end', 'audit:complete'];
+    const VALID_TYPES = ['agent:start', 'agent:complete', 'planning:start', 'planning:end', 'audit:complete',
+      'worker:start', 'worker:poll', 'worker:task-start', 'worker:task-complete', 'worker:idle'];
     if (!VALID_TYPES.includes(data.type)) return;
 
     const result = handleEvent(data);

package/lib/audit-cli.js

@@ -283,7 +283,7 @@ Full data: \`erne-docs/audit-data.json\`
 function postDashboardEvent(data) {
   try {
     const payload = JSON.stringify({
-      type: 'audit-complete',
+      type: 'audit:complete',
       timestamp: new Date().toISOString(),
       summary: {
         totalFiles: data.meta ? data.meta.totalSourceFiles : 0,

package/lib/worker.js

@@ -0,0 +1,122 @@
+'use strict';
+const path = require('path');
+
+module.exports = async function worker() {
+  const args = process.argv.slice(2);
+  const configIdx = args.indexOf('--config');
+  const configPath = configIdx !== -1 ? args[configIdx + 1] : null;
+  const dryRun = args.includes('--dry-run');
+  const once = args.includes('--once');
+
+  if (!configPath) {
+    console.error('  Usage: erne worker --config <path.json>');
+    console.error('  Options: --dry-run, --once');
+    process.exit(1);
+  }
+
+  const { loadConfig, validateConfig } = require('../worker/config');
+  const { createProvider } = require('../worker/providers/factory');
+  const { createPoller } = require('../worker/poller');
+  const { processTicket } = require('../worker/scheduler');
+  const { createLogger } = require('../worker/logger');
+  const { publishDashboardEvent } = require('../worker/dashboard-events');
+
+  // 1. Load config
+  const fullPath = path.resolve(configPath);
+  const config = loadConfig(fullPath);
+  const validation = validateConfig(config);
+  if (!validation.valid) {
+    console.error('  Config errors:');
+    validation.errors.forEach(e => console.error('    \u2717 ' + e));
+    process.exit(1);
+  }
+
+  // 2. Create logger
+  const logger = createLogger({ file: config.log?.file, level: config.log?.level || 'info' });
+
+  // 3. Detect project and scan (if audit-scanner available)
+  let stackInfo = { layers: [] };
+  let auditData = {};
+  try {
+    const { detectProject } = require('./detect');
+    stackInfo = detectProject(config.repo.path);
+  } catch { /* detect not critical */ }
+  try {
+    const { runScan } = require('./audit-scanner');
+    if (config.erne?.audit_refresh !== false) {
+      auditData = runScan(config.repo.path, { skipDepHealth: true, maxFiles: 500 });
+    }
+  } catch { /* scan not critical */ }
+
+  // 4. Create provider
+  const provider = createProvider(config, logger);
+
+  // 5. Print banner
+  const pollSec = config.provider.poll_interval_seconds || 60;
+  console.log(`
+  erne worker — Autonomous Agent
+
+  Provider: ${config.provider.type}
+  Repo: ${config.repo.path}
+  Profile: ${config.erne?.hook_profile || 'standard'}
+  Polling every ${pollSec}s
+  ${dryRun ? '  Mode: DRY RUN (no execution)\n' : ''}
+  Waiting for tickets...
+  `);
+
+  // 6. Dry run mode
+  if (dryRun) {
+    logger.info('Dry run — fetching tickets...');
+    try {
+      const tickets = await provider.fetchReadyTickets();
+      if (tickets.length === 0) {
+        console.log('  No ready tickets found.');
+      } else {
+        console.log(`  ${tickets.length} ticket(s) found:`);
+        tickets.forEach(t => console.log(`    - ${t.identifier}: ${t.title}`));
+      }
+    } catch (err) {
+      console.error('  Error fetching tickets:', err.message);
+    }
+    process.exit(0);
+  }
+
+  // 7. Publish start event
+  publishDashboardEvent('worker:start', { provider: config.provider.type, repo: config.repo.path, interval: pollSec });
+
+  // 8. Create poller
+  const poller = createPoller({
+    provider,
+    intervalMs: pollSec * 1000,
+    logger,
+    onTicket: async (ticket) => {
+      await processTicket({ ticket, provider, config, auditData, stackInfo, logger });
+    },
+  });
+
+  // 9. Handle shutdown
+  const shutdown = () => {
+    logger.info('Shutting down worker...');
+    poller.stop();
+  };
+  process.on('SIGINT', shutdown);
+  process.on('SIGTERM', shutdown);
+
+  // 10. Start (once mode or continuous)
+  if (once) {
+    logger.info('Once mode — processing first available ticket');
+    try {
+      const tickets = await provider.fetchReadyTickets();
+      if (tickets.length > 0) {
+        await processTicket({ ticket: tickets[0], provider, config, auditData, stackInfo, logger });
+      } else {
+        logger.info('No ready tickets found');
+      }
+    } catch (err) {
+      logger.error('Error:', { error: err.message });
+    }
+    process.exit(0);
+  }
+
+  await poller.start();
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "erne-universal",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Complete AI coding agent harness for React Native and Expo development",
   "keywords": [
     "react-native",
@@ -58,7 +58,7 @@
     "node": ">=18"
   },
   "scripts": {
-    "test": "node --test tests/*.test.js tests/hooks/*.test.js tests/context/*.test.js",
+    "test": "node --test tests/*.test.js tests/hooks/*.test.js tests/context/*.test.js tests/worker/*.test.js",
     "lint": "eslint lib/ scripts/ bin/",
     "lint:agents": "node scripts/lint-agents.js",
     "lint:content": "node scripts/lint-content.js",

package/scripts/validate-all.js

@@ -68,7 +68,7 @@ for (const f of agentFiles) {
 
 // Commands
 console.log('  Commands:');
-validateCount('commands', '.md', 20, 'commands/');
+validateCount('commands', '.md', 21, 'commands/');
 const cmdFiles = fs.readdirSync('commands').filter(f => f.endsWith('.md'));
 for (const f of cmdFiles) {
   validateFrontmatter(path.join('commands', f), ['name', 'description']);