diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index f1ce0e9..78ee27d 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -5,26 +5,26 @@ }, "metadata": { "description": "Film craft and AI video coherence: plan, continuity-check and compile shots for video models", - "version": "0.6.22" + "version": "0.6.23" }, "plugins": [ { "name": "cinewright", "source": "./plugins/cinewright", "description": "Core: plan shots, continuity-check and compile AI video prompts, review takes", - "version": "0.6.22" + "version": "0.6.23" }, { "name": "cinewright-craft", "source": "./plugins/cinewright-craft", "description": "Craft: script, design, movement, camera and lighting, film history styles, editing, color and VFX finishing, sound and mix", - "version": "0.6.22" + "version": "0.6.23" }, { "name": "cinewright-dev", "source": "./plugins/cinewright-dev", "description": "Dev: knowledge-base upkeep for cinewright maintainers", - "version": "0.6.22" + "version": "0.6.23" } ] } diff --git a/ai-docs/log.md b/ai-docs/log.md index 7498af3..6b07f5f 100644 --- a/ai-docs/log.md +++ b/ai-docs/log.md @@ -1034,3 +1034,4 @@ Step 3 finished: shots at threshold 0.15 (51 shots), wide frames for rooms 4 (3. - 2026-11-18 0.6.20: cinewright-history Bresson and Antonioni cards (book harvest round 21: Kovacs, Screening Modernism; Antonioni, Architecture of Vision). unittest OK, kb lint 0 errors, budget yellow (repo zip, unchanged), scrub 248 hits = baseline, 0 in diff. - 2026-11-18 0.6.21: cinewright-genvideo compile-rule timed segments anchor-then-changes (technique-harvest ct10 O2-1, kijai PromptRelay idea, no licence). unittest OK, kb lint 0 errors, budget yellow (repo zip, unchanged), scrub 248 hits = baseline. - 2026-11-19 0.6.22: sc40 chain-join harvest. cinewright-qc scripts/cine_seam.py (S28 seam metric + S30 framing zoom, stdlib; shared/lib had under 5 KB left, so not in cine.py), SKILL.md seam/rank/colour-match lines; scene `locked` list into cards new and qc rubric (S22, code locked-drift); ai-continuity one bed + J/L offset (S25) and notes S19, S8/S10, S49, S50, S9; qc RESEARCH S29. Calibration: C1 motion zoom 1.063 vs 1.005 before WARN, C1 still 1.000, harvest_A 0.978, 1wio4eg 0.931/0.938 PASS. unittest 162 OK, kb lint 0 errors, budget yellow (qc SKILL.md body 1389 tokens, runtime 195 KB unchanged), validate passed x4, scrub 248 hits = baseline. +- 2026-11-19 0.6.23: books round 6 track 44 (McKee, Truby, Williams). Script rules merged into five entries; cine.py UNPHOTOGRAPHABLE warn (comments trimmed to pay for it, runtime 195 KB); qc failures-motion bilabial-miss + impact-sync (entry was red at 1383 tokens with four codes: rows tightened, teeth-rubber and rushed-action dropped, now 1200), look-pass pretty-no-turn + no-turn-blink. unittest 164 OK, kb lint 0 errors, budget yellow. diff --git a/plugins/cinewright-craft/.claude-plugin/plugin.json b/plugins/cinewright-craft/.claude-plugin/plugin.json index 9172dab..14ef74d 100644 --- a/plugins/cinewright-craft/.claude-plugin/plugin.json +++ b/plugins/cinewright-craft/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "cinewright-craft", - "version": "0.6.22", + "version": "0.6.23", "description": "Film craft skills for AI video: cinewright-script (logline, beats, scene turns, dialogue for generated voices), cinewright-design (turnaround sheets, clean references, prop descriptions, costume arc, color script), cinewright-sets (set plans, per-wall location strings, master plates, coverage and reverse angles, set light, plate checks), cinewright-movement (weight, one phrase per shot, fights, battles, hard subjects), cinewright-camera (lens, depth of field, exposure, shutter, aspect and framing, lighting, color temperature), cinewright-history (movement, era, genre, director and cinematographer style cards), cinewright-edit (assembly, rule of six, J and L cuts, pacing, trimming generations, cutting battles), cinewright-finish (grade order, color spaces and delivery, crop to the film's frame, day for night, crowd multiplication, upscale last) cinewright-sound (layers and stems, generated audio, battle sound, mixing to a loudness target) and cinewright-voice (voice sheets, designed or cloned voices locked by reference clips, drift checks). Needs the cinewright plugin.", "author": { "name": "Mark Rogers" diff --git a/plugins/cinewright-craft/plugin.json b/plugins/cinewright-craft/plugin.json index 0a99cfa..952d16d 100644 --- a/plugins/cinewright-craft/plugin.json +++ b/plugins/cinewright-craft/plugin.json @@ -1,7 +1,7 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "cinewright-craft", - "version": "0.6.22", + "version": "0.6.23", "description": "Film craft skills for AI video: cinewright-script (logline, beats, scene turns, dialogue for generated voices), cinewright-design (turnaround sheets, clean references, prop descriptions, costume arc, color script), cinewright-sets (set plans, per-wall location strings, master plates, coverage and reverse angles, set light, plate checks), cinewright-movement (weight, one phrase per shot, fights, battles, hard subjects), cinewright-camera (lens, depth of field, exposure, shutter, aspect and framing, lighting, color temperature), cinewright-history (movement, era, genre, director and cinematographer style cards), cinewright-edit (assembly, rule of six, J and L cuts, pacing, trimming generations, cutting battles), cinewright-finish (grade order, color spaces and delivery, crop to the film's frame, day for night, crowd multiplication, upscale last) cinewright-sound (layers and stems, generated audio, battle sound, mixing to a loudness target) and cinewright-voice (voice sheets, designed or cloned voices locked by reference clips, drift checks). Needs the cinewright plugin.", "author": { "name": "Mark Rogers" diff --git a/plugins/cinewright-craft/skills/cinewright-camera/scripts/cine.py b/plugins/cinewright-craft/skills/cinewright-camera/scripts/cine.py index 311b9a3..912950f 100644 --- a/plugins/cinewright-craft/skills/cinewright-camera/scripts/cine.py +++ b/plugins/cinewright-craft/skills/cinewright-camera/scripts/cine.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -# copied from shared/lib/cine.py sha256:96258846e375b16ed16ed102cc6ad67a016ce67b2d72915859a483b894fb9bf6; edit the source +# copied from shared/lib/cine.py sha256:f455cd7246ca27533634090c6ff1a7f5cf702a865305e68b40c054b77bfe56f7; edit the source """cinewright runtime CLI: kb, cards, compile, continuity, qc, takes, voice. Run it; do not read it. Python 3.9+, standard library only. @@ -57,8 +57,7 @@ "arc-right": "the camera arcs slowly right around the subject, the background sliding behind", "dolly-zoom": "dolly zoom, the background stretching away while the subject keeps the same size", } -# Camera height and horizon together pin the angle (after Mateu-Mestre, Framed Ink). Out-of-frame values name no -# horizon: every noun gets drawn, so an interior card leaves horizon unset. +# Height and horizon pin the angle (Mateu-Mestre, Framed Ink). Interiors leave horizon unset: every noun gets drawn. HORIZON_WORDS = {"lower-third": "the horizon on the lower third of the frame", "middle": "the horizon across the middle of the frame", "upper-third": "the horizon on the upper third of the frame", "above-frame": "the ground fills the frame to the top edge", "below-frame": "only sky behind, the ground below the frame"} @@ -756,6 +755,7 @@ def graph_lines(rows, flags): RESULT_WORDS = set("angry sad scared smug desperate sexy quirky intense menacing emotional dramatic defensive sarcastic " "hostile cold vicious nervous calm friendly weak upset furious happy anxious".split()) RESULT_FILL = {"and", "very", "a", "bit", "more", "is", "looks", "feels"} +UNPHOTO = re.compile(r"\b(as if|as though|we (?:see|hear)|there (?:is|are)|seems?|for a long time)\b", re.I) # McKee, Story ch. 23 PLANT_LEVEL = 80 # "climax" cards for PLANT-MISSING; the reader's threshold, warn-only @@ -1010,6 +1010,9 @@ def add(level, card, code, msg): aw = set(re.findall(r"[a-z]+", action.lower())) - {w for m in cast1 for w in _norm("%s %s" % (m.get("id"), p.chars.get(m.get("id"), {}).get("name"))).split()} if sz in ("CU", "ECU") and cast1 and aw and aw <= RESULT_WORDS | RESULT_FILL and aw & RESULT_WORDS: add("warning", card, "RESULT", "a %s whose action is only a result (%s); give the face a verb" % (sz, " ".join(sorted(aw)))) + hit = UNPHOTO.search(action) + if hit: + add("warning", card, "UNPHOTOGRAPHABLE", "'%s' in the action: write what the camera sees or hears (entry screenplay-format)" % hit.group(0)) if _norm(card.get("beat")) and _norm(card.get("beat")) == _norm((prev or {}).get("beat")): add("warning", card, "BEAT-REPEAT", "same beat as %s; cut one or change what it tells (entry logline-and-beats)" % prev["id"]) pcs = (prev or {}).get("cast", []) @@ -1995,9 +1998,8 @@ def agree_stats(pairs): return res -# Machine measures of a take (qc measure). They find technical faults a reviewer misses at contact-sheet -# resolution; they never judge acting, look or story (that is the rubric). Thresholds were set on 2026-10-07 -# against reviewed takes of three local multi-shot films (keepers and rejects). +# qc measure: technical faults a contact sheet misses, never acting, look or story (the rubric). +# Thresholds set 2026-10-07 on reviewed keepers and rejects of three local films. MEASURE_CUT_SCENE = 0.30 # ffmpeg scene score that counts as a cut MEASURE_CUT_EARLY_S = 1.0 # H3 cuts 0.1-0.8 s before the stamped time (24 reviewed takes), so allow early MEASURE_CUT_LATE_S = 0.6 # ... and less late diff --git a/plugins/cinewright-craft/skills/cinewright-design/scripts/cine.py b/plugins/cinewright-craft/skills/cinewright-design/scripts/cine.py index 311b9a3..912950f 100644 --- a/plugins/cinewright-craft/skills/cinewright-design/scripts/cine.py +++ b/plugins/cinewright-craft/skills/cinewright-design/scripts/cine.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -# copied from shared/lib/cine.py sha256:96258846e375b16ed16ed102cc6ad67a016ce67b2d72915859a483b894fb9bf6; edit the source +# copied from shared/lib/cine.py sha256:f455cd7246ca27533634090c6ff1a7f5cf702a865305e68b40c054b77bfe56f7; edit the source """cinewright runtime CLI: kb, cards, compile, continuity, qc, takes, voice. Run it; do not read it. Python 3.9+, standard library only. @@ -57,8 +57,7 @@ "arc-right": "the camera arcs slowly right around the subject, the background sliding behind", "dolly-zoom": "dolly zoom, the background stretching away while the subject keeps the same size", } -# Camera height and horizon together pin the angle (after Mateu-Mestre, Framed Ink). Out-of-frame values name no -# horizon: every noun gets drawn, so an interior card leaves horizon unset. +# Height and horizon pin the angle (Mateu-Mestre, Framed Ink). Interiors leave horizon unset: every noun gets drawn. HORIZON_WORDS = {"lower-third": "the horizon on the lower third of the frame", "middle": "the horizon across the middle of the frame", "upper-third": "the horizon on the upper third of the frame", "above-frame": "the ground fills the frame to the top edge", "below-frame": "only sky behind, the ground below the frame"} @@ -756,6 +755,7 @@ def graph_lines(rows, flags): RESULT_WORDS = set("angry sad scared smug desperate sexy quirky intense menacing emotional dramatic defensive sarcastic " "hostile cold vicious nervous calm friendly weak upset furious happy anxious".split()) RESULT_FILL = {"and", "very", "a", "bit", "more", "is", "looks", "feels"} +UNPHOTO = re.compile(r"\b(as if|as though|we (?:see|hear)|there (?:is|are)|seems?|for a long time)\b", re.I) # McKee, Story ch. 23 PLANT_LEVEL = 80 # "climax" cards for PLANT-MISSING; the reader's threshold, warn-only @@ -1010,6 +1010,9 @@ def add(level, card, code, msg): aw = set(re.findall(r"[a-z]+", action.lower())) - {w for m in cast1 for w in _norm("%s %s" % (m.get("id"), p.chars.get(m.get("id"), {}).get("name"))).split()} if sz in ("CU", "ECU") and cast1 and aw and aw <= RESULT_WORDS | RESULT_FILL and aw & RESULT_WORDS: add("warning", card, "RESULT", "a %s whose action is only a result (%s); give the face a verb" % (sz, " ".join(sorted(aw)))) + hit = UNPHOTO.search(action) + if hit: + add("warning", card, "UNPHOTOGRAPHABLE", "'%s' in the action: write what the camera sees or hears (entry screenplay-format)" % hit.group(0)) if _norm(card.get("beat")) and _norm(card.get("beat")) == _norm((prev or {}).get("beat")): add("warning", card, "BEAT-REPEAT", "same beat as %s; cut one or change what it tells (entry logline-and-beats)" % prev["id"]) pcs = (prev or {}).get("cast", []) @@ -1995,9 +1998,8 @@ def agree_stats(pairs): return res -# Machine measures of a take (qc measure). They find technical faults a reviewer misses at contact-sheet -# resolution; they never judge acting, look or story (that is the rubric). Thresholds were set on 2026-10-07 -# against reviewed takes of three local multi-shot films (keepers and rejects). +# qc measure: technical faults a contact sheet misses, never acting, look or story (the rubric). +# Thresholds set 2026-10-07 on reviewed keepers and rejects of three local films. MEASURE_CUT_SCENE = 0.30 # ffmpeg scene score that counts as a cut MEASURE_CUT_EARLY_S = 1.0 # H3 cuts 0.1-0.8 s before the stamped time (24 reviewed takes), so allow early MEASURE_CUT_LATE_S = 0.6 # ... and less late diff --git a/plugins/cinewright-craft/skills/cinewright-edit/scripts/cine.py b/plugins/cinewright-craft/skills/cinewright-edit/scripts/cine.py index 311b9a3..912950f 100644 --- a/plugins/cinewright-craft/skills/cinewright-edit/scripts/cine.py +++ b/plugins/cinewright-craft/skills/cinewright-edit/scripts/cine.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -# copied from shared/lib/cine.py sha256:96258846e375b16ed16ed102cc6ad67a016ce67b2d72915859a483b894fb9bf6; edit the source +# copied from shared/lib/cine.py sha256:f455cd7246ca27533634090c6ff1a7f5cf702a865305e68b40c054b77bfe56f7; edit the source """cinewright runtime CLI: kb, cards, compile, continuity, qc, takes, voice. Run it; do not read it. Python 3.9+, standard library only. @@ -57,8 +57,7 @@ "arc-right": "the camera arcs slowly right around the subject, the background sliding behind", "dolly-zoom": "dolly zoom, the background stretching away while the subject keeps the same size", } -# Camera height and horizon together pin the angle (after Mateu-Mestre, Framed Ink). Out-of-frame values name no -# horizon: every noun gets drawn, so an interior card leaves horizon unset. +# Height and horizon pin the angle (Mateu-Mestre, Framed Ink). Interiors leave horizon unset: every noun gets drawn. HORIZON_WORDS = {"lower-third": "the horizon on the lower third of the frame", "middle": "the horizon across the middle of the frame", "upper-third": "the horizon on the upper third of the frame", "above-frame": "the ground fills the frame to the top edge", "below-frame": "only sky behind, the ground below the frame"} @@ -756,6 +755,7 @@ def graph_lines(rows, flags): RESULT_WORDS = set("angry sad scared smug desperate sexy quirky intense menacing emotional dramatic defensive sarcastic " "hostile cold vicious nervous calm friendly weak upset furious happy anxious".split()) RESULT_FILL = {"and", "very", "a", "bit", "more", "is", "looks", "feels"} +UNPHOTO = re.compile(r"\b(as if|as though|we (?:see|hear)|there (?:is|are)|seems?|for a long time)\b", re.I) # McKee, Story ch. 23 PLANT_LEVEL = 80 # "climax" cards for PLANT-MISSING; the reader's threshold, warn-only @@ -1010,6 +1010,9 @@ def add(level, card, code, msg): aw = set(re.findall(r"[a-z]+", action.lower())) - {w for m in cast1 for w in _norm("%s %s" % (m.get("id"), p.chars.get(m.get("id"), {}).get("name"))).split()} if sz in ("CU", "ECU") and cast1 and aw and aw <= RESULT_WORDS | RESULT_FILL and aw & RESULT_WORDS: add("warning", card, "RESULT", "a %s whose action is only a result (%s); give the face a verb" % (sz, " ".join(sorted(aw)))) + hit = UNPHOTO.search(action) + if hit: + add("warning", card, "UNPHOTOGRAPHABLE", "'%s' in the action: write what the camera sees or hears (entry screenplay-format)" % hit.group(0)) if _norm(card.get("beat")) and _norm(card.get("beat")) == _norm((prev or {}).get("beat")): add("warning", card, "BEAT-REPEAT", "same beat as %s; cut one or change what it tells (entry logline-and-beats)" % prev["id"]) pcs = (prev or {}).get("cast", []) @@ -1995,9 +1998,8 @@ def agree_stats(pairs): return res -# Machine measures of a take (qc measure). They find technical faults a reviewer misses at contact-sheet -# resolution; they never judge acting, look or story (that is the rubric). Thresholds were set on 2026-10-07 -# against reviewed takes of three local multi-shot films (keepers and rejects). +# qc measure: technical faults a contact sheet misses, never acting, look or story (the rubric). +# Thresholds set 2026-10-07 on reviewed keepers and rejects of three local films. MEASURE_CUT_SCENE = 0.30 # ffmpeg scene score that counts as a cut MEASURE_CUT_EARLY_S = 1.0 # H3 cuts 0.1-0.8 s before the stamped time (24 reviewed takes), so allow early MEASURE_CUT_LATE_S = 0.6 # ... and less late diff --git a/plugins/cinewright-craft/skills/cinewright-finish/scripts/cine.py b/plugins/cinewright-craft/skills/cinewright-finish/scripts/cine.py index 311b9a3..912950f 100644 --- a/plugins/cinewright-craft/skills/cinewright-finish/scripts/cine.py +++ b/plugins/cinewright-craft/skills/cinewright-finish/scripts/cine.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -# copied from shared/lib/cine.py sha256:96258846e375b16ed16ed102cc6ad67a016ce67b2d72915859a483b894fb9bf6; edit the source +# copied from shared/lib/cine.py sha256:f455cd7246ca27533634090c6ff1a7f5cf702a865305e68b40c054b77bfe56f7; edit the source """cinewright runtime CLI: kb, cards, compile, continuity, qc, takes, voice. Run it; do not read it. Python 3.9+, standard library only. @@ -57,8 +57,7 @@ "arc-right": "the camera arcs slowly right around the subject, the background sliding behind", "dolly-zoom": "dolly zoom, the background stretching away while the subject keeps the same size", } -# Camera height and horizon together pin the angle (after Mateu-Mestre, Framed Ink). Out-of-frame values name no -# horizon: every noun gets drawn, so an interior card leaves horizon unset. +# Height and horizon pin the angle (Mateu-Mestre, Framed Ink). Interiors leave horizon unset: every noun gets drawn. HORIZON_WORDS = {"lower-third": "the horizon on the lower third of the frame", "middle": "the horizon across the middle of the frame", "upper-third": "the horizon on the upper third of the frame", "above-frame": "the ground fills the frame to the top edge", "below-frame": "only sky behind, the ground below the frame"} @@ -756,6 +755,7 @@ def graph_lines(rows, flags): RESULT_WORDS = set("angry sad scared smug desperate sexy quirky intense menacing emotional dramatic defensive sarcastic " "hostile cold vicious nervous calm friendly weak upset furious happy anxious".split()) RESULT_FILL = {"and", "very", "a", "bit", "more", "is", "looks", "feels"} +UNPHOTO = re.compile(r"\b(as if|as though|we (?:see|hear)|there (?:is|are)|seems?|for a long time)\b", re.I) # McKee, Story ch. 23 PLANT_LEVEL = 80 # "climax" cards for PLANT-MISSING; the reader's threshold, warn-only @@ -1010,6 +1010,9 @@ def add(level, card, code, msg): aw = set(re.findall(r"[a-z]+", action.lower())) - {w for m in cast1 for w in _norm("%s %s" % (m.get("id"), p.chars.get(m.get("id"), {}).get("name"))).split()} if sz in ("CU", "ECU") and cast1 and aw and aw <= RESULT_WORDS | RESULT_FILL and aw & RESULT_WORDS: add("warning", card, "RESULT", "a %s whose action is only a result (%s); give the face a verb" % (sz, " ".join(sorted(aw)))) + hit = UNPHOTO.search(action) + if hit: + add("warning", card, "UNPHOTOGRAPHABLE", "'%s' in the action: write what the camera sees or hears (entry screenplay-format)" % hit.group(0)) if _norm(card.get("beat")) and _norm(card.get("beat")) == _norm((prev or {}).get("beat")): add("warning", card, "BEAT-REPEAT", "same beat as %s; cut one or change what it tells (entry logline-and-beats)" % prev["id"]) pcs = (prev or {}).get("cast", []) @@ -1995,9 +1998,8 @@ def agree_stats(pairs): return res -# Machine measures of a take (qc measure). They find technical faults a reviewer misses at contact-sheet -# resolution; they never judge acting, look or story (that is the rubric). Thresholds were set on 2026-10-07 -# against reviewed takes of three local multi-shot films (keepers and rejects). +# qc measure: technical faults a contact sheet misses, never acting, look or story (the rubric). +# Thresholds set 2026-10-07 on reviewed keepers and rejects of three local films. MEASURE_CUT_SCENE = 0.30 # ffmpeg scene score that counts as a cut MEASURE_CUT_EARLY_S = 1.0 # H3 cuts 0.1-0.8 s before the stamped time (24 reviewed takes), so allow early MEASURE_CUT_LATE_S = 0.6 # ... and less late diff --git a/plugins/cinewright-craft/skills/cinewright-history/scripts/cine.py b/plugins/cinewright-craft/skills/cinewright-history/scripts/cine.py index 311b9a3..912950f 100644 --- a/plugins/cinewright-craft/skills/cinewright-history/scripts/cine.py +++ b/plugins/cinewright-craft/skills/cinewright-history/scripts/cine.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -# copied from shared/lib/cine.py sha256:96258846e375b16ed16ed102cc6ad67a016ce67b2d72915859a483b894fb9bf6; edit the source +# copied from shared/lib/cine.py sha256:f455cd7246ca27533634090c6ff1a7f5cf702a865305e68b40c054b77bfe56f7; edit the source """cinewright runtime CLI: kb, cards, compile, continuity, qc, takes, voice. Run it; do not read it. Python 3.9+, standard library only. @@ -57,8 +57,7 @@ "arc-right": "the camera arcs slowly right around the subject, the background sliding behind", "dolly-zoom": "dolly zoom, the background stretching away while the subject keeps the same size", } -# Camera height and horizon together pin the angle (after Mateu-Mestre, Framed Ink). Out-of-frame values name no -# horizon: every noun gets drawn, so an interior card leaves horizon unset. +# Height and horizon pin the angle (Mateu-Mestre, Framed Ink). Interiors leave horizon unset: every noun gets drawn. HORIZON_WORDS = {"lower-third": "the horizon on the lower third of the frame", "middle": "the horizon across the middle of the frame", "upper-third": "the horizon on the upper third of the frame", "above-frame": "the ground fills the frame to the top edge", "below-frame": "only sky behind, the ground below the frame"} @@ -756,6 +755,7 @@ def graph_lines(rows, flags): RESULT_WORDS = set("angry sad scared smug desperate sexy quirky intense menacing emotional dramatic defensive sarcastic " "hostile cold vicious nervous calm friendly weak upset furious happy anxious".split()) RESULT_FILL = {"and", "very", "a", "bit", "more", "is", "looks", "feels"} +UNPHOTO = re.compile(r"\b(as if|as though|we (?:see|hear)|there (?:is|are)|seems?|for a long time)\b", re.I) # McKee, Story ch. 23 PLANT_LEVEL = 80 # "climax" cards for PLANT-MISSING; the reader's threshold, warn-only @@ -1010,6 +1010,9 @@ def add(level, card, code, msg): aw = set(re.findall(r"[a-z]+", action.lower())) - {w for m in cast1 for w in _norm("%s %s" % (m.get("id"), p.chars.get(m.get("id"), {}).get("name"))).split()} if sz in ("CU", "ECU") and cast1 and aw and aw <= RESULT_WORDS | RESULT_FILL and aw & RESULT_WORDS: add("warning", card, "RESULT", "a %s whose action is only a result (%s); give the face a verb" % (sz, " ".join(sorted(aw)))) + hit = UNPHOTO.search(action) + if hit: + add("warning", card, "UNPHOTOGRAPHABLE", "'%s' in the action: write what the camera sees or hears (entry screenplay-format)" % hit.group(0)) if _norm(card.get("beat")) and _norm(card.get("beat")) == _norm((prev or {}).get("beat")): add("warning", card, "BEAT-REPEAT", "same beat as %s; cut one or change what it tells (entry logline-and-beats)" % prev["id"]) pcs = (prev or {}).get("cast", []) @@ -1995,9 +1998,8 @@ def agree_stats(pairs): return res -# Machine measures of a take (qc measure). They find technical faults a reviewer misses at contact-sheet -# resolution; they never judge acting, look or story (that is the rubric). Thresholds were set on 2026-10-07 -# against reviewed takes of three local multi-shot films (keepers and rejects). +# qc measure: technical faults a contact sheet misses, never acting, look or story (the rubric). +# Thresholds set 2026-10-07 on reviewed keepers and rejects of three local films. MEASURE_CUT_SCENE = 0.30 # ffmpeg scene score that counts as a cut MEASURE_CUT_EARLY_S = 1.0 # H3 cuts 0.1-0.8 s before the stamped time (24 reviewed takes), so allow early MEASURE_CUT_LATE_S = 0.6 # ... and less late diff --git a/plugins/cinewright-craft/skills/cinewright-movement/scripts/cine.py b/plugins/cinewright-craft/skills/cinewright-movement/scripts/cine.py index 311b9a3..912950f 100644 --- a/plugins/cinewright-craft/skills/cinewright-movement/scripts/cine.py +++ b/plugins/cinewright-craft/skills/cinewright-movement/scripts/cine.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -# copied from shared/lib/cine.py sha256:96258846e375b16ed16ed102cc6ad67a016ce67b2d72915859a483b894fb9bf6; edit the source +# copied from shared/lib/cine.py sha256:f455cd7246ca27533634090c6ff1a7f5cf702a865305e68b40c054b77bfe56f7; edit the source """cinewright runtime CLI: kb, cards, compile, continuity, qc, takes, voice. Run it; do not read it. Python 3.9+, standard library only. @@ -57,8 +57,7 @@ "arc-right": "the camera arcs slowly right around the subject, the background sliding behind", "dolly-zoom": "dolly zoom, the background stretching away while the subject keeps the same size", } -# Camera height and horizon together pin the angle (after Mateu-Mestre, Framed Ink). Out-of-frame values name no -# horizon: every noun gets drawn, so an interior card leaves horizon unset. +# Height and horizon pin the angle (Mateu-Mestre, Framed Ink). Interiors leave horizon unset: every noun gets drawn. HORIZON_WORDS = {"lower-third": "the horizon on the lower third of the frame", "middle": "the horizon across the middle of the frame", "upper-third": "the horizon on the upper third of the frame", "above-frame": "the ground fills the frame to the top edge", "below-frame": "only sky behind, the ground below the frame"} @@ -756,6 +755,7 @@ def graph_lines(rows, flags): RESULT_WORDS = set("angry sad scared smug desperate sexy quirky intense menacing emotional dramatic defensive sarcastic " "hostile cold vicious nervous calm friendly weak upset furious happy anxious".split()) RESULT_FILL = {"and", "very", "a", "bit", "more", "is", "looks", "feels"} +UNPHOTO = re.compile(r"\b(as if|as though|we (?:see|hear)|there (?:is|are)|seems?|for a long time)\b", re.I) # McKee, Story ch. 23 PLANT_LEVEL = 80 # "climax" cards for PLANT-MISSING; the reader's threshold, warn-only @@ -1010,6 +1010,9 @@ def add(level, card, code, msg): aw = set(re.findall(r"[a-z]+", action.lower())) - {w for m in cast1 for w in _norm("%s %s" % (m.get("id"), p.chars.get(m.get("id"), {}).get("name"))).split()} if sz in ("CU", "ECU") and cast1 and aw and aw <= RESULT_WORDS | RESULT_FILL and aw & RESULT_WORDS: add("warning", card, "RESULT", "a %s whose action is only a result (%s); give the face a verb" % (sz, " ".join(sorted(aw)))) + hit = UNPHOTO.search(action) + if hit: + add("warning", card, "UNPHOTOGRAPHABLE", "'%s' in the action: write what the camera sees or hears (entry screenplay-format)" % hit.group(0)) if _norm(card.get("beat")) and _norm(card.get("beat")) == _norm((prev or {}).get("beat")): add("warning", card, "BEAT-REPEAT", "same beat as %s; cut one or change what it tells (entry logline-and-beats)" % prev["id"]) pcs = (prev or {}).get("cast", []) @@ -1995,9 +1998,8 @@ def agree_stats(pairs): return res -# Machine measures of a take (qc measure). They find technical faults a reviewer misses at contact-sheet -# resolution; they never judge acting, look or story (that is the rubric). Thresholds were set on 2026-10-07 -# against reviewed takes of three local multi-shot films (keepers and rejects). +# qc measure: technical faults a contact sheet misses, never acting, look or story (the rubric). +# Thresholds set 2026-10-07 on reviewed keepers and rejects of three local films. MEASURE_CUT_SCENE = 0.30 # ffmpeg scene score that counts as a cut MEASURE_CUT_EARLY_S = 1.0 # H3 cuts 0.1-0.8 s before the stamped time (24 reviewed takes), so allow early MEASURE_CUT_LATE_S = 0.6 # ... and less late diff --git a/plugins/cinewright-craft/skills/cinewright-script/CHANGELOG.md b/plugins/cinewright-craft/skills/cinewright-script/CHANGELOG.md index 1637400..dbb76b2 100644 --- a/plugins/cinewright-craft/skills/cinewright-script/CHANGELOG.md +++ b/plugins/cinewright-craft/skills/cinewright-script/CHANGELOG.md @@ -4,6 +4,11 @@ Every change to [SKILL.md](SKILL.md) and its companions, newest first, each with Entry shape: `### C-YYYYMMDD-n · date · one-line summary`, then `because:`, `files:`, and a sentence on what changed. +### C-20261119-1 · 2026-11-19 · McKee and Truby scene and line rules (0.6.23) +- because: book distillation round 6 (McKee, Story ch. 12-23; Truby, Anatomy of Story ch. 10) +- files: references/screenplay-format.md, scene-turns.md, logline-and-beats.md, dialogue-for-generated-voices.md, narration-writing.md; shared/lib cine.py +- Short rules merged into existing lines: name the thing and photographable action, mood never replaces a turn, three same-charge scenes, transition hinge, enter late and key line last, crisis held on screen with no cutaway, no late coincidence, inciting incident on screen, silent first, key word last and read aloud, break long speeches with a silent reaction, no "as you know", strip-the-voice-over test. `continuity diff` warns UNPHOTOGRAPHABLE on card action ("as if", "we see", "there is", "seems", "for a long time"). + ### C-20261113-2 · 2026-11-13 · Clip start and tail, cheat-out (Acting for Film) - because: book distillation (technique-harvest), R-20261113-2 - files: references/performance-words.md diff --git a/plugins/cinewright-craft/skills/cinewright-script/references/dialogue-for-generated-voices.md b/plugins/cinewright-craft/skills/cinewright-script/references/dialogue-for-generated-voices.md index b9c6718..f5d49f4 100644 --- a/plugins/cinewright-craft/skills/cinewright-script/references/dialogue-for-generated-voices.md +++ b/plugins/cinewright-craft/skills/cinewright-script/references/dialogue-for-generated-voices.md @@ -3,8 +3,8 @@ title: Dialogue for generated voices slug: dialogue-for-generated-voices summary: How many words fit a shot, one speaker per shot, off-screen lines, names a voice model mispronounces, voice strings in the bible, and the dialogue checks in the continuity diff. tags: [script, dialogue, voice, lip-sync, speech] -last_checked: 2026-11-09 -sources: ["Christopher Riley, The Hollywood Standard, 3rd ed., 2021", "https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_base_en.md", "library film test, 2026-10-07 (maintainer render)", "https://cloud.google.com/blog/products/ai-machine-learning/ultimate-prompting-guide-for-veo-3-1", "https://kling.ai/quickstart/klingai-video-3-model-user-guide", "Judith Weston, Directing Actors, 25th anniversary ed., 2021", "Michael Rabiger and Mick Hurbis-Cherrier, Directing: Film Techniques and Aesthetics, 6th ed., 2020"] +last_checked: 2026-11-19 +sources: ["Christopher Riley, The Hollywood Standard, 3rd ed., 2021", "Robert McKee, Story, 1997", "https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_base_en.md", "library film test, 2026-10-07 (maintainer render)", "https://cloud.google.com/blog/products/ai-machine-learning/ultimate-prompting-guide-for-veo-3-1", "https://kling.ai/quickstart/klingai-video-3-model-user-guide", "Judith Weston, Directing Actors, 25th anniversary ed., 2021", "Michael Rabiger and Mick Hurbis-Cherrier, Directing: Film Techniques and Aesthetics, 6th ed., 2020"] --- # Dialogue for generated voices @@ -14,12 +14,12 @@ sources: ["Christopher Riley, The Hollywood Standard, 3rd ed., 2021", "https://h - Fit the line to the shot: at most 2.5 words per second after half a second of lead-in (DIALOGUE). - One speaker per shot, and that speaker in the card's cast. Models lip-sync a face they can see: two speakers swap mouths, and an off-screen speaker's line goes to whoever is in frame (SPEAKERS, OFFSCREEN). Cut to the listener for the answer. - A line that must stay off screen: keep the speaker out of the cast; `compile` uses the model's voiceover syntax if its card has one (H3: `says in an off-screen voiceover`, visible lips closed), else leaves the line out for the mix. -- Short lines: one sentence, 12 words or fewer, subtext over explanation. +- Short lines: one sentence, 12 words or fewer, subtext over explanation. Key word last, no trailing phrase; it also lets the clip cut on the line's end. Read it aloud: rhymes and tongue twisters trip a voice (McKee ch. 23). - Words a voice says cleanly: numbers and abbreviations spelled as spoken, no stage directions inside the quotes. - A rare name that must be said: a respelling in characters.json `pronounce`, taken from the source the owner trusts (audiobook, author), never guessed. It replaces the name inside spoken lines only (PRONOUNCE). - Each speaker gets a `voice` string in the bible ("low, dry, unhurried"); a voice that must match across shots gets a locked reference (cinewright-voice, entry voice-sheet). - `tone` follows "says": an adverb or phrase ("under his breath"), never a verb (TONE). -- Silence is a line. +- Silence is a line. Break a long speech with a silent reaction card, not the speaker's voice over the listener's face. No "as you know" lines: what a character knows is a weapon in the scene (McKee ch. 20, 23). - Each line tries to get something from the listener. Put that verb in the line's `intent` ("pleading with her to stay"); engines that take free-text direction get it in place of an emotion tag (Rabiger ch. 8; Weston ch. 1). Verbs: `kb show performance-verbs`. - One subtext sentence per scene says what the talk is really about. Voice and face direction come from it, not from the surface words (Rabiger ch. 7, ch. 17). - No capitals or italics to force stress: that is a line reading. Give the subtext and let the engine place the stress (Weston ch. 1). Untested on TTS. diff --git a/plugins/cinewright-craft/skills/cinewright-script/references/logline-and-beats.md b/plugins/cinewright-craft/skills/cinewright-script/references/logline-and-beats.md index 1a253c7..a4ee858 100644 --- a/plugins/cinewright-craft/skills/cinewright-script/references/logline-and-beats.md +++ b/plugins/cinewright-craft/skills/cinewright-script/references/logline-and-beats.md @@ -3,8 +3,8 @@ title: Logline and beats slug: logline-and-beats summary: The one-sentence logline form, act proportions, how many beats a film of a given length holds, and the beat sentence each shot card carries. tags: [script, logline, beats, structure, acts] -last_checked: 2026-11-13 -sources: ["Blake Snyder, Save the Cat!, 2005", "Syd Field, Screenplay, rev. ed. 2005", "John Truby, The Anatomy of Story, 2007", "Michael Rabiger and Mick Hurbis-Cherrier, Directing: Film Techniques and Aesthetics, 6th ed., 2020", "David Mamet, On Directing Film, 1991", "David Bordwell, Poetics of Cinema, 2008, ch. 3", "David Bordwell, Narration in the Fiction Film, 1985, ch. 9", "Sheila Curran Bernard, Documentary Storytelling, 5th ed., ch. 2, 5 (book rule, unverified)"] +last_checked: 2026-11-19 +sources: ["Blake Snyder, Save the Cat!, 2005", "Syd Field, Screenplay, rev. ed. 2005", "John Truby, The Anatomy of Story, 2007", "Robert McKee, Story, 1997", "Michael Rabiger and Mick Hurbis-Cherrier, Directing: Film Techniques and Aesthetics, 6th ed., 2020", "David Mamet, On Directing Film, 1991", "David Bordwell, Poetics of Cinema, 2008, ch. 3", "David Bordwell, Narration in the Fiction Film, 1985, ch. 9", "Sheila Curran Bernard, Documentary Storytelling, 5th ed., ch. 2, 5 (book rule, unverified)"] --- # Logline and beats @@ -14,7 +14,7 @@ sources: ["Blake Snyder, Save the Cat!, 2005", "Syd Field, Screenplay, rev. ed. - Logline: one sentence, 35 words or fewer, in the form: when/where + a specific protagonist + wants a concrete goal + against a specific obstacle + what is at stake. No names needed; a defining adjective beats a name. - Write the logline first; if it will not fit one sentence, the film has two stories. Cut one. - Name the train in `brief.md`: the main line of action that pulls the film to its end. Start it in the opening beats (the point of attack); backstory comes after it moves, in small pieces. -- Open on a concrete event that happens on screen (why now), not on a place or on someone getting an idea (Mamet p. 81). +- Open on a concrete event that happens on screen (why now), not on a place or on someone getting an idea (Mamet p. 81). The inciting incident is on screen, never only in backstory or narration (McKee ch. 12). - Cap each scene objective: a visible end state that is won or flatly refused ("get the grade changed", not "win respect"). Write `ends_when:` per scene, the card where it resolves; later cards go to the next scene or are cut (Mamet p. 35, p. 41). - Beat names sit one level below the objective and never restate it or repeat each other: "to impress" under "win respect" is a repeat (Mamet p. 35). - A beat is one change the audience sees: a want shown, a choice made, a reversal, a reveal. Write each as a present-tense sentence with an active verb. "She hesitates" is a beat; "tension builds" is not. @@ -24,7 +24,7 @@ sources: ["Blake Snyder, Save the Cat!, 2005", "Syd Field, Screenplay, rev. ed. - Every fact the ending depends on is shown at least three times by different carriers (line, action, prop, another's comment); a prop the climax uses appears early and casually (Bordwell, Narration ch. 9). - Pair every inner need in the brief with a visible task (`need:` and `visible task:`): a stammer is the outward form of feeling unworthy (Rabiger ch. 4). - One objective per person per card; a second objective is a new card (Rabiger ch. 17). -- For each line of dialogue, ask whether a look or a task can carry it. A scene of dialogue singles with no action verb in any card is a warning sign (Rabiger ch. 8). +- Write the beats silent first, then add only the lines a look or a task cannot carry (McKee ch. 23; Truby ch. 10). A scene of dialogue singles with no action verb in any card is a warning sign (Rabiger ch. 8). - Each shot card's `beat` field names the beat it serves. A beat with no card is unshot; a card with no beat is cuttable. ## Numbers diff --git a/plugins/cinewright-craft/skills/cinewright-script/references/narration-writing.md b/plugins/cinewright-craft/skills/cinewright-script/references/narration-writing.md index 96515c2..2b26790 100644 --- a/plugins/cinewright-craft/skills/cinewright-script/references/narration-writing.md +++ b/plugins/cinewright-craft/skills/cinewright-script/references/narration-writing.md @@ -4,7 +4,7 @@ slug: narration-writing summary: Write voice-over against the cut shot list, not before it: each block adds what the picture cannot show, fits the gap before the next sync moment, and reads cleanly aloud. tags: [script, narration, voice-over, explainer, documentary] last_checked: 2026-11-13 -sources: ["Sheila Curran Bernard, Documentary Storytelling, 5th ed., ch. 14 (book rule, unverified)"] +sources: ["Sheila Curran Bernard, Documentary Storytelling, 5th ed., ch. 14 (book rule, unverified)", "Robert McKee, Story, 1997"] --- # Narration writing @@ -18,6 +18,7 @@ sources: ["Sheila Curran Bernard, Documentary Storytelling, 5th ed., ch. 14 (boo - Write for the ear: short sentences, subject before verb, no two numbers in one sentence, no words a voice trips on, no "the former and the latter". - Do the sums. Ages, spans and totals said aloud must agree with each other and with on-screen text. - No hype words ("incredible", "shocking"). Let the picture carry the weight. +- Fiction: strip the voice-over; if the story no longer reads, the narration is telling and the shots must carry it. A pan over photos is telling too (McKee ch. 20). - Leave strong moments without narration; silence over a reaction tells more than a line. - Hold one point of view and one tense through the film. - Plant what a later block will need, then remind the viewer briefly when it pays off. diff --git a/plugins/cinewright-craft/skills/cinewright-script/references/scene-turns.md b/plugins/cinewright-craft/skills/cinewright-script/references/scene-turns.md index d1f4be6..4cd5719 100644 --- a/plugins/cinewright-craft/skills/cinewright-script/references/scene-turns.md +++ b/plugins/cinewright-craft/skills/cinewright-script/references/scene-turns.md @@ -3,7 +3,7 @@ title: Scene turns slug: scene-turns summary: Every scene turns a value from positive to negative or back; how to name the value, the goal and the turning point, and place the turn in one shot. tags: [script, scene, turn, value, conflict] -last_checked: 2026-11-09 +last_checked: 2026-11-19 sources: ["Robert McKee, Story, 1997", "John Truby, The Anatomy of Story, 2007", "Michael Rabiger and Mick Hurbis-Cherrier, Directing: Film Techniques and Aesthetics, 6th ed., 2020", "Nicholas T. Proferes, Film Directing Fundamentals, 4th ed., ch. 2, 7", "David Bordwell, Narration in the Fiction Film, 1985, ch. 9", "Bordwell, Staiger, Thompson, The Classical Hollywood Cinema, 1985, p. 67"] --- @@ -11,13 +11,16 @@ sources: ["Robert McKee, Story, 1997", "John Truby, The Anatomy of Story, 2007", ## Rules -- Every scene turns a value (McKee): name the value (trust, safety, hope, love, life) and its charge at the start and at the end, plus or minus. A scene that ends with the same charge it started with is cut or merged. +- Every scene turns a value (McKee): name the value (trust, safety, hope, love, life) and its charge at the start and at the end, plus or minus. A scene that ends with the same charge it started with is cut or merged, however pretty its light or music: mood never replaces a turn (ch. 14-15). - Write three lines per scene in the script: the character's goal in the scene, what opposes it, and the turn (the moment the charge flips). - The turn happens in one shot. Mark that card in its `beat` ("turn: she trusts him") and give it the insert or the close-up; the shots before it build to it, the shots after show the consequence. - Turn on an action or a line the camera can see: a hand opens, a door shuts, a word is said. Never on a thought. -- Consecutive scenes alternate charge where possible (plus to minus, then minus to plus); two scenes turning the same way flatten the film. +- Consecutive scenes alternate charge where possible (plus to minus, then minus to plus); two scenes turning the same way flatten the film, and three in a row is a fault unless each is far stronger than the last (McKee ch. 14). - In a film of one scene, the scene turn is the story's turn. -- Scene chain: every scene but the last leaves one line open (a question, appointment, threat), and the next opens on it in its first shot or line; a dialogue hook answers or echoes the last line across the cut (Bordwell, Narration ch. 9; Classical Hollywood p. 67). +- Enter late; the scene's key line or image comes last (Truby ch. 10). +- The crisis choice is between two goods or two evils, never right against wrong. Hold it on a static card on screen, and cut straight from it to the climax, no cutaway between (McKee ch. 14, 17). +- No coincidence turns the story after the midpoint or at the end (McKee ch. 21). +- Scene chain: every scene but the last leaves one line open (a question, appointment, threat), and the next opens on it in its first shot or line, hinged on something A's tail and B's head share or oppose (an action, object, word, light, sound) (McKee ch. 16); a dialogue hook answers or echoes the last line across the cut (Bordwell, Narration ch. 9; Classical Hollywood p. 67). - Mark the fulcrum card: where the scene could go either way for its owner, never its first or last card. Split the scene into dramatic blocks, each named by one owner verb (reason, seduce, threaten); consecutive blocks never share a verb (Proferes ch. 2, ch. 7). Warn only. - Note per scene `knowledge: restricted` (we know what the lead knows) or `unrestricted`; a goal-driven short sets a deadline in its first part (Bordwell, Narration ch. 9). - Write the turn as a change of awareness: "a-ha, the door is locked". A change in what someone knows gives the camera a face to hold (Rabiger ch. 4). diff --git a/plugins/cinewright-craft/skills/cinewright-script/references/screenplay-format.md b/plugins/cinewright-craft/skills/cinewright-script/references/screenplay-format.md index f05620c..55b8bd9 100644 --- a/plugins/cinewright-craft/skills/cinewright-script/references/screenplay-format.md +++ b/plugins/cinewright-craft/skills/cinewright-script/references/screenplay-format.md @@ -3,8 +3,8 @@ title: Screenplay format slug: screenplay-format summary: Slugline, action, character cue, parenthetical and dialogue layout in plain text, how the slugline maps to the scene bible, and the timing rule of a page. tags: [script, screenplay, slugline, format] -last_checked: 2026-10-04 -sources: ["Christopher Riley, The Hollywood Standard, 3rd ed., 2021", "https://fountain.io/syntax"] +last_checked: 2026-11-19 +sources: ["Robert McKee, Story, 1997", "Christopher Riley, The Hollywood Standard, 3rd ed., 2021", "https://fountain.io/syntax"] --- # Screenplay format @@ -18,6 +18,7 @@ sources: ["Christopher Riley, The Hollywood Standard, 3rd ed., 2021", "https://f - Introduce a character in capitals the first time, with age and one telling detail; the identity string in the character bible is that detail expanded. - Sound that matters goes in the action in capitals once: `RAIN hammers the glass`. It becomes the card's `sound`. - Never write camera directions in the script; they belong on the cards. +- Name the thing: a specific noun and verb ("hammers a spike", "her tenth cigarette"), never noun plus adjective or verb plus adverb. Only what can be filmed: no "as if", "we see", "there is", "seems", time spans (McKee ch. 23). `continuity diff` warns UNPHOTOGRAPHABLE on card action. ## Numbers diff --git a/plugins/cinewright-craft/skills/cinewright-script/scripts/cine.py b/plugins/cinewright-craft/skills/cinewright-script/scripts/cine.py index 311b9a3..912950f 100644 --- a/plugins/cinewright-craft/skills/cinewright-script/scripts/cine.py +++ b/plugins/cinewright-craft/skills/cinewright-script/scripts/cine.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -# copied from shared/lib/cine.py sha256:96258846e375b16ed16ed102cc6ad67a016ce67b2d72915859a483b894fb9bf6; edit the source +# copied from shared/lib/cine.py sha256:f455cd7246ca27533634090c6ff1a7f5cf702a865305e68b40c054b77bfe56f7; edit the source """cinewright runtime CLI: kb, cards, compile, continuity, qc, takes, voice. Run it; do not read it. Python 3.9+, standard library only. @@ -57,8 +57,7 @@ "arc-right": "the camera arcs slowly right around the subject, the background sliding behind", "dolly-zoom": "dolly zoom, the background stretching away while the subject keeps the same size", } -# Camera height and horizon together pin the angle (after Mateu-Mestre, Framed Ink). Out-of-frame values name no -# horizon: every noun gets drawn, so an interior card leaves horizon unset. +# Height and horizon pin the angle (Mateu-Mestre, Framed Ink). Interiors leave horizon unset: every noun gets drawn. HORIZON_WORDS = {"lower-third": "the horizon on the lower third of the frame", "middle": "the horizon across the middle of the frame", "upper-third": "the horizon on the upper third of the frame", "above-frame": "the ground fills the frame to the top edge", "below-frame": "only sky behind, the ground below the frame"} @@ -756,6 +755,7 @@ def graph_lines(rows, flags): RESULT_WORDS = set("angry sad scared smug desperate sexy quirky intense menacing emotional dramatic defensive sarcastic " "hostile cold vicious nervous calm friendly weak upset furious happy anxious".split()) RESULT_FILL = {"and", "very", "a", "bit", "more", "is", "looks", "feels"} +UNPHOTO = re.compile(r"\b(as if|as though|we (?:see|hear)|there (?:is|are)|seems?|for a long time)\b", re.I) # McKee, Story ch. 23 PLANT_LEVEL = 80 # "climax" cards for PLANT-MISSING; the reader's threshold, warn-only @@ -1010,6 +1010,9 @@ def add(level, card, code, msg): aw = set(re.findall(r"[a-z]+", action.lower())) - {w for m in cast1 for w in _norm("%s %s" % (m.get("id"), p.chars.get(m.get("id"), {}).get("name"))).split()} if sz in ("CU", "ECU") and cast1 and aw and aw <= RESULT_WORDS | RESULT_FILL and aw & RESULT_WORDS: add("warning", card, "RESULT", "a %s whose action is only a result (%s); give the face a verb" % (sz, " ".join(sorted(aw)))) + hit = UNPHOTO.search(action) + if hit: + add("warning", card, "UNPHOTOGRAPHABLE", "'%s' in the action: write what the camera sees or hears (entry screenplay-format)" % hit.group(0)) if _norm(card.get("beat")) and _norm(card.get("beat")) == _norm((prev or {}).get("beat")): add("warning", card, "BEAT-REPEAT", "same beat as %s; cut one or change what it tells (entry logline-and-beats)" % prev["id"]) pcs = (prev or {}).get("cast", []) @@ -1995,9 +1998,8 @@ def agree_stats(pairs): return res -# Machine measures of a take (qc measure). They find technical faults a reviewer misses at contact-sheet -# resolution; they never judge acting, look or story (that is the rubric). Thresholds were set on 2026-10-07 -# against reviewed takes of three local multi-shot films (keepers and rejects). +# qc measure: technical faults a contact sheet misses, never acting, look or story (the rubric). +# Thresholds set 2026-10-07 on reviewed keepers and rejects of three local films. MEASURE_CUT_SCENE = 0.30 # ffmpeg scene score that counts as a cut MEASURE_CUT_EARLY_S = 1.0 # H3 cuts 0.1-0.8 s before the stamped time (24 reviewed takes), so allow early MEASURE_CUT_LATE_S = 0.6 # ... and less late diff --git a/plugins/cinewright-craft/skills/cinewright-sets/scripts/cine.py b/plugins/cinewright-craft/skills/cinewright-sets/scripts/cine.py index 311b9a3..912950f 100644 --- a/plugins/cinewright-craft/skills/cinewright-sets/scripts/cine.py +++ b/plugins/cinewright-craft/skills/cinewright-sets/scripts/cine.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -# copied from shared/lib/cine.py sha256:96258846e375b16ed16ed102cc6ad67a016ce67b2d72915859a483b894fb9bf6; edit the source +# copied from shared/lib/cine.py sha256:f455cd7246ca27533634090c6ff1a7f5cf702a865305e68b40c054b77bfe56f7; edit the source """cinewright runtime CLI: kb, cards, compile, continuity, qc, takes, voice. Run it; do not read it. Python 3.9+, standard library only. @@ -57,8 +57,7 @@ "arc-right": "the camera arcs slowly right around the subject, the background sliding behind", "dolly-zoom": "dolly zoom, the background stretching away while the subject keeps the same size", } -# Camera height and horizon together pin the angle (after Mateu-Mestre, Framed Ink). Out-of-frame values name no -# horizon: every noun gets drawn, so an interior card leaves horizon unset. +# Height and horizon pin the angle (Mateu-Mestre, Framed Ink). Interiors leave horizon unset: every noun gets drawn. HORIZON_WORDS = {"lower-third": "the horizon on the lower third of the frame", "middle": "the horizon across the middle of the frame", "upper-third": "the horizon on the upper third of the frame", "above-frame": "the ground fills the frame to the top edge", "below-frame": "only sky behind, the ground below the frame"} @@ -756,6 +755,7 @@ def graph_lines(rows, flags): RESULT_WORDS = set("angry sad scared smug desperate sexy quirky intense menacing emotional dramatic defensive sarcastic " "hostile cold vicious nervous calm friendly weak upset furious happy anxious".split()) RESULT_FILL = {"and", "very", "a", "bit", "more", "is", "looks", "feels"} +UNPHOTO = re.compile(r"\b(as if|as though|we (?:see|hear)|there (?:is|are)|seems?|for a long time)\b", re.I) # McKee, Story ch. 23 PLANT_LEVEL = 80 # "climax" cards for PLANT-MISSING; the reader's threshold, warn-only @@ -1010,6 +1010,9 @@ def add(level, card, code, msg): aw = set(re.findall(r"[a-z]+", action.lower())) - {w for m in cast1 for w in _norm("%s %s" % (m.get("id"), p.chars.get(m.get("id"), {}).get("name"))).split()} if sz in ("CU", "ECU") and cast1 and aw and aw <= RESULT_WORDS | RESULT_FILL and aw & RESULT_WORDS: add("warning", card, "RESULT", "a %s whose action is only a result (%s); give the face a verb" % (sz, " ".join(sorted(aw)))) + hit = UNPHOTO.search(action) + if hit: + add("warning", card, "UNPHOTOGRAPHABLE", "'%s' in the action: write what the camera sees or hears (entry screenplay-format)" % hit.group(0)) if _norm(card.get("beat")) and _norm(card.get("beat")) == _norm((prev or {}).get("beat")): add("warning", card, "BEAT-REPEAT", "same beat as %s; cut one or change what it tells (entry logline-and-beats)" % prev["id"]) pcs = (prev or {}).get("cast", []) @@ -1995,9 +1998,8 @@ def agree_stats(pairs): return res -# Machine measures of a take (qc measure). They find technical faults a reviewer misses at contact-sheet -# resolution; they never judge acting, look or story (that is the rubric). Thresholds were set on 2026-10-07 -# against reviewed takes of three local multi-shot films (keepers and rejects). +# qc measure: technical faults a contact sheet misses, never acting, look or story (the rubric). +# Thresholds set 2026-10-07 on reviewed keepers and rejects of three local films. MEASURE_CUT_SCENE = 0.30 # ffmpeg scene score that counts as a cut MEASURE_CUT_EARLY_S = 1.0 # H3 cuts 0.1-0.8 s before the stamped time (24 reviewed takes), so allow early MEASURE_CUT_LATE_S = 0.6 # ... and less late diff --git a/plugins/cinewright-craft/skills/cinewright-sound/scripts/cine.py b/plugins/cinewright-craft/skills/cinewright-sound/scripts/cine.py index 311b9a3..912950f 100644 --- a/plugins/cinewright-craft/skills/cinewright-sound/scripts/cine.py +++ b/plugins/cinewright-craft/skills/cinewright-sound/scripts/cine.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -# copied from shared/lib/cine.py sha256:96258846e375b16ed16ed102cc6ad67a016ce67b2d72915859a483b894fb9bf6; edit the source +# copied from shared/lib/cine.py sha256:f455cd7246ca27533634090c6ff1a7f5cf702a865305e68b40c054b77bfe56f7; edit the source """cinewright runtime CLI: kb, cards, compile, continuity, qc, takes, voice. Run it; do not read it. Python 3.9+, standard library only. @@ -57,8 +57,7 @@ "arc-right": "the camera arcs slowly right around the subject, the background sliding behind", "dolly-zoom": "dolly zoom, the background stretching away while the subject keeps the same size", } -# Camera height and horizon together pin the angle (after Mateu-Mestre, Framed Ink). Out-of-frame values name no -# horizon: every noun gets drawn, so an interior card leaves horizon unset. +# Height and horizon pin the angle (Mateu-Mestre, Framed Ink). Interiors leave horizon unset: every noun gets drawn. HORIZON_WORDS = {"lower-third": "the horizon on the lower third of the frame", "middle": "the horizon across the middle of the frame", "upper-third": "the horizon on the upper third of the frame", "above-frame": "the ground fills the frame to the top edge", "below-frame": "only sky behind, the ground below the frame"} @@ -756,6 +755,7 @@ def graph_lines(rows, flags): RESULT_WORDS = set("angry sad scared smug desperate sexy quirky intense menacing emotional dramatic defensive sarcastic " "hostile cold vicious nervous calm friendly weak upset furious happy anxious".split()) RESULT_FILL = {"and", "very", "a", "bit", "more", "is", "looks", "feels"} +UNPHOTO = re.compile(r"\b(as if|as though|we (?:see|hear)|there (?:is|are)|seems?|for a long time)\b", re.I) # McKee, Story ch. 23 PLANT_LEVEL = 80 # "climax" cards for PLANT-MISSING; the reader's threshold, warn-only @@ -1010,6 +1010,9 @@ def add(level, card, code, msg): aw = set(re.findall(r"[a-z]+", action.lower())) - {w for m in cast1 for w in _norm("%s %s" % (m.get("id"), p.chars.get(m.get("id"), {}).get("name"))).split()} if sz in ("CU", "ECU") and cast1 and aw and aw <= RESULT_WORDS | RESULT_FILL and aw & RESULT_WORDS: add("warning", card, "RESULT", "a %s whose action is only a result (%s); give the face a verb" % (sz, " ".join(sorted(aw)))) + hit = UNPHOTO.search(action) + if hit: + add("warning", card, "UNPHOTOGRAPHABLE", "'%s' in the action: write what the camera sees or hears (entry screenplay-format)" % hit.group(0)) if _norm(card.get("beat")) and _norm(card.get("beat")) == _norm((prev or {}).get("beat")): add("warning", card, "BEAT-REPEAT", "same beat as %s; cut one or change what it tells (entry logline-and-beats)" % prev["id"]) pcs = (prev or {}).get("cast", []) @@ -1995,9 +1998,8 @@ def agree_stats(pairs): return res -# Machine measures of a take (qc measure). They find technical faults a reviewer misses at contact-sheet -# resolution; they never judge acting, look or story (that is the rubric). Thresholds were set on 2026-10-07 -# against reviewed takes of three local multi-shot films (keepers and rejects). +# qc measure: technical faults a contact sheet misses, never acting, look or story (the rubric). +# Thresholds set 2026-10-07 on reviewed keepers and rejects of three local films. MEASURE_CUT_SCENE = 0.30 # ffmpeg scene score that counts as a cut MEASURE_CUT_EARLY_S = 1.0 # H3 cuts 0.1-0.8 s before the stamped time (24 reviewed takes), so allow early MEASURE_CUT_LATE_S = 0.6 # ... and less late diff --git a/plugins/cinewright-craft/skills/cinewright-voice/scripts/cine.py b/plugins/cinewright-craft/skills/cinewright-voice/scripts/cine.py index 311b9a3..912950f 100644 --- a/plugins/cinewright-craft/skills/cinewright-voice/scripts/cine.py +++ b/plugins/cinewright-craft/skills/cinewright-voice/scripts/cine.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -# copied from shared/lib/cine.py sha256:96258846e375b16ed16ed102cc6ad67a016ce67b2d72915859a483b894fb9bf6; edit the source +# copied from shared/lib/cine.py sha256:f455cd7246ca27533634090c6ff1a7f5cf702a865305e68b40c054b77bfe56f7; edit the source """cinewright runtime CLI: kb, cards, compile, continuity, qc, takes, voice. Run it; do not read it. Python 3.9+, standard library only. @@ -57,8 +57,7 @@ "arc-right": "the camera arcs slowly right around the subject, the background sliding behind", "dolly-zoom": "dolly zoom, the background stretching away while the subject keeps the same size", } -# Camera height and horizon together pin the angle (after Mateu-Mestre, Framed Ink). Out-of-frame values name no -# horizon: every noun gets drawn, so an interior card leaves horizon unset. +# Height and horizon pin the angle (Mateu-Mestre, Framed Ink). Interiors leave horizon unset: every noun gets drawn. HORIZON_WORDS = {"lower-third": "the horizon on the lower third of the frame", "middle": "the horizon across the middle of the frame", "upper-third": "the horizon on the upper third of the frame", "above-frame": "the ground fills the frame to the top edge", "below-frame": "only sky behind, the ground below the frame"} @@ -756,6 +755,7 @@ def graph_lines(rows, flags): RESULT_WORDS = set("angry sad scared smug desperate sexy quirky intense menacing emotional dramatic defensive sarcastic " "hostile cold vicious nervous calm friendly weak upset furious happy anxious".split()) RESULT_FILL = {"and", "very", "a", "bit", "more", "is", "looks", "feels"} +UNPHOTO = re.compile(r"\b(as if|as though|we (?:see|hear)|there (?:is|are)|seems?|for a long time)\b", re.I) # McKee, Story ch. 23 PLANT_LEVEL = 80 # "climax" cards for PLANT-MISSING; the reader's threshold, warn-only @@ -1010,6 +1010,9 @@ def add(level, card, code, msg): aw = set(re.findall(r"[a-z]+", action.lower())) - {w for m in cast1 for w in _norm("%s %s" % (m.get("id"), p.chars.get(m.get("id"), {}).get("name"))).split()} if sz in ("CU", "ECU") and cast1 and aw and aw <= RESULT_WORDS | RESULT_FILL and aw & RESULT_WORDS: add("warning", card, "RESULT", "a %s whose action is only a result (%s); give the face a verb" % (sz, " ".join(sorted(aw)))) + hit = UNPHOTO.search(action) + if hit: + add("warning", card, "UNPHOTOGRAPHABLE", "'%s' in the action: write what the camera sees or hears (entry screenplay-format)" % hit.group(0)) if _norm(card.get("beat")) and _norm(card.get("beat")) == _norm((prev or {}).get("beat")): add("warning", card, "BEAT-REPEAT", "same beat as %s; cut one or change what it tells (entry logline-and-beats)" % prev["id"]) pcs = (prev or {}).get("cast", []) @@ -1995,9 +1998,8 @@ def agree_stats(pairs): return res -# Machine measures of a take (qc measure). They find technical faults a reviewer misses at contact-sheet -# resolution; they never judge acting, look or story (that is the rubric). Thresholds were set on 2026-10-07 -# against reviewed takes of three local multi-shot films (keepers and rejects). +# qc measure: technical faults a contact sheet misses, never acting, look or story (the rubric). +# Thresholds set 2026-10-07 on reviewed keepers and rejects of three local films. MEASURE_CUT_SCENE = 0.30 # ffmpeg scene score that counts as a cut MEASURE_CUT_EARLY_S = 1.0 # H3 cuts 0.1-0.8 s before the stamped time (24 reviewed takes), so allow early MEASURE_CUT_LATE_S = 0.6 # ... and less late diff --git a/plugins/cinewright-dev/.claude-plugin/plugin.json b/plugins/cinewright-dev/.claude-plugin/plugin.json index 04693ec..27ceddb 100644 --- a/plugins/cinewright-dev/.claude-plugin/plugin.json +++ b/plugins/cinewright-dev/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "cinewright-dev", - "version": "0.6.22", + "version": "0.6.23", "description": "Maintainer skill for the cinewright knowledge base: cinewright-curate adds, verifies and retires reference entries and refreshes video model cards in a repository checkout. Not needed to make films.", "author": { "name": "Mark Rogers" diff --git a/plugins/cinewright-dev/plugin.json b/plugins/cinewright-dev/plugin.json index 9da920e..caf4261 100644 --- a/plugins/cinewright-dev/plugin.json +++ b/plugins/cinewright-dev/plugin.json @@ -1,7 +1,7 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "cinewright-dev", - "version": "0.6.22", + "version": "0.6.23", "description": "Maintainer skill for the cinewright knowledge base: cinewright-curate adds, verifies and retires reference entries and refreshes video model cards in a repository checkout. Not needed to make films.", "author": { "name": "Mark Rogers" diff --git a/plugins/cinewright/.claude-plugin/plugin.json b/plugins/cinewright/.claude-plugin/plugin.json index bdff299..3922baa 100644 --- a/plugins/cinewright/.claude-plugin/plugin.json +++ b/plugins/cinewright/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "cinewright", - "version": "0.6.22", + "version": "0.6.23", "description": "Plan AI video like a film crew: a director router, a shot-list and coverage planner, a script supervisor that diffs every shot card against character, prop, location and axis bibles, a compiler that turns generator-neutral shot cards into prompts for nine video models, and a take reviewer that routes failures to the cheapest fix.", "author": { "name": "Mark Rogers" diff --git a/plugins/cinewright/plugin.json b/plugins/cinewright/plugin.json index 625b12a..36eef4e 100644 --- a/plugins/cinewright/plugin.json +++ b/plugins/cinewright/plugin.json @@ -1,7 +1,7 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "cinewright", - "version": "0.6.22", + "version": "0.6.23", "description": "Plan AI video like a film crew: a director router, a shot-list and coverage planner, a script supervisor that diffs every shot card against character, prop, location and axis bibles, a compiler that turns generator-neutral shot cards into prompts for nine video models, and a take reviewer that routes failures to the cheapest fix.", "author": { "name": "Mark Rogers" diff --git a/plugins/cinewright/skills/cinewright-analyze/scripts/cine.py b/plugins/cinewright/skills/cinewright-analyze/scripts/cine.py index 311b9a3..912950f 100644 --- a/plugins/cinewright/skills/cinewright-analyze/scripts/cine.py +++ b/plugins/cinewright/skills/cinewright-analyze/scripts/cine.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -# copied from shared/lib/cine.py sha256:96258846e375b16ed16ed102cc6ad67a016ce67b2d72915859a483b894fb9bf6; edit the source +# copied from shared/lib/cine.py sha256:f455cd7246ca27533634090c6ff1a7f5cf702a865305e68b40c054b77bfe56f7; edit the source """cinewright runtime CLI: kb, cards, compile, continuity, qc, takes, voice. Run it; do not read it. Python 3.9+, standard library only. @@ -57,8 +57,7 @@ "arc-right": "the camera arcs slowly right around the subject, the background sliding behind", "dolly-zoom": "dolly zoom, the background stretching away while the subject keeps the same size", } -# Camera height and horizon together pin the angle (after Mateu-Mestre, Framed Ink). Out-of-frame values name no -# horizon: every noun gets drawn, so an interior card leaves horizon unset. +# Height and horizon pin the angle (Mateu-Mestre, Framed Ink). Interiors leave horizon unset: every noun gets drawn. HORIZON_WORDS = {"lower-third": "the horizon on the lower third of the frame", "middle": "the horizon across the middle of the frame", "upper-third": "the horizon on the upper third of the frame", "above-frame": "the ground fills the frame to the top edge", "below-frame": "only sky behind, the ground below the frame"} @@ -756,6 +755,7 @@ def graph_lines(rows, flags): RESULT_WORDS = set("angry sad scared smug desperate sexy quirky intense menacing emotional dramatic defensive sarcastic " "hostile cold vicious nervous calm friendly weak upset furious happy anxious".split()) RESULT_FILL = {"and", "very", "a", "bit", "more", "is", "looks", "feels"} +UNPHOTO = re.compile(r"\b(as if|as though|we (?:see|hear)|there (?:is|are)|seems?|for a long time)\b", re.I) # McKee, Story ch. 23 PLANT_LEVEL = 80 # "climax" cards for PLANT-MISSING; the reader's threshold, warn-only @@ -1010,6 +1010,9 @@ def add(level, card, code, msg): aw = set(re.findall(r"[a-z]+", action.lower())) - {w for m in cast1 for w in _norm("%s %s" % (m.get("id"), p.chars.get(m.get("id"), {}).get("name"))).split()} if sz in ("CU", "ECU") and cast1 and aw and aw <= RESULT_WORDS | RESULT_FILL and aw & RESULT_WORDS: add("warning", card, "RESULT", "a %s whose action is only a result (%s); give the face a verb" % (sz, " ".join(sorted(aw)))) + hit = UNPHOTO.search(action) + if hit: + add("warning", card, "UNPHOTOGRAPHABLE", "'%s' in the action: write what the camera sees or hears (entry screenplay-format)" % hit.group(0)) if _norm(card.get("beat")) and _norm(card.get("beat")) == _norm((prev or {}).get("beat")): add("warning", card, "BEAT-REPEAT", "same beat as %s; cut one or change what it tells (entry logline-and-beats)" % prev["id"]) pcs = (prev or {}).get("cast", []) @@ -1995,9 +1998,8 @@ def agree_stats(pairs): return res -# Machine measures of a take (qc measure). They find technical faults a reviewer misses at contact-sheet -# resolution; they never judge acting, look or story (that is the rubric). Thresholds were set on 2026-10-07 -# against reviewed takes of three local multi-shot films (keepers and rejects). +# qc measure: technical faults a contact sheet misses, never acting, look or story (the rubric). +# Thresholds set 2026-10-07 on reviewed keepers and rejects of three local films. MEASURE_CUT_SCENE = 0.30 # ffmpeg scene score that counts as a cut MEASURE_CUT_EARLY_S = 1.0 # H3 cuts 0.1-0.8 s before the stamped time (24 reviewed takes), so allow early MEASURE_CUT_LATE_S = 0.6 # ... and less late diff --git a/plugins/cinewright/skills/cinewright-continuity/scripts/cine.py b/plugins/cinewright/skills/cinewright-continuity/scripts/cine.py index 311b9a3..912950f 100644 --- a/plugins/cinewright/skills/cinewright-continuity/scripts/cine.py +++ b/plugins/cinewright/skills/cinewright-continuity/scripts/cine.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -# copied from shared/lib/cine.py sha256:96258846e375b16ed16ed102cc6ad67a016ce67b2d72915859a483b894fb9bf6; edit the source +# copied from shared/lib/cine.py sha256:f455cd7246ca27533634090c6ff1a7f5cf702a865305e68b40c054b77bfe56f7; edit the source """cinewright runtime CLI: kb, cards, compile, continuity, qc, takes, voice. Run it; do not read it. Python 3.9+, standard library only. @@ -57,8 +57,7 @@ "arc-right": "the camera arcs slowly right around the subject, the background sliding behind", "dolly-zoom": "dolly zoom, the background stretching away while the subject keeps the same size", } -# Camera height and horizon together pin the angle (after Mateu-Mestre, Framed Ink). Out-of-frame values name no -# horizon: every noun gets drawn, so an interior card leaves horizon unset. +# Height and horizon pin the angle (Mateu-Mestre, Framed Ink). Interiors leave horizon unset: every noun gets drawn. HORIZON_WORDS = {"lower-third": "the horizon on the lower third of the frame", "middle": "the horizon across the middle of the frame", "upper-third": "the horizon on the upper third of the frame", "above-frame": "the ground fills the frame to the top edge", "below-frame": "only sky behind, the ground below the frame"} @@ -756,6 +755,7 @@ def graph_lines(rows, flags): RESULT_WORDS = set("angry sad scared smug desperate sexy quirky intense menacing emotional dramatic defensive sarcastic " "hostile cold vicious nervous calm friendly weak upset furious happy anxious".split()) RESULT_FILL = {"and", "very", "a", "bit", "more", "is", "looks", "feels"} +UNPHOTO = re.compile(r"\b(as if|as though|we (?:see|hear)|there (?:is|are)|seems?|for a long time)\b", re.I) # McKee, Story ch. 23 PLANT_LEVEL = 80 # "climax" cards for PLANT-MISSING; the reader's threshold, warn-only @@ -1010,6 +1010,9 @@ def add(level, card, code, msg): aw = set(re.findall(r"[a-z]+", action.lower())) - {w for m in cast1 for w in _norm("%s %s" % (m.get("id"), p.chars.get(m.get("id"), {}).get("name"))).split()} if sz in ("CU", "ECU") and cast1 and aw and aw <= RESULT_WORDS | RESULT_FILL and aw & RESULT_WORDS: add("warning", card, "RESULT", "a %s whose action is only a result (%s); give the face a verb" % (sz, " ".join(sorted(aw)))) + hit = UNPHOTO.search(action) + if hit: + add("warning", card, "UNPHOTOGRAPHABLE", "'%s' in the action: write what the camera sees or hears (entry screenplay-format)" % hit.group(0)) if _norm(card.get("beat")) and _norm(card.get("beat")) == _norm((prev or {}).get("beat")): add("warning", card, "BEAT-REPEAT", "same beat as %s; cut one or change what it tells (entry logline-and-beats)" % prev["id"]) pcs = (prev or {}).get("cast", []) @@ -1995,9 +1998,8 @@ def agree_stats(pairs): return res -# Machine measures of a take (qc measure). They find technical faults a reviewer misses at contact-sheet -# resolution; they never judge acting, look or story (that is the rubric). Thresholds were set on 2026-10-07 -# against reviewed takes of three local multi-shot films (keepers and rejects). +# qc measure: technical faults a contact sheet misses, never acting, look or story (the rubric). +# Thresholds set 2026-10-07 on reviewed keepers and rejects of three local films. MEASURE_CUT_SCENE = 0.30 # ffmpeg scene score that counts as a cut MEASURE_CUT_EARLY_S = 1.0 # H3 cuts 0.1-0.8 s before the stamped time (24 reviewed takes), so allow early MEASURE_CUT_LATE_S = 0.6 # ... and less late diff --git a/plugins/cinewright/skills/cinewright-genvideo/references/failures-motion.md b/plugins/cinewright/skills/cinewright-genvideo/references/failures-motion.md index eff20f3..3df956f 100644 --- a/plugins/cinewright/skills/cinewright-genvideo/references/failures-motion.md +++ b/plugins/cinewright/skills/cinewright-genvideo/references/failures-motion.md @@ -3,10 +3,10 @@ title: Failure codes, motion, sound and spec slug: failures-motion summary: Failure codes for rendered takes (action, opening, end state, anatomy, flicker, physics, text, dialogue, lip lag, sound, seams, spec, loudness): symptom, cause, cheapest fix, rung, check. tags: [vocab, qc, failures, taxonomy, motion, audio] -last_checked: 2026-10-22 -sources: ["field lessons 005, 011, 014, 015, 020, 021 (maintainer's local renders, 2026-09)", "https://tech.ebu.ch/publications/r128"] +last_checked: 2026-11-19 +sources: ["field lessons 005, 011, 014, 015, 020, 021 (maintainer's local renders, 2026-09)", "https://tech.ebu.ch/publications/r128", "Richard Williams, The Animator's Survival Kit, 2001"] --- - + # Failure codes, motion, sound and spec @@ -18,18 +18,20 @@ Rungs and checks as in `failures-picture`. |---|---|---|---|---|---| | `action-incomplete` | action stops short or plays in slow motion | too much action for the length | one action; longer, or split the card | 2 | action | | `frozen-start` | picture holds still for the first frames | image-to-video eases in | write "already moving"; trim the head | 7 | action | -| `insert-too-fast` | hands or tools flick through an insert or ECU | magnified motion reads as sped up | write "slowly, deliberately" in the insert's action and match that tempo in the wide | 1 | action | +| `insert-too-fast` | hands or tools flick through an insert or ECU | magnified motion reads sped up | "slowly, deliberately" in the insert, same tempo in the wide | 1 | action | | `bad-opening` | wrong opening, the same on every reroll | the seed fixes the opening | new seed; then a guide still at frame 0 | 2 | opening | | `end-state-wrong` | last frame differs from the card | model ran its own course | next card starts from the observed end | 6 | end-state | | `anatomy` | hands, limbs or faces melt or multiply | small, fast or hidden subject | larger, slower, side-on; cut around it | 6 | anatomy | | `flicker` | brightness pulses frame to frame inside one shot | the model's exposure wavers between frames | `deflicker` in the grade; re-render when it stays | 7 | light | | `physics-morph` | objects merge, pass through or slide | contact and weight unstated | name contact and weight; fewer subjects | 1 | physics | -| `air-steps` | a flying figure takes walking steps on the air, as if on a floor | flight mode unstated; body pose left to the model | state the flight pose: legs together and trailing, body leaning into the flight; stepping only for air-walkers | 1 | action | -| `move-no-settle` | the camera is still moving on the last frame, so the cut lands mid-move | no held end on the move | `camera.settle` (held frames at both ends); trim to the hold | 2 | camera | -| `pan-strobe` | the background steps or smears across a fast pan or track | the frame crosses faster than about a third of its width a second | a slower move ("slow pan") or a longer shot; cut the fast part | 1 | camera | +| `air-steps` | a flying figure walks on the air | flight pose unstated | legs together and trailing, body leaning into the flight; steps only for air-walkers | 1 | action | +| `move-no-settle` | still moving on the last frame, so the cut lands mid-move | no held end | `camera.settle` (held frames at both ends); trim to the hold | 2 | camera | +| `pan-strobe` | the background steps or smears across a fast pan or track | crossing faster than a third of the frame a second | "slow pan" or a longer shot; cut the fast part | 1 | camera | | `text-artifact` | subtitles, captions, watermark, garbled signs | quoted dialogue; signs in scene | the card's dialogue syntax; negative terms | 1 | text | | `dialogue-wrong` | line missing, wrong mouth, lips off | two speakers, speaker not in shot, or a speaking reference video (H3 copies its lips) | one speaker per shot, in the cast; else the mix | 1 | audio | -| `lip-lag` | the mouth moves before or after its voice | picture and sound drift apart in the render or the mix | slip the sound by the measured lag when it is steady; re-render when it wanders | 7 | audio | +| `lip-lag` | the mouth moves before or after its voice | picture and sound drift in the render or mix | slip the sound by a steady measured lag; re-render when it wanders | 7 | audio | +| `bilabial-miss` | lips not closed 2 frames on M, B, P (Williams p. 309) | loose lip sync | re-render; cut away on the word | 6 | audio | +| `impact-sync` | hit sound before contact or 2+ frames after (p. 294) | placed by ear | slip to contact + 1 frame | 7 | audio | | `name-misread` | a name said wrong | spelling guessed | `pronounce` respelling | 1 | audio | | `sound-wrong` | silence, music, or the wrong sound | sound left to the model | name ambience and effects | 1 | audio | | `seam-restart` | a cut between renders reads as a restart | separate renders of one scene | `compile --sequence`; one sound across | 6 | seam | diff --git a/plugins/cinewright/skills/cinewright-genvideo/scripts/cine.py b/plugins/cinewright/skills/cinewright-genvideo/scripts/cine.py index 311b9a3..912950f 100644 --- a/plugins/cinewright/skills/cinewright-genvideo/scripts/cine.py +++ b/plugins/cinewright/skills/cinewright-genvideo/scripts/cine.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -# copied from shared/lib/cine.py sha256:96258846e375b16ed16ed102cc6ad67a016ce67b2d72915859a483b894fb9bf6; edit the source +# copied from shared/lib/cine.py sha256:f455cd7246ca27533634090c6ff1a7f5cf702a865305e68b40c054b77bfe56f7; edit the source """cinewright runtime CLI: kb, cards, compile, continuity, qc, takes, voice. Run it; do not read it. Python 3.9+, standard library only. @@ -57,8 +57,7 @@ "arc-right": "the camera arcs slowly right around the subject, the background sliding behind", "dolly-zoom": "dolly zoom, the background stretching away while the subject keeps the same size", } -# Camera height and horizon together pin the angle (after Mateu-Mestre, Framed Ink). Out-of-frame values name no -# horizon: every noun gets drawn, so an interior card leaves horizon unset. +# Height and horizon pin the angle (Mateu-Mestre, Framed Ink). Interiors leave horizon unset: every noun gets drawn. HORIZON_WORDS = {"lower-third": "the horizon on the lower third of the frame", "middle": "the horizon across the middle of the frame", "upper-third": "the horizon on the upper third of the frame", "above-frame": "the ground fills the frame to the top edge", "below-frame": "only sky behind, the ground below the frame"} @@ -756,6 +755,7 @@ def graph_lines(rows, flags): RESULT_WORDS = set("angry sad scared smug desperate sexy quirky intense menacing emotional dramatic defensive sarcastic " "hostile cold vicious nervous calm friendly weak upset furious happy anxious".split()) RESULT_FILL = {"and", "very", "a", "bit", "more", "is", "looks", "feels"} +UNPHOTO = re.compile(r"\b(as if|as though|we (?:see|hear)|there (?:is|are)|seems?|for a long time)\b", re.I) # McKee, Story ch. 23 PLANT_LEVEL = 80 # "climax" cards for PLANT-MISSING; the reader's threshold, warn-only @@ -1010,6 +1010,9 @@ def add(level, card, code, msg): aw = set(re.findall(r"[a-z]+", action.lower())) - {w for m in cast1 for w in _norm("%s %s" % (m.get("id"), p.chars.get(m.get("id"), {}).get("name"))).split()} if sz in ("CU", "ECU") and cast1 and aw and aw <= RESULT_WORDS | RESULT_FILL and aw & RESULT_WORDS: add("warning", card, "RESULT", "a %s whose action is only a result (%s); give the face a verb" % (sz, " ".join(sorted(aw)))) + hit = UNPHOTO.search(action) + if hit: + add("warning", card, "UNPHOTOGRAPHABLE", "'%s' in the action: write what the camera sees or hears (entry screenplay-format)" % hit.group(0)) if _norm(card.get("beat")) and _norm(card.get("beat")) == _norm((prev or {}).get("beat")): add("warning", card, "BEAT-REPEAT", "same beat as %s; cut one or change what it tells (entry logline-and-beats)" % prev["id"]) pcs = (prev or {}).get("cast", []) @@ -1995,9 +1998,8 @@ def agree_stats(pairs): return res -# Machine measures of a take (qc measure). They find technical faults a reviewer misses at contact-sheet -# resolution; they never judge acting, look or story (that is the rubric). Thresholds were set on 2026-10-07 -# against reviewed takes of three local multi-shot films (keepers and rejects). +# qc measure: technical faults a contact sheet misses, never acting, look or story (the rubric). +# Thresholds set 2026-10-07 on reviewed keepers and rejects of three local films. MEASURE_CUT_SCENE = 0.30 # ffmpeg scene score that counts as a cut MEASURE_CUT_EARLY_S = 1.0 # H3 cuts 0.1-0.8 s before the stamped time (24 reviewed takes), so allow early MEASURE_CUT_LATE_S = 0.6 # ... and less late diff --git a/plugins/cinewright/skills/cinewright-qc/CHANGELOG.md b/plugins/cinewright/skills/cinewright-qc/CHANGELOG.md index ee3f625..374f264 100644 --- a/plugins/cinewright/skills/cinewright-qc/CHANGELOG.md +++ b/plugins/cinewright/skills/cinewright-qc/CHANGELOG.md @@ -6,6 +6,10 @@ Entry shape: `### C-20261110-1 · 2026-11-10 · failures-framing: re-camera a ke - because: technique harvest GPU test 2026-11-10 (CrossView-Warp on MiniMax H3 REF2VA: az 20 measured 19/19/12 deg with the face held; az 40 short; 4-step turbo copied the source) - files: vocab failures-framing Rules (one line) +### C-20261119-2 · 2026-11-19 · Williams lip and impact codes, McKee look item (0.6.23) +- because: book distillation round 6 (Williams, Animator's Survival Kit pp. 86, 294, 309; McKee, Story ch. 14) +- files: vocab failures-motion (bilabial-miss, impact-sync; rows tightened to stay under the entry budget), references/look-pass.md (pretty-no-turn, no-turn-blink, both warn) + ### C-20261119-1 · 2026-11-19 · qc seam: join and framing checks for chained segments (0.6.22) - because: R-20261119-1 - files: scripts/cine_seam.py (new, not a shared/lib copy: the runtime budget has under 5 KB left), SKILL.md Step 1 (one item), evals action-3, tests TestSeam diff --git a/plugins/cinewright/skills/cinewright-qc/references/failures-motion.md b/plugins/cinewright/skills/cinewright-qc/references/failures-motion.md index eff20f3..3df956f 100644 --- a/plugins/cinewright/skills/cinewright-qc/references/failures-motion.md +++ b/plugins/cinewright/skills/cinewright-qc/references/failures-motion.md @@ -3,10 +3,10 @@ title: Failure codes, motion, sound and spec slug: failures-motion summary: Failure codes for rendered takes (action, opening, end state, anatomy, flicker, physics, text, dialogue, lip lag, sound, seams, spec, loudness): symptom, cause, cheapest fix, rung, check. tags: [vocab, qc, failures, taxonomy, motion, audio] -last_checked: 2026-10-22 -sources: ["field lessons 005, 011, 014, 015, 020, 021 (maintainer's local renders, 2026-09)", "https://tech.ebu.ch/publications/r128"] +last_checked: 2026-11-19 +sources: ["field lessons 005, 011, 014, 015, 020, 021 (maintainer's local renders, 2026-09)", "https://tech.ebu.ch/publications/r128", "Richard Williams, The Animator's Survival Kit, 2001"] --- - + # Failure codes, motion, sound and spec @@ -18,18 +18,20 @@ Rungs and checks as in `failures-picture`. |---|---|---|---|---|---| | `action-incomplete` | action stops short or plays in slow motion | too much action for the length | one action; longer, or split the card | 2 | action | | `frozen-start` | picture holds still for the first frames | image-to-video eases in | write "already moving"; trim the head | 7 | action | -| `insert-too-fast` | hands or tools flick through an insert or ECU | magnified motion reads as sped up | write "slowly, deliberately" in the insert's action and match that tempo in the wide | 1 | action | +| `insert-too-fast` | hands or tools flick through an insert or ECU | magnified motion reads sped up | "slowly, deliberately" in the insert, same tempo in the wide | 1 | action | | `bad-opening` | wrong opening, the same on every reroll | the seed fixes the opening | new seed; then a guide still at frame 0 | 2 | opening | | `end-state-wrong` | last frame differs from the card | model ran its own course | next card starts from the observed end | 6 | end-state | | `anatomy` | hands, limbs or faces melt or multiply | small, fast or hidden subject | larger, slower, side-on; cut around it | 6 | anatomy | | `flicker` | brightness pulses frame to frame inside one shot | the model's exposure wavers between frames | `deflicker` in the grade; re-render when it stays | 7 | light | | `physics-morph` | objects merge, pass through or slide | contact and weight unstated | name contact and weight; fewer subjects | 1 | physics | -| `air-steps` | a flying figure takes walking steps on the air, as if on a floor | flight mode unstated; body pose left to the model | state the flight pose: legs together and trailing, body leaning into the flight; stepping only for air-walkers | 1 | action | -| `move-no-settle` | the camera is still moving on the last frame, so the cut lands mid-move | no held end on the move | `camera.settle` (held frames at both ends); trim to the hold | 2 | camera | -| `pan-strobe` | the background steps or smears across a fast pan or track | the frame crosses faster than about a third of its width a second | a slower move ("slow pan") or a longer shot; cut the fast part | 1 | camera | +| `air-steps` | a flying figure walks on the air | flight pose unstated | legs together and trailing, body leaning into the flight; steps only for air-walkers | 1 | action | +| `move-no-settle` | still moving on the last frame, so the cut lands mid-move | no held end | `camera.settle` (held frames at both ends); trim to the hold | 2 | camera | +| `pan-strobe` | the background steps or smears across a fast pan or track | crossing faster than a third of the frame a second | "slow pan" or a longer shot; cut the fast part | 1 | camera | | `text-artifact` | subtitles, captions, watermark, garbled signs | quoted dialogue; signs in scene | the card's dialogue syntax; negative terms | 1 | text | | `dialogue-wrong` | line missing, wrong mouth, lips off | two speakers, speaker not in shot, or a speaking reference video (H3 copies its lips) | one speaker per shot, in the cast; else the mix | 1 | audio | -| `lip-lag` | the mouth moves before or after its voice | picture and sound drift apart in the render or the mix | slip the sound by the measured lag when it is steady; re-render when it wanders | 7 | audio | +| `lip-lag` | the mouth moves before or after its voice | picture and sound drift in the render or mix | slip the sound by a steady measured lag; re-render when it wanders | 7 | audio | +| `bilabial-miss` | lips not closed 2 frames on M, B, P (Williams p. 309) | loose lip sync | re-render; cut away on the word | 6 | audio | +| `impact-sync` | hit sound before contact or 2+ frames after (p. 294) | placed by ear | slip to contact + 1 frame | 7 | audio | | `name-misread` | a name said wrong | spelling guessed | `pronounce` respelling | 1 | audio | | `sound-wrong` | silence, music, or the wrong sound | sound left to the model | name ambience and effects | 1 | audio | | `seam-restart` | a cut between renders reads as a restart | separate renders of one scene | `compile --sequence`; one sound across | 6 | seam | diff --git a/plugins/cinewright/skills/cinewright-qc/references/look-pass.md b/plugins/cinewright/skills/cinewright-qc/references/look-pass.md index 525b643..c21e3fc 100644 --- a/plugins/cinewright/skills/cinewright-qc/references/look-pass.md +++ b/plugins/cinewright/skills/cinewright-qc/references/look-pass.md @@ -3,8 +3,8 @@ title: Look pass slug: look-pass summary: The review pass for light and visual structure: upstage key, source in frame, backlit atmosphere, subject brightest, space, line, settled moves, pan speed, attention at cuts. tags: [qc, review, light, space, attention, visual-structure] -last_checked: 2026-10-22 -sources: ["Blain Brown, Cinematography: Theory and Practice, 3rd ed., 2016", "Bruce Block, The Visual Story, 3rd ed., 2021"] +last_checked: 2026-11-19 +sources: ["Blain Brown, Cinematography: Theory and Practice, 3rd ed., 2016", "Bruce Block, The Visual Story, 3rd ed., 2021", "Robert McKee, Story, 1997", "Richard Williams, The Animator's Survival Kit, 2001"] --- # Look pass @@ -20,6 +20,8 @@ sources: ["Blain Brown, Cinematography: Theory and Practice, 3rd ed., 2016", "Br - Does the dominant line match the card's `line`? Squint at a small, blurred copy: lines exist only where tones meet. - Does a moving camera ease in and settle before the last frame? (`move-no-settle`, camera) - Does a pan or track take at least about 3 s for a thing to cross the frame, with no stepping background? (`pan-strobe`, camera) +- Does the card's value change between the first and last frame? A pretty take with no change goes back to cinewright-script, not to a reroll (`pretty-no-turn`, warn; McKee ch. 14). +- Does a calm head turn to a new focus blink on the turn? Eyes held open read as staring (`no-turn-blink`, warn; Williams p. 86). - At each cut, is the eye where the cards' `attention` cells plan it? (`attention-jump`, attention; the rubric asks it when the card sets `attention`) - Across the cut film: `CINE_POST grade measure SHOTS --plan ` (cinewright-edit, cinewright-finish) ranks contrast, saturation, warmth, diagonal edges and motion against the plan. - For a still's light logic (two value families, shadow colour, rims), artwright's craft rows say the same in more detail; use them when artwright is installed. diff --git a/plugins/cinewright/skills/cinewright-qc/scripts/cine.py b/plugins/cinewright/skills/cinewright-qc/scripts/cine.py index 311b9a3..912950f 100644 --- a/plugins/cinewright/skills/cinewright-qc/scripts/cine.py +++ b/plugins/cinewright/skills/cinewright-qc/scripts/cine.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -# copied from shared/lib/cine.py sha256:96258846e375b16ed16ed102cc6ad67a016ce67b2d72915859a483b894fb9bf6; edit the source +# copied from shared/lib/cine.py sha256:f455cd7246ca27533634090c6ff1a7f5cf702a865305e68b40c054b77bfe56f7; edit the source """cinewright runtime CLI: kb, cards, compile, continuity, qc, takes, voice. Run it; do not read it. Python 3.9+, standard library only. @@ -57,8 +57,7 @@ "arc-right": "the camera arcs slowly right around the subject, the background sliding behind", "dolly-zoom": "dolly zoom, the background stretching away while the subject keeps the same size", } -# Camera height and horizon together pin the angle (after Mateu-Mestre, Framed Ink). Out-of-frame values name no -# horizon: every noun gets drawn, so an interior card leaves horizon unset. +# Height and horizon pin the angle (Mateu-Mestre, Framed Ink). Interiors leave horizon unset: every noun gets drawn. HORIZON_WORDS = {"lower-third": "the horizon on the lower third of the frame", "middle": "the horizon across the middle of the frame", "upper-third": "the horizon on the upper third of the frame", "above-frame": "the ground fills the frame to the top edge", "below-frame": "only sky behind, the ground below the frame"} @@ -756,6 +755,7 @@ def graph_lines(rows, flags): RESULT_WORDS = set("angry sad scared smug desperate sexy quirky intense menacing emotional dramatic defensive sarcastic " "hostile cold vicious nervous calm friendly weak upset furious happy anxious".split()) RESULT_FILL = {"and", "very", "a", "bit", "more", "is", "looks", "feels"} +UNPHOTO = re.compile(r"\b(as if|as though|we (?:see|hear)|there (?:is|are)|seems?|for a long time)\b", re.I) # McKee, Story ch. 23 PLANT_LEVEL = 80 # "climax" cards for PLANT-MISSING; the reader's threshold, warn-only @@ -1010,6 +1010,9 @@ def add(level, card, code, msg): aw = set(re.findall(r"[a-z]+", action.lower())) - {w for m in cast1 for w in _norm("%s %s" % (m.get("id"), p.chars.get(m.get("id"), {}).get("name"))).split()} if sz in ("CU", "ECU") and cast1 and aw and aw <= RESULT_WORDS | RESULT_FILL and aw & RESULT_WORDS: add("warning", card, "RESULT", "a %s whose action is only a result (%s); give the face a verb" % (sz, " ".join(sorted(aw)))) + hit = UNPHOTO.search(action) + if hit: + add("warning", card, "UNPHOTOGRAPHABLE", "'%s' in the action: write what the camera sees or hears (entry screenplay-format)" % hit.group(0)) if _norm(card.get("beat")) and _norm(card.get("beat")) == _norm((prev or {}).get("beat")): add("warning", card, "BEAT-REPEAT", "same beat as %s; cut one or change what it tells (entry logline-and-beats)" % prev["id"]) pcs = (prev or {}).get("cast", []) @@ -1995,9 +1998,8 @@ def agree_stats(pairs): return res -# Machine measures of a take (qc measure). They find technical faults a reviewer misses at contact-sheet -# resolution; they never judge acting, look or story (that is the rubric). Thresholds were set on 2026-10-07 -# against reviewed takes of three local multi-shot films (keepers and rejects). +# qc measure: technical faults a contact sheet misses, never acting, look or story (the rubric). +# Thresholds set 2026-10-07 on reviewed keepers and rejects of three local films. MEASURE_CUT_SCENE = 0.30 # ffmpeg scene score that counts as a cut MEASURE_CUT_EARLY_S = 1.0 # H3 cuts 0.1-0.8 s before the stamped time (24 reviewed takes), so allow early MEASURE_CUT_LATE_S = 0.6 # ... and less late diff --git a/plugins/cinewright/skills/cinewright-shots/scripts/cine.py b/plugins/cinewright/skills/cinewright-shots/scripts/cine.py index 311b9a3..912950f 100644 --- a/plugins/cinewright/skills/cinewright-shots/scripts/cine.py +++ b/plugins/cinewright/skills/cinewright-shots/scripts/cine.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -# copied from shared/lib/cine.py sha256:96258846e375b16ed16ed102cc6ad67a016ce67b2d72915859a483b894fb9bf6; edit the source +# copied from shared/lib/cine.py sha256:f455cd7246ca27533634090c6ff1a7f5cf702a865305e68b40c054b77bfe56f7; edit the source """cinewright runtime CLI: kb, cards, compile, continuity, qc, takes, voice. Run it; do not read it. Python 3.9+, standard library only. @@ -57,8 +57,7 @@ "arc-right": "the camera arcs slowly right around the subject, the background sliding behind", "dolly-zoom": "dolly zoom, the background stretching away while the subject keeps the same size", } -# Camera height and horizon together pin the angle (after Mateu-Mestre, Framed Ink). Out-of-frame values name no -# horizon: every noun gets drawn, so an interior card leaves horizon unset. +# Height and horizon pin the angle (Mateu-Mestre, Framed Ink). Interiors leave horizon unset: every noun gets drawn. HORIZON_WORDS = {"lower-third": "the horizon on the lower third of the frame", "middle": "the horizon across the middle of the frame", "upper-third": "the horizon on the upper third of the frame", "above-frame": "the ground fills the frame to the top edge", "below-frame": "only sky behind, the ground below the frame"} @@ -756,6 +755,7 @@ def graph_lines(rows, flags): RESULT_WORDS = set("angry sad scared smug desperate sexy quirky intense menacing emotional dramatic defensive sarcastic " "hostile cold vicious nervous calm friendly weak upset furious happy anxious".split()) RESULT_FILL = {"and", "very", "a", "bit", "more", "is", "looks", "feels"} +UNPHOTO = re.compile(r"\b(as if|as though|we (?:see|hear)|there (?:is|are)|seems?|for a long time)\b", re.I) # McKee, Story ch. 23 PLANT_LEVEL = 80 # "climax" cards for PLANT-MISSING; the reader's threshold, warn-only @@ -1010,6 +1010,9 @@ def add(level, card, code, msg): aw = set(re.findall(r"[a-z]+", action.lower())) - {w for m in cast1 for w in _norm("%s %s" % (m.get("id"), p.chars.get(m.get("id"), {}).get("name"))).split()} if sz in ("CU", "ECU") and cast1 and aw and aw <= RESULT_WORDS | RESULT_FILL and aw & RESULT_WORDS: add("warning", card, "RESULT", "a %s whose action is only a result (%s); give the face a verb" % (sz, " ".join(sorted(aw)))) + hit = UNPHOTO.search(action) + if hit: + add("warning", card, "UNPHOTOGRAPHABLE", "'%s' in the action: write what the camera sees or hears (entry screenplay-format)" % hit.group(0)) if _norm(card.get("beat")) and _norm(card.get("beat")) == _norm((prev or {}).get("beat")): add("warning", card, "BEAT-REPEAT", "same beat as %s; cut one or change what it tells (entry logline-and-beats)" % prev["id"]) pcs = (prev or {}).get("cast", []) @@ -1995,9 +1998,8 @@ def agree_stats(pairs): return res -# Machine measures of a take (qc measure). They find technical faults a reviewer misses at contact-sheet -# resolution; they never judge acting, look or story (that is the rubric). Thresholds were set on 2026-10-07 -# against reviewed takes of three local multi-shot films (keepers and rejects). +# qc measure: technical faults a contact sheet misses, never acting, look or story (the rubric). +# Thresholds set 2026-10-07 on reviewed keepers and rejects of three local films. MEASURE_CUT_SCENE = 0.30 # ffmpeg scene score that counts as a cut MEASURE_CUT_EARLY_S = 1.0 # H3 cuts 0.1-0.8 s before the stamped time (24 reviewed takes), so allow early MEASURE_CUT_LATE_S = 0.6 # ... and less late diff --git a/plugins/cinewright/skills/cinewright/scripts/cine.py b/plugins/cinewright/skills/cinewright/scripts/cine.py index 311b9a3..912950f 100644 --- a/plugins/cinewright/skills/cinewright/scripts/cine.py +++ b/plugins/cinewright/skills/cinewright/scripts/cine.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -# copied from shared/lib/cine.py sha256:96258846e375b16ed16ed102cc6ad67a016ce67b2d72915859a483b894fb9bf6; edit the source +# copied from shared/lib/cine.py sha256:f455cd7246ca27533634090c6ff1a7f5cf702a865305e68b40c054b77bfe56f7; edit the source """cinewright runtime CLI: kb, cards, compile, continuity, qc, takes, voice. Run it; do not read it. Python 3.9+, standard library only. @@ -57,8 +57,7 @@ "arc-right": "the camera arcs slowly right around the subject, the background sliding behind", "dolly-zoom": "dolly zoom, the background stretching away while the subject keeps the same size", } -# Camera height and horizon together pin the angle (after Mateu-Mestre, Framed Ink). Out-of-frame values name no -# horizon: every noun gets drawn, so an interior card leaves horizon unset. +# Height and horizon pin the angle (Mateu-Mestre, Framed Ink). Interiors leave horizon unset: every noun gets drawn. HORIZON_WORDS = {"lower-third": "the horizon on the lower third of the frame", "middle": "the horizon across the middle of the frame", "upper-third": "the horizon on the upper third of the frame", "above-frame": "the ground fills the frame to the top edge", "below-frame": "only sky behind, the ground below the frame"} @@ -756,6 +755,7 @@ def graph_lines(rows, flags): RESULT_WORDS = set("angry sad scared smug desperate sexy quirky intense menacing emotional dramatic defensive sarcastic " "hostile cold vicious nervous calm friendly weak upset furious happy anxious".split()) RESULT_FILL = {"and", "very", "a", "bit", "more", "is", "looks", "feels"} +UNPHOTO = re.compile(r"\b(as if|as though|we (?:see|hear)|there (?:is|are)|seems?|for a long time)\b", re.I) # McKee, Story ch. 23 PLANT_LEVEL = 80 # "climax" cards for PLANT-MISSING; the reader's threshold, warn-only @@ -1010,6 +1010,9 @@ def add(level, card, code, msg): aw = set(re.findall(r"[a-z]+", action.lower())) - {w for m in cast1 for w in _norm("%s %s" % (m.get("id"), p.chars.get(m.get("id"), {}).get("name"))).split()} if sz in ("CU", "ECU") and cast1 and aw and aw <= RESULT_WORDS | RESULT_FILL and aw & RESULT_WORDS: add("warning", card, "RESULT", "a %s whose action is only a result (%s); give the face a verb" % (sz, " ".join(sorted(aw)))) + hit = UNPHOTO.search(action) + if hit: + add("warning", card, "UNPHOTOGRAPHABLE", "'%s' in the action: write what the camera sees or hears (entry screenplay-format)" % hit.group(0)) if _norm(card.get("beat")) and _norm(card.get("beat")) == _norm((prev or {}).get("beat")): add("warning", card, "BEAT-REPEAT", "same beat as %s; cut one or change what it tells (entry logline-and-beats)" % prev["id"]) pcs = (prev or {}).get("cast", []) @@ -1995,9 +1998,8 @@ def agree_stats(pairs): return res -# Machine measures of a take (qc measure). They find technical faults a reviewer misses at contact-sheet -# resolution; they never judge acting, look or story (that is the rubric). Thresholds were set on 2026-10-07 -# against reviewed takes of three local multi-shot films (keepers and rejects). +# qc measure: technical faults a contact sheet misses, never acting, look or story (the rubric). +# Thresholds set 2026-10-07 on reviewed keepers and rejects of three local films. MEASURE_CUT_SCENE = 0.30 # ffmpeg scene score that counts as a cut MEASURE_CUT_EARLY_S = 1.0 # H3 cuts 0.1-0.8 s before the stamped time (24 reviewed takes), so allow early MEASURE_CUT_LATE_S = 0.6 # ... and less late diff --git a/shared/lib/cine.py b/shared/lib/cine.py index cdf46f3..3ab0f84 100644 --- a/shared/lib/cine.py +++ b/shared/lib/cine.py @@ -56,8 +56,7 @@ "arc-right": "the camera arcs slowly right around the subject, the background sliding behind", "dolly-zoom": "dolly zoom, the background stretching away while the subject keeps the same size", } -# Camera height and horizon together pin the angle (after Mateu-Mestre, Framed Ink). Out-of-frame values name no -# horizon: every noun gets drawn, so an interior card leaves horizon unset. +# Height and horizon pin the angle (Mateu-Mestre, Framed Ink). Interiors leave horizon unset: every noun gets drawn. HORIZON_WORDS = {"lower-third": "the horizon on the lower third of the frame", "middle": "the horizon across the middle of the frame", "upper-third": "the horizon on the upper third of the frame", "above-frame": "the ground fills the frame to the top edge", "below-frame": "only sky behind, the ground below the frame"} @@ -755,6 +754,7 @@ def graph_lines(rows, flags): RESULT_WORDS = set("angry sad scared smug desperate sexy quirky intense menacing emotional dramatic defensive sarcastic " "hostile cold vicious nervous calm friendly weak upset furious happy anxious".split()) RESULT_FILL = {"and", "very", "a", "bit", "more", "is", "looks", "feels"} +UNPHOTO = re.compile(r"\b(as if|as though|we (?:see|hear)|there (?:is|are)|seems?|for a long time)\b", re.I) # McKee, Story ch. 23 PLANT_LEVEL = 80 # "climax" cards for PLANT-MISSING; the reader's threshold, warn-only @@ -1009,6 +1009,9 @@ def add(level, card, code, msg): aw = set(re.findall(r"[a-z]+", action.lower())) - {w for m in cast1 for w in _norm("%s %s" % (m.get("id"), p.chars.get(m.get("id"), {}).get("name"))).split()} if sz in ("CU", "ECU") and cast1 and aw and aw <= RESULT_WORDS | RESULT_FILL and aw & RESULT_WORDS: add("warning", card, "RESULT", "a %s whose action is only a result (%s); give the face a verb" % (sz, " ".join(sorted(aw)))) + hit = UNPHOTO.search(action) + if hit: + add("warning", card, "UNPHOTOGRAPHABLE", "'%s' in the action: write what the camera sees or hears (entry screenplay-format)" % hit.group(0)) if _norm(card.get("beat")) and _norm(card.get("beat")) == _norm((prev or {}).get("beat")): add("warning", card, "BEAT-REPEAT", "same beat as %s; cut one or change what it tells (entry logline-and-beats)" % prev["id"]) pcs = (prev or {}).get("cast", []) @@ -1994,9 +1997,8 @@ def agree_stats(pairs): return res -# Machine measures of a take (qc measure). They find technical faults a reviewer misses at contact-sheet -# resolution; they never judge acting, look or story (that is the rubric). Thresholds were set on 2026-10-07 -# against reviewed takes of three local multi-shot films (keepers and rejects). +# qc measure: technical faults a contact sheet misses, never acting, look or story (the rubric). +# Thresholds set 2026-10-07 on reviewed keepers and rejects of three local films. MEASURE_CUT_SCENE = 0.30 # ffmpeg scene score that counts as a cut MEASURE_CUT_EARLY_S = 1.0 # H3 cuts 0.1-0.8 s before the stamped time (24 reviewed takes), so allow early MEASURE_CUT_LATE_S = 0.6 # ... and less late diff --git a/shared/vocab/failures-motion.md b/shared/vocab/failures-motion.md index cdb4a5c..9406843 100644 --- a/shared/vocab/failures-motion.md +++ b/shared/vocab/failures-motion.md @@ -3,8 +3,8 @@ title: Failure codes, motion, sound and spec slug: failures-motion summary: Failure codes for rendered takes (action, opening, end state, anatomy, flicker, physics, text, dialogue, lip lag, sound, seams, spec, loudness): symptom, cause, cheapest fix, rung, check. tags: [vocab, qc, failures, taxonomy, motion, audio] -last_checked: 2026-10-22 -sources: ["field lessons 005, 011, 014, 015, 020, 021 (maintainer's local renders, 2026-09)", "https://tech.ebu.ch/publications/r128"] +last_checked: 2026-11-19 +sources: ["field lessons 005, 011, 014, 015, 020, 021 (maintainer's local renders, 2026-09)", "https://tech.ebu.ch/publications/r128", "Richard Williams, The Animator's Survival Kit, 2001"] --- # Failure codes, motion, sound and spec @@ -17,18 +17,20 @@ Rungs and checks as in `failures-picture`. |---|---|---|---|---|---| | `action-incomplete` | action stops short or plays in slow motion | too much action for the length | one action; longer, or split the card | 2 | action | | `frozen-start` | picture holds still for the first frames | image-to-video eases in | write "already moving"; trim the head | 7 | action | -| `insert-too-fast` | hands or tools flick through an insert or ECU | magnified motion reads as sped up | write "slowly, deliberately" in the insert's action and match that tempo in the wide | 1 | action | +| `insert-too-fast` | hands or tools flick through an insert or ECU | magnified motion reads sped up | "slowly, deliberately" in the insert, same tempo in the wide | 1 | action | | `bad-opening` | wrong opening, the same on every reroll | the seed fixes the opening | new seed; then a guide still at frame 0 | 2 | opening | | `end-state-wrong` | last frame differs from the card | model ran its own course | next card starts from the observed end | 6 | end-state | | `anatomy` | hands, limbs or faces melt or multiply | small, fast or hidden subject | larger, slower, side-on; cut around it | 6 | anatomy | | `flicker` | brightness pulses frame to frame inside one shot | the model's exposure wavers between frames | `deflicker` in the grade; re-render when it stays | 7 | light | | `physics-morph` | objects merge, pass through or slide | contact and weight unstated | name contact and weight; fewer subjects | 1 | physics | -| `air-steps` | a flying figure takes walking steps on the air, as if on a floor | flight mode unstated; body pose left to the model | state the flight pose: legs together and trailing, body leaning into the flight; stepping only for air-walkers | 1 | action | -| `move-no-settle` | the camera is still moving on the last frame, so the cut lands mid-move | no held end on the move | `camera.settle` (held frames at both ends); trim to the hold | 2 | camera | -| `pan-strobe` | the background steps or smears across a fast pan or track | the frame crosses faster than about a third of its width a second | a slower move ("slow pan") or a longer shot; cut the fast part | 1 | camera | +| `air-steps` | a flying figure walks on the air | flight pose unstated | legs together and trailing, body leaning into the flight; steps only for air-walkers | 1 | action | +| `move-no-settle` | still moving on the last frame, so the cut lands mid-move | no held end | `camera.settle` (held frames at both ends); trim to the hold | 2 | camera | +| `pan-strobe` | the background steps or smears across a fast pan or track | crossing faster than a third of the frame a second | "slow pan" or a longer shot; cut the fast part | 1 | camera | | `text-artifact` | subtitles, captions, watermark, garbled signs | quoted dialogue; signs in scene | the card's dialogue syntax; negative terms | 1 | text | | `dialogue-wrong` | line missing, wrong mouth, lips off | two speakers, speaker not in shot, or a speaking reference video (H3 copies its lips) | one speaker per shot, in the cast; else the mix | 1 | audio | -| `lip-lag` | the mouth moves before or after its voice | picture and sound drift apart in the render or the mix | slip the sound by the measured lag when it is steady; re-render when it wanders | 7 | audio | +| `lip-lag` | the mouth moves before or after its voice | picture and sound drift in the render or mix | slip the sound by a steady measured lag; re-render when it wanders | 7 | audio | +| `bilabial-miss` | lips not closed 2 frames on M, B, P (Williams p. 309) | loose lip sync | re-render; cut away on the word | 6 | audio | +| `impact-sync` | hit sound before contact or 2+ frames after (p. 294) | placed by ear | slip to contact + 1 frame | 7 | audio | | `name-misread` | a name said wrong | spelling guessed | `pronounce` respelling | 1 | audio | | `sound-wrong` | silence, music, or the wrong sound | sound left to the model | name ambience and effects | 1 | audio | | `seam-restart` | a cut between renders reads as a restart | separate renders of one scene | `compile --sequence`; one sound across | 6 | seam | diff --git a/tests/test_cine.py b/tests/test_cine.py index a98e9b4..20c8251 100644 --- a/tests/test_cine.py +++ b/tests/test_cine.py @@ -736,6 +736,15 @@ def test_setup_result_group_order(self): b["screen_order"] = ["y", "z", "x"] self.assertIn((b["id"], "GROUP-ORDER"), self.warns(p)) + def test_unphotographable_action(self): + p = self.project() + self.assertNotIn("UNPHOTOGRAPHABLE", {c for _, c in self.warns(p)}, "old cards stay quiet") + b = p.cards[1] + b["action"] = "she waits as if she has waited for a long time" + self.assertIn((b["id"], "UNPHOTOGRAPHABLE"), self.warns(p)) + b["action"] = "she stubs out her tenth cigarette" + self.assertNotIn((b["id"], "UNPHOTOGRAPHABLE"), self.warns(p)) + def test_track26_scene_and_card_codes(self): p = self.project() new = {"BEAT-REPEAT", "PLANT-MISSING", "INTRO", "REESTABLISH", "REVERSE-SCALE", "SINGLES-ONLY", "PAN-BETWEEN", "EXIT-HOLD", "TRIM", "NO-HOOK"}