Merge pull request 'Pin backend to announce final-only on every material tool result' (#670) from feature/fast-slow-o2-final-only-notice-all-tools into main

.task/archive/feature-fast-slow-o2-final-only-notice-all-tools.md

@@ -0,0 +1,163 @@
+# feature/fast-slow-o2-final-only-notice-all-tools 任务卡
+
+任务主记录：PR #670 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/670；状态：已完成（合入前闭合）；owner：weichen
+
+## 基线与授权
+
+- 权威仓：ssh://git@192.168.3.2:2222/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 210f8f305238a0241ce69ab5943b52d8bc5bcc62
+- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-fast-slow-o2-final-only-notice-all-tools（worktree）；分支：feature/fast-slow-o2-final-only-notice-all-tools
+- 分支类型：standalone；root_target：main；immediate_target：main；accepting_requirements：false
+- 需求分流：verdict=NEW；selected_initiative=无；requirement_sha256=2ca11f85a6b5aec7ca9d38b2ca74f6d4157c76719727445f9e0b4f987dce7f08；triage_receipt=/tmp/o2f1b-20261021/triage.json；receipt_sha256=6c4c1dff003ef7956dd46de75607f7240c7c7de6d83bc9281a620f7ceaea19d2
+
+- 授权与交付终点：用户「先开始 1吧」（2026-10-21，P3 后方向 1：告知扩展到所有工具结果）；允许零付费 Backend 实施单元、Backend PR/CI/合入、Dev gitlink 改钉 PR/CI/合入，并记录 P3 付费复验结果。未授权：再次付费复验（须单独批准）、A01 预算调整、路由契约改动、实例配置写入、部署
+- 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进）
+- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
+- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
+- 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
+- 当前阶段：合入；当前增量：I2 Dev 改钉（I1 已合入 Backend #235）
+- 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）
+
+## 目标与非目标
+
+目标：物料子 Agent 在下一次请求将为 final-only/stop 时，于当轮**任一**工具结果（不限 publish_work_checkpoint）追加告知；记录 P3 付费复验结果。受影响：Backend internal/runtime/sub_loop.go、material_final_reserve.go 及测试。
+
+非目标：不改路由契约、agent-native、工具说明/schema、materialFinalDecision 公式、任务文本、A01 预算；不发起付费请求。
+
+## Agent 实施收据
+
+路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md；每次尝试一行，原始日志留在源码外收据路径。
+
+| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
+|---|---|---|---|---|---|---|---|---|---|---|
+| o2f1b-i1-backend-notice-all-tools | Backend runtime/sub_loop.go、material_final_reserve.go、work_checkpoint_test.go | 22fcb8ac80b2 | implementation | 按 AGENT-EXECUTION.md | 1（866c2dd62a06，fresh_session=true，session not-observable） | pi | success | 52a3e497ed14 → Backend #235 | 0 | /tmp/o2f1b-20261021/f1b-receipt.json |
+| o2f1b-i2-dev-backend-pin | modules/backend gitlink → 07228aa | ccceb3bfb61b | implementation | 按 AGENT-EXECUTION.md | 1（212e019317ad，fresh_session=true，session not-observable） | cursor | success | 002231cca6d6 | 0 | /tmp/o2f1b-20261021/f2-receipt.json |
+
+## 关联方向与规划
+
+- 适用状态：适用（O2 A01 付费通过的前置修正）
+- 主记录路径/版本：docs/superpowers/specs/2026-10-21-fast-slow-o2-c8-review.md（F1）；前序归档卡 .task/archive/feature-fast-slow-o2-final-only-notice.md
+- 对应里程碑：O2 A01 付费复验通过
+
+## 需求分析
+
+| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
+|---|---|---|---|---|---|---|
+| R1 | final-only/stop 前一轮任一工具结果含告知 | 符合：P3 根因 | P0 | 单测：检查点后一轮 knowledge_search 结果含告知且第 3 次请求无检查点声明；错误结果保留 IsError；预算充足/无预算不追加；既有测试不变 | 无 | 完成（Backend #235） |
+| R2 | 记录 P3 付费复验结果 | 符合 | P0 | 卡内含花费、调用序列、结论与收据 | 无 | 完成（见探索试验） |
+
+## 方案与计划
+
+- 方案引用：P3 后方向 1（本卡目标）；单元说明 /tmp/o2f1b-20261021/f1b-unit.json
+- 实施计划引用：I1 Backend（R1，agent-per-unit）→ Backend PR/CI/合入 → I2 Dev 改钉 modules/backend
+- 测试计划引用：单元 verification（gofmt、vet、runtime/runmgr/server 测试、eval/live A01 离线用例）；Backend CI；Dev CI make test+build；付费复验 NOT_RUN（待授权）
+
+## 阶段记录
+
+| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
+|---|---|---|---|---|---|
+| 需求拆解 | 210f8f3 | 完成 | host | 2026-10-21 | 用户「先开始 1吧」 |
+| 需求评估 | 210f8f3 | 完成 | host | 2026-10-21 | R1/R2 |
+| 需求表确认 | 210f8f3 | 完成（范围即方向 1） | 用户 | 2026-10-21 | 选项 1 |
+| 方案设计 | 210f8f3 | 完成（P3 根因 + 方向 1） | host | 2026-10-21 | 本卡探索试验 |
+| 实施计划 | 93a999f | 完成 | host | 2026-10-21 | 单元说明 f1b/f2-unit.json |
+| 实施与自检 | Backend 52a3e49；Dev 002231c | 完成 | pi / cursor（agent-exec） | 2026-10-21 | 收据表；host 复跑 gofmt/vet/runtime+runmgr+server/eval-live A01 全部 ok（SELF） |
+| 正式测试与验收 | Backend 52a3e49；Dev 待 CI | Backend CI_SUCCESS（vet-and-test、governance）；Dev 待 CI | CI | 2026-10-21 | GATE |
+| 代码 Review | 7158bea..52a3e49 | 通过（无阻塞） | 独立 code-reviewer 子会话 | 2026-10-21 | 见合入与清理 |
+| 合入 | 待定 | 待执行 | — | — | — |
+| 合入核验与收口 | 待定 | 待执行 | — | — | — |
+
+## 探索试验与迭代
+
+| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
+|---|---|---|---|---|---|---|---|
+| P3 A01 付费复验（Dev 210f8f3 / Backend e02e25a） | #233 告知可避免 C8 | 1 次运行，3 次付费请求 / 20672 tokens（守卫 30000，实例 60000） | 无 C8、0 拒绝、有最终答复 | 用户「批准」（2026-10-21） | NOT_PASS：请求 1 发布检查点（无告知，正确）；请求 2 三次 knowledge_search；剩余 18056 ≤ 2×(5947+4000+1486)=22866 使请求 3 为 final-only，告知未送达；请求 3 发 3211 字节工具调用 → C8。1 检查点 0 拒绝；路由已删、实例已停；收据 ~/.local/share/agent-system-evidence/fast-slow-o2-a01f-20261021/a01/p3-run-receipt.json（80f5eb3b9ac4e8d7） | 告知须覆盖所有工具结果（本卡 R1） | 修正后需一次付费复验（待授权）；P2+P3 累计 38627 tokens |
+
+## 同步记录
+
+| 节点 | sync_base_sha | tested_head_sha | checked_at |
+|---|---|---|---|
+| 启动 | 210f8f305238a0241ce69ab5943b52d8bc5bcc62 | 210f8f305238a0241ce69ab5943b52d8bc5bcc62 | 2026-10-21T04:32:08Z |
+
+## 证据（Evidence）
+
+<!-- CMD="<命令>" make evidence 写入；手抄/转写输出视为无效证据（AGENTS.md 证据与验证门禁）。 -->
+| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
+|---|---|---|---|---|---|
+
+## 交付调度
+
+- 调度状态：窗口已领取；调度记录：issue #518 评论
+- entry_id：mq-dev-20261021-fast-slow-o2-final-only-notice-all-tools-01；attempt_id：01；窗口执行者：当前主模型
+- 固定候选：无（base/head、组件与相关配置引用实际尝试）
+- 调度依据：policy/delivery.md#合入调度
+- 固定后证据：源码外 RECEIPT；实际结果后按授权原样导入和闭合
+
+## 结果与验证
+
+- 结果：Backend #235（07228aa）在下一次请求将为 final-only/stop 时，于当轮任一工具结果追加告知（不再限于检查点）；Dev modules/backend 改钉 07228aa（同时带入他人已合入的 Backend #234）。P3 付费复验 NOT_PASS（C8，告知未送达）已记录于探索试验。
+- 验证：Backend CI PASS（GATE，sha 52a3e497ed14）；host 复跑 PASS（SELF）；Dev CI 见 CI 记录；付费复验 NOT_RUN（未授权）
+- 影响与剩余项：模型是否遵守告知须经一次 A01 付费复验（待批准，守卫 30000）；若仍失败，备选为提高 A01 预算或 final-only 阶段保留检查点声明由工具层拒绝
+
+## 规划进展与下一步
+
+- 本次推进/剩余：告知已覆盖所有工具结果；O2 A01 付费通过仍待复验
+- 首选下一任务：O2 A01 付费复验（P4）
+- 推荐依据：效果只能付费判定
+- 前置条件/待确认：用户批准付费；用户自行重建路由文件
+- 预期产物/验收条件：无 C8、0 拒绝、正常最终答复
+- 重复任务核对：无在途同题任务
+- 启动授权：未授权（建议不自动启动新任务，仍须明确授权）
+
+## 合入与清理
+
+- Review 记录：全新独立 code-reviewer 子会话（fresh_session=true，session id not-observable；仅收需求、base 7158bea/head 52a3e49 与 diff），离线重跑 runtime 测试通过；核对通用分支 IsError 等价、同轮决策单调、测试确实走非检查点工具且第 3 次请求无检查点声明、非物料子 Agent 不受影响。阻塞：无。非阻塞（记录不修）：hook/未知工具/取消等运行时生成结果不经 runTool、不带告知；materialDecision 注释仍只提检查点结果；Backend 提交沿用 agent-exec transport 主题（PR 描述含四段）。Dev 改钉仅 gitlink，内容即已审 Backend #235（另含他人已合入的 #234）
+- 冲突记录：NOT_RUN（最新目标同步、冲突处置、组合兼容核验及复审/补测）
+- CI 记录：NOT_RUN（当前 HEAD 完整 SHA、全部必需检查、运行链接、执行身份及 GATE 结果）
+- 合入记录：NOT_RUN（交付授权范围、PR、被核验 HEAD、合入 SHA、目标分支及内容核验）
+- 清理记录：NOT_RUN（授权依据、写者退出确认、worktree/分支/任务卡处置）
+
+<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
+```json
+{
+  "summary_schema": 1,
+  "source": "SELF",
+  "timestamp": "2026-10-21T04:31:15.651661+00:00",
+  "command": "make precheck",
+  "exit_code": 0,
+  "cwd": "/home/weichen/projects/Agent-System-Dev",
+  "before_head": "210f8f305238a0241ce69ab5943b52d8bc5bcc62",
+  "after_head": "210f8f305238a0241ce69ab5943b52d8bc5bcc62",
+  "branch": "main",
+  "target_branch": "main",
+  "target_head": "210f8f305238a0241ce69ab5943b52d8bc5bcc62",
+  "root_target": "main",
+  "immediate_target": "main",
+  "before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+  "after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+  "output_tail": [
+    "make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev'",
+    "[repo]   branch=main head=210f8f3052",
+    "[remote] origin/main=210f8f3052 ahead=0 behind=0",
+    "[tree]   clean submodules_drift=0 uninit=0",
+    "[worktrees] linked=5",
+    "[cards] 已合入未闭合任务卡:feature-project-access-lifecycle.md——make task-close 回填归档（主检出运行）",
+    "[initiatives] local cards (not authoritative): none",
+    "[hooks]   core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）",
+    "[facts]   policy/facts.md 6 条事实均在有效期内",
+    "[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
+    "[R0] 210f8f3052（完整：210f8f305238a0241ce69ab5943b52d8bc5bcc62）",
+    "[worktree] before-sync: recursive component checks passed",
+    "[verdict] READY — 保留本次 precheck receipt 后建任务工作区：PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
+    "make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev'"
+  ],
+  "output_sha256": "2414673f36e0321e34d32b0b4e97849a2da20a9cfb0a183c72b54e7aab344a9d",
+  "receipt_sha256": "e35da8024f5fe2bdd2f91478ae94b5db6c32a9d7320ae820355c0c028e56e6ff",
+  "receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/e35da8024f5fe2bdd2f91478ae94b5db6c32a9d7320ae820355c0c028e56e6ff.json"
+}
+```
+
+## 闭合记录（合入前折叠）
+
+- 本卡在 PR #670（https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/670）合入前闭合并归档，随该 PR 一同合入。
+- 该 PR 的合并提交即本任务的落地记录。
+- 合入后无需回填，也无需单独的闭合 PR。