transcoder gui tab good enough for now

Author: lucianpar

internalDocs/AGENTS.md

@@ -107,16 +107,33 @@ Native GUI linking `EngineSessionCore` directly in-process. No subprocess, no OS
 
 **Build:** `./init.sh` then `./build.sh --gui`. **Run:** `./run.sh`.
 
-### `cult-transcoder` — ADM → LUSID Tool
+### `cult-transcoder` — ADM ↔ LUSID Tool
+
+Three subcommands:
 
 ```bash
+# 1. ADM XML or ADM WAV/BWF → LUSID scene JSON
 build/internal/cult_transcoder/cult-transcoder transcode \
-    --in <adm_wav_path> --in-format adm_wav \
-    --out data/processedData/stageForRender/scene.lusid.json \
-    --out-format lusid_json \
-    [--lfe-mode hardcoded|speaker-label]
+    --in <path> --in-format adm_xml|adm_wav \
+    --out <scene.lusid.json> --out-format lusid_json \
+    [--lfe-mode hardcoded|speaker-label] [--report <path>] [--stdout-report]
+
+# 2. ADM WAV/BWF → self-contained LUSID package (metadata + split mono stems)
+build/internal/cult_transcoder/cult-transcoder package-adm-wav \
+    --in <source.wav> --out-package <package-dir> \
+    [--lfe-mode hardcoded|speaker-label] [--report <path>] [--stdout-report] [--quiet]
+
+# 3. LUSID scene/package → ADM BWF/WAV + sidecar ADM XML (export/authoring)
+build/internal/cult_transcoder/cult-transcoder adm-author \
+    --lusid <scene.lusid.json> --wav-dir <stem-dir> \
+    --out-xml <export.adm.xml> --out-wav <export.wav> \
+    [--report <path>] [--stdout-report] [--quiet]
+# alternate input:
+#   --lusid-package <package-dir>  (replaces --lusid + --wav-dir)
 ```
 
+The GUI Transcoder tab exposes all three workflows. See `source/gui/imgui/src/App.cpp::renderTranscodeTab()`.
+
 Source: `internal/cult_transcoder/` (git submodule). See `internal/cult_transcoder/internalDocs/AGENTS-CULT.md` for full cult-transcoder docs.
 
 ### `spatialroot_spatial_render` — Offline Batch Renderer

internalDocs/devHistory.md

@@ -5,6 +5,29 @@
 
 ---
 
+## GUI Transcoder Tab — Three-Workflow Redesign (May 8, 2026)
+
+**Status:** Complete. Replaces the single ADM→LUSID panel with a three-workflow tab bar exposing the full current CULT transcoder CLI surface.
+
+**Motivation:** The previous Transcoder tab only exposed `cult-transcoder transcode` (ADM→LUSID Scene). CULT now supports two additional subcommands (`package-adm-wav`, `adm-author`) that were inaccessible from the GUI.
+
+**Files changed:**
+- `source/gui/imgui/src/App.hpp` — added workflow state members and constants for all three workflows
+- `source/gui/imgui/src/App.cpp` — `renderTranscodeTab()` rebuilt with `BeginTabBar("##tc_workflow")`
+
+**Three sub-tabs now exposed:**
+1. **ADM to LUSID Scene** (`cult-transcoder transcode`) — converts ADM XML or ADM WAV/BWF metadata to `scene.lusid.json`
+2. **ADM WAV to LUSID Package** (`cult-transcoder package-adm-wav`) — extracts ADM, converts metadata, splits interleaved audio into a LUSID package directory
+3. **LUSID to ADM Export** (`cult-transcoder adm-author`) — authors LUSID package material into Logic-compatible ADM BWF/WAV + sidecar ADM XML
+
+**Each tab has:** file/folder pickers with type-appropriate browse dialogs, inline validation warnings for missing required fields, run button disabled until required fields are filled, live command preview, run-status indicator. Experimental `adm-author` options (`--dbmd-source`, `--metadata-post-data`) gated behind a collapsible section with amber warning text. `--stdout-report` added to all workflows so report JSON appears in the shared log.
+
+**Architecture preserved:** subprocess CLI calls via `SubprocessRunner`, shared `mTcRunner`/`mTcLog`/status. No new integration style introduced.
+
+**Build validated:** `[100%] Built target spatialroot_gui`.
+
+---
+
 ## Offline Renderer Source Split (May 8, 2026)
 
 **Status:** Complete. Non-destructive source-layout separation only.