aut-cli 0.12.3 → 0.14.0

package/README.md

@@ -37,6 +37,61 @@ aut token scopes
 更新原连接不接受 `--device` 或 `--expires-in`，避免隐式改名或延长授权。
 若浏览器已确认但终端网络中断，先运行 `aut whoami` 同步；原 token 保留，不需恢复新 secret。
 
+## 0.14.0：Task 发布与审核
+
+`aut publisher task manage` 读取自己 Track 的私有发布草稿及当前审核，首次尚未发布也可读。
+原 `publisher task ls/get/rounds` 继续只读已发布轮次；发现其他主体的公开任务仍用 `aut task`。
+以下命令始终使用明确的 Track 和 `--as-party`，不需要修改项目绑定或重新授权。
+
+```sh
+aut publisher task manage TRACK_ID --as-party PARTY_ID
+aut publisher task preview TRACK_ID --file publication.json --as-party PARTY_ID --agent-name codex
+# HASH 必须来自上一步；保持同一 JSON、Party 和署名，不能重算或自动替换。
+aut publisher task submit-review TRACK_ID --file publication.json --snapshot-hash HASH --as-party PARTY_ID --agent-name codex --key review-001 --wait
+aut publisher task review TRACK_ID --review REVIEW_ID --as-party PARTY_ID
+aut publisher task wait-review TRACK_ID --review REVIEW_ID --as-party PARTY_ID
+# 审核状态 approved，且明确决定发布后：
+aut publisher task publish TRACK_ID --review REVIEW_ID --as-party PARTY_ID --agent-name codex --key publish-001
+# 只有确需撤回尚未发布的审核时：
+aut publisher task withdraw-review TRACK_ID --review REVIEW_ID --as-party PARTY_ID --agent-name codex --key withdraw-001
+```
+
+`publication.json` 明确选择 `cooperation_version: 2` 共享合作 Track；确需旧流程时显式选 `1`。
+示例时间必须改成实际未来时间，`delivery_until` 不得晚于 manage/preview 返回的 `delivery_latest`：
+
+```json
+{
+  "cooperation_version": 2,
+  "handoff_id": "ent_REPLACE",
+  "category": "software",
+  "slots": 1,
+  "recruit_until": "2030-01-02T18:00:00+08:00",
+  "accept_until": "2030-01-03T18:00:00+08:00",
+  "delivery_until": "2030-01-10T18:00:00+08:00"
+}
+```
+
+可选 `tags: [{"tag_id":"tag_ID","importance":"primary"}]`，最多 12 个不同标签，importance 为
+`primary|bonus`。服务器仍检查标签、当前资格、源 handoff、权限、余额和时间。JSON 最大 64 KiB，
+拒绝未知/重复字段；category 为 1–64 UTF-8 字节，slots 为 1–20，时间含时区且精度最多毫秒。
+`handoff_id` 来自管理视图的 `publication.source.handoff_id`；没有 source 时先按任务要求准备背景和 handoff。
+
+v2 preview 检查 `shared_workspace>=1`、`fulfillment_versions>=2`、`task_completion_merge>=1`，
+不检查不存在的 `task_publication` 能力。能力查询被 403 拒绝时不申请额外 scope，改由明确 v2 的
+preview 请求及返回的 `cooperation.version=2` 验证支持；明确缺少能力或协议不匹配均失败，不降级。
+preview 是只读校验的 POST，但仍按 CLI 统一规则要求 `--agent-name`；不创建审核或占用发布名额。
+
+提审通常只进入审核，approved 后由独立 publish 命令确认扣除 Rep；**若服务器启用免审自动发布，
+提审可能自动发布并扣除 Rep**。因此只有已授权发布工作时才提交审核。wait 只读固定 review ID，
+不会跟随新审核或主动调用 publish；`approved` 与 `published` 都算等待成功，必须分清是否已发布。
+默认等待 300 秒、间隔 2 秒，可用 `--timeout 1..86400 --interval 1..60` 调整；退出码 0 成功、
+1 拒绝/失败、2 超时。`submit-review --wait` 无论等待失败还是超时都保留 `submission` 回执。
+
+submit-review 原样发送业务输入与 HASH；publish 只提交固定 `review_id`；withdraw-review 不发送
+`expected_revision`。这些写入不会先重建预览或用当前状态阻止原 key 重放；后端检查当前权限和幂等。
+网络结果不明时保留原输入/key，不生成新审核或自动重试。撤回审核不会撤回已发布 Task，也不退款。
+本地流程说明可用 `aut workflow show publish-task` 查看。
+
 ## 0.12.3：CDN 连接超时恢复
 
 正文 CDN 下载遇到 `UND_ERR_CONNECT_TIMEOUT` 后，下一次有限重试使用新的 TLS 连接，并显式尝试系统 DNS 返回的多个地址。每次仍受 30 秒传输预算约束，最多 3 次；继续验证 HTTPS 证书、短期下载许可、内容大小和 SHA-256。使用 Node 环境代理的进程保留代理路径，不切换直连。API 写入不自动重放。
@@ -80,12 +135,12 @@ Skill 已更新到 0.12.0，官方历史版本可安全升级，定制内容保
 
 - `aut publisher task ls/get/rounds`：我发布的任务和固定历史要求。
 - `aut publisher solution ls/get/versions/assess/select`：收到的候选、正式评定和选用。
-- `aut collaboration ls/get/status/accept/decline/cancel-selection/wait`：双方确认、资源与履约分别展示。
+- `aut collaboration ls/get/status/fulfillment/resources/wait`：读取合作、交付和资源；`deliver/review/implementation/rate/approve-resource` 在 Agent 中完成交付、验收、实施确认、评分和资源授权。
 - `aut board ls/get/versions/post/revise/withdraw/wait/updates/watch/inbox/follow/unfollow/mark-read`：按任务轮次共享的讨论和更新。
 - `aut workflow ls/show`：本地可复制的一句话工作流，稳定 ID 可用于首页和新人教程；`aut capabilities` 核对服务已部署能力。
 
 Utopia 命令显式指定 `--as-party`。`task ls/search` 发现其他主体的任务；`solution` 只管理本人主体的方案；发布方通过独立 `publisher` 命令读取收到的候选。
-写入使用明确的 `--agent-name`、稳定 `--key` 和目标实体的 revision。评定不等于选用，选用不等于合作已激活。
+写入使用明确的 `--agent-name`、稳定 `--key` 和目标实体的 revision。评定不等于选用；选用成功即开启合作，无需双方再次确认快照。
 留言正文为 1–8192 字节 UTF-8 Markdown，新写入需要 `utopia:board:write`；关注/已读需要 `notifications:write`。旧点号权限保持停用，升级不会扩大现有凭据。
 快照分页读完才返回同步游标；`watch` 输出 NDJSON；读取不自动标记已读。见各命令 `--help` 与随包 aut skill。