@swarmdo/cli 1.4.8

package/vendor/shared/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/vendor/shared/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}...`);
+        // Example ReasoningBank search results (replace with actual agentic-flow call)
+        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})`);
+        // Example ReasoningBank storage (replace with actual agentic-flow call)
+        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);
+    // Brief delay representing tool execution time
+    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

package/vendor/shared/dist/hooks/example-usage.js.map

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

package/vendor/shared/dist/hooks/executor.d.ts

@@ -0,0 +1,100 @@
+/**
+ * V3 Hooks System - Hook Executor
+ *
+ * Executes hooks in priority order with timeout handling and error recovery.
+ * Integrates with event bus for coordination and monitoring.
+ *
+ * @module v3/shared/hooks/executor
+ */
+import type { IEventBus } from '../core/interfaces/event.interface.js';
+import { HookRegistry } from './registry.js';
+import { HookEvent, HookContext, HookResult, HookExecutionOptions } from './types.js';
+/**
+ * Hook execution result aggregation
+ */
+export interface AggregatedHookResult {
+    /** Whether all hooks succeeded */
+    success: boolean;
+    /** Individual hook results */
+    results: HookResult[];
+    /** Total execution time in ms */
+    totalExecutionTime: number;
+    /** Number of hooks executed */
+    hooksExecuted: number;
+    /** Number of hooks failed */
+    hooksFailed: number;
+    /** Whether operation was aborted */
+    aborted: boolean;
+    /** Final merged context (from all hooks) */
+    finalContext?: Partial<HookContext>;
+}
+/**
+ * Hook executor implementation
+ */
+export declare class HookExecutor {
+    private registry;
+    private eventBus?;
+    constructor(registry: HookRegistry, eventBus?: IEventBus);
+    /**
+     * Execute all hooks for an event
+     *
+     * @param event - Hook event type
+     * @param context - Hook context
+     * @param options - Execution options
+     * @returns Aggregated results
+     */
+    execute(event: HookEvent, context: HookContext, options?: HookExecutionOptions): Promise<AggregatedHookResult>;
+    /**
+     * Execute hooks with timeout
+     *
+     * @param event - Hook event type
+     * @param context - Hook context
+     * @param timeout - Timeout in ms
+     * @returns Aggregated results
+     */
+    executeWithTimeout(event: HookEvent, context: HookContext, timeout: number): Promise<AggregatedHookResult>;
+    /**
+     * Execute a single hook with timeout and error handling
+     *
+     * @param handler - Hook handler function
+     * @param context - Hook context
+     * @param timeout - Optional timeout in ms
+     * @returns Hook result
+     */
+    private executeSingleHook;
+    /**
+     * Execute multiple hooks in parallel
+     *
+     * @param events - Array of hook events
+     * @param contexts - Array of contexts (matched by index)
+     * @param options - Execution options
+     * @returns Array of aggregated results
+     */
+    executeParallel(events: HookEvent[], contexts: HookContext[], options?: HookExecutionOptions): Promise<AggregatedHookResult[]>;
+    /**
+     * Execute hooks sequentially with context chaining
+     *
+     * @param events - Array of hook events
+     * @param initialContext - Initial context
+     * @param options - Execution options
+     * @returns Final aggregated result with chained context
+     */
+    executeSequential(events: HookEvent[], initialContext: HookContext, options?: HookExecutionOptions): Promise<AggregatedHookResult>;
+    /**
+     * Wrap a promise with timeout
+     */
+    private withTimeout;
+    /**
+     * Set event bus for coordination
+     */
+    setEventBus(eventBus: IEventBus): void;
+    /**
+     * Get hook registry
+     */
+    getRegistry(): HookRegistry;
+}
+/**
+ * Create a new hook executor
+ */
+export declare function createHookExecutor(registry: HookRegistry, eventBus?: IEventBus): HookExecutor;
+//# sourceMappingURL=executor.d.ts.map

package/vendor/shared/dist/hooks/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/hooks/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EACL,SAAS,EACT,WAAW,EACX,UAAU,EACV,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IAEjB,8BAA8B;IAC9B,OAAO,EAAE,UAAU,EAAE,CAAC;IAEtB,iCAAiC;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAE3B,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IAEtB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IAEpB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IAEjB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,QAAQ,CAAC,CAAY;gBAEjB,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,SAAS;IAKxD;;;;;;;OAOG;IACG,OAAO,CACX,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,oBAAoB,CAAC;IAwGhC;;;;;;;OAOG;IACG,kBAAkB,CACtB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,CAAC;IAOhC;;;;;;;OAOG;YACW,iBAAiB;IAiC/B;;;;;;;OAOG;IACG,eAAe,CACnB,MAAM,EAAE,SAAS,EAAE,EACnB,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,oBAAoB,EAAE,CAAC;IA4ClC;;;;;;;OAOG;IACG,iBAAiB,CACrB,MAAM,EAAE,SAAS,EAAE,EACnB,cAAc,EAAE,WAAW,EAC3B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,oBAAoB,CAAC;IA0ChC;;OAEG;YACW,WAAW;IAYzB;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI;IAItC;;OAEG;IACH,WAAW,IAAI,YAAY;CAG5B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,SAAS,GACnB,YAAY,CAEd"}