Function checkMetaCoverage

document/script/checkDocRefs.js:200–249

()

}

function checkMetaCoverage() {
  const errors = [];

  (function walk(dir) {
    const entries = fs.readdirSync(dir, { withFileTypes: true });

    for (const entry of entries) {
      if (!entry.isFile() || !isMetaFile(entry.name)) continue;
      const metaPath = path.join(dir, entry.name);
      let meta;
      try {
        meta = JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
      } catch (e) {
        errors.push({ file: metaPath, missing: [], parseError: e.message });
        continue;
      }
      const pages = Array.isArray(meta.pages) ? meta.pages : [];

      const declared = new Set();
      const wildcards = new Set();
      for (const p of pages) {
        if (typeof p !== 'string') continue;
        if (/^---.*---$/.test(p)) continue;
        if (p.startsWith('...')) {
          wildcards.add(p.slice(3));
          continue;
        }
        declared.add(p);
      }

      const expected = collectExpectedSlugs(dir);
      const missing = [];
      for (const slug of expected) {
        const topLevel = slug.split('/')[0];
        if (wildcards.has(topLevel)) continue;
        if (declared.has(slug)) continue;
        missing.push(slug);
      }
      if (missing.length > 0) errors.push({ file: metaPath, missing });
    }

    for (const entry of entries) {
      if (entry.isDirectory() && !entry.name.startsWith('.')) {
        walk(path.join(dir, entry.name));
      }
    }
  })(CONTENT_DIR);

  return errors;
}

function main() {
  const args = process.argv.slice(2).filter(Boolean);