Skip to content

High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.

fix: dry run release and update

Luigi Agostib968591b7dbd
diff --git a/.github/workflows/publish-skill.yml b/.github/workflows/publish-skill.yml
index 8174d1b8..9d7550b5 100644
--- a/.github/workflows/publish-skill.yml
+++ b/.github/workflows/publish-skill.yml
@@ -9,6 +9,9 @@ on:
description: 'Skill version (e.g. 0.2.0, without v prefix)'
required: true
+env:
+ FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
permissions:
contents: read
@@ -17,9 +20,9 @@ jobs:
name: Publish to ClawHub
runs-on: ubuntu-latest
steps:
- - uses: actions/checkout@v4
+ - uses: actions/checkout@v5
- - uses: actions/setup-node@v4
+ - uses: actions/setup-node@v5
with:
node-version: '22'
@@ -38,7 +41,7 @@ jobs:
else
VERSION=${GITHUB_REF_NAME#v}
fi
- clawhub publish skill/pinchtab \
+ clawhub publish skills/pinchtab \
--slug pinchtab \
--name "Pinchtab" \
--version "$VERSION" \
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index aa231d1b..a9969b98 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -25,8 +25,20 @@ on:
workflow_dispatch:
inputs:
tag:
- description: 'Tag to release (e.g. v0.2.0)'
- required: true
+ description: 'Tag to release (e.g. v0.2.0). Leave empty for dry-run from ref.'
+ required: false
+ ref:
+ description: 'Git ref for dry-run testing (branch, tag, or SHA). Defaults to main.'
+ required: false
+ default: 'main'
+ dry_run:
+ description: 'Build release artifacts without publishing them.'
+ required: false
+ type: boolean
+ default: false
+
+env:
+ FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
permissions:
contents: write
@@ -37,14 +49,21 @@ jobs:
runs-on: ubuntu-latest
permissions:
contents: write
- packages: write
steps:
- - uses: actions/checkout@v4
+ - name: Validate workflow inputs
+ if: ${{ github.event_name == 'workflow_dispatch' }}
+ run: |
+ if [ "${{ inputs.dry_run }}" != "true" ] && [ -z "${{ github.event.inputs.tag }}" ]; then
+ echo "tag is required unless dry_run=true" >&2
+ exit 1
+ fi
+
+ - uses: actions/checkout@v5
with:
fetch-depth: 0
- ref: ${{ github.event.inputs.tag || github.ref }}
+ ref: ${{ github.event.inputs.tag || github.event.inputs.ref || github.ref }}
- - uses: actions/setup-go@v5
+ - uses: actions/setup-go@v6
with:
go-version: '1.26'
@@ -56,18 +75,10 @@ jobs:
working-directory: dashboard
run: bun install --frozen-lockfile
- - uses: docker/setup-buildx-action@v3
-
- - uses: docker/login-action@v3
- with:
- registry: ghcr.io
- username: ${{ github.actor }}
- password: ${{ secrets.GITHUB_TOKEN }}
-
- uses: goreleaser/goreleaser-action@v6
with:
- version: latest
- args: release --clean
+ version: '~> v2'
+ args: ${{ github.event_name == 'workflow_dispatch' && inputs.dry_run && 'release --clean --snapshot' || 'release --clean' }}
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
HOMEBREW_TAP_GITHUB_TOKEN: ${{ secrets.HOMEBREW_TAP_GITHUB_TOKEN }}
@@ -79,11 +90,11 @@ jobs:
permissions:
contents: read
steps:
- - uses: actions/checkout@v4
+ - uses: actions/checkout@v5
with:
- ref: ${{ github.event.inputs.tag || github.ref }}
+ ref: ${{ github.event.inputs.tag || github.event.inputs.ref || github.ref }}
- - uses: actions/setup-node@v4
+ - uses: actions/setup-node@v5
with:
node-version: '22'
registry-url: 'https://registry.npmjs.org'
@@ -91,11 +102,16 @@ jobs:
- name: Extract version
id: version
run: |
- TAG="${{ github.event.inputs.tag || github.ref_name }}"
- VERSION=${TAG#v} # Remove 'v' prefix
+ if [ "${{ github.event_name }}" = "workflow_dispatch" ] && [ "${{ inputs.dry_run }}" = "true" ] && [ -z "${{ github.event.inputs.tag }}" ]; then
+ VERSION=$(jq -r .version npm/package.json)
+ else
+ TAG="${{ github.event.inputs.tag || github.ref_name }}"
+ VERSION=${TAG#v} # Remove 'v' prefix
+ fi
echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
- name: Update npm package version
+ if: ${{ github.event_name != 'workflow_dispatch' || !inputs.dry_run }}
working-directory: npm
run: |
CURRENT=$(jq -r .version package.json)
@@ -114,7 +130,15 @@ jobs:
working-directory: npm
run: npm run build
+ - name: Dry-run npm publish
+ if: ${{ github.event_name == 'workflow_dispatch' && inputs.dry_run }}
+ working-directory: npm
+ run: npm publish --dry-run
+ env:
+ NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
- name: Publish to npm
+ if: ${{ github.event_name != 'workflow_dispatch' || !inputs.dry_run }}
working-directory: npm
run: npm publish
env:
@@ -123,34 +147,74 @@ jobs:
docker:
name: Docker Image
runs-on: ubuntu-latest
+ needs: release
permissions:
contents: read
- packages: read
+ packages: write
steps:
+ - uses: actions/checkout@v5
+ with:
+ ref: ${{ github.event.inputs.tag || github.event.inputs.ref || github.ref }}
+
+ - name: Extract Docker metadata
+ id: meta
+ run: |
+ if [ "${{ github.event_name }}" = "workflow_dispatch" ] && [ "${{ inputs.dry_run }}" = "true" ]; then
+ if [ -n "${{ github.event.inputs.tag }}" ]; then
+ TAG="${{ github.event.inputs.tag }}"
+ VERSION="${TAG#v}-dryrun-${GITHUB_SHA::7}"
+ else
+ TAG="dry-run-${GITHUB_SHA::7}"
+ VERSION="$(jq -r .version npm/package.json)-dryrun-${GITHUB_SHA::7}"
+ fi
+ PUSH="false"
+ else
+ TAG="${{ github.event.inputs.tag || github.ref_name }}"
+ VERSION="${TAG#v}"
+ PUSH="true"
+ fi
+
+ {
+ echo "tag=$TAG"
+ echo "version=$VERSION"
+ echo "push=$PUSH"
+ } >> "$GITHUB_OUTPUT"
+
+ - name: Docker dry-run note
+ if: ${{ steps.meta.outputs.push != 'true' }}
+ run: |
+ echo "Running a multi-arch Docker build without pushing to GHCR or Docker Hub." >> "$GITHUB_STEP_SUMMARY"
+
+ - uses: docker/setup-qemu-action@v3
- uses: docker/setup-buildx-action@v3
- uses: docker/login-action@v3
+ if: ${{ steps.meta.outputs.push == 'true' }}
with:
username: ${{ secrets.DOCKERHUB_USER }}
password: ${{ secrets.DOCKERHUB_TOKEN }}
- uses: docker/login-action@v3
+ if: ${{ steps.meta.outputs.push == 'true' }}
with:
registry: ghcr.io
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}
- - name: Extract version
- id: version
- run: |
- TAG="${{ github.event.inputs.tag || github.ref_name }}"
- echo "tag=${TAG}" >> "$GITHUB_OUTPUT"
- echo "version=${TAG#v}" >> "$GITHUB_OUTPUT"
-
- - name: Mirror pinned release image to Docker Hub
- run: |
- docker buildx imagetools create \
- --tag pinchtab/pinchtab:latest \
- --tag pinchtab/pinchtab:${{ steps.version.outputs.tag }} \
- --tag pinchtab/pinchtab:${{ steps.version.outputs.version }} \
- ghcr.io/pinchtab/pinchtab:${{ steps.version.outputs.version }}
+ - uses: docker/build-push-action@v6
+ with:
+ context: .
+ file: ./Dockerfile
+ platforms: linux/amd64,linux/arm64
+ push: ${{ steps.meta.outputs.push == 'true' }}
+ provenance: false
+ labels: |
+ org.opencontainers.image.source=https://github.com/pinchtab/pinchtab
+ org.opencontainers.image.version=${{ steps.meta.outputs.version }}
+ tags: |
+ ghcr.io/pinchtab/pinchtab:latest
+ ghcr.io/pinchtab/pinchtab:${{ steps.meta.outputs.tag }}
+ ghcr.io/pinchtab/pinchtab:${{ steps.meta.outputs.version }}
+ pinchtab/pinchtab:latest
+ pinchtab/pinchtab:${{ steps.meta.outputs.tag }}
+ pinchtab/pinchtab:${{ steps.meta.outputs.version }}
diff --git a/.goreleaser.yml b/.goreleaser.yml
index ca9c9469..9a6ec714 100644
--- a/.goreleaser.yml
+++ b/.goreleaser.yml
@@ -55,38 +55,6 @@ changelog:
- '^ci:'
- '^chore:'
-dockers:
- - image_templates:
- - "ghcr.io/pinchtab/pinchtab:{{ .Version }}-amd64"
- use: buildx
- dockerfile: Dockerfile.goreleaser
- build_flag_templates:
- - "--platform=linux/amd64"
- - "--label=org.opencontainers.image.version={{ .Version }}"
- - "--label=org.opencontainers.image.source=https://github.com/pinchtab/pinchtab"
- goos: linux
- goarch: amd64
- - image_templates:
- - "ghcr.io/pinchtab/pinchtab:{{ .Version }}-arm64"
- use: buildx
- dockerfile: Dockerfile.goreleaser
- build_flag_templates:
- - "--platform=linux/arm64"
- - "--label=org.opencontainers.image.version={{ .Version }}"
- - "--label=org.opencontainers.image.source=https://github.com/pinchtab/pinchtab"
- goos: linux
- goarch: arm64
-
-docker_manifests:
- - name_template: "ghcr.io/pinchtab/pinchtab:{{ .Version }}"
- image_templates:
- - "ghcr.io/pinchtab/pinchtab:{{ .Version }}-amd64"
- - "ghcr.io/pinchtab/pinchtab:{{ .Version }}-arm64"
- - name_template: "ghcr.io/pinchtab/pinchtab:latest"
- image_templates:
- - "ghcr.io/pinchtab/pinchtab:{{ .Version }}-amd64"
- - "ghcr.io/pinchtab/pinchtab:{{ .Version }}-arm64"
-
release:
github:
owner: pinchtab
diff --git a/Dockerfile.goreleaser b/Dockerfile.goreleaser
deleted file mode 100644
index 0f302866..00000000
--- a/Dockerfile.goreleaser
+++ /dev/null
@@ -1,41 +0,0 @@
-# Release image — receives a pre-built binary from GoReleaser.
-# Mirrors the development Dockerfile runtime stage but uses the release
-# entrypoint which also backfills Chrome flags on first boot.
-FROM alpine:3.21
-
-LABEL org.opencontainers.image.source="https://github.com/pinchtab/pinchtab"
-LABEL org.opencontainers.image.description="Browser control for AI agents"
-
-# Chromium and its runtime dependencies for headless operation
-RUN apk add --no-cache \
- chromium \
- nss \
- freetype \
- harfbuzz \
- ca-certificates \
- ttf-freefont \
- dumb-init
-
-# Non-root user; /data is the persistent volume mount point
-RUN adduser -D -g '' pinchtab && \
- mkdir -p /data && \
- chown pinchtab:pinchtab /data
-
-COPY pinchtab /usr/local/bin/pinchtab
-COPY --chmod=0755 docker-entrypoint-release.sh /usr/local/bin/docker-entrypoint-release.sh
-
-USER pinchtab
-WORKDIR /data
-
-# HOME and XDG_CONFIG_HOME point into the persistent volume so config
-# and Chrome profiles survive container restarts.
-ENV HOME=/data \
- XDG_CONFIG_HOME=/data/.config
-
-EXPOSE 9867
-
-HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
- CMD wget -q -O /dev/null http://localhost:9867/health || exit 1
-
-ENTRYPOINT ["/usr/bin/dumb-init", "--"]
-CMD ["/usr/local/bin/docker-entrypoint-release.sh", "pinchtab"]
diff --git a/RELEASE.md b/RELEASE.md
index 1cbccdb3..11b88b36 100644
--- a/RELEASE.md
+++ b/RELEASE.md
@@ -100,6 +100,20 @@ If you need to re-release an existing tag:
2. **Run workflow**
3. Enter tag (e.g. `v0.7.1`)
+For a no-side-effects dry run from `main` or any other ref:
+
+1. Go to **Actions → Release**
+2. **Run workflow**
+3. Leave `tag` empty
+4. Set `ref` to the branch, tag, or commit you want to test
+5. Set `dry_run` to `true`
+
+Dry-run behavior:
+- GoReleaser runs in snapshot mode, so artifacts are built but not published
+- npm runs `npm publish --dry-run`
+- Docker runs a multi-arch `buildx` build with `push=false`
+- ClawHub skill publishing is not part of this workflow and is therefore skipped
+
## Pipeline details
### 1. Goreleaser (Go binary) — CRITICAL for npm
@@ -148,8 +162,8 @@ Depends on: `release` job (waits for goreleaser to finish)
### 3. Docker
-Goreleaser builds the pinned release image from `Dockerfile.goreleaser` and publishes it to GHCR.
-The Docker Hub job then mirrors that exact multi-arch manifest to Docker Hub, so the public release image does not rebuild from the floating development Dockerfile.
+GitHub Actions builds the release image directly from the tagged source with `docker buildx`.
+The workflow pushes the same multi-arch build to both GHCR and Docker Hub, so Docker no longer depends on GoReleaser's temporary build context.
## Troubleshooting