@vibe-validate/core 0.10.3 → 0.12.0

package/dist/index.d.ts

@@ -44,7 +44,9 @@
  *
  * @packageDocumentation
  */
-export type { ValidationStep, ValidationPhase, ValidationConfig, ValidationResult, StepResult, PhaseResult, } from './types.js';
-export { runValidation, runStepsInParallel, checkExistingValidation, parseFailures, setupSignalHandlers, } from './runner.js';
+export type { ValidationStep, ValidationPhase, ValidationConfig, ValidationResult, StepResult, PhaseResult, ExtractionQuality, } from './types.js';
+export { runValidation, runStepsInParallel, parseFailures, setupSignalHandlers, } from './runner.js';
 export { stopProcessGroup, } from './process-utils.js';
+export { ValidationResultSchema, StepResultSchema, PhaseResultSchema, safeValidateResult, validateResult, } from './result-schema.js';
+export { validationResultJsonSchema, generateValidationResultJsonSchema, } from './result-schema-export.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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,uBAAuB,EACvB,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,GACjB,MAAM,oBAAoB,CAAC"}
+{"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,EACX,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,0BAA0B,EAC1B,kCAAkC,GACnC,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -45,7 +45,11 @@
  * @packageDocumentation
  */
 // Export core runner functions
-export { runValidation, runStepsInParallel, checkExistingValidation, parseFailures, setupSignalHandlers, } from './runner.js';
+export { runValidation, runStepsInParallel, parseFailures, setupSignalHandlers, } from './runner.js';
 // Export process utilities
 export { stopProcessGroup, } from './process-utils.js';
+// Export validation result schema and validators
+export { ValidationResultSchema, StepResultSchema, PhaseResultSchema, safeValidateResult, validateResult, } from './result-schema.js';
+// Export JSON Schema generation
+export { validationResultJsonSchema, generateValidationResultJsonSchema, } from './result-schema-export.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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,uBAAuB,EACvB,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,2BAA2B;AAC3B,OAAO,EACL,gBAAgB,GACjB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAaH,+BAA+B;AAC/B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,2BAA2B;AAC3B,OAAO,EACL,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,iDAAiD;AACjD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,gCAAgC;AAChC,OAAO,EACL,0BAA0B,EAC1B,kCAAkC,GACnC,MAAM,2BAA2B,CAAC"}

package/dist/process-utils.d.ts

@@ -6,14 +6,17 @@
  */
 import { ChildProcess } from 'child_process';
 /**
- * Stop a child process and its entire process group
+ * Stop a child process and its entire process group (cross-platform)
  *
- * Uses negative PID to kill process group, ensuring all children are terminated.
+ * **Windows Implementation:**
+ * - Uses `taskkill /pid <PID> /T /F` to terminate process tree
+ * - /T flag kills child processes
+ * - /F flag forces termination
  *
- * **Implementation:**
- * - Graceful shutdown: SIGTERM to process group (-PID)
+ * **Unix Implementation:**
+ * - Uses negative PID to kill process group (-PID)
+ * - Graceful shutdown: SIGTERM to process group
  * - 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")
@@ -21,7 +24,7 @@ import { ChildProcess } from 'child_process';
  *
  * @example
  * ```typescript
- * const proc = spawn('tsc', ['--noEmit']);
+ * const proc = spawn('tsc --noEmit', [], { shell: true });
  * await stopProcessGroup(proc, 'TypeScript');
  * ```
  */

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

@@ -1 +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"}
+{"version":3,"file":"process-utils.d.ts","sourceRoot":"","sources":["../src/process-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAY,MAAM,eAAe,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,YAAY,EAC1B,WAAW,GAAE,MAAkB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA+Cf"}

package/dist/process-utils.js

@@ -4,15 +4,19 @@
  * Provides reliable process group cleanup for spawned child processes.
  * Used by validation runner for signal handling and fail-fast behavior.
  */
+import { execSync } from 'child_process';
 /**
- * Stop a child process and its entire process group
+ * Stop a child process and its entire process group (cross-platform)
  *
- * Uses negative PID to kill process group, ensuring all children are terminated.
+ * **Windows Implementation:**
+ * - Uses `taskkill /pid <PID> /T /F` to terminate process tree
+ * - /T flag kills child processes
+ * - /F flag forces termination
  *
- * **Implementation:**
- * - Graceful shutdown: SIGTERM to process group (-PID)
+ * **Unix Implementation:**
+ * - Uses negative PID to kill process group (-PID)
+ * - Graceful shutdown: SIGTERM to process group
  * - 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")
@@ -20,7 +24,7 @@
  *
  * @example
  * ```typescript
- * const proc = spawn('tsc', ['--noEmit']);
+ * const proc = spawn('tsc --noEmit', [], { shell: true });
  * await stopProcessGroup(proc, 'TypeScript');
  * ```
  */
@@ -32,23 +36,37 @@ export async function stopProcessGroup(childProcess, processName = 'Process') {
                 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
+            // Platform-specific process termination
+            if (process.platform === 'win32') {
+                // Windows: Use taskkill to terminate process tree
+                // /T - Terminates all child processes
+                // /F - Forcefully terminates the process
+                try {
+                    execSync(`taskkill /pid ${pid} /T /F`, { stdio: 'ignore' });
+                }
+                catch {
+                    // Process may already be dead, ignore error
+                }
             }
-            // Force kill entire process group after 1 second if not stopped
-            setTimeout(() => {
+            else {
+                // Unix: Kill process group with negative PID
+                // This kills the process and all its children
                 try {
-                    process.kill(-pid, 'SIGKILL');
+                    process.kill(-pid, 'SIGTERM');
                 }
                 catch {
                     // Process may already be dead, ignore error
                 }
-            }, 1000);
+                // 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();

package/dist/process-utils.js.map

@@ -1 +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"}
+{"version":3,"file":"process-utils.js","sourceRoot":"","sources":["../src/process-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAgB,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;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,wCAAwC;YACxC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACjC,kDAAkD;gBAClD,sCAAsC;gBACtC,yCAAyC;gBACzC,IAAI,CAAC;oBACH,QAAQ,CAAC,iBAAiB,GAAG,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC9D,CAAC;gBAAC,MAAM,CAAC;oBACP,4CAA4C;gBAC9C,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,6CAA6C;gBAC7C,8CAA8C;gBAC9C,IAAI,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBAChC,CAAC;gBAAC,MAAM,CAAC;oBACP,4CAA4C;gBAC9C,CAAC;gBAED,gEAAgE;gBAChE,UAAU,CAAC,GAAG,EAAE;oBACd,IAAI,CAAC;wBACH,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;oBAChC,CAAC;oBAAC,MAAM,CAAC;wBACP,4CAA4C;oBAC9C,CAAC;gBACH,CAAC,EAAE,IAAI,CAAC,CAAC;YACX,CAAC;YAED,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/result-schema-export.d.ts

@@ -0,0 +1,26 @@
+/**
+ * JSON Schema Export for Validation Result
+ *
+ * Generates JSON Schema from Zod validation result schema to enable
+ * validation of examples in documentation and agent integration guides.
+ */
+/**
+ * Generate JSON Schema from Zod validation result schema
+ *
+ * This schema can be used to validate examples in documentation:
+ * ```yaml
+ * # Example validation result
+ * passed: false
+ * timestamp: "2025-10-20T12:00:00.000Z"
+ * treeHash: "abc123..."
+ * failedStep: "TypeScript"
+ * ```
+ *
+ * @returns JSON Schema object
+ */
+export declare function generateValidationResultJsonSchema(): object;
+/**
+ * Pre-generated JSON Schema (exported for bundling in npm package)
+ */
+export declare const validationResultJsonSchema: object;
+//# sourceMappingURL=result-schema-export.d.ts.map

package/dist/result-schema-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-schema-export.d.ts","sourceRoot":"","sources":["../src/result-schema-export.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kCAAkC,IAAI,MAAM,CAM3D;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,QAAuC,CAAC"}

package/dist/result-schema-export.js

@@ -0,0 +1,34 @@
+/**
+ * JSON Schema Export for Validation Result
+ *
+ * Generates JSON Schema from Zod validation result schema to enable
+ * validation of examples in documentation and agent integration guides.
+ */
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { ValidationResultSchema } from './result-schema.js';
+/**
+ * Generate JSON Schema from Zod validation result schema
+ *
+ * This schema can be used to validate examples in documentation:
+ * ```yaml
+ * # Example validation result
+ * passed: false
+ * timestamp: "2025-10-20T12:00:00.000Z"
+ * treeHash: "abc123..."
+ * failedStep: "TypeScript"
+ * ```
+ *
+ * @returns JSON Schema object
+ */
+export function generateValidationResultJsonSchema() {
+    return zodToJsonSchema(ValidationResultSchema, {
+        name: 'ValidationResult',
+        $refStrategy: 'none', // Inline all references for simplicity
+        target: 'jsonSchema7',
+    });
+}
+/**
+ * Pre-generated JSON Schema (exported for bundling in npm package)
+ */
+export const validationResultJsonSchema = generateValidationResultJsonSchema();
+//# sourceMappingURL=result-schema-export.js.map

package/dist/result-schema-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-schema-export.js","sourceRoot":"","sources":["../src/result-schema-export.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kCAAkC;IAChD,OAAO,eAAe,CAAC,sBAAsB,EAAE;QAC7C,IAAI,EAAE,kBAAkB;QACxB,YAAY,EAAE,MAAM,EAAE,uCAAuC;QAC7D,MAAM,EAAE,aAAa;KACtB,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,kCAAkC,EAAE,CAAC"}

package/dist/result-schema.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Zod Schema for Validation Results
+ *
+ * This schema defines the structure of validation state files and enables
+ * runtime validation and JSON Schema generation for documentation.
+ */
+import { z } from 'zod';
+/**
+ * Validation Step Result Schema
+ */
+export declare const StepResultSchema: z.ZodObject<{
+    /** Step name */
+    name: z.ZodString;
+    /** Did the step pass? */
+    passed: z.ZodBoolean;
+    /** Execution duration in seconds */
+    durationSecs: z.ZodNumber;
+    /** Output from the step (stdout + stderr) */
+    output: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    durationSecs: number;
+    name: string;
+    passed: boolean;
+    output?: string | undefined;
+}, {
+    durationSecs: number;
+    name: string;
+    passed: boolean;
+    output?: string | undefined;
+}>;
+/**
+ * Validation Phase Result Schema
+ */
+export declare const PhaseResultSchema: z.ZodObject<{
+    /** Phase name */
+    name: z.ZodString;
+    /** Phase execution duration in seconds */
+    durationSecs: z.ZodNumber;
+    /** Did the phase pass? */
+    passed: z.ZodBoolean;
+    /** Results from individual steps */
+    steps: z.ZodArray<z.ZodObject<{
+        /** Step name */
+        name: z.ZodString;
+        /** Did the step pass? */
+        passed: z.ZodBoolean;
+        /** Execution duration in seconds */
+        durationSecs: z.ZodNumber;
+        /** Output from the step (stdout + stderr) */
+        output: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        durationSecs: number;
+        name: string;
+        passed: boolean;
+        output?: string | undefined;
+    }, {
+        durationSecs: number;
+        name: string;
+        passed: boolean;
+        output?: string | undefined;
+    }>, "many">;
+    /** Output from failed step (if any) */
+    output: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    durationSecs: number;
+    name: string;
+    passed: boolean;
+    steps: {
+        durationSecs: number;
+        name: string;
+        passed: boolean;
+        output?: string | undefined;
+    }[];
+    output?: string | undefined;
+}, {
+    durationSecs: number;
+    name: string;
+    passed: boolean;
+    steps: {
+        durationSecs: number;
+        name: string;
+        passed: boolean;
+        output?: string | undefined;
+    }[];
+    output?: string | undefined;
+}>;
+/**
+ * Validation Result Schema
+ *
+ * This schema defines the validation result structure returned by the validation
+ * runner and stored in git notes (v0.12.0+) for history tracking.
+ */
+export declare const ValidationResultSchema: z.ZodObject<{
+    /** Did validation pass? */
+    passed: z.ZodBoolean;
+    /** ISO 8601 timestamp */
+    timestamp: z.ZodString;
+    /** Git tree hash (if in git repo) */
+    treeHash: z.ZodString;
+    /** Results from each phase */
+    phases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Phase name */
+        name: z.ZodString;
+        /** Phase execution duration in seconds */
+        durationSecs: z.ZodNumber;
+        /** Did the phase pass? */
+        passed: z.ZodBoolean;
+        /** Results from individual steps */
+        steps: z.ZodArray<z.ZodObject<{
+            /** Step name */
+            name: z.ZodString;
+            /** Did the step pass? */
+            passed: z.ZodBoolean;
+            /** Execution duration in seconds */
+            durationSecs: z.ZodNumber;
+            /** Output from the step (stdout + stderr) */
+            output: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            durationSecs: number;
+            name: string;
+            passed: boolean;
+            output?: string | undefined;
+        }, {
+            durationSecs: number;
+            name: string;
+            passed: boolean;
+            output?: string | undefined;
+        }>, "many">;
+        /** Output from failed step (if any) */
+        output: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        durationSecs: number;
+        name: string;
+        passed: boolean;
+        steps: {
+            durationSecs: number;
+            name: string;
+            passed: boolean;
+            output?: string | undefined;
+        }[];
+        output?: string | undefined;
+    }, {
+        durationSecs: number;
+        name: string;
+        passed: boolean;
+        steps: {
+            durationSecs: number;
+            name: string;
+            passed: boolean;
+            output?: string | undefined;
+        }[];
+        output?: string | undefined;
+    }>, "many">>;
+    /** Name of failed step (if any) */
+    failedStep: z.ZodOptional<z.ZodString>;
+    /** Command to re-run failed step */
+    rerunCommand: z.ZodOptional<z.ZodString>;
+    /** Output from the failed step */
+    failedStepOutput: z.ZodOptional<z.ZodString>;
+    /** Failed test names (if applicable) */
+    failedTests: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Path to full log file */
+    fullLogFile: z.ZodOptional<z.ZodString>;
+    /** Summary message */
+    summary: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    passed: boolean;
+    timestamp: string;
+    treeHash: string;
+    failedStep?: string | undefined;
+    phases?: {
+        durationSecs: number;
+        name: string;
+        passed: boolean;
+        steps: {
+            durationSecs: number;
+            name: string;
+            passed: boolean;
+            output?: string | undefined;
+        }[];
+        output?: string | undefined;
+    }[] | undefined;
+    rerunCommand?: string | undefined;
+    failedStepOutput?: string | undefined;
+    failedTests?: string[] | undefined;
+    fullLogFile?: string | undefined;
+    summary?: string | undefined;
+}, {
+    passed: boolean;
+    timestamp: string;
+    treeHash: string;
+    failedStep?: string | undefined;
+    phases?: {
+        durationSecs: number;
+        name: string;
+        passed: boolean;
+        steps: {
+            durationSecs: number;
+            name: string;
+            passed: boolean;
+            output?: string | undefined;
+        }[];
+        output?: string | undefined;
+    }[] | undefined;
+    rerunCommand?: string | undefined;
+    failedStepOutput?: string | undefined;
+    failedTests?: string[] | undefined;
+    fullLogFile?: string | undefined;
+    summary?: string | undefined;
+}>;
+/**
+ * Inferred TypeScript types from Zod schemas
+ */
+export type StepResult = z.infer<typeof StepResultSchema>;
+export type PhaseResult = z.infer<typeof PhaseResultSchema>;
+export type ValidationResult = z.infer<typeof ValidationResultSchema>;
+/**
+ * Safe validation function
+ *
+ * Validates a validation result object against the schema.
+ *
+ * @param data - Data to validate
+ * @returns Validation result with success/error information
+ */
+export declare function safeValidateResult(data: unknown): {
+    success: true;
+    data: ValidationResult;
+} | {
+    success: false;
+    errors: string[];
+};
+/**
+ * Strict validation function
+ *
+ * Validates and throws on error.
+ *
+ * @param data - Data to validate
+ * @returns Validated result
+ * @throws {Error} If validation fails
+ */
+export declare function validateResult(data: unknown): ValidationResult;
+//# sourceMappingURL=result-schema.d.ts.map

package/dist/result-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-schema.d.ts","sourceRoot":"","sources":["../src/result-schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,gBAAgB;;IAGhB,yBAAyB;;IAGzB,oCAAoC;;IAGpC,6CAA6C;;;;;;;;;;;;EAE7C,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B,iBAAiB;;IAGjB,0CAA0C;;IAG1C,0BAA0B;;IAG1B,oCAAoC;;QA1BpC,gBAAgB;;QAGhB,yBAAyB;;QAGzB,oCAAoC;;QAGpC,6CAA6C;;;;;;;;;;;;;IAoB7C,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;EAEvC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;IACjC,2BAA2B;;IAG3B,yBAAyB;;IAGzB,qCAAqC;;IAGrC,8BAA8B;;QAhC9B,iBAAiB;;QAGjB,0CAA0C;;QAG1C,0BAA0B;;QAG1B,oCAAoC;;YA1BpC,gBAAgB;;YAGhB,yBAAyB;;YAGzB,oCAAoC;;YAGpC,6CAA6C;;;;;;;;;;;;;QAoB7C,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;IAuBvC,mCAAmC;;IAGnC,oCAAoC;;IAGpC,kCAAkC;;IAGlC,wCAAwC;;IAGxC,4BAA4B;;IAG5B,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEtB,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAC5C;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GACzC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAcvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAE9D"}

package/dist/result-schema.js

@@ -0,0 +1,96 @@
+/**
+ * Zod Schema for Validation Results
+ *
+ * This schema defines the structure of validation state files and enables
+ * runtime validation and JSON Schema generation for documentation.
+ */
+import { z } from 'zod';
+/**
+ * Validation Step Result Schema
+ */
+export const StepResultSchema = z.object({
+    /** Step name */
+    name: z.string(),
+    /** Did the step pass? */
+    passed: z.boolean(),
+    /** Execution duration in seconds */
+    durationSecs: z.coerce.number(),
+    /** Output from the step (stdout + stderr) */
+    output: z.string().optional(),
+});
+/**
+ * Validation Phase Result Schema
+ */
+export const PhaseResultSchema = z.object({
+    /** Phase name */
+    name: z.string(),
+    /** Phase execution duration in seconds */
+    durationSecs: z.coerce.number(),
+    /** Did the phase pass? */
+    passed: z.boolean(),
+    /** Results from individual steps */
+    steps: z.array(StepResultSchema),
+    /** Output from failed step (if any) */
+    output: z.string().optional(),
+});
+/**
+ * Validation Result Schema
+ *
+ * This schema defines the validation result structure returned by the validation
+ * runner and stored in git notes (v0.12.0+) for history tracking.
+ */
+export const ValidationResultSchema = z.object({
+    /** Did validation pass? */
+    passed: z.boolean(),
+    /** ISO 8601 timestamp */
+    timestamp: z.string(),
+    /** Git tree hash (if in git repo) */
+    treeHash: z.string(),
+    /** Results from each phase */
+    phases: z.array(PhaseResultSchema).optional(),
+    /** Name of failed step (if any) */
+    failedStep: z.string().optional(),
+    /** Command to re-run failed step */
+    rerunCommand: z.string().optional(),
+    /** Output from the failed step */
+    failedStepOutput: z.string().optional(),
+    /** Failed test names (if applicable) */
+    failedTests: z.array(z.string()).optional(),
+    /** Path to full log file */
+    fullLogFile: z.string().optional(),
+    /** Summary message */
+    summary: z.string().optional(),
+});
+/**
+ * Safe validation function
+ *
+ * Validates a validation result object against the schema.
+ *
+ * @param data - Data to validate
+ * @returns Validation result with success/error information
+ */
+export function safeValidateResult(data) {
+    const result = ValidationResultSchema.safeParse(data);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    // Extract error messages
+    const errors = result.error.errors.map(err => {
+        const path = err.path.join('.');
+        return path ? `${path}: ${err.message}` : err.message;
+    });
+    return { success: false, errors };
+}
+/**
+ * Strict validation function
+ *
+ * Validates and throws on error.
+ *
+ * @param data - Data to validate
+ * @returns Validated result
+ * @throws {Error} If validation fails
+ */
+export function validateResult(data) {
+    return ValidationResultSchema.parse(data);
+}
+//# sourceMappingURL=result-schema.js.map

package/dist/result-schema.js.map

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

package/dist/runner.d.ts

@@ -11,51 +11,14 @@
  */
 import { type ChildProcess } from 'child_process';
 import type { ValidationStep, ValidationResult, ValidationConfig, StepResult } from './types.js';
-/**
- * Legacy function - REMOVED in favor of @vibe-validate/git package
- *
- * Use `getGitTreeHash()` from '@vibe-validate/git' instead.
- * This provides deterministic, content-based tree hashing.
- *
- * @deprecated Removed in v0.9.11 - Use @vibe-validate/git instead
- */
-/**
- * Check if validation has already passed for current working tree state
- *
- * Reads the validation state file and compares the git tree hash to determine
- * if validation can be skipped (cache hit).
- *
- * @param currentTreeHash - Current git tree hash of working directory
- * @param stateFilePath - Path to validation state file
- * @returns Object with alreadyPassed flag and optional previousState
- *
- * @example
- * ```typescript
- * const { alreadyPassed, previousState } = checkExistingValidation(
- *   'abc123...',
- *   '.validate-state.json'
- * );
- *
- * if (alreadyPassed) {
- *   console.log('Validation already passed!');
- *   return previousState;
- * }
- * ```
- *
- * @public
- */
-export declare function checkExistingValidation(currentTreeHash: string, stateFilePath: string): {
-    alreadyPassed: boolean;
-    previousState?: ValidationResult;
-};
 /**
  * Parse test output to extract specific failures
  *
  * Extracts failure details from validation step output using pattern matching.
  * Supports Vitest, TypeScript, and ESLint error formats.
  *
- * Note: This is a basic implementation - the formatters package provides
- * more sophisticated parsing with tool-specific formatters.
+ * Note: This is a basic implementation - the extractors package provides
+ * more sophisticated parsing with tool-specific extractors.
  *
  * @param output - Raw stdout/stderr output from validation step
  * @returns Array of extracted failure messages (max 10 per failure type)
@@ -72,6 +35,7 @@ export declare function checkExistingValidation(currentTreeHash: string, stateFi
  * ```
  *
  * @public
+ * @deprecated Use extractByStepName() from @vibe-validate/extractors instead
  */
 export declare function parseFailures(output: string): string[];
 /**
@@ -106,7 +70,7 @@ export declare function parseFailures(output: string): string[];
  *
  * @public
  */
-export declare function runStepsInParallel(steps: ValidationStep[], phaseName: string, enableFailFast?: boolean, env?: Record<string, string>, verbose?: boolean): Promise<{
+export declare function runStepsInParallel(steps: ValidationStep[], phaseName: string, enableFailFast?: boolean, env?: Record<string, string>, verbose?: boolean, yaml?: boolean, developerFeedback?: boolean): Promise<{
     success: boolean;
     failedStep?: ValidationStep;
     outputs: Map<string, string>;
@@ -142,9 +106,7 @@ export declare function runStepsInParallel(steps: ValidationStep[], phaseName: s
  *       ],
  *     },
  *   ],
- *   stateFilePath: '.vibe-validate-state.yaml',
  *   enableFailFast: false,
- *   forceRun: false,
  * });
  *
  * if (result.passed) {