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("));
});