Cerbi.Governance.Core 1.0.2

Cerbi.Governance.Core

📄 What is Cerbi.Governance.Core?

Cerbi.Governance.Core is the shared runtime contract used across the Cerbi ecosystem for both build-time analyzers and runtime log governance enforcement. It includes:

• JSON schema models (LogProfile, CerbiGovernance, etc.)
• Plugin interfaces (ICustomGovernancePlugin)
• Governance result structures (GovernanceViolation, GovernanceValidationResult)
• Attribute to wire up governance configs ([assembly: CerbiGovernanceConfig(...)])

This library is designed to be lightweight, portable, and reusable across CerbiStream, governance analyzers, plugin systems, and runtime tools.

✨ Primary Use Cases

🚀 Quick Start

# Add to your CerbiStream app or analyzer
$ dotnet add package Cerbi.Governance.Core

Then, in your code:

using Cerbi.Governance;

[assembly: CerbiGovernanceConfig("cerbi_governance.json")]

💡 Common Types

✏️ Governance Profile Structure

public class LogProfile
{
    public Dictionary<string, string> FieldSeverities { get; set; }
    public Dictionary<string, List<string>> FieldEnums { get; set; }
    public Dictionary<string, string> FieldDescriptions { get; set; }
    public bool RequireTopic { get; set; }
    public List<string> AllowedTopics { get; set; }
    public string DefaultTopic { get; set; }
    public EncryptionSettings EncryptionSettings { get; set; }
    public bool? AllowRelax { get; set; }
}

⚡ Plugin Interface

public interface ICustomGovernancePlugin
{
    string Id { get; }
    string Description { get; }
    PluginCategory Category { get; }
    string[] AppliesToProfiles { get; }

    bool Validate(string profileName, Dictionary<string, object> logData, out List<string> failures, out int impactScore);
}

⚠️ Violation Result

public class GovernanceViolation
{
    public string RuleId { get; set; }
    public string Message { get; set; }
    public string Field { get; set; }
    public string Severity { get; set; } = "Error";
}

🔧 Recommended Use

⚖️ License

• License: MIT
• Copyright: © Cerbi LLC 2025

🔗 Links

• GitHub: https://github.com/Zeroshi/CerbiStream
• NuGet: https://nuget.org/packages/Cerbi.Governance.Core
• Website: https://cerbi.systems

Structured • Secure • Compliant

Cerbi.Governance.Core powers build-time and runtime governance for structured logging apps.