@vibe-validate/core 0.14.3 → 0.15.0-rc.1

package/dist/result-schema.d.ts

@@ -5,238 +5,1502 @@
  * runtime validation and JSON Schema generation for documentation.
  */
 import { z } from 'zod';
+/**
+ * Base: Command Execution Schema
+ *
+ * Shared by all command executions (RunResult, StepResult).
+ * Every command execution has:
+ * - What ran (command)
+ * - How it ended (exitCode)
+ * - How long it took (durationSecs)
+ * - What errors occurred (extraction)
+ */
+export declare const CommandExecutionSchema: z.ZodObject<{
+    /** Command that was executed */
+    command: z.ZodString;
+    /** Exit code from the command */
+    exitCode: z.ZodNumber;
+    /** Execution duration in seconds */
+    durationSecs: z.ZodNumber;
+    /** Extracted error information (LLM-optimized, structured errors) */
+    extraction: z.ZodOptional<z.ZodObject<{
+        summary: z.ZodString;
+        totalErrors: z.ZodNumber;
+        errors: z.ZodArray<z.ZodObject<{
+            file: z.ZodOptional<z.ZodString>;
+            line: z.ZodOptional<z.ZodNumber>;
+            column: z.ZodOptional<z.ZodNumber>;
+            message: z.ZodString;
+            code: z.ZodOptional<z.ZodString>;
+            severity: z.ZodOptional<z.ZodEnum<["error", "warning"]>>;
+            context: z.ZodOptional<z.ZodString>;
+            guidance: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            file?: string | undefined;
+            line?: number | undefined;
+            column?: number | undefined;
+            code?: string | undefined;
+            severity?: "error" | "warning" | undefined;
+            context?: string | undefined;
+            guidance?: string | undefined;
+        }, {
+            message: string;
+            file?: string | undefined;
+            line?: number | undefined;
+            column?: number | undefined;
+            code?: string | undefined;
+            severity?: "error" | "warning" | undefined;
+            context?: string | undefined;
+            guidance?: string | undefined;
+        }>, "many">;
+        guidance: z.ZodOptional<z.ZodString>;
+        errorSummary: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodObject<{
+            detection: z.ZodOptional<z.ZodObject<{
+                extractor: z.ZodString;
+                confidence: z.ZodNumber;
+                patterns: z.ZodArray<z.ZodString, "many">;
+                reason: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                extractor: string;
+                confidence: number;
+                patterns: string[];
+                reason: string;
+            }, {
+                extractor: string;
+                confidence: number;
+                patterns: string[];
+                reason: string;
+            }>>;
+            confidence: z.ZodNumber;
+            completeness: z.ZodNumber;
+            issues: z.ZodArray<z.ZodString, "many">;
+            suggestions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            issues: string[];
+            confidence: number;
+            completeness: number;
+            detection?: {
+                extractor: string;
+                confidence: number;
+                patterns: string[];
+                reason: string;
+            } | undefined;
+            suggestions?: string[] | undefined;
+        }, {
+            issues: string[];
+            confidence: number;
+            completeness: number;
+            detection?: {
+                extractor: string;
+                confidence: number;
+                patterns: string[];
+                reason: string;
+            } | undefined;
+            suggestions?: string[] | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        summary: string;
+        totalErrors: number;
+        errors: {
+            message: string;
+            file?: string | undefined;
+            line?: number | undefined;
+            column?: number | undefined;
+            code?: string | undefined;
+            severity?: "error" | "warning" | undefined;
+            context?: string | undefined;
+            guidance?: string | undefined;
+        }[];
+        guidance?: string | undefined;
+        errorSummary?: string | undefined;
+        metadata?: {
+            issues: string[];
+            confidence: number;
+            completeness: number;
+            detection?: {
+                extractor: string;
+                confidence: number;
+                patterns: string[];
+                reason: string;
+            } | undefined;
+            suggestions?: string[] | undefined;
+        } | undefined;
+    }, {
+        summary: string;
+        totalErrors: number;
+        errors: {
+            message: string;
+            file?: string | undefined;
+            line?: number | undefined;
+            column?: number | undefined;
+            code?: string | undefined;
+            severity?: "error" | "warning" | undefined;
+            context?: string | undefined;
+            guidance?: string | undefined;
+        }[];
+        guidance?: string | undefined;
+        errorSummary?: string | undefined;
+        metadata?: {
+            issues: string[];
+            confidence: number;
+            completeness: number;
+            detection?: {
+                extractor: string;
+                confidence: number;
+                patterns: string[];
+                reason: string;
+            } | undefined;
+            suggestions?: string[] | undefined;
+        } | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    exitCode: number;
+    durationSecs: number;
+    extraction?: {
+        summary: string;
+        totalErrors: number;
+        errors: {
+            message: string;
+            file?: string | undefined;
+            line?: number | undefined;
+            column?: number | undefined;
+            code?: string | undefined;
+            severity?: "error" | "warning" | undefined;
+            context?: string | undefined;
+            guidance?: string | undefined;
+        }[];
+        guidance?: string | undefined;
+        errorSummary?: string | undefined;
+        metadata?: {
+            issues: string[];
+            confidence: number;
+            completeness: number;
+            detection?: {
+                extractor: string;
+                confidence: number;
+                patterns: string[];
+                reason: string;
+            } | undefined;
+            suggestions?: string[] | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    command: string;
+    exitCode: number;
+    durationSecs: number;
+    extraction?: {
+        summary: string;
+        totalErrors: number;
+        errors: {
+            message: string;
+            file?: string | undefined;
+            line?: number | undefined;
+            column?: number | undefined;
+            code?: string | undefined;
+            severity?: "error" | "warning" | undefined;
+            context?: string | undefined;
+            guidance?: string | undefined;
+        }[];
+        guidance?: string | undefined;
+        errorSummary?: string | undefined;
+        metadata?: {
+            issues: string[];
+            confidence: number;
+            completeness: number;
+            detection?: {
+                extractor: string;
+                confidence: number;
+                patterns: string[];
+                reason: string;
+            } | undefined;
+            suggestions?: string[] | undefined;
+        } | undefined;
+    } | undefined;
+}>;
+/**
+ * Output Files Schema
+ *
+ * Shared by RunResult and StepResult.
+ * Provides paths to organized output files for debugging and inspection.
+ */
+export declare const OutputFilesSchema: z.ZodObject<{
+    /** Path to stdout.log (omitted if empty) */
+    stdout: z.ZodOptional<z.ZodString>;
+    /** Path to stderr.log (omitted if empty) */
+    stderr: z.ZodOptional<z.ZodString>;
+    /** Path to combined.jsonl (chronological, ANSI-stripped) */
+    combined: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    combined: string;
+    stdout?: string | undefined;
+    stderr?: string | undefined;
+}, {
+    combined: string;
+    stdout?: string | undefined;
+    stderr?: string | undefined;
+}>;
+/**
+ * Base: Operation Metadata Schema
+ *
+ * Shared by top-level operations (RunResult, ValidationResult).
+ * Every operation has:
+ * - When it ran (timestamp)
+ * - What code state (treeHash)
+ */
+export declare const OperationMetadataSchema: z.ZodObject<{
+    /** When the operation was executed (ISO 8601) */
+    timestamp: z.ZodString;
+    /** Git tree hash identifying the code state */
+    treeHash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    treeHash: string;
+}, {
+    timestamp: string;
+    treeHash: string;
+}>;
 /**
  * Validation Step Result Schema
+ *
+ * Extends CommandExecutionSchema with step-specific fields.
+ *
+ * Field ordering is optimized for LLM consumption:
+ * - What step (name)
+ * - Did it pass? (passed)
+ * - Command execution details (command, exitCode, durationSecs, extraction)
+ * - Debug resources (outputFiles)
+ *
+ * v0.15.0 BREAKING CHANGES:
+ * - Now extends CommandExecutionSchema (adds command, exitCode)
+ * - Removed extractionQuality (use extraction.metadata instead)
+ * - Removed output field (use extraction instead)
+ * - Removed failedTests field (use extraction.errors instead)
+ * - Added isCachedResult to indicate when result came from cache
+ * - Added .strict() to reject unknown properties (prevents internal fields from leaking)
+ *
+ * v0.15.1 ENHANCEMENTS:
+ * - Added outputFiles for debugging (stdout.log, stderr.log, combined.jsonl)
  */
 export declare const StepResultSchema: z.ZodObject<{
+    /** Command that was executed */
+    command: z.ZodString;
+    /** Exit code from the command */
+    exitCode: z.ZodNumber;
+    /** Execution duration in seconds */
+    durationSecs: z.ZodNumber;
+    /** Extracted error information (LLM-optimized, structured errors) */
+    extraction: z.ZodOptional<z.ZodObject<{
+        summary: z.ZodString;
+        totalErrors: z.ZodNumber;
+        errors: z.ZodArray<z.ZodObject<{
+            file: z.ZodOptional<z.ZodString>;
+            line: z.ZodOptional<z.ZodNumber>;
+            column: z.ZodOptional<z.ZodNumber>;
+            message: z.ZodString;
+            code: z.ZodOptional<z.ZodString>;
+            severity: z.ZodOptional<z.ZodEnum<["error", "warning"]>>;
+            context: z.ZodOptional<z.ZodString>;
+            guidance: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            file?: string | undefined;
+            line?: number | undefined;
+            column?: number | undefined;
+            code?: string | undefined;
+            severity?: "error" | "warning" | undefined;
+            context?: string | undefined;
+            guidance?: string | undefined;
+        }, {
+            message: string;
+            file?: string | undefined;
+            line?: number | undefined;
+            column?: number | undefined;
+            code?: string | undefined;
+            severity?: "error" | "warning" | undefined;
+            context?: string | undefined;
+            guidance?: string | undefined;
+        }>, "many">;
+        guidance: z.ZodOptional<z.ZodString>;
+        errorSummary: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodObject<{
+            detection: z.ZodOptional<z.ZodObject<{
+                extractor: z.ZodString;
+                confidence: z.ZodNumber;
+                patterns: z.ZodArray<z.ZodString, "many">;
+                reason: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                extractor: string;
+                confidence: number;
+                patterns: string[];
+                reason: string;
+            }, {
+                extractor: string;
+                confidence: number;
+                patterns: string[];
+                reason: string;
+            }>>;
+            confidence: z.ZodNumber;
+            completeness: z.ZodNumber;
+            issues: z.ZodArray<z.ZodString, "many">;
+            suggestions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            issues: string[];
+            confidence: number;
+            completeness: number;
+            detection?: {
+                extractor: string;
+                confidence: number;
+                patterns: string[];
+                reason: string;
+            } | undefined;
+            suggestions?: string[] | undefined;
+        }, {
+            issues: string[];
+            confidence: number;
+            completeness: number;
+            detection?: {
+                extractor: string;
+                confidence: number;
+                patterns: string[];
+                reason: string;
+            } | undefined;
+            suggestions?: string[] | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        summary: string;
+        totalErrors: number;
+        errors: {
+            message: string;
+            file?: string | undefined;
+            line?: number | undefined;
+            column?: number | undefined;
+            code?: string | undefined;
+            severity?: "error" | "warning" | undefined;
+            context?: string | undefined;
+            guidance?: string | undefined;
+        }[];
+        guidance?: string | undefined;
+        errorSummary?: string | undefined;
+        metadata?: {
+            issues: string[];
+            confidence: number;
+            completeness: number;
+            detection?: {
+                extractor: string;
+                confidence: number;
+                patterns: string[];
+                reason: string;
+            } | undefined;
+            suggestions?: string[] | undefined;
+        } | undefined;
+    }, {
+        summary: string;
+        totalErrors: number;
+        errors: {
+            message: string;
+            file?: string | undefined;
+            line?: number | undefined;
+            column?: number | undefined;
+            code?: string | undefined;
+            severity?: "error" | "warning" | undefined;
+            context?: string | undefined;
+            guidance?: string | undefined;
+        }[];
+        guidance?: string | undefined;
+        errorSummary?: string | undefined;
+        metadata?: {
+            issues: string[];
+            confidence: number;
+            completeness: number;
+            detection?: {
+                extractor: string;
+                confidence: number;
+                patterns: string[];
+                reason: string;
+            } | undefined;
+            suggestions?: string[] | undefined;
+        } | undefined;
+    }>>;
+} & {
     /** Step name */
     name: z.ZodString;
-    /** Did the step pass? */
+    /** Did the step pass? (derived from exitCode === 0) */
     passed: z.ZodBoolean;
-    /** Execution duration in seconds */
-    durationSecs: z.ZodNumber;
-    /** Output from the step (stdout + stderr) */
-    output: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
+    /** Was this result retrieved from cache? (v0.15.0+) */
+    isCachedResult: z.ZodOptional<z.ZodBoolean>;
+    /** Output files from step execution (v0.15.1+) */
+    outputFiles: z.ZodOptional<z.ZodObject<{
+        /** Path to stdout.log (omitted if empty) */
+        stdout: z.ZodOptional<z.ZodString>;
+        /** Path to stderr.log (omitted if empty) */
+        stderr: z.ZodOptional<z.ZodString>;
+        /** Path to combined.jsonl (chronological, ANSI-stripped) */
+        combined: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        combined: string;
+        stdout?: string | undefined;
+        stderr?: string | undefined;
+    }, {
+        combined: string;
+        stdout?: string | undefined;
+        stderr?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    command: string;
+    exitCode: number;
     durationSecs: number;
     name: string;
     passed: boolean;
-    output?: string | undefined;
+    extraction?: {
+        summary: string;
+        totalErrors: number;
+        errors: {
+            message: string;
+            file?: string | undefined;
+            line?: number | undefined;
+            column?: number | undefined;
+            code?: string | undefined;
+            severity?: "error" | "warning" | undefined;
+            context?: string | undefined;
+            guidance?: string | undefined;
+        }[];
+        guidance?: string | undefined;
+        errorSummary?: string | undefined;
+        metadata?: {
+            issues: string[];
+            confidence: number;
+            completeness: number;
+            detection?: {
+                extractor: string;
+                confidence: number;
+                patterns: string[];
+                reason: string;
+            } | undefined;
+            suggestions?: string[] | undefined;
+        } | undefined;
+    } | undefined;
+    isCachedResult?: boolean | undefined;
+    outputFiles?: {
+        combined: string;
+        stdout?: string | undefined;
+        stderr?: string | undefined;
+    } | undefined;
 }, {
+    command: string;
+    exitCode: number;
     durationSecs: number;
     name: string;
     passed: boolean;
-    output?: string | undefined;
+    extraction?: {
+        summary: string;
+        totalErrors: number;
+        errors: {
+            message: string;
+            file?: string | undefined;
+            line?: number | undefined;
+            column?: number | undefined;
+            code?: string | undefined;
+            severity?: "error" | "warning" | undefined;
+            context?: string | undefined;
+            guidance?: string | undefined;
+        }[];
+        guidance?: string | undefined;
+        errorSummary?: string | undefined;
+        metadata?: {
+            issues: string[];
+            confidence: number;
+            completeness: number;
+            detection?: {
+                extractor: string;
+                confidence: number;
+                patterns: string[];
+                reason: string;
+            } | undefined;
+            suggestions?: string[] | undefined;
+        } | undefined;
+    } | undefined;
+    isCachedResult?: boolean | undefined;
+    outputFiles?: {
+        combined: string;
+        stdout?: string | undefined;
+        stderr?: string | undefined;
+    } | undefined;
 }>;
 /**
  * Validation Phase Result Schema
+ *
+ * Field ordering optimized for LLM consumption:
+ * - Phase identification (name)
+ * - Status (passed)
+ * - Duration (durationSecs)
+ * - Step details (steps with extraction for failed steps)
  */
 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;
+    /** Phase execution duration in seconds */
+    durationSecs: z.ZodNumber;
     /** Results from individual steps */
     steps: z.ZodArray<z.ZodObject<{
+        /** Command that was executed */
+        command: z.ZodString;
+        /** Exit code from the command */
+        exitCode: z.ZodNumber;
+        /** Execution duration in seconds */
+        durationSecs: z.ZodNumber;
+        /** Extracted error information (LLM-optimized, structured errors) */
+        extraction: z.ZodOptional<z.ZodObject<{
+            summary: z.ZodString;
+            totalErrors: z.ZodNumber;
+            errors: z.ZodArray<z.ZodObject<{
+                file: z.ZodOptional<z.ZodString>;
+                line: z.ZodOptional<z.ZodNumber>;
+                column: z.ZodOptional<z.ZodNumber>;
+                message: z.ZodString;
+                code: z.ZodOptional<z.ZodString>;
+                severity: z.ZodOptional<z.ZodEnum<["error", "warning"]>>;
+                context: z.ZodOptional<z.ZodString>;
+                guidance: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                file?: string | undefined;
+                line?: number | undefined;
+                column?: number | undefined;
+                code?: string | undefined;
+                severity?: "error" | "warning" | undefined;
+                context?: string | undefined;
+                guidance?: string | undefined;
+            }, {
+                message: string;
+                file?: string | undefined;
+                line?: number | undefined;
+                column?: number | undefined;
+                code?: string | undefined;
+                severity?: "error" | "warning" | undefined;
+                context?: string | undefined;
+                guidance?: string | undefined;
+            }>, "many">;
+            guidance: z.ZodOptional<z.ZodString>;
+            errorSummary: z.ZodOptional<z.ZodString>;
+            metadata: z.ZodOptional<z.ZodObject<{
+                detection: z.ZodOptional<z.ZodObject<{
+                    extractor: z.ZodString;
+                    confidence: z.ZodNumber;
+                    patterns: z.ZodArray<z.ZodString, "many">;
+                    reason: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    extractor: string;
+                    confidence: number;
+                    patterns: string[];
+                    reason: string;
+                }, {
+                    extractor: string;
+                    confidence: number;
+                    patterns: string[];
+                    reason: string;
+                }>>;
+                confidence: z.ZodNumber;
+                completeness: z.ZodNumber;
+                issues: z.ZodArray<z.ZodString, "many">;
+                suggestions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                issues: string[];
+                confidence: number;
+                completeness: number;
+                detection?: {
+                    extractor: string;
+                    confidence: number;
+                    patterns: string[];
+                    reason: string;
+                } | undefined;
+                suggestions?: string[] | undefined;
+            }, {
+                issues: string[];
+                confidence: number;
+                completeness: number;
+                detection?: {
+                    extractor: string;
+                    confidence: number;
+                    patterns: string[];
+                    reason: string;
+                } | undefined;
+                suggestions?: string[] | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            summary: string;
+            totalErrors: number;
+            errors: {
+                message: string;
+                file?: string | undefined;
+                line?: number | undefined;
+                column?: number | undefined;
+                code?: string | undefined;
+                severity?: "error" | "warning" | undefined;
+                context?: string | undefined;
+                guidance?: string | undefined;
+            }[];
+            guidance?: string | undefined;
+            errorSummary?: string | undefined;
+            metadata?: {
+                issues: string[];
+                confidence: number;
+                completeness: number;
+                detection?: {
+                    extractor: string;
+                    confidence: number;
+                    patterns: string[];
+                    reason: string;
+                } | undefined;
+                suggestions?: string[] | undefined;
+            } | undefined;
+        }, {
+            summary: string;
+            totalErrors: number;
+            errors: {
+                message: string;
+                file?: string | undefined;
+                line?: number | undefined;
+                column?: number | undefined;
+                code?: string | undefined;
+                severity?: "error" | "warning" | undefined;
+                context?: string | undefined;
+                guidance?: string | undefined;
+            }[];
+            guidance?: string | undefined;
+            errorSummary?: string | undefined;
+            metadata?: {
+                issues: string[];
+                confidence: number;
+                completeness: number;
+                detection?: {
+                    extractor: string;
+                    confidence: number;
+                    patterns: string[];
+                    reason: string;
+                } | undefined;
+                suggestions?: string[] | undefined;
+            } | undefined;
+        }>>;
+    } & {
         /** Step name */
         name: z.ZodString;
-        /** Did the step pass? */
+        /** Did the step pass? (derived from exitCode === 0) */
         passed: z.ZodBoolean;
-        /** Execution duration in seconds */
-        durationSecs: z.ZodNumber;
-        /** Output from the step (stdout + stderr) */
-        output: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
+        /** Was this result retrieved from cache? (v0.15.0+) */
+        isCachedResult: z.ZodOptional<z.ZodBoolean>;
+        /** Output files from step execution (v0.15.1+) */
+        outputFiles: z.ZodOptional<z.ZodObject<{
+            /** Path to stdout.log (omitted if empty) */
+            stdout: z.ZodOptional<z.ZodString>;
+            /** Path to stderr.log (omitted if empty) */
+            stderr: z.ZodOptional<z.ZodString>;
+            /** Path to combined.jsonl (chronological, ANSI-stripped) */
+            combined: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            combined: string;
+            stdout?: string | undefined;
+            stderr?: string | undefined;
+        }, {
+            combined: string;
+            stdout?: string | undefined;
+            stderr?: string | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        command: string;
+        exitCode: number;
         durationSecs: number;
         name: string;
         passed: boolean;
-        output?: string | undefined;
+        extraction?: {
+            summary: string;
+            totalErrors: number;
+            errors: {
+                message: string;
+                file?: string | undefined;
+                line?: number | undefined;
+                column?: number | undefined;
+                code?: string | undefined;
+                severity?: "error" | "warning" | undefined;
+                context?: string | undefined;
+                guidance?: string | undefined;
+            }[];
+            guidance?: string | undefined;
+            errorSummary?: string | undefined;
+            metadata?: {
+                issues: string[];
+                confidence: number;
+                completeness: number;
+                detection?: {
+                    extractor: string;
+                    confidence: number;
+                    patterns: string[];
+                    reason: string;
+                } | undefined;
+                suggestions?: string[] | undefined;
+            } | undefined;
+        } | undefined;
+        isCachedResult?: boolean | undefined;
+        outputFiles?: {
+            combined: string;
+            stdout?: string | undefined;
+            stderr?: string | undefined;
+        } | undefined;
     }, {
+        command: string;
+        exitCode: number;
         durationSecs: number;
         name: string;
         passed: boolean;
-        output?: string | undefined;
+        extraction?: {
+            summary: string;
+            totalErrors: number;
+            errors: {
+                message: string;
+                file?: string | undefined;
+                line?: number | undefined;
+                column?: number | undefined;
+                code?: string | undefined;
+                severity?: "error" | "warning" | undefined;
+                context?: string | undefined;
+                guidance?: string | undefined;
+            }[];
+            guidance?: string | undefined;
+            errorSummary?: string | undefined;
+            metadata?: {
+                issues: string[];
+                confidence: number;
+                completeness: number;
+                detection?: {
+                    extractor: string;
+                    confidence: number;
+                    patterns: string[];
+                    reason: string;
+                } | undefined;
+                suggestions?: string[] | undefined;
+            } | undefined;
+        } | undefined;
+        isCachedResult?: boolean | undefined;
+        outputFiles?: {
+            combined: string;
+            stdout?: string | undefined;
+            stderr?: string | undefined;
+        } | undefined;
     }>, "many">;
-    /** Output from failed step (if any) */
-    output: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
+}, "strict", z.ZodTypeAny, {
     durationSecs: number;
     name: string;
     passed: boolean;
     steps: {
+        command: string;
+        exitCode: number;
         durationSecs: number;
         name: string;
         passed: boolean;
-        output?: string | undefined;
+        extraction?: {
+            summary: string;
+            totalErrors: number;
+            errors: {
+                message: string;
+                file?: string | undefined;
+                line?: number | undefined;
+                column?: number | undefined;
+                code?: string | undefined;
+                severity?: "error" | "warning" | undefined;
+                context?: string | undefined;
+                guidance?: string | undefined;
+            }[];
+            guidance?: string | undefined;
+            errorSummary?: string | undefined;
+            metadata?: {
+                issues: string[];
+                confidence: number;
+                completeness: number;
+                detection?: {
+                    extractor: string;
+                    confidence: number;
+                    patterns: string[];
+                    reason: string;
+                } | undefined;
+                suggestions?: string[] | undefined;
+            } | undefined;
+        } | undefined;
+        isCachedResult?: boolean | undefined;
+        outputFiles?: {
+            combined: string;
+            stdout?: string | undefined;
+            stderr?: string | undefined;
+        } | undefined;
     }[];
-    output?: string | undefined;
 }, {
     durationSecs: number;
     name: string;
     passed: boolean;
     steps: {
+        command: string;
+        exitCode: number;
         durationSecs: number;
         name: string;
         passed: boolean;
-        output?: string | undefined;
+        extraction?: {
+            summary: string;
+            totalErrors: number;
+            errors: {
+                message: string;
+                file?: string | undefined;
+                line?: number | undefined;
+                column?: number | undefined;
+                code?: string | undefined;
+                severity?: "error" | "warning" | undefined;
+                context?: string | undefined;
+                guidance?: string | undefined;
+            }[];
+            guidance?: string | undefined;
+            errorSummary?: string | undefined;
+            metadata?: {
+                issues: string[];
+                confidence: number;
+                completeness: number;
+                detection?: {
+                    extractor: string;
+                    confidence: number;
+                    patterns: string[];
+                    reason: string;
+                } | undefined;
+                suggestions?: string[] | undefined;
+            } | undefined;
+        } | undefined;
+        isCachedResult?: boolean | undefined;
+        outputFiles?: {
+            combined: string;
+            stdout?: string | undefined;
+            stderr?: string | undefined;
+        } | undefined;
     }[];
-    output?: string | undefined;
 }>;
 /**
  * Validation Result Schema
  *
+ * Extends OperationMetadataSchema with validation-specific fields.
+ *
  * This schema defines the validation result structure returned by the validation
  * runner and stored in git notes (v0.12.0+) for history tracking.
+ *
+ * Field ordering optimized for LLM consumption:
+ * - Status first (passed, summary)
+ * - Operation metadata (timestamp, treeHash)
+ * - Cache indicator (isCachedResult) - v0.15.0+
+ * - Quick navigation (failedStep)
+ * - Detailed breakdown (phases with step-level extraction, each step has command)
+ * - Metadata last (fullLogFile)
+ *
+ * v0.15.0 BREAKING CHANGES:
+ * - Removed rerunCommand (use phases[].steps[].command instead)
+ * - Removed failedStepOutput (use phases[].steps[].extraction instead)
+ * - Added .strict() to reject unknown properties (prevents internal fields
+ *   like _fromCache from leaking into public API)
  */
 export declare const ValidationResultSchema: z.ZodObject<{
-    /** Did validation pass? */
-    passed: z.ZodBoolean;
-    /** ISO 8601 timestamp */
+    /** When the operation was executed (ISO 8601) */
     timestamp: z.ZodString;
-    /** Git tree hash (if in git repo) */
+    /** Git tree hash identifying the code state */
     treeHash: z.ZodString;
-    /** Results from each phase */
+} & {
+    /** Did validation pass? */
+    passed: z.ZodBoolean;
+    /** One-line summary for LLMs (e.g., "Validation passed" or "TypeScript type check failed") */
+    summary: z.ZodOptional<z.ZodString>;
+    /** Was this entire validation result retrieved from cache? (v0.15.0+) */
+    isCachedResult: z.ZodOptional<z.ZodBoolean>;
+    /** Name of failed step (if any) - for quick navigation */
+    failedStep: z.ZodOptional<z.ZodString>;
+    /** Results from each phase (steps include extraction for failures) */
     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;
+        /** Phase execution duration in seconds */
+        durationSecs: z.ZodNumber;
         /** Results from individual steps */
         steps: z.ZodArray<z.ZodObject<{
+            /** Command that was executed */
+            command: z.ZodString;
+            /** Exit code from the command */
+            exitCode: z.ZodNumber;
+            /** Execution duration in seconds */
+            durationSecs: z.ZodNumber;
+            /** Extracted error information (LLM-optimized, structured errors) */
+            extraction: z.ZodOptional<z.ZodObject<{
+                summary: z.ZodString;
+                totalErrors: z.ZodNumber;
+                errors: z.ZodArray<z.ZodObject<{
+                    file: z.ZodOptional<z.ZodString>;
+                    line: z.ZodOptional<z.ZodNumber>;
+                    column: z.ZodOptional<z.ZodNumber>;
+                    message: z.ZodString;
+                    code: z.ZodOptional<z.ZodString>;
+                    severity: z.ZodOptional<z.ZodEnum<["error", "warning"]>>;
+                    context: z.ZodOptional<z.ZodString>;
+                    guidance: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    message: string;
+                    file?: string | undefined;
+                    line?: number | undefined;
+                    column?: number | undefined;
+                    code?: string | undefined;
+                    severity?: "error" | "warning" | undefined;
+                    context?: string | undefined;
+                    guidance?: string | undefined;
+                }, {
+                    message: string;
+                    file?: string | undefined;
+                    line?: number | undefined;
+                    column?: number | undefined;
+                    code?: string | undefined;
+                    severity?: "error" | "warning" | undefined;
+                    context?: string | undefined;
+                    guidance?: string | undefined;
+                }>, "many">;
+                guidance: z.ZodOptional<z.ZodString>;
+                errorSummary: z.ZodOptional<z.ZodString>;
+                metadata: z.ZodOptional<z.ZodObject<{
+                    detection: z.ZodOptional<z.ZodObject<{
+                        extractor: z.ZodString;
+                        confidence: z.ZodNumber;
+                        patterns: z.ZodArray<z.ZodString, "many">;
+                        reason: z.ZodString;
+                    }, "strip", z.ZodTypeAny, {
+                        extractor: string;
+                        confidence: number;
+                        patterns: string[];
+                        reason: string;
+                    }, {
+                        extractor: string;
+                        confidence: number;
+                        patterns: string[];
+                        reason: string;
+                    }>>;
+                    confidence: z.ZodNumber;
+                    completeness: z.ZodNumber;
+                    issues: z.ZodArray<z.ZodString, "many">;
+                    suggestions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                }, "strip", z.ZodTypeAny, {
+                    issues: string[];
+                    confidence: number;
+                    completeness: number;
+                    detection?: {
+                        extractor: string;
+                        confidence: number;
+                        patterns: string[];
+                        reason: string;
+                    } | undefined;
+                    suggestions?: string[] | undefined;
+                }, {
+                    issues: string[];
+                    confidence: number;
+                    completeness: number;
+                    detection?: {
+                        extractor: string;
+                        confidence: number;
+                        patterns: string[];
+                        reason: string;
+                    } | undefined;
+                    suggestions?: string[] | undefined;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                summary: string;
+                totalErrors: number;
+                errors: {
+                    message: string;
+                    file?: string | undefined;
+                    line?: number | undefined;
+                    column?: number | undefined;
+                    code?: string | undefined;
+                    severity?: "error" | "warning" | undefined;
+                    context?: string | undefined;
+                    guidance?: string | undefined;
+                }[];
+                guidance?: string | undefined;
+                errorSummary?: string | undefined;
+                metadata?: {
+                    issues: string[];
+                    confidence: number;
+                    completeness: number;
+                    detection?: {
+                        extractor: string;
+                        confidence: number;
+                        patterns: string[];
+                        reason: string;
+                    } | undefined;
+                    suggestions?: string[] | undefined;
+                } | undefined;
+            }, {
+                summary: string;
+                totalErrors: number;
+                errors: {
+                    message: string;
+                    file?: string | undefined;
+                    line?: number | undefined;
+                    column?: number | undefined;
+                    code?: string | undefined;
+                    severity?: "error" | "warning" | undefined;
+                    context?: string | undefined;
+                    guidance?: string | undefined;
+                }[];
+                guidance?: string | undefined;
+                errorSummary?: string | undefined;
+                metadata?: {
+                    issues: string[];
+                    confidence: number;
+                    completeness: number;
+                    detection?: {
+                        extractor: string;
+                        confidence: number;
+                        patterns: string[];
+                        reason: string;
+                    } | undefined;
+                    suggestions?: string[] | undefined;
+                } | undefined;
+            }>>;
+        } & {
             /** Step name */
             name: z.ZodString;
-            /** Did the step pass? */
+            /** Did the step pass? (derived from exitCode === 0) */
             passed: z.ZodBoolean;
-            /** Execution duration in seconds */
-            durationSecs: z.ZodNumber;
-            /** Output from the step (stdout + stderr) */
-            output: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
+            /** Was this result retrieved from cache? (v0.15.0+) */
+            isCachedResult: z.ZodOptional<z.ZodBoolean>;
+            /** Output files from step execution (v0.15.1+) */
+            outputFiles: z.ZodOptional<z.ZodObject<{
+                /** Path to stdout.log (omitted if empty) */
+                stdout: z.ZodOptional<z.ZodString>;
+                /** Path to stderr.log (omitted if empty) */
+                stderr: z.ZodOptional<z.ZodString>;
+                /** Path to combined.jsonl (chronological, ANSI-stripped) */
+                combined: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                combined: string;
+                stdout?: string | undefined;
+                stderr?: string | undefined;
+            }, {
+                combined: string;
+                stdout?: string | undefined;
+                stderr?: string | undefined;
+            }>>;
+        }, "strict", z.ZodTypeAny, {
+            command: string;
+            exitCode: number;
             durationSecs: number;
             name: string;
             passed: boolean;
-            output?: string | undefined;
+            extraction?: {
+                summary: string;
+                totalErrors: number;
+                errors: {
+                    message: string;
+                    file?: string | undefined;
+                    line?: number | undefined;
+                    column?: number | undefined;
+                    code?: string | undefined;
+                    severity?: "error" | "warning" | undefined;
+                    context?: string | undefined;
+                    guidance?: string | undefined;
+                }[];
+                guidance?: string | undefined;
+                errorSummary?: string | undefined;
+                metadata?: {
+                    issues: string[];
+                    confidence: number;
+                    completeness: number;
+                    detection?: {
+                        extractor: string;
+                        confidence: number;
+                        patterns: string[];
+                        reason: string;
+                    } | undefined;
+                    suggestions?: string[] | undefined;
+                } | undefined;
+            } | undefined;
+            isCachedResult?: boolean | undefined;
+            outputFiles?: {
+                combined: string;
+                stdout?: string | undefined;
+                stderr?: string | undefined;
+            } | undefined;
         }, {
+            command: string;
+            exitCode: number;
             durationSecs: number;
             name: string;
             passed: boolean;
-            output?: string | undefined;
+            extraction?: {
+                summary: string;
+                totalErrors: number;
+                errors: {
+                    message: string;
+                    file?: string | undefined;
+                    line?: number | undefined;
+                    column?: number | undefined;
+                    code?: string | undefined;
+                    severity?: "error" | "warning" | undefined;
+                    context?: string | undefined;
+                    guidance?: string | undefined;
+                }[];
+                guidance?: string | undefined;
+                errorSummary?: string | undefined;
+                metadata?: {
+                    issues: string[];
+                    confidence: number;
+                    completeness: number;
+                    detection?: {
+                        extractor: string;
+                        confidence: number;
+                        patterns: string[];
+                        reason: string;
+                    } | undefined;
+                    suggestions?: string[] | undefined;
+                } | undefined;
+            } | undefined;
+            isCachedResult?: boolean | undefined;
+            outputFiles?: {
+                combined: string;
+                stdout?: string | undefined;
+                stderr?: string | undefined;
+            } | undefined;
         }>, "many">;
-        /** Output from failed step (if any) */
-        output: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
+    }, "strict", z.ZodTypeAny, {
         durationSecs: number;
         name: string;
         passed: boolean;
         steps: {
+            command: string;
+            exitCode: number;
             durationSecs: number;
             name: string;
             passed: boolean;
-            output?: string | undefined;
+            extraction?: {
+                summary: string;
+                totalErrors: number;
+                errors: {
+                    message: string;
+                    file?: string | undefined;
+                    line?: number | undefined;
+                    column?: number | undefined;
+                    code?: string | undefined;
+                    severity?: "error" | "warning" | undefined;
+                    context?: string | undefined;
+                    guidance?: string | undefined;
+                }[];
+                guidance?: string | undefined;
+                errorSummary?: string | undefined;
+                metadata?: {
+                    issues: string[];
+                    confidence: number;
+                    completeness: number;
+                    detection?: {
+                        extractor: string;
+                        confidence: number;
+                        patterns: string[];
+                        reason: string;
+                    } | undefined;
+                    suggestions?: string[] | undefined;
+                } | undefined;
+            } | undefined;
+            isCachedResult?: boolean | undefined;
+            outputFiles?: {
+                combined: string;
+                stdout?: string | undefined;
+                stderr?: string | undefined;
+            } | undefined;
         }[];
-        output?: string | undefined;
     }, {
         durationSecs: number;
         name: string;
         passed: boolean;
         steps: {
+            command: string;
+            exitCode: number;
             durationSecs: number;
             name: string;
             passed: boolean;
-            output?: string | undefined;
+            extraction?: {
+                summary: string;
+                totalErrors: number;
+                errors: {
+                    message: string;
+                    file?: string | undefined;
+                    line?: number | undefined;
+                    column?: number | undefined;
+                    code?: string | undefined;
+                    severity?: "error" | "warning" | undefined;
+                    context?: string | undefined;
+                    guidance?: string | undefined;
+                }[];
+                guidance?: string | undefined;
+                errorSummary?: string | undefined;
+                metadata?: {
+                    issues: string[];
+                    confidence: number;
+                    completeness: number;
+                    detection?: {
+                        extractor: string;
+                        confidence: number;
+                        patterns: string[];
+                        reason: string;
+                    } | undefined;
+                    suggestions?: string[] | undefined;
+                } | undefined;
+            } | undefined;
+            isCachedResult?: boolean | undefined;
+            outputFiles?: {
+                combined: string;
+                stdout?: string | undefined;
+                stderr?: string | undefined;
+            } | 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;
+}, "strict", z.ZodTypeAny, {
     timestamp: string;
     treeHash: string;
+    passed: boolean;
+    isCachedResult?: boolean | undefined;
+    summary?: string | undefined;
     failedStep?: string | undefined;
     phases?: {
         durationSecs: number;
         name: string;
         passed: boolean;
         steps: {
+            command: string;
+            exitCode: number;
             durationSecs: number;
             name: string;
             passed: boolean;
-            output?: string | undefined;
+            extraction?: {
+                summary: string;
+                totalErrors: number;
+                errors: {
+                    message: string;
+                    file?: string | undefined;
+                    line?: number | undefined;
+                    column?: number | undefined;
+                    code?: string | undefined;
+                    severity?: "error" | "warning" | undefined;
+                    context?: string | undefined;
+                    guidance?: string | undefined;
+                }[];
+                guidance?: string | undefined;
+                errorSummary?: string | undefined;
+                metadata?: {
+                    issues: string[];
+                    confidence: number;
+                    completeness: number;
+                    detection?: {
+                        extractor: string;
+                        confidence: number;
+                        patterns: string[];
+                        reason: string;
+                    } | undefined;
+                    suggestions?: string[] | undefined;
+                } | undefined;
+            } | undefined;
+            isCachedResult?: boolean | undefined;
+            outputFiles?: {
+                combined: string;
+                stdout?: string | undefined;
+                stderr?: string | undefined;
+            } | 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;
+    passed: boolean;
+    isCachedResult?: boolean | undefined;
+    summary?: string | undefined;
     failedStep?: string | undefined;
     phases?: {
         durationSecs: number;
         name: string;
         passed: boolean;
         steps: {
+            command: string;
+            exitCode: number;
             durationSecs: number;
             name: string;
             passed: boolean;
-            output?: string | undefined;
+            extraction?: {
+                summary: string;
+                totalErrors: number;
+                errors: {
+                    message: string;
+                    file?: string | undefined;
+                    line?: number | undefined;
+                    column?: number | undefined;
+                    code?: string | undefined;
+                    severity?: "error" | "warning" | undefined;
+                    context?: string | undefined;
+                    guidance?: string | undefined;
+                }[];
+                guidance?: string | undefined;
+                errorSummary?: string | undefined;
+                metadata?: {
+                    issues: string[];
+                    confidence: number;
+                    completeness: number;
+                    detection?: {
+                        extractor: string;
+                        confidence: number;
+                        patterns: string[];
+                        reason: string;
+                    } | undefined;
+                    suggestions?: string[] | undefined;
+                } | undefined;
+            } | undefined;
+            isCachedResult?: boolean | undefined;
+            outputFiles?: {
+                combined: string;
+                stdout?: string | undefined;
+                stderr?: string | undefined;
+            } | 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 OutputFiles = z.infer<typeof OutputFilesSchema>;
 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
+ * Safe validation function (uses shared utility)
  */
-export declare function safeValidateResult(data: unknown): {
+export declare const safeValidateResult: (data: unknown) => {
     success: true;
-    data: ValidationResult;
+    data: {
+        timestamp: string;
+        treeHash: string;
+        passed: boolean;
+        isCachedResult?: boolean | undefined;
+        summary?: string | undefined;
+        failedStep?: string | undefined;
+        phases?: {
+            durationSecs: number;
+            name: string;
+            passed: boolean;
+            steps: {
+                command: string;
+                exitCode: number;
+                durationSecs: number;
+                name: string;
+                passed: boolean;
+                extraction?: {
+                    summary: string;
+                    totalErrors: number;
+                    errors: {
+                        message: string;
+                        file?: string | undefined;
+                        line?: number | undefined;
+                        column?: number | undefined;
+                        code?: string | undefined;
+                        severity?: "error" | "warning" | undefined;
+                        context?: string | undefined;
+                        guidance?: string | undefined;
+                    }[];
+                    guidance?: string | undefined;
+                    errorSummary?: string | undefined;
+                    metadata?: {
+                        issues: string[];
+                        confidence: number;
+                        completeness: number;
+                        detection?: {
+                            extractor: string;
+                            confidence: number;
+                            patterns: string[];
+                            reason: string;
+                        } | undefined;
+                        suggestions?: string[] | undefined;
+                    } | undefined;
+                } | undefined;
+                isCachedResult?: boolean | undefined;
+                outputFiles?: {
+                    combined: string;
+                    stdout?: string | undefined;
+                    stderr?: string | undefined;
+                } | undefined;
+            }[];
+        }[] | undefined;
+        fullLogFile?: string | undefined;
+    };
 } | {
     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
+ * Strict validation function (uses shared utility)
  */
-export declare function validateResult(data: unknown): ValidationResult;
+export declare const validateResult: (data: unknown) => {
+    timestamp: string;
+    treeHash: string;
+    passed: boolean;
+    isCachedResult?: boolean | undefined;
+    summary?: string | undefined;
+    failedStep?: string | undefined;
+    phases?: {
+        durationSecs: number;
+        name: string;
+        passed: boolean;
+        steps: {
+            command: string;
+            exitCode: number;
+            durationSecs: number;
+            name: string;
+            passed: boolean;
+            extraction?: {
+                summary: string;
+                totalErrors: number;
+                errors: {
+                    message: string;
+                    file?: string | undefined;
+                    line?: number | undefined;
+                    column?: number | undefined;
+                    code?: string | undefined;
+                    severity?: "error" | "warning" | undefined;
+                    context?: string | undefined;
+                    guidance?: string | undefined;
+                }[];
+                guidance?: string | undefined;
+                errorSummary?: string | undefined;
+                metadata?: {
+                    issues: string[];
+                    confidence: number;
+                    completeness: number;
+                    detection?: {
+                        extractor: string;
+                        confidence: number;
+                        patterns: string[];
+                        reason: string;
+                    } | undefined;
+                    suggestions?: string[] | undefined;
+                } | undefined;
+            } | undefined;
+            isCachedResult?: boolean | undefined;
+            outputFiles?: {
+                combined: string;
+                stdout?: string | undefined;
+                stderr?: string | undefined;
+            } | undefined;
+        }[];
+    }[] | undefined;
+    fullLogFile?: string | undefined;
+};
 //# sourceMappingURL=result-schema.d.ts.map