@amazon-devices/amazon-devices-buildertools-mcp 0.1.29 → 0.1.31

package/README.ja.md

@@ -22,6 +22,11 @@ Amazon Devices Builder Tools MCPは以下の機能をサポートしています
 | **フォーカス管理** | TVインターフェース用のD-Padナビゲーションとフォーカス管理を実装 | <ul><li>`フォーカス管理を示すために2つのボタンを持つアプリを作成できますか？`</li></ul> |
 | **SDK & CLI** | SDKのインストール/更新と、仕様駆動型CLIを介した効率的なCLIツールの実行 | <ul><li>`AIエージェントからSDKをインストール/更新`</li><li>`アプリをビルド`</li><li>`仮想デバイスでアプリを実行`</li><li>`物理デバイスでアプリを実行`</li><li>`KPI Visualizerを実行してパフォーマンス結果を取得`</li></ul> |
 | **クラッシュ分析**              | JavaScript、Native、LMK、ANRクラッシュの自動ACR分析による診断                    | <ul><li>`なぜアプリがクラッシュしたのですか？`</li><li>`このACRファイルを分析してください /path/to/crash.acr`</li></ul>                                                                                                                                                                                                                                                |
+| **キー入力レイテンシー**          | JSスレッドパフォーマンスと入力イベント分析によるキー入力レイテンシーの問題を診断・解決 | <ul><li>`なぜアプリのキー入力が遅いのですか？`</li><li>`Vegaアプリのキー入力レイテンシーを診断してください`</li><li>`ボタンクリックが遅く感じます、助けてください`</li></ul>                                                                                                                                                 |
+| **UI流暢性**                | コンポーネント再レンダリングとCPUパフォーマンス分析によるUI流暢性KPI障害の診断    | <ul><li>`アプリのUI流暢性スコアが低いです、診断してください`</li><li>`Vegaアプリのフレームドロップとジャンクを修正してください`</li><li>`アプリのスクロールがスムーズでないのはなぜですか？`</li></ul>                                                                                                                                                |
+| **アプリ移植** *(ベータ)*       | アプリタイプの自動検出によるFireOSアプリのVegaへの移植、またはWeb URLをVega WebViewアプリとしてラップ。4つの入力パスをサポート：FOS WebView → Vega WebView、FOS React Native → VegaScript、FOS Native (Java/Kotlin) → VegaScript *(部分的サポート)*、Web URL → Vega WebView。 | <ul><li>`TVアプリをVegaに移植してください`</li><li>`/path/to/fos-appにあるFireOSアプリをVegaに移行してください`</li><li>`FOS React NativeアプリをVegaScriptに移植してください`</li><li>`FOS WebViewアプリをVega Webアプリに変換してください`</li><li>`https://example.com をVega WebViewアプリとしてラップしてください`</li></ul> |
+| **RNアップグレード** *(アルファ)*       | AI支援による移行でVegaScriptアプリのReact Nativeバージョンをアップグレード。包括的なアップグレードガイド、破壊的変更の分析、バージョンアップグレード（例：RN 0.72 → 0.83）のためのインタラクティブなTODOベースのワークフローを提供。 | <ul><li>`VegaアプリをReact Native 0.72から0.83にアップグレードしてください`</li><li>`RN 0.83にアップグレードする際の破壊的変更は何ですか？`</li><li>`React Nativeアップグレードプロセスをガイドしてください`</li></ul> |
+| **Appstore IAP統合**   | VegaアプリでAmazon Appstoreアプリ内課金（IAP）SDKを統合・テスト                      | <ul><li>`VegaアプリにIAPを統合してください`</li><li>`Vegaアプリのアプリ内課金をセットアップするにはどうすればよいですか？`</li><li>`VegaアプリでIAPをテストしてください`</li></ul>                                                                                                                                                                      |
 | **フィードバックの提供** | MCPの使用体験についてAmazonにフィードバックを提供 | <ul><li>`フィードバックを提供したい`</li><li>`Vega MCPのフィードバックを提供するにはどうすればよいですか？`</li></ul> |
 
 ## ワンクリックインストール
@@ -225,6 +230,9 @@ Amazon Devices Builder Tools MCPが提供するツールをリストしてくだ
 - analyze_perfetto_traces
 - read_document
 - list_documents
+- diagnose_crash
+- diagnose_key_input_latency
+- diagnose_ui_fluidity
 
 ## MCPツール
 
@@ -382,3 +390,35 @@ Amazon Devices Builder Tools MCPは、AIエージェントの`/prompts`でワン
 ```
 > @diagnose_crash /path/to/crash.acr
 ```
+
+### 7. `diagnose_key_input_latency`
+
+**説明:** JSスレッドパフォーマンス、CPUボトルネック、入力イベント処理の最適化を体系的に分析し、React Native Vegaアプリのキー入力レイテンシーの問題を診断・解決します。
+
+**パラメータ:**
+
+- `vega_app_package_path`（必須、文字列）: Vegaアプリパッケージのルートディレクトリへの絶対パス
+- `app_process_name`（任意、文字列）: 入力レイテンシーが発生しているアプリプロセスの名前。指定しない場合、manifest.tomlから自動的に解決されます。
+- `perfetto_trace_file_path`（任意、文字列）: 既存のPerfettoトレースファイルへの絶対パス（既にキャプチャ済みの場合）
+- `target_component_or_button`（任意、文字列）: 調査する特定のボタンまたはコンポーネント名
+- `latency_threshold_ms`（任意、数値）: 許容される最大入力レイテンシー（ミリ秒）。デフォルトは100。
+
+**使用例:**
+
+```
+> @diagnose_key_input_latency /path/to/my-vega-app
+```
+
+### 8. `diagnose_ui_fluidity`
+
+**説明:** コンポーネント再レンダリングとCPUパフォーマンスボトルネックの体系的な分析を通じて、React Native VegaアプリのUI流暢性KPI障害を診断します。
+
+**パラメータ:**
+
+- `vega_app_package_path`（必須、文字列）: Vegaアプリパッケージのルートディレクトリへの絶対パス
+
+**使用例:**
+
+```
+> @diagnose_ui_fluidity /path/to/my-vega-app
+```

package/README.md

@@ -22,6 +22,11 @@ The Amazon Devices Builder Tools MCP supports the following capabilities:
 | **Focus Management**           | Implement D-Pad navigation and focus management for TV interfaces                                | <ul><li>`Can you create an app with 2 buttons to show case focus management?`</li></ul>                                                                                                                                                                                                                                              |
 | **Give Feedback** | Provide feedback to Amazon about your experience with the MCP | <ul><li>`I want to provide feedback`</li><li>`How can I provide vega mcp feedback?`</li></ul> |
 | **Crash Analysis**              | Diagnose JavaScript, Native, LMK, and ANR crashes with automated ACR analysis                    | <ul><li>`Why did my app crash?`</li><li>`Help me analyze this ACR file /path/to/crash.acr`</li></ul>                                                                                                                                                                                                                                                |
+| **Key Input Latency**          | Diagnose and resolve key input latency issues through JS Thread performance and input event analysis | <ul><li>`Why is my app responding slowly to key presses?`</li><li>`Help me diagnose key input latency in my Vega app`</li><li>`My button clicks feel laggy, can you help?`</li></ul>                                                                                                                                                 |
+| **UI Fluidity**                | Diagnose UI fluidity KPI failures through component re-rendering and CPU performance analysis    | <ul><li>`My app's UI fluidity score is low, help me diagnose it`</li><li>`Help me fix frame drops and jank in my Vega app`</li><li>`Why is scrolling not smooth in my app?`</li></ul>                                                                                                                                                |
+| **App Porting** *(Beta)*       | Port FireOS apps to Vega or wrap a web URL as a Vega app, with auto-detection of app type. Supports four input paths: FOS WebView → Vega WebView, FOS React Native → VegaScript, FOS Native (Java/Kotlin) → VegaScript *(partial support)*, and Web URL → Vega WebView. | <ul><li>`Port my TV app to Vega`</li><li>`Help me migrate my FireOS app at /path/to/fos-app to Vega`</li><li>`Port my FOS React Native app to VegaScript`</li><li>`Convert my FOS WebView app to a Vega Web App`</li><li>`Wrap https://example.com as a Vega WebView app`</li></ul> |
+| **RN Upgrade** *(Alpha)*       | Upgrade React Native version in VegaScript apps with AI-assisted migration. Provides comprehensive upgrade guides, breaking change analysis, and interactive TODO-based workflow for version upgrades (e.g., RN 0.72 → 0.83). | <ul><li>`Help me upgrade my Vega app from React Native 0.72 to 0.83`</li><li>`What are the breaking changes when upgrading to RN 0.83?`</li><li>`Guide me through the React Native upgrade process`</li></ul> |
+| **Appstore IAP Integration**   | Integrate and test Amazon Appstore In-App Purchasing (IAP) SDK in Vega apps                      | <ul><li>`Help me integrate IAP in my Vega app`</li><li>`How do I set up In-App Purchasing for my Vega app?`</li><li>`Help me test IAP in my Vega app`</li></ul>                                                                                                                                                                      |
 | **SDK & CLI**                  | Install/update SDK and efficiently run CLI tools via spec-driven CLI                             | <ul><li>`Install/update SDK from AI agents`</li><li>`Build my app`</li><li>`Run my app on virtual device`</li><li>`Run my app on physical device`</li><li>`Run KPI Visualizer and get performance results`</li></ul>                                                                                                                 |
 
 ## One-Click Installation
@@ -230,10 +235,13 @@ You should see a response that includes the following tools:
 - get_app_hot_functions
 - read_document
 - list_documents
-- search_documents
+- search_documentation
 - execute_query
 - get_database_schema
 - read_asset
+- diagnose_crash
+- diagnose_key_input_latency
+- diagnose_ui_fluidity
 
 ## MCP Tools
 
@@ -317,7 +325,7 @@ or with time window filtering:
 Analyze hot functions in /path/to/trace.json from 5 to 15 seconds with a limit of 20 functions
 ```
 
-### 5. `search_documents`
+### 5. `search_documentation`
 
 Search Vega development documentation using full-text search. Returns document IDs and relevant snippets matching the query. Use `read_document` with the returned ID to get full content.
 
@@ -352,7 +360,7 @@ Get the database schema for Vega documentation
 
 ### 7. `execute_query`
 
-Execute a SQL query against the Vega documentation database. Use this tool for more complex queries when `search_documents` is insufficient. Use `get_database_schema` first to understand available tables and FTS5 syntax. The database is read-only.
+Execute a SQL query against the Vega documentation database. Use this tool for more complex queries when `search_documentation` is insufficient. Use `get_database_schema` first to understand available tables and FTS5 syntax. The database is read-only.
 
 **Parameters:**
 
@@ -484,3 +492,35 @@ Amazon Devices Builder Tools MCP provides the following pre-defined prompt templ
 ```
 > @diagnose_crash /path/to/crash.acr
 ```
+
+### 7. `diagnose_key_input_latency`
+
+**Description:** Diagnose and resolve key input latency issues in React Native Vega apps through systematic analysis of JS Thread performance, CPU bottlenecks, and input event handling optimization.
+
+**Parameters:**
+
+- `vega_app_package_path` (required, string): Absolute path to the Vega app package root directory
+- `app_process_name` (optional, string): Name of the app process experiencing input latency. If not provided, resolved automatically from manifest.toml.
+- `perfetto_trace_file_path` (optional, string): Absolute path to existing Perfetto trace file (if already captured)
+- `target_component_or_button` (optional, string): Specific button or component name to investigate
+- `latency_threshold_ms` (optional, number): Maximum acceptable input latency in milliseconds. Default is 100.
+
+**Example usage:**
+
+```
+> @diagnose_key_input_latency /path/to/my-vega-app
+```
+
+### 8. `diagnose_ui_fluidity`
+
+**Description:** Diagnose UI fluidity KPI failures in React Native Vega apps through systematic analysis of component re-rendering and CPU performance bottlenecks.
+
+**Parameters:**
+
+- `vega_app_package_path` (required, string): Absolute path to the Vega app package root directory
+
+**Example usage:**
+
+```
+> @diagnose_ui_fluidity /path/to/my-vega-app
+```