feat(daemon): replace 5min idle timeout with long-lived daemon model (#641)

* docs: add daemon lifecycle redesign spec

Replace the aggressive 5-minute idle timeout with a long-lived daemon
model that stays running for hours, reducing restart overhead during
development cycles.

* docs: add daemon lifecycle redesign implementation plan

8-task TDD plan for replacing aggressive 5-minute idle timeout with
long-lived daemon model (4h default, dual-condition exit).

* feat(daemon): add DEFAULT_DAEMON_IDLE_TIMEOUT constant (4 hours)

* feat(daemon): replace fixed 5min timeout with dual-condition idle manager (4h default)

* feat(extension): reduce WS reconnect backoff cap from 60s to 5s

* feat(daemon): improve CLI connection-waiting UX with progress messages and 200ms polling

* feat(daemon): add opencli daemon status/stop/restart commands

* test(daemon): add tests for daemon status/stop commands

* fix(daemon): address code review issues — stale constant, restart robustness, timer cleanup, test coverage

* docs: update daemon documentation for new lifecycle and CLI commands

- troubleshooting.md: replace manual curl/pkill with `opencli daemon status/stop/restart`
- browser-bridge.md (en/zh): add Daemon Lifecycle section
- README.md: add `opencli daemon status` to Quick Start
- README.zh-CN.md: add daemon management commands to tips

Author: jackwener

README.md

@@ -72,7 +72,8 @@ npm install -g @jackwener/opencli
 ### 3. Verify & Try
 
 ```bash
-opencli doctor   # Check extension + daemon connectivity
+opencli doctor          # Check extension + daemon connectivity
+opencli daemon status   # Check daemon state (PID, uptime, memory)
 ```
 
 **Try it out:**

README.zh-CN.md

@@ -73,9 +73,11 @@ OpenCLI 通过轻量化的 **Browser Bridge** Chrome 扩展 + 微型 daemon 与
 
 完成！运行任何 opencli 浏览器命令时，后台微型 daemon 会自动启动与浏览器通信。无需配 API Token，零代码配置。
 
-> **Tip**：后续诊断用 `opencli doctor`：
+> **Tip**：后续诊断和 daemon 管理：
 > ```bash
 > opencli doctor            # 检查扩展和 daemon 连通性
+> opencli daemon status     # 查看 daemon 状态
+> opencli daemon stop       # 停止 daemon
 > ```
 
 ## 快速开始

docs/guide/browser-bridge.md

@@ -35,3 +35,15 @@ opencli doctor            # Check extension + daemon connectivity
 ```
 
 The daemon manages the WebSocket connection between your CLI commands and the Chrome extension. The extension executes JavaScript in the context of web pages, with access to the logged-in session.
+
+## Daemon Lifecycle
+
+The daemon auto-starts on first browser command and stays alive for **4 hours** by default. It exits only when both conditions are met: no CLI requests for the timeout period AND no Chrome extension connected.
+
+```bash
+opencli daemon status    # Check daemon state (PID, uptime, extension, memory)
+opencli daemon stop      # Graceful shutdown
+opencli daemon restart   # Stop + restart
+```
+
+Override the timeout via the `OPENCLI_DAEMON_TIMEOUT` environment variable (milliseconds). Set to `0` to keep the daemon alive indefinitely.

docs/guide/troubleshooting.md

@@ -20,17 +20,22 @@
 ### Daemon issues
 
 ```bash
-# Check daemon status
-curl localhost:19825/status
+# Check daemon status (PID, uptime, extension connection, memory)
+opencli daemon status
 
 # View extension logs
 curl localhost:19825/logs
 
-# Kill and restart daemon
-pkill -f opencli-daemon
+# Stop or restart the daemon
+opencli daemon stop
+opencli daemon restart
+
+# Full diagnostics
 opencli doctor
 ```
 
+> The daemon auto-exits after 4 hours of inactivity (no CLI requests and no extension connection). Override with `OPENCLI_DAEMON_TIMEOUT` (milliseconds, `0` = never timeout).
+
 ### Desktop adapter connection issues
 
 For Electron/CDP-based adapters (Cursor, Codex, etc.):