Claude Code: Add explicit version pinning and port readiness check

- Pin fastapi==0.115.6 and uvicorn[standard]==0.34.0 in requirements.txt
- Add explicit port readiness check in entrypoint.sh (waits up to 30s)
- Already had /health endpoint returning {"status": "ok"}

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

entrypoint.sh

@@ -42,8 +42,30 @@ echo "=========================================="
 # Auto-restart loop: if uvicorn crashes, wait 2s and restart
 while true; do
     echo "[$(date -u +"%Y-%m-%dT%H:%M:%SZ")] Starting uvicorn on 0.0.0.0:${PORT:-7860}..." >&2
-    uvicorn app:app --host 0.0.0.0 --port "${PORT:-7860}" 2>&1 | tee >(cat >&2)
-    EXIT_CODE=${PIPESTATUS[0]}
+    uvicorn app:app --host 0.0.0.0 --port "${PORT:-7860}" 2>&1 | tee >(cat >&2) &
+    UVICORN_PID=$!
+
+    # Wait for uvicorn to start and port to be ready
+    PORT=${PORT:-7860}
+    MAX_WAIT=30
+    WAIT_COUNT=0
+    while [ $WAIT_COUNT -lt $MAX_WAIT ]; do
+        if nc -z localhost $PORT 2>/dev/null || curl -s http://localhost:$PORT/health > /dev/null 2>&1; then
+            echo "[$(date -u +"%Y-%m-%dT%H:%M:%SZ")] ✓ Port $PORT is ready!" >&2
+            break
+        fi
+        WAIT_COUNT=$((WAIT_COUNT + 1))
+        sleep 1
+    done
+
+    if [ $WAIT_COUNT -eq $MAX_WAIT ]; then
+        echo "[$(date -u +"%Y-%m-%dT%H:%M:%SZ")] ✗ ERROR: Port $PORT did not become ready after $MAX_WAIT seconds!" >&2
+        echo "[$(date -u +"%Y-%m-%dT%H:%M:%SZ")] Startup failure detected. Check logs above for errors." >&2
+    fi
+
+    # Wait for uvicorn process
+    wait $UVICORN_PID
+    EXIT_CODE=$?
 
     echo "[$(date -u +"%Y-%m-%dT%H:%M:%SZ")] uvicorn exited with code: $EXIT_CODE"
 

requirements.txt

@@ -1,5 +1,5 @@
-fastapi>=0.104.0
-uvicorn>=0.24.0
-huggingface_hub>=0.24.5
-psutil>=5.9.0
-python-json-logger>=2.0.7
+fastapi==0.115.6
+uvicorn[standard]==0.34.0
+huggingface_hub==0.29.1
+psutil==6.1.1
+python-json-logger==3.2.1