@proletariat/cli 0.3.95 → 0.3.97

package/dist/lib/work-lifecycle/transition.js

@@ -0,0 +1,124 @@
+/**
+ * Work Transition Helper
+ *
+ * Shared logic for intent-based ticket transitions used by all work commands.
+ * Each work command specifies a transition intent, and this module resolves
+ * it to the correct provider state and moves the ticket.
+ *
+ * This replaces the old pattern of hardcoding column names via
+ * getWorkColumnSetting() + findColumnByName() in each command.
+ *
+ * Transition is best-effort: if no mapping exists, the operation still runs.
+ */
+import { TransitionMapStore } from '../providers/transition-map.js';
+import { getWorkColumnSetting, findColumnByName } from './settings.js';
+/**
+ * Map from transition intents to the legacy WorkColumnType settings keys.
+ * Used as a fallback when no transition map exists.
+ */
+const INTENT_TO_COLUMN_TYPE = {
+    started: 'in_progress',
+    needs_review: 'review',
+    completed: 'done',
+    ready: 'planned',
+};
+/**
+ * Resolve an intent to a target column name on the board.
+ *
+ * Resolution order:
+ * 1. pmo_transition_map — explicit user-confirmed mappings
+ * 2. Legacy column settings (column_in_progress, column_review, column_done)
+ * 3. Built-in default column names
+ *
+ * This only resolves the name — it does not move the ticket.
+ */
+export function resolveIntentToColumn(db, intent, providerName, columnNames) {
+    // 1. Check pmo_transition_map
+    try {
+        const store = new TransitionMapStore(db);
+        const mappedName = store.resolveIntent(providerName, intent);
+        if (mappedName) {
+            const match = findColumnByName(columnNames, mappedName);
+            if (match)
+                return match;
+        }
+    }
+    catch {
+        // Table may not exist yet — fall through
+    }
+    // 2. Fall back to legacy column settings
+    const columnType = INTENT_TO_COLUMN_TYPE[intent];
+    if (columnType) {
+        const settingName = getWorkColumnSetting(db, columnType);
+        const match = findColumnByName(columnNames, settingName);
+        if (match)
+            return match;
+    }
+    return null;
+}
+/**
+ * Move a ticket based on a transition intent.
+ *
+ * This is the primary function work commands should call for transitions.
+ * It resolves the intent to a column name, moves the ticket in the local PMO,
+ * and optionally syncs to the external provider.
+ *
+ * @param opts.db - Database instance
+ * @param opts.storage - PMO storage instance
+ * @param opts.ticket - The ticket to move
+ * @param opts.intent - The transition intent
+ * @param opts.providerName - Provider name for transition map lookup
+ * @param opts.resolveProvider - Function to resolve the external ticket provider
+ * @param opts.log - Optional logging callback
+ * @returns TransitionResult
+ */
+export async function moveTicketByIntent(opts) {
+    const { db, storage, ticket, intent, providerName, resolveProvider, log } = opts;
+    if (!ticket.projectId) {
+        return { moved: false, message: 'Ticket has no project' };
+    }
+    const board = await storage.getProjectBoard(ticket.projectId);
+    const columnNames = board ? board.columns.map(col => col.name) : [];
+    const targetColumn = resolveIntentToColumn(db, intent, providerName, columnNames);
+    if (!targetColumn) {
+        return { moved: false, message: `No column found for intent '${intent}'` };
+    }
+    const previousColumn = ticket.statusName;
+    // Skip if already in target state
+    if (previousColumn && previousColumn.toLowerCase() === targetColumn.toLowerCase()) {
+        return { moved: false, targetColumn, previousColumn, message: 'Already in target state' };
+    }
+    // Move in local PMO
+    try {
+        await storage.moveTicket(ticket.projectId, ticket.id, targetColumn);
+    }
+    catch (error) {
+        return {
+            moved: false,
+            targetColumn,
+            previousColumn,
+            message: `Failed to move: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+    // Sync to external provider
+    if (resolveProvider) {
+        try {
+            const provider = await resolveProvider(ticket.id, ticket.projectId);
+            if (provider.name !== 'pmo') {
+                const result = await provider.moveTicket(ticket.id, targetColumn);
+                if (result.success && log) {
+                    log(`Synced to ${result.provider}: ${targetColumn}`);
+                }
+            }
+        }
+        catch {
+            // Non-fatal — don't block work commands for provider sync failures
+        }
+    }
+    return {
+        moved: true,
+        targetColumn,
+        previousColumn,
+    };
+}
+//# sourceMappingURL=transition.js.map

package/dist/lib/work-lifecycle/transition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition.js","sourceRoot":"","sources":["../../../src/lib/work-lifecycle/transition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAuB,MAAM,eAAe,CAAA;AAgB3F;;;GAGG;AACH,MAAM,qBAAqB,GAAsD;IAC/E,OAAO,EAAE,aAAa;IACtB,YAAY,EAAE,QAAQ;IACtB,SAAS,EAAE,MAAM;IACjB,KAAK,EAAE,SAAS;CACjB,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,EAAqB,EACrB,MAAwB,EACxB,YAAoB,EACpB,WAAqB;IAErB,8BAA8B;IAC9B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,kBAAkB,CAAC,EAAE,CAAC,CAAA;QACxC,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;QAC5D,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,KAAK,GAAG,gBAAgB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAA;YACvD,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAA;QACzB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yCAAyC;IAC3C,CAAC;IAED,yCAAyC;IACzC,MAAM,UAAU,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAA;IAChD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,WAAW,GAAG,oBAAoB,CAAC,EAAE,EAAE,UAAU,CAAC,CAAA;QACxD,MAAM,KAAK,GAAG,gBAAgB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;QACxD,IAAI,KAAK;YAAE,OAAO,KAAK,CAAA;IACzB,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAQxC;IACC,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;IAEhF,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAA;IAC3D,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAC7D,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAEnE,MAAM,YAAY,GAAG,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,CAAC,CAAA;IACjF,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,+BAA+B,MAAM,GAAG,EAAE,CAAA;IAC5E,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAA;IAExC,kCAAkC;IAClC,IAAI,cAAc,IAAI,cAAc,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC;QAClF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAA;IAC3F,CAAC;IAED,oBAAoB;IACpB,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,YAAY,CAAC,CAAA;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,YAAY;YACZ,cAAc;YACd,OAAO,EAAE,mBAAmB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SACrF,CAAA;IACH,CAAC;IAED,4BAA4B;IAC5B,IAAI,eAAe,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;YACnE,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,YAAY,CAAC,CAAA;gBACjE,IAAI,MAAM,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC;oBAC1B,GAAG,CAAC,aAAa,MAAM,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC,CAAA;gBACtD,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;QACrE,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,IAAI;QACX,YAAY;QACZ,cAAc;KACf,CAAA;AACH,CAAC"}