@proletariat/cli 0.3.92 → 0.3.93

package/dist/lib/orchestrate/engine.js

@@ -0,0 +1,290 @@
+/**
+ * Orchestrate Engine
+ *
+ * The core daemon loop that:
+ * 1. Loads hook configuration from DB (synced from YAML/presets/CLI)
+ * 2. Subscribes to EventBus events
+ * 3. Executes matching hooks with mode-aware behavior
+ * 4. Optionally polls external sources for events
+ *
+ * The engine extends the existing HookManager with mode support
+ * and built-in action execution.
+ */
+import { execSync } from 'node:child_process';
+import { getEventBus } from '../events/event-bus.js';
+import { WorkHookStorage } from '../work-lifecycle/hooks/storage.js';
+import { executeBuiltinAction, ACTION_HANDLERS } from './actions.js';
+export class OrchestrateEngine {
+    db;
+    hookStorage;
+    unsubscribers = [];
+    log;
+    onConfirm;
+    onNotify;
+    running = false;
+    pendingConfirmations = [];
+    constructor(options) {
+        this.db = options.db;
+        this.hookStorage = new WorkHookStorage(options.db);
+        this.log = options.log ?? (() => { });
+        this.onConfirm = options.onConfirm;
+        this.onNotify = options.onNotify;
+    }
+    /**
+     * Start the orchestrate engine — subscribe to all orchestrate events.
+     */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        const bus = getEventBus();
+        // Subscribe to standard RuntimeEventMap events
+        const standardEvents = [
+            'work:started',
+            'work:status_changed',
+            'work:pr_created',
+            'work:pr_merged',
+            'work:pr_closed',
+            'work:completed',
+            'agent:spawned',
+            'agent:stopped',
+        ];
+        for (const eventName of standardEvents) {
+            this.unsubscribers.push(bus.on(eventName, (payload) => {
+                void this.handleEvent(eventName, payload);
+            }));
+        }
+        this.log('[orchestrate] Engine started, listening for events');
+    }
+    /**
+     * Stop the engine and clean up subscriptions.
+     */
+    stop() {
+        this.running = false;
+        for (const unsub of this.unsubscribers) {
+            unsub();
+        }
+        this.unsubscribers = [];
+        this.pendingConfirmations = [];
+        this.log('[orchestrate] Engine stopped');
+    }
+    /**
+     * Fire an event manually (used by `prlt hook fire`).
+     * This is the entry point for external event sources (GitHub Actions, polling, etc.).
+     */
+    async fireEvent(event, ctx) {
+        return this.handleEvent(event, ctx);
+    }
+    /**
+     * Get pending confirmations for hooks in confirm mode.
+     */
+    getPendingConfirmations() {
+        return [...this.pendingConfirmations];
+    }
+    /**
+     * Approve a pending confirmation and execute it.
+     */
+    async approveConfirmation(index) {
+        if (index < 0 || index >= this.pendingConfirmations.length)
+            return null;
+        const pending = this.pendingConfirmations.splice(index, 1)[0];
+        const result = executeBuiltinAction(pending.action, pending.ctx, pending.config);
+        this.log(`[orchestrate] Approved: ${pending.hookName} → ${pending.action} (${result.success ? 'success' : 'failed'})`);
+        return result;
+    }
+    /**
+     * Deny a pending confirmation.
+     */
+    denyConfirmation(index) {
+        if (index < 0 || index >= this.pendingConfirmations.length)
+            return false;
+        const pending = this.pendingConfirmations.splice(index, 1)[0];
+        this.log(`[orchestrate] Denied: ${pending.hookName} → ${pending.action}`);
+        return true;
+    }
+    // ===========================================================================
+    // Private
+    // ===========================================================================
+    /**
+     * Handle an event by finding and executing matching hooks.
+     */
+    async handleEvent(eventName, eventData) {
+        const results = [];
+        try {
+            // Query hooks matching this event, ordered by priority
+            const hooks = this.getHooksForEvent(eventName);
+            if (hooks.length === 0)
+                return results;
+            // Build event context from the payload
+            const ctx = this.buildContext(eventName, eventData);
+            for (const hook of hooks) {
+                const mode = (hook.mode || 'auto');
+                const config = hook.config ? JSON.parse(hook.config) : undefined;
+                // Determine action — either a built-in action name or the raw action_value
+                const actionName = this.resolveActionName(hook);
+                if (mode === 'off') {
+                    results.push({ action: actionName, success: true, durationMs: 0, skipped: true });
+                    continue;
+                }
+                if (mode === 'confirm') {
+                    // Queue for confirmation
+                    if (this.onConfirm) {
+                        const approved = await this.onConfirm(hook.name, eventName, actionName);
+                        if (!approved) {
+                            this.log(`[orchestrate] Skipped (not confirmed): ${hook.name} → ${actionName}`);
+                            results.push({ action: actionName, success: true, durationMs: 0, skipped: true });
+                            continue;
+                        }
+                    }
+                    else {
+                        // No confirm handler — queue for later approval
+                        this.pendingConfirmations.push({
+                            hookName: hook.name,
+                            event: eventName,
+                            action: actionName,
+                            ctx,
+                            config,
+                        });
+                        this.log(`[orchestrate] Queued for confirmation: ${hook.name} → ${actionName}`);
+                        results.push({ action: actionName, success: true, durationMs: 0, awaitingConfirmation: true });
+                        continue;
+                    }
+                }
+                // Execute the action
+                const result = this.executeAction(actionName, ctx, config);
+                results.push(result);
+                this.log(`[orchestrate] ${hook.name} → ${actionName}: ${result.success ? 'success' : `failed: ${result.error}`} (${result.durationMs}ms)`);
+                // For notify mode, also fire the notification callback
+                if (mode === 'notify' && this.onNotify) {
+                    this.onNotify(hook.name, eventName, actionName, result);
+                }
+            }
+        }
+        catch (err) {
+            this.log(`[orchestrate] Error handling event ${eventName}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        return results;
+    }
+    /**
+     * Get hooks for a given event from the database, ordered by priority.
+     */
+    getHooksForEvent(eventName) {
+        try {
+            return this.db.prepare(`
+        SELECT id, name, event, action_type, action_value, enabled, description, mode, priority, config
+        FROM pmo_work_hooks
+        WHERE event = ? AND enabled = 1
+        ORDER BY priority ASC, created_at ASC
+      `).all(eventName);
+        }
+        catch {
+            // Fallback without mode/priority columns (pre-migration)
+            try {
+                const basic = this.db.prepare(`
+          SELECT id, name, event, action_type, action_value, enabled, description
+          FROM pmo_work_hooks
+          WHERE event = ? AND enabled = 1
+          ORDER BY created_at ASC
+        `).all(eventName);
+                return basic;
+            }
+            catch {
+                return [];
+            }
+        }
+    }
+    /**
+     * Build an OrchestrateEventContext from raw event data.
+     */
+    buildContext(eventName, data) {
+        return {
+            event: eventName,
+            ticket: (data.ticketId ?? data.workItemId ?? data.ticket),
+            pr: (data.prNumber ?? data.pr),
+            branch: data.branch,
+            agent: (data.agentName ?? data.agent ?? data.sessionId),
+            container: data.containerId,
+            executionId: data.executionId,
+            prUrl: data.prUrl,
+            projectId: data.projectId,
+            ...data,
+        };
+    }
+    /**
+     * Resolve the action name from a hook row.
+     * Built-in actions are referenced by name; shell hooks use the raw command.
+     */
+    resolveActionName(hook) {
+        // If the action_value starts with "prlt hook fire", extract the --action value
+        const actionMatch = hook.action_value.match(/--action\s+(\S+)/);
+        if (actionMatch)
+            return actionMatch[1];
+        // If it's a known built-in action name directly
+        if (ACTION_HANDLERS[hook.action_value])
+            return hook.action_value;
+        // Otherwise it's a raw shell command — use the action_value as-is
+        return hook.action_value;
+    }
+    /**
+     * Execute an action — either built-in or shell fallback.
+     */
+    executeAction(actionName, ctx, config) {
+        // Try built-in action first
+        if (ACTION_HANDLERS[actionName]) {
+            return executeBuiltinAction(actionName, ctx, config);
+        }
+        // Fallback to shell execution
+        const start = Date.now();
+        try {
+            const env = {
+                ...process.env,
+                PRLT_HOOK_EVENT: ctx.event,
+                PRLT_HOOK_TICKET: ctx.ticket ?? '',
+                PRLT_HOOK_PR: ctx.pr ? String(ctx.pr) : '',
+                PRLT_HOOK_BRANCH: ctx.branch ?? '',
+                PRLT_HOOK_AGENT: ctx.agent ?? '',
+            };
+            execSync(actionName, { env, timeout: 30_000, stdio: 'pipe' });
+            return { action: actionName, success: true, durationMs: Date.now() - start };
+        }
+        catch (err) {
+            return {
+                action: actionName,
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+                durationMs: Date.now() - start,
+            };
+        }
+    }
+}
+// =============================================================================
+// Singleton
+// =============================================================================
+let _engine;
+/**
+ * Initialize and start the orchestrate engine.
+ * Safe to call multiple times.
+ */
+export function initOrchestrateEngine(options) {
+    if (!_engine) {
+        _engine = new OrchestrateEngine(options);
+        _engine.start();
+    }
+    return _engine;
+}
+/**
+ * Get the running orchestrate engine instance.
+ */
+export function getOrchestrateEngine() {
+    return _engine;
+}
+/**
+ * Stop the orchestrate engine.
+ */
+export function stopOrchestrateEngine() {
+    if (_engine) {
+        _engine.stop();
+        _engine = undefined;
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/lib/orchestrate/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/lib/orchestrate/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AACpE,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAyCpE,MAAM,OAAO,iBAAiB;IACpB,EAAE,CAAmB;IACrB,WAAW,CAAiB;IAC5B,aAAa,GAAsB,EAAE,CAAA;IACrC,GAAG,CAAuB;IAC1B,SAAS,CAAwE;IACjF,QAAQ,CAA6F;IACrG,OAAO,GAAG,KAAK,CAAA;IACf,oBAAoB,GAMvB,EAAE,CAAA;IAEP,YAAY,OAAiC;QAC3C,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAA;QACpB,IAAI,CAAC,WAAW,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAClD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QACpC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;QAClC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;IAClC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,OAAO;YAAE,OAAM;QACxB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QAEnB,MAAM,GAAG,GAAG,WAAW,EAAE,CAAA;QAEzB,+CAA+C;QAC/C,MAAM,cAAc,GAA+D;YACjF,cAAc;YACd,qBAAqB;YACrB,iBAAiB;YACjB,gBAAgB;YAChB,gBAAgB;YAChB,gBAAgB;YAChB,eAAe;YACf,eAAe;SAChB,CAAA;QAED,KAAK,MAAM,SAAS,IAAI,cAAc,EAAE,CAAC;YACvC,IAAI,CAAC,aAAa,CAAC,IAAI,CACrB,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;gBAC5B,KAAK,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,OAA6C,CAAC,CAAA;YACjF,CAAC,CAAC,CACH,CAAA;QACH,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAA;IAChE,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;QACpB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvC,KAAK,EAAE,CAAA;QACT,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,EAAE,CAAA;QACvB,IAAI,CAAC,oBAAoB,GAAG,EAAE,CAAA;QAC9B,IAAI,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAA;IAC1C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,GAA4B;QACzD,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,GAA8B,CAAC,CAAA;IAChE,CAAC;IAED;;OAEG;IACH,uBAAuB;QACrB,OAAO,CAAC,GAAG,IAAI,CAAC,oBAAoB,CAAC,CAAA;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CAAC,KAAa;QACrC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,oBAAoB,CAAC,MAAM;YAAE,OAAO,IAAI,CAAA;QAEvE,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC7D,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;QAEhF,IAAI,CAAC,GAAG,CAAC,2BAA2B,OAAO,CAAC,QAAQ,MAAM,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAA;QACtH,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,KAAa;QAC5B,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,oBAAoB,CAAC,MAAM;YAAE,OAAO,KAAK,CAAA;QAExE,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC7D,IAAI,CAAC,GAAG,CAAC,yBAAyB,OAAO,CAAC,QAAQ,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;QACzE,OAAO,IAAI,CAAA;IACb,CAAC;IAED,8EAA8E;IAC9E,UAAU;IACV,8EAA8E;IAE9E;;OAEG;IACK,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,SAAkC;QAC7E,MAAM,OAAO,GAA8B,EAAE,CAAA;QAE7C,IAAI,CAAC;YACH,uDAAuD;YACvD,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAA;YAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,OAAO,CAAA;YAEtC,uCAAuC;YACvC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;YAEnD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,MAAM,CAAa,CAAA;gBAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAA4B,CAAC,CAAC,CAAC,SAAS,CAAA;gBAE3F,2EAA2E;gBAC3E,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA;gBAE/C,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;oBACnB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;oBACjF,SAAQ;gBACV,CAAC;gBAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACvB,yBAAyB;oBACzB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;wBACnB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;wBACvE,IAAI,CAAC,QAAQ,EAAE,CAAC;4BACd,IAAI,CAAC,GAAG,CAAC,0CAA0C,IAAI,CAAC,IAAI,MAAM,UAAU,EAAE,CAAC,CAAA;4BAC/E,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;4BACjF,SAAQ;wBACV,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,gDAAgD;wBAChD,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC;4BAC7B,QAAQ,EAAE,IAAI,CAAC,IAAI;4BACnB,KAAK,EAAE,SAAS;4BAChB,MAAM,EAAE,UAAU;4BAClB,GAAG;4BACH,MAAM;yBACP,CAAC,CAAA;wBACF,IAAI,CAAC,GAAG,CAAC,0CAA0C,IAAI,CAAC,IAAI,MAAM,UAAU,EAAE,CAAC,CAAA;wBAC/E,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,CAAA;wBAC9F,SAAQ;oBACV,CAAC;gBACH,CAAC;gBAED,qBAAqB;gBACrB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA;gBAC1D,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBAEpB,IAAI,CAAC,GAAG,CACN,iBAAiB,IAAI,CAAC,IAAI,MAAM,UAAU,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,KAAK,EAAE,KAAK,MAAM,CAAC,UAAU,KAAK,CACjI,CAAA;gBAED,uDAAuD;gBACvD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACvC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,CAAA;gBACzD,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,sCAAsC,SAAS,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAClH,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,SAAiB;QACxC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;OAKtB,CAAC,CAAC,GAAG,CAAC,SAAS,CAAsB,CAAA;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;YACzD,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;SAK7B,CAAC,CAAC,GAAG,CAAC,SAAS,CAAsB,CAAA;gBACtC,OAAO,KAAK,CAAA;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAA;YACX,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,SAAiB,EAAE,IAA6B;QACnE,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAuB;YAC/E,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAuB;YACpD,MAAM,EAAE,IAAI,CAAC,MAA4B;YACzC,KAAK,EAAE,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,CAAuB;YAC7E,SAAS,EAAE,IAAI,CAAC,WAAiC;YACjD,WAAW,EAAE,IAAI,CAAC,WAAiC;YACnD,KAAK,EAAE,IAAI,CAAC,KAA2B;YACvC,SAAS,EAAE,IAAI,CAAC,SAA+B;YAC/C,GAAG,IAAI;SACR,CAAA;IACH,CAAC;IAED;;;OAGG;IACK,iBAAiB,CAAC,IAAqB;QAC7C,+EAA+E;QAC/E,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAA;QAC/D,IAAI,WAAW;YAAE,OAAO,WAAW,CAAC,CAAC,CAAC,CAAA;QAEtC,gDAAgD;QAChD,IAAI,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC;YAAE,OAAO,IAAI,CAAC,YAAY,CAAA;QAEhE,kEAAkE;QAClE,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;IAED;;OAEG;IACK,aAAa,CACnB,UAAkB,EAClB,GAA4B,EAC5B,MAAgC;QAEhC,4BAA4B;QAC5B,IAAI,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,OAAO,oBAAoB,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA;QACtD,CAAC;QAED,8BAA8B;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG;gBACV,GAAG,OAAO,CAAC,GAAG;gBACd,eAAe,EAAE,GAAG,CAAC,KAAK;gBAC1B,gBAAgB,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE;gBAClC,YAAY,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;gBAC1C,gBAAgB,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE;gBAClC,eAAe,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;aACjC,CAAA;YACD,QAAQ,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;YAC7D,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAA;QAC9E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,MAAM,EAAE,UAAU;gBAClB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;gBACvD,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAA;QACH,CAAC;IACH,CAAC;CACF;AAED,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,IAAI,OAAsC,CAAA;AAE1C;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAiC;IACrE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAA;QACxC,OAAO,CAAC,KAAK,EAAE,CAAA;IACjB,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,EAAE,CAAA;QACd,OAAO,GAAG,SAAS,CAAA;IACrB,CAAC;AACH,CAAC"}

package/dist/lib/orchestrate/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Orchestrate module — public API.
+ *
+ * Event-driven pipeline automation daemon with HITL controls.
+ * Extends the work-lifecycle hook system with built-in actions,
+ * YAML config loading, presets, and mode-aware execution.
+ */
+export type { OrchestrateEvent, HookMode, BuiltinAction, HooksYaml, HookYamlEntry, WorkflowYaml, PresetName, OrchestrateEventContext, OrchestrateActionResult, } from './types.js';
+export { ORCHESTRATE_EVENTS, HOOK_MODES, BUILTIN_ACTIONS, PRESET_NAMES, } from './types.js';
+export { PRESETS, getPreset, } from './presets.js';
+export { loadHooksYaml, loadWorkflowYaml, syncHooksFromYaml, applyPreset, exportHooksToYaml, } from './config-loader.js';
+export { ACTION_HANDLERS, executeBuiltinAction, } from './actions.js';
+export { OrchestrateEngine, initOrchestrateEngine, getOrchestrateEngine, stopOrchestrateEngine, } from './engine.js';
+export type { OrchestrateEngineOptions } from './engine.js';
+export { OrchestratePoller } from './poller.js';
+export type { PollerOptions } from './poller.js';

package/dist/lib/orchestrate/index.js

@@ -0,0 +1,14 @@
+/**
+ * Orchestrate module — public API.
+ *
+ * Event-driven pipeline automation daemon with HITL controls.
+ * Extends the work-lifecycle hook system with built-in actions,
+ * YAML config loading, presets, and mode-aware execution.
+ */
+export { ORCHESTRATE_EVENTS, HOOK_MODES, BUILTIN_ACTIONS, PRESET_NAMES, } from './types.js';
+export { PRESETS, getPreset, } from './presets.js';
+export { loadHooksYaml, loadWorkflowYaml, syncHooksFromYaml, applyPreset, exportHooksToYaml, } from './config-loader.js';
+export { ACTION_HANDLERS, executeBuiltinAction, } from './actions.js';
+export { OrchestrateEngine, initOrchestrateEngine, getOrchestrateEngine, stopOrchestrateEngine, } from './engine.js';
+export { OrchestratePoller } from './poller.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/orchestrate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/orchestrate/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,OAAO,EACP,SAAS,GACV,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,GAClB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,eAAe,EACf,oBAAoB,GACrB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,aAAa,CAAA;AAIpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA"}

package/dist/lib/orchestrate/poller.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Orchestrate External Event Poller
+ *
+ * Polls external systems (GitHub, database) and fires orchestrate events
+ * when conditions are detected. This bridges external state changes into
+ * the internal event bus.
+ *
+ * Supported polls:
+ * - GitHub: open PR CI status, merge conflicts
+ * - Database: ready tickets, agent lifecycle states
+ */
+import type Database from 'better-sqlite3';
+import type { OrchestrateEngine } from './engine.js';
+export interface PollerOptions {
+    engine: OrchestrateEngine;
+    db: Database.Database;
+    log: (msg: string) => void;
+    /** Working directory for gh CLI commands */
+    cwd?: string;
+}
+export declare class OrchestratePoller {
+    private engine;
+    private db;
+    private log;
+    private cwd?;
+    /** Tracks known PR state to detect transitions. */
+    private trackedPRs;
+    /** Track which tickets we've already fired on_ticket_ready for. */
+    private firedReadyTickets;
+    /** Track known agent lifecycle states. */
+    private lastAgentStates;
+    private ghAvailable;
+    constructor(options: PollerOptions);
+    /**
+     * Run one poll cycle. Called by the daemon on each interval.
+     */
+    poll(): Promise<void>;
+    /**
+     * Check for tickets in "Ready" (todo) status with no active agent.
+     * Fires on_ticket_ready for each.
+     */
+    private pollReadyTickets;
+    /**
+     * Check agent_work table for lifecycle state changes.
+     * Fires on_agent_died, on_agent_completed, on_agent_idle as appropriate.
+     */
+    private pollAgentLifecycle;
+    /**
+     * Check GitHub PRs for CI completion and merge conflicts.
+     * Fires on_ci_green, on_ci_failed, on_pr_conflicting, on_pr_merged.
+     */
+    private pollGitHubPRs;
+    /**
+     * Extract ticket ID from branch name.
+     * Branch format: {ticketId}/{type}/{owner}/{agent}/{description}
+     */
+    private extractTicketFromBranch;
+}

package/dist/lib/orchestrate/poller.js

@@ -0,0 +1,282 @@
+/**
+ * Orchestrate External Event Poller
+ *
+ * Polls external systems (GitHub, database) and fires orchestrate events
+ * when conditions are detected. This bridges external state changes into
+ * the internal event bus.
+ *
+ * Supported polls:
+ * - GitHub: open PR CI status, merge conflicts
+ * - Database: ready tickets, agent lifecycle states
+ */
+import { execSync } from 'node:child_process';
+import { isGHInstalled, isGHAuthenticated, listOpenPRs, getPRChecks, getPRByNumber } from '../pr/index.js';
+// =============================================================================
+// Poller
+// =============================================================================
+export class OrchestratePoller {
+    engine;
+    db;
+    log;
+    cwd;
+    /** Tracks known PR state to detect transitions. */
+    trackedPRs = new Map();
+    /** Track which tickets we've already fired on_ticket_ready for. */
+    firedReadyTickets = new Set();
+    /** Track known agent lifecycle states. */
+    lastAgentStates = new Map();
+    ghAvailable = null;
+    constructor(options) {
+        this.engine = options.engine;
+        this.db = options.db;
+        this.log = options.log;
+        this.cwd = options.cwd;
+    }
+    /**
+     * Run one poll cycle. Called by the daemon on each interval.
+     */
+    async poll() {
+        await this.pollReadyTickets();
+        await this.pollAgentLifecycle();
+        await this.pollGitHubPRs();
+    }
+    // ===========================================================================
+    // Ticket Polling
+    // ===========================================================================
+    /**
+     * Check for tickets in "Ready" (todo) status with no active agent.
+     * Fires on_ticket_ready for each.
+     */
+    async pollReadyTickets() {
+        try {
+            const readyTickets = this.db.prepare(`
+        SELECT t.id, t.title
+        FROM pmo_tickets t
+        JOIN pmo_workflow_statuses ws ON t.status_id = ws.id
+        WHERE ws.category = 'todo'
+          AND t.assignee IS NULL
+          AND t.id NOT IN (
+            SELECT ticket_id FROM agent_work WHERE status IN ('starting', 'running')
+          )
+        LIMIT 10
+      `).all();
+            for (const ticket of readyTickets) {
+                if (this.firedReadyTickets.has(ticket.id))
+                    continue;
+                this.firedReadyTickets.add(ticket.id);
+                this.log(`[poll] Detected ready ticket: ${ticket.id}`);
+                await this.engine.fireEvent('on_ticket_ready', {
+                    event: 'on_ticket_ready',
+                    ticket: ticket.id,
+                });
+            }
+        }
+        catch {
+            // Non-fatal polling error
+        }
+    }
+    // ===========================================================================
+    // Agent Lifecycle Polling
+    // ===========================================================================
+    /**
+     * Check agent_work table for lifecycle state changes.
+     * Fires on_agent_died, on_agent_completed, on_agent_idle as appropriate.
+     */
+    async pollAgentLifecycle() {
+        try {
+            const agents = this.db.prepare(`
+        SELECT id, ticket_id, agent_name, status, lifecycle_state, container_id, last_heartbeat
+        FROM agent_work
+        WHERE status IN ('starting', 'running', 'error')
+        LIMIT 50
+      `).all();
+            for (const agent of agents) {
+                const prevState = this.lastAgentStates.get(agent.id);
+                const currentState = agent.lifecycle_state || agent.status;
+                if (prevState === currentState)
+                    continue;
+                this.lastAgentStates.set(agent.id, currentState);
+                // Skip the first observation (we only fire on transitions)
+                if (!prevState)
+                    continue;
+                const ctx = {
+                    event: '',
+                    ticket: agent.ticket_id,
+                    agent: agent.agent_name,
+                    container: agent.container_id || undefined,
+                    executionId: agent.id,
+                };
+                if (currentState === 'died' || (agent.status === 'error' && prevState !== 'error')) {
+                    this.log(`[poll] Agent died: ${agent.agent_name} (${agent.ticket_id})`);
+                    await this.engine.fireEvent('on_agent_died', { ...ctx, event: 'on_agent_died' });
+                }
+                else if (currentState === 'completed') {
+                    this.log(`[poll] Agent completed: ${agent.agent_name} (${agent.ticket_id})`);
+                    await this.engine.fireEvent('on_agent_completed', { ...ctx, event: 'on_agent_completed' });
+                }
+                else if (currentState === 'idle') {
+                    this.log(`[poll] Agent idle: ${agent.agent_name} (${agent.ticket_id})`);
+                    await this.engine.fireEvent('on_agent_idle', { ...ctx, event: 'on_agent_idle' });
+                }
+            }
+            // Detect idle agents by heartbeat timeout (5 minutes)
+            try {
+                const idleAgents = this.db.prepare(`
+          SELECT id, ticket_id, agent_name, container_id
+          FROM agent_work
+          WHERE status = 'running'
+            AND last_heartbeat IS NOT NULL
+            AND datetime(last_heartbeat) < datetime('now', '-5 minutes')
+            AND (lifecycle_state IS NULL OR lifecycle_state = 'healthy')
+          LIMIT 10
+        `).all();
+                for (const agent of idleAgents) {
+                    const prevState = this.lastAgentStates.get(agent.id);
+                    if (prevState === 'idle')
+                        continue;
+                    this.lastAgentStates.set(agent.id, 'idle');
+                    if (prevState) {
+                        this.log(`[poll] Agent idle (heartbeat timeout): ${agent.agent_name}`);
+                        await this.engine.fireEvent('on_agent_idle', {
+                            event: 'on_agent_idle',
+                            ticket: agent.ticket_id,
+                            agent: agent.agent_name,
+                            container: agent.container_id || undefined,
+                            executionId: agent.id,
+                        });
+                    }
+                }
+            }
+            catch {
+                // last_heartbeat column might not exist yet
+            }
+        }
+        catch {
+            // Non-fatal polling error
+        }
+    }
+    // ===========================================================================
+    // GitHub PR Polling
+    // ===========================================================================
+    /**
+     * Check GitHub PRs for CI completion and merge conflicts.
+     * Fires on_ci_green, on_ci_failed, on_pr_conflicting, on_pr_merged.
+     */
+    async pollGitHubPRs() {
+        if (this.ghAvailable === null) {
+            this.ghAvailable = isGHInstalled() && isGHAuthenticated();
+        }
+        if (!this.ghAvailable)
+            return;
+        try {
+            const openPRs = listOpenPRs(this.cwd);
+            for (const pr of openPRs) {
+                const tracked = this.trackedPRs.get(pr.number);
+                const ticketId = this.extractTicketFromBranch(pr.headBranch);
+                // --- CI Status ---
+                const checks = getPRChecks(pr.number, this.cwd);
+                let ciState = 'unknown';
+                if (checks.length > 0) {
+                    const allDone = checks.every(c => c.status === 'COMPLETED' || c.conclusion);
+                    if (allDone) {
+                        const allPassed = checks.every(c => c.conclusion === 'SUCCESS' || c.conclusion === 'NEUTRAL' || c.conclusion === 'SKIPPED');
+                        ciState = allPassed ? 'success' : 'failure';
+                    }
+                    else {
+                        ciState = 'pending';
+                    }
+                }
+                // Fire CI events on state transition
+                if (tracked && ciState !== tracked.lastCIState && ciState !== 'pending' && ciState !== 'unknown') {
+                    if (ciState === 'success') {
+                        this.log(`[poll] CI green: PR #${pr.number}`);
+                        await this.engine.fireEvent('on_ci_green', {
+                            event: 'on_ci_green',
+                            pr: pr.number,
+                            branch: pr.headBranch,
+                            ticket: ticketId,
+                            prUrl: pr.url,
+                        });
+                    }
+                    else if (ciState === 'failure') {
+                        this.log(`[poll] CI failed: PR #${pr.number}`);
+                        await this.engine.fireEvent('on_ci_failed', {
+                            event: 'on_ci_failed',
+                            pr: pr.number,
+                            branch: pr.headBranch,
+                            ticket: ticketId,
+                            prUrl: pr.url,
+                        });
+                    }
+                }
+                // --- Merge Conflicts ---
+                let mergeable = 'UNKNOWN';
+                try {
+                    const mergeableResult = execSync(`gh pr view ${pr.number} --json mergeable -q .mergeable`, { cwd: this.cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+                    if (mergeableResult === 'CONFLICTING') {
+                        mergeable = 'CONFLICTING';
+                    }
+                    else if (mergeableResult === 'MERGEABLE') {
+                        mergeable = 'MERGEABLE';
+                    }
+                }
+                catch {
+                    // gh command failed
+                }
+                if (tracked &&
+                    mergeable === 'CONFLICTING' &&
+                    tracked.lastMergeable !== 'CONFLICTING') {
+                    this.log(`[poll] PR conflicting: PR #${pr.number}`);
+                    await this.engine.fireEvent('on_pr_conflicting', {
+                        event: 'on_pr_conflicting',
+                        pr: pr.number,
+                        branch: pr.headBranch,
+                        ticket: ticketId,
+                        prUrl: pr.url,
+                    });
+                }
+                // Update tracking
+                this.trackedPRs.set(pr.number, {
+                    number: pr.number,
+                    lastCIState: ciState,
+                    lastMergeable: mergeable,
+                });
+            }
+            // Detect merged/closed PRs (were tracked but no longer open)
+            for (const [prNum, tracked] of this.trackedPRs) {
+                if (!openPRs.some(p => p.number === prNum)) {
+                    // PR was open, now it's not — check if merged
+                    const pr = getPRByNumber(prNum, this.cwd);
+                    if (pr?.state === 'MERGED') {
+                        const ticketId = this.extractTicketFromBranch(pr.headBranch);
+                        this.log(`[poll] PR merged: PR #${prNum}`);
+                        await this.engine.fireEvent('on_pr_merged', {
+                            event: 'on_pr_merged',
+                            pr: prNum,
+                            branch: pr.headBranch,
+                            ticket: ticketId,
+                            prUrl: pr.url,
+                        });
+                    }
+                    this.trackedPRs.delete(prNum);
+                }
+            }
+        }
+        catch {
+            // Non-fatal GitHub polling error
+        }
+    }
+    // ===========================================================================
+    // Helpers
+    // ===========================================================================
+    /**
+     * Extract ticket ID from branch name.
+     * Branch format: {ticketId}/{type}/{owner}/{agent}/{description}
+     */
+    extractTicketFromBranch(branch) {
+        // Match patterns like PRLT-123/... or TKT-456/...
+        const match = branch.match(/^([A-Z]+-\d+|TKT-\d+)\//);
+        return match ? match[1] : undefined;
+    }
+}
+//# sourceMappingURL=poller.js.map