Full Stack Debug Agent

A complete autonomous debugging system that can diagnose and fix issues across your entire application stack. WHAT IT DEBUGS: 🖥️ FRONTEND: • React/Vue/Svelte rendering issues and hydration errors • CSS layout bugs (flexbox, grid, overflow, z-index) • JavaScript runtime errors with source map resolution • Browser compatibility issues • Performance bottlenecks (bundle size, render cycles, memory) • Accessibility violations (WCAG 2.1 AA) ⚙️ BACKEND: • API endpoint failures (status codes, timeouts, CORS) • Authentication/authorization bugs • Request/response payload mismatches • Middleware chain issues • Race conditions in async code • Memory leaks in long-running processes • N+1 query detection 🗄️ DATABASE: • Slow query identification with EXPLAIN ANALYZE • Missing index detection • Deadlock analysis • Connection pool exhaustion • Schema migration conflicts • Data integrity violations 🏗️ INFRASTRUCTURE: • Docker container health issues • Environment variable misconfigurations • Port conflicts and networking issues • SSL/TLS certificate problems • DNS resolution failures • Disk space and resource limits INCLUDED FILES: ``` full-stack-debug-agent/ ├── agent.py # Main debug agent (Python) ├── agent.ts # TypeScript version ├── analyzers/ │ ├── frontend.py # Frontend error analyzer │ ├── backend.py # Backend log analyzer │ ├── database.py # Query performance analyzer │ ├── infra.py # Infrastructure checker │ └── security.py # Security vulnerability scanner ├── fixers/ │ ├── auto_fix.py # Automatic fix generator │ ├── patch_creator.py # Creates git patches for fixes │ └── rollback.py # Safe rollback mechanism ├── reporters/ │ ├── terminal.py # Terminal output (colored) │ ├── json_report.py # Structured JSON report │ ├── markdown_report.py # Human-readable Markdown │ └── slack_webhook.py # Slack notification ├── config/ │ ├── default.yaml # Default configuration │ └── rules/ # Custom debugging rules ├── tests/ │ ├── test_frontend.py │ ├── test_backend.py │ ├── test_database.py │ └── test_infra.py ├── requirements.txt ├── package.json └── README.md ``` USAGE: ```bash # Install pip install -r requirements.txt # Debug entire stack python agent.py --project /path/to/project --full-scan # Debug specific layer python agent.py --project /path/to/project --layer backend --verbose # Auto-fix mode (generates patches) python agent.py --project /path/to/project --auto-fix --dry-run # CI/CD integration python agent.py --project . --ci --fail-on-critical --output report.json ``` SAMPLE OUTPUT: ``` 🔍 Full Stack Debug Report ━━━━━━━━━━━━━━━━━━━━━━━━━ CRITICAL (2): ❌ SQL injection in /api/users endpoint (backend.py:47) → Fix: Use parameterized query instead of string concatenation ❌ Missing rate limit on /auth/login (security) → Fix: Add rate limiter middleware (patch generated) WARNING (5): ⚠️ N+1 query in UserList component (3 extra queries per render) ⚠️ Bundle size 2.1MB — tree-shaking could reduce to 890KB ⚠️ Missing index on users.email (full table scan on login) ⚠️ React key prop missing in ProductList map() ⚠️ Unhandled promise rejection in paymentService.ts:89 INFO (3): ℹ️ Docker image can be reduced from 1.2GB to 340MB with multi-stage build ℹ️ Consider connection pooling — current max_connections: 5 ℹ️ 3 unused dependencies detected: lodash, moment, uuid ``` Every analyzer is a real, functional Python module. Not wrappers or stubs.