ctxinit 0.1.0

package/dist/build/atomic.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * Atomic File Operations
+ *
+ * Provides safe file writing with:
+ * - Temp file → atomic rename pattern
+ * - Multi-file transactions (all-or-nothing)
+ * - Cleanup on error
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTempPath = getTempPath;
+exports.atomicWrite = atomicWrite;
+exports.atomicWriteSync = atomicWriteSync;
+exports.transaction = transaction;
+exports.cleanupStaleTempFiles = cleanupStaleTempFiles;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Generate temp file path for atomic write
+ *
+ * @param targetPath - Target file path
+ * @returns Temp file path with pid suffix
+ */
+function getTempPath(targetPath) {
+    const dir = path.dirname(targetPath);
+    const base = path.basename(targetPath);
+    return path.join(dir, `${base}.tmp.${process.pid}`);
+}
+/**
+ * Write file atomically using temp file + rename
+ *
+ * @param targetPath - Target file path
+ * @param content - Content to write
+ * @throws Error if write or rename fails
+ */
+async function atomicWrite(targetPath, content) {
+    const tempPath = getTempPath(targetPath);
+    const dir = path.dirname(targetPath);
+    // Ensure directory exists
+    await fs.promises.mkdir(dir, { recursive: true });
+    try {
+        // Write to temp file
+        await fs.promises.writeFile(tempPath, content, 'utf-8');
+        // Atomic rename
+        await fs.promises.rename(tempPath, targetPath);
+    }
+    catch (error) {
+        // Cleanup temp file on error
+        try {
+            await fs.promises.unlink(tempPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        throw error;
+    }
+}
+/**
+ * Write file atomically (synchronous version)
+ *
+ * @param targetPath - Target file path
+ * @param content - Content to write
+ * @throws Error if write or rename fails
+ */
+function atomicWriteSync(targetPath, content) {
+    const tempPath = getTempPath(targetPath);
+    const dir = path.dirname(targetPath);
+    // Ensure directory exists
+    fs.mkdirSync(dir, { recursive: true });
+    try {
+        // Write to temp file
+        fs.writeFileSync(tempPath, content, 'utf-8');
+        // Atomic rename
+        fs.renameSync(tempPath, targetPath);
+    }
+    catch (error) {
+        // Cleanup temp file on error
+        try {
+            fs.unlinkSync(tempPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        throw error;
+    }
+}
+/**
+ * Execute a multi-file transaction (all-or-nothing)
+ *
+ * If any file fails to write, all temp files are cleaned up
+ * and no target files are modified.
+ *
+ * @param writes - Array of pending writes
+ * @returns Transaction result
+ */
+async function transaction(writes) {
+    const result = {
+        success: false,
+        writtenFiles: [],
+        errors: [],
+    };
+    // Track temp files for cleanup
+    const tempFiles = [];
+    try {
+        // Phase 1: Write all temp files
+        for (const write of writes) {
+            const tempPath = getTempPath(write.targetPath);
+            const dir = path.dirname(write.targetPath);
+            try {
+                // Ensure directory exists
+                await fs.promises.mkdir(dir, { recursive: true });
+                // Write to temp file
+                await fs.promises.writeFile(tempPath, write.content, 'utf-8');
+                write.tempPath = tempPath;
+                tempFiles.push(tempPath);
+            }
+            catch (error) {
+                result.errors.push({
+                    path: write.targetPath,
+                    error: error,
+                });
+                // Cleanup all temp files on any error
+                await cleanupTempFiles(tempFiles);
+                return result;
+            }
+        }
+        // Phase 2: Atomic rename all files
+        for (const write of writes) {
+            if (!write.tempPath)
+                continue;
+            try {
+                await fs.promises.rename(write.tempPath, write.targetPath);
+                result.writtenFiles.push(write.targetPath);
+            }
+            catch (error) {
+                result.errors.push({
+                    path: write.targetPath,
+                    error: error,
+                });
+                // Cleanup remaining temp files
+                const remaining = tempFiles.filter(tf => !result.writtenFiles.some(wf => getTempPath(wf) === tf));
+                await cleanupTempFiles(remaining);
+                return result;
+            }
+        }
+        result.success = true;
+        return result;
+    }
+    catch (error) {
+        // Unexpected error - cleanup all temp files
+        await cleanupTempFiles(tempFiles);
+        result.errors.push({
+            path: 'transaction',
+            error: error,
+        });
+        return result;
+    }
+}
+/**
+ * Cleanup temp files
+ *
+ * @param tempFiles - Array of temp file paths to cleanup
+ */
+async function cleanupTempFiles(tempFiles) {
+    for (const tempPath of tempFiles) {
+        try {
+            await fs.promises.unlink(tempPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    }
+}
+/**
+ * Cleanup stale temp files from a previous crashed build
+ *
+ * @param directory - Directory to scan for temp files
+ * @param pattern - Pattern to match temp files (default: *.tmp.*)
+ */
+async function cleanupStaleTempFiles(directory, pattern = /\.tmp\.\d+$/) {
+    const cleaned = [];
+    try {
+        const entries = await fs.promises.readdir(directory, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isFile() && pattern.test(entry.name)) {
+                const filePath = path.join(directory, entry.name);
+                try {
+                    await fs.promises.unlink(filePath);
+                    cleaned.push(filePath);
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or not accessible
+    }
+    return cleaned;
+}
+//# sourceMappingURL=atomic.js.map

package/dist/build/atomic.js.map

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

package/dist/build/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Build System
+ *
+ * Exports for the build system modules.
+ */
+export * from './manifest';
+export * from './atomic';
+export * from './lock';
+export * from './orchestrator';
+//# sourceMappingURL=index.d.ts.map

package/dist/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/build/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC"}

package/dist/build/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Build System
+ *
+ * Exports for the build system modules.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./manifest"), exports);
+__exportStar(require("./atomic"), exports);
+__exportStar(require("./lock"), exports);
+__exportStar(require("./orchestrator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/build/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,6CAA2B;AAC3B,2CAAyB;AACzB,yCAAuB;AACvB,iDAA+B"}

package/dist/build/lock.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Build Locking
+ *
+ * Prevents concurrent builds with:
+ * - Lock file with pid, timestamp, hostname
+ * - Stale lock detection (>5 minutes old)
+ * - Automatic cleanup on build completion
+ */
+/**
+ * Lock file content structure
+ */
+export interface LockInfo {
+    /** Process ID that holds the lock */
+    pid: number;
+    /** Timestamp when lock was acquired (Unix ms) */
+    timestamp: number;
+    /** Hostname of the machine holding the lock */
+    hostname: string;
+    /** Target being built */
+    target: string;
+}
+/**
+ * Lock acquisition result
+ */
+export interface LockResult {
+    /** Whether lock was acquired */
+    acquired: boolean;
+    /** Path to lock file */
+    lockPath: string;
+    /** If not acquired, info about existing lock */
+    existingLock?: LockInfo;
+    /** If stale lock was removed */
+    staleRemoved?: boolean;
+}
+/**
+ * Get lock file path
+ *
+ * @param projectRoot - Project root directory
+ * @returns Lock file path
+ */
+export declare function getLockPath(projectRoot: string): string;
+/**
+ * Create lock info for current process
+ *
+ * @param target - Build target
+ * @returns Lock info
+ */
+export declare function createLockInfo(target: string): LockInfo;
+/**
+ * Read existing lock file
+ *
+ * @param lockPath - Path to lock file
+ * @returns Lock info or null if not found/invalid
+ */
+export declare function readLock(lockPath: string): Promise<LockInfo | null>;
+/**
+ * Check if a lock is stale (older than threshold)
+ *
+ * @param lock - Lock info to check
+ * @param thresholdMs - Stale threshold in milliseconds
+ * @returns true if lock is stale
+ */
+export declare function isLockStale(lock: LockInfo, thresholdMs?: number): boolean;
+/**
+ * Check if process with given PID is still running
+ *
+ * @param pid - Process ID to check
+ * @returns true if process is running
+ */
+export declare function isProcessRunning(pid: number): boolean;
+/**
+ * Acquire build lock
+ *
+ * @param projectRoot - Project root directory
+ * @param target - Build target
+ * @param staleThresholdMs - Stale lock threshold in milliseconds
+ * @returns Lock acquisition result
+ */
+export declare function acquireLock(projectRoot: string, target: string, staleThresholdMs?: number): Promise<LockResult>;
+/**
+ * Release build lock
+ *
+ * @param projectRoot - Project root directory
+ * @returns true if lock was released
+ */
+export declare function releaseLock(projectRoot: string): Promise<boolean>;
+/**
+ * Format lock info for display
+ *
+ * @param lock - Lock info to format
+ * @returns Human-readable lock description
+ */
+export declare function formatLockInfo(lock: LockInfo): string;
+/**
+ * Create a lock guard for RAII-style lock management
+ *
+ * @param projectRoot - Project root directory
+ * @param target - Build target
+ * @returns Lock guard with release method
+ */
+export declare function withLock<T>(projectRoot: string, target: string, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=lock.d.ts.map

package/dist/build/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/build/lock.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,gCAAgC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAYD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAOvD;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAWzE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,GAAE,MAA2B,GAAG,OAAO,CAG7F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAUrD;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,gBAAgB,GAAE,MAA2B,GAC5C,OAAO,CAAC,UAAU,CAAC,CAiDrB;AAwCD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BvE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAIrD;AAmBD;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAgBZ"}

package/dist/build/lock.js

@@ -0,0 +1,297 @@
+"use strict";
+/**
+ * Build Locking
+ *
+ * Prevents concurrent builds with:
+ * - Lock file with pid, timestamp, hostname
+ * - Stale lock detection (>5 minutes old)
+ * - Automatic cleanup on build completion
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLockPath = getLockPath;
+exports.createLockInfo = createLockInfo;
+exports.readLock = readLock;
+exports.isLockStale = isLockStale;
+exports.isProcessRunning = isProcessRunning;
+exports.acquireLock = acquireLock;
+exports.releaseLock = releaseLock;
+exports.formatLockInfo = formatLockInfo;
+exports.withLock = withLock;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+/**
+ * Default stale lock threshold (5 minutes in ms)
+ */
+const STALE_THRESHOLD_MS = 5 * 60 * 1000;
+/**
+ * Lock file name
+ */
+const LOCK_FILENAME = '.build.lock';
+/**
+ * Get lock file path
+ *
+ * @param projectRoot - Project root directory
+ * @returns Lock file path
+ */
+function getLockPath(projectRoot) {
+    return path.join(projectRoot, '.context', LOCK_FILENAME);
+}
+/**
+ * Create lock info for current process
+ *
+ * @param target - Build target
+ * @returns Lock info
+ */
+function createLockInfo(target) {
+    return {
+        pid: process.pid,
+        timestamp: Date.now(),
+        hostname: os.hostname(),
+        target,
+    };
+}
+/**
+ * Read existing lock file
+ *
+ * @param lockPath - Path to lock file
+ * @returns Lock info or null if not found/invalid
+ */
+async function readLock(lockPath) {
+    try {
+        const content = await fs.promises.readFile(lockPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        // Invalid JSON or other error - treat as no lock
+        return null;
+    }
+}
+/**
+ * Check if a lock is stale (older than threshold)
+ *
+ * @param lock - Lock info to check
+ * @param thresholdMs - Stale threshold in milliseconds
+ * @returns true if lock is stale
+ */
+function isLockStale(lock, thresholdMs = STALE_THRESHOLD_MS) {
+    const age = Date.now() - lock.timestamp;
+    return age > thresholdMs;
+}
+/**
+ * Check if process with given PID is still running
+ *
+ * @param pid - Process ID to check
+ * @returns true if process is running
+ */
+function isProcessRunning(pid) {
+    try {
+        // kill with signal 0 checks if process exists without killing it
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        // EPERM means process exists but we don't have permission
+        // ESRCH means process doesn't exist
+        return error.code === 'EPERM';
+    }
+}
+/**
+ * Acquire build lock
+ *
+ * @param projectRoot - Project root directory
+ * @param target - Build target
+ * @param staleThresholdMs - Stale lock threshold in milliseconds
+ * @returns Lock acquisition result
+ */
+async function acquireLock(projectRoot, target, staleThresholdMs = STALE_THRESHOLD_MS) {
+    const lockPath = getLockPath(projectRoot);
+    const lockDir = path.dirname(lockPath);
+    // Ensure directory exists
+    await fs.promises.mkdir(lockDir, { recursive: true });
+    // Check for existing lock
+    const existingLock = await readLock(lockPath);
+    if (existingLock) {
+        // Check if lock is stale
+        if (isLockStale(existingLock, staleThresholdMs)) {
+            // Remove stale lock
+            try {
+                await fs.promises.unlink(lockPath);
+            }
+            catch {
+                // Ignore removal errors
+            }
+            // Try to acquire
+            return await tryAcquireLock(lockPath, target, true);
+        }
+        // Check if holding process is still running (same hostname only)
+        if (existingLock.hostname === os.hostname()) {
+            if (!isProcessRunning(existingLock.pid)) {
+                // Process is dead, remove lock
+                try {
+                    await fs.promises.unlink(lockPath);
+                }
+                catch {
+                    // Ignore removal errors
+                }
+                // Try to acquire
+                return await tryAcquireLock(lockPath, target, true);
+            }
+        }
+        // Lock is active - cannot acquire
+        return {
+            acquired: false,
+            lockPath,
+            existingLock,
+        };
+    }
+    // No existing lock - try to acquire
+    return await tryAcquireLock(lockPath, target, false);
+}
+/**
+ * Try to acquire the lock (internal helper)
+ */
+async function tryAcquireLock(lockPath, target, staleRemoved) {
+    const lockInfo = createLockInfo(target);
+    try {
+        // Write lock file with exclusive flag
+        const fd = await fs.promises.open(lockPath, fs.constants.O_WRONLY | fs.constants.O_CREAT | fs.constants.O_EXCL);
+        try {
+            await fd.writeFile(JSON.stringify(lockInfo, null, 2), 'utf-8');
+        }
+        finally {
+            await fd.close();
+        }
+        return {
+            acquired: true,
+            lockPath,
+            staleRemoved,
+        };
+    }
+    catch (error) {
+        if (error.code === 'EEXIST') {
+            // Race condition - another process acquired the lock
+            const existingLock = await readLock(lockPath);
+            return {
+                acquired: false,
+                lockPath,
+                existingLock: existingLock || undefined,
+            };
+        }
+        throw error;
+    }
+}
+/**
+ * Release build lock
+ *
+ * @param projectRoot - Project root directory
+ * @returns true if lock was released
+ */
+async function releaseLock(projectRoot) {
+    const lockPath = getLockPath(projectRoot);
+    try {
+        // Verify we own the lock before releasing
+        const existingLock = await readLock(lockPath);
+        if (!existingLock) {
+            // Lock doesn't exist - nothing to release
+            return false;
+        }
+        // Only release if we own the lock
+        if (existingLock.pid !== process.pid || existingLock.hostname !== os.hostname()) {
+            // We don't own this lock
+            return false;
+        }
+        await fs.promises.unlink(lockPath);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return false;
+        }
+        throw error;
+    }
+}
+/**
+ * Format lock info for display
+ *
+ * @param lock - Lock info to format
+ * @returns Human-readable lock description
+ */
+function formatLockInfo(lock) {
+    const age = Date.now() - lock.timestamp;
+    const ageStr = formatDuration(age);
+    return `Build in progress by PID ${lock.pid} on ${lock.hostname} (${ageStr} ago) for target: ${lock.target}`;
+}
+/**
+ * Format duration in human-readable form
+ */
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    if (hours > 0) {
+        return `${hours}h ${minutes % 60}m`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ${seconds % 60}s`;
+    }
+    return `${seconds}s`;
+}
+/**
+ * Create a lock guard for RAII-style lock management
+ *
+ * @param projectRoot - Project root directory
+ * @param target - Build target
+ * @returns Lock guard with release method
+ */
+async function withLock(projectRoot, target, fn) {
+    const result = await acquireLock(projectRoot, target);
+    if (!result.acquired) {
+        throw new Error(result.existingLock
+            ? `Build already in progress: ${formatLockInfo(result.existingLock)}`
+            : 'Failed to acquire build lock');
+    }
+    try {
+        return await fn();
+    }
+    finally {
+        await releaseLock(projectRoot);
+    }
+}
+//# sourceMappingURL=lock.js.map