Unify TUI runtime commands with gateway and harden gateway restart

docs/plans/state.json

@@ -53,6 +53,54 @@
       ],
       "test_status": "pnpm test:run src/daemon/routing.test.ts + pnpm typecheck passing"
     },
+    "openclaw-gateway-first-tui-runtime-unification": {
+      "status": "completed",
+      "date": "2026-02-24",
+      "updated": "2026-02-24",
+      "summary": "Unified runtime backend mode control across channel router, gateway, and TUI by extracting a shared backend-mode command service, wiring gateway `agent.send` to that shared service, and forwarding minimal/fullscreen TUI `/runtime` through a gateway bridge. `flynn tui` now auto-attaches to gateway and auto-starts local daemon+gateway when unavailable while preserving TUI-local `/backend [provider]` switching.",
+      "files_modified": [
+        "src/commands/runtimeBackendMode.ts",
+        "src/commands/index.ts",
+        "src/daemon/routing.ts",
+        "src/daemon/index.ts",
+        "src/daemon/services.ts",
+        "src/gateway/server.ts",
+        "src/gateway/handlers/agent.ts",
+        "src/gateway/handlers/agent.test.ts",
+        "src/cli/tuiRuntimeGateway.ts",
+        "src/cli/tuiRuntimeGateway.test.ts",
+        "src/cli/tui.ts",
+        "src/frontends/tui/fullscreen.ts",
+        "src/frontends/tui/components/App.tsx",
+        "src/frontends/tui/minimal.ts",
+        "src/frontends/tui/minimal.test.ts",
+        "src/frontends/tui/commands.ts",
+        "README.md",
+        "docs/architecture/AGENT_DIAGRAM.md",
+        "docs/architecture/GATEWAY_SESSIONS_AND_QUEUE.md",
+        "docs/api/PROTOCOL.md",
+        "docs/plans/state.json"
+      ],
+      "test_status": "pnpm test:run src/cli/tuiRuntimeGateway.test.ts src/frontends/tui/commands.test.ts src/frontends/tui/minimal.test.ts src/gateway/handlers/agent.test.ts src/daemon/routing.test.ts src/commands/builtin/index.test.ts + pnpm typecheck passing"
+    },
+    "gateway-startup-eaddrinuse-hardening": {
+      "status": "completed",
+      "date": "2026-02-24",
+      "updated": "2026-02-24",
+      "summary": "Hardened gateway startup bind-failure handling so port collisions (`EADDRINUSE`) are rejected deterministically instead of surfacing as an unhandled WebSocketServer error event. Added clearer daemon startup error text, reordered startup to bind gateway before channel adapters (avoiding noisy channel teardown on bind failures), added bounded bind-retry logic for short restart races, made TUI auto-start treat `EADDRINUSE` as an attach race (retry connect) rather than immediate failure, and updated `make daemon-start`/`make daemon-restart` to rebuild before service start/restart so runtime fixes are always reflected in `dist`.",
+      "files_modified": [
+        "Makefile",
+        "README.md",
+        "src/gateway/server.ts",
+        "src/gateway/server.test.ts",
+        "src/daemon/services.ts",
+        "src/daemon/startServices.test.ts",
+        "src/cli/tuiRuntimeGateway.ts",
+        "src/cli/tuiRuntimeGateway.test.ts",
+        "docs/plans/state.json"
+      ],
+      "test_status": "pnpm test:run src/gateway/server.test.ts src/cli/tuiRuntimeGateway.test.ts src/daemon/startServices.test.ts src/daemon/services.test.ts src/daemon/routing.test.ts src/frontends/tui/minimal.test.ts + pnpm typecheck passing"
+    },
     "pi-embedded-backend-canary-evaluation-phase": {
       "status": "completed",
       "date": "2026-02-24",
@@ -6510,7 +6558,7 @@
     }
   },
   "overall_progress": {
-    "total_test_count": 1996,
+    "total_test_count": 2009,
     "all_tests_passing": true,
     "p0_completion": "3/3 (100%)",
     "p1_completion": "4/4 (100%)",
@@ -6543,7 +6591,9 @@
     "next_up": "Track OpenClaw evolution regularly for inspiration and feature ideas",
     "pi_embedded_canary_spike": "completed — added optional pi_embedded backend adapter, canary-safe no-tools routing guard, backend success/fallback latency audit events, and docs/diagram updates while native remains default",
     "pi_embedded_evaluation_phase": "completed — final decision rollback (applied in runtime config): Window A failed latency/fallback gates (p50 +259ms, p95 +5695ms, fallback 25%, categories: pi_module_interface/empty_assistant_text); Window B remained sample-insufficient; controlled probes verified guard coverage (pi_no_tools_mode/capability_query/attachments_present each hit once)",
-    "pi_embedded_manual_mode": "completed — added persisted runtime backend controls for manual Pi activation/deactivation (`/runtime` preferred, `/backend` alias; `status`, `activate pi`, `deactivate pi`, `use config`) while keeping config-driven default routing"
+    "pi_embedded_manual_mode": "completed — added persisted runtime backend controls for manual Pi activation/deactivation (`/runtime` preferred, `/backend` alias; `status`, `activate pi`, `deactivate pi`, `use config`) while keeping config-driven default routing",
+    "openclaw_gateway_first_tui_runtime_unification": "completed — shared `/runtime` backend-mode command service across channel router + gateway, plus TUI `/runtime` forwarding through a gateway bridge with daemon/gateway auto-start attach",
+    "gateway_startup_eaddrinuse_hardening": "completed — gateway bind collisions now fail deterministically with explicit error handling and TUI auto-start treats EADDRINUSE as attach race with connect retry"
   },
   "soul_md_and_cron_create": {
     "date": "2026-02-11",