chore: auto-commit (97 archivos)

- .claude/CLAUDE.md
- .claude/agents/fn-recopilador/SKILL.md
- .claude/rules/INDEX.md
- .claude/rules/cpp_apps.md
- bash/functions/infra/build_cpp_windows.sh
- cpp/CMakeLists.txt
- cpp/PATTERNS.md
- cpp/framework/app_base.cpp
- cpp/framework/app_base.h
- dev/issues/README.md
- ...

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

functions/datascience/metrics_drift.md

@@ -0,0 +1,56 @@
+---
+name: metrics_drift
+kind: function
+lang: go
+domain: datascience
+version: "1.0.0"
+purity: pure
+signature: "func MetricsDrift(historical []int64, current int64, percentile float64) (drift float64, baseline int64)"
+description: "Calcula la deriva relativa de una medicion actual respecto a una linea base historica. La linea base se obtiene como el percentil indicado del historico. drift = (current - baseline) / baseline. Retorna drift=0, baseline=0 si el historico esta vacio o la linea base es cero."
+tags: [metrics, drift, percentile, statistics, monitoring, baseline]
+uses_functions: [percentile_int64_go_datascience]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: [sort]
+tested: true
+tests:
+  - "historico vacio retorna drift 0 baseline 0"
+  - "baseline cero retorna drift 0 baseline 0"
+  - "drift positivo cuando current supera baseline"
+  - "drift negativo cuando current es menor que baseline"
+test_file_path: "functions/datascience/metrics_drift_test.go"
+file_path: "functions/datascience/metrics_drift.go"
+params:
+  - name: historical
+    desc: "Ventana de mediciones previas en la misma unidad que current (ms, bytes, etc.). No necesita estar ordenada."
+  - name: current
+    desc: "Medicion actual a comparar contra la linea base historica."
+  - name: percentile
+    desc: "Percentil para calcular la linea base: 0.5 = mediana, 0.95 = p95. Rango [0.0, 1.0]."
+output: "drift es la desviacion relativa como fraccion (0.47 = +47% por encima de la linea base, -0.5 = 50% por debajo). baseline es el valor del percentil sobre el historico."
+---
+
+## Ejemplo
+
+```go
+historical := []int64{100, 120, 95, 110, 105}  // ms de respuesta previos
+current := int64(200)                            // ms de la ejecucion actual
+
+drift, baseline := MetricsDrift(historical, current, 0.5)
+// baseline ≈ 105 (mediana)
+// drift ≈ 0.905 (+90.5% sobre la mediana)
+
+// Con p95 como referencia de "worst case normal"
+_, p95 := MetricsDrift(historical, current, 0.95)
+// p95 = 120
+```
+
+## Notas
+
+Funcion pura. El historico se ordena internamente (copia defensiva) antes de calcular el percentil con `Percentile` de `percentile_int64_go_datascience`. No muta el slice de entrada.
+
+El drift puede ser negativo (mejora) o positivo (degradacion). El caller decide el umbral de alarma (ej. `drift > 0.5` = degradacion mayor al 50%).
+
+Util para el agente `fn-analizador` para comparar `duration_ms` de la ejecucion actual contra el historico de `executions` en `operations.db`.