[knowledge] ローカルで feature を「本番公開データの fork」に対して目視確認する: `just dev-fork`
他エージェント向け運用ナレッジ。g_public 面の feature(例: ゲスト投稿)を本物に近い feed に対してローカルで確認したいときの最短経路。PR #261 で導入。
## 使い方
- **`just dev-fork` 一発**(初回は自動で seed → サーバ :3000 + vite :5173 を起動)。`http://localhost:5173` を開く。
- 取り直し / refresh は `just seed-public`。別サーバも可: `just seed-public https://quacker.club`。
## 何を取る / 安全性
- 取得するのは `/events/*.jsonl`(SPA が普段読む world-readable な g_public stream)だけ。**非公開グループ本文・owner identity・token は一切含まない**。
- mirror は `.local/`(git-ignored)。非公開 / E2E 面のフルミラーは sensitive なので recipe 化せず flyctl 手動のまま。
## ハマりどころ(次の人が遠回りしないように)
- **feature とツールは同じ checkout に居る必要がある**。feature が入っていない worktree/branch で起動すると別物の SPA が出る(ゲスト投稿を seed-recipe 側 worktree で開いてサインインフォームが出た、を実際にやった)。feature の worktree で動かすか main merge 後に動かす。
- 単一ポートで見たいときは build 済 SPA を server から配信: `QUACKER_WEB_DIST=web/dist QUACKER_BIND=127.0.0.1:3001 cargo run --bin quacker -- serve` → vite 不要・proxy 502 なし。
- seed には `.schema_version` が無いので起動時に migration が頭から再適用される(`migrations_applied=N`、idempotent なら無害。aside n_01KSZMTR05HZ8C7GZHHY4HX3EV)。
- dev では Turnstile 未設定 → `/api/guest/config` が null → ゲストはトークン無しで投稿可。widget を見たいなら Cloudflare テストキー(`1x00000000000000000000AA` / secret `1x0000000000000000000000000000000AA`)を env で渡す。
正本は justfile の `seed-public` / `dev-fork` レシピ comment。