@a9n-shoji/rvw 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -5,6 +5,38 @@
 
 ## [Unreleased]
 
+## [0.2.2] - 2026-08-21
+
+### Changed
+
+- `rvw`と`rvw-watch-comments` Skillが具体的なcode上の結論、実装、testを投稿するとき、navigation価値のあるtyped code referenceを既定で付けるよう改善
+
+### Fixed
+
+- `rvw-watch-comments`が同じthreadの後続replyを処理するとき、以前の回答を確認中へ戻さず、新しい確認中replyを最終回答へ更新するよう修正
+- Markdown Previewで別commentへの返信が同期されても、入力中の未送信replyとfocusを保持するよう修正
+
+## [0.2.1] - 2026-08-20
+
+### Added
+
+- Agentが作成・返信・編集・同期するcomment postへ、exact commitに固定したinline code referenceを付与できるprotocol v3
+- `rvw-watch-comments`向けの一括preflight、cursor-resume watch driver、pending待機、即時auto-ack
+
+### Changed
+
+- Walkthroughとcomment postがcode referenceのschema、検証、表示、navigationを共有
+- 小規模batchの直接調査と、絶対pathのJSON fileによるworker結果回収をSkill契約へ明記
+- comment / replyの64 KiB超過errorへ実際のUTF-8 byte上限を明記
+- review sidebarをExplorerとCommentsの二階層へ整理し、PR本文、Walkthrough、repository fileを一つの
+  file treeとして扱うよう変更
+- Explorerと全文検索の切り替え時に、各viewの展開状態、検索語、scroll位置を保持
+
+### Fixed
+
+- Markdown previewの再描画後もtableの横scroll位置を保持
+- Markdownのinline codeとcode blockでfont sizeが不揃いになる表示を修正
+
 ## [0.2.0] - 2026-08-20
 
 ### Added

package/README.md

@@ -92,7 +92,8 @@ viewerはこの流れのために次を提供します。
 - `@pierre/vscode-icons`による全画面共通の言語／tooling file icon
 - ファイル名fuzzy検索、Gitによるrealtime全文fixed-string検索（case / whole-word、file grouping、行jump）
 - PR全体、PR本文、ファイル全体、行範囲、Walkthrough全体へのコメント
-- コメントと返信のsafe GFM表示（repository内link／同一commit相対画像、表示専用Mermaidを含む）
+- コメントと返信のsafe GFM表示（repository内link／同一commit相対画像、表示専用Mermaid、
+  exact commitへ固定したinline code referenceを含む）
 - 未解決／解決済み、返信、Outdated追跡
 - Agentへ渡す一件・一覧・複数選択した`rvw://comment/<uuid>`参照のコピー
 - Agentが提示したWalkthrough、exact code reference、選択可能なMermaid node
@@ -176,7 +177,9 @@ rvw Skillを使って、https://github.com/owner/repository/pull/123 の未解
 ```
 
 Agentにreview結果をRVWへ残してもらう場合は、対象PRとコメント作成を明示します。Agentはcommit済みの
-exact sourceを確認し、通常の未解決threadを一件ずつ作成します。
+exact sourceを確認し、通常の未解決threadを一件ずつ作成します。指摘や回答の理解に別の実装箇所が
+必要なら、投稿本文の`rvw-ref:<id>` linkと同じ投稿に保存したtyped referenceから、その時点のcommitを
+globalなcommit選択を変えずに開けます。
 
 ```text
 rvw Skillを使って、https://github.com/owner/repository/pull/123 をreviewし、見つけた指摘をRVWのコメントとして作成してください。
@@ -189,12 +192,16 @@ reference付きartifactとして検証してpublishします。Walkthrough全体
 現在内容を取得して同じURIを更新し、重複した「改訂版」を追加しません。
 
 新規root commentとreplyを継続監視する場合は`rvw-watch-comments` Skillを起動します。全登録PRを
-約10秒間隔で監視し、起動前の既存未解決commentは処理しません。自分のPRのfix-and-pushを起動taskへ
+同梱driverから約1秒間隔で監視し、起動前の既存未解決commentは処理しません。自分のPRのfix-and-pushを起動taskへ
 明示許可した場合だけ、live PR authorと起動時のGitHub loginが一致するPRで修正・test・commit・pushを
 行えます。fork PRではlive head repository、branch、OIDとpush先も一致させます。他人またはauthor不明の
-PRは常にcode/GitHub read-onlyで調査します。batchをclaimすると各threadへ`🔎 確認中です…`を即時返信し、
+PRは常にcode/GitHub read-onlyで調査します。同梱driverがcursor resumeとRFC 7464 ingestを行い、
+batchをclaimすると各threadへ`🔎 確認中です…`をAgent往復なしに即時返信し、
 完了時は同じreplyを最終結果へ編集します。Skill同梱のtask-state toolがrepository外のSQLiteへcursor、
-queue、retry、thread単位のstatus post、自己返信抑制をtransactionalに保存します。
+queue、retry、batch内のthread単位status post、自己返信抑制をtransactionalに保存します。同じthreadへ
+後から返信が追加された場合は新しいstatus postを返信するため、以前の回答は書き換えません。
+調査結果、実装内容、test結果が具体的なcodeに基づく場合、Skillは最終replyからexact commitの有用な
+line rangeへ`rvw-ref:` linkを付け、reviewerが根拠へ直接移動できるようにします。
 
 三つのSkillはSQLiteを直接読まず、`rvw protocol --json`、`rvw comment ... --json`、
 `rvw walkthrough get/update/publish/delete ... --json`、`rvw pr sync --stdin --json`だけを利用します。
@@ -212,7 +219,7 @@ rvw pr reset https://github.com/owner/repository/pull/123 --json
 rvw pr reset https://github.com/owner/repository/pull/123 --yes --json
 ```
 
-resetは対象PRのコメント、返信、コメント対象、Walkthrough、code reference、
+resetは対象PRのコメント、返信、コメント対象、コメント投稿とWalkthroughのcode reference、
 `refs/rvw/pr/<number>/...`を削除し、現在のGitHub状態からcacheとhead refを再構築します。
 バックアップや旧コメント移行は行わず、元に戻せません。
 
@@ -249,9 +256,11 @@ rvw pr attach <PR_REF> --repository <PATH> --json
 stdinをcloseし、shellではpipe、quoted heredoc、input redirectionのいずれかを使います。起動済みの
 対話commandへJSONと改行だけを送るとEOF待ちになります。
 
-`comment create`は登録済みPR、通常のcomment target、本文、任意のAgent名をstdin JSONで受け取り、
+`comment create`は登録済みPR、通常のcomment target、本文、任意のAgent名、投稿単位code referenceをstdin JSONで受け取り、
 未解決のroot threadを一件作成します。repository targetはexact commit、path、任意のinclusive line rangeを
 指定し、viewerと同じ文書・行検証を通ります。作成してもbrowserを開かず、tabやcommit選択を変更しません。
+同梱Skillは具体的なcode上のclaimにnavigation価値のある根拠がある場合、Walkthroughと同じくtyped
+referenceを既定で使います。
 
 `comment list`は未解決を既定として`unresolved` / `resolved` / `all`をページング列挙し、各threadの
 root post preview、post件数、最新head時点のOutdated判定を返します。`hasMore`なら`nextOffset`から
@@ -291,6 +300,18 @@ maintainer向けのversion、tag、npm staged publishing、障害対応手順は
 
 ## 開発
 
+source checkoutでは、GitHub接続や保存済みPRを用意せずにrepository規模のviewerを確認できます。
+
+```bash
+pnpm demo
+```
+
+このデモは小さなE2E fixtureとは分離され、現在のcheckoutにある直近6件のfirst-parent commitを
+一つのsynthetic PRとして表示します。tree、文書、diff、検索はworktreeではなく実際のGit objectから読み、
+100件以上の実在file、複数commit、変更外のtest・document・Skill、初期commentとWalkthroughを含みます。
+browserを自動で開かない場合は`pnpm demo -- --no-open`、portを変える場合は`RVW_DEMO_PORT`を指定します。
+デモを停止するには起動したterminalでCtrl+Cを押してください。
+
 ```bash
 pnpm install --frozen-lockfile
 pnpm check