jarvis-at-skic
70ffea0e16
Build and publish Eldorado documentation / build (pull_request) Successful in 30s
70 lines
4.0 KiB
JavaScript
70 lines
4.0 KiB
JavaScript
import {test} from 'node:test';
|
||
import {createHash} from 'node:crypto';
|
||
import assert from 'node:assert/strict';
|
||
import {readFileSync, existsSync, mkdtempSync, mkdirSync, writeFileSync, symlinkSync, unlinkSync, rmSync, readdirSync} from 'node:fs';
|
||
import {tmpdir} from 'node:os';
|
||
import {join, resolve} from 'node:path';
|
||
import {spawnSync} from 'node:child_process';
|
||
const read = p => readFileSync(p, 'utf8');
|
||
test('real build removes stale diagrams, keeps receipts private and rejects collisions', () => {
|
||
const root = mkdtempSync(join(tmpdir(), 'eldorado-diagrams-'));
|
||
try {
|
||
mkdirSync(join(root,'diagrams'));
|
||
symlinkSync(resolve('vendor'),join(root,'vendor'),'dir');
|
||
const spec = JSON.parse(read('diagrams/organization-structure.architecture.json'));
|
||
const writeSpec = name => {
|
||
spec.meta.output = `static/diagrams/${name}/index.html`;
|
||
writeFileSync(join(root,`diagrams/${name}.architecture.json`),JSON.stringify(spec));
|
||
};
|
||
const build = () => spawnSync(process.execPath,[resolve('scripts/build-diagrams.mjs')],{cwd:root,encoding:'utf8'});
|
||
writeSpec('old');
|
||
let result = build(); assert.equal(result.status,0,result.stderr);
|
||
assert(existsSync(join(root,'static/diagrams/old/index.html')));
|
||
assert(!readdirSync(join(root,'static/diagrams'),{recursive:true}).some(p=>p.endsWith('.delivery.json')));
|
||
unlinkSync(join(root,'diagrams/old.architecture.json'));
|
||
writeSpec('new');
|
||
result=build(); assert.equal(result.status,0,result.stderr);
|
||
assert(!existsSync(join(root,'static/diagrams/old')));
|
||
assert(!existsSync(join(root,'static/diagrams/old.json')));
|
||
writeFileSync(join(root,'diagrams/new.workflow.json'),JSON.stringify(spec));
|
||
result=build(); assert.notEqual(result.status,0);
|
||
assert(result.stderr.includes('Duplicate diagram output'));
|
||
} finally {rmSync(root,{recursive:true,force:true});}
|
||
});
|
||
test('vendored source matches the reviewed upstream snapshot', () => {
|
||
const checksums = JSON.parse(read('vendor/archify-checksums.json'));
|
||
for (const [path, hash] of Object.entries(checksums)) {
|
||
assert.equal(createHash('sha256').update(readFileSync(`vendor/archify/${path}`)).digest('hex'), hash, path);
|
||
}
|
||
});
|
||
test('three independent section menus and Structure first', () => {
|
||
const config = read('docusaurus.config.ts');
|
||
for (const section of ['Organization', 'Strategy', 'Contribution']) assert(config.includes(`label: '${section}'`));
|
||
assert(!config.includes("label: 'Documentation'"));
|
||
assert(!config.includes("label: 'Maintainer guide'"));
|
||
assert(read('sidebars/organization.ts').includes("organizationSidebar: ['structure']"));
|
||
for (const section of ['organization','strategy','contribution']) assert(config.includes(`id: '${section}'`));
|
||
});
|
||
test('Archify is pinned, licensed and rebuilt, not a remote embed', () => {
|
||
const provenance = JSON.parse(read('vendor/archify-provenance.json'));
|
||
assert.equal(provenance.commit, 'd5a1333d7447c866a765adac7d4d062f2f02e4d2');
|
||
assert(read('vendor/archify/LICENSE').includes('MIT License'));
|
||
const scripts = JSON.parse(read('package.json')).scripts;
|
||
assert(scripts.build.startsWith('pnpm diagrams:build'));
|
||
const wrapper = read('src/components/ArchifyDiagram/index.tsx');
|
||
assert(wrapper.includes('sandbox="allow-scripts allow-downloads"'));
|
||
assert(!wrapper.includes('allow-same-origin'));
|
||
assert(wrapper.includes('useBaseUrl'));
|
||
assert(wrapper.includes('showModal()') && wrapper.includes('onClose='));
|
||
assert(!wrapper.includes('target="_blank"'));
|
||
assert(wrapper.includes('Close full-screen diagram'));
|
||
});
|
||
test('example is explicitly illustrative and contains valid connected nodes', () => {
|
||
const spec = JSON.parse(read('diagrams/organization-structure.architecture.json'));
|
||
assert(spec.meta.title.includes('Illustrative'));
|
||
const ids = new Set(spec.components.map(n => n.id));
|
||
assert.equal(ids.size, spec.components.length);
|
||
for (const edge of spec.connections) assert(ids.has(edge.from) && ids.has(edge.to));
|
||
assert(read('docs/organization/structure.mdx').includes('not Eldorado’s confirmed organization chart'));
|
||
});
|