AsiBackbone.Storage.InMemory 7.0.0

AsiBackbone.Storage.InMemory

Non-durable in-memory storage helpers for AsiBackbone local validation, samples, and tests.

This package provides non-durable storage implementations that make it easy to exercise ASI Backbone governance flows without requiring a database, EF Core provider, or host infrastructure.

New to AsiBackbone? Start with the concept, not this package: Intent to Execution: An Accountability Pattern and the documentation site. This README covers one package in the family.

Important: This package is not durable storage. Do not use it as a production audit ledger, compliance archive, tamper-evident store, replay-protection store, or long-term accountability store.

What this package provides

• In-memory audit ledger behavior for local validation and tests.
• In-memory outbox behavior for local validation, samples, and integration tests.
• In-memory capability grant use tracking for local validation, samples, and integration tests.
• Storage implementations that depend on AsiBackbone.Core only.
• A simple bridge for samples that need audit, outbox, or bounded-use capability grant records without introducing EF Core or a database.

Intended usage

Use this package when:

• writing unit tests or integration tests around policy evaluation;
• building sample applications;
• validating decision receipt and audit ledger behavior locally;
• validating outbox state transitions locally;
• validating first-use and replay-denied capability grant flows locally;
• demonstrating host-neutral ASI Backbone flows before adding durable storage.

For production persistence, use a host-owned durable storage strategy such as AsiBackbone.EntityFrameworkCore or a custom implementation of the Core storage contracts.

In-memory capability grant use semantics

InMemoryCapabilityGrantUseStore implements ICapabilityGrantUseStore for tests, samples, and local validation. It is keyed by issuer and capability grant token ID, consumes one use when accepted, honors maxUseCount, and returns capability.use-limit-exceeded when the local in-process count reaches that limit.

Use records are evicted once a grant has been expired for longer than EvictionGracePeriod (default five minutes), measured from the latest observed use time. A grant past that retention horizon is refused with capability.use-retention-elapsed rather than given a fresh count. Set EvictionGracePeriod to at least the largest AllowedClockSkew used with the store; otherwise expired grants still inside the skew are denied.

The store is thread-safe inside one process, and exposes local-validation helpers to mark grants as stopped or cancelled, either for one issuer (StopGrant(issuer, grantId), CancelGrant(issuer, grantId)) or for every issuer using an identifier (StopGrant(grantId), CancelGrant(grantId)). It does not persist across process restarts, coordinate multiple replicas, provide distributed locks, or guarantee production replay protection.

In-memory outbox concurrency semantics

InMemoryGovernanceOutboxStore is single-process and non-durable. It does not claim work across replicas, coordinate distributed workers, or provide exactly-once provider delivery.

Within that single process, same-entry outbox status transitions use compare-and-swap updates so local tests do not accidentally observe last-write-wins behavior. Delivered and dead-lettered entries are treated as terminal for subsequent in-memory state updates, and retryable failure updates against the same entry advance from the latest observed entry state.

Boundary

The in-memory package should remain lightweight and host-neutral. It should not select a database provider, own migrations, expose ASP.NET Core middleware, or imply durable compliance-grade audit storage or production replay protection.