Id of the flat IAutoMovieScript.beats entry this node refines.
How this shot should read, for the human reviewer and the diffusion pass,
or null for no caption. planCaptionSidecar exports it through
beatCaptions, and renderScreenplay prints it as a [Shot: ...] line.
Spoken lines in order, possibly empty.
Stage direction: what happens, in non-empty prose. renderScreenplay
prints it under the beat heading.
The script tree's authored beat leaf holds direction, dialogue and caption and joins the flat beat list one to one by beat id. performShot defaults compiled identity to shot: plus that beat, while an explicit caller shotId may differ.
validateScriptTreerefuses abeatthat names no script beat or one another beat node already claims, a dialogue anchor that is negative or not finite, and, when a tree is present, a script beat no beat node refines. Project validation also requires a non-emptydirectionand, when present, a non-blankcaption.