Skip to content
Melange v0.9.0

Melange v0.9.0

August 17, 2026·pthm
pthm

Melange v0.9.0 restructures the repository into a cleaner module layout and, as part of that, changes how the CLI is installed. There are no runtime or generated-SQL changes — your Check and List call sites, and the SQL melange migrate emits, are unchanged.

Breaking: the CLI install path changed. Install with go install github.com/pthm/melange@latest — the old go install github.com/pthm/melange/cmd/melange@latest no longer works. See Migration below.

What changed

  • The CLI now lives in the root module. cmd/melange has been collapsed into the repository root and retired to a deprecated error-shim; its prior versions are retracted. Installing or building the CLI now uses the root module path.
  • Internal packages are sealed. The old lib/ tree moved under internal/, so only melange’s own code depends on it. The public surface is the melange runtime package and the CLI — nothing else is importable.
  • The test suite is its own module. test/ was extracted into a separate module so its heavy test-only dependencies (the OpenFGA oracle, testcontainers) no longer weigh on anyone importing the runtime.
  • Release plumbing simplified. The redundant VERSION file and the three-stage cmd/melange publish step were dropped.

Migration

Update how you install the CLI:

# Old (no longer works)
go install github.com/pthm/melange/cmd/melange@latest

# New
go install github.com/pthm/melange@latest

Homebrew, the container image, and the .deb / .rpm packages are unaffected:

brew install pthm/melange/melange
docker pull ghcr.io/pthm/melange:v0.9.0

The Go runtime import path is unchanged:

go get github.com/pthm/melange/melange@v0.9.0

There are no schema, API, or generated-SQL changes in this release — nothing to re-migrate.

Feedback

Open an issue for bug reports or feature requests.