merge: land conversational rectification on main

docs/BUG_HISTORY.md

@@ -345,3 +345,99 @@
 - 相关记录：BUG-017、BUG-018
 - 复发自：无
 - 修复版本：待提交
+
+## BUG-020 | 生时校正把语言问答包装成高阻力卡片表单
+
+- 状态：resolved
+- 首次发现：2026-07-22
+- 最近更新：2026-07-22
+- 影响面：首页生时校正会话、经历录入、候选核对与更正
+- 用户现象：每轮同时出现候选卡、领域按钮、年份与月份下拉、经历回顾卡和确认卡；用户需要理解多层控件才能回答一个问题，移动端尤为费力。
+- 触发条件：进入生时校正并提交或更正一条真实经历。
+- 根因：后端已有自由文本证据契约，但前端仍用结构化表单和多卡片包装；校正叙事 Agent 也未加载 Jyotish Skill 来生成自然、逐问式的取证措辞。
+- 修复：改为一段助理提问加一个自然语言输入框；候选状态和证据历史收进可展开进度区；保留明确确认、更正、持久化、计费、计算和分钟验证门禁；叙事 Agent 加载 Jyotish Skill，但服务端技术包仍是候选事实和确认权限的唯一来源。
+- 验证：语言优先组件静态与真实 Chromium 390px 回归 8/8 通过；校正路由与叙事契约 23/23 通过；目标文件 ESLint 和 Next.js production build 通过。
+- 防复发：语言问答不得重新拆成领域按钮或日期下拉；Skill 只能改进问题策略与措辞，不得生成、重算或确认候选时间。
+- 相关记录：BUG-008、BUG-009、BUG-015、BUG-016、BUG-017
+- 复发自：无
+- 修复版本：待提交（本地可测）
+
+## BUG-021 | 自然语言真实事件在分钟评分入口被静默丢弃
+
+- 状态：resolved
+- 首次发现：2026-07-22
+- 最近更新：2026-07-22
+- 影响面：生时校正自然语言抽取、历史事件持久化、分钟评分、首轮与兜底叙事
+- 用户现象：用户已经提供带日期的真实经历，系统仍反复索取证据；首轮回答展示完整 D 层技术清单，却没有用一个具体问题推进取证。19 世纪事件、疾病、手术、事故和丧亲尤其容易无法参与评分。
+- 触发条件：日期早于 1900 年；事件属于健康或重大压力；累计有效事件超过 6 条；或叙事模型未满足首轮全量技术层合同而进入确定性兜底。
+- 根因：前端日期正则写死 1900–2099；健康类关键词落入 `other`，并在路由中被过滤，尽管后端已有 `health_pressure` 与 D30 评分支持；路由另有独立的 6 条截断；叙事校验强制首轮正文列出全部稳定层、敏感层和值。
+- 修复：日期抽取支持 1000–2099 的四位历史年份；健康、事故、丧亲映射到既有 `health_pressure`/D30 合同并贯通持久化、旧数据导入和公开 turn schema；评分截断统一复用 8 条收敛上限；技术包和 validation receipt 继续完整保存，但非最终用户正文只呈现候选范围、未确认边界和一个高信息量问题，确定性兜底也遵守相同语言交互。
+- 验证：抽取、叙事、路由聚焦测试 59/59 通过；真实案例回放、编排和端到端契约 65/65 通过；目标文件 ESLint、Python replay/compilation、`git diff --check` 和 Next.js production build 通过。公开 smoke 中 Steve Jobs、Einstein、Marie Curie 分别保留 4、3、4 条可评分事件，产品过滤结果与结构化 oracle 一致。
+- 防复发：新增 18xx 中文与 ISO 日期、健康/事故/丧亲、8 条事件上限和单问题兜底断言；技术层可进入服务端证据包，不得重新进入普通会话正文；family/other 仍是持久化背景，不得伪装成已评分领域。
+- 相关记录：BUG-008、BUG-009、BUG-015、BUG-016、BUG-020
+- 复发自：BUG-020
+- 修复版本：待提交（本地可测）
+
+## BUG-022 | 生时校正入口等待首轮请求完成后才切换会话
+
+- 状态：resolved
+- 首次发现：2026-07-22
+- 最近更新：2026-07-22
+- 影响面：首页生时校正入口、普通咨询中的“先完成生时校正”、侧栏恢复校正会话
+- 用户现象：点击生时校正后长时间停留在首页或原咨询 session，直到恢复、建案、计算和会话持久化全部完成才突然跳转，用户容易误以为点击无效并重复操作。
+- 触发条件：`start`、`resume`、durable handoff 或 session persistence 任一请求响应较慢。
+- 根因：`openBirthTimeRectification` 虽然先设置了 loading，但专属 session 的插入、激活和校正 surface 的开放都位于首个异步请求之后；surface 还要求首个 turn 已存在，因此 loading 状态无法在目标会话中显示。
+- 修复：创建或复用专属 session 后，在任何 `await` 之前立即插入并激活该 session；校正 surface 允许以空 turn 渲染既有“正在建立校正记录…”状态；增加同步 in-flight 门禁防止快速重复点击发出多个启动请求；失败时新建 session 回滚到来源会话，复用 session 则保留可见错误与重试入口。
+- 验证：`frontend/tests/consultation-entrypoint.test.ts` 21/21 通过，锁定 session 插入、激活和 loading surface 必须早于首个异步请求，并锁定单请求门禁；目标文件 ESLint、`git diff --check` 和 Next.js production build 通过；真实应用内 Chromium 从首页点击时，在后台恢复完成前已经显示“正在建立校正记录…”，从普通会话切回校正 session 也立即显示目标会话。
+- 防复发：首页卡片、普通 session 建议和侧栏恢复必须继续共用同一启动函数；不得重新用首个 turn 是否返回作为 session 可见性的条件。
+- 相关记录：BUG-016、BUG-020、BUG-021
+- 复发自：无
+- 修复版本：待提交（本地可测）
+
+## BUG-023 | 初始化地址保存后的加载提示仍指向生时评估
+
+- 状态：resolved
+- 首次发现：2026-07-22
+- 最近更新：2026-07-22
+- 影响面：新用户初始化流程、出生地点保存后的全屏加载提示
+- 用户现象：用户填完出生地址后，页面实际准备进入首页，但加载提示仍显示正在生成生时评估，造成流程去向与界面文案不一致。
+- 触发条件：初始化流程完成出生时间填写，并提交最后一步出生地点。
+- 根因：出生时间保存和出生地点保存共用 `saving_profile` 展示阶段；该阶段文案仍按旧流程描述为即将生成生时评估。
+- 修复：新增独立的 `entering_home` 展示阶段，仅在 `saveOnboardingPlace` 提交地址时使用，显示“正在进入首页 / 出生资料已保存，正在为你准备首页。”；出生时间保存继续使用原 `saving_profile` 阶段。
+- 验证：聚焦测试锁定地址提交与 `entering_home` 的绑定及目标文案；目标文件 ESLint 与 `git diff --check` 通过。
+- 防复发：初始化步骤的加载文案必须绑定实际导航结果；不得通过修改共享 `saving_profile` 文案改变出生时间提交阶段的语义。
+- 相关记录：BUG-022
+- 复发自：无
+- 修复版本：待提交（本地可测）
+
+## BUG-024 | 侧栏会话标题与更多操作被拆成两块
+
+- 状态：resolved
+- 首次发现：2026-07-22
+- 最近更新：2026-07-22
+- 影响面：聊天记录侧栏、当前会话选中态与更多操作入口
+- 用户现象：会话标题显示在一块选中背景中，右侧更多操作却以独立圆形按钮悬在外侧，看起来像两个不一致的控件。
+- 触发条件：侧栏展开并选中任意会话。
+- 根因：选中背景只应用在左侧 `.session-main`，右侧 `.session-menu-trigger` 又单独使用 `50%` 圆角和悬停背景。
+- 修复：把选中、悬停和聚焦背景统一应用到整行 `.session-row`；子按钮保持透明，并移除更多操作按钮的独立圆形底色。
+- 验证：侧栏契约测试锁定整行选中背景、透明标题按钮和非圆形更多操作按钮；目标文件 ESLint 与 `git diff --check` 通过。
+- 防复发：会话标题和行内操作必须共享同一个行级状态面，不得分别绘制互相竞争的选中背景。
+- 相关记录：无
+- 复发自：无
+- 修复版本：待提交（本地可测）
+
+## BUG-025 | 健康压力追问被数据库误判为校正操作冲突
+
+- 状态：resolved
+- 首次发现：2026-07-22
+- 最近更新：2026-07-22
+- 影响面：生时校正首条自然语言回答、`POST /api/birth-time-conversation`、Supabase 对话持久化契约
+- 用户现象：用户提交一条带年月的真实经历后等待约一分钟，接口返回 `409 action_conflict`，页面提示加载最新进度后重试；重复提交仍无法进入下一问。
+- 触发条件：技术包为下一轮选择 `health_pressure`（健康与重大压力）作为待补证据领域。
+- 根因：应用层已把 `health_pressure` 作为正式领域，并允许语言问答每轮只追问一个重点领域；durable SQL 既缺少该领域，又要求 evidence request 至少包含两个领域。完整计算和叙事生成完成后，`save_conversational_rectification_turn` 才以 `conversational_action_conflict` 拒绝公开 turn。
+- 修复：新增向前迁移，将 `health_pressure` 同步加入四个 durable validator 和事件证据表约束，并把 evidence request 基数从 2–4 对齐为应用契约的 1–4；保留现有幂等、版本和候选确认门禁。
+- 验证：真实浏览器复现确认只有 `conversational_rectification_valid_evidence_request` 失败，其余公开 turn 子结构、事件、回执和私有候选均通过；迁移应用到测试 Supabase 后，用同一条“2023 年 3 月离家来北京工作”重放，`POST /api/birth-time-conversation` 返回 `200`，日志为 `actionKind: answer`、`resultCategory: success`，事件规范化保存为 `2023-03 · 离家来北京工作`，页面继续自然追问学业经历且输入框恢复可用；聚焦迁移测试锁定四个 validator 与表约束必须共同支持该领域。
+- 防复发：应用 evidence domain 枚举新增值时，必须同时更新 TypeScript schema、公开 recap/request、私有候选、事件表约束和迁移契约测试；不得把正常领域扩展映射为通用 409。
+- 相关记录：BUG-007、BUG-020、BUG-021
+- 复发自：BUG-007
+- 修复版本：待提交（测试 Supabase smoke 通过）