siesa-agents 2.1.72-qa.24 → 2.1.72-qa.26

package/bin/install.js

@@ -30,6 +30,12 @@ class SiesaBmadInstaller {
       '_bmad-output/shared-artifacts'
     ];
 
+    // Archivos sueltos que se copian a la raíz del workspace (no van en folderMappings)
+    // recorder.bat: launcher del Grabador de Localizadores v4, resuelve el kit vía %~dp0
+    this.rootFiles = [
+      'recorder.bat'
+    ];
+
     this.targetDir = process.cwd();
     // Intentar múltiples ubicaciones posibles para el paquete
     this.packageDir = this.findPackageDir();
@@ -537,6 +543,27 @@ class SiesaBmadInstaller {
         console.warn(`⚠️  Carpeta ${mapping.source} no encontrada en el paquete`);
       }
     }
+
+    // Copiar archivos sueltos a la raíz del workspace
+    await this.copyRootFiles();
+  }
+
+  async copyRootFiles() {
+    for (const fileName of this.rootFiles) {
+      const sourcePath = path.join(this.packageDir, fileName);
+      const targetPath = path.join(this.targetDir, fileName);
+
+      if (fs.existsSync(sourcePath)) {
+        try {
+          await fs.copy(sourcePath, targetPath, { overwrite: true });
+          console.log(`  ✓ ${fileName}`);
+        } catch (error) {
+          console.warn(`  ⚠️  Error copiando ${fileName}: ${error.message}`);
+        }
+      } else {
+        console.warn(`  ⚠️  Archivo ${fileName} no encontrado en el paquete`);
+      }
+    }
   }
 
   async update() {

package/package.json

@@ -1,42 +1,43 @@
-{
-  "name": "siesa-agents",
-  "version": "2.1.72-qa.24",
-  "description": "Paquete para instalar y configurar agentes SIESA en tu proyecto",
-  "main": "index.js",
-  "bin": {
-    "siesa-agents": "./bin/install.js"
-  },
-  "scripts": {
-    "postinstall": "node ./bin/install.js",
-    "build": "echo 'Build complete'"
-  },
-  "keywords": [
-    "siesa",
-    "bmad",
-    "agents",
-    "automation",
-    "cli"
-  ],
-  "author": "Sistemas de Información Empresarial",
-  "license": "MIT",
-  "files": [
-    "bmad/**/*",
-    "siesa-agents/**/*",
-    "vscode/**/*",
-    "github/**/*",
-    "claude/**/*",
-    "gemini/**/*",
-    "kiro/**/*",
-    "bin/**/*",
-    "resources/**/*",
-    "README.md",
-    "mcp.json"
-  ],
-  "engines": {
-    "node": ">=14.0.0"
-  },
-  "dependencies": {
-    "fs-extra": "^11.1.1",
-    "path": "^0.12.7"
-  }
-}
+{
+  "name": "siesa-agents",
+  "version": "2.1.72-qa.26",
+  "description": "Paquete para instalar y configurar agentes SIESA en tu proyecto",
+  "main": "index.js",
+  "bin": {
+    "siesa-agents": "./bin/install.js"
+  },
+  "scripts": {
+    "postinstall": "node ./bin/install.js",
+    "build": "echo 'Build complete'"
+  },
+  "keywords": [
+    "siesa",
+    "bmad",
+    "agents",
+    "automation",
+    "cli"
+  ],
+  "author": "Sistemas de Información Empresarial",
+  "license": "MIT",
+  "files": [
+    "bmad/**/*",
+    "siesa-agents/**/*",
+    "vscode/**/*",
+    "github/**/*",
+    "claude/**/*",
+    "gemini/**/*",
+    "kiro/**/*",
+    "bin/**/*",
+    "resources/**/*",
+    "README.md",
+    "mcp.json",
+    "recorder.bat"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "dependencies": {
+    "fs-extra": "^11.1.1",
+    "path": "^0.12.7"
+  }
+}

package/recorder.bat

@@ -0,0 +1,46 @@
+@echo off
+REM ============================================================
+REM  Grabador de Localizadores v4 — Launcher
+REM
+REM  Uso:
+REM    recorder          Modo ERP SIESA (login automatico)
+REM    recorder blank    Lienzo en blanco (sin login)
+REM    recorder fin      Financiero (qa.finance.siesa.dev)
+REM    recorder nom      Nomina (qas.nomina.siesa.dev)
+REM ============================================================
+
+set "KIT_DIR=%~dp0_siesa-agents\resources\playwright-kit"
+
+if not exist "%KIT_DIR%\tools\locator-recorder.spec.ts" (
+    echo [Grabador v4] ERROR: No se encontro playwright-kit en %KIT_DIR%
+    exit /b 1
+)
+
+pushd "%KIT_DIR%"
+
+if /i "%~1"=="blank" (
+    echo [Grabador v4] Lienzo en blanco
+    set "SKIP_LOGIN=1"
+    set "START_URL="
+    npm run recorder
+    set "SKIP_LOGIN="
+) else if /i "%~1"=="fin" (
+    echo [Grabador v4] Financiero — qa.finance.siesa.dev
+    set "SKIP_LOGIN=1"
+    set "START_URL=https://qa.finance.siesa.dev"
+    npm run recorder
+    set "SKIP_LOGIN="
+    set "START_URL="
+) else if /i "%~1"=="nom" (
+    echo [Grabador v4] Nomina — qas.nomina.siesa.dev
+    set "SKIP_LOGIN=1"
+    set "START_URL=https://qas.nomina.siesa.dev/mfe/payroll-frontend/"
+    npm run recorder
+    set "SKIP_LOGIN="
+    set "START_URL="
+) else (
+    echo [Grabador v4] ERP SIESA (login automatico)
+    npm run recorder
+)
+
+popd

package/siesa-agents/resources/playwright-kit/.env.example

@@ -5,11 +5,12 @@
 # ============================================================
 
 # Credenciales de login (Modo 1: ERP SIESA)
-TEST_USER=Carlos1
-TEST_PASS=1234
+TEST_USER=
+TEST_PASS=
+# ^^^ Definir con las credenciales de tu proyecto
 
-# URL base del ERP
-BASE_URL=https://erp-qa-beta.siesaerp.com
+# URL base del ambiente QA de tu proyecto (ej: https://qa.finance.siesa.dev)
+BASE_URL=
 
 # Base de datos a seleccionar en login (busca por texto en el combo)
 # Opciones tipicas: sqlserver, postgresql
@@ -18,7 +19,7 @@ DB_ENGINE=sqlserver
 # Cultura/idioma (comentar para usar la predeterminada del ERP)
 # CULTURE=es-CO
 
-# Ruta inicial del modulo a verificar/grabar (opcional, ej: /BLSurveyDocument/)
+# Ruta inicial del modulo a verificar/grabar (opcional, ej: /BLTuModulo/)
 # Usada por seed-example.spec.ts (test de navegacion) y por el grabador.
 # START_URL=
 

package/siesa-agents/resources/playwright-kit/README.md

@@ -5,8 +5,8 @@
 Kit portable para automatización E2E con agentes IA (Planner → Generator → Healer).
 Desarrollado por el equipo QA de I&D — Procesos y Calidad de Software.
 
-Validado en **9 réplicas**, 2 módulos (Encuestas + Capacitaciones), 271 tests,
-mejora de **160 min → 4 min**, 5 réplicas consecutivas sin Healer (R5-R9).
+Validado en múltiples proyectos Siesa (HCM, Financiero, Nómina),
+con mejoras de tiempo de pipeline de **160 min → 4 min** en réplicas consecutivas sin Healer.
 
 ## Estructura
 
@@ -49,7 +49,7 @@ npm install
 npx playwright install chromium
 
 # 4. Verificar con el seed
-TEST_USER=Carlos1 TEST_PASS=1234 npx playwright test tests/seed-example.spec.ts --headed
+TEST_USER=<tu_usuario> TEST_PASS=<tu_password> npx playwright test tests/seed-example.spec.ts --headed
 ```
 
 ## Reportes de ejecución
@@ -156,7 +156,7 @@ Ajustar `playwright.config.ts`:
 
 ```typescript
 use: {
-  baseURL: process.env.BASE_URL || 'https://erp-qa-beta.siesaerp.com',
+  baseURL: process.env.BASE_URL || 'http://localhost:5000',
 }
 ```
 
@@ -164,9 +164,9 @@ Variables de entorno:
 
 | Variable | Default | Descripción |
 |----------|---------|-------------|
-| `BASE_URL` | `https://erp-qa-beta.siesaerp.com` | URL base del ERP |
-| `TEST_USER` | `Carlos1` | Usuario ERP |
-| `TEST_PASS` | `1234` | Contraseña ERP |
+| `BASE_URL` | (definir en .env) | URL base del ambiente QA |
+| `TEST_USER` | (definir en .env) | Usuario ERP |
+| `TEST_PASS` | (definir en .env) | Contraseña ERP |
 | `DB_ENGINE` | `sqlserver` | BD a seleccionar en el login (match por texto) |
 | `PORTAL_LOGIN` | - | `1` para login Portal de Empleo |
 | `PORTAL_URL` | - | URL del portal |
@@ -197,20 +197,24 @@ Variables de entorno:
 
 ## Resultados validados
 
-| Réplica | Módulo | Tests | Resultado | Tiempo Pipeline | Tiempo Ejecución |
-|---------|--------|-------|-----------|-----------------|------------------|
-| R1 | Encuestas | 20 | 20/20 PASS | ~160 min | ~8 min |
-| R3 | Encuestas | 21 | 20/21 PASS | ~40 min | 4.2 min |
-| R4 | Capacitaciones | 16 | 16/16 PASS | ~35 min | 5.2 min |
-| R5-R7 | Capacitaciones | 16 | 16/16 PASS | <15 min | ~5 min |
-| R8 | Capacitaciones | 16 | 16/16 PASS | 4 min | 4 min |
-| R9 | Capacitaciones | 16 | 16/16 PASS | 4 min | 4 min |
+Kit validado en múltiples proyectos Siesa (HCM, Financiero, Nómina). La tabla
+siguiente conserva, a modo de historial, la evolución del tiempo de pipeline
+durante el piloto (réplicas consecutivas sin Healer):
+
+| Réplica | Tests | Resultado | Tiempo Pipeline | Tiempo Ejecución |
+|---------|-------|-----------|-----------------|------------------|
+| R1 | 20 | 20/20 PASS | ~160 min | ~8 min |
+| R3 | 21 | 20/21 PASS | ~40 min | 4.2 min |
+| R4 | 16 | 16/16 PASS | ~35 min | 5.2 min |
+| R5-R7 | 16 | 16/16 PASS | <15 min | ~5 min |
+| R8 | 16 | 16/16 PASS | 4 min | 4 min |
+| R9 | 16 | 16/16 PASS | 4 min | 4 min |
 
 ## Equipo
 
-- **Líder QA**: Juan Manuel Reina Montoya
-- **QA HCM**: Carlos Felipe Diaz Lombana, Jose Alejandro Bravo Escobar
-- **I&D**: Equipo de Procesos y Calidad de Software, SIESA
+- **Líder QA**: {nombre del líder del proyecto}
+- **Equipo QA**: {integrantes del equipo}
+- **Área**: {área o unidad organizacional}
 
 ## Capacitación
 

package/siesa-agents/resources/playwright-kit/helpers/blazor-e2e-helpers.ts

@@ -1,9 +1,9 @@
 /**
- * Blazor E2E Helpers — Módulo reutilizable para specs GP HCM
+ * Blazor E2E Helpers — Módulo reutilizable para specs Siesa ERP (Blazor Server)
  * Siesa Business ERP (Blazor Server + DevExpress + Radzen + SignalR)
  *
- * Extraído de Replica 4 (Capacitaciones) con refinamientos arquitectónicos.
- * Patrones validados en R1-R4 (4 módulos, 191+ tests).
+ * Desarrollado y validado en múltiples proyectos Siesa.
+ * Patrones validados en múltiples módulos (191+ tests).
  *
  * Uso:
  *   import { createObsCollector, login, searchInGrid, ... } from './blazor-e2e-helpers';
@@ -120,7 +120,7 @@ export async function settle(page: Page, extraMs = 0) {
 /**
  * Selecciona la BD en el login si el combo está presente y `DB_ENGINE` está definido.
  * Opt-in y best-effort: si no hay combo, `DB_ENGINE` no está, o algo falla, NO lanza
- * y deja el login directo (comportamiento validado R1-R9 intacto).
+ * y deja el login directo (comportamiento validado).
  * Soporta los dos mecanismos del ERP: DevExpress (SDKDropDownField) y <select> nativo.
  */
 export async function selectDbIfPresent(page: Page, db?: string) {
@@ -151,12 +151,9 @@ export async function selectDbIfPresent(page: Page, db?: string) {
 
 export async function login(page: Page, user?: string, pass?: string, db?: string) {
   const cred = {
-    user: user || process.env.TEST_USER || 'Carlos1',
-    password: pass || process.env.TEST_PASS || '1234',
+    user: user || process.env.TEST_USER || (() => { throw new Error('TEST_USER no definido. Configura TEST_USER en .env'); })(),
+    password: pass || process.env.TEST_PASS || (() => { throw new Error('TEST_PASS no definido. Configura TEST_PASS en .env'); })(),
   };
-  if (!user && !process.env.TEST_USER) {
-    console.warn('[blazor login] TEST_USER no definido — usando credencial demo "Carlos1". Define TEST_USER/TEST_PASS en .env para tu entorno.');
-  }
   await page.goto('/login');
   // Opt-in: solo selecciona BD si DB_ENGINE está definido y el combo existe (si no, login directo).
   await selectDbIfPresent(page, db);

package/siesa-agents/resources/playwright-kit/playwright.config.ts

@@ -59,7 +59,7 @@ export default defineConfig({
     }],
   ],
   use: {
-    baseURL: process.env.BASE_URL || 'https://erp-qa-beta.siesaerp.com',
+    baseURL: process.env.BASE_URL || (() => { console.warn('BASE_URL no definida en .env'); return 'http://localhost:5000'; })(),
     // CI corre en runners Linux sin display → headless obligatorio.
     headless: !!process.env.CI,
     viewport: null,

package/siesa-agents/resources/playwright-kit/reporters/agiletest-reporter.ts

@@ -8,7 +8,7 @@
  *   AGILETEST_CLIENT_ID, AGILETEST_CLIENT_SECRET
  *   AGILETEST_EXECUTION_ID  — ID interno de la ejecución (ej: 115230)
  *   AGILETEST_TC_ID          — ID interno del test case (ej: 1531352)
- *   AGILETEST_PROJECT_ID     — ID del proyecto Jira (default: 10032)
+ *   AGILETEST_PROJECT_ID     — ID del proyecto Jira (requerido, sin default)
  *   AGILETEST_TOTAL_STEPS    — Total de pasos del TC (default: 17)
  *                               Si se ejecutan menos, el TC queda "In Progress"
  */
@@ -23,15 +23,16 @@ import type {
 
 const AGILETEST_BASE = 'https://jira.agiletest.app';
 
-/** Status IDs para proyecto HCM (10032) */
+// Status IDs de AgileTest — cada proyecto Jira tiene IDs diferentes.
+// Configurar en .env si difieren de los defaults.
 const STATUS_IDS = {
-  todo: 15016,
-  pass: 15017,
-  fail: 15018,
-  blocked: 15019,
-  inProgress: 15020,
-  skipped: 15021,
-  retest: 15022,
+  todo:       Number(process.env.AT_STATUS_TODO       || 15016),
+  pass:       Number(process.env.AT_STATUS_PASS       || 15017),
+  fail:       Number(process.env.AT_STATUS_FAIL       || 15018),
+  blocked:    Number(process.env.AT_STATUS_BLOCKED    || 15019),
+  inProgress: Number(process.env.AT_STATUS_INPROGRESS || 15020),
+  skipped:    Number(process.env.AT_STATUS_SKIPPED    || 15021),
+  retest:     Number(process.env.AT_STATUS_RETEST     || 15022),
 } as const;
 
 interface StepResult {
@@ -66,7 +67,7 @@ function readConfig(): AgileTestConfig | null {
     clientSecret,
     executionId,
     tcId,
-    projectId: process.env.AGILETEST_PROJECT_ID || '10032',
+    projectId: process.env.AGILETEST_PROJECT_ID || (() => { console.warn('AGILETEST_PROJECT_ID no definido'); return ''; })(),
     totalSteps: parseInt(process.env.AGILETEST_TOTAL_STEPS || '17', 10),
   };
 }

package/siesa-agents/resources/playwright-kit/specs/architecture-brief-siesa-erp.md

@@ -76,9 +76,7 @@
 
 | Aplicación | Stack | URL base | Auth |
 |-----------|-------|----------|------|
-| Portal de Empleo | Blazor + DevExpress + Radzen | beta-aws.siesadev.com/BLPortalLogin | Email+Password |
-| ERP HCM | Blazor + DevExpress + SDK UI Kit | beta-aws.siesadev.com | MasterCrud + SSO |
-| Encuestas | Blazor + DevExpress + SDK UI Kit | beta-aws.siesadev.com | SSO |
+| ERP Siesa | Blazor + DevExpress + SDK UI Kit | {BASE_URL} | MasterCrud + SSO |
 | Financiero | React 18 + siesa-ui-kit + .NET 8 | qa.finance.siesa.dev/app | SSO |
 
 > **Patrones transferibles:** entity field, SDKSelectField, SDKCharField, TopBarButton,

package/siesa-agents/resources/playwright-kit/tests/seed-example.spec.ts

@@ -1,22 +1,22 @@
 /**
- * seed-gp.spec.ts — Seed file para Playwright Test Agents (GP / HCM)
+ * seed-example.spec.ts — Seed file para Playwright Test Agents (Siesa ERP)
  *
  * Establece el contexto de navegacion: Login ERP + seleccion de BD
  * Usado como referencia por los agentes Planner/Generator/Healer
  *
- * Ambiente por defecto: erp-qa-beta.siesaerp.com (baseURL del playwright.config.ts)
+ * Ambiente: definido por BASE_URL en .env (baseURL del playwright.config.ts)
  * Credenciales y BD se toman de .env (ver .env.example): TEST_USER / TEST_PASS / DB_ENGINE
  */
 import { test, expect } from '@playwright/test';
 
 // ─── Credenciales via env vars (alineadas con .env.example) ────────────────────
 const CRED = {
-  user: process.env.TEST_USER ?? 'Carlos1',
-  pass: process.env.TEST_PASS ?? '1234',
+  user: process.env.TEST_USER ?? '',
+  pass: process.env.TEST_PASS ?? '',
   bd: process.env.DB_ENGINE ?? 'sqlserver',
 };
 
-test.describe('GP HCM — Seed', () => {
+test.describe('Siesa ERP — Seed', () => {
   test('login ERP + verificar dashboard', async ({ page }) => {
     // 1. Navegar al login
     await page.goto('/login');

package/siesa-agents/resources/playwright-kit/tools/locator-recorder.spec.ts

@@ -32,15 +32,15 @@ import * as path from 'path';
 dotenvConfig({ path: path.join(__dirname, '..', '.env') });
 
 const CRED = {
-  user: process.env.TEST_USER || 'Carlos1',
-  password: process.env.TEST_PASS || '1234',
+  user: process.env.TEST_USER || '',
+  password: process.env.TEST_PASS || '',
   dbEngine: process.env.DB_ENGINE || 'sqlserver',
 };
 const OUTPUT_DIR = path.join(__dirname, '..', 'captured-locators');
 const SCREENSHOTS_DIR = path.join(OUTPUT_DIR, 'screenshots'); // v4: visual baseline
 const MODULES_DIR = path.join(OUTPUT_DIR, 'modules');         // v4: modulos reutilizables
 
-// ─── Login reutilizado del flujo encuestas ──────────────────────
+// ─── Login ERP (reutilizable por cualquier modulo) ──────────────────────
 async function login(page: Page) {
   await page.goto('/login');
   await page.waitForLoadState('networkidle').catch(() => {});
@@ -148,7 +148,7 @@ function generatePlaywrightTS(captures: any[]): {
   captures.forEach((c: any) => {
     let base = '';
     if (c.autoId) {
-      // Quitar prefijo SDK: SDKCharField_BLSurvey.Name → BLSurvey_Name
+      // Quitar prefijo SDK: SDKCharField_BLMiModulo.Campo → BLMiModulo_Campo
       base = c.autoId
         .replace(
           /^SDK(CharField|NumericField|Button|DateField|ComboBox|CheckBox|Grid|DataGrid|Dialog|TreeView|RadioGroup|Toolbar|DropDown|ListBox|Tab|Panel|Switch|Menu|Popup|Upload)_/,