feat: app script_navegador y dashboard Metabase

App Go para ejecutar scripts de navegación automatizada usando las
funciones CDP del registry. Incluye script de creación de dashboard
en Metabase para monitoreo.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

apps/script_navegador/script.go

@@ -0,0 +1,121 @@
+package main
+
+import (
+	"fmt"
+	"os"
+
+	"gopkg.in/yaml.v3"
+)
+
+// Script representa un archivo YAML de pasos de navegacion.
+type Script struct {
+	Name  string `yaml:"name"`
+	Steps []Step `yaml:"steps"`
+}
+
+// Step es un paso individual dentro del script.
+type Step struct {
+	// Comun a todos los pasos
+	Action          string `yaml:"action"`
+	ContinueOnError bool   `yaml:"continue_on_error"`
+
+	// navigate
+	URL string `yaml:"url"`
+
+	// wait
+	Selector  string `yaml:"selector"`
+	TimeoutMs int    `yaml:"timeout_ms"`
+
+	// type
+	Text string `yaml:"text"`
+
+	// screenshot
+	Path     string `yaml:"path"`
+	FullPage bool   `yaml:"full_page"`
+
+	// evaluate
+	Expr string `yaml:"expr"`
+
+	// sleep
+	Ms int `yaml:"ms"`
+}
+
+// Validate comprueba que el script tiene los campos minimos correctos.
+func (s *Script) Validate() error {
+	if s.Name == "" {
+		return fmt.Errorf("script: campo 'name' obligatorio")
+	}
+	if len(s.Steps) == 0 {
+		return fmt.Errorf("script %q: sin pasos definidos", s.Name)
+	}
+	for i, step := range s.Steps {
+		if err := step.Validate(i); err != nil {
+			return err
+		}
+	}
+	return nil
+}
+
+// Validate comprueba que el paso tiene los campos requeridos segun su action.
+func (s *Step) Validate(idx int) error {
+	prefix := fmt.Sprintf("step[%d] action=%q", idx, s.Action)
+	switch s.Action {
+	case "navigate":
+		if s.URL == "" {
+			return fmt.Errorf("%s: campo 'url' obligatorio", prefix)
+		}
+	case "wait":
+		if s.Selector == "" {
+			return fmt.Errorf("%s: campo 'selector' obligatorio", prefix)
+		}
+	case "click":
+		if s.Selector == "" {
+			return fmt.Errorf("%s: campo 'selector' obligatorio", prefix)
+		}
+	case "type":
+		if s.Selector == "" {
+			return fmt.Errorf("%s: campo 'selector' obligatorio", prefix)
+		}
+		if s.Text == "" {
+			return fmt.Errorf("%s: campo 'text' obligatorio", prefix)
+		}
+	case "screenshot":
+		if s.Path == "" {
+			return fmt.Errorf("%s: campo 'path' obligatorio", prefix)
+		}
+	case "evaluate":
+		if s.Expr == "" {
+			return fmt.Errorf("%s: campo 'expr' obligatorio", prefix)
+		}
+	case "get_html":
+		// sin parametros requeridos
+	case "wait_load":
+		// sin parametros requeridos (timeout_ms opcional)
+	case "sleep":
+		if s.Ms <= 0 {
+			return fmt.Errorf("%s: campo 'ms' debe ser mayor que 0", prefix)
+		}
+	default:
+		return fmt.Errorf("%s: accion desconocida (navigate|wait|wait_load|click|type|screenshot|evaluate|get_html|sleep)", prefix)
+	}
+	return nil
+}
+
+// LoadScript lee y parsea un archivo YAML de script de navegador.
+func LoadScript(path string) (*Script, error) {
+	data, err := os.ReadFile(path)
+	if err != nil {
+		return nil, fmt.Errorf("leer script %q: %w", path, err)
+	}
+
+	var s Script
+	if err := yaml.Unmarshal(data, &s); err != nil {
+		return nil, fmt.Errorf("parsear script %q: %w", path, err)
+	}
+
+	if err := s.Validate(); err != nil {
+		return nil, err
+	}
+
+	return &s, nil
+}