claude-flow 3.25.5 → 3.26.0

package/v3/@claude-flow/shared/dist/hooks/task-hooks.d.ts

@@ -1,163 +0,0 @@
-/**
- * V3 Task Lifecycle Hooks
- *
- * Provides pre-task and post-task hooks for task execution lifecycle.
- * Integrates with ReasoningBank for learning and pattern recognition.
- *
- * @module v3/shared/hooks/task-hooks
- */
-import { HookContext, HookResult } from './types.js';
-import { HookRegistry } from './registry.js';
-/**
- * Pre-task hook result with agent suggestions
- */
-export interface PreTaskHookResult extends HookResult {
-    /** Suggested agents for the task */
-    suggestedAgents?: AgentSuggestion[];
-    /** Task complexity estimation */
-    complexity?: 'low' | 'medium' | 'high';
-    /** Estimated duration in milliseconds */
-    estimatedDuration?: number;
-    /** Related patterns from ReasoningBank */
-    patterns?: TaskPattern[];
-    /** Potential risks */
-    risks?: string[];
-    /** Recommendations */
-    recommendations?: string[];
-}
-/**
- * Post-task hook result with learning data
- */
-export interface PostTaskHookResult extends HookResult {
-    /** Task outcome */
-    outcome?: TaskOutcome;
-    /** Learning updates applied */
-    learningUpdates?: LearningUpdate;
-    /** Pattern ID if a new pattern was created */
-    patternId?: string;
-    /** Trajectory ID for ReasoningBank */
-    trajectoryId?: string;
-}
-/**
- * Agent suggestion for task routing
- */
-export interface AgentSuggestion {
-    /** Agent type */
-    type: string;
-    /** Confidence score (0-1) */
-    confidence: number;
-    /** Reason for suggestion */
-    reason: string;
-    /** Capabilities relevant to this task */
-    capabilities?: string[];
-}
-/**
- * Task pattern from ReasoningBank
- */
-export interface TaskPattern {
-    /** Pattern identifier */
-    id: string;
-    /** Pattern description */
-    description: string;
-    /** Match score (0-1) */
-    matchScore: number;
-    /** Historical success rate */
-    successRate: number;
-    /** Average duration in ms */
-    avgDuration: number;
-    /** Recommended strategies */
-    strategies?: string[];
-}
-/**
- * Task outcome for learning
- */
-export interface TaskOutcome {
-    /** Whether the task succeeded */
-    success: boolean;
-    /** Duration in milliseconds */
-    duration: number;
-    /** Quality score (0-1) */
-    quality?: number;
-    /** Error details if failed */
-    error?: string;
-    /** Output artifacts */
-    artifacts?: string[];
-    /** Agent that executed the task */
-    agent?: string;
-}
-/**
- * Learning update result
- */
-export interface LearningUpdate {
-    /** Number of patterns updated */
-    patternsUpdated: number;
-    /** Number of new patterns created */
-    newPatterns: number;
-    /** Confidence adjustments made */
-    confidenceAdjusted: number;
-    /** Trajectories recorded */
-    trajectoriesRecorded: number;
-}
-/**
- * Task store for tracking active tasks
- */
-interface TaskStore {
-    taskId: string;
-    description: string;
-    startTime: number;
-    metadata?: Record<string, unknown>;
-    suggestedAgents?: AgentSuggestion[];
-}
-/**
- * Task Hooks Manager
- *
- * Manages pre-task and post-task hooks with ReasoningBank integration.
- */
-export declare class TaskHooksManager {
-    private registry;
-    private activeTasks;
-    private taskPatterns;
-    constructor(registry: HookRegistry);
-    /**
-     * Register default task hooks
-     */
-    private registerDefaultHooks;
-    /**
-     * Handle pre-task execution
-     */
-    handlePreTask(context: HookContext): Promise<PreTaskHookResult>;
-    /**
-     * Handle post-task execution
-     */
-    handlePostTask(context: HookContext): Promise<PostTaskHookResult>;
-    /**
-     * Analyze task for agent suggestions and patterns
-     */
-    private analyzeTask;
-    /**
-     * Record learning trajectory
-     */
-    private recordLearning;
-    /**
-     * Execute pre-task hook manually
-     */
-    executePreTask(taskId: string, description: string, metadata?: Record<string, unknown>): Promise<PreTaskHookResult>;
-    /**
-     * Execute post-task hook manually
-     */
-    executePostTask(taskId: string, success: boolean, metadata?: Record<string, unknown>): Promise<PostTaskHookResult>;
-    /**
-     * Get active tasks
-     */
-    getActiveTasks(): Map<string, TaskStore>;
-    /**
-     * Clear all active tasks
-     */
-    clearActiveTasks(): void;
-}
-/**
- * Create task hooks manager
- */
-export declare function createTaskHooksManager(registry: HookRegistry): TaskHooksManager;
-export {};
-//# sourceMappingURL=task-hooks.d.ts.map

package/v3/@claude-flow/shared/dist/hooks/task-hooks.js

@@ -1,326 +0,0 @@
-/**
- * V3 Task Lifecycle Hooks
- *
- * Provides pre-task and post-task hooks for task execution lifecycle.
- * Integrates with ReasoningBank for learning and pattern recognition.
- *
- * @module v3/shared/hooks/task-hooks
- */
-import { HookEvent, HookPriority, } from './types.js';
-/**
- * Task Hooks Manager
- *
- * Manages pre-task and post-task hooks with ReasoningBank integration.
- */
-export class TaskHooksManager {
-    registry;
-    activeTasks = new Map();
-    taskPatterns = new Map();
-    constructor(registry) {
-        this.registry = registry;
-        this.registerDefaultHooks();
-    }
-    /**
-     * Register default task hooks
-     */
-    registerDefaultHooks() {
-        // Pre-task hook for agent suggestion
-        this.registry.register(HookEvent.PreTaskExecute, this.handlePreTask.bind(this), HookPriority.Normal, { name: 'task-hooks:pre-task' });
-        // Post-task hook for learning
-        this.registry.register(HookEvent.PostTaskExecute, this.handlePostTask.bind(this), HookPriority.Normal, { name: 'task-hooks:post-task' });
-    }
-    /**
-     * Handle pre-task execution
-     */
-    async handlePreTask(context) {
-        const task = context.task;
-        if (!task) {
-            return { success: false, error: new Error('No task in context') };
-        }
-        // Store task for tracking
-        const taskStore = {
-            taskId: task.id,
-            description: task.description,
-            startTime: Date.now(),
-            metadata: task.metadata,
-        };
-        // Analyze task and suggest agents
-        const analysis = await this.analyzeTask(task);
-        taskStore.suggestedAgents = analysis.suggestedAgents;
-        this.activeTasks.set(task.id, taskStore);
-        // Store patterns for this task
-        if (analysis.patterns.length > 0) {
-            this.taskPatterns.set(task.id, analysis.patterns);
-        }
-        return {
-            success: true,
-            suggestedAgents: analysis.suggestedAgents,
-            complexity: analysis.complexity,
-            estimatedDuration: analysis.estimatedDuration,
-            patterns: analysis.patterns,
-            risks: analysis.risks,
-            recommendations: analysis.recommendations,
-            data: {
-                task: {
-                    ...task,
-                    metadata: {
-                        ...task.metadata,
-                        suggestedAgents: analysis.suggestedAgents.map(a => a.type),
-                        complexity: analysis.complexity,
-                    },
-                },
-            },
-        };
-    }
-    /**
-     * Handle post-task execution
-     */
-    async handlePostTask(context) {
-        const task = context.task;
-        if (!task) {
-            return { success: false, error: new Error('No task in context') };
-        }
-        const taskStore = this.activeTasks.get(task.id);
-        const patterns = this.taskPatterns.get(task.id);
-        // Calculate duration
-        const duration = taskStore ? Date.now() - taskStore.startTime : 0;
-        // Extract outcome from context metadata
-        const success = context.metadata?.success !== false;
-        const quality = context.metadata?.quality;
-        const error = context.metadata?.error;
-        const agent = context.metadata?.agent;
-        const outcome = {
-            success,
-            duration,
-            quality,
-            error,
-            agent,
-            artifacts: context.metadata?.artifacts,
-        };
-        // Record learning trajectory
-        const learningUpdates = await this.recordLearning(task, outcome, patterns);
-        // Clean up
-        this.activeTasks.delete(task.id);
-        this.taskPatterns.delete(task.id);
-        return {
-            success: true,
-            outcome,
-            learningUpdates,
-            patternId: learningUpdates.newPatterns > 0 ? `pattern-${task.id}` : undefined,
-            trajectoryId: `trajectory-${task.id}-${Date.now()}`,
-        };
-    }
-    /**
-     * Analyze task for agent suggestions and patterns
-     */
-    async analyzeTask(task) {
-        const description = task.description.toLowerCase();
-        // Pattern-based agent suggestion
-        const suggestedAgents = [];
-        const patterns = [];
-        const risks = [];
-        const recommendations = [];
-        // Analyze task keywords for agent routing
-        const agentPatterns = [
-            {
-                keywords: ['implement', 'code', 'create', 'build', 'develop', 'write'],
-                agent: 'coder',
-                capabilities: ['code-generation', 'implementation', 'debugging'],
-            },
-            {
-                keywords: ['test', 'spec', 'coverage', 'unit', 'integration'],
-                agent: 'tester',
-                capabilities: ['unit-testing', 'integration-testing', 'coverage-analysis'],
-            },
-            {
-                keywords: ['review', 'check', 'audit', 'analyze'],
-                agent: 'reviewer',
-                capabilities: ['code-review', 'quality-analysis', 'best-practices'],
-            },
-            {
-                keywords: ['research', 'investigate', 'explore', 'study'],
-                agent: 'researcher',
-                capabilities: ['research', 'analysis', 'documentation'],
-            },
-            {
-                keywords: ['security', 'vulnerability', 'cve', 'threat'],
-                agent: 'security-architect',
-                capabilities: ['security-analysis', 'vulnerability-detection', 'threat-modeling'],
-            },
-            {
-                keywords: ['performance', 'optimize', 'speed', 'memory'],
-                agent: 'performance-engineer',
-                capabilities: ['performance-optimization', 'profiling', 'benchmarking'],
-            },
-            {
-                keywords: ['architect', 'design', 'structure', 'pattern'],
-                agent: 'core-architect',
-                capabilities: ['architecture-design', 'pattern-application', 'system-design'],
-            },
-            {
-                keywords: ['memory', 'storage', 'database', 'cache'],
-                agent: 'memory-specialist',
-                capabilities: ['memory-management', 'data-persistence', 'caching'],
-            },
-            {
-                keywords: ['swarm', 'coordinate', 'orchestrate', 'agent'],
-                agent: 'swarm-specialist',
-                capabilities: ['swarm-coordination', 'agent-orchestration', 'distributed-systems'],
-            },
-        ];
-        // Score each agent based on keyword matches
-        for (const pattern of agentPatterns) {
-            let matchCount = 0;
-            for (const keyword of pattern.keywords) {
-                if (description.includes(keyword)) {
-                    matchCount++;
-                }
-            }
-            if (matchCount > 0) {
-                const confidence = Math.min(0.3 + matchCount * 0.2, 0.95);
-                suggestedAgents.push({
-                    type: pattern.agent,
-                    confidence,
-                    reason: `Matched keywords: ${pattern.keywords.filter(k => description.includes(k)).join(', ')}`,
-                    capabilities: pattern.capabilities,
-                });
-            }
-        }
-        // Sort by confidence
-        suggestedAgents.sort((a, b) => b.confidence - a.confidence);
-        // If no matches, default to coder
-        if (suggestedAgents.length === 0) {
-            suggestedAgents.push({
-                type: 'coder',
-                confidence: 0.5,
-                reason: 'Default agent for unclassified tasks',
-                capabilities: ['code-generation', 'implementation'],
-            });
-        }
-        // Estimate complexity based on description length and keywords
-        let complexity = 'medium';
-        const complexityKeywords = ['complex', 'large', 'multiple', 'refactor', 'redesign', 'critical'];
-        const simpleKeywords = ['simple', 'small', 'quick', 'fix', 'minor', 'typo'];
-        const hasComplexKeywords = complexityKeywords.some(k => description.includes(k));
-        const hasSimpleKeywords = simpleKeywords.some(k => description.includes(k));
-        if (hasComplexKeywords) {
-            complexity = 'high';
-        }
-        else if (hasSimpleKeywords) {
-            complexity = 'low';
-        }
-        else if (description.length > 200) {
-            complexity = 'high';
-        }
-        else if (description.length < 50) {
-            complexity = 'low';
-        }
-        // Estimate duration based on complexity
-        const durationMap = {
-            low: 5 * 60 * 1000, // 5 minutes
-            medium: 30 * 60 * 1000, // 30 minutes
-            high: 2 * 60 * 60 * 1000, // 2 hours
-        };
-        const estimatedDuration = durationMap[complexity];
-        // Detect risks
-        if (description.includes('production') || description.includes('live')) {
-            risks.push('Task involves production environment');
-        }
-        if (description.includes('delete') || description.includes('remove')) {
-            risks.push('Task involves destructive operations');
-        }
-        if (description.includes('security') || description.includes('auth')) {
-            risks.push('Task involves security-sensitive operations');
-        }
-        if (description.includes('database') || description.includes('migration')) {
-            risks.push('Task involves database changes');
-        }
-        // Add recommendations
-        if (complexity === 'high') {
-            recommendations.push('Consider breaking this task into smaller subtasks');
-        }
-        if (suggestedAgents.length > 1) {
-            recommendations.push('Consider using multiple agents for better coverage');
-        }
-        if (risks.length > 0) {
-            recommendations.push('Review risks before proceeding');
-        }
-        return {
-            suggestedAgents,
-            complexity,
-            estimatedDuration,
-            patterns,
-            risks,
-            recommendations,
-        };
-    }
-    /**
-     * Record learning trajectory
-     */
-    async recordLearning(task, outcome, patterns) {
-        // In a real implementation, this would integrate with ReasoningBank
-        // For now, we track basic statistics
-        const learningUpdate = {
-            patternsUpdated: patterns?.length || 0,
-            newPatterns: outcome.success ? 1 : 0,
-            confidenceAdjusted: patterns?.length || 0,
-            trajectoriesRecorded: 1,
-        };
-        return learningUpdate;
-    }
-    /**
-     * Execute pre-task hook manually
-     */
-    async executePreTask(taskId, description, metadata) {
-        const context = {
-            event: HookEvent.PreTaskExecute,
-            timestamp: new Date(),
-            task: {
-                id: taskId,
-                description,
-                metadata,
-            },
-        };
-        return this.handlePreTask(context);
-    }
-    /**
-     * Execute post-task hook manually
-     */
-    async executePostTask(taskId, success, metadata) {
-        const taskStore = this.activeTasks.get(taskId);
-        const context = {
-            event: HookEvent.PostTaskExecute,
-            timestamp: new Date(),
-            task: {
-                id: taskId,
-                description: taskStore?.description || 'Unknown task',
-                metadata: taskStore?.metadata,
-            },
-            metadata: {
-                ...metadata,
-                success,
-            },
-        };
-        return this.handlePostTask(context);
-    }
-    /**
-     * Get active tasks
-     */
-    getActiveTasks() {
-        return new Map(this.activeTasks);
-    }
-    /**
-     * Clear all active tasks
-     */
-    clearActiveTasks() {
-        this.activeTasks.clear();
-        this.taskPatterns.clear();
-    }
-}
-/**
- * Create task hooks manager
- */
-export function createTaskHooksManager(registry) {
-    return new TaskHooksManager(registry);
-}
-//# sourceMappingURL=task-hooks.js.map