MaguyvaのTypeScript対応: モノレポのためのより良いコンテキスト

TypeScriptのページが重要な理由

TypeScriptは、多くのチームがAI支援によるリファクタリングにようやく安心感を抱けると期待する言語です。型システムは助けにはなりますが、本当の問題を取り除いてはくれません。共有パッケージ、DTO、生成されたクライアント、Reactコンポーネント、テスト、アプリコードのすべてが、大規模なリポジトリの中で同じ名前を引き合いに出しているという問題です。

TypeScriptにとって、基準は「構文を理解している」よりも高いところにあります。エージェントは、共有の型、フック、クライアントを編集する前に、定義から実装、影響範囲へとコントラクトをたどる必要があります。

MaguyvaがTypeScriptで実際に抽出するもの

Maguyvaは、.ts、.mts、.cts、そしてテストやストーリー周りの一般的なTypeScriptファイルのバリエーションにわたって、クラス、メソッド、インターフェース、型エイリアスを抽出します。メンバー接頭辞は正規化される一方、クラス修飾された識別子は保持されます。これは、リポジトリに素のヘルパー名と、同じ末尾セグメントを持つクラススコープのメソッドの両方がある場合に役立ちます。

JSXは、はぐれたマークアップではなく本物の構造シグナルとして扱われ、シンボルの期待値は多くのテスト、ストーリー、設定のパスを明示的にスキップします。これはモノレポにおいて重要です。そうでなければ、エージェントは実際の実装面ではなく足場の再発見に時間を使いすぎてしまうからです。

TypeScriptのリポジトリに役立つMCPワークフロー

通常、次の3つの出発点のパターンで十分です。

• find_symbolを使う — インターフェース、型エイリアス、フック、サービスの名前がすでに分かっているとき。
• dependency_searchを使う — パッケージ横断で波及する可能性のある共有の型やクライアントを変更する前に。
• structural_searchを使う — キーワード一致ではなくコードの形が必要なとき、例えば繰り返されるコンポーネントやメソッドのパターンなど。

「チェックアウトの送信パスを追う」のような概念的な疑問には、生の検索よりもget_task_contextの方がしばしば良い最初の一手になります。

このページが特に関連する場面

このページは、TypeScriptが複数のパッケージの調整レイヤーとなっているWeb/プラットフォームのモノレポにおいて、最も力を発揮します。リポジトリに今も古いJSが多く含まれる場合は、JavaScriptガイドを読んでください。あなたの疑問が本当に「エージェントはアプリコードとインフラのコンテキストを一緒に保持できるか」というものであれば、これをTerraformと組み合わせて読んでください。