Skip to content

release: prepare 0.10 release#62

Merged
AndyTWF merged 1 commit into
mainfrom
release/0.10.0
Jul 24, 2025
Merged

release: prepare 0.10 release#62
AndyTWF merged 1 commit into
mainfrom
release/0.10.0

Conversation

@AndyTWF

@AndyTWF AndyTWF commented Jul 24, 2025

Copy link
Copy Markdown
Contributor

Summary by CodeRabbit

  • Documentation

    • Updated the changelog and README to reflect the new 0.10.0 release.
    • Documented the renaming of the chat room reactions command from "add" to "send" and introduced the new --count flag for sending multiple reactions.
    • Updated usage examples and command references to match the latest changes.
  • Chores

    • Bumped the CLI version to 0.10.0.

@AndyTWF AndyTWF requested a review from owenpearson July 24, 2025 13:44
@coderabbitai

coderabbitai Bot commented Jul 24, 2025

Copy link
Copy Markdown

Walkthrough

This update increments the CLI version to 0.10.0 across documentation and configuration files. It renames the rooms messages reactions add command to rooms messages reactions send, updates related documentation, and reflects the new version in all references. The changelog records these changes and a session storage fix.

Changes

File(s) Change Summary
CHANGELOG.md Added 0.10.0 entry: new endpoint option, reactions command rename, session storage race fix.
README.md Updated version references to 0.10.0; renamed reaction command from add to send; doc updates.
package.json Bumped package version from 0.9.0 to 0.10.0.

Sequence Diagram(s)

sequenceDiagram
    User->>CLI: ably rooms messages reactions send
    CLI->>Ably API: Send reaction with parameters (including --count if specified)
    Ably API-->>CLI: Acknowledge reaction sent
    CLI-->>User: Output result
Loading

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

Poem

Hopping along, a new version appears,
With "add" now "send," the command is clear.
Docs are refreshed, the changelog is neat,
Version ten’s milestone—oh, what a treat!
🐇✨

Note

⚡️ Unit Test Generation is now available in beta!

Learn more here, or try it out under "Finishing Touches" below.

✨ Finishing Touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch release/0.10.0

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Explain this complex logic.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai generate unit tests to generate unit tests for this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@vercel

vercel Bot commented Jul 24, 2025

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
cli-web-cli ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jul 24, 2025 1:45pm

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🔭 Outside diff range comments (2)
CHANGELOG.md (1)

432-433: Bullet appears truncated.

Line 432 ends abruptly after ably channels occupancy – looks like half a sentence survived a merge. Please restore or remove to avoid confusion.

README.md (1)

3549-3553: Stale example still refers to the removed “add” sub-command

The example block still shows:

$ ably rooms messages reactions add my-room "message-id" "👍"

This contradicts the new send syntax and will confuse users.

-$ ably rooms messages reactions add my-room "message-id" "👍"
+$ ably rooms messages reactions send my-room "<MESSAGE_SERIAL>" "👍"
🧹 Nitpick comments (3)
CHANGELOG.md (1)

20-20: Minor nit – missing period.

For consistency with the rest of the file, consider terminating the sentence with a period.

- - Race conditions in session storage to ensure smoother reconnection and consistent handling
+ - Race conditions in session storage to ensure smoother reconnection and consistent handling.
README.md (2)

3624-3632: Add language spec to fenced code block

markdownlint MD040 is triggered because the code fence directly under “Remove a reaction …” lacks a language tag.

-```
+```sh

3672-3680: Same MD040 violation for the new send example

Apply the same fix here:

-```
+```sh

This keeps lint clean and enables syntax highlighting.

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between a3cecd1 and f5e52fc.

📒 Files selected for processing (3)
  • CHANGELOG.md (2 hunks)
  • README.md (131 hunks)
  • package.json (1 hunks)
🧰 Additional context used
📓 Path-based instructions (1)
{README.md,docs/**,.cursor/rules/**}

📄 CodeRabbit Inference Engine (.cursor/rules/Development.mdc)

Update all relevant documentation, including README.md, files within the docs/ directory, and files within the .cursor/rules/ directory if the changes impact requirements, structure, testing procedures, development guidelines, Ably usage, or project structure.

Files:

  • README.md
🧠 Learnings (3)
package.json (14)

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Workflow.mdc:0-0
Timestamp: 2025-07-07T21:07:13.973Z
Learning: Execute pnpm prepare to ensure TypeScript compiles, oclif.manifest.json is updated, and README.md reflects command changes. Check for build errors in the output and ensure oclif.manifest.json and README.md changes (if any) are sensible.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Development.mdc:0-0
Timestamp: 2025-07-07T21:07:00.723Z
Learning: Run pnpm prepare to ensure the TypeScript code compiles successfully, the oclif.manifest.json is updated, and the README.md reflects any command changes before considering any task complete.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Development.mdc:0-0
Timestamp: 2025-07-07T21:07:00.723Z
Learning: Applies to package.json : Avoid unnecessary dependencies; keep dependencies to a pragmatic minimum.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Workflow.mdc:0-0
Timestamp: 2025-07-24T13:09:58.495Z
Learning: Before considering any task complete, you MUST run pnpm prepare to ensure TypeScript compiles, oclif.manifest.json is updated, and README.md reflects command changes. Verify build output for errors and sensible changes.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Development.mdc:0-0
Timestamp: 2025-07-24T13:09:42.990Z
Learning: If you want the oclif.manifest.json file to be updated and the README.md to be regenerated to reflect the command structure too, use pnpm prepare.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Development.mdc:0-0
Timestamp: 2025-07-07T21:07:00.723Z
Learning: If you want the oclif.manifest.json file to be updated and the README.md to be regenerated to reflect the command structure, use pnpm prepare.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Development.mdc:0-0
Timestamp: 2025-07-07T21:07:00.723Z
Learning: Applies to package.json : When installing libraries, do not pick a version manually in package.json; instead, use a script (e.g., pnpm add -D <package>) to install the latest version.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/AI-Assistance.mdc:0-0
Timestamp: 2025-07-24T13:09:23.307Z
Learning: The CLI is focused on Ably services - do not suggest features outside this scope.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Ably.mdc:0-0
Timestamp: 2025-07-24T13:09:29.835Z
Learning: The CLI will always use the relevant product Ably SDKs for all data plane commands.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Ably.mdc:0-0
Timestamp: 2025-07-07T21:06:41.172Z
Learning: The CLI must always use the relevant product Ably SDKs for all data plane commands.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Ably.mdc:0-0
Timestamp: 2025-07-07T21:06:41.172Z
Learning: When the Ably API reference mentions SDK version 2.0, use https://ably.com/docs/sdk/js/v2.0/ for the most up-to-date information.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Ably.mdc:0-0
Timestamp: 2025-07-24T13:09:29.835Z
Learning: When in doubt about how Ably works, refer to the Ably docs online at https://ably.com/docs to provide idiomatic suggestions in the CLI.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Ably.mdc:0-0
Timestamp: 2025-07-07T21:06:41.172Z
Learning: When in doubt about how Ably works, refer to the Ably docs online at https://ably.com/docs to provide idiomatic suggestions in the CLI.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/AI-Assistance.mdc:0-0
Timestamp: 2025-07-24T13:09:23.307Z
Learning: Applies to src/commands/**/*.ts : Do not use direct HTTP requests (e.g., fetch) for data plane APIs; use the Ably SDK instead.

CHANGELOG.md (5)

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/AI-Assistance.mdc:0-0
Timestamp: 2025-07-24T13:09:23.307Z
Learning: Applies to src/commands/**/*.ts : Do not use hardcoded endpoint URLs; use configuration values (e.g., flags.controlHost, config.controlHost) when constructing URLs.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/AI-Assistance.mdc:0-0
Timestamp: 2025-07-24T13:09:23.307Z
Learning: The CLI is focused on Ably services - do not suggest features outside this scope.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Ably.mdc:0-0
Timestamp: 2025-07-24T13:09:29.835Z
Learning: When in doubt about how Ably works, refer to the Ably docs online at https://ably.com/docs to provide idiomatic suggestions in the CLI.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Ably.mdc:0-0
Timestamp: 2025-07-07T21:06:41.172Z
Learning: When in doubt about how Ably works, refer to the Ably docs online at https://ably.com/docs to provide idiomatic suggestions in the CLI.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/AI-Assistance.mdc:0-0
Timestamp: 2025-07-24T13:09:23.307Z
Learning: Applies to src/commands/**/*.ts : Do not use direct HTTP requests (e.g., fetch) for data plane APIs; use the Ably SDK instead.

README.md (14)

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Development.mdc:0-0
Timestamp: 2025-07-07T21:07:00.723Z
Learning: Applies to {README.md,docs/,.cursor/rules/} : Update all relevant documentation, including README.md, files within the docs/ directory, and files within the .cursor/rules/ directory if changes affect requirements, structure, testing procedures, development guidelines, Ably usage, or project structure.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Development.mdc:0-0
Timestamp: 2025-07-24T13:09:42.990Z
Learning: Applies to {README.md,docs/,.cursor/rules/} : Update all relevant documentation, including README.md, files within the docs/ directory, and files within the .cursor/rules/ directory if the changes impact requirements, structure, testing procedures, development guidelines, Ably usage, or project structure.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Workflow.mdc:0-0
Timestamp: 2025-07-07T21:07:13.973Z
Learning: Review and update all relevant documentation and rule files based on your changes, including README.md, docs/*.md, .cursor/rules/*.mdc, and docs/TODO.md.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Ably.mdc:0-0
Timestamp: 2025-07-24T13:09:29.835Z
Learning: When in doubt about how Ably works, refer to the Ably docs online at https://ably.com/docs to provide idiomatic suggestions in the CLI.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Ably.mdc:0-0
Timestamp: 2025-07-07T21:06:41.172Z
Learning: When in doubt about how Ably works, refer to the Ably docs online at https://ably.com/docs to provide idiomatic suggestions in the CLI.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Ably.mdc:0-0
Timestamp: 2025-07-24T13:09:29.835Z
Learning: The CLI will always use the relevant product Ably SDKs for all data plane commands.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Ably.mdc:0-0
Timestamp: 2025-07-07T21:06:41.172Z
Learning: The CLI must always use the relevant product Ably SDKs for all data plane commands.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/AI-Assistance.mdc:0-0
Timestamp: 2025-07-24T13:09:23.307Z
Learning: The CLI is focused on Ably services - do not suggest features outside this scope.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Ably.mdc:0-0
Timestamp: 2025-07-07T21:06:41.172Z
Learning: When the Ably API reference mentions SDK version 2.0, use https://ably.com/docs/sdk/js/v2.0/ for the most up-to-date information.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/AI-Assistance.mdc:0-0
Timestamp: 2025-07-24T13:09:23.307Z
Learning: Applies to src/commands/**/*.ts : Do not use direct HTTP requests (e.g., fetch) for data plane APIs; use the Ably SDK instead.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Ably.mdc:0-0
Timestamp: 2025-07-24T13:09:29.835Z
Learning: Pay attention to the following Ably documentation: Pub/Sub guides and API references, Chat guides and API references, Spaces guides and API references, Control API docs and references, and broader platform docs.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/Ably.mdc:0-0
Timestamp: 2025-07-07T21:06:41.172Z
Learning: Pay attention to the following Ably documentation: Pub/Sub guides and API references, Chat guides and API references, Spaces guides and API references, Control API docs and references, and broader platform docs.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/AI-Assistance.mdc:0-0
Timestamp: 2025-07-24T13:09:23.307Z
Learning: Applies to src/commands/**/*.ts : Command should support auth via the standard auth helper (import { getAuth } from '../../helpers/auth') and use it in the run method.

Learnt from: CR
PR: ably/cli#0
File: .cursor/rules/AI-Assistance.mdc:0-0
Timestamp: 2025-07-24T13:09:23.307Z
Learning: Applies to **/*.test.ts : When testing, mock the Ably SDK properly by stubbing the constructor (e.g., sinon.stub(Ably, 'Rest').returns(mockClient)).

🪛 markdownlint-cli2 (0.17.2)
README.md

3627-3627: Fenced code blocks should have a language specified

(MD040, fenced-code-language)


3672-3672: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (3)
  • GitHub Check: e2e-web-cli
  • GitHub Check: e2e-cli
  • GitHub Check: test
🔇 Additional comments (4)
package.json (1)

3-3: Version bump looks fine – please run pnpm prepare and commit the regenerated artefacts.

Updating "version" to 0.10.0 is expected for the release, but remember that the manifest and README are generated from the build.
Before merging, run:

pnpm prepare

and commit any resulting changes to oclif.manifest.json / README.md so the published package is consistent.

CHANGELOG.md (1)

8-21: Changelog entry is clear – ensure docs & examples reflect the command rename.

rooms messages reactions addsend is called out here; double-check the README, usage examples and any integration tests were updated to the new spelling so users don’t hit a mismatch.

README.md (2)

30-32: Ensure version bump is propagated everywhere

The README now shows @ably/cli/0.10.0, but other artefacts (e.g., package.json badge, installation snippets in docs/ and .cursor/rules/) should all reference the same version to avoid drift.
Please run a quick grep to confirm there are no lingering 0.9. references.


180-184: Command rename propagated, but verify ancillary docs

rooms messages reactions send correctly replaces the deprecated add variant in the command index.
Double-check that:

  1. The alias add is actually removed from the CLI code (no hidden deprecated command).
  2. All deep-link anchors inside docs/ still resolve (search for #ably-rooms-messages-reactions-add).

If remnants exist they’ll 404 from the TOC.

@owenpearson owenpearson left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

lgtm 👍

@AndyTWF AndyTWF merged commit 106af1a into main Jul 24, 2025
6 checks passed
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