Claude Code: Improve Cain startup diagnostics and error handling

- Add detailed logging for openclaw and brain imports at startup
- Add startup_checks to status file to track import status
- Improve entrypoint.sh to ensure /data directory is writable
- Add error field to status file to capture actual errors

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

app.py

@@ -414,6 +414,11 @@ try:
         "stage": "RUNNING_A2A_READY",
         "last_updated": datetime.utcnow().isoformat() + "+00:00",
         "agent": "cain",
+        "error": None,
+        "startup_checks": {
+            "openclaw_imported": False,
+            "brain_imported": False
+        },
         "a2a": {
             "endpoint": "/a2a/jsonrpc",
             "enabled": True,
@@ -421,6 +426,15 @@ try:
         }
     }
 
+    # Check if openclaw and brain can be imported
+    try:
+        import openclaw
+        status_data["startup_checks"]["openclaw_imported"] = True
+        from agents import brain_minimal
+        status_data["startup_checks"]["brain_imported"] = True
+    except Exception as e:
+        status_data["error"] = f"{type(e).__name__}: {e}"
+
     # Write to primary location (OPENCLAW_DATA_DIR)
     status_path = os.environ.get('CAIN_STATUS_PATH', '/data/cain_status.json')
     Path(status_path).parent.mkdir(parents=True, exist_ok=True)
@@ -460,10 +474,17 @@ except Exception as e:
 try:
     import openclaw
     print(f">>> CAIN: openclaw imported from {openclaw.__file__}", flush=True)
+    print(f">>> CAIN: sys.path includes: {sys.path[:3]}", flush=True)
     from agents import brain_minimal
     print(">>> CAIN: brain_minimal module available", flush=True)
+    print(f">>> CAIN: brain_minimal has get_brain: {hasattr(brain_minimal, 'get_brain')}", flush=True)
+except ImportError as e:
+    print(f">>> CAIN ERROR: ImportError at startup: {e}", flush=True)
+    print(f">>> CAIN ERROR: sys.path = {sys.path}", flush=True)
 except Exception as e:
-    print(f">>> CAIN WARNING: Could not import brain modules at startup: {e}", flush=True)
+    print(f">>> CAIN WARNING: Could not import brain modules at startup: {type(e).__name__}: {e}", flush=True)
+    import traceback
+    traceback.print_exc()
 
 # ============================================================================
 # STARTUP DIAGNOSTIC ENDPOINT

entrypoint.sh

@@ -6,6 +6,10 @@ set -e
 mkdir -p /app/frontend
 mkdir -p /data/frontend
 
+# Ensure /data is writable and exists
+mkdir -p /data
+chmod 777 /data 2>/dev/null || true
+
 echo "=========================================="
 echo "Cain Starting..."
 echo "=========================================="
@@ -13,6 +17,7 @@ echo "Timestamp: $(date -u +"%Y-%m-%dT%H:%M:%SZ")"
 echo "PORT: ${PORT:-7860}"
 echo "Working Directory: $(pwd)"
 echo "Python Version: $(python --version)"
+echo "Data directory: $(ls -la /data 2>&1 | head -5)"
 echo "=========================================="
 
 # Change to app directory