build(level-18): ecosystem suite

ToolboxAid · ToolboxAid · commit ac8a0f042e29 · 2026-04-04T16:43:55.000-04:00
diff --git a/docs/dev/CODEX_COMMANDS.md b/docs/dev/CODEX_COMMANDS.md
@@ -1,21 +1 @@
-MODEL: GPT-5.4
-REASONING: high
-
-COMMAND:
-Execute this Level 17 expansion suite in order, treating each PLAN as the governing architecture contract for its corresponding BUILD/APPLY.
-
-Order:
-1. PLAN/BUILD/APPLY_PR_AI_AUTHORING_ASSISTANT
-2. PLAN/BUILD/APPLY_PR_GAMEPLAY_SYSTEM_LAYER
-3. PLAN/BUILD/APPLY_PR_COLLABORATION_SYSTEM
-4. PLAN/BUILD/APPLY_PR_PERFORMANCE_PROFILER
-
-Global requirements:
-- Preserve the accepted Level 16 platform baseline
-- Do not modify engine core APIs
-- Maintain deterministic, auditable, and readable reporting wherever applicable
-- Keep validation, packaging, runtime, and CI boundaries authoritative
-- Package each completed slice to the repo tmp directory using the established naming conventions
-
-Master package:
-HTML-JavaScript-Gaming/tmp/LEVEL_17_EXPANSION_SUITE_ATOMIC_PACKAGE_delta.zip
+Execute Level 18 suite
diff --git a/docs/dev/COMMIT_COMMENT.txt b/docs/dev/COMMIT_COMMENT.txt
@@ -1 +1 @@
-build(level-17): execute ai, gameplay, collaboration, and profiler expansion suite
+build(level-18): ecosystem suite
diff --git a/docs/dev/change_summary.txt b/docs/dev/change_summary.txt
@@ -1 +1 @@
-Combined Level 17 suite containing PLAN/BUILD/APPLY docs for AI authoring, gameplay, collaboration, and performance profiling.
+Level 18 ecosystem
diff --git a/docs/dev/file_tree.txt b/docs/dev/file_tree.txt
@@ -1,17 +1 @@
-docs/pr/PLAN_PR_AI_AUTHORING_ASSISTANT.md
-docs/pr/BUILD_PR_AI_AUTHORING_ASSISTANT.md
-docs/pr/APPLY_PR_AI_AUTHORING_ASSISTANT.md
-docs/pr/PLAN_PR_GAMEPLAY_SYSTEM_LAYER.md
-docs/pr/BUILD_PR_GAMEPLAY_SYSTEM_LAYER.md
-docs/pr/APPLY_PR_GAMEPLAY_SYSTEM_LAYER.md
-docs/pr/PLAN_PR_COLLABORATION_SYSTEM.md
-docs/pr/BUILD_PR_COLLABORATION_SYSTEM.md
-docs/pr/APPLY_PR_COLLABORATION_SYSTEM.md
-docs/pr/PLAN_PR_PERFORMANCE_PROFILER.md
-docs/pr/BUILD_PR_PERFORMANCE_PROFILER.md
-docs/pr/APPLY_PR_PERFORMANCE_PROFILER.md
-docs/dev/codex_commands.md
-docs/dev/commit_comment.txt
-docs/dev/change_summary.txt
-docs/dev/validation_checklist.txt
-docs/dev/file_tree.txt
+files
diff --git a/docs/dev/reports/asset_marketplace_validation.txt b/docs/dev/reports/asset_marketplace_validation.txt
@@ -0,0 +1,18 @@
+BUILD_PR_ASSET_MARKETPLACE validation
+
+Files:
+- tools/shared/assetMarketplace.js
+- tests/tools/AssetMarketplace.test.mjs
+- tests/run-tests.mjs
+
+Checks passed:
+- node --check tools/shared/assetMarketplace.js
+- node --check tests/tools/AssetMarketplace.test.mjs
+- node ./scripts/run-node-tests.mjs
+
+Behavior confirmed:
+- marketplace listings are normalized deterministically
+- version compatibility is incorporated into listing readiness
+- listing reports are auditable and readable
+- accepted platform boundaries remain authoritative
+- no engine core API changes
diff --git a/docs/dev/reports/cloud_runtime_validation.txt b/docs/dev/reports/cloud_runtime_validation.txt
@@ -0,0 +1,17 @@
+BUILD_PR_CLOUD_RUNTIME validation
+
+Files:
+- tools/shared/cloudRuntime.js
+- tests/tools/CloudRuntime.test.mjs
+- tests/run-tests.mjs
+
+Checks passed:
+- node --check tools/shared/cloudRuntime.js
+- node --check tests/tools/CloudRuntime.test.mjs
+- node ./scripts/run-node-tests.mjs
+
+Behavior confirmed:
+- cloud deployment targets are derived deterministically from packaged/export inputs
+- cloud runtime reports are readable and stable
+- accepted platform boundaries remain authoritative
+- no engine core API changes
diff --git a/docs/dev/reports/game_templates_validation.txt b/docs/dev/reports/game_templates_validation.txt
@@ -0,0 +1,17 @@
+BUILD_PR_GAME_TEMPLATES validation
+
+Files:
+- tools/shared/gameTemplates.js
+- tests/tools/GameTemplates.test.mjs
+- tests/run-tests.mjs
+
+Checks passed:
+- node --check tools/shared/gameTemplates.js
+- node --check tests/tools/GameTemplates.test.mjs
+- node ./scripts/run-node-tests.mjs
+
+Behavior confirmed:
+- template compatibility is evaluated deterministically from gameplay bindings
+- template reports are readable and stable
+- accepted platform boundaries remain authoritative
+- no engine core API changes
diff --git a/docs/dev/reports/publishing_pipeline_validation.txt b/docs/dev/reports/publishing_pipeline_validation.txt
@@ -0,0 +1,17 @@
+BUILD_PR_PUBLISHING_PIPELINE validation
+
+Files:
+- tools/shared/publishingPipeline.js
+- tests/tools/PublishingPipeline.test.mjs
+- tests/run-tests.mjs
+
+Checks passed:
+- node --check tools/shared/publishingPipeline.js
+- node --check tests/tools/PublishingPipeline.test.mjs
+- node ./scripts/run-node-tests.mjs
+
+Behavior confirmed:
+- publishing is blocked when upstream CI/export gates are not ready
+- release target planning is deterministic and readable
+- accepted platform boundaries remain authoritative
+- no engine core API changes
diff --git a/docs/dev/validation_checklist.txt b/docs/dev/validation_checklist.txt
@@ -1,5 +1 @@
-- All four Level 17 capability groups are present
-- Each capability has PLAN, BUILD, and APPLY docs
-- docs/dev contains codex_commands.md and commit_comment.txt
-- Level 16 platform remains the prerequisite authority
-- No engine core API changes are authorized
+all present
diff --git a/docs/pr/APPLY_PR_ASSET_MARKETPLACE.md b/docs/pr/APPLY_PR_ASSET_MARKETPLACE.md
@@ -0,0 +1,6 @@
+# APPLY_PR_ASSET_MARKETPLACE
+
+Docs-only acceptance boundary.
+
+Approved Commit Comment:
+build(marketplace): add asset marketplace ecosystem
diff --git a/docs/pr/APPLY_PR_CLOUD_RUNTIME.md b/docs/pr/APPLY_PR_CLOUD_RUNTIME.md
@@ -0,0 +1,6 @@
+# APPLY_PR_CLOUD_RUNTIME
+
+Docs-only acceptance boundary.
+
+Approved Commit Comment:
+build(cloud): add cloud runtime hosting architecture
diff --git a/docs/pr/APPLY_PR_GAME_TEMPLATES.md b/docs/pr/APPLY_PR_GAME_TEMPLATES.md
@@ -0,0 +1,6 @@
+# APPLY_PR_GAME_TEMPLATES
+
+Docs-only acceptance boundary.
+
+Approved Commit Comment:
+build(templates): add reusable game templates system
diff --git a/docs/pr/APPLY_PR_PUBLISHING_PIPELINE.md b/docs/pr/APPLY_PR_PUBLISHING_PIPELINE.md
@@ -0,0 +1,6 @@
+# APPLY_PR_PUBLISHING_PIPELINE
+
+Docs-only acceptance boundary.
+
+Approved Commit Comment:
+build(publishing): add publishing and release pipeline
diff --git a/docs/pr/BUILD_PR_ASSET_MARKETPLACE.md b/docs/pr/BUILD_PR_ASSET_MARKETPLACE.md
@@ -0,0 +1,30 @@
+# BUILD_PR_ASSET_MARKETPLACE
+
+## Goal
+Implement the asset marketplace layer over the accepted Level 17 platform baseline without changing engine core APIs.
+
+## Implemented Scope
+- Added shared marketplace planner in `tools/shared/assetMarketplace.js`
+  - normalizes marketplace listings deterministically
+  - evaluates listing compatibility through project versioning rules
+  - emits stable readable listing and review reports
+- Added automated coverage in `tests/tools/AssetMarketplace.test.mjs`
+
+## Validation Summary
+- Syntax checks passed:
+  - `node --check tools/shared/assetMarketplace.js`
+  - `node --check tests/tools/AssetMarketplace.test.mjs`
+- Full Node test suite passed:
+  - `node ./scripts/run-node-tests.mjs`
+
+## Scope Guard
+- Marketplace remains advisory and ecosystem-oriented.
+- Validation, packaging, runtime, and CI boundaries remain authoritative.
+- Listing reports remain deterministic, auditable, and readable.
+- No engine core API files were modified.
+
+## Approved Commit Comment
+build(marketplace): add asset marketplace ecosystem
+
+## Next Command
+APPLY_PR_ASSET_MARKETPLACE
diff --git a/docs/pr/BUILD_PR_CLOUD_RUNTIME.md b/docs/pr/BUILD_PR_CLOUD_RUNTIME.md
@@ -0,0 +1,29 @@
+# BUILD_PR_CLOUD_RUNTIME
+
+## Goal
+Implement the cloud runtime layer over the accepted Level 17 platform baseline without changing engine core APIs.
+
+## Implemented Scope
+- Added shared cloud runtime planner in `tools/shared/cloudRuntime.js`
+  - derives deterministic cloud deployment targets from strict packaged input
+  - composes with multi-target export planning
+  - emits stable readable deployment reports
+- Added automated coverage in `tests/tools/CloudRuntime.test.mjs`
+
+## Validation Summary
+- Syntax checks passed:
+  - `node --check tools/shared/cloudRuntime.js`
+  - `node --check tests/tools/CloudRuntime.test.mjs`
+- Full Node test suite passed:
+  - `node ./scripts/run-node-tests.mjs`
+
+## Scope Guard
+- Cloud runtime remains downstream of validation, packaging, runtime, and export planning.
+- Deployment targets remain deterministic and auditable.
+- No engine core API files were modified.
+
+## Approved Commit Comment
+build(cloud): add cloud runtime hosting architecture
+
+## Next Command
+APPLY_PR_CLOUD_RUNTIME
diff --git a/docs/pr/BUILD_PR_GAME_TEMPLATES.md b/docs/pr/BUILD_PR_GAME_TEMPLATES.md
@@ -0,0 +1,30 @@
+# BUILD_PR_GAME_TEMPLATES
+
+## Goal
+Implement the game templates layer over the accepted Level 17 platform baseline without changing engine core APIs.
+
+## Implemented Scope
+- Added shared game template evaluator in `tools/shared/gameTemplates.js`
+  - consumes gameplay system bindings
+  - evaluates deterministic template compatibility rules
+  - emits stable readable template reports
+- Added automated coverage in `tests/tools/GameTemplates.test.mjs`
+
+## Validation Summary
+- Syntax checks passed:
+  - `node --check tools/shared/gameTemplates.js`
+  - `node --check tests/tools/GameTemplates.test.mjs`
+- Full Node test suite passed:
+  - `node ./scripts/run-node-tests.mjs`
+
+## Scope Guard
+- Templates remain downstream of gameplay and packaged content bindings.
+- Validation, packaging, runtime, and CI boundaries remain authoritative.
+- Template reports remain deterministic and auditable.
+- No engine core API files were modified.
+
+## Approved Commit Comment
+build(templates): add reusable game templates system
+
+## Next Command
+APPLY_PR_GAME_TEMPLATES
diff --git a/docs/pr/BUILD_PR_PUBLISHING_PIPELINE.md b/docs/pr/BUILD_PR_PUBLISHING_PIPELINE.md
@@ -0,0 +1,29 @@
+# BUILD_PR_PUBLISHING_PIPELINE
+
+## Goal
+Implement the publishing pipeline layer over the accepted Level 17 platform baseline without changing engine core APIs.
+
+## Implemented Scope
+- Added shared publishing pipeline in `tools/shared/publishingPipeline.js`
+  - composes CI validation, multi-target export, and cloud runtime layers
+  - blocks publishing when CI or export readiness is not satisfied
+  - emits deterministic release target plans and readable publishing reports
+- Added automated coverage in `tests/tools/PublishingPipeline.test.mjs`
+
+## Validation Summary
+- Syntax checks passed:
+  - `node --check tools/shared/publishingPipeline.js`
+  - `node --check tests/tools/PublishingPipeline.test.mjs`
+- Full Node test suite passed:
+  - `node ./scripts/run-node-tests.mjs`
+
+## Scope Guard
+- Publishing remains downstream of validation, packaging, runtime, export, and CI gates.
+- Release plans remain deterministic and auditable.
+- No engine core API files were modified.
+
+## Approved Commit Comment
+build(publishing): add publishing and release pipeline
+
+## Next Command
+APPLY_PR_PUBLISHING_PIPELINE
diff --git a/docs/pr/PLAN_PR_ASSET_MARKETPLACE.md b/docs/pr/PLAN_PR_ASSET_MARKETPLACE.md
@@ -0,0 +1,5 @@
+# PLAN_PR_ASSET_MARKETPLACE
+
+Goal: Define asset_marketplace layer over Level 17 platform.
+
+Next Command: BUILD_PR_ASSET_MARKETPLACE
diff --git a/docs/pr/PLAN_PR_CLOUD_RUNTIME.md b/docs/pr/PLAN_PR_CLOUD_RUNTIME.md
@@ -0,0 +1,5 @@
+# PLAN_PR_CLOUD_RUNTIME
+
+Goal: Define cloud_runtime layer over Level 17 platform.
+
+Next Command: BUILD_PR_CLOUD_RUNTIME
diff --git a/docs/pr/PLAN_PR_GAME_TEMPLATES.md b/docs/pr/PLAN_PR_GAME_TEMPLATES.md
@@ -0,0 +1,5 @@
+# PLAN_PR_GAME_TEMPLATES
+
+Goal: Define game_templates layer over Level 17 platform.
+
+Next Command: BUILD_PR_GAME_TEMPLATES
diff --git a/docs/pr/PLAN_PR_PUBLISHING_PIPELINE.md b/docs/pr/PLAN_PR_PUBLISHING_PIPELINE.md
@@ -0,0 +1,5 @@
+# PLAN_PR_PUBLISHING_PIPELINE
+
+Goal: Define publishing_pipeline layer over Level 17 platform.
+
+Next Command: BUILD_PR_PUBLISHING_PIPELINE
diff --git a/tests/run-tests.mjs b/tests/run-tests.mjs
@@ -101,6 +101,10 @@ import { run as runAiAuthoringAssistant } from './tools/AiAuthoringAssistant.tes
 import { run as runGameplaySystemLayer } from './tools/GameplaySystemLayer.test.mjs';
 import { run as runCollaborationSystem } from './tools/CollaborationSystem.test.mjs';
 import { run as runPerformanceProfiler } from './tools/PerformanceProfiler.test.mjs';
+import { run as runAssetMarketplace } from './tools/AssetMarketplace.test.mjs';
+import { run as runCloudRuntime } from './tools/CloudRuntime.test.mjs';
+import { run as runGameTemplates } from './tools/GameTemplates.test.mjs';
+import { run as runPublishingPipeline } from './tools/PublishingPipeline.test.mjs';
 import './render/Renderer.test.mjs';
 import { run as runReplaySystem } from './replay/ReplaySystem.test.mjs';
 import { run as runOrbitLabModel } from './samples/OrbitLabModel.test.mjs';
@@ -196,6 +200,10 @@ const tests = [
     ['GameplaySystemLayer', runGameplaySystemLayer],
     ['CollaborationSystem', runCollaborationSystem],
     ['PerformanceProfiler', runPerformanceProfiler],
+    ['AssetMarketplace', runAssetMarketplace],
+    ['CloudRuntime', runCloudRuntime],
+    ['GameTemplates', runGameTemplates],
+    ['PublishingPipeline', runPublishingPipeline],
     ['ReplaySystem', runReplaySystem],
     ['OrbitLabModel', runOrbitLabModel],
     ['OrbitLabScene', runOrbitLabScene],
diff --git a/tests/tools/AssetMarketplace.test.mjs b/tests/tools/AssetMarketplace.test.mjs
@@ -0,0 +1,20 @@
+import assert from "node:assert/strict";
+import { buildAssetMarketplace, summarizeAssetMarketplace } from "../../tools/shared/assetMarketplace.js";
+
+export async function run() {
+  const result = buildAssetMarketplace({
+    currentSchemaVersion: 1,
+    listings: [
+      {
+        listingId: "market.sprite.hero",
+        assetId: "sprite.hero",
+        assetType: "sprite",
+        version: 1,
+        author: "toolbox"
+      }
+    ]
+  });
+  assert.equal(result.marketplace.status, "ready");
+  assert.equal(result.marketplace.listings.length, 1);
+  assert.equal(summarizeAssetMarketplace(result), "Asset marketplace ready with 1 listings.");
+}
diff --git a/tests/tools/CloudRuntime.test.mjs b/tests/tools/CloudRuntime.test.mjs
@@ -0,0 +1,21 @@
+import assert from "node:assert/strict";
+import { buildCloudRuntime, summarizeCloudRuntime } from "../../tools/shared/cloudRuntime.js";
+
+export async function run() {
+  const result = buildCloudRuntime({
+    packageManifest: {
+      package: {
+        projectId: "cloud-demo",
+        assets: [{ id: "sprite.hero", type: "sprite" }]
+      }
+    },
+    multiTargetExportResult: {
+      multiTargetExport: {
+        targets: [{ targetId: "web", outputPath: "dist/web" }]
+      }
+    }
+  });
+  assert.equal(result.cloudRuntime.status, "ready");
+  assert.equal(result.cloudRuntime.deployments.length, 2);
+  assert.equal(summarizeCloudRuntime(result), "Cloud runtime ready with 2 deployment targets.");
+}
diff --git a/tests/tools/GameTemplates.test.mjs b/tests/tools/GameTemplates.test.mjs
@@ -0,0 +1,20 @@
+import assert from "node:assert/strict";
+import { buildGameTemplates, summarizeGameTemplates } from "../../tools/shared/gameTemplates.js";
+
+export async function run() {
+  const result = buildGameTemplates({
+    gameplayResult: {
+      gameplay: {
+        status: "ready",
+        bindings: [
+          { role: "entity-visual" },
+          { role: "world-layout" },
+          { role: "supporting-content" }
+        ]
+      }
+    }
+  });
+  assert.equal(result.templates.status, "ready");
+  assert.equal(result.templates.templates.length, 3);
+  assert.equal(summarizeGameTemplates(result), "Game templates ready with 3 templates.");
+}
diff --git a/tests/tools/PublishingPipeline.test.mjs b/tests/tools/PublishingPipeline.test.mjs
diff --git a/tools/shared/assetMarketplace.js b/tools/shared/assetMarketplace.js
diff --git a/tools/shared/cloudRuntime.js b/tools/shared/cloudRuntime.js
diff --git a/tools/shared/gameTemplates.js b/tools/shared/gameTemplates.js
diff --git a/tools/shared/publishingPipeline.js b/tools/shared/publishingPipeline.js

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-build(level-17): execute ai, gameplay, collaboration, and profiler expansion suite`
	`1`	`+build(level-18): ecosystem suite`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-Combined Level 17 suite containing PLAN/BUILD/APPLY docs for AI authoring, gameplay, collaboration, and performance profiling.`
	`1`	`+Level 18 ecosystem`