* feat: implement slots instead of natural language Replace the natural-language projection (`nl`) with engine-owned slot completion: for a cursor position the engine classifies the slot being edited (operand, operator, literal, member access, ...) and returns typed options, literal facts and the expected type, for policies and graphs. - zen-expression: new `slot` module (classification, literals, operators) and a lenient lexer mode for incomplete input; `nl` removed - Intellisense: typed diagnostic codes with arguments, richer inspect for hover, dedicated parser error variants (messages unchanged) - Engine: `Workspace::cursor_scope`, `slot`, `facts`; `rename_from` and `references_from`; editor spans in UTF-16 units; renames reach imported policies, `$nodes` reads, child graphs and output column heads; no `$root` completion in policies - Node bindings: `slot`, `facts`, `cursorScope`, `slotBatch` replace `nl`, `nlTokenize`, `nlEncodeString`, `nlTokenizeBatch` No change to expression evaluation: the VM, compiler, functions and the default lexer path are untouched, and parser error messages keep their text. * fix: harden slot classification, scopes and graph expectations - restore master execution order; slot scopes hide writes of the edited block and its dependents instead of relying on block ranking - token-start editing gated by slot state; operator, list and operand spans no longer splice into neighbouring tokens - interval-aware bracket pairing for half-open and reversed intervals - lenient lexer recovers from unknown characters (slots only) - graph expected type follows switch and pass-through nodes and merges compatible output schemas - sibling inference caps distinct values and analyses lazily - deterministic overload return type display * fix: order policy blocks by entity reads through closures and relationships - record reads for `#.field` in closures so entity fields read through lists become dependencies - link reads through derived lists (filter/map results) to the entity fields they carry and order the list after those fields - evaluate entity blocks on single relationships, and demand entity paths for plain reads through relationships - slot scopes keep the top-level variable when hiding written fields
ZEN Engine
Business logic humans can read and machines can run. One copy of your rules: the owner reads it, every system runs it.
ZEN Engine is a cross-platform, open-source Business Rules Engine (BRE) written in Rust, with native bindings for Node.js, Python, Go, Java, Kotlin and .NET, plus iOS and Android packages. Decisions evaluate in microseconds, run identically on every platform, and are stored as portable JSON. Loading the JSON is up to you: file system, database or service call.
Try it in the free Online Editor with a built-in simulator, or embed the open-source React JDM Editor in your own product.
Rules that read like sentences
Conditions are written the way the business says them, in the ZEN Expression Language. The developer view is one toggle away, and the two can never drift apart: there is only one source of truth, and this engine runs it.
Rules as graphs, or as documents
Model a decision on a visual canvas of decision tables, switches, expressions, functions and reusable sub-decisions. Or write it as a policy document with prose, typed data models and tables. Both compile to the same engine and return the same answers.
To go deeper on the decision model and each node type, see the JDM documentation and the ZEN Expression Language reference.
What's new in 2.0
Version 2.0 is the first stable release of the new engine line:
- Policy documents: model decisions as readable documents with typed data models, expressions, decision tables, match blocks and assertions. Policies compile to the same engine as graphs and return the same answers.
- Workspace analysis: static type checking across policies and graphs. Type flow, exhaustiveness checking, write-conflict detection and precise diagnostics, all available before anything runs.
- Per-column collect: decision table output columns can collect across all matching rows (
tags[]) while the rest of the table stays first-match. - Pre-compiled engine: decisions are parsed and compiled once at load; evaluation is allocation-light and repeat-safe.
- Hardened runtime: out-of-range numbers, arithmetic overflow and malformed inputs return errors or nulls instead of crashing the process.
- Unified bindings: configurable loaders, batch evaluation and consistent error envelopes across Node.js, Python, Go and FFI consumers.
Important
Migrating from 0.x (Rust crates):
arbitrary_precisionis no longer enabled by default in zen-engine, zen-expression, zen-types and zen-tmpl. If you rely on arbitrary-precision number handling, addfeatures = ["arbitrary_precision"]to your dependency. Bindings (Node.js, Python, C, UniFFI) are unaffected, they opt in automatically.
Quickstart
Rust
[dependencies]
zen-engine = "2"
use serde_json::json;
use std::sync::Arc;
use zen_engine::model::DecisionContent;
use zen_engine::DecisionEngine;
async fn evaluate() {
let decision_content: DecisionContent =
serde_json::from_str(include_str!("jdm_graph.json")).unwrap();
let engine = DecisionEngine::default();
let decision = engine.create_decision(Arc::new(decision_content)).unwrap();
let result = decision.evaluate(json!({ "input": 12 }).into()).await;
}
Node.js
npm i @gorules/zen-engine
import { ZenEngine } from '@gorules/zen-engine';
import fs from 'fs/promises';
const content = await fs.readFile('./jdm_graph.json');
const engine = new ZenEngine();
const decision = engine.createDecision(content);
const result = await decision.evaluate({ input: 15 });
Python
pip install zen-engine
import zen
with open("./jdm_graph.json", "r") as f:
content = f.read()
engine = zen.ZenEngine()
decision = engine.create_decision(content)
result = decision.evaluate({"input": 15})
Full guides, including loaders for multi-decision graphs and batch evaluation:
- Node.js - GitHub | Documentation | npmjs
- Python - GitHub | Documentation | pypi
- Go - GitHub | Documentation
- Java / Kotlin - GitHub | Maven Central
- .NET - GitHub | NuGet
- Rust (Core) - GitHub | Documentation | crates.io
The GoRules platform
The engine is open at the core; GoRules is the platform around it. Managed cloud, self-hosted, or embedded with no network hop. SOC 2 Type II.
AI that builds rules, and stays reviewable
An AI copilot and MCP server that edits rules, runs tests and explains decisions. It never deploys. Releases stay with your reviewers.
Promote like a release, run like a binary
A release moves from testing to staging to production untouched. Approvals, instant rollback, and a paper trail for every change.
Prove it before it ships
Scenario suites run on every change, coverage is measured against decision paths, and every answer comes with a replayable trace.
Support matrix
| Arch | Rust | Node.js | Python | Go | Java / Kotlin | .NET |
|---|---|---|---|---|---|---|
| linux-x64-gnu | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| linux-arm64-gnu | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| darwin-x64 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| darwin-arm64 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| win32-x64-msvc | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| linux-x64-musl | ✔️ | ✔️ | ❌ | ❌ | ❌ | ❌ |
| linux-arm64-musl | ✔️ | ✔️ | ❌ | ❌ | ❌ | ❌ |
| linux-s390x | ✔️ | ❌ | ❌ | ❌ | ✔️ | ❌ |
| wasm32 (WASI) | ✔️ | ✔️ | ❌ | ❌ | ❌ | ❌ |
Mobile: Swift (iOS XCFramework) and Android (AAR) packages are published from the same core via UniFFI.
Contribution
The JDM standard is growing and we need to keep tight control over its development and roadmap, as a number of companies use GoRules ZEN Engine and GoRules BRMS. For this reason we can't accept code contributions at this moment, apart from help with documentation and additional tests.