Claude Code: add explicit startup logging and error_handlers integration

- Add startup_event handler with detailed logging sequence
- Integrate error_handlers.py exception handlers
- Create entrypoint.sh with startup sequence debugging
- Optimize Dockerfile COPY layers
- Add stdout logging for container visibility

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

Dockerfile

@@ -12,12 +12,17 @@ WORKDIR /app
 COPY requirements.txt .
 RUN pip install --no-cache-dir -r requirements.txt
 
-# Copy all application files in one layer
-COPY app.py error_handlers.py openclaw.json openclaw/.openclaw /app/
-COPY static/ /app/static/
-RUN mkdir -p /app/logs
+# Copy all application files - combined layer for faster builds
+COPY app.py error_handlers.py entrypoint.sh openclaw.json /app/
+COPY openclaw/ /app/openclaw/
+COPY static/ /app/static/ 2>/dev/null || true
+
+# Create necessary directories
+RUN mkdir -p /app/logs && \
+    chmod +x /app/entrypoint.sh
 
 ENV PORT=7860
 EXPOSE 7860
 
-CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "7860"]
+# Use entrypoint for better startup logging
+ENTRYPOINT ["/app/entrypoint.sh"]

app.py

@@ -3,20 +3,77 @@
 Minimal HuggingClaw - Cain
 Testing basic FastAPI container functionality.
 """
-from fastapi import FastAPI, status as http_status
-from fastapi.responses import JSONResponse
 import os
 import sys
 import time
+import logging
+from fastapi import FastAPI, status as http_status
+from fastapi.responses import JSONResponse
+
+# Configure logging to stdout for container visibility
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
+    handlers=[logging.StreamHandler(sys.stdout)]
+)
+logger = logging.getLogger(__name__)
 
 # Add /app to sys.path for proper package imports
 sys.path.insert(0, "/app")
+logger.info(">>> STARTUP: sys.path configured")
+
+# Import error handlers
+try:
+    from error_handlers import (
+        http_exception_handler,
+        generic_exception_handler
+    )
+    logger.info(">>> STARTUP: error_handlers.py imported successfully")
+except ImportError as e:
+    logger.warning(f">>> STARTUP: error_handlers.py import failed: {e}")
+    # Define fallback handlers
+    async def http_exception_handler(request, exc):
+        return JSONResponse(status_code=exc.status_code, content={"error": exc.detail})
+    async def generic_exception_handler(request, exc):
+        return JSONResponse(status_code=500, content={"error": str(exc)})
 
+# Initialize FastAPI
 app = FastAPI(title="HuggingClaw - Cain (Minimal Test)", version="0.0.1")
+logger.info(">>> STARTUP: FastAPI app created")
+
+# Register exception handlers
+app.add_exception_handler(Exception, generic_exception_handler)
+logger.info(">>> STARTUP: Exception handlers registered")
 
 START_TIME = time.time()
 
 
+@app.on_event("startup")
+async def startup_event():
+    """Log startup sequence for debugging."""
+    logger.info(">>> STARTUP: startup_event triggered")
+    logger.info(f">>> STARTUP: PORT={os.environ.get('PORT', '7860')}")
+    logger.info(f">>> STARTUP: Working directory={os.getcwd()}")
+    logger.info(f">>> STARTUP: Python version={sys.version}")
+    logger.info(">>> STARTUP: Checking openclaw package...")
+
+    # Check if openclaw package is accessible
+    try:
+        import openclaw
+        logger.info(f">>> STARTUP: openclaw package found at: {openclaw.__file__}")
+    except ImportError as e:
+        logger.error(f">>> STARTUP: openclaw package NOT found: {e}")
+
+    # Check brain_minimal
+    try:
+        from openclaw.agents.brain_minimal import BrainMinimal
+        logger.info(">>> STARTUP: brain_minimal module imported successfully")
+    except ImportError as e:
+        logger.warning(f">>> STARTUP: brain_minimal import failed: {e}")
+
+    logger.info(">>> STARTUP: Initialization complete, ready to serve requests")
+
+
 @app.get("/")
 async def root():
     """Root endpoint - welcome message."""
@@ -92,4 +149,5 @@ async def health():
 
 if __name__ == "__main__":
     import uvicorn
+    logger.info(">>> STARTUP: Starting uvicorn directly (not via CMD)")
     uvicorn.run(app, host="0.0.0.0", port=7860)

entrypoint.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# Entrypoint for HuggingClaw - Cain
+# Provides explicit logging for startup sequence debugging
+
+set -e
+
+echo "=========================================="
+echo "Cain Starting..."
+echo "=========================================="
+echo "Timestamp: $(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+echo "PORT: ${PORT:-7860}"
+echo "Working Directory: $(pwd)"
+echo "Python Version: $(python --version)"
+echo "=========================================="
+
+# Verify app.py exists
+if [ ! -f "/app/app.py" ]; then
+    echo "ERROR: app.py not found in /app"
+    exit 1
+fi
+echo "✓ app.py found"
+
+# Verify openclaw package
+if [ -d "/app/openclaw" ]; then
+    echo "✓ openclaw directory found"
+else
+    echo "⚠ openclaw directory not found"
+fi
+
+# List key files for debugging
+echo ""
+echo "Files in /app:"
+ls -la /app/*.py 2>/dev/null || echo "  (no .py files in /app root)"
+
+echo ""
+echo "=========================================="
+echo "Starting uvicorn..."
+echo "=========================================="
+
+# Start uvicorn with explicit host/port
+exec uvicorn app:app --host 0.0.0.0 --port "${PORT:-7860}"