docs(flows): DoD obligatorio con user-facing surface + abrir issues 0100-0103 (taxonomia, frontmatter migration, dev_console, work dashboard)

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

functions/browser/chrome_launch.md

@@ -3,23 +3,23 @@ name: chrome_launch
 kind: function
 lang: go
 domain: browser
-version: "1.0.0"
+version: "1.1.0"
 purity: impure
 signature: "func ChromeLaunch(opts ChromeLaunchOpts) (int, error)"
-description: "Lanza Google Chrome con remote debugging habilitado en el puerto indicado. Busca chrome.exe en PATH (WSL2) o en rutas conocidas de Windows. Espera hasta 15s a que el puerto CDP este listo antes de retornar. Retorna el PID del proceso."
-tags: [chrome, cdp, browser, automation, wsl2, headless]
+description: "Lanza Google Chrome con remote debugging habilitado en el puerto indicado. Busca chrome.exe en PATH (WSL2) o en rutas conocidas de Windows. En WSL2+chrome.exe, traduce UserDataDir a ruta Windows via wslpath e inyecta --remote-debugging-address=0.0.0.0 automaticamente. Espera hasta 15s a que el puerto CDP este listo antes de retornar. Retorna el PID del proceso."
+tags: [chrome, cdp, browser, automation, wsl2, headless, navegator]
 uses_functions: []
 uses_types: []
 returns: []
 returns_optional: false
 error_type: "error_go_core"
-imports: [fmt, net, os, os/exec, time]
+imports: [fmt, net, os, os/exec, regexp, strings, time]
 params:
   - name: opts
-    desc: "opciones de lanzamiento: Port, UserDataDir, Headless"
+    desc: "opciones de lanzamiento: Port (defecto 9222), UserDataDir (defecto /tmp/chrome-cdp-profile en Linux, C:\\Users\\<USER>\\AppData\\Local\\fn-chrome-cdp-profile en WSL2+exe), Headless, ChromePath, ExtraArgs"
 output: "int: PID del proceso Chrome lanzado"
 tested: true
-tests: ["TestFindChrome", "TestChromeLaunchAndConnect"]
+tests: ["TestIsWSL2", "TestTranslateUserDataDirForWindows", "TestIsWindowsExe", "TestFindChrome", "TestChromeLaunchAndConnect"]
 test_file_path: "functions/browser/chrome_launch_test.go"
 file_path: "functions/browser/chrome_launch.go"
 ---
@@ -27,10 +27,10 @@ file_path: "functions/browser/chrome_launch.go"
 ## Ejemplo
 
 ```go
+// Linux nativo (sin WSL2 o con Linux Chrome)
 pid, err := ChromeLaunch(ChromeLaunchOpts{
-    Port:        9222,
-    UserDataDir: "/tmp/chrome-cdp",
-    Headless:    true,
+    Port:     9222,
+    Headless: true,
 })
 if err != nil {
     log.Fatal(err)
@@ -38,6 +38,32 @@ if err != nil {
 defer CdpClose(nil, pid)
 ```
 
+```go
+// WSL2 → chrome.exe Windows: cero configuracion, todo automatico
+// ChromeLaunch detecta WSL2+.exe, traduce user-data-dir y bind 0.0.0.0
+pid, err := ChromeLaunch(ChromeLaunchOpts{})
+if err != nil {
+    log.Fatal(err)
+}
+// CDP listo en 127.0.0.1:9222 desde WSL2
+conn, err := CdpConnect(9222)
+```
+
+## Cuando usarla
+
+Cuando necesites lanzar Chrome con CDP desde Go para automatizacion (scraping, tests, capturas). Usar antes de `CdpConnect` / `CdpNavigate` / `CdpScreenshot`. Funciona tanto en Linux nativo como en WSL2 apuntando al chrome.exe de Windows.
+
+## Gotchas
+
+- **WSL2 + chrome.exe**: la funcion detecta automaticamente WSL2 (`/proc/version` contiene "microsoft"/"WSL") y que el ejecutable es `.exe`. En ese caso:
+  - `UserDataDir` vacio o con prefijo `/tmp/` o `/home/` se traduce via `wslpath -w` a ruta Windows. Por defecto: `C:\Users\<USER>\AppData\Local\fn-chrome-cdp-profile`.
+  - Se inyecta `--remote-debugging-address=0.0.0.0` para que Chrome sea accesible desde WSL2 vía `127.0.0.1:<port>`.
+  - `waitCDPReady` siempre espera usando `127.0.0.1` (WSL networking reenvía localhost → Windows).
+- **`wslpath` debe estar disponible**: se invoca como subproceso. Si falla, `ChromeLaunch` retorna error. `wslpath` es estándar en WSL2 desde Windows 10 1903+.
+- **Chrome no cierra solo**: el PID devuelto es el proceso Chrome. Usar `CdpClose(nil, pid)` o `os.FindProcess(pid).Kill()` para terminarlo.
+- **Puerto ocupado**: si el puerto ya está en uso por otra instancia de Chrome, `waitCDPReady` puede conectar al proceso previo. Usar puertos distintos por sesión.
+- **Headless en Windows via WSL2**: `--headless=new --disable-gpu` funciona bien con chrome.exe.
+
 ## Notas
 
 Busca Chrome en este orden:
@@ -49,3 +75,7 @@ Busca Chrome en este orden:
 Los flags aplicados desactivan funcionalidades de red y actualizacion en segundo plano para entornos de automatizacion. En modo headless se agrega `--headless=new --disable-gpu`.
 
 El struct `ChromeLaunchOpts` se define en el mismo archivo.
+
+## Capability growth log
+
+- v1.1.0 (2026-05-16) — auto-handle WSL2→Windows chrome.exe: translate user-data-dir via wslpath + inject --remote-debugging-address=0.0.0.0