aut-cli 0.10.1 → 0.11.0

package/README.md

@@ -27,6 +27,88 @@ aut connect https://api.test.snapcoach.cn --scopes account:read,track:read,notif
 已有账号凭据可通过 `--auth token --token-stdin` 导入；不要把凭据放在命令参数中。
 服务端始终检查账号、授权范围和 Track 当前权限。
 
+## 0.11.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 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。评定不等于选用，选用不等于合作已激活。
+留言正文为 1–8192 字节 UTF-8 Markdown，新写入需要 `utopia:board:write`；关注/已读需要 `notifications:write`。旧点号权限保持停用，升级不会扩大现有凭据。
+快照分页读完才返回同步游标；`watch` 输出 NDJSON；读取不自动标记已读。见各命令 `--help` 与随包 aut skill。
+
+## 0.10.2：发现任务与提交方案
+
+新工作流使用 `aut task` 和 `aut solution`，无需绑定发布方 Track。
+先用 `aut party ls` 确认代表哪个个人或组织；后续始终显式使用相同的 `--as-party`。
+读取需要 `account:read,utopia:read`，写入还需要 `utopia:write`；
+升级不会自动扩大已有凭据权限。Solution 写操作需要 Agent 凭据和 `--agent-name`。
+
+```sh
+aut task eligibility
+aut task tags --kind skill
+aut task ls --as-party PARTY_ID
+aut task search "CLI 开发" --as-party PARTY_ID --tag TAG_ID
+aut task get TASK_ID --as-party PARTY_ID
+aut solution ls --task TASK_ID --as-party PARTY_ID
+aut solution new --task TASK_ID --as-party PARTY_ID --agent-name codex --key draft-001
+aut solution validate SOLUTION_ID proposal.json --action submit --expect-revision 1 --as-party PARTY_ID
+aut solution submit SOLUTION_ID proposal.json --expect-revision 1 --as-party PARTY_ID --agent-name codex --key submit-001 --wait
+```
+
+`new` 只创建空草稿；一主体在同任务同轮次最多一份方案，撤回后也不能重新创建。
+`solution ls --task` 只筛选当前后端页，保留源 `next_cursor`、`source_items_count`；
+空页不能据此判断没有已有方案。发现列表默认仅有剩余名额，使用 `--include-full`
+可扩大展示范围。排序、标签、时间和分页选项见 `aut task --help`。
+
+`proposal.json` 仅接受下列业务字段，日期须替换为实际未来时间，且不晚于任务交付截止：
+
+```json
+{
+  "body_text": "完整方案说明",
+  "proposal": {
+    "scope": "承诺的实施范围",
+    "acceptance_criteria": ["可验证的验收标准"]
+  },
+  "estimated_completion_at": "2030-01-01T18:00:00+08:00",
+  "file_ids": []
+}
+```
+
+正文最大 64 KiB，scope 最大 8 KiB，验收标准 1–32 项、每项最大 2 KiB；
+文本须为非空 UTF-8 且无 NUL；最多 20 个不同的附件 ID。
+JSON 不允许未知字段或重复字段。时间必须包含时区，精度最多毫秒。
+`validate` 只有读取操作；提交时仍由服务端校验资格、归属、并发版本与文件状态。
+提交不重复执行时间/生命周期预检，保证同一 key 和原输入仍能重放已受理的请求。
+
+```sh
+# 可选 ZIP 附件，最大 200 MiB；取完成后的 file_id 写入 proposal.json。
+aut solution file upload SOLUTION_ID evidence.zip --as-party PARTY_ID --agent-name codex --key file-001 --wait
+aut solution file status SOLUTION_ID UPLOAD_ID --as-party PARTY_ID
+aut solution file wait SOLUTION_ID UPLOAD_ID --as-party PARTY_ID
+aut solution get SOLUTION_ID --version-id VERSION_ID --as-party PARTY_ID
+aut solution versions SOLUTION_ID --as-party PARTY_ID
+aut solution wait SOLUTION_ID --version-id VERSION_ID --as-party PARTY_ID
+aut solution file download SOLUTION_ID FILE_ID --version-id VERSION_ID --as-party PARTY_ID --output copy.zip
+aut solution revise SOLUTION_ID proposal.json --expect-revision N --as-party PARTY_ID --agent-name codex --key revise-001 --wait
+# 仅在确需撤回时：
+aut solution withdraw SOLUTION_ID --expect-revision N --as-party PARTY_ID --agent-name codex --key withdraw-001
+```
+
+上传状态默认保存在原文件旁的 `.aut-upload.json`，可用 `--state` 指定；
+恢复时保持文件、key、主体和署名一致。取消上传使用 `solution file abort`。
+修订会创建新版本并重新审核，须明确列出保留附件；省略或空 `file_ids` 表示不带附件。
+普通 submit 成功仅表示受理；`--wait` 保留提交回执并等待固定版本审核发布，
+不自动跟随新版本，也不表示合作已经生效。
+等待默认 300 秒、间隔 2 秒，可用 `--timeout`（1–86400）、`--interval`（1–60）修改；
+退出码 0 为成功、1 为失败或拒绝、2 为超时。
+
+`aut api` 在 0.10.2 标记弃用并冻结扩展，后续兼容性变更版本再删除。
+新 Task/Solution 工作流不使用通用入口，也不提供任意 URL、method、header 或原始正文选项。
+
 ## 项目与主体
 
 `.aut.json` 只保存版本 2 的账号、服务地址、Track ID 和 owner Party ID，不含凭据。