fix(rectification): keep set-focus idempotent and record tool failures (BUG-659/660)
Same-id focus returns instead of making the model retry; kind_hint targetKind is ignored. Failed receipts keep a redacted original error and known codes. Host fallback recap no longer duplicates dates. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Jesse_Chen
@@ -0,0 +1,43 @@
|
||||
# 进度 · 记完经历后 set-focus 连续 `tool_failed`（2026-09-12）
|
||||
|
||||
## 范围
|
||||
|
||||
- 分支：`codex/rectification-set-focus-tool-failed-20260912`（基于 `origin/staging` @ `fb18f72f`，任务书基线 `529fcc09`）
|
||||
- 任务单：`docs/tasks/TASK-rectification-set-focus-tool-failed-20260912.md`
|
||||
- BUG-659：失败可诊断 + 同 id 幂等 + `targetKind` 忽略 kind_hint
|
||||
- BUG-660：宿主兜底 recap 去重日期
|
||||
- 不改引擎、决策门、Skill、DB 迁移
|
||||
|
||||
## T0 取证
|
||||
|
||||
本地夹具复现 §1 第二轮（batch 已落 `collect:invite:more`，再调 set-focus 同 id）：
|
||||
|
||||
| 假设 | 入参 / 条件 | 旧回执码（529fcc09 源码） | 本分支 |
|
||||
| --- | --- | --- | --- |
|
||||
| (a) schema 身份冲突 | 同 questionId；RPC `set_agentic_rectification_conversation_focus` 抛 `focus_idempotency_conflict` | 该码在已知列表，不应显示为 `tool_failed`；若走到 RPC 会是 `focus_idempotency_conflict` | 同 id 在 RPC 前返回 `idempotent=true`，无失败回执；RPC 抛错也被吞掉 |
|
||||
| (b) `targetKind=invite_more` | Zod `evidenceKindSchema` | execute 前进不了，流映射 `tool_call_rejected`，与事故回执 `tool_failed` 不符 | schema 接受字符串；服务端忽略 hint，活动焦点 `target_kind=null` |
|
||||
| (c) 工具内抛错 | `assertCaseRef` / `invalid_domain` | 码不在已知列表 → `tool_failed`；10ms、无 DB，与事故形态最像 | `invalid_case_id` / `invalid_domain` 回执可辨，失败指纹含脱敏 `engine_message`，并打 `rectification_tool_failed` |
|
||||
|
||||
事故六次失败、每次约 10ms、界面只见 `tool_failed`，与 (c) 或「未知 throw 被压成兜底码」一致；(a)(b) 单独都不能解释成 `tool_failed`。T1 之后即使再失败也能从回执和日志分开这三类。
|
||||
|
||||
Staging 容器日志（`deploy@118.26.111.127`，密钥 `~/.ssh/jyotisha-staging`）：`docker compose logs --since 2026-09-12T05:05:00Z --until 2026-09-12T05:10:00Z web` 中 `rectification_tool_failed|rectification-set-focus` 匹配 **0** 行。与 §2.2 一致：当时没有把原始错误打进日志。不以容器原文锁定根因。
|
||||
|
||||
## 完成
|
||||
|
||||
- T1 `failReceipt`：`resultFingerprint = {safe_error_code, engine_message}`；`console.warn` JSON `{event:rectification_tool_failed, tool, case_id, code, message}`。`engineMessageForReceipt` 打码 UUID/邮箱。`safeToolErrorCode` 与 `SAFE_TOOL_ACTIVITY_CODES` 加入 `invalid_case_id` / `invalid_domain` / `invalid_event_kind` / `invalid_focus` / `tool_call_rejected`；未知 tool-error 活动带 `code=tool_failed`。
|
||||
- T2 活动焦点 `questionId` 相同则返回已有焦点；spoken_prompt 合法时尝试更新 schema，RPC 失败仍成功返回。`targetKind` 不再走证据种类 Zod；新焦点 persist 仍 `targetKind: null`。
|
||||
- T3 `recapLine`：短语含 `\d{4}年` 或以标签开头时只用短语。
|
||||
- T4 本文件、BUG-659/660、CHANGELOG、任务板改为待验收。
|
||||
|
||||
## 验收（本机，未部署）
|
||||
|
||||
- `frontend` `./node_modules/.bin/tsc --noEmit --incremental false`：**0 错**（约 5 分钟）
|
||||
- eslint 变更文件 **0 error / 27 warning**（`rectification-v9-tools.ts` 既有 unused-import，未在本单清扫）
|
||||
- 相关套件 `tsx --test` 八个文件（新合同测试、host-fallback、stream、status-security、v10 tool-contract、server-focus、v9-agent、collect-prompt）：**138 pass / 0 fail**
|
||||
- 新文件 `rectification-set-focus-tool-failed-20260912.test.ts`：**4 / 4**
|
||||
- 未跑 `next build` / 首屏 gzip
|
||||
- 未部署 staging 真机走查
|
||||
|
||||
## 未做
|
||||
|
||||
- 未 push、未部署。真机：开场说两件学业，本轮不得出现 `tool_failed`；兜底或模型正文日期不重复。
|
||||
@@ -174,7 +174,7 @@
|
||||
| `TASK-rectification-narrow-before-deliver-20260911.md` | `PROGRESS-rectification-narrow-before-deliver-20260911.md` | 09-11 真机：池空即出卡但范围仍 20 分钟——探针只在引擎跑时按初始簇生成一次、家人题被 0.85 先验丢弃、交付前无定向补事（BUG-653/654，Skill 10.0.24） | 已实现 `6c9a0896`，已部署；验收见修复单 | `codex/rectification-narrow-before-deliver-20260911` |
|
||||
| `TASK-rectification-targeted-collect-persist-20260911.md` | `PROGRESS-rectification-targeted-collect-persist-20260911.md` | 09-11 真机：6c9a0896 后六题答完又无题无卡——定向/锚定/通用采集题 `kind_hint` 违反 `target_kind` CHECK 落不了库、引擎刷新用整网格空转、`targetedCollectExhausted` 按池非空判定成永久等待。执行方只拿到 T0/T3 片段，做成 BUG-655（刷新空题不写库） | 部分实现 `512be9b7`；余项见修复单 | `codex/rectification-targeted-collect-persist-20260911` |
|
||||
| `TASK-rectification-targeted-collect-persist-fix-20260911.md` | `PROGRESS-rectification-targeted-collect-persist-fix-20260911.md` | 修复单：BUG-656 采集焦点 kind 映射到 CHECK 枚举；BUG-657 引擎刷新按 `column_times` 取剩余候选；BUG-658 刷新尝试持久化 + 等待收窄以已问过判定（512be9b7 让无新题时 GET 永远等待且每轮重调引擎） | 已实现 `eae049d0` + `529fcc09`，已部署；静态验收通过，真机六题流程待走 | `codex/rectification-targeted-collect-persist-fix-20260911` |
|
||||
| `TASK-rectification-set-focus-tool-failed-20260912.md` | `PROGRESS-rectification-set-focus-tool-failed-20260912.md` | 09-12 真机：记完两件学业后 `rectification-set-focus` 连续六次 `tool_failed`（兜底码，原始错误无处记录；焦点其实已由 batch 工具落下）、宿主兜底正文日期重复（BUG-659/660） | 待执行 | `codex/rectification-set-focus-tool-failed-20260912` |
|
||||
| `TASK-rectification-set-focus-tool-failed-20260912.md` | `PROGRESS-rectification-set-focus-tool-failed-20260912.md` | 09-12 真机：记完两件学业后 `rectification-set-focus` 连续六次 `tool_failed`（兜底码，原始错误无处记录；焦点其实已由 batch 工具落下）、宿主兜底正文日期重复（BUG-659/660） | 待验收 | `codex/rectification-set-focus-tool-failed-20260912` |
|
||||
|
||||
## 命名与归档
|
||||
|
||||
|
||||
Reference in New Issue
Block a user