@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/es/Python/commands/check-testing.md

@@ -0,0 +1,184 @@
+---
+description: Verificar Pruebas Python
+argument-hint: [arguments]
+---
+
+# Verificar Pruebas Python
+
+## Argumentos
+
+$ARGUMENTS (opcional: ruta al proyecto a analizar)
+
+## MISIÓN
+
+Realizar una auditoría completa de la estrategia de pruebas del proyecto Python verificando cobertura, calidad de pruebas y cumplimiento de mejores prácticas definidas en las reglas del proyecto.
+
+### Paso 1: Estructura y Organización de Pruebas
+
+Examinar organización de pruebas:
+- [ ] Carpeta `tests/` en raíz del proyecto
+- [ ] Estructura espejo del código fuente (tests/domain, tests/application, etc.)
+- [ ] Archivos de prueba nombrados `test_*.py` o `*_test.py`
+- [ ] Fixtures de pytest en `conftest.py`
+- [ ] Separación de pruebas unit / integration / e2e
+
+**Referencia**: `rules/07-testing.md` sección "Organización de Pruebas"
+
+### Paso 2: Cobertura de Código
+
+Medir cobertura de pruebas:
+- [ ] Cobertura general ≥ 80%
+- [ ] Cobertura Capa de Dominio ≥ 90%
+- [ ] Cobertura Capa de Aplicación ≥ 85%
+- [ ] Archivos críticos al 100%
+- [ ] Configuración de cobertura en pyproject.toml
+
+**Comando**: Ejecutar `docker run --rm -v $(pwd):/app python:3.11 sh -c "pip install pytest pytest-cov && pytest /app --cov=/app --cov-report=term-missing"`
+
+**Referencia**: `rules/07-testing.md` sección "Cobertura de Código"
+
+### Paso 3: Pruebas Unitarias
+
+Analizar calidad de pruebas unitarias:
+- [ ] Pruebas aisladas (sin dependencias externas)
+- [ ] Uso de mocks/stubs para dependencias
+- [ ] Pruebas rápidas (<100ms por prueba)
+- [ ] Una prueba = Un comportamiento
+- [ ] Nomenclatura descriptiva: `test_should_X_when_Y`
+- [ ] Patrón AAA (Arrange, Act, Assert)
+
+**Referencia**: `rules/07-testing.md` sección "Pruebas Unitarias"
+
+### Paso 4: Pruebas de Integración
+
+Verificar pruebas de integración:
+- [ ] Pruebas de interacciones entre componentes
+- [ ] Pruebas de capa de Infraestructura (BD, API, etc.)
+- [ ] Uso de bases de datos de prueba (fixtures)
+- [ ] Limpieza después de cada prueba (teardown)
+- [ ] Pruebas aisladas e independientes
+
+**Referencia**: `rules/07-testing.md` sección "Pruebas de Integración"
+
+### Paso 5: Aserciones y Calidad de Pruebas
+
+Verificar calidad de aserciones:
+- [ ] Aserciones explícitas y específicas
+- [ ] Sin múltiples aserciones no relacionadas
+- [ ] Mensajes de error claros
+- [ ] Pruebas de casos extremos
+- [ ] Pruebas de errores y excepciones
+- [ ] Sin pruebas deshabilitadas sin razón (skip/xfail)
+
+**Referencia**: `rules/07-testing.md` sección "Aserciones y Calidad de Pruebas"
+
+### Paso 6: Fixtures y Parametrización
+
+Evaluar uso de fixtures de pytest:
+- [ ] Fixtures para setup/teardown común
+- [ ] Ámbito apropiado (function, class, module, session)
+- [ ] Parametrización con `@pytest.mark.parametrize`
+- [ ] Factories para objetos de prueba complejos
+- [ ] Sin duplicación en fixtures
+
+**Referencia**: `rules/07-testing.md` sección "Fixtures de Pytest"
+
+### Paso 7: Rendimiento y Ejecución
+
+Analizar rendimiento de pruebas:
+- [ ] Tiempo total de ejecución <30 segundos (pruebas unitarias)
+- [ ] Pruebas paralelizables (pytest-xdist)
+- [ ] Sin sleep() en pruebas
+- [ ] Configuración de pytest en pyproject.toml
+- [ ] CI/CD con ejecución automática de pruebas
+
+**Comando**: Ejecutar `docker run --rm -v $(pwd):/app python:3.11 sh -c "pip install pytest && pytest /app -v --duration=10"`
+
+**Referencia**: `rules/07-testing.md` sección "Rendimiento de Pruebas"
+
+### Paso 8: Test-Driven Development (TDD)
+
+Verificar adopción de TDD:
+- [ ] Pruebas escritas antes del código (si aplica)
+- [ ] Ciclo Red-Green-Refactor
+- [ ] Pruebas guiando el diseño
+- [ ] Sin código sin probar en producción
+
+**Referencia**: `rules/01-workflow-analysis.md` sección "Flujo de Trabajo TDD"
+
+### Paso 9: Calcular Puntuación
+
+Atribución de puntos (sobre 25):
+- Cobertura de código: 7 puntos
+- Pruebas unitarias: 6 puntos
+- Pruebas de integración: 4 puntos
+- Calidad de aserciones: 3 puntos
+- Fixtures y organización: 3 puntos
+- Rendimiento: 2 puntos
+
+## FORMATO DE SALIDA
+
+```
+AUDITORÍA DE PRUEBAS PYTHON
+================================
+
+PUNTUACIÓN GENERAL: XX/25
+
+FORTALEZAS:
+- [Lista de buenas prácticas de pruebas observadas]
+
+MEJORAS:
+- [Lista de mejoras menores]
+
+PROBLEMAS CRÍTICOS:
+- [Lista de brechas críticas en pruebas]
+
+DETALLES POR CATEGORÍA:
+
+1. COBERTURA (XX/7)
+   Estado: [Análisis de cobertura]
+   Cobertura General: XX%
+   Dominio: XX%
+   Aplicación: XX%
+   Infraestructura: XX%
+
+2. PRUEBAS UNITARIAS (XX/6)
+   Estado: [Calidad de pruebas unitarias]
+   Número de Pruebas: XX
+   Pruebas Aisladas: XX%
+   Tiempo Promedio: XXms
+
+3. PRUEBAS DE INTEGRACIÓN (XX/4)
+   Estado: [Pruebas de integración]
+   Número de Pruebas: XX
+   Cobertura de Infraestructura: XX%
+
+4. ASERCIONES (XX/3)
+   Estado: [Calidad de aserciones]
+   Aserciones Específicas: XX%
+   Pruebas de Casos Extremos: XX
+
+5. FIXTURES (XX/3)
+   Estado: [Organización y fixtures]
+   Fixtures Reutilizables: XX
+   Pruebas Parametrizadas: XX
+
+6. RENDIMIENTO (XX/2)
+   Estado: [Rendimiento de pruebas]
+   Tiempo Total: XXs
+   Pruebas >1s: XX
+
+TOP 3 ACCIONES PRIORITARIAS:
+1. [Acción más crítica para mejorar pruebas]
+2. [Segunda acción prioritaria]
+3. [Tercera acción prioritaria]
+```
+
+## NOTAS
+
+- Ejecutar pytest con cobertura para obtener métricas
+- Usar Docker para abstraerse del entorno local
+- Identificar archivos críticos sin pruebas
+- Proponer pruebas faltantes para funcionalidades clave
+- Sugerir mejoras concretas para pruebas existentes
+- Priorizar pruebas según riesgo de negocio

package/Dev/i18n/es/Python/commands/dependency-audit.md

@@ -0,0 +1,198 @@
+---
+description: Auditoría de Dependencias Python
+argument-hint: [arguments]
+---
+
+# Auditoría de Dependencias Python
+
+Eres un experto en seguridad de Python. Debes auditar las dependencias del proyecto para identificar vulnerabilidades, paquetes obsoletos y problemas de licencias.
+
+## Argumentos
+$ARGUMENTS
+
+Argumentos:
+- (Opcional) Enfoque: security, outdated, licenses, all
+
+Ejemplo: `/python:dependency-audit security` o `/python:dependency-audit all`
+
+## MISIÓN
+
+### Paso 1: Identificar Configuración
+
+```bash
+# Archivos de dependencias posibles
+ls -la requirements*.txt pyproject.toml setup.py Pipfile poetry.lock
+
+# Listar dependencias instaladas
+pip list --format=json
+pip freeze
+```
+
+### Paso 2: Auditoría de Seguridad
+
+```bash
+# Usar pip-audit (recomendado)
+pip install pip-audit
+pip-audit
+
+# O safety (alternativa)
+pip install safety
+safety check -r requirements.txt
+
+# O con pip nativo (Python 3.12+)
+pip audit
+```
+
+### Paso 3: Verificar Actualizaciones
+
+```bash
+# Paquetes obsoletos
+pip list --outdated --format=json
+
+# Con pip-tools
+pip install pip-tools
+pip-compile --upgrade --dry-run
+
+# Con poetry
+poetry show --outdated
+
+# Con pipenv
+pipenv update --dry-run
+```
+
+### Paso 4: Auditoría de Licencias
+
+```bash
+# Instalar pip-licenses
+pip install pip-licenses
+
+# Listar licencias
+pip-licenses --format=markdown
+
+# Filtrar licencias problemáticas
+pip-licenses --fail-on="GPL;AGPL"
+
+# Exportar JSON
+pip-licenses --format=json --output-file=licenses.json
+```
+
+### Paso 5: Análisis de Dependencias Transitivas
+
+```bash
+# Árbol de dependencias
+pip install pipdeptree
+pipdeptree
+
+# Formato JSON
+pipdeptree --json
+
+# Dependencias inversas (quién usa qué)
+pipdeptree --reverse --packages requests
+```
+
+### Paso 6: Generar Reporte
+
+```
+══════════════════════════════════════════════════════════════
+📦 AUDITORÍA DE DEPENDENCIAS PYTHON
+══════════════════════════════════════════════════════════════
+
+──────────────────────────────────────────────────────────────
+🔒 VULNERABILIDADES DE SEGURIDAD
+──────────────────────────────────────────────────────────────
+
+| Paquete | Versión | CVE | Severidad | Corregido En |
+|---------|---------|-----|-----------|--------------|
+| requests | 2.25.0 | CVE-2023-32681 | ALTA | 2.31.0 |
+| urllib3 | 1.26.5 | CVE-2023-45803 | MEDIA | 1.26.18 |
+| pillow | 9.0.0 | CVE-2023-44271 | CRÍTICA | 10.0.1 |
+
+⚠️ ACCIONES REQUERIDAS:
+1. `pip install requests>=2.31.0` (prioridad ALTA)
+2. `pip install urllib3>=1.26.18` (prioridad MEDIA)
+3. `pip install pillow>=10.0.1` (prioridad CRÍTICA)
+
+──────────────────────────────────────────────────────────────
+📈 PAQUETES OBSOLETOS
+──────────────────────────────────────────────────────────────
+
+### Actualizaciones MAJOR (Posibles cambios disruptivos)
+| Paquete | Actual | Última | Changelog |
+|---------|--------|--------|-----------|
+| django | 3.2.23 | 5.0.1 | [Changelog](url) |
+| pydantic | 1.10.13 | 2.5.3 | [Migración](url) |
+
+### Actualizaciones MINOR (Recomendado)
+| Paquete | Actual | Última |
+|---------|--------|--------|
+| fastapi | 0.104.0 | 0.109.0 |
+| sqlalchemy | 2.0.23 | 2.0.25 |
+
+### Actualizaciones PATCH (Seguridad/Bugfix)
+| Paquete | Actual | Última |
+|---------|--------|--------|
+| httpx | 0.26.0 | 0.26.1 |
+
+──────────────────────────────────────────────────────────────
+📜 LICENCIAS
+──────────────────────────────────────────────────────────────
+
+### Resumen
+| Tipo | Cantidad | Paquetes |
+|------|----------|----------|
+| MIT | 45 | requests, fastapi, ... |
+| Apache-2.0 | 12 | google-cloud-*, ... |
+| BSD-3-Clause | 8 | numpy, pandas, ... |
+| GPL-3.0 | 2 | ⚠️ package-x, package-y |
+| DESCONOCIDO | 1 | ❓ private-package |
+
+### ⚠️ Licencias Copyleft Detectadas
+Estas licencias pueden tener implicaciones legales:
+
+| Paquete | Licencia | Impacto |
+|---------|----------|---------|
+| package-x | GPL-3.0 | Código derivado debe ser GPL |
+| package-y | AGPL-3.0 | Incluso para SaaS |
+
+**Recomendación**: Verificar compatibilidad con licencia del proyecto.
+
+──────────────────────────────────────────────────────────────
+📊 ESTADÍSTICAS
+──────────────────────────────────────────────────────────────
+
+| Métrica | Valor |
+|---------|-------|
+| Paquetes totales | 87 |
+| Directos | 23 |
+| Transitivos | 64 |
+| Vulnerabilidades | 3 |
+| Obsoletos | 15 |
+| Licencias OK | 82 |
+| Licencias a verificar | 5 |
+
+──────────────────────────────────────────────────────────────
+🔧 COMANDOS DE CORRECCIÓN
+──────────────────────────────────────────────────────────────
+
+# Corregir vulnerabilidades críticas
+pip install --upgrade requests>=2.31.0 urllib3>=1.26.18 pillow>=10.0.1
+
+# Actualizar parches de seguridad
+pip install --upgrade httpx
+
+# Generar requirements.txt actualizado
+pip freeze > requirements.txt
+
+# O con pip-tools
+pip-compile --upgrade requirements.in
+
+──────────────────────────────────────────────────────────────
+🎯 PRIORIDADES
+──────────────────────────────────────────────────────────────
+
+1. [ ] CRÍTICO: Corregir pillow (CVE-2023-44271)
+2. [ ] ALTO: Corregir requests (CVE-2023-32681)
+3. [ ] MEDIO: Corregir urllib3 (CVE-2023-45803)
+4. [ ] Verificar licencias GPL (package-x, package-y)
+5. [ ] Planificar migración pydantic v1 → v2
+```

package/Dev/i18n/es/Python/commands/generate-endpoint.md

@@ -0,0 +1,90 @@
+---
+description: Generar Endpoint FastAPI
+argument-hint: [arguments]
+---
+
+# Generar Endpoint FastAPI
+
+Eres un desarrollador senior de Python. Debes generar un endpoint completo de FastAPI con validación Pydantic, manejo de errores y pruebas.
+
+## Argumentos
+$ARGUMENTS
+
+Argumentos:
+- Nombre del recurso (ej: `user`, `product`, `order`)
+- (Opcional) Tipo (crud, list, detail, action)
+
+Ejemplo: `/python:generate-endpoint user crud`
+
+## MISIÓN
+
+### Paso 1: Estructura de Endpoint
+
+```
+app/
+├── api/
+│   └── v1/
+│       └── endpoints/
+│           └── {resource}.py
+├── schemas/
+│   └── {resource}.py
+├── crud/
+│   └── {resource}.py
+├── models/
+│   └── {resource}.py
+└── tests/
+    └── api/
+        └── v1/
+            └── test_{resource}.py
+```
+
+### Paso 2: Modelo SQLAlchemy
+
+[Crear template de modelo con UUID, timestamps, etc.]
+
+### Paso 3: Schemas Pydantic
+
+[Crear schemas: Base, Create, Update, InDB, Response, List]
+
+### Paso 4: Operaciones CRUD
+
+[Crear clase CRUD con get, create, update, delete, paginación]
+
+### Paso 5: Endpoint FastAPI
+
+[Crear router con endpoints GET, POST, PATCH, DELETE]
+
+### Paso 6: Pruebas
+
+[Crear clase de prueba con todas las pruebas de endpoint]
+
+### Paso 7: Registro de Router
+
+[Agregar router al archivo principal de API]
+
+### Resumen
+
+```
+══════════════════════════════════════════════════════════════
+✅ ENDPOINT GENERADO - {resource}
+══════════════════════════════════════════════════════════════
+
+📁 Archivos Creados:
+- app/models/{resource}.py
+- app/schemas/{resource}.py
+- app/crud/{resource}.py
+- app/api/v1/endpoints/{resource}.py
+- app/tests/api/v1/test_{resource}.py
+
+🔗 Endpoints Disponibles:
+- GET    /api/v1/{resource}s/     - Lista paginada
+- POST   /api/v1/{resource}s/     - Creación
+- GET    /api/v1/{resource}s/{id} - Detalle
+- PATCH  /api/v1/{resource}s/{id} - Actualización
+- DELETE /api/v1/{resource}s/{id} - Eliminación
+
+🔧 Próximos Pasos:
+1. Agregar router a app/api/v1/api.py
+2. Crear migración de Alembic
+3. Ejecutar pruebas: pytest app/tests/api/v1/test_{resource}.py
+```

package/Dev/i18n/es/Python/commands/generate-model.md

@@ -0,0 +1,96 @@
+---
+description: Generar Modelo SQLAlchemy
+argument-hint: [arguments]
+---
+
+# Generar Modelo SQLAlchemy
+
+Eres un desarrollador senior de Python. Debes generar un modelo completo de SQLAlchemy con relaciones, validaciones y migración de Alembic.
+
+## Argumentos
+$ARGUMENTS
+
+Argumentos:
+- Nombre del modelo (ej: `User`, `Product`, `Order`)
+- (Opcional) Campos en formato field:type (ej: `name:str email:str:unique`)
+
+Ejemplo: `/python:generate-model Product name:str price:decimal category_id:uuid:fk`
+
+## MISIÓN
+
+### Paso 1: Analizar Requisitos
+
+Identificar:
+- Nombre del modelo y tabla
+- Campos y sus tipos
+- Relaciones (ForeignKey, OneToMany, ManyToMany)
+- Índices y restricciones
+- Validaciones
+
+### Paso 2: Modelo SQLAlchemy 2.0
+
+[Crear modelo completo con Mapped, relationships, restricciones]
+
+### Paso 3: Tipos de Columna Comunes
+
+[Referencia para tipos SQLAlchemy: Integer, String, Text, DateTime, UUID, JSONB, etc.]
+
+### Paso 4: Relaciones
+
+[Ejemplos: OneToMany, ManyToMany con tabla de asociación]
+
+### Paso 5: Migración de Alembic
+
+[Crear archivo de migración con funciones upgrade/downgrade]
+
+### Paso 6: Comandos
+
+```bash
+# Generar migración automáticamente
+alembic revision --autogenerate -m "Create {model}s table"
+
+# Verificar migración
+alembic upgrade --sql head
+
+# Aplicar migración
+alembic upgrade head
+
+# Rollback si es necesario
+alembic downgrade -1
+```
+
+### Resumen
+
+```
+══════════════════════════════════════════════════════════════
+✅ MODELO GENERADO - {Model}
+══════════════════════════════════════════════════════════════
+
+📁 Archivos Creados:
+- app/models/{model}.py
+
+📊 Estructura de Tabla:
+| Columna | Tipo | Restricciones |
+|---------|------|---------------|
+| id | UUID | PK |
+| name | VARCHAR(255) | NOT NULL, INDEX |
+| slug | VARCHAR(255) | UNIQUE, INDEX |
+| description | TEXT | NULLABLE |
+| price | NUMERIC(10,2) | DEFAULT 0.00, CHECK >= 0 |
+| quantity | INTEGER | DEFAULT 0 |
+| is_active | BOOLEAN | DEFAULT true, INDEX |
+| category_id | UUID | FK -> categories.id |
+| created_at | DATETIME | DEFAULT now() |
+| updated_at | DATETIME | DEFAULT now(), ON UPDATE |
+
+🔗 Relaciones:
+- category: ManyToOne -> Category
+- order_items: OneToMany -> OrderItem
+
+🔧 Comandos:
+# Generar migración
+alembic revision --autogenerate -m "Create {model}s table"
+
+# Aplicar
+alembic upgrade head
+```

package/Dev/i18n/es/Python/commands/type-coverage.md

@@ -0,0 +1,119 @@
+---
+description: Verificar Cobertura de Tipos Python
+argument-hint: [arguments]
+---
+
+# Verificar Cobertura de Tipos Python
+
+Eres un experto en Python. Debes verificar la cobertura de anotaciones de tipo en el proyecto e identificar funciones/métodos sin tipar.
+
+## Argumentos
+$ARGUMENTS
+
+Argumentos:
+- (Opcional) Ruta a módulo específico
+- (Opcional) Umbral mínimo de cobertura (ej: `80`)
+
+Ejemplo: `/python:type-coverage app/` o `/python:type-coverage app/api/ 90`
+
+## MISIÓN
+
+### Paso 1: Configuración de MyPy
+
+[Mostrar configuración de mypy en pyproject.toml]
+
+### Paso 2: Lanzar Análisis
+
+```bash
+# MyPy estándar
+mypy app/
+
+# Con reporte de cobertura
+mypy app/ --txt-report type-coverage/
+
+# Reporte HTML
+mypy app/ --html-report type-coverage-html/
+
+# Modo estricto progresivo
+mypy app/ --strict --warn-return-any
+```
+
+### Paso 3: Script de Análisis de Cobertura
+
+[Script Python para analizar cobertura de tipos usando AST]
+
+### Paso 4: Patrones de Tipado
+
+[Mostrar patrones: TypeAlias, Generics, Protocols, Callable, Overload, etc.]
+
+### Paso 5: Generar Reporte
+
+```
+══════════════════════════════════════════════════════════════
+📊 REPORTE DE COBERTURA DE TIPOS
+══════════════════════════════════════════════════════════════
+
+──────────────────────────────────────────────────────────────
+📈 RESUMEN GLOBAL
+──────────────────────────────────────────────────────────────
+
+| Métrica | Valor | Umbral | Estado |
+|---------|-------|--------|--------|
+| Cobertura Global | 78.5% | 80% | ⚠️ |
+| Funciones Totales | 245 | - | - |
+| Completamente Tipadas | 192 | - | - |
+| Parcialmente Tipadas | 38 | - | - |
+| Sin Tipar | 15 | - | - |
+
+──────────────────────────────────────────────────────────────
+📁 COBERTURA POR MÓDULO
+──────────────────────────────────────────────────────────────
+
+| Módulo | Funciones | Tipadas | Cobertura |
+|--------|-----------|---------|-----------|
+| app/api/ | 45 | 45 | 100% ✅ |
+| app/core/ | 32 | 30 | 93.8% ✅ |
+| app/services/ | 58 | 52 | 89.7% ✅ |
+| app/crud/ | 40 | 35 | 87.5% ✅ |
+| app/models/ | 28 | 20 | 71.4% ⚠️ |
+| app/utils/ | 42 | 10 | 23.8% ❌ |
+
+──────────────────────────────────────────────────────────────
+❌ FUNCIONES SIN TIPAR
+──────────────────────────────────────────────────────────────
+
+### app/utils/helpers.py
+
+| Línea | Función | Faltante |
+|-------|---------|----------|
+| 15 | `parse_date` | tipo de retorno |
+| 28 | `format_currency` | param: amount, retorno |
+| 45 | `slugify` | tipo de retorno |
+| 67 | `calculate_hash` | param: data |
+
+──────────────────────────────────────────────────────────────
+🔧 CORRECCIONES SUGERIDAS
+──────────────────────────────────────────────────────────────
+
+### app/utils/helpers.py:15
+
+```python
+# Antes
+def parse_date(date_str):
+    ...
+
+# Después
+def parse_date(date_str: str) -> datetime | None:
+    ...
+```
+
+──────────────────────────────────────────────────────────────
+🎯 PRIORIDADES
+──────────────────────────────────────────────────────────────
+
+1. [ ] Tipar app/utils/ (23.8% → 80%+)
+2. [ ] Completar app/models/ (71.4% → 90%+)
+3. [ ] Corregir 23 errores de mypy
+4. [ ] Agregar plugin de mypy para SQLAlchemy
+5. [ ] Configurar hook pre-commit de mypy
+```