using ZB.MOM.WW.ScadaBridge.Commons.Types.Audit;
using ZB.MOM.WW.ScadaBridge.Commons.Types.Debugging;
using ZB.MOM.WW.ScadaBridge.Commons.Types.Enums;
namespace ZB.MOM.WW.ScadaBridge.Commons.Tests.Debugging;
///
/// Flow Debugger outbound-calls plan (2026-09-06) Task 0: the Commons vocabulary — External lane,
/// the three outbound kinds, Pending/Parked outcomes, the lifecycle row, and additive edge/step shapes.
///
public class FlowStepProjectorTests
{
private static readonly DateTimeOffset T0 = new(2026, 9, 6, 12, 0, 0, TimeSpan.Zero);
[Fact]
public void Vocabulary_HasExternalLane_ThreeOutboundKinds_AndPendingParkedOutcomes()
{
Assert.Equal(3, (int)FlowLane.External);
Assert.True(Enum.IsDefined(FlowStepKind.ApiCall));
Assert.True(Enum.IsDefined(FlowStepKind.DbCall));
Assert.True(Enum.IsDefined(FlowStepKind.Notify));
Assert.True(Enum.IsDefined(FlowStepKind.Unknown));
Assert.False(Enum.GetNames().Contains("External"));
Assert.True(Enum.IsDefined(FlowStepOutcome.Pending));
Assert.True(Enum.IsDefined(FlowStepOutcome.Parked));
}
[Fact]
public void FlowStep_WithoutLifecycle_StillConstructs_AndDefaultsToNull()
{
var step = new FlowStep(Guid.NewGuid(), null, null, FlowStepKind.ScriptRun, FlowLane.Site, "S", null,
T0, null, FlowStepOutcome.Ok, null, null, null, null, null, null, null, null);
Assert.Null(step.Lifecycle);
var row = new FlowLifecycleRow(Guid.NewGuid(), "CachedSubmit", "Submitted", T0, "node-a", null, null);
var withLifecycle = step with { Lifecycle = [row] };
Assert.Single(withLifecycle.Lifecycle!);
Assert.Equal("Submitted", withLifecycle.Lifecycle![0].Status);
}
[Fact]
public void FlowEdge_AsyncAndSpawn_DefaultFalse()
{
var a = Guid.NewGuid();
var b = Guid.NewGuid();
var edge = new FlowEdge(a, b, false, false);
Assert.False(edge.Async);
Assert.False(edge.Spawn);
Assert.True((edge with { Async = true }).Async);
Assert.True(new FlowEdge(a, b, false, false, Async: false, Spawn: true).Spawn);
}
// ---- Task 1: outbound rows project onto the External lane ---------------------------------
[Fact]
public void SyncApiCall_Delivered_IsApiCall_External_Ok_SyncSubtitle()
{
var evt = ScadaBridgeAuditEventFactory.Create(AuditChannel.ApiOutbound, AuditKind.ApiCall, AuditStatus.Delivered,
occurredAtUtc: T0.UtcDateTime, actor: "AckRecipe", target: "Delmia.AckRecipe", sourceNode: "node-a",
executionId: Guid.NewGuid(), sourceSiteId: "site-a", sourceInstanceId: "M1", durationMs: 212,
requestSummary: "{\"id\":1}", responseSummary: "{\"ok\":true}");
var step = FlowStepProjector.Project(evt);
Assert.Equal(FlowStepKind.ApiCall, step.Kind);
Assert.Equal(FlowLane.External, step.Lane);
Assert.Equal(FlowStepOutcome.Ok, step.Outcome);
Assert.Equal("Delmia.AckRecipe", step.Title);
Assert.Equal("Delivered · sync", step.Subtitle);
Assert.Equal("{\"id\":1}", step.InputJson);
Assert.Equal("{\"ok\":true}", step.OutputJson);
Assert.Equal(212, step.DurationMs);
}
[Fact]
public void CachedSubmit_InDbOutbound_IsDbCall_Pending_CachedSubtitle()
{
var evt = ScadaBridgeAuditEventFactory.Create(AuditChannel.DbOutbound, AuditKind.CachedSubmit, AuditStatus.Submitted,
occurredAtUtc: T0.UtcDateTime, target: "MesDb", correlationId: Guid.NewGuid(), executionId: Guid.NewGuid());
var step = FlowStepProjector.Project(evt);
Assert.Equal(FlowStepKind.DbCall, step.Kind);
Assert.Equal(FlowLane.External, step.Lane);
Assert.Equal(FlowStepOutcome.Pending, step.Outcome);
Assert.Equal("Submitted · cached", step.Subtitle);
}
[Fact]
public void DbWrite_WithRowsAffectedExtra_SubtitleIsOpAndRows()
{
var evt = ScadaBridgeAuditEventFactory.Create(AuditChannel.DbOutbound, AuditKind.DbWrite, AuditStatus.Delivered,
occurredAtUtc: T0.UtcDateTime, target: "MesDb", executionId: Guid.NewGuid(),
extra: "{\"op\":\"write\",\"rowsAffected\":3}");
var step = FlowStepProjector.Project(evt);
Assert.Equal(FlowStepKind.DbCall, step.Kind);
Assert.Equal(FlowStepOutcome.Ok, step.Outcome);
Assert.Equal("write · 3 rows", step.Subtitle);
var read = ScadaBridgeAuditEventFactory.Create(AuditChannel.DbOutbound, AuditKind.DbWrite, AuditStatus.Delivered,
occurredAtUtc: T0.UtcDateTime, target: "MesDb", extra: "{\"op\":\"read\",\"rowsReturned\":1}");
Assert.Equal("read · 1 row", FlowStepProjector.Project(read).Subtitle);
}
[Fact]
public void NotifySend_Submitted_IsNotify_Pending()
{
var evt = ScadaBridgeAuditEventFactory.Create(AuditChannel.Notification, AuditKind.NotifySend, AuditStatus.Submitted,
occurredAtUtc: T0.UtcDateTime, target: "Planners", correlationId: Guid.NewGuid(), executionId: Guid.NewGuid());
var step = FlowStepProjector.Project(evt);
Assert.Equal(FlowStepKind.Notify, step.Kind);
Assert.Equal(FlowLane.External, step.Lane);
Assert.Equal(FlowStepOutcome.Pending, step.Outcome);
Assert.Equal("Planners", step.Title);
Assert.Equal("Submitted", step.Subtitle);
}
[Theory]
[InlineData(AuditStatus.Parked, FlowStepOutcome.Parked)]
[InlineData(AuditStatus.Discarded, FlowStepOutcome.Parked)]
[InlineData(AuditStatus.Failed, FlowStepOutcome.Failed)]
[InlineData(AuditStatus.Forwarded, FlowStepOutcome.Pending)]
[InlineData(AuditStatus.Attempted, FlowStepOutcome.Pending)]
[InlineData(AuditStatus.Delivered, FlowStepOutcome.Ok)]
public void OutboundStatus_MapsToOutcome(AuditStatus status, FlowStepOutcome expected)
{
var evt = ScadaBridgeAuditEventFactory.Create(AuditChannel.ApiOutbound, AuditKind.CachedResolve, status,
occurredAtUtc: T0.UtcDateTime, target: "Delmia.AckRecipe", correlationId: Guid.NewGuid(),
errorMessage: status == AuditStatus.Failed ? "boom" : null);
var step = FlowStepProjector.Project(evt);
Assert.Equal(expected, step.Outcome);
Assert.Equal($"{status} · cached", step.Subtitle);
}
[Fact]
public void ScriptTraceOutcome_Unchanged_FailedStaysFailed_OtherStatusesOk()
{
var ok = ScadaBridgeAuditEventFactory.Create(AuditChannel.ScriptTrace, AuditKind.AttributeWrite, AuditStatus.Delivered,
occurredAtUtc: T0.UtcDateTime, target: "A");
var failed = ScadaBridgeAuditEventFactory.Create(AuditChannel.ScriptTrace, AuditKind.AttributeWrite, AuditStatus.Failed,
occurredAtUtc: T0.UtcDateTime, target: "A", errorMessage: "rejected");
Assert.Equal(FlowStepOutcome.Ok, FlowStepProjector.Project(ok).Outcome);
Assert.Equal(FlowStepOutcome.Failed, FlowStepProjector.Project(failed).Outcome);
}
[Theory]
[InlineData("{\"op\":\"write\",\"rowsAffected\":2147483648}", "write")]
[InlineData("{\"op\":\"write\",\"rowsAffected\":1.5}", "write")]
[InlineData("{\"op\":\"write\",\"rowsAffected\":-1}", "write")]
[InlineData("{\"op\":7}", "Delivered")]
[InlineData("not json", "Delivered")]
public void DbSubtitle_NeverThrows_OnOddExtra(string extra, string expected)
{
var evt = ScadaBridgeAuditEventFactory.Create(AuditChannel.DbOutbound, AuditKind.DbWrite, AuditStatus.Delivered,
occurredAtUtc: T0.UtcDateTime, target: "MesDb", extra: extra);
Assert.Equal(expected, FlowStepProjector.Project(evt).Subtitle);
}
}