@proletariat/cli 0.3.92 → 0.3.94

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

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

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

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

@@ -0,0 +1,27 @@
+/**
+ * Orchestrate Presets
+ *
+ * Pre-configured hook sets for common automation levels.
+ *
+ * - aggressive: auto-everything — no human needed
+ * - conservative: confirm everything — human approves all
+ * - supervised: auto for safe ops, confirm for destructive
+ */
+import type { HookMode, OrchestrateEvent, PresetName } from './types.js';
+interface PresetHook {
+    event: OrchestrateEvent;
+    action: string;
+    mode: HookMode;
+    config?: Record<string, unknown>;
+}
+interface PresetDefinition {
+    name: PresetName;
+    description: string;
+    hooks: PresetHook[];
+}
+export declare const PRESETS: Record<PresetName, PresetDefinition>;
+/**
+ * Get a preset definition by name.
+ */
+export declare function getPreset(name: PresetName): PresetDefinition;
+export {};

package/dist/lib/orchestrate/presets.js

@@ -0,0 +1,65 @@
+/**
+ * Orchestrate Presets
+ *
+ * Pre-configured hook sets for common automation levels.
+ *
+ * - aggressive: auto-everything — no human needed
+ * - conservative: confirm everything — human approves all
+ * - supervised: auto for safe ops, confirm for destructive
+ */
+const SHARED_HOOKS = [
+    { event: 'on_ci_green', action: 'merge-pr' },
+    { event: 'on_pr_merged', action: 'move-ticket', config: { target: 'done' } },
+    { event: 'on_pr_opened', action: 'move-ticket', config: { target: 'review' } },
+    { event: 'on_pr_merged', action: 'rebase-conflicting-prs' },
+    { event: 'on_pr_conflicting', action: 'rebase-conflicting-prs' },
+    { event: 'on_ticket_ready', action: 'spawn-agent' },
+    { event: 'on_agent_died', action: 'respawn', config: { max_retries: 2 } },
+    { event: 'on_agent_died', action: 'notify' },
+    { event: 'on_ci_failed', action: 'notify' },
+    { event: 'on_ci_failed', action: 'spawn-fix-agent' },
+    { event: 'on_agent_completed', action: 'cleanup-container' },
+    { event: 'on_agent_idle', action: 'health-check' },
+    { event: 'on_agent_spawned', action: 'move-ticket', config: { target: 'in-progress' } },
+];
+/** Safe actions that can be auto-executed even in supervised mode. */
+const SAFE_ACTIONS = new Set([
+    'move-ticket',
+    'notify',
+    'cleanup-container',
+    'health-check',
+    'rebase-conflicting-prs',
+]);
+export const PRESETS = {
+    aggressive: {
+        name: 'aggressive',
+        description: 'Auto everything — no human needed',
+        hooks: SHARED_HOOKS.map(h => ({
+            ...h,
+            mode: 'auto',
+        })),
+    },
+    conservative: {
+        name: 'conservative',
+        description: 'Confirm everything — human approves all actions',
+        hooks: SHARED_HOOKS.map(h => ({
+            ...h,
+            mode: 'confirm',
+        })),
+    },
+    supervised: {
+        name: 'supervised',
+        description: 'Auto for safe ops, confirm for destructive actions',
+        hooks: SHARED_HOOKS.map(h => ({
+            ...h,
+            mode: (SAFE_ACTIONS.has(h.action) ? 'auto' : 'confirm'),
+        })),
+    },
+};
+/**
+ * Get a preset definition by name.
+ */
+export function getPreset(name) {
+    return PRESETS[name];
+}
+//# sourceMappingURL=presets.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../src/lib/orchestrate/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiBH,MAAM,YAAY,GAAyF;IACzG,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE;IAC5C,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;IAC5E,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;IAC9E,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,wBAAwB,EAAE;IAC3D,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,EAAE,wBAAwB,EAAE;IAChE,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,aAAa,EAAE;IACnD,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE;IACzE,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE;IAC5C,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE;IAC3C,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE;IACpD,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,mBAAmB,EAAE;IAC5D,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE;IAClD,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE;CACxF,CAAA;AAED,sEAAsE;AACtE,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,aAAa;IACb,QAAQ;IACR,mBAAmB;IACnB,cAAc;IACd,wBAAwB;CACzB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,OAAO,GAAyC;IAC3D,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,mCAAmC;QAChD,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC5B,GAAG,CAAC;YACJ,IAAI,EAAE,MAAkB;SACzB,CAAC,CAAC;KACJ;IAED,YAAY,EAAE;QACZ,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,iDAAiD;QAC9D,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC5B,GAAG,CAAC;YACJ,IAAI,EAAE,SAAqB;SAC5B,CAAC,CAAC;KACJ;IAED,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,oDAAoD;QACjE,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC5B,GAAG,CAAC;YACJ,IAAI,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAa;SACpE,CAAC,CAAC;KACJ;CACF,CAAA;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAgB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;AACtB,CAAC"}

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

@@ -0,0 +1,93 @@
+/**
+ * Orchestrate Types
+ *
+ * Defines events, hook modes, actions, and presets for the orchestrate daemon.
+ * The orchestrate system extends the existing work-lifecycle hooks with
+ * built-in actions and HITL (human-in-the-loop) controls.
+ */
+/**
+ * All events the orchestrate daemon can react to.
+ * Extends the existing HookableEvent set with CI/PR/agent lifecycle events.
+ */
+export type OrchestrateEvent = 'work:started' | 'work:status_changed' | 'work:pr_created' | 'work:pr_merged' | 'work:pr_closed' | 'work:completed' | 'agent:spawned' | 'agent:stopped' | 'on_ci_green' | 'on_ci_failed' | 'on_pr_opened' | 'on_pr_merged' | 'on_pr_conflicting' | 'on_ticket_ready' | 'on_agent_spawned' | 'on_agent_died' | 'on_agent_completed' | 'on_agent_idle' | 'on_version_published';
+/** All valid orchestrate event names. */
+export declare const ORCHESTRATE_EVENTS: OrchestrateEvent[];
+/**
+ * Automation level for a hook.
+ *
+ * - auto: fires immediately, no human needed
+ * - confirm: pauses, notifies, waits for approval
+ * - notify: fires but also pings (log, Slack, dashboard)
+ * - off: disabled
+ */
+export type HookMode = 'auto' | 'confirm' | 'notify' | 'off';
+/** All valid hook modes. */
+export declare const HOOK_MODES: HookMode[];
+/**
+ * Built-in orchestrate actions.
+ * These are first-class actions the daemon knows how to execute natively.
+ */
+export type BuiltinAction = 'merge-pr' | 'move-ticket' | 'rebase-conflicting-prs' | 'spawn-agent' | 'respawn' | 'notify' | 'cleanup-container' | 'spawn-fix-agent' | 'health-check';
+/** All valid built-in action names. */
+export declare const BUILTIN_ACTIONS: BuiltinAction[];
+/**
+ * A single hook entry as defined in hooks.yml.
+ */
+export interface HookYamlEntry {
+    action: string;
+    mode: HookMode;
+    max_retries?: number;
+    args?: Record<string, string>;
+}
+/**
+ * The full hooks.yml file shape.
+ * Keys are event names, values are arrays of hook entries.
+ */
+export type HooksYaml = Record<string, HookYamlEntry[]>;
+/**
+ * The .proletariat/workflow.yml file shape.
+ */
+export interface WorkflowYaml {
+    branches?: {
+        target?: string;
+        strategy?: 'squash' | 'merge' | 'rebase';
+    };
+    on_implement_complete?: string[];
+    on_review_complete?: string[];
+    review?: {
+        required?: boolean | 'auto';
+        auto_merge_on_green?: boolean;
+    };
+}
+/**
+ * Preset name for quick hook configuration.
+ */
+export type PresetName = 'aggressive' | 'conservative' | 'supervised';
+/** All valid preset names. */
+export declare const PRESET_NAMES: PresetName[];
+/**
+ * Event context passed to hook handlers at runtime.
+ */
+export interface OrchestrateEventContext {
+    event: string;
+    ticket?: string;
+    pr?: number;
+    branch?: string;
+    agent?: string;
+    container?: string;
+    executionId?: string;
+    prUrl?: string;
+    projectId?: string;
+    [key: string]: unknown;
+}
+/**
+ * Result of running a single orchestrate hook action.
+ */
+export interface OrchestrateActionResult {
+    action: string;
+    success: boolean;
+    error?: string;
+    durationMs: number;
+    skipped?: boolean;
+    awaitingConfirmation?: boolean;
+}

package/dist/lib/orchestrate/types.js

@@ -0,0 +1,46 @@
+/**
+ * Orchestrate Types
+ *
+ * Defines events, hook modes, actions, and presets for the orchestrate daemon.
+ * The orchestrate system extends the existing work-lifecycle hooks with
+ * built-in actions and HITL (human-in-the-loop) controls.
+ */
+/** All valid orchestrate event names. */
+export const ORCHESTRATE_EVENTS = [
+    'work:started',
+    'work:status_changed',
+    'work:pr_created',
+    'work:pr_merged',
+    'work:pr_closed',
+    'work:completed',
+    'agent:spawned',
+    'agent:stopped',
+    'on_ci_green',
+    'on_ci_failed',
+    'on_pr_opened',
+    'on_pr_merged',
+    'on_pr_conflicting',
+    'on_ticket_ready',
+    'on_agent_spawned',
+    'on_agent_died',
+    'on_agent_completed',
+    'on_agent_idle',
+    'on_version_published',
+];
+/** All valid hook modes. */
+export const HOOK_MODES = ['auto', 'confirm', 'notify', 'off'];
+/** All valid built-in action names. */
+export const BUILTIN_ACTIONS = [
+    'merge-pr',
+    'move-ticket',
+    'rebase-conflicting-prs',
+    'spawn-agent',
+    'respawn',
+    'notify',
+    'cleanup-container',
+    'spawn-fix-agent',
+    'health-check',
+];
+/** All valid preset names. */
+export const PRESET_NAMES = ['aggressive', 'conservative', 'supervised'];
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/orchestrate/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiCH,yCAAyC;AACzC,MAAM,CAAC,MAAM,kBAAkB,GAAuB;IACpD,cAAc;IACd,qBAAqB;IACrB,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,eAAe;IACf,eAAe;IACf,aAAa;IACb,cAAc;IACd,cAAc;IACd,cAAc;IACd,mBAAmB;IACnB,iBAAiB;IACjB,kBAAkB;IAClB,eAAe;IACf,oBAAoB;IACpB,eAAe;IACf,sBAAsB;CACvB,CAAA;AAgBD,4BAA4B;AAC5B,MAAM,CAAC,MAAM,UAAU,GAAe,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA;AAqB1E,uCAAuC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,UAAU;IACV,aAAa;IACb,wBAAwB;IACxB,aAAa;IACb,SAAS;IACT,QAAQ;IACR,mBAAmB;IACnB,iBAAiB;IACjB,cAAc;CACf,CAAA;AAmDD,8BAA8B;AAC9B,MAAM,CAAC,MAAM,YAAY,GAAiB,CAAC,YAAY,EAAE,cAAc,EAAE,YAAY,CAAC,CAAA"}