@arcadialdev/arcality 4.1.0 → 4.1.1

package/.agent/skills/form-expert.md

@@ -1,102 +0,0 @@
----
-name: form-expert
-description: Metodología experta para explorar, identificar y llenar formularios complejos en aplicaciones web.
----
-
-# Form Expert Skill
-
-Esta habilidad define el protocolo que el agente DEBE seguir cuando la misión involucra llenar, crear o editar registros a través de formularios.
-
-## Principio Fundamental
-**NUNCA interactúes con un campo que no hayas inspeccionado primero.** Si un componente tiene un nombre genérico, un tag inferred como `[INFERRED]`, o simplemente no estás seguro de qué es, usa `inspect_element_details` ANTES de hacer click o fill.
-
-## Protocolo de Formularios (4 fases obligatorias)
-
-### Fase 1: RECONOCIMIENTO (Scan)
-Antes de llenar cualquier campo, dedica tu primer turno en el formulario a **analizar todos los componentes visibles**:
-
-1. **Lee la lista completa de CURRENT COMPONENTS** — identifica:
-   - Campos de tipo FIELD (inputs, textareas, selects)
-   - Campos con label visible (prioritarios)
-   - Campos sin label o con nombre genérico (requieren inspección)
-   - Botones de acción (GUARDAR, CANCELAR, etc.)
-   - Tabs o pestañas si el formulario tiene secciones
-
-2. **Clasifica los campos** en:
-   - ✅ **Confiables**: Tienen un nombre claro como `[input] Título del documento`
-   - ⚠️ **Sospechosos**: Tienen nombre genérico como `[input] Editar` o `[INFERRED] xxx`
-   - ❌ **Desconocidos**: Solo tienen tag genérico como `[input]`
-
-3. **Para campos sospechosos o desconocidos**: Usa `inspect_element_details` para obtener:
-   - El placeholder text
-   - El aria-label
-   - El atributo name o id
-   - Si está disabled o readonly
-
-### Fase 2: PLANIFICACIÓN (Plan)
-Con la información del reconocimiento, planifica la secuencia de acciones:
-
-1. **Prioriza los campos obligatorios** — los que tienen asterisco (*), clase "required", o están marcados en rojo.
-2. **Genera datos únicos** — Si la misión dice "genérico" o "aleatorio", genera datos que incluyan un timestamp o ID único para evitar duplicados. Ejemplo: `TEST-${timestamp}` o `Prueba QA Feb24`.
-3. **Planifica el orden**: Llena los campos de arriba a abajo, izquierda a derecha, siguiendo el orden del DOM.
-
-### Fase 3: EJECUCIÓN (Act)
-Ejecuta las acciones planificadas:
-
-1. **Llena múltiples campos por turno** — No pierdas un turno por campo. Agrupa 3-5 fills en una sola llamada a `perform_ui_actions`.
-2. **Para cada campo fill**: click + fill (en ese orden). El click asegura que el campo tiene focus.
-3. **Para dropdowns/selects** — Protocolo de Re-render:
-   - **Turno A**: Click para abrir el dropdown, espera el siguiente turno para ver las opciones.
-   - **Turno B**: Click en la opción deseada. ¡PRECAUCIÓN DE SEGURIDAD DOM! Si el formulario requiere llenar más campos después de seleccionar (ej. se habilitan nuevos inputs), **DETENTE AQUÍ**. NO agrupes el select con los siguientes fills en el mismo turno, porque React re-redenrizará el DOM y tus IDs se romperán. Espera al Turno C para seguir llenando.
-   - Si la selección del dropdown era el *último* paso, Y YA NO HAY MÁS campos que llenar, SÍ puedes hacer click en `Siguiente`/`Guardar` en ese mismo turno.
-4. **Si un fill falla**: NO reintentes inmediatamente. Usa `inspect_element_details` para ver si el campo es un select, un datepicker, o tiene un overlay encima.
-
-### Fase 4: VERIFICACIÓN (Verify)
-Antes de hacer GUARDAR:
-
-1. **Usa `validate_element_state`** en el botón de GUARDAR para confirmar que está enabled.
-2. **Revisa visualmente** si hay campos en rojo o mensajes de error.
-3. **Solo entonces** haz click en GUARDAR.
-4. **Después de GUARDAR**: Espera la respuesta de la UI. Si aparece un toast de éxito o regresas a la lista, la misión fue exitosa.
-
-## Manejo de Errores en Formularios
-
-### Si un campo falla con Timeout:
-```
-1. NO reintentes el mismo click/fill inmediatamente
-2. Usa inspect_element_details en ese IDX
-3. Analiza si:
-   - El elemento está cubierto por un overlay/modal
-   - El elemento es readonly/disabled  
-   - El IDX cambió (la página se re-renderizó)
-4. Si el elemento no sirve, busca un campo alternativo con nombre similar
-```
-
-### Si aparece un error de "duplicado" o "ya existe":
-```
-1. Identifica qué campo causó el error (claves, códigos, nombres)
-2. Cambia el valor a algo único (agrega sufijo numérico o timestamp)
-3. Reintenta GUARDAR
-```
-
-### Si el formulario tiene tabs o secciones:
-```
-1. Llena los campos de la sección actual PRIMERO.
-2. Identifica el elemento de la pestaña: Busca el texto de la pestaña (ej: "CAMPOS DE LA FORMA") en componentes tipo ACTION.
-3. PRECISIÓN: Evita hacer click en contenedores grandes que agrupan varias pestañas. Prefiere el elemento más pequeño (span o label) que contenga el texto exacto.
-4. Haz click en la pestaña. Si un click simple no funciona tras 2 intentos, usa 'double_click'.
-5. Espera el siguiente turno para ver los nuevos campos.
-```
-
-## Uso de Double Click
-- Úsalo SOLO cuando:
-  - La misión lo pida explícitamente (ej: "haz doble clic en la celda").
-  - Un elemento (como una pestaña o un icono) no responda tras dos intentos de click simple.
-  - Quieras activar modos de edición en tablas o componentes complejos.
-
-## Anti-patrones (NUNCA hagas esto)
-- ❌ Hacer click en un campo `[INFERRED]` sin inspeccionarlo primero
-- ❌ Intentar llenar TODO el formulario en el primer turno sin saber qué campos hay
-- ❌ Hacer click en el botón GUARDAR sin haber verificado que los campos están llenos
-- ❌ Reintentar la misma acción fallida sin investigar la causa
-- ❌ Asumir que un componente con nombre largo (>50 chars) es un campo — probablemente es un contenedor

package/.agent/skills/investigation-protocol.md

@@ -1,61 +0,0 @@
----
-name: investigation-protocol
-description: Protocolo obligatorio de investigación cuando una acción falla o un elemento es ambiguo.
----
-
-# Investigation Protocol Skill
-
-## Regla de Oro
-**NUNCA reintentes una acción fallida sin investigar primero.** Si algo falla, SIEMPRE ejecuta el protocolo de investigación antes de intentar de nuevo.
-
-## Protocolo de Investigación (Obligatorio tras cualquier fallo)
-
-### Paso 1: Inspección del elemento
-```
-Usa: inspect_element_details (idx del elemento que falló)
-Objetivo: Determinar POR QUÉ falló
-```
-
-Revisa en el resultado:
-- ¿El elemento es `disabled` o `readonly`?
-- ¿El elemento está cubierto por otro (`pointer-events: none`, overlay)?
-- ¿El elemento es un `<select>` que requiere interacción diferente a fill?
-- ¿El elemento está en un iframe diferente (`frameIdx`)?
-
-### Paso 2: Auditoría de consola
-```
-Usa: capture_console_errors
-Objetivo: Buscar errores JavaScript silenciosos
-```
-
-Si la UI no responde o está congelada, puede haber un error JS no visible. Revisa:
-- Errores de red (fetch failed, 404, 500)
-- Errores de JS (TypeError, undefined)
-- Warnings de frameworks (React, Angular)
-
-### Paso 3: Captura de evidencia
-```
-Usa: create_test_evidence (type: annotated_screenshot)
-Objetivo: Documentar el estado actual para debugging
-```
-
-Si identificas un bug real de la aplicación (no un error tuyo), documéntalo con evidencia anotada.
-
-### Paso 4: Decisión
-Después de investigar, toma UNA de estas decisiones:
-1. **Reintentar con variación**: Si descubriste que el campo es un select, usa click en vez de fill.
-2. **Buscar alternativa**: Si el elemento está cubierto, busca otro camino al mismo objetivo.
-3. **Reportar bug**: Si es un bug de la aplicación, usa `report_application_bug`.
-4. **Reportar incapacidad**: Si no puedes avanzar, usa `report_inability_to_proceed`.
-
-## Cuándo usar cada herramienta de investigación
-
-| Situación | Herramienta | Obligatoria |
-|-----------|------------|-------------|
-| Acción falló con Timeout | `inspect_element_details` | ✅ SÍ |
-| Elemento con nombre [INFERRED] | `inspect_element_details` | ✅ SÍ |
-| UI no responde / congelada | `capture_console_errors` | ✅ SÍ |
-| Antes de hacer GUARDAR/SAVE | `validate_element_state` | ✅ SÍ |
-| Después de GUARDAR exitoso | `extract_table_data` | Recomendada |
-| Bug encontrado | `create_test_evidence` | ✅ SÍ |
-| Fin de misión exitosa | `create_test_evidence` | Recomendada |

package/.agent/skills/modal-master.md

@@ -1,41 +0,0 @@
----
-name: modal-master
-description: Gestión experta de ventanas modales, diálogos y popups en pruebas de QA.
----
-
-# Modal Master Skill
-
-Esta habilidad permite al agente detectar, navegar y cerrar ventanas modales de manera eficiente, evitando que el flujo del test se bloquee por elementos superpuestos.
-
-## Cuándo usar esta habilidad
-- Cuando el agente realiza una acción y aparece un diálogo de confirmación (ej: "¿Desea guardar los cambios?").
-- Cuando un popup de error o notificación bloquea el acceso al resto de la página.
-- Cuando la misión requiere interactuar específicamente con elementos dentro de un modal.
-
-## Instrucciones para el Agente
-
-### 1. Detección de Modales
-Antes de intentar interactuar con un elemento del fondo, verifica si hay un modal activo buscando:
-- Elementos con `role="dialog"` o `role="alertdialog"`.
-- Atributos `aria-modal="true"`.
-- Overlays oscuros que cubren la pantalla (ej: clases tipo `backdrop`, `overlay`, `modal-open`).
-- Títulos destacados que no estaban antes de la acción.
-
-### 2. Prioridad de Interacción
-Si un modal está abierto:
-- **Prioridad 1**: Si el modal es informativo (Warning/Error), léelo y repórtalo en tu pensamiento antes de cerrarlo.
-- **Prioridad 2**: Si el modal es de confirmación para la acción que acabas de realizar, haz clic en el botón afirmativo (ej: "Aceptar", "Sí", "Confirmar").
-- **Prioridad 3**: Si el modal es intrusivo y no permite seguir, busca el botón de cierre (usualmente una 'X', un botón "Cerrar" o "Cancelar").
-
-### 3. Estrategias de Cierre
-Si no encuentras un botón de cierre claro:
-- Busca botones con clases `close`, `btn-close` o que tengan un ícono dentro.
-- Usa `send_keyboard_event` con key `Escape` para intentar cerrar el modal/popup/dropdown.
-- Verifica si el modal desaparece al hacer clic en el backdrop (el área fuera del cuadro blanco).
-
-### 4. Flujo de Trabajo (Ejemplo)
-1. **Acción**: Clic en "Eliminar".
-2. **Scan**: Detecto un modal con el texto "¿Está seguro?".
-3. **Validación**: Uso `validate_element_state` para verificar que el botón "Eliminar permanentemente" es visible dentro del modal.
-4. **Ejecución**: Clic en el botón del modal.
-5. **Verificación**: Espero a que el modal desaparezca antes de realizar la siguiente acción de la misión.

package/.agent/skills/native-control-expert.md

@@ -1,82 +0,0 @@
----
-name: native-control-expert
-description: Protocolo experto para interactuar con controles nativos del navegador (time pickers, date pickers, selects, etc.)
----
-
-# Native Control Expert Skill
-
-Esta habilidad define el protocolo que el agente DEBE seguir cuando la misión involucra interactuar con controles nativos del navegador que **NO responden bien** a la acción estándar `fill`.
-
-## Controles Nativos que REQUIEREN esta skill
-
-| Control | Ejemplo | Acción preferida |
-|---------|---------|-----------------|
-| `<input type="time">` | Campo de hora `HH:mm` | `interact_native_control` con `control_type: "time"` |
-| `<input type="date">` | Campo de fecha `YYYY-MM-DD` | `interact_native_control` con `control_type: "date"` |
-| `<input type="datetime-local">` | Fecha y hora combinados | `interact_native_control` con `control_type: "datetime"` |
-| `<input type="color">` | Selector de color | `interact_native_control` con `control_type: "color"` |
-| `<input type="range">` | Slider numérico | `interact_native_control` con `control_type: "range"` |
-| `<select>` nativo | Dropdown estándar HTML | `interact_native_control` con `control_type: "select"` |
-| Combobox/Autocomplete | Campos con `role="combobox"` | `click` + `fill` letra + `send_keyboard_event` ArrowDown + Enter |
-| Time picker con diálogo | Campos que abren un popup al hacer click | `send_keyboard_event` con Arrow keys |
-
-## Protocolo de Interacción con Time Pickers
-
-### ❌ LO QUE NUNCA DEBES HACER:
-- Intentar `fill` repetidamente si falla la primera vez
-- Hacer click una y otra vez sin cambiar de estrategia (esto causa loop detection)
-- Asumir que un time picker funciona como un input de texto normal
-
-### ✅ LO QUE SÍ DEBES HACER:
-
-**Estrategia 1: interact_native_control (PREFERIDA)**
-```
-1. Usa inspect_element_details para confirmar que es type="time"
-2. Usa interact_native_control con control_type: "time", value: "13:05"
-3. Verifica el resultado
-```
-
-**Estrategia 2: Keyboard Navigation (FALLBACK)**
-```
-1. Haz click en el campo de hora
-2. Usa send_keyboard_event con key: "Control+a" para seleccionar todo
-3. Usa send_keyboard_event para escribir los dígitos del tiempo
-4. Ejemplo: Para "13:05", envía las teclas: "1", "3", "0", "5"
-5. Usa send_keyboard_event con key: "Tab" para navegar al siguiente campo
-```
-
-**Estrategia 3: Arrow Keys (ULTIMO RECURSO)**
-```
-1. Haz click en el segmento de horas del campo
-2. Usa send_keyboard_event con key: "ArrowUp" o "ArrowDown" para ajustar la hora
-3. Usa send_keyboard_event con key: "Tab" para mover al segmento de minutos
-4. Repite con ArrowUp/ArrowDown para los minutos
-```
-
-## Protocolo de Interacción con Date Pickers
-
-### ✅ Estrategia preferida:
-```
-1. Confirma con inspect_element_details que es type="date"
-2. Usa interact_native_control con control_type: "date", value: "2026-03-25"
-3. IMPORTANTE: El formato SIEMPRE es YYYY-MM-DD
-```
-
-## Detección: ¿Cuándo usar esta skill?
-
-Debes activar esta skill cuando:
-1. Ves un componente FIELD con nombre que incluye "HH:mm" o "hora" o "time"
-2. Un campo tiene `role="combobox"` y `aria-expanded`
-3. Un `fill()` falla en un campo de fecha/hora con Timeout o sin efecto
-4. El inspector muestra `type="time"` o `type="date"` en los atributos
-
-## Keyboard Shortcuts Útiles
-
-| Tecla | Efecto en controles nativos |
-|-------|-----------------------------|
-| `Tab` | Mover al siguiente segmento (horas → minutos → AM/PM) |
-| `ArrowUp` | Incrementar valor del segmento actual |
-| `ArrowDown` | Decrementar valor del segmento actual |
-| `Escape` | Cerrar dropdown/calendar que se abrió |
-| `Enter` | Confirmar selección en calendarios |
-| `Control+a` | Seleccionar todo el contenido del campo |