Files
Jyotisha/docs/tasks/TASK-rectification-range-delivery-fix-20260907.md
T

3.2 KiB
Raw Blame History

TASK · 区间交付卡修复单:tsc 判空顺序、兑现不了的预测窗口句、再补经历无提示(2026-09-07)

  • 基线:origin/staging @ ab57d03f
  • 分支:codex/rectification-range-delivery-fix-20260907
  • 执行方:coding agent;验收:Claude
  • 优先级:P1 阻断tsc 不过,staging 门禁与 next build 都会失败,BUG-581~582 的 P0 修复被一起卡住)
  • BUG 编号起点:BUG-583(开工时 grep -o "^## BUG-5[0-9][0-9]" docs/BUG_HISTORY.md | tail -1 复核)

1. 事故实证

# 事实 位置
1 tsc --noEmitTS18047: 'candidateResult' is possibly 'null' frontend/src/components/rectification-agentic-chat.tsx L1655showSelectionCards && dismissedRangeResultId !== candidateResult.resultId && message.renderKey === selectionCardMessageKey && candidateResult && (…)
2 交付旁白句"下一次事业变动的预测窗口留在采用后的核对阶段",但 prospectiveWindowsNarration 已无任何调用点,采用后从不展示 user-copy.ts deferredCareerWindowgrep prospectiveWindowsNarration 只剩定义
3 「再补一件经历」只 setDismissedRangeResultId,卡片消失后没有任何提示 rectification-agentic-chat.tsx onContinue
4 执行方进度记录写"tsc 0",与 ab57d03f 实测不符 PROGRESS-rectification-range-delivery-card-20260907.md

2. 决策记录

  1. 判空提到最前:showSelectionCards && candidateResult && dismissedRangeResultId !== candidateResult.resultId && …
  2. 预测窗口二选一,本单选 接上:采用后 postAdoptVerify 第一轮旁白末尾追加 prospectiveWindowsNarration(receipt.prospective_probes)(有则加,无则不加);deferredCareerWindow 句保留。若执行方评估接不上,则删句并写明。
  3. 「再补一件经历」隐藏卡片后,步骤条切到"第 1 步·收集经历"文案,并在输入框上方给一句 continueCollectFallback(已有文案:"请继续说下一件你记得比较清楚、大概带年份的经历。")。
  4. 进度记录必须贴 tsc --noEmit 的真实输出行;没有复跑不得写 0。

3. 任务分解

  • 3.1 判空修复 + 源扫描断言(rectification-range-delivery-20260907.test.ts:正则锁定 candidateResult && 出现在 dismissedRangeResultId 之前)。
  • 3.2 预测窗口接到采用后首轮(postAdoptVerify 路径),测试:有 prospective_probes 的 receipt → 采用后首轮旁白含"预测下一次事业变动";无则不含。
  • 3.3 再补经历提示:组件测试——点击后卡片隐藏且出现 continueCollectFallback
  • 3.4 记录:BUG-583tsc 判空,复发自本单 4.2);CHANGELOG 一句;PROGRESS 贴 tsc 原文。

4. 让步顺序

3.1 必须当天合入(否则 P0 修复无法部署);3.2、3.3 其次;3.4 不可省。

5. 开工前置命令

git fetch origin --prune
git worktree add -b codex/rectification-range-delivery-fix-20260907 .worktrees/rectification-range-delivery-fix-20260907 origin/staging
cd .worktrees/rectification-range-delivery-fix-20260907
ln -s /workspace/Jyotisha/frontend/node_modules frontend/node_modules
cd frontend && ./node_modules/.bin/tsc --noEmit; echo "tsc exit $?"