crank/CONTRIBUTING.md

Участие в разработке

Crank Community принимает исправления ошибок, улучшения документации, тесты и доработки открытой версии проекта.

Лицензия вкладов

Crank Community распространяется по лицензии GNU Affero General Public License v3.0 only.

Перед отправкой pull request нужно согласиться с Contributor License Agreement. Это нужно, чтобы права на принятые изменения были оформлены явно и проект мог развиваться без юридических неопределенностей.

Перед pull request

Проверьте форматирование и тесты:

just fmt-check
just clippy
just test

Для изменений веб-интерфейса также выполните:

cd apps/ui
npm ci
npm run build
npx playwright test

Требования к изменениям

• Не добавляйте функциональность вне границ Community-версии.
• Не добавляйте секреты, токены, приватные адреса и локальные настройки.
• Не коммитьте AGENTS.md, TASKS.md, .env и временные файлы.
• Для изменений SQL-запросов обновляйте .sqlx, если это требуется SQLx.
• Для пользовательских изменений обновляйте документацию или примеры.

Границы проекта

В этом репозитории поддерживаются:

• REST API как источник MCP-инструментов;
• простая авторизация администратора;
• ключи агентов для MCP-доступа;
• одно самостоятельное развертывание;
• PostgreSQL как основное хранилище;
• необязательный Valkey или Redis для служебного кэша.

Функции за пределами перечисленного набора не должны попадать в этот репозиторий.