@neuraloom/contracts 0.0.0-stage → 0.1.23

package/dist/schemas/workflow-progression.d.ts

@@ -0,0 +1,1955 @@
+/**
+ * Workflow progression (per-step status) — Zod + inferred types
+ */
+import { z } from "zod";
+/** Canonical per-step status for workflow UI (sidebar, cards, body) — single union. */
+export declare const WorkflowNormalizedStepStatusSchema: z.ZodEnum<["not_started", "running", "completed", "completed_with_errors", "halted", "failed", "blocked", "evidence_conflict", "unavailable", "coming_soon"]>;
+export type WorkflowNormalizedStepStatus = z.infer<typeof WorkflowNormalizedStepStatusSchema>;
+/** Steps with no shipped page yet — extend when product adds stubs. */
+export declare const WORKFLOW_STEP_IDS_COMING_SOON: readonly ["monitor"];
+/** Steps whose route exists but is not wired — extend when a page is a known no-op. */
+export declare const WORKFLOW_STEP_IDS_UNAVAILABLE_ROUTE: readonly [];
+export declare const WorkflowStepStatusSchema: z.ZodEnum<["complete", "pending", "blocked", "stale", "generating"]>;
+export declare const WorkflowStepBlockedBySchema: z.ZodNullable<z.ZodEnum<["plan"]>>;
+export declare const WorkflowPhaseGuardianLockSchema: z.ZodObject<{
+    navPhaseTitle: z.ZodString;
+    scoreDisplay: z.ZodNumber;
+    threshold: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    navPhaseTitle: string;
+    scoreDisplay: number;
+    threshold: number;
+}, {
+    navPhaseTitle: string;
+    scoreDisplay: number;
+    threshold: number;
+}>;
+export declare const WorkflowStepProgressionEntrySchema: z.ZodObject<{
+    status: z.ZodEnum<["complete", "pending", "blocked", "stale", "generating"]>;
+    count: z.ZodNumber;
+    blockedBy: z.ZodOptional<z.ZodNullable<z.ZodEnum<["plan"]>>>;
+    phaseGuardianLock: z.ZodOptional<z.ZodObject<{
+        navPhaseTitle: z.ZodString;
+        scoreDisplay: z.ZodNumber;
+        threshold: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        navPhaseTitle: string;
+        scoreDisplay: number;
+        threshold: number;
+    }, {
+        navPhaseTitle: string;
+        scoreDisplay: number;
+        threshold: number;
+    }>>;
+    /** ISO timestamp of the latest successful completion for this step, when known. */
+    lastCompletedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Guardian score from the most recent `ai_runs` row for this step (any status), when present. */
+    lastRunGuardianScore: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodNull]>>;
+}, "strip", z.ZodTypeAny, {
+    status: "complete" | "blocked" | "pending" | "stale" | "generating";
+    count: number;
+    blockedBy?: "plan" | null | undefined;
+    phaseGuardianLock?: {
+        navPhaseTitle: string;
+        scoreDisplay: number;
+        threshold: number;
+    } | undefined;
+    lastCompletedAt?: string | null | undefined;
+    lastRunGuardianScore?: number | null | undefined;
+}, {
+    status: "complete" | "blocked" | "pending" | "stale" | "generating";
+    count: number;
+    blockedBy?: "plan" | null | undefined;
+    phaseGuardianLock?: {
+        navPhaseTitle: string;
+        scoreDisplay: number;
+        threshold: number;
+    } | undefined;
+    lastCompletedAt?: string | null | undefined;
+    lastRunGuardianScore?: number | null | undefined;
+}>;
+export declare const WorkflowGateSummarySchema: z.ZodObject<{
+    step: z.ZodString;
+    status: z.ZodString;
+    id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    step: string;
+    id?: string | undefined;
+}, {
+    status: string;
+    step: string;
+    id?: string | undefined;
+}>;
+export declare const WorkflowProgressionDataSchema: z.ZodObject<{
+    steps: z.ZodRecord<z.ZodString, z.ZodObject<{
+        status: z.ZodEnum<["complete", "pending", "blocked", "stale", "generating"]>;
+        count: z.ZodNumber;
+        blockedBy: z.ZodOptional<z.ZodNullable<z.ZodEnum<["plan"]>>>;
+        phaseGuardianLock: z.ZodOptional<z.ZodObject<{
+            navPhaseTitle: z.ZodString;
+            scoreDisplay: z.ZodNumber;
+            threshold: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            navPhaseTitle: string;
+            scoreDisplay: number;
+            threshold: number;
+        }, {
+            navPhaseTitle: string;
+            scoreDisplay: number;
+            threshold: number;
+        }>>;
+        /** ISO timestamp of the latest successful completion for this step, when known. */
+        lastCompletedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Guardian score from the most recent `ai_runs` row for this step (any status), when present. */
+        lastRunGuardianScore: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodNull]>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "complete" | "blocked" | "pending" | "stale" | "generating";
+        count: number;
+        blockedBy?: "plan" | null | undefined;
+        phaseGuardianLock?: {
+            navPhaseTitle: string;
+            scoreDisplay: number;
+            threshold: number;
+        } | undefined;
+        lastCompletedAt?: string | null | undefined;
+        lastRunGuardianScore?: number | null | undefined;
+    }, {
+        status: "complete" | "blocked" | "pending" | "stale" | "generating";
+        count: number;
+        blockedBy?: "plan" | null | undefined;
+        phaseGuardianLock?: {
+            navPhaseTitle: string;
+            scoreDisplay: number;
+            threshold: number;
+        } | undefined;
+        lastCompletedAt?: string | null | undefined;
+        lastRunGuardianScore?: number | null | undefined;
+    }>>;
+    overallGuardianScore: z.ZodUnion<[z.ZodNumber, z.ZodNull]>;
+    activeGates: z.ZodArray<z.ZodObject<{
+        step: z.ZodString;
+        status: z.ZodString;
+        id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        step: string;
+        id?: string | undefined;
+    }, {
+        status: string;
+        step: string;
+        id?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    steps: Record<string, {
+        status: "complete" | "blocked" | "pending" | "stale" | "generating";
+        count: number;
+        blockedBy?: "plan" | null | undefined;
+        phaseGuardianLock?: {
+            navPhaseTitle: string;
+            scoreDisplay: number;
+            threshold: number;
+        } | undefined;
+        lastCompletedAt?: string | null | undefined;
+        lastRunGuardianScore?: number | null | undefined;
+    }>;
+    overallGuardianScore: number | null;
+    activeGates: {
+        status: string;
+        step: string;
+        id?: string | undefined;
+    }[];
+}, {
+    steps: Record<string, {
+        status: "complete" | "blocked" | "pending" | "stale" | "generating";
+        count: number;
+        blockedBy?: "plan" | null | undefined;
+        phaseGuardianLock?: {
+            navPhaseTitle: string;
+            scoreDisplay: number;
+            threshold: number;
+        } | undefined;
+        lastCompletedAt?: string | null | undefined;
+        lastRunGuardianScore?: number | null | undefined;
+    }>;
+    overallGuardianScore: number | null;
+    activeGates: {
+        status: string;
+        step: string;
+        id?: string | undefined;
+    }[];
+}>;
+export type WorkflowStepProgressionStatus = z.infer<typeof WorkflowStepStatusSchema>;
+export type WorkflowStepProgressionEntry = z.infer<typeof WorkflowStepProgressionEntrySchema>;
+export type WorkflowProgressionData = z.infer<typeof WorkflowProgressionDataSchema>;
+export type WorkflowPhaseGuardianLock = z.infer<typeof WorkflowPhaseGuardianLockSchema>;
+export declare const PipelineStageStateSchema: z.ZodObject<{
+    stageId: z.ZodString;
+    status: z.ZodEnum<["not_started", "accepted", "rejected", "validating", "pending"]>;
+    guardianScore: z.ZodUnion<[z.ZodNumber, z.ZodNull]>;
+    artifactId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodNullable<z.ZodString>;
+    domainSummary: z.ZodString;
+    /** CI validation depth (e.g. actionlint skipped → partial). */
+    validationLevel: z.ZodOptional<z.ZodEnum<["full", "partial"]>>;
+}, "strip", z.ZodTypeAny, {
+    status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+    artifactId: string | null;
+    stageId: string;
+    guardianScore: number | null;
+    createdAt: string | null;
+    domainSummary: string;
+    validationLevel?: "partial" | "full" | undefined;
+}, {
+    status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+    artifactId: string | null;
+    stageId: string;
+    guardianScore: number | null;
+    createdAt: string | null;
+    domainSummary: string;
+    validationLevel?: "partial" | "full" | undefined;
+}>;
+export declare const WorkflowGateStateSchema: z.ZodObject<{
+    gateId: z.ZodString;
+    type: z.ZodString;
+    status: z.ZodString;
+    requiredApprover: z.ZodNullable<z.ZodString>;
+    resolvedAt: z.ZodNullable<z.ZodString>;
+    decision: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    status: string;
+    gateId: string;
+    requiredApprover: string | null;
+    resolvedAt: string | null;
+    decision: string | null;
+}, {
+    type: string;
+    status: string;
+    gateId: string;
+    requiredApprover: string | null;
+    resolvedAt: string | null;
+    decision: string | null;
+}>;
+/** Three-way UI categorization for workflow step pipeline/gate readiness (#376). */
+export declare const WorkflowStepBlockBucketsSchema: z.ZodObject<{
+    /** Preconditions that disable Generate / must clear before continuing */
+    hardBlockers: z.ZodArray<z.ZodString, "many">;
+    /** Quality/upstream cues — Generate remains allowed */
+    warnings: z.ZodArray<z.ZodString, "many">;
+    /** Missing stage outputs — work in flight, not gating Generate */
+    pendingStages: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    pendingStages: string[];
+    warnings: string[];
+    hardBlockers: string[];
+}, {
+    pendingStages: string[];
+    warnings: string[];
+    hardBlockers: string[];
+}>;
+export type WorkflowStepBlockBuckets = z.infer<typeof WorkflowStepBlockBucketsSchema>;
+export declare const WorkflowStepStateSchema: z.ZodObject<{
+    gates: z.ZodArray<z.ZodObject<{
+        gateId: z.ZodString;
+        type: z.ZodString;
+        status: z.ZodString;
+        requiredApprover: z.ZodNullable<z.ZodString>;
+        resolvedAt: z.ZodNullable<z.ZodString>;
+        decision: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        status: string;
+        gateId: string;
+        requiredApprover: string | null;
+        resolvedAt: string | null;
+        decision: string | null;
+    }, {
+        type: string;
+        status: string;
+        gateId: string;
+        requiredApprover: string | null;
+        resolvedAt: string | null;
+        decision: string | null;
+    }>, "many">;
+    /** Evidence resolution source for aliased software_app steps (#1062). */
+    evidenceSource: z.ZodOptional<z.ZodEnum<["registry", "legacy_compat", "mixed_invalid", "incomplete"]>>;
+    evidenceWarnings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Preconditions that disable Generate / must clear before continuing */
+    hardBlockers: z.ZodArray<z.ZodString, "many">;
+    /** Quality/upstream cues — Generate remains allowed */
+    warnings: z.ZodArray<z.ZodString, "many">;
+    /** Missing stage outputs — work in flight, not gating Generate */
+    pendingStages: z.ZodArray<z.ZodString, "many">;
+    id: z.ZodString;
+    stepId: z.ZodString;
+    name: z.ZodString;
+    phase: z.ZodString;
+    phaseIndex: z.ZodNumber;
+    stepIndex: z.ZodNumber;
+    pageRoute: z.ZodString;
+    status: z.ZodEnum<["not_started", "running", "completed", "completed_with_errors", "halted", "failed", "blocked", "evidence_conflict", "unavailable", "coming_soon"]>;
+    complete: z.ZodBoolean;
+    completionReasons: z.ZodArray<z.ZodString, "many">;
+    pipeline: z.ZodNullable<z.ZodObject<{
+        stages: z.ZodArray<z.ZodObject<{
+            stageId: z.ZodString;
+            status: z.ZodEnum<["not_started", "accepted", "rejected", "validating", "pending"]>;
+            guardianScore: z.ZodUnion<[z.ZodNumber, z.ZodNull]>;
+            artifactId: z.ZodNullable<z.ZodString>;
+            createdAt: z.ZodNullable<z.ZodString>;
+            domainSummary: z.ZodString;
+            /** CI validation depth (e.g. actionlint skipped → partial). */
+            validationLevel: z.ZodOptional<z.ZodEnum<["full", "partial"]>>;
+        }, "strip", z.ZodTypeAny, {
+            status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+            artifactId: string | null;
+            stageId: string;
+            guardianScore: number | null;
+            createdAt: string | null;
+            domainSummary: string;
+            validationLevel?: "partial" | "full" | undefined;
+        }, {
+            status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+            artifactId: string | null;
+            stageId: string;
+            guardianScore: number | null;
+            createdAt: string | null;
+            domainSummary: string;
+            validationLevel?: "partial" | "full" | undefined;
+        }>, "many">;
+        pendingStages: z.ZodArray<z.ZodString, "many">;
+        rejectedStages: z.ZodArray<z.ZodString, "many">;
+        guardianMin: z.ZodUnion<[z.ZodNumber, z.ZodNull]>;
+    }, "strip", z.ZodTypeAny, {
+        pendingStages: string[];
+        stages: {
+            status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+            artifactId: string | null;
+            stageId: string;
+            guardianScore: number | null;
+            createdAt: string | null;
+            domainSummary: string;
+            validationLevel?: "partial" | "full" | undefined;
+        }[];
+        rejectedStages: string[];
+        guardianMin: number | null;
+    }, {
+        pendingStages: string[];
+        stages: {
+            status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+            artifactId: string | null;
+            stageId: string;
+            guardianScore: number | null;
+            createdAt: string | null;
+            domainSummary: string;
+            validationLevel?: "partial" | "full" | undefined;
+        }[];
+        rejectedStages: string[];
+        guardianMin: number | null;
+    }>>;
+    latestGuardianScore: z.ZodUnion<[z.ZodNumber, z.ZodNull]>;
+    latestArtifactId: z.ZodNullable<z.ZodString>;
+    latestAiRunId: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    status: "not_started" | "running" | "completed" | "completed_with_errors" | "halted" | "failed" | "blocked" | "evidence_conflict" | "unavailable" | "coming_soon";
+    pendingStages: string[];
+    complete: boolean;
+    warnings: string[];
+    stepId: string;
+    hardBlockers: string[];
+    name: string;
+    phase: string;
+    phaseIndex: number;
+    stepIndex: number;
+    pageRoute: string;
+    completionReasons: string[];
+    pipeline: {
+        pendingStages: string[];
+        stages: {
+            status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+            artifactId: string | null;
+            stageId: string;
+            guardianScore: number | null;
+            createdAt: string | null;
+            domainSummary: string;
+            validationLevel?: "partial" | "full" | undefined;
+        }[];
+        rejectedStages: string[];
+        guardianMin: number | null;
+    } | null;
+    latestGuardianScore: number | null;
+    latestArtifactId: string | null;
+    latestAiRunId: string | null;
+    gates: {
+        type: string;
+        status: string;
+        gateId: string;
+        requiredApprover: string | null;
+        resolvedAt: string | null;
+        decision: string | null;
+    }[];
+    evidenceSource?: "registry" | "legacy_compat" | "mixed_invalid" | "incomplete" | undefined;
+    evidenceWarnings?: string[] | undefined;
+}, {
+    id: string;
+    status: "not_started" | "running" | "completed" | "completed_with_errors" | "halted" | "failed" | "blocked" | "evidence_conflict" | "unavailable" | "coming_soon";
+    pendingStages: string[];
+    complete: boolean;
+    warnings: string[];
+    stepId: string;
+    hardBlockers: string[];
+    name: string;
+    phase: string;
+    phaseIndex: number;
+    stepIndex: number;
+    pageRoute: string;
+    completionReasons: string[];
+    pipeline: {
+        pendingStages: string[];
+        stages: {
+            status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+            artifactId: string | null;
+            stageId: string;
+            guardianScore: number | null;
+            createdAt: string | null;
+            domainSummary: string;
+            validationLevel?: "partial" | "full" | undefined;
+        }[];
+        rejectedStages: string[];
+        guardianMin: number | null;
+    } | null;
+    latestGuardianScore: number | null;
+    latestArtifactId: string | null;
+    latestAiRunId: string | null;
+    gates: {
+        type: string;
+        status: string;
+        gateId: string;
+        requiredApprover: string | null;
+        resolvedAt: string | null;
+        decision: string | null;
+    }[];
+    evidenceSource?: "registry" | "legacy_compat" | "mixed_invalid" | "incomplete" | undefined;
+    evidenceWarnings?: string[] | undefined;
+}>;
+export declare const WorkflowStateCommandCenterSchema: z.ZodObject<{
+    /** Latest orchestrations.id for this project (same spine id used across AI runs). */
+    activeOrchestrationId: z.ZodNullable<z.ZodString>;
+    workflowExecutionMode: z.ZodNullable<z.ZodEnum<["build-new", "audit-existing"]>>;
+}, "strip", z.ZodTypeAny, {
+    activeOrchestrationId: string | null;
+    workflowExecutionMode: "build-new" | "audit-existing" | null;
+}, {
+    activeOrchestrationId: string | null;
+    workflowExecutionMode: "build-new" | "audit-existing" | null;
+}>;
+export type WorkflowStateCommandCenter = z.infer<typeof WorkflowStateCommandCenterSchema>;
+export declare const WorkflowStateResponseSchema: z.ZodObject<{
+    project: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        status: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        description: string | null;
+        status: string | null;
+        name: string;
+    }, {
+        id: string;
+        description: string | null;
+        status: string | null;
+        name: string;
+    }>;
+    commandCenter: z.ZodObject<{
+        /** Latest orchestrations.id for this project (same spine id used across AI runs). */
+        activeOrchestrationId: z.ZodNullable<z.ZodString>;
+        workflowExecutionMode: z.ZodNullable<z.ZodEnum<["build-new", "audit-existing"]>>;
+    }, "strip", z.ZodTypeAny, {
+        activeOrchestrationId: string | null;
+        workflowExecutionMode: "build-new" | "audit-existing" | null;
+    }, {
+        activeOrchestrationId: string | null;
+        workflowExecutionMode: "build-new" | "audit-existing" | null;
+    }>;
+    phases: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        number: z.ZodNumber;
+        title: z.ZodString;
+        steps: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        number: number;
+        id: string;
+        title: string;
+        steps: string[];
+    }, {
+        number: number;
+        id: string;
+        title: string;
+        steps: string[];
+    }>, "many">;
+    currentStepId: z.ZodNullable<z.ZodString>;
+    steps: z.ZodArray<z.ZodObject<{
+        gates: z.ZodArray<z.ZodObject<{
+            gateId: z.ZodString;
+            type: z.ZodString;
+            status: z.ZodString;
+            requiredApprover: z.ZodNullable<z.ZodString>;
+            resolvedAt: z.ZodNullable<z.ZodString>;
+            decision: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            status: string;
+            gateId: string;
+            requiredApprover: string | null;
+            resolvedAt: string | null;
+            decision: string | null;
+        }, {
+            type: string;
+            status: string;
+            gateId: string;
+            requiredApprover: string | null;
+            resolvedAt: string | null;
+            decision: string | null;
+        }>, "many">;
+        /** Evidence resolution source for aliased software_app steps (#1062). */
+        evidenceSource: z.ZodOptional<z.ZodEnum<["registry", "legacy_compat", "mixed_invalid", "incomplete"]>>;
+        evidenceWarnings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Preconditions that disable Generate / must clear before continuing */
+        hardBlockers: z.ZodArray<z.ZodString, "many">;
+        /** Quality/upstream cues — Generate remains allowed */
+        warnings: z.ZodArray<z.ZodString, "many">;
+        /** Missing stage outputs — work in flight, not gating Generate */
+        pendingStages: z.ZodArray<z.ZodString, "many">;
+        id: z.ZodString;
+        stepId: z.ZodString;
+        name: z.ZodString;
+        phase: z.ZodString;
+        phaseIndex: z.ZodNumber;
+        stepIndex: z.ZodNumber;
+        pageRoute: z.ZodString;
+        status: z.ZodEnum<["not_started", "running", "completed", "completed_with_errors", "halted", "failed", "blocked", "evidence_conflict", "unavailable", "coming_soon"]>;
+        complete: z.ZodBoolean;
+        completionReasons: z.ZodArray<z.ZodString, "many">;
+        pipeline: z.ZodNullable<z.ZodObject<{
+            stages: z.ZodArray<z.ZodObject<{
+                stageId: z.ZodString;
+                status: z.ZodEnum<["not_started", "accepted", "rejected", "validating", "pending"]>;
+                guardianScore: z.ZodUnion<[z.ZodNumber, z.ZodNull]>;
+                artifactId: z.ZodNullable<z.ZodString>;
+                createdAt: z.ZodNullable<z.ZodString>;
+                domainSummary: z.ZodString;
+                /** CI validation depth (e.g. actionlint skipped → partial). */
+                validationLevel: z.ZodOptional<z.ZodEnum<["full", "partial"]>>;
+            }, "strip", z.ZodTypeAny, {
+                status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                artifactId: string | null;
+                stageId: string;
+                guardianScore: number | null;
+                createdAt: string | null;
+                domainSummary: string;
+                validationLevel?: "partial" | "full" | undefined;
+            }, {
+                status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                artifactId: string | null;
+                stageId: string;
+                guardianScore: number | null;
+                createdAt: string | null;
+                domainSummary: string;
+                validationLevel?: "partial" | "full" | undefined;
+            }>, "many">;
+            pendingStages: z.ZodArray<z.ZodString, "many">;
+            rejectedStages: z.ZodArray<z.ZodString, "many">;
+            guardianMin: z.ZodUnion<[z.ZodNumber, z.ZodNull]>;
+        }, "strip", z.ZodTypeAny, {
+            pendingStages: string[];
+            stages: {
+                status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                artifactId: string | null;
+                stageId: string;
+                guardianScore: number | null;
+                createdAt: string | null;
+                domainSummary: string;
+                validationLevel?: "partial" | "full" | undefined;
+            }[];
+            rejectedStages: string[];
+            guardianMin: number | null;
+        }, {
+            pendingStages: string[];
+            stages: {
+                status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                artifactId: string | null;
+                stageId: string;
+                guardianScore: number | null;
+                createdAt: string | null;
+                domainSummary: string;
+                validationLevel?: "partial" | "full" | undefined;
+            }[];
+            rejectedStages: string[];
+            guardianMin: number | null;
+        }>>;
+        latestGuardianScore: z.ZodUnion<[z.ZodNumber, z.ZodNull]>;
+        latestArtifactId: z.ZodNullable<z.ZodString>;
+        latestAiRunId: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        status: "not_started" | "running" | "completed" | "completed_with_errors" | "halted" | "failed" | "blocked" | "evidence_conflict" | "unavailable" | "coming_soon";
+        pendingStages: string[];
+        complete: boolean;
+        warnings: string[];
+        stepId: string;
+        hardBlockers: string[];
+        name: string;
+        phase: string;
+        phaseIndex: number;
+        stepIndex: number;
+        pageRoute: string;
+        completionReasons: string[];
+        pipeline: {
+            pendingStages: string[];
+            stages: {
+                status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                artifactId: string | null;
+                stageId: string;
+                guardianScore: number | null;
+                createdAt: string | null;
+                domainSummary: string;
+                validationLevel?: "partial" | "full" | undefined;
+            }[];
+            rejectedStages: string[];
+            guardianMin: number | null;
+        } | null;
+        latestGuardianScore: number | null;
+        latestArtifactId: string | null;
+        latestAiRunId: string | null;
+        gates: {
+            type: string;
+            status: string;
+            gateId: string;
+            requiredApprover: string | null;
+            resolvedAt: string | null;
+            decision: string | null;
+        }[];
+        evidenceSource?: "registry" | "legacy_compat" | "mixed_invalid" | "incomplete" | undefined;
+        evidenceWarnings?: string[] | undefined;
+    }, {
+        id: string;
+        status: "not_started" | "running" | "completed" | "completed_with_errors" | "halted" | "failed" | "blocked" | "evidence_conflict" | "unavailable" | "coming_soon";
+        pendingStages: string[];
+        complete: boolean;
+        warnings: string[];
+        stepId: string;
+        hardBlockers: string[];
+        name: string;
+        phase: string;
+        phaseIndex: number;
+        stepIndex: number;
+        pageRoute: string;
+        completionReasons: string[];
+        pipeline: {
+            pendingStages: string[];
+            stages: {
+                status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                artifactId: string | null;
+                stageId: string;
+                guardianScore: number | null;
+                createdAt: string | null;
+                domainSummary: string;
+                validationLevel?: "partial" | "full" | undefined;
+            }[];
+            rejectedStages: string[];
+            guardianMin: number | null;
+        } | null;
+        latestGuardianScore: number | null;
+        latestArtifactId: string | null;
+        latestAiRunId: string | null;
+        gates: {
+            type: string;
+            status: string;
+            gateId: string;
+            requiredApprover: string | null;
+            resolvedAt: string | null;
+            decision: string | null;
+        }[];
+        evidenceSource?: "registry" | "legacy_compat" | "mixed_invalid" | "incomplete" | undefined;
+        evidenceWarnings?: string[] | undefined;
+    }>, "many">;
+    summary: z.ZodObject<{
+        totalSteps: z.ZodNumber;
+        completedSteps: z.ZodNumber;
+        inProgressSteps: z.ZodNumber;
+        blockedSteps: z.ZodNumber;
+        overallGuardianMin: z.ZodUnion<[z.ZodNumber, z.ZodNull]>;
+    }, "strip", z.ZodTypeAny, {
+        totalSteps: number;
+        completedSteps: number;
+        inProgressSteps: number;
+        blockedSteps: number;
+        overallGuardianMin: number | null;
+    }, {
+        totalSteps: number;
+        completedSteps: number;
+        inProgressSteps: number;
+        blockedSteps: number;
+        overallGuardianMin: number | null;
+    }>;
+    workflowEvidence: z.ZodOptional<z.ZodObject<{
+        conflicts: z.ZodArray<z.ZodObject<{
+            stepId: z.ZodString;
+            code: z.ZodEnum<["completion_vs_release_gate", "release_gate_vs_completion", "completion_vs_deployments_gate", "deployments_gate_vs_completion"]>;
+            message: z.ZodString;
+            completionSays: z.ZodEnum<["complete", "incomplete"]>;
+            gateSays: z.ZodEnum<["satisfied", "unsatisfied"]>;
+        }, "strip", z.ZodTypeAny, {
+            code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+            message: string;
+            stepId: string;
+            completionSays: "incomplete" | "complete";
+            gateSays: "satisfied" | "unsatisfied";
+        }, {
+            code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+            message: string;
+            stepId: string;
+            completionSays: "incomplete" | "complete";
+            gateSays: "satisfied" | "unsatisfied";
+        }>, "many">;
+        reviewReleaseTier: z.ZodOptional<z.ZodNullable<z.ZodEnum<["engineering_preview_only", "internal_beta_candidate", "launchable_public_mvp"]>>>;
+        deploymentsPlatformState: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        conflicts: {
+            code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+            message: string;
+            stepId: string;
+            completionSays: "incomplete" | "complete";
+            gateSays: "satisfied" | "unsatisfied";
+        }[];
+        reviewReleaseTier?: "engineering_preview_only" | "internal_beta_candidate" | "launchable_public_mvp" | null | undefined;
+        deploymentsPlatformState?: string | null | undefined;
+    }, {
+        conflicts: {
+            code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+            message: string;
+            stepId: string;
+            completionSays: "incomplete" | "complete";
+            gateSays: "satisfied" | "unsatisfied";
+        }[];
+        reviewReleaseTier?: "engineering_preview_only" | "internal_beta_candidate" | "launchable_public_mvp" | null | undefined;
+        deploymentsPlatformState?: string | null | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    steps: {
+        id: string;
+        status: "not_started" | "running" | "completed" | "completed_with_errors" | "halted" | "failed" | "blocked" | "evidence_conflict" | "unavailable" | "coming_soon";
+        pendingStages: string[];
+        complete: boolean;
+        warnings: string[];
+        stepId: string;
+        hardBlockers: string[];
+        name: string;
+        phase: string;
+        phaseIndex: number;
+        stepIndex: number;
+        pageRoute: string;
+        completionReasons: string[];
+        pipeline: {
+            pendingStages: string[];
+            stages: {
+                status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                artifactId: string | null;
+                stageId: string;
+                guardianScore: number | null;
+                createdAt: string | null;
+                domainSummary: string;
+                validationLevel?: "partial" | "full" | undefined;
+            }[];
+            rejectedStages: string[];
+            guardianMin: number | null;
+        } | null;
+        latestGuardianScore: number | null;
+        latestArtifactId: string | null;
+        latestAiRunId: string | null;
+        gates: {
+            type: string;
+            status: string;
+            gateId: string;
+            requiredApprover: string | null;
+            resolvedAt: string | null;
+            decision: string | null;
+        }[];
+        evidenceSource?: "registry" | "legacy_compat" | "mixed_invalid" | "incomplete" | undefined;
+        evidenceWarnings?: string[] | undefined;
+    }[];
+    project: {
+        id: string;
+        description: string | null;
+        status: string | null;
+        name: string;
+    };
+    commandCenter: {
+        activeOrchestrationId: string | null;
+        workflowExecutionMode: "build-new" | "audit-existing" | null;
+    };
+    phases: {
+        number: number;
+        id: string;
+        title: string;
+        steps: string[];
+    }[];
+    currentStepId: string | null;
+    summary: {
+        totalSteps: number;
+        completedSteps: number;
+        inProgressSteps: number;
+        blockedSteps: number;
+        overallGuardianMin: number | null;
+    };
+    workflowEvidence?: {
+        conflicts: {
+            code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+            message: string;
+            stepId: string;
+            completionSays: "incomplete" | "complete";
+            gateSays: "satisfied" | "unsatisfied";
+        }[];
+        reviewReleaseTier?: "engineering_preview_only" | "internal_beta_candidate" | "launchable_public_mvp" | null | undefined;
+        deploymentsPlatformState?: string | null | undefined;
+    } | undefined;
+}, {
+    steps: {
+        id: string;
+        status: "not_started" | "running" | "completed" | "completed_with_errors" | "halted" | "failed" | "blocked" | "evidence_conflict" | "unavailable" | "coming_soon";
+        pendingStages: string[];
+        complete: boolean;
+        warnings: string[];
+        stepId: string;
+        hardBlockers: string[];
+        name: string;
+        phase: string;
+        phaseIndex: number;
+        stepIndex: number;
+        pageRoute: string;
+        completionReasons: string[];
+        pipeline: {
+            pendingStages: string[];
+            stages: {
+                status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                artifactId: string | null;
+                stageId: string;
+                guardianScore: number | null;
+                createdAt: string | null;
+                domainSummary: string;
+                validationLevel?: "partial" | "full" | undefined;
+            }[];
+            rejectedStages: string[];
+            guardianMin: number | null;
+        } | null;
+        latestGuardianScore: number | null;
+        latestArtifactId: string | null;
+        latestAiRunId: string | null;
+        gates: {
+            type: string;
+            status: string;
+            gateId: string;
+            requiredApprover: string | null;
+            resolvedAt: string | null;
+            decision: string | null;
+        }[];
+        evidenceSource?: "registry" | "legacy_compat" | "mixed_invalid" | "incomplete" | undefined;
+        evidenceWarnings?: string[] | undefined;
+    }[];
+    project: {
+        id: string;
+        description: string | null;
+        status: string | null;
+        name: string;
+    };
+    commandCenter: {
+        activeOrchestrationId: string | null;
+        workflowExecutionMode: "build-new" | "audit-existing" | null;
+    };
+    phases: {
+        number: number;
+        id: string;
+        title: string;
+        steps: string[];
+    }[];
+    currentStepId: string | null;
+    summary: {
+        totalSteps: number;
+        completedSteps: number;
+        inProgressSteps: number;
+        blockedSteps: number;
+        overallGuardianMin: number | null;
+    };
+    workflowEvidence?: {
+        conflicts: {
+            code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+            message: string;
+            stepId: string;
+            completionSays: "incomplete" | "complete";
+            gateSays: "satisfied" | "unsatisfied";
+        }[];
+        reviewReleaseTier?: "engineering_preview_only" | "internal_beta_candidate" | "launchable_public_mvp" | null | undefined;
+        deploymentsPlatformState?: string | null | undefined;
+    } | undefined;
+}>;
+export type PipelineStageState = z.infer<typeof PipelineStageStateSchema>;
+export type PipelineStageStatus = PipelineStageState['status'];
+export type WorkflowGateState = z.infer<typeof WorkflowGateStateSchema>;
+export type WorkflowGateStatus = 'pending_approval' | 'approved' | 'rejected';
+export type WorkflowStepState = z.infer<typeof WorkflowStepStateSchema>;
+export type WorkflowStateResponse = z.infer<typeof WorkflowStateResponseSchema>;
+/**
+ * GET /api/projects/[id]/workflow/state — JSON body on success.
+ * Matches `NextResponse.json({ success: true, data })` and `typedFetch` envelope unwrap.
+ */
+export declare const WorkflowStateApiSuccessResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        project: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodNullable<z.ZodString>;
+            status: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            description: string | null;
+            status: string | null;
+            name: string;
+        }, {
+            id: string;
+            description: string | null;
+            status: string | null;
+            name: string;
+        }>;
+        commandCenter: z.ZodObject<{
+            /** Latest orchestrations.id for this project (same spine id used across AI runs). */
+            activeOrchestrationId: z.ZodNullable<z.ZodString>;
+            workflowExecutionMode: z.ZodNullable<z.ZodEnum<["build-new", "audit-existing"]>>;
+        }, "strip", z.ZodTypeAny, {
+            activeOrchestrationId: string | null;
+            workflowExecutionMode: "build-new" | "audit-existing" | null;
+        }, {
+            activeOrchestrationId: string | null;
+            workflowExecutionMode: "build-new" | "audit-existing" | null;
+        }>;
+        phases: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            number: z.ZodNumber;
+            title: z.ZodString;
+            steps: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            number: number;
+            id: string;
+            title: string;
+            steps: string[];
+        }, {
+            number: number;
+            id: string;
+            title: string;
+            steps: string[];
+        }>, "many">;
+        currentStepId: z.ZodNullable<z.ZodString>;
+        steps: z.ZodArray<z.ZodObject<{
+            gates: z.ZodArray<z.ZodObject<{
+                gateId: z.ZodString;
+                type: z.ZodString;
+                status: z.ZodString;
+                requiredApprover: z.ZodNullable<z.ZodString>;
+                resolvedAt: z.ZodNullable<z.ZodString>;
+                decision: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: string;
+                status: string;
+                gateId: string;
+                requiredApprover: string | null;
+                resolvedAt: string | null;
+                decision: string | null;
+            }, {
+                type: string;
+                status: string;
+                gateId: string;
+                requiredApprover: string | null;
+                resolvedAt: string | null;
+                decision: string | null;
+            }>, "many">;
+            /** Evidence resolution source for aliased software_app steps (#1062). */
+            evidenceSource: z.ZodOptional<z.ZodEnum<["registry", "legacy_compat", "mixed_invalid", "incomplete"]>>;
+            evidenceWarnings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /** Preconditions that disable Generate / must clear before continuing */
+            hardBlockers: z.ZodArray<z.ZodString, "many">;
+            /** Quality/upstream cues — Generate remains allowed */
+            warnings: z.ZodArray<z.ZodString, "many">;
+            /** Missing stage outputs — work in flight, not gating Generate */
+            pendingStages: z.ZodArray<z.ZodString, "many">;
+            id: z.ZodString;
+            stepId: z.ZodString;
+            name: z.ZodString;
+            phase: z.ZodString;
+            phaseIndex: z.ZodNumber;
+            stepIndex: z.ZodNumber;
+            pageRoute: z.ZodString;
+            status: z.ZodEnum<["not_started", "running", "completed", "completed_with_errors", "halted", "failed", "blocked", "evidence_conflict", "unavailable", "coming_soon"]>;
+            complete: z.ZodBoolean;
+            completionReasons: z.ZodArray<z.ZodString, "many">;
+            pipeline: z.ZodNullable<z.ZodObject<{
+                stages: z.ZodArray<z.ZodObject<{
+                    stageId: z.ZodString;
+                    status: z.ZodEnum<["not_started", "accepted", "rejected", "validating", "pending"]>;
+                    guardianScore: z.ZodUnion<[z.ZodNumber, z.ZodNull]>;
+                    artifactId: z.ZodNullable<z.ZodString>;
+                    createdAt: z.ZodNullable<z.ZodString>;
+                    domainSummary: z.ZodString;
+                    /** CI validation depth (e.g. actionlint skipped → partial). */
+                    validationLevel: z.ZodOptional<z.ZodEnum<["full", "partial"]>>;
+                }, "strip", z.ZodTypeAny, {
+                    status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                    artifactId: string | null;
+                    stageId: string;
+                    guardianScore: number | null;
+                    createdAt: string | null;
+                    domainSummary: string;
+                    validationLevel?: "partial" | "full" | undefined;
+                }, {
+                    status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                    artifactId: string | null;
+                    stageId: string;
+                    guardianScore: number | null;
+                    createdAt: string | null;
+                    domainSummary: string;
+                    validationLevel?: "partial" | "full" | undefined;
+                }>, "many">;
+                pendingStages: z.ZodArray<z.ZodString, "many">;
+                rejectedStages: z.ZodArray<z.ZodString, "many">;
+                guardianMin: z.ZodUnion<[z.ZodNumber, z.ZodNull]>;
+            }, "strip", z.ZodTypeAny, {
+                pendingStages: string[];
+                stages: {
+                    status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                    artifactId: string | null;
+                    stageId: string;
+                    guardianScore: number | null;
+                    createdAt: string | null;
+                    domainSummary: string;
+                    validationLevel?: "partial" | "full" | undefined;
+                }[];
+                rejectedStages: string[];
+                guardianMin: number | null;
+            }, {
+                pendingStages: string[];
+                stages: {
+                    status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                    artifactId: string | null;
+                    stageId: string;
+                    guardianScore: number | null;
+                    createdAt: string | null;
+                    domainSummary: string;
+                    validationLevel?: "partial" | "full" | undefined;
+                }[];
+                rejectedStages: string[];
+                guardianMin: number | null;
+            }>>;
+            latestGuardianScore: z.ZodUnion<[z.ZodNumber, z.ZodNull]>;
+            latestArtifactId: z.ZodNullable<z.ZodString>;
+            latestAiRunId: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            status: "not_started" | "running" | "completed" | "completed_with_errors" | "halted" | "failed" | "blocked" | "evidence_conflict" | "unavailable" | "coming_soon";
+            pendingStages: string[];
+            complete: boolean;
+            warnings: string[];
+            stepId: string;
+            hardBlockers: string[];
+            name: string;
+            phase: string;
+            phaseIndex: number;
+            stepIndex: number;
+            pageRoute: string;
+            completionReasons: string[];
+            pipeline: {
+                pendingStages: string[];
+                stages: {
+                    status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                    artifactId: string | null;
+                    stageId: string;
+                    guardianScore: number | null;
+                    createdAt: string | null;
+                    domainSummary: string;
+                    validationLevel?: "partial" | "full" | undefined;
+                }[];
+                rejectedStages: string[];
+                guardianMin: number | null;
+            } | null;
+            latestGuardianScore: number | null;
+            latestArtifactId: string | null;
+            latestAiRunId: string | null;
+            gates: {
+                type: string;
+                status: string;
+                gateId: string;
+                requiredApprover: string | null;
+                resolvedAt: string | null;
+                decision: string | null;
+            }[];
+            evidenceSource?: "registry" | "legacy_compat" | "mixed_invalid" | "incomplete" | undefined;
+            evidenceWarnings?: string[] | undefined;
+        }, {
+            id: string;
+            status: "not_started" | "running" | "completed" | "completed_with_errors" | "halted" | "failed" | "blocked" | "evidence_conflict" | "unavailable" | "coming_soon";
+            pendingStages: string[];
+            complete: boolean;
+            warnings: string[];
+            stepId: string;
+            hardBlockers: string[];
+            name: string;
+            phase: string;
+            phaseIndex: number;
+            stepIndex: number;
+            pageRoute: string;
+            completionReasons: string[];
+            pipeline: {
+                pendingStages: string[];
+                stages: {
+                    status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                    artifactId: string | null;
+                    stageId: string;
+                    guardianScore: number | null;
+                    createdAt: string | null;
+                    domainSummary: string;
+                    validationLevel?: "partial" | "full" | undefined;
+                }[];
+                rejectedStages: string[];
+                guardianMin: number | null;
+            } | null;
+            latestGuardianScore: number | null;
+            latestArtifactId: string | null;
+            latestAiRunId: string | null;
+            gates: {
+                type: string;
+                status: string;
+                gateId: string;
+                requiredApprover: string | null;
+                resolvedAt: string | null;
+                decision: string | null;
+            }[];
+            evidenceSource?: "registry" | "legacy_compat" | "mixed_invalid" | "incomplete" | undefined;
+            evidenceWarnings?: string[] | undefined;
+        }>, "many">;
+        summary: z.ZodObject<{
+            totalSteps: z.ZodNumber;
+            completedSteps: z.ZodNumber;
+            inProgressSteps: z.ZodNumber;
+            blockedSteps: z.ZodNumber;
+            overallGuardianMin: z.ZodUnion<[z.ZodNumber, z.ZodNull]>;
+        }, "strip", z.ZodTypeAny, {
+            totalSteps: number;
+            completedSteps: number;
+            inProgressSteps: number;
+            blockedSteps: number;
+            overallGuardianMin: number | null;
+        }, {
+            totalSteps: number;
+            completedSteps: number;
+            inProgressSteps: number;
+            blockedSteps: number;
+            overallGuardianMin: number | null;
+        }>;
+        workflowEvidence: z.ZodOptional<z.ZodObject<{
+            conflicts: z.ZodArray<z.ZodObject<{
+                stepId: z.ZodString;
+                code: z.ZodEnum<["completion_vs_release_gate", "release_gate_vs_completion", "completion_vs_deployments_gate", "deployments_gate_vs_completion"]>;
+                message: z.ZodString;
+                completionSays: z.ZodEnum<["complete", "incomplete"]>;
+                gateSays: z.ZodEnum<["satisfied", "unsatisfied"]>;
+            }, "strip", z.ZodTypeAny, {
+                code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+                message: string;
+                stepId: string;
+                completionSays: "incomplete" | "complete";
+                gateSays: "satisfied" | "unsatisfied";
+            }, {
+                code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+                message: string;
+                stepId: string;
+                completionSays: "incomplete" | "complete";
+                gateSays: "satisfied" | "unsatisfied";
+            }>, "many">;
+            reviewReleaseTier: z.ZodOptional<z.ZodNullable<z.ZodEnum<["engineering_preview_only", "internal_beta_candidate", "launchable_public_mvp"]>>>;
+            deploymentsPlatformState: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            conflicts: {
+                code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+                message: string;
+                stepId: string;
+                completionSays: "incomplete" | "complete";
+                gateSays: "satisfied" | "unsatisfied";
+            }[];
+            reviewReleaseTier?: "engineering_preview_only" | "internal_beta_candidate" | "launchable_public_mvp" | null | undefined;
+            deploymentsPlatformState?: string | null | undefined;
+        }, {
+            conflicts: {
+                code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+                message: string;
+                stepId: string;
+                completionSays: "incomplete" | "complete";
+                gateSays: "satisfied" | "unsatisfied";
+            }[];
+            reviewReleaseTier?: "engineering_preview_only" | "internal_beta_candidate" | "launchable_public_mvp" | null | undefined;
+            deploymentsPlatformState?: string | null | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        steps: {
+            id: string;
+            status: "not_started" | "running" | "completed" | "completed_with_errors" | "halted" | "failed" | "blocked" | "evidence_conflict" | "unavailable" | "coming_soon";
+            pendingStages: string[];
+            complete: boolean;
+            warnings: string[];
+            stepId: string;
+            hardBlockers: string[];
+            name: string;
+            phase: string;
+            phaseIndex: number;
+            stepIndex: number;
+            pageRoute: string;
+            completionReasons: string[];
+            pipeline: {
+                pendingStages: string[];
+                stages: {
+                    status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                    artifactId: string | null;
+                    stageId: string;
+                    guardianScore: number | null;
+                    createdAt: string | null;
+                    domainSummary: string;
+                    validationLevel?: "partial" | "full" | undefined;
+                }[];
+                rejectedStages: string[];
+                guardianMin: number | null;
+            } | null;
+            latestGuardianScore: number | null;
+            latestArtifactId: string | null;
+            latestAiRunId: string | null;
+            gates: {
+                type: string;
+                status: string;
+                gateId: string;
+                requiredApprover: string | null;
+                resolvedAt: string | null;
+                decision: string | null;
+            }[];
+            evidenceSource?: "registry" | "legacy_compat" | "mixed_invalid" | "incomplete" | undefined;
+            evidenceWarnings?: string[] | undefined;
+        }[];
+        project: {
+            id: string;
+            description: string | null;
+            status: string | null;
+            name: string;
+        };
+        commandCenter: {
+            activeOrchestrationId: string | null;
+            workflowExecutionMode: "build-new" | "audit-existing" | null;
+        };
+        phases: {
+            number: number;
+            id: string;
+            title: string;
+            steps: string[];
+        }[];
+        currentStepId: string | null;
+        summary: {
+            totalSteps: number;
+            completedSteps: number;
+            inProgressSteps: number;
+            blockedSteps: number;
+            overallGuardianMin: number | null;
+        };
+        workflowEvidence?: {
+            conflicts: {
+                code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+                message: string;
+                stepId: string;
+                completionSays: "incomplete" | "complete";
+                gateSays: "satisfied" | "unsatisfied";
+            }[];
+            reviewReleaseTier?: "engineering_preview_only" | "internal_beta_candidate" | "launchable_public_mvp" | null | undefined;
+            deploymentsPlatformState?: string | null | undefined;
+        } | undefined;
+    }, {
+        steps: {
+            id: string;
+            status: "not_started" | "running" | "completed" | "completed_with_errors" | "halted" | "failed" | "blocked" | "evidence_conflict" | "unavailable" | "coming_soon";
+            pendingStages: string[];
+            complete: boolean;
+            warnings: string[];
+            stepId: string;
+            hardBlockers: string[];
+            name: string;
+            phase: string;
+            phaseIndex: number;
+            stepIndex: number;
+            pageRoute: string;
+            completionReasons: string[];
+            pipeline: {
+                pendingStages: string[];
+                stages: {
+                    status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                    artifactId: string | null;
+                    stageId: string;
+                    guardianScore: number | null;
+                    createdAt: string | null;
+                    domainSummary: string;
+                    validationLevel?: "partial" | "full" | undefined;
+                }[];
+                rejectedStages: string[];
+                guardianMin: number | null;
+            } | null;
+            latestGuardianScore: number | null;
+            latestArtifactId: string | null;
+            latestAiRunId: string | null;
+            gates: {
+                type: string;
+                status: string;
+                gateId: string;
+                requiredApprover: string | null;
+                resolvedAt: string | null;
+                decision: string | null;
+            }[];
+            evidenceSource?: "registry" | "legacy_compat" | "mixed_invalid" | "incomplete" | undefined;
+            evidenceWarnings?: string[] | undefined;
+        }[];
+        project: {
+            id: string;
+            description: string | null;
+            status: string | null;
+            name: string;
+        };
+        commandCenter: {
+            activeOrchestrationId: string | null;
+            workflowExecutionMode: "build-new" | "audit-existing" | null;
+        };
+        phases: {
+            number: number;
+            id: string;
+            title: string;
+            steps: string[];
+        }[];
+        currentStepId: string | null;
+        summary: {
+            totalSteps: number;
+            completedSteps: number;
+            inProgressSteps: number;
+            blockedSteps: number;
+            overallGuardianMin: number | null;
+        };
+        workflowEvidence?: {
+            conflicts: {
+                code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+                message: string;
+                stepId: string;
+                completionSays: "incomplete" | "complete";
+                gateSays: "satisfied" | "unsatisfied";
+            }[];
+            reviewReleaseTier?: "engineering_preview_only" | "internal_beta_candidate" | "launchable_public_mvp" | null | undefined;
+            deploymentsPlatformState?: string | null | undefined;
+        } | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        steps: {
+            id: string;
+            status: "not_started" | "running" | "completed" | "completed_with_errors" | "halted" | "failed" | "blocked" | "evidence_conflict" | "unavailable" | "coming_soon";
+            pendingStages: string[];
+            complete: boolean;
+            warnings: string[];
+            stepId: string;
+            hardBlockers: string[];
+            name: string;
+            phase: string;
+            phaseIndex: number;
+            stepIndex: number;
+            pageRoute: string;
+            completionReasons: string[];
+            pipeline: {
+                pendingStages: string[];
+                stages: {
+                    status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                    artifactId: string | null;
+                    stageId: string;
+                    guardianScore: number | null;
+                    createdAt: string | null;
+                    domainSummary: string;
+                    validationLevel?: "partial" | "full" | undefined;
+                }[];
+                rejectedStages: string[];
+                guardianMin: number | null;
+            } | null;
+            latestGuardianScore: number | null;
+            latestArtifactId: string | null;
+            latestAiRunId: string | null;
+            gates: {
+                type: string;
+                status: string;
+                gateId: string;
+                requiredApprover: string | null;
+                resolvedAt: string | null;
+                decision: string | null;
+            }[];
+            evidenceSource?: "registry" | "legacy_compat" | "mixed_invalid" | "incomplete" | undefined;
+            evidenceWarnings?: string[] | undefined;
+        }[];
+        project: {
+            id: string;
+            description: string | null;
+            status: string | null;
+            name: string;
+        };
+        commandCenter: {
+            activeOrchestrationId: string | null;
+            workflowExecutionMode: "build-new" | "audit-existing" | null;
+        };
+        phases: {
+            number: number;
+            id: string;
+            title: string;
+            steps: string[];
+        }[];
+        currentStepId: string | null;
+        summary: {
+            totalSteps: number;
+            completedSteps: number;
+            inProgressSteps: number;
+            blockedSteps: number;
+            overallGuardianMin: number | null;
+        };
+        workflowEvidence?: {
+            conflicts: {
+                code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+                message: string;
+                stepId: string;
+                completionSays: "incomplete" | "complete";
+                gateSays: "satisfied" | "unsatisfied";
+            }[];
+            reviewReleaseTier?: "engineering_preview_only" | "internal_beta_candidate" | "launchable_public_mvp" | null | undefined;
+            deploymentsPlatformState?: string | null | undefined;
+        } | undefined;
+    };
+}, {
+    success: true;
+    data: {
+        steps: {
+            id: string;
+            status: "not_started" | "running" | "completed" | "completed_with_errors" | "halted" | "failed" | "blocked" | "evidence_conflict" | "unavailable" | "coming_soon";
+            pendingStages: string[];
+            complete: boolean;
+            warnings: string[];
+            stepId: string;
+            hardBlockers: string[];
+            name: string;
+            phase: string;
+            phaseIndex: number;
+            stepIndex: number;
+            pageRoute: string;
+            completionReasons: string[];
+            pipeline: {
+                pendingStages: string[];
+                stages: {
+                    status: "not_started" | "pending" | "accepted" | "rejected" | "validating";
+                    artifactId: string | null;
+                    stageId: string;
+                    guardianScore: number | null;
+                    createdAt: string | null;
+                    domainSummary: string;
+                    validationLevel?: "partial" | "full" | undefined;
+                }[];
+                rejectedStages: string[];
+                guardianMin: number | null;
+            } | null;
+            latestGuardianScore: number | null;
+            latestArtifactId: string | null;
+            latestAiRunId: string | null;
+            gates: {
+                type: string;
+                status: string;
+                gateId: string;
+                requiredApprover: string | null;
+                resolvedAt: string | null;
+                decision: string | null;
+            }[];
+            evidenceSource?: "registry" | "legacy_compat" | "mixed_invalid" | "incomplete" | undefined;
+            evidenceWarnings?: string[] | undefined;
+        }[];
+        project: {
+            id: string;
+            description: string | null;
+            status: string | null;
+            name: string;
+        };
+        commandCenter: {
+            activeOrchestrationId: string | null;
+            workflowExecutionMode: "build-new" | "audit-existing" | null;
+        };
+        phases: {
+            number: number;
+            id: string;
+            title: string;
+            steps: string[];
+        }[];
+        currentStepId: string | null;
+        summary: {
+            totalSteps: number;
+            completedSteps: number;
+            inProgressSteps: number;
+            blockedSteps: number;
+            overallGuardianMin: number | null;
+        };
+        workflowEvidence?: {
+            conflicts: {
+                code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+                message: string;
+                stepId: string;
+                completionSays: "incomplete" | "complete";
+                gateSays: "satisfied" | "unsatisfied";
+            }[];
+            reviewReleaseTier?: "engineering_preview_only" | "internal_beta_candidate" | "launchable_public_mvp" | null | undefined;
+            deploymentsPlatformState?: string | null | undefined;
+        } | undefined;
+    };
+}>;
+export type WorkflowStateApiSuccessResponse = z.infer<typeof WorkflowStateApiSuccessResponseSchema>;
+/** Display stat for workflow step stats cards (WorkflowStatsCard). */
+export declare const WorkflowStatSchema: z.ZodObject<{
+    label: z.ZodString;
+    value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    trend: z.ZodOptional<z.ZodEnum<["up", "down", "neutral"]>>;
+    trendValue: z.ZodOptional<z.ZodString>;
+    variant: z.ZodOptional<z.ZodEnum<["default", "success", "warning", "destructive"]>>;
+}, "strip", z.ZodTypeAny, {
+    value: string | number;
+    label: string;
+    trend?: "up" | "down" | "neutral" | undefined;
+    trendValue?: string | undefined;
+    variant?: "success" | "warning" | "default" | "destructive" | undefined;
+}, {
+    value: string | number;
+    label: string;
+    trend?: "up" | "down" | "neutral" | undefined;
+    trendValue?: string | undefined;
+    variant?: "success" | "warning" | "default" | "destructive" | undefined;
+}>;
+export type WorkflowStat = z.infer<typeof WorkflowStatSchema>;
+/** GET /api/projects/[id]/workflow/step-stats — supported step ids for metrics cards. */
+export declare const WorkflowStepStatsStepIdSchema: z.ZodEnum<["specify", "plan", "schema", "api", "ui", "constitution", "guardian", "tasks", "implement", "knowledge", "ci", "cicd", "deploy", "deployments", "review"]>;
+export type WorkflowStepStatsStepId = z.infer<typeof WorkflowStepStatsStepIdSchema>;
+export declare const WorkflowStepStatsResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        trend: z.ZodOptional<z.ZodEnum<["up", "down", "neutral"]>>;
+        trendValue: z.ZodOptional<z.ZodString>;
+        variant: z.ZodOptional<z.ZodEnum<["default", "success", "warning", "destructive"]>>;
+    }, "strip", z.ZodTypeAny, {
+        value: string | number;
+        label: string;
+        trend?: "up" | "down" | "neutral" | undefined;
+        trendValue?: string | undefined;
+        variant?: "success" | "warning" | "default" | "destructive" | undefined;
+    }, {
+        value: string | number;
+        label: string;
+        trend?: "up" | "down" | "neutral" | undefined;
+        trendValue?: string | undefined;
+        variant?: "success" | "warning" | "default" | "destructive" | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        value: string | number;
+        label: string;
+        trend?: "up" | "down" | "neutral" | undefined;
+        trendValue?: string | undefined;
+        variant?: "success" | "warning" | "default" | "destructive" | undefined;
+    }[];
+}, {
+    success: true;
+    data: {
+        value: string | number;
+        label: string;
+        trend?: "up" | "down" | "neutral" | undefined;
+        trendValue?: string | undefined;
+        variant?: "success" | "warning" | "default" | "destructive" | undefined;
+    }[];
+}>;
+export type WorkflowStepStatsResponse = z.infer<typeof WorkflowStepStatsResponseSchema>;
+export declare const WorkflowResetStepRequestSchema: z.ZodEffects<z.ZodObject<{
+    stepId: z.ZodLiteral<"api">;
+    dryRun: z.ZodBoolean;
+    confirm: z.ZodOptional<z.ZodLiteral<"RESET_API_STEP">>;
+}, "strip", z.ZodTypeAny, {
+    stepId: "api";
+    dryRun: boolean;
+    confirm?: "RESET_API_STEP" | undefined;
+}, {
+    stepId: "api";
+    dryRun: boolean;
+    confirm?: "RESET_API_STEP" | undefined;
+}>, {
+    stepId: "api";
+    dryRun: boolean;
+    confirm?: "RESET_API_STEP" | undefined;
+}, {
+    stepId: "api";
+    dryRun: boolean;
+    confirm?: "RESET_API_STEP" | undefined;
+}>;
+export type WorkflowResetStepRequest = z.infer<typeof WorkflowResetStepRequestSchema>;
+export declare const WorkflowResetStepResponseSchema: z.ZodObject<{
+    dryRun: z.ZodBoolean;
+    projectId: z.ZodString;
+    stepId: z.ZodLiteral<"api">;
+    wouldDelete: z.ZodObject<{
+        workflowArtifacts: z.ZodNumber;
+        apiDefinitions: z.ZodNumber;
+        apiKgNodes: z.ZodNumber;
+        apiKgEdges: z.ZodNumber;
+        orchestrationEvents: z.ZodNumber;
+        aiRuns: z.ZodNumber;
+        stepCompletionRows: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        workflowArtifacts: number;
+        apiDefinitions: number;
+        apiKgNodes: number;
+        apiKgEdges: number;
+        orchestrationEvents: number;
+        aiRuns: number;
+        stepCompletionRows: number;
+    }, {
+        workflowArtifacts: number;
+        apiDefinitions: number;
+        apiKgNodes: number;
+        apiKgEdges: number;
+        orchestrationEvents: number;
+        aiRuns: number;
+        stepCompletionRows: number;
+    }>;
+    protectedCounts: z.ZodObject<{
+        specifyArtifacts: z.ZodNumber;
+        planArtifacts: z.ZodNumber;
+        schemaArtifacts: z.ZodNumber;
+        specifications: z.ZodNumber;
+        nonApiKgNodes: z.ZodNumber;
+        nonApiKgEdges: z.ZodNumber;
+        workflowGates: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        specifyArtifacts: number;
+        planArtifacts: number;
+        schemaArtifacts: number;
+        specifications: number;
+        nonApiKgNodes: number;
+        nonApiKgEdges: number;
+        workflowGates: number;
+    }, {
+        specifyArtifacts: number;
+        planArtifacts: number;
+        schemaArtifacts: number;
+        specifications: number;
+        nonApiKgNodes: number;
+        nonApiKgEdges: number;
+        workflowGates: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    stepId: "api";
+    dryRun: boolean;
+    wouldDelete: {
+        workflowArtifacts: number;
+        apiDefinitions: number;
+        apiKgNodes: number;
+        apiKgEdges: number;
+        orchestrationEvents: number;
+        aiRuns: number;
+        stepCompletionRows: number;
+    };
+    protectedCounts: {
+        specifyArtifacts: number;
+        planArtifacts: number;
+        schemaArtifacts: number;
+        specifications: number;
+        nonApiKgNodes: number;
+        nonApiKgEdges: number;
+        workflowGates: number;
+    };
+}, {
+    projectId: string;
+    stepId: "api";
+    dryRun: boolean;
+    wouldDelete: {
+        workflowArtifacts: number;
+        apiDefinitions: number;
+        apiKgNodes: number;
+        apiKgEdges: number;
+        orchestrationEvents: number;
+        aiRuns: number;
+        stepCompletionRows: number;
+    };
+    protectedCounts: {
+        specifyArtifacts: number;
+        planArtifacts: number;
+        schemaArtifacts: number;
+        specifications: number;
+        nonApiKgNodes: number;
+        nonApiKgEdges: number;
+        workflowGates: number;
+    };
+}>;
+export type WorkflowResetStepResponse = z.infer<typeof WorkflowResetStepResponseSchema>;
+/** GET /api/projects/[id]/workflow/step-ai-output — ai_runs + workflow_artifacts digest for AIOutputDisplay. */
+export declare const WorkflowStepAiOutputRunRowSchema: z.ZodObject<{
+    id: z.ZodString;
+    step: z.ZodString;
+    status: z.ZodString;
+    output: z.ZodNullable<z.ZodUnknown>;
+    metadata: z.ZodNullable<z.ZodUnknown>;
+    guardian_score_after: z.ZodNullable<z.ZodNumber>;
+    created_at: z.ZodString;
+    completed_at: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    status: string;
+    step: string;
+    guardian_score_after: number | null;
+    created_at: string;
+    completed_at: string | null;
+    output?: unknown;
+    metadata?: unknown;
+}, {
+    id: string;
+    status: string;
+    step: string;
+    guardian_score_after: number | null;
+    created_at: string;
+    completed_at: string | null;
+    output?: unknown;
+    metadata?: unknown;
+}>;
+export type WorkflowStepAiOutputRunRow = z.infer<typeof WorkflowStepAiOutputRunRowSchema>;
+export declare const WorkflowStepAiOutputArtifactRowSchema: z.ZodObject<{
+    stage_id: z.ZodString;
+    artifact_type: z.ZodString;
+    status: z.ZodString;
+    guardian_score: z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    payload: z.ZodUnknown;
+    created_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    created_at: string;
+    stage_id: string;
+    artifact_type: string;
+    guardian_score: string | number | null;
+    payload?: unknown;
+}, {
+    status: string;
+    created_at: string;
+    stage_id: string;
+    artifact_type: string;
+    guardian_score: string | number | null;
+    payload?: unknown;
+}>;
+export type WorkflowStepAiOutputArtifactRow = z.infer<typeof WorkflowStepAiOutputArtifactRowSchema>;
+export declare const WorkflowStepAiOutputResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        aiRuns: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            step: z.ZodString;
+            status: z.ZodString;
+            output: z.ZodNullable<z.ZodUnknown>;
+            metadata: z.ZodNullable<z.ZodUnknown>;
+            guardian_score_after: z.ZodNullable<z.ZodNumber>;
+            created_at: z.ZodString;
+            completed_at: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            status: string;
+            step: string;
+            guardian_score_after: number | null;
+            created_at: string;
+            completed_at: string | null;
+            output?: unknown;
+            metadata?: unknown;
+        }, {
+            id: string;
+            status: string;
+            step: string;
+            guardian_score_after: number | null;
+            created_at: string;
+            completed_at: string | null;
+            output?: unknown;
+            metadata?: unknown;
+        }>, "many">;
+        artifactRows: z.ZodArray<z.ZodObject<{
+            stage_id: z.ZodString;
+            artifact_type: z.ZodString;
+            status: z.ZodString;
+            guardian_score: z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+            payload: z.ZodUnknown;
+            created_at: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            status: string;
+            created_at: string;
+            stage_id: string;
+            artifact_type: string;
+            guardian_score: string | number | null;
+            payload?: unknown;
+        }, {
+            status: string;
+            created_at: string;
+            stage_id: string;
+            artifact_type: string;
+            guardian_score: string | number | null;
+            payload?: unknown;
+        }>, "many">;
+        /** Alias of artifactRows (latest per stage) for browser probes and legacy clients. */
+        artifacts: z.ZodArray<z.ZodObject<{
+            stage_id: z.ZodString;
+            artifact_type: z.ZodString;
+            status: z.ZodString;
+            guardian_score: z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+            payload: z.ZodUnknown;
+            created_at: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            status: string;
+            created_at: string;
+            stage_id: string;
+            artifact_type: string;
+            guardian_score: string | number | null;
+            payload?: unknown;
+        }, {
+            status: string;
+            created_at: string;
+            stage_id: string;
+            artifact_type: string;
+            guardian_score: string | number | null;
+            payload?: unknown;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        aiRuns: {
+            id: string;
+            status: string;
+            step: string;
+            guardian_score_after: number | null;
+            created_at: string;
+            completed_at: string | null;
+            output?: unknown;
+            metadata?: unknown;
+        }[];
+        artifactRows: {
+            status: string;
+            created_at: string;
+            stage_id: string;
+            artifact_type: string;
+            guardian_score: string | number | null;
+            payload?: unknown;
+        }[];
+        artifacts: {
+            status: string;
+            created_at: string;
+            stage_id: string;
+            artifact_type: string;
+            guardian_score: string | number | null;
+            payload?: unknown;
+        }[];
+    }, {
+        aiRuns: {
+            id: string;
+            status: string;
+            step: string;
+            guardian_score_after: number | null;
+            created_at: string;
+            completed_at: string | null;
+            output?: unknown;
+            metadata?: unknown;
+        }[];
+        artifactRows: {
+            status: string;
+            created_at: string;
+            stage_id: string;
+            artifact_type: string;
+            guardian_score: string | number | null;
+            payload?: unknown;
+        }[];
+        artifacts: {
+            status: string;
+            created_at: string;
+            stage_id: string;
+            artifact_type: string;
+            guardian_score: string | number | null;
+            payload?: unknown;
+        }[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        aiRuns: {
+            id: string;
+            status: string;
+            step: string;
+            guardian_score_after: number | null;
+            created_at: string;
+            completed_at: string | null;
+            output?: unknown;
+            metadata?: unknown;
+        }[];
+        artifactRows: {
+            status: string;
+            created_at: string;
+            stage_id: string;
+            artifact_type: string;
+            guardian_score: string | number | null;
+            payload?: unknown;
+        }[];
+        artifacts: {
+            status: string;
+            created_at: string;
+            stage_id: string;
+            artifact_type: string;
+            guardian_score: string | number | null;
+            payload?: unknown;
+        }[];
+    };
+}, {
+    success: true;
+    data: {
+        aiRuns: {
+            id: string;
+            status: string;
+            step: string;
+            guardian_score_after: number | null;
+            created_at: string;
+            completed_at: string | null;
+            output?: unknown;
+            metadata?: unknown;
+        }[];
+        artifactRows: {
+            status: string;
+            created_at: string;
+            stage_id: string;
+            artifact_type: string;
+            guardian_score: string | number | null;
+            payload?: unknown;
+        }[];
+        artifacts: {
+            status: string;
+            created_at: string;
+            stage_id: string;
+            artifact_type: string;
+            guardian_score: string | number | null;
+            payload?: unknown;
+        }[];
+    };
+}>;
+export type WorkflowStepAiOutputResponse = z.infer<typeof WorkflowStepAiOutputResponseSchema>;