browser-debugger-cli 0.5.1 → 0.6.1

package/dist/session/cleanup.js

@@ -5,35 +5,21 @@
  * WHY: Centralized cleanup logic ensures consistent cleanup across error paths and normal shutdown.
  */
 import * as fs from 'fs';
-import { getErrorMessage } from '../ui/errors/index.js';
+import { getErrorMessage } from '../connection/errors.js';
 import { createLogger } from '../ui/logging/index.js';
 import { readChromePid, clearChromePid } from './chrome.js';
-import { safeDeleteFile } from './fileOps.js';
 import { acquireSessionLock, releaseSessionLock } from './lock.js';
 import { getSessionFilePath, ensureSessionDir } from './paths.js';
-import { readPid, cleanupPidFile } from './pid.js';
+import { readPid, cleanupPidFile, readPidFromFile } from './pid.js';
 import { isProcessAlive, killChromeProcess } from './process.js';
 const log = createLogger('cleanup');
-function readPidFromFile(filePath) {
-    if (!fs.existsSync(filePath)) {
-        return null;
-    }
-    try {
-        const pidStr = fs.readFileSync(filePath, 'utf-8').trim();
-        const pid = parseInt(pidStr, 10);
-        return Number.isNaN(pid) ? null : pid;
-    }
-    catch {
-        return null;
-    }
-}
 function killOrphanedWorker(pid) {
     try {
         process.kill(pid, 'SIGKILL');
-        log(`Force killed orphaned worker process ${pid}`);
+        log.info(`Force killed orphaned worker process ${pid}`);
     }
     catch (error) {
-        log(`Failed to kill orphaned worker process ${pid}: ${getErrorMessage(error)}`);
+        log.info(`Failed to kill orphaned worker process ${pid}: ${getErrorMessage(error)}`);
     }
 }
 function killCachedChromeProcess(reason) {
@@ -41,14 +27,14 @@ function killCachedChromeProcess(reason) {
     if (!chromePid) {
         return;
     }
-    log(`Killing cached Chrome process ${chromePid} (${reason})`);
+    log.info(`Killing cached Chrome process ${chromePid} (${reason})`);
     let killSucceeded = false;
     try {
         killChromeProcess(chromePid, 'SIGKILL');
         killSucceeded = true;
     }
     catch (error) {
-        log(`Failed to kill Chrome process ${chromePid}: ${getErrorMessage(error)}`);
+        log.info(`Failed to kill Chrome process ${chromePid}: ${getErrorMessage(error)}`);
     }
     finally {
         if (killSucceeded || !isProcessAlive(chromePid)) {
@@ -78,36 +64,29 @@ function killCachedChromeProcess(reason) {
  */
 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
+            if (!Number.isNaN(lockPid) && isProcessAlive(lockPid)) {
                 return false;
             }
         }
-        catch {
-            // Can't read lock file - will clean it up below
+        catch (error) {
+            log.debug(`Failed to read stale session lock: ${getErrorMessage(error)}`);
         }
-        // Lock exists but process is dead - force acquire
         try {
-            fs.unlinkSync(lockPath);
+            fs.rmSync(lockPath, { force: true });
         }
-        catch {
-            // Ignore if already deleted
+        catch (error) {
+            log.debug(`Failed to remove stale session lock: ${getErrorMessage(error)}`);
         }
-        // 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 and daemon processes are alive
     try {
         const sessionPid = readPid();
         let sessionAlive = sessionPid !== null && isProcessAlive(sessionPid);
@@ -115,7 +94,7 @@ export function cleanupStaleSession() {
         const daemonPid = readPidFromFile(daemonPidPath);
         const daemonAlive = daemonPid !== null && isProcessAlive(daemonPid);
         if (sessionAlive && !daemonAlive && sessionPid !== null) {
-            log(`Detected orphaned worker process (PID ${sessionPid}) with no daemon - forcing cleanup`);
+            log.info(`Detected orphaned worker process (PID ${sessionPid}) with no daemon - forcing cleanup`);
             killCachedChromeProcess('orphaned worker cleanup');
             killOrphanedWorker(sessionPid);
             sessionAlive = isProcessAlive(sessionPid);
@@ -126,44 +105,99 @@ export function cleanupStaleSession() {
         if (daemonAlive) {
             return false;
         }
-        // All processes are dead - clean up stale artifacts
-        log('Removing stale session files...');
+        log.info('Removing stale session files...');
         killCachedChromeProcess('stale session cleanup');
-        // Remove session PID
         cleanupPidFile();
-        // Remove all session files using helper
-        safeDeleteFile(getSessionFilePath('METADATA'), 'metadata file', log);
-        safeDeleteFile(daemonPidPath, 'daemon PID file', log);
-        safeDeleteFile(getSessionFilePath('DAEMON_SOCKET'), 'daemon socket', log);
-        safeDeleteFile(getSessionFilePath('DAEMON_LOCK'), 'daemon lock', log);
-        log('Stale session cleanup complete');
+        try {
+            fs.rmSync(getSessionFilePath('METADATA'), { force: true });
+        }
+        catch (error) {
+            log.debug(`Failed to remove metadata file: ${getErrorMessage(error)}`);
+        }
+        try {
+            fs.rmSync(daemonPidPath, { force: true });
+        }
+        catch (error) {
+            log.debug(`Failed to remove daemon PID file: ${getErrorMessage(error)}`);
+        }
+        try {
+            fs.rmSync(getSessionFilePath('DAEMON_SOCKET'), { force: true });
+        }
+        catch (error) {
+            log.debug(`Failed to remove daemon socket: ${getErrorMessage(error)}`);
+        }
+        try {
+            fs.rmSync(getSessionFilePath('DAEMON_LOCK'), { force: true });
+        }
+        catch (error) {
+            log.debug(`Failed to remove daemon lock: ${getErrorMessage(error)}`);
+        }
+        log.info('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.
+ * Removes session-specific files while preserving chrome-profile directory
+ * which contains user preferences, cookies, and cached data.
+ *
+ * Files removed:
+ * - session.pid (worker PID)
+ * - session.lock (session lock)
+ * - session.meta.json (session metadata)
+ * - daemon.pid, daemon.sock, daemon.lock (daemon files)
+ *
+ * Files preserved:
+ * - session.json (output file - user needs to read it)
+ * - chrome.pid (for emergency cleanup - auto-removed if Chrome is dead)
+ * - chrome-profile/ directory (cookies, preferences, cache)
+ *
  * Safe to call multiple times (idempotent).
  *
- * WHY: Ensures clean slate for next session, prevents stale file accumulation.
+ * WHY: Ensures clean slate for next session while preserving user preferences.
  */
 export function cleanupSession() {
+    // Clean up worker session files
     cleanupPidFile();
     releaseSessionLock();
-    const metaPath = getSessionFilePath('METADATA');
-    if (fs.existsSync(metaPath)) {
-        try {
-            fs.unlinkSync(metaPath);
-        }
-        catch {
-            // Ignore errors
-        }
+    // Remove session metadata
+    try {
+        fs.rmSync(getSessionFilePath('METADATA'), { force: true });
+    }
+    catch (error) {
+        log.debug(`Failed to remove metadata file: ${getErrorMessage(error)}`);
+    }
+    // NOTE: chrome.pid is intentionally NOT removed here
+    // It's used for emergency cleanup (bdg cleanup --chrome)
+    // and is automatically cleaned when Chrome process dies (via readChromePid)
+    // Remove daemon files
+    try {
+        fs.rmSync(getSessionFilePath('DAEMON_PID'), { force: true });
+    }
+    catch (error) {
+        log.debug(`Failed to remove daemon PID file: ${getErrorMessage(error)}`);
+    }
+    try {
+        fs.rmSync(getSessionFilePath('DAEMON_SOCKET'), { force: true });
+    }
+    catch (error) {
+        log.debug(`Failed to remove daemon socket: ${getErrorMessage(error)}`);
+    }
+    try {
+        fs.rmSync(getSessionFilePath('DAEMON_LOCK'), { force: true });
+    }
+    catch (error) {
+        log.debug(`Failed to remove daemon lock: ${getErrorMessage(error)}`);
     }
+    // NOTE: session.json (OUTPUT) is intentionally NOT removed
+    // User needs to read the output file after session ends
+    // They can manually delete it or use `bdg cleanup` to remove all files
+    // NOTE: chrome-profile/ directory is intentionally NOT removed
+    // to preserve user preferences, cookies, and cached data across sessions
 }
 /**
  * Cleanup stale daemon PID file if daemon process is dead.
@@ -180,48 +214,42 @@ export function cleanupStaleDaemonPid() {
     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)) {
+        if (!Number.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
+        log.info(`Daemon not running (stale PID ${daemonPid}), cleaning up...`);
         try {
-            fs.unlinkSync(daemonPidPath);
-            log('Removed stale daemon PID file');
+            fs.rmSync(daemonPidPath, { force: true });
+            log.info('Removed stale daemon PID file');
         }
         catch (error) {
-            log(`Failed to remove daemon PID: ${getErrorMessage(error)}`);
+            log.info(`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');
+                fs.rmSync(socketPath, { force: true });
+                log.info('Removed stale daemon socket');
             }
             catch (error) {
-                log(`Failed to remove daemon socket: ${getErrorMessage(error)}`);
+                log.info(`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');
+                fs.rmSync(lockPath, { force: true });
+                log.info('Removed stale daemon lock');
             }
             catch (error) {
-                log(`Failed to remove daemon lock: ${getErrorMessage(error)}`);
+                log.info(`Failed to remove daemon lock: ${getErrorMessage(error)}`);
             }
         }
         return true;
     }
     catch {
-        // Can't read daemon PID - will clean it up
         try {
-            fs.unlinkSync(daemonPidPath);
+            fs.rmSync(daemonPidPath, { force: true });
             return true;
         }
         catch {

package/dist/session/cleanup.js.map

@@ -1 +1 @@
-{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../src/session/cleanup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjE,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;AAEpC,SAAS,eAAe,CAAC,QAAgB;IACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACzD,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACjC,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC7B,GAAG,CAAC,wCAAwC,GAAG,EAAE,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,0CAA0C,GAAG,KAAK,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAc;IAC7C,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;IAClC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;IACT,CAAC;IAED,GAAG,CAAC,iCAAiC,SAAS,KAAK,MAAM,GAAG,CAAC,CAAC;IAE9D,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,CAAC;QACH,iBAAiB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACxC,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,iCAAiC,SAAS,KAAK,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/E,CAAC;YAAS,CAAC;QACT,IAAI,aAAa,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;YAChD,cAAc,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,mBAAmB;IACjC,gBAAgB,EAAE,CAAC;IAEnB,kCAAkC;IAClC,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC;IAE1C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,8DAA8D;QAC9D,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7D,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAEzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/C,6CAA6C;gBAC7C,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gDAAgD;QAClD,CAAC;QAED,kDAAkD;QAClD,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;QAED,4BAA4B;QAC5B,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;YAC1B,4DAA4D;YAC5D,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,OAAO,EAAE,CAAC;QAC7B,IAAI,YAAY,GAAG,UAAU,KAAK,IAAI,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;QAErE,MAAM,aAAa,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,SAAS,KAAK,IAAI,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;QAEpE,IAAI,YAAY,IAAI,CAAC,WAAW,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxD,GAAG,CAAC,yCAAyC,UAAU,oCAAoC,CAAC,CAAC;YAC7F,uBAAuB,CAAC,yBAAyB,CAAC,CAAC;YACnD,kBAAkB,CAAC,UAAU,CAAC,CAAC;YAC/B,YAAY,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,oDAAoD;QACpD,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAEvC,uBAAuB,CAAC,uBAAuB,CAAC,CAAC;QAEjD,qBAAqB;QACrB,cAAc,EAAE,CAAC;QAEjB,wCAAwC;QACxC,cAAc,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC;QACrE,cAAc,CAAC,aAAa,EAAE,iBAAiB,EAAE,GAAG,CAAC,CAAC;QACtD,cAAc,CAAC,kBAAkB,CAAC,eAAe,CAAC,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC;QAC1E,cAAc,CAAC,kBAAkB,CAAC,aAAa,CAAC,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;QAEtE,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAEtC,OAAO,IAAI,CAAC;IACd,CAAC;YAAS,CAAC;QACT,0BAA0B;QAC1B,kBAAkB,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc;IAC5B,cAAc,EAAE,CAAC;IACjB,kBAAkB,EAAE,CAAC;IAErB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,aAAa,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACpE,MAAM,SAAS,GAAG,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAE7C,2CAA2C;QAC3C,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;YACnD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,qDAAqD;QACrD,GAAG,CAAC,iCAAiC,SAAS,mBAAmB,CAAC,CAAC;QAEnE,oBAAoB;QACpB,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;YAC7B,GAAG,CAAC,+BAA+B,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,gCAAgC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,uBAAuB;QACvB,MAAM,UAAU,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC;QACvD,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;gBAC1B,GAAG,CAAC,6BAA6B,CAAC,CAAC;YACrC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,mCAAmC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QAED,qBAAqB;QACrB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;QACnD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACxB,GAAG,CAAC,2BAA2B,CAAC,CAAC;YACnC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,iCAAiC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,2CAA2C;QAC3C,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../src/session/cleanup.ts"],"names":[],"mappings":"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"}

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

@@ -1 +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"}
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/session/lock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkHH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/session/lock.js

@@ -5,8 +5,105 @@
  * WHY: Prevents race conditions when multiple bdg processes try to start simultaneously.
  */
 import * as fs from 'fs';
+import { getErrorMessage } from '../connection/errors.js';
+import { createLogger } from '../ui/logging/index.js';
 import { getSessionFilePath, ensureSessionDir } from './paths.js';
 import { isProcessAlive } from './process.js';
+const log = createLogger('session');
+/**
+ * Type guard for NodeJS errno exceptions.
+ *
+ * @param e - Unknown error to check
+ * @returns True if error has errno code property
+ */
+function isErrnoException(e) {
+    return typeof e === 'object' && e !== null && 'code' in e;
+}
+/**
+ * Read PID from lock file.
+ *
+ * @param lockPath - Path to lock file
+ * @returns Parsed PID or null if file doesn't exist or is invalid
+ */
+function readLockPid(lockPath) {
+    try {
+        const lockPidStr = fs.readFileSync(lockPath, 'utf-8').trim();
+        const lockPid = parseInt(lockPidStr, 10);
+        return Number.isNaN(lockPid) ? null : lockPid;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Try to remove stale lock file.
+ *
+ * @param lockPath - Path to lock file to remove
+ * @returns True if removal succeeded, false otherwise
+ */
+function removeStaleLock(lockPath) {
+    try {
+        fs.rmSync(lockPath, { force: true });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Handle existing lock file by checking if owner process is still alive.
+ *
+ * @param lockPath - Path to existing lock file
+ * @param file - Lock file type for retry
+ * @returns True if lock was acquired after removing stale lock, false if active lock exists
+ */
+function handleExistingLock(lockPath, file) {
+    const lockPid = readLockPid(lockPath);
+    if (lockPid !== null && isProcessAlive(lockPid)) {
+        return false;
+    }
+    if (!removeStaleLock(lockPath)) {
+        return false;
+    }
+    return acquireLock(file);
+}
+/**
+ * Acquire a lock file atomically.
+ *
+ * Uses exclusive file creation (wx flag) to ensure only one process can hold the lock.
+ * If lock exists but owner process is dead, automatically removes stale lock and retries.
+ *
+ * @param file - Lock file type to acquire
+ * @returns True if lock was acquired, false if another process holds it
+ */
+function acquireLock(file) {
+    ensureSessionDir();
+    const lockPath = getSessionFilePath(file);
+    try {
+        fs.writeFileSync(lockPath, process.pid.toString(), { flag: 'wx' });
+        return true;
+    }
+    catch (error) {
+        if (isErrnoException(error) && error.code === 'EEXIST') {
+            return handleExistingLock(lockPath, file);
+        }
+        return false;
+    }
+}
+/**
+ * Release a lock file.
+ *
+ * @param file - Lock file type to release
+ */
+function releaseLock(file) {
+    const lockPath = getSessionFilePath(file);
+    try {
+        fs.rmSync(lockPath, { force: true });
+    }
+    catch (error) {
+        log.debug(`Failed to release lock file ${file}: ${getErrorMessage(error)}`);
+    }
+}
 /**
  * Acquire session lock atomically.
  *
@@ -24,42 +121,7 @@ import { isProcessAlive } from './process.js';
  * ```
  */
 export function acquireSessionLock() {
-    ensureSessionDir();
-    const lockPath = getSessionFilePath('LOCK');
-    try {
-        // 'wx' flag creates file exclusively - fails if exists
-        fs.writeFileSync(lockPath, process.pid.toString(), { flag: 'wx' });
-        return true;
-    }
-    catch (error) {
-        if (error instanceof Error && 'code' in error && error.code === 'EEXIST') {
-            // Lock file exists - check if process is still alive
-            try {
-                const lockPidStr = fs.readFileSync(lockPath, 'utf-8').trim();
-                const lockPid = parseInt(lockPidStr, 10);
-                if (!isNaN(lockPid) && isProcessAlive(lockPid)) {
-                    // Lock is held by active process
-                    return false;
-                }
-                else {
-                    // Stale lock file - remove it and try again
-                    fs.unlinkSync(lockPath);
-                    return acquireSessionLock();
-                }
-            }
-            catch {
-                // Can't read lock file - assume it's stale
-                try {
-                    fs.unlinkSync(lockPath);
-                    return acquireSessionLock();
-                }
-                catch {
-                    return false;
-                }
-            }
-        }
-        return false;
-    }
+    return acquireLock('LOCK');
 }
 /**
  * Release session lock.
@@ -68,15 +130,7 @@ export function acquireSessionLock() {
  * Safe to call multiple times (idempotent).
  */
 export function releaseSessionLock() {
-    const lockPath = getSessionFilePath('LOCK');
-    try {
-        if (fs.existsSync(lockPath)) {
-            fs.unlinkSync(lockPath);
-        }
-    }
-    catch {
-        // Ignore errors during cleanup
-    }
+    releaseLock('LOCK');
 }
 /**
  * Acquire daemon lock atomically.
@@ -97,42 +151,7 @@ export function releaseSessionLock() {
  * ```
  */
 export function acquireDaemonLock() {
-    ensureSessionDir();
-    const lockPath = getSessionFilePath('DAEMON_LOCK');
-    try {
-        // 'wx' flag creates file exclusively - fails if exists
-        fs.writeFileSync(lockPath, process.pid.toString(), { flag: 'wx' });
-        return true;
-    }
-    catch (error) {
-        if (error instanceof Error && 'code' in error && error.code === 'EEXIST') {
-            // Lock file exists - check if process is still alive
-            try {
-                const lockPidStr = fs.readFileSync(lockPath, 'utf-8').trim();
-                const lockPid = parseInt(lockPidStr, 10);
-                if (!isNaN(lockPid) && isProcessAlive(lockPid)) {
-                    // Lock is held by active process
-                    return false;
-                }
-                else {
-                    // Stale lock file - remove it and try again
-                    fs.unlinkSync(lockPath);
-                    return acquireDaemonLock();
-                }
-            }
-            catch {
-                // Can't read lock file - assume it's stale
-                try {
-                    fs.unlinkSync(lockPath);
-                    return acquireDaemonLock();
-                }
-                catch {
-                    return false;
-                }
-            }
-        }
-        return false;
-    }
+    return acquireLock('DAEMON_LOCK');
 }
 /**
  * Release daemon lock.
@@ -141,14 +160,6 @@ export function acquireDaemonLock() {
  * Safe to call multiple times (idempotent).
  */
 export function releaseDaemonLock() {
-    const lockPath = getSessionFilePath('DAEMON_LOCK');
-    try {
-        if (fs.existsSync(lockPath)) {
-            fs.unlinkSync(lockPath);
-        }
-    }
-    catch {
-        // Ignore errors during cleanup
-    }
+    releaseLock('DAEMON_LOCK');
 }
 //# sourceMappingURL=lock.js.map

package/dist/session/lock.js.map

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

package/dist/session/metadata.d.ts

@@ -17,6 +17,15 @@ export interface SessionMetadata {
     webSocketDebuggerUrl?: string | undefined;
     activeTelemetry?: TelemetryType[] | undefined;
 }
+/**
+ * Options for reading session metadata.
+ */
+export interface ReadSessionMetadataOptions {
+    /** Log a warning when metadata cannot be parsed */
+    warnOnCorruption?: boolean;
+    /** Delete corrupted metadata file to self-heal for subsequent runs */
+    selfHealOnCorruption?: boolean;
+}
 /**
  * Write session metadata atomically.
  *
@@ -53,7 +62,5 @@ export declare function writeSessionMetadata(metadata: SessionMetadata): void;
  * }
  * ```
  */
-export declare function readSessionMetadata(options?: {
-    warnOnCorruption?: boolean;
-}): SessionMetadata | null;
+export declare function readSessionMetadata(options?: ReadSessionMetadataOptions): SessionMetadata | null;
 //# sourceMappingURL=metadata.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/session/metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAS7C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,eAAe,CAAC,EAAE,aAAa,EAAE,GAAG,SAAS,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAIpE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE;IAC5C,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,GAAG,eAAe,GAAG,IAAI,CAkBzB"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/session/metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAQ7C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,eAAe,CAAC,EAAE,aAAa,EAAE,GAAG,SAAS,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AA6BD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAIpE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,eAAe,GAAG,IAAI,CAchG"}

package/dist/session/metadata.js

@@ -5,11 +5,33 @@
  * WHY: Metadata persistence enables `bdg status` and other commands to inspect active sessions.
  */
 import * as fs from 'fs';
-import { getErrorMessage } from '../ui/errors/index.js';
+import { getErrorMessage } from '../connection/errors.js';
 import { createLogger } from '../ui/logging/index.js';
 import { AtomicFileWriter } from '../utils/atomicFile.js';
 import { getSessionFilePath, ensureSessionDir } from './paths.js';
 const log = createLogger('session');
+/**
+ * Handle corrupted metadata file.
+ *
+ * @param metaPath - Path to metadata file
+ * @param error - Error that occurred during parsing
+ * @param options - Error handling options
+ */
+function handleCorruptedMetadata(metaPath, error, options) {
+    if (options?.warnOnCorruption) {
+        log.info(`Session metadata corrupted (cannot read details): ${getErrorMessage(error)}`);
+        log.info('Troubleshooting: Run "bdg cleanup" to remove corrupted files');
+    }
+    if (options?.selfHealOnCorruption) {
+        try {
+            fs.rmSync(metaPath, { force: true });
+            log.info('Removed corrupted session metadata file');
+        }
+        catch (deleteError) {
+            log.debug(`Failed to remove corrupted metadata: ${getErrorMessage(deleteError)}`);
+        }
+    }
+}
 /**
  * Write session metadata atomically.
  *
@@ -60,11 +82,7 @@ export function readSessionMetadata(options) {
         return JSON.parse(content);
     }
     catch (error) {
-        // P1 Fix #2: Warn when metadata is corrupted
-        if (options?.warnOnCorruption) {
-            log(`Session metadata corrupted (cannot read details): ${getErrorMessage(error)}`);
-            log('Troubleshooting: Run "bdg cleanup" to remove corrupted files');
-        }
+        handleCorruptedMetadata(metaPath, error, options);
         return null;
     }
 }