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
@@ -31,6 +31,26 @@ imports:
- time
- warnings
- typing.Callable
params:
- name: file_path
desc: "Ruta del documento (PDF, TXT, Markdown) a procesar"
- name: entity_presets
desc: "Configuración de tipos de entidades a extraer con sus metadatos"
- name: relation_types
desc: "Tipos de relaciones a extraer (ej: 'owns', 'operates', 'communicates_with')"
- name: llm_chat_json
desc: "Función inyectada para llamadas al LLM (sin acoplamiento a proveedor)"
- name: chunk_size
desc: "Tamaño de chunks para procesamiento (default 500)"
- name: chunk_overlap
desc: "Solapamiento entre chunks (default 50)"
- name: confidence_threshold
desc: "Confianza mínima para incluir entidades (default 0.5)"
- name: dedup_threshold
desc: "Umbral fuzzy para deduplicación (default 0.85)"
- name: on_progress
desc: "Callback opcional para progreso (msg, percentage)"
output: "ExtractionResult con entidades, relaciones y estadísticas del proceso de extracción"
tested: true
tests:
- "documento con entidades y relaciones retorna ExtractionResult completo"
@@ -17,6 +17,10 @@ returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
params:
- name: app_name
desc: "Nombre de la app cuya operations.db registrar en Metabase"
output: "Void - registra la operations.db en Metabase como database SQLite y muestra mount requerido"
tested: false
tests: []
test_file_path: ""
@@ -21,6 +21,10 @@ returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
params:
- name: app_name
desc: "Nombre de la app para la que crear dashboard operativo"
output: "Void - crea dashboard en Metabase con KPIs, distribuciones y tablas de entities/executions/assertions"
tested: false
tests: []
test_file_path: ""
@@ -16,6 +16,7 @@ returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
output: "Void - arregla permisos SQLITE_READONLY_DIRECTORY en contenedor Metabase vía chmod 777/666"
tested: false
tests: []
test_file_path: ""
@@ -15,6 +15,16 @@ returns: []
returns_optional: false
error_type: "error_go_core"
imports: [numpy]
params:
- name: n_simulations
desc: "Número de simulaciones de mercado a ejecutar"
- name: base_params
desc: "Parámetros base aplicados a todas las simulaciones"
- name: vary_params
desc: "Parámetros a variar uniformemente: {param: (min, max)}"
- name: seed_start
desc: "Seed inicial para generador aleatorio (se incrementa por simulación)"
output: "Lista de dicts con parámetros usados y métricas: spreads, trades, volatilidad, PnL"
tested: false
tests: []
test_file_path: ""
@@ -16,6 +16,28 @@ returns: []
returns_optional: false
error_type: "error_go_core"
imports: [numpy]
params:
- name: initial_price
desc: "Precio inicial del activo"
- name: n_ticks
desc: "Número de ticks a simular"
- name: sigma
desc: "Volatilidad del precio fundamental"
- name: mu
desc: "Drift del precio fundamental"
- name: jump_intensity
desc: "Intensidad de saltos de Poisson"
- name: jump_size_std
desc: "Desviación estándar de tamaños de salto"
- name: n_makers
desc: "Número de market makers"
- name: gamma
desc: "Parámetro de aversión al riesgo de Avellaneda-Stoikov"
- name: hawkes_alpha
desc: "Parámetro de excitación del proceso Hawkes"
- name: seed
desc: "Seed para reproducibilidad"
output: "Dict con trades, spreads, midprices, PnL de makers y estadísticas del matching"
tested: false
tests: []
test_file_path: ""