@underpostnet/cyberia 3.3.0 → 3.3.73

package/src/client/components/core/Repository.js

@@ -0,0 +1,56 @@
+/**
+ * Repository identity on the client.
+ *
+ * The owner is resolved at build time by `src/server/storage/repository.js` and travels
+ * in `renderPayload.repository`. Composing every GitHub, Pages and Coveralls URL
+ * from it is what keeps a fork's links pointing at the fork instead of upstream.
+ *
+ * @module src/client/components/core/Repository.js
+ * @namespace PwaRepository
+ */
+
+/**
+ * Identity injected by the build.
+ * @returns {{owner: string, name: string, template: string, packageSuffix: string}}
+ * @memberof PwaRepository
+ */
+const repositoryIdentity = () => window.renderPayload.repository;
+
+/**
+ * Repository holding the prebuilt package and its published demo.
+ * @returns {string}
+ * @memberof PwaRepository
+ */
+const packageRepository = () => {
+  const { template, packageSuffix } = repositoryIdentity();
+  return `${template}${packageSuffix}`;
+};
+
+/**
+ * Composes a github.com URL under the resolved owner.
+ * @param {...string} segments - Path segments after the owner.
+ * @returns {string}
+ * @memberof PwaRepository
+ */
+const githubUrl = (...segments) =>
+  `https://github.com/${[repositoryIdentity().owner, ...segments].filter(Boolean).join('/')}/`;
+
+/**
+ * Composes a GitHub Pages URL under the resolved owner.
+ * @param {string} repository - Repository publishing the page.
+ * @returns {string}
+ * @memberof PwaRepository
+ */
+const githubPagesUrl = (repository) => `https://${repositoryIdentity().owner}.github.io/${repository}/`;
+
+/**
+ * Coveralls report for the engine repository this build came from.
+ * @returns {string}
+ * @memberof PwaRepository
+ */
+const coverallsUrl = () => {
+  const { owner, name } = repositoryIdentity();
+  return `https://coveralls.io/github/${owner}/${name}`;
+};
+
+export { coverallsUrl, githubPagesUrl, githubUrl, packageRepository, repositoryIdentity };

package/src/client/components/core/Translate.js

@@ -42,6 +42,13 @@ class Translate {
   static hasChangedListener(key) {
     return translateEvents.has(key);
   }
+  static text(keyLang, options = { disableTextFormat: false }) {
+    const translations = Translate.Data[keyLang];
+    if (!translations) return options.disableTextFormat ? keyLang : textFormatted(keyLang);
+    const lang = s('html')?.lang || 'en';
+    const value = translations[lang] ?? translations.en ?? keyLang;
+    return options.disableTextFormat ? value : textFormatted(value);
+  }
   static async emitChanged(detail) {
     await translateEvents.emit(TranslateEventType.changed, detail);
   }

package/src/client/components/core/{FullScreen.js → ViewModeController.js}

@@ -1,20 +1,20 @@
 /**
  * Utility module for fullscreen mode management with cross-browser and PWA compatibility.
  * Provides robust fullscreen detection, event handling, and UI synchronization.
- * @module src/client/components/core/FullScreen.js
- * @namespace FullScreenClient
+ * @module src/client/components/core/ViewModeController.js
+ * @namespace ViewModeControllerClient
  */
 import { Responsive } from './Responsive.js';
 import { ToggleSwitch } from './ToggleSwitch.js';
 import { Translate } from './Translate.js';
-import { checkFullScreen, fullScreenIn, fullScreenOut, s } from './VanillaJs.js';
+import { fullScreenIn, fullScreenOut, s } from './VanillaJs.js';
 /**
  * Manages fullscreen mode state, event handling, and UI synchronization.
  * Supports all major browsers and PWA/Nativefier environments with comprehensive
  * vendor-prefixed API detection.
- * @memberof FullScreenClient
+ * @memberof ViewModeControllerClient
  */
-class FullScreen {
+class ViewModeController {
   /**
    * Internal state flag tracking the intended fullscreen mode.
    * @type {boolean}
@@ -43,7 +43,7 @@ class FullScreen {
    * - Mozilla (Firefox)
    * - Microsoft (IE/Edge)
    * @private
-   * @memberof FullScreenClient.FullScreen
+   * @memberof ViewModeControllerClient.ViewModeController
    * @returns {boolean} True if currently in fullscreen mode, false otherwise.
    */
   static _isFullScreen() {
@@ -62,16 +62,16 @@ class FullScreen {
    * Prevents race conditions using the _syncInProgress flag.
    * Updates the toggle switch only if there's a mismatch between UI and actual state.
    * @private
-   * @memberof FullScreenClient.FullScreen
+   * @memberof ViewModeControllerClient.ViewModeController
    * @returns {void}
    */
   static _syncToggleState() {
-    if (FullScreen._syncInProgress) return;
-    FullScreen._syncInProgress = true;
-    const actualFullScreen = FullScreen._isFullScreen();
+    if (ViewModeController._syncInProgress) return;
+    ViewModeController._syncInProgress = true;
+    const actualFullScreen = ViewModeController._isFullScreen();
     // Only update if there's a mismatch
-    if (FullScreen._fullScreenSwitch !== actualFullScreen) {
-      FullScreen._fullScreenSwitch = actualFullScreen;
+    if (ViewModeController._fullScreenSwitch !== actualFullScreen) {
+      ViewModeController._fullScreenSwitch = actualFullScreen;
       // Update toggle switch UI if it exists
       const toggle = s('.fullscreen');
       if (toggle && ToggleSwitch.Tokens[`fullscreen`]) {
@@ -82,18 +82,18 @@ class FullScreen {
       }
     }
     setTimeout(() => {
-      FullScreen._syncInProgress = false;
+      ViewModeController._syncInProgress = false;
     }, 100);
   }
   /**
    * Event handler for fullscreen change events.
    * Triggers UI state synchronization when fullscreen mode changes.
    * @private
-   * @memberof FullScreenClient.FullScreen
+   * @memberof ViewModeControllerClient.ViewModeController
    * @returns {void}
    */
   static _handleFullScreenChange() {
-    FullScreen._syncToggleState();
+    ViewModeController._syncToggleState();
   }
   /**
    * Attaches all necessary event listeners for fullscreen mode detection.
@@ -103,20 +103,20 @@ class FullScreen {
    * - ESC key detection (fallback for manual fullscreen exit)
    * Only attaches listeners once to prevent duplicates.
    * @private
-   * @memberof FullScreenClient.FullScreen
+   * @memberof ViewModeControllerClient.ViewModeController
    * @returns {void}
    */
   static _addEventListeners() {
-    if (FullScreen._eventListenersAdded) return;
+    if (ViewModeController._eventListenersAdded) return;
     const events = ['fullscreenchange', 'webkitfullscreenchange', 'mozfullscreenchange', 'MSFullscreenChange'];
     events.forEach((eventName) => {
-      document.addEventListener(eventName, () => FullScreen._handleFullScreenChange(), false);
+      document.addEventListener(eventName, () => ViewModeController._handleFullScreenChange(), false);
     });
     // Additional check for PWA/Nativefier window resize events
     window.addEventListener(
       'resize',
       () => {
-        setTimeout(() => FullScreen._syncToggleState(), 150);
+        setTimeout(() => ViewModeController._syncToggleState(), 150);
       },
       false,
     );
@@ -125,77 +125,80 @@ class FullScreen {
       'keydown',
       (e) => {
         if (e.key === 'Escape' || e.keyCode === 27) {
-          setTimeout(() => FullScreen._syncToggleState(), 100);
+          setTimeout(() => ViewModeController._syncToggleState(), 100);
         }
       },
       false,
     );
-    FullScreen._eventListenersAdded = true;
+    ViewModeController._eventListenersAdded = true;
   }
   /**
    * Enters fullscreen mode if not already in fullscreen.
    * Updates internal state and triggers fullscreen API.
    * Verifies the state change after a delay to ensure synchronization.
    * @private
-   * @memberof FullScreenClient.FullScreen
+   * @memberof ViewModeControllerClient.ViewModeController
    * @returns {void}
    */
   static _enterFullScreen() {
-    if (FullScreen._isFullScreen()) return;
-    FullScreen._fullScreenSwitch = true;
+    if (ViewModeController._isFullScreen()) return;
+    ViewModeController._fullScreenSwitch = true;
     fullScreenIn();
     // Verify after attempt
-    setTimeout(() => FullScreen._syncToggleState(), 300);
+    setTimeout(() => ViewModeController._syncToggleState(), 300);
   }
   /**
    * Exits fullscreen mode if currently in fullscreen.
    * Updates internal state and triggers fullscreen exit API.
    * Verifies the state change after a delay to ensure synchronization.
    * @private
-   * @memberof FullScreenClient.FullScreen
+   * @memberof ViewModeControllerClient.ViewModeController
    * @returns {void}
    */
   static _exitFullScreen() {
-    if (!FullScreen._isFullScreen()) return;
-    FullScreen._fullScreenSwitch = false;
+    if (!ViewModeController._isFullScreen()) return;
+    ViewModeController._fullScreenSwitch = false;
     fullScreenOut();
     // Verify after attempt
-    setTimeout(() => FullScreen._syncToggleState(), 300);
+    setTimeout(() => ViewModeController._syncToggleState(), 300);
   }
   /**
    * Renders the fullscreen toggle setting UI component.
    * Initializes fullscreen state detection, sets up event listeners,
    * and creates a toggle switch for user interaction.
    * Integrates with the Responsive system for dynamic updates.
-   * @memberof FullScreenClient.FullScreen
+   * @memberof ViewModeControllerClient.ViewModeController
    * @returns {Promise<string>} A promise resolving to the HTML string for the fullscreen setting component.
    */
   static async RenderSetting() {
     // Initialize state from actual fullscreen status
-    FullScreen._fullScreenSwitch = FullScreen._isFullScreen();
+    ViewModeController._fullScreenSwitch = ViewModeController._isFullScreen();
     // Setup event listeners once
-    FullScreen._addEventListeners();
+    ViewModeController._addEventListeners();
     // Update responsive event
-    Responsive.onChanged(() => {
-      FullScreen._syncToggleState();
-    }, { key: 'full-screen-settings' });
+    Responsive.onChanged(
+      () => {
+        ViewModeController._syncToggleState();
+      },
+      { key: 'full-screen-settings' },
+    );
     return html`<div class="in section-mp">
       ${await ToggleSwitch.instance({
         wrapper: true,
         wrapperLabel: html`<i class="fa-solid fa-expand"></i> ${Translate.instance('fullscreen')}`,
         id: 'fullscreen',
         disabledOnClick: true,
-        checked: FullScreen._fullScreenSwitch,
+        checked: ViewModeController._fullScreenSwitch,
         on: {
           unchecked: () => {
-            FullScreen._exitFullScreen();
+            ViewModeController._exitFullScreen();
           },
           checked: () => {
-            FullScreen._enterFullScreen();
+            ViewModeController._enterFullScreen();
           },
         },
       })}
     </div>`;
   }
 }
-export { FullScreen };
+export { ViewModeController };

package/src/client/components/core/Wallet.js

@@ -1,5 +1,4 @@
 import { CryptoService } from '../../services/crypto/crypto.service.js';
-import { UserService } from '../../services/user/user.service.js';
 import { Auth } from './Auth.js';
 import { BtnIcon } from './BtnIcon.js';
 import { getId } from './CommonJs.js';
@@ -21,16 +20,6 @@ class Wallet {
           hash: 'SHA-256',
         };
         const format = 'jwk';
-        (async () => {
-          return;
-          const { data: payload } = await UserService.get({ id: 'public-key-sign-token' });
-          const signature = await window.crypto.subtle.sign(
-            algorithm,
-            keyPair.privateKey,
-            new TextEncoder().encode(payload),
-          );
-          const base64Signature = btoa(String.fromCharCode(...new Uint8Array(signature)));
-        })();
         const keyPair = await window.crypto.subtle.generateKey(algorithm, true, ['sign', 'verify']);
         const privateKey = await window.crypto.subtle.exportKey(format, keyPair.privateKey);
         const publicKey = await window.crypto.subtle.exportKey(format, keyPair.publicKey);

package/src/client/components/core/Worker.js

@@ -150,7 +150,13 @@ class PwaWorker {
     }
     const run = async () => {
       const registration = await this.getRegistration();
-      if (!registration) await this.register();
+      if (registration) {
+        try {
+          await registration.update();
+        } catch (error) {
+          logger.error('Error updating service worker:', error);
+        }
+      } else await this.register();
     };
     if (document.readyState === 'complete') run();
     else window.addEventListener('load', run, { once: true });

package/src/client/components/cryptokoyn/SettingsCryptokoyn.js

@@ -1,11 +1,11 @@
 import { Css } from '../core/Css.js';
-import { FullScreen } from '../core/FullScreen.js';
+import { ViewModeController } from '../core/ViewModeController.js';
 import { Translate } from '../core/Translate.js';
 import { Worker } from '../core/Worker.js';
 
 class SettingsCryptokoyn {
   static async instance() {
-    let render = await FullScreen.RenderSetting();
+    let render = await ViewModeController.RenderSetting();
     render += await Css.RenderSetting();
     render += await Translate.RenderSetting();
     render += await Worker.RenderSetting();

package/src/client/components/cyberia-portal/AppShellCyberiaPortal.js

@@ -3,6 +3,7 @@ import { BtnIcon } from '../core/BtnIcon.js';
 import { getId, newInstance, random } from '../core/CommonJs.js';
 import { Css, ThemeEvents, Themes, darkTheme } from '../core/Css.js';
 import { Docs } from '../core/Docs.js';
+import { githubUrl } from '../core/Repository.js';
 import { EventsUI } from '../core/EventsUI.js';
 import { LogIn } from '../core/LogIn.js';
 import { LogOut } from '../core/LogOut.js';
@@ -567,7 +568,7 @@ class AppShellCyberiaPortal {
               html`<img class="inl cyberia-menu-icon" src="${getProxyPath()}assets/ui-icons/arrow-right.png" />`,
             coverageUrl: () => `${getProxyPath()}docs/hardhat-coverage`,
             demoUrl: () => `https://client.cyberiaonline.com/`,
-            lastReleaseUrl: () => `https://github.com/underpostnet/engine-cyberia.git`,
+            lastReleaseUrl: () => githubUrl('engine-cyberia'),
           }),
         handleType: 'bar',
         observer: true,

package/src/client/components/cyberia-portal/SettingsCyberiaPortal.js

@@ -1,11 +1,11 @@
 import { Css } from '../core/Css.js';
-import { FullScreen } from '../core/FullScreen.js';
+import { ViewModeController } from '../core/ViewModeController.js';
 import { Translate } from '../core/Translate.js';
 import { Worker } from '../core/Worker.js';
 
 class SettingsCyberiaPortal {
   static async instance() {
-    let render = await FullScreen.RenderSetting();
+    let render = await ViewModeController.RenderSetting();
     render += await Css.RenderSetting();
     render += await Translate.RenderSetting();
     render += await Worker.RenderSetting();

package/src/client/components/default/AppShellDefault.js

@@ -239,7 +239,7 @@ class AppShellDefault {
           `,
         );
       } else {
-        const backgroundImage = `${getProxyPath()}assets/background/white0-min.jpg`;
+        const backgroundImage = `${getProxyPath()}assets/background/white.jpg`;
         htmls(
           `.style-ssr-background-image`,
           css`

package/src/client/components/default/SettingsDefault.js

@@ -1,11 +1,11 @@
 import { Css } from '../core/Css.js';
-import { FullScreen } from '../core/FullScreen.js';
+import { ViewModeController } from '../core/ViewModeController.js';
 import { Translate } from '../core/Translate.js';
 import { Worker } from '../core/Worker.js';
 
 class SettingsDefault {
   static async instance() {
-    let render = await FullScreen.RenderSetting();
+    let render = await ViewModeController.RenderSetting();
     render += await Css.RenderSetting();
     render += await Translate.RenderSetting();
     render += await Worker.RenderSetting();

package/src/client/components/itemledger/SettingsItemledger.js

@@ -1,11 +1,11 @@
 import { Css } from '../core/Css.js';
-import { FullScreen } from '../core/FullScreen.js';
+import { ViewModeController } from '../core/ViewModeController.js';
 import { Translate } from '../core/Translate.js';
 import { Worker } from '../core/Worker.js';
 
 class SettingsItemledger {
   static async instance() {
-    let render = await FullScreen.RenderSetting();
+    let render = await ViewModeController.RenderSetting();
     render += await Css.RenderSetting();
     render += await Translate.RenderSetting();
     render += await Worker.RenderSetting();

package/src/client/components/underpost/AppShellUnderpost.js

@@ -18,6 +18,7 @@ import { CyberpunkBloggerUnderpost } from './CyberpunkBloggerUnderpost.js';
 import { Badge } from '../core/Badge.js';
 import { SettingsUnderpost } from './SettingsUnderpost.js';
 import { Recover } from '../core/Recover.js';
+import { githubUrl, repositoryIdentity } from '../core/Repository.js';
 import { PanelForm } from '../core/PanelForm.js';
 import { SearchBox } from '../core/SearchBox.js';
 import { DocumentSearchProvider } from './DocumentSearchProvider.js';
@@ -214,7 +215,7 @@ class AppShellUnderpost {
               text: html`<span class="menu-label-text">${Translate.instance('github')}</span>`,
             }),
             attrs: `data-id="github"`,
-            tabHref: `https://github.com/underpostnet/`,
+            tabHref: githubUrl(),
             handleContainerClass: 'handle-btn-container',
             tooltipHtml: await Badge.instance(buildBadgeToolTipMenuOption('github')),
           })}
@@ -683,7 +684,7 @@ class AppShellUnderpost {
     });
 
     EventsUI.onClick(`.main-btn-github`, async () => {
-      location.href = `https://github.com/underpostnet/pwa-microservices-template/`;
+      location.href = githubUrl(repositoryIdentity().template);
     });
   }
 }

package/src/client/components/underpost/SettingsUnderpost.js

@@ -1,11 +1,11 @@
 import { Css } from '../core/Css.js';
-import { FullScreen } from '../core/FullScreen.js';
+import { ViewModeController } from '../core/ViewModeController.js';
 import { Translate } from '../core/Translate.js';
 import { Worker } from '../core/Worker.js';
 
 class SettingsUnderpost {
   static async instance() {
-    let render = await FullScreen.RenderSetting();
+    let render = await ViewModeController.RenderSetting();
     render += await Css.RenderSetting();
     render += await Translate.RenderSetting();
     render += await Worker.RenderSetting();

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.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.3.0 | **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.3.0 | **Status:** Draft | **Authors:** Underpost Engineering
+**Version:** 3.3.73 | **Status:** Draft | **Authors:** Underpost Engineering
 
 ---