fix(spaces): add FastAPI root_path for HF proxy, ensure 0.0.0.0:7860, verify v2 paths

- Make app proxy-aware via HF_SPACE_ROOT_PATH
- Provide __main__ uvicorn runner on 0.0.0.0:7860
- Clarify v2 router mount to avoid double prefixes
- Add test script for /health, /docs, and /api/v2/summarize/stream

app/main.py

@@ -1,6 +1,7 @@
 """
 Main FastAPI application for text summarizer backend.
 """
+import os
 import time
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
@@ -26,6 +27,8 @@ app = FastAPI(
     version="2.0.0",
     docs_url="/docs",
     redoc_url="/redoc",
+    # Make app aware of reverse-proxy prefix used by HF Spaces (if any)
+    root_path=os.getenv("HF_SPACE_ROOT_PATH", ""),
 )
 
 # Add CORS middleware
@@ -152,3 +155,10 @@ async def debug_config():
         "enable_v1_warmup": settings.enable_v1_warmup,
         "enable_v2_warmup": settings.enable_v2_warmup
     }
+
+
+if __name__ == "__main__":
+    # Local/dev runner. On HF Spaces, the platform will spawn uvicorn for main:app,
+    # but this keeps behavior consistent if launched manually.
+    import uvicorn
+    uvicorn.run("app.main:app", host="0.0.0.0", port=7860, reload=False)

scripts/test_endpoints.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SPACE_URL="${1:?Usage: ./scripts/test_endpoints.sh https://<space>.hf.space}"
+
+echo "==> Testing $SPACE_URL/health"
+curl -i "$SPACE_URL/health" || true
+
+echo "==> Testing $SPACE_URL/docs"
+curl -i "$SPACE_URL/docs" || true
+
+echo "==> Testing $SPACE_URL/api/v2/summarize/stream"
+curl -i -X POST "$SPACE_URL/api/v2/summarize/stream" \
+  -H "content-type: application/json" \
+  -d '{"text":"This is a test to verify the V2 endpoint responds externally.","max_tokens":50}' || true