From e2c08ad3a741055860c637ac146163df9246d44f Mon Sep 17 00:00:00 2001 From: patramsey Date: Thu, 20 Aug 2026 12:16:16 -0600 Subject: [PATCH] docs: prepare the v0.3.0 release MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fifteen user-facing changes since v0.2.4, from #39 and #41. Minor rather than patch because of the exit codes. Invocation mistakes — a bad flag value, an unknown record type, a missing required flag — used to exit 1, indistinguishable from an API or runtime failure, and now exit 2 as the documented table has always claimed. That is a fix, but it is one a script can be depending on, so it gets a note at the top of the section rather than a line buried under Fixed. The release also adds --wide, which is a feature and a minor bump on its own. The rest is what the audit turned up: a mistyped subcommand that exited 0, tables that overflowed an 80-column terminal, credentials that existed being reported as missing, seven list commands that could page forever, a 429 with a long Retry-After that decayed into a timeout, error bodies echoed at 20 KB, and one idempotency key shared across every write in an invocation. Only CHANGELOG.md changes; the build version comes from the tag. --- CHANGELOG.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 20b6569..f347c2e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,16 @@ Releases before `0.2.0` predate this file. Their notes are on the ## [Unreleased] +## [0.3.0] - 2026-08-20 + +Minor rather than patch because of one behavioural change worth checking before +upgrading: **invocation mistakes now exit 2 instead of 1.** A bad flag value, an +unknown record type, a missing required flag — all of these previously exited 1, +the same code as an API or runtime failure, and now exit 2 as the documented +table has always said. A script branching on exit 1 to detect "the command was +wrong" needs to look for 2. Nothing else in this release changes an exit code, +and no command changes what it sends to the API. + ### Added - `--wide` keeps every table column even when the table is wider than the terminal. @@ -176,7 +186,8 @@ Releases before `0.2.0` predate this file. Their notes are on the [#9](https://github.com/patramsey/namecom-cli/pull/9) and [#10](https://github.com/patramsey/namecom-cli/pull/10) for the commits. -[Unreleased]: https://github.com/patramsey/namecom-cli/compare/v0.2.4...HEAD +[Unreleased]: https://github.com/patramsey/namecom-cli/compare/v0.3.0...HEAD +[0.3.0]: https://github.com/patramsey/namecom-cli/compare/v0.2.4...v0.3.0 [0.2.4]: https://github.com/patramsey/namecom-cli/compare/v0.2.3...v0.2.4 [0.2.3]: https://github.com/patramsey/namecom-cli/compare/v0.2.2...v0.2.3 [0.2.2]: https://github.com/patramsey/namecom-cli/compare/v0.2.1...v0.2.2