agentic-flow 2.0.1-alpha.2 → 2.0.1-alpha.21

package/dist/mcp/fastmcp/tools/hooks/build-agents.js

@@ -0,0 +1,276 @@
+/**
+ * Build Agents Hook - Generate optimized agent configurations
+ * Creates YAML agent definitions based on pretrain analysis
+ */
+import { z } from 'zod';
+import * as path from 'path';
+import * as fs from 'fs';
+import { loadIntelligence } from './shared.js';
+// Focus mode configurations
+const focusConfigs = {
+    quality: {
+        description: 'Emphasizes code quality, best practices, and maintainability',
+        priorities: ['code-review', 'refactoring', 'documentation', 'testing'],
+        temperature: 0.3
+    },
+    speed: {
+        description: 'Optimized for rapid development and iteration',
+        priorities: ['implementation', 'prototyping', 'quick-fixes'],
+        temperature: 0.7
+    },
+    security: {
+        description: 'Security-first development with vulnerability awareness',
+        priorities: ['security-audit', 'input-validation', 'authentication', 'encryption'],
+        temperature: 0.2
+    },
+    testing: {
+        description: 'Test-driven development with comprehensive coverage',
+        priorities: ['unit-tests', 'integration-tests', 'e2e-tests', 'mocking'],
+        temperature: 0.4
+    },
+    fullstack: {
+        description: 'Balanced full-stack development capabilities',
+        priorities: ['frontend', 'backend', 'database', 'api-design'],
+        temperature: 0.5
+    }
+};
+export const hookBuildAgentsTool = {
+    name: 'hook_build_agents',
+    description: 'Generate optimized agent configurations from pretrain data',
+    parameters: z.object({
+        focus: z.enum(['quality', 'speed', 'security', 'testing', 'fullstack'])
+            .optional()
+            .default('quality')
+            .describe('Focus mode for agent generation'),
+        output: z.string().optional().default('.claude/agents').describe('Output directory'),
+        includePrompts: z.boolean().optional().default(true).describe('Include system prompts'),
+        format: z.enum(['yaml', 'json']).optional().default('yaml').describe('Output format')
+    }),
+    execute: async ({ focus, output, includePrompts, format }, { onProgress }) => {
+        const startTime = Date.now();
+        const intel = loadIntelligence();
+        const focusConfig = focusConfigs[focus];
+        onProgress?.({ progress: 0.1, message: 'Analyzing patterns...' });
+        // Detect languages from patterns
+        const detectedLangs = new Set();
+        const detectedFrameworks = new Set();
+        for (const state of Object.keys(intel.patterns)) {
+            if (state.includes('.rs'))
+                detectedLangs.add('rust');
+            if (state.includes('.ts') || state.includes('.js'))
+                detectedLangs.add('typescript');
+            if (state.includes('.tsx') || state.includes('.jsx'))
+                detectedFrameworks.add('react');
+            if (state.includes('.py'))
+                detectedLangs.add('python');
+            if (state.includes('.go'))
+                detectedLangs.add('go');
+            if (state.includes('.vue'))
+                detectedFrameworks.add('vue');
+            if (state.includes('.sql'))
+                detectedFrameworks.add('database');
+        }
+        onProgress?.({ progress: 0.3, message: 'Generating agent configs...' });
+        const agents = [];
+        // Language-specific agents
+        if (detectedLangs.has('rust')) {
+            agents.push({
+                name: 'rust-specialist',
+                type: 'rust-developer',
+                description: 'Rust development specialist for this codebase',
+                capabilities: ['cargo', 'unsafe-rust', 'async-rust', 'wasm', 'error-handling'],
+                focus: focusConfig.priorities,
+                temperature: focusConfig.temperature,
+                systemPrompt: includePrompts ? `You are a Rust specialist.
+Focus on: memory safety, zero-cost abstractions, idiomatic Rust patterns.
+Use cargo conventions, prefer Result over panic, leverage the type system.
+${focusConfig.description}` : undefined
+            });
+        }
+        if (detectedLangs.has('typescript')) {
+            agents.push({
+                name: 'typescript-specialist',
+                type: 'typescript-developer',
+                description: 'TypeScript development specialist',
+                capabilities: ['types', 'generics', 'decorators', 'async-await', 'modules'],
+                focus: focusConfig.priorities,
+                temperature: focusConfig.temperature,
+                systemPrompt: includePrompts ? `You are a TypeScript specialist.
+Focus on: strict typing, type inference, generic patterns, module organization.
+Prefer type safety over any, use discriminated unions, leverage utility types.
+${focusConfig.description}` : undefined
+            });
+        }
+        if (detectedLangs.has('python')) {
+            agents.push({
+                name: 'python-specialist',
+                type: 'python-developer',
+                description: 'Python development specialist',
+                capabilities: ['typing', 'async', 'testing', 'packaging', 'data-science'],
+                focus: focusConfig.priorities,
+                temperature: focusConfig.temperature,
+                systemPrompt: includePrompts ? `You are a Python specialist.
+Focus on: type hints, PEP standards, pythonic idioms, virtual environments.
+Use dataclasses, prefer pathlib, leverage context managers.
+${focusConfig.description}` : undefined
+            });
+        }
+        if (detectedLangs.has('go')) {
+            agents.push({
+                name: 'go-specialist',
+                type: 'go-developer',
+                description: 'Go development specialist',
+                capabilities: ['goroutines', 'channels', 'interfaces', 'testing', 'modules'],
+                focus: focusConfig.priorities,
+                temperature: focusConfig.temperature,
+                systemPrompt: includePrompts ? `You are a Go specialist.
+Focus on: simplicity, explicit error handling, goroutines, interface composition.
+Follow Go conventions, use go fmt, prefer composition over inheritance.
+${focusConfig.description}` : undefined
+            });
+        }
+        // Framework-specific agents
+        if (detectedFrameworks.has('react')) {
+            agents.push({
+                name: 'react-specialist',
+                type: 'react-developer',
+                description: 'React/Next.js development specialist',
+                capabilities: ['hooks', 'state-management', 'components', 'ssr', 'testing'],
+                focus: focusConfig.priorities,
+                temperature: focusConfig.temperature,
+                systemPrompt: includePrompts ? `You are a React specialist.
+Focus on: functional components, hooks, state management, performance optimization.
+Prefer composition, use memo wisely, follow React best practices.
+${focusConfig.description}` : undefined
+            });
+        }
+        if (detectedFrameworks.has('database')) {
+            agents.push({
+                name: 'database-specialist',
+                type: 'database-specialist',
+                description: 'Database design and optimization specialist',
+                capabilities: ['schema-design', 'queries', 'indexing', 'migrations', 'orm'],
+                focus: focusConfig.priorities,
+                temperature: focusConfig.temperature,
+                systemPrompt: includePrompts ? `You are a database specialist.
+Focus on: normalized schemas, efficient queries, proper indexing, data integrity.
+Consider performance implications, use transactions appropriately.
+${focusConfig.description}` : undefined
+            });
+        }
+        // Focus-specific agents
+        if (focus === 'testing' || focus === 'quality') {
+            agents.push({
+                name: 'test-architect',
+                type: 'test-engineer',
+                description: 'Testing and quality assurance specialist',
+                capabilities: ['unit-tests', 'integration-tests', 'mocking', 'coverage', 'tdd'],
+                focus: ['testing', 'quality', 'reliability'],
+                temperature: focusConfig.temperature,
+                systemPrompt: includePrompts ? `You are a testing specialist.
+Focus on: comprehensive test coverage, meaningful assertions, test isolation.
+Write tests first when possible, mock external dependencies, aim for >80% coverage.
+${focusConfig.description}` : undefined
+            });
+        }
+        if (focus === 'security') {
+            agents.push({
+                name: 'security-auditor',
+                type: 'security-specialist',
+                description: 'Security audit and hardening specialist',
+                capabilities: ['vulnerability-scan', 'auth', 'encryption', 'input-validation', 'owasp'],
+                focus: ['security', 'compliance', 'hardening'],
+                temperature: focusConfig.temperature,
+                systemPrompt: includePrompts ? `You are a security specialist.
+Focus on: OWASP top 10, input validation, authentication, authorization, encryption.
+Never trust user input, use parameterized queries, implement defense in depth.
+${focusConfig.description}` : undefined
+            });
+        }
+        // Add coordinator
+        agents.push({
+            name: 'project-coordinator',
+            type: 'coordinator',
+            description: 'Coordinates multi-agent workflows for this project',
+            capabilities: ['task-decomposition', 'agent-routing', 'context-management'],
+            focus: focusConfig.priorities,
+            temperature: focusConfig.temperature
+        });
+        onProgress?.({ progress: 0.7, message: 'Writing agent files...' });
+        // Create output directory
+        const outputDir = path.join(process.cwd(), output || '.claude/agents');
+        if (!fs.existsSync(outputDir)) {
+            fs.mkdirSync(outputDir, { recursive: true });
+        }
+        // Write agent files
+        const savedFiles = [];
+        for (const agent of agents) {
+            const filename = `${agent.name}.${format}`;
+            const filePath = path.join(outputDir, filename);
+            let content;
+            if (format === 'yaml') {
+                content = `# ${agent.description}
+name: ${agent.name}
+type: ${agent.type}
+description: ${agent.description}
+capabilities:
+${agent.capabilities.map(c => `  - ${c}`).join('\n')}
+focus:
+${agent.focus.map(f => `  - ${f}`).join('\n')}
+temperature: ${agent.temperature}
+${agent.systemPrompt ? `systemPrompt: |\n  ${agent.systemPrompt.split('\n').join('\n  ')}` : ''}
+`;
+            }
+            else {
+                content = JSON.stringify(agent, null, 2);
+            }
+            fs.writeFileSync(filePath, content);
+            savedFiles.push(filename);
+        }
+        // Write index file
+        const indexPath = path.join(outputDir, `index.${format}`);
+        if (format === 'yaml') {
+            const indexContent = `# Generated Agent Index
+# Focus: ${focus}
+# Generated: ${new Date().toISOString()}
+
+agents:
+${agents.map(a => `  - ${a.name}`).join('\n')}
+
+detected:
+  languages:
+${[...detectedLangs].map(l => `    - ${l}`).join('\n') || '    - generic'}
+  frameworks:
+${[...detectedFrameworks].map(f => `    - ${f}`).join('\n') || '    - none'}
+`;
+            fs.writeFileSync(indexPath, indexContent);
+        }
+        else {
+            fs.writeFileSync(indexPath, JSON.stringify({
+                focus,
+                generated: new Date().toISOString(),
+                agents: agents.map(a => a.name),
+                detected: {
+                    languages: [...detectedLangs],
+                    frameworks: [...detectedFrameworks]
+                }
+            }, null, 2));
+        }
+        savedFiles.push(`index.${format}`);
+        onProgress?.({ progress: 1.0, message: 'Agent generation complete!' });
+        const latency = Date.now() - startTime;
+        return {
+            success: true,
+            focus,
+            agentsGenerated: agents.length,
+            agents: agents.map(a => a.name),
+            detectedLanguages: [...detectedLangs],
+            detectedFrameworks: [...detectedFrameworks],
+            savedFiles,
+            outputDir: output,
+            latencyMs: latency,
+            timestamp: new Date().toISOString()
+        };
+    }
+};
+//# sourceMappingURL=build-agents.js.map

package/dist/mcp/fastmcp/tools/hooks/build-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-agents.js","sourceRoot":"","sources":["../../../../../src/mcp/fastmcp/tools/hooks/build-agents.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Build Agents Hook - Generate optimized agent configurations\n * Creates YAML agent definitions based on pretrain analysis\n */\n\nimport { z } from 'zod';\nimport * as path from 'path';\nimport * as fs from 'fs';\nimport type { ToolDefinition } from '../../types/index.js';\nimport { loadIntelligence } from './shared.js';\n\n// Focus mode configurations\nconst focusConfigs: Record<string, {\n  description: string;\n  priorities: string[];\n  temperature: number;\n}> = {\n  quality: {\n    description: 'Emphasizes code quality, best practices, and maintainability',\n    priorities: ['code-review', 'refactoring', 'documentation', 'testing'],\n    temperature: 0.3\n  },\n  speed: {\n    description: 'Optimized for rapid development and iteration',\n    priorities: ['implementation', 'prototyping', 'quick-fixes'],\n    temperature: 0.7\n  },\n  security: {\n    description: 'Security-first development with vulnerability awareness',\n    priorities: ['security-audit', 'input-validation', 'authentication', 'encryption'],\n    temperature: 0.2\n  },\n  testing: {\n    description: 'Test-driven development with comprehensive coverage',\n    priorities: ['unit-tests', 'integration-tests', 'e2e-tests', 'mocking'],\n    temperature: 0.4\n  },\n  fullstack: {\n    description: 'Balanced full-stack development capabilities',\n    priorities: ['frontend', 'backend', 'database', 'api-design'],\n    temperature: 0.5\n  }\n};\n\ninterface AgentConfig {\n  name: string;\n  type: string;\n  description: string;\n  capabilities: string[];\n  focus: string[];\n  temperature: number;\n  systemPrompt?: string;\n}\n\nexport const hookBuildAgentsTool: ToolDefinition = {\n  name: 'hook_build_agents',\n  description: 'Generate optimized agent configurations from pretrain data',\n  parameters: z.object({\n    focus: z.enum(['quality', 'speed', 'security', 'testing', 'fullstack'])\n      .optional()\n      .default('quality')\n      .describe('Focus mode for agent generation'),\n    output: z.string().optional().default('.claude/agents').describe('Output directory'),\n    includePrompts: z.boolean().optional().default(true).describe('Include system prompts'),\n    format: z.enum(['yaml', 'json']).optional().default('yaml').describe('Output format')\n  }),\n  execute: async ({ focus, output, includePrompts, format }, { onProgress }) => {\n    const startTime = Date.now();\n    const intel = loadIntelligence();\n    const focusConfig = focusConfigs[focus];\n\n    onProgress?.({ progress: 0.1, message: 'Analyzing patterns...' });\n\n    // Detect languages from patterns\n    const detectedLangs = new Set<string>();\n    const detectedFrameworks = new Set<string>();\n\n    for (const state of Object.keys(intel.patterns)) {\n      if (state.includes('.rs')) detectedLangs.add('rust');\n      if (state.includes('.ts') || state.includes('.js')) detectedLangs.add('typescript');\n      if (state.includes('.tsx') || state.includes('.jsx')) detectedFrameworks.add('react');\n      if (state.includes('.py')) detectedLangs.add('python');\n      if (state.includes('.go')) detectedLangs.add('go');\n      if (state.includes('.vue')) detectedFrameworks.add('vue');\n      if (state.includes('.sql')) detectedFrameworks.add('database');\n    }\n\n    onProgress?.({ progress: 0.3, message: 'Generating agent configs...' });\n\n    const agents: AgentConfig[] = [];\n\n    // Language-specific agents\n    if (detectedLangs.has('rust')) {\n      agents.push({\n        name: 'rust-specialist',\n        type: 'rust-developer',\n        description: 'Rust development specialist for this codebase',\n        capabilities: ['cargo', 'unsafe-rust', 'async-rust', 'wasm', 'error-handling'],\n        focus: focusConfig.priorities,\n        temperature: focusConfig.temperature,\n        systemPrompt: includePrompts ? `You are a Rust specialist.\nFocus on: memory safety, zero-cost abstractions, idiomatic Rust patterns.\nUse cargo conventions, prefer Result over panic, leverage the type system.\n${focusConfig.description}` : undefined\n      });\n    }\n\n    if (detectedLangs.has('typescript')) {\n      agents.push({\n        name: 'typescript-specialist',\n        type: 'typescript-developer',\n        description: 'TypeScript development specialist',\n        capabilities: ['types', 'generics', 'decorators', 'async-await', 'modules'],\n        focus: focusConfig.priorities,\n        temperature: focusConfig.temperature,\n        systemPrompt: includePrompts ? `You are a TypeScript specialist.\nFocus on: strict typing, type inference, generic patterns, module organization.\nPrefer type safety over any, use discriminated unions, leverage utility types.\n${focusConfig.description}` : undefined\n      });\n    }\n\n    if (detectedLangs.has('python')) {\n      agents.push({\n        name: 'python-specialist',\n        type: 'python-developer',\n        description: 'Python development specialist',\n        capabilities: ['typing', 'async', 'testing', 'packaging', 'data-science'],\n        focus: focusConfig.priorities,\n        temperature: focusConfig.temperature,\n        systemPrompt: includePrompts ? `You are a Python specialist.\nFocus on: type hints, PEP standards, pythonic idioms, virtual environments.\nUse dataclasses, prefer pathlib, leverage context managers.\n${focusConfig.description}` : undefined\n      });\n    }\n\n    if (detectedLangs.has('go')) {\n      agents.push({\n        name: 'go-specialist',\n        type: 'go-developer',\n        description: 'Go development specialist',\n        capabilities: ['goroutines', 'channels', 'interfaces', 'testing', 'modules'],\n        focus: focusConfig.priorities,\n        temperature: focusConfig.temperature,\n        systemPrompt: includePrompts ? `You are a Go specialist.\nFocus on: simplicity, explicit error handling, goroutines, interface composition.\nFollow Go conventions, use go fmt, prefer composition over inheritance.\n${focusConfig.description}` : undefined\n      });\n    }\n\n    // Framework-specific agents\n    if (detectedFrameworks.has('react')) {\n      agents.push({\n        name: 'react-specialist',\n        type: 'react-developer',\n        description: 'React/Next.js development specialist',\n        capabilities: ['hooks', 'state-management', 'components', 'ssr', 'testing'],\n        focus: focusConfig.priorities,\n        temperature: focusConfig.temperature,\n        systemPrompt: includePrompts ? `You are a React specialist.\nFocus on: functional components, hooks, state management, performance optimization.\nPrefer composition, use memo wisely, follow React best practices.\n${focusConfig.description}` : undefined\n      });\n    }\n\n    if (detectedFrameworks.has('database')) {\n      agents.push({\n        name: 'database-specialist',\n        type: 'database-specialist',\n        description: 'Database design and optimization specialist',\n        capabilities: ['schema-design', 'queries', 'indexing', 'migrations', 'orm'],\n        focus: focusConfig.priorities,\n        temperature: focusConfig.temperature,\n        systemPrompt: includePrompts ? `You are a database specialist.\nFocus on: normalized schemas, efficient queries, proper indexing, data integrity.\nConsider performance implications, use transactions appropriately.\n${focusConfig.description}` : undefined\n      });\n    }\n\n    // Focus-specific agents\n    if (focus === 'testing' || focus === 'quality') {\n      agents.push({\n        name: 'test-architect',\n        type: 'test-engineer',\n        description: 'Testing and quality assurance specialist',\n        capabilities: ['unit-tests', 'integration-tests', 'mocking', 'coverage', 'tdd'],\n        focus: ['testing', 'quality', 'reliability'],\n        temperature: focusConfig.temperature,\n        systemPrompt: includePrompts ? `You are a testing specialist.\nFocus on: comprehensive test coverage, meaningful assertions, test isolation.\nWrite tests first when possible, mock external dependencies, aim for >80% coverage.\n${focusConfig.description}` : undefined\n      });\n    }\n\n    if (focus === 'security') {\n      agents.push({\n        name: 'security-auditor',\n        type: 'security-specialist',\n        description: 'Security audit and hardening specialist',\n        capabilities: ['vulnerability-scan', 'auth', 'encryption', 'input-validation', 'owasp'],\n        focus: ['security', 'compliance', 'hardening'],\n        temperature: focusConfig.temperature,\n        systemPrompt: includePrompts ? `You are a security specialist.\nFocus on: OWASP top 10, input validation, authentication, authorization, encryption.\nNever trust user input, use parameterized queries, implement defense in depth.\n${focusConfig.description}` : undefined\n      });\n    }\n\n    // Add coordinator\n    agents.push({\n      name: 'project-coordinator',\n      type: 'coordinator',\n      description: 'Coordinates multi-agent workflows for this project',\n      capabilities: ['task-decomposition', 'agent-routing', 'context-management'],\n      focus: focusConfig.priorities,\n      temperature: focusConfig.temperature\n    });\n\n    onProgress?.({ progress: 0.7, message: 'Writing agent files...' });\n\n    // Create output directory\n    const outputDir = path.join(process.cwd(), output || '.claude/agents');\n    if (!fs.existsSync(outputDir)) {\n      fs.mkdirSync(outputDir, { recursive: true });\n    }\n\n    // Write agent files\n    const savedFiles: string[] = [];\n\n    for (const agent of agents) {\n      const filename = `${agent.name}.${format}`;\n      const filePath = path.join(outputDir, filename);\n\n      let content: string;\n      if (format === 'yaml') {\n        content = `# ${agent.description}\nname: ${agent.name}\ntype: ${agent.type}\ndescription: ${agent.description}\ncapabilities:\n${agent.capabilities.map(c => `  - ${c}`).join('\\n')}\nfocus:\n${agent.focus.map(f => `  - ${f}`).join('\\n')}\ntemperature: ${agent.temperature}\n${agent.systemPrompt ? `systemPrompt: |\\n  ${agent.systemPrompt.split('\\n').join('\\n  ')}` : ''}\n`;\n      } else {\n        content = JSON.stringify(agent, null, 2);\n      }\n\n      fs.writeFileSync(filePath, content);\n      savedFiles.push(filename);\n    }\n\n    // Write index file\n    const indexPath = path.join(outputDir, `index.${format}`);\n    if (format === 'yaml') {\n      const indexContent = `# Generated Agent Index\n# Focus: ${focus}\n# Generated: ${new Date().toISOString()}\n\nagents:\n${agents.map(a => `  - ${a.name}`).join('\\n')}\n\ndetected:\n  languages:\n${[...detectedLangs].map(l => `    - ${l}`).join('\\n') || '    - generic'}\n  frameworks:\n${[...detectedFrameworks].map(f => `    - ${f}`).join('\\n') || '    - none'}\n`;\n      fs.writeFileSync(indexPath, indexContent);\n    } else {\n      fs.writeFileSync(indexPath, JSON.stringify({\n        focus,\n        generated: new Date().toISOString(),\n        agents: agents.map(a => a.name),\n        detected: {\n          languages: [...detectedLangs],\n          frameworks: [...detectedFrameworks]\n        }\n      }, null, 2));\n    }\n\n    savedFiles.push(`index.${format}`);\n\n    onProgress?.({ progress: 1.0, message: 'Agent generation complete!' });\n\n    const latency = Date.now() - startTime;\n\n    return {\n      success: true,\n      focus,\n      agentsGenerated: agents.length,\n      agents: agents.map(a => a.name),\n      detectedLanguages: [...detectedLangs],\n      detectedFrameworks: [...detectedFrameworks],\n      savedFiles,\n      outputDir: output,\n      latencyMs: latency,\n      timestamp: new Date().toISOString()\n    };\n  }\n};\n"]}

package/dist/mcp/fastmcp/tools/hooks/explain.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Explain Hook - Explain routing decisions with full transparency
+ */
+import type { ToolDefinition } from '../../types/index.js';
+export declare const hookExplainTool: ToolDefinition;
+//# sourceMappingURL=explain.d.ts.map

package/dist/mcp/fastmcp/tools/hooks/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../../../src/mcp/fastmcp/tools/hooks/explain.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQ3D,eAAO,MAAM,eAAe,EAAE,cAuL7B,CAAC"}

package/dist/mcp/fastmcp/tools/hooks/explain.js

@@ -0,0 +1,164 @@
+/**
+ * Explain Hook - Explain routing decisions with full transparency
+ */
+import { z } from 'zod';
+import * as path from 'path';
+import { loadIntelligence, getAgentForFile, simpleEmbed, cosineSimilarity } from './shared.js';
+export const hookExplainTool = {
+    name: 'hook_explain',
+    description: 'Explain why an agent would be selected for a task',
+    parameters: z.object({
+        task: z.string().describe('Task description'),
+        file: z.string().optional().describe('Optional file context'),
+        agent: z.string().optional().describe('Specific agent to explain selection for')
+    }),
+    execute: async ({ task, file, agent }, { onProgress }) => {
+        const startTime = Date.now();
+        const intel = loadIntelligence();
+        // Collect all reasoning
+        const reasons = [];
+        // All agent scores
+        const allScores = {};
+        // 1. File pattern analysis
+        if (file) {
+            const ext = path.extname(file);
+            const suggestedAgent = getAgentForFile(file);
+            reasons.push({
+                factor: 'File Extension',
+                weight: 2.0,
+                evidence: `${ext} files are typically handled by ${suggestedAgent}`,
+                contributes: agent === suggestedAgent ? 'positive' : 'neutral'
+            });
+            allScores[suggestedAgent] = (allScores[suggestedAgent] || 0) + 2.0;
+            // Learned patterns
+            const state = `edit:${ext}`;
+            if (intel.patterns[state]) {
+                const patterns = intel.patterns[state];
+                const sortedPatterns = Object.entries(patterns)
+                    .sort((a, b) => b[1] - a[1]);
+                for (const [patternAgent, value] of sortedPatterns.slice(0, 3)) {
+                    if (typeof value === 'number') {
+                        allScores[patternAgent] = (allScores[patternAgent] || 0) + value;
+                        reasons.push({
+                            factor: 'Learned Pattern',
+                            weight: value,
+                            evidence: `Historical Q-value of ${value.toFixed(2)} for ${patternAgent} on ${ext} files`,
+                            contributes: agent === patternAgent
+                                ? (value > 0 ? 'positive' : 'negative')
+                                : 'neutral'
+                        });
+                    }
+                }
+            }
+        }
+        // 2. Task keyword analysis
+        const taskLower = task.toLowerCase();
+        const keywordMatches = [];
+        const keywordMap = {
+            'test-engineer': ['test', 'spec', 'coverage'],
+            'documentation-specialist': ['document', 'readme', 'docs'],
+            'security-specialist': ['security', 'auth', 'vulnerability'],
+            'database-specialist': ['database', 'sql', 'query'],
+            'optimizer': ['optimize', 'performance', 'speed'],
+            'researcher': ['research', 'find', 'explore']
+        };
+        for (const [agentType, keywords] of Object.entries(keywordMap)) {
+            for (const keyword of keywords) {
+                if (taskLower.includes(keyword)) {
+                    keywordMatches.push(keyword);
+                    allScores[agentType] = (allScores[agentType] || 0) + 1.5;
+                    reasons.push({
+                        factor: 'Keyword Match',
+                        weight: 1.5,
+                        evidence: `Task mentions "${keyword}" → suggests ${agentType}`,
+                        contributes: agent === agentType ? 'positive' : 'neutral'
+                    });
+                }
+            }
+        }
+        // 3. Memory similarity analysis
+        if (intel.memories.length > 0) {
+            const taskEmbed = simpleEmbed(task);
+            const similarMemories = [];
+            for (const mem of intel.memories) {
+                if (mem.embedding) {
+                    const similarity = cosineSimilarity(taskEmbed, mem.embedding);
+                    if (similarity > 0.3) {
+                        similarMemories.push({
+                            content: mem.content.slice(0, 100),
+                            similarity
+                        });
+                    }
+                }
+            }
+            if (similarMemories.length > 0) {
+                similarMemories.sort((a, b) => b.similarity - a.similarity);
+                const topMemory = similarMemories[0];
+                reasons.push({
+                    factor: 'Memory Similarity',
+                    weight: topMemory.similarity,
+                    evidence: `Similar past task: "${topMemory.content}..."`,
+                    contributes: 'positive'
+                });
+            }
+        }
+        // 4. Error pattern analysis
+        const relevantErrors = intel.errorPatterns.filter(ep => task.toLowerCase().includes(ep.errorType.toLowerCase()) ||
+            ep.context.toLowerCase().includes(task.toLowerCase().split(' ')[0]));
+        if (relevantErrors.length > 0) {
+            for (const ep of relevantErrors.slice(0, 2)) {
+                const bestAgent = Object.entries(ep.agentSuccess)
+                    .sort((a, b) => b[1] - a[1])[0];
+                if (bestAgent) {
+                    reasons.push({
+                        factor: 'Error History',
+                        weight: 1.0,
+                        evidence: `${bestAgent[0]} has fixed ${ep.errorType} ${bestAgent[1]} times`,
+                        contributes: agent === bestAgent[0] ? 'positive' : 'neutral'
+                    });
+                }
+            }
+        }
+        // 5. Calculate final scores and ranking
+        const ranking = Object.entries(allScores)
+            .sort((a, b) => b[1] - a[1])
+            .map(([agentName, score], index) => ({
+            rank: index + 1,
+            agent: agentName,
+            score,
+            isRequested: agent === agentName
+        }));
+        // 6. Generate explanation summary
+        const topAgent = ranking[0];
+        const requestedAgentRank = agent
+            ? ranking.find(r => r.agent === agent)
+            : null;
+        let summary;
+        if (!agent) {
+            summary = `${topAgent?.agent || 'coder'} is recommended with score ${topAgent?.score.toFixed(2) || 0}`;
+        }
+        else if (requestedAgentRank?.rank === 1) {
+            summary = `${agent} is the top choice with score ${requestedAgentRank.score.toFixed(2)}`;
+        }
+        else if (requestedAgentRank) {
+            summary = `${agent} ranks #${requestedAgentRank.rank} with score ${requestedAgentRank.score.toFixed(2)}. ${topAgent?.agent} is preferred.`;
+        }
+        else {
+            summary = `${agent} has no specific advantages for this task. Consider ${topAgent?.agent || 'coder'}.`;
+        }
+        const latency = Date.now() - startTime;
+        return {
+            success: true,
+            summary,
+            reasons,
+            ranking: ranking.slice(0, 5),
+            requestedAgent: agent || null,
+            recommendedAgent: topAgent?.agent || 'coder',
+            memoryCount: intel.memories.length,
+            patternCount: Object.keys(intel.patterns).length,
+            latencyMs: latency,
+            timestamp: new Date().toISOString()
+        };
+    }
+};
+//# sourceMappingURL=explain.js.map

package/dist/mcp/fastmcp/tools/hooks/explain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../../../../src/mcp/fastmcp/tools/hooks/explain.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Explain Hook - Explain routing decisions with full transparency\n */\n\nimport { z } from 'zod';\nimport * as path from 'path';\nimport type { ToolDefinition } from '../../types/index.js';\nimport {\n  loadIntelligence,\n  getAgentForFile,\n  simpleEmbed,\n  cosineSimilarity\n} from './shared.js';\n\nexport const hookExplainTool: ToolDefinition = {\n  name: 'hook_explain',\n  description: 'Explain why an agent would be selected for a task',\n  parameters: z.object({\n    task: z.string().describe('Task description'),\n    file: z.string().optional().describe('Optional file context'),\n    agent: z.string().optional().describe('Specific agent to explain selection for')\n  }),\n  execute: async ({ task, file, agent }, { onProgress }) => {\n    const startTime = Date.now();\n    const intel = loadIntelligence();\n\n    // Collect all reasoning\n    const reasons: Array<{\n      factor: string;\n      weight: number;\n      evidence: string;\n      contributes: 'positive' | 'negative' | 'neutral';\n    }> = [];\n\n    // All agent scores\n    const allScores: Record<string, number> = {};\n\n    // 1. File pattern analysis\n    if (file) {\n      const ext = path.extname(file);\n      const suggestedAgent = getAgentForFile(file);\n\n      reasons.push({\n        factor: 'File Extension',\n        weight: 2.0,\n        evidence: `${ext} files are typically handled by ${suggestedAgent}`,\n        contributes: agent === suggestedAgent ? 'positive' : 'neutral'\n      });\n\n      allScores[suggestedAgent] = (allScores[suggestedAgent] || 0) + 2.0;\n\n      // Learned patterns\n      const state = `edit:${ext}`;\n      if (intel.patterns[state]) {\n        const patterns = intel.patterns[state];\n        const sortedPatterns = Object.entries(patterns)\n          .sort((a, b) => (b[1] as number) - (a[1] as number));\n\n        for (const [patternAgent, value] of sortedPatterns.slice(0, 3)) {\n          if (typeof value === 'number') {\n            allScores[patternAgent] = (allScores[patternAgent] || 0) + value;\n            reasons.push({\n              factor: 'Learned Pattern',\n              weight: value,\n              evidence: `Historical Q-value of ${value.toFixed(2)} for ${patternAgent} on ${ext} files`,\n              contributes: agent === patternAgent\n                ? (value > 0 ? 'positive' : 'negative')\n                : 'neutral'\n            });\n          }\n        }\n      }\n    }\n\n    // 2. Task keyword analysis\n    const taskLower = task.toLowerCase();\n    const keywordMatches: string[] = [];\n\n    const keywordMap: Record<string, string[]> = {\n      'test-engineer': ['test', 'spec', 'coverage'],\n      'documentation-specialist': ['document', 'readme', 'docs'],\n      'security-specialist': ['security', 'auth', 'vulnerability'],\n      'database-specialist': ['database', 'sql', 'query'],\n      'optimizer': ['optimize', 'performance', 'speed'],\n      'researcher': ['research', 'find', 'explore']\n    };\n\n    for (const [agentType, keywords] of Object.entries(keywordMap)) {\n      for (const keyword of keywords) {\n        if (taskLower.includes(keyword)) {\n          keywordMatches.push(keyword);\n          allScores[agentType] = (allScores[agentType] || 0) + 1.5;\n\n          reasons.push({\n            factor: 'Keyword Match',\n            weight: 1.5,\n            evidence: `Task mentions \"${keyword}\" → suggests ${agentType}`,\n            contributes: agent === agentType ? 'positive' : 'neutral'\n          });\n        }\n      }\n    }\n\n    // 3. Memory similarity analysis\n    if (intel.memories.length > 0) {\n      const taskEmbed = simpleEmbed(task);\n      const similarMemories: Array<{ content: string; similarity: number }> = [];\n\n      for (const mem of intel.memories) {\n        if (mem.embedding) {\n          const similarity = cosineSimilarity(taskEmbed, mem.embedding);\n          if (similarity > 0.3) {\n            similarMemories.push({\n              content: mem.content.slice(0, 100),\n              similarity\n            });\n          }\n        }\n      }\n\n      if (similarMemories.length > 0) {\n        similarMemories.sort((a, b) => b.similarity - a.similarity);\n        const topMemory = similarMemories[0];\n\n        reasons.push({\n          factor: 'Memory Similarity',\n          weight: topMemory.similarity,\n          evidence: `Similar past task: \"${topMemory.content}...\"`,\n          contributes: 'positive'\n        });\n      }\n    }\n\n    // 4. Error pattern analysis\n    const relevantErrors = intel.errorPatterns.filter(ep =>\n      task.toLowerCase().includes(ep.errorType.toLowerCase()) ||\n      ep.context.toLowerCase().includes(task.toLowerCase().split(' ')[0])\n    );\n\n    if (relevantErrors.length > 0) {\n      for (const ep of relevantErrors.slice(0, 2)) {\n        const bestAgent = Object.entries(ep.agentSuccess)\n          .sort((a, b) => b[1] - a[1])[0];\n\n        if (bestAgent) {\n          reasons.push({\n            factor: 'Error History',\n            weight: 1.0,\n            evidence: `${bestAgent[0]} has fixed ${ep.errorType} ${bestAgent[1]} times`,\n            contributes: agent === bestAgent[0] ? 'positive' : 'neutral'\n          });\n        }\n      }\n    }\n\n    // 5. Calculate final scores and ranking\n    const ranking = Object.entries(allScores)\n      .sort((a, b) => b[1] - a[1])\n      .map(([agentName, score], index) => ({\n        rank: index + 1,\n        agent: agentName,\n        score,\n        isRequested: agent === agentName\n      }));\n\n    // 6. Generate explanation summary\n    const topAgent = ranking[0];\n    const requestedAgentRank = agent\n      ? ranking.find(r => r.agent === agent)\n      : null;\n\n    let summary: string;\n    if (!agent) {\n      summary = `${topAgent?.agent || 'coder'} is recommended with score ${topAgent?.score.toFixed(2) || 0}`;\n    } else if (requestedAgentRank?.rank === 1) {\n      summary = `${agent} is the top choice with score ${requestedAgentRank.score.toFixed(2)}`;\n    } else if (requestedAgentRank) {\n      summary = `${agent} ranks #${requestedAgentRank.rank} with score ${requestedAgentRank.score.toFixed(2)}. ${topAgent?.agent} is preferred.`;\n    } else {\n      summary = `${agent} has no specific advantages for this task. Consider ${topAgent?.agent || 'coder'}.`;\n    }\n\n    const latency = Date.now() - startTime;\n\n    return {\n      success: true,\n      summary,\n      reasons,\n      ranking: ranking.slice(0, 5),\n      requestedAgent: agent || null,\n      recommendedAgent: topAgent?.agent || 'coder',\n      memoryCount: intel.memories.length,\n      patternCount: Object.keys(intel.patterns).length,\n      latencyMs: latency,\n      timestamp: new Date().toISOString()\n    };\n  }\n};\n"]}

package/dist/mcp/fastmcp/tools/hooks/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Hook Tools - Intelligent agent routing and self-learning
+ * Integrates with ReasoningBank, LearningSystem, and Swarm
+ *
+ * NOW WITH FULL RUVECTOR INTELLIGENCE:
+ * - @ruvector/sona: Micro-LoRA (~0.05ms), EWC++, Trajectory tracking
+ * - @ruvector/attention: MoE, Flash, Hyperbolic, Graph attention
+ * - ruvector core: HNSW indexing (150x faster)
+ *
+ * Available as BOTH:
+ * 1. MCP Tools (via hooks-server.ts)
+ * 2. CLI Hooks (via npx ruvector hooks)
+ */
+export { hookPreEditTool } from './pre-edit.js';
+export { hookPostEditTool } from './post-edit.js';
+export { hookPreCommandTool } from './pre-command.js';
+export { hookPostCommandTool } from './post-command.js';
+export { hookRouteTool } from './route.js';
+export { hookExplainTool } from './explain.js';
+export { hookPretrainTool } from './pretrain.js';
+export { hookBuildAgentsTool } from './build-agents.js';
+export { hookMetricsTool } from './metrics.js';
+export { hookTransferTool } from './transfer.js';
+export { getIntelligence, routeTaskIntelligent, beginTaskTrajectory, recordTrajectoryStep, endTaskTrajectory, storePattern, findSimilarPatterns, getIntelligenceStats, forceLearningCycle, computeAttentionSimilarity } from './intelligence-bridge.js';
+export { intelligenceRouteTool, intelligenceTrajectoryStartTool, intelligenceTrajectoryStepTool, intelligenceTrajectoryEndTool, intelligencePatternStoreTool, intelligencePatternSearchTool, intelligenceStatsTool, intelligenceLearnTool, intelligenceAttentionTool, intelligenceTools } from './intelligence-tools.js';
+export declare const hookTools: import("../../types/index.js").ToolDefinition[];
+export declare const allHookTools: import("../../types/index.js").ToolDefinition[];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/fastmcp/tools/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/mcp/fastmcp/tools/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjD,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,0BAA0B,EAC3B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,8BAA8B,EAC9B,6BAA6B,EAC7B,4BAA4B,EAC5B,6BAA6B,EAC7B,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AAgBjC,eAAO,MAAM,SAAS,iDAWrB,CAAC;AAGF,eAAO,MAAM,YAAY,iDAGxB,CAAC"}

package/dist/mcp/fastmcp/tools/hooks/index.js

@@ -0,0 +1,59 @@
+/**
+ * Hook Tools - Intelligent agent routing and self-learning
+ * Integrates with ReasoningBank, LearningSystem, and Swarm
+ *
+ * NOW WITH FULL RUVECTOR INTELLIGENCE:
+ * - @ruvector/sona: Micro-LoRA (~0.05ms), EWC++, Trajectory tracking
+ * - @ruvector/attention: MoE, Flash, Hyperbolic, Graph attention
+ * - ruvector core: HNSW indexing (150x faster)
+ *
+ * Available as BOTH:
+ * 1. MCP Tools (via hooks-server.ts)
+ * 2. CLI Hooks (via npx ruvector hooks)
+ */
+// Hook tools (original)
+export { hookPreEditTool } from './pre-edit.js';
+export { hookPostEditTool } from './post-edit.js';
+export { hookPreCommandTool } from './pre-command.js';
+export { hookPostCommandTool } from './post-command.js';
+export { hookRouteTool } from './route.js';
+export { hookExplainTool } from './explain.js';
+export { hookPretrainTool } from './pretrain.js';
+export { hookBuildAgentsTool } from './build-agents.js';
+export { hookMetricsTool } from './metrics.js';
+export { hookTransferTool } from './transfer.js';
+// RuVector Intelligence Bridge
+export { getIntelligence, routeTaskIntelligent, beginTaskTrajectory, recordTrajectoryStep, endTaskTrajectory, storePattern, findSimilarPatterns, getIntelligenceStats, forceLearningCycle, computeAttentionSimilarity } from './intelligence-bridge.js';
+// RuVector Intelligence MCP Tools (NEW)
+export { intelligenceRouteTool, intelligenceTrajectoryStartTool, intelligenceTrajectoryStepTool, intelligenceTrajectoryEndTool, intelligencePatternStoreTool, intelligencePatternSearchTool, intelligenceStatsTool, intelligenceLearnTool, intelligenceAttentionTool, intelligenceTools } from './intelligence-tools.js';
+// Import all tools for registration
+import { hookPreEditTool } from './pre-edit.js';
+import { hookPostEditTool } from './post-edit.js';
+import { hookPreCommandTool } from './pre-command.js';
+import { hookPostCommandTool } from './post-command.js';
+import { hookRouteTool } from './route.js';
+import { hookExplainTool } from './explain.js';
+import { hookPretrainTool } from './pretrain.js';
+import { hookBuildAgentsTool } from './build-agents.js';
+import { hookMetricsTool } from './metrics.js';
+import { hookTransferTool } from './transfer.js';
+import { intelligenceTools } from './intelligence-tools.js';
+// Original hook tools (10 tools)
+export const hookTools = [
+    hookPreEditTool,
+    hookPostEditTool,
+    hookPreCommandTool,
+    hookPostCommandTool,
+    hookRouteTool,
+    hookExplainTool,
+    hookPretrainTool,
+    hookBuildAgentsTool,
+    hookMetricsTool,
+    hookTransferTool
+];
+// All tools including intelligence (19 tools total)
+export const allHookTools = [
+    ...hookTools,
+    ...intelligenceTools
+];
+//# sourceMappingURL=index.js.map

package/dist/mcp/fastmcp/tools/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/mcp/fastmcp/tools/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,wBAAwB;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,+BAA+B;AAC/B,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,0BAA0B,EAC3B,MAAM,0BAA0B,CAAC;AAElC,wCAAwC;AACxC,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,8BAA8B,EAC9B,6BAA6B,EAC7B,4BAA4B,EAC5B,6BAA6B,EAC7B,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AAEjC,oCAAoC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,iCAAiC;AACjC,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,eAAe;IACf,gBAAgB;IAChB,kBAAkB;IAClB,mBAAmB;IACnB,aAAa;IACb,eAAe;IACf,gBAAgB;IAChB,mBAAmB;IACnB,eAAe;IACf,gBAAgB;CACjB,CAAC;AAEF,oDAAoD;AACpD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,GAAG,SAAS;IACZ,GAAG,iBAAiB;CACrB,CAAC","sourcesContent":["/**\n * Hook Tools - Intelligent agent routing and self-learning\n * Integrates with ReasoningBank, LearningSystem, and Swarm\n *\n * NOW WITH FULL RUVECTOR INTELLIGENCE:\n * - @ruvector/sona: Micro-LoRA (~0.05ms), EWC++, Trajectory tracking\n * - @ruvector/attention: MoE, Flash, Hyperbolic, Graph attention\n * - ruvector core: HNSW indexing (150x faster)\n *\n * Available as BOTH:\n * 1. MCP Tools (via hooks-server.ts)\n * 2. CLI Hooks (via npx ruvector hooks)\n */\n\n// Hook tools (original)\nexport { hookPreEditTool } from './pre-edit.js';\nexport { hookPostEditTool } from './post-edit.js';\nexport { hookPreCommandTool } from './pre-command.js';\nexport { hookPostCommandTool } from './post-command.js';\nexport { hookRouteTool } from './route.js';\nexport { hookExplainTool } from './explain.js';\nexport { hookPretrainTool } from './pretrain.js';\nexport { hookBuildAgentsTool } from './build-agents.js';\nexport { hookMetricsTool } from './metrics.js';\nexport { hookTransferTool } from './transfer.js';\n\n// RuVector Intelligence Bridge\nexport {\n  getIntelligence,\n  routeTaskIntelligent,\n  beginTaskTrajectory,\n  recordTrajectoryStep,\n  endTaskTrajectory,\n  storePattern,\n  findSimilarPatterns,\n  getIntelligenceStats,\n  forceLearningCycle,\n  computeAttentionSimilarity\n} from './intelligence-bridge.js';\n\n// RuVector Intelligence MCP Tools (NEW)\nexport {\n  intelligenceRouteTool,\n  intelligenceTrajectoryStartTool,\n  intelligenceTrajectoryStepTool,\n  intelligenceTrajectoryEndTool,\n  intelligencePatternStoreTool,\n  intelligencePatternSearchTool,\n  intelligenceStatsTool,\n  intelligenceLearnTool,\n  intelligenceAttentionTool,\n  intelligenceTools\n} from './intelligence-tools.js';\n\n// Import all tools for registration\nimport { hookPreEditTool } from './pre-edit.js';\nimport { hookPostEditTool } from './post-edit.js';\nimport { hookPreCommandTool } from './pre-command.js';\nimport { hookPostCommandTool } from './post-command.js';\nimport { hookRouteTool } from './route.js';\nimport { hookExplainTool } from './explain.js';\nimport { hookPretrainTool } from './pretrain.js';\nimport { hookBuildAgentsTool } from './build-agents.js';\nimport { hookMetricsTool } from './metrics.js';\nimport { hookTransferTool } from './transfer.js';\nimport { intelligenceTools } from './intelligence-tools.js';\n\n// Original hook tools (10 tools)\nexport const hookTools = [\n  hookPreEditTool,\n  hookPostEditTool,\n  hookPreCommandTool,\n  hookPostCommandTool,\n  hookRouteTool,\n  hookExplainTool,\n  hookPretrainTool,\n  hookBuildAgentsTool,\n  hookMetricsTool,\n  hookTransferTool\n];\n\n// All tools including intelligence (19 tools total)\nexport const allHookTools = [\n  ...hookTools,\n  ...intelligenceTools\n];\n"]}