Initial EveTui runtime
This commit is contained in:
Meta Vens
commit
b01f481483
23 changed files with 2159 additions and 0 deletions
48
.github/workflows/runtime.yml
vendored
Normal file
48
.github/workflows/runtime.yml
vendored
Normal file
|
|
@ -0,0 +1,48 @@
|
||||||
|
name: EveTui runtime
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
workflow_dispatch:
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
contents: read
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test-and-pack:
|
||||||
|
runs-on: windows-latest
|
||||||
|
env:
|
||||||
|
GIT_LFS_SKIP_SMUDGE: "1"
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v7
|
||||||
|
with:
|
||||||
|
path: EveTui
|
||||||
|
|
||||||
|
- uses: actions/checkout@v7
|
||||||
|
with:
|
||||||
|
repository: GameCult/Eve
|
||||||
|
path: Eve
|
||||||
|
|
||||||
|
- uses: actions/checkout@v7
|
||||||
|
with:
|
||||||
|
repository: GameCult/Aetheria
|
||||||
|
path: Aetheria
|
||||||
|
lfs: false
|
||||||
|
|
||||||
|
- name: Verify runtime lifecycle
|
||||||
|
working-directory: EveTui
|
||||||
|
shell: powershell
|
||||||
|
run: .\scripts\run-evetui-lifecycle-smoke.ps1
|
||||||
|
|
||||||
|
- name: Pack runtime
|
||||||
|
working-directory: EveTui
|
||||||
|
shell: powershell
|
||||||
|
run: |
|
||||||
|
New-Item -ItemType Directory -Force artifacts\release | Out-Null
|
||||||
|
npm pack --pack-destination artifacts\release
|
||||||
|
|
||||||
|
- name: Upload runtime package
|
||||||
|
uses: actions/upload-artifact@v7
|
||||||
|
with:
|
||||||
|
name: eve-tui-${{ github.sha }}
|
||||||
|
path: EveTui/artifacts/release/*.tgz
|
||||||
|
if-no-files-found: error
|
||||||
2
.gitignore
vendored
Normal file
2
.gitignore
vendored
Normal file
|
|
@ -0,0 +1,2 @@
|
||||||
|
artifacts/
|
||||||
|
node_modules/
|
||||||
15
README.md
Normal file
15
README.md
Normal file
|
|
@ -0,0 +1,15 @@
|
||||||
|
# EveTui
|
||||||
|
|
||||||
|
EveTui is the provider-agnostic compact terminal lowerer for Eve surfaces. It
|
||||||
|
consumes provider advertisements and surface documents, emits typed command
|
||||||
|
intents through provider-owned boundaries, and publishes terminal-grid capture
|
||||||
|
evidence without owning provider state or plugin semantics.
|
||||||
|
|
||||||
|
Eve owns the surface contract. EveTui owns terminal projection, package and test
|
||||||
|
lifecycle, and capture artifacts. Providers remain the only writers of live
|
||||||
|
state.
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
npm test
|
||||||
|
powershell -ExecutionPolicy Bypass -File .\scripts\run-evetui-lifecycle-smoke.ps1
|
||||||
|
```
|
||||||
20
conformance/captures/aetheria/capture-request.json
Normal file
20
conformance/captures/aetheria/capture-request.json
Normal file
|
|
@ -0,0 +1,20 @@
|
||||||
|
{
|
||||||
|
"schema": "gamecult.eve.runtime_capture_request.v1",
|
||||||
|
"runtimeId": "tui",
|
||||||
|
"ownerRepo": "EveTui",
|
||||||
|
"providerId": "aetheria",
|
||||||
|
"surfaceId": "aetheria.daemon.game",
|
||||||
|
"surfaceKind": "interactive-world",
|
||||||
|
"targetId": "tui",
|
||||||
|
"projectionKind": "provider-authored-world-surface",
|
||||||
|
"commandBoundary": "aetheria.daemon.commands",
|
||||||
|
"receiptSchema": "aetheria.eve_command_acceptance_status.v1",
|
||||||
|
"captureKind": "terminal-cell-grid",
|
||||||
|
"artifactKind": "json-grid",
|
||||||
|
"artifactPath": "artifacts/evetui-capture/latest/tui-grid.json",
|
||||||
|
"conformanceAttachment": "runtime.captureArtifacts[]",
|
||||||
|
"authority": "Capture observes terminal projection only; provider state, command acceptance, and receipts stay provider-owned.",
|
||||||
|
"sourceAdvertisementPath": "E:\\Projects\\Eve\\..\\Aetheria\\conformance\\eve\\aetheria.provider-advertisement.json",
|
||||||
|
"sourceCapabilityManifestPath": "E:\\Projects\\Eve\\runtimes\\incubating\\eve-tui\\eve-runtime-capability.json",
|
||||||
|
"issuedAtUtc": "latest"
|
||||||
|
}
|
||||||
40
conformance/captures/aetheria/tui-grid.json
Normal file
40
conformance/captures/aetheria/tui-grid.json
Normal file
|
|
@ -0,0 +1,40 @@
|
||||||
|
{
|
||||||
|
"schema": "gamecult.eve.tui_grid.v1",
|
||||||
|
"runtimeId": "tui",
|
||||||
|
"providerId": "aetheria",
|
||||||
|
"surfaceId": "aetheria.daemon.game",
|
||||||
|
"projectionKind": "provider-authored-world-surface",
|
||||||
|
"commandBoundary": "aetheria.daemon.commands",
|
||||||
|
"receiptSchema": "aetheria.eve_command_acceptance_status.v1",
|
||||||
|
"ownership": "provider-owns-world-state-assets-command-acceptance-and-receipts",
|
||||||
|
"width": 80,
|
||||||
|
"lines": [
|
||||||
|
"EveTui aetheria",
|
||||||
|
"surface aetheria.daemon.game",
|
||||||
|
"command aetheria.daemon.commands",
|
||||||
|
"receipt aetheria.eve_command_acceptance_status.v1",
|
||||||
|
"surface aetheria.daemon.game.root",
|
||||||
|
" card aetheria.daemon.game.summary Daemon World",
|
||||||
|
" text aetheria.daemon.game.summary.text Provider-owned world state project...",
|
||||||
|
" metric aetheria.daemon.game.frame Frame",
|
||||||
|
" partition aetheria.daemon.game.partition",
|
||||||
|
" world aetheria.daemon.game.playable Daemon ARPG View",
|
||||||
|
" world aetheria.daemon.game.entity.player Vanguard",
|
||||||
|
" world aetheria.daemon.game.entity.raider Raider Scout",
|
||||||
|
" world aetheria.daemon.game.entity.station Anchor Station",
|
||||||
|
" world aetheria.daemon.game.flow Volumetric Flow",
|
||||||
|
" world aetheria.daemon.game.gravity Current Zone Gravity",
|
||||||
|
" card aetheria.daemon.game.commands Command Boundary",
|
||||||
|
" command aetheria.daemon.game.command.focus Focus Relay",
|
||||||
|
" command aetheria.daemon.game.command.move Issue Move Intent",
|
||||||
|
" text aetheria.daemon.game.authority Commands are intents against Aether..."
|
||||||
|
],
|
||||||
|
"embeddedDocumentSlots": [],
|
||||||
|
"pluginProjections": [],
|
||||||
|
"lossiness": "terminal-grid-command-surface; summarizes provider-authored world surface without owning provider state",
|
||||||
|
"artifactKind": "json-grid",
|
||||||
|
"captureKind": "terminal-cell-grid",
|
||||||
|
"sourceAdvertisementPath": "E:\\Projects\\Eve\\..\\Aetheria\\conformance\\eve\\aetheria.provider-advertisement.json",
|
||||||
|
"sourceCapabilityManifestPath": "E:\\Projects\\Eve\\runtimes\\incubating\\eve-tui\\eve-runtime-capability.json",
|
||||||
|
"issuedAtUtc": "latest"
|
||||||
|
}
|
||||||
20
conformance/captures/world-smoke/capture-request.json
Normal file
20
conformance/captures/world-smoke/capture-request.json
Normal file
|
|
@ -0,0 +1,20 @@
|
||||||
|
{
|
||||||
|
"schema": "gamecult.eve.runtime_capture_request.v1",
|
||||||
|
"runtimeId": "tui",
|
||||||
|
"ownerRepo": "EveTui",
|
||||||
|
"providerId": "eve.world-smoke",
|
||||||
|
"surfaceId": "eve.world-smoke.surface",
|
||||||
|
"surfaceKind": "interactive-world",
|
||||||
|
"targetId": "tui",
|
||||||
|
"projectionKind": "provider-authored-world-surface",
|
||||||
|
"commandBoundary": "eve.world-smoke.commands",
|
||||||
|
"receiptSchema": "eve.world_smoke.command_receipt.v1",
|
||||||
|
"captureKind": "terminal-cell-grid",
|
||||||
|
"artifactKind": "json-grid",
|
||||||
|
"artifactPath": "artifacts/evetui-capture/latest/tui-grid.json",
|
||||||
|
"conformanceAttachment": "runtime.captureArtifacts[]",
|
||||||
|
"authority": "Capture observes terminal projection only; provider state, command acceptance, and receipts stay provider-owned.",
|
||||||
|
"sourceAdvertisementPath": "E:\\Projects\\Eve\\web\\fixtures\\eve-world-smoke.provider-advertisement.json",
|
||||||
|
"sourceCapabilityManifestPath": "E:\\Projects\\Eve\\runtimes\\incubating\\eve-tui\\eve-runtime-capability.json",
|
||||||
|
"issuedAtUtc": "latest"
|
||||||
|
}
|
||||||
33
conformance/captures/world-smoke/tui-grid.json
Normal file
33
conformance/captures/world-smoke/tui-grid.json
Normal file
|
|
@ -0,0 +1,33 @@
|
||||||
|
{
|
||||||
|
"schema": "gamecult.eve.tui_grid.v1",
|
||||||
|
"runtimeId": "tui",
|
||||||
|
"providerId": "eve.world-smoke",
|
||||||
|
"surfaceId": "eve.world-smoke.surface",
|
||||||
|
"projectionKind": "provider-authored-world-surface",
|
||||||
|
"commandBoundary": "eve.world-smoke.commands",
|
||||||
|
"receiptSchema": "eve.world_smoke.command_receipt.v1",
|
||||||
|
"ownership": "provider-owns-world-state-and-command-receipts",
|
||||||
|
"width": 80,
|
||||||
|
"lines": [
|
||||||
|
"EveTui eve.world-smoke",
|
||||||
|
"surface eve.world-smoke.surface",
|
||||||
|
"command eve.world-smoke.commands",
|
||||||
|
"receipt eve.world_smoke.command_receipt.v1",
|
||||||
|
"surface eve.world-smoke.root",
|
||||||
|
" card eve.world-smoke.summary World Contract Control",
|
||||||
|
" text eve.world-smoke.summary.text A tiny provider-owned world surface use...",
|
||||||
|
" metric eve.world-smoke.tick Tick",
|
||||||
|
" world eve.world-smoke.field Contract Field",
|
||||||
|
" card eve.world-smoke.commands Command Boundary",
|
||||||
|
" command eve.world-smoke.command.focus Focus Beacon",
|
||||||
|
" text eve.world-smoke.authority The provider owns accepted state and recei..."
|
||||||
|
],
|
||||||
|
"embeddedDocumentSlots": [],
|
||||||
|
"pluginProjections": [],
|
||||||
|
"lossiness": "terminal-grid-command-surface; summarizes provider-authored world surface without owning provider state",
|
||||||
|
"artifactKind": "json-grid",
|
||||||
|
"captureKind": "terminal-cell-grid",
|
||||||
|
"sourceAdvertisementPath": "E:\\Projects\\Eve\\web\\fixtures\\eve-world-smoke.provider-advertisement.json",
|
||||||
|
"sourceCapabilityManifestPath": "E:\\Projects\\Eve\\runtimes\\incubating\\eve-tui\\eve-runtime-capability.json",
|
||||||
|
"issuedAtUtc": "latest"
|
||||||
|
}
|
||||||
195
eve-runtime-capability.json
Normal file
195
eve-runtime-capability.json
Normal file
|
|
@ -0,0 +1,195 @@
|
||||||
|
{
|
||||||
|
"schema": "gamecult.eve.runtime_capability.v1",
|
||||||
|
"runtimeId": "tui",
|
||||||
|
"title": "Compact TUI",
|
||||||
|
"owner": "EveTui",
|
||||||
|
"incubation": {
|
||||||
|
"status": "graduated",
|
||||||
|
"ownerRepo": "EveTui",
|
||||||
|
"currentHostRepo": "EveTui",
|
||||||
|
"splitTarget": "EveTui",
|
||||||
|
"graduationTrigger": "Graduated: EveTui owns package, tests, terminal lowering, command transport, lifecycle, and capture evidence."
|
||||||
|
},
|
||||||
|
"supportedFeatures": [
|
||||||
|
"providerAdvertisements",
|
||||||
|
"commandTransport",
|
||||||
|
"terminalGridSummary",
|
||||||
|
"terminalGridLowering",
|
||||||
|
"embeddedDocuments",
|
||||||
|
"pluginProjection"
|
||||||
|
],
|
||||||
|
"supportedPlugins": [
|
||||||
|
{
|
||||||
|
"pluginId": "sai.vn",
|
||||||
|
"capabilities": [
|
||||||
|
"vn.stage",
|
||||||
|
"story.choose",
|
||||||
|
"story.continue",
|
||||||
|
"story.jump"
|
||||||
|
],
|
||||||
|
"projectionAdapter": "EveTuiShell.buildPluginProjection",
|
||||||
|
"lossiness": "terminal-summary"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"pluginId": "norn.graph",
|
||||||
|
"capabilities": [
|
||||||
|
"embed.norn"
|
||||||
|
],
|
||||||
|
"projectionAdapter": "EveTuiShell.buildPluginProjection",
|
||||||
|
"lossiness": "terminal-outline"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"pluginId": "tex.math",
|
||||||
|
"capabilities": [
|
||||||
|
"embed.tex",
|
||||||
|
"tex.inline",
|
||||||
|
"tex.block"
|
||||||
|
],
|
||||||
|
"projectionAdapter": "EveTuiShell.buildPluginProjection",
|
||||||
|
"lossiness": "source-text"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"unsupportedPlugins": [],
|
||||||
|
"worldSurfaceLowering": [
|
||||||
|
{
|
||||||
|
"targetId": "tui",
|
||||||
|
"surfaceKinds": ["interactive-world", "interactive-world-editor"],
|
||||||
|
"projectionKinds": ["provider-authored-world-surface", "provider-authored-world-editor-surface"],
|
||||||
|
"supportLevel": "terminal-grid-command-surface",
|
||||||
|
"ownership": "runtime-lowers-provider-world-surface-without-owning-world-state",
|
||||||
|
"lossiness": "terminal-grid-summary-only",
|
||||||
|
"evidencePaths": [
|
||||||
|
"src/eve-tui-shell.mjs",
|
||||||
|
"test/eve-tui-shell.test.mjs",
|
||||||
|
"../Eve/web/fixtures/sai-vn-surface.json",
|
||||||
|
"../Aetheria/conformance/eve/aetheria.provider-advertisement.json",
|
||||||
|
"../Eve/web/fixtures/eve-world-smoke.provider-advertisement.json"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"commandTransport": {
|
||||||
|
"schema": "gamecult.eve.command_invocation.v1",
|
||||||
|
"status": "provider-shell-contract-skeleton",
|
||||||
|
"emitter": "EveTuiShell.createCommandIntent",
|
||||||
|
"clientId": "tui",
|
||||||
|
"authority": "TUI emits command intents through provider-advertised command boundaries; providers accept, deny, and publish receipts."
|
||||||
|
},
|
||||||
|
"lifecycle": {
|
||||||
|
"release": {
|
||||||
|
"ownerRepo": "EveTui",
|
||||||
|
"status": "owner-npm-package",
|
||||||
|
"releaseContract": {
|
||||||
|
"ownerRepo": "EveTui",
|
||||||
|
"packageName": "eve-tui",
|
||||||
|
"packageRoot": ".",
|
||||||
|
"versionSource": "package.json",
|
||||||
|
"tagPattern": "evetui-v{version}",
|
||||||
|
"artifactKind": "terminal-runtime",
|
||||||
|
"requestSchema": "gamecult.eve.runtime_release_request.v1",
|
||||||
|
"requestBuilder": "tools/evetui/evetui-release-contract.mjs",
|
||||||
|
"artifactPattern": "artifacts/evetui-release/{version}/eve-tui-{version}.tgz",
|
||||||
|
"publishProof": "Terminal runtime release is created from the EveTui repo and references the provider-agnostic TUI package root."
|
||||||
|
},
|
||||||
|
"evidencePaths": [
|
||||||
|
"package.json",
|
||||||
|
"src/eve-tui-shell.mjs",
|
||||||
|
"tools/evetui/evetui-release-contract.mjs",
|
||||||
|
"tools/evetui/evetui-release-contract.test.mjs",
|
||||||
|
"scripts/run-evetui-release-contract-smoke.ps1"
|
||||||
|
],
|
||||||
|
"pendingProofs": []
|
||||||
|
},
|
||||||
|
"test": {
|
||||||
|
"ownerRepo": "EveTui",
|
||||||
|
"status": "provider-shell-contract-skeleton",
|
||||||
|
"testContract": {
|
||||||
|
"ownerRepo": "EveTui",
|
||||||
|
"runnerKind": "terminal-provider-shell-smoke",
|
||||||
|
"runnerScript": "scripts/run-evetui-provider-shell-smoke.ps1",
|
||||||
|
"consumerProject": "../Aetheria",
|
||||||
|
"packageName": "eve-tui",
|
||||||
|
"testAssembly": "eve-tui-shell.test.mjs",
|
||||||
|
"testPlatform": "Node terminal-grid contract skeleton",
|
||||||
|
"resultsArtifact": "artifacts/evetui-provider-shell/{stamp}/provider-shell-results.json",
|
||||||
|
"logArtifact": "artifacts/evetui-provider-shell/{stamp}/provider-shell.log",
|
||||||
|
"manifestMutation": "None; the TUI consumes provider advertisements and must not mutate provider product manifests."
|
||||||
|
},
|
||||||
|
"evidencePaths": [
|
||||||
|
"package.json",
|
||||||
|
"src/eve-tui-shell.mjs",
|
||||||
|
"test/eve-tui-shell.test.mjs",
|
||||||
|
"scripts/run-evetui-provider-shell-smoke.ps1",
|
||||||
|
"conformance/captures/aetheria/tui-grid.json",
|
||||||
|
"conformance/captures/world-smoke/tui-grid.json"
|
||||||
|
],
|
||||||
|
"pendingProofs": []
|
||||||
|
},
|
||||||
|
"capture": {
|
||||||
|
"ownerRepo": "EveTui",
|
||||||
|
"status": "cell-grid-json-capture",
|
||||||
|
"captureContract": {
|
||||||
|
"ownerRepo": "EveTui",
|
||||||
|
"runtimeId": "tui",
|
||||||
|
"targetId": "tui",
|
||||||
|
"requestSchema": "gamecult.eve.runtime_capture_request.v1",
|
||||||
|
"requestBuilder": "tools/evetui/evetui-capture-contract.mjs",
|
||||||
|
"advertisementPath": "../Aetheria/conformance/eve/aetheria.provider-advertisement.json",
|
||||||
|
"captureKind": "terminal-cell-grid",
|
||||||
|
"artifactKind": "json-grid",
|
||||||
|
"artifactPattern": "artifacts/evetui-capture/{stamp}/tui-grid.json",
|
||||||
|
"conformanceAttachment": "runtime.captureArtifacts[]",
|
||||||
|
"requiredProvider": "aetheria",
|
||||||
|
"requiredSurface": "aetheria.daemon.game",
|
||||||
|
"additionalProviderSurfaces": [
|
||||||
|
{
|
||||||
|
"providerId": "eve.world-smoke",
|
||||||
|
"surfaceId": "eve.world-smoke.surface",
|
||||||
|
"purpose": "Generic non-product interactive-world capture control."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"providerId": "aetheria",
|
||||||
|
"surfaceId": "aetheria.daemon.editor",
|
||||||
|
"purpose": "Aetheria interactive-world-editor capture control."
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"authority": "Capture observes terminal projection only; provider state, command acceptance, and receipts stay provider-owned.",
|
||||||
|
"publishProof": "Terminal cell-grid JSON capture artifact is attached to the runtime conformance report from EveTui."
|
||||||
|
},
|
||||||
|
"evidencePaths": [
|
||||||
|
"tools/evetui/evetui-capture-contract.mjs",
|
||||||
|
"tools/evetui/evetui-capture-contract.test.mjs",
|
||||||
|
"tools/evetui/evetui-capture-artifact.mjs",
|
||||||
|
"tools/evetui/evetui-capture-artifact.test.mjs",
|
||||||
|
"scripts/run-evetui-capture-contract-smoke.ps1",
|
||||||
|
"scripts/run-evetui-capture-smoke.ps1",
|
||||||
|
"conformance/captures/aetheria/tui-grid.json",
|
||||||
|
"conformance/captures/world-smoke/tui-grid.json"
|
||||||
|
],
|
||||||
|
"pendingProofs": []
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"capture": {
|
||||||
|
"status": "json-grid",
|
||||||
|
"note": "EveTui publishes provider-advertisement-backed gamecult.eve.tui_grid.v1 release captures.",
|
||||||
|
"artifacts": [
|
||||||
|
{
|
||||||
|
"kind": "json-grid",
|
||||||
|
"schema": "gamecult.eve.tui_grid.v1",
|
||||||
|
"path": "conformance/captures/aetheria/tui-grid.json",
|
||||||
|
"providerId": "aetheria",
|
||||||
|
"surfaceId": "aetheria.daemon.game",
|
||||||
|
"sourceSurfacePath": "../Aetheria/conformance/eve/aetheria-world-surface.json",
|
||||||
|
"requestPath": "conformance/captures/aetheria/capture-request.json"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"kind": "json-grid",
|
||||||
|
"schema": "gamecult.eve.tui_grid.v1",
|
||||||
|
"path": "conformance/captures/world-smoke/tui-grid.json",
|
||||||
|
"providerId": "eve.world-smoke",
|
||||||
|
"surfaceId": "eve.world-smoke.surface",
|
||||||
|
"sourceSurfacePath": "../Eve/web/fixtures/eve-world-smoke-surface.json",
|
||||||
|
"requestPath": "conformance/captures/world-smoke/capture-request.json"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
18
package.json
Normal file
18
package.json
Normal file
|
|
@ -0,0 +1,18 @@
|
||||||
|
{
|
||||||
|
"name": "eve-tui",
|
||||||
|
"version": "0.1.0",
|
||||||
|
"type": "module",
|
||||||
|
"description": "Provider-agnostic compact TUI shell skeleton for Eve surfaces.",
|
||||||
|
"main": "src/eve-tui-shell.mjs",
|
||||||
|
"scripts": {
|
||||||
|
"test": "C:\\Progra~1\\nodejs\\node.exe --test test/*.test.mjs",
|
||||||
|
"test:all": "C:\\Progra~1\\nodejs\\node.exe --test test/*.test.mjs tools/evetui/*.test.mjs"
|
||||||
|
},
|
||||||
|
"keywords": [
|
||||||
|
"Eve",
|
||||||
|
"TUI",
|
||||||
|
"CultUI",
|
||||||
|
"provider-advertisement"
|
||||||
|
],
|
||||||
|
"license": "MPL-2.0"
|
||||||
|
}
|
||||||
99
scripts/run-evetui-capture-contract-smoke.ps1
Normal file
99
scripts/run-evetui-capture-contract-smoke.ps1
Normal file
|
|
@ -0,0 +1,99 @@
|
||||||
|
param(
|
||||||
|
[string] $CapabilityManifestPath = "eve-runtime-capability.json",
|
||||||
|
[string] $AdvertisementPath = "..\Aetheria\conformance\eve\aetheria.provider-advertisement.json",
|
||||||
|
[string] $OutputPath = "artifacts\evetui-capture-contract\latest\capture-request.json",
|
||||||
|
[string] $Stamp = "smoke"
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = "Stop"
|
||||||
|
|
||||||
|
$projectRoot = Split-Path -Parent $PSScriptRoot
|
||||||
|
$absoluteCapabilityPath = if ([System.IO.Path]::IsPathRooted($CapabilityManifestPath)) {
|
||||||
|
$CapabilityManifestPath
|
||||||
|
} else {
|
||||||
|
Join-Path $projectRoot $CapabilityManifestPath
|
||||||
|
}
|
||||||
|
$absoluteAdvertisementPath = if ([System.IO.Path]::IsPathRooted($AdvertisementPath)) {
|
||||||
|
$AdvertisementPath
|
||||||
|
} else {
|
||||||
|
Join-Path $projectRoot $AdvertisementPath
|
||||||
|
}
|
||||||
|
$absoluteOutputPath = if ([System.IO.Path]::IsPathRooted($OutputPath)) {
|
||||||
|
$OutputPath
|
||||||
|
} else {
|
||||||
|
Join-Path $projectRoot $OutputPath
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach ($path in @($absoluteCapabilityPath, $absoluteAdvertisementPath)) {
|
||||||
|
if (-not (Test-Path -LiteralPath $path)) {
|
||||||
|
throw "EveTui capture contract input not found: $path"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$manifest = Get-Content -LiteralPath $absoluteCapabilityPath -Raw | ConvertFrom-Json
|
||||||
|
$captureContract = $manifest.lifecycle.capture.captureContract
|
||||||
|
if ($null -eq $captureContract) {
|
||||||
|
throw "EveTui capture contract missing lifecycle.capture.captureContract"
|
||||||
|
}
|
||||||
|
foreach ($field in @("ownerRepo", "runtimeId", "targetId", "requestSchema", "requestBuilder", "advertisementPath", "captureKind", "artifactKind", "artifactPattern", "conformanceAttachment", "requiredProvider", "requiredSurface", "authority", "publishProof")) {
|
||||||
|
if (-not $captureContract.$field) {
|
||||||
|
throw "EveTui capture contract missing $field"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if ($captureContract.ownerRepo -ne "EveTui") {
|
||||||
|
throw "Unexpected EveTui capture owner: $($captureContract.ownerRepo)"
|
||||||
|
}
|
||||||
|
if ($captureContract.runtimeId -ne "tui") {
|
||||||
|
throw "Unexpected EveTui capture runtime: $($captureContract.runtimeId)"
|
||||||
|
}
|
||||||
|
if ($captureContract.targetId -ne "tui") {
|
||||||
|
throw "Unexpected EveTui capture target: $($captureContract.targetId)"
|
||||||
|
}
|
||||||
|
if ($captureContract.requestSchema -ne "gamecult.eve.runtime_capture_request.v1") {
|
||||||
|
throw "Unexpected EveTui capture request schema: $($captureContract.requestSchema)"
|
||||||
|
}
|
||||||
|
|
||||||
|
$builderPath = Join-Path $projectRoot $captureContract.requestBuilder
|
||||||
|
if (-not (Test-Path -LiteralPath $builderPath)) {
|
||||||
|
throw "EveTui capture request builder not found: $($captureContract.requestBuilder)"
|
||||||
|
}
|
||||||
|
if ((Join-Path $projectRoot $captureContract.advertisementPath) -ne $absoluteAdvertisementPath) {
|
||||||
|
throw "EveTui capture advertisement path mismatch: $($captureContract.advertisementPath) vs $AdvertisementPath"
|
||||||
|
}
|
||||||
|
|
||||||
|
node --test (Join-Path $projectRoot "tools\evetui\evetui-capture-contract.test.mjs")
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "EveTui capture contract tests failed with exit code $LASTEXITCODE"
|
||||||
|
}
|
||||||
|
|
||||||
|
node $builderPath --capability $absoluteCapabilityPath --advertisement $absoluteAdvertisementPath --output $absoluteOutputPath --stamp $Stamp
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "EveTui capture request builder failed with exit code $LASTEXITCODE"
|
||||||
|
}
|
||||||
|
if (-not (Test-Path -LiteralPath $absoluteOutputPath)) {
|
||||||
|
throw "EveTui capture request was not written: $absoluteOutputPath"
|
||||||
|
}
|
||||||
|
|
||||||
|
$request = Get-Content -LiteralPath $absoluteOutputPath -Raw | ConvertFrom-Json
|
||||||
|
foreach ($expectation in @(
|
||||||
|
@{ field = "schema"; value = "gamecult.eve.runtime_capture_request.v1" },
|
||||||
|
@{ field = "runtimeId"; value = "tui" },
|
||||||
|
@{ field = "ownerRepo"; value = "EveTui" },
|
||||||
|
@{ field = "providerId"; value = "aetheria" },
|
||||||
|
@{ field = "surfaceId"; value = "aetheria.daemon.game" },
|
||||||
|
@{ field = "targetId"; value = "tui" },
|
||||||
|
@{ field = "commandBoundary"; value = "aetheria.daemon.commands" },
|
||||||
|
@{ field = "receiptSchema"; value = "aetheria.eve_command_acceptance_status.v1" },
|
||||||
|
@{ field = "captureKind"; value = "terminal-cell-grid" },
|
||||||
|
@{ field = "artifactKind"; value = "json-grid" },
|
||||||
|
@{ field = "conformanceAttachment"; value = "runtime.captureArtifacts[]" }
|
||||||
|
)) {
|
||||||
|
if ($request.($expectation.field) -ne $expectation.value) {
|
||||||
|
throw "EveTui capture request $($expectation.field) expected $($expectation.value) got $($request.($expectation.field))"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if ($request.artifactPath -ne "artifacts/evetui-capture/$Stamp/tui-grid.json") {
|
||||||
|
throw "Unexpected EveTui capture artifact path: $($request.artifactPath)"
|
||||||
|
}
|
||||||
|
|
||||||
|
Write-Host "EveTui capture contract smoke passed: $absoluteOutputPath"
|
||||||
77
scripts/run-evetui-capture-smoke.ps1
Normal file
77
scripts/run-evetui-capture-smoke.ps1
Normal file
|
|
@ -0,0 +1,77 @@
|
||||||
|
param(
|
||||||
|
[string] $CapabilityManifestPath = "eve-runtime-capability.json",
|
||||||
|
[string] $AdvertisementPath = "..\Aetheria\conformance\eve\aetheria.provider-advertisement.json",
|
||||||
|
[string] $SurfacePath = "..\Aetheria\conformance\eve\aetheria-world-surface.json",
|
||||||
|
[string] $OutputPath = "artifacts\evetui-capture\latest\tui-grid.json",
|
||||||
|
[string] $RequestOutputPath = "artifacts\evetui-capture\latest\capture-request.json",
|
||||||
|
[string] $Stamp = "latest",
|
||||||
|
[string] $ExpectedProviderId = "aetheria",
|
||||||
|
[string] $ExpectedSurfaceId = "aetheria.daemon.game",
|
||||||
|
[string] $ExpectedCommandBoundary = "aetheria.daemon.commands",
|
||||||
|
[string] $ExpectedReceiptSchema = "aetheria.eve_command_acceptance_status.v1"
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = "Stop"
|
||||||
|
|
||||||
|
$projectRoot = Split-Path -Parent $PSScriptRoot
|
||||||
|
function Resolve-RepoPath([string] $candidate) {
|
||||||
|
if ([System.IO.Path]::IsPathRooted($candidate)) {
|
||||||
|
return $candidate
|
||||||
|
}
|
||||||
|
return Join-Path $projectRoot $candidate
|
||||||
|
}
|
||||||
|
|
||||||
|
$absoluteCapabilityPath = Resolve-RepoPath $CapabilityManifestPath
|
||||||
|
$absoluteAdvertisementPath = Resolve-RepoPath $AdvertisementPath
|
||||||
|
$absoluteSurfacePath = Resolve-RepoPath $SurfacePath
|
||||||
|
$absoluteOutputPath = Resolve-RepoPath $OutputPath
|
||||||
|
$absoluteRequestOutputPath = Resolve-RepoPath $RequestOutputPath
|
||||||
|
|
||||||
|
foreach ($path in @($absoluteCapabilityPath, $absoluteAdvertisementPath, $absoluteSurfacePath)) {
|
||||||
|
if (-not (Test-Path -LiteralPath $path)) {
|
||||||
|
throw "EveTui capture input not found: $path"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
node --test (Join-Path $projectRoot "tools\evetui\evetui-capture-artifact.test.mjs")
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "EveTui capture artifact tests failed with exit code $LASTEXITCODE"
|
||||||
|
}
|
||||||
|
|
||||||
|
node (Join-Path $projectRoot "tools\evetui\evetui-capture-artifact.mjs") `
|
||||||
|
--capability $absoluteCapabilityPath `
|
||||||
|
--advertisement $absoluteAdvertisementPath `
|
||||||
|
--surface $absoluteSurfacePath `
|
||||||
|
--output $absoluteOutputPath `
|
||||||
|
--request-output $absoluteRequestOutputPath `
|
||||||
|
--stamp $Stamp
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "EveTui capture artifact builder failed with exit code $LASTEXITCODE"
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach ($path in @($absoluteOutputPath, $absoluteRequestOutputPath)) {
|
||||||
|
if (-not (Test-Path -LiteralPath $path)) {
|
||||||
|
throw "EveTui capture artifact output missing: $path"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$grid = Get-Content -LiteralPath $absoluteOutputPath -Raw | ConvertFrom-Json
|
||||||
|
foreach ($expectation in @(
|
||||||
|
@{ field = "schema"; value = "gamecult.eve.tui_grid.v1" },
|
||||||
|
@{ field = "runtimeId"; value = "tui" },
|
||||||
|
@{ field = "providerId"; value = $ExpectedProviderId },
|
||||||
|
@{ field = "surfaceId"; value = $ExpectedSurfaceId },
|
||||||
|
@{ field = "commandBoundary"; value = $ExpectedCommandBoundary },
|
||||||
|
@{ field = "receiptSchema"; value = $ExpectedReceiptSchema },
|
||||||
|
@{ field = "artifactKind"; value = "json-grid" },
|
||||||
|
@{ field = "captureKind"; value = "terminal-cell-grid" }
|
||||||
|
)) {
|
||||||
|
if ($grid.($expectation.field) -ne $expectation.value) {
|
||||||
|
throw "EveTui grid $($expectation.field) expected $($expectation.value) got $($grid.($expectation.field))"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (@($grid.lines).Count -lt 1) {
|
||||||
|
throw "EveTui grid capture must contain terminal lines"
|
||||||
|
}
|
||||||
|
|
||||||
|
Write-Host "EveTui capture smoke passed: $absoluteOutputPath"
|
||||||
195
scripts/run-evetui-lifecycle-smoke.ps1
Normal file
195
scripts/run-evetui-lifecycle-smoke.ps1
Normal file
|
|
@ -0,0 +1,195 @@
|
||||||
|
param(
|
||||||
|
[string] $CapabilityManifestPath = "eve-runtime-capability.json"
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = "Stop"
|
||||||
|
|
||||||
|
$projectRoot = Split-Path -Parent $PSScriptRoot
|
||||||
|
$absoluteManifestPath = if ([System.IO.Path]::IsPathRooted($CapabilityManifestPath)) {
|
||||||
|
$CapabilityManifestPath
|
||||||
|
} else {
|
||||||
|
Join-Path $projectRoot $CapabilityManifestPath
|
||||||
|
}
|
||||||
|
|
||||||
|
if (-not (Test-Path -LiteralPath $absoluteManifestPath)) {
|
||||||
|
throw "EveTui runtime capability manifest not found: $absoluteManifestPath"
|
||||||
|
}
|
||||||
|
|
||||||
|
$manifest = Get-Content -LiteralPath $absoluteManifestPath -Raw | ConvertFrom-Json
|
||||||
|
|
||||||
|
if ($manifest.schema -ne "gamecult.eve.runtime_capability.v1") {
|
||||||
|
throw "Unexpected EveTui manifest schema: $($manifest.schema)"
|
||||||
|
}
|
||||||
|
if ($manifest.runtimeId -ne "tui") {
|
||||||
|
throw "Unexpected EveTui runtime id: $($manifest.runtimeId)"
|
||||||
|
}
|
||||||
|
if ($manifest.owner -ne "EveTui") {
|
||||||
|
throw "Unexpected EveTui owner: $($manifest.owner)"
|
||||||
|
}
|
||||||
|
if ($manifest.incubation.ownerRepo -ne "EveTui") {
|
||||||
|
throw "Unexpected EveTui incubation owner: $($manifest.incubation.ownerRepo)"
|
||||||
|
}
|
||||||
|
if ($manifest.incubation.currentHostRepo -ne "EveTui") {
|
||||||
|
throw "Unexpected EveTui current host repo: $($manifest.incubation.currentHostRepo)"
|
||||||
|
}
|
||||||
|
if ($manifest.incubation.splitTarget -ne "EveTui") {
|
||||||
|
throw "Unexpected EveTui split target: $($manifest.incubation.splitTarget)"
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach ($feature in @("providerAdvertisements", "commandTransport", "terminalGridSummary", "terminalGridLowering", "embeddedDocuments", "pluginProjection")) {
|
||||||
|
if (-not (@($manifest.supportedFeatures) -contains $feature)) {
|
||||||
|
throw "EveTui manifest missing provider-shell feature: $feature"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$expectedPlugins = @{
|
||||||
|
"sai.vn" = @("vn.stage", "story.choose", "story.continue", "story.jump")
|
||||||
|
"norn.graph" = @("embed.norn")
|
||||||
|
"tex.math" = @("embed.tex", "tex.inline", "tex.block")
|
||||||
|
}
|
||||||
|
foreach ($pluginId in $expectedPlugins.Keys) {
|
||||||
|
$supported = @($manifest.supportedPlugins) | Where-Object { $_.pluginId -eq $pluginId } | Select-Object -First 1
|
||||||
|
if (-not $supported) {
|
||||||
|
throw "EveTui manifest missing supported plugin declaration: $pluginId"
|
||||||
|
}
|
||||||
|
foreach ($capability in $expectedPlugins[$pluginId]) {
|
||||||
|
if (-not (@($supported.capabilities) -contains $capability)) {
|
||||||
|
throw "EveTui supported plugin $pluginId missing capability: $capability"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if ($supported.projectionAdapter -ne "EveTuiShell.buildPluginProjection") {
|
||||||
|
throw "EveTui supported plugin $pluginId has unexpected projection adapter: $($supported.projectionAdapter)"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$worldSurfaceLoweringClaims = @()
|
||||||
|
if ($null -ne $manifest.worldSurfaceLowering) {
|
||||||
|
$worldSurfaceLoweringClaims = @($manifest.worldSurfaceLowering)
|
||||||
|
}
|
||||||
|
if ($worldSurfaceLoweringClaims.Count -ne 1) {
|
||||||
|
throw "EveTui must claim exactly one world-surface lowering target"
|
||||||
|
}
|
||||||
|
$worldSurfaceLoweringClaim = $worldSurfaceLoweringClaims | Where-Object { $_.targetId -eq "tui" } | Select-Object -First 1
|
||||||
|
if (-not $worldSurfaceLoweringClaim) {
|
||||||
|
throw "EveTui manifest missing tui world-surface lowering claim"
|
||||||
|
}
|
||||||
|
if ($worldSurfaceLoweringClaim.supportLevel -ne "terminal-grid-command-surface") {
|
||||||
|
throw "Unexpected EveTui world-surface support level: $($worldSurfaceLoweringClaim.supportLevel)"
|
||||||
|
}
|
||||||
|
if ($worldSurfaceLoweringClaim.ownership -ne "runtime-lowers-provider-world-surface-without-owning-world-state") {
|
||||||
|
throw "Unexpected EveTui world-surface ownership: $($worldSurfaceLoweringClaim.ownership)"
|
||||||
|
}
|
||||||
|
foreach ($evidencePath in @($worldSurfaceLoweringClaim.evidencePaths)) {
|
||||||
|
$absoluteEvidencePath = Join-Path $projectRoot $evidencePath
|
||||||
|
if (-not (Test-Path -LiteralPath $absoluteEvidencePath)) {
|
||||||
|
throw "EveTui world-surface claim missing evidence path: $evidencePath"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach ($pluginId in $expectedPlugins.Keys) {
|
||||||
|
$unsupported = @($manifest.unsupportedPlugins) | Where-Object { $_.pluginId -eq $pluginId } | Select-Object -First 1
|
||||||
|
if ($unsupported) {
|
||||||
|
throw "EveTui manifest must not report $pluginId unsupported while terminal fallback projection is declared"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if ($manifest.commandTransport.schema -ne "gamecult.eve.command_invocation.v1") {
|
||||||
|
throw "Unexpected EveTui command schema: $($manifest.commandTransport.schema)"
|
||||||
|
}
|
||||||
|
if ($manifest.commandTransport.status -ne "provider-shell-contract-skeleton") {
|
||||||
|
throw "Unexpected EveTui command transport status: $($manifest.commandTransport.status)"
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach ($stage in @("release", "test", "capture")) {
|
||||||
|
$stageDocument = $manifest.lifecycle.$stage
|
||||||
|
if ($null -eq $stageDocument) {
|
||||||
|
throw "EveTui lifecycle missing stage: $stage"
|
||||||
|
}
|
||||||
|
if ($stageDocument.ownerRepo -ne "EveTui") {
|
||||||
|
throw "EveTui lifecycle stage $stage has unexpected owner: $($stageDocument.ownerRepo)"
|
||||||
|
}
|
||||||
|
if (-not $stageDocument.status) {
|
||||||
|
throw "EveTui lifecycle stage $stage missing status"
|
||||||
|
}
|
||||||
|
foreach ($evidencePath in @($stageDocument.evidencePaths)) {
|
||||||
|
$absoluteEvidencePath = Join-Path $projectRoot $evidencePath
|
||||||
|
if (-not (Test-Path -LiteralPath $absoluteEvidencePath)) {
|
||||||
|
throw "EveTui lifecycle stage $stage missing evidence path: $evidencePath"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$releaseContract = $manifest.lifecycle.release.releaseContract
|
||||||
|
foreach ($field in @("ownerRepo", "packageName", "packageRoot", "versionSource", "tagPattern", "artifactKind", "requestSchema", "requestBuilder", "artifactPattern", "publishProof")) {
|
||||||
|
if (-not $releaseContract.$field) {
|
||||||
|
throw "EveTui release contract missing $field"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if ($releaseContract.requestSchema -ne "gamecult.eve.runtime_release_request.v1") {
|
||||||
|
throw "EveTui release contract has unexpected request schema: $($releaseContract.requestSchema)"
|
||||||
|
}
|
||||||
|
foreach ($pathProperty in @("packageRoot", "versionSource")) {
|
||||||
|
$relativePath = $releaseContract.$pathProperty
|
||||||
|
$absolutePath = Join-Path $projectRoot $relativePath
|
||||||
|
if (-not (Test-Path -LiteralPath $absolutePath)) {
|
||||||
|
throw "EveTui release contract $pathProperty does not exist: $relativePath"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
foreach ($pathProperty in @("requestBuilder")) {
|
||||||
|
$relativePath = $releaseContract.$pathProperty
|
||||||
|
$absolutePath = Join-Path $projectRoot $relativePath
|
||||||
|
if (-not (Test-Path -LiteralPath $absolutePath)) {
|
||||||
|
throw "EveTui release contract $pathProperty does not exist: $relativePath"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$testContract = $manifest.lifecycle.test.testContract
|
||||||
|
foreach ($field in @("ownerRepo", "runnerKind", "runnerScript", "consumerProject", "packageName", "testAssembly", "testPlatform", "resultsArtifact", "logArtifact", "manifestMutation")) {
|
||||||
|
if (-not $testContract.$field) {
|
||||||
|
throw "EveTui test contract missing $field"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
foreach ($pathProperty in @("runnerScript", "consumerProject")) {
|
||||||
|
$candidate = $testContract.$pathProperty
|
||||||
|
$absolutePath = if ([System.IO.Path]::IsPathRooted($candidate)) {
|
||||||
|
$candidate
|
||||||
|
} else {
|
||||||
|
Join-Path $projectRoot $candidate
|
||||||
|
}
|
||||||
|
if (-not (Test-Path -LiteralPath $absolutePath)) {
|
||||||
|
throw "EveTui test contract $pathProperty does not exist: $candidate"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$captureContract = $manifest.lifecycle.capture.captureContract
|
||||||
|
foreach ($field in @("ownerRepo", "runtimeId", "targetId", "requestSchema", "requestBuilder", "advertisementPath", "captureKind", "artifactKind", "artifactPattern", "conformanceAttachment", "requiredProvider", "requiredSurface", "authority", "publishProof")) {
|
||||||
|
if (-not $captureContract.$field) {
|
||||||
|
throw "EveTui capture contract missing $field"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if ($captureContract.runtimeId -ne "tui") {
|
||||||
|
throw "EveTui capture contract has unexpected runtime: $($captureContract.runtimeId)"
|
||||||
|
}
|
||||||
|
if ($captureContract.targetId -ne "tui") {
|
||||||
|
throw "EveTui capture contract has unexpected target: $($captureContract.targetId)"
|
||||||
|
}
|
||||||
|
if ($captureContract.requestSchema -ne "gamecult.eve.runtime_capture_request.v1") {
|
||||||
|
throw "EveTui capture contract has unexpected request schema: $($captureContract.requestSchema)"
|
||||||
|
}
|
||||||
|
if ($captureContract.captureKind -ne "terminal-cell-grid") {
|
||||||
|
throw "EveTui capture contract has unexpected capture kind: $($captureContract.captureKind)"
|
||||||
|
}
|
||||||
|
foreach ($pathProperty in @("requestBuilder", "advertisementPath")) {
|
||||||
|
$relativePath = $captureContract.$pathProperty
|
||||||
|
$absolutePath = Join-Path $projectRoot $relativePath
|
||||||
|
if (-not (Test-Path -LiteralPath $absolutePath)) {
|
||||||
|
throw "EveTui capture contract $pathProperty does not exist: $relativePath"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
& (Join-Path $projectRoot "scripts\run-evetui-release-contract-smoke.ps1")
|
||||||
|
& (Join-Path $projectRoot "scripts\run-evetui-provider-shell-smoke.ps1")
|
||||||
|
& (Join-Path $projectRoot "scripts\run-evetui-capture-contract-smoke.ps1")
|
||||||
|
& (Join-Path $projectRoot "scripts\run-evetui-capture-smoke.ps1")
|
||||||
|
|
||||||
|
Write-Host "EveTui lifecycle smoke passed: $absoluteManifestPath"
|
||||||
111
scripts/run-evetui-provider-shell-smoke.ps1
Normal file
111
scripts/run-evetui-provider-shell-smoke.ps1
Normal file
|
|
@ -0,0 +1,111 @@
|
||||||
|
param(
|
||||||
|
[string] $CapabilityManifestPath = "eve-runtime-capability.json"
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = "Stop"
|
||||||
|
|
||||||
|
$projectRoot = Split-Path -Parent $PSScriptRoot
|
||||||
|
$absoluteManifestPath = if ([System.IO.Path]::IsPathRooted($CapabilityManifestPath)) {
|
||||||
|
$CapabilityManifestPath
|
||||||
|
} else {
|
||||||
|
Join-Path $projectRoot $CapabilityManifestPath
|
||||||
|
}
|
||||||
|
|
||||||
|
if (-not (Test-Path -LiteralPath $absoluteManifestPath)) {
|
||||||
|
throw "EveTui runtime capability manifest not found: $absoluteManifestPath"
|
||||||
|
}
|
||||||
|
|
||||||
|
$manifest = Get-Content -LiteralPath $absoluteManifestPath -Raw | ConvertFrom-Json
|
||||||
|
|
||||||
|
if ($manifest.runtimeId -ne "tui") {
|
||||||
|
throw "Unexpected EveTui runtime id: $($manifest.runtimeId)"
|
||||||
|
}
|
||||||
|
if ($manifest.lifecycle.test.status -ne "provider-shell-contract-skeleton") {
|
||||||
|
throw "Unexpected EveTui provider shell status: $($manifest.lifecycle.test.status)"
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach ($feature in @("providerAdvertisements", "commandTransport", "terminalGridSummary", "terminalGridLowering", "pluginProjection")) {
|
||||||
|
if (-not (@($manifest.supportedFeatures) -contains $feature)) {
|
||||||
|
throw "EveTui provider shell missing supported feature: $feature"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach ($pluginId in @("sai.vn", "norn.graph", "tex.math")) {
|
||||||
|
$supported = @($manifest.supportedPlugins) | Where-Object { $_.pluginId -eq $pluginId } | Select-Object -First 1
|
||||||
|
if (-not $supported) {
|
||||||
|
throw "EveTui provider shell missing supported plugin projection: $pluginId"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$worldSurfaceLoweringClaims = @()
|
||||||
|
if ($null -ne $manifest.worldSurfaceLowering) {
|
||||||
|
$worldSurfaceLoweringClaims = @($manifest.worldSurfaceLowering)
|
||||||
|
}
|
||||||
|
if ($worldSurfaceLoweringClaims.Count -ne 1) {
|
||||||
|
throw "EveTui must claim exactly one provider world-surface lowering target"
|
||||||
|
}
|
||||||
|
$worldSurfaceLoweringClaim = $worldSurfaceLoweringClaims | Where-Object { $_.targetId -eq "tui" } | Select-Object -First 1
|
||||||
|
if (-not $worldSurfaceLoweringClaim) {
|
||||||
|
throw "EveTui missing tui world-surface lowering claim"
|
||||||
|
}
|
||||||
|
foreach ($surfaceKind in @("interactive-world", "interactive-world-editor")) {
|
||||||
|
if (-not (@($worldSurfaceLoweringClaim.surfaceKinds) -contains $surfaceKind)) {
|
||||||
|
throw "EveTui world-surface claim missing surface kind: $surfaceKind"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
foreach ($projectionKind in @("provider-authored-world-surface", "provider-authored-world-editor-surface")) {
|
||||||
|
if (-not (@($worldSurfaceLoweringClaim.projectionKinds) -contains $projectionKind)) {
|
||||||
|
throw "EveTui world-surface claim missing projection kind: $projectionKind"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if ($worldSurfaceLoweringClaim.supportLevel -ne "terminal-grid-command-surface") {
|
||||||
|
throw "Unexpected EveTui support level: $($worldSurfaceLoweringClaim.supportLevel)"
|
||||||
|
}
|
||||||
|
if ($worldSurfaceLoweringClaim.ownership -ne "runtime-lowers-provider-world-surface-without-owning-world-state") {
|
||||||
|
throw "Unexpected EveTui ownership: $($worldSurfaceLoweringClaim.ownership)"
|
||||||
|
}
|
||||||
|
foreach ($evidencePath in @($worldSurfaceLoweringClaim.evidencePaths)) {
|
||||||
|
$absoluteEvidencePath = Join-Path $projectRoot $evidencePath
|
||||||
|
if (-not (Test-Path -LiteralPath $absoluteEvidencePath)) {
|
||||||
|
throw "EveTui world-surface claim missing evidence path: $evidencePath"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$expectedFiles = @(
|
||||||
|
"package.json",
|
||||||
|
"src\eve-tui-shell.mjs",
|
||||||
|
"test\eve-tui-shell.test.mjs"
|
||||||
|
)
|
||||||
|
|
||||||
|
foreach ($relativePath in $expectedFiles) {
|
||||||
|
$absolutePath = Join-Path $projectRoot $relativePath
|
||||||
|
if (-not (Test-Path -LiteralPath $absolutePath)) {
|
||||||
|
throw "EveTui provider shell missing file: $relativePath"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$shellSource = Get-Content -LiteralPath (Join-Path $projectRoot "src\eve-tui-shell.mjs") -Raw
|
||||||
|
foreach ($symbol in @("EveTuiShell", "selectSurface", "lowerSurface", "normalizeSurfaceDocument", "buildComponentLines", "buildPluginProjection", "collectPluginProjections", "terminalElementKind", "sai.vn", "norn.graph", "tex.math", "sidecar-advertised-plugin-abi", "createCommandIntent", "renderSummary", "gamecult.eve.tui_grid.v1", "commandBoundary", "receiptSchema")) {
|
||||||
|
if (-not $shellSource.Contains($symbol)) {
|
||||||
|
throw "EveTui provider shell source missing symbol: $symbol"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$testSource = Get-Content -LiteralPath (Join-Path $projectRoot "test\eve-tui-shell.test.mjs") -Raw
|
||||||
|
foreach ($symbol in @("selects advertised provider surfaces", "command intents carry provider-advertised boundaries", "summary grid is explicitly lossy", "lowers provider surface trees into a terminal grid", "lowers Sai, Norn, and TeX plugin surfaces into compact terminal fallbacks", "pluginProjections", "sai-vn-terminal-stage-summary", "norn-graph-terminal-outline", "tex-math-terminal-block-source", "rejects surface documents that do not match the advertised TUI target", "aetheria.daemon.commands")) {
|
||||||
|
if (-not $testSource.Contains($symbol)) {
|
||||||
|
throw "EveTui provider shell test missing symbol: $symbol"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Push-Location $projectRoot
|
||||||
|
try {
|
||||||
|
npm test
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "EveTui provider shell tests failed with exit code $LASTEXITCODE"
|
||||||
|
}
|
||||||
|
} finally {
|
||||||
|
Pop-Location
|
||||||
|
}
|
||||||
|
|
||||||
|
Write-Host "EveTui provider shell smoke passed: $absoluteManifestPath"
|
||||||
98
scripts/run-evetui-release-contract-smoke.ps1
Normal file
98
scripts/run-evetui-release-contract-smoke.ps1
Normal file
|
|
@ -0,0 +1,98 @@
|
||||||
|
param(
|
||||||
|
[string] $CapabilityManifestPath = "eve-runtime-capability.json",
|
||||||
|
[string] $OutputPath = "artifacts\evetui-release-contract\latest\release-request.json"
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = "Stop"
|
||||||
|
|
||||||
|
$projectRoot = Split-Path -Parent $PSScriptRoot
|
||||||
|
$absoluteCapabilityPath = if ([System.IO.Path]::IsPathRooted($CapabilityManifestPath)) {
|
||||||
|
$CapabilityManifestPath
|
||||||
|
} else {
|
||||||
|
Join-Path $projectRoot $CapabilityManifestPath
|
||||||
|
}
|
||||||
|
$absoluteOutputPath = if ([System.IO.Path]::IsPathRooted($OutputPath)) {
|
||||||
|
$OutputPath
|
||||||
|
} else {
|
||||||
|
Join-Path $projectRoot $OutputPath
|
||||||
|
}
|
||||||
|
|
||||||
|
if (-not (Test-Path -LiteralPath $absoluteCapabilityPath)) {
|
||||||
|
throw "EveTui release contract input not found: $absoluteCapabilityPath"
|
||||||
|
}
|
||||||
|
|
||||||
|
$manifest = Get-Content -LiteralPath $absoluteCapabilityPath -Raw | ConvertFrom-Json
|
||||||
|
$releaseContract = $manifest.lifecycle.release.releaseContract
|
||||||
|
if ($null -eq $releaseContract) {
|
||||||
|
throw "EveTui release contract missing lifecycle.release.releaseContract"
|
||||||
|
}
|
||||||
|
foreach ($field in @("ownerRepo", "packageName", "packageRoot", "versionSource", "tagPattern", "artifactKind", "requestSchema", "requestBuilder", "artifactPattern", "publishProof")) {
|
||||||
|
if (-not $releaseContract.$field) {
|
||||||
|
throw "EveTui release contract missing $field"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if ($releaseContract.ownerRepo -ne "EveTui") {
|
||||||
|
throw "Unexpected EveTui release owner: $($releaseContract.ownerRepo)"
|
||||||
|
}
|
||||||
|
if ($releaseContract.packageName -ne "eve-tui") {
|
||||||
|
throw "Unexpected EveTui package name: $($releaseContract.packageName)"
|
||||||
|
}
|
||||||
|
if ($releaseContract.requestSchema -ne "gamecult.eve.runtime_release_request.v1") {
|
||||||
|
throw "Unexpected EveTui release request schema: $($releaseContract.requestSchema)"
|
||||||
|
}
|
||||||
|
if ($releaseContract.artifactKind -ne "terminal-runtime") {
|
||||||
|
throw "Unexpected EveTui release artifact kind: $($releaseContract.artifactKind)"
|
||||||
|
}
|
||||||
|
|
||||||
|
$builderPath = Join-Path $projectRoot $releaseContract.requestBuilder
|
||||||
|
$packagePath = Join-Path $projectRoot $releaseContract.versionSource
|
||||||
|
$packageRoot = Join-Path $projectRoot $releaseContract.packageRoot
|
||||||
|
foreach ($path in @($builderPath, $packagePath, $packageRoot)) {
|
||||||
|
if (-not (Test-Path -LiteralPath $path)) {
|
||||||
|
throw "EveTui release contract path not found: $path"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
node --test (Join-Path $projectRoot "tools\evetui\evetui-release-contract.test.mjs")
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "EveTui release contract tests failed with exit code $LASTEXITCODE"
|
||||||
|
}
|
||||||
|
|
||||||
|
node $builderPath --capability $absoluteCapabilityPath --package $packagePath --output $absoluteOutputPath
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "EveTui release request builder failed with exit code $LASTEXITCODE"
|
||||||
|
}
|
||||||
|
if (-not (Test-Path -LiteralPath $absoluteOutputPath)) {
|
||||||
|
throw "EveTui release request was not written: $absoluteOutputPath"
|
||||||
|
}
|
||||||
|
|
||||||
|
$request = Get-Content -LiteralPath $absoluteOutputPath -Raw | ConvertFrom-Json
|
||||||
|
$packageManifest = Get-Content -LiteralPath $packagePath -Raw | ConvertFrom-Json
|
||||||
|
foreach ($expectation in @(
|
||||||
|
@{ field = "schema"; value = "gamecult.eve.runtime_release_request.v1" },
|
||||||
|
@{ field = "ownerRepo"; value = "EveTui" },
|
||||||
|
@{ field = "repository"; value = "GameCult/EveTui" },
|
||||||
|
@{ field = "packageName"; value = "eve-tui" },
|
||||||
|
@{ field = "version"; value = $packageManifest.version },
|
||||||
|
@{ field = "packageRoot"; value = "." },
|
||||||
|
@{ field = "versionSource"; value = "package.json" },
|
||||||
|
@{ field = "artifactKind"; value = "terminal-runtime" }
|
||||||
|
)) {
|
||||||
|
if ($request.($expectation.field) -ne $expectation.value) {
|
||||||
|
throw "EveTui release request $($expectation.field) expected $($expectation.value) got $($request.($expectation.field))"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$expectedTagName = $releaseContract.tagPattern.Replace("{version}", $packageManifest.version)
|
||||||
|
if ($request.tagName -ne $expectedTagName) {
|
||||||
|
throw "Unexpected EveTui release tag: $($request.tagName)"
|
||||||
|
}
|
||||||
|
$expectedArtifactPath = $releaseContract.artifactPattern.Replace("{version}", $packageManifest.version)
|
||||||
|
if ($request.artifactPath -ne $expectedArtifactPath) {
|
||||||
|
throw "Unexpected EveTui release artifact path: $($request.artifactPath)"
|
||||||
|
}
|
||||||
|
if ($request.main -ne $packageManifest.main) {
|
||||||
|
throw "EveTui release request lost package main entry"
|
||||||
|
}
|
||||||
|
|
||||||
|
Write-Host "EveTui release contract smoke passed: $absoluteOutputPath"
|
||||||
297
src/eve-tui-shell.mjs
Normal file
297
src/eve-tui-shell.mjs
Normal file
|
|
@ -0,0 +1,297 @@
|
||||||
|
export class EveTuiShell {
|
||||||
|
constructor({ clientId = "tui", width = 80 } = {}) {
|
||||||
|
this.clientId = clientId;
|
||||||
|
this.width = Math.max(20, Number(width) || 80);
|
||||||
|
}
|
||||||
|
|
||||||
|
selectSurface(providerAdvertisement, requestedSurfaceId = "") {
|
||||||
|
const provider = normalizeProviderAdvertisement(providerAdvertisement);
|
||||||
|
const surface = requestedSurfaceId
|
||||||
|
? provider.surfaces.find(candidate => candidate.surfaceId === requestedSurfaceId)
|
||||||
|
: provider.surfaces[0];
|
||||||
|
if (!surface) {
|
||||||
|
throw new Error(`Provider ${provider.providerId} does not advertise surface ${requestedSurfaceId || "(first)"}`);
|
||||||
|
}
|
||||||
|
return {
|
||||||
|
providerId: provider.providerId,
|
||||||
|
surfaceId: surface.surfaceId,
|
||||||
|
title: surface.title || provider.title || surface.surfaceId,
|
||||||
|
transport: surface.transport || "",
|
||||||
|
url: surface.url || surface.key || "",
|
||||||
|
worldInteraction: normalizeWorldInteraction(surface.worldInteraction),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
createCommandIntent(providerAdvertisement, requestedSurfaceId, command, payload = {}) {
|
||||||
|
if (!command) throw new Error("Command is required.");
|
||||||
|
const selected = this.selectSurface(providerAdvertisement, requestedSurfaceId);
|
||||||
|
const action = objectValue(payload.action);
|
||||||
|
const commandBoundary = firstString(
|
||||||
|
selected.worldInteraction.commandBoundary,
|
||||||
|
payload.commandBoundary,
|
||||||
|
action.commandBoundary,
|
||||||
|
action.target,
|
||||||
|
);
|
||||||
|
const receiptSchema = firstString(
|
||||||
|
selected.worldInteraction.receiptSchema,
|
||||||
|
payload.receiptSchema,
|
||||||
|
action.receiptSchema,
|
||||||
|
);
|
||||||
|
const intent = {
|
||||||
|
type: "surface-command",
|
||||||
|
schema: "gamecult.eve.command_invocation.v1",
|
||||||
|
providerId: selected.providerId,
|
||||||
|
surfaceId: selected.surfaceId,
|
||||||
|
command,
|
||||||
|
payload: {
|
||||||
|
...payload,
|
||||||
|
transport: payload.transport ?? null,
|
||||||
|
},
|
||||||
|
issuedAt: new Date().toISOString(),
|
||||||
|
clientId: this.clientId,
|
||||||
|
};
|
||||||
|
if (commandBoundary) intent.commandBoundary = commandBoundary;
|
||||||
|
if (receiptSchema) intent.receiptSchema = receiptSchema;
|
||||||
|
return intent;
|
||||||
|
}
|
||||||
|
|
||||||
|
lowerSurface(surfaceDocument, providerAdvertisement, requestedSurfaceId = "") {
|
||||||
|
const selected = this.selectSurface(providerAdvertisement, requestedSurfaceId);
|
||||||
|
const document = normalizeSurfaceDocument(surfaceDocument);
|
||||||
|
if (document.surfaceId !== selected.surfaceId) {
|
||||||
|
throw new Error(`Surface document ${document.surfaceId} does not match advertised TUI surface ${selected.surfaceId}.`);
|
||||||
|
}
|
||||||
|
|
||||||
|
const lines = [
|
||||||
|
fitLine(`EveTui ${selected.providerId}`, this.width),
|
||||||
|
fitLine(`surface ${selected.surfaceId}`, this.width),
|
||||||
|
fitLine(`command ${selected.worldInteraction.commandBoundary || "unadvertised"}`, this.width),
|
||||||
|
fitLine(`receipt ${selected.worldInteraction.receiptSchema || "unadvertised"}`, this.width),
|
||||||
|
...buildComponentLines(document.root, this.width),
|
||||||
|
];
|
||||||
|
|
||||||
|
return {
|
||||||
|
schema: "gamecult.eve.tui_grid.v1",
|
||||||
|
runtimeId: "tui",
|
||||||
|
providerId: selected.providerId,
|
||||||
|
surfaceId: selected.surfaceId,
|
||||||
|
projectionKind: selected.worldInteraction.projectionKind,
|
||||||
|
commandBoundary: selected.worldInteraction.commandBoundary,
|
||||||
|
receiptSchema: selected.worldInteraction.receiptSchema,
|
||||||
|
ownership: selected.worldInteraction.ownership,
|
||||||
|
width: this.width,
|
||||||
|
lines,
|
||||||
|
embeddedDocumentSlots: collectEmbeddedDocumentSlots(document.root),
|
||||||
|
pluginProjections: collectPluginProjections(document.root),
|
||||||
|
lossiness: "terminal-grid-command-surface; summarizes provider-authored world surface without owning provider state",
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
renderSummary(providerAdvertisement, requestedSurfaceId = "") {
|
||||||
|
const selected = this.selectSurface(providerAdvertisement, requestedSurfaceId);
|
||||||
|
const lines = [
|
||||||
|
fitLine(`EveTui ${selected.providerId}`, this.width),
|
||||||
|
fitLine(`surface ${selected.surfaceId}`, this.width),
|
||||||
|
fitLine(`transport ${selected.transport || "unknown"}`, this.width),
|
||||||
|
fitLine(`command ${selected.worldInteraction.commandBoundary || "unadvertised"}`, this.width),
|
||||||
|
fitLine(`receipt ${selected.worldInteraction.receiptSchema || "unadvertised"}`, this.width),
|
||||||
|
];
|
||||||
|
return {
|
||||||
|
schema: "gamecult.eve.tui_grid.v1",
|
||||||
|
runtimeId: "tui",
|
||||||
|
providerId: selected.providerId,
|
||||||
|
surfaceId: selected.surfaceId,
|
||||||
|
width: this.width,
|
||||||
|
lines,
|
||||||
|
lossiness: "provider-shell-summary-only; use lowerSurface for TUI world-surface lowering",
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export function normalizeProviderAdvertisement(providerAdvertisement) {
|
||||||
|
if (!providerAdvertisement || typeof providerAdvertisement !== "object") {
|
||||||
|
throw new Error("Provider advertisement is required.");
|
||||||
|
}
|
||||||
|
const providerId = String(providerAdvertisement.providerId || "");
|
||||||
|
if (!providerId) throw new Error("Provider advertisement missing providerId.");
|
||||||
|
const surfaces = Array.isArray(providerAdvertisement.surfaces)
|
||||||
|
? providerAdvertisement.surfaces
|
||||||
|
.filter(surface => surface && typeof surface === "object" && surface.surfaceId)
|
||||||
|
.map(surface => ({ ...surface, surfaceId: String(surface.surfaceId) }))
|
||||||
|
: [];
|
||||||
|
if (!surfaces.length) throw new Error(`Provider ${providerId} advertises no surfaces.`);
|
||||||
|
return { ...providerAdvertisement, providerId, surfaces };
|
||||||
|
}
|
||||||
|
|
||||||
|
export function normalizeSurfaceDocument(surfaceDocument) {
|
||||||
|
if (!surfaceDocument || typeof surfaceDocument !== "object") {
|
||||||
|
throw new Error("Surface document is required.");
|
||||||
|
}
|
||||||
|
if (surfaceDocument.schema !== "gamecult.eve.surface.v1") {
|
||||||
|
throw new Error(`Unexpected surface schema: ${surfaceDocument.schema || ""}`);
|
||||||
|
}
|
||||||
|
const surface = objectValue(surfaceDocument.surface);
|
||||||
|
const surfaceId = firstString(surface.id);
|
||||||
|
if (!surfaceId) throw new Error("Surface document missing surface.id.");
|
||||||
|
const root = objectValue(surface.root);
|
||||||
|
if (!root.id) throw new Error(`Surface document ${surfaceId} missing surface.root.`);
|
||||||
|
return { ...surfaceDocument, surfaceId, root };
|
||||||
|
}
|
||||||
|
|
||||||
|
function normalizeWorldInteraction(value) {
|
||||||
|
const source = objectValue(value);
|
||||||
|
return {
|
||||||
|
projectionKind: firstString(source.projectionKind),
|
||||||
|
commandBoundary: firstString(source.commandBoundary),
|
||||||
|
receiptSchema: firstString(source.receiptSchema),
|
||||||
|
ownership: firstString(source.ownership),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function buildComponentLines(component, width, depth = 0) {
|
||||||
|
const source = objectValue(component);
|
||||||
|
const kind = firstString(source.kind) || "component";
|
||||||
|
const id = firstString(source.id) || "(anonymous)";
|
||||||
|
const props = objectValue(source.props);
|
||||||
|
const label = firstString(props.label, props.title, props.text, props.bind, props.command, props.fieldId);
|
||||||
|
const indent = " ".repeat(Math.min(depth, 6));
|
||||||
|
const pluginProjection = buildPluginProjection(kind, source);
|
||||||
|
const pluginSuffix = pluginProjection
|
||||||
|
? ` [${pluginProjection.pluginId}:${pluginProjection.semanticOwner}]`
|
||||||
|
: "";
|
||||||
|
const ownLine = fitLine(`${indent}${terminalElementKind(kind)} ${id}${label ? ` ${label}` : ""}${pluginSuffix}`, width);
|
||||||
|
const children = Array.isArray(source.children) ? source.children : [];
|
||||||
|
const embeddedDocuments = normalizeEmbeddedDocuments(source.embeddedDocuments);
|
||||||
|
return [
|
||||||
|
ownLine,
|
||||||
|
...embeddedDocuments.map(document => fitLine(`${indent} slot ${document.slotId || "(slot)"} ${document.documentId || "(document)"}`, width)),
|
||||||
|
...children.flatMap(child => buildComponentLines(child, width, depth + 1)),
|
||||||
|
];
|
||||||
|
}
|
||||||
|
|
||||||
|
function collectEmbeddedDocumentSlots(component, slots = []) {
|
||||||
|
const source = objectValue(component);
|
||||||
|
const ownerId = firstString(source.id);
|
||||||
|
for (const document of normalizeEmbeddedDocuments(source.embeddedDocuments)) {
|
||||||
|
slots.push({ ownerId, ...document });
|
||||||
|
}
|
||||||
|
for (const child of Array.isArray(source.children) ? source.children : []) {
|
||||||
|
collectEmbeddedDocumentSlots(child, slots);
|
||||||
|
}
|
||||||
|
return slots;
|
||||||
|
}
|
||||||
|
|
||||||
|
function collectPluginProjections(component, projections = []) {
|
||||||
|
const source = objectValue(component);
|
||||||
|
const projection = buildPluginProjection(firstString(source.kind), source);
|
||||||
|
if (projection) {
|
||||||
|
projections.push({
|
||||||
|
ownerId: firstString(source.id),
|
||||||
|
...projection,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
for (const child of Array.isArray(source.children) ? source.children : []) {
|
||||||
|
collectPluginProjections(child, projections);
|
||||||
|
}
|
||||||
|
return projections;
|
||||||
|
}
|
||||||
|
|
||||||
|
function normalizeEmbeddedDocuments(value) {
|
||||||
|
return Array.isArray(value)
|
||||||
|
? value
|
||||||
|
.filter(document => document && typeof document === "object")
|
||||||
|
.map(document => ({
|
||||||
|
slotId: firstString(document.slotId, document.id),
|
||||||
|
documentId: firstString(document.documentId, document.href, document.url),
|
||||||
|
schemaId: firstString(document.schemaId, document.schema),
|
||||||
|
presentationKind: firstString(document.presentationKind, document.kind),
|
||||||
|
}))
|
||||||
|
.filter(document => document.slotId || document.documentId)
|
||||||
|
: [];
|
||||||
|
}
|
||||||
|
|
||||||
|
function terminalElementKind(componentKind) {
|
||||||
|
if (!componentKind) return "empty";
|
||||||
|
if (componentKind === "vn.stage") return "sai-vn";
|
||||||
|
if (componentKind === "embed.norn") return "norn";
|
||||||
|
if (componentKind === "embed.tex") return "tex";
|
||||||
|
if (componentKind.startsWith("control.")) return "command";
|
||||||
|
if (componentKind.startsWith("embed.")) return "plugin";
|
||||||
|
if (componentKind === "surface.slot") return "slot";
|
||||||
|
if (componentKind.startsWith("field.") || componentKind.startsWith("world.")) return "world";
|
||||||
|
if (componentKind.startsWith("text.") || componentKind === "text" || componentKind === "label") return "text";
|
||||||
|
if (componentKind === "metric") return "metric";
|
||||||
|
return componentKind;
|
||||||
|
}
|
||||||
|
|
||||||
|
function buildPluginProjection(componentKind, component) {
|
||||||
|
const props = objectValue(component.props);
|
||||||
|
if (componentKind === "vn.stage") {
|
||||||
|
return {
|
||||||
|
pluginId: "sai.vn",
|
||||||
|
projectionKind: "sai-vn-terminal-stage-summary",
|
||||||
|
abiSchema: "gamecult.eve.plugin_abi.v1",
|
||||||
|
commandBoundary: "sidecar-advertised-plugin-abi",
|
||||||
|
capabilities: ["vn.stage", "story.choose", "story.continue", "story.jump"],
|
||||||
|
documentId: firstString(props.storyId, component.id),
|
||||||
|
semanticOwner: "Sai",
|
||||||
|
availability: "required",
|
||||||
|
fallbackKind: "terminal-summary",
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
if (componentKind === "embed.norn") {
|
||||||
|
return {
|
||||||
|
pluginId: "norn.graph",
|
||||||
|
projectionKind: "norn-graph-terminal-outline",
|
||||||
|
abiSchema: "gamecult.eve.plugin_abi.v1",
|
||||||
|
commandBoundary: "sidecar-advertised-plugin-abi",
|
||||||
|
capabilities: ["embed.norn"],
|
||||||
|
documentId: firstString(props.sourceUri, props.documentId, component.id),
|
||||||
|
semanticOwner: "Norn",
|
||||||
|
availability: "optional-nested",
|
||||||
|
fallbackKind: "terminal-outline",
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
if (componentKind === "embed.tex") {
|
||||||
|
return {
|
||||||
|
pluginId: "tex.math",
|
||||||
|
projectionKind: texProjectionKind(props),
|
||||||
|
abiSchema: "gamecult.eve.plugin_abi.v1",
|
||||||
|
commandBoundary: "sidecar-advertised-plugin-abi",
|
||||||
|
capabilities: ["embed.tex", "tex.inline", "tex.block"],
|
||||||
|
documentId: firstString(props.sourceUri, props.source, component.id),
|
||||||
|
semanticOwner: "EvePlugins",
|
||||||
|
availability: "optional-nested",
|
||||||
|
fallbackKind: "source-text",
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
function texProjectionKind(props) {
|
||||||
|
const display = firstString(props.display, "inline");
|
||||||
|
if (display === "block") return "tex-math-terminal-block-source";
|
||||||
|
if (display === "page") return "tex-math-terminal-page-source";
|
||||||
|
return "tex-math-terminal-inline-source";
|
||||||
|
}
|
||||||
|
|
||||||
|
function fitLine(value, width) {
|
||||||
|
const text = String(value || "");
|
||||||
|
if (text.length <= width) return text;
|
||||||
|
return `${text.slice(0, Math.max(0, width - 3))}...`;
|
||||||
|
}
|
||||||
|
|
||||||
|
function objectValue(value) {
|
||||||
|
return value && typeof value === "object" && !Array.isArray(value) ? value : {};
|
||||||
|
}
|
||||||
|
|
||||||
|
function firstString(...values) {
|
||||||
|
for (const value of values) {
|
||||||
|
if (typeof value === "string" && value.trim()) return value;
|
||||||
|
if (typeof value === "number" && Number.isFinite(value)) return String(value);
|
||||||
|
}
|
||||||
|
return "";
|
||||||
|
}
|
||||||
71
test-support/schema-subset.mjs
Normal file
71
test-support/schema-subset.mjs
Normal file
|
|
@ -0,0 +1,71 @@
|
||||||
|
export function validateSchemaSubset(schema, value, pointer = "$", rootSchema = schema) {
|
||||||
|
const errors = [];
|
||||||
|
if (!schema || typeof schema !== "object") return errors;
|
||||||
|
|
||||||
|
if (schema.$ref) {
|
||||||
|
const resolved = resolveSchemaReference(rootSchema, schema.$ref);
|
||||||
|
return resolved
|
||||||
|
? validateSchemaSubset(resolved, value, pointer, rootSchema)
|
||||||
|
: [`${pointer}:unresolved-ref:${schema.$ref}`];
|
||||||
|
}
|
||||||
|
|
||||||
|
if (schema.const !== undefined && value !== schema.const) {
|
||||||
|
errors.push(`${pointer}:const:${schema.const}`);
|
||||||
|
}
|
||||||
|
if (schema.enum && !schema.enum.includes(value)) {
|
||||||
|
errors.push(`${pointer}:enum:${schema.enum.join("|")}`);
|
||||||
|
}
|
||||||
|
if (schema.type && !matchesSchemaType(value, schema.type)) {
|
||||||
|
errors.push(`${pointer}:type:${schema.type}`);
|
||||||
|
return errors;
|
||||||
|
}
|
||||||
|
if (schema.minLength !== undefined && typeof value === "string" && value.length < schema.minLength) {
|
||||||
|
errors.push(`${pointer}:minLength:${schema.minLength}`);
|
||||||
|
}
|
||||||
|
if (schema.minItems !== undefined && Array.isArray(value) && value.length < schema.minItems) {
|
||||||
|
errors.push(`${pointer}:minItems:${schema.minItems}`);
|
||||||
|
}
|
||||||
|
if (schema.required && value && typeof value === "object" && !Array.isArray(value)) {
|
||||||
|
for (const key of schema.required) {
|
||||||
|
if (value[key] === undefined) errors.push(`${pointer}.${key}:required`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (schema.properties && value && typeof value === "object" && !Array.isArray(value)) {
|
||||||
|
for (const [key, childSchema] of Object.entries(schema.properties)) {
|
||||||
|
if (value[key] !== undefined) {
|
||||||
|
errors.push(...validateSchemaSubset(childSchema, value[key], `${pointer}.${key}`, rootSchema));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (schema.items && Array.isArray(value)) {
|
||||||
|
value.forEach((item, index) => {
|
||||||
|
errors.push(...validateSchemaSubset(schema.items, item, `${pointer}[${index}]`, rootSchema));
|
||||||
|
});
|
||||||
|
}
|
||||||
|
return errors;
|
||||||
|
}
|
||||||
|
|
||||||
|
function resolveSchemaReference(rootSchema, reference) {
|
||||||
|
if (!reference.startsWith("#/")) return null;
|
||||||
|
return reference.slice(2).split("/").reduce((current, segment) => {
|
||||||
|
if (!current || typeof current !== "object") return null;
|
||||||
|
return current[segment.replaceAll("~1", "/").replaceAll("~0", "~")];
|
||||||
|
}, rootSchema);
|
||||||
|
}
|
||||||
|
|
||||||
|
function matchesSchemaType(value, type) {
|
||||||
|
switch (type) {
|
||||||
|
case "array":
|
||||||
|
return Array.isArray(value);
|
||||||
|
case "object":
|
||||||
|
return value !== null && typeof value === "object" && !Array.isArray(value);
|
||||||
|
case "string":
|
||||||
|
return typeof value === "string";
|
||||||
|
case "number":
|
||||||
|
return typeof value === "number";
|
||||||
|
case "boolean":
|
||||||
|
return typeof value === "boolean";
|
||||||
|
default:
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
256
test/eve-tui-shell.test.mjs
Normal file
256
test/eve-tui-shell.test.mjs
Normal file
|
|
@ -0,0 +1,256 @@
|
||||||
|
import assert from "node:assert/strict";
|
||||||
|
import { readFileSync } from "node:fs";
|
||||||
|
import path from "node:path";
|
||||||
|
import test from "node:test";
|
||||||
|
import { fileURLToPath } from "node:url";
|
||||||
|
import { validateSchemaSubset } from "../test-support/schema-subset.mjs";
|
||||||
|
import { EveTuiShell } from "../src/eve-tui-shell.mjs";
|
||||||
|
|
||||||
|
const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../Eve");
|
||||||
|
const tuiGridSchema = JSON.parse(readFileSync(
|
||||||
|
path.join(repoRoot, "schemas/gamecult.eve.tui_grid.v1.schema.json"),
|
||||||
|
"utf8",
|
||||||
|
));
|
||||||
|
|
||||||
|
test("selects advertised provider surfaces for compact projection", () => {
|
||||||
|
const shell = new EveTuiShell({ width: 48 });
|
||||||
|
const selected = shell.selectSurface(advertisement(), "aetheria.daemon.editor");
|
||||||
|
|
||||||
|
assert.equal(selected.providerId, "aetheria");
|
||||||
|
assert.equal(selected.surfaceId, "aetheria.daemon.editor");
|
||||||
|
assert.equal(selected.worldInteraction.commandBoundary, "aetheria.daemon.commands");
|
||||||
|
assert.equal(selected.worldInteraction.receiptSchema, "aetheria.eve_command_acceptance_status.v1");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("command intents carry provider-advertised boundaries", () => {
|
||||||
|
const shell = new EveTuiShell();
|
||||||
|
const intent = shell.createCommandIntent(
|
||||||
|
advertisement(),
|
||||||
|
"aetheria.daemon.game",
|
||||||
|
"aetheria.daemon.commands",
|
||||||
|
{
|
||||||
|
action: {
|
||||||
|
commandBoundary: "component.fallback.boundary",
|
||||||
|
receiptSchema: "component.fallback.receipt.v1",
|
||||||
|
target: "component.fallback.target",
|
||||||
|
},
|
||||||
|
commandId: "aetheria.daemon.focus",
|
||||||
|
},
|
||||||
|
);
|
||||||
|
|
||||||
|
assert.equal(intent.schema, "gamecult.eve.command_invocation.v1");
|
||||||
|
assert.equal(intent.providerId, "aetheria");
|
||||||
|
assert.equal(intent.surfaceId, "aetheria.daemon.game");
|
||||||
|
assert.equal(intent.commandBoundary, "aetheria.daemon.commands");
|
||||||
|
assert.equal(intent.receiptSchema, "aetheria.eve_command_acceptance_status.v1");
|
||||||
|
assert.equal(intent.clientId, "tui");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("summary grid is explicitly lossy provider-shell evidence", () => {
|
||||||
|
const shell = new EveTuiShell({ width: 36 });
|
||||||
|
const grid = shell.renderSummary(advertisement(), "aetheria.daemon.game");
|
||||||
|
|
||||||
|
assert.deepEqual(validateSchemaSubset(tuiGridSchema, grid), []);
|
||||||
|
assert.equal(grid.schema, "gamecult.eve.tui_grid.v1");
|
||||||
|
assert.equal(grid.runtimeId, "tui");
|
||||||
|
assert.equal(grid.surfaceId, "aetheria.daemon.game");
|
||||||
|
assert.match(grid.lossiness, /use lowerSurface/);
|
||||||
|
assert.ok(grid.lines.every(line => line.length <= 36));
|
||||||
|
});
|
||||||
|
|
||||||
|
test("lowers provider surface trees into a terminal grid", () => {
|
||||||
|
const shell = new EveTuiShell({ width: 44 });
|
||||||
|
const grid = shell.lowerSurface(surfaceDocument(), advertisement(), "aetheria.daemon.game");
|
||||||
|
|
||||||
|
assert.deepEqual(validateSchemaSubset(tuiGridSchema, grid), []);
|
||||||
|
assert.equal(grid.schema, "gamecult.eve.tui_grid.v1");
|
||||||
|
assert.equal(grid.runtimeId, "tui");
|
||||||
|
assert.equal(grid.providerId, "aetheria");
|
||||||
|
assert.equal(grid.surfaceId, "aetheria.daemon.game");
|
||||||
|
assert.equal(grid.projectionKind, "provider-authored-world-surface");
|
||||||
|
assert.equal(grid.commandBoundary, "aetheria.daemon.commands");
|
||||||
|
assert.equal(grid.receiptSchema, "aetheria.eve_command_acceptance_status.v1");
|
||||||
|
assert.match(grid.lossiness, /terminal-grid-command-surface/);
|
||||||
|
assert.ok(grid.lines.every(line => line.length <= 44));
|
||||||
|
assert.ok(grid.lines.some(line => line.includes("world aetheria.daemon.game.gravity")));
|
||||||
|
assert.ok(grid.lines.some(line => line.includes("command aetheria.daemon.game.focus")));
|
||||||
|
assert.ok(grid.lines.some(line => line.includes("norn aetheria.daemon.game.norn")));
|
||||||
|
assert.ok(grid.lines.some(line => line.includes("slot norn.map")));
|
||||||
|
assert.deepEqual(grid.pluginProjections, [
|
||||||
|
{
|
||||||
|
ownerId: "aetheria.daemon.game.norn",
|
||||||
|
pluginId: "norn.graph",
|
||||||
|
projectionKind: "norn-graph-terminal-outline",
|
||||||
|
abiSchema: "gamecult.eve.plugin_abi.v1",
|
||||||
|
commandBoundary: "sidecar-advertised-plugin-abi",
|
||||||
|
capabilities: ["embed.norn"],
|
||||||
|
documentId: "aetheria.daemon.game.norn",
|
||||||
|
semanticOwner: "Norn",
|
||||||
|
availability: "optional-nested",
|
||||||
|
fallbackKind: "terminal-outline",
|
||||||
|
},
|
||||||
|
]);
|
||||||
|
assert.deepEqual(grid.embeddedDocumentSlots, [
|
||||||
|
{
|
||||||
|
ownerId: "aetheria.daemon.game.norn",
|
||||||
|
slotId: "norn.map",
|
||||||
|
documentId: "cultmesh://aetheria/norn/map",
|
||||||
|
schemaId: "gamecult.eve.surface.v1",
|
||||||
|
presentationKind: "terminal-grid-slot",
|
||||||
|
},
|
||||||
|
]);
|
||||||
|
});
|
||||||
|
|
||||||
|
test("rejects surface documents that do not match the advertised TUI target", () => {
|
||||||
|
const shell = new EveTuiShell();
|
||||||
|
assert.throws(
|
||||||
|
() => shell.lowerSurface(surfaceDocument("aetheria.daemon.game"), advertisement(), "aetheria.daemon.editor"),
|
||||||
|
/does not match advertised TUI surface/,
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
test("lowers Sai, Norn, and TeX plugin surfaces into compact terminal fallbacks", () => {
|
||||||
|
const shell = new EveTuiShell({ width: 72 });
|
||||||
|
const saiSurface = JSON.parse(readFileSync(path.join(repoRoot, "web/fixtures/sai-vn-surface.json"), "utf8"));
|
||||||
|
const grid = shell.lowerSurface(saiSurface, saiAdvertisement(), "sai.visual_novel.surface");
|
||||||
|
|
||||||
|
assert.deepEqual(validateSchemaSubset(tuiGridSchema, grid), []);
|
||||||
|
assert.equal(grid.providerId, "gamecult.home.vn");
|
||||||
|
assert.equal(grid.surfaceId, "sai.visual_novel.surface");
|
||||||
|
assert.ok(grid.lines.every(line => line.length <= 72));
|
||||||
|
assert.ok(grid.lines.some(line => line.includes("sai-vn sai.root")));
|
||||||
|
assert.ok(grid.lines.some(line => line.includes("norn sai.graph")));
|
||||||
|
assert.ok(grid.lines.some(line => line.includes("tex sai.tex.log-power")));
|
||||||
|
|
||||||
|
const byPlugin = new Map(grid.pluginProjections.map(projection => [projection.pluginId, projection]));
|
||||||
|
assert.equal(byPlugin.get("sai.vn").semanticOwner, "Sai");
|
||||||
|
assert.equal(byPlugin.get("sai.vn").availability, "required");
|
||||||
|
assert.equal(byPlugin.get("sai.vn").projectionKind, "sai-vn-terminal-stage-summary");
|
||||||
|
assert.deepEqual(byPlugin.get("sai.vn").capabilities, [
|
||||||
|
"vn.stage",
|
||||||
|
"story.choose",
|
||||||
|
"story.continue",
|
||||||
|
"story.jump",
|
||||||
|
]);
|
||||||
|
assert.equal(byPlugin.get("norn.graph").semanticOwner, "Norn");
|
||||||
|
assert.equal(byPlugin.get("norn.graph").availability, "optional-nested");
|
||||||
|
assert.equal(byPlugin.get("norn.graph").fallbackKind, "terminal-outline");
|
||||||
|
assert.equal(byPlugin.get("tex.math").semanticOwner, "EvePlugins");
|
||||||
|
assert.equal(byPlugin.get("tex.math").availability, "optional-nested");
|
||||||
|
assert.equal(byPlugin.get("tex.math").projectionKind, "tex-math-terminal-block-source");
|
||||||
|
assert.equal(byPlugin.get("tex.math").fallbackKind, "source-text");
|
||||||
|
assert.equal(byPlugin.get("tex.math").documentId, "\\\\mathrm{votes}(p)=1+\\\\lfloor\\\\log_b(1+p)\\\\rfloor");
|
||||||
|
});
|
||||||
|
|
||||||
|
function advertisement() {
|
||||||
|
return {
|
||||||
|
schema: "gamecult.eve.provider_advertisement.v1",
|
||||||
|
providerId: "aetheria",
|
||||||
|
title: "Aetheria",
|
||||||
|
surfaces: [
|
||||||
|
{
|
||||||
|
surfaceId: "aetheria.daemon.game",
|
||||||
|
transport: "local-json",
|
||||||
|
url: "conformance/eve/aetheria-world-surface.json",
|
||||||
|
worldInteraction: {
|
||||||
|
projectionKind: "provider-authored-world-surface",
|
||||||
|
commandBoundary: "aetheria.daemon.commands",
|
||||||
|
receiptSchema: "aetheria.eve_command_acceptance_status.v1",
|
||||||
|
ownership: "provider-owns-world-state-assets-command-acceptance-and-receipts",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
surfaceId: "aetheria.daemon.editor",
|
||||||
|
transport: "local-json",
|
||||||
|
url: "conformance/eve/aetheria-world-surface.json",
|
||||||
|
worldInteraction: {
|
||||||
|
projectionKind: "provider-authored-world-editor-surface",
|
||||||
|
commandBoundary: "aetheria.daemon.commands",
|
||||||
|
receiptSchema: "aetheria.eve_command_acceptance_status.v1",
|
||||||
|
ownership: "provider-owns-editor-state-assets-command-acceptance-and-receipts",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function saiAdvertisement() {
|
||||||
|
return {
|
||||||
|
schema: "gamecult.eve.provider_advertisement.v1",
|
||||||
|
providerId: "gamecult.home.vn",
|
||||||
|
title: "GameCult Compound VN",
|
||||||
|
surfaces: [
|
||||||
|
{
|
||||||
|
surfaceId: "sai.visual_novel.surface",
|
||||||
|
transport: "local-json",
|
||||||
|
url: "web/fixtures/sai-vn-surface.json",
|
||||||
|
worldInteraction: {
|
||||||
|
projectionKind: "provider-authored-world-surface",
|
||||||
|
commandBoundary: "sai.vn.plugin.commands",
|
||||||
|
receiptSchema: "gamecult.eve.command_receipt.v1",
|
||||||
|
ownership: "provider-owns-story-state-plugin-sidecars-own-nested-semantics",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function surfaceDocument(surfaceId = "aetheria.daemon.game") {
|
||||||
|
return {
|
||||||
|
type: "surface-state",
|
||||||
|
schema: "gamecult.eve.surface.v1",
|
||||||
|
providerId: "aetheria",
|
||||||
|
providerKind: "game.runtime",
|
||||||
|
title: "Aetheria world",
|
||||||
|
version: 1,
|
||||||
|
updatedAtUtc: "2026-07-09T00:00:00Z",
|
||||||
|
surface: {
|
||||||
|
id: surfaceId,
|
||||||
|
root: {
|
||||||
|
id: `${surfaceId}.root`,
|
||||||
|
kind: "surface",
|
||||||
|
props: {},
|
||||||
|
children: [
|
||||||
|
{
|
||||||
|
id: `${surfaceId}.gravity`,
|
||||||
|
kind: "field.surface2d",
|
||||||
|
props: {
|
||||||
|
label: "Current Zone Gravity",
|
||||||
|
bind: "aetheria.daemon.soaView.gravityField",
|
||||||
|
fieldId: "aetheria.zone.gravity",
|
||||||
|
},
|
||||||
|
children: [],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: `${surfaceId}.focus`,
|
||||||
|
kind: "control.button",
|
||||||
|
props: {
|
||||||
|
label: "Focus Relay",
|
||||||
|
command: "aetheria.daemon.commands",
|
||||||
|
commandId: "aetheria.daemon.focus",
|
||||||
|
},
|
||||||
|
children: [],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: `${surfaceId}.norn`,
|
||||||
|
kind: "embed.norn",
|
||||||
|
props: {
|
||||||
|
label: "Norn tactical map",
|
||||||
|
},
|
||||||
|
embeddedDocuments: [
|
||||||
|
{
|
||||||
|
slotId: "norn.map",
|
||||||
|
documentId: "cultmesh://aetheria/norn/map",
|
||||||
|
schemaId: "gamecult.eve.surface.v1",
|
||||||
|
presentationKind: "terminal-grid-slot",
|
||||||
|
},
|
||||||
|
],
|
||||||
|
children: [],
|
||||||
|
},
|
||||||
|
],
|
||||||
|
},
|
||||||
|
styles: [],
|
||||||
|
},
|
||||||
|
commands: [],
|
||||||
|
};
|
||||||
|
}
|
||||||
118
tools/evetui/evetui-capture-artifact.mjs
Normal file
118
tools/evetui/evetui-capture-artifact.mjs
Normal file
|
|
@ -0,0 +1,118 @@
|
||||||
|
import { mkdirSync, writeFileSync } from "node:fs";
|
||||||
|
import path from "node:path";
|
||||||
|
import { fileURLToPath } from "node:url";
|
||||||
|
import { EveTuiShell } from "../../src/eve-tui-shell.mjs";
|
||||||
|
import { buildTuiCaptureRequest, loadJsonFile, writeCaptureRequest } from "./evetui-capture-contract.mjs";
|
||||||
|
|
||||||
|
export function buildTuiCaptureArtifact({
|
||||||
|
advertisement,
|
||||||
|
capabilityManifest,
|
||||||
|
surfaceDocument,
|
||||||
|
advertisementPath = "",
|
||||||
|
capabilityManifestPath = "",
|
||||||
|
captureSurfaceId = "",
|
||||||
|
stamp = "latest",
|
||||||
|
width = 80,
|
||||||
|
} = {}) {
|
||||||
|
const request = buildTuiCaptureRequest({
|
||||||
|
advertisement,
|
||||||
|
capabilityManifest,
|
||||||
|
advertisementPath,
|
||||||
|
capabilityManifestPath,
|
||||||
|
captureSurfaceId,
|
||||||
|
stamp,
|
||||||
|
});
|
||||||
|
const shell = new EveTuiShell({ width });
|
||||||
|
const grid = shell.lowerSurface(surfaceDocument, advertisement, request.surfaceId);
|
||||||
|
validateGridArtifact(grid, request);
|
||||||
|
|
||||||
|
return {
|
||||||
|
request,
|
||||||
|
grid: {
|
||||||
|
...grid,
|
||||||
|
artifactKind: request.artifactKind,
|
||||||
|
captureKind: request.captureKind,
|
||||||
|
sourceAdvertisementPath: request.sourceAdvertisementPath,
|
||||||
|
sourceCapabilityManifestPath: request.sourceCapabilityManifestPath,
|
||||||
|
issuedAtUtc: request.issuedAtUtc,
|
||||||
|
},
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
export function writeTuiCaptureArtifact({ request, grid }, { outputPath, requestOutputPath = "" } = {}) {
|
||||||
|
if (!outputPath) throw new Error("outputPath is required");
|
||||||
|
mkdirSync(path.dirname(outputPath), { recursive: true });
|
||||||
|
writeFileSync(outputPath, `${JSON.stringify(grid, null, 2)}\n`, "utf8");
|
||||||
|
if (requestOutputPath) {
|
||||||
|
writeCaptureRequest(request, requestOutputPath);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function validateGridArtifact(grid, request) {
|
||||||
|
if (grid.schema !== "gamecult.eve.tui_grid.v1") {
|
||||||
|
throw new Error(`Unexpected TUI grid schema: ${grid.schema || ""}`);
|
||||||
|
}
|
||||||
|
for (const [field, expected] of [
|
||||||
|
["runtimeId", request.runtimeId],
|
||||||
|
["providerId", request.providerId],
|
||||||
|
["surfaceId", request.surfaceId],
|
||||||
|
["projectionKind", request.projectionKind],
|
||||||
|
["commandBoundary", request.commandBoundary],
|
||||||
|
["receiptSchema", request.receiptSchema],
|
||||||
|
]) {
|
||||||
|
if ((grid[field] || "") !== (expected || "")) {
|
||||||
|
throw new Error(`TUI grid ${field} expected ${expected || ""} got ${grid[field] || ""}`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (!Array.isArray(grid.lines) || !grid.lines.length) {
|
||||||
|
throw new Error("TUI grid artifact must contain at least one line");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function parseArgs(argv) {
|
||||||
|
const args = {};
|
||||||
|
for (let index = 0; index < argv.length; index += 1) {
|
||||||
|
const value = argv[index];
|
||||||
|
if (!value.startsWith("--")) continue;
|
||||||
|
const key = value.slice(2);
|
||||||
|
const next = argv[index + 1];
|
||||||
|
if (!next || next.startsWith("--")) {
|
||||||
|
args[key] = true;
|
||||||
|
} else {
|
||||||
|
args[key] = next;
|
||||||
|
index += 1;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return args;
|
||||||
|
}
|
||||||
|
|
||||||
|
function runCli() {
|
||||||
|
const args = parseArgs(process.argv.slice(2));
|
||||||
|
for (const required of ["advertisement", "capability", "surface", "output"]) {
|
||||||
|
if (!args[required]) {
|
||||||
|
throw new Error(`missing required --${required}`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const stamp = args.stamp || "latest";
|
||||||
|
const artifact = buildTuiCaptureArtifact({
|
||||||
|
advertisement: loadJsonFile(args.advertisement),
|
||||||
|
capabilityManifest: loadJsonFile(args.capability),
|
||||||
|
surfaceDocument: loadJsonFile(args.surface),
|
||||||
|
advertisementPath: args.advertisement,
|
||||||
|
capabilityManifestPath: args.capability,
|
||||||
|
captureSurfaceId: args["surface-id"] || "",
|
||||||
|
stamp,
|
||||||
|
width: Number(args.width || 80),
|
||||||
|
});
|
||||||
|
writeTuiCaptureArtifact(artifact, {
|
||||||
|
outputPath: args.output,
|
||||||
|
requestOutputPath: args["request-output"] || "",
|
||||||
|
});
|
||||||
|
process.stdout.write(`${args.output}\n`);
|
||||||
|
}
|
||||||
|
|
||||||
|
const invokedPath = process.argv[1] ? path.resolve(process.argv[1]) : "";
|
||||||
|
const modulePath = fileURLToPath(import.meta.url);
|
||||||
|
if (invokedPath === modulePath) {
|
||||||
|
runCli();
|
||||||
|
}
|
||||||
57
tools/evetui/evetui-capture-artifact.test.mjs
Normal file
57
tools/evetui/evetui-capture-artifact.test.mjs
Normal file
|
|
@ -0,0 +1,57 @@
|
||||||
|
import assert from "node:assert/strict";
|
||||||
|
import { readFileSync } from "node:fs";
|
||||||
|
import test from "node:test";
|
||||||
|
import { buildTuiCaptureArtifact } from "./evetui-capture-artifact.mjs";
|
||||||
|
|
||||||
|
const advertisement = JSON.parse(readFileSync(new URL("../../../Aetheria/conformance/eve/aetheria.provider-advertisement.json", import.meta.url), "utf8"));
|
||||||
|
const capabilityManifest = JSON.parse(readFileSync(new URL("../../eve-runtime-capability.json", import.meta.url), "utf8"));
|
||||||
|
const surfaceDocument = JSON.parse(readFileSync(new URL("../../../Aetheria/conformance/eve/aetheria-world-surface.json", import.meta.url), "utf8"));
|
||||||
|
const worldSmokeAdvertisement = JSON.parse(readFileSync(new URL("../../../Eve/web/fixtures/eve-world-smoke.provider-advertisement.json", import.meta.url), "utf8"));
|
||||||
|
const worldSmokeSurfaceDocument = JSON.parse(readFileSync(new URL("../../../Eve/web/fixtures/eve-world-smoke-surface.json", import.meta.url), "utf8"));
|
||||||
|
|
||||||
|
test("builds TUI JSON grid capture artifact from provider advertisement and surface", () => {
|
||||||
|
const { request, grid } = buildTuiCaptureArtifact({
|
||||||
|
advertisement,
|
||||||
|
capabilityManifest,
|
||||||
|
surfaceDocument,
|
||||||
|
advertisementPath: "conformance/eve/aetheria.provider-advertisement.json",
|
||||||
|
capabilityManifestPath: "eve-runtime-capability.json",
|
||||||
|
stamp: "smoke",
|
||||||
|
width: 72,
|
||||||
|
});
|
||||||
|
|
||||||
|
assert.equal(request.artifactKind, "json-grid");
|
||||||
|
assert.equal(request.artifactPath, "artifacts/evetui-capture/smoke/tui-grid.json");
|
||||||
|
assert.equal(grid.schema, "gamecult.eve.tui_grid.v1");
|
||||||
|
assert.equal(grid.runtimeId, "tui");
|
||||||
|
assert.equal(grid.providerId, "aetheria");
|
||||||
|
assert.equal(grid.surfaceId, "aetheria.daemon.game");
|
||||||
|
assert.equal(grid.commandBoundary, "aetheria.daemon.commands");
|
||||||
|
assert.equal(grid.receiptSchema, "aetheria.eve_command_acceptance_status.v1");
|
||||||
|
assert.equal(grid.artifactKind, "json-grid");
|
||||||
|
assert.equal(grid.captureKind, "terminal-cell-grid");
|
||||||
|
assert.equal(grid.width, 72);
|
||||||
|
assert.ok(grid.lines.some(line => line.includes("aetheria.daemon.game")));
|
||||||
|
});
|
||||||
|
|
||||||
|
test("builds TUI JSON grid capture artifact from a generic world provider", () => {
|
||||||
|
const { grid } = buildTuiCaptureArtifact({
|
||||||
|
advertisement: worldSmokeAdvertisement,
|
||||||
|
capabilityManifest,
|
||||||
|
surfaceDocument: worldSmokeSurfaceDocument,
|
||||||
|
advertisementPath: "web/fixtures/eve-world-smoke.provider-advertisement.json",
|
||||||
|
capabilityManifestPath: "eve-runtime-capability.json",
|
||||||
|
stamp: "smoke",
|
||||||
|
width: 72,
|
||||||
|
});
|
||||||
|
|
||||||
|
assert.equal(grid.schema, "gamecult.eve.tui_grid.v1");
|
||||||
|
assert.equal(grid.runtimeId, "tui");
|
||||||
|
assert.equal(grid.providerId, "eve.world-smoke");
|
||||||
|
assert.equal(grid.surfaceId, "eve.world-smoke.surface");
|
||||||
|
assert.equal(grid.commandBoundary, "eve.world-smoke.commands");
|
||||||
|
assert.equal(grid.receiptSchema, "eve.world_smoke.command_receipt.v1");
|
||||||
|
assert.equal(grid.artifactKind, "json-grid");
|
||||||
|
assert.equal(grid.captureKind, "terminal-cell-grid");
|
||||||
|
assert.ok(grid.lines.some(line => line.includes("eve.world-smoke.surface")));
|
||||||
|
});
|
||||||
160
tools/evetui/evetui-capture-contract.mjs
Normal file
160
tools/evetui/evetui-capture-contract.mjs
Normal file
|
|
@ -0,0 +1,160 @@
|
||||||
|
import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
|
||||||
|
import path from "node:path";
|
||||||
|
import { fileURLToPath } from "node:url";
|
||||||
|
|
||||||
|
export function buildTuiCaptureRequest({
|
||||||
|
advertisement,
|
||||||
|
capabilityManifest,
|
||||||
|
advertisementPath = "",
|
||||||
|
capabilityManifestPath = "",
|
||||||
|
captureSurfaceId = "",
|
||||||
|
stamp = new Date().toISOString().replace(/[:.]/g, "-"),
|
||||||
|
} = {}) {
|
||||||
|
if (!advertisement || typeof advertisement !== "object") {
|
||||||
|
throw new Error("advertisement is required");
|
||||||
|
}
|
||||||
|
if (!capabilityManifest || typeof capabilityManifest !== "object") {
|
||||||
|
throw new Error("capabilityManifest is required");
|
||||||
|
}
|
||||||
|
|
||||||
|
const captureContract = capabilityManifest.lifecycle?.capture?.captureContract;
|
||||||
|
if (!captureContract) {
|
||||||
|
throw new Error("capability manifest is missing lifecycle.capture.captureContract");
|
||||||
|
}
|
||||||
|
|
||||||
|
const captureSurface = selectCaptureSurface(captureContract, advertisement.providerId, captureSurfaceId);
|
||||||
|
if (!captureSurface) {
|
||||||
|
if (captureSurfaceId) {
|
||||||
|
throw new Error(
|
||||||
|
`capture surface mismatch: expected ${captureSurfaceList(captureContract)} got ${advertisement.providerId || "missing"}:${captureSurfaceId}`,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
throw new Error(
|
||||||
|
`capture provider mismatch: expected ${captureProviderList(captureContract)} got ${advertisement.providerId || "missing"}`,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
const targetId = captureContract.targetId || captureContract.runtimeId;
|
||||||
|
const surface = (advertisement.surfaces || []).find(candidate => candidate.surfaceId === captureSurface.surfaceId);
|
||||||
|
if (!surface) {
|
||||||
|
throw new Error(`capture surface not advertised: ${captureSurface.surfaceId}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
const loweringTargets = surface.worldInteraction?.loweringTargets || [];
|
||||||
|
if (!loweringTargets.includes(targetId)) {
|
||||||
|
throw new Error(`surface ${surface.surfaceId} does not advertise lowering target ${targetId}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
const artifactPath = replaceStamp(captureContract.artifactPattern, stamp);
|
||||||
|
|
||||||
|
return {
|
||||||
|
schema: captureContract.requestSchema || "gamecult.eve.runtime_capture_request.v1",
|
||||||
|
runtimeId: capabilityManifest.runtimeId,
|
||||||
|
ownerRepo: captureContract.ownerRepo,
|
||||||
|
providerId: advertisement.providerId,
|
||||||
|
surfaceId: surface.surfaceId,
|
||||||
|
surfaceKind: surface.surfaceKind || "",
|
||||||
|
targetId,
|
||||||
|
projectionKind: surface.worldInteraction?.projectionKind || "",
|
||||||
|
commandBoundary: surface.worldInteraction?.commandBoundary || "",
|
||||||
|
receiptSchema: surface.worldInteraction?.receiptSchema || "",
|
||||||
|
captureKind: captureContract.captureKind,
|
||||||
|
artifactKind: captureContract.artifactKind,
|
||||||
|
artifactPath,
|
||||||
|
conformanceAttachment: captureContract.conformanceAttachment,
|
||||||
|
authority: captureContract.authority,
|
||||||
|
sourceAdvertisementPath: advertisementPath,
|
||||||
|
sourceCapabilityManifestPath: capabilityManifestPath,
|
||||||
|
issuedAtUtc: stamp,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
export function loadJsonFile(filePath) {
|
||||||
|
return JSON.parse(readFileSync(filePath, "utf8"));
|
||||||
|
}
|
||||||
|
|
||||||
|
export function writeCaptureRequest(request, outputPath) {
|
||||||
|
mkdirSync(path.dirname(outputPath), { recursive: true });
|
||||||
|
writeFileSync(outputPath, `${JSON.stringify(request, null, 2)}\n`, "utf8");
|
||||||
|
}
|
||||||
|
|
||||||
|
function replaceStamp(pattern, stamp) {
|
||||||
|
if (!pattern || !pattern.includes("{stamp}")) {
|
||||||
|
throw new Error(`capture artifact pattern must include {stamp}: ${pattern || "missing"}`);
|
||||||
|
}
|
||||||
|
return pattern.replace("{stamp}", stamp);
|
||||||
|
}
|
||||||
|
|
||||||
|
function selectCaptureSurface(captureContract, providerId, surfaceId = "") {
|
||||||
|
const claims = captureSurfaceClaims(captureContract).filter(claim => claim.providerId === providerId);
|
||||||
|
if (surfaceId) return claims.find(claim => claim.surfaceId === surfaceId) || null;
|
||||||
|
return claims[0] || null;
|
||||||
|
}
|
||||||
|
|
||||||
|
function captureProviderList(captureContract) {
|
||||||
|
return captureSurfaceClaims(captureContract).map(claim => claim.providerId).filter(Boolean).join(", ") || "missing";
|
||||||
|
}
|
||||||
|
|
||||||
|
function captureSurfaceList(captureContract) {
|
||||||
|
return captureSurfaceClaims(captureContract).map(claim => `${claim.providerId}:${claim.surfaceId}`).join(", ") || "missing";
|
||||||
|
}
|
||||||
|
|
||||||
|
function captureSurfaceClaims(captureContract) {
|
||||||
|
return [
|
||||||
|
{
|
||||||
|
providerId: captureContract.requiredProvider || "",
|
||||||
|
surfaceId: captureContract.requiredSurface || "",
|
||||||
|
},
|
||||||
|
...(Array.isArray(captureContract.additionalProviderSurfaces) ? captureContract.additionalProviderSurfaces : []),
|
||||||
|
]
|
||||||
|
.filter(claim => claim && typeof claim === "object")
|
||||||
|
.map(claim => ({
|
||||||
|
providerId: String(claim.providerId || ""),
|
||||||
|
surfaceId: String(claim.surfaceId || ""),
|
||||||
|
}))
|
||||||
|
.filter(claim => claim.providerId && claim.surfaceId);
|
||||||
|
}
|
||||||
|
|
||||||
|
function parseArgs(argv) {
|
||||||
|
const args = {};
|
||||||
|
for (let index = 0; index < argv.length; index += 1) {
|
||||||
|
const value = argv[index];
|
||||||
|
if (!value.startsWith("--")) continue;
|
||||||
|
const key = value.slice(2);
|
||||||
|
const next = argv[index + 1];
|
||||||
|
if (!next || next.startsWith("--")) {
|
||||||
|
args[key] = true;
|
||||||
|
} else {
|
||||||
|
args[key] = next;
|
||||||
|
index += 1;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return args;
|
||||||
|
}
|
||||||
|
|
||||||
|
function runCli() {
|
||||||
|
const args = parseArgs(process.argv.slice(2));
|
||||||
|
for (const required of ["advertisement", "capability", "output"]) {
|
||||||
|
if (!args[required]) {
|
||||||
|
throw new Error(`missing required --${required}`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const stamp = args.stamp || new Date().toISOString().replace(/[:.]/g, "-");
|
||||||
|
const request = buildTuiCaptureRequest({
|
||||||
|
advertisement: loadJsonFile(args.advertisement),
|
||||||
|
capabilityManifest: loadJsonFile(args.capability),
|
||||||
|
advertisementPath: args.advertisement,
|
||||||
|
capabilityManifestPath: args.capability,
|
||||||
|
captureSurfaceId: args["surface-id"] || "",
|
||||||
|
stamp,
|
||||||
|
});
|
||||||
|
writeCaptureRequest(request, args.output);
|
||||||
|
process.stdout.write(`${args.output}\n`);
|
||||||
|
}
|
||||||
|
|
||||||
|
const invokedPath = process.argv[1] ? path.resolve(process.argv[1]) : "";
|
||||||
|
const modulePath = fileURLToPath(import.meta.url);
|
||||||
|
if (invokedPath === modulePath) {
|
||||||
|
runCli();
|
||||||
|
}
|
||||||
78
tools/evetui/evetui-capture-contract.test.mjs
Normal file
78
tools/evetui/evetui-capture-contract.test.mjs
Normal file
|
|
@ -0,0 +1,78 @@
|
||||||
|
import assert from "node:assert/strict";
|
||||||
|
import { readFileSync } from "node:fs";
|
||||||
|
import test from "node:test";
|
||||||
|
import { buildTuiCaptureRequest } from "./evetui-capture-contract.mjs";
|
||||||
|
|
||||||
|
const advertisement = JSON.parse(readFileSync(new URL("../../../Aetheria/conformance/eve/aetheria.provider-advertisement.json", import.meta.url), "utf8"));
|
||||||
|
const worldSmokeAdvertisement = JSON.parse(readFileSync(new URL("../../../Eve/web/fixtures/eve-world-smoke.provider-advertisement.json", import.meta.url), "utf8"));
|
||||||
|
const capabilityManifest = JSON.parse(readFileSync(new URL("../../eve-runtime-capability.json", import.meta.url), "utf8"));
|
||||||
|
|
||||||
|
test("builds TUI capture request from provider advertisement", () => {
|
||||||
|
const request = buildTuiCaptureRequest({
|
||||||
|
advertisement,
|
||||||
|
capabilityManifest,
|
||||||
|
advertisementPath: "conformance/eve/aetheria.provider-advertisement.json",
|
||||||
|
capabilityManifestPath: "eve-runtime-capability.json",
|
||||||
|
stamp: "smoke",
|
||||||
|
});
|
||||||
|
|
||||||
|
assert.equal(request.schema, "gamecult.eve.runtime_capture_request.v1");
|
||||||
|
assert.equal(request.runtimeId, "tui");
|
||||||
|
assert.equal(request.ownerRepo, "EveTui");
|
||||||
|
assert.equal(request.providerId, "aetheria");
|
||||||
|
assert.equal(request.surfaceId, "aetheria.daemon.game");
|
||||||
|
assert.equal(request.targetId, "tui");
|
||||||
|
assert.equal(request.projectionKind, "provider-authored-world-surface");
|
||||||
|
assert.equal(request.commandBoundary, "aetheria.daemon.commands");
|
||||||
|
assert.equal(request.receiptSchema, "aetheria.eve_command_acceptance_status.v1");
|
||||||
|
assert.equal(request.captureKind, "terminal-cell-grid");
|
||||||
|
assert.equal(request.artifactKind, "json-grid");
|
||||||
|
assert.equal(request.artifactPath, "artifacts/evetui-capture/smoke/tui-grid.json");
|
||||||
|
assert.match(request.authority, /provider state/);
|
||||||
|
});
|
||||||
|
|
||||||
|
test("builds TUI capture request for Aetheria editor surface", () => {
|
||||||
|
const request = buildTuiCaptureRequest({
|
||||||
|
advertisement,
|
||||||
|
capabilityManifest,
|
||||||
|
captureSurfaceId: "aetheria.daemon.editor",
|
||||||
|
advertisementPath: "conformance/eve/aetheria.provider-advertisement.json",
|
||||||
|
capabilityManifestPath: "eve-runtime-capability.json",
|
||||||
|
stamp: "smoke",
|
||||||
|
});
|
||||||
|
|
||||||
|
assert.equal(request.runtimeId, "tui");
|
||||||
|
assert.equal(request.providerId, "aetheria");
|
||||||
|
assert.equal(request.surfaceId, "aetheria.daemon.editor");
|
||||||
|
assert.equal(request.surfaceKind, "interactive-world-editor");
|
||||||
|
assert.equal(request.projectionKind, "provider-authored-world-editor-surface");
|
||||||
|
assert.equal(request.commandBoundary, "aetheria.daemon.commands");
|
||||||
|
assert.equal(request.receiptSchema, "aetheria.eve_command_acceptance_status.v1");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("builds TUI capture request from a declared generic world provider", () => {
|
||||||
|
const request = buildTuiCaptureRequest({
|
||||||
|
advertisement: worldSmokeAdvertisement,
|
||||||
|
capabilityManifest,
|
||||||
|
advertisementPath: "web/fixtures/eve-world-smoke.provider-advertisement.json",
|
||||||
|
capabilityManifestPath: "eve-runtime-capability.json",
|
||||||
|
stamp: "smoke",
|
||||||
|
});
|
||||||
|
|
||||||
|
assert.equal(request.runtimeId, "tui");
|
||||||
|
assert.equal(request.providerId, "eve.world-smoke");
|
||||||
|
assert.equal(request.surfaceId, "eve.world-smoke.surface");
|
||||||
|
assert.equal(request.commandBoundary, "eve.world-smoke.commands");
|
||||||
|
assert.equal(request.receiptSchema, "eve.world_smoke.command_receipt.v1");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("rejects capture request when the surface does not advertise TUI", () => {
|
||||||
|
const withoutTarget = structuredClone(advertisement);
|
||||||
|
const surface = withoutTarget.surfaces.find(candidate => candidate.surfaceId === "aetheria.daemon.game");
|
||||||
|
surface.worldInteraction.loweringTargets = surface.worldInteraction.loweringTargets.filter(target => target !== "tui");
|
||||||
|
|
||||||
|
assert.throws(
|
||||||
|
() => buildTuiCaptureRequest({ advertisement: withoutTarget, capabilityManifest, stamp: "smoke" }),
|
||||||
|
/does not advertise lowering target tui/,
|
||||||
|
);
|
||||||
|
});
|
||||||
114
tools/evetui/evetui-release-contract.mjs
Normal file
114
tools/evetui/evetui-release-contract.mjs
Normal file
|
|
@ -0,0 +1,114 @@
|
||||||
|
import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
|
||||||
|
import path from "node:path";
|
||||||
|
import { fileURLToPath } from "node:url";
|
||||||
|
|
||||||
|
export function buildTuiReleaseRequest({
|
||||||
|
capabilityManifest,
|
||||||
|
packageManifest,
|
||||||
|
capabilityManifestPath = "",
|
||||||
|
packageManifestPath = "",
|
||||||
|
repository = "GameCult/EveTui",
|
||||||
|
} = {}) {
|
||||||
|
if (!capabilityManifest || typeof capabilityManifest !== "object") {
|
||||||
|
throw new Error("capabilityManifest is required");
|
||||||
|
}
|
||||||
|
if (!packageManifest || typeof packageManifest !== "object") {
|
||||||
|
throw new Error("packageManifest is required");
|
||||||
|
}
|
||||||
|
|
||||||
|
const releaseContract = capabilityManifest.lifecycle?.release?.releaseContract;
|
||||||
|
if (!releaseContract) {
|
||||||
|
throw new Error("capability manifest is missing lifecycle.release.releaseContract");
|
||||||
|
}
|
||||||
|
|
||||||
|
if (packageManifest.name !== releaseContract.packageName) {
|
||||||
|
throw new Error(`package name mismatch: expected ${releaseContract.packageName} got ${packageManifest.name || "missing"}`);
|
||||||
|
}
|
||||||
|
if (!packageManifest.version || !/^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/.test(packageManifest.version)) {
|
||||||
|
throw new Error(`package version is not a SemVer-compatible release version: ${packageManifest.version || "missing"}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
const tagName = replaceVersion(releaseContract.tagPattern, packageManifest.version);
|
||||||
|
const artifactPath = replaceVersion(
|
||||||
|
releaseContract.artifactPattern || `artifacts/evetui-release/{version}/${releaseContract.packageName}-{version}.tgz`,
|
||||||
|
packageManifest.version,
|
||||||
|
);
|
||||||
|
|
||||||
|
return {
|
||||||
|
schema: releaseContract.requestSchema || "gamecult.eve.runtime_release_request.v1",
|
||||||
|
ownerRepo: releaseContract.ownerRepo,
|
||||||
|
repository,
|
||||||
|
packageName: releaseContract.packageName,
|
||||||
|
version: packageManifest.version,
|
||||||
|
packageRoot: releaseContract.packageRoot,
|
||||||
|
versionSource: releaseContract.versionSource,
|
||||||
|
tagName,
|
||||||
|
artifactKind: releaseContract.artifactKind,
|
||||||
|
artifactPath,
|
||||||
|
publishProof: releaseContract.publishProof,
|
||||||
|
sourceCapabilityManifestPath: capabilityManifestPath,
|
||||||
|
sourcePackageManifestPath: packageManifestPath,
|
||||||
|
main: packageManifest.main || "",
|
||||||
|
scripts: packageManifest.scripts || {},
|
||||||
|
dependencies: packageManifest.dependencies || {},
|
||||||
|
devDependencies: packageManifest.devDependencies || {},
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
export function loadJsonFile(filePath) {
|
||||||
|
return JSON.parse(readFileSync(filePath, "utf8"));
|
||||||
|
}
|
||||||
|
|
||||||
|
export function writeReleaseRequest(request, outputPath) {
|
||||||
|
mkdirSync(path.dirname(outputPath), { recursive: true });
|
||||||
|
writeFileSync(outputPath, `${JSON.stringify(request, null, 2)}\n`, "utf8");
|
||||||
|
}
|
||||||
|
|
||||||
|
function replaceVersion(pattern, version) {
|
||||||
|
if (!pattern || !pattern.includes("{version}")) {
|
||||||
|
throw new Error(`release pattern must include {version}: ${pattern || "missing"}`);
|
||||||
|
}
|
||||||
|
return pattern.replaceAll("{version}", version);
|
||||||
|
}
|
||||||
|
|
||||||
|
function parseArgs(argv) {
|
||||||
|
const args = {};
|
||||||
|
for (let index = 0; index < argv.length; index += 1) {
|
||||||
|
const value = argv[index];
|
||||||
|
if (!value.startsWith("--")) continue;
|
||||||
|
const key = value.slice(2);
|
||||||
|
const next = argv[index + 1];
|
||||||
|
if (!next || next.startsWith("--")) {
|
||||||
|
args[key] = true;
|
||||||
|
} else {
|
||||||
|
args[key] = next;
|
||||||
|
index += 1;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return args;
|
||||||
|
}
|
||||||
|
|
||||||
|
function runCli() {
|
||||||
|
const args = parseArgs(process.argv.slice(2));
|
||||||
|
for (const required of ["capability", "package", "output"]) {
|
||||||
|
if (!args[required]) {
|
||||||
|
throw new Error(`missing required --${required}`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const request = buildTuiReleaseRequest({
|
||||||
|
capabilityManifest: loadJsonFile(args.capability),
|
||||||
|
packageManifest: loadJsonFile(args.package),
|
||||||
|
capabilityManifestPath: args.capability,
|
||||||
|
packageManifestPath: args.package,
|
||||||
|
repository: args.repository || "GameCult/EveTui",
|
||||||
|
});
|
||||||
|
writeReleaseRequest(request, args.output);
|
||||||
|
process.stdout.write(`${args.output}\n`);
|
||||||
|
}
|
||||||
|
|
||||||
|
const invokedPath = process.argv[1] ? path.resolve(process.argv[1]) : "";
|
||||||
|
const modulePath = fileURLToPath(import.meta.url);
|
||||||
|
if (invokedPath === modulePath) {
|
||||||
|
runCli();
|
||||||
|
}
|
||||||
37
tools/evetui/evetui-release-contract.test.mjs
Normal file
37
tools/evetui/evetui-release-contract.test.mjs
Normal file
|
|
@ -0,0 +1,37 @@
|
||||||
|
import assert from "node:assert/strict";
|
||||||
|
import { readFileSync } from "node:fs";
|
||||||
|
import test from "node:test";
|
||||||
|
import { buildTuiReleaseRequest } from "./evetui-release-contract.mjs";
|
||||||
|
|
||||||
|
const capabilityManifest = JSON.parse(readFileSync(new URL("../../eve-runtime-capability.json", import.meta.url), "utf8"));
|
||||||
|
const packageManifest = JSON.parse(readFileSync(new URL("../../package.json", import.meta.url), "utf8"));
|
||||||
|
|
||||||
|
test("builds EveTui release request from package manifest", () => {
|
||||||
|
const request = buildTuiReleaseRequest({
|
||||||
|
capabilityManifest,
|
||||||
|
packageManifest,
|
||||||
|
capabilityManifestPath: "eve-runtime-capability.json",
|
||||||
|
packageManifestPath: "package.json",
|
||||||
|
});
|
||||||
|
|
||||||
|
assert.equal(request.schema, "gamecult.eve.runtime_release_request.v1");
|
||||||
|
assert.equal(request.ownerRepo, "EveTui");
|
||||||
|
assert.equal(request.repository, "GameCult/EveTui");
|
||||||
|
assert.equal(request.packageName, "eve-tui");
|
||||||
|
assert.equal(request.version, "0.1.0");
|
||||||
|
assert.equal(request.packageRoot, ".");
|
||||||
|
assert.equal(request.versionSource, "package.json");
|
||||||
|
assert.equal(request.tagName, "evetui-v0.1.0");
|
||||||
|
assert.equal(request.artifactKind, "terminal-runtime");
|
||||||
|
assert.equal(request.artifactPath, "artifacts/evetui-release/0.1.0/eve-tui-0.1.0.tgz");
|
||||||
|
assert.equal(request.main, "src/eve-tui-shell.mjs");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("rejects package manifests that do not match the TUI release contract", () => {
|
||||||
|
const wrongPackage = { ...packageManifest, name: "eve-wrong" };
|
||||||
|
|
||||||
|
assert.throws(
|
||||||
|
() => buildTuiReleaseRequest({ capabilityManifest, packageManifest: wrongPackage }),
|
||||||
|
/package name mismatch/,
|
||||||
|
);
|
||||||
|
});
|
||||||
Reference in a new issue