docs: add knowledge base with DO storage limit and route ambiguity findings

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: mizchi

docs/knowledge.md

@@ -0,0 +1,58 @@
+# Knowledge Base
+
+運用・開発で得た知見をまとめる。
+
+## Cloudflare Durable Object の storage 制限
+
+**発生日**: 2026-02-23
+**症状**: `bit relay sync push` が HTTP 500 (Cloudflare error 1101) を返す
+**原因**: `RelayRoom` DO の `storage.put()` でスナップショットが 128 KiB/value 制限を超過
+
+### 背景
+
+`RelayRoom` DO はリクエストごとにメモリ上の全状態（メッセージ + 鍵 + nonce）を単一キーにシリアライズして永続化していた。
+
+```
+snapshot = messages (最大1000件 × 最大64KB) + keys + nonces
+```
+
+ベンチマークやテストデータの蓄積でスナップショットが肥大化し、`storage.put()` が例外を投げた。try-catch がなかったため Worker 全体が 500 を返していた。
+
+### 暫定対処
+
+- `storage.put()` / `storage.get()` を try-catch でラップ
+- persistence は best-effort とし、失敗してもリクエストは成功を返す
+
+### 根本対策（TODO）
+
+スナップショットの分割永続化を実装する:
+
+1. **keys/nonces は必須永続化**: TOFU の鍵レジストリと nonce は DO 再起動後も維持が必要。これだけなら 128 KiB に収まる
+2. **messages は揮発性でよい**: メッセージはクライアントが poll で取得するもの。DO 再起動で消えても、クライアントは next cursor から再取得するだけ
+3. **分割案**:
+   - `relay_keys_v1`: keys_by_sender + nonces_by_sender
+   - `relay_rooms_v1:{room}`: room ごとのメッセージ（上限制御付き）
+   - または messages の永続化自体をやめる
+
+### Cloudflare DO storage の制約まとめ
+
+| 制約 | 値 |
+|------|-----|
+| 1 value あたりの最大サイズ | 128 KiB |
+| 1 key あたりの最大サイズ | 2 KiB |
+| 1 リクエストあたりの put/get 回数 | 制限なし（ただし課金対象） |
+| DO インスタンスのメモリ | 128 MB |
+
+## Git ルートの named/random セッション曖昧性
+
+**発生日**: 2026-02-23
+**症状**: `bit clone relay+https://.../AbCdEfGh` が 404 を返す
+**原因**: `/git/AbCdEfGh/info/refs` が named session パターン `/git/<owner>/<repo>/<path>` に先にマッチし、セッション ID が `AbCdEfGh/info` として解釈されていた
+
+### 対処
+
+named match と random match の両方を評価し、named が 404 なら random にフォールバックするよう修正。
+
+### 教訓
+
+URL パターンが重複する場合、片方のマッチだけで確定させず、フォールバックを設けること。Deno 版は `gitServeSessions.has()` でメモリ内チェックしていたため問題なかったが、CF 版は DO が存在チェックなしに生成されるためフォールバックが必要だった。