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/shell/assert_command_exists.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: command_name
+    desc: "nombre del comando a verificar en PATH"
+output: "sin salida en éxito"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/shell/assert_file_exists.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: file_path
+    desc: "ruta del archivo a verificar"
+output: "tamaño del archivo en bytes"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/shell/exit_with_status.md

@@ -14,6 +14,14 @@ returns: []
 returns_optional: false
 error_type: ""
 imports: []
+params:
+  - name: total_steps
+    desc: "número total de pasos ejecutados"
+  - name: ok_steps
+    desc: "número de pasos exitosos"
+  - name: failed_steps
+    desc: "número de pasos fallidos"
+output: "exit code: 0 (éxito), 1 (fallo), o 2 (parcial)"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/shell/find_free_port.md

@@ -14,6 +14,12 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: start_port
+    desc: "puerto inicial del rango (default: 8888)"
+  - name: end_port
+    desc: "puerto final del rango (default: 8899)"
+output: "número de puerto TCP libre"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/shell/report_execution_json.md

@@ -14,6 +14,22 @@ returns: []
 returns_optional: false
 error_type: ""
 imports: []
+params:
+  - name: flow_name
+    desc: "nombre del flujo ejecutado"
+  - name: status
+    desc: "estado final: success, failure, o partial"
+  - name: exit_code
+    desc: "código de salida: 0, 1, o 2"
+  - name: started_at
+    desc: "timestamp ISO8601 de inicio"
+  - name: ended_at
+    desc: "timestamp ISO8601 de fin"
+  - name: duration_ms
+    desc: "duración total en milisegundos"
+  - name: steps_file
+    desc: "archivo TSV con resultados de cada paso"
+output: "JSON estructurado con metadatos de ejecución y array de pasos"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/shell/run_steps.md

@@ -14,6 +14,12 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: yaml_file
+    desc: "archivo YAML con especificación de pasos"
+  - name: --strict
+    desc: "flag opcional para mapear partial a failure"
+output: "JSON de ejecución con detalles de cada paso"
 tested: false
 tests: []
 test_file_path: ""

bash/functions/shell/validate_registry_paths.md

@@ -14,6 +14,14 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: db_path
+    desc: "ruta a registry.db"
+  - name: table
+    desc: "tabla a validar: functions o types"
+  - name: root_dir
+    desc: "directorio raíz del repositorio"
+output: "TSV con id, file_path, domain, tabla de rutas inválidas"
 tested: false
 tests: []
 test_file_path: ""