Barrhawk Premium E2e MCP

🚀 BARRHAWK: VERIFY YOUR VIBECODE

エージェントの検証とオーケストレーションのためのオペレーティングシステム

██████╗  █████╗ ██████╗ ██████╗ ██╗  ██╗ █████╗ ██╗    ██╗██╗  ██╗
██╔══██╗██╔══██╗██╔══██╗██╔══██╗██║  ██║██╔══██╗██║    ██║██║ ██╔╝
██████╔╝███████║██████╔╝██████╔╝███████║███████║██║ █╗ ██║█████╔╝
██╔══██╗██╔══██║██╔══██╗██╔══██╗██╔══██║██╔══██║██║███╗██║██╔═██╗
██████╔╝██║  ██║██║  ██║██║  ██║██║  ██║██║  ██║╚███╔███╔╝██║  ██╗
╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝ ╚══╝╚══╝ ╚═╝  ╚═╝
                                            v0.5.0 | TRIPARTITE RELEASE

"もしあなたのエージェントが自分自身をテストできないなら、それは単なる幻想に過ぎない。"

🚀 クイックスタート

# 1. クローンしてインストール
git clone git@github.com:barrhawk/barrhawk_premium_e2e_mcp.git
cd barrhawk_premium_e2e_mcp
bun install

# 2. スタックを起動
bun run barrhawk

# 3. テストを送信
curl -X POST http://localhost:7001/plan \
  -H "Content-Type: application/json" \
  -d '{"intent":"take a screenshot of the homepage","url":"https://example.com"}'

スタックモード

bun run barrhawk           # 完全なトリパーティトスタック (Bridge, Doctor, Igor, Frank)
bun run barrhawk --minimal # Bridge + Igor のみ (軽量版)
bun run barrhawk --hub     # 完全なスタック + テストオーケストレーションハブ

✨ 主な機能

v0.5.0の新機能

• 統合スタック - 単一のコマンド bun run barrhawk ですべてを起動できます。
• 統合ダッシュボード - http://localhost:7000/dashboard でライブモニタリングが可能です。
• エクスペリエンスシステム - セッションをまたいで学習する自己修復セレクターが搭載されています。
• ツール注入 - 新しいツールが実行中のIgorにリアルタイムで配信されます。
• Lightning Strike - Igorが行き詰まったときに自動的にClaudeにエスカレートします。
• ハブモード - --hub フラグを使用して、複数のIgorを用いたテストオーケストレーションが可能です。

📚 ドキュメント

トリパーティトアーキテクチャ

WebSocketを介して通信する4つの専用サーバーがあります。

動作原理

1. あなたがDoctorにインテント "test the login flow" を送信します。
2. Doctorがエクスペリエンスを参照し、プランを生成し、ツールを選択します。
3. Igorがプランをステップごとに実行します。
4. Frankensteinがブラウザーを制御し、スクリーンショットを撮ります。
5. エクスペリエンスが次回のために成功した内容を記録します。

Lightning Strike (Dual-Mode Igor)

Igorは「ダムモード」で起動します - 高速な正規表現ベースの実行です。あるステップが3回失敗すると、Igorは「ストライク」して、完全なClaudeの推論にエレベートして問題を解決し、その後元に戻ります。

エンドポイント

Doctor (ポート7001)

# プランを送信
POST /plan
{"intent": "click the login button", "url": "https://example.com"}

# プランのステータスを確認
GET /plans
GET /plans/:id

Bridge (ポート7000)

# ヘルスチェック
GET /health

# ライブダッシュボード
GET /dashboard

Igor (ポート7002)

# ステータス
GET /status
GET /health

# 現在のツールバッグ
GET /toolbag

Frankenstein (ポート7003)

# ヘルスとツール
GET /health
GET /tools

プロジェクト構造

/
├── bin/barrhawk.ts          # CLIエントリーポイント
├── tripartite/              # コアスタック
│   ├── bridge/              # メッセージバス + ダッシュボード (7000)
│   ├── doctor/              # プランナー + スワームロジック (7001)
│   ├── igor/                # エグゼキューター + Lightning (7002)
│   ├── frankenstein/        # ブラウザー + ツールフォージ (7003)
│   └── shared/              # 共通ユーティリティ
│       ├── experience.ts    # 学習システム
│       ├── tool-registry.ts # 120以上のツール定義
│       └── types.ts         # 共有型
├── hub/                     # テストオーケストレーション (--hubモード)
│   ├── index.ts             # ハブAPI (7010)
│   ├── coordinator.ts       # 複数Igorの同期 (7011)
│   └── igor-db.ts           # データベースウォッチャー (7012)
├── packages/                # 機能モジュール
│   ├── golden/              # ビジュアル回帰
│   ├── self-heal/           # セレクター戦略
│   └── ...                  # 30以上のパッケージ
└── docs/                    # ドキュメント
    └── specs/               # コンポーネント仕様

MCP統合

BarrHawkはClaude Code、Cursor、その他のAIアシスタント向けのMCPツールを公開しています。

Claude Codeの設定

./scripts/generate-mcp-configs.sh

主要なツール

// 自然言語自動化
frank_execute({ task: "Log into github.com", url: "https://github.com" })

// 並列テスト
frank_swarm_execute({ intent: "Test checkout flow", maxIgors: 4 })

// OSレベルの制御 (拡張機能、ダイアログ)
frank_os_mouse({ action: "click", x: 100, y: 200 })
frank_os_keyboard({ combo: "ctrl+shift+i" })

// スクリーンショット
frank_screenshot({ fullPage: true })

エクスペリエンスシステム

BarrHawkはすべてのテスト実行から学習します。

• セレクター：どの要素にどのCSSセレクターが有効か
• タイミング：各サイトでのアクションに通常かかる時間
• エラー：一般的なエラーパターンとその修正方法
• サイト：事前にマッピングされたセレクターを持つ既知のサイトパターン

データは experiencegained/experience.json に保存されます (EXPERIENCE_DIR で設定可能)。

開発

# テストを実行
bun test

# 型チェック
bun run typecheck

# ログを表示
tail -f /tmp/tripartite-*.log

📄 ライセンス

MIT

"信じるが、検証する。" — BarrHawk