fix: add async to handleServeRoute, restructure usage guides

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

Author: mizchi

docs/usage-guide-ja.md

@@ -1,6 +1,60 @@
 # bit-relay 利用ガイド
 
-bit-relay を使ったリポジトリ共有・issue 管理・コラボレーションのステップバイステップガイドです。Git の基本知識を前提としています。
+bit-relay を使ったリポジトリ共有・issue 管理・コラボレーションのガイドです。Git の基本知識を前提とします。
+
+## インストール
+
+```bash
+# シェルスクリプト（Mac/Linux）
+curl -fsSL https://raw.githubusercontent.com/mizchi/bit-vcs/main/install.sh | bash
+
+# MoonBit パッケージマネージャ
+moon install mizchi/bit/cmd/bit
+```
+
+```bash
+bit --version
+```
+
+## クイックスタート
+
+### リポジトリを作って issue を共有する
+
+```bash
+# リポジトリ作成
+mkdir my-project && cd my-project
+bit init
+echo "# My Project" > README.md
+bit add . && bit commit -m "initial commit"
+
+# issue トラッキングを初期化
+bit issue init
+
+# issue を作成
+bit issue create -t "ログインページでクラッシュする" -b "特殊文字入力時に発生"
+
+# relay に issue を push
+bit relay sync push relay+https://bit-relay.mizchi.workers.dev
+```
+
+### リポジトリを relay 経由で公開する
+
+```bash
+bit relay serve relay+https://bit-relay.mizchi.workers.dev
+# => Clone URL: relay+https://bit-relay.mizchi.workers.dev/AbCdEfGh
+```
+
+### 相手が clone して issue を取得する
+
+```bash
+bit clone relay+https://bit-relay.mizchi.workers.dev/AbCdEfGh
+cd AbCdEfGh
+bit issue init
+bit relay sync fetch relay+https://bit-relay.mizchi.workers.dev
+bit issue list
+```
+
+これだけで、GitHub なしにリポジトリと issue を共有できる。
 
 ## Why bit
 
@@ -26,25 +80,23 @@ bit + bit-relay は P2P のリレーサーバーとして実装されている
 
 ## 主要な概念
 
-bit は Git にプラットフォーム非依存のコラボレーション機能を追加しています。ワークフローに入る前に、通常の Git + GitHub との違いを理解しておきましょう。
-
 ### bit — Git 実装
 
-bit は MoonBit で書かれた Git 実装です。一部の未サポート機能（例: `--object-hash=sha256`）を除き、Git と互換性があります。既存の Git リポジトリをそのまま bit で扱え、その逆も可能です。
+bit は MoonBit で書かれた Git 実装。一部の未サポート機能（例: `--object-hash=sha256`）を除き、Git と互換。既存の Git リポジトリをそのまま bit で扱えるし、その逆も可能。
 
 ### hub — 分散型の Issue/PR 管理
 
-GitHub のワークフローでは issue や PR は GitHub サーバー上に存在します。bit では、**リポジトリ内部**に Git notes（`refs/notes/bit-hub`）として保存されます。これにより：
+GitHub では issue や PR は GitHub サーバー上にある。bit では **リポジトリ内部** に Git notes（`refs/notes/bit-hub`）として保存する。
 
-- issue や PR がリポジトリデータの一部となり、特定のホスティングに依存しない
+- issue/PR がリポジトリデータの一部になり、特定のホスティングに依存しない
 - 中央サーバーなしにピア間で同期できる
-- `bit issue init` で任意の git リポジトリにこのメタデータストアを初期化できる
+- `bit issue init` で任意の git リポジトリに初期化できる
 
 ### relay — 共有のためのリレーサーバー
 
-bit-relay は 2 つの問題を解決する軽量リレーサーバーです：
+bit-relay は 2 つの問題を解決する軽量リレーサーバー。
 
-1. **NAT/ファイアウォール越しのリポジトリ共有**: `bit relay serve` でローカルリポジトリを relay 経由で公開し、他者が `bit clone` できる — ポート開放不要
+1. **NAT/ファイアウォール越しのリポジトリ共有**: `bit relay serve` でローカルリポジトリを relay 経由で公開し、他者が `bit clone` できる。ポート開放不要
 2. **hub メタデータの同期**: `bit relay sync push/fetch` で issue/PR を relay 経由で配信・取得
 
 ```
@@ -55,53 +107,30 @@ bit-relay は 2 つの問題を解決する軽量リレーサーバーです：
 └──────────┘                      └───────────┘
 ```
 
-コード（blob/tree/commit）は `serve`/`clone` で転送されます。hub メタデータ（issue/PR）は `sync push`/`sync fetch` で転送されます。これらは独立した操作です。
+コード（blob/tree/commit）は `serve`/`clone` で、hub メタデータ（issue/PR）は `sync push`/`sync fetch` で転送する。これらは独立した操作。
 
-デフォルトの relay URL は本プロジェクトからデプロイされた公開インスタンス（`bit-relay.mizchi.workers.dev`）を指します。独自にデプロイすることも可能です — 詳細は [Hosting bit-relay](./host-bit-relay.md) を参照してください。
+デフォルトの relay は本プロジェクトからデプロイした公開インスタンス（`bit-relay.mizchi.workers.dev`）を使う。独自にデプロイすることもできる。詳細は [Hosting bit-relay](./host-bit-relay.md) を参照。
 
 ### sender — あなたの識別子
 
-`sender` は relay 上でのあなたの識別名です（例: `alice`）。Ed25519 署名鍵と組み合わせることで、メッセージの発行者を証明します。GitHub 検証を行うと sender 名が GitHub ユーザー名と紐付き、`alice/my-repo` のような名前付きセッションが使えるようになります。
+`sender` は relay 上での識別名（例: `alice`）。Ed25519 署名鍵と組み合わせて、メッセージの発行者を証明する。GitHub 検証を行うと sender 名が GitHub ユーザー名と紐付き、`alice/my-repo` のような名前付きセッションが使える。
 
 ### session — 一時的な relay エンドポイント
 
-`bit relay serve` を実行すると、relay に**セッション**が作成されます。セッションはランダム ID（例: `AbCdEfGh`）または名前付きパス（例: `alice/my-repo`）で識別される一時的なエンドポイントです。`serve` コマンドの実行中のみ有効です。
-
-## 前提条件
+`bit relay serve` を実行すると、relay にセッションが作られる。セッションはランダム ID（例: `AbCdEfGh`）か名前付きパス（例: `alice/my-repo`）で識別される一時的なエンドポイント。`serve` コマンドの実行中のみ有効。
 
-- **bit CLI** がインストール済み:
-  ```bash
-  # シェルスクリプトでインストール（Mac/Linux）
-  curl -fsSL https://raw.githubusercontent.com/mizchi/bit-vcs/main/install.sh | bash
-
-  # または MoonBit パッケージマネージャでインストール
-  moon install mizchi/bit/cmd/bit
-  ```
-- 稼働中の **bit-relay** サーバー URL（例: `relay+https://bit-relay.mizchi.workers.dev`）
-- （任意）署名付き publish 用の **Ed25519 署名鍵**
-
-セットアップの確認:
-
-```bash
-bit --version
-curl https://bit-relay.mizchi.workers.dev/health
-# => {"status":"ok","service":"bit-relay"}
-```
-
-## 1. 環境設定
+## 詳細設定
 
 ### 環境変数
 
-relay URL と sender ID を環境変数で設定します:
-
 ```bash
 # relay URL（serve/sync コマンドのデフォルト値）
 export BIT_RELAY_URL=relay+https://bit-relay.mizchi.workers.dev
 
-# sender ID（あなたの識別名）
+# sender ID
 export BIT_RELAY_SENDER=alice
 
-# （任意）署名鍵ファイルのパス
+# 署名鍵ファイルのパス（任意）
 export BIT_RELAY_SIGN_PRIVATE_KEY_FILE=~/.config/bit/relay-key.pem
 ```
 
@@ -116,106 +145,33 @@ openssl pkey -in ~/.config/bit/relay-key.pem -pubout -outform DER \
   | base64 | tr '+/' '-_' | tr -d '='
 ```
 
-## 2. GitHub ユーザー名検証
+### GitHub ユーザー名検証
 
-relay が署名を要求する場合、署名鍵を GitHub アカウントと紐付けることで本人確認ができます。Ed25519 鍵と GitHub SSH 鍵の照合により身元を証明します。
+署名鍵を GitHub アカウントと紐付けて本人確認できる。Ed25519 鍵と GitHub SSH 鍵を照合する仕組み。
 
 ```bash
 # 鍵を登録し GitHub SSH 鍵と照合
 #（BIT_RELAY_SENDER と BIT_RELAY_SIGN_PRIVATE_KEY_FILE の設定が必要）
 bit relay sync push relay+https://bit-relay.mizchi.workers.dev
 ```
 
-検証完了後、relay セッションでランダム ID の代わりに名前付きパス（例: `alice/my-repo`）が使えるようになります。
-
-## 3. リポジトリの初期化
+検証が通ると、ランダム ID の代わりに `alice/my-repo` のような名前付きセッションが使える。
 
-git リポジトリを作成し、hub メタデータを初期化します:
-
-```bash
-# リポジトリを新規作成
-mkdir my-project && cd my-project
-bit init
-echo "# My Project" > README.md
-bit add .
-bit commit -m "initial commit"
-
-# issue/PR トラッキングを初期化
-bit issue init
-```
-
-## 4. issue の作成
-
-issue は対処すべき問題やタスクを宣言するものです:
-
-```bash
-# issue を作成（解決策ではなく、問題を記述する）
-bit issue create --title "ログインページで特殊文字入力時にクラッシュする" \
-  --body "パスワード欄に特殊文字を入力するとクラッシュが発生する"
-
-# issue 一覧の確認
-bit issue list
-```
-
-## 5. hub データを relay に push
-
-ローカルの hub メタデータ（issue, PR, note）を relay サーバーに送信します:
-
-```bash
-bit relay sync push relay+https://bit-relay.mizchi.workers.dev
-```
-
-## 6. relay 経由でリポジトリを公開
-
-リポジトリを relay 経由でリモート clone 可能にします:
-
-```bash
-bit relay serve relay+https://bit-relay.mizchi.workers.dev
-```
-
-出力:
-
-```
-Session registered: abc123
-Clone URL: relay+https://bit-relay.mizchi.workers.dev/abc123
-```
-
-clone URL を共同作業者に共有してください。コマンドが実行中の間、セッションは有効です。
-
-### オプション
+### relay serve のオプション
 
 | オプション | 説明 |
 |-----------|------|
 | `--allow-remote-push` | リモートからの push を受け付ける（`refs/relay/incoming/` に保存） |
 | `--auto-fetch` | feature broadcast 検知時に自動 fetch |
 | `--repo <name>` | リポジトリ名を指定（名前付きセッションを有効化） |
 
-## 7. relay から clone
-
-共同作業者は公開されたリポジトリを clone できます:
+### relay URL 形式
 
-```bash
-bit clone relay+https://bit-relay.mizchi.workers.dev/abc123
-cd abc123
-```
-
-## 8. relay から hub データを取得
-
-clone 後、relay から hub メタデータ（issue, PR）を取得します:
-
-```bash
-bit relay sync fetch relay+https://bit-relay.mizchi.workers.dev
-```
-
-取得後の確認:
-
-```bash
-# issue 一覧
-bit issue list
-
-# PR 一覧
-bit pr list
-```
+| 形式 | 動作 |
+|------|------|
+| `relay+https://host` | relay API を直接使用（TLS） |
+| `relay+http://host` | relay API を直接使用（非 TLS、ローカル開発用） |
+| `https://host/repo.git` | smart-http を試行、404 時に relay fallback |
 
 ## フルワークフロー: Alice と Bob
 
@@ -259,19 +215,11 @@ bit issue list
 bit pr list
 ```
 
-## relay URL 形式
-
-| 形式 | 動作 |
-|------|------|
-| `relay+https://host` | relay API を直接使用（TLS） |
-| `relay+http://host` | relay API を直接使用（非 TLS、ローカル開発用） |
-| `https://host/repo.git` | smart-http を試行、404 時に relay fallback |
-
 ## bithub — bit の Web UI
 
-[bithub](https://github.com/bit-vcs/bithub) は bit と連携して GitHub のような UI を提供する Web サーバーです。現在開発中です。
+[bithub](https://github.com/bit-vcs/bithub) は bit と連携して GitHub のような UI を提供する Web サーバー。現在開発中。
 
-- 馴染みのある Web インターフェースでリポジトリを閲覧（`/blob/<path>`、`/issues` など）
+- Web インターフェースでリポジトリを閲覧（`/blob/<path>`、`/issues` など）
 - bit-relay 経由で同期された issue を表示
 - relay を通じて他の bithub ノードを発見（`/relay`）
 - Cloudflare Workers またはローカルサーバーとして動作
@@ -291,6 +239,6 @@ bit pr list
 
 ## トラブルシューティング
 
-- **"session not found"**: ホスト側の `bit relay serve` が停止した可能性があります。ホストに再起動を依頼してください。
-- **署名エラー**: `BIT_RELAY_SENDER` と `BIT_RELAY_SIGN_PRIVATE_KEY_FILE` が設定されているか確認するか、`RELAY_REQUIRE_SIGNATURE=false` で起動した relay を使用してください。
-- **接続拒否**: relay URL が正しいか、サーバーが起動しているか確認してください（`curl <relay-url>/health`）。
+- **"session not found"**: ホスト側の `bit relay serve` が停止している可能性がある。ホストに再起動を依頼する。
+- **署名エラー**: `BIT_RELAY_SENDER` と `BIT_RELAY_SIGN_PRIVATE_KEY_FILE` が正しく設定されているか確認する。テスト時は `RELAY_REQUIRE_SIGNATURE=false` で起動した relay を使う。
+- **接続拒否**: relay URL が正しいか、サーバーが起動しているか確認する（`curl <relay-url>/health`）。