underpost 3.2.9 → 3.2.10

package/.github/workflows/npmpkg.ci.yml

@@ -81,6 +81,7 @@ jobs:
       - name: Clone github package repository
         env:
           GITHUB_TOKEN: ${{ secrets.GIT_AUTH_TOKEN }}
+          GITHUB_USERNAME: ${{ github.repository_owner }}
         run: |
           cd .. && node engine/bin clone underpostnet/pwa-microservices-template
           cd engine

package/.github/workflows/pwa-microservices-template-test.ci.yml

@@ -30,4 +30,4 @@ jobs:
         run: npm install
 
       - name: Run test
-        run: node bin test
+        run: npm test

package/.github/workflows/release.cd.yml

@@ -34,6 +34,7 @@ jobs:
           # Commands to run on the remote VM
           script: |
             set -e
+            set -o pipefail
             echo "Starting remote release deploy"
             cd /home/dd/engine
             sudo -n -- /bin/bash -lc "node bin run pull"

package/.vscode/settings.json

@@ -1,10 +1,15 @@
 {
-  "editor.defaultFormatter": "esbenp.prettier-vscode",
   "editor.formatOnSave": true,
-  "explorer.compactFolders": false,
-  "js/ts.preferences.importModuleSpecifierEnding": "js",
   "[javascript]": {
     "editor.defaultFormatter": "esbenp.prettier-vscode"
   },
-  "editor.inlineSuggest.enabled": true
-}
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  }
+}

package/CHANGELOG.md

@@ -1,6 +1,127 @@
 # Changelog
 
-## 2026-05-14
+## 2026-05-26
+
+### cli-run
+
+- Add group property and shared directory setup methods to UnderpostRun ([6cc121c4a](https://github.com/underpostnet/engine/commit/6cc121c4abe8a5fe07582a99a251ef8e1133ce00))
+
+### cli-release
+
+- Add bumpp configuration and integrate version bumping into release process ([e5eb50d70](https://github.com/underpostnet/engine/commit/e5eb50d70980fe625e4246b5807b2a3984f09e72))
+
+### engine-cyberia
+
+- Refactor CI workflows for cyberia-client and cyberia-server, removing outdated comments and improving clarity. Update Dockerfile to ensure clean builds by adding a clean step before compilation. ([e74918e81](https://github.com/underpostnet/engine/commit/e74918e8102a2c7361ff8abd89aa019aee6ef642))
+- Refactor CI workflows and Dockerfiles for cyberia-client and cyberia-server ([0dfda92fd](https://github.com/underpostnet/engine/commit/0dfda92fd0c01de7af755a2935fd68199d94d61f))
+- Refactor package.json metadata for Cyberia CLI and Underpost Platform, updating descriptions and keywords for improved clarity and relevance. ([893a371ac](https://github.com/underpostnet/engine/commit/893a371acef87351841d4ff703f35421e05725e4))
+- Enhance Dockerfiles and CLI: align underpost versioning, add dev configurations, and improve manifest build options ([4f9c96df6](https://github.com/underpostnet/engine/commit/4f9c96df6b672c25ef8d34d0ad440f66061f7789))
+- Refactor presentation handling: remove legacy fields, update documentation, and streamline client hints integration ([e79315e6e](https://github.com/underpostnet/engine/commit/e79315e6e3064140d6b2e634f31b153008a15db0))
+- Refactor Cyberia defaults management ([2454ad54c](https://github.com/underpostnet/engine/commit/2454ad54c9f9d3e9b2aa43a831184f6e87b4772f))
+- Add cyberia hints model and refactor docs ([14fc8a633](https://github.com/underpostnet/engine/commit/14fc8a633843a52f705594eba3927a8a7b1dc685))
+- Update build process to include README.md and update white paper version ([77099e88f](https://github.com/underpostnet/engine/commit/77099e88f50516a0e6e626f74059814585ca18d6))
+
+### client
+
+- Chore landing icons ([ed1bc3fee](https://github.com/underpostnet/engine/commit/ed1bc3fee671319b151e218ec58b9ca67200579e))
+
+### github-actions
+
+- Add condition to skip jobs for dependabot in Coverall CI workflow ([db35270a6](https://github.com/underpostnet/engine/commit/db35270a686edf5c975721a3ec60ae8fc0b893be))
+- Enhance underpost test execution and improve error handling ([d046dcee2](https://github.com/underpostnet/engine/commit/d046dcee2a78c2a80fd13ac74322a735aa3044c5))
+- Update CI workflows to specify repository paths for cyberia-client and cyberia-server; adjust Dockerfile to copy from the correct directory ([9bef93774](https://github.com/underpostnet/engine/commit/9bef93774841ec650b2574f2369b8e6b486c342d))
+
+### cli-deploy
+
+- Add imagePullPolicy option to deployment commands and documentation ([d1ebe5d71](https://github.com/underpostnet/engine/commit/d1ebe5d71a7840d7739be0f41d59dc0f5dfdd155))
+- Enhance deployment monitoring: improve pod readiness checks, add container-status validation, and refine logging for deployment progress ([3cb67b64b](https://github.com/underpostnet/engine/commit/3cb67b64b01af8055396ca78515011ffe4146b28))
+
+### gitub-actions
+
+- Enhance CI workflow and Dockerfiles to include SSR dashboard setup and dependencies ([6e8db980f](https://github.com/underpostnet/engine/commit/6e8db980f79b3ef9d48d2231f83ea62c28879f25))
+
+### client-core
+
+- Enhance file handling logic and improve UI interactions in PanelForm and Auth components ([f4e146195](https://github.com/underpostnet/engine/commit/f4e146195b94dc8df711bb3e1eec52feaae0489c))
+- Enhance offline and maintenance fallback handling: implement inline HTML responses, improve caching logic, and ensure user-friendly error pages ([1802b40ca](https://github.com/underpostnet/engine/commit/1802b40caab7c90b0c73a9ab70a042772a8fe77b))
+- Enhance service worker fallback handling: add inline HTML responses for offline and maintenance states, improve caching logic, and refine navigation fetch strategy ([bc2a1a0ca](https://github.com/underpostnet/engine/commit/bc2a1a0ca711e7448ee9be7629a8e0e3b598dfaf))
+- Add SSR views for server metrics, maintenance, and offline handling ([81ca21084](https://github.com/underpostnet/engine/commit/81ca21084a7246f2926ee6b6c6f96858714a232c))
+
+### dependencies
+
+- Update dependencies and improve branch deletion error handling ([bcbf1a5e3](https://github.com/underpostnet/engine/commit/bcbf1a5e3a801d4bc6fdfc1e0f17a5630b40b325))
+- Update dependencies: bump body-parser to 1.20.5, express to 4.22.2, and qs to 6.15.2 ([3d5da7d28](https://github.com/underpostnet/engine/commit/3d5da7d28bba137ea50b0c2260b5614bf42c2b69))
+
+### ssr-cyberia
+
+- Refactor ssr/views/CyberiaServerMetrics.js ([7184a738d](https://github.com/underpostnet/engine/commit/7184a738d17602fafe5cefd7722a7cd669b11693))
+
+### cli
+
+- Enhance error handling: silence errors during git commit and process termination ([7583c4f12](https://github.com/underpostnet/engine/commit/7583c4f1288713513c02b76e5c11649c41e427ca))
+
+### cluster
+
+- Add targeted reset option for MongoDB components without full cluster restart ([8c293e11d](https://github.com/underpostnet/engine/commit/8c293e11dfafb992ccf3b26ab139e95266c28169))
+- Enhance UnderpostCluster: add natSetup method for NAT and iptables configuration, improve cluster deletion logic, and update options parameter for config method ([b90d7dba7](https://github.com/underpostnet/engine/commit/b90d7dba7bcbdd1d433f763ab3f7394dabf912f2))
+
+### ipfs
+
+- Fix IPFS deployment: streamline UDP buffer sysctl application for Kind nodes ([2b08cbc6d](https://github.com/underpostnet/engine/commit/2b08cbc6dafcd4af7b55c96d99bc7b8e603b80f6))
+
+### db
+
+- Refactor MongoDB bootstrap logic: enhance admin authentication check and streamline initialization script execution ([866e56c63](https://github.com/underpostnet/engine/commit/866e56c6303e20b8269778e5a7adc6e618f4520a))
+- Refactor MongoDB primary pod detection and bootstrap logic ([609f5e89b](https://github.com/underpostnet/engine/commit/609f5e89b5807df797bd5c16839c87f2bd786ba2))
+- Refactor MongoDB manifests and initialization: update PersistentVolume configurations, enhance StatefulSet security, and improve MongoDB cluster bootstrap logic ([ed89c3850](https://github.com/underpostnet/engine/commit/ed89c3850ca3108664ca70f9737ac756f7936083))
+- Refactor DataBaseProviderService: change #instance to static and update instance getter for compatibility ([360d2c856](https://github.com/underpostnet/engine/commit/360d2c856a6409efa32dc2e1d602bd6e5b268223))
+- Refactor replace DataBaseProvider with DataBaseProviderService across services and routers ([614e47314](https://github.com/underpostnet/engine/commit/614e4731493b413346f05915a0be6c18aa0d81c2))
+- Enhance MongoDB configuration and management: update stateful set parameters, improve secret handling, and implement replica set initialization logic ([1fb895669](https://github.com/underpostnet/engine/commit/1fb895669cbd8ec1d42b779c810ae6a35555725e))
+
+### ws
+
+- Refactor WebSocket management context: replace wsManagementId with hostKeyContext across IoInterface and related channels ([b82c80fce](https://github.com/underpostnet/engine/commit/b82c80fce52cba2ef9443ea664df69e727e35ca0))
+
+### deploy
+
+- Enhance deployment error handling: update expected container status, throw errors for pod status issues, and manage container status in shell execution ([d170f36cc](https://github.com/underpostnet/engine/commit/d170f36cc77b759a4e86a7f0dcad015aa6fc74ef))
+
+### lxd
+
+- Enhance LXD management: add safe teardown for VMs, improve engine source replication, and update documentation ([e9b3a68c9](https://github.com/underpostnet/engine/commit/e9b3a68c961dd08722dc3febbca3a5bd9c42a9fe))
+
+### api
+
+- Enhance ObjectLayerService command execution with error context ([4253b2437](https://github.com/underpostnet/engine/commit/4253b2437b9cb8af42cbea0967baa6900880e0b5))
+
+### docs
+
+- Clean docs ([465507082](https://github.com/underpostnet/engine/commit/465507082493ec26b96658b8dd26c33ace8e6bf4))
+- Update README.md for clarity and improved documentation links ([4021b6fcb](https://github.com/underpostnet/engine/commit/4021b6fcb55c6bad4e3cf605583c5b748ebb4734))
+- Add jsdelivr badge ([d2a6f2931](https://github.com/underpostnet/engine/commit/d2a6f293127801b89e7de1794c77bce2c0522276))
+- Update file paths and command syntax in architecture and client/server documentation ([f51891d44](https://github.com/underpostnet/engine/commit/f51891d44552fd5cd386e7685f86434b2cf02eb9))
+
+### settings
+
+- Update default formatters for JSON and TypeScript files ([e2c20b6f8](https://github.com/underpostnet/engine/commit/e2c20b6f896ef65f55df71678cc6e6d9c116b8f6))
+
+### dependabot
+
+- Update dependency patterns in dependabot.yml for improved package management ([60e8605c3](https://github.com/underpostnet/engine/commit/60e8605c3361e1cb824ac072d593a6321d79399f))
+
+### cli-cyberia
+
+- Refactor CyberiaDialogue handling to use codes instead of itemIds for improved dialogue management ([273fed2e4](https://github.com/underpostnet/engine/commit/273fed2e4706311fbbde993ce9ea5d549376dd0b))
+
+### runtime-cyberia
+
+- Refactor Dockerfiles for cyberia-client and cyberia-server to streamline package installations and improve build processes ([0312126c7](https://github.com/underpostnet/engine/commit/0312126c7032c17e1b67fe0fef8e7c74975d9ac8))
+
+### bin-vs
+
+- Fix correct typo in clean case to remove vsConfigRootPath ([0251c45a3](https://github.com/underpostnet/engine/commit/0251c45a3580ec0e5a907667fcc1240307e2f27b))
+
+## New release v:3.2.9 (2026-05-13)
 
 ### client-core
 

package/CLI-HELP.md

@@ -1,4 +1,4 @@
-## underpost ci/cd cli v3.2.9
+## underpost ci/cd cli v3.2.10
 
 ### Usage: `underpost [options] [command]`
   ```
@@ -412,6 +412,10 @@ Arguments:
 Options:
   --reset                              Deletes all clusters and prunes all
                                        related data and caches.
+  --reset-mongodb                      Performs a hard cleanup of only
+                                       MongoDB-related resources (StatefulSet,
+                                       PVCs/PVs, Secrets, ConfigMaps, caches)
+                                       without restarting the whole node.
   --mariadb                            Initializes the cluster with a MariaDB
                                        statefulset.
   --mysql                              Initializes the cluster with a MySQL
@@ -565,6 +569,11 @@ Options:
                                       bundle from Cloudinary inside the
                                       container. Use together with
                                       --skip-full-build.
+  --image-pull-policy <policy>        Override container imagePullPolicy in the
+                                      generated deployment manifest (Always,
+                                      IfNotPresent, Never). Defaults to Never
+                                      for localhost/ images and IfNotPresent
+                                      otherwise.
   -h, --help                          display help for command
  
 ```
@@ -903,7 +912,7 @@ Options:
 Runs specified scripts using various runners.
 
 Arguments:
-  runner-id                                       The runner ID to run. Options: dev-cluster,ipfs-expose,metadata,svc-ls,svc-rm,ssh-deploy-info,dev-hosts-expose,dev-hosts-restore,cluster-build,template-deploy,template-deploy-local,docker-image,clean,pull,release-deploy,ssh-deploy,ide,crypto-policy,sync,stop,ssh-deploy-stop,ssh-deploy-db-rollback,ssh-deploy-db,ssh-deploy-db-status,tz,get-proxy,instance-promote,instance,instance-build-manifest,ls-deployments,host-update,install-crio,dd-container,ip-info,db-client,git-conf,promote,metrics,cluster,deploy,disk-clean,disk-devices,disk-usage,dev,service,etc-hosts,sh,log,ps,pid-info,background,ports,deploy-test,tf-vae-test,spark-template,pull-rocky-image,rmi,kill,generate-pass,secret,underpost-config,gpu-env,tf-gpu-test,deploy-job,push-bundle,pull-bundle.
+  runner-id                                       The runner ID to run. Options: dev-cluster,ipfs-expose,metadata,svc-ls,svc-rm,ssh-deploy-info,dev-hosts-expose,dev-hosts-restore,cluster-build,template-deploy,template-deploy-local,docker-image,clean,pull,release-deploy,ssh-deploy,ide,crypto-policy,sync,stop,ssh-deploy-stop,ssh-deploy-db-rollback,ssh-deploy-db,ssh-deploy-db-status,tz,get-proxy,instance-promote,instance,instance-build-manifest,ls-deployments,host-update,install-crio,dd-container,ip-info,db-client,git-conf,promote,metrics,cluster,deploy,disk-clean,disk-devices,disk-usage,dev,service,etc-hosts,sh,log,ps,pid-info,background,ports,deploy-test,tf-vae-test,spark-template,pull-rocky-image,rmi,kill,generate-pass,secret,underpost-config,gpu-env,tf-gpu-test,deploy-job,push-bundle,pull-bundle,setup-shared-dir,reload-shared-dir.
   path                                            The input value, identifier, or path for the operation.
 
 Options:
@@ -987,7 +996,9 @@ Manages LXD virtual machines as K3s nodes (control plane or workers).
 Options:
   --init                           Initializes LXD on the current machine via
                                    preseed.
-  --reset                          Removes the LXD snap and purges all data.
+  --reset                          SAFE complete reset: cleans all VMs (proxy
+                                   devices first), profiles, networks, then
+                                   removes LXD snap.
   --install                        Installs the LXD snap.
   --dev                            Use local paths instead of the global npm
                                    installation.
@@ -1001,7 +1012,9 @@ Options:
                                    node.
   --create-vm <vm-name>            Copy the LXC launch command for a new K3s VM
                                    to the clipboard.
-  --delete-vm <vm-name>            Stop and delete the specified VM.
+  --delete-vm <vm-name>            SAFELY stop and delete VM (removes proxy
+                                   devices first, then stops, then deletes).
+                                   Safe to re-run.
   --init-vm <vm-name>              Run k3s-node-setup.sh on the specified VM
                                    (use with --control or --worker).
   --info-vm <vm-name>              Display full configuration and status for the
@@ -1018,9 +1031,8 @@ Options:
                                    "k3s-control:80,443").
   --delete-expose <vm-name:ports>  Remove proxied ports from a VM (e.g.,
                                    "k3s-control:80,443").
-  --workflow-id <workflow-id>      Workflow ID to execute via runWorkflow.
-  --vm-id <vm-name>                Target VM name for workflow execution.
-  --deploy-id <deploy-id>          Deployment ID context for workflow execution.
+  --bootstrap-engine <vm-name>     Replicate /home/dd/engine source into the VM
+                                   after init completes.
   --namespace <namespace>          Kubernetes namespace context (defaults to
                                    "default").
   -h, --help                       display help for command
@@ -1112,6 +1124,9 @@ Options:
   --pwa-build            Runs the pwa-microservices-template update flow: always
                          re-clones, syncs engine sources, installs, builds, and
                          pushes.
+  --dry-run              For --build: previews version-bump changes (per-file
+                         substitution counts) without writing files or running
+                         downstream commands.
   -h, --help             display help for command
  
 ```

package/README.md

@@ -16,17 +16,46 @@
 
 <div align="center">
 
-[![Node.js CI](https://github.com/underpostnet/engine/actions/workflows/docker-image.ci.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/docker-image.ci.yml) [![Test](https://github.com/underpostnet/engine/actions/workflows/coverall.ci.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/coverall.ci.yml) [![Downloads](https://img.shields.io/npm/dm/underpost.svg)](https://www.npmjs.com/package/underpost) [![Socket Badge](https://socket.dev/api/badge/npm/package/underpost/3.2.9)](https://socket.dev/npm/package/underpost/overview/3.2.9) [![Coverage Status](https://coveralls.io/repos/github/underpostnet/engine/badge.svg?branch=master)](https://coveralls.io/github/underpostnet/engine?branch=master) [![Version](https://img.shields.io/npm/v/underpost.svg)](https://www.npmjs.org/package/underpost) [![License](https://img.shields.io/npm/l/underpost.svg)](https://www.npmjs.com/package/underpost)
+[![Node.js CI](https://github.com/underpostnet/engine/actions/workflows/docker-image.ci.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/docker-image.ci.yml) [![Test](https://github.com/underpostnet/engine/actions/workflows/coverall.ci.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/coverall.ci.yml) [![Downloads](https://img.shields.io/npm/dm/underpost.svg)](https://www.npmjs.com/package/underpost) [![](https://data.jsdelivr.com/v1/package/npm/underpost/badge)](https://www.jsdelivr.com/package/npm/underpost) [![Socket Badge](https://socket.dev/api/badge/npm/package/underpost/3.2.10)](https://socket.dev/npm/package/underpost/overview/3.2.10) [![Coverage Status](https://coveralls.io/repos/github/underpostnet/engine/badge.svg?branch=master)](https://coveralls.io/github/underpostnet/engine?branch=master) [![Version](https://img.shields.io/npm/v/underpost.svg)](https://www.npmjs.org/package/underpost) [![License](https://img.shields.io/npm/l/underpost.svg)](https://www.npmjs.com/package/underpost)
 
 </div>
 
-<div align="center">
-
 #### Base template for pwa/api-rest projects.
 
-<div style="font-size: 20px;"><em>End2end</em> continuous integration and continuous deployment cloud applications toolchain. Develop, build, deploy, test, monitor, and manage multiple runtime applications on virtual machines or container instances.</div>
+## Underpost Platform
 
-</div>
+**Underpost** is an platform for application delivery, from infrastructure to runtime. The `underpost` npm package is its CLI toolchain surface.
+
+The project covers:
+
+- **Bare metal provisioning** on Rocky Linux 9.
+- **Kubernetes / K3s / kubeadm / LXD** workflows for production, edge, and isolated workloads.
+- **GitHub OSS repository flow** — clone, pull, push, commit, release, and CI integrations as first-class CLI subcommands.
+- **CI/CD orchestration** — GitHub Actions integrations, container builds, multi-environment deployments.
+- **Static build + PWA delivery** — every deploy ships as an installable Progressive Web App with Workbox-based offline support.
+- **Cloudinary-backed static asset flow** for image/asset delivery.
+- **ERP/CRM-style PWA base applications** as the default workload.
+- **Cyberia** — a dedicated MMO extension built on top of the platform, with its own content backend (`engine-cyberia`), authoritative simulation runtime (`cyberia-server`), and presentation runtime (`cyberia-client`).
+
+<a target="_top" href="Https://github.com/underpostnet/engine/blob/master/src/client/public/cyberia-docs/UNDERPOST-PLATFORM.md">See Detailed platform doc.</a>
+
+### Architectural roles (Cyberia stack)
+
+When the platform is hosting the Cyberia MMO extension, three runtime processes participate. Their boundaries are non-overlapping and their startup order is **strictly sequential** — not parallel.
+
+| Process                              | Role                                                                                                                                                                       |
+| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **engine-cyberia** (Node.js)         | Content authority: maps, object layers, atlas/asset metadata, world configuration, persistence, validation, gRPC + REST data services, editor backend, asset distribution. |
+| **cyberia-server** (Go)              | Authoritative simulation runtime: tick advancement, AOI replication, input command processing, snapshot generation.                                                        |
+| **cyberia-client** (C → WebAssembly) | Presentation runtime: rendering, UI, input capture, prediction, reconciliation, interpolation, client-side presentation defaults.                                          |
+
+**Startup order — sequential, in order:**
+
+1. **Persistent backend / sidecar data layer** — databases, content backend (engine-cyberia), static asset backend, config and data services.
+2. **cyberia-server** — authoritative Go simulation runtime; dials engine-cyberia gRPC at boot to load world configuration.
+3. **cyberia-client** — rendering, UI, prediction, interpolation, reconciliation; connects to cyberia-server via WebSocket.
+
+<a target="_top" href="https://github.com/underpostnet/engine-cyberia/blob/master/src/client/public/cyberia-docs/ARCHITECTURE.md">See Detailed architecture.</a>
 
 ## Create a new project
 
@@ -58,10 +87,10 @@ Run dev client server
 npm run dev
 ```
 
-<a target="_top" href="https://www.nexodev.org/docs?cid=src">See Docs here.</a>
+<a target="_top" href="https://www.nexodev.org/docs?cid=src">See Docs.</a>
 
 <!-- cli-index-start -->
-## underpost ci/cd cli v3.2.9
+## underpost ci/cd cli v3.2.10
 
 ### Usage: `underpost [options] [command]`
   ```
@@ -103,4 +132,4 @@ Commands:
 ```
 <!-- cli-index-end -->
 
-<a target="_top" href="https://github.com/underpostnet/pwa-microservices-template/blob/master/CLI-HELP.md">See CLI Docs here.</a>
+<a target="_top" href="https://github.com/underpostnet/pwa-microservices-template/blob/master/CLI-HELP.md">See CLI Docs.</a>

package/bin/build.js

@@ -64,9 +64,9 @@ if (process.argv.includes('conf')) {
     }
     shellExec(
       `cd ../${privateRepoName}` +
-        ` && git add .` +
-        ` && underpost cmt . ci engine-core-conf 'Update ${_confName} conf'` +
-        ` && underpost push . ${privateGitUri}`,
+      ` && git add .` +
+      ` && underpost cmt . ci engine-core-conf 'Update ${_confName} conf'` +
+      ` && underpost push . ${privateGitUri}`,
       {
         silent: true,
       },
@@ -167,23 +167,39 @@ const { DefaultConf } = await import(`../conf.${confName}.js`);
       packageJson.bin.cyberia = 'bin/index.js';
       packageJson.keywords = [
         'cyberia',
+        'cyberia-cli',
+        'sidecar',
+        'data-layer',
+        'engine-cyberia',
         'object-layer',
-        'game-engine',
-        'assets-management',
-        'web3',
         'atlas-sprite-sheet',
+        'ipfs',
+        'erc-1155',
+        'object-layer-token',
+        'hardhat',
+        'hyperledger-besu',
+        'blockchain',
+        'web3',
+        'underpost-platform',
+        'mmo-extension',
       ];
-      packageJson.description = 'Cyberia Engine - Object Layer and Assets Management Microservice';
-      const { CyberiaDependencies } = await import(`../src/client/components/cyberia-portal/CommonCyberiaPortal.js`);
+      packageJson.description =
+        'Cyberia CLI — toolchain for the Cyberia MMO data layer, content pipeline, persistence, gRPC services, and ERC-1155 lifecycle on Hyperledger Besu.';
+      const { CyberiaDependencies } = await import(`../src/api/cyberia-server-defaults/cyberia-server-defaults.js`);
       packageJson.dependencies = {
         ...originPackageJson.dependencies,
         ...CyberiaDependencies,
       };
       fs.writeFileSync(`${basePath}/bin/index.js`, fs.readFileSync(`./bin/cyberia.js`, 'utf8'), 'utf8');
+      fs.writeFileSync(
+        `${basePath}/README.md`,
+        fs.readFileSync(`./src/client/public/cyberia-docs/CYBERIA-CLI.md`, 'utf8'),
+        'utf8',
+      );
       fs.copySync(`./hardhat`, `${basePath}/hardhat`);
       for (const path of [
         '/src/grpc/cyberia',
-        '/src/client/ssr/pages/CyberiaServerMetrics.js',
+        '/src/client/ssr/views/CyberiaServerMetrics.js',
         '/src/server/object-layer.js',
         '/src/server/atlas-sprite-sheet-generator.js',
         '/src/server/shape-generator.js',
@@ -197,6 +213,7 @@ const { DefaultConf } = await import(`../conf.${confName}.js`);
         '/src/runtime/cyberia-client',
         '/.github/workflows/hardhat.ci.yml',
         '/src/client/public/cyberia-docs',
+        '/src/api/cyberia-server-defaults'
       ])
         fs.copySync(`.${path}`, `${basePath}${path}`);
 

package/bin/deploy.js

@@ -443,10 +443,10 @@ ${shellExec(`git log | grep Author: | sort -u`, { stdout: true }).split(`\n`).jo
           shellExec(`sudo kubectl delete secret ${secretSelector} -n ${namespace} --ignore-not-found`);
           shellExec(
             `sudo kubectl create secret generic ${secretSelector}` +
-              ` --from-literal=POSTGRES_DB=postgresdb` +
-              ` --from-literal=POSTGRES_USER=admin` +
-              ` --from-file=POSTGRES_PASSWORD=/home/dd/engine/engine-private/postgresql-password` +
-              ` --dry-run=client -o yaml | kubectl apply -f - -n ${namespace}`,
+            ` --from-literal=POSTGRES_DB=postgresdb` +
+            ` --from-literal=POSTGRES_USER=admin` +
+            ` --from-file=POSTGRES_PASSWORD=/home/dd/engine/engine-private/postgresql-password` +
+            ` --dry-run=client -o yaml | kubectl apply -f - -n ${namespace}`,
           );
         }
         {
@@ -454,10 +454,10 @@ ${shellExec(`git log | grep Author: | sort -u`, { stdout: true }).split(`\n`).jo
           shellExec(`sudo kubectl delete secret ${secretSelector} -n ${namespace} --ignore-not-found`);
           shellExec(
             `sudo kubectl create secret generic ${secretSelector}` +
-              ` --from-file=SECRET_KEY=/home/dd/engine/engine-private/postgresql-password` +
-              ` --from-literal=FIRST_SUPERUSER=${process.env.GITHUB_EMAIL || 'development@underpost.net'}` +
-              ` --from-file=FIRST_SUPERUSER_PASSWORD=/home/dd/engine/engine-private/postgresql-password` +
-              ` --dry-run=client -o yaml | kubectl apply -f - -n ${namespace}`,
+            ` --from-file=SECRET_KEY=/home/dd/engine/engine-private/postgresql-password` +
+            ` --from-literal=FIRST_SUPERUSER=${process.env.GITHUB_EMAIL || 'development@underpost.net'}` +
+            ` --from-file=FIRST_SUPERUSER_PASSWORD=/home/dd/engine/engine-private/postgresql-password` +
+            ` --dry-run=client -o yaml | kubectl apply -f - -n ${namespace}`,
           );
         }
       }
@@ -577,8 +577,7 @@ nvidia/gpu-operator \
       shellExec(`sudo docker pull ${image}`);
       if (!process.argv.includes('kubeadm'))
         shellExec(
-          `sudo ${
-            process.argv.includes('kubeadm') ? `ctr -n k8s.io images import` : `kind load docker-image`
+          `sudo ${process.argv.includes('kubeadm') ? `ctr -n k8s.io images import` : `kind load docker-image`
           } ${image}`,
         );
       const namespace = process.argv.find((arg) => arg.startsWith('--namespace='))?.split('=')[1] || 'default';
@@ -627,11 +626,11 @@ nvidia/gpu-operator \
           }
           env[key] =
             `${key}`.toUpperCase().match('API') ||
-            `${key}`.toUpperCase().match('KEY') ||
-            `${key}`.toUpperCase().match('SECRET') ||
-            `${key}`.toUpperCase().match('TOKEN') ||
-            `${key}`.toUpperCase().match('PASSWORD') ||
-            `${key}`.toUpperCase().match('MAC')
+              `${key}`.toUpperCase().match('KEY') ||
+              `${key}`.toUpperCase().match('SECRET') ||
+              `${key}`.toUpperCase().match('TOKEN') ||
+              `${key}`.toUpperCase().match('PASSWORD') ||
+              `${key}`.toUpperCase().match('MAC')
               ? 'changethis'
               : isNaN(parseFloat(privateEnv[key]))
                 ? `${privateEnv[key]}`.match(`@`)
@@ -714,7 +713,7 @@ nvidia/gpu-operator \
     }
 
     case 'cyberia': {
-      const { CyberiaDependencies } = await import(`../src/client/components/cyberia-portal/CommonCyberiaPortal.js`);
+      const { CyberiaDependencies } = await import(`../src/api/cyberia-server-defaults/cyberia-server-defaults.js`);
       for (const dep of Object.keys(CyberiaDependencies)) {
         const ver = CyberiaDependencies[dep];
         shellExec(`npm install ${dep}@${ver}`);
@@ -823,7 +822,7 @@ nvidia/gpu-operator \
 
       // Delete merged local and remote branches
       for (const { branch, isAlreadyMerged } of mergedBranches) {
-        shellExec(`git branch -D ${branch}`, { silent: true });
+        shellExec(`git branch -D ${branch}`, { silent: true, silentOnError: true });
         // logger.info(`Deleting remote branch: ${branch}${isAlreadyMerged ? ' (already merged)' : ''}`);
         // shellExec(`git push https://${process.env.GITHUB_TOKEN}@github.com/${gitUri}.git --delete ${branch}`, {
         //   disableLog: true,
@@ -1394,10 +1393,10 @@ nvidia/gpu-operator \
       const deployIds = deployIdArg
         ? [deployIdArg]
         : fs
-            .readFileSync(`./engine-private/deploy/dd.router`, 'utf8')
-            .split(',')
-            .map((d) => d.trim())
-            .filter(Boolean);
+          .readFileSync(`./engine-private/deploy/dd.router`, 'utf8')
+          .split(',')
+          .map((d) => d.trim())
+          .filter(Boolean);
 
       const addComponentToClientConf = ({ filePath, label, targetClientId, targetSubmoduleId }) => {
         if (!fs.existsSync(filePath)) return { added: 0, checked: 0, hasComponentFile: false };

package/bin/file.js

@@ -15,9 +15,13 @@ import dotenv from 'dotenv';
 
 const logger = loggerFactory(import.meta);
 
-dotenv.config({ path: `./engine-private/conf/dd-cron/.env.production`, override: true });
-
-logger.info('argv', process.argv);
+if (fs.existsSync('./engine-private/conf/dd-cron/.env.production'))
+  dotenv.config({
+    path:
+      `./engine-private/conf/dd-cron/.env.production`,
+    override: true
+  });
+else dotenv.config();
 
 let [exe, dir, type] = process.argv;
 let rawPath = process.argv[3].replaceAll(`'`, '');
@@ -56,10 +60,10 @@ try {
 
       if (type === 'update-template') {
         if (!fs.existsSync(toPath))
-          shellExec(`cd .. && underpost clone ${process.env.GITHUB_USERNAME}/pwa-microservices-template`);
+          shellExec(`cd .. && node engine/bin clone ${process.env.GITHUB_USERNAME}/pwa-microservices-template`);
         else {
           shellExec(`cd ${toPath} && git reset && git checkout . && git clean -f -d`);
-          shellExec(`underpost pull ${toPath} ${process.env.GITHUB_USERNAME}/pwa-microservices-template`);
+          shellExec(`node bin pull ${toPath} ${process.env.GITHUB_USERNAME}/pwa-microservices-template`);
           shellExec(`sudo rm -rf ${toPath}/engine-private`);
           shellExec(`sudo rm -rf ${toPath}/logs`);
         }
@@ -135,9 +139,6 @@ try {
         const templatePackageJson = JSON.parse(fs.readFileSync('../pwa-microservices-template/package.json', 'utf8'));
 
         const name = templatePackageJson.name;
-        const description = templatePackageJson.description;
-        const dev = templatePackageJson.scripts.dev;
-        const build = templatePackageJson.scripts.build;
 
         templatePackageJson.dependencies = originPackageJson.dependencies;
         templatePackageJson.devDependencies = originPackageJson.devDependencies;
@@ -145,11 +146,27 @@ try {
         templatePackageJson.scripts = originPackageJson.scripts;
         templatePackageJson.overrides = originPackageJson.overrides;
         templatePackageJson.name = name;
-        templatePackageJson.description = description;
-        // templatePackageJson.scripts.dev = dev;
-        // templatePackageJson.scripts.build = build;
+        templatePackageJson.description =
+          'Underpost Platform — end-to-end CI/CD and application-delivery toolchain CLI. Covers bare metal, Kubernetes, K3s, kubeadm, LXD, container/image orchestration, secrets, databases, cron jobs, monitoring, SSH, runners, PWA + Workbox delivery, and release orchestration. Extensible via downstream CLIs.';
         templatePackageJson.keywords = uniqueArray(
-          ['pwa', 'microservices', 'template', 'builder'].concat(templatePackageJson.keywords),
+          [
+            'underpost',
+            'underpost-platform',
+            'cli',
+            'toolchain',
+            'ci-cd',
+            'devops',
+            'kubernetes',
+            'k3s',
+            'kubeadm',
+            'lxd',
+            'bare-metal',
+            'container-orchestration',
+            'image-management',
+            'pwa',
+            'workbox',
+            'microservices',
+          ].concat(templatePackageJson.keywords || []),
         );
         delete templatePackageJson.scripts['update:template'];
         fs.writeFileSync(
@@ -199,4 +216,5 @@ try {
   }
 } catch (error) {
   logger.error(error, error.stack);
-}
+  process.exit(1);
+}

package/bin/index.js

@@ -9,4 +9,5 @@ try {
   program.parse();
 } catch (error) {
   logger.error(error);
-}
+  process.exit(1);
+}

package/bin/vs.js

@@ -65,7 +65,7 @@ switch (process.argv[2]) {
 
   case 'clean': {
     shellExec(`sudo rm -rf ${vsCodeRootPath}/*`);
-    shellExec(`sudo rn -rf ${vsConfigRootPath}`);
+    shellExec(`sudo rm -rf ${vsConfigRootPath}`);
     break;
   }
   default:

package/bump.config.js

@@ -0,0 +1,26 @@
+/**
+ * bumpp configuration for the Underpost engine.
+ *
+ * Owns the *canonical* version-bearing files (anything that exposes a literal `version` field
+ * bumpp can detect natively). Non-canonical files — image tags in workflows, README badges,
+ * doc strings, deployment.yaml image refs — are handled by the custom regex walker in
+ * src/cli/release.js (VERSION_BUMP_TARGETS), because bumpp only rewrites `version`-shaped lines.
+ *
+ * release.js drives bumpp programmatically (versionBump from 'bumpp') with commit/tag/push
+ * disabled, since the engine release flow stages and commits separately via `node bin cmt`.
+ *
+ * @see https://github.com/antfu/bumpp
+ */
+export default {
+  files: [
+    'package.json',
+    'package-lock.json',
+    // engine-private confs are git-ignored and visited only if present at bump time.
+    'engine-private/conf/**/package.json',
+  ],
+  commit: false,
+  tag: false,
+  push: false,
+  confirm: false,
+  recursive: false,
+};