// Web e2e scenarios: lifecycle & chrome — the workspace-aware first-send // flow over the real wire, reload recovery, and the dark-mode token cascade. // One tiny recorded turn (text-only) drives the whole spec: the empty-state // hero materializes a real Workspace + Session on first send (the jsdom // workspace-flow suite pins the object-layer state machine over the fixture // client; THIS spec pins the same flow through HTTP RPC + SSE + the host // gateway), reload replays everything from the log (zero further model // calls), and the theme scenario proves the shipped dark palette actually // cascades: attribute -> alias token flip -> painted surface change. No // theme/layout golden: aria snapshots are color-blind (lane scope: the // browser-e2e-lane Agent Note); the hero's waiting state gets the one golden // here. import { readFile } from 'node:fs/promises' import { fileURLToPath } from 'node:url' import { join } from 'node:path' import type { Browser, Page } from 'playwright' import { chromium } from 'playwright' import { afterAll, beforeAll, describe, expect, it, onTestFailed } from 'vitest' import type { SessionEvent } from '@deepseek-ai/dsh-session' import { acknowledgeReloadConnectionLoss, assertFixtureInventory, captureStableAria, compareOrRefreshGolden, fixtureUserPrompts, launchWebScaffold, recordFixture, watchConsole, webSnapshotMode, type WebScaffold, } from './scaffold.ts' import { connectFreshWorkspace, newEnglishPage, saveFailureShot } from './support.ts' const SNAPSHOT_DIR = fileURLToPath(new URL('./snapshots/lifecycle-chrome', import.meta.url)) const FIXTURE = join(SNAPSHOT_DIR, 'session.jsonl') const HERO_EXPECTED = join(SNAPSHOT_DIR, 'hero.expected.md') const COMMAND_MENU_EXPECTED = join(SNAPSHOT_DIR, 'command-menu.expected.md') const FUZZY_COMMAND_MENU_EXPECTED = join(SNAPSHOT_DIR, 'command-menu-fuzzy.expected.md') const PLAN_ACTIVE_EXPECTED = join(SNAPSHOT_DIR, 'plan-active.expected.md') // Post-reload golden: the same settled conversation rebuilt purely from // persistence + history — byte-equal rendering is exactly the recovery claim. const RELOADED_EXPECTED = join(SNAPSHOT_DIR, 'reloaded.expected.md') const MODE = webSnapshotMode() const PROMPT = 'Reply with the single word LIGHTHOUSE and stop.' const REPLAY_PACE_MS = 100 describe('web e2e: lifecycle & chrome (workspace flow / reload / dark mode)', () => { let scaffold: WebScaffold let browser: Browser let page: Page let tripwire: ReturnType const sessionEvents: SessionEvent[] = [] beforeAll(async () => { scaffold = await launchWebScaffold(MODE === 'record' ? {} : { replayFixture: FIXTURE, paceMs: REPLAY_PACE_MS }) scaffold.ctx.on('session/event', (_session, event: SessionEvent) => { sessionEvents.push(event) }) browser = await chromium.launch() page = await newEnglishPage(browser) tripwire = watchConsole(page) await page.goto(scaffold.baseUrl, { waitUntil: 'load' }) await page.waitForSelector('[class*="frame"]', { timeout: 30_000 }) // Fresh world: connect a Workspace so the composer scenarios start live. await connectFreshWorkspace(page, scaffold.workspaceCwd) }, 120_000) afterAll(async () => { await browser?.close() await scaffold?.close() }) it.skipIf(MODE === 'record')('opens the shared slash menu from plus with only Command candidates', async () => { onTestFailed(() => saveFailureShot(page, 'web-e2e-command-menu-launcher')) const launcher = page.getByRole('button', { name: 'Commands' }) await launcher.click() const menu = page.getByRole('listbox', { name: 'Trigger suggestions' }) await menu.waitFor({ timeout: 10_000 }) const snapshot = await captureStableAria(page, '[role="listbox"]', scaffold.workspaceCwd) await compareOrRefreshGolden(COMMAND_MENU_EXPECTED, snapshot, MODE) expect(snapshot).toContain('text: Commands') expect(snapshot).not.toContain('text: Skills') expect(snapshot).not.toContain('text: Subagents') const launchedBox = await menu.boundingBox() await page.locator('textarea').first().press('Escape') await expect.poll(() => menu.count()).toBe(0) const input = page.locator('textarea').first() await input.fill('/') await menu.waitFor({ timeout: 10_000 }) const typedBox = await menu.boundingBox() expect(launchedBox).not.toBeNull() expect(typedBox).not.toBeNull() expect(Math.abs(launchedBox!.x - typedBox!.x)).toBeLessThan(1) expect(Math.abs( launchedBox!.y + launchedBox!.height - typedBox!.y - typedBox!.height, )).toBeLessThan(1) await input.fill('/cpt') await expect.poll(() => menu.getByRole('option').allTextContents()).toEqual([ 'compactCompact older conversation history', ]) const fuzzySnapshot = await captureStableAria(page, '[role="listbox"]', scaffold.workspaceCwd) await compareOrRefreshGolden(FUZZY_COMMAND_MENU_EXPECTED, fuzzySnapshot, MODE) await input.fill('') await expect.poll(() => menu.count()).toBe(0) }) it.skipIf(MODE === 'record')('shows active Plan as the warn-state status action', async () => { const activeScaffold = await launchWebScaffold() const activePage = await newEnglishPage(browser) const activeTripwire = watchConsole(activePage) try { await activePage.goto(activeScaffold.baseUrl, { waitUntil: 'load' }) await activePage.waitForSelector('[class*="frame"]', { timeout: 30_000 }) await connectFreshWorkspace(activePage, activeScaffold.workspaceCwd) const input = activePage.locator('textarea').first() await activePage.getByRole('button', { name: 'Commands' }).click() const menu = activePage.getByRole('listbox', { name: 'Trigger suggestions' }) await menu.waitFor({ timeout: 10_000 }) await menu.getByRole('option', { name: 'plan Enter or leave plan mode' }).click() await expect.poll(() => input.inputValue()).toBe('/plan ') await input.press('Enter') const planButton = activePage.getByRole('button', { name: 'Plan mode on, press to turn off' }) await planButton.waitFor({ timeout: 10_000 }) // The golden encodes an empty composer, and the button arriving does not // mean the submitted text is gone yet: under load the capture can catch // a textbox still holding `/plan`. await expect.poll(() => input.inputValue(), { timeout: 10_000 }).toBe('') const planSnapshot = await captureStableAria(activePage, '[class*="frame"]', activeScaffold.workspaceCwd) await compareOrRefreshGolden(PLAN_ACTIVE_EXPECTED, planSnapshot, MODE) const planStyle = await planButton.evaluate((element) => { const probe = document.createElement('span') probe.style.color = 'var(--dsw-alias-state-warn-label)' probe.style.backgroundColor = 'var(--dsw-alias-state-warn-tertiary)' document.body.append(probe) const actual = getComputedStyle(element) const reference = getComputedStyle(probe) const result = { color: actual.color, backgroundColor: actual.backgroundColor, borderRadius: actual.borderRadius, fontSize: actual.fontSize, referenceColor: reference.color, referenceBackgroundColor: reference.backgroundColor, } probe.remove() return result }) expect(planStyle.color).toBe(planStyle.referenceColor) expect(planStyle.backgroundColor).toBe(planStyle.referenceBackgroundColor) expect(planStyle.borderRadius).toBe('999px') expect(planStyle.fontSize).toBe('13px') await planButton.click() await expect.poll(() => planButton.count()).toBe(0) expect(activeTripwire.pageErrors).toEqual([]) expect(activeTripwire.warnings).toEqual([]) } catch (error) { await saveFailureShot(activePage, 'web-e2e-plan-active').catch(() => undefined) throw error } finally { await activePage.close() await activeScaffold.close() } }) it('sends the first prompt from the empty-state hero (all modes)', async () => { onTestFailed(() => saveFailureShot(page, 'web-e2e-lifecycle-send')) if (MODE !== 'record') { expect(fixtureUserPrompts(await readFile(FIXTURE, 'utf8'))).toEqual([PROMPT]) } // The blank frame renders the hero, not the resident composer: the // headline plus the guidance placeholder are the empty state's anchors. await expect.poll(() => page.getByText('Into the Unknown', { exact: false }).count(), { timeout: 15_000 }).toBe(1) const input = page.locator('textarea').first() await input.waitFor({ timeout: 10_000 }) if (MODE !== 'record') { // Golden of the hero's stable waiting state (captured before any send; // the conversation-region goldens belong to the other scenarios). const snapshot = await captureStableAria(page, '[class*="frame"]', scaffold.workspaceCwd) await compareOrRefreshGolden(HERO_EXPECTED, snapshot, MODE) } const settled = scaffold.whenTurnSettled() await input.fill(PROMPT) const observeTurn = async () => { const originalViewport = page.viewportSize() ?? { width: 1680, height: 1000 } if (MODE !== 'record') await page.setViewportSize({ width: 480, height: 1000 }) try { await input.press('Enter') if (MODE !== 'record') { const liveTail = page.locator('[data-variant="think"][data-state="running"] [data-follow-end]') await expect.poll(async () => await liveTail.evaluate(element => ( element.scrollWidth > element.clientWidth && element.scrollLeft >= element.scrollWidth - element.clientWidth - 1 )), { timeout: 10_000, interval: 10 }).toBe(true) } return await settled } finally { if (MODE !== 'record') await page.setViewportSize(originalViewport) } } const sessionId = await observeTurn() if (MODE === 'record') { await recordFixture(scaffold, sessionId, FIXTURE) } }, 200_000) it.skipIf(MODE === 'record')('materialized a real Workspace and Session over the wire', async () => { onTestFailed(() => saveFailureShot(page, 'web-e2e-lifecycle-materialize')) // Browser: the sidebar tree now carries the auto-created workspace group // with its one session, and the opened session is the selected row. The // compact layout dropped group session counts, so the group row itself is // the barrier. await expect.poll( () => page.locator('[role="treeitem"][aria-expanded]').filter({ hasText: 'workspace' }).count(), { timeout: 15_000 }, ).toBeGreaterThanOrEqual(1) await expect.poll(() => page.locator('[role="treeitem"][aria-selected="true"]').count(), { timeout: 10_000 }).toBe(1) await expect.poll(() => page.getByText('LIGHTHOUSE', { exact: true }).count(), { timeout: 15_000 }).toBeGreaterThanOrEqual(1) // Host: the session's durable header cwd is the folder the workspace // flow created and adopted (/workspace) — the proof the // send went through workspace materialization rather than a bare // default-cwd session. const cwds = scaffold.ctx.sessions.list().map(session => session.header.cwd) expect(cwds).toEqual([join(scaffold.workspaceCwd, 'workspace')]) const turnEnds = sessionEvents.filter(e => e.type === 'turn/end') expect(turnEnds).toHaveLength(1) expect((turnEnds[0] as SessionEvent & { data: { reason: { kind: string } } }).data.reason.kind).toBe('completed') }, 60_000) it.skipIf(MODE === 'record')('recovers the whole surface across a reload from the log alone', async () => { onTestFailed(() => saveFailureShot(page, 'web-e2e-lifecycle-reload')) const warningStart = tripwire.warnings.length await page.reload({ waitUntil: 'load' }) await page.waitForSelector('[class*="frame"]', { timeout: 30_000 }) acknowledgeReloadConnectionLoss(tripwire, warningStart) // Selection persisted (dsh.sessions.current) and history replayed: the // recorded turn re-renders from session.history with zero model calls — // the replay cursor was fully consumed before the reload, so any stray // request would fail the scenario loudly at close(). await expect.poll(() => page.getByText('LIGHTHOUSE', { exact: true }).count(), { timeout: 15_000 }).toBeGreaterThanOrEqual(1) await expect.poll(() => page.locator('[role="treeitem"][aria-selected="true"]').count(), { timeout: 10_000 }).toBe(1) // Golden of the recovered conversation region: rebuilt from the log, it // must render the same settled transcript the live turn produced. const snapshot = await captureStableAria(page, '[class*="centerCol"]', scaffold.workspaceCwd) await compareOrRefreshGolden(RELOADED_EXPECTED, snapshot, MODE) expect(tripwire.pageErrors).toEqual([]) }, 90_000) it.skipIf(MODE === 'record')('cascades the dark theme from the body attribute to painted surfaces', async () => { onTestFailed(() => saveFailureShot(page, 'web-e2e-lifecycle-dark')) // This scenario pins the ThemeRuntime's DOM contract directly (the // body[data-ds-dark-theme] attribute -> stylesheet cascade); the REAL // user gesture above it (Settings -> Appearance cubes) is owned by // settings-chrome.e2e.ts. Driving the attribute here keeps the cascade // pinned independently of the settings surface's own lifecycle. const sample = async (): Promise<{ token: string; sidebarBg: string; bodyBg: string }> => await page.evaluate(() => { const sidebar = document.querySelector('[class*="sidebar"], [class*="rail"]') ?? document.body return { token: getComputedStyle(document.body).getPropertyValue('--dsw-alias-bg-base').trim(), sidebarBg: getComputedStyle(sidebar).backgroundColor, bodyBg: getComputedStyle(document.body).backgroundColor, } }) const light = await sample() await page.evaluate(() => { document.body.setAttribute('data-ds-dark-theme', '') }) const dark = await sample() // The alias token itself must flip — the cascade's root fact. expect(dark.token).not.toBe(light.token) // And a real painted surface must consume it (not just variables in a // void): at least one of the sampled backgrounds repaints. expect(dark.sidebarBg !== light.sidebarBg || dark.bodyBg !== light.bodyBg).toBe(true) // Removing the attribute restores the light values exactly (the palettes // live in one stylesheet; activation is attribute-only by design). await page.evaluate(() => { document.body.removeAttribute('data-ds-dark-theme') }) const restored = await sample() expect(restored).toEqual(light) expect(tripwire.pageErrors).toEqual([]) }, 60_000) it.skipIf(MODE === 'record')('keeps the fixture inventory closed', async () => { expect(tripwire.warnings).toEqual([]) await assertFixtureInventory(SNAPSHOT_DIR, [ 'session.jsonl', 'command-menu.expected.md', 'command-menu-fuzzy.expected.md', 'hero.expected.md', 'plan-active.expected.md', 'reloaded.expected.md', ]) }) })