@neuraloom/contracts 0.0.0-stage → 0.1.23

package/dist/schemas/film/film-production-read-model.schema.d.ts

@@ -0,0 +1,1038 @@
+import { z } from 'zod';
+/**
+ * FilmProductionReadModel (FP-14) — the unified operator display SSOT.
+ *
+ * Composes the canonical creative read-model (one query, one source of truth) and
+ * adds deterministically-derived production state: per-step status, hydrate status,
+ * generation health, KG export readiness, and a flat blocker list with repair actions.
+ *
+ * Built by the pure transform `buildFilmProductionReadModel` so it is fully testable
+ * with fixtures — no live provider/DB call inside the derivation.
+ */
+export declare const FILM_READ_MODEL_STEP_STATUSES: readonly ["not_started", "in_progress", "blocked", "complete"];
+export declare const FilmReadModelStepStatusSchema: z.ZodEnum<["not_started", "in_progress", "blocked", "complete"]>;
+export declare const FilmReadModelStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<["not_started", "in_progress", "blocked", "complete"]>;
+    blockers: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    nextActions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    status: "complete" | "not_started" | "blocked" | "in_progress";
+    blockers: string[];
+    nextActions: string[];
+}, {
+    id: string;
+    status: "complete" | "not_started" | "blocked" | "in_progress";
+    blockers?: string[] | undefined;
+    nextActions?: string[] | undefined;
+}>;
+export type FilmReadModelStep = z.infer<typeof FilmReadModelStepSchema>;
+export declare const FilmReadModelBlockerSchema: z.ZodObject<{
+    code: z.ZodString;
+    severity: z.ZodEnum<["info", "warning", "error"]>;
+    message: z.ZodString;
+    step: z.ZodOptional<z.ZodString>;
+    repairAction: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    severity: "info" | "warning" | "error";
+    step?: string | undefined;
+    repairAction?: string | undefined;
+}, {
+    code: string;
+    message: string;
+    severity: "info" | "warning" | "error";
+    step?: string | undefined;
+    repairAction?: string | undefined;
+}>;
+export type FilmReadModelBlocker = z.infer<typeof FilmReadModelBlockerSchema>;
+export declare const FilmHydrateStatusSchema: z.ZodObject<{
+    /** An accepted scene/shot artifact exists, so hydrate is meaningful. */
+    required: z.ZodBoolean;
+    /** film_scenes / film_shots / film_prompts rows exist. */
+    available: z.ZodBoolean;
+    blockers: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    required: boolean;
+    blockers: string[];
+    available: boolean;
+}, {
+    required: boolean;
+    available: boolean;
+    blockers?: string[] | undefined;
+}>;
+export type FilmHydrateStatus = z.infer<typeof FilmHydrateStatusSchema>;
+export declare const FilmProductionReadModelSchema: z.ZodObject<{
+    generatedAt: z.ZodString;
+    /** Embedded canonical creative read-model — components read from here (FP-14). */
+    creative: z.ZodObject<{
+        generatedAt: z.ZodString;
+        project: z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodNullable<z.ZodString>;
+            kind: z.ZodNullable<z.ZodString>;
+            projectKind: z.ZodNullable<z.ZodString>;
+            workflowVariant: z.ZodNullable<z.ZodString>;
+            status: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            title: string | null;
+            status: string | null;
+            workflowVariant: string | null;
+            kind: string | null;
+            projectKind: string | null;
+        }, {
+            id: string;
+            title: string | null;
+            status: string | null;
+            workflowVariant: string | null;
+            kind: string | null;
+            projectKind: string | null;
+        }>;
+        counts: z.ZodObject<{
+            artifacts: z.ZodNumber;
+            acceptedArtifacts: z.ZodNumber;
+            scenes: z.ZodNumber;
+            shots: z.ZodNumber;
+            prompts: z.ZodNumber;
+            keyframes: z.ZodNumber;
+            providerJobs: z.ZodNumber;
+            mediaAssets: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            artifacts: number;
+            prompts: number;
+            scenes: number;
+            shots: number;
+            acceptedArtifacts: number;
+            keyframes: number;
+            providerJobs: number;
+            mediaAssets: number;
+        }, {
+            artifacts: number;
+            prompts: number;
+            scenes: number;
+            shots: number;
+            acceptedArtifacts: number;
+            keyframes: number;
+            providerJobs: number;
+            mediaAssets: number;
+        }>;
+        artifacts: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            workflowStepId: z.ZodNullable<z.ZodString>;
+            stageId: z.ZodString;
+            artifactType: z.ZodString;
+            status: z.ZodString;
+            guardianScore: z.ZodNullable<z.ZodNumber>;
+            summary: z.ZodNullable<z.ZodString>;
+            payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            createdAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            status: string;
+            stageId: string;
+            guardianScore: number | null;
+            createdAt: string;
+            summary: string | null;
+            workflowStepId: string | null;
+            artifactType: string;
+            payload?: Record<string, unknown> | undefined;
+        }, {
+            id: string;
+            status: string;
+            stageId: string;
+            guardianScore: number | null;
+            createdAt: string;
+            summary: string | null;
+            workflowStepId: string | null;
+            artifactType: string;
+            payload?: Record<string, unknown> | undefined;
+        }>, "many">;
+        scenes: z.ZodArray<z.ZodObject<{
+            sceneId: z.ZodString;
+            sceneCode: z.ZodString;
+            title: z.ZodString;
+            sequenceIndex: z.ZodNumber;
+            purpose: z.ZodString;
+            shotCount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            purpose: string;
+            sceneCode: string;
+            sequenceIndex: number;
+            sceneId: string;
+            shotCount: number;
+        }, {
+            title: string;
+            purpose: string;
+            sceneCode: string;
+            sequenceIndex: number;
+            sceneId: string;
+            shotCount: number;
+        }>, "many">;
+        shots: z.ZodArray<z.ZodObject<{
+            shotId: z.ZodString;
+            sceneId: z.ZodString;
+            shotCode: z.ZodString;
+            shotType: z.ZodString;
+            subject: z.ZodString;
+            durationSeconds: z.ZodNumber;
+            generationStrategy: z.ZodString;
+            status: z.ZodString;
+            riskLevel: z.ZodOptional<z.ZodNullable<z.ZodEnum<["low", "medium", "high", "avoid"]>>>;
+            riskFlags: z.ZodArray<z.ZodString, "many">;
+            preflightErrors: z.ZodArray<z.ZodString, "many">;
+            hasApprovedKeyframe: z.ZodBoolean;
+            hasPrompt: z.ZodBoolean;
+            readiness: z.ZodObject<{
+                hasApprovedKeyframe: z.ZodBoolean;
+                approvedComfyUiWorkflowIds: z.ZodArray<z.ZodString, "many">;
+                recommendedProvider: z.ZodEnum<["runway", "comfyui", "manual", "blocked"]>;
+                blockedReasons: z.ZodArray<z.ZodString, "many">;
+                warnings: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                warnings: string[];
+                hasApprovedKeyframe: boolean;
+                approvedComfyUiWorkflowIds: string[];
+                recommendedProvider: "blocked" | "manual" | "runway" | "comfyui";
+                blockedReasons: string[];
+            }, {
+                hasApprovedKeyframe: boolean;
+                approvedComfyUiWorkflowIds: string[];
+                recommendedProvider: "blocked" | "manual" | "runway" | "comfyui";
+                blockedReasons: string[];
+                warnings?: string[] | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            status: string;
+            subject: string;
+            readiness: {
+                warnings: string[];
+                hasApprovedKeyframe: boolean;
+                approvedComfyUiWorkflowIds: string[];
+                recommendedProvider: "blocked" | "manual" | "runway" | "comfyui";
+                blockedReasons: string[];
+            };
+            durationSeconds: number;
+            shotId: string;
+            shotCode: string;
+            shotType: string;
+            generationStrategy: string;
+            riskFlags: string[];
+            sceneId: string;
+            hasApprovedKeyframe: boolean;
+            preflightErrors: string[];
+            hasPrompt: boolean;
+            riskLevel?: "low" | "medium" | "high" | "avoid" | null | undefined;
+        }, {
+            status: string;
+            subject: string;
+            readiness: {
+                hasApprovedKeyframe: boolean;
+                approvedComfyUiWorkflowIds: string[];
+                recommendedProvider: "blocked" | "manual" | "runway" | "comfyui";
+                blockedReasons: string[];
+                warnings?: string[] | undefined;
+            };
+            durationSeconds: number;
+            shotId: string;
+            shotCode: string;
+            shotType: string;
+            generationStrategy: string;
+            riskFlags: string[];
+            sceneId: string;
+            hasApprovedKeyframe: boolean;
+            preflightErrors: string[];
+            hasPrompt: boolean;
+            riskLevel?: "low" | "medium" | "high" | "avoid" | null | undefined;
+        }>, "many">;
+        prompts: z.ZodArray<z.ZodObject<{
+            promptId: z.ZodString;
+            shotId: z.ZodString;
+            shotCode: z.ZodString;
+            promptCode: z.ZodString;
+            provider: z.ZodString;
+            positivePrompt: z.ZodString;
+            status: z.ZodString;
+            version: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            status: string;
+            provider: string;
+            version: number;
+            shotId: string;
+            promptId: string;
+            shotCode: string;
+            promptCode: string;
+            positivePrompt: string;
+        }, {
+            status: string;
+            provider: string;
+            version: number;
+            shotId: string;
+            promptId: string;
+            shotCode: string;
+            promptCode: string;
+            positivePrompt: string;
+        }>, "many">;
+        providerJobs: z.ZodObject<{
+            total: z.ZodNumber;
+            byStatus: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            recent: z.ZodArray<z.ZodObject<Pick<{
+                id: z.ZodString;
+                projectId: z.ZodString;
+                provider: z.ZodEnum<["openai", "runway", "comfyui", "elevenlabs"]>;
+                lane: z.ZodEnum<["llm", "video", "voice", "image", "storage", "edit"]>;
+                jobType: z.ZodEnum<["story_generation", "script_generation", "shot_prompt_compilation", "continuity_review", "retake_reasoning", "release_copy", "image_generation", "image_to_video", "text_to_video", "video_to_video", "character_generation", "keyframe_generation", "voice_generation", "dubbing", "sound_effect"]>;
+                sourceEntityType: z.ZodEnum<["film_project", "film_scene", "film_shot", "film_prompt", "film_keyframe", "film_clip", "film_character_bible", "workflow_artifact"]>;
+                sourceEntityId: z.ZodString;
+                shotId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                promptId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                keyframeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                clipId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                generationTaskId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                externalJobId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                externalTaskId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                providerModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                status: z.ZodEnum<["queued", "submitted", "running", "succeeded", "failed", "cancelled", "expired"]>;
+                submittedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                startedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                completedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                expiresAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                inputSnapshotJson: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+                outputAssetUrls: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+                outputMetadataJson: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+                errorCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                errorMessage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                estimatedCredits: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                actualCredits: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                costCurrencyCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                requestedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+            }, "id" | "status" | "provider" | "startedAt" | "completedAt" | "errorCode" | "errorMessage" | "lane" | "jobType" | "generationTaskId" | "externalJobId" | "submittedAt">, "strict", z.ZodTypeAny, {
+                id: string;
+                status: "running" | "failed" | "queued" | "cancelled" | "expired" | "submitted" | "succeeded";
+                provider: "elevenlabs" | "openai" | "runway" | "comfyui";
+                lane: "llm" | "video" | "voice" | "image" | "storage" | "edit";
+                jobType: "sound_effect" | "story_generation" | "script_generation" | "shot_prompt_compilation" | "continuity_review" | "retake_reasoning" | "release_copy" | "image_generation" | "image_to_video" | "text_to_video" | "video_to_video" | "character_generation" | "keyframe_generation" | "voice_generation" | "dubbing";
+                startedAt?: string | null | undefined;
+                completedAt?: string | null | undefined;
+                errorCode?: string | null | undefined;
+                errorMessage?: string | null | undefined;
+                generationTaskId?: string | null | undefined;
+                externalJobId?: string | null | undefined;
+                submittedAt?: string | null | undefined;
+            }, {
+                id: string;
+                status: "running" | "failed" | "queued" | "cancelled" | "expired" | "submitted" | "succeeded";
+                provider: "elevenlabs" | "openai" | "runway" | "comfyui";
+                lane: "llm" | "video" | "voice" | "image" | "storage" | "edit";
+                jobType: "sound_effect" | "story_generation" | "script_generation" | "shot_prompt_compilation" | "continuity_review" | "retake_reasoning" | "release_copy" | "image_generation" | "image_to_video" | "text_to_video" | "video_to_video" | "character_generation" | "keyframe_generation" | "voice_generation" | "dubbing";
+                startedAt?: string | null | undefined;
+                completedAt?: string | null | undefined;
+                errorCode?: string | null | undefined;
+                errorMessage?: string | null | undefined;
+                generationTaskId?: string | null | undefined;
+                externalJobId?: string | null | undefined;
+                submittedAt?: string | null | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            total: number;
+            recent: {
+                id: string;
+                status: "running" | "failed" | "queued" | "cancelled" | "expired" | "submitted" | "succeeded";
+                provider: "elevenlabs" | "openai" | "runway" | "comfyui";
+                lane: "llm" | "video" | "voice" | "image" | "storage" | "edit";
+                jobType: "sound_effect" | "story_generation" | "script_generation" | "shot_prompt_compilation" | "continuity_review" | "retake_reasoning" | "release_copy" | "image_generation" | "image_to_video" | "text_to_video" | "video_to_video" | "character_generation" | "keyframe_generation" | "voice_generation" | "dubbing";
+                startedAt?: string | null | undefined;
+                completedAt?: string | null | undefined;
+                errorCode?: string | null | undefined;
+                errorMessage?: string | null | undefined;
+                generationTaskId?: string | null | undefined;
+                externalJobId?: string | null | undefined;
+                submittedAt?: string | null | undefined;
+            }[];
+            byStatus: Record<string, number>;
+        }, {
+            total: number;
+            recent: {
+                id: string;
+                status: "running" | "failed" | "queued" | "cancelled" | "expired" | "submitted" | "succeeded";
+                provider: "elevenlabs" | "openai" | "runway" | "comfyui";
+                lane: "llm" | "video" | "voice" | "image" | "storage" | "edit";
+                jobType: "sound_effect" | "story_generation" | "script_generation" | "shot_prompt_compilation" | "continuity_review" | "retake_reasoning" | "release_copy" | "image_generation" | "image_to_video" | "text_to_video" | "video_to_video" | "character_generation" | "keyframe_generation" | "voice_generation" | "dubbing";
+                startedAt?: string | null | undefined;
+                completedAt?: string | null | undefined;
+                errorCode?: string | null | undefined;
+                errorMessage?: string | null | undefined;
+                generationTaskId?: string | null | undefined;
+                externalJobId?: string | null | undefined;
+                submittedAt?: string | null | undefined;
+            }[];
+            byStatus: Record<string, number>;
+        }>;
+        mediaAssets: z.ZodObject<{
+            total: z.ZodNumber;
+            byReviewStatus: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            recent: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                assetType: z.ZodString;
+                assetRole: z.ZodString;
+                reviewStatus: z.ZodString;
+                sourceProvider: z.ZodNullable<z.ZodString>;
+                sourceProviderJobId: z.ZodNullable<z.ZodString>;
+                sceneId: z.ZodNullable<z.ZodString>;
+                shotId: z.ZodNullable<z.ZodString>;
+                createdAt: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                createdAt: string;
+                assetType: string;
+                shotId: string | null;
+                sceneId: string | null;
+                reviewStatus: string;
+                assetRole: string;
+                sourceProvider: string | null;
+                sourceProviderJobId: string | null;
+            }, {
+                id: string;
+                createdAt: string;
+                assetType: string;
+                shotId: string | null;
+                sceneId: string | null;
+                reviewStatus: string;
+                assetRole: string;
+                sourceProvider: string | null;
+                sourceProviderJobId: string | null;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            total: number;
+            recent: {
+                id: string;
+                createdAt: string;
+                assetType: string;
+                shotId: string | null;
+                sceneId: string | null;
+                reviewStatus: string;
+                assetRole: string;
+                sourceProvider: string | null;
+                sourceProviderJobId: string | null;
+            }[];
+            byReviewStatus: Record<string, number>;
+        }, {
+            total: number;
+            recent: {
+                id: string;
+                createdAt: string;
+                assetType: string;
+                shotId: string | null;
+                sceneId: string | null;
+                reviewStatus: string;
+                assetRole: string;
+                sourceProvider: string | null;
+                sourceProviderJobId: string | null;
+            }[];
+            byReviewStatus: Record<string, number>;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        project: {
+            id: string;
+            title: string | null;
+            status: string | null;
+            workflowVariant: string | null;
+            kind: string | null;
+            projectKind: string | null;
+        };
+        artifacts: {
+            id: string;
+            status: string;
+            stageId: string;
+            guardianScore: number | null;
+            createdAt: string;
+            summary: string | null;
+            workflowStepId: string | null;
+            artifactType: string;
+            payload?: Record<string, unknown> | undefined;
+        }[];
+        generatedAt: string;
+        prompts: {
+            status: string;
+            provider: string;
+            version: number;
+            shotId: string;
+            promptId: string;
+            shotCode: string;
+            promptCode: string;
+            positivePrompt: string;
+        }[];
+        counts: {
+            artifacts: number;
+            prompts: number;
+            scenes: number;
+            shots: number;
+            acceptedArtifacts: number;
+            keyframes: number;
+            providerJobs: number;
+            mediaAssets: number;
+        };
+        scenes: {
+            title: string;
+            purpose: string;
+            sceneCode: string;
+            sequenceIndex: number;
+            sceneId: string;
+            shotCount: number;
+        }[];
+        shots: {
+            status: string;
+            subject: string;
+            readiness: {
+                warnings: string[];
+                hasApprovedKeyframe: boolean;
+                approvedComfyUiWorkflowIds: string[];
+                recommendedProvider: "blocked" | "manual" | "runway" | "comfyui";
+                blockedReasons: string[];
+            };
+            durationSeconds: number;
+            shotId: string;
+            shotCode: string;
+            shotType: string;
+            generationStrategy: string;
+            riskFlags: string[];
+            sceneId: string;
+            hasApprovedKeyframe: boolean;
+            preflightErrors: string[];
+            hasPrompt: boolean;
+            riskLevel?: "low" | "medium" | "high" | "avoid" | null | undefined;
+        }[];
+        providerJobs: {
+            total: number;
+            recent: {
+                id: string;
+                status: "running" | "failed" | "queued" | "cancelled" | "expired" | "submitted" | "succeeded";
+                provider: "elevenlabs" | "openai" | "runway" | "comfyui";
+                lane: "llm" | "video" | "voice" | "image" | "storage" | "edit";
+                jobType: "sound_effect" | "story_generation" | "script_generation" | "shot_prompt_compilation" | "continuity_review" | "retake_reasoning" | "release_copy" | "image_generation" | "image_to_video" | "text_to_video" | "video_to_video" | "character_generation" | "keyframe_generation" | "voice_generation" | "dubbing";
+                startedAt?: string | null | undefined;
+                completedAt?: string | null | undefined;
+                errorCode?: string | null | undefined;
+                errorMessage?: string | null | undefined;
+                generationTaskId?: string | null | undefined;
+                externalJobId?: string | null | undefined;
+                submittedAt?: string | null | undefined;
+            }[];
+            byStatus: Record<string, number>;
+        };
+        mediaAssets: {
+            total: number;
+            recent: {
+                id: string;
+                createdAt: string;
+                assetType: string;
+                shotId: string | null;
+                sceneId: string | null;
+                reviewStatus: string;
+                assetRole: string;
+                sourceProvider: string | null;
+                sourceProviderJobId: string | null;
+            }[];
+            byReviewStatus: Record<string, number>;
+        };
+    }, {
+        project: {
+            id: string;
+            title: string | null;
+            status: string | null;
+            workflowVariant: string | null;
+            kind: string | null;
+            projectKind: string | null;
+        };
+        artifacts: {
+            id: string;
+            status: string;
+            stageId: string;
+            guardianScore: number | null;
+            createdAt: string;
+            summary: string | null;
+            workflowStepId: string | null;
+            artifactType: string;
+            payload?: Record<string, unknown> | undefined;
+        }[];
+        generatedAt: string;
+        prompts: {
+            status: string;
+            provider: string;
+            version: number;
+            shotId: string;
+            promptId: string;
+            shotCode: string;
+            promptCode: string;
+            positivePrompt: string;
+        }[];
+        counts: {
+            artifacts: number;
+            prompts: number;
+            scenes: number;
+            shots: number;
+            acceptedArtifacts: number;
+            keyframes: number;
+            providerJobs: number;
+            mediaAssets: number;
+        };
+        scenes: {
+            title: string;
+            purpose: string;
+            sceneCode: string;
+            sequenceIndex: number;
+            sceneId: string;
+            shotCount: number;
+        }[];
+        shots: {
+            status: string;
+            subject: string;
+            readiness: {
+                hasApprovedKeyframe: boolean;
+                approvedComfyUiWorkflowIds: string[];
+                recommendedProvider: "blocked" | "manual" | "runway" | "comfyui";
+                blockedReasons: string[];
+                warnings?: string[] | undefined;
+            };
+            durationSeconds: number;
+            shotId: string;
+            shotCode: string;
+            shotType: string;
+            generationStrategy: string;
+            riskFlags: string[];
+            sceneId: string;
+            hasApprovedKeyframe: boolean;
+            preflightErrors: string[];
+            hasPrompt: boolean;
+            riskLevel?: "low" | "medium" | "high" | "avoid" | null | undefined;
+        }[];
+        providerJobs: {
+            total: number;
+            recent: {
+                id: string;
+                status: "running" | "failed" | "queued" | "cancelled" | "expired" | "submitted" | "succeeded";
+                provider: "elevenlabs" | "openai" | "runway" | "comfyui";
+                lane: "llm" | "video" | "voice" | "image" | "storage" | "edit";
+                jobType: "sound_effect" | "story_generation" | "script_generation" | "shot_prompt_compilation" | "continuity_review" | "retake_reasoning" | "release_copy" | "image_generation" | "image_to_video" | "text_to_video" | "video_to_video" | "character_generation" | "keyframe_generation" | "voice_generation" | "dubbing";
+                startedAt?: string | null | undefined;
+                completedAt?: string | null | undefined;
+                errorCode?: string | null | undefined;
+                errorMessage?: string | null | undefined;
+                generationTaskId?: string | null | undefined;
+                externalJobId?: string | null | undefined;
+                submittedAt?: string | null | undefined;
+            }[];
+            byStatus: Record<string, number>;
+        };
+        mediaAssets: {
+            total: number;
+            recent: {
+                id: string;
+                createdAt: string;
+                assetType: string;
+                shotId: string | null;
+                sceneId: string | null;
+                reviewStatus: string;
+                assetRole: string;
+                sourceProvider: string | null;
+                sourceProviderJobId: string | null;
+            }[];
+            byReviewStatus: Record<string, number>;
+        };
+    }>;
+    workflow: z.ZodObject<{
+        currentStep: z.ZodString;
+        steps: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            status: z.ZodEnum<["not_started", "in_progress", "blocked", "complete"]>;
+            blockers: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            nextActions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            status: "complete" | "not_started" | "blocked" | "in_progress";
+            blockers: string[];
+            nextActions: string[];
+        }, {
+            id: string;
+            status: "complete" | "not_started" | "blocked" | "in_progress";
+            blockers?: string[] | undefined;
+            nextActions?: string[] | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        steps: {
+            id: string;
+            status: "complete" | "not_started" | "blocked" | "in_progress";
+            blockers: string[];
+            nextActions: string[];
+        }[];
+        currentStep: string;
+    }, {
+        steps: {
+            id: string;
+            status: "complete" | "not_started" | "blocked" | "in_progress";
+            blockers?: string[] | undefined;
+            nextActions?: string[] | undefined;
+        }[];
+        currentStep: string;
+    }>;
+    planning: z.ZodObject<{
+        hydrateStatus: z.ZodObject<{
+            /** An accepted scene/shot artifact exists, so hydrate is meaningful. */
+            required: z.ZodBoolean;
+            /** film_scenes / film_shots / film_prompts rows exist. */
+            available: z.ZodBoolean;
+            blockers: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            required: boolean;
+            blockers: string[];
+            available: boolean;
+        }, {
+            required: boolean;
+            available: boolean;
+            blockers?: string[] | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        hydrateStatus: {
+            required: boolean;
+            blockers: string[];
+            available: boolean;
+        };
+    }, {
+        hydrateStatus: {
+            required: boolean;
+            available: boolean;
+            blockers?: string[] | undefined;
+        };
+    }>;
+    generation: z.ZodObject<{
+        providerJobsByStatus: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        hasFailures: z.ZodBoolean;
+        keyframes: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        keyframes: number;
+        providerJobsByStatus: Record<string, number>;
+        hasFailures: boolean;
+    }, {
+        keyframes: number;
+        providerJobsByStatus: Record<string, number>;
+        hasFailures: boolean;
+    }>;
+    kg: z.ZodObject<{
+        coverageStatus: z.ZodEnum<["empty", "partial", "export_ready"]>;
+        exportReady: z.ZodBoolean;
+        blockers: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        blockers: string[];
+        exportReady: boolean;
+        coverageStatus: "partial" | "empty" | "export_ready";
+    }, {
+        exportReady: boolean;
+        coverageStatus: "partial" | "empty" | "export_ready";
+        blockers?: string[] | undefined;
+    }>;
+    blockers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        severity: z.ZodEnum<["info", "warning", "error"]>;
+        message: z.ZodString;
+        step: z.ZodOptional<z.ZodString>;
+        repairAction: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        severity: "info" | "warning" | "error";
+        step?: string | undefined;
+        repairAction?: string | undefined;
+    }, {
+        code: string;
+        message: string;
+        severity: "info" | "warning" | "error";
+        step?: string | undefined;
+        repairAction?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    generation: {
+        keyframes: number;
+        providerJobsByStatus: Record<string, number>;
+        hasFailures: boolean;
+    };
+    generatedAt: string;
+    blockers: {
+        code: string;
+        message: string;
+        severity: "info" | "warning" | "error";
+        step?: string | undefined;
+        repairAction?: string | undefined;
+    }[];
+    workflow: {
+        steps: {
+            id: string;
+            status: "complete" | "not_started" | "blocked" | "in_progress";
+            blockers: string[];
+            nextActions: string[];
+        }[];
+        currentStep: string;
+    };
+    planning: {
+        hydrateStatus: {
+            required: boolean;
+            blockers: string[];
+            available: boolean;
+        };
+    };
+    kg: {
+        blockers: string[];
+        exportReady: boolean;
+        coverageStatus: "partial" | "empty" | "export_ready";
+    };
+    creative: {
+        project: {
+            id: string;
+            title: string | null;
+            status: string | null;
+            workflowVariant: string | null;
+            kind: string | null;
+            projectKind: string | null;
+        };
+        artifacts: {
+            id: string;
+            status: string;
+            stageId: string;
+            guardianScore: number | null;
+            createdAt: string;
+            summary: string | null;
+            workflowStepId: string | null;
+            artifactType: string;
+            payload?: Record<string, unknown> | undefined;
+        }[];
+        generatedAt: string;
+        prompts: {
+            status: string;
+            provider: string;
+            version: number;
+            shotId: string;
+            promptId: string;
+            shotCode: string;
+            promptCode: string;
+            positivePrompt: string;
+        }[];
+        counts: {
+            artifacts: number;
+            prompts: number;
+            scenes: number;
+            shots: number;
+            acceptedArtifacts: number;
+            keyframes: number;
+            providerJobs: number;
+            mediaAssets: number;
+        };
+        scenes: {
+            title: string;
+            purpose: string;
+            sceneCode: string;
+            sequenceIndex: number;
+            sceneId: string;
+            shotCount: number;
+        }[];
+        shots: {
+            status: string;
+            subject: string;
+            readiness: {
+                warnings: string[];
+                hasApprovedKeyframe: boolean;
+                approvedComfyUiWorkflowIds: string[];
+                recommendedProvider: "blocked" | "manual" | "runway" | "comfyui";
+                blockedReasons: string[];
+            };
+            durationSeconds: number;
+            shotId: string;
+            shotCode: string;
+            shotType: string;
+            generationStrategy: string;
+            riskFlags: string[];
+            sceneId: string;
+            hasApprovedKeyframe: boolean;
+            preflightErrors: string[];
+            hasPrompt: boolean;
+            riskLevel?: "low" | "medium" | "high" | "avoid" | null | undefined;
+        }[];
+        providerJobs: {
+            total: number;
+            recent: {
+                id: string;
+                status: "running" | "failed" | "queued" | "cancelled" | "expired" | "submitted" | "succeeded";
+                provider: "elevenlabs" | "openai" | "runway" | "comfyui";
+                lane: "llm" | "video" | "voice" | "image" | "storage" | "edit";
+                jobType: "sound_effect" | "story_generation" | "script_generation" | "shot_prompt_compilation" | "continuity_review" | "retake_reasoning" | "release_copy" | "image_generation" | "image_to_video" | "text_to_video" | "video_to_video" | "character_generation" | "keyframe_generation" | "voice_generation" | "dubbing";
+                startedAt?: string | null | undefined;
+                completedAt?: string | null | undefined;
+                errorCode?: string | null | undefined;
+                errorMessage?: string | null | undefined;
+                generationTaskId?: string | null | undefined;
+                externalJobId?: string | null | undefined;
+                submittedAt?: string | null | undefined;
+            }[];
+            byStatus: Record<string, number>;
+        };
+        mediaAssets: {
+            total: number;
+            recent: {
+                id: string;
+                createdAt: string;
+                assetType: string;
+                shotId: string | null;
+                sceneId: string | null;
+                reviewStatus: string;
+                assetRole: string;
+                sourceProvider: string | null;
+                sourceProviderJobId: string | null;
+            }[];
+            byReviewStatus: Record<string, number>;
+        };
+    };
+}, {
+    generation: {
+        keyframes: number;
+        providerJobsByStatus: Record<string, number>;
+        hasFailures: boolean;
+    };
+    generatedAt: string;
+    workflow: {
+        steps: {
+            id: string;
+            status: "complete" | "not_started" | "blocked" | "in_progress";
+            blockers?: string[] | undefined;
+            nextActions?: string[] | undefined;
+        }[];
+        currentStep: string;
+    };
+    planning: {
+        hydrateStatus: {
+            required: boolean;
+            available: boolean;
+            blockers?: string[] | undefined;
+        };
+    };
+    kg: {
+        exportReady: boolean;
+        coverageStatus: "partial" | "empty" | "export_ready";
+        blockers?: string[] | undefined;
+    };
+    creative: {
+        project: {
+            id: string;
+            title: string | null;
+            status: string | null;
+            workflowVariant: string | null;
+            kind: string | null;
+            projectKind: string | null;
+        };
+        artifacts: {
+            id: string;
+            status: string;
+            stageId: string;
+            guardianScore: number | null;
+            createdAt: string;
+            summary: string | null;
+            workflowStepId: string | null;
+            artifactType: string;
+            payload?: Record<string, unknown> | undefined;
+        }[];
+        generatedAt: string;
+        prompts: {
+            status: string;
+            provider: string;
+            version: number;
+            shotId: string;
+            promptId: string;
+            shotCode: string;
+            promptCode: string;
+            positivePrompt: string;
+        }[];
+        counts: {
+            artifacts: number;
+            prompts: number;
+            scenes: number;
+            shots: number;
+            acceptedArtifacts: number;
+            keyframes: number;
+            providerJobs: number;
+            mediaAssets: number;
+        };
+        scenes: {
+            title: string;
+            purpose: string;
+            sceneCode: string;
+            sequenceIndex: number;
+            sceneId: string;
+            shotCount: number;
+        }[];
+        shots: {
+            status: string;
+            subject: string;
+            readiness: {
+                hasApprovedKeyframe: boolean;
+                approvedComfyUiWorkflowIds: string[];
+                recommendedProvider: "blocked" | "manual" | "runway" | "comfyui";
+                blockedReasons: string[];
+                warnings?: string[] | undefined;
+            };
+            durationSeconds: number;
+            shotId: string;
+            shotCode: string;
+            shotType: string;
+            generationStrategy: string;
+            riskFlags: string[];
+            sceneId: string;
+            hasApprovedKeyframe: boolean;
+            preflightErrors: string[];
+            hasPrompt: boolean;
+            riskLevel?: "low" | "medium" | "high" | "avoid" | null | undefined;
+        }[];
+        providerJobs: {
+            total: number;
+            recent: {
+                id: string;
+                status: "running" | "failed" | "queued" | "cancelled" | "expired" | "submitted" | "succeeded";
+                provider: "elevenlabs" | "openai" | "runway" | "comfyui";
+                lane: "llm" | "video" | "voice" | "image" | "storage" | "edit";
+                jobType: "sound_effect" | "story_generation" | "script_generation" | "shot_prompt_compilation" | "continuity_review" | "retake_reasoning" | "release_copy" | "image_generation" | "image_to_video" | "text_to_video" | "video_to_video" | "character_generation" | "keyframe_generation" | "voice_generation" | "dubbing";
+                startedAt?: string | null | undefined;
+                completedAt?: string | null | undefined;
+                errorCode?: string | null | undefined;
+                errorMessage?: string | null | undefined;
+                generationTaskId?: string | null | undefined;
+                externalJobId?: string | null | undefined;
+                submittedAt?: string | null | undefined;
+            }[];
+            byStatus: Record<string, number>;
+        };
+        mediaAssets: {
+            total: number;
+            recent: {
+                id: string;
+                createdAt: string;
+                assetType: string;
+                shotId: string | null;
+                sceneId: string | null;
+                reviewStatus: string;
+                assetRole: string;
+                sourceProvider: string | null;
+                sourceProviderJobId: string | null;
+            }[];
+            byReviewStatus: Record<string, number>;
+        };
+    };
+    blockers?: {
+        code: string;
+        message: string;
+        severity: "info" | "warning" | "error";
+        step?: string | undefined;
+        repairAction?: string | undefined;
+    }[] | undefined;
+}>;
+export type FilmProductionReadModel = z.infer<typeof FilmProductionReadModelSchema>;