Files
openwork/RELEASE.md
ben 6284b581f7 chore: rename openwrk to openwork-orchestrator (#573)
* chore(orchestrator): rename openwrk to openwork-orchestrator

Rename the host package and internal references from openwrk to openwork-orchestrator, and expose the CLI as 'openwork'.

Update desktop/UI runtime wiring, release workflows, and docs; bundle the Tauri sidecar as 'openwork-orchestrator' to avoid Cargo package name collisions.

* chore: keep orchestrator publish script executable

* chore: update pnpm lockfile

* chore: sync lockfile with orchestrator deps

* docs: update orchestrator usage + release notes

Document that openwork-orchestrator installs the 'openwork' CLI, update release command wording, and remove obsolete workflow branch trigger.
2026-02-15 14:24:42 -08:00

63 lines
2.2 KiB
Markdown

# Release checklist
OpenWork releases should be deterministic, easy to reproduce, and fully verifiable with CLI tooling.
## Preflight
- Sync the default branch (currently `dev`).
- Run `pnpm release:review` and fix any mismatches.
- If you are building sidecar assets, set `SOURCE_DATE_EPOCH` to the tag timestamp for deterministic manifests.
## App release (desktop)
1. Bump versions (app + desktop + Tauri + Cargo):
- `pnpm bump:patch` or `pnpm bump:minor` or `pnpm bump:major`
2. Re-run `pnpm release:review`.
3. Build sidecars for the desktop bundle:
- `pnpm --filter @different-ai/openwork prepare:sidecar`
4. Commit the version bump.
5. Tag and push:
- `git tag vX.Y.Z`
- `git push origin vX.Y.Z`
## openwork-orchestrator (npm + sidecars)
1. Bump versions (includes `packages/orchestrator/package.json`):
- `pnpm bump:patch` or `pnpm bump:minor` or `pnpm bump:major`
2. Build sidecar assets and manifest:
- `pnpm --filter openwork-orchestrator build:sidecars`
3. Create the GitHub release for sidecars:
- `gh release create openwork-orchestrator-vX.Y.Z packages/orchestrator/dist/sidecars/* --repo different-ai/openwork`
4. Publish the package:
- `pnpm --filter openwork-orchestrator publish --access public`
## openwork-server + opencode-router (if version changed)
- `pnpm --filter openwork-server publish --access public`
- `pnpm --filter opencode-router publish --access public`
## Verification
- `openwork start --workspace /path/to/workspace --check --check-events`
- `gh run list --repo different-ai/openwork --workflow "Release App" --limit 5`
- `gh release view vX.Y.Z --repo different-ai/openwork`
Use `pnpm release:review --json` when automating these checks in scripts or agents.
## AUR
`Release App` publishes the Arch AUR package automatically after the Linux `.deb` asset is uploaded.
Required repo config:
- GitHub Actions secret: `AUR_SSH_PRIVATE_KEY` (SSH key with push access to the AUR package repo)
- Optional repo variable: `AUR_REPO` (defaults to `openwork`)
## npm publishing
If you want `Release App` to publish `openwork-orchestrator`, `openwork-server`, and `opencode-router` to npm, configure:
- GitHub Actions secret: `NPM_TOKEN` (npm automation token)
If `NPM_TOKEN` is not set, the npm publish job is skipped.