cjm-workflow-hub-qt

Qt front door for cjm-substrate workflows — the last migration on the PySide6 lane (DEC 61b46ae8, per amendment 2030586d: a direct port IN SPIRIT). The same collection-grouped source browse with stage-at-a-glance pipeline status and the same curation vocabulary (confirm / file / refile / rename-or-merge / order) as cjm-workflow-hub-tui, whose pure spine and CLI ladder it imports verbatim; the graph stack + JobQueue run behind a private asyncio loop thread with a gesture lock serializing each commit-then-reload. The hub is a launcher, so where the Textual donor suspended into the stage TUIs, this window SPAWNS the Qt stage apps as detached processes resolved across their core envs (PATH first, then the sibling env's bin) — children outlive the hub, and a 2s poll reloads the browse when one exits.

Modules

• cjm_workflow_hub_qt.__init__ — Qt front door for cjm-substrate workflows — a DIRECT PORT IN SPIRIT of
• cjm_workflow_hub_qt.app — The Qt hub shell: the workspace front door under PySide6 (DEC 61b46ae8, a
• cjm_workflow_hub_qt.cli — Console-script driver for the Qt hub: the SAME argument surface and
• cjm_workflow_hub_qt.driver — The hub's shared launch surface: the argument surface (build_parser) and
• cjm_workflow_hub_qt.launch — Stage-app launch: resolve across core envs, spawn detached (DEC 61b46ae8).
• cjm_workflow_hub_qt.panes — Pure row/label builders for the Qt hub shell — the paint logic, Qt-free.
• cjm_workflow_hub_qt.session — The hub shell's jobs seam: graph stack + JobQueue behind a private asyncio
• cjm_workflow_hub_qt.spine — The hub's spine: pure/graph logic below the paint path (sources.py precedent

API

cjm_workflow_hub_qt.app

• HubWindow class — The hub surface under Qt — grouped browse + curation + stage spawn.

cjm_workflow_hub_qt.cli

• main function — Resolve the shared launch surface, run the Qt hub window.

cjm_workflow_hub_qt.driver

• build_parser function — The hub driver's argument surface (everything else the workspace answers).
• resolve_settings function — Resolve + export the workspace and default the manifests dir.

cjm_workflow_hub_qt.launch

• build_stage_cmd function — The donor's launch argv, verbatim: the explicit-db-path guardrail
• resolve_stage_app function — Resolve a stage app's console script across the core-env pattern.
• spawn_stage function — Spawn one stage app, detached: its own session (no signal coupling to

cjm_workflow_hub_qt.panes

• context_text function — The status ladder's MODE-SCOPED half: the editor prompt and the
• default_pins function — The hint line's default verbs before the user pins their own.
• group_targets_by_collection function — Group the filed sources by the collection they LEAVE, so each move is
• hint_entries function — The hub's declarative hint model (DEC 2a42c028): keyPressEvent-idiom
• hub_rows function — One list row per spine row — the donor's _paint_row, single-style.
• status_readout function — The status ladder's RESULT half (DEC 2a42c028 adoption): error >
• status_text function — The donor's status ladder, verbatim precedence: error > busy > the

cjm_workflow_hub_qt.session

• HubShellSession class — The loop-thread seat for the hub shell.

cjm_workflow_hub_qt.spine

• HubData class — Everything one hub reload pulls off the graph (paint-ready inputs).
• build_rows function — The grouped listing: collection headers (⚑ when proposed) with their
• correction_status function — Correction-layer status per source (the correction TUI's source_status
• fetch_pipeline_status function — The four bulk layer projections, joined (join_pipeline_status).
• join_pipeline_status function — Join the four bulk layer projections into per-source pipeline counts.
• list_sources function — Enumerate the graph's Source nodes (CARRIED COPY, see open_stack).
• load_hub_data function — One reload: collections + membership + order + sources + status.
• open_stack function — Bootstrap the graph capability stack, resolving the db path.
• stage_glance function — Stage-at-a-glance for one source row (pure; spans are the app's job).

Dependencies

Depends on: PySide6, cjm-context-graph-layer, cjm-context-graph-primitives, cjm-substrate, cjm-substrate-qt-kit, cjm-transcript-correction-core, cjm-transcript-graph-schema, cjm-transcription-core