1.9 KiB
Transcript and Glossary Input Files
This document owns accepted input formats. Use the CLI reference for invocation and error exit semantics, operations for artifact handling, and output files for corrected-transcript serialization.
Transcript JSON Contract
Accepted top-level shapes are an array of segments or an object containing a
segments array. The array must contain at least one segment. Unknown object
fields are ignored by the current parser; an input envelope does not require a
schema/version marker.
| Segment field | Type and validation |
|---|---|
id |
Optional integer (or null). Supplied IDs must be unique; missing IDs are accepted. |
speaker |
Non-empty string |
start, end |
Numeric seconds, finite and non-negative; end must be at least start |
text |
Non-empty string |
categories |
Optional array of non-empty strings |
Supply explicit start and end times for meaningful timing. The current decoder uses zero for missing or null timestamps rather than enforcing their presence. String validation checks empty values, not whitespace trimming. Normalization can merge segments and reassign IDs, so source IDs need not match output IDs.
The tiny transcript is a complete copyable input. Invalid JSON, unsupported top-level shapes, empty transcripts, invalid field types, duplicate supplied IDs, and the validation failures above are rejected.
Glossary collections
Glossary definitions are composed as application configuration, including the
optional companion inputs described by the configuration reference.
The local example provides a complete
collection. Configuration may contain empty collections; processing preflight
requires every glossary-correction entry to select at least one glossary entry.
The previous standalone glossary file format is not a processing input.