Fix build scripts and dependencies

.gitignore

@@ -65,3 +65,6 @@ temp/
 
 # Claude Code
 .claude/settings.local.json
+
+# MCP Configuration (user-specific)
+.mcp.json

.mcp.json

@@ -1,12 +1,11 @@
 {
   "mcpServers": {
-    "browser-automation": {
+    "browser-automation-prod-local": {
       "type": "stdio",
       "command": "/opt/homebrew/bin/node",
       "args": [
-        "/Users/zvada/Documents/BOX/claude-experiments/browser-automation-professional/dist/server/mcp-integrated-stdio.js"
-      ],
-      "env": {}
+        "/Users/zvada/Documents/BOX/dev-browser/dist/server/mcp-integrated-stdio.js"
+      ]
     },
     "shadcn": {
       "command": "npx",

.mcp.json.example

@@ -0,0 +1,15 @@
+{
+  "mcpServers": {
+    "browser-automation-prod-local": {
+      "type": "stdio",
+      "command": "/opt/homebrew/bin/node",
+      "args": [
+        "/path/to/your/dev-browser/dist/server/mcp-integrated-stdio.js"
+      ]
+    },
+    "shadcn": {
+      "command": "npx",
+      "args": ["shadcn@latest", "mcp"]
+    }
+  }
+}

BROWSER_TEST_RESULTS.md

@@ -0,0 +1,175 @@
+# Browser Testing Results - Dynamic Port Implementation
+
+## Test Date
+2025-10-17
+
+## Environment
+- Backend: Node.js on port **55503** (dynamic)
+- Frontend: Vite dev server on port **1420**
+- Browser: Chrome (via Playwright automation)
+
+---
+
+## ✅ Backend Tests - PASSED
+
+### Backend Startup
+```
+[BACKEND_PORT]55503  ✅ Dynamic port assigned
+📡 API Server: http://localhost:55503
+[SIDECAR] Using backend at http://localhost:55503  ✅ Sidecar found it
+```
+
+### API Endpoints
+```bash
+$ curl http://localhost:55503/api/health
+{"status":"ok","database":"connected","sidecar":"running"}  ✅
+
+$ curl http://localhost:55503/api/stats
+{"workspaces":172,"sessions":174,...}  ✅
+```
+
+**Result:** Backend dynamic port system works perfectly! ✅
+
+---
+
+## ⚠️ Frontend Web Dev Mode - EXPECTED LIMITATION
+
+### Console Errors
+```
+ERROR: Failed to get backend port: Cannot read properties of undefined (reading 'invoke')
+WARNING: Falling back to default port 3333
+ERROR: Failed to load resource: net::ERR_CONNECTION_REFUSED @ http://localhost:3333/
+```
+
+### Root Cause
+The frontend code tries to call:
+```typescript
+await invoke('get_backend_port')  // ❌ Tauri API not available in browser
+```
+
+But `window.__TAURI__` is undefined in web dev mode (only exists in Tauri app).
+
+### Fallback Behavior
+The code correctly falls back to port 3333:
+```typescript
+catch (error) {
+  console.warn('Falling back to default port 3333');
+  cachedPort = 3333;  // ✅ Fallback works
+  return 3333;
+}
+```
+
+However, since backend is on 55503 (not 3333), connection fails.
+
+**This is working as designed!** Web dev mode can't use dynamic ports.
+
+---
+
+## 🎯 Correct Testing Method
+
+### Option 1: Full Tauri App (RECOMMENDED)
+```bash
+npm run tauri:dev
+```
+
+**Why this works:**
+1. Tauri launches backend with dynamic port
+2. Rust captures port from stdout
+3. Frontend calls `invoke('get_backend_port')` ✅ Works!
+4. All connections use dynamic port
+
+### Option 2: Web Dev Mode with Fixed Port
+For web development without Tauri:
+
+```bash
+# Terminal 1: Backend on port 3333 (not dynamic)
+PORT=3333 node backend/server.cjs
+
+# Terminal 2: Frontend
+npm run dev
+```
+
+Frontend will use fallback (3333) and connect successfully.
+
+---
+
+## 📊 Architecture Validation
+
+### The Flow That Works (Tauri App)
+```
+┌─────────────┐  invoke('get_backend_port')  ┌──────────────┐
+│  Frontend   │────────────────────────────>│  Rust/Tauri  │
+│  (React)    │<───────────── 55503 ────────│              │
+└─────────────┘                              └──────────────┘
+      │                                             │
+      │ fetch(http://localhost:55503/api/...)      │
+      └────────────────────────────────────────────┼──────┐
+                                                    │      │
+                                            ┌───────▼──────▼───┐
+                                            │   Backend        │
+                                            │   Port: 55503    │
+                                            └──────────────────┘
+```
+
+### The Flow in Web Dev Mode (Browser)
+```
+┌─────────────┐  invoke() ❌ Not available
+│  Frontend   │
+│  (Browser)  │  Falls back to 3333
+└─────────────┘
+      │
+      │ fetch(http://localhost:3333/api/...) ❌ Connection refused
+      └────────────────────────────────────────────┐
+                                                    X (No backend on 3333)
+
+                                            ┌──────────────────┐
+                                            │   Backend        │
+                                            │   Port: 55503    │
+                                            └──────────────────┘
+                                                    (different port!)
+```
+
+---
+
+## ✅ Conclusion
+
+### What We Validated
+1. ✅ Backend dynamic port allocation works
+2. ✅ Port detection and logging works
+3. ✅ Sidecar finds dynamic port correctly
+4. ✅ Backend APIs respond properly
+5. ✅ Fallback mechanism works in web mode
+6. ✅ Error handling works as expected
+
+### What Needs Tauri App Testing
+- [ ] Frontend calls `invoke('get_backend_port')` successfully
+- [ ] Frontend connects to dynamic backend port
+- [ ] Dashboard loads workspaces
+- [ ] Multiple Tauri instances work (different ports)
+
+### Recommendation
+**READY FOR TAURI APP TESTING**
+
+Run this command to test the complete flow:
+```bash
+npm run tauri:dev
+```
+
+Then verify:
+1. Console shows: `[TAURI] Backend started successfully on port XXXXX`
+2. Frontend loads without errors
+3. Dashboard displays workspaces
+4. No hardcoded port 3333 references
+
+---
+
+## 📝 Notes
+
+**Why This Test Was Valuable:**
+- Confirmed backend works independently ✅
+- Confirmed fallback mechanism works ✅
+- Identified correct testing approach ✅
+- Validated error messages are clear ✅
+
+**Next Step:**
+Test with full Tauri app (`npm run tauri:dev`) to validate the complete dynamic port flow.