From 81db05c6f0180e34d8f70a076b4123231ae13367 Mon Sep 17 00:00:00 2001
From: jesse-ux <a740821056@gmail.com>
Date: Fri, 25 Sep 2026 03:12:17 +0800
Subject: [PATCH] fix(test): follow the moved onboarding shell in the
 birth-time contract

The home split moved BirthTimeRectification out of page.tsx. The gate still required that tag in the old file list. The scan now includes the shell, and page.tsx must still mount it.
---
 docs/BUG_HISTORY.md                       | 16 ++++++++++++++++
 tests/test_birth_time_journey_contract.py |  2 ++
 2 files changed, 18 insertions(+)

diff --git a/docs/BUG_HISTORY.md b/docs/BUG_HISTORY.md
index 34276ce8..2ad73ecd 100644
--- a/docs/BUG_HISTORY.md
+++ b/docs/BUG_HISTORY.md
@@ -13746,3 +13746,19 @@
 - 相关记录：BUG-1026；同步提交 `f2241463`
 - 复发自：无。这是同步漏合，不是旧 Muntha 测试覆盖过的路径。
 - 修复版本：本分支，未推 staging，未部署。
+
+## BUG-1029 | 首页拆分后出生时间合同仍只扫 page.tsx
+
+- 状态：resolved（定向回归已锁；部署待这次门禁）
+- 首次发现 / 最近更新：2026-09-25
+- 影响面：`tests/test_birth_time_journey_contract.py` 的首页引导扫描面
+- 用户现象：无。门禁 run 2887 在 `test_web_onboarding_uses_the_deterministic_free_journey` 失败，staging 停在已部署的 `9167d75e`。
+- 触发条件：首页拆分把引导屏 JSX 从 `page.tsx` 搬到 `home-onboarding-shell.tsx` 后推 staging。
+- 根因：合同把 `<BirthTimeRectification` 锁在旧的首页文件清单里。拆分后组件还在，清单没跟上。
+- 修复：扫描面加入 `home-onboarding-shell.tsx`，并要求 `page.tsx` 仍挂载 `<HomeOnboardingShell`。其余断言不放宽。
+- 验证：`tests/test_birth_time_journey_contract.py::test_web_onboarding_uses_the_deterministic_free_journey`。
+- 防复发：引导屏再搬家时，合同必须同时锁住挂载点和组件文件，不能只扫 `page.tsx`。
+- 相关记录：TASK-home-page-split-20260925
+- 复发自：无
+- 修复版本：本分支，待推送
+- 断言三栏：原值是扫描面不含引导屏组件、只要求其中出现 `<BirthTimeRectification`；新值是扫描面包含 `home-onboarding-shell.tsx`，并额外要求 `page.tsx` 挂载 `<HomeOnboardingShell`；原因是 JSX 搬家，行为没变，合同文件清单没跟上。
diff --git a/tests/test_birth_time_journey_contract.py b/tests/test_birth_time_journey_contract.py
index 496c4597..8d49542f 100644
--- a/tests/test_birth_time_journey_contract.py
+++ b/tests/test_birth_time_journey_contract.py
@@ -135,6 +135,7 @@ HOME_SURFACE_FILES = (
     FRONTEND / "src" / "components" / "birth-location-fields.tsx",
     FRONTEND / "src" / "components" / "profile-fields.tsx",
     FRONTEND / "src" / "components" / "onboarding-chat-message.tsx",
+    FRONTEND / "src" / "components" / "home-onboarding-shell.tsx",
     FRONTEND / "src" / "components" / "chart-library-panel.tsx",
     FRONTEND / "src" / "components" / "starter-home.tsx",
 )
@@ -177,6 +178,7 @@ def test_web_onboarding_uses_the_deterministic_free_journey() -> None:
     ).read_text(encoding="utf-8")
     mastra = _mastra_consultation_surface()
 
+    assert "<HomeOnboardingShell" in PAGE.read_text(encoding="utf-8")
     assert "<BirthTimeIntakeFields" in page
     assert "requestBirthTimeAssessment" in page
     assert "<BirthTimeRectification" in page