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,6 +14,16 @@ returns: []
returns_optional: false
error_type: ""
imports: [math]
params:
- name: history
desc: "lista de dicts con metricas historicas (ej: [{'records_out': 100, 'duration_ms': 500}, ...])"
- name: current
desc: "dict con metricas actuales a comparar (ej: {'records_out': 50, 'duration_ms': 2000})"
- name: fields
desc: "lista de nombres de campos a monitorizar en current vs history (ej: ['records_out', 'duration_ms'])"
- name: threshold
desc: "umbral de z-score para declarar drift (tipico: 2.0-3.0). Mayor = menos sensible."
output: "lista de dicts con {field, current, mean, std, z_score, drifted} para cada campo monitoreado"
tested: true
tests:
- "campo con drift claro (z > threshold)"