Feature/cgai 12 base agent analysis context

[Yosoyepa]

Descripción

Implementa las clases base que serán heredadas por todos los agentes especializados.
Incluye BaseAgent como clase abstracta y esquemas para AnalysisContext y Finding.

Historia de Usuario Relacionada

Closes #CGAI-12 (BaseAgent y AnalysisContext en Dominio)

🧪 Testing

• Tests unitarios creados para BaseAgent (10 tests)
• Tests unitarios creados para AnalysisContext (9 tests)
• Tests unitarios creados para Finding (8 tests)
• Cobertura de código: 85%+ ✅
• Todos los tests pasan localmente
• Pylint score: 8.7/10 ✅

✅ Checklist de Calidad

• He seguido las convenciones de commits (Conventional Commits)
• He agregado tests que prueban mis cambios
• Todos los tests pasan localmente (pytest)
• He formatado el código con Black e isort
• Pylint score >= 8.5/10
• Coverage >= 75%
• He actualizado la documentación (docstrings)
• Mi código no tiene linting warnings
• He hecho rebase con develop
• Sin conflictos con rama base

📸 Cambios Realizados

• ✅ backend/src/agents/base_agent.py: Clase abstracta BaseAgent
• ✅ backend/src/schemas/analysis.py: AnalysisContext, AnalysisRequest
• ✅ backend/src/schemas/finding.py: Finding, Severity, propiedades
• ✅ backend/tests/unit/test_base_agent.py: 10 tests
• ✅ backend/tests/unit/test_analysis_schemas.py: 27 tests

🔗 Related Issues

Closes #12

📚 Notas Adicionales

• BaseAgent implementa patrón Template Method
• AnalysisContext valida que sean archivos .py
• Finding tiene 5 propiedades computadas
• Todos los docstrings en formato Google-style

[Copilot]

Pull Request Overview

This PR implements core analysis schemas and base agent infrastructure for a code analysis system. The changes introduce Pydantic v2 models for analysis contexts, findings, and agent abstractions, along with comprehensive unit tests and a code quality automation script.

• Adds AnalysisContext, AnalysisRequest, and AnalysisResponse schemas for managing code analysis workflows
• Implements Finding schema with severity levels and utility methods for tracking code issues
• Creates abstract BaseAgent class providing event publishing, logging, and lifecycle management for analysis agents

Reviewed Changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
backend/src/schemas/analysis.py	Defines Pydantic models for analysis context with code parsing utilities, AST caching, and request/response schemas
backend/src/schemas/finding.py	Implements Finding model with severity enum, validation, and serialization methods for code issue tracking
backend/src/agents/base_agent.py	Provides abstract base class for analysis agents with event bus integration, logging helpers, and lifecycle methods
backend/tests/unit/test_analysis_schemas.py	Comprehensive unit tests covering validation, properties, and metadata handling for analysis schemas
backend/tests/unit/agents/test_base_agent.py	Tests for BaseAgent initialization, state management, event emission, and string representations
backend/fix_code_quality.sh	Shell script to automate code formatting with black, import sorting with isort, and linting with pylint
backend/tests/unit/test_main.py	Adds blank line after module docstring for style consistency
backend/tests/conftest.py	Adds blank line after module docstring for style consistency

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[jpastor1649]

Code has been reviewed. Please check the comments about potential improvements, such as better error handling and adding exit codes to ensure the script stops if a command fails. Consider also reviewing suggestions for using PrivateAttr() in Pydantic v2 to handle internal cache attributes more safely.

[jpastor1649]

PR approved