Table of Contents

Class GovernanceEmissionEnvelope

Namespace
AsiBackbone.Core.Emissions
Assembly
AsiBackbone.Core.dll

Represents a provider-neutral governance emission envelope that can be handed to outbox storage or downstream providers.

public sealed class GovernanceEmissionEnvelope
Inheritance
GovernanceEmissionEnvelope
Inherited Members

Remarks

The envelope carries minimized governance context and safe diagnostics. It does not contain provider SDK payloads, cloud-specific routing, raw secrets, raw tokens, prompts, or protected content.

Properties

ActorId

Gets the actor identifier associated with the source governance event, when available.

public string? ActorId { get; }

Property Value

string

AuditResidueId

Gets the audit residue identifier linked to this emission, when available.

public string? AuditResidueId { get; }

Property Value

string

CorrelationId

Gets the correlation identifier that links the emission to the host workflow, when available.

public string? CorrelationId { get; }

Property Value

string

CreatedUtc

Gets the UTC timestamp when this emission envelope was created.

public DateTimeOffset CreatedUtc { get; }

Property Value

DateTimeOffset

DecisionStage

Gets the provider-neutral decision stage associated with the emission, when available.

public string? DecisionStage { get; }

Property Value

string

EmitterProvider

Gets the provider-neutral emitter provider name, when available.

public string? EmitterProvider { get; }

Property Value

string

EmitterStatus

Gets the provider-neutral emitter status, when available.

public string? EmitterStatus { get; }

Property Value

string

EnvelopeId

Gets the stable envelope identifier.

public string EnvelopeId { get; }

Property Value

string

EventId

Gets the source governance event identifier, when available.

public string? EventId { get; }

Property Value

string

EventType

Gets the provider-neutral event category.

public GovernanceEmissionEventType EventType { get; }

Property Value

GovernanceEmissionEventType

GatewayExecutionId

Gets the gateway execution identifier associated with the emission, when available.

public string? GatewayExecutionId { get; }

Property Value

string

HasCorrelation

Gets a value indicating whether correlation metadata is available.

public bool HasCorrelation { get; }

Property Value

bool

HasMetadata

Gets a value indicating whether envelope metadata is present.

public bool HasMetadata { get; }

Property Value

bool

LifecycleStage

Gets the audit residue lifecycle stage linked to this emission, when available.

public AuditResidueLifecycleStage? LifecycleStage { get; }

Property Value

AuditResidueLifecycleStage?

LifecycleStageSequence

Gets the stable lifecycle stage sequence value, when a lifecycle stage is supplied.

public int? LifecycleStageSequence { get; }

Property Value

int?

Metadata

Gets minimized provider-neutral metadata.

public IReadOnlyDictionary<string, string> Metadata { get; }

Property Value

IReadOnlyDictionary<string, string>

OccurredUtc

Gets the UTC timestamp when the source governance event occurred.

public DateTimeOffset OccurredUtc { get; }

Property Value

DateTimeOffset

OperationName

Gets the operation name associated with the source governance event, when available.

public string? OperationName { get; }

Property Value

string

OutboxSequence

Gets the outbox sequence associated with the emission, when available.

public long? OutboxSequence { get; }

Property Value

long?

Outcome

Gets the outcome associated with the source governance event, when available.

public string? Outcome { get; }

Property Value

string

ParentSpanId

Gets the parent span identifier associated with the source governance event, when available.

public string? ParentSpanId { get; }

Property Value

string

Payload

Gets the minimized provider-neutral payload descriptor, when available.

public GovernanceEmissionPayload? Payload { get; }

Property Value

GovernanceEmissionPayload

PolicyHash

Gets the policy hash associated with the source governance event, when available.

public string? PolicyHash { get; }

Property Value

string

PolicyVersion

Gets the policy version associated with the source governance event, when available.

public string? PolicyVersion { get; }

Property Value

string

SchemaVersion

Gets the schema version for this provider-neutral envelope shape.

public string SchemaVersion { get; }

Property Value

string

SpanId

Gets the span identifier associated with the source governance event, when available.

public string? SpanId { get; }

Property Value

string

TraceId

Gets the trace identifier associated with the source governance event, when available.

public string? TraceId { get; }

Property Value

string

Methods

Create(GovernanceEmissionEventType, string?, DateTimeOffset?, string?, DateTimeOffset?, string?, string?, string?, AuditResidueLifecycleStage?, string?, string?, string?, string?, string?, string?, string?, string?, string?, string?, long?, string?, string?, GovernanceEmissionPayload?, IReadOnlyDictionary<string, string>?)

Creates a provider-neutral governance emission envelope.

public static GovernanceEmissionEnvelope Create(GovernanceEmissionEventType eventType, string? eventId = null, DateTimeOffset? occurredUtc = null, string? envelopeId = null, DateTimeOffset? createdUtc = null, string? schemaVersion = null, string? correlationId = null, string? auditResidueId = null, AuditResidueLifecycleStage? lifecycleStage = null, string? policyVersion = null, string? policyHash = null, string? traceId = null, string? spanId = null, string? parentSpanId = null, string? operationName = null, string? outcome = null, string? actorId = null, string? emitterStatus = null, string? emitterProvider = null, long? outboxSequence = null, string? gatewayExecutionId = null, string? decisionStage = null, GovernanceEmissionPayload? payload = null, IReadOnlyDictionary<string, string>? metadata = null)

Parameters

eventType GovernanceEmissionEventType
eventId string
occurredUtc DateTimeOffset?
envelopeId string
createdUtc DateTimeOffset?
schemaVersion string
correlationId string
auditResidueId string
lifecycleStage AuditResidueLifecycleStage?
policyVersion string
policyHash string
traceId string
spanId string
parentSpanId string
operationName string
outcome string
actorId string
emitterStatus string
emitterProvider string
outboxSequence long?
gatewayExecutionId string
decisionStage string
payload GovernanceEmissionPayload
metadata IReadOnlyDictionary<string, string>

Returns

GovernanceEmissionEnvelope

FromLifecycleEvent(AuditResidueLifecycleEvent, string?, DateTimeOffset?, GovernanceEmissionPayload?, IReadOnlyDictionary<string, string>?)

Creates a provider-neutral governance emission envelope from an audit residue lifecycle event.

public static GovernanceEmissionEnvelope FromLifecycleEvent(AuditResidueLifecycleEvent lifecycleEvent, string? envelopeId = null, DateTimeOffset? createdUtc = null, GovernanceEmissionPayload? payload = null, IReadOnlyDictionary<string, string>? metadata = null)

Parameters

lifecycleEvent AuditResidueLifecycleEvent
envelopeId string
createdUtc DateTimeOffset?
payload GovernanceEmissionPayload
metadata IReadOnlyDictionary<string, string>

Returns

GovernanceEmissionEnvelope

FromResidue(IAsiBackboneAuditResidue, GovernanceEmissionEventType, string?, DateTimeOffset?, GovernanceEmissionPayload?, IReadOnlyDictionary<string, string>?)

Creates a provider-neutral governance emission envelope from audit residue.

public static GovernanceEmissionEnvelope FromResidue(IAsiBackboneAuditResidue residue, GovernanceEmissionEventType eventType = GovernanceEmissionEventType.AuditResidue, string? envelopeId = null, DateTimeOffset? createdUtc = null, GovernanceEmissionPayload? payload = null, IReadOnlyDictionary<string, string>? metadata = null)

Parameters

residue IAsiBackboneAuditResidue
eventType GovernanceEmissionEventType
envelopeId string
createdUtc DateTimeOffset?
payload GovernanceEmissionPayload
metadata IReadOnlyDictionary<string, string>

Returns

GovernanceEmissionEnvelope
Edit this page