RepoGuardian

impulsado por RHD - Repository Health Director

Inteligencia autónoma de ingeniería. Decisiones basadas en evidencia. Ejecución controlada por humanos.

Conecta un repositorio de GitHub. RHD investiga sus issues, pull requests, código fuente, releases, riesgos de ingeniería y salud del repositorio utilizando RAG agéntico, orquestación determinista multi-agente, gobernanza de modelos especializada y razonamiento basado en evidencia.

RHD analiza automáticamente. RHD recomienda automáticamente. Los humanos autorizan acciones externas.

Related MCP server: GitHub Repo Explainer MCP

Aplicación en vivo

Aplicación web pública: https://repoguardian-rhd.vercel.app

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

Documentación de API: https://repoguardian-rhd-api.vercel.app/docs

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

Repositorio de demostración: https://github.com/romil569/RepoGuardian-Demo

Flujo público v5.1: pega un repositorio de GitHub en el chat de inicio, ejecuta el análisis, espera a que se completen las etapas del trabajo persistido, luego revisa el artefacto de arquitectura SVG en línea y haz preguntas de seguimiento en el mismo contexto del repositorio.

Arquitectura

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]

Modos de despliegue:

• LIGHTWEIGHT_LOCAL: SQLite, vectores locales, herramientas deterministas/RHD.

• INDUSTRY_LOCAL: PostgreSQL/Redis opcional con Docker cuando Docker existe.

• MANAGED_CLOUD: frontend de Vercel, backend de Vercel Python FastAPI, Neon PostgreSQL/pgvector, cola de Postgres.

• ENTERPRISE_AWS: Fundación Terraform; no aprovisionado.

Matriz de características

Niveles de capacidad veraces:

• Working: compatible con producción y cubierto por pruebas de regresión.

• Beta: implementado como una ruta v4 aditiva y cubierto por pruebas, pero depende de la calidad de los datos sincronizados del repositorio.

• Partial: existe la base, con restricciones explícitamente documentadas.

• Optional: requiere proveedor local/configurado; nunca se afirma activo en la nube pública sin configuración.

• Roadmap: solo documentado, no representado como comportamiento enviado.

Inicio rápido

Local ligero

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

Abre http://127.0.0.1:3000.

Local industrial

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

Docker PostgreSQL/Redis se usan solo cuando Docker está instalado. De lo contrario, la ruta ligera estable sigue disponible.

Nube gestionada

Punto de entrada del backend de Vercel: api/index.py.

Entorno requerido del backend:

• 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

Entorno del frontend:

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

Consulta docs/deployment-managed-cloud.md y docs/vercel-backend-audit.md.

MCP

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

MCP expone herramientas, recursos y prompts de RHD. Las acciones con control de escritura permanecen controladas por humanos/políticas. Consulta docs/mcp.md.

Pruebas

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

Seguridad

• Las escrituras en el repositorio están en la lista de permitidos y requieren aprobación humana.

• Los repositorios públicos se analizan en modo de solo lectura a menos que la política permita explícitamente escrituras.

• Los repositorios privados se procesan por defecto de forma local/determinista.

• El texto de issues, comentarios, archivos README, código y descripciones de PR se tratan como evidencia no confiable.

• La evidencia debe corresponder a registros sincronizados del repositorio.

• Las variables NEXT_PUBLIC_ del frontend nunca contienen secretos del backend.

• Los registros de auditoría almacenan resúmenes seguros, no secretos ni razonamientos privados.

Límites actuales

• PostgreSQL/pgvector gestionado está listo para credenciales pero no conectado en esta ejecución local.

• Redis es opcional y no está conectado localmente.

• Docker sigue siendo opcional y no está disponible en la máquina actual.

• qwen3:1.7b Ollama fue validado localmente; qwen3:8b se descargó pero era demasiado lento para la demo.

• No se afirma entrenamiento de ML/DL sin un conjunto de datos etiquetado defendible.

• La producción no se marca como validada hasta que existan infraestructura desplegada y pruebas de producción en vivo.

Documentación

• API

• MCP

• Despliegue en nube gestionada

• Benchmark de proveedores

• Preparación para la industria

• Auditoría de código fuente público

• Arquitectura de RHD v4

• Guion de demostración de RHD v4

• Espacio de trabajo de chat de RHD v5