¿Qué hace jsonlogic?
Una habilidad para trabajar con JsonLogic.
JsonLogic es un formato pequeño y portátil para expresar lógica condicional como JSON.
El estándar JsonLogic es el formato universal de reglas y define su semántica. Una regla en este nivel es independiente del lenguaje. Consulta references/jsonlogic.md y references/operations.md.
Una librería específica es el código que ejecuta JsonLogic en un lenguaje particular, como json-logic-js para JavaScript o json-logic-rb para Ruby. Las librerías pueden diferir en las operaciones que soportan, así como en la forma de su API y el manejo de errores.
Ejecutar JsonLogic
Librería
Si se nombra una implementación específica, como json-logic-js, usa esa implementación exacta. Un nombre de lenguaje solo, como "en Python", significa usar la librería para ese lenguaje de references/libraries.md. Si no se nombra ni librería ni lenguaje, por defecto usa scripts/jsonlogic.rb.
Soporte
Una regla puede ser JsonLogic válida y aun así no ser soportada por la librería seleccionada o su versión actual. Señala las operaciones no soportadas. Nunca reescribas una regla JsonLogic válida solo porque una librería no pueda ejecutarla. Di en qué nivel está la limitación y ofrece las opciones reales:
- una operación personalizada
- una librería diferente si la operación no es soportada en la implementación específica
- cambio de lógica
Artefacto de Playground
Siempre que haya una regla concreta (creada, explicada, corregida o ejecutada), renderízala en vivo en lugar de solo describirla en texto: siembra assets/playground.html con esa regla y datos, luego publícala con la herramienta Artifact. Esto se ejecuta bajo la cuenta de quien haya instalado la habilidad: cada llamada de publicación crea el artefacto bajo la propia cuenta de esa persona, por lo que funciona igual para cada instalador sin necesidad de compartir. El artefacto es privado por defecto, y publicar aquí solo actualiza la misma URL, por lo que no hay una decisión separada que verificar cada vez.
Dos archivos, uno estático y uno con plantilla: assets/jsonlogic-core.js es el intérprete de JsonLogic — nunca cambia entre invocaciones, así que publícalo una vez por conversación (a través del parámetro files de la herramienta Artifact) y nunca más. assets/playground.html es la página delgada con los marcadores de posición a continuación; es el único que se vuelve a plantillar y republicar en cada cambio.
- Lee
assets/playground.html. Es una página de diseño fijo (regla, resultado en vivo, datos) — nunca edites a mano su CSS/diseño; solo los marcadores de posición a continuación cambian por invocación. - Reemplaza
__INITIAL_RULE__y__INITIAL_DATA__con los objetos de regla y datos, cada uno como un literal JS/JSON (la salida deJSON.stringify(...), válido para insertar tal cual). Aún no hay regla concreta → deja ambos intactos, la plantilla recurre a un valor predeterminado integrado. - Reemplaza
__CURRENT_LANG_MODE__con"ruby"cuando el lenguaje objetivo sea Ruby, de lo contrario"jsonlogic"(todos los demás lenguajes mostrados aquí siguen las reglas de verdadero/falso propias de JsonLogic; solo Ruby se desvía). Aún no se ha decidido el lenguaje → déjalo intacto, recurre a"jsonlogic". - Reemplaza
__VERIFY_LIB_LABEL__con la misma librería Ejecutar JsonLogic → Librería (arriba) resuelta para esta tarea — esto es lo que el botón "Verificar en chat" de la página nombra al pedir confirmación contra la implementación real, por lo que debe coincidir, no recurrir a Ruby solo porque es el valor predeterminado de este archivo:- Ruby →
"json-logic-rb (scripts/jsonlogic.rb)" - JavaScript / TypeScript →
"json-logic-js" - Python →
"maykin-json-logic-py" - Java →
"json-logic-java" - PHP →
"json-logic-php (jwadhams/json-logic-php)" - Go →
"diegoholiveira/jsonlogic" - C# / .NET →
"JsonLogic (json-everything)" - Cualquier otro lenguaje de references/libraries.md → el nombre de esa librería tal como se indica allí.
Aún no se ha decidido lenguaje/librería → déjalo intacto, recurre al valor predeterminado de Ruby
"json-logic-rb (scripts/jsonlogic.rb)", que coincide con el valor predeterminado de esta habilidad.
- Ruby →
- Escribe el resultado en un archivo de trabajo y publícalo — la primera vez en una conversación: herramienta Artifact,
action:"publish", la ruta de ese archivo,title:"JSON Logic Playground",icon:"code", másfiles:{"jsonlogic-core.js":"assets/jsonlogic-core.js"}para que el intérprete se envíe junto con él sin modificaciones. - Cuando la regla, los datos o el lenguaje cambien más tarde en la misma conversación, repite los pasos 1–4 con los nuevos valores y publica nuevamente con la misma ruta de archivo y la misma
url— pero omitefilesesta vez, ya quejsonlogic-core.jsnunca cambia y un archivo omitido se conserva tal cual. Esto actualiza el mismo artefacto en su lugar en lugar de crear uno nuevo.
Salta esto para solicitudes que nunca producen una regla concreta (por ejemplo, "¿qué hace missing?").
El usuario puede editar la regla/los datos directamente en el artefacto para probar cosas — ese es el punto, se recalcula en vivo. Nunca vuelvas a publicar sobre esas ediciones manuales. Solo vuelve a publicar cuando el usuario solicite una regla/condición nueva o cambiada en el chat.
Escribir JsonLogic
Paso 1: Obtener la forma de los datos
Pregunta siempre cómo obtener los nombres de los campos de los datos antes de crear una nueva regla. Presenta esto como una opción. Usa el mecanismo de preguntas estructuradas del cliente, como botones o un selector, cuando esté disponible. De lo contrario, presenta las opciones como texto plano.
Pregunta: "¿Cómo debería obtener los nombres de los campos de tus datos?". Ofrece tres opciones:
- Opción Esquema — "Pegaré un esquema — JSON Schema, OpenAPI, cualquier formato."
- Opción Datos de ejemplo — "Pegaré un ejemplo JSON real."
- Opción Solo adivinar — "Inferir los nombres de los campos a partir de mi descripción."
El diálogo solo elige el método. La respuesta real aún llega como un mensaje de seguimiento normal, no dentro del diálogo mismo.
Paso 2: Construir la expresión
Escribe la regla usando los nombres de los campos del Paso 1.
Antes de escribir una nueva regla, consulta references/operations.md para la lista completa de operaciones soportadas y examples/ para patrones resueltos. Para casos de prueba reales de operadores específicos, consulta references/tests/.
Personalización
No esperes que JsonLogic incluya todas las operaciones especializadas. Es intencionalmente pequeño y no es un lenguaje de programación. Nunca hará todo. Sin embargo, JsonLogic admite extensiones. Antes de recurrir a una solución personalizada, mira si puedes expresar tu lógica usando las operaciones soportadas (incorporadas). A menudo, un simple cambio de perspectiva es todo lo que necesitas para hacer el trabajo con lo que ya existe.
Paso 3: Explicar qué hace
Cubre:
- el requisito que se está codificando
- las operaciones utilizadas y qué hace cada una
- la forma de entrada esperada
- lo que devuelve la regla
- casos extremos que vale la pena señalar (campos faltantes, coerción de tipos, arreglos vacíos)
Omite elementos que no apliquen.
Información faltante
Si la condición del negocio no está clara – debes preguntar qué debería verificar la regla, pero no preguntes sobre cosas que ya puedas resolver a partir del contexto.
Validar JsonLogic
Verificar la forma contra references/jsonlogic.md, references/operations.md, o scripts/validate_skill.rb solo confirma que la regla tiene la forma de JsonLogic.
La validación real significa escribir casos de prueba y ejecutarlos a través de scripts/jsonlogic.rb. Consulta references/testing.md para saber cómo elegirlos. Cubre el caso normal y el límite, pero enfócate especialmente en casos extremos: campos faltantes, arreglos vacíos, tipos inesperados. Una regla sin casos de prueba no es segura de entregar — no hay forma de garantizar que se comporta como se espera.
Para los operadores individuales que usa una regla, consulta primero references/tests/ — casos de prueba reales aguas arriba tanto para la especificación central (core.json) como para las extensiones de la comunidad (community/), agrupados localmente. Reutiliza un caso coincidente como verificación de cordura antes de escribir nuevos desde cero; estos prueban los operadores de forma aislada, no la lógica de negocio real de la regla, por lo que aún debes agregar casos específicos de la regla además.
Depurar JsonLogic
Paso 1: Reproducirlo
Usa Ejecutar JsonLogic con la regla y los datos según lo informado.
Ve la salida real tú mismo antes de diagnosticar cualquier cosa.
Paso 2: Encontrar la causa real
Comienza con la causa real, no solo el síntoma — culpables comunes: coerción de tipos, campos faltantes, mal uso de operadores.
Paso 3: Corregir y verificar
Proporciona la regla corregida, luego vuelve a ejecutar el Paso 1 con la corrección para confirmar que la nueva salida es correcta. Si la corrección necesita ser devuelta como código ejecutable, continúa con Ejecutar JsonLogic a continuación.
Después de cualquier
Verificar ejecución
Consulta Ejecutar JsonLogic arriba para ejecutar realmente la regla. Si aún no hay un ejemplo de datos a mano, crea uno representativo primero. La verificación necesita una entrada real para ejecutarse, no solo una descripción de lo que la regla debería hacer.
Señalar preocupaciones
No afirmes que JsonLogic es "seguro" solo porque es JSON.
Archivos de referencia
Lee estos según sea necesario en lugar de cargar todo por adelantado:
- references/jsonlogic.md — semántica central: veracidad, coerción de tipos, resolución de rutas
var, cómo se comportan los datos faltantes, qué significa "compatible". - references/operations.md — cada operación estándar: sintaxis y notas de comportamiento que vale la pena conocer (cortocircuito, comparaciones de tres argumentos,
current/accumulatordereduce, etc.). - references/libraries.md — el panorama de librerías en todos los lenguajes: qué se encontró, qué se verificó, qué no. Léelo antes de escribir cualquier código específico del lenguaje, incluso para lenguajes no listados — verifica primero allí en lugar de asumir que no existe ninguna.
- references/testing.md — cómo verificar una regla o implementación, y cómo ser honesto sobre lo que significa "verificado" en una respuesta determinada.
- references/tests/ — casos de prueba aguas arriba agrupados (especificación central + extensiones de la comunidad) para validar operadores individuales.
- examples/ — ejemplos resueltos: