JDM Standard

JDM (JSON Decision Model) is the file format used by GoRules to represent decision graphs. It’s a human-readable JSON structure that captures nodes, edges, and configuration in a portable format.

Why JDM?

Benefit	Description
Portable	Works across all GoRules SDKs and tools
Version controllable	Store in Git alongside your code
Human readable	Review and diff changes easily
Extensible	Add custom metadata without breaking compatibility

File structure

A JDM file contains two sections:

{
  "nodes": [...],
  "edges": [...]
}

Nodes

Each node represents a processing step in the decision:

{
  "id": "node-1",
  "type": "decisionTableNode",
  "name": "Customer Discount",
  "position": { "x": 200, "y": 100 },
  "content": {
    // Node-specific configuration
  }
}

Edges

Edges define connections between nodes:

{
  "id": "edge-1",
  "sourceId": "input-node",
  "targetId": "decision-table-node",
  "sourceHandle": "output"
}

Additional fields

The engine ignores unknown top-level fields, so tools can attach their own metadata without breaking evaluation. Only nodes and edges are part of the format.

Loading JDM files

Load and evaluate JDM files using any GoRules SDK:

Validating structure

The @gorules/jdm-editor package exports a Zod schema for validating JDM files:

import { decisionModelSchema } from '@gorules/jdm-editor/dist/schema';

const content = JSON.parse(await file.text());
const result = decisionModelSchema.safeParse(content);

if (!result.success) {
  console.error('Invalid JDM:', result.error.issues);
}

Version control best practices

File organization

rules

pricing

customer-discount.json

volume-discount.json

eligibility

loan-qualification.json

README.md

Meaningful commits

git commit -m "Add enterprise tier discount (20% for orders > $10k)"

Review diffs

JDM’s JSON format makes diffs readable:

  "rules": [
    {
      "_id": "rule-1",
      "i1": "\"gold\"",
-     "o1": "0.15"
+     "o1": "0.20"
    }
  ]

Exporting from BRMS

The GoRules BRMS exports decisions in JDM format:

Open the decision in BRMS
Click Export in the toolbar
Choose JSON Decision Model (.json)
Save to your repository

Schema reference

The complete JSON Schema for JDM files is available in the zen repository.

Overview

AI & Tools

Deployment

CI/CD Integrations

Platform Guides

SDKs

Big Data

JDM

Why JDM?

File structure

Nodes

Edges

Additional fields

Loading JDM files

Validating structure

Version control best practices

File organization

Meaningful commits

Review diffs

Exporting from BRMS

Schema reference

​Why JDM?

​File structure

​Nodes

​Edges

​Additional fields

​Loading JDM files

​Validating structure

​Version control best practices

​File organization

​Meaningful commits

​Review diffs

​Exporting from BRMS

​Schema reference

Why JDM?

File structure

Nodes

Edges

Additional fields

Loading JDM files

Validating structure

Version control best practices

File organization

Meaningful commits

Review diffs

Exporting from BRMS

Schema reference