Referencia
Documentación
Cómo medir un proyecto y leer una corrida, los spells, los resultados y el puntaje, la configuración, CI, agentes y cada comando de kalku.
Para empezar
- Instalación
- Instala kalku con Homebrew, desde un release o desde el código fuente.
- Medir un proyecto
- La primera corrida, sin configurar nada, y cómo dejar kalku instalado en un proyecto con kalku init.
- Qué te dice una corrida
- Cómo leer el reporte: los sobrevivientes primero, el puntaje después, y los cuatro formatos de salida.
- Configuración
- El archivo .kalku.toml, la carpeta .kalku/ y qué significa cada clave.
Conceptos
- Cómo funciona
- Las cuatro etapas de una corrida: línea base, plan, cast y reporte, y por qué los workers calientes son el punto.
- Spells
- Los tipos de defecto que lanza kalku, qué simula cada uno y qué forma toman en cada lenguaje.
- Resultados y puntaje
- En qué puede terminar un cast, cuáles resultados entran al puntaje y cuáles se reportan aparte.
- Mutantes equivalentes
- Qué hacer con un wekufe que ningún test puede matar: el archivo .kalku/equivalent y por qué un agente solo puede proponer.
En tu flujo de trabajo
- En CI
- Controla un pull request por los hoyos que él introdujo con --since, y el puntaje global con una corrida nocturna.
- Para agentes de código
- El ciclo para el que está hecho kalku: encontrar un sobreviviente, escribir un test, volver a lanzar y repetir.
- Servidor MCP
- kalku mcp sirve las cuatro herramientas para agentes por stdio: cómo instalarlo en tu host y qué hace cada una.
- Mantenlo caliente
- kalku serve conserva los kalku con los que se midió un proyecto, para que la siguiente corrida lance sobre uno caliente.
Comandos
- kalku run
- Lanza wekufe sobre unos archivos y reporta los sobrevivientes.
- kalku cast
- Vuelve a lanzar un wekufe después de escribir un test, para saber si ya murió.
- kalku show
- Un wekufe completo: site, diff, tests que lo cubren, pista e historia.
- kalku init
- Deja kalku en un proyecto: detecta el lenguaje y escribe .kalku.toml y .kalku/summon.
- kalku info
- Lo que kalku sabe de spells, resultados, formatos y agentes, documentado desde el propio binario.
- kalku propose-equivalent
- Propone un wekufe como equivalente, con su razón; kalku accept y kalku reject son la respuesta de una persona.
Referencia
- Lenguajes
- Los lenguajes que kalku mide hoy y cómo trabaja el kalku de cada uno.
- Qué funciona hoy
- kalku está en pre-alpha: qué piezas están hechas y cuáles todavía no.
- El elenco
- Qué significan kalku, wekufe, kalkutun y reni, de dónde vienen y qué nombra cada palabra en la herramienta.