Jyotisha/docs/tasks/TASK-rectification-targeted-collect-persist-fix-20260911.md

# TASK · 修复单：BUG-655（512be9b7）验收后仍未闭合的三处——采集焦点 kind 违反表约束、引擎刷新用整网格、无新题时 GET 永远「等待收窄」（2026-09-12）

- 基线：`origin/staging` @ `e59dd47c`（已部署；代码 `512be9b7`）
- 分支：`codex/rectification-targeted-collect-persist-fix-20260911`，基于 `origin/staging`
- 执行方：coding agent；验收：Claude
- BUG 编号起点：**BUG-656**（开工时核对 `docs/BUG_HISTORY.md` 最大号，应为 655）
- 本单是 `TASK-rectification-targeted-collect-persist-20260911.md` 的修复单。执行方当时只拿到该单 T0/T3 的片段（见其 PROGRESS「任务单不在本仓」），原单 §2.1 / §2.2 / §2.3 三条根因一条都没改；原单本次已随本单一并入库。

## 1. 验收结论（Claude，2026-09-12，基于 e59dd47c）

| 项 | 结论 | 依据 |
| --- | --- | --- |
| 512be9b7 T3「空刷新不写库、候选集变更不写库、并入探针 id 与已答同名」 | **通过** | `refresh-discriminator-probes.ts` `refreshWriteBlockedReason` / `alignedProbeId`；`tsc --noEmit` 0 错；相关测试 fail=0 |
| 原单 §2.1 定向 / 锚定 / 通用采集焦点写不进库 | **未通过（未做）** | `server-focus.ts` L346 仍 `targetKind: input.followup.kind_hint ?? null`；`targeted:<domain>` 违反 `agentic_rectification_conversation_focuses.target_kind` CHECK（`20260814020000_rectification_v10_runtime.sql` L124–131），无后续迁移放宽 |
| 原单 §2.2 引擎刷新按剩余候选生成 | **未通过（未做）** | `refinement_packet.py` L707 仍 `grid_times = built.candidate_times`，`column_times` 只喂三列对照；`refresh_probes` 分支永远拿到全网格 |
| 原单 §2.3 「等待收窄」必须有载体 | **未通过（未做），且 512be9b7 让它变成永久状态** | 见 §2 |
| 真机 | 未做（无登录态） | 需部署后按场景 0c 走 |

## 2. 512be9b7 引入的新死角（BUG-658）

刷新没有新题时现在**什么都不写**（`rectification_refresh_persist_skipped reason=no_new_probes`）。于是库里 `refresh_count` 恒为 0：

- GET `decideFromDossier` → `narrowingExhaustion`：`refreshed=false` 且剩余换升层非空 → `refreshExhausted=false` → `stillNeedNarrowing` 恒真 → `decideRectification` 走 `collect(..., waitToNarrowCapability)`：无题、无卡、`can_adopt=false`。GET 路由本身不调刷新，这个状态**永远**翻不过来。
- 答题事务 / 空闲路径每次都会再调一次引擎（`runV9CandidateScore`，真机单次约 20 s），因为 `shouldRefreshDatedPool` 只看库里的 `refresh_count`。
- 由于 §1 的 §2.2 未改，刷新在本案永远是 `no_new_probes`，所以本案在 e59dd47c 上的表现与 6c9a0896 相同：第六题答完后「没有拿到下一个问题」，且不再出卡。

## 3. 决策记录（沿用原单 §3，补一条）

5. 「刷新已尝试且无新题」必须是**持久化事实**：写进 `inference_state.refresh_attempts[]`（`{candidate_set_id, answer_count, result:"no_new_probes"|"new_probes", at}`），不新增推理 transition 行也可以（允许走 `persistV9InferenceState` 之外的轻量字段，例如 latest_result.decisionReceipt 的 `refresh_attempts`）；`refreshExhausted` 由「同一候选集、同一已答数下已有一次尝试记录」判定，`shouldRefreshDatedPool` 同源。

## 4. 硬红线

沿用原单 §4；另加：不得让 GET 的决策依赖只存在于内存的刷新结果；同一候选集、同一已答数下引擎刷新最多调用一次。

## 5. 任务分解

- **T1 采集焦点 kind 映射（BUG-656 = 原单 §2.1 / T1）**：`server-focus.ts` `persistCollectFocus` / `persistSpokenChoiceFallback` 写 `targetKind` 前经 `collectFocusTargetKind(followup)`（按领域映射到 CHECK 枚举：family→`family_event`、finance→`finance_gain`、relocation→`relocation`、relationship→`relationship_change`、career→`career_change`、education→`education_milestone`、health→`self_health_event`，其余 null）；`kind_hint` 原值写入 `expected_answer_schema.collect_kind`；读取侧（`answer-choice.ts` / `agent-run.ts` / `collection-question-pool.ts` 的 invite / anchor / generic / targeted 判定）改读 `collect_kind`，找不到时回退旧字段。验收：`rectification-server-focus.test.ts` 用真实 CHECK 列表断言三类 followup 的 `targetKind` 合法、`status=created`；回放测试第六题答完 → 定向题「还有 N 条线能把 04:48 和 05:07 分开：…」成为活动焦点。
- **T2 引擎按剩余候选刷新（BUG-657 = 原单 §2.2 / T2）**：`refinement_packet.py` 在 `request.refresh_probes` 为真且 `column_times` 非空时，把 `column_times` 作为 `_discriminating_event_probe_lists` 的 `candidate_times`；`event_probes.py` `refresh and remaining` 分支据此命中。验收：`tests/test_candidate_discriminator_contract.py` 加「31 格 + column_times=5」夹具，断言簇按 5 个候选重算且探针 `candidate_ids` 只含这 5 个；若确无边界则 `public=[]` 并在回执写 `refresh_result="no_new_probes"`。
- **T3 刷新尝试持久化 + 等待收窄以「已问过」判定（BUG-658 = 原单 §2.3 / T3 + 本单 §2）**：按 §3.5 写 `refresh_attempts`；`narrowingExhaustion.refreshExhausted` = 当前候选集与已答数下已有尝试记录 或 剩余换升层为空；`targetedCollectExhausted` = `collect:targeted:*` 焦点已存在且非 active 或池空；定向题落库 `skipped` 时同一事务把 `collect:targeted:<domain>` 记为 `skipped` 话题并按 BUG-651 出卡。客户端 `rectificationQuestionGapState`：`sessionOutcome=collect_evidence && !stopReason && 无焦点无卡` → `collect_waiting`。验收：模拟引擎恒返回旧题 → 第一次刷新后 `refresh_attempts` 有记录、第二次不再调引擎、GET 决策进入定向补事或出卡；模拟定向题落库失败 → 同一事务出「目前范围」卡，不出现「没有拿到下一个问题」。
- **T4 记录**：BUG-656～658 入历史（656 关联 BUG-648 / 442；657 关联 BUG-653；658 关联 BUG-655 / 651 / 652）；CHANGELOG；PROGRESS；场景 0c 补「定向题必须出现、无新题不重复调引擎」。

## 6. 让步顺序

T1 + T3 不可省（它们决定用户能不能继续）；T2 可拆下一单，但拆出去时 T3 必须让「无新题」直接进定向补事。

## 7. 开工前置命令

```bash
git fetch origin --prune
git worktree add -b codex/rectification-targeted-collect-persist-fix-20260911 .worktrees/rectification-targeted-collect-persist-fix-20260911 origin/staging
grep -o "^## BUG-[0-9]*" docs/BUG_HISTORY.md | sort -t- -k2 -n | tail -1   # 应为 655
cd frontend && npm test -- tests/rectification-server-focus.test.ts tests/rectification-probe-pool-exhausted-20260911.test.ts tests/rectification-replay-20260911.test.ts
cd .. && .venv/bin/python -m pytest tests/test_candidate_discriminator_contract.py tests/test_rectification_event_probes.py -q
```

## 8. 验收口径

沿用原单 §8；真机：§1 序列第六题答完必须看到定向补事题；说「没有了」后看到「目前范围」卡；全程不出现「没有拿到下一个问题」；同一候选集下引擎刷新只调用一次（容器日志 `rectification_refresh_persist_skipped` 至多一条）。