Tu primera vuelta

Aprende el ciclo de Comal sin conectar una cuenta. Al terminar habrás iniciado una sesión, visto operaciones con recibos y encontrado cómo reanudarla.

Antes de empezar

Necesitas Node.js 22 o posterior, npm y una copia del proyecto. Comal aloja su núcleo en Node, pero puede trabajar en proyectos de cualquier lenguaje disponible en tu entorno.

npm ci
node bin/comal.mjs --help

Ejecuta estos comandos desde la raíz de Comal. La CLI todavía no se distribuye aquí como un paquete público que puedas instalar por nombre.

1. Prepara un terreno de práctica

mkdir -p /tmp/comal-practica
node bin/comal.mjs --cwd /tmp/comal-practica --demo

--demo usa un guion determinista: no es una respuesta de un modelo y no requiere credenciales. Puede crear su archivo de ejemplo dentro del workspace de práctica. El directorio de --cwd debe existir.

2. Completa una vuelta

Escribe en el composer:

Muestra el ciclo de herramientas

Observa las operaciones, su estado y la respuesta. Después consulta:

/house
/audit

/house muestra ejecución y recibos. /audit verifica lo registrado; ninguna de estas consultas demuestra por sí sola que un encargo arbitrario esté bien resuelto.

3. Guarda el punto de regreso

Sal con /exit. Comal imprime el UUID de la sesión y el comando de reanudación. Conserva ese identificador:

node bin/comal.mjs --cwd /tmp/comal-practica --demo --resume UUID

Sustituye UUID por el valor real. También puedes listar sesiones con node bin/comal.mjs --cwd /tmp/comal-practica sessions.

Comprueba lo aprendido

• Puedes señalar qué se pidió y qué operación se ejecutó.
• Puedes encontrar su recibo sin pedirle al modelo que lo invente.
• Puedes cerrar y reanudar el mismo UUID.

Ahora sigue con Pedir, construir, verificar, o conecta un modelo real.