@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/schemas/ci/ci-status-response.schema.d.ts

@@ -0,0 +1,554 @@
+import { z } from 'zod';
+/** Per-PR CI truth classification — GitHub-evidence only; SHA inequality is not supersession. */
+export declare const CiPrClassificationSchema: z.ZodEnum<["open_failed", "open_pending", "open_green", "open_behind_main", "closed_superseded", "merged", "manual_review"]>;
+export declare const CiPrSupersededEvidenceSchema: z.ZodObject<{
+    kind: z.ZodEnum<["merged", "closed_marker", "commits_reachable", "superseding_pr"]>;
+    detail: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    kind: "merged" | "closed_marker" | "commits_reachable" | "superseding_pr";
+    detail: string;
+}, {
+    kind: "merged" | "closed_marker" | "commits_reachable" | "superseding_pr";
+    detail: string;
+}>;
+export declare const CiPrSupersededEvidenceNullableSchema: z.ZodNullable<z.ZodObject<{
+    kind: z.ZodEnum<["merged", "closed_marker", "commits_reachable", "superseding_pr"]>;
+    detail: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    kind: "merged" | "closed_marker" | "commits_reachable" | "superseding_pr";
+    detail: string;
+}, {
+    kind: "merged" | "closed_marker" | "commits_reachable" | "superseding_pr";
+    detail: string;
+}>>;
+export declare const CiStatusPerPrEntrySchema: z.ZodObject<{
+    prNumber: z.ZodNumber;
+    headSha: z.ZodString;
+    conclusion: z.ZodNullable<z.ZodString>;
+    blocking: z.ZodBoolean;
+    reason: z.ZodNullable<z.ZodString>;
+    classification: z.ZodEnum<["open_failed", "open_pending", "open_green", "open_behind_main", "closed_superseded", "merged", "manual_review"]>;
+    rawConclusion: z.ZodNullable<z.ZodString>;
+    githubState: z.ZodEnum<["open", "closed", "merged"]>;
+    mergeableState: z.ZodNullable<z.ZodString>;
+    baseSha: z.ZodNullable<z.ZodString>;
+    mainTipSha: z.ZodNullable<z.ZodString>;
+    commitsBehindMain: z.ZodNullable<z.ZodNumber>;
+    supersededEvidence: z.ZodNullable<z.ZodObject<{
+        kind: z.ZodEnum<["merged", "closed_marker", "commits_reachable", "superseding_pr"]>;
+        detail: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "merged" | "closed_marker" | "commits_reachable" | "superseding_pr";
+        detail: string;
+    }, {
+        kind: "merged" | "closed_marker" | "commits_reachable" | "superseding_pr";
+        detail: string;
+    }>>;
+    recommendedAction: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    reason: string | null;
+    conclusion: string | null;
+    prNumber: number;
+    recommendedAction: string;
+    headSha: string;
+    blocking: boolean;
+    classification: "open_failed" | "open_pending" | "open_green" | "open_behind_main" | "closed_superseded" | "merged" | "manual_review";
+    rawConclusion: string | null;
+    githubState: "merged" | "open" | "closed";
+    mergeableState: string | null;
+    baseSha: string | null;
+    mainTipSha: string | null;
+    commitsBehindMain: number | null;
+    supersededEvidence: {
+        kind: "merged" | "closed_marker" | "commits_reachable" | "superseding_pr";
+        detail: string;
+    } | null;
+}, {
+    reason: string | null;
+    conclusion: string | null;
+    prNumber: number;
+    recommendedAction: string;
+    headSha: string;
+    blocking: boolean;
+    classification: "open_failed" | "open_pending" | "open_green" | "open_behind_main" | "closed_superseded" | "merged" | "manual_review";
+    rawConclusion: string | null;
+    githubState: "merged" | "open" | "closed";
+    mergeableState: string | null;
+    baseSha: string | null;
+    mainTipSha: string | null;
+    commitsBehindMain: number | null;
+    supersededEvidence: {
+        kind: "merged" | "closed_marker" | "commits_reachable" | "superseding_pr";
+        detail: string;
+    } | null;
+}>;
+/** Canonical 7-state CI readiness machine; consumed by UI for state-driven rendering. */
+export declare const CiStatusStateSchema: z.ZodEnum<["repo_not_connected", "repo_connected_no_workflow_file", "workflow_artifact_generated_not_applied", "workflow_pr_open", "workflow_file_present_no_runs", "ci_runs_present", "ci_ready", "ci_ready_not_deployable"]>;
+/** Canonical CI/CD readiness aggregator — `/api/projects/:id/ci/status`. */
+export declare const CiStatusResponseSchema: z.ZodObject<{
+    state: z.ZodEnum<["repo_not_connected", "repo_connected_no_workflow_file", "workflow_artifact_generated_not_applied", "workflow_pr_open", "workflow_file_present_no_runs", "ci_runs_present", "ci_ready", "ci_ready_not_deployable"]>;
+    ready: z.ZodBoolean;
+    required: z.ZodBoolean;
+    blockers: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        code: string;
+        message: string;
+    }, {
+        code: string;
+        message: string;
+    }>, "many">;
+    repository: z.ZodObject<{
+        connected: z.ZodBoolean;
+        fullName: z.ZodNullable<z.ZodString>;
+        defaultBranch: z.ZodNullable<z.ZodString>;
+        linkedAt: z.ZodNullable<z.ZodString>;
+        defaultBranchTipSha: z.ZodNullable<z.ZodString>;
+        defaultBranchTipCapturedAt: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        fullName: string | null;
+        defaultBranch: string | null;
+        connected: boolean;
+        linkedAt: string | null;
+        defaultBranchTipSha: string | null;
+        defaultBranchTipCapturedAt: string | null;
+    }, {
+        fullName: string | null;
+        defaultBranch: string | null;
+        connected: boolean;
+        linkedAt: string | null;
+        defaultBranchTipSha: string | null;
+        defaultBranchTipCapturedAt: string | null;
+    }>;
+    workflow: z.ZodObject<{
+        artifactId: z.ZodNullable<z.ZodString>;
+        artifactGenerated: z.ZodBoolean;
+        artifactCreatedAt: z.ZodNullable<z.ZodString>;
+        applied: z.ZodBoolean;
+        appliedAt: z.ZodNullable<z.ZodString>;
+        pr: z.ZodNullable<z.ZodObject<{
+            url: z.ZodString;
+            number: z.ZodNumber;
+            state: z.ZodEnum<["open", "closed", "merged"]>;
+            branchName: z.ZodString;
+            commitSha: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            number: number;
+            url: string;
+            commitSha: string;
+            state: "merged" | "open" | "closed";
+            branchName: string;
+        }, {
+            number: number;
+            url: string;
+            commitSha: string;
+            state: "merged" | "open" | "closed";
+            branchName: string;
+        }>>;
+        pathInRepo: z.ZodNullable<z.ZodString>;
+        fileExistsInRepoOnDefaultBranch: z.ZodBoolean;
+        validationActionlintExecuted: z.ZodBoolean;
+        validationWarning: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        artifactId: string | null;
+        applied: boolean;
+        artifactGenerated: boolean;
+        artifactCreatedAt: string | null;
+        appliedAt: string | null;
+        pr: {
+            number: number;
+            url: string;
+            commitSha: string;
+            state: "merged" | "open" | "closed";
+            branchName: string;
+        } | null;
+        pathInRepo: string | null;
+        fileExistsInRepoOnDefaultBranch: boolean;
+        validationActionlintExecuted: boolean;
+        validationWarning: string | null;
+    }, {
+        artifactId: string | null;
+        applied: boolean;
+        artifactGenerated: boolean;
+        artifactCreatedAt: string | null;
+        appliedAt: string | null;
+        pr: {
+            number: number;
+            url: string;
+            commitSha: string;
+            state: "merged" | "open" | "closed";
+            branchName: string;
+        } | null;
+        pathInRepo: string | null;
+        fileExistsInRepoOnDefaultBranch: boolean;
+        validationActionlintExecuted: boolean;
+        validationWarning: string | null;
+    }>;
+    runs: z.ZodObject<{
+        latestConclusion: z.ZodNullable<z.ZodEnum<["success", "failure", "cancelled", "timed_out", "action_required", "neutral", "skipped"]>>;
+        latestStartedAt: z.ZodNullable<z.ZodString>;
+        count: z.ZodNumber;
+        latestSuccessful: z.ZodNullable<z.ZodObject<{
+            headSha: z.ZodString;
+            conclusion: z.ZodEnum<["success", "failure", "cancelled", "timed_out", "action_required", "neutral", "skipped"]>;
+            startedAt: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            conclusion: "success" | "neutral" | "skipped" | "cancelled" | "failure" | "timed_out" | "action_required";
+            startedAt: string | null;
+            headSha: string;
+        }, {
+            conclusion: "success" | "neutral" | "skipped" | "cancelled" | "failure" | "timed_out" | "action_required";
+            startedAt: string | null;
+            headSha: string;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        count: number;
+        latestConclusion: "success" | "neutral" | "skipped" | "cancelled" | "failure" | "timed_out" | "action_required" | null;
+        latestStartedAt: string | null;
+        latestSuccessful: {
+            conclusion: "success" | "neutral" | "skipped" | "cancelled" | "failure" | "timed_out" | "action_required";
+            startedAt: string | null;
+            headSha: string;
+        } | null;
+    }, {
+        count: number;
+        latestConclusion: "success" | "neutral" | "skipped" | "cancelled" | "failure" | "timed_out" | "action_required" | null;
+        latestStartedAt: string | null;
+        latestSuccessful: {
+            conclusion: "success" | "neutral" | "skipped" | "cancelled" | "failure" | "timed_out" | "action_required";
+            startedAt: string | null;
+            headSha: string;
+        } | null;
+    }>;
+    checks: z.ZodObject<{
+        perPr: z.ZodArray<z.ZodObject<{
+            prNumber: z.ZodNumber;
+            headSha: z.ZodString;
+            conclusion: z.ZodNullable<z.ZodString>;
+            blocking: z.ZodBoolean;
+            reason: z.ZodNullable<z.ZodString>;
+            classification: z.ZodEnum<["open_failed", "open_pending", "open_green", "open_behind_main", "closed_superseded", "merged", "manual_review"]>;
+            rawConclusion: z.ZodNullable<z.ZodString>;
+            githubState: z.ZodEnum<["open", "closed", "merged"]>;
+            mergeableState: z.ZodNullable<z.ZodString>;
+            baseSha: z.ZodNullable<z.ZodString>;
+            mainTipSha: z.ZodNullable<z.ZodString>;
+            commitsBehindMain: z.ZodNullable<z.ZodNumber>;
+            supersededEvidence: z.ZodNullable<z.ZodObject<{
+                kind: z.ZodEnum<["merged", "closed_marker", "commits_reachable", "superseding_pr"]>;
+                detail: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                kind: "merged" | "closed_marker" | "commits_reachable" | "superseding_pr";
+                detail: string;
+            }, {
+                kind: "merged" | "closed_marker" | "commits_reachable" | "superseding_pr";
+                detail: string;
+            }>>;
+            recommendedAction: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            reason: string | null;
+            conclusion: string | null;
+            prNumber: number;
+            recommendedAction: string;
+            headSha: string;
+            blocking: boolean;
+            classification: "open_failed" | "open_pending" | "open_green" | "open_behind_main" | "closed_superseded" | "merged" | "manual_review";
+            rawConclusion: string | null;
+            githubState: "merged" | "open" | "closed";
+            mergeableState: string | null;
+            baseSha: string | null;
+            mainTipSha: string | null;
+            commitsBehindMain: number | null;
+            supersededEvidence: {
+                kind: "merged" | "closed_marker" | "commits_reachable" | "superseding_pr";
+                detail: string;
+            } | null;
+        }, {
+            reason: string | null;
+            conclusion: string | null;
+            prNumber: number;
+            recommendedAction: string;
+            headSha: string;
+            blocking: boolean;
+            classification: "open_failed" | "open_pending" | "open_green" | "open_behind_main" | "closed_superseded" | "merged" | "manual_review";
+            rawConclusion: string | null;
+            githubState: "merged" | "open" | "closed";
+            mergeableState: string | null;
+            baseSha: string | null;
+            mainTipSha: string | null;
+            commitsBehindMain: number | null;
+            supersededEvidence: {
+                kind: "merged" | "closed_marker" | "commits_reachable" | "superseding_pr";
+                detail: string;
+            } | null;
+        }>, "many">;
+        branchHead: z.ZodUnion<[z.ZodObject<{
+            headSha: z.ZodString;
+            workflowRunBlocking: z.ZodBoolean;
+            workflowRunReason: z.ZodNullable<z.ZodString>;
+            workflowRunLatestConclusion: z.ZodNullable<z.ZodEnum<["success", "failure", "cancelled", "timed_out", "action_required", "neutral", "skipped"]>>;
+            checksBlocking: z.ZodBoolean;
+            checksReason: z.ZodNullable<z.ZodString>;
+            checkRunCount: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            headSha: string;
+            workflowRunBlocking: boolean;
+            workflowRunReason: string | null;
+            workflowRunLatestConclusion: "success" | "neutral" | "skipped" | "cancelled" | "failure" | "timed_out" | "action_required" | null;
+            checksBlocking: boolean;
+            checksReason: string | null;
+            checkRunCount: number;
+        }, {
+            headSha: string;
+            workflowRunBlocking: boolean;
+            workflowRunReason: string | null;
+            workflowRunLatestConclusion: "success" | "neutral" | "skipped" | "cancelled" | "failure" | "timed_out" | "action_required" | null;
+            checksBlocking: boolean;
+            checksReason: string | null;
+            checkRunCount: number;
+        }>, z.ZodNull]>;
+    }, "strip", z.ZodTypeAny, {
+        perPr: {
+            reason: string | null;
+            conclusion: string | null;
+            prNumber: number;
+            recommendedAction: string;
+            headSha: string;
+            blocking: boolean;
+            classification: "open_failed" | "open_pending" | "open_green" | "open_behind_main" | "closed_superseded" | "merged" | "manual_review";
+            rawConclusion: string | null;
+            githubState: "merged" | "open" | "closed";
+            mergeableState: string | null;
+            baseSha: string | null;
+            mainTipSha: string | null;
+            commitsBehindMain: number | null;
+            supersededEvidence: {
+                kind: "merged" | "closed_marker" | "commits_reachable" | "superseding_pr";
+                detail: string;
+            } | null;
+        }[];
+        branchHead: {
+            headSha: string;
+            workflowRunBlocking: boolean;
+            workflowRunReason: string | null;
+            workflowRunLatestConclusion: "success" | "neutral" | "skipped" | "cancelled" | "failure" | "timed_out" | "action_required" | null;
+            checksBlocking: boolean;
+            checksReason: string | null;
+            checkRunCount: number;
+        } | null;
+    }, {
+        perPr: {
+            reason: string | null;
+            conclusion: string | null;
+            prNumber: number;
+            recommendedAction: string;
+            headSha: string;
+            blocking: boolean;
+            classification: "open_failed" | "open_pending" | "open_green" | "open_behind_main" | "closed_superseded" | "merged" | "manual_review";
+            rawConclusion: string | null;
+            githubState: "merged" | "open" | "closed";
+            mergeableState: string | null;
+            baseSha: string | null;
+            mainTipSha: string | null;
+            commitsBehindMain: number | null;
+            supersededEvidence: {
+                kind: "merged" | "closed_marker" | "commits_reachable" | "superseding_pr";
+                detail: string;
+            } | null;
+        }[];
+        branchHead: {
+            headSha: string;
+            workflowRunBlocking: boolean;
+            workflowRunReason: string | null;
+            workflowRunLatestConclusion: "success" | "neutral" | "skipped" | "cancelled" | "failure" | "timed_out" | "action_required" | null;
+            checksBlocking: boolean;
+            checksReason: string | null;
+            checkRunCount: number;
+        } | null;
+    }>;
+    step: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<["pending", "in_progress", "completed", "blocked"]>;
+        state: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        status: "completed" | "blocked" | "pending" | "in_progress";
+        state?: string | undefined;
+    }, {
+        status: "completed" | "blocked" | "pending" | "in_progress";
+        state?: string | undefined;
+    }>>;
+    meta: z.ZodObject<{
+        lastSyncAt: z.ZodNullable<z.ZodString>;
+        lastWebhookEventAt: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        lastSyncAt: string | null;
+        lastWebhookEventAt: string | null;
+    }, {
+        lastSyncAt: string | null;
+        lastWebhookEventAt: string | null;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    required: boolean;
+    repository: {
+        fullName: string | null;
+        defaultBranch: string | null;
+        connected: boolean;
+        linkedAt: string | null;
+        defaultBranchTipSha: string | null;
+        defaultBranchTipCapturedAt: string | null;
+    };
+    ready: boolean;
+    blockers: {
+        code: string;
+        message: string;
+    }[];
+    state: "repo_not_connected" | "repo_connected_no_workflow_file" | "workflow_artifact_generated_not_applied" | "workflow_pr_open" | "workflow_file_present_no_runs" | "ci_runs_present" | "ci_ready" | "ci_ready_not_deployable";
+    meta: {
+        lastSyncAt: string | null;
+        lastWebhookEventAt: string | null;
+    };
+    checks: {
+        perPr: {
+            reason: string | null;
+            conclusion: string | null;
+            prNumber: number;
+            recommendedAction: string;
+            headSha: string;
+            blocking: boolean;
+            classification: "open_failed" | "open_pending" | "open_green" | "open_behind_main" | "closed_superseded" | "merged" | "manual_review";
+            rawConclusion: string | null;
+            githubState: "merged" | "open" | "closed";
+            mergeableState: string | null;
+            baseSha: string | null;
+            mainTipSha: string | null;
+            commitsBehindMain: number | null;
+            supersededEvidence: {
+                kind: "merged" | "closed_marker" | "commits_reachable" | "superseding_pr";
+                detail: string;
+            } | null;
+        }[];
+        branchHead: {
+            headSha: string;
+            workflowRunBlocking: boolean;
+            workflowRunReason: string | null;
+            workflowRunLatestConclusion: "success" | "neutral" | "skipped" | "cancelled" | "failure" | "timed_out" | "action_required" | null;
+            checksBlocking: boolean;
+            checksReason: string | null;
+            checkRunCount: number;
+        } | null;
+    };
+    runs: {
+        count: number;
+        latestConclusion: "success" | "neutral" | "skipped" | "cancelled" | "failure" | "timed_out" | "action_required" | null;
+        latestStartedAt: string | null;
+        latestSuccessful: {
+            conclusion: "success" | "neutral" | "skipped" | "cancelled" | "failure" | "timed_out" | "action_required";
+            startedAt: string | null;
+            headSha: string;
+        } | null;
+    };
+    workflow: {
+        artifactId: string | null;
+        applied: boolean;
+        artifactGenerated: boolean;
+        artifactCreatedAt: string | null;
+        appliedAt: string | null;
+        pr: {
+            number: number;
+            url: string;
+            commitSha: string;
+            state: "merged" | "open" | "closed";
+            branchName: string;
+        } | null;
+        pathInRepo: string | null;
+        fileExistsInRepoOnDefaultBranch: boolean;
+        validationActionlintExecuted: boolean;
+        validationWarning: string | null;
+    };
+    step?: {
+        status: "completed" | "blocked" | "pending" | "in_progress";
+        state?: string | undefined;
+    } | undefined;
+}, {
+    required: boolean;
+    repository: {
+        fullName: string | null;
+        defaultBranch: string | null;
+        connected: boolean;
+        linkedAt: string | null;
+        defaultBranchTipSha: string | null;
+        defaultBranchTipCapturedAt: string | null;
+    };
+    ready: boolean;
+    blockers: {
+        code: string;
+        message: string;
+    }[];
+    state: "repo_not_connected" | "repo_connected_no_workflow_file" | "workflow_artifact_generated_not_applied" | "workflow_pr_open" | "workflow_file_present_no_runs" | "ci_runs_present" | "ci_ready" | "ci_ready_not_deployable";
+    meta: {
+        lastSyncAt: string | null;
+        lastWebhookEventAt: string | null;
+    };
+    checks: {
+        perPr: {
+            reason: string | null;
+            conclusion: string | null;
+            prNumber: number;
+            recommendedAction: string;
+            headSha: string;
+            blocking: boolean;
+            classification: "open_failed" | "open_pending" | "open_green" | "open_behind_main" | "closed_superseded" | "merged" | "manual_review";
+            rawConclusion: string | null;
+            githubState: "merged" | "open" | "closed";
+            mergeableState: string | null;
+            baseSha: string | null;
+            mainTipSha: string | null;
+            commitsBehindMain: number | null;
+            supersededEvidence: {
+                kind: "merged" | "closed_marker" | "commits_reachable" | "superseding_pr";
+                detail: string;
+            } | null;
+        }[];
+        branchHead: {
+            headSha: string;
+            workflowRunBlocking: boolean;
+            workflowRunReason: string | null;
+            workflowRunLatestConclusion: "success" | "neutral" | "skipped" | "cancelled" | "failure" | "timed_out" | "action_required" | null;
+            checksBlocking: boolean;
+            checksReason: string | null;
+            checkRunCount: number;
+        } | null;
+    };
+    runs: {
+        count: number;
+        latestConclusion: "success" | "neutral" | "skipped" | "cancelled" | "failure" | "timed_out" | "action_required" | null;
+        latestStartedAt: string | null;
+        latestSuccessful: {
+            conclusion: "success" | "neutral" | "skipped" | "cancelled" | "failure" | "timed_out" | "action_required";
+            startedAt: string | null;
+            headSha: string;
+        } | null;
+    };
+    workflow: {
+        artifactId: string | null;
+        applied: boolean;
+        artifactGenerated: boolean;
+        artifactCreatedAt: string | null;
+        appliedAt: string | null;
+        pr: {
+            number: number;
+            url: string;
+            commitSha: string;
+            state: "merged" | "open" | "closed";
+            branchName: string;
+        } | null;
+        pathInRepo: string | null;
+        fileExistsInRepoOnDefaultBranch: boolean;
+        validationActionlintExecuted: boolean;
+        validationWarning: string | null;
+    };
+    step?: {
+        status: "completed" | "blocked" | "pending" | "in_progress";
+        state?: string | undefined;
+    } | undefined;
+}>;