fix(coordinator): make bootstrap non-blocking

.secrets.baseline

@@ -114,47 +114,7 @@
         "filename": ".github/workflows/release-please.yml",
         "hashed_secret": "3e26d6750975d678acb8fa35a0f69237881576b0",
         "is_verified": false,
-        "line_number": 34,
-        "is_added": false,
-        "is_removed": false
-      }
-    ],
-    "src/opencode_agent_hub/daemon.py": [
-      {
-        "type": "Secret Keyword",
-        "filename": "src/opencode_agent_hub/daemon.py",
-        "hashed_secret": "c41e49700c9c5e1766fc3ef8e8f36b0ce92326ff",
-        "is_verified": false,
-        "line_number": 435,
-        "is_added": false,
-        "is_removed": false
-      },
-      {
-        "type": "Secret Keyword",
-        "filename": "src/opencode_agent_hub/daemon.py",
-        "hashed_secret": "01316b806f30c57b1da2a281f514ba0e77e1c43e",
-        "is_verified": false,
-        "line_number": 436,
-        "is_added": false,
-        "is_removed": false
-      },
-      {
-        "type": "Secret Keyword",
-        "filename": "src/opencode_agent_hub/daemon.py",
-        "hashed_secret": "6267a72c61ecec32905226262bacc75cf6a91301",
-        "is_verified": false,
-        "line_number": 437,
-        "is_added": false,
-        "is_removed": false
-      },
-      {
-        "type": "Secret Keyword",
-        "filename": "src/opencode_agent_hub/daemon.py",
-        "hashed_secret": "2b48a76df3b7c706ddfe518edc5fdae481feb0c2",
-        "is_verified": false,
-        "line_number": 438,
-        "is_added": false,
-        "is_removed": false
+        "line_number": 34
       }
     ],
     "src/opencode_agent_hub/watch.py": [
@@ -163,18 +123,14 @@
         "filename": "src/opencode_agent_hub/watch.py",
         "hashed_secret": "cf0c39294e269cafab08ee2d0702885981e99951",
         "is_verified": false,
-        "line_number": 284,
-        "is_added": false,
-        "is_removed": false
+        "line_number": 284
       },
       {
         "type": "Secret Keyword",
         "filename": "src/opencode_agent_hub/watch.py",
         "hashed_secret": "64e35dc98f89e69055d58e1c89d11ec2ba50dbb8",
         "is_verified": false,
-        "line_number": 285,
-        "is_added": false,
-        "is_removed": false
+        "line_number": 285
       }
     ]
   },

CONTRIBUTING.md

@@ -108,11 +108,15 @@ Releases are automated via [release-please](https://github.com/google-github-act
 ├── AGENTS.md               # Optional coordinator instructions override
 └── COORDINATOR.md          # Alias for AGENTS.md
 
-Daemon watches these directories and:
-1. Detects new messages via watchdog
-2. Looks up target agent's OpenCode session (by session ID, not directory)
-3. Injects message via OpenCode HTTP API
-4. Marks message as delivered
+~/.local/share/opencode/
+└── opencode.db             # Shared SQLite database (all sessions)
+
+Daemon:
+1. Polls SQLite DB for new sessions (primary discovery mechanism)
+2. Detects new messages via watchdog on ~/.agent-hub/messages/
+3. Looks up target agent's OpenCode session (by session ID, not directory)
+4. Injects message via OpenCode HTTP API (prompt_async)
+5. Marks message as delivered
 ```
 
 ### Session-Based Agent Identity
@@ -124,6 +128,8 @@ Multiple OpenCode sessions in the same directory each get a unique agent identit
 
 ## Testing
 
+### Unit Tests
+
 Tests use pytest:
 ```bash
 uv run pytest -v
@@ -133,3 +139,35 @@ For coverage:
 ```bash
 uv run pytest --cov=opencode_agent_hub --cov-report=html
 ```
+
+### Integration Testing (Manual)
+
+To test session discovery, orientation, and multi-agent coordination end-to-end,
+you need to run the daemon and watch dashboard, then spin up TUI sessions.
+
+**Terminal 1 — Daemon:**
+```bash
+uv run agent-hub-daemon
+```
+
+**Terminal 2 — Watch dashboard:**
+```bash
+uv run agent-hub-watch
+```
+
+**Terminal 3+ — TUI sessions:**
+```bash
+opencode                    # default model
+opencode --agent kimi       # specific agent/model
+```
+
+**What to verify:**
+- The daemon detects new TUI sessions within ~5 seconds (watch the daemon logs)
+- New sessions receive an orientation message from the coordinator
+- The watch dashboard shows the session and its agent identity
+- Messages sent between agents are delivered (check `~/.agent-hub/messages/`)
+
+The daemon discovers sessions by querying OpenCode's shared SQLite database at
+`~/.local/share/opencode/opencode.db`. All OpenCode processes (TUI and serve)
+share this database, so the daemon sees every session regardless of how it was
+started.

contrib/coordinator/AGENTS.md

@@ -6,6 +6,12 @@ You are the **coordinator** for a multi-agent system. Your job is to facilitate
 
 Your value is making agents aware of each other. Once they're talking directly, **stay out of it**.
 
+## Session Mode
+
+- This session is non-interactive.
+- Never ask the human user anything.
+- Never use the `question` tool.
+
 ## Your Responsibilities
 
 1. **Capture tasks** - When notified of a new agent, ask what they're working on (ONE message)

contrib/coordinator/opencode.json

@@ -1,5 +1,6 @@
 {
   "$schema": "https://opencode.ai/config.json",
+  "model": "opencode/minimax-m2.5-free",
   "permission": [
     {"permission": "agent-hub_*", "pattern": "*", "action": "allow"},
     {"permission": "question", "pattern": "agent-hub*", "action": "allow"},