feat: add release workflow, update package metadata, and provide docu…

.github/workflows/release.yml

@@ -0,0 +1,56 @@
+name: Release
+
+on:
+  workflow_dispatch:
+
+jobs:
+  release:
+    name: Publish packages
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install capsule-run (PyPI)
+        run: pip install capsule-run
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.21.0
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build WASM sandboxes
+        run: pnpm prebuild-wasm
+
+      - name: Publish packages in dependency order
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          for pkg in bash-types bash bash-wasm bash-mcp; do
+            dir="packages/$pkg"
+            name=$(node -p "require('./$dir/package.json').name")
+            version=$(node -p "require('./$dir/package.json').version")
+            if npm view "$name@$version" version > /dev/null 2>&1; then
+              echo "$name@$version already published, skipping"
+              continue
+            fi
+            echo "Publishing $name@$version..."
+            (cd "$dir" && pnpm publish --access public --no-git-checks)
+          done

package.json

@@ -11,6 +11,11 @@
     "bash-wasm-shell": "pnpm --filter bash-wasm-shell bash-wasm-shell",
     "prebuild-wasm": "bash ./scripts/prebuild-wasm-sandboxes.sh"
   },
+  "homepage": "https://github.com/capsulerun/bash",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/capsulerun/bash.git"
+  },
   "dependencies": {
     "@capsule-run/cli": "^0.8.9",
     "@capsule-run/sdk": "^0.8.9"

packages/bash-mcp/README.md

@@ -1,4 +1,4 @@
-# `@capsule-run/bash-mcp`
+# `Capsule` bash mcp
 
 [![MCP Server Release](https://github.com/capsule-run/bash/actions/workflows/mcp-integration-release.yml/badge.svg)](https://github.com/capsule-run/bash/actions/workflows/mcp-integration-release.yml)
 

packages/bash-mcp/package.json

@@ -16,6 +16,12 @@
     "dev": "tsx watch src/index.ts",
     "build": "tsup src/index.ts --format esm --dts"
   },
+  "homepage": "https://github.com/capsulerun/bash/tree/main/packages/bash-mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/capsulerun/bash.git",
+    "directory": "packages/bash-mcp"
+  },
   "license": "Apache-2.0",
   "packageManager": "pnpm@10.21.0",
   "devDependencies": {

packages/bash-types/README.md

@@ -0,0 +1,3 @@
+# @capsule-run/bash-types
+
+Shared TypeScript types for the [`@capsule-run/bash`](https://github.com/capsule-run/bash) ecosystem.

packages/bash-types/package.json

@@ -3,6 +3,12 @@
   "version": "0.1.0",
   "description": "",
   "type": "module",
+  "homepage": "https://github.com/capsulerun/bash",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/capsulerun/bash.git",
+    "directory": "packages/bash-types"
+  },
   "main": "./src/index.ts",
   "types": "./src/index.ts",
   "exports": {

packages/bash-wasm/README.md

@@ -0,0 +1 @@
+../../README.md

packages/bash-wasm/package.json

@@ -3,11 +3,21 @@
   "version": "0.1.0",
   "description": "Sandboxed bash for agents",
   "type": "module",
+  "homepage": "https://github.com/capsulerun/bash",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/capsulerun/bash.git",
+    "directory": "packages/bash-wasm"
+  },
   "main": "./src/index.ts",
   "types": "./src/index.ts",
   "exports": {
     ".": "./src/index.ts"
   },
+  "files": [
+    "src",
+    "dist/sandboxes"
+  ],
   "scripts": {
     "pretest": "pip install -r sandboxes/python/requirements.txt -q",
     "test": "vitest run"

packages/bash/README.md

@@ -0,0 +1 @@
+../../README.md

packages/bash/package.json

@@ -3,6 +3,12 @@
   "version": "0.1.0",
   "description": "Sandboxed bash for agents",
   "type": "module",
+  "homepage": "https://github.com/capsulerun/bash",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/capsulerun/bash.git",
+    "directory": "packages/bash"
+  },
   "main": "./src/index.ts",
   "types": "./src/index.ts",
   "exports": {