release: Release v0.3.0 by pedronauck · Pull Request #263 · compozy/compozy

pedronauck · 2026-07-28T01:50:46Z

Release v0.3.0

This PR prepares the release of version v0.3.0.

Changelog

0.3.0 - 2026-07-28

🎉 Features

Introducing CompozyOS beta
BREAKING: introducing CompozyOS beta

🐛 Bug Fixes

(cli) Reap leaked test daemons and artifacts (fix(cli): reap leaked test daemons and artifacts #253)
Archive without tasks
Resolve inherited cross-runtime models against runtime defaults (fix: resolve inherited cross-runtime models against runtime defaults #259)

Release Notes

Breaking Changes

The OS Release

Compozy v0.3 is a new operating system boundary for agent work. Sessions, tasks, loops, memory,
permissions, automation, the OS shell, and Compozy Network now share one daemon-owned state model.
People can start and inspect that work from the web, CLI, HTTP/SSE, or UDS. Agents can operate the
same runtime through structured tools and extension contracts.
This is a breaking beta. The command, package, environment, storage, API, and tool namespaces move
to Compozy, and several v0.2 surfaces have deliberate replacements or removals. Follow the
v0.3 migration guide before replacing an existing install.
The maintained v0.2 line and its collateral remain on legacy/v0.2.
Install the beta through the verified hosted installer, @compozy/cli@beta, or the explicit
github.com/compozy/[email protected] Go version. The beta channel may change before v0.3.0
stable; production rollouts should pin the version and review each prerelease.
The repository was already MIT licensed. v0.3 corrects stale BSL-1.1 text in distribution metadata;
it does not relicense the code.

vercel · 2026-07-28T01:50:53Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
compozy-site	Ready	Preview, Comment	Jul 28, 2026 4:10am

coderabbitai · 2026-07-28T01:51:29Z

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

@coderabbitai resume to resume automatic reviews.
@coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

▶️ Resume reviews
🔍 Trigger review

Walkthrough

The direct github.com/compozy/compozy-web-assets dependency in go.mod is upgraded from v0.0.2 to v0.0.7.

Changes

Web assets dependency

Layer / File(s)	Summary
Update web assets requirement `go.mod`	The required `github.com/compozy/compozy-web-assets` version changes from `v0.0.2` to `v0.0.7`.

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

Suggested labels: release

🚥 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 identifies the v0.3.0 release preparation, which matches the PR's stated release-focused changes.

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch release/v0.3.0

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.}

greptile-apps · 2026-07-28T01:53:18Z

Greptile Summary

Prepares the v0.3.0 beta release metadata and distribution inputs.

Adds the v0.3.0 changelog, release body, release notes, and archived OS release narrative.
Updates the root package version to 0.3.0.
Upgrades the embedded web-assets Go module from v0.0.2 to v0.0.8.

Confidence Score: 3/5

The PR is not yet safe to merge because later beta publications would advertise an outdated installation version and the changelog still links to a stable tag that is not created.

The workflow increments beta tags dynamically, but the release body fixes its Go installation command to beta.1, while the committed changelog comparison continues to target v0.3.0 instead of the beta tag actually published.

Files Needing Attention: RELEASE_BODY.md, CHANGELOG.md

Important Files Changed

Filename	Overview
RELEASE_BODY.md	Replaces the prior release body with v0.3 release content, but its fixed beta.1 installation command becomes stale on subsequent beta publications.
CHANGELOG.md	Rebuilds release history and adds v0.3.0, while the previously reported stable-tag comparison remains unresolved.
RELEASE_NOTES.md	Prepends the v0.3.0 release notes and migration narrative.
package.json	Updates the release base version from 0.0.9 to 0.3.0.
go.mod	Upgrades compozy-web-assets from v0.0.2 to v0.0.8 with matching checksums.

_{Reviews (6): Last reviewed commit: "release: prepare release v0.3.0" | Re-trigger Greptile}

pedronauck · 2026-07-28T02:08:11Z

✅ Dry-Run Completed Successfully

📊 Build Summary

Version: 0.0.0-1785203922
Commit: 18332c7

📦 Built Artifacts

Not available.

This is an automated comment from the release dry-run check.

pedronauck · 2026-07-28T02:39:34Z

✅ Dry-Run Completed Successfully

📊 Build Summary

Version: 0.0.0-1785205799
Commit: 9430fc8

📦 Built Artifacts

Not available.

This is an automated comment from the release dry-run check.

greptile-apps · 2026-07-28T03:51:49Z

@@ -1,41 +1,51 @@
-## 0.0.9 - 2026-07-04
+## 0.3.0 - 2026-07-28


Release body advertises stable version

When the beta release workflow passes RELEASE_BODY.md directly to GoReleaser, this heading labels the v0.3.0-beta.N prerelease as stable 0.3.0, causing the published release body to contradict its tag, prerelease metadata, and beta installation instructions.

pedronauck · 2026-07-28T04:07:00Z

✅ Dry-Run Completed Successfully

📊 Build Summary

Version: 0.0.0-1785211049
Commit: 62beeeb

📦 Built Artifacts

Not available.

This is an automated comment from the release dry-run check.

greptile-apps · 2026-07-28T04:09:10Z

Want your agent to iterate on Greptile's feedback? Try greploops.

greptile-apps · 2026-07-28T04:09:14Z


-##### Clearer native tool errors and availability diagnostics
+Install the beta through the verified hosted installer, `@compozy/cli@beta`, or the explicit
+`github.com/compozy/[email protected]` Go version. The beta channel may change before v0.3.0


Installation version becomes stale

When v0.3.0-beta.1 already exists, the auto-beta workflow publishes a later beta but rewrites only this file's heading, leaving the installation command fixed at v0.3.0-beta.1 and directing users to install the older prerelease.

pedronauck · 2026-07-28T04:24:17Z

✅ Dry-Run Completed Successfully

📊 Build Summary

Version: 0.0.0-1785212097
Commit: 691f857