robotframework-evidence-reporter 0.1.0__tar.gz

robotframework_evidence_reporter-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Angel Gerardo Molina Valdez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

robotframework_evidence_reporter-0.1.0/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: robotframework-evidence-reporter
+Version: 0.1.0
+Summary: Standalone business evidence reports per Robot Framework test
+License-Expression: MIT
+License-File: LICENSE
+Keywords: robotframework,selenium,evidence,reporting,pabot
+Author: Angel Gerardo Molina Valdez
+Requires-Python: >=3.12,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Requires-Dist: jinja2 (>=3.1.6,<4.0)
+Requires-Dist: pillow (>=11.0,<14.0)
+Requires-Dist: robotframework (>=7.0,<8.0)
+Project-URL: Homepage, https://angel-valdezzz.github.io/robotframework-evidence-reporter/
+Project-URL: Repository, https://github.com/angel-valdezzz/robotframework-evidence-reporter
+Description-Content-Type: text/markdown
+
+# Robot Framework Evidence Reporter
+
+Un HTML autocontenido por caso de Robot Framework, orientado a evidencias de negocio. Registra capturas explícitas, mensajes y metadatos durante la ejecución; genera el HTML después, desde CLI o Python.
+
+[Documentación](https://angel-valdezzz.github.io/robotframework-evidence-reporter/) · [Documentación de keywords](https://angel-valdezzz.github.io/robotframework-evidence-reporter/reference/keywords.html) · [Ver reporte HTML](https://angel-valdezzz.github.io/robotframework-evidence-reporter/demo/passed.html)
+
+## Estado de publicación
+
+El código, la documentación y la demo HTML están publicados. La publicación en PyPI se ejecuta mediante GitHub Actions y requiere el Trusted Publisher configurado en la cuenta del propietario. Por ahora se puede instalar desde una revisión Git fija o construir el wheel desde el repositorio.
+
+## Instalación
+
+```bash
+# Disponible después de la primera publicación en PyPI
+pip install robotframework-evidence-reporter
+poetry add robotframework-evidence-reporter
+
+# Instalación desde el código publicado mientras tanto
+pip install "git+https://github.com/angel-valdezzz/robotframework-evidence-reporter.git@main"
+```
+
+Python 3.12 o superior y Robot Framework 7. Para capturar páginas o elementos instala también SeleniumLibrary. La librería reutiliza su navegador activo: no abre otra sesión ni depende de un navegador concreto.
+
+## Uso en Robot
+
+```robotframework
+*** Settings ***
+Library    SeleniumLibrary
+Library    EvidenceReporter
+
+*** Test Cases ***
+Registrar Cliente
+    Open Browser    https://example.test    chrome
+    Set Report Metadata    Aplicación=Portal    Ambiente=QA    Ticket=QA-123
+    Capture Page Evidence    Formulario de alta
+    ${milestone}=    Create Milestone    Cliente registrado
+    Capture Element Evidence    css:.confirmation    Confirmación    milestone_id=${milestone}
+    Add Evidence Message    El alta fue confirmada.    milestone_id=${milestone}
+    [Teardown]    Close All Browsers
+```
+
+Los hitos son opcionales. Sin `milestone_id`, la evidencia se añade directamente al caso. No se registran automáticamente argumentos ni todos los logs técnicos; añade los mensajes de negocio que necesites.
+
+```bash
+robot --outputdir results tests
+rf-evidence build results/evidence --output reports
+```
+
+Cada caso conserva su estado final de Robot (`PASS`, `FAIL`, `SKIP`), inicio, fin y duración, incluidos fallos del teardown. Un proceso interrumpido antes de guardar el resultado final conserva `INCOMPLETE`. Las fechas incluyen el offset horario del proceso que las registra.
+
+## Capturas y errores
+
+| Keyword | Captura |
+| --- | --- |
+| `Capture Page Evidence` | Página visible del navegador activo |
+| `Capture Element Evidence` | Elemento usando un locator SeleniumLibrary |
+| `Capture Desktop Evidence` | Escritorio de la máquina donde corre Robot |
+| `Attach Image Evidence` | Copia una imagen PNG, JPEG o WEBP existente |
+
+Las capturas fallidas producen **WARN por defecto**, se registran en el HTML y no cambian el estado del caso. Usa `strict=${True}` por keyword o `strict=${True}` al importar la librería para exigir una captura. `strict=${False}` por keyword permite sobrescribir esa configuración global.
+
+El usuario elige cuándo usar el escritorio. No hay detección automática de headless, remoto ni paralelismo. Pillow ImageGrab necesita un entorno gráfico compatible; en Linux puede requerir un backend de captura, y en macOS permisos de pantalla. La captura corresponde al escritorio del proceso, no necesariamente al navegador remoto. No se implementa página completa en esta versión.
+
+Errores definidos: `BROWSER_UNAVAILABLE`, `ELEMENT_NOT_FOUND`, `SCREENSHOT_FAILED`, `DESKTOP_UNAVAILABLE`, `IMAGE_UNAVAILABLE`, `INVALID_IMAGE`, `STORAGE_ERROR`. Argumentos incorrectos, hitos ajenos al caso y errores internos no se silencian. Si falla el almacenamiento inicial o final del listener, Robot registra el error del listener; comprueba también que se hayan generado los JSON esperados.
+
+## Python y paralelo
+
+```python
+from rf_evidence_reporter import build_reports
+
+paths = build_reports("results/evidence", "reports")
+```
+
+Cada caso usa un UUID y un directorio propio. Para Pabot proporciona un directorio compartido de esta ejecución, por ejemplo `output_dir=${EXECDIR}/results/evidence`. Genera los HTML después de que terminen todos los procesos. Usa un directorio nuevo por ejecución: el generador incluye todos los `case.json` encontrados y conserva cada intento separado.
+
+## Desarrollo
+
+```bash
+poetry install
+poetry run ruff check src tests scripts
+poetry run ruff format --check src tests scripts
+poetry run robocop check tests examples
+poetry run python -m unittest discover -s tests -v
+poetry run python scripts/validate.py
+poetry run python scripts/demo.py
+poetry run python -m robot.libdoc --name "Evidence Reporter" EvidenceReporter docs/reference/keywords.html
+poetry run mkdocs build --strict
+poetry build
+```
+
+`scripts/validate.py` verifica Robot y Pabot, incluyendo un caso con fallo deliberado en teardown. Las pruebas del núcleo usan unittest de Python; las pruebas de integración usan Robot. La demo pública utiliza datos e imágenes ficticios, indicados en el propio reporte.
+
+El HTML incluye imágenes, CSS y JavaScript sin recursos externos. Su visualizador funciona sin conexión y es navegable con teclado. Jira puede permitir adjuntarlo sin ofrecer vista previa; se puede descargar y abrir en un navegador. El contenido y las imágenes no se censuran automáticamente: registra solo datos apropiados para el destino del reporte.
+
+## Publicación
+
+GitHub Actions valida los cambios. `main` publica MkDocs y la demo en GitHub Pages. Un cambio de `pyproject.toml` en `main`, o una release `vX.Y.Z` cuya versión coincida con el paquete, publica wheel y sdist en PyPI mediante Trusted Publishing. Consulta `docs/publishing.md` para el registro inicial del publisher.
+
+Licencia MIT.
+
+## Estatus de evidencia y presentación
+
+Las cuatro keywords de captura aceptan `status=INFO` (por defecto), `PASS`, `WARN` o `FAIL`. No aceptan `SKIP`; un valor inválido produce `INVALID_CAPTURE_STATUS`. El estatus describe la evidencia y no modifica el resultado de Robot. Si la captura falla, se registra una advertencia independientemente del estatus solicitado.
+
+Consulta los [ejemplos completos con estatus de evidencia](https://angel-valdezzz.github.io/robotframework-evidence-reporter/guide/#estatus-de-evidencia-y-presentacion).
+
+El HTML tiene pestañas **Resumen**, **Pasos** y **Logs**. Resumen muestra una sola insignia de estatus de ejecución (`SKIP` en amarillo). Pasos presenta capturas e hitos; sus logs son plegables. Logs agrupa mensajes y advertencias en bloques plegables, con bordes por nivel y fondo neutro. El switch permite elegir modo claro u oscuro; conserva la preferencia cuando el navegador permite almacenamiento local.
+
+Las fechas visibles incluyen día/mes/año y hora con segundos. La zona horaria se indica al pie y el JSON conserva el timestamp completo. Los registros anteriores sin estatus de captura se presentan como `INFO`. No hay botón de impresión; PDF y Word quedan para una etapa posterior.
+
+## Navegación del reporte
+
+En Pasos, las evidencias directas empiezan plegadas y tienen pestañas Evidencias/Logs del bloque. Los hitos empiezan abiertos; puedes contraerlos individualmente o usar Expandir/Contraer todos los hitos. Los controles globales no modifican el bloque directo.
+
+La documentación comparte logo, colores y temas con el reporte. Consulta [Primera evidencia](https://angel-valdezzz.github.io/robotframework-evidence-reporter/getting-started/) para ejemplos de instalación y ejecución.
+

robotframework_evidence_reporter-0.1.0/README.md

@@ -0,0 +1,115 @@
+# Robot Framework Evidence Reporter
+
+Un HTML autocontenido por caso de Robot Framework, orientado a evidencias de negocio. Registra capturas explícitas, mensajes y metadatos durante la ejecución; genera el HTML después, desde CLI o Python.
+
+[Documentación](https://angel-valdezzz.github.io/robotframework-evidence-reporter/) · [Documentación de keywords](https://angel-valdezzz.github.io/robotframework-evidence-reporter/reference/keywords.html) · [Ver reporte HTML](https://angel-valdezzz.github.io/robotframework-evidence-reporter/demo/passed.html)
+
+## Estado de publicación
+
+El código, la documentación y la demo HTML están publicados. La publicación en PyPI se ejecuta mediante GitHub Actions y requiere el Trusted Publisher configurado en la cuenta del propietario. Por ahora se puede instalar desde una revisión Git fija o construir el wheel desde el repositorio.
+
+## Instalación
+
+```bash
+# Disponible después de la primera publicación en PyPI
+pip install robotframework-evidence-reporter
+poetry add robotframework-evidence-reporter
+
+# Instalación desde el código publicado mientras tanto
+pip install "git+https://github.com/angel-valdezzz/robotframework-evidence-reporter.git@main"
+```
+
+Python 3.12 o superior y Robot Framework 7. Para capturar páginas o elementos instala también SeleniumLibrary. La librería reutiliza su navegador activo: no abre otra sesión ni depende de un navegador concreto.
+
+## Uso en Robot
+
+```robotframework
+*** Settings ***
+Library    SeleniumLibrary
+Library    EvidenceReporter
+
+*** Test Cases ***
+Registrar Cliente
+    Open Browser    https://example.test    chrome
+    Set Report Metadata    Aplicación=Portal    Ambiente=QA    Ticket=QA-123
+    Capture Page Evidence    Formulario de alta
+    ${milestone}=    Create Milestone    Cliente registrado
+    Capture Element Evidence    css:.confirmation    Confirmación    milestone_id=${milestone}
+    Add Evidence Message    El alta fue confirmada.    milestone_id=${milestone}
+    [Teardown]    Close All Browsers
+```
+
+Los hitos son opcionales. Sin `milestone_id`, la evidencia se añade directamente al caso. No se registran automáticamente argumentos ni todos los logs técnicos; añade los mensajes de negocio que necesites.
+
+```bash
+robot --outputdir results tests
+rf-evidence build results/evidence --output reports
+```
+
+Cada caso conserva su estado final de Robot (`PASS`, `FAIL`, `SKIP`), inicio, fin y duración, incluidos fallos del teardown. Un proceso interrumpido antes de guardar el resultado final conserva `INCOMPLETE`. Las fechas incluyen el offset horario del proceso que las registra.
+
+## Capturas y errores
+
+| Keyword | Captura |
+| --- | --- |
+| `Capture Page Evidence` | Página visible del navegador activo |
+| `Capture Element Evidence` | Elemento usando un locator SeleniumLibrary |
+| `Capture Desktop Evidence` | Escritorio de la máquina donde corre Robot |
+| `Attach Image Evidence` | Copia una imagen PNG, JPEG o WEBP existente |
+
+Las capturas fallidas producen **WARN por defecto**, se registran en el HTML y no cambian el estado del caso. Usa `strict=${True}` por keyword o `strict=${True}` al importar la librería para exigir una captura. `strict=${False}` por keyword permite sobrescribir esa configuración global.
+
+El usuario elige cuándo usar el escritorio. No hay detección automática de headless, remoto ni paralelismo. Pillow ImageGrab necesita un entorno gráfico compatible; en Linux puede requerir un backend de captura, y en macOS permisos de pantalla. La captura corresponde al escritorio del proceso, no necesariamente al navegador remoto. No se implementa página completa en esta versión.
+
+Errores definidos: `BROWSER_UNAVAILABLE`, `ELEMENT_NOT_FOUND`, `SCREENSHOT_FAILED`, `DESKTOP_UNAVAILABLE`, `IMAGE_UNAVAILABLE`, `INVALID_IMAGE`, `STORAGE_ERROR`. Argumentos incorrectos, hitos ajenos al caso y errores internos no se silencian. Si falla el almacenamiento inicial o final del listener, Robot registra el error del listener; comprueba también que se hayan generado los JSON esperados.
+
+## Python y paralelo
+
+```python
+from rf_evidence_reporter import build_reports
+
+paths = build_reports("results/evidence", "reports")
+```
+
+Cada caso usa un UUID y un directorio propio. Para Pabot proporciona un directorio compartido de esta ejecución, por ejemplo `output_dir=${EXECDIR}/results/evidence`. Genera los HTML después de que terminen todos los procesos. Usa un directorio nuevo por ejecución: el generador incluye todos los `case.json` encontrados y conserva cada intento separado.
+
+## Desarrollo
+
+```bash
+poetry install
+poetry run ruff check src tests scripts
+poetry run ruff format --check src tests scripts
+poetry run robocop check tests examples
+poetry run python -m unittest discover -s tests -v
+poetry run python scripts/validate.py
+poetry run python scripts/demo.py
+poetry run python -m robot.libdoc --name "Evidence Reporter" EvidenceReporter docs/reference/keywords.html
+poetry run mkdocs build --strict
+poetry build
+```
+
+`scripts/validate.py` verifica Robot y Pabot, incluyendo un caso con fallo deliberado en teardown. Las pruebas del núcleo usan unittest de Python; las pruebas de integración usan Robot. La demo pública utiliza datos e imágenes ficticios, indicados en el propio reporte.
+
+El HTML incluye imágenes, CSS y JavaScript sin recursos externos. Su visualizador funciona sin conexión y es navegable con teclado. Jira puede permitir adjuntarlo sin ofrecer vista previa; se puede descargar y abrir en un navegador. El contenido y las imágenes no se censuran automáticamente: registra solo datos apropiados para el destino del reporte.
+
+## Publicación
+
+GitHub Actions valida los cambios. `main` publica MkDocs y la demo en GitHub Pages. Un cambio de `pyproject.toml` en `main`, o una release `vX.Y.Z` cuya versión coincida con el paquete, publica wheel y sdist en PyPI mediante Trusted Publishing. Consulta `docs/publishing.md` para el registro inicial del publisher.
+
+Licencia MIT.
+
+## Estatus de evidencia y presentación
+
+Las cuatro keywords de captura aceptan `status=INFO` (por defecto), `PASS`, `WARN` o `FAIL`. No aceptan `SKIP`; un valor inválido produce `INVALID_CAPTURE_STATUS`. El estatus describe la evidencia y no modifica el resultado de Robot. Si la captura falla, se registra una advertencia independientemente del estatus solicitado.
+
+Consulta los [ejemplos completos con estatus de evidencia](https://angel-valdezzz.github.io/robotframework-evidence-reporter/guide/#estatus-de-evidencia-y-presentacion).
+
+El HTML tiene pestañas **Resumen**, **Pasos** y **Logs**. Resumen muestra una sola insignia de estatus de ejecución (`SKIP` en amarillo). Pasos presenta capturas e hitos; sus logs son plegables. Logs agrupa mensajes y advertencias en bloques plegables, con bordes por nivel y fondo neutro. El switch permite elegir modo claro u oscuro; conserva la preferencia cuando el navegador permite almacenamiento local.
+
+Las fechas visibles incluyen día/mes/año y hora con segundos. La zona horaria se indica al pie y el JSON conserva el timestamp completo. Los registros anteriores sin estatus de captura se presentan como `INFO`. No hay botón de impresión; PDF y Word quedan para una etapa posterior.
+
+## Navegación del reporte
+
+En Pasos, las evidencias directas empiezan plegadas y tienen pestañas Evidencias/Logs del bloque. Los hitos empiezan abiertos; puedes contraerlos individualmente o usar Expandir/Contraer todos los hitos. Los controles globales no modifican el bloque directo.
+
+La documentación comparte logo, colores y temas con el reporte. Consulta [Primera evidencia](https://angel-valdezzz.github.io/robotframework-evidence-reporter/getting-started/) para ejemplos de instalación y ejecución.

robotframework_evidence_reporter-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[project]
+name = "robotframework-evidence-reporter"
+version = "0.1.0"
+description = "Standalone business evidence reports per Robot Framework test"
+authors = [{name = "Angel Gerardo Molina Valdez"}]
+readme = "README.md"
+requires-python = ">=3.12,<4.0"
+license = "MIT"
+keywords = ["robotframework", "selenium", "evidence", "reporting", "pabot"]
+dependencies = ["robotframework>=7.0,<8.0", "jinja2>=3.1.6,<4.0", "pillow>=11.0,<14.0"]
+
+[project.urls]
+Homepage = "https://angel-valdezzz.github.io/robotframework-evidence-reporter/"
+Repository = "https://github.com/angel-valdezzz/robotframework-evidence-reporter"
+
+[project.scripts]
+rf-evidence = "rf_evidence_reporter.cli:main"
+
+[tool.poetry]
+packages = [
+    {include = "rf_evidence_reporter", from = "src"},
+    {include = "EvidenceReporter", from = "src"},
+]
+include = ["src/rf_evidence_reporter/templates/*.html"]
+
+[tool.poetry.group.dev.dependencies]
+robotframework-seleniumlibrary = "^6.9.0"
+robotframework-pabot = "^5.1.0"
+robotframework-robocop = "^9.1.0"
+ruff = "^0.15.0"
+mkdocs-material = "^9.7.0"
+
+[tool.ruff]
+line-length = 110
+
+[tool.robocop.lint]
+ignore = ["too-few-calls-in-test-case"]
+
+[build-system]
+requires = ["poetry-core>=2.0,<3.0"]
+build-backend = "poetry.core.masonry.api"

robotframework_evidence_reporter-0.1.0/src/EvidenceReporter/__init__.py

@@ -0,0 +1,6 @@
+"""Public Robot Framework import: ``Library    EvidenceReporter``."""
+
+from rf_evidence_reporter import __version__
+from rf_evidence_reporter.library import EvidenceReporter
+
+__all__ = ["EvidenceReporter", "__version__"]

robotframework_evidence_reporter-0.1.0/src/rf_evidence_reporter/__init__.py

@@ -0,0 +1,8 @@
+"""Robot Framework Evidence Reporter public API."""
+
+from .builder import build_reports
+from .library import EvidenceReporter
+from .recorder import EvidenceRecorder
+
+__version__ = "0.1.0"
+__all__ = ["EvidenceReporter", "EvidenceRecorder", "build_reports"]

robotframework_evidence_reporter-0.1.0/src/rf_evidence_reporter/builder.py

@@ -0,0 +1,103 @@
+"""Generate portable HTML from recorded JSON without a browser or Robot execution."""
+
+import base64
+import json
+import warnings
+from pathlib import Path
+from datetime import datetime
+
+from jinja2 import Environment, PackageLoader, select_autoescape
+
+from .recorder import slug, timestamp
+
+
+def display_date(value):
+    if not value:
+        return "No registrado"
+    return datetime.fromisoformat(value).strftime("%d/%m/%Y · %H:%M:%S")
+
+
+def timezone_label(value):
+    offset = datetime.fromisoformat(value).strftime("%z")
+    return "UTC" + offset[:3] + ":" + offset[3:] if offset else "Sin zona horaria"
+
+
+def build_reports(results_dir, output_dir):
+    """Return generated HTML Paths. One HTML per recorded case, never a global dashboard.
+
+    Invalid case files fail generation clearly. Missing/invalid images become visible warnings.
+    Input image references must remain inside their case directory.
+    """
+    root = Path(results_dir).resolve()
+    files = sorted(root.rglob("case.json"))
+    if not files:
+        raise ValueError(f"NO_CASES: no hay archivos case.json en {root}")
+    destination = Path(output_dir).resolve()
+    destination.mkdir(parents=True, exist_ok=True)
+    environment = Environment(
+        loader=PackageLoader("rf_evidence_reporter", "templates"), autoescape=select_autoescape(["html"])
+    )
+    environment.filters["display_date"] = display_date
+    environment.filters["timezone_label"] = timezone_label
+    template = environment.get_template("report.html")
+    generated = []
+    for source in files:
+        case = json.loads(source.read_text(encoding="utf-8"))
+        if case.get("schema_version") != 1:
+            raise ValueError(f"UNSUPPORTED_SCHEMA: {source}")
+        # Validate the minimum identity needed for a reliable report filename.
+        if not isinstance(case.get("id"), str) or not case["id"] or not isinstance(case.get("name"), str):
+            raise ValueError(f"INVALID_CASE: {source}")
+        if case.get("status") not in {"PASS", "FAIL", "SKIP", "INCOMPLETE"}:
+            raise ValueError(f"INVALID_STATUS: {source}")
+        for event in case["events"]:
+            event.setdefault("status", "WARN" if event["kind"] == "capture_warning" else "INFO")
+            if event["status"] not in {"INFO", "PASS", "WARN", "FAIL"}:
+                raise ValueError(f"INVALID_CAPTURE_STATUS: {source}")
+            if event.get("image"):
+                path = (source.parent / event["image"]).resolve()
+                try:
+                    if not path.is_relative_to(source.parent.resolve()):
+                        raise ValueError("referencia fuera del directorio del caso")
+                    from PIL import Image
+
+                    with Image.open(path) as image:
+                        image.verify()
+                        mime = {"PNG": "image/png", "JPEG": "image/jpeg", "WEBP": "image/webp"}[image.format]
+                    event["image_data"] = f"data:{mime};base64,{base64.b64encode(path.read_bytes()).decode()}"
+                except (OSError, ValueError, KeyError) as error:
+                    event.update(
+                        kind="capture_warning",
+                        level="WARN",
+                        status="WARN",
+                        reason=f"IMAGE_UNAVAILABLE: {error}",
+                    )
+                    warnings.warn(f"{source}: {event['reason']}", stacklevel=2)
+        case["warning_count"] = sum(
+            event.get("level") == "WARN" or event.get("status") == "WARN" for event in case["events"]
+        )
+        blocks = []
+        # Blocks follow first evidence appearance; evidence within each block retains its order.
+        direct = [event for event in case["events"] if not event.get("milestone_id")]
+        if direct:
+            blocks.append({"title": "Evidencias del caso", "description": "", "events": direct})
+        for milestone in case["milestones"]:
+            blocks.append(
+                {
+                    **milestone,
+                    "events": [
+                        event for event in case["events"] if event.get("milestone_id") == milestone["id"]
+                    ],
+                }
+            )
+        for block in blocks:
+            block["warning_count"] = sum(
+                event.get("level") == "WARN" or event.get("status") == "WARN" for event in block["events"]
+            )
+        name = f"{slug(case['name'])}-{slug(case['id'])}.html"
+        target = destination / name
+        target.write_text(
+            template.render(case=case, blocks=blocks, generated_at=timestamp()), encoding="utf-8"
+        )
+        generated.append(target)
+    return generated

robotframework_evidence_reporter-0.1.0/src/rf_evidence_reporter/cli.py

@@ -0,0 +1,24 @@
+"""CLI shares the public Python generator."""
+
+import argparse
+import sys
+
+from .builder import build_reports
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="rf-evidence", description="HTML individual de evidencias de negocio"
+    )
+    commands = parser.add_subparsers(dest="command", required=True)
+    build = commands.add_parser("build", help="Generar un HTML autocontenido por caso")
+    build.add_argument("results_dir")
+    build.add_argument("--output", "-o", default="evidence-reports")
+    args = parser.parse_args()
+    try:
+        for path in build_reports(args.results_dir, args.output):
+            print(path)
+    except (OSError, ValueError, KeyError, TypeError) as error:
+        print(f"No se pudo generar el reporte: {error}", file=sys.stderr)
+        return 1
+    return 0

robotframework_evidence_reporter-0.1.0/src/rf_evidence_reporter/library.py

@@ -0,0 +1,353 @@
+"""Robot adapter: explicit evidence keywords and automatic final test metadata."""
+
+import io
+from pathlib import Path
+from uuid import uuid4
+
+from PIL import Image, ImageGrab
+from robot.api import logger
+from robot.api.deco import keyword, library
+from robot.libraries.BuiltIn import BuiltIn
+
+from .recorder import EvidenceRecorder
+
+
+class CaptureError(RuntimeError):
+    def __init__(self, code, reason):
+        self.code = code
+        super().__init__(f"{code}: {reason}")
+
+
+@library(scope="GLOBAL", auto_keywords=False)
+class EvidenceReporter:
+    """Registra evidencias de negocio independientes por caso de Robot Framework.
+
+    Las capturas y los mensajes se guardan junto con los datos de ejecución en
+    JSON. El HTML se genera después con ``rf-evidence build``; no se genera
+    durante las keywords. Los hitos son opcionales: las evidencias sin
+    ``milestone_id`` pertenecen directamente al caso.
+
+    = Importación =
+    | Library | EvidenceReporter | output_dir=${OUTPUTDIR}/evidence | strict=${False} |
+
+    = Argumentos comunes de captura =
+    - ``title``: título de negocio visible en el reporte.
+    - ``description``: descripción opcional de la evidencia.
+    - ``milestone_id``: ID devuelto por `Create Milestone` dentro del mismo caso.
+      Si se omite, la evidencia se registra directamente en el caso.
+    - ``strict``: si se omite, hereda la configuración de importación.
+      Con ``${False}``, un fallo de captura registra WARN y devuelve ``None``.
+      Con ``${True}``, conserva la advertencia y falla con ``CAPTURE_FAILED``.
+    - ``status``: INFO (predeterminado), PASS, WARN o FAIL. Describe la evidencia;
+      no modifica el resultado de ejecución. SKIP solo pertenece a la ejecución.
+
+    = Errores =
+    | Código | Motivo |
+    | BROWSER_UNAVAILABLE | SeleniumLibrary no importada o navegador no activo. |
+    | ELEMENT_NOT_FOUND | El locator no pudo resolverse. |
+    | SCREENSHOT_FAILED | El navegador o elemento no pudo producir la imagen. |
+    | DESKTOP_UNAVAILABLE | El backend no pudo capturar el escritorio. |
+    | IMAGE_UNAVAILABLE | La imagen solicitada no pudo leerse. |
+    | INVALID_IMAGE | Archivo inválido o formato distinto de PNG, JPEG y WEBP. |
+    | STORAGE_ERROR | No se pudo guardar el archivo. |
+
+    Los errores anteriores producen advertencias por defecto. En modo estricto,
+    ``CAPTURE_FAILED`` incluye el código y motivo originales. ``NO_ACTIVE_CASE``,
+    ``UNKNOWN_MILESTONE``, ``INVALID_LEVEL`` e ``INVALID_CAPTURE_STATUS`` son
+    errores de uso y siempre se propagan. Los errores inesperados también se
+    propagan; no se convierten silenciosamente en advertencias.
+
+    = Ejemplo =
+    | ${hito}= | Create Milestone | Cliente registrado | Alta confirmada. |
+    | Capture Page Evidence | Confirmación de registro | milestone_id=${hito} | status=PASS |
+    | Add Evidence Message | Se confirmó el alta del cliente. | milestone_id=${hito} |
+
+    Cada caso tiene su propio directorio e identificadores, también en Pabot.
+    Las capturas se solicitan explícitamente; la librería no decide cuándo
+    capturar ni oculta información sensible de las imágenes.
+    """
+
+    ROBOT_LISTENER_API_VERSION = 3
+
+    def __init__(self, output_dir=None, strict: bool = False):
+        """Configura el directorio de evidencias y la política de errores de captura.
+
+        ``output_dir`` admite una ruta absoluta o relativa al directorio de
+        ejecución. Si se omite, utiliza ``${OUTPUTDIR}/evidence`` de Robot.
+        ``strict`` es falso por defecto; puede sobrescribirse en cada captura.
+        La importación no abre un navegador ni genera reportes HTML.
+        """
+        self.ROBOT_LIBRARY_LISTENER = self
+        self.output_dir = output_dir
+        self.strict = strict
+        self.recorder = None
+
+    def start_test(self, data, result):
+        root = self.output_dir or Path(BuiltIn().get_variable_value("${OUTPUTDIR}")) / "evidence"
+        self.recorder = EvidenceRecorder(root)
+        self.recorder.start(result.name, result.parent.full_name, str(data.doc), result.tags)
+
+    def end_test(self, data, result):
+        if self.recorder and self.recorder.case:
+            self.recorder.finish(result.status, result.elapsed_time.total_seconds(), result.message)
+
+    def _active(self, milestone_id=None):
+        if self.recorder is None:
+            raise RuntimeError("NO_ACTIVE_CASE: no existe un caso de prueba activo.")
+        self.recorder.validate_milestone(milestone_id)
+        return self.recorder
+
+    @keyword
+    def create_milestone(self, title: str, description: str = ""):
+        """Crea un hito de negocio dentro del caso activo y devuelve su ID.
+
+        ``title`` identifica el hito; ``description`` añade contexto opcional.
+        Pasa el ID a las capturas o mensajes mediante ``milestone_id``. No hay
+        un hito implícitamente activo: omitir el ID registra evidencia directa.
+
+        | ${hito}= | Create Milestone | Cuentas consultadas | Saldos disponibles. |
+        | Capture Page Evidence | Lista de cuentas | milestone_id=${hito} |
+        """
+        return self._active().milestone(title, description)
+
+    @keyword
+    def set_report_metadata(self, **metadata):
+        """Añade campos personalizados a la tabla de información del caso.
+
+        Recibe argumentos nombrados ``etiqueta=valor`` y los guarda como texto.
+        Si se repite una etiqueta personalizada, conserva el último valor.
+        Los campos automáticos de ejecución se mantienen separados. No devuelve
+        un valor; falla con ``NO_ACTIVE_CASE`` fuera de un caso activo.
+
+        | Set Report Metadata | Aplicación=ParaBank | Requerimiento=QA-123 |
+        """
+        self._active().metadata(metadata)
+
+    @keyword
+    def add_evidence_message(self, message: str, level: str = "INFO", milestone_id=None):
+        """Registra un mensaje de negocio y devuelve el ID del evento.
+
+        ``message`` es el texto del mensaje. ``level`` admite INFO
+        (predeterminado), WARN y ERROR, sin distinguir mayúsculas. No modifica
+        el resultado del caso. ``milestone_id`` es opcional; debe pertenecer al
+        caso activo. Un nivel inválido falla con ``INVALID_LEVEL``.
+
+        | Add Evidence Message | Se consultaron las cuentas del cliente. |
+        | Add Evidence Message | Saldo pendiente de confirmar. | level=WARN |
+        """
+        level = level.upper()
+        if level not in {"INFO", "WARN", "ERROR"}:
+            raise ValueError("INVALID_LEVEL: utiliza INFO, WARN o ERROR.")
+        return self._active(milestone_id).event(message, level=level, milestone_id=milestone_id)
+
+    def _driver(self):
+        try:
+            selenium = BuiltIn().get_library_instance("SeleniumLibrary")
+            return selenium.driver
+        except Exception as error:
+            raise CaptureError(
+                "BROWSER_UNAVAILABLE", "SeleniumLibrary no está importada o no hay navegador activo."
+            ) from error
+
+    def _context(self, driver):
+        context = {}
+        for field, attribute in (("url", "current_url"), ("page_title", "title")):
+            try:
+                context[field] = getattr(driver, attribute)
+            except Exception:
+                context[field] = ""
+        return context
+
+    def _image(self, content):
+        try:
+            with Image.open(io.BytesIO(content)) as image:
+                if image.format not in {"PNG", "JPEG", "WEBP"}:
+                    raise ValueError("solo se admite PNG, JPEG o WEBP")
+                image.load()
+                return image.format.lower(), image.size
+        except Exception as error:
+            raise CaptureError("INVALID_IMAGE", str(error)) from error
+
+    def _capture(self, title, producer, kind, milestone_id, strict, description, status="INFO", context=None):
+        status = status.upper()
+        if status not in {"INFO", "PASS", "WARN", "FAIL"}:
+            raise ValueError("INVALID_CAPTURE_STATUS: utiliza INFO, PASS, WARN o FAIL; SKIP no es válido.")
+        recorder = self._active(milestone_id)
+        try:
+            content, details = producer()
+            extension, size = self._image(content)
+            path = recorder.case_dir / f"{uuid4().hex}.{extension}"
+            try:
+                path.write_bytes(content)
+            except OSError as error:
+                raise CaptureError("STORAGE_ERROR", str(error)) from error
+            return recorder.event(
+                title,
+                kind="capture",
+                milestone_id=milestone_id,
+                capture_type=kind,
+                status=status,
+                description=description,
+                image=path.name,
+                width=size[0],
+                height=size[1],
+                **details,
+            )
+        except CaptureError as error:
+            reason = str(error)
+        except OSError as error:
+            reason = f"STORAGE_ERROR: {error}"
+        # Unexpected programming errors deliberately propagate.
+        try:
+            recorder.event(
+                title,
+                kind="capture_warning",
+                level="WARN",
+                status="WARN",
+                milestone_id=milestone_id,
+                capture_type=kind,
+                description=description,
+                reason=reason,
+                **(context or {}),
+            )
+        except OSError as error:
+            logger.warn(f"STORAGE_ERROR: tampoco se pudo guardar la advertencia: {error}")
+        logger.warn(f"No se obtuvo la evidencia '{title}'. {reason}")
+        if self.strict if strict is None else strict:
+            raise CaptureError("CAPTURE_FAILED", reason)
+        return None
+
+    @keyword
+    def capture_page_evidence(
+        self,
+        title: str,
+        description: str = "",
+        milestone_id=None,
+        strict: bool | None = None,
+        status: str = "INFO",
+    ):
+        """Captura el área visible de la página en el navegador activo.
+
+        Reutiliza la sesión de SeleniumLibrary (Chrome, Edge o Firefox).
+        No incluye barras del navegador, escritorio ni la página completa.
+        Guarda URL y título de página cuando están disponibles.
+
+        Consulta los argumentos comunes y errores en la introducción.
+        Devuelve el ID del evento, o ``None`` si falla sin modo estricto.
+        Sin sesión disponible registra ``BROWSER_UNAVAILABLE``.
+
+        | Capture Page Evidence | Error mostrado por la aplicación | status=FAIL |
+        """
+
+        def producer():
+            driver = self._driver()
+            try:
+                return driver.get_screenshot_as_png(), self._context(driver)
+            except Exception as error:
+                raise CaptureError("SCREENSHOT_FAILED", str(error)) from error
+
+        return self._capture(title, producer, "page", milestone_id, strict, description, status)
+
+    @keyword
+    def capture_element_evidence(
+        self,
+        locator: str,
+        title: str,
+        description: str = "",
+        milestone_id=None,
+        strict: bool | None = None,
+        status: str = "INFO",
+    ):
+        """Captura un elemento de la sesión activa de SeleniumLibrary.
+
+        ``locator`` utiliza la sintaxis de SeleniumLibrary, por ejemplo
+        ``css:.confirmation`` o ``id:registrationForm``. Guarda URL y título de
+        página cuando están disponibles. No abre una sesión nueva.
+
+        Consulta los argumentos comunes y errores en la introducción.
+        Devuelve el ID del evento, o ``None`` si falla sin modo estricto.
+        Un locator no resuelto registra ``ELEMENT_NOT_FOUND``.
+
+        | Capture Element Evidence | css:.confirmation | Alta confirmada | status=PASS |
+        """
+
+        def producer():
+            driver = self._driver()
+            try:
+                element = BuiltIn().get_library_instance("SeleniumLibrary").find_element(locator)
+            except Exception as error:
+                raise CaptureError("ELEMENT_NOT_FOUND", f"{locator}: {error}") from error
+            try:
+                return element.screenshot_as_png, self._context(driver)
+            except Exception as error:
+                raise CaptureError("SCREENSHOT_FAILED", str(error)) from error
+
+        return self._capture(title, producer, "element", milestone_id, strict, description, status)
+
+    @keyword
+    def capture_desktop_evidence(
+        self,
+        title: str,
+        description: str = "",
+        milestone_id=None,
+        strict: bool | None = None,
+        status: str = "INFO",
+    ):
+        """Captura el escritorio del entorno donde se ejecuta Robot.
+
+        Utiliza Pillow ImageGrab y no necesita SeleniumLibrary. Requiere un
+        entorno gráfico/backend compatible y los permisos del sistema.
+        No captura el escritorio de una máquina remota de Selenium Grid.
+        En headless, CI o paralelo, el usuario decide si esta captura es útil:
+        puede incluir otras ventanas y no se sustituye por una captura de página.
+
+        Consulta los argumentos comunes y errores en la introducción.
+        Devuelve el ID del evento, o ``None`` si falla sin modo estricto.
+        Un backend no disponible registra ``DESKTOP_UNAVAILABLE``.
+
+        | Capture Desktop Evidence | Escritorio al confirmar la operación | status=INFO |
+        """
+
+        def producer():
+            try:
+                image = ImageGrab.grab()
+                buffer = io.BytesIO()
+                image.save(buffer, format="PNG")
+                return buffer.getvalue(), {}
+            except Exception as error:
+                raise CaptureError("DESKTOP_UNAVAILABLE", str(error)) from error
+
+        return self._capture(title, producer, "desktop", milestone_id, strict, description, status)
+
+    @keyword
+    def attach_image_evidence(
+        self,
+        path: str,
+        title: str,
+        description: str = "",
+        milestone_id=None,
+        strict: bool | None = None,
+        status: str = "INFO",
+    ):
+        """Copia una imagen existente al directorio de evidencias del caso.
+
+        ``path`` admite una ruta absoluta o relativa al directorio de ejecución.
+        Acepta PNG, JPEG y WEBP; valida el contenido real de la imagen. El archivo
+        original no se modifica y puede moverse después de una copia exitosa.
+        No necesita navegador ni entorno gráfico.
+
+        Consulta los argumentos comunes y errores en la introducción.
+        Devuelve el ID del evento, o ``None`` si falla sin modo estricto.
+        Una ruta ilegible registra ``IMAGE_UNAVAILABLE``; contenido inválido,
+        ``INVALID_IMAGE``.
+
+        | Attach Image Evidence | ${EXECDIR}/data/confirmacion.png | Confirmación externa | status=PASS |
+        """
+
+        def producer():
+            try:
+                return Path(path).read_bytes(), {}
+            except OSError as error:
+                raise CaptureError("IMAGE_UNAVAILABLE", str(error)) from error
+
+        return self._capture(title, producer, "attachment", milestone_id, strict, description, status)

robotframework_evidence_reporter-0.1.0/src/rf_evidence_reporter/recorder.py

@@ -0,0 +1,107 @@
+"""Append evidence to independent, atomically replaced case files."""
+
+import json
+import os
+import re
+from datetime import datetime
+from pathlib import Path
+from uuid import uuid4
+
+
+def timestamp():
+    return datetime.now().astimezone().isoformat(timespec="milliseconds")
+
+
+def slug(text):
+    return re.sub(r"[^\w-]+", "-", text, flags=re.UNICODE).strip("-")[:80] or "case"
+
+
+class EvidenceRecorder:
+    """One writer per case; no shared manifests, counters or browser state."""
+
+    def __init__(self, output_dir):
+        self.output_dir = Path(output_dir).resolve()
+        self.case = None
+        self.case_dir = None
+
+    def start(self, name, suite="", description="", tags=()):
+        identifier = uuid4().hex
+        self.case_dir = self.output_dir / f"{slug(name)}-{identifier}"
+        self.case_dir.mkdir(parents=True, exist_ok=False)
+        self.case = {
+            "schema_version": 1,
+            "id": identifier,
+            "name": str(name),
+            "suite": str(suite),
+            "description": str(description),
+            "tags": list(tags),
+            "process_id": os.getpid(),
+            "started_at": timestamp(),
+            "ended_at": None,
+            "duration_seconds": None,
+            "status": "INCOMPLETE",
+            "message": "",
+            "metadata": {},
+            "milestones": [],
+            "events": [],
+        }
+        self.save()
+        return identifier
+
+    def require_case(self):
+        if self.case is None:
+            raise RuntimeError("NO_ACTIVE_CASE: la evidencia debe registrarse dentro de un caso de prueba.")
+
+    def save(self):
+        self.require_case()
+        target = self.case_dir / "case.json"
+        temporary = target.with_suffix(".tmp")
+        temporary.write_text(json.dumps(self.case, ensure_ascii=False, indent=2), encoding="utf-8")
+        temporary.replace(target)
+
+    def milestone(self, title, description=""):
+        self.require_case()
+        identifier = uuid4().hex
+        self.case["milestones"].append(
+            {"id": identifier, "title": str(title), "description": str(description)}
+        )
+        self.save()
+        return identifier
+
+    def validate_milestone(self, identifier):
+        self.require_case()
+        if identifier and not any(item["id"] == identifier for item in self.case["milestones"]):
+            raise ValueError("UNKNOWN_MILESTONE: el hito no pertenece al caso activo.")
+
+    def metadata(self, values):
+        self.require_case()
+        self.case["metadata"].update({str(key): str(value) for key, value in values.items()})
+        self.save()
+
+    def event(self, title, kind="message", level="INFO", milestone_id=None, **fields):
+        self.validate_milestone(milestone_id)
+        event = {
+            "id": uuid4().hex,
+            "title": str(title),
+            "kind": kind,
+            "level": level,
+            "milestone_id": milestone_id,
+            "captured_at": timestamp(),
+            **fields,
+        }
+        self.case["events"].append(event)
+        self.save()
+        return event["id"]
+
+    def finish(self, status, duration_seconds, message=""):
+        self.require_case()
+        if status not in {"PASS", "FAIL", "SKIP"}:
+            raise ValueError(f"Unsupported Robot status: {status}")
+        self.case.update(
+            status=status,
+            duration_seconds=float(duration_seconds),
+            message=str(message),
+            ended_at=timestamp(),
+        )
+        self.save()
+        self.case = None

robotframework_evidence_reporter-0.1.0/src/rf_evidence_reporter/templates/report.html

@@ -0,0 +1,80 @@
+<!doctype html>
+<html lang="es" data-theme="light">
+<head>
+<meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
+<title>{{ case.name }} · Evidence Reporter</title>
+<style>
+:root{color-scheme:light;--canvas:#f0f4fb;--paper:#fff;--soft:#f7f9fd;--ink:#1c2c47;--muted:#52627c;--line:#dce4f1;--brand:#5744cc;--cyan:#007c91;--info:#1467c2;--pass:#168044;--warn:#a26000;--fail:#c52d4b;--info-bg:#e9f2ff;--pass-bg:#e5f6ec;--warn-bg:#fff3c9;--fail-bg:#ffe8ee;--shadow:0 12px 35px #304d7810}
+[data-theme="dark"]{color-scheme:dark;--canvas:#0d1424;--paper:#182238;--soft:#1d2a43;--ink:#edf3ff;--muted:#a8b9d3;--line:#34435e;--brand:#b1a3ff;--cyan:#5de0ed;--info:#8ac4ff;--pass:#79e7a8;--warn:#ffda72;--fail:#ff98ab;--info-bg:#213b5b;--pass-bg:#173e31;--warn-bg:#45371b;--fail-bg:#482837;--shadow:0 12px 35px #0002}
+*{box-sizing:border-box}body{margin:0;background:var(--canvas);color:var(--ink);font:15px/1.65 system-ui,-apple-system,"Segoe UI",sans-serif}button{font:inherit}button:focus-visible,summary:focus-visible{outline:3px solid var(--cyan);outline-offset:4px}[hidden]{display:none!important}header{background:linear-gradient(120deg,#33277d,#155571);color:#fff;border-bottom:4px solid #47d4d9;padding:23px max(22px,calc((100vw - 1120px)/2))}.header-row{display:flex;justify-content:space-between;align-items:center;gap:20px}.brand{font-weight:800;letter-spacing:.02em}.header-caption{font-size:12px;color:#d4dcff}.theme-switch{border:1px solid #ffffff65;border-radius:24px;color:#fff;background:#ffffff12;padding:8px 16px;cursor:pointer}.theme-switch[aria-checked="true"]{background:#ffffff25}main{max-width:1120px;margin:auto;padding:28px 24px 50px}.tabs{display:flex;gap:6px;padding:6px;background:var(--paper);border:1px solid var(--line);border-radius:14px;margin-bottom:24px;box-shadow:var(--shadow)}.tab{flex:1;border:0;border-radius:10px;padding:12px;color:var(--muted);background:transparent;font-weight:700;cursor:pointer}.tab[aria-selected="true"]{background:var(--brand);color:var(--paper)}[data-theme="dark"] .tab[aria-selected="true"]{color:#151d32}.card,.block{background:var(--paper);border:1px solid var(--line);border-radius:18px;box-shadow:var(--shadow);margin-bottom:24px}.card{padding:30px}.eyebrow{font-size:12px;font-weight:800;color:var(--brand);letter-spacing:.09em;text-transform:uppercase}.title-row{display:flex;justify-content:space-between;align-items:flex-start;gap:24px}h1{font-size:clamp(25px,4vw,36px);line-height:1.25;letter-spacing:-.025em;margin:12px 0 16px;overflow-wrap:anywhere}h2{font-size:24px;line-height:1.35;margin:0}h3{font-size:18px;margin:0}p{margin:8px 0;white-space:pre-wrap;overflow-wrap:anywhere}.muted{color:var(--muted)}.badge{display:inline-flex;align-items:center;gap:8px;font-size:12px;font-weight:850;letter-spacing:.03em;padding:5px 11px;border:1px solid currentColor;border-radius:9px;white-space:nowrap}.execution-status{font-size:17px;padding:12px 20px;margin-top:10px;box-shadow:0 5px 18px #0001}.PASS{color:var(--pass);background:var(--pass-bg)}.FAIL,.ERROR{color:var(--fail);background:var(--fail-bg)}.WARN,.SKIP,.INCOMPLETE{color:var(--warn);background:var(--warn-bg)}.INFO{color:var(--info);background:var(--info-bg)}.stats{display:grid;grid-template-columns:repeat(3,1fr);gap:14px;margin:24px 0}.stat{padding:16px 20px;background:var(--soft);border-radius:12px;border-top:3px solid var(--brand)}.stat:nth-child(2){border-color:var(--cyan)}.stat:nth-child(3){border-color:var(--warn)}.stat small{display:block;color:var(--muted)}.stat strong{font-size:23px}table{width:100%;border-collapse:collapse}th,td{padding:12px;border-bottom:1px solid var(--line);vertical-align:top;text-align:left;overflow-wrap:anywhere}th{width:26%;color:var(--muted);font-weight:600}tr:last-child>*{border-bottom:0}.block-head{padding:24px 26px;background:var(--soft);border-radius:18px 18px 0 0;border-bottom:1px solid var(--line);border-left:5px solid var(--brand)}.block-head h2{color:var(--brand);margin-top:6px}.number{display:inline-grid;place-items:center;background:var(--brand);color:var(--paper);width:32px;height:32px;border-radius:9px;margin-right:10px;font-size:16px}[data-theme="dark"] .number{color:#151d32}.events{padding:0 26px 24px}.event{padding:22px 0;border-bottom:1px solid var(--line)}.event:last-child{border-bottom:0}.event-head{display:flex;align-items:flex-start;justify-content:space-between;gap:20px}.event-title{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.time{font-size:12px;color:var(--muted)}.capture{border-left:4px solid var(--info);padding-left:18px}.capture[data-status="PASS"]{border-color:var(--pass)}.capture[data-status="WARN"]{border-color:var(--warn)}.capture[data-status="FAIL"]{border-color:var(--fail)}.image-button{display:block;width:100%;margin-top:16px;padding:0;background:var(--soft);border:1px solid var(--line);border-radius:10px;overflow:hidden;cursor:zoom-in}.image-button img{display:block;width:100%;height:auto}.caption{display:flex;justify-content:space-between;gap:12px;font-size:12px;color:var(--muted);margin-top:7px}.context{font-size:12px;color:var(--muted);overflow-wrap:anywhere;margin-top:10px}.note{background:transparent;border-left:4px solid var(--info);padding:10px 16px;margin-top:12px}.note.WARN{border-color:var(--warn)}.note.ERROR{border-color:var(--fail)}.note .badge{background:transparent}.note p{color:var(--ink)}details{border:1px solid var(--line);border-radius:10px;margin-top:18px;background:var(--paper)}summary{padding:13px 16px;cursor:pointer;font-weight:700;color:var(--muted)}details .log-list{padding:0 16px 16px}.log{padding:12px 0}.log+.log{border-top:1px solid var(--line)}.empty{padding:20px 0;color:var(--muted)}.footer{text-align:center;font-size:12px;color:var(--muted);margin-top:30px}.result-message{margin-top:20px}dialog{background:var(--paper);color:var(--ink);border:1px solid var(--line);border-radius:14px;padding:16px;max-width:96vw;max-height:96vh}dialog::backdrop{background:#050b19de}dialog img{display:block;max-width:90vw;max-height:80vh;object-fit:contain}.close{display:block;margin-left:auto;margin-bottom:12px;border:1px solid var(--line);border-radius:8px;background:var(--soft);color:var(--ink);padding:8px 16px;cursor:pointer}@media(max-width:640px){main{padding:20px 12px}.card{padding:20px}.title-row,.event-head{display:block}.stats{grid-template-columns:1fr}.header-row{align-items:flex-start}.header-caption{max-width:200px}.theme-switch{font-size:12px;padding:7px 10px}.block-head{padding:20px}.events{padding:0 18px 20px}.caption{flex-wrap:wrap}.time{display:block;margin-top:8px}th{width:34%}.tab{padding:10px 4px}}
+
+.block{margin-top:0}.block-head{display:flex;align-items:center;justify-content:space-between;gap:20px;list-style:none;border-radius:18px;border-bottom:0;color:var(--ink)}.block-head::-webkit-details-marker{display:none}.block[open]>.block-head{border-radius:18px 18px 0 0;border-bottom:1px solid var(--line)}.block-label{display:block;min-width:0}.block-title{display:block;font-size:24px;line-height:1.4;font-weight:800;color:var(--brand);margin:6px 0;overflow-wrap:anywhere}.block-counts{font-size:12px;color:var(--muted);font-weight:500}.disclosure{font-size:28px;color:var(--brand);transition:transform .15s}.block[open]>.block-head .disclosure{transform:rotate(180deg)}.block-description{padding-top:16px}.block-tabs{display:flex;gap:6px;margin-top:20px;border:1px solid var(--line);border-radius:10px;padding:5px;background:var(--soft)}.milestone-toolbar{display:flex;justify-content:space-between;align-items:center;gap:16px;margin-bottom:18px;color:var(--muted);font-size:13px}.milestone-toolbar>div{display:flex;gap:8px;flex-wrap:wrap}.control-button{border:1px solid var(--line);background:var(--paper);color:var(--brand);border-radius:8px;padding:8px 12px;font-weight:700;cursor:pointer}.control-button:hover{background:var(--soft)}@media(max-width:640px){.milestone-toolbar{align-items:flex-start;flex-direction:column}.block-title{font-size:21px}.block-head{padding:18px}.block-counts{display:block}.control-button{font-size:12px}.block-tabs .tab{font-size:13px}}
+.brand svg{width:32px;height:32px;vertical-align:middle;margin-right:8px}
+</style>
+</head>
+<body>
+<header><div class="header-row"><div><div class="brand"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Evidence Reporter">
+<title>Evidence Reporter</title><defs><linearGradient id="brand" x2="1" y2="1"><stop stop-color="#5744cc"/><stop offset="1" stop-color="#155571"/></linearGradient></defs>
+<rect width="64" height="64" rx="16" fill="url(#brand)"/>
+<rect x="14" y="10" width="34" height="44" rx="5" fill="none" stroke="#fff" stroke-width="3"/>
+<rect x="20" y="18" width="22" height="17" rx="3" fill="#b1a3ff"/>
+<path d="m22 31 6-7 5 5 4-4 3 6" fill="none" stroke="#fff" stroke-width="2.5" stroke-linejoin="round"/>
+<path d="M21 42h14M21 47h9" stroke="#fff" stroke-width="2.5" stroke-linecap="round"/>
+<circle cx="47" cy="47" r="12" fill="#47d4d9" stroke="#155571" stroke-width="2"/>
+<path d="m41 47 4 4 8-9" fill="none" stroke="#132a43" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+ Evidence Reporter</div><div class="header-caption">Reporte individual de evidencias de negocio</div></div><button class="theme-switch" id="theme-toggle" role="switch" aria-checked="false" aria-label="Modo oscuro">☾ Modo oscuro</button></div></header>
+<main>
+<nav class="tabs" role="tablist" aria-label="Secciones del reporte" hidden>
+{% for id,label in [('summary','Resumen'),('steps','Pasos'),('logs','Logs')] %}<button class="tab" id="tab-{{ id }}" role="tab" aria-controls="{{ id }}" aria-selected="{{ 'true' if loop.first else 'false' }}" tabindex="{{ '0' if loop.first else '-1' }}">{{ label }}</button>{% endfor %}
+</nav>
+<section id="summary" role="tabpanel" aria-labelledby="tab-summary" tabindex="0">
+<div class="card"><div class="eyebrow">Resumen del caso</div><div class="title-row"><h1>{{ case.name }}</h1><div><div class="muted">Estatus de ejecución</div><span class="badge execution-status {{ case.status }}">{% if case.status == 'PASS' %}✓{% elif case.status == 'FAIL' %}✕{% elif case.status == 'SKIP' %}↷{% else %}!{% endif %} {{ case.status }}</span></div></div>
+{% if case.description %}<p class="muted">{{ case.description }}</p>{% endif %}
+<div class="stats"><div class="stat"><small>Duración</small><strong>{% if case.duration_seconds is not none %}{{ '%.2f'|format(case.duration_seconds) }} s{% else %}Sin finalizar{% endif %}</strong></div><div class="stat"><small>Capturas obtenidas</small><strong>{{ case.events|selectattr('kind','equalto','capture')|list|length }}</strong></div><div class="stat"><small>Advertencias</small><strong>{{ case.warning_count }}</strong></div></div>
+<table aria-label="Información del caso"><tbody><tr><th scope="row">Caso de prueba</th><td>{{ case.name }}</td></tr><tr><th scope="row">Suite</th><td>{{ case.suite }}</td></tr><tr><th scope="row">Inicio de ejecución</th><td><time title="{{ case.started_at }}">{{ case.started_at|display_date }}</time></td></tr><tr><th scope="row">Fin de ejecución</th><td><time title="{{ case.ended_at or '' }}">{{ case.ended_at|display_date }}</time></td></tr>{% for label,value in case.metadata.items() %}<tr><th scope="row">{{ label }}</th><td>{{ value }}</td></tr>{% endfor %}</tbody></table>
+{% if case.message %}<div class="note {% if case.status == 'FAIL' %}ERROR{% else %}WARN{% endif %} result-message"><strong>Resultado</strong><p>{{ case.message }}</p></div>{% endif %}
+{% if case.status == 'INCOMPLETE' %}<div class="note WARN result-message">Ejecución incompleta: se muestran las evidencias conservadas, sin atribuir un resultado final.</div>{% endif %}
+</div></section>
+{% macro logs_list(events) %}{% for event in events %}<article class="log"><div class="event-head"><strong>{{ event.title }}</strong><time class="time" title="{{ event.captured_at }}">{{ event.captured_at|display_date }}</time></div><div class="note {{ event.level }}"><span class="badge {{ event.level }}">{{ event.level }}</span>{% if event.reason %}<p>{{ event.reason }}</p>{% else %}<p>{{ event.title }}</p>{% endif %}</div></article>{% endfor %}{% endmacro %}
+{% macro captures_list(events) %}{% for event in events if event.kind in ['capture','capture_warning'] %}<article class="event"><div class="capture" data-status="{{ event.status }}"><div class="event-head"><div class="event-title"><h3>{{ event.title }}</h3><span class="badge {{ event.status }}">{% if event.status == 'PASS' %}✓{% elif event.status == 'FAIL' %}✕{% elif event.status == 'WARN' %}!{% else %}ⓘ{% endif %} {{ event.status }}</span></div><time class="time" title="{{ event.captured_at }}">{{ event.captured_at|display_date }}</time></div>
+{% if event.kind == 'capture' %}{% if event.description %}<p class="muted">{{ event.description }}</p>{% endif %}<button class="image-button" aria-label="Ampliar: {{ event.title }}"><img src="{{ event.image_data }}" alt="{{ event.title }}" loading="lazy"></button><div class="caption"><span>{{ {'page':'Página visible','element':'Elemento','desktop':'Escritorio','attachment':'Imagen adjunta'}.get(event.capture_type,event.capture_type) }} · {{ event.width }} × {{ event.height }} px</span><span>Ampliar imagen ↗</span></div>{% if event.url %}<div class="context">URL: {{ event.url }}{% if event.page_title %}<br>Página: {{ event.page_title }}{% endif %}</div>{% endif %}
+{% else %}<div class="note WARN"><strong>Evidencia no disponible</strong><p>{{ event.reason }}</p></div>{% endif %}</div></article>{% else %}<p class="empty">Sin capturas en este bloque.</p>{% endfor %}
+{% endmacro %}
+<section id="steps" role="tabpanel" aria-labelledby="tab-steps" tabindex="0">
+{% set milestones = blocks|selectattr('id')|list %}{% if milestones %}<div class="milestone-toolbar" aria-label="Controles de hitos"><span>{{ milestones|length }} hitos de negocio</span><div><button id="expand-milestones" class="control-button">Expandir todos los hitos</button><button id="collapse-milestones" class="control-button">Contraer todos los hitos</button></div></div>{% endif %}
+{% for block in blocks %}{% set block_index = loop.index %}{% set messages = block.events|rejectattr('kind','equalto','capture')|list %}{% set warnings = block.events|selectattr('level','equalto','WARN')|list %}{% set captures = block.events|selectattr('kind','equalto','capture')|list %}
+<details class="block" data-block-kind="{{ 'milestone' if block.id else 'direct' }}" {% if block.id %}open{% endif %}>
+<summary class="block-head"><span class="block-label"><span class="eyebrow">{{ 'Hito de negocio' if block.id else 'Evidencias directas' }}</span><span class="block-title"><span class="number">{{ loop.index }}</span>{{ block.title }}</span><span class="block-counts">{{ captures|length }} capturas · {{ messages|length }} logs · {{ block.warning_count }} advertencias</span></span><span class="disclosure" aria-hidden="true">⌄</span></summary>
+<div class="events">{% if block.description %}<p class="block-description muted">{{ block.description }}</p>{% endif %}
+{% if not block.id %}
+<nav class="block-tabs" role="tablist" aria-label="Contenido de evidencias directas" hidden><button class="tab" id="direct-evidence-tab" role="tab" aria-controls="direct-evidence" aria-selected="true" tabindex="0">Evidencias</button><button class="tab" id="direct-logs-tab" role="tab" aria-controls="direct-logs" aria-selected="false" tabindex="-1">Logs del bloque · {{ messages|length }}</button></nav>
+<div id="direct-evidence" role="tabpanel" aria-labelledby="direct-evidence-tab">{{ captures_list(block.events) }}</div>
+<div id="direct-logs" role="tabpanel" aria-labelledby="direct-logs-tab">{{ logs_list(messages) }}{% if not messages %}<p class="empty">Sin mensajes registrados en este bloque.</p>{% endif %}</div>
+{% else %}
+{{ captures_list(block.events) }}
+{% if messages %}<details class="block-logs"><summary>Logs del bloque · {{ messages|length }}</summary><div class="log-list">{{ logs_list(messages) }}</div></details>{% endif %}
+{% endif %}</div></details>
+{% else %}<div class="card"><h2>Sin evidencias registradas</h2><p class="muted">El resultado se conserva aunque no se hayan llamado keywords de evidencia.</p></div>{% endfor %}
+</section>
+<section id="logs" role="tabpanel" aria-labelledby="tab-logs" tabindex="0"><div class="card"><div class="eyebrow">Registro de mensajes</div><h2>Logs de negocio</h2><p class="muted">Mensajes explícitos y advertencias de captura. Despliega el bloque que quieras consultar.</p>
+{% set counts = namespace(total=0) %}{% for block in blocks %}{% set messages = block.events|rejectattr('kind','equalto','capture')|list %}{% if messages %}{% set counts.total = counts.total + messages|length %}<details><summary>{{ block.title }} · {{ messages|length }}</summary><div class="log-list">{{ logs_list(messages) }}</div></details>{% endif %}{% endfor %}{% if counts.total == 0 %}<p class="empty">Sin logs registrados.</p>{% endif %}
+</div></section>
+<footer class="footer">Zona horaria de ejecución: {{ case.started_at|timezone_label }}<br>Generado: {{ generated_at|display_date }} · {{ generated_at|timezone_label }}<br>Robot Framework Evidence Reporter</footer>
+</main><dialog id="viewer" aria-label="Vista ampliada de evidencia"><button class="close">Cerrar ✕</button><img alt=""></dialog>
+<script>
+const themeButton=document.getElementById('theme-toggle');
+function setTheme(dark){document.documentElement.dataset.theme=dark?'dark':'light';themeButton.setAttribute('aria-checked',String(dark));themeButton.textContent=dark?'☀ Modo claro':'☾ Modo oscuro';}
+let stored;try{stored=localStorage.getItem('evidence-theme');}catch(e){}
+setTheme(stored?stored==='dark':window.matchMedia('(prefers-color-scheme: dark)').matches);
+themeButton.addEventListener('click',()=>{const dark=document.documentElement.dataset.theme!=='dark';setTheme(dark);try{localStorage.setItem('evidence-theme',dark?'dark':'light');}catch(e){}});
+function wireTabs(tablist){const tabs=[...tablist.querySelectorAll(':scope > [role="tab"]')];function activate(tab){tabs.forEach(item=>{const selected=item===tab;item.setAttribute('aria-selected',String(selected));item.tabIndex=selected?0:-1;document.getElementById(item.getAttribute('aria-controls')).hidden=!selected;});}tablist.hidden=false;activate(tabs[0]);tabs.forEach((tab,index)=>{tab.addEventListener('click',()=>activate(tab));tab.addEventListener('keydown',event=>{let next;if(event.key==='ArrowRight')next=(index+1)%tabs.length;else if(event.key==='ArrowLeft')next=(index+tabs.length-1)%tabs.length;else if(event.key==='Home')next=0;else if(event.key==='End')next=tabs.length-1;if(next!==undefined){event.preventDefault();activate(tabs[next]);tabs[next].focus();}});});}
+document.querySelectorAll('.tabs,.block-tabs').forEach(wireTabs);
+const milestones=[...document.querySelectorAll('details[data-block-kind="milestone"]')];
+document.getElementById('expand-milestones')?.addEventListener('click',()=>milestones.forEach(block=>block.open=true));
+document.getElementById('collapse-milestones')?.addEventListener('click',()=>milestones.forEach(block=>block.open=false));
+const dialog=document.getElementById('viewer');let previousFocus;
+document.querySelectorAll('.image-button').forEach(button=>button.addEventListener('click',()=>{previousFocus=button;const image=button.querySelector('img');const enlarged=dialog.querySelector('img');enlarged.src=image.src;enlarged.alt=image.alt;dialog.showModal();}));
+dialog.querySelector('.close').addEventListener('click',()=>dialog.close());dialog.addEventListener('close',()=>{if(previousFocus)previousFocus.focus();});dialog.addEventListener('click',event=>{if(event.target===dialog)dialog.close();});
+</script>
+</body></html>