Skip to content

RELEASE.md

Latest commit

 

History

History
64 lines (43 loc) · 2.31 KB

RELEASE.md

File metadata and controls

64 lines (43 loc) · 2.31 KB

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.

For local AMD64 Arch builds without Docker, see packaging/aur/README.md.

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.