feat(bridge): add CLI with setup, pairing, and plugin management

Add comprehensive CLI interface for ReCursor bridge with the following capabilities:

- Setup command with transport provider selection (Tailscale, Cloudflare, Ngrok, Manual)
- QR code pairing for mobile app connection
- Claude plugin installation and management
- Doctor command for configuration validation
- Pass-through to Claude CLI with plugin hooks

Bridge enhancements supporting the CLI:
- Optional ANTHROPIC_API_KEY with DisabledAgentRuntime fallback
- TLS support (HTTPS/WSS) via cert/key configuration
- Graceful shutdown with BridgeRuntime management
- Connection state subscriptions for monitoring
- Dynamic feature detection based on available configuration

Package updates:
- Added qrcode dependency and types
- Added bin entry for recursor CLI command

Author: MasuRii

packages/bridge/package-lock.json

@@ -5,8 +5,12 @@
   "description": "ReCursor bridge server",
   "license": "MIT",
   "main": "dist/index.js",
+  "bin": {
+    "recursor": "dist/cli.js"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json",
+    "cli": "node dist/cli.js",
     "check": "npm run format:check && npm run typecheck && npm run test:ci && npm run build",
     "dev": "nodemon --exec ts-node src/index.ts",
     "format": "prettier --write .",
@@ -21,6 +25,7 @@
     "cors": "^2.8.5",
     "dotenv": "^16.4.7",
     "express": "^4.21.1",
+    "qrcode": "^1.5.4",
     "simple-git": "^3.27.0",
     "uuid": "^10.0.0",
     "ws": "^8.18.0",
@@ -31,6 +36,7 @@
     "@types/express": "^5.0.0",
     "@types/jest": "^29.5.14",
     "@types/node": "^22.0.0",
+    "@types/qrcode": "^1.5.6",
     "@types/supertest": "^7.2.0",
     "@types/uuid": "^10.0.0",
     "@types/ws": "^8.5.13",

packages/bridge/package.json

@@ -60,6 +60,14 @@ function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === "object" && value !== null;
 }
 
+export class DisabledAgentRuntime implements AgentRuntime {
+  constructor(private readonly reason: string) {}
+
+  async runTurn(_request: AgentRuntimeTurnRequest): Promise<AgentRuntimeTurnResult> {
+    throw new Error(this.reason);
+  }
+}
+
 export class AnthropicMessageRuntime implements AgentRuntime {
   constructor(private client: Anthropic) {}