diff --git a/.claude/rules/INDEX.md b/.claude/rules/INDEX.md
index cfa5009c..d845b5e2 100644
--- a/.claude/rules/INDEX.md
+++ b/.claude/rules/INDEX.md
@@ -15,3 +15,4 @@ Reglas operativas del proyecto. Cada archivo es una regla independiente.
 | 09 | [go_packages.md](go_packages.md) | Nombre de paquete Go = nombre del directorio |
 | 10 | [apps_vs_functions.md](apps_vs_functions.md) | Codigo reutilizable en functions/, no reutilizable en apps/ |
 | 11 | [sources.md](sources.md) | Extraccion de funciones desde repos externos |
+| 12 | [notebook_collaboration.md](notebook_collaboration.md) | Colaboración en notebooks Jupyter via funciones del registry |
diff --git a/.claude/rules/notebook_collaboration.md b/.claude/rules/notebook_collaboration.md
new file mode 100644
index 00000000..6a6831cf
--- /dev/null
+++ b/.claude/rules/notebook_collaboration.md
@@ -0,0 +1,55 @@
+## Colaboración en notebooks Jupyter
+
+### Requisito previo
+
+El usuario debe tener Jupyter Lab corriendo en modo colaborativo (`--collaborative`) y el notebook abierto en el browser. Sin esto, los cambios no se ven en tiempo real.
+
+El launcher estándar (`run-jupyter-lab.sh` generado por `init_jupyter_analysis`) ya incluye `--collaborative`.
+
+### Funciones del registry (dominio `notebook`)
+
+| Función | ID | Para qué |
+|---|---|---|
+| `jupyter_discover` | `jupyter_discover_py_notebook` | Descubrir instancias Jupyter activas, kernels, sesiones, modo colaborativo |
+| `jupyter_read` | `jupyter_read_py_notebook` | Leer celdas (todas o una), metadata del notebook |
+| `jupyter_exec` | `jupyter_exec_py_notebook` | Ejecutar: append+execute, execute celda existente, o directo al kernel |
+| `jupyter_write` | `jupyter_write_py_notebook` | Escribir: append code/markdown, insert, edit, delete celdas |
+| `jupyter_kernel` | `jupyter_kernel_py_notebook` | CRUD de kernels: list, start, restart, interrupt, shutdown, sessions |
+
+### Invocación desde cualquier sesión de Claude
+
+```bash
+PYTHON="python/.venv/bin/python3"
+
+# 1. Descubrir qué Jupyter está corriendo
+$PYTHON python/functions/notebook/jupyter_discover.py --json
+
+# 2. Leer notebook
+$PYTHON python/functions/notebook/jupyter_read.py notebooks/01.ipynb --json
+
+# 3. Añadir celda y ejecutar (el usuario la ve en tiempo real)
+$PYTHON python/functions/notebook/jupyter_exec.py append notebooks/01.ipynb "df.describe()"
+
+# 4. Ejecutar celda existente
+$PYTHON python/functions/notebook/jupyter_exec.py cell notebooks/01.ipynb 3
+
+# 5. Ejecutar en kernel sin tocar notebook
+$PYTHON python/functions/notebook/jupyter_exec.py kernel "print(df.shape)"
+
+# 6. Añadir markdown
+$PYTHON python/functions/notebook/jupyter_write.py append-markdown notebooks/01.ipynb "## Resumen"
+
+# 7. Gestionar kernels
+$PYTHON python/functions/notebook/jupyter_kernel.py list
+$PYTHON python/functions/notebook/jupyter_kernel.py sessions
+$PYTHON python/functions/notebook/jupyter_kernel.py shutdown <kernel_id>
+```
+
+### Reglas de uso
+
+- **SIEMPRE** ejecutar `jupyter_discover` primero para confirmar que Jupyter está activo y el notebook abierto.
+- Las funciones resuelven automáticamente el `kernel_id` de la sesión del notebook y el `username` colaborativo via `/api/sessions` y `/api/me`.
+- Después de escribir/ejecutar, las funciones mantienen la conexión WebSocket 2 segundos para que Y.js propague los cambios al browser.
+- **NO usar MCP jupyter** — estas funciones reemplazan al MCP y funcionan desde cualquier directorio sin registrar nada.
+- El token por defecto es vacío (sin auth). Si el server tiene token, pasarlo con `--token`.
+- Los paths de notebooks son relativos a la raíz del servidor Jupyter (normalmente `analysis/{tema}/`).
diff --git a/bash/functions/infra/install_nordvpn.md b/bash/functions/infra/install_nordvpn.md
new file mode 100644
index 00000000..66aa70fc
--- /dev/null
+++ b/bash/functions/infra/install_nordvpn.md
@@ -0,0 +1,37 @@
+---
+name: install_nordvpn
+kind: function
+lang: bash
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "install_nordvpn() -> void"
+description: "Instala NordVPN CLI en Ubuntu/Debian (incluido WSL2). Configura repositorio oficial, instala paquete y habilita servicio nordvpnd. Idempotente."
+tags: [vpn, nordvpn, install, infra, wsl2]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: []
+tested: false
+tests: []
+test_file_path: ""
+file_path: "bash/functions/infra/install_nordvpn.sh"
+---
+
+## Ejemplo
+
+```bash
+source install_nordvpn.sh
+install_nordvpn
+# nordvpn ya instalado: NordVPN Version 3.x.x
+# — o —
+# Instalando NordVPN CLI...
+# NordVPN instalado: NordVPN Version 3.x.x
+# NOTA: ejecuta 'nordvpn login' para autenticarte
+```
+
+## Notas
+
+Usa el script de instalacion oficial de NordVPN. En WSL2 sin systemd, levanta nordvpnd manualmente. Agrega el usuario al grupo nordvpn para evitar sudo en comandos posteriores. Despues de instalar, se requiere `nordvpn login` para autenticarse.
diff --git a/bash/functions/infra/install_nordvpn.sh b/bash/functions/infra/install_nordvpn.sh
new file mode 100644
index 00000000..ed832e2c
--- /dev/null
+++ b/bash/functions/infra/install_nordvpn.sh
@@ -0,0 +1,41 @@
+# install_nordvpn
+# ---------------
+# Instala NordVPN CLI en Ubuntu/Debian (incluido WSL2).
+# Configura el repositorio oficial, instala el paquete y habilita el servicio.
+# Si ya esta instalado, no hace nada.
+#
+# USO (sourced):
+#   source install_nordvpn.sh
+#   install_nordvpn
+
+install_nordvpn() {
+    if command -v nordvpn &>/dev/null; then
+        echo "nordvpn ya instalado: $(nordvpn version 2>/dev/null)"
+        return 0
+    fi
+
+    echo "Instalando NordVPN CLI..."
+
+    # Descargar e instalar via script oficial
+    sh <(curl -sSf https://downloads.nordcdn.com/apps/linux/install.sh) 2>&1
+
+    if ! command -v nordvpn &>/dev/null; then
+        echo "install_nordvpn: fallo la instalacion" >&2
+        return 1
+    fi
+
+    # Agregar usuario al grupo nordvpn para evitar sudo
+    sudo usermod -aG nordvpn "$USER" 2>/dev/null || true
+
+    # Habilitar servicio (systemd o manual para WSL2)
+    if command -v systemctl &>/dev/null && systemctl is-system-running &>/dev/null 2>&1; then
+        sudo systemctl enable --now nordvpnd 2>/dev/null || true
+    else
+        # WSL2 sin systemd — levantar daemon manualmente
+        sudo nordvpnd &>/dev/null &
+        sleep 2
+    fi
+
+    echo "NordVPN instalado: $(nordvpn version 2>/dev/null)"
+    echo "NOTA: ejecuta 'nordvpn login' para autenticarte"
+}
diff --git a/bash/functions/infra/nordvpn_connect.md b/bash/functions/infra/nordvpn_connect.md
new file mode 100644
index 00000000..19d0c0c9
--- /dev/null
+++ b/bash/functions/infra/nordvpn_connect.md
@@ -0,0 +1,40 @@
+---
+name: nordvpn_connect
+kind: function
+lang: bash
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "nordvpn_connect(country?: string, city?: string) -> json"
+description: "Conecta a NordVPN por pais, ciudad o servidor especifico. Sin argumentos conecta al mejor servidor disponible. Devuelve JSON con resultado."
+tags: [vpn, nordvpn, connect, infra, network]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: []
+tested: false
+tests: []
+test_file_path: ""
+file_path: "bash/functions/infra/nordvpn_connect.sh"
+---
+
+## Ejemplo
+
+```bash
+source nordvpn_connect.sh
+
+nordvpn_connect
+# {"ok":true,"server":"us1234.nordvpn.com","country":"auto","city":"auto"}
+
+nordvpn_connect Spain
+# {"ok":true,"server":"es42.nordvpn.com","country":"Spain","city":"auto"}
+
+nordvpn_connect Spain Madrid
+# {"ok":true,"server":"es15.nordvpn.com","country":"Spain","city":"Madrid"}
+```
+
+## Notas
+
+Requiere NordVPN CLI instalado y autenticado (`nordvpn login`). La salida JSON facilita composicion con otros scripts y pipelines. Si ya hay una conexion activa, NordVPN reconecta automaticamente al nuevo destino.
diff --git a/bash/functions/infra/nordvpn_connect.sh b/bash/functions/infra/nordvpn_connect.sh
new file mode 100644
index 00000000..24b685e2
--- /dev/null
+++ b/bash/functions/infra/nordvpn_connect.sh
@@ -0,0 +1,39 @@
+# nordvpn_connect
+# ---------------
+# Conecta a NordVPN. Acepta pais, ciudad o servidor especifico.
+# Sin argumentos conecta al mejor servidor disponible.
+# Imprime JSON con el resultado de la conexion.
+#
+# USO (sourced):
+#   source nordvpn_connect.sh
+#   nordvpn_connect                    # mejor servidor
+#   nordvpn_connect Spain              # por pais
+#   nordvpn_connect Spain Madrid       # por ciudad
+#   nordvpn_connect Spain '#42'        # servidor especifico
+
+nordvpn_connect() {
+    local country="${1:-}"
+    local city="${2:-}"
+
+    if ! command -v nordvpn &>/dev/null; then
+        echo '{"ok":false,"error":"nordvpn no instalado"}' >&2
+        return 1
+    fi
+
+    local args=()
+    [ -n "$country" ] && args+=("$country")
+    [ -n "$city" ] && args+=("$city")
+
+    local output
+    output=$(nordvpn connect "${args[@]}" 2>&1)
+    local rc=$?
+
+    if [ $rc -eq 0 ] && echo "$output" | grep -qi "connected"; then
+        local server
+        server=$(echo "$output" | grep -oP '(?<=to )\S+' | head -1)
+        echo "{\"ok\":true,\"server\":\"${server}\",\"country\":\"${country:-auto}\",\"city\":\"${city:-auto}\"}"
+    else
+        echo "{\"ok\":false,\"error\":$(echo "$output" | python3 -c 'import sys,json; print(json.dumps(sys.stdin.read().strip()))' 2>/dev/null || echo "\"$output\"")}"
+        return 1
+    fi
+}
diff --git a/bash/functions/infra/nordvpn_disconnect.md b/bash/functions/infra/nordvpn_disconnect.md
new file mode 100644
index 00000000..9b01d6c6
--- /dev/null
+++ b/bash/functions/infra/nordvpn_disconnect.md
@@ -0,0 +1,34 @@
+---
+name: nordvpn_disconnect
+kind: function
+lang: bash
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "nordvpn_disconnect() -> json"
+description: "Desconecta de NordVPN. Idempotente — si no hay conexion activa retorna ok. Devuelve JSON con resultado."
+tags: [vpn, nordvpn, disconnect, infra, network]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: []
+tested: false
+tests: []
+test_file_path: ""
+file_path: "bash/functions/infra/nordvpn_disconnect.sh"
+---
+
+## Ejemplo
+
+```bash
+source nordvpn_disconnect.sh
+
+nordvpn_disconnect
+# {"ok":true,"status":"disconnected"}
+```
+
+## Notas
+
+Idempotente: si no hay conexion activa, retorna ok sin error. Requiere NordVPN CLI instalado.
diff --git a/bash/functions/infra/nordvpn_disconnect.sh b/bash/functions/infra/nordvpn_disconnect.sh
new file mode 100644
index 00000000..c5cd6f85
--- /dev/null
+++ b/bash/functions/infra/nordvpn_disconnect.sh
@@ -0,0 +1,26 @@
+# nordvpn_disconnect
+# ------------------
+# Desconecta de NordVPN. Idempotente — si no hay conexion activa, retorna ok.
+# Imprime JSON con el resultado.
+#
+# USO (sourced):
+#   source nordvpn_disconnect.sh
+#   nordvpn_disconnect
+
+nordvpn_disconnect() {
+    if ! command -v nordvpn &>/dev/null; then
+        echo '{"ok":false,"error":"nordvpn no instalado"}' >&2
+        return 1
+    fi
+
+    local output
+    output=$(nordvpn disconnect 2>&1)
+    local rc=$?
+
+    if [ $rc -eq 0 ] || echo "$output" | grep -qi "not connected\|disconnected"; then
+        echo '{"ok":true,"status":"disconnected"}'
+    else
+        echo "{\"ok\":false,\"error\":$(echo "$output" | python3 -c 'import sys,json; print(json.dumps(sys.stdin.read().strip()))' 2>/dev/null || echo "\"$output\"")}"
+        return 1
+    fi
+}
diff --git a/bash/functions/infra/nordvpn_get_ip.md b/bash/functions/infra/nordvpn_get_ip.md
new file mode 100644
index 00000000..58c06f73
--- /dev/null
+++ b/bash/functions/infra/nordvpn_get_ip.md
@@ -0,0 +1,39 @@
+---
+name: nordvpn_get_ip
+kind: function
+lang: bash
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "nordvpn_get_ip() -> json"
+description: "Obtiene IP publica actual con fallback entre multiples servicios. Indica si la conexion VPN esta activa y el servidor usado."
+tags: [vpn, nordvpn, ip, infra, network, verification]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: []
+tested: false
+tests: []
+test_file_path: ""
+file_path: "bash/functions/infra/nordvpn_get_ip.sh"
+---
+
+## Ejemplo
+
+```bash
+source nordvpn_get_ip.sh
+
+# Con VPN activa:
+nordvpn_get_ip
+# {"ok":true,"ip":"185.x.x.x","vpn_connected":true,"vpn_server":"es42.nordvpn.com","source":"https://api.ipify.org"}
+
+# Sin VPN:
+nordvpn_get_ip
+# {"ok":true,"ip":"88.x.x.x","vpn_connected":false,"vpn_server":"","source":"https://api.ipify.org"}
+```
+
+## Notas
+
+Usa ipify.org como servicio primario con fallback a ifconfig.me e icanhazip.com. Timeout de 5 segundos por servicio. Util para verificar que el tunel VPN esta activo antes de ejecutar operaciones sensibles a la IP.
diff --git a/bash/functions/infra/nordvpn_get_ip.sh b/bash/functions/infra/nordvpn_get_ip.sh
new file mode 100644
index 00000000..70ae1c75
--- /dev/null
+++ b/bash/functions/infra/nordvpn_get_ip.sh
@@ -0,0 +1,42 @@
+# nordvpn_get_ip
+# --------------
+# Obtiene la IP publica actual para verificar que el tunel VPN funciona.
+# Usa multiples servicios como fallback.
+#
+# USO (sourced):
+#   source nordvpn_get_ip.sh
+#   nordvpn_get_ip
+
+nordvpn_get_ip() {
+    local ip=""
+    local source=""
+
+    # Intentar multiples servicios
+    for svc in "https://api.ipify.org" "https://ifconfig.me" "https://icanhazip.com"; do
+        ip=$(curl -s --max-time 5 "$svc" 2>/dev/null)
+        if echo "$ip" | grep -qP '^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$'; then
+            source="$svc"
+            break
+        fi
+        ip=""
+    done
+
+    if [ -z "$ip" ]; then
+        echo '{"ok":false,"error":"no se pudo obtener IP publica"}' >&2
+        return 1
+    fi
+
+    # Si nordvpn esta disponible, incluir info de conexion
+    local connected="false"
+    local vpn_server=""
+    if command -v nordvpn &>/dev/null; then
+        local status_output
+        status_output=$(nordvpn status 2>/dev/null)
+        if echo "$status_output" | grep -qi "connected"; then
+            connected="true"
+            vpn_server=$(echo "$status_output" | grep -iP "hostname|server" | head -1 | sed 's/.*: *//')
+        fi
+    fi
+
+    echo "{\"ok\":true,\"ip\":\"$ip\",\"vpn_connected\":$connected,\"vpn_server\":\"$vpn_server\",\"source\":\"$source\"}"
+}
diff --git a/bash/functions/infra/nordvpn_list_cities.md b/bash/functions/infra/nordvpn_list_cities.md
new file mode 100644
index 00000000..21c5bc58
--- /dev/null
+++ b/bash/functions/infra/nordvpn_list_cities.md
@@ -0,0 +1,37 @@
+---
+name: nordvpn_list_cities
+kind: function
+lang: bash
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "nordvpn_list_cities(country: string) -> json"
+description: "Lista ciudades disponibles de un pais en NordVPN como array JSON ordenado."
+tags: [vpn, nordvpn, cities, infra, network]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: []
+tested: false
+tests: []
+test_file_path: ""
+file_path: "bash/functions/infra/nordvpn_list_cities.sh"
+---
+
+## Ejemplo
+
+```bash
+source nordvpn_list_cities.sh
+
+nordvpn_list_cities Spain
+# {"ok":true,"country":"Spain","count":2,"cities":["Barcelona","Madrid"]}
+
+nordvpn_list_cities "United_States"
+# {"ok":true,"country":"United_States","count":15,"cities":["Atlanta","Buffalo",...]}
+```
+
+## Notas
+
+El nombre de pais debe coincidir con lo que devuelve `nordvpn countries`. Usa underscores para paises compuestos (ej: United_States). Las ciudades se devuelven con espacios.
diff --git a/bash/functions/infra/nordvpn_list_cities.sh b/bash/functions/infra/nordvpn_list_cities.sh
new file mode 100644
index 00000000..d5380974
--- /dev/null
+++ b/bash/functions/infra/nordvpn_list_cities.sh
@@ -0,0 +1,38 @@
+# nordvpn_list_cities
+# -------------------
+# Lista las ciudades disponibles de un pais en NordVPN como array JSON.
+#
+# USO (sourced):
+#   source nordvpn_list_cities.sh
+#   nordvpn_list_cities Spain
+
+nordvpn_list_cities() {
+    local country="${1:?nordvpn_list_cities: se requiere pais como argumento}"
+
+    if ! command -v nordvpn &>/dev/null; then
+        echo '{"ok":false,"error":"nordvpn no instalado"}' >&2
+        return 1
+    fi
+
+    local output
+    output=$(nordvpn cities "$country" 2>&1)
+    local rc=$?
+
+    if [ $rc -ne 0 ]; then
+        echo "{\"ok\":false,\"error\":$(echo "$output" | python3 -c 'import sys,json; print(json.dumps(sys.stdin.read().strip()))' 2>/dev/null || echo "\"$output\"")}"
+        return 1
+    fi
+
+    echo "$output" | python3 -c '
+import sys, json, re
+
+country = "'"$country"'"
+text = sys.stdin.read()
+text = re.sub(r"\x1b\[[0-9;]*m", "", text)
+text = re.sub(r"[\t\r]", " ", text)
+cities = [c.strip().replace("_", " ") for c in re.split(r"[,\n]+", text) if c.strip() and c.strip() != "-"]
+cities = [c for c in cities if len(c) > 1]
+cities.sort()
+print(json.dumps({"ok": True, "country": country, "count": len(cities), "cities": cities}))
+'
+}
diff --git a/bash/functions/infra/nordvpn_list_countries.md b/bash/functions/infra/nordvpn_list_countries.md
new file mode 100644
index 00000000..e7f38b27
--- /dev/null
+++ b/bash/functions/infra/nordvpn_list_countries.md
@@ -0,0 +1,34 @@
+---
+name: nordvpn_list_countries
+kind: function
+lang: bash
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "nordvpn_list_countries() -> json"
+description: "Lista paises disponibles en NordVPN como array JSON ordenado alfabeticamente."
+tags: [vpn, nordvpn, countries, infra, network]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: []
+tested: false
+tests: []
+test_file_path: ""
+file_path: "bash/functions/infra/nordvpn_list_countries.sh"
+---
+
+## Ejemplo
+
+```bash
+source nordvpn_list_countries.sh
+
+nordvpn_list_countries
+# {"ok":true,"count":60,"countries":["Albania","Argentina","Australia",...,"United States","Vietnam"]}
+```
+
+## Notas
+
+Parsea la salida de `nordvpn countries` eliminando codigos ANSI y normalizando separadores. Los nombres de paises se devuelven con espacios en vez de underscores.
diff --git a/bash/functions/infra/nordvpn_list_countries.sh b/bash/functions/infra/nordvpn_list_countries.sh
new file mode 100644
index 00000000..f05c5d7d
--- /dev/null
+++ b/bash/functions/infra/nordvpn_list_countries.sh
@@ -0,0 +1,36 @@
+# nordvpn_list_countries
+# ----------------------
+# Lista los paises disponibles en NordVPN como array JSON.
+#
+# USO (sourced):
+#   source nordvpn_list_countries.sh
+#   nordvpn_list_countries
+
+nordvpn_list_countries() {
+    if ! command -v nordvpn &>/dev/null; then
+        echo '{"ok":false,"error":"nordvpn no instalado"}' >&2
+        return 1
+    fi
+
+    local output
+    output=$(nordvpn countries 2>&1)
+    local rc=$?
+
+    if [ $rc -ne 0 ]; then
+        echo "{\"ok\":false,\"error\":$(echo "$output" | python3 -c 'import sys,json; print(json.dumps(sys.stdin.read().strip()))' 2>/dev/null || echo "\"$output\"")}"
+        return 1
+    fi
+
+    echo "$output" | python3 -c '
+import sys, json, re
+
+text = sys.stdin.read()
+text = re.sub(r"\x1b\[[0-9;]*m", "", text)
+text = re.sub(r"[\t\r]", " ", text)
+# Split by comma, whitespace, or newline and clean
+countries = [c.strip().replace("_", " ") for c in re.split(r"[,\n]+", text) if c.strip() and c.strip() != "-"]
+countries = [c for c in countries if len(c) > 1]
+countries.sort()
+print(json.dumps({"ok": True, "count": len(countries), "countries": countries}))
+'
+}
diff --git a/bash/functions/infra/nordvpn_set_protocol.md b/bash/functions/infra/nordvpn_set_protocol.md
new file mode 100644
index 00000000..952093da
--- /dev/null
+++ b/bash/functions/infra/nordvpn_set_protocol.md
@@ -0,0 +1,37 @@
+---
+name: nordvpn_set_protocol
+kind: function
+lang: bash
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "nordvpn_set_protocol(protocol: string) -> json"
+description: "Cambia el protocolo de NordVPN entre NordLynx (WireGuard) y OpenVPN. NordLynx recomendado por velocidad."
+tags: [vpn, nordvpn, protocol, nordlynx, wireguard, openvpn, infra]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: []
+tested: false
+tests: []
+test_file_path: ""
+file_path: "bash/functions/infra/nordvpn_set_protocol.sh"
+---
+
+## Ejemplo
+
+```bash
+source nordvpn_set_protocol.sh
+
+nordvpn_set_protocol NordLynx
+# {"ok":true,"protocol":"NordLynx"}
+
+nordvpn_set_protocol OpenVPN
+# {"ok":true,"protocol":"OpenVPN"}
+```
+
+## Notas
+
+NordLynx es WireGuard wrapeado por NordVPN — mas rapido y moderno. OpenVPN es mas compatible con redes restrictivas. El cambio de protocolo requiere reconectar si hay una conexion activa.
diff --git a/bash/functions/infra/nordvpn_set_protocol.sh b/bash/functions/infra/nordvpn_set_protocol.sh
new file mode 100644
index 00000000..8634064b
--- /dev/null
+++ b/bash/functions/infra/nordvpn_set_protocol.sh
@@ -0,0 +1,38 @@
+# nordvpn_set_protocol
+# --------------------
+# Cambia el protocolo de NordVPN (NordLynx o OpenVPN).
+# NordLynx = WireGuard (recomendado por velocidad).
+#
+# USO (sourced):
+#   source nordvpn_set_protocol.sh
+#   nordvpn_set_protocol NordLynx
+#   nordvpn_set_protocol OpenVPN
+
+nordvpn_set_protocol() {
+    local protocol="${1:?nordvpn_set_protocol: se requiere protocolo (NordLynx|OpenVPN)}"
+
+    if ! command -v nordvpn &>/dev/null; then
+        echo '{"ok":false,"error":"nordvpn no instalado"}' >&2
+        return 1
+    fi
+
+    case "$protocol" in
+        NordLynx|nordlynx|NORDLYNX) protocol="NordLynx" ;;
+        OpenVPN|openvpn|OPENVPN)     protocol="OpenVPN" ;;
+        *)
+            echo "{\"ok\":false,\"error\":\"protocolo invalido: $protocol (usar NordLynx o OpenVPN)\"}"
+            return 1
+            ;;
+    esac
+
+    local output
+    output=$(nordvpn set protocol "$protocol" 2>&1)
+    local rc=$?
+
+    if [ $rc -eq 0 ] || echo "$output" | grep -qi "already set\|successfully"; then
+        echo "{\"ok\":true,\"protocol\":\"$protocol\"}"
+    else
+        echo "{\"ok\":false,\"error\":$(echo "$output" | python3 -c 'import sys,json; print(json.dumps(sys.stdin.read().strip()))' 2>/dev/null || echo "\"$output\"")}"
+        return 1
+    fi
+}
diff --git a/bash/functions/infra/nordvpn_status.md b/bash/functions/infra/nordvpn_status.md
new file mode 100644
index 00000000..b197ef62
--- /dev/null
+++ b/bash/functions/infra/nordvpn_status.md
@@ -0,0 +1,37 @@
+---
+name: nordvpn_status
+kind: function
+lang: bash
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "nordvpn_status() -> json"
+description: "Obtiene estado actual de NordVPN como JSON estructurado. Incluye servidor, IP, pais, protocolo y estado de conexion."
+tags: [vpn, nordvpn, status, infra, network]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: []
+tested: false
+tests: []
+test_file_path: ""
+file_path: "bash/functions/infra/nordvpn_status.sh"
+---
+
+## Ejemplo
+
+```bash
+source nordvpn_status.sh
+
+nordvpn_status
+# {"ok":true,"connected":true,"status":"Connected","hostname":"es42.nordvpn.com","ip":"185.x.x.x","country":"Spain","city":"Madrid","current_technology":"NordLynx","current_protocol":"nordlynx","transfer":"1.2 MiB received, 500 KiB sent","uptime":"5 minutes 32 seconds"}
+
+# Desconectado:
+# {"ok":true,"connected":false,"status":"Disconnected"}
+```
+
+## Notas
+
+Parsea la salida clave-valor de `nordvpn status` eliminando codigos ANSI. Los campos disponibles dependen del estado de conexion — cuando esta desconectado solo devuelve status y connected.
diff --git a/bash/functions/infra/nordvpn_status.sh b/bash/functions/infra/nordvpn_status.sh
new file mode 100644
index 00000000..c7cdc1b0
--- /dev/null
+++ b/bash/functions/infra/nordvpn_status.sh
@@ -0,0 +1,43 @@
+# nordvpn_status
+# --------------
+# Obtiene el estado actual de NordVPN como JSON estructurado.
+# Parsea la salida clave-valor de `nordvpn status` a campos JSON.
+#
+# USO (sourced):
+#   source nordvpn_status.sh
+#   nordvpn_status
+
+nordvpn_status() {
+    if ! command -v nordvpn &>/dev/null; then
+        echo '{"ok":false,"error":"nordvpn no instalado"}' >&2
+        return 1
+    fi
+
+    local output
+    output=$(nordvpn status 2>&1)
+    local rc=$?
+
+    if [ $rc -ne 0 ]; then
+        echo "{\"ok\":false,\"error\":$(echo "$output" | python3 -c 'import sys,json; print(json.dumps(sys.stdin.read().strip()))' 2>/dev/null || echo "\"$output\"")}"
+        return 1
+    fi
+
+    # Parsear output clave: valor a JSON con python3
+    echo "$output" | python3 -c '
+import sys, json, re
+
+lines = sys.stdin.read().strip().split("\n")
+data = {"ok": True}
+for line in lines:
+    line = re.sub(r"\x1b\[[0-9;]*m", "", line).strip()
+    line = line.lstrip("- ")
+    if ":" in line:
+        key, _, val = line.partition(":")
+        key = key.strip().lower().replace(" ", "_")
+        val = val.strip()
+        if key == "status":
+            data["connected"] = val.lower() == "connected"
+        data[key] = val
+print(json.dumps(data))
+'
+}
diff --git a/bash/functions/infra/write_jupyter_launcher.sh b/bash/functions/infra/write_jupyter_launcher.sh
index 7884d317..afcb0aef 100644
--- a/bash/functions/infra/write_jupyter_launcher.sh
+++ b/bash/functions/infra/write_jupyter_launcher.sh
@@ -56,7 +56,6 @@ jupyter lab \
     --ServerApp.disable_check_xsrf=True \
     --ServerApp.allow_origin='*' \
     --ServerApp.root_dir="$(pwd)" \
-    --YDocExtension.ystore_class='ypy_websocket.ystore.TempFileYStore' \
     --collaborative
 LAUNCHER
 
diff --git a/bash/functions/infra/write_mcp_jupyter_config.sh b/bash/functions/infra/write_mcp_jupyter_config.sh
index 470e327f..4a3dd2a2 100644
--- a/bash/functions/infra/write_mcp_jupyter_config.sh
+++ b/bash/functions/infra/write_mcp_jupyter_config.sh
@@ -1,7 +1,8 @@
 # write_mcp_jupyter_config
 # -------------------------
 # Genera o actualiza .mcp.json con la configuracion de jupyter-mcp-server.
-# Usa el python del venv local con -m jupyter_mcp_server.
+# Usa el python del venv local con -m jupyter_mcp_server.server.
+# Configura via env vars (SERVER_URL, TOKEN) — no CLI args.
 # Hace merge si ya existe .mcp.json (requiere jq).
 #
 # USO (sourced):
@@ -33,11 +34,11 @@ write_mcp_jupyter_config() {
   "mcpServers": {
     "jupyter": {
       "command": "${python_bin}",
-      "args": [
-        "-m", "jupyter_mcp_server",
-        "--runtime-url", "http://localhost:${port}",
-        "--start-new-runtime", "false"
-      ]
+      "args": ["-m", "jupyter_mcp_server.server"],
+      "env": {
+        "SERVER_URL": "http://localhost:${port}",
+        "TOKEN": ""
+      }
     }
   }
 }
diff --git a/frontend/functions/core/chart_colors.md b/frontend/functions/core/chart_colors.md
new file mode 100644
index 00000000..8bb9bd2a
--- /dev/null
+++ b/frontend/functions/core/chart_colors.md
@@ -0,0 +1,35 @@
+---
+name: chart_colors
+kind: function
+lang: typescript
+domain: core
+version: "1.0.0"
+purity: pure
+signature: "getChartColor(index: number): string"
+description: "Paleta de colores para gráficos basada en CSS variables del tema activo. Colores accesibles por índice cíclico."
+tags: [chart, color, theme, palette, visualization]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: []
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/core/chart_colors.ts"
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/charts/chart-base.tsx"
+---
+
+## Ejemplo
+
+```typescript
+getChartColor(0) // 'hsl(var(--chart-1, 220 70% 50%))'
+getChartColor(7) // 'hsl(var(--chart-3, 30 80% 55%))' — cicla sobre 5 colores
+```
+
+## Notas
+
+Usa CSS variables del tema con fallback hardcodeado. Los colores cambian automáticamente con el tema activo. También exporta `chartColors` (array) para uso directo.
diff --git a/frontend/functions/core/chart_colors.ts b/frontend/functions/core/chart_colors.ts
new file mode 100644
index 00000000..fc55e8cf
--- /dev/null
+++ b/frontend/functions/core/chart_colors.ts
@@ -0,0 +1,11 @@
+export const chartColors = [
+  'hsl(var(--chart-1, 220 70% 50%))',
+  'hsl(var(--chart-2, 160 60% 45%))',
+  'hsl(var(--chart-3, 30 80% 55%))',
+  'hsl(var(--chart-4, 280 65% 60%))',
+  'hsl(var(--chart-5, 340 75% 55%))',
+]
+
+export function getChartColor(index: number): string {
+  return chartColors[index % chartColors.length]
+}
diff --git a/frontend/functions/core/cn.md b/frontend/functions/core/cn.md
new file mode 100644
index 00000000..288ae534
--- /dev/null
+++ b/frontend/functions/core/cn.md
@@ -0,0 +1,36 @@
+---
+name: cn
+kind: function
+lang: typescript
+domain: core
+version: "1.0.0"
+purity: pure
+signature: "cn(...inputs: ClassValue[]): string"
+description: "Combina clases CSS con clsx y resuelve conflictos Tailwind con tailwind-merge. Utilidad fundamental para composición de estilos."
+tags: [css, tailwind, classname, merge, utility]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [clsx, tailwind-merge]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/core/cn.ts"
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/lib/utils.ts"
+---
+
+## Ejemplo
+
+```typescript
+cn("px-4 py-2", "px-6")              // "px-6 py-2" (tailwind-merge resuelve conflicto)
+cn("text-red-500", false && "hidden") // "text-red-500" (clsx filtra falsy)
+cn("rounded-lg", className)           // composición con className externo
+```
+
+## Notas
+
+Base de todo el sistema de estilos. Todos los componentes la usan para componer className.
diff --git a/frontend/functions/core/cn.ts b/frontend/functions/core/cn.ts
new file mode 100644
index 00000000..e3155433
--- /dev/null
+++ b/frontend/functions/core/cn.ts
@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx"
+import { twMerge } from "tailwind-merge"
+
+export function cn(...inputs: ClassValue[]): string {
+  return twMerge(clsx(inputs))
+}
diff --git a/frontend/functions/core/format_compact.md b/frontend/functions/core/format_compact.md
new file mode 100644
index 00000000..6542fa5b
--- /dev/null
+++ b/frontend/functions/core/format_compact.md
@@ -0,0 +1,36 @@
+---
+name: format_compact
+kind: function
+lang: typescript
+domain: core
+version: "1.0.0"
+purity: pure
+signature: "formatCompact(n: number, decimals?: number): string"
+description: "Familia de funciones de formato compacto: números (K/M/B), frecuencia (Hz/KHz/MHz), bytes (KB/MB/GB), duración (ms/s/min/h)."
+tags: [format, number, compact, utility, display]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: []
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/core/format_compact.ts"
+---
+
+## Ejemplo
+
+```typescript
+formatCompact(1234)       // '1.2K'
+formatCompact(1500000)    // '1.5M'
+formatHz(44100)           // '44.1 KHz'
+formatBytes(1073741824)   // '1.0 GB'
+formatDuration(3500)      // '3.5s'
+formatDuration(0.5)       // '500µs'
+```
+
+## Notas
+
+Todas son funciones puras sin dependencias. Útiles en dashboards, KPI cards, tablas y tooltips.
diff --git a/frontend/functions/core/format_compact.ts b/frontend/functions/core/format_compact.ts
new file mode 100644
index 00000000..ff7e4b9b
--- /dev/null
+++ b/frontend/functions/core/format_compact.ts
@@ -0,0 +1,42 @@
+/**
+ * Formatea un número en formato compacto (1K, 1.2M, etc.)
+ * Soporta sufijos personalizados.
+ */
+export function formatCompact(n: number, decimals: number = 1): string {
+  if (Math.abs(n) >= 1_000_000_000) return (n / 1_000_000_000).toFixed(decimals) + 'B'
+  if (Math.abs(n) >= 1_000_000) return (n / 1_000_000).toFixed(decimals) + 'M'
+  if (Math.abs(n) >= 1_000) return (n / 1_000).toFixed(decimals) + 'K'
+  return n.toString()
+}
+
+/**
+ * Formatea frecuencia en Hz/KHz/MHz/GHz.
+ */
+export function formatHz(hz: number, decimals: number = 1): string {
+  if (hz >= 1_000_000_000) return (hz / 1_000_000_000).toFixed(decimals) + ' GHz'
+  if (hz >= 1_000_000) return (hz / 1_000_000).toFixed(decimals) + ' MHz'
+  if (hz >= 1_000) return (hz / 1_000).toFixed(decimals) + ' KHz'
+  return hz + ' Hz'
+}
+
+/**
+ * Formatea bytes en KB/MB/GB/TB.
+ */
+export function formatBytes(bytes: number, decimals: number = 1): string {
+  if (bytes >= 1_099_511_627_776) return (bytes / 1_099_511_627_776).toFixed(decimals) + ' TB'
+  if (bytes >= 1_073_741_824) return (bytes / 1_073_741_824).toFixed(decimals) + ' GB'
+  if (bytes >= 1_048_576) return (bytes / 1_048_576).toFixed(decimals) + ' MB'
+  if (bytes >= 1_024) return (bytes / 1_024).toFixed(decimals) + ' KB'
+  return bytes + ' B'
+}
+
+/**
+ * Formatea duración en ms/s/min/h.
+ */
+export function formatDuration(ms: number): string {
+  if (ms >= 3_600_000) return (ms / 3_600_000).toFixed(1) + 'h'
+  if (ms >= 60_000) return (ms / 60_000).toFixed(1) + 'min'
+  if (ms >= 1_000) return (ms / 1_000).toFixed(1) + 's'
+  if (ms >= 1) return ms.toFixed(0) + 'ms'
+  return (ms * 1000).toFixed(0) + 'µs'
+}
diff --git a/frontend/functions/core/get_series_color.md b/frontend/functions/core/get_series_color.md
new file mode 100644
index 00000000..6bb5aa95
--- /dev/null
+++ b/frontend/functions/core/get_series_color.md
@@ -0,0 +1,36 @@
+---
+name: get_series_color
+kind: function
+lang: typescript
+domain: core
+version: "1.0.0"
+purity: pure
+signature: "getSeriesColor(index: number, color?: string): string"
+description: "Devuelve color para una serie de gráfico por índice cíclico, o el color explícito si se proporciona."
+tags: [chart, color, series, visualization]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: []
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/core/get_series_color.ts"
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/charts/chart-base.tsx"
+---
+
+## Ejemplo
+
+```typescript
+getSeriesColor(0)            // '#3b82f6'
+getSeriesColor(5)            // '#3b82f6' (cicla sobre 5 colores)
+getSeriesColor(0, '#ff0000') // '#ff0000' (usa el explícito)
+```
+
+## Notas
+
+Paleta fija de 5 colores: azul, verde, ámbar, violeta, rosa. También exporta `defaultColors` para uso directo.
diff --git a/frontend/functions/core/get_series_color.ts b/frontend/functions/core/get_series_color.ts
new file mode 100644
index 00000000..0c89b11a
--- /dev/null
+++ b/frontend/functions/core/get_series_color.ts
@@ -0,0 +1,7 @@
+const defaultColors = ['#3b82f6', '#22c55e', '#f59e0b', '#8b5cf6', '#ec4899']
+
+export function getSeriesColor(index: number, color?: string): string {
+  return color || defaultColors[index % defaultColors.length]
+}
+
+export { defaultColors }
diff --git a/frontend/functions/core/theme_config_to_colors.md b/frontend/functions/core/theme_config_to_colors.md
new file mode 100644
index 00000000..b3a7dab0
--- /dev/null
+++ b/frontend/functions/core/theme_config_to_colors.md
@@ -0,0 +1,37 @@
+---
+name: theme_config_to_colors
+kind: function
+lang: typescript
+domain: core
+version: "1.0.0"
+purity: pure
+signature: "themeConfigToColors(config: ThemeConfig): ThemeColors"
+description: "Convierte un ThemeConfig completo a ThemeColors plano para inyectar como CSS variables. Mapea tokens semánticos a variables CSS."
+tags: [theme, colors, css-variables, conversion]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: []
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/core/theme_config_to_colors.ts"
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/themes/types.ts"
+---
+
+## Ejemplo
+
+```typescript
+const colors = themeConfigToColors(darkThemeConfig)
+// { background: '...', foreground: '...', primary: '...', ... }
+```
+
+## Notas
+
+Puente entre el sistema de temas estructurado (ThemeConfig) y el sistema plano de CSS variables que consumen los componentes.
+
+Depende de los tipos ThemeConfig y ThemeColors definidos en `frontend/types/ui/theme_config.ts`. El tipo aún no está indexado en la BD (pendiente añadir theme_config.md para que fn index lo registre).
diff --git a/frontend/functions/core/theme_config_to_colors.ts b/frontend/functions/core/theme_config_to_colors.ts
new file mode 100644
index 00000000..884155db
--- /dev/null
+++ b/frontend/functions/core/theme_config_to_colors.ts
@@ -0,0 +1,49 @@
+import type { ThemeConfig, ThemeColors } from "../../types/ui/theme_config"
+
+export function themeConfigToColors(config: ThemeConfig): ThemeColors {
+  const { colors } = config
+
+  return {
+    background: colors.background.default,
+    foreground: colors.foreground.default,
+    card: colors.surface.raised,
+    cardForeground: colors.foreground.default,
+    popover: colors.surface.overlay,
+    popoverForeground: colors.foreground.default,
+    primary: colors.brand.primary,
+    primaryForeground: colors.brand.primaryForeground,
+    secondary: colors.brand.secondary,
+    secondaryForeground: colors.brand.secondaryForeground,
+    muted: colors.background.muted,
+    mutedForeground: colors.foreground.muted,
+    accent: colors.brand.accent,
+    accentForeground: colors.brand.accentForeground,
+    destructive: colors.status.error,
+    destructiveForeground: colors.status.errorForeground,
+    success: colors.status.success,
+    successForeground: colors.status.successForeground,
+    warning: colors.status.warning,
+    warningForeground: colors.status.warningForeground,
+    info: colors.status.info,
+    infoForeground: colors.status.infoForeground,
+    surface: colors.surface.raised,
+    surfaceHover: colors.background.subtle,
+    overlay: colors.surface.overlay,
+    border: colors.border.default,
+    input: colors.border.default,
+    ring: colors.ring,
+    chart1: colors.chart[1],
+    chart2: colors.chart[2],
+    chart3: colors.chart[3],
+    chart4: colors.chart[4],
+    chart5: colors.chart[5],
+    sidebar: colors.sidebar.background,
+    sidebarForeground: colors.sidebar.foreground,
+    sidebarPrimary: colors.brand.primary,
+    sidebarPrimaryForeground: colors.brand.primaryForeground,
+    sidebarAccent: colors.sidebar.accent,
+    sidebarAccentForeground: colors.sidebar.accentForeground,
+    sidebarBorder: colors.sidebar.border,
+    sidebarRing: colors.sidebar.ring,
+  }
+}
diff --git a/frontend/functions/core/wails_cache.md b/frontend/functions/core/wails_cache.md
new file mode 100644
index 00000000..2296276d
--- /dev/null
+++ b/frontend/functions/core/wails_cache.md
@@ -0,0 +1,39 @@
+---
+name: wails_cache
+kind: function
+lang: typescript
+domain: core
+version: "1.0.0"
+purity: pure
+signature: "class WailsCache { get<T>(key: string[]): T | null; set<T>(key: string[], data: T): void; invalidate(key: string[]): void; subscribe(key: string[], cb: () => void): () => void }"
+description: "Cache reactivo para IPC Wails con invalidación por prefijo, suscripción a cambios y tracking de staleness. Singleton global."
+tags: [wails, cache, ipc, reactive, state]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: []
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/core/wails_cache.ts"
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/lib/wails/cache.ts"
+---
+
+## Ejemplo
+
+```typescript
+import { wailsCache } from './wails_cache'
+
+wailsCache.set(['users', '123'], userData)
+const user = wailsCache.get<User>(['users', '123'])
+wailsCache.invalidate(['users']) // invalida users:*
+const unsub = wailsCache.subscribe(['users'], () => console.log('changed'))
+```
+
+## Notas
+
+Key como string[] permite invalidación jerárquica: `invalidate(['users'])` invalida `users`, `users:123`, `users:456`, etc.
diff --git a/frontend/functions/core/wails_cache.ts b/frontend/functions/core/wails_cache.ts
new file mode 100644
index 00000000..10f2c0ed
--- /dev/null
+++ b/frontend/functions/core/wails_cache.ts
@@ -0,0 +1,99 @@
+interface CacheEntry {
+  data: unknown
+  timestamp: Date
+}
+
+export class WailsCache {
+  private cache = new Map<string, CacheEntry>()
+  private subscribers = new Map<string, Set<() => void>>()
+
+  /** Generar key string desde array */
+  private getKey(queryKey: string[]): string {
+    return queryKey.join(':')
+  }
+
+  /** Obtener dato del cache */
+  get<T>(queryKey: string[]): T | null {
+    const entry = this.cache.get(this.getKey(queryKey))
+    return (entry?.data as T) ?? null
+  }
+
+  /** Guardar dato en cache */
+  set<T>(queryKey: string[], data: T): void {
+    const key = this.getKey(queryKey)
+    this.cache.set(key, { data, timestamp: new Date() })
+    this.notifySubscribers(key)
+  }
+
+  /** Verificar si existe en cache */
+  has(queryKey: string[]): boolean {
+    return this.cache.has(this.getKey(queryKey))
+  }
+
+  /** Obtener timestamp de última actualización */
+  getTimestamp(queryKey: string[]): Date | null {
+    const entry = this.cache.get(this.getKey(queryKey))
+    return entry?.timestamp ?? null
+  }
+
+  /** Verificar si los datos están stale */
+  isStale(queryKey: string[], staleTime: number): boolean {
+    const entry = this.cache.get(this.getKey(queryKey))
+    if (!entry) return true
+    return Date.now() - entry.timestamp.getTime() > staleTime
+  }
+
+  /** Invalidar cache (esta key y todas las que empiezan igual) */
+  invalidate(queryKey: string[]): void {
+    const prefix = this.getKey(queryKey)
+    const keysToDelete: string[] = []
+
+    for (const key of this.cache.keys()) {
+      if (key === prefix || key.startsWith(prefix + ':')) {
+        keysToDelete.push(key)
+      }
+    }
+
+    keysToDelete.forEach((key) => {
+      this.cache.delete(key)
+      this.notifySubscribers(key)
+    })
+  }
+
+  /** Limpiar todo el cache */
+  clear(): void {
+    this.cache.clear()
+    this.subscribers.forEach((_, key) => this.notifySubscribers(key))
+  }
+
+  /** Subscribirse a cambios en una key */
+  subscribe(queryKey: string[], callback: () => void): () => void {
+    const key = this.getKey(queryKey)
+    if (!this.subscribers.has(key)) {
+      this.subscribers.set(key, new Set())
+    }
+    this.subscribers.get(key)!.add(callback)
+
+    return () => {
+      this.subscribers.get(key)?.delete(callback)
+    }
+  }
+
+  /** Notificar a subscribers */
+  private notifySubscribers(key: string): void {
+    this.subscribers.get(key)?.forEach((callback) => callback())
+  }
+
+  /** Obtener tamaño del cache */
+  get size(): number {
+    return this.cache.size
+  }
+
+  /** Obtener todas las keys */
+  keys(): string[] {
+    return Array.from(this.cache.keys())
+  }
+}
+
+// Singleton global
+export const wailsCache = new WailsCache()
diff --git a/frontend/functions/ui/alert.md b/frontend/functions/ui/alert.md
new file mode 100644
index 00000000..fe735977
--- /dev/null
+++ b/frontend/functions/ui/alert.md
@@ -0,0 +1,49 @@
+---
+name: alert
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "Alert(props: { variant?: 'default' | 'destructive' }): JSX.Element"
+description: "Alerta accesible con variantes default y destructive. Sistema de slots para título, descripción, icono y acción."
+tags: [alert, feedback, component, ui, notification]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react, class-variance-authority]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/alert.tsx"
+props:
+  - name: variant
+    type: "'default' | 'destructive'"
+    required: false
+    description: "Variante visual"
+emits: []
+has_state: false
+framework: react
+variant: [default, destructive]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/alert.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<Alert variant="destructive">
+  <AlertCircle />
+  <AlertTitle>Error</AlertTitle>
+  <AlertDescription>Something went wrong.</AlertDescription>
+</Alert>
+```
+
+## Notas
+
+Exporta 4 subcomponentes composables via data-slot: Alert, AlertTitle, AlertDescription, AlertAction.
+El icono SVG se posiciona automáticamente en grid cuando es hijo directo de Alert.
+AlertAction se posiciona absolute top-right para acciones secundarias (ej: botón cerrar).
diff --git a/frontend/functions/ui/alert.tsx b/frontend/functions/ui/alert.tsx
new file mode 100644
index 00000000..788daf70
--- /dev/null
+++ b/frontend/functions/ui/alert.tsx
@@ -0,0 +1,34 @@
+import * as React from "react"
+import { cva, type VariantProps } from "class-variance-authority"
+import { cn } from "../core/cn"
+
+const alertVariants = cva(
+  "group/alert relative grid w-full gap-0.5 rounded-lg border px-2.5 py-2 text-left text-sm has-data-[slot=alert-action]:relative has-data-[slot=alert-action]:pr-18 has-[>svg]:grid-cols-[auto_1fr] has-[>svg]:gap-x-2 *:[svg]:row-span-2 *:[svg]:translate-y-0.5 *:[svg]:text-current *:[svg:not([class*='size-'])]:size-4",
+  {
+    variants: {
+      variant: {
+        default: "bg-card text-card-foreground",
+        destructive: "bg-card text-destructive *:data-[slot=alert-description]:text-destructive/90 *:[svg]:text-current",
+      },
+    },
+    defaultVariants: { variant: "default" },
+  }
+)
+
+function Alert({ className, variant, ...props }: React.ComponentProps<"div"> & VariantProps<typeof alertVariants>) {
+  return <div data-slot="alert" role="alert" className={cn(alertVariants({ variant }), className)} {...props} />
+}
+
+function AlertTitle({ className, ...props }: React.ComponentProps<"div">) {
+  return <div data-slot="alert-title" className={cn("font-medium group-has-[>svg]/alert:col-start-2 [&_a]:underline [&_a]:underline-offset-3 [&_a]:hover:text-foreground", className)} {...props} />
+}
+
+function AlertDescription({ className, ...props }: React.ComponentProps<"div">) {
+  return <div data-slot="alert-description" className={cn("text-sm text-balance text-muted-foreground md:text-pretty [&_a]:underline [&_a]:underline-offset-3 [&_a]:hover:text-foreground [&_p:not(:last-child)]:mb-4", className)} {...props} />
+}
+
+function AlertAction({ className, ...props }: React.ComponentProps<"div">) {
+  return <div data-slot="alert-action" className={cn("absolute top-2 right-2", className)} {...props} />
+}
+
+export { Alert, AlertTitle, AlertDescription, AlertAction, alertVariants }
diff --git a/frontend/functions/ui/analytics_page.md b/frontend/functions/ui/analytics_page.md
new file mode 100644
index 00000000..08846bd5
--- /dev/null
+++ b/frontend/functions/ui/analytics_page.md
@@ -0,0 +1,47 @@
+---
+name: analytics_page
+kind: function
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: pure
+signature: "analyticsPage(props: AnalyticsPageProps): ReactElement"
+description: "Genera un dashboard de analytics completo con header, fila de KPIs con deltas y grid de charts configurables."
+tags: [analytics, dashboard, kpi, charts, factory, composition, ui]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/analytics_page.tsx"
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: ""
+---
+
+## Ejemplo
+
+```tsx
+analyticsPage({
+  title: 'Sales Analytics',
+  metrics: [
+    { label: 'Revenue', value: '$124,500', delta: { value: 12.5, isPositive: true } },
+    { label: 'Orders', value: '1,234', delta: { value: -3.2, isPositive: false } },
+    { label: 'Avg Order', value: '$101', delta: { value: 0, isPositive: true } },
+    { label: 'Customers', value: '892' },
+  ],
+  charts: [
+    { id: 'revenue', title: 'Revenue Over Time', type: 'area', span: 2, content: <AreaChart data={revenueData} xKey="month" yKey="revenue" /> },
+    { id: 'orders', title: 'Orders by Category', type: 'bar', content: <BarChart data={orderData} xKey="category" yKey="count" /> },
+    { id: 'trends', title: 'Customer Trends', type: 'line', content: <LineChart data={trendData} xKey="week" yKey="customers" /> },
+  ],
+})
+```
+
+## Notas
+
+Layout inteligente: los KPIs se ajustan automáticamente a 2/3/4 columnas según cantidad. Los charts soportan span para ancho completo.
diff --git a/frontend/functions/ui/analytics_page.tsx b/frontend/functions/ui/analytics_page.tsx
new file mode 100644
index 00000000..9208aa03
--- /dev/null
+++ b/frontend/functions/ui/analytics_page.tsx
@@ -0,0 +1,101 @@
+import * as React from 'react'
+import { cn } from '../core/cn'
+
+interface MetricConfig {
+  label: string
+  value: string | number
+  delta?: { value: number; isPositive: boolean }
+  sparklineData?: number[]
+}
+
+interface ChartConfig {
+  id: string
+  title: string
+  type: 'line' | 'bar' | 'area'
+  span?: 1 | 2
+  height?: number
+  content: React.ReactNode
+}
+
+interface AnalyticsPageProps {
+  title: string
+  subtitle?: string
+  dateRange?: React.ReactNode
+  metrics: MetricConfig[]
+  charts: ChartConfig[]
+  actions?: React.ReactNode
+  className?: string
+}
+
+export function analyticsPage({
+  title,
+  subtitle,
+  dateRange,
+  metrics,
+  charts,
+  actions,
+  className,
+}: AnalyticsPageProps): React.ReactElement {
+  return (
+    <div className={cn('space-y-6', className)}>
+      {/* Header */}
+      <div className="flex items-center justify-between border-b pb-4">
+        <div className="space-y-1">
+          <h1 className="text-2xl font-semibold tracking-tight">{title}</h1>
+          {subtitle && <p className="text-sm text-muted-foreground">{subtitle}</p>}
+        </div>
+        <div className="flex items-center gap-2">
+          {dateRange}
+          {actions}
+        </div>
+      </div>
+
+      {/* KPI Row */}
+      <div className={cn(
+        'grid gap-4',
+        metrics.length <= 2 ? 'grid-cols-1 md:grid-cols-2' :
+        metrics.length <= 3 ? 'grid-cols-1 md:grid-cols-3' :
+        'grid-cols-1 md:grid-cols-2 lg:grid-cols-4'
+      )}>
+        {metrics.map((metric, i) => (
+          <div key={i} className="rounded-lg border bg-card p-4 text-card-foreground shadow-sm">
+            <p className="text-sm text-muted-foreground">{metric.label}</p>
+            <div className="mt-2 flex items-end justify-between gap-4">
+              <div className="space-y-1">
+                <p className="text-3xl font-bold tracking-tight">{metric.value}</p>
+                {metric.delta && (
+                  <div className={cn(
+                    'flex items-center gap-1 text-sm font-medium',
+                    metric.delta.value === 0 ? 'text-muted-foreground' :
+                    metric.delta.isPositive ? 'text-green-600 dark:text-green-500' :
+                    'text-red-600 dark:text-red-500'
+                  )}>
+                    <span>{metric.delta.value > 0 ? '+' : ''}{metric.delta.value}%</span>
+                  </div>
+                )}
+              </div>
+            </div>
+          </div>
+        ))}
+      </div>
+
+      {/* Charts Grid */}
+      <div className="grid grid-cols-1 gap-4 lg:grid-cols-2">
+        {charts.map((chart) => (
+          <div
+            key={chart.id}
+            className={cn(
+              'rounded-xl border bg-card p-4 text-card-foreground shadow-sm',
+              chart.span === 2 && 'lg:col-span-2'
+            )}
+          >
+            <h3 className="mb-3 text-sm font-medium text-muted-foreground">{chart.title}</h3>
+            {chart.content}
+          </div>
+        ))}
+      </div>
+    </div>
+  )
+}
+
+export type { AnalyticsPageProps, MetricConfig, ChartConfig }
diff --git a/frontend/functions/ui/apply_theme.md b/frontend/functions/ui/apply_theme.md
new file mode 100644
index 00000000..9991facc
--- /dev/null
+++ b/frontend/functions/ui/apply_theme.md
@@ -0,0 +1,40 @@
+---
+name: apply_theme
+kind: function
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "applyTheme(theme: Theme): void"
+description: "Inyecta un tema como CSS variables en document.documentElement. Maneja clase dark automáticamente. Mapea 40 tokens semánticos."
+tags: [theme, css-variables, apply, runtime, ui]
+uses_functions: []
+uses_types: [ThemeConfig_typescript_ui]
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: []
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/apply_theme.tsx"
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/hooks/use-theme.tsx"
+---
+
+## Ejemplo
+
+```typescript
+import { applyTheme } from './apply_theme'
+
+applyTheme({
+  name: 'dark',
+  label: 'Oscuro',
+  colors: themeConfigToColors(darkThemeConfig)
+})
+```
+
+## Notas
+
+Función impura (modifica el DOM). Mapea cada key de ThemeColors a una CSS variable. Temas oscuros (dark, midnight, sunset) añaden clase `dark` al root.
diff --git a/frontend/functions/ui/apply_theme.tsx b/frontend/functions/ui/apply_theme.tsx
new file mode 100644
index 00000000..49eafbd5
--- /dev/null
+++ b/frontend/functions/ui/apply_theme.tsx
@@ -0,0 +1,111 @@
+interface ThemeColors {
+  background: string
+  foreground: string
+  card: string
+  cardForeground: string
+  popover: string
+  popoverForeground: string
+  primary: string
+  primaryForeground: string
+  secondary: string
+  secondaryForeground: string
+  muted: string
+  mutedForeground: string
+  accent: string
+  accentForeground: string
+  destructive: string
+  destructiveForeground: string
+  success: string
+  successForeground: string
+  warning: string
+  warningForeground: string
+  info: string
+  infoForeground: string
+  surface: string
+  surfaceHover: string
+  overlay: string
+  border: string
+  input: string
+  ring: string
+  chart1: string
+  chart2: string
+  chart3: string
+  chart4: string
+  chart5: string
+  sidebar: string
+  sidebarForeground: string
+  sidebarPrimary: string
+  sidebarPrimaryForeground: string
+  sidebarAccent: string
+  sidebarAccentForeground: string
+  sidebarBorder: string
+  sidebarRing: string
+}
+
+interface Theme {
+  name: string
+  label: string
+  colors: ThemeColors
+}
+
+const cssVarMap: Record<keyof ThemeColors, string> = {
+  background: '--background',
+  foreground: '--foreground',
+  card: '--card',
+  cardForeground: '--card-foreground',
+  popover: '--popover',
+  popoverForeground: '--popover-foreground',
+  primary: '--primary',
+  primaryForeground: '--primary-foreground',
+  secondary: '--secondary',
+  secondaryForeground: '--secondary-foreground',
+  muted: '--muted',
+  mutedForeground: '--muted-foreground',
+  accent: '--accent',
+  accentForeground: '--accent-foreground',
+  destructive: '--destructive',
+  destructiveForeground: '--destructive-foreground',
+  success: '--success',
+  successForeground: '--success-foreground',
+  warning: '--warning',
+  warningForeground: '--warning-foreground',
+  info: '--info',
+  infoForeground: '--info-foreground',
+  surface: '--surface',
+  surfaceHover: '--surface-hover',
+  overlay: '--overlay',
+  border: '--border',
+  input: '--input',
+  ring: '--ring',
+  chart1: '--chart-1',
+  chart2: '--chart-2',
+  chart3: '--chart-3',
+  chart4: '--chart-4',
+  chart5: '--chart-5',
+  sidebar: '--sidebar',
+  sidebarForeground: '--sidebar-foreground',
+  sidebarPrimary: '--sidebar-primary',
+  sidebarPrimaryForeground: '--sidebar-primary-foreground',
+  sidebarAccent: '--sidebar-accent',
+  sidebarAccentForeground: '--sidebar-accent-foreground',
+  sidebarBorder: '--sidebar-border',
+  sidebarRing: '--sidebar-ring',
+}
+
+export function applyTheme(theme: Theme): void {
+  const root = document.documentElement
+  const colors = theme.colors
+
+  Object.entries(cssVarMap).forEach(([key, cssVar]) => {
+    const value = colors[key as keyof ThemeColors]
+    root.style.setProperty(cssVar, value)
+  })
+
+  if (theme.name === 'dark' || theme.name === 'midnight' || theme.name === 'sunset') {
+    root.classList.add('dark')
+  } else {
+    root.classList.remove('dark')
+  }
+}
+
+export type { Theme, ThemeColors }
diff --git a/frontend/functions/ui/area_chart.md b/frontend/functions/ui/area_chart.md
new file mode 100644
index 00000000..92a95495
--- /dev/null
+++ b/frontend/functions/ui/area_chart.md
@@ -0,0 +1,56 @@
+---
+name: area_chart
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "AreaChart(props: AreaChartProps): JSX.Element"
+description: "Gráfico de área Recharts con gradientes automáticos, multi-series, stacking y tooltips temáticos."
+tags: [chart, area, visualization, recharts, gradient, component, ui]
+uses_functions: [cn_typescript_core, chart_container_typescript_ui, get_series_color_typescript_core]
+uses_types: [ChartSeries_typescript_ui]
+returns: []
+returns_optional: false
+error_type: ""
+imports: [recharts]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/area_chart.tsx"
+props:
+  - name: data
+    type: "Record<string, unknown>[]"
+    required: true
+    description: "Array de datos"
+  - name: xKey
+    type: "string"
+    required: true
+    description: "Key del eje X"
+  - name: stacked
+    type: "boolean"
+    required: false
+    description: "Apilar áreas"
+  - name: gradient
+    type: "GradientConfig | boolean"
+    required: false
+    description: "Gradiente (true por defecto)"
+  - name: series
+    type: "Series[]"
+    required: false
+    description: "Series de datos para multi-series"
+emits: []
+has_state: false
+framework: react
+variant: [default, stacked]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/charts/area-chart.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<AreaChart data={data} xKey="date" yKey="revenue" gradient />
+<AreaChart data={data} xKey="date" series={series} stacked showLegend />
+```
diff --git a/frontend/functions/ui/area_chart.tsx b/frontend/functions/ui/area_chart.tsx
new file mode 100644
index 00000000..f0ef51cb
--- /dev/null
+++ b/frontend/functions/ui/area_chart.tsx
@@ -0,0 +1,62 @@
+import {
+  AreaChart as RechartsAreaChart, Area, XAxis, YAxis, CartesianGrid, Tooltip, Legend,
+} from 'recharts'
+import { ChartContainer, ChartTooltipContent, type Series, getSeriesColor } from './chart_container'
+
+interface GradientConfig { from: string; to: string }
+
+interface AreaChartProps {
+  data: Record<string, unknown>[]
+  xKey: string
+  yKey?: string
+  series?: Series[]
+  stacked?: boolean
+  gradient?: GradientConfig | boolean
+  showGrid?: boolean
+  showLegend?: boolean
+  height?: number | string
+  className?: string
+  xAxisFormatter?: (value: unknown) => string
+  yAxisFormatter?: (value: unknown) => string
+  valueFormatter?: (value: number) => string
+}
+
+function AreaChartComponent({
+  data, xKey, yKey, series, stacked = false, gradient = true, showGrid = true,
+  showLegend = false, height = 300, className, xAxisFormatter, yAxisFormatter,
+  valueFormatter = (v) => v.toLocaleString(),
+}: AreaChartProps) {
+  const areas = series
+    ? series.map((s, i) => ({ dataKey: s.key, name: s.name, color: getSeriesColor(i, s.color) }))
+    : yKey ? [{ dataKey: yKey, name: yKey, color: getSeriesColor(0) }] : []
+
+  const gradientConfig: GradientConfig | null = gradient
+    ? typeof gradient === 'object' ? gradient : { from: '', to: 'transparent' }
+    : null
+
+  return (
+    <ChartContainer className={className} height={height}>
+      <RechartsAreaChart data={data} margin={{ top: 10, right: 10, left: 10, bottom: 10 }}>
+        <defs>
+          {areas.map((area) => (
+            <linearGradient key={area.dataKey} id={`gradient-${area.dataKey}`} x1="0" y1="0" x2="0" y2="1">
+              <stop offset="5%" stopColor={gradientConfig?.from || area.color} stopOpacity={0.8} />
+              <stop offset="95%" stopColor={gradientConfig?.to || area.color} stopOpacity={0.1} />
+            </linearGradient>
+          ))}
+        </defs>
+        {showGrid && <CartesianGrid strokeDasharray="3 3" className="stroke-muted" />}
+        <XAxis dataKey={xKey} tickFormatter={xAxisFormatter} className="text-xs fill-muted-foreground" />
+        <YAxis tickFormatter={yAxisFormatter} className="text-xs fill-muted-foreground" />
+        <Tooltip content={<ChartTooltipContent valueFormatter={valueFormatter} />} cursor={{ stroke: 'hsl(var(--muted-foreground))', strokeDasharray: '3 3' }} />
+        {showLegend && <Legend />}
+        {areas.map((area) => (
+          <Area key={area.dataKey} type="monotone" dataKey={area.dataKey} name={area.name} stroke={area.color} strokeWidth={2} fill={gradient ? `url(#gradient-${area.dataKey})` : area.color} fillOpacity={gradient ? 1 : 0.3} stackId={stacked ? 'stack' : undefined} />
+        ))}
+      </RechartsAreaChart>
+    </ChartContainer>
+  )
+}
+
+export const AreaChart = AreaChartComponent
+export type { AreaChartProps, GradientConfig }
diff --git a/frontend/functions/ui/badge.md b/frontend/functions/ui/badge.md
new file mode 100644
index 00000000..4558d802
--- /dev/null
+++ b/frontend/functions/ui/badge.md
@@ -0,0 +1,48 @@
+---
+name: badge
+kind: component
+lang: ts
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "Badge(props: BadgeProps & VariantProps<typeof badgeVariants>): JSX.Element"
+description: "Badge con 10 variantes semánticas (default, secondary, destructive, outline, ghost, link, success, warning, error, info) y 2 tamaños."
+tags: [badge, status, component, ui, indicator]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: ["class-variance-authority"]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/badge.tsx"
+props:
+  - name: variant
+    type: "'default' | 'secondary' | 'destructive' | 'outline' | 'ghost' | 'link' | 'success' | 'warning' | 'error' | 'info'"
+    required: false
+    description: "Variante visual"
+  - name: size
+    type: "'default' | 'sm'"
+    required: false
+    description: "Tamaño"
+emits: []
+has_state: false
+framework: react
+variant: [default, secondary, destructive, outline, ghost, link, success, warning, error, info]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/badge.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<Badge variant="success">Active</Badge>
+<Badge variant="error" size="sm">Error</Badge>
+```
+
+## Notas
+
+Versión simplificada que usa span nativo en lugar de useRender de Base-UI. Mantiene todas las variantes y la composibilidad con cn().
diff --git a/frontend/functions/ui/badge.tsx b/frontend/functions/ui/badge.tsx
new file mode 100644
index 00000000..76f1fece
--- /dev/null
+++ b/frontend/functions/ui/badge.tsx
@@ -0,0 +1,45 @@
+import * as React from "react"
+import { cva, type VariantProps } from "class-variance-authority"
+import { cn } from "../core/cn"
+
+const badgeVariants = cva(
+  "group/badge inline-flex h-5 w-fit shrink-0 items-center justify-center gap-1 overflow-hidden rounded-4xl border border-transparent px-2 py-0.5 text-xs font-medium whitespace-nowrap transition-all focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 [&>svg]:pointer-events-none [&>svg]:size-3!",
+  {
+    variants: {
+      variant: {
+        default: "bg-primary text-primary-foreground [a]:hover:bg-primary/80",
+        secondary: "bg-secondary text-secondary-foreground [a]:hover:bg-secondary/80",
+        destructive: "bg-destructive/10 text-destructive [a]:hover:bg-destructive/20",
+        outline: "border-border text-foreground [a]:hover:bg-muted",
+        ghost: "hover:bg-muted hover:text-muted-foreground dark:hover:bg-muted/50",
+        link: "text-primary underline-offset-4 hover:underline",
+        success: "bg-green-500/10 text-green-600 dark:bg-green-500/20 dark:text-green-400",
+        warning: "bg-yellow-500/10 text-yellow-600 dark:bg-yellow-500/20 dark:text-yellow-400",
+        error: "bg-red-500/10 text-red-600 dark:bg-red-500/20 dark:text-red-400",
+        info: "bg-blue-500/10 text-blue-600 dark:bg-blue-500/20 dark:text-blue-400",
+      },
+      size: {
+        default: "h-5 px-2 text-xs",
+        sm: "h-4 px-1.5 text-[10px]",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+)
+
+interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {}
+
+function Badge({ className, variant = "default", size = "default", ...props }: BadgeProps) {
+  return (
+    <span
+      data-slot="badge"
+      className={cn(badgeVariants({ variant, size }), className)}
+      {...props}
+    />
+  )
+}
+
+export { Badge, badgeVariants }
diff --git a/frontend/functions/ui/bar_chart.md b/frontend/functions/ui/bar_chart.md
new file mode 100644
index 00000000..0857994f
--- /dev/null
+++ b/frontend/functions/ui/bar_chart.md
@@ -0,0 +1,52 @@
+---
+name: bar_chart
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "BarChart(props: BarChartProps): JSX.Element"
+description: "Gráfico de barras Recharts con multi-series, orientación horizontal/vertical, tooltips temáticos y bordes redondeados."
+tags: [chart, bar, visualization, recharts, component, ui]
+uses_functions: [cn_typescript_core, chart_container_typescript_ui, get_series_color_typescript_core]
+uses_types: [ChartSeries_typescript_ui]
+returns: []
+returns_optional: false
+error_type: ""
+imports: [recharts]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/bar_chart.tsx"
+props:
+  - name: data
+    type: "Record<string, unknown>[]"
+    required: true
+    description: "Array de datos"
+  - name: xKey
+    type: "string"
+    required: true
+    description: "Key del eje X/categoría"
+  - name: horizontal
+    type: "boolean"
+    required: false
+    description: "Orientación horizontal"
+  - name: series
+    type: "Series[]"
+    required: false
+    description: "Series de datos para multi-series"
+emits: []
+has_state: false
+framework: react
+variant: [vertical, horizontal]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/charts/bar-chart.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<BarChart data={data} xKey="category" yKey="sales" showLegend />
+<BarChart data={data} xKey="name" series={series} horizontal />
+```
diff --git a/frontend/functions/ui/bar_chart.tsx b/frontend/functions/ui/bar_chart.tsx
new file mode 100644
index 00000000..2a37f122
--- /dev/null
+++ b/frontend/functions/ui/bar_chart.tsx
@@ -0,0 +1,53 @@
+import {
+  BarChart as RechartsBarChart, Bar, XAxis, YAxis, CartesianGrid, Tooltip, Legend,
+} from 'recharts'
+import { ChartContainer, ChartTooltipContent, type Series, getSeriesColor } from './chart_container'
+
+interface BarChartProps {
+  data: Record<string, unknown>[]
+  xKey: string
+  yKey?: string
+  series?: Series[]
+  horizontal?: boolean
+  showGrid?: boolean
+  showLegend?: boolean
+  height?: number | string
+  className?: string
+  xAxisFormatter?: (value: unknown) => string
+  yAxisFormatter?: (value: unknown) => string
+  valueFormatter?: (value: number) => string
+}
+
+function BarChartComponent({
+  data, xKey, yKey, series, horizontal = false, showGrid = true, showLegend = false,
+  height = 300, className, xAxisFormatter, yAxisFormatter, valueFormatter = (v) => v.toLocaleString(),
+}: BarChartProps) {
+  const bars = series
+    ? series.map((s, i) => ({ dataKey: s.key, name: s.name, fill: getSeriesColor(i, s.color) }))
+    : yKey ? [{ dataKey: yKey, name: yKey, fill: getSeriesColor(0) }] : []
+
+  return (
+    <ChartContainer className={className} height={height}>
+      <RechartsBarChart data={data} layout={horizontal ? 'vertical' : 'horizontal'} margin={{ top: 10, right: 10, left: 10, bottom: 10 }}>
+        {showGrid && <CartesianGrid strokeDasharray="3 3" className="stroke-muted" />}
+        {horizontal ? (
+          <>
+            <XAxis type="number" tickFormatter={yAxisFormatter} className="text-xs fill-muted-foreground" />
+            <YAxis dataKey={xKey} type="category" tickFormatter={xAxisFormatter} width={80} className="text-xs fill-muted-foreground" />
+          </>
+        ) : (
+          <>
+            <XAxis dataKey={xKey} tickFormatter={xAxisFormatter} className="text-xs fill-muted-foreground" />
+            <YAxis tickFormatter={yAxisFormatter} className="text-xs fill-muted-foreground" />
+          </>
+        )}
+        <Tooltip content={<ChartTooltipContent valueFormatter={valueFormatter} />} cursor={{ fill: 'hsl(var(--muted) / 0.3)' }} />
+        {showLegend && <Legend />}
+        {bars.map((bar) => <Bar key={bar.dataKey} dataKey={bar.dataKey} name={bar.name} fill={bar.fill} radius={[4, 4, 0, 0]} />)}
+      </RechartsBarChart>
+    </ChartContainer>
+  )
+}
+
+export const BarChart = BarChartComponent
+export type { BarChartProps }
diff --git a/frontend/functions/ui/button.md b/frontend/functions/ui/button.md
new file mode 100644
index 00000000..a4ffada6
--- /dev/null
+++ b/frontend/functions/ui/button.md
@@ -0,0 +1,53 @@
+---
+name: button
+kind: component
+lang: ts
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "Button(props: ButtonProps & VariantProps<typeof buttonVariants>): JSX.Element"
+description: "Botón accesible con 6 variantes (default, outline, secondary, ghost, destructive, link) y 8 tamaños. Base-UI primitivo con CVA."
+tags: [button, component, ui, interactive, cva]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: ["@base-ui/react", "class-variance-authority"]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/button.tsx"
+props:
+  - name: variant
+    type: "'default' | 'outline' | 'secondary' | 'ghost' | 'destructive' | 'link'"
+    required: false
+    description: "Estilo visual del botón"
+  - name: size
+    type: "'default' | 'xs' | 'sm' | 'lg' | 'icon' | 'icon-xs' | 'icon-sm' | 'icon-lg'"
+    required: false
+    description: "Tamaño del botón"
+  - name: className
+    type: "string"
+    required: false
+    description: "Clases CSS adicionales"
+emits: [onClick]
+has_state: false
+framework: react
+variant: [default, outline, secondary, ghost, destructive, link]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/button.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<Button variant="outline" size="sm">Click me</Button>
+<Button variant="destructive">Delete</Button>
+<Button variant="ghost" size="icon"><TrashIcon /></Button>
+```
+
+## Notas
+
+Componente base del sistema. Usa Base-UI Button primitive para accesibilidad completa (keyboard, ARIA). CVA para gestión type-safe de variantes.
diff --git a/frontend/functions/ui/button.tsx b/frontend/functions/ui/button.tsx
new file mode 100644
index 00000000..74869947
--- /dev/null
+++ b/frontend/functions/ui/button.tsx
@@ -0,0 +1,52 @@
+"use client"
+
+import { Button as ButtonPrimitive } from "@base-ui/react/button"
+import { cva, type VariantProps } from "class-variance-authority"
+import { cn } from "../core/cn"
+
+const buttonVariants = cva(
+  "group/button inline-flex shrink-0 items-center justify-center rounded-lg border border-transparent bg-clip-padding text-sm font-medium whitespace-nowrap transition-all outline-none select-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 active:translate-y-px disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+  {
+    variants: {
+      variant: {
+        default: "bg-primary text-primary-foreground [a]:hover:bg-primary/80",
+        outline: "border-border bg-background hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:border-input dark:bg-input/30 dark:hover:bg-input/50",
+        secondary: "bg-secondary text-secondary-foreground hover:bg-secondary/80 aria-expanded:bg-secondary aria-expanded:text-secondary-foreground",
+        ghost: "hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:hover:bg-muted/50",
+        destructive: "bg-destructive/10 text-destructive hover:bg-destructive/20 focus-visible:border-destructive/40 focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:hover:bg-destructive/30 dark:focus-visible:ring-destructive/40",
+        link: "text-primary underline-offset-4 hover:underline",
+      },
+      size: {
+        default: "h-8 gap-1.5 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
+        xs: "h-6 gap-1 rounded-[min(var(--radius-md),10px)] px-2 text-xs",
+        sm: "h-7 gap-1 rounded-[min(var(--radius-md),12px)] px-2.5 text-[0.8rem]",
+        lg: "h-9 gap-1.5 px-2.5 has-data-[icon=inline-end]:pr-3 has-data-[icon=inline-start]:pl-3",
+        icon: "size-8",
+        "icon-xs": "size-6 rounded-[min(var(--radius-md),10px)]",
+        "icon-sm": "size-7 rounded-[min(var(--radius-md),12px)]",
+        "icon-lg": "size-9",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+)
+
+function Button({
+  className,
+  variant = "default",
+  size = "default",
+  ...props
+}: ButtonPrimitive.Props & VariantProps<typeof buttonVariants>) {
+  return (
+    <ButtonPrimitive
+      data-slot="button"
+      className={cn(buttonVariants({ variant, size, className }))}
+      {...props}
+    />
+  )
+}
+
+export { Button, buttonVariants }
diff --git a/frontend/functions/ui/card.md b/frontend/functions/ui/card.md
new file mode 100644
index 00000000..7de9a260
--- /dev/null
+++ b/frontend/functions/ui/card.md
@@ -0,0 +1,54 @@
+---
+name: card
+kind: component
+lang: ts
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "Card(props: { size?: 'default' | 'sm'; className?: string; children: ReactNode }): JSX.Element"
+description: "Contenedor card con header, title, description, action, content y footer. Sistema de slots composable."
+tags: [card, container, layout, component, ui]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: ["react"]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/card.tsx"
+props:
+  - name: size
+    type: "'default' | 'sm'"
+    required: false
+    description: "Tamaño del card"
+  - name: className
+    type: "string"
+    required: false
+    description: "Clases CSS adicionales"
+emits: []
+has_state: false
+framework: react
+variant: [default, sm]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/card.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<Card>
+  <CardHeader>
+    <CardTitle>Título</CardTitle>
+    <CardDescription>Descripción</CardDescription>
+  </CardHeader>
+  <CardContent>Contenido</CardContent>
+  <CardFooter>Footer</CardFooter>
+</Card>
+```
+
+## Notas
+
+Sistema de slots via data-slot attributes. Card detecta automáticamente la presencia de CardFooter y ajusta el padding. Exporta 7 subcomponentes composables.
diff --git a/frontend/functions/ui/card.tsx b/frontend/functions/ui/card.tsx
new file mode 100644
index 00000000..7f5a24df
--- /dev/null
+++ b/frontend/functions/ui/card.tsx
@@ -0,0 +1,85 @@
+import * as React from "react"
+import { cn } from "../core/cn"
+
+function Card({
+  className,
+  size = "default",
+  ...props
+}: React.ComponentProps<"div"> & { size?: "default" | "sm" }) {
+  return (
+    <div
+      data-slot="card"
+      data-size={size}
+      className={cn(
+        "group/card flex flex-col gap-4 overflow-hidden rounded-xl bg-card py-4 text-sm text-card-foreground ring-1 ring-foreground/10 has-data-[slot=card-footer]:pb-0 has-[>img:first-child]:pt-0 data-[size=sm]:gap-3 data-[size=sm]:py-3 data-[size=sm]:has-data-[slot=card-footer]:pb-0 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-header"
+      className={cn(
+        "group/card-header @container/card-header grid auto-rows-min items-start gap-1 rounded-t-xl px-4 group-data-[size=sm]/card:px-3 has-data-[slot=card-action]:grid-cols-[1fr_auto] has-data-[slot=card-description]:grid-rows-[auto_auto] [.border-b]:pb-4 group-data-[size=sm]/card:[.border-b]:pb-3",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-title"
+      className={cn("text-base leading-snug font-medium group-data-[size=sm]/card:text-sm", className)}
+      {...props}
+    />
+  )
+}
+
+function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-description"
+      className={cn("text-sm text-muted-foreground", className)}
+      {...props}
+    />
+  )
+}
+
+function CardAction({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-action"
+      className={cn("col-start-2 row-span-2 row-start-1 self-start justify-self-end", className)}
+      {...props}
+    />
+  )
+}
+
+function CardContent({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-content"
+      className={cn("px-4 group-data-[size=sm]/card:px-3", className)}
+      {...props}
+    />
+  )
+}
+
+function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-footer"
+      className={cn("flex items-center rounded-b-xl border-t bg-muted/50 p-4 group-data-[size=sm]/card:p-3", className)}
+      {...props}
+    />
+  )
+}
+
+export { Card, CardHeader, CardFooter, CardTitle, CardAction, CardDescription, CardContent }
diff --git a/frontend/functions/ui/chart_container.md b/frontend/functions/ui/chart_container.md
new file mode 100644
index 00000000..7f163c01
--- /dev/null
+++ b/frontend/functions/ui/chart_container.md
@@ -0,0 +1,49 @@
+---
+name: chart_container
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "ChartContainer(props: { children: ReactNode; height?: number | string }): JSX.Element"
+description: "Base para todos los charts Recharts: container responsive, tooltip temático, legend y utilidades de colores por serie."
+tags: [chart, container, recharts, base, visualization, component, ui]
+uses_functions: [cn_typescript_core, get_series_color_typescript_core]
+uses_types: [ChartSeries_typescript_ui]
+returns: []
+returns_optional: false
+error_type: ""
+imports: [recharts, react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/chart_container.tsx"
+props:
+  - name: height
+    type: "number | string"
+    required: false
+    description: "Altura del chart (default 300)"
+  - name: className
+    type: "string"
+    required: false
+    description: "Clases CSS adicionales"
+emits: []
+has_state: false
+framework: react
+variant: [default]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/charts/chart-base.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<ChartContainer height={400}>
+  <RechartsLineChart data={data}>...</RechartsLineChart>
+</ChartContainer>
+```
+
+## Notas
+
+Exporta: ChartContainer, ChartTooltipContent, ChartTooltip, ChartLegend, chartColors, defaultColors, getSeriesColor, Series.
diff --git a/frontend/functions/ui/chart_container.tsx b/frontend/functions/ui/chart_container.tsx
new file mode 100644
index 00000000..040a83ca
--- /dev/null
+++ b/frontend/functions/ui/chart_container.tsx
@@ -0,0 +1,80 @@
+import * as React from 'react'
+import { cn } from '../core/cn'
+import { ResponsiveContainer, Tooltip as RechartsTooltip, Legend as RechartsLegend } from 'recharts'
+
+export const chartColors = [
+  'hsl(var(--chart-1, 220 70% 50%))',
+  'hsl(var(--chart-2, 160 60% 45%))',
+  'hsl(var(--chart-3, 30 80% 55%))',
+  'hsl(var(--chart-4, 280 65% 60%))',
+  'hsl(var(--chart-5, 340 75% 55%))',
+]
+
+export const defaultColors = ['#3b82f6', '#22c55e', '#f59e0b', '#8b5cf6', '#ec4899']
+
+export interface Series {
+  key: string
+  name: string
+  color?: string
+}
+
+export function getSeriesColor(index: number, color?: string): string {
+  return color || defaultColors[index % defaultColors.length]
+}
+
+interface ChartContainerProps {
+  children: React.ReactNode
+  className?: string
+  height?: number | string
+}
+
+export function ChartContainer({ children, className, height = 300 }: ChartContainerProps) {
+  return (
+    <div
+      className={cn('w-full', className)}
+      style={{ height, minWidth: 100, minHeight: typeof height === 'number' ? Math.min(height, 100) : 100 }}
+    >
+      <ResponsiveContainer width="100%" height="100%">
+        {children as React.ReactElement}
+      </ResponsiveContainer>
+    </div>
+  )
+}
+
+interface ChartTooltipContentProps {
+  active?: boolean
+  payload?: Array<{ name: string; value: number; color: string; dataKey: string }>
+  label?: string
+  labelFormatter?: (label: string) => string
+  valueFormatter?: (value: number) => string
+}
+
+export function ChartTooltipContent({
+  active, payload, label,
+  labelFormatter = (l) => l,
+  valueFormatter = (v) => v.toLocaleString(),
+}: ChartTooltipContentProps) {
+  if (!active || !payload?.length) return null
+  return (
+    <div className="rounded-lg border bg-background p-2 shadow-md">
+      <p className="mb-1 text-sm font-medium">{labelFormatter(label || '')}</p>
+      <div className="space-y-0.5">
+        {payload.map((entry, index) => (
+          <div key={index} className="flex items-center gap-2 text-sm">
+            <div className="size-2.5 rounded-full" style={{ backgroundColor: entry.color }} />
+            <span className="text-muted-foreground">{entry.name}:</span>
+            <span className="font-medium">{valueFormatter(entry.value)}</span>
+          </div>
+        ))}
+      </div>
+    </div>
+  )
+}
+
+export function ChartTooltip(props: React.ComponentProps<typeof RechartsTooltip>) {
+  return <RechartsTooltip content={<ChartTooltipContent />} cursor={{ fill: 'hsl(var(--muted) / 0.3)' }} {...props} />
+}
+
+export function ChartLegend(props: React.ComponentProps<typeof RechartsLegend>) {
+  return <RechartsLegend wrapperStyle={{ paddingTop: 16 }} {...props} />
+}
diff --git a/frontend/functions/ui/crud_page.md b/frontend/functions/ui/crud_page.md
new file mode 100644
index 00000000..9f139b00
--- /dev/null
+++ b/frontend/functions/ui/crud_page.md
@@ -0,0 +1,51 @@
+---
+name: crud_page
+kind: function
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: pure
+signature: "crudPage<T>(props: CrudPageProps<T>): ReactElement"
+description: "Genera una página CRUD completa con header, tabla con columnas configurables, botones de acción (add/edit/delete) y schema de formulario."
+tags: [crud, page, table, form, factory, composition, ui]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/crud_page.tsx"
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: ""
+---
+
+## Ejemplo
+
+```tsx
+crudPage({
+  title: 'Users',
+  subtitle: 'Manage system users',
+  data: users,
+  fields: [
+    { key: 'name', label: 'Name', type: 'text', required: true },
+    { key: 'email', label: 'Email', type: 'email', required: true },
+    { key: 'role', label: 'Role', type: 'select', options: [{ label: 'Admin', value: 'admin' }, { label: 'User', value: 'user' }] },
+  ],
+  columns: [
+    { key: 'name', label: 'Name' },
+    { key: 'email', label: 'Email' },
+    { key: 'role', label: 'Role', render: (v) => <Badge variant={v === 'admin' ? 'default' : 'secondary'}>{v}</Badge> },
+  ],
+  onAdd: handleAdd,
+  onEdit: handleEdit,
+  onDelete: handleDelete,
+})
+```
+
+## Notas
+
+El schema de campos se almacena como data attribute para que un agente pueda leerlo y generar el formulario de diálogo correspondiente. La tabla incluye sorting visual implícito por columnas.
diff --git a/frontend/functions/ui/crud_page.tsx b/frontend/functions/ui/crud_page.tsx
new file mode 100644
index 00000000..effa6a24
--- /dev/null
+++ b/frontend/functions/ui/crud_page.tsx
@@ -0,0 +1,120 @@
+import * as React from 'react'
+import { cn } from '../core/cn'
+
+interface CrudField {
+  key: string
+  label: string
+  type: 'text' | 'number' | 'email' | 'select' | 'textarea'
+  required?: boolean
+  options?: Array<{ label: string; value: string }>
+  placeholder?: string
+}
+
+interface CrudPageProps<T extends Record<string, unknown>> {
+  title: string
+  subtitle?: string
+  data: T[]
+  fields: CrudField[]
+  columns: Array<{
+    key: keyof T
+    label: string
+    render?: (value: unknown, row: T) => React.ReactNode
+  }>
+  onAdd?: (item: Partial<T>) => void
+  onEdit?: (item: T) => void
+  onDelete?: (item: T) => void
+  actions?: React.ReactNode
+  className?: string
+}
+
+export function crudPage<T extends Record<string, unknown>>({
+  title,
+  subtitle,
+  data,
+  fields,
+  columns,
+  onAdd,
+  onEdit,
+  onDelete,
+  actions,
+  className,
+}: CrudPageProps<T>): React.ReactElement {
+  return (
+    <div className={cn('space-y-6', className)}>
+      {/* Header */}
+      <div className="flex items-center justify-between border-b pb-4">
+        <div className="space-y-1">
+          <h1 className="text-2xl font-semibold tracking-tight">{title}</h1>
+          {subtitle && <p className="text-sm text-muted-foreground">{subtitle}</p>}
+        </div>
+        <div className="flex items-center gap-2">
+          {actions}
+          {onAdd && (
+            <button className="inline-flex h-8 items-center gap-1.5 rounded-lg bg-primary px-2.5 text-sm font-medium text-primary-foreground hover:bg-primary/80">
+              <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2"><path d="M12 5v14M5 12h14"/></svg>
+              Add {title.replace(/s$/, '')}
+            </button>
+          )}
+        </div>
+      </div>
+
+      {/* Table */}
+      <div className="rounded-lg border">
+        <table className="w-full caption-bottom text-sm">
+          <thead className="border-b bg-muted/50">
+            <tr>
+              {columns.map((col) => (
+                <th key={String(col.key)} className="px-4 py-3 text-left text-sm font-medium text-muted-foreground">
+                  {col.label}
+                </th>
+              ))}
+              {(onEdit || onDelete) && (
+                <th className="px-4 py-3 text-right text-sm font-medium text-muted-foreground">Actions</th>
+              )}
+            </tr>
+          </thead>
+          <tbody className="divide-y">
+            {data.length === 0 ? (
+              <tr>
+                <td colSpan={columns.length + (onEdit || onDelete ? 1 : 0)} className="h-24 text-center text-muted-foreground">
+                  No items yet.
+                </td>
+              </tr>
+            ) : (
+              data.map((row, i) => (
+                <tr key={i} className="hover:bg-muted/50">
+                  {columns.map((col) => (
+                    <td key={String(col.key)} className="px-4 py-3 align-middle">
+                      {col.render ? col.render(row[col.key], row) : String(row[col.key] ?? '')}
+                    </td>
+                  ))}
+                  {(onEdit || onDelete) && (
+                    <td className="px-4 py-3 text-right">
+                      <div className="flex justify-end gap-1">
+                        {onEdit && (
+                          <button onClick={() => onEdit(row)} className="inline-flex size-7 items-center justify-center rounded-md hover:bg-muted">
+                            <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2"><path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"/><path d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z"/></svg>
+                          </button>
+                        )}
+                        {onDelete && (
+                          <button onClick={() => onDelete(row)} className="inline-flex size-7 items-center justify-center rounded-md text-destructive hover:bg-destructive/10">
+                            <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2"><path d="M3 6h18M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6m3 0V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"/></svg>
+                          </button>
+                        )}
+                      </div>
+                    </td>
+                  )}
+                </tr>
+              ))
+            )}
+          </tbody>
+        </table>
+      </div>
+
+      {/* Form fields definition (for agent use — renders a form preview) */}
+      <div className="hidden" data-slot="crud-form-schema" data-fields={JSON.stringify(fields)} />
+    </div>
+  )
+}
+
+export type { CrudPageProps, CrudField }
diff --git a/frontend/functions/ui/dashboard_layout.md b/frontend/functions/ui/dashboard_layout.md
new file mode 100644
index 00000000..e4b87676
--- /dev/null
+++ b/frontend/functions/ui/dashboard_layout.md
@@ -0,0 +1,42 @@
+---
+name: dashboard_layout
+kind: function
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: pure
+signature: "dashboardLayout(props: DashboardLayoutProps): ReactElement"
+description: "Genera un grid responsive de dashboard a partir de un array de widgets con span configurable. 1-4 columnas con auto-responsive."
+tags: [dashboard, layout, grid, factory, composition, ui]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/dashboard_layout.tsx"
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: ""
+---
+
+## Ejemplo
+
+```tsx
+dashboardLayout({
+  columns: 4,
+  widgets: [
+    { id: 'revenue', title: 'Revenue', content: <KPICard label="Revenue" value="$12k" /> },
+    { id: 'users', title: 'Users', content: <KPICard label="Users" value={1234} /> },
+    { id: 'chart', title: 'Trends', span: 2, content: <LineChart data={data} xKey="month" yKey="value" /> },
+    { id: 'table', span: 4, content: <DataTable columns={cols} data={rows} /> },
+  ]
+})
+```
+
+## Notas
+
+Factory pura — dado el mismo input siempre genera el mismo JSX. Un agente puede construir dashboards completos pasando widgets como configuración declarativa.
diff --git a/frontend/functions/ui/dashboard_layout.tsx b/frontend/functions/ui/dashboard_layout.tsx
new file mode 100644
index 00000000..a3d3b89e
--- /dev/null
+++ b/frontend/functions/ui/dashboard_layout.tsx
@@ -0,0 +1,67 @@
+import * as React from 'react'
+import { cn } from '../core/cn'
+
+interface DashboardWidget {
+  id: string
+  title?: string
+  span?: 1 | 2 | 3 | 4
+  rowSpan?: 1 | 2
+  content: React.ReactNode
+}
+
+interface DashboardLayoutProps {
+  widgets: DashboardWidget[]
+  columns?: 1 | 2 | 3 | 4
+  gap?: 'sm' | 'md' | 'lg'
+  className?: string
+}
+
+const gapClasses = { sm: 'gap-2', md: 'gap-4', lg: 'gap-6' }
+
+const spanClasses: Record<number, string> = {
+  1: 'col-span-1',
+  2: 'col-span-1 md:col-span-2',
+  3: 'col-span-1 md:col-span-2 lg:col-span-3',
+  4: 'col-span-1 md:col-span-2 lg:col-span-4',
+}
+
+const rowSpanClasses: Record<number, string> = {
+  1: 'row-span-1',
+  2: 'row-span-2',
+}
+
+export function dashboardLayout({
+  widgets,
+  columns = 4,
+  gap = 'md',
+  className,
+}: DashboardLayoutProps): React.ReactElement {
+  const gridCols: Record<number, string> = {
+    1: 'grid-cols-1',
+    2: 'grid-cols-1 md:grid-cols-2',
+    3: 'grid-cols-1 md:grid-cols-2 lg:grid-cols-3',
+    4: 'grid-cols-1 md:grid-cols-2 lg:grid-cols-4',
+  }
+
+  return (
+    <div className={cn('grid', gridCols[columns], gapClasses[gap], className)}>
+      {widgets.map((widget) => (
+        <div
+          key={widget.id}
+          className={cn(
+            'rounded-xl border bg-card p-4 text-card-foreground shadow-sm',
+            spanClasses[widget.span || 1],
+            rowSpanClasses[widget.rowSpan || 1]
+          )}
+        >
+          {widget.title && (
+            <h3 className="mb-3 text-sm font-medium text-muted-foreground">{widget.title}</h3>
+          )}
+          {widget.content}
+        </div>
+      ))}
+    </div>
+  )
+}
+
+export type { DashboardWidget, DashboardLayoutProps }
diff --git a/frontend/functions/ui/detail_page.md b/frontend/functions/ui/detail_page.md
new file mode 100644
index 00000000..3eb5c5bb
--- /dev/null
+++ b/frontend/functions/ui/detail_page.md
@@ -0,0 +1,54 @@
+---
+name: detail_page
+kind: function
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: pure
+signature: "detailPage(props: DetailPageProps): ReactElement"
+description: "Genera una página de detalle de entidad con header (avatar, badge, back), grid de campos, tabs con contadores y timeline de actividad."
+tags: [detail, page, entity, timeline, factory, composition, ui]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/detail_page.tsx"
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: ""
+---
+
+## Ejemplo
+
+```tsx
+detailPage({
+  title: 'John Doe',
+  subtitle: 'john@example.com',
+  badge: <Badge variant="success">Active</Badge>,
+  onBack: () => router.back(),
+  fields: [
+    { label: 'Role', value: 'Administrator' },
+    { label: 'Created', value: 'Mar 15, 2026' },
+    { label: 'Bio', value: 'Full stack developer...', span: 2 },
+  ],
+  tabs: [
+    { label: 'Projects', value: 'projects', count: 12, content: <ProjectList /> },
+    { label: 'Activity', value: 'activity', count: 48, content: <ActivityList /> },
+  ],
+  activeTab: 'projects',
+  timeline: [
+    { id: '1', title: 'Deployed v2.1', timestamp: '2 hours ago', variant: 'success' },
+    { id: '2', title: 'Updated settings', timestamp: 'Yesterday' },
+    { id: '3', title: 'Created project', timestamp: 'Mar 10, 2026' },
+  ],
+})
+```
+
+## Notas
+
+Factory completa para páginas de detalle. Combina header con back/avatar/badge, grid de metadata, tabs con badges de conteo, y timeline de actividad con variantes de color semántico.
diff --git a/frontend/functions/ui/detail_page.tsx b/frontend/functions/ui/detail_page.tsx
new file mode 100644
index 00000000..86bae0d4
--- /dev/null
+++ b/frontend/functions/ui/detail_page.tsx
@@ -0,0 +1,134 @@
+import * as React from 'react'
+import { cn } from '../core/cn'
+
+interface DetailField {
+  label: string
+  value: React.ReactNode
+  span?: 1 | 2
+}
+
+interface DetailTab {
+  label: string
+  value: string
+  content: React.ReactNode
+  count?: number
+}
+
+interface TimelineEvent {
+  id: string
+  title: string
+  description?: string
+  timestamp: string
+  icon?: React.ReactNode
+  variant?: 'default' | 'success' | 'warning' | 'error'
+}
+
+interface DetailPageProps {
+  title: string
+  subtitle?: string
+  badge?: React.ReactNode
+  avatar?: React.ReactNode
+  actions?: React.ReactNode
+  onBack?: () => void
+  fields: DetailField[]
+  tabs?: DetailTab[]
+  activeTab?: string
+  onTabChange?: (value: string) => void
+  timeline?: TimelineEvent[]
+  className?: string
+}
+
+const variantDotColors = {
+  default: 'bg-primary',
+  success: 'bg-green-500',
+  warning: 'bg-amber-500',
+  error: 'bg-red-500',
+}
+
+export function detailPage({
+  title, subtitle, badge, avatar, actions, onBack,
+  fields, tabs, activeTab, onTabChange, timeline, className,
+}: DetailPageProps): React.ReactElement {
+  return (
+    <div className={cn('space-y-6', className)}>
+      {/* Header */}
+      <div className="flex items-start justify-between border-b pb-4">
+        <div className="flex items-start gap-4">
+          {onBack && (
+            <button onClick={onBack} className="mt-1 inline-flex size-7 shrink-0 items-center justify-center rounded-md hover:bg-muted">
+              <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2"><path d="m15 18-6-6 6-6"/></svg>
+            </button>
+          )}
+          {avatar && <div className="size-12 shrink-0 overflow-hidden rounded-full bg-muted">{avatar}</div>}
+          <div className="space-y-1">
+            <div className="flex items-center gap-3">
+              <h1 className="text-2xl font-semibold tracking-tight">{title}</h1>
+              {badge}
+            </div>
+            {subtitle && <p className="text-sm text-muted-foreground">{subtitle}</p>}
+          </div>
+        </div>
+        {actions && <div className="flex items-center gap-2">{actions}</div>}
+      </div>
+
+      {/* Fields grid */}
+      <div className="grid grid-cols-1 gap-4 md:grid-cols-2">
+        {fields.map((field, i) => (
+          <div key={i} className={cn('space-y-1', field.span === 2 && 'md:col-span-2')}>
+            <p className="text-sm text-muted-foreground">{field.label}</p>
+            <div className="text-sm font-medium">{field.value}</div>
+          </div>
+        ))}
+      </div>
+
+      {/* Tabs */}
+      {tabs && tabs.length > 0 && (
+        <div className="space-y-4">
+          <nav className="flex gap-4 border-b">
+            {tabs.map((tab) => (
+              <button
+                key={tab.value}
+                type="button"
+                onClick={() => onTabChange?.(tab.value)}
+                className={cn(
+                  'inline-flex items-center gap-2 border-b-2 px-1 pb-3 text-sm font-medium transition-colors',
+                  activeTab === tab.value ? 'border-primary text-foreground' : 'border-transparent text-muted-foreground hover:text-foreground'
+                )}
+              >
+                {tab.label}
+                {tab.count !== undefined && (
+                  <span className="inline-flex h-5 items-center rounded-full bg-muted px-2 text-xs font-medium">{tab.count}</span>
+                )}
+              </button>
+            ))}
+          </nav>
+          {tabs.find(t => t.value === activeTab)?.content}
+        </div>
+      )}
+
+      {/* Timeline */}
+      {timeline && timeline.length > 0 && (
+        <div className="space-y-3">
+          <h3 className="text-sm font-medium text-muted-foreground">Activity</h3>
+          <div className="space-y-0">
+            {timeline.map((event, i) => (
+              <div key={event.id} className="flex gap-3 pb-4">
+                <div className="flex flex-col items-center">
+                  <div className={cn('mt-1 size-2.5 rounded-full', variantDotColors[event.variant || 'default'])} />
+                  {i < timeline.length - 1 && <div className="flex-1 w-px bg-border" />}
+                </div>
+                <div className="flex-1 space-y-0.5 pb-2">
+                  <p className="text-sm font-medium">{event.title}</p>
+                  {event.description && <p className="text-xs text-muted-foreground">{event.description}</p>}
+                  <p className="text-xs text-muted-foreground/70">{event.timestamp}</p>
+                </div>
+              </div>
+            ))}
+          </div>
+        </div>
+      )}
+    </div>
+  )
+}
+
+export type { DetailPageProps, DetailField, DetailTab, TimelineEvent }
diff --git a/frontend/functions/ui/dialog.md b/frontend/functions/ui/dialog.md
new file mode 100644
index 00000000..f4cf5991
--- /dev/null
+++ b/frontend/functions/ui/dialog.md
@@ -0,0 +1,55 @@
+---
+name: dialog
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "Dialog(props: DialogRootProps): JSX.Element"
+description: "Diálogo modal accesible con overlay blur, animaciones, close button y sistema de slots (header, footer, title, description)."
+tags: [dialog, modal, overlay, component, ui, interactive]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: ["@base-ui/react", lucide-react, react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/dialog.tsx"
+props:
+  - name: showCloseButton
+    type: "boolean"
+    required: false
+    description: "Mostrar botón de cerrar (default true)"
+emits: [onOpenChange]
+has_state: true
+framework: react
+variant: [default]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/dialog.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<Dialog>
+  <DialogTrigger asChild><Button>Open</Button></DialogTrigger>
+  <DialogContent>
+    <DialogHeader>
+      <DialogTitle>Título</DialogTitle>
+      <DialogDescription>Descripción</DialogDescription>
+    </DialogHeader>
+    <p>Contenido</p>
+    <DialogFooter>
+      <Button>Confirmar</Button>
+    </DialogFooter>
+  </DialogContent>
+</Dialog>
+```
+
+## Notas
+
+10 subcomponentes exportados. Base-UI Dialog primitive para accesibilidad completa (focus trap, escape, click outside).
diff --git a/frontend/functions/ui/dialog.tsx b/frontend/functions/ui/dialog.tsx
new file mode 100644
index 00000000..77c7d8fa
--- /dev/null
+++ b/frontend/functions/ui/dialog.tsx
@@ -0,0 +1,73 @@
+import * as React from "react"
+import { Dialog as DialogPrimitive } from "@base-ui/react/dialog"
+import { cn } from "../core/cn"
+import { XIcon } from "lucide-react"
+
+function Dialog({ ...props }: DialogPrimitive.Root.Props) {
+  return <DialogPrimitive.Root data-slot="dialog" {...props} />
+}
+
+function DialogTrigger({ ...props }: DialogPrimitive.Trigger.Props) {
+  return <DialogPrimitive.Trigger data-slot="dialog-trigger" {...props} />
+}
+
+function DialogPortal({ ...props }: DialogPrimitive.Portal.Props) {
+  return <DialogPrimitive.Portal data-slot="dialog-portal" {...props} />
+}
+
+function DialogClose({ ...props }: DialogPrimitive.Close.Props) {
+  return <DialogPrimitive.Close data-slot="dialog-close" {...props} />
+}
+
+function DialogOverlay({ className, ...props }: DialogPrimitive.Backdrop.Props) {
+  return (
+    <DialogPrimitive.Backdrop
+      data-slot="dialog-overlay"
+      className={cn("fixed inset-0 isolate z-50 bg-black/10 duration-100 supports-backdrop-filter:backdrop-blur-xs data-open:animate-in data-open:fade-in-0 data-closed:animate-out data-closed:fade-out-0", className)}
+      {...props}
+    />
+  )
+}
+
+function DialogContent({ className, children, showCloseButton = true, ...props }: DialogPrimitive.Popup.Props & { showCloseButton?: boolean }) {
+  return (
+    <DialogPortal>
+      <DialogOverlay />
+      <DialogPrimitive.Popup
+        data-slot="dialog-content"
+        className={cn("fixed top-1/2 left-1/2 z-50 grid w-full max-w-[calc(100%-2rem)] -translate-x-1/2 -translate-y-1/2 gap-4 rounded-xl bg-background p-4 text-sm ring-1 ring-foreground/10 duration-100 outline-none sm:max-w-sm data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95", className)}
+        {...props}
+      >
+        {children}
+        {showCloseButton && (
+          <DialogPrimitive.Close data-slot="dialog-close" className="absolute top-2 right-2 inline-flex size-7 items-center justify-center rounded-md hover:bg-muted">
+            <XIcon className="size-4" />
+            <span className="sr-only">Close</span>
+          </DialogPrimitive.Close>
+        )}
+      </DialogPrimitive.Popup>
+    </DialogPortal>
+  )
+}
+
+function DialogHeader({ className, ...props }: React.ComponentProps<"div">) {
+  return <div data-slot="dialog-header" className={cn("flex flex-col gap-2", className)} {...props} />
+}
+
+function DialogFooter({ className, children, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div data-slot="dialog-footer" className={cn("-mx-4 -mb-4 flex flex-col-reverse gap-2 rounded-b-xl border-t bg-muted/50 p-4 sm:flex-row sm:justify-end", className)} {...props}>
+      {children}
+    </div>
+  )
+}
+
+function DialogTitle({ className, ...props }: DialogPrimitive.Title.Props) {
+  return <DialogPrimitive.Title data-slot="dialog-title" className={cn("text-base leading-none font-medium", className)} {...props} />
+}
+
+function DialogDescription({ className, ...props }: DialogPrimitive.Description.Props) {
+  return <DialogPrimitive.Description data-slot="dialog-description" className={cn("text-sm text-muted-foreground", className)} {...props} />
+}
+
+export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger }
diff --git a/frontend/functions/ui/form_field.md b/frontend/functions/ui/form_field.md
new file mode 100644
index 00000000..81035466
--- /dev/null
+++ b/frontend/functions/ui/form_field.md
@@ -0,0 +1,53 @@
+---
+name: form_field
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "FormField(props: FormFieldProps): JSX.Element"
+description: "Wrapper de campo de formulario con label, helper text, error y ARIA automáticos. Inyecta id y aria-describedby a hijos."
+tags: [form, field, label, error, component, ui, accessibility]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/form_field.tsx"
+props:
+  - name: label
+    type: "string"
+    required: false
+    description: "Texto del label"
+  - name: helperText
+    type: "string"
+    required: false
+    description: "Texto de ayuda"
+  - name: error
+    type: "string"
+    required: false
+    description: "Mensaje de error (reemplaza helperText)"
+  - name: children
+    type: "ReactNode"
+    required: true
+    description: "Input o componente de formulario"
+emits: []
+has_state: false
+framework: react
+variant: [default]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/form-field.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<FormField label="Email" helperText="Tu email corporativo" error={errors.email}>
+  <Input type="email" />
+</FormField>
+```
diff --git a/frontend/functions/ui/form_field.tsx b/frontend/functions/ui/form_field.tsx
new file mode 100644
index 00000000..d238aa43
--- /dev/null
+++ b/frontend/functions/ui/form_field.tsx
@@ -0,0 +1,42 @@
+import * as React from "react"
+import { cn } from "../core/cn"
+
+interface FormFieldProps {
+  label?: string
+  helperText?: string
+  error?: string
+  children: React.ReactNode
+  className?: string
+}
+
+function FormField({ label, helperText, error, children, className }: FormFieldProps) {
+  const id = React.useId()
+  const inputId = `${id}-input`
+  const helperId = `${id}-helper`
+  const errorId = `${id}-error`
+
+  const describedBy = [helperText ? helperId : null, error ? errorId : null].filter(Boolean).join(" ") || undefined
+
+  const childWithProps = React.Children.map(children, (child) => {
+    if (React.isValidElement(child)) {
+      return React.cloneElement(child as React.ReactElement<Record<string, unknown>>, {
+        id: inputId,
+        "aria-invalid": error ? true : undefined,
+        "aria-describedby": describedBy,
+      })
+    }
+    return child
+  })
+
+  return (
+    <div className={cn("flex flex-col gap-1.5", className)}>
+      {label && <label htmlFor={inputId} className="text-sm font-medium text-foreground">{label}</label>}
+      {childWithProps}
+      {helperText && !error && <p id={helperId} className="text-sm text-muted-foreground">{helperText}</p>}
+      {error && <p id={errorId} className="text-sm text-destructive">{error}</p>}
+    </div>
+  )
+}
+
+export { FormField }
+export type { FormFieldProps }
diff --git a/frontend/functions/ui/input.md b/frontend/functions/ui/input.md
new file mode 100644
index 00000000..10dbe0f9
--- /dev/null
+++ b/frontend/functions/ui/input.md
@@ -0,0 +1,51 @@
+---
+name: input
+kind: component
+lang: ts
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "Input(props: InputHTMLAttributes): JSX.Element"
+description: "Campo de entrada accesible con soporte para iconos, grupos, validación ARIA y estados disabled/invalid."
+tags: [input, form, component, ui, interactive]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: ["@base-ui/react", "react"]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/input.tsx"
+props:
+  - name: type
+    type: "string"
+    required: false
+    description: "Tipo de input HTML"
+  - name: className
+    type: "string"
+    required: false
+    description: "Clases CSS adicionales"
+emits: [onChange, onFocus, onBlur]
+has_state: false
+framework: react
+variant: [default]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/input.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<Input placeholder="Email" type="email" />
+<InputGroup>
+  <InputIcon position="start"><SearchIcon /></InputIcon>
+  <Input placeholder="Buscar..." />
+</InputGroup>
+```
+
+## Notas
+
+Exporta Input, InputGroup e InputIcon. InputGroup detecta automáticamente la presencia de iconos y ajusta padding del Input.
diff --git a/frontend/functions/ui/input.tsx b/frontend/functions/ui/input.tsx
new file mode 100644
index 00000000..e5168797
--- /dev/null
+++ b/frontend/functions/ui/input.tsx
@@ -0,0 +1,56 @@
+import * as React from "react"
+import { Input as InputPrimitive } from "@base-ui/react/input"
+import { cn } from "../core/cn"
+
+function Input({ className, type, ...props }: React.ComponentProps<"input">) {
+  return (
+    <InputPrimitive
+      type={type}
+      data-slot="input"
+      className={cn(
+        "h-8 w-full min-w-0 rounded-lg border border-input bg-transparent px-2.5 py-1 text-base transition-colors outline-none file:inline-flex file:h-6 file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-foreground placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:pointer-events-none disabled:cursor-not-allowed disabled:bg-input/50 disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 md:text-sm dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40",
+        "group-has-[data-slot=input-icon-start]/input-group:pl-9",
+        "group-has-[data-slot=input-icon-end]/input-group:pr-9",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+interface InputGroupProps {
+  children: React.ReactNode
+  className?: string
+}
+
+function InputGroup({ children, className }: InputGroupProps) {
+  return (
+    <div data-slot="input-group" className={cn("group/input-group relative", className)}>
+      {children}
+    </div>
+  )
+}
+
+interface InputIconProps {
+  children: React.ReactNode
+  position: "start" | "end"
+  className?: string
+}
+
+function InputIcon({ children, position, className }: InputIconProps) {
+  return (
+    <span
+      data-slot={`input-icon-${position}`}
+      className={cn(
+        "pointer-events-none absolute top-1/2 -translate-y-1/2 text-muted-foreground [&_svg]:size-4",
+        position === "start" && "left-2.5",
+        position === "end" && "right-2.5",
+        className
+      )}
+    >
+      {children}
+    </span>
+  )
+}
+
+export { Input, InputGroup, InputIcon }
diff --git a/frontend/functions/ui/kpi_card.md b/frontend/functions/ui/kpi_card.md
new file mode 100644
index 00000000..b22b2965
--- /dev/null
+++ b/frontend/functions/ui/kpi_card.md
@@ -0,0 +1,56 @@
+---
+name: kpi_card
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "KPICard(props: KPICardProps): JSX.Element"
+description: "Card de KPI con label, valor, delta porcentual con color semántico, icono y subtítulo. 3 tamaños."
+tags: [kpi, card, metrics, dashboard, component, ui]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/kpi_card.tsx"
+props:
+  - name: label
+    type: "string"
+    required: true
+    description: "Etiqueta del KPI"
+  - name: value
+    type: "string | number"
+    required: true
+    description: "Valor principal"
+  - name: delta
+    type: "{ value: number; isPositive: boolean }"
+    required: false
+    description: "Cambio porcentual con dirección"
+  - name: icon
+    type: "ReactNode"
+    required: false
+    description: "Icono decorativo"
+  - name: size
+    type: "'sm' | 'default' | 'lg'"
+    required: false
+    description: "Tamaño"
+emits: []
+has_state: false
+framework: react
+variant: [sm, default, lg]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/kpi-card.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<KPICard label="Revenue" value="$12,450" delta={{ value: 12.5, isPositive: true }} />
+<KPICard label="Users" value={1234} size="lg" icon={<UsersIcon />} />
+```
diff --git a/frontend/functions/ui/kpi_card.tsx b/frontend/functions/ui/kpi_card.tsx
new file mode 100644
index 00000000..d45a50b8
--- /dev/null
+++ b/frontend/functions/ui/kpi_card.tsx
@@ -0,0 +1,60 @@
+import * as React from 'react'
+import { cn } from '../core/cn'
+
+type KPICardSize = 'sm' | 'default' | 'lg'
+
+interface Delta {
+  value: number
+  isPositive: boolean
+}
+
+interface KPICardProps extends React.HTMLAttributes<HTMLDivElement> {
+  label: string
+  value: string | number
+  delta?: Delta
+  icon?: React.ReactNode
+  subtitle?: string
+  size?: KPICardSize
+}
+
+const sizeStyles: Record<KPICardSize, { value: string; label: string }> = {
+  sm: { value: 'text-2xl font-bold', label: 'text-xs' },
+  default: { value: 'text-3xl font-bold', label: 'text-sm' },
+  lg: { value: 'text-4xl font-bold', label: 'text-base' },
+}
+
+const KPICard = React.forwardRef<HTMLDivElement, KPICardProps>(
+  ({ label, value, delta, icon, subtitle, size = 'default', className, ...props }, ref) => {
+    const styles = sizeStyles[size]
+    const deltaColor = delta
+      ? delta.value === 0 ? 'text-muted-foreground'
+        : delta.isPositive ? 'text-green-600 dark:text-green-500'
+        : 'text-red-600 dark:text-red-500'
+      : ''
+
+    return (
+      <div ref={ref} className={cn('rounded-lg border bg-card p-4 text-card-foreground shadow-sm', className)} {...props}>
+        <div className="flex items-start justify-between">
+          <div className="space-y-1">
+            <p className={cn('text-muted-foreground', styles.label)}>{label}</p>
+            {subtitle && <p className="text-xs text-muted-foreground/80">{subtitle}</p>}
+          </div>
+          {icon && <div className="text-muted-foreground">{icon}</div>}
+        </div>
+        <div className="mt-3 flex items-end justify-between gap-4">
+          <div className="space-y-1">
+            <p className={cn('tracking-tight', styles.value)}>{value}</p>
+            {delta && (
+              <div className={cn('flex items-center gap-1 text-sm font-medium', deltaColor)}>
+                <span>{delta.value > 0 ? '+' : ''}{delta.value}%</span>
+              </div>
+            )}
+          </div>
+        </div>
+      </div>
+    )
+  }
+)
+KPICard.displayName = 'KPICard'
+
+export { KPICard, type KPICardProps, type Delta, type KPICardSize }
diff --git a/frontend/functions/ui/label.md b/frontend/functions/ui/label.md
new file mode 100644
index 00000000..73b31c7c
--- /dev/null
+++ b/frontend/functions/ui/label.md
@@ -0,0 +1,39 @@
+---
+name: label
+kind: component
+lang: ts
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "Label(props: LabelHTMLAttributes): JSX.Element"
+description: "Etiqueta de formulario accesible con soporte para estados disabled y peer-disabled."
+tags: [label, form, component, ui]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: ["react"]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/label.tsx"
+props:
+  - name: className
+    type: "string"
+    required: false
+    description: "Clases CSS adicionales"
+emits: []
+has_state: false
+framework: react
+variant: [default]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/label.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<Label htmlFor="email">Email</Label>
+```
diff --git a/frontend/functions/ui/label.tsx b/frontend/functions/ui/label.tsx
new file mode 100644
index 00000000..56bb58a6
--- /dev/null
+++ b/frontend/functions/ui/label.tsx
@@ -0,0 +1,17 @@
+import * as React from "react"
+import { cn } from "../core/cn"
+
+function Label({ className, ...props }: React.ComponentProps<"label">) {
+  return (
+    <label
+      data-slot="label"
+      className={cn(
+        "flex items-center gap-2 text-sm leading-none font-medium select-none group-data-[disabled=true]:pointer-events-none group-data-[disabled=true]:opacity-50 peer-disabled:cursor-not-allowed peer-disabled:opacity-50",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export { Label }
diff --git a/frontend/functions/ui/line_chart.md b/frontend/functions/ui/line_chart.md
new file mode 100644
index 00000000..d71e6923
--- /dev/null
+++ b/frontend/functions/ui/line_chart.md
@@ -0,0 +1,68 @@
+---
+name: line_chart
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "LineChart(props: LineChartProps): JSX.Element"
+description: "Gráfico de líneas Recharts con multi-series, 5 tipos de curva, zoom brush, líneas de referencia, tooltips temáticos."
+tags: [chart, line, visualization, recharts, component, ui]
+uses_functions: [cn_typescript_core, chart_container_typescript_ui, get_series_color_typescript_core]
+uses_types: [ChartSeries_typescript_ui]
+returns: []
+returns_optional: false
+error_type: ""
+imports: [recharts]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/line_chart.tsx"
+props:
+  - name: data
+    type: "Record<string, unknown>[]"
+    required: true
+    description: "Array de datos"
+  - name: xKey
+    type: "string"
+    required: true
+    description: "Key del eje X"
+  - name: series
+    type: "Series[]"
+    required: false
+    description: "Series de datos"
+  - name: zoomable
+    type: "boolean"
+    required: false
+    description: "Habilitar zoom brush"
+  - name: curveType
+    type: "'linear' | 'monotone' | 'step' | 'stepBefore' | 'stepAfter'"
+    required: false
+    description: "Tipo de curva (default monotone)"
+  - name: referenceLines
+    type: "Array<{ y: number; label?: string; color?: string }>"
+    required: false
+    description: "Líneas de referencia horizontales"
+emits: []
+has_state: false
+framework: react
+variant: [default]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/charts/line-chart.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<LineChart
+  data={salesData}
+  xKey="month"
+  series={[
+    { key: "revenue", name: "Revenue", color: "#3b82f6" },
+    { key: "cost", name: "Cost", color: "#ef4444" },
+  ]}
+  zoomable
+  showLegend
+/>
+```
diff --git a/frontend/functions/ui/line_chart.tsx b/frontend/functions/ui/line_chart.tsx
new file mode 100644
index 00000000..773e862c
--- /dev/null
+++ b/frontend/functions/ui/line_chart.tsx
@@ -0,0 +1,57 @@
+import {
+  LineChart as RechartsLineChart, Line, XAxis, YAxis, CartesianGrid,
+  Tooltip, Legend, Brush, ReferenceLine,
+} from 'recharts'
+import { ChartContainer, ChartTooltipContent, type Series, getSeriesColor } from './chart_container'
+
+type CurveType = 'linear' | 'monotone' | 'step' | 'stepBefore' | 'stepAfter'
+
+interface LineChartProps {
+  data: Record<string, unknown>[]
+  xKey: string
+  yKey?: string
+  series?: Series[]
+  curveType?: CurveType
+  showGrid?: boolean
+  showLegend?: boolean
+  showDots?: boolean
+  zoomable?: boolean
+  height?: number | string
+  className?: string
+  xAxisFormatter?: (value: unknown) => string
+  yAxisFormatter?: (value: unknown) => string
+  valueFormatter?: (value: number) => string
+  referenceLines?: Array<{ y: number; label?: string; color?: string }>
+}
+
+function LineChartComponent({
+  data, xKey, yKey, series, curveType = 'monotone', showGrid = true, showLegend = false,
+  showDots = true, zoomable = false, height = 300, className, xAxisFormatter, yAxisFormatter,
+  valueFormatter = (v) => v.toLocaleString(), referenceLines = [],
+}: LineChartProps) {
+  const lines = series
+    ? series.map((s, i) => ({ dataKey: s.key, name: s.name, stroke: getSeriesColor(i, s.color) }))
+    : yKey ? [{ dataKey: yKey, name: yKey, stroke: getSeriesColor(0) }] : []
+
+  return (
+    <ChartContainer className={className} height={height}>
+      <RechartsLineChart data={data} margin={{ top: 10, right: 10, left: 10, bottom: zoomable ? 30 : 10 }}>
+        {showGrid && <CartesianGrid strokeDasharray="3 3" className="stroke-muted" />}
+        <XAxis dataKey={xKey} tickFormatter={xAxisFormatter} className="text-xs fill-muted-foreground" />
+        <YAxis tickFormatter={yAxisFormatter} className="text-xs fill-muted-foreground" />
+        <Tooltip content={<ChartTooltipContent valueFormatter={valueFormatter} />} cursor={{ stroke: 'hsl(var(--muted-foreground))', strokeDasharray: '3 3' }} />
+        {showLegend && <Legend />}
+        {referenceLines.map((ref, i) => (
+          <ReferenceLine key={i} y={ref.y} stroke={ref.color || 'hsl(var(--muted-foreground))'} strokeDasharray="3 3" label={ref.label ? { value: ref.label, position: 'right' } : undefined} />
+        ))}
+        {lines.map((line) => (
+          <Line key={line.dataKey} type={curveType} dataKey={line.dataKey} name={line.name} stroke={line.stroke} strokeWidth={2} dot={showDots ? { r: 3, fill: line.stroke } : false} activeDot={{ r: 5, fill: line.stroke }} />
+        ))}
+        {zoomable && <Brush dataKey={xKey} height={20} stroke="hsl(var(--primary))" fill="hsl(var(--muted))" tickFormatter={xAxisFormatter} />}
+      </RechartsLineChart>
+    </ChartContainer>
+  )
+}
+
+export const LineChart = LineChartComponent
+export type { LineChartProps, CurveType }
diff --git a/frontend/functions/ui/page_header.md b/frontend/functions/ui/page_header.md
new file mode 100644
index 00000000..5036587f
--- /dev/null
+++ b/frontend/functions/ui/page_header.md
@@ -0,0 +1,62 @@
+---
+name: page_header
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "PageHeader(props: PageHeaderProps): JSX.Element"
+description: "Cabecera de página con título, subtítulo, acciones, back button, tabs integrados, badge y modo sticky. Incluye SimplePageHeader."
+tags: [header, page, layout, navigation, component, ui]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/page_header.tsx"
+props:
+  - name: title
+    type: "string"
+    required: true
+    description: "Título principal"
+  - name: subtitle
+    type: "string"
+    required: false
+    description: "Subtítulo"
+  - name: actions
+    type: "ReactNode"
+    required: false
+    description: "Botones de acción"
+  - name: tabs
+    type: "TabItem[]"
+    required: false
+    description: "Tabs de navegación integrados"
+  - name: sticky
+    type: "boolean"
+    required: false
+    description: "Header fijo al scroll"
+emits: [onBack, onTabChange]
+has_state: false
+framework: react
+variant: [full, simple]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/page-header.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<PageHeader
+  title="Dashboard"
+  subtitle="Vista general"
+  actions={<Button>Export</Button>}
+  tabs={[{ label: "Overview", value: "overview" }, { label: "Analytics", value: "analytics" }]}
+  activeTab="overview"
+  onTabChange={setTab}
+/>
+```
diff --git a/frontend/functions/ui/page_header.tsx b/frontend/functions/ui/page_header.tsx
new file mode 100644
index 00000000..926ee202
--- /dev/null
+++ b/frontend/functions/ui/page_header.tsx
@@ -0,0 +1,94 @@
+"use client"
+
+import * as React from "react"
+import { cn } from "../core/cn"
+
+interface TabItem {
+  label: string
+  value: string
+  icon?: React.ReactNode
+  disabled?: boolean
+}
+
+interface PageHeaderProps extends React.HTMLAttributes<HTMLDivElement> {
+  title: string
+  subtitle?: string
+  actions?: React.ReactNode
+  onBack?: () => void
+  tabs?: TabItem[]
+  activeTab?: string
+  onTabChange?: (value: string) => void
+  badge?: React.ReactNode
+  sticky?: boolean
+}
+
+function PageHeader({
+  title, subtitle, actions, onBack, tabs, activeTab, onTabChange,
+  badge, sticky = false, className, ...props
+}: PageHeaderProps) {
+  return (
+    <header
+      data-slot="page-header"
+      className={cn("space-y-4 border-b bg-background pb-4", sticky && "sticky top-0 z-20", className)}
+      {...props}
+    >
+      <div className="flex items-start justify-between gap-4">
+        <div className="flex items-start gap-3">
+          {onBack && (
+            <button onClick={onBack} className="mt-1 inline-flex size-7 shrink-0 items-center justify-center rounded-md hover:bg-muted">
+              <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2"><path d="m15 18-6-6 6-6"/></svg>
+            </button>
+          )}
+          <div className="space-y-1">
+            <div className="flex items-center gap-3">
+              <h1 className="text-2xl font-semibold tracking-tight">{title}</h1>
+              {badge}
+            </div>
+            {subtitle && <p className="text-sm text-muted-foreground">{subtitle}</p>}
+          </div>
+        </div>
+        {actions && <div className="flex shrink-0 items-center gap-2">{actions}</div>}
+      </div>
+      {tabs && tabs.length > 0 && (
+        <nav className="flex gap-4 border-b -mb-4 pb-0">
+          {tabs.map((tab) => (
+            <button
+              key={tab.value}
+              type="button"
+              disabled={tab.disabled}
+              onClick={() => onTabChange?.(tab.value)}
+              className={cn(
+                "inline-flex items-center gap-2 border-b-2 px-1 pb-3 text-sm font-medium transition-colors",
+                activeTab === tab.value ? "border-primary text-foreground" : "border-transparent text-muted-foreground hover:text-foreground",
+                tab.disabled && "pointer-events-none opacity-50"
+              )}
+            >
+              {tab.icon && <span className="size-4">{tab.icon}</span>}
+              {tab.label}
+            </button>
+          ))}
+        </nav>
+      )}
+    </header>
+  )
+}
+
+interface SimplePageHeaderProps extends React.HTMLAttributes<HTMLDivElement> {
+  title: string
+  description?: string
+  children?: React.ReactNode
+}
+
+function SimplePageHeader({ title, description, children, className, ...props }: SimplePageHeaderProps) {
+  return (
+    <div className={cn("flex items-center justify-between border-b pb-4", className)} {...props}>
+      <div className="space-y-1">
+        <h1 className="text-2xl font-semibold tracking-tight">{title}</h1>
+        {description && <p className="text-sm text-muted-foreground">{description}</p>}
+      </div>
+      {children && <div className="flex items-center gap-2">{children}</div>}
+    </div>
+  )
+}
+
+export { PageHeader, SimplePageHeader }
diff --git a/frontend/functions/ui/progress_bar.md b/frontend/functions/ui/progress_bar.md
new file mode 100644
index 00000000..ac33616f
--- /dev/null
+++ b/frontend/functions/ui/progress_bar.md
@@ -0,0 +1,81 @@
+---
+name: progress_bar
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "ProgressBar(props: ProgressBarProps): JSX.Element"
+description: "Barra de progreso con variantes de color y tamaño, buffer, animación, modo indeterminado y display de valor."
+tags: [progress, loading, component, ui, feedback]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [class-variance-authority]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/progress_bar.tsx"
+props:
+  - name: value
+    type: "number"
+    required: true
+    description: "Valor actual de progreso"
+  - name: max
+    type: "number"
+    required: false
+    description: "Valor máximo (default 100)"
+  - name: buffer
+    type: "number"
+    required: false
+    description: "Valor de buffer secundario (opcional)"
+  - name: showValue
+    type: "boolean"
+    required: false
+    description: "Mostrar porcentaje como texto superpuesto"
+  - name: animated
+    type: "boolean"
+    required: false
+    description: "Activar animación de rayas (stripes)"
+  - name: indeterminate
+    type: "boolean"
+    required: false
+    description: "Modo indeterminado sin valor conocido"
+  - name: size
+    type: "'sm' | 'md' | 'lg'"
+    required: false
+    description: "Altura de la barra (default md)"
+  - name: color
+    type: "'primary' | 'success' | 'warning' | 'destructive'"
+    required: false
+    description: "Color semántico (default primary)"
+  - name: label
+    type: "string"
+    required: false
+    description: "aria-label para accesibilidad"
+emits: []
+has_state: false
+framework: react
+variant: [primary, success, warning, destructive]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/progress/progress-bar.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<ProgressBar value={75} color="success" showValue />
+<ProgressBar value={0} indeterminate />
+<ProgressBar value={50} buffer={80} animated />
+<ProgressBar value={30} size="lg" color="warning" />
+```
+
+## Notas
+
+El porcentaje se clampea a [0, 100] internamente. El buffer se renderiza como capa semitransparente detrás del fill.
+Las animaciones de stripes e indeterminate requieren keyframes definidos en el CSS global:
+- `progress-stripes`: background-position de 0 a 1rem
+- `progress-indeterminate`: translateX de -100% a 300%
diff --git a/frontend/functions/ui/progress_bar.tsx b/frontend/functions/ui/progress_bar.tsx
new file mode 100644
index 00000000..09543328
--- /dev/null
+++ b/frontend/functions/ui/progress_bar.tsx
@@ -0,0 +1,68 @@
+import { cva, type VariantProps } from 'class-variance-authority'
+import { cn } from '../core/cn'
+
+const progressBarVariants = cva(
+  'relative w-full overflow-hidden rounded-full bg-muted',
+  {
+    variants: {
+      size: { sm: 'h-1', md: 'h-2', lg: 'h-3' },
+      color: {
+        primary: '[&_.progress-fill]:bg-primary',
+        success: '[&_.progress-fill]:bg-emerald-500',
+        warning: '[&_.progress-fill]:bg-amber-500',
+        destructive: '[&_.progress-fill]:bg-destructive',
+      },
+    },
+    defaultVariants: { size: 'md', color: 'primary' },
+  }
+)
+
+export interface ProgressBarProps extends VariantProps<typeof progressBarVariants> {
+  value: number
+  max?: number
+  buffer?: number
+  showValue?: boolean
+  animated?: boolean
+  indeterminate?: boolean
+  label?: string
+  className?: string
+}
+
+export function ProgressBar({
+  value, max = 100, buffer, showValue = false, animated = false,
+  indeterminate = false, size = 'md', color = 'primary', label, className,
+}: ProgressBarProps) {
+  const percentage = Math.min(100, Math.max(0, (value / max) * 100))
+  const bufferPercentage = buffer ? Math.min(100, Math.max(0, (buffer / max) * 100)) : undefined
+
+  return (
+    <div
+      data-slot="progress-bar"
+      role="progressbar"
+      aria-valuenow={indeterminate ? undefined : value}
+      aria-valuemin={0}
+      aria-valuemax={max}
+      aria-label={label}
+      className={cn(progressBarVariants({ size, color }), className)}
+    >
+      {bufferPercentage !== undefined && (
+        <div className="progress-buffer absolute inset-0 bg-current opacity-20 transition-all duration-300" style={{ width: `${bufferPercentage}%` }} />
+      )}
+      <div
+        className={cn(
+          'progress-fill h-full transition-all duration-300',
+          animated && 'bg-[length:1rem_1rem] bg-[linear-gradient(45deg,rgba(255,255,255,.15)_25%,transparent_25%,transparent_50%,rgba(255,255,255,.15)_50%,rgba(255,255,255,.15)_75%,transparent_75%,transparent)] animate-[progress-stripes_1s_linear_infinite]',
+          indeterminate && 'w-1/3 animate-[progress-indeterminate_1.5s_ease-in-out_infinite]'
+        )}
+        style={indeterminate ? undefined : { width: `${percentage}%` }}
+      />
+      {showValue && !indeterminate && (
+        <span className="absolute inset-0 flex items-center justify-center text-[10px] font-medium text-foreground mix-blend-difference">
+          {Math.round(percentage)}%
+        </span>
+      )}
+    </div>
+  )
+}
+
+export { progressBarVariants }
diff --git a/frontend/functions/ui/select.md b/frontend/functions/ui/select.md
new file mode 100644
index 00000000..2fbd3478
--- /dev/null
+++ b/frontend/functions/ui/select.md
@@ -0,0 +1,68 @@
+---
+name: select
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "Select<T>(props: SelectRootProps<T>): JSX.Element"
+description: "Select genérico accesible con grupos, separadores y animaciones. Base-UI primitive con posicionamiento automático."
+tags: [select, form, dropdown, component, ui, interactive]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: ["@base-ui/react", lucide-react, react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/select.tsx"
+props:
+  - name: value
+    type: "T"
+    required: false
+    description: "Valor seleccionado (controlled)"
+  - name: onValueChange
+    type: "(value: T) => void"
+    required: false
+    description: "Callback al cambiar selección"
+  - name: defaultValue
+    type: "T"
+    required: false
+    description: "Valor inicial (uncontrolled)"
+  - name: disabled
+    type: "boolean"
+    required: false
+    description: "Deshabilitar el select"
+emits: [onValueChange]
+has_state: true
+framework: react
+variant: [default]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/select.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<Select>
+  <SelectTrigger><SelectValue placeholder="Elegir..." /></SelectTrigger>
+  <SelectContent>
+    <SelectGroup>
+      <SelectGroupLabel>Frutas</SelectGroupLabel>
+      <SelectItem value="apple">Manzana</SelectItem>
+      <SelectItem value="banana">Banana</SelectItem>
+    </SelectGroup>
+    <SelectSeparator />
+    <SelectItem value="other">Otro</SelectItem>
+  </SelectContent>
+</Select>
+```
+
+## Notas
+
+Exporta 9 subcomponentes composables: Select, SelectTrigger, SelectValue, SelectPortal, SelectContent, SelectGroup, SelectGroupLabel, SelectItem, SelectSeparator.
+Genérico sobre el tipo de valor T — TypeScript infiere el tipo desde el prop value/defaultValue.
+Depende de @base-ui/react y lucide-react.
diff --git a/frontend/functions/ui/select.tsx b/frontend/functions/ui/select.tsx
new file mode 100644
index 00000000..b6ac1698
--- /dev/null
+++ b/frontend/functions/ui/select.tsx
@@ -0,0 +1,88 @@
+"use client"
+
+import * as React from "react"
+import { Select as SelectPrimitive } from "@base-ui/react/select"
+import { ChevronDown, Check } from "lucide-react"
+import { cn } from "../core/cn"
+
+function Select<T>({ ...props }: SelectPrimitive.Root.Props<T>) {
+  return <SelectPrimitive.Root data-slot="select" {...props} />
+}
+
+function SelectValue({ ...props }: SelectPrimitive.Value.Props) {
+  return <SelectPrimitive.Value data-slot="select-value" {...props} />
+}
+
+function SelectTrigger({ className, children, ...props }: SelectPrimitive.Trigger.Props) {
+  return (
+    <SelectPrimitive.Trigger
+      data-slot="select-trigger"
+      className={cn(
+        "flex h-8 w-full items-center justify-between gap-2 rounded-lg border border-input bg-transparent px-2.5 py-1 text-sm transition-colors outline-none placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 [&>span]:line-clamp-1",
+        className
+      )}
+      {...props}
+    >
+      {children}
+      <SelectPrimitive.Icon>
+        <ChevronDown className="size-4 shrink-0 text-muted-foreground" />
+      </SelectPrimitive.Icon>
+    </SelectPrimitive.Trigger>
+  )
+}
+
+function SelectPortal({ ...props }: SelectPrimitive.Portal.Props) {
+  return <SelectPrimitive.Portal data-slot="select-portal" {...props} />
+}
+
+function SelectContent({ className, children, ...props }: SelectPrimitive.Positioner.Props) {
+  return (
+    <SelectPortal>
+      <SelectPrimitive.Positioner
+        data-slot="select-content"
+        className={cn(
+          "relative z-50 max-h-[300px] min-w-[8rem] overflow-hidden rounded-lg border bg-popover text-popover-foreground shadow-md",
+          "data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95",
+          "data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95",
+          className
+        )}
+        sideOffset={4}
+        {...props}
+      >
+        <SelectPrimitive.Popup className="w-full p-1">{children}</SelectPrimitive.Popup>
+      </SelectPrimitive.Positioner>
+    </SelectPortal>
+  )
+}
+
+function SelectGroup({ ...props }: SelectPrimitive.Group.Props) {
+  return <SelectPrimitive.Group data-slot="select-group" {...props} />
+}
+
+function SelectGroupLabel({ className, ...props }: SelectPrimitive.GroupLabel.Props) {
+  return <SelectPrimitive.GroupLabel data-slot="select-group-label" className={cn("px-2 py-1.5 text-xs font-medium text-muted-foreground", className)} {...props} />
+}
+
+function SelectItem({ className, children, ...props }: SelectPrimitive.Item.Props) {
+  return (
+    <SelectPrimitive.Item
+      data-slot="select-item"
+      className={cn(
+        "relative flex w-full cursor-default select-none items-center rounded-md py-1.5 pl-8 pr-2 text-sm outline-none focus:bg-accent focus:text-accent-foreground data-disabled:pointer-events-none data-disabled:opacity-50",
+        className
+      )}
+      {...props}
+    >
+      <span className="absolute left-2 flex size-4 items-center justify-center">
+        <SelectPrimitive.ItemIndicator><Check className="size-4" /></SelectPrimitive.ItemIndicator>
+      </span>
+      <SelectPrimitive.ItemText>{children}</SelectPrimitive.ItemText>
+    </SelectPrimitive.Item>
+  )
+}
+
+function SelectSeparator({ className, ...props }: React.ComponentProps<"div">) {
+  return <div data-slot="select-separator" className={cn("-mx-1 my-1 h-px bg-muted", className)} {...props} />
+}
+
+export { Select, SelectContent, SelectGroup, SelectGroupLabel, SelectItem, SelectPortal, SelectSeparator, SelectTrigger, SelectValue }
diff --git a/frontend/functions/ui/settings_page.md b/frontend/functions/ui/settings_page.md
new file mode 100644
index 00000000..11d29677
--- /dev/null
+++ b/frontend/functions/ui/settings_page.md
@@ -0,0 +1,57 @@
+---
+name: settings_page
+kind: function
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: pure
+signature: "settingsPage(props: SettingsPageProps): ReactElement"
+description: "Genera una página de configuración con navegación lateral, secciones y campos de formulario (text, number, toggle, select, textarea)."
+tags: [settings, page, form, sections, factory, composition, ui]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/settings_page.tsx"
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: ""
+---
+
+## Ejemplo
+
+```tsx
+settingsPage({
+  title: 'Project Settings',
+  sections: [
+    {
+      id: 'general',
+      title: 'General',
+      description: 'Basic project configuration',
+      fields: [
+        { key: 'name', label: 'Project Name', type: 'text', value: 'My Project' },
+        { key: 'visibility', label: 'Public', description: 'Make project visible to everyone', type: 'toggle', value: true },
+        { key: 'language', label: 'Language', type: 'select', options: [{ label: 'English', value: 'en' }, { label: 'Spanish', value: 'es' }] },
+      ],
+    },
+    {
+      id: 'notifications',
+      title: 'Notifications',
+      fields: [
+        { key: 'email', label: 'Email notifications', type: 'toggle', value: false },
+        { key: 'webhook', label: 'Webhook URL', type: 'text', placeholder: 'https://...' },
+      ],
+    },
+  ],
+  onSave: handleSave,
+})
+```
+
+## Notas
+
+Layout de settings estándar con sidebar de navegación (oculta en mobile). Secciones con anclas para scroll. Soporta 5 tipos de campo.
diff --git a/frontend/functions/ui/settings_page.tsx b/frontend/functions/ui/settings_page.tsx
new file mode 100644
index 00000000..3115c945
--- /dev/null
+++ b/frontend/functions/ui/settings_page.tsx
@@ -0,0 +1,112 @@
+import * as React from 'react'
+import { cn } from '../core/cn'
+
+interface SettingField {
+  key: string
+  label: string
+  description?: string
+  type: 'text' | 'number' | 'toggle' | 'select' | 'textarea'
+  value?: unknown
+  options?: Array<{ label: string; value: string }>
+  placeholder?: string
+}
+
+interface SettingSection {
+  id: string
+  title: string
+  description?: string
+  fields: SettingField[]
+}
+
+interface SettingsPageProps {
+  title?: string
+  subtitle?: string
+  sections: SettingSection[]
+  onSave?: (values: Record<string, unknown>) => void
+  className?: string
+}
+
+export function settingsPage({
+  title = 'Settings',
+  subtitle,
+  sections,
+  onSave,
+  className,
+}: SettingsPageProps): React.ReactElement {
+  return (
+    <div className={cn('space-y-6', className)}>
+      {/* Header */}
+      <div className="border-b pb-4">
+        <h1 className="text-2xl font-semibold tracking-tight">{title}</h1>
+        {subtitle && <p className="text-sm text-muted-foreground">{subtitle}</p>}
+      </div>
+
+      {/* Tabs navigation */}
+      <div className="flex gap-6">
+        <nav className="hidden w-48 shrink-0 md:block">
+          <div className="space-y-1">
+            {sections.map((section) => (
+              <a
+                key={section.id}
+                href={`#${section.id}`}
+                className="block rounded-md px-3 py-2 text-sm font-medium text-muted-foreground hover:bg-muted hover:text-foreground"
+              >
+                {section.title}
+              </a>
+            ))}
+          </div>
+        </nav>
+
+        {/* Sections */}
+        <div className="flex-1 space-y-8">
+          {sections.map((section) => (
+            <div key={section.id} id={section.id} className="space-y-4">
+              <div>
+                <h2 className="text-lg font-medium">{section.title}</h2>
+                {section.description && <p className="text-sm text-muted-foreground">{section.description}</p>}
+              </div>
+              <div className="space-y-4 rounded-lg border p-4">
+                {section.fields.map((field) => (
+                  <div key={field.key} className="flex flex-col gap-1.5 sm:flex-row sm:items-center sm:justify-between">
+                    <div className="space-y-0.5">
+                      <label className="text-sm font-medium">{field.label}</label>
+                      {field.description && <p className="text-xs text-muted-foreground">{field.description}</p>}
+                    </div>
+                    <div className="w-full sm:w-64">
+                      {field.type === 'toggle' ? (
+                        <button className={cn(
+                          'relative inline-flex h-5 w-9 shrink-0 cursor-pointer rounded-full border-2 border-transparent transition-colors',
+                          field.value ? 'bg-primary' : 'bg-input'
+                        )}>
+                          <span className={cn('pointer-events-none block size-4 rounded-full bg-background shadow-lg ring-0 transition-transform', field.value ? 'translate-x-4' : 'translate-x-0')} />
+                        </button>
+                      ) : field.type === 'select' ? (
+                        <select className="h-8 w-full rounded-lg border border-input bg-transparent px-2.5 text-sm">
+                          {field.options?.map((opt) => <option key={opt.value} value={opt.value}>{opt.label}</option>)}
+                        </select>
+                      ) : field.type === 'textarea' ? (
+                        <textarea className="w-full rounded-lg border border-input bg-transparent px-2.5 py-1.5 text-sm" rows={3} placeholder={field.placeholder} defaultValue={String(field.value ?? '')} />
+                      ) : (
+                        <input type={field.type} className="h-8 w-full rounded-lg border border-input bg-transparent px-2.5 text-sm" placeholder={field.placeholder} defaultValue={String(field.value ?? '')} />
+                      )}
+                    </div>
+                  </div>
+                ))}
+              </div>
+            </div>
+          ))}
+
+          {onSave && (
+            <div className="flex justify-end border-t pt-4">
+              <button className="inline-flex h-8 items-center rounded-lg bg-primary px-4 text-sm font-medium text-primary-foreground hover:bg-primary/80">
+                Save changes
+              </button>
+            </div>
+          )}
+        </div>
+      </div>
+    </div>
+  )
+}
+
+export type { SettingsPageProps, SettingSection, SettingField }
diff --git a/frontend/functions/ui/skeleton.md b/frontend/functions/ui/skeleton.md
new file mode 100644
index 00000000..bdaac90e
--- /dev/null
+++ b/frontend/functions/ui/skeleton.md
@@ -0,0 +1,65 @@
+---
+name: skeleton
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "Skeleton(props: HTMLAttributes<HTMLDivElement>): JSX.Element"
+description: "Sistema de loading skeletons: base, text, card, avatar, button, table. Variantes preconfiguradas para estados de carga."
+tags: [skeleton, loading, placeholder, component, ui]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/skeleton.tsx"
+props:
+  - name: className
+    type: "string"
+    required: false
+    description: "Clases CSS adicionales"
+  - name: lines
+    type: "number"
+    required: false
+    description: "Número de líneas (SkeletonText, default 3)"
+  - name: rows
+    type: "number"
+    required: false
+    description: "Filas de tabla (SkeletonTable, default 5)"
+  - name: columns
+    type: "number"
+    required: false
+    description: "Columnas de tabla (SkeletonTable, default 4)"
+  - name: size
+    type: "'xs' | 'sm' | 'md' | 'lg' | 'xl'"
+    required: false
+    description: "Tamaño del avatar (SkeletonAvatar, default md)"
+emits: []
+has_state: false
+framework: react
+variant: [base, text, card, avatar, button, table]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/skeleton.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<SkeletonCard />
+<SkeletonText lines={4} />
+<SkeletonTable rows={10} columns={5} />
+<SkeletonAvatar size="lg" />
+<SkeletonButton />
+```
+
+## Notas
+
+Exporta 6 variantes preconfiguradas. Todas componen sobre el Skeleton base con animate-pulse.
+La última línea de SkeletonText se acorta a w-4/5 para simular texto real.
+SkeletonCard incluye imagen (h-[180px]) + dos líneas de texto.
diff --git a/frontend/functions/ui/skeleton.tsx b/frontend/functions/ui/skeleton.tsx
new file mode 100644
index 00000000..0efb56ab
--- /dev/null
+++ b/frontend/functions/ui/skeleton.tsx
@@ -0,0 +1,54 @@
+import * as React from "react"
+import { cn } from "../core/cn"
+
+function Skeleton({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) {
+  return <div data-slot="skeleton" className={cn("animate-pulse rounded-md bg-muted", className)} {...props} />
+}
+
+function SkeletonText({ className, lines = 3, ...props }: React.HTMLAttributes<HTMLDivElement> & { lines?: number }) {
+  return (
+    <div className={cn("space-y-2", className)} {...props}>
+      {Array.from({ length: lines }).map((_, i) => (
+        <Skeleton key={i} className={cn("h-4", i === lines - 1 ? "w-4/5" : "w-full")} />
+      ))}
+    </div>
+  )
+}
+
+function SkeletonCard({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) {
+  return (
+    <div className={cn("space-y-3", className)} {...props}>
+      <Skeleton className="h-[180px] w-full rounded-lg" />
+      <Skeleton className="h-4 w-3/4" />
+      <Skeleton className="h-4 w-1/2" />
+    </div>
+  )
+}
+
+function SkeletonAvatar({ className, size = "md", ...props }: React.HTMLAttributes<HTMLDivElement> & { size?: "xs" | "sm" | "md" | "lg" | "xl" }) {
+  const sizeClasses = { xs: "size-6", sm: "size-8", md: "size-10", lg: "size-12", xl: "size-16" }
+  return <Skeleton className={cn("rounded-full", sizeClasses[size], className)} {...props} />
+}
+
+function SkeletonButton({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) {
+  return <Skeleton className={cn("h-8 w-24 rounded-lg", className)} {...props} />
+}
+
+function SkeletonTable({ className, rows = 5, columns = 4, ...props }: React.HTMLAttributes<HTMLDivElement> & { rows?: number; columns?: number }) {
+  return (
+    <div className={cn("space-y-3", className)} {...props}>
+      <div className="flex gap-4">
+        {Array.from({ length: columns }).map((_, i) => <Skeleton key={i} className="h-4 flex-1" />)}
+      </div>
+      <div className="space-y-2">
+        {Array.from({ length: rows }).map((_, rowIndex) => (
+          <div key={rowIndex} className="flex gap-4">
+            {Array.from({ length: columns }).map((_, colIndex) => <Skeleton key={colIndex} className="h-4 flex-1" />)}
+          </div>
+        ))}
+      </div>
+    </div>
+  )
+}
+
+export { Skeleton, SkeletonAvatar, SkeletonButton, SkeletonCard, SkeletonTable, SkeletonText }
diff --git a/frontend/functions/ui/sparkline.md b/frontend/functions/ui/sparkline.md
new file mode 100644
index 00000000..fefb9543
--- /dev/null
+++ b/frontend/functions/ui/sparkline.md
@@ -0,0 +1,60 @@
+---
+name: sparkline
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "Sparkline(props: SparklineProps): JSX.Element"
+description: "Mini gráfico inline SVG puro (sin Recharts) con variantes line, area y bar. Para KPI cards y tablas."
+tags: [sparkline, chart, inline, svg, component, ui, visualization]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/sparkline.tsx"
+props:
+  - name: data
+    type: "number[]"
+    required: true
+    description: "Array de valores numéricos"
+  - name: variant
+    type: "'line' | 'area' | 'bar'"
+    required: false
+    description: "Tipo de visualización"
+  - name: color
+    type: "string"
+    required: false
+    description: "Color del gráfico"
+  - name: width
+    type: "number"
+    required: false
+    description: "Ancho en px (default 80)"
+  - name: height
+    type: "number"
+    required: false
+    description: "Alto en px (default 24)"
+emits: []
+has_state: false
+framework: react
+variant: [line, area, bar]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/sparkline.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<Sparkline data={[10, 25, 15, 40, 30, 55]} variant="area" color="#22c55e" />
+<Sparkline data={[5, 3, 8, 1, 9]} variant="bar" width={60} height={20} />
+```
+
+## Notas
+
+SVG puro — sin dependencia de Recharts. Ideal para inline en tablas y cards.
diff --git a/frontend/functions/ui/sparkline.tsx b/frontend/functions/ui/sparkline.tsx
new file mode 100644
index 00000000..2a758798
--- /dev/null
+++ b/frontend/functions/ui/sparkline.tsx
@@ -0,0 +1,72 @@
+import * as React from 'react'
+import { cn } from '../core/cn'
+
+type SparklineVariant = 'line' | 'area' | 'bar'
+
+interface SparklineProps extends React.SVGAttributes<SVGSVGElement> {
+  data: number[]
+  variant?: SparklineVariant
+  color?: string
+  width?: number
+  height?: number
+  strokeWidth?: number
+  showLastPoint?: boolean
+}
+
+function getPath(data: number[], width: number, height: number, padding: number = 2) {
+  if (data.length === 0) return { linePath: '', areaPath: '' }
+  const min = Math.min(...data)
+  const max = Math.max(...data)
+  const range = max - min || 1
+  const ew = width - padding * 2
+  const eh = height - padding * 2
+  const points = data.map((value, index) => ({
+    x: padding + (index / (data.length - 1)) * ew,
+    y: padding + eh - ((value - min) / range) * eh,
+  }))
+  const linePath = points.map((p, i) => `${i === 0 ? 'M' : 'L'} ${p.x} ${p.y}`).join(' ')
+  const areaPath = `${linePath} L ${points[points.length - 1].x} ${height - padding} L ${padding} ${height - padding} Z`
+  return { linePath, areaPath }
+}
+
+const Sparkline = React.forwardRef<SVGSVGElement, SparklineProps>(
+  ({ data, variant = 'line', color = 'currentColor', width = 80, height = 24, strokeWidth = 1.5, showLastPoint = true, className, ...props }, ref) => {
+    if (data.length === 0) return <svg ref={ref} width={width} height={height} viewBox={`0 0 ${width} ${height}`} className={cn('text-primary', className)} {...props} />
+
+    if (variant === 'bar') {
+      const min = Math.min(...data, 0)
+      const max = Math.max(...data)
+      const range = max - min || 1
+      const p = 2
+      const eh = height - p * 2
+      const bw = (width - p * 2) / data.length - 1
+      return (
+        <svg ref={ref} width={width} height={height} viewBox={`0 0 ${width} ${height}`} className={cn('text-primary', className)} {...props}>
+          {data.map((value, index) => {
+            const bh = ((value - min) / range) * eh
+            const x = p + index * ((width - p * 2) / data.length) + 0.5
+            const y = p + eh - bh
+            return <rect key={index} x={x} y={y} width={Math.max(bw, 1)} height={Math.max(bh, 1)} fill={color} opacity={0.8} />
+          })}
+        </svg>
+      )
+    }
+
+    const { linePath, areaPath } = getPath(data, width, height)
+    const lastPoint = {
+      x: width - 2,
+      y: 2 + (height - 4) - ((data[data.length - 1] - Math.min(...data)) / (Math.max(...data) - Math.min(...data) || 1)) * (height - 4)
+    }
+
+    return (
+      <svg ref={ref} width={width} height={height} viewBox={`0 0 ${width} ${height}`} className={cn('text-primary', className)} {...props}>
+        {variant === 'area' && <path d={areaPath} fill={color} opacity={0.2} />}
+        <path d={linePath} fill="none" stroke={color} strokeWidth={strokeWidth} strokeLinecap="round" strokeLinejoin="round" />
+        {showLastPoint && <circle cx={lastPoint.x} cy={lastPoint.y} r={2.5} fill={color} />}
+      </svg>
+    )
+  }
+)
+Sparkline.displayName = 'Sparkline'
+
+export { Sparkline, type SparklineProps, type SparklineVariant }
diff --git a/frontend/functions/ui/tabs.md b/frontend/functions/ui/tabs.md
new file mode 100644
index 00000000..716c72e1
--- /dev/null
+++ b/frontend/functions/ui/tabs.md
@@ -0,0 +1,50 @@
+---
+name: tabs
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "Tabs(props: TabsRootProps): JSX.Element"
+description: "Sistema de tabs con orientación horizontal/vertical, variantes default y line, y soporte para iconos. Base-UI primitive."
+tags: [tabs, navigation, component, ui, interactive]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: ["@base-ui/react", class-variance-authority]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/tabs.tsx"
+props:
+  - name: orientation
+    type: "'horizontal' | 'vertical'"
+    required: false
+    description: "Orientación de los tabs"
+  - name: variant
+    type: "'default' | 'line'"
+    required: false
+    description: "Estilo visual de la lista"
+emits: [onValueChange]
+has_state: true
+framework: react
+variant: [default, line]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/tabs.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<Tabs defaultValue="general">
+  <TabsList>
+    <TabsTrigger value="general">General</TabsTrigger>
+    <TabsTrigger value="security">Security</TabsTrigger>
+  </TabsList>
+  <TabsContent value="general">...</TabsContent>
+  <TabsContent value="security">...</TabsContent>
+</Tabs>
+```
diff --git a/frontend/functions/ui/tabs.tsx b/frontend/functions/ui/tabs.tsx
new file mode 100644
index 00000000..347e8bf0
--- /dev/null
+++ b/frontend/functions/ui/tabs.tsx
@@ -0,0 +1,43 @@
+import { Tabs as TabsPrimitive } from "@base-ui/react/tabs"
+import { cva, type VariantProps } from "class-variance-authority"
+import { cn } from "../core/cn"
+
+function Tabs({ className, orientation = "horizontal", ...props }: TabsPrimitive.Root.Props) {
+  return (
+    <TabsPrimitive.Root data-slot="tabs" data-orientation={orientation} className={cn("group/tabs flex gap-2 data-horizontal:flex-col", className)} {...props} />
+  )
+}
+
+const tabsListVariants = cva(
+  "group/tabs-list inline-flex w-fit items-center justify-center rounded-lg p-[3px] text-muted-foreground group-data-horizontal/tabs:h-8 group-data-vertical/tabs:h-fit group-data-vertical/tabs:flex-col data-[variant=line]:rounded-none",
+  {
+    variants: {
+      variant: { default: "bg-muted", line: "gap-1 bg-transparent" },
+    },
+    defaultVariants: { variant: "default" },
+  }
+)
+
+function TabsList({ className, variant = "default", ...props }: TabsPrimitive.List.Props & VariantProps<typeof tabsListVariants>) {
+  return <TabsPrimitive.List data-slot="tabs-list" data-variant={variant} className={cn(tabsListVariants({ variant }), className)} {...props} />
+}
+
+function TabsTrigger({ className, ...props }: TabsPrimitive.Tab.Props) {
+  return (
+    <TabsPrimitive.Tab
+      data-slot="tabs-trigger"
+      className={cn(
+        "relative inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center gap-1.5 rounded-md border border-transparent px-1.5 py-0.5 text-sm font-medium whitespace-nowrap text-foreground/60 transition-all hover:text-foreground focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50",
+        "data-active:bg-background data-active:text-foreground dark:data-active:border-input dark:data-active:bg-input/30",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TabsContent({ className, ...props }: TabsPrimitive.Panel.Props) {
+  return <TabsPrimitive.Panel data-slot="tabs-content" className={cn("flex-1 text-sm outline-none", className)} {...props} />
+}
+
+export { Tabs, TabsList, TabsTrigger, TabsContent, tabsListVariants }
diff --git a/frontend/functions/ui/theme_provider.md b/frontend/functions/ui/theme_provider.md
new file mode 100644
index 00000000..6cbc7689
--- /dev/null
+++ b/frontend/functions/ui/theme_provider.md
@@ -0,0 +1,65 @@
+---
+name: theme_provider
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "ThemeProvider(props: { children: ReactNode; themes: Record<string, Theme>; defaultTheme?: string }): JSX.Element"
+description: "Provider de tema React con context, persistencia en localStorage, detección de preferencia del sistema y hook useTheme."
+tags: [theme, provider, context, hook, component, ui]
+uses_functions: [apply_theme_typescript_ui]
+uses_types: [ThemeConfig_typescript_ui]
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/theme_provider.tsx"
+props:
+  - name: themes
+    type: "Record<string, Theme>"
+    required: true
+    description: "Mapa de temas disponibles"
+  - name: defaultTheme
+    type: "string"
+    required: false
+    description: "Nombre del tema por defecto"
+  - name: children
+    type: "ReactNode"
+    required: true
+    description: "Contenido de la app"
+emits: []
+has_state: true
+framework: react
+variant: [default]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/hooks/use-theme.tsx"
+---
+
+## Ejemplo
+
+```tsx
+import { ThemeProvider, useTheme } from './theme_provider'
+
+<ThemeProvider themes={allThemes} defaultTheme="dark">
+  <App />
+</ThemeProvider>
+
+// Dentro de un componente:
+function ThemeSwitcher() {
+  const { themeName, setTheme, themes } = useTheme()
+  return (
+    <select value={themeName} onChange={(e) => setTheme(e.target.value)}>
+      {Object.values(themes).map(t => <option key={t.name} value={t.name}>{t.label}</option>)}
+    </select>
+  )
+}
+```
+
+## Notas
+
+Detecta prefers-color-scheme automáticamente. Persiste elección en localStorage. Exporta ThemeProvider (componente) y useTheme (hook).
diff --git a/frontend/functions/ui/theme_provider.tsx b/frontend/functions/ui/theme_provider.tsx
new file mode 100644
index 00000000..cfd2f9df
--- /dev/null
+++ b/frontend/functions/ui/theme_provider.tsx
@@ -0,0 +1,101 @@
+import { createContext, useCallback, useContext, useEffect, useState, type ReactNode } from 'react'
+
+interface ThemeColors {
+  [key: string]: string
+}
+
+interface Theme {
+  name: string
+  label: string
+  colors: ThemeColors
+}
+
+interface ThemeContextValue {
+  theme: Theme
+  themeName: string
+  setTheme: (name: string) => void
+  themes: Record<string, Theme>
+}
+
+const STORAGE_KEY = 'frontend-library-theme'
+const ThemeContext = createContext<ThemeContextValue | null>(null)
+
+function applyThemeColors(theme: Theme) {
+  const root = document.documentElement
+  const cssVarMap: Record<string, string> = {
+    background: '--background', foreground: '--foreground',
+    card: '--card', cardForeground: '--card-foreground',
+    popover: '--popover', popoverForeground: '--popover-foreground',
+    primary: '--primary', primaryForeground: '--primary-foreground',
+    secondary: '--secondary', secondaryForeground: '--secondary-foreground',
+    muted: '--muted', mutedForeground: '--muted-foreground',
+    accent: '--accent', accentForeground: '--accent-foreground',
+    destructive: '--destructive', destructiveForeground: '--destructive-foreground',
+    success: '--success', successForeground: '--success-foreground',
+    warning: '--warning', warningForeground: '--warning-foreground',
+    info: '--info', infoForeground: '--info-foreground',
+    surface: '--surface', surfaceHover: '--surface-hover', overlay: '--overlay',
+    border: '--border', input: '--input', ring: '--ring',
+    chart1: '--chart-1', chart2: '--chart-2', chart3: '--chart-3', chart4: '--chart-4', chart5: '--chart-5',
+    sidebar: '--sidebar', sidebarForeground: '--sidebar-foreground',
+    sidebarPrimary: '--sidebar-primary', sidebarPrimaryForeground: '--sidebar-primary-foreground',
+    sidebarAccent: '--sidebar-accent', sidebarAccentForeground: '--sidebar-accent-foreground',
+    sidebarBorder: '--sidebar-border', sidebarRing: '--sidebar-ring',
+  }
+  Object.entries(cssVarMap).forEach(([key, cssVar]) => {
+    if (theme.colors[key]) root.style.setProperty(cssVar, theme.colors[key])
+  })
+  if (theme.name === 'dark' || theme.name === 'midnight' || theme.name === 'sunset') {
+    root.classList.add('dark')
+  } else {
+    root.classList.remove('dark')
+  }
+}
+
+interface ThemeProviderProps {
+  children: ReactNode
+  themes: Record<string, Theme>
+  defaultTheme?: string
+}
+
+export function ThemeProvider({ children, themes, defaultTheme: initialTheme }: ThemeProviderProps) {
+  const [themeName, setThemeName] = useState<string>(() => {
+    if (initialTheme) return initialTheme
+    if (typeof window === 'undefined') return 'default'
+    const stored = localStorage.getItem(STORAGE_KEY)
+    if (stored && themes[stored]) return stored
+    if (window.matchMedia('(prefers-color-scheme: dark)').matches) return 'dark'
+    return 'default'
+  })
+
+  const theme = themes[themeName] ?? themes['default'] ?? Object.values(themes)[0]
+
+  const setTheme = useCallback((name: string) => {
+    if (themes[name]) {
+      setThemeName(name)
+      localStorage.setItem(STORAGE_KEY, name)
+    }
+  }, [themes])
+
+  useEffect(() => { applyThemeColors(theme) }, [theme])
+
+  useEffect(() => {
+    const mq = window.matchMedia('(prefers-color-scheme: dark)')
+    const handle = (e: MediaQueryListEvent) => {
+      if (!localStorage.getItem(STORAGE_KEY)) setThemeName(e.matches ? 'dark' : 'default')
+    }
+    mq.addEventListener('change', handle)
+    return () => mq.removeEventListener('change', handle)
+  }, [])
+
+  return <ThemeContext.Provider value={{ theme, themeName, setTheme, themes }}>{children}</ThemeContext.Provider>
+}
+
+export function useTheme() {
+  const ctx = useContext(ThemeContext)
+  if (!ctx) throw new Error('useTheme must be used within a ThemeProvider')
+  return ctx
+}
+
+export { ThemeContext }
+export type { ThemeContextValue, ThemeProviderProps, Theme, ThemeColors }
diff --git a/frontend/functions/ui/tooltip.md b/frontend/functions/ui/tooltip.md
new file mode 100644
index 00000000..d0377fd7
--- /dev/null
+++ b/frontend/functions/ui/tooltip.md
@@ -0,0 +1,51 @@
+---
+name: tooltip
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "Tooltip(props: TooltipRootProps): JSX.Element"
+description: "Tooltip accesible con animaciones, posicionamiento automático y arrow. Base-UI primitive con delay configurable."
+tags: [tooltip, overlay, component, ui, help]
+uses_functions: [cn_typescript_core]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: ["@base-ui/react", react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/tooltip.tsx"
+props:
+  - name: delayDuration
+    type: "number"
+    required: false
+    description: "Delay en ms antes de mostrar el tooltip (default 300)"
+emits: []
+has_state: true
+framework: react
+variant: [default]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/tooltip.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<TooltipProvider>
+  <Tooltip>
+    <TooltipTrigger>Hover me</TooltipTrigger>
+    <TooltipContent>Tooltip text</TooltipContent>
+  </Tooltip>
+</TooltipProvider>
+```
+
+## Notas
+
+Exporta 5 subcomponentes: TooltipProvider, Tooltip, TooltipTrigger, TooltipPortal, TooltipContent.
+TooltipProvider gestiona el delay global — envolver la app o sección con un único Provider.
+TooltipContent incluye Arrow con fill-primary automático.
+Depende de @base-ui/react — asegurarse de que está en package.json del frontend.
diff --git a/frontend/functions/ui/tooltip.tsx b/frontend/functions/ui/tooltip.tsx
new file mode 100644
index 00000000..8b8657d2
--- /dev/null
+++ b/frontend/functions/ui/tooltip.tsx
@@ -0,0 +1,45 @@
+"use client"
+
+import * as React from "react"
+import { Tooltip as TooltipPrimitive } from "@base-ui/react/tooltip"
+import { cn } from "../core/cn"
+
+function TooltipProvider({ delayDuration = 300, ...props }: { delayDuration?: number; children: React.ReactNode }) {
+  return <TooltipPrimitive.Provider delay={delayDuration} {...props} />
+}
+
+function Tooltip({ ...props }: TooltipPrimitive.Root.Props) {
+  return <TooltipPrimitive.Root data-slot="tooltip" {...props} />
+}
+
+function TooltipTrigger({ ...props }: TooltipPrimitive.Trigger.Props) {
+  return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />
+}
+
+function TooltipPortal({ ...props }: TooltipPrimitive.Portal.Props) {
+  return <TooltipPrimitive.Portal data-slot="tooltip-portal" {...props} />
+}
+
+function TooltipContent({ className, sideOffset = 4, ...props }: TooltipPrimitive.Positioner.Props) {
+  return (
+    <TooltipPortal>
+      <TooltipPrimitive.Positioner
+        data-slot="tooltip-content"
+        sideOffset={sideOffset}
+        className={cn(
+          "z-50 overflow-hidden rounded-md bg-primary px-3 py-1.5 text-xs text-primary-foreground",
+          "animate-in fade-in-0 zoom-in-95",
+          "data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95",
+          "data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2",
+          className
+        )}
+        {...props}
+      >
+        <TooltipPrimitive.Popup>{props.children}</TooltipPrimitive.Popup>
+        <TooltipPrimitive.Arrow className="fill-primary" />
+      </TooltipPrimitive.Positioner>
+    </TooltipPortal>
+  )
+}
+
+export { Tooltip, TooltipContent, TooltipPortal, TooltipProvider, TooltipTrigger }
diff --git a/frontend/functions/ui/use_animated_canvas.md b/frontend/functions/ui/use_animated_canvas.md
new file mode 100644
index 00000000..106c5b89
--- /dev/null
+++ b/frontend/functions/ui/use_animated_canvas.md
@@ -0,0 +1,57 @@
+---
+name: use_animated_canvas
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "useAnimatedCanvas(options: AnimatedCanvasOptions): AnimatedCanvasResult"
+description: "Hook React para canvas animado a N fps via requestAnimationFrame. Maneja DPR, resize, throttling, y contador de FPS real."
+tags: [canvas, animation, fps, requestAnimationFrame, hook, realtime, component, ui]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/use_animated_canvas.tsx"
+props:
+  - name: fps
+    type: "number"
+    required: false
+    description: "Target FPS (default 60)"
+  - name: draw
+    type: "(ctx: CanvasRenderingContext2D, width: number, height: number, frameCount: number) => void"
+    required: true
+    description: "Callback de renderizado"
+emits: []
+has_state: true
+framework: react
+variant: [default]
+---
+
+## Ejemplo
+
+```tsx
+const { canvasRef, renderFpsRef } = useAnimatedCanvas({
+  fps: 100,
+  draw: (ctx, w, h) => {
+    // Dibujar lo que sea a 100fps
+    ctx.fillStyle = '#3b82f6'
+    ctx.fillRect(0, 0, w * Math.random(), h)
+  },
+})
+
+return <canvas ref={canvasRef} style={{ width: '100%', height: 300 }} />
+```
+
+## Notas
+
+- DPR automático: escala el canvas al devicePixelRatio de la pantalla
+- Resize automático: detecta cambios de tamaño via getBoundingClientRect
+- Throttle configurable: rAF corre a ~144fps nativo, el hook filtra a N fps
+- FPS real: `renderFpsRef.current` tiene los FPS medidos (no el target)
+- drawRef pattern: actualiza el callback sin re-crear el loop de animación
diff --git a/frontend/functions/ui/use_animated_canvas.tsx b/frontend/functions/ui/use_animated_canvas.tsx
new file mode 100644
index 00000000..209b1ed9
--- /dev/null
+++ b/frontend/functions/ui/use_animated_canvas.tsx
@@ -0,0 +1,80 @@
+import { useEffect, useRef } from 'react'
+
+export interface AnimatedCanvasOptions {
+  /** Target FPS (default 60). El throttle real es 1000/fps ms. */
+  fps?: number
+  /** Callback de dibujo. Recibe el canvas 2d context y dimensiones. */
+  draw: (ctx: CanvasRenderingContext2D, width: number, height: number, frameCount: number) => void
+}
+
+export interface AnimatedCanvasResult {
+  canvasRef: React.RefObject<HTMLCanvasElement | null>
+  /** FPS real de renderizado (actualizado cada segundo) */
+  renderFpsRef: React.RefObject<number>
+}
+
+/**
+ * Hook para renderizar un canvas a N fps usando requestAnimationFrame.
+ * Maneja DPR, resize, y throttling automático.
+ */
+export function useAnimatedCanvas(options: AnimatedCanvasOptions): AnimatedCanvasResult {
+  const { fps = 60, draw } = options
+  const canvasRef = useRef<HTMLCanvasElement>(null)
+  const renderFpsRef = useRef(0)
+  const rafRef = useRef(0)
+  const lastDrawRef = useRef(0)
+  const frameCountRef = useRef(0)
+  const fpsTimerRef = useRef(0)
+  const drawRef = useRef(draw)
+
+  // Keep draw ref updated without re-subscribing the effect
+  drawRef.current = draw
+
+  useEffect(() => {
+    const interval = 1000 / fps
+
+    const loop = (now: number) => {
+      rafRef.current = requestAnimationFrame(loop)
+
+      if (now - lastDrawRef.current < interval) return
+      lastDrawRef.current = now
+
+      // FPS counting
+      frameCountRef.current++
+      if (now - fpsTimerRef.current >= 1000) {
+        renderFpsRef.current = frameCountRef.current
+        frameCountRef.current = 0
+        fpsTimerRef.current = now
+      }
+
+      const canvas = canvasRef.current
+      if (!canvas) return
+
+      const rect = canvas.getBoundingClientRect()
+      const w = rect.width
+      const h = rect.height
+      const dpr = window.devicePixelRatio || 1
+
+      const targetW = Math.floor(w * dpr)
+      const targetH = Math.floor(h * dpr)
+
+      if (canvas.width !== targetW || canvas.height !== targetH) {
+        canvas.width = targetW
+        canvas.height = targetH
+      }
+
+      const ctx = canvas.getContext('2d')
+      if (!ctx) return
+
+      ctx.setTransform(dpr, 0, 0, dpr, 0, 0)
+      ctx.clearRect(0, 0, w, h)
+
+      drawRef.current(ctx, w, h, frameCountRef.current)
+    }
+
+    rafRef.current = requestAnimationFrame(loop)
+    return () => cancelAnimationFrame(rafRef.current)
+  }, [fps])
+
+  return { canvasRef, renderFpsRef }
+}
diff --git a/frontend/functions/ui/use_wails_event.md b/frontend/functions/ui/use_wails_event.md
new file mode 100644
index 00000000..111689bd
--- /dev/null
+++ b/frontend/functions/ui/use_wails_event.md
@@ -0,0 +1,62 @@
+---
+name: use_wails_event
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "useWailsEvent<T>(opts: UseWailsEventOptions<T>): UseWailsEventResult<T>"
+description: "Hook para suscripción a eventos Go→TS y emisión TS→Go via Wails runtime. Soporta once, maxCallbacks, emit bidireccional."
+tags: [wails, event, hook, ipc, realtime, component, ui]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/use_wails_event.tsx"
+props:
+  - name: eventName
+    type: "string"
+    required: true
+    description: "Nombre del evento Wails"
+  - name: onEvent
+    type: "(data: T) => void"
+    required: false
+    description: "Callback al recibir evento"
+  - name: once
+    type: "boolean"
+    required: false
+    description: "Solo escuchar una vez"
+  - name: enabled
+    type: "boolean"
+    required: false
+    description: "Habilitar suscripción"
+emits: [onEvent]
+has_state: true
+framework: react
+variant: [default]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/lib/wails/use-wails-event.tsx"
+---
+
+## Ejemplo
+
+```tsx
+// Escuchar eventos de Go
+const { lastData, eventCount, emit } = useWailsEvent<PriceUpdate>({
+  eventName: 'price:update',
+  onEvent: (price) => updateChart(price),
+})
+
+// Emitir de TS a Go
+emit({ symbol: 'BTC', action: 'subscribe' })
+```
+
+## Notas
+
+Exporta también `useWailsEmit()` para emit sin suscripción. Usa `window.runtime.EventsOn/Off/Emit` del Wails runtime.
diff --git a/frontend/functions/ui/use_wails_event.tsx b/frontend/functions/ui/use_wails_event.tsx
new file mode 100644
index 00000000..ce06e2d5
--- /dev/null
+++ b/frontend/functions/ui/use_wails_event.tsx
@@ -0,0 +1,115 @@
+import { useCallback, useEffect, useRef, useState } from 'react'
+
+// Types for Wails runtime (will be available when running in Wails)
+declare global {
+  interface Window {
+    runtime?: {
+      EventsOn: (eventName: string, callback: (...args: unknown[]) => void) => () => void
+      EventsOff: (eventName: string, ...additionalEventNames: string[]) => void
+      EventsOnce: (eventName: string, callback: (...args: unknown[]) => void) => () => void
+      EventsOnMultiple: (eventName: string, callback: (...args: unknown[]) => void, maxCallbacks: number) => () => void
+      EventsEmit: (eventName: string, ...data: unknown[]) => void
+    }
+  }
+}
+
+export interface UseWailsEventOptions<T> {
+  /** Nombre del evento a escuchar */
+  eventName: string
+  /** Callback cuando llega el evento */
+  onEvent?: (data: T) => void
+  /** Si está habilitado */
+  enabled?: boolean
+  /** Solo escuchar una vez */
+  once?: boolean
+  /** Número máximo de veces a escuchar */
+  maxCallbacks?: number
+}
+
+export interface UseWailsEventResult<T> {
+  /** Último dato recibido */
+  lastData: T | undefined
+  /** Número de eventos recibidos */
+  eventCount: number
+  /** Emitir un evento */
+  emit: (data?: T) => void
+  /** Resetear estado */
+  reset: () => void
+}
+
+/**
+ * Hook para suscribirse a eventos de Wails
+ */
+export function useWailsEvent<T = unknown>({
+  eventName,
+  onEvent,
+  enabled = true,
+  once = false,
+  maxCallbacks,
+}: UseWailsEventOptions<T>): UseWailsEventResult<T> {
+  const [lastData, setLastData] = useState<T | undefined>(undefined)
+  const [eventCount, setEventCount] = useState(0)
+  const callbackRef = useRef(onEvent)
+
+  // Keep callback ref updated
+  useEffect(() => {
+    callbackRef.current = onEvent
+  }, [onEvent])
+
+  useEffect(() => {
+    if (!enabled || !window.runtime) return
+
+    const handleEvent = (...args: unknown[]) => {
+      const data = args[0] as T
+      setLastData(data)
+      setEventCount((c) => c + 1)
+      callbackRef.current?.(data)
+    }
+
+    let unsubscribe: (() => void) | undefined
+
+    if (once) {
+      unsubscribe = window.runtime.EventsOnce(eventName, handleEvent)
+    } else if (maxCallbacks !== undefined) {
+      unsubscribe = window.runtime.EventsOnMultiple(eventName, handleEvent, maxCallbacks)
+    } else {
+      unsubscribe = window.runtime.EventsOn(eventName, handleEvent)
+    }
+
+    return () => {
+      unsubscribe?.()
+    }
+  }, [eventName, enabled, once, maxCallbacks])
+
+  const emit = useCallback(
+    (data?: T) => {
+      if (window.runtime) {
+        window.runtime.EventsEmit(eventName, data)
+      }
+    },
+    [eventName]
+  )
+
+  const reset = useCallback(() => {
+    setLastData(undefined)
+    setEventCount(0)
+  }, [])
+
+  return {
+    lastData,
+    eventCount,
+    emit,
+    reset,
+  }
+}
+
+/**
+ * Hook para emitir eventos a Wails (sin suscripción)
+ */
+export function useWailsEmit() {
+  return useCallback((eventName: string, ...data: unknown[]) => {
+    if (window.runtime) {
+      window.runtime.EventsEmit(eventName, ...data)
+    }
+  }, [])
+}
diff --git a/frontend/functions/ui/use_wails_mutation.md b/frontend/functions/ui/use_wails_mutation.md
new file mode 100644
index 00000000..a86b62cd
--- /dev/null
+++ b/frontend/functions/ui/use_wails_mutation.md
@@ -0,0 +1,64 @@
+---
+name: use_wails_mutation
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "useWailsMutation<TData, TVariables>(opts: UseWailsMutationOptions<TData, TVariables>): UseWailsMutationResult<TData, TVariables>"
+description: "Hook para escrituras IPC Wails con optimistic updates, invalidación automática de queries, retry y callbacks completos."
+tags: [wails, mutation, hook, ipc, optimistic, component, ui]
+uses_functions: [wails_cache_typescript_core, wails_provider_typescript_ui]
+uses_types: [WailsIPC_typescript_ui]
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/use_wails_mutation.tsx"
+props:
+  - name: mutationFn
+    type: "(variables: TVariables) => Promise<TData>"
+    required: true
+    description: "Función que ejecuta la mutación via IPC"
+  - name: invalidateQueries
+    type: "string[][]"
+    required: false
+    description: "Query keys a invalidar en éxito"
+  - name: onMutate
+    type: "(variables: TVariables) => unknown"
+    required: false
+    description: "Optimistic update antes de la mutación"
+emits: [onSuccess, onError, onSettled]
+has_state: true
+framework: react
+variant: [default]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/lib/wails/use-wails-mutation.tsx"
+---
+
+## Ejemplo
+
+```tsx
+const { mutate, isLoading } = useWailsMutation({
+  mutationFn: (user: User) => CreateUser(user),
+  invalidateQueries: [['users']],
+  onMutate: (user) => {
+    // Optimistic: añadir al cache antes de confirmar
+    const prev = wailsCache.get<User[]>(['users', 'list'])
+    wailsCache.set(['users', 'list'], [...(prev || []), user])
+    return { prev }
+  },
+  onError: (_err, _vars, context) => {
+    // Rollback
+    wailsCache.set(['users', 'list'], context.prev)
+  },
+})
+```
+
+## Notas
+
+`mutate()` es fire-and-forget, `mutateAsync()` retorna Promise. Estado: idle → loading → success/error.
diff --git a/frontend/functions/ui/use_wails_mutation.tsx b/frontend/functions/ui/use_wails_mutation.tsx
new file mode 100644
index 00000000..4dd8a6f6
--- /dev/null
+++ b/frontend/functions/ui/use_wails_mutation.tsx
@@ -0,0 +1,150 @@
+import { useCallback, useRef, useState } from 'react'
+import { useWailsContext } from './wails_provider'
+import type { MutationOptions } from '../../types/ui/wails_ipc'
+
+export interface UseWailsMutationOptions<TData, TVariables> extends MutationOptions {
+  /** Función que ejecuta la mutación */
+  mutationFn: (variables: TVariables) => Promise<TData>
+  /** Callback antes de la mutación (optimistic update) */
+  onMutate?: (variables: TVariables) => Promise<unknown> | unknown
+  /** Callback en éxito */
+  onSuccess?: (data: TData, variables: TVariables, context: unknown) => void
+  /** Callback en error */
+  onError?: (error: Error, variables: TVariables, context: unknown) => void
+  /** Callback siempre (éxito o error) */
+  onSettled?: (data: TData | undefined, error: Error | null, variables: TVariables, context: unknown) => void
+  /** Query keys a invalidar en éxito */
+  invalidateQueries?: string[][]
+}
+
+export interface UseWailsMutationResult<TData, TVariables> {
+  /** Ejecutar la mutación */
+  mutate: (variables: TVariables) => void
+  /** Ejecutar la mutación (async) */
+  mutateAsync: (variables: TVariables) => Promise<TData>
+  /** Estado de carga */
+  isLoading: boolean
+  /** Datos del resultado */
+  data: TData | undefined
+  /** Error si ocurrió */
+  error: Error | null
+  /** Resetear estado */
+  reset: () => void
+  /** Si fue exitoso */
+  isSuccess: boolean
+  /** Si hubo error */
+  isError: boolean
+  /** Si está idle */
+  isIdle: boolean
+}
+
+export function useWailsMutation<TData, TVariables = void>({
+  mutationFn,
+  onMutate,
+  onSuccess,
+  onError,
+  onSettled,
+  invalidateQueries,
+  retry = false,
+  retryDelay = 1000,
+}: UseWailsMutationOptions<TData, TVariables>): UseWailsMutationResult<TData, TVariables> {
+  const { cache } = useWailsContext()
+
+  const [state, setState] = useState<{
+    status: 'idle' | 'loading' | 'success' | 'error'
+    data: TData | undefined
+    error: Error | null
+  }>({
+    status: 'idle',
+    data: undefined,
+    error: null,
+  })
+
+  const retryCountRef = useRef(0)
+
+  const executeMutation = useCallback(
+    async (variables: TVariables): Promise<TData> => {
+      setState((s) => ({ ...s, status: 'loading', error: null }))
+
+      let context: unknown
+
+      try {
+        // Optimistic update
+        if (onMutate) {
+          context = await onMutate(variables)
+        }
+
+        const data = await mutationFn(variables)
+
+        // Reset retry count on success
+        retryCountRef.current = 0
+
+        setState({
+          status: 'success',
+          data,
+          error: null,
+        })
+
+        // Invalidate queries
+        if (invalidateQueries) {
+          invalidateQueries.forEach((queryKey) => {
+            cache.invalidate(queryKey)
+          })
+        }
+
+        onSuccess?.(data, variables, context)
+        onSettled?.(data, null, variables, context)
+
+        return data
+      } catch (error) {
+        const maxRetries = typeof retry === 'number' ? retry : retry ? 3 : 0
+
+        if (retryCountRef.current < maxRetries) {
+          retryCountRef.current += 1
+          await new Promise((resolve) => setTimeout(resolve, retryDelay))
+          return executeMutation(variables)
+        }
+
+        setState((s) => ({
+          ...s,
+          status: 'error',
+          error: error as Error,
+        }))
+
+        onError?.(error as Error, variables, context)
+        onSettled?.(undefined, error as Error, variables, context)
+
+        throw error
+      }
+    },
+    [mutationFn, onMutate, onSuccess, onError, onSettled, invalidateQueries, cache, retry, retryDelay]
+  )
+
+  const mutate = useCallback(
+    (variables: TVariables) => {
+      executeMutation(variables).catch(() => {})
+    },
+    [executeMutation]
+  )
+
+  const reset = useCallback(() => {
+    setState({
+      status: 'idle',
+      data: undefined,
+      error: null,
+    })
+    retryCountRef.current = 0
+  }, [])
+
+  return {
+    mutate,
+    mutateAsync: executeMutation,
+    isLoading: state.status === 'loading',
+    data: state.data,
+    error: state.error,
+    reset,
+    isSuccess: state.status === 'success',
+    isError: state.status === 'error',
+    isIdle: state.status === 'idle',
+  }
+}
diff --git a/frontend/functions/ui/use_wails_query.md b/frontend/functions/ui/use_wails_query.md
new file mode 100644
index 00000000..aa6336d3
--- /dev/null
+++ b/frontend/functions/ui/use_wails_query.md
@@ -0,0 +1,65 @@
+---
+name: use_wails_query
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "useWailsQuery<T>(opts: UseWailsQueryOptions<T>): UseWailsQueryResult<T>"
+description: "Hook React Query-like sobre IPC Wails. Cache automático, refetch por intervalo/foco, retry con backoff, invalidación."
+tags: [wails, query, hook, ipc, cache, component, ui]
+uses_functions: [wails_cache_typescript_core, wails_provider_typescript_ui]
+uses_types: [WailsIPC_typescript_ui]
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/use_wails_query.tsx"
+props:
+  - name: queryKey
+    type: "string[]"
+    required: true
+    description: "Key única para cache"
+  - name: queryFn
+    type: "() => Promise<T>"
+    required: true
+    description: "Función que llama al binding Wails"
+  - name: enabled
+    type: "boolean"
+    required: false
+    description: "Habilitar auto-fetch (default true)"
+  - name: refetchInterval
+    type: "number"
+    required: false
+    description: "Refetch cada N ms"
+  - name: staleTime
+    type: "number"
+    required: false
+    description: "Tiempo antes de considerar datos stale"
+emits: [onSuccess, onError]
+has_state: true
+framework: react
+variant: [default]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/lib/wails/use-wails-query.tsx"
+---
+
+## Ejemplo
+
+```tsx
+const { data, loading, refetch, invalidate } = useWailsQuery({
+  queryKey: ['users', 'list'],
+  queryFn: () => GetUsers(),       // Wails binding
+  refetchInterval: 30000,          // Cada 30s
+  staleTime: 5000,                 // Fresh por 5s
+  onSuccess: (users) => console.log(`${users.length} users`),
+})
+```
+
+## Notas
+
+API inspirada en TanStack Query pero sobre IPC Wails (sin HTTP). Cache compartido via WailsProvider o singleton. Refetch automático en window focus.
diff --git a/frontend/functions/ui/use_wails_query.tsx b/frontend/functions/ui/use_wails_query.tsx
new file mode 100644
index 00000000..18eb37e5
--- /dev/null
+++ b/frontend/functions/ui/use_wails_query.tsx
@@ -0,0 +1,163 @@
+import { useCallback, useEffect, useRef, useState } from 'react'
+import { useWailsContext } from './wails_provider'
+import { DEFAULT_QUERY_OPTIONS, type QueryOptions, type QueryState } from '../../types/ui/wails_ipc'
+
+export interface UseWailsQueryOptions<T> extends QueryOptions {
+  /** Key única para identificar esta query en el cache */
+  queryKey: string[]
+  /** Función que ejecuta la llamada a Wails */
+  queryFn: () => Promise<T>
+  /** Callback en éxito */
+  onSuccess?: (data: T) => void
+  /** Callback en error */
+  onError?: (error: Error) => void
+}
+
+export interface UseWailsQueryResult<T> extends QueryState<T> {
+  /** Re-ejecutar la query manualmente */
+  refetch: () => Promise<T>
+  /** Invalidar cache de esta query */
+  invalidate: () => void
+}
+
+export function useWailsQuery<T>({
+  queryKey,
+  queryFn,
+  onSuccess,
+  onError,
+  ...options
+}: UseWailsQueryOptions<T>): UseWailsQueryResult<T> {
+  const { cache, defaultQueryOptions } = useWailsContext()
+
+  // Merge options with defaults
+  const opts = {
+    ...DEFAULT_QUERY_OPTIONS,
+    ...defaultQueryOptions,
+    ...options,
+  }
+
+  const {
+    enabled,
+    staleTime,
+    refetchInterval,
+    refetchOnFocus,
+    retry,
+    retryDelay,
+  } = opts
+
+  const [state, setState] = useState<QueryState<T>>(() => ({
+    data: cache.get<T>(queryKey),
+    loading: !cache.has(queryKey) && enabled,
+    error: null,
+    isStale: cache.isStale(queryKey, staleTime),
+    lastUpdated: cache.getTimestamp(queryKey),
+  }))
+
+  const retryCountRef = useRef(0)
+  const mountedRef = useRef(true)
+
+  const fetch = useCallback(async (): Promise<T> => {
+    if (!mountedRef.current) throw new Error('Component unmounted')
+
+    setState((s) => ({ ...s, loading: true, error: null }))
+
+    try {
+      const data = await queryFn()
+
+      if (!mountedRef.current) throw new Error('Component unmounted')
+
+      cache.set(queryKey, data)
+      retryCountRef.current = 0
+
+      setState({
+        data,
+        loading: false,
+        error: null,
+        isStale: false,
+        lastUpdated: new Date(),
+      })
+
+      onSuccess?.(data)
+      return data
+    } catch (error) {
+      if (!mountedRef.current) throw error
+
+      const maxRetries = typeof retry === 'number' ? retry : retry ? 3 : 0
+
+      if (retryCountRef.current < maxRetries) {
+        retryCountRef.current += 1
+        await new Promise((resolve) => setTimeout(resolve, retryDelay))
+        return fetch()
+      }
+
+      setState((s) => ({
+        ...s,
+        loading: false,
+        error: error as Error,
+      }))
+
+      onError?.(error as Error)
+      throw error
+    }
+  }, [queryKey.join(':'), queryFn, cache, staleTime, retry, retryDelay, onSuccess, onError])
+
+  // Initial fetch
+  useEffect(() => {
+    mountedRef.current = true
+
+    if (enabled && (!cache.has(queryKey) || cache.isStale(queryKey, staleTime))) {
+      fetch().catch(() => {})
+    }
+
+    return () => {
+      mountedRef.current = false
+    }
+  }, [enabled, queryKey.join(':'), staleTime])
+
+  // Refetch interval
+  useEffect(() => {
+    if (!refetchInterval || !enabled) return
+
+    const interval = setInterval(() => {
+      fetch().catch(() => {})
+    }, refetchInterval)
+
+    return () => clearInterval(interval)
+  }, [refetchInterval, enabled, fetch])
+
+  // Refetch on window focus
+  useEffect(() => {
+    if (!refetchOnFocus || !enabled) return
+
+    const handleFocus = () => {
+      if (cache.isStale(queryKey, staleTime)) {
+        fetch().catch(() => {})
+      }
+    }
+
+    window.addEventListener('focus', handleFocus)
+    return () => window.removeEventListener('focus', handleFocus)
+  }, [refetchOnFocus, enabled, queryKey.join(':'), staleTime, fetch])
+
+  // Subscribe to cache changes
+  useEffect(() => {
+    return cache.subscribe(queryKey, () => {
+      setState((s) => ({
+        ...s,
+        data: cache.get<T>(queryKey),
+        isStale: cache.isStale(queryKey, staleTime),
+        lastUpdated: cache.getTimestamp(queryKey),
+      }))
+    })
+  }, [queryKey.join(':'), staleTime])
+
+  const invalidate = useCallback(() => {
+    cache.invalidate(queryKey)
+  }, [queryKey.join(':')])
+
+  return {
+    ...state,
+    refetch: fetch,
+    invalidate,
+  }
+}
diff --git a/frontend/functions/ui/use_wails_stream.md b/frontend/functions/ui/use_wails_stream.md
new file mode 100644
index 00000000..c347d4f8
--- /dev/null
+++ b/frontend/functions/ui/use_wails_stream.md
@@ -0,0 +1,69 @@
+---
+name: use_wails_stream
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "useWailsStream<T>(opts: UseWailsStreamOptions<T>): UseWailsStreamResult<T>"
+description: "Hook para streaming de datos Go→TS con buffer configurable, auto-complete, transform y control start/stop. Incluye useWailsLogs."
+tags: [wails, stream, hook, ipc, realtime, buffer, component, ui]
+uses_functions: [use_wails_event_typescript_ui]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/use_wails_stream.tsx"
+props:
+  - name: streamName
+    type: "string"
+    required: true
+    description: "Nombre del evento de stream"
+  - name: startFn
+    type: "() => Promise<void>"
+    required: false
+    description: "Función Go para iniciar el stream"
+  - name: stopFn
+    type: "() => Promise<void>"
+    required: false
+    description: "Función Go para detener el stream"
+  - name: bufferSize
+    type: "number"
+    required: false
+    description: "Tamaño máximo del buffer (default 1000)"
+  - name: transform
+    type: "(data: unknown) => T"
+    required: false
+    description: "Transformar datos entrantes"
+emits: [onData, onComplete, onError]
+has_state: true
+framework: react
+variant: [default]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/lib/wails/use-wails-stream.tsx"
+---
+
+## Ejemplo
+
+```tsx
+// Stream de logs en tiempo real
+const { data: logs, isStreaming, start, stop, clear } = useWailsStream<string>({
+  streamName: 'app:logs',
+  startFn: () => StartLogStream(),
+  stopFn: () => StopLogStream(),
+  bufferSize: 500,
+  autoStart: true,
+})
+
+// Versión simplificada para logs
+const { data: logs } = useWailsLogs('deploy:logs')
+```
+
+## Notas
+
+Protocolo de stream: Go emite chunks en `{streamName}`, completa con `{streamName}:complete`, errores con `{streamName}:error`. Buffer circular con tamaño configurable.
diff --git a/frontend/functions/ui/use_wails_stream.tsx b/frontend/functions/ui/use_wails_stream.tsx
new file mode 100644
index 00000000..c46c90c3
--- /dev/null
+++ b/frontend/functions/ui/use_wails_stream.tsx
@@ -0,0 +1,196 @@
+import { useCallback, useEffect, useRef, useState } from 'react'
+import { useWailsEvent } from './use_wails_event'
+
+export interface UseWailsStreamOptions<T> {
+  /** Nombre del evento de stream */
+  streamName: string
+  /** Función para iniciar el stream en Go */
+  startFn?: () => Promise<void>
+  /** Función para detener el stream en Go */
+  stopFn?: () => Promise<void>
+  /** Transformar datos entrantes */
+  transform?: (data: unknown) => T
+  /** Callback por cada chunk */
+  onData?: (data: T) => void
+  /** Callback cuando el stream termina */
+  onComplete?: () => void
+  /** Callback en error */
+  onError?: (error: Error) => void
+  /** Tamaño máximo del buffer */
+  bufferSize?: number
+  /** Auto-iniciar el stream */
+  autoStart?: boolean
+}
+
+export interface UseWailsStreamResult<T> {
+  /** Datos acumulados */
+  data: T[]
+  /** Último dato recibido */
+  lastChunk: T | undefined
+  /** Si está activo */
+  isStreaming: boolean
+  /** Si está cargando (iniciando) */
+  isLoading: boolean
+  /** Error si ocurrió */
+  error: Error | null
+  /** Iniciar stream */
+  start: () => Promise<void>
+  /** Detener stream */
+  stop: () => Promise<void>
+  /** Limpiar buffer */
+  clear: () => void
+  /** Número de chunks recibidos */
+  chunkCount: number
+}
+
+/**
+ * Hook para manejar streams de datos desde Wails
+ * Útil para datos en tiempo real como logs, métricas, etc.
+ */
+export function useWailsStream<T = unknown>({
+  streamName,
+  startFn,
+  stopFn,
+  transform,
+  onData,
+  onComplete,
+  onError,
+  bufferSize = 1000,
+  autoStart = false,
+}: UseWailsStreamOptions<T>): UseWailsStreamResult<T> {
+  const [data, setData] = useState<T[]>([])
+  const [isStreaming, setIsStreaming] = useState(false)
+  const [isLoading, setIsLoading] = useState(false)
+  const [error, setError] = useState<Error | null>(null)
+  const [chunkCount, setChunkCount] = useState(0)
+
+  const lastChunkRef = useRef<T | undefined>(undefined)
+  const mountedRef = useRef(true)
+
+  // Listen for stream data
+  useWailsEvent<unknown>({
+    eventName: streamName,
+    enabled: isStreaming,
+    onEvent: (rawData) => {
+      if (!mountedRef.current) return
+
+      const chunk = transform ? transform(rawData) : (rawData as T)
+      lastChunkRef.current = chunk
+
+      setData((prev) => {
+        const newData = [...prev, chunk]
+        // Mantener buffer limitado
+        if (newData.length > bufferSize) {
+          return newData.slice(-bufferSize)
+        }
+        return newData
+      })
+
+      setChunkCount((c) => c + 1)
+      onData?.(chunk)
+    },
+  })
+
+  // Listen for stream complete
+  useWailsEvent({
+    eventName: `${streamName}:complete`,
+    enabled: isStreaming,
+    onEvent: () => {
+      if (!mountedRef.current) return
+      setIsStreaming(false)
+      onComplete?.()
+    },
+  })
+
+  // Listen for stream error
+  useWailsEvent<{ message: string }>({
+    eventName: `${streamName}:error`,
+    enabled: isStreaming,
+    onEvent: (errorData) => {
+      if (!mountedRef.current) return
+      const err = new Error(errorData?.message || 'Stream error')
+      setError(err)
+      setIsStreaming(false)
+      onError?.(err)
+    },
+  })
+
+  const start = useCallback(async () => {
+    if (isStreaming || isLoading) return
+
+    setIsLoading(true)
+    setError(null)
+
+    try {
+      if (startFn) {
+        await startFn()
+      }
+      setIsStreaming(true)
+    } catch (err) {
+      const error = err as Error
+      setError(error)
+      onError?.(error)
+    } finally {
+      setIsLoading(false)
+    }
+  }, [isStreaming, isLoading, startFn, onError])
+
+  const stop = useCallback(async () => {
+    if (!isStreaming) return
+
+    try {
+      if (stopFn) {
+        await stopFn()
+      }
+      setIsStreaming(false)
+    } catch (err) {
+      const error = err as Error
+      setError(error)
+      onError?.(error)
+    }
+  }, [isStreaming, stopFn, onError])
+
+  const clear = useCallback(() => {
+    setData([])
+    setChunkCount(0)
+    lastChunkRef.current = undefined
+  }, [])
+
+  // Auto-start
+  useEffect(() => {
+    if (autoStart) {
+      start()
+    }
+  }, []) // eslint-disable-line react-hooks/exhaustive-deps
+
+  // Cleanup
+  useEffect(() => {
+    mountedRef.current = true
+    return () => {
+      mountedRef.current = false
+    }
+  }, [])
+
+  return {
+    data,
+    lastChunk: lastChunkRef.current,
+    isStreaming,
+    isLoading,
+    error,
+    start,
+    stop,
+    clear,
+    chunkCount,
+  }
+}
+
+/**
+ * Hook simplificado para logs en tiempo real
+ */
+export function useWailsLogs(eventName: string = 'logs') {
+  return useWailsStream<string>({
+    streamName: eventName,
+    transform: (data) => (typeof data === 'string' ? data : JSON.stringify(data)),
+    bufferSize: 500,
+  })
+}
diff --git a/frontend/functions/ui/wails_provider.md b/frontend/functions/ui/wails_provider.md
new file mode 100644
index 00000000..92147d6d
--- /dev/null
+++ b/frontend/functions/ui/wails_provider.md
@@ -0,0 +1,53 @@
+---
+name: wails_provider
+kind: component
+lang: typescript
+domain: ui
+version: "1.0.0"
+purity: impure
+signature: "WailsProvider(props: { children: ReactNode; cache?: WailsCache; defaultQueryOptions?: QueryOptions }): JSX.Element"
+description: "Provider React para IPC Wails con cache context, opciones default y fallback a singleton. Exporta useWailsContext y useWailsCache."
+tags: [wails, provider, context, ipc, component, ui]
+uses_functions: [wails_cache_typescript_core]
+uses_types: [WailsIPC_typescript_ui]
+returns: []
+returns_optional: false
+error_type: ""
+imports: [react]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "frontend/functions/ui/wails_provider.tsx"
+props:
+  - name: cache
+    type: "WailsCache"
+    required: false
+    description: "Cache custom (default: singleton global)"
+  - name: defaultQueryOptions
+    type: "Partial<QueryOptions>"
+    required: false
+    description: "Opciones default para todas las queries"
+  - name: children
+    type: "ReactNode"
+    required: true
+    description: "App content"
+emits: []
+has_state: false
+framework: react
+variant: [default]
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/lib/wails/wails-provider.tsx"
+---
+
+## Ejemplo
+
+```tsx
+<WailsProvider defaultQueryOptions={{ staleTime: 5000, retry: 2 }}>
+  <App />
+</WailsProvider>
+```
+
+## Notas
+
+Sin provider, los hooks hacen fallback al singleton `wailsCache`. El provider solo es necesario para cache custom o opciones globales.
diff --git a/frontend/functions/ui/wails_provider.tsx b/frontend/functions/ui/wails_provider.tsx
new file mode 100644
index 00000000..be6c4ac3
--- /dev/null
+++ b/frontend/functions/ui/wails_provider.tsx
@@ -0,0 +1,60 @@
+import { createContext, useContext, useMemo, type ReactNode } from 'react'
+import { WailsCache, wailsCache } from '../core/wails_cache'
+import type { QueryOptions, MutationOptions } from '../../types/ui/wails_ipc'
+
+interface WailsContextValue {
+  cache: WailsCache
+  defaultQueryOptions: Partial<QueryOptions>
+  defaultMutationOptions: Partial<MutationOptions>
+}
+
+const WailsContext = createContext<WailsContextValue | null>(null)
+
+export interface WailsProviderProps {
+  children: ReactNode
+  /** Usar un cache custom en lugar del singleton */
+  cache?: WailsCache
+  /** Opciones por defecto para queries */
+  defaultQueryOptions?: Partial<QueryOptions>
+  /** Opciones por defecto para mutations */
+  defaultMutationOptions?: Partial<MutationOptions>
+}
+
+export function WailsProvider({
+  children,
+  cache,
+  defaultQueryOptions = {},
+  defaultMutationOptions = {},
+}: WailsProviderProps) {
+  const value = useMemo<WailsContextValue>(
+    () => ({
+      cache: cache ?? wailsCache,
+      defaultQueryOptions,
+      defaultMutationOptions,
+    }),
+    [cache, defaultQueryOptions, defaultMutationOptions]
+  )
+
+  return (
+    <WailsContext.Provider value={value}>
+      {children}
+    </WailsContext.Provider>
+  )
+}
+
+export function useWailsContext(): WailsContextValue {
+  const context = useContext(WailsContext)
+  if (!context) {
+    // Fallback to singleton cache if no provider
+    return {
+      cache: wailsCache,
+      defaultQueryOptions: {},
+      defaultMutationOptions: {},
+    }
+  }
+  return context
+}
+
+export function useWailsCache(): WailsCache {
+  return useWailsContext().cache
+}
diff --git a/frontend/types/core/component_variants.md b/frontend/types/core/component_variants.md
new file mode 100644
index 00000000..30f321e1
--- /dev/null
+++ b/frontend/types/core/component_variants.md
@@ -0,0 +1,40 @@
+---
+name: ComponentVariants
+lang: typescript
+domain: core
+version: "1.0.0"
+algebraic: product
+definition: |
+  interface ComponentBaseProps { className?: string; children?: React.ReactNode }
+  type PropsWithVariants<V> = ComponentBaseProps & VariantProps<V>
+description: "Tipos base para componentes con variantes CVA. Props comunes y composición de variantes type-safe."
+tags: [component, variants, cva, props, base]
+uses_types: []
+file_path: "frontend/types/core/component_variants.ts"
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/button.tsx"
+---
+
+## Tipos exportados
+
+- `VariantProps<V>` — re-exportado de `class-variance-authority`. Extrae el tipo de props de un `cva()` call.
+- `ComponentBaseProps` — props comunes a todos los componentes: `className` y `children` opcionales.
+- `PropsWithVariants<V>` — combinación de `ComponentBaseProps` con las variantes de un `cva()` concreto. Usar como base para las props de cualquier componente con variantes.
+
+## Uso
+
+```typescript
+import { cva } from "class-variance-authority"
+import { type PropsWithVariants } from "@/types/core/component_variants"
+
+const buttonVariants = cva("base-classes", {
+  variants: { size: { sm: "...", md: "..." } }
+})
+
+type ButtonProps = PropsWithVariants<typeof buttonVariants>
+```
+
+## Notas
+
+Requiere `class-variance-authority` como dependencia del proyecto consumidor. `React.ReactNode` requiere que `react` esté en el scope — en proyectos con `@types/react` esto se resuelve automáticamente.
diff --git a/frontend/types/core/component_variants.ts b/frontend/types/core/component_variants.ts
new file mode 100644
index 00000000..0a314379
--- /dev/null
+++ b/frontend/types/core/component_variants.ts
@@ -0,0 +1,10 @@
+import { type VariantProps } from "class-variance-authority"
+
+export type { VariantProps }
+
+export interface ComponentBaseProps {
+  className?: string
+  children?: React.ReactNode
+}
+
+export type PropsWithVariants<V> = ComponentBaseProps & VariantProps<V>
diff --git a/frontend/types/ui/chart_series.md b/frontend/types/ui/chart_series.md
new file mode 100644
index 00000000..a7b27d56
--- /dev/null
+++ b/frontend/types/ui/chart_series.md
@@ -0,0 +1,26 @@
+---
+name: ChartSeries
+lang: typescript
+domain: ui
+version: "1.0.0"
+algebraic: product
+definition: |
+  interface Series { key: string; name: string; color?: string }
+  interface ChartDataPoint { [key: string]: string | number }
+description: "Tipos base para series y datos de gráficos. Usados por todos los chart components."
+tags: [chart, series, data, visualization]
+uses_types: []
+file_path: "frontend/types/ui/chart_series.ts"
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/components/ui/charts/chart-base.tsx"
+---
+
+## Interfaces exportadas
+
+- `Series` — describe una serie de datos: `key` (campo en el datapoint), `name` (label visible), `color` opcional (override del color del tema)
+- `ChartDataPoint` — mapa genérico `string -> string | number`, representa un punto de datos indexado por clave
+
+## Notas
+
+Tipos mínimos sin dependencias. `ChartDataPoint` usa index signature para permitir cualquier combinación de campos numéricos y categóricos en el mismo punto de datos.
diff --git a/frontend/types/ui/chart_series.ts b/frontend/types/ui/chart_series.ts
new file mode 100644
index 00000000..b532f9b9
--- /dev/null
+++ b/frontend/types/ui/chart_series.ts
@@ -0,0 +1,9 @@
+export interface Series {
+  key: string
+  name: string
+  color?: string
+}
+
+export interface ChartDataPoint {
+  [key: string]: string | number
+}
diff --git a/frontend/types/ui/theme_config.md b/frontend/types/ui/theme_config.md
new file mode 100644
index 00000000..4bcf9e03
--- /dev/null
+++ b/frontend/types/ui/theme_config.md
@@ -0,0 +1,41 @@
+---
+name: ThemeConfig
+lang: typescript
+domain: ui
+version: "1.0.0"
+algebraic: product
+definition: |
+  interface ThemeConfig { name: string; label: string; palette: ColorPalette; colors: SemanticColors; typography: Typography; spacing: Spacing; borders: Borders; shadows: Shadows; motion: Motion; breakpoints: Breakpoints; zIndex: ZIndex; icons: Icons }
+description: "Sistema completo de tokens de diseño: colores semánticos, tipografía, spacing, sombras, motion, breakpoints. Base del theming de Frontend Library."
+tags: [theme, design-tokens, colors, typography, ui]
+uses_types: []
+file_path: "frontend/types/ui/theme_config.ts"
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/themes/types.ts"
+---
+
+## Interfaces exportadas
+
+- `ColorPalette` — colores primitivos (grays, brand, status, white/black)
+- `SemanticColors` — tokens semánticos (background, foreground, border, brand, status, surface, sidebar, chart)
+- `Typography` — fontFamily, fontSize, fontWeight, lineHeight, letterSpacing
+- `Spacing` — escala 0-96 basada en 4px
+- `Borders` — width y radius
+- `Shadows` — elevación xs-2xl, inner, glow
+- `Motion` — duration e easing
+- `Breakpoints` — xs-2xl
+- `ZIndex` — jerarquía de capas hide-max
+- `Icons` — size y strokeWidth para Phosphor Icons
+- `ThemeConfig` — composición completa de todos los tokens
+- `ThemeColors` — formato legacy para compatibilidad con shadcn/ui
+- `Theme` — nombre + label + ThemeColors
+- `ThemeName` — union type de los temas disponibles
+
+## Helper
+
+`themeConfigToColors(config: ThemeConfig): ThemeColors` — convierte un ThemeConfig al formato legacy ThemeColors que consume shadcn/ui.
+
+## Notas
+
+Copia directa de `frontend/src/themes/types.ts` de Frontend_Library. El archivo es autocontenido sin dependencias externas. Los colores usan formato OKLCH via variables CSS.
diff --git a/frontend/types/ui/theme_config.ts b/frontend/types/ui/theme_config.ts
new file mode 100644
index 00000000..3af56b8c
--- /dev/null
+++ b/frontend/types/ui/theme_config.ts
@@ -0,0 +1,540 @@
+// ============================================================================
+// THEME SYSTEM TYPES
+// Sistema de temas completo para Frontend Library
+// ============================================================================
+
+// ----------------------------------------------------------------------------
+// 1. COLOR PALETTE (Primitivos)
+// ----------------------------------------------------------------------------
+
+export interface ColorPalette {
+  // Grays (escala neutral)
+  gray50: string
+  gray100: string
+  gray200: string
+  gray300: string
+  gray400: string
+  gray500: string
+  gray600: string
+  gray700: string
+  gray800: string
+  gray900: string
+  gray950: string
+
+  // Brand colors (personalizables por tema)
+  brand50: string
+  brand100: string
+  brand200: string
+  brand300: string
+  brand400: string
+  brand500: string
+  brand600: string
+  brand700: string
+  brand800: string
+  brand900: string
+  brand950: string
+
+  // Status colors
+  red500: string
+  red600: string
+  green500: string
+  green600: string
+  yellow500: string
+  yellow600: string
+  blue500: string
+  blue600: string
+
+  // Pure colors
+  white: string
+  black: string
+  transparent: string
+}
+
+// ----------------------------------------------------------------------------
+// 2. SEMANTIC COLORS (Tokens semánticos)
+// ----------------------------------------------------------------------------
+
+export interface SemanticColors {
+  // Backgrounds
+  background: {
+    default: string
+    subtle: string
+    muted: string
+    inverse: string
+  }
+
+  // Foregrounds
+  foreground: {
+    default: string
+    muted: string
+    subtle: string
+    disabled: string
+    inverse: string
+  }
+
+  // Borders
+  border: {
+    default: string
+    muted: string
+    strong: string
+    focus: string
+  }
+
+  // Brand
+  brand: {
+    primary: string
+    primaryForeground: string
+    secondary: string
+    secondaryForeground: string
+    accent: string
+    accentForeground: string
+  }
+
+  // Status
+  status: {
+    success: string
+    successForeground: string
+    successMuted: string
+    warning: string
+    warningForeground: string
+    warningMuted: string
+    error: string
+    errorForeground: string
+    errorMuted: string
+    info: string
+    infoForeground: string
+    infoMuted: string
+  }
+
+  // Surfaces (jerarquía de capas)
+  surface: {
+    base: string        // Fondo principal
+    raised: string      // Cards, panels
+    overlay: string     // Modals, dropdowns
+    sunken: string      // Inputs, wells
+  }
+
+  // Sidebar (panel lateral oscuro)
+  sidebar: {
+    background: string
+    foreground: string
+    muted: string
+    accent: string
+    accentForeground: string
+    border: string
+    ring: string
+  }
+
+  // Charts
+  chart: {
+    1: string
+    2: string
+    3: string
+    4: string
+    5: string
+    6: string
+    7: string
+    8: string
+  }
+
+  // Interactive
+  ring: string
+  input: string
+}
+
+// ----------------------------------------------------------------------------
+// 3. TYPOGRAPHY
+// ----------------------------------------------------------------------------
+
+export interface Typography {
+  fontFamily: {
+    display: string     // Títulos destacados
+    heading: string     // Encabezados
+    body: string        // Texto general
+    mono: string        // Código
+  }
+
+  fontSize: {
+    xs: string          // 12px
+    sm: string          // 14px
+    base: string        // 16px
+    lg: string          // 18px
+    xl: string          // 20px
+    '2xl': string       // 24px
+    '3xl': string       // 30px
+    '4xl': string       // 36px
+    '5xl': string       // 48px
+    '6xl': string       // 60px
+  }
+
+  fontWeight: {
+    light: number
+    normal: number
+    medium: number
+    semibold: number
+    bold: number
+    extrabold: number
+  }
+
+  lineHeight: {
+    none: number
+    tight: number
+    snug: number
+    normal: number
+    relaxed: number
+    loose: number
+  }
+
+  letterSpacing: {
+    tighter: string
+    tight: string
+    normal: string
+    wide: string
+    wider: string
+  }
+}
+
+// ----------------------------------------------------------------------------
+// 4. SPACING
+// ----------------------------------------------------------------------------
+
+export interface Spacing {
+  0: string
+  px: string
+  0.5: string
+  1: string
+  1.5: string
+  2: string
+  2.5: string
+  3: string
+  3.5: string
+  4: string
+  5: string
+  6: string
+  7: string
+  8: string
+  9: string
+  10: string
+  11: string
+  12: string
+  14: string
+  16: string
+  20: string
+  24: string
+  28: string
+  32: string
+  36: string
+  40: string
+  44: string
+  48: string
+  52: string
+  56: string
+  60: string
+  64: string
+  72: string
+  80: string
+  96: string
+}
+
+// ----------------------------------------------------------------------------
+// 5. BORDERS
+// ----------------------------------------------------------------------------
+
+export interface Borders {
+  width: {
+    none: string
+    thin: string
+    default: string
+    medium: string
+    thick: string
+  }
+
+  radius: {
+    none: string
+    sm: string
+    default: string
+    md: string
+    lg: string
+    xl: string
+    '2xl': string
+    '3xl': string
+    full: string
+  }
+}
+
+// ----------------------------------------------------------------------------
+// 6. SHADOWS (Elevation)
+// ----------------------------------------------------------------------------
+
+export interface Shadows {
+  none: string
+  xs: string
+  sm: string
+  default: string
+  md: string
+  lg: string
+  xl: string
+  '2xl': string
+  inner: string
+  // Colored shadows for glow effects
+  glow: {
+    sm: string
+    md: string
+    lg: string
+  }
+}
+
+// ----------------------------------------------------------------------------
+// 7. MOTION / ANIMATION
+// ----------------------------------------------------------------------------
+
+export interface Motion {
+  duration: {
+    instant: string     // 0ms
+    fast: string        // 100ms
+    normal: string      // 200ms
+    slow: string        // 300ms
+    slower: string      // 500ms
+    slowest: string     // 1000ms
+  }
+
+  easing: {
+    linear: string
+    default: string
+    in: string
+    out: string
+    inOut: string
+    spring: string
+    bounce: string
+  }
+}
+
+// ----------------------------------------------------------------------------
+// 8. BREAKPOINTS
+// ----------------------------------------------------------------------------
+
+export interface Breakpoints {
+  xs: string
+  sm: string
+  md: string
+  lg: string
+  xl: string
+  '2xl': string
+}
+
+// ----------------------------------------------------------------------------
+// 9. Z-INDEX
+// ----------------------------------------------------------------------------
+
+export interface ZIndex {
+  hide: number
+  base: number
+  raised: number
+  dropdown: number
+  sticky: number
+  overlay: number
+  modal: number
+  popover: number
+  toast: number
+  tooltip: number
+  max: number
+}
+
+// ----------------------------------------------------------------------------
+// 10. ICONS
+// ----------------------------------------------------------------------------
+
+export interface Icons {
+  size: {
+    xs: string          // 12px
+    sm: string          // 16px
+    default: string     // 20px
+    md: string          // 24px
+    lg: string          // 32px
+    xl: string          // 40px
+    '2xl': string       // 48px
+  }
+
+  strokeWidth: {
+    thin: number
+    light: number
+    regular: number
+    bold: number
+    fill: number
+  }
+}
+
+// ----------------------------------------------------------------------------
+// THEME CONFIGURATION (Complete)
+// ----------------------------------------------------------------------------
+
+export interface ThemeConfig {
+  // Metadata
+  name: string
+  label: string
+  description?: string
+
+  // Color system
+  palette: ColorPalette
+  colors: SemanticColors
+
+  // Typography
+  typography: Typography
+
+  // Layout
+  spacing: Spacing
+  borders: Borders
+  shadows: Shadows
+
+  // Interaction
+  motion: Motion
+
+  // Responsive
+  breakpoints: Breakpoints
+  zIndex: ZIndex
+
+  // Icons
+  icons: Icons
+}
+
+// ----------------------------------------------------------------------------
+// LEGACY SUPPORT - ThemeColors (for backward compatibility)
+// ----------------------------------------------------------------------------
+
+export interface ThemeColors {
+  // Base
+  background: string
+  foreground: string
+
+  // Cards & Popovers
+  card: string
+  cardForeground: string
+  popover: string
+  popoverForeground: string
+
+  // Primary & Secondary
+  primary: string
+  primaryForeground: string
+  secondary: string
+  secondaryForeground: string
+
+  // Muted & Accent
+  muted: string
+  mutedForeground: string
+  accent: string
+  accentForeground: string
+
+  // Semantic colors
+  destructive: string
+  destructiveForeground: string
+  success: string
+  successForeground: string
+  warning: string
+  warningForeground: string
+  info: string
+  infoForeground: string
+
+  // Surfaces
+  surface: string
+  surfaceHover: string
+  overlay: string
+
+  // Form elements
+  border: string
+  input: string
+  ring: string
+
+  // Charts
+  chart1: string
+  chart2: string
+  chart3: string
+  chart4: string
+  chart5: string
+
+  // Sidebar
+  sidebar: string
+  sidebarForeground: string
+  sidebarPrimary: string
+  sidebarPrimaryForeground: string
+  sidebarAccent: string
+  sidebarAccentForeground: string
+  sidebarBorder: string
+  sidebarRing: string
+}
+
+export interface Theme {
+  name: string
+  label: string
+  colors: ThemeColors
+}
+
+export type ThemeName = 'default' | 'dark' | 'blue' | 'green' | 'purple' | 'orange' | 'rose' | 'cyan' | 'sunset' | 'midnight'
+
+// ----------------------------------------------------------------------------
+// HELPER: Convert ThemeConfig to legacy ThemeColors
+// ----------------------------------------------------------------------------
+
+export function themeConfigToColors(config: ThemeConfig): ThemeColors {
+  const { colors } = config
+
+  return {
+    // Base
+    background: colors.background.default,
+    foreground: colors.foreground.default,
+
+    // Cards & Popovers
+    card: colors.surface.raised,
+    cardForeground: colors.foreground.default,
+    popover: colors.surface.overlay,
+    popoverForeground: colors.foreground.default,
+
+    // Primary & Secondary
+    primary: colors.brand.primary,
+    primaryForeground: colors.brand.primaryForeground,
+    secondary: colors.brand.secondary,
+    secondaryForeground: colors.brand.secondaryForeground,
+
+    // Muted & Accent
+    muted: colors.background.muted,
+    mutedForeground: colors.foreground.muted,
+    accent: colors.brand.accent,
+    accentForeground: colors.brand.accentForeground,
+
+    // Semantic colors
+    destructive: colors.status.error,
+    destructiveForeground: colors.status.errorForeground,
+    success: colors.status.success,
+    successForeground: colors.status.successForeground,
+    warning: colors.status.warning,
+    warningForeground: colors.status.warningForeground,
+    info: colors.status.info,
+    infoForeground: colors.status.infoForeground,
+
+    // Surfaces
+    surface: colors.surface.raised,
+    surfaceHover: colors.background.subtle,
+    overlay: colors.surface.overlay,
+
+    // Form elements
+    border: colors.border.default,
+    input: colors.border.default,
+    ring: colors.ring,
+
+    // Charts
+    chart1: colors.chart[1],
+    chart2: colors.chart[2],
+    chart3: colors.chart[3],
+    chart4: colors.chart[4],
+    chart5: colors.chart[5],
+
+    // Sidebar
+    sidebar: colors.sidebar.background,
+    sidebarForeground: colors.sidebar.foreground,
+    sidebarPrimary: colors.brand.primary,
+    sidebarPrimaryForeground: colors.brand.primaryForeground,
+    sidebarAccent: colors.sidebar.accent,
+    sidebarAccentForeground: colors.sidebar.accentForeground,
+    sidebarBorder: colors.sidebar.border,
+    sidebarRing: colors.sidebar.ring,
+  }
+}
diff --git a/frontend/types/ui/wails_ipc.md b/frontend/types/ui/wails_ipc.md
new file mode 100644
index 00000000..87490263
--- /dev/null
+++ b/frontend/types/ui/wails_ipc.md
@@ -0,0 +1,22 @@
+---
+name: WailsIPC
+lang: typescript
+domain: ui
+version: "1.0.0"
+algebraic: product
+definition: |
+  interface QueryState<T> { data: T | null; loading: boolean; error: Error | null; isStale: boolean; lastUpdated: Date | null }
+  interface QueryOptions { enabled?: boolean; refetchInterval?: number; refetchOnFocus?: boolean; staleTime?: number; cacheTime?: number; retry?: number | boolean; retryDelay?: number }
+  interface MutationOptions { retry?: number | boolean; retryDelay?: number }
+description: "Tipos base para el sistema IPC de Wails: QueryState, QueryOptions, MutationOptions, WailsEvent, defaults."
+tags: [wails, ipc, types, query, mutation]
+uses_types: []
+file_path: "frontend/types/ui/wails_ipc.ts"
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
+source_license: "MIT"
+source_file: "frontend/src/lib/wails/types.ts"
+---
+
+## Notas
+
+Incluye constantes DEFAULT_QUERY_OPTIONS y DEFAULT_MUTATION_OPTIONS con valores sensibles para IPC (staleTime: 0, cacheTime: 5min, retry: 3).
diff --git a/frontend/types/ui/wails_ipc.ts b/frontend/types/ui/wails_ipc.ts
new file mode 100644
index 00000000..dd708449
--- /dev/null
+++ b/frontend/types/ui/wails_ipc.ts
@@ -0,0 +1,64 @@
+/** Estado de una query */
+export interface QueryState<T> {
+  data: T | null
+  loading: boolean
+  error: Error | null
+  isStale: boolean
+  lastUpdated: Date | null
+}
+
+/** Opciones comunes para queries */
+export interface QueryOptions {
+  /** Ejecutar automáticamente (default: true) */
+  enabled?: boolean
+  /** Auto-refetch cada N ms */
+  refetchInterval?: number
+  /** Refetch cuando la ventana gana foco */
+  refetchOnFocus?: boolean
+  /** Tiempo en ms antes de considerar datos stale (default: 0) */
+  staleTime?: number
+  /** Tiempo en ms en cache después de unmount (default: 5 min) */
+  cacheTime?: number
+  /** Número de reintentos en error (default: 3) */
+  retry?: number | boolean
+  /** Delay entre reintentos en ms */
+  retryDelay?: number
+}
+
+/** Opciones para mutations */
+export interface MutationOptions {
+  /** Reintentos en error */
+  retry?: number | boolean
+  /** Delay entre reintentos */
+  retryDelay?: number
+}
+
+/** Resultado de un evento Wails */
+export interface WailsEvent<T> {
+  name: string
+  data: T
+  timestamp: Date
+}
+
+/** Estado de una mutation */
+export interface MutationState<T> {
+  data: T | null
+  loading: boolean
+  error: Error | null
+}
+
+/** Default options */
+export const DEFAULT_QUERY_OPTIONS: Required<QueryOptions> = {
+  enabled: true,
+  refetchInterval: 0,
+  refetchOnFocus: true,
+  staleTime: 0,
+  cacheTime: 5 * 60 * 1000, // 5 minutos
+  retry: 3,
+  retryDelay: 1000,
+}
+
+export const DEFAULT_MUTATION_OPTIONS: Required<MutationOptions> = {
+  retry: 0,
+  retryDelay: 1000,
+}
diff --git a/functions/datascience/lorenz_step.go b/functions/datascience/lorenz_step.go
new file mode 100644
index 00000000..a1e2c19a
--- /dev/null
+++ b/functions/datascience/lorenz_step.go
@@ -0,0 +1,43 @@
+package datascience
+
+// LorenzState representa el estado del atractor de Lorenz en 3D.
+type LorenzState struct {
+	X, Y, Z float64
+}
+
+// LorenzParams define los parámetros del atractor de Lorenz.
+type LorenzParams struct {
+	Sigma float64 // Rate of rotation (default 10)
+	Rho   float64 // Size of attractor (default 28)
+	Beta  float64 // Damping (default 8/3)
+}
+
+// DefaultLorenzParams retorna los parámetros clásicos del atractor de Lorenz.
+func DefaultLorenzParams() LorenzParams {
+	return LorenzParams{Sigma: 10.0, Rho: 28.0, Beta: 8.0 / 3.0}
+}
+
+// LorenzStep calcula un paso del atractor de Lorenz usando integración de Euler.
+// dx/dt = sigma*(y-x), dy/dt = x*(rho-z)-y, dz/dt = x*y - beta*z
+func LorenzStep(s LorenzState, dt float64, p LorenzParams) LorenzState {
+	dx := p.Sigma * (s.Y - s.X)
+	dy := s.X*(p.Rho-s.Z) - s.Y
+	dz := s.X*s.Y - p.Beta*s.Z
+
+	return LorenzState{
+		X: s.X + dx*dt,
+		Y: s.Y + dy*dt,
+		Z: s.Z + dz*dt,
+	}
+}
+
+// LorenzSeries genera N pasos del atractor y retorna la serie completa.
+func LorenzSeries(initial LorenzState, dt float64, p LorenzParams, steps int) []LorenzState {
+	series := make([]LorenzState, steps)
+	state := initial
+	for i := 0; i < steps; i++ {
+		state = LorenzStep(state, dt, p)
+		series[i] = state
+	}
+	return series
+}
diff --git a/functions/datascience/lorenz_step.md b/functions/datascience/lorenz_step.md
new file mode 100644
index 00000000..49364e58
--- /dev/null
+++ b/functions/datascience/lorenz_step.md
@@ -0,0 +1,38 @@
+---
+name: lorenz_step
+kind: function
+lang: go
+domain: datascience
+version: "1.0.0"
+purity: pure
+signature: "LorenzStep(s LorenzState, dt float64, p LorenzParams) LorenzState"
+description: "Paso del atractor de Lorenz (sistema caótico determinista). Integración Euler con parámetros configurables. Incluye LorenzSeries para generar N pasos."
+tags: [lorenz, chaos, attractor, simulation, math, dynamical-systems]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: []
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/datascience/lorenz_step.go"
+---
+
+## Ejemplo
+
+```go
+p := DefaultLorenzParams()
+state := LorenzState{X: 1, Y: 1, Z: 1}
+
+// Un paso
+next := LorenzStep(state, 0.005, p)
+
+// Serie completa
+series := LorenzSeries(LorenzState{X: 1, Y: 1, Z: 1}, 0.005, p, 10000)
+```
+
+## Notas
+
+El atractor de Lorenz es un sistema de ecuaciones diferenciales que produce comportamiento caótico determinista. Con los parámetros clásicos (sigma=10, rho=28, beta=8/3), el sistema converge al famoso "butterfly attractor". X oscila típicamente entre -20 y 20.
diff --git a/functions/infra/clickhouse_open.go b/functions/infra/clickhouse_open.go
new file mode 100644
index 00000000..8d69e4c4
--- /dev/null
+++ b/functions/infra/clickhouse_open.go
@@ -0,0 +1,25 @@
+package infra
+
+import (
+	"database/sql"
+	"fmt"
+
+	_ "github.com/ClickHouse/clickhouse-go/v2"
+)
+
+// ClickHouseOpen connects to a ClickHouse server and returns a *sql.DB.
+// Constructs a DSN of the form:
+//
+//	clickhouse://user:password@host:port/database
+func ClickHouseOpen(host string, port int, user, password, database string) (*sql.DB, error) {
+	dsn := fmt.Sprintf("clickhouse://%s:%s@%s:%d/%s", user, password, host, port, database)
+	db, err := sql.Open("clickhouse", dsn)
+	if err != nil {
+		return nil, fmt.Errorf("clickhouse_open: open: %w", err)
+	}
+	if err := db.Ping(); err != nil {
+		db.Close()
+		return nil, fmt.Errorf("clickhouse_open: ping %s:%d/%s: %w", host, port, database, err)
+	}
+	return db, nil
+}
diff --git a/functions/infra/clickhouse_open.md b/functions/infra/clickhouse_open.md
new file mode 100644
index 00000000..380968a8
--- /dev/null
+++ b/functions/infra/clickhouse_open.md
@@ -0,0 +1,37 @@
+---
+name: clickhouse_open
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "func ClickHouseOpen(host string, port int, user, password, database string) (*sql.DB, error)"
+description: "Conecta a ClickHouse construyendo DSN clickhouse://user:pass@host:port/database."
+tags: [database, clickhouse, connection, sql, olap]
+uses_functions: []
+uses_types: [db_config_go_infra]
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: ["database/sql", "github.com/ClickHouse/clickhouse-go/v2"]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/clickhouse_open.go"
+---
+
+## Ejemplo
+
+```go
+db, err := ClickHouseOpen("localhost", 9000, "default", "", "analytics")
+if err != nil {
+    log.Fatal(err)
+}
+defer DBClose(db)
+
+rows, err := DBQuery(db, "SELECT event, count() FROM events GROUP BY event")
+```
+
+## Notas
+
+Usa el driver `github.com/ClickHouse/clickhouse-go/v2` registrado como "clickhouse". Puerto por defecto de ClickHouse es 9000 (nativo) o 8123 (HTTP). Hace ping al abrir para verificar conectividad.
diff --git a/functions/infra/db_close.go b/functions/infra/db_close.go
new file mode 100644
index 00000000..da0611a8
--- /dev/null
+++ b/functions/infra/db_close.go
@@ -0,0 +1,18 @@
+package infra
+
+import (
+	"database/sql"
+	"fmt"
+)
+
+// DBClose closes the database connection. Wraps db.Close() for composability
+// in pipelines that manage *sql.DB lifecycle explicitly.
+func DBClose(db *sql.DB) error {
+	if db == nil {
+		return fmt.Errorf("db_close: db is nil")
+	}
+	if err := db.Close(); err != nil {
+		return fmt.Errorf("db_close: %w", err)
+	}
+	return nil
+}
diff --git a/functions/infra/db_close.md b/functions/infra/db_close.md
new file mode 100644
index 00000000..8ce8c5d7
--- /dev/null
+++ b/functions/infra/db_close.md
@@ -0,0 +1,35 @@
+---
+name: db_close
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "func DBClose(db *sql.DB) error"
+description: "Cierra la conexion a la base de datos. Wrapper sobre db.Close() para composabilidad en pipelines que gestionan el ciclo de vida de *sql.DB explicitamente."
+tags: [database, sql, close, lifecycle]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: ["database/sql"]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/db_close.go"
+---
+
+## Ejemplo
+
+```go
+db, err := SQLiteOpen("/data/app.db")
+if err != nil {
+    return err
+}
+defer DBClose(db)
+```
+
+## Notas
+
+Retorna error si db es nil. En la mayoria de los casos se usa con `defer`. Existe como funcion del registry para que los pipelines puedan referenciarla en `uses_functions` y modelar el ciclo de vida completo de la conexion.
diff --git a/functions/infra/db_config.go b/functions/infra/db_config.go
new file mode 100644
index 00000000..d87608d0
--- /dev/null
+++ b/functions/infra/db_config.go
@@ -0,0 +1,8 @@
+package infra
+
+// DBConfig holds connection parameters for any supported database.
+type DBConfig struct {
+	Driver string            // "sqlite", "duckdb", "postgres", "clickhouse"
+	DSN    string            // Data source name / connection string
+	Opts   map[string]string // Driver-specific options (optional)
+}
diff --git a/functions/infra/db_create_table.go b/functions/infra/db_create_table.go
new file mode 100644
index 00000000..55640436
--- /dev/null
+++ b/functions/infra/db_create_table.go
@@ -0,0 +1,32 @@
+package infra
+
+import (
+	"database/sql"
+	"fmt"
+	"regexp"
+	"strings"
+)
+
+var validIdentifier = regexp.MustCompile(`^[a-zA-Z_][a-zA-Z0-9_]*$`)
+
+// DBCreateTable executes CREATE TABLE IF NOT EXISTS for the given table with
+// the provided column definitions. Each element of columns should be a full
+// SQL column definition, e.g. "id INTEGER PRIMARY KEY" or "name TEXT NOT NULL".
+// Returns an error if the table name contains invalid characters.
+func DBCreateTable(db *sql.DB, table string, columns []string) error {
+	if !validIdentifier.MatchString(table) {
+		return fmt.Errorf("db_create_table: invalid table name %q (only alphanumeric and underscore allowed)", table)
+	}
+	if len(columns) == 0 {
+		return fmt.Errorf("db_create_table: at least one column definition required")
+	}
+	query := fmt.Sprintf(
+		"CREATE TABLE IF NOT EXISTS %s (%s)",
+		table,
+		strings.Join(columns, ", "),
+	)
+	if _, err := db.Exec(query); err != nil {
+		return fmt.Errorf("db_create_table %q: %w", table, err)
+	}
+	return nil
+}
diff --git a/functions/infra/db_create_table.md b/functions/infra/db_create_table.md
new file mode 100644
index 00000000..b4430439
--- /dev/null
+++ b/functions/infra/db_create_table.md
@@ -0,0 +1,36 @@
+---
+name: db_create_table
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "func DBCreateTable(db *sql.DB, table string, columns []string) error"
+description: "Ejecuta CREATE TABLE IF NOT EXISTS con las definiciones de columnas dadas. Valida que el nombre de tabla sea un identificador SQL seguro."
+tags: [database, sql, ddl, create, table, schema]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: ["database/sql", "regexp", "strings"]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/db_create_table.go"
+---
+
+## Ejemplo
+
+```go
+err := DBCreateTable(db, "events", []string{
+    "id INTEGER PRIMARY KEY AUTOINCREMENT",
+    "name TEXT NOT NULL",
+    "ts  INTEGER NOT NULL",
+    "payload TEXT",
+})
+```
+
+## Notas
+
+`columns` son definiciones SQL completas incluyendo nombre, tipo y constraints. Usa `CREATE TABLE IF NOT EXISTS` para ser idempotente. Valida el nombre de tabla con regex `^[a-zA-Z_][a-zA-Z0-9_]*$` para prevenir SQL injection. Las definiciones de columna no se sanitizan — son responsabilidad del llamador.
diff --git a/functions/infra/db_exec.go b/functions/infra/db_exec.go
new file mode 100644
index 00000000..1f0ca6c2
--- /dev/null
+++ b/functions/infra/db_exec.go
@@ -0,0 +1,22 @@
+package infra
+
+import (
+	"database/sql"
+	"fmt"
+)
+
+// DBExec executes a non-SELECT statement (INSERT, UPDATE, DELETE, DDL) and
+// returns the number of rows affected. For statements that don't return rows
+// affected (e.g. DDL on some drivers), the count may be 0.
+func DBExec(db *sql.DB, query string, args ...any) (int64, error) {
+	result, err := db.Exec(query, args...)
+	if err != nil {
+		return 0, fmt.Errorf("db_exec: %w", err)
+	}
+	n, err := result.RowsAffected()
+	if err != nil {
+		// Some drivers don't support RowsAffected; treat as 0.
+		return 0, nil
+	}
+	return n, nil
+}
diff --git a/functions/infra/db_exec.md b/functions/infra/db_exec.md
new file mode 100644
index 00000000..19288698
--- /dev/null
+++ b/functions/infra/db_exec.md
@@ -0,0 +1,35 @@
+---
+name: db_exec
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "func DBExec(db *sql.DB, query string, args ...any) (int64, error)"
+description: "Ejecuta un statement no-SELECT (INSERT, UPDATE, DELETE, DDL) y retorna el numero de filas afectadas."
+tags: [database, sql, exec, insert, update, delete, ddl]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: ["database/sql"]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/db_exec.go"
+---
+
+## Ejemplo
+
+```go
+n, err := DBExec(db, "UPDATE users SET active = ? WHERE last_login < ?", false, cutoff)
+if err != nil {
+    return err
+}
+fmt.Printf("desactivados: %d usuarios\n", n)
+```
+
+## Notas
+
+Agnóstica al driver. Para DDL algunos drivers retornan 0 en RowsAffected — esto es normal. Para INSERT con last_insert_id usar `DBInsertRow` que retorna ese valor. Para multiples filas en una transaccion usar `DBInsertBatch`.
diff --git a/functions/infra/db_insert_batch.go b/functions/infra/db_insert_batch.go
new file mode 100644
index 00000000..99df7bfa
--- /dev/null
+++ b/functions/infra/db_insert_batch.go
@@ -0,0 +1,70 @@
+package infra
+
+import (
+	"database/sql"
+	"fmt"
+	"strings"
+)
+
+// DBInsertBatch inserts multiple rows into a table using a prepared statement
+// inside a transaction. columns must match the order of values in each row.
+// Returns the total number of rows affected.
+// Column and table names are validated to contain only safe identifier chars.
+func DBInsertBatch(db *sql.DB, table string, columns []string, rows [][]any) (int64, error) {
+	if !validIdentifier.MatchString(table) {
+		return 0, fmt.Errorf("db_insert_batch: invalid table name %q", table)
+	}
+	if len(columns) == 0 {
+		return 0, fmt.Errorf("db_insert_batch: columns must not be empty")
+	}
+	if len(rows) == 0 {
+		return 0, nil
+	}
+
+	for _, col := range columns {
+		if !validIdentifier.MatchString(col) {
+			return 0, fmt.Errorf("db_insert_batch: invalid column name %q", col)
+		}
+	}
+
+	placeholders := make([]string, len(columns))
+	for i := range columns {
+		placeholders[i] = "?"
+	}
+	query := fmt.Sprintf(
+		"INSERT INTO %s (%s) VALUES (%s)",
+		table,
+		strings.Join(columns, ", "),
+		strings.Join(placeholders, ", "),
+	)
+
+	tx, err := db.Begin()
+	if err != nil {
+		return 0, fmt.Errorf("db_insert_batch: begin tx: %w", err)
+	}
+	defer tx.Rollback() //nolint:errcheck
+
+	stmt, err := tx.Prepare(query)
+	if err != nil {
+		return 0, fmt.Errorf("db_insert_batch: prepare: %w", err)
+	}
+	defer stmt.Close()
+
+	var total int64
+	for i, row := range rows {
+		if len(row) != len(columns) {
+			return 0, fmt.Errorf("db_insert_batch: row %d has %d values, expected %d", i, len(row), len(columns))
+		}
+		result, err := stmt.Exec(row...)
+		if err != nil {
+			return 0, fmt.Errorf("db_insert_batch: exec row %d: %w", i, err)
+		}
+		n, _ := result.RowsAffected()
+		total += n
+	}
+
+	if err := tx.Commit(); err != nil {
+		return 0, fmt.Errorf("db_insert_batch: commit: %w", err)
+	}
+	return total, nil
+}
diff --git a/functions/infra/db_insert_batch.md b/functions/infra/db_insert_batch.md
new file mode 100644
index 00000000..4b91159a
--- /dev/null
+++ b/functions/infra/db_insert_batch.md
@@ -0,0 +1,41 @@
+---
+name: db_insert_batch
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "func DBInsertBatch(db *sql.DB, table string, columns []string, rows [][]any) (int64, error)"
+description: "Inserta multiples filas en una transaccion usando prepared statement. Retorna el total de filas afectadas. Mas eficiente que llamar DBInsertRow en un loop."
+tags: [database, sql, insert, batch, transaction, bulk]
+uses_functions: [db_insert_row_go_infra]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: ["database/sql", "strings"]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/db_insert_batch.go"
+---
+
+## Ejemplo
+
+```go
+cols := []string{"name", "score", "ts"}
+rows := [][]any{
+    {"Alice", 95.5, 1700000000},
+    {"Bob",   87.2, 1700000001},
+    {"Carol", 91.0, 1700000002},
+}
+n, err := DBInsertBatch(db, "results", cols, rows)
+if err != nil {
+    return err
+}
+fmt.Printf("insertadas: %d filas\n", n)
+```
+
+## Notas
+
+Usa `tx.Prepare()` + `stmt.Exec()` en un loop dentro de una transaccion. El rollback es automatico si alguna fila falla. Valida tabla y columnas con regex. Cada fila debe tener exactamente `len(columns)` valores — retorna error descriptivo si no coincide.
diff --git a/functions/infra/db_insert_row.go b/functions/infra/db_insert_row.go
new file mode 100644
index 00000000..ef05a934
--- /dev/null
+++ b/functions/infra/db_insert_row.go
@@ -0,0 +1,54 @@
+package infra
+
+import (
+	"database/sql"
+	"fmt"
+	"sort"
+	"strings"
+)
+
+// DBInsertRow generates and executes a single-row INSERT from a map of
+// column→value pairs. Returns the last insert ID reported by the driver.
+// Column and table names are validated to contain only safe identifier chars.
+func DBInsertRow(db *sql.DB, table string, row map[string]any) (int64, error) {
+	if !validIdentifier.MatchString(table) {
+		return 0, fmt.Errorf("db_insert_row: invalid table name %q", table)
+	}
+	if len(row) == 0 {
+		return 0, fmt.Errorf("db_insert_row: row map must not be empty")
+	}
+
+	// Sort keys for deterministic query generation.
+	cols := make([]string, 0, len(row))
+	for col := range row {
+		if !validIdentifier.MatchString(col) {
+			return 0, fmt.Errorf("db_insert_row: invalid column name %q", col)
+		}
+		cols = append(cols, col)
+	}
+	sort.Strings(cols)
+
+	placeholders := make([]string, len(cols))
+	values := make([]any, len(cols))
+	for i, col := range cols {
+		placeholders[i] = "?"
+		values[i] = row[col]
+	}
+
+	query := fmt.Sprintf(
+		"INSERT INTO %s (%s) VALUES (%s)",
+		table,
+		strings.Join(cols, ", "),
+		strings.Join(placeholders, ", "),
+	)
+
+	result, err := db.Exec(query, values...)
+	if err != nil {
+		return 0, fmt.Errorf("db_insert_row %q: %w", table, err)
+	}
+	id, err := result.LastInsertId()
+	if err != nil {
+		return 0, nil
+	}
+	return id, nil
+}
diff --git a/functions/infra/db_insert_row.md b/functions/infra/db_insert_row.md
new file mode 100644
index 00000000..181c0c16
--- /dev/null
+++ b/functions/infra/db_insert_row.md
@@ -0,0 +1,39 @@
+---
+name: db_insert_row
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "func DBInsertRow(db *sql.DB, table string, row map[string]any) (int64, error)"
+description: "Genera y ejecuta un INSERT de una sola fila desde un map columna→valor. Retorna el last insert ID. Sanitiza nombres de tabla y columnas."
+tags: [database, sql, insert, row, dynamic]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: ["database/sql", "sort", "strings"]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/db_insert_row.go"
+---
+
+## Ejemplo
+
+```go
+id, err := DBInsertRow(db, "users", map[string]any{
+    "name":   "Alice",
+    "email":  "alice@example.com",
+    "active": true,
+})
+if err != nil {
+    return err
+}
+fmt.Printf("nuevo usuario ID: %d\n", id)
+```
+
+## Notas
+
+Las claves del map se ordenan alfabeticamente para generar queries deterministas. Valida tabla y columnas con regex `^[a-zA-Z_][a-zA-Z0-9_]*$`. Para insertar muchas filas usar `DBInsertBatch` que es mas eficiente. El last insert ID puede ser 0 en drivers que no lo soportan (ej: postgres — usar RETURNING en su lugar con `DBQuery`).
diff --git a/functions/infra/db_query.go b/functions/infra/db_query.go
new file mode 100644
index 00000000..e134ac73
--- /dev/null
+++ b/functions/infra/db_query.go
@@ -0,0 +1,79 @@
+package infra
+
+import (
+	"database/sql"
+	"fmt"
+	"strconv"
+)
+
+// DBQuery executes a SELECT query and returns the results as a slice of maps.
+// Each map key is the column name; values are converted to native Go types:
+// int64, float64, bool, string, []byte, or nil for NULLs.
+func DBQuery(db *sql.DB, query string, args ...any) ([]map[string]any, error) {
+	rows, err := db.Query(query, args...)
+	if err != nil {
+		return nil, fmt.Errorf("db_query: %w", err)
+	}
+	defer rows.Close()
+
+	cols, err := rows.Columns()
+	if err != nil {
+		return nil, fmt.Errorf("db_query: columns: %w", err)
+	}
+	colTypes, err := rows.ColumnTypes()
+	if err != nil {
+		return nil, fmt.Errorf("db_query: column types: %w", err)
+	}
+
+	var results []map[string]any
+	for rows.Next() {
+		// Use RawBytes so we can inspect the raw value before converting.
+		raw := make([]sql.RawBytes, len(cols))
+		ptrs := make([]any, len(cols))
+		for i := range raw {
+			ptrs[i] = &raw[i]
+		}
+		if err := rows.Scan(ptrs...); err != nil {
+			return nil, fmt.Errorf("db_query: scan: %w", err)
+		}
+
+		row := make(map[string]any, len(cols))
+		for i, col := range cols {
+			if raw[i] == nil {
+				row[col] = nil
+				continue
+			}
+			row[col] = convertRaw(raw[i], colTypes[i].DatabaseTypeName())
+		}
+		results = append(results, row)
+	}
+	if err := rows.Err(); err != nil {
+		return nil, fmt.Errorf("db_query: rows: %w", err)
+	}
+	return results, nil
+}
+
+// convertRaw attempts to convert a raw SQL byte slice into a native Go type
+// based on the database column type name hint.
+func convertRaw(b sql.RawBytes, dbType string) any {
+	s := string(b)
+	switch dbType {
+	case "INTEGER", "INT", "BIGINT", "SMALLINT", "TINYINT", "INT2", "INT4", "INT8":
+		if v, err := strconv.ParseInt(s, 10, 64); err == nil {
+			return v
+		}
+	case "REAL", "FLOAT", "DOUBLE", "NUMERIC", "DECIMAL":
+		if v, err := strconv.ParseFloat(s, 64); err == nil {
+			return v
+		}
+	case "BOOLEAN", "BOOL":
+		if v, err := strconv.ParseBool(s); err == nil {
+			return v
+		}
+	case "BLOB":
+		cp := make([]byte, len(b))
+		copy(cp, b)
+		return cp
+	}
+	return s
+}
diff --git a/functions/infra/db_query.md b/functions/infra/db_query.md
new file mode 100644
index 00000000..582ad209
--- /dev/null
+++ b/functions/infra/db_query.md
@@ -0,0 +1,37 @@
+---
+name: db_query
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "func DBQuery(db *sql.DB, query string, args ...any) ([]map[string]any, error)"
+description: "Ejecuta un SELECT y retorna los resultados como slice de maps. Convierte valores a tipos nativos Go segun el tipo de columna reportado por el driver."
+tags: [database, sql, query, select, generic]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: ["database/sql"]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/db_query.go"
+---
+
+## Ejemplo
+
+```go
+rows, err := DBQuery(db, "SELECT id, name, score FROM players WHERE active = ?", true)
+if err != nil {
+    return err
+}
+for _, row := range rows {
+    fmt.Println(row["name"], row["score"])
+}
+```
+
+## Notas
+
+Agnóstica al driver — funciona con cualquier `*sql.DB` (sqlite, duckdb, postgres, clickhouse). Usa `sql.RawBytes` + `ColumnTypes()` para conversion dinamica. Convierte INTEGER→int64, FLOAT/REAL/DOUBLE→float64, BOOLEAN→bool, BLOB→[]byte, NULL→nil, resto→string. Para queries con muchos resultados considerar paginar con LIMIT/OFFSET.
diff --git a/functions/infra/docker_run_container.go b/functions/infra/docker_run_container.go
index 895a1de4..ff47ae12 100644
--- a/functions/infra/docker_run_container.go
+++ b/functions/infra/docker_run_container.go
@@ -15,6 +15,8 @@ type DockerRunOpts struct {
 	Detach  bool              // Ejecutar en background
 	Remove  bool              // Eliminar al terminar (--rm)
 	Network string            // Red Docker (opcional)
+	CapAdd  []string          // Linux capabilities, ej: ["NET_ADMIN", "SYS_MODULE"]
+	Cmd     []string          // Comando a ejecutar en el contenedor (opcional)
 }
 
 // DockerRunContainer ejecuta un contenedor Docker nuevo con la imagen y opciones dadas.
@@ -43,8 +45,12 @@ func DockerRunContainer(image string, opts DockerRunOpts) (string, error) {
 	for _, vol := range opts.Volumes {
 		args = append(args, "-v", vol)
 	}
+	for _, cap := range opts.CapAdd {
+		args = append(args, "--cap-add", cap)
+	}
 
 	args = append(args, image)
+	args = append(args, opts.Cmd...)
 
 	out, err := exec.Command("docker", args...).CombinedOutput()
 	if err != nil {
diff --git a/functions/infra/duckdb_open.go b/functions/infra/duckdb_open.go
new file mode 100644
index 00000000..9a240a8c
--- /dev/null
+++ b/functions/infra/duckdb_open.go
@@ -0,0 +1,27 @@
+package infra
+
+import (
+	"database/sql"
+	"fmt"
+
+	_ "github.com/marcboeker/go-duckdb"
+)
+
+// DuckDBOpen opens (or creates) a DuckDB database file.
+// Pass an empty path or ":memory:" for an in-memory database.
+// Returns a ready-to-use *sql.DB or an error.
+func DuckDBOpen(path string) (*sql.DB, error) {
+	dsn := path
+	if dsn == "" {
+		dsn = ":memory:"
+	}
+	db, err := sql.Open("duckdb", dsn)
+	if err != nil {
+		return nil, fmt.Errorf("duckdb_open: open %q: %w", dsn, err)
+	}
+	if err := db.Ping(); err != nil {
+		db.Close()
+		return nil, fmt.Errorf("duckdb_open: ping %q: %w", dsn, err)
+	}
+	return db, nil
+}
diff --git a/functions/infra/duckdb_open.md b/functions/infra/duckdb_open.md
new file mode 100644
index 00000000..b8602c95
--- /dev/null
+++ b/functions/infra/duckdb_open.md
@@ -0,0 +1,38 @@
+---
+name: duckdb_open
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "func DuckDBOpen(path string) (*sql.DB, error)"
+description: "Abre (o crea) una base de datos DuckDB. Path vacio o ':memory:' abre una base en memoria."
+tags: [database, duckdb, connection, sql, analytics]
+uses_functions: []
+uses_types: [db_config_go_infra]
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: ["database/sql", "github.com/marcboeker/go-duckdb"]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/duckdb_open.go"
+---
+
+## Ejemplo
+
+```go
+// In-memory para analisis temporal
+db, err := DuckDBOpen("")
+if err != nil {
+    log.Fatal(err)
+}
+defer DBClose(db)
+
+rows, err := DBQuery(db, "SELECT * FROM read_parquet('/data/sales.parquet')")
+```
+
+## Notas
+
+Usa el driver `github.com/marcboeker/go-duckdb` (CGO). DuckDB es una base de datos OLAP embebida, ideal para analisis de datos. Path vacio equivale a `:memory:`. Hace ping al abrir para detectar errores temprano.
diff --git a/functions/infra/nordvpn_container_run.go b/functions/infra/nordvpn_container_run.go
new file mode 100644
index 00000000..c12c2018
--- /dev/null
+++ b/functions/infra/nordvpn_container_run.go
@@ -0,0 +1,44 @@
+package infra
+
+import (
+	"fmt"
+)
+
+// NordVPNContainerRunOpts opciones para ejecutar un container a traves del gateway NordVPN.
+type NordVPNContainerRunOpts struct {
+	Image   string            // Imagen Docker a ejecutar (obligatorio)
+	Cmd     []string          // Comando a ejecutar en el container
+	Env     map[string]string // Variables de entorno
+	Volumes []string          // Bind mounts
+	Name    string            // Nombre del container (opcional)
+	Gateway string            // Nombre del container NordVPN gateway (default: "nordvpn")
+	Detach  bool              // Ejecutar en background
+	Remove  bool              // Eliminar al terminar (--rm)
+}
+
+// NordVPNContainerRun ejecuta un container Docker cuyo trafico de red
+// pasa por el container gateway NordVPN usando --network=container:<gateway>.
+// Devuelve el ID del container creado.
+func NordVPNContainerRun(opts NordVPNContainerRunOpts) (string, error) {
+	if opts.Image == "" {
+		return "", fmt.Errorf("image required")
+	}
+	if opts.Gateway == "" {
+		opts.Gateway = "nordvpn"
+	}
+
+	id, err := DockerRunContainer(opts.Image, DockerRunOpts{
+		Name:    opts.Name,
+		Env:     opts.Env,
+		Volumes: opts.Volumes,
+		Detach:  opts.Detach,
+		Remove:  opts.Remove,
+		Network: "container:" + opts.Gateway,
+		Cmd:     opts.Cmd,
+	})
+	if err != nil {
+		return "", fmt.Errorf("nordvpn container run %s: %w", opts.Image, err)
+	}
+
+	return id, nil
+}
diff --git a/functions/infra/nordvpn_container_run.md b/functions/infra/nordvpn_container_run.md
new file mode 100644
index 00000000..e33ec2e2
--- /dev/null
+++ b/functions/infra/nordvpn_container_run.md
@@ -0,0 +1,53 @@
+---
+name: nordvpn_container_run
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "func NordVPNContainerRun(opts NordVPNContainerRunOpts) (string, error)"
+description: "Ejecuta un container Docker cuyo trafico pasa por el gateway NordVPN usando --network=container:<gateway>. El container hereda la IP y tunel VPN del gateway."
+tags: [vpn, nordvpn, docker, container, run, infra, network]
+uses_functions: ["docker_run_container_go_infra"]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: [fmt]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/nordvpn_container_run.go"
+---
+
+## Ejemplo
+
+```go
+// Verificar IP desde VPN
+id, err := NordVPNContainerRun(NordVPNContainerRunOpts{
+    Image:   "curlimages/curl",
+    Cmd:     []string{"https://api.ipify.org"},
+    Remove:  true,
+    Gateway: "nordvpn",
+})
+
+// Ejecutar scraper bajo VPN
+id, err := NordVPNContainerRun(NordVPNContainerRunOpts{
+    Image:   "my-scraper:latest",
+    Env:     map[string]string{"TARGET_URL": "https://example.com"},
+    Volumes: []string{"/tmp/output:/output"},
+    Detach:  true,
+    Name:    "scraper-vpn",
+})
+
+// Navegador headless bajo VPN
+id, err := NordVPNContainerRun(NordVPNContainerRunOpts{
+    Image:   "chromedp/headless-shell",
+    Detach:  true,
+    Name:    "chrome-vpn",
+})
+```
+
+## Notas
+
+Requiere que el container gateway NordVPN este corriendo (usar `NordVPNContainerStart` primero). El container cliente no necesita capabilities especiales — hereda la red del gateway. Con `--network=container:X` el container no puede exponer puertos propios; los puertos deben mapearse en el gateway.
diff --git a/functions/infra/nordvpn_container_start.go b/functions/infra/nordvpn_container_start.go
new file mode 100644
index 00000000..219cf652
--- /dev/null
+++ b/functions/infra/nordvpn_container_start.go
@@ -0,0 +1,73 @@
+package infra
+
+import (
+	"fmt"
+	"strings"
+	"time"
+)
+
+// NordVPNContainerOpts opciones para el container gateway NordVPN.
+type NordVPNContainerOpts struct {
+	Token    string // Token de acceso NordVPN (obligatorio)
+	Country  string // Pais al que conectar (opcional, ej: "Spain")
+	City     string // Ciudad (opcional, ej: "Madrid")
+	Protocol string // "NordLynx" o "OpenVPN" (default: NordLynx)
+	Name     string // Nombre del container (default: "nordvpn")
+}
+
+// NordVPNContainerStart levanta un container Docker con NordVPN como gateway.
+// Otros containers pueden usar su red con --network=container:<name>.
+// Espera hasta que el tunel este activo o timeout de 30s.
+func NordVPNContainerStart(opts NordVPNContainerOpts) (string, error) {
+	if opts.Token == "" {
+		return "", fmt.Errorf("nordvpn token required")
+	}
+	if opts.Name == "" {
+		opts.Name = "nordvpn"
+	}
+	if opts.Protocol == "" {
+		opts.Protocol = "NordLynx"
+	}
+
+	env := map[string]string{
+		"TOKEN":      opts.Token,
+		"TECHNOLOGY": opts.Protocol,
+	}
+	if opts.Country != "" {
+		connect := opts.Country
+		if opts.City != "" {
+			connect += " " + opts.City
+		}
+		env["CONNECT"] = connect
+	}
+
+	// Limpiar container previo con el mismo nombre si existe
+	_ = DockerRemoveContainer(opts.Name, true)
+
+	id, err := DockerRunContainer("ghcr.io/bubuntux/nordvpn", DockerRunOpts{
+		Name:   opts.Name,
+		Env:    env,
+		Detach: true,
+		CapAdd: []string{"NET_ADMIN", "NET_RAW"},
+	})
+	if err != nil {
+		return "", fmt.Errorf("nordvpn container start: %w", err)
+	}
+
+	// Esperar a que el tunel este activo
+	for i := 0; i < 30; i++ {
+		time.Sleep(1 * time.Second)
+		logs, logErr := DockerContainerLogs(opts.Name, 20)
+		if logErr != nil {
+			continue
+		}
+		if strings.Contains(logs, "Connected") || strings.Contains(logs, "connected") {
+			return id, nil
+		}
+		if strings.Contains(logs, "error") || strings.Contains(logs, "failed") {
+			return id, fmt.Errorf("nordvpn connection failed, check logs: docker logs %s", opts.Name)
+		}
+	}
+
+	return id, fmt.Errorf("nordvpn connection timeout after 30s, check logs: docker logs %s", opts.Name)
+}
diff --git a/functions/infra/nordvpn_container_start.md b/functions/infra/nordvpn_container_start.md
new file mode 100644
index 00000000..4189673f
--- /dev/null
+++ b/functions/infra/nordvpn_container_start.md
@@ -0,0 +1,42 @@
+---
+name: nordvpn_container_start
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "func NordVPNContainerStart(opts NordVPNContainerOpts) (string, error)"
+description: "Levanta un container Docker con NordVPN como gateway de red. Otros containers pueden rutear su trafico a traves de este con --network=container:<name>. Espera hasta 30s a que el tunel este activo."
+tags: [vpn, nordvpn, docker, container, gateway, infra, network]
+uses_functions: ["docker_run_container_go_infra", "docker_remove_container_go_infra", "docker_container_logs_go_infra"]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: [fmt, strings, time]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/nordvpn_container_start.go"
+---
+
+## Ejemplo
+
+```go
+id, err := NordVPNContainerStart(NordVPNContainerOpts{
+    Token:   os.Getenv("NORDVPN_TOKEN"),
+    Country: "Spain",
+    City:    "Madrid",
+})
+if err != nil {
+    log.Fatal(err)
+}
+fmt.Println("VPN gateway:", id)
+
+// Ahora otros containers pueden usar la VPN:
+// docker run --network=container:nordvpn curlimages/curl https://api.ipify.org
+```
+
+## Notas
+
+Usa la imagen `ghcr.io/bubuntux/nordvpn`. Requiere un token de acceso NordVPN (obtener con `nordvpn token` desde CLI o desde la web de NordVPN). Limpia containers previos con el mismo nombre automaticamente. El protocolo por defecto es NordLynx (WireGuard).
diff --git a/functions/infra/nordvpn_container_stop.go b/functions/infra/nordvpn_container_stop.go
new file mode 100644
index 00000000..8feba515
--- /dev/null
+++ b/functions/infra/nordvpn_container_stop.go
@@ -0,0 +1,29 @@
+package infra
+
+import (
+	"fmt"
+)
+
+// NordVPNContainerStop detiene y elimina el container gateway NordVPN.
+// Tambien detiene containers que usen su red si se proporcionan.
+func NordVPNContainerStop(gateway string, clientNames ...string) error {
+	if gateway == "" {
+		gateway = "nordvpn"
+	}
+
+	// Primero parar los clientes que usan la red del gateway
+	for _, name := range clientNames {
+		_ = DockerStopContainer(name, 5)
+		_ = DockerRemoveContainer(name, true)
+	}
+
+	// Parar y eliminar el gateway
+	if err := DockerStopContainer(gateway, 10); err != nil {
+		return fmt.Errorf("nordvpn container stop: %w", err)
+	}
+	if err := DockerRemoveContainer(gateway, true); err != nil {
+		return fmt.Errorf("nordvpn container remove: %w", err)
+	}
+
+	return nil
+}
diff --git a/functions/infra/nordvpn_container_stop.md b/functions/infra/nordvpn_container_stop.md
new file mode 100644
index 00000000..f0b68321
--- /dev/null
+++ b/functions/infra/nordvpn_container_stop.md
@@ -0,0 +1,35 @@
+---
+name: nordvpn_container_stop
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "func NordVPNContainerStop(gateway string, clientNames ...string) error"
+description: "Detiene y elimina el container gateway NordVPN y opcionalmente los containers cliente que usan su red."
+tags: [vpn, nordvpn, docker, container, stop, cleanup, infra]
+uses_functions: ["docker_stop_container_go_infra", "docker_remove_container_go_infra"]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: [fmt]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/nordvpn_container_stop.go"
+---
+
+## Ejemplo
+
+```go
+// Parar solo el gateway
+err := NordVPNContainerStop("nordvpn")
+
+// Parar gateway y clientes asociados
+err := NordVPNContainerStop("nordvpn", "chrome-vpn", "scraper-vpn")
+```
+
+## Notas
+
+Detiene primero los containers cliente (si se proporcionan) y luego el gateway. Importante: si los clientes usan `--network=container:nordvpn`, deben pararse antes que el gateway para evitar errores de red. Los clientes se paran con timeout de 5s, el gateway con 10s.
diff --git a/functions/infra/parse_nordvpn_status.go b/functions/infra/parse_nordvpn_status.go
new file mode 100644
index 00000000..0cc78472
--- /dev/null
+++ b/functions/infra/parse_nordvpn_status.go
@@ -0,0 +1,68 @@
+package infra
+
+import (
+	"regexp"
+	"strings"
+)
+
+// NordVPNStatus representa el estado parseado de nordvpn status.
+type NordVPNStatus struct {
+	Connected  bool   // true si hay conexion activa
+	Status     string // "Connected" o "Disconnected"
+	Hostname   string // ej: "es42.nordvpn.com"
+	IP         string // IP del servidor VPN
+	Country    string // ej: "Spain"
+	City       string // ej: "Madrid"
+	Technology string // ej: "NordLynx"
+	Protocol   string // ej: "nordlynx"
+	Transfer   string // ej: "1.2 MiB received, 500 KiB sent"
+	Uptime     string // ej: "5 minutes 32 seconds"
+}
+
+// ansiRegexp elimina codigos de escape ANSI.
+var ansiRegexp = regexp.MustCompile(`\x1b\[[0-9;]*m`)
+
+// ParseNordVPNStatus parsea la salida de texto de `nordvpn status`
+// a un struct tipado. Funcion pura — no ejecuta comandos.
+func ParseNordVPNStatus(output string) NordVPNStatus {
+	var s NordVPNStatus
+
+	lines := strings.Split(output, "\n")
+	for _, line := range lines {
+		line = ansiRegexp.ReplaceAllString(line, "")
+		line = strings.TrimSpace(line)
+		line = strings.TrimLeft(line, "- ")
+
+		idx := strings.Index(line, ":")
+		if idx < 0 {
+			continue
+		}
+
+		key := strings.ToLower(strings.TrimSpace(line[:idx]))
+		val := strings.TrimSpace(line[idx+1:])
+
+		switch key {
+		case "status":
+			s.Status = val
+			s.Connected = strings.EqualFold(val, "connected")
+		case "hostname", "server":
+			s.Hostname = val
+		case "ip":
+			s.IP = val
+		case "country":
+			s.Country = val
+		case "city":
+			s.City = val
+		case "current technology":
+			s.Technology = val
+		case "current protocol":
+			s.Protocol = val
+		case "transfer":
+			s.Transfer = val
+		case "uptime":
+			s.Uptime = val
+		}
+	}
+
+	return s
+}
diff --git a/functions/infra/parse_nordvpn_status.md b/functions/infra/parse_nordvpn_status.md
new file mode 100644
index 00000000..64cf3d1c
--- /dev/null
+++ b/functions/infra/parse_nordvpn_status.md
@@ -0,0 +1,41 @@
+---
+name: parse_nordvpn_status
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: pure
+signature: "func ParseNordVPNStatus(output string) NordVPNStatus"
+description: "Parsea la salida de texto de nordvpn status a un struct tipado. Elimina codigos ANSI y normaliza claves."
+tags: [vpn, nordvpn, parser, pure, infra]
+uses_functions: []
+uses_types: ["NordVPNStatus_go_infra"]
+returns: []
+returns_optional: false
+error_type: ""
+imports: ["regexp", "strings"]
+tested: true
+tests: ["TestParseNordVPNStatus_Connected", "TestParseNordVPNStatus_Disconnected", "TestParseNordVPNStatus_WithANSI"]
+test_file_path: "functions/infra/parse_nordvpn_status_test.go"
+file_path: "functions/infra/parse_nordvpn_status.go"
+---
+
+## Ejemplo
+
+```go
+output := `Status: Connected
+Hostname: es42.nordvpn.com
+IP: 185.230.124.42
+Country: Spain
+City: Madrid
+Current Technology: NordLynx`
+
+s := ParseNordVPNStatus(output)
+// s.Connected == true
+// s.Hostname == "es42.nordvpn.com"
+// s.Country == "Spain"
+```
+
+## Notas
+
+Funcion pura — no ejecuta comandos ni accede a red. Maneja codigos ANSI que NordVPN CLI emite en terminal. Campos no presentes en la salida quedan como zero value.
diff --git a/functions/infra/parse_nordvpn_status_test.go b/functions/infra/parse_nordvpn_status_test.go
new file mode 100644
index 00000000..829dc91d
--- /dev/null
+++ b/functions/infra/parse_nordvpn_status_test.go
@@ -0,0 +1,62 @@
+package infra
+
+import "testing"
+
+func TestParseNordVPNStatus_Connected(t *testing.T) {
+	input := `Status: Connected
+Hostname: es42.nordvpn.com
+IP: 185.230.124.42
+Country: Spain
+City: Madrid
+Current Technology: NordLynx
+Current Protocol: nordlynx
+Transfer: 1.2 MiB received, 500 KiB sent
+Uptime: 5 minutes 32 seconds`
+
+	got := ParseNordVPNStatus(input)
+
+	if !got.Connected {
+		t.Error("expected Connected=true")
+	}
+	if got.Hostname != "es42.nordvpn.com" {
+		t.Errorf("Hostname = %q, want es42.nordvpn.com", got.Hostname)
+	}
+	if got.IP != "185.230.124.42" {
+		t.Errorf("IP = %q, want 185.230.124.42", got.IP)
+	}
+	if got.Country != "Spain" {
+		t.Errorf("Country = %q, want Spain", got.Country)
+	}
+	if got.City != "Madrid" {
+		t.Errorf("City = %q, want Madrid", got.City)
+	}
+	if got.Technology != "NordLynx" {
+		t.Errorf("Technology = %q, want NordLynx", got.Technology)
+	}
+}
+
+func TestParseNordVPNStatus_Disconnected(t *testing.T) {
+	input := `Status: Disconnected`
+
+	got := ParseNordVPNStatus(input)
+
+	if got.Connected {
+		t.Error("expected Connected=false")
+	}
+	if got.Status != "Disconnected" {
+		t.Errorf("Status = %q, want Disconnected", got.Status)
+	}
+}
+
+func TestParseNordVPNStatus_WithANSI(t *testing.T) {
+	input := "\x1b[32mStatus: Connected\x1b[0m\n\x1b[32m- Hostname: us1234.nordvpn.com\x1b[0m"
+
+	got := ParseNordVPNStatus(input)
+
+	if !got.Connected {
+		t.Error("expected Connected=true with ANSI codes")
+	}
+	if got.Hostname != "us1234.nordvpn.com" {
+		t.Errorf("Hostname = %q, want us1234.nordvpn.com", got.Hostname)
+	}
+}
diff --git a/functions/infra/postgres_open.go b/functions/infra/postgres_open.go
new file mode 100644
index 00000000..548ee491
--- /dev/null
+++ b/functions/infra/postgres_open.go
@@ -0,0 +1,32 @@
+package infra
+
+import (
+	"database/sql"
+	"fmt"
+
+	_ "github.com/jackc/pgx/v5/stdlib"
+)
+
+// PostgresOpen connects to a PostgreSQL server and returns a *sql.DB.
+// sslmode defaults to "disable" when empty.
+// Constructs a DSN of the form:
+//
+//	host=<host> port=<port> user=<user> password=<password> dbname=<dbname> sslmode=<sslmode>
+func PostgresOpen(host string, port int, user, password, dbname string, sslmode string) (*sql.DB, error) {
+	if sslmode == "" {
+		sslmode = "disable"
+	}
+	dsn := fmt.Sprintf(
+		"host=%s port=%d user=%s password=%s dbname=%s sslmode=%s",
+		host, port, user, password, dbname, sslmode,
+	)
+	db, err := sql.Open("pgx", dsn)
+	if err != nil {
+		return nil, fmt.Errorf("postgres_open: open: %w", err)
+	}
+	if err := db.Ping(); err != nil {
+		db.Close()
+		return nil, fmt.Errorf("postgres_open: ping %s:%d/%s: %w", host, port, dbname, err)
+	}
+	return db, nil
+}
diff --git a/functions/infra/postgres_open.md b/functions/infra/postgres_open.md
new file mode 100644
index 00000000..f9c4f1f2
--- /dev/null
+++ b/functions/infra/postgres_open.md
@@ -0,0 +1,37 @@
+---
+name: postgres_open
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "func PostgresOpen(host string, port int, user, password, dbname string, sslmode string) (*sql.DB, error)"
+description: "Conecta a PostgreSQL construyendo el DSN desde parametros individuales. sslmode por defecto 'disable' si vacio."
+tags: [database, postgres, postgresql, connection, sql]
+uses_functions: []
+uses_types: [db_config_go_infra]
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: ["database/sql", "github.com/jackc/pgx/v5/stdlib"]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/postgres_open.go"
+---
+
+## Ejemplo
+
+```go
+db, err := PostgresOpen("localhost", 5432, "user", "secret", "mydb", "disable")
+if err != nil {
+    log.Fatal(err)
+}
+defer DBClose(db)
+
+rows, err := DBQuery(db, "SELECT id, name FROM users WHERE active = $1", true)
+```
+
+## Notas
+
+Usa el driver `github.com/jackc/pgx/v5/stdlib` registrado como "pgx". Construye DSN con los parametros separados para mayor legibilidad. Para produccion usar `sslmode=require` o `sslmode=verify-full`. Hace ping al abrir para verificar conectividad.
diff --git a/functions/infra/scaffold_wails_app.go b/functions/infra/scaffold_wails_app.go
new file mode 100644
index 00000000..63530d34
--- /dev/null
+++ b/functions/infra/scaffold_wails_app.go
@@ -0,0 +1,215 @@
+package infra
+
+import (
+	"context"
+	"fmt"
+	"os"
+	"os/exec"
+	"path/filepath"
+	"strings"
+	"text/template"
+)
+
+// ScaffoldWailsAppConfig configura la generación del proyecto Wails.
+type ScaffoldWailsAppConfig struct {
+	Name        string // Nombre del proyecto
+	Dir         string // Directorio destino
+	Title       string // Título de la ventana
+	Width       int    // Ancho de la ventana (default 1024)
+	Height      int    // Alto de la ventana (default 768)
+	Author      string // Nombre del autor
+	FrontendLib string // Path a la frontend library (default ~/.local_agentes/frontend/frontend)
+}
+
+const mainGoTpl = `package main
+
+import (
+	"embed"
+
+	"github.com/wailsapp/wails/v2"
+	"github.com/wailsapp/wails/v2/pkg/options"
+	"github.com/wailsapp/wails/v2/pkg/options/assetserver"
+)
+
+//go:embed all:frontend/dist
+var assets embed.FS
+
+func main() {
+	app := NewApp()
+
+	err := wails.Run(&options.App{
+		Title:  "{{.Title}}",
+		Width:  {{.Width}},
+		Height: {{.Height}},
+		AssetServer: &assetserver.Options{
+			Assets: assets,
+		},
+		BackgroundColour: &options.RGBA{R: 27, G: 38, B: 54, A: 1},
+		OnStartup:        app.startup,
+		Bind: []interface{}{
+			app,
+		},
+	})
+
+	if err != nil {
+		println("Error:", err.Error())
+	}
+}
+`
+
+const appGoTpl = `package main
+
+import (
+	"context"
+
+	"github.com/wailsapp/wails/v2/pkg/runtime"
+)
+
+// App struct — cada método público se expone como binding IPC al frontend.
+type App struct {
+	ctx context.Context
+}
+
+func NewApp() *App {
+	return &App{}
+}
+
+func (a *App) startup(ctx context.Context) {
+	a.ctx = ctx
+}
+
+// EmitEvent emite un evento al frontend.
+func (a *App) EmitEvent(eventName string, data interface{}) {
+	runtime.EventsEmit(a.ctx, eventName, data)
+}
+
+// Ping verifica que el IPC funciona.
+func (a *App) Ping() string {
+	return "pong"
+}
+`
+
+const wailsJSONTpl = `{
+  "$schema": "https://wails.io/schemas/config.v2.json",
+  "name": "{{.Name}}",
+  "outputfilename": "{{.Name}}",
+  "frontend:dir": "./frontend",
+  "frontend:install": "pnpm install",
+  "frontend:build": "pnpm run build",
+  "frontend:dev:watcher": "pnpm run dev",
+  "frontend:dev:serverUrl": "auto",
+  "wailsjsdir": "./frontend/src/wailsjs",
+  "author": {
+    "name": "{{.Author}}"
+  }
+}
+`
+
+const goModTpl = `module {{.Name}}
+
+go 1.23
+
+require github.com/wailsapp/wails/v2 v2.11.0
+`
+
+// ScaffoldWailsApp genera la estructura base de un proyecto Wails con frontend vinculado.
+func ScaffoldWailsApp(ctx context.Context, cfg ScaffoldWailsAppConfig) error {
+	if cfg.Name == "" {
+		return fmt.Errorf("name is required")
+	}
+	if cfg.Dir == "" {
+		cfg.Dir = cfg.Name
+	}
+	if cfg.Title == "" {
+		cfg.Title = cfg.Name
+	}
+	if cfg.Width == 0 {
+		cfg.Width = 1024
+	}
+	if cfg.Height == 0 {
+		cfg.Height = 768
+	}
+	if cfg.Author == "" {
+		cfg.Author = "Agent"
+	}
+	if cfg.FrontendLib == "" {
+		home, _ := os.UserHomeDir()
+		cfg.FrontendLib = filepath.Join(home, ".local_agentes", "frontend", "frontend")
+	}
+
+	// Crear directorio
+	if err := os.MkdirAll(cfg.Dir, 0755); err != nil {
+		return fmt.Errorf("creating dir: %w", err)
+	}
+
+	// Generar archivos Go
+	files := map[string]string{
+		"main.go":    mainGoTpl,
+		"app.go":     appGoTpl,
+		"wails.json": wailsJSONTpl,
+		"go.mod":     goModTpl,
+	}
+
+	for name, tpl := range files {
+		path := filepath.Join(cfg.Dir, name)
+		t, err := template.New(name).Parse(tpl)
+		if err != nil {
+			return fmt.Errorf("parsing template %s: %w", name, err)
+		}
+		f, err := os.Create(path)
+		if err != nil {
+			return fmt.Errorf("creating %s: %w", name, err)
+		}
+		if err := t.Execute(f, cfg); err != nil {
+			f.Close()
+			return fmt.Errorf("executing template %s: %w", name, err)
+		}
+		f.Close()
+	}
+
+	// Crear frontend como link simbólico o copiar template
+	frontendDir := filepath.Join(cfg.Dir, "frontend")
+	createProjectScript := filepath.Join(filepath.Dir(cfg.FrontendLib), "..", "scripts", "create-project.sh")
+
+	if _, err := os.Stat(createProjectScript); err == nil {
+		// Usar el script de Frontend_Library
+		cmd := exec.CommandContext(ctx, "bash", createProjectScript, cfg.Name, frontendDir, "--wails")
+		cmd.Stdout = os.Stdout
+		cmd.Stderr = os.Stderr
+		if err := cmd.Run(); err != nil {
+			return fmt.Errorf("creating frontend: %w", err)
+		}
+	} else {
+		// Fallback: crear frontend mínimo
+		if err := os.MkdirAll(filepath.Join(frontendDir, "src"), 0755); err != nil {
+			return fmt.Errorf("creating frontend dir: %w", err)
+		}
+		pkgJSON := fmt.Sprintf(`{"name":"%s-frontend","private":true,"scripts":{"dev":"vite","build":"vite build"}}`, cfg.Name)
+		os.WriteFile(filepath.Join(frontendDir, "package.json"), []byte(pkgJSON), 0644)
+	}
+
+	// go mod tidy
+	cmd := exec.CommandContext(ctx, "go", "mod", "tidy")
+	cmd.Dir = cfg.Dir
+	cmd.Stdout = os.Stdout
+	cmd.Stderr = os.Stderr
+	_ = cmd.Run() // No fatal si falla
+
+	fmt.Printf("Wails app scaffolded at %s\n", cfg.Dir)
+	return nil
+}
+
+// GenerateAppBinding genera el código Go para un método de binding.
+func GenerateAppBinding(name string, params []string, returnType string, body string) string {
+	var sb strings.Builder
+	sb.WriteString(fmt.Sprintf("func (a *App) %s(", name))
+	sb.WriteString(strings.Join(params, ", "))
+	sb.WriteString(")")
+	if returnType != "" {
+		sb.WriteString(" " + returnType)
+	}
+	sb.WriteString(" {\n")
+	sb.WriteString("\t" + body + "\n")
+	sb.WriteString("}\n")
+	return sb.String()
+}
diff --git a/functions/infra/scaffold_wails_app.md b/functions/infra/scaffold_wails_app.md
new file mode 100644
index 00000000..a7e4bcb4
--- /dev/null
+++ b/functions/infra/scaffold_wails_app.md
@@ -0,0 +1,38 @@
+---
+name: scaffold_wails_app
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "ScaffoldWailsApp(ctx context.Context, cfg ScaffoldWailsAppConfig) error"
+description: "Genera proyecto Wails completo: main.go con embed, app.go con bindings base, wails.json, go.mod, y frontend vinculado a Frontend_Library."
+tags: [wails, scaffold, desktop, project, generator]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: [os, os/exec, path/filepath, text/template, fmt, strings, context]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/scaffold_wails_app.go"
+---
+
+## Ejemplo
+
+```go
+ScaffoldWailsApp(ctx, ScaffoldWailsAppConfig{
+    Name:   "my-dashboard",
+    Dir:    "/home/user/projects/my-dashboard",
+    Title:  "My Dashboard",
+    Width:  1280,
+    Height: 800,
+    Author: "Lucas",
+})
+```
+
+## Notas
+
+Pipeline que compone: generación de templates Go + creación de frontend via create-project.sh de Frontend_Library + go mod tidy. Incluye GenerateAppBinding para crear métodos de binding programáticamente.
diff --git a/functions/infra/sqlite_open.go b/functions/infra/sqlite_open.go
new file mode 100644
index 00000000..cf894f6d
--- /dev/null
+++ b/functions/infra/sqlite_open.go
@@ -0,0 +1,27 @@
+package infra
+
+import (
+	"database/sql"
+	"fmt"
+
+	_ "github.com/mattn/go-sqlite3"
+)
+
+// SQLiteOpen opens (or creates) a SQLite database file with WAL mode and
+// foreign key support enabled. Returns a ready-to-use *sql.DB or an error.
+// Pass ":memory:" for an in-memory database.
+func SQLiteOpen(path string) (*sql.DB, error) {
+	if path == "" {
+		return nil, fmt.Errorf("sqlite_open: path must not be empty (use ':memory:' for in-memory)")
+	}
+	dsn := fmt.Sprintf("file:%s?_journal_mode=WAL&_foreign_keys=on", path)
+	db, err := sql.Open("sqlite3", dsn)
+	if err != nil {
+		return nil, fmt.Errorf("sqlite_open: open %q: %w", path, err)
+	}
+	if err := db.Ping(); err != nil {
+		db.Close()
+		return nil, fmt.Errorf("sqlite_open: ping %q: %w", path, err)
+	}
+	return db, nil
+}
diff --git a/functions/infra/sqlite_open.md b/functions/infra/sqlite_open.md
new file mode 100644
index 00000000..bb9964c9
--- /dev/null
+++ b/functions/infra/sqlite_open.md
@@ -0,0 +1,37 @@
+---
+name: sqlite_open
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "func SQLiteOpen(path string) (*sql.DB, error)"
+description: "Abre (o crea) una base de datos SQLite con WAL mode y foreign keys habilitados. Hace ping para verificar la conexion."
+tags: [database, sqlite, connection, sql]
+uses_functions: []
+uses_types: [db_config_go_infra]
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: ["database/sql", "github.com/mattn/go-sqlite3"]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/sqlite_open.go"
+---
+
+## Ejemplo
+
+```go
+db, err := SQLiteOpen("/data/myapp.db")
+if err != nil {
+    log.Fatal(err)
+}
+defer DBClose(db)
+
+rows, err := DBQuery(db, "SELECT * FROM users WHERE active = ?", 1)
+```
+
+## Notas
+
+Usa el driver `github.com/mattn/go-sqlite3` (CGO). El DSN incluye `_journal_mode=WAL` para mejor concurrencia y `_foreign_keys=on`. Acepta `:memory:` para base de datos en memoria. Hace ping al abrir para detectar errores temprano.
diff --git a/functions/infra/wails_bind_crud.go b/functions/infra/wails_bind_crud.go
new file mode 100644
index 00000000..7bbfc878
--- /dev/null
+++ b/functions/infra/wails_bind_crud.go
@@ -0,0 +1,85 @@
+package infra
+
+import (
+	"fmt"
+	"strings"
+)
+
+// WailsCRUDSpec define la especificación para generar bindings CRUD.
+type WailsCRUDSpec struct {
+	EntityName string   // Nombre de la entidad (PascalCase, ej: "User")
+	Fields     []string // Campos de la entidad (ej: ["Name string", "Email string"])
+	WithList   bool     // Generar List method
+	WithGet    bool     // Generar Get method
+	WithCreate bool     // Generar Create method
+	WithUpdate bool     // Generar Update method
+	WithDelete bool     // Generar Delete method
+}
+
+// GenerateWailsCRUD genera código Go de bindings CRUD para una entidad.
+// Retorna el código Go como string — función pura.
+func GenerateWailsCRUD(spec WailsCRUDSpec) string {
+	var sb strings.Builder
+	lower := strings.ToLower(spec.EntityName)
+	plural := lower + "s"
+
+	// Tipo
+	sb.WriteString(fmt.Sprintf("// %s entity\n", spec.EntityName))
+	sb.WriteString(fmt.Sprintf("type %s struct {\n", spec.EntityName))
+	sb.WriteString("\tID string `json:\"id\"`\n")
+	for _, field := range spec.Fields {
+		parts := strings.SplitN(field, " ", 2)
+		if len(parts) == 2 {
+			jsonTag := strings.ToLower(parts[0])
+			sb.WriteString(fmt.Sprintf("\t%s %s `json:\"%s\"`\n", parts[0], parts[1], jsonTag))
+		}
+	}
+	sb.WriteString("}\n\n")
+
+	// List
+	if spec.WithList {
+		sb.WriteString(fmt.Sprintf("// List%s retorna todos los %s.\n", spec.EntityName+"s", plural))
+		sb.WriteString(fmt.Sprintf("func (a *App) List%s() ([]%s, error) {\n", spec.EntityName+"s", spec.EntityName))
+		sb.WriteString(fmt.Sprintf("\t// TODO: implement List%s\n", spec.EntityName+"s"))
+		sb.WriteString(fmt.Sprintf("\treturn nil, fmt.Errorf(\"not implemented\")\n"))
+		sb.WriteString("}\n\n")
+	}
+
+	// Get
+	if spec.WithGet {
+		sb.WriteString(fmt.Sprintf("// Get%s retorna un %s por ID.\n", spec.EntityName, lower))
+		sb.WriteString(fmt.Sprintf("func (a *App) Get%s(id string) (%s, error) {\n", spec.EntityName, spec.EntityName))
+		sb.WriteString(fmt.Sprintf("\t// TODO: implement Get%s\n", spec.EntityName))
+		sb.WriteString(fmt.Sprintf("\treturn %s{}, fmt.Errorf(\"not implemented\")\n", spec.EntityName))
+		sb.WriteString("}\n\n")
+	}
+
+	// Create
+	if spec.WithCreate {
+		sb.WriteString(fmt.Sprintf("// Create%s crea un nuevo %s.\n", spec.EntityName, lower))
+		sb.WriteString(fmt.Sprintf("func (a *App) Create%s(%s %s) (%s, error) {\n", spec.EntityName, lower, spec.EntityName, spec.EntityName))
+		sb.WriteString(fmt.Sprintf("\t// TODO: implement Create%s\n", spec.EntityName))
+		sb.WriteString(fmt.Sprintf("\treturn %s, fmt.Errorf(\"not implemented\")\n", lower))
+		sb.WriteString("}\n\n")
+	}
+
+	// Update
+	if spec.WithUpdate {
+		sb.WriteString(fmt.Sprintf("// Update%s actualiza un %s existente.\n", spec.EntityName, lower))
+		sb.WriteString(fmt.Sprintf("func (a *App) Update%s(%s %s) (%s, error) {\n", spec.EntityName, lower, spec.EntityName, spec.EntityName))
+		sb.WriteString(fmt.Sprintf("\t// TODO: implement Update%s\n", spec.EntityName))
+		sb.WriteString(fmt.Sprintf("\treturn %s, fmt.Errorf(\"not implemented\")\n", lower))
+		sb.WriteString("}\n\n")
+	}
+
+	// Delete
+	if spec.WithDelete {
+		sb.WriteString(fmt.Sprintf("// Delete%s elimina un %s por ID.\n", spec.EntityName, lower))
+		sb.WriteString(fmt.Sprintf("func (a *App) Delete%s(id string) error {\n", spec.EntityName))
+		sb.WriteString(fmt.Sprintf("\t// TODO: implement Delete%s\n", spec.EntityName))
+		sb.WriteString("\treturn fmt.Errorf(\"not implemented\")\n")
+		sb.WriteString("}\n\n")
+	}
+
+	return sb.String()
+}
diff --git a/functions/infra/wails_bind_crud.md b/functions/infra/wails_bind_crud.md
new file mode 100644
index 00000000..8dc73a1d
--- /dev/null
+++ b/functions/infra/wails_bind_crud.md
@@ -0,0 +1,40 @@
+---
+name: wails_bind_crud
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: pure
+signature: "GenerateWailsCRUD(spec WailsCRUDSpec) string"
+description: "Genera código Go de bindings CRUD para Wails: struct + métodos List/Get/Create/Update/Delete con stubs not-implemented."
+tags: [wails, crud, generator, bindings, codegen, infra]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [fmt, strings]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/wails_bind_crud.go"
+---
+
+## Ejemplo
+
+```go
+code := GenerateWailsCRUD(WailsCRUDSpec{
+    EntityName: "User",
+    Fields:     []string{"Name string", "Email string", "Role string"},
+    WithList:   true,
+    WithGet:    true,
+    WithCreate: true,
+    WithUpdate: true,
+    WithDelete: true,
+})
+// Genera: type User struct + ListUsers + GetUser + CreateUser + UpdateUser + DeleteUser
+```
+
+## Notas
+
+Función pura — genera código como string. Los métodos son stubs con `return fmt.Errorf("not implemented")`. Un agente puede generar el código, insertarlo en app.go, y luego implementar los TODOs.
diff --git a/functions/infra/wails_build.go b/functions/infra/wails_build.go
new file mode 100644
index 00000000..13beeb89
--- /dev/null
+++ b/functions/infra/wails_build.go
@@ -0,0 +1,65 @@
+package infra
+
+import (
+	"context"
+	"fmt"
+	"os/exec"
+	"strings"
+)
+
+// WailsBuildConfig configura la compilación de un proyecto Wails.
+type WailsBuildConfig struct {
+	Dir      string // Directorio del proyecto Wails
+	Platform string // linux, windows, darwin (default: current)
+	Output   string // Nombre del binario de salida
+	Debug    bool   // Build con debug info
+}
+
+// WailsBuild compila un proyecto Wails para la plataforma especificada.
+func WailsBuild(ctx context.Context, cfg WailsBuildConfig) error {
+	if cfg.Dir == "" {
+		return fmt.Errorf("dir is required")
+	}
+
+	args := []string{"build"}
+
+	if cfg.Platform != "" {
+		args = append(args, "-platform", cfg.Platform)
+	}
+	if cfg.Output != "" {
+		args = append(args, "-o", cfg.Output)
+	}
+	if cfg.Debug {
+		args = append(args, "-debug")
+	}
+
+	cmd := exec.CommandContext(ctx, "wails", args...)
+	cmd.Dir = cfg.Dir
+
+	output, err := cmd.CombinedOutput()
+	if err != nil {
+		return fmt.Errorf("wails build failed: %w\n%s", err, string(output))
+	}
+
+	fmt.Printf("Built successfully: %s\n", strings.TrimSpace(string(output)))
+	return nil
+}
+
+// WailsDev lanza un proyecto Wails en modo desarrollo con hot reload.
+func WailsDev(ctx context.Context, dir string, browser bool) error {
+	if dir == "" {
+		return fmt.Errorf("dir is required")
+	}
+
+	args := []string{"dev"}
+	if browser {
+		args = append(args, "-browser")
+	}
+
+	cmd := exec.CommandContext(ctx, "wails", args...)
+	cmd.Dir = dir
+	cmd.Stdout = nil // inherit
+	cmd.Stderr = nil
+
+	return cmd.Run()
+}
diff --git a/functions/infra/wails_build.md b/functions/infra/wails_build.md
new file mode 100644
index 00000000..3f75b8bd
--- /dev/null
+++ b/functions/infra/wails_build.md
@@ -0,0 +1,38 @@
+---
+name: wails_build
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "WailsBuild(ctx context.Context, cfg WailsBuildConfig) error"
+description: "Compila un proyecto Wails para linux/windows/darwin. Incluye WailsDev para modo desarrollo con hot reload."
+tags: [wails, build, compile, desktop, infra]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: [os/exec, fmt, strings, context]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/wails_build.go"
+---
+
+## Ejemplo
+
+```go
+// Build para linux
+WailsBuild(ctx, WailsBuildConfig{
+    Dir:      "/home/user/my-app",
+    Platform: "linux",
+})
+
+// Desarrollo con hot reload + browser
+WailsDev(ctx, "/home/user/my-app", true)
+```
+
+## Notas
+
+Requiere `wails` CLI instalado. WailsDev bloquea el proceso (es un servidor de desarrollo).
diff --git a/functions/infra/wails_emit_event.go b/functions/infra/wails_emit_event.go
new file mode 100644
index 00000000..d6f86b43
--- /dev/null
+++ b/functions/infra/wails_emit_event.go
@@ -0,0 +1,40 @@
+//go:build ignore
+// NOTE: requires wails dependency in target project — use this file by copying into a Wails project
+
+package infra
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"time"
+
+	"github.com/wailsapp/wails/v2/pkg/runtime"
+)
+
+// WailsEventPayload es un envelope para eventos tipados.
+type WailsEventPayload struct {
+	Type      string      `json:"type"`
+	Data      interface{} `json:"data"`
+	Timestamp time.Time   `json:"timestamp"`
+}
+
+// WailsEmitEvent emite un evento tipado al frontend.
+func WailsEmitEvent(ctx context.Context, eventName string, data interface{}) {
+	payload := WailsEventPayload{
+		Type:      eventName,
+		Data:      data,
+		Timestamp: time.Now(),
+	}
+	runtime.EventsEmit(ctx, eventName, payload)
+}
+
+// WailsEmitJSON emite datos como JSON string al frontend.
+func WailsEmitJSON(ctx context.Context, eventName string, data interface{}) error {
+	b, err := json.Marshal(data)
+	if err != nil {
+		return fmt.Errorf("marshaling event data: %w", err)
+	}
+	runtime.EventsEmit(ctx, eventName, string(b))
+	return nil
+}
diff --git a/functions/infra/wails_emit_event.md b/functions/infra/wails_emit_event.md
new file mode 100644
index 00000000..3c08d90d
--- /dev/null
+++ b/functions/infra/wails_emit_event.md
@@ -0,0 +1,35 @@
+---
+name: wails_emit_event
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "WailsEmitEvent(ctx context.Context, eventName string, data interface{})"
+description: "Emite eventos tipados de Go al frontend con timestamp automático. Incluye WailsEmitJSON para serialización explícita."
+tags: [wails, event, emit, ipc, realtime, infra]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: [context, encoding/json, fmt, time, github.com/wailsapp/wails/v2/pkg/runtime]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/wails_emit_event.go"
+---
+
+## Ejemplo
+
+```go
+// Emitir evento tipado
+WailsEmitEvent(ctx, "price:update", PriceData{Symbol: "BTC", Price: 67500.0})
+
+// El frontend lo recibe con useWailsEvent:
+// useWailsEvent({ eventName: 'price:update', onEvent: (data) => ... })
+```
+
+## Notas
+
+El evento llega al frontend como WailsEventPayload con `type`, `data` y `timestamp`. Complementa `use_wails_event` del lado TS. Requiere la dependencia `github.com/wailsapp/wails/v2` en el proyecto destino.
diff --git a/functions/infra/wails_stream_data.go b/functions/infra/wails_stream_data.go
new file mode 100644
index 00000000..f86880e4
--- /dev/null
+++ b/functions/infra/wails_stream_data.go
@@ -0,0 +1,70 @@
+//go:build ignore
+// NOTE: requires wails dependency in target project — use this file by copying into a Wails project
+
+package infra
+
+import (
+	"context"
+	"fmt"
+	"time"
+
+	"github.com/wailsapp/wails/v2/pkg/runtime"
+)
+
+// WailsStreamConfig configura un stream de datos hacia el frontend.
+type WailsStreamConfig struct {
+	StreamName string        // Nombre del stream (evento base)
+	ChunkDelay time.Duration // Delay entre chunks (default 0)
+}
+
+// WailsStreamData envía un slice de datos como stream al frontend.
+// Emite cada elemento como chunk en {streamName}, y {streamName}:complete al terminar.
+func WailsStreamData[T any](ctx context.Context, cfg WailsStreamConfig, data []T) error {
+	if cfg.StreamName == "" {
+		return fmt.Errorf("stream name is required")
+	}
+
+	for _, chunk := range data {
+		select {
+		case <-ctx.Done():
+			runtime.EventsEmit(ctx, cfg.StreamName+":error", map[string]string{
+				"message": "stream cancelled",
+			})
+			return ctx.Err()
+		default:
+			runtime.EventsEmit(ctx, cfg.StreamName, chunk)
+			if cfg.ChunkDelay > 0 {
+				time.Sleep(cfg.ChunkDelay)
+			}
+		}
+	}
+
+	runtime.EventsEmit(ctx, cfg.StreamName+":complete", nil)
+	return nil
+}
+
+// WailsStreamFunc ejecuta una función generadora y envía resultados como stream.
+// La función generadora envía datos por el canal, y esta función los retransmite al frontend.
+func WailsStreamFunc[T any](ctx context.Context, streamName string, generator func(ctx context.Context, ch chan<- T) error) error {
+	ch := make(chan T, 100)
+	errCh := make(chan error, 1)
+
+	go func() {
+		defer close(ch)
+		errCh <- generator(ctx, ch)
+	}()
+
+	for chunk := range ch {
+		runtime.EventsEmit(ctx, streamName, chunk)
+	}
+
+	if err := <-errCh; err != nil {
+		runtime.EventsEmit(ctx, streamName+":error", map[string]string{
+			"message": err.Error(),
+		})
+		return err
+	}
+
+	runtime.EventsEmit(ctx, streamName+":complete", nil)
+	return nil
+}
diff --git a/functions/infra/wails_stream_data.md b/functions/infra/wails_stream_data.md
new file mode 100644
index 00000000..333dfb78
--- /dev/null
+++ b/functions/infra/wails_stream_data.md
@@ -0,0 +1,50 @@
+---
+name: wails_stream_data
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "WailsStreamData[T any](ctx context.Context, cfg WailsStreamConfig, data []T) error"
+description: "Envía datos como stream Go→TS con protocolo {name}/{name}:complete/{name}:error. Incluye WailsStreamFunc para generadores."
+tags: [wails, stream, ipc, realtime, chunks, infra]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: [context, fmt, time, github.com/wailsapp/wails/v2/pkg/runtime]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/wails_stream_data.go"
+---
+
+## Ejemplo
+
+```go
+// Stream de slice
+WailsStreamData(ctx, WailsStreamConfig{
+    StreamName: "logs",
+    ChunkDelay: 10 * time.Millisecond,
+}, logLines)
+
+// Stream con generador
+WailsStreamFunc(ctx, "metrics", func(ctx context.Context, ch chan<- Metric) error {
+    for {
+        select {
+        case <-ctx.Done():
+            return nil
+        case <-time.After(time.Second):
+            ch <- collectMetric()
+        }
+    }
+})
+
+// Frontend lo recibe con useWailsStream:
+// useWailsStream({ streamName: 'metrics', autoStart: true })
+```
+
+## Notas
+
+Protocolo: chunks en `{streamName}`, fin en `{streamName}:complete`, error en `{streamName}:error`. Compatible con `use_wails_stream` del lado TS. WailsStreamFunc usa goroutine + canal para datos asíncronos. Requiere Go 1.18+ (generics) y la dependencia `github.com/wailsapp/wails/v2` en el proyecto destino.
diff --git a/go.mod b/go.mod
index 8907d0dc..eeddff0a 100644
--- a/go.mod
+++ b/go.mod
@@ -1,6 +1,6 @@
 module fn-registry
 
-go 1.24.2
+go 1.25.0
 
 require (
 	github.com/mattn/go-sqlite3 v1.14.37
@@ -8,7 +8,12 @@ require (
 )
 
 require (
+	github.com/ClickHouse/ch-go v0.71.0 // indirect
+	github.com/ClickHouse/clickhouse-go/v2 v2.44.0 // indirect
+	github.com/andybalholm/brotli v1.2.0 // indirect
+	github.com/apache/arrow-go/v18 v18.1.0 // indirect
 	github.com/aymanbagabas/go-osc52/v2 v2.0.1 // indirect
+	github.com/cespare/xxhash/v2 v2.3.0 // indirect
 	github.com/charmbracelet/bubbles v1.0.0 // indirect
 	github.com/charmbracelet/bubbletea v1.3.10 // indirect
 	github.com/charmbracelet/colorprofile v0.4.1 // indirect
@@ -21,15 +26,41 @@ require (
 	github.com/clipperhouse/stringish v0.1.1 // indirect
 	github.com/clipperhouse/uax29/v2 v2.5.0 // indirect
 	github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f // indirect
+	github.com/go-faster/city v1.0.1 // indirect
+	github.com/go-faster/errors v0.7.1 // indirect
+	github.com/go-viper/mapstructure/v2 v2.2.1 // indirect
+	github.com/goccy/go-json v0.10.5 // indirect
+	github.com/google/flatbuffers v25.1.24+incompatible // indirect
+	github.com/google/uuid v1.6.0 // indirect
+	github.com/jackc/pgpassfile v1.0.0 // indirect
+	github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 // indirect
+	github.com/jackc/pgx/v5 v5.9.1 // indirect
+	github.com/jackc/puddle/v2 v2.2.2 // indirect
+	github.com/klauspost/compress v1.18.3 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.9 // indirect
 	github.com/lucasb-eyer/go-colorful v1.3.0 // indirect
+	github.com/marcboeker/go-duckdb v1.8.5 // indirect
 	github.com/mattn/go-isatty v0.0.20 // indirect
 	github.com/mattn/go-localereader v0.0.1 // indirect
 	github.com/mattn/go-runewidth v0.0.19 // indirect
 	github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 // indirect
 	github.com/muesli/cancelreader v0.2.2 // indirect
 	github.com/muesli/termenv v0.16.0 // indirect
+	github.com/paulmach/orb v0.12.0 // indirect
+	github.com/pierrec/lz4/v4 v4.1.25 // indirect
 	github.com/rivo/uniseg v0.4.7 // indirect
+	github.com/segmentio/asm v1.2.1 // indirect
+	github.com/shopspring/decimal v1.4.0 // indirect
 	github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
-	golang.org/x/sys v0.38.0 // indirect
-	golang.org/x/text v0.3.8 // indirect
+	github.com/zeebo/xxh3 v1.0.2 // indirect
+	go.opentelemetry.io/otel v1.41.0 // indirect
+	go.opentelemetry.io/otel/trace v1.41.0 // indirect
+	go.yaml.in/yaml/v3 v3.0.4 // indirect
+	golang.org/x/exp v0.0.0-20250128182459-e0ece0dbea4c // indirect
+	golang.org/x/mod v0.27.0 // indirect
+	golang.org/x/sync v0.19.0 // indirect
+	golang.org/x/sys v0.41.0 // indirect
+	golang.org/x/text v0.29.0 // indirect
+	golang.org/x/tools v0.36.0 // indirect
+	golang.org/x/xerrors v0.0.0-20240903120638-7835f813f4da // indirect
 )
diff --git a/go.sum b/go.sum
index 39c6fd10..2375987e 100644
--- a/go.sum
+++ b/go.sum
@@ -1,5 +1,15 @@
+github.com/ClickHouse/ch-go v0.71.0 h1:bUdZ/EZj/LcVHsMqaRUP2holqygrPWQKeMjc6nZoyRM=
+github.com/ClickHouse/ch-go v0.71.0/go.mod h1:NwbNc+7jaqfY58dmdDUbG4Jl22vThgx1cYjBw0vtgXw=
+github.com/ClickHouse/clickhouse-go/v2 v2.44.0 h1:9pxs5pRwIvhni5BDRPn/n5A8DeUod5TnBaeulFBX8EQ=
+github.com/ClickHouse/clickhouse-go/v2 v2.44.0/go.mod h1:giJfUVlMkcfUEPVfRpt51zZaGEx9i17gCos8gBl392c=
+github.com/andybalholm/brotli v1.2.0 h1:ukwgCxwYrmACq68yiUqwIWnGY0cTPox/M94sVwToPjQ=
+github.com/andybalholm/brotli v1.2.0/go.mod h1:rzTDkvFWvIrjDXZHkuS16NPggd91W3kUSvPlQ1pLaKY=
+github.com/apache/arrow-go/v18 v18.1.0 h1:agLwJUiVuwXZdwPYVrlITfx7bndULJ/dggbnLFgDp/Y=
+github.com/apache/arrow-go/v18 v18.1.0/go.mod h1:tigU/sIgKNXaesf5d7Y95jBBKS5KsxTqYBKXFsvKzo0=
 github.com/aymanbagabas/go-osc52/v2 v2.0.1 h1:HwpRHbFMcZLEVr42D4p7XBqjyuxQH5SMiErDT4WkJ2k=
 github.com/aymanbagabas/go-osc52/v2 v2.0.1/go.mod h1:uYgXzlJ7ZpABp8OJ+exZzJJhRNQ2ASbcXHWsFqH8hp8=
+github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=
+github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
 github.com/charmbracelet/bubbles v1.0.0 h1:12J8/ak/uCZEMQ6KU7pcfwceyjLlWsDLAxB5fXonfvc=
 github.com/charmbracelet/bubbles v1.0.0/go.mod h1:9d/Zd5GdnauMI5ivUIVisuEm3ave1XwXtD1ckyV6r3E=
 github.com/charmbracelet/bubbletea v1.3.10 h1:otUDHWMMzQSB0Pkc87rm691KZ3SWa4KUlvF9nRvCICw=
@@ -22,10 +32,49 @@ github.com/clipperhouse/stringish v0.1.1 h1:+NSqMOr3GR6k1FdRhhnXrLfztGzuG+VuFDfa
 github.com/clipperhouse/stringish v0.1.1/go.mod h1:v/WhFtE1q0ovMta2+m+UbpZ+2/HEXNWYXQgCt4hdOzA=
 github.com/clipperhouse/uax29/v2 v2.5.0 h1:x7T0T4eTHDONxFJsL94uKNKPHrclyFI0lm7+w94cO8U=
 github.com/clipperhouse/uax29/v2 v2.5.0/go.mod h1:Wn1g7MK6OoeDT0vL+Q0SQLDz/KpfsVRgg6W7ihQeh4g=
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f h1:Y/CXytFA4m6baUTXGLOoWe4PQhGxaX0KpnayAqC48p4=
 github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f/go.mod h1:vw97MGsxSvLiUE2X8qFplwetxpGLQrlU1Q9AUEIzCaM=
+github.com/go-faster/city v1.0.1 h1:4WAxSZ3V2Ws4QRDrscLEDcibJY8uf41H6AhXDrNDcGw=
+github.com/go-faster/city v1.0.1/go.mod h1:jKcUJId49qdW3L1qKHH/3wPeUstCVpVSXTM6vO3VcTw=
+github.com/go-faster/errors v0.7.1 h1:MkJTnDoEdi9pDabt1dpWf7AA8/BaSYZqibYyhZ20AYg=
+github.com/go-faster/errors v0.7.1/go.mod h1:5ySTjWFiphBs07IKuiL69nxdfd5+fzh1u7FPGZP2quo=
+github.com/go-viper/mapstructure/v2 v2.2.1 h1:ZAaOCxANMuZx5RCeg0mBdEZk7DZasvvZIxtHqx8aGss=
+github.com/go-viper/mapstructure/v2 v2.2.1/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM=
+github.com/goccy/go-json v0.10.5 h1:Fq85nIqj+gXn/S5ahsiTlK3TmC85qgirsdTP/+DeaC4=
+github.com/goccy/go-json v0.10.5/go.mod h1:oq7eo15ShAhp70Anwd5lgX2pLfOS3QCiwU/PULtXL6M=
+github.com/gogo/protobuf v1.3.2/go.mod h1:P1XiOD3dCwIKUDQYPy72D8LYyHL2YPYrpS2s69NZV8Q=
+github.com/golang/protobuf v1.5.0/go.mod h1:FsONVRAS9T7sI+LIUmWTfcYkHO4aIWwzhcaSAoJOfIk=
+github.com/golang/snappy v0.0.1/go.mod h1:/XxbfmMg8lxefKM7IXC3fBNl/7bRcc72aCRzEWrmP2Q=
+github.com/google/flatbuffers v25.1.24+incompatible h1:4wPqL3K7GzBd1CwyhSd3usxLKOaJN/AC6puCca6Jm7o=
+github.com/google/flatbuffers v25.1.24+incompatible/go.mod h1:1AeVuKshWv4vARoZatz6mlQ0JxURH0Kv5+zNeJKJCa8=
+github.com/google/go-cmp v0.5.2/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
+github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
+github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
+github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/jackc/pgpassfile v1.0.0 h1:/6Hmqy13Ss2zCq62VdNG8tM1wchn8zjSGOBJ6icpsIM=
+github.com/jackc/pgpassfile v1.0.0/go.mod h1:CEx0iS5ambNFdcRtxPj5JhEz+xB6uRky5eyVu/W2HEg=
+github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 h1:iCEnooe7UlwOQYpKFhBabPMi4aNAfoODPEFNiAnClxo=
+github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761/go.mod h1:5TJZWKEWniPve33vlWYSoGYefn3gLQRzjfDlhSJ9ZKM=
+github.com/jackc/pgx/v5 v5.9.1 h1:uwrxJXBnx76nyISkhr33kQLlUqjv7et7b9FjCen/tdc=
+github.com/jackc/pgx/v5 v5.9.1/go.mod h1:mal1tBGAFfLHvZzaYh77YS/eC6IX9OWbRV1QIIM0Jn4=
+github.com/jackc/puddle/v2 v2.2.2 h1:PR8nw+E/1w0GLuRFSmiioY6UooMp6KJv0/61nB7icHo=
+github.com/jackc/puddle/v2 v2.2.2/go.mod h1:vriiEXHvEE654aYKXXjOvZM39qJ0q+azkZFrfEOc3H4=
+github.com/kisielk/errcheck v1.5.0/go.mod h1:pFxgyoBC7bSaBwPgfKdkLd5X25qrDl4LWUI2bnpBCr8=
+github.com/kisielk/gotool v1.0.0/go.mod h1:XhKaO+MFFWcvkIS/tQcRk01m1F5IRFswLeQ+oQHNcck=
+github.com/klauspost/compress v1.13.6/go.mod h1:/3/Vjq9QcHkK5uEr5lBEmyoZ1iFhe47etQ6QUkpK6sk=
+github.com/klauspost/compress v1.18.3 h1:9PJRvfbmTabkOX8moIpXPbMMbYN60bWImDDU7L+/6zw=
+github.com/klauspost/compress v1.18.3/go.mod h1:R0h/fSBs8DE4ENlcrlib3PsXS61voFxhIs2DeRhCvJ4=
+github.com/klauspost/cpuid/v2 v2.2.9 h1:66ze0taIn2H33fBvCkXuv9BmCwDfafmiIVpKV9kKGuY=
+github.com/klauspost/cpuid/v2 v2.2.9/go.mod h1:rqkxqrZ1EhYM9G+hXH7YdowN5R5RGN6NK4QwQ3WMXF8=
+github.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORNo=
+github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ=
+github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI=
 github.com/lucasb-eyer/go-colorful v1.3.0 h1:2/yBRLdWBZKrf7gB40FoiKfAWYQ0lqNcbuQwVHXptag=
 github.com/lucasb-eyer/go-colorful v1.3.0/go.mod h1:R4dSotOR9KMtayYi1e77YzuveK+i7ruzyGqttikkLy0=
+github.com/marcboeker/go-duckdb v1.8.5 h1:tkYp+TANippy0DaIOP5OEfBEwbUINqiFqgwMQ44jME0=
+github.com/marcboeker/go-duckdb v1.8.5/go.mod h1:6mK7+WQE4P4u5AFLvVBmhFxY5fvhymFptghgJX6B+/8=
 github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
 github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
 github.com/mattn/go-localereader v0.0.1 h1:ygSAOl7ZXTx4RdPYinUpg6W99U8jWvWi9Ye2JC/oIi4=
@@ -34,23 +83,110 @@ github.com/mattn/go-runewidth v0.0.19 h1:v++JhqYnZuu5jSKrk9RbgF5v4CGUjqRfBm05byF
 github.com/mattn/go-runewidth v0.0.19/go.mod h1:XBkDxAl56ILZc9knddidhrOlY5R/pDhgLpndooCuJAs=
 github.com/mattn/go-sqlite3 v1.14.37 h1:3DOZp4cXis1cUIpCfXLtmlGolNLp2VEqhiB/PARNBIg=
 github.com/mattn/go-sqlite3 v1.14.37/go.mod h1:Uh1q+B4BYcTPb+yiD3kU8Ct7aC0hY9fxUwlHK0RXw+Y=
+github.com/montanaflynn/stats v0.0.0-20171201202039-1bf9dbcd8cbe/go.mod h1:wL8QJuTMNUDYhXwkmfOly8iTdp5TEcJFWZD2D7SIkUc=
 github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 h1:ZK8zHtRHOkbHy6Mmr5D264iyp3TiX5OmNcI5cIARiQI=
 github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6/go.mod h1:CJlz5H+gyd6CUWT45Oy4q24RdLyn7Md9Vj2/ldJBSIo=
 github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA=
 github.com/muesli/cancelreader v0.2.2/go.mod h1:3XuTXfFS2VjM+HTLZY9Ak0l6eUKfijIfMUZ4EgX0QYo=
 github.com/muesli/termenv v0.16.0 h1:S5AlUN9dENB57rsbnkPyfdGuWIlkmzJjbFf0Tf5FWUc=
 github.com/muesli/termenv v0.16.0/go.mod h1:ZRfOIKPFDYQoDFF4Olj7/QJbW60Ol/kL1pU3VfY/Cnk=
+github.com/paulmach/orb v0.12.0 h1:z+zOwjmG3MyEEqzv92UN49Lg1JFYx0L9GpGKNVDKk1s=
+github.com/paulmach/orb v0.12.0/go.mod h1:5mULz1xQfs3bmQm63QEJA6lNGujuRafwA5S/EnuLaLU=
+github.com/paulmach/protoscan v0.2.1/go.mod h1:SpcSwydNLrxUGSDvXvO0P7g7AuhJ7lcKfDlhJCDw2gY=
+github.com/pierrec/lz4/v4 v4.1.25 h1:kocOqRffaIbU5djlIBr7Wh+cx82C0vtFb0fOurZHqD0=
+github.com/pierrec/lz4/v4 v4.1.25/go.mod h1:EoQMVJgeeEOMsCqCzqFm2O0cJvljX2nGZjcRIPL34O4=
+github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
 github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ=
 github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
+github.com/segmentio/asm v1.2.1 h1:DTNbBqs57ioxAD4PrArqftgypG4/qNpXoJx8TVXxPR0=
+github.com/segmentio/asm v1.2.1/go.mod h1:BqMnlJP91P8d+4ibuonYZw9mfnzI9HfxselHZr5aAcs=
+github.com/shopspring/decimal v1.4.0 h1:bxl37RwXBklmTi0C79JfXCEBD1cqqHt0bbgBAGFp81k=
+github.com/shopspring/decimal v1.4.0/go.mod h1:gawqmDU56v4yIKSwfBSFip1HdCCXN8/+DMd9qYNcwME=
+github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
+github.com/stretchr/testify v1.6.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+github.com/tidwall/pretty v1.0.0/go.mod h1:XNkn88O1ChpSDQmQeStsy+sBenx6DDtFZJxhVysOjyk=
+github.com/xdg-go/pbkdf2 v1.0.0/go.mod h1:jrpuAogTd400dnrH08LKmI/xc1MbPOebTwRqcT5RDeI=
+github.com/xdg-go/scram v1.1.1/go.mod h1:RaEWvsqvNKKvBPvcKeFjrG2cJqOkHTiyTpzz23ni57g=
+github.com/xdg-go/stringprep v1.0.3/go.mod h1:W3f5j4i+9rC0kuIEJL0ky1VpHXQU3ocBgklLGvcBnW8=
 github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e h1:JVG44RsyaB9T2KIHavMF/ppJZNG9ZpyihvCd0w101no=
 github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e/go.mod h1:RbqR21r5mrJuqunuUZ/Dhy/avygyECGrLceyNeo4LiM=
+github.com/youmark/pkcs8 v0.0.0-20181117223130-1be2e3e5546d/go.mod h1:rHwXgn7JulP+udvsHwJoVG1YGAP6VLg4y9I5dyZdqmA=
+github.com/yuin/goldmark v1.1.27/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
+github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
+github.com/zeebo/xxh3 v1.0.2 h1:xZmwmqxHZA8AI603jOQ0tMqmBr9lPeFwGg6d+xy9DC0=
+github.com/zeebo/xxh3 v1.0.2/go.mod h1:5NWz9Sef7zIDm2JHfFlcQvNekmcEl9ekUZQQKCYaDcA=
+go.mongodb.org/mongo-driver v1.11.4/go.mod h1:PTSz5yu21bkT/wXpkS7WR5f0ddqw5quethTUn9WM+2g=
+go.opentelemetry.io/otel v1.41.0 h1:YlEwVsGAlCvczDILpUXpIpPSL/VPugt7zHThEMLce1c=
+go.opentelemetry.io/otel v1.41.0/go.mod h1:Yt4UwgEKeT05QbLwbyHXEwhnjxNO6D8L5PQP51/46dE=
+go.opentelemetry.io/otel/trace v1.41.0 h1:Vbk2co6bhj8L59ZJ6/xFTskY+tGAbOnCtQGVVa9TIN0=
+go.opentelemetry.io/otel/trace v1.41.0/go.mod h1:U1NU4ULCoxeDKc09yCWdWe+3QoyweJcISEVa1RBzOis=
+go.yaml.in/yaml/v3 v3.0.4 h1:tfq32ie2Jv2UxXFdLJdh3jXuOzWiL1fo0bu/FbuKpbc=
+go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=
+golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
+golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI=
+golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto=
+golang.org/x/crypto v0.0.0-20220622213112-05595931fe9d/go.mod h1:IxCIyHEi3zRg3s0A5j5BB6A9Jmi73HwBIUl50j+osU4=
+golang.org/x/exp v0.0.0-20250128182459-e0ece0dbea4c h1:KL/ZBHXgKGVmuZBZ01Lt57yE5ws8ZPSkkihmEyq7FXc=
+golang.org/x/exp v0.0.0-20250128182459-e0ece0dbea4c/go.mod h1:tujkw807nyEEAamNbDrEGzRav+ilXA7PCRAd6xsmwiU=
+golang.org/x/mod v0.2.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
+golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
+golang.org/x/mod v0.27.0 h1:kb+q2PyFnEADO2IEF935ehFUXlWiNjJWtRNgBLSfbxQ=
+golang.org/x/mod v0.27.0/go.mod h1:rWI627Fq0DEoudcK+MBkNkCe0EetEaDSwJJkCcjpazc=
+golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
+golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
+golang.org/x/net v0.0.0-20200226121028-0de0cce0169b/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
+golang.org/x/net v0.0.0-20201021035429-f5854403a974/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU=
+golang.org/x/net v0.0.0-20211112202133-69e39bad7dc2/go.mod h1:9nx3DQGgdP8bBQD5qxJ1jj9UTztislL4KSBs9R2vV5Y=
+golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.0.0-20190911185100-cd5d95a43a6e/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.0.0-20210220032951-036812b2e83c/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.17.0 h1:l60nONMj9l5drqw6jlhIELNv9I0A4OFgRsG9k2oT9Ug=
+golang.org/x/sync v0.17.0/go.mod h1:9KTHXmSnoGruLpwFjVSX0lNNA75CykiMECbovNTZqGI=
+golang.org/x/sync v0.19.0 h1:vV+1eWNmZ5geRlYjzm2adRgW2/mcpevXNg50YZtPCE4=
+golang.org/x/sync v0.19.0/go.mod h1:9KTHXmSnoGruLpwFjVSX0lNNA75CykiMECbovNTZqGI=
+golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
+golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20200930185726-fdedc70b468f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20210423082822-04245dca01da/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.0.0-20210809222454-d867a43fc93e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.38.0 h1:3yZWxaJjBmCWXqhN1qh02AkOnCQ1poK6oF+a7xWL6Gc=
 golang.org/x/sys v0.38.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/sys v0.41.0 h1:Ivj+2Cp/ylzLiEU89QhWblYnOE9zerudt9Ftecq2C6k=
+golang.org/x/sys v0.41.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
+golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
+golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
+golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
+golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ=
 golang.org/x/text v0.3.8 h1:nAL+RVCQ9uMn3vJZbV+MRnydTJFPf8qqY42YiA6MrqY=
 golang.org/x/text v0.3.8/go.mod h1:E6s5w1FMmriuDzIBO73fBruAKo1PCIq6d2Q6DHfQ8WQ=
+golang.org/x/text v0.29.0 h1:1neNs90w9YzJ9BocxfsQNHKuAT4pkghyXc4nhZ6sJvk=
+golang.org/x/text v0.29.0/go.mod h1:7MhJOA9CD2qZyOKYazxdYMF85OwPdEr9jTtBpO7ydH4=
+golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
+golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
+golang.org/x/tools v0.0.0-20200619180055-7c47624df98f/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE=
+golang.org/x/tools v0.0.0-20210106214847-113979e3529a/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA=
+golang.org/x/tools v0.36.0 h1:kWS0uv/zsvHEle1LbV5LE8QujrxB3wfQyxHfhOk0Qkg=
+golang.org/x/tools v0.36.0/go.mod h1:WBDiHKJK8YgLHlcQPYQzNCkUxUypCaa5ZegCVutKm+s=
+golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+golang.org/x/xerrors v0.0.0-20240903120638-7835f813f4da h1:noIWHXmPHxILtqtCOPIhSt0ABwskkZKjD3bXGnZGpNY=
+golang.org/x/xerrors v0.0.0-20240903120638-7835f813f4da/go.mod h1:NDW/Ps6MPRej6fsCIbMTohpP40sJ/P/vI1MoTEGwX90=
+google.golang.org/protobuf v1.26.0-rc.1/go.mod h1:jlhhOSvTdKEhbULTjvd4ARK9grFBp09yW+WbY/TyQbw=
+google.golang.org/protobuf v1.27.1/go.mod h1:9q0QmTI4eRPtz6boOQmLYwt+qCgq0jsYwAQnmE0givc=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
+gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
 gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
diff --git a/python/functions/notebook/__init__.py b/python/functions/notebook/__init__.py
new file mode 100644
index 00000000..42ea774c
--- /dev/null
+++ b/python/functions/notebook/__init__.py
@@ -0,0 +1 @@
+# notebook — funciones para interaccion con Jupyter
diff --git a/python/functions/notebook/jupyter_discover.md b/python/functions/notebook/jupyter_discover.md
new file mode 100644
index 00000000..a01d6168
--- /dev/null
+++ b/python/functions/notebook/jupyter_discover.md
@@ -0,0 +1,88 @@
+---
+name: jupyter_discover
+kind: function
+lang: py
+domain: notebook
+version: "1.0.0"
+purity: impure
+signature: "def jupyter_discover(registry_root: str = \"\", ports: list[int] | None = None) -> list[dict]"
+description: "Descubre instancias de Jupyter Lab activas escaneando archivos .jupyter-port en analysis/ y puertos comunes (8888-8892). Para cada instancia consulta /api/status, /api/config, /api/kernels y /api/sessions via HTTP REST."
+tags: [jupyter, notebook, discovery, api, http, kernels, sessions, analysis]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: [json, os, urllib.error, urllib.request, pathlib]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "python/functions/notebook/jupyter_discover.py"
+---
+
+## Ejemplo
+
+```python
+from notebook.jupyter_discover import jupyter_discover
+
+# Descubrir con deteccion automatica de puertos
+instances = jupyter_discover(registry_root="/home/lucas/fn_registry")
+
+# Escanear puertos especificos
+instances = jupyter_discover(ports=[8888, 8900])
+
+for inst in instances:
+    print(inst["url"], inst["collaborative"], len(inst["kernels"]))
+# http://localhost:8888 True 2
+```
+
+## Estructura del dict retornado
+
+Cada elemento de la lista tiene la siguiente forma:
+
+```python
+{
+    "url": "http://localhost:8888",
+    "port": 8888,
+    "analysis": "finanzas_personales",  # nombre del subdirectorio en analysis/, o ""
+    "collaborative": True,              # True si YDocExtension esta activo
+    "kernels": [
+        {
+            "id": "abc123...",
+            "name": "python3",
+            "execution_state": "idle",
+            "last_activity": "2026-04-01T10:00:00.000Z"
+        }
+    ],
+    "sessions": [
+        {
+            "notebook": "notebooks/01_exploracion.ipynb",
+            "kernel_id": "abc123...",
+            "kernel_state": "idle"
+        }
+    ]
+}
+```
+
+## CLI
+
+```bash
+# Descubrir con deteccion automatica
+python python/functions/notebook/jupyter_discover.py --registry-root /home/lucas/fn_registry
+
+# Puertos especificos, salida JSON
+python python/functions/notebook/jupyter_discover.py --port 8888 --port 8889 --json
+
+# Usando variable de entorno
+FN_REGISTRY_ROOT=/home/lucas/fn_registry python python/functions/notebook/jupyter_discover.py
+```
+
+## Notas
+
+Solo usa stdlib: `urllib`, `json`, `pathlib`, `os`. No requiere `requests` ni clientes Jupyter especializados.
+
+El escaneo de puertos tiene un timeout de 2 segundos por instancia para no bloquear en puertos cerrados.
+
+La deteccion de modo colaborativo busca `YDocExtension` o `collaborative` en el JSON de `/api/config`. Esto cubre tanto jupyter-collaboration >= 2.x (que expone la extension bajo `LabApp`) como configuraciones antiguas.
+
+Archivos `.jupyter-port`: el pipeline `init_jupyter_analysis` escribe este archivo en cada analisis al lanzar Jupyter, permitiendo que `jupyter_discover` los encuentre sin escanear todos los puertos.
diff --git a/python/functions/notebook/jupyter_discover.py b/python/functions/notebook/jupyter_discover.py
new file mode 100644
index 00000000..9c760c75
--- /dev/null
+++ b/python/functions/notebook/jupyter_discover.py
@@ -0,0 +1,219 @@
+"""Descubrimiento de instancias Jupyter Lab activas via API REST."""
+
+import json
+import os
+import urllib.error
+import urllib.request
+from pathlib import Path
+
+
+_DEFAULT_PORTS = [8888, 8889, 8890, 8891, 8892]
+
+
+def _get(url: str, timeout: float = 2.0) -> dict | list | None:
+    """Hace GET a url y retorna el JSON parseado, o None si falla."""
+    try:
+        with urllib.request.urlopen(url, timeout=timeout) as resp:
+            return json.loads(resp.read().decode())
+    except Exception:
+        return None
+
+
+def _is_collaborative(config: dict | list | None) -> bool:
+    """Detecta si el servidor tiene jupyter-collaboration/YDocExtension activo."""
+    if not isinstance(config, dict):
+        return False
+    # Jupyter Lab expone la config de extensiones bajo claves como
+    # 'LabApp' o similares; la presencia de 'collaborative' o 'YDocExtension'
+    # en cualquier valor de primer nivel indica modo colaborativo.
+    raw = json.dumps(config).lower()
+    return "ydocextension" in raw or "collaborative" in raw
+
+
+def _query_instance(base_url: str) -> dict | None:
+    """Consulta la API REST de una instancia Jupyter y retorna su estado.
+
+    Retorna None si la instancia no responde o no es Jupyter.
+    """
+    status = _get(f"{base_url}/api/status")
+    if status is None:
+        return None
+
+    config = _get(f"{base_url}/api/config")
+    kernels_raw = _get(f"{base_url}/api/kernels") or []
+    sessions_raw = _get(f"{base_url}/api/sessions") or []
+
+    kernels = []
+    if isinstance(kernels_raw, list):
+        for k in kernels_raw:
+            if isinstance(k, dict):
+                kernels.append({
+                    "id": k.get("id", ""),
+                    "name": k.get("name", ""),
+                    "execution_state": k.get("execution_state", ""),
+                    "last_activity": k.get("last_activity", ""),
+                })
+
+    sessions = []
+    if isinstance(sessions_raw, list):
+        for s in sessions_raw:
+            if isinstance(s, dict):
+                kernel = s.get("kernel") or {}
+                path = s.get("path") or s.get("notebook", {}).get("path", "")
+                sessions.append({
+                    "notebook": path,
+                    "kernel_id": kernel.get("id", ""),
+                    "kernel_state": kernel.get("execution_state", ""),
+                })
+
+    return {
+        "kernels": kernels,
+        "sessions": sessions,
+        "collaborative": _is_collaborative(config),
+    }
+
+
+def _scan_analysis_ports(registry_root: str) -> list[tuple[int, str]]:
+    """Escanea subdirectorios de analysis/ buscando archivos .jupyter-port.
+
+    Retorna lista de (puerto, nombre_analisis).
+    """
+    root = Path(registry_root) if registry_root else Path.cwd()
+    analysis_dir = root / "analysis"
+    results: list[tuple[int, str]] = []
+
+    if not analysis_dir.is_dir():
+        return results
+
+    for entry in analysis_dir.iterdir():
+        if not entry.is_dir():
+            continue
+        port_file = entry / ".jupyter-port"
+        if port_file.is_file():
+            try:
+                port = int(port_file.read_text().strip())
+                results.append((port, entry.name))
+            except (ValueError, OSError):
+                pass
+
+    return results
+
+
+def jupyter_discover(
+    registry_root: str = "",
+    ports: list[int] | None = None,
+) -> list[dict]:
+    """Descubre instancias de Jupyter Lab activas consultando su API REST.
+
+    Escanea primero los archivos .jupyter-port en subdirectorios de analysis/
+    para encontrar puertos registrados, y luego aplica un fallback sobre puertos
+    comunes (8888-8892). Para cada instancia que responde consulta /api/status,
+    /api/config, /api/kernels y /api/sessions.
+
+    Args:
+        registry_root: Raiz del fn_registry. Si vacio usa el directorio actual
+                       o la variable de entorno FN_REGISTRY_ROOT.
+        ports: Lista de puertos a escanear. Si None, usa los puertos encontrados
+               en .jupyter-port mas los defaults (8888-8892).
+
+    Returns:
+        Lista de dicts con: url, port, analysis, collaborative, kernels, sessions.
+        Cada sesion incluye: notebook, kernel_id, kernel_state.
+    """
+    if not registry_root:
+        registry_root = os.environ.get("FN_REGISTRY_ROOT", "")
+
+    # Recopilar puertos a escanear
+    port_analysis: dict[int, str] = {}
+
+    if ports is not None:
+        for p in ports:
+            port_analysis[p] = ""
+    else:
+        # Primero los registrados en .jupyter-port
+        for port, analysis_name in _scan_analysis_ports(registry_root):
+            port_analysis[port] = analysis_name
+        # Fallback: puertos comunes que no estén ya en la lista
+        for p in _DEFAULT_PORTS:
+            if p not in port_analysis:
+                port_analysis[p] = ""
+
+    results = []
+    for port, analysis_name in port_analysis.items():
+        base_url = f"http://localhost:{port}"
+        info = _query_instance(base_url)
+        if info is None:
+            continue
+        results.append({
+            "url": base_url,
+            "port": port,
+            "analysis": analysis_name,
+            "collaborative": info["collaborative"],
+            "kernels": info["kernels"],
+            "sessions": info["sessions"],
+        })
+
+    return results
+
+
+# ---------------------------------------------------------------------------
+# CLI
+# ---------------------------------------------------------------------------
+
+if __name__ == "__main__":
+    import argparse
+    import sys
+
+    parser = argparse.ArgumentParser(
+        description="Descubre instancias de Jupyter Lab activas."
+    )
+    parser.add_argument(
+        "--registry-root",
+        default="",
+        help="Raiz del fn_registry (default: FN_REGISTRY_ROOT env o cwd)",
+    )
+    parser.add_argument(
+        "--port",
+        dest="ports",
+        type=int,
+        action="append",
+        metavar="PORT",
+        help="Puerto a escanear (puede repetirse). Default: .jupyter-port + 8888-8892",
+    )
+    parser.add_argument(
+        "--json",
+        action="store_true",
+        help="Emitir salida en JSON",
+    )
+    args = parser.parse_args()
+
+    instances = jupyter_discover(
+        registry_root=args.registry_root,
+        ports=args.ports,
+    )
+
+    if args.json:
+        print(json.dumps(instances, indent=2))
+        sys.exit(0)
+
+    if not instances:
+        print("No se encontraron instancias de Jupyter Lab activas.")
+        sys.exit(0)
+
+    for inst in instances:
+        label = f"  analysis: {inst['analysis']}" if inst["analysis"] else ""
+        collab = "colaborativo" if inst["collaborative"] else "estandar"
+        print(f"Jupyter Lab en {inst['url']}  [{collab}]{label}")
+        if inst["kernels"]:
+            print(f"  Kernels ({len(inst['kernels'])}):")
+            for k in inst["kernels"]:
+                print(f"    - {k['name']}  estado={k['execution_state']}  id={k['id'][:8]}...")
+        else:
+            print("  Kernels: ninguno")
+        if inst["sessions"]:
+            print(f"  Sesiones ({len(inst['sessions'])}):")
+            for s in inst["sessions"]:
+                print(f"    - {s['notebook']}  kernel={s['kernel_id'][:8]}...  estado={s['kernel_state']}")
+        else:
+            print("  Sesiones: ninguna")
+        print()
diff --git a/python/functions/notebook/jupyter_exec.md b/python/functions/notebook/jupyter_exec.md
new file mode 100644
index 00000000..182d1b1c
--- /dev/null
+++ b/python/functions/notebook/jupyter_exec.md
@@ -0,0 +1,94 @@
+---
+name: jupyter_exec
+kind: function
+lang: py
+domain: notebook
+version: "1.0.0"
+purity: impure
+signature: "jupyter_append_execute(notebook_path: str, code: str, server_url: str, token: str) -> dict"
+description: "Ejecuta codigo en kernels de Jupyter via WebSocket. Tres modos: append (añade celda al notebook y la ejecuta), cell (ejecuta celda existente por indice), kernel (ejecuta en el kernel sin tocar ningun notebook)."
+tags: [jupyter, notebook, kernel, websocket, execution, cells]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: [jupyter_kernel_client, jupyter_nbmodel_client]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "python/functions/notebook/jupyter_exec.py"
+---
+
+## Funciones
+
+### `jupyter_append_execute(notebook_path, code, server_url, token)`
+
+Añade una celda de codigo al final del notebook y la ejecuta. Usa el protocolo
+colaborativo de Jupyter, por lo que tanto el agente como el usuario ven la celda
+y su output en tiempo real en JupyterLab.
+
+```python
+from notebook.jupyter_exec import jupyter_append_execute
+
+result = jupyter_append_execute(
+    "notebooks/analisis.ipynb",
+    "import pandas as pd\nprint(pd.__version__)",
+    server_url="http://localhost:8888",
+    token="",
+)
+# {"cell_index": 5, "outputs": ["2.2.1"]}
+```
+
+### `jupyter_execute_cell(notebook_path, cell_index, server_url, token)`
+
+Ejecuta una celda existente del notebook por su indice (0-based).
+
+```python
+from notebook.jupyter_exec import jupyter_execute_cell
+
+result = jupyter_execute_cell("notebooks/analisis.ipynb", 3)
+# {"cell_index": 3, "outputs": ["42"]}
+```
+
+### `jupyter_kernel_execute(code, server_url, token)`
+
+Ejecuta codigo directamente en el kernel sin modificar ningun notebook. Util para
+consultas rapidas, inspeccion de variables o verificacion de estado del kernel.
+
+```python
+from notebook.jupyter_exec import jupyter_kernel_execute
+
+result = jupyter_kernel_execute("len(df)")
+# {"outputs": ["1500"], "status": "ok"}
+```
+
+## CLI
+
+```bash
+# Añadir celda y ejecutar
+python -m notebook.jupyter_exec append notebooks/mi.ipynb "print('hola')" --server http://localhost:8888 --token mytoken
+
+# Ejecutar celda existente
+python -m notebook.jupyter_exec cell notebooks/mi.ipynb 2 --server http://localhost:8888
+
+# Ejecutar en kernel directamente
+python -m notebook.jupyter_exec kernel "x = 42; print(x)"
+```
+
+Output siempre JSON. En error retorna `{"error": "..."}` por stderr con exit code 1.
+
+## Extraccion de outputs
+
+| output_type | campo leido |
+|---|---|
+| stream | `text` |
+| display_data / execute_result | `data.text/plain` |
+| error | `traceback` (joined con `\n`) |
+
+## Notas
+
+- Las funciones `append` y `cell` son async internamente; las publicas usan `asyncio.run()`.
+- `jupyter_kernel_execute` es sincrona directamente porque `KernelClient.execute` es bloqueante.
+- El token puede ser cadena vacia si el servidor tiene autenticacion deshabilitada.
+- `NbModelClient` requiere que el servidor tenga habilitado el endpoint colaborativo (`/api/collaboration/`), disponible en JupyterLab >= 4 con `jupyter-collaboration` instalado.
diff --git a/python/functions/notebook/jupyter_exec.py b/python/functions/notebook/jupyter_exec.py
new file mode 100644
index 00000000..9d694619
--- /dev/null
+++ b/python/functions/notebook/jupyter_exec.py
@@ -0,0 +1,280 @@
+"""Ejecuta codigo en kernels de Jupyter via WebSocket.
+
+Tres modos de ejecucion:
+- append: añade una celda al final del notebook y la ejecuta
+- cell: ejecuta una celda existente por indice
+- kernel: ejecuta codigo directamente en el kernel sin modificar ningun notebook
+"""
+
+import asyncio
+import json
+from typing import Any
+from urllib.error import URLError
+from urllib.request import Request, urlopen
+
+from jupyter_kernel_client import KernelClient
+from jupyter_nbmodel_client import NbModelClient, get_jupyter_notebook_websocket_url
+
+
+# ---------------------------------------------------------------------------
+# Helpers internos
+# ---------------------------------------------------------------------------
+
+
+def _api_get(url: str, token: str = "") -> dict | list | None:
+    """GET a Jupyter REST API endpoint."""
+    headers = {"Accept": "application/json"}
+    if token:
+        headers["Authorization"] = f"token {token}"
+    try:
+        req = Request(url, headers=headers)
+        with urlopen(req, timeout=5) as resp:
+            return json.loads(resp.read())
+    except (URLError, OSError, json.JSONDecodeError):
+        return None
+
+
+def _resolve_kernel_id(server_url: str, token: str, notebook_path: str) -> str | None:
+    """Find the kernel_id associated with a notebook via the sessions API."""
+    sessions = _api_get(f"{server_url}/api/sessions", token) or []
+    for session in sessions:
+        nb = session.get("notebook", session.get("path", {}))
+        nb_path = nb.get("path", nb) if isinstance(nb, dict) else str(nb)
+        if nb_path == notebook_path:
+            kernel = session.get("kernel", {})
+            return kernel.get("id")
+    return None
+
+
+def _resolve_collab_username(server_url: str, token: str) -> str:
+    """Resolve the display name of the active user in Jupyter collaboration.
+
+    Queries /api/me to get the identity Jupyter assigned to the browser user.
+    Falls back to 'Anonymous' if unavailable.
+    """
+    me = _api_get(f"{server_url}/api/me", token)
+    if me:
+        identity = me.get("identity", {})
+        return identity.get("display_name", "") or identity.get("username", "") or identity.get("name", "Anonymous")
+    return "Anonymous"
+
+
+def _extract_outputs(raw_outputs: list[dict]) -> list[str]:
+    """Convierte outputs de nbformat a lista de strings legibles."""
+    result: list[str] = []
+    for output in raw_outputs:
+        output_type = output.get("output_type", "")
+        if output_type == "stream":
+            text = output.get("text", "")
+            if isinstance(text, list):
+                text = "".join(text)
+            result.append(text.rstrip("\n"))
+        elif output_type in ("display_data", "execute_result"):
+            data = output.get("data", {})
+            text = data.get("text/plain", "")
+            if isinstance(text, list):
+                text = "".join(text)
+            result.append(text.rstrip("\n"))
+        elif output_type == "error":
+            traceback = output.get("traceback", [])
+            result.append("\n".join(traceback))
+    return result
+
+
+# ---------------------------------------------------------------------------
+# Modo append (async interno)
+# ---------------------------------------------------------------------------
+
+
+async def _async_append_execute(
+    notebook_path: str,
+    code: str,
+    server_url: str,
+    token: str,
+) -> dict[str, Any]:
+    ws_url = get_jupyter_notebook_websocket_url(
+        server_url,
+        notebook_path,
+        token or None,
+    )
+
+    kernel_id = _resolve_kernel_id(server_url, token, notebook_path)
+    username = _resolve_collab_username(server_url, token)
+
+    async with NbModelClient(ws_url, username=username) as nb:
+        await nb.wait_until_synced()
+
+        with KernelClient(server_url=server_url, token=token, kernel_id=kernel_id) as kernel:
+            cell_index = nb.add_code_cell(code)
+            result = nb.execute_cell(cell_index, kernel)
+
+        # Let Y.js propagate changes to other clients (browser)
+        await asyncio.sleep(2)
+
+    outputs = _extract_outputs(result.get("outputs", []))
+    return {"cell_index": cell_index, "outputs": outputs}
+
+
+# ---------------------------------------------------------------------------
+# Modo cell (async interno)
+# ---------------------------------------------------------------------------
+
+
+async def _async_execute_cell(
+    notebook_path: str,
+    cell_index: int,
+    server_url: str,
+    token: str,
+) -> dict[str, Any]:
+    ws_url = get_jupyter_notebook_websocket_url(
+        server_url,
+        notebook_path,
+        token or None,
+    )
+    kernel_id = _resolve_kernel_id(server_url, token, notebook_path)
+    username = _resolve_collab_username(server_url, token)
+
+    async with NbModelClient(ws_url, username=username) as nb:
+        await nb.wait_until_synced()
+
+        with KernelClient(server_url=server_url, token=token, kernel_id=kernel_id) as kernel:
+            result = nb.execute_cell(cell_index, kernel)
+
+        await asyncio.sleep(2)
+
+    outputs = _extract_outputs(result.get("outputs", []))
+    return {"cell_index": cell_index, "outputs": outputs}
+
+
+# ---------------------------------------------------------------------------
+# API publica
+# ---------------------------------------------------------------------------
+
+
+def jupyter_append_execute(
+    notebook_path: str,
+    code: str,
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+) -> dict[str, Any]:
+    """Añade una celda de codigo al final del notebook y la ejecuta.
+
+    Tanto el agente como el usuario ven la celda y su output en tiempo real
+    porque la escritura se realiza a traves del protocolo colaborativo de Jupyter.
+
+    Args:
+        notebook_path: Ruta al notebook relativa a la raiz del servidor Jupyter.
+        code: Codigo Python a insertar y ejecutar.
+        server_url: URL del servidor Jupyter; por defecto http://localhost:8888.
+        token: Token de autenticacion del servidor Jupyter.
+
+    Returns:
+        dict con 'cell_index' (indice de la nueva celda) y 'outputs' (lista de strings).
+
+    Raises:
+        Exception: si no se puede conectar al servidor o al kernel.
+    """
+    return asyncio.run(_async_append_execute(notebook_path, code, server_url, token))
+
+
+def jupyter_execute_cell(
+    notebook_path: str,
+    cell_index: int,
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+) -> dict[str, Any]:
+    """Ejecuta una celda existente del notebook por indice.
+
+    Args:
+        notebook_path: Ruta al notebook relativa a la raiz del servidor Jupyter.
+        cell_index: Indice de la celda a ejecutar (0-based).
+        server_url: URL del servidor Jupyter; por defecto http://localhost:8888.
+        token: Token de autenticacion del servidor Jupyter.
+
+    Returns:
+        dict con 'cell_index' y 'outputs' (lista de strings).
+
+    Raises:
+        IndexError: si cell_index esta fuera de rango.
+        Exception: si no se puede conectar al servidor o al kernel.
+    """
+    return asyncio.run(_async_execute_cell(notebook_path, cell_index, server_url, token))
+
+
+def jupyter_kernel_execute(
+    code: str,
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+) -> dict[str, Any]:
+    """Ejecuta codigo directamente en el kernel sin modificar ningun notebook.
+
+    Util para consultas rapidas, inspeccion de variables, comprobaciones de estado.
+
+    Args:
+        code: Codigo Python a ejecutar en el kernel activo.
+        server_url: URL del servidor Jupyter; por defecto http://localhost:8888.
+        token: Token de autenticacion del servidor Jupyter.
+
+    Returns:
+        dict con 'outputs' (lista de strings) y 'status' ('ok' o 'error').
+
+    Raises:
+        Exception: si no se puede conectar al servidor o al kernel.
+    """
+    with KernelClient(server_url=server_url, token=token) as kernel:
+        result = kernel.execute(code)
+
+    outputs = _extract_outputs(result.get("outputs", []))
+    return {"outputs": outputs, "status": result.get("status", "unknown")}
+
+
+# ---------------------------------------------------------------------------
+# CLI
+# ---------------------------------------------------------------------------
+
+if __name__ == "__main__":
+    import argparse
+    import sys
+
+    parser = argparse.ArgumentParser(
+        description="Ejecuta codigo en kernels de Jupyter",
+    )
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    # append
+    p_append = sub.add_parser("append", help="Añade celda al notebook y la ejecuta")
+    p_append.add_argument("notebook", help="Ruta al notebook relativa al servidor")
+    p_append.add_argument("code", help="Codigo a insertar y ejecutar")
+    p_append.add_argument("--server", default="http://localhost:8888")
+    p_append.add_argument("--token", default="")
+
+    # cell
+    p_cell = sub.add_parser("cell", help="Ejecuta celda existente por indice")
+    p_cell.add_argument("notebook", help="Ruta al notebook relativa al servidor")
+    p_cell.add_argument("index", type=int, help="Indice de la celda (0-based)")
+    p_cell.add_argument("--server", default="http://localhost:8888")
+    p_cell.add_argument("--token", default="")
+
+    # kernel
+    p_kernel = sub.add_parser("kernel", help="Ejecuta codigo en el kernel sin tocar notebook")
+    p_kernel.add_argument("code", help="Codigo a ejecutar")
+    p_kernel.add_argument("--server", default="http://localhost:8888")
+    p_kernel.add_argument("--token", default="")
+
+    args = parser.parse_args()
+
+    try:
+        if args.command == "append":
+            result = jupyter_append_execute(args.notebook, args.code, args.server, args.token)
+        elif args.command == "cell":
+            result = jupyter_execute_cell(args.notebook, args.index, args.server, args.token)
+        elif args.command == "kernel":
+            result = jupyter_kernel_execute(args.code, args.server, args.token)
+        else:
+            parser.print_help()
+            sys.exit(1)
+
+        print(json.dumps(result, ensure_ascii=False, indent=2))
+    except Exception as exc:
+        print(json.dumps({"error": str(exc)}, ensure_ascii=False), file=sys.stderr)
+        sys.exit(1)
diff --git a/python/functions/notebook/jupyter_kernel.md b/python/functions/notebook/jupyter_kernel.md
new file mode 100644
index 00000000..dc2864c4
--- /dev/null
+++ b/python/functions/notebook/jupyter_kernel.md
@@ -0,0 +1,136 @@
+---
+name: jupyter_kernel
+kind: function
+lang: py
+domain: notebook
+version: "1.0.0"
+purity: impure
+signature: "def jupyter_kernel_list(server_url: str = \"http://localhost:8888\", token: str = \"\") -> list[dict]"
+description: "CRUD completo de kernels Jupyter via REST API. Expone seis operaciones: list, start, restart, interrupt, shutdown y sessions. Usa solo stdlib (urllib, json), sin dependencias externas."
+tags: [jupyter, notebook, kernel, api, http, rest, sessions, crud]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: [json, urllib.error, urllib.request]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "python/functions/notebook/jupyter_kernel.py"
+---
+
+## Funciones expuestas
+
+| Funcion | Endpoint | Descripcion |
+|---------|----------|-------------|
+| `jupyter_kernel_list(server_url, token)` | `GET /api/kernels` | Lista kernels activos |
+| `jupyter_kernel_start(server_url, token, name)` | `POST /api/kernels` | Inicia un kernel nuevo |
+| `jupyter_kernel_restart(server_url, token, kernel_id)` | `POST /api/kernels/{id}/restart` | Reinicia un kernel |
+| `jupyter_kernel_interrupt(server_url, token, kernel_id)` | `POST /api/kernels/{id}/interrupt` | Interrumpe ejecucion |
+| `jupyter_kernel_shutdown(server_url, token, kernel_id)` | `DELETE /api/kernels/{id}` | Apaga y elimina un kernel |
+| `jupyter_kernel_sessions(server_url, token)` | `GET /api/sessions` | Lista sesiones activas |
+
+## Ejemplo
+
+```python
+from notebook.jupyter_kernel import (
+    jupyter_kernel_list,
+    jupyter_kernel_start,
+    jupyter_kernel_restart,
+    jupyter_kernel_interrupt,
+    jupyter_kernel_shutdown,
+    jupyter_kernel_sessions,
+)
+
+# Listar kernels activos
+kernels = jupyter_kernel_list("http://localhost:8888", token="mi_token")
+# [{"id": "abc123", "name": "python3", "execution_state": "idle",
+#   "last_activity": "2026-04-01T10:00:00.000Z", "connections": 1}]
+
+# Iniciar un kernel nuevo
+kernel = jupyter_kernel_start("http://localhost:8888", token="mi_token", name="python3")
+# {"id": "def456", "name": "python3", "execution_state": "starting"}
+
+# Reiniciar
+jupyter_kernel_restart("http://localhost:8888", "mi_token", kernel["id"])
+
+# Interrumpir ejecucion en curso
+jupyter_kernel_interrupt("http://localhost:8888", "mi_token", kernel["id"])
+
+# Apagar
+jupyter_kernel_shutdown("http://localhost:8888", "mi_token", kernel["id"])
+
+# Listar sesiones (mapeo notebook <-> kernel)
+sessions = jupyter_kernel_sessions("http://localhost:8888", token="mi_token")
+# [{"id": "s1", "notebook": "notebooks/01_analisis.ipynb",
+#   "kernel_id": "abc123", "kernel_state": "idle", "type": "notebook", "name": "01_analisis"}]
+```
+
+## CLI
+
+```bash
+# Listar kernels
+python python/functions/notebook/jupyter_kernel.py list --server http://localhost:8888 --token TK
+
+# Iniciar kernel (por defecto python3)
+python python/functions/notebook/jupyter_kernel.py start --name python3
+
+# Reiniciar
+python python/functions/notebook/jupyter_kernel.py restart abc123-...
+
+# Interrumpir
+python python/functions/notebook/jupyter_kernel.py interrupt abc123-...
+
+# Apagar
+python python/functions/notebook/jupyter_kernel.py shutdown abc123-...
+
+# Listar sesiones
+python python/functions/notebook/jupyter_kernel.py sessions
+```
+
+Todos los subcomandos aceptan `--server` y `--token`. El output es siempre JSON.
+
+## Estructura de los dicts retornados
+
+**`jupyter_kernel_list`** — cada elemento:
+```python
+{
+    "id": "abc123-...",
+    "name": "python3",
+    "execution_state": "idle",   # idle | busy | starting
+    "last_activity": "2026-04-01T10:00:00.000Z",
+    "connections": 1
+}
+```
+
+**`jupyter_kernel_start`** — elemento retornado:
+```python
+{
+    "id": "def456-...",
+    "name": "python3",
+    "execution_state": "starting"
+}
+```
+
+**`jupyter_kernel_sessions`** — cada elemento:
+```python
+{
+    "id": "session-id",
+    "notebook": "notebooks/01_analisis.ipynb",  # path relativo al root del servidor
+    "kernel_id": "abc123-...",
+    "kernel_state": "idle",
+    "type": "notebook",
+    "name": "01_analisis"
+}
+```
+
+## Notas
+
+Solo usa stdlib: `urllib.request`, `urllib.error`, `json`. No requiere `requests`, `jupyter_client` ni ningun paquete externo.
+
+La funcion interna `_make_request` centraliza la construccion de headers y serializacion JSON. El header `Authorization: token {token}` se omite si `token` esta vacio, permitiendo conectar a servidores sin autenticacion.
+
+`jupyter_kernel_interrupt` y `jupyter_kernel_shutdown` retornan `None` porque la API de Jupyter devuelve 204 No Content en esos casos.
+
+Compatible con Jupyter Lab 3.x, 4.x y Jupyter Notebook 6.x/7.x — todos exponen la misma REST API en `/api/kernels` y `/api/sessions`.
diff --git a/python/functions/notebook/jupyter_kernel.py b/python/functions/notebook/jupyter_kernel.py
new file mode 100644
index 00000000..7b603502
--- /dev/null
+++ b/python/functions/notebook/jupyter_kernel.py
@@ -0,0 +1,287 @@
+"""CRUD de kernels Jupyter via REST API."""
+
+import json
+import urllib.error
+import urllib.request
+
+
+def _make_request(
+    method: str,
+    url: str,
+    token: str = "",
+    body: dict | None = None,
+) -> dict | list | None:
+    """Ejecuta una request HTTP a la API de Jupyter.
+
+    Args:
+        method: Metodo HTTP (GET, POST, DELETE).
+        url: URL completa del endpoint.
+        token: Token de autenticacion de Jupyter. Vacio si no se requiere.
+        body: Cuerpo de la request para metodos POST.
+
+    Returns:
+        Respuesta deserializada como dict o list, o None si la respuesta esta vacia.
+
+    Raises:
+        urllib.error.HTTPError: Si la respuesta HTTP indica un error.
+        urllib.error.URLError: Si no se puede conectar al servidor.
+    """
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+
+    headers = {
+        "Accept": "application/json",
+        "Content-Type": "application/json",
+    }
+    if token:
+        headers["Authorization"] = f"token {token}"
+
+    req = urllib.request.Request(url, data=data, headers=headers, method=method)
+
+    with urllib.request.urlopen(req) as resp:
+        raw = resp.read()
+        if not raw:
+            return None
+        return json.loads(raw.decode("utf-8"))
+
+
+def jupyter_kernel_list(
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+) -> list[dict]:
+    """Lista todos los kernels activos en el servidor Jupyter.
+
+    Args:
+        server_url: URL base del servidor Jupyter.
+        token: Token de autenticacion. Vacio si el servidor no requiere auth.
+
+    Returns:
+        Lista de dicts con los campos: id, name, execution_state,
+        last_activity, connections.
+
+    Raises:
+        urllib.error.HTTPError: Si la respuesta HTTP indica un error.
+        urllib.error.URLError: Si no se puede conectar al servidor.
+    """
+    url = f"{server_url.rstrip('/')}/api/kernels"
+    result = _make_request("GET", url, token)
+    return result if isinstance(result, list) else []
+
+
+def jupyter_kernel_start(
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+    name: str = "python3",
+) -> dict:
+    """Inicia un kernel nuevo en el servidor Jupyter.
+
+    Args:
+        server_url: URL base del servidor Jupyter.
+        token: Token de autenticacion. Vacio si el servidor no requiere auth.
+        name: Nombre del kernel a iniciar (p.ej. "python3", "ir").
+
+    Returns:
+        Dict con los campos: id, name, execution_state.
+
+    Raises:
+        urllib.error.HTTPError: Si la respuesta HTTP indica un error.
+        urllib.error.URLError: Si no se puede conectar al servidor.
+    """
+    url = f"{server_url.rstrip('/')}/api/kernels"
+    result = _make_request("POST", url, token, body={"name": name})
+    return result if isinstance(result, dict) else {}
+
+
+def jupyter_kernel_restart(
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+    kernel_id: str = "",
+) -> dict:
+    """Reinicia un kernel existente.
+
+    Args:
+        server_url: URL base del servidor Jupyter.
+        token: Token de autenticacion. Vacio si el servidor no requiere auth.
+        kernel_id: ID del kernel a reiniciar.
+
+    Returns:
+        Dict con la informacion actualizada del kernel.
+
+    Raises:
+        urllib.error.HTTPError: Si la respuesta HTTP indica un error (p.ej. 404 si no existe).
+        urllib.error.URLError: Si no se puede conectar al servidor.
+    """
+    url = f"{server_url.rstrip('/')}/api/kernels/{kernel_id}/restart"
+    result = _make_request("POST", url, token)
+    return result if isinstance(result, dict) else {}
+
+
+def jupyter_kernel_interrupt(
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+    kernel_id: str = "",
+) -> None:
+    """Interrumpe la ejecucion actual de un kernel.
+
+    Args:
+        server_url: URL base del servidor Jupyter.
+        token: Token de autenticacion. Vacio si el servidor no requiere auth.
+        kernel_id: ID del kernel a interrumpir.
+
+    Raises:
+        urllib.error.HTTPError: Si la respuesta HTTP indica un error (p.ej. 404 si no existe).
+        urllib.error.URLError: Si no se puede conectar al servidor.
+    """
+    url = f"{server_url.rstrip('/')}/api/kernels/{kernel_id}/interrupt"
+    _make_request("POST", url, token)
+
+
+def jupyter_kernel_shutdown(
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+    kernel_id: str = "",
+) -> None:
+    """Apaga y elimina un kernel.
+
+    Args:
+        server_url: URL base del servidor Jupyter.
+        token: Token de autenticacion. Vacio si el servidor no requiere auth.
+        kernel_id: ID del kernel a apagar.
+
+    Raises:
+        urllib.error.HTTPError: Si la respuesta HTTP indica un error (p.ej. 404 si no existe).
+        urllib.error.URLError: Si no se puede conectar al servidor.
+    """
+    url = f"{server_url.rstrip('/')}/api/kernels/{kernel_id}"
+    _make_request("DELETE", url, token)
+
+
+def jupyter_kernel_sessions(
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+) -> list[dict]:
+    """Lista las sesiones activas del servidor Jupyter.
+
+    Cada sesion mapea un notebook a su kernel y usuario actuales.
+
+    Args:
+        server_url: URL base del servidor Jupyter.
+        token: Token de autenticacion. Vacio si el servidor no requiere auth.
+
+    Returns:
+        Lista de dicts con los campos: id, notebook (path), kernel_id,
+        kernel_state, type, name.
+
+    Raises:
+        urllib.error.HTTPError: Si la respuesta HTTP indica un error.
+        urllib.error.URLError: Si no se puede conectar al servidor.
+    """
+    url = f"{server_url.rstrip('/')}/api/sessions"
+    raw = _make_request("GET", url, token)
+    if not isinstance(raw, list):
+        return []
+
+    sessions = []
+    for s in raw:
+        kernel = s.get("kernel") or {}
+        sessions.append(
+            {
+                "id": s.get("id", ""),
+                "notebook": s.get("path", ""),
+                "kernel_id": kernel.get("id", ""),
+                "kernel_state": kernel.get("execution_state", ""),
+                "type": s.get("type", ""),
+                "name": s.get("name", ""),
+            }
+        )
+    return sessions
+
+
+# ---------------------------------------------------------------------------
+# CLI
+# ---------------------------------------------------------------------------
+
+if __name__ == "__main__":
+    import argparse
+    import sys
+
+    parser = argparse.ArgumentParser(
+        description="CRUD de kernels Jupyter via REST API."
+    )
+    parser.add_argument(
+        "--server",
+        default="http://localhost:8888",
+        help="URL base del servidor Jupyter (default: http://localhost:8888)",
+    )
+    parser.add_argument(
+        "--token",
+        default="",
+        help="Token de autenticacion de Jupyter (default: vacio)",
+    )
+
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    # list
+    subparsers.add_parser("list", help="Lista todos los kernels activos.")
+
+    # start
+    sp_start = subparsers.add_parser("start", help="Inicia un kernel nuevo.")
+    sp_start.add_argument(
+        "--name",
+        default="python3",
+        help="Nombre del kernel (default: python3)",
+    )
+
+    # restart
+    sp_restart = subparsers.add_parser("restart", help="Reinicia un kernel existente.")
+    sp_restart.add_argument("kernel_id", help="ID del kernel a reiniciar.")
+
+    # interrupt
+    sp_interrupt = subparsers.add_parser(
+        "interrupt", help="Interrumpe la ejecucion de un kernel."
+    )
+    sp_interrupt.add_argument("kernel_id", help="ID del kernel a interrumpir.")
+
+    # shutdown
+    sp_shutdown = subparsers.add_parser("shutdown", help="Apaga y elimina un kernel.")
+    sp_shutdown.add_argument("kernel_id", help="ID del kernel a apagar.")
+
+    # sessions
+    subparsers.add_parser("sessions", help="Lista las sesiones activas.")
+
+    args = parser.parse_args()
+
+    try:
+        if args.command == "list":
+            result = jupyter_kernel_list(args.server, args.token)
+        elif args.command == "start":
+            result = jupyter_kernel_start(args.server, args.token, args.name)
+        elif args.command == "restart":
+            result = jupyter_kernel_restart(args.server, args.token, args.kernel_id)
+            if result is None:
+                result = {"status": "restarted", "kernel_id": args.kernel_id}
+        elif args.command == "interrupt":
+            jupyter_kernel_interrupt(args.server, args.token, args.kernel_id)
+            result = {"status": "interrupted", "kernel_id": args.kernel_id}
+        elif args.command == "shutdown":
+            jupyter_kernel_shutdown(args.server, args.token, args.kernel_id)
+            result = {"status": "shutdown", "kernel_id": args.kernel_id}
+        elif args.command == "sessions":
+            result = jupyter_kernel_sessions(args.server, args.token)
+        else:
+            parser.print_help()
+            sys.exit(1)
+
+        print(json.dumps(result, indent=2))
+    except urllib.error.HTTPError as e:
+        body = e.read().decode("utf-8", errors="replace")
+        print(
+            json.dumps({"error": f"HTTP {e.code}: {e.reason}", "detail": body}),
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    except urllib.error.URLError as e:
+        print(
+            json.dumps({"error": f"URLError: {e.reason}"}),
+            file=sys.stderr,
+        )
+        sys.exit(1)
diff --git a/python/functions/notebook/jupyter_read.md b/python/functions/notebook/jupyter_read.md
new file mode 100644
index 00000000..0e04d426
--- /dev/null
+++ b/python/functions/notebook/jupyter_read.md
@@ -0,0 +1,118 @@
+---
+name: jupyter_read
+kind: function
+lang: py
+domain: notebook
+version: "1.0.0"
+purity: impure
+signature: "def jupyter_read_cells(notebook_path: str, server_url: str = 'http://localhost:8888', token: str = '', cell_index: int | None = None) -> list[dict]"
+description: "Lee celdas de un notebook Jupyter abierto via el protocolo de colaboracion en tiempo real (CRDT/Y.js). Devuelve el estado actual incluyendo cambios no guardados. Expone tambien jupyter_notebook_info() para metadata rapida."
+tags: [jupyter, notebook, crdt, yjs, websocket, cells, read, realtime]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: [jupyter_nbmodel_client]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "python/functions/notebook/jupyter_read.py"
+---
+
+## Funciones exportadas
+
+### `jupyter_read_cells`
+
+```python
+def jupyter_read_cells(
+    notebook_path: str,
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+    cell_index: int | None = None,
+) -> list[dict]
+```
+
+Lee todas las celdas o una especifica de un notebook Jupyter en vivo.
+Retorna lista de dicts:
+
+```python
+{"index": 0, "type": "code", "source": "import pandas as pd", "outputs": ["..."]}
+```
+
+- Para celdas markdown y raw, el campo `outputs` no se incluye.
+- Para code cells, los outputs se convierten a texto legible:
+  - `stream` -> texto plano
+  - `display_data`/`execute_result` -> `text/plain`, o `[HTML Output]`, `[Image Output (PNG)]`
+  - `error` -> traceback limpio (sin codigos ANSI)
+
+### `jupyter_notebook_info`
+
+```python
+def jupyter_notebook_info(
+    notebook_path: str,
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+) -> dict
+```
+
+Retorna metadata del notebook:
+
+```python
+{
+    "notebook_path": "notebooks/analysis.ipynb",
+    "server_url": "http://localhost:8888",
+    "total_cells": 12,
+    "cell_counts": {"code": 9, "markdown": 3}
+}
+```
+
+## Ejemplo
+
+```python
+from notebook.jupyter_read import jupyter_read_cells, jupyter_notebook_info
+
+# Leer todas las celdas
+cells = jupyter_read_cells(
+    "notebooks/analysis.ipynb",
+    server_url="http://localhost:8888",
+    token="mi-token",
+)
+for cell in cells:
+    print(f"[{cell['index']}] {cell['type']}: {cell['source'][:60]}")
+
+# Leer solo la celda 3
+cell = jupyter_read_cells("notebooks/analysis.ipynb", token="mi-token", cell_index=3)
+
+# Solo metadata
+info = jupyter_notebook_info("notebooks/analysis.ipynb", token="mi-token")
+print(f"Total celdas: {info['total_cells']}")
+```
+
+## CLI
+
+```bash
+# Ver todas las celdas (formato legible)
+python jupyter_read.py notebooks/analysis.ipynb --token MI_TOKEN
+
+# Ver solo la celda 5
+python jupyter_read.py notebooks/analysis.ipynb --token MI_TOKEN --cell 5
+
+# Solo metadata
+python jupyter_read.py notebooks/analysis.ipynb --token MI_TOKEN --info
+
+# Salida JSON (todas las celdas)
+python jupyter_read.py notebooks/analysis.ipynb --token MI_TOKEN --json
+
+# Servidor remoto
+python jupyter_read.py notebooks/analysis.ipynb --server http://mi-servidor:8888 --token MI_TOKEN
+```
+
+## Notas
+
+- Usa `NbModelClient` de `jupyter_nbmodel_client` con protocolo CRDT/Y.js.
+- Las funciones internas son `async`; las publicas envuelven con `asyncio.run()` para ser sincronas.
+- Lee el estado **en memoria del servidor**, no el archivo `.ipynb` en disco — captura cambios no guardados.
+- `notebook_path` debe ser relativo a la raiz del servidor Jupyter, no al sistema de archivos local.
+- Para servidores sin token, usar `token=""` (default).
+- El CLI muestra preview de hasta 8 lineas de source y 4 lineas por output en modo legible.
diff --git a/python/functions/notebook/jupyter_read.py b/python/functions/notebook/jupyter_read.py
new file mode 100644
index 00000000..c8fb695a
--- /dev/null
+++ b/python/functions/notebook/jupyter_read.py
@@ -0,0 +1,293 @@
+"""Lee celdas de un notebook Jupyter via protocolo de colaboracion en tiempo real (CRDT/Y.js)."""
+
+from __future__ import annotations
+
+import asyncio
+import json
+import sys
+from typing import Any
+from urllib.error import URLError
+from urllib.request import Request, urlopen
+
+from jupyter_nbmodel_client import NbModelClient, get_jupyter_notebook_websocket_url
+
+
+def _resolve_collab_username(server_url: str, token: str) -> str:
+    """Resolve the display name of the active user in Jupyter collaboration."""
+    headers = {"Accept": "application/json"}
+    if token:
+        headers["Authorization"] = f"token {token}"
+    try:
+        req = Request(f"{server_url}/api/me", headers=headers)
+        with urlopen(req, timeout=5) as resp:
+            me = json.loads(resp.read())
+        identity = me.get("identity", {})
+        return identity.get("display_name", "") or identity.get("username", "") or identity.get("name", "Anonymous")
+    except (URLError, OSError, json.JSONDecodeError):
+        return "Anonymous"
+
+
+# ---------------------------------------------------------------------------
+# Helpers internos (async)
+# ---------------------------------------------------------------------------
+
+def _extract_outputs(outputs: list[dict]) -> list[str]:
+    """Convierte outputs de celda en representaciones legibles."""
+    result = []
+    for out in outputs:
+        out_type = out.get("output_type", "")
+        if out_type == "stream":
+            text = out.get("text", "")
+            if isinstance(text, list):
+                text = "".join(text)
+            result.append(text.rstrip())
+        elif out_type in ("display_data", "execute_result"):
+            data = out.get("data", {})
+            if "text/plain" in data:
+                plain = data["text/plain"]
+                if isinstance(plain, list):
+                    plain = "".join(plain)
+                result.append(plain.rstrip())
+            elif "text/html" in data:
+                result.append("[HTML Output]")
+            elif "image/png" in data:
+                result.append("[Image Output (PNG)]")
+            else:
+                result.append(f"[Output: {list(data.keys())}]")
+        elif out_type == "error":
+            traceback = out.get("traceback", [])
+            # Strip ANSI codes for clean text
+            import re
+            ansi_escape = re.compile(r"\x1b\[[0-9;]*m")
+            clean = [ansi_escape.sub("", line) for line in traceback]
+            result.append("\n".join(clean))
+    return result
+
+
+def _cell_to_dict(index: int, cell: Any) -> dict:
+    """Convierte una NotebookNode en un dict normalizado."""
+    cell_type = cell.get("cell_type", "code")
+    source = cell.get("source", "")
+    if isinstance(source, list):
+        source = "".join(source)
+
+    entry: dict = {
+        "index": index,
+        "type": cell_type,
+        "source": source,
+    }
+
+    if cell_type == "code":
+        raw_outputs = cell.get("outputs", [])
+        entry["outputs"] = _extract_outputs(raw_outputs)
+
+    return entry
+
+
+async def _read_cells_async(
+    notebook_path: str,
+    server_url: str,
+    token: str,
+    cell_index: int | None,
+) -> list[dict]:
+    """Conecta al servidor Jupyter y lee las celdas del notebook."""
+    ws_url = get_jupyter_notebook_websocket_url(
+        server_url,
+        notebook_path,
+        token,
+    )
+    username = _resolve_collab_username(server_url, token)
+    async with NbModelClient(ws_url, username=username) as client:
+        await client.wait_until_synced()
+        total = len(client)
+        if cell_index is not None:
+            if cell_index < 0 or cell_index >= total:
+                raise IndexError(
+                    f"cell_index {cell_index} fuera de rango (0-{total - 1})"
+                )
+            return [_cell_to_dict(cell_index, client[cell_index])]
+        return [_cell_to_dict(i, client[i]) for i in range(total)]
+
+
+async def _notebook_info_async(
+    notebook_path: str,
+    server_url: str,
+    token: str,
+) -> dict:
+    """Conecta al servidor Jupyter y retorna metadata del notebook."""
+    ws_url = get_jupyter_notebook_websocket_url(
+        server_url,
+        notebook_path,
+        token,
+    )
+    username = _resolve_collab_username(server_url, token)
+    async with NbModelClient(ws_url, username=username) as client:
+        await client.wait_until_synced()
+        total = len(client)
+        counts: dict[str, int] = {}
+        for i in range(total):
+            ct = client[i].get("cell_type", "code")
+            counts[ct] = counts.get(ct, 0) + 1
+        return {
+            "notebook_path": notebook_path,
+            "server_url": server_url,
+            "total_cells": total,
+            "cell_counts": counts,
+        }
+
+
+# ---------------------------------------------------------------------------
+# API publica (sincrona)
+# ---------------------------------------------------------------------------
+
+def jupyter_read_cells(
+    notebook_path: str,
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+    cell_index: int | None = None,
+) -> list[dict]:
+    """Lee todas las celdas de un notebook Jupyter o una celda especifica.
+
+    Conecta via el protocolo de colaboracion en tiempo real (CRDT/Y.js) y
+    devuelve el estado actual del notebook incluyendo cambios no guardados.
+
+    Args:
+        notebook_path: Ruta relativa al notebook desde la raiz del servidor
+                       (ej: "notebooks/analysis.ipynb").
+        server_url: URL base del servidor Jupyter (default http://localhost:8888).
+        token: Token de autenticacion del servidor Jupyter.
+        cell_index: Si se indica, retorna solo esa celda (0-based). Si es None,
+                    retorna todas las celdas.
+
+    Returns:
+        Lista de dicts con campos:
+        - index (int): posicion de la celda en el notebook
+        - type (str): "code", "markdown" o "raw"
+        - source (str): contenido de la celda
+        - outputs (list[str]): solo para code cells; representacion legible
+          de cada output (stream, texto plano, [HTML Output], [Image Output (PNG)],
+          traceback de errores).
+
+    Raises:
+        IndexError: Si cell_index esta fuera del rango del notebook.
+        Exception: Si no se puede conectar al servidor Jupyter o al notebook.
+    """
+    return asyncio.run(
+        _read_cells_async(notebook_path, server_url, token, cell_index)
+    )
+
+
+def jupyter_notebook_info(
+    notebook_path: str,
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+) -> dict:
+    """Retorna metadata de un notebook Jupyter abierto.
+
+    Args:
+        notebook_path: Ruta relativa al notebook desde la raiz del servidor.
+        server_url: URL base del servidor Jupyter.
+        token: Token de autenticacion.
+
+    Returns:
+        Dict con:
+        - notebook_path (str): ruta del notebook
+        - server_url (str): URL del servidor
+        - total_cells (int): numero total de celdas
+        - cell_counts (dict): conteo por tipo {"code": N, "markdown": M, ...}
+
+    Raises:
+        Exception: Si no se puede conectar al servidor Jupyter o al notebook.
+    """
+    return asyncio.run(
+        _notebook_info_async(notebook_path, server_url, token)
+    )
+
+
+# ---------------------------------------------------------------------------
+# CLI
+# ---------------------------------------------------------------------------
+
+def _format_readable(cells: list[dict]) -> str:
+    """Formatea celdas en texto legible con preview de hasta 8 lineas."""
+    lines = []
+    for cell in cells:
+        header = f"[{cell['index']}] {cell['type'].upper()}"
+        lines.append(header)
+        lines.append("-" * len(header))
+        source_lines = cell["source"].splitlines()
+        preview = source_lines[:8]
+        lines.extend(preview)
+        if len(source_lines) > 8:
+            lines.append(f"... ({len(source_lines) - 8} lineas mas)")
+        if "outputs" in cell and cell["outputs"]:
+            lines.append("  -> outputs:")
+            for out in cell["outputs"]:
+                out_preview = out.splitlines()[:4]
+                for ol in out_preview:
+                    lines.append(f"     {ol}")
+                if len(out.splitlines()) > 4:
+                    lines.append("     ...")
+        lines.append("")
+    return "\n".join(lines)
+
+
+def main() -> None:
+    import argparse
+
+    parser = argparse.ArgumentParser(
+        description="Lee celdas de un notebook Jupyter via CRDT/Y.js"
+    )
+    parser.add_argument("notebook", help="Ruta del notebook relativa al servidor")
+    parser.add_argument(
+        "--server",
+        default="http://localhost:8888",
+        help="URL del servidor Jupyter (default: http://localhost:8888)",
+    )
+    parser.add_argument("--token", default="", help="Token de autenticacion")
+    parser.add_argument(
+        "--cell",
+        type=int,
+        default=None,
+        metavar="INDEX",
+        help="Indice de celda especifica (0-based)",
+    )
+    parser.add_argument(
+        "--info",
+        action="store_true",
+        help="Mostrar solo metadata del notebook",
+    )
+    parser.add_argument(
+        "--json",
+        action="store_true",
+        dest="as_json",
+        help="Salida en formato JSON",
+    )
+    args = parser.parse_args()
+
+    try:
+        if args.info:
+            result = jupyter_notebook_info(args.notebook, args.server, args.token)
+            if args.as_json:
+                print(json.dumps(result, ensure_ascii=False, indent=2))
+            else:
+                print(f"Notebook: {result['notebook_path']}")
+                print(f"Servidor: {result['server_url']}")
+                print(f"Total celdas: {result['total_cells']}")
+                for ct, count in result["cell_counts"].items():
+                    print(f"  {ct}: {count}")
+        else:
+            cells = jupyter_read_cells(
+                args.notebook, args.server, args.token, args.cell
+            )
+            if args.as_json:
+                print(json.dumps(cells, ensure_ascii=False, indent=2))
+            else:
+                print(_format_readable(cells))
+    except Exception as exc:
+        print(f"Error: {exc}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/python/functions/notebook/jupyter_write.md b/python/functions/notebook/jupyter_write.md
new file mode 100644
index 00000000..397f1df2
--- /dev/null
+++ b/python/functions/notebook/jupyter_write.md
@@ -0,0 +1,111 @@
+---
+name: jupyter_write
+kind: function
+lang: py
+domain: notebook
+version: "1.0.0"
+purity: impure
+signature: "def jupyter_append_code(notebook_path: str, source: str, server_url: str = 'http://localhost:8888', token: str = '') -> dict"
+description: "Operaciones de escritura sobre celdas de un notebook Jupyter via colaboracion en tiempo real (WebSocket). Expone cinco operaciones: append_code, append_markdown, insert, edit, delete. NO ejecuta celdas — solo modifica la estructura del notebook."
+tags: [jupyter, notebook, websocket, cell, write, append, insert, edit, delete, nbmodel]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: [jupyter_nbmodel_client]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "python/functions/notebook/jupyter_write.py"
+---
+
+## Funciones expuestas
+
+| Funcion | Descripcion |
+|---------|-------------|
+| `jupyter_append_code(notebook_path, source, server_url, token)` | Anade celda de codigo al final |
+| `jupyter_append_markdown(notebook_path, source, server_url, token)` | Anade celda markdown al final |
+| `jupyter_insert_cell(notebook_path, cell_index, source, cell_type, server_url, token)` | Inserta celda en posicion especifica |
+| `jupyter_edit_cell(notebook_path, cell_index, source, server_url, token)` | Sobrescribe contenido de celda existente |
+| `jupyter_delete_cell(notebook_path, cell_index, server_url, token)` | Elimina una celda |
+
+## Ejemplo
+
+```python
+from notebook.jupyter_write import (
+    jupyter_append_code,
+    jupyter_append_markdown,
+    jupyter_insert_cell,
+    jupyter_edit_cell,
+    jupyter_delete_cell,
+)
+
+# Anadir celda de codigo al final
+result = jupyter_append_code(
+    notebook_path="notebooks/01_analisis.ipynb",
+    source="import pandas as pd\ndf = pd.read_csv('data.csv')",
+    server_url="http://localhost:8888",
+    token="mi-token",
+)
+# {"action": "append_code", "cell_index": 5, "notebook": "notebooks/01_analisis.ipynb"}
+
+# Anadir celda markdown
+result = jupyter_append_markdown(
+    notebook_path="notebooks/01_analisis.ipynb",
+    source="## Resultados\n\nAnalisis de los datos obtenidos.",
+)
+# {"action": "append_markdown", "cell_index": 6, "notebook": "notebooks/01_analisis.ipynb"}
+
+# Insertar celda en posicion 2
+result = jupyter_insert_cell(
+    notebook_path="notebooks/01_analisis.ipynb",
+    cell_index=2,
+    source="# celda insertada",
+    cell_type="code",
+)
+# {"action": "insert", "cell_index": 2, "cell_type": "code", "notebook": "..."}
+
+# Editar celda existente (indice 0)
+result = jupyter_edit_cell(
+    notebook_path="notebooks/01_analisis.ipynb",
+    cell_index=0,
+    source="# Titulo actualizado",
+)
+# {"action": "edit", "cell_index": 0, "notebook": "..."}
+
+# Eliminar celda
+result = jupyter_delete_cell(
+    notebook_path="notebooks/01_analisis.ipynb",
+    cell_index=3,
+)
+# {"action": "delete", "cell_index": 3, "notebook": "..."}
+```
+
+## CLI
+
+```bash
+# Anadir celda de codigo
+python -m notebook.jupyter_write append-code notebooks/01.ipynb "print('hola')" --server http://localhost:8888 --token mi-token
+
+# Anadir celda markdown
+python -m notebook.jupyter_write append-markdown notebooks/01.ipynb "## Titulo"
+
+# Insertar en posicion 2
+python -m notebook.jupyter_write insert notebooks/01.ipynb 2 "x = 42" --type code
+
+# Editar celda 0
+python -m notebook.jupyter_write edit notebooks/01.ipynb 0 "# Nuevo titulo"
+
+# Eliminar celda 3
+python -m notebook.jupyter_write delete notebooks/01.ipynb 3
+```
+
+## Notas
+
+- Todas las funciones son sincronas publicamente. Internamente usan `asyncio.run()` sobre corutinas async que se comunican via WebSocket con `NbModelClient`.
+- El `notebook_path` es relativo al servidor Jupyter (no al filesystem local).
+- Si el servidor no esta corriendo o el token es incorrecto, lanza excepcion de conexion de `jupyter_nbmodel_client`.
+- NO ejecuta celdas — solo modifica la estructura. Para ejecutar, usar el MCP de Jupyter o la API REST de Jupyter.
+- `server_url` y `token` tienen defaults convenientes para desarrollo local (`http://localhost:8888`, token vacio).
+- El campo `cell_index` en el resultado refleja la posicion final de la celda en el notebook.
diff --git a/python/functions/notebook/jupyter_write.py b/python/functions/notebook/jupyter_write.py
new file mode 100644
index 00000000..aafc1672
--- /dev/null
+++ b/python/functions/notebook/jupyter_write.py
@@ -0,0 +1,329 @@
+"""Operaciones de escritura sobre celdas de un notebook Jupyter via colaboracion en tiempo real.
+
+NO ejecuta celdas — solo modifica la estructura del notebook (append, insert, edit, delete).
+Usa jupyter_nbmodel_client para comunicarse con el servidor Jupyter via WebSocket.
+"""
+
+import asyncio
+import json
+import argparse
+from urllib.error import URLError
+from urllib.request import Request, urlopen
+
+from jupyter_nbmodel_client import NbModelClient, get_jupyter_notebook_websocket_url
+
+
+def _resolve_collab_username(server_url: str, token: str) -> str:
+    """Resolve the display name of the active user in Jupyter collaboration."""
+    headers = {"Accept": "application/json"}
+    if token:
+        headers["Authorization"] = f"token {token}"
+    try:
+        req = Request(f"{server_url}/api/me", headers=headers)
+        with urlopen(req, timeout=5) as resp:
+            me = json.loads(resp.read())
+        identity = me.get("identity", {})
+        return identity.get("display_name", "") or identity.get("username", "") or identity.get("name", "Anonymous")
+    except (URLError, OSError, json.JSONDecodeError):
+        return "Anonymous"
+
+
+# ---------------------------------------------------------------------------
+# Helpers internos async
+# ---------------------------------------------------------------------------
+
+
+async def _append_cell(
+    notebook_path: str,
+    source: str,
+    cell_type: str,
+    server_url: str,
+    token: str,
+) -> dict:
+    ws_url = get_jupyter_notebook_websocket_url(
+        server_url=server_url,
+        token=token,
+        path=notebook_path,
+    )
+    username = _resolve_collab_username(server_url, token)
+    async with NbModelClient(ws_url, username=username) as nb:
+        if cell_type == "markdown":
+            nb.add_markdown_cell(source)
+        else:
+            nb.add_code_cell(source)
+        cell_index = len(nb) - 1
+        await asyncio.sleep(2)
+    return {
+        "action": f"append_{cell_type}",
+        "cell_index": cell_index,
+        "notebook": notebook_path,
+    }
+
+
+async def _insert_cell(
+    notebook_path: str,
+    cell_index: int,
+    source: str,
+    cell_type: str,
+    server_url: str,
+    token: str,
+) -> dict:
+    ws_url = get_jupyter_notebook_websocket_url(
+        server_url=server_url,
+        token=token,
+        path=notebook_path,
+    )
+    username = _resolve_collab_username(server_url, token)
+    async with NbModelClient(ws_url, username=username) as nb:
+        nb.insert_cell(cell_index, cell_type=cell_type, source=source)
+        await asyncio.sleep(2)
+    return {
+        "action": "insert",
+        "cell_index": cell_index,
+        "cell_type": cell_type,
+        "notebook": notebook_path,
+    }
+
+
+async def _edit_cell(
+    notebook_path: str,
+    cell_index: int,
+    source: str,
+    server_url: str,
+    token: str,
+) -> dict:
+    ws_url = get_jupyter_notebook_websocket_url(
+        server_url=server_url,
+        token=token,
+        path=notebook_path,
+    )
+    username = _resolve_collab_username(server_url, token)
+    async with NbModelClient(ws_url, username=username) as nb:
+        nb.set_cell_source(cell_index, source)
+        await asyncio.sleep(2)
+    return {
+        "action": "edit",
+        "cell_index": cell_index,
+        "notebook": notebook_path,
+    }
+
+
+async def _delete_cell(
+    notebook_path: str,
+    cell_index: int,
+    server_url: str,
+    token: str,
+) -> dict:
+    ws_url = get_jupyter_notebook_websocket_url(
+        server_url=server_url,
+        token=token,
+        path=notebook_path,
+    )
+    username = _resolve_collab_username(server_url, token)
+    async with NbModelClient(ws_url, username=username) as nb:
+        nb.delete_cell(cell_index)
+        await asyncio.sleep(2)
+    return {
+        "action": "delete",
+        "cell_index": cell_index,
+        "notebook": notebook_path,
+    }
+
+
+# ---------------------------------------------------------------------------
+# API publica sincrona
+# ---------------------------------------------------------------------------
+
+
+def jupyter_append_code(
+    notebook_path: str,
+    source: str,
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+) -> dict:
+    """Anade una celda de codigo al final del notebook.
+
+    Args:
+        notebook_path: Ruta relativa al notebook dentro del servidor Jupyter.
+        source: Codigo fuente de la celda.
+        server_url: URL base del servidor Jupyter.
+        token: Token de autenticacion del servidor Jupyter.
+
+    Returns:
+        dict con action, cell_index y notebook.
+    """
+    return asyncio.run(_append_cell(notebook_path, source, "code", server_url, token))
+
+
+def jupyter_append_markdown(
+    notebook_path: str,
+    source: str,
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+) -> dict:
+    """Anade una celda markdown al final del notebook.
+
+    Args:
+        notebook_path: Ruta relativa al notebook dentro del servidor Jupyter.
+        source: Contenido markdown de la celda.
+        server_url: URL base del servidor Jupyter.
+        token: Token de autenticacion del servidor Jupyter.
+
+    Returns:
+        dict con action, cell_index y notebook.
+    """
+    return asyncio.run(
+        _append_cell(notebook_path, source, "markdown", server_url, token)
+    )
+
+
+def jupyter_insert_cell(
+    notebook_path: str,
+    cell_index: int,
+    source: str,
+    cell_type: str = "code",
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+) -> dict:
+    """Inserta una celda en una posicion especifica del notebook.
+
+    Args:
+        notebook_path: Ruta relativa al notebook dentro del servidor Jupyter.
+        cell_index: Indice donde insertar (0 = primer posicion).
+        source: Contenido de la celda.
+        cell_type: Tipo de celda: "code" o "markdown".
+        server_url: URL base del servidor Jupyter.
+        token: Token de autenticacion del servidor Jupyter.
+
+    Returns:
+        dict con action, cell_index, cell_type y notebook.
+    """
+    return asyncio.run(
+        _insert_cell(notebook_path, cell_index, source, cell_type, server_url, token)
+    )
+
+
+def jupyter_edit_cell(
+    notebook_path: str,
+    cell_index: int,
+    source: str,
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+) -> dict:
+    """Sobrescribe el contenido de una celda existente.
+
+    Args:
+        notebook_path: Ruta relativa al notebook dentro del servidor Jupyter.
+        cell_index: Indice de la celda a editar (0-based).
+        source: Nuevo contenido de la celda.
+        server_url: URL base del servidor Jupyter.
+        token: Token de autenticacion del servidor Jupyter.
+
+    Returns:
+        dict con action, cell_index y notebook.
+    """
+    return asyncio.run(
+        _edit_cell(notebook_path, cell_index, source, server_url, token)
+    )
+
+
+def jupyter_delete_cell(
+    notebook_path: str,
+    cell_index: int,
+    server_url: str = "http://localhost:8888",
+    token: str = "",
+) -> dict:
+    """Elimina una celda del notebook.
+
+    Args:
+        notebook_path: Ruta relativa al notebook dentro del servidor Jupyter.
+        cell_index: Indice de la celda a eliminar (0-based).
+        server_url: URL base del servidor Jupyter.
+        token: Token de autenticacion del servidor Jupyter.
+
+    Returns:
+        dict con action, cell_index y notebook.
+    """
+    return asyncio.run(
+        _delete_cell(notebook_path, cell_index, server_url, token)
+    )
+
+
+# ---------------------------------------------------------------------------
+# CLI
+# ---------------------------------------------------------------------------
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="jupyter_write",
+        description="Operaciones de escritura sobre celdas de un notebook Jupyter.",
+    )
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    # Argumentos comunes
+    def add_common(p: argparse.ArgumentParser) -> None:
+        p.add_argument("--server", default="http://localhost:8888", help="URL del servidor Jupyter")
+        p.add_argument("--token", default="", help="Token de autenticacion")
+
+    # append-code
+    p_ac = sub.add_parser("append-code", help="Anade celda de codigo al final")
+    p_ac.add_argument("notebook", help="Ruta del notebook")
+    p_ac.add_argument("source", help="Codigo fuente")
+    add_common(p_ac)
+
+    # append-markdown
+    p_am = sub.add_parser("append-markdown", help="Anade celda markdown al final")
+    p_am.add_argument("notebook", help="Ruta del notebook")
+    p_am.add_argument("source", help="Contenido markdown")
+    add_common(p_am)
+
+    # insert
+    p_ins = sub.add_parser("insert", help="Inserta celda en posicion especifica")
+    p_ins.add_argument("notebook", help="Ruta del notebook")
+    p_ins.add_argument("index", type=int, help="Indice de insercion (0-based)")
+    p_ins.add_argument("source", help="Contenido de la celda")
+    p_ins.add_argument("--type", dest="cell_type", choices=["code", "markdown"], default="code")
+    add_common(p_ins)
+
+    # edit
+    p_ed = sub.add_parser("edit", help="Sobrescribe el contenido de una celda")
+    p_ed.add_argument("notebook", help="Ruta del notebook")
+    p_ed.add_argument("index", type=int, help="Indice de la celda (0-based)")
+    p_ed.add_argument("source", help="Nuevo contenido")
+    add_common(p_ed)
+
+    # delete
+    p_del = sub.add_parser("delete", help="Elimina una celda")
+    p_del.add_argument("notebook", help="Ruta del notebook")
+    p_del.add_argument("index", type=int, help="Indice de la celda (0-based)")
+    add_common(p_del)
+
+    return parser
+
+
+def main() -> None:
+    parser = _build_parser()
+    args = parser.parse_args()
+
+    if args.command == "append-code":
+        result = jupyter_append_code(args.notebook, args.source, args.server, args.token)
+    elif args.command == "append-markdown":
+        result = jupyter_append_markdown(args.notebook, args.source, args.server, args.token)
+    elif args.command == "insert":
+        result = jupyter_insert_cell(
+            args.notebook, args.index, args.source, args.cell_type, args.server, args.token
+        )
+    elif args.command == "edit":
+        result = jupyter_edit_cell(args.notebook, args.index, args.source, args.server, args.token)
+    elif args.command == "delete":
+        result = jupyter_delete_cell(args.notebook, args.index, args.server, args.token)
+    else:
+        parser.print_help()
+        return
+
+    print(json.dumps(result, indent=2))
+
+
+if __name__ == "__main__":
+    main()
diff --git a/sources/sources.yaml b/sources/sources.yaml
index 91ff9a4d..a3eceb21 100644
--- a/sources/sources.yaml
+++ b/sources/sources.yaml
@@ -17,4 +17,155 @@
 #   4. fn index para registrar en registry.db
 #   5. Actualizar este manifest con las funciones extraidas
 
-repos: []
+repos:
+  - repo: https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library
+    license: MIT
+    cloned_dir: frontend_library
+    extracted:
+      # Tipos (3)
+      - id: ThemeConfig_typescript_ui
+        source_file: frontend/src/themes/types.ts
+        date: 2026-04-01
+      - id: ChartSeries_typescript_ui
+        source_file: frontend/src/components/ui/charts/chart-base.tsx
+        date: 2026-04-01
+      - id: ComponentVariants_typescript_core
+        source_file: frontend/src/components/ui/button.tsx
+        date: 2026-04-01
+      # Funciones core puras (4)
+      - id: cn_typescript_core
+        source_file: frontend/src/lib/utils.ts
+        date: 2026-04-01
+      - id: get_series_color_typescript_core
+        source_file: frontend/src/components/ui/charts/chart-base.tsx
+        date: 2026-04-01
+      - id: theme_config_to_colors_typescript_core
+        source_file: frontend/src/themes/types.ts
+        date: 2026-04-01
+      - id: chart_colors_typescript_core
+        source_file: frontend/src/components/ui/charts/chart-base.tsx
+        date: 2026-04-01
+      # Componentes atómicos (10)
+      - id: button_typescript_ui
+        source_file: frontend/src/components/ui/button.tsx
+        date: 2026-04-01
+      - id: card_typescript_ui
+        source_file: frontend/src/components/ui/card.tsx
+        date: 2026-04-01
+      - id: input_typescript_ui
+        source_file: frontend/src/components/ui/input.tsx
+        date: 2026-04-01
+      - id: label_typescript_ui
+        source_file: frontend/src/components/ui/label.tsx
+        date: 2026-04-01
+      - id: badge_typescript_ui
+        source_file: frontend/src/components/ui/badge.tsx
+        date: 2026-04-01
+      - id: alert_typescript_ui
+        source_file: frontend/src/components/ui/alert.tsx
+        date: 2026-04-01
+      - id: skeleton_typescript_ui
+        source_file: frontend/src/components/ui/skeleton.tsx
+        date: 2026-04-01
+      - id: progress_bar_typescript_ui
+        source_file: frontend/src/components/ui/progress/progress-bar.tsx
+        date: 2026-04-01
+      - id: tooltip_typescript_ui
+        source_file: frontend/src/components/ui/tooltip.tsx
+        date: 2026-04-01
+      - id: select_typescript_ui
+        source_file: frontend/src/components/ui/select.tsx
+        date: 2026-04-01
+      # Componentes moleculares (5)
+      - id: dialog_typescript_ui
+        source_file: frontend/src/components/ui/dialog.tsx
+        date: 2026-04-01
+      - id: form_field_typescript_ui
+        source_file: frontend/src/components/ui/form-field.tsx
+        date: 2026-04-01
+      - id: tabs_typescript_ui
+        source_file: frontend/src/components/ui/tabs.tsx
+        date: 2026-04-01
+      - id: kpi_card_typescript_ui
+        source_file: frontend/src/components/ui/kpi-card.tsx
+        date: 2026-04-01
+      - id: page_header_typescript_ui
+        source_file: frontend/src/components/ui/page-header.tsx
+        date: 2026-04-01
+      # Charts (5)
+      - id: chart_container_typescript_ui
+        source_file: frontend/src/components/ui/charts/chart-base.tsx
+        date: 2026-04-01
+      - id: line_chart_typescript_ui
+        source_file: frontend/src/components/ui/charts/line-chart.tsx
+        date: 2026-04-01
+      - id: bar_chart_typescript_ui
+        source_file: frontend/src/components/ui/charts/bar-chart.tsx
+        date: 2026-04-01
+      - id: area_chart_typescript_ui
+        source_file: frontend/src/components/ui/charts/area-chart.tsx
+        date: 2026-04-01
+      - id: sparkline_typescript_ui
+        source_file: frontend/src/components/ui/sparkline.tsx
+        date: 2026-04-01
+      # Factories de composición (5)
+      - id: dashboard_layout_typescript_ui
+        source_file: ""
+        date: 2026-04-01
+      - id: crud_page_typescript_ui
+        source_file: ""
+        date: 2026-04-01
+      - id: analytics_page_typescript_ui
+        source_file: ""
+        date: 2026-04-01
+      - id: settings_page_typescript_ui
+        source_file: ""
+        date: 2026-04-01
+      - id: detail_page_typescript_ui
+        source_file: ""
+        date: 2026-04-01
+      # Theming (2)
+      - id: apply_theme_typescript_ui
+        source_file: frontend/src/hooks/use-theme.tsx
+        date: 2026-04-01
+      - id: theme_provider_typescript_ui
+        source_file: frontend/src/hooks/use-theme.tsx
+        date: 2026-04-01
+      # Wails IPC hooks (7)
+      - id: wails_cache_typescript_core
+        source_file: frontend/src/lib/wails/cache.ts
+        date: 2026-04-01
+      - id: WailsIPC_typescript_ui
+        source_file: frontend/src/lib/wails/types.ts
+        date: 2026-04-01
+      - id: wails_provider_typescript_ui
+        source_file: frontend/src/lib/wails/wails-provider.tsx
+        date: 2026-04-01
+      - id: use_wails_query_typescript_ui
+        source_file: frontend/src/lib/wails/use-wails-query.tsx
+        date: 2026-04-01
+      - id: use_wails_mutation_typescript_ui
+        source_file: frontend/src/lib/wails/use-wails-mutation.tsx
+        date: 2026-04-01
+      - id: use_wails_event_typescript_ui
+        source_file: frontend/src/lib/wails/use-wails-event.tsx
+        date: 2026-04-01
+      - id: use_wails_stream_typescript_ui
+        source_file: frontend/src/lib/wails/use-wails-stream.tsx
+        date: 2026-04-01
+      # Wails Go functions (5)
+      - id: scaffold_wails_app_go_infra
+        source_file: ""
+        date: 2026-04-01
+      - id: wails_build_go_infra
+        source_file: ""
+        date: 2026-04-01
+      - id: wails_emit_event_go_infra
+        source_file: ""
+        date: 2026-04-01
+      - id: wails_stream_data_go_infra
+        source_file: ""
+        date: 2026-04-01
+      - id: wails_bind_crud_go_infra
+        source_file: ""
+        date: 2026-04-01
diff --git a/types/infra/db_config.md b/types/infra/db_config.md
new file mode 100644
index 00000000..bc50f973
--- /dev/null
+++ b/types/infra/db_config.md
@@ -0,0 +1,21 @@
+---
+name: db_config
+lang: go
+domain: infra
+version: "1.0.0"
+algebraic: product
+definition: |
+  type DBConfig struct {
+      Driver string            // "sqlite", "duckdb", "postgres", "clickhouse"
+      DSN    string            // Data source name / connection string
+      Opts   map[string]string // Driver-specific options (optional)
+  }
+description: "Parametros de conexion para cualquier base de datos soportada. Agnóstico al driver."
+tags: [database, config, connection, sqlite, duckdb, postgres, clickhouse]
+uses_types: []
+file_path: "functions/infra/db_config.go"
+---
+
+## Notas
+
+Tipo producto — todos los campos siempre presentes. Driver toma uno de los valores: "sqlite", "duckdb", "postgres", "clickhouse". DSN es el connection string nativo del driver. Opts permite pasar opciones adicionales especificas del driver sin necesidad de un tipo por driver.
diff --git a/types/infra/nordvpn_status.md b/types/infra/nordvpn_status.md
new file mode 100644
index 00000000..0862f3da
--- /dev/null
+++ b/types/infra/nordvpn_status.md
@@ -0,0 +1,31 @@
+---
+name: NordVPNStatus
+lang: go
+domain: infra
+version: "1.0.0"
+algebraic: product
+definition: "type NordVPNStatus struct { Connected bool; Status string; Hostname string; IP string; Country string; City string; Technology string; Protocol string; Transfer string; Uptime string }"
+description: "Estado parseado de nordvpn status. Contiene informacion de conexion, servidor, ubicacion y protocolo."
+tags: [vpn, nordvpn, status, infra]
+uses_types: []
+file_path: "functions/infra/parse_nordvpn_status.go"
+---
+
+## Ejemplos
+
+```go
+s := NordVPNStatus{
+    Connected:  true,
+    Status:     "Connected",
+    Hostname:   "es42.nordvpn.com",
+    IP:         "185.230.124.42",
+    Country:    "Spain",
+    City:       "Madrid",
+    Technology: "NordLynx",
+    Protocol:   "nordlynx",
+}
+```
+
+## Notas
+
+Producido por ParseNordVPNStatus. Los campos corresponden a las claves de la salida de `nordvpn status`. Transfer y Uptime son strings sin parsear — incluir parseo numerico si se necesita.