ClawPatch: код-ревью, которое видит фичу целиком, а не отдельный файл

ClawPatch — CLI-инструмент для автоматического код-ревью, который разбивает репозиторий на семантические фичи (маршруты, команды, пакеты, тесты), ревьюит каждую через AI-провайдер и сохраняет находки с аудит-трейлом. В отличие от линтеров, анализирует не отдельные файлы, а функциональные срезы кодовой базы — с входными точками, связанными файлами и границами доверия.

Что это

ClawPatch — open-source CLI от команды OpenClaw (Peter Steinberger, создатель OpenClaw). Инструмент решает задачу, которую традиционные линтеры и файловые сканеры не покрывают: ревью кода в контексте фичи, а не отдельного файла.

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

• clawpatch init — определяет тип проекта, пакетный менеджер, тестовые команды.
• clawpatch map — строит карту семантических фич: маршруты Next.js, Go-пакеты, Rust-крейты, Python-модули, SwiftPM-таргеты.
• clawpatch review — отправляет каждую фичу AI-провайдеру (сейчас Codex CLI) на ревью.
• Все находки сохраняются с категорией, серьёзностью, уверенностью и конкретными доказательствами.
• clawpatch fix —finding — патч для одной конкретной находки с валидацией.

Весь процесс — явный, без скрытых коммитов и автоматических мёржей. Лицензия — MIT.

Зачем нужно

• Получить код-ревью не по файлам, а по фичам — AI видит entrypoints, owned files, тесты и trust boundaries одновременно.
• Структурировать находки: категория (bug / security / performance / docs-gap / test-gap / maintainability), серьёзность (critical → low), уровень уверенности.
• Патчить по одной находке за раз с валидацией (typecheck, lint, format, тесты) — без скрытых коммитов.
• Масштабировать ревью на mono-repo: семантическая карта разбивает большой репозиторий на управляемые единицы.
• Сохранять персистентное состояние в .clawpatch/ — можно остановить и продолжить в любой момент.

Как устроено

Основные возможности

Поддерживаемые языки и фреймворки

• Node.js / TypeScript — npm package bins, workspace scripts (start, build, test, lint, typecheck, format).
• Next.js — app/ и pages/ маршруты.
• Python — project metadata, console scripts, bounded source groups, pytest suites, Flask routes.
• Go — go list ./…, command packages, internal packages, тесты.
• Rust — src/main.rs, src/bin/*.rs, src/lib.rs, crates, integration tests.
• SwiftPM — Sources/* таргеты и Tests/* suites.
• Java / Kotlin — Gradle source groups, JVM semantic roles по аннотациям и интерфейсам.
• Конфиги — общие файлы конфигурации проекта.

AI-провайдеры

Сейчас ClawPatch поддерживает один production-провайдер — Codex CLI (локальный). Провайдер вызывается через codex exec со строгими JSON-схемами.

• codex — локальный Codex CLI (основной).
• mock — детерминированный тестовый провайдер.
• mock-fail — тестовый провайдер с ошибками.

Прямая интеграция с OpenAI, Claude, Gemini и другими провайдерами пока не реализована. Планируется в будущих версиях.

clawpatch init          # Инициализация проекта, определение конфигурации
clawpatch map           # Построение семантической карты фич
clawpatch status        # Статус проекта, счётчики фич и находок
clawpatch review        # Ревью фич, поиск проблем
clawpatch report        # Генерация Markdown-отчёта
clawpatch next          # Следующая приоритетная находка
clawpatch show --finding <id>   # Детали находки с evidence
clawpatch triage --finding <id>  # Разметка статуса находки
clawpatch fix --finding <id>     # Патч одной находки
clawpatch revalidate    # Перепроверка находок
clawpatch doctor        # Проверка окружения

# npm
npm install -g clawpatch

# pnpm
pnpm add -g clawpatch

# Из исходников
git clone https://github.com/openclaw/clawpatch.git
cd clawpatch
pnpm install
pnpm run build
pnpm link --global

Безопасность

ClawPatch построен с жёсткими гарантиями безопасности:

• Ревью не меняет файлы. Команда review работает в read-only режиме.
• Фикс — явный. Только через fix —finding, по одной находке за раз.
• Чистое дерево. По умолчанию блокирует фиксы на грязном worktree.
• Нет скрытых действий. Никогда не коммитит, не пушит, не открывает PR.
• Валидация схем. Все ответы провайдера проверяются через строгие JSON-схемы.
• Аудит-трейл. Все раны, находки и патч-попытки сохранены в .clawpatch/.

Пример

Типичный сценарий код-ревью перед релизом:

# Инициализировать в проекте
clawpatch init

# Построить карту фич
clawpatch map

# Прогнать ревью параллельно (5 воркеров)
clawpatch review --limit 50 --jobs 5

# Сгенерировать отчёт
clawpatch report > code-review.md

# Закрыть находки с фиксом
clawpatch fix --finding <id>
clawpatch fix --finding <id>

После крупного рефакторинга запускается ревью на затронутых фичах — ClawPatch видит контекст шире, чем линтер, и ловит регрессии, которые файловый сканер не заметил бы.

Контекст: как OpenClaw использует ClawPatch

Peter Steinberger (создатель OpenClaw) рассказывает, что команда постоянно запускает около 100 Codex-инстанций в облаке. ClawPatch используется для разбиения всех проектов на функциональные единицы и поиска багов и регрессий. Отдельно тот же подход применяется для security-аудита совместно с Vercel DeepSec и Codex Security.