cjm-transcript-correction-tui 0.0.1__tar.gz → 0.0.2__tar.gz

{cjm_transcript_correction_tui-0.0.1 → cjm_transcript_correction_tui-0.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cjm-transcript-correction-tui
-Version: 0.0.1
+Version: 0.0.2
 Summary: Transcript-correction TUI driver: keyboard-first terminal review surface (cursor-windowed segment walk, VAD-chunk audio auto-play, fidelity + boundary-shift corrections, agents-propose/humans-confirm triage) over cjm-transcript-correction-core's operation vocabulary. The first born-on-graph library of the self-hosting graph arc.
 Author-email: "Christian J. Mills" <9126128+cj-mills@users.noreply.github.com>
 License: Apache-2.0
@@ -29,7 +29,6 @@ The minimal presentation driver for cjm-transcript-correction-core: a document-o
 
 - **`cjm_transcript_correction_tui.__init__`** — Keyboard-first TUI driver for the transcript-correction workflow — a presentation
 - **`cjm_transcript_correction_tui.app`**
-- **`cjm_transcript_correction_tui.audio`**
 - **`cjm_transcript_correction_tui.cli`**
 - **`cjm_transcript_correction_tui.spine`**
 
@@ -41,12 +40,6 @@ The minimal presentation driver for cjm-transcript-correction-core: a document-o
 - `load_tui_state` _function_ — Read the per-graph TUI sidecar state (last-focused positions).
 - `save_tui_state` _function_ — Merge one source's last-focused position into the sidecar state file.
 
-### `cjm_transcript_correction_tui.audio`
-
-- `ChunkPlayer` _class_ — Persistent-output-stream VAD-chunk player — the focus-walk auto-play engine.
-- `load_chunk` _function_ — Read one VAD chunk's samples from the model-input WAV — frame-sliced, sample-accurate.
-- `stretch` _function_ — Pitch-preserving time-stretch (WSOLA, numpy-only) — the playback-speed engine.
-
 ### `cjm_transcript_correction_tui.cli`
 
 - `build_parser` _function_ — The TUI driver's argument surface (mirrors correction-core's run/review args).
@@ -56,8 +49,14 @@ The minimal presentation driver for cjm-transcript-correction-core: a document-o
 
 - `ChunkRef` _class_ — Where one Segment's VAD-chunk audio lives: the model-input WAV + the chunk-local span.
 - `SpineView` _class_ — One Source's effective correction spine, cursor-windowed for the TUI.
+- `list_sources` _function_ — Enumerate the graph's Source nodes (the discovery corpus, 2ce81638).
+- `match_sources` _function_ — The --source selector (pure; shared by direct open and the picker's seed).
+- `open_stack` _function_ — Bootstrap the graph capability stack, resolving the db path (2ce81638).
+- `parse_mark_input` _function_ — Parse the M-editor mark grammar (pure; the DEC 2a231843 TUI gesture).
 - `plan_boundary_shift` _function_ — Plan a ONE-WORD boundary shift (the [ / ] gesture unit).
+- `resolve_mark_class_token` _function_ — Resolve a leading digit token to its menu class (the M picker; pure).
+- `source_status` _function_ — Correction-status-at-a-glance for one Source (the picker's detail row).
 
 ## Dependencies
 
-**Depends on:** `cjm-context-graph-layer`, `cjm-transcript-correction-core`, `numpy`, `sounddevice`, `soundfile`, `textual`
+**Depends on:** `cjm-context-graph-layer`, `cjm-substrate-tui-kit`, `cjm-transcript-correction-core`, `numpy`, `sounddevice`, `soundfile`, `textual`

{cjm_transcript_correction_tui-0.0.1 → cjm_transcript_correction_tui-0.0.2}/README.md

@@ -8,7 +8,6 @@ The minimal presentation driver for cjm-transcript-correction-core: a document-o
 
 - **`cjm_transcript_correction_tui.__init__`** — Keyboard-first TUI driver for the transcript-correction workflow — a presentation
 - **`cjm_transcript_correction_tui.app`**
-- **`cjm_transcript_correction_tui.audio`**
 - **`cjm_transcript_correction_tui.cli`**
 - **`cjm_transcript_correction_tui.spine`**
 
@@ -20,12 +19,6 @@ The minimal presentation driver for cjm-transcript-correction-core: a document-o
 - `load_tui_state` _function_ — Read the per-graph TUI sidecar state (last-focused positions).
 - `save_tui_state` _function_ — Merge one source's last-focused position into the sidecar state file.
 
-### `cjm_transcript_correction_tui.audio`
-
-- `ChunkPlayer` _class_ — Persistent-output-stream VAD-chunk player — the focus-walk auto-play engine.
-- `load_chunk` _function_ — Read one VAD chunk's samples from the model-input WAV — frame-sliced, sample-accurate.
-- `stretch` _function_ — Pitch-preserving time-stretch (WSOLA, numpy-only) — the playback-speed engine.
-
 ### `cjm_transcript_correction_tui.cli`
 
 - `build_parser` _function_ — The TUI driver's argument surface (mirrors correction-core's run/review args).
@@ -35,8 +28,14 @@ The minimal presentation driver for cjm-transcript-correction-core: a document-o
 
 - `ChunkRef` _class_ — Where one Segment's VAD-chunk audio lives: the model-input WAV + the chunk-local span.
 - `SpineView` _class_ — One Source's effective correction spine, cursor-windowed for the TUI.
+- `list_sources` _function_ — Enumerate the graph's Source nodes (the discovery corpus, 2ce81638).
+- `match_sources` _function_ — The --source selector (pure; shared by direct open and the picker's seed).
+- `open_stack` _function_ — Bootstrap the graph capability stack, resolving the db path (2ce81638).
+- `parse_mark_input` _function_ — Parse the M-editor mark grammar (pure; the DEC 2a231843 TUI gesture).
 - `plan_boundary_shift` _function_ — Plan a ONE-WORD boundary shift (the [ / ] gesture unit).
+- `resolve_mark_class_token` _function_ — Resolve a leading digit token to its menu class (the M picker; pure).
+- `source_status` _function_ — Correction-status-at-a-glance for one Source (the picker's detail row).
 
 ## Dependencies
 
-**Depends on:** `cjm-context-graph-layer`, `cjm-transcript-correction-core`, `numpy`, `sounddevice`, `soundfile`, `textual`
+**Depends on:** `cjm-context-graph-layer`, `cjm-substrate-tui-kit`, `cjm-transcript-correction-core`, `numpy`, `sounddevice`, `soundfile`, `textual`

{cjm_transcript_correction_tui-0.0.1 → cjm_transcript_correction_tui-0.0.2}/cjm_transcript_correction_tui/__init__.py

@@ -5,7 +5,7 @@ this package is authored as graph nodes and projected to `.py`."""
 
 import os
 
-__version__ = "0.0.1"
+__version__ = "0.0.2"
 
 # PipeWire routing: conda-forge PortAudio ships an ALSA that cannot see the system
 # pipewire/default PCM (hw-only enumeration -> audio lands on the wrong sink, e.g. a

{cjm_transcript_correction_tui-0.0.1 → cjm_transcript_correction_tui-0.0.2}/cjm_transcript_correction_tui/app.py

@@ -16,7 +16,8 @@ from textual.app import App, ComposeResult
 from textual.binding import Binding
 from textual.widgets import Input, Static
 
-from .spine import parse_mark_input, plan_boundary_shift, resolve_mark_class_token, SpineView
+from .spine import (list_sources, match_sources, open_stack, parse_mark_input, plan_boundary_shift,
+                    resolve_mark_class_token, source_status, SpineView)
 
 
 class CorrectionApp(App):
@@ -70,11 +71,12 @@ class CorrectionApp(App):
         Binding("N", "prev_mark", "prev mark"),
         Binding("p", "next_prune", "next prune"),
         Binding("P", "prev_prune", "prev prune"),
+        Binding("enter", "open_source", "open", show=False),
         Binding("escape", "cancel", "cancel/stop", show=False, priority=True),
         Binding("q", "quit_app", "quit"),
     ]
 
-    def __init__(self, graph_db_path: str,                # The shared transcription graph db
+    def __init__(self, graph_db_path: Optional[str] = None,  # The shared transcription graph db (None = workspace-resolved, 2ce81638)
                  *, source: Optional[str] = None,         # Source id or title substring
                  manifests_dir: str = ".cjm/manifests",   # Capability manifests directory
                  rendition: Optional[str] = None,         # Rendition selector (None = auto)
@@ -87,8 +89,16 @@ class CorrectionApp(App):
         self._open_kwargs = dict(source=source, manifests_dir=manifests_dir,
                                  rendition=rendition)
         self._graph_db_path = graph_db_path
-        # Every correction write appends through to the db's sidecar journal (DEC ccbab9f5).
-        self._journal_path = sidecar_journal_path(graph_db_path)
+        # Every correction write appends through to the db's sidecar journal (DEC
+        # ccbab9f5); the path derives from the EFFECTIVE db at mount (may be
+        # workspace-resolved, so it cannot be computed here).
+        self._journal_path: Optional[object] = None
+        self.stage = "select"            # "select" (source picker) -> "correct" (the walk)
+        self._graph_cap = "cjm-capability-graph-sqlite"
+        self._manager = None             # the open stack; view.close() owns teardown once a spine opens
+        self._queue = None
+        self._sources: List[Tuple[str, str]] = []     # [(source_id, title)] the picker walks
+        self._status: Dict[str, Dict[str, int]] = {}  # source_id -> status-at-a-glance
         self.view: Optional[SpineView] = None
         self.player: Optional[ChunkPlayer] = None
         self.cursor = 0
@@ -114,8 +124,31 @@ class CorrectionApp(App):
         yield editor
 
     async def on_mount(self) -> None:
-        self.view = await SpineView.open(self._graph_db_path, **self._open_kwargs)
+        self._manager, self._queue, db = await open_stack(
+            self._graph_db_path, manifests_dir=self._open_kwargs["manifests_dir"],
+            graph_capability=self._graph_cap)
+        self._graph_db_path = db
+        self._journal_path = sidecar_journal_path(db)
         self.player = ChunkPlayer(device=self.audio_device)
+        sources = await list_sources(self._queue, self._graph_cap)
+        picked = match_sources(sources, self._open_kwargs["source"])
+        if len(picked) == 1:
+            await self._open_source(*picked[0])
+            return
+        # 2ce81638 discovery: no unique --source -> browse the graph's Sources
+        # (a bad needle widens to ALL of them, never a dead-end error).
+        self._sources = picked if len(picked) > 1 else sources
+        for sid, _ in self._sources:
+            self._status[sid] = await source_status(self._queue, self._graph_cap, sid)
+        self.cursor = 0
+        self._render()
+
+    async def _open_source(self, source_id: str, title: str) -> None:
+        """Open one Source's spine on the already-open stack and enter the walk."""
+        self.view = await SpineView.open_on(self._manager, self._queue, self._graph_cap,
+                                            source_id, title,
+                                            rendition=self._open_kwargs["rendition"])
+        self.stage = "correct"
         sess = await start_session(self.view.queue, self.view.graph_id,
                                    [self.view.source_id],
                                    journal_path=self._journal_path)
@@ -128,6 +161,7 @@ class CorrectionApp(App):
             self.speed = 1.0
         mc = str(state.get("_mark_class") or "suspect")
         self._mark_class = mc if mc[:1].isalnum() else "suspect"   # heal a junk-class sidecar
+        self.cursor = 0                    # the picker borrowed the cursor
         if self.resume:
             saved = state.get(self.view.source_id)
             if saved and self.view.size:
@@ -202,6 +236,9 @@ class CorrectionApp(App):
         is pinned to the vertical center of the card area; neighbor cards stack
         outward from it (one blank separator row) and absorb the height variance,
         clipping at the screen edges. The pin never moves — the spine flows past it."""
+        if self.stage == "select":
+            self._render_picker()
+            return
         view = self.view
         if not view.size:
             self.query_one("#status", Static).update(f"{view.source_title}  ·  empty spine")
@@ -239,6 +276,48 @@ class CorrectionApp(App):
             f"  ·  j/k·w/s walk · ←→/a/d shift · r replay · \\[/] speed · e edit · y copy"
             f" · space/u ±reviewed · m/b/M ⚑mark · n/N⚑ p/P✂ jump · q quit")
 
+    def _render_picker(self) -> None:
+        """The 2ce81638 discovery stage: the graph's Sources with correction
+        status at a glance; same key vocabulary as the walk (j/k, enter opens).
+        Spans only — no base row styles (7aca1117)."""
+        width = max(20, self.size.width)
+        lines: List[Text] = [Text("")]
+        if not self._sources:
+            lines.append(Text("  no Source nodes on this graph", style="dim"))
+        for i, (sid, title) in enumerate(self._sources):
+            st = self._status.get(sid) or {}
+            focused = (i == self.cursor)
+            row = Text("")
+            row.append("  > " if focused else "    ")
+            row.append(title or sid[:12], style="bold" if focused else "")
+            row.append(f"   {st.get('segments', 0)} segs", style="dim")
+            row.append(f" · {st.get('corrections', 0)} corrections", style="dim")
+            marks = st.get("marks", 0)
+            if marks:
+                row.append(f" · {marks} ⚑", style="yellow")
+            row.truncate(width)
+            lines.append(row)
+        self.query_one("#cards", Static).update(Text("\n").join(lines))
+        tail = str(self._graph_db_path or "")
+        tail = tail if len(tail) <= 40 else "…" + tail[-39:]
+        self.query_one("#status", Static).update(
+            f"pick a source ({len(self._sources)})  ·  @{tail}"
+            f"  ·  j/k walk · enter open · q quit")
+
+    def check_action(self, action: str, parameters) -> bool:
+        """Stage gate: during the picker only walk/open/quit act — the whole
+        correction vocabulary stays inert until a spine is open (view-None
+        crash guard, one gate instead of twenty)."""
+        if self.stage == "select":
+            return action in ("next", "prev", "open_source", "quit_app")
+        return True
+
+    async def action_open_source(self) -> None:
+        if self.stage != "select" or not self._sources:
+            return
+        sid, title = self._sources[self.cursor]
+        await self._open_source(sid, title)
+
     def _play_cursor(self) -> None:
         c = self.view.chunk(self.cursor)
         if c is None:
@@ -247,6 +326,11 @@ class CorrectionApp(App):
         self.player.play(load_chunk(c.wav_path, c.start_s, c.end_s, speed=self.speed))
 
     def _move(self, delta: int) -> None:
+        if self.stage == "select":                 # the picker walks the source list
+            if self._sources:
+                self.cursor = max(0, min(len(self._sources) - 1, self.cursor + delta))
+                self._render()
+            return
         new = max(0, min(self.view.size - 1, self.cursor + delta))
         if new == self.cursor:
             return
@@ -607,6 +691,8 @@ class CorrectionApp(App):
             self.player.close()
         if self.view is not None:
             await self.view.close()
+        elif self._queue is not None:
+            await self._queue.stop()   # picker-stage quit: the stack is open, no view owns it yet
         self.exit()
 
 

{cjm_transcript_correction_tui-0.0.1 → cjm_transcript_correction_tui-0.0.2}/cjm_transcript_correction_tui/cli.py

@@ -12,19 +12,23 @@ def build_parser() -> argparse.ArgumentParser:  # Configured CLI parser
         prog="cjm-transcript-correction-tui",
         description="Keyboard-first correction loop over a transcription context graph "
                     "(document-order segment walk, VAD-chunk auto-play, fidelity edits).")
-    p.add_argument("--graph-db-path", required=True,
-                   help="The shared transcription graph db (the committed spine)")
+    p.add_argument("--graph-db-path", default=None,
+                   help="The shared transcription graph db (the committed spine); "
+                        "default: the graph capability's persisted config — under an "
+                        "active workspace the config store is workspace-scoped, so "
+                        "the workspace names the db (2ce81638)")
     p.add_argument("--source", default=None,
-                   help="Source node id or title substring (required when the graph "
-                        "holds more than one Source)")
+                   help="Source node id or title substring; omitted or ambiguous -> "
+                        "the in-TUI source picker (correction status at a glance)")
     p.add_argument("--manifests-dir", default=None,
                    help="Capability manifests directory (default: the workspace's "
                         ".cjm/manifests when one is active, else .cjm/manifests under the cwd)")
     p.add_argument("--workspace", default=None,
                    help="Workspace root (5daadfc4; default: CJM_WORKSPACE env, else upward walk "
                         "from cwd). Supplies the manifests default and is exported so capability "
-                        "workers resolve workspace-scoped paths; run/source DISCOVERY over the "
-                        "workspace graph is the 2ce81638 follow-on")
+                        "workers resolve workspace-scoped paths and the config store "
+                        "supplies the graph db default (2ce81638 discovery is built: "
+                        "no --source -> in-TUI picker)")
     p.add_argument("--rendition", default=None,
                    help="AudioRendition selector when a source has more than one "
                         "(\"raw\" or a preprocessing substring); default: auto-select")

{cjm_transcript_correction_tui-0.0.1 → cjm_transcript_correction_tui-0.0.2}/cjm_transcript_correction_tui/spine.py

@@ -61,38 +61,44 @@ class SpineView:
         self._aseg_audio: List[Optional[ChunkRef]] = []  # Parallel: (wav, aseg-start) join stubs
 
     @classmethod
-    async def open(cls, graph_db_path: str,                 # The shared transcription graph db
+    async def open(cls, graph_db_path: Optional[str],       # The shared transcription graph db (None = workspace-resolved)
                    *, source: Optional[str] = None,         # Source node id OR a title substring
                    manifests_dir: str = ".cjm/manifests",   # Capability manifests directory
                    graph_capability: str = "cjm-capability-graph-sqlite",
                    rendition: Optional[str] = None,         # Rendition selector (None = auto)
                    ) -> "SpineView":
-        """Bootstrap the capability stack and load one Source's effective spine."""
-        manager = CapabilityManager(search_paths=[Path(manifests_dir)])
-        load_capabilities(manager, [graph_capability],
-                          configs={graph_capability: {"db_path": str(graph_db_path)}})
-        queue = JobQueue(deps=manager)
-        await queue.start()
+        """Bootstrap the capability stack and load one Source's effective spine
+        (the direct/scripted launch; the app's picker composes the same rungs —
+        open_stack / list_sources / open_on — around a selection stage)."""
+        manager, queue, _ = await open_stack(graph_db_path, manifests_dir=manifests_dir,
+                                             graph_capability=graph_capability)
         try:
-            sq = NodeQuery(label="Source", project=["title"])
-            res = await graph_task(queue, graph_capability, "query_nodes", query=sq.to_dict())
-            sources = [(r["id"], str(r.get("title") or "")) for r in (res.rows or [])]
-            if source:
-                picked = [(i, t) for i, t in sources
-                          if i == source or source.lower() in t.lower()]
-            else:
-                picked = sources
+            sources = await list_sources(queue, graph_capability)
+            picked = match_sources(sources, source)
             if len(picked) != 1:
                 titles = "; ".join(t for _, t in sources)
                 raise ValueError(f"need exactly one Source (matched {len(picked)}) — "
                                  f"pass `source=` an id or title substring; available: {titles}")
-            view = cls(manager, queue, graph_capability, picked[0][0], picked[0][1])
-            await view._load(rendition)
-            return view
+            return await cls.open_on(manager, queue, graph_capability,
+                                     picked[0][0], picked[0][1], rendition=rendition)
         except BaseException:
             await queue.stop()
             raise
 
+    @classmethod
+    async def open_on(cls, manager: CapabilityManager,      # The open stack's manager
+                      queue: JobQueue,                      # Started queue (teardown stays with the caller until the view owns it)
+                      graph_id: str,                        # The graph capability name
+                      source_id: str,                       # The picked Source node id
+                      source_title: str,                    # Its display title
+                      *, rendition: Optional[str] = None,   # Rendition selector (None = auto)
+                      ) -> "SpineView":
+        """Load one Source's effective spine on an ALREADY-open stack (the
+        picker's open rung — discovery browsed the stack first, 2ce81638)."""
+        view = cls(manager, queue, graph_id, source_id, source_title)
+        await view._load(rendition)
+        return view
+
     async def _load(self, rendition: Optional[str]) -> None:
         """Load spine + corrections + the audio join (one Source, one rendition chain)."""
         segments = await load_source_segments(self.queue, self.graph_id, self.source_id,
@@ -319,3 +325,72 @@ def resolve_mark_class_token(
     if not (1 <= n <= len(menu)):
         return raw, f"no class #{n} (menu is 1-{len(menu)})"
     return f"{menu[n - 1]} {rest}".strip(), None
+
+
+async def open_stack(
+    graph_db_path: Optional[str],            # Explicit graph db, or None = the workspace answers
+    *, manifests_dir: str = ".cjm/manifests",  # Capability manifests directory
+    graph_capability: str = "cjm-capability-graph-sqlite",
+) -> Tuple[CapabilityManager, JobQueue, str]:  # (manager, started queue, effective db path)
+    """Bootstrap the graph capability stack, resolving the db path (2ce81638).
+
+    With an explicit path the capability loads against it (today's hand-carried
+    launch). With None, the capability loads on its PERSISTED config — under
+    CJM_WORKSPACE the substrate config store is workspace-scoped (5daadfc4), so
+    the workspace itself names the graph db; the effective path reads back off
+    the loaded instance (CR-2 applies persisted config when the caller sends
+    none). No db path anywhere = loud refusal naming both outs."""
+    manager = CapabilityManager(search_paths=[Path(manifests_dir)])
+    configs = ({graph_capability: {"db_path": str(graph_db_path)}}
+               if graph_db_path else None)
+    load_capabilities(manager, [graph_capability], configs=configs)
+    effective = graph_db_path or (
+        (manager.instances[graph_capability].config or {}).get("db_path"))
+    if not effective:
+        raise ValueError(
+            f"no graph db path: pass --graph-db-path, or persist one on "
+            f"{graph_capability} in the active workspace's config store")
+    queue = JobQueue(deps=manager)
+    await queue.start()
+    return manager, queue, str(effective)
+
+
+async def list_sources(
+    queue: JobQueue,      # Started queue over the loaded graph capability
+    graph_id: str,        # The graph capability name
+) -> List[Tuple[str, str]]:  # [(source_id, title)] in query order
+    """Enumerate the graph's Source nodes (the discovery corpus, 2ce81638)."""
+    sq = NodeQuery(label="Source", project=["title"])
+    res = await graph_task(queue, graph_id, "query_nodes", query=sq.to_dict())
+    return [(r["id"], str(r.get("title") or "")) for r in (res.rows or [])]
+
+
+def match_sources(
+    sources: List[Tuple[str, str]],  # [(source_id, title)] as enumerated
+    needle: Optional[str],           # Source node id OR a title substring; None = all
+) -> List[Tuple[str, str]]:  # The subset the needle selects (all when None)
+    """The --source selector (pure; shared by direct open and the picker's seed)."""
+    if not needle:
+        return list(sources)
+    return [(i, t) for i, t in sources
+            if i == needle or needle.lower() in t.lower()]
+
+
+async def source_status(
+    queue: JobQueue,      # Started queue over the loaded graph capability
+    graph_id: str,        # The graph capability name
+    source_id: str,       # Source whose correction status to summarize
+) -> Dict[str, int]:  # {"segments": VAD-chunk count, "corrections": active, "marks": open}
+    """Correction-status-at-a-glance for one Source (the picker's detail row).
+
+    Segments count the VAD skeleton (AudioSegment PART_OF source — the same
+    full-skeleton walk the correction surface presents); corrections count the
+    ACTIVE set (supersession applied), marks the OPEN ⚑ set."""
+    aq = NodeQuery(label=TranscriptGraphLabels.AUDIO_SEGMENT,
+                   related=RelationPredicate(SpineRelations.PART_OF, node_id=source_id),
+                   project=["id"])
+    ares = await graph_task(queue, graph_id, "query_nodes", query=aq.to_dict())
+    corrections, superseded = await load_source_corrections(queue, graph_id, source_id)
+    return {"segments": len(ares.rows or []),
+            "corrections": len(active_corrections(corrections, superseded)),
+            "marks": len(open_marks(corrections, superseded))}

{cjm_transcript_correction_tui-0.0.1 → cjm_transcript_correction_tui-0.0.2}/cjm_transcript_correction_tui.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cjm-transcript-correction-tui
-Version: 0.0.1
+Version: 0.0.2
 Summary: Transcript-correction TUI driver: keyboard-first terminal review surface (cursor-windowed segment walk, VAD-chunk audio auto-play, fidelity + boundary-shift corrections, agents-propose/humans-confirm triage) over cjm-transcript-correction-core's operation vocabulary. The first born-on-graph library of the self-hosting graph arc.
 Author-email: "Christian J. Mills" <9126128+cj-mills@users.noreply.github.com>
 License: Apache-2.0
@@ -29,7 +29,6 @@ The minimal presentation driver for cjm-transcript-correction-core: a document-o
 
 - **`cjm_transcript_correction_tui.__init__`** — Keyboard-first TUI driver for the transcript-correction workflow — a presentation
 - **`cjm_transcript_correction_tui.app`**
-- **`cjm_transcript_correction_tui.audio`**
 - **`cjm_transcript_correction_tui.cli`**
 - **`cjm_transcript_correction_tui.spine`**
 
@@ -41,12 +40,6 @@ The minimal presentation driver for cjm-transcript-correction-core: a document-o
 - `load_tui_state` _function_ — Read the per-graph TUI sidecar state (last-focused positions).
 - `save_tui_state` _function_ — Merge one source's last-focused position into the sidecar state file.
 
-### `cjm_transcript_correction_tui.audio`
-
-- `ChunkPlayer` _class_ — Persistent-output-stream VAD-chunk player — the focus-walk auto-play engine.
-- `load_chunk` _function_ — Read one VAD chunk's samples from the model-input WAV — frame-sliced, sample-accurate.
-- `stretch` _function_ — Pitch-preserving time-stretch (WSOLA, numpy-only) — the playback-speed engine.
-
 ### `cjm_transcript_correction_tui.cli`
 
 - `build_parser` _function_ — The TUI driver's argument surface (mirrors correction-core's run/review args).
@@ -56,8 +49,14 @@ The minimal presentation driver for cjm-transcript-correction-core: a document-o
 
 - `ChunkRef` _class_ — Where one Segment's VAD-chunk audio lives: the model-input WAV + the chunk-local span.
 - `SpineView` _class_ — One Source's effective correction spine, cursor-windowed for the TUI.
+- `list_sources` _function_ — Enumerate the graph's Source nodes (the discovery corpus, 2ce81638).
+- `match_sources` _function_ — The --source selector (pure; shared by direct open and the picker's seed).
+- `open_stack` _function_ — Bootstrap the graph capability stack, resolving the db path (2ce81638).
+- `parse_mark_input` _function_ — Parse the M-editor mark grammar (pure; the DEC 2a231843 TUI gesture).
 - `plan_boundary_shift` _function_ — Plan a ONE-WORD boundary shift (the [ / ] gesture unit).
+- `resolve_mark_class_token` _function_ — Resolve a leading digit token to its menu class (the M picker; pure).
+- `source_status` _function_ — Correction-status-at-a-glance for one Source (the picker's detail row).
 
 ## Dependencies
 
-**Depends on:** `cjm-context-graph-layer`, `cjm-transcript-correction-core`, `numpy`, `sounddevice`, `soundfile`, `textual`
+**Depends on:** `cjm-context-graph-layer`, `cjm-substrate-tui-kit`, `cjm-transcript-correction-core`, `numpy`, `sounddevice`, `soundfile`, `textual`

{cjm_transcript_correction_tui-0.0.1 → cjm_transcript_correction_tui-0.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cjm-transcript-correction-tui"
-version = "0.0.1"
+version = "0.0.2"
 description = "Transcript-correction TUI driver: keyboard-first terminal review surface (cursor-windowed segment walk, VAD-chunk audio auto-play, fidelity + boundary-shift corrections, agents-propose/humans-confirm triage) over cjm-transcript-correction-core's operation vocabulary. The first born-on-graph library of the self-hosting graph arc."
 readme = "README.md"
 requires-python = ">=3.12"

{cjm_transcript_correction_tui-0.0.1 → cjm_transcript_correction_tui-0.0.2}/tests/test_gestures.py

@@ -112,3 +112,17 @@ def test_resolve_mark_class_token():
     assert raw == "9" and err is not None
     raw, err = resolve_mark_class_token("0 note", menu)
     assert raw == "0 note" and err is not None
+
+
+def test_match_sources_selector_arms():
+    """2ce81638 discovery: the --source selector is pure and shared by direct
+    open and the picker seed — exact-id wins, title substring is case-blind,
+    None selects all, a miss selects none (the app widens a miss to the full
+    picker instead of dead-ending)."""
+    from cjm_transcript_correction_tui.spine import match_sources
+    sources = [("id-a", "Intro꞉ Learning Games"), ("id-b", "Chapter One")]
+    assert match_sources(sources, None) == sources
+    assert match_sources(sources, "id-a") == [sources[0]]
+    assert match_sources(sources, "chapter") == [sources[1]]
+    assert match_sources(sources, "LEARNING") == [sources[0]]
+    assert match_sources(sources, "zzz") == []