Skip to content

Prepare for launch - #6

Merged
mstdokumaci merged 4 commits into
mainfrom
prepare-for-release-3
Aug 4, 2026
Merged

mstdokumaci merged 4 commits into
mainfrom
prepare-for-release-3

Conversation

@mstdokumaci

@mstdokumaci mstdokumaci commented Aug 4, 2026 •

Copy link
Copy Markdown
Owner

Summary by CodeRabbit

  • New Features

    • Added automated releases with prebuilt Linux and macOS binaries for multiple platforms.
    • Added release archives with generated notes and Linux smoke testing.
    • Updated the package version to 0.3.0.
  • Documentation

    • Added a changelog covering versions 0.1.0–0.3.0.
    • Added release instructions for contributors.
    • Expanded installation, package usage, and import-ordering examples.
  • Bug Fixes

    • Builds now detect and report mismatched package and application versions.
  • Chores

    • Expanded validation across supported Zig versions.

@coderabbitai

coderabbitai Bot commented Aug 4, 2026 •

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

You’ve reached a temporary PR review limit under our Fair Usage Limits Policy.

Your recent review volume is higher than typical usage, so adaptive limits are currently applied.

Next review available in: 15 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 83c03b7c-e658-4270-afd1-bc43ce357232

📥 Commits

Reviewing files that changed from the base of the PR and between 82d8941 and cf2184a.

📒 Files selected for processing (1)
  • .github/workflows/release.yml
📝 Walkthrough

Walkthrough

The PR prepares zsort for version 0.3.0. It adds version consistency checks, re-exports AST scanner symbols, expands CI across two Zig versions, adds cross-platform release automation, and updates release documentation.

Changes

Version 0.3.0 release infrastructure

Layer / File(s) Summary
Version constant and build-time consistency check
src/version.zig, build.zig.zon, build.zig, src/zsort.zig
Adds the public version constant, updates the package version, checks both versions at compile time, and re-exports findLineEnd, Import, analyze, and class_local.
CI lint matrix
.github/workflows/ci.yml
Runs formatting and build checks on Zig 0.15.2 and 0.16.0. Runs pinned external linters only on Zig 0.15.2.
Release workflow
.github/workflows/release.yml
Builds and archives binaries for four Linux and macOS targets, smoke-tests the Linux binary, and publishes releases for version tags or manual dispatch.
Changelog and release documentation
CHANGELOG.md, CONTRIBUTING.md, README.md
Adds release notes and documents release procedures, binary downloads, dependency updates, archive hashes, artifact verification, and expanded import-ordering examples.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Trigger as Tag or manual dispatch
  participant Workflow as release.yml
  participant Zig as Zig 0.16.0
  participant GitHub as GitHub release
  Trigger->>Workflow: start release workflow
  Workflow->>Zig: build ReleaseFast binaries for four targets
  Workflow->>Workflow: create compressed archives
  Workflow->>Workflow: smoke-test Linux binary
  Workflow->>GitHub: publish archives with generated notes
Loading

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the release workflow, version updates, documentation, and launch preparation changes.
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.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch prepare-for-release-3

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

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

🤖 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 @.github/workflows/release.yml:
- Line 5: Update the workflow_dispatch configuration and release logic to
require a tag input for manual runs, validate that tag against the project
version, and use the validated input as the release tag instead of relying on
github.ref. Preserve the existing tag behavior for non-manual triggers and
ensure mismatched manual tags prevent publication.
- Around line 3-4: The release workflow currently triggers on any tag starting
with 'v' without validating that the tag version matches the actual binary
version being published. Add a validation step early in the workflow that
extracts the version from github.ref_name, compares it against the output of
zsort --version, and fails the workflow with a clear error message if they do
not match. This ensures the published binaries have a version tag that
corresponds to their actual reported version.
- Around line 7-8: Restructure the release workflow into separate build and
publish jobs: keep checkout, setup, packaging, and tests in a job with contents:
read, then pass its artifacts to a publish job limited to contents: write.
Ensure only the publish job can use write permissions, and pin every action used
by both jobs to immutable commit SHAs.

In `@CHANGELOG.md`:
- Around line 11-19: Update the CHANGELOG release notes to accurately describe
the workflows: state that binary publishing and Homebrew tap bumps occur only
for v* tag pushes, clarify that Zig gates run on 0.15.2 and 0.16 while external
linters run only on 0.15.2, say the version is declared in both build.zig.zon
and src/version.zig with a build-time consistency check, and remove AGENTS.md
from the Added list.

In `@CONTRIBUTING.md`:
- Around line 92-94: Update the contribution instructions to identify the
version fields accurately: refer to `.version` in `build.zig.zon` and `version`
in `src/version.zig`, while preserving the remaining release steps.

In `@README.md`:
- Around line 46-47: Update the comment next to the v0.3.0 archive URL in the
dependency configuration example to document the complete zig fetch command
including that URL, or reference the release procedure in CONTRIBUTING.md
instead of showing only zig fetch --save.

In `@src/zsort.zig`:
- Line 9: Change the findLineEnd alias in zsort.zig to be publicly exported so
downstream code can access zsort.findLineEnd, matching the visibility of the
other re-exported symbols.
🪄 Autofix

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: defaults

Review profile: CHILL

Plan: Pro

Run ID: 419c32a7-1ed7-4130-8b21-5dd7c8272025

📥 Commits

Reviewing files that changed from the base of the PR and between b8d88db and ea52aff.

📒 Files selected for processing (9)
  • .github/workflows/ci.yml
  • .github/workflows/release.yml
  • CHANGELOG.md
  • CONTRIBUTING.md
  • README.md
  • build.zig
  • build.zig.zon
  • src/version.zig
  • src/zsort.zig

Comment thread .github/workflows/release.yml
Comment thread .github/workflows/release.yml
Comment thread .github/workflows/release.yml Outdated
Comment thread CHANGELOG.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread README.md Outdated
Comment thread src/zsort.zig

@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 @.github/workflows/release.yml:
- Line 36: The direct interpolation of github.event.inputs.tag into the VERSION
assignment at line 36 creates a shell injection vulnerability. Move the
github.event.inputs.tag input to an environment variable (such as RELEASE_TAG)
at the job level, then update the VERSION assignment to use that environment
variable with parameter expansion (VERSION="${RELEASE_TAG#v}") to safely strip
the leading 'v' prefix. Additionally, restrict the workflow_dispatch trigger to
only run from trusted maintainers by setting appropriate permissions on the
workflow_dispatch event.
🪄 Autofix

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: defaults

Review profile: CHILL

Plan: Pro

Run ID: e550777a-93a8-4d93-a8bd-aad904f62e54

📥 Commits

Reviewing files that changed from the base of the PR and between 8bc3c99 and 82d8941.

📒 Files selected for processing (4)
  • .github/workflows/release.yml
  • CHANGELOG.md
  • CONTRIBUTING.md
  • README.md
🚧 Files skipped from review as they are similar to previous changes (3)
  • CONTRIBUTING.md
  • CHANGELOG.md
  • README.md

Comment thread .github/workflows/release.yml Outdated
@mstdokumaci
mstdokumaci merged commit c83c24b into main Aug 4, 2026
10 checks passed
@mstdokumaci
mstdokumaci deleted the prepare-for-release-3 branch August 4, 2026 11:07
This was referenced Aug 4, 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.

1 participant