steroids-api 0.2.7

package/dist/src/locking/section-lock.js

@@ -0,0 +1,196 @@
+/**
+ * Section locking for parallel work prevention
+ * Prevents multiple runners from working on tasks in the same section
+ */
+import { getSectionLock, isSectionLockExpired, tryInsertSectionLock, claimExpiredSectionLock, releaseSectionLock as releaseSectionLockQuery, forceReleaseSectionLock, } from './queries.js';
+// Default section lock timeout in minutes
+const DEFAULT_SECTION_TIMEOUT_MINUTES = 120;
+// ============ Lock Acquisition ============
+/**
+ * Acquire a section lock with atomic operations
+ *
+ * Flow:
+ * 1. Try INSERT (fails if lock exists)
+ * 2. If exists, check if we own it
+ * 3. If owned by another, check if expired
+ * 4. If expired, claim atomically
+ * 5. If not expired, return failure
+ */
+export function acquireSectionLock(db, sectionId, runnerId, timeoutMinutes = DEFAULT_SECTION_TIMEOUT_MINUTES) {
+    // Step 1: Try to insert new lock
+    if (tryInsertSectionLock(db, sectionId, runnerId, timeoutMinutes)) {
+        const lock = getSectionLock(db, sectionId);
+        return {
+            acquired: true,
+            lock: lock ?? undefined,
+            reason: 'acquired_new',
+        };
+    }
+    // Step 2: Lock exists, get current state
+    const existingLock = getSectionLock(db, sectionId);
+    if (!existingLock) {
+        // Race condition: lock was deleted between insert attempt and now
+        if (tryInsertSectionLock(db, sectionId, runnerId, timeoutMinutes)) {
+            const lock = getSectionLock(db, sectionId);
+            return {
+                acquired: true,
+                lock: lock ?? undefined,
+                reason: 'acquired_new',
+            };
+        }
+        const currentLock = getSectionLock(db, sectionId);
+        return createLockedError(sectionId, currentLock);
+    }
+    // Step 3: Check if we already own the lock
+    if (existingLock.runner_id === runnerId) {
+        return {
+            acquired: true,
+            lock: existingLock,
+            reason: 'already_owned',
+        };
+    }
+    // Step 4: Check if lock is expired
+    if (isSectionLockExpired(existingLock)) {
+        if (claimExpiredSectionLock(db, sectionId, runnerId, timeoutMinutes)) {
+            const lock = getSectionLock(db, sectionId);
+            return {
+                acquired: true,
+                lock: lock ?? undefined,
+                reason: 'claimed_expired',
+            };
+        }
+        // Another runner claimed it first
+        const currentLock = getSectionLock(db, sectionId);
+        return createLockedError(sectionId, currentLock);
+    }
+    // Step 5: Lock is held by another runner and not expired
+    return createLockedError(sectionId, existingLock);
+}
+/**
+ * Create a SECTION_LOCKED error response
+ */
+function createLockedError(sectionId, lock) {
+    return {
+        acquired: false,
+        error: {
+            code: 'SECTION_LOCKED',
+            message: 'Section is locked by another runner',
+            details: {
+                sectionId,
+                runnerId: lock?.runner_id,
+                expiresAt: lock?.expires_at,
+            },
+        },
+    };
+}
+// ============ Lock Release ============
+/**
+ * Release a section lock (only by owner)
+ */
+export function releaseSectionLock(db, sectionId, runnerId) {
+    const existingLock = getSectionLock(db, sectionId);
+    if (!existingLock) {
+        return {
+            released: false,
+            error: {
+                code: 'LOCK_NOT_FOUND',
+                message: 'Lock does not exist',
+                details: { sectionId },
+            },
+        };
+    }
+    if (existingLock.runner_id !== runnerId) {
+        return {
+            released: false,
+            error: {
+                code: 'PERMISSION_DENIED',
+                message: 'Cannot release lock owned by another runner',
+                details: {
+                    sectionId,
+                    runnerId: existingLock.runner_id,
+                    expiresAt: existingLock.expires_at,
+                },
+            },
+        };
+    }
+    releaseSectionLockQuery(db, sectionId, runnerId);
+    return { released: true };
+}
+/**
+ * Force release a section lock (admin operation)
+ */
+export function forceRelease(db, sectionId) {
+    const existed = forceReleaseSectionLock(db, sectionId);
+    if (!existed) {
+        return {
+            released: false,
+            error: {
+                code: 'LOCK_NOT_FOUND',
+                message: 'Lock does not exist',
+                details: { sectionId },
+            },
+        };
+    }
+    return { released: true };
+}
+// ============ Lock Manager ============
+/**
+ * Create a section lock manager for a specific section
+ */
+export function createSectionLockManager(db, sectionId, runnerId, timeoutMinutes = DEFAULT_SECTION_TIMEOUT_MINUTES) {
+    return {
+        acquire: () => acquireSectionLock(db, sectionId, runnerId, timeoutMinutes),
+        release: () => releaseSectionLock(db, sectionId, runnerId),
+        isHeld: () => {
+            const lock = getSectionLock(db, sectionId);
+            return lock !== null && lock.runner_id === runnerId && !isSectionLockExpired(lock);
+        },
+    };
+}
+// ============ Lock Status Check ============
+/**
+ * Check if a section is locked
+ */
+export function isSectionLocked(db, sectionId) {
+    const lock = getSectionLock(db, sectionId);
+    if (!lock)
+        return false;
+    return !isSectionLockExpired(lock);
+}
+/**
+ * Check if a section is locked by a specific runner
+ */
+export function isSectionLockedBy(db, sectionId, runnerId) {
+    const lock = getSectionLock(db, sectionId);
+    if (!lock)
+        return false;
+    return lock.runner_id === runnerId && !isSectionLockExpired(lock);
+}
+/**
+ * Get time until section lock expires (in milliseconds)
+ */
+export function getTimeUntilExpiry(db, sectionId) {
+    const lock = getSectionLock(db, sectionId);
+    if (!lock)
+        return null;
+    const expiresAt = new Date(lock.expires_at).getTime();
+    const remaining = expiresAt - Date.now();
+    return Math.max(0, remaining);
+}
+// ============ Helper Functions ============
+/**
+ * Check if any tasks in the section are in progress by another runner
+ * This can be used before acquiring a section lock
+ */
+export function getSectionLockHolder(db, sectionId) {
+    const lock = getSectionLock(db, sectionId);
+    if (!lock || isSectionLockExpired(lock)) {
+        return null;
+    }
+    return lock;
+}
+// ============ Constants Export ============
+export const SECTION_LOCK_CONSTANTS = {
+    DEFAULT_TIMEOUT_MINUTES: DEFAULT_SECTION_TIMEOUT_MINUTES,
+};
+//# sourceMappingURL=section-lock.js.map

package/dist/src/locking/section-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-lock.js","sourceRoot":"","sources":["../../../../src/locking/section-lock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,IAAI,uBAAuB,EAC7C,uBAAuB,GAExB,MAAM,cAAc,CAAC;AAEtB,0CAA0C;AAC1C,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAgC5C,6CAA6C;AAE7C;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,EAAqB,EACrB,SAAiB,EACjB,QAAgB,EAChB,iBAAyB,+BAA+B;IAExD,iCAAiC;IACjC,IAAI,oBAAoB,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAC3C,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,IAAI,IAAI,SAAS;YACvB,MAAM,EAAE,cAAc;SACvB,CAAC;IACJ,CAAC;IAED,yCAAyC;IACzC,MAAM,YAAY,GAAG,cAAc,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IACnD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,kEAAkE;QAClE,IAAI,oBAAoB,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YAC3C,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,IAAI,EAAE,IAAI,IAAI,SAAS;gBACvB,MAAM,EAAE,cAAc;aACvB,CAAC;QACJ,CAAC;QACD,MAAM,WAAW,GAAG,cAAc,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAClD,OAAO,iBAAiB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;IAED,2CAA2C;IAC3C,IAAI,YAAY,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,eAAe;SACxB,CAAC;IACJ,CAAC;IAED,mCAAmC;IACnC,IAAI,oBAAoB,CAAC,YAAY,CAAC,EAAE,CAAC;QACvC,IAAI,uBAAuB,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YAC3C,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,IAAI,EAAE,IAAI,IAAI,SAAS;gBACvB,MAAM,EAAE,iBAAiB;aAC1B,CAAC;QACJ,CAAC;QACD,kCAAkC;QAClC,MAAM,WAAW,GAAG,cAAc,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAClD,OAAO,iBAAiB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;IAED,yDAAyD;IACzD,OAAO,iBAAiB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CACxB,SAAiB,EACjB,IAAwB;IAExB,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,KAAK,EAAE;YACL,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,qCAAqC;YAC9C,OAAO,EAAE;gBACP,SAAS;gBACT,QAAQ,EAAE,IAAI,EAAE,SAAS;gBACzB,SAAS,EAAE,IAAI,EAAE,UAAU;aAC5B;SACF;KACF,CAAC;AACJ,CAAC;AAED,yCAAyC;AAEzC;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,EAAqB,EACrB,SAAiB,EACjB,QAAgB;IAEhB,MAAM,YAAY,GAAG,cAAc,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAEnD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE;gBACL,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,qBAAqB;gBAC9B,OAAO,EAAE,EAAE,SAAS,EAAE;aACvB;SACF,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE;gBACL,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,6CAA6C;gBACtD,OAAO,EAAE;oBACP,SAAS;oBACT,QAAQ,EAAE,YAAY,CAAC,SAAS;oBAChC,SAAS,EAAE,YAAY,CAAC,UAAU;iBACnC;aACF;SACF,CAAC;IACJ,CAAC;IAED,uBAAuB,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACjD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,EAAqB,EACrB,SAAiB;IAEjB,MAAM,OAAO,GAAG,uBAAuB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAEvD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE;gBACL,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,qBAAqB;gBAC9B,OAAO,EAAE,EAAE,SAAS,EAAE;aACvB;SACF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,yCAAyC;AAEzC;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,EAAqB,EACrB,SAAiB,EACjB,QAAgB,EAChB,iBAAyB,+BAA+B;IAExD,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,CAAC;QAC1E,OAAO,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC;QAC1D,MAAM,EAAE,GAAG,EAAE;YACX,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YAC3C,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACrF,CAAC;KACF,CAAC;AACJ,CAAC;AAED,8CAA8C;AAE9C;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,EAAqB,EACrB,SAAiB;IAEjB,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,EAAqB,EACrB,SAAiB,EACjB,QAAgB;IAEhB,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,EAAqB,EACrB,SAAiB;IAEjB,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;IACtD,MAAM,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AAChC,CAAC;AAED,6CAA6C;AAE7C;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,EAAqB,EACrB,SAAiB;IAEjB,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6CAA6C;AAE7C,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,uBAAuB,EAAE,+BAA+B;CAChD,CAAC"}

package/dist/src/locking/task-lock.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Task locking with atomic operations
+ * Prevents multiple runners from working on the same task
+ */
+import type Database from 'better-sqlite3';
+import { type TaskLock } from './queries.js';
+export interface LockAcquisitionResult {
+    acquired: boolean;
+    lock?: TaskLock;
+    reason?: 'already_owned' | 'acquired_new' | 'claimed_expired';
+    error?: LockError;
+}
+export interface LockError {
+    code: 'TASK_LOCKED' | 'LOCK_NOT_FOUND' | 'PERMISSION_DENIED';
+    message: string;
+    details?: {
+        taskId: string;
+        runnerId?: string;
+        expiresAt?: string;
+    };
+}
+export interface LockReleaseResult {
+    released: boolean;
+    error?: LockError;
+}
+export interface TaskLockManager {
+    acquire: () => LockAcquisitionResult;
+    release: () => LockReleaseResult;
+    heartbeat: () => boolean;
+    extend: (additionalMinutes?: number) => boolean;
+    isHeld: () => boolean;
+}
+/**
+ * Acquire a task lock with atomic operations
+ *
+ * Flow:
+ * 1. Try INSERT (fails if lock exists)
+ * 2. If exists, check if we own it
+ * 3. If owned by another, check if expired
+ * 4. If expired, claim atomically
+ * 5. If not expired, return failure
+ */
+export declare function acquireTaskLock(db: Database.Database, taskId: string, runnerId: string, timeoutMinutes?: number): LockAcquisitionResult;
+/**
+ * Release a task lock (only by owner)
+ */
+export declare function releaseTaskLock(db: Database.Database, taskId: string, runnerId: string): LockReleaseResult;
+/**
+ * Force release a task lock (admin operation, ignores owner)
+ */
+export declare function forceRelease(db: Database.Database, taskId: string): LockReleaseResult;
+/**
+ * Update heartbeat for a task lock
+ * Should be called periodically while holding the lock
+ */
+export declare function heartbeat(db: Database.Database, taskId: string, runnerId: string): boolean;
+/**
+ * Extend a task lock's expiry time
+ */
+export declare function extend(db: Database.Database, taskId: string, runnerId: string, additionalMinutes?: number): boolean;
+/**
+ * Create a task lock manager for a specific task
+ * Provides a convenient interface for managing a single lock
+ */
+export declare function createTaskLockManager(db: Database.Database, taskId: string, runnerId: string, timeoutMinutes?: number): TaskLockManager;
+export interface HeartbeatHandle {
+    start: () => void;
+    stop: () => void;
+}
+/**
+ * Create an automatic heartbeat manager that updates
+ * the lock heartbeat at regular intervals
+ */
+export declare function createHeartbeatLoop(db: Database.Database, taskId: string, runnerId: string, intervalMs?: number): HeartbeatHandle;
+/**
+ * Check if a task is locked
+ */
+export declare function isTaskLocked(db: Database.Database, taskId: string): boolean;
+/**
+ * Check if a task is locked by a specific runner
+ */
+export declare function isTaskLockedBy(db: Database.Database, taskId: string, runnerId: string): boolean;
+/**
+ * Get time until lock expires (in milliseconds)
+ * Returns null if not locked, 0 if already expired
+ */
+export declare function getTimeUntilExpiry(db: Database.Database, taskId: string): number | null;
+export declare const LOCK_CONSTANTS: {
+    readonly DEFAULT_TIMEOUT_MINUTES: 60;
+    readonly HEARTBEAT_INTERVAL_MS: number;
+};
+//# sourceMappingURL=task-lock.d.ts.map

package/dist/src/locking/task-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-lock.d.ts","sourceRoot":"","sources":["../../../../src/locking/task-lock.ts"],"names":[],"mappings":"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"}

package/dist/src/locking/task-lock.js

@@ -0,0 +1,233 @@
+/**
+ * Task locking with atomic operations
+ * Prevents multiple runners from working on the same task
+ */
+import { getTaskLock, isTaskLockExpired, tryInsertTaskLock, claimExpiredTaskLock, releaseTaskLock as releaseTaskLockQuery, forceReleaseTaskLock, updateTaskLockHeartbeat, extendTaskLock, } from './queries.js';
+// Default lock timeout in minutes
+const DEFAULT_LOCK_TIMEOUT_MINUTES = 60;
+const HEARTBEAT_INTERVAL_MS = 30 * 1000; // 30 seconds
+// ============ Lock Acquisition ============
+/**
+ * Acquire a task lock with atomic operations
+ *
+ * Flow:
+ * 1. Try INSERT (fails if lock exists)
+ * 2. If exists, check if we own it
+ * 3. If owned by another, check if expired
+ * 4. If expired, claim atomically
+ * 5. If not expired, return failure
+ */
+export function acquireTaskLock(db, taskId, runnerId, timeoutMinutes = DEFAULT_LOCK_TIMEOUT_MINUTES) {
+    // Step 1: Try to insert new lock
+    if (tryInsertTaskLock(db, taskId, runnerId, timeoutMinutes)) {
+        const lock = getTaskLock(db, taskId);
+        return {
+            acquired: true,
+            lock: lock ?? undefined,
+            reason: 'acquired_new',
+        };
+    }
+    // Step 2: Lock exists, get current state
+    const existingLock = getTaskLock(db, taskId);
+    if (!existingLock) {
+        // Race condition: lock was deleted between insert attempt and now
+        // Try to acquire again
+        if (tryInsertTaskLock(db, taskId, runnerId, timeoutMinutes)) {
+            const lock = getTaskLock(db, taskId);
+            return {
+                acquired: true,
+                lock: lock ?? undefined,
+                reason: 'acquired_new',
+            };
+        }
+        // Still failed, get the current lock
+        const currentLock = getTaskLock(db, taskId);
+        return createLockedError(taskId, currentLock);
+    }
+    // Step 3: Check if we already own the lock
+    if (existingLock.runner_id === runnerId) {
+        // Refresh the lock expiry
+        extendTaskLock(db, taskId, runnerId, timeoutMinutes);
+        const updatedLock = getTaskLock(db, taskId);
+        return {
+            acquired: true,
+            lock: updatedLock ?? undefined,
+            reason: 'already_owned',
+        };
+    }
+    // Step 4: Check if lock is expired
+    if (isTaskLockExpired(existingLock)) {
+        // Try to claim the expired lock atomically
+        if (claimExpiredTaskLock(db, taskId, runnerId, timeoutMinutes)) {
+            const lock = getTaskLock(db, taskId);
+            return {
+                acquired: true,
+                lock: lock ?? undefined,
+                reason: 'claimed_expired',
+            };
+        }
+        // Another runner claimed it first
+        const currentLock = getTaskLock(db, taskId);
+        return createLockedError(taskId, currentLock);
+    }
+    // Step 5: Lock is held by another runner and not expired
+    return createLockedError(taskId, existingLock);
+}
+/**
+ * Create a TASK_LOCKED error response
+ */
+function createLockedError(taskId, lock) {
+    return {
+        acquired: false,
+        error: {
+            code: 'TASK_LOCKED',
+            message: 'Task is locked by another runner',
+            details: {
+                taskId,
+                runnerId: lock?.runner_id,
+                expiresAt: lock?.expires_at,
+            },
+        },
+    };
+}
+// ============ Lock Release ============
+/**
+ * Release a task lock (only by owner)
+ */
+export function releaseTaskLock(db, taskId, runnerId) {
+    const existingLock = getTaskLock(db, taskId);
+    if (!existingLock) {
+        return {
+            released: false,
+            error: {
+                code: 'LOCK_NOT_FOUND',
+                message: 'Lock does not exist',
+                details: { taskId },
+            },
+        };
+    }
+    if (existingLock.runner_id !== runnerId) {
+        return {
+            released: false,
+            error: {
+                code: 'PERMISSION_DENIED',
+                message: 'Cannot release lock owned by another runner',
+                details: {
+                    taskId,
+                    runnerId: existingLock.runner_id,
+                    expiresAt: existingLock.expires_at,
+                },
+            },
+        };
+    }
+    releaseTaskLockQuery(db, taskId, runnerId);
+    return { released: true };
+}
+/**
+ * Force release a task lock (admin operation, ignores owner)
+ */
+export function forceRelease(db, taskId) {
+    const existed = forceReleaseTaskLock(db, taskId);
+    if (!existed) {
+        return {
+            released: false,
+            error: {
+                code: 'LOCK_NOT_FOUND',
+                message: 'Lock does not exist',
+                details: { taskId },
+            },
+        };
+    }
+    return { released: true };
+}
+// ============ Lock Heartbeat ============
+/**
+ * Update heartbeat for a task lock
+ * Should be called periodically while holding the lock
+ */
+export function heartbeat(db, taskId, runnerId) {
+    return updateTaskLockHeartbeat(db, taskId, runnerId);
+}
+/**
+ * Extend a task lock's expiry time
+ */
+export function extend(db, taskId, runnerId, additionalMinutes = DEFAULT_LOCK_TIMEOUT_MINUTES) {
+    return extendTaskLock(db, taskId, runnerId, additionalMinutes);
+}
+// ============ Lock Manager ============
+/**
+ * Create a task lock manager for a specific task
+ * Provides a convenient interface for managing a single lock
+ */
+export function createTaskLockManager(db, taskId, runnerId, timeoutMinutes = DEFAULT_LOCK_TIMEOUT_MINUTES) {
+    return {
+        acquire: () => acquireTaskLock(db, taskId, runnerId, timeoutMinutes),
+        release: () => releaseTaskLock(db, taskId, runnerId),
+        heartbeat: () => updateTaskLockHeartbeat(db, taskId, runnerId),
+        extend: (additionalMinutes = timeoutMinutes) => extendTaskLock(db, taskId, runnerId, additionalMinutes),
+        isHeld: () => {
+            const lock = getTaskLock(db, taskId);
+            return lock !== null && lock.runner_id === runnerId && !isTaskLockExpired(lock);
+        },
+    };
+}
+/**
+ * Create an automatic heartbeat manager that updates
+ * the lock heartbeat at regular intervals
+ */
+export function createHeartbeatLoop(db, taskId, runnerId, intervalMs = HEARTBEAT_INTERVAL_MS) {
+    let intervalId = null;
+    const beat = () => {
+        updateTaskLockHeartbeat(db, taskId, runnerId);
+    };
+    const start = () => {
+        if (intervalId)
+            return; // Already running
+        beat(); // Immediate first beat
+        intervalId = setInterval(beat, intervalMs);
+    };
+    const stop = () => {
+        if (intervalId) {
+            clearInterval(intervalId);
+            intervalId = null;
+        }
+    };
+    return { start, stop };
+}
+// ============ Lock Status Check ============
+/**
+ * Check if a task is locked
+ */
+export function isTaskLocked(db, taskId) {
+    const lock = getTaskLock(db, taskId);
+    if (!lock)
+        return false;
+    return !isTaskLockExpired(lock);
+}
+/**
+ * Check if a task is locked by a specific runner
+ */
+export function isTaskLockedBy(db, taskId, runnerId) {
+    const lock = getTaskLock(db, taskId);
+    if (!lock)
+        return false;
+    return lock.runner_id === runnerId && !isTaskLockExpired(lock);
+}
+/**
+ * Get time until lock expires (in milliseconds)
+ * Returns null if not locked, 0 if already expired
+ */
+export function getTimeUntilExpiry(db, taskId) {
+    const lock = getTaskLock(db, taskId);
+    if (!lock)
+        return null;
+    const expiresAt = new Date(lock.expires_at).getTime();
+    const remaining = expiresAt - Date.now();
+    return Math.max(0, remaining);
+}
+// ============ Constants Export ============
+export const LOCK_CONSTANTS = {
+    DEFAULT_TIMEOUT_MINUTES: DEFAULT_LOCK_TIMEOUT_MINUTES,
+    HEARTBEAT_INTERVAL_MS,
+};
+//# sourceMappingURL=task-lock.js.map

package/dist/src/locking/task-lock.js.map

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

package/dist/src/migrations/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Migration system exports
+ * Re-exports all migration-related functionality
+ */
+export { MigrationEntry, MigrationManifest, AppliedMigration, getBundledManifestPath, getMigrationFilePath, getCachedManifestPath, readBundledManifest, readCachedManifest, cacheManifest, parseManifest, validateManifest, calculateChecksum, verifyChecksum, findPendingMigrations, findOrphanedMigrations, getMigrationById, getCliSupportedVersions, } from './manifest.js';
+export { MigrationResult, MigrationStatus, parseMigrationFile, readMigrationFile, getAppliedMigrations, getDatabaseVersion, createBackup, applyMigration, rollbackMigration, runMigrations, rollbackToVersion, getMigrationStatus, autoMigrate, } from './runner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/src/migrations/index.js

@@ -0,0 +1,9 @@
+/**
+ * Migration system exports
+ * Re-exports all migration-related functionality
+ */
+// Manifest management
+export { getBundledManifestPath, getMigrationFilePath, getCachedManifestPath, readBundledManifest, readCachedManifest, cacheManifest, parseManifest, validateManifest, calculateChecksum, verifyChecksum, findPendingMigrations, findOrphanedMigrations, getMigrationById, getCliSupportedVersions, } from './manifest.js';
+// Migration runner
+export { parseMigrationFile, readMigrationFile, getAppliedMigrations, getDatabaseVersion, createBackup, applyMigration, rollbackMigration, runMigrations, rollbackToVersion, getMigrationStatus, autoMigrate, } from './runner.js';
+//# sourceMappingURL=index.js.map

package/dist/src/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sBAAsB;AACtB,OAAO,EAIL,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAEvB,mBAAmB;AACnB,OAAO,EAGL,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/src/migrations/manifest.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Migration manifest management
+ * Handles reading, parsing, and validating the migration manifest
+ */
+/**
+ * Single migration entry in the manifest
+ */
+export interface MigrationEntry {
+    id: number;
+    name: string;
+    file: string;
+    description: string;
+    checksum: string;
+    cliVersion: string;
+}
+/**
+ * Migration manifest structure
+ */
+export interface MigrationManifest {
+    version: string;
+    latestDbVersion: number;
+    migrations: MigrationEntry[];
+}
+/**
+ * Applied migration record from database
+ */
+export interface AppliedMigration {
+    id: number;
+    name: string;
+    checksum: string;
+    applied_at: string;
+}
+/**
+ * Get the path to the bundled manifest (in the package)
+ */
+export declare function getBundledManifestPath(): string;
+/**
+ * Get the path to a migration file (in the package)
+ */
+export declare function getMigrationFilePath(filename: string): string;
+/**
+ * Get the path to the cached manifest
+ */
+export declare function getCachedManifestPath(): string;
+/**
+ * Read the bundled manifest from the package
+ */
+export declare function readBundledManifest(): MigrationManifest;
+/**
+ * Read the cached manifest if it exists and is valid
+ */
+export declare function readCachedManifest(): MigrationManifest | null;
+/**
+ * Save manifest to cache
+ */
+export declare function cacheManifest(manifest: MigrationManifest): void;
+/**
+ * Parse and validate manifest content
+ */
+export declare function parseManifest(content: string): MigrationManifest;
+/**
+ * Validate manifest structure
+ */
+export declare function validateManifest(manifest: MigrationManifest): void;
+/**
+ * Calculate SHA256 checksum for migration file content
+ */
+export declare function calculateChecksum(content: string): string;
+/**
+ * Verify checksum matches
+ */
+export declare function verifyChecksum(content: string, expectedChecksum: string): boolean;
+/**
+ * Find pending migrations that need to be applied
+ */
+export declare function findPendingMigrations(manifest: MigrationManifest, appliedMigrations: AppliedMigration[]): MigrationEntry[];
+/**
+ * Find migrations to rollback (applied but not in manifest)
+ */
+export declare function findOrphanedMigrations(manifest: MigrationManifest, appliedMigrations: AppliedMigration[]): AppliedMigration[];
+/**
+ * Get migration entry by ID
+ */
+export declare function getMigrationById(manifest: MigrationManifest, id: number): MigrationEntry | null;
+/**
+ * Get the current supported database version range for this CLI
+ */
+export declare function getCliSupportedVersions(manifest: MigrationManifest): {
+    min: number;
+    max: number;
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/src/migrations/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../../src/migrations/manifest.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8EH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAeD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAG/C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,iBAAiB,CASvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,GAAG,IAAI,CAkB7D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAc/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAIhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAmClE;AA6BD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAQjF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,EAC3B,iBAAiB,EAAE,gBAAgB,EAAE,GACpC,cAAc,EAAE,CAGlB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,iBAAiB,EAC3B,iBAAiB,EAAE,gBAAgB,EAAE,GACpC,gBAAgB,EAAE,CAGpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAE/F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CASjG"}