docs: document supervised TUI Logs streaming

Document real-time log streaming behavior in supervised TUI and add an Unreleased changelog entry. Note that stdout/stderr forwarding can be disabled via ROBOPPI_TUI_STREAM_STDIO=0.

Author: reoring

CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to this project will be documented in this file.
 
 The format is based on Keep a Changelog, and this project follows SemVer where practical.
 
+## [Unreleased]
+
+### Added
+
+- Supervised workflow TUI now streams worker events to `2: Logs` in real time (stdout/stderr/progress/patch) via IPC `job_event` messages.
+
+### Changed
+
+- In supervised + TUI mode, stdout/stderr forwarding to `2: Logs` is enabled by default; set `ROBOPPI_TUI_STREAM_STDIO=0` to forward progress/patch only.
+
 ## [0.1.5] - 2026-02-25
 
 ### Added

README.ja.md

@@ -99,6 +99,11 @@ JSON Lines IPC サーバーを起動します（stdin を読み、stdout に応
 workflow runner で実行します。デフォルトは supervised 実行（Core IPC 経由）です。
 Core を介さず runner が直接 worker を spawn する場合は `--direct` を使います。
 
+TUI について:
+
+- stderr が TTY のとき TUI は自動で有効です（無効化: `--no-tui`）。
+- supervised + TUI では `2: Logs` に worker のリアルタイム出力（stdout/stderr/progress/patch）が表示されます。stdout/stderr を転送したくない場合は `ROBOPPI_TUI_STREAM_STDIO=0` を設定してください。
+
 ```bash
 ./roboppi workflow examples/hello-world.yaml --verbose
 # (dev) bun run src/workflow/run.ts examples/hello-world.yaml --verbose

README.md

@@ -107,6 +107,11 @@ Workflows are executed by the workflow runner.
 By default, workflows run in supervised mode (Supervisor -> Core -> Worker).
 Use `--direct` to spawn workers directly from the runner (no Core IPC).
 
+TUI notes:
+
+- TUI is enabled by default when stderr is a TTY (disable with `--no-tui`).
+- In supervised + TUI mode, `2: Logs` shows real-time worker output (stdout/stderr/progress/patch). To disable stdout/stderr forwarding, set `ROBOPPI_TUI_STREAM_STDIO=0`.
+
 ```bash
 ROBOPPI_VERBOSE=1 bun run src/workflow/run.ts examples/agent-pr-loop.yaml \
   --workspace /tmp/my-work --verbose

docs/guide/quickstart.md

@@ -401,6 +401,11 @@ roboppi workflow my-workflow.yaml --verbose
 # (dev) bun run src/workflow/run.ts my-workflow.yaml --verbose
 ```
 
+TUI notes:
+
+- TUI is enabled by default when stderr is a TTY (disable with `--no-tui`).
+- In supervised + TUI mode, `2: Logs` shows real-time worker output (stdout/stderr/progress/patch). To disable stdout/stderr forwarding, set `ROBOPPI_TUI_STREAM_STDIO=0`.
+
 For each step, Roboppi Core requests a Permit, delegates to the worker, and collects results. If a step fails, it aborts depending on policy.
 
 ### Reuse worker settings with agent catalogs

docs/guide/workflow.md

@@ -579,13 +579,22 @@ Use `--direct` to spawn worker processes directly from the runner (no Core IPC).
 | `--supervised` | - | supervised mode: delegate steps via Core IPC (Supervisor -> Core -> Worker) | on |
 | `--direct` | - | direct mode: spawn worker processes directly (no Core IPC) | off |
 | `--no-supervised` | - | alias for `--direct` | - |
+| `--tui` | - | force-enable the interactive workflow TUI (renders to stderr) | auto |
+| `--no-tui` | - | disable the TUI (plain output) | auto |
 | `--keepalive` | - | emit periodic output to avoid no-output watchdogs | auto (on when non-TTY) |
 | `--no-keepalive` | - | disable keepalive output | - |
 | `--keepalive-interval <d>` | - | keepalive interval (DurationString) | `10s` |
 | `--ipc-request-timeout <d>` | - | IPC request timeout for supervised mode (DurationString) | `2m` |
 | `--agents <path>` | - | agent catalog YAML (repeatable); merged with `ROBOPPI_AGENTS_FILE` | auto-load `agents.yaml` / `agents.yml` next to workflow |
 | `--help` | `-h` | show help | - |
 
+### TUI logs streaming (supervised)
+
+When running in supervised mode with TUI enabled, the `2: Logs` tab shows real-time worker output (stdout/stderr/progress/patch).
+
+- Default: stdout/stderr are forwarded.
+- Opt-out: set `ROBOPPI_TUI_STREAM_STDIO=0` to forward progress/patch only.
+
 ### Examples
 
 ```bash

docs/quickstart.ja.md

@@ -211,6 +211,11 @@ bun run --cwd "$AGENTCORE_ROOT" src/workflow/run.ts \
   --supervised --verbose
 ```
 
+TUI について:
+
+- stderr が TTY のとき TUI は自動で有効です（無効化: `--no-tui`）。
+- supervised + TUI では `2: Logs` に worker のリアルタイム出力（stdout/stderr/progress/patch）が表示されます。stdout/stderr を転送したくない場合は `ROBOPPI_TUI_STREAM_STDIO=0` を設定してください。
+
 ### 引数の説明
 
 | 引数 | 説明 |

docs/quickstart.md

@@ -212,6 +212,11 @@ bun run --cwd "$AGENTCORE_ROOT" src/workflow/run.ts \
   --supervised --verbose
 ```
 
+TUI notes:
+
+- TUI is enabled by default when stderr is a TTY (disable with `--no-tui`).
+- In supervised + TUI mode, `2: Logs` shows real-time worker output (stdout/stderr/progress/patch). To disable stdout/stderr forwarding, set `ROBOPPI_TUI_STREAM_STDIO=0`.
+
 ### Arguments
 
 | Argument | Description |