@underpostnet/cyberia 3.2.90 → 3.3.73

package/src/client/public/cyberia-docs/CYBERIA-CLI.md

@@ -87,6 +87,9 @@ cyberia instance [instance-code] [options]
 | `--import [path]`                                     | Import from a backup directory (upsert, preserves UUIDs)                |
 | `--conf`                                              | With `--export`/`--import`: only `cyberia-instance.json` + `-conf.json` |
 | `--drop`                                              | Drop all documents associated with the instance code                    |
+| `--export-current-fallbackworld`                      | Capture the in-memory procedural fallback world, then export it         |
+| `--keep-fallback-codes`                               | Capture using the raw `fallback-map-*` / canonical action-quest codes   |
+| `--fallback-url <url>`                                | Capture the world a running engine serves instead of regenerating it    |
 | `--env-path <path>` · `--mongo-host <host>` · `--dev` | env / DB / dev overrides                                                |
 
 ```bash
@@ -95,6 +98,30 @@ cyberia instance FOREST --import ./backups/FOREST
 cyberia instance FOREST --drop
 ```
 
+### Capturing the procedural fallback world
+
+The fallback world is never persisted: every engine process rebuilds it from the code defaults at
+boot and serves it whenever a requested instance is absent. `--export-current-fallbackworld` freezes
+that in-memory world into MongoDB under a real instance code — maps and portal topology, the
+instance conf, and the content collections the fallback path serves from code rather than the DB
+(skills, entity-type defaults, dialogues, actions, quests) — and then exports it like any other
+instance.
+
+```bash
+# Freeze the current fallback world as PROC-1 and back it up
+cyberia instance PROC-1 --export-current-fallbackworld --dev
+
+# Restore it later as an ordinary persisted instance
+cyberia instance PROC-1 --import --dev
+```
+
+Map, action and quest codes are namespaced under the instance code (`fallback-map-0` →
+`PROC-1-map-0`) so successive captures never overwrite each other; `--keep-fallback-codes` writes
+the canonical codes verbatim instead. Sprites are the one thing a capture cannot synthesise: when a
+referenced item id has no `ObjectLayer` document the command aborts and names the ids to import with
+`cyberia ol <ids> --import`. Staged fallback default items live only in the serving engine process,
+so pass `--fallback-url http://localhost:4001` to capture a live world rather than regenerating it.
+
 ---
 
 ## `cyberia client-hints` — presentation hints
@@ -198,7 +225,7 @@ cyberia run-workflow build-server-dashboard
 ## Bringing up the full stack locally
 
 ```bash
-node bin run cluster 'express,dd-cyberia' --dev
+node bin run cluster --deploy-id dd-cyberia --dev
 ```
 
 One command, no extra flags. It resets and rebuilds the node, deploys MongoDB / IPFS / Valkey, imports each database from its git backup, installs the Gateway API control plane, and deploys `dd-cyberia` behind it.
@@ -213,16 +240,16 @@ The run ends with a gateway status report: listener and route conditions, the wo
 
 ### With the MMO services
 
-The optional third path segment brings up custom instances from `engine-private/conf/dd-cyberia/conf.instances.json` in the same run:
+`--instance-id` brings up custom instances from `engine-private/conf/dd-cyberia/conf.instances.json` in the same run:
 
 ```bash
-node bin run cluster 'express,dd-cyberia,mmo-server' --dev
-node bin run cluster 'express,dd-cyberia,mmo-server+mmo-client' --dev
+node bin run cluster --deploy-id dd-cyberia --instance-id mmo-server --dev
+node bin run cluster --deploy-id dd-cyberia --instance-id mmo-server,mmo-client --dev
 ```
 
 Each id runs only where `dd-cyberia` declares it, and only once the portal workload has rolled out — `cyberia-server` dials the engine's gRPC ClusterIP for its world configuration at boot, so the content authority has to be serving first. `mmo-server` names the whole variant family (`amethyst-strata-expansion`, `FOREST`, `TEST`); `mmo-server-forest` names one variant.
 
-`server.cyberiaonline.com` and `client.cyberiaonline.com` are issued the same self-signed certificates as the portal hosts and written into the same `/etc/hosts` pass, so the three services are reachable over TLS from a local browser without further setup. In production the same segment issues cert-manager certificates instead.
+`server.cyberiaonline.com` and `client.cyberiaonline.com` are issued the same self-signed certificates as the portal hosts and written into the same `/etc/hosts` pass, so the three services are reachable over TLS from a local browser without further setup. In production the same flag issues cert-manager certificates instead.
 
 To place the static documents again without redeploying — after rebuilding the portal client, for instance:
 

package/src/client/public/cyberia-docs/CYBERIA-SERVER.md

@@ -157,7 +157,7 @@ Per player:
 [9..10]  u16  entityCount entity blocks that follow
 ```
 
-The `tick` and `lastAcked` fields are how the client reconciles its predicted self with authoritative state. The client drops input commands with `sequence ≤ lastAcked` from its replay buffer, then rewinds and replays the rest.
+The `tick` and `lastAcked` fields are how the client reconciles its predicted self with authoritative state. `lastAcked` proves arrival, not acceptance: movement re-plans once per player per tick from the newest tap of that tick, so a tap superseded within its own tick is acknowledged and never planned. The snapshot therefore carries a second acknowledgement, `moveAck` — the highest `PlayerAction` sequence that actually re-planned movement — and the client adopts the authoritative `targetPos` / `path` only once `moveAck` covers its newest command. See ARCHITECTURE.md § Input replication.
 
 Other message types (init data, FCT) carry their own headers and are not part of the per-tick replication stream.
 

package/src/client/public/cyberia-docs/CYBERIA.md

@@ -8,9 +8,29 @@
 
 _Stackable Rendering Layers as a Unified Tokenized Reality_
 
-[![Version](https://img.shields.io/npm/v/cyberia.svg)](https://www.npmjs.org/package/cyberia)
+</div>
+
+<!-- Tech stack -->
+<div align="center">
+
+<a target="_top" href='https://download.rockylinux.org/pub/rocky/9/'><img alt='rockylinux' src='https://img.shields.io/badge/Rocky Linux v9.8-100000?style=flat&logo=rockylinux&logoColor=white&labelColor=10b981&color=727273'/></a> <a target="_top" href='https://www.npmjs.com/package/npm?activeTab=versions'><img alt='npm' src='https://img.shields.io/badge/npm v11.6.2-100000?style=flat&logo=npm&logoColor=white&labelColor=CB3837&color=727273'/></a> <a target="_top" href='https://nodejs.org/download/release'><img alt='nodedotjs' src='https://img.shields.io/badge/node v24.15.0-100000?style=flat&logo=nodedotjs&logoColor=white&labelColor=5FA04E&color=727273'/></a> <a target="_top" href='https://pgp.mongodb.com/'><img alt='mongodb' src='https://img.shields.io/badge/mongodb_server v7.0-100000?style=flat&logo=mongodb&logoColor=white&labelColor=47A248&color=727273'/></a>
 
 </div>
+
+<!-- CI/CD and health -->
+<div align="center">
+
+[![Node.js CI](https://img.shields.io/github/actions/workflow/status/underpostnet/engine-cyberia/docker-image.engine-cyberia.ci.yml?branch=main&label=Node.js%20CI)](https://github.com/underpostnet/engine-cyberia/actions/workflows/docker-image.engine-cyberia.ci.yml) [![Test](https://img.shields.io/github/actions/workflow/status/underpostnet/engine-cyberia/coverall.cyberia.ci.yml?branch=main&label=Test)](https://github.com/underpostnet/engine-cyberia/actions/workflows/coverall.cyberia.ci.yml) [![Coverage Status](https://coveralls.io/repos/github/underpostnet/engine-cyberia/badge.svg?branch=main)](https://coveralls.io/github/underpostnet/engine-cyberia?branch=main) [![Socket Badge](https://socket.dev/api/badge/npm/package/cyberia/3.3.73)](https://socket.dev/npm/package/cyberia/overview/3.3.73)
+
+</div>
+
+<!-- Distribution and package -->
+<div align="center">
+
+[![Version](https://img.shields.io/npm/v/cyberia.svg)](https://www.npmjs.com/package/cyberia) [![Downloads](https://img.shields.io/npm/dm/cyberia.svg)](https://www.npmjs.com/package/cyberia) [![jsDelivr](https://data.jsdelivr.com/v1/package/npm/cyberia/badge)](https://www.jsdelivr.com/package/npm/cyberia) [![License](https://img.shields.io/npm/l/cyberia.svg)](https://www.npmjs.com/package/cyberia)
+
+</div>
+
 Cyberia is an MMORPG extension built on the Underpost Platform. The platform owns the
 toolchain, deployment surface, PWA delivery, and base infrastructure. Cyberia adds a three-service MMO
 runtime: `engine-cyberia`, `cyberia-server`, and `cyberia-client`.

package/src/client/public/cyberia-docs/HARDHAT-MODULE.md

@@ -20,7 +20,7 @@ hardhat/
     ObjectLayerToken.sol  ERC-1155 multi-token contract
   scripts/
     deployObjectLayerToken.js  Deployment script
-  test/                   Contract tests (Mocha + ethers v6)
+  test/                   Contract tests (node:test + viem)
   deployments/            Deployment artifacts (auto-generated)
   ignition/               Hardhat Ignition modules (optional)
   networks/               Network-specific genesis configs
@@ -199,15 +199,32 @@ The artifact is consumed by:
 
 ## Running Tests
 
+Contract tests are the `contracts` tier of the platform runner, so they run
+alongside every other suite and report to the same dashboard:
+
 ```bash
-cd hardhat
-npx hardhat test
+underpost test contracts             # this tier only
+underpost test contracts --allure    # also write results for the dashboard
+underpost test contracts --grep Burning
+underpost test                       # every tier, contracts last
+```
+
+Hardhat's own tasks stay available for contract-only work:
 
-# With gas report
-REPORT_GAS=true npx hardhat test
+```bash
+cd hardhat
+npm test                             # hardhat test
+npm run coverage                     # Solidity line/statement coverage
+REPORT_GAS=true npm test
 ```
 
-Tests use **Mocha + ethers v6** via `@nomicfoundation/hardhat-toolbox-mocha-ethers`. The `hardhat` in-process network simulates Besu behavior.
+Tests use **node:test + viem** via `@nomicfoundation/hardhat-toolbox-viem`. The
+`hardhat` in-process network simulates Besu behavior.
+
+The tier runs the suites on Node's test runner rather than through `hardhat
+test`: Hardhat pins its own reporter, and Node's can emit the JUnit results the
+Allure dashboard ingests while still printing a readable run. Compilation still
+goes through `hardhat build` first, so artifacts and the EVM are identical.
 
 ---
 

package/src/client/public/cyberia-docs/ROADMAP.md

@@ -1,6 +1,6 @@
 # Cyberia Online — Development Roadmap
 
-**Current version:** 3.2.90 | **Target milestone:** Open Alpha
+**Current version:** 3.3.73 | **Target milestone:** Open Alpha
 
 ---
 

package/src/client/public/cyberia-docs/WHITE-PAPER.md

@@ -18,7 +18,7 @@ _Stackable Rendering Layers as a Unified Tokenized Reality_
 
 ---
 
-**Version:** 3.2.90 | **Status:** Draft | **Authors:** Underpost Engineering
+**Version:** 3.3.73 | **Status:** Draft | **Authors:** Underpost Engineering
 
 ---
 

package/src/client/public/default/browserconfig.xml

@@ -6,7 +6,7 @@
       <square150x150logo src="/mstile-150x150.png"/>
       <wide310x150logo src="/mstile-310x150.png"/>
       <square310x310logo src="/mstile-310x310.png"/>
-      <TileColor>#fff</TileColor>
+      <TileColor>#ececec</TileColor>
     </tile>
   </msapplication>
 </browserconfig>

package/src/client/public/default/manifest.webmanifest

@@ -1,15 +1,15 @@
 {
-  "name": "Default",
-  "short_name": "Default",
-  "description": null,
+  "name": "PWA Demo App",
+  "short_name": "PWA Demo App",
+  "description": "Web application",
   "dir": "auto",
   "lang": "en-US",
   "display": "standalone",
   "orientation": "any",
   "scope": "/",
   "start_url": "/?homescreen=1",
-  "background_color": "#fff",
-  "theme_color": "#fff",
+  "background_color": "#ececec",
+  "theme_color": "#ececec",
   "icons": [
     {
       "src": "/android-chrome-36x36.png",

package/src/client/public/default/yandex-browser-manifest.json

@@ -3,7 +3,7 @@
   "api_version": 1,
   "layout": {
     "logo": "/yandex-browser-50x50.png",
-    "color": "#fff",
+    "color": "#ececec",
     "show_title": true
   }
 }

package/src/client/services/cyberia-instance/cyberia-instance.service.js

@@ -96,6 +96,46 @@ class CyberiaInstanceService {
           return reject(error);
         }),
     );
+  /** Fallback-world default items currently staged on the engine process. */
+  static getFallbackDefaultItems = () =>
+    new Promise((resolve, reject) =>
+      fetch(getApiBaseUrl({ id: 'fallback-world/default-items', endpoint }), {
+        method: 'GET',
+        headers: headersFactory(),
+        credentials: 'include',
+      })
+        .then(async (res) => res.json())
+        .then((res) => {
+          logger.info(res);
+          return resolve(res);
+        })
+        .catch((error) => {
+          logger.error(error);
+          return reject(error);
+        }),
+    );
+  /**
+   * Stage the fallback world's default items and reload a running cyberia-server
+   * (moderator/admin). The items ride along with the trigger — nothing is persisted.
+   */
+  static fallbackHotReload = (options = { body: {} }) =>
+    new Promise((resolve, reject) =>
+      fetch(getApiBaseUrl({ id: 'fallback-world/hot-reload', endpoint }), {
+        method: 'POST',
+        headers: headersFactory(),
+        credentials: 'include',
+        body: JSON.stringify(options.body ?? {}),
+      })
+        .then(async (res) => res.json())
+        .then((res) => {
+          logger.info(res);
+          return resolve(res);
+        })
+        .catch((error) => {
+          logger.error(error);
+          return reject(error);
+        }),
+    );
   static portalConnect = (options = { id: '' }) =>
     new Promise((resolve, reject) =>
       fetch(getApiBaseUrl({ id: `${options.id}/portal-connect`, endpoint }), {

package/src/client/services/object-layer/object-layer.management.js

@@ -293,7 +293,7 @@ class ObjectLayerManagement {
         width: 160,
         editable: false,
         sortable: false,
-        filter: false,
+        filter: 'agTextColumnFilter',
       },
       {
         field: 'cid',
@@ -302,7 +302,7 @@ class ObjectLayerManagement {
         cellRenderer: CidRenderer,
         editable: false,
         sortable: false,
-        filter: false,
+        filter: 'agTextColumnFilter',
       },
       {
         field: 'data.render.cid',
@@ -311,7 +311,7 @@ class ObjectLayerManagement {
         cellRenderer: AtlasCidRenderer,
         editable: false,
         sortable: false,
-        filter: false,
+        filter: 'agTextColumnFilter',
       },
       {
         field: 'data.render.metadataCid',
@@ -320,7 +320,7 @@ class ObjectLayerManagement {
         cellRenderer: MetadataCidRenderer,
         editable: false,
         sortable: false,
-        filter: false,
+        filter: 'agTextColumnFilter',
       },
       {
         field: 'frame08',

package/src/client/ssr/RootDocument.js

@@ -1,4 +1,4 @@
-SrrComponent = ({ title, ssrPath, buildId, ssrHeadComponents, ssrBodyComponents, renderPayload, renderApi }) => html`
+SSRComponent = ({ title, ssrPath, buildId, ssrHeadComponents, ssrBodyComponents, renderPayload, renderApi }) => html`
   <!DOCTYPE html>
   <html dir="ltr" lang="en">
     <head>

package/src/client/ssr/body/404.js

@@ -65,7 +65,7 @@ const main = () => {
   );
 };
 
-SrrComponent = () =>
+SSRComponent = () =>
   html`<script>
     {
       const s = ${s};

package/src/client/ssr/body/500.js

@@ -64,7 +64,7 @@ const main = () => {
   );
 };
 
-SrrComponent = () =>
+SSRComponent = () =>
   html`<script>
     {
       const s = ${s};

package/src/client/ssr/body/CacheControl.js

@@ -70,7 +70,7 @@ const CacheControl = function ({ ttiLoadTimeLimit }) {
   setTimeout(window.cacheControlCallBack, ttiLoadTimeLimit); // 70s limit);
 };
 
-SrrComponent = ({ ttiLoadTimeLimit, version }) => {
+SSRComponent = ({ ttiLoadTimeLimit, version }) => {
   const borderChar = (px, color, selectors) => {
     if (selectors) {
       return selectors

package/src/client/ssr/body/CyberiaDefaultSplashScreen.js

@@ -1,4 +1,4 @@
-SrrComponent = ({ backgroundImage, metadata }) => html`
+SSRComponent = ({ backgroundImage, metadata }) => html`
   ${backgroundImage
     ? html`<style class="style-ssr-background-image">
         .ssr-background-image {

package/src/client/ssr/body/DefaultSplashScreen.js

@@ -1,4 +1,4 @@
-SrrComponent = ({ backgroundImage, metadata }) => html`
+SSRComponent = ({ backgroundImage, metadata }) => html`
   ${backgroundImage
     ? html`<style class="style-ssr-background-image">
         .ssr-background-image {

package/src/client/ssr/body/SwaggerDarkMode.js

@@ -282,4 +282,4 @@ const swaggerDarkJs = `(function () {
   }, 100);
 })();`;
 
-SrrComponent = () => ({ css: swaggerDarkCss, js: swaggerDarkJs });
+SSRComponent = () => ({ css: swaggerDarkCss, js: swaggerDarkJs });

package/src/client/ssr/body/UnderpostDefaultSplashScreen.js

@@ -1,4 +1,4 @@
-SrrComponent = ({ backgroundImage }) => html`
+SSRComponent = ({ backgroundImage }) => html`
   ${backgroundImage
     ? html`<style>
         .ssr-background-image {

package/src/client/ssr/head/CryptokoynScripts.js

@@ -1,4 +1,4 @@
-SrrComponent = ({ ssrPath }) => html`
+SSRComponent = ({ ssrPath }) => html`
   <script type="text/javascript" src="${ssrPath}dist/validator/validator.min.js"></script>
   <script type="text/javascript" src="${ssrPath}dist/ag-grid-community/ag-grid-community.min.js"></script>
 `;

package/src/client/ssr/head/Css.js

@@ -1,6 +1,6 @@
 // https://css-loaders.com/pulsing/
 
-SrrComponent = () => html`
+SSRComponent = () => html`
   <style>
     body {
       margin: 0;

package/src/client/ssr/head/CyberiaPortalScripts.js

@@ -1,4 +1,4 @@
-SrrComponent = ({ ssrPath }) => html`
+SSRComponent = ({ ssrPath }) => html`
   <script type="text/javascript" src="${ssrPath}dist/validator/validator.min.js"></script>
   <script type="text/javascript" src="${ssrPath}dist/ag-grid-community/ag-grid-community.min.js"></script>
   <script type="text/javascript" src="${ssrPath}dist/easymde/easymde.min.js"></script>

package/src/client/ssr/head/DefaultScripts.js

@@ -1,4 +1,4 @@
-SrrComponent = ({ ssrPath }) => html`
+SSRComponent = ({ ssrPath }) => html`
   <script type="text/javascript" src="${ssrPath}dist/validator/validator.min.js"></script>
   <script type="text/javascript" src="${ssrPath}dist/ag-grid-community/ag-grid-community.min.js"></script>
   <script type="text/javascript" src="${ssrPath}dist/easymde/easymde.min.js"></script>

package/src/client/ssr/head/ItemledgerScripts.js

@@ -1,4 +1,4 @@
-SrrComponent = ({ ssrPath }) => html`
+SSRComponent = ({ ssrPath }) => html`
   <script type="text/javascript" src="${ssrPath}dist/validator/validator.min.js"></script>
   <script type="text/javascript" src="${ssrPath}dist/ag-grid-community/ag-grid-community.min.js"></script>
 `;

package/src/client/ssr/head/Microdata.js

@@ -1,4 +1,4 @@
-SrrComponent = ({ microdata }) => html`
+SSRComponent = ({ microdata }) => html`
   ${microdata
     .map(
       (jsonld) => html`

package/src/client/ssr/head/Production.js

@@ -1 +1 @@
-SrrComponent = () => html``;
+SSRComponent = () => html``;

package/src/client/ssr/head/Pwa.js

@@ -1,4 +1,4 @@
-SrrComponent = ({
+SSRComponent = ({
   title,
   author,
   keywords,

package/src/client/ssr/head/PwaItemledger.js

@@ -1,4 +1,4 @@
-SrrComponent = () =>
+SSRComponent = () =>
   html`<link rel="icon" type="image/x-icon" href="/favicon.ico" />
     <link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png" />
     <link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png" />