cjm-transcript-graph-schema

Audio-transcript layer schema for context graphs: Source, AudioSegment, Transcript, and Segment nodes with deterministic identity tuples and graph-node mapping, shared by the transcription, decomposition, and correction workflow cores.

Modules

• cjm_transcript_graph_schema.__init__
• cjm_transcript_graph_schema.schema — The audio-transcript layer schema (where-graph-begins locked layer schema): Source -> AudioSegment(coarse boundary) -> AudioRendition(model-input: raw | vocals | ...) -> Transcript(per-transcriber variants) emitted by transcription, extended with the fine Segment spine (per-rendition) by decomposition, and with the intrinsic Collection layer ABOVE Source (book/series/course; proposed-by-tool / confirmed-by-actor, order optional) captured at transcription hand-off. Deterministic identity tuples per the stage-5 ratified rule; the AudioRendition node lets raw + preprocessed model-inputs of one boundary coexist in one graph. Document from the pre-CR-18 era dissolves into Source.

API

cjm_transcript_graph_schema.schema

• AudioRenditionNode class — A model-input rendition OF an AudioSegment — the materialized 16k-mono WAV
• AudioSegmentNode class — Coarse ~5-min spine member: a BOUNDARY range of the Source (an audio fact),
• CollectionNode class — An intrinsic collection (book, podcast series, lecture course) — the
• RespinedChunkEntry class — One chunk respine as the Source records it (0b4d5cfa (4)): the entry the
• SegmentNode class — Fine spine member: one VAD chunk — IMMUTABLE audio range + CORRECTABLE
• SourceNode class — The provenance root: one ingested media file.
• TranscriptGraphLabels class — Node labels of the audio-transcript layer schema.
• TranscriptNode class — One transcriber's text for one AudioRendition (per-transcriber variants at
• TranscriptSliceRef class — One per-transcriber char-range reference for a fine Segment: where this
• audio_rendition_node_id function — AudioRendition identity = (audio segment, preprocessing chain).
• audio_segment_node_id function — AudioSegment identity = (source, boundary range).
• collection_edges function — Membership edges for a collection (ae3464fc: ORDER IS OPTIONAL).
• collection_node_id function — Collection identity = the NORMALIZED TITLE (ratified fork, hub-session
• external_config_hash function — The config hash an external landing carries where a capability's effective
• external_transcriber_name function — Transcriber name for an EXTERNAL landing (ruling 9ffce5f7 (1)): the model id
• normalize_collection_title function — Normalize a collection title for identity derivation.
• segment_node_id function — Fine Segment identity = audio-side only (audio rendition, VAD config, chunk
• source_node_id function — Source identity = the ingested file's content hash (Thread-1 ingested-root identity).
• transcript_node_id function — Transcript identity = (audio rendition, transcriber, config) — MIRRORS the

Dependencies

Depends on: cjm-context-graph-layer, cjm-context-graph-primitives Used by: cjm-context-graph-layer, cjm-transcript-correction-core, cjm-transcript-decomp-core, cjm-transcription-core, cjm-transcription-qt, cjm-workflow-hub-qt