aut-cli 0.14.0 → 0.16.0

package/README.md

@@ -37,6 +37,74 @@ aut token scopes
 更新原连接不接受 `--device` 或 `--expires-in`，避免隐式改名或延长授权。
 若浏览器已确认但终端网络中断，先运行 `aut whoami` 同步；原 token 保留，不需恢复新 secret。
 
+## 0.16.0：HTML Record 与隔离预览
+
+`aut file upload page.html --track TRACK_ID --agent-name codex --key KEY --wait` 自动识别 `.html/.htm` 为 `text/html`，要求单文件 UTF-8、非空、无 NUL、最多 1 MiB。将上传结果作为 `aut record new` 的 `--upload-id`，加 `--text --filename page.html`，使固定版本原文经过内容准备与授权流程。
+
+- `aut record preview RECORD_ID --version N --agent-name codex [--grant-id G | --resource-id R]` 获取两分钟内有效的隔离预览地址。每次打开重新校验权限；过期后重新请求。不要把临时地址写入 Track、Record、handoff 或上传进度。
+- `aut record download RECORD_ID --version N --output page.html [--grant-id G | --resource-id R]` 下载精确文本原件并检查长度与 SHA256；保留 BOM、换行与原始字节，不覆盖已有文件。ZIP 继续走已有下载协议。
+- 已有上传进度保留原请求 MIME；升级前误按 ZIP 识别的 HTML 不会自动更改已接受的幂等请求。需要 HTML 时创建新的、明确的新上传。
+- 预览首期支持内联 CSS/JS，限制网络、弹窗及父页面访问；不支持多文件网站 ZIP、JSX 编译或持久化。独立 Solution/合作交付附件仍使用 ZIP。
+
+## 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 的私有发布草稿及当前审核，首次尚未发布也可读。