specweave 0.21.2 → 0.22.0

package/dist/src/core/hooks/HookExecutor.js

@@ -0,0 +1,287 @@
+/**
+ * Hook Executor
+ *
+ * Executes hooks in isolated environment and validates results.
+ * Detects import errors, runtime errors, timeouts, and performance issues.
+ *
+ * Part of increment 0037: Hook Health Check System
+ */
+import { spawn } from 'child_process';
+import * as path from 'path';
+/**
+ * Hook Executor - Validates hook execution
+ */
+export class HookExecutor {
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Execute hook and capture result
+     */
+    async executeHook(hook) {
+        const startTime = Date.now();
+        const timestamp = new Date().toISOString();
+        try {
+            const { exitCode, stdout, stderr } = await this.runHookProcess(hook);
+            const executionTime = Date.now() - startTime;
+            // Analyze execution result
+            const errors = this.detectErrors(stderr, hook);
+            const warnings = this.detectWarnings(stdout, stderr, executionTime, hook);
+            const performanceIssue = this.checkPerformance(executionTime, hook);
+            const success = exitCode === 0 && errors.length === 0;
+            return {
+                hook: hook.name,
+                plugin: hook.plugin,
+                success,
+                exitCode,
+                stdout,
+                stderr,
+                executionTime,
+                errors,
+                warnings,
+                timestamp,
+                performanceIssue,
+                performanceRatio: hook.expectedDuration
+                    ? executionTime / hook.expectedDuration
+                    : undefined
+            };
+        }
+        catch (error) {
+            // Execution failed completely
+            const executionTime = Date.now() - startTime;
+            return {
+                hook: hook.name,
+                plugin: hook.plugin,
+                success: false,
+                exitCode: -1,
+                stdout: '',
+                stderr: error instanceof Error ? error.message : String(error),
+                executionTime,
+                errors: [{
+                        type: 'runtime',
+                        message: `Hook execution failed: ${error instanceof Error ? error.message : String(error)}`,
+                        fixable: false
+                    }],
+                warnings: [],
+                timestamp,
+                performanceIssue: false
+            };
+        }
+    }
+    /**
+     * Run hook as child process
+     */
+    async runHookProcess(hook) {
+        return new Promise((resolve, reject) => {
+            const args = this.getHookArgs(hook);
+            const command = this.getHookCommand(hook);
+            const childProcess = spawn(command, args, {
+                cwd: path.dirname(hook.path),
+                env: { ...process.env, NODE_ENV: 'test' },
+                timeout: this.config.timeout
+            });
+            let stdout = '';
+            let stderr = '';
+            if (this.config.captureStdout) {
+                childProcess.stdout?.on('data', (data) => {
+                    stdout += data.toString();
+                });
+            }
+            if (this.config.captureStderr) {
+                childProcess.stderr?.on('data', (data) => {
+                    stderr += data.toString();
+                });
+            }
+            childProcess.on('close', (exitCode) => {
+                resolve({
+                    exitCode: exitCode || 0,
+                    stdout,
+                    stderr
+                });
+            });
+            childProcess.on('error', (error) => {
+                reject(error);
+            });
+            // Handle timeout
+            setTimeout(() => {
+                if (!childProcess.killed) {
+                    childProcess.kill('SIGTERM');
+                    reject(new Error(`Hook execution timeout (${this.config.timeout}ms)`));
+                }
+            }, this.config.timeout);
+        });
+    }
+    /**
+     * Get command to execute hook
+     */
+    getHookCommand(hook) {
+        if (hook.type === 'shell') {
+            return 'bash';
+        }
+        else {
+            return 'node';
+        }
+    }
+    /**
+     * Get arguments for hook execution
+     */
+    getHookArgs(hook) {
+        if (hook.type === 'shell') {
+            return [hook.path];
+        }
+        else {
+            // For TypeScript hooks, run the compiled JavaScript
+            const jsPath = hook.path.replace(/\.ts$/, '.js').replace('/lib/hooks/', '/lib/hooks/');
+            const distPath = jsPath.replace(/^plugins\//, 'dist/plugins/');
+            return [distPath, this.config.testIncrementId];
+        }
+    }
+    /**
+     * Detect errors in hook execution
+     */
+    detectErrors(stderr, hook) {
+        const errors = [];
+        // Detect import errors (ERR_MODULE_NOT_FOUND)
+        if (stderr.includes('ERR_MODULE_NOT_FOUND')) {
+            const importError = this.parseImportError(stderr);
+            if (importError) {
+                errors.push({
+                    type: 'import',
+                    message: importError.message,
+                    suggestion: importError.suggestion,
+                    fixable: importError.fixable
+                });
+            }
+        }
+        // Detect static vs instance method errors
+        if (stderr.includes('Did you mean to access the static member')) {
+            errors.push({
+                type: 'runtime',
+                message: 'Using instance method instead of static method',
+                suggestion: 'Use ClassName.methodName() instead of this.methodName()',
+                fixable: false // Requires code review
+            });
+        }
+        // Detect syntax errors
+        if (stderr.includes('SyntaxError')) {
+            const syntaxMatch = stderr.match(/SyntaxError: (.+)/);
+            errors.push({
+                type: 'syntax',
+                message: syntaxMatch ? syntaxMatch[1] : 'Syntax error in hook code',
+                fixable: false
+            });
+        }
+        // Detect JSON parse errors
+        if (stderr.includes('Unexpected token') && stderr.includes('JSON')) {
+            errors.push({
+                type: 'validation',
+                message: 'Invalid JSON input to hook',
+                suggestion: 'Validate hook input format matches expected schema',
+                fixable: false
+            });
+        }
+        return errors;
+    }
+    /**
+     * Parse import error from stderr
+     */
+    parseImportError(stderr) {
+        const moduleMatch = stderr.match(/Cannot find module '(.+?)'/);
+        if (!moduleMatch) {
+            return null;
+        }
+        const missingModule = moduleMatch[1];
+        const hasExtension = missingModule.endsWith('.js');
+        let suggestion = '';
+        let fixable = false;
+        if (!hasExtension) {
+            suggestion = `Add .js extension: import from '${missingModule}.js'`;
+            fixable = true;
+        }
+        else {
+            suggestion = `Verify module exists at path: ${missingModule}`;
+            fixable = false;
+        }
+        return {
+            type: 'import',
+            message: `Cannot find module '${missingModule}'`,
+            suggestion,
+            fixable
+        };
+    }
+    /**
+     * Detect warnings in hook execution
+     */
+    detectWarnings(stdout, stderr, executionTime, hook) {
+        const warnings = [];
+        // Performance warning
+        if (hook.expectedDuration && executionTime > hook.expectedDuration * 2) {
+            warnings.push({
+                type: 'performance',
+                message: `Hook took ${executionTime}ms (expected ${hook.expectedDuration}ms)`,
+                severity: 'medium',
+                recommendation: 'Optimize hook performance or increase expected duration'
+            });
+        }
+        // Deprecation warnings
+        if (stderr.includes('DeprecationWarning')) {
+            warnings.push({
+                type: 'deprecation',
+                message: 'Hook uses deprecated APIs',
+                severity: 'low',
+                recommendation: 'Update to use current APIs'
+            });
+        }
+        return warnings;
+    }
+    /**
+     * Check if hook has performance issues
+     */
+    checkPerformance(executionTime, hook) {
+        if (!hook.expectedDuration) {
+            return false;
+        }
+        // Performance issue if >2x expected duration
+        return executionTime > hook.expectedDuration * 2;
+    }
+    /**
+     * Extract import error details for auto-fixing
+     */
+    extractImportErrorDetails(stderr, hookPath) {
+        const moduleMatch = stderr.match(/Cannot find module '(.+?)'/);
+        const importingMatch = stderr.match(/imported from '(.+?)'/);
+        if (!moduleMatch) {
+            return null;
+        }
+        const modulePath = moduleMatch[1];
+        const importingFile = importingMatch ? importingMatch[1] : hookPath;
+        // Check if .js extension is missing
+        const hasExtension = modulePath.endsWith('.js');
+        const suggestedPath = hasExtension ? modulePath : `${modulePath}.js`;
+        // Determine fix confidence
+        let fixConfidence = 'medium';
+        if (!hasExtension && !modulePath.includes('node_modules')) {
+            fixConfidence = 'high'; // High confidence for relative imports missing .js
+        }
+        return {
+            modulePath,
+            importingFile,
+            importStatement: '', // Would need to parse file to get exact statement
+            hasExtension,
+            suggestedPath,
+            fixConfidence
+        };
+    }
+    /**
+     * Create default executor config
+     */
+    static createDefaultConfig() {
+        return {
+            timeout: 5000, // 5 seconds
+            captureStdout: true,
+            captureStderr: true,
+            testIncrementId: '__health-check-test__'
+        };
+    }
+}
+//# sourceMappingURL=HookExecutor.js.map

package/dist/src/core/hooks/HookExecutor.js.map

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

package/dist/src/core/hooks/HookHealthChecker.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Hook Health Checker
+ *
+ * Main orchestrator for hook health monitoring system.
+ * Coordinates scanning, execution, validation, and reporting.
+ *
+ * Part of increment 0037: Hook Health Check System
+ */
+import { HookDefinition, HealthCheckResult, HealthCheckConfig, HookExecutionResult } from './types.js';
+/**
+ * Hook Health Checker - Main orchestrator
+ */
+export declare class HookHealthChecker {
+    private config;
+    private scanner;
+    private executor;
+    constructor(config: HealthCheckConfig);
+    /**
+     * Run full health check on all hooks
+     */
+    checkAllHooks(): Promise<HealthCheckResult>;
+    /**
+     * Check specific hook by name
+     */
+    checkHook(hookName: string): Promise<HookExecutionResult | null>;
+    /**
+     * Get all discovered hooks
+     */
+    scanHooks(): Promise<HookDefinition[]>;
+    /**
+     * Calculate overall health status
+     */
+    private calculateOverallHealth;
+    /**
+     * Check if result is for a critical hook
+     */
+    private isResultCritical;
+    /**
+     * Check if hook name is critical
+     */
+    private isHookCritical;
+    /**
+     * Generate health summary with recommendations
+     */
+    private generateSummary;
+    /**
+     * Create default health check config
+     */
+    static createDefaultConfig(projectRoot: string): HealthCheckConfig;
+}
+//# sourceMappingURL=HookHealthChecker.d.ts.map

package/dist/src/core/hooks/HookHealthChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HookHealthChecker.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/HookHealthChecker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EAEjB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAe;gBAEnB,MAAM,EAAE,iBAAiB;IAqBrC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAiDjD;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IActE;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAO5C;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoEvB;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB;CAYnE"}

package/dist/src/core/hooks/HookHealthChecker.js

@@ -0,0 +1,212 @@
+/**
+ * Hook Health Checker
+ *
+ * Main orchestrator for hook health monitoring system.
+ * Coordinates scanning, execution, validation, and reporting.
+ *
+ * Part of increment 0037: Hook Health Check System
+ */
+import { HookScanner } from './HookScanner.js';
+import { HookExecutor } from './HookExecutor.js';
+/**
+ * Hook Health Checker - Main orchestrator
+ */
+export class HookHealthChecker {
+    constructor(config) {
+        this.config = config;
+        // Initialize scanner
+        const scannerConfig = {
+            projectRoot: config.projectRoot,
+            pluginDirs: [], // Will be populated by findPluginDirectories
+            includeNonTestable: !config.criticalOnly
+        };
+        this.scanner = new HookScanner(scannerConfig);
+        // Initialize executor
+        const executorConfig = {
+            timeout: config.timeout,
+            captureStdout: true,
+            captureStderr: true,
+            testIncrementId: '__health-check-test__'
+        };
+        this.executor = new HookExecutor(executorConfig);
+    }
+    /**
+     * Run full health check on all hooks
+     */
+    async checkAllHooks() {
+        const startTime = Date.now();
+        // 1. Discover all hooks
+        const pluginDirs = await HookScanner.findPluginDirectories(this.config.projectRoot);
+        this.scanner.config.pluginDirs = pluginDirs;
+        let allHooks = await this.scanner.scanHooks();
+        // 2. Filter hooks if needed
+        if (this.config.criticalOnly) {
+            allHooks = allHooks.filter(h => h.critical);
+        }
+        if (this.config.hooksToCheck.length > 0) {
+            allHooks = allHooks.filter(h => this.config.hooksToCheck.includes(h.name));
+        }
+        // 3. Execute all hooks
+        const results = [];
+        for (const hook of allHooks) {
+            if (!hook.testable && !this.config.verbose) {
+                continue; // Skip non-testable hooks in non-verbose mode
+            }
+            const result = await this.executor.executeHook(hook);
+            results.push(result);
+        }
+        // 4. Calculate overall health
+        const totalExecutionTime = Date.now() - startTime;
+        const overallHealth = this.calculateOverallHealth(results);
+        const summary = this.generateSummary(results);
+        return {
+            timestamp: new Date().toISOString(),
+            totalHooks: results.length,
+            passedHooks: results.filter(r => r.success).length,
+            failedHooks: results.filter(r => !r.success).length,
+            criticalFailures: results.filter(r => !r.success && this.isHookCritical(r.hook, allHooks)).length,
+            overallHealth,
+            results,
+            summary,
+            totalExecutionTime,
+            projectRoot: this.config.projectRoot
+        };
+    }
+    /**
+     * Check specific hook by name
+     */
+    async checkHook(hookName) {
+        const pluginDirs = await HookScanner.findPluginDirectories(this.config.projectRoot);
+        this.scanner.config.pluginDirs = pluginDirs;
+        const allHooks = await this.scanner.scanHooks();
+        const hook = allHooks.find(h => h.name === hookName);
+        if (!hook) {
+            return null;
+        }
+        return await this.executor.executeHook(hook);
+    }
+    /**
+     * Get all discovered hooks
+     */
+    async scanHooks() {
+        const pluginDirs = await HookScanner.findPluginDirectories(this.config.projectRoot);
+        this.scanner.config.pluginDirs = pluginDirs;
+        return await this.scanner.scanHooks();
+    }
+    /**
+     * Calculate overall health status
+     */
+    calculateOverallHealth(results) {
+        if (results.length === 0) {
+            return 'healthy'; // No hooks to check
+        }
+        const failedCount = results.filter(r => !r.success).length;
+        const total = results.length;
+        const failureRate = failedCount / total;
+        // Check for critical failures
+        const criticalFailures = results.filter(r => !r.success && this.isResultCritical(r));
+        if (criticalFailures.length > 0) {
+            return 'unhealthy'; // Any critical failure = unhealthy
+        }
+        if (failureRate > 0.3) {
+            return 'degraded'; // >30% failure rate = degraded
+        }
+        if (failureRate > 0) {
+            return 'degraded'; // Any failures = degraded
+        }
+        return 'healthy';
+    }
+    /**
+     * Check if result is for a critical hook
+     */
+    isResultCritical(result) {
+        const criticalHooks = ['post-task-completion', 'user-prompt-submit'];
+        return criticalHooks.includes(result.hook);
+    }
+    /**
+     * Check if hook name is critical
+     */
+    isHookCritical(hookName, allHooks) {
+        const hook = allHooks.find(h => h.name === hookName);
+        return hook?.critical || false;
+    }
+    /**
+     * Generate health summary with recommendations
+     */
+    generateSummary(results) {
+        const failedResults = results.filter(r => !r.success);
+        const fixableIssues = failedResults.filter(r => r.errors.some(e => e.fixable)).length;
+        const manualIssues = failedResults.length - fixableIssues;
+        const recommendations = [];
+        const slowHooks = [];
+        const criticalHooksFailed = [];
+        // Analyze results and generate recommendations
+        for (const result of results) {
+            // Performance issues
+            if (result.performanceIssue) {
+                slowHooks.push(result.hook);
+                recommendations.push(`Optimize ${result.hook} (${result.executionTime}ms)`);
+            }
+            // Failures
+            if (!result.success) {
+                if (this.isResultCritical(result)) {
+                    criticalHooksFailed.push(result.hook);
+                }
+                // Generate specific recommendations from errors
+                for (const error of result.errors) {
+                    if (error.suggestion) {
+                        recommendations.push(`${result.hook}: ${error.suggestion}`);
+                    }
+                }
+            }
+        }
+        // Add auto-fix recommendation if applicable
+        if (fixableIssues > 0) {
+            recommendations.unshift(`Run with --fix to automatically repair ${fixableIssues} issue(s)`);
+        }
+        // Determine overall status
+        let status = 'pass';
+        let message = '';
+        if (criticalHooksFailed.length > 0) {
+            status = 'fail';
+            message = `${criticalHooksFailed.length} critical hook(s) failed: ${criticalHooksFailed.join(', ')}`;
+        }
+        else if (failedResults.length > 0) {
+            status = 'warn';
+            message = `${failedResults.length} hook(s) failed (non-critical)`;
+        }
+        else if (slowHooks.length > 0) {
+            status = 'warn';
+            message = `${slowHooks.length} hook(s) have performance issues`;
+        }
+        else {
+            status = 'pass';
+            message = 'All hooks are healthy';
+        }
+        return {
+            status,
+            message,
+            recommendations,
+            fixableIssues,
+            manualIssues,
+            slowHooks,
+            criticalHooksFailed
+        };
+    }
+    /**
+     * Create default health check config
+     */
+    static createDefaultConfig(projectRoot) {
+        return {
+            projectRoot,
+            timeout: 5000,
+            autoFix: false,
+            verbose: false,
+            criticalOnly: false,
+            hooksToCheck: [],
+            performanceThreshold: 2.0,
+            failOnWarnings: false
+        };
+    }
+}
+//# sourceMappingURL=HookHealthChecker.js.map

package/dist/src/core/hooks/HookHealthChecker.js.map

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

package/dist/src/core/hooks/HookScanner.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Hook Scanner
+ *
+ * Discovers and catalogs all hooks in the project.
+ * Scans plugin directories, parses hook metadata, and builds hook registry.
+ *
+ * Part of increment 0037: Hook Health Check System
+ */
+import { HookDefinition, ScannerConfig } from './types.js';
+/**
+ * Hook Scanner - Discovers hooks in project
+ */
+export declare class HookScanner {
+    private config;
+    constructor(config: ScannerConfig);
+    /**
+     * Scan project for all hooks
+     */
+    scanHooks(): Promise<HookDefinition[]>;
+    /**
+     * Scan hooks in a specific plugin directory
+     */
+    private scanPluginHooks;
+    /**
+     * Check if file is a hook trigger file
+     */
+    private isHookFile;
+    /**
+     * Parse hook file and extract metadata
+     */
+    private parseHookFile;
+    /**
+     * Extract hook trigger from hook name
+     */
+    private extractTrigger;
+    /**
+     * Get file type from extension
+     */
+    private getFileType;
+    /**
+     * Extract dependencies from hook file
+     */
+    private extractDependencies;
+    /**
+     * Determine if hook is critical (failure blocks workflow)
+     */
+    private isCriticalHook;
+    /**
+     * Determine if hook is testable in isolation
+     */
+    private isTestableHook;
+    /**
+     * Get expected execution duration for hook (ms)
+     */
+    private getExpectedDuration;
+    /**
+     * Find all plugin directories in project
+     */
+    static findPluginDirectories(projectRoot: string): Promise<string[]>;
+    /**
+     * Create default scanner config
+     */
+    static createDefaultConfig(projectRoot: string): Promise<ScannerConfig>;
+}
+//# sourceMappingURL=HookScanner.d.ts.map

package/dist/src/core/hooks/HookScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HookScanner.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/HookScanner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,cAAc,EAGd,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,aAAa;IAIjC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAiB5C;;OAEG;YACW,eAAe;IA2B7B;;OAEG;IACH,OAAO,CAAC,UAAU;IAMlB;;OAEG;YACW,aAAa;IA2B3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;YACW,mBAAmB;IAsBjC;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;WACU,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmB1E;;OAEG;WACU,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAS9E"}