Guia de configuracion y uso - management-pull-request

1. Que hace esta extension

Esta extension para VS Code te permite:

Ver Pull Requests asignados a tu usuario en Azure DevOps.
Agrupar PRs por repositorio y estado.
Abrir el detalle de un PR.
Ejecutar un analisis automatico con AWS Bedrock (Claude).
Aprobar un PR desde la misma vista.
Copiar el analisis generado al portapapeles.
Monitorear un repositorio principal y repositorios adicionales.

2. Requisitos

Antes de usarla, valida lo siguiente:

VS Code 1.110 o superior.
Acceso a Azure DevOps.
Un PAT (Personal Access Token) de Azure DevOps.
Credenciales de AWS configuradas en tu entorno (por ejemplo, via AWS CLI, variables de entorno o perfil).
Permisos en AWS Bedrock para invocar el modelo configurado.

2.1 Permisos recomendados del PAT

Para que la extension funcione bien, el PAT debe tener permisos de Code al menos para:

Leer pull requests y metadatos del repo.
Actualizar el voto del revisor (approve).

Si faltan permisos, veras errores en carga o al aprobar PRs.

3. Configuracion inicial

Puedes configurar la extension desde el archivo de configuracion de VS Code (Workspace o User Settings) en formato JSON.

Ejemplo minimo:

{
  "managementPullRequest.azure.organizationUrl": "https://dev.azure.com/tu-org",
  "managementPullRequest.azure.project": "Tu Proyecto",
  "managementPullRequest.azure.repository": "tu-repo"
}

4. Todas las configuraciones disponibles

{
  "managementPullRequest.azure.organizationUrl": "https://dev.azure.com/tu-org",
  "managementPullRequest.azure.project": "Tu Proyecto",
  "managementPullRequest.azure.repository": "tu-repo-principal",

  "managementPullRequest.repositories": [
    {
      "organizationUrl": "https://dev.azure.com/tu-org",
      "project": "Tu Proyecto",
      "repository": "otro-repo"
    }
  ],

  "managementPullRequest.bedrock.region": "us-east-1",
  "managementPullRequest.bedrock.modelId": "us.anthropic.claude-3-5-sonnet-20241022-v2:0",

  "managementPullRequest.bedrock.caBundlePath": "",
  "managementPullRequest.bedrock.allowInsecureTls": false,

  "managementPullRequest.analysis.maxChangedFiles": 40
}

Notas importantes

managementPullRequest.azure.*: define el repositorio principal.
managementPullRequest.repositories: lista adicional de repositorios a monitorear.
managementPullRequest.analysis.maxChangedFiles: limita archivos enviados al analisis.
managementPullRequest.bedrock.caBundlePath: util en redes corporativas con CA interna.
managementPullRequest.bedrock.allowInsecureTls: solo para depuracion local. No recomendado en ambientes reales.

5. Configurar el PAT de Azure DevOps

Usa el comando PR Assistant: Configure DevOps PAT para agregar tu token de Azure DevOps:

Abre la paleta de comandos (Cmd+Shift+P en macOS).
Ejecuta: PR Assistant: Configure DevOps PAT.
Pega tu PAT cuando se solicite.
El PAT se guarda de forma segura en Secret Storage de VS Code.

6. Agregar repositorios y proyectos

Usa el comando PR Assistant: Add Repository para agregar el repositorio y proyecto de Azure DevOps que deseas monitorear:

Abre la paleta de comandos (Cmd+Shift+P en macOS).
Ejecuta: PR Assistant: Add Repository.
Ingresa la URL del repositorio en Azure DevOps con este formato:

https://dev.azure.com/{org}/{project}/_git/{repo}

Ejemplo:

https://dev.azure.com/DevOpsPCO/Dominio%20de%20Lealtad/_git/pco-loyalty-configuration-back

La extension extrae automaticamente la organizacion, el proyecto y el repositorio de la URL y los agrega a la configuracion. Puedes ejecutar este comando varias veces para agregar multiples repositorios.

7. Flujo de uso diario

Abre la vista del Explorador llamada Pull Request Analysis.
La extension carga PRs asignados a tu usuario.
Usa el boton Refresh para recargar datos.
Haz clic en un PR para abrir el detalle y el analisis.
En el panel de detalle puedes:
- Ver metadata del PR, reviewers, checks y archivos modificados.
- Copiar el analisis (Copy analysis).
- Aprobar el PR (Approve PR) si aplica.

8. Comandos disponibles

PR Assistant: Configure DevOps PAT — agrega o actualiza el token (PAT) de Azure DevOps.
PR Assistant: Add Repository — agrega un repositorio y proyecto de Azure DevOps para monitorear.
Refresh (en el titulo de la vista) — recarga la lista de PRs.

9. Solucion de problemas

No carga PRs

Revisa:

organizationUrl, project, repository bien configurados.
PAT configurado y vigente.
Permisos del PAT en el proyecto/repositorio.

Error de TLS o certificados en Bedrock

Si estas en red corporativa y aparece un error de certificado:

Configura managementPullRequest.bedrock.caBundlePath con una ruta a un PEM valido.
Mantiene managementPullRequest.bedrock.allowInsecureTls en false.
Solo si estas depurando localmente, prueba allowInsecureTls: true de forma temporal.

Error de AWS Bedrock