トラブルシューティング（開発）

pnpm dev で Core が起動しない

• Wrangler のログを確認。ポート競合や .dev.vars の不足がないか確認。

OpenAPI が空/古い

• Core をローカル起動し、http://localhost:8787/doc にアクセスできるか確認。
• cd asteroid-docs && pnpm prepare で generated/openapi.json を再取得。

Airport の API 呼び出しで 4xx/5xx

• .env の VITE_API_BASE_URL が正しいか確認。
• CORS/認可の設定を確認。リクエスト/レスポンスをネットワークタブで確認。

Biome の整形が意図せず差分を増やす

• 小さな PR を心がけ、整形差分とロジック変更を分ける。