@claude-flow/shared 3.0.0-alpha.1

package/dist/hooks/session-hooks.d.ts

@@ -0,0 +1,234 @@
+/**
+ * V3 Session Management Hooks
+ *
+ * Provides session-end and session-restore hooks for state persistence.
+ * Enables cross-session memory and state recovery.
+ *
+ * @module v3/shared/hooks/session-hooks
+ */
+import { HookContext, HookResult } from './types.js';
+import { HookRegistry } from './registry.js';
+/**
+ * Session state to persist
+ */
+export interface SessionState {
+    /** Session ID */
+    sessionId: string;
+    /** Session start time */
+    startTime: Date;
+    /** Session end time */
+    endTime?: Date;
+    /** Working directory */
+    workingDirectory?: string;
+    /** Active tasks */
+    activeTasks?: Array<{
+        id: string;
+        description: string;
+        status: 'pending' | 'in_progress' | 'completed' | 'failed';
+    }>;
+    /** Spawned agents */
+    spawnedAgents?: Array<{
+        id: string;
+        type: string;
+        status: 'active' | 'idle' | 'terminated';
+    }>;
+    /** Memory entries */
+    memoryEntries?: Array<{
+        key: string;
+        namespace: string;
+        type: string;
+    }>;
+    /** Git state */
+    gitState?: {
+        branch: string;
+        uncommittedChanges: number;
+        lastCommit?: string;
+    };
+    /** Learning metrics */
+    learningMetrics?: {
+        patternsLearned: number;
+        trajectoryCount: number;
+        avgConfidence: number;
+    };
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Session-end hook result
+ */
+export interface SessionEndHookResult extends HookResult {
+    /** Session state that was persisted */
+    persistedState?: SessionState;
+    /** File path where state was saved */
+    statePath?: string;
+    /** Duration of the session in ms */
+    duration?: number;
+    /** Summary of session activity */
+    summary?: SessionSummary;
+}
+/**
+ * Session-restore hook result
+ */
+export interface SessionRestoreHookResult extends HookResult {
+    /** Restored session state */
+    restoredState?: SessionState;
+    /** Number of tasks restored */
+    tasksRestored?: number;
+    /** Number of agents restored */
+    agentsRestored?: number;
+    /** Memory entries restored */
+    memoryRestored?: number;
+    /** Warnings during restoration */
+    warnings?: string[];
+}
+/**
+ * Session summary
+ */
+export interface SessionSummary {
+    /** Total tasks executed */
+    tasksExecuted: number;
+    /** Successful tasks */
+    tasksSucceeded: number;
+    /** Failed tasks */
+    tasksFailed: number;
+    /** Commands executed */
+    commandsExecuted: number;
+    /** Files modified */
+    filesModified: number;
+    /** Agents spawned */
+    agentsSpawned: number;
+    /** Duration in ms */
+    duration: number;
+}
+/**
+ * Session storage interface
+ */
+export interface SessionStorage {
+    /** Save session state */
+    save(sessionId: string, state: SessionState): Promise<void>;
+    /** Load session state */
+    load(sessionId: string): Promise<SessionState | null>;
+    /** List available sessions */
+    list(): Promise<Array<{
+        id: string;
+        startTime: Date;
+        summary?: SessionSummary;
+    }>>;
+    /** Delete session */
+    delete(sessionId: string): Promise<boolean>;
+    /** Get latest session ID */
+    getLatest(): Promise<string | null>;
+}
+/**
+ * In-memory session storage (for testing and fallback)
+ */
+export declare class InMemorySessionStorage implements SessionStorage {
+    private sessions;
+    save(sessionId: string, state: SessionState): Promise<void>;
+    load(sessionId: string): Promise<SessionState | null>;
+    list(): Promise<Array<{
+        id: string;
+        startTime: Date;
+        summary?: SessionSummary;
+    }>>;
+    delete(sessionId: string): Promise<boolean>;
+    getLatest(): Promise<string | null>;
+}
+/**
+ * Session activity tracker
+ */
+interface SessionActivity {
+    tasksExecuted: number;
+    tasksSucceeded: number;
+    tasksFailed: number;
+    commandsExecuted: number;
+    filesModified: Set<string>;
+    agentsSpawned: Set<string>;
+}
+/**
+ * Session Hooks Manager
+ *
+ * Manages session lifecycle hooks with state persistence.
+ */
+export declare class SessionHooksManager {
+    private registry;
+    private storage;
+    private currentSessionId;
+    private sessionStartTime;
+    private activity;
+    constructor(registry: HookRegistry, storage?: SessionStorage);
+    /**
+     * Register default session hooks
+     */
+    private registerDefaultHooks;
+    /**
+     * Handle session start
+     */
+    handleSessionStart(context: HookContext): Promise<HookResult>;
+    /**
+     * Handle session end
+     */
+    handleSessionEnd(context: HookContext): Promise<SessionEndHookResult>;
+    /**
+     * Handle session resume (restoration)
+     */
+    handleSessionResume(context: HookContext): Promise<SessionRestoreHookResult>;
+    /**
+     * Track task execution
+     */
+    private trackTaskExecution;
+    /**
+     * Track command execution
+     */
+    private trackCommandExecution;
+    /**
+     * Track file modification
+     */
+    private trackFileModification;
+    /**
+     * Track agent spawn
+     */
+    private trackAgentSpawn;
+    /**
+     * Reset activity tracking
+     */
+    private resetActivity;
+    /**
+     * Execute session-end hook manually
+     */
+    executeSessionEnd(metadata?: Record<string, unknown>): Promise<SessionEndHookResult>;
+    /**
+     * Execute session-restore hook manually
+     */
+    executeSessionRestore(sessionId?: string, metadata?: Record<string, unknown>): Promise<SessionRestoreHookResult>;
+    /**
+     * List available sessions
+     */
+    listSessions(): Promise<Array<{
+        id: string;
+        startTime: Date;
+        summary?: SessionSummary;
+    }>>;
+    /**
+     * Delete a session
+     */
+    deleteSession(sessionId: string): Promise<boolean>;
+    /**
+     * Get current session ID
+     */
+    getCurrentSessionId(): string | null;
+    /**
+     * Get current session activity
+     */
+    getCurrentActivity(): SessionActivity;
+    /**
+     * Set storage backend
+     */
+    setStorage(storage: SessionStorage): void;
+}
+/**
+ * Create session hooks manager
+ */
+export declare function createSessionHooksManager(registry: HookRegistry, storage?: SessionStorage): SessionHooksManager;
+export {};
+//# sourceMappingURL=session-hooks.d.ts.map

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

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

package/dist/hooks/session-hooks.js

@@ -0,0 +1,334 @@
+/**
+ * V3 Session Management Hooks
+ *
+ * Provides session-end and session-restore hooks for state persistence.
+ * Enables cross-session memory and state recovery.
+ *
+ * @module v3/shared/hooks/session-hooks
+ */
+import { HookEvent, HookPriority, } from './types.js';
+/**
+ * In-memory session storage (for testing and fallback)
+ */
+export class InMemorySessionStorage {
+    sessions = new Map();
+    async save(sessionId, state) {
+        this.sessions.set(sessionId, state);
+    }
+    async load(sessionId) {
+        return this.sessions.get(sessionId) || null;
+    }
+    async list() {
+        return Array.from(this.sessions.entries()).map(([id, state]) => ({
+            id,
+            startTime: state.startTime,
+        }));
+    }
+    async delete(sessionId) {
+        return this.sessions.delete(sessionId);
+    }
+    async getLatest() {
+        let latest = null;
+        for (const [id, state] of this.sessions) {
+            const time = state.startTime.getTime();
+            if (!latest || time > latest.time) {
+                latest = { id, time };
+            }
+        }
+        return latest?.id || null;
+    }
+}
+/**
+ * Session Hooks Manager
+ *
+ * Manages session lifecycle hooks with state persistence.
+ */
+export class SessionHooksManager {
+    registry;
+    storage;
+    currentSessionId = null;
+    sessionStartTime = null;
+    activity = {
+        tasksExecuted: 0,
+        tasksSucceeded: 0,
+        tasksFailed: 0,
+        commandsExecuted: 0,
+        filesModified: new Set(),
+        agentsSpawned: new Set(),
+    };
+    constructor(registry, storage) {
+        this.registry = registry;
+        this.storage = storage || new InMemorySessionStorage();
+        this.registerDefaultHooks();
+    }
+    /**
+     * Register default session hooks
+     */
+    registerDefaultHooks() {
+        // Session start hook
+        this.registry.register(HookEvent.SessionStart, this.handleSessionStart.bind(this), HookPriority.High, { name: 'session-hooks:start' });
+        // Session end hook
+        this.registry.register(HookEvent.SessionEnd, this.handleSessionEnd.bind(this), HookPriority.High, { name: 'session-hooks:end' });
+        // Session resume hook (for restoration)
+        this.registry.register(HookEvent.SessionResume, this.handleSessionResume.bind(this), HookPriority.High, { name: 'session-hooks:resume' });
+        // Track tasks
+        this.registry.register(HookEvent.PostTaskExecute, this.trackTaskExecution.bind(this), HookPriority.Low, { name: 'session-hooks:track-task' });
+        // Track commands
+        this.registry.register(HookEvent.PostCommand, this.trackCommandExecution.bind(this), HookPriority.Low, { name: 'session-hooks:track-command' });
+        // Track file modifications
+        this.registry.register(HookEvent.PostEdit, this.trackFileModification.bind(this), HookPriority.Low, { name: 'session-hooks:track-file' });
+        // Track agent spawns
+        this.registry.register(HookEvent.PostAgentSpawn, this.trackAgentSpawn.bind(this), HookPriority.Low, { name: 'session-hooks:track-agent' });
+    }
+    /**
+     * Handle session start
+     */
+    async handleSessionStart(context) {
+        this.currentSessionId = context.session?.id || `session-${Date.now()}`;
+        this.sessionStartTime = new Date();
+        this.resetActivity();
+        return {
+            success: true,
+            data: {
+                session: {
+                    id: this.currentSessionId,
+                    startTime: this.sessionStartTime,
+                },
+            },
+        };
+    }
+    /**
+     * Handle session end
+     */
+    async handleSessionEnd(context) {
+        if (!this.currentSessionId || !this.sessionStartTime) {
+            return { success: true }; // No active session to end
+        }
+        const endTime = new Date();
+        const duration = endTime.getTime() - this.sessionStartTime.getTime();
+        // Build session summary
+        const summary = {
+            tasksExecuted: this.activity.tasksExecuted,
+            tasksSucceeded: this.activity.tasksSucceeded,
+            tasksFailed: this.activity.tasksFailed,
+            commandsExecuted: this.activity.commandsExecuted,
+            filesModified: this.activity.filesModified.size,
+            agentsSpawned: this.activity.agentsSpawned.size,
+            duration,
+        };
+        // Build session state
+        const state = {
+            sessionId: this.currentSessionId,
+            startTime: this.sessionStartTime,
+            endTime,
+            workingDirectory: context.metadata?.workingDirectory,
+            activeTasks: context.metadata?.activeTasks,
+            spawnedAgents: context.metadata?.spawnedAgents,
+            memoryEntries: context.metadata?.memoryEntries,
+            gitState: context.metadata?.gitState,
+            learningMetrics: context.metadata?.learningMetrics,
+            metadata: {
+                summary,
+                ...(context.metadata || {}),
+            },
+        };
+        // Persist state
+        await this.storage.save(this.currentSessionId, state);
+        // Reset session tracking
+        const sessionId = this.currentSessionId;
+        this.currentSessionId = null;
+        this.sessionStartTime = null;
+        this.resetActivity();
+        return {
+            success: true,
+            persistedState: state,
+            statePath: `sessions/${sessionId}.json`,
+            duration,
+            summary,
+        };
+    }
+    /**
+     * Handle session resume (restoration)
+     */
+    async handleSessionResume(context) {
+        let sessionId = context.session?.id;
+        // If 'latest' is requested, get the most recent session
+        if (sessionId === 'latest' || !sessionId) {
+            sessionId = await this.storage.getLatest() || undefined;
+        }
+        if (!sessionId) {
+            return {
+                success: false,
+                error: new Error('No session ID provided and no previous sessions found'),
+                warnings: ['No sessions available for restoration'],
+            };
+        }
+        // Load session state
+        const state = await this.storage.load(sessionId);
+        if (!state) {
+            return {
+                success: false,
+                error: new Error(`Session ${sessionId} not found`),
+                warnings: [`Session ${sessionId} does not exist or has been deleted`],
+            };
+        }
+        const warnings = [];
+        // Validate state age
+        const stateAge = Date.now() - state.startTime.getTime();
+        const maxAge = 7 * 24 * 60 * 60 * 1000; // 7 days
+        if (stateAge > maxAge) {
+            warnings.push(`Session is ${Math.floor(stateAge / (24 * 60 * 60 * 1000))} days old, some state may be stale`);
+        }
+        // Count restorable items
+        const tasksRestored = state.activeTasks?.length || 0;
+        const agentsRestored = state.spawnedAgents?.length || 0;
+        const memoryRestored = state.memoryEntries?.length || 0;
+        // Check for incomplete tasks
+        const incompleteTasks = state.activeTasks?.filter(t => t.status === 'pending' || t.status === 'in_progress');
+        if (incompleteTasks && incompleteTasks.length > 0) {
+            warnings.push(`${incompleteTasks.length} tasks were incomplete when session ended`);
+        }
+        // Update current session tracking
+        this.currentSessionId = `session-${Date.now()}-restored`;
+        this.sessionStartTime = new Date();
+        this.resetActivity();
+        return {
+            success: true,
+            restoredState: state,
+            tasksRestored,
+            agentsRestored,
+            memoryRestored,
+            warnings: warnings.length > 0 ? warnings : undefined,
+            data: {
+                session: {
+                    id: this.currentSessionId,
+                    startTime: this.sessionStartTime,
+                    metadata: {
+                        restoredFrom: sessionId,
+                        originalStartTime: state.startTime,
+                    },
+                },
+            },
+        };
+    }
+    /**
+     * Track task execution
+     */
+    async trackTaskExecution(context) {
+        this.activity.tasksExecuted++;
+        if (context.metadata?.success !== false) {
+            this.activity.tasksSucceeded++;
+        }
+        else {
+            this.activity.tasksFailed++;
+        }
+        return { success: true };
+    }
+    /**
+     * Track command execution
+     */
+    async trackCommandExecution(context) {
+        this.activity.commandsExecuted++;
+        return { success: true };
+    }
+    /**
+     * Track file modification
+     */
+    async trackFileModification(context) {
+        if (context.file?.path) {
+            this.activity.filesModified.add(context.file.path);
+        }
+        return { success: true };
+    }
+    /**
+     * Track agent spawn
+     */
+    async trackAgentSpawn(context) {
+        if (context.agent?.id) {
+            this.activity.agentsSpawned.add(context.agent.id);
+        }
+        return { success: true };
+    }
+    /**
+     * Reset activity tracking
+     */
+    resetActivity() {
+        this.activity = {
+            tasksExecuted: 0,
+            tasksSucceeded: 0,
+            tasksFailed: 0,
+            commandsExecuted: 0,
+            filesModified: new Set(),
+            agentsSpawned: new Set(),
+        };
+    }
+    /**
+     * Execute session-end hook manually
+     */
+    async executeSessionEnd(metadata) {
+        const context = {
+            event: HookEvent.SessionEnd,
+            timestamp: new Date(),
+            session: this.currentSessionId
+                ? {
+                    id: this.currentSessionId,
+                    startTime: this.sessionStartTime,
+                }
+                : undefined,
+            metadata,
+        };
+        return this.handleSessionEnd(context);
+    }
+    /**
+     * Execute session-restore hook manually
+     */
+    async executeSessionRestore(sessionId, metadata) {
+        const context = {
+            event: HookEvent.SessionResume,
+            timestamp: new Date(),
+            session: {
+                id: sessionId || 'latest',
+                startTime: new Date(),
+            },
+            metadata,
+        };
+        return this.handleSessionResume(context);
+    }
+    /**
+     * List available sessions
+     */
+    async listSessions() {
+        return this.storage.list();
+    }
+    /**
+     * Delete a session
+     */
+    async deleteSession(sessionId) {
+        return this.storage.delete(sessionId);
+    }
+    /**
+     * Get current session ID
+     */
+    getCurrentSessionId() {
+        return this.currentSessionId;
+    }
+    /**
+     * Get current session activity
+     */
+    getCurrentActivity() {
+        return { ...this.activity };
+    }
+    /**
+     * Set storage backend
+     */
+    setStorage(storage) {
+        this.storage = storage;
+    }
+}
+/**
+ * Create session hooks manager
+ */
+export function createSessionHooksManager(registry, storage) {
+    return new SessionHooksManager(registry, storage);
+}
+//# sourceMappingURL=session-hooks.js.map

package/dist/hooks/session-hooks.js.map

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