game_learning_layers.py

class GameLearningLayers:
    """
    Separates learning signals into structured domains:
    rules, state, territory, conditions.
    """

    def split_signals(self, stats, events, rewards):

        return {
            "rules": self._rules_signal(events, rewards),
            "state": self._state_signal(stats),
            "territory": self._territory_signal(events),
            "conditions": self._condition_signal(rewards)
        }

    # -------------------------
    def _rules_signal(self, events, rewards):

        return {
            "collision_frequency": sum(1 for e in events if e.get("type") == "score"),
            "reset_count": sum(1 for e in events if e.get("type") == "reset")
        }

    # -------------------------
    def _state_signal(self, stats):

        return {
            "avg_score": stats.get("avg_score", 0),
            "dominance": stats.get("dominance", 0)
        }

    # -------------------------
    def _territory_signal(self, events):

        return {
            "movement_events": len(events)
        }

    # -------------------------
    def _condition_signal(self, rewards):

        if not rewards:
            return {"stability": 1.0}

        values = list(rewards.values())

        return {
            "spread": max(values) - min(values),
            "stability": 1.0 / (1.0 + max(values))
        }