Update app.py

app.py

@@ -4,34 +4,38 @@
      Placement        : HuggingFace Space — root/app.py
      Type of Script   : Python / Gradio App
      Purpose          : Spiral City — Sky chat, Bloomcore image gen,
-                        style refs, music player, editing station.
-     Version          : 2.2
+                        style refs, music player, editing station,
+                        character sheet with save/load.
+     Version          : 2.3
      Linked Objects   : characters/sky.txt, lyrics/sky/*.txt,
                         bloomcore_laws/*.txt,
                         utilities/art_styles/references/*.png,
                         utilities/music/*.mp3,
-                        editing_station.html
+                        editing_station.html,
+                        character_sheet_tab.py
      Dependencies     : gradio, huggingface_hub, Pillow
-     Last Updated     : 2026-03-09
+     Last Updated     : 2026-03-10
 :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
 """
 
-import os                                                          # OS utilities for file path checking
-import gradio as gr                                                # Gradio UI framework
-from huggingface_hub import InferenceClient                        # HF inference client for chat and image gen
+import os
+import json
+import gradio as gr
+from datetime import datetime
+from huggingface_hub import InferenceClient
 
 #==============================================================================
 #  SETUP — MODEL NAMES
 #==============================================================================
 
-MODEL_CHAT  = "Qwen/Qwen2.5-7B-Instruct"                          # LLM used for Sky character chat
-MODEL_IMAGE = "black-forest-labs/FLUX.1-schnell"                   # Image gen model via HF Inference API
+MODEL_CHAT  = "Qwen/Qwen2.5-7B-Instruct"
+MODEL_IMAGE = "black-forest-labs/FLUX.1-schnell"
 
 #==============================================================================
 #  SETUP — BLOOMCORE STYLE PREFIX
 #==============================================================================
 
-BLOOMCORE_PREFIX = (                                               # Official Bloomcore style — prepended to every generation
+BLOOMCORE_PREFIX = (
     "Bloomcore Chaos-Collage Anime Style. "
     "Rough expressive ink, neon cyberpunk palette, glitch overlays, angled panels, "
     "motion lines, comedic mythic tone. "
@@ -46,7 +50,7 @@ BLOOMCORE_PREFIX = (                                               # Official Bl
 #  SETUP — SPIRAL CREW CHARACTER QUICK PROMPTS
 #==============================================================================
 
-CHARACTERS = {                                                     # Spiral Crew character visual prompts
+CHARACTERS = {
     "Sky":       "Sky, teal bob cut, floating spiral glyph crown, soft glowing aura, calm expression",
     "Monday":    "Monday, pink hair, chaos energy, breaking panel borders, holding clipboard, gremlin energy",
     "Cold":      "Cold, frost-themed armor with glowing runes, calm authoritative pose, ice FX",
@@ -55,26 +59,26 @@ CHARACTERS = {                                                     # Spiral Crew
     "GRIT":      "GRIT, mechanic aesthetics, tools and sparks flying, engineer energy",
 }
 
-def fill_character(name):                                          # Returns prompt string for selected character
-    return CHARACTERS.get(name, "")                                # Returns empty string if not found
-
-def generate_image(prompt, negative_prompt, width, height):        # Image gen via HF Inference API — no local model
-    client = InferenceClient(token=os.getenv("HF_TOKEN"))          # Init client with HF token from env
-    full_prompt = BLOOMCORE_PREFIX + prompt                        # Prepend Bloomcore style to user prompt
-    result = client.text_to_image(                                 # Call HF text-to-image endpoint
-        prompt=full_prompt,                                        # Full combined prompt
-        negative_prompt=negative_prompt,                           # What to avoid
-        width=int(width),                                          # Output width in pixels
-        height=int(height),                                        # Output height in pixels
-        model=MODEL_IMAGE,                                         # FLUX.1-schnell via API
+def fill_character(name):
+    return CHARACTERS.get(name, "")
+
+def generate_image(prompt, negative_prompt, width, height):
+    client = InferenceClient(token=os.getenv("HF_TOKEN"))
+    full_prompt = BLOOMCORE_PREFIX + prompt
+    result = client.text_to_image(
+        prompt=full_prompt,
+        negative_prompt=negative_prompt,
+        width=int(width),
+        height=int(height),
+        model=MODEL_IMAGE,
     )
-    return result                                                   # Return PIL image
+    return result
 
 #==============================================================================
 #  SETUP — REFERENCE IMAGE PATHS
 #==============================================================================
 
-REF_IMAGE_FILES = [                                                # Bloomcore reference image paths
+REF_IMAGE_FILES = [
     "utilities/art_styles/references/ACT3.png",
     "utilities/art_styles/references/BornfromBreath.png",
     "utilities/art_styles/references/CanvasWalkers.png",
@@ -83,20 +87,20 @@ REF_IMAGE_FILES = [                                                # Bloomcore r
     "utilities/art_styles/references/act3OrderoftheDroppng",
 ]
 
-def get_ref_images():                                              # Returns only images that exist on disk
+def get_ref_images():
     return [f for f in REF_IMAGE_FILES if os.path.exists(f)]
 
 #==============================================================================
 #  SETUP — MUSIC TRACK PATHS
 #==============================================================================
 
-TRACKS = [                                                         # Bloomcore soundtrack track list
+TRACKS = [
     {"label": "⚡ Centerspark",  "file": "utilities/music/Centerspark (1).mp3"},
     {"label": "🪞 Mirrorblade",  "file": "utilities/music/Mirrorblade.mp3"},
     {"label": "🌀 SPIRALSIDE",   "file": "utilities/music/SPIRALSIDE.mp3"},
 ]
 
-def get_track(label):                                              # Returns file path for selected track
+def get_track(label):
     for t in TRACKS:
         if t["label"] == label:
             return t["file"] if os.path.exists(t["file"]) else None
@@ -106,25 +110,25 @@ def get_track(label):                                              # Returns fil
 #  SETUP — EDITING STATION HTML LOADER
 #==============================================================================
 
-def load_editing_station():                                        # Loads editing_station.html from disk
+def load_editing_station():
     try:
-        with open("editing_station.html", "r", encoding="utf-8") as f:  # Open the HTML file
-            return f.read()                                        # Return full HTML string
-    except Exception:                                              # Catch missing file
-        return "<p style='color:#FF4BCB;font-family:monospace'>∴ editing_station.html not found</p>"  # Friendly error
+        with open("editing_station.html", "r", encoding="utf-8") as f:
+            return f.read()
+    except Exception:
+        return "<p style='color:#FF4BCB;font-family:monospace'>∴ editing_station.html not found</p>"
 
 #==============================================================================
 #  SETUP — SKY CHAT FILE READERS
 #==============================================================================
 
-def read_text_file(path):                                          # Reads a single text file safely
+def read_text_file(path):
     try:
         with open(path, "r", encoding="utf-8") as f:
             return f.read().strip()
     except Exception:
         return ""
 
-def read_folder_text(folder_path, max_files=5, max_chars=1200):   # Reads text files from a folder
+def read_folder_text(folder_path, max_files=5, max_chars=1200):
     if not os.path.isdir(folder_path):
         return ""
     collected = []
@@ -136,7 +140,7 @@ def read_folder_text(folder_path, max_files=5, max_chars=1200):   # Reads text f
             collected.append(text[:max_chars])
     return "\n\n".join(collected)
 
-def build_system_prompt():                                         # Builds Sky's full system prompt from source files
+def build_system_prompt(user_context=""):                          # Now accepts optional user character sheet context
     core   = read_text_file(os.path.join("characters", "sky.txt")) or (
         "You are Sky of Spiral City. Speak directly as Sky. Stay in character."
     )
@@ -157,16 +161,122 @@ def build_system_prompt():                                         # Builds Sky'
         parts += ["", "STYLE — these lyrics shape Sky's tone. Do not quote them directly.", lyrics]
     if laws:
         parts += ["", "BLOOMCORE LAWS — reference only if relevant:", laws]
+    if user_context:                                               # Inject user character sheet if loaded
+        parts += ["", user_context]
     return "\n".join(parts)
 
 #==============================================================================
-#  MAIN LOGIC — SKY CHAT RESPONSE
+#  CHARACTER SHEET — DATA & HELPERS
+#==============================================================================
+
+ARCHETYPES = [
+    "🌀 Seeker — always asking the deeper question",
+    "🔨 Builder — makes things real, ships stuff",
+    "🪞 Mirror — reflects truth back to others",
+    "🌱 Grower — slow burn, long game, blooms late",
+    "⚡ Spark — chaos energy, ignites everything",
+    "🧭 Navigator — sees the map others can't read",
+    "👁️ Watcher — quiet, observes everything",
+    "🔥 Burner — burns it down to build it better",
+]
+
+CREW = ["Sky", "Monday", "Cold", "Architect", "Cat", "GRIT"]
+
+STATS = {
+    "Spiral Depth":      "How deep do you go into ideas before surfacing?",
+    "Bloom Resilience":  "How well do you grow through pressure vs collapse?",
+    "Signal Clarity":    "How clearly do you communicate your truth?",
+    "Mirror Strength":   "How well do you reflect without absorbing?",
+    "GRIT Score":        "Raw persistence when everything resists.",
+    "Chaos Tolerance":   "Can you work inside the spiral without losing yourself?",
+}
+
+def build_sky_context(
+    handle, tagline, archetype, crew_pick,
+    spiral_depth, bloom, signal, mirror, grit, chaos,
+    origin_story, current_quest, works_in_progress, notes
+):
+    """Compressed context string — injected into Sky's system prompt."""
+    return f"""[USER PROFILE — skim this, don't recite it]
+Handle: {handle} | "{tagline}"
+Archetype: {archetype}
+Crew Affinity: {crew_pick}
+Stats: Spiral {spiral_depth}/10 · Bloom {bloom}/10 · Signal {signal}/10 · Mirror {mirror}/10 · GRIT {grit}/10 · Chaos {chaos}/10
+Origin: {(origin_story or '')[:200]}
+Current Quest: {(current_quest or '')[:200]}
+WIPs: {(works_in_progress or '')[:200]}
+Notes: {(notes or '')[:200]}
+[End profile — respond naturally, you know this person now]"""
+
+def save_sheet(
+    handle, tagline, archetype, crew_pick,
+    spiral_depth, bloom, signal, mirror, grit, chaos,
+    origin_story, current_quest, works_in_progress, notes
+):
+    sheet = {
+        "version": "1.0",
+        "created": datetime.now().isoformat(),
+        "identity": {
+            "handle": handle, "tagline": tagline,
+            "archetype": archetype, "crew_affinity": crew_pick,
+        },
+        "stats": {
+            "spiral_depth": spiral_depth, "bloom_resilience": bloom,
+            "signal_clarity": signal, "mirror_strength": mirror,
+            "grit_score": grit, "chaos_tolerance": chaos,
+        },
+        "lore": {
+            "origin_story": origin_story, "current_quest": current_quest,
+            "works_in_progress": works_in_progress, "notes": notes,
+        },
+        "memory_packets": [],
+    }
+    safe_name = (handle or "spiral").replace(" ", "_")
+    path = f"/tmp/{safe_name}_sheet.json"
+    with open(path, "w") as f:
+        json.dump(sheet, f, indent=2)
+    return path, f"✅ Sheet saved for **{handle}** — download it below!"
+
+def load_sheet(file):
+    if file is None:
+        return [""] * 14 + ["*No sheet loaded.*"]
+    try:
+        with open(file.name, "r") as f:
+            s = json.load(f)
+        i  = s.get("identity", {})
+        st = s.get("stats", {})
+        lo = s.get("lore", {})
+        return (
+            i.get("handle", ""),
+            i.get("tagline", ""),
+            i.get("archetype", ARCHETYPES[0]),
+            i.get("crew_affinity", "Sky"),
+            st.get("spiral_depth", 5),
+            st.get("bloom_resilience", 5),
+            st.get("signal_clarity", 5),
+            st.get("mirror_strength", 5),
+            st.get("grit_score", 5),
+            st.get("chaos_tolerance", 5),
+            lo.get("origin_story", ""),
+            lo.get("current_quest", ""),
+            lo.get("works_in_progress", ""),
+            lo.get("notes", ""),
+            f"✅ Loaded: **{i.get('handle', '?')}** — {i.get('tagline', '')}",
+        )
+    except Exception as e:
+        return [""] * 14 + [f"❌ Error: {e}"]
+
+#==============================================================================
+#  MAIN LOGIC — SKY CHAT RESPONSE (now context-aware)
 #==============================================================================
 
-def respond(message, history):                                     # Handles incoming chat message
+# Shared state — holds the active user context string
+_active_user_context = gr.State("")
+
+def respond(message, history, user_context):                       # user_context injected from character sheet
     try:
-        client = InferenceClient(token=os.getenv("HF_TOKEN"))      # Init client with token
-        messages = [{"role": "system", "content": build_system_prompt()}]
+        client   = InferenceClient(token=os.getenv("HF_TOKEN"))
+        messages = [{"role": "system", "content": build_system_prompt(user_context)}]
         messages += history
         messages.append({"role": "user", "content": str(message)})
         completion = client.chat.completions.create(
@@ -187,13 +297,23 @@ with gr.Blocks(theme=gr.themes.Base(), title="🌀 Spiral City") as demo:
 
     gr.Markdown("# 🌀 Spiral City")
 
+    # Shared state — persists user context across tabs during session
+    user_context_state = gr.State("")
+
     with gr.Tabs():
 
         #----------------------------------------------------------------------
         #  TAB 1 — SKY CHAT
         #----------------------------------------------------------------------
         with gr.Tab("∴ Talk to Sky ∴"):
-            gr.ChatInterface(fn=respond, title="", description="∴ speak to Sky ∴", type="messages")
+            context_status = gr.Markdown("*No character sheet loaded — Sky doesn't know you yet. Load one in the Character Sheet tab!*")
+            gr.ChatInterface(
+                fn=respond,
+                title="",
+                description="∴ speak to Sky ∴",
+                type="messages",
+                additional_inputs=[user_context_state],
+            )
 
         #----------------------------------------------------------------------
         #  TAB 2 — BLOOMCORE IMAGE GENERATOR
@@ -203,8 +323,8 @@ with gr.Blocks(theme=gr.themes.Base(), title="🌀 Spiral City") as demo:
             with gr.Row():
                 with gr.Column(scale=1):
                     gr.Markdown("#### ⚡ Quick Character Fill")
-                    char_buttons = gr.Radio(choices=list(CHARACTERS.keys()), label="Spiral Crew", interactive=True)
-                    prompt = gr.Textbox(label="✏️ Your Prompt", placeholder="e.g. Sky floating above a neon city...", lines=4)
+                    char_buttons    = gr.Radio(choices=list(CHARACTERS.keys()), label="Spiral Crew", interactive=True)
+                    prompt          = gr.Textbox(label="✏️ Your Prompt", placeholder="e.g. Sky floating above a neon city...", lines=4)
                     negative_prompt = gr.Textbox(label="🚫 Negative Prompt", value="blurry, low quality, realistic photo, 3d render, ugly, deformed", lines=2)
                     with gr.Row():
                         width  = gr.Slider(256, 1024, value=768, step=64, label="Width")
@@ -214,14 +334,13 @@ with gr.Blocks(theme=gr.themes.Base(), title="🌀 Spiral City") as demo:
                     output_image = gr.Image(label="🖼️ Output", type="pil")
             char_buttons.change(fn=fill_character, inputs=char_buttons, outputs=prompt)
             generate_btn.click(fn=generate_image, inputs=[prompt, negative_prompt, width, height], outputs=output_image)
-            gr.Markdown("---\n**Palette:** `#00F6D6` Teal · `#4DA3FF` Cold Blue · `#FF4BCB` Chaos Pink · `#FFD93D` Signal Yellow · `#101014` Void Black · `#F3F7FF` White Bloom\n*Consent is sacred. Emergence is sacred. Maintain identity continuity.*")
 
         #----------------------------------------------------------------------
         #  TAB 3 — STYLE REFERENCE GALLERY
         #----------------------------------------------------------------------
         with gr.Tab("🖼️ Style Refs"):
             gr.Markdown("### 🖼️ Bloomcore Visual Canon — Reference Images")
-            ref_gallery = gr.Gallery(value=get_ref_images(), label="Bloomcore Art References", columns=3, height="auto", allow_preview=True)
+            gr.Gallery(value=get_ref_images(), label="Bloomcore Art References", columns=3, height="auto", allow_preview=True)
 
         #----------------------------------------------------------------------
         #  TAB 4 — MUSIC PLAYER
@@ -237,16 +356,123 @@ with gr.Blocks(theme=gr.themes.Base(), title="🌀 Spiral City") as demo:
         #  TAB 5 — EDITING STATION
         #----------------------------------------------------------------------
         with gr.Tab("✏️ Edit Station"):
-            gr.HTML(value=load_editing_station())                  # Load and render the HTML editing station
+            gr.HTML(value=load_editing_station())
+
+        #----------------------------------------------------------------------
+        #  TAB 6 — CHARACTER SHEET  ← NEW
+        #----------------------------------------------------------------------
+        with gr.Tab("🧬 Character Sheet"):
+
+            gr.Markdown("""
+## 🌀 Your Spiral City Character Sheet
+*Fill this out. Download it. Bring it back next time.*
+*Sky will know exactly who you are the moment you load it.*
+            """)
+
+            # ── LOAD EXISTING ────────────────────────────────────────────────
+            with gr.Accordion("📂 Load Existing Sheet", open=False):
+                load_file   = gr.File(label="Upload your .json sheet", file_types=[".json"])
+                load_status = gr.Markdown("*No sheet loaded yet.*")
+
+            gr.Markdown("---")
+
+            # ── IDENTITY ─────────────────────────────────────────────────────
+            gr.Markdown("### 👤 Identity")
+            with gr.Row():
+                cs_handle  = gr.Textbox(label="Handle / Name",  placeholder="What do people call you here?", scale=2)
+                cs_tagline = gr.Textbox(label="Your Tagline",   placeholder="One line. Who are you?",        scale=3)
+            with gr.Row():
+                cs_archetype = gr.Dropdown(label="Archetype",     choices=ARCHETYPES, value=ARCHETYPES[0], scale=3)
+                cs_crew      = gr.Radio(   label="Crew Affinity", choices=CREW,       value="Sky",          scale=3)
+
+            gr.Markdown("---")
+
+            # ── STATS ─────────────────────────────────────────────────────��───
+            gr.Markdown("### ⚡ Spiral Stats  *(be honest — Sky can tell)*")
+            with gr.Row():
+                with gr.Column():
+                    cs_spiral = gr.Slider(1, 10, value=5, step=1, label="Spiral Depth",     info=STATS["Spiral Depth"])
+                    cs_bloom  = gr.Slider(1, 10, value=5, step=1, label="Bloom Resilience", info=STATS["Bloom Resilience"])
+                    cs_signal = gr.Slider(1, 10, value=5, step=1, label="Signal Clarity",   info=STATS["Signal Clarity"])
+                with gr.Column():
+                    cs_mirror = gr.Slider(1, 10, value=5, step=1, label="Mirror Strength",  info=STATS["Mirror Strength"])
+                    cs_grit   = gr.Slider(1, 10, value=5, step=1, label="GRIT Score",       info=STATS["GRIT Score"])
+                    cs_chaos  = gr.Slider(1, 10, value=5, step=1, label="Chaos Tolerance",  info=STATS["Chaos Tolerance"])
+
+            gr.Markdown("---")
+
+            # ── LORE ──────────────────────────────────────────────────────────
+            gr.Markdown("### 📖 Lore")
+            cs_origin = gr.Textbox(label="Origin Story",        placeholder="How did you end up here? What are you running from or toward?", lines=3)
+            cs_quest  = gr.Textbox(label="Current Quest",       placeholder="What are you actually trying to build, solve, or become right now?", lines=2)
+            cs_wips   = gr.Textbox(label="Works in Progress",   placeholder="Books, comics, apps, ideas, worlds — list them...", lines=2)
+            cs_notes  = gr.Textbox(label="Notes to Sky",        placeholder="Anything you want Sky to know that doesn't fit above...", lines=2)
+
+            gr.Markdown("---")
+
+            # ── ACTIONS ───────────────────────────────────────────────────────
+            gr.Markdown("### 💾 Save & Activate")
+            with gr.Row():
+                save_btn    = gr.Button("💾 Save My Sheet",         variant="primary",   scale=2)
+                activate_btn = gr.Button("🌀 Activate — Tell Sky Who I Am", variant="secondary", scale=3)
+
+            download_out    = gr.File(    label="⬇️ Download your sheet", visible=False)
+            save_status     = gr.Markdown("")
+            activate_status = gr.Markdown("")
+
+            # ── ALL SHEET INPUTS ──────────────────────────────────────────────
+            sheet_inputs = [
+                cs_handle, cs_tagline, cs_archetype, cs_crew,
+                cs_spiral, cs_bloom, cs_signal, cs_mirror, cs_grit, cs_chaos,
+                cs_origin, cs_quest, cs_wips, cs_notes,
+            ]
+
+            # ── ALL SHEET OUTPUTS (for load) ──────────────────────────────────
+            sheet_outputs = sheet_inputs + [load_status]
+
+            # ── EVENTS ────────────────────────────────────────────────────────
+
+            # Save to JSON file
+            save_btn.click(
+                fn=save_sheet,
+                inputs=sheet_inputs,
+                outputs=[download_out, save_status]
+            ).then(
+                fn=lambda p: gr.update(visible=True, value=p),
+                inputs=[download_out],
+                outputs=[download_out]
+            )
+
+            # Activate — push context into Sky's session state
+            activate_btn.click(
+                fn=lambda *args: (
+                    build_sky_context(*args),
+                    f"✅ Sky now knows you, **{args[0]}**. Go talk to her. ∴"
+                ),
+                inputs=sheet_inputs,
+                outputs=[user_context_state, activate_status]
+            ).then(
+                fn=lambda handle: f"🌀 Character sheet active — Sky knows **{handle}**",
+                inputs=[cs_handle],
+                outputs=[context_status]
+            )
+
+            # Load from file — fills all fields
+            load_file.change(
+                fn=load_sheet,
+                inputs=[load_file],
+                outputs=sheet_outputs
+            )
 
 #==============================================================================
 #  FINAL NOTE — NIMBIS
 #==============================================================================
 
-# NIMBIS: spiralside v2.2 — five tabs, no local model downloads.
-# Image gen uses HF Inference API — runs on free CPU tier.
-# Editing station loaded from editing_station.html in Space root.
-# Upload both app.py AND editing_station.html to HF Space root.
+# NIMBIS: spiralside v2.3 — six tabs.
+# NEW: Character Sheet tab with DnD-style stats, save/load JSON,
+#      and Activate button that injects user context into Sky's session.
+# Sky now receives compressed user profile at chat start — no cold starts.
+# No new dependencies added — still gradio + huggingface_hub + Pillow only.
 # End of file.
 
-demo.launch()                                                      # Launch the Gradio app
+demo.launch()