XIL-PARSE(1)

NAME
xil-parse

SYNOPSIS
xil-parse [-h] [--episode EPISODE | --tag TAG] [--show SHOW] [--output OUTPUT] [--preview PREVIEW] [--quiet] [--debug] [--stats] [--speakers SPEAKERS] script

DESCRIPTION
Parse production script markdown into structured JSON

script
    Path to the production script markdown file

OPTIONS

--episode EPISODE
    Episode tag (e.g. S01E01) — validates header and auto-generates absent cast/sfx configs

--tag TAG
    Raw tag for non-episodic content (e.g. V01C03, D01, CH003) — skips season/episode header validation

--show SHOW
    Show name override (default: from project.json)

--output OUTPUT, -o OUTPUT
    Output JSON path (default: parsed/parsed_<slug>_<TAG>.json)

--preview PREVIEW
    Show first N dialogue lines (default: show all)

--quiet
    Only output JSON, skip summary/preview

--debug
    Write diagnostic CSV alongside JSON output

--stats
    Print per-speaker dialogue distribution (lines, words, chars, %)

--speakers SPEAKERS
    Path to speakers.json (default: auto-detect from CWD, then built-in)

SEE ALSO
xil(1), xil-scan(1), xil-parse(1), xil-cues(1), xil-produce(1), xil-assemble(1), xil-studio-onboard(1), xil-daw(1), xil-migrate(1), xil-cleanup(1), xil-import(1), xil-regen(1), xil-master(1), xil-voices(1), xil-csv-join(1), xil-sfx(1), xil-sample(1), xil-sfx-lib(1), xil-splice(1), xil-mp3-hash(1), xil-migrate-workspace(1), xil-init(1)

AUTHOR
John Brissette <xilcmd@gmail.com>