Demote Unity plugin host capability gap

This commit is contained in:
Meta Vens 2026-07-09 00:18:59 +01:00
commit 92d6eedff9
4 changed files with 53 additions and 6 deletions

View file

@ -274,14 +274,14 @@ Exit criteria:
## Active Work Queue
1. Resolve or explicitly demote the Unity plugin-host capability gap so
`EveUnity` can explain whether Sai/Norn support is real runtime behavior or
still incubating proof work.
2. Prepare an `EveConformance` export layout so core, plugin, runtime, and
1. Prepare an `EveConformance` export layout so core, plugin, runtime, and
provider packs can be consumed without Eve's local source layout.
Recently cut:
- Unity's plugin-host capability gap is now explicitly demoted. The UI Toolkit
runtime owns generic projection and command requests, while Sai, Norn, and
TeX semantics remain unsupported until a real Unity plugin host exists.
- Flutter and Unity now have runtime command-transport smoke evidence in the
parity report. Flutter emits `gamecult.eve.command.v1` intents from lowered
controls, and Unity command requests now carry the same command schema.

View file

@ -7,6 +7,12 @@ It owns native projection only. Providers still own truth, accepted state,
style token values, and command effects through CultMesh/CultNet. Unknown
component kinds degrade to inert containers instead of gaining local semantics.
Plugin semantics are not hosted here yet. `sai.vn`, `norn.graph`, and
`tex.math` surfaces may pass through as generic Eve component structure, but
Unity UI Toolkit does not currently own the Sai VN stage model, Norn graph
layout, or TeX render pipeline. Those remain plugin-owned semantics until an
explicit Unity plugin host exists.
This package lives in the Eve repository as the shared Unity lowering target.
Aetheria and other Unity consumers should import it from Eve instead of
carrying local copies.

View file

@ -681,6 +681,20 @@
"requiredFixtures": ["embedded-surface"],
"pluginFixtures": ["sai-vn"],
"supportedFeatures": ["embeddedDocuments"],
"unsupportedPlugins": [
{
"pluginId": "sai.vn",
"reason": "Unity UI Toolkit currently lowers Sai VN component kinds as generic Eve containers; no Sai plugin host exists in this runtime."
},
{
"pluginId": "norn.graph",
"reason": "Unity UI Toolkit currently preserves embed.norn as generic Eve structure; no Norn graph plugin host or layout adapter exists in this runtime."
},
{
"pluginId": "tex.math",
"reason": "Unity UI Toolkit currently preserves embed.tex as generic Eve structure; no TeX render plugin host exists in this runtime."
}
],
"expectedPaths": ["packages/org.gamecult.eve.unity-uitoolkit/Runtime/EveUiToolkitSurfaceLowerer.cs"],
"expectedSourceSymbols": [
{

View file

@ -289,6 +289,7 @@ async function evaluateRuntime(runtime, fixtureResults) {
const commandTransportSmokeErrors = await validateRuntimeCommandTransportSmoke(runtime);
const missingIncubationFields = requiredIncubationFields(runtime).filter(field => !runtime[field]);
const pluginCapabilityGaps = collectPluginCapabilityGaps(runtime, fixtureResults);
const unsupportedPluginNotes = collectUnsupportedPluginNotes(runtime, fixtureResults);
let status = runtime.kind === "active" ? "active" : "pending";
if (missingPaths.length) status = "missing-body";
if (runtime.kind === "active" && missingSourceSymbols.length) status = "missing-source-symbol";
@ -322,6 +323,8 @@ async function evaluateRuntime(runtime, fixtureResults) {
missingRequiredFixtures,
supportedFeatures,
supportedPlugins,
unsupportedPlugins: runtime.unsupportedPlugins || [],
unsupportedPluginNotes,
missingRequiredFeatures,
commandTransportSmoke: runtime.commandTransportSmoke || null,
commandTransportSmokeErrors,
@ -742,6 +745,7 @@ function matchesSchemaType(value, type) {
function collectPluginCapabilityGaps(runtime, fixtureResults) {
const supported = new Map((runtime.supportedPlugins || []).map(plugin => [plugin.pluginId, new Set(plugin.capabilities || [])]));
const unsupported = new Map((runtime.unsupportedPlugins || []).map(plugin => [plugin.pluginId, plugin.reason || "unsupported"]));
const fixtureById = new Map((manifest.fixtures || []).map(fixture => [fixture.id, fixture]));
const gaps = [];
const fixtureIds = [...new Set([...(runtime.requiredFixtures || []), ...(runtime.pluginFixtures || [])])];
@ -750,6 +754,7 @@ function collectPluginCapabilityGaps(runtime, fixtureResults) {
if (!fixtureResult || fixtureResult.status !== "pass") continue;
const fixture = fixtureById.get(fixtureId);
for (const requirement of fixture?.requiredPlugins || []) {
if (unsupported.has(requirement.pluginId)) continue;
const capabilities = supported.get(requirement.pluginId);
if (!capabilities) {
gaps.push(`${fixtureId}:${requirement.pluginId}`);
@ -763,6 +768,23 @@ function collectPluginCapabilityGaps(runtime, fixtureResults) {
return gaps;
}
function collectUnsupportedPluginNotes(runtime, fixtureResults) {
const unsupported = new Map((runtime.unsupportedPlugins || []).map(plugin => [plugin.pluginId, plugin.reason || "unsupported"]));
const fixtureById = new Map((manifest.fixtures || []).map(fixture => [fixture.id, fixture]));
const notes = [];
const fixtureIds = [...new Set([...(runtime.requiredFixtures || []), ...(runtime.pluginFixtures || [])])];
for (const fixtureId of fixtureIds) {
const fixtureResult = fixtureResults.find(fixture => fixture.id === fixtureId);
if (!fixtureResult || fixtureResult.status !== "pass") continue;
const fixture = fixtureById.get(fixtureId);
for (const requirement of fixture?.requiredPlugins || []) {
const reason = unsupported.get(requirement.pluginId);
if (reason) notes.push(`${fixtureId}:${requirement.pluginId}:${reason}`);
}
}
return notes;
}
async function validateRuntimeCommandTransportSmoke(runtime) {
const smoke = runtime.commandTransportSmoke;
if (!smoke) return [];
@ -822,7 +844,12 @@ function evaluateSplitTargets(splitTargets, runtimeResults) {
}
const supportedPlugins = new Map(runtime.supportedPlugins.map(plugin => [plugin.pluginId, new Set(plugin.capabilities || [])]));
const unsupportedPlugins = new Map((runtime.unsupportedPlugins || []).map(plugin => [plugin.pluginId, plugin.reason || "unsupported"]));
for (const requirement of requiredPlugins) {
if (unsupportedPlugins.has(requirement.pluginId)) {
blockers.push(`runtime:${runtimeId}:unsupported-plugin:${requirement.pluginId}:${unsupportedPlugins.get(requirement.pluginId)}`);
continue;
}
const capabilities = supportedPlugins.get(requirement.pluginId);
if (!capabilities) {
blockers.push(`runtime:${runtimeId}:plugin:${requirement.pluginId}`);
@ -1077,7 +1104,7 @@ function renderMarkdown(report) {
lines.push(`| ${provider.title || provider.providerId} | ${provider.status} | ${provider.ownerRepo} | ${provider.scenarioId || ""} | ${provider.scenarioReceiptStates.join(", ")} | ${provider.surfaceIds.join(", ")} | ${provider.commandIds.join(", ")} | ${provider.witnessKinds.join(", ")} | ${missing} |`);
}
lines.push("", "## Runtimes", "", "| Runtime | Status | Owner | Capture | Command Smoke | Required Fixtures | Plugin Fixtures | Features | Plugin Gaps | Missing |", "| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |");
lines.push("", "## Runtimes", "", "| Runtime | Status | Owner | Capture | Command Smoke | Required Fixtures | Plugin Fixtures | Features | Plugin Gaps | Unsupported Plugins | Missing |", "| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |");
for (const runtime of report.runtimes) {
const missing = [
...runtime.missingPaths,
@ -1089,7 +1116,7 @@ function renderMarkdown(report) {
...runtime.commandTransportSmokeErrors.map(id => `command-smoke:${id}`),
...runtime.missingIncubationFields.map(id => `metadata:${id}`),
].join(", ");
lines.push(`| ${runtime.title} | ${runtime.status} | ${runtime.ownerRepo} | ${runtime.capture?.status || "unknown"} | ${runtime.commandTransportSmoke?.schema || ""} | ${runtime.requiredFixtures.join(", ")} | ${runtime.pluginFixtures.join(", ")} | ${runtime.supportedFeatures.join(", ")} | ${runtime.pluginCapabilityGaps.join(", ")} | ${missing} |`);
lines.push(`| ${runtime.title} | ${runtime.status} | ${runtime.ownerRepo} | ${runtime.capture?.status || "unknown"} | ${runtime.commandTransportSmoke?.schema || ""} | ${runtime.requiredFixtures.join(", ")} | ${runtime.pluginFixtures.join(", ")} | ${runtime.supportedFeatures.join(", ")} | ${runtime.pluginCapabilityGaps.join(", ")} | ${runtime.unsupportedPluginNotes.join(", ")} | ${missing} |`);
}
lines.push("", "## Split Readiness", "", "| Target | Status | Owner | Runtimes | Blockers |", "| --- | --- | --- | --- | --- |");