diff --git a/docs/eve-migration-roadmap.md b/docs/eve-migration-roadmap.md index 68958bc..9689dda 100644 --- a/docs/eve-migration-roadmap.md +++ b/docs/eve-migration-roadmap.md @@ -280,6 +280,14 @@ Exit criteria: Recently cut: +- EveConformance now has a machine-readable handoff at + `tools/conformance/eveconformance-handoff.json` and a verifier at + `scripts/run-eveconformance-handoff-smoke.ps1`. The handoff names the + conformance runner, schemas, consumer smokes, fixture corpus, contract inputs, + forbidden imports, and external proofs that leave Eve when the harness + graduates. The conformance export carries `conformanceHandoffPath`, and the + generic consumer smoke asserts it so EveConformance split readiness is not + trapped in Eve's parity manifest. - Sai and Norn now have plugin handoff manifests at `plugins/incubating/sai-vn.plugin-handoff.json` and `plugins/incubating/norn-graph.plugin-handoff.json`, plus a shared verifier diff --git a/docs/parity-testing-harness.md b/docs/parity-testing-harness.md index ef7e3f1..530c72c 100644 --- a/docs/parity-testing-harness.md +++ b/docs/parity-testing-harness.md @@ -80,6 +80,11 @@ The semantic runner writes: - `artifacts/conformance/latest/packs/*.json` - `artifacts/conformance//...` +The conformance export includes `conformanceHandoffPath`, pointing at the +machine-readable EveConformance split map. That handoff is incubation evidence: +it names which runner, schema, consumer-smoke, and fixture-corpus paths move +when the conformance body leaves Eve. + The conformance export includes runtime `capabilityManifestPath` and `capabilityManifestErrors` fields so external consumers can distinguish a generic projection runtime from a runtime that can project plugin-declared @@ -103,6 +108,17 @@ After generating the parity report, `run-parity-harness.ps1` copies proves the conformance export can be consumed through its own index and pack files without reading `tools/parity/parity-manifest.json`. +EveConformance handoff smoke: + +```powershell +powershell -ExecutionPolicy Bypass -File .\scripts\run-eveconformance-handoff-smoke.ps1 +``` + +That script validates `tools/conformance/eveconformance-handoff.json` against +the parity manifest and, when present, the generated conformance export. It +checks the runner, schema, consumer-smoke, fixture-corpus move sets and the +required core/plugin/provider/runtime pack families. + Provider-owned consumer smoke: ```powershell diff --git a/scripts/run-conformance-consumer-smoke.ps1 b/scripts/run-conformance-consumer-smoke.ps1 index f7f6166..467f122 100644 --- a/scripts/run-conformance-consumer-smoke.ps1 +++ b/scripts/run-conformance-consumer-smoke.ps1 @@ -30,7 +30,10 @@ Copy-Item -LiteralPath $sourceExport -Destination $consumerExport -Recurse Push-Location $projectRoot try { - node .\tools\conformance\consume-export.mjs $consumerExport + node .\tools\conformance\consume-export.mjs $consumerExport --expect-conformance-handoff + if ($LASTEXITCODE -ne 0) { + throw "Conformance consumer smoke failed with exit code $LASTEXITCODE" + } } finally { Pop-Location } diff --git a/scripts/run-eveconformance-handoff-smoke.ps1 b/scripts/run-eveconformance-handoff-smoke.ps1 new file mode 100644 index 0000000..98a5a93 --- /dev/null +++ b/scripts/run-eveconformance-handoff-smoke.ps1 @@ -0,0 +1,107 @@ +param( + [string] $HandoffPath = "tools\conformance\eveconformance-handoff.json", + [string] $ManifestPath = "tools\parity\parity-manifest.json", + [string] $ExportDirectory = "artifacts\conformance\latest" +) + +$ErrorActionPreference = "Stop" + +$projectRoot = Split-Path -Parent $PSScriptRoot +$absoluteHandoffPath = if ([System.IO.Path]::IsPathRooted($HandoffPath)) { + $HandoffPath +} else { + Join-Path $projectRoot $HandoffPath +} +$absoluteManifestPath = if ([System.IO.Path]::IsPathRooted($ManifestPath)) { + $ManifestPath +} else { + Join-Path $projectRoot $ManifestPath +} +$absoluteExportDirectory = if ([System.IO.Path]::IsPathRooted($ExportDirectory)) { + $ExportDirectory +} else { + Join-Path $projectRoot $ExportDirectory +} + +if (-not (Test-Path -LiteralPath $absoluteHandoffPath)) { + throw "EveConformance handoff manifest not found: $absoluteHandoffPath" +} +if (-not (Test-Path -LiteralPath $absoluteManifestPath)) { + throw "Parity manifest not found: $absoluteManifestPath" +} + +$handoff = Get-Content -LiteralPath $absoluteHandoffPath -Raw | ConvertFrom-Json +$manifest = Get-Content -LiteralPath $absoluteManifestPath -Raw | ConvertFrom-Json + +if ($handoff.schema -ne "gamecult.eve.conformance_handoff.v1") { + throw "Unexpected EveConformance handoff schema: $($handoff.schema)" +} +if ($handoff.splitTarget -ne "EveConformance") { + throw "Unexpected EveConformance handoff split target: $($handoff.splitTarget)" +} +if ($handoff.ownerRepo -ne "EveConformance") { + throw "Unexpected EveConformance handoff owner: $($handoff.ownerRepo)" +} +if ($handoff.currentHostRepo -ne "Eve") { + throw "Unexpected EveConformance handoff host: $($handoff.currentHostRepo)" +} + +$expectedPath = $HandoffPath.Replace("\", "/") +if ($manifest.repoStrategy.conformanceHandoffPath -ne $expectedPath) { + throw "Parity manifest does not point at EveConformance handoff. Expected $expectedPath got $($manifest.repoStrategy.conformanceHandoffPath)" +} + +foreach ($id in @("conformance-runner", "conformance-schemas", "consumer-smokes", "fixture-corpus")) { + $moveSet = @($handoff.moveSets) | Where-Object { $_.id -eq $id } | Select-Object -First 1 + if (-not $moveSet) { + throw "EveConformance handoff missing move set: $id" + } + if ($moveSet.destinationOwner -ne "EveConformance") { + throw "EveConformance move set $id has unexpected destination owner: $($moveSet.destinationOwner)" + } + if (-not $moveSet.replacementProof) { + throw "EveConformance move set $id missing replacement proof" + } + foreach ($relativePath in @($moveSet.currentPaths)) { + $absolutePath = Join-Path $projectRoot $relativePath + if (-not (Test-Path -LiteralPath $absolutePath)) { + throw "EveConformance move set $id references missing current path: $relativePath" + } + } +} + +foreach ($contract in @( + "gamecult.eve.surface.v1", + "gamecult.eve.command.v1", + "gamecult.eve.conformance_export.v1", + "gamecult.eve.conformance_fixture.v1", + "gamecult.eve.provider_scenario.v1", + "gamecult.eve.plugin.v1", + "gamecult.eve.provider_advertisement.v1", + "gamecult.eve.runtime_capability.v1" +)) { + if (-not (@($handoff.contractInputs) -contains $contract)) { + throw "EveConformance handoff missing contract input: $contract" + } +} + +if (Test-Path -LiteralPath (Join-Path $absoluteExportDirectory "index.json")) { + $export = Get-Content -LiteralPath (Join-Path $absoluteExportDirectory "index.json") -Raw | ConvertFrom-Json + if ($export.conformanceHandoffPath -ne $expectedPath) { + throw "Conformance export does not point at EveConformance handoff. Expected $expectedPath got $($export.conformanceHandoffPath)" + } + foreach ($packId in @("core", "plugin", "provider", "runtime")) { + $pack = @($export.packs) | Where-Object { $_.id -eq $packId } | Select-Object -First 1 + if (-not $pack) { + throw "Conformance export missing pack: $packId" + } + } +} + +foreach ($proof in @($handoff.requiredExternalProofs)) { + if (-not $proof) { + throw "EveConformance handoff contains an empty required external proof" + } +} + +Write-Host "EveConformance handoff smoke passed: $absoluteHandoffPath" diff --git a/scripts/run-parity-harness.ps1 b/scripts/run-parity-harness.ps1 index 12a19c7..54441f6 100644 --- a/scripts/run-parity-harness.ps1 +++ b/scripts/run-parity-harness.ps1 @@ -14,6 +14,7 @@ $env:EVE_PARITY_OUTPUT = if ([System.IO.Path]::IsPathRooted($OutputDirectory)) { Push-Location $projectRoot try { node .\tools\parity\run-parity.mjs + & (Join-Path $PSScriptRoot "run-eveconformance-handoff-smoke.ps1") & (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") diff --git a/tools/conformance/consume-export.mjs b/tools/conformance/consume-export.mjs index eb493df..633f32a 100644 --- a/tools/conformance/consume-export.mjs +++ b/tools/conformance/consume-export.mjs @@ -16,6 +16,7 @@ if (!exportDirectory) { " --expect-runtime ", " --expect-scenario ", " --expect-split-target ", + " --expect-conformance-handoff", " --expect-plugin-operation ", " --expect-plugin-capability ", " --expect-plugin-handoff ", @@ -105,6 +106,10 @@ function validateIndex(index, directory, expectations, errors) { const runtimes = mergeRuntimeRecords(Array.isArray(index.runtimes) ? index.runtimes : [], exportedRuntimeTargets); const splitTargets = Array.isArray(index.splitTargets) ? index.splitTargets : []; + if (expectations.conformanceHandoff && !index.conformanceHandoffPath) { + errors.push("conformanceHandoffPath:missing"); + } + for (const expectedFixture of expectations.fixtures) { if (!fixtureIds.has(expectedFixture)) errors.push(`fixture:${expectedFixture}:missing`); } @@ -311,6 +316,7 @@ function parseArguments(args) { splitTargetStatuses: [], splitTargetBlockers: [], splitTargetProofs: [], + conformanceHandoff: false, }; const optionTargets = new Map([ ["--expect-pack", expectations.packs], @@ -338,6 +344,10 @@ function parseArguments(args) { for (let index = 1; index < args.length; index += 1) { const option = args[index]; + if (option === "--expect-conformance-handoff") { + expectations.conformanceHandoff = true; + continue; + } const target = optionTargets.get(option); if (!target) { console.error(`Unknown option: ${option}`); diff --git a/tools/conformance/eveconformance-handoff.json b/tools/conformance/eveconformance-handoff.json new file mode 100644 index 0000000..54ad02b --- /dev/null +++ b/tools/conformance/eveconformance-handoff.json @@ -0,0 +1,76 @@ +{ + "schema": "gamecult.eve.conformance_handoff.v1", + "splitTarget": "EveConformance", + "ownerRepo": "EveConformance", + "currentHostRepo": "Eve", + "authorityBoundary": "EveConformance owns fixture corpus layout, conformance pack export, parity runner orchestration, consumer smokes, report artifacts, capability matrix evidence, and CI once the harness stabilizes. Eve keeps the kernel contracts, browser reference oracle, and minimal core fixtures.", + "moveSets": [ + { + "id": "conformance-runner", + "destinationOwner": "EveConformance", + "currentPaths": [ + "tools/parity/run-parity.mjs", + "tools/parity/parity-manifest.json", + "tools/conformance/consume-export.mjs" + ], + "replacementProof": "EveConformance runs the parity/conformance harness without depending on Eve source layout." + }, + { + "id": "conformance-schemas", + "destinationOwner": "EveConformance", + "currentPaths": [ + "schemas/gamecult.eve.conformance_export.v1.schema.json", + "schemas/gamecult.eve.conformance_fixture.v1.schema.json", + "schemas/gamecult.eve.provider_scenario.v1.schema.json" + ], + "replacementProof": "EveConformance publishes conformance export, fixture metadata, and provider scenario schemas as consumed contracts." + }, + { + "id": "consumer-smokes", + "destinationOwner": "EveConformance", + "currentPaths": [ + "scripts/run-conformance-consumer-smoke.ps1", + "scripts/run-plugin-owner-conformance-consumer-smoke.ps1", + "scripts/run-runtime-owner-conformance-consumer-smoke.ps1", + "scripts/run-split-target-conformance-consumer-smoke.ps1", + "scripts/run-aetheria-conformance-consumer-smoke.ps1", + "scripts/run-eveflutter-conformance-consumer-smoke.ps1" + ], + "replacementProof": "Runtime, plugin, provider, and split-target consumers can verify exported packs without reading Eve's parity manifest." + }, + { + "id": "fixture-corpus", + "destinationOwner": "EveConformance", + "currentPaths": [ + "web/fixtures/cultui-slider-inspector.conformance.json", + "web/fixtures/sai-vn-surface.conformance.json", + "web/fixtures/aetheria-world-surface.conformance.json", + "web/fixtures/fensalir-direct2d-surface.conformance.json", + "web/fixtures/cultui-embedded-surface.conformance.json" + ], + "replacementProof": "Core, plugin, provider, and runtime fixture metadata are exported as conformance packs with owner and exit criteria." + } + ], + "contractInputs": [ + "gamecult.eve.surface.v1", + "gamecult.eve.command.v1", + "gamecult.eve.conformance_export.v1", + "gamecult.eve.conformance_fixture.v1", + "gamecult.eve.provider_scenario.v1", + "gamecult.eve.plugin.v1", + "gamecult.eve.provider_advertisement.v1", + "gamecult.eve.runtime_capability.v1" + ], + "forbiddenImports": [ + "provider internals as conformance truth", + "runtime source layout as required consumer input", + "plugin semantic internals as Eve core authority", + "screenshot artifacts as provider state" + ], + "requiredExternalProofs": [ + "EveConformance publishes a consumable conformance export without depending on Eve source layout.", + "Runtime repos consume runtime targets, lifecycle evidence, and capture status from exported packs.", + "Plugin owner repos consume plugin manifests, ABI operations, capabilities, and handoff paths from exported packs.", + "Provider repos consume provider advertisements, scenarios, receipts, and handoff paths from exported packs." + ] +} diff --git a/tools/parity/parity-manifest.json b/tools/parity/parity-manifest.json index 3768ecb..60d2ef9 100644 --- a/tools/parity/parity-manifest.json +++ b/tools/parity/parity-manifest.json @@ -3,7 +3,8 @@ "repoStrategy": { "boundaryRule": "Eve core owns contracts; plugins own semantics; runtime repos own native projection; provider repos own live truth.", "incubationPolicy": "Eve may host runtimes, plugins, and conformance packs only while their contract is still forming.", - "graduationDocument": "docs/repo-strategy.md" + "graduationDocument": "docs/repo-strategy.md", + "conformanceHandoffPath": "tools/conformance/eveconformance-handoff.json" }, "schemas": { "gamecult.eve.conformance_fixture.v1": "schemas/gamecult.eve.conformance_fixture.v1.schema.json", diff --git a/tools/parity/run-parity.mjs b/tools/parity/run-parity.mjs index 48b4fb3..1af5282 100644 --- a/tools/parity/run-parity.mjs +++ b/tools/parity/run-parity.mjs @@ -1338,6 +1338,7 @@ function buildConformanceExport(report) { sourceManifest: report.manifest, boundaryRule: report.repoStrategy.boundaryRule || "", incubationPolicy: report.repoStrategy.incubationPolicy || "", + conformanceHandoffPath: report.repoStrategy.conformanceHandoffPath || "", packs, plugins: (report.plugins || []).map(plugin => ({ pluginId: plugin.pluginId, @@ -1400,6 +1401,7 @@ function renderConformanceExportMarkdown(conformanceExport) { `Generated: ${conformanceExport.generatedAt}`, "", `Boundary rule: ${conformanceExport.boundaryRule || "not declared"}`, + `Conformance handoff: ${conformanceExport.conformanceHandoffPath || "not declared"}`, "", "## Packs", "",