feat: add section navigation and embedded Archify diagrams

scripts/verify.mjs

@@ -6,7 +6,7 @@ const config = read('docusaurus.config.ts');
 assert(config.includes("baseUrl: '/eldorado-v1/documentation/'"));
 assert(config.includes("onBrokenLinks: 'throw'"));
 assert(config.includes("hashed: 'filename'"));
-for (const file of readdirSync('docs')) {
+for (const file of readdirSync('docs', {recursive: true}).filter(f => /\.mdx?$/.test(f))) {
   const doc = read(join('docs', file));
   assert(/^---\n[\s\S]*?title: .+\n[\s\S]*?description: .+\n/.test(doc), `Missing metadata: ${file}`);
 }
@@ -16,9 +16,13 @@ const workflow = read('.gitea/workflows/pages.yml');
 assert(workflow.includes('mountpoint -q'));
 assert(workflow.includes("gitea.event_name == 'push' && gitea.ref == 'refs/heads/main'"));
 if (process.argv.includes('--build')) {
-  for (const route of ['index.html','docs/overview/index.html','docs/maintain/index.html','docs/reference/index.html','404.html']) {
+  for (const route of ['index.html','docs/overview/index.html','docs/maintain/index.html','docs/reference/index.html','404.html','organization/structure/index.html','strategy/index.html','contribution/index.html','contribution/diagrams/index.html','diagrams/organization-structure/index.html']) {
     assert(existsSync(join('build',route)), `Missing route: ${route}`);
   }
+  assert(!readdirSync('build/diagrams', {recursive: true}).some(f => f.endsWith('.delivery.json')), 'Private build receipts must not be published');
+  const diagram = read('build/diagrams/organization-structure/index.html');
+  assert(diagram.includes('Example leadership') && diagram.includes('node-engineering'));
+  assert(!diagram.includes('/opt/data/'), 'No build paths in published diagrams');
   const home = read('build/index.html');
   assert(/<title\b[^>]*>Eldorado Powered By AI<\/title>/.test(home));
   assert(home.includes('Powered By AI</span></h1>'));