docs: 收口 Artificer task 输入下钻

2026-07-12 06:41:55 +02:00
parent d56a9ad58e
commit be9050df55
4 changed files with 32 additions and 5 deletions
@@ -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)。
@@ -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]

@@ -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`。
@@ -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/<taskId> --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`。