Codex
56 lines
4.5 KiB
Markdown
56 lines
4.5 KiB
Markdown
# AgentRun 运行可靠性
|
||
|
||
来源：[AgentRun #294](https://github.com/pikasTech/agentrun/issues/294)。
|
||
|
||
范围：长期跟踪 AgentRun admission、dispatch、runner、resource bundle、provider 建立、终态失败可见性与自动交付可靠性。单次故障作为 MDTODO ITEM 纳入，不为每个 issue 新建文件。
|
||
|
||
|
||
## R1 [in_progress]
|
||
|
||
依据 [AgentRun #294](https://github.com/pikasTech/agentrun/issues/294) 恢复 Artificer resource-bundle Git 获取与失败可见性，完成任务后将详细报告写入[任务报告](./details/agentrun-resource-bundle-git-fetch/R1_Task_Report.md)。
|
||
### R1.1
|
||
|
||
用固定四个 run 单步披露 bundle source、fetch 阶段、脱敏 remote/credential sourceRef 与首个失败分类，完成任务后将详细报告写入[任务报告](./details/agentrun-resource-bundle-git-fetch/R1.1_Task_Report.md)。
|
||
### R1.2
|
||
|
||
在 YAML/sourceRef 或 AgentRun runner/resource-bundle 权威路径修复 code 128，并统一 task terminal failure 摘要，完成任务后将详细报告写入[任务报告](./details/agentrun-resource-bundle-git-fetch/R1.2_Task_Report.md)。
|
||
### R1.3
|
||
|
||
通过 PR 合并自动 CI/CD 后重派同类 Artificer 任务，验收 bundle materialized、provider established 和业务执行开始，完成任务后将详细报告写入[任务报告](./details/agentrun-resource-bundle-git-fetch/R1.3_Task_Report.md)。
|
||
|
||
## R2 [completed]
|
||
|
||
在不改变产品事件、持久化、trace authority 或跨服务职责的前提下，清理 AgentRun/HWLAB 观测诊断 CLI 支线；来源 [UniDesk #1619](https://github.com/pikasTech/unidesk/issues/1619) 与 [UniDesk #1796](https://github.com/pikasTech/unidesk/issues/1796)，任何架构变更均跳过，完成任务后将详细报告写入[任务报告](./details/agentrun-runtime-reliability/R2_Task_Report.md)。
|
||
|
||
### R2.1 [completed]
|
||
|
||
落实 [UniDesk #1619](https://github.com/pikasTech/unidesk/issues/1619)：仅在 CLI 输出层增加有界 plan 默认视图和 observability scoped help，显式 full/raw 保持完整；禁止提高 stdout 阈值、修改 YAML 或运行面，完成任务后将详细报告写入[任务报告](./details/agentrun-runtime-reliability/R2.1_Task_Report.md)。
|
||
|
||
### R2.2 [completed]
|
||
|
||
落实 [UniDesk #1796](https://github.com/pikasTech/unidesk/issues/1796)：仅修既有诊断层的 lane 选择、commandId 过滤和 missing-command-terminal-span 的 unknown/instrumentation-gap 分类；禁止新增第二事实源或改变 trace authority，完成任务后将详细报告写入[任务报告](./details/agentrun-runtime-reliability/R2.2_Task_Report.md)。
|
||
|
||
### R2.3 [completed]
|
||
|
||
由主代理完成架构 diff review、定向 CLI 验收、PR 合并与 issue 收口；只接受局部诊断/可见性修改，rollout 不适用，完成任务后将详细报告写入[任务报告](./details/agentrun-runtime-reliability/R2.3_Task_Report.md)。
|
||
|
||
### R2.4 [completed]
|
||
|
||
登记 [UniDesk #1801](https://github.com/pikasTech/unidesk/issues/1801)：diagnose 的 command/result 读取会向同一业务 trace 补记 command_result span，使重复读取改变 instrumentation completeness；该问题涉及 trace context 与诊断证据隔离，本轮按架构变更边界跳过，完成任务后将详细报告写入[任务报告](./details/agentrun-runtime-reliability/R2.4_Task_Report.md)。
|
||
|
||
## R3 [in_progress]
|
||
|
||
依据 [AgentRun #307](https://github.com/pikasTech/agentrun/issues/307) 实现 Queue Q5 的同 task 不可变 attempt 历史与显式终态失败 retry，禁止通过重置 task 或复制 task 合同绕过资源语义，完成任务后将详细报告写入[任务报告](./details/agentrun-runtime-reliability/R3_Task_Report.md)。
|
||
|
||
### R3.1
|
||
|
||
在 AgentRun 增加正式 `agentrun_queue_attempts` 存储、现有 latestAttempt 回填和不可变历史查询；task.latestAttempt 只保留为摘要指针，完成任务后将详细报告写入[任务报告](./details/agentrun-runtime-reliability/R3.1_Task_Report.md)。
|
||
|
||
### R3.2
|
||
|
||
实现服务端 `POST /api/v1/queue/tasks/:id/retry`：同 task 新 attempt、retry key 幂等、failed/blocked 白名单、completed/cancelled fail closed，并让 dry-run 全校验且零写入，完成任务后将详细报告写入[任务报告](./details/agentrun-runtime-reliability/R3.2_Task_Report.md)。
|
||
|
||
### R3.3
|
||
|
||
在 UniDesk 受控 CLI 增加 task retry 资源入口，完成内存/PostgreSQL 并发测试、PR 自动交付和固定任务 `qt_5b65a086385a49bdb874cf8f9d191169` 的 bundle/provider/业务启动验收，完成任务后将详细报告写入[任务报告](./details/agentrun-runtime-reliability/R3.3_Task_Report.md)。
|