|
|
|
|
@@ -1,84 +1,109 @@
|
|
|
|
|
<#
|
|
|
|
|
.SYNOPSIS
|
|
|
|
|
Phase 6.3 exit-gate compliance check — stub. Each `Assert-*` either passes
|
|
|
|
|
(Write-Host green) or throws. Non-zero exit = fail.
|
|
|
|
|
Phase 6.3 exit-gate compliance check. Each check either passes or records a
|
|
|
|
|
failure; non-zero exit = fail.
|
|
|
|
|
|
|
|
|
|
.DESCRIPTION
|
|
|
|
|
Validates Phase 6.3 (Redundancy runtime) completion. Checks enumerated in
|
|
|
|
|
`docs/v2/implementation/phase-6-3-redundancy-runtime.md`
|
|
|
|
|
§"Compliance Checks (run at exit gate)".
|
|
|
|
|
|
|
|
|
|
Current status: SCAFFOLD. Every check writes a TODO line and does NOT throw.
|
|
|
|
|
Each implementation task in Phase 6.3 is responsible for replacing its TODO
|
|
|
|
|
with a real check before closing that task.
|
|
|
|
|
|
|
|
|
|
.NOTES
|
|
|
|
|
Usage: pwsh ./scripts/compliance/phase-6-3-compliance.ps1
|
|
|
|
|
Exit: 0 = all checks passed (or are still TODO); non-zero = explicit fail
|
|
|
|
|
Exit: 0 = all checks passed; non-zero = one or more FAILs
|
|
|
|
|
#>
|
|
|
|
|
[CmdletBinding()]
|
|
|
|
|
param()
|
|
|
|
|
|
|
|
|
|
$ErrorActionPreference = 'Stop'
|
|
|
|
|
$script:failures = 0
|
|
|
|
|
$repoRoot = (Resolve-Path (Join-Path $PSScriptRoot '..\..')).Path
|
|
|
|
|
|
|
|
|
|
function Assert-Todo {
|
|
|
|
|
param([string]$Check, [string]$ImplementationTask)
|
|
|
|
|
Write-Host " [TODO] $Check (implement during $ImplementationTask)" -ForegroundColor Yellow
|
|
|
|
|
function Assert-Pass { param([string]$C) Write-Host " [PASS] $C" -ForegroundColor Green }
|
|
|
|
|
function Assert-Fail { param([string]$C, [string]$R) Write-Host " [FAIL] $C - $R" -ForegroundColor Red; $script:failures++ }
|
|
|
|
|
function Assert-Deferred { param([string]$C, [string]$P) Write-Host " [DEFERRED] $C (follow-up: $P)" -ForegroundColor Yellow }
|
|
|
|
|
|
|
|
|
|
function Assert-FileExists {
|
|
|
|
|
param([string]$C, [string]$P)
|
|
|
|
|
if (Test-Path (Join-Path $repoRoot $P)) { Assert-Pass "$C ($P)" }
|
|
|
|
|
else { Assert-Fail $C "missing file: $P" }
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
function Assert-Pass {
|
|
|
|
|
param([string]$Check)
|
|
|
|
|
Write-Host " [PASS] $Check" -ForegroundColor Green
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
function Assert-Fail {
|
|
|
|
|
param([string]$Check, [string]$Reason)
|
|
|
|
|
Write-Host " [FAIL] $Check — $Reason" -ForegroundColor Red
|
|
|
|
|
$script:failures++
|
|
|
|
|
function Assert-TextFound {
|
|
|
|
|
param([string]$C, [string]$Pat, [string[]]$Paths)
|
|
|
|
|
foreach ($p in $Paths) {
|
|
|
|
|
$full = Join-Path $repoRoot $p
|
|
|
|
|
if (-not (Test-Path $full)) { continue }
|
|
|
|
|
if (Select-String -Path $full -Pattern $Pat -Quiet) {
|
|
|
|
|
Assert-Pass "$C (matched in $p)"
|
|
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
Assert-Fail $C "pattern '$Pat' not found in any of: $($Paths -join ', ')"
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
Write-Host ""
|
|
|
|
|
Write-Host "=== Phase 6.3 compliance — Redundancy runtime ===" -ForegroundColor Cyan
|
|
|
|
|
Write-Host "=== Phase 6.3 compliance - Redundancy runtime ===" -ForegroundColor Cyan
|
|
|
|
|
Write-Host ""
|
|
|
|
|
|
|
|
|
|
Write-Host "Stream A — Topology loader"
|
|
|
|
|
Assert-Todo "Transparent-mode rejection — sp_PublishGeneration blocks RedundancyMode=Transparent" "Stream A.3"
|
|
|
|
|
Write-Host "Stream B - ServiceLevel 8-state matrix (decision #154)"
|
|
|
|
|
Assert-FileExists "ServiceLevelCalculator present" "src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ServiceLevelCalculator.cs"
|
|
|
|
|
Assert-FileExists "ServiceLevelBand enum present" "src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ServiceLevelCalculator.cs"
|
|
|
|
|
Assert-TextFound "Maintenance = 0 (reserved per OPC UA Part 5)" "Maintenance\s*=\s*0" @("src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ServiceLevelCalculator.cs")
|
|
|
|
|
Assert-TextFound "NoData = 1 (reserved per OPC UA Part 5)" "NoData\s*=\s*1" @("src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ServiceLevelCalculator.cs")
|
|
|
|
|
Assert-TextFound "InvalidTopology = 2 (detected-inconsistency band)" "InvalidTopology\s*=\s*2" @("src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ServiceLevelCalculator.cs")
|
|
|
|
|
Assert-TextFound "AuthoritativePrimary = 255" "AuthoritativePrimary\s*=\s*255" @("src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ServiceLevelCalculator.cs")
|
|
|
|
|
Assert-TextFound "IsolatedPrimary = 230 (retains authority)" "IsolatedPrimary\s*=\s*230" @("src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ServiceLevelCalculator.cs")
|
|
|
|
|
Assert-TextFound "PrimaryMidApply = 200" "PrimaryMidApply\s*=\s*200" @("src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ServiceLevelCalculator.cs")
|
|
|
|
|
Assert-TextFound "RecoveringPrimary = 180" "RecoveringPrimary\s*=\s*180" @("src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ServiceLevelCalculator.cs")
|
|
|
|
|
Assert-TextFound "AuthoritativeBackup = 100" "AuthoritativeBackup\s*=\s*100" @("src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ServiceLevelCalculator.cs")
|
|
|
|
|
Assert-TextFound "IsolatedBackup = 80 (does NOT auto-promote)" "IsolatedBackup\s*=\s*80" @("src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ServiceLevelCalculator.cs")
|
|
|
|
|
Assert-TextFound "BackupMidApply = 50" "BackupMidApply\s*=\s*50" @("src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ServiceLevelCalculator.cs")
|
|
|
|
|
Assert-TextFound "RecoveringBackup = 30" "RecoveringBackup\s*=\s*30" @("src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ServiceLevelCalculator.cs")
|
|
|
|
|
|
|
|
|
|
Write-Host ""
|
|
|
|
|
Write-Host "Stream B — Peer probe + ServiceLevel calculator"
|
|
|
|
|
Assert-Todo "OPC UA band compliance — 0=Maintenance / 1=NoData reserved; operational 2..255" "Stream B.2"
|
|
|
|
|
Assert-Todo "Authoritative-Primary ServiceLevel = 255" "Stream B.2"
|
|
|
|
|
Assert-Todo "Isolated-Primary (peer unreachable, self serving) = 230" "Stream B.2"
|
|
|
|
|
Assert-Todo "Primary-Mid-Apply = 200" "Stream B.2"
|
|
|
|
|
Assert-Todo "Recovering-Primary = 180 with dwell + publish witness enforced" "Stream B.2"
|
|
|
|
|
Assert-Todo "Authoritative-Backup = 100" "Stream B.2"
|
|
|
|
|
Assert-Todo "Isolated-Backup (primary unreachable) = 80 — no auto-promote" "Stream B.2"
|
|
|
|
|
Assert-Todo "InvalidTopology = 2 — >1 Primary self-demotes both nodes" "Stream B.2"
|
|
|
|
|
Assert-Todo "UaHealthProbe authority — HTTP-200 + UA-down peer treated as UA-unhealthy" "Stream B.1"
|
|
|
|
|
Write-Host "Stream B - RecoveryStateManager"
|
|
|
|
|
Assert-FileExists "RecoveryStateManager present" "src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/RecoveryStateManager.cs"
|
|
|
|
|
Assert-TextFound "Dwell + publish-witness gate" "_witnessed" @("src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/RecoveryStateManager.cs")
|
|
|
|
|
Assert-TextFound "Default dwell 60 s" "FromSeconds\(60\)" @("src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/RecoveryStateManager.cs")
|
|
|
|
|
|
|
|
|
|
Write-Host ""
|
|
|
|
|
Write-Host "Stream C — OPC UA node wiring"
|
|
|
|
|
Assert-Todo "ServerUriArray — returns self + peer URIs, self first" "Stream C.2"
|
|
|
|
|
Assert-Todo "Client.CLI cutover — primary halt triggers reconnect to backup via ServerUriArray" "Stream C.4"
|
|
|
|
|
Write-Host "Stream D - Apply-lease registry (decision #162)"
|
|
|
|
|
Assert-FileExists "ApplyLeaseRegistry present" "src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ApplyLeaseRegistry.cs"
|
|
|
|
|
Assert-TextFound "BeginApplyLease returns IAsyncDisposable" "IAsyncDisposable" @("src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ApplyLeaseRegistry.cs")
|
|
|
|
|
Assert-TextFound "Lease key includes PublishRequestId" "PublishRequestId" @("src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ApplyLeaseRegistry.cs")
|
|
|
|
|
Assert-TextFound "Watchdog PruneStale present" "PruneStale" @("src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ApplyLeaseRegistry.cs")
|
|
|
|
|
Assert-TextFound "Default ApplyMaxDuration 10 min" "FromMinutes\(10\)" @("src/ZB.MOM.WW.OtOpcUa.Server/Redundancy/ApplyLeaseRegistry.cs")
|
|
|
|
|
|
|
|
|
|
Write-Host ""
|
|
|
|
|
Write-Host "Stream D — Apply-lease + publish fencing"
|
|
|
|
|
Assert-Todo "Apply-lease disposal — leases close on exception, cancellation, watchdog timeout" "Stream D.2"
|
|
|
|
|
Assert-Todo "Role transition via operator publish — no restart; both nodes flip ServiceLevel on publish confirm" "Stream D.3"
|
|
|
|
|
|
|
|
|
|
Write-Host ""
|
|
|
|
|
Write-Host "Stream F — Interop matrix"
|
|
|
|
|
Assert-Todo "Client interoperability matrix — Ignition 8.1/8.3 / Kepware / Aveva OI Gateway findings documented" "Stream F.1-F.2"
|
|
|
|
|
Assert-Todo "Galaxy MXAccess failover — primary kill; Galaxy consumer reconnects within session-timeout budget" "Stream F.3"
|
|
|
|
|
Write-Host "Deferred surfaces"
|
|
|
|
|
Assert-Deferred "Stream A - RedundancyCoordinator cluster-topology loader" "task #145"
|
|
|
|
|
Assert-Deferred "Stream C - OPC UA node wiring (ServiceLevel + ServerUriArray + RedundancySupport)" "task #147"
|
|
|
|
|
Assert-Deferred "Stream E - Admin RedundancyTab + OpenTelemetry metrics + SignalR" "task #149"
|
|
|
|
|
Assert-Deferred "Stream F - Client interop matrix + Galaxy MXAccess failover" "task #150"
|
|
|
|
|
Assert-Deferred "sp_PublishGeneration rejects Transparent mode pre-publish" "task #148 part 2 (SQL-side validator)"
|
|
|
|
|
|
|
|
|
|
Write-Host ""
|
|
|
|
|
Write-Host "Cross-cutting"
|
|
|
|
|
Assert-Todo "No regression in driver test suites; /healthz reachable under redundancy load" "Final exit-gate"
|
|
|
|
|
Write-Host " Running full solution test suite..." -ForegroundColor DarkGray
|
|
|
|
|
$prevPref = $ErrorActionPreference
|
|
|
|
|
$ErrorActionPreference = 'Continue'
|
|
|
|
|
$testOutput = & dotnet test (Join-Path $repoRoot 'ZB.MOM.WW.OtOpcUa.slnx') --nologo 2>&1
|
|
|
|
|
$ErrorActionPreference = $prevPref
|
|
|
|
|
$passLine = $testOutput | Select-String 'Passed:\s+(\d+)' -AllMatches
|
|
|
|
|
$failLine = $testOutput | Select-String 'Failed:\s+(\d+)' -AllMatches
|
|
|
|
|
$passCount = 0; foreach ($m in $passLine.Matches) { $passCount += [int]$m.Groups[1].Value }
|
|
|
|
|
$failCount = 0; foreach ($m in $failLine.Matches) { $failCount += [int]$m.Groups[1].Value }
|
|
|
|
|
$baseline = 1097
|
|
|
|
|
if ($passCount -ge $baseline) { Assert-Pass "No test-count regression ($passCount >= $baseline pre-Phase-6.3 baseline)" }
|
|
|
|
|
else { Assert-Fail "Test-count regression" "passed $passCount < baseline $baseline" }
|
|
|
|
|
|
|
|
|
|
if ($failCount -le 1) { Assert-Pass "No new failing tests (pre-existing CLI flake tolerated)" }
|
|
|
|
|
else { Assert-Fail "New failing tests" "$failCount failures > 1 tolerated" }
|
|
|
|
|
|
|
|
|
|
Write-Host ""
|
|
|
|
|
if ($script:failures -eq 0) {
|
|
|
|
|
Write-Host "Phase 6.3 compliance: scaffold-mode PASS (all checks TODO)" -ForegroundColor Green
|
|
|
|
|
Write-Host "Phase 6.3 compliance: PASS" -ForegroundColor Green
|
|
|
|
|
exit 0
|
|
|
|
|
}
|
|
|
|
|
Write-Host "Phase 6.3 compliance: $script:failures FAIL(s)" -ForegroundColor Red
|
|
|
|
|
|