specweave 0.21.2 → 0.22.0

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

@@ -0,0 +1,214 @@
+/**
+ * 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 * as fs from 'fs-extra';
+import * as path from 'path';
+/**
+ * Hook Scanner - Discovers hooks in project
+ */
+export class HookScanner {
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Scan project for all hooks
+     */
+    async scanHooks() {
+        const hooks = [];
+        for (const pluginDir of this.config.pluginDirs) {
+            const hooksDir = path.join(pluginDir, 'hooks');
+            if (!fs.existsSync(hooksDir)) {
+                continue; // No hooks in this plugin
+            }
+            const pluginHooks = await this.scanPluginHooks(hooksDir, path.basename(pluginDir));
+            hooks.push(...pluginHooks);
+        }
+        return hooks;
+    }
+    /**
+     * Scan hooks in a specific plugin directory
+     */
+    async scanPluginHooks(hooksDir, pluginName) {
+        const hooks = [];
+        const files = fs.readdirSync(hooksDir);
+        for (const file of files) {
+            const filePath = path.join(hooksDir, file);
+            const stat = fs.statSync(filePath);
+            if (stat.isDirectory()) {
+                // Skip subdirectories (lib/, etc.)
+                continue;
+            }
+            // Only check hook trigger files (.sh or .ts)
+            if (!this.isHookFile(file)) {
+                continue;
+            }
+            const hook = await this.parseHookFile(filePath, pluginName);
+            if (hook) {
+                hooks.push(hook);
+            }
+        }
+        return hooks;
+    }
+    /**
+     * Check if file is a hook trigger file
+     */
+    isHookFile(filename) {
+        // Hook trigger files: *.sh (bash hooks)
+        // Exclude lib/ subdirectories
+        return filename.endsWith('.sh') && !filename.includes('lib/');
+    }
+    /**
+     * Parse hook file and extract metadata
+     */
+    async parseHookFile(filePath, pluginName) {
+        const filename = path.basename(filePath);
+        const hookName = filename.replace(/\.(sh|ts|js)$/, '');
+        const trigger = this.extractTrigger(hookName);
+        if (!trigger) {
+            return null; // Not a recognized hook trigger
+        }
+        const fileType = this.getFileType(filename);
+        const dependencies = await this.extractDependencies(filePath, fileType);
+        const critical = this.isCriticalHook(hookName);
+        const testable = this.isTestableHook(hookName, fileType);
+        return {
+            name: hookName,
+            plugin: pluginName,
+            path: filePath,
+            type: fileType,
+            dependencies,
+            trigger,
+            testable,
+            critical,
+            expectedDuration: this.getExpectedDuration(hookName)
+        };
+    }
+    /**
+     * Extract hook trigger from hook name
+     */
+    extractTrigger(hookName) {
+        const triggerMap = {
+            'user-prompt-submit': 'user-prompt-submit',
+            'post-task-completion': 'post-task-completion',
+            'post-increment-change': 'post-increment-change',
+            'pre-tool-use': 'pre-tool-use',
+            'post-write': 'post-write',
+            'post-edit': 'post-edit'
+        };
+        return triggerMap[hookName] || null;
+    }
+    /**
+     * Get file type from extension
+     */
+    getFileType(filename) {
+        if (filename.endsWith('.sh')) {
+            return 'shell';
+        }
+        else if (filename.endsWith('.ts')) {
+            return 'typescript';
+        }
+        else if (filename.endsWith('.js')) {
+            return 'javascript';
+        }
+        return 'shell'; // Default
+    }
+    /**
+     * Extract dependencies from hook file
+     */
+    async extractDependencies(filePath, fileType) {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const dependencies = [];
+        if (fileType === 'shell') {
+            // Extract dependencies from bash script
+            // Look for node invocations
+            const nodeMatches = Array.from(content.matchAll(/node\s+([^\s]+)/g));
+            for (const match of nodeMatches) {
+                dependencies.push(match[1]);
+            }
+        }
+        else {
+            // Extract TypeScript/JavaScript imports
+            const importMatches = Array.from(content.matchAll(/import\s+.*\s+from\s+['"](.+?)['"]/g));
+            for (const match of importMatches) {
+                dependencies.push(match[1]);
+            }
+        }
+        return dependencies;
+    }
+    /**
+     * Determine if hook is critical (failure blocks workflow)
+     */
+    isCriticalHook(hookName) {
+        const criticalHooks = [
+            'post-task-completion', // AC sync, living docs sync
+            'user-prompt-submit' // Input validation
+        ];
+        return criticalHooks.includes(hookName);
+    }
+    /**
+     * Determine if hook is testable in isolation
+     */
+    isTestableHook(hookName, fileType) {
+        // Shell hooks that call Node.js scripts are testable
+        // TypeScript/JavaScript hooks are directly testable
+        if (fileType === 'typescript' || fileType === 'javascript') {
+            return true;
+        }
+        // Some bash hooks are wrappers that call Node.js - testable
+        const testableShellHooks = [
+            'post-task-completion',
+            'post-increment-change'
+        ];
+        return testableShellHooks.includes(hookName);
+    }
+    /**
+     * Get expected execution duration for hook (ms)
+     */
+    getExpectedDuration(hookName) {
+        const durationMap = {
+            'update-ac-status': 100, // 100ms
+            'auto-transition': 50, // 50ms
+            'sync-living-docs': 200, // 200ms
+            'translate-living-docs': 150, // 150ms
+            'update-tasks-md': 80, // 80ms
+            'update-status-line': 50, // 50ms
+            'prepare-reflection-context': 60, // 60ms
+            'invoke-translator-skill': 40 // 40ms
+        };
+        return durationMap[hookName] || 100; // Default 100ms
+    }
+    /**
+     * Find all plugin directories in project
+     */
+    static async findPluginDirectories(projectRoot) {
+        const pluginsDir = path.join(projectRoot, 'plugins');
+        if (!fs.existsSync(pluginsDir)) {
+            return [];
+        }
+        const entries = fs.readdirSync(pluginsDir, { withFileTypes: true });
+        const pluginDirs = [];
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                pluginDirs.push(path.join(pluginsDir, entry.name));
+            }
+        }
+        return pluginDirs;
+    }
+    /**
+     * Create default scanner config
+     */
+    static async createDefaultConfig(projectRoot) {
+        const pluginDirs = await this.findPluginDirectories(projectRoot);
+        return {
+            projectRoot,
+            pluginDirs,
+            includeNonTestable: true
+        };
+    }
+}
+//# sourceMappingURL=HookScanner.js.map

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

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

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

@@ -0,0 +1,281 @@
+/**
+ * Hook Health Check Types
+ *
+ * Type definitions for the hook health monitoring system.
+ * Supports detection, validation, and auto-fixing of hook failures.
+ *
+ * Part of increment 0037: Hook Health Check System
+ */
+/**
+ * Trigger event that causes a hook to execute
+ */
+export type HookTrigger = 'user-prompt-submit' | 'post-task-completion' | 'post-increment-change' | 'pre-tool-use' | 'post-write' | 'post-edit';
+/**
+ * Hook file type
+ */
+export type HookType = 'shell' | 'typescript' | 'javascript';
+/**
+ * Hook definition discovered by scanner
+ */
+export interface HookDefinition {
+    /** Hook name (e.g., "update-ac-status") */
+    name: string;
+    /** Plugin that owns this hook (e.g., "specweave") */
+    plugin: string;
+    /** Absolute path to hook file */
+    path: string;
+    /** File type */
+    type: HookType;
+    /** Imported modules/dependencies */
+    dependencies: string[];
+    /** Trigger event */
+    trigger: HookTrigger;
+    /** Can be tested in isolation */
+    testable: boolean;
+    /** Failure blocks workflow (critical hooks) */
+    critical: boolean;
+    /** Expected execution time (ms) */
+    expectedDuration?: number;
+}
+/**
+ * Error detected during hook execution
+ */
+export interface HookError {
+    /** Error type */
+    type: 'import' | 'runtime' | 'timeout' | 'validation' | 'syntax';
+    /** Error message */
+    message: string;
+    /** Stack trace (if available) */
+    stack?: string;
+    /** Auto-fix suggestion */
+    suggestion?: string;
+    /** Can be auto-fixed */
+    fixable: boolean;
+    /** Line number where error occurred */
+    line?: number;
+    /** Column number where error occurred */
+    column?: number;
+}
+/**
+ * Warning detected during hook execution
+ */
+export interface HookWarning {
+    /** Warning type */
+    type: 'performance' | 'deprecation' | 'best-practice' | 'security';
+    /** Warning message */
+    message: string;
+    /** Severity level */
+    severity: 'low' | 'medium' | 'high';
+    /** Recommendation to address warning */
+    recommendation?: string;
+}
+/**
+ * Result of executing a single hook
+ */
+export interface HookExecutionResult {
+    /** Hook name */
+    hook: string;
+    /** Plugin name */
+    plugin: string;
+    /** Hook passed health check */
+    success: boolean;
+    /** Process exit code */
+    exitCode: number;
+    /** Standard output */
+    stdout: string;
+    /** Standard error */
+    stderr: string;
+    /** Execution time in milliseconds */
+    executionTime: number;
+    /** Detected errors */
+    errors: HookError[];
+    /** Detected warnings */
+    warnings: HookWarning[];
+    /** Execution timestamp */
+    timestamp: string;
+    /** Performance threshold exceeded */
+    performanceIssue: boolean;
+    /** Expected vs actual duration */
+    performanceRatio?: number;
+}
+/**
+ * Overall health check result
+ */
+export interface HealthCheckResult {
+    /** Check timestamp */
+    timestamp: string;
+    /** Total hooks checked */
+    totalHooks: number;
+    /** Hooks that passed */
+    passedHooks: number;
+    /** Hooks that failed */
+    failedHooks: number;
+    /** Critical hook failures */
+    criticalFailures: number;
+    /** Overall health status */
+    overallHealth: 'healthy' | 'degraded' | 'unhealthy';
+    /** Individual hook results */
+    results: HookExecutionResult[];
+    /** Summary and recommendations */
+    summary: HealthSummary;
+    /** Total execution time */
+    totalExecutionTime: number;
+    /** Project root path */
+    projectRoot: string;
+}
+/**
+ * Health check summary with recommendations
+ */
+export interface HealthSummary {
+    /** Pass/warn/fail status */
+    status: 'pass' | 'warn' | 'fail';
+    /** Summary message */
+    message: string;
+    /** Actionable recommendations */
+    recommendations: string[];
+    /** Number of auto-fixable issues */
+    fixableIssues: number;
+    /** Number of issues requiring manual intervention */
+    manualIssues: number;
+    /** Hooks with performance issues */
+    slowHooks: string[];
+    /** Critical hooks that failed */
+    criticalHooksFailed: string[];
+}
+/**
+ * Auto-fix result
+ */
+export interface FixResult {
+    /** Hook that was fixed */
+    hook: string;
+    /** Fix was successful */
+    success: boolean;
+    /** Type of fix applied */
+    fixType: 'import' | 'static-method' | 'timeout' | 'dependency';
+    /** Fix description */
+    description: string;
+    /** Files modified */
+    filesModified: string[];
+    /** Error if fix failed */
+    error?: string;
+    /** Verification after fix */
+    verification?: HookExecutionResult;
+}
+/**
+ * Auto-fix batch result
+ */
+export interface BatchFixResult {
+    /** Total fixes attempted */
+    totalFixes: number;
+    /** Successful fixes */
+    successfulFixes: number;
+    /** Failed fixes */
+    failedFixes: number;
+    /** Individual fix results */
+    results: FixResult[];
+    /** Hooks that require manual intervention */
+    manualFixRequired: string[];
+    /** Overall success */
+    success: boolean;
+}
+/**
+ * Hook health check configuration
+ */
+export interface HealthCheckConfig {
+    /** Project root directory */
+    projectRoot: string;
+    /** Timeout for hook execution (ms) */
+    timeout: number;
+    /** Run auto-fix for detected issues */
+    autoFix: boolean;
+    /** Verbose output */
+    verbose: boolean;
+    /** Check only critical hooks */
+    criticalOnly: boolean;
+    /** Specific hooks to check (empty = all) */
+    hooksToCheck: string[];
+    /** Performance threshold ratio (actual/expected) */
+    performanceThreshold: number;
+    /** Fail on warnings */
+    failOnWarnings: boolean;
+}
+/**
+ * Health report format
+ */
+export type ReportFormat = 'console' | 'markdown' | 'json' | 'junit';
+/**
+ * Health report options
+ */
+export interface ReportOptions {
+    /** Output format */
+    format: ReportFormat;
+    /** Output file path (null = stdout) */
+    outputPath?: string;
+    /** Include full details */
+    detailed: boolean;
+    /** Color output for console */
+    color: boolean;
+    /** Show only failures */
+    failuresOnly: boolean;
+}
+/**
+ * Scanner configuration
+ */
+export interface ScannerConfig {
+    /** Project root */
+    projectRoot: string;
+    /** Plugin directories to scan */
+    pluginDirs: string[];
+    /** Include non-testable hooks */
+    includeNonTestable: boolean;
+}
+/**
+ * Executor configuration
+ */
+export interface ExecutorConfig {
+    /** Execution timeout (ms) */
+    timeout: number;
+    /** Capture stdout */
+    captureStdout: boolean;
+    /** Capture stderr */
+    captureStderr: boolean;
+    /** Test increment ID to use */
+    testIncrementId: string;
+    /** Test input data */
+    testInput?: any;
+}
+/**
+ * Import error details
+ */
+export interface ImportErrorDetails {
+    /** Missing module path */
+    modulePath: string;
+    /** Importing file */
+    importingFile: string;
+    /** Import statement line */
+    importStatement: string;
+    /** Has .js extension */
+    hasExtension: boolean;
+    /** Suggested fix */
+    suggestedPath: string;
+    /** Fix confidence */
+    fixConfidence: 'high' | 'medium' | 'low';
+}
+/**
+ * Performance analysis result
+ */
+export interface PerformanceAnalysis {
+    /** Hook name */
+    hook: string;
+    /** Actual execution time (ms) */
+    actualTime: number;
+    /** Expected execution time (ms) */
+    expectedTime: number;
+    /** Performance ratio (actual/expected) */
+    ratio: number;
+    /** Exceeds threshold */
+    exceedsThreshold: boolean;
+    /** Performance recommendation */
+    recommendation?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Hook Health Check Types
+ *
+ * Type definitions for the hook health monitoring system.
+ * Supports detection, validation, and auto-fixing of hook failures.
+ *
+ * Part of increment 0037: Hook Health Check System
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/hooks/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/src/core/iac/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Infrastructure as Code (IaC) Generation - Barrel Exports
+ *
+ * This module provides Terraform template generation capabilities for serverless platforms:
+ * - Handlebars template engine
+ * - Multi-platform support (AWS Lambda, Azure Functions, GCP, Firebase, Supabase)
+ * - Environment-specific configuration (dev, staging, prod)
+ */
+export * from './template-engine.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/iac/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/iac/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,sBAAsB,CAAC"}

package/dist/src/core/iac/index.js

@@ -0,0 +1,11 @@
+/**
+ * Infrastructure as Code (IaC) Generation - Barrel Exports
+ *
+ * This module provides Terraform template generation capabilities for serverless platforms:
+ * - Handlebars template engine
+ * - Multi-platform support (AWS Lambda, Azure Functions, GCP, Firebase, Supabase)
+ * - Environment-specific configuration (dev, staging, prod)
+ */
+// Template engine
+export * from './template-engine.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/iac/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/iac/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,kBAAkB;AAClB,cAAc,sBAAsB,CAAC"}

package/dist/src/core/iac/template-engine.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Terraform Template Engine
+ *
+ * Renders Terraform templates using Handlebars with platform-specific variables.
+ */
+export interface TemplateVariables {
+    projectName?: string;
+    projectDescription?: string;
+    environment?: 'dev' | 'staging' | 'prod';
+    provider?: 'aws' | 'azure' | 'gcp' | 'firebase' | 'supabase';
+    region?: string;
+    functionName?: string;
+    runtime?: string;
+    handler?: string;
+    memorySize?: number;
+    timeout?: number;
+    databaseName?: string;
+    databaseType?: 'dynamodb' | 'cosmosdb' | 'firestore' | 'postgresql';
+    apiName?: string;
+    apiStageName?: string;
+    authEnabled?: boolean;
+    authProvider?: string;
+    monitoringEnabled?: boolean;
+    [key: string]: any;
+}
+export interface TemplateRenderResult {
+    mainTf: string;
+    variablesTf: string;
+    outputsTf: string;
+    providerTf?: string;
+    readmeMd?: string;
+}
+/**
+ * Template Engine for generating Terraform configurations
+ */
+export declare class TerraformTemplateEngine {
+    private handlebars;
+    private templateCache;
+    constructor();
+    /**
+     * Register custom Handlebars helpers
+     */
+    private registerHelpers;
+    /**
+     * Load and compile a template from file
+     */
+    loadTemplate(templatePath: string): HandlebarsTemplateDelegate;
+    /**
+     * Load template from string
+     */
+    loadTemplateString(templateContent: string): HandlebarsTemplateDelegate;
+    /**
+     * Register a partial template
+     */
+    registerPartial(name: string, templatePath: string): void;
+    /**
+     * Render a single template file
+     */
+    renderTemplate(templatePath: string, variables: TemplateVariables): string;
+    /**
+     * Render complete Terraform configuration from template directory
+     */
+    renderTerraformConfig(templateDir: string, variables: TemplateVariables): TemplateRenderResult;
+    /**
+     * Write rendered Terraform configuration to output directory
+     */
+    writeTerraformConfig(outputDir: string, config: TemplateRenderResult): void;
+    /**
+     * Clear template cache
+     */
+    clearCache(): void;
+}
+/**
+ * Create a new template engine instance
+ */
+export declare function createTemplateEngine(): TerraformTemplateEngine;
+//# sourceMappingURL=template-engine.d.ts.map

package/dist/src/core/iac/template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.d.ts","sourceRoot":"","sources":["../../../../src/core/iac/template-engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,iBAAiB;IAEhC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;IAGzC,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,CAAC;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,YAAY,CAAC;IAGpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAG5B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,aAAa,CAA0C;;IAQ/D;;OAEG;IACH,OAAO,CAAC,eAAe;IAwDvB;;OAEG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,0BAA0B;IAqB9D;;OAEG;IACH,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,0BAA0B;IAOvE;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAKzD;;OAEG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,MAAM;IAK1E;;OAEG;IACH,qBAAqB,CACnB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,iBAAiB,GAC3B,oBAAoB;IAyCvB;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAoB3E;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,uBAAuB,CAE9D"}