chore: auto-commit (13 archivos)

- CAPABILITIES_TODO.md
- demo_e2e/RESUMEN.md
- demo_e2e/results/prueba_1_quotes.json
- demo_e2e/results/prueba_2_perceive.json
- demo_e2e/results/prueba_3_search.json
- demo_e2e/results/prueba_4_login_session.json
- demo_e2e/results/prueba_5_books.json
- demo_e2e/results/prueba_6_session_storage.json
- demo_e2e/results/prueba_7_find_honesto.json
- demo_e2e/results/prueba_8_verificacion.json
- ...

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

demo_e2e/RESUMEN.md

@@ -15,9 +15,9 @@ de simples a complejas. No "compila", sino "funciona".
   mensajes de golpe falló por una race: el servidor procesa requests de forma concurrente.
 - **Runner**: `run_demo.py` — ejecuta las 5 pruebas, guarda pasos/respuestas/veredicto en `results/`.
 
-## Resultado: 8/8 PASS (headless y con ventana visible)
+## Resultado: 9/9 PASS (headless y con ventana visible)
 
-Las pruebas 1-5 son la batería inicial; 6-8 se añadieron para validar las tandas de fixes (A/D/E y B).
+Las pruebas 1-5 son la batería inicial; 6-9 se añadieron para validar las tandas de fixes (A/D/E, B, y gap #1).
 
 | # | Prueba | Sitio sandbox | Capacidades ejercitadas | Resultado |
 |---|---|---|---|---|
@@ -29,6 +29,7 @@ Las pruebas 1-5 son la batería inicial; 6-8 se añadieron para validar las tand
 | 6 | sessionStorage en storage_state | the-internet.herokuapp.com | set→save→clear→load→get | PASS — `clear=null`, `restore=demo_v` (fix D) |
 | 7 | `find_by_text` honesto | quotes.toscrape.com | dom_find_by_text presente vs inexistente | PASS — texto inexistente devuelve error, no vacío (fix E) |
 | 8 | Verificación post-acción | quotes.toscrape.com | dom_click sobre oculto / dom_type sin foco | PASS — ambos devuelven error en vez de actuar al vacío (fix B) |
+| 9 | Bucle percibir→actuar por `#ref` | the-internet.herokuapp.com/login | page_perceive → dom_type_ref/dom_click_ref + auto-observe | PASS — login solo por `#ref` (sin selector); cada acción devuelve el outline nuevo (gap #1) |
 
 Cobertura conjunta: lanzar/atar navegador, navegar, esperar carga, evaluar JS con JSON real, percibir
 (AX outline), leer texto, teclado, formularios, cookies, estado de sesión, y composición multi-página.
@@ -69,6 +70,26 @@ Tras la primera batería se atacaron tres deudas, cada una validada:
   encontraba (el caller creía que había encontrado algo). Ahora devuelve error explícito. Validado por la
   prueba 7.
 
+## Gap #1 — bucle percibir→actuar por `#ref` (lo que cierra el loop del agente)
+
+El cambio que más sube el nivel del agente. Un solo cambio resolvió tres cosas a la vez:
+
+- **`#ref` = `backendDOMNodeId`** (no el `nodeId` efímero del AX tree). `render_ax_outline` ahora emite el id
+  del nodo DOM real, estable mientras el nodo viva → el `#ref` que el LLM lee sigue válido cuando actúa un
+  instante después. Resuelve "ref→acción" y "refs estables" de golpe, **sin mantener mapa de estado** en el MCP.
+- **Funciones por ref** (`cdp_click_ref`, `cdp_type_ref`, `cdp_hover_ref`): resuelven `backendDOMNodeId` →
+  bbox (`DOM.getBoxModel`) → centro → acción humanizada.
+- **Primitivo único `cdp_click_xy_human`**: click humanizado por coordenadas, compartido por las tres vías
+  (selector, `#ref`, y futura visión OCR/YOLO). `cdp_click_human` se refactorizó para usarlo (un solo camino).
+- **Auto-observe**: cada tool `_ref` del MCP devuelve el outline AX actualizado tras la acción → el LLM ve el
+  efecto sin pedir otra lectura = verificación implícita (como Playwright MCP).
+- **Defectos de calidad de `render_ax_outline` corregidos** en la misma edición: guard de ciclo + límite de
+  profundidad (evita `RecursionError`), se quitó el `ljust(60)` (gastaba tokens en relleno), y ahora renderiza
+  el `value` de los inputs (texto escrito, estado).
+
+Validado por la prueba 9: login completo en the-internet **actuando solo por `#ref`** (sin un solo selector CSS).
+Pendiente de esta familia: política de humanización por sesión (`human`/`fast`/`instant`) para scraping masivo.
+
 ## Tercera tanda de fix (B) — verificación post-acción
 
 - **B — fin del "fire-and-forget"** (`cdp_click.go`, `cdp_type_text.go`). `cdp_click` ahora verifica que