@claude-flow/hooks 3.0.0-alpha.1

package/dist/reasoningbank/guidance-provider.js

@@ -0,0 +1,350 @@
+/**
+ * V3 Guidance Provider
+ *
+ * Generates Claude-visible guidance output from ReasoningBank patterns.
+ * Outputs plain text (exit 0) or JSON with additionalContext.
+ *
+ * @module @claude-flow/hooks/reasoningbank/guidance-provider
+ */
+import { ReasoningBank } from './index.js';
+/**
+ * Security patterns to block
+ */
+const BLOCKED_PATTERNS = ['.env', '.pem', '.key', 'credentials', 'secret', 'password'];
+const WARNED_PATTERNS = ['prod', 'production', 'live', 'deploy'];
+/**
+ * Dangerous commands to block
+ */
+const DANGEROUS_COMMANDS = [
+    'rm -rf',
+    'drop database',
+    'truncate',
+    'push.*--force|--force.*push',
+    'reset --hard',
+    'format c:',
+];
+/**
+ * Risky commands to warn about
+ */
+const RISKY_COMMANDS = ['npm publish', 'git push', 'deploy', 'kubectl apply'];
+/**
+ * Guidance Provider class
+ *
+ * Converts ReasoningBank patterns into Claude-visible guidance.
+ */
+export class GuidanceProvider {
+    reasoningBank;
+    constructor(reasoningBank) {
+        this.reasoningBank = reasoningBank || new ReasoningBank();
+    }
+    /**
+     * Initialize the provider
+     */
+    async initialize() {
+        await this.reasoningBank.initialize();
+    }
+    /**
+     * Generate session start context
+     * Returns plain text that Claude will see
+     */
+    async generateSessionContext() {
+        const stats = this.reasoningBank.getStats();
+        const lines = [
+            '## V3 Development Context',
+            '',
+            '**Architecture**: Domain-Driven Design with 15 @claude-flow modules',
+            '**Priority**: Security-first (CVE-1, CVE-2, CVE-3 remediation)',
+            '',
+            '**Performance Targets**:',
+            '- HNSW search: 150x-12,500x faster (<1ms)',
+            '- Flash Attention: 2.49x-7.47x speedup',
+            '- Memory: 50-75% reduction',
+            '',
+            '**Active Patterns**:',
+            '- Use TDD London School (mock-first)',
+            '- Event sourcing for state changes',
+            '- agentic-flow@alpha as core foundation',
+            '- Bounded contexts with clear interfaces',
+            '',
+            '**Code Quality Rules**:',
+            '- Files under 500 lines',
+            '- No hardcoded secrets',
+            '- Input validation at boundaries',
+            '- Typed interfaces for all public APIs',
+            '',
+            `**Learned Patterns**: ${stats.shortTermCount + stats.longTermCount} available`,
+            `**Avg Search Time**: ${stats.avgSearchTime.toFixed(2)}ms`,
+        ];
+        return lines.join('\n');
+    }
+    /**
+     * Generate user prompt context
+     * Returns plain text guidance based on prompt analysis
+     */
+    async generatePromptContext(prompt) {
+        const guidance = await this.reasoningBank.generateGuidance({
+            event: 'pre-route',
+            timestamp: new Date(),
+            routing: { task: prompt },
+        });
+        const lines = [];
+        // Add domain-specific guidance
+        if (guidance.recommendations.length > 0) {
+            const domains = this.detectDomains(prompt);
+            for (const domain of domains) {
+                lines.push(`**${this.capitalize(domain)} Guidance**:`);
+                for (const rec of guidance.recommendations.slice(0, 5)) {
+                    lines.push(`- ${rec}`);
+                }
+                lines.push('');
+            }
+        }
+        // Add relevant patterns
+        if (guidance.patterns.length > 0) {
+            lines.push('**Relevant Learned Patterns**:');
+            for (const { pattern, similarity } of guidance.patterns.slice(0, 3)) {
+                lines.push(`- ${pattern.strategy} (${(similarity * 100).toFixed(0)}% match)`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Generate pre-edit guidance
+     * Returns JSON for Claude hook system
+     */
+    async generatePreEditGuidance(filePath) {
+        // Security checks - block sensitive files
+        for (const pattern of BLOCKED_PATTERNS) {
+            if (filePath.toLowerCase().includes(pattern)) {
+                return {
+                    hookSpecificOutput: {
+                        hookEventName: 'PreToolUse',
+                        permissionDecision: 'deny',
+                        permissionDecisionReason: `Security: Cannot edit ${pattern} files directly. Use environment variables instead.`,
+                    },
+                };
+            }
+        }
+        // Warn about production files
+        for (const pattern of WARNED_PATTERNS) {
+            if (filePath.toLowerCase().includes(pattern)) {
+                return {
+                    hookSpecificOutput: {
+                        hookEventName: 'PreToolUse',
+                        permissionDecision: 'ask',
+                        permissionDecisionReason: `This appears to be a ${pattern} file. Confirm this edit is intentional.`,
+                    },
+                };
+            }
+        }
+        // Generate file-specific guidance from patterns
+        const guidance = await this.reasoningBank.generateGuidance({
+            event: 'pre-edit',
+            timestamp: new Date(),
+            file: { path: filePath, operation: 'modify' },
+        });
+        let contextGuidance = '';
+        // File type specific guidance
+        if (/test|spec/i.test(filePath)) {
+            contextGuidance = 'Testing file: Use TDD London School patterns. Mock dependencies, test behavior not implementation.';
+        }
+        else if (/security|auth/i.test(filePath)) {
+            contextGuidance = 'Security module: Validate inputs, use parameterized queries, no hardcoded secrets.';
+        }
+        else if (/memory|cache/i.test(filePath)) {
+            contextGuidance = 'Memory module: Consider HNSW indexing, batch operations, proper cleanup.';
+        }
+        else if (/swarm|coordinator/i.test(filePath)) {
+            contextGuidance = 'Swarm module: Use event-driven communication, handle failures gracefully.';
+        }
+        else if (/\.ts$/.test(filePath)) {
+            contextGuidance = 'TypeScript: Use strict types, avoid any, export interfaces for public APIs.';
+        }
+        // Add pattern-based guidance
+        if (guidance.patterns.length > 0) {
+            const patternHints = guidance.patterns
+                .slice(0, 2)
+                .map(p => p.pattern.strategy)
+                .join('; ');
+            contextGuidance += ` Similar patterns: ${patternHints}`;
+        }
+        if (contextGuidance) {
+            return {
+                hookSpecificOutput: {
+                    hookEventName: 'PreToolUse',
+                    permissionDecision: 'allow',
+                    additionalContext: contextGuidance,
+                },
+            };
+        }
+        return { decision: 'allow' };
+    }
+    /**
+     * Generate post-edit feedback
+     * Returns JSON with quality feedback
+     */
+    async generatePostEditFeedback(filePath, fileContent) {
+        const issues = [];
+        if (fileContent) {
+            // Check for console.log in non-test files
+            if (!/test|spec/i.test(filePath) && fileContent.includes('console.log')) {
+                issues.push('Remove console.log statements (use proper logging)');
+            }
+            // Check for TODO/FIXME
+            if (/TODO|FIXME|HACK/i.test(fileContent)) {
+                issues.push('Address TODO/FIXME comments before committing');
+            }
+            // Check for any type in TypeScript
+            if (/\.ts$/.test(filePath) && /:\s*any\b/.test(fileContent)) {
+                issues.push("Replace 'any' types with specific types");
+            }
+            // Check file size
+            const lines = fileContent.split('\n').length;
+            if (lines > 500) {
+                issues.push(`File exceeds 500 lines (${lines}). Consider splitting.`);
+            }
+            // Check for hardcoded secrets
+            if (/password\s*=\s*['"][^'"]+['"]|api[_-]?key\s*=\s*['"][^'"]+['"]/i.test(fileContent)) {
+                issues.push('Possible hardcoded secret detected. Use environment variables.');
+            }
+        }
+        // Store the edit as a pattern
+        await this.reasoningBank.storePattern(`Edit: ${filePath}`, 'code', {
+            operation: 'modify',
+            issues: issues.length,
+        });
+        if (issues.length > 0) {
+            return {
+                decision: 'allow',
+                reason: `Edit completed. Review suggestions:\n- ${issues.join('\n- ')}`,
+                hookSpecificOutput: {
+                    hookEventName: 'PostToolUse',
+                    additionalContext: `Quality check found items to address:\n- ${issues.join('\n- ')}`,
+                },
+            };
+        }
+        return { decision: 'allow' };
+    }
+    /**
+     * Generate pre-command guidance
+     * Returns JSON with risk assessment
+     */
+    async generatePreCommandGuidance(command) {
+        // Block dangerous commands
+        for (const pattern of DANGEROUS_COMMANDS) {
+            if (new RegExp(pattern, 'i').test(command)) {
+                return {
+                    hookSpecificOutput: {
+                        hookEventName: 'PreToolUse',
+                        permissionDecision: 'deny',
+                        permissionDecisionReason: `Destructive command blocked: ${pattern}. Use safer alternatives.`,
+                    },
+                };
+            }
+        }
+        // Warn about risky commands
+        for (const pattern of RISKY_COMMANDS) {
+            if (command.toLowerCase().includes(pattern)) {
+                return {
+                    hookSpecificOutput: {
+                        hookEventName: 'PreToolUse',
+                        permissionDecision: 'ask',
+                        permissionDecisionReason: `This command has external effects (${pattern}). Confirm before proceeding.`,
+                    },
+                };
+            }
+        }
+        // Guide test commands
+        if (/npm test|vitest|jest|pnpm test/i.test(command)) {
+            return {
+                hookSpecificOutput: {
+                    hookEventName: 'PreToolUse',
+                    permissionDecision: 'allow',
+                    additionalContext: 'Running tests. If failures occur, fix them before proceeding.',
+                },
+            };
+        }
+        // Guide build commands
+        if (/npm run build|tsc|pnpm build/i.test(command)) {
+            return {
+                hookSpecificOutput: {
+                    hookEventName: 'PreToolUse',
+                    permissionDecision: 'allow',
+                    additionalContext: 'Building project. Watch for type errors. All must pass before commit.',
+                },
+            };
+        }
+        return { decision: 'allow' };
+    }
+    /**
+     * Generate task routing guidance
+     * Returns plain text with agent recommendation
+     */
+    async generateRoutingGuidance(task) {
+        const routing = await this.reasoningBank.routeTask(task);
+        const lines = [
+            `**Recommended Agent**: ${routing.agent}`,
+            `**Confidence**: ${routing.confidence}%`,
+            `**Reasoning**: ${routing.reasoning}`,
+            '',
+        ];
+        if (routing.alternatives.length > 0) {
+            lines.push('**Alternatives**:');
+            for (const alt of routing.alternatives) {
+                lines.push(`- ${alt.agent} (${alt.confidence}%)`);
+            }
+            lines.push('');
+        }
+        if (routing.historicalPerformance) {
+            lines.push('**Historical Performance**:');
+            lines.push(`- Success rate: ${(routing.historicalPerformance.successRate * 100).toFixed(0)}%`);
+            lines.push(`- Avg quality: ${(routing.historicalPerformance.avgQuality * 100).toFixed(0)}%`);
+            lines.push(`- Similar tasks: ${routing.historicalPerformance.taskCount}`);
+        }
+        lines.push('');
+        lines.push(`Use Task tool with subagent_type="${routing.agent}" for optimal results.`);
+        return lines.join('\n');
+    }
+    /**
+     * Generate stop check
+     * Returns exit code 2 + stderr if work incomplete
+     */
+    async generateStopCheck() {
+        const stats = this.reasoningBank.getStats();
+        // Check if there are uncommitted patterns
+        if (stats.shortTermCount > 10) {
+            return {
+                shouldStop: false,
+                reason: `${stats.shortTermCount} patterns not yet consolidated. Run consolidation before stopping.`,
+            };
+        }
+        return { shouldStop: true };
+    }
+    // ===== Helper Methods =====
+    detectDomains(text) {
+        const domains = [];
+        const lowerText = text.toLowerCase();
+        if (/security|auth|password|token|secret|cve|vuln/i.test(lowerText)) {
+            domains.push('security');
+        }
+        if (/test|spec|mock|coverage|tdd|assert/i.test(lowerText)) {
+            domains.push('testing');
+        }
+        if (/perf|optim|fast|slow|memory|cache|speed/i.test(lowerText)) {
+            domains.push('performance');
+        }
+        if (/architect|design|ddd|domain|refactor|struct/i.test(lowerText)) {
+            domains.push('architecture');
+        }
+        if (/fix|bug|error|issue|broken|fail|debug/i.test(lowerText)) {
+            domains.push('debugging');
+        }
+        return domains;
+    }
+    capitalize(s) {
+        return s.charAt(0).toUpperCase() + s.slice(1);
+    }
+}
+// Export singleton
+export const guidanceProvider = new GuidanceProvider();
+//# sourceMappingURL=guidance-provider.js.map

package/dist/reasoningbank/guidance-provider.js.map

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

package/dist/reasoningbank/index.d.ts

@@ -0,0 +1,212 @@
+/**
+ * V3 ReasoningBank - Pattern Learning with AgentDB
+ *
+ * Connects hooks to persistent vector storage using AgentDB adapter.
+ * No JSON - all patterns stored as vectors in memory.db
+ *
+ * Features:
+ * - Real HNSW indexing (M=16, efConstruction=200) for 150x+ faster search
+ * - ONNX embeddings via @claude-flow/embeddings (MiniLM-L6 384-dim)
+ * - AgentDB backend for persistence
+ * - Pattern promotion from short-term to long-term memory
+ *
+ * @module @claude-flow/hooks/reasoningbank
+ */
+import { EventEmitter } from 'node:events';
+import type { HookContext } from '../types.js';
+/**
+ * Pattern stored in AgentDB
+ */
+export interface GuidancePattern {
+    id: string;
+    strategy: string;
+    domain: string;
+    embedding: Float32Array;
+    quality: number;
+    usageCount: number;
+    successCount: number;
+    createdAt: number;
+    updatedAt: number;
+    metadata: Record<string, unknown>;
+}
+/**
+ * Guidance result from pattern search
+ */
+export interface GuidanceResult {
+    patterns: Array<{
+        pattern: GuidancePattern;
+        similarity: number;
+    }>;
+    context: string;
+    recommendations: string[];
+    agentSuggestion?: {
+        agent: string;
+        confidence: number;
+        reasoning: string;
+    };
+    searchTimeMs: number;
+}
+/**
+ * Agent routing result
+ */
+export interface RoutingResult {
+    agent: string;
+    confidence: number;
+    alternatives: Array<{
+        agent: string;
+        confidence: number;
+    }>;
+    reasoning: string;
+    historicalPerformance?: {
+        successRate: number;
+        avgQuality: number;
+        taskCount: number;
+    };
+}
+/**
+ * ReasoningBank configuration
+ */
+export interface ReasoningBankConfig {
+    /** Vector dimensions (384 for MiniLM, 1536 for OpenAI) */
+    dimensions: number;
+    /** HNSW M parameter */
+    hnswM: number;
+    /** HNSW ef construction */
+    hnswEfConstruction: number;
+    /** HNSW ef search */
+    hnswEfSearch: number;
+    /** Maximum patterns in short-term memory */
+    maxShortTerm: number;
+    /** Maximum patterns in long-term memory */
+    maxLongTerm: number;
+    /** Promotion threshold (usage count) */
+    promotionThreshold: number;
+    /** Quality threshold for promotion */
+    qualityThreshold: number;
+    /** Deduplication similarity threshold */
+    dedupThreshold: number;
+    /** Database path */
+    dbPath: string;
+    /** Use mock embeddings (for testing) */
+    useMockEmbeddings?: boolean;
+}
+/**
+ * ReasoningBank metrics
+ */
+export interface ReasoningBankMetrics {
+    patternsStored: number;
+    patternsRetrieved: number;
+    searchCount: number;
+    totalSearchTime: number;
+    promotions: number;
+    hnswSearchTime: number;
+    bruteForceSearchTime: number;
+}
+/**
+ * ReasoningBank - Vector-based pattern storage and retrieval
+ *
+ * Uses AgentDB adapter for HNSW-indexed pattern storage.
+ * Provides guidance generation from learned patterns.
+ */
+export declare class ReasoningBank extends EventEmitter {
+    private config;
+    private agentDB;
+    private hnswIndex;
+    private embeddingService;
+    private initialized;
+    private useRealBackend;
+    private shortTermPatterns;
+    private longTermPatterns;
+    private metrics;
+    constructor(config?: Partial<ReasoningBankConfig>);
+    /**
+     * Initialize ReasoningBank with AgentDB backend and real HNSW
+     */
+    initialize(): Promise<void>;
+    /**
+     * Load optional dependencies
+     */
+    private loadDependencies;
+    /**
+     * Store a new pattern from hook execution
+     */
+    storePattern(strategy: string, domain: string, metadata?: Record<string, unknown>): Promise<{
+        id: string;
+        action: 'created' | 'updated';
+    }>;
+    /**
+     * Search for similar patterns using HNSW (if available) or brute-force
+     */
+    searchPatterns(query: string | Float32Array, k?: number): Promise<Array<{
+        pattern: GuidancePattern;
+        similarity: number;
+    }>>;
+    /**
+     * Brute-force search (fallback)
+     */
+    private bruteForceSearch;
+    /**
+     * Generate guidance for a given context
+     */
+    generateGuidance(context: HookContext): Promise<GuidanceResult>;
+    /**
+     * Route task to optimal agent based on learned patterns
+     */
+    routeTask(task: string): Promise<RoutingResult>;
+    /**
+     * Record pattern usage outcome
+     */
+    recordOutcome(patternId: string, success: boolean): Promise<void>;
+    /**
+     * Consolidate patterns (dedup, prune, promote)
+     * Called by HooksLearningDaemon
+     */
+    consolidate(): Promise<{
+        duplicatesRemoved: number;
+        patternsPruned: number;
+        patternsPromoted: number;
+    }>;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        shortTermCount: number;
+        longTermCount: number;
+        metrics: ReasoningBankMetrics;
+        avgSearchTime: number;
+        useRealBackend: boolean;
+        hnswSpeedup: number;
+    };
+    /**
+     * Export patterns for backup/transfer
+     */
+    exportPatterns(): Promise<{
+        shortTerm: GuidancePattern[];
+        longTerm: GuidancePattern[];
+    }>;
+    /**
+     * Import patterns from backup
+     */
+    importPatterns(data: {
+        shortTerm: GuidancePattern[];
+        longTerm: GuidancePattern[];
+    }): Promise<{
+        imported: number;
+    }>;
+    private ensureInitialized;
+    private loadPatterns;
+    private storeInAgentDB;
+    private updateInStorage;
+    private deleteFromStorage;
+    private entryToPattern;
+    private buildQueryFromContext;
+    private detectDomains;
+    private suggestAgent;
+    private calculateQuality;
+    private shouldPromote;
+    private checkPromotion;
+    private promotePattern;
+    private cosineSimilarity;
+}
+export declare const reasoningBank: ReasoningBank;
+//# sourceMappingURL=index.d.ts.map

package/dist/reasoningbank/index.d.ts.map

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