@a9n-shoji/rvw 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -5,6 +5,45 @@
 
 ## [Unreleased]
 
+## [0.3.2] - 2026-08-31
+
+### Added
+
+- Markdown、comment、WalkthroughのMermaid図をviewportサイズのreview workspaceへ展開し、Fit・zoom・
+  scroll、resizableなcomment rail、code referenceのpeekとreview画面へのnavigationを利用できる機能
+- WalkthroughのMermaid bindingをflowchartとclassDiagramに加え、sequenceDiagramのparticipant / actor、
+  stateDiagram-v2のstate、erDiagramのentity、architecture-betaのserviceへ拡張
+
+### Changed
+
+- Walkthroughのcode referenceを保存済みの最新PR headへ遅延解決し、fileが不変ならexact range、変更時は
+  sourceとdestinationで一意な未変更rangeだけを対応付け。安全に特定できない場合はimmutableなsource commitへ
+  fallbackし、rename / copyも一意な直接successorだけを追跡
+
+## [0.3.1] - 2026-08-28
+
+### Added
+
+- Pull Request一覧を表示しただけではGitHubへ問い合わせず、Open、Draft、状態未取得の登録済みPRだけを
+  明示的なbutton操作で一括status更新する機能
+
+### Changed
+
+- 同じdatabaseを使う通常の`rvw open`は既存runtimeへPRを追加し、同じHTTP originを再利用。並行起動でも
+  owner lockをRuntime / HTTP serverより先に確定し、一つのdatabaseにつき一つのactive processへ限定
+- 一括status更新のGitHub認証を操作ごとに一度だけ行い、最大4件並列・部分失敗許容で処理。Closed / Mergedを
+  継続追跡対象から除外し、保存済みPRの累積件数ではなく現在のworking setに問い合わせ量を限定
+- 一覧のPR titleを省略せず複数行で全文表示し、review画面のロゴをCmd / Ctrl / 中クリックで一覧を
+  別tabに開けるnative linkへ変更
+
+### Fixed
+
+- status更新によって現在のoffsetが無効になった場合、最後の有効な一覧pageへ戻して誤ったempty stateを防止
+- runtime停止時にHTTP / SQLiteを閉じるまでdatabase owner lockを保持し、新旧runtimeが一時的に重複するraceを防止
+- 終了猶予中の`rvw open`をpending viewer leaseで保護し、`--no-open`で再利用したruntimeをCtrl+Cまで維持
+- runtime停止中に到着した`rvw open`がowner解放後にownershipを再取得できずtimeoutするhandoff raceを防止
+- `viewer.open`のPR解決中はoperation reservationを維持し、解決後からbrowser接続待ちtimeoutを開始
+
 ## [0.3.0] - 2026-08-28
 
 ### Added

package/README.md

@@ -16,7 +16,7 @@ Agentが実装
     ↓
 Git commit / GitHub Pull Request
     ↓
-Agentが任意でcommit固定のWalkthroughを提示
+Agentが任意でsource anchor付きWalkthroughを提示
     ↓
 rvwで意図・説明・変更・repository全体を読む
     ↓
@@ -65,9 +65,19 @@ rvw open https://github.com/owner/repository/pull/123
 rvw open
 ```
 
-serverは`127.0.0.1`の空きportだけへbindします。通常の`rvw open`はviewerを開き、最初のtab接続を確認してから端末へ制御を返します。serverはbackgroundで動き、最後のtabを閉じると短い猶予後に停止します。リロード中や別tabが残っている間は停止しません。
+serverは`127.0.0.1`の空きportだけへbindします。同じdatabaseで既にrvwが動いていれば、通常の
+`rvw open`はそのruntimeへPRを追加し、同じoriginで新しいtabを開きます。二つ目のserverやdatabase接続は
+起動しません。最初の`rvw open`だけがbackground runtimeを開始し、最初のtab接続を確認してから端末へ
+制御を返します。最後のtabを閉じると短い猶予後に停止し、リロード中や別tabが残っている間は停止しません。
+異なる`RVW_DATABASE_PATH`を指定したruntimeは独立して起動できます。
 
-serverを端末に接続したままにする場合は`rvw open --foreground`を使います。ブラウザを開かずに検証する場合は`rvw open --no-open`を使います。どちらもCtrl+Cで停止します。一度登録したPRは、完全URLまたは全登録PRで一意な番号を指定すればrepository外のdirectoryからも開けます。
+serverを端末に接続したままにする場合は`rvw open --foreground`を使います。同じdatabaseのruntimeが
+既にあればforeground commandは競合を明示します。ブラウザだけを自動で開かない場合は
+`rvw open --no-open`を使います。active runtimeがあればURLを表示して再利用し、なければCtrl+Cまで
+signal管理のserverを起動します。再利用時もCLIがCtrl+Cまでviewer leaseを保持するため、表示したURLが
+終了猶予中に無効になることはありません。初回の`--port`は尊重し、active runtimeと異なるportを指定した場合は
+二つ目を起動せず競合を返します。一度登録したPRは、完全URLまたは全登録PRで一意な番号を指定すれば
+repository外のdirectoryからも開けます。
 
 ## 変更を理解する
 
@@ -108,7 +118,7 @@ viewerはこの流れのために次を提供します。
 
 ## Agentの説明を人間の順序で検証する
 
-外部Agentは`rvw-walkthrough` SkillとCLIを使い、実装説明を一つのcommitへ固定してrvwへ提示できます。
+外部Agentは`rvw-walkthrough` SkillとCLIを使い、実装説明を一つのsource commitをanchorとしてrvwへ提示できます。
 
 ```bash
 rvw walkthrough publish --stdin --json
@@ -118,7 +128,14 @@ rvw walkthrough publish --stdin --json
 構成されます。参照は意味のある複数行range、単行、またはfile全体を指せます。rvwは登録時にcommit、
 path、指定された行範囲を検証します。publishしてもbrowserは開かれず、
 active tabやscroll位置も変わりません。人間がviewerのWalkthroughを開き、必要なreferenceを選んだ
-時だけ、exact sourceがdocument tabへ開き、行指定があれば範囲全体が強調されます。通常clickは左ペイン、
+時だけ、`sourceOid`のanchorから最新PR headへcode位置を保守的に解決します。追跡できれば最新code、
+変更や曖昧さがあれば参照時点のcodeを明示して開きます。行指定はfile全体が同一、または選択範囲が
+source/latest双方で一意な場合だけ解決し、範囲全体を強調します。元pathが消えたrenameはcopy候補も含めて後継が1件のときだけ追従します。
+変更表示は選択中の比較がlatestで終わる場合だけtop barのPR比較範囲を使い、historical範囲では別revisionへ
+lineを誤適用せずlatest全文を表示します。fallbackでは、同じfileまたは明確なrename先があればline保証なしで
+最新fileも開けます。このactionも比較終端がlatestと一致するときだけ変更表示を使い、historical範囲ではlatest全文を
+開きます。解決後にPR headが進んだ場合、または同じWalkthrough IDのreference座標が変わった場合はstaleとし、
+解決時／現在のSHAと表示中のanchorを示します。staleな判断とlatest file actionを隠して明示的な再解決だけを提供します。通常clickは左ペイン、
 `Cmd` / `Ctrl`を押しながら選べば右ペインへ開きます。説明tabは残るため、
 複数のclaimと実装を任意の順序・任意のタイミングで往復できます。
 
@@ -187,7 +204,7 @@ rvw Skillを使って、https://github.com/owner/repository/pull/123 をreview
 
 Walkthroughを作る場合は、説明したい対象と必要な作成指示をセッションへ伝えて`rvw-walkthrough` Skillを使います。
 Skillは明示された指示を優先し、未指定の作成判断だけを既定guideで補って、reviewerが変更または実装対象の
-mental modelを作るための最初の読解経路を構成します。文書の見出しや説明順序は固定せず、commit固定の
+mental modelを作るための最初の読解経路を構成します。文書の見出しや説明順序は固定せず、source anchorを持つ
 reference付きartifactとして検証してpublishします。Walkthrough全体へのコメントから説明を改善する場合は、
 現在内容を取得して同じURIを更新し、重複した「改訂版」を追加しません。
 
@@ -326,8 +343,8 @@ pnpm test:package
 
 通常テストは実Git binaryとfake GitHub adapterを使い、GitHub認証やnetworkを必要としません。
 `test:package`はclean buildと実tarball作成を行い、一時directoryへinstallしてrepository checkout外から
-CLI、migration、frontend、bundled Skillをsmoke testします。CIはmacOS、Linux、Windowsでpackage smokeを
-実行しますが、通常CIからnpmへ公開しません。
+CLI、migration、frontend、bundled Skillをsmoke testします。Pull Request CIはLinuxでpackage smokeを
+実行し、`main`更新時とrelease CIはmacOS、Linux、Windowsで互換性を確認します。通常CIからnpmへ公開しません。
 
 ## データとセキュリティ
 
@@ -339,10 +356,12 @@ credentialはGitHub CLIが管理し、rvwのDBへコピーしません。
 既定DBのdirectory/fileは新規作成時だけ`0700` / `0600`へ設定し、既存pathはownerとmodeを検証して
 安全ならchmodしません。明示的に管理する別pathは`RVW_DATABASE_PATH`で指定でき、この場合rvwは既存pathを
 chmodしません。存在しないdirectory/fileは作成時のmodeだけで`0700` / `0600`にし、既存pathが推奨modeで
-なければ`doctor --json`にwarningを表示します。通常起動したviewerは`0700`の一時directory内へ
+なければ`doctor --json`にwarningを表示します。通常起動したviewer runtimeは`0700`の一時directory内へ
 `0600`のdatabase別Unix socketを提供し、Agent CLIは可能ならそのprocessへ
 書き込みを依頼するため、AgentへDB directoryの直接write権限を渡す必要がありません。同じsocketでは
-atomicなowner lockを取得した一つのNode processだけがlistenし、owner終了後にfollowerが引き継ぎます。
+RuntimeやHTTP serverより先にatomicなowner lockを取得し、一つのdatabaseを一つのNode processだけが
+扱います。競合した`rvw open`はownerへ依頼して終了し、dead ownerのstale lock/socketは次回起動時に
+exact inodeを確認して回収します。
 `rvw doctor --json`はmode/ownerだけでなくwrite transactionとAgent疎通も報告します。
 
 ローカルHTTP serverは`127.0.0.1`だけへbindしてHost / Originを検証し、write APIは