Function generateIndex

scripts/build-compliance.cjs:494–548

(version, sourceDir)

const { lint: lintUniversalDocParity } = require('./lint-universal-storyboard-doc-parity.cjs');

function generateIndex(version, sourceDir) {
  const specialisms = discoverSpecialisms(sourceDir);
  const protocols = discoverProtocols(sourceDir, specialisms);
  verifyEnumParity(specialisms, protocols);
  const docParityErrors = lintUniversalDocParity({ sourceDir });
  if (docParityErrors.length) {
    throw new Error('Universal-storyboard doc parity drift:\n  - ' + docParityErrors.join('\n  - '));
  }
  lintStoryboardIdempotency(sourceDir, SCHEMAS_DIR);
  const universalDir = path.join(sourceDir, 'universal');
  const universal = fs.existsSync(universalDir)
    ? fs.readdirSync(universalDir)
        .filter(f => f.endsWith('.yaml'))
        .map(f => f.replace(/\.yaml$/, ''))
        .sort()
    : [];

  const protocolEntries = protocols.map(d => ({
    id: d.id,
    title: d.title,
    has_baseline: d.has_baseline,
    path: d.path,
  }));
  // Transitional alias for @adcp/client consumers that read `domains` and expect
  // `domains/{id}/` on-disk paths. Drop after v6 ships and all consumers upgrade.
  const domainAliasEntries = protocols.map(d => ({
    id: d.id,
    title: d.title,
    has_baseline: d.has_baseline,
    path: d.path.replace(/^protocols\//, 'domains/'),
  }));

  // published_version: full semver of this compliance bundle.
  // adcp_version: legacy alias kept through 3.x for @adcp/client compatibility
  // (ComplianceIndex.adcp_version). Both carry full semver; distinct from the
  // wire field in core/version-envelope.json (release-precision).
  return {
    published_version: version,
    adcp_version: version,
    generated_at: new Date().toISOString(),
    universal,
    protocols: protocolEntries,
    domains: domainAliasEntries,
    specialisms: specialisms.map(s => ({
      id: s.id,
      protocol: s.protocol,
      domain: s.protocol,
      title: s.title,
      status: s.status,
      required_tools: s.required_tools,
      ...(s.required_any_of_tools ? { required_any_of_tools: s.required_any_of_tools } : {}),
      path: s.path
    }))
  };
}

function mirrorProtocolsToDomains(targetDir) {
  const protocolsDir = path.join(targetDir, 'protocols');