MKTRUE-SYNC(1)mktrue 1.3.1MKTRUE-SYNC(1)
mktrue sync
NOMBRE
mktrue sync — pone el método al día
SINOPSIS
mktrue sync [--write] [--adopt] [--restore]
DESCRIPCIÓN
sync pone al día con este kit los archivos que gestiona el kit, uno a uno, frente al hash guardado cuando se escribió cada uno:
- sin cambios aquí, cambiado en el kit: se actualiza.
- cambiado aquí, sin cambios en el kit: se conserva.
- cambiado en los dos: un conflicto. Cuando el kit aún tiene una versión del archivo, se escribe junto a él, como copia .mktrue-next.
- fijado en .mktrue.json: se omite, y se informa.
- borrado aquí: se informa, y solo vuelve con
--restore. - retirado por el kit, un archivo que ya no genera: se borra con
--writecuando aquí no ha cambiado. Si aquí cambió, es un conflicto sin copia .mktrue-next, porque al kit no le queda versión que escribir.
Es un simulacro salvo con --write. Nunca toca lo que es del repositorio: sus propias secciones de reglas, el estado, las decisiones, los planes, los registros y el código. El archivo de ajustes solo se escribe cuando no hay ninguno.
--adopt toma la versión del kit de archivos que nunca se gestionaron. sync es también la forma de entrar en un repositorio que mktrue no creó: el método sin la plantilla.
OPCIONES
--write- Escribe los cambios en vez de solo listarlos.
--adopt- Toma la versión del kit de archivos que nunca se gestionaron.
--restore- Devuelve un archivo del kit que este repositorio borró.
--target <name>- El agente para el que se crea. Por defecto, claude-code.
--bench <dir>- El kit desde el que se crea. Por defecto, el kit instalado.
--help- Muestra esta pantalla: el uso del comando, sus opciones y sus códigos de salida.
ESTADO DE SALIDA
| 0 | true: se imprimió el plan, o se escribió con --write. |
| 1 | hallazgos: el plan tiene alguno, .mktrue.json no lista ningún gate, o una escritura falló antes de mover nada. |
| 2 | uso: no hay .mktrue.json o no hay banquillo, o .mktrue.json no se puede leer. |
| 4 | hace falta una decisión: un archivo cambió aquí y en el kit. |
EJEMPLOS
El simulacro, en un repositorio que ya está en esta versión del kit.
exit 0
mktrue syncmktrue: sync · kit 1.3.1 → 1.3.1 · dry runmktrue: 0 updates · 0 kept · 0 conflicts · 0 skipped · 0 removedmktrue: true · exit 0
Salida real de mktrue 1.3.1, capturada con NO_COLOR.