django-cfg 1.5.9__tar.gz → 1.5.11__tar.gz

{django_cfg-1.5.9 → django_cfg-1.5.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-cfg
-Version: 1.5.9
+Version: 1.5.11
 Summary: Modern Django framework with type-safe Pydantic v2 configuration, Next.js admin integration, real-time WebSockets, and 8 enterprise apps. Replace settings.py with validated models, 90% less code. Production-ready with AI agents, auto-generated TypeScript clients, and zero-config features.
 Project-URL: Homepage, https://djangocfg.com
 Project-URL: Documentation, https://djangocfg.com

{django_cfg-1.5.9 → django_cfg-1.5.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "django-cfg"
-version = "1.5.9"
+version = "1.5.11"
 description = "Modern Django framework with type-safe Pydantic v2 configuration, Next.js admin integration, real-time WebSockets, and 8 enterprise apps. Replace settings.py with validated models, 90% less code. Production-ready with AI agents, auto-generated TypeScript clients, and zero-config features."
 readme = "README.md"
 keywords = [ "django", "configuration", "pydantic", "settings", "type-safety", "pydantic-settings", "django-environ", "startup-validation", "ide-autocomplete", "nextjs-admin", "react-admin", "websocket", "centrifugo", "real-time", "typescript-generation", "ai-agents", "enterprise-django", "django-settings", "type-safe-config", "modern-django",]

{django_cfg-1.5.9 → django_cfg-1.5.11}/src/django_cfg/__init__.py

@@ -32,7 +32,7 @@ Example:
 default_app_config = "django_cfg.apps.DjangoCfgConfig"
 
 # Version information
-__version__ = "1.5.9"
+__version__ = "1.5.11"
 __license__ = "MIT"
 
 # Setup warnings debug early (checks env var only at this point)

django_cfg-1.5.11/src/django_cfg/apps/api/commands/serializers.py

@@ -0,0 +1,152 @@
+"""
+Django CFG Commands API Serializers.
+"""
+
+from rest_framework import serializers
+
+
+class CommandMetadataSerializer(serializers.Serializer):
+    """
+    Serializer for command metadata.
+
+    Includes security attributes from our base classes:
+    - web_executable: Can be executed via web interface
+    - requires_input: Requires interactive user input
+    - is_destructive: Modifies or deletes data
+    - is_allowed: Passes security checks
+    - risk_level: Security risk assessment
+    """
+
+    web_executable = serializers.BooleanField(
+        allow_null=True,
+        help_text="Whether command can be executed via web interface"
+    )
+    requires_input = serializers.BooleanField(
+        allow_null=True,
+        help_text="Whether command requires interactive user input"
+    )
+    is_destructive = serializers.BooleanField(
+        allow_null=True,
+        help_text="Whether command modifies or deletes data"
+    )
+    is_allowed = serializers.BooleanField(
+        help_text="Whether command passes security checks for web execution"
+    )
+    risk_level = serializers.ChoiceField(
+        choices=['safe', 'caution', 'dangerous', 'unknown'],
+        help_text="Security risk level assessment"
+    )
+
+
+class CommandSerializer(serializers.Serializer):
+    """
+    Serializer for Django management commands.
+
+    Returns command information including:
+    - Basic info (name, app, description)
+    - Security metadata (web_executable, requires_input, is_destructive)
+    - Execution status (is_allowed, risk_level)
+    """
+
+    name = serializers.CharField(
+        help_text="Command name"
+    )
+    app = serializers.CharField(
+        help_text="Django app that provides this command"
+    )
+    description = serializers.CharField(
+        help_text="Short description of what the command does"
+    )
+
+    # Security metadata - flattened for easier API consumption
+    web_executable = serializers.BooleanField(
+        allow_null=True,
+        help_text="Can be executed via web interface"
+    )
+    requires_input = serializers.BooleanField(
+        allow_null=True,
+        help_text="Requires interactive user input"
+    )
+    is_destructive = serializers.BooleanField(
+        allow_null=True,
+        help_text="Modifies or deletes data"
+    )
+    is_allowed = serializers.BooleanField(
+        help_text="Passes security checks"
+    )
+    risk_level = serializers.ChoiceField(
+        choices=['safe', 'caution', 'dangerous', 'unknown'],
+        help_text="Security risk level"
+    )
+
+
+class CommandListResponseSerializer(serializers.Serializer):
+    """
+    Serializer for list commands API response.
+
+    Returns categorized commands:
+    - django_cfg: Custom django-cfg commands
+    - django_core: Django built-in commands
+    - third_party: Third-party app commands
+    - project: Project-specific commands
+    """
+
+    status = serializers.ChoiceField(
+        choices=['success', 'error'],
+        help_text="Response status"
+    )
+    commands = serializers.DictField(
+        child=serializers.ListField(child=CommandSerializer()),
+        help_text="Categorized command lists"
+    )
+    total_commands = serializers.IntegerField(
+        help_text="Total number of commands available"
+    )
+    timestamp = serializers.DateTimeField(
+        help_text="Response timestamp"
+    )
+
+
+class CommandExecutionRequestSerializer(serializers.Serializer):
+    """
+    Serializer for command execution requests.
+    """
+
+    command = serializers.CharField(
+        required=True,
+        help_text="Name of the command to execute"
+    )
+    args = serializers.ListField(
+        child=serializers.CharField(),
+        required=False,
+        default=list,
+        help_text="Positional arguments for the command"
+    )
+    options = serializers.DictField(
+        required=False,
+        default=dict,
+        help_text="Named options for the command (e.g., {'--verbose': True})"
+    )
+
+
+class CommandHelpResponseSerializer(serializers.Serializer):
+    """
+    Serializer for command help API response.
+    """
+
+    status = serializers.ChoiceField(
+        choices=['success', 'error'],
+        help_text="Response status"
+    )
+    command = serializers.CharField(
+        help_text="Command name"
+    )
+    app = serializers.CharField(
+        help_text="Django app"
+    )
+    help = serializers.CharField(
+        help_text="Full help text from command --help"
+    )
+    timestamp = serializers.DateTimeField(
+        help_text="Response timestamp"
+    )

{django_cfg-1.5.9 → django_cfg-1.5.11}/src/django_cfg/apps/api/commands/views.py

@@ -49,6 +49,7 @@ def list_commands_view(request):
                 "name": command_name,
                 "app": app_name,
                 "description": _get_command_description(command_name),
+                **_get_command_metadata(command_name, app_name),
             }
 
             if app_name == "django_cfg":
@@ -270,6 +271,37 @@ def _get_command_description(command_name: str) -> str:
         return f'Django management command: {command_name}'
 
 
+def _get_command_metadata(command_name: str, app_name: str) -> dict:
+    """
+    Get security metadata for a command.
+
+    Returns:
+        Dict with web_executable, requires_input, is_destructive, is_allowed
+    """
+    try:
+        from django.core.management import load_command_class
+        from django_cfg.apps.system.dashboard.services.commands_security import is_command_allowed, get_command_risk_level
+
+        command_instance = load_command_class(app_name, command_name)
+
+        return {
+            'web_executable': getattr(command_instance, 'web_executable', None),
+            'requires_input': getattr(command_instance, 'requires_input', None),
+            'is_destructive': getattr(command_instance, 'is_destructive', None),
+            'is_allowed': is_command_allowed(command_name, app_name),
+            'risk_level': get_command_risk_level(command_name, app_name),
+        }
+    except Exception as e:
+        logger.debug(f"Could not load metadata for {command_name}: {e}")
+        return {
+            'web_executable': None,
+            'requires_input': None,
+            'is_destructive': None,
+            'is_allowed': False,
+            'risk_level': 'unknown',
+        }
+
+
 def _get_command_help(command_name: str) -> str:
     """Get full help text for a command."""
     try:

{django_cfg-1.5.9 → django_cfg-1.5.11}/src/django_cfg/apps/business/accounts/management/commands/otp_test.py

@@ -2,17 +2,20 @@
 Management command to test OTP functionality.
 """
 
-from django.core.management.base import BaseCommand, CommandError
+from django.core.management.base import CommandError
 from django.utils import timezone
 from rich.console import Console
 from rich.panel import Panel
 from rich.table import Table
 
+from django_cfg.management.utils import SafeCommand
+
 from ...models import OTPSecret
 from ...services.otp_service import OTPService
 
 
-class Command(BaseCommand):
+class Command(SafeCommand):
+    command_name = 'otp_test'
     help = "Test OTP functionality with email and telegram delivery"
 
     def __init__(self, *args, **kwargs):

django_cfg-1.5.11/src/django_cfg/apps/business/agents/management/commands/create_agent.py

@@ -0,0 +1,177 @@
+"""
+Management command to create agent definitions.
+"""
+
+import asyncio
+
+from django.contrib.auth.models import User
+from django.core.management.base import CommandError
+
+from django_cfg.management.utils import AdminCommand
+
+from django_cfg.apps.business.agents.models.registry import AgentDefinition
+
+
+class Command(AdminCommand):
+    """Create agent definition from command line."""
+
+    command_name = 'create_agent'
+    help = 'Create a new agent definition'
+
+    def add_arguments(self, parser):
+        """Add command arguments."""
+        parser.add_argument('name', type=str, help='Agent name (unique identifier)')
+        parser.add_argument('instructions', type=str, help='Agent instructions/system prompt')
+
+        parser.add_argument(
+            '--deps-type',
+            type=str,
+            default='DjangoDeps',
+            help='Dependencies type (default: DjangoDeps)'
+        )
+        parser.add_argument(
+            '--output-type',
+            type=str,
+            default='ProcessResult',
+            help='Output type (default: ProcessResult)'
+        )
+        parser.add_argument(
+            '--model',
+            type=str,
+            default='openai:gpt-4o-mini',
+            help='LLM model to use (default: openai:gpt-4o-mini)'
+        )
+        parser.add_argument(
+            '--category',
+            type=str,
+            default='',
+            help='Agent category'
+        )
+        parser.add_argument(
+            '--timeout',
+            type=int,
+            default=300,
+            help='Execution timeout in seconds (default: 300)'
+        )
+        parser.add_argument(
+            '--max-retries',
+            type=int,
+            default=3,
+            help='Maximum retry attempts (default: 3)'
+        )
+        parser.add_argument(
+            '--public',
+            action='store_true',
+            help='Make agent public (accessible to all users)'
+        )
+        parser.add_argument(
+            '--no-cache',
+            action='store_true',
+            help='Disable caching for this agent'
+        )
+        parser.add_argument(
+            '--creator',
+            type=str,
+            help='Username of agent creator (defaults to first superuser)'
+        )
+        parser.add_argument(
+            '--description',
+            type=str,
+            default='',
+            help='Agent description'
+        )
+        parser.add_argument(
+            '--tags',
+            type=str,
+            nargs='*',
+            help='Agent tags (space-separated)'
+        )
+
+    def handle(self, *args, **options):
+        """Handle command execution."""
+        # Run async operations
+        asyncio.run(self._create_agent(options))
+
+    async def _create_agent(self, options):
+        """Create agent definition."""
+        name = options['name']
+        instructions = options['instructions']
+
+        # Validate name
+        if await AgentDefinition.objects.filter(name=name).aexists():
+            raise CommandError(f"Agent '{name}' already exists")
+
+        # Get creator user
+        creator = await self._get_creator_user(options.get('creator'))
+
+        # Prepare agent data
+        agent_data = {
+            'name': name,
+            'instructions': instructions,
+            'deps_type': options['deps_type'],
+            'output_type': options['output_type'],
+            'model': options['model'],
+            'category': options['category'],
+            'timeout': options['timeout'],
+            'max_retries': options['max_retries'],
+            'is_public': options['public'],
+            'enable_caching': not options['no_cache'],
+            'created_by': creator,
+            'description': options['description'],
+        }
+
+        # Add tags if provided
+        if options['tags']:
+            agent_data['tags'] = options['tags']
+
+        # Create agent definition
+        try:
+            agent_def = await AgentDefinition.objects.acreate(**agent_data)
+
+            self.stdout.write(
+                self.style.SUCCESS(f"✅ Created agent definition: {agent_def.name}")
+            )
+
+            # Show agent details
+            self.stdout.write("\nAgent Details:")
+            self.stdout.write(f"  Name: {agent_def.name}")
+            self.stdout.write(f"  Display Name: {agent_def.display_name}")
+            self.stdout.write(f"  Category: {agent_def.category or 'None'}")
+            self.stdout.write(f"  Model: {agent_def.model}")
+            self.stdout.write(f"  Dependencies: {agent_def.deps_type}")
+            self.stdout.write(f"  Output Type: {agent_def.output_type}")
+            self.stdout.write(f"  Timeout: {agent_def.timeout}s")
+            self.stdout.write(f"  Max Retries: {agent_def.max_retries}")
+            self.stdout.write(f"  Public: {agent_def.is_public}")
+            self.stdout.write(f"  Caching: {agent_def.enable_caching}")
+            self.stdout.write(f"  Created by: {agent_def.created_by.username}")
+
+            if agent_def.tags:
+                self.stdout.write(f"  Tags: {', '.join(agent_def.tags)}")
+
+            if agent_def.description:
+                self.stdout.write(f"  Description: {agent_def.description}")
+
+            # Instructions preview
+            instructions_preview = agent_def.instructions[:200]
+            if len(agent_def.instructions) > 200:
+                instructions_preview += "..."
+
+            self.stdout.write(f"  Instructions: {instructions_preview}")
+
+        except Exception as e:
+            raise CommandError(f"Failed to create agent: {e}")
+
+    async def _get_creator_user(self, username):
+        """Get creator user."""
+        if username:
+            try:
+                return await User.objects.aget(username=username)
+            except User.DoesNotExist:
+                raise CommandError(f"User '{username}' not found")
+        else:
+            # Use first superuser
+            try:
+                return await User.objects.filter(is_superuser=True).afirst()
+            except User.DoesNotExist:
+                raise CommandError("No superuser found. Please create a superuser first or specify --creator")

django_cfg-1.5.9/src/django_cfg/apps/business/agents/management/commands/create_agent.py → django_cfg-1.5.11/src/django_cfg/apps/business/agents/management/commands/load_agent_templates.py

@@ -1,182 +1,21 @@
 """
-Management command to create agent definitions.
+Management command to load pre-built agent templates.
 """
 
 import asyncio
 
 from django.contrib.auth.models import User
-from django.core.management.base import BaseCommand, CommandError
+from django.core.management.base import CommandError
 
-from django_cfg.apps.business.agents.models.registry import AgentDefinition
-
-
-class Command(BaseCommand):
-    """Create agent definition from command line."""
-
-    help = 'Create a new agent definition'
-
-    def add_arguments(self, parser):
-        """Add command arguments."""
-        parser.add_argument('name', type=str, help='Agent name (unique identifier)')
-        parser.add_argument('instructions', type=str, help='Agent instructions/system prompt')
-
-        parser.add_argument(
-            '--deps-type',
-            type=str,
-            default='DjangoDeps',
-            help='Dependencies type (default: DjangoDeps)'
-        )
-        parser.add_argument(
-            '--output-type',
-            type=str,
-            default='ProcessResult',
-            help='Output type (default: ProcessResult)'
-        )
-        parser.add_argument(
-            '--model',
-            type=str,
-            default='openai:gpt-4o-mini',
-            help='LLM model to use (default: openai:gpt-4o-mini)'
-        )
-        parser.add_argument(
-            '--category',
-            type=str,
-            default='',
-            help='Agent category'
-        )
-        parser.add_argument(
-            '--timeout',
-            type=int,
-            default=300,
-            help='Execution timeout in seconds (default: 300)'
-        )
-        parser.add_argument(
-            '--max-retries',
-            type=int,
-            default=3,
-            help='Maximum retry attempts (default: 3)'
-        )
-        parser.add_argument(
-            '--public',
-            action='store_true',
-            help='Make agent public (accessible to all users)'
-        )
-        parser.add_argument(
-            '--no-cache',
-            action='store_true',
-            help='Disable caching for this agent'
-        )
-        parser.add_argument(
-            '--creator',
-            type=str,
-            help='Username of agent creator (defaults to first superuser)'
-        )
-        parser.add_argument(
-            '--description',
-            type=str,
-            default='',
-            help='Agent description'
-        )
-        parser.add_argument(
-            '--tags',
-            type=str,
-            nargs='*',
-            help='Agent tags (space-separated)'
-        )
-
-    def handle(self, *args, **options):
-        """Handle command execution."""
-        # Run async operations
-        asyncio.run(self._create_agent(options))
-
-    async def _create_agent(self, options):
-        """Create agent definition."""
-        name = options['name']
-        instructions = options['instructions']
-
-        # Validate name
-        if await AgentDefinition.objects.filter(name=name).aexists():
-            raise CommandError(f"Agent '{name}' already exists")
-
-        # Get creator user
-        creator = await self._get_creator_user(options.get('creator'))
-
-        # Prepare agent data
-        agent_data = {
-            'name': name,
-            'instructions': instructions,
-            'deps_type': options['deps_type'],
-            'output_type': options['output_type'],
-            'model': options['model'],
-            'category': options['category'],
-            'timeout': options['timeout'],
-            'max_retries': options['max_retries'],
-            'is_public': options['public'],
-            'enable_caching': not options['no_cache'],
-            'created_by': creator,
-            'description': options['description'],
-        }
-
-        # Add tags if provided
-        if options['tags']:
-            agent_data['tags'] = options['tags']
-
-        # Create agent definition
-        try:
-            agent_def = await AgentDefinition.objects.acreate(**agent_data)
-
-            self.stdout.write(
-                self.style.SUCCESS(f"✅ Created agent definition: {agent_def.name}")
-            )
-
-            # Show agent details
-            self.stdout.write("\nAgent Details:")
-            self.stdout.write(f"  Name: {agent_def.name}")
-            self.stdout.write(f"  Display Name: {agent_def.display_name}")
-            self.stdout.write(f"  Category: {agent_def.category or 'None'}")
-            self.stdout.write(f"  Model: {agent_def.model}")
-            self.stdout.write(f"  Dependencies: {agent_def.deps_type}")
-            self.stdout.write(f"  Output Type: {agent_def.output_type}")
-            self.stdout.write(f"  Timeout: {agent_def.timeout}s")
-            self.stdout.write(f"  Max Retries: {agent_def.max_retries}")
-            self.stdout.write(f"  Public: {agent_def.is_public}")
-            self.stdout.write(f"  Caching: {agent_def.enable_caching}")
-            self.stdout.write(f"  Created by: {agent_def.created_by.username}")
+from django_cfg.management.utils import AdminCommand
 
-            if agent_def.tags:
-                self.stdout.write(f"  Tags: {', '.join(agent_def.tags)}")
-
-            if agent_def.description:
-                self.stdout.write(f"  Description: {agent_def.description}")
-
-            # Instructions preview
-            instructions_preview = agent_def.instructions[:200]
-            if len(agent_def.instructions) > 200:
-                instructions_preview += "..."
-
-            self.stdout.write(f"  Instructions: {instructions_preview}")
-
-        except Exception as e:
-            raise CommandError(f"Failed to create agent: {e}")
-
-    async def _get_creator_user(self, username):
-        """Get creator user."""
-        if username:
-            try:
-                return await User.objects.aget(username=username)
-            except User.DoesNotExist:
-                raise CommandError(f"User '{username}' not found")
-        else:
-            # Use first superuser
-            try:
-                return await User.objects.filter(is_superuser=True).afirst()
-            except User.DoesNotExist:
-                raise CommandError("No superuser found. Please create a superuser first or specify --creator")
+from django_cfg.apps.business.agents.models.registry import AgentDefinition
 
 
-class Command(BaseCommand):
+class Command(AdminCommand):
     """Load agent definitions from templates."""
 
+    command_name = 'load_agent_templates'
     help = 'Load pre-built agent templates'
 
     def add_arguments(self, parser):

{django_cfg-1.5.9 → django_cfg-1.5.11}/src/django_cfg/apps/business/agents/management/commands/orchestrator_status.py

@@ -5,17 +5,19 @@ Management command to show orchestrator status.
 import asyncio
 from datetime import timedelta
 
-from django.core.management.base import BaseCommand
 from django.utils import timezone
 
+from django_cfg.management.utils import SafeCommand
+
 from django_cfg.apps.business.agents.integration.registry import get_registry
 from django_cfg.apps.business.agents.models.execution import AgentExecution, WorkflowExecution
 from django_cfg.apps.business.agents.models.registry import AgentDefinition
 
 
-class Command(BaseCommand):
+class Command(SafeCommand):
     """Show Django Orchestrator status and statistics."""
 
+    command_name = 'orchestrator_status'
     help = 'Display Django Orchestrator status and statistics'
 
     def add_arguments(self, parser):

{django_cfg-1.5.9 → django_cfg-1.5.11}/src/django_cfg/apps/business/knowbase/management/commands/knowbase_stats.py

@@ -3,17 +3,19 @@ Knowledge Base statistics command.
 """
 
 from django.contrib.auth import get_user_model
-from django.core.management.base import BaseCommand
 from django.db import models
 from django.db.models import Avg, Count, ExpressionWrapper, F, Q, Sum
 from django.db.models.functions import Extract
 
+from django_cfg.management.utils import SafeCommand
+
 User = get_user_model()
 
 
-class Command(BaseCommand):
+class Command(SafeCommand):
     """Display Knowledge Base statistics."""
 
+    command_name = 'knowbase_stats'
     help = 'Display Knowledge Base usage statistics'
 
     def add_arguments(self, parser):

{django_cfg-1.5.9 → django_cfg-1.5.11}/src/django_cfg/apps/business/knowbase/management/commands/setup_knowbase.py

@@ -2,13 +2,15 @@
 Setup command for Knowledge Base application.
 """
 
-from django.core.management.base import BaseCommand
 from django.db import connection
 
+from django_cfg.management.utils import AdminCommand
 
-class Command(BaseCommand):
+
+class Command(AdminCommand):
     """Setup Knowledge Base with pgvector extension and initial data."""
 
+    command_name = 'setup_knowbase'
     help = 'Setup Knowledge Base with pgvector extension and run migrations'
 
     def add_arguments(self, parser):