Module scan 

xil scan — pre-flight check of a production script. Port of XILP000_script_scanner.py.

Structs

Args 🔒

Scan 🔒

Constants

ALLOWED_TAGS 🔒

Native paralinguistic cues Chatterbox Turbo renders. Anything else is silently stripped at generation time, which is what makes a near-miss worth flagging. Mirrors ALLOWED_TAGS in chatterbox_turbo_worker.py.

NEAR_MISS_CUTOFF 🔒

Similarity floor for suggesting a Turbo cue. Genuine mistakes score

TAG_ALIASES 🔒

Variants difflib scores too low because the wording diverges.

Statics

INLINE_TAG 🔒

Functions

all_scripts 🔒

glob(dir/**/*.md, recursive=True) or glob(dir/*.md).

arr 🔒

backfill_cast 🔒

build_scan 🔒

The full scan result, in the key order the JSON output uses.

command

The clap definition behind --help, for man pages.

execute 🔒

format_report 🔒

harvest_cast 🔒

inner_text 🔒

line[1:-1].strip() — the bracket interior, as the scanner slices it.

is_all_caps_candidate 🔒

A bare ALL-CAPS line worth classifying.

line_list 🔒

load_and_normalize 🔒

Read and apply the parser’s two-pass normalization.

pad 🔒

Pad to width by character count, as Python’s :<N does.

resolve_speakers_path 🔒

--speakers, else configs/{slug}/speakers.json when --show names one.

run

scan_ambience_coverage 🔒

Every looping AMBIENCE needs a stop marker.

scan_direction_texts 🔒

Audit direction texts against an existing SFX config.

scan_paralinguistic_tags 🔒

Inline [tags] that look like misspelled Turbo cues.

scan_script 🔒

Classify every ALL-CAPS candidate into section, speaker or unknown.

scan_span_pairing 🔒

Every <marker> ENGAGES must have a matching DISENGAGES.