Add details field for clarifications

Author: john-b-yang

codeclash/games/game.py

@@ -38,6 +38,7 @@ def __init__(self, round_num: int, agents: list[Player]):
         # Map of player to game metric (e.g. # of wins, assets accumulated)
         self.scores: dict[str, float] = {}
         self.player_stats: dict[str, PlayerStats] = {agent.name: PlayerStats(name=agent.name) for agent in agents}
+        self.details: list[str] = []
 
     def __str__(self) -> str:
         rv = [f"In round {self.round_num}, the winner is {self.winner}.", "\nSummary of player performance:"]
@@ -46,6 +47,8 @@ def __str__(self) -> str:
                 rv.append(f"- {player}: submission compiled successfully, score={stats.score}")
             else:
                 rv.append(f"- {player}: submission failed with error: {stats.invalid_reason}")
+        if self.details:
+            rv.extend(["Details:"] + [f"- {line}" for line in self.details])
         return "\n".join(rv)
 
     def to_dict(self) -> dict[str, Any]:
@@ -54,6 +57,7 @@ def to_dict(self) -> dict[str, Any]:
         return {
             "round_num": self.round_num,
             "winner": self.winner,
+            "details": self.details,
             "scores": {name: self.scores.get(name, 0.0) for name in player_names},
             "player_stats": {name: stats.to_dict() for name, stats in self.player_stats.items()},
         }

codeclash/games/robotrumble/robotrumble.py

@@ -89,6 +89,7 @@ def get_results(self, agents: list[Player], round_num: int, stats: RoundStats):
 
         # Update stats
         stats.winner = final_winner
+        stats.details.append(f"In this round, {agents[0].name} was Blue and {agents[1].name} was Red.")
         stats.scores = dict(counts)
         for player, score in counts.items():
             if player != RESULT_TIE: