cjm-transcript-decomp-core 0.0.5__tar.gz → 0.0.9__tar.gz

{cjm_transcript_decomp_core-0.0.5/cjm_transcript_decomp_core.egg-info → cjm_transcript_decomp_core-0.0.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cjm-transcript-decomp-core
-Version: 0.0.5
+Version: 0.0.9
 Summary: A frontend-agnostic core for the transcript decomposition workflow — composes isolated capability workers (forced alignment, VAD, graph storage) into a headless pipeline that decomposes transcription run manifests into a VAD-aligned context-graph spine with traceable provenance, and a CLI as its first driver.
 Author-email: "Christian J. Mills" <9126128+cj-mills@users.noreply.github.com>
 License: Apache-2.0
@@ -10,7 +10,8 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: cjm_substrate>=0.0.57
+Requires-Dist: cjm_substrate>=0.0.63
+Requires-Dist: pyyaml
 Requires-Dist: cjm_context_graph_primitives>=0.0.15
 Requires-Dist: cjm_capability_primitives>=0.0.11
 Requires-Dist: cjm-context-graph-layer>=0.0.11
@@ -25,11 +26,17 @@ A frontend-agnostic core for the transcript decomposition workflow — composes
 
 ## Modules
 
+- **`cjm_transcript_decomp_core`**
 - **`cjm_transcript_decomp_core.alignment`** — Pure forced-alignment logic (no capability calls): map FA words back to character spans in the original text, assign words to VAD chunks by timestamp, and build one text segment per VAD chunk. Extracted from the page-centric ForcedAlignmentService (Tier-1 logic).
 - **`cjm_transcript_decomp_core.cli`** — The CLI driver — the decomposition core's first (and currently only) frontend.
+- **`cjm_transcript_decomp_core.discovery`** — Capability-role discovery by manifest surface match — the journaling-by-
 - **`cjm_transcript_decomp_core.graph`** — Graph-spine EXTENSION + skeptical-lens verification (stage 5, CR-18 revolution 2). Decomp no longer creates a Document: it RECOMPUTES the transcription-emitted root's deterministic node ids from the consumed manifest (no search), verifies the root exists, and attaches the fine Segment spine under the existing AudioSegment nodes — PART_OF to the owning rendition, STARTS_WITH per rendition (the coarse-seam jump anchor), source-wide NEXT. Each Segment carries the audio TimeSlice ref plus per-transcriber CharSlice refs into the Transcript nodes (the D4/P10 framing, finally expressible). Commit goes through the layer's idempotent extend_graph.
+- **`cjm_transcript_decomp_core.launch`** — The shared launch surface every decomp shell drives through: the argument
 - **`cjm_transcript_decomp_core.models`** — Lean data shapes for the transcript-decomposition pipeline: in-core mirrors of the forced-alignment / VAD / text DTOs (no FastHTML deps), run configuration, the committed graph-segment carrier, and the decomposition run manifest (proto-bundle).
 - **`cjm_transcript_decomp_core.pipeline`** — The headless decomposition pipeline (stage 5: decomp is an EXTENDER). Load a transcription run manifest, verify the transcription-emitted graph root exists (the graph begins at transcription), then per source per pipeline-segment run VAD + per-transcriber forced alignment, build one aligned segment per VAD chunk with per-transcriber text variants, and attach the fine spine under the existing AudioSegment nodes via the layer's idempotent extend_graph — with HITL approval seams between alignment, commit, and the next source.
+- **`cjm_transcript_decomp_core.runs`** — Run-manifest indexes for the decomp-batch TUI (work item 0ff6bf0f): the
+- **`cjm_transcript_decomp_core.segments`** — Fine-segment inspection for the decomp TUI (work item 166dd2b8, half a):
+- **`cjm_transcript_decomp_core.state`** — Sidecar TUI state: last-used batch settings persisted across sessions (the
 
 ## API
 
@@ -37,7 +44,9 @@ A frontend-agnostic core for the transcript decomposition workflow — composes
 
 - `assign_words_to_chunks` _function_ — Assign each FA word to a VAD chunk by timestamp overlap.
 - `build_segments_from_alignment` _function_ — Build a TextSegment per VAD chunk by grouping words by chunk assignment.
+- `carve_chunks_at_event_spans` _function_ — The event-carve stage (EVENT_SPLIT_POLICY, respine trial DEC 6cc10fb7):
 - `map_fa_words_to_text` _function_ — Map forced-alignment words back to character spans in the original text.
+- `rescue_gap_words` _function_ — The word-rescue stage (WORD_RESCUE_POLICY, 96edc646 verdict bc7ece7b):
 - `sentence_end_word_indices` _function_ — Map capability-delivered sentence boundaries onto FA words (B.5: the
 - `split_chunks_at_sentence_gaps` _function_ — The sentence-split stage (SENTENCE_SPLIT_POLICY, DEC f1024568): refine the
 - `tier1_alignment_checks` _function_ — Tier-1 deterministic pre-filters for the alignment-review seam (no AI).
@@ -49,6 +58,11 @@ A frontend-agnostic core for the transcript decomposition workflow — composes
 - `main` _function_ — CLI entry point (console script: `cjm-transcript-decomp-core`).
 - `run_command` _function_ — Execute the `run` subcommand: extend transcription-run manifest(s) with the fine spine.
 
+### `cjm_transcript_decomp_core.discovery`
+
+- `discover_capability` _function_ — Pick a DEFAULT capability for a role by surface match.
+- `manifests_with_method` _function_ — Enumerate installed capabilities whose structural surface lists `method`.
+
 ### `cjm_transcript_decomp_core.graph`
 
 - `SourceVerification` _class_ — Skeptical-lens verification of one Source's fine-spine extension under a
@@ -56,6 +70,15 @@ A frontend-agnostic core for the transcript decomposition workflow — composes
 - `resolve_root_ids` _function_ — Recompute the transcription-emitted root node ids from manifest data.
 - `verify_source` _function_ — Verify a Source's committed extension via server-side AGGREGATES (D13/D19).
 
+### `cjm_transcript_decomp_core.launch`
+
+- `batch_argv` _function_ — Render one hand-off group as headless decomp-core argv.
+- `build_parser` _function_ — The TUI driver's argument surface (batch-setup options + core passthrough).
+- `event_split_batch_error` _function_ — One propset carves ONE source: the core applies --event-propset to every
+- `hand_off` _function_ — The shared driver tail: persist the confirmed choices, adopt the in-app
+- `resolve_settings` _function_ — Resolve the batch-setup settings every shell shares (flags > persisted
+- `resolve_split_flags` _function_ — Resolve the post-parse split-flag contract (pure; main() calls it
+
 ### `cjm_transcript_decomp_core.models`
 
 - `DecompConfig` _class_ — Configuration for one transcript-decomposition run.
@@ -72,18 +95,50 @@ A frontend-agnostic core for the transcript decomposition workflow — composes
 
 - `build_alignment_composition` _function_ — Build the whole-source M×(VAD ∥ T×FA ∥ SEG) composition (D8 fan-in, stage-5 variants).
 - `collect_capability_info` _function_ — Record capability identity + data-DB pointers for the run manifest (provenance).
-- `compute_skeleton_hash` _function_ — Skeleton identity, pure (DEC f1024568 + 9241564f).
+- `compute_skeleton_hash` _function_ — Skeleton identity, pure (DEC f1024568 + 9241564f + 6cc10fb7).
 - `confirm_seam` _function_ — HITL approval seam in its cheapest viable form (log + optional CLI prompt).
 - `decomp_replay_handlers` _function_ — The decomp core's replay vocabulary (DEC 426658f1, replay stays DOMAIN-OWNED).
 - `decompose_source` _function_ — Decompose one source into aligned fine segments with per-transcriber variants.
+- `event_spans_from_propset` _function_ — Load a proposal set BY POINTER and select its carve spans (respine trial
 - `fa_words_from_result` _function_ — Normalize a typed forced-alignment result into FA words (pure; stage 3).
 - `load_source_manifest` _function_ — Load + lightly validate a transcription-core run manifest.
+- `resolve_event_propsets` _function_ — Join each proposal set to ITS source by the set manifest's own source
 - `run_decomp` _function_ — Extend every source in a transcription run manifest with its fine spine.
 - `sentence_spans_from_result` _function_ — Normalize a typed sentence-segmentation result into char-span tuples (pure; B.5).
 - `submit_and_wait` _function_ — Submit one capability job, wait for it, and return its result (raise on failure).
 - `vad_chunks_from_result` _function_ — Normalize a typed VAD result into segment-local VAD chunks.
 
+### `cjm_transcript_decomp_core.runs`
+
+- `DecompIndex` _class_ — Decomp-core run manifests read back: coverage chips for the batch stage
+- `PropsetIndex` _class_ — Proposal-set manifests under the workspace proposals/ dir — the model's
+- `SourceRunIndex` _class_ — Transcription-core run manifests — the decomp workflow's SOURCES — plus
+- `TrainingRunIndex` _class_ — Training-run manifests under the workspace training-runs/ dir — the
+- `group_batches` _function_ — Fold an ordered batch selection into headless hand-off groups.
+
+### `cjm_transcript_decomp_core.segments`
+
+- `SegmentStack` _class_ — One lazily-opened READ-ONLY graph seat, keyed by db path.
+- `aseg_index_for` _function_ — Which coarse AudioSegment a source-coordinate time falls in (pure;
+- `build_display` _function_ — Interleave gap markers into the paintable entry list (pure).
+- `capability_config_schema` _function_ — A capability's config_schema off its installed manifest (json read, pure).
+- `find_gaps` _function_ — Uncovered timestamp spans between committed segments (pure).
+- `fmt_ts` _function_ — Source-coordinate timestamp for listing rows (pure).
+- `locate_span` _function_ — Resolve a source-coordinate span onto its owning coarse WAV (pure).
+- `ordered_rows` _function_ — Re-impose the manifest's spine order on fetched rows (pure).
+- `predicted_rows` _function_ — Synthesize segment-shaped rows for a probe's predicted skeleton (pure).
+- `probe_compare` _function_ — Compare a VAD probe against the committed skeleton (pure).
+- `realign_rows` _function_ — Re-run the decomp pipeline's own text fold over a PROBE skeleton (pure).
+- `split_predicted` _function_ — Run the decomp pipeline's own SENTENCE-SPLIT stage over a probe skeleton
+- `vad_summary` _function_ — The decomp run's recorded VAD config, one status line (pure).
+
+### `cjm_transcript_decomp_core.state`
+
+- `load_state` _function_ — Read this project's persisted TUI state.
+- `save_state` _function_ — Merge updates into the persisted state and write it back (best-effort:
+- `state_path` _function_ — Where this project's TUI state lives.
+
 ## Dependencies
 
-**Depends on:** `cjm-capability-primitives`, `cjm-context-graph-layer`, `cjm-context-graph-primitives`, `cjm-substrate`, `cjm-transcript-graph-schema`
-**Used by:** `cjm-transcript-decomp-tui`
+**Depends on:** `cjm-capability-primitives`, `cjm-context-graph-layer`, `cjm-context-graph-primitives`, `cjm-substrate`, `cjm-transcript-graph-schema`, `pyyaml`
+**Used by:** `cjm-transcript-decomp-qt`, `cjm-transcript-decomp-tui`

{cjm_transcript_decomp_core-0.0.5 → cjm_transcript_decomp_core-0.0.9}/README.md

@@ -6,11 +6,17 @@ A frontend-agnostic core for the transcript decomposition workflow — composes
 
 ## Modules
 
+- **`cjm_transcript_decomp_core`**
 - **`cjm_transcript_decomp_core.alignment`** — Pure forced-alignment logic (no capability calls): map FA words back to character spans in the original text, assign words to VAD chunks by timestamp, and build one text segment per VAD chunk. Extracted from the page-centric ForcedAlignmentService (Tier-1 logic).
 - **`cjm_transcript_decomp_core.cli`** — The CLI driver — the decomposition core's first (and currently only) frontend.
+- **`cjm_transcript_decomp_core.discovery`** — Capability-role discovery by manifest surface match — the journaling-by-
 - **`cjm_transcript_decomp_core.graph`** — Graph-spine EXTENSION + skeptical-lens verification (stage 5, CR-18 revolution 2). Decomp no longer creates a Document: it RECOMPUTES the transcription-emitted root's deterministic node ids from the consumed manifest (no search), verifies the root exists, and attaches the fine Segment spine under the existing AudioSegment nodes — PART_OF to the owning rendition, STARTS_WITH per rendition (the coarse-seam jump anchor), source-wide NEXT. Each Segment carries the audio TimeSlice ref plus per-transcriber CharSlice refs into the Transcript nodes (the D4/P10 framing, finally expressible). Commit goes through the layer's idempotent extend_graph.
+- **`cjm_transcript_decomp_core.launch`** — The shared launch surface every decomp shell drives through: the argument
 - **`cjm_transcript_decomp_core.models`** — Lean data shapes for the transcript-decomposition pipeline: in-core mirrors of the forced-alignment / VAD / text DTOs (no FastHTML deps), run configuration, the committed graph-segment carrier, and the decomposition run manifest (proto-bundle).
 - **`cjm_transcript_decomp_core.pipeline`** — The headless decomposition pipeline (stage 5: decomp is an EXTENDER). Load a transcription run manifest, verify the transcription-emitted graph root exists (the graph begins at transcription), then per source per pipeline-segment run VAD + per-transcriber forced alignment, build one aligned segment per VAD chunk with per-transcriber text variants, and attach the fine spine under the existing AudioSegment nodes via the layer's idempotent extend_graph — with HITL approval seams between alignment, commit, and the next source.
+- **`cjm_transcript_decomp_core.runs`** — Run-manifest indexes for the decomp-batch TUI (work item 0ff6bf0f): the
+- **`cjm_transcript_decomp_core.segments`** — Fine-segment inspection for the decomp TUI (work item 166dd2b8, half a):
+- **`cjm_transcript_decomp_core.state`** — Sidecar TUI state: last-used batch settings persisted across sessions (the
 
 ## API
 
@@ -18,7 +24,9 @@ A frontend-agnostic core for the transcript decomposition workflow — composes
 
 - `assign_words_to_chunks` _function_ — Assign each FA word to a VAD chunk by timestamp overlap.
 - `build_segments_from_alignment` _function_ — Build a TextSegment per VAD chunk by grouping words by chunk assignment.
+- `carve_chunks_at_event_spans` _function_ — The event-carve stage (EVENT_SPLIT_POLICY, respine trial DEC 6cc10fb7):
 - `map_fa_words_to_text` _function_ — Map forced-alignment words back to character spans in the original text.
+- `rescue_gap_words` _function_ — The word-rescue stage (WORD_RESCUE_POLICY, 96edc646 verdict bc7ece7b):
 - `sentence_end_word_indices` _function_ — Map capability-delivered sentence boundaries onto FA words (B.5: the
 - `split_chunks_at_sentence_gaps` _function_ — The sentence-split stage (SENTENCE_SPLIT_POLICY, DEC f1024568): refine the
 - `tier1_alignment_checks` _function_ — Tier-1 deterministic pre-filters for the alignment-review seam (no AI).
@@ -30,6 +38,11 @@ A frontend-agnostic core for the transcript decomposition workflow — composes
 - `main` _function_ — CLI entry point (console script: `cjm-transcript-decomp-core`).
 - `run_command` _function_ — Execute the `run` subcommand: extend transcription-run manifest(s) with the fine spine.
 
+### `cjm_transcript_decomp_core.discovery`
+
+- `discover_capability` _function_ — Pick a DEFAULT capability for a role by surface match.
+- `manifests_with_method` _function_ — Enumerate installed capabilities whose structural surface lists `method`.
+
 ### `cjm_transcript_decomp_core.graph`
 
 - `SourceVerification` _class_ — Skeptical-lens verification of one Source's fine-spine extension under a
@@ -37,6 +50,15 @@ A frontend-agnostic core for the transcript decomposition workflow — composes
 - `resolve_root_ids` _function_ — Recompute the transcription-emitted root node ids from manifest data.
 - `verify_source` _function_ — Verify a Source's committed extension via server-side AGGREGATES (D13/D19).
 
+### `cjm_transcript_decomp_core.launch`
+
+- `batch_argv` _function_ — Render one hand-off group as headless decomp-core argv.
+- `build_parser` _function_ — The TUI driver's argument surface (batch-setup options + core passthrough).
+- `event_split_batch_error` _function_ — One propset carves ONE source: the core applies --event-propset to every
+- `hand_off` _function_ — The shared driver tail: persist the confirmed choices, adopt the in-app
+- `resolve_settings` _function_ — Resolve the batch-setup settings every shell shares (flags > persisted
+- `resolve_split_flags` _function_ — Resolve the post-parse split-flag contract (pure; main() calls it
+
 ### `cjm_transcript_decomp_core.models`
 
 - `DecompConfig` _class_ — Configuration for one transcript-decomposition run.
@@ -53,18 +75,50 @@ A frontend-agnostic core for the transcript decomposition workflow — composes
 
 - `build_alignment_composition` _function_ — Build the whole-source M×(VAD ∥ T×FA ∥ SEG) composition (D8 fan-in, stage-5 variants).
 - `collect_capability_info` _function_ — Record capability identity + data-DB pointers for the run manifest (provenance).
-- `compute_skeleton_hash` _function_ — Skeleton identity, pure (DEC f1024568 + 9241564f).
+- `compute_skeleton_hash` _function_ — Skeleton identity, pure (DEC f1024568 + 9241564f + 6cc10fb7).
 - `confirm_seam` _function_ — HITL approval seam in its cheapest viable form (log + optional CLI prompt).
 - `decomp_replay_handlers` _function_ — The decomp core's replay vocabulary (DEC 426658f1, replay stays DOMAIN-OWNED).
 - `decompose_source` _function_ — Decompose one source into aligned fine segments with per-transcriber variants.
+- `event_spans_from_propset` _function_ — Load a proposal set BY POINTER and select its carve spans (respine trial
 - `fa_words_from_result` _function_ — Normalize a typed forced-alignment result into FA words (pure; stage 3).
 - `load_source_manifest` _function_ — Load + lightly validate a transcription-core run manifest.
+- `resolve_event_propsets` _function_ — Join each proposal set to ITS source by the set manifest's own source
 - `run_decomp` _function_ — Extend every source in a transcription run manifest with its fine spine.
 - `sentence_spans_from_result` _function_ — Normalize a typed sentence-segmentation result into char-span tuples (pure; B.5).
 - `submit_and_wait` _function_ — Submit one capability job, wait for it, and return its result (raise on failure).
 - `vad_chunks_from_result` _function_ — Normalize a typed VAD result into segment-local VAD chunks.
 
+### `cjm_transcript_decomp_core.runs`
+
+- `DecompIndex` _class_ — Decomp-core run manifests read back: coverage chips for the batch stage
+- `PropsetIndex` _class_ — Proposal-set manifests under the workspace proposals/ dir — the model's
+- `SourceRunIndex` _class_ — Transcription-core run manifests — the decomp workflow's SOURCES — plus
+- `TrainingRunIndex` _class_ — Training-run manifests under the workspace training-runs/ dir — the
+- `group_batches` _function_ — Fold an ordered batch selection into headless hand-off groups.
+
+### `cjm_transcript_decomp_core.segments`
+
+- `SegmentStack` _class_ — One lazily-opened READ-ONLY graph seat, keyed by db path.
+- `aseg_index_for` _function_ — Which coarse AudioSegment a source-coordinate time falls in (pure;
+- `build_display` _function_ — Interleave gap markers into the paintable entry list (pure).
+- `capability_config_schema` _function_ — A capability's config_schema off its installed manifest (json read, pure).
+- `find_gaps` _function_ — Uncovered timestamp spans between committed segments (pure).
+- `fmt_ts` _function_ — Source-coordinate timestamp for listing rows (pure).
+- `locate_span` _function_ — Resolve a source-coordinate span onto its owning coarse WAV (pure).
+- `ordered_rows` _function_ — Re-impose the manifest's spine order on fetched rows (pure).
+- `predicted_rows` _function_ — Synthesize segment-shaped rows for a probe's predicted skeleton (pure).
+- `probe_compare` _function_ — Compare a VAD probe against the committed skeleton (pure).
+- `realign_rows` _function_ — Re-run the decomp pipeline's own text fold over a PROBE skeleton (pure).
+- `split_predicted` _function_ — Run the decomp pipeline's own SENTENCE-SPLIT stage over a probe skeleton
+- `vad_summary` _function_ — The decomp run's recorded VAD config, one status line (pure).
+
+### `cjm_transcript_decomp_core.state`
+
+- `load_state` _function_ — Read this project's persisted TUI state.
+- `save_state` _function_ — Merge updates into the persisted state and write it back (best-effort:
+- `state_path` _function_ — Where this project's TUI state lives.
+
 ## Dependencies
 
-**Depends on:** `cjm-capability-primitives`, `cjm-context-graph-layer`, `cjm-context-graph-primitives`, `cjm-substrate`, `cjm-transcript-graph-schema`
-**Used by:** `cjm-transcript-decomp-tui`
+**Depends on:** `cjm-capability-primitives`, `cjm-context-graph-layer`, `cjm-context-graph-primitives`, `cjm-substrate`, `cjm-transcript-graph-schema`, `pyyaml`
+**Used by:** `cjm-transcript-decomp-qt`, `cjm-transcript-decomp-tui`

cjm_transcript_decomp_core-0.0.9/cjm_transcript_decomp_core/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.0.9"