fix(rectification): stop other-collect fallback from blocking delivery (BUG-586)

After the dated domains are asked or declined, keep the occupation question or the range card instead of hanging on a leftover other-collect prompt. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-08 09:02:20 +08:00
parent 6c7a8b0262
commit 9aec502961
18 changed files with 535 additions and 45 deletions
@@ -8641,7 +8641,7 @@
 - 修复：穷尽采集不再问 `other`。还有 dated / occupation 就继续问；否则 `acceptance_allowed` 且训练门开且可采用则 `adopt_representative`（`stopReason=probe_pool_exhausted`），否则写门槛翻译句、不写焦点，并用 `terminalNote` 满足非终止出口。口述采集在输入框上方放与点选卡同文案的停止按钮；只读范围改为同一停止动作。`ask_about_result` 与 `stop_rectification` 在点选和口述焦点都映射到停止。`keep_collecting` 仍继续采集，不得劫持成出牌。
 - 验证：`frontend/tests/rectification-exhaustion-exit-20260906.test.ts`；既有 adopt / spoken-collect / timeline / hidden-e2e 三栏更新。
 - 防复发：`exhaustionSpokenCollectFollowup` 不得再返回 `other`。穷尽日志必须有 `rectification_exhaustion_collect` 且不含证据摘要或年份。不得把 `keep_collecting` 改成强制采用。
- 相关记录：BUG-550、BUG-546
+- 相关记录：BUG-550、BUG-546、BUG-586
 - 复发自：无
 - 修复版本：`150d7ef1`

@@ -9046,5 +9046,19 @@
 - 复发自：无（区间卡 `ab57d03f` 引入；任务书 4.2 验收未过）
 - 修复版本：待发布（`codex/rectification-range-delivery-fix-20260907`）

+## BUG-586 | 七领域问完落到补问兜底句，职业题被覆盖、区间卡出不来

+- 状态：mitigated
+- 首次发现：2026-09-07
+- 最近更新：2026-09-08
+- 影响面：`USER_COLLECT_QUESTION`、`spokenFollowupForUser`、active-focus 承接 followup、`rectification-set-focus` 兜底、`persistNextInterviewIfIdle`
+- 用户现象：学业、感情、事业、家人、财务、迁居、健康都问过或拒过后，助手不问「你平时主要做什么工作？」，也不出区间交付卡，只剩一句「也可以再说一件你记得大概时间的事」。
+- 触发条件：七个带年月领域已覆盖或拒答，职业尚未问完或已有 `collect:other:*` 焦点挂着；同轮可能两次 set-focus。
+- 根因：三条活路已由代码确认。职业焦点落库时 `persistableFocusDomain("occupation")` 仍写 `other`（表约束没有 occupation）；承接 followup 用 `focus.targetDomain` 重建成 `domain=other`，稳定 id 变成 `collect:other:*` 并 supersede 职业题。set-focus 两次 `invalid_spoken_prompt` 后查 `USER_COLLECT_QUESTION[domain]`，`domain=other` 把那句兜底写进焦点。`collectQuestionDomain` 把空领域归为 other。挂着的 `collect:other:*` 让 `persistNextInterviewIfIdle` 见 active focus 提前返回，出卡路径跑不到。同轮第二次 set-focus 覆盖职业题的具体 receipt 链（任务书 2.2）未从事故 Case 证实，不得写成已闭环。
+- 修复：删除 `USER_COLLECT_QUESTION.other` 与 retry。非开场 `domain=other` 的口述题返回 `null`。承接 followup 从 `collect:<domain>:` 解析领域。set-focus 兜底只允许表内真实领域，否则不落地。同轮已成功的 set-focus 第二次返回 `idempotent: true`。账本已有带年月事件时，闲置路径把存量 `collect:other:*` 标 `skipped`。采用跳过持久化时写 `terminalNote`，让 agent-run 能写 exhaustion 闸门轮。
+- 验证：`frontend/tests/rectification-other-collect-fallback-20260908.test.ts`；`frontend/tests/rectification-exhaustion-exit-20260906.test.ts` 覆盖事故形状出卡；`frontend` `tsc --noEmit` 0；指定 TS 切片 983/0；`grep -rn "也可以再说一件" src tests` 为空。未拿事故 Case receipt，2.2 仍 investigating。
+- 防复发：源码与测试不得再出现「也可以再说一件」整句。`USER_COLLECT_QUESTION` 不得再有 `other` 键。职业承接 id 必须仍是 `collect:occupation:*`。set-focus 不得在 `domain=other` 时查表落地。闲置路径必须跳过孤儿 `collect:other:*`。
+- 相关记录：BUG-558、BUG-580、BUG-582
+- 复发自：BUG-558（同现象、不同来路；558 只堵了穷尽采集 `otherCollectFollowup`）
+- 修复版本：待发布（`codex/rectification-other-collect-fallback-20260908`）

@@ -0,0 +1,49 @@
+# PROGRESS · 采集问完落到补问兜底句（2026-09-08）
+
+工作树：`.worktrees/rectification-other-collect-fallback-20260908`
+分支：`codex/rectification-other-collect-fallback-20260908`
+任务书：`docs/tasks/TASK-rectification-other-collect-fallback-20260908.md`
+基线：`origin/staging` @ `6c7a8b02`
+
+本单状态：**待验收**。未 commit、未 push。
+
+未改：采用门、确认门、`MIN_SEPARATION_LEAD`、`_relative_support`、`minute_step=1`、`page.tsx`、Skill 版本（仍 10.0.15）、`persistableFocusDomain("occupation") === "other"`（表约束未动）。
+
+## 做了什么
+
+- **决策 1** 删除 `USER_COLLECT_QUESTION.other` / `_RETRY.other` 与死代码 `otherCollectFollowup`。`spokenFollowupForUser` 对 `domain=other` 只保留开场 GENERIC，其余 `null`。
+- **决策 2** 新增 `parseCollectFocusQuestionId`。active-focus 非点选承接 followup 的 `domain` 先从 `collect:<domain>:` 解析，再退回 `focus.targetDomain`。
+- **决策 3** set-focus 两次无效后的查表兜底排除 `other`；没有真实领域题干则 `invalid_spoken_prompt`、不落地。
+- **决策 4** 同轮已成功 persist 后再调 set-focus：若 active focus 的 `askedTurnId === turnId`，返回现有投影并标 `idempotent: true`。
+- **决策 5** `isOrphanOtherCollectFocus`：`collect:other:*` 且账本已有带年月事件时，闲置路径 `skipped` 后继续出卡。
+- 采用跳过 followup 持久化（idle 与 after-choice 两条）补 `terminalNote: true`，agent-run 才能写 exhaustion 闸门轮。
+
+## 三栏（被触碰断言）
+
+| 用例 | 原值 | 新值 | 理由 |
+| --- | --- | --- | --- |
+| 职业承接 followup `domain` | `focus.targetDomain`（other） | `parseCollectFocusQuestionId` → occupation | 决策 2，稳定 id 保持 `collect:occupation:*` |
+| set-focus other 两次无效 | 查表落地 `USER_COLLECT_QUESTION.other` | `invalid_spoken_prompt`，0 次 persist | 决策 3 |
+| 同轮第二次 set-focus | 可 supersede 成 `collect:other:*` | `idempotent: true`，焦点 id 不变 | 决策 4 |
+| 存量 `collect:other:*` + 已有带年月事件 | idle 见 focus 提前返回 | `skipped` 后 `terminalNote` 出卡 | 决策 5 |
+| `spokenFollowupForUser` other retry | `USER_COLLECT_QUESTION_RETRY.other` | `null` | 决策 1 |
+| 开场 `collect:other:collect_method_evidence` | 同左 | 同左 | 开场身份仍是 other + GENERIC |
+| `persistableFocusDomain("occupation")` | `"other"` | `"other"` | 表约束未改，测试保留 |
+| covered accident idle `terminalNote` | `undefined` | `true` | 验收 (d)，agent-run 闸门轮 |
+
+## 测试
+
+- `frontend` `./node_modules/.bin/tsc --noEmit`：exit 0
+- 本单改动文件 eslint：0 error（tools / method-followup 上既有 unused-import warning）
+- 任务书指定 TS 切片（`tests/rectification-*.test.ts` + `agent-voice-copy-contract.test.ts`，排除 database）：**983 passed / 0 failed**
+- `grep -rn "也可以再说一件" src tests`：空
+- Docker `database-rectification-*.test.ts`：本机未跑，记 blocked
+- 事故 Case receipt / 任务书 2.2：未取到，仍 investigating
+- 浏览器七领域真人走查：无登录态，记环境缺口，见 `docs/testing/rectification-scenarios-20260907.md` §6
+
+## 偏离
+
+1. 验收形状写在新建 `frontend/tests/rectification-other-collect-fallback-20260908.test.ts`，没有只扩 `rectification-collect-stall.test.ts` / `rectification-occupation-coverage-exit.test.ts`。既有 exhaustion-exit covered-accident 补了 `terminalNote`。
+2. `isConfirmedDated` 参数放宽为 dated 字段 Pick，否则 `ledgerHasConfirmedDatedEvent` 在 tsc 上报 domain 缺失。
+3. 决策 4 已做，没有后置为 P2。
+4. BUG-586 状态写 **mitigated** 而非 resolved：三条活路已堵，但 2.2 同轮覆盖链没有事故 receipt。
@@ -73,7 +73,7 @@
 | `TASK-rectification-range-delivery-card-20260907.md` | `PROGRESS-rectification-range-delivery-card-20260907.md` | 结尾重设计：四张分钟卡 + 相对支持度换成一张区间交付卡（范围、代表分钟、稳定/敏感主题、边界句）+ 只列未问 D9/D10/月宿分歧的 2～3 列对比面板（文案只取类型表），动作只有「按这个范围用 / 再补一件经历」；删交付旁白里三行预测窗口；Skill §9 口径改、bump 10.0.15 | **未通过**：tsc 1 错（判空顺序）；P2 预测窗口句兑现不了；P3 再补经历无提示 | `ab57d03f`；修复单 `TASK-rectification-range-delivery-fix-20260907.md` |
 | `TASK-rectification-range-delivery-fix-20260907.md` | `PROGRESS-rectification-range-delivery-fix-20260907.md` | 区间卡修复单：`candidateResult` 判空提到最前（tsc 阻断）；预测窗口接到采用后首轮或删句；「再补一件经历」隐藏卡后给采集提示；进度记录须贴 tsc 原文 | 待验收 | `codex/rectification-range-delivery-fix-20260907`（BUG-583） |
 | `TASK-rectification-duplicate-narration-20260907.md` | `PROGRESS-rectification-duplicate-narration-20260907.md` | 每轮采集旁白说两遍 + 题干在正文与问题块各一次：`step-answer` 的 set-focus 例外（BUG-533）放行了 set-focus 前后两个 step 的正文并拼接；`detachCollectSpokenAssistantText` 只剥逐字后缀，模型写进正文的问句没有代码守卫（BUG-488 防线只在提示词） | 待执行 | `codex/rectification-duplicate-narration-20260907`（BUG-584～585） |
-| `TASK-rectification-other-collect-fallback-20260908.md` | `PROGRESS-rectification-other-collect-fallback-20260908.md` | 七领域问完落到「也可以再说一件」、职业题从未出现、不自动出卡：`USER_COLLECT_QUESTION.other` 仍有三条活路（职业焦点 `target_domain` 压成 other 后被 active-focus 承接 followup 重建；set-focus 两次无效兜底查表；无领域采集归 other），`collect:other:*` 焦点挂着让 `persistNextInterviewIfIdle` 的出卡路径永远不跑 | 待执行（触发链 investigating，需事故 Case receipt） | `codex/rectification-other-collect-fallback-20260908`（BUG-586） |
+| `TASK-rectification-other-collect-fallback-20260908.md` | `PROGRESS-rectification-other-collect-fallback-20260908.md` | 七领域问完落到「也可以再说一件」、职业题从未出现、不自动出卡：`USER_COLLECT_QUESTION.other` 仍有三条活路（职业焦点 `target_domain` 压成 other 后被 active-focus 承接 followup 重建；set-focus 两次无效兜底查表；无领域采集归 other），`collect:other:*` 焦点挂着让 `persistNextInterviewIfIdle` 的出卡路径永远不跑 | 待验收（2.2 触发链仍 investigating） | `codex/rectification-other-collect-fallback-20260908`（BUG-586） |
 | `TASK-api-not-configured-mislabel-20260904.md` | `PROGRESS-api-not-configured-mislabel-20260904.md` | 16 处路由把数据库瞬断（部署切换窗口）兜底翻译成 503「服务尚未配置」；改为仅配置错误用该文案，其余 `service_unavailable`，收敛为共享 helper | 已验收 | `5483649b`（BUG-542）；2 条子进程测试留 CI Node 22 复核 |
 | `TASK-rectification-ux-20260902.md` | `PROGRESS-rectification-ux-20260903.md` | 会话面空白假死与交互摩擦 | 已验收 | `d159f08e`（09-03 在新基线重做后合入，BUG-505～509） |

@@ -90,3 +90,15 @@
 - 点「按这个范围用」成功，设置页出生时间状态变为已采用
 - 点「再补一件经历」卡片收起，输入框上方出现「第 1 步·收集经历」和「请继续说下一件…」，服务端范围不变

+## 6. 七领域问完后下一问必须是职业题或直接出区间卡
+
+资料：家人记得大概时间，钟点任意，范围「差不多准」。地点任意公开城市。
+
+开场后依次说或拒答七个带年月领域（学业、感情、事业、家人、财务、迁居、健康），不要主动说职业。
+
+期望：
+
+- 七领域问完后下一问是「你平时主要做什么工作？」，或已经可以交付时直接出区间卡
+- 不得出现补问兜底句「也可以再说一件你记得大概时间的事」
+- 职业答过、又没有剩余采集时，必须出现区间交付卡，不能只剩停止按钮
+