@defai.digital/contracts 13.0.3

package/dist/review/v1/schema.d.ts

@@ -0,0 +1,1284 @@
+/**
+ * Review Domain Contracts v1
+ *
+ * Schemas for AI-powered code review with focused analysis modes.
+ *
+ * Invariants:
+ * - INV-REV-001: Focus Mode Isolation
+ * - INV-REV-002: Confidence Filtering
+ * - INV-REV-003: Explanation Required
+ * - INV-REV-004: Actionable Suggestions
+ * - INV-REV-OPS-001: Timeout Handling
+ * - INV-REV-OPS-002: Provider Fallback
+ * - INV-REV-OUT-001: Severity Ordering
+ * - INV-REV-OUT-002: Health Score Calculation
+ * - INV-REV-OUT-003: SARIF Compliance
+ */
+import { z } from 'zod';
+/**
+ * Review focus modes - each mode provides specialized analysis
+ * INV-REV-001: Each focus mode MUST only report issues relevant to that focus
+ */
+export declare const ReviewFocusSchema: z.ZodEnum<["security", "architecture", "performance", "maintainability", "correctness", "all"]>;
+export type ReviewFocus = z.infer<typeof ReviewFocusSchema>;
+/**
+ * Review request schema
+ */
+export declare const ReviewRequestSchema: z.ZodObject<{
+    /** Unique request ID */
+    requestId: z.ZodString;
+    /** Paths to review (files or directories) */
+    paths: z.ZodArray<z.ZodString, "many">;
+    /** Focus mode for specialized review */
+    focus: z.ZodDefault<z.ZodEnum<["security", "architecture", "performance", "maintainability", "correctness", "all"]>>;
+    /** Additional context for the reviewer */
+    context: z.ZodOptional<z.ZodString>;
+    /** Minimum confidence threshold (0-1) - INV-REV-002 */
+    minConfidence: z.ZodDefault<z.ZodNumber>;
+    /** Maximum files to analyze */
+    maxFiles: z.ZodDefault<z.ZodNumber>;
+    /** Maximum lines per file */
+    maxLinesPerFile: z.ZodDefault<z.ZodNumber>;
+    /** Provider to use (optional, uses default routing) */
+    providerId: z.ZodOptional<z.ZodString>;
+    /** Timeout in milliseconds - INV-REV-OPS-001 */
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    /** Output format */
+    outputFormat: z.ZodDefault<z.ZodEnum<["markdown", "json", "sarif"]>>;
+    /** Dry run - only show what would be analyzed */
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    requestId: string;
+    timeoutMs: number;
+    paths: string[];
+    focus: "performance" | "architecture" | "all" | "security" | "maintainability" | "correctness";
+    minConfidence: number;
+    maxFiles: number;
+    maxLinesPerFile: number;
+    outputFormat: "markdown" | "json" | "sarif";
+    dryRun: boolean;
+    context?: string | undefined;
+    providerId?: string | undefined;
+}, {
+    requestId: string;
+    paths: string[];
+    context?: string | undefined;
+    timeoutMs?: number | undefined;
+    providerId?: string | undefined;
+    focus?: "performance" | "architecture" | "all" | "security" | "maintainability" | "correctness" | undefined;
+    minConfidence?: number | undefined;
+    maxFiles?: number | undefined;
+    maxLinesPerFile?: number | undefined;
+    outputFormat?: "markdown" | "json" | "sarif" | undefined;
+    dryRun?: boolean | undefined;
+}>;
+export type ReviewRequest = z.infer<typeof ReviewRequestSchema>;
+/**
+ * Review comment severity levels
+ * INV-REV-OUT-001: Comments MUST be ordered by severity (critical first)
+ */
+export declare const ReviewCommentSeveritySchema: z.ZodEnum<["critical", "warning", "suggestion", "note"]>;
+export type ReviewCommentSeverity = z.infer<typeof ReviewCommentSeveritySchema>;
+/**
+ * Review comment schema
+ * INV-REV-003: Every comment MUST include rationale (body field)
+ * INV-REV-004: Comments with severity >= warning MUST include suggestion
+ */
+export declare const ReviewCommentSchema: z.ZodObject<{
+    /** Unique comment ID */
+    commentId: z.ZodString;
+    /** File path */
+    file: z.ZodString;
+    /** Starting line number */
+    line: z.ZodNumber;
+    /** Ending line number (for multi-line comments) */
+    lineEnd: z.ZodOptional<z.ZodNumber>;
+    /** Comment severity */
+    severity: z.ZodEnum<["critical", "warning", "suggestion", "note"]>;
+    /** Short title (max 100 chars) */
+    title: z.ZodString;
+    /** Detailed explanation (markdown supported) - Required per INV-REV-003 */
+    body: z.ZodString;
+    /** Why this matters */
+    rationale: z.ZodOptional<z.ZodString>;
+    /** Suggested fix or improvement - Required for critical/warning per INV-REV-004 */
+    suggestion: z.ZodOptional<z.ZodString>;
+    /** Code snippet showing the fix */
+    suggestedCode: z.ZodOptional<z.ZodString>;
+    /** Review focus that triggered this */
+    focus: z.ZodEnum<["security", "architecture", "performance", "maintainability", "correctness", "all"]>;
+    /** Confidence score (0-1) - INV-REV-002 */
+    confidence: z.ZodNumber;
+    /** Category tag */
+    category: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    severity: "critical" | "suggestion" | "warning" | "note";
+    category: string;
+    title: string;
+    confidence: number;
+    focus: "performance" | "architecture" | "all" | "security" | "maintainability" | "correctness";
+    commentId: string;
+    file: string;
+    line: number;
+    body: string;
+    suggestion?: string | undefined;
+    lineEnd?: number | undefined;
+    rationale?: string | undefined;
+    suggestedCode?: string | undefined;
+}, {
+    severity: "critical" | "suggestion" | "warning" | "note";
+    category: string;
+    title: string;
+    confidence: number;
+    focus: "performance" | "architecture" | "all" | "security" | "maintainability" | "correctness";
+    commentId: string;
+    file: string;
+    line: number;
+    body: string;
+    suggestion?: string | undefined;
+    lineEnd?: number | undefined;
+    rationale?: string | undefined;
+    suggestedCode?: string | undefined;
+}>;
+export type ReviewComment = z.infer<typeof ReviewCommentSchema>;
+/**
+ * Review summary statistics
+ * INV-REV-OUT-002: Health score MUST reflect weighted severity counts
+ */
+export declare const ReviewSummarySchema: z.ZodObject<{
+    /** Total comments by severity */
+    bySeverity: z.ZodObject<{
+        critical: z.ZodNumber;
+        warning: z.ZodNumber;
+        suggestion: z.ZodNumber;
+        note: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        critical: number;
+        suggestion: number;
+        warning: number;
+        note: number;
+    }, {
+        critical: number;
+        suggestion: number;
+        warning: number;
+        note: number;
+    }>;
+    /** Total comments by focus */
+    byFocus: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    /** Files with most issues */
+    hotspots: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        commentCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        commentCount: number;
+    }, {
+        file: string;
+        commentCount: number;
+    }>, "many">;
+    /** Overall health score (0-100) - Calculated per INV-REV-OUT-002 */
+    healthScore: z.ZodNumber;
+    /** One-line verdict */
+    verdict: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    bySeverity: {
+        critical: number;
+        suggestion: number;
+        warning: number;
+        note: number;
+    };
+    byFocus: Record<string, number>;
+    hotspots: {
+        file: string;
+        commentCount: number;
+    }[];
+    healthScore: number;
+    verdict: string;
+}, {
+    bySeverity: {
+        critical: number;
+        suggestion: number;
+        warning: number;
+        note: number;
+    };
+    byFocus: Record<string, number>;
+    hotspots: {
+        file: string;
+        commentCount: number;
+    }[];
+    healthScore: number;
+    verdict: string;
+}>;
+export type ReviewSummary = z.infer<typeof ReviewSummarySchema>;
+/**
+ * Review result schema
+ */
+export declare const ReviewResultSchema: z.ZodObject<{
+    /** Unique result ID */
+    resultId: z.ZodString;
+    /** Original request ID */
+    requestId: z.ZodString;
+    /** Review comments - ordered by severity per INV-REV-OUT-001 */
+    comments: z.ZodArray<z.ZodObject<{
+        /** Unique comment ID */
+        commentId: z.ZodString;
+        /** File path */
+        file: z.ZodString;
+        /** Starting line number */
+        line: z.ZodNumber;
+        /** Ending line number (for multi-line comments) */
+        lineEnd: z.ZodOptional<z.ZodNumber>;
+        /** Comment severity */
+        severity: z.ZodEnum<["critical", "warning", "suggestion", "note"]>;
+        /** Short title (max 100 chars) */
+        title: z.ZodString;
+        /** Detailed explanation (markdown supported) - Required per INV-REV-003 */
+        body: z.ZodString;
+        /** Why this matters */
+        rationale: z.ZodOptional<z.ZodString>;
+        /** Suggested fix or improvement - Required for critical/warning per INV-REV-004 */
+        suggestion: z.ZodOptional<z.ZodString>;
+        /** Code snippet showing the fix */
+        suggestedCode: z.ZodOptional<z.ZodString>;
+        /** Review focus that triggered this */
+        focus: z.ZodEnum<["security", "architecture", "performance", "maintainability", "correctness", "all"]>;
+        /** Confidence score (0-1) - INV-REV-002 */
+        confidence: z.ZodNumber;
+        /** Category tag */
+        category: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        severity: "critical" | "suggestion" | "warning" | "note";
+        category: string;
+        title: string;
+        confidence: number;
+        focus: "performance" | "architecture" | "all" | "security" | "maintainability" | "correctness";
+        commentId: string;
+        file: string;
+        line: number;
+        body: string;
+        suggestion?: string | undefined;
+        lineEnd?: number | undefined;
+        rationale?: string | undefined;
+        suggestedCode?: string | undefined;
+    }, {
+        severity: "critical" | "suggestion" | "warning" | "note";
+        category: string;
+        title: string;
+        confidence: number;
+        focus: "performance" | "architecture" | "all" | "security" | "maintainability" | "correctness";
+        commentId: string;
+        file: string;
+        line: number;
+        body: string;
+        suggestion?: string | undefined;
+        lineEnd?: number | undefined;
+        rationale?: string | undefined;
+        suggestedCode?: string | undefined;
+    }>, "many">;
+    /** Summary statistics */
+    summary: z.ZodObject<{
+        /** Total comments by severity */
+        bySeverity: z.ZodObject<{
+            critical: z.ZodNumber;
+            warning: z.ZodNumber;
+            suggestion: z.ZodNumber;
+            note: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            critical: number;
+            suggestion: number;
+            warning: number;
+            note: number;
+        }, {
+            critical: number;
+            suggestion: number;
+            warning: number;
+            note: number;
+        }>;
+        /** Total comments by focus */
+        byFocus: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        /** Files with most issues */
+        hotspots: z.ZodArray<z.ZodObject<{
+            file: z.ZodString;
+            commentCount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            file: string;
+            commentCount: number;
+        }, {
+            file: string;
+            commentCount: number;
+        }>, "many">;
+        /** Overall health score (0-100) - Calculated per INV-REV-OUT-002 */
+        healthScore: z.ZodNumber;
+        /** One-line verdict */
+        verdict: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        bySeverity: {
+            critical: number;
+            suggestion: number;
+            warning: number;
+            note: number;
+        };
+        byFocus: Record<string, number>;
+        hotspots: {
+            file: string;
+            commentCount: number;
+        }[];
+        healthScore: number;
+        verdict: string;
+    }, {
+        bySeverity: {
+            critical: number;
+            suggestion: number;
+            warning: number;
+            note: number;
+        };
+        byFocus: Record<string, number>;
+        hotspots: {
+            file: string;
+            commentCount: number;
+        }[];
+        healthScore: number;
+        verdict: string;
+    }>;
+    /** Files that were reviewed */
+    filesReviewed: z.ZodArray<z.ZodString, "many">;
+    /** Total lines analyzed */
+    linesAnalyzed: z.ZodNumber;
+    /** Provider used */
+    providerId: z.ZodString;
+    /** Model used */
+    modelId: z.ZodString;
+    /** Duration in milliseconds */
+    durationMs: z.ZodNumber;
+    /** Completion timestamp */
+    completedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    summary: {
+        bySeverity: {
+            critical: number;
+            suggestion: number;
+            warning: number;
+            note: number;
+        };
+        byFocus: Record<string, number>;
+        hotspots: {
+            file: string;
+            commentCount: number;
+        }[];
+        healthScore: number;
+        verdict: string;
+    };
+    durationMs: number;
+    requestId: string;
+    completedAt: string;
+    providerId: string;
+    resultId: string;
+    comments: {
+        severity: "critical" | "suggestion" | "warning" | "note";
+        category: string;
+        title: string;
+        confidence: number;
+        focus: "performance" | "architecture" | "all" | "security" | "maintainability" | "correctness";
+        commentId: string;
+        file: string;
+        line: number;
+        body: string;
+        suggestion?: string | undefined;
+        lineEnd?: number | undefined;
+        rationale?: string | undefined;
+        suggestedCode?: string | undefined;
+    }[];
+    filesReviewed: string[];
+    linesAnalyzed: number;
+    modelId: string;
+}, {
+    summary: {
+        bySeverity: {
+            critical: number;
+            suggestion: number;
+            warning: number;
+            note: number;
+        };
+        byFocus: Record<string, number>;
+        hotspots: {
+            file: string;
+            commentCount: number;
+        }[];
+        healthScore: number;
+        verdict: string;
+    };
+    durationMs: number;
+    requestId: string;
+    completedAt: string;
+    providerId: string;
+    resultId: string;
+    comments: {
+        severity: "critical" | "suggestion" | "warning" | "note";
+        category: string;
+        title: string;
+        confidence: number;
+        focus: "performance" | "architecture" | "all" | "security" | "maintainability" | "correctness";
+        commentId: string;
+        file: string;
+        line: number;
+        body: string;
+        suggestion?: string | undefined;
+        lineEnd?: number | undefined;
+        rationale?: string | undefined;
+        suggestedCode?: string | undefined;
+    }[];
+    filesReviewed: string[];
+    linesAnalyzed: number;
+    modelId: string;
+}>;
+export type ReviewResult = z.infer<typeof ReviewResultSchema>;
+/**
+ * SARIF 2.1.0 compliant rule schema
+ */
+export declare const SarifRuleSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    shortDescription: z.ZodOptional<z.ZodObject<{
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+    }, {
+        text: string;
+    }>>;
+    fullDescription: z.ZodOptional<z.ZodObject<{
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+    }, {
+        text: string;
+    }>>;
+    defaultConfiguration: z.ZodOptional<z.ZodObject<{
+        level: z.ZodOptional<z.ZodEnum<["error", "warning", "note", "none"]>>;
+    }, "strip", z.ZodTypeAny, {
+        level?: "error" | "none" | "warning" | "note" | undefined;
+    }, {
+        level?: "error" | "none" | "warning" | "note" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name?: string | undefined;
+    shortDescription?: {
+        text: string;
+    } | undefined;
+    fullDescription?: {
+        text: string;
+    } | undefined;
+    defaultConfiguration?: {
+        level?: "error" | "none" | "warning" | "note" | undefined;
+    } | undefined;
+}, {
+    id: string;
+    name?: string | undefined;
+    shortDescription?: {
+        text: string;
+    } | undefined;
+    fullDescription?: {
+        text: string;
+    } | undefined;
+    defaultConfiguration?: {
+        level?: "error" | "none" | "warning" | "note" | undefined;
+    } | undefined;
+}>;
+export type SarifRule = z.infer<typeof SarifRuleSchema>;
+/**
+ * SARIF 2.1.0 compliant result location schema
+ */
+export declare const SarifLocationSchema: z.ZodObject<{
+    physicalLocation: z.ZodObject<{
+        artifactLocation: z.ZodObject<{
+            uri: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            uri: string;
+        }, {
+            uri: string;
+        }>;
+        region: z.ZodOptional<z.ZodObject<{
+            startLine: z.ZodNumber;
+            endLine: z.ZodOptional<z.ZodNumber>;
+            startColumn: z.ZodOptional<z.ZodNumber>;
+            endColumn: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            startLine: number;
+            endLine?: number | undefined;
+            startColumn?: number | undefined;
+            endColumn?: number | undefined;
+        }, {
+            startLine: number;
+            endLine?: number | undefined;
+            startColumn?: number | undefined;
+            endColumn?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        artifactLocation: {
+            uri: string;
+        };
+        region?: {
+            startLine: number;
+            endLine?: number | undefined;
+            startColumn?: number | undefined;
+            endColumn?: number | undefined;
+        } | undefined;
+    }, {
+        artifactLocation: {
+            uri: string;
+        };
+        region?: {
+            startLine: number;
+            endLine?: number | undefined;
+            startColumn?: number | undefined;
+            endColumn?: number | undefined;
+        } | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    physicalLocation: {
+        artifactLocation: {
+            uri: string;
+        };
+        region?: {
+            startLine: number;
+            endLine?: number | undefined;
+            startColumn?: number | undefined;
+            endColumn?: number | undefined;
+        } | undefined;
+    };
+}, {
+    physicalLocation: {
+        artifactLocation: {
+            uri: string;
+        };
+        region?: {
+            startLine: number;
+            endLine?: number | undefined;
+            startColumn?: number | undefined;
+            endColumn?: number | undefined;
+        } | undefined;
+    };
+}>;
+export type SarifLocation = z.infer<typeof SarifLocationSchema>;
+/**
+ * SARIF 2.1.0 compliant result schema
+ */
+export declare const SarifResultSchema: z.ZodObject<{
+    ruleId: z.ZodString;
+    level: z.ZodEnum<["error", "warning", "note", "none"]>;
+    message: z.ZodObject<{
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+    }, {
+        text: string;
+    }>;
+    locations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        physicalLocation: z.ZodObject<{
+            artifactLocation: z.ZodObject<{
+                uri: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                uri: string;
+            }, {
+                uri: string;
+            }>;
+            region: z.ZodOptional<z.ZodObject<{
+                startLine: z.ZodNumber;
+                endLine: z.ZodOptional<z.ZodNumber>;
+                startColumn: z.ZodOptional<z.ZodNumber>;
+                endColumn: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                startLine: number;
+                endLine?: number | undefined;
+                startColumn?: number | undefined;
+                endColumn?: number | undefined;
+            }, {
+                startLine: number;
+                endLine?: number | undefined;
+                startColumn?: number | undefined;
+                endColumn?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            artifactLocation: {
+                uri: string;
+            };
+            region?: {
+                startLine: number;
+                endLine?: number | undefined;
+                startColumn?: number | undefined;
+                endColumn?: number | undefined;
+            } | undefined;
+        }, {
+            artifactLocation: {
+                uri: string;
+            };
+            region?: {
+                startLine: number;
+                endLine?: number | undefined;
+                startColumn?: number | undefined;
+                endColumn?: number | undefined;
+            } | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        physicalLocation: {
+            artifactLocation: {
+                uri: string;
+            };
+            region?: {
+                startLine: number;
+                endLine?: number | undefined;
+                startColumn?: number | undefined;
+                endColumn?: number | undefined;
+            } | undefined;
+        };
+    }, {
+        physicalLocation: {
+            artifactLocation: {
+                uri: string;
+            };
+            region?: {
+                startLine: number;
+                endLine?: number | undefined;
+                startColumn?: number | undefined;
+                endColumn?: number | undefined;
+            } | undefined;
+        };
+    }>, "many">>;
+    fixes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        description: z.ZodObject<{
+            text: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            text: string;
+        }, {
+            text: string;
+        }>;
+        artifactChanges: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        description: {
+            text: string;
+        };
+        artifactChanges?: unknown[] | undefined;
+    }, {
+        description: {
+            text: string;
+        };
+        artifactChanges?: unknown[] | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    message: {
+        text: string;
+    };
+    level: "error" | "none" | "warning" | "note";
+    ruleId: string;
+    locations?: {
+        physicalLocation: {
+            artifactLocation: {
+                uri: string;
+            };
+            region?: {
+                startLine: number;
+                endLine?: number | undefined;
+                startColumn?: number | undefined;
+                endColumn?: number | undefined;
+            } | undefined;
+        };
+    }[] | undefined;
+    fixes?: {
+        description: {
+            text: string;
+        };
+        artifactChanges?: unknown[] | undefined;
+    }[] | undefined;
+}, {
+    message: {
+        text: string;
+    };
+    level: "error" | "none" | "warning" | "note";
+    ruleId: string;
+    locations?: {
+        physicalLocation: {
+            artifactLocation: {
+                uri: string;
+            };
+            region?: {
+                startLine: number;
+                endLine?: number | undefined;
+                startColumn?: number | undefined;
+                endColumn?: number | undefined;
+            } | undefined;
+        };
+    }[] | undefined;
+    fixes?: {
+        description: {
+            text: string;
+        };
+        artifactChanges?: unknown[] | undefined;
+    }[] | undefined;
+}>;
+export type SarifResult = z.infer<typeof SarifResultSchema>;
+/**
+ * SARIF 2.1.0 compliant output schema
+ * INV-REV-OUT-003: MUST comply with SARIF 2.1.0 schema
+ */
+export declare const SarifOutputSchema: z.ZodObject<{
+    $schema: z.ZodLiteral<"https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json">;
+    version: z.ZodLiteral<"2.1.0">;
+    runs: z.ZodArray<z.ZodObject<{
+        tool: z.ZodObject<{
+            driver: z.ZodObject<{
+                name: z.ZodString;
+                version: z.ZodString;
+                informationUri: z.ZodOptional<z.ZodString>;
+                rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    name: z.ZodOptional<z.ZodString>;
+                    shortDescription: z.ZodOptional<z.ZodObject<{
+                        text: z.ZodString;
+                    }, "strip", z.ZodTypeAny, {
+                        text: string;
+                    }, {
+                        text: string;
+                    }>>;
+                    fullDescription: z.ZodOptional<z.ZodObject<{
+                        text: z.ZodString;
+                    }, "strip", z.ZodTypeAny, {
+                        text: string;
+                    }, {
+                        text: string;
+                    }>>;
+                    defaultConfiguration: z.ZodOptional<z.ZodObject<{
+                        level: z.ZodOptional<z.ZodEnum<["error", "warning", "note", "none"]>>;
+                    }, "strip", z.ZodTypeAny, {
+                        level?: "error" | "none" | "warning" | "note" | undefined;
+                    }, {
+                        level?: "error" | "none" | "warning" | "note" | undefined;
+                    }>>;
+                }, "strip", z.ZodTypeAny, {
+                    id: string;
+                    name?: string | undefined;
+                    shortDescription?: {
+                        text: string;
+                    } | undefined;
+                    fullDescription?: {
+                        text: string;
+                    } | undefined;
+                    defaultConfiguration?: {
+                        level?: "error" | "none" | "warning" | "note" | undefined;
+                    } | undefined;
+                }, {
+                    id: string;
+                    name?: string | undefined;
+                    shortDescription?: {
+                        text: string;
+                    } | undefined;
+                    fullDescription?: {
+                        text: string;
+                    } | undefined;
+                    defaultConfiguration?: {
+                        level?: "error" | "none" | "warning" | "note" | undefined;
+                    } | undefined;
+                }>, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                version: string;
+                informationUri?: string | undefined;
+                rules?: {
+                    id: string;
+                    name?: string | undefined;
+                    shortDescription?: {
+                        text: string;
+                    } | undefined;
+                    fullDescription?: {
+                        text: string;
+                    } | undefined;
+                    defaultConfiguration?: {
+                        level?: "error" | "none" | "warning" | "note" | undefined;
+                    } | undefined;
+                }[] | undefined;
+            }, {
+                name: string;
+                version: string;
+                informationUri?: string | undefined;
+                rules?: {
+                    id: string;
+                    name?: string | undefined;
+                    shortDescription?: {
+                        text: string;
+                    } | undefined;
+                    fullDescription?: {
+                        text: string;
+                    } | undefined;
+                    defaultConfiguration?: {
+                        level?: "error" | "none" | "warning" | "note" | undefined;
+                    } | undefined;
+                }[] | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            driver: {
+                name: string;
+                version: string;
+                informationUri?: string | undefined;
+                rules?: {
+                    id: string;
+                    name?: string | undefined;
+                    shortDescription?: {
+                        text: string;
+                    } | undefined;
+                    fullDescription?: {
+                        text: string;
+                    } | undefined;
+                    defaultConfiguration?: {
+                        level?: "error" | "none" | "warning" | "note" | undefined;
+                    } | undefined;
+                }[] | undefined;
+            };
+        }, {
+            driver: {
+                name: string;
+                version: string;
+                informationUri?: string | undefined;
+                rules?: {
+                    id: string;
+                    name?: string | undefined;
+                    shortDescription?: {
+                        text: string;
+                    } | undefined;
+                    fullDescription?: {
+                        text: string;
+                    } | undefined;
+                    defaultConfiguration?: {
+                        level?: "error" | "none" | "warning" | "note" | undefined;
+                    } | undefined;
+                }[] | undefined;
+            };
+        }>;
+        results: z.ZodArray<z.ZodObject<{
+            ruleId: z.ZodString;
+            level: z.ZodEnum<["error", "warning", "note", "none"]>;
+            message: z.ZodObject<{
+                text: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                text: string;
+            }, {
+                text: string;
+            }>;
+            locations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                physicalLocation: z.ZodObject<{
+                    artifactLocation: z.ZodObject<{
+                        uri: z.ZodString;
+                    }, "strip", z.ZodTypeAny, {
+                        uri: string;
+                    }, {
+                        uri: string;
+                    }>;
+                    region: z.ZodOptional<z.ZodObject<{
+                        startLine: z.ZodNumber;
+                        endLine: z.ZodOptional<z.ZodNumber>;
+                        startColumn: z.ZodOptional<z.ZodNumber>;
+                        endColumn: z.ZodOptional<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        startLine: number;
+                        endLine?: number | undefined;
+                        startColumn?: number | undefined;
+                        endColumn?: number | undefined;
+                    }, {
+                        startLine: number;
+                        endLine?: number | undefined;
+                        startColumn?: number | undefined;
+                        endColumn?: number | undefined;
+                    }>>;
+                }, "strip", z.ZodTypeAny, {
+                    artifactLocation: {
+                        uri: string;
+                    };
+                    region?: {
+                        startLine: number;
+                        endLine?: number | undefined;
+                        startColumn?: number | undefined;
+                        endColumn?: number | undefined;
+                    } | undefined;
+                }, {
+                    artifactLocation: {
+                        uri: string;
+                    };
+                    region?: {
+                        startLine: number;
+                        endLine?: number | undefined;
+                        startColumn?: number | undefined;
+                        endColumn?: number | undefined;
+                    } | undefined;
+                }>;
+            }, "strip", z.ZodTypeAny, {
+                physicalLocation: {
+                    artifactLocation: {
+                        uri: string;
+                    };
+                    region?: {
+                        startLine: number;
+                        endLine?: number | undefined;
+                        startColumn?: number | undefined;
+                        endColumn?: number | undefined;
+                    } | undefined;
+                };
+            }, {
+                physicalLocation: {
+                    artifactLocation: {
+                        uri: string;
+                    };
+                    region?: {
+                        startLine: number;
+                        endLine?: number | undefined;
+                        startColumn?: number | undefined;
+                        endColumn?: number | undefined;
+                    } | undefined;
+                };
+            }>, "many">>;
+            fixes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                description: z.ZodObject<{
+                    text: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    text: string;
+                }, {
+                    text: string;
+                }>;
+                artifactChanges: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                description: {
+                    text: string;
+                };
+                artifactChanges?: unknown[] | undefined;
+            }, {
+                description: {
+                    text: string;
+                };
+                artifactChanges?: unknown[] | undefined;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            message: {
+                text: string;
+            };
+            level: "error" | "none" | "warning" | "note";
+            ruleId: string;
+            locations?: {
+                physicalLocation: {
+                    artifactLocation: {
+                        uri: string;
+                    };
+                    region?: {
+                        startLine: number;
+                        endLine?: number | undefined;
+                        startColumn?: number | undefined;
+                        endColumn?: number | undefined;
+                    } | undefined;
+                };
+            }[] | undefined;
+            fixes?: {
+                description: {
+                    text: string;
+                };
+                artifactChanges?: unknown[] | undefined;
+            }[] | undefined;
+        }, {
+            message: {
+                text: string;
+            };
+            level: "error" | "none" | "warning" | "note";
+            ruleId: string;
+            locations?: {
+                physicalLocation: {
+                    artifactLocation: {
+                        uri: string;
+                    };
+                    region?: {
+                        startLine: number;
+                        endLine?: number | undefined;
+                        startColumn?: number | undefined;
+                        endColumn?: number | undefined;
+                    } | undefined;
+                };
+            }[] | undefined;
+            fixes?: {
+                description: {
+                    text: string;
+                };
+                artifactChanges?: unknown[] | undefined;
+            }[] | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        tool: {
+            driver: {
+                name: string;
+                version: string;
+                informationUri?: string | undefined;
+                rules?: {
+                    id: string;
+                    name?: string | undefined;
+                    shortDescription?: {
+                        text: string;
+                    } | undefined;
+                    fullDescription?: {
+                        text: string;
+                    } | undefined;
+                    defaultConfiguration?: {
+                        level?: "error" | "none" | "warning" | "note" | undefined;
+                    } | undefined;
+                }[] | undefined;
+            };
+        };
+        results: {
+            message: {
+                text: string;
+            };
+            level: "error" | "none" | "warning" | "note";
+            ruleId: string;
+            locations?: {
+                physicalLocation: {
+                    artifactLocation: {
+                        uri: string;
+                    };
+                    region?: {
+                        startLine: number;
+                        endLine?: number | undefined;
+                        startColumn?: number | undefined;
+                        endColumn?: number | undefined;
+                    } | undefined;
+                };
+            }[] | undefined;
+            fixes?: {
+                description: {
+                    text: string;
+                };
+                artifactChanges?: unknown[] | undefined;
+            }[] | undefined;
+        }[];
+    }, {
+        tool: {
+            driver: {
+                name: string;
+                version: string;
+                informationUri?: string | undefined;
+                rules?: {
+                    id: string;
+                    name?: string | undefined;
+                    shortDescription?: {
+                        text: string;
+                    } | undefined;
+                    fullDescription?: {
+                        text: string;
+                    } | undefined;
+                    defaultConfiguration?: {
+                        level?: "error" | "none" | "warning" | "note" | undefined;
+                    } | undefined;
+                }[] | undefined;
+            };
+        };
+        results: {
+            message: {
+                text: string;
+            };
+            level: "error" | "none" | "warning" | "note";
+            ruleId: string;
+            locations?: {
+                physicalLocation: {
+                    artifactLocation: {
+                        uri: string;
+                    };
+                    region?: {
+                        startLine: number;
+                        endLine?: number | undefined;
+                        startColumn?: number | undefined;
+                        endColumn?: number | undefined;
+                    } | undefined;
+                };
+            }[] | undefined;
+            fixes?: {
+                description: {
+                    text: string;
+                };
+                artifactChanges?: unknown[] | undefined;
+            }[] | undefined;
+        }[];
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    version: "2.1.0";
+    $schema: "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json";
+    runs: {
+        tool: {
+            driver: {
+                name: string;
+                version: string;
+                informationUri?: string | undefined;
+                rules?: {
+                    id: string;
+                    name?: string | undefined;
+                    shortDescription?: {
+                        text: string;
+                    } | undefined;
+                    fullDescription?: {
+                        text: string;
+                    } | undefined;
+                    defaultConfiguration?: {
+                        level?: "error" | "none" | "warning" | "note" | undefined;
+                    } | undefined;
+                }[] | undefined;
+            };
+        };
+        results: {
+            message: {
+                text: string;
+            };
+            level: "error" | "none" | "warning" | "note";
+            ruleId: string;
+            locations?: {
+                physicalLocation: {
+                    artifactLocation: {
+                        uri: string;
+                    };
+                    region?: {
+                        startLine: number;
+                        endLine?: number | undefined;
+                        startColumn?: number | undefined;
+                        endColumn?: number | undefined;
+                    } | undefined;
+                };
+            }[] | undefined;
+            fixes?: {
+                description: {
+                    text: string;
+                };
+                artifactChanges?: unknown[] | undefined;
+            }[] | undefined;
+        }[];
+    }[];
+}, {
+    version: "2.1.0";
+    $schema: "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json";
+    runs: {
+        tool: {
+            driver: {
+                name: string;
+                version: string;
+                informationUri?: string | undefined;
+                rules?: {
+                    id: string;
+                    name?: string | undefined;
+                    shortDescription?: {
+                        text: string;
+                    } | undefined;
+                    fullDescription?: {
+                        text: string;
+                    } | undefined;
+                    defaultConfiguration?: {
+                        level?: "error" | "none" | "warning" | "note" | undefined;
+                    } | undefined;
+                }[] | undefined;
+            };
+        };
+        results: {
+            message: {
+                text: string;
+            };
+            level: "error" | "none" | "warning" | "note";
+            ruleId: string;
+            locations?: {
+                physicalLocation: {
+                    artifactLocation: {
+                        uri: string;
+                    };
+                    region?: {
+                        startLine: number;
+                        endLine?: number | undefined;
+                        startColumn?: number | undefined;
+                        endColumn?: number | undefined;
+                    } | undefined;
+                };
+            }[] | undefined;
+            fixes?: {
+                description: {
+                    text: string;
+                };
+                artifactChanges?: unknown[] | undefined;
+            }[] | undefined;
+        }[];
+    }[];
+}>;
+export type SarifOutput = z.infer<typeof SarifOutputSchema>;
+export declare const ReviewErrorCode: {
+    readonly INVALID_INPUT: "INVALID_INPUT";
+    readonly REVIEW_FAILED: "REVIEW_FAILED";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly PROVIDER_UNAVAILABLE: "PROVIDER_UNAVAILABLE";
+    readonly FILE_NOT_FOUND: "FILE_NOT_FOUND";
+    readonly PARSE_ERROR: "PARSE_ERROR";
+    readonly INVALID_PATH: "INVALID_PATH";
+    readonly NO_FILES_FOUND: "NO_FILES_FOUND";
+};
+export type ReviewErrorCode = (typeof ReviewErrorCode)[keyof typeof ReviewErrorCode];
+/**
+ * Validates a review request
+ */
+export declare function validateReviewRequest(data: unknown): ReviewRequest;
+/**
+ * Safe validation for review request
+ */
+export declare function safeValidateReviewRequest(data: unknown): {
+    success: true;
+    data: ReviewRequest;
+} | {
+    success: false;
+    error: z.ZodError;
+};
+/**
+ * Validates a review result
+ */
+export declare function validateReviewResult(data: unknown): ReviewResult;
+/**
+ * Safe validation for review result
+ */
+export declare function safeValidateReviewResult(data: unknown): {
+    success: true;
+    data: ReviewResult;
+} | {
+    success: false;
+    error: z.ZodError;
+};
+/**
+ * Validates a review comment
+ */
+export declare function validateReviewComment(data: unknown): ReviewComment;
+/**
+ * Validates SARIF output
+ */
+export declare function validateSarifOutput(data: unknown): SarifOutput;
+/**
+ * Calculate health score from severity counts
+ * Formula: 100 - (critical*25 + warning*10 + suggestion*2)
+ * Clamped to 0-100 range
+ * INV-REV-OUT-002: Health score MUST reflect weighted severity counts
+ */
+export declare function calculateHealthScore(critical: number, warning: number, suggestion: number): number;
+/**
+ * Severity ordering for sorting comments
+ * INV-REV-OUT-001: Comments MUST be ordered by severity (critical first)
+ */
+export declare const SEVERITY_ORDER: Record<ReviewCommentSeverity, number>;
+/**
+ * Compare function for sorting comments by severity
+ * Primary: severity (critical first)
+ * Secondary: confidence (descending)
+ * Tertiary: file path (alphabetical)
+ */
+export declare function compareCommentsBySeverity(a: ReviewComment, b: ReviewComment): number;
+/**
+ * Sort comments according to INV-REV-OUT-001
+ */
+export declare function sortCommentsBySeverity(comments: ReviewComment[]): ReviewComment[];
+/**
+ * Creates an empty review summary
+ */
+export declare function createEmptyReviewSummary(): ReviewSummary;
+/**
+ * Creates a review summary from comments
+ */
+export declare function createReviewSummary(comments: ReviewComment[]): ReviewSummary;
+//# sourceMappingURL=schema.d.ts.map