Documentación / Inicio / Descripción general

Descripción general

kedgeway es una herramienta de línea de comandos que te dice qué tan desactualizado está el toolchain de un repo de Stellar o Soroban. Lee tus manifiestos, le pregunta al ecosistema en vivo cuál es la versión actual y reporta la diferencia con sus fuentes.

Qué es

Una CLI que escanea Cargo.toml (soroban-sdk) y package.json (@stellar/stellar-sdk, @stellar/stellar-base y los paquetes heredados soroban-client y stellar-sdk).
Basada en datos en vivo del servidor MCP Stellar Raven: la página oficial Software Versions y el índice de toolchains del ecosistema de Scout.
La evidencia primero. Cada hallazgo cita su fuente y la hora en que se observó.
Honesta ante las fallas. Si no se puede acceder a una fuente, el reporte dice DATA_DEGRADED en lugar de adivinar.

Qué no es

No reescribe código. diagnose nunca modifica tu repo. La migración imprime una guía y actualiza las cadenas de versión. Nunca ejecuta cargo ni npm.
No es un auditor completo de lockfiles. Usa la versión resuelta de la dependencia directa cuando un lockfile compatible da un único resultado y, si no, recurre al manifiesto.
No es una auditoría de seguridad ni de contratos. Solo mide el desfase de versión del SDK.
No es un servicio. El contenido de tu repo nunca sale de tu máquina. Consulta Autenticación.

Cómo razona

Escanear. Recorre el repo y reúne las dependencias del SDK desde los manifiestos.
Consultar a Raven. Obtiene las versiones actuales y la muestra de obsoletos una vez por ejecución.
Diagnosticar. Compara cada dependencia con el ecosistema e imprime los hallazgos por severidad.

Qué leer después

Primeros pasos: Instala desde npm, inicia sesión y ejecuta tu primer diagnóstico.
Autenticación: Cómo funciona el inicio de sesión y qué se guarda.
Comandos: Cada comando, flag y código de salida.
Hallazgos: Cada código de hallazgo y qué hacer al respecto.
CI: Hacer fallar un build por desfase.
Fixtures: Ejecuta sin conexión con un snapshot guardado.
SDK de TypeScript: Llama a diagnose y migrate desde tu propio código.
Servidor MCP: Permite que los asistentes de IA diagnostiquen un repo.
GitHub Action: Bloquea pull requests con desfase.
Modo de migración: Una guía a partir del snapshot y luego los cambios de versión.
Qué escanea: Formas de manifiesto, carpetas omitidas, rangos de versión.
Fuentes de datos: De dónde sale la información de referencia.
Arquitectura: Núcleo, puertos, adaptadores, CLI.
Limitaciones: Lo que kedgeway no hace.
Preguntas frecuentes: Respuestas cortas.