Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -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"
}
]
}
1 change: 1 addition & 0 deletions ai-docs/log.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
2 changes: 1 addition & 1 deletion plugins/cinewright-craft/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -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"
Expand Down
2 changes: 1 addition & 1 deletion plugins/cinewright-craft/plugin.json
Original file line number Diff line number Diff line change
@@ -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"
Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand Down Expand Up @@ -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"}
Expand Down Expand Up @@ -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


Expand Down Expand Up @@ -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", [])
Expand Down Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand Down Expand Up @@ -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"}
Expand Down Expand Up @@ -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


Expand Down Expand Up @@ -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", [])
Expand Down Expand Up @@ -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
Expand Down
14 changes: 8 additions & 6 deletions plugins/cinewright-craft/skills/cinewright-edit/scripts/cine.py
Original file line number Diff line number Diff line change
@@ -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.
Expand Down Expand Up @@ -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"}
Expand Down Expand Up @@ -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


Expand Down Expand Up @@ -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", [])
Expand Down Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand Down Expand Up @@ -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"}
Expand Down Expand Up @@ -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


Expand Down Expand Up @@ -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", [])
Expand Down Expand Up @@ -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
Expand Down
Loading
Loading