sourcebook

Находит файлы, которые ваш ИИ-агент забыл изменить.

Уровень безопасности для внесения изменений в код. sourcebook анализирует git diff на предмет полноты — помечает файлы, которые должны были быть изменены, но не были. Основанное на правилах структурное обнаружение плюс семантический анализ на базе ИИ. Нулевое количество ложных срабатываний на чистых diff.

npx sourcebook init # sets up Claude Code hooks + generates CLAUDE.md
npx sourcebook check # check your current diff for missing files
npx sourcebook scan-history # see what you've been missing

Что он находит

Ваш ИИ-агент изменил обработчик. Обновил ли он тест? Сопутствующий модуль? Конфигурацию, которая ссылается на старое значение?

sourcebook проверяет ваш diff на соответствие реальной структуре репозитория:

• Отсутствующие файлы тестов — исходный файл изменен, файл теста — нет

• Сопутствующие модули — файлы, которые импортируют или импортируются тем, что вы изменили

• Совместно изменяемые файлы — файлы, которые исторически меняются вместе в коммитах git

• Радиус поражения хаб-файлов — вы затронули файл, от которого зависят 50+ других

С флагом --ai: межмодульные семантические связи, переименования полей, требующие миграций, устаревшая логика валидации.

Related MCP server: Carto MCP Server

Ключевые показатели

Четыре поверхности взаимодействия

1. CLI

Запускайте на любом diff. Настройка не требуется.

npx sourcebook check # check staged/unstaged changes
npx sourcebook check --ai # add AI semantic analysis (requires ANTHROPIC_API_KEY)
npx sourcebook check --quiet # exit code only (for CI/scripts)
npx sourcebook check --branch main # compare vs a branch

2. Хуки Claude Code

Одна команда для настройки pre-commit хуков. Агент редактирует файл, sourcebook проверяет diff, агент видит, что пропущено — все до того, как коммит будет зафиксирован.

npx sourcebook init # generates CLAUDE.md + installs hooks

3. MCP-сервер

Опубликован в официальном реестре MCP. Агенты могут запрашивать структуру репозитория, радиус поражения, соглашения и данные о совместных изменениях по требованию.

npx sourcebook serve

Добавьте в ваш MCP-клиент:

{
 "mcpServers": {
 "sourcebook": {
 "command": "npx",
 "args": ["-y", "sourcebook", "serve", "--dir", "/path/to/your/project"]
 }
 }
}

4. Приложение GitHub (скоро)

Автоматические проверки полноты в каждом pull request. Присоединяйтесь к списку ожидания.

Команды

Как это работает

Уровень A — На основе правил (без LLM, <1 секунды)

1. Анализ совместных изменений — извлекает из истории git файлы, которые меняются вместе. Если вы затронули auth.ts, и он меняется вместе с session.ts в 88% коммитов, sourcebook пометит session.ts.

2. Обнаружение файлов тестов — сопоставляет исходные файлы с файлами тестов через соглашения об именовании и историю совместных изменений.

3. Граф импорта — строит граф зависимостей и проверяет, нужно ли обновлять файлы, которые импортируют (или импортируются) измененные вами файлы.

4. Обнаружение хабов — помечает случаи, когда вы изменили файл с высоким коэффициентом входящих зависимостей (fan-in). Такие изменения имеют радиус поражения.

Уровень B — На базе ИИ (~$0.012/запуск)

Отправляет diff вместе с контекстом зависимостей в Claude Sonnet. Находит семантические связи, которые не видит Уровень A — переименования полей, требующие миграций, логику валидации, основанную на старых схемах, межмодульные зависимости без явных ссылок импорта.

Каждое предложение ИИ требует ссылки на зависимость. Галлюцинированные пути к файлам отфильтровываются. Контроль полноты гарантирует отсутствие ложных срабатываний: если diff действительно полон, Уровень B молчит.

Конфигурация

# Required for --ai flag only
export ANTHROPIC_API_KEY=sk-ant-...

Другая конфигурация не требуется. sourcebook считывает историю git и структуру файлов вашего репозитория напрямую.

Поддержка языков

Исследования

Построено на реальных бенчмарках, а не на ощущениях:

• Проверить результаты валидации — методология и данные о точности

• Бенчмарк: 19 задач, 10 репозиториев, 4 языка — контролируемое тестирование производительности агентов

• Почему автогенерируемый контекст делает агентов хуже — исследование ETH Zurich, которое сформировало наш подход

Лицензия

BSL-1.1 — исходный код доступен, бесплатна для использования, не может предлагаться как хостинг-сервис. Переходит на MIT 25 марта 2030 года. Подробности см. в LICENSE.

sourcebook.run · GitHub · npm · @maroond_

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers