Function syncTarget

scripts/sync-sidebar.js:170–221

(source, target)

}

function syncTarget(source, target) {
  const dir = path.resolve(ROOT_DIR, target.dir);
  const report = {
    route: target.route,
    dir: path.relative(ROOT_DIR, dir),
    added: [],
    removed: [],
    warnings: [],
  };

  if (!fs.existsSync(dir)) {
    throw new Error(`Markdown directory not found: ${target.dir}`);
  }

  const files = collectMarkdownSlugs(dir);
  const blockRange = findRouteArray(source, target.route);
  if (!blockRange) {
    throw new Error(`Route not found in sidebar.ts: ${target.route}`);
  }

  let block = source.slice(blockRange.start, blockRange.end + 1);
  const refs = collectRefs(block);
  const listedSlugs = new Set(refs.map((ref) => ref.slug));
  const fileSlugs = new Set(files.map((file) => file.slug));

  const staleSlugs = [...listedSlugs].filter((slug) => !fileSlugs.has(slug));
  if (staleSlugs.length > 0) {
    const removal = removeStaleStringEntries(block, staleSlugs);
    block = removal.block;
    report.removed = removal.removed;

    for (const slug of staleSlugs) {
      if (!removal.removed.includes(slug)) {
        report.warnings.push(`Stale ref "${slug}" is not a plain string entry; remove it manually if needed.`);
      }
    }
  }

  const refsAfterRemoval = collectRefs(block);
  const listedAfterRemoval = new Set(refsAfterRemoval.map((ref) => ref.slug));
  const missingFiles = files.filter((file) => !listedAfterRemoval.has(file.slug));

  if (missingFiles.length > 0) {
    const insertion = appendMissingEntries(block, missingFiles, target.fallbackGroup);
    block = insertion.block;
    report.added = insertion.added;
    report.warnings.push(...insertion.warnings);
  }

  const nextSource = source.slice(0, blockRange.start) + block + source.slice(blockRange.end + 1);
  return { source: nextSource, report };
}

function collectMarkdownSlugs(dir) {
  return fs