#!/usr/bin/env bash
# Generic external-player JSON-Lines harness for Magic Civilization.
#
# Spawns Godot headless with the `player_api_main` scene and pipes
# stdin/stdout. Any client that speaks the JSON-Lines wire protocol
# documented in `src/game/engine/docs/PLAYER_API.md` can drive a game
# slot through this harness — Claude Code via the
# `tooling/claude-player-mcp/` adapter, an OpenSpiel/RL trainer via a
# Python `subprocess.Popen`, a smoke-test shell script, etc.
#
# Env vars (see PLAYER_API.md for the full schema):
#   CP_SEED, CP_PLAYERS, CP_CLAUDE_SLOT, CP_MAP_SIZE, CP_MAP_TYPE,
#   CP_OMNISCIENT, CP_TIMEOUT_SEC, CP_LOG_FILE.
#
# `CP_CLAUDE_SLOT` is the env-var name the harness has used since p2-67;
# it identifies the externally-controlled player slot — kept as-is for
# backward compatibility with existing clients. Despite the name it is
# not Claude-specific.
#
# Exit code 0 on clean shutdown (shutdown request received or stdin EOF).
# Non-zero on protocol error or harness crash.

set -uo pipefail

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
PROJECT_DIR="$(dirname "$SCRIPT_DIR")"

# Defaults — adapter overrides via env.
: "${CP_SEED:=42}"
: "${CP_PLAYERS:=2}"
: "${CP_CLAUDE_SLOT:=0}"
: "${CP_MAP_SIZE:=duel}"
: "${CP_MAP_TYPE:=continents}"
: "${CP_OMNISCIENT:=0}"
: "${CP_TIMEOUT_SEC:=60}"
: "${CP_LOG_FILE:=}"

# Pure-headless mode — no Wayland needed. JSON-Lines speaks to stdout.
#
# Linux uses flatpak Godot (matches the rest of the apricot pipeline).
# macOS uses the locally-installed `godot` binary (Homebrew); a parallel
# flatpak runtime just for this harness is silly when native Godot 4
# works directly. Env-var passthrough is automatic for the native path.
export CP_SEED CP_PLAYERS CP_CLAUDE_SLOT CP_MAP_SIZE CP_MAP_TYPE \
    CP_OMNISCIENT CP_TIMEOUT_SEC CP_LOG_FILE

case "$(uname -s)" in
    Darwin)
        GODOT_BIN="${GODOT_BIN:-godot}"
        if ! command -v "$GODOT_BIN" >/dev/null 2>&1; then
            echo "ERROR: no godot binary on PATH (set GODOT_BIN or 'brew install godot')." >&2
            exit 1
        fi
        exec "$GODOT_BIN" \
            --path "$PROJECT_DIR/src/game" \
            --headless \
            --rendering-method gl_compatibility \
            res://engine/scenes/headless/player_api_main.tscn
        ;;
    *)
        exec flatpak run --user \
            --env=CP_SEED="$CP_SEED" \
            --env=CP_PLAYERS="$CP_PLAYERS" \
            --env=CP_CLAUDE_SLOT="$CP_CLAUDE_SLOT" \
            --env=CP_MAP_SIZE="$CP_MAP_SIZE" \
            --env=CP_MAP_TYPE="$CP_MAP_TYPE" \
            --env=CP_OMNISCIENT="$CP_OMNISCIENT" \
            --env=CP_TIMEOUT_SEC="$CP_TIMEOUT_SEC" \
            --env=CP_LOG_FILE="$CP_LOG_FILE" \
            org.godotengine.Godot \
            --path "$PROJECT_DIR/src/game" \
            --headless \
            --rendering-method gl_compatibility \
            res://engine/scenes/headless/player_api_main.tscn
        ;;
esac