diff --git a/docs/eve-migration-roadmap.md b/docs/eve-migration-roadmap.md index fa7e253..db6e62c 100644 --- a/docs/eve-migration-roadmap.md +++ b/docs/eve-migration-roadmap.md @@ -295,6 +295,10 @@ Recently cut: EveUnity's pending `unity-scene` runtime, and `tui` gaps point at EveTui's pending `tui` runtime. Eve only owns a world-lowering gap when no runtime target has been declared. +- The conformance export now carries `worldSurfaceLoweringGaps[]` as typed + data in addition to the generic `capabilityGaps[]` ledger. Runtime owners can + consume provider id, surface id, target id, owner repo, runtime id, split + target, and runtime status without scraping prose or gap strings. - EveUnity now has a pending Unity scene handoff at `runtimes/incubating/eve-unity-scene/eveunity-scene-split-handoff.json`. The active `unity-uitoolkit` runtime remains a semantic UI surface lowerer; diff --git a/docs/parity-testing-harness.md b/docs/parity-testing-harness.md index 4d96905..90905c2 100644 --- a/docs/parity-testing-harness.md +++ b/docs/parity-testing-harness.md @@ -104,6 +104,10 @@ When a provider advertises a world-surface lowering target that no runtime claims, the gap is assigned to the matching pending runtime owner when one exists, such as `unity-scene` -> EveUnity or `tui` -> EveTui. Eve only owns the gap when no runtime target has been declared at all. +The same facts are also exported as `worldSurfaceLoweringGaps[]` so runtime +owners can consume provider id, surface id, target id, owner repo, runtime id, +split target, and runtime status as typed fields instead of parsing the generic +gap text. The conformance export includes runtime `capabilityManifestPath` and `capabilityManifestErrors` fields so external consumers can distinguish a diff --git a/schemas/gamecult.eve.conformance_export.v1.schema.json b/schemas/gamecult.eve.conformance_export.v1.schema.json index 3271172..a229209 100644 --- a/schemas/gamecult.eve.conformance_export.v1.schema.json +++ b/schemas/gamecult.eve.conformance_export.v1.schema.json @@ -95,6 +95,65 @@ "additionalProperties": true } }, + "worldSurfaceLoweringGaps": { + "type": "array", + "items": { + "type": "object", + "required": [ + "providerId", + "surfaceId", + "targetId", + "ownerRepo", + "runtimeId", + "severity" + ], + "properties": { + "providerId": { + "type": "string", + "minLength": 1 + }, + "providerOwnerRepo": { + "type": "string" + }, + "surfaceId": { + "type": "string", + "minLength": 1 + }, + "surfaceKind": { + "type": "string" + }, + "projectionKind": { + "type": "string" + }, + "targetId": { + "type": "string", + "minLength": 1 + }, + "ownerRepo": { + "type": "string", + "minLength": 1 + }, + "runtimeId": { + "type": "string", + "minLength": 1 + }, + "splitTarget": { + "type": "string" + }, + "runtimeStatus": { + "type": "string" + }, + "severity": { + "type": "string", + "minLength": 1 + }, + "detail": { + "type": "string" + } + }, + "additionalProperties": true + } + }, "plugins": { "type": "array" }, diff --git a/scripts/run-conformance-consumer-smoke.ps1 b/scripts/run-conformance-consumer-smoke.ps1 index 9a64b9e..d09beaf 100644 --- a/scripts/run-conformance-consumer-smoke.ps1 +++ b/scripts/run-conformance-consumer-smoke.ps1 @@ -35,6 +35,9 @@ try { --expect-capability-gap runtime:Fensalir:direct2d:capture:missing ` --expect-capability-gap "runtime:EveUnity:unity-scene:provider:aetheria:surface:aetheria.daemon.game:world-lowering-target:unity-scene:missing-runtime" ` --expect-capability-gap "runtime:EveTui:tui:provider:aetheria:surface:aetheria.daemon.game:world-lowering-target:tui:missing-runtime" ` + --expect-world-lowering-gap aetheria:aetheria.daemon.game:unity-scene:EveUnity:unity-scene ` + --expect-world-lowering-gap aetheria:aetheria.daemon.game:tui:EveTui:tui ` + --expect-world-lowering-gap aetheria:aetheria.daemon.editor:tui:EveTui:tui ` --expect-capability-gap "split-target:EveUnity:EveUnity:proof:Tagged UPM release" ` --expect-conformance-handoff if ($LASTEXITCODE -ne 0) { diff --git a/tools/conformance/consume-export.mjs b/tools/conformance/consume-export.mjs index a92d9b9..e6d1018 100644 --- a/tools/conformance/consume-export.mjs +++ b/tools/conformance/consume-export.mjs @@ -18,6 +18,7 @@ if (!exportDirectory) { " --expect-split-target ", " --expect-capability-matrix", " --expect-capability-gap ", + " --expect-world-lowering-gap ", " --expect-conformance-handoff", " --expect-plugin-operation ", " --expect-plugin-capability ", @@ -120,6 +121,7 @@ function validateIndex(index, directory, expectations, errors) { const runtimes = mergeRuntimeRecords(Array.isArray(index.runtimes) ? index.runtimes : [], exportedRuntimeTargets); const splitTargets = Array.isArray(index.splitTargets) ? index.splitTargets : []; const capabilityGaps = Array.isArray(index.capabilityGaps) ? index.capabilityGaps : []; + const worldSurfaceLoweringGaps = Array.isArray(index.worldSurfaceLoweringGaps) ? index.worldSurfaceLoweringGaps : []; if (expectations.conformanceHandoff && !index.conformanceHandoffPath) { errors.push("conformanceHandoffPath:missing"); @@ -131,11 +133,28 @@ function validateIndex(index, directory, expectations, errors) { validateCapabilityMatrix(index.capabilityMatrix, packs, plugins, providers, runtimes, splitTargets, errors); } validateCapabilityGaps(index.capabilityGaps, errors); + validateWorldSurfaceLoweringGaps(index.worldSurfaceLoweringGaps, errors); for (const expectedGap of expectations.capabilityGaps) { if (!capabilityGaps.some(gap => capabilityGapText(gap).includes(expectedGap))) { errors.push(`capabilityGaps:${expectedGap}:missing`); } } + for (const expectation of expectations.worldLoweringGaps) { + const gap = worldSurfaceLoweringGaps.find(candidate => + candidate.providerId === expectation.providerId && + candidate.surfaceId === expectation.surfaceId && + candidate.targetId === expectation.targetId); + if (!gap) { + errors.push(`worldSurfaceLoweringGaps:${expectation.providerId}:${expectation.surfaceId}:${expectation.targetId}:missing`); + continue; + } + if (gap.ownerRepo !== expectation.ownerRepo) { + errors.push(`worldSurfaceLoweringGaps:${expectation.providerId}:${expectation.surfaceId}:${expectation.targetId}:ownerRepo:expected ${expectation.ownerRepo} got ${gap.ownerRepo || ""}`); + } + if (gap.runtimeId !== expectation.runtimeId) { + errors.push(`worldSurfaceLoweringGaps:${expectation.providerId}:${expectation.surfaceId}:${expectation.targetId}:runtimeId:expected ${expectation.runtimeId} got ${gap.runtimeId || ""}`); + } + } for (const expectedFixture of expectations.fixtures) { if (!fixtureIds.has(expectedFixture)) errors.push(`fixture:${expectedFixture}:missing`); @@ -535,6 +554,18 @@ function validateCapabilityGaps(gaps, errors) { } } +function validateWorldSurfaceLoweringGaps(gaps, errors) { + if (!Array.isArray(gaps)) { + errors.push("worldSurfaceLoweringGaps:missing"); + return; + } + for (const [index, gap] of gaps.entries()) { + for (const field of ["providerId", "surfaceId", "targetId", "ownerRepo", "runtimeId", "severity"]) { + if (!gap?.[field]) errors.push(`worldSurfaceLoweringGaps:${index}:${field}:missing`); + } + } +} + function capabilityGapText(gap) { return [ gap.kind, @@ -584,6 +615,7 @@ function parseArguments(args) { splitTargetProofs: [], capabilityMatrix: false, capabilityGaps: [], + worldLoweringGaps: [], conformanceHandoff: false, }; const optionTargets = new Map([ @@ -621,6 +653,7 @@ function parseArguments(args) { ["--expect-split-target-blocker", expectations.splitTargetBlockers], ["--expect-split-target-proof", expectations.splitTargetProofs], ["--expect-capability-gap", expectations.capabilityGaps], + ["--expect-world-lowering-gap", expectations.worldLoweringGaps], ]); for (let index = 1; index < args.length; index += 1) { @@ -695,6 +728,8 @@ function parseArguments(args) { target.push(parseSplitTargetExpectation(value, "blocker")); } else if (option === "--expect-split-target-proof") { target.push(parseSplitTargetExpectation(value, "proof")); + } else if (option === "--expect-world-lowering-gap") { + target.push(parseWorldLoweringGapExpectation(value)); } else { target.push(value); } @@ -704,6 +739,21 @@ function parseArguments(args) { return { exportDirectory: exportPath, expectations }; } +function parseWorldLoweringGapExpectation(value) { + const parts = value.split(":"); + if (parts.length !== 5 || parts.some(part => !part)) { + console.error(`Expected world lowering gap in form, got: ${value}`); + process.exit(2); + } + return { + providerId: parts[0], + surfaceId: parts[1], + targetId: parts[2], + ownerRepo: parts[3], + runtimeId: parts[4], + }; +} + function parsePluginExpectation(value, field) { const separator = value.indexOf(":"); if (separator <= 0 || separator === value.length - 1) { diff --git a/tools/parity/run-parity.mjs b/tools/parity/run-parity.mjs index 98eb597..bf76a82 100644 --- a/tools/parity/run-parity.mjs +++ b/tools/parity/run-parity.mjs @@ -1588,6 +1588,7 @@ function buildConformanceExport(report) { conformanceHandoffExportPath: makeHandoffExportPath("conformance", "EveConformance", report.repoStrategy.conformanceHandoffPath || ""), packs, capabilityMatrix: buildCapabilityMatrix(report), + worldSurfaceLoweringGaps: collectWorldSurfaceLoweringGaps(report), capabilityGaps: collectCapabilityGaps(report), plugins: (report.plugins || []).map(plugin => ({ pluginId: plugin.pluginId, @@ -1815,33 +1816,15 @@ function collectCapabilityGaps(report) { } } - const worldLoweringTargets = new Set(); - const runtimeByWorldTarget = new Map(); - for (const runtime of report.runtimes || []) { - if (runtime.id) runtimeByWorldTarget.set(runtime.id, runtime); - for (const claim of runtime.worldSurfaceLowering || []) { - if (claim.targetId) worldLoweringTargets.add(claim.targetId); - if (claim.targetId) runtimeByWorldTarget.set(claim.targetId, runtime); - } - } - for (const provider of report.providers || []) { - for (const surface of provider.surfaceContracts || []) { - for (const targetId of surface.worldInteraction?.loweringTargets || []) { - if (!worldLoweringTargets.has(targetId)) { - const targetRuntime = runtimeByWorldTarget.get(targetId); - addGap({ - kind: "runtime", - ownerRepo: targetRuntime?.ownerRepo || "Eve", - subjectId: targetRuntime?.id || "world-surface-lowering", - gap: `provider:${provider.providerId}:surface:${surface.surfaceId}:world-lowering-target:${targetId}:missing-runtime`, - severity: "blocker", - detail: targetRuntime - ? `splitTarget:${targetRuntime.splitTarget || ""}:status:${targetRuntime.status || ""}` - : "no-runtime-target-declared", - }); - } - } - } + for (const gap of collectWorldSurfaceLoweringGaps(report)) { + addGap({ + kind: "runtime", + ownerRepo: gap.ownerRepo, + subjectId: gap.runtimeId, + gap: `provider:${gap.providerId}:surface:${gap.surfaceId}:world-lowering-target:${gap.targetId}:missing-runtime`, + severity: gap.severity, + detail: gap.detail, + }); } for (const target of report.splitTargets || []) { @@ -1859,6 +1842,46 @@ function collectCapabilityGaps(report) { return gaps; } +function collectWorldSurfaceLoweringGaps(report) { + const claimedTargets = new Set(); + const runtimeByWorldTarget = new Map(); + for (const runtime of report.runtimes || []) { + if (runtime.id) runtimeByWorldTarget.set(runtime.id, runtime); + for (const claim of runtime.worldSurfaceLowering || []) { + if (!claim.targetId) continue; + claimedTargets.add(claim.targetId); + runtimeByWorldTarget.set(claim.targetId, runtime); + } + } + + const gaps = []; + for (const provider of report.providers || []) { + for (const surface of provider.surfaceContracts || []) { + for (const targetId of surface.worldInteraction?.loweringTargets || []) { + if (claimedTargets.has(targetId)) continue; + const targetRuntime = runtimeByWorldTarget.get(targetId); + gaps.push({ + providerId: provider.providerId, + providerOwnerRepo: provider.ownerRepo || "", + surfaceId: surface.surfaceId, + surfaceKind: surface.surfaceKind || "", + projectionKind: surface.worldInteraction?.projectionKind || "", + targetId, + ownerRepo: targetRuntime?.ownerRepo || "Eve", + runtimeId: targetRuntime?.id || "world-surface-lowering", + splitTarget: targetRuntime?.splitTarget || "", + runtimeStatus: targetRuntime?.status || "", + severity: "blocker", + detail: targetRuntime + ? `splitTarget:${targetRuntime.splitTarget || ""}:status:${targetRuntime.status || ""}` + : "no-runtime-target-declared", + }); + } + } + } + return gaps; +} + async function writeConformanceExport(conformanceExport, directory) { await mkdir(path.join(directory, "packs"), { recursive: true }); await mkdir(path.join(directory, "handoffs"), { recursive: true });