repowise：READMEと実装範囲から見る導入判断

繰り返し探索の代わりに事前計算されたインデックス

repowiseはPython製のコマンドラインツールおよびMCPサーバーで、コードベースの単一インデックスを構築し、コミットのたびに最新の状態に保ちます。READMEの中心的な主張は、コーディングエージェントがファイルを繰り返し読むことに多くのコンテキストを費やしているため、repowiseは呼び出し元、変更影響、ファイルリスクなどの回答を事前に計算し、10個のMCPツールを通じて提供するというものです。同じインデックスはローカルダッシュボード、コードヘルススコア、プルリクエストの変更リスクスコアリングにも使われます。READMEによると、最初のインデックスにAPIキーは不要で、セルフホスト使用ではコードがマシンから出ることはありません。 repowise のREADMEに書かれた範囲を基準にすると、ここで扱えるのは設定とコードの確認までです。資料にない性能値や運用保証は判断材料に含めません。 実行日時、版、環境、入力識別子、出力要約、警告を記録し、再現不能な結果は成功例として扱いません。

1回のパスで5つのレイヤー

READMEは、単一パスで構築される5つのレイヤーを説明しています。ファイルとシンボルのノード、フレームワーク認識エッジを持つ依存関係グラフ、ホットスポット、所有権、共変更ペア、バスファクターを含むGit分析、各モジュールとファイルの生成wiki（鮮度と信頼度スコア付き）、8つのソースからマイニングされたアーキテクチャ決定、そして25の決定的マーカーで各ファイルを1から10まで欠陥リスク、保守性、パフォーマンスの3軸でスコアリングするコードヘルスレイヤーです。各レイヤーはCLI、MCPツール、ダッシュボードからクエリ可能です。グラフレイヤーは17言語をカバーすると説明され、後のセクションでは18言語がASTにパースされるとリストされています。wikiはLLMなしで生成でき、必要に応じてモデルによる散文を追加できます。 導入を考える読者は、この節の記述と repowise のリポジトリ内ファイルを突き合わせてください。記載された名前や引数が変われば、同じ結論にはなりません。

コマンド出力の圧縮と変更リスクの評価

READMEには、エージェントが読む前にコマンド出力を圧縮し、エラーを先頭に保ち終了コードを保持する`distill`コマンドがあります。省略された内容にはインラインマーカーが残り、後で展開できるため、エージェントはコマンドを再実行せずに詳細を取り戻せます。プルリクエストについては、repowiseはdiffの形状に基づき、リポジトリ自身の最近のコミットと比較して0から10の決定的な変更リスクスコアを提供します。PRモードは`will_break`、`missing_cochanges`、`missing_tests`、`tests_to_run`などのディレクティブを返します。READMEはまた、各PRに1つのコメントを投稿し、クリーンなPRにはコメントせず、LLM呼び出しを行わない無料のGitHub App PRボットについて説明しています。 反対に、別の実装を選ぶ場面では、同じ処理を何に置き換えるのかを具体化する必要があります。READMEは対応範囲を示しますが、未記載の互換性を保証する資料ではありません。

具体的なリファクタリング計画を伴うコードヘルス

ヘルスレイヤーは、LLM呼び出しなし、クラウドなし、新しいランタイム依存関係なしで、25の決定的マーカーを使用して各ファイルをスコアリングします。READMEによると、3,000ファイルのリポジトリで30秒未満で実行されます。インデックス作成後、repowiseは自身のフラグをリポジトリのgit履歴と照合し、最も低いヘルスのファイルのうち実際にバグ修正があった数を自己チェックとして報告します。次に、Extract Class、Extract Helper、Move Method、Break Cycle、Split File、Extract Methodなどの具体的なリファクタリングを、移動するメソッドとエッジ、呼び出し元のブラスト半径とともに挙げます。READMEは21のオープンソースリポジトリでの検証（ROC AUC 0.737）とCodeSceneとの比較（固定レビュー予算で2.3倍の欠陥）を報告していますが、これらはプロジェクト自身が公表した数字です。 repowise のREADMEに書かれた範囲を基準にすると、ここで扱えるのは設定とコードの確認までです。資料にない性能値や運用保証は判断材料に含めません。

ダッシュボード、ワークスペース、エディタ統合

`repowise serve`はMCPサーバーの横でローカルダッシュボードを起動します。ダッシュボードには、アーキテクチャビュー、コードヘルスマップ、チャット、生成ドキュメント、C4図、ナレッジグラフ、リスク、ホットスポット、結合、ブラスト半径、コントリビューター、決定、シンボル、セキュリティ、デッドコード、統計、コスト、ワークスペースビューが含まれます。ワークスペースを使うと、複数のリポジトリを1つのユニットとしてインデックス化でき、プロデューサーとコンシューマー間のコントラクトマッチング、クロスリポジトリの共変更ペア、フェデレーションMCPが可能です。リンクされたgitワークツリーは検出され、ベースチェックアウトからシードされ、自動同期はコミット後フック、ファイルウォッチャー、webhook、ポーリングで実行できます。VS Code拡張機能はMCPサーバーを登録し、GitHub Copilotに6つのツールを公開します。 導入を考える読者は、この節の記述と repowise のリポジトリ内ファイルを突き合わせてください。記載された名前や引数が変われば、同じ結論にはなりません。

10個のMCPツールとクイックスタート

READMEは10個のMCPツールを説明しています：`get_overview`、`get_answer`、`get_context`、`get_symbol`、`search_codebase`、`get_risk`、`get_change_risk`、`get_why`、`get_dead_code`、`get_health`。各レスポンスはインデックス年齢とインデックス化されたコミットに関するメタデータを運びます。クイックスタートは、`pip install repowise`、次にリポジトリで`repowise init`を実行し、スキャン後に3つのインデックスモードを提供します。キーレスパスは`--no-prose -y`を使用し、APIキーは不要です。`--prose -y`はモデル生成のサブシステムページを書きます。後で`repowise generate`を使えば、コスト見積もりを確認した上でwikiの一部または全部をモデルでアップグレードできます。MCPサーバーは`repowise mcp`で起動します。 反対に、別の実装を選ぶ場面では、同じ処理を何に置き換えるのかを具体化する必要があります。READMEは対応範囲を示しますが、未記載の互換性を保証する資料ではありません。

ライセンス、プライバシー、未検証の部分

このプロジェクトはAGPL-3.0でライセンスされており、READMEによると、個人、チーム、企業が内部的に使用する場合は無料で、エンタープライズ機能には商用ライセンスがあります。ライセンス抜粋は、プログラムをコピー、配布、変更する権限を許可し、ネットワークサーバーの運営者は変更版のソースコードをユーザーに提供することを要求します。READMEは、セルフホストのコードがマシンの外に出ないこと、匿名のオプトアウト可能なテレメトリ、LLMプロバイダーには自前のキーを使うことを述べています。正式なセキュリティ保証、保証、サポートコミットメントは確立されていません。READMEには他のツールとのベンチマーク主張と比較が含まれていますが、それらの数値はプロジェクト自身のものであり、提供された資料では独立に検証されていません。 repowise のREADMEに書かれた範囲を基準にすると、ここで扱えるのは設定とコードの確認までです。資料にない性能値や運用保証は判断材料に含めません。

編集部の結論

repowise はREADMEに示された用途と環境が一致する開発者向けです。対応外の環境や、資料にない性能保証を必要とする運用には向きません。最初に repowise のREADME記載コマンドと設定ファイルを確認し、入力から出力までの差分を記録してください。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes