RepoGuardian

на базе RHD — Repository Health Director

Автономная инженерная аналитика. Решения на основе доказательств. Выполнение под контролем человека.

Подключите GitHub-репозиторий. RHD исследует его issues, pull request'ы, исходный код, релизы, инженерные риски и состояние репозитория с помощью агентного RAG, детерминированной мультиагентной оркестрации, специализированного управления моделями и рассуждений на основе доказательств.

RHD анализирует автоматически. RHD рекомендует автоматически. Люди авторизуют внешние действия.

Related MCP server: GitHub Repo Explainer MCP

Живое приложение

Публичное веб-приложение: https://repoguardian-rhd.vercel.app

FastAPI: https://repoguardian-rhd-api.vercel.app

Документация API: https://repoguardian-rhd-api.vercel.app/docs

Архитектура: https://repoguardian-rhd.vercel.app/architecture

RHD v4 Mission Control: https://repoguardian-rhd.vercel.app/mission-control

RHD v5 Chat Workspace: https://repoguardian-rhd.vercel.app

Демонстрационный репозиторий: https://github.com/romil569/RepoGuardian-Demo

Публичный сценарий v5.1: вставьте GitHub-репозиторий в чат на главной странице, запустите анализ, дождитесь завершения сохранённых этапов задания, затем просмотрите сгенерированную SVG-схему архитектуры и задавайте уточняющие вопросы в том же контексте репозитория.

Архитектура

flowchart LR
  G[GitHub] --> W[Webhooks / Sync]
  W --> Q[Event Queue]
  Q --> RI[Repository Intelligence]
  RI --> S[(SQL + Vector + Graph)]
  S --> AR[Agentic RAG]
  AR --> RHD[RHD Supervisor]
  RHD --> A[Specialist Agents]
  A --> ML[ML / DL Intelligence]
  ML --> EC[Evidence Critic]
  EC --> PG[Policy Gate]
  PG --> HR[Human Review]
  HR --> GA[GitHub Action]

Режимы развёртывания:

• LIGHTWEIGHT_LOCAL: SQLite, локальные векторы, детерминированные/RHD-инструменты.

• INDUSTRY_LOCAL: опциональные Docker PostgreSQL/Redis при наличии Docker.

• MANAGED_CLOUD: фронтенд на Vercel, бэкенд Vercel Python FastAPI, Neon PostgreSQL/pgvector, очередь Postgres.

• ENTERPRISE_AWS: фундамент на Terraform; не разворачивается.

Матрица возможностей

Уровни честного описания возможностей:

• Работает: совместимо с продакшеном и покрыто регрессионными тестами.

• Бета: реализовано как аддитивный путь v4 и покрыто тестами, но зависит от качества синхронизированных данных репозитория.

• Частично: существует фундамент с явно задокументированными ограничениями.

• Опционально: требует локального/настроенного провайдера; не заявляется как активное в публичном облаке без конфигурации.

• Дорожная карта: только задокументировано, не заявляется как реализованное поведение.

Быстрый старт

Лёгкий локальный режим

cd C:\Users\HP\Desktop\RepoGuardian
copy .env.example .env
copy backend\.env.example backend\.env
.\scripts\start-dev.ps1

Откройте http://127.0.0.1:3000.

Локальный индустриальный режим

cd C:\Users\HP\Desktop\RepoGuardian
.\scripts\start-industry-local.ps1
.\scripts\doctor.ps1

Docker PostgreSQL/Redis используются только при установленном Docker. В противном случае остаётся доступен стабильный лёгкий путь.

Управляемое облако

Точка входа бэкенда Vercel: api/index.py.

Требуемые переменные окружения бэкенда:

• DEPLOYMENT_MODE=MANAGED_CLOUD

• DATABASE_URL=postgresql://...

• POSTGRES_RUNTIME_MODE=managed

• QUEUE_BACKEND=postgres

• PUBLIC_ANALYSIS_MODE=true

• GITHUB_WRITE_MODE=disabled

• FRONTEND_URL=https://...

• CORS_ORIGINS=https://...

• ENABLE_STARTUP_SCHEMA_CREATE=false

Переменные окружения фронтенда:

NEXT_PUBLIC_API_URL=https://your-fastapi-service.example.com

См. docs/deployment-managed-cloud.md и docs/vercel-backend-audit.md.

MCP

cd mcp-server
npm install
$env:REPOGUARDIAN_API_URL="http://127.0.0.1:8000"
npm start

MCP предоставляет RHD-инструменты, ресурсы и промпты. Действия с записью остаются ограниченными человеком/политиками. См. docs/mcp.md.

Тестирование

cd backend
.\.venv\Scripts\python -m pytest

cd frontend
npm run lint
npm run typecheck
npm run build
npm run e2e

cd mcp-server
npm run typecheck
npm test

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

• Запись в репозиторий разрешена по белому списку и требует одобрения человека.

• Публичные репозитории анализируются в режиме только для чтения, если политика явно не разрешает запись.

• Частные репозитории по умолчанию обрабатываются локально/детерминированно.

• Текст issues, комментарии, README-файлы, код и описания PR рассматриваются как недоверенные доказательства.

• Доказательства должны соответствовать синхронизированным записям репозитория.

• Переменные фронтенда NEXT_PUBLIC_ никогда не содержат секретов бэкенда.

• Журналы аудита хранят безопасные сводки, а не секреты или приватные рассуждения.

Текущие ограничения

• Управляемый PostgreSQL/pgvector готов к учётным данным, но не подключён в этом локальном запуске.

• Redis опционален и не подключён локально.

• Docker остаётся опциональным и недоступен на текущей машине.

• Ollama qwen3:1.7b была проверена локально; qwen3:8b была загружена, но слишком медленная для демо.

• ML/DL-обучение не заявляется без защищённого размеченного набора данных.

• Продакшен не помечается как проверенный, пока не развёрнута инфраструктура и не проведено живое продакшен-тестирование.

Документация

• API

• MCP

• Развёртывание в управляемом облаке

• Сравнительный анализ провайдеров

• Индустриальная готовность

• Публичный аудит исходного кода

• Архитектура RHD v4

• Сценарий демо RHD v4

• RHD v5 Chat Workspace