egutierrez
a9cd28b010
Tracking de issues completados (jupyter tools) y funciones implementadas (specs de diseño ya resueltas).
1.2 KiB
1.2 KiB
Documentación consolidada de herramientas Jupyter
Componente: python/functions/notebook/
Problema
Las 5 funciones jupyter (discover, read, exec, write, kernel) tienen su documentación distribuida entre:
- El
--helpde cada script - La sección de
CLAUDE.mddel proyecto raíz - Los
.mdde frontmatter de cada función
No hay un documento único que explique el flujo completo, casos de uso comunes, y troubleshooting. Esto dificulta tanto el uso por agentes como por humanos.
Solución propuesta
Crear una función de tipo documentation o un .md dedicado que incluya:
- Flujo típico: discover → read → write/exec (con ejemplo completo)
- Tabla de subcomandos por función con parámetros y ejemplos
- Troubleshooting: errores comunes y soluciones
- Websocket 4404 (notebook no existe)
- Kernel does not exist (sesión stale)
- Document not yet synced (timing de colaboración)
- Limitaciones conocidas: qué NO pueden hacer las funciones
- Diferencias con MCP jupyter: por qué estas funciones lo reemplazan
Ubicación sugerida
python/functions/notebook/README.md o bien una función jupyter_help_py_notebook que imprima la guía.