@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/schemas/film/film-clip-review-orchestration.schema.d.ts

@@ -0,0 +1,234 @@
+import { z } from "zod";
+export declare const FilmClipReviewScoresOrchestrationInputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    orchestrationId: z.ZodString;
+    /** When true, reuse latest persisted structured scores + plan (no vision model). */
+    skipVision: z.ZodOptional<z.ZodBoolean>;
+    /** PR-N: attempt automatic winner rollup once sibling reviews hydrate. */
+    takeComparisonId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    projectId: string;
+    orchestrationId: string;
+    takeComparisonId?: string | undefined;
+    skipVision?: boolean | undefined;
+}, {
+    projectId: string;
+    orchestrationId: string;
+    takeComparisonId?: string | undefined;
+    skipVision?: boolean | undefined;
+}>;
+export type FilmClipReviewScoresOrchestrationInput = z.infer<typeof FilmClipReviewScoresOrchestrationInputSchema>;
+export declare const FilmClipReviewScoresOrchestrationResultSchema: z.ZodObject<{
+    scores: z.ZodObject<{
+        characterMatch: z.ZodNumber;
+        wardrobeMatch: z.ZodNumber;
+        locationMatch: z.ZodNumber;
+        styleMatch: z.ZodNumber;
+        cameraMatch: z.ZodNumber;
+        motionQuality: z.ZodNumber;
+        artifactScore: z.ZodNumber;
+        editUsability: z.ZodNumber;
+        overallUsability: z.ZodNumber;
+        reasoning: z.ZodString;
+        detectedIssues: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        scoredBy: z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+            version: z.ZodString;
+            scoredAt: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            provider: string;
+            version: string;
+            model: string;
+            scoredAt: string;
+        }, {
+            provider: string;
+            version: string;
+            model: string;
+            scoredAt: string;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        characterMatch: number;
+        wardrobeMatch: number;
+        locationMatch: number;
+        styleMatch: number;
+        cameraMatch: number;
+        artifactScore: number;
+        overallUsability: number;
+        reasoning: string;
+        detectedIssues: string[];
+        scoredBy: {
+            provider: string;
+            version: string;
+            model: string;
+            scoredAt: string;
+        };
+        motionQuality: number;
+        editUsability: number;
+    }, {
+        characterMatch: number;
+        wardrobeMatch: number;
+        locationMatch: number;
+        styleMatch: number;
+        cameraMatch: number;
+        artifactScore: number;
+        overallUsability: number;
+        reasoning: string;
+        scoredBy: {
+            provider: string;
+            version: string;
+            model: string;
+            scoredAt: string;
+        };
+        motionQuality: number;
+        editUsability: number;
+        detectedIssues?: string[] | undefined;
+    }>;
+    verdict: z.ZodEnum<["approve", "reject", "borderline"]>;
+    breachedThresholds: z.ZodArray<z.ZodString, "many">;
+    nearMissThresholdKeys: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    thresholdsUsed: z.ZodObject<{
+        characterMatchMin: z.ZodDefault<z.ZodNumber>;
+        wardrobeMatchMin: z.ZodDefault<z.ZodNumber>;
+        locationMatchMin: z.ZodDefault<z.ZodNumber>;
+        styleMatchMin: z.ZodDefault<z.ZodNumber>;
+        cameraMatchMin: z.ZodDefault<z.ZodNumber>;
+        artifactScoreMax: z.ZodDefault<z.ZodNumber>;
+        overallUsabilityMin: z.ZodDefault<z.ZodNumber>;
+    } & {
+        motionQualityMin: z.ZodDefault<z.ZodNumber>;
+        editUsabilityMin: z.ZodDefault<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        characterMatchMin: number;
+        wardrobeMatchMin: number;
+        locationMatchMin: number;
+        styleMatchMin: number;
+        cameraMatchMin: number;
+        artifactScoreMax: number;
+        overallUsabilityMin: number;
+        motionQualityMin: number;
+        editUsabilityMin: number;
+    }, {
+        characterMatchMin?: number | undefined;
+        wardrobeMatchMin?: number | undefined;
+        locationMatchMin?: number | undefined;
+        styleMatchMin?: number | undefined;
+        cameraMatchMin?: number | undefined;
+        artifactScoreMax?: number | undefined;
+        overallUsabilityMin?: number | undefined;
+        motionQualityMin?: number | undefined;
+        editUsabilityMin?: number | undefined;
+    }>;
+    usableWindow: z.ZodObject<{
+        startSeconds: z.ZodNumber;
+        endSeconds: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        startSeconds: number;
+        endSeconds: number;
+    }, {
+        startSeconds: number;
+        endSeconds: number;
+    }>;
+    guardianScore: z.ZodNumber;
+    cached: z.ZodLiteral<false>;
+} & {
+    reviewId: z.ZodString;
+    structuredScoreId: z.ZodString;
+    regenerationPlanId: z.ZodOptional<z.ZodString>;
+    clipReviewArtifactId: z.ZodOptional<z.ZodString>;
+    patchedPromptId: z.ZodOptional<z.ZodString>;
+    patchedPromptVersion: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    guardianScore: number;
+    cached: false;
+    usableWindow: {
+        startSeconds: number;
+        endSeconds: number;
+    };
+    scores: {
+        characterMatch: number;
+        wardrobeMatch: number;
+        locationMatch: number;
+        styleMatch: number;
+        cameraMatch: number;
+        artifactScore: number;
+        overallUsability: number;
+        reasoning: string;
+        detectedIssues: string[];
+        scoredBy: {
+            provider: string;
+            version: string;
+            model: string;
+            scoredAt: string;
+        };
+        motionQuality: number;
+        editUsability: number;
+    };
+    structuredScoreId: string;
+    verdict: "approve" | "reject" | "borderline";
+    breachedThresholds: string[];
+    nearMissThresholdKeys: string[];
+    thresholdsUsed: {
+        characterMatchMin: number;
+        wardrobeMatchMin: number;
+        locationMatchMin: number;
+        styleMatchMin: number;
+        cameraMatchMin: number;
+        artifactScoreMax: number;
+        overallUsabilityMin: number;
+        motionQualityMin: number;
+        editUsabilityMin: number;
+    };
+    reviewId: string;
+    regenerationPlanId?: string | undefined;
+    clipReviewArtifactId?: string | undefined;
+    patchedPromptId?: string | undefined;
+    patchedPromptVersion?: number | undefined;
+}, {
+    guardianScore: number;
+    cached: false;
+    usableWindow: {
+        startSeconds: number;
+        endSeconds: number;
+    };
+    scores: {
+        characterMatch: number;
+        wardrobeMatch: number;
+        locationMatch: number;
+        styleMatch: number;
+        cameraMatch: number;
+        artifactScore: number;
+        overallUsability: number;
+        reasoning: string;
+        scoredBy: {
+            provider: string;
+            version: string;
+            model: string;
+            scoredAt: string;
+        };
+        motionQuality: number;
+        editUsability: number;
+        detectedIssues?: string[] | undefined;
+    };
+    structuredScoreId: string;
+    verdict: "approve" | "reject" | "borderline";
+    breachedThresholds: string[];
+    thresholdsUsed: {
+        characterMatchMin?: number | undefined;
+        wardrobeMatchMin?: number | undefined;
+        locationMatchMin?: number | undefined;
+        styleMatchMin?: number | undefined;
+        cameraMatchMin?: number | undefined;
+        artifactScoreMax?: number | undefined;
+        overallUsabilityMin?: number | undefined;
+        motionQualityMin?: number | undefined;
+        editUsabilityMin?: number | undefined;
+    };
+    reviewId: string;
+    regenerationPlanId?: string | undefined;
+    nearMissThresholdKeys?: string[] | undefined;
+    clipReviewArtifactId?: string | undefined;
+    patchedPromptId?: string | undefined;
+    patchedPromptVersion?: number | undefined;
+}>;
+export type FilmClipReviewScoresOrchestrationResult = z.infer<typeof FilmClipReviewScoresOrchestrationResultSchema>;

package/dist/schemas/film/film-clip-review-orchestration.schema.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilmClipReviewScoresOrchestrationResultSchema = exports.FilmClipReviewScoresOrchestrationInputSchema = void 0;
+const zod_1 = require("zod");
+const film_clip_review_generate_schema_1 = require("../ai/film-clip-review-generate.schema");
+exports.FilmClipReviewScoresOrchestrationInputSchema = zod_1.z
+    .object({
+    projectId: zod_1.z.string().uuid(),
+    orchestrationId: zod_1.z.string().min(1),
+    /** When true, reuse latest persisted structured scores + plan (no vision model). */
+    skipVision: zod_1.z.boolean().optional(),
+    /** PR-N: attempt automatic winner rollup once sibling reviews hydrate. */
+    takeComparisonId: zod_1.z.string().uuid().optional(),
+})
+    .strict();
+exports.FilmClipReviewScoresOrchestrationResultSchema = film_clip_review_generate_schema_1.FilmClipReviewGenerateSuccessSchema.extend({
+    reviewId: zod_1.z.string().uuid(),
+    structuredScoreId: zod_1.z.string().uuid(),
+    regenerationPlanId: zod_1.z.string().uuid().optional(),
+    clipReviewArtifactId: zod_1.z.string().uuid().optional(),
+    patchedPromptId: zod_1.z.string().uuid().optional(),
+    patchedPromptVersion: zod_1.z.number().int().positive().optional(),
+});

package/dist/schemas/film/film-clip-review-scores.schema.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Film Clip Review Scores — six-dimension 0-10 reviewer scoring.
+ *
+ * Additive to the existing finding/severity model in film-review.schema.ts.
+ * Stored in `film_clip_review_scores` table; consumed by the critic loop
+ * to compute prompt-template / reference-pack acceptance rates per shot.
+ */
+import { z } from 'zod';
+export declare const FILM_REVIEW_SCORE_DIMENSIONS: readonly ["identity", "motion", "lighting", "continuity", "composition", "intent"];
+export type FilmReviewScoreDimension = (typeof FILM_REVIEW_SCORE_DIMENSIONS)[number];
+export declare const FilmClipReviewScoresSchema: z.ZodObject<{
+    clipId: z.ZodString;
+    reviewerUserId: z.ZodOptional<z.ZodString>;
+    identity: z.ZodNumber;
+    motion: z.ZodNumber;
+    lighting: z.ZodNumber;
+    continuity: z.ZodNumber;
+    composition: z.ZodNumber;
+    intent: z.ZodNumber;
+    /** Controlled-vocabulary failure reason codes (subset of FILM_CLIP_REJECTION_REASONS + extras). */
+    reasonCodes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    intent: number;
+    continuity: number;
+    reasonCodes: string[];
+    lighting: number;
+    clipId: string;
+    identity: number;
+    motion: number;
+    composition: number;
+    notes?: string | undefined;
+    reviewerUserId?: string | undefined;
+}, {
+    intent: number;
+    continuity: number;
+    lighting: number;
+    clipId: string;
+    identity: number;
+    motion: number;
+    composition: number;
+    notes?: string | undefined;
+    reasonCodes?: string[] | undefined;
+    reviewerUserId?: string | undefined;
+}>;
+export type FilmClipReviewScores = z.infer<typeof FilmClipReviewScoresSchema>;
+/**
+ * Computes the mean of the six dimensions. Used by the bandit policy
+ * and the OFI-report aggregator. Pure function; no I/O.
+ */
+export declare function meanReviewScore(scores: FilmClipReviewScores): number;

package/dist/schemas/film/film-clip-review-scores.schema.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilmClipReviewScoresSchema = exports.FILM_REVIEW_SCORE_DIMENSIONS = void 0;
+exports.meanReviewScore = meanReviewScore;
+/**
+ * Film Clip Review Scores — six-dimension 0-10 reviewer scoring.
+ *
+ * Additive to the existing finding/severity model in film-review.schema.ts.
+ * Stored in `film_clip_review_scores` table; consumed by the critic loop
+ * to compute prompt-template / reference-pack acceptance rates per shot.
+ */
+const zod_1 = require("zod");
+exports.FILM_REVIEW_SCORE_DIMENSIONS = [
+    'identity',
+    'motion',
+    'lighting',
+    'continuity',
+    'composition',
+    'intent',
+];
+const Score = zod_1.z.number().int().min(0).max(10);
+exports.FilmClipReviewScoresSchema = zod_1.z
+    .object({
+    clipId: zod_1.z.string().uuid(),
+    reviewerUserId: zod_1.z.string().uuid().optional(),
+    identity: Score,
+    motion: Score,
+    lighting: Score,
+    continuity: Score,
+    composition: Score,
+    intent: Score,
+    /** Controlled-vocabulary failure reason codes (subset of FILM_CLIP_REJECTION_REASONS + extras). */
+    reasonCodes: zod_1.z.array(zod_1.z.string().min(1)).default([]),
+    notes: zod_1.z.string().max(2000).optional(),
+})
+    .strict();
+/**
+ * Computes the mean of the six dimensions. Used by the bandit policy
+ * and the OFI-report aggregator. Pure function; no I/O.
+ */
+function meanReviewScore(scores) {
+    const total = scores.identity +
+        scores.motion +
+        scores.lighting +
+        scores.continuity +
+        scores.composition +
+        scores.intent;
+    return total / 6;
+}

package/dist/schemas/film/film-clip-structured-review-artifact.schema.d.ts

@@ -0,0 +1,175 @@
+import { z } from "zod";
+export declare const FilmClipStructuredReviewArtifactPayloadSchema: z.ZodObject<{
+    clipId: z.ZodString;
+    shotId: z.ZodString;
+    scores: z.ZodObject<{
+        characterMatch: z.ZodNumber;
+        wardrobeMatch: z.ZodNumber;
+        locationMatch: z.ZodNumber;
+        styleMatch: z.ZodNumber;
+        cameraMatch: z.ZodNumber;
+        motionQuality: z.ZodNumber;
+        artifactScore: z.ZodNumber;
+        editUsability: z.ZodNumber;
+        overallUsability: z.ZodNumber;
+        reasoning: z.ZodString;
+        detectedIssues: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        scoredBy: z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+            version: z.ZodString;
+            scoredAt: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            provider: string;
+            version: string;
+            model: string;
+            scoredAt: string;
+        }, {
+            provider: string;
+            version: string;
+            model: string;
+            scoredAt: string;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        characterMatch: number;
+        wardrobeMatch: number;
+        locationMatch: number;
+        styleMatch: number;
+        cameraMatch: number;
+        artifactScore: number;
+        overallUsability: number;
+        reasoning: string;
+        detectedIssues: string[];
+        scoredBy: {
+            provider: string;
+            version: string;
+            model: string;
+            scoredAt: string;
+        };
+        motionQuality: number;
+        editUsability: number;
+    }, {
+        characterMatch: number;
+        wardrobeMatch: number;
+        locationMatch: number;
+        styleMatch: number;
+        cameraMatch: number;
+        artifactScore: number;
+        overallUsability: number;
+        reasoning: string;
+        scoredBy: {
+            provider: string;
+            version: string;
+            model: string;
+            scoredAt: string;
+        };
+        motionQuality: number;
+        editUsability: number;
+        detectedIssues?: string[] | undefined;
+    }>;
+    verdict: z.ZodEnum<["approve", "reject", "borderline"]>;
+    thresholdsApplied: z.ZodObject<{
+        characterMatchMin: z.ZodDefault<z.ZodNumber>;
+        wardrobeMatchMin: z.ZodDefault<z.ZodNumber>;
+        locationMatchMin: z.ZodDefault<z.ZodNumber>;
+        styleMatchMin: z.ZodDefault<z.ZodNumber>;
+        cameraMatchMin: z.ZodDefault<z.ZodNumber>;
+        artifactScoreMax: z.ZodDefault<z.ZodNumber>;
+        overallUsabilityMin: z.ZodDefault<z.ZodNumber>;
+    } & {
+        motionQualityMin: z.ZodDefault<z.ZodNumber>;
+        editUsabilityMin: z.ZodDefault<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        characterMatchMin: number;
+        wardrobeMatchMin: number;
+        locationMatchMin: number;
+        styleMatchMin: number;
+        cameraMatchMin: number;
+        artifactScoreMax: number;
+        overallUsabilityMin: number;
+        motionQualityMin: number;
+        editUsabilityMin: number;
+    }, {
+        characterMatchMin?: number | undefined;
+        wardrobeMatchMin?: number | undefined;
+        locationMatchMin?: number | undefined;
+        styleMatchMin?: number | undefined;
+        cameraMatchMin?: number | undefined;
+        artifactScoreMax?: number | undefined;
+        overallUsabilityMin?: number | undefined;
+        motionQualityMin?: number | undefined;
+        editUsabilityMin?: number | undefined;
+    }>;
+    breachedThresholdKeys: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    shotId: string;
+    clipId: string;
+    scores: {
+        characterMatch: number;
+        wardrobeMatch: number;
+        locationMatch: number;
+        styleMatch: number;
+        cameraMatch: number;
+        artifactScore: number;
+        overallUsability: number;
+        reasoning: string;
+        detectedIssues: string[];
+        scoredBy: {
+            provider: string;
+            version: string;
+            model: string;
+            scoredAt: string;
+        };
+        motionQuality: number;
+        editUsability: number;
+    };
+    verdict: "approve" | "reject" | "borderline";
+    thresholdsApplied: {
+        characterMatchMin: number;
+        wardrobeMatchMin: number;
+        locationMatchMin: number;
+        styleMatchMin: number;
+        cameraMatchMin: number;
+        artifactScoreMax: number;
+        overallUsabilityMin: number;
+        motionQualityMin: number;
+        editUsabilityMin: number;
+    };
+    breachedThresholdKeys: string[];
+}, {
+    shotId: string;
+    clipId: string;
+    scores: {
+        characterMatch: number;
+        wardrobeMatch: number;
+        locationMatch: number;
+        styleMatch: number;
+        cameraMatch: number;
+        artifactScore: number;
+        overallUsability: number;
+        reasoning: string;
+        scoredBy: {
+            provider: string;
+            version: string;
+            model: string;
+            scoredAt: string;
+        };
+        motionQuality: number;
+        editUsability: number;
+        detectedIssues?: string[] | undefined;
+    };
+    verdict: "approve" | "reject" | "borderline";
+    thresholdsApplied: {
+        characterMatchMin?: number | undefined;
+        wardrobeMatchMin?: number | undefined;
+        locationMatchMin?: number | undefined;
+        styleMatchMin?: number | undefined;
+        cameraMatchMin?: number | undefined;
+        artifactScoreMax?: number | undefined;
+        overallUsabilityMin?: number | undefined;
+        motionQualityMin?: number | undefined;
+        editUsabilityMin?: number | undefined;
+    };
+    breachedThresholdKeys?: string[] | undefined;
+}>;
+export type FilmClipStructuredReviewArtifactPayload = z.infer<typeof FilmClipStructuredReviewArtifactPayloadSchema>;

package/dist/schemas/film/film-clip-structured-review-artifact.schema.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilmClipStructuredReviewArtifactPayloadSchema = void 0;
+const zod_1 = require("zod");
+const film_clip_structured_review_schema_1 = require("./film-clip-structured-review.schema");
+exports.FilmClipStructuredReviewArtifactPayloadSchema = zod_1.z
+    .object({
+    clipId: zod_1.z.string().uuid(),
+    shotId: zod_1.z.string().uuid(),
+    scores: film_clip_structured_review_schema_1.FilmClipStructuredReviewScoresSchema,
+    verdict: film_clip_structured_review_schema_1.FilmClipStructuredReviewVerdictSchema,
+    thresholdsApplied: film_clip_structured_review_schema_1.FilmClipStructuredReviewThresholdsSchema,
+    breachedThresholdKeys: zod_1.z.array(zod_1.z.string()).default([]),
+})
+    .strict();