voyager-repo

voyager-repo

Voyager のリポジトリ調査器官 — 未知のリポジトリに触れる前に、AI エージェントが先遣させる目。

Voyager は ウェブ（@dir-ai/voyager）、リポジトリ（これ）、そして次は ネットワークへと調査範囲を広げます。Repotector はリポジトリの守護者として 受け取り、制御 します。一方、Voyager Repo はエージェントの相棒として 外へ踏み出し、安全に報告を返します。

npx @dir-ai/voyager-repo scout .          # orient in the repo you're standing in
npx @dir-ai/voyager-repo scout . --check-deps 10   # + vet 10 deps via Voyager

できること

Claude や Codex が新しいコードベースを把握するように、安全かつ繰り返し実行できるツールとして機能します。scout は 概要ブリーフを生成します。

• 目的 — マニフェスト／README から推定し、信頼できない情報として扱います（オーナーのテキストはモデルに届く前にインジェクションを除去します）
• 構成 — 言語、主要ディレクトリ（役割の推定を含む）、エントリーポイント
• ビルド — インストール／ビルド／テスト／実行コマンド（検出のみで、実行はしません）
• 健全性 — git のシグナル：コミット数、バスファクター（上位作者の割合）、最近の更新状況、変更が集中する箇所
• 依存関係 — Voyager と連携し、各依存関係に OSV に基づく実際の判定を提供します（--check-deps N）
• リスク — インストールフック（npm install での RCE）、コミット済みのシークレット、ロックファイルの欠如、大きく内容が不透明なバイナリ
• 調査計画 — 下記を参照

調査プロトコル（要点）

慎重な新参者として振る舞い、手当たり次第に変更を加えません。

1. リポジトリに Repotector（.repotector/）がある場合は、まず Repotector とハンドシェイクします。有効なゾーン／リースを読み取り、編集前にその指示を尊重します。
2. 権限はフェイルクローズです。 デフォルトではすべて 読み取り専用です。依存関係のインストール、コードの実行、リモートリポジトリのクローンは、同意するまで保留されます（--allow-install／--allow-exec／--allow-clone）。また、実行を許可した場合はサンドボックス内で行います。
3. 順序立てて調査します。 ブリーフの最後に、適切に振る舞うエージェントが次に取るべき手順を順番に示し、行き当たりばったりに調べるのではなく、目的を持って探索できるようにします。

保証

• 対象内のものがホスト上で実行されることはありません。 scout はファイルと git を読み取るだけで、リポジトリのコードを実行しません。（同意を得て実行する場合は、Voyager の強化されたコンテナ内で実行します。）
• オーナーが管理するすべてのバイトは信頼できない情報として扱われます — README、説明、コミットメッセージ、Repotector の台帳は、モデルに表示される前にインジェクションを除去し、信頼できない情報として示します。
• 終了コード： 0 把握済み · 1 把握済み＋高リスクの検出事項あり · 2 ツールエラー

MCP

voyager-repo mcp

ツール：scout_repo — 同じ概要を安全をデフォルトとする設定（侵襲的なフラグは無効）で提供します。

ライブラリ

import { scout } from '@dir-ai/voyager-repo'
const brief = await scout('/path/to/repo', { checkDeps: 10 })
if (brief.risks.some((r) => r.level === 'high')) { /* caution */ }

ステータス

0.x — Voyager の「感覚」シリーズにおけるフェーズ 1（リポジトリの概要把握）です。ロードマップ： パッケージの tarball の機能分析、PyPI／cargo／go の依存関係の審査、そして net 器官（クラウド／インフラの調査）。

ライセンス

MIT