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.15)

Plan de Pruebas: IA ahora es obligatoria (GitHub Copilot). Ya no hay generador local de fallback.
Plan de Pruebas: Selector dinámico de modelos IA - detecta automáticamente todos los modelos disponibles en tu instalación de Copilot (sin restricciones).
Plan de Pruebas: Sistema inteligente de variaciones - intenta nombre exacto y variantes automáticas (ej: claude-sonnet-4.5 → claude-sonnet → claude).
Plan de Pruebas: Cascada automática - intenta modelo seleccionado → gpt-4o → gpt-4 → cualquier disponible.
Plan de Pruebas: Prompt neutralizado - los escenarios se generan solo del contexto real del Work Item, sin asumir dominios.
Corrección crítica: Eliminado código corrupto que impedía activación de la extensión.
Fix análisis PR: Corregido error changes.filter is not a function al analizar archivos modificados en Pull Requests.
Tests actualizados: validación de error cuando Copilot no está disponible, 100 líneas de código comentado eliminadas.

Novedades (3.0.14)

Correccion de estabilidad en Sidebar: tabs y botones del webview vuelven a responder correctamente.
PR Review: validacion de URL mas robusta para dev.azure.com y org.visualstudio.com.
PR Review: soporte de entrada pegada en formato markdown ([texto](https://example.com/pr)) y en formato <https://example.com/pr>.
PR Review: fallback backend para parsear prUrl cuando faltan campos derivados en frontend.
Cobertura estricta recuperada al 100% en statements, branches, functions y lines con npm run test:coverage:check.

Novedades (3.0.13)

Plan de Pruebas: escenarios mas claros, ejecutables y orientados al negocio.
Plan de Pruebas: additionalContext ahora es opcional y solo influye cuando aporta valor real.
Plan de Pruebas: se garantizan flujos criticos de negocio cuando el contexto los requiere.
Plan de Pruebas: deduplicacion de escenarios y estandar de salida Pruebas THL-XXXX + titulo del Work Item.

Novedades (3.0.12)

Cuando el contenido excede el límite, el comentario se divide en múltiples partes en lugar de truncarse.
Cada comentario parcial incluye encabezado Parte X de N para mantener lectura secuencial.
PR review: soporte de gbot.prReview.maxFilesToReview (default 100, valor 0 revisa todo el PR).
PR review: cuando aplica limite, ahora se reporta el listado de archivos que quedaron sin revision.
Rendimiento: se reutilizan threads precargados entre bloques y se reduce latencia en PRs grandes.
Rendimiento: concurrencia configurable para obtencion de diffs (gbot.prReview.diffFetchConcurrency).
Rendimiento: prefetch del siguiente bloque durante el analisis del bloque actual (gbot.prReview.blockPrefetch.enabled).
Rendimiento: modo adaptativo por tiempo para degradar detalle/sugerencias en ejecuciones largas (gbot.prReview.adaptiveMode.*).
Cobertura/Node16: scripts de test y cobertura ajustados para ejecucion compatible en Windows y corrida secuencial reproducible.

Novedades (3.0.11)

Follow-up: plantilla de respuesta incluye todos los issueNumber.
Follow-up: reintento automatico cuando el modelo omite issues.
Pipeline: publicacion de cobertura (Cobertura) en Code Coverage.

Novedades (3.0.10)

RFC: plantilla base para publicación de comentario en workitem, render mas seguro y mensajes saneados.
Subtasks: validaciones y robustez al generar subtareas desde Work Items.
Code review: follow-up con normalizacion y resolucion de falsos positivos mas consistente.

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.15.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.maxFilesToReview
gbot.prReview.diffFetchConcurrency
gbot.prReview.blockPrefetch.enabled
gbot.prReview.adaptiveMode.enabled
gbot.prReview.adaptiveMode.warningSeconds
gbot.prReview.adaptiveMode.criticalSeconds
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

Limite de Archivos en PR Review

Para controlar el tiempo de respuesta y costo de analisis en PRs muy grandes, puedes definir el maximo de archivos a revisar por ejecucion.

gbot.prReview.maxFilesToReview: cantidad maxima de archivos a revisar
0: revisa todos los archivos del PR
> 0: revisa solo ese numero de archivos (orden deterministico por ruta)
default: 100 (comportamiento conservador para mantener estabilidad)

Si se aplica limite, G-Bot muestra en el comentario una seccion con los archivos que quedaron fuera de revision.

Optimizaciones de Rendimiento (PR grandes)

Para reducir latencia y estabilizar revisiones extensas, puedes ajustar estos settings:

gbot.prReview.diffFetchConcurrency: archivos procesados en paralelo por bloque (default 4, rango 1..12)
gbot.prReview.blockPrefetch.enabled: permite traer el siguiente bloque mientras el actual se analiza (default true)
gbot.prReview.adaptiveMode.enabled: activa degradacion progresiva por tiempo transcurrido (default true)
gbot.prReview.adaptiveMode.warningSeconds: umbral del primer ajuste adaptativo (default 180)
gbot.prReview.adaptiveMode.criticalSeconds: umbral del ajuste critico a modo light/sin sugerencias (default 300)

Ejemplo:

{
  "gbot.prReview.diffFetchConcurrency": 4,
  "gbot.prReview.blockPrefetch.enabled": true,
  "gbot.prReview.adaptiveMode.enabled": true,
  "gbot.prReview.adaptiveMode.warningSeconds": 180,
  "gbot.prReview.adaptiveMode.criticalSeconds": 300,
  "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