import assert from "node:assert/strict"; import fs from "node:fs"; import path from "node:path"; import { fileURLToPath } from "node:url"; import { assertCloudWebDistFresh, buildCloudWebDist, readCloudWebAppSource } from "./dist-contract.ts"; const rootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), ".."); const repoRoot = path.resolve(rootDir, "../.."); const requiredFiles = Object.freeze([ "index.html", "src/main.tsx", "src/App.tsx", "src/components/layout/ActivityRail.tsx", "src/components/auth/LoginShell.tsx", "src/components/sessions/SessionSidebar.tsx", "src/components/conversation/ConversationPanel.tsx", "src/components/command-bar/CommandBar.tsx", "src/components/device-pod/DevicePodSidebar.tsx", "src/components/performance/PerformanceView.tsx", "src/components/settings/SettingsView.tsx", "src/components/skills/SkillsView.tsx", "src/hooks/useAuth.ts", "src/services/api/client.ts", "src/state/workbench.ts", "src/types/domain.ts", "src/styles/workbench.css", "favicon.svg", "favicon.ico", "help.md" ]); for (const file of requiredFiles) { if (!fs.existsSync(path.resolve(rootDir, file))) throw new Error(`missing React web asset: ${file}`); } console.log("hwlab-cloud-web check: React module assets present"); const html = readWeb("index.html"); const appTsx = readWeb("src/App.tsx"); const apiClientSource = readWeb("src/services/api/client.ts"); const appSource = readCloudWebAppSource(rootDir); const css = readWeb("src/styles/workbench.css"); assert.match(html, /
<\/div>/u, "index.html must only expose React mount root"); assert.match(html, /src="\/src\/main\.tsx"/u, "index.html must load React TSX entry"); assert.doesNotMatch(html, /workbench-shell|device-pod-sidebar|command-input|conversation-list|session-tabs/u, "index.html must not contain business DOM shell"); for (const removed of ["app.ts", "app-device-pod.ts", "app-conversation.ts", "app-helpers.ts", "app-skills.ts", "styles.css", "web-types.d.ts"]) { assert.equal(fs.existsSync(path.join(rootDir, removed)), false, `${removed} must not remain as a legacy runtime path`); } assertIncludes(appSource, "createRoot", "React root must be used"); assertIncludes(appSource, "React.StrictMode", "React StrictMode must wrap the app"); assertIncludes(appSource, "useWorkbenchStore", "state hook must own workbench state"); assertIncludes(appSource, "fetchJson", "API client must own fetch calls"); assertIncludes(appSource, "DevicePodSidebar", "Device Pod sidebar component must exist"); assertIncludes(appSource, "CommandBar", "command bar component must exist"); assertIncludes(appSource, "PerformanceView", "performance view component must exist"); assertIncludes(appSource, "SkillsView", "skills component must exist"); assertIncludes(appSource, "SettingsView", "settings component must exist"); assertIncludes(appTsx, "const workspaceRoute = route === \"workspace\"", "React runtime must explicitly identify workspace route before starting workbench data flows"); assertIncludes(appTsx, "useWorkbenchStore(auth.authState === \"authenticated\" && workspaceRoute)", "Workbench data requests must wait until auth is authenticated and workspace route is active"); assertIncludes(apiClientSource, "adapter: (): Promise> => fetchJson(\"/v1/rpc/system.health\", { method: \"POST\"", "adapter health must use POST /v1/rpc/system.health"); assertIncludes(appSource, "selectVisibleDevicePodId", "Device Pod detail probes must be selected from the authenticated visible list"); assertIncludes(appSource, "api.devicePods()", "Device Pod list must be fetched before detail probes"); assert.doesNotMatch(appSource, /api\.devicePods\(\),\s*api\.devicePodStatus/u, "Device Pod status must not be requested in the initial parallel live probe"); assertIncludes(readRepo("internal/dev-entrypoint/cloud-web-routes.mjs"), "normalizedPath.startsWith(\"/v1/rpc/\")", "Cloud Web must proxy REST RPC bridge routes to cloud-api"); assertIncludes(appSource, "id=\"command-input\"", "React runtime must render command input selector"); assertIncludes(appSource, "id=\"conversation-list\"", "React runtime must render conversation list selector"); assertIncludes(appSource, "id=\"device-pod-sidebar\"", "React runtime must render Device Pod sidebar selector"); assertIncludes(appSource, "id=\"device-event-scroll\"", "React runtime must render Device Pod event stream selector"); assertIncludes(appSource, "id=\"logout-button\"", "React runtime must render logout selector"); assertIncludes(appSource, "route === \"performance\"", "React runtime must route top-level performance panel"); assertIncludes(readRepo("internal/cloud/server.ts"), "/v1/web-performance/summary", "cloud-api must expose WebUI performance summary API"); assert.doesNotMatch(appSource, /document\.getElementById\((?!["']root["'])|querySelector\(["']#(?:command-input|conversation-list|device-pod-sidebar)/u, "major UI must not be driven by global DOM element lookups"); assert.doesNotMatch(appSource, /\bconst\s+el\s*=/u, "global el map must not return"); for (const directory of ["components/layout", "components/auth", "components/sessions", "components/conversation", "components/command-bar", "components/device-pod", "components/performance", "components/settings", "components/skills", "hooks", "services/api", "state", "types", "styles"]) { assert.ok(fs.existsSync(path.join(rootDir, "src", directory)), `missing React module boundary src/${directory}`); } assert.match(css, /@media \(max-width: 720px\)/u, "mobile layout contract must be explicit"); assert.match(css, /grid-template-columns:\s*56px\s+minmax\(0,\s*1fr\)/u, "390px mobile layout must not keep three squeezed columns"); assert.match(css, /\.device-event-scroll\s*\{[\s\S]*?overscroll-behavior:\s*contain;/u, "event stream scroll must be contained"); assert.match(css, /\.device-event-panel\s*\{[\s\S]*?max-height:\s*min\(360px,\s*38dvh\);/u, "event stream panel must have a bounded own scroll area"); assert.match(css, /\.session-tabs\s*\{[\s\S]*?overflow-x:\s*hidden;/u, "session sidebar must not horizontally scroll"); assert.match(css, /\.message-body p\s*\{\s*white-space:\s*pre-wrap;\s*\}/u, "final response markdown paragraphs must preserve soft line breaks"); assert.match(css, /@keyframes trace-update-pulse/u, "trace updates must have an explicit visual pulse"); assert.match(css, /@keyframes trace-working-border/u, "running trace frame must show an explicit working animation"); assert.match(css, /\.message-trace-body\s*\{[\s\S]*?max-height:\s*calc\(4 \* 1\.35em \+ 14px\);/u, "trace/tool output body must be capped to about four lines with internal scroll"); assert.doesNotMatch(appSource, /message-trace-storage-key/u, "trace summary must not expose raw trace ids as visible chips"); assert.doesNotMatch(appSource, /last ยท/u, "trace summary must not show raw last-event labels"); const cloudApiServer = readRepo("internal/cloud/server.ts"); const deployJson = readRepo("deploy/deploy.json"); assertIncludes(cloudApiServer, "/v1/device-pods", "cloud-api must expose Device Pod REST routes"); assertIncludes(cloudApiServer, "/v1/skills", "cloud-api must expose Skills REST routes"); assertIncludes(deployJson, "hwlab-device-pod", "deploy manifest must include Device Pod service"); await buildCloudWebDist(rootDir); console.log("hwlab-cloud-web check: dist bundle built by Vite"); await assertCloudWebDistFresh(rootDir); console.log("hwlab-cloud-web check: dist freshness verified"); console.log("hwlab-cloud-web check ok: React + strict TypeScript module boundaries and runtime selectors are present"); function readWeb(relativePath: string): string { return fs.readFileSync(path.resolve(rootDir, relativePath), "utf8"); } function readRepo(relativePath: string): string { return fs.readFileSync(path.resolve(repoRoot, relativePath), "utf8"); } function assertIncludes(source: string, term: string, message: string): void { assert.ok(source.includes(term), message); }