The open-source app everyone uses to manage agents at work
TypeScript acpxagent-orchestrationagent-skillsagentic-aiai-agentsai-engineeringai-governanceai-toolsautonomous-agentsclaudeclaude-codeclaude-skillscodexhermesllmmcpmulti-agentopenclawproject-managementworkflow-automation
chore: simplify release preflight workflow
Dotta30ee59c3241d
diff --git a/doc/RELEASING.md b/doc/RELEASING.mdindex 7b6b69e8dd..bd7314cefc 100644--- a/doc/RELEASING.md+++ b/doc/RELEASING.md@@ -42,9 +42,6 @@ claude -p "Use the release-changelog skill to draft or update releases/v${VERSIO# 4. Smoke test what users will actually installPAPERCLIPAI_VERSION=canary ./scripts/docker-onboard-smoke.sh-# Optional: have preflight run the onboarding smoke immediately afterward-./scripts/release-preflight.sh canary patch --onboard-smoke --onboard-host-port 3232 --onboard-data-dir ./data/release-preflight-canary-# Users install with:npx paperclipai@canary onboard```@@ -123,6 +120,14 @@ This is the best existing fit when you want:- a dedicated host port- an end-to-end `npx paperclipai ... onboard` check+If you want to exercise onboarding from a fresh local checkout rather than npm, use:++```bash+./scripts/clean-onboard-git.sh+```++That is not a required release step every time, but it is a useful higher-confidence check when onboarding is the main risk area or when you need to verify what the current codebase does before publishing.+### GitHub Actions releaseThere is also a manual workflow at [`.github/workflows/release.yml`](../.github/workflows/release.yml). It is designed for npm trusted publishing via GitHub OIDC instead of long-lived npm tokens.@@ -328,12 +333,17 @@ Run the actual install path in Docker:PAPERCLIPAI_VERSION=canary ./scripts/docker-onboard-smoke.sh```-If you want it tied directly to preflight, you can append:+Useful isolated variants:++```bash+HOST_PORT=3232 DATA_DIR=./data/release-smoke-canary PAPERCLIPAI_VERSION=canary ./scripts/docker-onboard-smoke.sh+HOST_PORT=3233 DATA_DIR=./data/release-smoke-stable PAPERCLIPAI_VERSION=latest ./scripts/docker-onboard-smoke.sh+```++If you want to smoke onboarding from the current codebase rather than npm, run:```bash-./scripts/release-preflight.sh canary <patch|minor|major> --onboard-smoke-./scripts/release-preflight.sh canary <patch|minor|major> --onboard-smoke --onboard-host-port 3232 --onboard-data-dir ./data/release-preflight-canary-./scripts/release-preflight.sh stable <patch|minor|major> --onboard-smoke --onboard-host-port 3233 --onboard-data-dir ./data/release-preflight-stable+./scripts/clean-onboard-git.sh```Minimum checks:diff --git a/scripts/release-preflight.sh b/scripts/release-preflight.shindex 4b68cbb355..84faf5b227 100755--- a/scripts/release-preflight.sh+++ b/scripts/release-preflight.sh@@ -6,23 +6,15 @@ export GIT_PAGER=catchannel=""bump_type=""-run_onboard_smoke=false-onboard_version=""-onboard_host_port=""-onboard_data_dir=""usage() {cat <<'EOF'Usage:- ./scripts/release-preflight.sh <canary|stable> <patch|minor|major> [--onboard-smoke]- [--onboard-version <version-or-tag>]- [--onboard-host-port <port>]- [--onboard-data-dir <path>]+ ./scripts/release-preflight.sh <canary|stable> <patch|minor|major>Examples:./scripts/release-preflight.sh canary patch./scripts/release-preflight.sh stable minor- ./scripts/release-preflight.sh canary minor --onboard-smoke --onboard-version canary --onboard-host-port 3232What it does:- verifies the git worktree is clean, including untracked files@@ -33,7 +25,6 @@ What it does:pnpm -r typecheckpnpm test:runpnpm build- - optionally runs scripts/docker-onboard-smoke.sh afterwardEOF}@@ -43,33 +34,6 @@ while [ $# -gt 0 ]; dousageexit 0;;- --onboard-smoke)- run_onboard_smoke=true- ;;- --onboard-version)- shift- if [ $# -eq 0 ]; then- echo "Error: --onboard-version requires a value." >&2- exit 1- fi- onboard_version="$1"- ;;- --onboard-host-port)- shift- if [ $# -eq 0 ]; then- echo "Error: --onboard-host-port requires a value." >&2- exit 1- fi- onboard_host_port="$1"- ;;- --onboard-data-dir)- shift- if [ $# -eq 0 ]; then- echo "Error: --onboard-data-dir requires a value." >&2- exit 1- fi- onboard_data_dir="$1"- ;;*)if [ -z "$channel" ]; thenchannel="$1"@@ -168,14 +132,6 @@ fiTARGET_STABLE_VERSION="$(compute_bumped_version "$CURRENT_STABLE_VERSION" "$bump_type")"TARGET_CANARY_VERSION="$(next_canary_version "$TARGET_STABLE_VERSION")"-if [ "$run_onboard_smoke" = true ] && [ -z "$onboard_version" ]; then- if [ "$channel" = "canary" ]; then- onboard_version="canary"- else- onboard_version="latest"- fi-fi-if [ -n "$(git -C "$REPO_ROOT" status --porcelain)" ]; thenecho "Error: working tree is not clean. Commit, stash, or remove changes before releasing." >&2exit 1@@ -202,16 +158,6 @@ if [ "$channel" = "canary" ]; thenecho " Next canary version: $TARGET_CANARY_VERSION"echo " Guard: canaries are always derived from the next stable version, never ${CURRENT_STABLE_VERSION}-canary.N"fi-if [ "$run_onboard_smoke" = true ]; then- echo " Post-check: onboarding smoke enabled"- echo " Onboarding smoke version/tag: $onboard_version"- if [ -n "$onboard_host_port" ]; then- echo " Onboarding smoke host port: $onboard_host_port"- fi- if [ -n "$onboard_data_dir" ]; then- echo " Onboarding smoke data dir: $onboard_data_dir"- fi-fiecho ""echo "==> Working tree"@@ -246,25 +192,6 @@ pnpm test:runpnpm buildecho ""-if [ "$run_onboard_smoke" = true ]; then- echo "==> Optional onboarding smoke"- smoke_cmd=(env "PAPERCLIPAI_VERSION=$onboard_version")- if [ -n "$onboard_host_port" ]; then- smoke_cmd+=("HOST_PORT=$onboard_host_port")- fi- if [ -n "$onboard_data_dir" ]; then- smoke_cmd+=("DATA_DIR=$onboard_data_dir")- fi- smoke_cmd+=("$REPO_ROOT/scripts/docker-onboard-smoke.sh")- printf ' Running:'- for arg in "${smoke_cmd[@]}"; do- printf ' %q' "$arg"- done- printf '\n'- "${smoke_cmd[@]}"- echo ""-fi-echo "==> Release preflight summary"echo " Channel: $channel"echo " Bump: $bump_type"@@ -275,15 +202,6 @@ if [ "$channel" = "canary" ]; thenecho " Next canary version: $TARGET_CANARY_VERSION"echo " Guard: canaries are always derived from the next stable version, never ${CURRENT_STABLE_VERSION}-canary.N"fi-if [ "$run_onboard_smoke" = true ]; then- echo " Onboarding smoke version/tag: $onboard_version"- if [ -n "$onboard_host_port" ]; then- echo " Onboarding smoke host port: $onboard_host_port"- fi- if [ -n "$onboard_data_dir" ]; then- echo " Onboarding smoke data dir: $onboard_data_dir"- fi-fiecho ""echo "Preflight passed for $channel release."