aicodeman 0.2.8

package/dist/session-lifecycle-log.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Append-only JSONL audit log for session lifecycle events.
+ *
+ * Records every session creation, start, exit, deletion, recovery, and server
+ * start/stop to ~/.codeman/session-lifecycle.jsonl. Survives server restarts
+ * (unlike RunSummary which is in-memory only).
+ *
+ * @module session-lifecycle-log
+ */
+import type { LifecycleEventType, LifecycleEntry } from './types.js';
+export declare class SessionLifecycleLog {
+    private filePath;
+    private writeQueue;
+    constructor(filePath?: string);
+    /**
+     * Append a lifecycle event. Fire-and-forget — errors are logged but never thrown.
+     */
+    log(entry: Omit<LifecycleEntry, 'ts'> & {
+        ts?: number;
+    }): void;
+    /**
+     * Query the log file with optional filters.
+     */
+    query(opts?: {
+        sessionId?: string;
+        event?: LifecycleEventType;
+        since?: number;
+        limit?: number;
+    }): Promise<LifecycleEntry[]>;
+    /**
+     * Trim the log file if it exceeds MAX_LINES. Called on server start.
+     */
+    trimIfNeeded(): Promise<void>;
+}
+export declare function getLifecycleLog(filePath?: string): SessionLifecycleLog;
+//# sourceMappingURL=session-lifecycle-log.d.ts.map

package/dist/session-lifecycle-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lifecycle-log.d.ts","sourceRoot":"","sources":["../src/session-lifecycle-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKrE,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAoC;gBAE1C,QAAQ,CAAC,EAAE,MAAM;IAQ7B;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAU9D;;OAEG;IACG,KAAK,CAAC,IAAI,CAAC,EAAE;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,kBAAkB,CAAC;QAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAgC7B;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CAgBpC;AAKD,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAKtE"}

package/dist/session-lifecycle-log.js

@@ -0,0 +1,101 @@
+/**
+ * @fileoverview Append-only JSONL audit log for session lifecycle events.
+ *
+ * Records every session creation, start, exit, deletion, recovery, and server
+ * start/stop to ~/.codeman/session-lifecycle.jsonl. Survives server restarts
+ * (unlike RunSummary which is in-memory only).
+ *
+ * @module session-lifecycle-log
+ */
+import { appendFile, readFile, writeFile } from 'node:fs/promises';
+import { existsSync, mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+const MAX_LINES = 10_000;
+const TRIM_TO = 8_000;
+export class SessionLifecycleLog {
+    filePath;
+    writeQueue = Promise.resolve();
+    constructor(filePath) {
+        this.filePath = filePath || join(homedir(), '.codeman', 'session-lifecycle.jsonl');
+        const dir = dirname(this.filePath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true, mode: 0o700 });
+        }
+    }
+    /**
+     * Append a lifecycle event. Fire-and-forget — errors are logged but never thrown.
+     */
+    log(entry) {
+        const line = JSON.stringify({ ts: Date.now(), ...entry }) + '\n';
+        // Chain writes to prevent interleaving
+        this.writeQueue = this.writeQueue
+            .then(() => appendFile(this.filePath, line, 'utf-8'))
+            .catch((err) => {
+            console.error('[LifecycleLog] Failed to write:', err);
+        });
+    }
+    /**
+     * Query the log file with optional filters.
+     */
+    async query(opts) {
+        const limit = opts?.limit ?? 200;
+        let raw;
+        try {
+            raw = await readFile(this.filePath, 'utf-8');
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return [];
+            throw err;
+        }
+        const lines = raw.trim().split('\n').filter(Boolean);
+        const entries = [];
+        // Parse in reverse (newest first) for efficiency with limit
+        for (let i = lines.length - 1; i >= 0 && entries.length < limit; i--) {
+            try {
+                const entry = JSON.parse(lines[i]);
+                if (opts?.sessionId && entry.sessionId !== opts.sessionId)
+                    continue;
+                if (opts?.event && entry.event !== opts.event)
+                    continue;
+                if (opts?.since && entry.ts < opts.since)
+                    continue;
+                entries.push(entry);
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+        return entries;
+    }
+    /**
+     * Trim the log file if it exceeds MAX_LINES. Called on server start.
+     */
+    async trimIfNeeded() {
+        let raw;
+        try {
+            raw = await readFile(this.filePath, 'utf-8');
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return;
+            throw err;
+        }
+        const lines = raw.trim().split('\n').filter(Boolean);
+        if (lines.length <= MAX_LINES)
+            return;
+        const trimmed = lines.slice(-TRIM_TO);
+        await writeFile(this.filePath, trimmed.join('\n') + '\n', 'utf-8');
+        console.log(`[LifecycleLog] Trimmed from ${lines.length} to ${trimmed.length} entries`);
+    }
+}
+// Singleton
+let instance = null;
+export function getLifecycleLog(filePath) {
+    if (!instance) {
+        instance = new SessionLifecycleLog(filePath);
+    }
+    return instance;
+}
+//# sourceMappingURL=session-lifecycle-log.js.map

package/dist/session-lifecycle-log.js.map

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

package/dist/session-manager.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @fileoverview Session Manager for coordinating multiple Claude sessions
+ *
+ * Provides lifecycle management for Claude CLI sessions:
+ * - Session creation with working directory configuration
+ * - Event forwarding from individual sessions
+ * - State persistence via StateStore
+ * - Concurrent session limits
+ *
+ * @module session-manager
+ */
+import { EventEmitter } from 'node:events';
+import { Session } from './session.js';
+import { SessionState } from './types.js';
+/**
+ * Events emitted by SessionManager
+ */
+export interface SessionManagerEvents {
+    /** Fired when a new session starts successfully */
+    sessionStarted: (session: Session) => void;
+    /** Fired when a session stops (graceful or forced) */
+    sessionStopped: (sessionId: string) => void;
+    /** Fired when a session encounters an error */
+    sessionError: (sessionId: string, error: string) => void;
+    /** Fired when a session produces terminal output */
+    sessionOutput: (sessionId: string, output: string) => void;
+    /** Fired when a completion phrase is detected */
+    sessionCompletion: (sessionId: string, phrase: string) => void;
+}
+export declare class SessionManager extends EventEmitter {
+    private sessions;
+    private sessionHandlers;
+    private store;
+    private _sessionCreationLock;
+    /**
+     * Creates a new SessionManager and loads previous session state.
+     */
+    constructor();
+    private loadFromStore;
+    /**
+     * Creates and starts a new Claude session.
+     * Uses mutex to prevent race conditions when multiple requests arrive simultaneously.
+     *
+     * @param workingDir - Working directory for the session
+     * @returns The newly created session
+     * @throws Error if max concurrent sessions limit reached
+     */
+    createSession(workingDir: string): Promise<Session>;
+    /**
+     * Stops a session by ID.
+     *
+     * @param id - Session ID to stop
+     */
+    stopSession(id: string): Promise<void>;
+    /**
+     * Stops all active sessions.
+     * Uses Promise.allSettled to ensure all sessions are stopped even if some fail.
+     */
+    stopAllSessions(): Promise<void>;
+    /**
+     * Gets a session by ID.
+     * @param id - Session ID
+     * @returns The session or undefined if not found
+     */
+    getSession(id: string): Session | undefined;
+    /** Gets all active sessions. */
+    getAllSessions(): Session[];
+    /** Gets all sessions currently idle (not processing). */
+    getIdleSessions(): Session[];
+    /** Gets all sessions currently busy (processing). */
+    getBusySessions(): Session[];
+    /** Gets the count of active sessions. */
+    getSessionCount(): number;
+    /** Checks if a session exists by ID. */
+    hasSession(id: string): boolean;
+    private updateSessionState;
+    /** Gets all sessions from persistent storage (including stopped). */
+    getStoredSessions(): Record<string, SessionState>;
+    /**
+     * Sends input to a session.
+     *
+     * @param sessionId - Session ID to send to
+     * @param input - Input string to send
+     * @throws Error if session not found
+     */
+    sendToSession(sessionId: string, input: string): Promise<void>;
+    /** Gets the output buffer for a session. */
+    getSessionOutput(sessionId: string): string | null;
+    /** Gets the error buffer for a session. */
+    getSessionError(sessionId: string): string | null;
+}
+/**
+ * Gets or creates the singleton SessionManager instance.
+ * @returns The global SessionManager
+ */
+export declare function getSessionManager(): SessionManager;
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,cAAc,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,sDAAsD;IACtD,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,+CAA+C;IAC/C,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,oDAAoD;IACpD,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,iDAAiD;IACjD,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAChE;AA4BD,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,eAAe,CAA2C;IAClE,OAAO,CAAC,KAAK,CAAc;IAG3B,OAAO,CAAC,oBAAoB,CAA8B;IAE1D;;OAEG;;IAMH,OAAO,CAAC,aAAa;IAarB;;;;;;;OAOG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqEzD;;;;OAIG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B5C;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtC;;;;OAIG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI3C,gCAAgC;IAChC,cAAc,IAAI,OAAO,EAAE;IAI3B,yDAAyD;IACzD,eAAe,IAAI,OAAO,EAAE;IAI5B,qDAAqD;IACrD,eAAe,IAAI,OAAO,EAAE;IAI5B,yCAAyC;IACzC,eAAe,IAAI,MAAM;IAIzB,wCAAwC;IACxC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B,OAAO,CAAC,kBAAkB;IAI1B,qEAAqE;IACrE,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAIjD;;;;;;OAMG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpE,4CAA4C;IAC5C,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKlD,2CAA2C;IAC3C,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAIlD;AAKD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD"}

package/dist/session-manager.js

@@ -0,0 +1,224 @@
+/**
+ * @fileoverview Session Manager for coordinating multiple Claude sessions
+ *
+ * Provides lifecycle management for Claude CLI sessions:
+ * - Session creation with working directory configuration
+ * - Event forwarding from individual sessions
+ * - State persistence via StateStore
+ * - Concurrent session limits
+ *
+ * @module session-manager
+ */
+import { EventEmitter } from 'node:events';
+import { Session } from './session.js';
+import { getStore } from './state-store.js';
+export class SessionManager extends EventEmitter {
+    sessions = new Map();
+    sessionHandlers = new Map();
+    store = getStore();
+    // Mutex for session creation to prevent race conditions
+    _sessionCreationLock = null;
+    /**
+     * Creates a new SessionManager and loads previous session state.
+     */
+    constructor() {
+        super();
+        this.loadFromStore();
+    }
+    loadFromStore() {
+        const storedSessions = this.store.getSessions();
+        // Note: We don't restore actual processes, just the state
+        // Dead sessions are marked as stopped
+        for (const [id, state] of Object.entries(storedSessions)) {
+            if (state.status !== 'stopped') {
+                state.status = 'stopped';
+                state.pid = null;
+                this.store.setSession(id, state);
+            }
+        }
+    }
+    /**
+     * Creates and starts a new Claude session.
+     * Uses mutex to prevent race conditions when multiple requests arrive simultaneously.
+     *
+     * @param workingDir - Working directory for the session
+     * @returns The newly created session
+     * @throws Error if max concurrent sessions limit reached
+     */
+    async createSession(workingDir) {
+        // Wait for any pending session creation to complete (mutex pattern)
+        while (this._sessionCreationLock) {
+            await this._sessionCreationLock;
+        }
+        // Create a new lock promise that others will wait on
+        // Define unlock first to ensure it's always in scope before promise assignment
+        let unlock;
+        const lockPromise = new Promise((resolve) => {
+            unlock = resolve;
+        });
+        this._sessionCreationLock = lockPromise;
+        try {
+            const config = this.store.getConfig();
+            // Check limit INSIDE the lock to prevent race conditions
+            if (this.sessions.size >= config.maxConcurrentSessions) {
+                throw new Error(`Maximum concurrent sessions (${config.maxConcurrentSessions}) reached`);
+            }
+            const session = new Session({ workingDir });
+            // Set up event forwarding with stored handlers for cleanup
+            const handlers = {
+                output: (data) => {
+                    this.emit('sessionOutput', session.id, data);
+                    this.updateSessionState(session);
+                },
+                error: (data) => {
+                    this.emit('sessionError', session.id, data);
+                    this.updateSessionState(session);
+                },
+                completion: (phrase) => {
+                    this.emit('sessionCompletion', session.id, phrase);
+                },
+                exit: () => {
+                    this.emit('sessionStopped', session.id);
+                    this.updateSessionState(session);
+                },
+                taskError: (taskId, error) => {
+                    this.emit('sessionTaskError', session.id, taskId, error);
+                },
+            };
+            session.on('output', handlers.output);
+            session.on('error', handlers.error);
+            session.on('completion', handlers.completion);
+            session.on('exit', handlers.exit);
+            session.on('taskError', handlers.taskError);
+            // Store handlers for later cleanup
+            this.sessionHandlers.set(session.id, handlers);
+            await session.start();
+            this.sessions.set(session.id, session);
+            this.store.setSession(session.id, session.toState());
+            this.emit('sessionStarted', session);
+            return session;
+        }
+        finally {
+            // Release the lock so other createSession calls can proceed
+            this._sessionCreationLock = null;
+            unlock();
+        }
+    }
+    /**
+     * Stops a session by ID.
+     *
+     * @param id - Session ID to stop
+     */
+    async stopSession(id) {
+        const session = this.sessions.get(id);
+        if (!session) {
+            // Update store to mark as stopped if it exists there
+            const storedSession = this.store.getSession(id);
+            if (storedSession) {
+                storedSession.status = 'stopped';
+                storedSession.pid = null;
+                this.store.setSession(id, storedSession);
+            }
+            return;
+        }
+        // Remove event listeners to prevent memory leaks
+        const handlers = this.sessionHandlers.get(id);
+        if (handlers) {
+            session.off('output', handlers.output);
+            session.off('error', handlers.error);
+            session.off('completion', handlers.completion);
+            session.off('exit', handlers.exit);
+            session.off('taskError', handlers.taskError);
+            this.sessionHandlers.delete(id);
+        }
+        await session.stop();
+        this.sessions.delete(id);
+        this.updateSessionState(session);
+    }
+    /**
+     * Stops all active sessions.
+     * Uses Promise.allSettled to ensure all sessions are stopped even if some fail.
+     */
+    async stopAllSessions() {
+        const stopPromises = Array.from(this.sessions.keys()).map((id) => this.stopSession(id));
+        const results = await Promise.allSettled(stopPromises);
+        // Log any failures but don't throw - best effort cleanup
+        for (const result of results) {
+            if (result.status === 'rejected') {
+                console.error('[SessionManager] Failed to stop session:', result.reason);
+            }
+        }
+    }
+    /**
+     * Gets a session by ID.
+     * @param id - Session ID
+     * @returns The session or undefined if not found
+     */
+    getSession(id) {
+        return this.sessions.get(id);
+    }
+    /** Gets all active sessions. */
+    getAllSessions() {
+        return Array.from(this.sessions.values());
+    }
+    /** Gets all sessions currently idle (not processing). */
+    getIdleSessions() {
+        return this.getAllSessions().filter((s) => s.isIdle());
+    }
+    /** Gets all sessions currently busy (processing). */
+    getBusySessions() {
+        return this.getAllSessions().filter((s) => s.isBusy());
+    }
+    /** Gets the count of active sessions. */
+    getSessionCount() {
+        return this.sessions.size;
+    }
+    /** Checks if a session exists by ID. */
+    hasSession(id) {
+        return this.sessions.has(id);
+    }
+    updateSessionState(session) {
+        this.store.setSession(session.id, session.toState());
+    }
+    /** Gets all sessions from persistent storage (including stopped). */
+    getStoredSessions() {
+        return this.store.getSessions();
+    }
+    /**
+     * Sends input to a session.
+     *
+     * @param sessionId - Session ID to send to
+     * @param input - Input string to send
+     * @throws Error if session not found
+     */
+    async sendToSession(sessionId, input) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        await session.sendInput(input);
+    }
+    /** Gets the output buffer for a session. */
+    getSessionOutput(sessionId) {
+        const session = this.sessions.get(sessionId);
+        return session?.getOutput() ?? null;
+    }
+    /** Gets the error buffer for a session. */
+    getSessionError(sessionId) {
+        const session = this.sessions.get(sessionId);
+        return session?.getError() ?? null;
+    }
+}
+// Singleton instance
+let managerInstance = null;
+/**
+ * Gets or creates the singleton SessionManager instance.
+ * @returns The global SessionManager
+ */
+export function getSessionManager() {
+    if (!managerInstance) {
+        managerInstance = new SessionManager();
+    }
+    return managerInstance;
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/session-manager.js.map

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