@01.works/visual-review 0.9.4 → 0.9.6

package/README.md

@@ -215,16 +215,26 @@ bootstrap을 시작하지 않습니다. development build의 1회 console 안내
 등록한 `onInactive` callback만 이 dormant 경계에서 실행될 수 있습니다.
 `enabled={false}`는 긴급 kill switch이며 진단도 실행하지 않습니다.
 
+검증 성공 뒤 activation의 범위는 runtime의 실제 인증 재개 범위를 따릅니다. 현재 hosted
+Convex runtime은 reviewer bearer와 marker를 모두 탭의 `sessionStorage`에 두므로 같은 탭의
+새로고침·복원만 재개합니다. Browser-persistent auth를 제공하는 runtime만 만료 시각이 든
+versioned `localStorage` marker를 사용합니다. 만료되거나 인증과 어긋난 legacy marker는
+DOM·runtime import·network 전에 제거됩니다. 위젯의 **피드백 목록 → 리뷰 종료**는 현재
+브라우저의 현재 site에서 local session과 activation을 정리하며, 모든 기기의 접근
+철회는 owner의 invitation revoke가 담당합니다.
+
 처음에는 이메일의
 `#visual-review=<invitation-id>&visual-review-token=<one-time-token>` 링크로 접근합니다. hosted service가
 project에 연결된 exact Origin 목록과 현재 pathname을 읽기 전용 activation gate로
-확인합니다. bootstrap 응답은 public Instant App ID만 반환하며 reviewer session이나
-이메일을 포함하지 않습니다. Fragment는 주소창에서 즉시 제거되고, reviewer가
-**리뷰 시작**을 누를 때 server가 1회용 token을 지정된 origin/path에서 교환해 Instant
-session과 invitation claim을 함께 만듭니다. 인증된 `/v1/pages/resolve`가 아직 등록되지 않은
+확인합니다. bootstrap 응답은 provider의 public endpoint와 invitation expiry만 반환하며
+reviewer session이나 이메일을 포함하지 않습니다. Fragment는 주소창에서 즉시 제거되고,
+reviewer가 **리뷰 시작**을 누를 때 server가 token을 지정된 origin/path에서 교환해
+provider session과 invitation claim을 함께 만듭니다. token은 15분 retry grace 뒤
+소진되며 새 탭이나 기기에서는 같은 링크가 이메일 복구 코드 flow를 시작합니다.
+인증된 `/v1/pages/resolve`가 아직 등록되지 않은
 pathname을 자동 등록합니다. Server는
-`db.asUser({ token })`으로 user-scoped claim을 실행하며 완료된 뒤에만 client가
-정확한 page를 선택해 Instant subscription과 overlay를 mount합니다. `revokedAt`,
+provider의 user-scoped mutation으로 claim을 실행하며 완료된 뒤에만 client가
+정확한 page를 선택해 subscription과 overlay를 mount합니다. `revokedAt`,
 expiry와 claim 시 membership/project mismatch는 fail closed합니다.
 
 Invitation candidate는 load gate이고 allowed origin/current pathname은 hosted