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.

python/functions/notebook/jupyter_discover.md

@@ -14,6 +14,12 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [json, os, urllib.error, urllib.request, pathlib]
+params:
+  - name: registry_root
+    desc: "Raíz del registry para detectar análisis (opcional, usa FN_REGISTRY_ROOT si no se proporciona)"
+  - name: ports
+    desc: "Puertos a escanear (default: 8888-8892, detecta automáticamente)"
+output: "Lista de dicts con información de instancias Jupyter: url, port, analysis, root_dir, collaborative, kernels, sessions"
 tested: false
 tests: []
 test_file_path: ""

python/functions/notebook/jupyter_exec.md

@@ -14,6 +14,16 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [jupyter_kernel_client, jupyter_nbmodel_client]
+params:
+  - name: notebook_path
+    desc: "Ruta relativa al notebook"
+  - name: code
+    desc: "Código a ejecutar"
+  - name: server_url
+    desc: "URL del servidor Jupyter (default localhost:8888)"
+  - name: token
+    desc: "Token de autenticación (default vacío)"
+output: "Dict con cell_index y outputs del código ejecutado, o resultados del kernel"
 tested: false
 tests: []
 test_file_path: ""

python/functions/notebook/jupyter_kernel.md

@@ -14,6 +14,7 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [json, urllib.error, urllib.request]
+output: "Múltiples funciones para CRUD de kernels: list, start, restart, interrupt, shutdown, sessions (retornan dicts con metadatos)"
 tested: false
 tests: []
 test_file_path: ""

python/functions/notebook/jupyter_read.md

@@ -14,6 +14,16 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [jupyter_nbmodel_client]
+params:
+  - name: notebook_path
+    desc: "Ruta relativa del notebook"
+  - name: server_url
+    desc: "URL del servidor Jupyter (default localhost:8888)"
+  - name: token
+    desc: "Token de autenticación"
+  - name: cell_index
+    desc: "Índice de celda específica a leer (opcional)"
+output: "Lista de dicts con info de celdas (index, type, source, outputs) o dict con metadata del notebook"
 tested: false
 tests: []
 test_file_path: ""

python/functions/notebook/jupyter_write.md

@@ -14,6 +14,7 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: [jupyter_nbmodel_client]
+output: "Múltiples funciones para escribir en notebooks: append_code/markdown, insert, edit, delete, create, batch (retornan dicts con action y posición)"
 tested: false
 tests: []
 test_file_path: ""