@slorenzot/mcp-azure 2.3.5 → 2.4.1

package/IMPLEMENTATION_SUMMARY.md

@@ -0,0 +1,103 @@
+# Azure Repos Implementation Summary
+
+## Versión: 2.4.0
+
+## Fecha: 2026-03-10
+
+## Cambios Realizados
+
+### 1. Archivos Modificados
+- `src/index.ts`: +1093 líneas (1315 → 2408 líneas)
+- `package.json`: Actualizado versión de 2.3.5 a 2.4.0
+- `dist/index.js`: Regenerado con todas las nuevas funcionalidades
+
+### 2. Nuevos Imports (2 módulos)
+- `azure-devops-node-api/GitApi`
+- `azure-devops-node-api/interfaces/GitInterfaces`
+
+### 3. Nueva Variable de Estado
+- `gitApiClient: gitApi.IGitApi | null = null`
+
+### 4. Nueva Función Getter
+- `getGitApi()`: Obtiene instancia lazy-loaded de Git API
+
+### 5. Nuevas Funciones Helper (11)
+- `formatBytes(bytes)`: Formatea bytes a KB/MB/GB
+- `getVoteLabel(vote)`: Convierte valor numérico a etiqueta legible
+- `formatRepository(repo)`: Formatea repositorio individual
+- `formatRepositoryList(repos)`: Formatea lista de repositorios
+- `formatBranchList(refs)`: Formatea lista de branches
+- `formatPullRequest(pr)`: Formatea PR individual completo
+- `formatPullRequestList(prs)`: Formatea lista de PRs
+- `formatReviewer(reviewer)`: Formatea reviewer individual
+- `formatReviewerList(reviewers)`: Formatea lista de reviewers
+- `formatThreadList(threads)`: Formatea lista de hilos de comentarios
+- `formatCommitList(commits)`: Formatea lista de commits
+
+### 6. Herramientas Implementadas (19 nuevas)
+
+#### Repositorios (3)
+1. `ado_list_repositories`: Lista todos los repositorios del proyecto
+2. `ado_get_repository`: Obtiene detalles de un repositorio específico
+3. `ado_list_branches`: Lista las ramas de un repositorio
+
+#### Pull Requests CRUD (6)
+4. `ado_list_pull_requests`: Lista PRs con filtros (por repo o proyecto-wide)
+5. `ado_get_pull_request`: Obtiene detalles completos de un PR
+6. `ado_create_pull_request`: Crea un nuevo PR
+7. `ado_update_pull_request`: Actualiza propiedades de un PR
+8. `ado_complete_pull_request`: Completa (merge) un PR con opciones de estrategia
+9. `ado_abandon_pull_request`: Abandona un PR
+
+#### Pull Request Reviews (4)
+10. `ado_approve_pull_request`: Aprueba un PR (voto: 10)
+11. `ado_reject_pull_request`: Rechaza un PR (voto: -10)
+12. `ado_get_pull_request_reviewers`: Obtiene todos los revisores de un PR
+13. `ado_add_pull_request_reviewer`: Agrega un revisor a un PR
+
+#### Pull Request Comments (3)
+14. `ado_get_pull_request_threads`: Obtiene todos los hilos de comentarios
+15. `ado_create_pull_request_thread`: Crea un nuevo hilo (general o código)
+16. `ado_reply_to_pull_request_thread`: Responde a un hilo existente
+
+#### Pull Request Info (3)
+17. `ado_get_pull_request_commits`: Obtiene commits de un PR
+18. `ado_get_pull_request_work_items`: Obtiene work items vinculados
+19. `ado_update_pull_request_thread_status`: Actualiza estado de hilo
+
+### 7. Actualizaciones de Configuración
+- `ado_configure`: Ahora resetea `gitApiClient` al reconfigurar
+- `autoConfigureFromEnv`: Ahora resetea `gitApiClient` al auto-configurar
+- `getConnection`: Mensaje de error actualizado para incluir scope Code
+
+## Estadísticas
+
+| Métrica | Valor |
+|----------|--------|
+| Herramientas totales | 34 (14 existentes + 19 nuevas) |
+| Líneas de código fuente | 2408 (de 1315) |
+| Nuevos módulos importados | 2 |
+| Nuevas funciones helper | 11 |
+| Categorías de Azure Repos | 5 (Repos, PR CRUD, Reviews, Comments, Info) |
+
+## Verificación
+
+✅ Build exitoso sin errores de TypeScript  
+✅ Servidor MCP inicia correctamente  
+✅ Todas las herramientas siguen las convenciones existentes  
+✅ No breaking changes a funcionalidad existente  
+✅ PAT scope requerido: Code (Read & Write)
+
+## Próximos Pasos Recomendados
+
+1. Actualizar README.md con documentación de las nuevas herramientas
+2. Ejecutar pruebas manuales según el checklist del PRD
+3. Publicar a npm: `npm publish`
+4. Considerar agregar prompts de MCP para workflows comunes de PRs
+
+## Notas
+
+- La implementación sigue exactamente el patrón del código existente
+- Todas las herramientas tienen manejo de errores con try-catch
+- Los responses usan el formato `{ content: [{ type: "text", text: "..." }] }`
+- Las funciones helper son consistentes con las existentes

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Soulberto Lorenzo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.