docs: 收口观测诊断支线

2026-07-11 22:33:04 +02:00
parent 5bb9c6d310
commit 551eac6aaf
5 changed files with 28 additions and 4 deletions
@@ -18,19 +18,19 @@

 通过 PR 合并自动 CI/CD 后重派同类 Artificer 任务，验收 bundle materialized、provider established 和业务执行开始，完成任务后将详细报告写入[任务报告](./details/agentrun-resource-bundle-git-fetch/R1.3_Task_Report.md)。

-## R2 [in_progress]
+## 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 [in_progress]
+### 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 [in_progress]
+### 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
+### R2.3 [completed]

 由主代理完成架构 diff review、定向 CLI 验收、PR 合并与 issue 收口；只接受局部诊断/可见性修改，rollout 不适用，完成任务后将详细报告写入[任务报告](./details/agentrun-runtime-reliability/R2.3_Task_Report.md)。

@@ -0,0 +1,5 @@
+# R2.1 任务报告
+
+[UniDesk #1619](https://github.com/pikasTech/unidesk/issues/1619) 已由 PR #1800 修复并关闭，merge commit 为 5bb9c6d3104afcb647bf70866f6c53198b26767f。
+
+默认 observability plan 从约 17.8 KiB / 538 行收敛到约 1.8 KiB / 41 行，无 stdout dump；full/raw 保持完整。search、trace、diagnose-code-agent scoped help 已隔离。定向测试 5/5、基础 check 11/11 通过。未修改 stdout 阈值、YAML 或运行面，rollout=not-applicable。
@@ -0,0 +1,5 @@
+# R2.2 任务报告
+
+[UniDesk #1796](https://github.com/pikasTech/unidesk/issues/1796) 已由 PR #1798 修复并关闭，merge commit 为 96e03ceb0d0c3c152fb0708624df6d55d4e5d4d4。
+
+修复仅位于 diagnose-code-agent：优先 provider-decision lane、events 按 commandId 隔离、authority 不可用时报告 unknown，并区分 service coverage 与 command terminal instrumentation gap。固定 warm trace 验收为 completed/completed，authority namespace 为 agentrun-v02。定向测试 3/3 通过，rollout=not-applicable。
@@ -0,0 +1,5 @@
+# R2.3 任务报告
+
+主代理已完成 #1798 与 #1800 的逐文件架构 review、preflight、定向测试、固定 trace CLI 验收、guarded merge、issue 生命周期和 post-task 清理。
+
+两个修复均局限在 UniDesk CLI renderer/help/diagnosis 层；没有新增事件源、第二 authority、跨服务职责或运行面补丁。诊断读取自身产生 span 的架构风险已独立登记为 #1801 和 R2.4，本轮跳过。
@@ -0,0 +1,9 @@
+# R2 任务报告
+
+AgentRun/HWLAB 观测诊断 CLI 支线已完成有界收口：
+
+- #1619 默认 plan 与 scoped help 已修复并关闭。
+- #1796 warm-session terminal 诊断已修复并关闭。
+- #1801 observer effect 已登记为架构风险，保持 open 且跳过实现。
+
+全部已执行修改均限于局部 CLI/诊断层，未改变产品事件、持久化、trace authority、Kafka/SSE 或跨服务职责。