Said feat stack 11

[rbdnv]

Что Изменилось

Добавлен runtime-контракт для metadata документов: появилась Zod-схема frontmatter, генерация content-report.json, режимы проверки контента и базовые проверки структуры документации.

Изменение понадобилось, чтобы ошибки в title, description, order/sidebar_position, author, section-id, slug и generated pages не попадали в production молча через fallback-значения.

Тип Изменения

• Обновление контента
• Улучшение UI или UX
• Изменение поиска или навигации
• Улучшение build или CI
• Исправление ошибки
• Другое

Проверка

Отметьте, что вы запускали:

• npm run prepare:content
• npm run validate:content
• npm run lint
• npm run typecheck
• npm run build

Дополнительно запускалось:

• npm run prepare:content:warning
• node --check scripts/content-manifest.mjs
• node --check scripts/content-report.mjs
• node --check scripts/content-schema.mjs

npm run prepare:content сейчас падает ожидаемо, потому что строгий режим error находит проблемы в существующем контенте: отсутствующие author, дубли virtual path и generated-page shadowing. Для проверки механизма использовался warning-режим.

Затронутые Области

• Треки или файлы:

  • docs/algorithms/
  • docs/java/index.mdx
  • docs/java/overview.mdx
  • docs/python/index.mdx

• Маршруты или страницы:

  • /docs/algorithms
  • /docs/algorithms/getting-started
  • /docs/java
  • /docs/java/overview
  • /docs/python

• Скрипты или workflow:

  • scripts/content-manifest.mjs
  • scripts/content-schema.mjs
  • scripts/content-report.mjs
  • .github/workflows/pr-check.yml
  • package.json
  • package-lock.json

Скриншоты

Не требуются, интерфейс не менялся.

Комментарии Для Ревью

Особое внимание стоит обратить на:

• корректность режима --mode=error, --mode=warning, --mode=autofix-report;
• формат .cache/content-report.json;
• проверку duplicate_virtual_path;
• проверку duplicate-slug;
• проверку missing-section-index;
• обработку generated-page-shadowed;
• обязательность поля author в текущей Zod-схеме;
• оставшиеся проблемы существующего контента, из-за которых строгий prepare:content пока падает.