chore: snapshot current WIP before consolidation

Author: JustAGhosT

.github/app-manifest.yml

@@ -0,0 +1,30 @@
+# GitHub App Manifest for CodeFlow Engine
+# This manifest defines the GitHub App configuration for automatic setup
+# See: https://docs.github.com/en/apps/sharing-github-apps/registering-a-github-app-from-a-manifest
+#
+# NOTE: Before creating your GitHub App, replace 'your-app.azurewebsites.net' 
+# with your actual deployment URL in the webhook and callback URLs below.
+
+name: CodeFlow Engine Setup
+url: https://github.com/JustAGhosT/codeflow-engine
+hook_attributes:
+  url: https://your-app.azurewebsites.net/api/github-app/webhook
+  active: true
+redirect_url: https://your-app.azurewebsites.net/api/github-app/callback
+description: Automated setup for CodeFlow Engine - GitHub Workflow Automation
+public: false
+
+default_permissions:
+  # Repository permissions
+  actions: write
+  contents: read
+  metadata: read
+  secrets: write
+  workflows: write
+
+default_events:
+  - installation
+  - installation_repositories
+  - workflow_run
+  - push
+  - pull_request

.github/workflows/README.md

@@ -19,15 +19,17 @@ The monorepo uses a combination of engine-specific workflows, path-aware compone
 | `release-website.yml` | Website release build | Tags, manual |
 | `release-vscode-extension.yml` | VS Code extension release packaging | Tags, manual |
 | `release-orchestration-utils.yml` | Shared utility package release build | Tags, manual |
+| `deploy-autopr-engine.yml` | Engine container build and Azure deployment | Push to `master`, PR, manual |
 
 ## Workflow Details
 
 ### Key conventions
 
 - Engine workflows run from [engine](engine) via `working-directory`.
 - Component workflows use path filters so unrelated changes do not trigger full builds.
-- Release workflows use component-specific tag prefixes such as `engine-v1.2.3` and `desktop-v1.2.3`.
+- Release workflows use component-specific tag prefixes such as `engine-v0.2.0-alpha.1` and `desktop-v0.2.0-alpha.1`.
 - Infrastructure for the website and engine is sourced from [orchestration](orchestration).
+- The engine deployment workflow still uses the filename [deploy-autopr-engine.yml](.github/workflows/deploy-autopr-engine.yml) for backward compatibility, but it deploys the current CodeFlow Engine.
 
 ### Archival follow-up
 
@@ -40,7 +42,7 @@ Before archiving the legacy repositories, update their README files with the red
    - `Quality Feedback` runs (detailed feedback)
    - `CI` runs (comprehensive checks)
 
-2. **Push to Main/Develop:**
+2. **Push to master:**
    - `CI` runs with full volume settings
 
 3. **Manual/Scheduled:**

.github/workflows/deploy-autopr-engine.yml

@@ -1,4 +1,4 @@
-name: Build and Deploy CodeFlow Engine
+name: Build and Deploy CodeFlow Engine
 
 on:
   push:
@@ -36,16 +36,16 @@ jobs:
         run: |
           echo "Validating GitHub App manifest..."
           python3 -c "import yaml; yaml.safe_load(open('.github/app-manifest.yml'))"
-          echo "✅ app-manifest.yml is valid YAML"
+          echo "[OK] app-manifest.yml is valid YAML"
 
       - name: Validate .codeflow.yml config
         run: |
           if [ -f ".codeflow.yml" ]; then
             echo "Validating .codeflow.yml..."
             python3 -c "import yaml; yaml.safe_load(open('.codeflow.yml'))"
-            echo "✅ .codeflow.yml is valid YAML"
+            echo "[OK] .codeflow.yml is valid YAML"
           else
-            echo "⚠️ .codeflow.yml not found (optional)"
+            echo "[!] .codeflow.yml not found (optional)"
           fi
 
       - name: Set up Docker Buildx
@@ -64,7 +64,7 @@ jobs:
             RUN_TESTS=false
 
       - name: Validate build
-        run: echo "✅ Docker image built successfully for PR validation"
+        run: echo "[OK] Docker image built successfully for PR validation"
 
   build-and-push:
     name: Build and Push Container Image
@@ -190,7 +190,7 @@ jobs:
           ENV_NAME="prod-codeflow-san-env"
           CUSTOM_DOMAIN="app.codeflow.io"
           
-          echo "🔍 Checking for existing managed certificates for domain: $CUSTOM_DOMAIN"
+          echo "[*] Checking for existing managed certificates for domain: $CUSTOM_DOMAIN"
           
           # Check if environment exists
           if az containerapp env show -n $ENV_NAME -g $RESOURCE_GROUP &>/dev/null; then
@@ -207,10 +207,10 @@ jobs:
               '.[] | select(.properties.subjectName == $domain and .type == "Microsoft.App/managedEnvironments/managedCertificates") | .name')
             
             if [ -n "$DUPLICATE_CERTS" ]; then
-              echo "⚠️ Found duplicate managed certificate(s) for domain $CUSTOM_DOMAIN:"
+              echo "[!] Found duplicate managed certificate(s) for domain $CUSTOM_DOMAIN:"
               echo "$DUPLICATE_CERTS"
               echo ""
-              echo "🗑️ Removing duplicate certificates to prevent deployment conflicts..."
+              echo "[*] Removing duplicate certificates to prevent deployment conflicts..."
               
               while IFS= read -r cert_name; do
                 if [ -n "$cert_name" ]; then
@@ -219,23 +219,23 @@ jobs:
                     --name $ENV_NAME \
                     --resource-group $RESOURCE_GROUP \
                     --certificate "$cert_name" \
-                    --yes || echo "⚠️ Failed to delete certificate $cert_name (may not exist or be in use)"
+                    --yes || echo "[!] Failed to delete certificate $cert_name (may not exist or be in use)"
                 fi
               done <<< "$DUPLICATE_CERTS"
               
-              echo "✅ Cleanup completed"
+              echo "[OK] Cleanup completed"
             else
-              echo "✅ No duplicate certificates found for $CUSTOM_DOMAIN"
+              echo "[OK] No duplicate certificates found for $CUSTOM_DOMAIN"
             fi
           else
-            echo "ℹ️ Environment does not exist yet, skipping certificate cleanup"
+            echo "[i] Environment does not exist yet, skipping certificate cleanup"
           fi
           echo ""
 
       - name: Deploy Bicep Template
         run: |
-          echo "ℹ️ Note: SSL certificates are automatically managed by Azure. No certificate upload needed!"
-          echo "📖 See orchestration/infrastructure/bicep/FAQ.md for certificate details"
+          echo "[i] Note: SSL certificates are automatically managed by Azure. No certificate upload needed!"
+          echo "[*] See orchestration/infrastructure/bicep/FAQ.md for certificate details"
           echo ""
           az deployment group create \
             --name codeflow-engine \
@@ -267,18 +267,18 @@ jobs:
 
       - name: Display deployment info
         run: |
-          echo "✅ Deployment successful!"
+          echo "[OK] Deployment successful!"
           echo "Container App URL: ${{ steps.outputs.outputs.container_app_url }}"
           echo "Custom Domain: ${{ steps.outputs.outputs.custom_domain }}"
           echo "PostgreSQL FQDN: ${{ steps.outputs.outputs.postgres_fqdn }}"
           echo "Redis Host: ${{ steps.outputs.outputs.redis_host }}"
           echo ""
-          echo "🔒 SSL Certificate: Automatically managed by Azure (no action needed)"
+          echo "[*] SSL Certificate: Automatically managed by Azure (no action needed)"
           echo ""
-          echo "⚠️ Next steps:"
+          echo "[!] Next steps:"
           echo "1. Add DNS CNAME record: ${{ steps.outputs.outputs.custom_domain }} -> Container App FQDN"
           echo "2. Wait for DNS propagation (typically 15-30 minutes)"
           echo "3. Azure will automatically provision and bind the SSL certificate (5-15 minutes)"
           echo ""
-          echo "📖 For troubleshooting, see: infrastructure/bicep/FAQ.md"
+          echo "[*] For troubleshooting, see: infrastructure/bicep/FAQ.md"
 

codeflow_engine/actions/ai_actions/__init__.py

@@ -0,0 +1,61 @@
+"""
+CodeFlow Engine - AI Actions
+
+Actions for AI/LLM-powered features including AutoGen, memory systems, and summarization.
+"""
+
+from typing import Any
+
+# Import with error handling for optional dependencies
+AutoGenImplementation: type[Any] | None = None
+try:
+    from codeflow_engine.actions.ai_actions.autogen_implementation import AutoGenImplementation
+except ImportError:
+    pass
+
+AutoGenAgentSystem: type[Any] | None = None
+try:
+    from codeflow_engine.actions.ai_actions.autogen_multi_agent import AutoGenAgentSystem
+except ImportError:
+    pass
+
+Mem0MemoryManager: type[Any] | None = None
+try:
+    from codeflow_engine.actions.ai_actions.mem0_memory_integration import Mem0MemoryManager
+except ImportError:
+    pass
+
+LearningMemorySystem: type[Any] | None = None
+try:
+    from codeflow_engine.actions.ai_actions.learning_memory_system import LearningMemorySystem
+except ImportError:
+    pass
+
+ConfigurableLLMProvider: type[Any] | None = None
+try:
+    from codeflow_engine.actions.ai_actions.configurable_llm_provider import ConfigurableLLMProvider
+except ImportError:
+    pass
+
+# Submodule exports with guarded imports
+autogen = None
+try:
+    from codeflow_engine.actions.ai_actions import autogen
+except (ImportError, OSError):
+    pass
+
+llm = None
+try:
+    from codeflow_engine.actions.ai_actions import llm
+except (ImportError, OSError):
+    pass
+
+__all__ = [
+    "AutoGenAgentSystem",
+    "AutoGenImplementation",
+    "ConfigurableLLMProvider",
+    "LearningMemorySystem",
+    "Mem0MemoryManager",
+    "autogen",
+    "llm",
+]

codeflow_engine/actions/ai_actions/autogen/__init__.py

@@ -0,0 +1,16 @@
+"""
+AutoGen Actions Module
+
+Multi-agent collaboration and automation using AutoGen.
+"""
+
+from .agents import AutoGenAgentFactory
+from .models import AutoGenInputs, AutoGenOutputs
+from .system import AutoGenAgentSystem
+
+__all__ = [
+    "AutoGenInputs",
+    "AutoGenOutputs",
+    "AutoGenAgentFactory",
+    "AutoGenAgentSystem"
+]

codeflow_engine/actions/ai_actions/autogen/agents.py

@@ -0,0 +1,77 @@
+"""
+AutoGen Agents
+
+Specialized agents for different tasks in the AutoGen system.
+"""
+
+from typing import Any, Dict, List, Optional
+
+try:
+    from autogen import ConversableAgent  # type: ignore
+    AUTOGEN_AVAILABLE = True
+except ImportError:
+    AUTOGEN_AVAILABLE = False
+    # Create dummy class for type annotations
+    class ConversableAgentDummy:
+        def __init__(self, *args: Any, **kwargs: Any) -> None: pass
+        def initiate_chat(self, *args: Any, **kwargs: Any) -> List[Dict[str, Any]]:
+            return []
+
+    ConversableAgent = ConversableAgentDummy
+
+
+class AutoGenAgentFactory:
+    """Factory for creating specialized AutoGen agents."""
+
+    @staticmethod
+    def create_code_analyzer(llm_config: Dict[str, Any]) -> ConversableAgent:
+        """Create a code analyzer agent."""
+        if not AUTOGEN_AVAILABLE:
+            raise ImportError("AutoGen not installed. Install with: pip install pyautogen")
+
+        return ConversableAgent(
+            name="code_analyzer",
+            system_message="""You are a senior code analyzer. Your role is to:
+            1. Analyze code comments and identify the specific issue or request
+            2. Understand the context and scope of the problem
+            3. Classify the type of fix needed (syntax, logic, style, security, performance)
+            4. Provide detailed analysis with confidence scores
+
+            Always provide structured analysis with clear reasoning.""",
+            llm_config=llm_config,
+            human_input_mode="NEVER",
+        )
+
+    @staticmethod
+    def create_code_fixer(llm_config: Dict[str, Any]) -> ConversableAgent:
+        """Create a code fixer agent."""
+        if not AUTOGEN_AVAILABLE:
+            raise ImportError("AutoGen not installed. Install with: pip install pyautogen")
+
+        return ConversableAgent(
+            name="code_fixer",
+            system_message="""You are an expert code fixer. Your role is to:
+            1. Take analysis from the code analyzer
+            2. Generate precise, minimal code fixes
+            3. Ensure fixes follow best practices and project conventions
+            4. Provide multiple solution options when appropriate""",
+            llm_config=llm_config,
+            human_input_mode="NEVER",
+        )
+
+    @staticmethod
+    def create_security_auditor(llm_config: Dict[str, Any]) -> ConversableAgent:
+        """Create a security auditor agent."""
+        if not AUTOGEN_AVAILABLE:
+            raise ImportError("AutoGen not installed. Install with: pip install pyautogen")
+
+        return ConversableAgent(
+            name="security_auditor",
+            system_message="""You are a security expert. Your role is to:
+            1. Identify potential security vulnerabilities
+            2. Assess code for security best practices
+            3. Provide security-focused recommendations
+            4. Ensure compliance with security standards""",
+            llm_config=llm_config,
+            human_input_mode="NEVER",
+        )

codeflow_engine/actions/ai_actions/autogen/models.py

@@ -0,0 +1,32 @@
+"""
+AutoGen Models
+
+Data models for AutoGen multi-agent integration.
+"""
+
+from typing import Any, Dict, List, Optional
+
+from pydantic import BaseModel, Field
+
+
+class AutoGenInputs(BaseModel):
+    """Inputs for AutoGen multi-agent processing."""
+    comment_body: str
+    file_path: Optional[str] = None
+    file_content: Optional[str] = None
+    pr_context: Dict[str, Any] = Field(default_factory=dict)
+    task_type: str = (
+        "analyze_and_fix"  # "analyzeAnd_fix", "code_review", "security_audit"
+    )
+    agents_config: Dict[str, Any] = Field(default_factory=dict)
+
+
+class AutoGenOutputs(BaseModel):
+    """Outputs from AutoGen multi-agent processing."""
+    success: bool
+    analysis: Dict[str, Any] = Field(default_factory=dict)
+    recommendations: List[str] = Field(default_factory=list)
+    fix_code: Optional[str] = None
+    agent_conversations: List[Dict[str, str]] = Field(default_factory=list)
+    consensus: Optional[str] = None
+    error_message: Optional[str] = None