More work on states, added bot

src/game_server/InternalGameServer.h

@@ -2,11 +2,15 @@
 
 #include "IGameServer.h"
 
+class AudioPlayerAsync;
+
 namespace FRG {
 
 class Game;
 class Character;
 class Location;
+struct LocationConfig;
+struct LocationSetup;
 
 // In-process implementation used by single-player.  GameState exists exactly
 // once, here; clients see immutable snapshots and mutate it with typed commands.
@@ -15,7 +19,9 @@ public:
 	InternalGameServer();
 
 	std::shared_ptr<const GameSnapshot> snapshot() const override;
+	const std::string& localPlayerId() const override { return localPlayerId_; }
 	void submit(const GameCommand& command) override;
+	std::vector<GameServerEvent> drainEvents() override;
 	void update(std::int64_t deltaMs) override;
 	void save(nlohmann::json& out) const override;
 	void load(const nlohmann::json& in) override;
@@ -23,25 +29,38 @@ public:
 private:
 	friend class Game;
 
-	// Transitional host operations are intentionally available only to Game,
-	// which owns location loading and old-save migration. They are never part of
-	// IGameServer and therefore cannot leak mutable state to UI/network clients.
-	GameState& hostState() { return state_; }
-	const GameState& hostState() const { return state_; }
-	std::unordered_map<std::string, std::shared_ptr<Location>>& runtimeLocations() { return runtimeLocations_; }
-	const std::unordered_map<std::string, std::shared_ptr<Location>>& runtimeLocations() const { return runtimeLocations_; }
+	// Host-only lifecycle operations. They never expose authoritative state and
+	// are intentionally absent from IGameServer.
+	void initializeCampaign(
+		const std::string& campaignId, const std::string& questsPath,
+		const std::string& zipFile);
+	void clearCampaign();
+	void resetCampaign(const std::string& questsPath, const std::string& zipFile);
+	bool prepareLocation(const LocationConfig& config);
+	void setupRuntimeLocation(
+		const std::string& id, const std::shared_ptr<Location>& location,
+		LocationSetup params, AudioPlayerAsync* audioPlayer);
+	Location* runtimeLocation(const std::string& id) const;
+	bool hasRuntimeLocation(const std::string& id) const;
+	std::vector<std::string> loadedRuntimeLocationIds() const;
+	void clearRuntimeLocations(bool retainState);
 	void bindRuntimeLocation(const std::string& id, std::shared_ptr<Location> location);
 	void synchronizeRuntimeAuxiliaryState();
 	void applyStateToRuntime();
-	void markHostMutation();
+	void publishMutation();
+	void ensureBattleZoneTestBot();
+	void updateBattleZoneTestBot(std::int64_t deltaMs);
 
 	GameSnapshot buildSnapshot() const;
 
 	GameState state_;
+	std::string localPlayerId_ = "player";
+	std::int64_t battleZoneTestBotElapsedMs_ = 0;
 	std::unordered_map<std::string, std::shared_ptr<Location>> runtimeLocations_;
 	std::uint64_t revision_ = 1;
 	mutable std::uint64_t cachedRevision_ = 0;
 	mutable std::shared_ptr<const GameSnapshot> cachedSnapshot_;
+	std::vector<GameServerEvent> pendingEvents_;
 };
 
 } // namespace FRG