@vibe-validate/core 0.9.0

package/README.md

@@ -0,0 +1,46 @@
+# @vibe-validate/core
+
+Core validation orchestration engine for vibe-validate.
+
+## Features
+
+- **Parallel Execution**: Run multiple validation steps simultaneously
+- **Phase-Based Orchestration**: Define validation phases with dependencies
+- **Git Tree Hash Caching**: Skip validation when code unchanged
+- **Process Management**: Clean up child processes on interruption
+- **LLM-Optimized Output**: Format errors for AI consumption
+
+## Installation
+
+```bash
+npm install @vibe-validate/core
+```
+
+## Usage
+
+```typescript
+import { ValidationRunner } from '@vibe-validate/core';
+
+const runner = new ValidationRunner({
+  phases: [
+    {
+      name: 'Pre-Qualification',
+      parallel: true,
+      steps: [
+        { name: 'TypeCheck', command: 'tsc --noEmit' },
+        { name: 'Lint', command: 'eslint src/' },
+      ],
+    },
+  ],
+});
+
+const result = await runner.run();
+```
+
+## API
+
+See [TypeScript types](./src/index.ts) for complete API documentation.
+
+## License
+
+MIT © Jeff Dutton

package/dist/cli.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Vibe-Validate CLI Entry Point
+ *
+ * This script loads the configuration and runs the validation runner.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/cli.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+/**
+ * Vibe-Validate CLI Entry Point
+ *
+ * This script loads the configuration and runs the validation runner.
+ */
+import { join, resolve } from 'path';
+import { existsSync } from 'fs';
+import { runValidation } from './runner.js';
+/**
+ * Find and load vibe-validate.config.ts
+ *
+ * @returns A config object with validation, git, and output settings
+ */
+async function loadConfig() {
+    const cwd = process.cwd();
+    const configPaths = [
+        'vibe-validate.config.ts',
+        'vibe-validate.config.js',
+        'vibe-validate.config.mjs',
+        '.vibe-validate.ts',
+        '.vibe-validate.js',
+        '.vibe-validate.mjs',
+    ];
+    for (const configPath of configPaths) {
+        const fullPath = join(cwd, configPath);
+        if (existsSync(fullPath)) {
+            console.log(`📋 Loading config from ${configPath}`);
+            try {
+                // Use dynamic import to support both .ts and .js configs
+                const configModule = await import(`file://${resolve(fullPath)}`);
+                const config = configModule.default || configModule;
+                return config;
+            }
+            catch (error) {
+                console.error(`❌ Failed to load config from ${configPath}:`, error);
+                process.exit(1);
+            }
+        }
+    }
+    console.error('❌ No vibe-validate.config.ts found in current directory');
+    console.error('   Searched for:');
+    configPaths.forEach((path) => console.error(`   - ${path}`));
+    process.exit(1);
+}
+/**
+ * Main CLI entry point
+ */
+async function main() {
+    try {
+        // Load configuration
+        const rawConfig = await loadConfig();
+        // Adapt config structure for runner
+        // The config loader returns a structured config with {validation, git, output}
+        // The runner expects a flat config with {phases, ...}
+        // Convert process.env to Record<string, string> by filtering out undefined values
+        const envVars = {};
+        for (const [key, value] of Object.entries(process.env)) {
+            if (value !== undefined) {
+                envVars[key] = value;
+            }
+        }
+        const runnerConfig = {
+            phases: rawConfig.validation?.phases || [],
+            enableFailFast: rawConfig.validation?.failFast ?? true,
+            env: envVars,
+            stateFilePath: '.vibe-validate-state.yaml',
+            onPhaseStart: (phase) => console.log(`\n🔄 Running phase: ${phase.name}`),
+            onPhaseComplete: (phase, result) => {
+                if (result.passed) {
+                    console.log(`✅ Phase ${phase.name} completed successfully`);
+                }
+                else {
+                    console.log(`❌ Phase ${phase.name} failed`);
+                }
+            },
+            onStepStart: (step) => console.log(`  ⏳ ${step.name}...`),
+            onStepComplete: (step, result) => {
+                if (result.passed) {
+                    console.log(`  ✅ ${step.name} (${result.duration}ms)`);
+                }
+                else {
+                    console.log(`  ❌ ${step.name} failed (${result.duration}ms)`);
+                }
+            },
+        };
+        // Run validation
+        const result = await runValidation(runnerConfig);
+        // Exit with appropriate code
+        process.exit(result.passed ? 0 : 1);
+    }
+    catch (error) {
+        console.error('❌ Validation failed with error:', error);
+        process.exit(1);
+    }
+}
+// Run if executed directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch((error) => {
+        console.error('Fatal error:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @vibe-validate/core
+ *
+ * Core validation engine with git tree hash caching, parallel execution, and fail-fast support.
+ *
+ * ## Features
+ *
+ * - **Git Tree Hash Caching**: Skip validation if code unchanged
+ * - **Parallel Execution**: Run validation steps concurrently for speed
+ * - **Fail-Fast**: Stop on first failure with proper process cleanup
+ * - **Signal Handling**: Graceful cleanup on SIGTERM/SIGINT
+ * - **Language Agnostic**: Works with any command-line tool
+ *
+ * ## Example Usage
+ *
+ * ```typescript
+ * import { runValidation } from '@vibe-validate/core';
+ *
+ * const result = await runValidation({
+ *   phases: [
+ *     {
+ *       name: 'Type Checking',
+ *       steps: [
+ *         { name: 'TypeScript', command: 'tsc --noEmit' },
+ *         { name: 'ESLint', command: 'eslint src/' },
+ *       ],
+ *     },
+ *     {
+ *       name: 'Testing',
+ *       steps: [
+ *         { name: 'Unit Tests', command: 'npm test' },
+ *       ],
+ *     },
+ *   ],
+ *   enableFailFast: true,
+ * });
+ *
+ * if (result.passed) {
+ *   console.log('✅ Validation passed!');
+ * } else {
+ *   console.error('❌ Validation failed:', result.failedStep);
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export type { ValidationStep, ValidationPhase, ValidationConfig, ValidationResult, StepResult, PhaseResult, } from './types.js';
+export { runValidation, runStepsInParallel, getWorkingTreeHash, checkExistingValidation, parseFailures, setupSignalHandlers, } from './runner.js';
+export { stopProcessGroup, } from './process-utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAGH,YAAY,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,51 @@
+/**
+ * @vibe-validate/core
+ *
+ * Core validation engine with git tree hash caching, parallel execution, and fail-fast support.
+ *
+ * ## Features
+ *
+ * - **Git Tree Hash Caching**: Skip validation if code unchanged
+ * - **Parallel Execution**: Run validation steps concurrently for speed
+ * - **Fail-Fast**: Stop on first failure with proper process cleanup
+ * - **Signal Handling**: Graceful cleanup on SIGTERM/SIGINT
+ * - **Language Agnostic**: Works with any command-line tool
+ *
+ * ## Example Usage
+ *
+ * ```typescript
+ * import { runValidation } from '@vibe-validate/core';
+ *
+ * const result = await runValidation({
+ *   phases: [
+ *     {
+ *       name: 'Type Checking',
+ *       steps: [
+ *         { name: 'TypeScript', command: 'tsc --noEmit' },
+ *         { name: 'ESLint', command: 'eslint src/' },
+ *       ],
+ *     },
+ *     {
+ *       name: 'Testing',
+ *       steps: [
+ *         { name: 'Unit Tests', command: 'npm test' },
+ *       ],
+ *     },
+ *   ],
+ *   enableFailFast: true,
+ * });
+ *
+ * if (result.passed) {
+ *   console.log('✅ Validation passed!');
+ * } else {
+ *   console.error('❌ Validation failed:', result.failedStep);
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Export core runner functions
+export { runValidation, runStepsInParallel, getWorkingTreeHash, checkExistingValidation, parseFailures, setupSignalHandlers, } from './runner.js';
+// Export process utilities
+export { stopProcessGroup, } from './process-utils.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAYH,+BAA+B;AAC/B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,2BAA2B;AAC3B,OAAO,EACL,gBAAgB,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/process-utils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Process management utilities for validation runner
+ *
+ * Provides reliable process group cleanup for spawned child processes.
+ * Used by validation runner for signal handling and fail-fast behavior.
+ */
+import { ChildProcess } from 'child_process';
+/**
+ * Stop a child process and its entire process group
+ *
+ * Uses negative PID to kill process group, ensuring all children are terminated.
+ *
+ * **Implementation:**
+ * - Graceful shutdown: SIGTERM to process group (-PID)
+ * - Force kill after 1s: SIGKILL to process group
+ * - Ultimate timeout: Resolves after 2s regardless
+ *
+ * @param childProcess - The child process to stop
+ * @param processName - Optional name for logging (e.g., "TypeScript", "ESLint")
+ * @returns Promise that resolves when process is stopped
+ *
+ * @example
+ * ```typescript
+ * const proc = spawn('tsc', ['--noEmit']);
+ * await stopProcessGroup(proc, 'TypeScript');
+ * ```
+ */
+export declare function stopProcessGroup(childProcess: ChildProcess, processName?: string): Promise<void>;
+//# sourceMappingURL=process-utils.d.ts.map

package/dist/process-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-utils.d.ts","sourceRoot":"","sources":["../src/process-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,YAAY,EAC1B,WAAW,GAAE,MAAkB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/dist/process-utils.js

@@ -0,0 +1,62 @@
+/**
+ * Process management utilities for validation runner
+ *
+ * Provides reliable process group cleanup for spawned child processes.
+ * Used by validation runner for signal handling and fail-fast behavior.
+ */
+/**
+ * Stop a child process and its entire process group
+ *
+ * Uses negative PID to kill process group, ensuring all children are terminated.
+ *
+ * **Implementation:**
+ * - Graceful shutdown: SIGTERM to process group (-PID)
+ * - Force kill after 1s: SIGKILL to process group
+ * - Ultimate timeout: Resolves after 2s regardless
+ *
+ * @param childProcess - The child process to stop
+ * @param processName - Optional name for logging (e.g., "TypeScript", "ESLint")
+ * @returns Promise that resolves when process is stopped
+ *
+ * @example
+ * ```typescript
+ * const proc = spawn('tsc', ['--noEmit']);
+ * await stopProcessGroup(proc, 'TypeScript');
+ * ```
+ */
+export async function stopProcessGroup(childProcess, processName = 'Process') {
+    return new Promise((resolve) => {
+        if (!childProcess.killed && childProcess.pid) {
+            const pid = childProcess.pid;
+            childProcess.on('exit', () => {
+                console.log(`🛑 ${processName} stopped`);
+                resolve();
+            });
+            // Kill the entire process group by negating the PID
+            // This kills the process and all its children
+            try {
+                process.kill(-pid, 'SIGTERM');
+            }
+            catch {
+                // Process may already be dead, ignore error
+            }
+            // Force kill entire process group after 1 second if not stopped
+            setTimeout(() => {
+                try {
+                    process.kill(-pid, 'SIGKILL');
+                }
+                catch {
+                    // Process may already be dead, ignore error
+                }
+            }, 1000);
+            // Ultimate timeout - resolve after 2 seconds regardless
+            setTimeout(() => {
+                resolve();
+            }, 2000);
+        }
+        else {
+            resolve();
+        }
+    });
+}
+//# sourceMappingURL=process-utils.js.map

package/dist/process-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-utils.js","sourceRoot":"","sources":["../src/process-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,YAA0B,EAC1B,cAAsB,SAAS;IAE/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,CAAC,YAAY,CAAC,MAAM,IAAI,YAAY,CAAC,GAAG,EAAE,CAAC;YAC7C,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC;YAE7B,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;gBAC3B,OAAO,CAAC,GAAG,CAAC,MAAM,WAAW,UAAU,CAAC,CAAC;gBACzC,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YAEH,oDAAoD;YACpD,8CAA8C;YAC9C,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAChC,CAAC;YAAC,MAAM,CAAC;gBACP,4CAA4C;YAC9C,CAAC;YAED,gEAAgE;YAChE,UAAU,CAAC,GAAG,EAAE;gBACd,IAAI,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBAChC,CAAC;gBAAC,MAAM,CAAC;oBACP,4CAA4C;gBAC9C,CAAC;YACH,CAAC,EAAE,IAAI,CAAC,CAAC;YAET,wDAAwD;YACxD,UAAU,CAAC,GAAG,EAAE;gBACd,OAAO,EAAE,CAAC;YACZ,CAAC,EAAE,IAAI,CAAC,CAAC;QACX,CAAC;aAAM,CAAC;YACN,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Validation Runner - Core validation orchestration with state caching
+ *
+ * This module provides the core validation engine that:
+ * 1. Executes validation steps in parallel for speed
+ * 2. Tracks state using git tree hashes for caching
+ * 3. Provides fail-fast execution with proper cleanup
+ * 4. Handles signals (SIGTERM/SIGINT) gracefully
+ *
+ * @packageDocumentation
+ */
+import type { ValidationStep, ValidationResult, ValidationConfig, StepResult } from './types.js';
+/**
+ * Git tree hash calculator
+ *
+ * IMPORTANT: Current implementation uses `git stash create` which includes timestamps.
+ * This makes hashes non-deterministic - identical code produces different hashes.
+ *
+ * TODO: Replace with deterministic git write-tree approach:
+ *   git add --intent-to-add .  # Mark untracked (no staging)
+ *   git write-tree              # Content-based hash (no timestamps)
+ *   git reset                   # Restore index
+ *
+ * @returns SHA-1 hash representing working tree state (currently non-deterministic)
+ */
+export declare function getWorkingTreeHash(): string;
+/**
+ * Check if validation has already passed for current working tree state
+ */
+export declare function checkExistingValidation(currentTreeHash: string, stateFilePath: string): {
+    alreadyPassed: boolean;
+    previousState?: ValidationResult;
+};
+/**
+ * Parse test output to extract specific failures
+ * This is a basic implementation - formatters package will have more sophisticated parsing
+ */
+export declare function parseFailures(output: string): string[];
+/**
+ * Run validation steps in parallel with smart fail-fast
+ *
+ * @param steps - Array of validation steps to execute
+ * @param phaseName - Name of the current phase (for logging)
+ * @param logPath - Path to log file for output capture
+ * @param enableFailFast - If true, kills remaining processes on first failure
+ * @param env - Environment variables to pass to child processes
+ */
+export declare function runStepsInParallel(steps: ValidationStep[], phaseName: string, enableFailFast?: boolean, env?: Record<string, string>): Promise<{
+    success: boolean;
+    failedStep?: ValidationStep;
+    outputs: Map<string, string>;
+    stepResults: StepResult[];
+}>;
+/**
+ * Validation runner with state tracking and caching
+ *
+ * Main entry point for running validation with git tree hash caching
+ */
+export declare function runValidation(config: ValidationConfig): Promise<ValidationResult>;
+/**
+ * Setup signal handlers for graceful cleanup
+ *
+ * Ensures all child processes are killed when validation runner is interrupted
+ */
+export declare function setupSignalHandlers(activeProcesses: Set<any>): void;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EAEX,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CA0B3C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,GACpB;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAmB9D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBtD;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,cAAc,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,OAAe,EAC/B,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC/B,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B,CAAC,CAiFD;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoHvF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAenE"}

package/dist/runner.js

@@ -0,0 +1,276 @@
+/**
+ * Validation Runner - Core validation orchestration with state caching
+ *
+ * This module provides the core validation engine that:
+ * 1. Executes validation steps in parallel for speed
+ * 2. Tracks state using git tree hashes for caching
+ * 3. Provides fail-fast execution with proper cleanup
+ * 4. Handles signals (SIGTERM/SIGINT) gracefully
+ *
+ * @packageDocumentation
+ */
+import { spawn, execSync } from 'child_process';
+import { writeFileSync, appendFileSync, existsSync, readFileSync } from 'fs';
+import { stopProcessGroup } from './process-utils.js';
+/**
+ * Git tree hash calculator
+ *
+ * IMPORTANT: Current implementation uses `git stash create` which includes timestamps.
+ * This makes hashes non-deterministic - identical code produces different hashes.
+ *
+ * TODO: Replace with deterministic git write-tree approach:
+ *   git add --intent-to-add .  # Mark untracked (no staging)
+ *   git write-tree              # Content-based hash (no timestamps)
+ *   git reset                   # Restore index
+ *
+ * @returns SHA-1 hash representing working tree state (currently non-deterministic)
+ */
+export function getWorkingTreeHash() {
+    try {
+        // Use git stash create to include ALL working tree changes
+        // WARNING: This creates commit objects with timestamps (non-deterministic)
+        const stashHash = execSync('git stash create', {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'ignore']
+        }).trim();
+        // If no changes, fall back to HEAD tree
+        if (!stashHash) {
+            return execSync('git rev-parse HEAD^{tree}', {
+                encoding: 'utf8',
+                stdio: ['pipe', 'pipe', 'ignore']
+            }).trim();
+        }
+        // Extract tree hash from stash commit
+        return execSync(`git rev-parse ${stashHash}^{tree}`, {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'ignore']
+        }).trim();
+    }
+    catch (error) {
+        // Fallback for non-git repos or git command failures
+        return `nogit-${Date.now()}`;
+    }
+}
+/**
+ * Check if validation has already passed for current working tree state
+ */
+export function checkExistingValidation(currentTreeHash, stateFilePath) {
+    if (!existsSync(stateFilePath)) {
+        return { alreadyPassed: false };
+    }
+    try {
+        const content = readFileSync(stateFilePath, 'utf8');
+        // Parse as JSON (will support YAML in CLI package)
+        const state = JSON.parse(content);
+        // Check if validation passed and tree hash matches
+        if (state.passed && state.treeHash === currentTreeHash) {
+            return { alreadyPassed: true, previousState: state };
+        }
+        return { alreadyPassed: false, previousState: state };
+    }
+    catch (error) {
+        return { alreadyPassed: false };
+    }
+}
+/**
+ * Parse test output to extract specific failures
+ * This is a basic implementation - formatters package will have more sophisticated parsing
+ */
+export function parseFailures(output) {
+    const failures = [];
+    // Vitest test failures - extract test names
+    const vitestFailures = output.match(/❌ .+/g);
+    if (vitestFailures) {
+        failures.push(...vitestFailures.slice(0, 10)); // Limit to first 10
+    }
+    // TypeScript errors - extract file:line
+    const tsErrors = output.match(/[^(]+\(\d+,\d+\): error TS\d+:.+/g);
+    if (tsErrors) {
+        failures.push(...tsErrors.slice(0, 10).map(e => e.trim()));
+    }
+    // ESLint errors - extract file:line
+    const eslintErrors = output.match(/\S+\.ts\(\d+,\d+\): .+/g);
+    if (eslintErrors) {
+        failures.push(...eslintErrors.slice(0, 10).map(e => e.trim()));
+    }
+    return failures;
+}
+/**
+ * Run validation steps in parallel with smart fail-fast
+ *
+ * @param steps - Array of validation steps to execute
+ * @param phaseName - Name of the current phase (for logging)
+ * @param logPath - Path to log file for output capture
+ * @param enableFailFast - If true, kills remaining processes on first failure
+ * @param env - Environment variables to pass to child processes
+ */
+export async function runStepsInParallel(steps, phaseName, enableFailFast = false, env = {}) {
+    console.log(`\n🔍 Running ${phaseName} (${steps.length} steps in parallel)...`);
+    // Find longest step name for alignment
+    const maxNameLength = Math.max(...steps.map(s => s.name.length));
+    const outputs = new Map();
+    const stepResults = [];
+    const processes = [];
+    let firstFailure = null;
+    const results = await Promise.allSettled(steps.map(step => new Promise((resolve, reject) => {
+        const paddedName = step.name.padEnd(maxNameLength);
+        console.log(`   ⏳ ${paddedName}  →  ${step.command}`);
+        const startTime = Date.now();
+        const proc = spawn('sh', ['-c', step.command], {
+            stdio: 'pipe',
+            detached: true, // Create new process group for easier cleanup
+            env: {
+                ...process.env,
+                ...env,
+            }
+        });
+        // Track process for potential kill
+        processes.push({ proc, step });
+        let stdout = '';
+        let stderr = '';
+        proc.stdout.on('data', data => { stdout += data.toString(); });
+        proc.stderr.on('data', data => { stderr += data.toString(); });
+        proc.on('close', code => {
+            const duration = Date.now() - startTime;
+            const output = stdout + stderr;
+            outputs.set(step.name, output);
+            const durationSec = (duration / 1000).toFixed(1);
+            const status = code === 0 ? '✅' : '❌';
+            const result = code === 0 ? 'PASSED' : 'FAILED';
+            console.log(`      ${status} ${step.name.padEnd(maxNameLength)} - ${result} (${durationSec}s)`);
+            stepResults.push({ name: step.name, passed: code === 0, duration });
+            if (code === 0) {
+                resolve({ step, output, duration });
+            }
+            else {
+                // On first failure, kill other processes if fail-fast enabled
+                if (enableFailFast && !firstFailure) {
+                    firstFailure = { step, output };
+                    console.log(`\n⚠️  Fail-fast enabled: Killing remaining processes...`);
+                    // Kill all other running processes
+                    for (const { proc: otherProc, step: otherStep } of processes) {
+                        if (otherStep !== step && otherProc.exitCode === null) {
+                            stopProcessGroup(otherProc, otherStep.name).catch(() => {
+                                // Process may have already exited, ignore errors
+                            });
+                        }
+                    }
+                }
+                reject({ step, output, duration });
+            }
+        });
+    })));
+    // Check for failures
+    for (const result of results) {
+        if (result.status === 'rejected') {
+            const { step } = result.reason;
+            return { success: false, failedStep: step, outputs, stepResults };
+        }
+    }
+    return { success: true, outputs, stepResults };
+}
+/**
+ * Validation runner with state tracking and caching
+ *
+ * Main entry point for running validation with git tree hash caching
+ */
+export async function runValidation(config) {
+    const { phases, stateFilePath = '.validate-state.json', logPath = `/tmp/validation-${new Date().toISOString().replace(/[:.]/g, '-')}.log`, enableFailFast = false, forceRun = false, env = {}, onPhaseStart, onPhaseComplete, } = config;
+    // Get current working tree hash
+    const currentTreeHash = getWorkingTreeHash();
+    // Check if validation already passed for this exact code state
+    if (!forceRun) {
+        const { alreadyPassed, previousState } = checkExistingValidation(currentTreeHash, stateFilePath);
+        if (alreadyPassed && previousState) {
+            console.log('✅ Validation already passed for current working tree state');
+            console.log(`   Tree hash: ${currentTreeHash.substring(0, 12)}...`);
+            console.log(`   Last validated: ${previousState.timestamp}`);
+            return previousState;
+        }
+    }
+    // Initialize log file
+    writeFileSync(logPath, `Validation started at ${new Date().toISOString()}\n\n`);
+    let fullOutput = '';
+    let failedStep = null;
+    const phaseResults = [];
+    // Run each phase
+    for (const phase of phases) {
+        if (onPhaseStart) {
+            onPhaseStart(phase);
+        }
+        const phaseStartTime = Date.now();
+        const result = await runStepsInParallel(phase.steps, phase.name, enableFailFast, env);
+        const phaseDuration = Date.now() - phaseStartTime;
+        // Append all outputs to log file
+        for (const [stepName, output] of result.outputs) {
+            appendFileSync(logPath, `\n${'='.repeat(60)}\n`);
+            appendFileSync(logPath, `${stepName}${result.failedStep?.name === stepName ? ' - FAILED' : ''}\n`);
+            appendFileSync(logPath, `${'='.repeat(60)}\n`);
+            appendFileSync(logPath, output);
+            fullOutput += output;
+        }
+        // Record phase result
+        const phaseResult = {
+            name: phase.name,
+            duration: phaseDuration,
+            passed: result.success,
+            steps: result.stepResults,
+        };
+        // If phase failed, include output
+        if (!result.success && result.failedStep) {
+            phaseResult.output = result.outputs.get(result.failedStep.name);
+        }
+        phaseResults.push(phaseResult);
+        if (onPhaseComplete) {
+            onPhaseComplete(phase, phaseResult);
+        }
+        // If phase failed, stop here
+        if (!result.success && result.failedStep) {
+            failedStep = result.failedStep;
+            const failedOutput = result.outputs.get(failedStep.name) || '';
+            const failures = parseFailures(failedOutput);
+            const validationResult = {
+                passed: false,
+                timestamp: new Date().toISOString(),
+                treeHash: currentTreeHash,
+                phases: phaseResults,
+                failedStep: failedStep.name,
+                rerunCommand: failedStep.command,
+                failedStepOutput: failedOutput,
+                failedTests: failures.length > 0 ? failures : undefined,
+                fullLogFile: logPath,
+            };
+            // Write state file
+            writeFileSync(stateFilePath, JSON.stringify(validationResult, null, 2));
+            return validationResult;
+        }
+    }
+    // All steps passed!
+    const validationResult = {
+        passed: true,
+        timestamp: new Date().toISOString(),
+        treeHash: currentTreeHash,
+        phases: phaseResults,
+        fullLogFile: logPath,
+    };
+    // Write state file
+    writeFileSync(stateFilePath, JSON.stringify(validationResult, null, 2));
+    return validationResult;
+}
+/**
+ * Setup signal handlers for graceful cleanup
+ *
+ * Ensures all child processes are killed when validation runner is interrupted
+ */
+export function setupSignalHandlers(activeProcesses) {
+    const cleanup = async (signal) => {
+        console.log(`\n⚠️  Received ${signal}, cleaning up ${activeProcesses.size} active processes...`);
+        // Kill all active processes
+        const cleanupPromises = Array.from(activeProcesses).map(proc => stopProcessGroup(proc, 'Validation step'));
+        await Promise.all(cleanupPromises);
+        process.exit(1);
+    };
+    process.on('SIGTERM', () => cleanup('SIGTERM'));
+    process.on('SIGINT', () => cleanup('SIGINT'));
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Core validation types for vibe-validate
+ *
+ * These types define the validation configuration structure and result types.
+ */
+/**
+ * A single validation step (language-agnostic)
+ */
+export interface ValidationStep {
+    /** Human-readable step name */
+    name: string;
+    /** Command to execute (can be any shell command, not just npm scripts) */
+    command: string;
+    /** Optional timeout in milliseconds */
+    timeout?: number;
+    /** Optional environment variables for this step */
+    env?: Record<string, string>;
+}
+/**
+ * A validation phase containing multiple steps
+ */
+export interface ValidationPhase {
+    /** Human-readable phase name */
+    name: string;
+    /** Run steps in parallel? */
+    parallel: boolean;
+    /** Phase names this phase depends on */
+    dependsOn?: string[];
+    /** Steps to execute in this phase */
+    steps: ValidationStep[];
+}
+/**
+ * Result from executing a validation step
+ */
+export interface StepResult {
+    /** Step name */
+    name: string;
+    /** Did the step pass? */
+    passed: boolean;
+    /** Execution duration in milliseconds */
+    duration: number;
+    /** Output from the step (stdout + stderr) */
+    output?: string;
+}
+/**
+ * Result from executing a validation phase
+ */
+export interface PhaseResult {
+    /** Phase name */
+    name: string;
+    /** Phase execution duration in milliseconds */
+    duration: number;
+    /** Did the phase pass? */
+    passed: boolean;
+    /** Results from individual steps */
+    steps: StepResult[];
+    /** Output from failed step (if any) */
+    output?: string;
+}
+/**
+ * Overall validation result
+ */
+export interface ValidationResult {
+    /** Did validation pass? */
+    passed: boolean;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    /** Git tree hash (if in git repo) */
+    treeHash: string;
+    /** Results from each phase */
+    phases?: PhaseResult[];
+    /** Name of failed step (if any) */
+    failedStep?: string;
+    /** Command to re-run failed step */
+    rerunCommand?: string;
+    /** Output from the failed step */
+    failedStepOutput?: string;
+    /** Failed test names (if applicable) */
+    failedTests?: string[];
+    /** Path to full log file */
+    fullLogFile?: string;
+    /** Summary message */
+    summary?: string;
+}
+/**
+ * Validation configuration
+ */
+export interface ValidationConfig {
+    /** Validation phases to execute */
+    phases: ValidationPhase[];
+    /** Path to state file (default: .validate-state.json) */
+    stateFilePath?: string;
+    /** Path to log file (default: /tmp/validation-{timestamp}.log) */
+    logPath?: string;
+    /** Enable fail-fast (stop on first failure) */
+    enableFailFast?: boolean;
+    /** Force re-run even if state says validation already passed */
+    forceRun?: boolean;
+    /** Environment variables to pass to all child processes */
+    env?: Record<string, string>;
+    /** Callback when phase starts */
+    onPhaseStart?: (phase: ValidationPhase) => void;
+    /** Callback when phase completes */
+    onPhaseComplete?: (phase: ValidationPhase, result: PhaseResult) => void;
+    /** Callback when step starts */
+    onStepStart?: (step: ValidationStep) => void;
+    /** Callback when step completes */
+    onStepComplete?: (step: ValidationStep, result: StepResult) => void;
+    /** Caching configuration */
+    caching?: {
+        /** Enable git tree hash caching */
+        enabled: boolean;
+        /** Cache strategy */
+        strategy: 'git-tree-hash' | 'file-hash' | 'timestamp';
+        /** Maximum age of cached results (ms) */
+        maxAge?: number;
+    };
+    /** Output configuration */
+    output?: {
+        /** Output format */
+        format: 'auto' | 'human' | 'yaml' | 'json';
+        /** Show verbose output */
+        verbose?: boolean;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Core validation types for vibe-validate
+ *
+ * These types define the validation configuration structure and result types.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@vibe-validate/core",
+  "version": "0.9.0",
+  "description": "Core validation orchestration engine for vibe-validate",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "keywords": [
+    "validation",
+    "parallel",
+    "orchestration",
+    "git",
+    "cache"
+  ],
+  "author": "Jeff Dutton",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jdutton/vibe-validate.git",
+    "directory": "packages/core"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.17.6",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}