Codex
6.1 KiB
AgentRun 运行可靠性
来源：AgentRun #294。
范围：长期跟踪 AgentRun admission、dispatch、runner、resource bundle、provider 建立、终态失败可见性与自动交付可靠性。单次故障作为 MDTODO ITEM 纳入，不为每个 issue 新建文件。
R1 [in_progress]
依据 AgentRun #294 恢复 Artificer resource-bundle Git 获取与失败可见性，完成任务后将详细报告写入任务报告。
R1.1
用固定四个 run 单步披露 bundle source、fetch 阶段、脱敏 remote/credential sourceRef 与首个失败分类，完成任务后将详细报告写入任务报告。
R1.2
在 YAML/sourceRef 或 AgentRun runner/resource-bundle 权威路径修复 code 128，并统一 task terminal failure 摘要，完成任务后将详细报告写入任务报告。
R1.3
通过 PR 合并自动 CI/CD 后重派同类 Artificer 任务，验收 bundle materialized、provider established 和业务执行开始，完成任务后将详细报告写入任务报告。
R2 [completed]
在不改变产品事件、持久化、trace authority 或跨服务职责的前提下，清理 AgentRun/HWLAB 观测诊断 CLI 支线；来源 UniDesk #1619 与 UniDesk #1796，任何架构变更均跳过，完成任务后将详细报告写入任务报告。
R2.1 [completed]
落实 UniDesk #1619：仅在 CLI 输出层增加有界 plan 默认视图和 observability scoped help，显式 full/raw 保持完整；禁止提高 stdout 阈值、修改 YAML 或运行面，完成任务后将详细报告写入任务报告。
R2.2 [completed]
落实 UniDesk #1796：仅修既有诊断层的 lane 选择、commandId 过滤和 missing-command-terminal-span 的 unknown/instrumentation-gap 分类；禁止新增第二事实源或改变 trace authority，完成任务后将详细报告写入任务报告。
R2.3 [completed]
由主代理完成架构 diff review、定向 CLI 验收、PR 合并与 issue 收口；只接受局部诊断/可见性修改，rollout 不适用，完成任务后将详细报告写入任务报告。
R2.4 [completed]
登记 UniDesk #1801：diagnose 的 command/result 读取会向同一业务 trace 补记 command_result span，使重复读取改变 instrumentation completeness；该问题涉及 trace context 与诊断证据隔离，本轮按架构变更边界跳过，完成任务后将详细报告写入任务报告。
R3
在不改变已验收的纯 Kafka + SSE 实时/刷新链路前提下，统一解决 UniDesk #1784 managed mirror 物化、UniDesk #1801 诊断 trace 污染和 UniDesk #1802 自动交付 provenance 未收敛；所有可调事实来自 owning YAML，保持单一 source、terminal 与 trace authority，交付只由 PR merge 自动触发，禁止人工补跑、fallback 或下游过滤补洞，完成任务后将详细报告写入任务报告。
R3.1
冻结 #1784、#1801、#1802 与 #1769 的统一架构合同：明确 repository dependency owner、诊断 trace 边界、source→snapshot→artifact→GitOps→Argo→runtime provenance schema、controller 职责、迁移顺序与 fail-closed 语义；先形成决策报告和测试计划，不改运行面，完成任务后将详细报告写入任务报告。
R3.2
依赖 R3.1，解决 #1802：让 YAML-owned pipeline 输出 admission-owned outer-event provenance 和标准 terminal evidence，由单一 controller 自动 reconcile GitOps 并验证 commit graph；只用修复 PR merge 的新事件验收 source、GitOps、Argo 为 exact/descendant 且 runtime digest 对齐，禁止人工 mirror、PipelineRun、sync、flush、trigger、apply 或 closeout，完成任务后将详细报告写入任务报告。
R3.3
依赖 R3.1，并与 R3.2 复用同一 source authority，解决 #1784：由 owning YAML 声明依赖 repository/ref，统一 renderer/controller 自动物化 repo、cache 与 ref，提供 durable status/retry，消费者在 ready 前 fail-closed；以新 PR merge 事件验收 resource bundle 自动获取，禁止 direct GitHub fallback 或人工 mirror，完成任务后将详细报告写入任务报告。
R3.4
依赖 R3.1，解决 #1801：诊断读取创建独立 diagnostic trace，通过 OTel Span Link 和关联字段引用原业务 trace，不继承其 active trace parent；重复诊断不得改变原业务 trace 的 terminal/instrumentation 判定，同时保留诊断自身可观测性，并用固定 trace 与端到端合同确认纯 Kafka + SSE 链路无改动，完成任务后将详细报告写入任务报告。