diff --git a/docs/eve-migration-roadmap.md b/docs/eve-migration-roadmap.md index 1d8e7c6..a919fb9 100644 --- a/docs/eve-migration-roadmap.md +++ b/docs/eve-migration-roadmap.md @@ -280,6 +280,12 @@ Exit criteria: Recently cut: +- The web reference no longer hardcodes the local provider list in + `web/surface.js`. It loads `web/local-provider-catalog.json`, then opens + advertisement-backed entries for Aetheria, Repixelizer, and Sai through the + same `loadProviderAdvertisement` path used by the provider picker. Fixture-only + surfaces remain explicit local catalog entries until they gain provider + advertisements or move into their owner packs. - Provider advertisements can now name sidecar plugin requirements per surface with `surfaces[].requiresPlugins[]`. The parity harness validates those requirements against known plugin manifests, exports them in the conformance diff --git a/docs/renderer-parity.md b/docs/renderer-parity.md index be477cd..7d1a634 100644 --- a/docs/renderer-parity.md +++ b/docs/renderer-parity.md @@ -47,15 +47,20 @@ provider picker: - `Repixelizer`: loads `web/fixtures/repixelizer.provider-advertisement.json` and `web/fixtures/repixelizer.eve-surface.json`. +- `Aetheria`: loads `web/fixtures/aetheria.provider-advertisement.json` + and `web/fixtures/aetheria-world-surface.json`. +- `Sai VN Surface`: loads `web/fixtures/sai-vn.provider-advertisement.json` + and `web/fixtures/sai-vn-surface.json`. - `Fensalir Direct2D`: loads `web/fixtures/fensalir-client-surface.json`, a recorded surface describing the Direct2D client lowering path. -- `Sai VN Surface`: loads `web/fixtures/sai-vn-surface.json`. - `Huginn .cc`: compiles `web/fixtures/huginn-cc-surface.eve`. - `Reactive DSL`: compiles `web/fixtures/reactive-composition.eve`. - `CultUI Inspector`: compiles `web/fixtures/cultui-slider-inspector.eve` and proves partition/field-row/slider-anatomy lowering in the web reference. -The remaining temporary part is the local fixture provider list itself. The +The local fallback provider list now lives in `web/local-provider-catalog.json` +instead of renderer code. That catalog is fixture discovery data for the browser +oracle; live discovery still belongs to CultMesh/Odin advertisements. The runtime app target is the same picker fed by live `gamecult.eve.provider_advertisement.v1` documents through CultMesh/Odin; the browser reference no longer opens live providers by dialing Mimir's deck broker diff --git a/docs/runtime-app-parity-roadmap.md b/docs/runtime-app-parity-roadmap.md index bf394a9..f0200a2 100644 --- a/docs/runtime-app-parity-roadmap.md +++ b/docs/runtime-app-parity-roadmap.md @@ -133,6 +133,8 @@ First cuts: - Replace hardcoded tabs with a provider picker. - Represent existing fixtures as provider advertisements. +- Load fallback provider entries from `web/local-provider-catalog.json` so + local discovery data stays out of renderer code. - Add Repixelizer fixture loading from `docs/fixtures/repixelizer.eve-surface.json`. - Map the full Repixelizer style token set to CSS variables. - Add screenshot capture for the Repixelizer first viewport and main app diff --git a/tools/parity/parity-manifest.json b/tools/parity/parity-manifest.json index 2fb1e54..22c21e2 100644 --- a/tools/parity/parity-manifest.json +++ b/tools/parity/parity-manifest.json @@ -464,6 +464,15 @@ "requiredFixtures": ["embedded-surface"], "pluginFixtures": ["sai-vn"], "supportedFeatures": ["embeddedDocuments", "providerAdvertisements", "stateBindings", "styleTokens", "authorityWitnesses"], + "localProviderCatalog": { + "path": "web/local-provider-catalog.json", + "requiredProviders": ["aetheria", "repixelizer", "gamecult.home.vn"], + "requiredAdvertisements": [ + "web/fixtures/aetheria.provider-advertisement.json", + "web/fixtures/repixelizer.provider-advertisement.json", + "web/fixtures/sai-vn.provider-advertisement.json" + ] + }, "supportedPlugins": [ { "pluginId": "sai.vn", @@ -481,7 +490,11 @@ "expectedSourceSymbols": [ { "path": "web/surface.js", - "contains": ["loadProviderAdvertisement", "aetheria.provider-advertisement.json", "publishCommandIntent", "browser.reference"] + "contains": ["loadLocalProviderCatalog", "loadProviderAdvertisement", "publishCommandIntent", "browser.reference"] + }, + { + "path": "web/local-provider-catalog.json", + "contains": ["aetheria.provider-advertisement.json", "repixelizer.provider-advertisement.json", "sai-vn.provider-advertisement.json"] }, { "path": "packages/eve-browser-lowering/src/index.ts", diff --git a/tools/parity/run-parity.mjs b/tools/parity/run-parity.mjs index cda82df..1f2eca8 100644 --- a/tools/parity/run-parity.mjs +++ b/tools/parity/run-parity.mjs @@ -303,6 +303,7 @@ async function evaluateRuntime(runtime, fixtureResults) { } const commandTransportSmokeErrors = await validateRuntimeCommandTransportSmoke(runtime); const capabilityManifestErrors = await validateRuntimeCapabilityManifest(runtime); + const localProviderCatalogErrors = await validateRuntimeLocalProviderCatalog(runtime); const missingIncubationFields = requiredIncubationFields(runtime).filter(field => !runtime[field]); const pluginCapabilityGaps = collectPluginCapabilityGaps(runtime, fixtureResults); const unsupportedPluginNotes = collectUnsupportedPluginNotes(runtime, fixtureResults); @@ -313,6 +314,7 @@ async function evaluateRuntime(runtime, fixtureResults) { if (runtime.kind === "active" && missingRequiredFeatures.length) status = "missing-required-feature"; if (runtime.kind === "active" && commandTransportSmokeErrors.length) status = "missing-command-transport-smoke"; if (runtime.kind === "active" && capabilityManifestErrors.length) status = "invalid-runtime-capability"; + if (runtime.kind === "active" && localProviderCatalogErrors.length) status = "invalid-local-provider-catalog"; if (runtime.kind === "active" && missingIncubationFields.length) status = "missing-incubation-metadata"; if (runtime.kind === "active" && pluginCapabilityGaps.length && status === "active") status = "active-with-capability-gaps"; if (runtime.kind === "pending" && runtime.adapterSpike === "external" && !missingExternalPaths.length && !missingExternalSourceSymbols.length) { @@ -347,6 +349,8 @@ async function evaluateRuntime(runtime, fixtureResults) { commandTransportSmokeErrors, capabilityManifest: runtime.capabilityManifest || null, capabilityManifestErrors, + localProviderCatalog: runtime.localProviderCatalog || null, + localProviderCatalogErrors, lifecycle: runtime.lifecycle || null, ownerRepo: runtime.ownerRepo || "", repoRole: runtime.repoRole || "", @@ -361,6 +365,56 @@ async function evaluateRuntime(runtime, fixtureResults) { }; } +async function validateRuntimeLocalProviderCatalog(runtime) { + const catalogConfig = runtime.localProviderCatalog; + if (!catalogConfig) return []; + + const errors = []; + const catalogPath = catalogConfig.path || ""; + const absolutePath = path.join(repoRoot, catalogPath); + if (!existsSync(absolutePath)) return [`${catalogPath}:missing`]; + + let catalog; + try { + catalog = JSON.parse(await readFile(absolutePath, "utf8")); + } catch (error) { + return [`${catalogPath}:invalid-json:${error instanceof Error ? error.message : String(error)}`]; + } + + const providers = Array.isArray(catalog.providers) ? catalog.providers : []; + const providerIds = new Set(providers.map(provider => provider.providerId).filter(Boolean)); + for (const providerId of catalogConfig.requiredProviders || []) { + if (!providerIds.has(providerId)) errors.push(`${catalogPath}:provider:${providerId}:missing`); + } + + const catalogDirectory = path.posix.dirname(normalizePath(catalogPath)); + const advertisedPaths = new Set(providers + .map(provider => resolveCatalogPath(catalogDirectory, provider.advertisement || "")) + .filter(Boolean)); + for (const advertisementPath of catalogConfig.requiredAdvertisements || []) { + const normalized = normalizePath(advertisementPath); + if (!advertisedPaths.has(normalized)) { + errors.push(`${catalogPath}:advertisement:${advertisementPath}:unreferenced`); + } + if (!existsSync(path.join(repoRoot, advertisementPath))) { + errors.push(`${advertisementPath}:missing`); + } + } + + return errors; +} + +function normalizePath(candidate) { + return candidate.replaceAll("\\", "/").replace(/^\.\//, ""); +} + +function resolveCatalogPath(catalogDirectory, candidate) { + const normalized = normalizePath(candidate); + if (!normalized) return ""; + if (/^(https?:|\/)/i.test(normalized)) return normalized; + return path.posix.normalize(path.posix.join(catalogDirectory, normalized)); +} + async function evaluatePlugin(plugin, fixtureResults) { const expectedPaths = plugin.expectedPaths || []; const missingPaths = expectedPaths.filter(candidate => !existsSync(path.join(repoRoot, candidate))); @@ -1243,13 +1297,14 @@ function buildConformanceExport(report) { capabilityManifestPath: runtime.capabilityManifest?.manifestPath || "", commandTransportSchema: runtime.commandTransportSmoke?.schema || "", captureStatus: runtime.capture?.status || "", - lifecycle: runtime.lifecycle, - missingEvidence: [ + lifecycle: runtime.lifecycle, + missingEvidence: [ ...runtime.missingPaths, ...runtime.missingRequiredFixtures.map(id => `fixture:${id}`), ...runtime.missingRequiredFeatures.map(id => `feature:${id}`), ...runtime.commandTransportSmokeErrors.map(id => `command-smoke:${id}`), ...runtime.capabilityManifestErrors.map(id => `runtime-capability:${id}`), + ...runtime.localProviderCatalogErrors.map(id => `local-provider-catalog:${id}`), ], })) : []; @@ -1464,6 +1519,7 @@ function renderMarkdown(report) { ...runtime.missingRequiredFeatures.map(id => `feature:${id}`), ...runtime.commandTransportSmokeErrors.map(id => `command-smoke:${id}`), ...runtime.capabilityManifestErrors.map(id => `runtime-capability:${id}`), + ...runtime.localProviderCatalogErrors.map(id => `local-provider-catalog:${id}`), ...runtime.missingIncubationFields.map(id => `metadata:${id}`), ].join(", "); lines.push(`| ${runtime.title} | ${runtime.status} | ${runtime.ownerRepo} | ${summarizeLifecycle(runtime.lifecycle)} | ${runtime.capture?.status || "unknown"} | ${runtime.commandTransportSmoke?.schema || ""} | ${runtime.requiredFixtures.join(", ")} | ${runtime.pluginFixtures.join(", ")} | ${runtime.supportedFeatures.join(", ")} | ${runtime.pluginCapabilityGaps.join(", ")} | ${runtime.unsupportedPluginNotes.join(", ")} | ${missing} |`); diff --git a/web/local-provider-catalog.json b/web/local-provider-catalog.json new file mode 100644 index 0000000..f0a5a9e --- /dev/null +++ b/web/local-provider-catalog.json @@ -0,0 +1,124 @@ +{ + "schema": "gamecult.eve.local_provider_catalog.v1", + "purpose": "Browser reference fallback catalog for local provider advertisements and fixture surfaces. This is not live discovery truth.", + "providers": [ + { + "providerId": "aetheria", + "title": "Aetheria", + "kind": "game.runtime", + "advertisement": "./fixtures/aetheria.provider-advertisement.json", + "surfaces": [ + { + "transport": "local-json", + "surfaceId": "aetheria.daemon.game", + "url": "./fixtures/aetheria-world-surface.json" + } + ] + }, + { + "providerId": "repixelizer", + "title": "Repixelizer", + "kind": "service.product", + "advertisement": "./fixtures/repixelizer.provider-advertisement.json", + "surfaces": [ + { + "transport": "local-json", + "surfaceId": "repixelizer.operator.surface", + "url": "./fixtures/repixelizer.eve-surface.json" + } + ] + }, + { + "providerId": "gamecult.home.vn", + "aliases": ["sai.visual_novel", "sai-vn"], + "title": "Sai VN Surface", + "kind": "content.runtime", + "advertisement": "./fixtures/sai-vn.provider-advertisement.json", + "surfaces": [ + { + "transport": "local-json", + "surfaceId": "sai.visual_novel.surface", + "url": "./fixtures/sai-vn-surface.json" + } + ] + }, + { + "providerId": "fensalir.direct2d", + "title": "Fensalir Direct2D", + "kind": "surface.renderer", + "freshness": { "state": "fixture" }, + "surfaces": [ + { + "transport": "local-json", + "surfaceId": "fensalir.direct2d.fixture", + "url": "./fixtures/fensalir-client-surface.json" + } + ] + }, + { + "providerId": "cultcache.huginn.inspector", + "title": "Huginn .cc", + "kind": "inspection.huginn", + "freshness": { "state": "fixture" }, + "surfaces": [ + { + "transport": "local-eve-dsl", + "surfaceId": "cultcache.huginn.inspector", + "url": "./fixtures/huginn-cc-surface.eve" + } + ] + }, + { + "providerId": "eve.reactive.dsl", + "title": "Reactive DSL", + "kind": "surface.fixture", + "freshness": { "state": "fixture" }, + "surfaces": [ + { + "transport": "local-eve-dsl", + "surfaceId": "eve.reactive.dsl", + "url": "./fixtures/reactive-composition.eve" + } + ] + }, + { + "providerId": "gamecult.eve.authority-witness", + "title": "Authority Witness", + "kind": "surface.fixture", + "freshness": { "state": "fixture" }, + "surfaces": [ + { + "transport": "local-json", + "surfaceId": "gamecult.eve.authority-witness", + "url": "./fixtures/authority-staleness-witness.json" + } + ] + }, + { + "providerId": "eve.cultui.inspector", + "title": "CultUI Inspector", + "kind": "surface.fixture", + "freshness": { "state": "fixture" }, + "surfaces": [ + { + "transport": "local-eve-dsl", + "surfaceId": "eve.cultui.inspector", + "url": "./fixtures/cultui-slider-inspector.eve" + } + ] + }, + { + "providerId": "gamecult.eve.embedded-demo", + "title": "Embedded Surface Slot", + "kind": "surface.fixture", + "freshness": { "state": "fixture" }, + "surfaces": [ + { + "transport": "local-json", + "surfaceId": "gamecult.eve.embedded-demo", + "url": "./fixtures/cultui-embedded-surface.json" + } + ] + } + ] +} diff --git a/web/surface.js b/web/surface.js index fd9c92b..fcd2384 100644 --- a/web/surface.js +++ b/web/surface.js @@ -17,73 +17,6 @@ let currentProvider; let liveHermodr = false; let openProviderGeneration = 0; -const localProviders = [ - { - providerId: "aetheria", - title: "Aetheria", - kind: "game.runtime", - advertisement: "./fixtures/aetheria.provider-advertisement.json", - surfaces: [{ transport: "local-json", surfaceId: "aetheria.daemon.game", url: "./fixtures/aetheria-world-surface.json" }], - }, - { - providerId: "repixelizer", - title: "Repixelizer", - kind: "service.product", - advertisement: "./fixtures/repixelizer.provider-advertisement.json", - surfaces: [{ transport: "local-json", surfaceId: "repixelizer.operator.surface", url: "./fixtures/repixelizer.eve-surface.json" }], - }, - { - providerId: "fensalir.direct2d", - title: "Fensalir Direct2D", - kind: "surface.renderer", - freshness: { state: "fixture" }, - surfaces: [{ transport: "local-json", surfaceId: "fensalir.direct2d.fixture", url: "./fixtures/fensalir-client-surface.json" }], - }, - { - providerId: "sai.visual_novel", - aliases: ["gamecult.home.vn", "sai-vn"], - title: "Sai VN Surface", - kind: "content.runtime", - freshness: { state: "fixture" }, - surfaces: [{ transport: "local-json", surfaceId: "sai.visual_novel.surface", url: "./fixtures/sai-vn-surface.json" }], - }, - { - providerId: "cultcache.huginn.inspector", - title: "Huginn .cc", - kind: "inspection.huginn", - freshness: { state: "fixture" }, - surfaces: [{ transport: "local-eve-dsl", surfaceId: "cultcache.huginn.inspector", url: "./fixtures/huginn-cc-surface.eve" }], - }, - { - providerId: "eve.reactive.dsl", - title: "Reactive DSL", - kind: "surface.fixture", - freshness: { state: "fixture" }, - surfaces: [{ transport: "local-eve-dsl", surfaceId: "eve.reactive.dsl", url: "./fixtures/reactive-composition.eve" }], - }, - { - providerId: "gamecult.eve.authority-witness", - title: "Authority Witness", - kind: "surface.fixture", - freshness: { state: "fixture" }, - surfaces: [{ transport: "local-json", surfaceId: "gamecult.eve.authority-witness", url: "./fixtures/authority-staleness-witness.json" }], - }, - { - providerId: "eve.cultui.inspector", - title: "CultUI Inspector", - kind: "surface.fixture", - freshness: { state: "fixture" }, - surfaces: [{ transport: "local-eve-dsl", surfaceId: "eve.cultui.inspector", url: "./fixtures/cultui-slider-inspector.eve" }], - }, - { - providerId: "gamecult.eve.embedded-demo", - title: "Embedded Surface Slot", - kind: "surface.fixture", - freshness: { state: "fixture" }, - surfaces: [{ transport: "local-json", surfaceId: "gamecult.eve.embedded-demo", url: "./fixtures/cultui-embedded-surface.json" }], - }, -]; - providerSelect.addEventListener("change", () => { const provider = providers.find(candidate => candidate.providerId === providerSelect.value); if (provider) void openProvider(provider); @@ -96,7 +29,7 @@ async function bootProviders() { if (providers.length) { liveHermodr = true; } else { - providers = await Promise.all(localProviders.map(loadProviderAdvertisement)); + providers = await Promise.all((await loadLocalProviderCatalog()).map(loadProviderAdvertisement)); } providerSelect.replaceChildren(...providers.map(provider => { const option = document.createElement("option"); @@ -115,6 +48,12 @@ async function bootProviders() { await openProvider(firstProduct); } +async function loadLocalProviderCatalog() { + const response = await fetch("./local-provider-catalog.json", { cache: "no-store" }); + const catalog = await response.json(); + return catalog.providers || []; +} + async function loadHermodrProviders() { try { const response = await fetch("/hermodr/verse/catalog", { cache: "no-store" });