@jacques-ai/server 0.0.7-alpha.1

package/dist/session/process-monitor.js

@@ -0,0 +1,270 @@
+/**
+ * Process Monitor
+ *
+ * Handles process verification, bypass detection, and PID management.
+ * Extracted from SessionRegistry to separate process-level concerns
+ * from session state management.
+ */
+import { createLogger } from '../logging/logger-factory.js';
+import { IDLE_TIMEOUT_MS, PROCESS_VERIFY_INTERVAL_MS, } from '../connection/constants.js';
+import { extractPid } from '../connection/terminal-key.js';
+import { isProcessRunning, isProcessBypass, getClaudeProcesses } from '../connection/process-detection.js';
+/** Grace period for newly registered sessions before considering them dead (ms) */
+const NEW_SESSION_GRACE_MS = 60_000; // 60 seconds
+export class ProcessMonitor {
+    callbacks;
+    processVerifyInterval = null;
+    logger;
+    // CWDs where a session was launched with --dangerously-skip-permissions
+    pendingBypassCwds = new Set();
+    constructor(options) {
+        this.callbacks = options.callbacks;
+        this.logger = options.logger ?? createLogger({ silent: true });
+    }
+    get log() { return this.logger.log.bind(this.logger); }
+    get warn() { return this.logger.warn.bind(this.logger); }
+    /**
+     * Get PID for a session from any available source.
+     * Priority: terminal_key → session.terminal.terminal_pid
+     */
+    getSessionPid(session) {
+        const keyPid = extractPid(session.terminal_key);
+        if (keyPid !== null) {
+            return keyPid;
+        }
+        if (session.terminal?.terminal_pid) {
+            return session.terminal.terminal_pid;
+        }
+        return null;
+    }
+    /**
+     * Store terminal_pid on a session if not already known.
+     * When a PID is first stored, checks if the process is running with
+     * --dangerously-skip-permissions and marks the session accordingly.
+     */
+    storeTerminalPid(session, terminalPid) {
+        if (!terminalPid || terminalPid <= 0)
+            return;
+        const existingPid = this.getSessionPid(session);
+        if (existingPid === null) {
+            if (!session.terminal) {
+                session.terminal = {
+                    tty: null,
+                    terminal_pid: terminalPid,
+                    term_program: null,
+                    iterm_session_id: null,
+                    term_session_id: null,
+                    kitty_window_id: null,
+                    wezterm_pane: null,
+                    vscode_injection: null,
+                    windowid: null,
+                    term: null,
+                };
+            }
+            else if (!session.terminal.terminal_pid) {
+                session.terminal.terminal_pid = terminalPid;
+            }
+            this.log(`[Registry] Stored terminal_pid ${terminalPid} for session ${session.session_id}`);
+        }
+        // Now check if this process is bypass (async, non-blocking)
+        if (!session.is_bypass) {
+            isProcessBypass(terminalPid).then((bypass) => {
+                if (bypass) {
+                    session.is_bypass = true;
+                    this.log(`[Registry] Detected bypass from stored PID ${terminalPid} for session ${session.session_id}`);
+                }
+            }).catch(() => { });
+        }
+    }
+    /**
+     * Verify sessions are still valid:
+     * 1. Process is still running (checks all PID sources)
+     * 2. CWD is not in Trash
+     * 3. Session is not idle beyond timeout
+     * 4. PID-less sessions cross-referenced against running Claude processes
+     */
+    async verifyProcesses() {
+        const sessionsToRemove = [];
+        const pidlessSessions = [];
+        const now = Date.now();
+        for (const [id, session] of this.callbacks.getAllSessions()) {
+            // 1. Check if process is still running
+            const pid = this.getSessionPid(session);
+            if (pid !== null) {
+                const isRunning = await isProcessRunning(pid);
+                if (!isRunning) {
+                    this.log(`[Registry] Process ${pid} no longer running for session ${id}`);
+                    sessionsToRemove.push(id);
+                    continue;
+                }
+            }
+            else {
+                // Track PID-less sessions for batch process scan
+                pidlessSessions.push([id, session]);
+            }
+            // 2. Check if CWD is in Trash
+            if (session.cwd && session.cwd.includes('.Trash')) {
+                this.log(`[Registry] CWD in Trash for session ${id}: ${session.cwd}`);
+                sessionsToRemove.push(id);
+                continue;
+            }
+            // 3. Check for idle timeout
+            if (now - session.last_activity > IDLE_TIMEOUT_MS) {
+                const hoursIdle = ((now - session.last_activity) / (1000 * 60 * 60)).toFixed(1);
+                this.log(`[Registry] Session ${id} idle for ${hoursIdle}h, marking as stale`);
+                sessionsToRemove.push(id);
+                continue;
+            }
+        }
+        // 4. Process re-scan for PID-less sessions
+        if (pidlessSessions.length > 0) {
+            const removeSet = new Set(sessionsToRemove);
+            const remainingPidless = pidlessSessions.filter(([id]) => !removeSet.has(id));
+            if (remainingPidless.length > 0) {
+                await this.verifyPidlessSessions(remainingPidless, sessionsToRemove, now);
+            }
+        }
+        for (const id of sessionsToRemove) {
+            this.log(`[Registry] Removing stale/dead session: ${id}`);
+            this.callbacks.removeSession(id);
+        }
+        if (sessionsToRemove.length > 0) {
+            this.log(`[Registry] Removed ${sessionsToRemove.length} stale/dead session(s)`);
+        }
+    }
+    /**
+     * Verify PID-less sessions by scanning running Claude processes.
+     *
+     * For sessions without a PID, we can't use `kill -0`. Instead:
+     * 1. Enumerate all running Claude processes
+     * 2. Exclude PIDs already claimed by verified-alive sessions
+     * 3. Match PID-less sessions to unclaimed processes by CWD
+     * 4. If matched: enrich session with PID for future fast verification
+     * 5. If unmatched: session is dead, mark for removal
+     */
+    async verifyPidlessSessions(pidlessSessions, sessionsToRemove, now) {
+        let processes;
+        try {
+            processes = await getClaudeProcesses();
+        }
+        catch (err) {
+            // If process enumeration fails, don't remove anything (fail-safe)
+            this.warn(`[Registry] Failed to enumerate Claude processes for PID-less verification: ${err}`);
+            return;
+        }
+        // Build set of PIDs already claimed by sessions WITH PIDs
+        const claimedPids = new Set();
+        for (const [, session] of this.callbacks.getAllSessions()) {
+            const pid = this.getSessionPid(session);
+            if (pid !== null) {
+                claimedPids.add(pid);
+            }
+        }
+        // Build pool of unclaimed processes, indexed by normalized CWD
+        const unclaimedByCwd = new Map();
+        for (const proc of processes) {
+            if (claimedPids.has(proc.pid))
+                continue;
+            const normalizedCwd = proc.cwd.replace(/\/+$/, '');
+            const existing = unclaimedByCwd.get(normalizedCwd) || [];
+            existing.push(proc);
+            unclaimedByCwd.set(normalizedCwd, existing);
+        }
+        for (const [id, session] of pidlessSessions) {
+            // Grace period: skip sessions registered less than 60s ago
+            if (now - session.registered_at < NEW_SESSION_GRACE_MS) {
+                this.log(`[Registry] Skipping PID-less session ${id} (within grace period)`);
+                continue;
+            }
+            const sessionCwd = (session.cwd || '').replace(/\/+$/, '');
+            const candidates = unclaimedByCwd.get(sessionCwd);
+            if (candidates && candidates.length > 0) {
+                // Match found — claim the first unclaimed process and enrich with PID
+                const matched = candidates.shift();
+                if (candidates.length === 0) {
+                    unclaimedByCwd.delete(sessionCwd);
+                }
+                this.storeTerminalPid(session, matched.pid);
+                claimedPids.add(matched.pid);
+                this.log(`[Registry] Enriched PID-less session ${id} with PID ${matched.pid} (matched by CWD: ${sessionCwd})`);
+            }
+            else {
+                // No matching Claude process — session is dead
+                this.log(`[Registry] No matching Claude process for PID-less session ${id} (CWD: ${sessionCwd})`);
+                sessionsToRemove.push(id);
+            }
+        }
+    }
+    /**
+     * Detect bypass sessions by checking each session's actual process command line.
+     */
+    async detectBypassSessions() {
+        const updated = [];
+        for (const [id, session] of this.callbacks.getAllSessions()) {
+            if (session.is_bypass)
+                continue;
+            const pid = this.getSessionPid(session);
+            if (pid === null)
+                continue;
+            const bypass = await isProcessBypass(pid);
+            if (bypass) {
+                session.is_bypass = true;
+                updated.push(id);
+                this.log(`[Registry] Detected bypass from PID ${pid} for session ${id}`);
+            }
+        }
+        return updated;
+    }
+    /**
+     * Start periodic process verification.
+     */
+    startProcessVerification(intervalMs = PROCESS_VERIFY_INTERVAL_MS) {
+        if (this.processVerifyInterval) {
+            return;
+        }
+        // Run immediately on start
+        this.verifyProcesses().catch((err) => {
+            this.warn(`[Registry] Process verification failed: ${err}`);
+        });
+        // Then run periodically
+        this.processVerifyInterval = setInterval(() => {
+            this.verifyProcesses().catch((err) => {
+                this.warn(`[Registry] Process verification failed: ${err}`);
+            });
+        }, intervalMs);
+        this.log(`[Registry] Process verification started (interval: ${intervalMs / 1000}s)`);
+    }
+    /**
+     * Stop process verification interval.
+     */
+    stopProcessVerification() {
+        if (this.processVerifyInterval) {
+            clearInterval(this.processVerifyInterval);
+            this.processVerifyInterval = null;
+        }
+    }
+    /**
+     * Mark a CWD as expecting a bypass session.
+     * Auto-expires after 60s.
+     */
+    markPendingBypass(cwd) {
+        const normalized = cwd.replace(/\/+$/, '');
+        this.pendingBypassCwds.add(normalized);
+        this.log(`[Registry] Marked pending bypass for: ${normalized}`);
+        setTimeout(() => {
+            this.pendingBypassCwds.delete(normalized);
+        }, 60_000);
+    }
+    /**
+     * Check if a CWD has a pending bypass flag, and consume it if so.
+     */
+    consumePendingBypass(cwd) {
+        const normalized = cwd.replace(/\/+$/, '');
+        if (this.pendingBypassCwds.has(normalized)) {
+            this.pendingBypassCwds.delete(normalized);
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=process-monitor.js.map

package/dist/session/process-monitor.js.map

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

package/dist/session/process-monitor.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Process Monitor Tests
+ */
+export {};
+//# sourceMappingURL=process-monitor.test.d.ts.map

package/dist/session/process-monitor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-monitor.test.d.ts","sourceRoot":"","sources":["../../src/session/process-monitor.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/session/process-monitor.test.js

@@ -0,0 +1,367 @@
+/**
+ * Process Monitor Tests
+ */
+import { jest } from '@jest/globals';
+// Mock process-detection module before importing the module under test
+const mockIsProcessRunning = jest.fn();
+const mockIsProcessBypass = jest.fn();
+const mockGetClaudeProcesses = jest.fn();
+jest.unstable_mockModule('../connection/process-detection.js', () => ({
+    isProcessRunning: mockIsProcessRunning,
+    isProcessBypass: mockIsProcessBypass,
+    getClaudeProcesses: mockGetClaudeProcesses,
+}));
+// Import after mocking
+const { ProcessMonitor } = await import('./process-monitor.js');
+import { createLogger } from '../logging/logger-factory.js';
+function makeSession(overrides) {
+    return {
+        source: 'claude_code',
+        session_title: null,
+        transcript_path: null,
+        cwd: '/test',
+        project: 'test',
+        model: null,
+        workspace: null,
+        terminal: null,
+        terminal_key: 'TTY:/dev/ttys001',
+        status: 'active',
+        last_activity: Date.now(),
+        registered_at: Date.now(),
+        context_metrics: null,
+        autocompact: null,
+        last_tool_name: null,
+        ...overrides,
+    };
+}
+describe('ProcessMonitor', () => {
+    let monitor;
+    let sessions;
+    let removedSessionIds;
+    const silentLogger = createLogger({ silent: true });
+    beforeEach(() => {
+        sessions = new Map();
+        removedSessionIds = [];
+        jest.clearAllMocks();
+        mockGetClaudeProcesses.mockResolvedValue([]);
+        const callbacks = {
+            getSession: (id) => sessions.get(id),
+            getAllSessions: () => Array.from(sessions.entries()),
+            removeSession: (id) => {
+                sessions.delete(id);
+                removedSessionIds.push(id);
+            },
+        };
+        monitor = new ProcessMonitor({ callbacks, logger: silentLogger });
+    });
+    describe('getSessionPid', () => {
+        it('should extract PID from DISCOVERED:PID: key', () => {
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'DISCOVERED:PID:12345',
+            });
+            expect(monitor.getSessionPid(session)).toBe(12345);
+        });
+        it('should extract PID from DISCOVERED:TTY: key', () => {
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'DISCOVERED:TTY:ttys001:67890',
+            });
+            expect(monitor.getSessionPid(session)).toBe(67890);
+        });
+        it('should fall back to terminal.terminal_pid', () => {
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'TTY:/dev/ttys001',
+                terminal: {
+                    tty: '/dev/ttys001',
+                    terminal_pid: 99999,
+                    term_program: null,
+                    iterm_session_id: null,
+                    term_session_id: null,
+                    kitty_window_id: null,
+                    wezterm_pane: null,
+                    vscode_injection: null,
+                    windowid: null,
+                    term: null,
+                },
+            });
+            expect(monitor.getSessionPid(session)).toBe(99999);
+        });
+        it('should return null when no PID available', () => {
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'AUTO:some-uuid',
+            });
+            expect(monitor.getSessionPid(session)).toBeNull();
+        });
+    });
+    describe('storeTerminalPid', () => {
+        it('should create terminal object when none exists', () => {
+            mockIsProcessBypass.mockResolvedValue(false);
+            const session = makeSession({ session_id: 's1', terminal_key: 'AUTO:uuid' });
+            monitor.storeTerminalPid(session, 12345);
+            expect(session.terminal).not.toBeNull();
+            expect(session.terminal.terminal_pid).toBe(12345);
+        });
+        it('should set terminal_pid on existing terminal object', () => {
+            mockIsProcessBypass.mockResolvedValue(false);
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'AUTO:uuid',
+                terminal: {
+                    tty: '/dev/ttys001',
+                    terminal_pid: 0,
+                    term_program: 'iTerm2',
+                    iterm_session_id: null,
+                    term_session_id: null,
+                    kitty_window_id: null,
+                    wezterm_pane: null,
+                    vscode_injection: null,
+                    windowid: null,
+                    term: null,
+                },
+            });
+            monitor.storeTerminalPid(session, 54321);
+            expect(session.terminal.terminal_pid).toBe(54321);
+        });
+        it('should not overwrite existing PID', () => {
+            mockIsProcessBypass.mockResolvedValue(false);
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'DISCOVERED:PID:11111',
+            });
+            monitor.storeTerminalPid(session, 22222);
+            // PID comes from terminal_key, should not create terminal object
+            expect(session.terminal).toBeNull();
+        });
+        it('should skip invalid PIDs', () => {
+            const session = makeSession({ session_id: 's1', terminal_key: 'AUTO:uuid' });
+            monitor.storeTerminalPid(session, 0);
+            monitor.storeTerminalPid(session, -1);
+            expect(session.terminal).toBeNull();
+        });
+    });
+    describe('verifyProcesses', () => {
+        it('should remove sessions with dead processes', async () => {
+            mockIsProcessRunning.mockResolvedValue(false);
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'DISCOVERED:PID:12345',
+            });
+            sessions.set('s1', session);
+            await monitor.verifyProcesses();
+            expect(removedSessionIds).toContain('s1');
+        });
+        it('should keep sessions with running processes', async () => {
+            mockIsProcessRunning.mockResolvedValue(true);
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'DISCOVERED:PID:12345',
+            });
+            sessions.set('s1', session);
+            await monitor.verifyProcesses();
+            expect(removedSessionIds).toHaveLength(0);
+        });
+        it('should remove sessions with CWD in Trash', async () => {
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'AUTO:uuid',
+                cwd: '/Users/test/.Trash/old-project',
+            });
+            sessions.set('s1', session);
+            await monitor.verifyProcesses();
+            expect(removedSessionIds).toContain('s1');
+        });
+        it('should remove sessions idle beyond timeout', async () => {
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'AUTO:uuid',
+                last_activity: Date.now() - (5 * 60 * 60 * 1000), // 5 hours ago
+            });
+            sessions.set('s1', session);
+            await monitor.verifyProcesses();
+            expect(removedSessionIds).toContain('s1');
+        });
+        it('should not remove recently active sessions without PID', async () => {
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'AUTO:uuid',
+                last_activity: Date.now(),
+            });
+            sessions.set('s1', session);
+            await monitor.verifyProcesses();
+            expect(removedSessionIds).toHaveLength(0);
+        });
+    });
+    describe('detectBypassSessions', () => {
+        it('should mark sessions as bypass when process has flag', async () => {
+            mockIsProcessBypass.mockResolvedValue(true);
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'DISCOVERED:PID:12345',
+            });
+            sessions.set('s1', session);
+            const updated = await monitor.detectBypassSessions();
+            expect(updated).toContain('s1');
+            expect(session.is_bypass).toBe(true);
+        });
+        it('should skip already-bypass sessions', async () => {
+            mockIsProcessBypass.mockResolvedValue(true);
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'DISCOVERED:PID:12345',
+                is_bypass: true,
+            });
+            sessions.set('s1', session);
+            const updated = await monitor.detectBypassSessions();
+            expect(updated).toHaveLength(0);
+            expect(mockIsProcessBypass).not.toHaveBeenCalled();
+        });
+        it('should skip sessions without PID', async () => {
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'AUTO:uuid',
+            });
+            sessions.set('s1', session);
+            const updated = await monitor.detectBypassSessions();
+            expect(updated).toHaveLength(0);
+            expect(mockIsProcessBypass).not.toHaveBeenCalled();
+        });
+    });
+    describe('verifyProcesses - PID-less session verification', () => {
+        it('should remove PID-less session when no Claude processes running', async () => {
+            mockGetClaudeProcesses.mockResolvedValue([]);
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'AUTO:some-uuid',
+                cwd: '/Users/test/project',
+                registered_at: Date.now() - 120_000, // 2 min ago, past grace period
+            });
+            sessions.set('s1', session);
+            await monitor.verifyProcesses();
+            expect(removedSessionIds).toContain('s1');
+            expect(mockGetClaudeProcesses).toHaveBeenCalledTimes(1);
+        });
+        it('should keep PID-less session when matching process found by CWD', async () => {
+            mockIsProcessBypass.mockResolvedValue(false);
+            mockGetClaudeProcesses.mockResolvedValue([
+                { pid: 55555, tty: 'ttys001', cwd: '/Users/test/project' },
+            ]);
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'AUTO:some-uuid',
+                cwd: '/Users/test/project',
+                registered_at: Date.now() - 120_000,
+            });
+            sessions.set('s1', session);
+            await monitor.verifyProcesses();
+            expect(removedSessionIds).toHaveLength(0);
+            // Verify PID was enriched
+            expect(monitor.getSessionPid(session)).toBe(55555);
+        });
+        it('should not remove PID-less session within grace period', async () => {
+            mockGetClaudeProcesses.mockResolvedValue([]); // No matching processes
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'AUTO:some-uuid',
+                cwd: '/Users/test/project',
+                registered_at: Date.now() - 10_000, // 10s ago, within grace period
+            });
+            sessions.set('s1', session);
+            await monitor.verifyProcesses();
+            expect(removedSessionIds).toHaveLength(0);
+        });
+        it('should not claim processes already owned by PID-bearing sessions', async () => {
+            mockIsProcessRunning.mockResolvedValue(true);
+            mockGetClaudeProcesses.mockResolvedValue([
+                { pid: 11111, tty: 'ttys001', cwd: '/Users/test/project' },
+            ]);
+            // Session with PID (already claims PID 11111)
+            const sessionWithPid = makeSession({
+                session_id: 's1',
+                terminal_key: 'DISCOVERED:PID:11111',
+                cwd: '/Users/test/project',
+            });
+            // PID-less session in same CWD
+            const sessionWithoutPid = makeSession({
+                session_id: 's2',
+                terminal_key: 'AUTO:uuid2',
+                cwd: '/Users/test/project',
+                registered_at: Date.now() - 120_000,
+            });
+            sessions.set('s1', sessionWithPid);
+            sessions.set('s2', sessionWithoutPid);
+            await monitor.verifyProcesses();
+            // s2 should be removed because the only process (PID 11111) is claimed by s1
+            expect(removedSessionIds).toContain('s2');
+            expect(removedSessionIds).not.toContain('s1');
+        });
+        it('should handle getClaudeProcesses failure gracefully', async () => {
+            mockGetClaudeProcesses.mockRejectedValue(new Error('pgrep failed'));
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'AUTO:some-uuid',
+                cwd: '/Users/test/project',
+                registered_at: Date.now() - 120_000,
+            });
+            sessions.set('s1', session);
+            await monitor.verifyProcesses();
+            // Should NOT remove the session (fail-safe)
+            expect(removedSessionIds).toHaveLength(0);
+        });
+        it('should match multiple PID-less sessions to multiple processes in same CWD', async () => {
+            mockIsProcessBypass.mockResolvedValue(false);
+            mockGetClaudeProcesses.mockResolvedValue([
+                { pid: 111, tty: 'ttys001', cwd: '/Users/test/project' },
+                { pid: 222, tty: 'ttys002', cwd: '/Users/test/project' },
+            ]);
+            const s1 = makeSession({
+                session_id: 's1',
+                terminal_key: 'AUTO:uuid1',
+                cwd: '/Users/test/project',
+                registered_at: Date.now() - 120_000,
+            });
+            const s2 = makeSession({
+                session_id: 's2',
+                terminal_key: 'AUTO:uuid2',
+                cwd: '/Users/test/project',
+                registered_at: Date.now() - 120_000,
+            });
+            sessions.set('s1', s1);
+            sessions.set('s2', s2);
+            await monitor.verifyProcesses();
+            expect(removedSessionIds).toHaveLength(0);
+            // Both sessions should be enriched with PIDs
+            expect(monitor.getSessionPid(s1)).not.toBeNull();
+            expect(monitor.getSessionPid(s2)).not.toBeNull();
+        });
+        it('should skip process scan when no PID-less sessions exist', async () => {
+            mockIsProcessRunning.mockResolvedValue(true);
+            const session = makeSession({
+                session_id: 's1',
+                terminal_key: 'DISCOVERED:PID:12345',
+            });
+            sessions.set('s1', session);
+            await monitor.verifyProcesses();
+            expect(mockGetClaudeProcesses).not.toHaveBeenCalled();
+        });
+    });
+    describe('pendingBypass', () => {
+        it('should consume pending bypass for matching CWD', () => {
+            monitor.markPendingBypass('/Users/test/project');
+            expect(monitor.consumePendingBypass('/Users/test/project')).toBe(true);
+            // Second consume should return false (already consumed)
+            expect(monitor.consumePendingBypass('/Users/test/project')).toBe(false);
+        });
+        it('should normalize trailing slashes', () => {
+            monitor.markPendingBypass('/Users/test/project/');
+            expect(monitor.consumePendingBypass('/Users/test/project')).toBe(true);
+        });
+        it('should return false for non-matching CWD', () => {
+            monitor.markPendingBypass('/Users/test/project-a');
+            expect(monitor.consumePendingBypass('/Users/test/project-b')).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=process-monitor.test.js.map