aut-cli 0.13.0 → 0.15.0

package/README.md

@@ -37,6 +37,120 @@ aut token scopes
 更新原连接不接受 `--device` 或 `--expires-in`，避免隐式改名或延长授权。
 若浏览器已确认但终端网络中断，先运行 `aut whoami` 同步；原 token 保留，不需恢复新 secret。
 
+## 0.15.0：共享合作 v2 与结案
+
+补齐共享工作区定位、多轮交付预览/提交/分页/固定版本下载、三态验收与补交期限、发布方结案查询和重试。
+所有命令保留明确 Party；写入还需要 Agent 署名、精确 revision 和稳定幂等键。工作区命令只返回目标，
+不会修改项目绑定、连接或凭据授权。旧 v1 命令保留；遇到 v2 会要求使用明确的新协议，不自动降级。
+
+```sh
+aut collaboration workspace COLLABORATION --as-party PARTY
+aut publisher task workspace TASK --round 1 --as-party PARTY
+aut track add WORKSPACE_TRACK progress.md --type progress --collaboration COLLABORATION --contribution-scope personal --agent-name codex --key progress-001
+aut collaboration delivery preview COLLABORATION --file preview.json --expect-revision REV --as-party PARTY --agent-name codex --key preview-001
+aut collaboration delivery preview-items PREVIEW --limit 20 --as-party PARTY
+aut collaboration delivery submit COLLABORATION --preview PREVIEW --manifest-sha256 PREVIEW_HASH --expect-revision REV --as-party PARTY --agent-name codex --key submit-001
+aut collaboration delivery ls COLLABORATION --as-party PARTY
+aut collaboration delivery get VERSION --collaboration COLLABORATION --as-party PARTY
+aut collaboration delivery items VERSION --collaboration COLLABORATION --manifest-sha256 VERSION_HASH --as-party PARTY
+aut collaboration delivery reviews VERSION --collaboration COLLABORATION --manifest-sha256 VERSION_HASH --as-party PARTY
+aut collaboration delivery file download VERSION FILE_REF --collaboration COLLABORATION --manifest-sha256 VERSION_HASH --output delivery.zip --as-party PARTY
+```
+
+`preview.json` 是 `{body_text,workspace_through_seq,file_ids?,extra_entry_ids?,agreement_change_id:null|ID}`。
+`workspace_through_seq` 取实际读到的位置；最后一项必须明确给出当前生效变更或 null。`commit` JSON 支持
+顶层 `work_context: {collaboration_id?,contribution_scope:"personal"|"shared"}`，保留原生内容提交语义。
+
+**提交请求用 PREVIEW_HASH；后续验收用提交回执的 VERSION_HASH，两者不同。**
+分页按原目标、Party、limit 和服务端 next_cursor 继续；游标失效直接报错，不静默重新开始。
+下载使用版本内的 FILE_REF 并核验大小与 SHA-256。每个写入只提交一次；不明结果先核对原 key，
+不会通过新预览、新 key 或当前版本重放。明确 v2 的写入直接进入支持幂等的版本化接口。
+
+```sh
+aut collaboration review COLLABORATION --workflow-version 2 --file review.json --expect-revision REV --as-party PARTY --agent-name codex --key review-001
+aut publisher task completion TASK --round 1 --as-party PARTY
+aut publisher task completion-preview TASK --round 1 --as-party PARTY
+aut publisher task completion-get COMPLETION --as-party PARTY
+aut publisher task completion-submit TASK --round 1 --expect-workspace-revision WR --roster-revision RR --manifest-sha256 HASH --as-party PARTY --agent-name codex --key close-001
+aut publisher task completion-retry COMPLETION --expect-revision REV --as-party PARTY --agent-name codex --key retry-001
+aut publisher task completion-file download COMPLETION ARCHIVE_REF --output archive.zip --as-party PARTY
+```
+
+`review.json` 固定 `submission_id`、`manifest_sha256` 和 `decision: accept|request_changes|reject_final`。
+后两者需 `reason`；只有 `request_changes` 必须带含时区的 `revision_due_at`。不把旧 `reject` 自动转换。
+内容审核中、要求补交、补交逾期、个人验收通过、Task 合并中和合并阻塞分别保留。
+个人通过不表示全部席位已结束，也不表示结案合并完成。后台正常自动推进结案；手动提交/重试保留精确屏障。
+结案 API 没有 `agent_name` 字段，CLI 仍要求调用署名但不会发送不支持的 DTO 字段。
+
+能力门控与发布 v2 相同：三项能力缺失直接失败；可选探测403时由明确 v2 业务接口判定，不扩权。
+随包 aut skill 升级到 0.15.0，新增命令、角色/范围限制与回执恢复说明；官方 0.14 安装可备份后原位升级。
+
+Track、Solution 和合作交付的新上传都把本地 basename 作为 `filename` 发送；不会发送目录。
+文件名保留原始 Unicode，最多 255 UTF-8 字节，不接受首尾空白、控制/格式字符或路径分隔符。
+新检查点在创建请求前固定文件名、字节摘要及命令摘要，创建回执丢失后仍以原 key/原输入恢复。
+旧检查点继续原有无 `filename` 的命令摘要和请求，不因升级补字段。
+
+仅当旧客户端的创建请求已发出、回执丢失且没有检查点时，在**原上传命令**加
+`--legacy-no-filename`（`file upload` 或 `solution file upload`）明确恢复旧请求。
+此选项不用于普通新上传，也不会自动由 409 触发；已有带文件名的新检查点拒绝切换旧格式。
+固定交付及结案归档下载回执保留服务端原文件名，同时继续核验文件大小与 SHA-256。
+
+
+## 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 写入不自动重放。