Skip to content

Local code intelligence for developers and AI agents. Connect code, docs and infrastructure in a persistent graph, with CBM Lens, MCP tools, agent integrations and change-aware test selection.

test(ui): check the Architecture and log fixes of the hand test in a browser

Bernhard Jackiewicz0e957965a6b0
diff --git a/graph-ui/tools/handtest-fixes-architecture.mjs b/graph-ui/tools/handtest-fixes-architecture.mjs
new file mode 100644
index 000000000..1ac9866e0
--- /dev/null
+++ b/graph-ui/tools/handtest-fixes-architecture.mjs
@@ -0,0 +1,543 @@
+#!/usr/bin/env node
+/*
+ * Browserpruefung der Handtest-Korrekturen, Strang Architecture und Logs
+ * (K18 bis K23, K25, K26 aus verification/call-feedback-2026-10-02/KORREKTURPLAN.md).
+ *
+ * node tools/handtest-fixes-architecture.mjs --origin http://127.0.0.1:4373 \
+ * --out /tmp/handtest/architecture [--tag after] [--only K18,K19] \
+ * [--project django-demo] [--control cbm] [--profile /tmp/profile]
+ *
+ * Jede Pruefung faehrt genau den Ablauf aus dem Korrekturplan, misst den
+ * Befund in der laufenden Seite und schreibt PASS oder FAIL mit dem Messwert.
+ * Die Bilder liegen je Punkt unter <out>/<K>/<tag>-NN-name.png, bei einer
+ * Bewegung auch nach 0 ms, 250 ms, 1 s und 3 s. Daneben schreibt das Skript je
+ * Punkt ein index-<tag>.md mit jedem Bild und dem, was es zeigt, und
+ * report-<tag>.json.
+ *
+ * Beschriftungen und Kamera haengen von der Groesse der Zeichenflaeche ab. K20,
+ * K21 und K25 laufen darum zweimal: mit 1600x1000 und in der Ansicht des
+ * Handtests (1494x728, Chat offen), in der die leeren Behavior-Kaesten
+ * auffielen.
+ *
+ * Es startet keinen Server und schreibt nichts in das Protokoll des Servers:
+ * POST /api/ui-log wird im Browser beantwortet und nur mitgeschnitten, und
+ * navigator.sendBeacon (die letzte Sendung beim Verlassen einer Seite, die am
+ * Routing vorbeigeht) bleibt in der Seite. So landen die Pruefsitzungen nicht
+ * im System-Log des Nutzers.
+ */
+
+import { chromium } from 'playwright';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { inflateSync } from 'node:zlib';
+
+const argv = process.argv.slice(2);
+const arg = (name, fallback) => {
+ const index = argv.indexOf(`--${name}`);
+ if (index < 0) return fallback;
+ const value = argv[index + 1];
+ return value === undefined || value.startsWith('--') ? true : value;
+};
+const ORIGIN = String(arg('origin', 'http://127.0.0.1:4373')).replace(/\/$/, '');
+const OUT = resolve(String(arg('out', 'verification/handtest-fixes/architecture')));
+const TAG = String(arg('tag', 'after'));
+const PROFILE = resolve(String(arg('profile', join(OUT, '..', 'profile-architecture'))));
+const PROJECT = String(arg('project', 'django-demo'));
+const CONTROL = String(arg('control', 'cbm'));
+const ONLY = String(arg('only', 'K18,K19,K20,K21,K22,K23,K25,K26')).split(',');
+const VIEWPORT = { width: 1600, height: 1000 };
+const SCALE = 2;
+const THREE_CLOCK = 'THREE.THREE.Clock: This module has been deprecated. Please use THREE.Timer instead.';
+
+const wait = (ms) => new Promise((done) => setTimeout(done, ms));
+
+/* ------------------------------------------------------------------ */
+/* Ergebnis und Bilder */
+
+const checks = [];
+const images = new Map();
+const counters = new Map();
+
+/** Die Ansicht des Handtests: schmalere, niedrigere Zeichenflaeche mit offenem Chat. */
+let layout = 'standard';
+const LAYOUTS = { standard: { width: 1600, height: 1000, chat: false }, handtest: { width: 1494, height: 728, chat: true } };
+
+function check(id, title, pass, measured) {
+ const name = layout === 'standard' ? id : `${id}@${layout}`;
+ checks.push({ id: name, title, pass: Boolean(pass), measured });
+ console.log(`${pass ? 'PASS' : 'FAIL'} ${name} ${title} ${JSON.stringify(measured)}`);
+}
+
+async function shot(page, id, label, note = '') {
+ const next = (counters.get(id) ?? 0) + 1;
+ counters.set(id, next);
+ const file = `${TAG}-${String(next).padStart(2, '0')}-${layout === 'standard' ? '' : `${layout}-`}${label}.png`;
+ await mkdir(join(OUT, id), { recursive: true });
+ const png = await page.screenshot({ path: join(OUT, id, file) });
+ images.set(id, [...images.get(id) ?? [], { file, note }]);
+ return png;
+}
+
+/** Bilder direkt nach einer Handlung und nach 250 ms, 1 s und 3 s. */
+async function series(page, id, label, action, note) {
+ await action();
+ await shot(page, id, `${label}-0ms`, `${note}: direkt nach der Handlung`);
+ await wait(250); await shot(page, id, `${label}-250ms`, `${note}: nach 250 ms`);
+ await wait(750); await shot(page, id, `${label}-1s`, `${note}: nach 1 s`);
+ await wait(2000); return shot(page, id, `${label}-3s`, `${note}: nach 3 s`);
+}
+
+/* ------------------------------------------------------------------ */
+/* Pixel aus einem Bildschirmfoto, ohne weitere Abhaengigkeit */
+
+function decodePng(buffer) {
+ let offset = 8; let width = 0; let height = 0; let channels = 4; const idat = [];
+ while (offset < buffer.length) {
+ const length = buffer.readUInt32BE(offset); const type = buffer.toString('ascii', offset + 4, offset + 8);
+ const data = buffer.subarray(offset + 8, offset + 8 + length);
+ if (type === 'IHDR') { width = data.readUInt32BE(0); height = data.readUInt32BE(4); channels = data[9] === 6 ? 4 : 3; }
+ if (type === 'IDAT') idat.push(data);
+ offset += length + 12;
+ }
+ const raw = inflateSync(Buffer.concat(idat)); const stride = width * channels; const pixels = Buffer.alloc(stride * height);
+ for (let y = 0; y < height; y++) {
+ const filter = raw[y * (stride + 1)]; const line = raw.subarray(y * (stride + 1) + 1, (y + 1) * (stride + 1));
+ for (let x = 0; x < stride; x++) {
+ const left = x >= channels ? pixels[y * stride + x - channels] : 0; const up = y ? pixels[(y - 1) * stride + x] : 0;
+ const corner = x >= channels && y ? pixels[(y - 1) * stride + x - channels] : 0;
+ const paeth = () => { const p = left + up - corner; const a = Math.abs(p - left); const b = Math.abs(p - up); const c = Math.abs(p - corner); return a <= b && a <= c ? left : b <= c ? up : corner; };
+ const value = filter === 1 ? left : filter === 2 ? up : filter === 3 ? (left + up) >> 1 : filter === 4 ? paeth() : 0;
+ pixels[y * stride + x] = (line[x] + value) & 255;
+ }
+ }
+ return { width, height, channels, pixels };
+}
+
+/** Die haeufigste Farbe in einem 7x7-Feld um einen Punkt in CSS-Pixeln: Rasterlinien fallen heraus. */
+function colorAt(image, x, y) {
+ const counts = new Map();
+ for (let dy = -3; dy <= 3; dy++) for (let dx = -3; dx <= 3; dx++) {
+ const px = Math.min(image.width - 1, Math.max(0, Math.round(x * SCALE) + dx)); const py = Math.min(image.height - 1, Math.max(0, Math.round(y * SCALE) + dy));
+ const at = (py * image.width + px) * image.channels; const key = `${image.pixels[at]},${image.pixels[at + 1]},${image.pixels[at + 2]}`;
+ counts.set(key, (counts.get(key) ?? 0) + 1);
+ }
+ return [...counts].sort((a, b) => b[1] - a[1])[0][0].split(',').map(Number);
+}
+const hex = ([r, g, b]) => `#${[r, g, b].map((value) => value.toString(16).padStart(2, '0')).join('')}`;
+const close = (a, b, tolerance = 6) => a.every((value, index) => Math.abs(value - b[index]) <= tolerance);
+
+/* ------------------------------------------------------------------ */
+/* Seite */
+
+let uiLogPosts = [];
+
+async function open(page, project, workspace = 'architecture') {
+ const size = LAYOUTS[layout];
+ await page.setViewportSize({ width: size.width, height: size.height });
+ await page.goto(`${ORIGIN}/?project=${encodeURIComponent(project)}&workspace=${workspace}`, { waitUntil: 'domcontentloaded' });
+ await page.waitForSelector('.atlas-shell', { timeout: 30000 });
+ await wait(1500);
+ const toggle = page.locator('.atlas-agent-chat-toggle').first();
+ if (await toggle.count() && (await toggle.getAttribute('aria-expanded') === 'true') !== size.chat) { await toggle.click(); await wait(800); }
+}
+const tab = (page, view) => page.locator(`button.atlas-arch-tab[data-view="${view}"]`).first();
+async function sceneSettled(page, selector, timeout = 30000) {
+ await page.waitForFunction((sel) => document.querySelectorAll(sel).length > 0, selector, { timeout }).catch(() => {});
+ await wait(2500);
+}
+
+/**
+ * Sichtbare Beschriftungen in der Zeichenflaeche und ihre Ueberdeckungen. Ein
+ * Etikett darf den Innenabstand eines Nachbarn beruehren, nie seine Schrift:
+ * gemessen wird darum die Schriftflaeche des einen gegen den Kasten des anderen.
+ */
+async function labelGeometry(page) {
+ return page.evaluate(() => {
+ const canvas = document.querySelector('.atlas-architecture canvas')?.getBoundingClientRect();
+ const kinds = { 'architecture-node-label': 'chip', 'architecture-folder-label': 'folder', 'system-scene-node-label': 'chip', 'system-scene-lane-label': 'lane' };
+ const items = [];
+ for (const element of document.querySelectorAll('.architecture-node-label, .architecture-folder-label, .system-scene-node-label, .system-scene-lane-label')) {
+ const style = getComputedStyle(element); const box = element.getBoundingClientRect();
+ if (element.offsetParent === null || style.visibility === 'hidden' || style.display === 'none' || box.width < 1 || box.height < 1) continue;
+ if (canvas && (box.right < canvas.left || box.left > canvas.right || box.bottom < canvas.top || box.top > canvas.bottom)) continue;
+ const side = (name) => (parseFloat(style.getPropertyValue(`padding-${name}`)) || 0) + (parseFloat(style.getPropertyValue(`border-${name}-width`)) || 0);
+ const text = { left: box.left + side('left'), right: box.right - side('right'), top: box.top + side('top'), bottom: box.bottom - side('bottom') };
+ const kind = Object.entries(kinds).find(([name]) => element.classList.contains(name))?.[1] ?? 'label';
+ const strong = element.querySelector('strong') ?? element;
+ items.push({ kind, text: element.textContent?.trim() ?? '', title: element.getAttribute('title') ?? '', box: { left: box.left, right: box.right, top: box.top, bottom: box.bottom }, textBox: text,
+ truncated: strong.scrollWidth > strong.clientWidth + 1, inside: Boolean(canvas) && box.left >= canvas.left - 1 && box.right <= canvas.right + 1 && box.top >= canvas.top - 1 && box.bottom <= canvas.bottom + 1 });
+ }
+ const hit = (a, b) => Math.min(a.right, b.right) - Math.max(a.left, b.left) > 0.5 && Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top) > 0.5;
+ const overlaps = [];
+ for (let i = 0; i < items.length; i++) for (let j = i + 1; j < items.length; j++) {
+ if (hit(items[i].textBox, items[j].box) || hit(items[j].textBox, items[i].box)) overlaps.push(`${items[i].kind}:${items[i].text} / ${items[j].kind}:${items[j].text}`);
+ }
+ return { canvas: canvas ? { left: canvas.left, right: canvas.right, top: canvas.top, bottom: canvas.bottom } : null, labels: items, overlaps };
+ });
+}
+const summary = (geometry) => ({ labels: geometry.labels.length, chips: geometry.labels.filter((item) => item.kind === 'chip').length,
+ folders: geometry.labels.filter((item) => item.kind === 'folder' || item.kind === 'lane').length, overlaps: geometry.overlaps.length, overlapping: geometry.overlaps.slice(0, 6) });
+
+async function selectEntry(page, pattern) {
+ const select = page.getByLabel('Behavior entry point').first();
+ const options = await select.locator('option').allTextContents();
+ const index = options.findIndex((option) => pattern.test(option));
+ if (index < 0) return null;
+ await select.selectOption({ index });
+ return options[index];
+}
+async function behaviorState(page) {
+ return page.evaluate(() => {
+ const select = document.querySelector('select[aria-label="Behavior entry point"]');
+ const scene = document.querySelector('.system-scene');
+ return { heading: document.querySelector('.behavior-heading h2')?.textContent?.trim() ?? '',
+ value: select?.value ?? null, selected: select?.selectedOptions[0]?.textContent?.trim() ?? '',
+ navigation: document.querySelector('.behavior-navigation')?.textContent?.replace(/\s+/g, ' ').trim() ?? '',
+ pages: document.querySelector('nav[aria-label="Direct call pages"]')?.textContent?.replace(/\s+/g, ' ').trim() ?? '',
+ sceneNodes: scene ? Number(scene.getAttribute('data-node-count') ?? NaN) : null };
+ });
+}
+
+/* ------------------------------------------------------------------ */
+/* K18: das Auswahlfeld "Start" zeigt die automatisch gewaehlte Operation */
+
+async function k18(page) {
+ await open(page, PROJECT);
+ await shot(page, 'K18', 'architecture-geoeffnet', 'Architecture fuer django-demo, vor dem Wechsel nach Behavior');
+ await series(page, 'K18', 'behavior', () => tab(page, 'behavior').click(), 'Behavior angeklickt');
+ await page.waitForFunction(() => /What can .+ call\?/i.test(document.querySelector('.behavior-heading h2')?.textContent ?? ''), null, { timeout: 30000 }).catch(() => {});
+ await wait(1500);
+ const state = await behaviorState(page);
+ await shot(page, 'K18', 'behavior-fertig', 'Ueberschrift und Auswahlfeld nebeneinander');
+ const name = state.heading.match(/What can (.+) call\?/i)?.[1] ?? '';
+ check('K18', 'Behavior: das Start-Feld zeigt die Operation, die die Ueberschrift nennt',
+ Boolean(name) && state.value !== '' && state.selected.toLowerCase().startsWith(`${name.toLowerCase()} ·`), state);
+}
+
+/* ------------------------------------------------------------------ */
+/* K19: ein gruenes Farbschema in allen Szenen */
+
+async function sceneColors(page, png, id, label) {
+ const image = decodePng(png);
+ const measured = await page.evaluate(() => {
+ const canvas = document.querySelector('.atlas-architecture canvas')?.getBoundingClientRect();
+ const style = (selector, property) => { const element = document.querySelector(selector); return element ? getComputedStyle(element).getPropertyValue(property) : null; };
+ return { canvas: canvas ? { left: canvas.left, top: canvas.top, right: canvas.right, bottom: canvas.bottom } : null,
+ label: style('.architecture-node-label:not(.is-selected), .system-scene-node-label', 'background-color'),
+ labelBorder: style('.architecture-node-label:not(.is-selected), .system-scene-node-label', 'border-top-color'),
+ inspector: style('.spatial-inspector, .behavior-inspector, .system-inspector', 'background-color') };
+ });
+ const background = measured.canvas ? [colorAt(image, measured.canvas.left + 10, measured.canvas.top + 10), colorAt(image, measured.canvas.right - 10, measured.canvas.top + 10)] : [];
+ return { scene: label, background: background.map(hex), green: background.every(([r, g, b]) => g >= b && g >= r), label: measured.label, labelBorder: measured.labelBorder, inspector: measured.inspector, raw: background };
+}
+
+async function k19(page) {
+ await open(page, PROJECT);
+ const scenes = [];
+ const pngs = [];
+ await tab(page, 'overview').click();
+ await sceneSettled(page, '.architecture-node-label');
+ let png = await shot(page, 'K19', 'overview', 'Overview (Referenz)'); pngs.push(png);
+ scenes.push(await sceneColors(page, png, 'K19', 'overview'));
+ await tab(page, 'routes').click(); await wait(6000);
+ png = await shot(page, 'K19', 'routes-service-map', 'Routes, Service map'); pngs.push(png);
+ scenes.push({ ...(await sceneColors(page, png, 'K19', 'service-map')), note: 'ohne Deployment-Dateien keine Szene' });
+ const endpoints = page.getByRole('button', { name: 'Endpoints', exact: true });
+ if (await endpoints.count()) await endpoints.click();
+ await sceneSettled(page, '.architecture-node-label');
+ png = await shot(page, 'K19', 'routes-endpoints', 'Routes, Endpoints'); pngs.push(png);
+ scenes.push(await sceneColors(page, png, 'K19', 'endpoints'));
+ await tab(page, 'hotspots').click();
+ await sceneSettled(page, '.architecture-node-label');
+ png = await shot(page, 'K19', 'hotspots', 'Hotspots'); pngs.push(png);
+ scenes.push(await sceneColors(page, png, 'K19', 'hotspots'));
+ // "Hotspots sind flach": so weit nach unten gedreht wie moeglich bleibt die Karte geneigt, nie eine Linie.
+ const spread = async () => page.evaluate(() => {
+ const ys = [...document.querySelectorAll('.architecture-node-label:not(.is-hidden)')].map((label) => { const box = label.getBoundingClientRect(); return box.top + box.height / 2; });
+ return ys.length > 1 ? Math.max(...ys) - Math.min(...ys) : 0;
+ });
+ const tiltCanvas = await page.locator('.atlas-architecture canvas').first().boundingBox();
+ const spreadBefore = await spread();
+ if (tiltCanvas) {
+ await page.mouse.move(tiltCanvas.x + tiltCanvas.width / 2, tiltCanvas.y + tiltCanvas.height / 2);
+ await page.mouse.down();
+ await page.mouse.move(tiltCanvas.x + tiltCanvas.width / 2, tiltCanvas.y + tiltCanvas.height / 2 - 600, { steps: 20 });
+ await page.mouse.up();
+ await wait(1200);
+ }
+ const spreadAfter = await spread();
+ await shot(page, 'K19', 'hotspots-ganz-gekippt', 'Hotspots nach dem Drehen bis an die untere Grenze');
+ check('K19-tilt', 'Hotspots lassen sich nicht flach auf eine Linie drehen', spreadBefore > 0 && spreadAfter / spreadBefore >= 0.3,
+ { labelSpreadBefore: Math.round(spreadBefore), labelSpreadAfter: Math.round(spreadAfter), ratio: spreadBefore ? Number((spreadAfter / spreadBefore).toFixed(2)) : null });
+ await page.getByRole('button', { name: 'Fit map' }).first().click(); await wait(800);
+ await tab(page, 'structure').click();
+ await sceneSettled(page, '.system-scene-node-label', 40000);
+ png = await shot(page, 'K19', 'system-structure', 'System structure'); pngs.push(png);
+ scenes.push(await sceneColors(page, png, 'K19', 'structure'));
+ await tab(page, 'behavior').click();
+ await sceneSettled(page, '.system-scene-node-label', 40000);
+ png = await shot(page, 'K19', 'behavior', 'Behavior'); pngs.push(png);
+ scenes.push(await sceneColors(page, png, 'K19', 'behavior'));
+ // Alle Ansichten nebeneinander, so wie der Vergleich im Korrekturplan es verlangt.
+ const sheet = await page.context().newPage();
+ await sheet.setViewportSize({ width: 2400, height: 1060 });
+ await sheet.setContent(`<body style="margin:0;background:#000;display:grid;grid-template-columns:repeat(3,800px);gap:4px">${pngs.map((buffer) => `<img style="width:800px" src="data:image/png;base64,${buffer.toString('base64')}">`).join('')}</body>`);
+ await wait(500);
+ await mkdir(join(OUT, 'K19'), { recursive: true });
+ await sheet.screenshot({ path: join(OUT, 'K19', `${TAG}-00-vergleich.png`) });
+ images.set('K19', [{ file: `${TAG}-00-vergleich.png`, note: 'Alle sechs Ansichten nebeneinander: Overview, Service map, Endpoints / Hotspots, System structure, Behavior' }, ...images.get('K19') ?? []]);
+ await sheet.close();
+ const drawn = scenes.filter((scene) => scene.background.length);
+ const reference = drawn[0]?.raw[0];
+ const sameBackground = drawn.every((scene) => scene.raw.every((color) => reference && close(color, reference)));
+ const labels = new Set(drawn.map((scene) => scene.label));
+ check('K19', 'Alle Architecture-Szenen im selben gruenen Schema wie Overview (Hintergrund, Schilder, Inspektor)',
+ drawn.length >= 4 && sameBackground && drawn.every((scene) => scene.green) && labels.size === 1,
+ { scenes: scenes.map(({ raw, ...rest }) => rest), sameBackground, labelBackgrounds: [...labels] });
+}
+
+/* ------------------------------------------------------------------ */
+/* K20: Beschriftungen ohne Ueberdeckung, rechte Spalte im Bereich */
+
+async function k20(page) {
+ await open(page, PROJECT);
+ await tab(page, 'overview').click();
+ await sceneSettled(page, '.architecture-node-label');
+ await shot(page, 'K20', 'overview-wurzel', 'Overview an der Wurzel');
+ const area = page.locator('button.architecture-node-label', { hasText: /^\W*django\s*$/ }).first();
+ await area.click(); await wait(800);
+ const openArea = page.getByRole('button', { name: /Open area/ }).first();
+ await series(page, 'K20', 'django-geoeffnet', async () => { if (await openArea.count()) await openArea.click(); else await area.dblclick(); }, 'Bereich django geoeffnet');
+ const inside = await labelGeometry(page);
+ // Ueberdeckungen haengen vom Zoom ab: zwei Stufen hinaus, dann zwei hinein, jede gemessen.
+ const zoomed = [];
+ const canvasBox = await page.locator('.atlas-architecture canvas').first().boundingBox();
+ for (const [index, delta] of [240, 240, -240, -240, -240].entries()) {
+ if (!canvasBox) break;
+ await page.mouse.move(canvasBox.x + canvasBox.width / 2, canvasBox.y + canvasBox.height / 2);
+ await page.mouse.wheel(0, delta); await wait(700);
+ const geometry = await labelGeometry(page);
+ zoomed.push({ step: index + 1, delta, labels: geometry.labels.length, overlaps: geometry.overlaps.length, outsideCovered: geometry.overlaps.filter((pair) => pair.includes('folder:Outside')).length, overlapping: geometry.overlaps.slice(0, 3) });
+ if (index === 1 || index === 4) await shot(page, 'K20', `django-zoom-${index + 1}`, `Overview in django nach Zoomstufe ${index + 1}`);
+ }
+ await page.getByRole('button', { name: 'Fit map' }).first().click(); await wait(1200);
+ const outside = inside.labels.find((item) => item.kind === 'folder' && /^Outside$/.test(item.text));
+ const outsideCovered = [...inside.overlaps.filter((pair) => pair.includes('folder:Outside')), ...zoomed.flatMap((step) => step.outsideCovered ? [`zoom ${step.step}`] : [])];
+ const inspector = await page.evaluate(() => ({ eyebrow: document.querySelector('.spatial-inspector .spatial-eyebrow')?.textContent?.trim() ?? '',
+ heading: document.querySelector('.spatial-inspector h3')?.textContent?.trim() ?? '',
+ text: document.querySelector('.spatial-inspector')?.textContent?.replace(/\s+/g, ' ').trim().slice(0, 200) ?? '' }));
+ check('K20a', 'Overview in django: Spurlabel "Outside" sichtbar und von keinem Schild verdeckt', Boolean(outside) && outsideCovered.length === 0,
+ { outside: outside ? outside.box : null, covered: outsideCovered });
+ check('K20b', 'Overview in django: rechte Spalte fasst den geoeffneten Bereich zusammen', /^django$/.test(inspector.heading) && /2[.,]?310 files/.test(inspector.text) && !/^Repository$/i.test(inspector.eyebrow), inspector);
+ check('K20-overview', 'Overview in django: keine Beschriftung ueberdeckt eine andere, auch nicht beim Zoomen', inside.overlaps.length === 0 && zoomed.every((step) => step.overlaps === 0), { ...summary(inside), zoomed });
+
+ await series(page, 'K20', 'system-structure', () => tab(page, 'structure').click(), 'System structure geoeffnet');
+ await sceneSettled(page, '.system-scene-node-label', 40000);
+ const structure = await labelGeometry(page);
+ await shot(page, 'K20', 'system-structure-fertig', 'System structure mit Gruppen und Plattennamen');
+ const chipNames = new Set(structure.labels.filter((item) => item.kind === 'chip').map((item) => item.text.toLowerCase()));
+ const doubled = structure.labels.filter((item) => item.kind === 'lane' && (chipNames.has(item.text.toLowerCase()) || (/^repository root$/i.test(item.text) && chipNames.has('(root)'))));
+ check('K20c', 'System structure: ein Name pro Gruppe, keine Ueberdeckung', doubled.length === 0 && structure.overlaps.length === 0,
+ { ...summary(structure), doubled: doubled.map((item) => item.text) });
+
+ await series(page, 'K20', 'hotspots', () => tab(page, 'hotspots').click(), 'Hotspots geoeffnet');
+ await sceneSettled(page, '.architecture-node-label');
+ const hotspots = await labelGeometry(page);
+ await shot(page, 'K20', 'hotspots-fertig', 'Hotspots mit Bereichsnamen unter den Schildern');
+ check('K20d', 'Hotspots: Bereichsnamen und Schilder ueberlagern sich nicht', hotspots.overlaps.length === 0 && hotspots.labels.some((item) => item.kind === 'folder'), summary(hotspots));
+}
+
+/* ------------------------------------------------------------------ */
+/* K21: jeder Aufruf-Kasten hat seinen Namen */
+
+async function journeyLabels(page) {
+ const geometry = await labelGeometry(page);
+ const chips = geometry.labels.filter((item) => item.kind === 'chip');
+ const state = await behaviorState(page);
+ return { state, chips: chips.map((item) => ({ text: item.text, title: item.title, inside: item.inside, truncated: item.truncated })), overlaps: geometry.overlaps };
+}
+
+async function k21(page) {
+ await open(page, PROJECT);
+ await tab(page, 'behavior').click();
+ await sceneSettled(page, '.system-scene-node-label', 40000);
+ await shot(page, 'K21', 'behavior-start', 'Behavior mit der automatisch gewaehlten Operation');
+ let chosen = null;
+ await series(page, 'K21', 'handle-loaddata', async () => { chosen = await selectEntry(page, /^handle · django\/core\/management\/commands\/loaddata\.py$/); }, 'handle · loaddata.py gewaehlt');
+ await page.waitForFunction(() => /What can handle call\?/i.test(document.querySelector('.behavior-heading h2')?.textContent ?? ''), null, { timeout: 30000 }).catch(() => {});
+ await wait(2500);
+ const measured = await journeyLabels(page);
+ await shot(page, 'K21', 'handle-loaddata-fertig', 'Alle Aufruf-Kaesten mit Namen');
+ const named = measured.chips.filter((chip) => chip.text.replace(/^(START|POSSIBLE CALL|HOP \d+)/, '').trim().length > 0);
+ check('K21', 'Behavior handle · loaddata.py: jeder Kasten der Seite zeigt seinen Namen, gekuerzt mit Tooltip statt ausgeblendet',
+ chosen !== null && Number.isFinite(measured.state.sceneNodes) && named.length === measured.state.sceneNodes && measured.chips.every((chip) => chip.inside && chip.title.length > 0) && measured.overlaps.length === 0,
+ { chosen, sceneNodes: measured.state.sceneNodes, labels: measured.chips.length, named: named.length, chips: measured.chips, overlaps: measured.overlaps });
+}
+
+/* ------------------------------------------------------------------ */
+/* K25: Zahlen passen, alle Kaesten der Seite im Bild, Einpassen beim Blaettern */
+
+async function switchProject(page, name) {
+ await page.locator('.atlas-shell details summary', { hasText: PROJECT }).first().click();
+ const entry = page.locator('.atlas-project-results button', { has: page.locator('.atlas-project-result-name', { hasText: new RegExp(`^${name}$`) }) }).first();
+ await entry.waitFor({ timeout: 20000 });
+ await entry.click();
+}
+
+async function k25(page) {
+ // Wie im Handtest: Behavior in django-demo offen, dann der Projektwechsel nach cbm.
+ await open(page, PROJECT);
+ await tab(page, 'behavior').click();
+ await sceneSettled(page, '.system-scene-node-label', 40000);
+ await shot(page, 'K25', 'behavior-django-vor-wechsel', 'Behavior in django-demo vor dem Projektwechsel');
+ await series(page, 'K25', 'behavior-cbm', () => switchProject(page, CONTROL), 'Projektwechsel nach cbm mit offenem Behavior');
+ await page.waitForFunction(() => /What can main call\?/i.test(document.querySelector('.behavior-heading h2')?.textContent ?? ''), null, { timeout: 40000 }).catch(() => {});
+ await sceneSettled(page, '.system-scene-node-label', 40000);
+ const first = await journeyLabels(page);
+ await shot(page, 'K25', 'seite-1', 'Erste Seite der direkten Aufrufe von main');
+ const direct = Number(first.state.navigation.match(/(\d+) direct callees?/)?.[1] ?? NaN);
+ const pageTotal = Number(first.state.pages.match(/of (\d+)/)?.[1] ?? NaN);
+ const explained = /not drawn|beyond the display limit|match the filter/i.test(first.state.pages);
+ const more = page.getByRole('button', { name: /More calls/ }).first();
+ let second = null;
+ if (await more.count() && await more.isEnabled()) {
+ await series(page, 'K25', 'mehr-aufrufe', () => more.click(), 'More calls angeklickt');
+ second = await journeyLabels(page);
+ }
+ const allInside = (reading) => reading && reading.chips.length === reading.state.sceneNodes && reading.chips.every((chip) => chip.inside);
+ check('K25', 'Behavior cbm main: Anzahl direkter Aufrufe und Seitenzaehler stimmen ueberein, alle Kaesten jeder Seite im Bild',
+ Number.isFinite(direct) && (direct === pageTotal || explained) && allInside(first) && (second === null || allInside(second)),
+ { direct, pageTotal, pages: first.state.pages, firstPage: { sceneNodes: first.state.sceneNodes, inside: first.chips.filter((chip) => chip.inside).length, labels: first.chips.map((chip) => chip.text) },
+ secondPage: second ? { pages: second.state.pages, sceneNodes: second.state.sceneNodes, inside: second.chips.filter((chip) => chip.inside).length, labels: second.chips.map((chip) => chip.text) } : null });
+}
+
+/* ------------------------------------------------------------------ */
+/* K22: Service map ohne Deployment-Dateien */
+
+async function k22(page) {
+ await open(page, PROJECT);
+ await series(page, 'K22', 'routes', () => tab(page, 'routes').click(), 'Routes, Service map fuer django-demo');
+ // Die Service map laedt nach; erst ihr eigener Text sagt, ob die Suche nach Compose-Dateien fertig ist.
+ await page.waitForFunction(() => {
+ const map = document.querySelector('.container-map');
+ return Boolean(map) && !/Finding indexed Compose definitions/.test(map.textContent ?? '');
+ }, null, { timeout: 60000 }).catch(() => {});
+ await wait(1000);
+ const text = await page.locator('.container-map').first().innerText().catch(() => '');
+ await shot(page, 'K22', 'service-map-meldung', 'Meldung der Service map');
+ const endpoints = page.getByRole('button', { name: /Show endpoints/ }).first();
+ let switched = false;
+ if (await endpoints.count()) {
+ await endpoints.click(); await wait(2500);
+ switched = await page.getByRole('button', { name: 'Endpoints', exact: true }).first().getAttribute('aria-pressed') === 'true';
+ await shot(page, 'K22', 'endpoints-nach-knopf', 'Nach dem Knopf: Endpoints');
+ }
+ check('K22', 'Service map ohne Deployment-Dateien sagt das klar und fuehrt zu Endpoints, kein Lesefehler',
+ /No Docker Compose deployment files/i.test(text) && !/Could not read/i.test(text) && switched, { message: text.split('\n').find((line) => /deployment|Compose|Could not/i.test(line)) ?? text.slice(0, 160), switched });
+}
+
+/* ------------------------------------------------------------------ */
+/* K23: unterscheidbare Routen-Schilder */
+
+async function k23(page) {
+ await open(page, PROJECT);
+ await tab(page, 'routes').click(); await wait(2000);
+ await page.getByRole('button', { name: 'Endpoints', exact: true }).first().click();
+ await sceneSettled(page, '.architecture-node-label');
+ await shot(page, 'K23', 'endpoints', 'Endpoints gruppiert');
+ // Die Gruppe wie im Handtest waehlen; ist ihr Schild gerade ausgeblendet, ueber "Browse map".
+ const group = page.locator('button.architecture-node-label:not(.is-hidden)', { hasText: /^\/generic-lastmod\s*·\s*2/ }).first();
+ if (await group.count()) await group.click();
+ else {
+ await page.locator('.spatial-node-list summary').first().click();
+ await page.locator('.spatial-node-list button', { hasText: /^\/generic-lastmod · 2/ }).first().click();
+ }
+ await wait(800);
+ await shot(page, 'K23', 'gruppe-gewaehlt', 'Gruppe /generic-lastmod gewaehlt');
+ const show = page.getByRole('button', { name: /Show these 2 routes/ }).first();
+ if (await show.count()) await series(page, 'K23', 'zwei-routen', () => show.click(), 'Show these 2 routes');
+ const geometry = await labelGeometry(page);
+ const routes = geometry.labels.filter((item) => item.kind === 'chip' && /^\W*(…|\/generic-lastmod)/.test(item.text) && !/·\s*2/.test(item.text));
+ const texts = routes.map((item) => item.text);
+ check('K23', 'Gefilterte Routen zeigen das Unterscheidende, voller Pfad im Tooltip',
+ routes.length === 2 && new Set(texts).size === 2 && routes.every((item) => !item.truncated && /\/generic-lastmod\//.test(item.title)),
+ { routes: routes.map((item) => ({ text: item.text, title: item.title.split('\n')[0], truncated: item.truncated })) });
+}
+
+/* ------------------------------------------------------------------ */
+/* K26: gleiche Konsolenmeldungen einmal mit Zaehler */
+
+async function k26(page) {
+ await open(page, CONTROL, 'system');
+ uiLogPosts = [];
+ await page.evaluate((message) => { for (let i = 0; i < 120; i++) console.warn(message); }, THREE_CLOCK);
+ await wait(2500);
+ // Wie beim Schliessen des Tabs: der letzte Stand geht mit "final" hinaus.
+ await page.evaluate(() => { window.dispatchEvent(new Event('pagehide')); });
+ await wait(800);
+ const beacons = await page.evaluate(async () => Promise.all(window.__beacons.filter((item) => item.url.includes('/api/ui-log')).map(async (item) => JSON.parse(await item.data.text()))));
+ const entries = [...uiLogPosts, ...beacons].flatMap((post) => post.entries ?? []).filter((entry) => entry.message === THREE_CLOCK);
+ const counted = entries.map((entry) => entry.detail ?? '').filter(Boolean);
+ check('K26-transport', '120 gleiche Warnungen gehen als Erstmeldung plus Zaehler an /api/ui-log, nicht 120-mal',
+ entries.length > 0 && entries.length <= 4 && counted.some((detail) => /120/.test(detail)), { posted: entries.length, details: counted });
+
+ await page.getByRole('tab', { name: 'Logs' }).click();
+ await page.getByLabel('Log severity').selectOption('warn');
+ await wait(4000);
+ const rows = await page.evaluate(() => [...document.querySelectorAll('.system-log-record')].map((row) => row.textContent ?? ''));
+ const clockRows = rows.filter((row) => row.includes('THREE.THREE.Clock'));
+ const counts = clockRows.map((row) => Number(row.match(/×(\d+)/)?.[1] ?? 1));
+ await shot(page, 'K26', 'system-logs', 'System › Logs, Warnungen und Fehler');
+ await page.evaluate(() => { const log = document.querySelector('.system-log'); if (log) log.scrollTop = log.scrollHeight; });
+ await wait(300);
+ await shot(page, 'K26', 'system-logs-ende', 'System › Logs, Ende der Liste');
+ check('K26-logs', 'System › Logs fasst gleiche Meldungen zu einer Zeile mit Zaehler zusammen',
+ clockRows.length > 0 && clockRows.length <= 3 && counts.some((count) => count > 1), { rows: rows.length, clockRows: clockRows.length, counts });
+}
+
+/* ------------------------------------------------------------------ */
+
+const context = await chromium.launchPersistentContext(PROFILE, {
+ headless: false, viewport: VIEWPORT, deviceScaleFactor: SCALE,
+ args: ['--enable-unsafe-webgpu', '--ignore-gpu-blocklist'],
+});
+await context.addInitScript(() => {
+ try { localStorage.setItem('cbm.workspace.setup', 'done'); } catch { /* ohne Speicher geht es auch */ }
+ // Eine Bake beim Verlassen der Seite umgeht das Routing des Browsers: sie bleibt hier und erreicht den Server nie.
+ window.__beacons = [];
+ navigator.sendBeacon = (url, data) => { window.__beacons.push({ url: String(url), data }); return true; };
+});
+await context.route('**/api/ui-log', async (route) => {
+ if (route.request().method() !== 'POST') return route.continue();
+ try { uiLogPosts.push(route.request().postDataJSON()); } catch { /* eine Bake ohne lesbaren Inhalt */ }
+ return route.fulfill({ status: 200, contentType: 'application/json', body: '{"accepted":0}' });
+});
+const page = context.pages()[0] ?? await context.newPage();
+const pageErrors = [];
+page.on('pageerror', (error) => { pageErrors.push(error.message); console.error(`[pageerror] ${error.message}`); });
+const steps = { K18: k18, K19: k19, K20: k20, K21: k21, K22: k22, K23: k23, K25: k25, K26: k26 };
+// Beschriftungen und Kamera haengen von der Groesse der Zeichenflaeche ab: diese drei auch in der Ansicht des Handtests.
+const bothLayouts = new Set(['K20', 'K21', 'K25']);
+for (const id of ONLY) {
+ for (const name of bothLayouts.has(id) ? ['standard', 'handtest'] : ['standard']) {
+ layout = name;
+ try { await steps[id]?.(page); } catch (error) { check(id, 'Ablauf abgebrochen', false, String(error?.message ?? error)); }
+ }
+ layout = 'standard';
+}
+check('X1', 'Keine Seitenfehler im Lauf', pageErrors.length === 0, { pageErrors });
+await context.close();
+
+for (const [id, list] of images) {
+ const results = checks.filter((item) => item.id.startsWith(id));
+ const lines = [`# ${id} (${TAG})`, '', ...results.map((item) => `- ${item.pass ? 'PASS' : 'FAIL'} ${item.id}: ${item.title}`), '', '| Bild | Zeigt |', '|---|---|',
+ ...list.map((item) => `| ${item.file} | ${item.note} |`), '', '```json', JSON.stringify(results.map((item) => ({ id: item.id, measured: item.measured })), null, 1).slice(0, 6000), '```', ''];
+ await writeFile(join(OUT, id, `index-${TAG}.md`), lines.join('\n'));
+}
+await mkdir(OUT, { recursive: true });
+// Ein Teillauf (--only) ueberschreibt den Bericht des ganzen Laufs nicht.
+const partial = String(arg('only', '')) ? `-${ONLY.join('-')}` : '';
+await writeFile(join(OUT, `report-${TAG}${partial}.json`), JSON.stringify({ origin: ORIGIN, tag: TAG, checks }, null, 2));
+const failed = checks.filter((item) => !item.pass);
+console.log(`${checks.length - failed.length}/${checks.length} bestanden`);
+if (failed.length) process.exitCode = 1;