Merge pull request 'Pin backend to announce final-only in material checkpoint results' (#669) from feature/fast-slow-o2-final-only-notice into main

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

@@ -0,0 +1,163 @@
+# feature/fast-slow-o2-final-only-notice 任务卡
+
+任务主记录：PR #669 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/669；状态：已完成（合入前闭合）；owner：weichen
+
+## 基线与授权
+
+- 权威仓：ssh://git@192.168.3.2:2222/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= a496ea0f0249b2b412354677ef97612ccd692d25
+- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-fast-slow-o2-final-only-notice（worktree）；分支：feature/fast-slow-o2-final-only-notice
+- 分支类型：standalone；root_target：main；immediate_target：main；accepting_requirements：false
+- 需求分流：verdict=NEW；selected_initiative=无；requirement_sha256=0e52b1ae1ba0a197f908d26723a6ddef5a4f73014822263a35bcfc08a2e79bc8；triage_receipt=/tmp/o2f1-20261021/triage.json；receipt_sha256=29517c35eda25d6fe16a78c7ecabe26b306bd4071dff9c29bc36e839cfe5872b
+
+- 授权与交付终点：用户「实施」（2026-10-21，针对 C8 复核推荐的 F1）；允许零付费 Backend 实施单元、Backend PR/CI/合入、Dev gitlink 改钉 PR/CI/合入。未授权：付费复验（须单独批准）、路由契约改动、实例配置写入、部署
+- 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进）
+- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
+- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
+- 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
+- 当前阶段：合入；当前增量：I2 Dev 改钉（I1 已合入 Backend #233）
+- 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）
+
+## 目标与非目标
+
+目标：物料子 Agent 在宿主判定下一次请求为 final-only（或预算停止）时，于当次 publish_work_checkpoint 工具结果中告知模型「后续不再接受检查点、直接写最终结论」；物料任务指令写明检查点通常最多 2 次（reading → crosscheck）。受影响：Backend internal/runtime/sub_loop.go、material_final_reserve.go、internal/runmgr/material.go 及测试。
+
+非目标：不改路由契约与 agent-native；不改检查点工具说明/schema、materialFinalDecision 公式；不发起付费请求。
+
+## Agent 实施收据
+
+路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md；每次尝试一行，原始日志留在源码外收据路径。
+
+| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
+|---|---|---|---|---|---|---|---|---|---|---|
+| o2f1-i1-backend-final-only-notice | Backend runtime/sub_loop.go、material_final_reserve.go、work_checkpoint_test.go、runmgr/material.go、material_sources_test.go | 76bc59db1d0e | implementation | cursor→agy→pi | 1（9e8e3bf5a934，fresh_session=true，session not-observable） | cursor | success | 786744992046 → Backend #233 | 0 | /tmp/o2f1-20261021/f1-receipt.json |
+| o2f1-i2-dev-backend-pin | modules/backend gitlink → e02e25a | ccceb3bfb61b | implementation | cursor→agy→pi | 1（fresh_session=true，session not-observable） | cursor | success | 623d1064587d | 0 | /tmp/o2f1-20261021/f2-receipt.json |
+
+## 关联方向与规划
+
+- 适用状态：适用（O2 A01 付费通过的前置修正）
+- 主记录路径/版本：docs/superpowers/specs/2026-10-21-fast-slow-o2-c8-review.md（main a496ea0）F1
+- 对应里程碑：O2 A01 付费复验通过
+
+## 需求分析
+
+| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
+|---|---|---|---|---|---|---|
+| R1 | final-only 前一次检查点工具结果含告知 | 符合：C8 复核根因 | P0 | 单测：第 2 个检查点结果含告知、首个不含、仅预算触发时也含；既有 final-only 测试不变 | 无 | 完成（Backend #233） |
+| R2 | 物料任务指令与 2 次检查点上限一致 | 符合 | P0 | 单测断言任务文本关键句 | 无 | 完成（Backend #233） |
+
+## 方案与计划
+
+- 方案引用：docs/superpowers/specs/2026-10-21-fast-slow-o2-c8-review.md「可选修正」F1（main a496ea0）；单元说明 /tmp/o2f1-20261021/f1-unit.json
+- 实施计划引用：I1 Backend（R1、R2，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（待授权）
+
+## 阶段记录
+
+| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
+|---|---|---|---|---|---|
+| 需求拆解 | a496ea0 | 完成 | host | 2026-10-21 | 用户「实施」F1 |
+| 需求评估 | a496ea0 | 完成 | host | 2026-10-21 | R1/R2 |
+| 需求表确认 | a496ea0 | 完成（范围即 C8 复核 F1） | 用户 | 2026-10-21 | 「实施」 |
+| 方案设计 | a496ea0 | 完成（沿用已合入复核文档 F1） | host | 2026-10-21 | 方案引用 |
+| 实施计划 | 874287b | 完成 | host | 2026-10-21 | 单元说明 f1/f2-unit.json |
+| 实施与自检 | Backend 7867449；Dev 623d106 | 完成 | cursor（agent-exec） | 2026-10-21 | 收据表；host 复跑 gofmt/vet/runtime+runmgr+server 测试/eval-live A01 全部 ok（SELF） |
+| 正式测试与验收 | Backend 7867449；Dev 待 CI | Backend CI_SUCCESS（vet-and-test、governance）；Dev 待 CI | CI | 2026-10-21 | GATE |
+| 代码 Review | 7a41f22..7867449 | 通过（无阻塞） | 独立 code-reviewer 子会话 | 2026-10-21 | 见合入与清理 |
+| 合入 | 待定 | 待执行 | — | — | — |
+| 合入核验与收口 | 待定 | 待执行 | — | — | — |
+
+## 探索试验与迭代
+
+| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
+|---|---|---|---|---|---|---|---|
+| 待定义 | — | — | — | 待核对 | NOT_RUN | 待评估 | 待评估 |
+
+## 同步记录
+
+| 节点 | sync_base_sha | tested_head_sha | checked_at |
+|---|---|---|---|
+| 启动 | a496ea0f0249b2b412354677ef97612ccd692d25 | a496ea0f0249b2b412354677ef97612ccd692d25 | 2026-10-21T02:52:15Z |
+
+## 证据（Evidence）
+
+<!-- CMD="<命令>" make evidence 写入；手抄/转写输出视为无效证据（AGENTS.md 证据与验证门禁）。 -->
+| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
+|---|---|---|---|---|---|
+
+## 交付调度
+
+- 调度状态：窗口已领取（前序 #668 于 03:42 释放）；调度记录：issue #518 评论
+- entry_id：mq-dev-20261021-fast-slow-o2-final-only-notice-01；attempt_id：01；窗口执行者：当前主模型
+- 固定候选：无（base/head、组件与相关配置引用实际尝试）
+- 调度依据：policy/delivery.md#合入调度
+- 固定后证据：源码外 RECEIPT；实际结果后按授权原样导入和闭合
+
+## 结果与验证
+
+- 结果：Backend #233（e02e25a）在下一次请求将为 final-only/stop 时于当次检查点工具结果追加告知，并让物料任务指令写明检查点通常最多 2 次；Dev modules/backend 改钉 e02e25a（同时带入他人已合入的 Backend #231）。
+- 验证：Backend CI PASS（GATE，sha 786744992046）；host 复跑 PASS（SELF）；Dev CI 见 CI 记录；付费复验 NOT_RUN（未授权）
+- 影响与剩余项：模型是否遵守告知只能经一次 A01 付费复验判定（待用户批准，守卫 30000 tokens）
+
+## 规划进展与下一步
+
+- 本次推进/剩余：F1 已交付；O2 A01 付费通过仍待复验
+- 首选下一任务：O2 A01 付费复验（P3）
+- 推荐依据：F1 效果只能付费判定
+- 前置条件/待确认：用户批准付费；用户自行重建路由文件
+- 预期产物/验收条件：无 C8、无拒绝检查点、正常最终答复
+- 重复任务核对：无在途同题任务
+- 启动授权：未授权（建议不自动启动新任务，仍须明确授权）
+
+## 合入与清理
+
+- Review 记录：全新独立 code-reviewer 子会话（fresh_session=true，session id not-observable；仅收需求、base 7a41f22/head 7867449 与 diff），离线重跑 runtime/runmgr 测试通过；核对 message_end 先于工具执行、决策与下一请求同源、输出上限等价。阻塞：无。非阻塞（记录不修）：stop 路径告知缺单测；任务文案「最后输出完整整理结果」略重复；同一回复内多个调用无法被本次告知撤回（既有批处理语义）。Dev 改钉仅 gitlink，内容即已审 Backend #233（另含已合入的 #231）
+- 冲突记录：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-21T02:50:21.185986+00:00",
+  "command": "make precheck",
+  "exit_code": 0,
+  "cwd": "/home/weichen/projects/Agent-System-Dev",
+  "before_head": "a496ea0f0249b2b412354677ef97612ccd692d25",
+  "after_head": "a496ea0f0249b2b412354677ef97612ccd692d25",
+  "branch": "main",
+  "target_branch": "main",
+  "target_head": "a496ea0f0249b2b412354677ef97612ccd692d25",
+  "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=a496ea0f02",
+    "[remote] origin/main=a496ea0f02 ahead=0 behind=0",
+    "[tree]   clean submodules_drift=0 uninit=0",
+    "[worktrees] linked=4",
+    "[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] a496ea0f02（完整：a496ea0f0249b2b412354677ef97612ccd692d25）",
+    "[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": "35e2936cf7a32e8e9b1454ec05f7b91ab0d0016105d80deaf7e8f7a26db2fa9d",
+  "receipt_sha256": "8d5a1392fde8843dc1700461131ffde68dbc3e599350c1259b3e3217b84adc81",
+  "receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/8d5a1392fde8843dc1700461131ffde68dbc3e599350c1259b3e3217b84adc81.json"
+}
+```
+
+## 闭合记录（合入前折叠）
+
+- 本卡在 PR #669（https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/669）合入前闭合并归档，随该 PR 一同合入。
+- 该 PR 的合并提交即本任务的落地记录。
+- 合入后无需回填，也无需单独的闭合 PR。