docs: fix README formatting and add release automation

.github/workflows/release.yml

@@ -4,16 +4,68 @@ on:
   push:
     tags:
       - 'v*'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version type to bump (patch, minor, major)'
+        required: true
+        default: 'patch'
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
 
 permissions:
-  contents: read
+  contents: write
   id-token: write
 
 jobs:
+  bump-version:
+    if: github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Configure Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test -- --run
+
+      - name: Bump version
+        id: version
+        run: |
+          npm version ${{ github.event.inputs.version }} -m "chore: release %s"
+          echo "version=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT
+
+      - name: Push changes
+        run: |
+          git push origin main
+          git push origin --tags
+
   publish:
+    needs: [bump-version]
+    if: always() && (github.event_name == 'push' || needs.bump-version.result == 'success')
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4
+      with:
+        ref: ${{ github.event_name == 'workflow_dispatch' && format('v{0}', needs.bump-version.outputs.version) || github.ref }}
 
     - uses: actions/setup-node@v4
       with:
@@ -28,4 +80,14 @@ jobs:
 
     - run: npm publish --provenance --access public
       env:
-        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+    - name: Create GitHub Release
+      if: success()
+      uses: softprops/action-gh-release@v2
+      with:
+        tag_name: ${{ github.event_name == 'workflow_dispatch' && format('v{0}', needs.bump-version.outputs.version) || github.ref_name }}
+        name: Release ${{ github.event_name == 'workflow_dispatch' && needs.bump-version.outputs.version || github.ref_name }}
+        generate_release_notes: true
+        draft: false
+        prerelease: false

README.md

@@ -17,29 +17,30 @@ No more context-switching. No more dashboard hunting.
 
 ## Demo
 
+### Your conversation:
 ```
-// In your AI conversation:
-"Check my latest Vercel deployment"
-
-// Claude's Response:
-## Deployment Status
-
-### Current Status
-**Project:** my-app  
-**Platform:** Vercel  
-**Status:** ✅ Success  
-**URL:** https://my-app.vercel.app  
-**Duration:** 45s  
-**Deployed:** 2 hours ago  
-
-### Commit Info
-**SHA:** `abc123ef`  
-**Message:** Update homepage hero section  
-**Author:** John Doe  
-
-Everything looks good - your deployment is live and running successfully!
+User: "Check my latest Vercel deployment"
 ```
 
+### AI Assistant's Response:
+
+> ## Deployment Status
+> 
+> ### Current Status
+> **Project:** my-app  
+> **Platform:** Vercel  
+> **Status:** ✅ Success  
+> **URL:** https://my-app.vercel.app  
+> **Duration:** 45s  
+> **Deployed:** 2 hours ago  
+> 
+> ### Commit Info
+> **SHA:** `abc123ef`  
+> **Message:** Update homepage hero section  
+> **Author:** John Doe  
+> 
+> Everything looks good - your deployment is live and running successfully!
+
 **Just ask your AI**: *"What's the status of my latest deployment?"*  
 Get instant answers without leaving your conversation.
 
@@ -308,81 +309,85 @@ Render integration is on our roadmap. [Star the repo](https://github.com/alexpot
 ### Quick Examples by Tool
 
 #### 1. Check Deployment Status
-```
-You: "Check my Vercel deployment"
-You: "Is my website live?"
-You: "Show deployment status for my-app"
-```
 
-#### 2. Watch Deployment (Real-time) **[NEW]**
-```
-You: "Watch my deployment"
-You: "Stream my build progress"
-You: "Show me real-time deployment updates"
-```
-Get live updates as your deployment progresses through initialization, building, and completion.
+> 💬 **Ask your AI:**
+> - "Check my Vercel deployment"
+> - "Is my website live?"
+> - "Show deployment status for my-app"
 
-#### 3. Compare Deployments **[NEW]**
-```
-You: "Compare my last 2 deployments"
-You: "What changed in my latest deployment?"
-You: "Show build time differences"
-```
-See performance metrics, risk assessment, and identify what changed between deployments.
+#### 2. Watch Deployment (Real-time)
 
-#### 4. Get Deployment Logs **[NEW]**
-```
-You: "Show deployment logs"
-You: "Why did my deployment fail?"
-You: "Get error logs for deployment dpl_ABC123"
-```
-Get intelligent error analysis with suggested fixes and filtered log output.
+> 💬 **Ask your AI:**
+> - "Watch my deployment"
+> - "Stream my build progress"
+> - "Show me real-time deployment updates"
 
-### MCP Server Usage
-
-Once configured with your AI assistant, simply ask:
-
-```
-You: Check my latest Vercel deployment
+Get live updates as your deployment progresses through initialization, building, and completion.
 
-Assistant: I'll check your latest Vercel deployment for you.
+#### 3. Compare Deployments
 
-## Deployment Status
+> 💬 **Ask your AI:**
+> - "Compare my last 2 deployments"
+> - "What changed in my latest deployment?"
+> - "Show build time differences"
 
-### Current Status
-**Project:** my-app  
-**Platform:** Vercel  
-**Status:** ✅ Success  
-**URL:** https://my-app.vercel.app  
-**Duration:** 45s  
-**Deployed:** 2 hours ago  
-
-### Commit Info
-**SHA:** `abc123ef`  
-**Message:** Update homepage hero section  
-**Author:** John Doe  
-
-Everything looks good - your deployment is live and running successfully!
-```
+See performance metrics, risk assessment, and identify what changed between deployments.
 
-**New Real-time Example:**
-```
-You: Watch my deployment
+#### 4. Get Deployment Logs
 
-Assistant: ## Deployment Watch
+> 💬 **Ask your AI:**
+> - "Show deployment logs"
+> - "Why did my deployment fail?"
+> - "Get error logs for deployment dpl_ABC123"
 
-### Real-time Updates
-🔄 **Starting to watch deployment for my-app**
+Get intelligent error analysis with suggested fixes and filtered log output.
 
-🔄 **Deployment state: INITIALIZING**
+### MCP Server Usage
 
-🔄 **Deployment state: BUILDING**
-   Duration: 15s
+Once configured with your AI assistant, simply ask:
 
-✅ **Deployment successful!**
-   URL: https://my-app.vercel.app
-   Duration: 45s
-```
+#### Example: Check Status
+
+**You:** "Check my latest Vercel deployment"
+
+**Assistant:**
+> I'll check your latest Vercel deployment for you.
+>
+> ## Deployment Status
+> 
+> ### Current Status
+> **Project:** my-app  
+> **Platform:** Vercel  
+> **Status:** ✅ Success  
+> **URL:** https://my-app.vercel.app  
+> **Duration:** 45s  
+> **Deployed:** 2 hours ago  
+> 
+> ### Commit Info
+> **SHA:** `abc123ef`  
+> **Message:** Update homepage hero section  
+> **Author:** John Doe  
+> 
+> Everything looks good - your deployment is live and running successfully!
+
+#### Example: Real-time Monitoring
+
+**You:** "Watch my deployment"
+
+**Assistant:**
+> ## Deployment Watch
+> 
+> ### Real-time Updates
+> 🔄 **Starting to watch deployment for my-app**
+> 
+> 🔄 **Deployment state: INITIALIZING**
+> 
+> 🔄 **Deployment state: BUILDING**  
+>    Duration: 15s
+> 
+> ✅ **Deployment successful!**  
+>    URL: https://my-app.vercel.app  
+>    Duration: 45s
 
 **More examples:**
 - `"Is my website deployment finished?"`