@proletariat/cli 0.3.95 → 0.3.96

package/dist/lib/sync/merge-queue.js

@@ -0,0 +1,321 @@
+/**
+ * Merge Queue
+ *
+ * Sequential rebase-test-merge pipeline for parallel agent PRs.
+ *
+ * With strict branch protection (PR must be up-to-date with main), parallel
+ * agent PRs create a rebase treadmill. The merge queue processes green PRs
+ * one at a time: rebase on main → wait for CI → merge if green → eject if red.
+ *
+ * State machine per cycle:
+ * 1. If paused → skip
+ * 2. If a PR is currently being processed (rebased, waiting for CI):
+ *    - CI green → merge, rebase siblings
+ *    - CI failed → eject (label + comment)
+ *    - CI pending → wait
+ * 3. If no current PR:
+ *    - Build queue: open, non-draft PRs with green CI, ordered by priority then age
+ *    - Pick first → rebase → set as current
+ *    - If rebase fails (conflicts) → eject, try next
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { listOpenPRs, getPRChecks, getPRByNumber, mergePR, } from '../pr/index.js';
+import { rebaseSiblingPRs } from '../shipping/rebase.js';
+import { GitHubProvider } from '../shipping/github.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const MERGE_QUEUE_STATE_FILE = 'merge-queue.json';
+const MAX_EJECTED_HISTORY = 10;
+const EJECTED_LABEL = 'merge-queue-ejected';
+const EJECTED_COMMENT_PREFIX = 'Merge queue ejected this PR:';
+const DEFAULT_PRIORITY = 3; // P3 — lowest
+// =============================================================================
+// State Management
+// =============================================================================
+export function getMergeQueueStatePath(hqPath) {
+    return path.join(hqPath, '.proletariat', MERGE_QUEUE_STATE_FILE);
+}
+export function getDefaultState() {
+    return {
+        paused: false,
+        pausedAt: null,
+        currentPR: null,
+        lastMergedPR: null,
+        lastCycleAt: null,
+        ejectedPRs: [],
+    };
+}
+export function getMergeQueueState(hqPath) {
+    const statePath = getMergeQueueStatePath(hqPath);
+    try {
+        const content = fs.readFileSync(statePath, 'utf-8');
+        return { ...getDefaultState(), ...JSON.parse(content) };
+    }
+    catch {
+        return getDefaultState();
+    }
+}
+export function saveMergeQueueState(hqPath, state) {
+    const statePath = getMergeQueueStatePath(hqPath);
+    fs.writeFileSync(statePath, JSON.stringify(state, null, 2));
+}
+// =============================================================================
+// Pause / Resume
+// =============================================================================
+export function isMergeQueuePaused(hqPath) {
+    return getMergeQueueState(hqPath).paused;
+}
+export function pauseMergeQueue(hqPath) {
+    const state = getMergeQueueState(hqPath);
+    state.paused = true;
+    state.pausedAt = new Date().toISOString();
+    saveMergeQueueState(hqPath, state);
+    return state;
+}
+export function resumeMergeQueue(hqPath) {
+    const state = getMergeQueueState(hqPath);
+    state.paused = false;
+    state.pausedAt = null;
+    saveMergeQueueState(hqPath, state);
+    return state;
+}
+// =============================================================================
+// Queue Building
+// =============================================================================
+/**
+ * Build the merge queue: open, non-draft PRs with all CI checks green,
+ * ordered by priority (P0 first) then by creation date (oldest first).
+ */
+export function buildMergeQueue(options, deps = { listOpenPRs, getPRChecks }) {
+    const { cwd, branchPriorities } = options;
+    const openPRs = deps.listOpenPRs(cwd);
+    const entries = [];
+    for (const pr of openPRs) {
+        // Skip drafts
+        if (pr.isDraft)
+            continue;
+        // Check CI
+        const checks = deps.getPRChecks(pr.number, cwd);
+        if (checks.length === 0)
+            continue; // No checks = not ready
+        if (!allChecksGreen(checks))
+            continue;
+        // Resolve priority from branch
+        const priority = branchPriorities?.get(pr.headBranch) ?? DEFAULT_PRIORITY;
+        const ticketId = extractTicketIdFromBranch(pr.headBranch);
+        entries.push({ pr, ticketId, priority });
+    }
+    // Sort: lower priority number first (P0 < P1 < P2 < P3), then oldest first
+    entries.sort((a, b) => {
+        if (a.priority !== b.priority)
+            return a.priority - b.priority;
+        return new Date(a.pr.createdAt).getTime() - new Date(b.pr.createdAt).getTime();
+    });
+    return entries;
+}
+// =============================================================================
+// Main Cycle
+// =============================================================================
+const _defaultProvider = new GitHubProvider();
+const defaultDeps = {
+    listOpenPRs,
+    getPRChecks,
+    getPRByNumber,
+    mergePR,
+    rebaseSiblingPRs,
+    updatePRBranch: (prNumber, cwd) => _defaultProvider.updatePRBranch(prNumber, cwd),
+    addLabel: (prNumber, label, cwd) => _defaultProvider.addLabel(prNumber, label, cwd),
+    addComment: (prNumber, body, cwd) => _defaultProvider.addComment(prNumber, body, cwd),
+};
+/**
+ * Run a single merge queue cycle.
+ *
+ * Called by the daemon on each interval. Handles the state machine:
+ * - If paused, returns immediately
+ * - If a PR is in progress (rebased, waiting CI), checks status
+ * - If no PR in progress, picks next from queue and rebases
+ */
+export function runMergeQueueCycle(options, deps = defaultDeps) {
+    const { hqPath, cwd, log, mergeMethod = 'squash', deleteBranch = true, branchPriorities, } = options;
+    const state = getMergeQueueState(hqPath);
+    state.lastCycleAt = new Date().toISOString();
+    // Step 1: Check if paused
+    if (state.paused) {
+        saveMergeQueueState(hqPath, state);
+        log?.('Merge queue is paused');
+        return { action: 'paused', queueSize: 0 };
+    }
+    // Step 2: If a PR is currently being processed, check its status
+    if (state.currentPR) {
+        const result = processCurrentPR(state, { cwd, log, mergeMethod, deleteBranch }, deps);
+        saveMergeQueueState(hqPath, state);
+        return result;
+    }
+    // Step 3: No current PR — build queue and pick next
+    const queue = buildMergeQueue({ cwd, branchPriorities }, deps);
+    log?.(`Merge queue: ${queue.length} eligible PR(s)`);
+    if (queue.length === 0) {
+        saveMergeQueueState(hqPath, state);
+        return { action: 'none', queueSize: 0 };
+    }
+    // Try to rebase the top PR — if conflicts, eject and try next
+    for (const entry of queue) {
+        const rebaseResult = deps.updatePRBranch(entry.pr.number, cwd);
+        if (rebaseResult.success) {
+            state.currentPR = {
+                prNumber: entry.pr.number,
+                headBranch: entry.pr.headBranch,
+                baseBranch: entry.pr.baseBranch,
+                ticketId: entry.ticketId,
+                priority: entry.priority,
+                rebasedAt: new Date().toISOString(),
+            };
+            log?.(`Rebased PR #${entry.pr.number} (${entry.pr.headBranch}) — waiting for CI`);
+            saveMergeQueueState(hqPath, state);
+            return { action: 'rebase_started', prNumber: entry.pr.number, queueSize: queue.length };
+        }
+        // Rebase failed — eject this PR
+        const reason = rebaseResult.hasConflicts
+            ? 'Merge conflicts during rebase'
+            : `Rebase failed: ${rebaseResult.error ?? 'unknown error'}`;
+        ejectPR(state, entry.pr.number, entry.pr.headBranch, reason, cwd, deps);
+        log?.(`Ejected PR #${entry.pr.number}: ${reason}`);
+    }
+    // All PRs in queue had conflicts
+    saveMergeQueueState(hqPath, state);
+    return { action: 'none', reason: 'All eligible PRs have conflicts', queueSize: queue.length };
+}
+// =============================================================================
+// Process Current PR
+// =============================================================================
+function processCurrentPR(state, options, deps) {
+    const { cwd, log, mergeMethod, deleteBranch } = options;
+    const current = state.currentPR;
+    const queueSize = 0; // We don't rebuild the queue when checking current
+    // Verify PR is still open
+    const prInfo = deps.getPRByNumber(current.prNumber, cwd);
+    if (!prInfo || prInfo.state !== 'OPEN') {
+        const reason = prInfo?.state === 'MERGED'
+            ? 'PR was merged externally'
+            : 'PR is no longer open';
+        log?.(`Current PR #${current.prNumber}: ${reason} — clearing`);
+        state.currentPR = null;
+        if (prInfo?.state === 'MERGED') {
+            state.lastMergedPR = {
+                prNumber: current.prNumber,
+                headBranch: current.headBranch,
+                mergedAt: new Date().toISOString(),
+            };
+        }
+        return { action: 'none', prNumber: current.prNumber, reason, queueSize };
+    }
+    // Check CI status
+    const checks = deps.getPRChecks(current.prNumber, cwd);
+    // No checks yet — still waiting
+    if (checks.length === 0) {
+        log?.(`PR #${current.prNumber}: no CI checks yet — waiting`);
+        return { action: 'waiting_ci', prNumber: current.prNumber, queueSize };
+    }
+    const failed = checks.filter(c => c.conclusion === 'FAILURE');
+    const pending = checks.filter(c => !c.conclusion || c.status === 'IN_PROGRESS' || c.status === 'QUEUED');
+    // CI still pending
+    if (pending.length > 0) {
+        log?.(`PR #${current.prNumber}: CI pending (${pending.length} check(s)) — waiting`);
+        return { action: 'waiting_ci', prNumber: current.prNumber, queueSize };
+    }
+    // CI failed — eject
+    if (failed.length > 0) {
+        const failedNames = failed.map(c => c.name).join(', ');
+        const reason = `CI failed after rebase: ${failedNames}`;
+        ejectPR(state, current.prNumber, current.headBranch, reason, cwd, deps);
+        state.currentPR = null;
+        log?.(`Ejected PR #${current.prNumber}: ${reason}`);
+        return { action: 'ejected', prNumber: current.prNumber, reason, queueSize };
+    }
+    // All CI green — merge!
+    log?.(`PR #${current.prNumber}: CI green — merging (${mergeMethod})`);
+    const mergeResult = deps.mergePR(current.prNumber, {
+        method: mergeMethod,
+        deleteBranch,
+        cwd,
+    });
+    if (!mergeResult.success) {
+        // Check if it was merged by someone else
+        const recheck = deps.getPRByNumber(current.prNumber, cwd);
+        if (recheck?.state === 'MERGED') {
+            log?.(`PR #${current.prNumber}: was merged externally`);
+            state.currentPR = null;
+            state.lastMergedPR = {
+                prNumber: current.prNumber,
+                headBranch: current.headBranch,
+                mergedAt: new Date().toISOString(),
+            };
+            return { action: 'merged', prNumber: current.prNumber, reason: 'Merged externally', queueSize };
+        }
+        const reason = `Merge failed: ${mergeResult.error}`;
+        ejectPR(state, current.prNumber, current.headBranch, reason, cwd, deps);
+        state.currentPR = null;
+        log?.(`Ejected PR #${current.prNumber}: ${reason}`);
+        return { action: 'ejected', prNumber: current.prNumber, reason, queueSize };
+    }
+    // Merge succeeded!
+    log?.(`Merged PR #${current.prNumber} (${current.headBranch})`);
+    state.currentPR = null;
+    state.lastMergedPR = {
+        prNumber: current.prNumber,
+        headBranch: current.headBranch,
+        mergedAt: new Date().toISOString(),
+    };
+    // Rebase sibling PRs
+    log?.('Rebasing sibling PRs...');
+    const siblingResult = deps.rebaseSiblingPRs({
+        excludePRNumber: current.prNumber,
+        cwd,
+        onProgress: log,
+        labelConflicts: true,
+        commentOnConflicts: true,
+    });
+    log?.(`Siblings: ${siblingResult.succeeded.length} rebased, ${siblingResult.failed.length} failed, ${siblingResult.skipped.length} skipped`);
+    return { action: 'merged', prNumber: current.prNumber, queueSize };
+}
+// =============================================================================
+// Eject PR
+// =============================================================================
+function ejectPR(state, prNumber, headBranch, reason, cwd, deps) {
+    // Record ejection
+    state.ejectedPRs.unshift({
+        prNumber,
+        headBranch,
+        reason,
+        ejectedAt: new Date().toISOString(),
+    });
+    // Keep only the last N ejected PRs
+    if (state.ejectedPRs.length > MAX_EJECTED_HISTORY) {
+        state.ejectedPRs = state.ejectedPRs.slice(0, MAX_EJECTED_HISTORY);
+    }
+    // Label and comment on the PR (best effort)
+    try {
+        deps.addLabel(prNumber, EJECTED_LABEL, cwd);
+        deps.addComment(prNumber, `${EJECTED_COMMENT_PREFIX} ${reason}`, cwd);
+    }
+    catch {
+        // Best effort — don't fail the cycle
+    }
+}
+// =============================================================================
+// Helpers
+// =============================================================================
+function allChecksGreen(checks) {
+    return checks.every(c => c.conclusion === 'SUCCESS' || c.conclusion === 'NEUTRAL' || c.conclusion === 'SKIPPED');
+}
+/**
+ * Extract a ticket ID from a branch name.
+ * Supports patterns like: PRLT-1173/feat/... or TKT-007/...
+ */
+function extractTicketIdFromBranch(branch) {
+    const match = branch.match(/^([A-Z]+-\d+)\//);
+    return match?.[1] ?? null;
+}
+//# sourceMappingURL=merge-queue.js.map

package/dist/lib/sync/merge-queue.js.map

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

package/dist/lib/sync/reconciler.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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
+ */
+import type { PRInfo, PRCheck } from '../pr/index.js';
+import type { Ticket } from '../pmo/types.js';
+export type ReconcileActionType = 'move_to_done' | 'move_to_review' | 'flag_stale' | 'move_to_backlog';
+export interface ReconcileAction {
+    type: ReconcileActionType;
+    ticketId: string;
+    ticketTitle: string;
+    reason: string;
+    /** Target status name to move to (for move actions) */
+    targetStatus?: string;
+}
+export interface ReconcileContext {
+    ticket: Ticket;
+    pr: PRInfo | null;
+    checks: PRCheck[];
+    hasActiveExecution: boolean;
+}
+export interface ReconcileResult {
+    actions: ReconcileAction[];
+    checked: number;
+    errors: Array<{
+        ticketId: string;
+        error: string;
+    }>;
+}
+/**
+ * Determine reconciliation actions for a single ticket.
+ */
+export declare function reconcileTicket(ctx: ReconcileContext): ReconcileAction | null;

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