XperienceCommunity.Sentinel.Core 0.4.5-alpha

XperienceCommunity.Sentinel.Core

Reusable check library powering Sentinel for Xperience by Kentico. Embeddable in any .NET host — CLI, admin module, ASP.NET Core background worker, GitHub Action.

This is the framework-agnostic core of Sentinel for Xperience by Kentico — the health scanner for Xperience by Kentico projects. It ships the primitives everyone else builds on:

• ICheck — a single health check (config smell, outdated NuGet, orphan content item, etc.)
• ScanContext — the state a check reads / writes during a run
• CheckRegistry — the default suite of static and runtime checks
• ScanRunner — orchestrates a full scan and emits a sanitized report
• Reporting — HTML + JSON report writers, stable schema
• Quoting — sanitized payload builder for the sentinel quote flow

Use this package directly when you want to run Sentinel's checks inside your own host — for example, a custom dashboard, a webhook, or a bespoke CI script. For the turn-key experiences, reach for the integration packages instead:

• XperienceCommunity.Sentinel.Module — headless XbyK integration (scheduled task, event log mirror, email digest)
• XperienceCommunity.Sentinel.Admin — admin UI module
• XperienceCommunity.Sentinel — sentinel dotnet global tool for CI / local use

Install

<PackageReference Include="XperienceCommunity.Sentinel.Core" Version="0.4.5-alpha" />

Minimal usage

using XperienceCommunity.Sentinel.Core;

var registry = new CheckRegistry();
var runner = new ScanRunner(registry);

var context = new ScanContext
{
    ProjectPath = @"C:\src\MyXperienceSite",
    // Optional — enables runtime checks (unused content types, stale content, etc.)
    ConnectionString = "Server=.;Database=XbyK;Integrated Security=true"
};

var result = await runner.RunAsync(context);

foreach (var finding in result.Findings)
{
    Console.WriteLine($"{finding.Severity} {finding.RuleId} {finding.Message}");
}

What it checks

The same suite the CLI and embedded integration run — static config / dependency / content-model checks out of the box, plus runtime checks (unused types, orphans, stale content, broken assets) when a connection string is supplied. See the main repo README for the full list and configuration reference.

Supported versions

Targets .NET 9. Check coverage targets Xperience by Kentico 29+ for static checks and XbyK 31.x for runtime checks. KX13 is not supported.

License

MIT © Refined Element