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,14 @@ returns: []
|
||||
returns_optional: false
|
||||
error_type: "error_go_core"
|
||||
imports: [threading]
|
||||
params:
|
||||
- name: key
|
||||
desc: "Clave de traducción con dot-path notation (ej: 'report.done')"
|
||||
- name: locale
|
||||
desc: "Locale a usar (default: usa locale thread-local)"
|
||||
- name: kwargs
|
||||
desc: "Variables para interpolación en el template"
|
||||
output: "String traducido e interpolado, o la key si no se encuentra traducción"
|
||||
tested: true
|
||||
tests: ["key existente retorna traduccion", "key inexistente retorna la key", "interpolacion de variables", "dot-path profundo", "fallback a locale default"]
|
||||
test_file_path: "python/functions/core/t_test.py"
|
||||
|
||||
Reference in New Issue
Block a user