@a9n-shoji/rvw 0.9.0 → 0.11.0

package/CHANGELOG.md

@@ -5,6 +5,33 @@
 
 ## [Unreleased]
 
+## [0.11.0] - 2026-10-02
+
+### Added
+
+- PR一覧にアーカイブ・解除と、既定ONの「アーカイブ済みを非表示」を追加。Closed / Mergedの絞り込みと独立して利用できます。
+- 独自Skillから操作できる`rvw pr archive`、`rvw pr unarchive`、`rvw pr list`と対応APIを追加。Machine protocolは6を維持し、`pullRequest.archive`と`pullRequest.list`を追加。
+
+### Changed
+
+- アーカイブ状態はローカルDBへ保存し、同期・reset後も維持。アーカイブ済みでも直接閲覧・コメントを継続できます。同梱Skillによる自動アーカイブは行いません。
+- 最終ページが空になった場合の自動補正はブラウザ履歴を置き換え、「戻る」がループしないようにしました。
+
+## [0.10.0] - 2026-09-23
+
+### Added
+
+- レビュー中のcode参照から、TypeScript、TSX、JavaScript、Rubyの定義・参照候補をcommit固定で探索できるcode navigationを追加。
+
+### Removed
+
+- ブラウザ通知の設定・権限要求・テスト通知・Agent投稿の通知処理を撤去。コメントのpollingとwatch／Monitor連携は維持。
+- StructureのRegions表示・所属・配置・export・生成指示を撤去。通常Graph、Guide、thesis／start／backboneは維持。
+
+### Changed
+
+- Machine protocolを6へ更新。旧`presentation.regions`入力は拒否し、既存保存データはmigration 023でGraphを保ったまま移行。
+
 ## [0.9.0] - 2026-09-20
 
 ### Changed

package/README.md

@@ -1,135 +1,105 @@
 # rvw
 
-rvwは、GitHubのPull Requestを、差分と**その時点のコードベース全体**を行き来しながら読むためのツールです。
-PR内のコミットを選び、変更された行からファイル全文、変更されていない呼び出し元やテストまで、手元のブラウザで確認できます。
+GitHub Pull Request の差分だけでなく、**そのコミット時点のコードベース全体**を行き来しながらレビューするためのローカルビューアです。
 
-基本的な使い方は次の4つです。
+変更行からファイル全体のコード、未変更の呼び出し元、テストコードまでを手元のブラウザで確認できます。
 
-- **その時点のコードベースを読む。** 差分と全文を切り替え、変更されていないファイルも開いて検索できます。
-- **参照リンクで根拠を確かめる。** 説明・図・コメントに付いたリンクから、対象のファイルと行を開けます。
-- **左右に並べて読む。** 説明とコード、呼び出し元と呼び出し先を、タブに残して見比べられます。
-- **コードにコメントを残す。** 変更のない行にも質問を書けます。Agentのコメント監視を起動しておけば、質問への応答と調査結果を同じ場所で読めます。
+- **コードベース全体の探索**: 差分とファイル全文の切り替え、未変更ファイルの閲覧・全文検索に対応。
+- **根拠コードへのジャンプ**: Walkthrough（解説文）やStructure（関係図）内のリンクから該当コードを開く。
+- **2ペイン表示**: 説明とコード、呼び出し元と呼び出し先を左右に並べて比較。
+- **ローカルコメント & Agent調査**: 変更のない行にもコメント可能。Codex や Claude Code に行単位で質問し、その場で調査結果を確認できる。
 
-## 説明とコードを並べて読む
+---
 
-コードをどこから読めばよいか迷ったときは、Agentに参照リンク付きの説明を作ってもらえます。
-rvwでは、その説明をコードと同じ画面に開き、気になる箇所から根拠のファイルや行へ進めます。説明には2つの形式があります。
+## インストールと起動
 
-- **Walkthrough** は、一つの疑問や処理を順に読む説明です。「決済の承認後に注文を保存できなかったらどうなるか」などを文章や図で説明し、各所に根拠のコードへのリンクを付けます。流れを読みながら、条件や処理をコードで確認できます。
-- **Structure** は、ファイルや処理の関係を辿るための図です。どの処理がデータを読み書きするか、どのファイルに依存するかなどを、関連する要素や線からコードを開いて確認できます。
+### 動作要件
 
-作成は、別に起動したCodex / Claude CodeへSkillを使って依頼します。rvwがAgentを起動したり、説明の正しさを判定したりすることはありません。
-Agentなしでコードを読むこともできます。
+- Node.js 24.15.0 以上
+- Git
+- [GitHub CLI (`gh`)](https://cli.github.com/)（対象PRへのアクセス権限およびGit認証が完了していること）
+- PRのマージ先（base）リポジトリのローカルclone、またはそこから作成した Git worktree
+  - ※ fork元リポジトリ単体のcloneでは利用できません。
+- Claude Code でコメント監視を使う場合は、`Monitor` tool とサブAgentが利用可能な環境
 
-下は注文サービスPRのデモです。左のWalkthroughにある「決済の復旧処理」から右にコードを開き、
-注文の有無と決済状態による分岐を確認して質問します（カーソル付きGIF・7.5秒）。
+### セットアップ
 
-![左のWalkthroughの参照リンクをカーソルで選び、右に復旧コードを開いて読み、再試行について質問し、Agentの確認中の応答と返信を読む操作](https://raw.githubusercontent.com/a9n-shoji/rvw/166871b5fbd78f258611553ca7c8acc0101737e2/docs/images/review-flow.gif)
-
-左の説明を残したまま、右のコードで質問し、Agentの「🔎 確認中です…」が回答に変わるところまでを見せています。
-実操作を短く編集し、カーソルとクリック位置を表示しています。応答は撮影用に用意した例で、実際のAgentの処理時間を示すものではありません。
-
-## コードを確かめて質問を残す
-
-このデモでは「決済承認後に注文を保存できなかったら」を開き、次の順に読みます。
-
-1. 説明内の **決済の復旧処理** を `Cmd` / `Ctrl`＋クリックして、右ペインにコードを開きます。
-2. 注文がある場合は終了し、決済状態が `voidable` の場合に取り消すことを確認します。
-3. さらに読むと、`pending` や `unknown` の場合は `retry-later` を返しています。再試行の期限が分からなければ、その行に質問を残します。
-4. Agentの返信と、返信に付いた参照リンクからコードや運用手順を確認します。
-
-![再試行の期限を質問したコメントと、Codexの応答例。復旧処理と運用手順の参照リンク付きで回答している画面](https://raw.githubusercontent.com/a9n-shoji/rvw/166871b5fbd78f258611553ca7c8acc0101737e2/docs/images/review-comment.png)
-
-Agent連携では、先に外部Agentで **rvw-watch-comments** を起動しておきます。
-コメントを受け付けると **「🔎 確認中です…」** が付き、調査が終わると同じ投稿が回答に変わります。
-応答にはCodex / Claude CodeなどのAgent名が表示され、自分の質問と区別できます。上の返信はデモ用の例です。
-コメントと返信は手元のrvwに保存され、GitHubには投稿されません。
+```bash
+# GitHub CLI のセットアップ（未設定の場合）
+gh auth login
+gh auth setup-git
 
-## 図から処理の関係を辿る
+# インストール
+npm install --global @a9n-shoji/rvw
 
-Structureでは、処理やデータを表す要素と、それらの関係を図で読めます。
-要素のコード参照からその実装へ、関係に付いたコード参照から呼び出しや条件分岐などの根拠へ進めます。
+# baseリポジトリへ移動して起動
+cd /path/to/base-repository-clone
+rvw doctor
+rvw open https://github.com/owner/repository/pull/123
+```
 
-下は同じPRの「決済を取り消してよいか」という図です。**決済先の承認状態**の周辺に絞り、
-「取り消せる状態か確かめる」という関係の **`</>`** を `Cmd` / `Ctrl`＋クリックしています。
-右に開いた復旧処理で `voidable` の判定を確認し、続けて図の要素から決済先との通信を扱うコードを開きます。
+`http://127.0.0.1:43117` でブラウザが開きます。ブラウザのタブをすべて閉じると、サーバーも自動停止します。
 
-![左のStructureで決済状態と取り消し判断の関係を選び、右に判定コードを開く。続いて決済先の承認状態の要素からStripeGatewayの実装を読む操作](https://raw.githubusercontent.com/a9n-shoji/rvw/166871b5fbd78f258611553ca7c8acc0101737e2/docs/images/structure-flow.gif)
+---
 
-カーソル付きGIF・7.5秒。要素を選んで **1-hop / 2-hop** を使うと周辺の関係に絞れます。
-**全体** で図全体に戻り、**Fit** で表示中の要素を画面に収められます。
+## 基本的なレビューフロー
 
-## インストールしてPRを開く
+### 1. 差分とコードベースを行き来する
 
-必要なものは次のとおりです。
+1. 開いた画面でコミットを選択し、左側のファイル一覧からファイルを開きます。
+2. 上部の切り替えで **変更**（差分）または **全文**（選択コミット時点の内容）を表示します。
+3. **変更のないファイルも表示** を有効にすれば、未変更ファイルも一覧や全文検索（`Cmd/Ctrl + Shift + F`）から参照可能。`Cmd/Ctrl + クリック` で右ペインに並べて開けます。
+4. 任意の行番号の **＋** からコメントを追加できます（未変更行も可。ドラッグで複数行選択）。
 
-- Node.js **24.15.0以上**、Git、[GitHub CLI](https://cli.github.com/)。ブラウザはローカルで開きます。
-- GitHub CLIで対象PRを読める認証と、Gitで取得できる権限。
-- PRの**マージ先（base）リポジトリのclone**、またはそのcloneから作ったGit worktree。
-  forkからのPRも読めますが、fork側だけのcloneでは開けません。
-- 新規登録するPRは **github.com上のOpenまたはDraft**。初回取得と同期にはネット接続が必要です。
+### 2. Walkthrough（解説）とコードの突き合わせ
 
-```bash
-# 未設定の場合に実行
-gh auth login
-gh auth setup-git
+PR全体の流れを把握するために、Agentが生成した解説（Walkthrough）を左ペインに開き、リンクから右ペインに該当コードを呼び出せます。
 
-# 同名の別パッケージと区別するため、scopeを含める
-npm install --global @a9n-shoji/rvw
+![Walkthroughからコードを開き、コメントで質問する操作フロー](https://raw.githubusercontent.com/a9n-shoji/rvw/166871b5fbd78f258611553ca7c8acc0101737e2/docs/images/review-flow.gif)
 
-cd /path/to/base-repository-clone
-rvw doctor
-rvw open https://github.com/owner/repository/pull/123
-```
+- 解説文中のリンク（`Cmd/Ctrl + クリック`）から、実装行へ直接ジャンプします。
+- 疑問点があればその場でコード行にコメントを残せます。
 
-`/path/to/base-repository-clone` とPRのURLは、自分の対象に置き換えてください。
-`rvw doctor` はGit・GitHub認証・リポジトリ・保存先への書き込みなどを診断します。
-現在のブランチに対応するPRを初めて開くときは `rvw open` だけでも指定できます。
-登録済みPRを確実に選ぶにはURLを指定してください。
+### 3. Structure（関係図）からの依存関係の把握
 
-通常は `http://127.0.0.1:43117` でブラウザが開き、端末に制御が戻ります。
-最後のrvwタブを閉じると、少し待ってサーバーも終了します。
+ファイルや処理の依存関係を図として可視化し、図中の要素やコネクタから該当コードを特定できます。
 
-## 最初のレビューを進める
+![Structureからコード参照を開く操作フロー](https://raw.githubusercontent.com/a9n-shoji/rvw/166871b5fbd78f258611553ca7c8acc0101737e2/docs/images/structure-flow.gif)
 
-### 差分からコードベース全体を読む
+- 図中の **`</>`** アイコンを `Cmd/Ctrl + クリック` すると、呼び出し元や条件分岐の実装を右ペインに開きます。
+- **1-hop / 2-hop** で着目したノードの周辺関係に絞り込み、**Fit** で全体表示に戻せます。
 
-1. 開いた `Pull Request.md` で変更の目的を確認します。
-2. 上部の **対象commit** で、PR全体または確認したいコミットを選びます。
-3. 左のファイル一覧から一つ選び、**変更** で差分、**全文** でその時点のコードを読みます。
-4. **変更のないファイルも表示** をオンにし、呼び出し元やテストも開きます。`Cmd` / `Ctrl`＋クリックすると右ペインに並べられます。
-5. 疑問のあるコード行にマウスを置き、行番号横の **＋** からコメントします。変更のない行にもコメントでき、複数行は＋からドラッグして選べます。
+---
 
-ファイル一覧や検索では、選択範囲の最後のコミット時点のリポジトリ全体を辿れます。表示するのはGitにコミットされたコードで、作業中の未コミット変更ではありません。
-ここまでにAgentやSkillは必要ありません。
+## Agent連携（Codex / Claude Code）
 
-### Agentの説明から読み始める
+ローカルの Agent に Skill を登録することで、PRの構成図生成や、行コメントに対する調査・返信を自動化できます。
 
-同じマシンで動き、対象リポジトリとrvw CLIを使えるCodexまたはClaude Codeを用意します。
-使う方のSkillをインストールしてください。
+### 1. Skill のセットアップ
 
 ```bash
-# Codexを使う場合
+# Codex の場合
 rvw skill install codex
 
-# Claude Codeを使う場合
+# Claude Code の場合
 rvw skill install claude
 rvw skill status
 ```
 
-Agent側でSkillが読み込まれていることを確認し、`rvw-review-compose`を選んでPRのURLだけを渡します。
-`rvw-review-compose`はPRと周辺コードを調べ、どこを説明し、どこをコードで直接読むかを考えて、
-必要なWalkthroughやStructureを作成します。
+### 2. Walkthrough / Structure の作成依頼
+
+PRのURLとともに `rvw-review-compose` を実行させます。
 
 ```text
+rvw-review-compose Skillを使って、次のPull Requestをレビューするための構成を検討し、
+必要なStructureやWalkthroughをrvwに作成してください。
+
 https://github.com/owner/repository/pull/123
 ```
 
-作成後は、Agentが案内した説明を左の **ウォークスルー** または **Structure** から開きます。
-気になる説明のリンクや図のコード参照を `Cmd` / `Ctrl`＋クリックし、横のコードで条件や呼び出し先を確かめてください。
-小さな変更では、ファイルの関係図とコードを直接読む構成になることもあります。WalkthroughとStructureが常に一組で作られるわけではありません。
+### 3. コメントの監視と調査返信
 
-コメントする前に、外部Agentの別タスクで監視を起動します。
+Agent にコメント監視を開始させた状態でコード行にコメントを残すと、Agent が調査結果を該当行のスレッドに直接返信します。
 
 ```text
 rvw-watch-comments Skillを使って、rvwの新しいコメントと返信を監視してください。
@@ -137,58 +107,64 @@ rvw-watch-comments Skillを使って、rvwの新しいコメントと返信を
 監視を開始できたら知らせてください。
 ```
 
-監視開始の知らせを待ってから、疑問のあるコード行にコメントします。
-「🔎 確認中です…」が付けばAgentが受け付けています。調査後はその投稿が回答に置き換わるので、
-返信とリンク先のコードを確認し、疑問が解消したら **解決** を押します。続けて質問する場合は同じコメントに返信できます。
-
-監視には子Agentを使えるローカル環境が必要です。**全登録PRの新しいコメント・返信**が対象で、
-新規に監視を始める前からあるコメントは拾いません。rvwを起動するだけでは監視は始まりません。
-Claude Codeでは`Monitor` toolで監視driverを起動し、出力イベントを受け取ります。Bashのbackground実行や
-出力pollingは使わず、Monitorの期限到達時は同じtask stateで再開します。
-監視を使わず一件ずつ渡す方法や、修正を依頼する方法は、
-[利用ガイド](https://github.com/a9n-shoji/rvw/blob/2f8ce1af320682b8904f2dbaae399d8b14c4385d/docs/usage.md)にあります。
-
-## 使う前に知っておくこと
-
-- **コメントはGitHubへ投稿されません。** コメント、返信、Walkthrough、Structureはローカルに保存します。
-  GitHubからはPR情報とコミットを取得します。共有レビューやApprove・MergeはGitHubで行います。
-- **説明はコードと照合してください。** rvwが検証するのは、参照先のコミット・ファイル・行が存在することです。説明の内容が正しいかどうかは判定しません。
-  古い説明やコメントを最新コードへ確実に対応付けられない場合は、参照時点や `Outdated` を表示します。
-- **初回登録・同期にはGitHubへの接続が必要です。** PR本文にある対応形式のGitHub添付画像も取得します。
-  登録済みPRは保存済みデータとGitオブジェクトで再表示できます。Agentへ渡す情報は、そのAgentの権限・送信先・設定に従います。
-- **GitHub Enterprise、Closed／Merged PRの新規登録は未対応です。** 登録後にClosed／MergedになったPRは引き続き表示・同期できます。
-- **ローカル環境が必要です。** 対象リポジトリやrvwのローカル接続を使えないクラウドAgentは連携対象外です。
-  rvw自身はコード編集、テスト実行、commit、pushを行いません。
-- PRタイトルと本文は、常に**最後に成功したGitHub同期時点の内容**です。過去のコミットを選んでも過去のPR本文には戻りません。
-
-保存場所、ファイル表示の制限、同期に失敗したときの確認は[利用ガイド](https://github.com/a9n-shoji/rvw/blob/2f8ce1af320682b8904f2dbaae399d8b14c4385d/docs/usage.md)にまとめています。
-
-## デモと関連文書
-
-ソースから `pnpm demo` を起動すると、上の画面と同じ注文サービスPRを試せます。
-GitHub認証やAgentは不要です。[デモの起動と操作手順](https://github.com/a9n-shoji/rvw/blob/2f8ce1af320682b8904f2dbaae399d8b14c4385d/docs/usage.md#デモで同じ疑問を追う)を参照してください。
-
-- [利用ガイド](https://github.com/a9n-shoji/rvw/blob/2f8ce1af320682b8904f2dbaae399d8b14c4385d/docs/usage.md)：PRを読む、説明を頼む、コメントへの応答を読む、修正後を確認する。
-- [CLI protocol](https://github.com/a9n-shoji/rvw/blob/166871b5fbd78f258611553ca7c8acc0101737e2/docs/cli-protocol.md)：Agentや自動化向けのコマンドとJSON仕様。
-- [実装仕様](https://github.com/a9n-shoji/rvw/blob/166871b5fbd78f258611553ca7c8acc0101737e2/docs/implementation-spec.md) / [設計](https://github.com/a9n-shoji/rvw/blob/166871b5fbd78f258611553ca7c8acc0101737e2/docs/architecture.md)：参照解決、保存、描画などの保証。
-- [開発・問い合わせ](https://github.com/a9n-shoji/rvw/blob/166871b5fbd78f258611553ca7c8acc0101737e2/CONTRIBUTING.md) / [互換性](https://github.com/a9n-shoji/rvw/blob/166871b5fbd78f258611553ca7c8acc0101737e2/docs/compatibility.md) / [セキュリティ](https://github.com/a9n-shoji/rvw/blob/166871b5fbd78f258611553ca7c8acc0101737e2/SECURITY.md)。
-
-ライセンスは[MIT](https://github.com/a9n-shoji/rvw/blob/166871b5fbd78f258611553ca7c8acc0101737e2/LICENSE)です。
-
-## ショートカット
-
-`Cmd`はmacOS、`Ctrl`はWindows / Linuxで使います。
-
-| 操作                                     | ショートカット                 | 使う場所・条件                                                                |
-| ---------------------------------------- | ------------------------------ | ----------------------------------------------------------------------------- |
-| ファイルや説明を名前で探して開く         | `Cmd` / `Ctrl` + `P`           | 検索結果は `↑` / `↓` で選び、`Enter` で左ペインに開く                         |
-| コードベース全体から文字列を探す         | `Cmd` / `Ctrl` + `Shift` + `F` | 選択コミットのリポジトリを全文検索                                            |
-| 開いているペイン内を検索する             | `Cmd` / `Ctrl` + `F`           | 文書ペインをクリックしてから。コメントなどの入力欄にいる場合は対象外          |
-| ペイン内検索の次／前の一致へ進む         | `Enter` / `Shift` + `Enter`    | ペイン内検索の入力欄。検索を開いている間は `F3` / `Shift` + `F3` も使える     |
-| ファイルや参照先を横に開く               | `Cmd` / `Ctrl` + クリック      | ファイル一覧・検索結果・説明やコメントの参照リンク・Structureのコード参照     |
-| コメント・返信を送信する／編集を保存する | `Cmd` / `Ctrl` + `Enter`       | 各入力欄。日本語変換中は送信しない                                            |
-| 新規の行・ファイルコメント入力を取り消す | `Esc`                          | 新規コメントの入力欄。未投稿の内容を破棄する                                  |
-| 前／次の文書タブへ移る                   | `←` / `→`                      | 文書タブにフォーカスがあるとき。`Home` / `End` で先頭／末尾へ                 |
-| コミットを範囲で選ぶ                     | `Shift` + クリック             | **対象commit** の一覧で、選択範囲の最後のコミットからクリックしたコミットまで |
-| Structureの要素と周辺の関係へ移る        | 要素をダブルクリック           | 図のコード参照ボタン以外の部分                                                |
-| Structureを拡大・縮小する                | `Cmd` / `Ctrl` + ホイール      | 図の上。ホイールだけなら図を移動                                              |
+![コメントに対するAgentの返信例](https://raw.githubusercontent.com/a9n-shoji/rvw/166871b5fbd78f258611553ca7c8acc0101737e2/docs/images/review-comment.png)
+
+- コメント送信後、調査中は「🔎 確認中です…」と表示され、完了すると回答に置き換わります。
+- 疑問が解消したら **解決** を押してクローズします。
+
+---
+
+## 仕様・注意点
+
+- **完全ローカル管理**: コメント、返信、生成された Walkthrough / Structure はローカルに保存されます。**GitHub上のPRには一切投稿・送信されません**。Approve や Merge 等は通常通り GitHub 上で行ってください。
+- **参照の検証**: rvw は指定コミット・ファイル・行が存在することのみを検証します。Agentが生成した解説自体の妥当性は保証しません。
+- **接続要件**: 初回取得・同期時のみ GitHub への接続が必要です。取得済みのPRはオフラインでも表示可能です。
+- **未対応環境**: GitHub Enterprise、および新規登録時点ですでに Closed / Merged になっているPRには非対応です（登録済みPRのクローズ追従は可能）。
+- **変更操作の非保持**: rvw 単独でコード編集、テスト実行、Git コミット等を行う機能はありません。
+
+---
+
+## ショートカット一覧
+
+※ `Cmd`（macOS） / `Ctrl`（Windows, Linux）
+
+| 操作                             | ショートカット            | 補足                                           |
+| :------------------------------- | :------------------------ | :--------------------------------------------- |
+| ファイル・解説をクイックオープン | `Cmd/Ctrl + P`            | `↑`/`↓` で選択、`Enter` で開く                 |
+| コードベース全体の全文検索       | `Cmd/Ctrl + Shift + F`    | 選択コミットのリポジトリ全体が対象             |
+| ペイン内検索                     | `Cmd/Ctrl + F`            | 文書ペインを選択中に有効                       |
+| 次／前の検索一致箇所             | `Enter` / `Shift + Enter` | 検索窓フォーカス時（`F3` / `Shift + F3` も可） |
+| ファイル・参照先を右ペインに開く | `Cmd/Ctrl + クリック`     | 一覧、リンク、Structure上の参照に対応          |
+| コメント・返信の投稿 / 保存      | `Cmd/Ctrl + Enter`        | 各入力欄                                       |
+| コメント入力のキャンセル         | `Esc`                     | 未投稿内容を破棄                               |
+| 前／次のタブへ移動               | `←` / `→`                 | タブヘッダーにフォーカス時                     |
+| コミットの範囲選択               | `Shift + クリック`        | コミット一覧で範囲指定                         |
+| Structure: ノードの詳細展開      | ノードをダブルクリック    | コード参照ボタン以外の部分                     |
+| Structure: 拡大・縮小            | `Cmd/Ctrl + ホイール`     | ホイール単体はキャンバス移動                   |
+
+### コードの定義候補を辿る
+
+Ruby・JS/TS・React（JSX/TSX）の全文・diff上の名前を **Cmd/Ctrl + click** すると、同じcommit内の定義候補を表示します。
+候補をclickすると対象行を開き、Cmd/Ctrl + clickなら右ペインに開きます。ブラウザのBackで元へ戻れます。
+候補は宣言行をプレビューでき、↑↓/Enterで選択、Escapeで閉じられます。
+開発checkoutでは `pnpm demo:navigation` で実Git履歴を使うRuby/Reactデモを起動できます。
+対応言語の解析機能を同梱するので、RubyやLSPの追加セットアップは不要です。構文に基づく候補であり、呼び先は確定しません。
+ローカル変数の代入・引数を候補にし、JS/TSの相対named import（`import { Button as Action } from "./Button"`のような別名も含む）先を優先します。型位置と`import type`の相対named aliasにも対応しますが、型・値のsemanticな解決は行いません。
+default / namespace / package import、re-export、tsconfig paths、完全なmodule resolution、型に基づくreceiver解決、Railsの動的生成method、外部gem、Find usagesは未対応です。[対象と制限](https://github.com/a9n-shoji/rvw/blob/main/docs/code-navigation.md)を参照してください。
+
+---
+
+## 見終わったPRを整理する
+
+PR一覧の各行からアーカイブ・解除できます。アーカイブ済みは既定で非表示になり、チェックを外すと再表示できます。
+PRの閲覧やコメントは引き続き利用できます。[操作と独自Skillでの自動化](https://github.com/a9n-shoji/rvw/blob/main/docs/usage.md#pr一覧のアーカイブ)を参照してください。
+
+## ドキュメント
+
+ソースから `pnpm demo` を実行すると、デモ環境（認証・Agent不要）をローカルで試せます。
+
+- [利用ガイド](https://github.com/a9n-shoji/rvw/blob/main/docs/usage.md)
+- [CLI Protocol 仕様](https://github.com/a9n-shoji/rvw/blob/166871b5fbd78f258611553ca7c8acc0101737e2/docs/cli-protocol.md)
+- [アーキテクチャ設計・実装仕様](https://github.com/a9n-shoji/rvw/blob/166871b5fbd78f258611553ca7c8acc0101737e2/docs/architecture.md)
+- [コントリビューション](https://github.com/a9n-shoji/rvw/blob/166871b5fbd78f258611553ca7c8acc0101737e2/CONTRIBUTING.md) / [セキュリティ](https://github.com/a9n-shoji/rvw/blob/166871b5fbd78f258611553ca7c8acc0101737e2/SECURITY.md)
+- [ライセンス (MIT)](https://github.com/a9n-shoji/rvw/blob/166871b5fbd78f258611553ca7c8acc0101737e2/LICENSE)

package/dist/cli-THIRD_PARTY_NOTICES.txt

@@ -1529,6 +1529,90 @@ CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
+================================================================================
+tree-sitter-javascript@0.25.0
+Declared license: MIT
+Source: https://github.com/tree-sitter/tree-sitter-javascript
+
+--- LICENSE ---
+The MIT License (MIT)
+
+Copyright (c) 2014 Max Brunsfeld
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+================================================================================
+tree-sitter-ruby@0.23.1
+Declared license: MIT
+Source: https://github.com/tree-sitter/tree-sitter-ruby
+
+--- LICENSE ---
+The MIT License (MIT)
+
+Copyright (c) 2016 Rob Rix
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+================================================================================
+tree-sitter-typescript@0.23.2
+Declared license: MIT
+Source: https://github.com/tree-sitter/tree-sitter-typescript
+
+--- LICENSE ---
+The MIT License (MIT)
+
+Copyright (c) 2017 Max Brunsfeld
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
 ================================================================================
 unist-util-position@5.0.0
 Declared license: MIT
@@ -1702,6 +1786,34 @@ CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
+================================================================================
+web-tree-sitter@0.27.0
+Declared license: MIT
+Source: git+https://github.com/tree-sitter/tree-sitter.git
+
+--- LICENSE ---
+The MIT License (MIT)
+
+Copyright (c) 2018 Max Brunsfeld
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
 ================================================================================
 wsl-utils@0.3.1
 Declared license: MIT