@proletariat/cli 0.3.76 → 0.3.78

package/dist/lib/providers/resolver.js

@@ -4,6 +4,11 @@
  * Determines which provider should handle ticket operations based on the
  * ticket's external source metadata or workspace configuration.
  *
+ * All resolved providers are wrapped with EventEmittingProvider, making
+ * the adapter layer the central event hub. Every provider (PMO, Linear,
+ * Jira, Shortcut, Asana) is an equal peer that emits events through
+ * the same mechanism.
+ *
  * Two resolution modes:
  * 1. Ticket-level: resolveTicketProvider() — for operations on a specific ticket
  *    (move, delete). Uses the ticket's metadata to find the source of truth.
@@ -16,6 +21,68 @@ import { isLinearConfigured } from '../linear/config.js';
 import { LinearMapper } from '../linear/mapper.js';
 import { PMOTicketProvider } from './pmo-provider.js';
 import { LinearTicketProvider } from './linear-provider.js';
+import { EventEmittingProvider } from './event-emitting-provider.js';
+/**
+ * Create a StatusResolver backed by the database.
+ * Used by EventEmittingProvider to resolve status names/categories
+ * for event emission.
+ */
+function createDbStatusResolver(db, storage) {
+    return {
+        resolveStatusByName(projectId, statusName) {
+            try {
+                const row = db.prepare(`
+          SELECT ws.id, ws.name, ws.category
+          FROM pmo_workflow_statuses ws
+          JOIN pmo_projects p ON p.workflow_id = ws.workflow_id
+          WHERE p.id = ? AND LOWER(ws.name) = LOWER(?)
+        `).get(projectId, statusName);
+                if (row) {
+                    return { id: row.id, name: row.name, category: row.category };
+                }
+                // Fallback: search by status ID
+                const byId = db.prepare(`
+          SELECT id, name, category FROM pmo_workflow_statuses WHERE id = ?
+        `).get(statusName);
+                if (byId) {
+                    return { id: byId.id, name: byId.name, category: byId.category };
+                }
+            }
+            catch {
+                // Non-fatal: status resolution is best-effort
+            }
+            return null;
+        },
+        getTicketStatus(ticketId) {
+            try {
+                const row = db.prepare(`
+          SELECT t.status_id, ws.name, ws.category
+          FROM pmo_tickets t
+          LEFT JOIN pmo_workflow_statuses ws ON t.status_id = ws.id
+          WHERE t.id = ?
+        `).get(ticketId);
+                if (row) {
+                    return {
+                        statusId: row.status_id,
+                        statusName: row.name,
+                        statusCategory: row.category ?? null,
+                    };
+                }
+            }
+            catch {
+                // Non-fatal: status resolution is best-effort
+            }
+            return null;
+        },
+    };
+}
+/**
+ * Wrap a provider with EventEmittingProvider for event emission.
+ */
+function wrapWithEvents(provider, db, storage, projectId) {
+    const resolver = createDbStatusResolver(db, storage);
+    return new EventEmittingProvider(provider, resolver, projectId);
+}
 /**
  * Resolve the correct provider for a given ticket.
  *
@@ -23,6 +90,9 @@ import { LinearTicketProvider } from './linear-provider.js';
  * - external_source = 'linear' + configured + inbound/bidirectional → Linear
  * - Otherwise → PMO
  *
+ * The resolved provider is wrapped with EventEmittingProvider so that
+ * events are emitted at the adapter layer, not the storage layer.
+ *
  * @param ticketId - The PMO ticket ID
  * @param projectId - The PMO project ID
  * @param db - Database handle for config/mapping lookups
@@ -42,12 +112,14 @@ export function resolveTicketProvider(ticketId, projectId, db, storage, metadata
             // - 'bidirectional' = both directions synced → write to Linear directly
             // - 'outbound' = ticket was created in PMO and pushed to Linear → PMO is source of truth
             if (mapping.syncDirection !== 'outbound') {
-                return new LinearTicketProvider(db, storage, projectId, null);
+                const inner = new LinearTicketProvider(db, storage, projectId, null);
+                return wrapWithEvents(inner, db, storage, projectId);
             }
         }
     }
     // Default: local PMO
-    return new PMOTicketProvider(storage, projectId);
+    const inner = new PMOTicketProvider(storage, projectId);
+    return wrapWithEvents(inner, db, storage, projectId);
 }
 /**
  * Resolve the correct provider for project-level operations (list, create).
@@ -55,6 +127,9 @@ export function resolveTicketProvider(ticketId, projectId, db, storage, metadata
  * Unlike resolveTicketProvider, this doesn't require a specific ticket.
  * It checks workspace configuration to determine the active provider.
  *
+ * The resolved provider is wrapped with EventEmittingProvider so that
+ * events are emitted at the adapter layer, not the storage layer.
+ *
  * @param db - Database handle for config lookups
  * @param storage - Storage instance
  * @param projectId - The PMO project ID
@@ -63,20 +138,24 @@ export function resolveTicketProvider(ticketId, projectId, db, storage, metadata
  */
 export function resolveProjectProvider(db, storage, projectId, source) {
     if (source === 'pmo') {
-        return new PMOTicketProvider(storage, projectId);
+        const inner = new PMOTicketProvider(storage, projectId);
+        return wrapWithEvents(inner, db, storage, projectId);
     }
     if (source === 'linear') {
-        return new LinearTicketProvider(db, storage, projectId, null);
+        const inner = new LinearTicketProvider(db, storage, projectId, null);
+        return wrapWithEvents(inner, db, storage, projectId);
     }
     // auto: use Linear when it's configured in the workspace
     try {
         if (isLinearConfigured(db)) {
-            return new LinearTicketProvider(db, storage, projectId, null);
+            const inner = new LinearTicketProvider(db, storage, projectId, null);
+            return wrapWithEvents(inner, db, storage, projectId);
         }
     }
     catch {
         // workspace_settings table may not exist in older/test databases
     }
-    return new PMOTicketProvider(storage, projectId);
+    const inner = new PMOTicketProvider(storage, projectId);
+    return wrapWithEvents(inner, db, storage, projectId);
 }
 //# sourceMappingURL=resolver.js.map

package/dist/lib/providers/resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../src/lib/providers/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAE3D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,SAAiB,EACjB,EAAqB,EACrB,OAAwB,EACxB,QAAwC;IAExC,MAAM,cAAc,GAAG,QAAQ,EAAE,eAAe,CAAA;IAEhD,eAAe;IACf,IAAI,cAAc,KAAK,QAAQ,IAAI,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAA;QACnC,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;QAE9C,IAAI,OAAO,EAAE,CAAC;YACZ,+DAA+D;YAC/D,4EAA4E;YAC5E,wEAAwE;YACxE,yFAAyF;YACzF,IAAI,OAAO,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;gBACzC,OAAO,IAAI,oBAAoB,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,CAAA;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,OAAO,IAAI,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;AAClD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CACpC,EAAqB,EACrB,OAAwB,EACxB,SAAiB,EACjB,MAAe;IAEf,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,OAAO,IAAI,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IAClD,CAAC;IAED,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,OAAO,IAAI,oBAAoB,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,CAAA;IAC/D,CAAC;IAED,yDAAyD;IACzD,IAAI,CAAC;QACH,IAAI,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,oBAAoB,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,CAAA;QAC/D,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;IACnE,CAAC;IAED,OAAO,IAAI,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;AAClD,CAAC"}
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../src/lib/providers/resolver.ts"],"names":[],"mappings":"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"}

package/dist/lib/providers/status-mapping.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Provider Status Mapping
+ *
+ * Configurable mapping between provider-specific status names and
+ * canonical workflow statuses. Each provider (Linear, Jira, Shortcut,
+ * Asana, etc.) may use different status vocabularies. This module
+ * translates between them.
+ *
+ * Example mappings:
+ *   linear: "In Review" → canonical: "Review"
+ *   jira: "Code Review" → canonical: "Review"
+ *   asana: "QA" → canonical: "Review"
+ *
+ * When no mapping is configured, the system falls back to:
+ * 1. Exact name match
+ * 2. Category-based matching (e.g., 'started' category)
+ */
+import type Database from 'better-sqlite3';
+import type { StateCategory } from '../pmo/types.js';
+export interface StatusMapping {
+    provider: string;
+    providerStatus: string;
+    canonicalStatus: string;
+    canonicalCategory: StateCategory | null;
+}
+/**
+ * ProviderStatusMappingStore manages the pmo_provider_status_map table.
+ * Provides CRUD operations for status mappings per provider.
+ */
+export declare class ProviderStatusMappingStore {
+    private db;
+    constructor(db: Database.Database);
+    /**
+     * Get the canonical status for a provider-specific status.
+     * Returns null if no mapping is configured.
+     */
+    getCanonicalStatus(provider: string, providerStatus: string): StatusMapping | null;
+    /**
+     * Get the provider-specific status for a canonical status.
+     * Returns null if no mapping is configured.
+     */
+    getProviderStatus(provider: string, canonicalStatus: string): StatusMapping | null;
+    /**
+     * List all status mappings for a provider.
+     */
+    listMappings(provider: string): StatusMapping[];
+    /**
+     * Add or update a status mapping for a provider.
+     */
+    upsertMapping(mapping: StatusMapping): void;
+    /**
+     * Remove a specific status mapping.
+     */
+    removeMapping(provider: string, providerStatus: string): void;
+    /**
+     * Remove all status mappings for a provider.
+     */
+    clearMappings(provider: string): void;
+    /**
+     * Resolve a status name from a provider to its canonical equivalent.
+     * Falls back to the original name if no mapping is found.
+     */
+    resolveStatus(provider: string, statusName: string): string;
+}

package/dist/lib/providers/status-mapping.js

@@ -0,0 +1,136 @@
+/**
+ * Provider Status Mapping
+ *
+ * Configurable mapping between provider-specific status names and
+ * canonical workflow statuses. Each provider (Linear, Jira, Shortcut,
+ * Asana, etc.) may use different status vocabularies. This module
+ * translates between them.
+ *
+ * Example mappings:
+ *   linear: "In Review" → canonical: "Review"
+ *   jira: "Code Review" → canonical: "Review"
+ *   asana: "QA" → canonical: "Review"
+ *
+ * When no mapping is configured, the system falls back to:
+ * 1. Exact name match
+ * 2. Category-based matching (e.g., 'started' category)
+ */
+/**
+ * ProviderStatusMappingStore manages the pmo_provider_status_map table.
+ * Provides CRUD operations for status mappings per provider.
+ */
+export class ProviderStatusMappingStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Get the canonical status for a provider-specific status.
+     * Returns null if no mapping is configured.
+     */
+    getCanonicalStatus(provider, providerStatus) {
+        try {
+            const row = this.db.prepare(`
+        SELECT provider, provider_status, canonical_status, canonical_category
+        FROM pmo_provider_status_map
+        WHERE provider = ? AND LOWER(provider_status) = LOWER(?)
+      `).get(provider, providerStatus);
+            if (!row)
+                return null;
+            return {
+                provider: row.provider,
+                providerStatus: row.provider_status,
+                canonicalStatus: row.canonical_status,
+                canonicalCategory: row.canonical_category,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get the provider-specific status for a canonical status.
+     * Returns null if no mapping is configured.
+     */
+    getProviderStatus(provider, canonicalStatus) {
+        try {
+            const row = this.db.prepare(`
+        SELECT provider, provider_status, canonical_status, canonical_category
+        FROM pmo_provider_status_map
+        WHERE provider = ? AND LOWER(canonical_status) = LOWER(?)
+      `).get(provider, canonicalStatus);
+            if (!row)
+                return null;
+            return {
+                provider: row.provider,
+                providerStatus: row.provider_status,
+                canonicalStatus: row.canonical_status,
+                canonicalCategory: row.canonical_category,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * List all status mappings for a provider.
+     */
+    listMappings(provider) {
+        try {
+            const rows = this.db.prepare(`
+        SELECT provider, provider_status, canonical_status, canonical_category
+        FROM pmo_provider_status_map
+        WHERE provider = ?
+        ORDER BY canonical_status
+      `).all(provider);
+            return rows.map(row => ({
+                provider: row.provider,
+                providerStatus: row.provider_status,
+                canonicalStatus: row.canonical_status,
+                canonicalCategory: row.canonical_category,
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Add or update a status mapping for a provider.
+     */
+    upsertMapping(mapping) {
+        this.db.prepare(`
+      INSERT INTO pmo_provider_status_map (provider, provider_status, canonical_status, canonical_category)
+      VALUES (?, ?, ?, ?)
+      ON CONFLICT(provider, provider_status) DO UPDATE SET
+        canonical_status = excluded.canonical_status,
+        canonical_category = excluded.canonical_category
+    `).run(mapping.provider, mapping.providerStatus, mapping.canonicalStatus, mapping.canonicalCategory);
+    }
+    /**
+     * Remove a specific status mapping.
+     */
+    removeMapping(provider, providerStatus) {
+        this.db.prepare(`
+      DELETE FROM pmo_provider_status_map
+      WHERE provider = ? AND provider_status = ?
+    `).run(provider, providerStatus);
+    }
+    /**
+     * Remove all status mappings for a provider.
+     */
+    clearMappings(provider) {
+        this.db.prepare(`
+      DELETE FROM pmo_provider_status_map
+      WHERE provider = ?
+    `).run(provider);
+    }
+    /**
+     * Resolve a status name from a provider to its canonical equivalent.
+     * Falls back to the original name if no mapping is found.
+     */
+    resolveStatus(provider, statusName) {
+        const mapping = this.getCanonicalStatus(provider, statusName);
+        return mapping?.canonicalStatus ?? statusName;
+    }
+}
+//# sourceMappingURL=status-mapping.js.map

package/dist/lib/providers/status-mapping.js.map

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

package/dist/lib/providers/trigger-config.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Provider Trigger Configuration
+ *
+ * Configurable triggers that map work lifecycle events to automatic
+ * column/status transitions. When a trigger event fires, the system
+ * automatically moves the affected ticket to the configured target status.
+ *
+ * Supported trigger events:
+ * - agent_started: An agent begins working on a ticket
+ * - pr_created: A pull request is created or linked
+ * - pr_merged: A pull request is merged
+ * - tests_passed: Tests pass for the work item
+ * - work_completed: Work on the item is marked complete
+ *
+ * Triggers can be scoped per provider (or '*' for all providers)
+ * and per project (or null for all projects).
+ *
+ * Example:
+ *   trigger_event: 'pr_created', target_status: 'Review'
+ *   → When a PR is created, move the ticket to "Review"
+ *
+ *   trigger_event: 'pr_merged', target_status: 'Done'
+ *   → When a PR is merged, move the ticket to "Done"
+ */
+import type Database from 'better-sqlite3';
+/**
+ * Valid trigger event names that can be configured.
+ */
+export type TriggerEvent = 'agent_started' | 'pr_created' | 'pr_merged' | 'tests_passed' | 'work_completed';
+export declare const TRIGGER_EVENTS: readonly TriggerEvent[];
+export interface TriggerConfig {
+    id?: number;
+    provider: string;
+    triggerEvent: TriggerEvent;
+    targetStatus: string;
+    projectId: string | null;
+    enabled: boolean;
+}
+/**
+ * ProviderTriggerStore manages the pmo_provider_triggers table.
+ * Provides CRUD operations for configurable triggers.
+ */
+export declare class ProviderTriggerStore {
+    private db;
+    constructor(db: Database.Database);
+    /**
+     * Get all triggers for a specific event, optionally filtered by provider and project.
+     */
+    getTriggersForEvent(triggerEvent: TriggerEvent, provider?: string, projectId?: string | null): TriggerConfig[];
+    /**
+     * List all configured triggers.
+     */
+    listTriggers(): TriggerConfig[];
+    /**
+     * Add or update a trigger configuration.
+     */
+    upsertTrigger(config: TriggerConfig): void;
+    /**
+     * Remove a trigger by ID.
+     */
+    removeTrigger(id: number): void;
+    /**
+     * Enable or disable a trigger.
+     */
+    setEnabled(id: number, enabled: boolean): void;
+}
+/**
+ * TriggerHandler subscribes to work-lifecycle events on the EventBus
+ * and automatically transitions tickets based on configured triggers.
+ */
+export declare class TriggerHandler {
+    private unsubscribers;
+    private store;
+    private moveTicket;
+    constructor(db: Database.Database, moveTicket: (ticketId: string, projectId: string, targetStatus: string) => Promise<void>);
+    /**
+     * Start listening for work-lifecycle events and applying triggers.
+     */
+    start(): void;
+    /**
+     * Stop listening for events.
+     */
+    stop(): void;
+    /**
+     * Apply a trigger: look up configured triggers for the event
+     * and move the ticket to the target status if a match is found.
+     */
+    private applyTrigger;
+}
+/**
+ * Initialize the trigger handler.
+ * Safe to call multiple times — subsequent calls are no-ops.
+ */
+export declare function initTriggerHandler(db: Database.Database, moveTicket: (ticketId: string, projectId: string, targetStatus: string) => Promise<void>): TriggerHandler;
+/**
+ * Stop the trigger handler (primarily for testing).
+ */
+export declare function stopTriggerHandler(): void;

package/dist/lib/providers/trigger-config.js

@@ -0,0 +1,204 @@
+/**
+ * Provider Trigger Configuration
+ *
+ * Configurable triggers that map work lifecycle events to automatic
+ * column/status transitions. When a trigger event fires, the system
+ * automatically moves the affected ticket to the configured target status.
+ *
+ * Supported trigger events:
+ * - agent_started: An agent begins working on a ticket
+ * - pr_created: A pull request is created or linked
+ * - pr_merged: A pull request is merged
+ * - tests_passed: Tests pass for the work item
+ * - work_completed: Work on the item is marked complete
+ *
+ * Triggers can be scoped per provider (or '*' for all providers)
+ * and per project (or null for all projects).
+ *
+ * Example:
+ *   trigger_event: 'pr_created', target_status: 'Review'
+ *   → When a PR is created, move the ticket to "Review"
+ *
+ *   trigger_event: 'pr_merged', target_status: 'Done'
+ *   → When a PR is merged, move the ticket to "Done"
+ */
+import { getEventBus } from '../events/event-bus.js';
+export const TRIGGER_EVENTS = [
+    'agent_started',
+    'pr_created',
+    'pr_merged',
+    'tests_passed',
+    'work_completed',
+];
+/**
+ * ProviderTriggerStore manages the pmo_provider_triggers table.
+ * Provides CRUD operations for configurable triggers.
+ */
+export class ProviderTriggerStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Get all triggers for a specific event, optionally filtered by provider and project.
+     */
+    getTriggersForEvent(triggerEvent, provider, projectId) {
+        try {
+            const rows = this.db.prepare(`
+        SELECT id, provider, trigger_event, target_status, project_id, enabled
+        FROM pmo_provider_triggers
+        WHERE trigger_event = ?
+          AND enabled = 1
+          AND (provider = '*' OR provider = ?)
+          AND (project_id IS NULL OR project_id = ?)
+        ORDER BY
+          CASE WHEN provider != '*' THEN 0 ELSE 1 END,
+          CASE WHEN project_id IS NOT NULL THEN 0 ELSE 1 END
+      `).all(triggerEvent, provider ?? '*', projectId ?? null);
+            return rows.map(row => ({
+                id: row.id,
+                provider: row.provider,
+                triggerEvent: row.trigger_event,
+                targetStatus: row.target_status,
+                projectId: row.project_id,
+                enabled: row.enabled === 1,
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * List all configured triggers.
+     */
+    listTriggers() {
+        try {
+            const rows = this.db.prepare(`
+        SELECT id, provider, trigger_event, target_status, project_id, enabled
+        FROM pmo_provider_triggers
+        ORDER BY trigger_event, provider
+      `).all();
+            return rows.map(row => ({
+                id: row.id,
+                provider: row.provider,
+                triggerEvent: row.trigger_event,
+                targetStatus: row.target_status,
+                projectId: row.project_id,
+                enabled: row.enabled === 1,
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Add or update a trigger configuration.
+     */
+    upsertTrigger(config) {
+        this.db.prepare(`
+      INSERT INTO pmo_provider_triggers (provider, trigger_event, target_status, project_id, enabled)
+      VALUES (?, ?, ?, ?, ?)
+      ON CONFLICT(provider, trigger_event, project_id) DO UPDATE SET
+        target_status = excluded.target_status,
+        enabled = excluded.enabled
+    `).run(config.provider, config.triggerEvent, config.targetStatus, config.projectId, config.enabled ? 1 : 0);
+    }
+    /**
+     * Remove a trigger by ID.
+     */
+    removeTrigger(id) {
+        this.db.prepare('DELETE FROM pmo_provider_triggers WHERE id = ?').run(id);
+    }
+    /**
+     * Enable or disable a trigger.
+     */
+    setEnabled(id, enabled) {
+        this.db.prepare('UPDATE pmo_provider_triggers SET enabled = ? WHERE id = ?').run(enabled ? 1 : 0, id);
+    }
+}
+/**
+ * TriggerHandler subscribes to work-lifecycle events on the EventBus
+ * and automatically transitions tickets based on configured triggers.
+ */
+export class TriggerHandler {
+    unsubscribers = [];
+    store;
+    moveTicket;
+    constructor(db, moveTicket) {
+        this.store = new ProviderTriggerStore(db);
+        this.moveTicket = moveTicket;
+    }
+    /**
+     * Start listening for work-lifecycle events and applying triggers.
+     */
+    start() {
+        const bus = getEventBus();
+        // agent_started trigger: fires on work:started events
+        this.unsubscribers.push(bus.on('work:started', (event) => {
+            void this.applyTrigger('agent_started', event.source, event.workItemId, event.projectId ?? null);
+        }));
+        // pr_created trigger: fires on work:pr_created events
+        this.unsubscribers.push(bus.on('work:pr_created', (event) => {
+            void this.applyTrigger('pr_created', event.source, event.workItemId, event.projectId ?? null);
+        }));
+        // pr_merged trigger: fires on work:pr_merged events
+        this.unsubscribers.push(bus.on('work:pr_merged', (event) => {
+            void this.applyTrigger('pr_merged', event.source, event.workItemId, event.projectId ?? null);
+        }));
+        // work_completed trigger: fires on work:completed events
+        this.unsubscribers.push(bus.on('work:completed', (event) => {
+            void this.applyTrigger('work_completed', event.source, event.workItemId, event.projectId ?? null);
+        }));
+    }
+    /**
+     * Stop listening for events.
+     */
+    stop() {
+        for (const unsub of this.unsubscribers) {
+            unsub();
+        }
+        this.unsubscribers = [];
+    }
+    /**
+     * Apply a trigger: look up configured triggers for the event
+     * and move the ticket to the target status if a match is found.
+     */
+    async applyTrigger(triggerEvent, source, workItemId, projectId) {
+        const triggers = this.store.getTriggersForEvent(triggerEvent, source, projectId);
+        if (triggers.length === 0)
+            return;
+        // Use the most specific trigger (provider-specific + project-specific first)
+        const trigger = triggers[0];
+        try {
+            await this.moveTicket(workItemId, projectId ?? '', trigger.targetStatus);
+        }
+        catch {
+            // Trigger application is non-fatal
+        }
+    }
+}
+// =============================================================================
+// Singleton
+// =============================================================================
+let _handler;
+/**
+ * Initialize the trigger handler.
+ * Safe to call multiple times — subsequent calls are no-ops.
+ */
+export function initTriggerHandler(db, moveTicket) {
+    if (!_handler) {
+        _handler = new TriggerHandler(db, moveTicket);
+        _handler.start();
+    }
+    return _handler;
+}
+/**
+ * Stop the trigger handler (primarily for testing).
+ */
+export function stopTriggerHandler() {
+    if (_handler) {
+        _handler.stop();
+        _handler = undefined;
+    }
+}
+//# sourceMappingURL=trigger-config.js.map

package/dist/lib/providers/trigger-config.js.map

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