Muonroi.RuleGen 2.0.0

muonroi-building-block

Muonroi Building Block is the .NET foundation of the Muonroi open-core ecosystem: rule engine, decision tables, governance, tenancy, observability, and the commercial extensions that sit on top of the OSS base.

Install

dotnet add package Muonroi.RuleEngine.Core
dotnet add package Muonroi.RuleEngine.SourceGenerators

Quick Example

Annotate rule logic in normal C#:

[MExtractAsRule("HIGH_VALUE_ORDER", DependsOn = new[] { "CREDIT_SCORE" })]
public RuleResult HighValue(OrderContext context, FactBag facts)
{
    if (context.Amount <= 1000m) return RuleResult.Failure("Below threshold.");
    facts["requiresReview"] = true;
    return RuleResult.Success();
}

Generate the registration and wire the engine:

muonroi-rule extract --source src/Rules --output Generated/Rules
muonroi-rule register --rules Generated/Rules --output Generated/RuleEngineRegistrationExtensions.g.cs

using Muonroi.RuleEngine.Generated;

builder.Services.AddRuleEngine<OrderContext>();
builder.Services.AddGeneratedRules();

Result: the rule enters the DI graph without a handwritten registration block, and muonroi-rule verify can catch dependency and rule-code mistakes before runtime.

Package Families

The boundary rule remains simple:

• OSS packages must not reference commercial packages.
• Commercial packages may reference OSS packages.

See OSS-BOUNDARY.md for the detailed matrix.

What To Read First

• Docs: https://docs.muonroi.com/docs/getting-started/introduction
• Rule engine guide: https://docs.muonroi.com/docs/guides/rule-engine/rule-engine-guide
• Rule source generator deep dive: https://docs.muonroi.com/docs/guides/rule-engine/rule-source-generator
• Decision table guide: https://docs.muonroi.com/docs/guides/rule-engine/decision-table-guide
• Samples index: samples/README.md

Samples

• Quickstart.RuleEngine
• Quickstart.DecisionTable
• FraudDetection
• LoanApproval
• MultiTenantSaaS
• RuleSourceGen

Local Development

dotnet restore Muonroi.BuildingBlock.sln
dotnet build Muonroi.BuildingBlock.sln -c Debug

Useful gates before opening a PR:

pwsh ./scripts/check-modular-boundaries.ps1 -RepoRoot .
dotnet test Muonroi.BuildingBlock.sln -c Debug

Community

• Docs: https://docs.muonroi.com
• Issues: https://github.com/muonroi/muonroi-building-block/issues
• Contributing guide: CONTRIBUTING.md
• Security policy: https://docs.muonroi.com/docs/resources/SECURITY

Discussion templates are prepared under .github/DISCUSSION_TEMPLATE and become active as soon as GitHub Discussions is enabled for the repository.

License

OSS packages are Apache 2.0. Commercial packages are distributed under the Muonroi commercial license and require activation proof in deployed environments.