RepoGuardian

RHD 搭載 - Repository Health Director

自律型エンジニアリングインテリジェンス。根拠に基づく意思決定。人間による承認の実行。

GitHub リポジトリを接続します。RHD は、エージェント型 RAG、決定論的なマルチエージェントオーケストレーション、特化型モデルガバナンス、根拠に基づく推論を用いて、その Issue、プルリクエスト、ソースコード、リリース、エンジニアリングリスク、リポジトリの健全性を調査します。

RHD は自動的に分析します。RHD は自動的に推奨します。外部へのアクションを承認するのは人間です。

Related MCP server: GitHub Repo Explainer MCP

ライブアプリケーション

公開 Web アプリ: 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 ミッションコントロール: https://repoguardian-rhd.vercel.app/mission-control

RHD v5 チャットワークスペース: https://repoguardian-rhd.vercel.app

デモリポジトリ: https://github.com/org/repo

公開 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 による基盤準備のみ。プロビジョニングはしていません。

機能マトリクス

誠実な能力レベル定義:

• Working: 本番相当でリグレッションテストに含まれています。

• Beta: v4 アドオンパスとして実装してテストを含めていますが、同期されたリポジトリのデータ品質に依存しています。

• Partial: 基盤はありますが、明示された制約があります。

• Optional: ローカルまたは共通化したプロバイダーが必要。構成なしにパブリッククラウドで有効とすることはありません。

• Roadmap: ドキュメント記載のみで、実装済みではありません。

クイックスタート

軽量ローカル

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 の API ツール、リソース、プロンプトを公開します。書き込み系の成果物は、人間とポリシーで承認された場合のみです。詳細は 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

安全性

• リポジトリへの書き込みは許可リストにより、人間が承認する。

• 公開リポジトリは、ポリシーが明示的に許可しない限り読み取り専用で分析されます。

• プライベートリポジトリの処理は、デフォルトでローカル/決定論的方式です。

• Issue の本文、コメント、README、コード、PR の説明は、信頼できないインプットとして扱います。

• 根拠は、対象の同期済みリポジトリレコードと一致する必要があります。

• フロントエンドの NEXT_PUBLIC_ 変数には、バックエンドのシークレットを含みません。

• 監査ログは安全なサマリーのみを保存し、機密情報や内部推理は保存しません。

現在の制限

• マネージド PostgreSQL/pgvector は資格情報の受け入れは決まっていますが、現在のローカル実行では接続していません。

• Redis はオプションで、ローカルでは未接続です。

• Docker は任意ですが、この環境にはありません。

• qwen3:1.7b の Ollama はローカルで検証済み。qwen3:8b は pull しましたが、デモには遅すぎでした。

• 妥当なラベル付きデータセットがないのに、ML/DL の学習実施を表明しません。

• 本番は、実際にデプロイされた基盤と本番レベルの移行テストが存在するまではグリッド検証済みとしません。

ドキュメント

• API

• MCP

• マネージドクラウド デプロイ

• プロバイダーベンチマーク

• 業界環境の readiness

• 公開ソースの監査

• RHD v4 アーキテクチャ

• RHD v4 デモスクリップ

• RHD v5 チャットワークスペース