Cirreum.Kernel 1.0.0

Cirreum.Kernel

Cirreum's foundational abstractions — cross-host primitives every Cirreum app builds on.

Overview

Cirreum.Kernel is the foundational base of the Cirreum framework. It contains the cross-host abstractions, contracts, value types, and sentinels that every Cirreum package consumes — directly or transitively — regardless of host (Server, WebAssembly, Serverless).

Kernel is dependency-light and deliberately small. It defines:

• Identity & security primitives — IUserState, IUserStateAccessor, IUserSession, UserStateBase, IApplicationUser, IApplicationUserResolver, IOwnedApplicationUser, AnonymousUser, AuthenticationBoundary, ClaimsHelper
• User profile model — UserProfile, UserProfileAddress, UserProfileMembership, UserProfileOrganization, IUserProfileEnricher
• Authentication events & keys — AuthenticationContextKeys and the IAuthenticationEvent family (IAuthenticationEventPublisher, IAuthenticationEventHandler, plus the CredentialRevoked / SessionTerminationRequested / UserAccountDisabled / GrantsInvalidated records)
• Conductor markers — INotification, INotificationHandler (the Result-free notification primitives; the rest of the Conductor surface lives in Cirreum.Common)
• Message registry — IMessageRegistry, MessageDefinition, MessageProperty, MessageVersionAttribute, MessageRegistryBase, MessageScanner
• Framework bootstrap — IDomainApplicationBuilder, DomainContext, DomainServicesBuilder, AssemblyScanner, IDomainContextInitializer, DomainRuntimeType, DomainFeatureResolver, IDomainObject
• Environment, time & enums — IDomainEnvironment, IDateTimeClock, Timing, IdentityProviderType
• State foundation — IApplicationState (the marker interface other state contracts extend)
• Health, diagnostics & utilities — IStartedStatus, CirreumTelemetry, InternetDomainValidator, MissingResource, plus extension methods and SmartFormat command sources

Other Cirreum packages — Common, Shared, the host infrastructure, and the runtime — build on Kernel.

Where it fits

Cirreum.Kernel              ← this package (alongside Cirreum.Result, Cirreum.Exceptions)
Cirreum.Common              — cross-host contracts (Conductor, the Authorization pillar, Invocation)
Cirreum.Shared              — default implementations (also Cirreum.AuthenticationProvider, ...)
Cirreum.Services.{Host}     — host infrastructure (Cirreum.Authentication.{Scheme}, ...)
Cirreum.Runtime.{Host}      — composition (Cirreum.Runtime.{Track}Provider)
Cirreum.Runtime.{Track}     — app-facing umbrellas

Kernel does NOT reference its foundation peers (Cirreum.Result, Cirreum.Exceptions). Other Cirreum packages consume Kernel and those peers as needed.

Contribution Guidelines

1. Be conservative with new abstractions
   The API surface must remain stable and meaningful — Kernel sits at the foundation; changes ripple through every Cirreum package.

2. Limit dependency expansion
   Only add foundational, version-stable dependencies. Kernel must remain dependency-light to qualify as the framework's base.

3. Favor additive, non-breaking changes
   Breaking changes in Kernel cascade through every dependent package and every Cirreum app. Major version bumps are rare.

4. Include thorough unit tests
   All primitives should be independently testable.

5. Document architectural decisions
   Context and reasoning should be clear for future maintainers.

6. Follow .NET conventions
   Use established patterns from Microsoft.Extensions.* libraries.

Versioning

Cirreum.Kernel follows Semantic Versioning:

• Major — Breaking API changes
• Minor — New features, backward compatible
• Patch — Bug fixes, backward compatible

Given its foundational role, major version bumps are rare and carefully considered.

License

This project is licensed under the MIT License — see the LICENSE file for details.

Cirreum Foundation Framework
Layered simplicity for modern .NET