La operación es la unidad
Intención, contrato, juicio, ejecución y recibo.
En esta página
El modelo no cocina: sobre el comal se cocina. El modelo propone; Comal regula la ejecución y deja el recibo de cada vuelta.
La operación es la unidad
Una operación declara nombre, esquema de entrada, efectos, audiencia, superficies y handler. CLI, TUI y modelo proyectan ese registro; no deberían tener ejecutores con permisos distintos para el mismo efecto.
Una petición de alto nivel puede requerir muchas operaciones pequeñas. «Arregla el formulario» no es una autorización universal para cualquier comando.
La casa es el juez
La casa enlaza cada propuesta a un actor del host, valida argumentos y contrato vigente, juzga permisos y conserva un recibo de resultado. No acepta como identidad o aprobación un JSON fabricado por el modelo.
- Intención: el usuario pide un resultado y fija restricciones.
- Propuesta: el modelo solicita una operación con argumentos.
- Juicio: la casa evalúa contrato, actor y límites aplicables.
- Ejecución: el handler entra sólo si fue autorizado.
- Recibo: se registra resultado, hashes y observaciones disponibles.
Qué puede decidir el recibo
serve, repeat y basket describen disposiciones sobre ejecución observada. Repetir requiere inspección y una propuesta nueva: no hay replay automático de una acción incierta ni rollback implícito.
Las herramientas nativas pueden releer una escritura y comparar su hash. Para Bash o un servidor externo, muchos efectos internos permanecen desconocidos. La casa declara ese alcance en lugar de inventar certeza.
Controles que pertenecen al humano
Cambiar modelo, esfuerzo, modo, nombre o login no es una capacidad que el modelo pueda autoasignarse. Esos controles tienen audiencia humana; se omiten del catálogo del LLM y se rechazan si los adivina.
Proyectar a otras superficies
Esta separación permite una interfaz web o una app Electron sobre el mismo núcleo. Habría que extraer coordinación del CLI, exponer solicitudes/eventos y conservar el juicio en el núcleo. Esa interfaz operativa no está implementada por este sitio: aquí sólo aprendes y consultas documentación.
Node aloja Comal. Los proyectos que produce pueden utilizar cualquier lenguaje cuyo entorno esté disponible.
Marca tu lectura para seguir el recorrido.
Ver esta página como Markdown
Fuente editable de esta guía: arquitectura.md. Las páginas de referencia se regeneran desde el inventario auditado.