Repository Inspector

Это небольшой инструмент для разработчиков на TypeScript, который проверяет изменения в Git-репозитории, запускает дополнительные команды валидации и создает отчет в формате Markdown. Его можно использовать из командной строки или подключать к ИИ-клиентам через MCP.

Ваша задача

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

От вас не требуется успеть все. Нам важно, как вы исследуете, расставляете приоритеты, реализуете, проверяете и объясняете значимый объем работы.

Related MCP server: repository-inspector

Продуктовое решение

Инструментом могут пользоваться как разработчики напрямую, так и ИИ-агенты для написания кода. Решите, каким должен быть основной интерфейс: CLI-first, MCP-first или гибридный. Внесите улучшения в соответствии с вашим решением.

Предпочтительного варианта нет. Опишите:

• Основного пользователя и среду выполнения, на которую вы ориентировались.

• Границу доверия и разрешенные возможности.

• Компромиссы по надежности, обнаруживаемости, задержке/контексту и размеру вывода.

• Как интерфейсы, которые вы продолжаете поддерживать, остаются согласованными по поведению.

• Какие доказательства могли бы изменить ваше решение.

Время и правила

• Максимум 90 минут целенаправленной работы в течение 48 часов с момента получения приглашения.

• Свободно используйте ИИ-инструменты для написания кода. Проверяйте их работу и задокументируйте как минимум одно предложение, которое вы исправили или отклонили.

• Работайте в собственном репозитории, созданном из этого шаблона.

• Делайте коммиты по мере работы и заполните SUBMISSION.md в финальном коммите.

• Завершение не обязательно. Точный объем и проверка важнее большого диффа.

Установка

npm install
npm run typecheck
npm test

CLI

npm run inspector -- review --repo ./path/to/repo --format markdown
npm run inspector -- review --repo ./path/to/repo --validate "npm test"

Отчет записывается в review-report.md.

MCP

Запустите stdio-сервер командой:

npm run mcp-server

Он предоставляет инструмент review_repository, принимающий repo_path (обязательный), base_ref (необязательный) и validation_commands (необязательный массив shell-команд).

Аргументами MCP можно управлять через содержимое проверяемого репозитория (инъекция промптов), поэтому запуск команд валидации через MCP отключен по умолчанию. Чтобы включить его, оператор сервера должен задать обе переменные окружения — если задана только одна, валидация остается отключенной:

• INSPECTOR_ALLOW_VALIDATION=1

• INSPECTOR_VALIDATION_ALLOWLIST="npm test,npm run typecheck" — разделенный запятыми список точных команд, которым разрешено выполняться; все остальные пропускаются.

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

Структура проекта

src/core.ts         shared review orchestration
src/cli.ts          command-line adapter
src/mcp-server.ts   MCP adapter
src/git.ts          Git inspection
src/validation.ts   validation execution
src/report.ts       Markdown report generation
test/               public starter tests

По завершении отправьте через Security → Report a vulnerability в этом репозитории — см. SECURITY.md, чтобы узнать, что именно включить. Не отвечайте по электронной почте; этот канал отправки не отслеживается.