RepoGuardian

RHD(Repository Health Director) 기반

자율 엔지니어링 인텔리전스. 증거 기반 의사 결정. 인간 통제 실행.

GitHub 저장소를 연결하세요. RHD가 에이전트 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 채팅 워크스페이스: 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가 존재하는 경우 선택적 Docker PostgreSQL/Redis.

• 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

안전

• 저장소 쓰기는 허용 목록에 있으며 인간 승인이 필요합니다.

• 공개 저장소는 정책이 명시적으로 쓰기를 허용하지 않는 한 읽기 전용 모드로 분석됩니다.

• 비공개 저장소는 기본적으로 로컬/결정론적 처리를 사용합니다.

• 이슈 텍스트, 댓글, README 파일, 코드 및 PR 설명은 신뢰할 수 없는 증거로 취급됩니다.

• 증거는 동기화된 저장소 레코드와 일치해야 합니다.

• 프론트엔드 NEXT_PUBLIC_ 변수에는 백엔드 비밀번호가 절대 포함되지 않습니다.

• 감사 로그는 비밀번호나 비공개 추론이 아닌 안전한 요약을 저장합니다.

현재 제한 사항

• 관리형 PostgreSQL/pgvector는 자격 증명 준비가 되었지만 이 로컬 실행에서는 연결되지 않았습니다.

• Redis는 선택 사항이며 로컬에서 연결되지 않았습니다.

• Docker는 선택 사항이며 현재 머신에서 사용할 수 없습니다.

• qwen3:1.7b Ollama는 로컬에서 검증되었습니다. qwen3:8b는 풀링되었지만 데모에 너무 느렸습니다.

• 방어 가능한 라벨링된 데이터셋 없이 ML/DL 학습을 주장하지 않습니다.

• 배포된 인프라와 실시간 프로덕션 테스트가 존재할 때까지 프로덕션은 검증된 것으로 표시되지 않습니다.

문서

• API

• MCP

• 관리형 클라우드 배포

• 제공자 벤치마크

• 산업 준비 상태

• 공개 소스 감사

• RHD v4 아키텍처

• RHD v4 데모 스크립트

• RHD v5 채팅 워크스페이스