v10.2: Fix art quality — lower P2 strength 0.35→0.12, P2 Monster 2.00→1.30, P1 start 0.00→0.05

handler.py

@@ -1,19 +1,18 @@
 """
-QR-Verse AI Art Generator — HuggingFace Inference Endpoint Handler v10
+QR-Verse AI Art Generator — HuggingFace Inference Endpoint Handler v10.2
 
 Two-Pass Pipeline for optimal art quality + QR scannability.
 
-Problem: Single-pass ControlNet forces a tradeoff — higher CN weight = stronger QR
-but worse art. Lower weight = better art but unscannable QR.
+v10.2 changes (art quality fix):
+  - P1: Monster 1.50→1.00, start 0.00→0.05 (match gold standard timing)
+  - P2: Monster 2.00→1.30, strength 0.35→0.12, Brightness 0.35→0.20
+  - P2 barely modifies the art (12% denoise) with gentle QR reinforcement
+  - Previous v10 P2 was DESTROYING art by overwriting 35% with Monster=2.00
 
-Solution: Decouple art generation from QR reinforcement:
-  Pass 1 (ART):  txt2img + moderate Monster + Brightness → beautiful art with QR hint
-  Pass 2 (SCAN): img2img + higher Monster, low strength → reinforce QR patterns
-
-Additional improvements over v9:
-  - Server-side QR generation with pixel-aligned modules (16px/module, no fuzzy edges)
-  - NEAREST resampling for client QR images (preserves sharp module edges)
-  - img2img Pass 2 shares all model components with Pass 1 (zero extra VRAM)
+Gold standard reference (ComfyUI sequential CN):
+  - CN weight: 1.25-1.50, start=0.05, end=0.85
+  - Single pass achieves 38% ZBar scan rate with beautiful art
+  - diffusers parallel CN requires two-pass to compensate
 
 Models:
   - Checkpoint: SG161222/Realistic_Vision_V5.1_noVAE (SD 1.5)
@@ -45,25 +44,28 @@ logger = logging.getLogger(__name__)
 # Two-pass defaults
 # ---------------------------------------------------------------------------
 
-# Pass 1 — ART FOCUS (txt2img): moderate CN for beautiful art with QR hint
-# P1 sweep results: 1.40-1.60 optimal. Lower = prettier art, higher = more scannable.
-P1_MONSTER_WEIGHT = 1.50
-P1_BRIGHTNESS_WEIGHT = 0.20
-P1_MONSTER_START = 0.00
+# Pass 1 — ART FOCUS (txt2img): lower CN for beautiful art with subtle QR hint
+# Gold standard uses 1.25-1.50 with start=0.05, end=0.85
+# Diffusers parallel CN is additive, so use lower weight than ComfyUI sequential
+P1_MONSTER_WEIGHT = 1.00
+P1_BRIGHTNESS_WEIGHT = 0.15
+P1_MONSTER_START = 0.05   # Match gold standard — skip earliest denoising for art freedom
 P1_MONSTER_END = 0.85
 
-# Pass 2 — QR REINFORCEMENT (img2img): higher CN + low strength to force QR
-P2_MONSTER_WEIGHT = 2.00
-P2_BRIGHTNESS_WEIGHT = 0.35
-P2_MONSTER_START = 0.00
-P2_MONSTER_END = 0.90
-P2_CFG = 10.0
-P2_STEPS = 25
-P2_STRENGTH = 0.35
+# Pass 2 — GENTLE QR reinforcement: barely modify art, just boost scan contrast
+# v10 had Monster=2.00 strength=0.35 which DESTROYED art quality
+# v10.2: gentle touch — 12% denoise with moderate Monster
+P2_MONSTER_WEIGHT = 1.30
+P2_BRIGHTNESS_WEIGHT = 0.20
+P2_MONSTER_START = 0.05
+P2_MONSTER_END = 0.85
+P2_CFG = 8.0
+P2_STEPS = 20
+P2_STRENGTH = 0.12
 
 # Brightness timing (both passes)
-BRIGHTNESS_START = 0.00
-BRIGHTNESS_END = 1.00
+BRIGHTNESS_START = 0.05
+BRIGHTNESS_END = 0.85
 
 # ---------------------------------------------------------------------------
 # Quality tags — NO QR tags (QR structure from ControlNet only)