XIL-MIGRATE(1)

NAME
xil-migrate

SYNOPSIS
xil-migrate [-h] [--episode TAG] [--tag TAG] [--show SHOW] [--old PATH] [--new PATH] [--stems DIR] [--orig-prefix ORIG_PREFIX] [--dry-run] [--strict] [--quiet]

DESCRIPTION
Migrate episode stems from an old parsed JSON to a revised one. Copies unchanged stems to their new seq-numbered filenames; reports what still needs TTS/SFX generation. Run XILP002 afterwards to fill the gaps.

OPTIONS

--episode TAG
    Episode tag (e.g. S02E03); derives --old, --new, and --stems paths automatically

--tag TAG
    Raw tag for non-episodic content (e.g. V01C03, D01); same as --episode but skips format validation

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

--old PATH
    Old parsed JSON (overrides --episode)

--new PATH
    New parsed JSON (overrides --episode)

--stems DIR
    Stems directory (overrides --episode)

--orig-prefix ORIG_PREFIX
    Filename prefix for the old parsed JSON (default: orig_)

--dry-run
    Show plan without copying any files

--strict
    Exact text match only. Default is fuzzy: ignores em-dash/ellipsis variants so punctuation-only edits don't force unnecessary regen.

--quiet
    Print only the summary, not per-stem details

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>