Add TUI capture request contract

scripts/run-evetui-capture-contract-smoke.ps1

@@ -0,0 +1,99 @@
+param(
+  [string] $CapabilityManifestPath = "runtimes\incubating\eve-tui\eve-runtime-capability.json",
+  [string] $AdvertisementPath = "web\fixtures\aetheria.provider-advertisement.json",
+  [string] $OutputPath = "artifacts\evetui-capture-contract\latest\capture-request.json",
+  [string] $Stamp = "smoke"
+)
+
+$ErrorActionPreference = "Stop"
+
+$projectRoot = Split-Path -Parent $PSScriptRoot
+$absoluteCapabilityPath = if ([System.IO.Path]::IsPathRooted($CapabilityManifestPath)) {
+  $CapabilityManifestPath
+} else {
+  Join-Path $projectRoot $CapabilityManifestPath
+}
+$absoluteAdvertisementPath = if ([System.IO.Path]::IsPathRooted($AdvertisementPath)) {
+  $AdvertisementPath
+} else {
+  Join-Path $projectRoot $AdvertisementPath
+}
+$absoluteOutputPath = if ([System.IO.Path]::IsPathRooted($OutputPath)) {
+  $OutputPath
+} else {
+  Join-Path $projectRoot $OutputPath
+}
+
+foreach ($path in @($absoluteCapabilityPath, $absoluteAdvertisementPath)) {
+  if (-not (Test-Path -LiteralPath $path)) {
+    throw "EveTui capture contract input not found: $path"
+  }
+}
+
+$manifest = Get-Content -LiteralPath $absoluteCapabilityPath -Raw | ConvertFrom-Json
+$captureContract = $manifest.lifecycle.capture.captureContract
+if ($null -eq $captureContract) {
+  throw "EveTui capture contract missing lifecycle.capture.captureContract"
+}
+foreach ($field in @("ownerRepo", "runtimeId", "targetId", "requestSchema", "requestBuilder", "advertisementPath", "captureKind", "artifactKind", "artifactPattern", "conformanceAttachment", "requiredProvider", "requiredSurface", "authority", "publishProof")) {
+  if (-not $captureContract.$field) {
+    throw "EveTui capture contract missing $field"
+  }
+}
+if ($captureContract.ownerRepo -ne "EveTui") {
+  throw "Unexpected EveTui capture owner: $($captureContract.ownerRepo)"
+}
+if ($captureContract.runtimeId -ne "tui") {
+  throw "Unexpected EveTui capture runtime: $($captureContract.runtimeId)"
+}
+if ($captureContract.targetId -ne "tui") {
+  throw "Unexpected EveTui capture target: $($captureContract.targetId)"
+}
+if ($captureContract.requestSchema -ne "gamecult.eve.runtime_capture_request.v1") {
+  throw "Unexpected EveTui capture request schema: $($captureContract.requestSchema)"
+}
+
+$builderPath = Join-Path $projectRoot $captureContract.requestBuilder
+if (-not (Test-Path -LiteralPath $builderPath)) {
+  throw "EveTui capture request builder not found: $($captureContract.requestBuilder)"
+}
+if ((Join-Path $projectRoot $captureContract.advertisementPath) -ne $absoluteAdvertisementPath) {
+  throw "EveTui capture advertisement path mismatch: $($captureContract.advertisementPath) vs $AdvertisementPath"
+}
+
+node --test (Join-Path $projectRoot "tools\evetui\evetui-capture-contract.test.mjs")
+if ($LASTEXITCODE -ne 0) {
+  throw "EveTui capture contract tests failed with exit code $LASTEXITCODE"
+}
+
+node $builderPath --capability $absoluteCapabilityPath --advertisement $absoluteAdvertisementPath --output $absoluteOutputPath --stamp $Stamp
+if ($LASTEXITCODE -ne 0) {
+  throw "EveTui capture request builder failed with exit code $LASTEXITCODE"
+}
+if (-not (Test-Path -LiteralPath $absoluteOutputPath)) {
+  throw "EveTui capture request was not written: $absoluteOutputPath"
+}
+
+$request = Get-Content -LiteralPath $absoluteOutputPath -Raw | ConvertFrom-Json
+foreach ($expectation in @(
+  @{ field = "schema"; value = "gamecult.eve.runtime_capture_request.v1" },
+  @{ field = "runtimeId"; value = "tui" },
+  @{ field = "ownerRepo"; value = "EveTui" },
+  @{ field = "providerId"; value = "aetheria" },
+  @{ field = "surfaceId"; value = "aetheria.daemon.game" },
+  @{ field = "targetId"; value = "tui" },
+  @{ field = "commandBoundary"; value = "aetheria.daemon.commands" },
+  @{ field = "receiptSchema"; value = "aetheria.eve_command_acceptance_status.v1" },
+  @{ field = "captureKind"; value = "terminal-transcript-or-cell-grid" },
+  @{ field = "artifactKind"; value = "ansi-transcript-or-json-grid" },
+  @{ field = "conformanceAttachment"; value = "runtime.captureArtifacts[]" }
+)) {
+  if ($request.($expectation.field) -ne $expectation.value) {
+    throw "EveTui capture request $($expectation.field) expected $($expectation.value) got $($request.($expectation.field))"
+  }
+}
+if ($request.artifactPath -ne "artifacts/evetui-capture/$Stamp/tui-transcript.ansi") {
+  throw "Unexpected EveTui capture artifact path: $($request.artifactPath)"
+}
+
+Write-Host "EveTui capture contract smoke passed: $absoluteOutputPath"

scripts/run-evetui-lifecycle-smoke.ps1

@@ -135,13 +135,33 @@ foreach ($pathProperty in @("runnerScript", "consumerProject")) {
 }
 
 $captureContract = $manifest.lifecycle.capture.captureContract
-foreach ($field in @("ownerRepo", "runtimeId", "captureKind", "artifactKind", "artifactPattern", "conformanceAttachment", "requiredProvider", "requiredSurface", "authority", "publishProof")) {
+foreach ($field in @("ownerRepo", "runtimeId", "targetId", "requestSchema", "requestBuilder", "advertisementPath", "captureKind", "artifactKind", "artifactPattern", "conformanceAttachment", "requiredProvider", "requiredSurface", "authority", "publishProof")) {
   if (-not $captureContract.$field) {
     throw "EveTui capture contract missing $field"
   }
 }
+if ($captureContract.runtimeId -ne "tui") {
+  throw "EveTui capture contract has unexpected runtime: $($captureContract.runtimeId)"
+}
+if ($captureContract.targetId -ne "tui") {
+  throw "EveTui capture contract has unexpected target: $($captureContract.targetId)"
+}
+if ($captureContract.requestSchema -ne "gamecult.eve.runtime_capture_request.v1") {
+  throw "EveTui capture contract has unexpected request schema: $($captureContract.requestSchema)"
+}
+if ($captureContract.captureKind -ne "terminal-transcript-or-cell-grid") {
+  throw "EveTui capture contract has unexpected capture kind: $($captureContract.captureKind)"
+}
+foreach ($pathProperty in @("requestBuilder", "advertisementPath")) {
+  $relativePath = $captureContract.$pathProperty
+  $absolutePath = Join-Path $projectRoot $relativePath
+  if (-not (Test-Path -LiteralPath $absolutePath)) {
+    throw "EveTui capture contract $pathProperty does not exist: $relativePath"
+  }
+}
 
 & (Join-Path $projectRoot "scripts\run-evetui-split-handoff-smoke.ps1")
 & (Join-Path $projectRoot "scripts\run-evetui-provider-shell-smoke.ps1")
+& (Join-Path $projectRoot "scripts\run-evetui-capture-contract-smoke.ps1")
 
 Write-Host "EveTui lifecycle smoke passed: $absoluteManifestPath"

scripts/run-evetui-split-handoff-smoke.ps1

@@ -61,7 +61,7 @@ foreach ($id in $expectedMoveSets.Keys) {
   }
   $currentPaths = if ($null -eq $moveSet.currentPaths) { @() } else { @($moveSet.currentPaths) }
   $observedProviderPaths = if ($null -eq $moveSet.observedProviderPaths) { @() } else { @($moveSet.observedProviderPaths) }
-  if ($id -in @("tui-runtime-body", "tui-world-surface-lowering", "tui-command-transport")) {
+  if ($id -in @("tui-runtime-body", "tui-world-surface-lowering", "tui-command-transport", "tui-capture-lifecycle")) {
     if ($currentPaths.Count -eq 0) {
       throw "EveTui split handoff move set $id must name provider-shell skeleton paths"
     }
@@ -71,8 +71,6 @@ foreach ($id in $expectedMoveSets.Keys) {
         throw "EveTui split handoff move set $id references missing current path: $relativePath"
       }
     }
-  } elseif ($currentPaths.Count -ne 0) {
-    throw "EveTui split handoff move set $id must not claim existing Eve source paths before its proof exists"
   }
   if ($observedProviderPaths.Count -ne 0) {
     throw "EveTui split handoff move set $id must not treat provider product paths as generic TUI runtime source"

scripts/run-runtime-owner-conformance-consumer-smoke.ps1

@@ -186,6 +186,10 @@ node $consumerScript $consumerExport `
   --expect-runtime-lifecycle-field "tui:test:testContract.runnerKind:terminal-provider-shell-smoke" `
   --expect-runtime-lifecycle-field "tui:test:testContract.runnerScript:scripts/run-evetui-provider-shell-smoke.ps1" `
   --expect-runtime-lifecycle-field "tui:capture:captureContract.captureKind:terminal-transcript-or-cell-grid" `
+  --expect-runtime-lifecycle-field "tui:capture:captureContract.targetId:tui" `
+  --expect-runtime-lifecycle-field "tui:capture:captureContract.requestSchema:gamecult.eve.runtime_capture_request.v1" `
+  --expect-runtime-lifecycle-field "tui:capture:captureContract.requestBuilder:tools/evetui/evetui-capture-contract.mjs" `
+  --expect-runtime-lifecycle-field "tui:capture:captureContract.advertisementPath:web/fixtures/aetheria.provider-advertisement.json" `
   --expect-runtime-lifecycle-field "tui:capture:captureContract.requiredSurface:aetheria.daemon.game"
 
 if ($LASTEXITCODE -ne 0) {

scripts/run-split-target-conformance-consumer-smoke.ps1

@@ -79,6 +79,7 @@ try {
     --expect-split-handoff-move EveTui:tui:tui-runtime-body:current:exists:eve-tui-shell.mjs `
     --expect-split-handoff-move EveTui:tui:tui-world-surface-lowering:current:exists:eve-tui-shell.mjs `
     --expect-split-handoff-move EveTui:tui:tui-command-transport:current:exists:eve-tui-shell.mjs `
+    --expect-split-handoff-move EveTui:tui:tui-capture-lifecycle:current:exists:evetui-capture-contract.mjs `
     --expect-split-target-blocker "EveTui:TUI runtime body graduates to EveTui outside provider product code"
   if ($LASTEXITCODE -ne 0) {
     throw "Split target conformance consumer smoke failed with exit code $LASTEXITCODE"