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:
@@ -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"
|
||||
|
||||
Reference in New Issue
Block a user