mirror of
https://github.com/stablyai/orca.git
synced 2026-11-19 04:23:57 +00:00
* [comment audit] Align legacy failure-read counts with cached display * [comment audit] Condense shared provider lifecycle and browser recovery comments [skip ci] * [comment audit] Condense shared generation, path and preview comments [skip ci] * [comment audit] Condense host, file and Git contract rationale [skip ci] * [comment audit] Tighten Git lifecycle and provider contract comments [skip ci] * [comment audit] Clarify shared host authority and launch isolation [skip ci] * [comment audit] simplify local access mobile and native chat contracts [skip ci] * [comment audit] simplify native chat presentation and state contracts [skip ci] * [comment audit] simplify native runtime and provider contracts [skip ci] * [comment audit] simplify migration and orchestration contracts [skip ci] * [comment audit] simplify plugin trust and process capture rationale [skip ci] * [comment audit] simplify terminal delivery and remote compatibility rationale [skip ci] * [comment audit] clarify remote recovery and launch wire rationale [skip ci] * [comment audit] shorten shared RPC compatibility and runtime evidence comments [skip ci] * [comment audit] simplify secure storage shell startup and sidebar rationale [skip ci] * [comment audit] clarify sidebar, skill and SSH invariants [skip ci] * [comment audit] condense structured chat delivery and timing rationale [skip ci] * [comment audit] condense terminal replay and telemetry invariants [skip ci] * [comment audit] clarify launch permission and terminal delivery rationale [skip ci] * [comment audit] clarify workspace ownership and layout contracts [skip ci] * [comment audit] wait for fitted and painted SSH terminal links * [comment audit] clarify layout persistence and session ownership [skip ci] * [comment audit] clarify host routing and workspace lifecycle contracts [skip ci] * [comment audit] clarify startup persistence and app lifetime comments [skip ci] * [comment audit] clarify recovery and activity boundaries [skip ci] * [comment audit] condense activity and artifact invariants [skip ci] * [comment audit] condense automation authority contracts [skip ci] * [comment audit] simplify automation scheduling and history contracts [skip ci] * [comment audit] clarify browser chrome and annotation lifecycles [skip ci] * [comment audit] clarify browser routing and retained guest ownership [skip ci] * [comment audit] clarify browser recovery and document ownership comments [skip ci] * [comment audit] restore hosted runners required by native IME fixtures * [comment audit] shorten preview, palette and dashboard invariants [skip ci] * [comment audit] clarify terminal preview, dashboard and retention comments [skip ci] * [comment audit] clarify diff-note recovery and editor lifecycle comments [skip ci] * [comment audit] shorten rich-text and combined-diff ownership comments [skip ci] * [comment audit] shorten autosave, draft recovery and model ownership comments [skip ci] * [comment audit] shorten save-queue, notebook and Markdown constraints [skip ci] * [comment audit] shorten Monaco, PDF and rich Markdown safeguards [skip ci] * [comment audit] clarify rich Markdown source and selection safeguards [skip ci] * [comment audit] clarify editor loading and emulator stream lifetimes [skip ci] * [comment audit] trim emulator and feature tour narration [skip ci] * [comment audit] clarify floating workspace and GitHub cache ownership [skip ci] * [comment audit] trim provider controls and Linear filter explanations [skip ci] * [comment audit] clarify pairing and chat resume lifetimes [skip ci] * [comment audit] clarify chat delivery and transcript lifetimes [skip ci] * [comment audit] clarify session options and host-owned status [skip ci] * [comment audit] clarify draft durability and live-status precedence [skip ci] * [comment audit] Trim chat send and model ownership explanations [skip ci] * [comment audit] Shorten transcript ownership and send recovery comments [skip ci] * [comment audit] Simplify native chat composer and transcript hook comments [skip ci] * [comment audit] Shorten native chat scroll and structured session explanations [skip ci] * [comment audit] Trim workspace picker and onboarding commentary [skip ci] * [comment audit] Simplify pet rendering, review cache and quick open comments [skip ci] * [comment audit] Trim sidebar and session history explanations [skip ci] * [comment audit] Condense session resume and review checks comments [skip ci] * [comment audit] Shorten checks state and file explorer refresh comments [skip ci] * [comment audit] Trim plugin bridge and source-control action rationale [skip ci] * [comment audit] Trim source-control listing and review rationale [skip ci] * [comment audit] Shorten sidebar lifecycle and explorer safeguards [skip ci] * [comment audit] Condense Settings account and appearance rationale [skip ci] * [comment audit] Trim pairing and repository Settings explanations [skip ci] * [comment audit] Condense Settings search SSH and terminal safeguards [skip ci] * [comment audit] Shorten Settings voice and provider ownership comments [skip ci] * [comment audit] Condense Settings draft persistence and host-state rationale [skip ci] * [comment audit] Trim Settings hooks and sidebar setup rationale [skip ci] * [comment audit] Condense sidebar deletion and board-filter safeguards [skip ci] * [comment audit] Condense worktree cards, host ownership and Markdown contracts [skip ci] * [comment audit] Condense sidebar drag, folder and filtering contracts [skip ci] * [comment audit] Condense sidebar parity, sleep and host ownership contracts [skip ci] * [comment audit] Prune focus-read baseline after comment cleanup * [comment audit] Clarify sidebar visibility, board drops and agent evidence [skip ci] * [comment audit] Tighten sidebar listing, drag and reveal contracts [skip ci] * [comment audit] Clarify viewport geometry and skill update safeguards [skip ci] * [comment audit] Tighten skill inventory, usage and host status comments [skip ci] * [comment audit] Clarify usage ownership and resource kill safeguards [skip ci] * [comment audit] Tighten tab selection, rename and search contracts [skip ci] * [comment audit] Tighten tab-strip geometry and drag ownership comments [skip ci] * [comment audit] Tighten Tasks recovery, pagination and mutation comments [skip ci] * [comment audit] Tighten provider loading and terminal recovery comments [skip ci] * [comment audit] Tighten completion, cadence and PTY ownership comments [skip ci] * [comment audit] Clarify terminal restore and parked-pane boundaries [skip ci] * [comment audit] Tighten PTY startup and replay explanations [skip ci] * [comment audit] Clarify PTY identity and delivery ownership [skip ci] * [comment audit] Shorten remote reconnect and input replay rationale [skip ci] * [comment audit] Condense terminal parking clipboard and file link comments [skip ci] * [comment audit] Clarify IME ownership and trim trace history [skip ci] * [comment audit] Shorten pane recovery and parked watcher explanations [skip ci] * [comment audit] Condense snapshot replay and visibility recovery rationale [skip ci] * [comment audit] Shorten terminal parking and keyboard ownership rationale [skip ci] * [comment audit] Trim renderer lifecycle and menu rationale [skip ci] * [comment audit] Condense workspace cleanup ownership and settlement notes [skip ci] * [comment audit] Clarify renderer hook evidence and source ownership [skip ci] * [comment audit] Tighten IPC ownership and reconnect explanations [skip ci] * [comment audit] Trim renderer focus, paste and attention comments [skip ci] * [comment audit] Shorten scroll, locale and agent lifecycle comments [skip ci] * [comment audit] Trim agent launch, resume and ownership commentary [skip ci] * [comment audit] Shorten account, browser and editor comments [skip ci] * [comment audit] Clarify host-mirror waits, previews and input ownership [skip ci] * [comment audit] Condense launch recovery and editor tokenization comments [skip ci] * [comment audit] Condense workspace selection and terminal pane rationale [skip ci] * [comment audit] Condense terminal fitting and rendering recovery comments [skip ci] * [comment audit] Condense terminal input and host routing explanations [skip ci] * [comment audit] Condense ownership and sleeping-session recovery rationale [skip ci] * [comment audit] Condense structured launch and terminal link explanations [skip ci] * [comment audit] Condense terminal ownership and workspace file routing rationale [skip ci] * [comment audit] Condense session persistence and workspace activation rationale [skip ci] * [comment audit] Condense workspace routing and browser ownership rationale [skip ci] * [comment audit] Condense mirror recovery and layout authority rationale [skip ci] * [comment audit] Condense runtime transport and file safety rationale [skip ci] * [comment audit] Condense runtime graph and structured session rationale [skip ci] * [comment audit] Condense browser creation and remote tab recovery rationale [skip ci] * [comment audit] Condense snapshot authority and publisher recovery rationale [skip ci] * [comment audit] Condense frame, startup and provider cache rationale [skip ci] * [comment audit] Condense host twin and agent lifecycle rationale [skip ci] * [comment audit] Condense browser authority and editor cleanup rationale [skip ci] * [comment audit] Condense editor buffer identity and review cache rationale [skip ci] * [comment audit] Condense provider lifetime and repository ownership rationale [skip ci] * [comment audit] Condense reconnect, hydration and terminal retirement rationale [skip ci] * [comment audit] Condense recovery, reconciliation and persistence rationale [skip ci] * [comment audit] Condense cleanup ownership and listing admission rationale [skip ci] * [comment audit] Condense teardown ordering and terminal ownership rationale [skip ci] * [comment audit] Condense recovery ledger and web host-boundary rationale [skip ci] * [comment audit] Condense web reconnect and credential lifecycle rationale [skip ci] * [comment audit] Condense cloud rollout and assignment safety rationale [skip ci] * [comment audit] Condense relay session and database recovery rationale [skip ci] * [comment audit] Condense relay placement and protocol compatibility rationale [skip ci] * [comment audit] Condense build and packaging constraints [skip ci] * [comment audit] Condense CI gates and validation isolation rationale [skip ci] * [comment audit] Condense catalog identity and browser validation rationale [skip ci] * [comment audit] Condense mobile browser and frame-budget rationale [skip ci] * [comment audit] Shorten mobile route and browser test explanations [skip ci] * [comment audit] Condense editor and session seam test rationale [skip ci] * [comment audit] Trim session and terminal closure history [skip ci] * [comment audit] Shorten terminal browser and census explanations [skip ci] * [comment audit] Preserve root-only E2E diagnostic baseline * [comment audit] Condense mobile seam and HTML preview test rationale [skip ci] * [comment audit] Condense preview instrumentation and render harness rationale [skip ci] * [comment audit] Condense bundle contracts and native-build constraints [skip ci] * [comment audit] Shorten native packaging and CI routing rationale [skip ci] * [comment audit] Condense release tooling and benchmark constraints [skip ci] * [comment audit] Condense packaging and platform gate rationale [skip ci] * [comment audit] Shorten mobile route and history rationale [skip ci] * [comment audit] Condense mobile browser and component rationale [skip ci] * [comment audit] Shorten drawer and workspace-form rationale [skip ci] * [comment audit] Trim mobile review and editor-document explanations [skip ci] * [comment audit] Condense editor lifecycle and Markdown explanations [skip ci] * [comment audit] Trim mobile file, diagnostics and dictation commentary [skip ci] * [comment audit] Simplify mobile host-list and workspace-view explanations [skip ci] * [comment audit] Clarify mobile shell lifetime and bridge delivery constraints [skip ci] * [comment audit] Condense bridge stream, native request and audio rationale [skip ci] * [comment audit] Reduce bridge schema and page-client commentary [skip ci] * [comment audit] Tighten mobile page bridge contracts [skip ci] * [comment audit] Clarify mobile cache and session constraints [skip ci] * [comment audit] Condense mobile route and lifecycle rationale [skip ci] * [comment audit] Tighten mobile shell hook timing rationale [skip ci] * [comment audit] Clarify route handoff and notification compatibility [skip ci] * [comment audit] Clarify push registration and dictation cleanup constraints [skip ci] * [comment audit] Condense keyboard geometry and native media ownership rationale [skip ci] * [comment audit] Tighten mobile chat scroll and composer concurrency rationale [skip ci] * [comment audit] Condense mobile reply compatibility and upload ownership rationale [skip ci] * [comment audit] Condense optimistic echo and scroll ownership rationale [skip ci] * [comment audit] Tighten stream replay and queued session ownership rationale [skip ci] * [comment audit] Condense mobile composer and reply-schema constraints [skip ci] * [comment audit] Clarify mobile transcript recovery and session ownership [skip ci] * [comment audit] Clarify mobile queue and source-control compatibility [skip ci] * [comment audit] Condense storage and task launch constraints [skip ci] * [comment audit] Clarify task schemas and terminal document ownership [skip ci] * [comment audit] Tighten terminal input and viewport rationale [skip ci] * [comment audit] Shorten terminal and RPC recorder contracts [skip ci] * [comment audit] Condense recorder engine and connection contracts [skip ci] * [comment audit] Shorten host credential and relay recovery comments [skip ci] * [comment audit] Tighten pairing recovery and bundle transport rationale [skip ci] * [comment audit] Clarify RPC delivery and workspace catalog boundaries [skip ci] * [comment audit] Condense catalog and relay entry contracts [skip ci] * [comment audit] Shorten shutdown and SSH relay delivery contracts [skip ci] * [comment audit] Condense WSL relay and E2E regression rationale [skip ci] * [comment audit] Shorten cross-version harness and renderer fixture explanations [skip ci] * [comment audit] Condense paired-host and E2E lifecycle rationale [skip ci] * [comment audit] Shorten layout oracle and regression explanations [skip ci] * [comment audit] Condense paired recovery and ownership regression contracts [skip ci] * [comment audit] Shorten restart, sidebar and SSH lifecycle contracts [skip ci] * [comment audit] Condense terminal rendering and IME regression rationale [skip ci] * [comment audit] Shorten terminal recovery and benchmark contracts [skip ci] * [comment audit] Condense tooling and Windows lifecycle proof rationale [skip ci] * [comment audit] Condense workflow routing and release rationale [skip ci] * [comment audit] Condense mobile security and installer contracts [skip ci] * [comment audit] Shorten native rationale and stylesheet workarounds [skip ci] * [comment audit] Shorten Windows visibility probe rationale [skip ci] * [comment audit] Condense embedded release and signing rationale [skip ci] * [comment audit] Retain current main test behavior in final reconciliation [skip ci] * [comment audit] Complete final comment review across current source inventory * [comment audit] Handle consolidated audit reports before final CI * [comment audit] Preserve credential storage census detail [skip ci] * [comment audit] Scale broad changed E2E selections with verified timing shards * [comment audit] Align E2E assertions with browser close and settled session metadata * [comment audit] Match existing E2Es to current resource and windowing contracts * [comment audit] Observe the shared server outage notice in reconnect coverage * [comment audit] Make existing renderer probes measure settled tab and PTY work * [comment audit] Align palette E2E selector with task search * [comment audit] Refresh remaining palette search selectors * [comment audit] Keep selector correction within selected audit specs * [comment audit] Await emoji fixture settings inside renderer evaluation * [comment audit] Cancel fixture fit retries between terminal tests --------- Co-authored-by: OrcaWin <293788423+OrcaWin@users.noreply.github.com>
425 lines
15 KiB
TypeScript
425 lines
15 KiB
TypeScript
import { rmSync } from 'node:fs'
|
||
import { createServer } from 'node:http'
|
||
import type { AddressInfo } from 'node:net'
|
||
import type { ElectronApplication, Page, TestInfo } from '@stablyai/playwright-test'
|
||
import {
|
||
launchHeadlessPairedRuntimeHost,
|
||
type HeadlessPairedRuntimeHost
|
||
} from './helpers/headless-paired-runtime-host'
|
||
import { forceQuitElectronAppForE2E } from './helpers/electron-process-shutdown'
|
||
import { focusMaterializedRemoteBrowserPane } from './helpers/materialized-remote-browser-pane'
|
||
import { expect, test } from './helpers/orca-app'
|
||
import {
|
||
launchPairedElectronClient,
|
||
type PairedElectronClient
|
||
} from './helpers/paired-electron-client'
|
||
|
||
// SIGKILL a server-screencast client, reopen its device identity, and require decoded live frames with one subscriber.
|
||
// Guest innerWidth fingerprints viewport ownership; after clean replacement quit it must return to the unwatched width.
|
||
// Loopback often reaps the dead socket immediately, so record orphan timing but assert subtraction independently.
|
||
|
||
const ROUTE_COLORS = {
|
||
'/server': { name: 'teal', rgb: [0, 128, 128] },
|
||
'/next': { name: 'crimson', rgb: [220, 20, 60] }
|
||
} as const
|
||
|
||
// Separate initial, rejoined and natural widths so viewport ownership has an unambiguous fingerprint.
|
||
const FIRST_CLIENT_WINDOW = { width: 900, height: 700 }
|
||
const REJOINED_CLIENT_WINDOW = { width: 1600, height: 1040 }
|
||
|
||
type GhostBrowserFixture = {
|
||
close(): Promise<void>
|
||
origin: string
|
||
serverUrl: string
|
||
nextUrl: string
|
||
}
|
||
|
||
// Decode distinct full-viewport colors to prove received pixels change, not just transport bookkeeping.
|
||
async function startGhostBrowserFixture(): Promise<GhostBrowserFixture> {
|
||
const server = createServer((request, response) => {
|
||
const url = new URL(request.url ?? '/', 'http://127.0.0.1')
|
||
const route = url.pathname === '/next' ? '/next' : '/server'
|
||
const color = ROUTE_COLORS[route]
|
||
response.writeHead(200, {
|
||
'cache-control': 'no-store',
|
||
'content-type': 'text/html; charset=utf-8'
|
||
})
|
||
response.end(`<!doctype html><html><head><title>${color.name}</title>
|
||
<style>
|
||
html,body{margin:0;padding:0;height:100%;background:rgb(${color.rgb.join(',')});}
|
||
#tick{position:fixed;left:8px;top:8px;font:700 28px monospace;color:#fff;}
|
||
</style></head><body>
|
||
<div id="marker">${color.name}</div>
|
||
<div id="tick">0</div>
|
||
<script>
|
||
let n = 0
|
||
// Keeps the compositor producing paints, so a live screencast always has something to send.
|
||
setInterval(() => { document.getElementById('tick').textContent = String(++n) }, 100)
|
||
</script>
|
||
</body></html>`)
|
||
})
|
||
await new Promise<void>((resolve, reject) => {
|
||
server.once('error', reject)
|
||
server.listen(0, '127.0.0.1', () => {
|
||
server.off('error', reject)
|
||
resolve()
|
||
})
|
||
})
|
||
const origin = `http://127.0.0.1:${(server.address() as AddressInfo).port}`
|
||
return {
|
||
close: () =>
|
||
new Promise<void>((resolve, reject) => {
|
||
server.closeAllConnections()
|
||
server.close((error) => (error ? reject(error) : resolve()))
|
||
}),
|
||
origin,
|
||
serverUrl: `${origin}/server`,
|
||
nextUrl: `${origin}/next`
|
||
}
|
||
}
|
||
|
||
async function callEnvironment<TResult>(
|
||
page: Page,
|
||
environmentId: string,
|
||
method: string,
|
||
params: unknown
|
||
): Promise<TResult> {
|
||
return page.evaluate(
|
||
async ({ environmentId, method, params }) => {
|
||
const response = await window.api.runtimeEnvironments.call({
|
||
selector: environmentId,
|
||
method,
|
||
params,
|
||
timeoutMs: 30_000
|
||
})
|
||
if (!response.ok) {
|
||
throw new Error(`${response.error.code}: ${response.error.message}`)
|
||
}
|
||
return response.result
|
||
},
|
||
{ environmentId, method, params }
|
||
) as Promise<TResult>
|
||
}
|
||
|
||
async function setClientWindowSize(
|
||
app: ElectronApplication,
|
||
bounds: { width: number; height: number }
|
||
): Promise<void> {
|
||
await app.evaluate(({ BrowserWindow }, bounds) => {
|
||
BrowserWindow.getAllWindows()[0]?.setBounds({ x: 0, y: 0, ...bounds })
|
||
}, bounds)
|
||
}
|
||
|
||
// Read viewport ownership inside the runtime guest, where subscriber device metrics apply.
|
||
async function readGuestViewportWidth(
|
||
app: ElectronApplication,
|
||
originPrefix: string
|
||
): Promise<number | null> {
|
||
return app.evaluate(async ({ webContents }, prefix) => {
|
||
const target = webContents.getAllWebContents().find((c) => c.getURL().startsWith(prefix))
|
||
if (!target) {
|
||
return null
|
||
}
|
||
try {
|
||
return (await target.executeJavaScript('innerWidth')) as number
|
||
} catch {
|
||
return null
|
||
}
|
||
}, originPrefix)
|
||
}
|
||
|
||
async function readGuestUrls(app: ElectronApplication, originPrefix: string): Promise<string[]> {
|
||
return app.evaluate(
|
||
({ webContents }, prefix) =>
|
||
webContents
|
||
.getAllWebContents()
|
||
.map((contents) => contents.getURL())
|
||
.filter((url) => url.startsWith(prefix)),
|
||
originPrefix
|
||
)
|
||
}
|
||
|
||
async function waitForWorktreeId(page: Page): Promise<string> {
|
||
await expect
|
||
.poll(() => page.evaluate(() => window.__store?.getState().allWorktrees().length ?? 0), {
|
||
timeout: 60_000,
|
||
message: 'paired client never saw a host worktree'
|
||
})
|
||
.toBeGreaterThan(0)
|
||
const worktreeId = await page.evaluate(
|
||
() => window.__store?.getState().allWorktrees()[0]?.id ?? null
|
||
)
|
||
if (!worktreeId) {
|
||
throw new Error('paired client did not receive the host worktree')
|
||
}
|
||
return worktreeId
|
||
}
|
||
|
||
/** Server placement only: a client-hosted page has no server screencast to ghost. */
|
||
async function forceServerPlacement(page: Page): Promise<void> {
|
||
await page.evaluate(async () => {
|
||
await window.__store?.getState().updateSettings({ browserClientHostedRemoteEnabled: false })
|
||
})
|
||
}
|
||
|
||
type FrameSample = {
|
||
src: string | null
|
||
dominant: 'teal' | 'crimson' | 'other' | 'undecodable'
|
||
}
|
||
|
||
// Decode shown pixels: an img src can remain frozen on a stale object URL.
|
||
async function sampleRenderedFrame(page: Page): Promise<FrameSample> {
|
||
return page.evaluate(async () => {
|
||
const img = document.querySelector<HTMLImageElement>('[data-testid="remote-browser-frame"]')
|
||
if (!img) {
|
||
return { src: null, dominant: 'undecodable' as const }
|
||
}
|
||
const src = img.getAttribute('src')
|
||
try {
|
||
if (!img.complete || img.naturalWidth === 0) {
|
||
await img.decode()
|
||
}
|
||
const canvas = document.createElement('canvas')
|
||
canvas.width = Math.max(1, Math.min(img.naturalWidth, 160))
|
||
canvas.height = Math.max(1, Math.min(img.naturalHeight, 160))
|
||
const context = canvas.getContext('2d', { willReadFrequently: true })
|
||
if (!context) {
|
||
return { src, dominant: 'undecodable' as const }
|
||
}
|
||
context.drawImage(img, 0, 0, canvas.width, canvas.height)
|
||
const { data } = context.getImageData(0, 0, canvas.width, canvas.height)
|
||
let red = 0
|
||
let green = 0
|
||
let blue = 0
|
||
for (let i = 0; i < data.length; i += 4) {
|
||
red += data[i]
|
||
green += data[i + 1]
|
||
blue += data[i + 2]
|
||
}
|
||
const pixels = data.length / 4
|
||
const [r, g, b] = [red / pixels, green / pixels, blue / pixels]
|
||
// Teal is green+blue with no red; crimson is red with neither.
|
||
if (r > 90 && r > g + 50 && r > b + 50) {
|
||
return { src, dominant: 'crimson' as const }
|
||
}
|
||
if (g > 40 && b > 40 && g + b > r * 2) {
|
||
return { src, dominant: 'teal' as const }
|
||
}
|
||
return { src, dominant: 'other' as const }
|
||
} catch {
|
||
return { src, dominant: 'undecodable' as const }
|
||
}
|
||
})
|
||
}
|
||
|
||
async function expectPaneShows(
|
||
page: Page,
|
||
expected: 'teal' | 'crimson',
|
||
message: string
|
||
): Promise<void> {
|
||
await expect
|
||
.poll(async () => (await sampleRenderedFrame(page)).dominant, {
|
||
timeout: 90_000,
|
||
intervals: [500, 1_000, 2_000],
|
||
message
|
||
})
|
||
.toBe(expected)
|
||
}
|
||
|
||
async function attachEvidence(testInfo: TestInfo, name: string, body: unknown): Promise<void> {
|
||
console.log(`[ghost-e2e] ${name}`, JSON.stringify(body))
|
||
await testInfo.attach(name, {
|
||
body: JSON.stringify(body, null, 2),
|
||
contentType: 'application/json'
|
||
})
|
||
}
|
||
|
||
test('replaces a force-quit client screencast subscriber when the same device rejoins', async ({
|
||
testRepoPath
|
||
}, testInfo) => {
|
||
test.setTimeout(300_000)
|
||
const host: HeadlessPairedRuntimeHost = await launchHeadlessPairedRuntimeHost()
|
||
const fixture = await startGhostBrowserFixture()
|
||
let client: PairedElectronClient | null = null
|
||
let abandonedProfile: string | null = null
|
||
|
||
try {
|
||
await host.client.call('repo.add', { path: testRepoPath, kind: 'git' })
|
||
client = await launchPairedElectronClient(host.offer, testInfo, 'Ghost subscriber rejoin')
|
||
const clientProfile = client.userDataDir
|
||
abandonedProfile = clientProfile
|
||
await setClientWindowSize(client.app, FIRST_CLIENT_WINDOW)
|
||
const worktreeId = await waitForWorktreeId(client.page)
|
||
await forceServerPlacement(client.page)
|
||
|
||
const created = await callEnvironment<{ browserPageId: string }>(
|
||
client.page,
|
||
client.environmentId,
|
||
'browser.tabCreate',
|
||
{ worktree: `id:${worktreeId}`, url: fixture.serverUrl, activate: true }
|
||
)
|
||
const remotePageId = created.browserPageId
|
||
|
||
await expect
|
||
.poll(() => readGuestUrls(host.app, fixture.origin), {
|
||
timeout: 60_000,
|
||
message: 'runtime never opened the server-placed browser page'
|
||
})
|
||
.toHaveLength(1)
|
||
expect(await readGuestUrls(client.app, fixture.origin)).toHaveLength(0)
|
||
|
||
await expect
|
||
.poll(() => readGuestViewportWidth(host.app, fixture.origin), {
|
||
timeout: 30_000,
|
||
message: 'runtime guest page never reported a viewport'
|
||
})
|
||
.not.toBeNull()
|
||
const unwatchedWidth = await readGuestViewportWidth(host.app, fixture.origin)
|
||
|
||
// Use the mirrored pane; a second local pane would replace its one-screencast-per-connection subscription.
|
||
await focusMaterializedRemoteBrowserPane(client.page, {
|
||
environmentId: client.environmentId,
|
||
remotePageId,
|
||
worktreeId
|
||
})
|
||
await expect(client.page.getByTestId('remote-browser-frame').first()).toBeVisible({
|
||
timeout: 60_000
|
||
})
|
||
await expectPaneShows(client.page, 'teal', 'first client never rendered the server page pixels')
|
||
|
||
// Read the first client’s viewport fingerprint from the host guest.
|
||
await expect
|
||
.poll(() => readGuestViewportWidth(host.app, fixture.origin), {
|
||
timeout: 60_000,
|
||
message: 'first subscriber never took ownership of the guest viewport'
|
||
})
|
||
.not.toBe(unwatchedWidth)
|
||
const firstClientWidth = await readGuestViewportWidth(host.app, fixture.origin)
|
||
|
||
const killedApp = client.app
|
||
client = null
|
||
await forceQuitElectronAppForE2E(killedApp)
|
||
|
||
// Record orphan handling while no client exists; immediate socket reap and later same-device replacement are both valid.
|
||
const orphanTimeline: { atMs: number; guestWidth: number | null }[] = []
|
||
const killedAt = Date.now()
|
||
for (const waitMs of [500, 1_500, 3_000, 5_000]) {
|
||
await new Promise((resolve) => setTimeout(resolve, waitMs))
|
||
orphanTimeline.push({
|
||
atMs: Date.now() - killedAt,
|
||
guestWidth: await readGuestViewportWidth(host.app, fixture.origin)
|
||
})
|
||
}
|
||
const orphanSurvivedTheKill = orphanTimeline.some(
|
||
(entry) => entry.guestWidth === firstClientWidth
|
||
)
|
||
|
||
// Server placement means the page outlives the client that was viewing it — which is what
|
||
// leaves a subscriber behind to be ghosted in the first place.
|
||
expect(await readGuestUrls(host.app, fixture.origin)).toHaveLength(1)
|
||
|
||
// Reuse the profile’s credential so the new socket authenticates the same pairedDeviceId.
|
||
client = await launchPairedElectronClient(host.offer, testInfo, 'Ghost subscriber rejoin', {
|
||
reuseUserDataDir: clientProfile
|
||
})
|
||
const widthWhenRejoiningClientStarted = await readGuestViewportWidth(host.app, fixture.origin)
|
||
await setClientWindowSize(client.app, REJOINED_CLIENT_WINDOW)
|
||
const rejoinedWorktreeId = await waitForWorktreeId(client.page)
|
||
await forceServerPlacement(client.page)
|
||
await focusMaterializedRemoteBrowserPane(client.page, {
|
||
environmentId: client.environmentId,
|
||
remotePageId,
|
||
worktreeId: rejoinedWorktreeId
|
||
})
|
||
|
||
await expect(client.page.getByTestId('remote-browser-frame').first()).toBeVisible({
|
||
timeout: 90_000
|
||
})
|
||
await expectPaneShows(
|
||
client.page,
|
||
'teal',
|
||
'rejoined client never rendered a screencast frame of the surviving page'
|
||
)
|
||
|
||
await expect
|
||
.poll(() => readGuestViewportWidth(host.app, fixture.origin), {
|
||
timeout: 60_000,
|
||
message: 'rejoined subscriber never took ownership of the guest viewport'
|
||
})
|
||
.not.toBe(firstClientWidth)
|
||
const rejoinedClientWidth = await readGuestViewportWidth(host.app, fixture.origin)
|
||
expect(rejoinedClientWidth).not.toBe(unwatchedWidth)
|
||
|
||
// Navigate at the host and require changed decoded client pixels, ruling out a stale snapshot.
|
||
await callEnvironment(client.page, client.environmentId, 'browser.goto', {
|
||
worktree: `id:${rejoinedWorktreeId}`,
|
||
page: remotePageId,
|
||
url: fixture.nextUrl
|
||
})
|
||
await expectPaneShows(
|
||
client.page,
|
||
'crimson',
|
||
'rejoined screencast never reflected a runtime-side navigation'
|
||
)
|
||
await expect
|
||
.poll(() => readGuestUrls(host.app, fixture.origin), {
|
||
timeout: 60_000,
|
||
message: 'runtime page never navigated'
|
||
})
|
||
.toEqual([fixture.nextUrl])
|
||
|
||
await client.page.screenshot({
|
||
path: testInfo.outputPath('ghost-rejoin-live-frame.png'),
|
||
fullPage: false
|
||
})
|
||
await testInfo.attach('rejoined-client-frame', {
|
||
path: testInfo.outputPath('ghost-rejoin-live-frame.png'),
|
||
contentType: 'image/png'
|
||
})
|
||
|
||
// Cleanly quit the rejoined client, then require natural guest width: the dead subscriber must not regain viewport ownership.
|
||
// Bound this below heartbeat/90-refusal cleanup so slow fallback cannot satisfy it.
|
||
const departingClient = client
|
||
client = null
|
||
await departingClient.dispose()
|
||
|
||
const departure: { atMs: number; guestWidth: number | null }[] = []
|
||
const departedAt = Date.now()
|
||
for (;;) {
|
||
const guestWidth = await readGuestViewportWidth(host.app, fixture.origin)
|
||
departure.push({ atMs: Date.now() - departedAt, guestWidth })
|
||
if (guestWidth !== rejoinedClientWidth || Date.now() - departedAt > 15_000) {
|
||
break
|
||
}
|
||
await new Promise((resolve) => setTimeout(resolve, 250))
|
||
}
|
||
|
||
await attachEvidence(testInfo, 'ghost-subscriber-evidence', {
|
||
unwatchedWidth,
|
||
firstClientWidth,
|
||
widthWhenRejoiningClientStarted,
|
||
rejoinedClientWidth,
|
||
orphanSurvivedTheKill,
|
||
orphanTimeline,
|
||
finalWidth: departure.at(-1)?.guestWidth,
|
||
departureSamples: departure.length
|
||
})
|
||
|
||
const finalWidth = departure.at(-1)?.guestWidth
|
||
expect(
|
||
finalWidth,
|
||
'the force-quit client still owned a screencast subscriber after the rejoining device replaced it'
|
||
).not.toBe(firstClientWidth)
|
||
expect(finalWidth, 'the runtime never released the screencast viewport override').toBe(
|
||
unwatchedWidth
|
||
)
|
||
} finally {
|
||
await client?.dispose()
|
||
if (abandonedProfile) {
|
||
rmSync(abandonedProfile, { recursive: true, force: true })
|
||
}
|
||
await fixture.close()
|
||
await host.dispose()
|
||
}
|
||
})
|