Skip to content

chore: prepare release 1.0.0#380

Open
umair-ably wants to merge 3 commits intomainfrom
release/v1.0.0
Open

chore: prepare release 1.0.0#380
umair-ably wants to merge 3 commits intomainfrom
release/v1.0.0

Conversation

@umair-ably
Copy link
Copy Markdown
Collaborator

Summary

  • Bump @ably/cli and @ably/react-web-cli from 0.17.01.0.0
  • Add [1.0.0] - 2026-05-01 entry to CHANGELOG.md summarising user-facing changes since v0.17.0 (109 PRs, ~457 commits)

This is the first stable major release. The CHANGELOG covers OAuth Device Authorization login, the unified --force flag for destructive operations, the structured JSON output envelope with status/completed signals, error hint fields, new command groups (chat mutations, push publish, annotations, expanded spaces, integrations, mutable-message channel rules), the breaking removal of auth flags, the move of primary entity identifiers from --name/--channel/etc. flags to positional arguments, and standardised pagination, time-range flags, and error handling. Migration notes are included.

Test plan

  • pnpm prepare (build + manifest)
  • pnpm generate-doc
  • pnpm exec eslint . — 0 errors
  • pnpm test:unit — 2372 passed, 1 todo, 1 skipped
  • Reviewer to confirm CHANGELOG accurately reflects shipped behaviour
  • After merge: tag v1.0.0 on main to trigger release.yml (npm publish) and release-web-cli.yml

@vercel
Copy link
Copy Markdown

vercel Bot commented May 1, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
cli-web-cli Ready Ready Preview, Comment May 1, 2026 11:50am

Request Review

@claude-code-ably-assistant
Copy link
Copy Markdown

Walkthrough

This PR prepares the first stable major release (1.0.0) of @ably/cli and @ably/react-web-cli, bumping both packages from 0.17.0. It adds a comprehensive CHANGELOG.md entry that consolidates ~109 PRs and ~457 commits since v0.17.0, covering every user-facing change, and includes migration notes for users upgrading from v0.x.

Changes

Area Files Summary
Docs CHANGELOG.md New [1.0.0] - 2026-05-01 section: Added/Changed/Fixed/Removed entries + migration notes
Config package.json Version bump 0.17.0 → 1.0.0 for @ably/cli
Config packages/react-web-cli/package.json Version bump 0.17.0 → 1.0.0 for @ably/react-web-cli

Review Notes

  • Release trigger: After merge, v1.0.0 must be tagged manually on main to trigger release.yml (npm publish) and release-web-cli.yml — not automated by this PR.
  • CHANGELOG accuracy: The PR author explicitly flags this for reviewer attention — confirm the CHANGELOG accurately reflects all shipped behaviour across the ~457 commits it summarises.
  • Three breaking changes are called out in migration notes: auth flags removed (--api-key/--token/--access-token), primary entity identifiers moved from flags to positional args, and JSON output envelope restructured. Any downstream tooling or documentation outside this repo will need updating.
  • No code changes: This is purely a version bump + changelog entry; no new logic, tests, or dependencies are introduced.

@umair-ably
Copy link
Copy Markdown
Collaborator Author

waiting for #373 before this can be merged

Comment thread CHANGELOG.md

## [1.0.0] - 2026-05-01

First stable release. This is a large release that overhauls authentication, command argument conventions, output formatting, and adds several new command groups. Key user-facing changes are summarised below; review the migration notes before upgrading.
Copy link
Copy Markdown
Contributor

@sacOO7 sacOO7 May 1, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Had a question, we didn't include any points from proposed changelog entry at https://ably-real-time.slack.com/archives/C09M25LCZLP/p1777559095294669?thread_ts=1777545682.860959&cid=C09M25LCZLP , is this intentional?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah that's for changelog.ably.com

Copy link
Copy Markdown
Contributor

@sacOO7 sacOO7 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor CHANGELOG comments

Comment thread CHANGELOG.md Outdated
umair-ably and others added 2 commits May 1, 2026 12:45
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1.0.0 is the first stable release. Remove the formatReleaseStatus
helper and replace its callers in the help banner and interactive
welcome with a plain "Version X" line. Drop the now-duplicate version
line from `ably version` and `--version` (already covered by
formatVersionString).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds a BREAKING entry alongside the other v1.0.0 breaking items and a
matching migration step covering the removal of the TOKEN positional in
favour of --client-id / --revocation-key.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants