Курування знань через Git

Посібник контриб’ютора

Як подавати нові спостереження, структурні бар’єри, механізми та пропозиції інтервенцій через pull request у Git.

Робочий процес контриб’ютора

git clone https://github.com/dmytro-yemelianov/hoba.work.git

pnpm install

pnpm validate:strict

pnpm test

pnpm build

Автоматичні CI-перевірки pull request

✓ Строга відповідність Zod-схемам
✓ Референційна цілісність усіх ID
✓ Топологічне сортування DAG бар’єрів (строга ациклічність)
✓ Ребра циклів оголошені на механізмах (SCC Тар’яна)
✓ Збереження чесних базових механізмів
✓ Структурний паритет англійської та української версій

Дві мови, одна структура

Кожен вузол існує в content/ (англійська, канонічна) та content-uk/ (українська). ID і структура графа мають бути ідентичними; відрізнятися може лише текст — це перевіряє валідатор.