Skip to content

release: 1.0.0 - #68

Merged
fadion merged 1 commit into
masterfrom
release/v1.0.0
Aug 27, 2026
Merged

fadion merged 1 commit into
masterfrom
release/v1.0.0

Conversation

@fadion

@fadion fadion commented Aug 27, 2026

Copy link
Copy Markdown
Owner

The version the binary reports. The release workflow refuses a tag that disagrees with const version, so this lands before v1.0.0 is pushed.

1.0 is a promise rather than a milestone: breaking changes start costing a major bump. docs/compatibility.md says what that covers and, more usefully, what it does not.

It's worth making now because nothing is outstanding — the 25-issue backlog is cleared, the pre-1.0 audit's findings are fixed, both remaining issues are closed, and Known Gaps holds one entry that is a performance question rather than a semantic one.

What changed

  • const version in aria.go, from 0.6.0 to 1.0.0.
  • CLAUDE.md's tag example, so it follows the constant.
  • The pretty-print example's sample config, which named the old version in data that reads as this project's own, plus its golden.

Tagging

The tag has to be v1.0.0. The workflow accepts an unprefixed tag for the sake of the pre-0.6 ones, but the module proxy does not — an unprefixed tag is why go install github.com/fadion/aria@latest spent years resolving to a 2017 pseudo-version.

226 characterization cases, 141 README blocks, 20 examples, all green.

The version the binary reports, which the release workflow refuses a tag
that disagrees with, so this lands before v1.0.0 is pushed.

1.0 is a promise rather than a milestone: breaking changes start costing a
major bump. docs/compatibility.md says what that covers and, more usefully,
what it does not -- diagnostic wording above all, since the
characterization suite records every message exactly and a reworded error
is indistinguishable in a diff from a behavior change.

The promise is worth making now because there is nothing outstanding. The
25-issue backlog is cleared, the two gaps the pre-1.0 audit turned up are
fixed, both remaining issues are closed, and Known Gaps holds one entry
that is a performance question rather than a semantic one.

What made it enforceable rather than aspirational: 226 characterization
cases, 141 README code blocks and 20 examples, all executed, so a change
that breaks a documented program cannot land quietly.

CLAUDE.md's tag example follows the constant, and the pretty-print
example's sample config named the old version in data that reads as this
project's own.

The tag has to be v1.0.0. The workflow accepts an unprefixed one for the
sake of the old tags, but the module proxy does not, and an unprefixed tag
is why `go install github.com/fadion/aria@latest` spent years resolving to
a 2017 pseudo-version.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@fadion
fadion merged commit d03394a into master Aug 27, 2026
6 checks passed
@fadion
fadion deleted the release/v1.0.0 branch August 27, 2026 21:30
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