browser-debugger-cli 0.0.1-alpha.0 → 0.1.0-alpha.1

package/dist/session/chrome.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Chrome PID cache management.
+ *
+ * Persistent cache for Chrome PID that survives session cleanup.
+ * WHY: Enables aggressive Chrome cleanup even after session ends (for `bdg cleanup --chrome`).
+ */
+/**
+ * Write Chrome PID to persistent cache.
+ *
+ * This cache survives session cleanup so aggressive cleanup can find Chrome later.
+ * WHY: Users may want to kill Chrome after session ends, especially for testing.
+ *
+ * @param chromePid - Chrome process ID to cache
+ *
+ * @example
+ * ```typescript
+ * const chrome = await launchChrome();
+ * writeChromePid(chrome.pid);
+ * ```
+ */
+export declare function writeChromePid(chromePid: number): void;
+/**
+ * Read Chrome PID from persistent cache.
+ *
+ * Only returns the PID if the process is still alive.
+ * Automatically cleans up stale cache entries.
+ *
+ * @returns Chrome PID if cached and process is alive, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const chromePid = readChromePid();
+ * if (chromePid) {
+ *   console.log(`Chrome is running with PID ${chromePid}`);
+ *   killChromeProcess(chromePid, 'SIGKILL');
+ * }
+ * ```
+ */
+export declare function readChromePid(): number | null;
+/**
+ * Remove Chrome PID from persistent cache.
+ *
+ * Safe to call multiple times (idempotent).
+ */
+export declare function clearChromePid(): void;
+//# sourceMappingURL=chrome.d.ts.map

package/dist/session/chrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.d.ts","sourceRoot":"","sources":["../../src/session/chrome.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAItD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CA+B7C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAUrC"}

package/dist/session/chrome.js

@@ -0,0 +1,92 @@
+/**
+ * Chrome PID cache management.
+ *
+ * Persistent cache for Chrome PID that survives session cleanup.
+ * WHY: Enables aggressive Chrome cleanup even after session ends (for `bdg cleanup --chrome`).
+ */
+import * as fs from 'fs';
+import { AtomicFileWriter } from '../utils/atomicFile.js';
+import { getSessionFilePath, ensureSessionDir } from './paths.js';
+import { isProcessAlive } from './process.js';
+/**
+ * Write Chrome PID to persistent cache.
+ *
+ * This cache survives session cleanup so aggressive cleanup can find Chrome later.
+ * WHY: Users may want to kill Chrome after session ends, especially for testing.
+ *
+ * @param chromePid - Chrome process ID to cache
+ *
+ * @example
+ * ```typescript
+ * const chrome = await launchChrome();
+ * writeChromePid(chrome.pid);
+ * ```
+ */
+export function writeChromePid(chromePid) {
+    ensureSessionDir();
+    const cachePath = getSessionFilePath('CHROME_PID');
+    AtomicFileWriter.writeSync(cachePath, chromePid.toString());
+}
+/**
+ * Read Chrome PID from persistent cache.
+ *
+ * Only returns the PID if the process is still alive.
+ * Automatically cleans up stale cache entries.
+ *
+ * @returns Chrome PID if cached and process is alive, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const chromePid = readChromePid();
+ * if (chromePid) {
+ *   console.log(`Chrome is running with PID ${chromePid}`);
+ *   killChromeProcess(chromePid, 'SIGKILL');
+ * }
+ * ```
+ */
+export function readChromePid() {
+    const cachePath = getSessionFilePath('CHROME_PID');
+    if (!fs.existsSync(cachePath)) {
+        return null;
+    }
+    try {
+        const pidStr = fs.readFileSync(cachePath, 'utf-8').trim();
+        const pid = parseInt(pidStr, 10);
+        if (isNaN(pid)) {
+            return null;
+        }
+        // Only return the PID if the process is still alive
+        // This prevents trying to kill stale PIDs
+        if (!isProcessAlive(pid)) {
+            // Clean up stale cache
+            try {
+                fs.unlinkSync(cachePath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            return null;
+        }
+        return pid;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Remove Chrome PID from persistent cache.
+ *
+ * Safe to call multiple times (idempotent).
+ */
+export function clearChromePid() {
+    const cachePath = getSessionFilePath('CHROME_PID');
+    try {
+        if (fs.existsSync(cachePath)) {
+            fs.unlinkSync(cachePath);
+        }
+    }
+    catch {
+        // Ignore errors during cleanup
+    }
+}
+//# sourceMappingURL=chrome.js.map

package/dist/session/chrome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.js","sourceRoot":"","sources":["../../src/session/chrome.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,gBAAgB,EAAE,CAAC;IACnB,MAAM,SAAS,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IACnD,gBAAgB,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,SAAS,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAEnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAEjC,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QAED,oDAAoD;QACpD,0CAA0C;QAC1C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,uBAAuB;YACvB,IAAI,CAAC;gBACH,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,wBAAwB;YAC1B,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,SAAS,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAEnD,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;IACjC,CAAC;AACH,CAAC"}

package/dist/session/cleanup.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Session cleanup operations.
+ *
+ * Handles cleanup of session files (PID, metadata, lock, socket).
+ * WHY: Centralized cleanup logic ensures consistent cleanup across error paths and normal shutdown.
+ */
+/**
+ * Cleanup stale session files if no active session is running.
+ *
+ * Uses lock-based serialization to safely clean up orphaned session artifacts
+ * (PID, metadata, socket) when the recorded process is dead or files are
+ * missing/corrupt.
+ *
+ * WHY: Prevents accumulation of stale session files from crashed processes.
+ *
+ * @returns True if cleanup was performed, false if an active session is running
+ *
+ * @example
+ * ```typescript
+ * if (cleanupStaleSession()) {
+ *   console.log('Cleaned up stale session files');
+ * } else {
+ *   console.log('Active session is running - no cleanup performed');
+ * }
+ * ```
+ */
+export declare function cleanupStaleSession(): boolean;
+/**
+ * Cleanup all session files after a session ends.
+ *
+ * Removes PID, lock, and metadata files.
+ * Safe to call multiple times (idempotent).
+ *
+ * WHY: Ensures clean slate for next session, prevents stale file accumulation.
+ */
+export declare function cleanupSession(): void;
+/**
+ * Cleanup stale daemon PID file if daemon process is dead.
+ *
+ * WHY: Prevents stale daemon PIDs from blocking new daemon starts (P0 Fix #2).
+ *
+ * @returns True if cleanup was performed, false if daemon is running
+ */
+export declare function cleanupStaleDaemonPid(): boolean;
+//# sourceMappingURL=cleanup.d.ts.map

package/dist/session/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/session/cleanup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAsH7C;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAYrC;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CA0D/C"}

package/dist/session/cleanup.js

@@ -0,0 +1,230 @@
+/**
+ * Session cleanup operations.
+ *
+ * Handles cleanup of session files (PID, metadata, lock, socket).
+ * WHY: Centralized cleanup logic ensures consistent cleanup across error paths and normal shutdown.
+ */
+import * as fs from 'fs';
+import { getErrorMessage } from '../utils/errors.js';
+import { createLogger } from '../utils/logger.js';
+import { acquireSessionLock, releaseSessionLock } from './lock.js';
+import { getSessionFilePath, ensureSessionDir } from './paths.js';
+import { readPid, cleanupPidFile } from './pid.js';
+import { isProcessAlive } from './process.js';
+const log = createLogger('cleanup');
+/**
+ * Cleanup stale session files if no active session is running.
+ *
+ * Uses lock-based serialization to safely clean up orphaned session artifacts
+ * (PID, metadata, socket) when the recorded process is dead or files are
+ * missing/corrupt.
+ *
+ * WHY: Prevents accumulation of stale session files from crashed processes.
+ *
+ * @returns True if cleanup was performed, false if an active session is running
+ *
+ * @example
+ * ```typescript
+ * if (cleanupStaleSession()) {
+ *   console.log('Cleaned up stale session files');
+ * } else {
+ *   console.log('Active session is running - no cleanup performed');
+ * }
+ * ```
+ */
+export function cleanupStaleSession() {
+    ensureSessionDir();
+    // Try to acquire the session lock
+    const lockAcquired = acquireSessionLock();
+    if (!lockAcquired) {
+        // Lock is held by another process - check if it's still alive
+        const lockPath = getSessionFilePath('LOCK');
+        try {
+            const lockPidStr = fs.readFileSync(lockPath, 'utf-8').trim();
+            const lockPid = parseInt(lockPidStr, 10);
+            if (!isNaN(lockPid) && isProcessAlive(lockPid)) {
+                // Active session is running - don't clean up
+                return false;
+            }
+        }
+        catch {
+            // Can't read lock file - will clean it up below
+        }
+        // Lock exists but process is dead - force acquire
+        try {
+            fs.unlinkSync(lockPath);
+        }
+        catch {
+            // Ignore if already deleted
+        }
+        // Try to acquire lock again
+        if (!acquireSessionLock()) {
+            // Still can't acquire - another process may have grabbed it
+            return false;
+        }
+    }
+    // We now hold the lock - check if session PID exists and is alive
+    try {
+        const sessionPid = readPid();
+        // If session PID exists and process is alive, release lock and return
+        if (sessionPid !== null && isProcessAlive(sessionPid)) {
+            releaseSessionLock();
+            return false;
+        }
+        // Check daemon PID if it exists
+        const daemonPidPath = getSessionFilePath('DAEMON_PID');
+        if (fs.existsSync(daemonPidPath)) {
+            try {
+                const daemonPidStr = fs.readFileSync(daemonPidPath, 'utf-8').trim();
+                const daemonPid = parseInt(daemonPidStr, 10);
+                // If daemon is still alive, release lock and return
+                if (!isNaN(daemonPid) && isProcessAlive(daemonPid)) {
+                    releaseSessionLock();
+                    return false;
+                }
+            }
+            catch {
+                // Can't read daemon PID - will clean it up below
+            }
+        }
+        // All processes are dead - clean up stale artifacts
+        log('Removing stale session files...');
+        // Remove session PID
+        cleanupPidFile();
+        // Remove metadata
+        const metaPath = getSessionFilePath('METADATA');
+        if (fs.existsSync(metaPath)) {
+            try {
+                fs.unlinkSync(metaPath);
+                log('Removed metadata file');
+            }
+            catch (error) {
+                log(`Failed to remove metadata: ${getErrorMessage(error)}`);
+            }
+        }
+        // Remove daemon PID
+        if (fs.existsSync(daemonPidPath)) {
+            try {
+                fs.unlinkSync(daemonPidPath);
+                log('Removed daemon PID file');
+            }
+            catch (error) {
+                log(`Failed to remove daemon PID: ${getErrorMessage(error)}`);
+            }
+        }
+        // Remove daemon socket
+        const socketPath = getSessionFilePath('DAEMON_SOCKET');
+        if (fs.existsSync(socketPath)) {
+            try {
+                fs.unlinkSync(socketPath);
+                log('Removed daemon socket');
+            }
+            catch (error) {
+                log(`Failed to remove daemon socket: ${getErrorMessage(error)}`);
+            }
+        }
+        // Remove daemon lock (P0 Fix #1)
+        const daemonLockPath = getSessionFilePath('DAEMON_LOCK');
+        if (fs.existsSync(daemonLockPath)) {
+            try {
+                fs.unlinkSync(daemonLockPath);
+                log('Removed daemon lock');
+            }
+            catch (error) {
+                log(`Failed to remove daemon lock: ${getErrorMessage(error)}`);
+            }
+        }
+        log('Stale session cleanup complete');
+        return true;
+    }
+    finally {
+        // Always release the lock
+        releaseSessionLock();
+    }
+}
+/**
+ * Cleanup all session files after a session ends.
+ *
+ * Removes PID, lock, and metadata files.
+ * Safe to call multiple times (idempotent).
+ *
+ * WHY: Ensures clean slate for next session, prevents stale file accumulation.
+ */
+export function cleanupSession() {
+    cleanupPidFile();
+    releaseSessionLock();
+    const metaPath = getSessionFilePath('METADATA');
+    if (fs.existsSync(metaPath)) {
+        try {
+            fs.unlinkSync(metaPath);
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+}
+/**
+ * Cleanup stale daemon PID file if daemon process is dead.
+ *
+ * WHY: Prevents stale daemon PIDs from blocking new daemon starts (P0 Fix #2).
+ *
+ * @returns True if cleanup was performed, false if daemon is running
+ */
+export function cleanupStaleDaemonPid() {
+    const daemonPidPath = getSessionFilePath('DAEMON_PID');
+    if (!fs.existsSync(daemonPidPath)) {
+        return false;
+    }
+    try {
+        const daemonPidStr = fs.readFileSync(daemonPidPath, 'utf-8').trim();
+        const daemonPid = parseInt(daemonPidStr, 10);
+        // If daemon is still alive, don't clean up
+        if (!isNaN(daemonPid) && isProcessAlive(daemonPid)) {
+            return false;
+        }
+        // Daemon is dead - clean up stale PID and lock files
+        log(`Daemon not running (stale PID ${daemonPid}), cleaning up...`);
+        // Remove daemon PID
+        try {
+            fs.unlinkSync(daemonPidPath);
+            log('Removed stale daemon PID file');
+        }
+        catch (error) {
+            log(`Failed to remove daemon PID: ${getErrorMessage(error)}`);
+        }
+        // Remove daemon socket
+        const socketPath = getSessionFilePath('DAEMON_SOCKET');
+        if (fs.existsSync(socketPath)) {
+            try {
+                fs.unlinkSync(socketPath);
+                log('Removed stale daemon socket');
+            }
+            catch (error) {
+                log(`Failed to remove daemon socket: ${getErrorMessage(error)}`);
+            }
+        }
+        // Remove daemon lock
+        const lockPath = getSessionFilePath('DAEMON_LOCK');
+        if (fs.existsSync(lockPath)) {
+            try {
+                fs.unlinkSync(lockPath);
+                log('Removed stale daemon lock');
+            }
+            catch (error) {
+                log(`Failed to remove daemon lock: ${getErrorMessage(error)}`);
+            }
+        }
+        return true;
+    }
+    catch {
+        // Can't read daemon PID - will clean it up
+        try {
+            fs.unlinkSync(daemonPidPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/session/cleanup.js.map

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

package/dist/session/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Session management module - centralized exports.
+ *
+ * Re-exports all session-related utilities from focused submodules.
+ * WHY: Single import point maintains backwards compatibility while improving internal structure.
+ */
+export { getSessionDir, getSessionFilePath, getWorkerSocketPath, ensureSessionDir, type SessionFileType, } from './paths.js';
+export { isProcessAlive, killChromeProcess } from './process.js';
+export { acquireSessionLock, releaseSessionLock } from './lock.js';
+export { writePid, readPid, cleanupPidFile } from './pid.js';
+export { writeSessionMetadata, readSessionMetadata, type SessionMetadata } from './metadata.js';
+export { writeChromePid, readChromePid, clearChromePid } from './chrome.js';
+export { writeSessionOutput } from './output.js';
+export { cleanupSession, cleanupStaleSession } from './cleanup.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGnE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG7D,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhG,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/session/index.js

@@ -0,0 +1,23 @@
+/**
+ * Session management module - centralized exports.
+ *
+ * Re-exports all session-related utilities from focused submodules.
+ * WHY: Single import point maintains backwards compatibility while improving internal structure.
+ */
+// Path management
+export { getSessionDir, getSessionFilePath, getWorkerSocketPath, ensureSessionDir, } from './paths.js';
+// Process utilities
+export { isProcessAlive, killChromeProcess } from './process.js';
+// Lock management
+export { acquireSessionLock, releaseSessionLock } from './lock.js';
+// PID management
+export { writePid, readPid, cleanupPidFile } from './pid.js';
+// Metadata management
+export { writeSessionMetadata, readSessionMetadata } from './metadata.js';
+// Chrome PID cache
+export { writeChromePid, readChromePid, clearChromePid } from './chrome.js';
+// Output file I/O
+export { writeSessionOutput } from './output.js';
+// Cleanup operations
+export { cleanupSession, cleanupStaleSession } from './cleanup.js';
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kBAAkB;AAClB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GAEjB,MAAM,YAAY,CAAC;AAEpB,oBAAoB;AACpB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjE,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEnE,iBAAiB;AACjB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE7D,sBAAsB;AACtB,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAwB,MAAM,eAAe,CAAC;AAEhG,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5E,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,qBAAqB;AACrB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/session/lock.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Session lock management for preventing concurrent sessions.
+ *
+ * Uses exclusive file creation (wx flag) with PID tracking for atomic lock acquisition.
+ * WHY: Prevents race conditions when multiple bdg processes try to start simultaneously.
+ */
+/**
+ * Acquire session lock atomically.
+ *
+ * Uses exclusive file creation (wx flag) to ensure only one session can run.
+ * If lock file exists but process is dead, automatically removes stale lock and retries.
+ *
+ * @returns True if lock was acquired, false if another session is running
+ *
+ * @example
+ * ```typescript
+ * if (!acquireSessionLock()) {
+ *   console.error('Another session is already running');
+ *   process.exit(1);
+ * }
+ * ```
+ */
+export declare function acquireSessionLock(): boolean;
+/**
+ * Release session lock.
+ *
+ * Removes the lock file to allow other sessions to start.
+ * Safe to call multiple times (idempotent).
+ */
+export declare function releaseSessionLock(): void;
+/**
+ * Acquire daemon lock atomically.
+ *
+ * Uses exclusive file creation (wx flag) to ensure only one daemon can start.
+ * If lock file exists but process is dead, automatically removes stale lock and retries.
+ *
+ * WHY: Prevents race condition where two concurrent bdg commands spawn 2 daemons.
+ *
+ * @returns True if lock was acquired, false if another daemon startup is in progress
+ *
+ * @example
+ * ```typescript
+ * if (!acquireDaemonLock()) {
+ *   console.error('Another daemon is starting up');
+ *   process.exit(1);
+ * }
+ * ```
+ */
+export declare function acquireDaemonLock(): boolean;
+/**
+ * Release daemon lock.
+ *
+ * Removes the daemon lock file to allow other daemon startups.
+ * Safe to call multiple times (idempotent).
+ */
+export declare function releaseDaemonLock(): void;
+//# sourceMappingURL=lock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/session/lock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAmC5C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAUzC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAmC3C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAUxC"}