// Scratch-only browser proof: real views/modal/graph, deterministic get_pipeline
// fixture. No deployed service, socket, workflow, model or device is contacted.
import assert from "node:assert/strict";
import { createServer } from "node:http";
import { readFile, mkdir } from "node:fs/promises";
import { resolve, extname } from "node:path";
import { fileURLToPath } from "node:url";
import { launchChrome } from "./browser.mjs";
const root = fileURLToPath(new URL("../", import.meta.url));
const out = resolve(process.argv[2] || ".ui-stage-definition");
await mkdir(out, { recursive: true });
const source = "# stage review\n\n```prompt\nReview **the change**.\n# stage not-a-node\n```\n\n```custom\nPreserve this authored block.\n```\n\n```edges\nsuccess -> #\n```\n\n";
const html = `
Stage definition scratch proof
${["design/tokens/tokens", "base", "shell", "lists", "run-detail", "chat", "graph", "dialogs"].map(name => ``).join("")}
Scratch stage definition proof
`;
const server = createServer(async (req, res) => {
try {
if (req.url === "/") { res.setHeader("content-type", "text/html"); res.end(html); return; }
const path = resolve(root, `.${new URL(req.url, "http://scratch").pathname}`);
if (!path.startsWith(root)) { res.writeHead(403); res.end(); return; }
res.setHeader("content-type", extname(path) === ".css" ? "text/css" : "text/javascript");
res.end(await readFile(path));
} catch { res.writeHead(404); res.end(); }
});
await new Promise(resolve => server.listen(0, "127.0.0.1", resolve));
let browser;
try {
browser = await launchChrome();
const page = await browser.openPage(`http://127.0.0.1:${server.address().port}/`);
const capture = async (name) => {
await page.evaluate('Promise.all(document.getAnimations().filter(a => a.effect.getTiming().iterations !== Infinity).map(a => a.finished.catch(() => {})))');
await page.screenshot(resolve(out, name));
};
await page.waitForSelector('.graph-node[data-key="review"]');
const openDefinition = async () => {
await page.evaluate('new Promise(resolve => requestAnimationFrame(() => requestAnimationFrame(resolve)))');
await page.click('.graph-node[data-key="review"]');
// Run nodes open visit evidence. Definition is explicit in its audit;
// workflow graph nodes still open authored source directly.
if (await page.evaluate('!!document.querySelector(".stage-pane")')) {
await page.click('.audit-open');
await page.click('[data-audit-tab="definition"]');
}
};
const clickNode = async () => {
await openDefinition();
await page.waitForSelector('.stage-definition-document .field-markdown');
};
await clickNode();
assert.deepEqual(await page.evaluate('requests'), [{ id: 7, version: 3 }]);
assert.equal(await page.evaluate('document.querySelector(".app-root").inert'), true);
await capture("01-run-definition-rendered.png");
await page.clickText('.audit-doc-mode', 'Raw');
assert.equal(await page.evaluate('document.querySelector(".stage-definition-document code").textContent === expectedSource'), true);
assert.equal(await page.evaluate('document.activeElement.textContent'), 'Raw');
await capture("02-run-definition-raw.png");
for (let i = 0; i < 8; i++) {
await page.pressKey('Tab');
assert.equal(await page.evaluate('document.querySelector(".audit-viewer").contains(document.activeElement)'), true);
}
await page.pressKey('Escape');
assert.equal(await page.evaluate('document.activeElement.classList.contains("audit-open")'), true);
await page.pressKey('Escape');
assert.equal(await page.evaluate('document.activeElement.dataset.key'), 'review');
assert.equal(await page.evaluate('location.pathname'), '/');
assert.deepEqual(await page.evaluate('routes'), []);
await page.evaluate("show('pipeline')");
await clickNode();
assert.deepEqual(await page.evaluate('routes'), []);
assert.equal(await page.evaluate('requests.length'), 1);
await capture("03-pipeline-definition-rendered.png");
await page.click('.audit-close');
await page.evaluate("show('run');pane()");
await page.click('.audit-open');
await page.click('[data-audit-tab="definition"]');
await page.waitForSelector('.stage-definition-document .field-markdown');
assert.deepEqual(await page.evaluate('rt.modal.stackIds()'), ['stage-pane','stage-audit']);
await capture("04-visit-definition-nested.png");
await page.pressKey('Escape');
assert.equal(await page.evaluate('!!document.querySelector(".stage-pane")'), true);
assert.equal(await page.evaluate('document.activeElement.classList.contains("audit-open")'), true);
await page.evaluate("show('run');window.missing=true");
await page.evaluate('new Promise(resolve => requestAnimationFrame(() => requestAnimationFrame(resolve)))');
await openDefinition();
await page.waitForText('No definition has been reconstructed.');
await capture("05-definition-missing-source.png");
await page.evaluate("show('run');window.missing=false;window.fail=true");
await page.evaluate('new Promise(resolve => requestAnimationFrame(() => requestAnimationFrame(resolve)))');
await openDefinition();
await page.waitForText('fixture refusal');
await capture("06-definition-load-failed.png");
await page.evaluate("show('pipeline');window.fail=false");
await page.evaluate('new Promise(resolve => requestAnimationFrame(() => requestAnimationFrame(resolve)))');
await page.click('.graph-node[data-key="#success"]');
await page.waitForText('Terminal nodes have no authored stage definition.');
await capture("07-definition-terminal.png");
await page.evaluate("show('run')");
await clickNode();
await page.resize(390, 844);
await capture("08-definition-narrow.png");
await page.resize(1440, 900);
await page.evaluate("show('run');window.delay=true");
await page.evaluate('new Promise(resolve => requestAnimationFrame(() => requestAnimationFrame(resolve)))');
await openDefinition();
await page.waitForText('Loading stage definition…');
await capture("09-definition-loading.png");
await page.clickText('.audit-doc-mode', 'Raw');
await page.evaluate('release()');
await page.waitForSelector('.stage-definition-document code');
assert.equal(await page.evaluate('document.querySelector(".stage-definition-document code").textContent === expectedSource'), true);
await page.evaluate("show('run');window.delay=false;rt.state.runDetail.version=0;window.beforeRequests=requests.length");
await page.evaluate('new Promise(resolve => requestAnimationFrame(() => requestAnimationFrame(resolve)))');
await openDefinition();
await page.waitForText('The run did not include its pipeline version.');
assert.equal(await page.evaluate('requests.length === beforeRequests'), true);
await capture("10-definition-missing-version.png");
console.log(`PASS: explicit run-visit audit / workflow definition popup, exact source, keyboard focus/escape, nested stage preservation, missing/error states; captures ${out}`);
} finally {
await browser?.close();
await new Promise(resolve => server.close(resolve));
}