analyze-reference-grammar

Purpose

Ingest a video file and measure its editorial DNA: every cut point, the pacing curve (cuts per 10-second window), the audio mode (music-only / vo+music / speech-only), an optional word-level transcript, and the beat grid when music is present. The final output is a grammar-profile.json that characterises the video against the eight creator-grammar archetypes (see CREATOR_GRAMMAR.md §8 and generate-edit-decision-list/references/archetypes.json) and identifies the best-fit archetype with a confidence score.

Two primary use cases:

Reference teardown — drop a winning competitor or reference video in; get back a structured profile you can hand to generate-edit-decision-list to replicate its pacing.
Conform-mode input — re-edit an existing video to this grammar by feeding grammar-profile.json into generate-edit-decision-list (conform source mode).

Inputs

Field	Required	Notes
`source`	yes	Path to a video file (mp4, mov, webm, m4v).
`output_dir`	yes	Directory where all outputs are written. Created if absent.
`--no-transcribe`	no	Skip Whisper transcription (default: transcription is on). Pass this flag for speed when transcript is not needed.