Add EveConformance handoff proof

This commit is contained in:
Meta Vens 2026-07-09 01:52:04 +01:00
commit 5667483bed
9 changed files with 226 additions and 2 deletions

View file

@ -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

View file

@ -80,6 +80,11 @@ The semantic runner writes:
- `artifacts/conformance/latest/packs/*.json`
- `artifacts/conformance/<timestamp>/...`
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

View file

@ -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
}

View file

@ -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"

View file

@ -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")

View file

@ -16,6 +16,7 @@ if (!exportDirectory) {
" --expect-runtime <id>",
" --expect-scenario <id>",
" --expect-split-target <id>",
" --expect-conformance-handoff",
" --expect-plugin-operation <pluginId:operation>",
" --expect-plugin-capability <pluginId:capability>",
" --expect-plugin-handoff <pluginId>",
@ -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}`);

View file

@ -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."
]
}

View file

@ -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",

View file

@ -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",
"",