django-cfg 1.5.8__py3-none-any.whl → 1.5.20__py3-none-any.whl

django_cfg/apps/integrations/grpc/management/commands/rungrpc.py

@@ -1,21 +1,53 @@
 """
-Django management command to run gRPC server.
+Django management command to run async gRPC server with auto-reload support.
 
 Usage:
+    # Development mode (with auto-reload)
     python manage.py rungrpc
+
+    # Production mode (no auto-reload)
+    python manage.py rungrpc --noreload
+
+    # Custom host and port
     python manage.py rungrpc --host 0.0.0.0 --port 50051
-    python manage.py rungrpc --workers 20
+
+    # With Centrifugo test event on startup
+    python manage.py rungrpc --test
+
+    # Disable specific features
+    python manage.py rungrpc --no-reflection --no-health-check
+
+Auto-reload behavior:
+    - Enabled by default in development mode (ENV_MODE != "production")
+    - Disabled by default in production mode (ENV_MODE == "production")
+    - Use --noreload to explicitly disable auto-reload
+    - Server will restart automatically when Python files change
+
+Test mode:
+    - Use --test to send a test Centrifugo event on server startup
+    - Useful for verifying Centrifugo integration is working
+    - Event published to: grpc#rungrpc#startup#test
 """
 
 from __future__ import annotations
 
+import asyncio
 import logging
 import signal
 import sys
-from concurrent import futures
+import threading
 
 from django.conf import settings
 from django.core.management.base import BaseCommand
+from django.utils import autoreload
+
+from django_cfg.core.config import get_current_config
+from django_cfg.modules.django_logging import get_logger
+from django_cfg.apps.integrations.grpc.utils.streaming_logger import (
+    setup_streaming_logger,
+    log_server_start,
+    log_server_shutdown,
+)
 
 # Check dependencies before importing grpc
 from django_cfg.apps.integrations.grpc._cfg import check_grpc_dependencies
@@ -28,24 +60,46 @@ except Exception as e:
 
 # Now safe to import grpc
 import grpc
-
-logger = logging.getLogger(__name__)
+import grpc.aio
 
 
 class Command(BaseCommand):
     """
-    Run gRPC server with auto-discovered services.
+    Run async gRPC server with auto-discovered services and hot-reload.
 
     Features:
+    - Async server with grpc.aio
     - Auto-discovers and registers services
-    - Configurable host, port, and workers
+    - Hot-reload in development mode (watches for file changes)
+    - Configurable host, port
     - Health check support
     - Reflection support
     - Graceful shutdown
     - Signal handling
+
+    Hot-reload:
+    - Automatically enabled in development mode (ENV_MODE != "production")
+    - Automatically disabled in production mode (ENV_MODE == "production")
+    - Use --noreload to explicitly disable in development
+    - Works like Django's runserver - restarts on code changes
     """
 
-    help = "Run gRPC server"
+    # Web execution metadata
+    web_executable = False
+    requires_input = False
+    is_destructive = False
+
+    help = "Run async gRPC server with optional hot-reload support"
+
+    def __init__(self, *args, **kwargs):
+        """Initialize with self.logger and async server reference."""
+        super().__init__(*args, **kwargs)
+        self.logger = get_logger('rungrpc')
+        self.streaming_logger = None  # Will be initialized when server starts
+        self.server = None
+        self.shutdown_event = None
+        self.server_status = None
+        self.server_config = None  # Store config for re-registration
 
     def add_arguments(self, parser):
         """Add command arguments."""
@@ -61,12 +115,6 @@ class Command(BaseCommand):
             default=None,
             help="Server port (default: from settings or 50051)",
         )
-        parser.add_argument(
-            "--workers",
-            type=int,
-            default=None,
-            help="Max worker threads (default: from settings or 10)",
-        )
         parser.add_argument(
             "--no-reflection",
             action="store_true",
@@ -77,53 +125,190 @@ class Command(BaseCommand):
             action="store_true",
             help="Disable health check service",
         )
+        parser.add_argument(
+            "--asyncio-debug",
+            action="store_true",
+            help="Enable asyncio debug mode",
+        )
+        parser.add_argument(
+            "--noreload",
+            action="store_false",
+            dest="use_reloader",
+            help="Disable auto-reloader (default: enabled in dev mode)",
+        )
+        parser.add_argument(
+            "--test",
+            action="store_true",
+            help="Send test Centrifugo event on startup (for testing integration)",
+        )
 
     def handle(self, *args, **options):
-        """Run gRPC server."""
-        # Import models here to avoid AppRegistryNotReady
-        from django_cfg.apps.integrations.grpc.models import GRPCServerStatus
+        """Run async gRPC server with optional auto-reload."""
+        config = get_current_config()
+
+        # Determine if we should use auto-reload
+        # Changed default to False for stability with bidirectional streaming
+        use_reloader = options.get("use_reloader", False)
+
+        # Check if we're in production mode (disable reloader in production)
+        if config and hasattr(config, 'is_production'):
+            is_production = config.is_production  # property, not method
+        else:
+            # Fallback to settings
+            env_mode = getattr(settings, "ENV_MODE", "development").lower()
+            is_production = env_mode == "production"
+
+        # Disable reloader in production by default
+        if is_production and options.get("use_reloader") is None:
+            use_reloader = False
+            self.stdout.write(
+                self.style.WARNING(
+                    "Production mode - auto-reloader disabled"
+                )
+            )
 
-        # Get configuration
-        grpc_server_config = getattr(settings, "GRPC_SERVER", {})
+        # Enable asyncio debug if requested
+        if options.get("asyncio_debug"):
+            asyncio.get_event_loop().set_debug(True)
+            self.logger.info("Asyncio debug mode enabled")
+
+        # Run with or without reloader
+        if use_reloader:
+            from datetime import datetime
+            current_time = datetime.now().strftime('%H:%M:%S')
+
+            self.stdout.write(
+                self.style.SUCCESS(
+                    f"🔄 Auto-reloader enabled - watching for file changes [{current_time}]"
+                )
+            )
+            self.stdout.write(
+                self.style.WARNING(
+                    "⚠️  Note: Active streaming connections will be dropped on reload. Use --noreload for stable bots."
+                )
+            )
+
+            # Setup autoreload to watch project directory
+            from django.utils.autoreload import autoreload_started
+
+            def watch_project_files(sender, **kwargs):
+                """Automatically watch Django project directory for changes."""
+                base_dir = getattr(settings, 'BASE_DIR', None)
+                if base_dir:
+                    sender.watch_dir(str(base_dir), '*.py')
+                    self.logger.debug(f"Watching project directory: {base_dir}")
 
-        # Get server parameters
-        host = options["host"] or grpc_server_config.get("host", "[::]")
-        port = options["port"] or grpc_server_config.get("port", 50051)
-        max_workers = options["workers"] or grpc_server_config.get("max_workers", 10)
+            autoreload_started.connect(watch_project_files)
+
+            # Use autoreload to restart on code changes
+            autoreload.run_with_reloader(
+                lambda: asyncio.run(self._async_main(*args, **options))
+            )
+        else:
+            # Run directly without reloader
+            asyncio.run(self._async_main(*args, **options))
+
+    async def _async_main(self, *args, **options):
+        """Main async server loop."""
+        # Setup streaming logger for detailed gRPC logging
+        self.streaming_logger = setup_streaming_logger(
+            name='grpc_rungrpc',
+            level=logging.DEBUG,
+            console_level=logging.INFO
+        )
 
-        # Server options
-        enable_reflection = not options["no_reflection"] and grpc_server_config.get(
-            "enable_reflection", False
+        config = get_current_config()
+        use_reloader = options.get("use_reloader", True)
+
+        # Determine production mode
+        if config and hasattr(config, 'is_production'):
+            is_production = config.is_production  # property, not method
+        else:
+            env_mode = getattr(settings, "ENV_MODE", "development").lower()
+            is_production = env_mode == "production"
+
+        # Log startup using reusable function
+        start_time = log_server_start(
+            self.streaming_logger,
+            server_type="gRPC Server",
+            mode="Production" if is_production else "Development",
+            hotreload_enabled=use_reloader
         )
-        enable_health_check = not options["no_health_check"] and grpc_server_config.get(
-            "enable_health_check", True
+
+        # Import models here to avoid AppRegistryNotReady
+        from django_cfg.apps.integrations.grpc.models import GRPCServerStatus
+        from django_cfg.apps.integrations.grpc.services.config_helper import (
+            get_grpc_server_config,
         )
 
+        # Get configuration
+        grpc_server_config_obj = get_grpc_server_config()
+
+        # Fallback to settings if not configured via django-cfg
+        if not grpc_server_config_obj:
+            grpc_server_config = getattr(settings, "GRPC_SERVER", {})
+            host = options["host"] or grpc_server_config.get("host", "[::]")
+            port = options["port"] or grpc_server_config.get("port", 50051)
+            max_concurrent_streams = grpc_server_config.get("max_concurrent_streams", None)
+            enable_reflection = not options["no_reflection"] and grpc_server_config.get(
+                "enable_reflection", False
+            )
+            enable_health_check = not options["no_health_check"] and grpc_server_config.get(
+                "enable_health_check", True
+            )
+        else:
+            # Use django-cfg config
+            host = options["host"] or grpc_server_config_obj.host
+            port = options["port"] or grpc_server_config_obj.port
+            max_concurrent_streams = grpc_server_config_obj.max_concurrent_streams
+            enable_reflection = (
+                not options["no_reflection"] and grpc_server_config_obj.enable_reflection
+            )
+            enable_health_check = (
+                not options["no_health_check"]
+                and grpc_server_config_obj.enable_health_check
+            )
+            grpc_server_config = {
+                "host": grpc_server_config_obj.host,
+                "port": grpc_server_config_obj.port,
+                "max_concurrent_streams": grpc_server_config_obj.max_concurrent_streams,
+                "enable_reflection": grpc_server_config_obj.enable_reflection,
+                "enable_health_check": grpc_server_config_obj.enable_health_check,
+                "compression": grpc_server_config_obj.compression,
+                "max_send_message_length": grpc_server_config_obj.max_send_message_length,
+                "max_receive_message_length": grpc_server_config_obj.max_receive_message_length,
+                "keepalive_time_ms": grpc_server_config_obj.keepalive_time_ms,
+                "keepalive_timeout_ms": grpc_server_config_obj.keepalive_timeout_ms,
+            }
+
         # gRPC options
         grpc_options = self._build_grpc_options(grpc_server_config)
 
-        # Create server
-        server = grpc.server(
-            futures.ThreadPoolExecutor(max_workers=max_workers),
+        # Add max_concurrent_streams if specified
+        if max_concurrent_streams:
+            grpc_options.append(("grpc.max_concurrent_streams", max_concurrent_streams))
+
+        # Create async server
+        self.server = grpc.aio.server(
             options=grpc_options,
-            interceptors=self._build_interceptors(),
+            interceptors=await self._build_interceptors_async(),
         )
 
         # Discover and register services FIRST
-        service_count = self._register_services(server)
+        service_count = await self._register_services_async(self.server)
 
         # Add health check with registered services
         health_servicer = None
         if enable_health_check:
-            health_servicer = self._add_health_check(server)
+            health_servicer = await self._add_health_check_async(self.server)
 
         # Add reflection
         if enable_reflection:
-            self._add_reflection(server)
+            await self._add_reflection_async(self.server)
 
         # Bind server
         address = f"{host}:{port}"
-        server.add_insecure_port(address)
+        self.server.add_insecure_port(address)
 
         # Track server status in database
         server_status = None
@@ -131,35 +316,62 @@ class Command(BaseCommand):
             import os
             from django_cfg.apps.integrations.grpc.services import ServiceDiscovery
 
-            # Get registered services metadata
+            # Store config for re-registration
+            self.server_config = {
+                'host': host,
+                'port': port,
+                'pid': os.getpid(),
+                'max_workers': 0,
+                'enable_reflection': enable_reflection,
+                'enable_health_check': enable_health_check,
+            }
+
+            # Get registered services metadata (run in thread to avoid blocking)
             discovery = ServiceDiscovery()
-            services_metadata = discovery.get_registered_services()
+            services_metadata = await asyncio.to_thread(
+                discovery.get_registered_services
+            )
 
-            server_status = GRPCServerStatus.objects.start_server(
+            server_status = await asyncio.to_thread(
+                GRPCServerStatus.objects.start_server,
                 host=host,
                 port=port,
                 pid=os.getpid(),
-                max_workers=max_workers,
+                max_workers=0,  # Async server - no workers
                 enable_reflection=enable_reflection,
                 enable_health_check=enable_health_check,
             )
 
             # Store registered services in database
             server_status.registered_services = services_metadata
-            server_status.save(update_fields=["registered_services"])
+            await asyncio.to_thread(
+                server_status.save,
+                update_fields=["registered_services"]
+            )
+
+            # Store in instance for heartbeat
+            self.server_status = server_status
 
         except Exception as e:
-            logger.warning(f"Could not start server status tracking: {e}")
+            self.logger.warning(f"Could not start server status tracking: {e}")
 
         # Start server
-        server.start()
+        await self.server.start()
 
         # Mark server as running
         if server_status:
             try:
-                server_status.mark_running()
+                await asyncio.to_thread(server_status.mark_running)
             except Exception as e:
-                logger.warning(f"Could not mark server as running: {e}")
+                self.logger.warning(f"Could not mark server as running: {e}")
+
+        # Start heartbeat background task
+        heartbeat_task = None
+        if server_status:
+            heartbeat_task = asyncio.create_task(
+                self._heartbeat_loop(interval=30)
+            )
+            self.logger.info("Started heartbeat background task (30s interval)")
 
         # Display gRPC-specific startup info
         try:
@@ -168,35 +380,100 @@ class Command(BaseCommand):
 
             # Get registered service names
             discovery = ServiceDiscovery()
-            services_metadata = discovery.get_registered_services()
+            services_metadata = await asyncio.to_thread(
+                discovery.get_registered_services
+            )
             service_names = [s.get('name', 'Unknown') for s in services_metadata]
 
             # Display startup info
             grpc_display = GRPCDisplayManager()
-            grpc_display.display_grpc_startup(
+            await asyncio.to_thread(
+                grpc_display.display_grpc_startup,
                 host=host,
                 port=port,
-                max_workers=max_workers,
+                max_workers=0,  # Async server
                 enable_reflection=enable_reflection,
                 enable_health_check=enable_health_check,
                 registered_services=service_count,
                 service_names=service_names,
             )
         except Exception as e:
-            logger.warning(f"Could not display gRPC startup info: {e}")
+            self.logger.warning(f"Could not display gRPC startup info: {e}")
 
         # Setup signal handlers for graceful shutdown
-        self._setup_signal_handlers(server, server_status)
+        self._setup_signal_handlers_async(self.server, server_status)
 
         # Keep server running
-        self.stdout.write(self.style.SUCCESS("\n✅ gRPC server is running..."))
+        self.stdout.write(self.style.SUCCESS("\n✅ Async gRPC server is running..."))
+
+        # Show reloader status
+        if use_reloader and not is_production:
+            self.stdout.write(
+                self.style.SUCCESS(
+                    "🔄 Auto-reloader active - server will restart on code changes"
+                )
+            )
+
         self.stdout.write("Press CTRL+C to stop\n")
 
+        # Log server ready
+        self.streaming_logger.info("✅ Server ready and accepting connections")
+        if use_reloader:
+            self.streaming_logger.info("🔄 Watching for file changes...")
+
+        # Send test Centrifugo event if --test flag is set
+        if options.get("test"):
+            self.streaming_logger.info("🧪 Sending test Centrifugo event...")
+            try:
+                from django_cfg.apps.integrations.grpc.centrifugo.demo import send_demo_event
+
+                test_result = await send_demo_event(
+                    channel="grpc#rungrpc#startup#test",
+                    metadata={
+                        "source": "rungrpc",
+                        "action": "startup_test",
+                        "mode": "Development" if not is_production else "Production",
+                        "host": host,
+                        "port": port,
+                    }
+                )
+
+                if test_result:
+                    self.streaming_logger.info("✅ Test Centrifugo event sent successfully")
+                    self.stdout.write(self.style.SUCCESS("🧪 Test event published to Centrifugo"))
+                else:
+                    self.streaming_logger.warning("⚠️ Test Centrifugo event failed")
+                    self.stdout.write(self.style.WARNING("⚠️ Test event failed (check Centrifugo config)"))
+
+            except Exception as e:
+                self.streaming_logger.error(f"❌ Failed to send test event: {e}")
+                self.stdout.write(
+                    self.style.ERROR(f"❌ Test event error: {e}")
+                )
+
+        shutdown_reason = "Unknown"
         try:
-            server.wait_for_termination()
+            await self.server.wait_for_termination()
+            shutdown_reason = "Normal termination"
         except KeyboardInterrupt:
-            # Signal handler will take care of graceful shutdown
+            shutdown_reason = "Keyboard interrupt"
             pass
+        finally:
+            # Log shutdown using reusable function
+            log_server_shutdown(
+                self.streaming_logger,
+                start_time,
+                server_type="gRPC Server",
+                reason=shutdown_reason
+            )
+
+            # Cancel heartbeat task
+            if heartbeat_task and not heartbeat_task.done():
+                heartbeat_task.cancel()
+                try:
+                    await heartbeat_task
+                except asyncio.CancelledError:
+                    pass
 
     def _build_grpc_options(self, config: dict) -> list:
         """
@@ -244,12 +521,12 @@ class Command(BaseCommand):
 
         return options
 
-    def _build_interceptors(self) -> list:
+    async def _build_interceptors_async(self) -> list:
         """
-        Build server interceptors from configuration.
+        Build async server interceptors from configuration.
 
         Returns:
-            List of interceptor instances
+            List of async interceptor instances
         """
         grpc_framework_config = getattr(settings, "GRPC_FRAMEWORK", {})
         interceptor_paths = grpc_framework_config.get("SERVER_INTERCEPTORS", [])
@@ -269,22 +546,22 @@ class Command(BaseCommand):
                 interceptor = interceptor_class()
                 interceptors.append(interceptor)
 
-                logger.debug(f"Loaded interceptor: {class_name}")
+                self.logger.debug(f"Loaded async interceptor: {class_name}")
 
             except Exception as e:
-                logger.error(f"Failed to load interceptor {interceptor_path}: {e}")
+                self.logger.error(f"Failed to load async interceptor {interceptor_path}: {e}")
 
         return interceptors
 
-    def _add_health_check(self, server):
+    async def _add_health_check_async(self, server):
         """
-        Add health check service with per-service status tracking.
+        Add health check service to async server.
 
         Args:
-            server: gRPC server instance
+            server: Async gRPC server instance
 
         Returns:
-            health_servicer: Health servicer instance (for dynamic updates) or None
+            health_servicer: Health servicer instance or None
         """
         try:
             from grpc_health.v1 import health, health_pb2, health_pb2_grpc
@@ -294,14 +571,13 @@ class Command(BaseCommand):
 
             # Set overall server status
             health_servicer.set("", health_pb2.HealthCheckResponse.SERVING)
-            logger.info("Overall server health: SERVING")
+            self.logger.info("Overall server health: SERVING")
 
-            # Get registered service names
+            # Get registered service names from async server
             service_names = []
             if hasattr(server, '_state') and hasattr(server._state, 'generic_handlers'):
                 for handler in server._state.generic_handlers:
                     if hasattr(handler, 'service_name'):
-                        # service_name() returns a callable or list
                         names = handler.service_name()
                         if callable(names):
                             names = names()
@@ -316,44 +592,42 @@ class Command(BaseCommand):
                     service_name,
                     health_pb2.HealthCheckResponse.SERVING
                 )
-                logger.info(f"Service '{service_name}' health: SERVING")
+                self.logger.info(f"Service '{service_name}' health: SERVING")
 
-            # Register health service
+            # Register health service to async server
             health_pb2_grpc.add_HealthServicer_to_server(health_servicer, server)
 
-            logger.info(
+            self.logger.info(
                 f"✅ Health check enabled for {len(service_names)} service(s)"
             )
 
-            # Return servicer for dynamic health updates
             return health_servicer
 
         except ImportError:
-            logger.warning(
+            self.logger.warning(
                 "grpcio-health-checking not installed. "
                 "Install with: pip install 'django-cfg[grpc]'"
             )
             return None
         except Exception as e:
-            logger.error(f"Failed to add health check service: {e}")
+            self.logger.error(f"Failed to add health check service: {e}")
             return None
 
-    def _add_reflection(self, server):
+    async def _add_reflection_async(self, server):
         """
-        Add reflection service to server.
+        Add reflection service to async server.
 
         Args:
-            server: gRPC server instance
+            server: Async gRPC server instance
         """
         try:
             from grpc_reflection.v1alpha import reflection
 
-            # Get service names from registered services
+            # Get service names from async server
             service_names = []
             if hasattr(server, '_state') and hasattr(server._state, 'generic_handlers'):
                 for handler in server._state.generic_handlers:
                     if hasattr(handler, 'service_name'):
-                        # service_name() returns a callable or list
                         names = handler.service_name()
                         if callable(names):
                             names = names()
@@ -365,25 +639,25 @@ class Command(BaseCommand):
             # Add grpc.reflection.v1alpha.ServerReflection service itself
             service_names.append('grpc.reflection.v1alpha.ServerReflection')
 
-            # Add reflection
+            # Add reflection to async server
             reflection.enable_server_reflection(service_names, server)
 
-            logger.info(f"Server reflection enabled for {len(service_names)} service(s)")
+            self.logger.info(f"Server reflection enabled for {len(service_names)} service(s)")
 
         except ImportError:
-            logger.warning(
+            self.logger.warning(
                 "grpcio-reflection not installed. "
                 "Install with: pip install grpcio-reflection"
             )
         except Exception as e:
-            logger.error(f"Failed to enable server reflection: {e}")
+            self.logger.error(f"Failed to enable server reflection: {e}")
 
-    def _register_services(self, server) -> int:
+    async def _register_services_async(self, server) -> int:
         """
-        Discover and register services to server.
+        Discover and register services to async server.
 
         Args:
-            server: gRPC server instance
+            server: Async gRPC server instance
 
         Returns:
             Number of services registered
@@ -391,24 +665,115 @@ class Command(BaseCommand):
         try:
             from django_cfg.apps.integrations.grpc.services.discovery import discover_and_register_services
 
-            count = discover_and_register_services(server)
+            # Service registration is sync, run in thread
+            count = await asyncio.to_thread(
+                discover_and_register_services,
+                server
+            )
             return count
 
         except Exception as e:
-            logger.error(f"Failed to register services: {e}", exc_info=True)
+            self.logger.error(f"Failed to register services: {e}", exc_info=True)
             self.stdout.write(
                 self.style.ERROR(f"Error registering services: {e}")
             )
             return 0
 
-    def _setup_signal_handlers(self, server, server_status=None):
+    async def _heartbeat_loop(self, interval: int = 30):
+        """
+        Periodically update server heartbeat with auto-recovery.
+
+        If server record is deleted from database, automatically re-registers
+        the server to maintain monitoring continuity.
+
+        Args:
+            interval: Heartbeat interval in seconds (default: 30)
+        """
+        from django_cfg.apps.integrations.grpc.models import GRPCServerStatus
+        from asgiref.sync import sync_to_async
+
+        try:
+            while True:
+                await asyncio.sleep(interval)
+
+                if not self.server_status or not self.server_config:
+                    self.logger.warning("No server status or config available")
+                    continue
+
+                try:
+                    # Check if record still exists
+                    record_exists = await sync_to_async(
+                        GRPCServerStatus.objects.filter(
+                            id=self.server_status.id
+                        ).exists
+                    )()
+
+                    if not record_exists:
+                        # Record was deleted - re-register server
+                        self.logger.warning(
+                            "Server record was deleted from database, "
+                            "re-registering..."
+                        )
+
+                        # Get services metadata for re-registration
+                        from django_cfg.apps.integrations.grpc.services import ServiceDiscovery
+                        discovery = ServiceDiscovery()
+                        services_metadata = await asyncio.to_thread(
+                            discovery.get_registered_services
+                        )
+
+                        # Re-register server
+                        new_server_status = await asyncio.to_thread(
+                            GRPCServerStatus.objects.start_server,
+                            **self.server_config
+                        )
+
+                        # Store registered services
+                        new_server_status.registered_services = services_metadata
+                        await asyncio.to_thread(
+                            new_server_status.save,
+                            update_fields=["registered_services"]
+                        )
+
+                        # Mark as running
+                        await asyncio.to_thread(new_server_status.mark_running)
+
+                        # Update reference
+                        self.server_status = new_server_status
+
+                        self.logger.warning(
+                            f"✅ Successfully re-registered server (ID: {new_server_status.id})"
+                        )
+                    else:
+                        # Record exists - just update heartbeat
+                        await asyncio.to_thread(self.server_status.mark_running)
+                        self.logger.debug(f"Heartbeat updated (interval: {interval}s)")
+
+                except Exception as e:
+                    self.logger.warning(f"Failed to update heartbeat: {e}")
+
+        except asyncio.CancelledError:
+            self.logger.info("Heartbeat task cancelled")
+            raise
+
+    def _setup_signal_handlers_async(self, server, server_status=None):
         """
-        Setup signal handlers for graceful shutdown.
+        Setup signal handlers for graceful async server shutdown.
 
         Args:
-            server: gRPC server instance
+            server: Async gRPC server instance
             server_status: GRPCServerStatus instance (optional)
+
+        Note:
+            Signal handlers can only be set in the main thread.
+            When running with autoreload, we're in a separate thread,
+            so we skip signal handler setup.
         """
+        # Check if we're in the main thread
+        if threading.current_thread() is not threading.main_thread():
+            # In autoreload mode, Django handles signals - we don't need to set them up
+            return
+
         # Flag to prevent multiple shutdown attempts
         shutdown_initiated = {'value': False}
 
@@ -423,19 +788,33 @@ class Command(BaseCommand):
             # Mark server as stopping
             if server_status:
                 try:
-                    server_status.mark_stopping()
+                    import django
+                    if django.VERSION >= (3, 0):
+                        from asgiref.sync import sync_to_async
+                        # Run in sync context
+                        try:
+                            server_status.mark_stopping()
+                        except:
+                            pass
                 except Exception as e:
-                    logger.warning(f"Could not mark server as stopping: {e}")
+                    self.logger.warning(f"Could not mark server as stopping: {e}")
 
-            # Stop server with grace period
-            server.stop(grace=5)
+            # Stop async server
+            try:
+                # Create task to stop server
+                loop = asyncio.get_event_loop()
+                loop.create_task(server.stop(grace=5))
+            except Exception as e:
+                self.logger.error(f"Error stopping server: {e}")
 
-            # Mark server as stopped
+            # Mark server as stopped (async-safe)
             if server_status:
                 try:
-                    server_status.mark_stopped()
+                    from asgiref.sync import sync_to_async
+                    # Wrap sync DB operation in sync_to_async
+                    asyncio.create_task(sync_to_async(server_status.mark_stopped)())
                 except Exception as e:
-                    logger.warning(f"Could not mark server as stopped: {e}")
+                    self.logger.warning(f"Could not mark server as stopped: {e}")
 
             self.stdout.write(self.style.SUCCESS("✅ Server stopped"))