@uzuhq/code-cli 0.5.5 → 0.5.7

package/dist/dev-server/game-room.js

@@ -14,6 +14,33 @@
 import { randomUUID } from 'crypto';
 import { compare, applyJsonMergePatch, applyJsonPatch } from './json-patch.js';
 import { SeededRandomImpl } from './random.js';
+/**
+ * roster の申告を player だけに落とす。 壊れた申告は null。
+ *
+ * 観測者は roster に載らない。 旧ホストは観測席も載せてくるので、 配役に混ざらないよう
+ * ここで落とす。
+ */
+function parseRoster(rosterParam) {
+    if (!rosterParam)
+        return null;
+    let raw;
+    try {
+        raw = JSON.parse(rosterParam);
+    }
+    catch {
+        return null;
+    }
+    if (!Array.isArray(raw))
+        return null;
+    return raw
+        .filter((p) => (p.kind ?? 'player') === 'player')
+        .map((p) => ({
+        id: p.id,
+        nickname: p.name ?? 'Guest',
+        iconUrl: p.iconUrl ?? '',
+        characterId: p.characterId,
+    }));
+}
 /**
  * serverOnly() で wrap された handler かを判定する (SDK の isServerOnlyAction と同じ brand)。
  * dev-server は SDK を import できないため実装を持つ。
@@ -36,14 +63,14 @@ export class GameRoom {
     tickPaused = false;
     playerInputs = {};
     /**
-     * roster (kind 付き)。 spectator / admin 席も含む — logic.setup にはこれを渡す。
+     * roster。 配役を受け取る player 席のみで、 観測席 (GM 席・観戦席) は載らない。
      * dev harness では manifest から組んだ roster を constructor で注入する
      * (server 権威)。 その場合、 接続クエリの roster 申告は一切採用しないので、
      * 旧世代 harness page の残タブが reconnect しても roster を汚染できない。
      * 本番 DO は backend 由来の roster を全 client が同一申告するため接続時
      * 登録で成立している — 権威が platform 側にある点は同じ。
      */
-    seats = [];
+    players = [];
     seq = 0;
     prevBroadcastState = null;
     static SNAPSHOT_INTERVAL = 20;
@@ -51,14 +78,12 @@ export class GameRoom {
     attachments = new WeakMap();
     snapshotSubscribers = new Set();
     eventSubscribers = new Set();
-    constructor(logic, seats) {
+    constructor(logic, players) {
         this.logic = logic;
         this.tickRate = logic.tickRate ?? 0;
-        if (seats && seats.length > 0) {
-            this.seats = seats;
-            console.log(`[GameRoom] 📋 Seats (server-authoritative): ${seats
-                .map((p) => `${p.id}(${p.kind ?? 'player'})`)
-                .join(', ')}`);
+        if (players && players.length > 0) {
+            this.players = players;
+            console.log(`[GameRoom] 📋 Roster (server-authoritative): ${players.map((p) => p.id).join(', ')}`);
         }
     }
     // ─── Broadcast ─────────────────────────────────────────
@@ -153,22 +178,32 @@ export class GameRoom {
         });
     }
     // ─── Game Lifecycle ────────────────────────────────────
+    /**
+     * 移行期: 手元のシナリオが `setup({ seats })` のままでも `uzu dev` を動かせるよう、
+     * 同じ配列を旧名でも渡す。 本番 (play-server) が publish 済み logic.js のために
+     * 同じことをしているのと揃えている。 `SetupArgs` に `seats` を宣言しないのは、
+     * 新規シナリオに旧名を選ばせないため。
+     */
+    setupArgs(random) {
+        return {
+            players: this.players,
+            seats: this.players,
+            ctx: { random, now: Date.now() },
+        };
+    }
     maybeStartGame() {
         if (this.gameState !== null)
             return;
-        if (this.seats.length === 0)
+        if (this.players.length === 0)
             return;
         this.seed = Date.now() & 0xffffffff;
         this.random = new SeededRandomImpl(this.seed);
-        this.gameState = this.logic.setup({
-            seats: this.seats,
-            ctx: { random: this.random, now: Date.now() },
-        });
+        this.gameState = this.logic.setup(this.setupArgs(this.random));
         this.stateInitialized = true;
         this.tickCount = 0;
         this.seq = 0;
         this.prevBroadcastState = structuredClone(this.gameState);
-        console.log(`[GameRoom] ✅ Game started with ${this.seats.filter((p) => p.kind === 'player').length} players (${this.seats.length} seats)`);
+        console.log(`[GameRoom] ✅ Game started with ${this.players.length} players`);
         this.broadcastAll({
             type: '__game_start',
             state: this.gameState,
@@ -237,30 +272,17 @@ export class GameRoom {
         }
         const nickname = url.searchParams.get('nickname') ?? 'Guest';
         const connectionId = randomUUID();
-        if (this.seats.length === 0) {
+        // roster に自席が居なくても弾かない。 観測席 (GM 席・観戦席) は roster に載らない
+        // まま接続してくる。 シナリオ側は state.players の空振りで観測者ビューを返す。
+        if (this.players.length === 0) {
             // constructor 注入 (server 権威) が無い場合のみ、 接続クエリの申告 roster に
             // fallback する (本番 DO と同じ経路)。 dev harness では常に注入済みなので
             // ここは通らない。
-            const rosterParam = url.searchParams.get('seats');
-            if (rosterParam) {
-                try {
-                    const raw = JSON.parse(rosterParam);
-                    if (Array.isArray(raw)) {
-                        this.seats = raw.map((p) => ({
-                            id: p.id,
-                            nickname: p.name ?? 'Guest',
-                            iconUrl: p.iconUrl ?? '',
-                            characterId: p.characterId,
-                            kind: p.kind,
-                        }));
-                        console.log(`[GameRoom] 📋 Seats registered: ${this.seats
-                            .map((p) => `${p.id}(${p.kind})`)
-                            .join(', ')}`);
-                    }
-                }
-                catch {
-                    /* ignore */
-                }
+            // 移行期: 旧 SDK を同梱したシナリオは `seats=` を送り続ける。
+            const declared = parseRoster(url.searchParams.get('players') ?? url.searchParams.get('seats'));
+            if (declared && declared.length > 0) {
+                this.players = declared;
+                console.log(`[GameRoom] 📋 Roster pinned: ${this.players.map((p) => p.id).join(', ')}`);
             }
         }
         console.log(`[GameRoom] 🔗 New connection: connectionId=${connectionId} playerId=${playerId} nickname=${nickname}`);
@@ -576,10 +598,7 @@ export class GameRoom {
                     this.seed = opts.seed;
                 }
                 this.random = new SeededRandomImpl(this.seed);
-                this.gameState = this.logic.setup({
-                    seats: this.seats,
-                    ctx: { random: this.random, now: Date.now() },
-                });
+                this.gameState = this.logic.setup(this.setupArgs(this.random));
                 this.tickCount = 0;
                 // reset は新規ゲーム = 実行可能状態を意味するので pause も解除する。
                 this.tickPaused = false;

package/dist/dev-server/server.js

@@ -55,7 +55,7 @@ export function startHarnessServer(opts) {
                 const key = `${revisionId}/${roomId}`;
                 let room = gameRooms.get(key);
                 if (!room) {
-                    room = new GameRoom(opts.logic, opts.meta.seats);
+                    room = new GameRoom(opts.logic, opts.meta.players);
                     gameRooms.set(key, room);
                 }
                 room.handleConnection(ws, url);

package/dist/dev.js

@@ -6,7 +6,7 @@
  *   2. child stdout/stderr を line-by-line で監視し、 `dev.readyPattern` (default vite 向け)
  *      の regex match をトリガに scenario dev server の URL を確定
  *   3. harness http+WebSocket server を立て、 iframe grid + HUD を親 frame に描画
- *   4. `?server=ws://localhost:<port>&roomId=<key>&seatId=dev_N&seats=<json>&revisionId=dev`
+ *   4. `?server=ws://localhost:<port>&roomId=<key>&seatId=dev_N&players=<json>&revisionId=dev`
  *      を子 iframe URL に組み立てて mount。 SDK は既存 online mode でそのまま接続する
  *   5. `window.__uzu_dev` は harness page が dev-server の管理 channel と WS で会話して expose
  */
@@ -77,27 +77,24 @@ export async function runDevCommand() {
     const roomKey = 'devroom';
     const harnessPort = await findFreePort();
     const lanHosts = currentLanHosts();
-    // 完全な roster をここで一度だけ組む。 grid・iframe URL・GameRoom 注入の単一の源。
-    const seats = [
-        ...Array.from({ length: playerCount }, (_, i) => ({
-            id: `dev_${i}`,
-            nickname: manifest.characters?.[i]?.name ?? `Player ${i + 1}`,
-            iconUrl: manifest.characters?.[i]?.icon ?? '',
-            characterId: manifest.characters?.[i]?.id,
-            kind: 'player',
-        })),
-        ...(manifest.spectator
-            ? [{ id: 'spec_0', nickname: '観戦', iconUrl: '', kind: 'spectator' }]
-            : []),
-        ...(manifest.admin
-            ? [{ id: 'admin_0', nickname: 'Admin', iconUrl: '', kind: 'admin' }]
-            : []),
-    ];
+    // roster をここで一度だけ組む。 grid の player セル・iframe URL・GameRoom 注入の単一の源。
+    const players = Array.from({ length: playerCount }, (_, i) => ({
+        id: `dev_${i}`,
+        nickname: manifest.characters?.[i]?.name ?? `Player ${i + 1}`,
+        iconUrl: manifest.characters?.[i]?.icon ?? '',
+        characterId: manifest.characters?.[i]?.id,
+    }));
+    // 観測席は roster に載せない。 harness が pane を出すだけで、 scenario からは
+    // state.players に居ない席として見える。
+    const admin = manifest.admin ?? false;
+    const spectator = manifest.spectator ?? false;
     const meta = {
         scenarioUrl,
         playerCount,
         orientation,
-        seats,
+        players,
+        admin,
+        spectator,
         roomKey,
         serverBaseUrl: `ws://localhost:${harnessPort}`,
         revisionId: 'dev',
@@ -117,9 +114,9 @@ export async function runDevCommand() {
     console.log(`  🎮  UZU dev harness: ${harnessUrl}`);
     console.log(`      scenario: ${scenarioUrl}`);
     console.log(`      players: ${playerCount}  orientation: ${orientation}  roomKey: ${roomKey}`);
-    const extraSeats = seats.filter((seat) => seat.kind !== 'player');
-    if (extraSeats.length > 0) {
-        console.log(`      extra seats: ${extraSeats.map((s) => `${s.kind} (${s.id})`).join(', ')}`);
+    const observerIds = [...(spectator ? ['spec_0'] : []), ...(admin ? ['admin_0'] : [])];
+    if (observerIds.length > 0) {
+        console.log(`      observer seats (roster 外): ${observerIds.join(', ')}`);
     }
     if (lanHosts.length) {
         console.log('');

package/dist/harness/client-entry.js

@@ -5,7 +5,7 @@
  * `window.__uzu_dev` に expose する。 esbuild で IIFE bundle 済み文字列として
  * dev-server が `/_uzu_harness.js` から serve する。
  */
-import { mountIframeGrid, mountSinglePlayer } from './mount.js';
+import { mountIframeGrid, mountSinglePlayer, paneCount } from './mount.js';
 import { attachAdminClient } from './admin-client.js';
 /**
  * meta の URL は CLI 視点 (localhost) で書かれている。 スマホ実機など
@@ -40,10 +40,10 @@ async function main() {
     // admin channel は grid (親frame) だけが張るので、 単体表示では dev メニューを出さない。
     const playerParam = new URLSearchParams(location.search).get('player');
     const playerIndex = playerParam == null ? null : Number(playerParam);
-    const seatCount = meta.seats.length;
+    const panes = paneCount(meta);
     if (playerIndex != null && Number.isInteger(playerIndex)) {
-        if (playerIndex < 0 || playerIndex >= seatCount) {
-            document.body.textContent = `player は 0〜${seatCount - 1} で指定してください`;
+        if (playerIndex < 0 || playerIndex >= panes) {
+            document.body.textContent = `player は 0〜${panes - 1} で指定してください`;
             return;
         }
         mountSinglePlayer({
@@ -55,7 +55,9 @@ async function main() {
             serverBaseUrl: meta.serverBaseUrl,
             revisionId: meta.revisionId,
             roomKey: meta.roomKey,
-            seats: meta.seats,
+            players: meta.players,
+            admin: meta.admin,
+            spectator: meta.spectator,
         }, playerIndex);
         return;
     }
@@ -79,7 +81,9 @@ async function main() {
         serverBaseUrl: meta.serverBaseUrl,
         revisionId: meta.revisionId,
         roomKey: meta.roomKey,
-        seats: meta.seats,
+        players: meta.players,
+        admin: meta.admin,
+        spectator: meta.spectator,
         // 実機リンク用 host は rewrite 前の meta から取る (localhost 視点の LAN/mDNS 一覧)。
         lanHosts: rawMeta.lanHosts,
         // 各 cell の UZU ボタンに配線する dev メニュー。

package/dist/harness/mount.js

@@ -2,7 +2,7 @@
  * Dev harness の iframe grid を parent frame に描画する。
  *
  * 子 iframe URL には `?server=ws://localhost:<port>&roomId=<key>&seatId=dev_N&
- * seats=<json>&revisionId=dev` を付ける。 SDK は既存 online mode で dev-server に
+ * players=<json>&revisionId=dev` を付ける。 SDK は既存 online mode で dev-server に
  * 接続する (本番 Cloudflare Worker と同じ shape)。
  */
 import qrcode from 'qrcode-generator';
@@ -161,9 +161,9 @@ export function mountSinglePlayer(opts, playerIndex) {
     splash.textContent = 'waiting firstFrameReady…';
     opts.target.appendChild(iframe);
     opts.target.appendChild(splash);
-    // 実機でも本番アプリと同じ overlay chrome を出す (ハリボテ)。 admin 席は端末を
+    // 実機でも本番アプリと同じ overlay chrome を出す (ハリボテ)。 GM 席は端末を
     // 模す必要が無いので載せない。 UZU ボタンだけは「他プレイヤー画面へ切替」に配線する。
-    if (seatAt(opts, playerIndex).kind !== 'admin') {
+    if (paneAt(opts, playerIndex).seatKind !== 'admin') {
         const chrome = createCellChrome(opts, playerIndex, true, undefined, () => {
             const uzuBtn = chrome.querySelector('button');
             if (uzuBtn)
@@ -273,39 +273,77 @@ function createLifecycleStatusRow() {
     row.appendChild(predictionWarn);
     return { el: row, dots, predictionWarn };
 }
-function seatAt(opts, index) {
-    const seat = opts.seats[index];
-    if (!seat)
-        throw new Error(`seat index out of range: ${index}`);
-    return seat;
+/**
+ * roster に載らない観測席の pane。 席の中身は固定なので manifest の宣言から起こす。
+ * grid の中だけの存在で、 GameRoom にも iframe の `?players=` にも渡らない。
+ */
+function observerPanes(opts) {
+    const pane = (id, nickname, seatKind) => ({
+        id,
+        nickname,
+        seatKind,
+        playerNo: null,
+    });
+    return [
+        ...(opts.spectator ? [pane('spec_0', '観戦', 'spectator')] : []),
+        ...(opts.admin ? [pane('admin_0', 'Admin', 'admin')] : []),
+    ];
+}
+export function paneCount(opts) {
+    return opts.players.length + observerPanes(opts).length;
 }
-function isPlayerSeat(seat) {
-    return seat.kind === 'player';
+function paneAt(opts, index) {
+    const player = opts.players[index];
+    if (player) {
+        return {
+            id: player.id,
+            nickname: player.nickname,
+            seatKind: 'player',
+            playerNo: index + 1,
+        };
+    }
+    const observer = observerPanes(opts)[index - opts.players.length];
+    if (!observer)
+        throw new Error(`pane index out of range: ${index}`);
+    return observer;
 }
-/** SDK が読む wire 形式 (nickname → name)。 */
+/**
+ * SDK が読む wire 形式 (nickname → name)。
+ *
+ * `kind` は移行期の互換措置。 旧 SDK (0.7.3 等) は `kind` の無い席を受け取ると
+ * throw する。 roster は player だけになったので値は常に 'player'。
+ */
 function toWireSeat(seat) {
     return {
         id: seat.id,
         name: seat.nickname,
         iconUrl: seat.iconUrl,
         characterId: seat.characterId,
-        kind: seat.kind,
+        kind: 'player',
     };
 }
 function buildIframeUrl(opts, playerIndex) {
     const url = new URL(opts.scenarioUrl);
-    const seat = seatAt(opts, playerIndex);
+    const pane = paneAt(opts, playerIndex);
     url.searchParams.set('server', opts.serverBaseUrl);
     url.searchParams.set('roomId', opts.roomKey);
-    url.searchParams.set('seatId', seat.id);
-    url.searchParams.set('seats', JSON.stringify(opts.seats.map(toWireSeat)));
+    url.searchParams.set('seatId', pane.id);
+    // roster は player 席だけ。 観測席の iframe も同じ roster を送る (自分は載らない)。
+    // 移行期: 手元の scenario が同梱する SDK が旧版 (0.7.3 等) だと `?seats=` が無いだけで
+    // run() の入口が throw する。 旧名も併せて載せる。
+    const roster = JSON.stringify(opts.players.map(toWireSeat));
+    url.searchParams.set('players', roster);
+    url.searchParams.set('seats', roster);
+    // 自分の席種別。 観測席で GM ビューと観戦ビューを出し分けるのに要る (state からは
+    // 導けない)。 iframe URL 限定で WebSocket には出さない。
+    url.searchParams.set('seatKind', pane.seatKind);
     url.searchParams.set('revisionId', opts.revisionId);
     // SDK は解釈しないが、 scenario 側で「parent は harness page (audio consumer 無し) か」を
     // 判定するマーカーとして残す (tenbo の __uzuAudio bridge スキップ判定など)。
     url.searchParams.set('__dev_player', String(playerIndex));
     url.searchParams.set('__dev_room', opts.roomKey);
-    if (seat.kind === 'admin') {
-        // admin 席は本番 overlay chrome を載せないため避け領域も不要。
+    if (pane.seatKind === 'admin') {
+        // GM 席は本番 overlay chrome を載せないため避け領域も不要。
         url.searchParams.set('uzuHudInsetX', '0');
         url.searchParams.set('uzuHudInsetY', '0');
         return url.toString();
@@ -403,11 +441,11 @@ function openPlayerSwitcher(opts, currentIndex, anchor) {
     heading.textContent = '画面を切り替え';
     heading.style.cssText = 'font-size:11px;color:#a0a8b8;padding:2px 8px 6px;';
     panel.appendChild(heading);
-    for (let i = 0; i < opts.seats.length; i++) {
-        const seat = seatAt(opts, i);
+    for (let i = 0; i < paneCount(opts); i++) {
+        const pane = paneAt(opts, i);
         const isCurrent = i === currentIndex;
         const row = document.createElement('button');
-        row.textContent = `${isCurrent ? '● ' : ''}${seat.nickname} (${seat.id})`;
+        row.textContent = `${isCurrent ? '● ' : ''}${pane.nickname} (${pane.id})`;
         row.style.cssText = [
             'text-align:left;border:none;border-radius:6px',
             'padding:10px 12px;font-size:14px;cursor:pointer',
@@ -467,7 +505,7 @@ onUzuClick) {
         'flex-shrink:0',
     ].join(';');
     const mobileUrl = resolveMobileUrl(opts, playerIndex);
-    const label = seatAt(opts, playerIndex).nickname;
+    const label = paneAt(opts, playerIndex).nickname;
     if (onUzuClick) {
         uzu.onclick = onUzuClick;
     }
@@ -476,7 +514,7 @@ onUzuClick) {
             stateGetter: opts.stateGetter,
             resetGame: opts.resetGame,
             playerCount: opts.playerCount,
-            adminEnabled: opts.seats.some((s) => s.kind === 'admin'),
+            adminEnabled: opts.admin,
             onOpenSingleView: () => {
                 window.open(singleViewUrl(playerIndex), '_blank', 'noopener');
             },
@@ -585,17 +623,18 @@ export function mountIframeGrid(opts) {
         iframeSplashes.clear();
         iframePredictionWarns.clear();
         notchAppliers.length = 0;
-        for (let i = 0; i < opts.seats.length; i++) {
-            const seat = seatAt(opts, i);
+        for (let i = 0; i < paneCount(opts); i++) {
+            const pane = paneAt(opts, i);
             const cell = document.createElement('div');
             const label = document.createElement('div');
-            // admin は本番に存在しない dev 専用席なので、 player 席と見分く別配色にする。
-            const labelColor = seat.kind === 'admin' ? '#ffb86c' : '#8be9fd';
+            // GM 席は本番に存在しない dev 専用席なので、 player 席と見分く別配色にする。
+            const labelColor = pane.seatKind === 'admin' ? '#ffb86c' : '#8be9fd';
             label.style.cssText = `color:${labelColor};font-size:12px;padding:2px 0;flex-shrink:0;background:#16213e;text-align:center;`;
             const nameRow = document.createElement('div');
-            nameRow.textContent = isPlayerSeat(seat)
-                ? `Player ${i + 1} (${seat.id})`
-                : `${seat.kind === 'admin' ? '⚙' : '👁'} ${seat.nickname} (${seat.id})`;
+            nameRow.textContent =
+                pane.seatKind === 'player'
+                    ? `Player ${pane.playerNo} (${pane.id})`
+                    : `${pane.seatKind === 'admin' ? '⚙' : '👁'} ${pane.nickname} (${pane.id})`;
             label.appendChild(nameRow);
             const statusRow = createLifecycleStatusRow();
             label.appendChild(statusRow.el);
@@ -624,8 +663,8 @@ export function mountIframeGrid(opts) {
             splash.textContent = 'waiting firstFrameReady…';
             screen.appendChild(iframe);
             screen.appendChild(splash);
-            // admin は端末を模す必要が無いので overlay chrome / 擬似ノッチを載せず素の画面にする。
-            if (seat.kind !== 'admin') {
+            // GM 席は端末を模す必要が無いので overlay chrome / 擬似ノッチを載せず素の画面にする。
+            if (pane.seatKind !== 'admin') {
                 screen.appendChild(createCellChrome(opts, i, false, {
                     toggle: toggleNotchSim,
                     register: (apply) => {
@@ -655,7 +694,7 @@ export function mountIframeGrid(opts) {
             });
             // 擬似ノッチ ON/OFF を screen の inset だけで切り替える (iframe は再生成しない)。
             const applyNotch = (on) => {
-                if (seat.kind === 'admin')
+                if (pane.seatKind === 'admin')
                     on = false;
                 if (on) {
                     screen.style.top = `${SIM_NOTCH.top}px`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uzuhq/code-cli",
-  "version": "0.5.5",
+  "version": "0.5.7",
   "description": "UZU ゲーム開発 CLI - ビルド・パブリッシュ・プロジェクト作成ツール",
   "type": "module",
   "bin": {