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.
This commit is contained in:
2026-04-05 18:45:16 +02:00
parent bd1bf2b5dc
commit 988e901066
506 changed files with 2964 additions and 0 deletions
+14
View File
@@ -14,6 +14,20 @@ returns: [directory_scan_result_py_infra]
returns_optional: false
error_type: "error_go_core"
imports: [os, pathlib, fnmatch, sys, dataclasses]
params:
- name: root
desc: "directorio raiz a escanear"
- name: supported_extensions
desc: "conjunto opcional de extensiones soportadas (ej: {'.pdf', '.md'})"
- name: ignore_dirs
desc: "conjunto opcional de nombres de directorio a ignorar"
- name: include
desc: "patrones glob opcionales separados por coma para incluir archivos"
- name: exclude
desc: "patrones glob opcionales separados por coma para excluir archivos"
- name: strict
desc: "si True, lanza ValueError si hay archivos no soportados"
output: "instancia DirectoryScanResult con listas processable y unsupported de ClassifiedFile"
tested: true
tests:
- "directorio con mezcla de archivos"