@a9n-shoji/rvw 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -5,6 +5,24 @@
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-08-20
+
+### Added
+
+- Agentが新しい未解決threadを安全なMarkdownで記録できる`comment.create` CLI capability
+- Agentが既存post本文と関連commitを置き換えられる`comment.edit` CLI capability
+- browserの戻る／進むで、review scopeやworkspace layoutを変えずに辿れるreading history
+- PR commentを継続監視し、重複なく返信できる`rvw-watch-comments` Skill
+
+### Changed
+
+- reviewerの目的とrepository固有の指示に合わせて説明を組み立てるWalkthrough authoring guide
+- `rvw-watch-comments`がclaim直後に確認中replyを追加し、同じreplyを最終結果へ更新するよう改善
+
+### Fixed
+
+- 不正なMermaidを含むcommentを表示すると、一時的なerror SVGがcomment外へ残りviewer下部を覆う問題
+
 ## [0.1.1] - 2026-08-17
 
 ### Fixed

package/README.md

@@ -92,6 +92,7 @@ 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を含む）
 - 未解決／解決済み、返信、Outdated追跡
 - Agentへ渡す一件・一覧・複数選択した`rvw://comment/<uuid>`参照のコピー
 - Agentが提示したWalkthrough、exact code reference、選択可能なMermaid node
@@ -137,8 +138,9 @@ Agentは現在内容を読み、同じ`rvw://walkthrough/<uuid>`を更新して
 
 ## Codex / Claude Code Skills
 
-アプリ本体からローカルSkillをインストールします。一度のinstallで、コメント処理用の`rvw`と
-Walkthroughのpublish・改善・削除用の`rvw-walkthrough`が入ります。Skill名と内容はCodex / Claude Codeで共通で、
+アプリ本体からローカルSkillをインストールします。一度のinstallで、コメント処理用の`rvw`、
+Walkthroughのpublish・改善・削除用の`rvw-walkthrough`、新規コメント監視用の
+`rvw-watch-comments`が入ります。Skill名と内容はCodex / Claude Codeで共通で、
 platform指定は配置先だけを選びます。
 
 ```bash
@@ -149,8 +151,8 @@ rvw skill status
 
 既定の配置先は次です。
 
-- Codex: `~/.agents/skills/rvw`、`~/.agents/skills/rvw-walkthrough`
-- Claude Code: `~/.claude/skills/rvw`、`~/.claude/skills/rvw-walkthrough`
+- 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`
 
 rvwがインストールしたSkillには同梱版digestを記録します。`skill status --json`と`doctor --json`は、
 管理済みの旧版なら`updateAvailable: true`、ローカル編集なら`locallyModified: true`、記録のない差異なら
@@ -173,12 +175,28 @@ rvw://comment/00000000-0000-4000-8000-000000000000
 rvw Skillを使って、https://github.com/owner/repository/pull/123 の未解決コメントを確認してください。
 ```
 
-Walkthroughを作る場合は、説明したい対象をセッションへ伝えて`rvw-walkthrough` Skillを使います。
-Skillは文書の見出しや説明順序を固定せず、セッションが作った説明をcommit固定のreference付きartifactとして
-検証してpublishします。Walkthrough全体へのコメントから説明を改善する場合は、現在内容を取得して同じURIを
-更新し、重複した「改訂版」を追加しません。
+Agentにreview結果をRVWへ残してもらう場合は、対象PRとコメント作成を明示します。Agentはcommit済みの
+exact sourceを確認し、通常の未解決threadを一件ずつ作成します。
 
-二つのSkillはSQLiteを直接読まず、`rvw protocol --json`、`rvw comment ... --json`、
+```text
+rvw Skillを使って、https://github.com/owner/repository/pull/123 をreviewし、見つけた指摘をRVWのコメントとして作成してください。
+```
+
+Walkthroughを作る場合は、説明したい対象と必要な作成指示をセッションへ伝えて`rvw-walkthrough` Skillを使います。
+Skillは明示された指示を優先し、未指定の作成判断だけを既定guideで補って、reviewerが変更または実装対象の
+mental modelを作るための最初の読解経路を構成します。文書の見出しや説明順序は固定せず、commit固定の
+reference付きartifactとして検証してpublishします。Walkthrough全体へのコメントから説明を改善する場合は、
+現在内容を取得して同じURIを更新し、重複した「改訂版」を追加しません。
+
+新規root commentとreplyを継続監視する場合は`rvw-watch-comments` Skillを起動します。全登録PRを
+約10秒間隔で監視し、起動前の既存未解決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へ`🔎 確認中です…`を即時返信し、
+完了時は同じreplyを最終結果へ編集します。Skill同梱のtask-state toolがrepository外のSQLiteへcursor、
+queue、retry、thread単位のstatus post、自己返信抑制をtransactionalに保存します。
+
+三つのSkillはSQLiteを直接読まず、`rvw protocol --json`、`rvw comment ... --json`、
 `rvw walkthrough get/update/publish/delete ... --json`、`rvw pr sync --stdin --json`だけを利用します。
 ローカルDBやrepositoryへアクセスできないCloud Agentは対象外です。
 
@@ -200,18 +218,22 @@ resetは対象PRのコメント、返信、コメント対象、Walkthrough、co
 
 ## CLI protocol
 
-機械向けコマンドはstdoutへJSONだけを出します。
+機械向けコマンドはstdoutへJSONだけを出します。長時間の`comment watch`だけはRFC 7464 JSON text
+sequenceを出します。
 
 ```bash
 rvw protocol --json
 rvw agent ping --json
 rvw agent status --json
 rvw pr refresh <PR_REF> --json
+rvw comment create --stdin --json
 rvw comment list <PR_REF> --state unresolved --limit 50 --offset 0 --json
+rvw comment watch [--after <CURSOR>] [--interval 10] --json-seq
 rvw comment get <COMMENT_URI> --json
 rvw comment get <COMMENT_URI> --include-pr-body --json
 rvw comment get <COMMENT_URI> --live --json
 rvw comment reply <COMMENT_URI> --stdin --json
+rvw comment edit <COMMENT_URI> --post <POST_ID> --stdin --json
 rvw comment resolve <COMMENT_URI> --json
 rvw comment reopen <COMMENT_URI> --json
 rvw walkthrough get <WALKTHROUGH_URI> --json
@@ -227,6 +249,10 @@ 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で受け取り、
+未解決のroot threadを一件作成します。repository targetはexact commit、path、任意のinclusive line rangeを
+指定し、viewerと同じ文書・行検証を通ります。作成してもbrowserを開かず、tabやcommit選択を変更しません。
+
 `comment list`は未解決を既定として`unresolved` / `resolved` / `all`をページング列挙し、各threadの
 root post preview、post件数、最新head時点のOutdated判定を返します。`hasMore`なら`nextOffset`から
 続けて取得し、完全なthreadは`comment get`で読みます。listと通常の`comment get`はPR本文を省略し、
@@ -235,7 +261,7 @@ root post preview、post件数、最新head時点のOutdated判定を返しま
 `comment get`は最新PRのtitle、base/head、serviceが導出したplacement、対象commitのbounded source
 excerptを返すため、AgentはOID比較でOutdatedを推測しません。
 
-`comment get --live`はGitHubの現在値とcacheの差をread-onlyで確認し、DBを更新しません。`pr sync`はGitHub上の最新PR状態を取得し、任意の`commentUpdates`を同じSQLite transactionで反映します。保存先がdirtyでも同じrepositoryのcleanなworktreeを`--repository`で選べ、確認済みの未追跡fileだけは`--allow-untracked`で許可できます。local branchがGitHub headより単にbehindな場合や最終同期後にforce-pushされた場合はcheckoutを変更せず同期します。`pr sync`と`comment reply`は冪等ではないため、結果が不明な場合はコメントを再取得してから再試行してください。
+`comment get --live`はGitHubの現在値とcacheの差をread-onlyで確認し、DBを更新しません。`pr sync`はGitHub上の最新PR状態を取得し、任意の`commentUpdates`を同じSQLite transactionで反映します。保存先がdirtyでも同じrepositoryのcleanなworktreeを`--repository`で選べ、確認済みの未追跡fileだけは`--allow-untracked`で許可できます。local branchがGitHub headより単にbehindな場合や最終同期後にforce-pushされた場合はcheckoutを変更せず同期します。`comment create`は非冪等です。`pr sync`と`comment reply`は任意の冪等keyを受け、`comment edit`は同じpostの完全置換なので安全に再試行できます。
 
 `rvw agent ping/status --json`はsocket path、接続結果とOS error詳細、期待／接続先DB、選択transport、
 fallback理由を表示します。人向け出力にも同じ診断項目を表示します。`RVW_AGENT_SOCKET_PATH`を明示した場合は
@@ -296,7 +322,8 @@ atomicなowner lockを取得した一つのNode processだけがlistenし、owne
 `rvw doctor --json`はmode/ownerだけでなくwrite transactionとAgent疎通も報告します。
 
 ローカルHTTP serverは`127.0.0.1`だけへbindしてHost / Originを検証し、write APIは
-`application/json`だけを受理し、CORSを有効にしません。コメントと返信はplain UTF-8 textです。
+`application/json`だけを受理し、CORSを有効にしません。コメントと返信はUTF-8 GFM Markdown sourceとして
+保存し、raw HTMLをsanitizeします。外部画像は取得せず、repository相対画像だけをexact commitから取得します。
 CLIとfrontend bundleに含まれる第三者softwareのlicenseはpackage内の
 `dist/cli-THIRD_PARTY_NOTICES.txt`と`dist/web/THIRD_PARTY_NOTICES.txt`へbuild時に収録します。