RPG Guardian

Enterprise Code Quality Analyzer for IBM i

RPG Guardian ayuda a revisar la calidad de codigo IBM i desde Visual Studio Code. Analiza el documento abierto, identifica posibles problemas y presenta recomendaciones junto al fuente.

Caracteristicas

• Analisis local de buenas practicas, nomenclatura, SQL, estructura y manejo de errores.
• Hallazgos con severidad, linea, evidencia, impacto y recomendacion.
• Dashboard con calidad general, riesgo de produccion, madurez RPG y graficos por categoria.
• Navegacion a problemas en el editor y diagnosticos en Problems.
• Catalogo de reglas con descripcion, forma de evaluacion y fundamento.
• Busqueda y filtros de hallazgos por severidad y categoria.
• Exportacion del reporte a JSON.
• Reglas adicionales opcionales y revision asistida por GitHub Copilot o Azure OpenAI.

Requisitos

• Visual Studio Code 1.95 o superior.
• Fuentes RPG Free, RPGLE o SQLRPGLE. CLLE y DDS tienen soporte limitado de comprobaciones aplicables.
• Para miembros remotos, una extension IBM i que permita abrir el fuente e identificar su lenguaje.
• Para utilizar IA, acceso al proveedor elegido y autorizacion para compartir codigo. El analisis local no requiere IA.

Instalacion

1. Abra Extensions en VS Code.
2. Busque RPG Guardian y seleccione la extension del publisher DenisonCecilianoVega.
3. Pulse Install.

Si dispone del paquete VSIX, use Extensions > ... > Install from VSIX... y seleccione el archivo de RPG Guardian. Si VS Code solicita recargar, ejecute Developer: Reload Window.

Como utilizarla

1. Abra el fuente que desea revisar.
2. Haga clic derecho en el editor y elija Analizar Calidad RPG, o ejecute el comando desde la paleta.
3. Espere a que termine el analisis y consulte el reporte junto al editor.
4. Revise las pestañas Resumen, Metricas, Hallazgos y Reglas.
5. Use los filtros y el boton de linea de cada hallazgo para navegar al codigo.
6. Corrija los problemas, compile y pruebe en su entorno IBM i; vuelva a analizar para actualizar el reporte.

Tambien puede consultar los hallazgos desde el icono RPG Guardian en la barra de actividad izquierda y desde Problems. No necesita seleccionar un archivo de reglas para comenzar.

Editar o cerrar el documento invalida el reporte anterior. Ejecute nuevamente el analisis antes de exportar o navegar a los resultados.

Ayuda y configuracion

En la esquina superior derecha del reporte encontrara:

• Catalogo de reglas: descripcion, evaluacion y fundamento de cada regla, junto con una explicacion de los niveles de madurez.
• Guia de ajustes e IA: parametros, valores predeterminados y ejemplos de configuracion.
• Ajustes e IA: acceso a la configuracion de la extension en VS Code.

La configuracion inicial mantiene la IA desactivada. Para comenzar solo con analisis local:

{
  "rpgGuardian.ai.provider": "off"
}

Puede ajustar los pesos de puntuacion o agregar un archivo de reglas mediante Cargar reglas adicionales. Las reglas adicionales complementan el perfil integrado; no lo sustituyen.

Interpretacion del reporte

Los hallazgos se clasifican como Critical, High, Medium, Low o Info. Priorice los problemas de mayor severidad y revise la evidencia antes de modificar el codigo.

Una regla No evaluada requiere informacion o revision adicional; no significa que este aprobada. El Quality Gate combina el score con hallazgos criticos y revisiones pendientes. La madurez y el riesgo son indicadores orientativos, no certificaciones.

Privacidad y alcance

El analisis estatico local no envia el fuente a proveedores de IA. La revision IA es opcional, requiere un workspace confiable y pide consentimiento antes de enviar el fuente completo y las reglas. Las claves de Azure se guardan en VS Code SecretStorage, no en los ajustes.

El analisis es heuristico y se limita al documento abierto: no ejecuta el programa, no expande /COPY o /INCLUDE y no verifica catalogos DB2, planes SQL ni enlaces ILE. No sustituye compilacion, pruebas o revision humana.

Manual

El manual completo MANUAL_RPG_GUARDIAN.md se incluye dentro de la extension. Para consultarlo, ejecute Developer: Open Extensions Folder, abra la carpeta de RPG Guardian y el archivo Markdown. Incluye configuracion, reglas, ejemplos y resolucion de problemas.

Licencia

MIT.