agent-nuvira 1.18.0 → 1.19.0

package/README.md

@@ -1339,7 +1339,7 @@ npx tsc --noEmit
 
 **Phases 1–3 (25 phases) are complete.** Phase 4 (Industry Standards & Autonomous Polish) is in progress. See [UPGRADE_ROADMAP.md](./UPGRADE_ROADMAP.md) for the full implementation journey.
 
-> 📊 **Product strategy and pitch materials:** [PRODUCT_STRATEGY.md](./PRODUCT_STRATEGY.md) — Competitive landscape, positioning map, OKR framework, and risk register. [PITCH_DECK.md](./PITCH_DECK.md) — 10-slide investor presentation outline with talking points and data.
+> 📊 **Architecture, strategy & contribution materials:** [ARCHITECTURE.md](./ARCHITECTURE.md) — Modular execution engine design with 7 module specifications, extensibility/observability systems, and phased migration plan. [ARCHITECTURE_DIAGRAMS.md](./ARCHITECTURE_DIAGRAMS.md) — Mermaid-rendered versions of all architecture diagrams (Module Architecture, Extensibility, Safe Execution, Data Flow, Observability Bus). [PRODUCT_STRATEGY.md](./PRODUCT_STRATEGY.md) — Competitive landscape, positioning map, OKR framework, and risk register. [PITCH_DECK.md](./PITCH_DECK.md) — 10-slide investor presentation outline with talking points and data. [CONTRIBUTING.md](./CONTRIBUTING.md) — Quick-reference contributor guide with docs map, dev setup, and contribution workflow.
 
 | Phase | Feature | Status |
 |---|---|---|

package/dist/agents/module-registry.d.ts

@@ -0,0 +1,128 @@
+/**
+ * ModuleRegistry — Plugin-based module loading system for the agent execution engine.
+ *
+ * Replaces the hardcoded `createAgent()` switch statement with a registry that
+ * allows modules (agents) to be registered, discovered, and loaded at runtime.
+ * Built-in agents are pre-registered; custom agents can be added by plugins
+ * or via the SDK's `registerAgent()` function.
+ *
+ * @see ARCHITECTURE.md §4.1 — Extensibility System
+ */
+import { Agent } from './agent.js';
+import type { EventBus } from '../observability/event-bus.js';
+/** Factory function that creates a new Agent instance */
+export type AgentFactory = () => Agent;
+/** Metadata about a registered module */
+export interface ModuleMetadata {
+    /** The agent type string used in task plans (e.g. 'planner', 'writer') */
+    agentType: string;
+    /** Human-readable name of the agent (e.g. 'Planner', 'Writer') */
+    name: string;
+    /** Short description of what this agent does */
+    description: string;
+    /** Emoji icon for the spinner / UI display */
+    icon: string;
+    /** Whether this module is built-in (true) or added by a plugin (false) */
+    isBuiltin: boolean;
+}
+/** Error thrown when a module lookup fails */
+export declare class ModuleNotFoundError extends Error {
+    constructor(agentType: string);
+}
+/**
+ * ModuleRegistry — Central registry for agent modules.
+ *
+ * Manages a collection of agent factories with metadata. Supports lookup,
+ * listing, and dynamic registration at runtime.
+ *
+ * @example
+ * ```typescript
+ * const registry = ModuleRegistry.createWithBuiltins();
+ * const planner = registry.getModule('planner'); // → PlannerAgent instance
+ * ```
+ */
+export declare class ModuleRegistry {
+    /** Agent factory functions, keyed by agentType */
+    private factories;
+    /** Module metadata, keyed by agentType */
+    private metadata;
+    /** The event bus for emitting observability events */
+    private eventBus;
+    constructor(eventBus?: EventBus);
+    /**
+     * Register an agent module with the registry.
+     *
+     * @param agentType - The agent type string used in task plans
+     * @param factory   - Factory function that returns a new Agent instance
+     * @param meta      - Metadata describing the module
+     *
+     * @throws {Error} If `agentType` is already registered (use `override` to replace)
+     */
+    register(agentType: string, factory: AgentFactory, meta: Omit<ModuleMetadata, 'agentType' | 'isBuiltin'> & {
+        isBuiltin?: boolean;
+    }): void;
+    /**
+     * Register an agent module, silently replacing any existing registration.
+     * Useful for plugin overrides and hot-reload scenarios.
+     */
+    registerOrOverride(agentType: string, factory: AgentFactory, meta: Omit<ModuleMetadata, 'agentType' | 'isBuiltin'> & {
+        isBuiltin?: boolean;
+    }): void;
+    /**
+     * Unregister an agent module.
+     * Safe to call for non-existent agent types (no-op).
+     */
+    unregister(agentType: string): boolean;
+    /**
+     * Get an Agent instance for the given agent type.
+     *
+     * @param agentType - The agent type string (e.g. 'planner', 'writer')
+     * @returns A new Agent instance
+     * @throws {ModuleNotFoundError} If no module is registered for `agentType`
+     */
+    getModule(agentType: string): Agent;
+    /**
+     * Check if an agent type is registered.
+     */
+    hasModule(agentType: string): boolean;
+    /**
+     * Get metadata for a registered agent type.
+     * Returns undefined if the agent type is not registered.
+     */
+    getMetadata(agentType: string): ModuleMetadata | undefined;
+    /**
+     * List all registered modules, optionally filtered by a predicate.
+     */
+    listModules(filter?: (meta: ModuleMetadata) => boolean): ModuleMetadata[];
+    /**
+     * Get the icon for an agent type, or a default icon if not found.
+     */
+    getIcon(agentType: string): string;
+    /**
+     * Get the number of registered modules.
+     */
+    get size(): number;
+    /**
+     * Create a ModuleRegistry pre-populated with all built-in agents.
+     */
+    static createWithBuiltins(eventBus?: EventBus): ModuleRegistry;
+}
+/**
+ * Get or create the global ModuleRegistry singleton.
+ *
+ * First call creates a registry with all built-in agents pre-registered.
+ * Subsequent calls return the same instance.
+ * Use `resetModuleRegistry()` to clear and re-initialize (useful in tests).
+ */
+export declare function getModuleRegistry(): ModuleRegistry;
+/**
+ * Reset the global module registry.
+ * Primarily useful in tests to get a clean slate.
+ */
+export declare function resetModuleRegistry(): void;
+/**
+ * Set the global module registry (for dependency injection in tests).
+ * Returns the previous registry instance (or null).
+ */
+export declare function setModuleRegistry(registry: ModuleRegistry): ModuleRegistry | null;
+//# sourceMappingURL=module-registry.d.ts.map

package/dist/agents/module-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-registry.d.ts","sourceRoot":"","sources":["../../src/agents/module-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAenC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAI9D,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC;AAEvC,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,8CAA8C;AAC9C,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,SAAS,EAAE,MAAM;CAI9B;AAID;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IACzB,kDAAkD;IAClD,OAAO,CAAC,SAAS,CAAmC;IACpD,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAqC;IACrD,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAW;gBAEf,QAAQ,CAAC,EAAE,QAAQ;IAM/B;;;;;;;;OAQG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,WAAW,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAC9E,IAAI;IAsBP;;;OAGG;IACH,kBAAkB,CAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,WAAW,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAC9E,IAAI;IAiBP;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAetC;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK;IAQnC;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIrC;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI1D;;OAEG;IACH,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,GAAG,cAAc,EAAE;IAKzE;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIlC;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAID;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,cAAc;CAiG/D;AAMD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc,GAAG,IAAI,CAIjF"}

package/dist/agents/module-registry.js

@@ -0,0 +1,282 @@
+/**
+ * ModuleRegistry — Plugin-based module loading system for the agent execution engine.
+ *
+ * Replaces the hardcoded `createAgent()` switch statement with a registry that
+ * allows modules (agents) to be registered, discovered, and loaded at runtime.
+ * Built-in agents are pre-registered; custom agents can be added by plugins
+ * or via the SDK's `registerAgent()` function.
+ *
+ * @see ARCHITECTURE.md §4.1 — Extensibility System
+ */
+import { PlannerAgent } from './agents/planner.js';
+import { ContextGathererAgent } from './agents/context-gatherer.js';
+import { WriterAgent } from './agents/writer.js';
+import { ReviewerAgent } from './agents/reviewer.js';
+import { RunnerAgent } from './agents/runner.js';
+import { TesterAgent } from './agents/tester.js';
+import { DebuggerAgent } from './agents/debugger.js';
+import { GitAgent } from './agents/git-agent.js';
+import { PackageAgent } from './agents/package-agent.js';
+import { GitHubReleaseAgent } from './agents/github-release-agent.js';
+import { SecurityAgent } from './agents/security-agent.js';
+import { SkillRunnerAgent } from './agents/skill-runner.js';
+import { MCPAgent } from './agents/mcp-agent.js';
+import { getEventBus, EventNames } from '../observability/event-bus.js';
+/** Error thrown when a module lookup fails */
+export class ModuleNotFoundError extends Error {
+    constructor(agentType) {
+        super(`No module registered for agent type: '${agentType}'`);
+        this.name = 'ModuleNotFoundError';
+    }
+}
+// ─── Registry Class ─────────────────────────────────────────────────────────
+/**
+ * ModuleRegistry — Central registry for agent modules.
+ *
+ * Manages a collection of agent factories with metadata. Supports lookup,
+ * listing, and dynamic registration at runtime.
+ *
+ * @example
+ * ```typescript
+ * const registry = ModuleRegistry.createWithBuiltins();
+ * const planner = registry.getModule('planner'); // → PlannerAgent instance
+ * ```
+ */
+export class ModuleRegistry {
+    /** Agent factory functions, keyed by agentType */
+    factories = new Map();
+    /** Module metadata, keyed by agentType */
+    metadata = new Map();
+    /** The event bus for emitting observability events */
+    eventBus;
+    constructor(eventBus) {
+        this.eventBus = eventBus ?? getEventBus();
+    }
+    // ── Registration ─────────────────────────────────────────────────────
+    /**
+     * Register an agent module with the registry.
+     *
+     * @param agentType - The agent type string used in task plans
+     * @param factory   - Factory function that returns a new Agent instance
+     * @param meta      - Metadata describing the module
+     *
+     * @throws {Error} If `agentType` is already registered (use `override` to replace)
+     */
+    register(agentType, factory, meta) {
+        if (this.factories.has(agentType)) {
+            throw new Error(`Agent type '${agentType}' is already registered. Use unregister() first to replace.`);
+        }
+        this.factories.set(agentType, factory);
+        this.metadata.set(agentType, {
+            agentType,
+            name: meta.name,
+            description: meta.description,
+            icon: meta.icon,
+            isBuiltin: meta.isBuiltin ?? false,
+        });
+        this.eventBus.emit(EventNames.REGISTRY_MODULE_REGISTERED, {
+            agentType,
+            name: meta.name,
+            isBuiltin: meta.isBuiltin ?? false,
+        }, 'module-registry');
+    }
+    /**
+     * Register an agent module, silently replacing any existing registration.
+     * Useful for plugin overrides and hot-reload scenarios.
+     */
+    registerOrOverride(agentType, factory, meta) {
+        this.factories.set(agentType, factory);
+        this.metadata.set(agentType, {
+            agentType,
+            name: meta.name,
+            description: meta.description,
+            icon: meta.icon,
+            isBuiltin: meta.isBuiltin ?? false,
+        });
+        this.eventBus.emit(EventNames.REGISTRY_MODULE_REGISTERED, {
+            agentType,
+            name: meta.name,
+            isBuiltin: meta.isBuiltin ?? false,
+        }, 'module-registry');
+    }
+    /**
+     * Unregister an agent module.
+     * Safe to call for non-existent agent types (no-op).
+     */
+    unregister(agentType) {
+        const hadFactory = this.factories.delete(agentType);
+        this.metadata.delete(agentType);
+        if (hadFactory) {
+            this.eventBus.emit(EventNames.REGISTRY_MODULE_UNREGISTERED, {
+                agentType,
+            }, 'module-registry');
+        }
+        return hadFactory;
+    }
+    // ── Lookup ───────────────────────────────────────────────────────────
+    /**
+     * Get an Agent instance for the given agent type.
+     *
+     * @param agentType - The agent type string (e.g. 'planner', 'writer')
+     * @returns A new Agent instance
+     * @throws {ModuleNotFoundError} If no module is registered for `agentType`
+     */
+    getModule(agentType) {
+        const factory = this.factories.get(agentType);
+        if (!factory) {
+            throw new ModuleNotFoundError(agentType);
+        }
+        return factory();
+    }
+    /**
+     * Check if an agent type is registered.
+     */
+    hasModule(agentType) {
+        return this.factories.has(agentType);
+    }
+    /**
+     * Get metadata for a registered agent type.
+     * Returns undefined if the agent type is not registered.
+     */
+    getMetadata(agentType) {
+        return this.metadata.get(agentType);
+    }
+    /**
+     * List all registered modules, optionally filtered by a predicate.
+     */
+    listModules(filter) {
+        const all = Array.from(this.metadata.values());
+        return filter ? all.filter(filter) : all;
+    }
+    /**
+     * Get the icon for an agent type, or a default icon if not found.
+     */
+    getIcon(agentType) {
+        return this.metadata.get(agentType)?.icon ?? '⚙️';
+    }
+    /**
+     * Get the number of registered modules.
+     */
+    get size() {
+        return this.factories.size;
+    }
+    // ── Factory methods ──────────────────────────────────────────────────
+    /**
+     * Create a ModuleRegistry pre-populated with all built-in agents.
+     */
+    static createWithBuiltins(eventBus) {
+        const registry = new ModuleRegistry(eventBus);
+        // Each registration includes: agentType, factory, and metadata
+        registry.register('planner', () => new PlannerAgent(), {
+            name: 'Planner',
+            description: 'Analyzes user goals and creates detailed execution plans',
+            icon: '📋',
+            isBuiltin: true,
+        });
+        registry.register('context-gatherer', () => new ContextGathererAgent(), {
+            name: 'Context Gatherer',
+            description: 'Scans the codebase and identifies relevant files',
+            icon: '📂',
+            isBuiltin: true,
+        });
+        registry.register('writer', () => new WriterAgent(), {
+            name: 'Writer',
+            description: 'Generates code changes based on the plan and context',
+            icon: '✏️',
+            isBuiltin: true,
+        });
+        registry.register('reviewer', () => new ReviewerAgent(), {
+            name: 'Reviewer',
+            description: 'Validates code changes for correctness, security, and quality',
+            icon: '👁️',
+            isBuiltin: true,
+        });
+        registry.register('runner', () => new RunnerAgent(), {
+            name: 'Runner',
+            description: 'Executes shell commands and captures output',
+            icon: '▶️',
+            isBuiltin: true,
+        });
+        registry.register('tester', () => new TesterAgent(), {
+            name: 'Tester',
+            description: 'Runs tests in a sandboxed environment',
+            icon: '🧪',
+            isBuiltin: true,
+        });
+        registry.register('debugger', () => new DebuggerAgent(), {
+            name: 'Debugger',
+            description: 'Diagnoses test failures and iteratively applies fixes',
+            icon: '🐛',
+            isBuiltin: true,
+        });
+        registry.register('git', () => new GitAgent(), {
+            name: 'Git',
+            description: 'Manages git operations (branch, commit, PR)',
+            icon: '🔀',
+            isBuiltin: true,
+        });
+        registry.register('package', () => new PackageAgent(), {
+            name: 'Package',
+            description: 'Manages package version, build, and npm publish',
+            icon: '📦',
+            isBuiltin: true,
+        });
+        registry.register('github-release', () => new GitHubReleaseAgent(), {
+            name: 'GitHub Release',
+            description: 'Creates GitHub releases with auto-generated changelogs',
+            icon: '🏷️',
+            isBuiltin: true,
+        });
+        registry.register('security', () => new SecurityAgent(), {
+            name: 'Security',
+            description: 'Scans for PII, prompt injection, and dangerous code patterns',
+            icon: '🔒',
+            isBuiltin: true,
+        });
+        registry.register('skill-runner', () => new SkillRunnerAgent(), {
+            name: 'SkillRunner',
+            description: 'Executes a compiled skill as a pre-filled task plan',
+            icon: '🧠',
+            isBuiltin: true,
+        });
+        registry.register('mcp', () => new MCPAgent(), {
+            name: 'MCP',
+            description: 'Invokes MCP (Model Context Protocol) tools from connected servers',
+            icon: '🔌',
+            isBuiltin: true,
+        });
+        return registry;
+    }
+}
+// ─── Global Singleton ───────────────────────────────────────────────────────
+let _globalRegistry = null;
+/**
+ * Get or create the global ModuleRegistry singleton.
+ *
+ * First call creates a registry with all built-in agents pre-registered.
+ * Subsequent calls return the same instance.
+ * Use `resetModuleRegistry()` to clear and re-initialize (useful in tests).
+ */
+export function getModuleRegistry() {
+    if (!_globalRegistry) {
+        _globalRegistry = ModuleRegistry.createWithBuiltins();
+    }
+    return _globalRegistry;
+}
+/**
+ * Reset the global module registry.
+ * Primarily useful in tests to get a clean slate.
+ */
+export function resetModuleRegistry() {
+    _globalRegistry = null;
+}
+/**
+ * Set the global module registry (for dependency injection in tests).
+ * Returns the previous registry instance (or null).
+ */
+export function setModuleRegistry(registry) {
+    const previous = _globalRegistry;
+    _globalRegistry = registry;
+    return previous;
+}
+//# sourceMappingURL=module-registry.js.map

package/dist/agents/module-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-registry.js","sourceRoot":"","sources":["../../src/agents/module-registry.ts"],"names":[],"mappings":"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"}

package/dist/agents/orchestrator.d.ts

@@ -18,6 +18,8 @@
  */
 import { ConfigManager } from '../config/manager.js';
 import type { TaskStep } from './agent.js';
+import { type ModuleRegistry } from './module-registry.js';
+import type { EventBus } from '../observability/event-bus.js';
 /** Configuration for an orchestration session */
 export interface OrchestratorOptions {
     /** Inference provider type (default: from configManager) */
@@ -124,7 +126,11 @@ export interface OrchestrationResult {
 }
 export declare class Orchestrator {
     private configManager;
-    constructor(configManager?: ConfigManager);
+    /** The module registry used for agent lookups */
+    private moduleRegistry;
+    /** The event bus for emitting observability events */
+    private eventBus;
+    constructor(configManager?: ConfigManager, moduleRegistry?: ModuleRegistry, eventBus?: EventBus);
     /**
      * Execute a multi-agent pipeline for the given goal.
      */

package/dist/agents/orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/agents/orchestrator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/agents/orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/agents/orchestrator.js

@@ -25,21 +25,11 @@ import { showModelPicker } from '../cli/model-picker.js';
 import { logger } from '../utils/logger.js';
 import { ContextVault } from './context-vault.js';
 import { buildProjectFileTree, truncateTree } from './utils/file-tree.js';
-import { PlannerAgent } from './agents/planner.js';
-import { ContextGathererAgent } from './agents/context-gatherer.js';
-import { WriterAgent } from './agents/writer.js';
-import { ReviewerAgent } from './agents/reviewer.js';
-import { RunnerAgent } from './agents/runner.js';
-import { TesterAgent, cleanupSandbox } from './agents/tester.js';
-import { DebuggerAgent } from './agents/debugger.js';
-import { GitAgent } from './agents/git-agent.js';
-import { PackageAgent } from './agents/package-agent.js';
-import { GitHubReleaseAgent } from './agents/github-release-agent.js';
-import { SecurityAgent } from './agents/security-agent.js';
-import { SkillRunnerAgent } from './agents/skill-runner.js';
-import { MCPAgent } from './agents/mcp-agent.js';
+import { cleanupSandbox } from './agents/tester.js';
 import { getMCPManager, resetMCPManager } from '../mcp/manager.js';
 import { formatMcpToolsForPrompt } from './agents/mcp-agent.js';
+import { getModuleRegistry } from './module-registry.js';
+import { getEventBus, EventNames } from '../observability/event-bus.js';
 import { ContextPruner } from '../learning/context-pruner.js';
 import { ErrorRepairEngine } from '../learning/error-repair.js';
 import { scanForInjections, formatScanReport } from '../security/scanner.js';
@@ -77,61 +67,30 @@ async function tryResetDAG() {
     if (dagModule)
         dagModule.resetDAG();
 }
-// ─── Agent Registry ─────────────────────────────────────────────────────────
-// ─── Spinner Icons ─────────────────────────────────────────────────────────
-/** Icons for each agent type, shown in the spinner during execution */
-const AGENT_ICONS = {
-    'context-gatherer': '📂',
-    'planner': '📋',
-    'writer': '✏️',
-    'reviewer': '👁️',
-    'tester': '🧪',
-    'debugger': '🐛',
-    'runner': '▶️',
-    'git': '🔀',
-    'package': '📦',
-    'github-release': '🏷️',
-    'security': '🔒',
-    'skill-runner': '🧠',
-    'mcp': '🔌',
-};
-function createAgent(agentType, _options) {
-    switch (agentType) {
-        case 'context-gatherer':
-            return new ContextGathererAgent();
-        case 'planner':
-            return new PlannerAgent();
-        case 'writer':
-            return new WriterAgent();
-        case 'reviewer':
-            return new ReviewerAgent();
-        case 'runner':
-            return new RunnerAgent();
-        case 'tester':
-            return new TesterAgent();
-        case 'debugger':
-            return new DebuggerAgent();
-        case 'git':
-            return new GitAgent();
-        case 'package':
-            return new PackageAgent();
-        case 'github-release':
-            return new GitHubReleaseAgent();
-        case 'security':
-            return new SecurityAgent();
-        case 'skill-runner':
-            return new SkillRunnerAgent();
-        case 'mcp':
-            return new MCPAgent();
-        default:
-            return null;
+// ─── Agent Registry Bridge ───────────────────────────────────────────────────
+/**
+ * Create an agent instance by looking it up in the ModuleRegistry.
+ * Replaces the old hardcoded switch statement.
+ */
+function createAgent(agentType, registry) {
+    try {
+        return registry.getModule(agentType);
+    }
+    catch {
+        return null;
     }
 }
 // ─── Orchestrator ───────────────────────────────────────────────────────────
 export class Orchestrator {
     configManager;
-    constructor(configManager) {
+    /** The module registry used for agent lookups */
+    moduleRegistry;
+    /** The event bus for emitting observability events */
+    eventBus;
+    constructor(configManager, moduleRegistry, eventBus) {
         this.configManager = configManager ?? new ConfigManager();
+        this.moduleRegistry = moduleRegistry ?? getModuleRegistry();
+        this.eventBus = eventBus ?? getEventBus();
     }
     /**
      * Execute a multi-agent pipeline for the given goal.
@@ -142,6 +101,12 @@ export class Orchestrator {
         const defaultCallLLM = this.createLLMProvider(options);
         const agentResults = [];
         const contextFiles = [];
+        // ── Emit: pipeline started event ───────────────────────────────────
+        this.eventBus.emit(EventNames.ORCHESTRATOR_PIPELINE_STARTED, {
+            goal,
+            provider: options.provider,
+            model: options.model,
+        }, 'orchestrator');
         // ── 2b. Build project file tree and inject for Planner ────────────────
         if (options.verbose)
             logger.highlight('\n📂 Scanning project structure...');
@@ -268,7 +233,7 @@ export class Orchestrator {
         else {
             if (options.verbose)
                 logger.highlight('\n📋 Planning...');
-            const planResult = await this.runAgent(new PlannerAgent(), vault, defaultCallLLM, options);
+            const planResult = await this.runAgent(this.moduleRegistry.getModule('planner'), vault, defaultCallLLM, options);
             agentResults.push({ agent: 'Planner', success: planResult.success, summary: planResult.summary });
             if (!planResult.success) {
                 return this.buildResult(false, goal, agentResults, vault, {
@@ -471,6 +436,14 @@ export class Orchestrator {
         const completed = vault.context.taskPlan.filter((s) => s.status === 'completed').length;
         const total = vault.context.taskPlan.length;
         const hasFailures = vault.hasFailedTasks;
+        // ── Emit: pipeline completed event ────────────────────────────────
+        this.eventBus.emit(EventNames.ORCHESTRATOR_PIPELINE_COMPLETED, {
+            goal,
+            success: !hasFailures,
+            tasksCompleted: completed,
+            tasksTotal: total,
+            durationMs: Date.now() - startTime,
+        }, 'orchestrator');
         const summaryLines = [];
         summaryLines.push(hasFailures
             ? `Completed ${completed}/${total} tasks with some failures in ${elapsed}s`
@@ -616,9 +589,14 @@ export class Orchestrator {
             !['debugger', 'runner', 'tester'].includes(task.agentType);
         vault.updateTaskStatus(task.id, 'running');
         await tryUpdateDAGNode(task.id, { status: 'running' });
+        this.eventBus.emit(EventNames.ORCHESTRATOR_TASK_STARTED, {
+            taskId: task.id,
+            agentType: task.agentType,
+            description: task.description,
+        }, 'orchestrator');
         // Update spinner text to show which task is currently executing
         if (options.spinner) {
-            const agentIcon = AGENT_ICONS[task.agentType] || '⚙️';
+            const agentIcon = this.moduleRegistry.getIcon(task.agentType);
             const shortDesc = task.description.slice(0, 60);
             options.spinner.start(`${agentIcon} ${shortDesc}${task.description.length > 60 ? '...' : ''}`);
         }
@@ -656,7 +634,7 @@ export class Orchestrator {
                 }
                 return;
             }
-            const agent = createAgent(task.agentType, options);
+            const agent = createAgent(task.agentType, this.moduleRegistry);
             if (!agent) {
                 vault.updateTaskStatus(task.id, 'failed', `Unknown agent type: ${task.agentType}`);
                 agentResults.push({
@@ -704,6 +682,12 @@ export class Orchestrator {
                 status: result.success ? 'completed' : 'failed',
                 summary: result.summary,
             });
+            this.eventBus.emit(EventNames.ORCHESTRATOR_TASK_COMPLETED, {
+                taskId: task.id,
+                agentType: task.agentType,
+                success: result.success,
+                summary: result.summary,
+            }, 'orchestrator');
             agentResults.push({ agent: task.agentType, success: result.success, summary: result.summary });
             // Track sandbox path for cleanup
             if (result.success && task.agentType === 'tester') {