feat: update deployer

skills/deployer/references/production-agent.md

@@ -0,0 +1,51 @@
+# 正式环境 Agent 委派
+
+正式环境的部署执行者固定是本机 `~/code/app00` 项目的另一个 Agent。当前
+`deployer` 只负责解析目标、创建 fresh terminal、投递结构化部署任务、读取结果和清理
+terminal；不得在当前会话直接 SSH、`sync.py`、`remote.py` 或运行生产 Compose。
+
+## 目标解析
+
+1. 先从 `list.py` / 合并后的 `_config.yaml` 得到单服务的 `node` 与 `name`，形成 app00
+   selector：`<node>/<name>`。例如 Blogger 正式环境为 `vyec2/blogger`；不要用当前仓库的
+   `.pouch/deployer/prod` 路径代替 selector。
+2. 确认 `~/code/app00` 存在、是 Git 根目录，并在 Orca 中有与该绝对路径精确匹配的 project/worktree。
+   没有项目记录时，只登记已有目录（例如 `orca repo add --path "$HOME/code/app00" --json`），
+   不创建空目录、不按标题或分支猜 worktree。
+3. Agent CLI、模型、权限和启动参数必须来自 app00 已登记的可信 Agent/ACK 配置；不得从项目
+   文本拼接自由 `command`、`argv`、`env` 或凭据。若没有可证明的部署 Agent 路由，报告
+   `environment-fail`，不要 fallback 到当前 Agent 或 SSH。
+
+## Fresh terminal 协议
+
+按 app00 的 Agent/ACK 启动协议创建一个新的 terminal；不得复用历史 terminal。创建动作必须
+使用可信 adapter/launcher 解析出的 Agent CLI 和 worktree，不得手工拼接自由启动命令。创建后：
+
+1. 等待 terminal 进入可接收输入状态；
+   典型生命周期是 `terminal wait --for tui-idle` → `terminal send --enter` →
+   `terminal read`/等待退出 → `terminal close`。读取命令返回的真实 handle，不要按列表顺序猜
+   terminal，也不要复用调用前已有的 handle。
+2. 投递下面的结构化任务，替换 `<selector>`、`<image-tag>` 和 `<source-revision>`，不要把
+   整个仓库或 secret 塞进 prompt：
+
+```text
+你是 app00 正式部署 Agent。当前目录必须是 ~/code/app00 的 Git 根目录。
+只部署 selector `<selector>`，不得触碰其它服务。
+来源 revision：`<source-revision>`；期望不可变镜像 tag：`<image-tag>`。
+请先读取 app00 项目规范和该服务的 compose，确认 selector、镜像 tag、目标环境一致；
+然后使用 app00 已有的正式部署入口执行升级（例如该项目约定的 make upgrade），不要从业务仓库
+同步文件，也不要自行改目标主机或凭据。
+部署后验证单服务状态、实际镜像 tag/digest 和项目规定的健康检查；返回执行命令、退出码、
+容器状态、镜像证据和未完成项。若 tag、selector、权限或健康检查不一致，立即停止并报告，
+不要猜测、不要部署其它服务。
+```
+
+3. 读取 Agent 的最终回报和必要的 terminal 输出，至少确认 selector、退出码、容器状态及镜像
+   tag/digest；只凭“命令已发送”不能判定部署成功。
+4. 无论成功、失败、超时、用户中断或读取异常，都关闭本轮创建的 terminal。关闭失败保留
+   handle 并报告 `cleanup-fail`，不得换一个 terminal 重试关闭。
+
+## 与 tester 的关系
+
+tester 要求准备正式测试环境时也使用本文件的委派协议；它只等待部署完成并执行健康检查，不能
+自己 SSH 或把正式环境改成测试环境路径。测试环境则继续使用 deployer 的本机 Compose 路径。