validator-spec.md

Validator Spec v1

Purpose

Validator перевіряє, що memory docs відповідають schema v1 і базовим referential rules.

Input

• усі .md файли в memory/
• за потреби canonical docs у skills/core/, якщо вони описані як memory nodes

Checks

1. Required field checks

Перевіряти наявність:

• schema_version
• id
• type
• title
• status
• created_at
• updated_at
• project
• tags
• links
• provenance.source
• provenance.confidence

2. Enum checks

Перевіряти допустимі значення для:

• type
• status
• provenance.confidence
• links[].type

3. ID and file checks

Перевіряти:

• id відповідає формату mem-{type}-{slug}
• файл має назву {id}.md
• директорія відповідає типу документа

4. Referential checks

Перевіряти:

• усі links[].target існують
• усі supersedes targets існують
• якщо status: superseded, то superseded_by не порожній

5. Structural checks

Перевіряти:

• links є масивом об'єктів
• кожен link має type і target
• дублікати однакових type + target відсутні
• tags є масивом строк

6. Orphan check

Документ є orphan candidate, якщо:

• не має outbound links;
• не має inbound links;
• не входить до списку дозволених root nodes.

7. Allowed root nodes

У v1 дозволені як root:

• глобальний concept системи;
• vault-index;
• cluster indexes.

Output

Validator має повертати:

• список errors, які ламають contract;
• список warnings, які не блокують repo, але вимагають cleanup.

Suggested report groups

• missing_required_fields
• invalid_enum_values
• broken_file_naming
• broken_links
• broken_supersede_chain
• duplicate_links
• orphan_candidates