RepoGuardian

unterstützt von RHD - Repository Health Director

Autonome Engineering-Intelligenz. Evidenzbasierte Entscheidungen. Menschlich kontrollierte Ausführung.

Verbinden Sie ein GitHub-Repository. RHD untersucht dessen Issues, Pull Requests, Quellcode, Releases, Engineering-Risiken und Repository-Gesundheit mithilfe von agentischem RAG, deterministischer Multi-Agenten-Orchestrierung, spezialisierter Modell-Governance und evidenzbasierter Argumentation.

RHD analysiert automatisch. RHD empfiehlt automatisch. Menschen autorisieren externe Aktionen.

Related MCP server: GitHub Repo Explainer MCP

Live-Anwendung

Öffentliche Web-App: https://repoguardian-rhd.vercel.app

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

API-Dokumentation: https://repoguardian-rhd-api.vercel.app/docs

Architektur: 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

Demo-Repository: https://github.com/romil569/RepoGuardian-Demo

Öffentlicher v5.1-Ablauf: Fügen Sie ein GitHub-Repository in den Home-Chat ein, führen Sie die Analyse aus, warten Sie, bis die persistenten Job-Phasen abgeschlossen sind, und überprüfen Sie dann das Inline-SVG-Architektur-Artefakt und stellen Sie Folgefragen im selben Repository-Kontext.

Architektur

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]

Bereitstellungsmodi:

• LIGHTWEIGHT_LOCAL: SQLite, lokale Vektoren, deterministische/RHD-Tools.

• INDUSTRY_LOCAL: optionales Docker PostgreSQL/Redis, wenn Docker vorhanden ist.

• MANAGED_CLOUD: Vercel-Frontend, Vercel-Python-FastAPI-Backend, Neon PostgreSQL/pgvector, Postgres-Warteschlange.

• ENTERPRISE_AWS: Terraform-Grundlage; nicht bereitgestellt.

Funktionsmatrix

Ehrliche Fähigkeitsstufen:

• Working: produktionskompatibel und durch Regressionstests abgedeckt.

• Beta: als additiver v4-Pfad implementiert und durch Tests abgedeckt, hängt jedoch von der Qualität der synchronisierten Repository-Daten ab.

• Partial: Grundlage vorhanden, mit explizit dokumentierten Einschränkungen.

• Optional: erfordert lokalen/konfigurierten Anbieter; wird ohne Konfiguration nie als aktiv in der öffentlichen Cloud beansprucht.

• Roadmap: nur dokumentiert, nicht als ausgeliefertes Verhalten dargestellt.

Schnellstart

Leichtgewichtiges Lokal

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

Öffnen Sie http://127.0.0.1:3000.

Industrie-Lokal

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

Docker PostgreSQL/Redis werden nur verwendet, wenn Docker installiert ist. Andernfalls bleibt der stabile leichtgewichtige Pfad verfügbar.

Verwaltete Cloud

Backend-Vercel-Einstiegspunkt: api/index.py.

Erforderliche Backend-Umgebung:

• 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

Frontend-Umgebung:

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

Siehe docs/deployment-managed-cloud.md und docs/vercel-backend-audit.md.

MCP

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

MCP stellt RHD-Tools, Ressourcen und Prompts bereit. Schreibaktionen bleiben durch Menschen/Policy gesteuert. Siehe docs/mcp.md.

Testen

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

Sicherheit

• Repository-Schreibvorgänge sind auf eine Whitelist beschränkt und erfordern menschliche Genehmigung.

• Öffentliche Repositorys werden im Nur-Lese-Modus analysiert, sofern die Richtlinie Schreibvorgänge nicht ausdrücklich erlaubt.

• Private Repositorys verwenden standardmäßig lokale/deterministische Verarbeitung.

• Issue-Text, Kommentare, README-Dateien, Code und PR-Beschreibungen werden als nicht vertrauenswürdige Evidenz behandelt.

• Evidenz muss mit synchronisierten Repository-Datensätzen übereinstimmen.

• Frontend-NEXT_PUBLIC_-Variablen enthalten niemals Backend-Geheimnisse.

• Audit-Logs speichern sichere Zusammenfassungen, keine Geheimnisse oder private Überlegungen.

Aktuelle Grenzen

• Verwaltetes PostgreSQL/pgvector ist für Anmeldeinformationen bereit, aber in diesem lokalen Lauf nicht verbunden.

• Redis ist optional und lokal nicht verbunden.

• Docker bleibt optional und auf der aktuellen Maschine nicht verfügbar.

• qwen3:1.7b Ollama wurde lokal validiert; qwen3:8b wurde heruntergeladen, war aber für die Demo zu langsam.

• ML/DL-Training wird ohne einen vertretbaren gelabelten Datensatz nicht beansprucht.

• Produktion wird erst als validiert markiert, wenn bereitgestellte Infrastruktur und Live-Produktionstests existieren.

Dokumentation

• API

• MCP

• Managed Cloud Deployment

• Provider Benchmark

• Industry Readiness

• Public Source Audit

• RHD v4 Architecture

• RHD v4 Demo Script

• RHD v5 Chat Workspace