AsiBackbone.Core
7.5.3
See the version list below for details.
dotnet add package AsiBackbone.Core --version 7.5.3
NuGet\Install-Package AsiBackbone.Core -Version 7.5.3
<PackageReference Include="AsiBackbone.Core" Version="7.5.3" />
<PackageVersion Include="AsiBackbone.Core" Version="7.5.3" />
<PackageReference Include="AsiBackbone.Core" />
paket add AsiBackbone.Core --version 7.5.3
#r "nuget: AsiBackbone.Core, 7.5.3"
#:package AsiBackbone.Core@7.5.3
#addin nuget:?package=AsiBackbone.Core&version=7.5.3
#tool nuget:?package=AsiBackbone.Core&version=7.5.3

AsiBackbone
7.5.3is the current stable release onmain.
7.5.3improves package discovery, evaluation guidance, terminology validation, visual identity, and repository tooling while preserving public APIs and durable contracts. See the 7.5.3 release notes; consumers moving from6.xmust still follow the 6.x to 7.0 upgrade guide.
A governance framework for accountable .NET decision flow.
AI may provide the intellect. AsiBackbone provides the accountable spine.
AsiBackbone is the implementation package family for Accountable Systems Infrastructure (stable 7.5.x).
Documentation ownership
AsiBackbone/AsiBackbone is the source of truth for the concrete product: package installation and configuration, public APIs and type behavior, runtime semantics, integration boundaries, security posture, operations, compatibility, releases, and maintainer evidence.
For organization-level concepts, architecture education, terminology lineage, tutorials, comparisons, tradeoffs, labs, and general governed-execution teaching, use AsiBackbone Learning and its source repository as the canonical educational source. Learning does not define or override released AsiBackbone package, API, configuration, or runtime behavior.
See the cross-repository documentation ownership contract for the full routing matrix.
The practical problem
Most software can tell you what happened. Far less can show that an action was evaluated before it executed: which rules shaped the decision, which policy version applied, whether acknowledgment was required, how follow-on authority was scoped, and where the host took responsibility for execution.
AsiBackbone is a .NET package family for that decision boundary. It helps a host application build safe policy context, evaluate constraints, return a structured decision, preserve a decision receipt, optionally scope continuation, and then let the host decide whether and how to execute.
Is it a good fit? Consider AsiBackbone when a consequential host-owned action needs policy provenance, acknowledgment, scoped continuation authority, or durable decision evidence. Prefer ordinary framework authorization, application services, and logs when the action is low risk and those simpler boundaries already provide the evidence you need. See Adoption and Target Use Cases for the detailed product-fit and simpler-design guidance.
Five-minute evaluator path
Want to see one policy-as-code decision allow an operation and block another before you read about the package family? With .NET SDK 10.0.400 or a later 10.0.4xx patch installed (pinned in global.json):
git clone https://github.com/AsiBackbone/AsiBackbone.git
cd AsiBackbone
dotnet run samples/FiveMinuteEvaluator/evaluate.cs
The single-file app restores the published AsiBackbone.Core package, registers one host-owned rule, and evaluates the same orders.approve request for two regions. The output looks like this (receipt IDs omitted):
orders.approve in US-LA
Outcome: Allowed
Reasons: (none)
Host executed: yes
orders.approve in EU-DE
Outcome: Denied
Reasons: orders.region.not-allowed
Host executed: no
Host executions: 1 of 2. The blocked request never reached host code.
Look for one thing: AsiBackbone returns a decision and a decision receipt, and the host's own code runs only when decision.CanProceed is true. The evaluator uses one package and no web host, database, or signing. It is a way to evaluate the approach, not a starting point for adoption. When you're ready to adopt, use First 15 Minutes: Standard API Gating.
If something in this path was unclear or failed, ask in Q&A.
Implementation-first mental model
A normal API adoption path looks like this:
HTTP request
-> host builds safe evaluation context
-> host-owned rules evaluate the request
-> AsiBackbone returns a GovernanceDecision
-> host writes a decision receipt
-> host continues only when decision.CanProceed is true
Use plain engineering translations first:
| Term | Practical meaning |
|---|---|
| Policy decision pipeline | Rules evaluate request facts and return a structured decision. |
| Decision receipt | Record of a decision, its outcome, and its reasons. |
| Acknowledgment | Confirmation before a risky operation. |
| Capability grant | Short-lived scoped permission. |
| Outbox | Durable records awaiting reliable delivery. |
| OpenTelemetry projection | Optional traces/metrics projection after local records exist. |
| Host-owned execution | The application code that performs or refuses the protected operation. |
First code path
The snippet below is an intentionally small README slice, not a complete Program.cs. It shows the primary governance path: build safe context, evaluate policy, write decision receipt, and let the host execute only after the decision allows it. The full compile-ready walkthrough lives in First 15 Minutes: Standard API Gating.
Note: it is recommended in production environments that reason codes stay in decision receipt rather than client responses
// Registration: Core evaluator + one host-owned rule + local in-memory decision receipt sink.
builder.Services.AddAsiBackboneAspNetCore();
builder.Services.AddSingleton<InMemoryAuditLedger>();
builder.Services.AddSingleton<IDecisionReceiptSink>(sp =>
sp.GetRequiredService<InMemoryAuditLedger>());
builder.Services.AddSingleton<IGovernanceConstraint<GovernanceEvaluationContext>, AllowedRegionConstraint>();
builder.Services.AddSingleton<IGovernancePolicyEvaluator<GovernanceEvaluationContext>>(sp =>
DefaultGovernancePolicyEvaluator.CreateBuilder<GovernanceEvaluationContext>()
.AddConstraints(sp.GetServices<IGovernanceConstraint<GovernanceEvaluationContext>>())
.WithOptions(new GovernancePolicyOptions())
.Build());
app.MapPost("/api/orders/{region}/approve", async (
string region,
HttpContext httpContext,
IGovernancePolicyEvaluator<GovernanceEvaluationContext> evaluator,
IDecisionReceiptSink auditSink,
CancellationToken cancellationToken) =>
{
var metadata = new Dictionary<string, string>(StringComparer.Ordinal)
{
["operation"] = "orders.approve",
["region"] = region,
["risk"] = "routine-api-write"
};
var context = new GovernanceEvaluationContext(
correlationId: httpContext.TraceIdentifier,
policyVersion: "policy-v1",
policyHash: "policy-hash-v1",
metadata: metadata);
GovernanceDecision decision = await evaluator.EvaluateAsync(context, cancellationToken);
DecisionReceipt receipt = DecisionReceipt.FromDecision(
GovernanceActorContext.Human("example-user", "Example User"),
operationName: "orders.approve",
decision,
metadata: context.Metadata);
await auditSink.WriteAsync(receipt, cancellationToken);
if (!decision.CanProceed)
{
return Results.Json(new
{
allowed = false,
decision = decision.Outcome.ToString(),
decision.ReasonCodes,
auditEventId = receipt.EventId
}, statusCode: StatusCodes.Status403Forbidden);
}
// Host-owned execution starts here. AsiBackbone does not approve the order itself.
return Results.Ok(new
{
allowed = true,
message = "Host order approval would run after this governance decision.",
auditEventId = receipt.EventId
});
});
The 4.x evaluator defaults are intentionally fail-closed for governed surfaces: empty policy structures deny, eligible ordinary constraint exceptions deny with asibackbone.policy.constraint_exception, and threat-contributor exceptions deny. Set TreatConstraintExceptionAsDenial = false only when a host intentionally wants fail-fast exception propagation through its own exception, transaction, retry, telemetry, or incident-response boundary.
For production-style hosts, add durable audit/outbox persistence, signing or verification, DLP/classification, provider emission, and operational monitoring only where the host has explicitly chosen and configured those boundaries.
Package family
Stable 7.x package family. The current release is 7.5.3.
7.5.3 improves package discovery metadata, adds a five-minute evaluator,
aligns current terminology and release documentation, and refreshes visual
identity and repository tooling without changing public APIs, durable
contracts, declared runtime dependency minimums, or runtime decision behavior. The
7.5.0 release added compatible Core context and decision-copy APIs for request
trace correlation. The 7.4 minor
release added production public-key signature verification and durable EF Core
capability-grant replay protection, building on the signed capability grants
introduced in 7.3. Package IDs, the net10.0 target, canonical wire values,
and binary assembly identity 7.0.0.0 are unchanged.
Consumers upgrading from 6.x must follow the 6.x to 7.0 upgrade guide. Hosts must preserve actor identity across both acknowledgment-challenge legs and remap persisted numeric DLP enum values.
Runtime decision-receipt signing remains provider-neutral through AsiBackbone.Signing.ManagedKey. AsiBackbone does not ship first-party Azure Key Vault, AWS KMS, GCP Cloud KMS, HSM, certificate-store, enterprise KMS, or production-style signing sample-host implementations. Future Event Hubs, Purview, gateway, robotics, immutable-storage, or other non-signing provider packages are not part of the stable contract unless separately reviewed and released.
Supported target framework
Stable 7.x packages intentionally target net10.0. Consumers should plan on a .NET 10 SDK/runtime or later for the current package line.
The project is not multi-targeting .NET 8 for 7.x. That is an explicit adoption decision, not a defect workaround. The current package family uses a single repository-wide TargetFramework of net10.0, the EF Core integration is aligned with centrally managed EF Core 10.0.x dependencies, and backporting the full package, analyzer, template, CI, packaging, and smoke-test surface would add compatibility overhead for a short-lived adoption window.
If meaningful external consumer demand appears, additional TFM support can be reconsidered in a later release with CI, packaging validation, analyzer compatibility, template smoke tests, and documentation updated together. See the Target Framework Support Decision Record.
Choose your path
Use the organization as one connected path; each repository has a distinct job:
| If you want to... | Use | Role |
|---|---|---|
| Learn the pattern | AsiBackbone Learning | Concepts, tutorials, labs, comparisons, and tradeoffs, including when the pattern is unnecessary. Needs no AsiBackbone package. |
| Start a secure application | NetCoreApplicationTemplate | A secure-by-default ASP.NET Core application baseline to evaluate or adapt, with or without AsiBackbone. |
| See the pieces running together | ReferenceApplication | A runnable integration specimen that builds on NetCoreApplicationTemplate and adds AsiBackbone governance (stable 1.x). |
| Adopt the packages | This repository | Package behavior, APIs, compatibility, and the implementation-first path. Install only the AsiBackbone.* packages your host needs, and validate one low-risk governed operation before expanding. |
Already evaluating or using the project? See the public adopter registry and use its report form to share permission-based adoption evidence or feedback.
Start here
For implementation-first adoption:
- Implementation-First Adoption Path — plain engineering translations and the recommended first reading path.
- First 15 Minutes: Standard API Gating
- AddAsiBackbone Builder Facade
- dotnet new Templates
- Target Framework Support Decision Record
- Reference Deployment: Plain ASP.NET Core Host Evidence
- Testing Harness
- Strict Governance Profile
- Threat Model Contributors
- Project Boundaries and Non-Claims
- Terminology Map
- Progressive Adoption Ladder
- Production Managed-Key Integration Guide
For optional conceptual background:
- Intent to Execution: An Accountability Pattern
- Core Governance Flow Diagrams
- ASI Backbone Concept Synopsis
- Acknowledgment Workflow
- Core Domain Language
- Host-Owned Execution Enforcement
The full, categorized documentation set lives at the documentation site.
Current status
The current stable release is 7.5.3. It improves package discovery metadata, adds a five-minute evaluator, aligns current terminology and release documentation, and refreshes visual identity and repository tooling while preserving public APIs, durable schemas, canonical wire values, package IDs, declared runtime dependency minimums, the net10.0 target, and runtime decision behavior.
Managed assemblies retain binary identity 7.0.0.0 throughout the compatible 7.x line.
The stable API contract is documented in API Compatibility and SemVer.
The release is described in 7.5.3 Release Notes; the preceding dependency-maintenance patch is described in 7.5.2 Release Notes.
Consumer verification evidence is recorded in the 7.5.3 Consumer Verification Guide.
Consumers moving from the previous stable line must follow the 6.x to 7.0 upgrade guide.
Major Version History and Upgrade Cost explains why each major version since 1.x was necessary and what each upgrade costs.
Earlier release records remain available for historical traceability.
Feedback that helps most now
AsiBackbone is a stable 7.5.x package family targeting net10.0. It returns governance decisions and receipts; the host keeps execution ownership. It does not certify compliance or make an application secure on its own, and ordinary framework authorization is often the simpler design (see Project Boundaries and Non-Claims).
At this stage, the most useful feedback is from people evaluating the package family for the first time: steps that were unclear or failed, packages or examples that would make evaluation easier, and applications where the approach does not fit.
| Discussion category | Question to answer |
|---|---|
| Q&A | What is unclear or fails in the five-minute evaluator path or the First 15 Minutes walkthrough? |
| Ideas | Which package or example would make evaluation easier? |
| Architecture & Integration | Where would this policy-as-code and host-owned-execution approach not fit your application? |
Name AsiBackbone/AsiBackbone in the discussion when it is specific to this repository. For a reproducible bug, a focused feature request, or a documentation change, use the issue forms instead. Report vulnerabilities privately through the Security Policy.
Support and project stewardship
- Use the Support Policy to choose between discussions, issues, and private vulnerability reporting and to review the version-support lifecycle.
- Report sensitive concerns through the repository Security Policy.
- See Maintainers for current operational and publishing ownership.
- See Governance for authoritative roles, decisions, triage, and release policy.
- See Adopters for public adoption evidence and the opt-in reporting path.
Relationship to NetCoreApplicationTemplate
NetCoreApplicationTemplate may be used as a preferred host baseline during development and validation, but AsiBackbone does not require it.
NetCoreApplicationTemplate = preferred host baseline
AsiBackbone = optional governance/module package family
Consumer application = chooses whether to use either or both
A consumer should be able to use AsiBackbone in an application generated from NetCoreApplicationTemplate, in an existing ASP.NET Core application, or in a custom host that provides the required infrastructure. See NetCoreApplicationTemplate Host Validation.
Alignment boundary
AsiBackbone is a governance framework, not an intelligence engine. It implements software primitives for accountable decision flow and keeps execution authority with the host application. See Project Boundaries and Non-Claims for the full scope statement and safe wording guidance.
Current NuGet packages are intentionally published without package signing. The dated NuGet Package Signing Decision Record records the accepted risk, compensating controls, mandatory review date, and early re-evaluation criteria. The project publishes durable release-attached SBOMs, package/SBOM provenance, Source Link metadata, and package hashes as distinct trust signals; none is presented as a signed-package guarantee. For verification guidance, see the 7.5.3 Consumer Verification Guide and 7.5.3 Release Notes.
Design principles
- Keep Core small.
- Keep Core dependency-light.
- Avoid hidden host assumptions.
- Prefer explicit integration over magic.
- Let the host own infrastructure.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Options (>= 10.0.14)
NuGet packages (7)
Showing the top 5 NuGet packages that depend on AsiBackbone.Core:
| Package | Downloads |
|---|---|
|
AsiBackbone.AspNetCore
ASP.NET Core host adapters for Accountable Systems Infrastructure actor context, request correlation, HTTP result mapping, and acknowledgment challenge flows. |
|
|
AsiBackbone.Storage.InMemory
Non-durable in-memory storage helpers for Accountable Systems Infrastructure local validation, tests, and samples. |
|
|
AsiBackbone.EntityFrameworkCore
Entity Framework Core model configuration and host-owned persistence helpers for Accountable Systems Infrastructure audit and acknowledgment records. |
|
|
AsiBackbone.OpenTelemetry
OpenTelemetry-friendly Accountable Systems Infrastructure governance emission provider for AsiBackbone decision-flow telemetry. |
|
|
AsiBackbone.Signing.LocalDevelopment
Local-development RSA signing and verification provider for exercising AsiBackbone signing abstractions without cloud key-management dependencies. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated | |
|---|---|---|---|
| 7.5.4 | 348 | 11/14/2026 | |
| 7.5.3 | 720 | 11/7/2026 | |
| 7.5.2 | 427 | 10/26/2026 | |
| 7.5.1 | 223 | 10/24/2026 | |
| 7.5.0 | 634 | 10/22/2026 | |
| 7.4.0 | 215 | 10/21/2026 | |
| 7.3.0 | 196 | 10/21/2026 | |
| 7.2.1 | 398 | 10/18/2026 | |
| 7.2.0 | 225 | 10/17/2026 | |
| 7.1.1 | 205 | 10/15/2026 | |
| 7.1.0 | 168 | 10/3/2026 | |
| 7.0.0 | 171 | 9/26/2026 | |
| 6.0.0 | 224 | 9/19/2026 | |
| 5.2.0 | 196 | 9/14/2026 | |
| 5.1.0 | 4,276 | 9/12/2026 | |
| 5.0.0 | 242 | 9/7/2026 | |
| 4.0.0 | 252 | 9/6/2026 | |
| 3.2.3 | 273 | 8/30/2026 | |
| 3.2.2 | 290 | 8/22/2026 | |
| 3.2.1 | 252 | 8/7/2026 |