@nodaro/shared 2.11.0 → 2.12.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/shared",
-  "version": "2.11.0",
+  "version": "2.12.2",
   "description": "Shared types, model catalog, wire contracts, and structural vocabularies for the Nodaro platform and SDK.",
   "type": "module",
   "license": "Apache-2.0",

package/src/__tests__/video-analysis-catalog-sync.test.ts

@@ -157,8 +157,12 @@ describe("bare video-analysis node-type credit id", () => {
     // 24 and the schedule regenerated ~47% lower at the ceiling bucket, and 300
     // wrote 2064: the V1 hybrid-smart reprice (task A3) moved `smart` to a
     // multi-roll plan (native skeleton + donor rolls, always refined) and
-    // trued up every tier's judge/refine terms).
-    expect(ceiling).toBe(2064)
+    // trued up every tier's judge/refine terms), 355 wrote 2068: the
+    // recast shot-craft Stage-1 doctrine (transitions + on-screen text, three
+    // required wire fields) grew the analyser's system prompt, moving the
+    // plugin's token pin 8_203 -> 8_482, and 356 wrote 2071: Stage 1.3 grew
+    // that prompt again, moving the pin 8_482 -> 8_706.
+    expect(ceiling).toBe(2071)
   })
 
   it("the bare id still bounds the default tier at the ceiling bucket", () => {

package/src/__tests__/video-analysis-pricing.test.ts

@@ -178,12 +178,12 @@ describe("video-audit-pricing", () => {
   })
 
   it("videoAuditCreditsForBucket: table lookup by resolved bucket + family, snapping a raw duration onto the ladder", () => {
-    expect(videoAuditCreditsForBucket(60, false)).toBe(213)
-    expect(videoAuditCreditsForBucket(60, true)).toBe(393)
-    expect(videoAuditCreditsForBucket(180, false)).toBe(289)
-    expect(videoAuditCreditsForBucket(360, false)).toBe(659)
-    expect(videoAuditCreditsForBucket(600, false)).toBe(1066)
-    expect(videoAuditCreditsForBucket(600, true)).toBe(1912)
+    expect(videoAuditCreditsForBucket(60, false)).toBe(214)
+    expect(videoAuditCreditsForBucket(60, true)).toBe(394)
+    expect(videoAuditCreditsForBucket(180, false)).toBe(290)
+    expect(videoAuditCreditsForBucket(360, false)).toBe(661)
+    expect(videoAuditCreditsForBucket(600, false)).toBe(1070)
+    expect(videoAuditCreditsForBucket(600, true)).toBe(1917)
     // Not just exact ladder values — a raw duration snaps up to its bucket.
     expect(videoAuditCreditsForBucket(70, false)).toBe(VIDEO_AUDIT_BUCKET_CREDITS["video-audit:180s"])
     expect(videoAuditCreditsForBucket(9999, true)).toBe(VIDEO_AUDIT_BUCKET_CREDITS["video-audit:auto:600s"])
@@ -224,8 +224,8 @@ describe("video-audit-pricing", () => {
     // 600s bucket here, same convention as VIDEO_ANALYSIS_BUCKET_CREDITS).
     expect(Object.keys(VIDEO_AUDIT_BUCKET_CREDITS)).toHaveLength(8)
     // Bare-id values quoted in the task/catalog must equal each family's 600s ceiling.
-    expect(VIDEO_AUDIT_BUCKET_CREDITS["video-audit:600s"]).toBe(1066)
-    expect(VIDEO_AUDIT_BUCKET_CREDITS["video-audit:auto:600s"]).toBe(1912)
+    expect(VIDEO_AUDIT_BUCKET_CREDITS["video-audit:600s"]).toBe(1070)
+    expect(VIDEO_AUDIT_BUCKET_CREDITS["video-audit:auto:600s"]).toBe(1917)
   })
 
   it("auto family = base family + the gemini-3-flash (legacy fast tier) row at the same bucket, exactly — single-source, never hand-added", () => {

package/src/__tests__/video-analysis-shot-craft.test.ts

@@ -0,0 +1,38 @@
+import { describe, it, expect } from "vitest"
+import {
+  VIDEO_ANALYSIS_TEXT_KINDS, VIDEO_ANALYSIS_CLIP_TRANSITIONS_IN, VIDEO_ANALYSIS_TRANSITIONS,
+  windowAnalysisSchema, videoAnalysisResultSchema,
+} from "../video-analysis.js"
+
+const scene = { startSec: 0, endSec: 4, label: "hook", shotType: "Wide", camera: "static", visual: "{slot:a} waits", audio: [] }
+const slot = { slotId: "a", label: "A", source: "wired-character", role: "person", description: "d" }
+
+describe("shot-craft fields (keys only)", () => {
+  it("adds a text-kind vocabulary and a clip transition-in vocabulary without widening the transition enum", () => {
+    expect(VIDEO_ANALYSIS_TEXT_KINDS).toEqual(["title", "caption", "lower-third", "subtitle", "logo", "other"])
+    expect(VIDEO_ANALYSIS_CLIP_TRANSITIONS_IN).toEqual(["fade"])
+    expect(VIDEO_ANALYSIS_TRANSITIONS).toEqual(["cut", "fade", "dissolve", "wipe", "whip"])
+  })
+  it("window and result accept transitionIn at the CLIP level and onScreenTextKind on a scene", () => {
+    const w = windowAnalysisSchema.parse({ transitionIn: "fade", slots: [slot], scenes: [{ ...scene, onScreenText: "HELLO", onScreenTextKind: "title", transitionOut: "cut" }] })
+    expect(w.transitionIn).toBe("fade")
+    expect(w.scenes[0]!.onScreenTextKind).toBe("title")
+    const r = videoAnalysisResultSchema.parse({
+      meta: { durationSec: 4, width: 16, height: 9, aspectRatio: "16:9" }, transitionIn: "fade", slots: [slot],
+      scenes: [{ ...scene, sceneNumber: 1, visualResolved: "A waits", slotRefs: ["a"], onScreenTextKind: "subtitle", onScreenText: "hi" }],
+    })
+    expect(r.transitionIn).toBe("fade")
+  })
+  it("a pre-change result still parses, and an unknown key is stripped (readers never break)", () => {
+    const r = videoAnalysisResultSchema.parse({
+      meta: { durationSec: 4, width: 16, height: 9, aspectRatio: "16:9" }, slots: [slot],
+      scenes: [{ ...scene, sceneNumber: 1, visualResolved: "A waits", slotRefs: ["a"], futureKey: 1 }],
+    })
+    expect(r.transitionIn).toBeUndefined()
+    expect((r.scenes[0] as Record<string, unknown>).futureKey).toBeUndefined()
+  })
+  it("rejects a value outside the vocabularies", () => {
+    expect(() => windowAnalysisSchema.parse({ transitionIn: "wipe", slots: [], scenes: [] })).toThrow()
+    expect(() => windowAnalysisSchema.parse({ slots: [], scenes: [{ ...scene, onScreenTextKind: "banner" }] })).toThrow()
+  })
+})

package/src/i18n/framing.ar.ts

@@ -18,7 +18,6 @@ const map: LocaleCatalogMap = {
   "macro": { label: "ماكرو", description: "تفصيل قريب جدا لموضوع صغير" },
   "full-shot": { label: "لقطة كاملة", description: "الجسم بالكامل من الرأس إلى القدم في الإطار" },
   "cowboy-shot": { label: "لقطة Cowboy", description: "من منتصف الفخذ فأعلى، تأطير غربي كلاسيكي" },
-  "head-to-knees": { label: "من الرأس للركبتين", description: "من الرأس نزولا للركبتين" },
   "head-to-hip": { label: "من الرأس للخصر", description: "من الرأس نزولا للوركين" },
   "half-body": { label: "نصف جسم", description: "بورتريه نظيف من الخصر فأعلى" },
 

package/src/i18n/framing.de.ts

@@ -18,7 +18,6 @@ const map: LocaleCatalogMap = {
   "macro": { label: "Makro", description: "Extremes Nahdetail eines kleinen Motivs" },
   "full-shot": { label: "Ganzkörper-Aufnahme", description: "Ganzer Körper von Kopf bis Fuß im Bild" },
   "cowboy-shot": { label: "Cowboy Shot", description: "Ab Mitte Oberschenkel, klassische Western-Einstellung" },
-  "head-to-knees": { label: "Kopf bis Knie", description: "Vom Kopf bis zu den Knien" },
   "head-to-hip": { label: "Kopf bis Hüfte", description: "Vom Kopf bis zur Hüftlinie" },
   "half-body": { label: "Halbporträt", description: "Sauberes Porträt ab der Hüfte aufwärts" },
   "eye-level": { label: "Augenhöhe", description: "Kamera auf Augenhöhe des Motivs" },

package/src/i18n/framing.es.ts

@@ -18,7 +18,6 @@ const map: LocaleCatalogMap = {
   "macro": { label: "Macro", description: "Detalle extremamente cercano de un sujeto pequeño" },
   "full-shot": { label: "Plano Entero", description: "Cuerpo entero de cabeza a pies en el cuadro" },
   "cowboy-shot": { label: "Plano Vaquero", description: "Desde mitad del muslo hacia arriba, encuadre clásico del Oeste" },
-  "head-to-knees": { label: "De Cabeza a Rodillas", description: "Desde la cabeza hasta las rodillas" },
   "head-to-hip": { label: "De Cabeza a Cadera", description: "Desde la cabeza hasta las caderas" },
   "half-body": { label: "Medio Cuerpo", description: "Retrato limpio de cintura para arriba" },
 

package/src/i18n/framing.fr.ts

@@ -19,7 +19,6 @@ const map: LocaleCatalogMap = {
   "macro": { description: "Détail extrêmement rapproché d'un petit sujet" },
   "full-shot": { label: "Plan en pied", description: "Corps entier de la tête aux pieds dans le cadre" },
   "cowboy-shot": { description: "Du milieu des cuisses, cadrage western classique" },
-  "head-to-knees": { label: "De la tête aux genoux", description: "De la tête jusqu'aux genoux" },
   "head-to-hip": { label: "De la tête à la hanche", description: "De la tête jusqu'aux hanches" },
   "half-body": { label: "Demi-corps", description: "Portrait propre à partir de la taille" },
   // Angle

package/src/i18n/framing.he.ts

@@ -18,7 +18,6 @@ const map: LocaleCatalogMap = {
   "macro": { label: "Macro", description: "פרט קרוב קיצוני של סובייקט קטן" },
   "full-shot": { label: "Full Shot", description: "כל הגוף מראש עד רגליים בפריים" },
   "cowboy-shot": { label: "Cowboy Shot", description: "מאמצע הירך ומעלה, מסגור Western קלאסי" },
-  "head-to-knees": { label: "ראש עד ברכיים", description: "מהראש למטה עד הברכיים" },
   "head-to-hip": { label: "ראש עד מותן", description: "מהראש למטה עד המותניים" },
   "half-body": { label: "חצי גוף", description: "פורטרט נקי מהמותניים ומעלה" },
 

package/src/i18n/framing.hi.ts

@@ -19,7 +19,6 @@ const map: LocaleCatalogMap = {
   "macro": { label: "Macro", description: "छोटे subject का अत्यधिक नज़दीकी detail" },
   "full-shot": { label: "Full Shot", description: "Frame में सिर-से-पैर तक पूरा बदन" },
   "cowboy-shot": { label: "Cowboy Shot", description: "जाँघ के बीच से ऊपर, क्लासिक Western framing" },
-  "head-to-knees": { label: "सिर से घुटनों तक", description: "सिर से लेकर घुटनों तक" },
   "head-to-hip": { label: "सिर से कूल्हे तक", description: "सिर से लेकर कूल्हे तक" },
   "half-body": { label: "आधा बदन", description: "साफ़ कमर-से-ऊपर portrait" },
 

package/src/i18n/framing.ja.ts

@@ -19,7 +19,6 @@ const map: LocaleCatalogMap = {
   "macro": { label: "マクロ", description: "小さな被写体の極端な拡大" },
   "full-shot": { label: "フルショット", description: "頭からつま先まで全身がフレーム内に収まる" },
   "cowboy-shot": { label: "カウボーイショット", description: "太もも中央から上、クラシックな西部劇のフレーミング" },
-  "head-to-knees": { label: "頭から膝まで", description: "頭から膝までを写す" },
   "head-to-hip": { label: "頭から腰まで", description: "頭から腰までを写す" },
   "half-body": { label: "ハーフボディ", description: "クリーンな腰上のポートレート" },
 

package/src/i18n/framing.ko.ts

@@ -19,7 +19,6 @@ const map: LocaleCatalogMap = {
   "macro": { label: "매크로", description: "작은 피사체의 극단적인 클로즈 디테일입니다" },
   "full-shot": { label: "풀 샷", description: "머리부터 발끝까지 전신이 프레임에 들어갑니다" },
   "cowboy-shot": { label: "카우보이 샷", description: "허벅지 중간부터 위로, 클래식한 서부극 프레이밍입니다" },
-  "head-to-knees": { label: "머리부터 무릎까지", description: "머리부터 무릎까지의 프레이밍입니다" },
   "head-to-hip": { label: "머리부터 엉덩이까지", description: "머리부터 엉덩이까지의 프레이밍입니다" },
   "half-body": { label: "반신", description: "허리 위의 깔끔한 인물 사진입니다" },
 

package/src/i18n/framing.pt-BR.ts

@@ -19,7 +19,6 @@ const map: LocaleCatalogMap = {
   "macro": { description: "Detalhe extremo de um pequeno sujeito" },
   "full-shot": { label: "Plano Inteiro", description: "Corpo inteiro da cabeça aos pés no quadro" },
   "cowboy-shot": { description: "Da metade da coxa para cima, enquadramento clássico de Western" },
-  "head-to-knees": { label: "Da Cabeça aos Joelhos", description: "Da cabeça até os joelhos" },
   "head-to-hip": { label: "Da Cabeça ao Quadril", description: "Da cabeça até o quadril" },
   "half-body": { label: "Meio Corpo", description: "Retrato limpo da cintura para cima" },
 

package/src/i18n/framing.ru.ts

@@ -19,7 +19,6 @@ const map: LocaleCatalogMap = {
   "macro": { label: "Макро", description: "Сверхблизкая деталь маленького объекта" },
   "full-shot": { label: "Полный план", description: "Всё тело с головы до пят в кадре" },
   "cowboy-shot": { label: "Ковбойский план", description: "От середины бедра, классическое вестерн-кадрирование" },
-  "head-to-knees": { label: "Голова до колен", description: "От головы до колен" },
   "head-to-hip": { label: "Голова до бёдер", description: "От головы до бёдер" },
   "half-body": { label: "Поясной портрет", description: "Чистый поясной портрет" },
 

package/src/i18n/framing.zh-CN.ts

@@ -19,7 +19,6 @@ const map: LocaleCatalogMap = {
   "macro":             { label: "微距",           description: "对小型主体的极近距细节" },
   "full-shot":         { label: "全身镜头",       description: "全身入画" },
   "cowboy-shot":       { label: "牛仔镜头",       description: "大腿中部以上,经典西部片取景" },
-  "head-to-knees":     { label: "头到膝盖",       description: "从头部到膝盖" },
   "head-to-hip":       { label: "头到髋",         description: "从头部到髋部" },
   "half-body":         { label: "半身像",         description: "干净的腰部以上人像" },
 

package/src/model-catalog.ts

@@ -1971,11 +1971,11 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     description: "Legacy fast-tier analysis model (pre-2026-07). Kept so stored raw-model configs keep running and keep pricing under their own identifier; new fast-tier runs use the current fast model.",
     useCases: ["video-analysis", "shot-list", "fast"],
     pricing: [
-      { identifier: "video-analysis:gemini-3-flash", credits: 846, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-analysis:gemini-3-flash", credits: 847, note: "10-min ceiling (no duration given)" },
       { identifier: "video-analysis:gemini-3-flash:60s", credits: 180 },
       { identifier: "video-analysis:gemini-3-flash:180s", credits: 185 },
-      { identifier: "video-analysis:gemini-3-flash:360s", credits: 514 },
-      { identifier: "video-analysis:gemini-3-flash:600s", credits: 846, note: "10-min ceiling" },
+      { identifier: "video-analysis:gemini-3-flash:360s", credits: 515 },
+      { identifier: "video-analysis:gemini-3-flash:600s", credits: 847, note: "10-min ceiling" },
     ],
   },
   "gemini-3.6-flash-video-analysis": {
@@ -1988,11 +1988,11 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     description: "Analyze a video into a structured shot list (scenes, camera, audio) — fast, economy tier. Billed per duration bucket.",
     useCases: ["video-analysis", "shot-list", "fast"],
     pricing: [
-      { identifier: "video-analysis:gemini-3.6-flash", credits: 986, note: "10-min ceiling (no duration given)" },
-      { identifier: "video-analysis:gemini-3.6-flash:60s", credits: 203 },
+      { identifier: "video-analysis:gemini-3.6-flash", credits: 990, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-analysis:gemini-3.6-flash:60s", credits: 204 },
       { identifier: "video-analysis:gemini-3.6-flash:180s", credits: 218 },
-      { identifier: "video-analysis:gemini-3.6-flash:360s", credits: 598 },
-      { identifier: "video-analysis:gemini-3.6-flash:600s", credits: 986, note: "10-min ceiling" },
+      { identifier: "video-analysis:gemini-3.6-flash:360s", credits: 600 },
+      { identifier: "video-analysis:gemini-3.6-flash:600s", credits: 990, note: "10-min ceiling" },
     ],
   },
   "gemini-3.1-pro-video-analysis": {
@@ -2005,11 +2005,11 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     description: "Analyze a video into a structured shot list (scenes, camera, audio) — higher-fidelity, default tier. Billed per duration bucket.",
     useCases: ["video-analysis", "shot-list", "cinematic"],
     pricing: [
-      { identifier: "video-analysis:gemini-3.1-pro", credits: 1050, note: "10-min ceiling (no duration given)" },
-      { identifier: "video-analysis:gemini-3.1-pro:60s", credits: 215 },
-      { identifier: "video-analysis:gemini-3.1-pro:180s", credits: 231 },
-      { identifier: "video-analysis:gemini-3.1-pro:360s", credits: 636 },
-      { identifier: "video-analysis:gemini-3.1-pro:600s", credits: 1050, note: "10-min ceiling" },
+      { identifier: "video-analysis:gemini-3.1-pro", credits: 1053, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-analysis:gemini-3.1-pro:60s", credits: 216 },
+      { identifier: "video-analysis:gemini-3.1-pro:180s", credits: 232 },
+      { identifier: "video-analysis:gemini-3.1-pro:360s", credits: 639 },
+      { identifier: "video-analysis:gemini-3.1-pro:600s", credits: 1053, note: "10-min ceiling" },
     ],
   },
   // Both mixed tiers are variants of the same advanced multi-engine analysis
@@ -2025,11 +2025,11 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     description: "Our most advanced analysis tier — multiple analysis engines combined into one result for maximum completeness and accuracy. Billed per duration bucket.",
     useCases: ["video-analysis", "shot-list", "premium", "most-complete"],
     pricing: [
-      { identifier: "video-analysis:mixed", credits: 1169, note: "10-min ceiling (no duration given)" },
-      { identifier: "video-analysis:mixed:60s", credits: 268 },
-      { identifier: "video-analysis:mixed:180s", credits: 289 },
-      { identifier: "video-analysis:mixed:360s", credits: 724 },
-      { identifier: "video-analysis:mixed:600s", credits: 1169, note: "10-min ceiling" },
+      { identifier: "video-analysis:mixed", credits: 1174, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-analysis:mixed:60s", credits: 269 },
+      { identifier: "video-analysis:mixed:180s", credits: 290 },
+      { identifier: "video-analysis:mixed:360s", credits: 727 },
+      { identifier: "video-analysis:mixed:600s", credits: 1174, note: "10-min ceiling" },
     ],
   },
   // SMART — the accuracy tier. Since the 2026-08-03 hybrid re-plan it is a
@@ -2047,11 +2047,11 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     description: "Highest-accuracy analysis — a hybrid pass that blends a native skeleton read with several donor analysis rolls, then always refines the merged result to find shot boundaries and identify the cast by appearance. Best choice when the shot list will drive regeneration. Billed per duration bucket.",
     useCases: ["video-analysis", "shot-list", "premium", "most-accurate"],
     pricing: [
-      { identifier: "video-analysis:smart", credits: 2064, note: "10-min ceiling (no duration given)" },
-      { identifier: "video-analysis:smart:60s", credits: 410 },
-      { identifier: "video-analysis:smart:180s", credits: 500 },
-      { identifier: "video-analysis:smart:360s", credits: 1259 },
-      { identifier: "video-analysis:smart:600s", credits: 2064, note: "10-min ceiling" },
+      { identifier: "video-analysis:smart", credits: 2071, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-analysis:smart:60s", credits: 412 },
+      { identifier: "video-analysis:smart:180s", credits: 502 },
+      { identifier: "video-analysis:smart:360s", credits: 1264 },
+      { identifier: "video-analysis:smart:600s", credits: 2071, note: "10-min ceiling" },
     ],
   },
   // ── AI Audit (`video-audit`) ── a SEPARATE node from video-analysis (own
@@ -2075,11 +2075,11 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     description: "Re-watches a clip against a wired analysis, applies video-verified corrections under guards, and returns a disclosed report of what changed. Billed per duration bucket.",
     useCases: ["video-audit", "qa", "shot-list", "verification"],
     pricing: [
-      { identifier: "video-audit", credits: 1066, note: "10-min ceiling (no duration given)" },
-      { identifier: "video-audit:60s", credits: 213 },
-      { identifier: "video-audit:180s", credits: 289 },
-      { identifier: "video-audit:360s", credits: 659 },
-      { identifier: "video-audit:600s", credits: 1066, note: "10-min ceiling" },
+      { identifier: "video-audit", credits: 1070, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-audit:60s", credits: 214 },
+      { identifier: "video-audit:180s", credits: 290 },
+      { identifier: "video-audit:360s", credits: 661 },
+      { identifier: "video-audit:600s", credits: 1070, note: "10-min ceiling" },
     ],
   },
   "video-audit-auto": {
@@ -2091,11 +2091,11 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     description: "Same video-verified audit as AI Audit, but auto-runs a fast analysis first when none is wired in, then applies corrections under guards and returns a disclosed report. Billed per duration bucket.",
     useCases: ["video-audit", "qa", "shot-list", "verification", "auto-analysis"],
     pricing: [
-      { identifier: "video-audit:auto", credits: 1912, note: "10-min ceiling (no duration given)" },
-      { identifier: "video-audit:auto:60s", credits: 393 },
-      { identifier: "video-audit:auto:180s", credits: 474 },
-      { identifier: "video-audit:auto:360s", credits: 1173 },
-      { identifier: "video-audit:auto:600s", credits: 1912, note: "10-min ceiling" },
+      { identifier: "video-audit:auto", credits: 1917, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-audit:auto:60s", credits: 394 },
+      { identifier: "video-audit:auto:180s", credits: 475 },
+      { identifier: "video-audit:auto:360s", credits: 1176 },
+      { identifier: "video-audit:auto:600s", credits: 1917, note: "10-min ceiling" },
     ],
   },
 }

package/src/video-analysis-pricing.ts

@@ -86,39 +86,50 @@ export const VIDEO_ANALYSIS_WINDOW = { LEN: WINDOW_LEN, STRIDE: WINDOW_STRIDE, O
 //
 // Values are pasted verbatim from the plugin generator's output — never hand
 // computed. The plugin's cost test cross-checks every row, sentinels included.
+// REGENERATED 2026-08-28 — recast shot-craft Stage 1: the analyser's system
+// prompt grew (transition/on-screen-text doctrine + three required wire
+// fields), so the plugin's system-prompt token pin moved 8_203 → 8_482 and
+// 21 of 28 rows tick up by 1–4 credits (~0.1–0.3%). Output of the plugin's
+// `scripts/gen-va-buckets.mjs` on `feat/va-shot-craft`, pasted verbatim.
+//
+// REGENERATED 2026-08-29 — recast shot-craft Stage 1.3: the analyser's system
+// prompt grew again, moving the plugin's system-prompt token pin 8_482 → 8_706
+// (cloud-plugins 0.209.0). 12 of 20 analysis rows and 6 of 8 audit rows tick up
+// by 1–3 credits (~0.1–0.3%); the legacy `gemini-3-flash` family is unchanged.
+// Output of the plugin's `scripts/gen-va-buckets.mjs`, pasted verbatim.
 export const VIDEO_ANALYSIS_BUCKET_CREDITS: Record<string, number> = {
   // Legacy fast-tier model (pre-2026-07) — kept for stored raw-id configs.
   "video-analysis:gemini-3-flash:60s": 180,
   "video-analysis:gemini-3-flash:180s": 185,
-  "video-analysis:gemini-3-flash:360s": 514,
-  "video-analysis:gemini-3-flash:600s": 846,
+  "video-analysis:gemini-3-flash:360s": 515,
+  "video-analysis:gemini-3-flash:600s": 847,
   // Current fast tier — regenerated from the private formula for its backing
   // model; higher than the legacy fast schedule but still ≤ pro per bucket.
-  "video-analysis:gemini-3.6-flash:60s": 203,
+  "video-analysis:gemini-3.6-flash:60s": 204,
   "video-analysis:gemini-3.6-flash:180s": 218,
-  "video-analysis:gemini-3.6-flash:360s": 598,
-  "video-analysis:gemini-3.6-flash:600s": 986,
-  "video-analysis:gemini-3.1-pro:60s": 215,
-  "video-analysis:gemini-3.1-pro:180s": 231,
-  "video-analysis:gemini-3.1-pro:360s": 636,
-  "video-analysis:gemini-3.1-pro:600s": 1050,
+  "video-analysis:gemini-3.6-flash:360s": 600,
+  "video-analysis:gemini-3.6-flash:600s": 990,
+  "video-analysis:gemini-3.1-pro:60s": 216,
+  "video-analysis:gemini-3.1-pro:180s": 232,
+  "video-analysis:gemini-3.1-pro:360s": 639,
+  "video-analysis:gemini-3.1-pro:600s": 1053,
   // Mixed tiers (`mixed` + `mixed-fast`) share ONE credit family — they are
   // variants of the same engine plan (plan internals live in the private
   // analysis plugin). Admin-tunable via model_pricing like every other row.
-  "video-analysis:mixed:60s": 268,
-  "video-analysis:mixed:180s": 289,
-  "video-analysis:mixed:360s": 724,
-  "video-analysis:mixed:600s": 1169,
+  "video-analysis:mixed:60s": 269,
+  "video-analysis:mixed:180s": 290,
+  "video-analysis:mixed:360s": 727,
+  "video-analysis:mixed:600s": 1174,
   // SMART — the accuracy tier, and since the 2026-08-03 re-plan a multi-roll
   // plan like the others, always refined (`selectionMode` does not apply
   // here — smart always refines; it never offers a cheaper "choose" path).
   // Priced above the economy tiers because it genuinely costs more to run;
   // the only tier whose accuracy is validated against a hand-counted edit
   // list, re-validated at the current plan before this schedule shipped.
-  "video-analysis:smart:60s": 410,
-  "video-analysis:smart:180s": 500,
-  "video-analysis:smart:360s": 1259,
-  "video-analysis:smart:600s": 2064,
+  "video-analysis:smart:60s": 412,
+  "video-analysis:smart:180s": 502,
+  "video-analysis:smart:360s": 1264,
+  "video-analysis:smart:600s": 2071,
 }
 
 /**
@@ -188,14 +199,14 @@ export function videoAnalysisNumWindows(bucketSec: number): number {
  * never hand computed. The plugin's cost test cross-checks every row.
  */
 export const VIDEO_AUDIT_BUCKET_CREDITS: Record<string, number> = {
-  "video-audit:60s": 213,
-  "video-audit:180s": 289,
-  "video-audit:360s": 659,
-  "video-audit:600s": 1066,
-  "video-audit:auto:60s": 393,
-  "video-audit:auto:180s": 474,
-  "video-audit:auto:360s": 1173,
-  "video-audit:auto:600s": 1912,
+  "video-audit:60s": 214,
+  "video-audit:180s": 290,
+  "video-audit:360s": 661,
+  "video-audit:600s": 1070,
+  "video-audit:auto:60s": 394,
+  "video-audit:auto:180s": 475,
+  "video-audit:auto:360s": 1176,
+  "video-audit:auto:600s": 1917,
 }
 
 /**

package/src/video-analysis.ts

@@ -88,6 +88,21 @@ export type VideoAnalysisVisualEffect = (typeof VIDEO_ANALYSIS_VISUAL_EFFECTS)[n
 export const VIDEO_ANALYSIS_TRANSITIONS = ["cut", "fade", "dissolve", "wipe", "whip"] as const
 export type VideoAnalysisTransition = (typeof VIDEO_ANALYSIS_TRANSITIONS)[number]
 
+/**
+ * What burned-in text IS (2026-08-28, recast shot craft). Decides render-vs-omit
+ * downstream: a `subtitle` is a transcription of the piece's own speech — a
+ * recreation re-speaks it and must not render it — while a `title`, `caption`,
+ * `lower-third` or `logo` is picture content. Absent when a scene carries no
+ * text. A new KEY on the scene: strip-mode readers drop it harmlessly.
+ */
+export const VIDEO_ANALYSIS_TEXT_KINDS = ["title", "caption", "lower-third", "subtitle", "logo", "other"] as const
+export type VideoAnalysisTextKind = (typeof VIDEO_ANALYSIS_TEXT_KINDS)[number]
+
+/** How the CLIP opens (clip-level, not per scene — a window's first scene is
+ *  not the clip's). Absent ⇒ a hard open. Only `fade` today. */
+export const VIDEO_ANALYSIS_CLIP_TRANSITIONS_IN = ["fade"] as const
+export type VideoAnalysisClipTransitionIn = (typeof VIDEO_ANALYSIS_CLIP_TRANSITIONS_IN)[number]
+
 /**
  * Time manipulation — slow motion, ramps, timelapse, freeze, reverse.
  *
@@ -302,6 +317,8 @@ const windowSceneBase = z.object({
    * earlier scene's speech means the shot is replayed footage under a voice-over.
    */
   onScreenText: z.string().optional(),
+  /** What the on-screen text IS. Meaningful only when `onScreenText` is non-empty. */
+  onScreenTextKind: z.enum(VIDEO_ANALYSIS_TEXT_KINDS).optional(),
   /** Effects on this shot's PICTURE. Absent ⇒ a clean image. */
   effects: z.array(z.enum(VIDEO_ANALYSIS_VISUAL_EFFECTS)).optional(),
   transitionOut: z.enum(VIDEO_ANALYSIS_TRANSITIONS).optional(),
@@ -323,6 +340,8 @@ export const windowAnalysisSchema = z.object({
   /** The clip-level look as read from THIS window. Merge folds the windows
    *  field-by-field (first non-empty wins), like `language`. */
   look: clipLookSchema.optional(),
+  /** The clip opens with a fade-in. Folded from window 0 only. */
+  transitionIn: z.enum(VIDEO_ANALYSIS_CLIP_TRANSITIONS_IN).optional(),
   slots: z.array(entitySlotSchema),
   scenes: z.array(windowSceneSchema),
 })
@@ -349,6 +368,8 @@ export const videoAnalysisResultSchema = z.object({
    *  rather than a member: `meta` is probed fact (ffprobe dimensions, probed
    *  duration), while this is the model's reading of the photography. */
   look: clipLookSchema.optional(),
+  /** The clip opens with a fade-in. Folded from window 0 only. */
+  transitionIn: z.enum(VIDEO_ANALYSIS_CLIP_TRANSITIONS_IN).optional(),
   slots: z.array(entitySlotSchema),
   scenes: z.array(analyzedSceneSchema).min(1),
   /** CAST VARIATIONS (§4 cap handling): looks the analyzer's merge FOLDED into