@gw-tools/gw 0.29.0 → 0.29.1

package/README.md

@@ -22,7 +22,7 @@ A command-line tool for managing git worktrees, built with Deno.
     - [Example Configuration](#example-configuration)
     - [Configuration Options](#configuration-options)
   - [Commands](#commands)
-    - [checkout (add, co)](#checkout)
+    - [checkout](#checkout)
       - [Arguments](#arguments)
       - [Options](#options)
       - [Examples](#examples)
@@ -33,21 +33,22 @@ A command-line tool for managing git worktrees, built with Deno.
       - [Examples](#examples-1)
       - [How It Works](#how-it-works)
     - [pr](#pr)
-      - [Arguments](#arguments-3)
+      - [Arguments](#arguments-2)
       - [Options](#options-1)
-      - [Examples](#examples-3)
+      - [Examples](#examples-2)
       - [Requirements](#requirements)
-      - [How It Works](#how-it-works-2)
+      - [How It Works](#how-it-works-1)
     - [update](#update)
       - [Options](#options-2)
-      - [Examples](#examples-4)
-      - [How It Works](#how-it-works-3)
+      - [Examples](#examples-3)
+      - [How It Works](#how-it-works-2)
     - [install-shell](#install-shell)
       - [Options](#options-3)
-      - [Examples](#examples-5)
+      - [Examples](#examples-4)
+      - [Migrating from File-Based Integration](#migrating-from-file-based-integration)
     - [root](#root)
-      - [Examples](#examples-6)
-      - [How It Works](#how-it-works-4)
+      - [Examples](#examples-5)
+      - [How It Works](#how-it-works-3)
     - [init](#init)
       - [Options](#options-4)
       - [Clone Examples](#clone-examples)
@@ -57,17 +58,17 @@ A command-line tool for managing git worktrees, built with Deno.
       - [When to Use](#when-to-use)
     - [show-init](#show-init)
       - [Options](#options-5)
-      - [Examples](#examples-7)
+      - [Examples](#examples-6)
       - [Output Example](#output-example)
       - [When to Use](#when-to-use-1)
     - [sync](#sync)
-      - [Arguments](#arguments-4)
+      - [Arguments](#arguments-3)
       - [Options](#options-6)
-      - [Examples](#examples-8)
+      - [Examples](#examples-7)
     - [clean](#clean)
       - [Options](#options-7)
-      - [Examples](#examples-9)
-      - [How It Works](#how-it-works-5)
+      - [Examples](#examples-8)
+      - [How It Works](#how-it-works-4)
     - [Git Worktree Proxy Commands](#git-worktree-proxy-commands)
       - [list (ls)](#list-ls)
       - [remove (rm)](#remove-rm)
@@ -83,13 +84,14 @@ A command-line tool for managing git worktrees, built with Deno.
       - [Shell Alias Method (Recommended)](#shell-alias-method-recommended)
     - [Available Scripts](#available-scripts)
     - [Publishing](#publishing)
-      - [Automated Release (Recommended)](#automated-release-recommended)
-      - [Manual Publishing](#manual-publishing)
+      - [How It Works](#how-it-works-5)
+      - [Conventional Commits](#conventional-commits)
+      - [Testing Releases](#testing-releases)
+      - [Manual Publishing (Fallback)](#manual-publishing-fallback)
       - [Publishing to JSR (Optional)](#publishing-to-jsr-optional)
-      - [Version Management](#version-management)
     - [Project Structure](#project-structure)
     - [Adding New Commands](#adding-new-commands)
-      - [Custom Commands (like `add`, `copy`)](#custom-commands-like-add-copy)
+      - [Custom Commands (like `checkout`, `sync`)](#custom-commands-like-checkout-sync)
       - [Git Proxy Commands (like `list`, `remove`)](#git-proxy-commands-like-list-remove)
   - [License](#license)
 
@@ -135,19 +137,14 @@ gw checkout main
 Enhance your AI agent with gw-tools knowledge using [skills.sh](https://skills.sh):
 
 ```bash
-npx skills add https://github.com/mthines/gw-tools --skill @gw-git-worktree-workflows @gw-config-management @gw-autonomous-workflow # installs all skills
+npx skills add https://github.com/mthines/gw-tools --skill
 ```
 
-```bash
-# Autonomous feature development workflow
-npx skills add https://github.com/mthines/gw-tools --skill @gw-autonomous-workflow
-
-# Master Git worktrees and gw workflows
-npx skills add https://github.com/mthines/gw-tools --skill @gw-git-worktree-workflows
+Available skills:
 
-# Configure gw for your project type (Next.js, monorepos, etc.)
-npx skills add https://github.com/mthines/gw-tools --skill @gw-config-management
-```
+- **autonomous-workflow** - Autonomous feature development from requirements to PR
+- **git-worktree-workflows** - Master Git worktrees and gw workflows
+- **gw-config-management** - Configure gw for your project type (Next.js, monorepos, etc.)
 
 Once installed, your AI agent can:
 
@@ -1529,125 +1526,83 @@ nx run gw-tool:test
 
 ### Publishing
 
-This tool uses **automated semantic versioning** based on conventional commits. The version is automatically determined from your commit messages.
+Releases are **fully automated** via CI. No manual release commands are needed.
+
+#### How It Works
+
+**Beta Releases (on Pull Requests):**
 
-#### Automated Release (Recommended)
+When you open a non-draft PR with changes to `packages/gw-tool/src/`:
 
-The simplest way to publish is using the automated release process:
+1. CI runs tests
+2. If tests pass, a beta version is automatically created (e.g., `0.29.0-beta.27.1`)
+3. The beta is published to npm with the `beta` tag and Homebrew as `gw-beta`
+4. A comment is added to the PR with installation instructions
 
 ```bash
-# Make sure you're on main/master branch with all changes pushed
-nx run gw-tool:release
+# Install beta version
+npm install @gw-tools/gw@beta
+brew install mthines/gw-tools/gw-beta
 ```
 
-This single command will:
+**Stable Releases (on Merge to Main):**
+
+When a PR is merged to `main` with changes to `packages/gw-tool/src/`:
 
-1. Analyze your commits since the last release
-2. Automatically determine version bump (major/minor/patch)
-3. Update npm/package.json with the new version
-4. Create a git commit and tag
-5. Push to GitHub
-6. Build binaries for all platforms
-7. Create a GitHub release with binaries attached
-8. Publish to npm
+1. CI automatically determines the version bump from conventional commits
+2. Updates `package.json`, creates a git tag, and pushes
+3. Builds binaries for all platforms
+4. Creates a GitHub release with binaries attached
+5. Publishes to npm and updates Homebrew tap
 
-**Conventional Commit Format:**
+#### Conventional Commits
 
 Use these commit prefixes to control versioning:
 
-- `feat:` - New feature (bumps **MINOR** version: 1.0.0 → 1.1.0)
-- `fix:` - Bug fix (bumps **PATCH** version: 1.0.0 → 1.0.1)
-- `BREAKING CHANGE:` or `feat!:` or `fix!:` - Breaking change (bumps **MAJOR** version: 1.0.0 → 2.0.0)
-- `chore:`, `docs:`, `style:`, `refactor:`, `test:` - No version bump
+| Prefix                         | Version Bump          | Example                        |
+| ------------------------------ | --------------------- | ------------------------------ |
+| `feat:`                        | Minor (1.0.0 → 1.1.0) | `feat: add dry-run mode`       |
+| `fix:`                         | Patch (1.0.0 → 1.0.1) | `fix: correct path resolution` |
+| `feat!:` or `BREAKING CHANGE:` | Major (1.0.0 → 2.0.0) | `feat!: redesign config`       |
+| `chore:`, `docs:`, `refactor:` | No bump               | `docs: update README`          |
 
-**Examples:**
+#### Testing Releases
+
+To test the release workflow without publishing:
 
 ```bash
-git commit -m "feat: add dry-run mode"           # 1.0.0 → 1.1.0
-git commit -m "fix: correct path resolution"     # 1.0.0 → 1.0.1
-git commit -m "feat!: redesign config structure" # 1.0.0 → 2.0.0
-git commit -m "docs: update README"              # no version bump
+# Trigger a dry-run release via GitHub Actions
+gh workflow run ci.yml -f test_release=true -f version=0.0.0-test
 ```
 
-#### Manual Publishing
+#### Manual Publishing (Fallback)
 
-If you prefer manual control or need to debug the release process:
+If CI fails or you need manual control:
 
 ```bash
-# 1. Update version
-cd packages/gw-tool/npm
-npm version 1.0.0
-cd ../../..
-
-# 2. Commit and push
-git add packages/gw-tool/npm/package.json
-git commit -m "chore: bump version to 1.0.0"
-git push
-
-# 3. Build binaries
+# 1. Build binaries
 nx run gw-tool:compile-all
 nx run gw-tool:npm-pack
 
-# 4. Create GitHub release
+# 2. Create GitHub release
 gh release create "v1.0.0" \
   --title "v1.0.0" \
   --notes "Release notes" \
   dist/packages/gw-tool/binaries/*
 
-# 5. Publish to npm
+# 3. Publish to npm
 cd dist/packages/gw-tool/npm
 npm publish --access public
 ```
 
 #### Publishing to JSR (Optional)
 
-For users who prefer Deno's native package manager.
-
-1. **Add JSR configuration to `deno.json`:**
-
-   ```json
-   {
-     "name": "@your-scope/gw",
-     "version": "1.0.0",
-     "exports": "./src/main.ts"
-   }
-   ```
-
-2. **Publish:**
-   ```bash
-   nx run gw-tool:publish-jsr
-   ```
-
-#### Version Management
-
-**Automated Approach (Recommended):**
-
-Use conventional commits and let the system determine the version:
+For users who prefer Deno's native package manager:
 
 ```bash
-# Make changes
-git add .
-git commit -m "feat: add new awesome feature"
-
-# When ready to release
-nx run gw-tool:release
+nx run gw-tool:publish-jsr
 ```
 
-The version is automatically determined from your commits:
-
-- `feat:` → minor version bump (1.0.0 → 1.1.0)
-- `fix:` → patch version bump (1.0.0 → 1.0.1)
-- `feat!:` or `BREAKING CHANGE:` → major version bump (1.0.0 → 2.0.0)
-
-**Manual Approach:**
-
-If you prefer manual control:
-
-1. Update `packages/gw-tool/npm/package.json` version
-2. Update `packages/gw-tool/deno.json` version (if using JSR)
-3. Commit and push changes
-4. Build, create release, and publish manually
-
 ### Project Structure
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gw-tools/gw",
-  "version": "0.29.0",
+  "version": "0.29.1",
   "description": "A command-line tool for managing git worktrees - copy files between worktrees with ease",
   "keywords": [
     "git",