rust-rule-engine 1.20.1

A blazing-fast Rust rule engine with RETE algorithm, backward chaining inference, and GRL (Grule Rule Language) syntax. Features: forward/backward chaining, pattern matching, unification, O(1) rule indexing, TMS, expression evaluation, method calls, streaming with Redis state backend, watermarking, and custom functions. Production-ready for business rules, expert systems, real-time stream processing, and decision automation.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

# Guides

Step-by-step tutorials and best practices.

---

## 📚 Available Guides

### Integration & Architecture

#### [Backward Chaining RETE Integration](BACKWARD_CHAINING_RETE_INTEGRATION.md)
Combine forward and backward chaining for powerful hybrid reasoning.

**Topics:**
- Integration patterns
- When to use each approach
- Performance considerations
- Real-world examples

**Use when:** Building hybrid reasoning systems

#### [Module Management](MODULE_PARSING_GUIDE.md)
Organize rules into reusable modules.

**Topics:**
- Module structure
- Imports and exports
- Namespace management
- Module best practices

**Use when:** Building large rule sets

### Problem Solving

#### [Troubleshooting](TROUBLESHOOTING.md)
Comprehensive troubleshooting guide for backward chaining.

**Topics:**
- Common errors and solutions
- Debugging techniques
- Performance issues
- Best practices

**Use when:** Encountering problems or errors

### Advanced Topics

#### [Cyclic Import Detection](CYCLIC_IMPORT_DETECTION.md)
Understanding and preventing circular module dependencies.

**Topics:**
- What are cyclic imports
- Detection mechanisms
- Prevention strategies
- Error resolution

**Use when:** Working with complex module structures

#### [Module Refactoring](MODULE_REFACTORING.md)
Strategies for refactoring and organizing modules.

**Topics:**
- Refactoring patterns
- Code organization
- Migration strategies

**Use when:** Improving existing module structure

---

## 🎯 Quick Navigation by Problem

### Common Scenarios

**"My rules aren't firing"**
→ [Troubleshooting - Rules Not Firing](TROUBLESHOOTING.md)

**"I have circular module dependencies"**
→ [Cyclic Import Detection](CYCLIC_IMPORT_DETECTION.md)

**"How do I combine forward and backward chaining?"**
→ [RETE Integration](BACKWARD_CHAINING_RETE_INTEGRATION.md)

**"How should I organize my rules?"**
→ [Module Management](MODULE_PARSING_GUIDE.md)

**"I need to refactor my modules"**
→ [Module Refactoring](MODULE_REFACTORING.md)

---

## 📖 By Experience Level

### Beginners
1. Start with [Getting Started](../getting-started/QUICK_START.md)
2. Read [Troubleshooting](TROUBLESHOOTING.md) for common issues
3. Learn [Module Management](MODULE_PARSING_GUIDE.md) basics

### Intermediate
1. Master [RETE Integration](BACKWARD_CHAINING_RETE_INTEGRATION.md)
2. Understand [Cyclic Imports](CYCLIC_IMPORT_DETECTION.md)
3. Apply [Best Practices](TROUBLESHOOTING.md#best-practices)

### Advanced
1. Optimize with [Module Refactoring](MODULE_REFACTORING.md)
2. Build hybrid systems with [RETE Integration](BACKWARD_CHAINING_RETE_INTEGRATION.md)
3. Create complex architectures

---

## 🔗 Related Documentation

- **[Getting Started](../getting-started/QUICK_START.md)** - Quick start guide
- **[API Reference](../api-reference/API_REFERENCE.md)** - Complete API
- **[Examples](../examples/)** - Real-world examples

---

## 💡 Contributing

Have a guide idea? Found an issue? We welcome contributions!

See [CONTRIBUTING.md](../../CONTRIBUTING.md) for details.

---

## Navigation

📚 **[Documentation Home](../README.md)** | 📖 **[Getting Started](../getting-started/QUICK_START.md)**