Skip to content

v1.3.0: Commands declare their effect on the world - #242

Merged
jdx merged 1 commit into
mainfrom
release-plz-2026-07-26T01-02-33Z
Aug 2, 2026
Merged

jdx merged 1 commit into
mainfrom
release-plz-2026-07-26T01-02-33Z

Conversation

@jdx

@jdx jdx commented Jul 26, 2026 •

Copy link
Copy Markdown
Owner

This release teaches communique's usage spec what each command does to the world — read, write, or destructive — so tools built on the spec can tell a safe inspection from a state-changing one. It also picks up progress-display fixes from clx v3.

Added

  • (usage) Every communique command now carries an effect annotation in its usage spec, distinguishing read-only commands from those that modify or destroy state. generate and sponsors are read; init is write; and the flags that actually change things are raised accordingly — --changelog, --github-release, and --output on generate are write, and init --force is destructive. Because effect is per-command, generate is classified as read at its floor while its state-changing flags carry the higher effect (the effect of an invocation is the maximum of the command and its supplied flags). The regenerated communique.usage.kdl and docs/cli reflect these labels. (#240) (@jdx)

Changed

  • Updated clx to v3 for progress-display fixes: cursor escape sequences are no longer written in text or quiet mode, and a reflowed frame is now cleared after a terminal resize. (#248)

Full Changelog: https://github.com/jdx/communique/commits/v1.3.0


Note

Low Risk
Version and documentation-only changes with no runtime logic in this diff.

Overview
Cuts release v1.3.0 by bumping the crate and generated CLI metadata from 1.2.4 to 1.3.0 in Cargo.toml, Cargo.lock, communique.usage.kdl, and docs/cli.

Updates CHANGELOG.md with a dated [1.3.0] section documenting the shipped work (usage read/write/destructive effects and clx v3 progress fixes), while [Unreleased] still only lists the upcoming default model bump to claude-opus-4-8.

Reviewed by Cursor Bugbot for commit 169db15. Bugbot is set up for automated code reviews on this repo. Configure here.

Summary by CodeRabbit

  • New Features

    • CLI usage specifications now identify each command’s world effects: read, write, or destructive.
  • Changed

    • Updated the CLI to version 1.3.0.
    • Text and quiet modes no longer emit cursor escape sequences.
    • Reflowed frames are cleared after terminal resizing.
    • Updated displayed version information across CLI documentation and metadata.

Copilot AI review requested due to automatic review settings July 26, 2026 01:02
@coderabbitai

coderabbitai Bot commented Jul 26, 2026 •

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

The project version is bumped from 1.2.4 to 1.3.0, with matching updates to the changelog, CLI usage specification, generated command metadata, and CLI documentation.

Changes

1.3.0 release update

Layer / File(s) Summary
Release declaration and changelog
Cargo.toml, CHANGELOG.md
The crate version is set to 1.3.0, and a dated 1.3.0 release entry documents CLI world-effects and clx v3 changes.
CLI metadata and documentation synchronization
communique.usage.kdl, docs/cli/commands.json, docs/cli/index.md
CLI usage data, command metadata, and displayed documentation versions are updated from 1.2.4 to 1.3.0.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Poem

A bunny bumps the version bright,
From twelve-four to thirteen’s light.
The docs and specs now match the tune,
Changelog flowers in July’s moon.
Hop, release, and code balloon!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the release and the new command effect annotations.

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

Comment @coderabbitai help to get the list of available commands.

@jdx jdx changed the title chore: release v1.2.4 v1.2.4: Keep draft release tags intact Jul 26, 2026
@jdx
jdx force-pushed the release-plz-2026-07-26T01-02-33Z branch from 89a5994 to ca551d5 Compare July 26, 2026 01:03

Copilot AI 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.

Pull request overview

Cuts the automated v1.2.4 release for communique (1.2.3 → 1.2.4) by updating the changelog with the release notes generated by release-plz.

Changes:

  • Adds a 1.2.4 changelog entry documenting the GitHub draft-release tag preservation fix and assorted dependency/CI housekeeping entries.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread CHANGELOG.md Outdated
Comment on lines +102 to +121
## [1.2.4](https://github.com/jdx/communique/compare/v1.2.3...v1.2.4) - 2026-07-26

### Fixed

- *(github)* keep a draft release's tag when rewriting its notes ([#241](https://github.com/jdx/communique/pull/241))

### Other

- Keep draft release tags intact ([#238](https://github.com/jdx/communique/pull/238))
- *(deps)* update jdx/mise-action digest to f10502f ([#239](https://github.com/jdx/communique/pull/239))
- *(deps)* update actions/setup-node action to v7 ([#237](https://github.com/jdx/communique/pull/237))
- *(deps)* update release-plz/action action to v0.5.131 ([#234](https://github.com/jdx/communique/pull/234))
- *(deps)* update dependency vue to v3.5.40 ([#233](https://github.com/jdx/communique/pull/233))
- *(deps)* update rust crate clx to v2.1.1 ([#235](https://github.com/jdx/communique/pull/235))
- *(deps)* update zizmorcore/zizmor-action action to v0.6.0 ([#236](https://github.com/jdx/communique/pull/236))
- *(deps)* update actions/checkout digest to 3d3c42e ([#231](https://github.com/jdx/communique/pull/231))
- *(deps)* update taiki-e/setup-cross-toolchain-action digest to 12b7ad4 ([#232](https://github.com/jdx/communique/pull/232))
- *(deps)* lock file maintenance ([#230](https://github.com/jdx/communique/pull/230))
- *(deps)* update jdx/mise-action digest to dad1bfd ([#229](https://github.com/jdx/communique/pull/229))

@codecov

codecov Bot commented Jul 26, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.01%. Comparing base (344c1ec) to head (169db15).

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #242   +/-   ##
=======================================
  Coverage   95.01%   95.01%           
=======================================
  Files          27       27           
  Lines        5501     5501           
  Branches     5501     5501           
=======================================
  Hits         5227     5227           
  Misses        172      172           
  Partials      102      102           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@greptile-apps

greptile-apps Bot commented Jul 26, 2026 •

Copy link
Copy Markdown

Greptile Summary

Updates release metadata for version 1.3.0.

  • Bumps the package, lockfile, usage specification, and generated CLI documentation from 1.2.4 to 1.3.0.
  • Adds the 1.3.0 release notes to the changelog.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename Overview
CHANGELOG.md Adds the v1.3.0 release section; the previously reported duplicate v1.2.4 section is no longer present.
Cargo.toml Bumps the package version from 1.2.4 to 1.3.0.
Cargo.lock Synchronizes the root package version with Cargo.toml.
communique.usage.kdl Updates the generated usage specification version to 1.3.0.
docs/cli/commands.json Updates the generated CLI metadata version to 1.3.0.
docs/cli/index.md Updates the documented CLI version to 1.3.0.

Reviews (8): Last reviewed commit: "chore: release v1.3.0" | Re-trigger Greptile

Comment thread CHANGELOG.md Resolved
@jdx jdx changed the title v1.2.4: Keep draft release tags intact chore: release v1.3.0 Jul 27, 2026
@jdx
jdx force-pushed the release-plz-2026-07-26T01-02-33Z branch from ca551d5 to f20635e Compare July 27, 2026 00:36
@jdx jdx changed the title chore: release v1.3.0 v1.3.0: Commands declare their effect on the world Jul 27, 2026
@jdx
jdx force-pushed the release-plz-2026-07-26T01-02-33Z branch from f20635e to 900e364 Compare July 27, 2026 00:37
@jdx jdx changed the title v1.3.0: Commands declare their effect on the world chore: release v1.3.0 Jul 27, 2026
@jdx
jdx force-pushed the release-plz-2026-07-26T01-02-33Z branch from 900e364 to bf27077 Compare July 27, 2026 00:43
@jdx jdx changed the title chore: release v1.3.0 v1.3.0: Commands declare their effect on the world Jul 27, 2026
@jdx
jdx force-pushed the release-plz-2026-07-26T01-02-33Z branch from bf27077 to 86fe147 Compare July 27, 2026 00:44
@jdx jdx changed the title v1.3.0: Commands declare their effect on the world chore: release v1.3.0 Jul 27, 2026
@jdx
jdx force-pushed the release-plz-2026-07-26T01-02-33Z branch from 86fe147 to 5f9ccd3 Compare July 27, 2026 00:44
@jdx jdx changed the title chore: release v1.3.0 v1.3.0: Commands declare their effect on the world Jul 27, 2026
@jdx
jdx force-pushed the release-plz-2026-07-26T01-02-33Z branch from 5f9ccd3 to 22bc691 Compare July 27, 2026 00:45
@jdx jdx changed the title v1.3.0: Commands declare their effect on the world chore: release v1.3.0 Jul 27, 2026
@jdx
jdx force-pushed the release-plz-2026-07-26T01-02-33Z branch from 22bc691 to 1888177 Compare July 27, 2026 13:17
@jdx jdx changed the title chore: release v1.3.0 v1.3.0: Commands declare their effect on the world Jul 27, 2026
@jdx
jdx force-pushed the release-plz-2026-07-26T01-02-33Z branch from 1888177 to 259c797 Compare July 27, 2026 13:19

@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: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@CHANGELOG.md`:
- Line 20: Resolve the duplicate ## Changed heading in CHANGELOG.md by either
configuring changelog-specific markdownlint handling for duplicate headings or
restructuring the headings so each heading is unique, while preserving the
existing changelog sections and content.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Central YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: a8373787-f3b3-4c43-873b-67a02f47849c

📥 Commits

Reviewing files that changed from the base of the PR and between f1531fb and 259c797.

⛔ Files ignored due to path filters (1)
  • Cargo.lock is excluded by !**/*.lock
📒 Files selected for processing (5)
  • CHANGELOG.md
  • Cargo.toml
  • communique.usage.kdl
  • docs/cli/commands.json
  • docs/cli/index.md

Comment thread CHANGELOG.md Resolved
@jdx jdx changed the title v1.3.0: Commands declare their effect on the world chore: release v1.3.0 Jul 27, 2026
@jdx
jdx force-pushed the release-plz-2026-07-26T01-02-33Z branch from 259c797 to 850cdcb Compare July 27, 2026 13:46
@jdx jdx changed the title chore: release v1.3.0 v1.3.0: Commands declare their effect on the world Jul 27, 2026
@jdx
jdx force-pushed the release-plz-2026-07-26T01-02-33Z branch from 850cdcb to 5cae18d Compare July 27, 2026 13:47
@jdx jdx changed the title v1.3.0: Commands declare their effect on the world chore: release v1.3.0 Jul 28, 2026
@jdx
jdx force-pushed the release-plz-2026-07-26T01-02-33Z branch from 5cae18d to cb1af67 Compare July 28, 2026 04:07
@jdx jdx changed the title chore: release v1.3.0 v1.3.0: Commands declare their effect on the world Jul 28, 2026
@jdx
jdx force-pushed the release-plz-2026-07-26T01-02-33Z branch from cb1af67 to ad91b8e Compare July 28, 2026 04:08
@jdx jdx changed the title v1.3.0: Commands declare their effect on the world chore: release v1.3.0 Jul 28, 2026
@jdx
jdx force-pushed the release-plz-2026-07-26T01-02-33Z branch from ad91b8e to a079ef7 Compare July 28, 2026 14:20
@jdx jdx changed the title chore: release v1.3.0 v1.3.0: Commands declare their effect on the world Jul 28, 2026
@jdx
jdx force-pushed the release-plz-2026-07-26T01-02-33Z branch from a079ef7 to 169db15 Compare July 28, 2026 14:21
@jdx
jdx merged commit e279fb2 into main Aug 2, 2026
9 checks passed
@jdx
jdx deleted the release-plz-2026-07-26T01-02-33Z branch August 2, 2026 10:32
@jdx jdx mentioned this pull request Aug 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants