@proletariat/cli 0.3.91 → 0.3.93

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

@@ -0,0 +1,94 @@
+/**
+ * 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 type Database from 'better-sqlite3';
+import type { OrchestrateEventContext, OrchestrateActionResult } from './types.js';
+export interface OrchestrateEngineOptions {
+    /** Database connection */
+    db: Database.Database;
+    /** Logger function */
+    log?: (msg: string) => void;
+    /** Callback for confirm-mode hooks (returns true to approve) */
+    onConfirm?: (hookName: string, event: string, action: string) => Promise<boolean>;
+    /** Callback for notifications */
+    onNotify?: (hookName: string, event: string, action: string, result: OrchestrateActionResult) => void;
+}
+export declare class OrchestrateEngine {
+    private db;
+    private hookStorage;
+    private unsubscribers;
+    private log;
+    private onConfirm?;
+    private onNotify?;
+    private running;
+    private pendingConfirmations;
+    constructor(options: OrchestrateEngineOptions);
+    /**
+     * Start the orchestrate engine — subscribe to all orchestrate events.
+     */
+    start(): void;
+    /**
+     * Stop the engine and clean up subscriptions.
+     */
+    stop(): void;
+    /**
+     * Fire an event manually (used by `prlt hook fire`).
+     * This is the entry point for external event sources (GitHub Actions, polling, etc.).
+     */
+    fireEvent(event: string, ctx: OrchestrateEventContext): Promise<OrchestrateActionResult[]>;
+    /**
+     * Get pending confirmations for hooks in confirm mode.
+     */
+    getPendingConfirmations(): typeof this.pendingConfirmations;
+    /**
+     * Approve a pending confirmation and execute it.
+     */
+    approveConfirmation(index: number): Promise<OrchestrateActionResult | null>;
+    /**
+     * Deny a pending confirmation.
+     */
+    denyConfirmation(index: number): boolean;
+    /**
+     * Handle an event by finding and executing matching hooks.
+     */
+    private handleEvent;
+    /**
+     * Get hooks for a given event from the database, ordered by priority.
+     */
+    private getHooksForEvent;
+    /**
+     * Build an OrchestrateEventContext from raw event data.
+     */
+    private buildContext;
+    /**
+     * Resolve the action name from a hook row.
+     * Built-in actions are referenced by name; shell hooks use the raw command.
+     */
+    private resolveActionName;
+    /**
+     * Execute an action — either built-in or shell fallback.
+     */
+    private executeAction;
+}
+/**
+ * Initialize and start the orchestrate engine.
+ * Safe to call multiple times.
+ */
+export declare function initOrchestrateEngine(options: OrchestrateEngineOptions): OrchestrateEngine;
+/**
+ * Get the running orchestrate engine instance.
+ */
+export declare function getOrchestrateEngine(): OrchestrateEngine | undefined;
+/**
+ * Stop the orchestrate engine.
+ */
+export declare function stopOrchestrateEngine(): void;

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;
+}