@designfever/web-review-kit 0.1.0

package/dist/types-D_mNjOHx.d.cts

@@ -0,0 +1,183 @@
+type ReviewItemKind = 'note' | 'area';
+type ReviewItemScope = 'mobile' | 'tablet' | 'desktop' | 'wide' | 'dom';
+type ReviewWorkflowStatus = 'todo' | 'doing' | 'review' | 'hold' | 'done';
+type ReviewItemStatus = 'open' | 'resolved' | ReviewWorkflowStatus;
+type ReviewMode = 'idle' | 'note' | 'element' | 'area';
+type ReviewSource = 'local' | 'df-sheet' | 'supabase' | (string & {});
+type ReviewSubmitStatus = 'idle' | 'submitting' | 'submitted' | 'failed';
+type ReviewViewportScope = Exclude<ReviewItemScope, 'dom'>;
+type DomAnchorStrategy = 'configured-attribute' | 'id' | 'class' | 'dom-path';
+interface ReviewRulerConfig {
+    enabled?: boolean;
+    unit?: string;
+}
+interface DomAnchorCandidate {
+    selector: string;
+    strategy: DomAnchorStrategy;
+    textFingerprint?: string;
+    confidence?: number;
+}
+interface DomSourceHint {
+    component?: string;
+    file?: string;
+    sectionId?: string;
+    sectionIndex?: string;
+}
+interface DomAnchor extends DomAnchorCandidate {
+    candidates?: DomAnchorCandidate[];
+    htmlSnippet?: string;
+    source?: DomSourceHint;
+}
+interface RelativeSelection {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface ViewportSize {
+    width: number;
+    height: number;
+}
+interface ReviewPoint {
+    x: number;
+    y: number;
+}
+interface ReviewMarker {
+    viewport: ReviewPoint;
+    relative?: ReviewPoint;
+}
+interface ReviewSelection {
+    viewport: RelativeSelection;
+    relative?: RelativeSelection;
+}
+interface ReviewItem {
+    id: string;
+    reviewNumber?: number;
+    projectId: string;
+    routeKey: string;
+    pageUrl: string;
+    originalUrl?: string;
+    normalizedPath: string;
+    scope?: ReviewItemScope;
+    kind: ReviewItemKind;
+    title?: string;
+    comment: string;
+    status: ReviewItemStatus;
+    viewport: ViewportSize;
+    devicePixelRatio?: number;
+    scroll?: {
+        x: number;
+        y: number;
+    };
+    anchor?: DomAnchor;
+    marker?: ReviewMarker;
+    selection?: ReviewSelection;
+    externalIssueId?: string;
+    externalIssueUrl?: string;
+    submittedAt?: string;
+    submitStatus?: ReviewSubmitStatus;
+    submitError?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ReviewItemQuery {
+    projectId: string;
+    pageId?: string;
+    routeKey?: string;
+    normalizedPath?: string;
+    status?: ReviewItemStatus;
+    source?: string;
+}
+interface WebReviewKitAdapter {
+    get(id: string): Promise<ReviewItem | null>;
+    list(query: ReviewItemQuery): Promise<ReviewItem[]>;
+    create(item: ReviewItem): Promise<ReviewItem>;
+    update(id: string, patch: Partial<Omit<ReviewItem, 'id' | 'createdAt'>>): Promise<ReviewItem>;
+    remove(id: string): Promise<void>;
+}
+interface LocalAdapterOptions {
+    storageKey?: string;
+}
+interface DfSheetAdapterOptions {
+    baseUrl?: string;
+    projectId: string;
+    pageId: string;
+    reviewProjectId?: string;
+    reviewPathPrefix?: string;
+    source?: string;
+    issueType?: string;
+    priority?: string;
+    token?: string;
+}
+interface SupabaseReviewClient {
+    from(table: string): any;
+    rpc?: (fn: string, args?: Record<string, unknown>) => any;
+}
+interface SupabaseReviewAdapterOptions {
+    client: SupabaseReviewClient;
+    table?: string;
+    projectId: string;
+    source?: ReviewSource;
+    createRpc?: string;
+    reviewPathPrefix?: string;
+    unsafeClientReviewNumberFallback?: boolean;
+}
+interface ReviewViewportPreset {
+    label: string;
+    width: number;
+    height: number;
+    scope?: Exclude<ReviewItemScope, 'dom'>;
+}
+interface NumberedReviewItem {
+    item: ReviewItem;
+    scope: ReviewItemScope;
+    label: string;
+    number: number;
+    displayLabel: string;
+}
+interface WebReviewKitOptions {
+    projectId: string;
+    adapter?: WebReviewKitAdapter;
+    target?: WebReviewKitTarget | (() => WebReviewKitTarget | undefined);
+    viewports?: {
+        presets?: ReviewViewportPreset[];
+    };
+    ruler?: ReviewRulerConfig;
+    hotkeys?: {
+        qa?: string;
+    };
+    anchors?: {
+        attribute?: string;
+    };
+    onRestoreItem?: (item: ReviewItem) => void | Promise<void>;
+    onItemsChange?: (items: ReviewItem[]) => void;
+    onModeChange?: (mode: ReviewMode) => void;
+    ui?: {
+        panel?: boolean;
+    };
+    modules?: {
+        qa?: boolean;
+        grid?: boolean;
+        figma?: boolean;
+    };
+}
+interface WebReviewKitController {
+    open(): void;
+    close(): void;
+    toggle(): void;
+    setMode(mode: ReviewMode): void;
+    getMode(): ReviewMode;
+    highlightItem(itemId?: string): void;
+    setHiddenItemIds(itemIds?: string[]): void;
+    reload(): Promise<ReviewItem[]>;
+    getItems(): ReviewItem[];
+    destroy(): void;
+}
+interface WebReviewKitTarget {
+    window: Window;
+    document: Document;
+    getViewportRect?: () => Pick<DOMRect, 'left' | 'top' | 'width' | 'height'>;
+    getOverlayRect?: () => Pick<DOMRect, 'left' | 'top' | 'width' | 'height'>;
+}
+
+export type { DfSheetAdapterOptions as D, LocalAdapterOptions as L, NumberedReviewItem as N, ReviewWorkflowStatus as R, SupabaseReviewAdapterOptions as S, ViewportSize as V, WebReviewKitAdapter as W, ReviewItemStatus as a, WebReviewKitOptions as b, WebReviewKitController as c, ReviewViewportPreset as d, ReviewItem as e, ReviewItemScope as f, DomAnchor as g, DomAnchorCandidate as h, DomAnchorStrategy as i, DomSourceHint as j, RelativeSelection as k, ReviewItemKind as l, ReviewItemQuery as m, ReviewMarker as n, ReviewMode as o, ReviewPoint as p, ReviewRulerConfig as q, ReviewSelection as r, ReviewSource as s, ReviewSubmitStatus as t, ReviewViewportScope as u, SupabaseReviewClient as v, WebReviewKitTarget as w };

package/dist/types-D_mNjOHx.d.ts

@@ -0,0 +1,183 @@
+type ReviewItemKind = 'note' | 'area';
+type ReviewItemScope = 'mobile' | 'tablet' | 'desktop' | 'wide' | 'dom';
+type ReviewWorkflowStatus = 'todo' | 'doing' | 'review' | 'hold' | 'done';
+type ReviewItemStatus = 'open' | 'resolved' | ReviewWorkflowStatus;
+type ReviewMode = 'idle' | 'note' | 'element' | 'area';
+type ReviewSource = 'local' | 'df-sheet' | 'supabase' | (string & {});
+type ReviewSubmitStatus = 'idle' | 'submitting' | 'submitted' | 'failed';
+type ReviewViewportScope = Exclude<ReviewItemScope, 'dom'>;
+type DomAnchorStrategy = 'configured-attribute' | 'id' | 'class' | 'dom-path';
+interface ReviewRulerConfig {
+    enabled?: boolean;
+    unit?: string;
+}
+interface DomAnchorCandidate {
+    selector: string;
+    strategy: DomAnchorStrategy;
+    textFingerprint?: string;
+    confidence?: number;
+}
+interface DomSourceHint {
+    component?: string;
+    file?: string;
+    sectionId?: string;
+    sectionIndex?: string;
+}
+interface DomAnchor extends DomAnchorCandidate {
+    candidates?: DomAnchorCandidate[];
+    htmlSnippet?: string;
+    source?: DomSourceHint;
+}
+interface RelativeSelection {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface ViewportSize {
+    width: number;
+    height: number;
+}
+interface ReviewPoint {
+    x: number;
+    y: number;
+}
+interface ReviewMarker {
+    viewport: ReviewPoint;
+    relative?: ReviewPoint;
+}
+interface ReviewSelection {
+    viewport: RelativeSelection;
+    relative?: RelativeSelection;
+}
+interface ReviewItem {
+    id: string;
+    reviewNumber?: number;
+    projectId: string;
+    routeKey: string;
+    pageUrl: string;
+    originalUrl?: string;
+    normalizedPath: string;
+    scope?: ReviewItemScope;
+    kind: ReviewItemKind;
+    title?: string;
+    comment: string;
+    status: ReviewItemStatus;
+    viewport: ViewportSize;
+    devicePixelRatio?: number;
+    scroll?: {
+        x: number;
+        y: number;
+    };
+    anchor?: DomAnchor;
+    marker?: ReviewMarker;
+    selection?: ReviewSelection;
+    externalIssueId?: string;
+    externalIssueUrl?: string;
+    submittedAt?: string;
+    submitStatus?: ReviewSubmitStatus;
+    submitError?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ReviewItemQuery {
+    projectId: string;
+    pageId?: string;
+    routeKey?: string;
+    normalizedPath?: string;
+    status?: ReviewItemStatus;
+    source?: string;
+}
+interface WebReviewKitAdapter {
+    get(id: string): Promise<ReviewItem | null>;
+    list(query: ReviewItemQuery): Promise<ReviewItem[]>;
+    create(item: ReviewItem): Promise<ReviewItem>;
+    update(id: string, patch: Partial<Omit<ReviewItem, 'id' | 'createdAt'>>): Promise<ReviewItem>;
+    remove(id: string): Promise<void>;
+}
+interface LocalAdapterOptions {
+    storageKey?: string;
+}
+interface DfSheetAdapterOptions {
+    baseUrl?: string;
+    projectId: string;
+    pageId: string;
+    reviewProjectId?: string;
+    reviewPathPrefix?: string;
+    source?: string;
+    issueType?: string;
+    priority?: string;
+    token?: string;
+}
+interface SupabaseReviewClient {
+    from(table: string): any;
+    rpc?: (fn: string, args?: Record<string, unknown>) => any;
+}
+interface SupabaseReviewAdapterOptions {
+    client: SupabaseReviewClient;
+    table?: string;
+    projectId: string;
+    source?: ReviewSource;
+    createRpc?: string;
+    reviewPathPrefix?: string;
+    unsafeClientReviewNumberFallback?: boolean;
+}
+interface ReviewViewportPreset {
+    label: string;
+    width: number;
+    height: number;
+    scope?: Exclude<ReviewItemScope, 'dom'>;
+}
+interface NumberedReviewItem {
+    item: ReviewItem;
+    scope: ReviewItemScope;
+    label: string;
+    number: number;
+    displayLabel: string;
+}
+interface WebReviewKitOptions {
+    projectId: string;
+    adapter?: WebReviewKitAdapter;
+    target?: WebReviewKitTarget | (() => WebReviewKitTarget | undefined);
+    viewports?: {
+        presets?: ReviewViewportPreset[];
+    };
+    ruler?: ReviewRulerConfig;
+    hotkeys?: {
+        qa?: string;
+    };
+    anchors?: {
+        attribute?: string;
+    };
+    onRestoreItem?: (item: ReviewItem) => void | Promise<void>;
+    onItemsChange?: (items: ReviewItem[]) => void;
+    onModeChange?: (mode: ReviewMode) => void;
+    ui?: {
+        panel?: boolean;
+    };
+    modules?: {
+        qa?: boolean;
+        grid?: boolean;
+        figma?: boolean;
+    };
+}
+interface WebReviewKitController {
+    open(): void;
+    close(): void;
+    toggle(): void;
+    setMode(mode: ReviewMode): void;
+    getMode(): ReviewMode;
+    highlightItem(itemId?: string): void;
+    setHiddenItemIds(itemIds?: string[]): void;
+    reload(): Promise<ReviewItem[]>;
+    getItems(): ReviewItem[];
+    destroy(): void;
+}
+interface WebReviewKitTarget {
+    window: Window;
+    document: Document;
+    getViewportRect?: () => Pick<DOMRect, 'left' | 'top' | 'width' | 'height'>;
+    getOverlayRect?: () => Pick<DOMRect, 'left' | 'top' | 'width' | 'height'>;
+}
+
+export type { DfSheetAdapterOptions as D, LocalAdapterOptions as L, NumberedReviewItem as N, ReviewWorkflowStatus as R, SupabaseReviewAdapterOptions as S, ViewportSize as V, WebReviewKitAdapter as W, ReviewItemStatus as a, WebReviewKitOptions as b, WebReviewKitController as c, ReviewViewportPreset as d, ReviewItem as e, ReviewItemScope as f, DomAnchor as g, DomAnchorCandidate as h, DomAnchorStrategy as i, DomSourceHint as j, RelativeSelection as k, ReviewItemKind as l, ReviewItemQuery as m, ReviewMarker as n, ReviewMode as o, ReviewPoint as p, ReviewRulerConfig as q, ReviewSelection as r, ReviewSource as s, ReviewSubmitStatus as t, ReviewViewportScope as u, SupabaseReviewClient as v, WebReviewKitTarget as w };

package/docs/README.md

@@ -0,0 +1,37 @@
+# df-web-review-kit docs
+
+현재 문서의 읽는 순서:
+
+1. [Concept](concept.md)
+2. [Installation](installation.md)
+3. [Supabase setup](supabase.md)
+4. [Supabase review item SQL](supabase-review-items.md)
+5. [Supabase presence](supabase-presence.md)
+6. [Adapter handoff](adapter-handoff.md)
+7. [df-sheet next](df-sheet-next.md)
+8. [Review feedback 2026-06-20](review-feedback-2026-06-20.md)
+9. [Stabilize UI work guide](stabilize-ui-work-guide.md)
+10. [Smoke baseline 2026-06-20](smoke-baseline-2026-06-20.md)
+11. [Package split checkpoint](package-split-checkpoint.md)
+
+## 문서 역할
+
+- `concept.md`: 왜 이 package가 있고 어떤 문제를 해결하는지.
+- `installation.md`: host project에 설치하고 `/review` route에 붙이는 방법.
+- `supabase.md`: Supabase를 remote QA 저장소와 presence backend로 연결하는 방법.
+- `supabase-review-items.md`: 실제 table/RPC/RLS SQL.
+- `supabase-presence.md`: Supabase Realtime Presence adapter 구조.
+- `adapter-handoff.md`: package repo로 옮길 때 필요한 adapter contract 정리.
+- `df-sheet-next.md`: df-sheet를 source of record로 쓸 때 필요한 제품/API 방향.
+- `review-feedback-2026-06-20.md`: 빵빵/팡팡/오빵 package 리뷰 메모와 우선순위.
+- `stabilize-ui-work-guide.md`: anchor 안정화, UI token화, package split 전 작업 순서.
+- `smoke-baseline-2026-06-20.md`: 761 현재 기능 smoke 기준선 결과.
+- `package-split-checkpoint.md`: 765 package export/file/peer dependency와 host 소비 경계.
+- `initial-plan.md`: 초기 계획 기록. 현재 기준 문서가 아니다.
+
+## 현재 기준
+
+- `local`: 개인 draft 저장소.
+- `supabase`: 팀 공유 remote 저장소.
+- `df-sheet`: 나중에 issue workflow로 연결할 수 있는 remote destination.
+- local 번호는 개인 draft용이고, remote 번호는 remote source가 새로 발급하는 canonical 번호다.

package/docs/adapter-handoff.md

@@ -0,0 +1,146 @@
+# review-kit adapter handoff
+
+## 목적
+
+`df-web-review-kit`를 Lexus repo 안에서 검증한 뒤 별도 package repo로 옮기기 위한 handoff 문서다.
+
+현재 방향은 review shell/core와 저장소를 분리하고, project page에서는 adapter array만 선언해서 local, remote, Supabase 같은 저장소를 교체 가능하게 만드는 것이다.
+
+## 현재 상태
+
+- Mount 위치: `page/review/index.tsx`
+- Package 위치: `packages/df-web-review-kit`
+- 현재 source: `local`, `df-sheet`
+- 현재 shell-facing adapter config: array
+- core-facing internal adapter: 기존 `WebReviewKitAdapter`
+- local item id: uuid
+- local 표시 번호: 개인 draft용 `reviewNumber`
+- remote 표시 번호: remote source가 새로 배정하는 canonical `reviewNumber`
+- remote submit 성공 시 local item은 삭제하고, remote source에서 새 canonical id/number item으로 조회한다.
+
+현재 public shell adapter는 generic `update`를 노출하지 않는다.
+
+```ts
+type ReviewShellAdapter = {
+  label: ReviewSource;
+  pageId?: string;
+  get: WebReviewKitAdapter['get'];
+  list: WebReviewKitAdapter['list'];
+  create: WebReviewKitAdapter['create'];
+  statusOptions?: readonly ReviewShellStatusOption[];
+  updateStatus?: (input: ReviewShellUpdateStatusInput) => Promise<ReviewItem>;
+  syncSubmission?: (input: ReviewShellSyncSubmissionInput) => Promise<ReviewItem>;
+  remove?: WebReviewKitAdapter['remove'];
+};
+```
+
+의도:
+
+- `create`: QA 생성 또는 remote 등록
+- `list/get`: source별 QA 조회와 deep link restore
+- `statusOptions + updateStatus`: 상태 변경 UI
+- `remove`: 삭제 버튼 노출 조건
+- `syncSubmission`: remote 등록 중/실패 상태를 local item에 임시 기록하는 좁은 bookkeeping
+
+## 결정된 원칙
+
+- shell public adapter에는 generic `update`를 넣지 않는다.
+- 상태 변경은 `updateStatus`로만 다룬다.
+- `statusIndex`는 identity가 아니라 외부 시스템 매핑 보조값이다.
+- 저장 기준은 stable status value다.
+- source가 기능을 제공하지 않으면 shell은 해당 버튼/UI를 숨기거나 readonly badge로 보여준다.
+- `local`은 생성, 상태 변경, 삭제, remote submit 중/실패 상태 기록을 담당한다.
+- `df-sheet`는 현재 review-kit 안에서는 remote 등록과 읽기 중심으로 둔다.
+
+## Supabase adapter
+
+Supabase adapter를 하나 붙이면 adapter 계약 검증에 좋다. df-sheet보다 DB schema를 직접 통제할 수 있어서 `statusOptions`, `updateStatus`, `remove`의 동작 경계를 확인하기 쉽다.
+
+초기 source 이름은 `supabase`로 잡았다.
+
+```ts
+{
+  label: 'supabase',
+  get,
+  list,
+  create,
+  statusOptions,
+  updateStatus,
+  remove,
+}
+```
+
+현재 구현:
+
+- Adapter: `packages/df-web-review-kit/src/adapters/supabase.ts`
+- Lexus wiring: `page/review/index.tsx`
+- SQL/runbook: `packages/df-web-review-kit/docs/supabase-review-items.md`
+- `ReviewSource`는 string 확장 가능 타입으로 풀었다.
+- route query의 `source` 처리는 `source !== 'local'` 기준으로 일반화했다.
+- shell은 adapter array의 첫 non-local adapter를 remote source로 사용한다.
+- source별 list title, empty text도 label 기반으로 바꿨다.
+
+## Supabase schema
+
+브라우저에서 직접 붙이는 빠른 검증은 anon key + RLS 기준으로 시작한다. service role key는 브라우저에 절대 넣지 않는다.
+
+현재 schema/runbook은 `supabase-review-items.md`가 source of truth다.
+
+핵심 구조:
+
+- `review_items`: QA row. 실제 review item payload는 `item jsonb`에 저장한다.
+- `review_project_counters`: `(project_id, source)`별 다음 `review_number`를 보관한다.
+- `create_review_item`: counter row를 짧게 증가시키고 canonical `review_number`를 item에 주입해서 insert한다.
+
+주의:
+
+- 이 RLS는 dev 검증용이다.
+- production/package용으로는 Supabase Edge Function 또는 project-scoped backend proxy가 더 안전하다.
+- RLS 조건에 쓰는 컬럼에는 인덱스를 둔다.
+
+## Supabase adapter draft
+
+Adapter option:
+
+```ts
+type SupabaseReviewAdapterOptions = {
+  url: string;
+  anonKey: string;
+  table?: string;
+  projectId: string;
+  source?: string;
+  createRpc?: string;
+  unsafeClientReviewNumberFallback?: boolean;
+};
+```
+
+API mapping:
+
+- `get(id)`: `select().eq('id', id).maybeSingle()`
+- `list(query)`: `project_id`, `route_key`, optional `status` filter
+- `create(item)`: `create_review_item` RPC로 canonical id/number 발급 후 review item 반환
+- `updateStatus({ id, status })`: `status`, `updated_at`만 patch
+- `remove(id)`: row delete
+
+local `reviewNumber`는 사람별 draft 번호라 서로 겹칠 수 있다. remote submit 시 local 번호를 보존하지 않고 Supabase adapter가 새 `id`와 새 canonical `reviewNumber`를 배정한다.
+
+현재 구현은 `create_review_item` RPC가 `review_project_counters` row를 `insert ... on conflict ... do update returning`으로 증가시켜 `review_number`를 발급하고 row를 insert한다. 동시 등록 충돌과 삭제 후 번호 재사용을 피하기 위한 구조다. `unsafeClientReviewNumberFallback` option을 켜면 예전 client `max(review_number) + 1` 방식을 쓸 수 있지만 dev 임시 용도다.
+
+## 작업 순서
+
+1. `ReviewSource`/route/source select를 adapter label 기반으로 일반화한다.
+2. `supabaseAdapter` 파일을 추가한다.
+3. `page/review/index.tsx`에 Supabase adapter config를 선택적으로 추가한다.
+4. `.env` 예시를 문서화한다.
+5. local, df-sheet, supabase source 전환을 브라우저에서 확인한다.
+6. `pnpm --dir packages/df-web-review-kit typecheck`
+7. `pnpm typecheck:review`
+8. `pnpm review-kit:build`
+
+## Open questions
+
+- Supabase는 dev 검증만 할지, package 정식 adapter로 포함할지.
+- remote source에서 delete를 허용할지.
+- remote source의 `reviewNumber`를 사람이 쓰는 canonical id로 확정할지.
+- auth를 anon+RLS로 유지할지, Edge Function/proxy로 감쌀지.
+- status option을 package default로 둘지, project page config에서만 주입할지.

package/docs/concept.md

@@ -0,0 +1,102 @@
+# Concept
+
+`df-web-review-kit`는 웹 프로젝트 안에 넣는 review shell이다. QA 전용 SaaS나 Chrome extension이 아니라, 프로젝트가 가진 route, viewport, DOM, style context를 그대로 사용해 검수 이슈를 남기는 toolkit이다.
+
+## 해결하려는 문제
+
+웹 QA는 보통 다음 정보가 빠져서 다시 확인하는 시간이 길어진다.
+
+- 정확한 page route
+- viewport size
+- scroll position
+- DOM anchor
+- 깨진 영역의 좌표
+- 사람이 남긴 comment
+- 누가 같은 page를 보고 있는지
+
+review-kit은 이 정보를 review item 하나에 묶어서 저장하고, `/review?...` link로 다시 복원한다.
+
+## 기본 UX
+
+1. `/review`를 연다.
+2. sitemap에서 target page를 고른다.
+3. mobile/tablet/desktop/wide viewport를 고른다.
+4. iframe 안에서 note, DOM note, area item을 만든다.
+5. 개인이 처리할 것은 `local` draft에 둔다.
+6. 팀 공유가 필요한 것만 remote source에 등록한다.
+7. remote item link를 공유하거나 AI prompt로 복사한다.
+
+## Source 개념
+
+### local
+
+개인 draft 저장소다. `localStorage` 기반이라 빠르고, 실험/개인 처리용 QA를 remote에 섞지 않는다.
+
+local item의 `#id`는 개인 브라우저 안에서만 의미가 있다. 여러 사람이 같은 번호를 가질 수 있다.
+
+### remote
+
+팀이 같이 보는 source of record다. 현재 검증 source는 `supabase`다.
+
+local item을 remote에 등록하면 local id/number를 보존하지 않고 remote source가 새 id와 canonical `reviewNumber`를 발급한다. 등록 성공 후 local draft는 삭제한다.
+
+### df-sheet
+
+df-sheet는 issue workflow와 연결되는 remote destination 후보다. review-kit이 df-sheet issue editor가 되면 안 되고, local QA를 issue로 등록하고 restore link를 제공하는 역할이 맞다.
+
+## Item 종류
+
+- `note`: 화면 특정 지점에 남기는 comment.
+- `dom`: DOM element에 anchor를 둔 note.
+- `area`: 사용자가 드래그한 영역.
+
+표시 범위는 mobile/tablet/desktop/wide와 연결된다. DOM item은 viewport가 달라도 anchor를 찾아 복원하는 것을 목표로 한다.
+
+## Presence
+
+Presence는 저장소가 아니다. 현재 접속한 사용자의 page/source/viewport 상태만 공유한다.
+
+현재 UI는 같은 page에 들어온 사용자 id만 page header 쪽에 보여준다. sitemap 같은 상위 화면에서는 page별 접속자 표시로 확장할 수 있다.
+
+## 패키지 경계
+
+Package가 담당하는 것:
+
+- review shell UI
+- iframe target loading
+- marker 생성과 restore
+- prompt generation
+- adapter contract
+- local adapter
+- Supabase adapter
+- presence adapter contract
+
+Host project가 담당하는 것:
+
+- `/review` route 생성
+- page glob 전달
+- viewport preset 전달
+- project id와 storage key 결정
+- remote adapter env와 auth 결정
+- Supabase client 생성
+
+## 0.1 목표
+
+0.1은 완전한 review platform이 아니라, 프로젝트별로 붙여 쓸 수 있는 최소 안정 package다.
+
+포함:
+
+- local draft
+- Supabase remote CRUD
+- Supabase Presence
+- stable remote review number
+- prompt copy
+- route/viewport/scroll/marker restore
+
+보류:
+
+- screenshot upload
+- full df-sheet workflow
+- auth/member 기반 production RLS
+- sitemap presence dashboard
+- Chrome extension