< Summary

Information
Class: AsiBackbone.Core.HostIntegration.HostAccountabilityLifecycleEvent
Assembly: AsiBackbone.Core
File(s): /home/runner/work/AsiBackbone/AsiBackbone/src/AsiBackbone.Core/HostIntegration/HostAccountabilityLifecycleEvent.cs
Line coverage
100%
Covered lines: 32
Uncovered lines: 0
Coverable lines: 32
Total lines: 91
Line coverage: 100%
Branch coverage
100%
Covered branches: 12
Total branches: 12
Branch coverage: 100%
Method coverage

Feature is only available for sponsors

Upgrade to PRO version

Metrics

MethodBranch coverage Crap Score Cyclomatic complexity Line coverage
ExecutionStarted(...)100%11100%
FromExecutionReceipt(...)100%11100%
AddMetadata(...)100%1010100%
AddOptional(...)100%22100%

File(s)

/home/runner/work/AsiBackbone/AsiBackbone/src/AsiBackbone.Core/HostIntegration/HostAccountabilityLifecycleEvent.cs

#LineLine coverage
 1using System.Collections.ObjectModel;
 2using AsiBackbone.Core.Audit;
 3using AsiBackbone.Core.Signing;
 4
 5namespace AsiBackbone.Core.HostIntegration;
 6
 7/// <summary>
 8/// Creates append-only audit lifecycle events that bind a governed decision to host execution evidence.
 9/// </summary>
 10public static class HostAccountabilityLifecycleEvent
 11{
 12    /// <summary>
 13    /// Creates a gateway-execution-started lifecycle event for one logical operation and attempt.
 14    /// </summary>
 15    public static DecisionReceiptLifecycleEvent ExecutionStarted(
 16        IDecisionReceipt decisionReceipt,
 17        string operationExecutionId,
 18        string? executionAttemptId = null,
 19        string? decisionAuditRecordId = null,
 20        string? eventId = null,
 21        DateTimeOffset? occurredUtc = null,
 22        IReadOnlyDictionary<string, string>? metadata = null)
 23    {
 424        ArgumentNullException.ThrowIfNull(decisionReceipt);
 325        ArgumentException.ThrowIfNullOrWhiteSpace(operationExecutionId);
 26
 227        SortedDictionary<string, string> lifecycleMetadata = new(StringComparer.Ordinal);
 228        AddMetadata(lifecycleMetadata, metadata);
 229        lifecycleMetadata[HostAccountabilityMetadataKeys.OperationExecutionId] = operationExecutionId.Trim();
 230        AddOptional(lifecycleMetadata, HostAccountabilityMetadataKeys.ExecutionAttemptId, executionAttemptId);
 231        AddOptional(lifecycleMetadata, HostAccountabilityMetadataKeys.DecisionAuditRecordId, decisionAuditRecordId);
 32
 233        return DecisionReceiptLifecycleEvent.FromDecisionReceipt(
 234            DecisionReceiptLifecycleStage.GatewayExecutionStarted,
 235            decisionReceipt,
 236            eventId: eventId,
 237            occurredUtc: occurredUtc,
 238            outcome: "Started",
 239            metadata: new ReadOnlyDictionary<string, string>(lifecycleMetadata));
 40    }
 41
 42    /// <summary>
 43    /// Creates a gateway-execution-completed lifecycle event from a typed host execution receipt.
 44    /// </summary>
 45    /// <remarks>
 46    /// The existing completion stage remains stable. Committed, failed, rolled-back, and no-mutation
 47    /// distinctions are carried by the typed receipt outcome and stable metadata keys rather than by
 48    /// expanding the lifecycle-stage enum.
 49    /// </remarks>
 50    public static DecisionReceiptLifecycleEvent FromExecutionReceipt(
 51        IDecisionReceipt decisionReceipt,
 52        GovernedOperationExecutionReceipt executionReceipt,
 53        string? eventId = null,
 54        IReadOnlyDictionary<string, string>? metadata = null)
 55    {
 2356        ArgumentNullException.ThrowIfNull(decisionReceipt);
 2357        ArgumentNullException.ThrowIfNull(executionReceipt);
 58
 2359        return DecisionReceiptLifecycleEvent.FromDecisionReceipt(
 2360            DecisionReceiptLifecycleStage.GatewayExecutionCompleted,
 2361            decisionReceipt,
 2362            eventId: eventId,
 2363            occurredUtc: executionReceipt.CompletedUtc,
 2364            outcome: CanonicalEnumWireNames.ForPersistenceOutcome(executionReceipt.PersistenceOutcome),
 2365            metadata: executionReceipt.ToLifecycleMetadata(metadata));
 66    }
 67
 68    private static void AddMetadata(SortedDictionary<string, string> destination, IReadOnlyDictionary<string, string>? m
 69    {
 270        if (metadata is null)
 71        {
 172            return;
 73        }
 74
 1075        foreach (KeyValuePair<string, string> item in metadata)
 76        {
 477            if (!string.IsNullOrWhiteSpace(item.Key))
 78            {
 379                destination[item.Key.Trim()] = item.Value?.Trim() ?? string.Empty;
 80            }
 81        }
 182    }
 83
 84    private static void AddOptional(SortedDictionary<string, string> destination, string key, string? value)
 85    {
 486        if (!string.IsNullOrWhiteSpace(value))
 87        {
 288            destination[key] = value.Trim();
 89        }
 490    }
 91}