docs(tasks): other-collect fallback dead-end fix brief (BUG-586)
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0193vBv6w5MV2cifdTUu9H5P
This commit is contained in:
Jesse_Chen
@@ -73,6 +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-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） |
|
||||
|
||||
|
||||
@@ -0,0 +1,83 @@
|
||||
# TASK · 生时校正修复单：采集问完落到「也可以再说一件你记得大概时间的事」，职业题从未出现、没有自动出卡（2026-09-08）
|
||||
|
||||
- 基线：`origin/staging` @ `3973b6c3`（代码头 `a00b069d`，staging 已部署 `a00b069d`；事故转录来自 2026-09-07 晚间实测，跑在 `84a29754` 还是 `a00b069d` 上待用户确认，下文两版都对过）
|
||||
- 分支：`codex/rectification-other-collect-fallback-20260908`，基于 `origin/staging`
|
||||
- 执行方：coding agent；验收：Claude
|
||||
- 涉及文件：`frontend/src/lib/rectification-agentic/v9/server-focus.ts`（`persistableFocusDomain`、`stableFollowupQuestionId`）、`v9/method-followup.ts`（active-focus 承接 followup、`collectQuestionDomain`、`otherCollectFollowup` 死代码）、`frontend/src/mastra/rectification-v9-tools.ts`（set-focus 的 `invalid_spoken_prompt` 兜底 L1085–1100）、`frontend/src/lib/rectification-agentic/user-copy.ts`（`USER_COLLECT_QUESTION.other` / `_RETRY.other`）
|
||||
- BUG 编号起点：**BUG-586**（584/585 已由重复旁白修复单占用；开工时 `grep -o "^## BUG-5[0-9][0-9]" docs/BUG_HISTORY.md | tail -1` 复核）
|
||||
- 优先级：**P1**（采集走完后无出口，第四次实测复现；BUG-558 同现象、不同来路）
|
||||
|
||||
## 1. 事故实证（只写结构）
|
||||
|
||||
七个带年月领域全部问过或拒过（学业、感情、事业、家人拒答、财务、迁居、健康），中间答了 5 张点选卡，范围从 30 分钟收到 8 分钟。最后一轮：
|
||||
|
||||
1. 助手气泡两段旁白（BUG-584）；
|
||||
2. 「本轮对照了 …」方法句；
|
||||
3. 问题块：**「也可以再说一件你记得大概时间的事。」**——这是 `USER_COLLECT_QUESTION.other` 逐字；
|
||||
4. 没有区间交付卡、没有职业题「你平时主要做什么工作？」、没有停止按钮以外的出口。receipt 显示该轮 6 步（此前每轮 3 步）。
|
||||
|
||||
按当前设计，这一步应当是：职业口述题 → （若有未问领域则 holdout）→ `adopt_representative` 自动出区间交付卡。职业题一次都没出现，而「other」这句取代了它。
|
||||
|
||||
## 2. 已由代码确认的事实
|
||||
|
||||
### 2.1 这句固定文案在 `a00b069d` 仍有三条活路
|
||||
|
||||
`spokenFollowupForUser` 对 `domain="other"` 的采集 followup：只有「`source=method_coverage` 且 `method_id=dasha_events` 且非 retry 且账本无带年月事件」才给开场句 GENERIC；其余一律查表落到 `USER_COLLECT_QUESTION.other`。BUG-558 只堵了 `exhaustionSpokenCollectFollowup` 这一条（`otherCollectFollowup` 现已无人调用，是死代码），但 `domain="other"` 还能从下面三处产生：
|
||||
|
||||
| # | 来路 | 位置 |
|
||||
| --- | --- | --- |
|
||||
| A | **职业焦点落库时领域被压成 other**：DB 约束 `target_domain in (education, career, relationship, relocation, finance, health, family, other)` 没有 `occupation`，`persistableFocusDomain("occupation")` 返回 `"other"`（测试 `rectification-server-focus.test.ts` L716/L775 锁定）。随后 `buildMethodFollowupPlan` 有 active focus 时用 `domain: focus.targetDomain` 重建「承接 followup」（`method-followup.ts` L2016–2025，`source="active_focus"`），职业焦点被重建成 `domain=other, intent=collect`，`spokenFollowupForUser` 给出「也可以再说一件」。`stableFollowupQuestionId` 对它算出 `collect:other:collect_method_evidence`，与原职业焦点 `collect:occupation:collect_method_evidence` 不同，因此不会被判 `already_open`，会 supersede 掉职业题 | `server-focus.ts` L201–206、L52–53；`method-followup.ts` L2016 |
|
||||
| B | **set-focus 工具的兜底**：模型 `spokenPrompt` 两次 `invalid_spoken_prompt` 后，`USER_COLLECT_QUESTION[nextFollowup.domain]` 直接落库；`nextFollowup.domain="other"` 时就是这句 | `rectification-v9-tools.ts` L1085–1100 |
|
||||
| C | `spokenCollectFallbackFollowup` / `collectQuestionDomain(null | "unknown" | "active_focus")` 把无领域的采集 followup 归为 other | `method-followup.ts` L1343、L1371 |
|
||||
|
||||
### 2.2 尚未确认的触发链（`investigating`）
|
||||
|
||||
最符合转录的链：该轮模型先用 set-focus 写出职业题（焦点 `target_domain=other`），同一轮再次调用 set-focus（6 步）；第二次的 `next_followup` 是承接 followup（`domain=other`），模型的 `spokenPrompt` 因 `domain_mismatch`（模型填 `targetDomain="career"`，`persistableFocusDomain` 后 ≠ `"other"`）或词表问题两次被拒，走 2.1-B 兜底，把职业题覆盖成「也可以再说一件」。**这一段需要事故 Case 的 receipt 证实**（预期能看到两条 `rectification-set-focus / intent.classified / failed / invalid_spoken_prompt` 和一条 completed，以及 `collect:occupation:*` 焦点被 `collect:other:*` supersede）。执行方拿不到 staging 数据时，把这一节保留为 `investigating`，不得编造。
|
||||
|
||||
无论触发链是哪条，2.1 的三条活路都是确定性缺陷，修掉后这句话在代码里不再存在。
|
||||
|
||||
### 2.3 为什么没有自动出卡
|
||||
|
||||
出卡的服务端路径是 `persistNextInterviewIfIdle → persistExhaustionCollect`：`exhaustionSpokenCollectFollowup` 为空且 `acceptanceAllowed && trainingGate.open && canAdopt` 时写 `adopt_representative` 旁白 + `terminalNote`，客户端据此渲染区间交付卡。它只在**没有 active focus** 时运行（L1158 提前返回）。一个 `collect:other:*` 焦点挂着，出卡永远轮不到；用户答了这句「再说一件」之后，若职业仍未覆盖，还会再来一遍。
|
||||
|
||||
## 3. 决策记录
|
||||
|
||||
1. **删掉 `USER_COLLECT_QUESTION.other` 与 `USER_COLLECT_QUESTION_RETRY.other`**（产品口径：多余入口宁可删除也不修）。`spokenFollowupForUser` 对 `domain=other` 只剩开场 GENERIC 一条路；非开场的 other 返回 `null`，上游按「无可问」处理。`otherCollectFollowup` 一并删除。
|
||||
2. **职业焦点不再丢领域。** 不改表（本轮不动迁移）：`target_domain` 仍写 `other`，但 `questionId` 已是 `collect:occupation:collect_method_evidence`；承接 followup 的 `domain` 改为「先从 `questionId` 解析 `collect:<domain>:` 段，再退回 `focus.targetDomain`」。新增 `parseCollectFocusQuestionId`。`persistableFocusDomain("occupation") === "other"` 的两条测试保留（DB 约束未变）。
|
||||
3. **set-focus 兜底只允许表内真实领域。** L1085–1100：`fallbackDomain` 必须是 `USER_COLLECT_QUESTION` 的键且 ≠ `other`（删表后自然满足），否则返回 `invalid_spoken_prompt` 不落地；且兜底题干必须与当前 `next_followup` 同领域。
|
||||
4. **同一轮第二次 set-focus 必须承接、不得覆盖。** 若 active focus 的 `askedTurnId === turnId`（本轮刚写的），set-focus 返回该焦点投影并标 `idempotent: true`，不重建、不 supersede。
|
||||
5. **有 `collect:other:*` 非开场焦点的存量 Case**：`persistNextInterviewIfIdle` 开头把这种焦点判为 stale 并 `skipped`（复用 `isStalePreAdoptFocus` 旁边加一条 `isOrphanOtherCollectFocus`：`questionId` 以 `collect:other:` 开头且账本已有带年月事件），让出卡路径能跑起来。
|
||||
6. 不动采用门、确认门、`MIN_SEPARATION_LEAD`、`_relative_support`、`minute_step=1` 指纹；不动 `page.tsx`；Skill 不 bump。
|
||||
|
||||
## 4. 任务分解
|
||||
|
||||
### 4.1 BUG-586：三条活路 + 出卡
|
||||
- 决策 1–5 全部落地。
|
||||
- 验收（形状用例，`rectification-collect-stall.test.ts` / `rectification-occupation-coverage-exit.test.ts` 扩）：
|
||||
- (a) 7 个带年月领域已覆盖或拒答、职业未覆盖、active focus 为 `collect:occupation:*`（`target_domain=other`）→ `buildMethodFollowupPlan` 的承接 followup `domain === "occupation"`，`spokenFollowupForUser` 给「你平时主要做什么工作？」，`stableFollowupQuestionId` 等于原焦点 id（`already_open`，不 supersede）。
|
||||
- (b) 同 (a)，模型 `spokenPrompt` 两次无效 → set-focus 返回 `invalid_spoken_prompt`，**不**落库任何 `collect:other:*`。
|
||||
- (c) 同一轮 set-focus 两次（第二次 `next_followup` 为承接 followup）→ 第二次返回 `idempotent: true`，焦点 id 不变。
|
||||
- (d) 职业已答、无剩余采集、`acceptanceAllowed && trainingGate.open && canAdopt` → `persistNextInterviewIfIdle` 返回 `terminalNote: true` 的采用旁白，`agent-run` 写 exhaustion gate turn，客户端 `canOfferCards` 为真（区间交付卡）。
|
||||
- (e) 存量 `collect:other:*` 焦点 + 账本有带年月事件 → 进入 `persistNextInterviewIfIdle` 时被 `skipped`，随后走 (d)。
|
||||
- (f) `agent-voice-copy-contract`：源码与 `user-copy.ts` 不再含「也可以再说一件」；`rectification-server-focus.test.ts` L517/L727、`rectification-adopt-flow-*.test.ts` 里以 `collect:other:collect_method_evidence` 为期望值的断言逐条写「原值 / 新值 / 原因」。
|
||||
|
||||
### 4.2 记录
|
||||
- `docs/BUG_HISTORY.md` BUG-586：状态先写 `investigating`（2.2 未证实）或 `resolved`（若执行方能从 staging receipt 证实触发链）；复发自 BUG-558（同现象），关联 BUG-580、BUG-582；`CHANGELOG.md`；`PROGRESS-rectification-other-collect-fallback-20260908.md`；`docs/testing/rectification-scenarios-20260907.md` 加「七领域问完后下一问必须是职业题或直接出区间卡，不得出现『再说一件』」。
|
||||
|
||||
## 5. 让步顺序
|
||||
|
||||
决策 1、2、3 必做且同一提交；决策 4 若 set-focus 工具改动牵扯太广可后置为 P2 但要写进度记录；决策 5 必做（否则存量 Case 卡死）；4.2 不可省。
|
||||
|
||||
## 6. 开工前置命令
|
||||
|
||||
```bash
|
||||
git fetch origin --prune
|
||||
git worktree add -b codex/rectification-other-collect-fallback-20260908 .worktrees/rectification-other-collect-fallback-20260908 origin/staging
|
||||
cd .worktrees/rectification-other-collect-fallback-20260908
|
||||
ln -s /workspace/Jyotisha/frontend/node_modules frontend/node_modules
|
||||
cd frontend && ./node_modules/.bin/tsc --noEmit; npm run lint 2>&1 | tail -1
|
||||
ls tests/rectification-*.test.ts tests/agent-voice-copy-contract.test.ts | grep -v database | xargs npx tsx --test 2>&1 | grep -E "^# (tests|pass|fail)"
|
||||
grep -rn "也可以再说一件" src tests # 收工时必须为空
|
||||
```
|
||||
|
||||
与 `codex/rectification-duplicate-narration-20260907`（BUG-584/585，改 `step-answer.ts` / `agent-run.ts` / `collect-prompt.ts`）无文件重叠；谁后合谁 rebase。
|
||||
Reference in New Issue
Block a user