@claude-flow/shared 3.0.0-alpha.1

package/dist/events.js

@@ -0,0 +1,249 @@
+/**
+ * V3 Event Bus System
+ * Event-driven communication for the 15-agent swarm
+ *
+ * Based on ADR-007 (Event Sourcing for State Changes)
+ */
+// =============================================================================
+// Event Bus Implementation
+// =============================================================================
+export class EventBus {
+    handlers = new Map();
+    history = [];
+    maxHistorySize;
+    constructor(options = {}) {
+        this.maxHistorySize = options.maxHistorySize ?? 10000;
+    }
+    subscribe(eventType, handler) {
+        if (!this.handlers.has(eventType)) {
+            this.handlers.set(eventType, new Set());
+        }
+        const handlers = this.handlers.get(eventType);
+        handlers.add(handler);
+        return () => {
+            handlers.delete(handler);
+        };
+    }
+    subscribeAll(handler) {
+        if (!this.handlers.has('*')) {
+            this.handlers.set('*', new Set());
+        }
+        const handlers = this.handlers.get('*');
+        handlers.add(handler);
+        return () => {
+            handlers.delete(handler);
+        };
+    }
+    async emit(event) {
+        this.addToHistory(event);
+        const typeHandlers = this.handlers.get(event.type) ?? new Set();
+        const allHandlers = this.handlers.get('*') ?? new Set();
+        const allPromises = [];
+        for (const handler of typeHandlers) {
+            allPromises.push(this.safeExecute(handler, event));
+        }
+        for (const handler of allHandlers) {
+            allPromises.push(this.safeExecute(handler, event));
+        }
+        await Promise.all(allPromises);
+    }
+    emitSync(event) {
+        this.addToHistory(event);
+        const typeHandlers = this.handlers.get(event.type) ?? new Set();
+        const allHandlers = this.handlers.get('*') ?? new Set();
+        for (const handler of typeHandlers) {
+            try {
+                const result = handler(event);
+                if (result instanceof Promise) {
+                    result.catch(err => console.error(`Event handler error: ${err}`));
+                }
+            }
+            catch (err) {
+                console.error(`Event handler error: ${err}`);
+            }
+        }
+        for (const handler of allHandlers) {
+            try {
+                const result = handler(event);
+                if (result instanceof Promise) {
+                    result.catch(err => console.error(`Event handler error: ${err}`));
+                }
+            }
+            catch (err) {
+                console.error(`Event handler error: ${err}`);
+            }
+        }
+    }
+    getHistory(filter) {
+        let events = [...this.history];
+        if (filter?.types?.length) {
+            events = events.filter(e => filter.types.includes(e.type));
+        }
+        if (filter?.sources?.length) {
+            events = events.filter(e => filter.sources.includes(e.source));
+        }
+        if (filter?.since) {
+            events = events.filter(e => e.timestamp >= filter.since);
+        }
+        if (filter?.until) {
+            events = events.filter(e => e.timestamp <= filter.until);
+        }
+        if (filter?.limit) {
+            events = events.slice(-filter.limit);
+        }
+        return events;
+    }
+    clear() {
+        this.history = [];
+    }
+    addToHistory(event) {
+        this.history.push(event);
+        if (this.history.length > this.maxHistorySize) {
+            this.history = this.history.slice(-Math.floor(this.maxHistorySize / 2));
+        }
+    }
+    async safeExecute(handler, event) {
+        try {
+            await handler(event);
+        }
+        catch (err) {
+            console.error(`Event handler error for ${event.type}: ${err}`);
+        }
+    }
+}
+// =============================================================================
+// In-Memory Event Store
+// =============================================================================
+export class InMemoryEventStore {
+    events = new Map();
+    allEvents = [];
+    snapshots = new Map();
+    async append(event) {
+        const aggregateId = this.extractAggregateId(event);
+        if (!this.events.has(aggregateId)) {
+            this.events.set(aggregateId, []);
+        }
+        this.events.get(aggregateId).push(event);
+        this.allEvents.push(event);
+    }
+    async getEvents(aggregateId, fromVersion) {
+        const events = this.events.get(aggregateId) ?? [];
+        if (fromVersion !== undefined) {
+            return events.slice(fromVersion);
+        }
+        return events;
+    }
+    async getAllEvents(filter) {
+        let events = [...this.allEvents];
+        if (filter?.types?.length) {
+            events = events.filter(e => filter.types.includes(e.type));
+        }
+        if (filter?.sources?.length) {
+            events = events.filter(e => filter.sources.includes(e.source));
+        }
+        if (filter?.since) {
+            events = events.filter(e => e.timestamp >= filter.since);
+        }
+        if (filter?.until) {
+            events = events.filter(e => e.timestamp <= filter.until);
+        }
+        if (filter?.limit) {
+            events = events.slice(-filter.limit);
+        }
+        return events;
+    }
+    async getSnapshot(aggregateId) {
+        return this.snapshots.get(aggregateId) ?? null;
+    }
+    async saveSnapshot(snapshot) {
+        this.snapshots.set(snapshot.aggregateId, snapshot);
+    }
+    extractAggregateId(event) {
+        if (event.source !== 'swarm') {
+            return event.source;
+        }
+        if (typeof event.payload === 'object' && event.payload !== null) {
+            const payload = event.payload;
+            if ('agentId' in payload)
+                return payload.agentId;
+            if ('taskId' in payload)
+                return payload.taskId;
+        }
+        return 'swarm';
+    }
+}
+// =============================================================================
+// Event Factory Functions
+// =============================================================================
+let eventCounter = 0;
+export function createEvent(type, source, payload) {
+    return {
+        id: `evt-${Date.now()}-${++eventCounter}`,
+        type,
+        timestamp: Date.now(),
+        source,
+        payload
+    };
+}
+// Agent Events
+export function agentSpawnedEvent(agentId, role) {
+    return createEvent('agent:spawned', 'swarm', { agentId, role });
+}
+export function agentStatusChangedEvent(agentId, previousStatus, newStatus) {
+    return createEvent('agent:status-changed', agentId, { previousStatus, newStatus });
+}
+export function agentTaskAssignedEvent(agentId, taskId) {
+    return createEvent('agent:task-assigned', 'swarm', { agentId, taskId });
+}
+export function agentTaskCompletedEvent(agentId, taskId, result) {
+    return createEvent('agent:task-completed', agentId, { taskId, result });
+}
+export function agentErrorEvent(agentId, error) {
+    return createEvent('agent:error', agentId, {
+        message: error.message,
+        stack: error.stack
+    });
+}
+// Task Events
+export function taskCreatedEvent(taskId, type, title) {
+    return createEvent('task:created', 'swarm', { taskId, type, title });
+}
+export function taskQueuedEvent(taskId, priority) {
+    return createEvent('task:queued', 'swarm', { taskId, priority });
+}
+export function taskAssignedEvent(taskId, agentId) {
+    return createEvent('task:assigned', 'swarm', { taskId, agentId });
+}
+export function taskStartedEvent(taskId, agentId) {
+    return createEvent('task:started', agentId, { taskId });
+}
+export function taskCompletedEvent(taskId, result) {
+    return createEvent('task:completed', 'swarm', { taskId, result });
+}
+export function taskFailedEvent(taskId, error) {
+    return createEvent('task:failed', 'swarm', {
+        taskId,
+        error: error.message,
+        stack: error.stack
+    });
+}
+export function taskBlockedEvent(taskId, blockedBy) {
+    return createEvent('task:blocked', 'swarm', { taskId, blockedBy });
+}
+// Swarm Events
+export function swarmInitializedEvent(config) {
+    return createEvent('swarm:initialized', 'swarm', { config });
+}
+export function swarmPhaseChangedEvent(previousPhase, newPhase) {
+    return createEvent('swarm:phase-changed', 'swarm', { previousPhase, newPhase });
+}
+export function swarmMilestoneReachedEvent(milestoneId, name) {
+    return createEvent('swarm:milestone-reached', 'swarm', { milestoneId, name });
+}
+export function swarmErrorEvent(error) {
+    return createEvent('swarm:error', 'swarm', {
+        message: error.message,
+        stack: error.stack
+    });
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/hooks/example-usage.d.ts

@@ -0,0 +1,42 @@
+/**
+ * V3 Hooks System - Example Usage
+ *
+ * Demonstrates practical use cases for the hooks system.
+ *
+ * @module v3/shared/hooks/example-usage
+ */
+export declare function setupSecurityHooks(): {
+    registry: import("./registry.js").HookRegistry;
+    executor: import("./executor.js").HookExecutor;
+};
+export declare function setupLearningHooks(): {
+    registry: import("./registry.js").HookRegistry;
+    executor: import("./executor.js").HookExecutor;
+};
+export declare function setupPerformanceHooks(): {
+    registry: import("./registry.js").HookRegistry;
+    executor: import("./executor.js").HookExecutor;
+    performanceMetrics: Map<string, {
+        start: number;
+        end?: number;
+    }>;
+};
+export declare function setupFileValidationHooks(): {
+    registry: import("./registry.js").HookRegistry;
+    executor: import("./executor.js").HookExecutor;
+};
+export declare function setupSessionHooks(): {
+    registry: import("./registry.js").HookRegistry;
+    executor: import("./executor.js").HookExecutor;
+};
+export declare function setupErrorHooks(): {
+    registry: import("./registry.js").HookRegistry;
+    executor: import("./executor.js").HookExecutor;
+    errorLog: {
+        timestamp: Date;
+        error: Error;
+        context?: string;
+    }[];
+};
+export declare function runDemo(): Promise<void>;
+//# sourceMappingURL=example-usage.d.ts.map

package/dist/hooks/example-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-usage.d.ts","sourceRoot":"","sources":["../../src/hooks/example-usage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,wBAAgB,kBAAkB;;;EAyDjC;AAMD,wBAAgB,kBAAkB;;;EAsEjC;AAMD,wBAAgB,qBAAqB;;;;eAKiB,MAAM;cAAQ,MAAM;;EA4DzE;AAMD,wBAAgB,wBAAwB;;;EAmEvC;AAMD,wBAAgB,iBAAiB;;;EAwDhC;AAMD,wBAAgB,eAAe;;;;mBAKM,IAAI;eAAS,KAAK;kBAAY,MAAM;;EA+CxE;AAMD,wBAAsB,OAAO,kBAyE5B"}

package/dist/hooks/example-usage.js

@@ -0,0 +1,351 @@
+/**
+ * V3 Hooks System - Example Usage
+ *
+ * Demonstrates practical use cases for the hooks system.
+ *
+ * @module v3/shared/hooks/example-usage
+ */
+import { createHookRegistry } from './registry.js';
+import { createHookExecutor } from './executor.js';
+import { HookEvent, HookPriority } from './types.js';
+import { createEventBus } from '../core/event-bus.js';
+// =============================================================================
+// Example 1: Security Hooks - Prevent Dangerous Commands
+// =============================================================================
+export function setupSecurityHooks() {
+    const registry = createHookRegistry();
+    const eventBus = createEventBus();
+    const executor = createHookExecutor(registry, eventBus);
+    // Block dangerous commands
+    registry.register(HookEvent.PreCommand, async (context) => {
+        const dangerousPatterns = [
+            /rm\s+-rf\s+\//,
+            /format\s+c:/i,
+            /del\s+\/f\s+\/s\s+\/q/i,
+            /dd\s+if=/,
+        ];
+        const command = context.command?.command || '';
+        for (const pattern of dangerousPatterns) {
+            if (pattern.test(command)) {
+                return {
+                    success: false,
+                    abort: true,
+                    error: new Error(`🛡️  Dangerous command blocked: ${command}`),
+                };
+            }
+        }
+        return { success: true };
+    }, HookPriority.Critical, {
+        name: 'Security: Block Dangerous Commands',
+        metadata: { category: 'security' },
+    });
+    // Log security-sensitive commands
+    registry.register(HookEvent.PostCommand, async (context) => {
+        const sensitiveKeywords = ['password', 'secret', 'key', 'token', 'auth'];
+        const command = context.command?.command.toLowerCase() || '';
+        if (sensitiveKeywords.some(keyword => command.includes(keyword))) {
+            console.warn('⚠️  Security-sensitive command executed:', command);
+        }
+        return { success: true };
+    }, HookPriority.Normal, {
+        name: 'Security: Audit Sensitive Commands',
+    });
+    return { registry, executor };
+}
+// =============================================================================
+// Example 2: Learning Hooks - ReasoningBank Integration
+// =============================================================================
+export function setupLearningHooks() {
+    const registry = createHookRegistry();
+    const eventBus = createEventBus();
+    const executor = createHookExecutor(registry, eventBus);
+    // Pre-edit: Retrieve similar past edits
+    registry.register(HookEvent.PreEdit, async (context) => {
+        const filePath = context.file?.path;
+        if (!filePath) {
+            return { success: true };
+        }
+        console.log(`📚 Searching for similar edits to ${filePath}...`);
+        // Simulated ReasoningBank search
+        const similarEdits = [
+            { task: `Edit ${filePath}`, reward: 0.92, critique: 'Good test coverage' },
+            { task: `Edit ${filePath}`, reward: 0.88, critique: 'Could improve error handling' },
+        ];
+        return {
+            success: true,
+            data: {
+                metadata: {
+                    ...context.metadata,
+                    learningContext: similarEdits,
+                },
+            },
+        };
+    }, HookPriority.High, {
+        name: 'Learning: Pre-Edit Context Retrieval',
+        timeout: 2000,
+    });
+    // Post-edit: Store edit pattern
+    registry.register(HookEvent.PostEdit, async (context) => {
+        const success = context.metadata?.editSuccess ?? true;
+        const filePath = context.file?.path;
+        if (!filePath) {
+            return { success: true };
+        }
+        console.log(`💾 Storing edit pattern for ${filePath} (success: ${success})`);
+        // Simulated ReasoningBank storage
+        const pattern = {
+            task: `Edit ${filePath}`,
+            reward: success ? 0.9 : 0.3,
+            success,
+        };
+        console.log('Pattern stored:', pattern);
+        return { success: true };
+    }, HookPriority.Normal, {
+        name: 'Learning: Post-Edit Pattern Storage',
+    });
+    return { registry, executor };
+}
+// =============================================================================
+// Example 3: Performance Monitoring Hooks
+// =============================================================================
+export function setupPerformanceHooks() {
+    const registry = createHookRegistry();
+    const eventBus = createEventBus();
+    const executor = createHookExecutor(registry, eventBus);
+    const performanceMetrics = new Map();
+    // Start performance tracking
+    registry.register(HookEvent.PreToolUse, async (context) => {
+        const toolName = context.tool?.name;
+        if (!toolName) {
+            return { success: true };
+        }
+        const metricId = `tool-${toolName}-${Date.now()}`;
+        performanceMetrics.set(metricId, { start: Date.now() });
+        return {
+            success: true,
+            data: {
+                metadata: {
+                    ...context.metadata,
+                    performanceMetricId: metricId,
+                },
+            },
+        };
+    }, HookPriority.High, {
+        name: 'Performance: Start Tool Tracking',
+    });
+    // End performance tracking
+    registry.register(HookEvent.PostToolUse, async (context) => {
+        const metricId = context.metadata?.performanceMetricId;
+        if (!metricId) {
+            return { success: true };
+        }
+        const metric = performanceMetrics.get(metricId);
+        if (metric) {
+            metric.end = Date.now();
+            const duration = metric.end - metric.start;
+            console.log(`⏱️  Tool ${context.tool?.name} took ${duration}ms`);
+            if (duration > 5000) {
+                console.warn(`⚠️  Slow tool execution detected: ${duration}ms`);
+            }
+        }
+        return { success: true };
+    }, HookPriority.Normal, {
+        name: 'Performance: End Tool Tracking',
+    });
+    return { registry, executor, performanceMetrics };
+}
+// =============================================================================
+// Example 4: File Validation Hooks
+// =============================================================================
+export function setupFileValidationHooks() {
+    const registry = createHookRegistry();
+    const eventBus = createEventBus();
+    const executor = createHookExecutor(registry, eventBus);
+    // Validate file paths
+    registry.register(HookEvent.PreWrite, async (context) => {
+        const filePath = context.file?.path;
+        if (!filePath) {
+            return { success: true };
+        }
+        // Check for dangerous paths
+        const dangerousPaths = ['../', '/etc/', '/sys/', 'C:\\Windows'];
+        if (dangerousPaths.some(path => filePath.includes(path))) {
+            return {
+                success: false,
+                abort: true,
+                error: new Error(`🛡️  Dangerous file path blocked: ${filePath}`),
+            };
+        }
+        // Check for sensitive files
+        const sensitivePatterns = ['.env', 'credentials', 'secrets', '.pem', '.key'];
+        if (sensitivePatterns.some(pattern => filePath.includes(pattern))) {
+            console.warn(`⚠️  Writing to sensitive file: ${filePath}`);
+        }
+        return { success: true };
+    }, HookPriority.Critical, {
+        name: 'File: Validate Write Path',
+    });
+    // Check file size limits
+    registry.register(HookEvent.PreWrite, async (context) => {
+        const content = context.file?.content;
+        if (!content) {
+            return { success: true };
+        }
+        const maxSize = 10 * 1024 * 1024; // 10MB
+        const size = Buffer.byteLength(content, 'utf8');
+        if (size > maxSize) {
+            return {
+                success: false,
+                abort: true,
+                error: new Error(`File too large: ${size} bytes (max: ${maxSize})`),
+            };
+        }
+        return { success: true };
+    }, HookPriority.High, {
+        name: 'File: Check Size Limit',
+    });
+    return { registry, executor };
+}
+// =============================================================================
+// Example 5: Session Management Hooks
+// =============================================================================
+export function setupSessionHooks() {
+    const registry = createHookRegistry();
+    const eventBus = createEventBus();
+    const executor = createHookExecutor(registry, eventBus);
+    let activeSession = null;
+    // Initialize session
+    registry.register(HookEvent.SessionStart, async (context) => {
+        const sessionId = context.session?.id || `session-${Date.now()}`;
+        activeSession = {
+            id: sessionId,
+            startTime: new Date(),
+        };
+        console.log(`🚀 Session started: ${sessionId}`);
+        return {
+            success: true,
+            data: {
+                session: {
+                    id: sessionId,
+                    startTime: activeSession.startTime,
+                },
+            },
+        };
+    }, HookPriority.Critical, {
+        name: 'Session: Initialize',
+    });
+    // Cleanup session
+    registry.register(HookEvent.SessionEnd, async (context) => {
+        if (activeSession) {
+            const duration = Date.now() - activeSession.startTime.getTime();
+            console.log(`👋 Session ended: ${activeSession.id} (duration: ${duration}ms)`);
+            activeSession = null;
+        }
+        return { success: true };
+    }, HookPriority.Critical, {
+        name: 'Session: Cleanup',
+    });
+    return { registry, executor };
+}
+// =============================================================================
+// Example 6: Error Handling Hooks
+// =============================================================================
+export function setupErrorHooks() {
+    const registry = createHookRegistry();
+    const eventBus = createEventBus();
+    const executor = createHookExecutor(registry, eventBus);
+    const errorLog = [];
+    // Log all errors
+    registry.register(HookEvent.OnError, async (context) => {
+        const error = context.error?.error;
+        if (!error) {
+            return { success: true };
+        }
+        errorLog.push({
+            timestamp: new Date(),
+            error,
+            context: context.error?.context,
+        });
+        console.error(`❌ Error occurred:`, error.message);
+        return { success: true };
+    }, HookPriority.High, {
+        name: 'Error: Log Errors',
+    });
+    // Attempt recovery for recoverable errors
+    registry.register(HookEvent.OnError, async (context) => {
+        const recoverable = context.error?.recoverable ?? false;
+        if (recoverable) {
+            console.log(`🔄 Attempting error recovery...`);
+            // Implement recovery logic here
+        }
+        return { success: true };
+    }, HookPriority.Normal, {
+        name: 'Error: Attempt Recovery',
+    });
+    return { registry, executor, errorLog };
+}
+// =============================================================================
+// Demo: Run All Examples
+// =============================================================================
+export async function runDemo() {
+    console.log('='.repeat(60));
+    console.log('V3 Hooks System - Demo');
+    console.log('='.repeat(60));
+    // Example 1: Security Hooks
+    console.log('\n📋 Example 1: Security Hooks');
+    const { executor: securityExecutor } = setupSecurityHooks();
+    const dangerousCommand = {
+        event: HookEvent.PreCommand,
+        timestamp: new Date(),
+        command: {
+            command: 'rm -rf /',
+            isDestructive: true,
+        },
+    };
+    const securityResult = await securityExecutor.execute(HookEvent.PreCommand, dangerousCommand);
+    console.log(`Security result: ${securityResult.success ? '✅ Passed' : '❌ Blocked'}`);
+    // Example 2: Learning Hooks
+    console.log('\n📋 Example 2: Learning Hooks');
+    const { executor: learningExecutor } = setupLearningHooks();
+    const editContext = {
+        event: HookEvent.PreEdit,
+        timestamp: new Date(),
+        file: {
+            path: '/workspaces/project/src/app.ts',
+            operation: 'edit',
+        },
+    };
+    await learningExecutor.execute(HookEvent.PreEdit, editContext);
+    // Example 3: Performance Monitoring
+    console.log('\n📋 Example 3: Performance Monitoring');
+    const { executor: perfExecutor } = setupPerformanceHooks();
+    const toolContext = {
+        event: HookEvent.PreToolUse,
+        timestamp: new Date(),
+        tool: {
+            name: 'Read',
+            parameters: { path: 'file.ts' },
+            category: 'file',
+        },
+    };
+    const preToolResult = await perfExecutor.execute(HookEvent.PreToolUse, toolContext);
+    // Simulate tool execution
+    await new Promise(resolve => setTimeout(resolve, 100));
+    await perfExecutor.execute(HookEvent.PostToolUse, {
+        ...toolContext,
+        event: HookEvent.PostToolUse,
+        metadata: preToolResult.finalContext?.metadata,
+    });
+    // Get statistics
+    console.log('\n📊 Hook Statistics');
+    const stats = perfExecutor.getRegistry().getStats();
+    console.log(`Total hooks: ${stats.totalHooks}`);
+    console.log(`Total executions: ${stats.totalExecutions}`);
+    console.log(`Average execution time: ${stats.avgExecutionTime.toFixed(2)}ms`);
+    console.log('\n' + '='.repeat(60));
+}
+// Run demo if executed directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    runDemo().catch(console.error);
+}
+//# sourceMappingURL=example-usage.js.map