@neuraloom/contracts 0.0.0-stage → 0.1.23

package/dist/schemas/film/film-ofi-report.schema.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilmOfiReportGenerateInputSchema = exports.FilmOfiReportSchema = exports.FilmOfiCoverageGapSchema = exports.FilmOfiReferencePackStatSchema = exports.FilmOfiPromptTemplateStatSchema = exports.FilmOfiShotStatSchema = void 0;
+/**
+ * Film OFI Report — machine-readable per-film telemetry aggregate.
+ *
+ * Built deterministically (SQL + TS reducer) from `film_generation_telemetry`
+ * and `film_clip_review_scores`. Becomes the input to the critic that
+ * produces the carry-forward FilmLessonsManifest for the next film.
+ */
+const zod_1 = require("zod");
+const film_production_style_schema_1 = require("./film-production-style.schema");
+const film_clip_review_scores_schema_1 = require("./film-clip-review-scores.schema");
+const ScoreBreakdown = zod_1.z.object(Object.fromEntries(film_clip_review_scores_schema_1.FILM_REVIEW_SCORE_DIMENSIONS.map((d) => [d, zod_1.z.number().min(0).max(10)])));
+exports.FilmOfiShotStatSchema = zod_1.z.object({
+    shotId: zod_1.z.string().uuid(),
+    shotCode: zod_1.z.string().min(1),
+    attempts: zod_1.z.number().int().nonnegative(),
+    /** 1-indexed attempt number that was accepted; null if no attempt was accepted. */
+    acceptedAttempt: zod_1.z.number().int().positive().nullable(),
+    meanScores: ScoreBreakdown,
+    topReasonCodes: zod_1.z.array(zod_1.z.string()).default([]),
+    budgetExceeded: zod_1.z.boolean(),
+});
+exports.FilmOfiPromptTemplateStatSchema = zod_1.z.object({
+    templateId: zod_1.z.string().min(1),
+    uses: zod_1.z.number().int().nonnegative(),
+    acceptanceRate: zod_1.z.number().min(0).max(1),
+    meanScore: zod_1.z.number().min(0).max(10),
+    topFailureReasonCodes: zod_1.z.array(zod_1.z.string()).default([]),
+});
+exports.FilmOfiReferencePackStatSchema = zod_1.z.object({
+    packId: zod_1.z.string().uuid(),
+    uses: zod_1.z.number().int().nonnegative(),
+    acceptanceRate: zod_1.z.number().min(0).max(1),
+    driftIndicators: zod_1.z.array(zod_1.z.string()).default([]),
+});
+exports.FilmOfiCoverageGapSchema = zod_1.z.object({
+    shotId: zod_1.z.string().uuid(),
+    shotCode: zod_1.z.string().min(1),
+    reason: zod_1.z.string().min(1),
+});
+exports.FilmOfiReportSchema = zod_1.z.object({
+    filmId: zod_1.z.string().min(1),
+    projectId: zod_1.z.string().uuid(),
+    productionStyle: film_production_style_schema_1.FilmProductionStyleSchema,
+    generatedAt: zod_1.z.string().datetime(),
+    version: zod_1.z.number().int().positive().default(1),
+    shotStats: zod_1.z.array(exports.FilmOfiShotStatSchema).default([]),
+    promptTemplateStats: zod_1.z.array(exports.FilmOfiPromptTemplateStatSchema).default([]),
+    referencePackStats: zod_1.z.array(exports.FilmOfiReferencePackStatSchema).default([]),
+    budgetBreaches: zod_1.z.array(exports.FilmOfiShotStatSchema).default([]),
+    coverageGaps: zod_1.z.array(exports.FilmOfiCoverageGapSchema).default([]),
+    costSummary: zod_1.z.object({
+        totalCostUnits: zod_1.z.number().nonnegative(),
+        meanCostUnitsPerAcceptedShot: zod_1.z.number().nonnegative(),
+        totalAttempts: zod_1.z.number().int().nonnegative(),
+        acceptedShots: zod_1.z.number().int().nonnegative(),
+    }),
+});
+// ─── API contract (FP-15: every /api/film route has a typed wrapper) ──────────
+exports.FilmOfiReportGenerateInputSchema = zod_1.z.object({
+    projectId: zod_1.z.string().uuid(),
+    filmId: zod_1.z.string().min(1).optional(),
+});

package/dist/schemas/film/film-otio-sidecar.schema.d.ts

@@ -0,0 +1,136 @@
+import { z } from 'zod';
+/** Items flattened across tracks — sibling manifest next to exported OTIO JSON. */
+export declare const OtioJsonSidecarItemSchema: z.ZodObject<{
+    itemId: z.ZodString;
+    clipId: z.ZodString;
+    shotId: z.ZodString;
+    reviewId: z.ZodOptional<z.ZodString>;
+    recordStartFrame: z.ZodNumber;
+    sourceStartFrame: z.ZodNumber;
+    sourceEndFrame: z.ZodNumber;
+    durationFrames: z.ZodNumber;
+    trackIndex: z.ZodNumber;
+    mediaType: z.ZodEnum<["video", "audio", "subtitle"]>;
+    filename: z.ZodString;
+    storagePath: z.ZodString;
+    customData: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    storagePath: string;
+    shotId: string;
+    durationFrames: number;
+    clipId: string;
+    customData: Record<string, unknown>;
+    itemId: string;
+    recordStartFrame: number;
+    sourceStartFrame: number;
+    sourceEndFrame: number;
+    trackIndex: number;
+    mediaType: "subtitle" | "audio" | "video";
+    filename: string;
+    reviewId?: string | undefined;
+}, {
+    storagePath: string;
+    shotId: string;
+    durationFrames: number;
+    clipId: string;
+    itemId: string;
+    recordStartFrame: number;
+    sourceStartFrame: number;
+    sourceEndFrame: number;
+    trackIndex: number;
+    mediaType: "subtitle" | "audio" | "video";
+    filename: string;
+    customData?: Record<string, unknown> | undefined;
+    reviewId?: string | undefined;
+}>;
+export type OtioJsonSidecarItem = z.infer<typeof OtioJsonSidecarItemSchema>;
+export declare const OtioJsonSidecarSchema: z.ZodObject<{
+    timelineId: z.ZodString;
+    projectId: z.ZodString;
+    frameRate: z.ZodNumber;
+    totalDurationFrames: z.ZodNumber;
+    items: z.ZodArray<z.ZodObject<{
+        itemId: z.ZodString;
+        clipId: z.ZodString;
+        shotId: z.ZodString;
+        reviewId: z.ZodOptional<z.ZodString>;
+        recordStartFrame: z.ZodNumber;
+        sourceStartFrame: z.ZodNumber;
+        sourceEndFrame: z.ZodNumber;
+        durationFrames: z.ZodNumber;
+        trackIndex: z.ZodNumber;
+        mediaType: z.ZodEnum<["video", "audio", "subtitle"]>;
+        filename: z.ZodString;
+        storagePath: z.ZodString;
+        customData: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        storagePath: string;
+        shotId: string;
+        durationFrames: number;
+        clipId: string;
+        customData: Record<string, unknown>;
+        itemId: string;
+        recordStartFrame: number;
+        sourceStartFrame: number;
+        sourceEndFrame: number;
+        trackIndex: number;
+        mediaType: "subtitle" | "audio" | "video";
+        filename: string;
+        reviewId?: string | undefined;
+    }, {
+        storagePath: string;
+        shotId: string;
+        durationFrames: number;
+        clipId: string;
+        itemId: string;
+        recordStartFrame: number;
+        sourceStartFrame: number;
+        sourceEndFrame: number;
+        trackIndex: number;
+        mediaType: "subtitle" | "audio" | "video";
+        filename: string;
+        customData?: Record<string, unknown> | undefined;
+        reviewId?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    items: {
+        storagePath: string;
+        shotId: string;
+        durationFrames: number;
+        clipId: string;
+        customData: Record<string, unknown>;
+        itemId: string;
+        recordStartFrame: number;
+        sourceStartFrame: number;
+        sourceEndFrame: number;
+        trackIndex: number;
+        mediaType: "subtitle" | "audio" | "video";
+        filename: string;
+        reviewId?: string | undefined;
+    }[];
+    frameRate: number;
+    totalDurationFrames: number;
+    timelineId: string;
+}, {
+    projectId: string;
+    items: {
+        storagePath: string;
+        shotId: string;
+        durationFrames: number;
+        clipId: string;
+        itemId: string;
+        recordStartFrame: number;
+        sourceStartFrame: number;
+        sourceEndFrame: number;
+        trackIndex: number;
+        mediaType: "subtitle" | "audio" | "video";
+        filename: string;
+        customData?: Record<string, unknown> | undefined;
+        reviewId?: string | undefined;
+    }[];
+    frameRate: number;
+    totalDurationFrames: number;
+    timelineId: string;
+}>;
+export type OtioJsonSidecar = z.infer<typeof OtioJsonSidecarSchema>;

package/dist/schemas/film/film-otio-sidecar.schema.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OtioJsonSidecarSchema = exports.OtioJsonSidecarItemSchema = void 0;
+const zod_1 = require("zod");
+const film_edit_sequence_schema_1 = require("./film-edit-sequence.schema");
+/** Items flattened across tracks — sibling manifest next to exported OTIO JSON. */
+exports.OtioJsonSidecarItemSchema = zod_1.z.object({
+    itemId: zod_1.z.string().uuid(),
+    clipId: zod_1.z.string().uuid(),
+    shotId: zod_1.z.string().uuid(),
+    reviewId: zod_1.z.string().uuid().optional(),
+    recordStartFrame: zod_1.z.number().int().nonnegative(),
+    sourceStartFrame: zod_1.z.number().int().nonnegative(),
+    sourceEndFrame: zod_1.z.number().int().nonnegative(),
+    durationFrames: zod_1.z.number().int().positive(),
+    trackIndex: zod_1.z.number().int().nonnegative(),
+    mediaType: film_edit_sequence_schema_1.FilmEditSequenceTrackMediaTypeSchema,
+    filename: zod_1.z.string().min(1),
+    storagePath: zod_1.z.string(),
+    customData: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).default({}),
+});
+exports.OtioJsonSidecarSchema = zod_1.z.object({
+    timelineId: zod_1.z.string().uuid(),
+    projectId: zod_1.z.string().uuid(),
+    frameRate: zod_1.z.number().positive(),
+    totalDurationFrames: zod_1.z.number().int().nonnegative(),
+    items: zod_1.z.array(exports.OtioJsonSidecarItemSchema),
+});

package/dist/schemas/film/film-production-coverage.schema.d.ts

@@ -0,0 +1,179 @@
+/**
+ * FilmProductionCoverage — canonical coverage object (PR6).
+ *
+ * Powers generation status display, review readiness, release gates,
+ * export UI, and dashboards across the film production operator shell.
+ *
+ * Constitutional:
+ *   - Types owned by @neuraloom/contracts only (never inline in frontend)
+ *   - Export/release NEVER complete from prompt packs alone when clip/shot
+ *     coverage is insufficient (enforced via exportBlockedReasons)
+ *
+ * SSOT: packages/contracts/src/schemas/film/film-production-coverage.schema.ts
+ */
+import { z } from 'zod';
+export declare const FILM_EXPORT_BLOCK_SEVERITIES: readonly ["info", "warning", "critical"];
+export type FilmExportBlockSeverity = (typeof FILM_EXPORT_BLOCK_SEVERITIES)[number];
+export declare const FilmExportBlockSeveritySchema: z.ZodEnum<["info", "warning", "critical"]>;
+export declare const FilmExportBlockReasonSchema: z.ZodObject<{
+    code: z.ZodString;
+    label: z.ZodString;
+    count: z.ZodNumber;
+    severity: z.ZodEnum<["info", "warning", "critical"]>;
+}, "strict", z.ZodTypeAny, {
+    code: string;
+    severity: "info" | "warning" | "critical";
+    count: number;
+    label: string;
+}, {
+    code: string;
+    severity: "info" | "warning" | "critical";
+    count: number;
+    label: string;
+}>;
+export type FilmExportBlockReason = z.infer<typeof FilmExportBlockReasonSchema>;
+export declare const FILM_EXPORT_BLOCK_CODES: {
+    /** Export attempted from prompt pack completion alone — shots/clips incomplete. */
+    readonly PROMPT_PACK_ONLY: "PROMPT_PACK_ONLY";
+    /** Shots exist but no clips generated for them. */
+    readonly SHOTS_WITHOUT_CLIPS: "SHOTS_WITHOUT_CLIPS";
+    /** Clips generated but none selected for export. */
+    readonly NO_SELECTED_CLIPS: "NO_SELECTED_CLIPS";
+    /** Shots blocked (pre-flight / risk failure). */
+    readonly BLOCKED_SHOTS: "BLOCKED_SHOTS";
+    /** Scenes not fully approved. */
+    readonly UNAPPROVED_SCENES: "UNAPPROVED_SCENES";
+    /** Clips generated but not reviewed. */
+    readonly UNREVIEWED_CLIPS: "UNREVIEWED_CLIPS";
+};
+export type FilmExportBlockCode = (typeof FILM_EXPORT_BLOCK_CODES)[keyof typeof FILM_EXPORT_BLOCK_CODES];
+export declare const FILM_RELEASE_GATE_BLOCK_CODES: {
+    readonly REVIEW_REPORT_MISSING: "REVIEW_REPORT_MISSING";
+    readonly REVIEW_NOT_EXPORT_READY: "REVIEW_NOT_EXPORT_READY";
+    readonly REVIEW_GUARDIAN_NOT_ACCEPTED: "REVIEW_GUARDIAN_NOT_ACCEPTED";
+    readonly FILM_GATE_BLOCKED: "FILM_GATE_BLOCKED";
+    readonly KG_COVERAGE_BLOCKED: "KG_COVERAGE_BLOCKED";
+    readonly HUMAN_APPROVAL_MISSING: "HUMAN_APPROVAL_MISSING";
+};
+export type FilmReleaseGateBlockCode = (typeof FILM_RELEASE_GATE_BLOCK_CODES)[keyof typeof FILM_RELEASE_GATE_BLOCK_CODES];
+export declare const FilmReleaseGateBlockerSchema: z.ZodObject<{
+    code: z.ZodEnum<["REVIEW_REPORT_MISSING", "REVIEW_NOT_EXPORT_READY", "REVIEW_GUARDIAN_NOT_ACCEPTED", "FILM_GATE_BLOCKED", "KG_COVERAGE_BLOCKED", "HUMAN_APPROVAL_MISSING"]>;
+    message: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    code: "REVIEW_REPORT_MISSING" | "REVIEW_NOT_EXPORT_READY" | "REVIEW_GUARDIAN_NOT_ACCEPTED" | "FILM_GATE_BLOCKED" | "KG_COVERAGE_BLOCKED" | "HUMAN_APPROVAL_MISSING";
+    message: string;
+}, {
+    code: "REVIEW_REPORT_MISSING" | "REVIEW_NOT_EXPORT_READY" | "REVIEW_GUARDIAN_NOT_ACCEPTED" | "FILM_GATE_BLOCKED" | "KG_COVERAGE_BLOCKED" | "HUMAN_APPROVAL_MISSING";
+    message: string;
+}>;
+export type FilmReleaseGateBlocker = z.infer<typeof FilmReleaseGateBlockerSchema>;
+export declare const FilmReleaseGateDecisionSchema: z.ZodObject<{
+    allowed: z.ZodBoolean;
+    blockers: z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<["REVIEW_REPORT_MISSING", "REVIEW_NOT_EXPORT_READY", "REVIEW_GUARDIAN_NOT_ACCEPTED", "FILM_GATE_BLOCKED", "KG_COVERAGE_BLOCKED", "HUMAN_APPROVAL_MISSING"]>;
+        message: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        code: "REVIEW_REPORT_MISSING" | "REVIEW_NOT_EXPORT_READY" | "REVIEW_GUARDIAN_NOT_ACCEPTED" | "FILM_GATE_BLOCKED" | "KG_COVERAGE_BLOCKED" | "HUMAN_APPROVAL_MISSING";
+        message: string;
+    }, {
+        code: "REVIEW_REPORT_MISSING" | "REVIEW_NOT_EXPORT_READY" | "REVIEW_GUARDIAN_NOT_ACCEPTED" | "FILM_GATE_BLOCKED" | "KG_COVERAGE_BLOCKED" | "HUMAN_APPROVAL_MISSING";
+        message: string;
+    }>, "many">;
+    checkedAt: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    blockers: {
+        code: "REVIEW_REPORT_MISSING" | "REVIEW_NOT_EXPORT_READY" | "REVIEW_GUARDIAN_NOT_ACCEPTED" | "FILM_GATE_BLOCKED" | "KG_COVERAGE_BLOCKED" | "HUMAN_APPROVAL_MISSING";
+        message: string;
+    }[];
+    checkedAt: string;
+    allowed: boolean;
+}, {
+    blockers: {
+        code: "REVIEW_REPORT_MISSING" | "REVIEW_NOT_EXPORT_READY" | "REVIEW_GUARDIAN_NOT_ACCEPTED" | "FILM_GATE_BLOCKED" | "KG_COVERAGE_BLOCKED" | "HUMAN_APPROVAL_MISSING";
+        message: string;
+    }[];
+    checkedAt: string;
+    allowed: boolean;
+}>;
+export type FilmReleaseGateDecision = z.infer<typeof FilmReleaseGateDecisionSchema>;
+export declare const FilmProductionCoverageSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    scenesTotal: z.ZodNumber;
+    scenesApproved: z.ZodNumber;
+    shotsTotal: z.ZodNumber;
+    shotsPromptReady: z.ZodNumber;
+    shotsWithGeneratedClip: z.ZodNumber;
+    shotsWithSelectedClip: z.ZodNumber;
+    shotsBlocked: z.ZodNumber;
+    clipsTotal: z.ZodNumber;
+    clipsReviewed: z.ZodNumber;
+    clipsSelected: z.ZodNumber;
+    exportableShots: z.ZodNumber;
+    exportBlockedReasons: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        label: z.ZodString;
+        count: z.ZodNumber;
+        severity: z.ZodEnum<["info", "warning", "critical"]>;
+    }, "strict", z.ZodTypeAny, {
+        code: string;
+        severity: "info" | "warning" | "critical";
+        count: number;
+        label: string;
+    }, {
+        code: string;
+        severity: "info" | "warning" | "critical";
+        count: number;
+        label: string;
+    }>, "many">;
+    /** True only when all shots have selected clips and no critical export blockers. */
+    isExportReady: z.ZodBoolean;
+    /** True when prompt pack is complete but clip coverage is insufficient. */
+    isPromptPackOnlyComplete: z.ZodBoolean;
+    computedAt: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    projectId: string;
+    computedAt: string;
+    scenesTotal: number;
+    scenesApproved: number;
+    shotsTotal: number;
+    shotsPromptReady: number;
+    shotsWithGeneratedClip: number;
+    shotsWithSelectedClip: number;
+    shotsBlocked: number;
+    clipsTotal: number;
+    clipsReviewed: number;
+    clipsSelected: number;
+    exportableShots: number;
+    exportBlockedReasons: {
+        code: string;
+        severity: "info" | "warning" | "critical";
+        count: number;
+        label: string;
+    }[];
+    isExportReady: boolean;
+    isPromptPackOnlyComplete: boolean;
+}, {
+    projectId: string;
+    computedAt: string;
+    scenesTotal: number;
+    scenesApproved: number;
+    shotsTotal: number;
+    shotsPromptReady: number;
+    shotsWithGeneratedClip: number;
+    shotsWithSelectedClip: number;
+    shotsBlocked: number;
+    clipsTotal: number;
+    clipsReviewed: number;
+    clipsSelected: number;
+    exportableShots: number;
+    exportBlockedReasons: {
+        code: string;
+        severity: "info" | "warning" | "critical";
+        count: number;
+        label: string;
+    }[];
+    isExportReady: boolean;
+    isPromptPackOnlyComplete: boolean;
+}>;
+export type FilmProductionCoverage = z.infer<typeof FilmProductionCoverageSchema>;
+export declare function emptyFilmProductionCoverage(projectId: string): FilmProductionCoverage;

package/dist/schemas/film/film-production-coverage.schema.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * FilmProductionCoverage — canonical coverage object (PR6).
+ *
+ * Powers generation status display, review readiness, release gates,
+ * export UI, and dashboards across the film production operator shell.
+ *
+ * Constitutional:
+ *   - Types owned by @neuraloom/contracts only (never inline in frontend)
+ *   - Export/release NEVER complete from prompt packs alone when clip/shot
+ *     coverage is insufficient (enforced via exportBlockedReasons)
+ *
+ * SSOT: packages/contracts/src/schemas/film/film-production-coverage.schema.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilmProductionCoverageSchema = exports.FilmReleaseGateDecisionSchema = exports.FilmReleaseGateBlockerSchema = exports.FILM_RELEASE_GATE_BLOCK_CODES = exports.FILM_EXPORT_BLOCK_CODES = exports.FilmExportBlockReasonSchema = exports.FilmExportBlockSeveritySchema = exports.FILM_EXPORT_BLOCK_SEVERITIES = void 0;
+exports.emptyFilmProductionCoverage = emptyFilmProductionCoverage;
+const zod_1 = require("zod");
+// ─── Export block reason severity ────────────────────────────────────────────
+exports.FILM_EXPORT_BLOCK_SEVERITIES = ['info', 'warning', 'critical'];
+exports.FilmExportBlockSeveritySchema = zod_1.z.enum(exports.FILM_EXPORT_BLOCK_SEVERITIES);
+// ─── Individual export block reason ──────────────────────────────────────────
+exports.FilmExportBlockReasonSchema = zod_1.z
+    .object({
+    code: zod_1.z.string().min(1),
+    label: zod_1.z.string().min(1),
+    count: zod_1.z.number().int().nonnegative(),
+    severity: exports.FilmExportBlockSeveritySchema,
+})
+    .strict();
+// ─── Well-known export block codes ───────────────────────────────────────────
+exports.FILM_EXPORT_BLOCK_CODES = {
+    /** Export attempted from prompt pack completion alone — shots/clips incomplete. */
+    PROMPT_PACK_ONLY: 'PROMPT_PACK_ONLY',
+    /** Shots exist but no clips generated for them. */
+    SHOTS_WITHOUT_CLIPS: 'SHOTS_WITHOUT_CLIPS',
+    /** Clips generated but none selected for export. */
+    NO_SELECTED_CLIPS: 'NO_SELECTED_CLIPS',
+    /** Shots blocked (pre-flight / risk failure). */
+    BLOCKED_SHOTS: 'BLOCKED_SHOTS',
+    /** Scenes not fully approved. */
+    UNAPPROVED_SCENES: 'UNAPPROVED_SCENES',
+    /** Clips generated but not reviewed. */
+    UNREVIEWED_CLIPS: 'UNREVIEWED_CLIPS',
+};
+exports.FILM_RELEASE_GATE_BLOCK_CODES = {
+    REVIEW_REPORT_MISSING: 'REVIEW_REPORT_MISSING',
+    REVIEW_NOT_EXPORT_READY: 'REVIEW_NOT_EXPORT_READY',
+    REVIEW_GUARDIAN_NOT_ACCEPTED: 'REVIEW_GUARDIAN_NOT_ACCEPTED',
+    FILM_GATE_BLOCKED: 'FILM_GATE_BLOCKED',
+    KG_COVERAGE_BLOCKED: 'KG_COVERAGE_BLOCKED',
+    HUMAN_APPROVAL_MISSING: 'HUMAN_APPROVAL_MISSING',
+};
+exports.FilmReleaseGateBlockerSchema = zod_1.z
+    .object({
+    code: zod_1.z.enum([
+        exports.FILM_RELEASE_GATE_BLOCK_CODES.REVIEW_REPORT_MISSING,
+        exports.FILM_RELEASE_GATE_BLOCK_CODES.REVIEW_NOT_EXPORT_READY,
+        exports.FILM_RELEASE_GATE_BLOCK_CODES.REVIEW_GUARDIAN_NOT_ACCEPTED,
+        exports.FILM_RELEASE_GATE_BLOCK_CODES.FILM_GATE_BLOCKED,
+        exports.FILM_RELEASE_GATE_BLOCK_CODES.KG_COVERAGE_BLOCKED,
+        exports.FILM_RELEASE_GATE_BLOCK_CODES.HUMAN_APPROVAL_MISSING,
+    ]),
+    message: zod_1.z.string().min(1),
+})
+    .strict();
+exports.FilmReleaseGateDecisionSchema = zod_1.z
+    .object({
+    allowed: zod_1.z.boolean(),
+    blockers: zod_1.z.array(exports.FilmReleaseGateBlockerSchema),
+    checkedAt: zod_1.z.string().datetime(),
+})
+    .strict();
+// ─── Main coverage schema ─────────────────────────────────────────────────────
+exports.FilmProductionCoverageSchema = zod_1.z
+    .object({
+    projectId: zod_1.z.string().uuid(),
+    // Scene coverage
+    scenesTotal: zod_1.z.number().int().nonnegative(),
+    scenesApproved: zod_1.z.number().int().nonnegative(),
+    // Shot coverage
+    shotsTotal: zod_1.z.number().int().nonnegative(),
+    shotsPromptReady: zod_1.z.number().int().nonnegative(),
+    shotsWithGeneratedClip: zod_1.z.number().int().nonnegative(),
+    shotsWithSelectedClip: zod_1.z.number().int().nonnegative(),
+    shotsBlocked: zod_1.z.number().int().nonnegative(),
+    // Clip coverage
+    clipsTotal: zod_1.z.number().int().nonnegative(),
+    clipsReviewed: zod_1.z.number().int().nonnegative(),
+    clipsSelected: zod_1.z.number().int().nonnegative(),
+    // Exportability
+    exportableShots: zod_1.z.number().int().nonnegative(),
+    exportBlockedReasons: zod_1.z.array(exports.FilmExportBlockReasonSchema),
+    // Derived summary flags
+    /** True only when all shots have selected clips and no critical export blockers. */
+    isExportReady: zod_1.z.boolean(),
+    /** True when prompt pack is complete but clip coverage is insufficient. */
+    isPromptPackOnlyComplete: zod_1.z.boolean(),
+    // Computed at
+    computedAt: zod_1.z.string().datetime(),
+})
+    .strict();
+// ─── Empty coverage factory ───────────────────────────────────────────────────
+function emptyFilmProductionCoverage(projectId) {
+    return {
+        projectId,
+        scenesTotal: 0,
+        scenesApproved: 0,
+        shotsTotal: 0,
+        shotsPromptReady: 0,
+        shotsWithGeneratedClip: 0,
+        shotsWithSelectedClip: 0,
+        shotsBlocked: 0,
+        clipsTotal: 0,
+        clipsReviewed: 0,
+        clipsSelected: 0,
+        exportableShots: 0,
+        exportBlockedReasons: [],
+        isExportReady: false,
+        isPromptPackOnlyComplete: false,
+        computedAt: new Date().toISOString(),
+    };
+}