@proletariat/cli 0.3.70 → 0.3.72

package/dist/lib/work-lifecycle/post-execution.js

@@ -0,0 +1,68 @@
+/**
+ * Post-Execution Transition Hook
+ *
+ * Handles automatic ticket state transitions after an action execution completes.
+ * Primary use case: when the implement action completes and a PR was created,
+ * automatically move the ticket from In Progress to Review.
+ *
+ * This hook replaces the need for a separate "create-pr" action. The implement
+ * action's endPrompt handles PR creation via `prlt work ready --pr`, and this
+ * hook ensures the state transition happens systematically.
+ */
+import { getWorkColumnSetting, findColumnByName } from '../pmo/utils.js';
+/**
+ * Check if a completed execution should trigger an automatic state transition.
+ *
+ * When an execution completes and the ticket:
+ * 1. Is in a "started" category (e.g., In Progress)
+ * 2. Has a PR URL in its metadata
+ *
+ * Then automatically move the ticket to the Review column.
+ * If no PR was created, the ticket stays in its current state.
+ *
+ * @param context - Execution context with ticket and optional action info
+ * @param storage - PMO storage instance for ticket operations
+ * @param db - Database for work column settings
+ * @returns Result indicating whether a transition occurred
+ */
+export async function handlePostExecutionTransition(context, storage, db) {
+    // Get the ticket to check current state and PR status
+    const ticket = await storage.getTicket(context.ticketId);
+    if (!ticket || !ticket.projectId) {
+        return { transitioned: false };
+    }
+    // Only auto-transition tickets that are in the "started" category (In Progress)
+    if (ticket.statusCategory !== 'started') {
+        return { transitioned: false };
+    }
+    // Check if a PR was created (PR URL exists in ticket metadata)
+    const prUrl = ticket.metadata?.pr_url;
+    if (!prUrl) {
+        return { transitioned: false };
+    }
+    // Get the Review column name
+    const targetColumnName = getWorkColumnSetting(db, 'review');
+    // Get board columns to find the review column
+    const board = await storage.getProjectBoard(ticket.projectId);
+    if (!board) {
+        return { transitioned: false };
+    }
+    const columnNames = board.columns.map(col => col.name);
+    const reviewColumn = findColumnByName(columnNames, targetColumnName);
+    if (!reviewColumn) {
+        return { transitioned: false };
+    }
+    // Already in Review — skip
+    if (ticket.statusName === reviewColumn) {
+        return { transitioned: false };
+    }
+    // Move ticket to Review
+    const previousState = ticket.statusName;
+    await storage.moveTicket(ticket.projectId, context.ticketId, reviewColumn);
+    return {
+        transitioned: true,
+        fromState: previousState,
+        toState: reviewColumn,
+    };
+}
+//# sourceMappingURL=post-execution.js.map

package/dist/lib/work-lifecycle/post-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-execution.js","sourceRoot":"","sources":["../../../src/lib/work-lifecycle/post-execution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AA6BxE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,OAA6B,EAC7B,OAA6B,EAC7B,EAAqB;IAErB,sDAAsD;IACtD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IACxD,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACjC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAA;IAChC,CAAC;IAED,gFAAgF;IAChF,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAA;IAChC,CAAC;IAED,+DAA+D;IAC/D,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAA;IACrC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAA;IAChC,CAAC;IAED,6BAA6B;IAC7B,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IAE3D,8CAA8C;IAC9C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAC7D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAA;IAChC,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACtD,MAAM,YAAY,GAAG,gBAAgB,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAA;IACpE,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAA;IAChC,CAAC;IAED,2BAA2B;IAC3B,IAAI,MAAM,CAAC,UAAU,KAAK,YAAY,EAAE,CAAC;QACvC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAA;IAChC,CAAC;IAED,wBAAwB;IACxB,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAA;IACvC,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;IAE1E,OAAO;QACL,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,aAAa;QACxB,OAAO,EAAE,YAAY;KACtB,CAAA;AACH,CAAC"}

package/dist/lib/work-lifecycle/rule-evaluator.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Workflow Rule Evaluator
+ *
+ * Subscribes to ticket:status_changed events on the global EventBus and
+ * evaluates workflow rules when a ticket enters a new state.
+ *
+ * For on_enter rules, emits a work:rule_matched event so that
+ * downstream systems (orchestrators, hooks) can fire the associated action.
+ * For manual rules, the match is logged but no action is auto-fired.
+ */
+import type Database from 'better-sqlite3';
+export declare class WorkflowRuleEvaluator {
+    private unsubscribers;
+    private db;
+    constructor(db: Database.Database);
+    /**
+     * Start listening for ticket state changes.
+     */
+    start(): void;
+    /**
+     * Stop listening for events.
+     */
+    stop(): void;
+    /**
+     * Evaluate workflow rules for a status change event.
+     * Finds all enabled rules matching the new state and emits events for on_enter rules.
+     */
+    private evaluate;
+}
+/**
+ * Initialize and start the workflow rule evaluator.
+ * Safe to call multiple times — subsequent calls are no-ops.
+ */
+export declare function initWorkflowRuleEvaluator(db: Database.Database): WorkflowRuleEvaluator;
+/**
+ * Stop the workflow rule evaluator (primarily for testing).
+ */
+export declare function stopWorkflowRuleEvaluator(): void;

package/dist/lib/work-lifecycle/rule-evaluator.js

@@ -0,0 +1,102 @@
+/**
+ * Workflow Rule Evaluator
+ *
+ * Subscribes to ticket:status_changed events on the global EventBus and
+ * evaluates workflow rules when a ticket enters a new state.
+ *
+ * For on_enter rules, emits a work:rule_matched event so that
+ * downstream systems (orchestrators, hooks) can fire the associated action.
+ * For manual rules, the match is logged but no action is auto-fired.
+ */
+import { getEventBus } from '../events/event-bus.js';
+import { PMO_TABLES } from '../pmo/schema.js';
+export class WorkflowRuleEvaluator {
+    unsubscribers = [];
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Start listening for ticket state changes.
+     */
+    start() {
+        const bus = getEventBus();
+        this.unsubscribers.push(bus.on('ticket:status_changed', (event) => {
+            this.evaluate(event);
+        }));
+    }
+    /**
+     * Stop listening for events.
+     */
+    stop() {
+        for (const unsub of this.unsubscribers) {
+            unsub();
+        }
+        this.unsubscribers = [];
+    }
+    /**
+     * Evaluate workflow rules for a status change event.
+     * Finds all enabled rules matching the new state and emits events for on_enter rules.
+     */
+    evaluate(event) {
+        if (!event.newStatusName)
+            return;
+        try {
+            // Find all enabled rules where to_state matches the new status
+            const rows = this.db.prepare(`
+        SELECT * FROM ${PMO_TABLES.workflow_rules}
+        WHERE to_state = ? AND enabled = 1
+      `).all(event.newStatusName);
+            if (rows.length === 0)
+                return;
+            const bus = getEventBus();
+            for (const row of rows) {
+                // If from_state is set, it must match the previous status
+                if (row.from_state && row.from_state !== event.previousStatusName) {
+                    continue;
+                }
+                // Emit rule_matched event for on_enter triggers
+                if (row.trigger === 'on_enter') {
+                    bus.emit('workflow_rule:matched', {
+                        ruleId: row.id,
+                        ticketId: event.ticketId,
+                        projectId: event.projectId,
+                        actionId: row.action_id,
+                        trigger: row.trigger,
+                        fromState: row.from_state,
+                        toState: row.to_state,
+                        timestamp: new Date(),
+                    });
+                }
+            }
+        }
+        catch {
+            // Rule evaluation errors are non-fatal
+        }
+    }
+}
+// =============================================================================
+// Singleton
+// =============================================================================
+let _evaluator;
+/**
+ * Initialize and start the workflow rule evaluator.
+ * Safe to call multiple times — subsequent calls are no-ops.
+ */
+export function initWorkflowRuleEvaluator(db) {
+    if (!_evaluator) {
+        _evaluator = new WorkflowRuleEvaluator(db);
+        _evaluator.start();
+    }
+    return _evaluator;
+}
+/**
+ * Stop the workflow rule evaluator (primarily for testing).
+ */
+export function stopWorkflowRuleEvaluator() {
+    if (_evaluator) {
+        _evaluator.stop();
+        _evaluator = undefined;
+    }
+}
+//# sourceMappingURL=rule-evaluator.js.map

package/dist/lib/work-lifecycle/rule-evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-evaluator.js","sourceRoot":"","sources":["../../../src/lib/work-lifecycle/rule-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAY7C,MAAM,OAAO,qBAAqB;IACxB,aAAa,GAAsB,EAAE,CAAA;IACrC,EAAE,CAAmB;IAE7B,YAAY,EAAqB;QAC/B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;IACd,CAAC;IAED;;OAEG;IACH,KAAK;QACH,MAAM,GAAG,GAAG,WAAW,EAAE,CAAA;QAEzB,IAAI,CAAC,aAAa,CAAC,IAAI,CACrB,GAAG,CAAC,EAAE,CAAC,uBAAuB,EAAE,CAAC,KAA+B,EAAE,EAAE;YAClE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QACtB,CAAC,CAAC,CACH,CAAA;IACH,CAAC;IAED;;OAEG;IACH,IAAI;QACF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvC,KAAK,EAAE,CAAA;QACT,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,EAAE,CAAA;IACzB,CAAC;IAED;;;OAGG;IACK,QAAQ,CAAC,KAA+B;QAC9C,IAAI,CAAC,KAAK,CAAC,aAAa;YAAE,OAAM;QAEhC,IAAI,CAAC;YACH,+DAA+D;YAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;wBACX,UAAU,CAAC,cAAc;;OAE1C,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAsB,CAAA;YAEhD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAM;YAE7B,MAAM,GAAG,GAAG,WAAW,EAAE,CAAA;YAEzB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,0DAA0D;gBAC1D,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,KAAK,KAAK,CAAC,kBAAkB,EAAE,CAAC;oBAClE,SAAQ;gBACV,CAAC;gBAED,gDAAgD;gBAChD,IAAI,GAAG,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;oBAC/B,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE;wBAChC,MAAM,EAAE,GAAG,CAAC,EAAE;wBACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,SAAS,EAAE,KAAK,CAAC,SAAS;wBAC1B,QAAQ,EAAE,GAAG,CAAC,SAAS;wBACvB,OAAO,EAAE,GAAG,CAAC,OAA8B;wBAC3C,SAAS,EAAE,GAAG,CAAC,UAAU;wBACzB,OAAO,EAAE,GAAG,CAAC,QAAQ;wBACrB,SAAS,EAAE,IAAI,IAAI,EAAE;qBACtB,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;CACF;AAED,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,IAAI,UAA6C,CAAA;AAEjD;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,EAAqB;IAC7D,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,UAAU,GAAG,IAAI,qBAAqB,CAAC,EAAE,CAAC,CAAA;QAC1C,UAAU,CAAC,KAAK,EAAE,CAAA;IACpB,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,IAAI,UAAU,EAAE,CAAC;QACf,UAAU,CAAC,IAAI,EAAE,CAAA;QACjB,UAAU,GAAG,SAAS,CAAA;IACxB,CAAC;AACH,CAAC"}