using SVSim.BattleNode.Bridge;

namespace SVSim.EmulatedEntrypoint.Matching;

/// <summary>
/// Picks a bot opponent for an incoming AI rank battle. Used by
/// <c>RankBattleController.AiStart</c> to compose <c>oppo_info</c>.
/// </summary>
/// <remarks>
/// Phase 3 ships a hardcoded fixture; future improvement is to migrate the roster
/// to <c>SVSim.Bootstrap/Data/seeds/bot-roster.json</c> for editability without
/// rebuilds. See spec § Future improvements.
/// </remarks>
public interface IBotRoster
{
    /// <summary>
    /// Returns a bot profile for the calling viewer. Deterministic per
    /// <see cref="MatchContext"/> — the same context value returns the same bot.
    /// </summary>
    AIBotProfile Pick(MatchContext selfCtx);
}