From 51822365294c7e18be50ccd1dc444480a2b4ce50 Mon Sep 17 00:00:00 2001 From: Meta Vens Date: Thu, 9 Jul 2026 09:54:49 +0100 Subject: [PATCH] Smoke Unity scene split handoff --- docs/eve-migration-roadmap.md | 6 + ...run-eveunity-scene-split-handoff-smoke.ps1 | 106 ++++++++++++++++++ scripts/run-parity-harness.ps1 | 1 + ...plit-target-conformance-consumer-smoke.ps1 | 1 + tools/parity/parity-manifest.json | 8 ++ 5 files changed, 122 insertions(+) create mode 100644 scripts/run-eveunity-scene-split-handoff-smoke.ps1 diff --git a/docs/eve-migration-roadmap.md b/docs/eve-migration-roadmap.md index a585a21..881e255 100644 --- a/docs/eve-migration-roadmap.md +++ b/docs/eve-migration-roadmap.md @@ -369,6 +369,12 @@ Recently cut: runtime keeps the missing provider-agnostic scene body, command transport, scene capture, and advertised `unity-scene` lowering proof visible as EveUnity blockers. +- Unity scene now has a direct split handoff smoke at + `scripts/run-eveunity-scene-split-handoff-smoke.ps1`. The smoke verifies the + scene runtime owns no current Eve source paths, does not treat Aetheria + product paths as generic runtime source, names the required Eve contracts, + and keeps the scene body, command transport, lowering claim, and capture as + external proofs until EveUnity owns them. - EveElectron now has a pending split target and handoff at `runtimes/incubating/eve-electron/eveelectron-split-handoff.json`. It does not claim an Electron runtime body yet. The handoff draws the line between a diff --git a/scripts/run-eveunity-scene-split-handoff-smoke.ps1 b/scripts/run-eveunity-scene-split-handoff-smoke.ps1 new file mode 100644 index 0000000..a229889 --- /dev/null +++ b/scripts/run-eveunity-scene-split-handoff-smoke.ps1 @@ -0,0 +1,106 @@ +param( + [string] $HandoffPath = "runtimes\incubating\eve-unity-scene\eveunity-scene-split-handoff.json" +) + +$ErrorActionPreference = "Stop" + +$projectRoot = Split-Path -Parent $PSScriptRoot +$absoluteHandoffPath = if ([System.IO.Path]::IsPathRooted($HandoffPath)) { + $HandoffPath +} else { + Join-Path $projectRoot $HandoffPath +} + +if (-not (Test-Path -LiteralPath $absoluteHandoffPath)) { + throw "EveUnity scene split handoff manifest not found: $absoluteHandoffPath" +} + +$handoff = Get-Content -LiteralPath $absoluteHandoffPath -Raw | ConvertFrom-Json + +if ($handoff.schema -ne "gamecult.eve.runtime_split_handoff.v1") { + throw "Unexpected EveUnity scene split handoff schema: $($handoff.schema)" +} +if ($handoff.splitTarget -ne "EveUnity") { + throw "Unexpected EveUnity scene split handoff target: $($handoff.splitTarget)" +} +if ($handoff.ownerRepo -ne "EveUnity") { + throw "Unexpected EveUnity scene split handoff owner: $($handoff.ownerRepo)" +} +if ($handoff.currentHostRepo -ne "Eve") { + throw "Unexpected EveUnity scene split handoff host: $($handoff.currentHostRepo)" +} +if ($handoff.runtimeId -ne "unity-scene") { + throw "Unexpected EveUnity scene split handoff runtime: $($handoff.runtimeId)" +} +if ($handoff.packageName -ne "org.gamecult.eve.unity-scene") { + throw "Unexpected EveUnity scene package name: $($handoff.packageName)" +} + +$sourcePackageRoot = Join-Path $projectRoot $handoff.sourcePackageRoot +if (-not (Test-Path -LiteralPath $sourcePackageRoot)) { + throw "EveUnity scene source package root missing: $($handoff.sourcePackageRoot)" +} + +$moveSets = @($handoff.moveSets) +$expectedMoveSets = @{ + "unity-scene-runtime-body" = "runtime-body" + "unity-scene-world-surface-lowering" = "world-surface-lowering" + "unity-scene-command-transport" = "command" + "unity-scene-capture-lifecycle" = "capture" +} + +foreach ($id in $expectedMoveSets.Keys) { + $moveSet = $moveSets | Where-Object { $_.id -eq $id } | Select-Object -First 1 + if (-not $moveSet) { + throw "EveUnity scene split handoff missing move set: $id" + } + if ($moveSet.stage -ne $expectedMoveSets[$id]) { + throw "EveUnity scene split handoff move set $id has unexpected stage: $($moveSet.stage)" + } + if ($moveSet.destinationOwner -ne "EveUnity") { + throw "EveUnity scene split handoff move set $id has unexpected destination owner: $($moveSet.destinationOwner)" + } + if (-not $moveSet.replacementProof) { + throw "EveUnity scene split handoff move set $id missing replacement proof" + } + $currentPaths = if ($null -eq $moveSet.currentPaths) { @() } else { @($moveSet.currentPaths) } + $observedProviderPaths = if ($null -eq $moveSet.observedProviderPaths) { @() } else { @($moveSet.observedProviderPaths) } + if ($currentPaths.Count -ne 0) { + throw "EveUnity scene split handoff move set $id must not claim existing Eve source paths before the generic scene lowerer exists" + } + if ($observedProviderPaths.Count -ne 0) { + throw "EveUnity scene split handoff move set $id must not treat provider product paths as generic scene runtime source" + } +} + +foreach ($contract in @( + "gamecult.eve.surface.v1", + "gamecult.eve.command.v1", + "gamecult.eve.provider_advertisement.v1", + "gamecult.eve.runtime_capability.v1", + "gamecult.eve.conformance_export.v1" +)) { + if (-not (@($handoff.contractInputs) -contains $contract)) { + throw "EveUnity scene split handoff missing contract input: $contract" + } +} + +foreach ($forbiddenImport in @( + "Aetheria daemon state as Unity scene runtime authority", + "Aetheria gameplay scripts as EveUnity scene lowerer truth", + "provider-specific scene components that bypass gamecult.eve.command.v1", + "renderer-local world simulation as provider truth", + "product assets bundled as Eve runtime contract" +)) { + if (-not (@($handoff.forbiddenImports) -contains $forbiddenImport)) { + throw "EveUnity scene split handoff missing forbidden import: $forbiddenImport" + } +} + +foreach ($proof in @($handoff.requiredExternalProofs)) { + if (-not $proof) { + throw "EveUnity scene split handoff contains an empty required external proof" + } +} + +Write-Host "EveUnity scene split handoff smoke passed: $absoluteHandoffPath" diff --git a/scripts/run-parity-harness.ps1 b/scripts/run-parity-harness.ps1 index 42d62b4..85f7071 100644 --- a/scripts/run-parity-harness.ps1 +++ b/scripts/run-parity-harness.ps1 @@ -18,6 +18,7 @@ try { & (Join-Path $PSScriptRoot "run-plugin-handoff-smoke.ps1") & (Join-Path $PSScriptRoot "run-aetheria-provider-handoff-smoke.ps1") & (Join-Path $PSScriptRoot "run-eveunity-split-handoff-smoke.ps1") + & (Join-Path $PSScriptRoot "run-eveunity-scene-split-handoff-smoke.ps1") & (Join-Path $PSScriptRoot "run-eveelectron-split-handoff-smoke.ps1") & (Join-Path $PSScriptRoot "run-conformance-consumer-smoke.ps1") & (Join-Path $PSScriptRoot "run-plugin-owner-conformance-consumer-smoke.ps1") diff --git a/scripts/run-split-target-conformance-consumer-smoke.ps1 b/scripts/run-split-target-conformance-consumer-smoke.ps1 index 52b2bcb..a412c05 100644 --- a/scripts/run-split-target-conformance-consumer-smoke.ps1 +++ b/scripts/run-split-target-conformance-consumer-smoke.ps1 @@ -41,6 +41,7 @@ try { --expect-split-target-status EveUnity:incubating ` --expect-split-target-proof "EveUnity:Unity lifecycle evidence is declared" ` --expect-split-target-proof "EveUnity:EveUnity split handoff is machine-readable" ` + --expect-split-target-proof "EveUnity:Unity scene split handoff is machine-readable" ` --expect-split-target-blocker "EveUnity:runtime:unity-scene:status:pending" ` --expect-split-target-blocker-record EveUnity:runtime-status:unity-scene ` --expect-split-target-blocker-record EveUnity:runtime-plugin-projection:unity-scene:sai.vn ` diff --git a/tools/parity/parity-manifest.json b/tools/parity/parity-manifest.json index 3181e1e..407efed 100644 --- a/tools/parity/parity-manifest.json +++ b/tools/parity/parity-manifest.json @@ -573,6 +573,14 @@ "scripts/run-eveunity-split-handoff-smoke.ps1", "packages/org.gamecult.eve.unity-uitoolkit/eve-runtime-capability.json" ] + }, + { + "description": "Unity scene split handoff is machine-readable and smoke-checked.", + "status": "passed", + "evidencePaths": [ + "runtimes/incubating/eve-unity-scene/eveunity-scene-split-handoff.json", + "scripts/run-eveunity-scene-split-handoff-smoke.ps1" + ] } ], "pendingProofs": [