maxim-engine
v1.2.1
Published
A simplistic (for now) rules engine
Downloads
14
Maintainers
Readme
Maxim Engine
Maxim is a simple rule engine, getting better a step at a time.
The engine will recognize when a consequence changes a property in working memory that is referenced by a registered rule. When this happens, it will re-run the rule-set.
It does not (yet) do loop detection so it will re-run the rule-set a defined number of times (default is 10).
The engine lazily evaluates referenced properties in working memory and uses Reflect / Proxy to intercept and record when they change.
Limitations
- no loop detection / conflict resolution
- no optimization of rule re-runs
- probably more I haven't thought of...
Roadmap (tentative)
These will change depending on community engagement, and my own needs.
- ability to name rules
- explore smarter algorithms to execute across the ruleset
- loop detection
- conflict resolution
Usage
Initialize yourself an instance of the MaximEngine
const { MaximEngine } = require('maxim-engine');
let engine = new MaximEngine();
Rules have two components, a condition
and a consequence
. Each component needs a lambda that takes an instance of the engine's Working Memory
A condition
is a lambda that takes an instance of the engine's Working Memory and returns a boolean value that indicates to the engine that the consequence applies.
eg. (wm) => !('message' in wm)
A consequence
is a lambda that mutates the provided working memory (which is actually a copy of the original working memory in order to avoid side-effects).
eg. (wm) => wm.message = "Hello, World!"
So here is an example of a complete rule:
let rule = {
condition: (wm) => !('message' in wm),
consequence: (wm) => wm.message = "Hello, World!"
};
Once you have a set of rules you can register them with the engine. You can provide a single rule or an array of rules.
engine.register(rule);
Once you have loaded your rules into the engine, you can use it as many times as you'd like with different input data.
let result = engine.execute({ message: "Change me!" });
console.log(result.message); // Outputs "Hello, World!"
With a more sophisticated ruleset, if you want to ensure a maximum number of working memory generations (in case you have loops) you can do so like this:
let result = engine.execute({ message: "Change me!" }, 100);
// evaluates a maximum of 100 generations of working memory
Prioritizing Rules
Rules can be prioritized with a property called priority
. Higher integers represent higher priority.
engine.register([
{
priority: 100,
condition: wm => wm.value === 1,
consequence: wm => wm.value = 100
},
{
priority: 1,
condition: wm => wm.value === 1,
consequence: wm => wm.value = 10
}
]);
let result = engine.execute({value: 1});
// { value: 100 }
Distributed Openly, Built Openly
This project is licensed under the very permissive MIT license and Copyright (c) 2018 Stacey Vetzal.
My goal is that the entirety of this system will be built openly via the Twitch platform. While traditionally a game-streaming platform, Twitch offers a remarkable experience for the streamer, and I hope that the archive of streams will be perhaps useful for educational purposes.
You can watch the entirety of Maxim-Engine's construction via the following Twitch collection.