Runbook: live cron line, state dir, concurrency 0, P1-5 cutover notes

docs/runbook.md

@@ -19,10 +19,14 @@ cd ~/.local/share/server-access-client && python3 -I agent-access.py \
   --secret-env PLANE_WINDOW10_API_TOKEN=PLANE_WINDOW10_API_TOKEN \
   --timeout 900 -- /home/ubuntu/Documents/wjj/project/plane-agentd/cli/agentd tick --once
 ```
-crontab（每 2 分钟；tick 有文件锁，重叠的 tick 直接跳过）：
+crontab（oregon 实际在用，每 2 分钟）：
 ```
-*/2 * * * * cd $HOME/.local/share/server-access-client && python3 -I agent-access.py --config https://nas.tail9531b.ts.net:8443/identity/agent.json exec --secret-env PLANE_OREGON_API_TOKEN=PLANE_OREGON_API_TOKEN --secret-env PLANE_WINDOW10_API_TOKEN=PLANE_WINDOW10_API_TOKEN --timeout 900 -- $HOME/Documents/wjj/project/plane-agentd/cli/agentd tick --once >> $HOME/Documents/wjj/project/plane-agentd/state/cron.log 2>&1
+*/2 * * * * /home/ubuntu/Documents/wjj/project/plane-agentd/cron/agentd-tick.sh
 ```
+`cron/agentd-tick.sh` = `flock -n ~/.gwent-board/agentd.lock timeout 900 python3 -I agent-access.py --config <identity> exec --secret-env PLANE_OREGON_API_TOKEN=… --secret-env PLANE_WINDOW10_API_TOKEN=… --timeout 850 -- python3 cli/agentd tick --once >> ~/.gwent-board/agentd-cron.log 2>&1`。空闲 tick 不打印任何东西（cron 日志为空是正常的），活着与否看 `heartbeat.json` 的 `at`；`skip: another tick holds …` 表示与手工 tick/smoke 撞锁，无害。
+实际配置 `config/agentd.yaml`（已提交，不含密钥）：`state_dir: ~/.gwent-board/agentd`，所以下表的 `state/…` 在 oregon 上是 `~/.gwent-board/agentd/…`。
+暂停一个终端（不再派新运行、也不探测，在途运行照常收尾）：把它的 `concurrency` 设为 0。
+
 常驻替代：`... exec ... -- cli/agentd tick --loop --interval 120`（vault 会话超时要够长，cron 更稳）。
 cron 的 PATH 很短：本机执行器的二进制用终端 `bins` 写绝对路径（如 `claude: /home/ubuntu/.local/bin/claude`）。
 
@@ -78,3 +82,11 @@ Todo + 指派给终端用户 → agentd 选最小编号、终端有空位、串
 | Plane 回帖失败 | 在途记录保留，下一 tick 重新 collect 并回帖（可能重复一条评论） |
 | 想手工终止一轮 | 把工作项移出 In Progress（如 Waiting）即可，下一 tick agentd 自己 kill 并释放槽位。中继不通、kill 一直失败时：在终端上手工结束（本机 `kill -TERM -<pid.txt>`，win10 `taskkill /T /F /PID <pid.txt>`），停 cron 后从 `state/agentd-state.json` 删掉该项的 `inflight` |
 | `已连续 N 轮 [progress]` | 达到 `max_progress_rounds`：看最近几轮是否在原地打转；拆分任务或补充说明后移回 Todo |
+
+## 切换记录（2026-10-21，P1-5）
+- 旧 worker `gwent-design/tools/board-worker-plane.py`（cron `board-worker-plane-cron.sh`）已从 crontab 移除；脚本与 `~/.gwent-board/plane-state.json`、`plane-worker.log` 保留作历史，不要再启用（两者会抢同一批 window10 的 Todo 项）。
+- 切换时旧 worker 无在途运行（GW-6 的 board-6-2 已于 06:30 以 `[blocked]` 结束，项在 Waiting）。GW-6 的 codex 线程 `01a15ce3…` 已迁入 agentd 状态（`runs=2`、`thread_on=[win10, codex]`、旧评论标为已见），移回 Todo 并指派 window10 时 agentd 续这个线程，run id 从 `GW-6-3` 起。
+- 运行目录变了：旧 worker 用 win10 `runtime\board\board-<n>-<k>`，agentd 用 `runtime\agentd\GW-<n>-<k>`。
+- 冒烟：oregon（GW-7，claude-code/sonnet，约 30 s）与 win10（GW-8，codex/gpt-6.1-sol/fast，约 3.5 min）均 PASS。win10 上验证过：`codex exec resume` 也会输出 `thread.started`（与原线程同 ID）；续线程时 `-c sandbox_mode="workspace-write"` 生效，能在仓库内写文件；把运行中的项移出 In Progress 后，`taskkill /T /F /PID <pid.txt>` 结束了整棵树（runner powershell → codex.exe → code-mode-host / command-runner → powershell），`Get-Process codex` 归零，计划任务被删除。
+- 差异：旧 worker 对没有 model 标签的项用 sol + `service_tier="fast"`；agentd 只在有 `model:sol` 标签时加 fast，无标签项跑 sol/medium 不加 fast。需要 fast 就打 `model:sol`。
+- win10 上 codex 的 stderr 常见 websocket 连接被拒（`os error 10061`，`wss://chatgpt.com/...`）后回退成功；只有运行失败时它才出现在失败说明的尾部，不影响分类（不匹配临时性模式）。