Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
import assert from 'node:assert/strict';
import fs from 'node:fs';
import path from 'node:path';
import test from 'node:test';
import { ChromeVisualBrowser, findChrome } from '../archify/bin/visual-check.mjs';
import { git, fixture, run } from './helpers/repository-evidence-fixture.mjs';
test('browser renders local-only sources as searchable text and web sources as links', {
skip: process.env.ARCHIFY_CHROME ? false : 'Set ARCHIFY_CHROME to run evidence browser checks.',
timeout: 60000,
}, async () => {
const data = fixture();
const browser = new ChromeVisualBrowser(findChrome());
try {
for (const mode of ['github', 'gitee', 'gitlab', 'local-only']) {
const local = mode === 'local-only';
const url = local ? 'http://git.internal/Team/repo' : `https://${mode}.com/example/evidence-repo`;
data.diagram.meta.repository = { url, revision: data.revision, ...(local ? { link_mode: mode } : {}) };
git(data.root, 'remote', 'set-url', 'origin', url);
fs.writeFileSync(data.input, JSON.stringify(data.diagram));
const artifactPath = path.join(data.root, `${mode}.html`);
const result = run(['deliver', 'architecture', data.input, artifactPath, '--repo-root', data.root, '--json']);
assert.equal(result.status, 0, result.stderr || result.stdout);
for (const theme of ['light', 'dark']) {
await browser.inspect({ artifactPath, width: 1440, height: 900, theme });
const sessionId = await browser.sessionPromise;
const response = await browser.cdp.send('Runtime.evaluate', {
expression: `(() => {
document.querySelector('[data-node-id="users"]').dispatchEvent(new MouseEvent('click', { bubbles: true }));
const panel = document.getElementById('focus-evidence');
const rows = [...panel.querySelectorAll('.semantic-passport-source')];
const input = document.getElementById('node-finder-input');
input.value = 'src/router.js';
input.dispatchEvent(new Event('input', { bubbles: true }));
return {
visible: !panel.hidden,
links: rows.filter(row => row.tagName === 'A').map(row => row.getAttribute('href')),
paths: rows.map(row => row.querySelector('small').textContent),
locations: rows.map(row => row.querySelector('code').textContent),
repositoryHref: document.getElementById('focus-repository').getAttribute('href'),
scope: panel.title,
badges: document.querySelectorAll('[data-source-evidence-beacon]').length,
sourceCount: document.querySelector('[data-node-id="users"]').getAttribute('data-source-evidence-count'),
sourceAria: document.querySelector('[data-node-id="users"]').getAttribute('aria-label'),
invalidLinks: [...panel.querySelectorAll('a[href]')].some(a => /undefined|javascript:/.test(a.getAttribute('href'))),
search: document.getElementById('node-finder-results').textContent
};
})()`, returnByValue: true,
}, sessionId);
assert.equal(response.exceptionDetails, undefined);
const observed = response.result.value;
assert.equal(observed.visible, true);
assert.equal(observed.badges, 0);
assert.equal(observed.sourceCount, '2');
assert.match(observed.sourceAria, /2 verified source references/);
assert.equal(observed.invalidLinks, false);
assert.deepEqual(observed.paths, ['src/router.js', 'src/store.js']);
assert.match(observed.scope, /local Git/);
assert.match(observed.search, /Users/);
assert.equal(observed.links.length, local ? 0 : 2);
assert.equal(observed.locations[0], local ? 'L1–3' : 'L1–3 ↗');
assert.equal(observed.repositoryHref, local ? null : `${url}/${mode === 'gitlab' ? '-/' : ''}tree/${data.revision}`);
}
}
} finally { await browser.close(); }
});
test('browser announces verified source counts without visual marks and restores canonical export labels', {
skip: process.env.ARCHIFY_CHROME ? false : 'Set ARCHIFY_CHROME to run evidence browser checks.',
timeout: 30000,
}, async (t) => {
const data = fixture();
t.after(() => fs.rmSync(data.root, { recursive: true, force: true }));
data.diagram.meta.locale = 'zh-CN';
fs.writeFileSync(data.input, JSON.stringify(data.diagram));
const artifactPath = path.join(data.root, 'source-aria.html');
const delivered = run(['deliver', 'architecture', data.input, artifactPath, '--repo-root', data.root, '--json']);
assert.equal(delivered.status, 0, delivered.stderr || delivered.stdout);
const html = fs.readFileSync(artifactPath, 'utf8');
const initialization = html.match(/Archify\.sourceEvidence = \(function \(\) \{[\s\S]*?\}\)\(\);/)?.[0];
assert.ok(initialization);
const browser = new ChromeVisualBrowser(findChrome());
try {
await browser.inspect({ artifactPath, width: 1440, height: 900, theme: 'light' });
const sessionId = await browser.sessionPromise;
async function accessibleNodeName() {
const remote = await browser.cdp.send('Runtime.evaluate', {
expression: `document.querySelector('[data-node-id="users"]')`,
}, sessionId);
const tree = await browser.cdp.send('Accessibility.getPartialAXTree', {
objectId: remote.result.objectId, fetchRelatives: false,
}, sessionId);
const name = tree.nodes.find(node => !node.ignored)?.name?.value;
assert.equal(typeof name, 'string', JSON.stringify(tree));
return name;
}
assert.match(await accessibleNodeName(), /2 个已验证来源引用/);
const response = await browser.cdp.send('Runtime.evaluate', {
expression: `(async () => {
const reinitialize = () => { ${initialization} };
const svg = document.querySelector('.diagram-container > svg');
const node = svg.querySelector('[data-node-id="users"]');
const element = document.getElementById('archify-source-evidence-data');
const payload = JSON.parse(element.textContent);
const originalSources = payload.nodes.users.slice();
const authoredLabel = node.getAttribute('data-source-evidence-original-label');
const geometry = [...svg.querySelectorAll('rect,path,line,polyline,text')].map(el => el.outerHTML).join('');
const initial = node.getAttribute('aria-label');
reinitialize();
const repeated = node.getAttribute('aria-label');
const noVisualMarks = !svg.querySelector('[data-source-evidence-beacon], .source-evidence-beacon');
const geometryPreserved = geometry === [...svg.querySelectorAll('rect,path,line,polyline,text')].map(el => el.outerHTML).join('');
Archify.focus.set('users', { toggle: false });
const passportLinks = document.querySelectorAll('#focus-evidence a[href]').length;
const before = svg.outerHTML;
const originalCreate = URL.createObjectURL;
let exportedBlob;
URL.createObjectURL = function(blob) {
if (blob.type.startsWith('image/svg+xml')) exportedBlob = blob;
return originalCreate.call(URL, blob);
};
let exportPreservesLive;
try {
const pending = Archify.exportMenu.run('svg');
exportPreservesLive = before === svg.outerHTML;
await pending;
} finally { URL.createObjectURL = originalCreate; }
const exported = new DOMParser().parseFromString(await exportedBlob.text(), 'image/svg+xml');
const exportedLabel = exported.querySelector('[data-node-id="users"]').getAttribute('aria-label');
const exportClean = !exported.querySelector('[data-source-evidence-count], [data-source-evidence-original-label], [data-reader-legend-corner], [data-source-evidence-beacon]');
// The download anchor can clear Focus through its existing outside-click
// behavior. Reopen via the public interface to verify sources survive.
Archify.focus.set('users', { toggle: false });
const passportLinksAfter = document.querySelectorAll('#focus-evidence a[href]').length;
payload.nodes.users = [];
element.textContent = JSON.stringify(payload);
reinitialize();
const zeroRestored = node.getAttribute('aria-label') === authoredLabel && !node.hasAttribute('data-source-evidence-count');
const results = [];
for (const label of [null, '', 'Authored focus label']) {
node.removeAttribute('data-source-evidence-count');
node.removeAttribute('data-source-evidence-original-label');
if (label === null) node.removeAttribute('aria-label'); else node.setAttribute('aria-label', label);
payload.nodes.users = [originalSources[0]];
payload.verified = true;
element.textContent = JSON.stringify(payload);
reinitialize();
const once = node.getAttribute('aria-label');
reinitialize();
const twice = node.getAttribute('aria-label');
let labelBlob;
URL.createObjectURL = function(blob) {
if (blob.type.startsWith('image/svg+xml')) labelBlob = blob;
return originalCreate.call(URL, blob);
};
try { await Archify.exportMenu.run('svg'); }
finally { URL.createObjectURL = originalCreate; }
const exportedNode = new DOMParser().parseFromString(await labelBlob.text(), 'image/svg+xml').querySelector('[data-node-id="users"]');
payload.nodes.users = [];
element.textContent = JSON.stringify(payload);
reinitialize();
const zeroRestored = node.getAttribute('aria-label');
payload.nodes.users = [originalSources[0]];
element.textContent = JSON.stringify(payload);
reinitialize();
payload.verified = false;
element.textContent = JSON.stringify(payload);
reinitialize();
results.push({ once, twice, zeroRestored, exportedLabel: exportedNode.getAttribute('aria-label'), restored: node.getAttribute('aria-label'), count: node.getAttribute('data-source-evidence-count') });
}
return { initial, repeated, noVisualMarks, geometryPreserved, authoredLabel, exportedLabel,
exportClean, exportPreservesLive, passportLinks, passportLinksAfter,
zeroRestored, results };
})()`, returnByValue: true, awaitPromise: true,
}, sessionId);
assert.equal(response.exceptionDetails, undefined);
const observed = response.result.value;
assert.match(observed.initial, /2 个已验证来源引用/);
assert.equal(observed.repeated, observed.initial);
for (const key of ['noVisualMarks', 'geometryPreserved', 'exportClean', 'exportPreservesLive', 'zeroRestored']) assert.equal(observed[key], true, key);
assert.equal(observed.exportedLabel, observed.authoredLabel);
assert.equal(observed.passportLinks, 3);
assert.equal(observed.passportLinksAfter, 3);
for (const [index, result] of observed.results.entries()) {
assert.match(result.once, /1 个已验证来源引用/);
assert.equal(result.twice, result.once);
assert.equal(result.restored, [null, '', 'Authored focus label'][index]);
assert.equal(result.zeroRestored, [null, '', 'Authored focus label'][index]);
assert.equal(result.exportedLabel, [null, '', 'Authored focus label'][index]);
assert.equal(result.count, null);
}
const restored = await browser.cdp.send('Runtime.evaluate', {
expression: `(() => {
const element = document.getElementById('archify-source-evidence-data');
const payload = JSON.parse(element.textContent);
payload.verified = true;
element.textContent = JSON.stringify(payload);
${initialization}
return document.querySelector('[data-node-id="users"]').getAttribute('aria-labelledby');
})()`, returnByValue: true,
}, sessionId);
assert.equal(restored.exceptionDetails, undefined);
assert.equal(restored.result.value, null, 'node has no competing aria-labelledby');
assert.equal(await accessibleNodeName(), 'Authored focus label, 1 个已验证来源引用');
} finally { await browser.close(); }
});