Problem
The quickstart docs show a clean expected output for `conductor workflow start -w hello_workflow --sync`:
```json
{
"summary": "Host orkes-api-sampler-... responded in 0 ms with random value 1141",
"apiResponse": { ... }
}
```
The actual output is a ~100-line JSON blob containing full task execution details, timing, poll counts, worker IDs, etc. The workflow output values are in there (nested under `"output"`), but a new user has no way to know that — they see a wall of JSON that looks nothing like the docs.
Actual output structure
```json
{
"createTime": 1774492657451,
"output": {
"apiResponse": { ... },
"summary": "Host ... responded in 0 ms with random value 3363"
},
"requestId": "...",
"responseType": "TARGET_WORKFLOW",
"status": "COMPLETED",
"targetWorkflowId": "...",
"tasks": [ ... 80+ lines ... ]
}
```
Fix options
- CLI: Add a
--output-only or --quiet flag to `workflow start --sync` that prints only `output` field
- Docs: Show the actual full output (or a truncated version with `...`) so users know what to expect
- CLI: Default `--sync` to printing only the workflow output, with a flag to show full details
Affects
- `conductor-oss/conductor-cli` (UX)
- `conductor-oss/conductor` docs/quickstart/index.md
Problem
The quickstart docs show a clean expected output for `conductor workflow start -w hello_workflow --sync`:
```json
{
"summary": "Host orkes-api-sampler-... responded in 0 ms with random value 1141",
"apiResponse": { ... }
}
```
The actual output is a ~100-line JSON blob containing full task execution details, timing, poll counts, worker IDs, etc. The workflow output values are in there (nested under `"output"`), but a new user has no way to know that — they see a wall of JSON that looks nothing like the docs.
Actual output structure
```json
{
"createTime": 1774492657451,
"output": {
"apiResponse": { ... },
"summary": "Host ... responded in 0 ms with random value 3363"
},
"requestId": "...",
"responseType": "TARGET_WORKFLOW",
"status": "COMPLETED",
"targetWorkflowId": "...",
"tasks": [ ... 80+ lines ... ]
}
```
Fix options
--output-onlyor--quietflag to `workflow start --sync` that prints only `output` fieldAffects