Add EveConformance handoff proof
This commit is contained in:
parent
96968931a1
commit
5667483bed
9 changed files with 226 additions and 2 deletions
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
}
|
||||
|
|
|
|||
107
scripts/run-eveconformance-handoff-smoke.ps1
Normal file
107
scripts/run-eveconformance-handoff-smoke.ps1
Normal 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"
|
||||
|
|
@ -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")
|
||||
|
|
|
|||
|
|
@ -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}`);
|
||||
|
|
|
|||
76
tools/conformance/eveconformance-handoff.json
Normal file
76
tools/conformance/eveconformance-handoff.json
Normal 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."
|
||||
]
|
||||
}
|
||||
|
|
@ -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",
|
||||
|
|
|
|||
|
|
@ -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",
|
||||
"",
|
||||
|
|
|
|||
Loading…
Reference in a new issue