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