@proletariat/cli 0.3.95 → 0.3.97

package/dist/lib/sync/reconciler.js

@@ -0,0 +1,88 @@
+/**
+ * Board Sync Reconciler
+ *
+ * Core reconciliation logic that detects drift between GitHub PR state
+ * and ticket provider state, then produces corrective actions.
+ *
+ * Provider-agnostic: works with any ticket provider (Linear, PMO, etc.)
+ * and any git host that exposes PR info.
+ *
+ * Reconciliation rules:
+ * 1. Merged PR + ticket not Done → move to Done
+ * 2. Green CI + ticket In Progress → move to Review
+ * 3. Ticket In Progress + no active agent → flag as stale
+ * 4. Ticket In Review + PR closed (not merged) → move to Backlog
+ */
+// =============================================================================
+// Reconciler
+// =============================================================================
+/**
+ * Determine reconciliation actions for a single ticket.
+ */
+export function reconcileTicket(ctx) {
+    const { ticket, pr, checks, hasActiveExecution } = ctx;
+    const category = ticket.statusCategory;
+    // Rule 1: Merged PR + ticket not Done → move to Done
+    if (pr?.state === 'MERGED' && category !== 'completed' && category !== 'canceled') {
+        return {
+            type: 'move_to_done',
+            ticketId: ticket.id,
+            ticketTitle: ticket.title,
+            reason: `PR #${pr.number} is merged but ticket is still in ${ticket.statusName ?? category}`,
+            targetStatus: 'Done',
+        };
+    }
+    // Rule 4: Ticket in review + PR closed (not merged) → move to Backlog
+    // Check this before rule 2 since a closed PR should take precedence
+    if (pr?.state === 'CLOSED' && category === 'started' && isReviewStatus(ticket)) {
+        return {
+            type: 'move_to_backlog',
+            ticketId: ticket.id,
+            ticketTitle: ticket.title,
+            reason: `PR #${pr.number} was closed without merging`,
+            targetStatus: 'Backlog',
+        };
+    }
+    // Rule 2: Green CI + ticket In Progress → move to Review
+    if (pr?.state === 'OPEN' &&
+        !pr.isDraft &&
+        category === 'started' &&
+        !isReviewStatus(ticket) &&
+        checks.length > 0 &&
+        allChecksGreen(checks)) {
+        return {
+            type: 'move_to_review',
+            ticketId: ticket.id,
+            ticketTitle: ticket.title,
+            reason: `PR #${pr.number} has all CI checks passing`,
+            targetStatus: 'Review',
+        };
+    }
+    // Rule 3: Ticket In Progress + no active agent + no open PR → flag as stale
+    if (category === 'started' &&
+        !isReviewStatus(ticket) &&
+        !hasActiveExecution &&
+        (!pr || pr.state === 'CLOSED')) {
+        return {
+            type: 'flag_stale',
+            ticketId: ticket.id,
+            ticketTitle: ticket.title,
+            reason: 'No active agent and no open PR',
+        };
+    }
+    return null;
+}
+/**
+ * Check if all CI checks have passed.
+ */
+function allChecksGreen(checks) {
+    return checks.every(c => c.conclusion === 'SUCCESS' || c.conclusion === 'NEUTRAL' || c.conclusion === 'SKIPPED');
+}
+/**
+ * Check if a ticket is in a review-like status.
+ */
+function isReviewStatus(ticket) {
+    const name = (ticket.statusName ?? '').toLowerCase();
+    return name.includes('review') || name.includes('in review');
+}
+//# sourceMappingURL=reconciler.js.map

package/dist/lib/sync/reconciler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciler.js","sourceRoot":"","sources":["../../../src/lib/sync/reconciler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAqCH,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAqB;IACnD,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,GAAG,CAAA;IACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAA;IAEtC,qDAAqD;IACrD,IAAI,EAAE,EAAE,KAAK,KAAK,QAAQ,IAAI,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QAClF,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,WAAW,EAAE,MAAM,CAAC,KAAK;YACzB,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,qCAAqC,MAAM,CAAC,UAAU,IAAI,QAAQ,EAAE;YAC5F,YAAY,EAAE,MAAM;SACrB,CAAA;IACH,CAAC;IAED,sEAAsE;IACtE,oEAAoE;IACpE,IAAI,EAAE,EAAE,KAAK,KAAK,QAAQ,IAAI,QAAQ,KAAK,SAAS,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/E,OAAO;YACL,IAAI,EAAE,iBAAiB;YACvB,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,WAAW,EAAE,MAAM,CAAC,KAAK;YACzB,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,6BAA6B;YACrD,YAAY,EAAE,SAAS;SACxB,CAAA;IACH,CAAC;IAED,yDAAyD;IACzD,IACE,EAAE,EAAE,KAAK,KAAK,MAAM;QACpB,CAAC,EAAE,CAAC,OAAO;QACX,QAAQ,KAAK,SAAS;QACtB,CAAC,cAAc,CAAC,MAAM,CAAC;QACvB,MAAM,CAAC,MAAM,GAAG,CAAC;QACjB,cAAc,CAAC,MAAM,CAAC,EACtB,CAAC;QACD,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,WAAW,EAAE,MAAM,CAAC,KAAK;YACzB,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,4BAA4B;YACpD,YAAY,EAAE,QAAQ;SACvB,CAAA;IACH,CAAC;IAED,4EAA4E;IAC5E,IACE,QAAQ,KAAK,SAAS;QACtB,CAAC,cAAc,CAAC,MAAM,CAAC;QACvB,CAAC,kBAAkB;QACnB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,KAAK,QAAQ,CAAC,EAC9B,CAAC;QACD,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,WAAW,EAAE,MAAM,CAAC,KAAK;YACzB,MAAM,EAAE,gCAAgC;SACzC,CAAA;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,MAAiB;IACvC,OAAO,MAAM,CAAC,KAAK,CACjB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,CAC5F,CAAA;AACH,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,MAAc;IACpC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IACpD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;AAC9D,CAAC"}

package/dist/lib/utils/text.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Text and general-purpose utility functions.
+ */
+/**
+ * Convert a string to a URL-safe slug
+ */
+export declare function slugify(text: string): string;
+/**
+ * Format a date as ISO string (date only)
+ */
+export declare function formatDate(date: Date): string;
+/**
+ * Format a date as ISO timestamp
+ */
+export declare function formatTimestamp(date: Date): string;
+/**
+ * Parse an ISO date string
+ */
+export declare function parseDate(str: string): Date;
+/**
+ * Parsed entity ID components
+ */
+export interface ParsedEntityId {
+    entityType: string;
+    number: number;
+    raw: string;
+}
+/**
+ * Parse an entity ID into its components.
+ *
+ * Format: TKT-001 → { entityType: 'TKT', number: 1 }
+ *
+ * @param id - Entity ID to parse
+ * @returns Parsed components, or null if invalid format
+ */
+export declare function parseEntityId(id: string): ParsedEntityId | null;
+/**
+ * Deep clone an object
+ */
+export declare function deepClone<T>(obj: T): T;
+/**
+ * Check if two arrays have the same elements (order-independent)
+ */
+export declare function arraysEqual<T>(a: T[], b: T[]): boolean;

package/dist/lib/utils/text.js

@@ -0,0 +1,72 @@
+/**
+ * Text and general-purpose utility functions.
+ */
+/**
+ * Convert a string to a URL-safe slug
+ */
+export function slugify(text) {
+    return text
+        .toLowerCase()
+        .trim()
+        .replace(/[^\w\s-]/g, '') // Remove non-word chars (except spaces and hyphens)
+        .replace(/[\s_]+/g, '-') // Replace spaces and underscores with hyphens
+        .replace(/-+/g, '-') // Replace multiple hyphens with single hyphen
+        .replace(/^-+|-+$/g, '') // Remove leading/trailing hyphens
+        .substring(0, 100); // Limit length
+}
+/**
+ * Format a date as ISO string (date only)
+ */
+export function formatDate(date) {
+    return date.toISOString().split('T')[0];
+}
+/**
+ * Format a date as ISO timestamp
+ */
+export function formatTimestamp(date) {
+    return date.toISOString();
+}
+/**
+ * Parse an ISO date string
+ */
+export function parseDate(str) {
+    return new Date(str);
+}
+/**
+ * Parse an entity ID into its components.
+ *
+ * Format: TKT-001 → { entityType: 'TKT', number: 1 }
+ *
+ * @param id - Entity ID to parse
+ * @returns Parsed components, or null if invalid format
+ */
+export function parseEntityId(id) {
+    if (!id)
+        return null;
+    const match = id.match(/^([A-Z]+)-(\d+)$/);
+    if (match) {
+        return {
+            entityType: match[1],
+            number: parseInt(match[2], 10),
+            raw: id,
+        };
+    }
+    return null;
+}
+/**
+ * Deep clone an object
+ */
+export function deepClone(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}
+/**
+ * Check if two arrays have the same elements (order-independent)
+ */
+export function arraysEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    const sortedA = [...a].sort();
+    const sortedB = [...b].sort();
+    return sortedA.every((val, idx) => val === sortedB[idx]);
+}
+//# sourceMappingURL=text.js.map

package/dist/lib/utils/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/lib/utils/text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI;SACR,WAAW,EAAE;SACb,IAAI,EAAE;SACN,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,oDAAoD;SAC7E,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAG,8CAA8C;SACxE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAO,8CAA8C;SACxE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAG,kCAAkC;SAC5D,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA,CAAS,eAAe;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAU;IACxC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAA;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAA;AACtB,CAAC;AAWD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAErB,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC3C,IAAI,KAAK,EAAE,CAAC;QACV,OAAO;YACL,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;YACpB,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC9B,GAAG,EAAE,EAAE;SACR,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAI,GAAM;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAI,CAAM,EAAE,CAAM;IAC3C,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IACvC,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAC7B,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAC7B,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;AAC1D,CAAC"}

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

@@ -13,7 +13,7 @@
  * (Linear, Jira, etc.) — not through the local PMO as a cache layer.
  * The local PMO is just the default provider for users without integrations.
  */
-import { getWorkColumnSetting, findColumnByName, getReviewGateSetting } from '../pmo/utils.js';
+import { getWorkColumnSetting, findColumnByName, getReviewGateSetting } from './settings.js';
 import { resolveTicketProvider } from '../providers/resolver.js';
 import { tryValidateCommits } from '../execution/commit-validation.js';
 import { moveWithProvider } from '../providers/state-resolution.js';

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

@@ -1 +1 @@
-{"version":3,"file":"post-execution.js","sourceRoot":"","sources":["../../../src/lib/work-lifecycle/post-execution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAE9F,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAEhE,OAAO,EAAE,kBAAkB,EAA+B,MAAM,mCAAmC,CAAA;AACnG,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAmDnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,OAA6B,EAC7B,OAA+C,EAC/C,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,yCAAyC;IACzC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,oBAAoB,CAAC,EAAE,CAAC,CAAA;IAEjE,8DAA8D;IAC9D,qDAAqD;IACrD,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAA;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;QAC5C,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,yEAAyE;IACzE,kDAAkD;IAClD,IAAI,UAA8C,CAAA;IAClD,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,kBAAkB,CAC/B,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,aAAa,CACtB,CAAA;YACD,IAAI,MAAM,EAAE,CAAC;gBACX,UAAU,GAAG,MAAM,CAAA;gBACnB,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;oBACnB,OAAO;wBACL,YAAY,EAAE,KAAK;wBACnB,SAAS,EAAE,MAAM,CAAC,UAAU;wBAC5B,UAAU;wBACV,mBAAmB,EAAE,IAAI;wBACzB,UAAU;qBACX,CAAA;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,4DAA4D;YAC5D,yDAAyD;QAC3D,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,oDAAoD;IACpD,sDAAsD;IACtD,MAAM,MAAM,GAAG,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAA;IAExD,mDAAmD;IACnD,0EAA0E;IAC1E,oFAAoF;IACpF,MAAM,QAAQ,GAAG,qBAAqB,CACpC,OAAO,CAAC,QAAQ,EAChB,MAAM,CAAC,SAAS,EAChB,EAAE,EACF,OAA0B,EAC1B,MAAM,CAAC,QAAQ,CAChB,CAAA;IAED,wEAAwE;IACxE,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAA;IACvC,MAAM,UAAU,GAAG,MAAM,gBAAgB,CACvC,QAAQ,EACR,OAA0B,EAC1B,MAAM,CAAC,SAAS,EAChB,OAAO,CAAC,QAAQ,EAChB,MAAM,EACN,EAAE,EACF,MAAM,CAAC,UAAU,CAClB,CAAA;IAED,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,6DAA6D;QAC7D,IAAI,UAAU,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACzC,MAAM,gBAAgB,GAAG,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAA;YAClE,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAA;YACnE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;YAC7D,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;YAC5C,CAAC;YACD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACtD,MAAM,YAAY,GAAG,gBAAgB,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAA;YACpE,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,KAAK,YAAY,EAAE,CAAC;gBACxD,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;YAC5C,CAAC;YACD,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;YAC5E,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;gBACxB,OAAO;oBACL,YAAY,EAAE,KAAK;oBACnB,SAAS,EAAE,aAAa;oBACxB,OAAO,EAAE,YAAY;oBACrB,QAAQ,EAAE,UAAU,CAAC,QAAQ;oBAC7B,aAAa,EAAE,UAAU,CAAC,KAAK;oBAC/B,UAAU;oBACV,UAAU;iBACX,CAAA;YACH,CAAC;YACD,OAAO;gBACL,YAAY,EAAE,IAAI;gBAClB,SAAS,EAAE,aAAa;gBACxB,OAAO,EAAE,YAAY;gBACrB,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,UAAU;gBACV,UAAU;aACX,CAAA;QACH,CAAC;QAED,OAAO;YACL,YAAY,EAAE,KAAK;YACnB,SAAS,EAAE,aAAa;YACxB,OAAO,EAAE,UAAU,CAAC,SAAS;YAC7B,QAAQ,EAAE,QAAQ,CAAC,IAAI;YACvB,aAAa,EAAE,UAAU,CAAC,KAAK,IAAI,UAAU,CAAC,OAAO;YACrD,UAAU;YACV,UAAU;SACX,CAAA;IACH,CAAC;IAED,OAAO;QACL,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,aAAa;QACxB,OAAO,EAAE,UAAU,CAAC,SAAS;QAC7B,QAAQ,EAAE,QAAQ,CAAC,IAAI;QACvB,UAAU;QACV,UAAU;KACX,CAAA;AACH,CAAC"}
+{"version":3,"file":"post-execution.js","sourceRoot":"","sources":["../../../src/lib/work-lifecycle/post-execution.ts"],"names":[],"mappings":"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"}

package/dist/lib/work-lifecycle/settings.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Work lifecycle settings — column, priority, and review gate configuration.
+ */
+import type { ReviewGateMode } from '../pmo/types.js';
+/**
+ * Database interface for settings access (compatible with better-sqlite3)
+ */
+interface DatabaseLike {
+    prepare(sql: string): {
+        get(...params: unknown[]): unknown;
+        run(...params: unknown[]): unknown;
+    };
+}
+/**
+ * Default column names for work commands (Linear-style workflow)
+ *
+ * Linear-style: Backlog → Planned → In Progress → Review → Done
+ * - planned: Move tickets here when scheduled/assigned
+ * - in_progress: Move tickets here when work starts
+ * - review: Move tickets here when work is ready for review
+ * - done: Move tickets here when work is complete (reviewed/merged)
+ */
+export declare const DEFAULT_WORK_COLUMNS: {
+    readonly planned: "Planned";
+    readonly in_progress: "In Progress";
+    readonly review: "Review";
+    readonly done: "Done";
+};
+export type WorkColumnType = keyof typeof DEFAULT_WORK_COLUMNS;
+/**
+ * Get a work column setting from pmo_settings with fallback to default.
+ * Column matching is case-insensitive.
+ *
+ * Settings keys:
+ * - column_in_progress: Column to move tickets to when work starts
+ * - column_review: Column to move tickets to when work is ready for review
+ * - column_done: Column to move tickets to when work is complete
+ *
+ * @param db - Database instance
+ * @param columnType - Type of column (in_progress, review, done)
+ * @returns The configured column name, or the default if not set
+ */
+export declare function getWorkColumnSetting(db: DatabaseLike, columnType: WorkColumnType): string;
+/**
+ * Set a work column setting in pmo_settings.
+ *
+ * @param db - Database instance
+ * @param columnType - Type of column (in_progress, review, done)
+ * @param columnName - Name of the column to use
+ */
+export declare function setWorkColumnSetting(db: DatabaseLike, columnType: WorkColumnType, columnName: string): void;
+/**
+ * Find a column by configured name (case-insensitive match).
+ * Returns the actual column name from the board if found, null otherwise.
+ *
+ * @param columnNames - Array of column names from the board
+ * @param targetColumn - The column name to find (from settings or default)
+ * @returns The matching column name, or null if not found
+ */
+export declare function findColumnByName(columnNames: string[], targetColumn: string): string | null;
+/**
+ * Default priority scale (backwards compatible with hardcoded P0-P3).
+ */
+export declare const DEFAULT_PRIORITIES: readonly ["P0", "P1", "P2", "P3"];
+/**
+ * Get the workspace priority scale from pmo_settings.
+ * Returns the user-defined priority scale, or DEFAULT_PRIORITIES if not set.
+ *
+ * Priority values are ordered strings - position in array determines sort order.
+ * Index 0 is highest priority.
+ *
+ * @param db - Database instance
+ * @returns Array of priority strings ordered from highest to lowest
+ */
+export declare function getWorkspacePriorities(db: DatabaseLike): string[];
+/**
+ * Set the workspace priority scale in pmo_settings.
+ *
+ * @param db - Database instance
+ * @param priorities - Array of priority strings ordered from highest to lowest
+ */
+export declare function setWorkspacePriorities(db: DatabaseLike, priorities: string[]): void;
+/**
+ * Check if a value is a valid priority for the workspace.
+ *
+ * @param db - Database instance
+ * @param value - Value to check
+ * @returns true if the value is in the workspace priority scale
+ */
+export declare function isValidWorkspacePriority(db: DatabaseLike, value: string): boolean;
+/**
+ * Get the sort index for a priority value.
+ * Returns the position in the priority array (0 = highest priority).
+ * Returns Infinity for unknown priorities (sorts last).
+ *
+ * @param db - Database instance
+ * @param value - Priority value
+ * @returns Sort index (lower = higher priority)
+ */
+export declare function getPrioritySortIndex(db: DatabaseLike, value: string | undefined | null): number;
+/**
+ * Valid review gate modes.
+ */
+export declare const REVIEW_GATE_MODES: readonly ReviewGateMode[];
+/**
+ * Default review gate mode for workspace.
+ */
+export declare const DEFAULT_REVIEW_GATE: ReviewGateMode;
+/**
+ * Get the workspace review gate default from pmo_settings.
+ * Returns the configured mode, or 'required' if not set.
+ *
+ * @param db - Database instance
+ * @returns The configured review gate mode
+ */
+export declare function getReviewGateSetting(db: DatabaseLike): ReviewGateMode;
+/**
+ * Set the workspace review gate default in pmo_settings.
+ *
+ * @param db - Database instance
+ * @param mode - Review gate mode to set
+ */
+export declare function setReviewGateSetting(db: DatabaseLike, mode: ReviewGateMode): void;
+/**
+ * Check if a value is a valid review gate mode.
+ */
+export declare function isValidReviewGateMode(value: string): value is ReviewGateMode;
+/**
+ * Resolve the effective review gate mode given the hierarchy of overrides.
+ * Most specific wins: per-spawn > per-action > workspace default.
+ *
+ * @param spawnOverride - Value from --review-gate flag on `prlt work start`
+ * @param actionOverride - Value from the action's review_gate column
+ * @param db - Database instance for workspace default lookup
+ * @returns The resolved review gate mode
+ */
+export declare function resolveReviewGate(spawnOverride: ReviewGateMode | undefined, actionOverride: ReviewGateMode | undefined, db: DatabaseLike): ReviewGateMode;
+export {};

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

@@ -0,0 +1,213 @@
+/**
+ * Work lifecycle settings — column, priority, and review gate configuration.
+ */
+// =============================================================================
+// Work Column Settings
+// =============================================================================
+/**
+ * Default column names for work commands (Linear-style workflow)
+ *
+ * Linear-style: Backlog → Planned → In Progress → Review → Done
+ * - planned: Move tickets here when scheduled/assigned
+ * - in_progress: Move tickets here when work starts
+ * - review: Move tickets here when work is ready for review
+ * - done: Move tickets here when work is complete (reviewed/merged)
+ */
+export const DEFAULT_WORK_COLUMNS = {
+    planned: 'Planned',
+    in_progress: 'In Progress',
+    review: 'Review',
+    done: 'Done',
+};
+/**
+ * Get a work column setting from pmo_settings with fallback to default.
+ * Column matching is case-insensitive.
+ *
+ * Settings keys:
+ * - column_in_progress: Column to move tickets to when work starts
+ * - column_review: Column to move tickets to when work is ready for review
+ * - column_done: Column to move tickets to when work is complete
+ *
+ * @param db - Database instance
+ * @param columnType - Type of column (in_progress, review, done)
+ * @returns The configured column name, or the default if not set
+ */
+export function getWorkColumnSetting(db, columnType) {
+    const settingKey = `column_${columnType}`;
+    const row = db.prepare(`SELECT value FROM pmo_settings WHERE key = ?`).get(settingKey);
+    return row?.value || DEFAULT_WORK_COLUMNS[columnType];
+}
+/**
+ * Set a work column setting in pmo_settings.
+ *
+ * @param db - Database instance
+ * @param columnType - Type of column (in_progress, review, done)
+ * @param columnName - Name of the column to use
+ */
+export function setWorkColumnSetting(db, columnType, columnName) {
+    const settingKey = `column_${columnType}`;
+    db.prepare(`
+    INSERT INTO pmo_settings (key, value) VALUES (?, ?)
+    ON CONFLICT(key) DO UPDATE SET value = ?
+  `).run(settingKey, columnName, columnName);
+}
+/**
+ * Find a column by configured name (case-insensitive match).
+ * Returns the actual column name from the board if found, null otherwise.
+ *
+ * @param columnNames - Array of column names from the board
+ * @param targetColumn - The column name to find (from settings or default)
+ * @returns The matching column name, or null if not found
+ */
+export function findColumnByName(columnNames, targetColumn) {
+    const targetLower = targetColumn.toLowerCase();
+    // First try exact match (case-insensitive)
+    const exactMatch = columnNames.find(col => col.toLowerCase() === targetLower);
+    if (exactMatch)
+        return exactMatch;
+    // Then try partial match (contains)
+    const partialMatch = columnNames.find(col => col.toLowerCase().includes(targetLower) ||
+        targetLower.includes(col.toLowerCase()));
+    return partialMatch || null;
+}
+// =============================================================================
+// Workspace Priority Settings
+// =============================================================================
+/**
+ * Default priority scale (backwards compatible with hardcoded P0-P3).
+ */
+export const DEFAULT_PRIORITIES = ['P0', 'P1', 'P2', 'P3'];
+/**
+ * Settings key for storing workspace priorities.
+ */
+const PRIORITIES_SETTING_KEY = 'priorities';
+/**
+ * Get the workspace priority scale from pmo_settings.
+ * Returns the user-defined priority scale, or DEFAULT_PRIORITIES if not set.
+ *
+ * Priority values are ordered strings - position in array determines sort order.
+ * Index 0 is highest priority.
+ *
+ * @param db - Database instance
+ * @returns Array of priority strings ordered from highest to lowest
+ */
+export function getWorkspacePriorities(db) {
+    const row = db.prepare(`SELECT value FROM pmo_settings WHERE key = ?`).get(PRIORITIES_SETTING_KEY);
+    if (!row)
+        return [...DEFAULT_PRIORITIES];
+    try {
+        const parsed = JSON.parse(row.value);
+        if (Array.isArray(parsed) && parsed.length > 0 && parsed.every((p) => typeof p === 'string')) {
+            return parsed;
+        }
+        return [...DEFAULT_PRIORITIES];
+    }
+    catch {
+        return [...DEFAULT_PRIORITIES];
+    }
+}
+/**
+ * Set the workspace priority scale in pmo_settings.
+ *
+ * @param db - Database instance
+ * @param priorities - Array of priority strings ordered from highest to lowest
+ */
+export function setWorkspacePriorities(db, priorities) {
+    const value = JSON.stringify(priorities);
+    db.prepare(`
+    INSERT INTO pmo_settings (key, value) VALUES (?, ?)
+    ON CONFLICT(key) DO UPDATE SET value = ?
+  `).run(PRIORITIES_SETTING_KEY, value, value);
+}
+/**
+ * Check if a value is a valid priority for the workspace.
+ *
+ * @param db - Database instance
+ * @param value - Value to check
+ * @returns true if the value is in the workspace priority scale
+ */
+export function isValidWorkspacePriority(db, value) {
+    const priorities = getWorkspacePriorities(db);
+    return priorities.includes(value);
+}
+/**
+ * Get the sort index for a priority value.
+ * Returns the position in the priority array (0 = highest priority).
+ * Returns Infinity for unknown priorities (sorts last).
+ *
+ * @param db - Database instance
+ * @param value - Priority value
+ * @returns Sort index (lower = higher priority)
+ */
+export function getPrioritySortIndex(db, value) {
+    if (!value)
+        return Infinity;
+    const priorities = getWorkspacePriorities(db);
+    const index = priorities.indexOf(value);
+    return index !== -1 ? index : Infinity;
+}
+// =============================================================================
+// Review Gate Settings
+// =============================================================================
+/**
+ * Valid review gate modes.
+ */
+export const REVIEW_GATE_MODES = ['required', 'auto', 'post'];
+/**
+ * Default review gate mode for workspace.
+ */
+export const DEFAULT_REVIEW_GATE = 'required';
+/**
+ * Settings key for workspace-level review gate default.
+ */
+const REVIEW_GATE_SETTING_KEY = 'review_gate';
+/**
+ * Get the workspace review gate default from pmo_settings.
+ * Returns the configured mode, or 'required' if not set.
+ *
+ * @param db - Database instance
+ * @returns The configured review gate mode
+ */
+export function getReviewGateSetting(db) {
+    const row = db.prepare(`SELECT value FROM pmo_settings WHERE key = ?`).get(REVIEW_GATE_SETTING_KEY);
+    const value = row?.value;
+    if (value === 'required' || value === 'auto' || value === 'post') {
+        return value;
+    }
+    return DEFAULT_REVIEW_GATE;
+}
+/**
+ * Set the workspace review gate default in pmo_settings.
+ *
+ * @param db - Database instance
+ * @param mode - Review gate mode to set
+ */
+export function setReviewGateSetting(db, mode) {
+    db.prepare(`
+    INSERT INTO pmo_settings (key, value) VALUES (?, ?)
+    ON CONFLICT(key) DO UPDATE SET value = ?
+  `).run(REVIEW_GATE_SETTING_KEY, mode, mode);
+}
+/**
+ * Check if a value is a valid review gate mode.
+ */
+export function isValidReviewGateMode(value) {
+    return REVIEW_GATE_MODES.includes(value);
+}
+/**
+ * Resolve the effective review gate mode given the hierarchy of overrides.
+ * Most specific wins: per-spawn > per-action > workspace default.
+ *
+ * @param spawnOverride - Value from --review-gate flag on `prlt work start`
+ * @param actionOverride - Value from the action's review_gate column
+ * @param db - Database instance for workspace default lookup
+ * @returns The resolved review gate mode
+ */
+export function resolveReviewGate(spawnOverride, actionOverride, db) {
+    if (spawnOverride)
+        return spawnOverride;
+    if (actionOverride)
+        return actionOverride;
+    return getReviewGateSetting(db);
+}
+//# sourceMappingURL=settings.js.map

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

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

package/dist/lib/work-lifecycle/transition.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 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 type Database from 'better-sqlite3';
+/**
+ * Minimal ticket shape needed for intent-based transitions.
+ * Accepts both full Ticket objects and partial objects from batch spawn paths.
+ */
+export interface TransitionTicket {
+    id: string;
+    projectId?: string;
+    statusName?: string;
+}
+import type { ProviderStorage, TicketProvider } from '../providers/types.js';
+import type { TransitionIntent } from '../providers/state-intents.js';
+/**
+ * Result of attempting a ticket transition.
+ */
+export interface TransitionResult {
+    /** Whether the ticket was moved successfully */
+    moved: boolean;
+    /** The resolved target column name, if any */
+    targetColumn?: string;
+    /** The previous column name */
+    previousColumn?: string;
+    /** Human-readable explanation of what happened */
+    message?: string;
+}
+/**
+ * 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 declare function resolveIntentToColumn(db: Database.Database, intent: TransitionIntent, providerName: string, columnNames: string[]): string | 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 declare function moveTicketByIntent(opts: {
+    db: Database.Database;
+    storage: ProviderStorage;
+    ticket: TransitionTicket;
+    intent: TransitionIntent;
+    providerName: string;
+    resolveProvider?: (ticketId: string, projectId: string) => Promise<TicketProvider>;
+    log?: (msg: string) => void;
+}): Promise<TransitionResult>;