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.