Spraxium logoSpraxium

Información del CLI

Guía detallada del comando de diagnóstico spraxium info. Aprende cuándo usar salida legible para humanos o JSON en flujos de troubleshooting.

Cuándo usarlo

Usa spraxium info siempre que necesites una instantánea de diagnóstico rápida de la máquina y el proyecto actuales. Es especialmente útil antes de abrir issues, después de upgrades, cuando CI se comporta diferente al desarrollo local o cuando necesitas confirmar exactamente qué paquetes de Spraxium está ejecutando un proyecto.

terminal
spraxium info
spraxium info --json

Si solo necesitas una revisión rápida para humanos, la salida por defecto en terminal es suficiente. Si la salida se va a incluir en un ticket, script o artefacto de CI, prefiere el modo JSON para poder copiar y parsear el informe completo sin perder detalle.

Qué incluye el informe

El comando construye un informe con la versión del CLI, nombre del proyecto detectado, versión de Node, sistema operativo y ruta del runtime. También captura el package manager preferido y las versiones detectadas de npm, pnpm, yarn y bun. Por último, escanea el proyecto y el workspace para detectar todos los paquetes instalados @spraxium/* y lista cada versión.

Esa combinación importa porque la mayoría de preguntas de troubleshooting empiezan por una de estas incógnitas:

  1. ¿Qué versión de CLI se está ejecutando realmente?
  2. ¿La máquina está usando el runtime de Node esperado?
  3. ¿El proyecto está en el package manager que el equipo espera?
  4. ¿Los paquetes del framework están alineados o uno va atrasado respecto a los demás?

spraxium info responde esas preguntas en una sola pasada en lugar de obligarte a reunir los datos manualmente.

Cómo leer el informe

Revisa primero el runtime

Empieza por la versión de Node, el SO y la ruta del runtime. Si una máquina falla y otra funciona, este suele ser el lugar más rápido para detectar un desajuste de entorno.

Revisa después el package manager

Confirma si el proyecto usa pnpm, npm, yarn o bun. Los problemas de resolución de dependencias y deriva de lockfiles suelen empezar aquí.

Revisa la alineación de paquetes Spraxium

Compara las versiones detectadas de @spraxium/. Las versiones mezcladas son una fuente común de comportamiento confuso del framework tras upgrades parciales.

Modos de salida

Prefiere JSON al compartir diagnósticos

La salida por defecto es más fácil de leer en terminal. La salida JSON es mejor cuando el informe se va a pegar en un issue, guardar en CI o comparar entre máquinas.

Dónde y quién debería usarlo

  • Soporte interno: solicitar contexto mínimo a quien reporta.
  • Reportes públicos de bugs: adjuntar diagnósticos en plantillas de issue.
  • Depuración en CI: persistir el informe como artefacto de build.

Los equipos avanzados también se benefician después de upgrades de dependencias. Si un workspace empieza a comportarse distinto tras actualizar paquetes, spraxium info es la forma más rápida de confirmar si las versiones resueltas coinciden con lo que esperabas instalar.

Plantilla rápida para issues

snippet.txt
Problem summary:
Reproduction steps:
Expected result:
Actual result:
Output from `spraxium info --json`:

Hábito práctico

Si tu equipo da soporte a múltiples bots o entornos, convierte spraxium info --json en parte de la plantilla predeterminada de reporte de bugs. Ese pequeño hábito evita mucho ida y vuelta antes de poder empezar la depuración real.