Summary of Changes

Hello, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request performs a routine release for version v2.18.3, primarily by updating a wide array of dependencies across both the Rust and JavaScript ecosystems. It ensures that the project's various components and their lock files reflect the latest stable dependency versions, and updates internal version references in documentation and configuration.

Highlights

• Version Bump: The project's version has been updated to v2.18.3 across various configuration and documentation files.
• Rust Dependency Updates: Several Rust dependencies, including getrandom, jiff, jiff-static, quote, and r-efi, have been updated to newer versions in Cargo.lock.
• JavaScript Dependency Updates: Numerous Node.js dependencies, such as @iconify-json/simple-icons, caniuse-lite, electron-to-chromium, flatted, node-releases, postcss, and vitepress, have been updated in pnpm-lock.yaml.
• Changelog Entry: A new entry for v2.18.3 has been added to the CHANGELOG.md, specifically noting an update to the actions/setup-node digest.

Greptile Summary

This is a fully automated v3.0.0 release PR, generated by the tasks/release-plz script. The major version bump is justified by the breaking spec change (feat!(spec)) introduced in #542 — cliff.toml has breaking_always_bump_major = true and the release script explicitly handles this via git cliff --bumped-version.

Key changes:

• Version bump — usage-lib and usage-cli moved from 2.18.2 → 3.0.0 across Cargo.toml, cli/Cargo.toml, lib/Cargo.toml, Cargo.lock, the generated KDL spec, and both documentation reference files. clap_usage is intentionally held at 2.0.3 per the --exclude clap_usage flag in the release script.
• Cargo.lock refresh — cargo update pulled in routine minor/patch bumps: clap 4.5→4.6, roff 1.0.0→1.1.0, zerocopy 0.8.40→0.8.42, getrandom 0.4.1→0.4.2, and several others — all within their semver-compatible ranges defined in the manifests.
• pnpm-lock.yaml refresh — pnpm update upgraded eslint 10.0.2→10.0.3 (matching the tightened ^10.0.3 specifier in package.json) and bumped a number of @algolia/* and postcss transitive dependencies.
• Generated artifacts — cli/usage.usage.kdl, docs/cli/reference/commands.json, and docs/cli/reference/index.md were all regenerated by mise run render and reflect only the version string change.

Confidence Score: 5/5

• This PR is safe to merge — it is a clean, fully automated release commit with no hand-written logic changes.
• Every change is either a version string update, a cargo update/pnpm update lock file refresh, or an auto-regenerated documentation artifact. The major-version jump from 2.x to 3.0.0 is correct and intentional (triggered by the feat! breaking change in feat!(spec): add support for license, before/after help metadata #542). All version numbers are consistent across manifests and generated files. The clap_usage exclusion from the version bump is confirmed intentional by the release script. No source code logic was modified.
• No files require special attention.

Important Files Changed

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["push to main\n(after PR merge)"] --> B["release-plz workflow"]
    B --> C{"Is v3.0.0\nalready tagged?"}
    C -- "No (first run)" --> D["cargo publish -p usage-lib\ncargo publish -p usage-cli"]
    D --> E["git tag v3.0.0\ngit push --tags"]
    E --> F["publish-cli.yml\ntriggered on v* tag"]
    F --> G["create-release job\n(draft GitHub Release)"]
    G --> H["build-and-publish job\n(cross-compile binaries\nfor 7 targets)"]
    H --> I["release job\n(undraft GitHub Release)"]
    I --> J["enhance-release job\n(communique AI summary)"]
    C -- "Yes (subsequent runs)" --> K["git cliff --bumped-version\n→ calculate next version"]
    K --> L["Update CHANGELOG.md\nbump versions\nregen docs"]
    L --> M["Open/update\n'release' branch PR"]

_{Last reviewed commit: b44d9bb}

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 77.94%. Comparing base (84a198c) to head (b10aaa3).

@@           Coverage Diff           @@
##             main     #527   +/-   ##
=======================================
  Coverage   77.94%   77.94%           
=======================================
  Files          48       48           
  Lines        6682     6682           
  Branches     6682     6682           
=======================================
  Hits         5208     5208           
  Misses       1114     1114           
  Partials      360      360           

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

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	npm/​eslint@​10.0.2 ⏵ 10.0.3	+1
	cargo/​roff@​1.0.0 ⏵ 1.1.0

View full report