docs: params/output semántico en 506 funciones para composabilidad

Añade campos params y output al frontmatter YAML de las 506 funciones del registry.
Cada parámetro tiene descripción semántica (qué representa, unidades, rango típico)
y cada función describe qué produce su output. Permite a agentes razonar sobre
cadenas de composición (ej: prices → log_return → sharpe_ratio) sin leer código.

bash/functions/infra/assert_docker_container_running.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: container_name
+    desc: "nombre del contenedor Docker a verificar"
+output: "sin salida; exit code 0 si existe y está corriendo, 1 si no"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/infra/docker_cp_file.md

@@ -14,6 +14,14 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: local_path
+    desc: "ruta del archivo local a copiar"
+  - name: container_name
+    desc: "nombre del contenedor Docker destino"
+  - name: dest_path
+    desc: "ruta destino dentro del contenedor"
+output: "JSON con local_size y remote_size en bytes"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/infra/init_uv_venv.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: project_dir
+    desc: "directorio del proyecto donde crear el venv (default: directorio actual)"
+output: "ruta absoluta del venv creado o existente"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/infra/install_nbconvert.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: project_dir
+    desc: "directorio del proyecto con venv existente"
+output: "sin salida"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/infra/install_nordvpn.md

@@ -14,6 +14,8 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params: []
+output: "sin salida; muestra estado de instalación"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/infra/nordvpn_connect.md

@@ -14,6 +14,12 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: country
+    desc: "país de destino (opcional; default: auto)"
+  - name: city
+    desc: "ciudad de destino (opcional; default: auto)"
+output: "JSON con ok, server, country, city"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/infra/nordvpn_disconnect.md

@@ -14,6 +14,8 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params: []
+output: "JSON con ok y status"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/infra/nordvpn_get_ip.md

@@ -14,6 +14,8 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params: []
+output: "JSON con ok, ip, vpn_connected, vpn_server, source"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/infra/nordvpn_list_cities.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: country
+    desc: "nombre del país en NordVPN (ej: Spain, United_States)"
+output: "JSON con ok, country, count, cities (array de strings)"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/infra/nordvpn_list_countries.md

@@ -14,6 +14,8 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params: []
+output: "JSON con ok, count, countries (array de strings ordenado alfabéticamente)"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/infra/nordvpn_set_protocol.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: protocol
+    desc: "protocolo a usar: NordLynx (WireGuard) u OpenVPN"
+output: "JSON con ok y protocol confirmado"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/infra/nordvpn_status.md

@@ -14,6 +14,8 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params: []
+output: "JSON con estado de VPN: ok, connected, status, hostname, ip, country, city, etc"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/infra/notebook_to_pdf.md

@@ -14,6 +14,14 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: project_dir
+    desc: "directorio raíz del proyecto con venv y notebooks"
+  - name: pattern
+    desc: "glob de notebooks a convertir (default: notebooks/*.ipynb)"
+  - name: output_dir
+    desc: "directorio destino para PDFs relativo a project_dir (default: notebooks/pdf/)"
+output: "lista de PDFs generados con sus rutas"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/infra/pass_delete.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: entry
+    desc: "ruta de entrada en el password store (ej: agentes/token)"
+output: "sin salida"
 tested: true
 tests: ["elimina entrada de test", "falla con entrada inexistente"]
 test_file_path: "bash/functions/infra/pass_test.sh"

bash/functions/infra/pass_generate.md

@@ -14,6 +14,12 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: entry
+    desc: "ruta de entrada en el password store"
+  - name: length
+    desc: "longitud del password (default: 24 caracteres)"
+output: "password generado en texto plano"
 tested: true
 tests: ["genera password de longitud especifica", "default 24 chars"]
 test_file_path: "bash/functions/infra/pass_test.sh"

bash/functions/infra/pass_get.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: entry
+    desc: "ruta de entrada en el password store"
+output: "valor del secreto en texto plano"
 tested: true
 tests: ["lee entrada existente", "falla con entrada inexistente"]
 test_file_path: "bash/functions/infra/pass_test.sh"

bash/functions/infra/pass_list.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: prefix
+    desc: "prefijo para filtrar entradas (opcional; ej: agentes)"
+output: "JSON array de nombres de entradas"
 tested: true
 tests: ["lista todas las entradas", "filtra por prefijo"]
 test_file_path: "bash/functions/infra/pass_test.sh"

bash/functions/infra/pass_set.md

@@ -14,6 +14,12 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: entry
+    desc: "ruta de entrada en el password store"
+  - name: value
+    desc: "valor del secreto (opcional; se lee de stdin si no se proporciona)"
+output: "sin salida"
 tested: true
 tests: ["inserta valor y lo lee de vuelta", "sobreescribe valor existente"]
 test_file_path: "bash/functions/infra/pass_test.sh"

bash/functions/infra/pass_sync.md

@@ -14,6 +14,8 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params: []
+output: "JSON con resultados de pull y push"
 tested: true
 tests: ["sincroniza con remoto"]
 test_file_path: "bash/functions/infra/pass_test.sh"

bash/functions/infra/uv_add_packages.md

@@ -14,6 +14,12 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: project_dir
+    desc: "directorio del proyecto con venv existente"
+  - name: packages
+    desc: "nombres de paquetes Python a instalar (variadic)"
+output: "sin salida"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/infra/write_claude_jupyter_rules.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: project_dir
+    desc: "directorio del proyecto Jupyter (default: directorio actual)"
+output: "ruta del archivo .claude/CLAUDE.md generado o actualizado"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/infra/write_jupyter_launcher.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: project_dir
+    desc: "directorio del proyecto Jupyter (default: directorio actual)"
+output: "ruta del script run-jupyter-lab.sh generado"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/infra/write_jupyter_registry_kernel.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: project_dir
+    desc: "directorio del proyecto Jupyter (default: directorio actual)"
+output: "ruta del archivo startup generado"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/infra/write_mcp_jupyter_config.md

@@ -14,6 +14,12 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: project_dir
+    desc: "directorio del proyecto Jupyter (default: directorio actual)"
+  - name: port
+    desc: "puerto Jupyter (default: detectado automáticamente)"
+output: "ruta del archivo .mcp.json generado o actualizado"
 tested: false
 tests: []
 test_file_path: ""