Update main.py

main.py

@@ -463,6 +463,7 @@ def deep_dive():
 
 # -----------------------------------------------------------------------------
 # ODYSSEUS ENGINE V10.1: HARDENED GAME CONSOLE (SYNTAX GUARD + VICTORY HOOKS)
+# DIFFICULTY CALIBRATION UPDATE: Human-feasible challenges with generous tolerances
 # -----------------------------------------------------------------------------
 
 # Enhanced Forbidden Patterns to prevent "Unexpected Token" errors in Babel
@@ -510,6 +511,8 @@ def generate_trial():
     Odysseus v10.1: The Hardened Instrumentalist.
     Architects bespoke, interactive React games with a 3-pass syntax repair loop.
     Cost: 1 Spark.
+    
+    DIFFICULTY TUNING: Now calibrated for human-achievable gameplay with forgiving mechanics.
     """
     logger.info(">>> ODYSSEUS V10.1: FORGING HARDENED INSTRUMENT")
     uid = verify_token(request.headers.get('Authorization'))
@@ -538,37 +541,59 @@ def generate_trial():
     attempts, forged, last_raw, last_errs = 0, None, "", []
     
     base_prompt = f"""
-    You are Athena's Master Game Architect. Forge an interactive scientific 'Instrument' for {subject}.
-    Context: {ctx_text}
-
-    TASK: Write a React component named 'Instrument'. 
-    This is a GAME that requires user interaction to achieve a scientific victory.
-
-    TECHNICAL CONSTRAINTS (STRICT):
-    1. REACT ONLY: Use React hooks (useState, useEffect, useRef). No external libs. Use SVG/Canvas.
-    2. HANDSHAKE: Component receives `{{ onAction, onWin }}` as props. 
-       - Call `props.onAction()` the moment the user interacts.
-       - Call `props.onWin()` when the specific scientific goal is reached.
-    3. WIN CONDITION: You MUST define a logic state (e.g., matching a frequency) that triggers `onWin()`.
-    4. NO COMMENTS: Do not use HTML comments <!-- -->. Use {{/* */}} if needed.
-    5. CAMELCASE: Use className, onClick, onMouseDown, etc.
-    6. ENTROPY: The system must fail/decay if the user stops interacting.
-
-    JSON OUTPUT SCHEMA:
-    {{
-      "engine": "odysseus_v10.1",
-      "instrument_name": "Title",
-      "mission_brief": "Goal description.",
-      "controls_guide": "Manual: 'Drag the X to the Y', 'Tap the Z to pulse', 'Hold the X until Y'.",
-      "component_code": "const Instrument = (props) => {{ ... }}; export default Instrument;",
-      "feynman_truth": "Scientific revelation."
-    }}
-    """
+You are Athena's Master Game Architect. Forge an interactive scientific 'Instrument' for {subject}.
+Context: {ctx_text}
+
+TASK: Write a React component named 'Instrument'. 
+This is a GAME that requires user interaction to achieve a scientific victory.
+
+TECHNICAL CONSTRAINTS (STRICT):
+1. REACT ONLY: Use React hooks (useState, useEffect, useRef). No external libs. Use SVG/Canvas.
+2. HANDSHAKE: Component receives `{{ onAction, onWin }}` as props. 
+   - Call `props.onAction()` the moment the user interacts.
+   - Call `props.onWin()` when the specific scientific goal is reached.
+3. WIN CONDITION: You MUST define a logic state (e.g., matching a frequency) that triggers `onWin()`.
+4. NO COMMENTS: Do not use HTML comments <!-- -->. Use {{/* */}} if needed.
+5. CAMELCASE: Use className, onClick, onMouseDown, etc.
+6. ENTROPY: The system must fail/decay if the user stops interacting.
+
+DIFFICULTY CALIBRATION (CRITICAL - HUMAN-FEASIBLE DESIGN):
+7. GENEROUS TOLERANCES: Use ±10-20% margins for success conditions. "Close enough" = victory.
+   - Example: Target frequency 440Hz? Accept 400-480Hz range.
+   - Example: Alignment needed? Accept ±15px margin, not pixel-perfect.
+8. HUMAN TIMING: Design for 300-800ms reaction windows. No frame-perfect precision required.
+9. CLEAR FEEDBACK: Show visual progress indicators (color gradients, meters, proximity bars).
+   - Player should always know: "Am I getting closer?" and "How close am I to winning?"
+10. ACHIEVABLE IN 20-60 SECONDS: Average player with focus should win in under a minute.
+11. FORGIVING MISTAKES: Don't reset to zero on errors. Allow recovery and course correction.
+12. EXPLICIT SUCCESS METRICS: controls_guide must state exact winning thresholds.
+
+GOOD DIFFICULTY EXAMPLES:
+- "Stabilize the pendulum angle between -10° and +10° for 3 seconds"
+- "Match the wavelength within ±15nm (target: 550nm)"
+- "Keep reaction rate in green zone (60-80%) for 5 seconds"
+- "Align particles until overlap meter shows >75%"
+
+BAD DIFFICULTY EXAMPLES (AVOID):
+- "Match exactly 440.00000Hz" (too precise)
+- "Click within 50ms of the flash" (inhuman timing)
+- "Perfect circular motion required" (impossible with mouse/touch)
+
+JSON OUTPUT SCHEMA:
+{{
+  "engine": "odysseus_v10.1",
+  "instrument_name": "Title",
+  "mission_brief": "Goal with quantified success criteria.",
+  "controls_guide": "Explicit manual: 'Drag slider to keep value between X and Y', 'Maintain green zone for Z seconds to win'.",
+  "component_code": "const Instrument = (props) => {{ ... }}; export default Instrument;",
+  "feynman_truth": "Scientific revelation."
+}}
+"""
 
     try:
         while attempts < 3 and not forged:
             attempts += 1
-            current_prompt = base_prompt if attempts == 1 else f"REPAIR LOGIC ERROR: {last_errs}\nPREVIOUS CODE: {last_raw}"
+            current_prompt = base_prompt if attempts == 1 else f"REPAIR LOGIC ERROR: {last_errs}\nPREVIOUS CODE: {last_raw}\n\nREMINDER: Make the game HUMANLY ACHIEVABLE with generous tolerances (±15% margins) and clear visual feedback showing progress."
             
             res = client.models.generate_content(
                 model=ATHENA_FLASH,
@@ -617,6 +642,7 @@ def generate_trial():
         logger.error(f"v10.1 Global Failure: {e}")
         return jsonify({"error": "The laws of the universe failed to stabilize. Retry."}), 500
 
+
 # -----------------------------------------------------------------------------
 # 5. THE CHIRON MENTOR & SYSTEM UTILS
 # -----------------------------------------------------------------------------