@a9n-shoji/rvw 0.3.1 → 0.4.0-beta.0

package/CHANGELOG.md

@@ -5,6 +5,30 @@
 
 ## [Unreleased]
 
+## [0.4.0-beta.0] - 2026-08-31
+
+### Added
+
+- 一つの具体的なbehavior / processing flowをsource-anchored origin、stable Node / Edge ID、exact source
+  anchorで提示し、1/2-hop / All、focus、pan / zoom / dragから探索できるproduction `Structure` document
+- Structureのpublish / get / whole-value update / confirmation付きdeleteを行うCLI、Agent socket capability、
+  SQLite migration、HTTP API、Codex / Claude Code共通の`rvw-structure` Skill
+
+## [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

package/README.md

@@ -6,6 +6,8 @@ repository全体を行き来し、PR本文、変更されたコード、変更
 Agentが実装やarchitectureの説明を提示した場合は、説明を独立したtabに残したまま、inline linkや
 Mermaid図から人間が選んだcodeだけを開けます。文書は最大2ペインへ並べられるため、
 説明と実装、callerとdefinition、Markdown previewとcodeを同時に読めます。
+順序より関係が重要なsubjectは、Agentがsource anchor付きStructureとして提示でき、同じworkspaceで
+nodeとrelationを自由に辿れます。
 
 diffは変更を見つける入口であり、レビュー対象の境界ではありません。人間が結果を読み、影響を追い、
 次に直すべきことを判断します。Codex / Claude Codeは、その判断を同梱された共通Skillと`rvw` CLI
@@ -16,7 +18,7 @@ Agentが実装
     ↓
 Git commit / GitHub Pull Request
     ↓
-Agentが任意でcommit固定のWalkthroughを提示
+Agentが任意でsource anchor付きWalkthrough / Structureを提示
     ↓
 rvwで意図・説明・変更・repository全体を読む
     ↓
@@ -107,6 +109,7 @@ viewerはこの流れのために次を提供します。
 - 未解決／解決済み、返信、Outdated追跡
 - Agentへ渡す一件・一覧・複数選択した`rvw://comment/<uuid>`参照のコピー
 - Agentが提示したWalkthrough、exact code reference、選択可能なMermaid node
+- Agentが提示したStructure、focus近傍、source anchor付きnode / relation
 - Walkthrough commentをAgentが読むときの、元の説明本文とcode referenceの同時取得
 - 同じ参照を保ったWalkthroughの改善と、確認付きの不要Walkthrough削除
 
@@ -118,7 +121,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
@@ -128,7 +131,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と実装を任意の順序・任意のタイミングで往復できます。
 
@@ -147,10 +157,35 @@ Agentは現在内容を読み、同じ`rvw://walkthrough/<uuid>`を更新して
 同じ説明へ残り、viewerはpollで本文、参照、titleを再取得します。不要なWalkthroughはviewerの削除action、
 または削除件数を確認したCLIで、紐づくコメントと返信を含めて削除できます。
 
+## codeの関係を空間として検証する
+
+外部Agentは`rvw-structure` SkillとCLIを使い、PRに関係するboundedなbehaviorをfactualなcode entrypointから
+dependency、contract、side effectへ辿る空間として提示できます。必須の読み順を持つ説明はWalkthroughです。
+entrypointを置けない静的なarchitecture／責務inventoryはStructureへ広げません。
+
+```bash
+rvw structure publish --stdin --json
+rvw structure get rvw://structure/<uuid> --json
+rvw structure update rvw://structure/<uuid> --stdin --json
+rvw structure delete rvw://structure/<uuid> --json
+```
+
+Structureは一つのexact `sourceOid`、宣言されたtitle / scope、entrypoint、stableなNode / Edge IDからなります。
+Nodeは0または1件、Edgeは0件以上のsource anchorを持ち、rvwはcommit、UTF-8 path、line pair、endpoint、
+focus、重複ID、sizeを保存前に検証します。publish / updateはbrowserやnavigationを操作しません。
+
+viewerではfocusがある時に1-hop / 2-hopへ絞り、Allでは全Node / Edgeを表示します。relationを次数やIDで
+暗黙に隠さず、pan、zoom、fit、node drag、layout resetで探索できます。通常clickでexact sourceを左、
+`Cmd` / `Ctrl`+clickで右ペインへ開きます。globalなcommit選択は
+変えません。node位置とviewportは同じbrowser sessionで保持しますが、SQLiteやAgent protocolへ座標を
+保存しません。同じsubjectの更新は同じURIを完全置換し、存続するIDの位置を保ちます。別subjectは新しい
+Structureとしてpublishします。
+
 ## Codex / Claude Code Skills
 
 アプリ本体からローカルSkillをインストールします。一度のinstallで、コメント処理用の`rvw`、
-Walkthroughのpublish・改善・削除用の`rvw-walkthrough`、新規コメント監視用の
+Walkthroughのpublish・改善・削除用の`rvw-walkthrough`、Structureのpublish・置換・削除用の
+`rvw-structure`、新規コメント監視用の
 `rvw-watch-comments`が入ります。Skill名と内容はCodex / Claude Codeで共通で、
 platform指定は配置先だけを選びます。
 
@@ -162,8 +197,8 @@ rvw skill status
 
 既定の配置先は次です。
 
-- Codex: `~/.agents/skills/rvw`、`~/.agents/skills/rvw-walkthrough`、`~/.agents/skills/rvw-watch-comments`
-- Claude Code: `~/.claude/skills/rvw`、`~/.claude/skills/rvw-walkthrough`、`~/.claude/skills/rvw-watch-comments`
+- Codex: `~/.agents/skills/rvw`、`~/.agents/skills/rvw-walkthrough`、`~/.agents/skills/rvw-structure`、`~/.agents/skills/rvw-watch-comments`
+- Claude Code: `~/.claude/skills/rvw`、`~/.claude/skills/rvw-walkthrough`、`~/.claude/skills/rvw-structure`、`~/.claude/skills/rvw-watch-comments`
 
 rvwがインストールしたSkillには同梱版digestを記録します。`skill status --json`と`doctor --json`は、
 管理済みの旧版なら`updateAvailable: true`、ローカル編集なら`locallyModified: true`、記録のない差異なら
@@ -197,10 +232,15 @@ 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を更新し、重複した「改訂版」を追加しません。
 
+Structureを作る場合は、behavior、entrypoint、scope、含める／除外する関係を伝えて`rvw-structure` Skillを使います。
+Skillは実際のcommit済みcodeを調査し、labelではなくclaimのidentityとしてstable IDを割り当てます。
+読み順が本質ならWalkthroughを提案し、静的なarchitecture inventoryならStructureを作りません。producer authoringの実地評価は
+[Structure producer evaluation](docs/structure-producer-evaluation.md)に記録しています。
+
 新規root commentとreplyを継続監視する場合は`rvw-watch-comments` Skillを起動します。全登録PRを
 同梱driverから約1秒間隔で監視し、起動前の既存未解決commentは処理しません。自分のPRのfix-and-pushを起動taskへ
 明示許可した場合だけ、live PR authorと起動時のGitHub loginが一致するPRで修正・test・commit・pushを
@@ -216,8 +256,9 @@ queue、retry、batch内のthread単位status post、自己返信抑制をtransa
 調査結果、実装内容、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`だけを利用します。
+四つのSkillはSQLiteを直接読まず、`rvw protocol --json`、`rvw comment ... --json`、
+`rvw walkthrough get/update/publish/delete ... --json`、`rvw structure get/update/publish/delete ... --json`、
+`rvw pr sync --stdin --json`だけを利用します。
 ローカルDBやrepositoryへアクセスできないCloud Agentは対象外です。
 
 ## 復旧
@@ -232,7 +273,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、Structure、
 `refs/rvw/pr/<number>/...`を削除し、現在のGitHub状態からcacheとhead refを再構築します。
 バックアップや旧コメント移行は行わず、元に戻せません。