chore(koshien-web): tmp/smalruby-koshien-web をdevpodでローカル実行可能化し新旧APIを動作確認 (rbwasm)

[smalruby3-editor-bot]

概要

tmp/smalruby-koshien-web をローカル(devpod)で実行可能にし、「AIを試す」の新 API と
既存 AI の両方が動くことを実機で確認する。

制約

• wasm/ は gitignore で空（game-server.wasm / player-ai.wasm は未ビルド）。
• ビルドは rbwasm（ruby.wasm + wasi-sdk）が必要。devpod に docker は無いため、
  devpod に rbwasm ツールチェーンを直接導入してビルドする。

やること

• devpod に ruby + ruby_wasm(rbwasm) + wasi-sdk を導入。
• game-server.wasm / player-ai.wasm を README 手順に沿ってビルド
  (rbwasm build → rbwasm pack)。
• GameViewer を静的に配信して起動（dxopal server もしくは静的サーバ）。
• 動作確認（Playwright headless）:
  • 新 API: scratch-gui v2 生成コードを ?player1=data:<base64> で渡して AI が動く
    （接続→マップ取得→経路計算→移動→ターン終了）。
  • 旧 API: パラメータ無し（default_ai）/ 既存スタイル AI がそのまま動く。
  • v1 生成コード（Sprite.new(...) do … end）も動く。

受け入れ条件

• devpod で wasm をビルドできる手順が再現可能（スクリプト or 手順書）
• ローカルで GameViewer が起動する
• 新 API（生成 AI）で対戦が進む
• 旧 API（既存/デフォルト AI）が壊れていない
• 検証結果を記録（スクリーンショット等は tmp/ 配下）

関連

Epic #738 / 前提: 「AIを試す」param 化、game server API 対応（各別 Issue）

[smalruby3-editor-bot]

devpod でビルド + 新旧 API 動作確認 完了 ✅ (2026-06-29)

devpod (Debian/arm64, docker 無し) で wasm をビルドし、ホストの Chrome (SSH ポートフォワーディングで localhost:7521) で新旧 API の対戦を確認した。

ビルド方式 (重要な知見)

• ソースビルド (rbwasm build) は arm64 で詰み: devpod arm64 では wasi-sdk が 26 以降しか無く、それで ruby を wasm へソースビルドすると、ビューアの @ruby/wasm-wasi@2.7.1 ランタイム上で ruby_init 時に exit して起動しない (wasm32-unknown-wasip1 / 新 SDK 非互換)。--target wasm32-unknown-wasi でも不可。
• 解決 = 公式プレビルド ruby を pack: npm i @ruby/3.3-wasm-wasi@2.7.1 の dist/ruby+stdlib.wasm (wasm32-wasi、js/json/yaml/stdlib 入り) を base に rbwasm pack するだけ。pack は wasi-vfs のみ使い wasi-sdk/binaryen/C コンパイラ不要・高速。これは同ランタイムで正常起動する。
• 再現スクリプト: build-wasm-devpod.sh (このプレビルド方式、冪等)。成果物 wasm/player-ai.wasm / wasm/game-server.wasm。
• 配信: cd game_viewer && npx http-server . -p 7521 -c-1。-c-1 (キャッシュ無効) が重要 — 既定の max-age=3600 だと wasm 差し替え後もブラウザが旧 wasm をキャッシュし続ける (今回ハマった)。

動作確認結果

API	プレイヤー	結果
旧 (default_ai)	player02	✅ ナビゲート → GOAL (85)
新 (scratch-gui v2 生成)	player1	✅ ナビゲート → GOAL (92)

新 API は koshien.when_connect_game(name:) do … loop.with_screen_refresh do get_map_area / calc_route(result: $最短経路) / move_to($最短経路[1]) / turn_over end end を実行。毎ターン (5,1)→…→(8,9) と1マスずつ正しく移動しゴール。Game round_1 over. scores: player1=92, player02=85。

これにより #763 のゲームサーバー実装 (when_connect_game 登録 + Smalruby3.start でのインスタンス化 + instance_exec、ステージ def initialize のグローバル初期化、loop.with_screen_refresh、$最短経路[1] の0始まり読み) が実機でエンドツーエンド検証できた。

受け入れ条件

• devpod で wasm をビルドできる手順が再現可能 (build-wasm-devpod.sh)
• ローカルで GameViewer が起動する
• 新 API (生成 AI) で対戦が進む (player1 v2 → GOAL 92)
• 旧 API (既存/デフォルト AI) が壊れていない (player02 default_ai → GOAL 85)
• 検証結果を記録 (本コメント)

補足: ブラウザ確認は v2 + 旧 default_ai。v1 (Sprite.new do … end フラット) は #763 のコードトレース + headless node テストで検証済み (同一 lib 経路)。