feat(browser): auto-commit con 178 cambios

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

python/functions/datascience/render_eda_markdown.md

@@ -0,0 +1,103 @@
+---
+name: render_eda_markdown
+kind: function
+lang: py
+domain: datascience
+version: "1.0.0"
+purity: pure
+signature: "def render_eda_markdown(profile: dict) -> str"
+description: "Convierte un TableProfile (dict del grupo eda) en un report markdown legible y autosuficiente. Render puro: dict de entrada -> string markdown de salida. Lee todo defensivamente con .get(...) porque muchas claves del perfil pueden venir None. Genera secciones Overview, Columnas, Numéricas (con sparkline ASCII del histograma), Categóricas, Calidad, Correlaciones y Análisis LLM, omitiendo limpiamente lo que esté vacío."
+tags: [eda, markdown, render, report, profiling, datascience]
+params:
+  - name: profile
+    desc: "TableProfile dict del grupo eda: {table, source, profiled_at, n_rows, n_cols, size_bytes, duplicate_rows, duplicate_pct, constant_cols, all_null_cols, null_cell_pct, type_breakdown, columns:[ColumnProfile], correlations, key_candidates, quality_score, llm, models}. Cada ColumnProfile puede traer sub-dicts numeric/categorical/datetime que pueden ser None. Todas las claves se leen defensivamente."
+output: "String markdown con el report EDA. Empieza por '# EDA — <table>' y contiene las secciones disponibles (Overview, Columnas, Numéricas, Categóricas, Calidad, Correlaciones, Análisis LLM). Las secciones sin datos se omiten."
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: ""
+imports: []
+tested: true
+tests: ["test_contains_title_and_sections", "test_contains_column_names", "test_contains_sparkline", "test_pct_fields_scaled_by_100", "test_pct_handles_none_as_blank", "test_tolerates_none_correlations_and_llm", "test_tolerates_empty_profile", "test_tolerates_none_profile"]
+test_file_path: "python/functions/datascience/render_eda_markdown_test.py"
+file_path: "python/functions/datascience/render_eda_markdown.py"
+---
+
+## Ejemplo
+
+```python
+from datascience import render_eda_markdown
+
+profile = {
+    "table": "sales",
+    "source": "data/sales.csv",
+    "n_rows": 1000,
+    "n_cols": 1,
+    "null_cell_pct": 0.015,
+    "type_breakdown": {"numeric": 1},
+    "columns": [
+        {
+            "name": "price",
+            "inferred_type": "float",
+            "semantic_type": "currency",
+            "null_pct": 0.0,
+            "distinct_count": 850,
+            "unique_pct": 0.85,
+            "quality_score": 0.95,
+            "flags": [],
+            "numeric": {
+                "min": 1.0, "median": 40.0, "mean": 42.5, "std": 12.3,
+                "p25": 30.0, "p75": 55.0, "p95": 80.0, "p99": 95.0,
+                "skew": 0.4, "outlier_pct": 0.012, "distribution_type": "right-skewed",
+                "histogram": [
+                    {"lo": 0, "hi": 25, "count": 100},
+                    {"lo": 25, "hi": 50, "count": 500},
+                    {"lo": 50, "hi": 75, "count": 300},
+                    {"lo": 75, "hi": 100, "count": 50},
+                ],
+            },
+            "categorical": None,
+        },
+    ],
+    "correlations": None,
+    "llm": None,
+}
+
+md = render_eda_markdown(profile)
+print(md)
+```
+
+Salida (extracto):
+
+```markdown
+# EDA — sales
+
+source: `data/sales.csv` · 1000 rows × 1 cols
+...
+### price
+...
+histogram: `▂█▅▁`
+```
+
+## Cuando usarla
+
+Úsala como paso final de un pipeline EDA: tras construir el `TableProfile` (con las
+funciones del grupo `eda` que perfilan columnas, calidad e histogramas), pásaselo a
+esta función para obtener un report markdown listo para volcar a un `.md`, una celda
+de notebook, una nota de vault o un mensaje. Es render puro: no escribe a disco,
+solo devuelve el string, así que tú decides dónde guardarlo. Tolera perfiles
+parciales (correlaciones o LLM aún no calculados) sin fallar.
+
+## Gotchas
+
+Función pura sin efectos. El sparkline del histograma escala los `count` de cada bin
+linealmente sobre la rampa de bloques `▁▂▃▄▅▆▇█`; si todos los counts son iguales, se
+dibuja el bloque más bajo para todos. No escribe el report a ningún archivo — el
+caller es responsable de persistirlo.
+
+Convención de porcentajes: TODOS los campos `*_pct` (`null_pct`, `empty_pct`,
+`unique_pct`, `outlier_pct`, `zero_pct`, `negative_pct`, `null_cell_pct`,
+`duplicate_pct`, y el `pct`/`mode_pct` del sub-dict categorical) se esperan como
+**fracción 0-1** (p.ej. `unique_pct=0.857` = 85.7%). El render los multiplica por 100
+al formatear, mostrando `85.70%`. No pases valores ya en escala 0-100 o saldrán inflados.