handoff: harden config and align MVP surface

README.md

@@ -33,17 +33,19 @@ python_version: "3.11"
 - Можливість додавання коментарів для уточнення контексту
 - Автоматична класифікація за типом судочинства та категорією
 
-### 🔍 Пошук схожих позицій
+### 🔍 Пошук схожих позицій *(опціонально)*
 - Інтелектуальний пошук релевантних правових позицій у базі даних
 - Пошук на основі згенерованої позиції або вхідного тексту
 - Гібридний підхід: векторний пошук + BM25
 - Відображення результатів з посиланнями на джерела
+- Якщо customer build поставляється без retrieval-інфраструктури, цей модуль може бути вимкнений
 
-### ⚖️ Порівняльний аналіз
+### ⚖️ Порівняльний аналіз *(опціонально)*
 - Детальний аналіз релевантності знайдених позицій
 - Виявлення спільних правових аспектів
 - Оцінка можливості застосування існуючих позицій
 - Обґрунтовані висновки щодо необхідності створення нової позиції
+- Не є критерієм приймання MVP, якщо це не зафіксовано окремо в ТЗ
 
 ### ⚙️ Редагування промптів
 - Персональне налаштування промптів для AI
@@ -153,8 +155,10 @@ REDIS_PASSWORD=your_redis_password
 
 ### 4. Запуск додатку
 
+Локальний запуск:
+
 ```bash
-python main.py
+python app.py
 ```
 
 Додаток буде доступний за адресою: `http://localhost:7860`
@@ -320,6 +324,12 @@ redis:
 
 ## 🚀 Deployment
 
+### Deployment profiles
+
+- **Customer MVP / handoff:** Generation + model/thinking/comment controls are the primary supported flow.
+- **Optional modules:** Search and comparative analysis may be enabled only when retrieval indexes are available and accepted as in-scope.
+- **Known limitation:** if retrieval uses `DocSA/legal-position-indexes`, that corpus is an older snapshot and may be stale.
+
 ### Hugging Face Spaces
 
 1. Створіть новий Space на [Hugging Face](https://huggingface.co/spaces)
@@ -443,4 +453,4 @@ gunicorn main:app --workers 4 --bind 0.0.0.0:7860
 
 **Останнє оновлення:** 2026-01-03
 
-**Статус:** ✅ Production Ready
+**Статус:** 🟡 Handoff Candidate (generation-first MVP; optional retrieval modules require separate validation)

app.py

@@ -24,98 +24,17 @@ def _suppress_asyncio_fd_errors(unraisable):
 
 sys.unraisablehook = _suppress_asyncio_fd_errors
 
-# Set environment for Hugging Face Spaces
-os.environ['GRADIO_SERVER_NAME'] = '0.0.0.0'
-os.environ['GRADIO_SERVER_PORT'] = '7860'
-# Avoid uvloop shutdown warnings on HF Spaces
-os.environ.setdefault('UVICORN_LOOP', 'asyncio')
+def configure_runtime_environment() -> None:
+    """Apply runtime defaults for Hugging Face Spaces / Gradio deployment."""
+    os.environ.setdefault('GRADIO_SERVER_NAME', '0.0.0.0')
+    os.environ.setdefault('GRADIO_SERVER_PORT', '7860')
+    os.environ.setdefault('UVICORN_LOOP', 'asyncio')
 
-# Apply nest_asyncio only if needed (some Python versions have conflicts)
-# try:
-#     import nest_asyncio
-#     nest_asyncio.apply()
-# except Exception as e:
-#     print(f"[WARNING] Could not apply nest_asyncio: {e}")
 
 # Add project root to Python path
 project_root = Path(__file__).parent
 sys.path.insert(0, str(project_root))
-
-# ============ Network Diagnostics ============
-def run_network_diagnostics():
-    """Check outbound network connectivity from HF Spaces container."""
-    import urllib.request
-    import socket
-    
-    print("=" * 50)
-    print("🔍 NETWORK DIAGNOSTICS")
-    print("=" * 50)
-    
-    # Check proxy env vars
-    proxy_vars = ['HTTP_PROXY', 'HTTPS_PROXY', 'http_proxy', 'https_proxy', 'NO_PROXY', 'no_proxy', 'ALL_PROXY']
-    print("\n📡 Proxy environment variables:")
-    for var in proxy_vars:
-        val = os.environ.get(var)
-        if val:
-            print(f"  {var} = {val}")
-    if not any(os.environ.get(v) for v in proxy_vars):
-        print("  (none set)")
-    
-    # Check DNS resolution
-    hosts = ['api.anthropic.com', 'api.openai.com', 'generativelanguage.googleapis.com']
-    print("\n🌐 DNS resolution:")
-    for host in hosts:
-        try:
-            ip = socket.gethostbyname(host)
-            print(f"  ✅ {host} -> {ip}")
-        except socket.gaierror as e:
-            print(f"  ❌ {host} -> DNS FAILED: {e}")
-    
-    # Check actual HTTP(S) connectivity
-    print("\n🔌 HTTPS connectivity:")
-    test_urls = [
-        ('https://api.anthropic.com', 'Anthropic API'),
-        ('https://api.openai.com', 'OpenAI API'),
-        ('https://httpbin.org/get', 'httpbin (general internet)'),
-    ]
-    for url, name in test_urls:
-        try:
-            req = urllib.request.Request(url, method='HEAD')
-            req.add_header('User-Agent', 'connectivity-test/1.0')
-            resp = urllib.request.urlopen(req, timeout=10)
-            print(f"  ✅ {name} ({url}) -> HTTP {resp.status}")
-        except urllib.error.HTTPError as e:
-            # HTTP error means we CAN connect (just got an error response)
-            print(f"  ✅ {name} ({url}) -> HTTP {e.code} (connection OK, auth expected)")
-        except Exception as e:
-            print(f"  ❌ {name} ({url}) -> {type(e).__name__}: {e}")
-    
-    # Check httpx (used by anthropic/openai SDKs)
-    print("\n🔧 httpx connectivity test:")
-    try:
-        import httpx
-        print(f"  httpx version: {httpx.__version__}")
-        # Test with default settings
-        with httpx.Client(timeout=10) as client:
-            resp = client.get("https://api.anthropic.com")
-            print(f"  ✅ httpx (default) -> Anthropic HTTP {resp.status_code}")
-        # Test OpenAI with HTTP/2 disabled (avoids 421 Misdirected Request)
-        with httpx.Client(timeout=10, http2=False) as client:
-            resp = client.get("https://api.openai.com")
-            print(f"  ✅ httpx (http1.1) -> OpenAI HTTP {resp.status_code}")
-        # Also test with default HTTP/2 to compare
-        try:
-            with httpx.Client(timeout=10) as client:
-                resp = client.get("https://api.openai.com")
-                print(f"  ✅ httpx (default) -> OpenAI HTTP {resp.status_code}")
-        except Exception as e2:
-            print(f"  ⚠️ httpx (default/http2) -> OpenAI FAILED: {type(e2).__name__}: {e2}")
-    except Exception as e:
-        print(f"  ❌ httpx -> {type(e).__name__}: {e}")
-    
-    print("=" * 50)
-
-# ============ End Diagnostics ============
+configure_runtime_environment()
 
 # Import and launch interface
 from interface import create_gradio_interface
@@ -134,11 +53,8 @@ else:
 demo = create_gradio_interface()
 
 if __name__ == "__main__":
-    # Run diagnostics only when executed directly
-    run_network_diagnostics()
-    
     print("🚀 Starting Legal Position AI Analyzer...")
-    
+
     # Detect if running on HF Spaces or locally
     is_hf_space = os.environ.get('SPACE_ID') is not None
     

config.py

@@ -1,8 +1,11 @@
+import logging
 import os
 from enum import Enum
 from pathlib import Path
 from dotenv import load_dotenv
 
+logger = logging.getLogger(__name__)
+
 # Load environment variables
 load_dotenv()
 
@@ -13,19 +16,6 @@ OPENAI_API_KEY = os.getenv("OPENAI_API_KEY")
 ANTHROPIC_API_KEY = os.getenv("ANTHROPIC_API_KEY")
 DEEPSEEK_API_KEY = os.getenv("DEEPSEEK_API_KEY")
 
-# Debug: Print key status (masked)
-print("="*30)
-print("🔧 CONFIGURATION DEBUG")
-print(f"OPENAI_API_KEY: {'✅ Found' if OPENAI_API_KEY else '❌ Missing'}")
-if OPENAI_API_KEY:
-    print(f"  Length: {len(OPENAI_API_KEY)}")
-    print(f"  Prefix: {OPENAI_API_KEY[:5]}...")
-
-print(f"ANTHROPIC_API_KEY: {'✅ Found' if ANTHROPIC_API_KEY else '❌ Missing'}")
-print(f"DEEPSEEK_API_KEY: {'✅ Found' if DEEPSEEK_API_KEY else '❌ Missing'}")
-print(f"GEMINI_API_KEY: {'✅ Found' if os.getenv('GEMINI_API_KEY') else '❌ Missing'}")
-print("="*30)
-
 # Конфігурація Gemini
 GEMINI_API_KEY = os.getenv("GEMINI_API_KEY")
 if GEMINI_API_KEY:

interface.py

@@ -730,8 +730,8 @@ def create_gradio_interface() -> gr.Blocks:
                         
                     with gr.TabItem("📂 Завантаження файлу", id="file_tab"):
                         file_input = gr.File(
-                            label="Перетягніть файл або натисніть для вибору",
-                            file_types=[".txt", ".docx", ".pdf"], # Added docx/pdf just for UI (backend needs support)
+                            label="Перетягніть TXT-файл або натисніть для вибору",
+                            file_types=[".txt"],
                             file_count="single"
                         )
                 
@@ -752,7 +752,7 @@ def create_gradio_interface() -> gr.Blocks:
                     )
                     
                     generate_position_button = gr.Button(
-                        "� Згенерувати правову позицію",
+                        "📝 Згенерувати правову позицію",
                         variant="primary",
                         size="lg"
                     )