import assert from "node:assert/strict"; import { readFileSync } from "node:fs"; import test from "node:test"; import { BOOTSTRAP_PREPARE_TIMEOUT_MS, HOME_BOOTSTRAP_SLOW_MS, SESSION_PREFETCH_COUNT, bootstrapLoadingCopy, bootstrapPrepareSettled, bootstrapRevealDelayMs, landingYieldsToRecovery, resolveStarterHomeLandingSessionId, sessionIdsToPrefetch, shouldAutoOpenRectificationSession, starterHomeLandingNeedsConsultation, } from "../src/lib/home-bootstrap.ts"; import { homeSurface } from "./home-surface.ts"; // Product rule (2026-09-02): the loading screen owns every wait. After the home // page is revealed there is no component-level spinner left — only the streaming // answer keeps a live marker, because that is content being generated, not data // being loaded. const page = readFileSync(new URL("../src/app/(app)/page.tsx", import.meta.url), "utf8"); const bootstrapRun = readFileSync(new URL("../src/lib/home-bootstrap-run.ts", import.meta.url), "utf8"); const bootstrapError = readFileSync(new URL("../src/components/home-bootstrap-error.tsx", import.meta.url), "utf8"); const starterHome = readFileSync(new URL("../src/components/starter-home.tsx", import.meta.url), "utf8"); const globalsCss = readFileSync(new URL("../src/app/globals.css", import.meta.url), "utf8"); const staleClientRecovery = readFileSync(new URL("../src/components/stale-client-recovery.tsx", import.meta.url), "utf8"); const rectificationId = "11111111-1111-4111-8111-111111111111"; const consultationId = "22222222-2222-4222-8222-222222222222"; const emptyConsultationId = "33333333-3333-4333-8333-333333333333"; test("bare / after login does not auto-open the latest rectification session", () => { assert.equal(shouldAutoOpenRectificationSession({ sessionType: "birth_time_rectification", sessionId: rectificationId, search: "", }), false); assert.equal(shouldAutoOpenRectificationSession({ sessionType: "birth_time_rectification", sessionId: rectificationId, search: `?c=${rectificationId}`, }), true); assert.equal(shouldAutoOpenRectificationSession({ sessionType: "birth_time_rectification", sessionId: rectificationId, search: `?c=${consultationId}`, }), false); assert.equal(shouldAutoOpenRectificationSession({ sessionType: "consultation", sessionId: consultationId, search: `?c=${consultationId}`, }), false); }); test("default landing replaces a latest rectification session with an empty consultation", () => { const sessions = [ { id: rectificationId, sessionType: "birth_time_rectification", messages: [] }, { id: emptyConsultationId, sessionType: "consultation", messages: [] }, { id: consultationId, sessionType: "consultation", messages: [{ role: "user" }] }, ]; assert.equal(resolveStarterHomeLandingSessionId(sessions, rectificationId, "none"), emptyConsultationId); assert.equal(resolveStarterHomeLandingSessionId(sessions, rectificationId, "replace-clear"), emptyConsultationId); assert.equal(resolveStarterHomeLandingSessionId(sessions, rectificationId, "keep"), rectificationId); // 原值: resolveStarterHomeLandingSessionId(sessions, rectificationId, "replace-selected") === rectificationId。 // 新值: 该 urlAction 已删除,改为断言 lookup(`?c=` 查到后)同样保留所选会话。 // 原因: BUG-1052 D3 删除登录返回存根,replace-selected 只服务存根。 assert.equal(resolveStarterHomeLandingSessionId(sessions, rectificationId, "lookup"), rectificationId); // 原值: resolveStarterHomeLandingSessionId(sessions, consultationId, "none") === consultationId(裸 `/` 打开最近普通对话)。 // 新值: === emptyConsultationId(裸 `/` 落空白首页,复用已有空草稿)。 // 原因: BUG-1052 D1 产品决策——裸 `/` 永远是空白首页,不落旧对话。 assert.equal(resolveStarterHomeLandingSessionId(sessions, consultationId, "none"), emptyConsultationId); assert.equal( starterHomeLandingNeedsConsultation( [{ id: rectificationId, sessionType: "birth_time_rectification", messages: [] }], rectificationId, "none", ), true, ); assert.equal( starterHomeLandingNeedsConsultation(sessions, emptyConsultationId, "none"), false, ); assert.equal( starterHomeLandingNeedsConsultation(sessions, rectificationId, "keep"), false, ); // 原值: page.tsx 直接调用 resolveStarterHomeLandingSessionId / starterHomeLandingNeedsConsultation。 // 新值: 这两个调用在 home-bootstrap-run.ts;page.tsx 仍调用 shouldAutoOpenRectificationSession。 // 原因: 启动落点搬进 runHomeBootstrap,揭幕阶段的校正会话判断留在首页。 assert.match(bootstrapRun, /resolveStarterHomeLandingSessionId\(/); assert.match(page, /shouldAutoOpenRectificationSession\(/); assert.match(bootstrapRun, /starterHomeLandingNeedsConsultation\(/); }); test("new chat landing requests a fresh consultation even with an existing ordinary chat", () => { const sessions = [ { id: consultationId, sessionType: "consultation", messages: [{ role: "user" }] }, { id: emptyConsultationId, sessionType: "consultation", messages: [] }, { id: rectificationId, sessionType: "birth_time_rectification", messages: [] }, ]; for (const session of sessions) { assert.equal(resolveStarterHomeLandingSessionId(sessions, session.id, "new-chat"), session.id); assert.equal(starterHomeLandingNeedsConsultation(sessions, session.id, "new-chat"), true); } assert.equal(starterHomeLandingNeedsConsultation([], consultationId, "new-chat"), true); }); test("bare home with a latest ordinary chat lands on a new blank starter home (BUG-1052)", () => { // 原值: 标题 "bare home still opens the selected ordinary chat without creating another"; // none → consultationId,NeedsConsultation === false。 // 新值: none → 仍返回 consultationId(没有空草稿可复用),但 NeedsConsultation === true,启动会本地新建空对话落地。 // 原因: BUG-1052 D1——登录后 / 地址栏 / 书签 / 刷新裸 `/` 都落空白首页,不再打开最近一条旧对话。 const sessions = [{ id: consultationId, sessionType: "consultation", messages: [{ role: "user" }] }]; assert.equal(resolveStarterHomeLandingSessionId(sessions, consultationId, "none"), consultationId); assert.equal(starterHomeLandingNeedsConsultation(sessions, consultationId, "none"), true); }); test("a list row whose messages were not loaded is not mistaken for the blank home", () => { // The session list can omit messages (messagesHydrated false). Such a row is // a saved conversation, not an empty draft, so bare `/` must not land on it. const sessions = [ { id: consultationId, sessionType: "consultation", messages: [], messagesHydrated: false }, { id: rectificationId, sessionType: "birth_time_rectification", messages: [] }, ]; assert.equal(resolveStarterHomeLandingSessionId(sessions, consultationId, "none"), consultationId); assert.equal(starterHomeLandingNeedsConsultation(sessions, consultationId, "none"), true); assert.equal(resolveStarterHomeLandingSessionId(sessions, rectificationId, "none"), rectificationId); assert.equal(starterHomeLandingNeedsConsultation(sessions, rectificationId, "none"), true); // An archived empty row is not a draft either. const archived = [{ id: emptyConsultationId, sessionType: "consultation", messages: [], archivedAt: "2026-09-01T00:00:00Z" }]; assert.equal(starterHomeLandingNeedsConsultation(archived, emptyConsultationId, "none"), true); // A dead `?c=` (replace-clear) lands on the blank home too. assert.equal(starterHomeLandingNeedsConsultation(sessions, consultationId, "replace-clear"), true); }); test("a background answer takes the screen only when the address bar named a conversation", () => { assert.equal(landingYieldsToRecovery("keep"), true); assert.equal(landingYieldsToRecovery("lookup"), true); assert.equal(landingYieldsToRecovery("none"), false); assert.equal(landingYieldsToRecovery("replace-clear"), false); assert.equal(landingYieldsToRecovery("new-chat"), false); }); test("prepare phase settles only when every applicable item has an answer", () => { // 原值: BootstrapPrepareState 含 profileComplete + onboardingSettled,未完成建议问题不得揭幕。 // 新值: 揭幕只等入口摘要、今日星语(若适用)与校正会话(若适用)。 // 原因: 主题卡与 /api/onboarding 已下线,建议问题不再挡首页。 const base = { dailyStarlanguageApplicable: true, dailyStarlanguageSettled: true, entrySummarySettled: true, }; assert.equal(bootstrapPrepareSettled(base), true); assert.equal(bootstrapPrepareSettled({ ...base, entrySummarySettled: false }), false); assert.equal(bootstrapPrepareSettled({ ...base, dailyStarlanguageSettled: false }), false); assert.equal(bootstrapPrepareSettled({ ...base, dailyStarlanguageApplicable: false, dailyStarlanguageSettled: false }), true); }); test("home bootstrap keeps one slow-network budget before the fatal screen", () => { // 原值: 首页账户阶段使用 8000ms 内联总超时。 // 新值: 账户、模型与状态等待共享 20000ms,超时后只显示错误屏。 // 原因: 慢网串行链需要一次等待一次揭幕,不能半揭幕或提前放弃。 assert.equal(HOME_BOOTSTRAP_SLOW_MS, 20_000); // 原值: page.tsx 引用 HOME_BOOTSTRAP_SLOW_MS。 // 新值: 20 秒预算在 runHomeBootstrap 里。 // 原因: 超时属于启动流程,首页只调用这个函数。 assert.match(bootstrapRun, /HOME_BOOTSTRAP_SLOW_MS/); assert.doesNotMatch(page, /\}, 8000\);/); assert.doesNotMatch(bootstrapRun, /\}, 8000\);/); }); test("reveal delay is zero once settled and counts down from the phase start otherwise", () => { assert.equal(BOOTSTRAP_PREPARE_TIMEOUT_MS, 4000); assert.equal(bootstrapRevealDelayMs(10_000, 9_000, true), 0); assert.equal(bootstrapRevealDelayMs(10_000, 9_000, false), 3000); assert.equal(bootstrapRevealDelayMs(20_000, 9_000, false), 0); assert.equal(bootstrapRevealDelayMs(10_000, null, false), BOOTSTRAP_PREPARE_TIMEOUT_MS); }); test("loading copy changes per phase so the single loading screen narrates progress", () => { const account = bootstrapLoadingCopy("account"); const prepare = bootstrapLoadingCopy("prepare"); assert.notEqual(account.title, prepare.title); assert.notEqual(account.detail, prepare.detail); assert.match(page, /const loadingCopy = bootstrapLoadingCopy\(bootstrapPhase\);/); assert.match(page, //); }); test("bootstrap enters the prepare phase instead of revealing after the account fetch", () => { // 原值: `if (bootstrapFailed) setHydrated(true); else setBootstrapPhase("prepare");` 写在 page.tsx。 // 新值: 同一分支写在 runHomeBootstrap,setter 经 deps.commit 注入。 // 原因: 失败仍揭幕错误屏,成功仍进入 prepare,不半揭幕。 assert.match(bootstrapRun, /if \(bootstrapFailed\) deps\.commit\.setHydrated\(true\);\n\s*else deps\.commit\.setBootstrapPhase\("prepare"\);/); // 原值: 3 个 prepare 守卫(onboarding / 今日星语 / 入口摘要)。 // 新值: 2 个(今日星语 / 入口摘要)。 // 原因: 建议问题请求已删除。 const binder = readFileSync(new URL("../src/components/daily-starlanguage-binder.tsx", import.meta.url), "utf8"); const guards = `${page}\n${binder}`.match(/if \(bootstrapPhase === "account" \|\| !accountId/g) ?? []; assert.equal(guards.length, 2, "daily starlanguage and entry summary must both key off bootstrapPhase"); assert.match(page, /setRectificationEntrySummarySettled\(true\);/); assert.match(page, /bootstrapRevealDelayMs\(Date\.now\(\), prepareStartedAt\.current, bootstrapPrepareReady\)/); assert.match(page, /window\.setTimeout\(\(\) => setHydrated\(true\), delay\)/); assert.match(page, /void import\("@\/components\/birth-time-rectification"\);/); }); test("revealed home carries no component loading state", () => { assert.doesNotMatch(page, /starter-loading/); assert.doesNotMatch(starterHome, /starter-loading|dailyStarlanguageBusy|aria-busy=\{/); assert.doesNotMatch(globalsCss, /\.starter-loading/); assert.doesNotMatch(page, /InlineSpinner/); assert.doesNotMatch(page, /dailyStarlanguageBusy|正在写下今天的星语/); // Switching to a session whose messages are not cached keeps a silent placeholder. assert.match(page, /className="message-list session-messages-loading" role="status" aria-busy="true" aria-live="polite">\n\s*正在加载聊天记录<\/span>/); }); test("recent sessions are prefetched after reveal so switches do not wait", () => { assert.equal(SESSION_PREFETCH_COUNT, 5); const sessions = [ { id: "active", sessionType: "consultation" }, { id: "a", sessionType: "consultation" }, { id: "b", sessionType: "consultation", messagesHydrated: true }, { id: "r", sessionType: "birth_time_rectification" }, { id: "c", sessionType: "consultation" }, { id: "d", sessionType: "consultation" }, { id: "e", sessionType: "consultation" }, { id: "f", sessionType: "consultation" }, { id: "g", sessionType: "consultation" }, ]; assert.deepEqual(sessionIdsToPrefetch(sessions, "active"), ["a", "c", "d", "e", "f"]); assert.match(page, /sessionIdsToPrefetch\(sessionsRef\.current, activeSessionIdRef\.current\)/); assert.match(page, /await ensureSessionMessages\(sessionId\);/); }); test("the loading screen DOM contract stale-client recovery depends on is untouched", () => { assert.match(page, /
/); // 原值: 错误屏 main 写在 page.tsx。 // 新值: 同一段 main 在 home-bootstrap-error.tsx。 // 原因: 错误屏抽成组件,class 与 role 不变,僵死恢复脚本仍能找到它。 assert.match(bootstrapError, /
/); assert.match(staleClientRecovery, /main\.app-loading\[aria-busy="true"\]/); assert.match(staleClientRecovery, /main\.app-loading-error/); assert.ok(homeSurface.includes("bootstrapPrepareSettled(")); });