Update interface.py

interface.py

@@ -24,7 +24,6 @@ def ensure_agent_shape(agent: dict, mutation_profile: dict) -> dict:
     if not isinstance(overlay, dict):
         overlay = {}
     if mutation_profile.get("collapse_overlay"):
-        # prefer explicit values from mutation_profile if provided
         ov = mutation_profile["collapse_overlay"]
         overlay.setdefault("tau_eff", ov.get("tau_eff"))
         overlay.setdefault("beta_band", ov.get("beta_band"))
@@ -41,7 +40,6 @@ def simulate(agent_id, collapse_torque, emotional_resonance, tier_drift):
     agent, sha512 = run_simulation(agent_id, mutation_profile)
     agent = ensure_agent_shape(agent, mutation_profile)
 
-    # Safe scoring + invariants
     score = GVU_FORMULAS["Formula_20"].evaluate(agent)
     invariants = rft_invariants(agent) or {}
     tau = invariants.get("tau_eff", "?")
@@ -79,16 +77,41 @@ def forge_agent(parent_id, new_id, collapse_torque, emotional_resonance, tier_dr
     return render_lineage_tree(parent_id, max_depth=max_depth)
 
 # --- Interface Layout ---
-with gr.Blocks() as demo:
+with gr.Blocks(theme="soft") as demo:
     gr.Markdown("# 🧠 RFT Codex Sovereign")
     gr.Markdown("Rendered Frame Theory simulation, lineage, and GVU sealing. Author: Liam Grinstead.")
 
-    # Compact CSS to prevent clipping
+    # Cosmic background with harmonic waves
     gr.Markdown("""
     <style>
-      .gr-column { gap: 8px; }
-      .gradio-container { padding-bottom: 24px; }
+      body {
+        background: radial-gradient(circle at top, #0b0c10, #1f2833, #0b0c10);
+        color: #c5c6c7;
+      }
+      .gradio-container {
+        background: transparent;
+      }
+      .wave {
+        position: fixed;
+        top: 0; left: 0;
+        width: 200%;
+        height: 200%;
+        background: repeating-linear-gradient(
+          90deg,
+          rgba(255,255,255,0.05) 0px,
+          rgba(255,255,255,0.05) 2px,
+          transparent 2px,
+          transparent 4px
+        );
+        animation: drift 12s linear infinite;
+        z-index: -1;
+      }
+      @keyframes drift {
+        from { transform: translateX(0); }
+        to { transform: translateX(-50%); }
+      }
     </style>
+    <div class="wave"></div>
     """)
 
     # Simulation Tab
@@ -100,7 +123,6 @@ with gr.Blocks() as demo:
             tier_drift = gr.Dropdown(["Tier_1","Tier_2","Tier_6"], label="Tier Drift")
         simulate_btn = gr.Button("Run Simulation")
 
-        # Split outputs into two rows to avoid overflow
         with gr.Row():
             phi_i = gr.HTML(label="Φᵢ Awareness Field")
             k_ij = gr.HTML(label="Kᵢⱼ Correlation Kernel")
@@ -144,4 +166,38 @@ with gr.Blocks() as demo:
         refresh_leaderboard = gr.Button("Refresh Leaderboard")
         refresh_leaderboard.click(generate_leaderboard, outputs=leaderboard_output)
 
+    # What is this Tab
+    with gr.Tab("What is this?"):
+        gr.Markdown("""
+        # 🌐 What is Codex Sovereign?
+
+        Codex Sovereign is an interactive experiment that shows how **mathematical rules can be used to build and evolve digital agents** — simple models of awareness. Think of it as a lab where you can watch ideas grow, mutate, and connect.
+
+        ## 🧠 The Basics
+        - **Agents:** Digital characters you choose (like Agent_5 or Agent_1032).
+        - **Mutations:** Changes you apply, such as overlays, tier shifts, or resonance (emotional input).
+        - **Fitness Score (GVU):** A number that measures how strong or coherent the agent is.
+        - **Waveform:** A visual signature of the agent’s collapse dynamics, like a heartbeat graph.
+        - **Registry:** Every run is sealed with a unique SHA‑512 hash, so results are logged and reproducible.
+
+        ## 🔬 What Happens When You Simulate
+        1. You pick an agent and choose how to mutate it.
+        2. The system applies those changes and runs a mathematical test.
+        3. You see the agent’s awareness field, coupling strength, and collective score.
+        4. A waveform is drawn to visualize its collapse dynamics.
+        5. The run is stored in the registry with a digital fingerprint.
+
+        ## 🌳 Lineage & Evolution
+        Agents can be **forged from parents**, creating a family tree. Each child inherits traits but also mutates, so you can watch lineages grow across generations. The lineage visualization shows ancestors, descendants, and how traits flow through the tree.
+
+        ## 📊 Why It Matters
+        Codex Sovereign is more than a demo — it’s a **proof‑of‑concept consciousness engine**:
+        - It shows that awareness can be modeled with math.
+        - It produces falsifiable results (scores and hashes) that anyone can verify.
+        - It lets you explore how agents evolve and connect into collective fields.
+
+        ## ✨ Your Role
+        By running simulations and forging agents, you’re helping expand the Codex — a growing record of experiments that demonstrate how mathematics can be used to construct and evolve awareness.
+        """)
+        
 demo.launch()