@a9n-shoji/rvw 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -5,6 +5,73 @@
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-09-08
+
+### Changed
+
+- PR全体の`rvw-review-compose` defaultを、実在fileを1 Nodeずつsource anchorへ結ぶ必須の
+  file-map Structureと、必要に応じたWalkthrough・通常Structure・直接code readingのadaptive compositionへ変更
+- `rvw-walkthrough`を具体的な問いからcode確認とmental-model更新を繰り返す読解pathとして明確化し、
+  interaction、state、branch等を文章から再構築させる場合は問いに合うMermaid図を標準的に選ぶauthoring guidanceを追加
+- `rvw-structure`に、bounded behavior mapとは別のPR-scoped file responsibility / dependency map用途を追加。
+  generic architecture inventory、新しいArtifact kind、schema、Viewer modeは追加しない
+
+## [0.6.0] - 2026-09-07
+
+### Added
+
+- 通知permissionの状態表示と、Agentのcomment更新経路を介さずbrowser / OS通知を確認できるテスト通知
+- PR全体または明示されたreview subjectを調査し、Walkthrough、Structure、直接code readingから必要最小限の
+  構成を選ぶCodex / Claude Code共通のbundled `rvw-review-compose` Skill
+- Structureへthesis、attention start、optionalなconnected exact-Edge primary backbone、stable IDとresponsibility
+  summaryを持つunorderedなnamed comprehension regionからなるoptionalなauthorial `presentation`を追加。raw座標を保存せず、spatial organizerが
+  ある時だけcanonical配置をauthoringし、start-onlyではtopology配置のままGuide、focus、visual cue、exportへ
+  説明意図を伝えられる
+- Structure Viewerへ折り畳み可能なGuide、Home / Backによるfocus navigation、clickableなRegion framing、
+  backbone salienceとfocus-hop attentionの分離、complete extentを保つsemantic zoomを追加
+- protocol version 5と`structure.presentation` capability
+
+### Changed
+
+- `rvw open`の新規runtimeを既定で`127.0.0.1:43117`へ固定し、起動をまたいでorigin-scopedな通知permissionと
+  設定を維持。空きportの自動選択は明示的な`--port 0`へ変更
+- comment watcherのauthorityをshared rvw database上のgenerationとしてdurable化し、
+  `comment.watchOwnership` capabilityでpreflightする。repository単位のwriter reservationで異なるtask / processの
+  Git writerを直列化し、generationを持たないlegacy task stateは再初期化と明示的なactivateを必須に変更
+- `rvw-walkthrough`と`rvw-structure`を一つのbounded Artifactを作るproducerとして明確化し、上位composerの
+  subject、review question、scope、inclusion / exclusionを優先しながら、`mustEstablish`、suggested origin / relation /
+  invariantはcommit済みsourceで独立に検証し、各representationの拒否境界を維持
+- review composerからproducerをcanonical名と各hostのnative Skill mechanismでloadし、Codex / Claude Code固有の
+  user-facing invocation記法を共有runtime contractにしないfail-closedな委譲へ変更
+- Structure preview / publish / updateはrequired nullableな`presentation`を受け取る。旧`graph_json`はread時に
+  `null`へnormalizeし、content rewriteは不要。migration 020は削除済みRegion IDのtombstoneだけを追加する
+- Viewer / exportで共有するdeterministicなobstacle-aware relation routeとstable label placementへ変更し、
+  exact endpointのvisible boundary portへ接続する。non-endpoint NodeへのEdge貫通とfocus変更によるlabel jumpを防ぎ、
+  shared / near-coincident corridorを持つdistinct visible relation（parallel / reciprocalを含む）の実質的lane分離と
+  normal-detail labelの相互非重複を保証
+- Structure presentationのRegion配列と各`nodeIds`を順序を持たないsetとして扱い、stable IDでcanonical化する
+- Regionを持つGraphのcanonical projectionはRegion全体をcompound chunkとして先に配置し、direct factual
+  adjacency、internal crossing、boundary affinityを使って全体extentとEdge routeを抑える。backbone-onlyの
+  projectionは従来のderived bandを維持する
+- partial Region membershipで残るneutral Contextをfactual connected component単位のrenderer-owned compoundとして
+  boundedに折り畳み、chain / bridge / fan-outをauthored Regionの全周へglobal packingすることで、12〜50 Nodeでも
+  一方向へ伸びず、Regionとexact boundary relationの近くへ配置される
+- Structure内のNode / Region / Context / exact Relation / source移動をbrowser historyへ統合し、Back / Forwardで
+  view mode、focus、hop depth、lens、cameraを復元する
+- Region frameをpane-localなchunk lensとして保持し、focusを変えずmember / internal relationをfull relevanceで
+  表示。Home / Node focus / depth変更で解除し、Backでfocus / depth / cameraと一緒に復元
+- 長いprimary backboneのderived bandをdeterministicなserpentine複数行へ折り返し、region envelopeの衝突を
+  避けながらcanonical mapの縦方向を活用。row / layerを新しいprotocol semanticsにはしない
+- bundled Skillsのprotocol preflightをversion 5へ更新
+
+### Fixed
+
+- 最後のviewerを閉じて再起動した際、random portによるorigin変更でAgentコメント通知が事実上リセットされる問題
+- superseded watcherがauthorityを再取得できるrace、resolved / missing threadのhistorical eventがactionable workとして
+  再処理される問題、別task / processのrepository writerが重複実行される問題
+- Structureのfile逆引きをCmd / Ctrl+Clickした際に修飾キーが失われ、右ペインではなく左ペインへ開く問題
+- 2-hop表示で遠距離のbackbone Node / Edgeだけが強いopacityを保ち、focusからの距離層を判別できない問題
+
 ## [0.5.0] - 2026-09-03
 
 ### Added

package/README.md

@@ -6,8 +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を自由に辿れます。
+関係を同時に見渡したいsubjectは、Agentがsource anchorとoptionalなauthorial presentation付きStructureとして
+提示でき、意図されたspatial explanationを手がかりに同じworkspaceでnodeとrelationを自由に辿れます。
 
 diffは変更を見つける入口であり、レビュー対象の境界ではありません。人間が結果を読み、影響を追い、
 次に直すべきことを判断します。Codex / Claude Codeは、その判断を同梱された共通Skillと`rvw` CLI
@@ -67,20 +67,27 @@ rvw open https://github.com/owner/repository/pull/123
 rvw open
 ```
 
-serverは`127.0.0.1`の空きportだけへbindします。同じdatabaseで既にrvwが動いていれば、通常の
+serverは`127.0.0.1:43117`へbindします。同じdatabaseで既にrvwが動いていれば、通常の
 `rvw open`はそのruntimeへPRを追加し、同じoriginで新しいtabを開きます。二つ目のserverやdatabase接続は
 起動しません。最初の`rvw open`だけがbackground runtimeを開始し、最初のtab接続を確認してから端末へ
 制御を返します。最後のtabを閉じると短い猶予後に停止し、リロード中や別tabが残っている間は停止しません。
-異なる`RVW_DATABASE_PATH`を指定したruntimeは独立して起動できます。
+固定originにより、Browser NotificationのpermissionとAgentコメント通知設定は通常起動をまたいで維持されます。
+空きportを自動選択する場合は`--port 0`を明示します。この場合は起動ごとにoriginが変わり得るため、通知permissionと
+browser storageは引き継がれません。異なる`RVW_DATABASE_PATH`のruntimeを同時に起動する場合は、二つ目へ別の
+固定`--port`または`--port 0`を指定します。
 
 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を指定した場合は
+終了猶予中に無効になることはありません。初回の`--port`は尊重し、省略時はactive runtimeのoriginを再利用します。
+active runtimeと異なるportを明示した場合は
 二つ目を起動せず競合を返します。一度登録したPRは、完全URLまたは全登録PRで一意な番号を指定すれば
 repository外のdirectoryからも開けます。
 
+最上部の`...` menuでは、Browser Notificationのpermission状態を確認し、Agent更新と独立したテスト通知を送れます。
+`Agentのコメントを通知`を有効にすると、初回読込後にAgentが追加・更新した最終回答を通知します。
+
 ## 変更を理解する
 
 初回openでPRのcommit履歴と最新PR本文を取得します。以後は保持済み状態を先に表示し、viewer起動後または最上部の`...` menuにある`GitHubと同期`で最新状態を取得します。独自の版取り込み操作はありません。
@@ -121,7 +128,8 @@ viewerはこの流れのために次を提供します。
 
 ## Agentの説明を人間の順序で検証する
 
-外部Agentは`rvw-walkthrough` SkillとCLIを使い、実装説明を一つのsource commitをanchorとしてrvwへ提示できます。
+外部Agentは単一Artifact producerである`rvw-walkthrough` SkillとCLIを使い、一つのbounded subjectの
+実装説明を一つのsource commitをanchorとしてrvwへ提示できます。
 
 ```bash
 rvw walkthrough publish --stdin --json
@@ -144,12 +152,21 @@ lineを誤適用せずlatest全文を表示します。fallbackでは、同じfi
 
 Walkthrough本文のinline referenceとMermaid node linkは維持しますが、同じ参照を横や下へ列挙する
 `Code references` indexとsidebar上の参照件数は表示しません。そのため、本文linkと、本文中に実在する
-flowchart/classDiagram nodeへのMermaid bindingのどちらからも使われないreferenceはpublish/update時に
+対応済みnode-like elementへのMermaid bindingのどちらからも使われないreferenceはpublish/update時に
 拒否します。存在しないnode名だけをbindingへ宣言しても使用済みにはなりません。
 
 Mermaidの描画はflowchartだけに限定せず、class、sequence、state、ERなどbundled Mermaidが対応する
-記法を受け付けます。code referenceとの要素bindingはflowchartとclass diagramをE2Eで保証し、
-SVG上の要素構造が異なる他の記法は描画とinteractionを分けて扱います。
+記法を受け付けます。code referenceとの要素bindingはflowchart node、class、sequence participant / actor、
+state、ER entity、architecture serviceをE2Eで保証します。message、transition、relationship、architecture
+edge / groupなどのedge-like elementはbindingできないため、そのclaimの根拠は図の近くのinline referenceで
+開けるようにします。binding IDはWalkthrough全体で共有され、別sourceを開く複数図では別IDを使います。
+
+authoringの既定は、具体的な状況と最初のcode入口から始め、一つの問いに必要な小さな説明を得てsourceで
+確かめ、何が分かったかを責務・状態・条件・結果へ位置付け、次の探索理由へつなぐ読解pathです。複数の主体、
+状態、順序、分岐を文章だけから組み立て直す必要がある場合、Mermaidを標準的に使います。flowchartは分岐、
+stateDiagram-v2はstate / lifecycle、sequenceDiagramはinteraction / async順序というように中心の問いから
+図法を選び、必要になった地点へ一問一図の小さな図を置きます。小さな定数や局所条件は図なしの方が明快です。
+図の矢印、状態、順序もsourceについてのclaimであり、renderやbinding成功だけで意味の正しさは保証されません。
 
 これはin-app AI chatではありません。説明と図はAgentのclaimで、commit済みcodeが検証対象の正本です。
 Walkthroughにはローカルな版履歴を持たせません。説明全体へのfeedbackはstableなWalkthrough IDへ残るため、
@@ -159,9 +176,16 @@ Agentは現在内容を読み、同じ`rvw://walkthrough/<uuid>`を更新して
 
 ## codeの関係を空間として検証する
 
-外部Agentは`rvw-structure` SkillとCLIを使い、PRに関係するboundedなbehaviorをfactualなcode entrypointから
-dependency、contract、side effectへ辿る空間として提示できます。必須の読み順を持つ説明はWalkthroughです。
-entrypointを置けない静的なarchitecture／責務inventoryはStructureへ広げません。
+外部Agentは単一Artifact producerである`rvw-structure` SkillとCLIを使い、PRに関係する一つのboundedな
+behavior / review questionをfactualなcode entrypointからdependency、contract、side effectへ辿る空間、
+またはPRを理解するためのfile responsibility / dependency mapを提示できます。ファイル地図では実在する
+repository fileを1 Nodeずつfile-level anchorへ結び、Edgeを具体的なsource evidenceで検証します。
+thesis、最初に見るNode、必要な場合だけ2〜12 Node / 1〜16 Edgeのconnected exact-relation backbone、
+stable IDと責務summaryを持つcomprehension regionで説明の意図を表せます。artifactは一つのbounded behavior、
+review question、またはfile relation setに必要なrelationを保持し、Viewerはstableな全体像とfocus-relativeな
+局所lensを往復します。正直なspatial organizerがない場合も、意味のある
+thesisとattention startだけを提示できます。順序とprose自体がartifactならWalkthroughです。
+PRへ接地しない静的なarchitecture／責務inventoryやrepository全体のimport graphへは広げません。
 
 ```bash
 rvw structure preview --stdin --json
@@ -171,18 +195,54 @@ 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からなります。
+Structureは一つのexact `sourceOid`、宣言されたtitle / scope、roleに合うorigin、stableなNode / Edge ID、required nullableな
+`presentation`からなります。presentationはraw座標ではなく、thesis、authorialなattention start、exact factual
+Edgeのunordered setからなる一つのoptionalなconnected primary backbone、stable ID / label / 責務summary /
+重複しないNode membershipを持つcomprehension regionからなるauthorial semanticsです。backboneもregionも持たないstart-only presentationは、
+意味のあるthesisとattention startを伝えられる一方、graph配置へ存在しないspatial orderを作りません。
 Nodeは0または1件、Edgeは0件以上のsource anchorを持ち、rvwはcommit、UTF-8 path、line pair、endpoint、
-focus、重複ID、sizeを保存前に検証します。publish / updateはbrowserやnavigationを操作しません。
-publish / update前には同じgraph contentをpreviewし、canonical layout diagnosticsとauthoring warningから
+重複ID、presentation参照とmembership、sizeを保存前に検証します。publish / updateはbrowserやnavigationを操作しません。
+publish / update前には同じgraph contentをpreviewし、presentationに依存しないtopology diagnosticsとauthoring warningから
 origin、granularity、behavior / subject boundaryを再確認できます。warningは保存を拒否せず、graphを自動変更しません。
 
-viewerではfocusがある時に1-hop / 2-hopへ絞り、Allでは全Node / Edgeを表示します。relationを次数やIDで
-暗黙に隠さず、pan、zoom、fit、node drag、layout resetで探索できます。通常clickでexact sourceを左、
+primary backboneまたはregionがあればcanonical配置へ反映し、backboneもregionもないstart-only presentationと
+`presentation: null`は同じtopology projectionを使います。start-onlyでもthesisとattention startはoverview、
+visual cue、exportへ残り、新規sessionは`startNodeId`から始まります。factual entrypointのoriginは別に示します。
+header直下のcompact Guideはattention startと折り畳み可能なthesisだけを示し、backbone Edgeの完全なリストや
+Region関係図を複製しません。Structure本体はGraph / Regionsを切り替えられ、Regions modeではRegionごとの責務を
+矩形として示し、factual Edgeから導出したdirectなRegion間connectionを矢印で表示します。Regionを選ぶとGraphへ
+drill-downして、代表Nodeを捏造せずexact memberへviewportを移動します。Graph上にはRegionのfull label、責務summary、
+member / internal relation数を持つcompact lensを表示し、対象Nodeと内部relationを専用styleで強調します。stable ID由来の
+略称を復号したり、Node配置からmembershipを推測したりする必要はありません。BackでRegions overviewへ戻れます。
+Regions modeはcard geometryを狭いpaneへ押し込まず、初期表示 / ResetではStartを含む責務を読めるscaleで示し、
+Fitだけがmap全体を収めます。独立したzoom / wheel・drag panで局所を読みます。このRegions cameraはGraph viewportと混ぜずpane-local sessionへ保持し、
+mode切替、Region drillからのBack、tab往復でもそれぞれの位置を復元します。
+region membershipは囲い枠ではなく明示Node IDに
+基づくため、manual drag後も変わりません。regionはnamed comprehension chunkで、summaryはそのchunkがthesisへ
+何を寄与するかを伝えます。Region arrayと各`nodeIds`の順序に意味はなく、stable IDでcanonical化されます。
+Region間の関係は別のauthorial graphではなく、member間のdirect factual EdgeからViewerが導出します。
+viewerではHomeでauthorial start（null presentationではorigin）とexact 1-hopを読み、canvas / minimapに残る
+backbone emphasisでcoreの位置を保ちながら、single clickではcameraを動かさずNodeを選択し、double clickでは
+選択Nodeとexact 1-hopへone-shotでfocusします。1-hop / 2-hop、Region frame、AllをBackで往復できます。
+HomeとRegion frameは対象を確実に見せるためAllへ切り替えます。Region frame中はfocusを維持したままmemberと内部relationを
+full relevanceで読め、Home、Node selection、depth変更で解除します。Backは直前のview mode / focus / hop depth / framed region / viewportを復元します。
+backbone membershipは固定されたauthorial salience、focus hopは一時的なreviewer attentionとして別に表示します。
+低zoomで省略するdetailもvisible / total件数、minimap、selection、Allから回収でき、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は新しい
+変えません。GraphのNode位置 / viewportとRegions viewportは互いに独立して同じbrowser sessionで保持しますが、SQLiteやAgent protocolへ座標を
+保存しません。同じsubjectの更新は同じURIを完全置換します。通常は存続するIDの位置を保ちますが、backbone endpoint
+adjacency、Region identity / membershipなどspatial organizerが変われば、新しいspatial semanticsへcanonical geometryをrebaseします。
+frame中のRegion IDが存続する場合はchunk lensも維持し、current memberと内部relationのderived boundsへrefitします。
+Regionのlabel / summaryや配列順だけの変更ではGraphのNode geometryをrebaseしません。
+Regions cameraは別のderived-map basisでreconcileし、unorderedな配列順やsummary / thesisだけの変更では保持する一方、
+Region label / membership、cross-Region Edge endpoint・direction・labelなどprojection / routingが変われば、
+Startを読める新しいHome projectionへ戻します。map全体への縮小は明示的なFitだけが行います。
+`null`とstart-onlyの往復やthesis / startだけの変更ではmanual geometryを保ちます。別subjectは新しい
 Structureとしてpublishします。
+Node / Edge / Regionのstable IDは同じclaim / comprehension chunkが存続する間だけ維持し、一度削除したIDを
+別の意味で再利用しません。rvwは三種類すべてのretired IDをtombstoneとして保持し、後のupdateでの再導入を
+拒否します。存続中のIDが意味ごと差し替えられたかは機械判定せず、producerが新しいIDを割り当てます。
 
 Structure headerの`Export`から、現在のNode配置を保った図全体をstandalone SVGまたは2倍基準のPNGとして
 保存できます。focusや1-hop / 2-hopで画面上に絞り込んでいても、出力には全Node、全Relation、全Edge labelが
@@ -190,11 +250,11 @@ Structure headerの`Export`から、現在のNode配置を保った図全体をs
 
 ## Codex / Claude Code Skills
 
-アプリ本体からローカルSkillをインストールします。一度のinstallで、コメント処理用の`rvw`、
-Walkthroughのpublish・改善・削除用の`rvw-walkthrough`、Structureのpublish・置換・削除用の
-`rvw-structure`、新規コメント監視用の
-`rvw-watch-comments`が入ります。Skill名と内容はCodex / Claude Codeで共通で、
-platform指定は配置先だけを選びます。
+アプリ本体からローカルSkillをインストールします。一度のinstallで、コメント処理用の`rvw`、PR全体の
+必要最小限のreview compositionを選ぶ`rvw-review-compose`、単一Walkthroughのpublish・改善・削除用の
+`rvw-walkthrough`、単一Structureのpublish・置換・削除用の`rvw-structure`、新規コメント監視用の
+`rvw-watch-comments`という5つが入ります。Skill名と内容はCodex / Claude Codeで共通で、platform指定は
+配置先だけを選びます。
 
 ```bash
 rvw skill install codex
@@ -204,8 +264,8 @@ rvw skill status
 
 既定の配置先は次です。
 
-- 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`
+- Codex: `~/.agents/skills/rvw`、`~/.agents/skills/rvw-review-compose`、`~/.agents/skills/rvw-walkthrough`、`~/.agents/skills/rvw-structure`、`~/.agents/skills/rvw-watch-comments`
+- Claude Code: `~/.claude/skills/rvw`、`~/.claude/skills/rvw-review-compose`、`~/.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`、記録のない差異なら
@@ -237,16 +297,52 @@ globalなcommit選択を変えずに開けます。
 rvw Skillを使って、https://github.com/owner/repository/pull/123 をreviewし、見つけた指摘をRVWのコメントとして作成してください。
 ```
 
-Walkthroughを作る場合は、説明したい対象と必要な作成指示をセッションへ伝えて`rvw-walkthrough` Skillを使います。
-Skillは明示された指示を優先し、未指定の作成判断だけを既定guideで補って、reviewerが変更または実装対象の
-mental modelを作るための最初の読解経路を構成します。文書の見出しや説明順序は固定せず、source anchorを持つ
-reference付きartifactとして検証してpublishします。Walkthrough全体へのコメントから説明を改善する場合は、
-現在内容を取得して同じURIを更新し、重複した「改訂版」を追加しません。
+PR全体または明示したreview subjectについて、どの説明surfaceが必要かも含めて任せる場合は
+`rvw-review-compose` Skillを使います。
 
-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)に記録しています。
+```text
+rvw-review-compose Skillを使って、https://github.com/owner/repository/pull/123 を理解するための
+Walkthrough / Structureをおすすめの構成で作ってください。
+```
+
+composerはcommit済みcodeと周辺contextを調査します。PR全体のdefault compositionでは、変更を理解するために
+必要な実在fileの責務と具体的な依存を示すファイル地図Structureを必ず含め、その制約内で総理解コストを
+最小化します。小さなPRなら1 Node / 0 Edgeの地図と直接code readingだけで構いません。意味のあるbehavior
+changeには原則Walkthroughを選び、ownership、state authority、contract等の関係理解に独立した価値があれば、
+ファイル地図とは別の通常Structureも選びます。Walkthroughと通常Structureを常に一組にせず、固定の3 Artifact、
+overview、section template、reading orderも要求しません。recommendation-onlyでは必須地図も未作成briefに留まり、
+権限やtransportが足りなければ未達理由を返します。作成後は通常のAgent responseで、構成理由、推奨される最初の入口、作成または
+更新したURI、ファイル地図に含めた／除外した範囲、意図的に直接code readingへ残した論点を返します。このresponseとcomposer内部の理解単位やbriefは
+永続Artifactではなく、厳密なreview完了planでもありません。ReviewerはWalkthrough、Structure、codeのどこからでも
+入り直せます。
+
+composerは各producerをcanonical Skill名で、Codex / Claude Codeそれぞれのnative Skill mechanismからloadします。
+共有Skill本文は`$name`や`/name`をruntime protocolとして扱わず、producerがsessionで利用不能ならArtifact操作前に
+停止します。briefのsubject、review question、purpose / behavior boundary、scope、inclusion / exclusion、emphasisは
+調査範囲のauthorityですが、`mustEstablish`、suggested origin / relationship / invariantなどの実装assertionはproducerが
+commit済みsourceとtestから独立に検証するcandidate claimです。briefやvalidなsource rangeだけで事実とはみなしません。
+
+Walkthroughを一件作る場合は、説明したいbounded subjectと必要な作成指示をセッションへ伝えて
+`rvw-walkthrough` Skillを直接使います。Skillは上位composerを含む明示されたbriefのsubject、review question、
+scope、inclusion / exclusion、emphasisを優先し、未指定の作成判断だけを既定guideで補います。PR全体のArtifact数や
+Structureとの役割分担を決めず、そのsubjectに適した一つのordered pathをsource anchor付きreferenceで検証して
+publishします。`mustEstablish`その他の実装assertionはauthorityとして受け入れずsourceから再検証し、essential claimが
+unsupported / contradictedなら無理なanchorを付けずcallerへ返します。ordered pathが適切でなければStructureを提案する
+representation rejectionは残ります。
+Walkthrough全体へのコメントから説明を改善する場合は、現在内容を取得して同じURIを更新し、重複した
+「改訂版」を追加しません。
+
+Structureを作る場合は、通常Structureかファイル地図か、behavior / review question、roleに合うorigin候補、scope、含める／除外する関係と、必要なら伝えたいthesis、
+最初に見るNode、connectedなexact factual relation setのprimary backbone、regionを伝えて`rvw-structure` Skillを使います。
+Skillは上位composerを含む明示briefを調査boundaryのauthorityとして一つのbounded mapだけを扱い、suggested
+originやrelationを実際のcommit済みcodeから再検証して、labelではなくclaimのidentityとしてstable IDを割り当てます。
+通常Structureはresponsibility等をcode-level Nodeへ分けられます。ファイル地図は同一pathを分割せず、複数fileを
+まとめず、全Nodeをfile-level anchorへ置きます。独立領域を架空Edgeで結ばず、必要ならcomposerが別地図を判断します。
+PR全体の構成や別behaviorのArtifactは自律的に増やしません。順序とprose自体が本質ならWalkthroughを提案し、
+Structureを一本道のstepperにせず、genericな静的architecture inventoryも作らないrepresentation rejectionは残ります。
+producer authoringの実地評価は
+[Structure producer evaluation](docs/structure-producer-evaluation.md)、[Walkthrough producer evaluation](docs/walkthrough-producer-evaluation.md)、composition判断のfresh-context評価は
+[Review composition decision evaluation](docs/review-composition-evaluation.md)に記録しています。
 
 新規root commentとreplyを継続監視する場合は`rvw-watch-comments` Skillを起動します。全登録PRを
 同梱driverから約1秒間隔で監視し、起動前の既存未解決commentは処理しません。自分のPRのfix-and-pushを起動taskへ
@@ -263,9 +359,12 @@ 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 structure preview/get/update/publish/delete ... --json`、
-`rvw pr sync --stdin --json`だけを利用します。
+5つのSkillはrvwのapplication SQLiteを直接読まず、rvwへの操作には`rvw protocol --json`、`rvw agent status --json`、
+`rvw comment ... --json`、
+`rvw walkthrough get/update/publish/delete ... --json`、
+`rvw structure list/preview/get/update/publish/delete ... --json`、`rvw pr sync --stdin --json`という既存contractだけを
+利用します。composerの追加による新しいCLI commandやprotocol capabilityはありません。既存Walkthrough URIが
+明示されない場合に全Walkthroughを列挙するcontractもないため、composerはSQLiteを読んで重複を推測しません。
 ローカルDBやrepositoryへアクセスできないCloud Agentは対象外です。
 
 ## 復旧
@@ -297,6 +396,10 @@ 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 watch-task activate --task-id <UUID> --json
+rvw comment watch-task verify --task-id <UUID> --generation <N> --json
+rvw comment watch-task reserve-write --task-id <UUID> --generation <N> --lease-id <UUID> --write-key <OWNER/REPOSITORY> --json
+rvw comment watch-task release-write --task-id <UUID> --generation <N> --lease-id <UUID> --json
 rvw comment get <COMMENT_URI> --json
 rvw comment get <COMMENT_URI> --include-pr-body --json
 rvw comment get <COMMENT_URI> --live --json
@@ -317,6 +420,12 @@ rvw pr attach <PR_REF> --repository <PATH> --json
 stdinをcloseし、shellではpipe、quoted heredoc、input redirectionのいずれかを使います。起動済みの
 対話commandへJSONと改行だけを送るとEOF待ちになります。
 
+`comment watch-task`は同じrvw databaseを監視する外部taskのgenerationを管理します。新taskだけが
+`activate`し、再開taskは保存済みgenerationを`verify`します。comment watch cursorは引き続きevent位置
+だけを表し、consumer ownershipとは独立です。repository writer reservationもrvw databaseで共有され、
+active generationの検証と取得が同じtransactionで行われます。旧generationの取得済みreservationは
+releaseされるまで新generationをブロックします。
+
 `comment create`は登録済みPR、通常のcomment target、本文、任意のAgent名、投稿単位code referenceをstdin JSONで受け取り、
 未解決のroot threadを一件作成します。repository targetはexact commit、path、任意のinclusive line rangeを
 指定し、viewerと同じ文書・行検証を通ります。作成してもbrowserを開かず、tabやcommit選択を変更しません。
@@ -367,16 +476,27 @@ source checkoutでは、GitHub接続や保存済みPRを用意せずにrepositor
 pnpm demo
 ```
 
-このデモは小さなE2E fixtureとは分離され、現在のcheckoutにある直近6件のfirst-parent commitを
-一つのsynthetic PRとして表示します。tree、文書、diff、検索はworktreeではなく実際のGit objectから読み、
-100件以上の実在file、複数commit、変更外のtest・document・Skill、初期commentとWalkthroughを含みます。
+既定のデモは、固定metadataからtemporary directoryへ毎回同じSHA-1 Git historyを構築します。架空の注文
+serviceに対するresilient order placement PRを、7 commits、changed / unchanged file、review comments、
+Walkthrough、Structureを含む一貫したreview workloadとして表示します。networkや現在のrvw historyには依存しません。
 browserを自動で開かない場合は`pnpm demo -- --no-open`、portを変える場合は`RVW_DEMO_PORT`を指定します。
-デモを停止するには起動したterminalでCtrl+Cを押してください。
+
+現在のrvw checkoutをそのままreviewする任意のdogfood modeは別commandです。表示内容はlocal refsと
+committed historyに応じて変わり、必要なfirst-parent historyが不足していれば明示的に失敗します。
+
+```bash
+pnpm demo:dogfood
+```
+
+fixtureのcontract / realistic / stress / dogfoodの境界、realistic historyの更新規則、anchor integrity、
+stress coverageの場所は[Fixture architecture](docs/fixture-architecture.md)を参照してください。デモを停止するには
+起動したterminalでCtrl+Cを押してください。
 
 ```bash
 pnpm install --frozen-lockfile
 pnpm check
 pnpm test
+pnpm test:dogfood
 pnpm test:e2e
 pnpm build
 pnpm test:package