From be9050df55488b7c4c1b5dcdf45c3a46987ed008 Mon Sep 17 00:00:00 2001 From: Codex Date: Sun, 12 Jul 2026 06:41:55 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=94=B6=E5=8F=A3=20Artificer=20task?= =?UTF-8?q?=20=E8=BE=93=E5=85=A5=E4=B8=8B=E9=92=BB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/MDTODO/agentrun-runtime-reliability.md | 4 ++-- docs/MDTODO/cli-output-progressive-disclosure.md | 6 +++--- .../R3.1.1_Task_Report.md | 14 ++++++++++++++ .../R3.1_Task_Report.md | 13 +++++++++++++ 4 files changed, 32 insertions(+), 5 deletions(-) create mode 100644 docs/MDTODO/details/cli-output-progressive-disclosure/R3.1.1_Task_Report.md create mode 100644 docs/MDTODO/details/cli-output-progressive-disclosure/R3.1_Task_Report.md diff --git a/docs/MDTODO/agentrun-runtime-reliability.md b/docs/MDTODO/agentrun-runtime-reliability.md index e4d143ea..e6cd01e9 100644 --- a/docs/MDTODO/agentrun-runtime-reliability.md +++ b/docs/MDTODO/agentrun-runtime-reliability.md @@ -71,8 +71,8 @@ ### R5.1 [in_progress] -解决 [AgentRun #310](https://github.com/pikasTech/agentrun/issues/310)：Artificer 已报告 resource-bundle-materialized 却未物化 primary UniDesk workspace；禁止 agent 自行 clone、借用宿主 worktree 或 trans 源码旁路。旧 task 已错误进入不可变 completed，修复自动交付后须以相同 cadence 与哨兵报告业务目标创建新的 Artificer task，并以 Artificer 自身完成作为验收。，完成任务后将详细报告写入[任务报告](./details/agentrun-runtime-reliability/R5.1_Task_Report.md)。 +解决 [AgentRun #310](https://github.com/pikasTech/agentrun/issues/310)：Artificer 已报告 resource-bundle-materialized 却未物化 primary UniDesk workspace；禁止 agent 自行 clone、借用宿主 worktree 或 trans 源码旁路。旧 task 已错误进入不可变 completed，修复自动交付后须以相同 cadence 与哨兵报告业务目标创建新的 Artificer task，并以 Artificer 自身完成作为验收，完成任务后将详细报告写入[任务报告](./details/agentrun-runtime-reliability/R5.1_Task_Report.md)。 #### R5.1.1 [in_progress] -审核并修复 [AgentRun PR #312](https://github.com/pikasTech/agentrun/pull/312) 的 session workspace 连续性：首次物化精确主仓，但同 session 后续 run/runner 恢复不得清空既有工作树；补齐 source/workspace identity、干净重置边界和回归测试，再由 PR merge 自动交付后用两项固定 Artificer 业务目标验收，禁止主代理代做、agent clone、宿主 worktree、trans 源码旁路或人工 CI/CD。，完成任务后将详细报告写入[任务报告](./details/agentrun-runtime-reliability/R5.1.1_Task_Report.md)。 +审核并修复 [AgentRun PR #312](https://github.com/pikasTech/agentrun/pull/312) 的 session workspace 连续性：首次物化精确主仓，但同 session 后续 run/runner 恢复不得清空既有工作树；补齐 source/workspace identity、安全替换边界和回归测试，再由 PR merge 自动交付后用两项固定 Artificer 业务目标验收，禁止主代理代做、agent clone、宿主 worktree、trans 源码旁路或人工 CI/CD，完成任务后将详细报告写入[任务报告](./details/agentrun-runtime-reliability/R5.1.1_Task_Report.md)。 diff --git a/docs/MDTODO/cli-output-progressive-disclosure.md b/docs/MDTODO/cli-output-progressive-disclosure.md index a4ff09e8..6f174325 100644 --- a/docs/MDTODO/cli-output-progressive-disclosure.md +++ b/docs/MDTODO/cli-output-progressive-disclosure.md @@ -35,13 +35,13 @@ 完善 AgentRun/Artificer 调试资源的语义化逐级披露，使 task 输入、资源引用与脱敏 provenance 可独立读取，不依赖完整资源 dump，完成任务后将详细报告写入[任务报告](./details/cli-output-progressive-disclosure/R3_Task_Report.md)。 -### R3.1 [in_progress] +### R3.1 [completed] 解决 [UniDesk #1819](https://github.com/pikasTech/unidesk/issues/1819)：为两个固定 Artificer task 增加 input/spec 的有界 id-specific CLI 下钻和默认 Next；只改 UniDesk render-only CLI，不提高 stdout 阈值、不修改 AgentRun/Queue/Kafka durable facts，并以真实 task 只读复现验收，完成任务后将详细报告写入[任务报告](./details/cli-output-progressive-disclosure/R3.1_Task_Report.md)。 -#### R3.1.1 [in_progress] +#### R3.1.1 [completed] -在 [UniDesk PR #1821](https://github.com/pikasTech/unidesk/pull/1821) 内修复 `--input` 与 `--full|--raw` 的组合歧义：组合使用必须稳定 fail closed，不能绕过 TaskInput 的 SecretRef-only/valuesPrinted=false 合同；补 CLI 解析测试和两项固定 task 有界只读复验后再合并。，完成任务后将详细报告写入[任务报告](./details/cli-output-progressive-disclosure/R3.1.1_Task_Report.md)。 +在 [UniDesk PR #1821](https://github.com/pikasTech/unidesk/pull/1821) 内修复 `--input` 与 `--full|--raw` 的组合歧义：组合使用必须稳定 fail closed，不能绕过 TaskInput 的 SecretRef-only/valuesPrinted=false 合同；补 CLI 解析测试和两项固定 task 有界只读复验后再合并，完成任务后将详细报告写入[任务报告](./details/cli-output-progressive-disclosure/R3.1.1_Task_Report.md)。 ### R3.2 [in_progress] diff --git a/docs/MDTODO/details/cli-output-progressive-disclosure/R3.1.1_Task_Report.md b/docs/MDTODO/details/cli-output-progressive-disclosure/R3.1.1_Task_Report.md new file mode 100644 index 00000000..d23c0ec6 --- /dev/null +++ b/docs/MDTODO/details/cli-output-progressive-disclosure/R3.1.1_Task_Report.md @@ -0,0 +1,14 @@ +# R3.1.1 任务报告 + +## 结果 + +- [UniDesk PR #1821](https://github.com/pikasTech/unidesk/pull/1821) 在提交 `5c6ca8e9` 收窄后合并，merge commit 为 `d56a9ad5`。 +- `--input` 与 `--full|--raw` 在任何 manager 请求前稳定返回 `validation-failed`，不会返回完整 `resource` 或 `data`。 +- 删除通用 `rest-bridge` 对任意错误 `recoveryActions` 的渲染，避免扩大错误 `Next` authority。 + +## 验证 + +- `bun test scripts/src/agentrun.test.ts scripts/src/agentrun-events.test.ts`：14 pass，0 fail，290 assertions。 +- 两个固定 Artificer task 的正常 TaskInput 分别为 6819/6620 bytes，均无 dump、`valuesPrinted=false`、`secretRefsOnly=true`。 +- 主分支复验非法组合 exit=1，输出有界且无完整资源字段。 +- `git diff --check` 通过；`rollout=not-applicable`。 diff --git a/docs/MDTODO/details/cli-output-progressive-disclosure/R3.1_Task_Report.md b/docs/MDTODO/details/cli-output-progressive-disclosure/R3.1_Task_Report.md new file mode 100644 index 00000000..25ab7945 --- /dev/null +++ b/docs/MDTODO/details/cli-output-progressive-disclosure/R3.1_Task_Report.md @@ -0,0 +1,13 @@ +# R3.1 任务报告 + +## 结果 + +- 通过 [UniDesk #1819](https://github.com/pikasTech/unidesk/issues/1819) 和 [PR #1821](https://github.com/pikasTech/unidesk/pull/1821) 增加 `agentrun describe task/ --input -o json|yaml`。 +- 输出只投影 task create 字段、AipodSpec identity、资源引用和脱敏 provenance；credential 只保留 SecretRef。 +- 默认 task describe 提供语义化 input 下钻，显式 full/raw 完整读取合同保持不变。 + +## 验证 + +- 两个原 Artificer 负例均可直接恢复完整 prompt 与重建字段，不依赖 `/tmp` dump。 +- 定向测试 14/14 通过，主分支原入口复验通过。 +- merge commit `d56a9ad5`；该变更为 render-only CLI，`rollout=not-applicable`。