Changed for scripts: every `--json` invocation now prints exactly one document on stdout
(CLI-SPEC §6), with prompts, previews-before-a-prompt and prose on stderr (X5). The preview and
then the summary used to be two documents, so `pipdock install x --json | ConvertFrom-Json`
failed on the second. The document is: the ResolutionReport when nothing runs (a dry run, an
empty plan, a declined prompt - exit 2), the ExecutionSummary when something does, the FlowStep
when there is nothing to plan, the GuardReport for a refused removal (with --force, only the
summary), and the entity itself for env use, pin add/remove, snapshot create, engine and
pip-upgrade ({before, after}). Prompts moved to stderr in both modes.
- `env use` is honoured (X3): --env, then the default it set, then a .venv here - as --env's help
always said. It was written and never read. A default whose interpreter is gone is said and
skipped. The help line says "the one `env use` set" now (32 help snapshots re-blessed for that
line alone).
- Ctrl-C (and Ctrl-Break, which a supervisor can send) trips the flow's token (X6): the engine's
process tree is killed, what ran is summarized with the snapshot to roll back to, and the exit
is 130; a second press quits at once. Verified against a resolve hung on a server that never
answers: exit 130 the instant the signal arrived, no python left running.
- `update` with neither names nor --all exits 2 instead of planning nothing (X16); `audit` uses
--engine (X14); `engine` needs no environment (X15); `doctor` judges the configured engine, not
pip, so a uv-only venv passes (no pip is the uv default); an impossibility skipped off a TTY says
what and why (X26); `list` probes once instead of twice (X28); names and versions honour
`{:<32}` (X27); `snapshot diff` compares the way a rollback would across engines.
Verified with a script driving the real binary through each of these: every stdout parses as one
JSON document and every exit matches CLI-SPEC §5.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>