TheTree_mock/docs/traceability/original/GUEST_AI_VERIFICATION_2026-09-29.md

最大欲求優先AIと来客観察UIの実装

2026-09-29。原本 BASELINE.txt 81〜83行（B-4.2）を現行のGuestServiceとRuntimeへ反映した。原本そのものは変更していない。

挙動の変更

従来は欲求解消・好み・品質・価格等の総合点を先に比較しており、空腹90・睡眠70でも高品質な客室を選び得た。現在は、施設が解消する四大欲求（食欲・睡眠欲・娯楽欲・性欲）の現在値を優先し、同じ欲求優先度の候補間で既存の距離・行列・価格・品質・好み等の点数を比較する。候補側が指定する緊急度で実欲求を上書きしない。

到達不能・休業・所持金不足・最低品質・クラス制約等の既存フィルターは維持する。同点時は既存の安定した施設ID順に決め、候補の投入順に左右されない。主欲求を解消する施設が利用不能、効用が退館閾値未満、予約失敗の場合は次の利用可能な候補へ進む。これは既存の代替施設・退館処理を維持する実装判断で、原本にない閾値や料金を新設していない。

新たな意思決定時に適用する。移動・待機・利用途中の目的地を強制的に変更しない。サービス属性一致の料金加算とは別の選択規則であり、未設定の加算額・不足基準を確定していない。衛生・救護の既存状態と緊急回復経路も保持する。

ゲーム内の確認方法

上部の「来客」ボタンを押すと、実在する客を選び、四欲求のバー、所持金、忍耐、現在の行動、目的地を確認できる。現在最も高い欲求を文字でも表示する。同値の欲求は併記し、全て0なら「なし」。退館者の選択は残さず、読込後は復元されたGuestServiceから表示を作り直す。

表示は現在値と選択方針の説明。過去の意思決定を記録した思考履歴ではない。B-11.2の四欲求観察部分を進めたが、同要件群全体を完了とはしない。

パネルの更新は表示中のみ0.5秒間隔。経路探索や候補採点を表示のために再実行せず、保存スキーマも追加しない。描画確認ではSimulationDigest不変を検証した。

検証

最終集計: 関連 627項目PASS・失敗0。今回は関連試験の再実行であり、前回の全83本を新たに全件実行した結果ではない。

対象	項目数	主な確認
GuestService	137	低い欲求の高品質施設より最大欲求を優先、距離・列・価格、到達・所持金、同値、閾値と予約失敗の代替、保存再生
来客UI	22	実HUDから開く、全行動状態、欲求更新、空一覧、退館、復元、観察による状態不変
Runtime客・職員統合	40	自律行動とサービス、24時間再生の完全一致
Runtime異常系	74	行動・経路・保存境界
ダッシュボード	127	HUD、操作、複数解像度のレイアウト
営業	48	料金・受付・待機等
保存ライフサイクル	96	ディスク保存、復元、破損と回復
通常開業	53	初期予算から実建設・雇用・宿泊・00:00決算・翌朝、実描画
macOS配布PCK	15	ソース非依存の18施設・建設・来客パネル
Windows配布PCK	15	同上

make check、git diff --checkも成功。Macの配布実行ファイルを起動して正常終了。Windows向け書き出しとPCK検証はMac上で行い、今回のWindows実機操作・性能測定は未実施。

来客パネルの実画面 は、テスト用の実GuestRuntimeの欲求を設定した表示確認。自然来客の営業受入は上記53項目の別シナリオで確認した。

配布版

• Mac: build/macos/TheTree-GuestAI-2026-09-29.app
• TheTree-ドット版を起動.command を上記へ更新（ローカルとDriveの既存起動リンク）。
• Windows: build/TheTree-Windows-GuestAI-2026-09-29.zip。展開したEXEとPCKを同じフォルダーに置き、EXEを起動する。
• ソース・配布物のハッシュ

残件

天候・流行、救護搬送のローカル統合、全施設・経済・進行・クラス特性、思考履歴などは残る。原本対応表 と requirements.json を参照。本変更で原本全体の完成とはしない。