open-azdo 0.3.2 → 0.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -51,6 +51,19 @@ Optional flags:
51
51
  - `--dry-run`
52
52
  - `--json`
53
53
 
54
+ ## Output And Logging
55
+
56
+ Operational logs are pretty, colorized, and written to `stderr` by default so humans can follow the run in local terminals and CI job logs.
57
+ The final command result stays on `stdout`.
58
+
59
+ Use `--json` when you want fully machine-readable output:
60
+
61
+ - command results stay on `stdout` as JSON
62
+ - operational logs stay on `stderr` as JSON
63
+ - `review` and `sandbox capture` both follow the same contract
64
+
65
+ During OpenCode execution, `open-azdo` now emits live progress milestones such as session start, retries, tool start/completion, todo-plan updates, and session errors. Raw assistant text deltas and full tool outputs are intentionally omitted from default logs to keep them readable.
66
+
54
67
  ## Sandbox Capture
55
68
 
56
69
  Use the live capture command when you want to validate changes against a real Azure DevOps pull request without mutating PR threads:
@@ -99,6 +112,7 @@ Exit behavior:
99
112
 
100
113
  - successful review runs return `0`, even when findings are posted
101
114
  - operational failures return non-zero
115
+ - logs always use `stderr`; results always use `stdout`
102
116
 
103
117
  ## Azure Pipelines
104
118