antigravity-autopilot 1.4.7 → 1.4.8

package/.github/workflows/release.yml

@@ -3,7 +3,7 @@ name: Release
 on:
   push:
     tags:
-      - 'v*'
+      - "v*"
 
 permissions:
   contents: write
@@ -18,7 +18,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: "20"
 
       - name: Install vsce
         run: npm install -g @vscode/vsce
@@ -31,16 +31,22 @@ jobs:
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
         with:
-          files: '*.vsix'
+          files: "*.vsix"
           generate_release_notes: true
           body: |
             ## Antigravity AutoPilot ${{ github.ref_name }}
 
             ### Install
 
-            **CLI (npm):**
+            **CLI (recommended — always runs latest version):**
+            ```bash
+            npx antigravity-autopilot
+            ```
+
+            **CLI (global install):**
             ```bash
             npm i -g antigravity-autopilot
+            antigravity-autopilot
             ```
 
             **VS Code Extension:**
@@ -48,3 +54,18 @@ jobs:
             ```bash
             antigravity --install-extension antigravity-autopilot-*.vsix
             ```
+
+            ### Patch Types
+            | Type | Description |
+            |------|-------------|
+            | `terminal` | Auto-execute terminal commands |
+            | `browser` | Auto-confirm browser actions |
+            | `file` | Auto-allow file permissions |
+
+            ### Usage
+            ```bash
+            npx antigravity-autopilot              # Apply all patches
+            npx antigravity-autopilot --only terminal  # Patch terminal only
+            npx antigravity-autopilot --check      # Check status
+            npx antigravity-autopilot --revert     # Restore originals
+            ```

package/README.md

@@ -36,6 +36,25 @@ Antigravity has an **"Always Proceed"** terminal execution policy, but due to mi
 
 ---
 
+## Installation
+
+**Option 1 — `npx` (recommended):** No install needed. Always runs the latest version:
+
+```bash
+npx antigravity-autopilot
+```
+
+**Option 2 — Global install:** Installs permanently, runs offline. Remember to update manually:
+
+```bash
+npm i -g antigravity-autopilot
+antigravity-autopilot
+```
+
+> **Which to choose?** Use `npx` unless you need offline access or run the tool frequently. `npx` always fetches the latest version automatically, while `npm i -g` keeps the installed version until you run `npm update -g`.
+
+---
+
 ## CLI Usage
 
 ```bash
@@ -86,7 +105,7 @@ Install the extension directly into Antigravity for a UI-based experience (sideb
 
 ```bash
 # Download .vsix from GitHub Releases, then:
-antigravity --install-extension antigravity-autopilot-1.4.7.vsix
+antigravity --install-extension antigravity-autopilot-1.4.8.vsix
 ```
 
 **Extension features:**

package/RELEASE.md

@@ -1,69 +1,87 @@
 # Release Checklist — Antigravity AutoPilot
 
-Follow these steps in order for every release.
+Follow these steps **in order** for every release.
+All platforms (npm, VSIX, GitHub Release) must have the **same version**.
 
 ## Pre-Release
 
 1. **Update code** — implement features/fixes
-2. **Bump `version`** in `package.json`
+2. **Bump `version`** in `package.json` ← single source of truth for all platforms
 3. **Update `README.md`** — document new features, commands, flags
 4. **Update `--help` screen** in `cli.js` if CLI changed
 5. **Update extension VSIX version reference** in `README.md` install command
+6. **Update `cli.js` banner version** if it has inline version strings
 
 ## Build & Test
 
-6. **Build VSIX:**
+7. **Build VSIX:**
    ```bash
    npx -y @vscode/vsce package --no-dependencies
    ```
-7. **Install VSIX locally:**
+8. **Install VSIX locally:**
    ```bash
    cursor --install-extension antigravity-autopilot-X.Y.Z.vsix --force
    ```
-8. **Test CLI commands:**
+9. **Test CLI commands:**
    ```bash
-   node cli.js --check     # verify per-patch status display
-   node cli.js             # apply patches, check graceful skip
-   node cli.js             # double-apply: all should show "Already patched"
-   node cli.js --revert    # revert, then re-apply
-   node cli.js --only terminal  # selective patch
-   node cli.js --help      # verify help screen
+   node cli.js --check        # verify per-patch status display
+   node cli.js                # apply patches, check graceful skip
+   node cli.js                # double-apply: all should show "Already patched"
+   node cli.js --revert       # revert
+   node cli.js --only terminal   # selective patch
+   node cli.js --help         # verify help screen
    ```
 
-## Publish
+## Publish (order matters!)
 
-9. **Commit all changes:**
-   ```bash
-   git add -A && git commit -m "feat: description (vX.Y.Z)"
-   ```
-10. **Push to GitHub:**
+10. **Commit all changes (including README, RELEASE.md, etc.):**
+    ```bash
+    git add -A && git commit -m "feat: description (vX.Y.Z)"
+    ```
+11. **Push to GitHub:**
     ```bash
     git push origin master
     ```
-11. **Publish to npm:**
+12. **Publish to npm** (README is frozen at this point!):
     ```bash
     npm publish
     ```
-12. **Create annotated tag (triggers GitHub Release via CI):**
+13. **Create annotated tag** (triggers GitHub Release workflow):
     ```bash
     git tag -a vX.Y.Z -m "vX.Y.Z - changelog summary"
     git push origin vX.Y.Z
     ```
-13. **Verify GitHub Release** — check that the workflow ran and VSIX is attached
-14. **Verify npm** — `npm info antigravity-autopilot version` shows new version
 
-## Post-Release
+## Post-Release Verification
 
-15. **(Optional) Publish to VS Code Marketplace:**
+14. **Verify npm:**
+    ```bash
+    npm info antigravity-autopilot version   # should show X.Y.Z
+    ```
+15. **Verify npm README** — visit https://www.npmjs.com/package/antigravity-autopilot
+16. **Verify GitHub Release** — check that the workflow ran and VSIX is attached
+17. **(Optional) Publish to VS Code Marketplace:**
     ```bash
     npx -y @vscode/vsce publish
     ```
 
+## Version Sync Matrix
+
+All of these must show the **same version**:
+
+| Location | File | What to update |
+|----------|------|---------------|
+| npm | `package.json` → `version` | Primary source of truth |
+| CLI banner | `cli.js` → `VERSION` constant | Reads from `package.json` automatically |
+| VSIX | Built from `package.json` version | Rebuild after version bump |
+| README | VSIX install command filename | Update `antigravity-autopilot-X.Y.Z.vsix` |
+| GitHub Release | Tag name `vX.Y.Z` | Must match `package.json` version |
+
 ## Common Mistakes to Avoid
 
-- ❌ Forgetting to update README with new features
-- ❌ Forgetting to bump version in `package.json`
-- ❌ Publishing to npm before pushing to GitHub
-- ❌ Not testing double-apply idempotency
+- ❌ Publishing to npm **before** updating README (npm freezes README at publish time)
+- ❌ Forgetting to rebuild VSIX after version bump
+- ❌ Forgetting to update VSIX filename in README
+- ❌ Different versions across npm / VSIX / GitHub tag
 - ❌ Using wrong branch name (`master` vs `main`)
 - ❌ Wrong publisher ID in `package.json` for Marketplace

package/package.json

@@ -2,7 +2,7 @@
   "name": "antigravity-autopilot",
   "displayName": "Antigravity AutoPilot",
   "description": "Enables autopilot mode for Antigravity: automatically executes all tool calls and terminal commands without manual confirmation. Patches the runtime JS bundle to inject auto-accept logic whenever the 'Always Proceed' policy is active — regex-based and version-agnostic.",
-  "version": "1.4.7",
+  "version": "1.4.8",
   "license": "MIT",
   "publisher": "nguyenhx2",
   "bin": {