OPENHIGH✦ KiBot
Consolidación de todas las tareas duplicadas sobre validaciones en endpoints /api/v1/tasks/validate y /api/v1/projects/validate
abierto por @kibot · 30/9/2026, 13:24:16
## 🎯 Consolidación de Tareas Duplicadas sobre Validaciones
Este issue consolida todas las tareas duplicadas relacionadas con implementaciones de validaciones en endpoints `/api/v1/tasks/validate` y `/api/v1/projects/validate`.
### 📋 Tareas Consolidadas
Las siguientes tareas han sido consolidadas en este issue:
#### ✅ Completadas (Skills Implementadas)
- [x] github.md - Autenticación OAuth2 para GitHub API
- [x] incidents.md - Manejo de GitHub API 403/429
- [x] validation.md - Reglas de validación para endpoints
#### ⏳ Pendientes de Implementación
**1. projects.md - Gestión de Proyectos SHB**
- **Prioridad:** MEDIUM
- **Propósito:** Procedimientos para gestión de proyectos comunitarios SHB usando las herramientas shb-platform
- **Herramientas requeridas:** shb-platform (shb_get_project, shb_list_projects, shb_update_project, etc.)
- **Operaciones principales:** Obtener proyecto, listar proyectos, actualizar metadatos, crear/actualizar issues, gestionar tareas, publicar actualizaciones
**2. repositories.md - Análisis de Repositorios SHB**
- **Prioridad:** MEDIUM
- **Propósito:** Procedimientos para análisis de repositorios SHB y gestión de fichas /software/<slug>
- **Herramientas requeridas:** shb-platform (shb_get_software, shb_list_software, shb_update_software), brave-search, read_url
- **Operaciones principales:** Obtener ficha de software, buscar fichas, actualizar campos editoriales, encolar reanálisis
**3. security.md - Checklist de Validaciones para Endpoints**
- **Prioridad:** HIGH
- **Propósito:** Checklist de validaciones de seguridad completas para endpoints /api/v1/tasks/validate y /api/v1/projects/validate
- **Validaciones requeridas:**
- Autenticación OAuth2 en todos los endpoints
- Validación de formato de ID para tareas (UUID v4)
- Validación de longitud de nombre de proyecto (max 100 chars)
- Validación de longitud de descripción (max 500 chars)
- Manejo de GitHub API rate limiting con OAuth2
### 📊 Estado del Proyecto
| Skill | Estado | Porcentaje |
|-------|--------|------------|
| github.md | ✅ IMPLEMENTADO | 100% |
| incidents.md | ✅ IMPLEMENTADO | 100% |
| validation.md | ✅ IMPLEMENTADO | 100% |
| projects.md | ⏳ PENDIENTE | 0% |
| repositories.md | ⏳ PENDIENTE | 0% |
| security.md | ⏳ PENDIENTE | 0% |
**Total:** 3/6 skills implementadas (50%)
### 🎯 Próximos Pasos
1. **Prioridad Alta:** Implementar `security.md` con checklist completo de validaciones
2. **Prioridad Media:** Implementar `projects.md` para gestión de proyectos SHB
3. **Prioridad Media:** Implementar `repositories.md` para análisis de repositorios
4. **Documentación:** Actualizar SKILLS.md con ejemplos prácticos de cada skill
### 🔗 Referencias
- [GitHub OAuth Authentication](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/understanding-oauth)
- [FastAPI OAuth2 Security](https://fastapi.tiangolo.com/tutorial/security/oauth2jira/)
- [GitHub API Rate Limits](https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting)
---
*Consolidado el 2026-10-01*