deploy-akashic

部署当前 Akashic

本回合负责检查、合并和提交。宿主负责等待回复送达、停止、迁移与启动。 成功接单不等于更新成功；提交之后不再操作，让本回合正常结束。

┌────────────── Agent 当前回合 ──────────────┐
│ 检查 → 合并 → 固定 SHA → Shell submit → 最终回复 │
└──────────────────────┬───────────────────┘
                       ▼
┌────────────── 宿主独立 systemd worker ──────┐
│ 预检 → 核对完成与送达 → 关闭准入并排空 → 更新 │
└───────────────────────────────────────────┘

前提由部署者一次性准备：安装支持此流程的 Docker 版本及宿主 CLI， 运行用户的 systemd manager 已启动并启用 linger，现有发布器所需的 非交互 sudo、Docker、mise 和 Git 权限已验证。旧 Supervisor 版本需先由 部署者更新一次；Agent 不尝试在缺少停止协议的旧实例内自举。 提交会先保留原调用的送达凭据；--timeout（默认 600 秒）包含凭据保留预算， 构建较慢时在最后提交命令显式提高，最大 3600 秒。

1. 从用户请求确定允许合并的 PR 和备份选择；“提 PR”不授权合并或部署。

2. 用 Shell 的 gh pr view / gh pr checks 核对目标 head、依赖和 CI。 合并使用 gh pr merge <number> --squash --match-head-commit <head-sha>。 检查失败、head 改变或未解决冲突时停止部署，说明真实原因。

3. 所有获授权 PR 合并后，用 git ls-remote --exit-code origin refs/heads/main 取得唯一完整 40 位 SHA。宿主会准备干净 checkout；不需要在运行目录拉代码。

4. 把下面命令作为最后一次 Shell 操作，单独执行：

   akashic-release submit --commit <完整SHA>
   

   仅在本次明确要求备份时加 --backup；默认不备份。 CLI 自动读取 Shell 的当前调用身份，不需要填写 session、Turn 或 boot ID。 如 shell 提前返回运行句柄，先用现有 write_stdin 等待同一个命令退出。 接单成功应包含 status: accepted、requestId 和目标 SHA。

5. 正常回复用户：“已提交更新 ，任务编号 。本轮结束后，宿主会等待其他工作收尾再更新；这不是更新成功回执。” 接单成功后不再查状态、不 load_tools、不运行 Shell、不要求用户继续，也不等待重启。 必须产生普通最终回复，让 Turn 完整结束。

失败时如实报告，不能把正在执行、submitting 或 failed 说成已接单。 响应不明时不换调用重交；宿主按原调用去重。使用原任务编号查询实际状态。

后续用户明确要求查询时，在新的回合执行：

akashic-release status <requestId>
journalctl --user -u akashic-deploy-<requestId>.service --no-pager -n 80

如果无法启动用户 systemd service，或宿主发布权限未配置，交给部署者修复。 不使用 sleep、nohup、后台 shell、kill、docker restart 或直接 systemctl stop 来更新自己。 宿主等待超时、发送失败或旧 boot 被替换时会拒绝更新；既有消息保留。