agentops-cockpit 0.5.0__py3-none-any.whl → 0.9.7__py3-none-any.whl

agent_ops_cockpit/optimizer.py

@@ -1,88 +1,349 @@
-import sys
+from __future__ import annotations
 import os
 import re
-import ast
-from typing import List, Dict
+from typing import List, Dict, Any
 import typer
 from rich.console import Console
 from rich.table import Table
 from rich.panel import Panel
 from rich.syntax import Syntax
+from packaging import version
+
+# Import the evidence bridge
+try:
+    from agent_ops_cockpit.ops.evidence_bridge import get_package_evidence, get_compatibility_report
+except ImportError:
+    # Fallback for local execution
+    try:
+        from backend.ops.evidence_bridge import get_package_evidence, get_compatibility_report
+    except ImportError:
+        # Final fallback
+        def get_package_evidence(pkg): return {}
+        def get_compatibility_report(imports): return []
 
 app = typer.Typer(help="AgentOps Cockpit: The Agent Optimizer CLI")
 console = Console()
 
 class OptimizationIssue:
-    def __init__(self, id: str, title: str, impact: str, savings: str, description: str, diff: str, fix_pattern: str = None):
+    def __init__(self, id: str, title: str, impact: str, savings: str, description: str, diff: str, package: str = None, fix_pattern: str = None):
         self.id = id
         self.title = title
         self.impact = impact
         self.savings = savings
         self.description = description
         self.diff = diff
+        self.package = package
         self.fix_pattern = fix_pattern
+        self.evidence = None
 
-def analyze_code(content: str, file_path: str = "agent.py") -> List[OptimizationIssue]:
+def analyze_code(content: str, file_path: str = "agent.py", versions: Dict[str, str] = None) -> List[OptimizationIssue]:
     issues = []
     content_lower = content.lower()
+    content_no_comments = re.sub(r'#.*', '', content_lower)
+    versions = versions or {}
+
+    # --- SITUATIONAL PLATFORM OPTIMIZATIONS ---
+
+    v_ai = versions.get("google-cloud-aiplatform", "Not Installed")
+    if "google.cloud.aiplatform" in content_lower or "vertexai" in content_lower:
+        if v_ai == "Not Installed":
+             issues.append(OptimizationIssue(
+                "vertex_install", "Install Modern Vertex SDK", "HIGH", "90% cost savings",
+                "You appear to be using Vertex AI logic but the SDK is not in your environment. Install v1.70.0+ to unlock context caching.",
+                "+ # pip install google-cloud-aiplatform>=1.70.0",
+                package="google-cloud-aiplatform"
+            ))
+        elif v_ai != "Unknown":
+            try:
+                if version.parse(v_ai) < version.parse("1.70.0"):
+                     issues.append(OptimizationIssue(
+                        "vertex_legacy_opt", "Situational Performance (Legacy SDK)", "MEDIUM", "20% cost savings",
+                        f"Your SDK ({v_ai}) lacks native Context Caching. Optimize by using selective prompt pruning before execution.",
+                        "+ from agent_ops_cockpit.ops.cost_optimizer import situational_pruning\n+ pruned = situational_pruning(context)",
+                        package="google-cloud-aiplatform"
+                    ))
+                     issues.append(OptimizationIssue(
+                        "vertex_upgrade_path", "Modernization Path", "HIGH", "90% cost savings",
+                        "Upgrading to 1.70.0+ enables near-instant token reuse via CachingConfig.",
+                        "+ # Upgrade to >1.70.0",
+                        package="google-cloud-aiplatform"
+                    ))
+                elif "cache" not in content_lower:
+                    issues.append(OptimizationIssue(
+                        "context_caching", "Enable Context Caching", "HIGH", "90% cost reduction",
+                        "Large model context detected. Use native CachingConfig.",
+                        "+ cache = vertexai.preview.CachingConfig(ttl=3600)",
+                        package="google-cloud-aiplatform"
+                    ))
+            except Exception:
+                pass
+
+    # OpenAI
+    openai_v = versions.get("openai", "Not Installed")
+    if "openai" in content_lower:
+        if openai_v != "Not Installed" and version.parse(openai_v) < version.parse("1.0.0"):
+             issues.append(OptimizationIssue(
+                "openai_legacy", "Found Legacy OpenAI SDK", "HIGH", "40% latency reduction",
+                f"You are on {openai_v}. Transitioning to the v1.0.0+ Client pattern enables modern streaming and improved error handling.",
+                "+ from openai import OpenAI\n+ client = OpenAI()",
+                package="openai"
+            ))
+        elif "prompt_cache" not in content_lower:
+             issues.append(OptimizationIssue(
+                "openai_caching", "OpenAI Prompt Caching", "MEDIUM", "50% latency reduction",
+                "OpenAI automatically caches repeated input prefixes. Ensure your system prompt is first.",
+                "+ # Ensure system prompt is first\n+ messages = [{'role': 'system', ...}]",
+                package="openai"
+            ))
+
+    # Anthropic
+    if ("anthropic" in content_lower or "claude" in content_lower) and "orchestra" not in content_lower:
+        issues.append(OptimizationIssue(
+            "anthropic_orchestration", "Anthropic Orchestration Pattern", "HIGH", "30% reliability boost",
+            "Claude performs best with an Orchestrator-Subagent pattern for complex tasks.",
+            "+ # Use orchestrator to delegate sub-tasks",
+            package="anthropic"
+        ))
+
+    # Microsoft
+    if ("autogen" in content_lower or "microsoft" in content_lower) and "workflow" not in content_lower:
+        issues.append(OptimizationIssue(
+            "ms_workflows", "Microsoft Agent Workflows", "MEDIUM", "40% consistency boost",
+            "Using graph-based repeatable workflows ensures enterprise reliability.",
+            "+ # Define a repeatable graph-based flow",
+            package="pyautogen"
+        ))
+
+    # AWS
+    if ("bedrock" in content_lower or "boto3" in content_lower) and "actiongroup" not in content_lower:
+        issues.append(OptimizationIssue(
+            "aws_action_groups", "AWS Bedrock Action Groups", "HIGH", "50% tool reliability",
+            "Standardize tool execution via Bedrock Action Group schemas.",
+            "+ # Define Bedrock Action Group",
+            package="aws-sdk"
+        ))
+
+    # CopilotKit
+    if "copilotkit" in content_lower and "usecopilotstate" not in content_lower:
+        issues.append(OptimizationIssue(
+            "copilot_state", "CopilotKit Shared State", "MEDIUM", "60% UI responsiveness",
+            "Ensure the Face remains aligned with the Engine via shared state sync.",
+            "+ # Use shared state for UI alignment",
+            package="@copilotkit/react-core"
+        ))
 
-    # --- PLATFORM SPECIFIC OPTIMIZATIONS ---
+    # Routing
+    if "pro" in content_lower and "flash" not in content_lower:
+        issues.append(OptimizationIssue(
+            "model_routing", "Smart Model Routing", "HIGH", "70% cost savings",
+            "Route simple queries to Flash models to minimize consumption.",
+            "+ if is_simple(q): model = 'gemini-1.5-flash'",
+            package="google-cloud-aiplatform"
+        ))
+
+    # Infrastructure (Cloud Run + GKE)
+    if "cloud run" in content_lower and "cpu_boost" not in content_lower:
+        issues.append(OptimizationIssue(
+            "cr_startup_boost", "Cloud Run Startup Boost", "HIGH", "50% latency reduction",
+            "Enable Startup CPU Boost to reduce cold-start latency for Python agents.",
+            "+ startup_cpu_boost: true",
+            package="google-cloud-run"
+        ))
+    if ("gke" in content_lower or "kubernetes" in content_lower) and "identity" not in content_lower:
+        issues.append(OptimizationIssue(
+            "gke_identity", "GKE Workload Identity", "HIGH", "100% security baseline",
+            "Use Workload Identity for secure service-to-service communication.",
+            "+ # Use Workload Identity",
+            package="google-cloud-gke"
+        ))
 
-    # Check for OpenAI Prompt Caching
-    if "openai" in content_lower and "prompt_cache" not in content_lower:
+    # Language Specific (Go + Node)
+    if file_path.endswith(".go") and "goroutine" not in content_lower:
+        issues.append(OptimizationIssue(
+            "go_concurrency", "Go Native Concurrency", "HIGH", "80% throughput boost",
+            "Leveraging Goroutines for parallel tool execution is a Go best practice.",
+            "+ go func() { tool.execute() }()",
+            package="golang"
+        ))
+    if (file_path.endswith(".ts") or file_path.endswith(".js") or "axios" in content_lower) and "fetch" not in content_lower:
         issues.append(OptimizationIssue(
-            "openai_caching",
-            "OpenAI Prompt Caching",
-            "MEDIUM",
-            "50% latency reduction",
-            "OpenAI automatically caches repeated input prefixes. Ensure your system prompt is at the beginning of the message list.",
-            "+ # Ensure system prompt is first and static for optimal caching\n+ messages = [{'role': 'system', 'content': SYSTEM_PROMPT}, ...]",
-            fix_pattern="# [Cockpit Fix] Optimize OpenAI Caching\n"
+            "node_native_fetch", "Native Fetch API", "MEDIUM", "20% bundle reduction",
+            "Node 20+ supports native fetch, reducing dependency on heavy libraries like axios.",
+            "+ const res = await fetch(url);",
+            package="nodejs"
         ))
 
-    # Check for large system instructions
-    large_string_pattern = re.compile(r'"""[\s\S]{200,}"""|\'\'\'[\s\S]{200,}\'\'\'')
-    if large_string_pattern.search(content) and "cache" not in content_lower:
+    lg_v = versions.get("langgraph", "Not Installed")
+    if "langgraph" in content_lower:
+        if lg_v != "Not Installed" and lg_v != "Unknown":
+            try:
+                if version.parse(lg_v) < version.parse("0.1.0"):
+                     issues.append(OptimizationIssue(
+                        "langgraph_legacy", "Situational Stability (Legacy LangGraph)", "HIGH", "Stability Boost",
+                        f"You are on {lg_v}. Older versions lack the hardened StateGraph compilation. Upgrade is recommended.",
+                        "+ # Consider upgrading for better persistence",
+                        package="langgraph"
+                    ))
+            except Exception:
+                pass
+        
+        if "persistence" not in content_lower and "checkpointer" not in content_lower:
+            issues.append(OptimizationIssue(
+                "langgraph_persistence", "LangGraph Persistence", "HIGH", "100% state recovery",
+                "A checkpointer is mandatory for reliable long-running agents.",
+                "+ graph.compile(checkpointer=checkpointer)",
+                package="langgraph"
+            ))
+        if "recursion" not in content_lower:
+            issues.append(OptimizationIssue(
+                "langgraph_recursion", "Recursion Limits", "MEDIUM", "Safety Guardrail",
+                "Set recursion limits to prevent expensive infinite loops in cyclic graphs.",
+                "+ graph.invoke(..., config={'recursion_limit': 50})",
+                package="langgraph"
+            ))
+
+    # --- ARCHITECTURAL OPTIMIZATIONS ---
+
+    # Large system instructions (individual docstrings > 200 chars)
+    docstrings = re.findall(r'"""([\s\S]*?)"""|\'\'\'([\s\S]*?)\'\'\'', content)
+    has_large_prompt = any(len(d[0] or d[1]) > 200 for d in docstrings)
+    
+    if has_large_prompt and "cache" not in content_lower:
         issues.append(OptimizationIssue(
-            "context_caching",
-            "Enable Context Caching",
-            "HIGH",
-            "90% cost reduction on reuse",
-            "Large static system instructions detected. Using context caching (Gemini/Anthropic) prevents redundant token processing.",
-            "+ cache = vertexai.preview.CachingConfig(ttl=3600)\n+ model = GenerativeModel('gemini-1.5-pro', caching_config=cache)",
-            fix_pattern="# [Cockpit Fix] Vertex AI Context Caching enabled\n"
+            "context_caching", "Enable Context Caching", "HIGH", "90% cost reduction",
+            "Large static system instructions detected. Use context caching.",
+            "+ cache = vertexai.preview.CachingConfig(ttl=3600)",
+            package="google-cloud-aiplatform"
         ))
 
-    # Check for missing semantic cache
+    # Missing semantic cache
     if "hive_mind" not in content_lower and "cache" not in content_lower:
          issues.append(OptimizationIssue(
-            "semantic_caching",
-            "Implement Semantic Caching",
-            "HIGH",
-            "40-60% cost savings",
-            "No caching layer detected. Adding a semantic cache (Hive Mind) can significantly reduce LLM calls for repeated queries.",
-            "+ @hive_mind(cache=global_cache)\n  async def chat(q: str): ...",
-            fix_pattern="# [Cockpit Fix] Hive Mind Semantic Caching integrated\n"
+            "semantic_caching", "Implement Semantic Caching", "HIGH", "40-60% savings",
+            "No caching layer detected. Adding a semantic cache reduces LLM costs.",
+            "+ @hive_mind(cache=global_cache)",
+            package="google-adk"
         ))
 
+    # --- BEST PRACTICE OPTIMIZATIONS ---
+
+    # Prompt Externalization
+    if has_large_prompt:
+        issues.append(OptimizationIssue(
+            "external_prompts", "Externalize System Prompts", "MEDIUM", "Architectural Debt Reduction",
+            "Keeping large system prompts in code makes them hard to version and test. Move them to 'system_prompt.md' and load dynamically.",
+            "+ with open('system_prompt.md', 'r') as f:\n+     SYSTEM_PROMPT = f.read()"
+        ))
+
+    # Resiliency / Retries
+    if "retry" not in content_lower and "tenacity" not in content_lower:
+        issues.append(OptimizationIssue(
+            "resiliency_retries", "Implement Exponential Backoff", "HIGH", "99.9% Reliability",
+            "Your agent calls external APIs/DBs but has no retry logic. Use 'tenacity' to handle transient failures.",
+            "+ @retry(wait=wait_exponential(multiplier=1, min=4, max=10), stop=stop_after_attempt(3))",
+            package="tenacity"
+        ))
+
+    # Session Management
+    if "session" not in content_lower and "conversation_id" not in content_lower:
+         issues.append(OptimizationIssue(
+            "session_management", "Add Session Tracking", "MEDIUM", "User Continuity",
+            "No session tracking detected. Agents in production need a 'conversation_id' to maintain multi-turn context.",
+            "+ def chat(q: str, conversation_id: str = None):"
+        ))
+
+    # Pinecone Optimization
+    if "pinecone" in content_lower:
+        if "grpc" not in content_lower:
+            issues.append(OptimizationIssue(
+                "pinecone_grpc", "Pinecone High-Perf (gRPC)", "MEDIUM", "40% latency reduction",
+                "You are using the standard Pinecone client. Switching to pinecone[grpc] enables low-latency streaming for large vector retrievals.",
+                "+ from pinecone.grpc import PineconeGRPC as Pinecone\n+ pc = Pinecone(api_key='...')"
+            ))
+        if "namespace" not in content_lower:
+            issues.append(OptimizationIssue(
+                "pinecone_isolation", "Pinecone Namespace Isolation", "MEDIUM", "RAG Accuracy Boost",
+                "No namespaces detected. Use namespaces to isolate user data or document segments for more accurate retrieval.",
+                "+ index.query(..., namespace='customer-a')"
+            ))
+
+    # Google Cloud Database Optimizations
+    
+    # AlloyDB
+    if "alloydb" in content_no_comments:
+        if "columnar" not in content_no_comments:
+            issues.append(OptimizationIssue(
+                "alloydb_columnar", "AlloyDB Columnar Engine", "HIGH", "100x Query Speedup",
+                "AlloyDB detected. Enable the Columnar Engine for analytical and AI-driven vector queries.",
+                "+ # Enable AlloyDB Columnar Engine for vector scaling"
+            ))
+            
+    # BigQuery
+    if "bigquery" in content_no_comments or "bq" in content_no_comments:
+        if "vector_search" not in content_no_comments:
+            issues.append(OptimizationIssue(
+                "bq_vector_search", "BigQuery Vector Search", "HIGH", "FinOps: Serverless RAG",
+                "BigQuery detected. Use BQ Vector Search for cost-effective RAG over massive datasets without moving data to a separate DB.",
+                "+ SELECT * FROM VECTOR_SEARCH(TABLE my_dataset.embeddings, ...)"
+            ))
+
+    # Cloud SQL
+    if "cloudsql" in content_lower or "psycopg2" in content_lower or "sqlalchemy" in content_lower:
+        if "cloud-sql-connector" not in content_lower:
+            issues.append(OptimizationIssue(
+                "cloudsql_connector", "Cloud SQL Python Connector", "MEDIUM", "100% Secure Auth",
+                "Using raw drivers detected. Use the official Cloud SQL Python Connector for IAM-based authentication and automatic encryption.",
+                "+ from google.cloud.sql.connector import Connector\n+ connector = Connector()"
+            ))
+
+    # Firestore
+    if "firestore" in content_lower:
+        if "vector" not in content_lower:
+            issues.append(OptimizationIssue(
+                "firestore_vector", "Firestore Vector Search (Native)", "HIGH", "Real-time RAG",
+                "Firestore detected. Use native Vector Search and KNN queries for high-concurrency mobile/web agent retrieval.",
+                "+ collection.find_nearest(vector_field='embedding', ...)"
+            ))
+
+    # Oracle OCI Optimizations
+    if "oci" in content_lower or "oracle" in content_lower:
+        if "resource_principal" not in content_lower:
+            issues.append(OptimizationIssue(
+                "oci_auth", "OCI Resource Principals", "HIGH", "100% Secure Auth",
+                "Using static config/keys detected on OCI. Use Resource Principals for secure, credential-less access from OCI compute.",
+                "+ auth = oci.auth.signers.get_resource_principals_signer()"
+            ))
+
+    # CrewAI Optimizations
+    if "crewai" in content_lower or "crew(" in content_lower:
+        if "manager_agent" not in content_lower and "hierarchical" not in content_lower:
+             issues.append(OptimizationIssue(
+                "crewai_manager", "Use Hierarchical Manager", "MEDIUM", "30% Coordination Boost",
+                "Your crew uses sequential execution. For complex tasks, a Manager Agent improves task handoffs and reasoning.",
+                "+ crew = Crew(..., process=Process.hierarchical, manager_agent=manager)"
+            ))
+
     return issues
 
 def estimate_savings(token_count: int, issues: List[OptimizationIssue]) -> Dict[str, Any]:
-    """
-    Step 5: FinOps Integration. Calculate literal dollar-amount projection.
-    """
-    # Baseline: $10 per 1M tokens (mixed input/output)
     baseline_cost_per_m = 10.0
     monthly_requests = 10000 
     current_cost = (token_count / 1_000_000) * baseline_cost_per_m * monthly_requests
     
     total_savings_pct = 0.0
     for issue in issues:
-        if "90%" in issue.savings: total_savings_pct += 0.4 # Cumulative weighted
-        if "50%" in issue.savings: total_savings_pct += 0.2
-        if "40-60%" in issue.savings: total_savings_pct += 0.25
+        if "90%" in issue.savings:
+            total_savings_pct += 0.45  # Context Caching / Modern SDK
+        elif "70%" in issue.savings:
+            total_savings_pct += 0.35  # Smart Routing (Pro -> Flash)
+        elif "50%" in issue.savings:
+            total_savings_pct += 0.20  # Infrastructure / Startup Boost
+        elif "40-60%" in issue.savings:
+            total_savings_pct += 0.25  # Semantic Caching (Hive Mind)
+        else:
+            total_savings_pct += 0.05  # Standard Best Practices
 
-    projected_savings = current_cost * min(total_savings_pct, 0.8) # Cap at 80%
+    projected_savings = current_cost * min(total_savings_pct, 0.85)
     
     return {
         "current_monthly": current_cost,
@@ -94,34 +355,80 @@ def estimate_savings(token_count: int, issues: List[OptimizationIssue]) -> Dict[
 def audit(
     file_path: str = typer.Argument("agent.py", help="Path to the agent code to audit"),
     interactive: bool = typer.Option(True, "--interactive/--no-interactive", "-i", help="Run in interactive mode"),
-    apply_fix: bool = typer.Option(False, "--apply", "--fix", help="Automatically apply recommended fixes")
+    apply_fix: bool = typer.Option(False, "--apply", "--fix", help="Automatically apply recommended fixes"),
+    quick: bool = typer.Option(False, "--quick", "-q", help="Skip live evidence fetching for faster execution")
 ):
-    """
-    Audits agent code and proposes cost/perf/FinOps optimizations.
-    """
     console.print(Panel.fit("🔍 [bold blue]GCP AGENT OPS: OPTIMIZER AUDIT[/bold blue]", border_style="blue"))
-    console.print(f"Target: [yellow]{file_path}[/yellow]")
-    
     if not os.path.exists(file_path):
-        console.print(f"❌ [red]Error: File {file_path} not found.[/red]")
+        console.print(f"❌ [red]Error: Path {file_path} not found.[/red]")
         raise typer.Exit(1)
 
+    # If it's a directory, try to find the agent entry point
+    if os.path.isdir(file_path):
+        found = False
+        for entry in ["agent.py", "main.py", "app.py"]:
+            candidate = os.path.join(file_path, entry)
+            if os.path.exists(candidate):
+                file_path = candidate
+                found = True
+                break
+        if not found:
+            # Look for any .py file if common names aren't found
+            for root, dirs, files in os.walk(file_path):
+                # Prune excluded directories for performance
+                dirs[:] = [d for d in dirs if d not in [".venv", "node_modules", ".git", "__pycache__", "dist", "build"]]
+                
+                for f in files:
+                    if f.endswith(".py") and f != "__init__.py":
+                        file_path = os.path.join(root, f)
+                        found = True
+                        break
+                if found: break
+        
+        if not found:
+            console.print(f"❌ [red]Error: No python entry point found in {file_path}[/red]")
+            raise typer.Exit(1)
+
+    console.print(f"Target: [yellow]{file_path}[/yellow]")
+
     with open(file_path, 'r') as f:
         content = f.read()
     
+    # Heuristic: Find all imported packages
+    imports = re.findall(r"(?:from|import)\s+([\w\.-]+)", content)
+    
+    from agent_ops_cockpit.ops.evidence_bridge import get_installed_version
+    package_versions = { pkg: get_installed_version(pkg) for pkg in ["google-cloud-aiplatform", "openai", "anthropic", "langgraph", "crewai"] }
+    
     token_estimate = len(content.split()) * 1.5 
     console.print(f"📊 Token Metrics: ~[bold]{token_estimate:.0f}[/bold] prompt tokens detected.")
     
-    with console.status("[bold green]Running heuristic analysis..."):
-        issues = analyze_code(content, file_path)
-        import time
-        time.sleep(1)
+    issues = analyze_code(content, file_path, versions=package_versions)
+    # Inject live evidence (skip in quick mode)
+    if not quick:
+        for issue in issues:
+            if issue.package:
+                issue.evidence = get_package_evidence(issue.package)
+
+    # --- CROSS-PACKAGE VALIDATION ---
+    comp_reports = get_compatibility_report(imports)
+    
+    if comp_reports:
+        console.print("\n[bold yellow]🧩 Cross-Package Validation:[/bold yellow]")
+        for report in comp_reports:
+            if report["type"] == "INCOMPATIBLE":
+                console.print(f"❌ [bold red]Conflict Detected:[/bold red] {report['component']} + {report['conflict_with']}")
+                console.print(f"   [dim]{report['reason']}[/dim]")
+            elif report["type"] == "SYNERGY":
+                console.print(f"✅ [bold green]Synergy Verified:[/bold green] {report['component']} is optimally paired.")
 
     if not issues:
-        console.print("\n[bold green]✅ No immediate optimization opportunities found. Your agent is lean![/bold green]")
-        return
+        console.print("\n[bold green]✅ No immediate code-level optimizations found. Your agent is lean![/bold green]")
+        if not comp_reports:
+             return
+        else:
+             raise typer.Exit(0)
 
-    # Step 5: FinOps Report
     savings = estimate_savings(token_estimate, issues)
     finops_panel = Panel(
         f"💰 [bold]FinOps Projection (Est. 10k req/mo)[/bold]\n"
@@ -141,15 +448,39 @@ def audit(
         console.print(f"\n[bold white on blue] --- [{opt.impact} IMPACT] {opt.title} --- [/bold white on blue]")
         console.print(f"Benefit: [green]{opt.savings}[/green]")
         console.print(f"Reason: {opt.description}")
-        console.print("\nProposed Change:")
+        
+        if opt.evidence and "error" not in opt.evidence:
+            ev = opt.evidence
+            ev_title = "[dim]SDK Citation & Evidence[/dim]"
+            
+            # Highlight if an upgrade is required for maximum efficiency
+            if ev.get("upgrade_required"):
+                console.print("🚨 [bold yellow]URGENT UPGRADE RECOMMENDED[/bold yellow]")
+                console.print(f"   Current: {ev['installed_version']} | Required for optimization: >={ev['min_optimized_version']}")
+                ev_title = "[bold red]UPGRADE REQUIRED Evidence[/bold red]"
+
+            ev_panel = Panel(
+                f"🔗 [bold]Source[/bold]: {ev['source_url']}\n"
+                f"📅 [bold]Latest Release[/bold]: {ev['release_date'][:10]}\n"
+                f"📝 [bold]Note[/bold]: {ev['best_practice_context']}",
+                title=ev_title,
+                border_style="red" if ev.get("upgrade_required") else "dim"
+            )
+            console.print(ev_panel)
+            # Orchestrator parsing
+            console.print(f"SOURCE: {opt.title} | {ev['source_url']} | {ev['best_practice_context'].replace('\\n', ' ')}")
+
         syntax = Syntax(opt.diff, "python", theme="monokai", line_numbers=False)
         console.print(syntax)
         
+        # Output ACTION: for report generation
+        console.print(f"ACTION: {file_path}:1 | Optimization: {opt.title} | {opt.description} (Est. {opt.savings})")
+        
         do_apply = False
         if apply_fix:
             do_apply = True
         elif interactive:
-            do_apply = typer.confirm("\nDo you want to apply this optimization?", default=True)
+            do_apply = typer.confirm("\nDo you want to apply this code-level optimization?", default=True)
         
         if do_apply:
             console.print("✅ [APPROVED] applying fix...")
@@ -164,7 +495,6 @@ def audit(
         with open(file_path, 'w') as f:
             f.write(fixed_content)
         console.print(f"\n✨ [bold green]Applied {applied} optimizations to {file_path}![/bold green]")
-        console.print("🚀 Run 'agent-ops report' to verify the new architecture score.")
     
     summary_table = Table(title="🎯 AUDIT SUMMARY")
     summary_table.add_column("Category", style="cyan")
@@ -173,5 +503,10 @@ def audit(
     summary_table.add_row("Optimizations Rejected", str(rejected))
     console.print(summary_table)
 
+    # CI/CD Enforcement: Fail if high-impact issues remain in non-interactive mode
+    if not interactive and any(opt.impact == "HIGH" for opt in issues):
+        console.print("\n[bold red]❌ HIGH IMPACT issues detected. Optimization required for production.[/bold red]")
+        raise typer.Exit(code=1)
+
 if __name__ == "__main__":
     app()

agent_ops_cockpit/shadow/router.py

@@ -1,7 +1,8 @@
 import asyncio
 import json
 import uuid
-from typing import Dict, Any, Callable
+import os
+from typing import Any, Callable
 from datetime import datetime
 
 class ShadowRouter:
@@ -13,17 +14,17 @@ class ShadowRouter:
         self.v1 = v1_func
         self.v2 = v2_func
 
-    async def route(self, query: str, context: Dict[str, Any] = None):
+    async def route(self, query: str, **kwargs):
         trace_id = str(uuid.uuid4())
         
         # 1. Primary Call (Production v1) - Sequential/Blocking
         start_v1 = datetime.now()
-        v1_resp = await self.v1(query, context)
+        v1_resp = await self.v1(query, **kwargs)
         v1_latency = (datetime.now() - start_v1).total_seconds()
 
         # 2. Shadow Call (Experimental v2) - Asynchronous/Non-blocking
         # We fire and forget this, or use a background task
-        asyncio.create_task(self._run_shadow(trace_id, query, context, v1_resp, v1_latency))
+        asyncio.create_task(self._run_shadow(trace_id, query, v1_resp, v1_latency, **kwargs))
 
         return {
             "response": v1_resp,
@@ -31,14 +32,14 @@ class ShadowRouter:
             "latency": v1_latency
         }
 
-    async def _run_shadow(self, trace_id: str, query: str, context: Dict[str, Any], v1_resp: Any, v1_latency: float):
+    async def _run_shadow(self, trace_id: str, query: str, v1_resp: Any, v1_latency: float, **kwargs):
         """
         Runs the v2 agent in the 'shadow' without user impact.
         Logs the comparison to BigQuery/Cloud Logging.
         """
         try:
             start_v2 = datetime.now()
-            v2_resp = await self.v2(query, context)
+            v2_resp = await self.v2(query, **kwargs)
             v2_latency = (datetime.now() - start_v2).total_seconds()
 
             comparison = {
@@ -71,5 +72,3 @@ class ShadowRouter:
         os.makedirs("traces", exist_ok=True)
         with open(f"traces/{data['traceId']}.json", "w") as f:
             json.dump(data, f)
-
-import os

agent_ops_cockpit/system_prompt.md

@@ -0,0 +1,13 @@
+# 🕹️ AgentOps Cockpit: System Persona
+
+You are a professional **Google Well-Architected Agent Orchestrator**. 
+Your primary goal is to assist users in building, optimizing, and securing AI agents on Google Cloud.
+
+## 🛡️ Core Directives:
+1. **Safety First**: Always check for PII leakage and prompt injection before executing logic.
+2. **Operations-Aware**: Frame your responses within the context of the Engine, Face, and Cockpit.
+3. **Structured Recovery**: If a tool fails, suggest a retry strategy with exponential backoff.
+4. **Efficiency**: Use semantic caching whenever possible to reduce token overhead.
+
+## 📡 Output Standard:
+Follow the **A2UI Protocol**. Always return structured JSON that the Face can render.