siesa-agents 2.1.72-qa.2 → 2.1.72-qa.21

package/siesa-agents/resources/playwright-kit/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "playwright-agentes-ia-siesa",
+  "version": "1.0.0",
+  "description": "Kit Playwright + Agentes IA para automatización E2E — Siesa",
+  "scripts": {
+    "test": "npx playwright test",
+    "test:headed": "npx playwright test --headed",
+    "test:seed": "npx playwright test tests/seed-example.spec.ts --headed",
+    "recorder": "npx playwright test tools/locator-recorder.spec.ts --headed --timeout 3600000",
+    "test:proposed": "npx playwright test proposed/ --config playwright.config.ts",
+    "report": "npx playwright show-report",
+    "report:allure": "npx allure generate allure-results -o allure-report --clean && npx allure open allure-report",
+    "report:monocart": "npx monocart show-report monocart-report/index.html"
+  },
+  "keywords": ["playwright", "e2e", "siesa", "qa", "agentes-ia"],
+  "author": "Equipo QA I&D — Procesos y Calidad de Software, SIESA",
+  "license": "UNLICENSED",
+  "private": true,
+  "type": "commonjs",
+  "devDependencies": {
+    "@playwright/test": "^1.60.0",
+    "allure-commandline": "^2.42.0",
+    "allure-playwright": "^3.9.0",
+    "dotenv": "^16.4.5",
+    "monocart-reporter": "^2.11.2"
+  }
+}

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

@@ -0,0 +1,60 @@
+/**
+ * Configuracion Playwright — Kit Agentes IA Siesa
+ * Reporters: list + HTML + Allure + Monocart
+ */
+import { defineConfig } from '@playwright/test';
+import { config as dotenvConfig } from 'dotenv';
+
+dotenvConfig(); // carga .env personal del QA (gitignored); usa defaults si no existe
+
+export default defineConfig({
+  globalSetup: './global-setup.ts',
+  testDir: '.',
+  timeout: 120_000,
+  expect: { timeout: 10_000 },
+  fullyParallel: false,
+  // R-CI-03: Blazor Server (SignalR) requiere reintentos ante fallos transitorios.
+  retries: process.env.CI ? 2 : 1,
+  workers: 1,
+  reporter: [
+    ['list'],
+    ['html', { open: 'never', outputFolder: 'playwright-report' }],
+    // R-CI-07: junit.xml para GitHub Actions / Jenkins (solo en CI).
+    ...(process.env.CI ? [['junit', { outputFile: 'test-results/junit.xml' }] as const] : []),
+    ['allure-playwright', {
+      outputFolder: 'allure-results',
+      detail: true,
+      suiteTitle: process.env.SUITE_TITLE || 'E2E — Pipeline Agentes IA',
+    }],
+    ['monocart-reporter', {
+      name: process.env.SUITE_TITLE || 'E2E — Pipeline Agentes IA',
+      outputFile: 'monocart-report/index.html',
+    }],
+  ],
+  use: {
+    baseURL: process.env.BASE_URL || 'https://erp-qa-beta.siesaerp.com',
+    // CI corre en runners Linux sin display → headless obligatorio.
+    headless: !!process.env.CI,
+    viewport: null,
+    // Timeouts parametrizables por entorno (CI lento puede subirlos sin tocar código).
+    actionTimeout: Number(process.env.ACTION_TIMEOUT ?? 30_000),
+    navigationTimeout: Number(process.env.NAVIGATION_TIMEOUT ?? 30_000),
+    // En CI solo capturar evidencia ante fallo para no saturar disco.
+    screenshot: process.env.CI ? 'only-on-failure' : 'on',
+    // En CI, trace solo en el primer reintento (archivos más pequeños que retain-on-failure).
+    trace: process.env.CI ? 'on-first-retry' : 'retain-on-failure',
+    video: process.env.CI ? 'off' : 'on',
+  },
+  projects: [
+    {
+      name: 'chromium',
+      use: {
+        browserName: 'chromium',
+        launchOptions: {
+          slowMo: 150,
+          args: ['--force-device-scale-factor=1', '--high-dpi-support=1', '--start-maximized'],
+        },
+      },
+    },
+  ],
+});

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

@@ -0,0 +1,252 @@
+/**
+ * AgileTest Playwright Reporter
+ *
+ * Sincroniza resultados de Playwright con una Ejecución de Pruebas en AgileTest.
+ * Se desactiva silenciosamente si las env vars no están definidas.
+ *
+ * Env vars requeridas:
+ *   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_TOTAL_STEPS    — Total de pasos del TC (default: 17)
+ *                               Si se ejecutan menos, el TC queda "In Progress"
+ */
+import type {
+  Reporter,
+  TestCase,
+  TestResult,
+  FullConfig,
+  Suite,
+  FullResult,
+} from '@playwright/test/reporter';
+
+const AGILETEST_BASE = 'https://jira.agiletest.app';
+
+/** Status IDs para proyecto HCM (10032) */
+const STATUS_IDS = {
+  todo: 15016,
+  pass: 15017,
+  fail: 15018,
+  blocked: 15019,
+  inProgress: 15020,
+  skipped: 15021,
+  retest: 15022,
+} as const;
+
+interface StepResult {
+  paso: string;
+  title: string;
+  status: 'passed' | 'failed' | 'timedOut' | 'skipped' | 'interrupted';
+  duration: number;
+  error?: string;
+}
+
+interface AgileTestConfig {
+  clientId: string;
+  clientSecret: string;
+  executionId: string;
+  tcId: string;
+  projectId: string;
+  totalSteps: number;
+}
+
+function readConfig(): AgileTestConfig | null {
+  const clientId = process.env.AGILETEST_CLIENT_ID;
+  const clientSecret = process.env.AGILETEST_CLIENT_SECRET;
+  const executionId = process.env.AGILETEST_EXECUTION_ID;
+  const tcId = process.env.AGILETEST_TC_ID;
+
+  if (!clientId || !clientSecret || !executionId || !tcId) {
+    return null;
+  }
+
+  return {
+    clientId,
+    clientSecret,
+    executionId,
+    tcId,
+    projectId: process.env.AGILETEST_PROJECT_ID || '10032',
+    totalSteps: parseInt(process.env.AGILETEST_TOTAL_STEPS || '17', 10),
+  };
+}
+
+async function getToken(clientId: string, clientSecret: string): Promise<string> {
+  const res = await fetch(`${AGILETEST_BASE}/api/apikeys/authenticate`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ clientId, clientSecret }),
+  });
+
+  if (!res.ok) {
+    throw new Error(`AgileTest auth failed: ${res.status} ${await res.text()}`);
+  }
+
+  // La respuesta es el token como string con comillas
+  const raw = await res.text();
+  return raw.replace(/^"|"$/g, '');
+}
+
+class AgileTestReporter implements Reporter {
+  private results: StepResult[] = [];
+  private config: AgileTestConfig | null = null;
+  private enabled = false;
+
+  onBegin(_config: FullConfig, _suite: Suite): void {
+    this.config = readConfig();
+    this.enabled = this.config !== null;
+
+    if (!this.enabled) {
+      console.log('[AgileTest] Reporter desactivado — env vars no definidas');
+    } else {
+      console.log('[AgileTest] Reporter activo — sincronizará con ejecución', this.config!.executionId);
+    }
+  }
+
+  onTestEnd(test: TestCase, result: TestResult): void {
+    if (!this.enabled) return;
+
+    const match = test.title.match(/Paso\s+(\d+|manual)/i);
+    const paso = match ? match[1] : '?';
+
+    this.results.push({
+      paso,
+      title: test.title,
+      status: result.status,
+      duration: result.duration,
+      error: result.errors?.[0]?.message?.substring(0, 300),
+    });
+  }
+
+  async onEnd(_result: FullResult): Promise<void> {
+    if (!this.enabled || this.results.length === 0) return;
+
+    const config = this.config!;
+
+    // Determinar si la ejecución fue completa o parcial
+    const executedSteps = this.results.filter(r => r.paso !== '?').length;
+    const isPartial = executedSteps < config.totalSteps;
+
+    const hasFailed = this.results.some(
+      r => r.status === 'failed' || r.status === 'timedOut' || r.status === 'interrupted',
+    );
+    const hasSkipped = this.results.some(r => r.status === 'skipped');
+
+    let globalStatusId: number;
+    let statusLabel: string;
+
+    if (hasFailed) {
+      globalStatusId = STATUS_IDS.fail;
+      statusLabel = 'FAIL';
+    } else if (isPartial) {
+      globalStatusId = STATUS_IDS.inProgress;
+      statusLabel = `IN PROGRESS (${executedSteps}/${config.totalSteps})`;
+    } else if (hasSkipped) {
+      globalStatusId = STATUS_IDS.skipped;
+      statusLabel = 'SKIPPED';
+    } else {
+      globalStatusId = STATUS_IDS.pass;
+      statusLabel = 'PASS';
+    }
+
+    try {
+      // 1. Autenticar
+      console.log('[AgileTest] Autenticando...');
+      const token = await getToken(config.clientId, config.clientSecret);
+
+      const headers = {
+        'Content-Type': 'application/json',
+        Authorization: `JWT ${token}`,
+      };
+
+      // 2. PUT resultado del TC en la ejecución
+      console.log(`[AgileTest] Actualizando TC ${config.tcId} → ${statusLabel}`);
+      const putUrl = `${AGILETEST_BASE}/ds/test-executions/${config.executionId}/test-case/${config.tcId}`;
+      const putRes = await fetch(putUrl, {
+        method: 'PUT',
+        headers,
+        body: JSON.stringify({
+          testExecutionItem: { result: globalStatusId },
+          projectId: config.projectId,
+        }),
+      });
+
+      if (!putRes.ok) {
+        console.error(`[AgileTest] PUT falló: ${putRes.status} ${await putRes.text()}`);
+        return;
+      }
+
+      const putData = await putRes.json();
+      const itemId = putData.id;
+      console.log(`[AgileTest] Resultado actualizado → ${statusLabel} (itemId: ${itemId})`);
+
+      // 3. POST comentario con tabla detallada vía test-execution-items
+      const comment = this.buildComment(statusLabel, isPartial, config.totalSteps);
+      const commentUrl = `${AGILETEST_BASE}/ds/test-execution-items/${itemId}/comments`;
+      const commentRes = await fetch(commentUrl, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify({ text: comment, projectId: config.projectId }),
+      });
+
+      if (commentRes.ok) {
+        console.log('[AgileTest] Comentario agregado con detalle por paso');
+      } else {
+        console.warn(`[AgileTest] Comentario falló: ${commentRes.status} (no crítico)`);
+      }
+    } catch (err) {
+      console.error('[AgileTest] Error sincronizando resultados:', err);
+    }
+  }
+
+  private buildComment(globalStatus: string, isPartial: boolean, totalSteps: number): string {
+    const sorted = [...this.results].sort((a, b) => {
+      const na = a.paso === 'manual' ? 999 : a.paso === '?' ? 1000 : Number(a.paso);
+      const nb = b.paso === 'manual' ? 999 : b.paso === '?' ? 1000 : Number(b.paso);
+      return na - nb;
+    });
+
+    const totalDuration = this.results.reduce((sum, r) => sum + r.duration, 0);
+    const passed = this.results.filter(r => r.status === 'passed').length;
+    const failed = this.results.filter(
+      r => r.status === 'failed' || r.status === 'timedOut' || r.status === 'interrupted',
+    ).length;
+    const skipped = this.results.filter(r => r.status === 'skipped').length;
+    const pending = totalSteps - this.results.filter(r => r.paso !== '?').length;
+
+    const timestamp = new Date().toISOString().replace('T', ' ').substring(0, 19);
+
+    const lines = [
+      `*Playwright Automated Run — ${timestamp}*`,
+      `*Resultado: ${globalStatus}* | ${passed} passed, ${failed} failed, ${skipped} skipped${pending > 0 ? `, ${pending} pending` : ''} | ${this.formatDuration(totalDuration)}`,
+      '',
+      '||Paso||Nombre||Status||Duración||',
+    ];
+
+    for (const r of sorted) {
+      const icon = r.status === 'passed' ? '(/)' : r.status === 'skipped' ? '(i)' : '(x)';
+      const statusText = r.status === 'passed' ? 'PASS' : r.status === 'skipped' ? 'SKIP' : 'FAIL';
+      lines.push(`|${r.paso}|${r.title}|${icon} ${statusText}|${this.formatDuration(r.duration)}|`);
+    }
+
+    if (isPartial) {
+      lines.push(`|—|_Pasos ${this.results.length + 1}-${totalSteps} pendientes_|(//) TO DO|—|`);
+    }
+
+    if (failed > 0) {
+      lines.push('', '*Errores:*');
+      for (const r of sorted.filter(s => s.error)) {
+        lines.push(`* Paso ${r.paso}: {noformat}${r.error}{noformat}`);
+      }
+    }
+
+    return lines.join('\n');
+  }
+
+  private formatDuration(ms: number): string {
+    if (ms < 1000) return `${ms}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+  }
+}
+
+export default AgileTestReporter;

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

@@ -0,0 +1,85 @@
+# Architecture Brief — SIESA ERP (Blazor Server + DevExpress + Radzen)
+
+> Brief lleno para la plataforma SIESA ERP. Los patrones aquí documentados son
+> **transferibles entre módulos** porque todos comparten el mismo stack (SDK UI Kit).
+> Lo que el agente aprende en un módulo le sirve en todos.
+
+---
+
+## Stack y Comportamiento
+
+- **Framework UI:** Blazor Server con SignalR (conexión persistente)
+- **Componentes:** DevExpress BlazorGrid + Radzen Dialogs + SDK UI Kit
+- **Pre-carga requerida:** SÍ — navegar a la URL base (sin parámetros `dat=`) para inicializar
+  SignalR, esperar `networkidle` + 3s, y luego navegar a la URL real.
+- **Cultura/Idioma:** ES con tildes. Algunos dropdowns (Género, Estado civil) pueden aparecer
+  en EN según config del servidor → **intentar ES primero, fallback EN**.
+- **Auth:** MasterCrud + SSO (ERP) · Email+Password (Portal de Empleo).
+
+## Patrones de Interacción
+
+### Campos de texto (SDKCharField)
+- **Selector:** `[data-automation-id="SDKCharField_{CAMPO}"] input.dxbl-text-edit-input`
+- **Interacción:** click → `fill("")` → `pressSequentially(valor, { delay: 30 })`
+
+### Campos numéricos (SDKNumericField)
+- **Selector:** `[data-automation-id="NumericField_{CAMPO}"] input.dxbl-text-edit-input`
+- **Nota:** DevExpress formatea con decimales — assertion con regex `/^valor(\.00)?$/`.
+
+### Dropdowns simples (SDKSelectField — Radzen)
+- **Selector:** `[data-automation-id="SDKSelectField_{CAMPO}"] span.rz-dropdown-label`
+- **Interacción:** click → esperar opciones → click en option por texto (ES, fallback EN).
+
+### Entity fields (SDKEntityField — dropdown con búsqueda)
+- **Input:** `[data-automation-id="SDKEntityField_{CAMPO}"] input`
+- **Primera opción:** `[data-automation-id="SDKEntityField_{CAMPO}_1"]`
+- **Lupa:** `[data-automation-id="SDKEntityField_{CAMPO}_SearchBtn"]`
+- **Crear:** `[data-automation-id="SDKEntityField_{CAMPO}_CreateBtn"]`
+- **Dropdown:** click input → esperar lista → click `_1`
+- **Búsqueda:** click lupa → submit → dblclick en celda del grid
+- **Crear inline:** click crear → llenar Id + Name + Status Activo
+
+### Textareas (SDKTextField) — descripción SIEMPRE es textarea
+- **Selector:** `[data-automation-id="SDKTextField_{CAMPO}"] textarea`
+- **Interacción:** click → Ctrl+A → `fill("")` → `fill(valor)`
+
+### Campos de fecha (Radzen DatePicker)
+- **Interacción:** `click({ clickCount: 3 })` → `pressSequentially(MM/DD/YYYY)` → Tab
+
+### Botones toolbar (TopBarButton)
+- **Editar:** `[data-automation-id="TopBarButton_Action.Edit"]`.last()
+- **Guardar:** `[data-automation-id="TopBarButton_Action.Save"]`.last()
+- **Cancelar:** `[data-automation-id="TopBarButton_Action.Cancel"]`.last()
+
+### Dialogs y Popups
+- **Wrapper:** `.rz-dialog-wrapper` (puede interceptar clicks)
+- **Cerrar:** JS click en `a.rz-dialog-titlebar-close`
+- **Grid DevExpress:** `td` con `role="gridcell"`, dblclick para seleccionar
+
+## Problemas Conocidos
+
+- [x] **Pre-load SignalR:** navegar a URL base sin `dat=` primero, luego URL real.
+- [x] **Modal reconexión Blazor:** `#components-reconnect-modal` intercepta clicks → esperar hidden o force click.
+- [x] **Loader SDK:** `.sdk-loader` bloquea interacción → esperar `state: hidden` (timeout 10s).
+- [x] **Toolbar duplicada:** sidebar oculto duplica botones → usar `.last()`.
+- [x] **Cultura dual:** dropdowns pueden mostrar ES o EN → intentar ES, fallback EN.
+- [x] **Celda de filtro DevExpress:** tras `.fill()` presionar `Enter` para activar el binding.
+- [x] **Listados dual-mode:** primera visita = formulario de búsqueda; después = grid.
+
+## Helpers disponibles (`helpers/blazor-e2e-helpers.ts`)
+
+`login` · `fillSDKText` · `fillSDKTextArea` · `fillFechaRadzen` · `clickToolbar` ·
+`closeOverlays` · `clickActivo` · `waitForSave` · `selectEntityPopup` · `searchInGrid` ·
+`navigateTo` · `waitForGrid` · `getFechas` · `createObsCollector`
+
+## Aplicaciones registradas
+
+| 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 |
+| Financiero | React 18 + siesa-ui-kit + .NET 8 | qa.finance.siesa.dev/app | SSO |
+
+> **Patrones transferibles:** entity field, SDKSelectField, SDKCharField, TopBarButton,
+> pre-load SignalR, modal reconexión, loader SDK, toolbar duplicada, cultura dual.

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

@@ -0,0 +1,109 @@
+# Architecture Brief — SIESA React (Vite + TanStack + siesa-ui-kit)
+
+> Brief para las apps SIESA construidas con el **stack corporativo React** (la arquitectura
+> objetivo de los microservicios nuevos). Los patrones aquí son **transferibles entre módulos**
+> porque todos comparten siesa-ui-kit + MasterCrud + LookupField.
+>
+> ⚠️ Este es el stack **distinto al ERP Blazor**. Si la app objetivo es Blazor Server / DevExpress /
+> Radzen, usa `architecture-brief-siesa-erp.md`, NO este.
+
+---
+
+## Stack y Comportamiento
+
+- **Framework UI:** React (componentes `.tsx`, hooks) · Vite 7+ · TanStack Router (file-based)
+- **Componentes:** siesa-ui-kit (librería propia) + Radix UI + shadcn/ui. Orquestador de masters: `MasterCrud`.
+- **Estado:** Zustand (cliente) + TanStack Query (servidor). Los datos llegan async → esperar fin de fetch.
+- **Pre-carga requerida:** NO. No hay SignalR ni conexión persistente (a diferencia de Blazor).
+  Esperar a que TanStack Query resuelva (spinner/skeleton oculto) en vez de `networkidle` fijo.
+- **Cultura/Idioma:** ES por defecto; i18n por `react-i18next`/locale. Confirmar en el brief del módulo.
+- **Auth:** SSO corporativo (JWT con TenantId). `Company-ID` en headers para operaciones multi-compañía.
+- **Microfrontends:** Single-SPA (default). La app se monta en `#single-spa-application`.
+
+## Ambiente
+
+- **URL base:** {URL — ej: qa.finance.siesa.dev/app}
+- **Usuario de prueba:** {referencia a env var}
+- **Password:** {referencia a env var, NUNCA literal en el repo}
+
+## Estrategia de selectores (orden de preferencia)
+
+> En React, prioriza selectores **semánticos y estables** sobre CSS. Si el componente no expone
+> rol/label accesible, pide `data-testid` al equipo y documéntalo aquí; no uses clases de Tailwind
+> como selector (cambian con el estilo).
+
+1. `getByRole('button', { name: 'Guardar' })` / `getByRole('textbox', { name: 'Código' })`
+2. `getByLabel('Nombre')` (campos asociados a `<label>`)
+3. `getByTestId('...')` (`data-testid` acordado con el equipo)
+4. CSS solo como último recurso, documentado abajo.
+
+## Patrones de Interacción (completar con lo confirmado por módulo/dev)
+
+### Campos de texto / número (React Hook Form)
+- **Selector:** `getByLabel('{CAMPO}')` o `getByRole('textbox', { name: '{CAMPO}' })`
+- **Interacción:** `click` → `fill('')` → `fill(valor)`. La validación Zod aparece on-blur/submit.
+- **Nota:** assertion sobre el valor con `toHaveValue`; para errores, `getByText` del mensaje Zod.
+
+### Dropdowns / Select (siesa-ui-kit / Radix Select)
+- **Selector trigger:** `getByRole('combobox', { name: '{CAMPO}' })`
+- **Interacción:** click trigger → `getByRole('option', { name: '{VALOR}' })` → click.
+
+### LookupField (selección de registros maestros — patrón R-LF-001)
+- **Input:** `getByRole('combobox', { name: '{CAMPO}' })` o `getByTestId('lookup-{campo}')`
+- **Interacción:** escribir término → esperar lista (TanStack Query) → click opción.
+- **Dependientes (cascada):** seleccionar el padre primero; el hijo se habilita por `dependencies`.
+
+### MasterCrud (orquestador de masters)
+- **Crear:** botón `getByRole('button', { name: 'Nuevo' })` → llenar form → `Guardar`.
+- **Editar:** seleccionar fila de la grilla → `Editar` → modificar → `Guardar`.
+- **Navegación:** modal / sidebar / page según prop `navigationType` (confirmar en brief del módulo).
+
+### Formularios (React Hook Form + Zod)
+- **Submit:** `getByRole('button', { name: 'Guardar' })`.
+- **Validación:** los errores Zod se renderizan como texto cerca del campo → `getByText(/mensaje/)`.
+
+### Botones / Toolbar
+- **Guardar / Cancelar / Eliminar:** `getByRole('button', { name: '{ACCIÓN}' })`.
+
+### Dialogs y Popups (Radix Dialog)
+- **Wrapper:** `getByRole('dialog')` · **Cerrar:** `getByRole('button', { name: /cerrar|close/i })`.
+
+## Estados de carga y espera (clave en React)
+
+- **No** uses esperas fijas. Espera a que el spinner/skeleton de TanStack Query desaparezca:
+  `await expect(page.getByRole('progressbar')).toBeHidden()` o el `data-testid` del loader del kit.
+- Tras guardar, espera el toast de éxito o la invalidación de query (la grilla se refresca sola).
+
+## Problemas Conocidos (marcar los que apliquen por módulo)
+
+- [ ] **Carga async TanStack Query:** esperar fin de fetch antes de interactuar/aseverar.
+- [ ] **Toast de confirmación:** aparece y se auto-oculta → capturarlo rápido o assert por rol `status`.
+- [ ] **Single-SPA mount:** la app vive bajo `#single-spa-application`; esperar montaje.
+- [ ] **Dark mode (class-based):** no afecta selectores semánticos; sí selectores por color.
+- [ ] **Otro:** {describir}
+
+## Datos de Prueba de referencia
+
+| Campo | Valor | Patrón | Notas |
+|-------|-------|--------|-------|
+| {campo} | {valor} | texto/select/lookup/fecha | {nota} |
+
+## Helpers disponibles (`helpers/react-e2e-helpers.ts`)
+
+`createObsCollector` · `login` · `waitForQuery` · `fillField` · `selectOption` · `selectLookup` ·
+`setToggle` · `submitForm` · `clickAction` · `expectToast` · `expectFieldError` · `navigateTo` ·
+`waitForGrid` · `getFechas` · `step` · `generateRunId`
+
+> ⚠️ **Scaffold:** los selectores concretos de siesa-ui-kit no están documentados en el repo,
+> así que varios helpers traen suposiciones marcadas con `TODO[brief]` (rol del LookupField,
+> loader, ruta de login SSO). Cada helper acepta `byTestId`/overrides — confírmalos contra la
+> app real (vía dev o grabador) antes de promover specs a `tests/`.
+
+## Aplicaciones registradas (React)
+
+| Aplicación | Stack | URL base | Auth |
+|-----------|-------|----------|------|
+| Financiero | React 18 + siesa-ui-kit + .NET 8 | qa.finance.siesa.dev/app | SSO |
+
+> **Retroalimentación del Healer:** cada patrón/quirk nuevo que descubra el Healer se agrega aquí
+> con prefijo `[HEALER]` (validar que se repita en ≥2 corridas antes de marcarlo estable).

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

@@ -0,0 +1,69 @@
+# Architecture Brief — {NOMBRE_APLICACIÓN}
+
+> **Qué es:** el insumo que le da al Agente Ejecutor E2E el conocimiento del stack, los
+> selectores y los patrones de interacción de la app objetivo. Con brief, el agente genera
+> specs correctos al primer intento (~85-90% autonomía); sin él, descubre por prueba y error.
+>
+> **Cómo llenarlo:** (1) un dev lo completa en ~5 min, o (2) QA usa el grabador
+> (`tools/locator-recorder.spec.ts`) en una sesión exploratoria y lo llena.
+
+---
+
+## Stack y Comportamiento
+
+- **Framework UI:** {ej: Blazor Server con SignalR / React 18 / Angular}
+- **Componentes:** {ej: DevExpress BlazorGrid + Radzen Dialogs + SDK UI Kit}
+- **Pre-carga requerida:** {SI/NO — si SI, describir el patrón. Ej: "navegar a URL base sin parámetros para inicializar SignalR, luego navegar a la URL real"}
+- **Cultura/Idioma:** {ej: "ES con tildes; algunos dropdowns aparecen en EN según config del servidor — intentar ES primero"}
+- **Auth:** {ej: Email+Password / SSO corporativo / MasterCrud}
+
+## Ambiente
+
+- **URL base:** {URL}
+- **Usuario de prueba:** {usuario o referencia a env var}
+- **Password:** {referencia a env var, NUNCA literal en el repo}
+
+## Patrones de Interacción (completar solo los que apliquen)
+
+### Campos de texto
+- **Selector:** `{ej: [data-automation-id="SDKCharField_{CAMPO}"] input.dxbl-text-edit-input}`
+- **Interacción:** {ej: click → fill("") → pressSequentially(valor, { delay: 30 })}
+
+### Campos numéricos
+- **Selector:** `{...}`
+- **Nota:** {ej: DevExpress formatea con decimales — "70" se muestra como "70.00"}
+
+### Dropdowns simples
+- **Selector:** `{ej: [data-automation-id="SDKSelectField_{CAMPO}"] span.rz-dropdown-label}`
+- **Interacción:** {click → esperar opciones → click en option por texto}
+
+### Entity fields (dropdown con búsqueda/lupa)
+- **Input:** `{...}` · **Primera opción:** `{..._1}` · **Lupa:** `{..._SearchBtn}` · **Crear:** `{..._CreateBtn}`
+- **Interacción:** {dropdown: click input → esperar lista → click `_1`; búsqueda: click lupa → submit → dblclick celda}
+
+### Campos de fecha
+- **Selector:** `{...}` · **Interacción:** {ej: click({clickCount:3}) → pressSequentially(MM/DD/YYYY) → Tab}
+
+### Botones toolbar
+- **Editar / Guardar / Cancelar:** `{...}`
+
+### Dialogs y Popups
+- **Wrapper / cerrar / grid:** `{...}`
+
+## Problemas Conocidos (marcar los que apliquen)
+
+- [ ] **Pre-load:** {descripción}
+- [ ] **Modal de reconexión:** {selector + cómo manejarlo}
+- [ ] **Loader bloqueante:** {selector + esperar hidden}
+- [ ] **Toolbar duplicada:** {usar `.last()`}
+- [ ] **Cultura dual ES/EN:** {intentar ES, fallback EN}
+- [ ] **Otro:** {describir}
+
+## Datos de Prueba de referencia
+
+| Campo | Valor | Patrón | Notas |
+|-------|-------|--------|-------|
+| {campo} | {valor} | texto/dropdown/entity/fecha | {nota} |
+
+> **Retroalimentación del Healer:** cada vez que el Healer descubra un patrón/quirk nuevo,
+> agregarlo aquí con prefijo `[HEALER]` para que los próximos módulos se beneficien.