Skip to content

release: deliver RoleWeave v0.3.0 desktop installers #358

Closed

Description

@PeterGuy326

RoleWeave v0.3.0 delivery — R1

DEC-ROLEWEAVE-358-001 · 2026-09-18T12:07:51Z · status=in-progress

Scope and decision

Publish the RoleWeave 0.3.0 desktop distribution. Candidate baseline: d5e028472a64a39465ebcc2f0b3c8c262988cbe1 (merged PR #320, current main). The final release commit will be the reviewed release-prep PR's squash commit, recorded before allocating the tag. Version 0.3.0 and its tag are currently unused on every declared channel (tag ref and GitHub Release both absent, verified 2026-09-18).

Delta since v0.2.0 (tag peels to c51621bbae03841d679cd585b79586bfbd415ea9, PR #272): #294/#295 conversation refinements (copy, re-edit, session history, JSONC settings drafts), #292/#293 post-creation employee profile editing, #289 persistent locked Agent selection, #305/#307 conversation restart control, #308 workspace reveal in the OS file manager, #316 initialize existing folders plus rail collapse polish, #312 frequency-ordered module rail, #329/#330 native phone shell and #334/#335/#336/#337 per-platform iOS/Android/HarmonyOS shells, #328/#344 Ontology Runtime R2 contract slice, #302/#303 GitHub-operations employee team, #276 bundled WorkBuddy engine, #283 encrypted host credential settings, #246/#255 semantic color configuration, #331/#297/#298/#301/#304 simplified employee creation, #319/#320 MCP grant warnings and rejections, #309/#318 oversized-body drain reporting, #326 budget declaration visibility, #269/#270 turn timeout and indeterminate copy, #237/#251 group message expansion, #274/#278 group dismiss with quota recovery, #324/#291 localization, #285 unified visual language, #263/#264/#282 org-tree drag fixes, #287 avatar clipping, #277 hire drawer alignment, plus server refactors #254/#280/#281 and changelog housekeeping #253/#273 that need no user-facing bullets. The versioned changelog section moves the full [Unreleased] history into [0.3.0] — 2026-09-18 verbatim; old work is not relabeled as new.

No release-workflow change is required: the reviewed release.yml on main remains the release machinery.

Declared channels

Channel Scope
GitHub Release Public stable v0.3.0: roleweave-0.3.0-arm64.dmg, roleweave-0.3.0-arm64.zip, roleweave-0.3.0-x64.exe, their blockmaps, latest-mac.yml, latest.yml, latest-mac.json. Confirm every emitted asset, nonzero sizes, hashes, macOS manifest signature and public downloads.
npm N/A: root roleweave and @roleweave/desktop are private: true workspaces; the repository's release workflow distributes Electron installers, not an npm package.
GHCR N/A: this release workflow declares no container build or registry publishing channel.

Supported architectures are macOS Apple Silicon arm64 and Windows x64. Apple notarization and Windows Authenticode signing are not claimed; company-level signing decisions remain open. The macOS update manifest carries an independent Ed25519 signature; that is not Apple code signing. Publishing v0.3.0 exposes its metadata to v0.2.0 clients checking the macOS update channel.

Tag protection readback

  • immutable-release-tags (repository ruleset 22240705, active): conditions refs/tags/v* include-only; update and deletion rules; no bypass actors. Read back 2026-09-18.
  • release-tag-creation (repository ruleset 22240738, active): conditions refs/tags/v* include-only; creation rule; single bypass actor RepositoryRole admin (bypass mode: always). Read back 2026-09-18. Tag creation will be a single annotated tag by the least-privileged eligible actor after the pre-tag gate.

Acceptance and verification

  • AC-001: the release-prep PR passes all required checks on its exact final head and is squash-merged through protected main without an administrator bypass.
  • AC-002: the pre-tag gate proves the recorded squash commit resolves exactly, is reachable from origin/main, and v0.3.0 is unused as tag and release; the annotated tag v0.3.0 peels to exactly that commit.
  • AC-003: the release workflow run on the tag completes preflight, both build legs and publish; the release is public (not draft, not prerelease) and uses the frozen notes bytes.
  • AC-004: every declared asset is read back from the API (nonzero sizes, digests, restored update-metadata names) and the macOS update manifest signature is verified. No reuse or overwriting of old releases/tags.

Rollback: before publication, halt and leave this record open. If a published artifact is defective, ship a new patch version; never move an immutable tag or replace published bytes.

Revision history

  • R1 · 2026-09-18T12:07:51Z: release record opened for v0.3.0. Implementation: release-prep PR to follow. This record is not a completion claim.

Activity

  1. PeterGuy326 commented on Sep 18, 2026

    @PeterGuy326
    ContributorAuthor

    R2 — 发版准备 PR 合并记录 · 2026-09-18T12:28:41Z

    • PR: release: ship RoleWeave v0.3.0 #359 「release: ship RoleWeave v0.3.0」(squash merge)
    • head SHA: 2bc10921ffe47a2a88090f178d89e73f5dac5cc5(branch release/roleweave-v0.3.0,由 API 构建并逐字节校验等于本地提交 30d4807)
    • merge SHA: 6a74b3f8d1601ffed7d8c562ab6dc36f66964f89(现 main tip)
    • 变更范围: 6 个文件(package.json、apps/desktop/package.json、package-lock.json、CHANGELOG.md、README.md、docs/releases/v0.3.0.md),无夹带
    • PR head CI: 全部 required checks 通过 —
    • 合并方式: owner(PeterGuy326)admin bypass squash merge;与 v0.2.0 先例(release: ship goal spine and local WSL hosts in RoleWeave 0.2.0 #272,2026-09-15)一致 — main 分支保护要求 1 个 approving review,无 CODEOWNERS 指派,自动化预审无 P0/P1 且 CI 全绿。此处记录为 owner bypass merge,不构成任何人类 reviewer 的正式 approval。
    • push/main CI: 已提交 6a74b3f,run URL 与结论将在 R3 回填。
    • 下一步: push/main checks 全绿后执行预 tag 门禁(squash commit 可达性、v0.3.0 tag 未占用、tag rulesets readback),随后创建 annotated tag v0.3.0 触发 release workflow。
  2. PeterGuy326 commented on Sep 18, 2026

    @PeterGuy326
    ContributorAuthor

    R3 — 发布收据与验收 · 2026-09-18

    Release workflow(tag push 自动触发):https://github.com/bytefolk/roleweave/actions/runs/35346044031 — conclusion: success

    • Release preflight: success
    • Build (Windows-x64): success
    • Build (macOS-arm64): success
    • Publish release: success(draft → 资产回读 → tag push 自动 publish)

    Tag:annotated v0.3.0(tag object d121b80af1a2921684cf7aeea46eda8049904515)→ commit 6a74b3f8d1601ffed7d8c562ab6dc36f66964f89(R2 merge SHA,main tip)。预 tag 门禁:main push CI 全绿、tag 名未占用、rulesets 22240705 / 22240738 readback active。

    push/main CI(commit 6a74b3f):

    已发布 Release:https://github.com/bytefolk/roleweave/releases/tag/v0.3.0(draft: false,prerelease: false,published_at 2026-09-18T12:46:19Z,target main,说明文字为冻结版 docs/releases/v0.3.0.md 开头)

    资产清单(9/9,全部 uploaded,与 R1 渠道矩阵一致):

    资产 大小 (B)
    roleweave-0.3.0-arm64.dmg 129,808,223
    roleweave-0.3.0-arm64.dmg.blockmap 135,614
    roleweave-0.3.0-arm64.zip 129,687,435
    roleweave-0.3.0-arm64.zip.blockmap 135,890
    roleweave-0.3.0-x64.exe 113,148,428
    roleweave-0.3.0-x64.exe.blockmap 120,123
    latest-mac.yml 503
    latest-mac.json 460
    latest.yml 343

    AC-001..004 核验:包版本 0.3.0 与 tag 一致(preflight job 校验);三分平台安装包 + 双更新清单齐备;release 为公开非 draft;tag 不可变(immutable-release-tags ruleset 生效)。

    Known limits:安装包未签名/未公证(README 口径不变);npm/GHCR 渠道按 R1 声明为 N/A;下载计数初始为 0(刚发布)。

    发版记录关闭:R1(计划)→ R2(合并)→ R3(发布收据)齐备,标记 completed。产品侧验收(下载安装、更新通道消费)按 README 既有口径由用户实测另行反馈。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions