Galaxy & Planets

Endpoints for Galaxy status, strength, invites, planets, and biomes.

Galaxy

GET /galaxy

Returns the Galaxy with planet summaries.

GET /galaxy/strength

Returns the 5-dimension Galaxy strength score with trend.

{
  "score": 73.4,
  "grade": "C",
  "dimensions": {
    "volume": {"score": 65.0, "weight": 0.25, "label": "Knowledge Volume"},
    "density": {"score": 80.2, "weight": 0.20, "label": "Entity Graph Density"},
    "health": {"score": 75.0, "weight": 0.20, "label": "Contradiction Health"},
    "diversity": {"score": 68.5, "weight": 0.20, "label": "Reinforcement Diversity"},
    "coverage": {"score": 82.0, "weight": 0.15, "label": "Active Coverage"}
  },
  "trend": "+2.1 vs last week"
}

GET /galaxy/status

Summary with total stardust, entities, planets, and unresolved contradictions.

GET /galaxy/sun

Returns all Sun sections as a list.

POST /galaxy/invite

Create an invite link (owner/admin only). Body: {"planet_id": "p-123", "role": "member"}. Returns a 7-day single-use token.

POST /galaxy/join

Join a Galaxy with an invite token. Body: {"invite_token": "...", "email": "...", "name": "...", "password": "..."}.

Planets

GET /planets

List all planets in the Galaxy.

GET /planets/{id}

Get a planet with its biomes.

POST /planets

Create a new planet. Body: {"name": "Research", "color": "#10B981"}.

PUT /planets/{id}

Update planet name or color.

Biomes

GET /biomes/{id}

Get a biome with stardust count and lifecycle state.

POST /planets/{planet_id}/biomes

Create a biome. Body: {"name": "Auth Refactor"}.

PUT /biomes/{id}/lifecycle

Advance lifecycle state. Body: {"state": "ACTIVE"}.