v0.2.0: CLI, Python package, working e2e replay

.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets).
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md).

.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.3/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

.github/workflows/release.yml

@@ -1,28 +1,94 @@
 name: Release
 on:
   push:
-    tags: ["v*"]
+    branches: [main]
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
 
 jobs:
   release:
     runs-on: ubuntu-latest
     permissions:
       contents: write
+      pull-requests: write
+      id-token: write
+    outputs:
+      published: ${{ steps.changesets.outputs.published }}
+      publishedPackages: ${{ steps.changesets.outputs.publishedPackages }}
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Check repository hygiene
+        run: |
+          if git ls-files | grep -E '^(docs/plans|\.omx|\.pilot|\.dev-session)(/|$)|(^|/)(AGENTS\.md|CLAUDE\.md|POSITIONING\.md|ROADMAP\.md|BROWSER_USE_PR\.md|demo/RECORD-DEMO-PROMPT\.md|\.staff-engineer-state\.json|\.staff-engineer\.json)$'; then
+            echo "Tracked internal-only files found in public release tree."
+            exit 1
+          fi
+          extra_banners="$(git ls-files .github/banners | grep -Ev '^\.github/banners/05-replay-arrows\.svg$' || true)"
+          if [ -n "$extra_banners" ]; then
+            printf '%s\n' "$extra_banners"
+            echo "Tracked banner drafts found outside the release banner."
+            exit 1
+          fi
       - uses: actions/setup-node@v4
         with:
           node-version: 22
           cache: npm
           registry-url: https://registry.npmjs.org
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
       - run: npm ci
-      - run: npm run build
-      - run: npm run typecheck
-      - run: npm test
-      - run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-      - name: Create GitHub Release
-        run: gh release create "${{ github.ref_name }}" --generate-notes
+      - run: npm run release:verify
+      - name: Verify python package
+        run: |
+          python -m pip install -e "./python[dev]" build twine
+          python -m pytest python/tests -q
+          (
+            cd python
+            python -m build
+            python -m twine check dist/*
+          )
+      - name: Verify browser-use integration
+        working-directory: integrations/browser-use
+        run: |
+          npm ci
+          npm run typecheck
+          npm test
+      - name: Verify browserbase integration
+        working-directory: integrations/browserbase
+        run: |
+          npm ci
+          npm test
+      - name: Create release PR or publish npm
+        id: changesets
+        uses: changesets/action@v1
+        with:
+          version: npm run release:version
+          publish: npm run release:publish:npm
         env:
-          GH_TOKEN: ${{ github.token }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+  pypi:
+    runs-on: ubuntu-latest
+    needs: release
+    if: needs.release.outputs.published == 'true'
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install -e "./python[dev]" build
+      - run: python -m pytest python/tests -q
+      - run: python -m build
+        working-directory: python
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: python/dist/

.gitignore

@@ -2,6 +2,19 @@ node_modules/
 dist/
 .turbo/
 *.tsbuildinfo
+.DS_Store
+*.tgz
+.omx/
+.pilot/
 .dev-session/
 .staff-engineer-state.json
+.staff-engineer.json
+AGENTS.md
+.github/banners/*
+!.github/banners/05-replay-arrows.svg
+docs/plans/
+POSITIONING.md
+ROADMAP.md
+BROWSER_USE_PR.md
+demo/RECORD-DEMO-PROMPT.md
 CLAUDE.md