factory-factory 0.2.5 → 0.2.7

package/dist/src/backend/lib/atomic-file.d.ts

@@ -0,0 +1,6 @@
+export interface WriteFileAtomicOptions {
+    encoding?: BufferEncoding;
+    mode?: number;
+}
+export declare function writeFileAtomic(targetPath: string, content: string | Buffer, options?: WriteFileAtomicOptions): Promise<void>;
+//# sourceMappingURL=atomic-file.d.ts.map

package/dist/src/backend/lib/atomic-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-file.d.ts","sourceRoot":"","sources":["../../../../src/backend/lib/atomic-file.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/src/backend/lib/atomic-file.js

@@ -0,0 +1,28 @@
+import { randomUUID } from 'node:crypto';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+export async function writeFileAtomic(targetPath, content, options = {}) {
+    const directory = path.dirname(targetPath);
+    await fs.mkdir(directory, { recursive: true });
+    const tmpPath = path.join(directory, `.tmp-${randomUUID()}`);
+    if (typeof content === 'string') {
+        await fs.writeFile(tmpPath, content, {
+            encoding: options.encoding ?? 'utf-8',
+            mode: options.mode,
+        });
+    }
+    else {
+        await fs.writeFile(tmpPath, content, {
+            mode: options.mode,
+        });
+    }
+    try {
+        await fs.rename(tmpPath, targetPath);
+    }
+    catch (error) {
+        await fs.unlink(tmpPath).catch(() => {
+        });
+        throw error;
+    }
+}
+//# sourceMappingURL=atomic-file.js.map

package/dist/src/backend/lib/atomic-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-file.js","sourceRoot":"","sources":["../../../../src/backend/lib/atomic-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAWlC,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,OAAwB,EACxB,UAAkC,EAAE;IAEpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,UAAU,EAAE,EAAE,CAAC,CAAC;IAE7D,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE;YACnC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,OAAO;YACrC,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE;YACnC,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QAEpC,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/src/backend/lib/atomic-file.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=atomic-file.test.d.ts.map

package/dist/src/backend/lib/atomic-file.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-file.test.d.ts","sourceRoot":"","sources":["../../../../src/backend/lib/atomic-file.test.ts"],"names":[],"mappings":""}

package/dist/src/backend/lib/atomic-file.test.js

@@ -0,0 +1,62 @@
+import { vi } from 'vitest';
+const renameControl = vi.hoisted(() => ({
+    fn: vi.fn(),
+}));
+vi.mock('node:fs/promises', async (importOriginal) => {
+    const actual = await importOriginal();
+    renameControl.fn.mockImplementation(actual.rename);
+    return {
+        ...actual,
+        rename: (...args) => renameControl.fn(...args),
+    };
+});
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { writeFileAtomic } from './atomic-file.js';
+describe('writeFileAtomic', () => {
+    afterEach(() => {
+        renameControl.fn.mockClear();
+    });
+    it('writes and replaces atomically', async () => {
+        const baseDir = await fs.mkdtemp(path.join(os.tmpdir(), 'ff-atomic-file-'));
+        const targetPath = path.join(baseDir, 'state.json');
+        try {
+            await fs.writeFile(targetPath, 'old', 'utf-8');
+            await writeFileAtomic(targetPath, 'new', { encoding: 'utf-8' });
+            const content = await fs.readFile(targetPath, 'utf-8');
+            expect(content).toBe('new');
+        }
+        finally {
+            await fs.rm(baseDir, { recursive: true, force: true });
+        }
+    });
+    it('creates parent directories as needed', async () => {
+        const baseDir = await fs.mkdtemp(path.join(os.tmpdir(), 'ff-atomic-file-'));
+        const targetPath = path.join(baseDir, 'nested', 'dir', 'config.json');
+        try {
+            await writeFileAtomic(targetPath, '{"ok":true}', { encoding: 'utf-8' });
+            const content = await fs.readFile(targetPath, 'utf-8');
+            expect(content).toBe('{"ok":true}');
+        }
+        finally {
+            await fs.rm(baseDir, { recursive: true, force: true });
+        }
+    });
+    it('cleans up temp file if rename fails', async () => {
+        const baseDir = await fs.mkdtemp(path.join(os.tmpdir(), 'ff-atomic-file-'));
+        const targetPath = path.join(baseDir, 'failing.json');
+        renameControl.fn.mockRejectedValueOnce(new Error('rename failed for test'));
+        try {
+            await expect(writeFileAtomic(targetPath, 'x', { encoding: 'utf-8' })).rejects.toThrow('rename failed for test');
+            const files = await fs.readdir(baseDir);
+            const leftoverTmpFiles = files.filter((file) => file.includes('.tmp'));
+            expect(leftoverTmpFiles).toHaveLength(0);
+        }
+        finally {
+            await fs.rm(baseDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=atomic-file.test.js.map

package/dist/src/backend/lib/atomic-file.test.js.map

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

package/dist/src/backend/lib/claude-paths.d.ts

@@ -0,0 +1,2 @@
+export declare function getClaudeProjectPath(workingDir: string): string;
+//# sourceMappingURL=claude-paths.d.ts.map

package/dist/src/backend/lib/claude-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-paths.d.ts","sourceRoot":"","sources":["../../../../src/backend/lib/claude-paths.ts"],"names":[],"mappings":"AAeA,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG/D"}

package/dist/src/backend/lib/claude-paths.js

@@ -0,0 +1,7 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export function getClaudeProjectPath(workingDir) {
+    const escapedPath = workingDir.replace(/\//g, '-');
+    return join(homedir(), '.claude', 'projects', escapedPath);
+}
+//# sourceMappingURL=claude-paths.js.map

package/dist/src/backend/lib/claude-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-paths.js","sourceRoot":"","sources":["../../../../src/backend/lib/claude-paths.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAMjC,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;AAC7D,CAAC"}

package/dist/src/backend/lib/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const LIB_LIMITS: Readonly<{
+    readonly maxFileReadBytes: number;
+    readonly shellDefaultMaxBufferBytes: number;
+    readonly osascriptEscapedMaxChars: 200;
+}>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/backend/lib/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/backend/lib/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU;;;;EAIZ,CAAC"}

package/dist/src/backend/lib/constants.js

@@ -0,0 +1,6 @@
+export const LIB_LIMITS = Object.freeze({
+    maxFileReadBytes: 1024 * 1024,
+    shellDefaultMaxBufferBytes: 10 * 1024 * 1024,
+    osascriptEscapedMaxChars: 200,
+});
+//# sourceMappingURL=constants.js.map

package/dist/src/backend/lib/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/backend/lib/constants.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;IACtC,gBAAgB,EAAE,IAAI,GAAG,IAAI;IAC7B,0BAA0B,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;IAC5C,wBAAwB,EAAE,GAAG;CACrB,CAAC,CAAC"}

package/dist/src/backend/lib/event-emitter-types.d.ts

@@ -0,0 +1,4 @@
+import type { EventEmitter } from 'node:events';
+export type EventEmitterListener = Parameters<EventEmitter['on']>[1];
+export type EventEmitterEmitArgs = Parameters<EventEmitter['emit']> extends [unknown, ...infer Args] ? Args : never;
+//# sourceMappingURL=event-emitter-types.d.ts.map

package/dist/src/backend/lib/event-emitter-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter-types.d.ts","sourceRoot":"","sources":["../../../../src/backend/lib/event-emitter-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrE,MAAM,MAAM,oBAAoB,GAC9B,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC"}

package/dist/src/backend/lib/event-emitter-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=event-emitter-types.js.map

package/dist/src/backend/lib/event-emitter-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter-types.js","sourceRoot":"","sources":["../../../../src/backend/lib/event-emitter-types.ts"],"names":[],"mappings":""}

package/dist/src/backend/lib/file-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-helpers.d.ts","sourceRoot":"","sources":["../../../../src/backend/lib/file-helpers.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOrE;AAKD,eAAO,MAAM,aAAa,QAAc,CAAC;AAOzC,wBAAsB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgCzF;AAKD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8B5D;AAKD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CASvD"}
+{"version":3,"file":"file-helpers.d.ts","sourceRoot":"","sources":["../../../../src/backend/lib/file-helpers.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOrE;AAKD,eAAO,MAAM,aAAa,QAA8B,CAAC;AAOzD,wBAAsB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgCzF;AAKD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8B5D;AAKD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CASvD"}

package/dist/src/backend/lib/file-helpers.js

@@ -1,5 +1,6 @@
 import { realpath, stat } from 'node:fs/promises';
 import path from 'node:path';
+import { LIB_LIMITS } from './constants.js';
 export async function pathExists(targetPath) {
     try {
         await stat(targetPath);
@@ -9,7 +10,7 @@ export async function pathExists(targetPath) {
         return false;
     }
 }
-export const MAX_FILE_SIZE = 1024 * 1024;
+export const MAX_FILE_SIZE = LIB_LIMITS.maxFileReadBytes;
 export async function isPathSafe(worktreePath, filePath) {
     const normalizedPath = path.normalize(filePath);
     if (normalizedPath.startsWith('..') ||

package/dist/src/backend/lib/file-helpers.js.map

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

package/dist/src/backend/lib/file-lock-mutex.d.ts

@@ -0,0 +1,26 @@
+export interface FileLockMutexOptions {
+    acquireTimeoutMs: number;
+    postTimeoutWaitMs: number;
+    initialRetryDelayMs: number;
+    maxRetryDelayMs: number;
+    maxStaleRetries: number;
+    staleThresholdMs: number;
+}
+export declare class FileLockTimeoutError extends Error {
+    constructor(message: string);
+}
+export declare class FileLockMutex {
+    private options;
+    constructor(options?: Partial<FileLockMutexOptions>);
+    acquire(lockPath: string): Promise<() => Promise<void>>;
+    private resolveAcquireContention;
+    private createLockCleanup;
+    private getInodeAndClose;
+    private unlinkIfOwned;
+    private tryHandleStaleLockAfterTimeout;
+    private tryRemoveStaleLock;
+    private verifyAndUnlinkStaleLock;
+    private unlinkStaleLock;
+    private sleep;
+}
+//# sourceMappingURL=file-lock-mutex.d.ts.map

package/dist/src/backend/lib/file-lock-mutex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-lock-mutex.d.ts","sourceRoot":"","sources":["../../../../src/backend/lib/file-lock-mutex.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAuB;gBAE1B,OAAO,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAajD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;YA4B/C,wBAAwB;IA4CtC,OAAO,CAAC,iBAAiB;YAkBX,gBAAgB;YA0BhB,aAAa;YA2Bb,8BAA8B;YAiB9B,kBAAkB;YA8BlB,wBAAwB;YA2BxB,eAAe;IAmB7B,OAAO,CAAC,KAAK;CAGd"}

package/dist/src/backend/lib/file-lock-mutex.js

@@ -0,0 +1,224 @@
+import * as fs from 'node:fs/promises';
+import { createLogger } from '../services/logger.service.js';
+const logger = createLogger('file-lock-mutex');
+const DEFAULT_LOCK_ACQUIRE_TIMEOUT_MS = 5000;
+const DEFAULT_LOCK_RETRY_DELAY_MS = 50;
+const DEFAULT_LOCK_MAX_RETRY_DELAY_MS = 500;
+const DEFAULT_LOCK_MAX_STALE_RETRIES = 3;
+export class FileLockTimeoutError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'FileLockTimeoutError';
+    }
+}
+export class FileLockMutex {
+    options;
+    constructor(options = {}) {
+        const acquireTimeoutMs = options.acquireTimeoutMs ?? DEFAULT_LOCK_ACQUIRE_TIMEOUT_MS;
+        this.options = {
+            acquireTimeoutMs,
+            postTimeoutWaitMs: options.postTimeoutWaitMs ?? 0,
+            initialRetryDelayMs: options.initialRetryDelayMs ?? DEFAULT_LOCK_RETRY_DELAY_MS,
+            maxRetryDelayMs: options.maxRetryDelayMs ?? DEFAULT_LOCK_MAX_RETRY_DELAY_MS,
+            maxStaleRetries: options.maxStaleRetries ?? DEFAULT_LOCK_MAX_STALE_RETRIES,
+            staleThresholdMs: options.staleThresholdMs ?? acquireTimeoutMs * 5,
+        };
+    }
+    async acquire(lockPath) {
+        const startTime = Date.now();
+        let retryDelay = this.options.initialRetryDelayMs;
+        let staleRetryCount = 0;
+        while (true) {
+            try {
+                const fileHandle = await fs.open(lockPath, 'wx');
+                return this.createLockCleanup(fileHandle, lockPath);
+            }
+            catch (error) {
+                const resolution = await this.resolveAcquireContention({
+                    error,
+                    lockPath,
+                    startTime,
+                    staleRetryCount,
+                });
+                staleRetryCount = resolution.staleRetryCount;
+                if (resolution.continueImmediately) {
+                    continue;
+                }
+                await this.sleep(retryDelay);
+                retryDelay = Math.min(retryDelay * 2, this.options.maxRetryDelayMs);
+            }
+        }
+    }
+    async resolveAcquireContention({ error, lockPath, startTime, staleRetryCount, }) {
+        const code = error?.code;
+        if (code !== 'EEXIST') {
+            throw error;
+        }
+        const elapsed = Date.now() - startTime;
+        const hardTimeoutMs = this.options.acquireTimeoutMs + this.options.postTimeoutWaitMs;
+        if (elapsed < this.options.acquireTimeoutMs) {
+            return { staleRetryCount, continueImmediately: false };
+        }
+        const staleResolution = await this.tryHandleStaleLockAfterTimeout(lockPath, staleRetryCount);
+        if (staleResolution.staleRemoved) {
+            return {
+                staleRetryCount: staleResolution.newCount,
+                continueImmediately: true,
+            };
+        }
+        const elapsedAfterStaleCheck = Date.now() - startTime;
+        if (elapsedAfterStaleCheck >= hardTimeoutMs) {
+            throw new FileLockTimeoutError(`Failed to acquire lock after ${hardTimeoutMs}ms and ${staleResolution.newCount} stale removal attempts: ${lockPath}`);
+        }
+        return {
+            staleRetryCount: staleResolution.newCount,
+            continueImmediately: false,
+        };
+    }
+    createLockCleanup(fileHandle, lockPath) {
+        let released = false;
+        return async () => {
+            if (released) {
+                return;
+            }
+            released = true;
+            const handleIno = await this.getInodeAndClose(fileHandle, lockPath);
+            if (handleIno === undefined) {
+                return;
+            }
+            await this.unlinkIfOwned(lockPath, handleIno);
+        };
+    }
+    async getInodeAndClose(fileHandle, lockPath) {
+        let handleIno;
+        try {
+            const handleStat = await fileHandle.stat();
+            handleIno = handleStat.ino;
+        }
+        catch (error) {
+            logger.warn('Failed to stat file handle during cleanup', {
+                lockPath,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        finally {
+            await fileHandle.close().catch((closeError) => {
+                logger.warn('Failed to close file handle during cleanup', {
+                    lockPath,
+                    error: closeError instanceof Error ? closeError.message : String(closeError),
+                });
+            });
+        }
+        return handleIno;
+    }
+    async unlinkIfOwned(lockPath, expectedIno) {
+        try {
+            const pathStat = await fs.stat(lockPath);
+            if (pathStat.ino === expectedIno) {
+                await fs.unlink(lockPath).catch(() => {
+                });
+            }
+            else {
+                logger.debug('Lock file inode changed, not unlinking (owned by another process)', {
+                    lockPath,
+                    ourIno: expectedIno,
+                    currentIno: pathStat.ino,
+                });
+            }
+        }
+        catch (error) {
+            const code = error?.code;
+            if (code === 'ENOENT') {
+                return;
+            }
+            logger.warn('Failed to stat lock file during cleanup', {
+                lockPath,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    async tryHandleStaleLockAfterTimeout(lockPath, staleRetryCount) {
+        if (staleRetryCount >= this.options.maxStaleRetries) {
+            return { staleRemoved: false, newCount: staleRetryCount };
+        }
+        const removed = await this.tryRemoveStaleLock(lockPath);
+        if (!removed) {
+            return { staleRemoved: false, newCount: staleRetryCount };
+        }
+        await this.sleep(this.options.initialRetryDelayMs);
+        return { staleRemoved: true, newCount: staleRetryCount + 1 };
+    }
+    async tryRemoveStaleLock(lockPath) {
+        try {
+            const stats = await fs.stat(lockPath);
+            const lockAge = Date.now() - stats.mtimeMs;
+            if (lockAge < this.options.staleThresholdMs) {
+                return false;
+            }
+            logger.warn('Attempting to remove stale lock file', {
+                lockPath,
+                lockAgeMs: lockAge,
+                inode: stats.ino,
+            });
+            return await this.verifyAndUnlinkStaleLock(lockPath, stats.ino);
+        }
+        catch (error) {
+            const code = error?.code;
+            if (code === 'ENOENT') {
+                return true;
+            }
+            logger.warn('Failed to check stale lock file', {
+                lockPath,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return false;
+        }
+    }
+    async verifyAndUnlinkStaleLock(lockPath, expectedIno) {
+        try {
+            const verifyStats = await fs.stat(lockPath);
+            if (verifyStats.ino !== expectedIno) {
+                logger.debug('Lock file inode changed, not removing (new lock created)', {
+                    lockPath,
+                    originalIno: expectedIno,
+                    currentIno: verifyStats.ino,
+                });
+                return false;
+            }
+            return await this.unlinkStaleLock(lockPath);
+        }
+        catch (error) {
+            const code = error?.code;
+            if (code === 'ENOENT') {
+                return true;
+            }
+            logger.warn('Failed to verify lock file before removal', {
+                lockPath,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return false;
+        }
+    }
+    async unlinkStaleLock(lockPath) {
+        try {
+            await fs.unlink(lockPath);
+            return true;
+        }
+        catch (error) {
+            const code = error?.code;
+            if (code === 'ENOENT') {
+                return true;
+            }
+            logger.warn('Failed to unlink stale lock file', {
+                lockPath,
+                error: error instanceof Error ? error.message : String(error),
+                code,
+            });
+            return false;
+        }
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=file-lock-mutex.js.map

package/dist/src/backend/lib/file-lock-mutex.js.map

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

package/dist/src/backend/lib/file-lock-mutex.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=file-lock-mutex.test.d.ts.map

package/dist/src/backend/lib/file-lock-mutex.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-lock-mutex.test.d.ts","sourceRoot":"","sources":["../../../../src/backend/lib/file-lock-mutex.test.ts"],"names":[],"mappings":""}

package/dist/src/backend/lib/file-lock-mutex.test.js

@@ -0,0 +1,143 @@
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { FileLockMutex, FileLockTimeoutError } from './file-lock-mutex.js';
+async function exists(targetPath) {
+    try {
+        await fs.stat(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+describe('FileLockMutex', () => {
+    it('acquires and releases a lock file', async () => {
+        const baseDir = await fs.mkdtemp(path.join(os.tmpdir(), 'ff-lock-mutex-'));
+        const lockPath = path.join(baseDir, 'test.lock');
+        const mutex = new FileLockMutex();
+        try {
+            const release = await mutex.acquire(lockPath);
+            expect(await exists(lockPath)).toBe(true);
+            await release();
+            expect(await exists(lockPath)).toBe(false);
+        }
+        finally {
+            await fs.rm(baseDir, { recursive: true, force: true });
+        }
+    });
+    it('times out when lock is held and stale retries are disabled', async () => {
+        const baseDir = await fs.mkdtemp(path.join(os.tmpdir(), 'ff-lock-mutex-'));
+        const lockPath = path.join(baseDir, 'held.lock');
+        await fs.writeFile(lockPath, 'held', 'utf-8');
+        const mutex = new FileLockMutex({
+            acquireTimeoutMs: 40,
+            initialRetryDelayMs: 5,
+            maxRetryDelayMs: 10,
+            maxStaleRetries: 0,
+            staleThresholdMs: 10_000,
+        });
+        try {
+            await expect(mutex.acquire(lockPath)).rejects.toBeInstanceOf(FileLockTimeoutError);
+        }
+        finally {
+            await fs.rm(baseDir, { recursive: true, force: true });
+        }
+    });
+    it('keeps waiting during post-timeout window and acquires once lock is released', async () => {
+        const baseDir = await fs.mkdtemp(path.join(os.tmpdir(), 'ff-lock-mutex-'));
+        const lockPath = path.join(baseDir, 'contention.lock');
+        const holder = new FileLockMutex({
+            acquireTimeoutMs: 20,
+            postTimeoutWaitMs: 120,
+            initialRetryDelayMs: 5,
+            maxRetryDelayMs: 10,
+            maxStaleRetries: 0,
+            staleThresholdMs: 10_000,
+        });
+        const contender = new FileLockMutex({
+            acquireTimeoutMs: 20,
+            postTimeoutWaitMs: 120,
+            initialRetryDelayMs: 5,
+            maxRetryDelayMs: 10,
+            maxStaleRetries: 0,
+            staleThresholdMs: 10_000,
+        });
+        try {
+            const releaseHolder = await holder.acquire(lockPath);
+            setTimeout(() => {
+                void releaseHolder();
+            }, 40);
+            const releaseContender = await contender.acquire(lockPath);
+            await releaseContender();
+        }
+        finally {
+            await fs.rm(baseDir, { recursive: true, force: true });
+        }
+    });
+    it('removes stale lock and acquires it', async () => {
+        const baseDir = await fs.mkdtemp(path.join(os.tmpdir(), 'ff-lock-mutex-'));
+        const lockPath = path.join(baseDir, 'stale.lock');
+        await fs.writeFile(lockPath, 'stale', 'utf-8');
+        const staleTime = new Date(Date.now() - 60_000);
+        await fs.utimes(lockPath, staleTime, staleTime);
+        const mutex = new FileLockMutex({
+            acquireTimeoutMs: 30,
+            postTimeoutWaitMs: 50,
+            initialRetryDelayMs: 5,
+            maxRetryDelayMs: 10,
+            maxStaleRetries: 2,
+            staleThresholdMs: 20,
+        });
+        try {
+            const release = await mutex.acquire(lockPath);
+            expect(await exists(lockPath)).toBe(true);
+            await release();
+            expect(await exists(lockPath)).toBe(false);
+        }
+        finally {
+            await fs.rm(baseDir, { recursive: true, force: true });
+        }
+    });
+    it('removes stale lock with zero post-timeout window', async () => {
+        const baseDir = await fs.mkdtemp(path.join(os.tmpdir(), 'ff-lock-mutex-'));
+        const lockPath = path.join(baseDir, 'stale-zero-post.lock');
+        await fs.writeFile(lockPath, 'stale', 'utf-8');
+        const staleTime = new Date(Date.now() - 60_000);
+        await fs.utimes(lockPath, staleTime, staleTime);
+        const mutex = new FileLockMutex({
+            acquireTimeoutMs: 30,
+            postTimeoutWaitMs: 0,
+            initialRetryDelayMs: 5,
+            maxRetryDelayMs: 10,
+            maxStaleRetries: 2,
+            staleThresholdMs: 20,
+        });
+        try {
+            const release = await mutex.acquire(lockPath);
+            expect(await exists(lockPath)).toBe(true);
+            await release();
+            expect(await exists(lockPath)).toBe(false);
+        }
+        finally {
+            await fs.rm(baseDir, { recursive: true, force: true });
+        }
+    });
+    it('does not unlink a replaced lock file on release', async () => {
+        const baseDir = await fs.mkdtemp(path.join(os.tmpdir(), 'ff-lock-mutex-'));
+        const lockPath = path.join(baseDir, 'replaced.lock');
+        const mutex = new FileLockMutex();
+        try {
+            const release = await mutex.acquire(lockPath);
+            await fs.unlink(lockPath);
+            await fs.writeFile(lockPath, 'replacement', 'utf-8');
+            await release();
+            expect(await exists(lockPath)).toBe(true);
+        }
+        finally {
+            await fs.rm(baseDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=file-lock-mutex.test.js.map