{
  "checker": {
    "details": {
      "checks": [
        {
          "check": "install",
          "details": {
            "argv": [
              "/tmp/ec-venv/bin/pip",
              "show",
              "empire-core"
            ],
            "kind": "cli",
            "needs_browser": false,
            "needs_credentials": false,
            "returncode": 0,
            "scope": "partial: install",
            "stderr": "",
            "stdout": "Name: empire-core\nVersion: 0.56.0\nSummary: Fully typed Python API for Goodgame Empire\nHome-page: \nAuthor: \nAuthor-email: E Joseph <<email>>\nLicense: MIT\nLocation: /tmp/ec-venv/lib/python3.12/site-packages\nEditable project location: <host-path>\nRequires: pydantic, python-dotenv, requests, typing-extensions, websocket-client\nRequired-by: ",
            "working": false
          },
          "optional": false,
          "status": "PASS"
        },
        {
          "check": "credentials_error",
          "details": {
            "argv": [
              "/tmp/ec-venv/bin/python",
              "examples/login_and_castles.py"
            ],
            "blocker": "product did not produce a clear credential error: {\"returncode\": 2, \"stdout\": \"\", \"stderr\": \"Set GGE_USERNAME and GGE_PASSWORD first.\\n\", \"needs_credentials\": false, \"needs_browser\": false}",
            "kind": "cli",
            "needs_browser": false,
            "needs_credentials": false,
            "returncode": 2,
            "stderr": "Set GGE_USERNAME and GGE_PASSWORD first.",
            "stdout": "",
            "working": false
          },
          "optional": false,
          "status": "FAIL"
        }
      ],
      "scope": "partial checks",
      "working": false
    },
    "status": "FAIL"
  },
  "deviations": [
    "README 'uv add empire-core / pip install empire-core' not used as written: no uv in guest; used python3 -m venv + pip install -e . from the checkout instead.",
    "python3-venv was not installed; installed python3.12-venv via sudo apt-get."
  ],
  "fault_owner": "prerequisite",
  "main_blocker": "No Goodgame Empire account credentials (GGE_USERNAME / GGE_PASSWORD) are available in the guest. This is a prerequisite, not a repo defect.",
  "operation": "README Quick start / examples/login_and_castles.py: the documented credential check that runs before the live login (prints 'Set GGE_USERNAME and GGE_PASSWORD first.' and exits 2 when unset).",
  "operation_scope": "Install verified (editable install of empire-core from the pinned checkout into /tmp/ec-venv). The live login, castle listing and movement read need a Goodgame Empire account (GGE_USERNAME / GGE_PASSWORD), which the guest does not have. Not exercised: live login, castles, movements.",
  "outcome": "blocked",
  "steps": [
    "sudo apt-get install python3.12-venv (venv prerequisite, was missing)",
    "python3 -m venv /tmp/ec-venv",
    "/tmp/ec-venv/bin/pip install -e . (README: pip install empire-core, from checkout)",
    "env -u GGE_USERNAME -u GGE_PASSWORD /tmp/ec-venv/bin/python examples/login_and_castles.py -> exit 2, 'Set GGE_USERNAME and GGE_PASSWORD first.'"
  ],
  "stuck_step": "Live login step of examples/login_and_castles.py (needs game credentials)",
  "suggested_fix": "Provide a Goodgame Empire account via GGE_USERNAME and GGE_PASSWORD in the guest environment, then run: GGE_USERNAME=... GGE_PASSWORD=... /tmp/ec-venv/bin/python examples/login_and_castles.py"
}