chore: Decouple browse-cli release cycle from stagehand core
Merged
SH
8mo ago+132+132+012345678901234567890123456789-0-0-0123456789
Summary
- Adds
@browserbasehq/browse-clito the changesetignorelist so the main "Version Packages" PR no longer includes CLI version bumps - Creates a new
release-cli.ymlworkflow (triggered viaworkflow_dispatch) that independently versions and publishes browse-cli to npm
How it works
Main release flow (release.yml) — unchanged, but now skips browse-cli. Core stagehand changesets are versioned and published as before.
CLI release flow (release-cli.yml) — triggered manually via GitHub Actions "Run workflow":
- Detects pending browse-cli changesets (fails early if a changeset mixes browse-cli with other packages)
- Temporarily swaps the changeset ignore config to version only browse-cli
- Runs
changeset versionto consume CLI changesets and bumppackages/cli/package.json - Builds all packages, publishes browse-cli to npm via Trusted Publishing
- Commits the version bump and pushes a git tag
Constraints
- Changesets that reference both browse-cli and another package (e.g., stagehand core) must be split into separate changeset files — the workflow enforces this with a pre-check
- browse-cli is excluded from canary (
alpha) releases — add a canary step torelease-cli.ymlif needed later
Test plan
- Verify existing
release.ymlstill creates "Version Packages" PR for core changesets (browse-cli changesets should be excluded) - Trigger
release-cli.ymlvia workflow_dispatch with a pending browse-cli changeset and verify it publishes correctly - Verify mixed changeset detection fails the workflow with a clear error
🤖 Generated with Claude Code
Summary by cubic
Decouples the @browserbasehq/browse-cli release cycle from stagehand core so we can ship CLI updates independently. Implements STG-1663.
-
New Features
- Adds
@browserbasehq/browse-clito.changesetignore sorelease.ymlskips CLI. - Adds
release-cli.yml(manual viaworkflow_dispatch, restricted tomain) to version and publish CLI with Trusted Publishing. - Pre-checks for CLI-only changesets; fails on mixed changesets.
- Temporarily swaps
.changesetignore to version only CLI and strips the@browserbasehq/stagehandworkspace dep beforechangeset versionto satisfy Changesets; restores both after. - Builds and publishes
packages/clito npm, commits the bump, and tags.
- Adds
-
Migration
- Split changesets that touch CLI and core.
- Use the “Release CLI” workflow to publish CLI releases.
- Canary releases for CLI are not included.