clinkx 0.2.3 → 1.0.0

package/clinkx-workflows/dist/plan-review/contract.d.ts

@@ -0,0 +1,763 @@
+import { z } from "zod";
+export declare const REVIEW_ID_PATTERN: RegExp;
+export declare const REPOSITORY_ID_PATTERN: RegExp;
+export declare const PLAN_ID_PATTERN: RegExp;
+export declare const SHA256_PATTERN: RegExp;
+export declare const MAX_PLAN_REVIEW_REPOSITORY_ID_CHARS = 128;
+export declare const MAX_PLAN_REVIEW_SEATS = 10;
+export declare const PLAN_REVIEW_STANCES: readonly ["strict", "pragmatic", "adversarial"];
+export declare const MAX_RESULT_ENVELOPE_BYTES = 1048576;
+export declare const ReviewIdSchema: z.ZodString;
+export declare const RepositoryIdSchema: z.ZodString;
+export declare const PlanIdSchema: z.ZodString;
+export declare const DigestSchema: z.ZodString;
+export declare const CliNameSchema: z.ZodEnum<["codex", "claude", "glm", "agy", "grok"]>;
+/**
+ * The closed v1 plan-review provider set, derived from `CliNameSchema` so the
+ * enum stays the single source of truth: a seat's `cli_name` and the set
+ * discovery advertises cannot drift apart.
+ *
+ * Discovery filters configured adapters through this set. A custom adapter the
+ * host happens to have configured is NOT a v1 plan-review provider — admitting
+ * it into the roster would fail `CliNameSchema` at contract parse anyway, so
+ * advertising it would promise a seat that cannot be bound.
+ */
+export declare const PLAN_REVIEW_V1_CLI_NAMES: ["codex", "claude", "glm", "agy", "grok"];
+export declare const CouncilPlanReviewInputSchema: z.ZodEffects<z.ZodObject<{
+    schema_version: z.ZodLiteral<"council-plan-review-input-v1">;
+    workspace_schema: z.ZodLiteral<"plan-workspace-v1">;
+    digest_profile: z.ZodLiteral<"checkpoint-text-v1">;
+    review_id: z.ZodString;
+    repository_id: z.ZodString;
+    iteration: z.ZodNumber;
+    plan_id: z.ZodString;
+    revision: z.ZodNumber;
+    digest: z.ZodString;
+    expected_execution_contract_digest: z.ZodString;
+    threshold: z.ZodNumber;
+    designated_editor: z.ZodString;
+    chairman_seat: z.ZodString;
+    plan_file: z.ZodEffects<z.ZodString, string, string>;
+    seats: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        seat_id: z.ZodString;
+        reviewer: z.ZodString;
+        cli_name: z.ZodEnum<["codex", "claude", "glm", "agy", "grok"]>;
+        stance: z.ZodEnum<["strict", "pragmatic", "adversarial"]>;
+    }, "strict", z.ZodTypeAny, {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        seat_id: string;
+        reviewer: string;
+        stance: "strict" | "pragmatic" | "adversarial";
+    }, {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        seat_id: string;
+        reviewer: string;
+        stance: "strict" | "pragmatic" | "adversarial";
+    }>, {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        seat_id: string;
+        reviewer: string;
+        stance: "strict" | "pragmatic" | "adversarial";
+    }, {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        seat_id: string;
+        reviewer: string;
+        stance: "strict" | "pragmatic" | "adversarial";
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    schema_version: "council-plan-review-input-v1";
+    workspace_schema: "plan-workspace-v1";
+    digest_profile: "checkpoint-text-v1";
+    review_id: string;
+    repository_id: string;
+    iteration: number;
+    plan_id: string;
+    revision: number;
+    digest: string;
+    expected_execution_contract_digest: string;
+    threshold: number;
+    designated_editor: string;
+    chairman_seat: string;
+    plan_file: string;
+    seats: {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        seat_id: string;
+        reviewer: string;
+        stance: "strict" | "pragmatic" | "adversarial";
+    }[];
+}, {
+    schema_version: "council-plan-review-input-v1";
+    workspace_schema: "plan-workspace-v1";
+    digest_profile: "checkpoint-text-v1";
+    review_id: string;
+    repository_id: string;
+    iteration: number;
+    plan_id: string;
+    revision: number;
+    digest: string;
+    expected_execution_contract_digest: string;
+    threshold: number;
+    designated_editor: string;
+    chairman_seat: string;
+    plan_file: string;
+    seats: {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        seat_id: string;
+        reviewer: string;
+        stance: "strict" | "pragmatic" | "adversarial";
+    }[];
+}>, {
+    schema_version: "council-plan-review-input-v1";
+    workspace_schema: "plan-workspace-v1";
+    digest_profile: "checkpoint-text-v1";
+    review_id: string;
+    repository_id: string;
+    iteration: number;
+    plan_id: string;
+    revision: number;
+    digest: string;
+    expected_execution_contract_digest: string;
+    threshold: number;
+    designated_editor: string;
+    chairman_seat: string;
+    plan_file: string;
+    seats: {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        seat_id: string;
+        reviewer: string;
+        stance: "strict" | "pragmatic" | "adversarial";
+    }[];
+}, {
+    schema_version: "council-plan-review-input-v1";
+    workspace_schema: "plan-workspace-v1";
+    digest_profile: "checkpoint-text-v1";
+    review_id: string;
+    repository_id: string;
+    iteration: number;
+    plan_id: string;
+    revision: number;
+    digest: string;
+    expected_execution_contract_digest: string;
+    threshold: number;
+    designated_editor: string;
+    chairman_seat: string;
+    plan_file: string;
+    seats: {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        seat_id: string;
+        reviewer: string;
+        stance: "strict" | "pragmatic" | "adversarial";
+    }[];
+}>;
+export type CouncilPlanReviewInput = z.infer<typeof CouncilPlanReviewInputSchema>;
+export declare const ReviewReceiptV1Schema: z.ZodObject<{
+    schema_version: z.ZodLiteral<"review-receipt-v1">;
+    workspace_schema: z.ZodLiteral<"plan-workspace-v1">;
+    digest_profile: z.ZodLiteral<"checkpoint-text-v1">;
+    review_id: z.ZodString;
+    repository_id: z.ZodString;
+    iteration: z.ZodNumber;
+    plan_id: z.ZodString;
+    revision: z.ZodNumber;
+    digest: z.ZodString;
+    seat_id: z.ZodString;
+    reviewer: z.ZodString;
+    status: z.ZodEnum<["completed", "failed"]>;
+    verdict: z.ZodEnum<["approve", "request_changes", "abstain"]>;
+    score: z.ZodNumber;
+    blockers: z.ZodArray<z.ZodString, "many">;
+    verification_gaps: z.ZodArray<z.ZodString, "many">;
+    findings: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    status: "failed" | "completed";
+    schema_version: "review-receipt-v1";
+    score: number;
+    findings: string[];
+    seat_id: string;
+    reviewer: string;
+    workspace_schema: "plan-workspace-v1";
+    digest_profile: "checkpoint-text-v1";
+    review_id: string;
+    repository_id: string;
+    iteration: number;
+    plan_id: string;
+    revision: number;
+    digest: string;
+    verdict: "approve" | "request_changes" | "abstain";
+    blockers: string[];
+    verification_gaps: string[];
+}, {
+    status: "failed" | "completed";
+    schema_version: "review-receipt-v1";
+    score: number;
+    findings: string[];
+    seat_id: string;
+    reviewer: string;
+    workspace_schema: "plan-workspace-v1";
+    digest_profile: "checkpoint-text-v1";
+    review_id: string;
+    repository_id: string;
+    iteration: number;
+    plan_id: string;
+    revision: number;
+    digest: string;
+    verdict: "approve" | "request_changes" | "abstain";
+    blockers: string[];
+    verification_gaps: string[];
+}>;
+export type ReviewReceiptV1 = z.infer<typeof ReviewReceiptV1Schema>;
+export declare const PlanReviewErrorReasonSchema: z.ZodEnum<["timeout", "nonzero_exit", "invalid_output", "schema_mismatch", "no_artifact", "cancelled", "internal_error"]>;
+export declare const CouncilPlanReviewResultSchema: z.ZodEffects<z.ZodObject<{
+    schema_version: z.ZodLiteral<"council-plan-review-result-v1">;
+    execution_contract_digest: z.ZodString;
+    execution_status: z.ZodEnum<["complete", "partial"]>;
+    bindings: z.ZodObject<{
+        repository_id: z.ZodString;
+        review_id: z.ZodString;
+        plan_id: z.ZodString;
+        revision: z.ZodNumber;
+        digest: z.ZodString;
+        threshold: z.ZodNumber;
+        designated_editor: z.ZodString;
+        chairman_seat: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        review_id: string;
+        repository_id: string;
+        plan_id: string;
+        revision: number;
+        digest: string;
+        threshold: number;
+        designated_editor: string;
+        chairman_seat: string;
+    }, {
+        review_id: string;
+        repository_id: string;
+        plan_id: string;
+        revision: number;
+        digest: string;
+        threshold: number;
+        designated_editor: string;
+        chairman_seat: string;
+    }>;
+    seats: z.ZodArray<z.ZodDiscriminatedUnion<"execution_status", [z.ZodObject<{
+        execution_status: z.ZodLiteral<"completed">;
+        receipt_candidate: z.ZodObject<{
+            schema_version: z.ZodLiteral<"review-receipt-v1">;
+            workspace_schema: z.ZodLiteral<"plan-workspace-v1">;
+            digest_profile: z.ZodLiteral<"checkpoint-text-v1">;
+            review_id: z.ZodString;
+            repository_id: z.ZodString;
+            iteration: z.ZodNumber;
+            plan_id: z.ZodString;
+            revision: z.ZodNumber;
+            digest: z.ZodString;
+            seat_id: z.ZodString;
+            reviewer: z.ZodString;
+            status: z.ZodEnum<["completed", "failed"]>;
+            verdict: z.ZodEnum<["approve", "request_changes", "abstain"]>;
+            score: z.ZodNumber;
+            blockers: z.ZodArray<z.ZodString, "many">;
+            verification_gaps: z.ZodArray<z.ZodString, "many">;
+            findings: z.ZodArray<z.ZodString, "many">;
+        }, "strict", z.ZodTypeAny, {
+            status: "failed" | "completed";
+            schema_version: "review-receipt-v1";
+            score: number;
+            findings: string[];
+            seat_id: string;
+            reviewer: string;
+            workspace_schema: "plan-workspace-v1";
+            digest_profile: "checkpoint-text-v1";
+            review_id: string;
+            repository_id: string;
+            iteration: number;
+            plan_id: string;
+            revision: number;
+            digest: string;
+            verdict: "approve" | "request_changes" | "abstain";
+            blockers: string[];
+            verification_gaps: string[];
+        }, {
+            status: "failed" | "completed";
+            schema_version: "review-receipt-v1";
+            score: number;
+            findings: string[];
+            seat_id: string;
+            reviewer: string;
+            workspace_schema: "plan-workspace-v1";
+            digest_profile: "checkpoint-text-v1";
+            review_id: string;
+            repository_id: string;
+            iteration: number;
+            plan_id: string;
+            revision: number;
+            digest: string;
+            verdict: "approve" | "request_changes" | "abstain";
+            blockers: string[];
+            verification_gaps: string[];
+        }>;
+        seat_id: z.ZodString;
+        internal_call_id: z.ZodString;
+        reviewer: z.ZodString;
+        cli_name: z.ZodEnum<["codex", "claude", "glm", "agy", "grok"]>;
+    }, "strict", z.ZodTypeAny, {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "completed";
+        seat_id: string;
+        reviewer: string;
+        receipt_candidate: {
+            status: "failed" | "completed";
+            schema_version: "review-receipt-v1";
+            score: number;
+            findings: string[];
+            seat_id: string;
+            reviewer: string;
+            workspace_schema: "plan-workspace-v1";
+            digest_profile: "checkpoint-text-v1";
+            review_id: string;
+            repository_id: string;
+            iteration: number;
+            plan_id: string;
+            revision: number;
+            digest: string;
+            verdict: "approve" | "request_changes" | "abstain";
+            blockers: string[];
+            verification_gaps: string[];
+        };
+        internal_call_id: string;
+    }, {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "completed";
+        seat_id: string;
+        reviewer: string;
+        receipt_candidate: {
+            status: "failed" | "completed";
+            schema_version: "review-receipt-v1";
+            score: number;
+            findings: string[];
+            seat_id: string;
+            reviewer: string;
+            workspace_schema: "plan-workspace-v1";
+            digest_profile: "checkpoint-text-v1";
+            review_id: string;
+            repository_id: string;
+            iteration: number;
+            plan_id: string;
+            revision: number;
+            digest: string;
+            verdict: "approve" | "request_changes" | "abstain";
+            blockers: string[];
+            verification_gaps: string[];
+        };
+        internal_call_id: string;
+    }>, z.ZodObject<{
+        execution_status: z.ZodLiteral<"failed">;
+        error: z.ZodObject<{
+            reason: z.ZodEnum<["timeout", "nonzero_exit", "invalid_output", "schema_mismatch", "no_artifact", "cancelled", "internal_error"]>;
+            detail: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            reason: "cancelled" | "timeout" | "nonzero_exit" | "invalid_output" | "schema_mismatch" | "no_artifact" | "internal_error";
+            detail?: string | undefined;
+        }, {
+            reason: "cancelled" | "timeout" | "nonzero_exit" | "invalid_output" | "schema_mismatch" | "no_artifact" | "internal_error";
+            detail?: string | undefined;
+        }>;
+        seat_id: z.ZodString;
+        internal_call_id: z.ZodString;
+        reviewer: z.ZodString;
+        cli_name: z.ZodEnum<["codex", "claude", "glm", "agy", "grok"]>;
+    }, "strict", z.ZodTypeAny, {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "failed";
+        seat_id: string;
+        reviewer: string;
+        internal_call_id: string;
+        error: {
+            reason: "cancelled" | "timeout" | "nonzero_exit" | "invalid_output" | "schema_mismatch" | "no_artifact" | "internal_error";
+            detail?: string | undefined;
+        };
+    }, {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "failed";
+        seat_id: string;
+        reviewer: string;
+        internal_call_id: string;
+        error: {
+            reason: "cancelled" | "timeout" | "nonzero_exit" | "invalid_output" | "schema_mismatch" | "no_artifact" | "internal_error";
+            detail?: string | undefined;
+        };
+    }>, z.ZodObject<{
+        execution_status: z.ZodLiteral<"missing">;
+        error: z.ZodObject<{
+            reason: z.ZodEnum<["timeout", "nonzero_exit", "invalid_output", "schema_mismatch", "no_artifact", "cancelled", "internal_error"]>;
+            detail: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            reason: "cancelled" | "timeout" | "nonzero_exit" | "invalid_output" | "schema_mismatch" | "no_artifact" | "internal_error";
+            detail?: string | undefined;
+        }, {
+            reason: "cancelled" | "timeout" | "nonzero_exit" | "invalid_output" | "schema_mismatch" | "no_artifact" | "internal_error";
+            detail?: string | undefined;
+        }>;
+        seat_id: z.ZodString;
+        internal_call_id: z.ZodString;
+        reviewer: z.ZodString;
+        cli_name: z.ZodEnum<["codex", "claude", "glm", "agy", "grok"]>;
+    }, "strict", z.ZodTypeAny, {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "missing";
+        seat_id: string;
+        reviewer: string;
+        internal_call_id: string;
+        error: {
+            reason: "cancelled" | "timeout" | "nonzero_exit" | "invalid_output" | "schema_mismatch" | "no_artifact" | "internal_error";
+            detail?: string | undefined;
+        };
+    }, {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "missing";
+        seat_id: string;
+        reviewer: string;
+        internal_call_id: string;
+        error: {
+            reason: "cancelled" | "timeout" | "nonzero_exit" | "invalid_output" | "schema_mismatch" | "no_artifact" | "internal_error";
+            detail?: string | undefined;
+        };
+    }>]>, "many">;
+    chairman: z.ZodDiscriminatedUnion<"execution_status", [z.ZodObject<{
+        execution_status: z.ZodLiteral<"completed">;
+        synthesis: z.ZodString;
+        seat_id: z.ZodString;
+        cli_name: z.ZodEnum<["codex", "claude", "glm", "agy", "grok"]>;
+    }, "strict", z.ZodTypeAny, {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "completed";
+        synthesis: string;
+        seat_id: string;
+    }, {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "completed";
+        synthesis: string;
+        seat_id: string;
+    }>, z.ZodObject<{
+        execution_status: z.ZodLiteral<"failed">;
+        seat_id: z.ZodString;
+        cli_name: z.ZodEnum<["codex", "claude", "glm", "agy", "grok"]>;
+    }, "strict", z.ZodTypeAny, {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "failed";
+        seat_id: string;
+    }, {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "failed";
+        seat_id: string;
+    }>, z.ZodObject<{
+        execution_status: z.ZodLiteral<"skipped">;
+        seat_id: z.ZodString;
+        cli_name: z.ZodEnum<["codex", "claude", "glm", "agy", "grok"]>;
+    }, "strict", z.ZodTypeAny, {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "skipped";
+        seat_id: string;
+    }, {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "skipped";
+        seat_id: string;
+    }>]>;
+}, "strict", z.ZodTypeAny, {
+    schema_version: "council-plan-review-result-v1";
+    execution_status: "partial" | "complete";
+    seats: ({
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "completed";
+        seat_id: string;
+        reviewer: string;
+        receipt_candidate: {
+            status: "failed" | "completed";
+            schema_version: "review-receipt-v1";
+            score: number;
+            findings: string[];
+            seat_id: string;
+            reviewer: string;
+            workspace_schema: "plan-workspace-v1";
+            digest_profile: "checkpoint-text-v1";
+            review_id: string;
+            repository_id: string;
+            iteration: number;
+            plan_id: string;
+            revision: number;
+            digest: string;
+            verdict: "approve" | "request_changes" | "abstain";
+            blockers: string[];
+            verification_gaps: string[];
+        };
+        internal_call_id: string;
+    } | {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "failed";
+        seat_id: string;
+        reviewer: string;
+        internal_call_id: string;
+        error: {
+            reason: "cancelled" | "timeout" | "nonzero_exit" | "invalid_output" | "schema_mismatch" | "no_artifact" | "internal_error";
+            detail?: string | undefined;
+        };
+    } | {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "missing";
+        seat_id: string;
+        reviewer: string;
+        internal_call_id: string;
+        error: {
+            reason: "cancelled" | "timeout" | "nonzero_exit" | "invalid_output" | "schema_mismatch" | "no_artifact" | "internal_error";
+            detail?: string | undefined;
+        };
+    })[];
+    execution_contract_digest: string;
+    bindings: {
+        review_id: string;
+        repository_id: string;
+        plan_id: string;
+        revision: number;
+        digest: string;
+        threshold: number;
+        designated_editor: string;
+        chairman_seat: string;
+    };
+    chairman: {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "completed";
+        synthesis: string;
+        seat_id: string;
+    } | {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "failed";
+        seat_id: string;
+    } | {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "skipped";
+        seat_id: string;
+    };
+}, {
+    schema_version: "council-plan-review-result-v1";
+    execution_status: "partial" | "complete";
+    seats: ({
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "completed";
+        seat_id: string;
+        reviewer: string;
+        receipt_candidate: {
+            status: "failed" | "completed";
+            schema_version: "review-receipt-v1";
+            score: number;
+            findings: string[];
+            seat_id: string;
+            reviewer: string;
+            workspace_schema: "plan-workspace-v1";
+            digest_profile: "checkpoint-text-v1";
+            review_id: string;
+            repository_id: string;
+            iteration: number;
+            plan_id: string;
+            revision: number;
+            digest: string;
+            verdict: "approve" | "request_changes" | "abstain";
+            blockers: string[];
+            verification_gaps: string[];
+        };
+        internal_call_id: string;
+    } | {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "failed";
+        seat_id: string;
+        reviewer: string;
+        internal_call_id: string;
+        error: {
+            reason: "cancelled" | "timeout" | "nonzero_exit" | "invalid_output" | "schema_mismatch" | "no_artifact" | "internal_error";
+            detail?: string | undefined;
+        };
+    } | {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "missing";
+        seat_id: string;
+        reviewer: string;
+        internal_call_id: string;
+        error: {
+            reason: "cancelled" | "timeout" | "nonzero_exit" | "invalid_output" | "schema_mismatch" | "no_artifact" | "internal_error";
+            detail?: string | undefined;
+        };
+    })[];
+    execution_contract_digest: string;
+    bindings: {
+        review_id: string;
+        repository_id: string;
+        plan_id: string;
+        revision: number;
+        digest: string;
+        threshold: number;
+        designated_editor: string;
+        chairman_seat: string;
+    };
+    chairman: {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "completed";
+        synthesis: string;
+        seat_id: string;
+    } | {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "failed";
+        seat_id: string;
+    } | {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "skipped";
+        seat_id: string;
+    };
+}>, {
+    schema_version: "council-plan-review-result-v1";
+    execution_status: "partial" | "complete";
+    seats: ({
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "completed";
+        seat_id: string;
+        reviewer: string;
+        receipt_candidate: {
+            status: "failed" | "completed";
+            schema_version: "review-receipt-v1";
+            score: number;
+            findings: string[];
+            seat_id: string;
+            reviewer: string;
+            workspace_schema: "plan-workspace-v1";
+            digest_profile: "checkpoint-text-v1";
+            review_id: string;
+            repository_id: string;
+            iteration: number;
+            plan_id: string;
+            revision: number;
+            digest: string;
+            verdict: "approve" | "request_changes" | "abstain";
+            blockers: string[];
+            verification_gaps: string[];
+        };
+        internal_call_id: string;
+    } | {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "failed";
+        seat_id: string;
+        reviewer: string;
+        internal_call_id: string;
+        error: {
+            reason: "cancelled" | "timeout" | "nonzero_exit" | "invalid_output" | "schema_mismatch" | "no_artifact" | "internal_error";
+            detail?: string | undefined;
+        };
+    } | {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "missing";
+        seat_id: string;
+        reviewer: string;
+        internal_call_id: string;
+        error: {
+            reason: "cancelled" | "timeout" | "nonzero_exit" | "invalid_output" | "schema_mismatch" | "no_artifact" | "internal_error";
+            detail?: string | undefined;
+        };
+    })[];
+    execution_contract_digest: string;
+    bindings: {
+        review_id: string;
+        repository_id: string;
+        plan_id: string;
+        revision: number;
+        digest: string;
+        threshold: number;
+        designated_editor: string;
+        chairman_seat: string;
+    };
+    chairman: {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "completed";
+        synthesis: string;
+        seat_id: string;
+    } | {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "failed";
+        seat_id: string;
+    } | {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "skipped";
+        seat_id: string;
+    };
+}, {
+    schema_version: "council-plan-review-result-v1";
+    execution_status: "partial" | "complete";
+    seats: ({
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "completed";
+        seat_id: string;
+        reviewer: string;
+        receipt_candidate: {
+            status: "failed" | "completed";
+            schema_version: "review-receipt-v1";
+            score: number;
+            findings: string[];
+            seat_id: string;
+            reviewer: string;
+            workspace_schema: "plan-workspace-v1";
+            digest_profile: "checkpoint-text-v1";
+            review_id: string;
+            repository_id: string;
+            iteration: number;
+            plan_id: string;
+            revision: number;
+            digest: string;
+            verdict: "approve" | "request_changes" | "abstain";
+            blockers: string[];
+            verification_gaps: string[];
+        };
+        internal_call_id: string;
+    } | {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "failed";
+        seat_id: string;
+        reviewer: string;
+        internal_call_id: string;
+        error: {
+            reason: "cancelled" | "timeout" | "nonzero_exit" | "invalid_output" | "schema_mismatch" | "no_artifact" | "internal_error";
+            detail?: string | undefined;
+        };
+    } | {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "missing";
+        seat_id: string;
+        reviewer: string;
+        internal_call_id: string;
+        error: {
+            reason: "cancelled" | "timeout" | "nonzero_exit" | "invalid_output" | "schema_mismatch" | "no_artifact" | "internal_error";
+            detail?: string | undefined;
+        };
+    })[];
+    execution_contract_digest: string;
+    bindings: {
+        review_id: string;
+        repository_id: string;
+        plan_id: string;
+        revision: number;
+        digest: string;
+        threshold: number;
+        designated_editor: string;
+        chairman_seat: string;
+    };
+    chairman: {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "completed";
+        synthesis: string;
+        seat_id: string;
+    } | {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "failed";
+        seat_id: string;
+    } | {
+        cli_name: "codex" | "claude" | "glm" | "agy" | "grok";
+        execution_status: "skipped";
+        seat_id: string;
+    };
+}>;
+export type CouncilPlanReviewResult = z.infer<typeof CouncilPlanReviewResultSchema>;