From 8d52f1ab14fa2d2acd5e13c8846539bd4e1c822a Mon Sep 17 00:00:00 2001 From: Codex Date: Sat, 11 Jul 2026 22:25:47 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20=E7=99=BB=E8=AE=B0=E6=94=AF=E7=BA=BF?= =?UTF-8?q?=E6=B8=85=E7=90=86=E4=B8=8E=E6=9E=B6=E6=9E=84=E8=B7=B3=E8=BF=87?= =?UTF-8?q?=E8=BE=B9=E7=95=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/MDTODO/agentrun-runtime-reliability.md | 16 ++++++++++++++++ .../R2.1_Task_Report.md | 13 +++++++++++++ .../R2_Task_Report.md | 3 +++ .../github-gitea-durable-source-authority.md | 9 ++++++++- 4 files changed, 40 insertions(+), 1 deletion(-) create mode 100644 docs/MDTODO/details/github-gitea-durable-source-authority/R2.1_Task_Report.md create mode 100644 docs/MDTODO/details/github-gitea-durable-source-authority/R2_Task_Report.md diff --git a/docs/MDTODO/agentrun-runtime-reliability.md b/docs/MDTODO/agentrun-runtime-reliability.md index 215e8412..472cfabd 100644 --- a/docs/MDTODO/agentrun-runtime-reliability.md +++ b/docs/MDTODO/agentrun-runtime-reliability.md @@ -17,3 +17,19 @@ ### R1.3 通过 PR 合并自动 CI/CD 后重派同类 Artificer 任务，验收 bundle materialized、provider established 和业务执行开始，完成任务后将详细报告写入[任务报告](./details/agentrun-resource-bundle-git-fetch/R1.3_Task_Report.md)。 + +## R2 [in_progress] + +在不改变产品事件、持久化、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] + +落实 [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] + +落实 [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 + +由主代理完成架构 diff review、定向 CLI 验收、PR 合并与 issue 收口；只接受局部诊断/可见性修改，rollout 不适用，完成任务后将详细报告写入[任务报告](./details/agentrun-runtime-reliability/R2.3_Task_Report.md)。 diff --git a/docs/MDTODO/details/github-gitea-durable-source-authority/R2.1_Task_Report.md b/docs/MDTODO/details/github-gitea-durable-source-authority/R2.1_Task_Report.md new file mode 100644 index 00000000..f896702c --- /dev/null +++ b/docs/MDTODO/details/github-gitea-durable-source-authority/R2.1_Task_Report.md @@ -0,0 +1,13 @@ +# R2.1 任务报告 + +## 结论 + +[UniDesk #1784](https://github.com/pikasTech/unidesk/issues/1784) 当前没有根因修复 PR。既有证据表明，修复目标需要改变 owning YAML 到 managed mirror repositories/cache 的 renderer、controller 与 automatic reconcile 职责，属于控制面架构变更。 + +按本轮用户边界，本项保持 issue open 并跳过实现。未执行人工 mirror、手工 PipelineRun、sync、flush、trigger、apply、closeout，也未增加 direct GitHub fallback。 + +## 证据 + +- AgentRun #294 固定失败为 agent_skills@master 在 managed mirror 中 repository-not-found。 +- AgentRun PR #295 只改善 resource-bundle 首错和 Failure 可见性，明确未修 mirror 根因。 +- 本轮只读审计未发现 #1784 专属 PR 或 worktree。 diff --git a/docs/MDTODO/details/github-gitea-durable-source-authority/R2_Task_Report.md b/docs/MDTODO/details/github-gitea-durable-source-authority/R2_Task_Report.md new file mode 100644 index 00000000..a6048f9f --- /dev/null +++ b/docs/MDTODO/details/github-gitea-durable-source-authority/R2_Task_Report.md @@ -0,0 +1,3 @@ +# R2 任务报告 + +已完成 [UniDesk #1784](https://github.com/pikasTech/unidesk/issues/1784) 的架构风险分类与执行边界登记。该问题必须经明确授权的控制面架构设计处理；本轮保持 open、跳过代码和运行面变更，避免产生第二套 mirror authority 或人工交付补洞。 diff --git a/docs/MDTODO/github-gitea-durable-source-authority.md b/docs/MDTODO/github-gitea-durable-source-authority.md index 61d2b433..b03dedb0 100644 --- a/docs/MDTODO/github-gitea-durable-source-authority.md +++ b/docs/MDTODO/github-gitea-durable-source-authority.md @@ -22,4 +22,11 @@ 修正 mirror/webhook status：按 GitHub head 精确选择 snapshot，MATCH=false 必须 STALE=true，并移除全部 REPAIR/手工补偿 hint，完成任务后将详细报告写入[任务报告](./details/github-gitea-durable-source-authority/R1.3_Task_Report.md)。 ### R1.4 [in_progress] -覆盖重复 delivery、跨 repo、部分 ref 已存在、atomic failure、retry exhaustion 与 truthful status，提交 non-draft PR/preflight；运行面验收只由修复 PR merge 后新事件完成，完成任务后将详细报告写入[任务报告](./details/github-gitea-durable-source-authority/R1.4_Task_Report.md)。 \ No newline at end of file +覆盖重复 delivery、跨 repo、部分 ref 已存在、atomic failure、retry exhaustion 与 truthful status，提交 non-draft PR/preflight；运行面验收只由修复 PR merge 后新事件完成，完成任务后将详细报告写入[任务报告](./details/github-gitea-durable-source-authority/R1.4_Task_Report.md)。 +## R2 [completed] + +跟踪 [UniDesk #1784](https://github.com/pikasTech/unidesk/issues/1784) 暴露的 managed mirror repository materialization 根因；本轮只完成架构风险分类，不修改 renderer/controller/reconcile authority，完成任务后将详细报告写入[任务报告](./details/github-gitea-durable-source-authority/R2_Task_Report.md)。 + +### R2.1 [completed] + +依据 [UniDesk #1784](https://github.com/pikasTech/unidesk/issues/1784) 的只读审计，确认修复需要 owning YAML 到 managed mirror renderer/controller/automatic reconcile 的架构变更；按用户边界保持 issue open 并跳过，禁止人工 mirror、手工 CI/CD 补跑或 GitHub fallback，完成任务后将详细报告写入[任务报告](./details/github-gitea-durable-source-authority/R2.1_Task_Report.md)。