import assert from 'node:assert/strict'; import {existsSync, readFileSync, readdirSync} from 'node:fs'; import {join} from 'node:path'; import {XMLValidator} from 'fast-xml-parser'; const root = process.cwd(); const read = (path) => readFileSync(join(root, path), 'utf8'); const config = read('docusaurus.config.ts'); const packageJson = JSON.parse(read('package.json')); const globalCss = read('src/css/custom.css'); const homepageCss = read('src/pages/index.module.css'); assert.match(config, /defaultMode:\s*'dark'/, 'dark must remain the default theme'); assert.match(config, /disableSwitch:\s*false/, 'theme switch must be enabled'); assert.match(globalCss, /\[data-theme=['"]light['"]\]/, 'global CSS needs an explicit light palette'); assert.match(homepageCss, /:global\(\[data-theme=['"]light['"]\]\)/, 'homepage needs a light palette'); assert.doesNotMatch(globalCss, /html,\s*body\s*\{\s*background:\s*#08101b/, 'document background must not be hard-coded dark'); for (const section of ['projects', 'teams', 'members', 'board', 'governance']) { assert.match(config, new RegExp(`id:\\s*'${section}'`), `${section} docs plugin is missing`); assert.match(config, new RegExp(`sidebarId:\\s*'${section}Sidebar'`), `${section} navbar item does not target its dedicated sidebar`); assert.ok(existsSync(join(root, `sidebars/${section}.ts`)), `${section} sidebar file is missing`); } assert.match(config, /id:\s*'architecture-high-level'/, 'Architecture High Level docs plugin is missing'); assert.match(config, /sidebarId:\s*'architectureHighLevelSidebar'/, 'Architecture High Level navbar item does not target its dedicated sidebar'); assert.match(config, /label:\s*'Architecture High Level'/, 'Architecture High Level navbar label is missing'); assert.ok(existsSync(join(root, 'sidebars/architecture-high-level.ts')), 'Architecture High Level sidebar file is missing'); assert.match(config, /baseUrl:\s*'\/corp-v1\/portal\/'/, 'Pages base URL must follow the renamed repository'); assert.match(config, /projectName:\s*'portal'/, 'Docusaurus project name must be portal'); assert.doesNotMatch(config, /sterring-commitee/, 'legacy repository name must not remain in Docusaurus config'); assert.doesNotMatch(config, /Pilot Model|docs\/pilot|routeBasePath:\s*'pilot'/, 'legacy Pilot Model navigation must not remain'); const board = read('docs/board/index.md'); for (const memberId of ['1518725627845283888', '476287310627864587', '773109855497093191', '364383883778850827']) { assert.ok(board.includes(memberId), `board page is missing Discord member ${memberId}`); } assert.match(board, /Only these Board members may approve a project kickoff or project closure/i); assert.match(board, /Only these Board members may approve changes to `corp-v1--main`/i); const lifecycle = read('docs/governance/project-lifecycle.md'); assert.match(lifecycle, /Board approval/i, 'project lifecycle must require Board approval'); assert.match(lifecycle, /central project-channel reference skill/i, 'lifecycle must govern central channel-reference skill changes'); assert.match(lifecycle, /project-adopted channel skill/i, 'lifecycle must require project skill synchronization'); for (const section of ['projects', 'teams', 'members']) { const sidebar = read(`sidebars/${section}.ts`); assert.match(sidebar, /label:\s*'Registry'/, `${section} sidebar registry label must be concise`); assert.doesNotMatch(sidebar, /label:\s*'(Projects|Teams|Members) Registry'/, `${section} sidebar must not repeat its section name`); } assert.ok(packageJson.dependencies?.['@easyops-cn/docusaurus-search-local'], 'local search dependency is missing'); assert.match(config, /@easyops-cn\/docusaurus-search-local/, 'local search theme is not configured'); assert.ok(packageJson.dependencies?.['docusaurus-plugin-drawio'], 'Draw.io plugin dependency is missing'); assert.ok(packageJson.devDependencies?.['raw-loader'], 'Draw.io raw-loader dependency is missing'); assert.match(config, /\['drawio',\s*\{lib:\s*'\/corp-v1\/portal\/drawio\/viewer\.min\.js'\}\]/, 'Draw.io plugin must use the self-hosted viewer'); assert.ok(existsSync(join(root, 'static/drawio/viewer.min.js')), 'self-hosted Draw.io viewer is missing'); const drawioLicense = read('static/drawio/LICENSE'); assert.match(drawioLicense, /MIT License/, 'vendored Draw.io viewer license is missing'); assert.match(drawioLicense, /Copyright \(c\) 2022 xiguaxigua/, 'vendored Draw.io viewer copyright notice is missing'); assert.match(config, /indexPages:\s*true/, 'custom pages must be indexed'); const searchRoutesMatch = config.match(/docsRouteBasePath:\s*\[([^\]]+)\]/); assert.ok(searchRoutesMatch, 'search route configuration is missing'); const searchRoutes = searchRoutesMatch[1]; for (const route of ['/', 'architecture-high-level', 'projects', 'teams', 'members', 'board', 'governance']) { assert.ok(searchRoutes.includes(`'${route}'`), `search does not include route base ${route}`); } const architectureSidebar = read('sidebars/architecture-high-level.ts'); const architectureEntries = [...architectureSidebar.matchAll(/\{type:\s*'doc',\s*id:\s*'([^']+)',\s*label:\s*'([^']+)'\}/g)] .map((match) => ({id: match[1], label: match[2]})); assert.deepEqual(architectureEntries, [ {id: 'context', label: 'Context'}, {id: 'overview', label: 'Overview'}, {id: 'overview-channels', label: 'Overview Channels'}, {id: 'overview-repositories', label: 'Overview Repositories'}, ], 'Architecture High Level sidebar must contain exactly the four requested documents in order'); const architecturePages = { context: read('docs/architecture-high-level/context.mdx'), overview: read('docs/architecture-high-level/overview.mdx'), channels: read('docs/architecture-high-level/overview-channels.mdx'), repositories: read('docs/architecture-high-level/overview-repositories.mdx'), }; for (const [name, page] of Object.entries(architecturePages)) { assert.match(page, /!!raw-loader!\.\/diagrams\/.+\.drawio/, `${name} page must render an editable Draw.io source`); } for (const term of ['six channel skills', 'seven engineering skills', 'Gitea Actions', 'scheduler jobs']) { assert.ok(Object.values(architecturePages).some((page) => page.includes(term)), `architecture explanation is missing: ${term}`); } for (const [name, markers] of Object.entries({ 'context.drawio': ['CORP V1 — OPERATING CONTEXT', 'Corp v1 Board', 'Gitea organizations and repositories', 'Delivery platform'], 'overview.drawio': ['CORP V1 — PROJECT OPERATING FLOW', 'BOARD APPROVAL', 'KANBAN / FOCUS', 'VERIFY & RECORD'], 'channels.drawio': ['CORP V1 — PROJECT CHANNELS', 'GENERAL', 'ARCHITECTURE', 'RELEASES'], 'repositories.drawio': ['CORP V1 — ORGANIZATIONS, REPOSITORIES & DELIVERY', 'PROJECT ORGANIZATION', 'SKILLS ORGANIZATION', 'GITEA ACTIONS'], })) { const diagram = read(`docs/architecture-high-level/diagrams/${name}`); const xmlResult = XMLValidator.validate(diagram); assert.equal(xmlResult, true, `${name} is malformed XML: ${JSON.stringify(xmlResult)}`); assert.match(diagram, /]/, `${name} is not a Draw.io source file`); for (const marker of markers) assert.ok(diagram.includes(marker), `${name} is missing: ${marker}`); } if (existsSync(join(root, 'build'))) { const filename = readdirSync(join(root, 'build')).find((name) => /^search-index(?:-[a-f0-9]+)?\.json$/.test(name)); assert.ok(filename, 'production search index is missing'); const search = readFileSync(join(root, 'build', filename), 'utf8').toLowerCase(); for (const term of ['projects registry', 'teams registry', 'members registry', 'board members', 'project lifecycle', 'corp v1 board', 'overview channels', 'overview repositories']) { assert.ok(search.includes(term), `search index is missing: ${term}`); } } console.log('Portal behavior checks passed.');