steroids-cli 0.4.47

package/dist/locking/queries.js

@@ -0,0 +1,255 @@
+"use strict";
+/**
+ * Database queries for task and section lock management
+ * All lock operations are atomic using SQLite transactions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTaskLock = getTaskLock;
+exports.isTaskLockExpired = isTaskLockExpired;
+exports.getTaskLockInfo = getTaskLockInfo;
+exports.tryInsertTaskLock = tryInsertTaskLock;
+exports.claimExpiredTaskLock = claimExpiredTaskLock;
+exports.releaseTaskLock = releaseTaskLock;
+exports.forceReleaseTaskLock = forceReleaseTaskLock;
+exports.updateTaskLockHeartbeat = updateTaskLockHeartbeat;
+exports.extendTaskLock = extendTaskLock;
+exports.listTaskLocks = listTaskLocks;
+exports.findExpiredTaskLocks = findExpiredTaskLocks;
+exports.cleanupExpiredTaskLocks = cleanupExpiredTaskLocks;
+exports.getSectionLock = getSectionLock;
+exports.isSectionLockExpired = isSectionLockExpired;
+exports.tryInsertSectionLock = tryInsertSectionLock;
+exports.claimExpiredSectionLock = claimExpiredSectionLock;
+exports.releaseSectionLock = releaseSectionLock;
+exports.forceReleaseSectionLock = forceReleaseSectionLock;
+exports.listSectionLocks = listSectionLocks;
+exports.findExpiredSectionLocks = findExpiredSectionLocks;
+exports.cleanupExpiredSectionLocks = cleanupExpiredSectionLocks;
+// ============ Task Lock Queries ============
+/**
+ * Get task lock by task ID
+ */
+function getTaskLock(db, taskId) {
+    return db
+        .prepare('SELECT * FROM task_locks WHERE task_id = ?')
+        .get(taskId);
+}
+/**
+ * Check if a task lock is expired
+ */
+function isTaskLockExpired(lock) {
+    const expiresAt = new Date(lock.expires_at).getTime();
+    return Date.now() > expiresAt;
+}
+/**
+ * Get task lock info with ownership and expiry status
+ */
+function getTaskLockInfo(db, taskId, runnerId) {
+    const lock = getTaskLock(db, taskId);
+    if (!lock) {
+        return {
+            isLocked: false,
+            lock: null,
+            isExpired: false,
+            isOwnedByUs: false,
+        };
+    }
+    const isExpired = isTaskLockExpired(lock);
+    const isOwnedByUs = lock.runner_id === runnerId;
+    return {
+        isLocked: !isExpired,
+        lock,
+        isExpired,
+        isOwnedByUs,
+    };
+}
+/**
+ * Try to insert a new task lock (atomic)
+ * Returns true if lock was acquired, false if already exists
+ */
+function tryInsertTaskLock(db, taskId, runnerId, timeoutMinutes) {
+    const expiresAt = new Date(Date.now() + timeoutMinutes * 60 * 1000).toISOString();
+    try {
+        db.prepare(`INSERT INTO task_locks (task_id, runner_id, expires_at)
+       VALUES (?, ?, ?)`).run(taskId, runnerId, expiresAt);
+        return true;
+    }
+    catch (err) {
+        // IntegrityError means lock already exists
+        if (err instanceof Error && err.message.includes('UNIQUE constraint')) {
+            return false;
+        }
+        throw err;
+    }
+}
+/**
+ * Claim an expired lock atomically
+ * Only succeeds if the lock is actually expired at execution time
+ */
+function claimExpiredTaskLock(db, taskId, runnerId, timeoutMinutes) {
+    const expiresAt = new Date(Date.now() + timeoutMinutes * 60 * 1000).toISOString();
+    const result = db.prepare(`UPDATE task_locks
+     SET runner_id = ?,
+         acquired_at = datetime('now'),
+         expires_at = ?,
+         heartbeat_at = datetime('now')
+     WHERE task_id = ?
+       AND expires_at < datetime('now')`).run(runnerId, expiresAt, taskId);
+    return result.changes > 0;
+}
+/**
+ * Release a task lock (only if owned by the specified runner)
+ * Returns true if lock was released, false if not owned
+ */
+function releaseTaskLock(db, taskId, runnerId) {
+    const result = db.prepare(`DELETE FROM task_locks
+     WHERE task_id = ?
+       AND runner_id = ?`).run(taskId, runnerId);
+    return result.changes > 0;
+}
+/**
+ * Force release a task lock (admin operation)
+ * Returns true if lock was released
+ */
+function forceReleaseTaskLock(db, taskId) {
+    const result = db.prepare(`DELETE FROM task_locks WHERE task_id = ?`).run(taskId);
+    return result.changes > 0;
+}
+/**
+ * Update heartbeat for a task lock
+ * Returns true if heartbeat was updated, false if lock not found or not owned
+ */
+function updateTaskLockHeartbeat(db, taskId, runnerId) {
+    const result = db.prepare(`UPDATE task_locks
+     SET heartbeat_at = datetime('now')
+     WHERE task_id = ?
+       AND runner_id = ?`).run(taskId, runnerId);
+    return result.changes > 0;
+}
+/**
+ * Extend a task lock's expiry time
+ * Returns true if extended, false if lock not found or not owned
+ */
+function extendTaskLock(db, taskId, runnerId, additionalMinutes) {
+    const newExpiresAt = new Date(Date.now() + additionalMinutes * 60 * 1000).toISOString();
+    const result = db.prepare(`UPDATE task_locks
+     SET expires_at = ?,
+         heartbeat_at = datetime('now')
+     WHERE task_id = ?
+       AND runner_id = ?`).run(newExpiresAt, taskId, runnerId);
+    return result.changes > 0;
+}
+/**
+ * List all task locks
+ */
+function listTaskLocks(db) {
+    return db
+        .prepare('SELECT * FROM task_locks ORDER BY acquired_at DESC')
+        .all();
+}
+/**
+ * Find all expired task locks
+ */
+function findExpiredTaskLocks(db) {
+    return db
+        .prepare(`SELECT * FROM task_locks
+       WHERE expires_at < datetime('now')
+       ORDER BY expires_at ASC`)
+        .all();
+}
+/**
+ * Delete all expired task locks
+ * Returns the number of locks deleted
+ */
+function cleanupExpiredTaskLocks(db) {
+    const result = db.prepare(`DELETE FROM task_locks WHERE expires_at < datetime('now')`).run();
+    return result.changes;
+}
+// ============ Section Lock Queries ============
+/**
+ * Get section lock by section ID
+ */
+function getSectionLock(db, sectionId) {
+    return db
+        .prepare('SELECT * FROM section_locks WHERE section_id = ?')
+        .get(sectionId);
+}
+/**
+ * Check if a section lock is expired
+ */
+function isSectionLockExpired(lock) {
+    const expiresAt = new Date(lock.expires_at).getTime();
+    return Date.now() > expiresAt;
+}
+/**
+ * Try to insert a new section lock (atomic)
+ */
+function tryInsertSectionLock(db, sectionId, runnerId, timeoutMinutes) {
+    const expiresAt = new Date(Date.now() + timeoutMinutes * 60 * 1000).toISOString();
+    try {
+        db.prepare(`INSERT INTO section_locks (section_id, runner_id, expires_at)
+       VALUES (?, ?, ?)`).run(sectionId, runnerId, expiresAt);
+        return true;
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes('UNIQUE constraint')) {
+            return false;
+        }
+        throw err;
+    }
+}
+/**
+ * Claim an expired section lock atomically
+ */
+function claimExpiredSectionLock(db, sectionId, runnerId, timeoutMinutes) {
+    const expiresAt = new Date(Date.now() + timeoutMinutes * 60 * 1000).toISOString();
+    const result = db.prepare(`UPDATE section_locks
+     SET runner_id = ?,
+         acquired_at = datetime('now'),
+         expires_at = ?
+     WHERE section_id = ?
+       AND expires_at < datetime('now')`).run(runnerId, expiresAt, sectionId);
+    return result.changes > 0;
+}
+/**
+ * Release a section lock
+ */
+function releaseSectionLock(db, sectionId, runnerId) {
+    const result = db.prepare(`DELETE FROM section_locks
+     WHERE section_id = ?
+       AND runner_id = ?`).run(sectionId, runnerId);
+    return result.changes > 0;
+}
+/**
+ * Force release a section lock
+ */
+function forceReleaseSectionLock(db, sectionId) {
+    const result = db.prepare(`DELETE FROM section_locks WHERE section_id = ?`).run(sectionId);
+    return result.changes > 0;
+}
+/**
+ * List all section locks
+ */
+function listSectionLocks(db) {
+    return db
+        .prepare('SELECT * FROM section_locks ORDER BY acquired_at DESC')
+        .all();
+}
+/**
+ * Find all expired section locks
+ */
+function findExpiredSectionLocks(db) {
+    return db
+        .prepare(`SELECT * FROM section_locks
+       WHERE expires_at < datetime('now')
+       ORDER BY expires_at ASC`)
+        .all();
+}
+/**
+ * Delete all expired section locks
+ */
+function cleanupExpiredSectionLocks(db) {
+    const result = db.prepare(`DELETE FROM section_locks WHERE expires_at < datetime('now')`).run();
+    return result.changes;
+}
+//# sourceMappingURL=queries.js.map

package/dist/locking/queries.js.map

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

package/dist/locking/section-lock.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Section locking for parallel work prevention
+ * Prevents multiple runners from working on tasks in the same section
+ */
+import type Database from 'better-sqlite3';
+import { type SectionLock } from './queries.js';
+export interface SectionLockAcquisitionResult {
+    acquired: boolean;
+    lock?: SectionLock;
+    reason?: 'already_owned' | 'acquired_new' | 'claimed_expired';
+    error?: SectionLockError;
+}
+export interface SectionLockError {
+    code: 'SECTION_LOCKED' | 'LOCK_NOT_FOUND' | 'PERMISSION_DENIED';
+    message: string;
+    details?: {
+        sectionId: string;
+        runnerId?: string;
+        expiresAt?: string;
+    };
+}
+export interface SectionLockReleaseResult {
+    released: boolean;
+    error?: SectionLockError;
+}
+export interface SectionLockManager {
+    acquire: () => SectionLockAcquisitionResult;
+    release: () => SectionLockReleaseResult;
+    isHeld: () => boolean;
+}
+/**
+ * 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 declare function acquireSectionLock(db: Database.Database, sectionId: string, runnerId: string, timeoutMinutes?: number): SectionLockAcquisitionResult;
+/**
+ * Release a section lock (only by owner)
+ */
+export declare function releaseSectionLock(db: Database.Database, sectionId: string, runnerId: string): SectionLockReleaseResult;
+/**
+ * Force release a section lock (admin operation)
+ */
+export declare function forceRelease(db: Database.Database, sectionId: string): SectionLockReleaseResult;
+/**
+ * Create a section lock manager for a specific section
+ */
+export declare function createSectionLockManager(db: Database.Database, sectionId: string, runnerId: string, timeoutMinutes?: number): SectionLockManager;
+/**
+ * Check if a section is locked
+ */
+export declare function isSectionLocked(db: Database.Database, sectionId: string): boolean;
+/**
+ * Check if a section is locked by a specific runner
+ */
+export declare function isSectionLockedBy(db: Database.Database, sectionId: string, runnerId: string): boolean;
+/**
+ * Get time until section lock expires (in milliseconds)
+ */
+export declare function getTimeUntilExpiry(db: Database.Database, sectionId: string): number | null;
+/**
+ * Check if any tasks in the section are in progress by another runner
+ * This can be used before acquiring a section lock
+ */
+export declare function getSectionLockHolder(db: Database.Database, sectionId: string): SectionLock | null;
+export declare const SECTION_LOCK_CONSTANTS: {
+    readonly DEFAULT_TIMEOUT_MINUTES: 120;
+};
+//# sourceMappingURL=section-lock.d.ts.map

package/dist/locking/section-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-lock.d.ts","sourceRoot":"","sources":["../../src/locking/section-lock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAOL,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AAOtB,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,MAAM,CAAC,EAAE,eAAe,GAAG,cAAc,GAAG,iBAAiB,CAAC;IAC9D,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,4BAA4B,CAAC;IAC5C,OAAO,EAAE,MAAM,wBAAwB,CAAC;IACxC,MAAM,EAAE,MAAM,OAAO,CAAC;CACvB;AAID;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,cAAc,GAAE,MAAwC,GACvD,4BAA4B,CAqD9B;AAyBD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,wBAAwB,CA+B1B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,GAChB,wBAAwB,CAe1B;AAID;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,cAAc,GAAE,MAAwC,GACvD,kBAAkB,CASpB;AAID;;GAEG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAIT;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAIT;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAOf;AAID;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,GAChB,WAAW,GAAG,IAAI,CAMpB;AAID,eAAO,MAAM,sBAAsB;;CAEzB,CAAC"}

package/dist/locking/section-lock.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * Section locking for parallel work prevention
+ * Prevents multiple runners from working on tasks in the same section
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SECTION_LOCK_CONSTANTS = void 0;
+exports.acquireSectionLock = acquireSectionLock;
+exports.releaseSectionLock = releaseSectionLock;
+exports.forceRelease = forceRelease;
+exports.createSectionLockManager = createSectionLockManager;
+exports.isSectionLocked = isSectionLocked;
+exports.isSectionLockedBy = isSectionLockedBy;
+exports.getTimeUntilExpiry = getTimeUntilExpiry;
+exports.getSectionLockHolder = getSectionLockHolder;
+const queries_js_1 = require("./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
+ */
+function acquireSectionLock(db, sectionId, runnerId, timeoutMinutes = DEFAULT_SECTION_TIMEOUT_MINUTES) {
+    // Step 1: Try to insert new lock
+    if ((0, queries_js_1.tryInsertSectionLock)(db, sectionId, runnerId, timeoutMinutes)) {
+        const lock = (0, queries_js_1.getSectionLock)(db, sectionId);
+        return {
+            acquired: true,
+            lock: lock ?? undefined,
+            reason: 'acquired_new',
+        };
+    }
+    // Step 2: Lock exists, get current state
+    const existingLock = (0, queries_js_1.getSectionLock)(db, sectionId);
+    if (!existingLock) {
+        // Race condition: lock was deleted between insert attempt and now
+        if ((0, queries_js_1.tryInsertSectionLock)(db, sectionId, runnerId, timeoutMinutes)) {
+            const lock = (0, queries_js_1.getSectionLock)(db, sectionId);
+            return {
+                acquired: true,
+                lock: lock ?? undefined,
+                reason: 'acquired_new',
+            };
+        }
+        const currentLock = (0, queries_js_1.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 ((0, queries_js_1.isSectionLockExpired)(existingLock)) {
+        if ((0, queries_js_1.claimExpiredSectionLock)(db, sectionId, runnerId, timeoutMinutes)) {
+            const lock = (0, queries_js_1.getSectionLock)(db, sectionId);
+            return {
+                acquired: true,
+                lock: lock ?? undefined,
+                reason: 'claimed_expired',
+            };
+        }
+        // Another runner claimed it first
+        const currentLock = (0, queries_js_1.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)
+ */
+function releaseSectionLock(db, sectionId, runnerId) {
+    const existingLock = (0, queries_js_1.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,
+                },
+            },
+        };
+    }
+    (0, queries_js_1.releaseSectionLock)(db, sectionId, runnerId);
+    return { released: true };
+}
+/**
+ * Force release a section lock (admin operation)
+ */
+function forceRelease(db, sectionId) {
+    const existed = (0, queries_js_1.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
+ */
+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 = (0, queries_js_1.getSectionLock)(db, sectionId);
+            return lock !== null && lock.runner_id === runnerId && !(0, queries_js_1.isSectionLockExpired)(lock);
+        },
+    };
+}
+// ============ Lock Status Check ============
+/**
+ * Check if a section is locked
+ */
+function isSectionLocked(db, sectionId) {
+    const lock = (0, queries_js_1.getSectionLock)(db, sectionId);
+    if (!lock)
+        return false;
+    return !(0, queries_js_1.isSectionLockExpired)(lock);
+}
+/**
+ * Check if a section is locked by a specific runner
+ */
+function isSectionLockedBy(db, sectionId, runnerId) {
+    const lock = (0, queries_js_1.getSectionLock)(db, sectionId);
+    if (!lock)
+        return false;
+    return lock.runner_id === runnerId && !(0, queries_js_1.isSectionLockExpired)(lock);
+}
+/**
+ * Get time until section lock expires (in milliseconds)
+ */
+function getTimeUntilExpiry(db, sectionId) {
+    const lock = (0, queries_js_1.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
+ */
+function getSectionLockHolder(db, sectionId) {
+    const lock = (0, queries_js_1.getSectionLock)(db, sectionId);
+    if (!lock || (0, queries_js_1.isSectionLockExpired)(lock)) {
+        return null;
+    }
+    return lock;
+}
+// ============ Constants Export ============
+exports.SECTION_LOCK_CONSTANTS = {
+    DEFAULT_TIMEOUT_MINUTES: DEFAULT_SECTION_TIMEOUT_MINUTES,
+};
+//# sourceMappingURL=section-lock.js.map

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

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

package/dist/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/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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"}