engine/genesis.py

"""GODSEED genesis state — epoch 0, exactly as specified in ARCHITECTURE.md.

A barren obsidian world, one monolith, an orbiting invitation. These values
are a cross-component contract (the web renderer mock carries the same list);
do NOT edit them.
"""

from __future__ import annotations

import copy

GENESIS_FEATURES = [
    {"id": "f_000000", "wish_id": "genesis", "tool": "set_sky",
     "args": {"palette": "void", "star_density": 0.9, "moons": 1}, "seed": 7, "t": 0},
    {"id": "f_000001", "wish_id": "genesis", "tool": "raise_terrain",
     "args": {"lat": 12, "lon": 40, "radius_deg": 28, "height": 0.05, "roughness": 0.7},
     "seed": 11, "t": 0},
    {"id": "f_000002", "wish_id": "genesis", "tool": "place_structure",
     "args": {"lat": 14, "lon": 38, "kind": "monolith", "scale": 1.4, "hue": 270},
     "seed": 13, "t": 0},
    {"id": "f_000003", "wish_id": "genesis", "tool": "inscribe_wish",
     "args": {"text": "speak, and it will be made", "style": "orbit"}, "seed": 17, "t": 0},
]


def genesis_features() -> list[dict]:
    """Deep copy of the genesis feature list (safe to mutate / load)."""
    return copy.deepcopy(GENESIS_FEATURES)


def genesis_world():
    """A fresh World seeded with the genesis features."""
    from .world import World

    return World.load(genesis_features())