@xgent-ai/skills 0.7.4 → 0.7.6

package/skills/archify/test/export-cleanup-browser.test.mjs

@@ -1,294 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { execFileSync } from 'node:child_process';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-import { ChromeVisualBrowser, findChrome } from '../bin/visual-check.mjs';
-
-const skillRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-const chrome = process.env.ARCHIFY_CHROME ? findChrome() : null;
-const cases = {
-  architecture: 'web-app.architecture.json', workflow: 'agent-tool-call.workflow.json',
-  sequence: 'cache-miss-request.sequence.json', dataflow: 'product-analytics.dataflow.json',
-  lifecycle: 'agent-run.lifecycle.json',
-};
-
-test('Export cleanup preserves canonical artifacts and live interaction state', {
-  skip: chrome ? false : 'Set ARCHIFY_CHROME to run real-browser export checks.',
-}, async (t) => {
-  const scratch = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-export-cleanup-'));
-  t.after(() => fs.rmSync(scratch, { recursive: true, force: true }));
-  const evidence = process.env.ARCHIFY_EXPORT_EVIDENCE;
-  if (evidence) fs.mkdirSync(evidence, { recursive: true });
-  const records = [];
-  t.after(() => {
-    if (evidence) fs.writeFileSync(path.join(evidence, 'observations.json'), JSON.stringify(records, null, 2) + '\n');
-  });
-  const files = {};
-  for (const [mode, example] of Object.entries(cases)) {
-    const file = path.join(scratch, `${mode}.html`);
-    if (process.env.ARCHIFY_EXPORT_BASELINE_DIR) {
-      fs.copyFileSync(path.join(process.env.ARCHIFY_EXPORT_BASELINE_DIR, `${mode}.html`), file);
-    } else {
-      execFileSync(process.execPath, [path.join(skillRoot, `renderers/${mode}/render-${mode}.mjs`),
-        path.join(skillRoot, 'examples', example), file]);
-    }
-    files[mode] = file;
-  }
-  const browser = new ChromeVisualBrowser(chrome);
-  t.after(() => browser.close());
-  const session = await browser.sessionPromise;
-  const send = (method, params = {}) => browser.cdp.send(method, params, session);
-  await browser.cdp.send('Browser.setDownloadBehavior', { behavior: 'deny' });
-  await send('Page.addScriptToEvaluateOnNewDocument', { source: `window.exportTestErrors = [];
-    addEventListener('error', e => exportTestErrors.push(e.message));
-    addEventListener('unhandledrejection', e => exportTestErrors.push(String(e.reason)));` });
-  async function evaluate(expression, awaitPromise = false) {
-    const result = await send('Runtime.evaluate', { expression, awaitPromise, returnByValue: true });
-    assert.equal(result.exceptionDetails, undefined, result.exceptionDetails?.exception?.description);
-    return result.result?.value;
-  }
-  async function load(file, theme = 'dark', reduced = false) {
-    await send('Emulation.setDeviceMetricsOverride', { width: 1440, height: 900, deviceScaleFactor: 1, mobile: false });
-    await send('Emulation.setEmulatedMedia', { features: [
-      { name: 'prefers-color-scheme', value: theme },
-      { name: 'prefers-reduced-motion', value: reduced ? 'reduce' : 'no-preference' },
-    ] });
-    const loaded = browser.cdp.waitFor('Page.loadEventFired', session);
-    const result = await send('Page.navigate', { url: pathToFileURL(file).href + `?theme=${theme}` });
-    assert.equal(result.errorText, undefined);
-    await loaded;
-    await evaluate('(async () => { await document.fonts.ready; await Archify.readerLayout.whenStable(); await Archify.viewerChromeLayout.whenStable(); })()', true);
-    assert.deepEqual(await evaluate('exportTestErrors'), []);
-  }
-  async function exported(label, action = '') {
-    // Capture the SVG synchronously at the public export call. Timers and
-    // animation frames cannot explain away a live-DOM mutation by cleanup.
-    const value = await evaluate(`(async () => {
-      ${action}
-      const svg = document.querySelector('.diagram-container > svg');
-      const before = svg.outerHTML;
-      const original = URL.createObjectURL;
-      let blob;
-      URL.createObjectURL = function (value) {
-        if (value.type.startsWith('image/svg+xml')) blob = value;
-        return original.call(URL, value);
-      };
-      let after;
-      try {
-        const pending = Archify.exportMenu.run('svg');
-        after = svg.outerHTML;
-        await pending;
-      } finally { URL.createObjectURL = original; }
-      if (!blob) throw new Error('Export did not produce SVG');
-      const text = await blob.text();
-      const root = new DOMParser().parseFromString(text, 'image/svg+xml').documentElement;
-      const transient = root.querySelectorAll('[data-focus-selected], [data-reach-match], [data-lens-selected], [data-intent-trace-overlay], [data-route-probe-overlay], [data-route-journey-overlay], [data-story-overlay], [data-chapter-preview-role], [data-source-evidence-beacon], [data-relationship-hit-overlay]');
-      return { text, liveUnchanged: before === after, transientCount: transient.length,
-        geometry: root.getAttribute('viewBox'), liveGeometry: svg.getAttribute('viewBox'),
-        rootClean: !['data-view-scale', 'data-focus-active', 'data-reach-active', 'data-route-active', 'data-lens-active', 'data-story-active', 'data-share-route', 'data-share-reach'].some(a => root.hasAttribute(a)),
-        resources: performance.getEntriesByType('resource').map(e => e.name).filter(n => /^https?:/.test(n)), errors: exportTestErrors };
-    })()`, true);
-    assert.equal(value.liveUnchanged, true, `${label}: live SVG changed`);
-    assert.equal(value.transientCount, 0, label);
-    assert.equal(value.rootClean, true, label);
-    assert.equal(value.geometry, value.liveGeometry, label);
-    assert.deepEqual(value.resources, [], label);
-    assert.deepEqual(value.errors, [], label);
-    if (evidence) fs.writeFileSync(path.join(evidence, `${label}.svg`), value.text);
-    const { text, ...observation } = value;
-    records.push({ label, ...observation });
-    return text;
-  }
-
-  await t.test('five modes export standalone SVG in both themes and reduced motion', async () => {
-    for (const [mode, file] of Object.entries(files)) {
-      for (const theme of ['dark', 'light']) {
-        await load(file, theme, theme === 'light');
-        await exported(`${mode}-${theme}`);
-      }
-    }
-  });
-
-  await t.test('real zoom, focus, preview, lens, story and route actions leave exports clean', async () => {
-    await load(files.architecture);
-    const pristine = await exported('interaction-pristine');
-    const actions = {
-      zoom: `Archify.view.zoomIn();`,
-      focus: `if (!Archify.focus.set('api', { toggle: false, updateUrl: false })) throw new Error('focus failed');`,
-      preview: `if (!Archify.intentTrace.show('api')) throw new Error('preview failed');`,
-      lens: `Archify.semanticLens.select('backend'); if (!Archify.semanticLens.active()) throw new Error('lens failed');`,
-      story: `Archify.guidedViews.activate('request-path', { updateUrl: false }); Archify.guidedViews.playCurrent(); if (!Archify.guidedViews.isPlaying()) throw new Error('story failed');`,
-      route: `Archify.routeProbe.begin({ source: 'users', focusNode: false }); if (!Archify.routeProbe.choose('db', { updateUrl: false })) throw new Error('route failed');`,
-      upstream: `Archify.focus.set('api', { toggle: false, updateUrl: false }); if (!Archify.focus.reach('upstream', { toggle: false, updateUrl: false, reveal: false })) throw new Error('reach failed');`,
-      downstream: `Archify.focus.set('api', { toggle: false, updateUrl: false }); if (!Archify.focus.reach('downstream', { toggle: false, updateUrl: false, reveal: false })) throw new Error('reach failed');`,
-    };
-    for (const [name, action] of Object.entries(actions)) {
-      await load(files.architecture);
-      const text = await exported(`active-${name}`, action);
-      // Existing style.removeProperty calls can leave empty style attributes.
-      // Apart from that inert serialization detail, compare the entire SVG.
-      assert.equal(text.replace(/ style=""/g, ''), pristine.replace(/ style=""/g, ''), name);
-    }
-  });
-
-  await t.test('raster and share-card exports preserve dimensions and current theme', async () => {
-    for (const theme of ['dark', 'light']) {
-      await load(files.architecture, theme, theme === 'light');
-      for (const format of ['png', 'jpeg', 'webp', 'share-card']) {
-        const result = await evaluate(`(async () => {
-          Archify.focus.set('api', { toggle: false, updateUrl: false });
-          const format = ${JSON.stringify(format)};
-          const original = URL.createObjectURL;
-          let blob;
-          URL.createObjectURL = function (value) {
-            if (value.type.startsWith('image/') && value.type !== 'image/svg+xml') blob = value;
-            return original.call(URL, value);
-          };
-          try {
-            if (format === 'share-card') blob = await Archify.exportMenu.shareCard();
-            else await Archify.exportMenu.run(format);
-          } finally { URL.createObjectURL = original; }
-          if (!blob) throw new Error('Missing raster export');
-          const bitmap = await createImageBitmap(blob);
-          const dimensions = [bitmap.width, bitmap.height];
-          bitmap.close();
-          const svg = document.querySelector('.diagram-container > svg');
-          const expected = format === 'share-card' ? [1200, 630] : [svg.viewBox.baseVal.width * 4, svg.viewBox.baseVal.height * 4];
-          const data = await new Promise((resolve, reject) => {
-            const reader = new FileReader();
-            reader.onload = () => resolve(reader.result.split(',')[1]);
-            reader.onerror = reject;
-            reader.readAsDataURL(blob);
-          });
-          return { data, dimensions, expected, type: blob.type, errors: exportTestErrors };
-        })()`, true);
-        assert.deepEqual(result.dimensions, result.expected);
-        assert.equal(result.type, format === 'share-card' ? 'image/png' : `image/${format}`);
-        assert.deepEqual(result.errors, []);
-        const label = `${theme}-${format}`;
-        if (evidence) fs.writeFileSync(path.join(evidence, `${label}.${format === 'share-card' ? 'png' : format}`), Buffer.from(result.data, 'base64'));
-        const { data, ...observation } = result;
-        records.push({ label, ...observation });
-      }
-    }
-  });
-
-  // Private checks supplement the real public exports. The hook exists only in
-  // this disposable test artifact; production receives no testing interface.
-  const html = fs.readFileSync(files.architecture, 'utf8');
-  let cleanup = html.match(/function cleanExportClone\(clone\) \{[\s\S]*?\n      \}/)?.[0];
-  if (!cleanup && process.env.ARCHIFY_EXPORT_BASELINE_DIR) {
-    const start = html.indexOf('        // View transforms and neighborhood focus');
-    const end = html.indexOf('        var vb = svg.viewBox.baseVal;', start);
-    assert.ok(start >= 0 && end > start);
-    cleanup = `function cleanExportClone(clone) {\n${html.slice(start, end)}return canonicalStateClean;\n}`;
-  }
-  assert.ok(cleanup, 'the extracted cleanup implementation is present');
-  const cleanupReference = html.includes('function cleanExportClone(clone)') ? 'cleanExportClone' : cleanup;
-  const hooked = html.replace('      function download(blob, filename) {',
-    `      window.exportCleanupTest = { serialize: serializeSvg, clean: ${cleanupReference} };\n      function download(blob, filename) {`);
-  assert.notEqual(hooked, html);
-  const privateFile = path.join(scratch, 'private.html');
-  fs.writeFileSync(privateFile, hooked);
-
-  await t.test('clone restoration, preservation and repeated cleanup are independent of live DOM', async () => {
-    await load(privateFile);
-    const result = await evaluate(`(() => {
-      const svg = document.querySelector('.diagram-container > svg');
-      const before = svg.outerHTML;
-      const clone = svg.cloneNode(true);
-      // A small authored fragment is the independent preservation oracle.
-      const group = document.createElementNS(svg.namespaceURI, 'g');
-      group.setAttribute('id', 'authored-preservation');
-      group.setAttribute('data-node-id', 'authored');
-      group.setAttribute('data-animate', 'node');
-      group.innerHTML = '<path d="M 0 0 L 10 20" transform="translate(3 4)"/><text>Keep 中文 &amp; text</text>';
-      clone.appendChild(group);
-      const authored = group.outerHTML;
-      const labels = ['original', '', null].map((value, i) => {
-        const node = document.createElementNS(svg.namespaceURI, 'g');
-        node.setAttribute('id', 'restore-' + i);
-        node.setAttribute('aria-label', 'runtime label');
-        node.setAttribute('data-source-evidence-count', '2');
-        if (value !== null) node.setAttribute('data-source-evidence-original-label', value);
-        clone.appendChild(node);
-        return node;
-      });
-      clone.setAttribute('data-share-route', 'true');
-      clone.setAttribute('data-share-reach', 'upstream');
-      group.setAttribute('data-share-route-match', '');
-      group.setAttribute('data-share-reach-match', '');
-      const clean = exportCleanupTest.clean(clone);
-      const once = clone.outerHTML;
-      const twiceClean = exportCleanupTest.clean(clone);
-      const empty = document.createElementNS(svg.namespaceURI, 'svg');
-      empty.setAttribute('viewBox', '0 0 100 50');
-      const emptyBefore = empty.outerHTML;
-      const emptyClean = exportCleanupTest.clean(empty);
-      const orphan = document.createElementNS(svg.namespaceURI, 'g');
-      orphan.setAttribute('data-story-carrier-token', 'true');
-      const residual = empty.cloneNode(true);
-      residual.appendChild(orphan);
-      const residualClean = exportCleanupTest.clean(residual);
-      return { clean, twiceClean, unchanged: before === svg.outerHTML, idempotent: once === clone.outerHTML,
-        authored: group.outerHTML === authored, labels: labels.map(n => n.getAttribute('aria-label')),
-        restorationRecords: clone.querySelectorAll('[data-source-evidence-count], [data-source-evidence-original-label]').length,
-        shares: clone.hasAttribute('data-share-route') || clone.hasAttribute('data-share-reach'),
-        residualClean, emptyClean, emptyUnchanged: emptyBefore === empty.outerHTML };
-    })()`);
-    assert.deepEqual(result, { clean: true, twiceClean: true, unchanged: true, idempotent: true,
-      authored: true, labels: ['original', null, null], restorationRecords: 0, shares: false,
-      residualClean: false, emptyClean: true, emptyUnchanged: true });
-    records.push({ label: 'restoration', ...result });
-  });
-
-  await t.test('share decoration follows cleanup and preserves snapshot rejection behavior', async () => {
-    for (const variant of ['route', 'upstream', 'downstream']) {
-      await load(privateFile);
-      const result = await evaluate(`(() => {
-        const variant = ${JSON.stringify(variant)};
-        let snapshot;
-        if (variant === 'route') {
-          Archify.routeProbe.begin({ source: 'users', focusNode: false });
-          Archify.routeProbe.choose('db', { updateUrl: false });
-          snapshot = Archify.routeProbe.exportSnapshot();
-        } else {
-          Archify.focus.set('api', { toggle: false, updateUrl: false });
-          Archify.focus.reach(variant, { toggle: false, updateUrl: false, reveal: false });
-          snapshot = Archify.focus.reachabilitySnapshot();
-        }
-        if (!snapshot) throw new Error('missing ' + variant + ' snapshot');
-        const key = variant === 'route' ? 'routeSnapshot' : 'reachSnapshot';
-        const field = variant === 'route' ? 'routeStateClean' : 'reachStateClean';
-        const svg = document.querySelector('.diagram-container > svg');
-        const before = svg.outerHTML;
-        const data = exportCleanupTest.serialize(1, { [key]: snapshot });
-        const rejected = exportCleanupTest.serialize(1, { [key]: { ...snapshot, nodeIds: [] } });
-        const viewBox = svg.getAttribute('viewBox');
-        svg.setAttribute('viewBox', '0 0 0 0');
-        const invalidDimensions = exportCleanupTest.serialize(1, { [key]: snapshot });
-        svg.setAttribute('viewBox', viewBox);
-        const root = new DOMParser().parseFromString(data.svgString, 'image/svg+xml').documentElement;
-        return { text: data.svgString, canonical: data.canonicalStateClean, accepted: data[field],
-          rejected: rejected[field], invalidDimensions: invalidDimensions[field], unchanged: before === svg.outerHTML,
-          route: root.hasAttribute('data-share-route'), reach: root.getAttribute('data-share-reach'),
-          ids: [...root.querySelectorAll('[data-share-route-match][data-node-id], [data-share-reach-match][data-node-id]')].map(n => n.getAttribute('data-node-id')).sort(),
-          expectedIds: snapshot.nodeIds.slice().sort() };
-      })()`);
-      assert.equal(result.canonical, true);
-      assert.equal(result.accepted, true);
-      assert.equal(result.rejected, false);
-      assert.equal(result.invalidDimensions, false);
-      assert.equal(result.unchanged, true);
-      assert.equal(result.route, variant === 'route');
-      assert.equal(result.reach, variant === 'route' ? null : variant);
-      assert.deepEqual(result.ids, result.expectedIds);
-      if (evidence) fs.writeFileSync(path.join(evidence, `share-${variant}.svg`), result.text);
-      const { text, ...observation } = result;
-      records.push({ label: `share-${variant}`, ...observation });
-    }
-  });
-});

package/skills/archify/test/finder-browser.test.mjs

@@ -1,274 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { execFileSync } from 'node:child_process';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-import { ChromeVisualBrowser, findChrome } from '../bin/visual-check.mjs';
-import { createViewerClick } from './helpers/viewer-click.mjs';
-
-const skillRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-const chrome = process.env.ARCHIFY_CHROME ? findChrome() : null;
-
-test('Finder preserves search, keyboard, contextual Route selection and cleanup', {
-  skip: chrome ? false : 'Set ARCHIFY_CHROME to run real-browser Finder checks.',
-}, async (t) => {
-  const scratch = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-finder-browser-'));
-  t.after(() => fs.rmSync(scratch, { recursive: true, force: true }));
-  const evidence = process.env.ARCHIFY_FINDER_EVIDENCE;
-  if (evidence) fs.mkdirSync(evidence, { recursive: true });
-  const records = [];
-  t.after(() => {
-    if (evidence) fs.writeFileSync(path.join(evidence, 'observations.json'), JSON.stringify(records, null, 2) + '\n');
-  });
-  const cases = {
-    architecture: 'web-app.architecture.json', workflow: 'agent-tool-call.workflow.json',
-    sequence: 'cache-miss-request.sequence.json', dataflow: 'product-analytics.dataflow.json',
-    lifecycle: 'agent-run.lifecycle.json',
-  };
-  const files = {};
-  for (const [mode, example] of Object.entries(cases)) {
-    files[mode] = path.join(scratch, mode + '.html');
-    execFileSync(process.execPath, [path.join(skillRoot, `renderers/${mode}/render-${mode}.mjs`),
-      path.join(skillRoot, 'examples', example), files[mode]]);
-  }
-  // A controlled metadata fixture exercises the Finder's input boundary;
-  // repository verification and brand rendering have their own tests.
-  files.metadata = path.join(scratch, 'metadata.html');
-  const metadataSource = fs.readFileSync(files.architecture, 'utf8');
-  assert.ok(metadataSource.includes('    Archify.finder = (function () {'), 'Finder fixture anchor');
-  fs.writeFileSync(files.metadata, metadataSource.replace(
-    '    Archify.finder = (function () {', `
-    document.querySelector('[data-node-id="api"]').setAttribute('data-node-brand', 'finder-brand-token');
-    var finderOriginalSources = Archify.sourceEvidence.node;
-    Archify.sourceEvidence.node = function (id) {
-      return id === 'api' ? [{path:'src/finder-proof.js',label:'Finder proof',line:12,endLine:18}] : finderOriginalSources(id);
-    };
-    Archify.finder = (function () {`));
-  const browser = new ChromeVisualBrowser(chrome);
-  t.after(() => browser.close());
-  const session = await browser.sessionPromise;
-  await browser.cdp.send('Browser.setDownloadBehavior', { behavior: 'deny' });
-  const send = (method, params = {}) => browser.cdp.send(method, params, session);
-  // Match the focused-page setup used by the WebM browser harness so that
-  // programmatic SVG focus also dispatches native focusin/focusout events.
-  await send('Emulation.setFocusEmulationEnabled', { enabled: true });
-  async function run(expression) {
-    const result = await send('Runtime.evaluate', { expression, awaitPromise: true, returnByValue: true });
-    assert.equal(result.exceptionDetails, undefined, result.exceptionDetails?.exception?.description);
-    return result.result?.value;
-  }
-  const click = await createViewerClick({ send, run, timeout: 10000 });
-  await send('Page.addScriptToEvaluateOnNewDocument', { source: `
-    window.finderErrors = [];
-    addEventListener('error', e => finderErrors.push(e.message));
-    addEventListener('unhandledrejection', e => finderErrors.push(String(e.reason)));
-    window.finderWait = (predicate, description = 'Finder observation') => new Promise((resolve, reject) => {
-      const start = performance.now();
-      function sample() {
-        if (predicate()) return resolve();
-        if (performance.now()-start > 10000) return reject(new Error(description + ' timed out; open=' + Archify.finder.isOpen() + ', active=' + document.activeElement.id));
-        requestAnimationFrame(sample);
-      }
-      requestAnimationFrame(sample);
-    });
-  ` });
-  async function load(mode = 'architecture', { theme = 'dark', width = 1440, height = 900, reduced = false, query = '' } = {}) {
-    await send('Input.dispatchMouseEvent', { type: 'mouseMoved', x: 0, y: 0 });
-    await send('Emulation.setDeviceMetricsOverride', { width, height, deviceScaleFactor: 1, mobile: false });
-    await send('Emulation.setEmulatedMedia', { media: '', features: [
-      { name: 'prefers-reduced-motion', value: reduced ? 'reduce' : 'no-preference' },
-    ] });
-    const loaded = browser.cdp.waitFor('Page.loadEventFired', session);
-    await send('Page.navigate', { url: pathToFileURL(files[mode]).href + `?theme=${theme}${query}` });
-    await loaded;
-    await run('document.fonts.ready');
-    await run('Archify.viewerChromeLayout.whenStable()');
-  }
-  async function key(key, code, windowsVirtualKeyCode) {
-    await send('Input.dispatchKeyEvent', { type: 'keyDown', key, code, windowsVirtualKeyCode });
-    await send('Input.dispatchKeyEvent', { type: 'keyUp', key, code, windowsVirtualKeyCode });
-  }
-  async function opened() {
-    await run(`finderWait(() => Archify.finder.isOpen(), 'Finder panel opening')`);
-    await run(`finderWait(() => document.activeElement.id === 'node-finder-input', 'Finder input focus')`);
-  }
-  async function search(text) {
-    await run(`document.getElementById('node-finder-input').select()`);
-    await send('Input.insertText', { text });
-  }
-  async function snapshot(scenario) {
-    const value = await run(`(() => {
-      const panel=document.getElementById('node-finder'), input=document.getElementById('node-finder-input');
-      return {open:Archify.finder.isOpen(), context:Archify.finder.context(), count:Archify.finder.count,
-        expanded:document.getElementById('btn-node-finder').getAttribute('aria-expanded'),
-        panelContext:panel.getAttribute('data-context'), title:document.getElementById('node-finder-title').textContent,
-        query:input.value, placeholder:input.placeholder, empty:document.getElementById('node-finder-empty').hidden,
-        status:document.getElementById('node-finder-status').textContent,
-        results:[...panel.querySelectorAll('.node-finder-result')].map(el=>({id:el.dataset.nodeId,badge:el.querySelector('em').textContent,aria:el.getAttribute('aria-label')})),
-        activeId:document.activeElement.id, activeNode:document.activeElement.getAttribute('data-node-id'),
-        focus:Archify.focus.active(), route:Archify.routeProbe.active(),
-        routeFinder:document.getElementById('route-probe').getAttribute('data-finder-open'),
-        errors:finderErrors,
-        external:performance.getEntriesByType('resource').map(e=>e.name).filter(n=>/^https?:/.test(n))};
-    })()`);
-    assert.deepEqual(value.errors, [], scenario); assert.deepEqual(value.external, [], scenario);
-    records.push({ scenario, ...value });
-    return value;
-  }
-  const ids = state => state.results.map(item => item.id);
-
-  await t.test('five modes initialize one index and no external resources', async () => {
-    for (const mode of Object.keys(cases)) {
-      await load(mode);
-      const state = await snapshot(mode + '-initial');
-      assert.equal(state.open, false); assert.equal(state.count, state.results.length);
-      assert.equal(state.count, await run(`document.querySelectorAll('.diagram-container svg [data-node-id]').length`));
-      assert.equal(new Set(ids(state)).size, state.count);
-      // One full open/close cycle covers the shared controller; retain
-      // initialization and index checks for all five renderer inputs.
-      if (mode === 'architecture') {
-        await click('#btn-node-finder'); await opened();
-        assert.equal((await snapshot(mode + '-open')).expanded, 'true');
-        await key('Escape', 'Escape', 27);
-        assert.equal((await snapshot(mode + '-closed')).activeId, 'btn-node-finder');
-      }
-    }
-  });
-
-  await t.test('search normalizes queries and preserves contextual lists and retained context', async () => {
-    await load('metadata'); await click('#btn-node-finder'); await opened();
-    for (const query of ['  API SERVER  ', 'finder-brand-token', 'src/finder-proof.js']) {
-      await search(query); const state = await snapshot('query-' + query.trim());
-      assert.deepEqual(ids(state), ['api']); assert.equal(state.empty, true);
-      assert.match(state.status, /1/);
-    }
-    await search('no-matching-node');
-    const empty = await snapshot('query-empty'); assert.deepEqual(ids(empty), []); assert.equal(empty.empty, false);
-    await key('Enter', 'Enter', 13); assert.equal(await run('Archify.finder.isOpen()'), true);
-    await run(`Archify.finder.open({context:{kind:'fixture',allowedIds:['db','api'],badges:{api:'custom badge'}}})`); await opened();
-    const restricted = await snapshot('restricted');
-    assert.deepEqual(ids(restricted), ['api', 'db']); assert.equal(restricted.results[0].badge, 'custom badge');
-    await run(`Archify.finder.close()`);
-    const closed = await snapshot('retained-context');
-    assert.equal(closed.context, 'fixture'); assert.deepEqual(closed.results, restricted.results);
-    await run(`Archify.finder.open({context:{allowedIds:[]}})`); await opened();
-    assert.deepEqual(ids(await snapshot('no-allowed-items')), []);
-    assert.equal(await run(`Archify.finder.select('missing')`), false);
-    // Filtering is a list contract; the public select method uses all items.
-    assert.equal(await run(`Archify.finder.select('api')`), true);
-    assert.equal(await run('Archify.focus.active()'), 'api');
-    await run('Archify.finder.open()'); await opened();
-    const reset = await snapshot('default-restored'); assert.equal(reset.context, 'focus'); assert.equal(reset.results.length, reset.count);
-  });
-
-  await t.test('trusted keyboard navigation, selection and Escape preserve focus boundaries', async () => {
-    await load();
-    await key('/', 'Slash', 191); await opened();
-    await key('ArrowDown', 'ArrowDown', 40);
-    const first = await snapshot('keyboard-first'); assert.equal(first.activeNode, first.results[0].id);
-    await key('ArrowUp', 'ArrowUp', 38);
-    assert.equal((await snapshot('keyboard-wrap')).activeNode, first.results.at(-1).id);
-    await key('Home', 'Home', 36); assert.equal((await snapshot('keyboard-home')).activeNode, first.results[0].id);
-    await key('End', 'End', 35); assert.equal((await snapshot('keyboard-end')).activeNode, first.results.at(-1).id);
-    await key('Escape', 'Escape', 27);
-    assert.equal((await snapshot('keyboard-escape')).activeId, 'btn-node-finder');
-    await run(`Archify.guidedViews.activate('request-path')`);
-    await run(`finderWait(() => !Archify.guidedViews.handoff())`);
-    await key('/', 'Slash', 191); await opened(); await search('API Server');
-    // Slash in an input must not reopen the panel and erase the query.
-    await key('/', 'Slash', 191); assert.equal(await run(`document.getElementById('node-finder-input').value`), 'API Server');
-    await key('Enter', 'Enter', 13);
-    await run(`finderWait(() => !document.querySelector('.diagram-container').hasAttribute('data-camera-transaction'))`);
-    const selected = await snapshot('normal-selection');
-    assert.equal(selected.open, false); assert.equal(selected.focus, 'api'); assert.equal(selected.activeNode, 'api');
-    assert.equal(await run('Archify.guidedViews.active()'), null);
-    assert.match(await run('location.hash'), /focus=api/);
-    assert.equal(await run(`(() => {const n=document.querySelector('.diagram-container svg [data-node-id="api"]').getBoundingClientRect(),s=Archify.viewerChromeLayout.stageRect();return n.right>s.left&&n.left<s.right&&n.bottom>s.top&&n.top<s.bottom;})()`), true);
-  });
-
-  await t.test('real Route controls select source and target; cancellation restores Route focus', async () => {
-    await load(); await click('#btn-route-probe'); await click('#route-probe-find'); await opened();
-    let state = await snapshot('route-source');
-    assert.equal(state.context, 'route-source'); assert.equal(state.routeFinder, 'true');
-    assert.ok(ids(state).includes('users')); assert.ok(!ids(state).includes('db'));
-    await key('Escape', 'Escape', 27);
-    state = await snapshot('route-source-cancel'); assert.equal(state.route, 'source'); assert.equal(state.routeFinder, null); assert.equal(state.activeId, 'route-probe-find');
-    await click('#route-probe-find'); await opened(); await search('Users');
-    await click('.node-finder-result[data-node-id="users"]');
-    state = await snapshot('route-source-selected'); assert.equal(state.route, 'target'); assert.equal(state.open, false); assert.equal(state.routeFinder, null);
-    await click('#route-probe-find'); await opened();
-    state = await snapshot('route-target'); assert.equal(state.context, 'route-target');
-    assert.ok(ids(state).includes('db')); assert.ok(!ids(state).includes('users')); assert.ok(!ids(state).includes('auth'));
-    assert.match(state.results.find(item => item.id === 'db').badge, /4/);
-    assert.equal(await run(`Archify.finder.select('auth')`), false);
-    assert.equal(await run('Archify.finder.isOpen()'), true);
-    await key('Escape', 'Escape', 27);
-    assert.equal((await snapshot('route-target-cancel')).activeId, 'route-probe-find');
-    await click('#route-probe-find'); await opened(); await search('PostgreSQL');
-    await key('Enter', 'Enter', 13);
-    state = await snapshot('route-result'); assert.equal(state.route, 'result'); assert.equal(state.routeFinder, null); assert.equal(state.open, false);
-    const result = await run('Archify.routeProbe.result()');
-    assert.deepEqual(result.nodes, ['users', 'cdn', 'lb', 'api', 'db']); assert.equal(result.hops, 4);
-    // A sink is allowed by Route's public API even though the source picker
-    // filters it out. Its actual target context must render an empty list.
-    await run(`Archify.routeProbe.begin({source:'db'})`);
-    await click('#route-probe-find'); await opened();
-    state = await snapshot('route-empty-target');
-    assert.equal(state.context, 'route-target'); assert.deepEqual(ids(state), []); assert.equal(state.empty, false);
-    await key('Enter', 'Enter', 13); assert.equal(await run('Archify.routeProbe.active()'), 'target');
-    await key('Escape', 'Escape', 27);
-    await click('#route-probe-clear'); await key('/', 'Slash', 191); await opened();
-    assert.equal((await snapshot('route-cleared-default')).context, 'focus');
-  });
-
-  await t.test('panel coordination, outside clicks, repeated close and embed retain baseline semantics', async () => {
-    await load();
-    await run('Archify.exportMenu.open(); Archify.finder.open()'); await opened();
-    assert.equal(await run('Archify.exportMenu.isOpen()'), false);
-    await run('Archify.semanticLens.open(); Archify.finder.open()'); await opened();
-    assert.equal(await run('Archify.semanticLens.isOpen()'), false);
-    await run(`Archify.finder.close(); document.querySelector('[data-legend-kind][role="button"]').focus()`);
-    assert.equal(await run(`document.querySelector('.diagram-container > svg').hasAttribute('data-legend-preview-active')`), true);
-    await run('Archify.finder.open()'); await opened();
-    assert.equal(await run(`document.querySelector('.diagram-container > svg').hasAttribute('data-legend-preview-active')`), false);
-    await click('#btn-node-finder'); assert.equal(await run('Archify.finder.isOpen()'), false);
-    await click('#btn-node-finder'); await opened();
-    await click('h1'); assert.equal(await run('Archify.finder.isOpen()'), false);
-    const rapid = await run(`(() => {Archify.finder.open(); const a=Archify.finder.close({restoreFocus:false}); const b=Archify.finder.close({restoreFocus:false}); return {a:a===undefined,b:b===undefined,open:Archify.finder.isOpen()};})()`);
-    assert.deepEqual(rapid, { a: true, b: true, open: false });
-    await run('new Promise(resolve => requestAnimationFrame(resolve))');
-    await snapshot('rapid-close');
-    await load('architecture', { query: '&embed=1' });
-    assert.equal(await run('Archify.finder.open()'), false); assert.equal((await snapshot('embed')).open, false);
-  });
-
-  await t.test('themes, constrained viewport, reduced motion and exported SVG', async () => {
-    for (const theme of ['dark', 'light']) {
-      await load('architecture', { theme, width: 640, height: 600, reduced: true });
-      await click('#btn-node-finder'); await opened();
-      const layout = await run(`(() => {const p=document.getElementById('node-finder').getBoundingClientRect(),r=document.getElementById('node-finder-results'); return {visible:p.width>0&&p.height>0,within:p.left>=-1&&p.right<=innerWidth+1&&p.top>=-1&&p.bottom<=innerHeight+1,scroll:getComputedStyle(r).overflowY};})()`);
-      assert.equal(layout.visible, true); assert.equal(layout.within, true); assert.match(layout.scroll, /auto|scroll/);
-      await snapshot('constrained-' + theme);
-      if (evidence) {
-        await run(`Promise.all(document.querySelector('.node-finder-search').getAnimations({subtree:true}).map(animation=>animation.finished.catch(()=>{})))`);
-        await run('new Promise(resolve=>requestAnimationFrame(()=>requestAnimationFrame(resolve)))');
-        const shot = await send('Page.captureScreenshot', { format: 'png' });
-        fs.writeFileSync(path.join(evidence, theme + '.png'), Buffer.from(shot.data, 'base64'));
-      }
-      await search('API Server'); await key('Enter', 'Enter', 13);
-      await run(`finderWait(() => !document.querySelector('.diagram-container').hasAttribute('data-camera-transaction'))`);
-      assert.equal(await run('Archify.focus.active()'), 'api');
-      const exported = await run(`(async () => {
-        const original=URL.createObjectURL; let blob;
-        URL.createObjectURL=function(value){if(value.type.startsWith('image/svg+xml'))blob=value;return original.call(URL,value);};
-        try {await Archify.exportMenu.run('svg');} finally {URL.createObjectURL=original;}
-        const text=await blob.text(),root=new DOMParser().parseFromString(text,'image/svg+xml').documentElement;
-        return {clean:!root.querySelector('[id^="node-finder"],.node-finder-result,[data-focus-selected]')&&!root.hasAttribute('data-focus-active'),geometry:root.getAttribute('viewBox')===document.querySelector('.diagram-container > svg').getAttribute('viewBox')};
-      })()`);
-      assert.deepEqual(exported, { clean: true, geometry: true });
-      await snapshot('export-' + theme);
-    }
-  });
-});