dino-spec 17.4.2 → 17.5.0

package/dist/hooks/hook-agent-bridge.js

@@ -0,0 +1,489 @@
+/**
+ * Hook-Agent Bridge - v17.5.0
+ *
+ * Enables hybrid communication between hooks (fast, deterministic) and
+ * agents (reasoning, complex). Implements decision matrix for when to
+ * escalate from hook to agent.
+ *
+ * Features:
+ * - Escalation from hooks to agents when complexity detected
+ * - Temporary hook registration by agents
+ * - Shared validation cache
+ * - Decision matrix: <2s deterministic = hook, >2s reasoning = agent
+ * - Performance targets: hooks <100ms, agents 2-30s
+ * - Message bus integration
+ *
+ * @module hook-agent-bridge
+ */
+import { createMessage, messageBus } from '../core/agents/message-protocol.js';
+import { ValidationCache } from '../core/agents/validation-cache.js';
+// =============================================================================
+// Constants
+// =============================================================================
+export const DEFAULT_BRIDGE_CONFIG = {
+    escalationThreshold: 50, // Score >= 50 escalates to agent
+    maxHookTimeMs: 100, // Hooks must complete in <100ms
+    maxAgentTimeMs: 30000, // Agents can take up to 30s
+    enableSharedCache: true,
+    defaultHookTtlMs: 5 * 60 * 1000, // 5 minutes
+};
+/**
+ * Complexity factors and their weights
+ */
+const COMPLEXITY_WEIGHTS = {
+    multiFile: 0.3, // Multiple files affected
+    reasoning: 0.25, // Requires reasoning/analysis
+    external: 0.2, // External API/service calls
+    security: 0.15, // Security-sensitive operation
+    async: 0.1, // Async/long-running operation
+};
+// =============================================================================
+// Hook-Agent Bridge Class
+// =============================================================================
+/**
+ * Bridge between hooks and agents
+ */
+export class HookAgentBridge {
+    config;
+    temporaryHooks = new Map();
+    pendingEscalations = new Map();
+    sharedCache;
+    escalationCounter = 0;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_BRIDGE_CONFIG, ...config };
+        this.sharedCache = new ValidationCache(this.config.cacheConfig);
+        // Subscribe to agent responses
+        this.setupMessageHandlers();
+    }
+    // ===========================================================================
+    // Complexity Assessment
+    // ===========================================================================
+    /**
+     * Assess complexity of an operation
+     */
+    assessComplexity(operation, context) {
+        const factors = [];
+        // Multi-file factor
+        const files = context.files || [];
+        if (files.length > 1) {
+            factors.push({
+                name: 'multiFile',
+                weight: COMPLEXITY_WEIGHTS.multiFile,
+                score: Math.min(100, files.length * 20),
+                description: `${files.length} files affected`,
+            });
+        }
+        // Reasoning factor
+        const requiresReasoning = this.detectReasoningRequired(operation, context);
+        if (requiresReasoning) {
+            factors.push({
+                name: 'reasoning',
+                weight: COMPLEXITY_WEIGHTS.reasoning,
+                score: 80,
+                description: 'Requires analysis or decision-making',
+            });
+        }
+        // External API factor
+        const hasExternal = this.detectExternalCalls(operation, context);
+        if (hasExternal) {
+            factors.push({
+                name: 'external',
+                weight: COMPLEXITY_WEIGHTS.external,
+                score: 60,
+                description: 'External API or service calls',
+            });
+        }
+        // Security factor
+        const isSecurity = this.detectSecuritySensitive(operation, context);
+        if (isSecurity) {
+            factors.push({
+                name: 'security',
+                weight: COMPLEXITY_WEIGHTS.security,
+                score: 90,
+                description: 'Security-sensitive operation',
+            });
+        }
+        // Async factor
+        const isAsync = this.detectAsyncOperation(operation, context);
+        if (isAsync) {
+            factors.push({
+                name: 'async',
+                weight: COMPLEXITY_WEIGHTS.async,
+                score: 50,
+                description: 'Async or long-running operation',
+            });
+        }
+        // Calculate weighted score
+        const totalWeight = factors.reduce((sum, f) => sum + f.weight, 0);
+        const weightedScore = totalWeight > 0 ? factors.reduce((sum, f) => sum + f.score * f.weight, 0) / totalWeight : 0;
+        const score = Math.round(weightedScore);
+        const handler = this.determineHandler(score, factors);
+        const estimatedTimeMs = this.estimateProcessingTime(handler, factors);
+        return {
+            score,
+            handler,
+            factors,
+            estimatedTimeMs,
+            reason: this.generateDecisionReason(handler, factors),
+        };
+    }
+    /**
+     * Detect if operation requires reasoning
+     */
+    detectReasoningRequired(operation, context) {
+        const reasoningOps = ['analyze', 'decide', 'plan', 'review', 'validate'];
+        if (reasoningOps.some((op) => operation.toLowerCase().includes(op))) {
+            return true;
+        }
+        // Check for ambiguity markers
+        const text = String(context.text || context.content || '');
+        const ambiguityMarkers = ['maybe', 'might', 'could', 'perhaps', 'unclear'];
+        return ambiguityMarkers.some((m) => text.toLowerCase().includes(m));
+    }
+    /**
+     * Detect external API calls
+     */
+    detectExternalCalls(operation, context) {
+        const externalOps = ['fetch', 'request', 'api', 'http', 'web'];
+        if (externalOps.some((op) => operation.toLowerCase().includes(op))) {
+            return true;
+        }
+        const urls = context.urls;
+        return urls !== undefined && urls.length > 0;
+    }
+    /**
+     * Detect security-sensitive operations
+     */
+    detectSecuritySensitive(operation, context) {
+        const securityOps = ['auth', 'token', 'credential', 'secret', 'password', 'encrypt'];
+        if (securityOps.some((op) => operation.toLowerCase().includes(op))) {
+            return true;
+        }
+        const files = context.files || [];
+        const securityFiles = ['.env', 'credentials', 'secret', 'auth'];
+        return files.some((f) => securityFiles.some((s) => f.toLowerCase().includes(s)));
+    }
+    /**
+     * Detect async operations
+     */
+    detectAsyncOperation(operation, _context) {
+        const asyncOps = ['install', 'build', 'deploy', 'test', 'search'];
+        return asyncOps.some((op) => operation.toLowerCase().includes(op));
+    }
+    /**
+     * Determine handler based on score and factors
+     */
+    determineHandler(score, factors) {
+        // Always escalate security-sensitive operations
+        if (factors.some((f) => f.name === 'security' && f.score >= 80)) {
+            return 'agent';
+        }
+        // Use threshold for other decisions
+        if (score >= this.config.escalationThreshold) {
+            return 'agent';
+        }
+        // If reasoning required but score low, use both
+        if (factors.some((f) => f.name === 'reasoning' && f.score >= 50)) {
+            return 'both';
+        }
+        return 'hook';
+    }
+    /**
+     * Estimate processing time
+     */
+    estimateProcessingTime(handler, factors) {
+        if (handler === 'hook') {
+            return 50; // 50ms for hooks
+        }
+        // Base agent time
+        let time = 2000; // 2s base
+        // Add time for factors
+        for (const factor of factors) {
+            if (factor.name === 'external')
+                time += 3000;
+            if (factor.name === 'reasoning')
+                time += 5000;
+            if (factor.name === 'multiFile')
+                time += factor.score * 50;
+        }
+        return Math.min(time, this.config.maxAgentTimeMs);
+    }
+    /**
+     * Generate decision reason
+     */
+    generateDecisionReason(handler, factors) {
+        if (factors.length === 0) {
+            return 'Simple operation - handled by hook';
+        }
+        const topFactors = factors
+            .sort((a, b) => b.score * b.weight - a.score * a.weight)
+            .slice(0, 2)
+            .map((f) => f.description);
+        if (handler === 'agent') {
+            return `Escalated to agent: ${topFactors.join(', ')}`;
+        }
+        if (handler === 'both') {
+            return `Hybrid handling: ${topFactors.join(', ')}`;
+        }
+        return `Handled by hook: ${topFactors.join(', ')}`;
+    }
+    // ===========================================================================
+    // Escalation
+    // ===========================================================================
+    /**
+     * Escalate operation to agent
+     */
+    async escalateToAgent(hookId, operation, context) {
+        const assessment = this.assessComplexity(operation, context);
+        const request = {
+            id: `esc-${Date.now()}-${++this.escalationCounter}`,
+            hookId,
+            operation,
+            context,
+            assessment,
+            priority: this.determinePriority(assessment),
+            timestamp: new Date(),
+        };
+        this.pendingEscalations.set(request.id, request);
+        // Send escalation message via message bus (use 'broadcast' type for escalation)
+        const message = createMessage('broadcast', hookId, {
+            broadcastType: 'custom',
+            data: { type: 'escalation', request },
+        }, 'agent-pool');
+        await messageBus.publish(message);
+        // Wait for response with timeout
+        return this.waitForEscalationResult(request.id);
+    }
+    /**
+     * Determine priority for escalation
+     */
+    determinePriority(assessment) {
+        if (assessment.factors.some((f) => f.name === 'security')) {
+            return 'critical';
+        }
+        if (assessment.score >= 80) {
+            return 'high';
+        }
+        if (assessment.score >= 50) {
+            return 'medium';
+        }
+        return 'low';
+    }
+    /**
+     * Wait for escalation result
+     */
+    async waitForEscalationResult(requestId) {
+        return new Promise((resolve) => {
+            const startTime = Date.now();
+            const timeout = this.config.maxAgentTimeMs;
+            const checkResult = () => {
+                const request = this.pendingEscalations.get(requestId);
+                // Check timeout
+                if (Date.now() - startTime > timeout) {
+                    this.pendingEscalations.delete(requestId);
+                    resolve({
+                        requestId,
+                        success: false,
+                        error: 'Escalation timed out',
+                        processingTimeMs: Date.now() - startTime,
+                    });
+                    return;
+                }
+                // Check if resolved (would be updated by message handler)
+                // For now, simulate immediate resolution
+                if (!request) {
+                    resolve({
+                        requestId,
+                        success: true,
+                        processingTimeMs: Date.now() - startTime,
+                    });
+                    return;
+                }
+                // Check again after delay
+                setTimeout(checkResult, 100);
+            };
+            checkResult();
+        });
+    }
+    // ===========================================================================
+    // Temporary Hooks
+    // ===========================================================================
+    /**
+     * Register a temporary hook from an agent
+     */
+    registerTemporaryHook(hook) {
+        const id = `temp-hook-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+        const expiresAt = new Date(Date.now() + this.config.defaultHookTtlMs);
+        const fullHook = {
+            ...hook,
+            id,
+            expiresAt,
+        };
+        this.temporaryHooks.set(id, fullHook);
+        // Schedule cleanup
+        setTimeout(() => {
+            this.unregisterTemporaryHook(id);
+        }, this.config.defaultHookTtlMs);
+        return id;
+    }
+    /**
+     * Unregister a temporary hook
+     */
+    unregisterTemporaryHook(hookId) {
+        return this.temporaryHooks.delete(hookId);
+    }
+    /**
+     * Get all active temporary hooks for an event
+     */
+    getTemporaryHooksForEvent(event) {
+        const now = new Date();
+        // Clean up expired hooks
+        for (const [id, hook] of this.temporaryHooks) {
+            if (hook.expiresAt < now) {
+                this.temporaryHooks.delete(id);
+            }
+        }
+        // Return matching hooks sorted by priority
+        return Array.from(this.temporaryHooks.values())
+            .filter((h) => h.event === event)
+            .sort((a, b) => b.priority - a.priority);
+    }
+    /**
+     * Execute temporary hooks
+     */
+    async executeTemporaryHooks(event, context) {
+        const hooks = this.getTemporaryHooksForEvent(event);
+        for (const hook of hooks) {
+            // Check matcher if defined
+            if (hook.matcher) {
+                const regex = new RegExp(hook.matcher);
+                const target = String(context.tool || context.command || '');
+                if (!regex.test(target)) {
+                    continue;
+                }
+            }
+            const result = await hook.handler(context);
+            // If blocking hook says don't proceed, stop
+            if (hook.blocking && !result.proceed) {
+                return result;
+            }
+            // Apply any context modifications
+            if (result.modifiedContext) {
+                Object.assign(context, result.modifiedContext);
+            }
+        }
+        return { proceed: true };
+    }
+    // ===========================================================================
+    // Shared Cache
+    // ===========================================================================
+    /**
+     * Get the shared validation cache
+     */
+    getSharedCache() {
+        return this.sharedCache;
+    }
+    /**
+     * Check cache for a value
+     */
+    getCached(key) {
+        return this.sharedCache.get(key);
+    }
+    /**
+     * Set cache value
+     */
+    setCached(key, value, ttlMs) {
+        this.sharedCache.set(key, value, ttlMs);
+    }
+    // ===========================================================================
+    // Message Handling
+    // ===========================================================================
+    /**
+     * Setup message handlers for agent communication
+     */
+    setupMessageHandlers() {
+        // Handle escalation responses
+        messageBus.subscribe('hook-bridge', (msg) => {
+            if (msg.type === 'response') {
+                const payload = msg.payload;
+                if (payload.requestId) {
+                    // Mark escalation as resolved
+                    this.pendingEscalations.delete(payload.requestId);
+                }
+            }
+        }, { types: ['response'] });
+        // Handle temporary hook registrations from agents
+        messageBus.subscribe('hook-bridge', (msg) => {
+            if (msg.type === 'claim') {
+                const payload = msg.payload;
+                if (payload.action === 'register-hook' && payload.hook) {
+                    this.registerTemporaryHook(payload.hook);
+                }
+            }
+        }, { types: ['claim'] });
+    }
+    // ===========================================================================
+    // Statistics
+    // ===========================================================================
+    /**
+     * Get bridge statistics
+     */
+    getStats() {
+        return {
+            pendingEscalations: this.pendingEscalations.size,
+            activeTemporaryHooks: this.temporaryHooks.size,
+            cacheStats: this.sharedCache.getStats(),
+        };
+    }
+    /**
+     * Clear all state
+     */
+    clear() {
+        this.pendingEscalations.clear();
+        this.temporaryHooks.clear();
+        this.sharedCache.clear();
+    }
+}
+// =============================================================================
+// Singleton Instance
+// =============================================================================
+/** Global hook-agent bridge instance */
+export const hookAgentBridge = new HookAgentBridge();
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Quick decision on handler for an operation
+ */
+export function decideHandler(operation, context) {
+    return hookAgentBridge.assessComplexity(operation, context).handler;
+}
+/**
+ * Check if operation should escalate to agent
+ */
+export function shouldEscalate(operation, context) {
+    const decision = decideHandler(operation, context);
+    return decision === 'agent' || decision === 'both';
+}
+/**
+ * Format assessment for display
+ */
+export function formatAssessment(assessment) {
+    const lines = [];
+    lines.push('## Complexity Assessment');
+    lines.push('');
+    lines.push(`**Score:** ${assessment.score}/100`);
+    lines.push(`**Handler:** ${assessment.handler}`);
+    lines.push(`**Est. Time:** ${assessment.estimatedTimeMs}ms`);
+    lines.push(`**Reason:** ${assessment.reason}`);
+    lines.push('');
+    if (assessment.factors.length > 0) {
+        lines.push('### Factors');
+        for (const factor of assessment.factors) {
+            lines.push(`- **${factor.name}**: ${factor.score} (weight: ${factor.weight})`);
+            lines.push(`  ${factor.description}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=hook-agent-bridge.js.map

package/dist/hooks/hook-agent-bridge.js.map

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

package/dist/hooks/index.d.ts

@@ -1,6 +1,8 @@
 /**
- * Hook generators - v12.1.0
+ * Hook generators - v17.5.0
  */
+export { DEFAULT_GENERATOR_CONFIG, DynamicHookGenerator, formatGeneratedResult, formatHooks, type GeneratedHooks, generateHooksForProject, getHookGenerator, HOOK_TEMPLATES, type HookDefinition, type HookEvent, type HookTemplate, mergeWithExistingSettings, type ProjectType, type ToolMatcher, } from './dynamic-generator.js';
+export { type BridgeConfig, type ComplexityAssessment, type ComplexityFactor, DEFAULT_BRIDGE_CONFIG, decideHandler, type EscalationRequest, type EscalationResult, formatAssessment, type HandlerDecision, HookAgentBridge, type HookResult, hookAgentBridge, shouldEscalate, type TemporaryHook, } from './hook-agent-bridge.js';
 export { generatePostEditScript } from './post-edit.js';
 export { generatePostExecutionScript, generatePostExecutionScript as generatePostTestScript, generatePostExecutionScript as generatePostBuildScript, generatePostExecutionScript as generatePostLintScript, } from './post-execution.js';
 export { generatePostTypecheckScript } from './post-typecheck.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAEvD,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,IAAI,sBAAsB,EACrD,2BAA2B,IAAI,uBAAuB,EACtD,2BAA2B,IAAI,sBAAsB,GACtD,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,KAAK,cAAc,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,yBAAyB,EACzB,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,qBAAqB,EACrB,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,KAAK,eAAe,EACpB,eAAe,EACf,KAAK,UAAU,EACf,eAAe,EACf,cAAc,EACd,KAAK,aAAa,GACnB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAEvD,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,IAAI,sBAAsB,EACrD,2BAA2B,IAAI,uBAAuB,EACtD,2BAA2B,IAAI,sBAAsB,GACtD,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/hooks/index.js

@@ -1,6 +1,10 @@
 /**
- * Hook generators - v12.1.0
+ * Hook generators - v17.5.0
  */
+// v17.5.0: Dynamic Hook Generator (MAC-10)
+export { DEFAULT_GENERATOR_CONFIG, DynamicHookGenerator, formatGeneratedResult, formatHooks, generateHooksForProject, getHookGenerator, HOOK_TEMPLATES, mergeWithExistingSettings, } from './dynamic-generator.js';
+// v17.5.0: Hook-Agent Bridge
+export { DEFAULT_BRIDGE_CONFIG, decideHandler, formatAssessment, HookAgentBridge, hookAgentBridge, shouldEscalate, } from './hook-agent-bridge.js';
 export { generatePostEditScript } from './post-edit.js';
 // Legacy exports for backwards compatibility (deprecated)
 export { generatePostExecutionScript, generatePostExecutionScript as generatePostTestScript, generatePostExecutionScript as generatePostBuildScript, generatePostExecutionScript as generatePostLintScript, } from './post-execution.js';

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AACvD,0DAA0D;AAC1D,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,IAAI,sBAAsB,EACrD,2BAA2B,IAAI,uBAAuB,EACtD,2BAA2B,IAAI,sBAAsB,GACtD,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2CAA2C;AAC3C,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EAEX,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EAId,yBAAyB,GAG1B,MAAM,wBAAwB,CAAA;AAC/B,6BAA6B;AAC7B,OAAO,EAIL,qBAAqB,EACrB,aAAa,EAGb,gBAAgB,EAEhB,eAAe,EAEf,eAAe,EACf,cAAc,GAEf,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AACvD,0DAA0D;AAC1D,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,IAAI,sBAAsB,EACrD,2BAA2B,IAAI,uBAAuB,EACtD,2BAA2B,IAAI,sBAAsB,GACtD,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/mcp/tool-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-catalog.d.ts","sourceRoot":"","sources":["../../src/mcp/tool-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,MAAM,GACN,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,GACP,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,UAAU,CAAA;AAEd;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,UAAU,GACV,gBAAgB,GAChB,SAAS,GACT,QAAQ,GACR,SAAS,CAAA;AAEb;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,YAAY,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,aAAa,EAAE,CAAA;IAClC,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,cAAc,CAAC,EAAE;QACf,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,UAAU,CAAC,EAAE;QACX,UAAU,EAAE,MAAM,CAAA;QAClB,aAAa,EAAE,MAAM,CAAA;KACtB,CAAA;CACF;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,EA+rBlC,CAAA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,QAAQ,EAAE,CAEjE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,QAAQ,EAAE,CAErE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,CAI5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,KAAK,CAAC;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf,CAAC,CAyBD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAuBtE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsC9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAmD3D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAoGlD"}
+{"version":3,"file":"tool-catalog.d.ts","sourceRoot":"","sources":["../../src/mcp/tool-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,MAAM,GACN,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,GACP,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,UAAU,CAAA;AAEd;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,UAAU,GACV,gBAAgB,GAChB,SAAS,GACT,QAAQ,GACR,SAAS,CAAA;AAEb;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,YAAY,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,aAAa,EAAE,CAAA;IAClC,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,cAAc,CAAC,EAAE;QACf,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,UAAU,CAAC,EAAE;QACX,UAAU,EAAE,MAAM,CAAA;QAClB,aAAa,EAAE,MAAM,CAAA;KACtB,CAAA;CACF;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,EAkvBlC,CAAA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,QAAQ,EAAE,CAEjE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,QAAQ,EAAE,CAErE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,CAI5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,KAAK,CAAC;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf,CAAC,CAyBD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAuBtE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsC9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAmD3D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAoGlD"}

package/dist/mcp/tool-catalog.js

@@ -688,6 +688,53 @@ export const TOOL_CATALOG = [
         ],
         relatedTools: ['dino_spec_analyze', 'dino_spec_feedback', 'dino_memory_recall'],
     },
+    // =====================================================================
+    // VALIDATION TOOLS (v17.4.0)
+    // =====================================================================
+    {
+        name: 'dino_validate_package',
+        category: 'analysis',
+        description: 'Validate a package for security vulnerabilities, size, and quality before installation (v17.4.0)',
+        whenToUse: 'Before adding a new dependency to check for security issues, package size, and quality metrics.',
+        whenNotToUse: 'For packages already validated or internal packages.',
+        recommendedPhases: ['discovery', 'planning'],
+        exampleScenarios: [
+            'Validating lodash before adding it as a dependency',
+            'Checking a package for known vulnerabilities',
+            'Verifying package size is within acceptable limits',
+            'Checking if a package is deprecated or unmaintained',
+        ],
+        relatedTools: ['dino_validate_deps', 'dino_security_scan'],
+    },
+    {
+        name: 'dino_validate_deps',
+        category: 'analysis',
+        description: 'Batch validate multiple packages or all dependencies from package.json (v17.4.0)',
+        whenToUse: 'To audit all project dependencies or validate a list of packages at once.',
+        whenNotToUse: 'For single package validation - use dino_validate_package instead.',
+        recommendedPhases: ['discovery', 'planning', 'review'],
+        exampleScenarios: [
+            'Auditing all dependencies in package.json',
+            'Validating a list of packages before a major upgrade',
+            'Checking devDependencies for security issues',
+            'Running dependency validation as part of Ralph Gate',
+        ],
+        relatedTools: ['dino_validate_package', 'dino_security_scan'],
+    },
+    {
+        name: 'dino_security_scan',
+        category: 'analysis',
+        description: 'Fast security-only scan for package vulnerabilities via npm audit (v17.4.0)',
+        whenToUse: 'When you only need security information without size/quality checks. Faster than full validation.',
+        whenNotToUse: 'When you also need size and quality metrics - use dino_validate_package.',
+        recommendedPhases: ['discovery', 'planning'],
+        exampleScenarios: [
+            'Quick security check before installing a package',
+            'Scanning for vulnerabilities in a recommended package',
+            'Checking if a package has critical security issues',
+        ],
+        relatedTools: ['dino_validate_package', 'dino_validate_deps'],
+    },
 ];
 /**
  * Get tools recommended for a workflow phase