G-Bot

G-Bot - Compañero de productividad que automatiza tareas complejas para que vos te enfoqués en crear

G-Bot es una extensión de Visual Studio Code para acelerar los flujos DevOps de equipos de desarrollo: integra Azure DevOps para Work Items y Pull Requests, realiza code review con IA usando GitHub Copilot y genera documentación técnica en Word/PDF.

Novedades (3.0.9)

Nuevo modal para adjuntos de Work Items con descarga por item y carpeta destino.
Conversion de DOCX a PDF con Office cuando esta disponible y fallback a Word Online.
Enlaces SharePoint/OneDrive mejorados: soporte de baseUrl my?id y apertura en Word Online (web=1&action=edit).

Novedades (3.0.8)

Cierre de cobertura global en src a 100% (lineas, ramas, funciones y statements).
Consolidacion de pruebas en modulos de extension, API, vistas y generadores.
Endurecimiento final de workItemPDFGenerator para eliminar deuda de ramas residuales.

Novedades (3.0.7)

Hardening del flujo de PR grandes con guardas de memoria en construcción/lectura de diffs.
Activación automática de Auto Lite Mode con umbrales configurables por archivos y bloques.
Corrección de precedencia y recarga en caliente de patrones ignorados (settings explícito > config.json > defaults).
Mejoras de cobertura: pruebas unitarias para helpers de auto-lite y mapeo load/save del Sidebar.

Novedades (3.0.5)

Corrección de error en revisión de archivos grandes: technologies.join is not a function.
Mayor robustez al parsear respuestas de IA cuando llegan truncadas o vacías.
Reintento automático cuando la IA devuelve payload vacío.

Novedades (3.0.4)

Bump de versión para publicación en Marketplace tras rechazo por versión duplicada (3.0.3 ya existente).
Sin cambios funcionales respecto a 3.0.3; release orientado a despliegue.

Novedades (3.0.3)

Follow-up más preciso en PR reviews con contexto global de archivos por bloque.
Reducción de falsos positivos cross-block cuando un script/archivo existe en otro lote del PR.
Soporte de plantilla del desarrollador en comentarios del PR:
- Issue [N] - NO APLICA
- Justificación: ...
- Issue [N] - APLICA
Evaluación explícita de justificaciones NO APLICA en segunda revisión.

Capacidades

Integración con Azure DevOps para Work Items y Pull Requests.
Revisión de cambios staged/unstaged con IA (Copilot).
Análisis de riesgo de cambios (LOW, MEDIUM, HIGH, CRITICAL).
Comparación de branches y estadísticas de cambios.
Generación de documentos Word con estilos configurables.
Generación de PDFs desde Work Items con enlaces e imágenes.
Panel de revisión en Source Control y sidebar operativo.

Instalación

Opción 1: VSIX

Descarga el archivo VSIX de la versión deseada.
Instala con:

code --install-extension G-Bot-3.0.9.vsix

Opción 2: Marketplace

Abre Extensions en VS Code.
Busca G-Bot.
Selecciona Install.

Configuración Base

Todas las configuraciones usan el namespace gbot.

gbot.azure.organization
gbot.azure.pat
gbot.devops.organization
gbot.devops.pat
gbot.sharepoint.localPath
gbot.sharepoint.baseUrl
gbot.template.path
gbot.template.outputDir
gbot.summary.method
gbot.prReview.aiModel
gbot.prReview.ignoredFilePatterns
gbot.prReview.autoLiteMode.enabled
gbot.prReview.autoLiteMode.filesThreshold
gbot.prReview.autoLiteMode.blocksThreshold
gbot.documentation.url
gbot.debug

Auto Lite Mode (PR grandes)

Para mejorar estabilidad cuando un PR es muy grande, G-Bot puede activar un modo liviano automático.

gbot.prReview.autoLiteMode.enabled: habilita/deshabilita el modo automático
gbot.prReview.autoLiteMode.filesThreshold: umbral de archivos para activación
gbot.prReview.autoLiteMode.blocksThreshold: umbral de bloques para activación

Ejemplo:

{
  "gbot.prReview.autoLiteMode.enabled": true,
  "gbot.prReview.autoLiteMode.filesThreshold": 180,
  "gbot.prReview.autoLiteMode.blocksThreshold": 24
}

Cuando se activa este modo:

reduce el nivel de detalle de detailed a standard
desactiva sugerencias opcionales
prioriza estabilidad para evitar picos de memoria

Configuración de Tokens (PAT)

G-Bot usa dos credenciales PAT diferentes para separar permisos por tipo de operación.

1) Azure Boards / Work Items

Se usa para consultar WIQL, leer Work Items y generar Word/PDF.

Settings usados:
- gbot.azure.organization
- gbot.azure.pat
Organización típica:
- ORG-BOARD (ajustable según tu entorno)
Permisos requeridos del PAT:
- Code (Read)
- Identity (Read)
- Work Items (Read & Write)

2) Azure DevOps Git / Pull Requests

Se usa para obtener PRs, commits, diffs y publicar comentarios de revisión.

Settings usados:
- gbot.devops.organization
- gbot.devops.pat
Organización típica:
- ORG-PR (ajustable según tu entorno)
Permisos requeridos del PAT:
- Code (Read)
- Project and Team (Read)
- Pull Request Threads (Read & Write)
- Work Items (Read)

Matriz rápida de permisos por flujo

Flujo	Settings	Scope mínimo
Work Items / WIQL / PDFs	`gbot.azure.organization`, `gbot.azure.pat`	`Code (Read)`, `Identity (Read)`, `Work Items (Read & Write)`
PR Review lectura y publicación	`gbot.devops.organization`, `gbot.devops.pat`	`Code (Read)`, `Project and Team (Read)`, `Pull Request Threads (Read & Write)`, `Work Items (Read)`

Comandos Disponibles

G-Bot: Show Sidebar
G-Bot: Refrescar Sidebar
G-Bot: Abrir Log
G-Bot: Show Output Channel
G-Bot: Review Unstaged Changes
G-Bot: Review Staged Changes
G-Bot: Analyze Risk
G-Bot: Compare Branches
G-Bot: Show Change Stats
G-Bot: Next Comment
G-Bot: Previous Comment

Guía Rápida

Ejecuta G-Bot: Show Sidebar.
Configura organizaciones y tokens PAT.
Guarda configuración y valida conexión.
Ejecuta revisión de cambios desde Code Review.
Genera documento Word o PDF según el flujo.

Troubleshooting

Es comportamiento esperado. La extensión se activa, pero la vista no se abre sola. Usa G-Bot: Show Sidebar o el ícono en Activity Bar.

Error 401 en Work Items o PDFs

Verifica gbot.azure.organization y gbot.azure.pat.
Confirma scopes: Code (Read), Identity (Read) y Work Items (Read & Write).

Error al publicar comentarios en PR

Verifica gbot.devops.organization y gbot.devops.pat.
Confirma scopes: Code (Read), Project and Team (Read), Pull Request Threads (Read & Write) y Work Items (Read).

Identidad

Nombre del producto: G-Bot
Namespace interno: gbot
Chat participant: @gbot
Slogan oficial: G-Bot - Compañero de productividad que automatiza tareas complejas para que vos te enfoqués en crear

Licencia

Licencia: Apache 2.0 (ver LICENSE). En ningún caso BAC LATAM SSC S.A. será responsable por daños indirectos, incidentales, consecuentes o pérdida de beneficios derivados del uso de la extensión.

Autoría

Gerald Barquero Valverde

Con colaboración de GitHub Copilot para automatización y productividad del flujo de desarrollo.

G Bot

Thunderlight