@milenyumai/film-kit 2.3.2 → 2.3.3

package/README.md

@@ -558,10 +558,7 @@ These subpackages are marked `private: true` and are bundled as internal sources
 Maintainer release checklist:
 
 ```bash
-npm run typecheck
-npm test
-npm run build
-npm pack --json --dry-run
+npm run release:check
 ```
 
 Publish the single public package:
@@ -572,6 +569,12 @@ npm whoami
 npm publish --access public
 ```
 
+If the account has npm two-factor authentication enabled for publish, include the current one-time password from the authenticator app:
+
+```bash
+npm publish --access public --otp=123456
+```
+
 Optional validation before publish:
 
 ```bash

package/build/lib/cli.js

@@ -414,7 +414,7 @@ async function parseGenerateStoryboardCommand(args, rootDir) {
                 break;
         }
     }
-    if (!brief) {
+    if (!brief?.trim()) {
         throw new Error("generate-storyboard requires --brief.");
     }
     if (characterRefs.length === 0) {

package/build/lib/storyboard-reference/output-writer.js

@@ -41,6 +41,37 @@ function formatProviderTokens(bundle) {
     })
         .join("\n");
 }
+function getProviderToken(bundle, role, fallback) {
+    return Object.values(bundle.providerAssetMapping)
+        .find(entry => entry.role === role)?.token ?? fallback;
+}
+function formatCoverageReferences(bundle) {
+    const interpretation = bundle.storyboardInterpretation;
+    const characterTokens = Object.values(bundle.providerAssetMapping)
+        .filter(entry => entry.role === "character_identity")
+        .map(entry => entry.token)
+        .join(", ") || "@Image1";
+    const storyboardToken = getProviderToken(bundle, "storyboard_plan", "@Image2");
+    const visualWorld = interpretation.visualWorld;
+    const camera = interpretation.cameraPlan;
+    const firstPhase = interpretation.phases[0];
+    const lastPhase = interpretation.phases.at(-1) ?? firstPhase;
+    return `## Coverage References In Same File
+
+Coverage is standalone editorial material for this shot only. Do not chain coverage into the next main shot. Keep the same generated character identity, wardrobe, props, lighting direction, environment, screen direction, and visual_world.
+
+### ${bundle.shotId}A - ECU Reaction | 3s
+
+\`\`\`text
+Use ${characterTokens} as the exact identity source and ${storyboardToken} only for scene continuity. Extreme close-up reaction coverage during ${firstPhase?.timeRange ?? "the opening beat"}: ${firstPhase?.subjectAction ?? "the character registers the story beat"}. Keep ${visualWorld.lighting}, ${visualWorld.atmosphere}, and ${camera.screenDirection}. Static or barely drifting camera, shallow depth of field, natural skin texture, visible breath or eye tension, no new action beat, no new identity. Audio: close breath, subtle clothing sound, matched ambience, Music: NONE. Avoid: identity drift, face drift, wardrobe drift, beauty filter, plastic skin, distorted eyes, flicker, warping, on-screen text, watermark, logo.
+\`\`\`
+
+### ${bundle.shotId}B - Insert / Environmental Detail | 3s
+
+\`\`\`text
+Use ${storyboardToken} only for composition and environment continuity; do not introduce a new character identity. Tight insert coverage tied to ${lastPhase?.timeRange ?? "the final beat"}: ${lastPhase?.subjectAction ?? "the action resolves into a clear visual detail"}. Show a physically plausible detail from the same visual world: foreground texture, prop contact, reflection, light spill, hand tension, fabric motion, or environment response. Keep ${visualWorld.environment}; ${visualWorld.foreground}; ${visualWorld.background}; ${visualWorld.lighting}. Audio: matched practical SFX and ambience, no dialogue unless explicitly present in the main Audio Plan, Music: NONE. Avoid: new location, new character, clear logo, readable text, impossible physics, wrong reflection angle, identity override, flicker, warping, cartoon style, CGI look.
+\`\`\``;
+}
 export function renderShotMarkdown(bundle) {
     const interpretation = bundle.storyboardInterpretation;
     const audioPlan = getAudioPlan(bundle);
@@ -104,6 +135,8 @@ ${JSON.stringify(audioPlan ?? null, null, 2)}
 
 ${modelPrompts}
 
+${formatCoverageReferences(bundle)}
+
 ## QA
 ${formatQa(bundle)}
 `;

package/build/lib/storyboard-reference/validators.js

@@ -99,8 +99,12 @@ export function validateModelPromptOutput(output) {
 }
 export function validatePromptBundle(bundle, assets, voiceCast = []) {
     const roleIssues = validateResolvedAssetRoles(assets);
+    const modelValidationResults = Object.values(bundle.modelPrompts)
+        .filter((output) => Boolean(output))
+        .map(validateModelPromptOutput);
     const modelIssues = Object.values(bundle.modelPrompts)
-        .flatMap(output => output?.qa.issues ?? []);
+        .flatMap(output => output?.qa.issues ?? [])
+        .concat(modelValidationResults.flatMap(result => result.issues));
     const voiceCastKeys = new Set(voiceCast.map(entry => entry.speakerKey));
     const audioPlans = Object.values(bundle.modelPrompts)
         .map(output => output?.audioPlan)
@@ -110,9 +114,10 @@ export function validatePromptBundle(bundle, assets, voiceCast = []) {
         hasStoryboardReference: assets.storyboards.length >= 1 || Boolean(bundle.storyboardImagePrompt),
         hasStoryboardImagePrompt: Boolean(bundle.storyboardImagePrompt?.promptText.trim()),
         storyboardPromptHasReferenceLockStructure: hasGptImageStillPromptContract(bundle.storyboardImagePrompt?.promptText ?? ""),
-        hasAvoidLineEverywhere: Object.values(bundle.modelPrompts).every(output => Boolean(output?.qa.checks.hasAvoidLine ?? output?.qa.checks.hasAvoidOrNegative)),
+        hasAvoidLineEverywhere: Object.values(bundle.modelPrompts).every(output => Boolean(output) && hasAvoidOrNegativePrompt(output.promptText)),
         storyboardPromptHasAvoidLine: hasAvoidOrNegativePrompt(bundle.storyboardImagePrompt?.promptText ?? ""),
-        modelGrammarPasses: Object.values(bundle.modelPrompts).every(output => output?.qa.verdict === "pass"),
+        modelGrammarPasses: Object.values(bundle.modelPrompts).every(output => output?.qa.verdict === "pass")
+            && modelValidationResults.every(result => result.verdict === "pass"),
         storyboardDoesNotOverrideIdentity: Object.values(bundle.modelPrompts).every(output => /storyboard.*staging|storyboard.*planning|storyboard.*composition|storyboard.*only/i.test(output?.promptText ?? "")),
         audioPlanPresent: Object.values(bundle.modelPrompts).every(output => Boolean(output?.audioPlan)),
         speakingAudioPlansHaveActiveSpeaker: audioPlans.every(plan => plan.dialogueTranscript === "NONE" || Boolean(plan.activeSpeakerKey)),
@@ -131,10 +136,20 @@ export function validatePromptBundle(bundle, assets, voiceCast = []) {
     };
 }
 export function assertStoryboardReferenceBuildPass(result) {
-    const failedBundles = result.bundles.filter(bundle => bundle.qa.verdict !== "pass");
-    const issues = failedBundles.flatMap(bundle => (bundle.qa.issues.length > 0
-        ? bundle.qa.issues.map(issue => `${bundle.shotId}: ${issue}`)
-        : [`${bundle.shotId}: bundle QA failed without a detailed issue.`]));
+    const issues = validateCharacterReferenceSheetPrompts(result.characterReferenceSheetPrompts)
+        .map(issue => `character-sheet: ${issue}`);
+    for (const bundle of result.bundles) {
+        const currentQa = validatePromptBundle(bundle, result.assets, result.plan.voiceCast);
+        if (bundle.qa.verdict !== "pass" || currentQa.verdict !== "pass") {
+            const bundleIssues = [
+                ...bundle.qa.issues,
+                ...currentQa.issues
+            ];
+            issues.push(...(bundleIssues.length > 0
+                ? bundleIssues.map(issue => `${bundle.shotId}: ${issue}`)
+                : [`${bundle.shotId}: bundle QA failed without a detailed issue.`]));
+        }
+    }
     if (result.bundles.length === 0) {
         issues.push("No storyboard-reference prompt bundles were generated.");
     }

package/build/lib/storyboard-reference/visual-world-builder.js

@@ -11,7 +11,7 @@ export function buildCameraPlan(request) {
         lens: wideShot ? "35mm lens feel" : closeShot ? "85mm lens feel" : "50mm lens feel",
         framing: wideShot ? "layered wide composition" : closeShot ? "eye-level close framing" : "stable mid-shot framing",
         stabilization: "tripod-stable with minimal organic drift",
-        screenDirection: "preserve the storyboard's screen direction and eyeline relationships"
+        screenDirection: "storyboard screen direction and eyeline relationships"
     };
 }
 export function buildVisualWorld(request) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milenyumai/film-kit",
-  "version": "2.3.2",
+  "version": "2.3.3",
   "description": "Single-package Film-Kit distribution with preset-driven cinematic runtime setup for OpenAI Codex App, Claude Code, Cursor, Copilot, and Antigravity.",
   "type": "module",
   "main": "./build/index.js",
@@ -44,6 +44,7 @@
     "build:presets": "npm --prefix packages/multi run build && npm --prefix packages/hybrid run build && npm --prefix packages/hybrid-smart run build && npm --prefix packages/gpt-image-smart run build && npm --prefix packages/studio run build",
     "dev:setup": "tsx src/postinstall.ts",
     "postinstall": "node -e \"import('./build/postinstall.js').then(m=>m.runPostinstall()).catch(()=>{})\"",
+    "release:check": "npm run typecheck && npm test && npm run build && npm publish --access public --dry-run",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc -p tsconfig.json --noEmit"