| | | 1 | | using System.Collections.ObjectModel; |
| | | 2 | | using AsiBackbone.Core.Audit; |
| | | 3 | | using AsiBackbone.Core.Signing; |
| | | 4 | | |
| | | 5 | | namespace AsiBackbone.Core.HostIntegration; |
| | | 6 | | |
| | | 7 | | /// <summary> |
| | | 8 | | /// Creates append-only audit lifecycle events that bind a governed decision to host execution evidence. |
| | | 9 | | /// </summary> |
| | | 10 | | public 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 residue, |
| | | 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 | | { |
| | 0 | 24 | | ArgumentNullException.ThrowIfNull(residue); |
| | 0 | 25 | | ArgumentException.ThrowIfNullOrWhiteSpace(operationExecutionId); |
| | | 26 | | |
| | 0 | 27 | | SortedDictionary<string, string> lifecycleMetadata = new(StringComparer.Ordinal); |
| | 0 | 28 | | AddMetadata(lifecycleMetadata, metadata); |
| | 0 | 29 | | lifecycleMetadata[HostAccountabilityMetadataKeys.OperationExecutionId] = operationExecutionId.Trim(); |
| | 0 | 30 | | AddOptional(lifecycleMetadata, HostAccountabilityMetadataKeys.ExecutionAttemptId, executionAttemptId); |
| | 0 | 31 | | AddOptional(lifecycleMetadata, HostAccountabilityMetadataKeys.DecisionAuditRecordId, decisionAuditRecordId); |
| | | 32 | | |
| | 0 | 33 | | return DecisionReceiptLifecycleEvent.FromDecisionReceipt( |
| | 0 | 34 | | DecisionReceiptLifecycleStage.GatewayExecutionStarted, |
| | 0 | 35 | | residue, |
| | 0 | 36 | | eventId: eventId, |
| | 0 | 37 | | occurredUtc: occurredUtc, |
| | 0 | 38 | | outcome: "Started", |
| | 0 | 39 | | 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 residue, |
| | | 52 | | GovernedOperationExecutionReceipt receipt, |
| | | 53 | | string? eventId = null, |
| | | 54 | | IReadOnlyDictionary<string, string>? metadata = null) |
| | | 55 | | { |
| | 19 | 56 | | ArgumentNullException.ThrowIfNull(residue); |
| | 19 | 57 | | ArgumentNullException.ThrowIfNull(receipt); |
| | | 58 | | |
| | 19 | 59 | | return DecisionReceiptLifecycleEvent.FromDecisionReceipt( |
| | 19 | 60 | | DecisionReceiptLifecycleStage.GatewayExecutionCompleted, |
| | 19 | 61 | | residue, |
| | 19 | 62 | | eventId: eventId, |
| | 19 | 63 | | occurredUtc: receipt.CompletedUtc, |
| | 19 | 64 | | outcome: CanonicalEnumWireNames.ForPersistenceOutcome(receipt.PersistenceOutcome), |
| | 19 | 65 | | metadata: receipt.ToLifecycleMetadata(metadata)); |
| | | 66 | | } |
| | | 67 | | |
| | | 68 | | private static void AddMetadata(SortedDictionary<string, string> destination, IReadOnlyDictionary<string, string>? m |
| | | 69 | | { |
| | 0 | 70 | | if (metadata is null) |
| | | 71 | | { |
| | 0 | 72 | | return; |
| | | 73 | | } |
| | | 74 | | |
| | 0 | 75 | | foreach (KeyValuePair<string, string> item in metadata) |
| | | 76 | | { |
| | 0 | 77 | | if (!string.IsNullOrWhiteSpace(item.Key)) |
| | | 78 | | { |
| | 0 | 79 | | destination[item.Key.Trim()] = item.Value?.Trim() ?? string.Empty; |
| | | 80 | | } |
| | | 81 | | } |
| | 0 | 82 | | } |
| | | 83 | | |
| | | 84 | | private static void AddOptional(SortedDictionary<string, string> destination, string key, string? value) |
| | | 85 | | { |
| | 0 | 86 | | if (!string.IsNullOrWhiteSpace(value)) |
| | | 87 | | { |
| | 0 | 88 | | destination[key] = value.Trim(); |
| | | 89 | | } |
| | 0 | 90 | | } |
| | | 91 | | } |