v0.2.0

RoleWeave 0.2.0

This release brings the goal-centered collaboration spine, the Windows WSL runtime for projects and Agent hosts, and the refined employee workspace and avatar workflow to the desktop installers, together with the model-slug and conversation-viewport fixes. Its changelog section also assigns user-visible work that already shipped in the v0.1.2 installers but was never assigned to a release there — the RoleWeave light/dark theme, the Codex Agent hosts, the model line, and the collapsible execution status row — which the v0.1.2 publisher-handoff paragraph anticipated.

Changes

• Goals are a first-class module: declare a goal, associate personal sessions, group chats and turns with it, and review the goal with its related work in one place. The goals contract and API are new, and the surface is bilingual.
• Windows can run the project backend and Agent hosts in a local WSL distribution while keeping the Windows interface. A runtime preference selects the distribution, the project picker starts from its Linux home, and the backend uses Linux Node with a built-in adapter that preserves the Linux CLI's login, proxy and certificate configuration. Cross-distribution selection is rejected.
• First launch starts from an empty workspace: the demo workspace is no longer copied or opened automatically. A previously opened workspace is restored when accessible, explicit overrides are preserved, and existing demo and user files stay untouched.
• Employee and project setup is simplified. Each employee or project binds one Agent with model selection; memory and session collaboration surfaces and conversation routing are new; employee avatars support upload, preset and AI-generation entry points.
• Local doc and mem services get a unified Docker management surface (initialize, verify, start, status/logs, stop) and connect as independent HTTP services: settings store an encrypted token, verify the actual API contract and open the upstream native UI. Source-based tooling pins the upstream commit and preserves history and persistent data paths.
• The Codex service-credential and local-login Agent hosts, the model line under hosts with a model knob, the RoleWeave light/dark theme and the collapsible execution status row are assigned to this release's changelog section; they were already present in the v0.1.2 installers.
• Long model names ellipsize on one line instead of wrapping, and switching employees preserves the conversation panel's scroll viewport.
• Codex turns no longer become unreadable records after write; the report center's audit timeline uses the conversation panel's engine-label source; Codex readiness requires the built-in engine boundary; the local Claude Host no longer offers a bare settings source that disables OAuth reuse.
• Workspace override paths skip local existence checks only in the Windows WSL control-plane mode, and the control-plane switch accepts the RoleWeave-named ROLEWEAVE_CONTROL_PLANE_MODE variable while preserving the legacy name.
• The free macOS GitHub update channel remains part of the package: the release workflow signs ZIP metadata with an Ed25519 key, and the client verifies it before background download and replacement on normal exit.

This packet is reviewed against main revision 971519b06ee24ee4a794b999a174729ea4260c9f. The post-v0.1.2 commits are #235 (goal spine, tracked by #222), #262 (Windows WSL runtime), #265 (employee workspace and avatar workflow), #250 (model-slug ellipsis, tracked by #245), and #252 (conversation viewport, tracked by #234), plus the maintenance commits #266 (design-system pin bump), #268 (unreferenced session-surface removal) and #229 (CodeQL pinned-version annotations), which need no user-facing bullets. Version metadata and frozen-notes publication safeguards are release preparation in #271, not additional runtime features.

Downloads

• macOS Apple Silicon: roleweave-0.2.0-arm64.dmg and roleweave-0.2.0-arm64.zip.
• Windows x64: roleweave-0.2.0-x64.exe.
• Intel Mac and Linux installers are not included.

Installation and updates

macOS packages are not Apple Developer ID-signed or notarized; Windows packages are not Authenticode-signed. The operating system may show a security prompt on installation or first launch.

The macOS app verifies an independently signed update manifest, downloads updates in the background and replaces the app on normal exit. Windows can check the existing Electron update channel, but unsigned builds keep in-app download and install disabled without a publisher identity; use the Windows installer manually. Publishing this release exposes its metadata to clients checking those channels.

CI covers native builds, packaged startup and layout, and installer asset integrity. Installation, uninstallation and cross-version automatic updates on user machines are not claimed as fully verified end to end. Users of older Org Workbench development builds need to install RoleWeave manually once.

Publisher handoff

Before allocating the annotated tag, recheck the final main-to-v0.1.2 delta and update these notes in the reviewed release commit if that delta changed. Required review, protected merge, exact-commit checks and the ByteFolk release process still apply.

The workflow reads docs/releases/vVERSION.md from its frozen release commit. The first line must be # RoleWeave VERSION, followed by a nonempty body. It carries the exact bytes in a separate notes artifact, checks their SHA-256 before creating the draft, and passes them with --notes-file; no manual draft-body edit is required. Notes are not included in the installer asset inventory.

Tag pushes and manual dispatches with draft=false publish only after asset readback; manual dispatches with draft=true leave a draft. Do not rely on the transient draft during a tag-push run as a manual editing window. This preparation does not itself allocate a tag or publish a release. Roll back through a reviewed source revert before publication; never replace published assets or move a published tag.