siesa-agents 2.1.72-qa.8 → 2.1.72-qa.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "siesa-agents",
3
- "version": "2.1.72-qa.8",
3
+ "version": "2.1.72-qa.9",
4
4
  "description": "Paquete para instalar y configurar agentes SIESA en tu proyecto",
5
5
  "main": "index.js",
6
6
  "bin": {
@@ -993,6 +993,35 @@ consecuencia de negocio y estrategia de mitigación recomendada.
993
993
 
994
994
  ---
995
995
 
996
+ ### VII. EXPORTACIÓN ESTRUCTURADA (YAML)
997
+
998
+ Además de la Matriz Integral en Markdown (Sección V), genera un archivo
999
+ `test-design-{modulo}.yml` con la siguiente estructura:
1000
+
1001
+ **Estructura del YAML:**
1002
+
1003
+ 1. `metadata` — workflow, phase, methodology, project, mode, features_in_scope, batch_info
1004
+ 2. `gatekeeper` — clasificación de historias (Lógica de Negocio vs Ruido Técnico)
1005
+ 3. `features` — FAC Gherkin + blind_spots por feature
1006
+ 4. `dependencies` — relaciones entre features
1007
+ 5. `test_matrix` — todos los casos de la Matriz Integral con `steps` como ARRAY:
1008
+ - Campos 1–9 y 11–13: igual que la tabla Markdown
1009
+ - Campo 10 (`steps`): expandir a array de objetos con `paso`, `accion`, `resultado`, `datos`
1010
+ - Regla: 1 paso = 1 acción atómica. NO agrupar múltiples acciones en un paso.
1011
+ 6. `tsr` — métricas, distribución por nivel, pending_batches
1012
+ 7. `traceability` — mapeo FAC → casos
1013
+
1014
+ **Regla de consistencia:** El YAML debe contener exactamente los mismos casos
1015
+ que la Matriz Markdown. Si la matriz tiene N filas, el YAML tiene N entries
1016
+ en `test_matrix`. Cero desviaciones.
1017
+
1018
+ **Consumidores del YAML:**
1019
+ - AgileTest (`create_agiletest_issues.py`) — crea Test Cases + Test Steps en Jira
1020
+ - Agente Ejecutor E2E — genera `.spec.ts` Playwright desde los pasos
1021
+ - Motor de Datos — lee `datos` por paso para generar seeds en BD
1022
+
1023
+ ---
1024
+
996
1025
  ## 📋 Lista de Verificación del Arquitecto (Auto-revisión antes de entregar)
997
1026
 
998
1027
  Antes de entregar el diseño de pruebas, verifica cada punto:
@@ -706,7 +706,15 @@ test_matrix: # Sección V — Matriz Integral 360° (13 col
706
706
  technique: <Técnica>
707
707
  scenario: <Escenario>
708
708
  preconditions: <Precondiciones>
709
- steps: <Pasos>
709
+ steps: # ARRAY de pasos — 1 paso = 1 acción atómica (NO agrupar)
710
+ - paso: 1
711
+ accion: <acción concreta del paso>
712
+ resultado: <resultado verificable de ese paso>
713
+ datos: <datos usados en ese paso — insumo del Motor de Datos>
714
+ - paso: 2
715
+ accion: <...>
716
+ resultado: <...>
717
+ datos: <...>
710
718
  expected_result: <Resultado Esperado>
711
719
  risk: <Riesgo IxP> # ej. "4x3=12"
712
720
  priority: <Prioridad> # P0 | P1 | P2 | P3
@@ -729,10 +737,15 @@ traceability: # Apéndice — Matriz de Trazabilidad
729
737
  - ✅ Usar **Write tool ONLY** (encoding UTF-8). NUNCA bash, cat, echo, sed, awk.
730
738
  - ✅ Construir el string YAML completo en memoria y llamar Write una sola vez.
731
739
  - ✅ Los valores con `:`, `#`, comillas o saltos de línea deben ir entre comillas dobles o como
732
- bloque literal (`|`). Los pasos multilínea usan bloque literal.
740
+ bloque literal (`|`).
741
+ - ✅ **`steps` es un ARRAY de objetos** (`paso`, `accion`, `resultado`, `datos`), NO un string.
742
+ Regla: **1 paso = 1 acción atómica** — prohibido agrupar múltiples acciones en un solo paso.
743
+ El campo `datos` por paso es el insumo que el Motor de Datos (Fase 6) lee para generar seeds,
744
+ y el Agente Ejecutor E2E usa los pasos para generar el `.spec.ts` de Playwright.
733
745
  - ✅ Las claves `mode`, `interface_type`, `dependencies` deben ser congruentes con la Fase 0:
734
746
  en Modo Feature → `dependencies: []`; en Modo Completo → `interface_type: null`.
735
747
  - ✅ El `test_matrix` debe tener **una entrada por cada fila** de la matriz (mismo conteo que el CSV).
748
+ El array `steps` de cada caso debe reflejar exactamente los pasos de la columna `Pasos` del Markdown.
736
749
 
737
750
  Guardar como: `{implementation_artifacts}/quality-process/diseno/test-design-YYYY-MM-DD-HHmmss/test-design.yml` (en la raíz, junto a `test-cases.csv`, NO en shards/)
738
751