feat: add /legal:update command for in-app framework updates

fedec65 · claude · fedec65 · commit 69b5689f8f10 · 2026-01-23T16:32:31.000+01:00
- Add new /legal:update slash command for cross-platform updates
- Support macOS, Linux, and Windows with automatic platform detection
- Include options: --force, --check, --changelog
- Update /legal:help with new command documentation
- Update /legal:version to reference update command
- Bump version to 2.2.4

Co-Authored-By: Claude Opus 4.5 &lt;noreply@anthropic.com&gt;
diff --git a/.claude/commands/legal-help.md b/.claude/commands/legal-help.md
@@ -271,6 +271,7 @@ All commands work in **DE/FR/IT/EN**:
 | `/swiss:precedent` | Precedent Analyst 📊 | Precedent chain analysis | Citation evolution, case chains |
 | `/doc:analyze` | Document Analyst 📄 | Legal document analysis | Contract review, issue identification |
 | `/legal:version` | [Reference] | Framework version information | Current version and capabilities |
+| `/legal:update` | [System] | Update framework to latest version | In-app cross-platform update |
 | `/legal:help` | [Reference] | Command documentation | This help document |
 
 ---
@@ -458,6 +459,32 @@ When you use `/legal:` commands, these MCP servers are activated:
 
 ---
 
+### `/legal:update` - Framework Update
+**Purpose**: Update BetterCallClaude to the latest version directly from Claude Code
+
+**Features**:
+- Cross-platform support (macOS, Linux, Windows)
+- Automatic platform detection from environment
+- MCP server rebuild included
+- Changelog display option
+
+**Example**:
+```
+/legal:update
+→ Detecting platform: macOS (darwin)
+→ Current version: v2.2.2
+→ Latest version: v2.2.3
+→ Updating... Done!
+→ Please restart Claude Code to reload MCP servers
+```
+
+**Options**:
+- `--force` - Skip confirmation prompt
+- `--check` - Only check for updates, don't install
+- `--changelog` - Display changelog after update
+
+---
+
 ## 📚 Additional Resources
 
 - **Onboarding Guides**:
diff --git a/.claude/commands/legal-update.md b/.claude/commands/legal-update.md
@@ -0,0 +1,297 @@
+# /legal:update - BetterCallClaude Framework Update
+
+**Update the BetterCallClaude framework to the latest version directly from Claude Code.**
+
+---
+
+## Overview
+
+This command provides an in-app update mechanism for BetterCallClaude, detecting your platform and executing the appropriate update commands.
+
+---
+
+## Execution Behavior
+
+When this command is invoked, Claude must:
+
+### 1. Detect Platform from Environment
+
+Read the `<env>` context to determine the operating system:
+- **darwin** → macOS (use bash/zsh commands)
+- **linux** → Linux (use bash commands)
+- **win32** or contains "Windows" → Windows (use PowerShell commands)
+
+### 2. Check Current Version
+
+Before updating, display the current version:
+```bash
+# macOS/Linux
+bettercallclaude version 2>/dev/null || echo "CLI not available"
+
+# Windows PowerShell
+bettercallclaude version 2>$null
+```
+
+### 3. Check for Updates Available
+
+Compare local vs remote version:
+```bash
+# macOS/Linux - via git in installation directory
+cd ~/.claude/bettercallclaude && git fetch origin && git log HEAD..origin/main --oneline
+
+# Windows PowerShell
+Push-Location "$env:USERPROFILE\.claude\bettercallclaude"; git fetch origin; git log HEAD..origin/main --oneline; Pop-Location
+```
+
+### 4. Execute Platform-Specific Update
+
+#### macOS / Linux
+```bash
+# Option A: Using CLI wrapper (preferred)
+bettercallclaude update
+
+# Option B: Using installer directly
+cd ~/.claude/bettercallclaude && bash install.sh update
+```
+
+#### Windows (PowerShell)
+```powershell
+# Option A: Using CLI wrapper (preferred)
+bettercallclaude update
+
+# Option B: Using installer directly
+Push-Location "$env:USERPROFILE\.claude\bettercallclaude"
+.\install.ps1 -Update
+Pop-Location
+```
+
+### 5. Display Post-Update Instructions
+
+After successful update, display:
+
+```
+╔══════════════════════════════════════════════════════════════════╗
+║                    Update Complete!                               ║
+╠══════════════════════════════════════════════════════════════════╣
+║  BetterCallClaude has been updated to v{new_version}             ║
+║                                                                   ║
+║  IMPORTANT: MCP servers have been rebuilt.                       ║
+║                                                                   ║
+║  To complete the update:                                         ║
+║  1. Save any open work                                           ║
+║  2. Restart Claude Code (Cmd/Ctrl+Shift+P → "Reload Window")    ║
+║  3. MCP servers will reconnect automatically                     ║
+║                                                                   ║
+║  Run /legal:version to verify the update.                        ║
+╚══════════════════════════════════════════════════════════════════╝
+```
+
+---
+
+## Response Format
+
+### Before Update
+```
+╔══════════════════════════════════════════════════════════════════╗
+║                BetterCallClaude Update                            ║
+╠══════════════════════════════════════════════════════════════════╣
+║  Current Version:  v2.2.2                                         ║
+║  Latest Version:   v2.2.3                                         ║
+║  Platform:         macOS (darwin)                                 ║
+╠══════════════════════════════════════════════════════════════════╣
+║  Checking for updates...                                          ║
+╚══════════════════════════════════════════════════════════════════╝
+```
+
+### Update In Progress
+```
+╔══════════════════════════════════════════════════════════════════╗
+║  Updating BetterCallClaude...                                     ║
+╠══════════════════════════════════════════════════════════════════╣
+║  [✓] Fetching latest changes                                      ║
+║  [✓] Pulling updates from main                                    ║
+║  [✓] Rebuilding MCP servers                                       ║
+║  [✓] Updating manifest                                            ║
+╚══════════════════════════════════════════════════════════════════╝
+```
+
+### No Update Needed
+```
+╔══════════════════════════════════════════════════════════════════╗
+║                Already Up to Date!                                ║
+╠══════════════════════════════════════════════════════════════════╣
+║  Version:   v2.2.2                                                ║
+║  Status:    You have the latest version                           ║
+╚══════════════════════════════════════════════════════════════════╝
+```
+
+---
+
+## Error Handling
+
+### Installation Not Found
+```
+╔══════════════════════════════════════════════════════════════════╗
+║  Error: BetterCallClaude Not Installed                           ║
+╠══════════════════════════════════════════════════════════════════╣
+║  No installation found at expected locations:                     ║
+║  - ~/.claude/bettercallclaude (global)                           ║
+║  - ./.bettercallclaude (local)                                   ║
+║                                                                   ║
+║  To install BetterCallClaude:                                    ║
+║  curl -fsSL https://raw.githubusercontent.com/fedec65/           ║
+║       BetterCallClaude/main/install.sh | bash                    ║
+╚══════════════════════════════════════════════════════════════════╝
+```
+
+### Git Conflicts
+```
+╔══════════════════════════════════════════════════════════════════╗
+║  Warning: Local Changes Detected                                  ║
+╠══════════════════════════════════════════════════════════════════╣
+║  The update found uncommitted local changes.                      ║
+║                                                                   ║
+║  Options:                                                         ║
+║  1. Stash changes: git stash (then retry update)                 ║
+║  2. Discard changes: git checkout . (then retry update)          ║
+║  3. Manual update: cd ~/.claude/bettercallclaude && git pull     ║
+╚══════════════════════════════════════════════════════════════════╝
+```
+
+### Network Error
+```
+╔══════════════════════════════════════════════════════════════════╗
+║  Error: Network Connection Failed                                 ║
+╠══════════════════════════════════════════════════════════════════╣
+║  Could not connect to GitHub to fetch updates.                    ║
+║                                                                   ║
+║  Please check:                                                    ║
+║  - Your internet connection                                       ║
+║  - GitHub status: https://www.githubstatus.com                   ║
+║  - Firewall/proxy settings                                        ║
+╚══════════════════════════════════════════════════════════════════╝
+```
+
+---
+
+## Platform Detection Logic
+
+```javascript
+// Claude reads platform from <env> context in every session
+// Example env context:
+// Platform: darwin
+// OS Version: Darwin 25.1.0
+
+// Detection rules:
+if (platform === "darwin") {
+    // macOS - use bash commands
+    useShell = "bash";
+    updateCmd = "bettercallclaude update";
+    installDir = "~/.claude/bettercallclaude";
+}
+else if (platform === "linux") {
+    // Linux - use bash commands
+    useShell = "bash";
+    updateCmd = "bettercallclaude update";
+    installDir = "~/.claude/bettercallclaude";
+}
+else if (platform.includes("win") || platform.includes("Windows")) {
+    // Windows - use PowerShell
+    useShell = "powershell";
+    updateCmd = "bettercallclaude update";
+    installDir = "$env:USERPROFILE\\.claude\\bettercallclaude";
+}
+```
+
+---
+
+## Usage
+
+### Basic Update
+```
+/legal:update
+```
+
+### With Force Flag (skip confirmation)
+```
+/legal:update --force
+```
+
+### Check Only (no update)
+```
+/legal:update --check
+```
+
+---
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| (none) | Interactive update with confirmation |
+| `--force` | Skip confirmation prompt, update immediately |
+| `--check` | Only check for updates, don't install |
+| `--changelog` | Display changelog after update |
+
+---
+
+## Important Notes
+
+### MCP Server Reload Required
+
+After updating, MCP servers need to be reloaded. This requires:
+
+1. **Restart Claude Code** - The recommended method
+   - macOS: `Cmd+Shift+P` → "Developer: Reload Window"
+   - Windows: `Ctrl+Shift+P` → "Developer: Reload Window"
+
+2. **Or restart the terminal** and reopen Claude Code
+
+### Why Restart is Required
+
+MCP servers are registered at Claude Code startup. When BetterCallClaude updates:
+- New TypeScript code is pulled
+- MCP servers are rebuilt (`npm run build`)
+- But Claude Code's running MCP processes use the old code
+
+A restart refreshes the MCP server connections with the new code.
+
+---
+
+## Related Commands
+
+- `/legal:version` - Check current version and MCP status
+- `/legal:help` - Full command reference
+- `/legal:doctor` - Diagnose installation issues (if implemented)
+
+---
+
+## Changelog Display (--changelog)
+
+After update, optionally show recent changes:
+
+```
+╔══════════════════════════════════════════════════════════════════╗
+║               What's New in v2.2.3                                ║
+╠══════════════════════════════════════════════════════════════════╣
+║  • Fixed CLI wrapper syntax error in heredoc                      ║
+║  • Improved PowerShell parameter handling                         ║
+║  • pyproject.toml now single source of truth for version          ║
+║                                                                   ║
+║  Full changelog: https://github.com/fedec65/BetterCallClaude/    ║
+║                  blob/main/CHANGELOG.md                          ║
+╚══════════════════════════════════════════════════════════════════╝
+```
+
+---
+
+## Security Considerations
+
+- Updates are pulled from the official GitHub repository only
+- HTTPS is enforced for all connections
+- The update process runs in the user's context (no elevated privileges)
+- Local changes are preserved via git stash (not discarded)
+
+---
+
+**BetterCallClaude v2.2.4 - Swiss Legal Intelligence Framework**
diff --git a/.claude/commands/legal-version.md b/.claude/commands/legal-version.md
@@ -34,7 +34,7 @@ For each server, indicate:
 Check for available updates:
 - Compare local version with remote `pyproject.toml` from GitHub main branch
 - If update available, display: **Update available: v{remote_version}**
-- Provide command to update: `./install.sh update` or `bettercallclaude update`
+- Provide command to update: `/legal:update` (in-app) or `bettercallclaude update` (terminal)
 
 ---
 
@@ -69,10 +69,11 @@ No arguments required. This command displays current status and checks for updat
 
 ## Related Commands
 
+- `/legal:update` - Update framework to latest version (in-app)
 - `/legal:help` - Full command reference
-- `./install.sh version` - Terminal version check with update option
-- `./install.sh doctor` - Comprehensive installation diagnostics
+- `bettercallclaude version` - Terminal version check
+- `bettercallclaude doctor` - Comprehensive installation diagnostics
 
 ---
 
-**BetterCallClaude v1.3.2 - Swiss Legal Intelligence Framework**
+**BetterCallClaude v2.2.4 - Swiss Legal Intelligence Framework**
diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
 # BetterCallClaude: Legal Intelligence Framework for Swiss Lawyers
 
-[![Version](https://img.shields.io/badge/version-2.2.2-blue.svg)](https://github.com/fedec65/bettercallclaude)
+[![Version](https://img.shields.io/badge/version-2.2.4-blue.svg)](https://github.com/fedec65/bettercallclaude)
 [![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
 [![Languages](https://img.shields.io/badge/languages-DE%20%7C%20FR%20%7C%20IT%20%7C%20EN-orange.svg)]()
 [![Claude Code](https://img.shields.io/badge/built%20with-Claude%20Code-purple.svg)](https://claude.ai/code)
diff --git a/pyproject.toml b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "adversarial-workflow"
-version = "2.2.2"
+version = "2.2.4"
 description = "Adversarial workflow for legal document analysis with multi-agent communication"
 readme = "README.md"
 requires-python = ">=3.11"
