v0.2.0

Five developer-experience audits and their remediation.

Upgrade from 0.1.0

0.1.0 contains every P0 fixed here. If you installed it, upgrading is preferred to pinning:

• a successful idea execute stranded the initiative in running forever — every later command answered "already running", with no way back short of editing the database;
• the idea text and modern provider keys (sk-ant-…, sk-proj-…, sk-svcacct-…) reached the model provider unredacted;
• a late panic rewrote a succeeded run as failed;
• the PRD stage asked a token budget no provider accepts, so every real OpenAI run failed with a 400 whose explanation the code discarded;
• idea model set silently reverted hand-edited harness.yaml at exit 0;
• a model id without a provider (gpt-4o) routed the whole workflow to the synthetic demo stub while model set, config validate and doctor all reported success.

The documented eight-command quick start also did not work on the no-key path: it did nothing, then reported ✓ initiative complete over an initiative with zero change sets. Measured back-to-back: 0 of 5 runs passed before, 5 of 5 after.

Breaking

Pre-1.0, so these land in a minor release. Each entry in the changelog states its consumer impact.

• Exit codes. Commands that printed a failure and exited 0 now exit non-zero: idea verify on an unmet gate, idea doctor on a failed check, idea daemon status when stopped, and every command given an unknown flag or subcommand. Scripts that relied on the old exit 0 will now stop.
• HTTP. POST …/change-sets/{id}/revert and POST …/execute answer 409 instead of 202 when the precondition fails; advance and revise answer 409 rather than 500; setting a disposition on a finding that does not exist answers 404 rather than 200.
• Response shapes. Empty arrays are [], not null — a client that null-checked them keeps working, one generated from openapi.yaml now works at all. The review endpoint's verdict enum is documented as the values the API actually accepts (approved/rejected), not the CLI's short forms.

Also

idea retry exists. idea new waits for the run it starts (--no-wait returns immediately). Provider errors carry the upstream message, bounded and scrubbed for credentials. Truncated model output is detected rather than silently accepted. idea version no longer reports a version that was never tagged.

Seven CI guards now check documentation and spec drift, including two added this cycle: ledger-check (defect ledgers agree with the tree) and enum-check (spec enums match the domain constants).

Full detail, including what each change means for a consumer, is in CHANGELOG.md.

Verify your download

shasum -a 256 -c checksums.txt
idea version        # v0.2.0 (e82f9c2)

Pre-1.0: the CLI surface, HTTP API and config schema may change in any release.