docs: add CHANGELOG for the new management commands#180
Conversation
Documents the 0.1.93 (project/billing/org/backup/key management) and 0.1.94 (billing checkout/portal + project transfer) feature releases in Keep a Changelog format. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Walkthrough
ChangesCHANGELOG updates
Estimated code review effort🎯 1 (Trivial) | ⏱️ ~3 minutes Poem
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
Greptile SummaryAdds a new
Confidence Score: 4/5Safe to merge after confirming the correct version for the The only substantive concern is a potential version misattribution: CHANGELOG.md — specifically the 'Billing inspection' bullet under 0.1.94. Important Files Changed
Reviews (1): Last reviewed commit: "docs: add CHANGELOG covering the new man..." | Re-trigger Greptile |
| - **Billing inspection** — `billing history` (past payments/invoices) and | ||
| `billing cycles` (current and previous billing-cycle windows). |
There was a problem hiding this comment.
Billing inspection commands may be misattributed to 0.1.94
The PR description explicitly states that 0.1.93 (PR #175) covers "billing/usage inspection," while 0.1.94 (PR #176) covers only "billing checkout/portal management and projects transfer." The "Billing inspection" bullet (billing history, billing cycles) is placed here under 0.1.94 but looks like it belongs in 0.1.93 alongside billing status and billing credits. If these commands were actually shipped in #176 this is fine, but it conflicts with the description above — worth verifying against the source PRs.
Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!
jwfing
left a comment
There was a problem hiding this comment.
Summary
Docs-only PR adding a new CHANGELOG.md (Keep a Changelog format) for releases 0.1.93 and 0.1.94; I verified every documented command, flag, guard, date, and version attribution against the source tree and git tags — all accurate.
Requirements context
No matching spec/plan found under a /docs/superpowers/ directory (it doesn't exist in this repo). The repo keeps specs in docs/specs/, but the three present (diagnose-command, db-migrations) are unrelated to a changelog. Assessed against the PR description, the referenced PRs (#175, #176), and the actual shipped CLI surface.
Findings
Critical
(none)
Suggestion
- Software engineering / accuracy —
CHANGELOG.md:43-44: the version links point atreleases/tag/v0.1.9x. Both tags exist, so the links resolve, but the Keep a Changelog convention this file declares it follows (CHANGELOG.md:3-5) usescompare/<prev>...<this>diff ranges for the link reference section. Switching to compare links (or keeping tag links deliberately) is a minor consistency call — non-blocking.
Information
- Accuracy (verified, no action needed) — Spot-checked the full surface; all of it is correct:
billing upgrade <plan>/manage— both open the hosted Stripe URL viaopen()and, under--json, print the session object and skip the browser (src/commands/billing/index.ts:157-205). Matches the description exactly.billing history/cyclesare correctly attributed to 0.1.94 — they were introduced inf0c0755(#176) and are absent from thev0.1.93tag, which only carriesstatus/credits. Good version split.projects transfer <targetOrgId>andprojects deleteboth force an explicit--project(resolveProjectId(opts, true)) and gate on a confirm prompt (src/commands/projects/manage.ts:118-200) — the "requires an explicit--projectand is guarded for human approval" wording is accurate.projects update-version --waitandbackups create --waitflags exist as described (src/commands/projects/manage.ts:219-222,src/commands/backups/index.ts:95-99).secrets rotate <api-key|anon-key>validates the key against['api-key','anon-key']and exposes--grace-hours(the "optional grace period") —src/commands/secrets/rotate.ts:10-31.- The Changed entry is real: at
v0.1.92both groups wereprogram.command('orgs'/'projects', { hidden: true }); thehiddenflag was dropped inv0.1.93, so they now appear in--help. - Dates are correct:
v0.1.94tagged 2026-06-24,v0.1.93tagged 2026-06-23 — matching the## [0.1.94] - 2026-06-24/## [0.1.93] - 2026-06-23headers.
- Security — No security-relevant changes; this is documentation only, no secrets or tokens introduced.
- Performance — No performance-relevant changes; documentation only.
- Scope — Clean, single-file, additive (+45/-0). Explicitly scopes out internal telemetry (#177), which is the right call for a user-facing changelog.
Verdict
approved (informational — a human still gives the explicit GitHub approval). Zero Critical findings; the lone Suggestion is an optional link-format consistency tweak. Accurate, well-scoped documentation.
Summary
Adds a
CHANGELOG.md(Keep a Changelog format) covering the two feature releases that built out the CLI's management surface:projects transfer(#176)Documents user-facing features only; internal telemetry coverage (#177) is omitted.
🤖 Generated with Claude Code
Summary by cubic
Adds
CHANGELOG.mdfor@insforge/cli, documenting 0.1.93 and 0.1.94 in Keep a Changelog format.Highlights new management commands: project lifecycle, billing (checkout/portal, status/credits/cycles/history), organizations and members, backups, secrets rotation, storage S3 keys,
projects transfer, and--helpupdates.Written for commit afd8ca0. Summary will update on new commits.
Note
Add CHANGELOG entries for releases 0.1.93 and 0.1.94
Adds a CHANGELOG.md documenting the new management commands introduced in releases 0.1.93 and 0.1.94, with links to the corresponding GitHub release tags.
Macroscope summarized afd8ca0.
Summary by CodeRabbit
orgsandprojectscommand groups now appear in help output.