feat(browser): auto-commit con 60 cambios

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

functions/browser/cdp_handle_dialog.md

@@ -5,13 +5,13 @@ kind: function
 lang: go
 domain: browser
 purity: impure
-version: 1.0.0
-tested: false
-tests: []
-test_file_path: ""
-description: "Instala un auto-handler que responde automaticamente a dialogos JS (alert/confirm/prompt/beforeunload) via Page.javascriptDialogOpening CDP hasta que se llame el cancel devuelto."
+version: 1.1.0
+tested: true
+tests: ["TestCdpHandleDialog_nilConn", "TestDialogLog"]
+test_file_path: "functions/browser/cdp_handle_dialog_test.go"
+description: "Instala un auto-handler que responde automaticamente a dialogos JS (alert/confirm/prompt/beforeunload) via Page.javascriptDialogOpening CDP hasta que se llame el cancel devuelto. Devuelve un *DialogLog con Count/LastType/LastMessage de lo auto-respondido. Un unico worker serializa las respuestas (no spawnea una goroutine por dialogo)."
 tags: [cdp, browser, dialog, input, navegator]
-signature: "func CdpHandleDialog(c *CDPConn, accept bool, promptText string) (func(), error)"
+signature: "func CdpHandleDialog(c *CDPConn, accept bool, promptText string) (func(), *DialogLog, error)"
 uses_functions: []
 uses_types: []
 returns: []
@@ -32,7 +32,7 @@ params:
     desc: "true para aceptar/OK el dialogo; false para rechazar/Cancel. Para alert() el valor no importa (siempre se cierra), para confirm() determina el valor de retorno, para prompt() determina si se devuelve el texto o null."
   - name: promptText
     desc: "Texto a inyectar en dialogos prompt(). Vacio string para no inyectar texto. Ignorado en alert() y confirm()."
-output: "cancel func() para des-registrar el handler cuando ya no se necesite, y error si la conexion es nula o Page.enable falla. El cancel devuelto es seguro llamarlo multiples veces."
+output: "(cancel func(), *DialogLog, error): cancel des-registra el handler y detiene el worker (idempotente, seguro llamarlo varias veces); DialogLog acumula Count/LastType/LastMessage de lo auto-respondido (leer con Snapshot()); error si la conexion es nula o Page.enable falla."
 ---
 
 ## Ejemplo
@@ -40,10 +40,10 @@ output: "cancel func() para des-registrar el handler cuando ya no se necesite, y
 ```go
 conn, _ := CdpConnect(9222)
 _ = CdpNavigate(conn, "https://example.com/admin")
-_ = CdpWaitLoad(conn, 3000)
+_ = CdpWaitLoad(conn, 3*time.Second)
 
 // Instalar handler antes de la accion que dispara el dialogo
-cancel, err := CdpHandleDialog(conn, true, "")
+cancel, dlog, err := CdpHandleDialog(conn, true, "")
 if err != nil {
     log.Fatal(err)
 }
@@ -52,13 +52,11 @@ defer cancel()
 // Este boton dispara confirm("¿Seguro que quieres borrar?")
 // El handler lo acepta automaticamente sin bloquear
 _ = CdpClick(conn, "#btn-delete-all")
-_ = CdpWaitIdle(conn, 2000)
+_ = CdpWaitIdle(conn, CdpWaitIdleOpts{})
 
-// Ejemplo con prompt(): responder con texto especifico
-cancelPrompt, _ := CdpHandleDialog(conn, true, "mi-respuesta-secreta")
-defer cancelPrompt()
-_ = CdpClick(conn, "#btn-ask-password")
-_ = CdpWaitIdle(conn, 1000)
+// Saber qué se auto-respondió
+count, lastType, lastMsg := dlog.Snapshot()
+fmt.Printf("auto-respondidos: %d (último %s: %q)\n", count, lastType, lastMsg)
 ```
 
 ## Cuando usarla
@@ -67,8 +65,13 @@ Instalar antes de cualquier accion que pueda disparar `alert()`, `confirm()`, `p
 
 ## Gotchas
 
-- DEADLOCK GARANTIZADO si se llama `sendCDP` de forma sincrona dentro del handler de evento. El handler corre en la goroutine de lectura del WebSocket; `sendCDP` espera una respuesta que esa misma goroutine deberia leer. La implementacion ya usa `go c.sendCDP(...)` para evitarlo — no modificar este patron.
-- El handler se instala de forma permanente hasta que se llame `cancel()`. Si la pagina dispara multiples dialogos, todos seran respondidos con los mismos parametros `accept` y `promptText`.
-- `Page.enable` es idempotente pero tiene coste de red; no llamar CdpHandleDialog en bucles tight.
-- Para `beforeunload` (cuando el usuario cierra/navega fuera), `accept: true` permite la navegacion y `accept: false` la bloquea.
-- Llamar `cancel()` no cierra dialogos ya abiertos; solo evita que los futuros sean respondidos automaticamente.
+- DEADLOCK GARANTIZADO si se llama `sendCDP` de forma sincrona dentro del handler de evento. El handler corre en la goroutine de lectura del WebSocket; `sendCDP` espera una respuesta que esa misma goroutine deberia leer. La implementacion encola el evento en un canal y lo responde desde UN worker aparte — no modificar este patron.
+- **Un único worker, no goroutine por diálogo**: el handler antiguo hacía `go c.sendCDP(...)` por cada diálogo (spawn ilimitado). Ahora encola en un canal con buffer (64) que consume un worker. Si la página dispara una tormenta de diálogos que llena el buffer, los excedentes se descartan (no se responden) para no colgar la conexión — caso patológico, raro en la práctica.
+- **Leer el log con `Snapshot()`**: `DialogLog` tiene mutex interno. En concurrencia, usa `dlog.Snapshot()` en vez de leer los campos públicos directamente (evita data race con el worker).
+- El handler responde todos los diálogos con los mismos `accept` y `promptText` hasta que se llame `cancel()`.
+- `cancel()` es idempotente (seguro llamarlo varias veces) y detiene el worker. No cierra diálogos ya abiertos; solo evita responder los futuros.
+- Para `beforeunload`, `accept: true` permite la navegacion y `accept: false` la bloquea.
+
+## Capability growth log
+
+- v1.1.0 (2026-06-06) — devuelve `*DialogLog` (Count/LastType/LastMessage) para que el caller sepa qué se auto-respondió; reemplaza el spawn de una goroutine por diálogo por un worker único alimentado por canal con buffer; `cancel()` ahora idempotente vía sync.Once.