Function main

scripts/verify-internal-links-in-toc.js:154–342

()

}

function main() {
  process.chdir(ROOT);

  const verbose =
    process.env.VERBOSE_TOC === "1" ||
    process.env.VERBOSE_TOC === "true" ||
    process.env.VERBOSE === "1" ||
    process.env.VERBOSE === "true";
  const maxMissing =
    Number.parseInt(process.env.TOC_MAX_MISSING || "", 10) || 50;
  const maxFiles =
    Number.parseInt(process.env.TOC_MAX_FILES || "", 10) || 30;
  const maxLinksPerFile =
    Number.parseInt(process.env.TOC_MAX_LINKS_PER_FILE || "", 10) || 10;

  const tocFiles = readTocFiles();
  if (tocFiles.length === 0) {
    console.error("TOC check error: no TOC*.md files found in repo root.");
    process.exit(1);
  }

  const { tocToPages, anyTocPages, pageToTocs, cloudTocPages } =
    buildTocIndex(tocFiles);
  const buildScopePages = sortedValues(anyTocPages);

  const missingScopePages = [];
  const violations = [];

  buildScopePages.forEach((sourceRel) => {
    const sourceAbs = path.join(ROOT, sourceRel);
    if (!fs.existsSync(sourceAbs)) {
      missingScopePages.push(sourceRel);
      return;
    }

    extractInternalDocTargetsFromMarkdownFile(sourceAbs)
      .filter((targetRel) =>
        !SPECIAL_IMPLICIT_TARGETS.has(path.basename(targetRel))
      )
      .forEach((targetRel) => {
        const { ok, expectedLabel } = expectedSetForTarget(
          targetRel,
          tocToPages,
          anyTocPages,
          cloudTocPages
        );
        if (!ok) {
          violations.push({
            sourceRel,
            targetRel,
            expectedLabel,
          });
        }
      });
  });

  if (missingScopePages.length > 0) {
    // Printed below in a grouped summary.