@kynetic-ai/spec 0.11.0 → 0.12.0

package/dist/schema/review-records.d.ts

@@ -0,0 +1,2676 @@
+import { z } from "zod";
+export declare const ReviewLifecycleStateSchema: z.ZodEnum<["draft", "open", "closed", "archived"]>;
+export declare const ReviewDispositionSchema: z.ZodEnum<["pending", "approved", "changes_requested"]>;
+export declare const ReviewGateStateSchema: z.ZodEnum<["passing", "failing", "pending"]>;
+export declare const ReviewCodeSubjectSchema: z.ZodObject<{
+    type: z.ZodLiteral<"code">;
+    base_commit: z.ZodString;
+    head_commit: z.ZodString;
+    merge_base_commit: z.ZodOptional<z.ZodString>;
+    base_branch: z.ZodOptional<z.ZodString>;
+    head_branch: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "code";
+    base_commit: string;
+    head_commit: string;
+    merge_base_commit?: string | undefined;
+    base_branch?: string | undefined;
+    head_branch?: string | undefined;
+}, {
+    type: "code";
+    base_commit: string;
+    head_commit: string;
+    merge_base_commit?: string | undefined;
+    base_branch?: string | undefined;
+    head_branch?: string | undefined;
+}>;
+export declare const ReviewPlanSubjectSchema: z.ZodObject<{
+    type: z.ZodLiteral<"plan">;
+    ref: z.ZodString;
+    shadow_commit: z.ZodString;
+    content_hash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "plan";
+    ref: string;
+    shadow_commit: string;
+    content_hash: string;
+}, {
+    type: "plan";
+    ref: string;
+    shadow_commit: string;
+    content_hash: string;
+}>;
+export declare const ReviewTaskSubjectSchema: z.ZodObject<{
+    type: z.ZodLiteral<"task">;
+    ref: z.ZodString;
+    shadow_commit: z.ZodString;
+    content_hash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "task";
+    ref: string;
+    shadow_commit: string;
+    content_hash: string;
+}, {
+    type: "task";
+    ref: string;
+    shadow_commit: string;
+    content_hash: string;
+}>;
+export declare const ReviewSpecSubjectSchema: z.ZodObject<{
+    type: z.ZodLiteral<"spec">;
+    ref: z.ZodString;
+    shadow_commit: z.ZodString;
+    content_hash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "spec";
+    ref: string;
+    shadow_commit: string;
+    content_hash: string;
+}, {
+    type: "spec";
+    ref: string;
+    shadow_commit: string;
+    content_hash: string;
+}>;
+export declare const ReviewExternalSubjectSchema: z.ZodObject<{
+    type: z.ZodLiteral<"external">;
+    url: z.ZodString;
+    external_id: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "external";
+    url: string;
+    external_id?: string | undefined;
+    provider?: string | undefined;
+}, {
+    type: "external";
+    url: string;
+    external_id?: string | undefined;
+    provider?: string | undefined;
+}>;
+export declare const ReviewSubjectSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"code">;
+    base_commit: z.ZodString;
+    head_commit: z.ZodString;
+    merge_base_commit: z.ZodOptional<z.ZodString>;
+    base_branch: z.ZodOptional<z.ZodString>;
+    head_branch: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "code";
+    base_commit: string;
+    head_commit: string;
+    merge_base_commit?: string | undefined;
+    base_branch?: string | undefined;
+    head_branch?: string | undefined;
+}, {
+    type: "code";
+    base_commit: string;
+    head_commit: string;
+    merge_base_commit?: string | undefined;
+    base_branch?: string | undefined;
+    head_branch?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"plan">;
+    ref: z.ZodString;
+    shadow_commit: z.ZodString;
+    content_hash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "plan";
+    ref: string;
+    shadow_commit: string;
+    content_hash: string;
+}, {
+    type: "plan";
+    ref: string;
+    shadow_commit: string;
+    content_hash: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"task">;
+    ref: z.ZodString;
+    shadow_commit: z.ZodString;
+    content_hash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "task";
+    ref: string;
+    shadow_commit: string;
+    content_hash: string;
+}, {
+    type: "task";
+    ref: string;
+    shadow_commit: string;
+    content_hash: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"spec">;
+    ref: z.ZodString;
+    shadow_commit: z.ZodString;
+    content_hash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "spec";
+    ref: string;
+    shadow_commit: string;
+    content_hash: string;
+}, {
+    type: "spec";
+    ref: string;
+    shadow_commit: string;
+    content_hash: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"external">;
+    url: z.ZodString;
+    external_id: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "external";
+    url: string;
+    external_id?: string | undefined;
+    provider?: string | undefined;
+}, {
+    type: "external";
+    url: string;
+    external_id?: string | undefined;
+    provider?: string | undefined;
+}>]>;
+export declare const ReviewCodeCompareVersionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"code_compare">;
+    base_commit: z.ZodString;
+    head_commit: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "code_compare";
+    base_commit: string;
+    head_commit: string;
+}, {
+    type: "code_compare";
+    base_commit: string;
+    head_commit: string;
+}>;
+export declare const ReviewEntityVersionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"entity_version">;
+    content_hash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "entity_version";
+    content_hash: string;
+}, {
+    type: "entity_version";
+    content_hash: string;
+}>;
+export declare const ReviewSubjectVersionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"code_compare">;
+    base_commit: z.ZodString;
+    head_commit: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "code_compare";
+    base_commit: string;
+    head_commit: string;
+}, {
+    type: "code_compare";
+    base_commit: string;
+    head_commit: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"entity_version">;
+    content_hash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "entity_version";
+    content_hash: string;
+}, {
+    type: "entity_version";
+    content_hash: string;
+}>]>;
+export declare const ReviewCodeAnchorSchema: z.ZodObject<{
+    type: z.ZodLiteral<"code">;
+    path: z.ZodString;
+    side: z.ZodEnum<["base", "head"]>;
+    line_start: z.ZodNumber;
+    line_end: z.ZodNumber;
+    commit: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    type: "code";
+    commit: string;
+    side: "head" | "base";
+    line_start: number;
+    line_end: number;
+}, {
+    path: string;
+    type: "code";
+    commit: string;
+    side: "head" | "base";
+    line_start: number;
+    line_end: number;
+}>;
+export declare const ReviewStructuredAnchorSchema: z.ZodObject<{
+    type: z.ZodLiteral<"structured">;
+    section: z.ZodOptional<z.ZodString>;
+    field: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "structured";
+    path?: string | undefined;
+    ref?: string | undefined;
+    section?: string | undefined;
+    field?: string | undefined;
+}, {
+    type: "structured";
+    path?: string | undefined;
+    ref?: string | undefined;
+    section?: string | undefined;
+    field?: string | undefined;
+}>;
+export declare const ReviewAnchorSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"code">;
+    path: z.ZodString;
+    side: z.ZodEnum<["base", "head"]>;
+    line_start: z.ZodNumber;
+    line_end: z.ZodNumber;
+    commit: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    type: "code";
+    commit: string;
+    side: "head" | "base";
+    line_start: number;
+    line_end: number;
+}, {
+    path: string;
+    type: "code";
+    commit: string;
+    side: "head" | "base";
+    line_start: number;
+    line_end: number;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"structured">;
+    section: z.ZodOptional<z.ZodString>;
+    field: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "structured";
+    path?: string | undefined;
+    ref?: string | undefined;
+    section?: string | undefined;
+    field?: string | undefined;
+}, {
+    type: "structured";
+    path?: string | undefined;
+    ref?: string | undefined;
+    section?: string | undefined;
+    field?: string | undefined;
+}>]>;
+export declare const ReviewThreadKindSchema: z.ZodEnum<["blocker", "question", "nit"]>;
+export declare const ReviewThreadEntrySchema: z.ZodObject<{
+    _ulid: z.ZodString;
+    author: z.ZodString;
+    body: z.ZodString;
+    created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
+}, "strip", z.ZodTypeAny, {
+    created_at: string;
+    _ulid: string;
+    author: string;
+    body: string;
+}, {
+    created_at: string;
+    _ulid: string;
+    author: string;
+    body: string;
+}>;
+export declare const ReviewThreadSchema: z.ZodObject<{
+    _ulid: z.ZodString;
+    kind: z.ZodDefault<z.ZodEnum<["blocker", "question", "nit"]>>;
+    anchor: z.ZodOptional<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"code">;
+        path: z.ZodString;
+        side: z.ZodEnum<["base", "head"]>;
+        line_start: z.ZodNumber;
+        line_end: z.ZodNumber;
+        commit: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        type: "code";
+        commit: string;
+        side: "head" | "base";
+        line_start: number;
+        line_end: number;
+    }, {
+        path: string;
+        type: "code";
+        commit: string;
+        side: "head" | "base";
+        line_start: number;
+        line_end: number;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"structured">;
+        section: z.ZodOptional<z.ZodString>;
+        field: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        ref: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "structured";
+        path?: string | undefined;
+        ref?: string | undefined;
+        section?: string | undefined;
+        field?: string | undefined;
+    }, {
+        type: "structured";
+        path?: string | undefined;
+        ref?: string | undefined;
+        section?: string | undefined;
+        field?: string | undefined;
+    }>]>>;
+    entries: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        _ulid: z.ZodString;
+        author: z.ZodString;
+        body: z.ZodString;
+        created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    }, "strip", z.ZodTypeAny, {
+        created_at: string;
+        _ulid: string;
+        author: string;
+        body: string;
+    }, {
+        created_at: string;
+        _ulid: string;
+        author: string;
+        body: string;
+    }>, "many">>;
+    resolved_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+    resolved_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    entries: {
+        created_at: string;
+        _ulid: string;
+        author: string;
+        body: string;
+    }[];
+    _ulid: string;
+    kind: "question" | "blocker" | "nit";
+    anchor?: {
+        path: string;
+        type: "code";
+        commit: string;
+        side: "head" | "base";
+        line_start: number;
+        line_end: number;
+    } | {
+        type: "structured";
+        path?: string | undefined;
+        ref?: string | undefined;
+        section?: string | undefined;
+        field?: string | undefined;
+    } | undefined;
+    resolved_at?: string | null | undefined;
+    resolved_by?: string | null | undefined;
+}, {
+    _ulid: string;
+    anchor?: {
+        path: string;
+        type: "code";
+        commit: string;
+        side: "head" | "base";
+        line_start: number;
+        line_end: number;
+    } | {
+        type: "structured";
+        path?: string | undefined;
+        ref?: string | undefined;
+        section?: string | undefined;
+        field?: string | undefined;
+    } | undefined;
+    entries?: {
+        created_at: string;
+        _ulid: string;
+        author: string;
+        body: string;
+    }[] | undefined;
+    resolved_at?: string | null | undefined;
+    resolved_by?: string | null | undefined;
+    kind?: "question" | "blocker" | "nit" | undefined;
+}>;
+export declare const ReviewCheckStatusSchema: z.ZodEnum<["pass", "fail", "running", "skipped"]>;
+export declare const ReviewCheckSchema: z.ZodObject<{
+    name: z.ZodString;
+    status: z.ZodEnum<["pass", "fail", "running", "skipped"]>;
+    required: z.ZodDefault<z.ZodBoolean>;
+    runner: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodString>;
+    applies_to_version: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"code_compare">;
+        base_commit: z.ZodString;
+        head_commit: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "code_compare";
+        base_commit: string;
+        head_commit: string;
+    }, {
+        type: "code_compare";
+        base_commit: string;
+        head_commit: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"entity_version">;
+        content_hash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "entity_version";
+        content_hash: string;
+    }, {
+        type: "entity_version";
+        content_hash: string;
+    }>]>;
+    created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    completed_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    status: "skipped" | "pass" | "fail" | "running";
+    created_at: string;
+    required: boolean;
+    applies_to_version: {
+        type: "code_compare";
+        base_commit: string;
+        head_commit: string;
+    } | {
+        type: "entity_version";
+        content_hash: string;
+    };
+    completed_at?: string | null | undefined;
+    runner?: string | undefined;
+    evidence?: string | undefined;
+}, {
+    name: string;
+    status: "skipped" | "pass" | "fail" | "running";
+    created_at: string;
+    applies_to_version: {
+        type: "code_compare";
+        base_commit: string;
+        head_commit: string;
+    } | {
+        type: "entity_version";
+        content_hash: string;
+    };
+    required?: boolean | undefined;
+    completed_at?: string | null | undefined;
+    runner?: string | undefined;
+    evidence?: string | undefined;
+}>;
+export declare const ReviewVerdictDecisionSchema: z.ZodEnum<["approve", "request_changes", "comment"]>;
+export declare const ReviewVerdictSchema: z.ZodObject<{
+    reviewer: z.ZodString;
+    role: z.ZodDefault<z.ZodString>;
+    decision: z.ZodEnum<["approve", "request_changes", "comment"]>;
+    applies_to_version: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"code_compare">;
+        base_commit: z.ZodString;
+        head_commit: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "code_compare";
+        base_commit: string;
+        head_commit: string;
+    }, {
+        type: "code_compare";
+        base_commit: string;
+        head_commit: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"entity_version">;
+        content_hash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "entity_version";
+        content_hash: string;
+    }, {
+        type: "entity_version";
+        content_hash: string;
+    }>]>;
+    created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
+}, "strip", z.ZodTypeAny, {
+    decision: "approve" | "request_changes" | "comment";
+    reviewer: string;
+    role: string;
+    created_at: string;
+    applies_to_version: {
+        type: "code_compare";
+        base_commit: string;
+        head_commit: string;
+    } | {
+        type: "entity_version";
+        content_hash: string;
+    };
+}, {
+    decision: "approve" | "request_changes" | "comment";
+    reviewer: string;
+    created_at: string;
+    applies_to_version: {
+        type: "code_compare";
+        base_commit: string;
+        head_commit: string;
+    } | {
+        type: "entity_version";
+        content_hash: string;
+    };
+    role?: string | undefined;
+}>;
+export declare const ReviewEventTypeSchema: z.ZodEnum<["lifecycle_change", "verdict_submitted", "thread_created", "thread_replied", "thread_resolved", "thread_reopened", "check_added", "subject_refreshed"]>;
+export declare const ReviewEventSchema: z.ZodObject<{
+    _ulid: z.ZodString;
+    event_type: z.ZodEnum<["lifecycle_change", "verdict_submitted", "thread_created", "thread_replied", "thread_resolved", "thread_reopened", "check_added", "subject_refreshed"]>;
+    actor: z.ZodString;
+    timestamp: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    payload: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    _ulid: string;
+    event_type: "lifecycle_change" | "verdict_submitted" | "thread_created" | "thread_replied" | "thread_resolved" | "thread_reopened" | "check_added" | "subject_refreshed";
+    actor: string;
+    timestamp: string;
+    payload: Record<string, unknown>;
+}, {
+    _ulid: string;
+    event_type: "lifecycle_change" | "verdict_submitted" | "thread_created" | "thread_replied" | "thread_resolved" | "thread_reopened" | "check_added" | "subject_refreshed";
+    actor: string;
+    timestamp: string;
+    payload?: Record<string, unknown> | undefined;
+}>;
+export declare const ReviewExternalLinkSchema: z.ZodObject<{
+    url: z.ZodString;
+    provider: z.ZodOptional<z.ZodString>;
+    external_id: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    external_id?: string | undefined;
+    provider?: string | undefined;
+    label?: string | undefined;
+}, {
+    url: string;
+    external_id?: string | undefined;
+    provider?: string | undefined;
+    label?: string | undefined;
+}>;
+export declare const ReviewRecordSchema: z.ZodObject<{
+    _ulid: z.ZodString;
+    slugs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    title: z.ZodString;
+    lifecycle_state: z.ZodDefault<z.ZodEnum<["draft", "open", "closed", "archived"]>>;
+    subject: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"code">;
+        base_commit: z.ZodString;
+        head_commit: z.ZodString;
+        merge_base_commit: z.ZodOptional<z.ZodString>;
+        base_branch: z.ZodOptional<z.ZodString>;
+        head_branch: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "code";
+        base_commit: string;
+        head_commit: string;
+        merge_base_commit?: string | undefined;
+        base_branch?: string | undefined;
+        head_branch?: string | undefined;
+    }, {
+        type: "code";
+        base_commit: string;
+        head_commit: string;
+        merge_base_commit?: string | undefined;
+        base_branch?: string | undefined;
+        head_branch?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"plan">;
+        ref: z.ZodString;
+        shadow_commit: z.ZodString;
+        content_hash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "plan";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    }, {
+        type: "plan";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"task">;
+        ref: z.ZodString;
+        shadow_commit: z.ZodString;
+        content_hash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "task";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    }, {
+        type: "task";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"spec">;
+        ref: z.ZodString;
+        shadow_commit: z.ZodString;
+        content_hash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "spec";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    }, {
+        type: "spec";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"external">;
+        url: z.ZodString;
+        external_id: z.ZodOptional<z.ZodString>;
+        provider: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "external";
+        url: string;
+        external_id?: string | undefined;
+        provider?: string | undefined;
+    }, {
+        type: "external";
+        url: string;
+        external_id?: string | undefined;
+        provider?: string | undefined;
+    }>]>;
+    author: z.ZodString;
+    related_refs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    threads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        _ulid: z.ZodString;
+        kind: z.ZodDefault<z.ZodEnum<["blocker", "question", "nit"]>>;
+        anchor: z.ZodOptional<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"code">;
+            path: z.ZodString;
+            side: z.ZodEnum<["base", "head"]>;
+            line_start: z.ZodNumber;
+            line_end: z.ZodNumber;
+            commit: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            type: "code";
+            commit: string;
+            side: "head" | "base";
+            line_start: number;
+            line_end: number;
+        }, {
+            path: string;
+            type: "code";
+            commit: string;
+            side: "head" | "base";
+            line_start: number;
+            line_end: number;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"structured">;
+            section: z.ZodOptional<z.ZodString>;
+            field: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString>;
+            ref: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "structured";
+            path?: string | undefined;
+            ref?: string | undefined;
+            section?: string | undefined;
+            field?: string | undefined;
+        }, {
+            type: "structured";
+            path?: string | undefined;
+            ref?: string | undefined;
+            section?: string | undefined;
+            field?: string | undefined;
+        }>]>>;
+        entries: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            _ulid: z.ZodString;
+            author: z.ZodString;
+            body: z.ZodString;
+            created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
+        }, "strip", z.ZodTypeAny, {
+            created_at: string;
+            _ulid: string;
+            author: string;
+            body: string;
+        }, {
+            created_at: string;
+            _ulid: string;
+            author: string;
+            body: string;
+        }>, "many">>;
+        resolved_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        resolved_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        entries: {
+            created_at: string;
+            _ulid: string;
+            author: string;
+            body: string;
+        }[];
+        _ulid: string;
+        kind: "question" | "blocker" | "nit";
+        anchor?: {
+            path: string;
+            type: "code";
+            commit: string;
+            side: "head" | "base";
+            line_start: number;
+            line_end: number;
+        } | {
+            type: "structured";
+            path?: string | undefined;
+            ref?: string | undefined;
+            section?: string | undefined;
+            field?: string | undefined;
+        } | undefined;
+        resolved_at?: string | null | undefined;
+        resolved_by?: string | null | undefined;
+    }, {
+        _ulid: string;
+        anchor?: {
+            path: string;
+            type: "code";
+            commit: string;
+            side: "head" | "base";
+            line_start: number;
+            line_end: number;
+        } | {
+            type: "structured";
+            path?: string | undefined;
+            ref?: string | undefined;
+            section?: string | undefined;
+            field?: string | undefined;
+        } | undefined;
+        entries?: {
+            created_at: string;
+            _ulid: string;
+            author: string;
+            body: string;
+        }[] | undefined;
+        resolved_at?: string | null | undefined;
+        resolved_by?: string | null | undefined;
+        kind?: "question" | "blocker" | "nit" | undefined;
+    }>, "many">>;
+    checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        status: z.ZodEnum<["pass", "fail", "running", "skipped"]>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        runner: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodOptional<z.ZodString>;
+        applies_to_version: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"code_compare">;
+            base_commit: z.ZodString;
+            head_commit: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        }, {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"entity_version">;
+            content_hash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "entity_version";
+            content_hash: string;
+        }, {
+            type: "entity_version";
+            content_hash: string;
+        }>]>;
+        created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
+        completed_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        status: "skipped" | "pass" | "fail" | "running";
+        created_at: string;
+        required: boolean;
+        applies_to_version: {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        } | {
+            type: "entity_version";
+            content_hash: string;
+        };
+        completed_at?: string | null | undefined;
+        runner?: string | undefined;
+        evidence?: string | undefined;
+    }, {
+        name: string;
+        status: "skipped" | "pass" | "fail" | "running";
+        created_at: string;
+        applies_to_version: {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        } | {
+            type: "entity_version";
+            content_hash: string;
+        };
+        required?: boolean | undefined;
+        completed_at?: string | null | undefined;
+        runner?: string | undefined;
+        evidence?: string | undefined;
+    }>, "many">>;
+    verdicts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        reviewer: z.ZodString;
+        role: z.ZodDefault<z.ZodString>;
+        decision: z.ZodEnum<["approve", "request_changes", "comment"]>;
+        applies_to_version: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"code_compare">;
+            base_commit: z.ZodString;
+            head_commit: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        }, {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"entity_version">;
+            content_hash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "entity_version";
+            content_hash: string;
+        }, {
+            type: "entity_version";
+            content_hash: string;
+        }>]>;
+        created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    }, "strip", z.ZodTypeAny, {
+        decision: "approve" | "request_changes" | "comment";
+        reviewer: string;
+        role: string;
+        created_at: string;
+        applies_to_version: {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        } | {
+            type: "entity_version";
+            content_hash: string;
+        };
+    }, {
+        decision: "approve" | "request_changes" | "comment";
+        reviewer: string;
+        created_at: string;
+        applies_to_version: {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        } | {
+            type: "entity_version";
+            content_hash: string;
+        };
+        role?: string | undefined;
+    }>, "many">>;
+    events: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        _ulid: z.ZodString;
+        event_type: z.ZodEnum<["lifecycle_change", "verdict_submitted", "thread_created", "thread_replied", "thread_resolved", "thread_reopened", "check_added", "subject_refreshed"]>;
+        actor: z.ZodString;
+        timestamp: z.ZodUnion<[z.ZodString, z.ZodString]>;
+        payload: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        _ulid: string;
+        event_type: "lifecycle_change" | "verdict_submitted" | "thread_created" | "thread_replied" | "thread_resolved" | "thread_reopened" | "check_added" | "subject_refreshed";
+        actor: string;
+        timestamp: string;
+        payload: Record<string, unknown>;
+    }, {
+        _ulid: string;
+        event_type: "lifecycle_change" | "verdict_submitted" | "thread_created" | "thread_replied" | "thread_resolved" | "thread_reopened" | "check_added" | "subject_refreshed";
+        actor: string;
+        timestamp: string;
+        payload?: Record<string, unknown> | undefined;
+    }>, "many">>;
+    notes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        _ulid: z.ZodString;
+        created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
+        author: z.ZodOptional<z.ZodString>;
+        content: z.ZodString;
+        supersedes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        created_at: string;
+        _ulid: string;
+        author?: string | undefined;
+        supersedes?: string | null | undefined;
+    }, {
+        content: string;
+        created_at: string;
+        _ulid: string;
+        author?: string | undefined;
+        supersedes?: string | null | undefined;
+    }>, "many">>;
+    external_links: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        provider: z.ZodOptional<z.ZodString>;
+        external_id: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        external_id?: string | undefined;
+        provider?: string | undefined;
+        label?: string | undefined;
+    }, {
+        url: string;
+        external_id?: string | undefined;
+        provider?: string | undefined;
+        label?: string | undefined;
+    }>, "many">>;
+    examined_commit: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodString]>>;
+    updated_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+}, "strip", z.ZodTypeAny, {
+    created_at: string;
+    lifecycle_state: "draft" | "closed" | "open" | "archived";
+    _ulid: string;
+    author: string;
+    threads: {
+        entries: {
+            created_at: string;
+            _ulid: string;
+            author: string;
+            body: string;
+        }[];
+        _ulid: string;
+        kind: "question" | "blocker" | "nit";
+        anchor?: {
+            path: string;
+            type: "code";
+            commit: string;
+            side: "head" | "base";
+            line_start: number;
+            line_end: number;
+        } | {
+            type: "structured";
+            path?: string | undefined;
+            ref?: string | undefined;
+            section?: string | undefined;
+            field?: string | undefined;
+        } | undefined;
+        resolved_at?: string | null | undefined;
+        resolved_by?: string | null | undefined;
+    }[];
+    notes: {
+        content: string;
+        created_at: string;
+        _ulid: string;
+        author?: string | undefined;
+        supersedes?: string | null | undefined;
+    }[];
+    slugs: string[];
+    title: string;
+    subject: {
+        type: "code";
+        base_commit: string;
+        head_commit: string;
+        merge_base_commit?: string | undefined;
+        base_branch?: string | undefined;
+        head_branch?: string | undefined;
+    } | {
+        type: "plan";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    } | {
+        type: "task";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    } | {
+        type: "spec";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    } | {
+        type: "external";
+        url: string;
+        external_id?: string | undefined;
+        provider?: string | undefined;
+    };
+    related_refs: string[];
+    checks: {
+        name: string;
+        status: "skipped" | "pass" | "fail" | "running";
+        created_at: string;
+        required: boolean;
+        applies_to_version: {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        } | {
+            type: "entity_version";
+            content_hash: string;
+        };
+        completed_at?: string | null | undefined;
+        runner?: string | undefined;
+        evidence?: string | undefined;
+    }[];
+    verdicts: {
+        decision: "approve" | "request_changes" | "comment";
+        reviewer: string;
+        role: string;
+        created_at: string;
+        applies_to_version: {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        } | {
+            type: "entity_version";
+            content_hash: string;
+        };
+    }[];
+    events: {
+        _ulid: string;
+        event_type: "lifecycle_change" | "verdict_submitted" | "thread_created" | "thread_replied" | "thread_resolved" | "thread_reopened" | "check_added" | "subject_refreshed";
+        actor: string;
+        timestamp: string;
+        payload: Record<string, unknown>;
+    }[];
+    external_links: {
+        url: string;
+        external_id?: string | undefined;
+        provider?: string | undefined;
+        label?: string | undefined;
+    }[];
+    examined_commit: string | null;
+    updated_at?: string | null | undefined;
+}, {
+    _ulid: string;
+    author: string;
+    title: string;
+    subject: {
+        type: "code";
+        base_commit: string;
+        head_commit: string;
+        merge_base_commit?: string | undefined;
+        base_branch?: string | undefined;
+        head_branch?: string | undefined;
+    } | {
+        type: "plan";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    } | {
+        type: "task";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    } | {
+        type: "spec";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    } | {
+        type: "external";
+        url: string;
+        external_id?: string | undefined;
+        provider?: string | undefined;
+    };
+    updated_at?: string | null | undefined;
+    created_at?: string | undefined;
+    lifecycle_state?: "draft" | "closed" | "open" | "archived" | undefined;
+    threads?: {
+        _ulid: string;
+        anchor?: {
+            path: string;
+            type: "code";
+            commit: string;
+            side: "head" | "base";
+            line_start: number;
+            line_end: number;
+        } | {
+            type: "structured";
+            path?: string | undefined;
+            ref?: string | undefined;
+            section?: string | undefined;
+            field?: string | undefined;
+        } | undefined;
+        entries?: {
+            created_at: string;
+            _ulid: string;
+            author: string;
+            body: string;
+        }[] | undefined;
+        resolved_at?: string | null | undefined;
+        resolved_by?: string | null | undefined;
+        kind?: "question" | "blocker" | "nit" | undefined;
+    }[] | undefined;
+    notes?: {
+        content: string;
+        created_at: string;
+        _ulid: string;
+        author?: string | undefined;
+        supersedes?: string | null | undefined;
+    }[] | undefined;
+    slugs?: string[] | undefined;
+    related_refs?: string[] | undefined;
+    checks?: {
+        name: string;
+        status: "skipped" | "pass" | "fail" | "running";
+        created_at: string;
+        applies_to_version: {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        } | {
+            type: "entity_version";
+            content_hash: string;
+        };
+        required?: boolean | undefined;
+        completed_at?: string | null | undefined;
+        runner?: string | undefined;
+        evidence?: string | undefined;
+    }[] | undefined;
+    verdicts?: {
+        decision: "approve" | "request_changes" | "comment";
+        reviewer: string;
+        created_at: string;
+        applies_to_version: {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        } | {
+            type: "entity_version";
+            content_hash: string;
+        };
+        role?: string | undefined;
+    }[] | undefined;
+    events?: {
+        _ulid: string;
+        event_type: "lifecycle_change" | "verdict_submitted" | "thread_created" | "thread_replied" | "thread_resolved" | "thread_reopened" | "check_added" | "subject_refreshed";
+        actor: string;
+        timestamp: string;
+        payload?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    external_links?: {
+        url: string;
+        external_id?: string | undefined;
+        provider?: string | undefined;
+        label?: string | undefined;
+    }[] | undefined;
+    examined_commit?: string | null | undefined;
+}>;
+/**
+ * Review record input schema (for creating new reviews).
+ * Most fields are optional - defaults will be applied.
+ */
+export declare const ReviewRecordInputSchema: z.ZodObject<{
+    _ulid: z.ZodOptional<z.ZodString>;
+    slugs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    title: z.ZodString;
+    lifecycle_state: z.ZodOptional<z.ZodEnum<["draft", "open", "closed", "archived"]>>;
+    subject: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"code">;
+        base_commit: z.ZodString;
+        head_commit: z.ZodString;
+        merge_base_commit: z.ZodOptional<z.ZodString>;
+        base_branch: z.ZodOptional<z.ZodString>;
+        head_branch: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "code";
+        base_commit: string;
+        head_commit: string;
+        merge_base_commit?: string | undefined;
+        base_branch?: string | undefined;
+        head_branch?: string | undefined;
+    }, {
+        type: "code";
+        base_commit: string;
+        head_commit: string;
+        merge_base_commit?: string | undefined;
+        base_branch?: string | undefined;
+        head_branch?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"plan">;
+        ref: z.ZodString;
+        shadow_commit: z.ZodString;
+        content_hash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "plan";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    }, {
+        type: "plan";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"task">;
+        ref: z.ZodString;
+        shadow_commit: z.ZodString;
+        content_hash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "task";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    }, {
+        type: "task";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"spec">;
+        ref: z.ZodString;
+        shadow_commit: z.ZodString;
+        content_hash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "spec";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    }, {
+        type: "spec";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"external">;
+        url: z.ZodString;
+        external_id: z.ZodOptional<z.ZodString>;
+        provider: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "external";
+        url: string;
+        external_id?: string | undefined;
+        provider?: string | undefined;
+    }, {
+        type: "external";
+        url: string;
+        external_id?: string | undefined;
+        provider?: string | undefined;
+    }>]>;
+    author: z.ZodString;
+    related_refs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    threads: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        _ulid: z.ZodString;
+        kind: z.ZodDefault<z.ZodEnum<["blocker", "question", "nit"]>>;
+        anchor: z.ZodOptional<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"code">;
+            path: z.ZodString;
+            side: z.ZodEnum<["base", "head"]>;
+            line_start: z.ZodNumber;
+            line_end: z.ZodNumber;
+            commit: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            type: "code";
+            commit: string;
+            side: "head" | "base";
+            line_start: number;
+            line_end: number;
+        }, {
+            path: string;
+            type: "code";
+            commit: string;
+            side: "head" | "base";
+            line_start: number;
+            line_end: number;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"structured">;
+            section: z.ZodOptional<z.ZodString>;
+            field: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString>;
+            ref: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "structured";
+            path?: string | undefined;
+            ref?: string | undefined;
+            section?: string | undefined;
+            field?: string | undefined;
+        }, {
+            type: "structured";
+            path?: string | undefined;
+            ref?: string | undefined;
+            section?: string | undefined;
+            field?: string | undefined;
+        }>]>>;
+        entries: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            _ulid: z.ZodString;
+            author: z.ZodString;
+            body: z.ZodString;
+            created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
+        }, "strip", z.ZodTypeAny, {
+            created_at: string;
+            _ulid: string;
+            author: string;
+            body: string;
+        }, {
+            created_at: string;
+            _ulid: string;
+            author: string;
+            body: string;
+        }>, "many">>;
+        resolved_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        resolved_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        entries: {
+            created_at: string;
+            _ulid: string;
+            author: string;
+            body: string;
+        }[];
+        _ulid: string;
+        kind: "question" | "blocker" | "nit";
+        anchor?: {
+            path: string;
+            type: "code";
+            commit: string;
+            side: "head" | "base";
+            line_start: number;
+            line_end: number;
+        } | {
+            type: "structured";
+            path?: string | undefined;
+            ref?: string | undefined;
+            section?: string | undefined;
+            field?: string | undefined;
+        } | undefined;
+        resolved_at?: string | null | undefined;
+        resolved_by?: string | null | undefined;
+    }, {
+        _ulid: string;
+        anchor?: {
+            path: string;
+            type: "code";
+            commit: string;
+            side: "head" | "base";
+            line_start: number;
+            line_end: number;
+        } | {
+            type: "structured";
+            path?: string | undefined;
+            ref?: string | undefined;
+            section?: string | undefined;
+            field?: string | undefined;
+        } | undefined;
+        entries?: {
+            created_at: string;
+            _ulid: string;
+            author: string;
+            body: string;
+        }[] | undefined;
+        resolved_at?: string | null | undefined;
+        resolved_by?: string | null | undefined;
+        kind?: "question" | "blocker" | "nit" | undefined;
+    }>, "many">>;
+    checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        status: z.ZodEnum<["pass", "fail", "running", "skipped"]>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        runner: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodOptional<z.ZodString>;
+        applies_to_version: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"code_compare">;
+            base_commit: z.ZodString;
+            head_commit: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        }, {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"entity_version">;
+            content_hash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "entity_version";
+            content_hash: string;
+        }, {
+            type: "entity_version";
+            content_hash: string;
+        }>]>;
+        created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
+        completed_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        status: "skipped" | "pass" | "fail" | "running";
+        created_at: string;
+        required: boolean;
+        applies_to_version: {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        } | {
+            type: "entity_version";
+            content_hash: string;
+        };
+        completed_at?: string | null | undefined;
+        runner?: string | undefined;
+        evidence?: string | undefined;
+    }, {
+        name: string;
+        status: "skipped" | "pass" | "fail" | "running";
+        created_at: string;
+        applies_to_version: {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        } | {
+            type: "entity_version";
+            content_hash: string;
+        };
+        required?: boolean | undefined;
+        completed_at?: string | null | undefined;
+        runner?: string | undefined;
+        evidence?: string | undefined;
+    }>, "many">>;
+    verdicts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        reviewer: z.ZodString;
+        role: z.ZodDefault<z.ZodString>;
+        decision: z.ZodEnum<["approve", "request_changes", "comment"]>;
+        applies_to_version: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"code_compare">;
+            base_commit: z.ZodString;
+            head_commit: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        }, {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"entity_version">;
+            content_hash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "entity_version";
+            content_hash: string;
+        }, {
+            type: "entity_version";
+            content_hash: string;
+        }>]>;
+        created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    }, "strip", z.ZodTypeAny, {
+        decision: "approve" | "request_changes" | "comment";
+        reviewer: string;
+        role: string;
+        created_at: string;
+        applies_to_version: {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        } | {
+            type: "entity_version";
+            content_hash: string;
+        };
+    }, {
+        decision: "approve" | "request_changes" | "comment";
+        reviewer: string;
+        created_at: string;
+        applies_to_version: {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        } | {
+            type: "entity_version";
+            content_hash: string;
+        };
+        role?: string | undefined;
+    }>, "many">>;
+    events: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        _ulid: z.ZodString;
+        event_type: z.ZodEnum<["lifecycle_change", "verdict_submitted", "thread_created", "thread_replied", "thread_resolved", "thread_reopened", "check_added", "subject_refreshed"]>;
+        actor: z.ZodString;
+        timestamp: z.ZodUnion<[z.ZodString, z.ZodString]>;
+        payload: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        _ulid: string;
+        event_type: "lifecycle_change" | "verdict_submitted" | "thread_created" | "thread_replied" | "thread_resolved" | "thread_reopened" | "check_added" | "subject_refreshed";
+        actor: string;
+        timestamp: string;
+        payload: Record<string, unknown>;
+    }, {
+        _ulid: string;
+        event_type: "lifecycle_change" | "verdict_submitted" | "thread_created" | "thread_replied" | "thread_resolved" | "thread_reopened" | "check_added" | "subject_refreshed";
+        actor: string;
+        timestamp: string;
+        payload?: Record<string, unknown> | undefined;
+    }>, "many">>;
+    notes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        _ulid: z.ZodString;
+        created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
+        author: z.ZodOptional<z.ZodString>;
+        content: z.ZodString;
+        supersedes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        created_at: string;
+        _ulid: string;
+        author?: string | undefined;
+        supersedes?: string | null | undefined;
+    }, {
+        content: string;
+        created_at: string;
+        _ulid: string;
+        author?: string | undefined;
+        supersedes?: string | null | undefined;
+    }>, "many">>;
+    external_links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        provider: z.ZodOptional<z.ZodString>;
+        external_id: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        external_id?: string | undefined;
+        provider?: string | undefined;
+        label?: string | undefined;
+    }, {
+        url: string;
+        external_id?: string | undefined;
+        provider?: string | undefined;
+        label?: string | undefined;
+    }>, "many">>;
+    examined_commit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodString]>>;
+    updated_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+}, "strip", z.ZodTypeAny, {
+    author: string;
+    title: string;
+    subject: {
+        type: "code";
+        base_commit: string;
+        head_commit: string;
+        merge_base_commit?: string | undefined;
+        base_branch?: string | undefined;
+        head_branch?: string | undefined;
+    } | {
+        type: "plan";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    } | {
+        type: "task";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    } | {
+        type: "spec";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    } | {
+        type: "external";
+        url: string;
+        external_id?: string | undefined;
+        provider?: string | undefined;
+    };
+    updated_at?: string | null | undefined;
+    created_at?: string | undefined;
+    lifecycle_state?: "draft" | "closed" | "open" | "archived" | undefined;
+    _ulid?: string | undefined;
+    threads?: {
+        entries: {
+            created_at: string;
+            _ulid: string;
+            author: string;
+            body: string;
+        }[];
+        _ulid: string;
+        kind: "question" | "blocker" | "nit";
+        anchor?: {
+            path: string;
+            type: "code";
+            commit: string;
+            side: "head" | "base";
+            line_start: number;
+            line_end: number;
+        } | {
+            type: "structured";
+            path?: string | undefined;
+            ref?: string | undefined;
+            section?: string | undefined;
+            field?: string | undefined;
+        } | undefined;
+        resolved_at?: string | null | undefined;
+        resolved_by?: string | null | undefined;
+    }[] | undefined;
+    notes?: {
+        content: string;
+        created_at: string;
+        _ulid: string;
+        author?: string | undefined;
+        supersedes?: string | null | undefined;
+    }[] | undefined;
+    slugs?: string[] | undefined;
+    related_refs?: string[] | undefined;
+    checks?: {
+        name: string;
+        status: "skipped" | "pass" | "fail" | "running";
+        created_at: string;
+        required: boolean;
+        applies_to_version: {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        } | {
+            type: "entity_version";
+            content_hash: string;
+        };
+        completed_at?: string | null | undefined;
+        runner?: string | undefined;
+        evidence?: string | undefined;
+    }[] | undefined;
+    verdicts?: {
+        decision: "approve" | "request_changes" | "comment";
+        reviewer: string;
+        role: string;
+        created_at: string;
+        applies_to_version: {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        } | {
+            type: "entity_version";
+            content_hash: string;
+        };
+    }[] | undefined;
+    events?: {
+        _ulid: string;
+        event_type: "lifecycle_change" | "verdict_submitted" | "thread_created" | "thread_replied" | "thread_resolved" | "thread_reopened" | "check_added" | "subject_refreshed";
+        actor: string;
+        timestamp: string;
+        payload: Record<string, unknown>;
+    }[] | undefined;
+    external_links?: {
+        url: string;
+        external_id?: string | undefined;
+        provider?: string | undefined;
+        label?: string | undefined;
+    }[] | undefined;
+    examined_commit?: string | null | undefined;
+}, {
+    author: string;
+    title: string;
+    subject: {
+        type: "code";
+        base_commit: string;
+        head_commit: string;
+        merge_base_commit?: string | undefined;
+        base_branch?: string | undefined;
+        head_branch?: string | undefined;
+    } | {
+        type: "plan";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    } | {
+        type: "task";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    } | {
+        type: "spec";
+        ref: string;
+        shadow_commit: string;
+        content_hash: string;
+    } | {
+        type: "external";
+        url: string;
+        external_id?: string | undefined;
+        provider?: string | undefined;
+    };
+    updated_at?: string | null | undefined;
+    created_at?: string | undefined;
+    lifecycle_state?: "draft" | "closed" | "open" | "archived" | undefined;
+    _ulid?: string | undefined;
+    threads?: {
+        _ulid: string;
+        anchor?: {
+            path: string;
+            type: "code";
+            commit: string;
+            side: "head" | "base";
+            line_start: number;
+            line_end: number;
+        } | {
+            type: "structured";
+            path?: string | undefined;
+            ref?: string | undefined;
+            section?: string | undefined;
+            field?: string | undefined;
+        } | undefined;
+        entries?: {
+            created_at: string;
+            _ulid: string;
+            author: string;
+            body: string;
+        }[] | undefined;
+        resolved_at?: string | null | undefined;
+        resolved_by?: string | null | undefined;
+        kind?: "question" | "blocker" | "nit" | undefined;
+    }[] | undefined;
+    notes?: {
+        content: string;
+        created_at: string;
+        _ulid: string;
+        author?: string | undefined;
+        supersedes?: string | null | undefined;
+    }[] | undefined;
+    slugs?: string[] | undefined;
+    related_refs?: string[] | undefined;
+    checks?: {
+        name: string;
+        status: "skipped" | "pass" | "fail" | "running";
+        created_at: string;
+        applies_to_version: {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        } | {
+            type: "entity_version";
+            content_hash: string;
+        };
+        required?: boolean | undefined;
+        completed_at?: string | null | undefined;
+        runner?: string | undefined;
+        evidence?: string | undefined;
+    }[] | undefined;
+    verdicts?: {
+        decision: "approve" | "request_changes" | "comment";
+        reviewer: string;
+        created_at: string;
+        applies_to_version: {
+            type: "code_compare";
+            base_commit: string;
+            head_commit: string;
+        } | {
+            type: "entity_version";
+            content_hash: string;
+        };
+        role?: string | undefined;
+    }[] | undefined;
+    events?: {
+        _ulid: string;
+        event_type: "lifecycle_change" | "verdict_submitted" | "thread_created" | "thread_replied" | "thread_resolved" | "thread_reopened" | "check_added" | "subject_refreshed";
+        actor: string;
+        timestamp: string;
+        payload?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    external_links?: {
+        url: string;
+        external_id?: string | undefined;
+        provider?: string | undefined;
+        label?: string | undefined;
+    }[] | undefined;
+    examined_commit?: string | null | undefined;
+}>;
+/**
+ * Reviews file schema (collection of reviews).
+ * Stored in project.reviews.yaml.
+ */
+export declare const ReviewRecordsFileSchema: z.ZodObject<{
+    kynetic_reviews: z.ZodDefault<z.ZodString>;
+    reviews: z.ZodArray<z.ZodObject<{
+        _ulid: z.ZodString;
+        slugs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        title: z.ZodString;
+        lifecycle_state: z.ZodDefault<z.ZodEnum<["draft", "open", "closed", "archived"]>>;
+        subject: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"code">;
+            base_commit: z.ZodString;
+            head_commit: z.ZodString;
+            merge_base_commit: z.ZodOptional<z.ZodString>;
+            base_branch: z.ZodOptional<z.ZodString>;
+            head_branch: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "code";
+            base_commit: string;
+            head_commit: string;
+            merge_base_commit?: string | undefined;
+            base_branch?: string | undefined;
+            head_branch?: string | undefined;
+        }, {
+            type: "code";
+            base_commit: string;
+            head_commit: string;
+            merge_base_commit?: string | undefined;
+            base_branch?: string | undefined;
+            head_branch?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"plan">;
+            ref: z.ZodString;
+            shadow_commit: z.ZodString;
+            content_hash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "plan";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        }, {
+            type: "plan";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"task">;
+            ref: z.ZodString;
+            shadow_commit: z.ZodString;
+            content_hash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "task";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        }, {
+            type: "task";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"spec">;
+            ref: z.ZodString;
+            shadow_commit: z.ZodString;
+            content_hash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "spec";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        }, {
+            type: "spec";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"external">;
+            url: z.ZodString;
+            external_id: z.ZodOptional<z.ZodString>;
+            provider: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "external";
+            url: string;
+            external_id?: string | undefined;
+            provider?: string | undefined;
+        }, {
+            type: "external";
+            url: string;
+            external_id?: string | undefined;
+            provider?: string | undefined;
+        }>]>;
+        author: z.ZodString;
+        related_refs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        threads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            _ulid: z.ZodString;
+            kind: z.ZodDefault<z.ZodEnum<["blocker", "question", "nit"]>>;
+            anchor: z.ZodOptional<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                type: z.ZodLiteral<"code">;
+                path: z.ZodString;
+                side: z.ZodEnum<["base", "head"]>;
+                line_start: z.ZodNumber;
+                line_end: z.ZodNumber;
+                commit: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                path: string;
+                type: "code";
+                commit: string;
+                side: "head" | "base";
+                line_start: number;
+                line_end: number;
+            }, {
+                path: string;
+                type: "code";
+                commit: string;
+                side: "head" | "base";
+                line_start: number;
+                line_end: number;
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"structured">;
+                section: z.ZodOptional<z.ZodString>;
+                field: z.ZodOptional<z.ZodString>;
+                path: z.ZodOptional<z.ZodString>;
+                ref: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: "structured";
+                path?: string | undefined;
+                ref?: string | undefined;
+                section?: string | undefined;
+                field?: string | undefined;
+            }, {
+                type: "structured";
+                path?: string | undefined;
+                ref?: string | undefined;
+                section?: string | undefined;
+                field?: string | undefined;
+            }>]>>;
+            entries: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                _ulid: z.ZodString;
+                author: z.ZodString;
+                body: z.ZodString;
+                created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
+            }, "strip", z.ZodTypeAny, {
+                created_at: string;
+                _ulid: string;
+                author: string;
+                body: string;
+            }, {
+                created_at: string;
+                _ulid: string;
+                author: string;
+                body: string;
+            }>, "many">>;
+            resolved_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+            resolved_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            entries: {
+                created_at: string;
+                _ulid: string;
+                author: string;
+                body: string;
+            }[];
+            _ulid: string;
+            kind: "question" | "blocker" | "nit";
+            anchor?: {
+                path: string;
+                type: "code";
+                commit: string;
+                side: "head" | "base";
+                line_start: number;
+                line_end: number;
+            } | {
+                type: "structured";
+                path?: string | undefined;
+                ref?: string | undefined;
+                section?: string | undefined;
+                field?: string | undefined;
+            } | undefined;
+            resolved_at?: string | null | undefined;
+            resolved_by?: string | null | undefined;
+        }, {
+            _ulid: string;
+            anchor?: {
+                path: string;
+                type: "code";
+                commit: string;
+                side: "head" | "base";
+                line_start: number;
+                line_end: number;
+            } | {
+                type: "structured";
+                path?: string | undefined;
+                ref?: string | undefined;
+                section?: string | undefined;
+                field?: string | undefined;
+            } | undefined;
+            entries?: {
+                created_at: string;
+                _ulid: string;
+                author: string;
+                body: string;
+            }[] | undefined;
+            resolved_at?: string | null | undefined;
+            resolved_by?: string | null | undefined;
+            kind?: "question" | "blocker" | "nit" | undefined;
+        }>, "many">>;
+        checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            status: z.ZodEnum<["pass", "fail", "running", "skipped"]>;
+            required: z.ZodDefault<z.ZodBoolean>;
+            runner: z.ZodOptional<z.ZodString>;
+            evidence: z.ZodOptional<z.ZodString>;
+            applies_to_version: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                type: z.ZodLiteral<"code_compare">;
+                base_commit: z.ZodString;
+                head_commit: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: "code_compare";
+                base_commit: string;
+                head_commit: string;
+            }, {
+                type: "code_compare";
+                base_commit: string;
+                head_commit: string;
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"entity_version">;
+                content_hash: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: "entity_version";
+                content_hash: string;
+            }, {
+                type: "entity_version";
+                content_hash: string;
+            }>]>;
+            created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
+            completed_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            status: "skipped" | "pass" | "fail" | "running";
+            created_at: string;
+            required: boolean;
+            applies_to_version: {
+                type: "code_compare";
+                base_commit: string;
+                head_commit: string;
+            } | {
+                type: "entity_version";
+                content_hash: string;
+            };
+            completed_at?: string | null | undefined;
+            runner?: string | undefined;
+            evidence?: string | undefined;
+        }, {
+            name: string;
+            status: "skipped" | "pass" | "fail" | "running";
+            created_at: string;
+            applies_to_version: {
+                type: "code_compare";
+                base_commit: string;
+                head_commit: string;
+            } | {
+                type: "entity_version";
+                content_hash: string;
+            };
+            required?: boolean | undefined;
+            completed_at?: string | null | undefined;
+            runner?: string | undefined;
+            evidence?: string | undefined;
+        }>, "many">>;
+        verdicts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            reviewer: z.ZodString;
+            role: z.ZodDefault<z.ZodString>;
+            decision: z.ZodEnum<["approve", "request_changes", "comment"]>;
+            applies_to_version: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                type: z.ZodLiteral<"code_compare">;
+                base_commit: z.ZodString;
+                head_commit: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: "code_compare";
+                base_commit: string;
+                head_commit: string;
+            }, {
+                type: "code_compare";
+                base_commit: string;
+                head_commit: string;
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"entity_version">;
+                content_hash: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: "entity_version";
+                content_hash: string;
+            }, {
+                type: "entity_version";
+                content_hash: string;
+            }>]>;
+            created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
+        }, "strip", z.ZodTypeAny, {
+            decision: "approve" | "request_changes" | "comment";
+            reviewer: string;
+            role: string;
+            created_at: string;
+            applies_to_version: {
+                type: "code_compare";
+                base_commit: string;
+                head_commit: string;
+            } | {
+                type: "entity_version";
+                content_hash: string;
+            };
+        }, {
+            decision: "approve" | "request_changes" | "comment";
+            reviewer: string;
+            created_at: string;
+            applies_to_version: {
+                type: "code_compare";
+                base_commit: string;
+                head_commit: string;
+            } | {
+                type: "entity_version";
+                content_hash: string;
+            };
+            role?: string | undefined;
+        }>, "many">>;
+        events: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            _ulid: z.ZodString;
+            event_type: z.ZodEnum<["lifecycle_change", "verdict_submitted", "thread_created", "thread_replied", "thread_resolved", "thread_reopened", "check_added", "subject_refreshed"]>;
+            actor: z.ZodString;
+            timestamp: z.ZodUnion<[z.ZodString, z.ZodString]>;
+            payload: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            _ulid: string;
+            event_type: "lifecycle_change" | "verdict_submitted" | "thread_created" | "thread_replied" | "thread_resolved" | "thread_reopened" | "check_added" | "subject_refreshed";
+            actor: string;
+            timestamp: string;
+            payload: Record<string, unknown>;
+        }, {
+            _ulid: string;
+            event_type: "lifecycle_change" | "verdict_submitted" | "thread_created" | "thread_replied" | "thread_resolved" | "thread_reopened" | "check_added" | "subject_refreshed";
+            actor: string;
+            timestamp: string;
+            payload?: Record<string, unknown> | undefined;
+        }>, "many">>;
+        notes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            _ulid: z.ZodString;
+            created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
+            author: z.ZodOptional<z.ZodString>;
+            content: z.ZodString;
+            supersedes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            content: string;
+            created_at: string;
+            _ulid: string;
+            author?: string | undefined;
+            supersedes?: string | null | undefined;
+        }, {
+            content: string;
+            created_at: string;
+            _ulid: string;
+            author?: string | undefined;
+            supersedes?: string | null | undefined;
+        }>, "many">>;
+        external_links: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            provider: z.ZodOptional<z.ZodString>;
+            external_id: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            external_id?: string | undefined;
+            provider?: string | undefined;
+            label?: string | undefined;
+        }, {
+            url: string;
+            external_id?: string | undefined;
+            provider?: string | undefined;
+            label?: string | undefined;
+        }>, "many">>;
+        examined_commit: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        created_at: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodString]>>;
+        updated_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+    }, "strip", z.ZodTypeAny, {
+        created_at: string;
+        lifecycle_state: "draft" | "closed" | "open" | "archived";
+        _ulid: string;
+        author: string;
+        threads: {
+            entries: {
+                created_at: string;
+                _ulid: string;
+                author: string;
+                body: string;
+            }[];
+            _ulid: string;
+            kind: "question" | "blocker" | "nit";
+            anchor?: {
+                path: string;
+                type: "code";
+                commit: string;
+                side: "head" | "base";
+                line_start: number;
+                line_end: number;
+            } | {
+                type: "structured";
+                path?: string | undefined;
+                ref?: string | undefined;
+                section?: string | undefined;
+                field?: string | undefined;
+            } | undefined;
+            resolved_at?: string | null | undefined;
+            resolved_by?: string | null | undefined;
+        }[];
+        notes: {
+            content: string;
+            created_at: string;
+            _ulid: string;
+            author?: string | undefined;
+            supersedes?: string | null | undefined;
+        }[];
+        slugs: string[];
+        title: string;
+        subject: {
+            type: "code";
+            base_commit: string;
+            head_commit: string;
+            merge_base_commit?: string | undefined;
+            base_branch?: string | undefined;
+            head_branch?: string | undefined;
+        } | {
+            type: "plan";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        } | {
+            type: "task";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        } | {
+            type: "spec";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        } | {
+            type: "external";
+            url: string;
+            external_id?: string | undefined;
+            provider?: string | undefined;
+        };
+        related_refs: string[];
+        checks: {
+            name: string;
+            status: "skipped" | "pass" | "fail" | "running";
+            created_at: string;
+            required: boolean;
+            applies_to_version: {
+                type: "code_compare";
+                base_commit: string;
+                head_commit: string;
+            } | {
+                type: "entity_version";
+                content_hash: string;
+            };
+            completed_at?: string | null | undefined;
+            runner?: string | undefined;
+            evidence?: string | undefined;
+        }[];
+        verdicts: {
+            decision: "approve" | "request_changes" | "comment";
+            reviewer: string;
+            role: string;
+            created_at: string;
+            applies_to_version: {
+                type: "code_compare";
+                base_commit: string;
+                head_commit: string;
+            } | {
+                type: "entity_version";
+                content_hash: string;
+            };
+        }[];
+        events: {
+            _ulid: string;
+            event_type: "lifecycle_change" | "verdict_submitted" | "thread_created" | "thread_replied" | "thread_resolved" | "thread_reopened" | "check_added" | "subject_refreshed";
+            actor: string;
+            timestamp: string;
+            payload: Record<string, unknown>;
+        }[];
+        external_links: {
+            url: string;
+            external_id?: string | undefined;
+            provider?: string | undefined;
+            label?: string | undefined;
+        }[];
+        examined_commit: string | null;
+        updated_at?: string | null | undefined;
+    }, {
+        _ulid: string;
+        author: string;
+        title: string;
+        subject: {
+            type: "code";
+            base_commit: string;
+            head_commit: string;
+            merge_base_commit?: string | undefined;
+            base_branch?: string | undefined;
+            head_branch?: string | undefined;
+        } | {
+            type: "plan";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        } | {
+            type: "task";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        } | {
+            type: "spec";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        } | {
+            type: "external";
+            url: string;
+            external_id?: string | undefined;
+            provider?: string | undefined;
+        };
+        updated_at?: string | null | undefined;
+        created_at?: string | undefined;
+        lifecycle_state?: "draft" | "closed" | "open" | "archived" | undefined;
+        threads?: {
+            _ulid: string;
+            anchor?: {
+                path: string;
+                type: "code";
+                commit: string;
+                side: "head" | "base";
+                line_start: number;
+                line_end: number;
+            } | {
+                type: "structured";
+                path?: string | undefined;
+                ref?: string | undefined;
+                section?: string | undefined;
+                field?: string | undefined;
+            } | undefined;
+            entries?: {
+                created_at: string;
+                _ulid: string;
+                author: string;
+                body: string;
+            }[] | undefined;
+            resolved_at?: string | null | undefined;
+            resolved_by?: string | null | undefined;
+            kind?: "question" | "blocker" | "nit" | undefined;
+        }[] | undefined;
+        notes?: {
+            content: string;
+            created_at: string;
+            _ulid: string;
+            author?: string | undefined;
+            supersedes?: string | null | undefined;
+        }[] | undefined;
+        slugs?: string[] | undefined;
+        related_refs?: string[] | undefined;
+        checks?: {
+            name: string;
+            status: "skipped" | "pass" | "fail" | "running";
+            created_at: string;
+            applies_to_version: {
+                type: "code_compare";
+                base_commit: string;
+                head_commit: string;
+            } | {
+                type: "entity_version";
+                content_hash: string;
+            };
+            required?: boolean | undefined;
+            completed_at?: string | null | undefined;
+            runner?: string | undefined;
+            evidence?: string | undefined;
+        }[] | undefined;
+        verdicts?: {
+            decision: "approve" | "request_changes" | "comment";
+            reviewer: string;
+            created_at: string;
+            applies_to_version: {
+                type: "code_compare";
+                base_commit: string;
+                head_commit: string;
+            } | {
+                type: "entity_version";
+                content_hash: string;
+            };
+            role?: string | undefined;
+        }[] | undefined;
+        events?: {
+            _ulid: string;
+            event_type: "lifecycle_change" | "verdict_submitted" | "thread_created" | "thread_replied" | "thread_resolved" | "thread_reopened" | "check_added" | "subject_refreshed";
+            actor: string;
+            timestamp: string;
+            payload?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        external_links?: {
+            url: string;
+            external_id?: string | undefined;
+            provider?: string | undefined;
+            label?: string | undefined;
+        }[] | undefined;
+        examined_commit?: string | null | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    kynetic_reviews: string;
+    reviews: {
+        created_at: string;
+        lifecycle_state: "draft" | "closed" | "open" | "archived";
+        _ulid: string;
+        author: string;
+        threads: {
+            entries: {
+                created_at: string;
+                _ulid: string;
+                author: string;
+                body: string;
+            }[];
+            _ulid: string;
+            kind: "question" | "blocker" | "nit";
+            anchor?: {
+                path: string;
+                type: "code";
+                commit: string;
+                side: "head" | "base";
+                line_start: number;
+                line_end: number;
+            } | {
+                type: "structured";
+                path?: string | undefined;
+                ref?: string | undefined;
+                section?: string | undefined;
+                field?: string | undefined;
+            } | undefined;
+            resolved_at?: string | null | undefined;
+            resolved_by?: string | null | undefined;
+        }[];
+        notes: {
+            content: string;
+            created_at: string;
+            _ulid: string;
+            author?: string | undefined;
+            supersedes?: string | null | undefined;
+        }[];
+        slugs: string[];
+        title: string;
+        subject: {
+            type: "code";
+            base_commit: string;
+            head_commit: string;
+            merge_base_commit?: string | undefined;
+            base_branch?: string | undefined;
+            head_branch?: string | undefined;
+        } | {
+            type: "plan";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        } | {
+            type: "task";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        } | {
+            type: "spec";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        } | {
+            type: "external";
+            url: string;
+            external_id?: string | undefined;
+            provider?: string | undefined;
+        };
+        related_refs: string[];
+        checks: {
+            name: string;
+            status: "skipped" | "pass" | "fail" | "running";
+            created_at: string;
+            required: boolean;
+            applies_to_version: {
+                type: "code_compare";
+                base_commit: string;
+                head_commit: string;
+            } | {
+                type: "entity_version";
+                content_hash: string;
+            };
+            completed_at?: string | null | undefined;
+            runner?: string | undefined;
+            evidence?: string | undefined;
+        }[];
+        verdicts: {
+            decision: "approve" | "request_changes" | "comment";
+            reviewer: string;
+            role: string;
+            created_at: string;
+            applies_to_version: {
+                type: "code_compare";
+                base_commit: string;
+                head_commit: string;
+            } | {
+                type: "entity_version";
+                content_hash: string;
+            };
+        }[];
+        events: {
+            _ulid: string;
+            event_type: "lifecycle_change" | "verdict_submitted" | "thread_created" | "thread_replied" | "thread_resolved" | "thread_reopened" | "check_added" | "subject_refreshed";
+            actor: string;
+            timestamp: string;
+            payload: Record<string, unknown>;
+        }[];
+        external_links: {
+            url: string;
+            external_id?: string | undefined;
+            provider?: string | undefined;
+            label?: string | undefined;
+        }[];
+        examined_commit: string | null;
+        updated_at?: string | null | undefined;
+    }[];
+}, {
+    reviews: {
+        _ulid: string;
+        author: string;
+        title: string;
+        subject: {
+            type: "code";
+            base_commit: string;
+            head_commit: string;
+            merge_base_commit?: string | undefined;
+            base_branch?: string | undefined;
+            head_branch?: string | undefined;
+        } | {
+            type: "plan";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        } | {
+            type: "task";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        } | {
+            type: "spec";
+            ref: string;
+            shadow_commit: string;
+            content_hash: string;
+        } | {
+            type: "external";
+            url: string;
+            external_id?: string | undefined;
+            provider?: string | undefined;
+        };
+        updated_at?: string | null | undefined;
+        created_at?: string | undefined;
+        lifecycle_state?: "draft" | "closed" | "open" | "archived" | undefined;
+        threads?: {
+            _ulid: string;
+            anchor?: {
+                path: string;
+                type: "code";
+                commit: string;
+                side: "head" | "base";
+                line_start: number;
+                line_end: number;
+            } | {
+                type: "structured";
+                path?: string | undefined;
+                ref?: string | undefined;
+                section?: string | undefined;
+                field?: string | undefined;
+            } | undefined;
+            entries?: {
+                created_at: string;
+                _ulid: string;
+                author: string;
+                body: string;
+            }[] | undefined;
+            resolved_at?: string | null | undefined;
+            resolved_by?: string | null | undefined;
+            kind?: "question" | "blocker" | "nit" | undefined;
+        }[] | undefined;
+        notes?: {
+            content: string;
+            created_at: string;
+            _ulid: string;
+            author?: string | undefined;
+            supersedes?: string | null | undefined;
+        }[] | undefined;
+        slugs?: string[] | undefined;
+        related_refs?: string[] | undefined;
+        checks?: {
+            name: string;
+            status: "skipped" | "pass" | "fail" | "running";
+            created_at: string;
+            applies_to_version: {
+                type: "code_compare";
+                base_commit: string;
+                head_commit: string;
+            } | {
+                type: "entity_version";
+                content_hash: string;
+            };
+            required?: boolean | undefined;
+            completed_at?: string | null | undefined;
+            runner?: string | undefined;
+            evidence?: string | undefined;
+        }[] | undefined;
+        verdicts?: {
+            decision: "approve" | "request_changes" | "comment";
+            reviewer: string;
+            created_at: string;
+            applies_to_version: {
+                type: "code_compare";
+                base_commit: string;
+                head_commit: string;
+            } | {
+                type: "entity_version";
+                content_hash: string;
+            };
+            role?: string | undefined;
+        }[] | undefined;
+        events?: {
+            _ulid: string;
+            event_type: "lifecycle_change" | "verdict_submitted" | "thread_created" | "thread_replied" | "thread_resolved" | "thread_reopened" | "check_added" | "subject_refreshed";
+            actor: string;
+            timestamp: string;
+            payload?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        external_links?: {
+            url: string;
+            external_id?: string | undefined;
+            provider?: string | undefined;
+            label?: string | undefined;
+        }[] | undefined;
+        examined_commit?: string | null | undefined;
+    }[];
+    kynetic_reviews?: string | undefined;
+}>;
+export type ReviewLifecycleState = z.infer<typeof ReviewLifecycleStateSchema>;
+export type ReviewDisposition = z.infer<typeof ReviewDispositionSchema>;
+export type ReviewGateState = z.infer<typeof ReviewGateStateSchema>;
+export type ReviewCodeSubject = z.infer<typeof ReviewCodeSubjectSchema>;
+export type ReviewPlanSubject = z.infer<typeof ReviewPlanSubjectSchema>;
+export type ReviewTaskSubject = z.infer<typeof ReviewTaskSubjectSchema>;
+export type ReviewSpecSubject = z.infer<typeof ReviewSpecSubjectSchema>;
+export type ReviewExternalSubject = z.infer<typeof ReviewExternalSubjectSchema>;
+export type ReviewSubject = z.infer<typeof ReviewSubjectSchema>;
+export type ReviewCodeCompareVersion = z.infer<typeof ReviewCodeCompareVersionSchema>;
+export type ReviewEntityVersion = z.infer<typeof ReviewEntityVersionSchema>;
+export type ReviewSubjectVersion = z.infer<typeof ReviewSubjectVersionSchema>;
+export type ReviewCodeAnchor = z.infer<typeof ReviewCodeAnchorSchema>;
+export type ReviewStructuredAnchor = z.infer<typeof ReviewStructuredAnchorSchema>;
+export type ReviewAnchor = z.infer<typeof ReviewAnchorSchema>;
+export type ReviewThreadKind = z.infer<typeof ReviewThreadKindSchema>;
+export type ReviewThreadEntry = z.infer<typeof ReviewThreadEntrySchema>;
+export type ReviewThread = z.infer<typeof ReviewThreadSchema>;
+export type ReviewCheckStatus = z.infer<typeof ReviewCheckStatusSchema>;
+export type ReviewCheck = z.infer<typeof ReviewCheckSchema>;
+export type ReviewVerdictDecision = z.infer<typeof ReviewVerdictDecisionSchema>;
+export type ReviewVerdict = z.infer<typeof ReviewVerdictSchema>;
+export type ReviewEventType = z.infer<typeof ReviewEventTypeSchema>;
+export type ReviewEvent = z.infer<typeof ReviewEventSchema>;
+export type ReviewExternalLink = z.infer<typeof ReviewExternalLinkSchema>;
+export type ReviewRecord = z.infer<typeof ReviewRecordSchema>;
+export type ReviewRecordInput = z.infer<typeof ReviewRecordInputSchema>;
+export type ReviewRecordsFile = z.infer<typeof ReviewRecordsFileSchema>;
+//# sourceMappingURL=review-records.d.ts.map