Skip to content

[Feature]: Добавить строгую runtime-валидацию frontmatter и контентного контракта. #11

Closed

Description

@minkinad

Проблема Или Возможность

Сейчас тип DocFrontmatter существует только как TypeScript-интерфейс, а на runtime почти все поля молча заполняются fallback-значениями:
lib/navigation.ts (line 10), lib/navigation.ts (line 150).
Это удобно на старте, но плохо для роста: ошибки в метаданных будут попадать в прод незаметно.

Предлагаемое Решение

Целевая архитектура: модуль content-schema на zod или json-schema, который проверяет title, description, order/sidebar_position, author, допустимые section-id, уникальность slug, наличие section index, корректность generated pages. В prepare:content должны появиться режимы error, warning, autofix-report, а в CI нужно публиковать content-report.json.
Эффект: вы получаете стабильный контракт данных, а backend перестает “догадываться”, что имел в виду автор документа.

Область Изменения

No response

Рассмотренные Альтернативы

No response

Критерии Готовности

No response

Activity

  1. linked a pull request that will close this issueSaid feat stack 11 #20on May 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions