@skillsmith/core 0.5.5 → 0.5.6

package/dist/session/SessionHealthMonitor.js

@@ -0,0 +1,233 @@
+/**
+ * SMI-761: Session Health Monitoring
+ * SMI-1189: Refactored to use TypedEventEmitter
+ *
+ * Provides health monitoring for swarm sessions:
+ * - Heartbeat mechanism every 30 seconds
+ * - Automatic detection of stuck sessions
+ * - Session state recovery capabilities
+ * - Metrics for session health
+ */
+import { TypedEventEmitter } from './typed-event-emitter.js';
+import { MAX_RECOVERY_ATTEMPTS, DEFAULT_CONFIG, } from './health-types.js';
+import { calculateHealth, determineHealthStatus, hasStatusChanged } from './health-checks.js';
+import { recordSessionCount, recordRecoverySuccess, recordHealthStatusError, } from './metrics-collector.js';
+/**
+ * Session Health Monitor
+ *
+ * Tracks session health through heartbeats and detects stuck sessions.
+ */
+export class SessionHealthMonitor extends TypedEventEmitter {
+    config;
+    sessions = new Map();
+    checkInterval = null;
+    started = false;
+    constructor(config = {}) {
+        super();
+        this.config = {
+            heartbeatIntervalMs: config.heartbeatIntervalMs ?? DEFAULT_CONFIG.heartbeatIntervalMs,
+            warningThreshold: config.warningThreshold ?? DEFAULT_CONFIG.warningThreshold,
+            unhealthyThreshold: config.unhealthyThreshold ?? DEFAULT_CONFIG.unhealthyThreshold,
+            deadThreshold: config.deadThreshold ?? DEFAULT_CONFIG.deadThreshold,
+            autoRecover: config.autoRecover ?? DEFAULT_CONFIG.autoRecover,
+        };
+    }
+    /**
+     * Start monitoring a session
+     */
+    registerSession(session) {
+        const now = Date.now();
+        this.sessions.set(session.sessionId, {
+            sessionId: session.sessionId,
+            startedAt: now,
+            lastHeartbeat: now,
+            missedHeartbeats: 0,
+            status: 'healthy',
+            sessionData: session,
+            recoveryAttempts: 0,
+        });
+        recordSessionCount(this.sessions.size);
+    }
+    /**
+     * Record a heartbeat for a session
+     */
+    heartbeat(sessionId) {
+        const state = this.sessions.get(sessionId);
+        if (!state) {
+            return;
+        }
+        const wasUnhealthy = state.status !== 'healthy';
+        state.lastHeartbeat = Date.now();
+        state.missedHeartbeats = 0;
+        state.status = 'healthy';
+        this.emit('heartbeat', sessionId);
+        // If recovering from unhealthy state, emit recovered event
+        if (wasUnhealthy) {
+            this.emit('recovered', sessionId);
+        }
+    }
+    /**
+     * Stop monitoring a session
+     */
+    unregisterSession(sessionId) {
+        this.sessions.delete(sessionId);
+        recordSessionCount(this.sessions.size);
+    }
+    /**
+     * Get health status for a session
+     */
+    getSessionHealth(sessionId) {
+        const state = this.sessions.get(sessionId);
+        if (!state) {
+            return null;
+        }
+        return calculateHealth(state);
+    }
+    /**
+     * Get health status for all sessions
+     */
+    getAllSessionHealth() {
+        return Array.from(this.sessions.values()).map((state) => calculateHealth(state));
+    }
+    /**
+     * Start the health monitor
+     */
+    start() {
+        if (this.started) {
+            return;
+        }
+        this.started = true;
+        // Start health check interval (runs every heartbeat interval)
+        this.checkInterval = setInterval(() => {
+            this.checkAllSessions();
+        }, this.config.heartbeatIntervalMs);
+        // Don't prevent Node.js from exiting
+        this.checkInterval.unref();
+    }
+    /**
+     * Stop the health monitor
+     */
+    stop() {
+        if (!this.started) {
+            return;
+        }
+        this.started = false;
+        if (this.checkInterval) {
+            clearInterval(this.checkInterval);
+            this.checkInterval = null;
+        }
+    }
+    /**
+     * Check if the monitor is running
+     */
+    isRunning() {
+        return this.started;
+    }
+    /**
+     * Get the number of monitored sessions
+     */
+    getSessionCount() {
+        return this.sessions.size;
+    }
+    /**
+     * Attempt to recover a dead session from stored sessionData
+     *
+     * @param state - The session health state to recover
+     * @returns true if recovery was successful, false otherwise
+     */
+    attemptRecovery(state) {
+        // Check if we've exceeded max recovery attempts
+        if (state.recoveryAttempts >= MAX_RECOVERY_ATTEMPTS) {
+            this.emit('recovery-failed', state.sessionId, 'Max recovery attempts exceeded');
+            return false;
+        }
+        // Check if we have session data to restore from
+        if (!state.sessionData) {
+            this.emit('recovery-failed', state.sessionId, 'No session data available for recovery');
+            return false;
+        }
+        // Increment recovery attempts
+        state.recoveryAttempts++;
+        // Emit recovery attempt event
+        this.emit('recovery-attempt', state.sessionId, state.recoveryAttempts);
+        // Restore session health state from stored sessionData
+        // Reset the session to healthy state with a fresh heartbeat
+        const now = Date.now();
+        state.lastHeartbeat = now;
+        state.missedHeartbeats = 0;
+        state.status = 'healthy';
+        state.recoveryAttempts = 0; // Reset recovery attempts on success (SMI-769)
+        // Emit recovered event
+        this.emit('recovered', state.sessionId);
+        // Record successful recovery metric
+        recordRecoverySuccess();
+        return true;
+    }
+    /**
+     * Check all sessions for health issues
+     */
+    checkAllSessions() {
+        for (const state of this.sessions.values()) {
+            const previousStatus = state.status;
+            state.missedHeartbeats++;
+            // Determine new status based on missed heartbeats
+            state.status = determineHealthStatus(state.missedHeartbeats, this.config);
+            // Emit events on status change
+            if (hasStatusChanged(previousStatus, state.status)) {
+                const health = calculateHealth(state);
+                switch (state.status) {
+                    case 'warning':
+                        this.emit('warning', health);
+                        recordHealthStatusError(state.status);
+                        break;
+                    case 'unhealthy':
+                        this.emit('unhealthy', health);
+                        recordHealthStatusError(state.status);
+                        break;
+                    case 'dead':
+                        this.emit('dead', health);
+                        recordHealthStatusError(state.status);
+                        // Attempt automatic recovery if enabled
+                        if (this.config.autoRecover) {
+                            this.attemptRecovery(state);
+                        }
+                        break;
+                }
+            }
+        }
+    }
+}
+/**
+ * Default health monitor instance
+ */
+let defaultMonitor = null;
+/**
+ * Get the default health monitor instance
+ */
+export function getHealthMonitor() {
+    if (!defaultMonitor) {
+        defaultMonitor = new SessionHealthMonitor();
+    }
+    return defaultMonitor;
+}
+/**
+ * Initialize the health monitor with custom config
+ */
+export function initializeHealthMonitor(config) {
+    if (defaultMonitor) {
+        defaultMonitor.stop();
+    }
+    defaultMonitor = new SessionHealthMonitor(config);
+    defaultMonitor.start();
+    return defaultMonitor;
+}
+/**
+ * Shutdown the health monitor
+ */
+export function shutdownHealthMonitor() {
+    if (defaultMonitor) {
+        defaultMonitor.stop();
+        defaultMonitor = null;
+    }
+}
+//# sourceMappingURL=SessionHealthMonitor.js.map

package/dist/session/SessionHealthMonitor.js.map

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

package/dist/session/SessionManager.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Session Manager for Claude-Flow Memory Integration
+ * SMI-641: Session ID Storage in Claude-Flow Memory
+ * SMI-1518: V3 API Migration - Use direct API calls instead of spawn
+ * SMI-2741: Split to meet 500-line standard
+ *
+ * Manages session lifecycle with persistent storage in claude-flow memory
+ * to enable context restoration across sessions.
+ */
+import type { SessionData, Checkpoint } from './SessionContext.js';
+import type { CommandExecutor, SessionOptions } from './SessionManager.types.js';
+export type { CommandExecutor, MemoryResult, SessionOptions } from './SessionManager.types.js';
+export { DefaultCommandExecutor } from './SessionManager.helpers.js';
+export { storeMemoryEntry, retrieveMemoryEntry, deleteMemoryEntry, runPreTaskHook, runPostTaskHook, } from './SessionManager.memory.js';
+/**
+ * Session Manager for claude-flow memory integration
+ *
+ * Provides session lifecycle management:
+ * - Start sessions with unique IDs
+ * - Create checkpoints for recovery points
+ * - End sessions with cleanup
+ * - Recover sessions from memory
+ *
+ * Thread Safety:
+ * - Uses mutex lock for concurrent operations (SMI-675)
+ * - Implements rollback on partial failures (SMI-676)
+ */
+export declare class SessionManager {
+    private executor;
+    private currentSession;
+    /**
+     * Mutex lock for serializing session modifications
+     * Prevents race conditions when multiple operations run concurrently
+     */
+    private sessionLock;
+    constructor(executor?: CommandExecutor);
+    /**
+     * Execute a function with exclusive access to session state
+     * Serializes concurrent operations to prevent race conditions
+     */
+    private withLock;
+    /**
+     * Generate a unique session ID using crypto.randomUUID (per standards.md §4.8)
+     */
+    generateSessionId(): string;
+    /**
+     * Start a new session and store in claude-flow memory
+     */
+    startSession(options?: SessionOptions): Promise<SessionData>;
+    /**
+     * Create a checkpoint in the current session
+     *
+     * SMI-675: Uses mutex lock to prevent race conditions
+     * SMI-676: Stores checkpoint memory FIRST, rolls back on failure
+     */
+    createCheckpoint(description: string): Promise<Checkpoint>;
+    /**
+     * Record a modified file in the current session
+     * SMI-675: Uses mutex lock to prevent race conditions
+     */
+    recordFileModified(filePath: string): Promise<void>;
+    /**
+     * End the current session
+     */
+    endSession(): Promise<void>;
+    /**
+     * Get the current active session
+     */
+    getCurrentSession(): SessionData | null;
+    /**
+     * Retrieve a session from memory by ID
+     */
+    getSession(sessionId: string): Promise<SessionData | null>;
+    /**
+     * Get the ID of the current session from memory
+     */
+    getCurrentSessionId(): Promise<string | null>;
+    /**
+     * Store session data in claude-flow memory
+     */
+    private storeSession;
+    /**
+     * Set the current session pointer
+     */
+    private setCurrentSession;
+    /**
+     * Clear the current session pointer
+     */
+    private clearCurrentSession;
+}
+//# sourceMappingURL=SessionManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../src/session/SessionManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAGlE,OAAO,KAAK,EAAE,eAAe,EAAgB,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAgB9F,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC9F,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,4BAA4B,CAAA;AAEnC;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,cAAc,CAA2B;IAEjD;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAmC;gBAE1C,QAAQ,CAAC,EAAE,eAAe;IAItC;;;OAGG;YACW,QAAQ;IAiBtB;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACG,YAAY,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IA6BtE;;;;;OAKG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAqDhE;;;OAGG;IACG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAezD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBjC;;OAEG;IACH,iBAAiB,IAAI,WAAW,GAAG,IAAI;IAIvC;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAehE;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAenD;;OAEG;YACW,YAAY;IAM1B;;OAEG;YACW,iBAAiB;IAI/B;;OAEG;YACW,mBAAmB;CAGlC"}

package/dist/session/SessionManager.helpers.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Session Manager Helper Functions and Classes
+ * @module @skillsmith/core/session/SessionManager.helpers
+ */
+import type { CommandExecutor } from './SessionManager.types.js';
+/**
+ * Memory key patterns for session storage
+ */
+export declare const MEMORY_KEYS: {
+    readonly CURRENT: "session/current";
+    readonly SESSION_PREFIX: "session/";
+    readonly CHECKPOINT_PREFIX: "checkpoint/";
+};
+/**
+ * Validates a memory key to prevent injection attacks
+ */
+export declare function validateMemoryKey(key: string): boolean;
+/**
+ * Default command executor using child_process.spawn
+ * Uses argument arrays to prevent command injection
+ */
+export declare class DefaultCommandExecutor implements CommandExecutor {
+    /**
+     * @deprecated Legacy string-based execution - use spawn instead
+     */
+    execute(command: string): Promise<{
+        stdout: string;
+        stderr: string;
+    }>;
+    /**
+     * Secure spawn-based execution with argument array
+     */
+    spawn(executable: string, args: string[]): Promise<{
+        stdout: string;
+        stderr: string;
+    }>;
+    /**
+     * Parse legacy string command and execute via spawn
+     */
+    private executeWithSpawn;
+}
+//# sourceMappingURL=SessionManager.helpers.d.ts.map

package/dist/session/SessionManager.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.helpers.d.ts","sourceRoot":"","sources":["../../src/session/SessionManager.helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAMhE;;GAEG;AACH,eAAO,MAAM,WAAW;;;;CAId,CAAA;AAYV;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEtD;AAMD;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAK3E;;OAEG;IACG,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAiC5F;;OAEG;YACW,gBAAgB;CAO/B"}

package/dist/session/SessionManager.helpers.js

@@ -0,0 +1,88 @@
+/**
+ * Session Manager Helper Functions and Classes
+ * @module @skillsmith/core/session/SessionManager.helpers
+ */
+import { spawn } from 'node:child_process';
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Memory key patterns for session storage
+ */
+export const MEMORY_KEYS = {
+    CURRENT: 'session/current',
+    SESSION_PREFIX: 'session/',
+    CHECKPOINT_PREFIX: 'checkpoint/',
+};
+// ============================================================================
+// Validation
+// ============================================================================
+/**
+ * Pattern for safe memory keys
+ * Only allows alphanumeric characters, hyphens, underscores, and forward slashes
+ */
+const SAFE_KEY_PATTERN = /^[a-zA-Z0-9/_-]+$/;
+/**
+ * Validates a memory key to prevent injection attacks
+ */
+export function validateMemoryKey(key) {
+    return SAFE_KEY_PATTERN.test(key) && key.length <= 256;
+}
+// ============================================================================
+// Default Command Executor
+// ============================================================================
+/**
+ * Default command executor using child_process.spawn
+ * Uses argument arrays to prevent command injection
+ */
+export class DefaultCommandExecutor {
+    /**
+     * @deprecated Legacy string-based execution - use spawn instead
+     */
+    async execute(command) {
+        // For backwards compatibility only - prefer spawn()
+        return this.executeWithSpawn(command);
+    }
+    /**
+     * Secure spawn-based execution with argument array
+     */
+    async spawn(executable, args) {
+        return new Promise((resolve, reject) => {
+            const proc = spawn(executable, args, {
+                shell: false,
+                env: { ...process.env },
+                timeout: 30000,
+            });
+            let stdout = '';
+            let stderr = '';
+            proc.stdout?.on('data', (data) => {
+                stdout += data.toString();
+            });
+            proc.stderr?.on('data', (data) => {
+                stderr += data.toString();
+            });
+            proc.on('close', (code) => {
+                if (code === 0) {
+                    resolve({ stdout: stdout.trim(), stderr: stderr.trim() });
+                }
+                else {
+                    reject(new Error(stderr || `Command failed with code ${code}`));
+                }
+            });
+            proc.on('error', (err) => {
+                reject(err);
+            });
+        });
+    }
+    /**
+     * Parse legacy string command and execute via spawn
+     */
+    async executeWithSpawn(command) {
+        // Parse the command safely
+        const parts = command.split(' ');
+        const executable = parts[0];
+        const args = parts.slice(1);
+        return this.spawn(executable, args);
+    }
+}
+//# sourceMappingURL=SessionManager.helpers.js.map

package/dist/session/SessionManager.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.helpers.js","sourceRoot":"","sources":["../../src/session/SessionManager.helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAG1C,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,iBAAiB;IAC1B,cAAc,EAAE,UAAU;IAC1B,iBAAiB,EAAE,aAAa;CACxB,CAAA;AAEV,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,gBAAgB,GAAG,mBAAmB,CAAA;AAE5C;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAA;AACxD,CAAC;AAED,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,OAAO,sBAAsB;IACjC;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,OAAe;QAC3B,oDAAoD;QACpD,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,UAAkB,EAAE,IAAc;QAC5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE;gBACnC,KAAK,EAAE,KAAK;gBACZ,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;gBACvB,OAAO,EAAE,KAAK;aACf,CAAC,CAAA;YAEF,IAAI,MAAM,GAAG,EAAE,CAAA;YACf,IAAI,MAAM,GAAG,EAAE,CAAA;YAEf,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACvC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAA;YAC3B,CAAC,CAAC,CAAA;YAEF,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACvC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAA;YAC3B,CAAC,CAAC,CAAA;YAEF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACxB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;gBAC3D,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,4BAA4B,IAAI,EAAE,CAAC,CAAC,CAAA;gBACjE,CAAC;YACH,CAAC,CAAC,CAAA;YAEF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACvB,MAAM,CAAC,GAAG,CAAC,CAAA;YACb,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB,CAAC,OAAe;QAC5C,2BAA2B;QAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAChC,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;IACrC,CAAC;CACF"}