handoff: align help and trim debug leakage

HELP.md

@@ -98,6 +98,10 @@
 - Потужні моделі: 15-30 секунд
 - З режимом Thinking: 30-60 секунд
 
+### Для customer MVP
+- Основний підтримуваний сценарій поставки: **Генерація** + налаштування `provider/model/thinking/comment`.
+- Якщо retrieval-контур не входить у ТЗ або не підготовлені актуальні індекси, вкладки **Пошук** і **Аналіз** можуть бути вимкнені без втрати основної цінності MVP.
+
 ---
 
 ## Закладка: Пошук

docs/deployment/hf/HF_DEPLOYMENT_SUMMARY.md

@@ -4,6 +4,8 @@ NOTE: This HF deployment summary is a convenience document for operators. Canoni
 
 # 🎉 Підсумок: Готовність до розгортання на Hugging Face Spaces
 
+> Примітка для handoff: canonical instructions and current MVP scope live in `docs/deployment/hf/DEPLOYMENT_HF.md`, `docs/README.md`, `README.md`, and `docs/SCOPE_AND_DATA_FRESHNESS.md`. This file is only a summary note.
+
 ## ✅ Створені файли
 
 ### 1. Основні файли розгортання:

docs/deployment/hf/README_HF.md

@@ -21,8 +21,8 @@ Legal Position AI Analyzer — це інструмент для автомати
 ### Основні можливості:
 
 - 🤖 **Генерація правових позицій** з судових рішень
-- 🔍 **Пошук релевантних прецедентів** в базі даних
-- ⚖️ **Аналіз схожості** з існуючими правовими позиціями
+- 🔍 **Пошук релевантних прецедентів** в базі даних *(опціонально)*
+- ⚖️ **Аналіз схожості** з існуючими правовими позиціями *(опціонально)*
 - 📊 **Пакетне тестування** для обробки множини справ
 - 🎯 **Підтримка декількох AI моделей**:
   - Anthropic Claude (Opus 4.5, Sonnet 4.5, Haiku 4.5)
@@ -39,15 +39,17 @@ Legal Position AI Analyzer — це інструмент для автомати
 3. Додайте коментар (опціонально)
 4. Натисніть "Генерувати позицію"
 
-### 2. Пошук прецедентів
+### 2. Пошук прецедентів *(опціонально)*
 
 - Автоматичний пошук після генерації позиції
 - Або ручний пошук за текстом/URL
+- Для customer MVP може бути вимкнений, якщо retrieval не входить у погоджений scope
 
-### 3. Аналіз релевантності
+### 3. Аналіз релевантності *(опціонально)*
 
 - Порівняння з існуючими правовими позиціями
 - Оцінка застосовності до нової справи
+- Не є обов’язковим критерієм приймання MVP без окремого узгодження
 
 ## ⚙️ Конфігурація
 

main.py

@@ -796,26 +796,13 @@ def generate_legal_position(
             raise Exception(f"Текст судового рішення занадто короткий або відсутній (довжина: {len(court_decision_text) if court_decision_text else 0} символів). Будь ласка, перевірте вхідні дані.")
 
         if provider == ModelProvider.OPENAI.value:
-            # Diagnostic: test raw httpx connection before using OpenAI SDK
             http_client = None
             response_text = None
             try:
                 print(f"[DEBUG] OpenAI pre-flight check...")
                 print(f"[DEBUG] openai SDK version: {openai.__version__}")
                 print(f"[DEBUG] httpx version: {httpx.__version__}")
-                print(f"[DEBUG] OPENAI_API_KEY length: {len(OPENAI_API_KEY) if OPENAI_API_KEY else 0}")
-                
-                # Quick raw httpx connectivity test to api.openai.com
-                try:
-                    with httpx.Client(timeout=10.0, http2=False) as test_client:
-                        test_resp = test_client.get("https://api.openai.com/v1/models",
-                                                     headers={"Authorization": f"Bearer {OPENAI_API_KEY[:20]}...truncated"})
-                        print(f"[DEBUG] Raw httpx test -> HTTP {test_resp.status_code}")
-                except Exception as pre_err:
-                    import traceback
-                    print(f"[WARNING] Raw httpx pre-flight failed: {type(pre_err).__name__}: {pre_err}")
-                    print(f"[WARNING] Pre-flight traceback: {traceback.format_exc()}")
-                
+
                 http_client = httpx.Client(
                     timeout=httpx.Timeout(120.0, connect=30.0),
                     http2=False,
@@ -1024,7 +1011,7 @@ def generate_legal_position(
             # Debug: check what we're sending to Anthropic
             print(f"[DEBUG] Sending to Anthropic - content length: {len(content)}")
             print(f"[DEBUG] Content preview: {content[:500]}")
-            print(f"[DEBUG] ANTHROPIC_API_KEY set: {bool(ANTHROPIC_API_KEY)}, length: {len(ANTHROPIC_API_KEY) if ANTHROPIC_API_KEY else 0}")
+            print(f"[DEBUG] Anthropic API key configured: {bool(ANTHROPIC_API_KEY)}")
 
             messages = [{
                 "role": "user",