underpost 3.1.2 → 3.2.0

package/CLI-HELP.md

@@ -1,4 +1,4 @@
-## underpost ci/cd cli v3.1.2
+## underpost ci/cd cli v3.2.0
 
 ### Usage: `underpost [options] [command]`
   ```
@@ -34,6 +34,7 @@ Commands:
   run [options] <runner-id> [path]                           Runs specified scripts using various runners.
   lxd [options]                                              Manages LXD virtual machines as K3s nodes (control plane or workers).
   baremetal [options] [workflow-id]                          Manages baremetal server operations, including installation, database setup, commissioning, and user management.
+  release [options] [version]                                Release orchestrator for building new versions and deploying releases of the Underpost CLI.
   help [command]                                             display help for command
  
 ```
@@ -92,6 +93,9 @@ Arguments:
 Options:
   --sync-env-port   Sync environment port assignments across all deploy IDs
   --single-replica  Build single replica folders instead of full client
+  --build-zip       Create zip files of the builds
+  --lite-build      Skip full build (default is full build)
+  --icons-build     Build icons
   -h, --help        display help for command
  
 ```
@@ -118,6 +122,8 @@ Options:
                                process.
   --underpost-quickly-install  Uses Underpost Quickly Install for dependency
                                installation.
+  --skip-pull-base             Skips cloning repositories, uses current
+                               workspace code directly.
   -h, --help                   display help for command
  
 ```
@@ -178,7 +184,7 @@ Arguments:
                                      message for the commit.
 
 Options:
-  --log <latest-n>                   Shows commit history from the specified
+  --log [latest-n]                   Shows commit history from the specified
                                      number of latest n path commits.
   --last-msg <latest-n>              Displays the last n commit message.
   --empty                            Allows committing with empty files.
@@ -205,7 +211,14 @@ Options:
   --changelog-no-hash                Excludes commit hashes from the generated
                                      changelog entries (used with
                                      --changelog-build).
+  --unpush                           With --log, automatically sets range to
+                                     unpushed commits ahead of remote.
   -b                                 Shows the current Git branch name.
+  -p [branch]                        Shows the reflog for the specified branch.
+  --bc <commit-hash>                 Shows branches that contain the specified
+                                     commit.
+  --is-remote-repo <url-repo>        Checks whether a remote Git repository URL
+                                     is reachable. Prints true or false.
   -h, --help                         display help for command
  
 ```
@@ -505,6 +518,12 @@ Options:
                                       machine network configuration.
   --kubeadm                           Enables the kubeadm context for deployment
                                       operations.
+  --k3s                               Enables the k3s context for deployment
+                                      operations.
+  --kind                              Enables the kind context for deployment
+                                      operations.
+  --git-clean                         Runs git clean on volume mount paths
+                                      before copying.
   --etc-hosts                         Enables the etc-hosts context for
                                       deployment operations.
   --restore-hosts                     Restores default `/etc/hosts` entries.
@@ -854,7 +873,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-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,ls-deployments,host-update,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,ptls,deploy-test,tf-vae-test,spark-template,rmi,kill,secret,underpost-config,gpu-env,tf-gpu-test,deploy-job.
+  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,template-deploy-image,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,ls-deployments,host-update,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,rmi,kill,generate-pass,secret,underpost-config,gpu-env,tf-gpu-test,deploy-job.
   path                                            The input value, identifier, or path for the operation.
 
 Options:
@@ -901,6 +920,7 @@ Options:
   --kubeadm                                       Sets the kubeadm cluster context for the runner execution.
   --k3s                                           Sets the k3s cluster context for the runner execution.
   --kind                                          Sets the kind cluster context for the runner execution.
+  --git-clean                                     Runs git clean on volume mount paths before copying.
   --log-type <log-type>                           Sets the log type for the runner execution.
   --deploy-id <deploy-id>                         Sets deploy id context for the runner execution.
   --user <user>                                   Sets user context for the runner execution.
@@ -918,8 +938,10 @@ Options:
   --monitor-status-delta-ms <milliseconds>        Sets the polling interval in milliseconds for status monitoring (default: 1000).
   --monitor-status-max-attempts <attempts>        Sets the maximum number of status check attempts (default: 600).
   --dry-run                                       Preview operations without executing them.
+  --from-n-commit <n>                             Number of commits back to use for message propagation in template-deploy (default: 1, last commit only).
   --create-job-now                                After applying cron manifests, immediately create a Job from each CronJob (forwarded to cron runner).
   --host-aliases <host-aliases>                   Adds entries to the Pod /etc/hosts via hostAliases. Format: semicolon-separated entries of "ip=hostname1,hostname2" (e.g., "127.0.0.1=foo.local,bar.local;10.1.2.3=foo.remote,bar.remote").
+  --copy                                          Copies the runner output to the clipboard (supported by: generate-pass, template-deploy-local).
   -h, --help                                      display help for command
  
 ```
@@ -1032,4 +1054,34 @@ Options:
   -h, --help                                    display help for command
  
 ```
+  
+
+### `release` :
+```
+ Usage: underpost release [options] [version]
+
+Release orchestrator for building new versions and deploying releases of the
+Underpost CLI.
+
+Arguments:
+  version                The new version string to set (e.g., "3.1.4"). Defaults
+                         to current version.
+
+Options:
+  --build                Builds a new version: tests template, bumps versions,
+                         rebuilds manifests and configs.
+  --deploy               Deploys the release: syncs secrets, commits, and pushes
+                         to remote repositories.
+  --ci-push <deploy-id>  Local equivalent of engine-*.ci.yml: builds
+                         dd-{deploy-id} and pushes to the engine-{deploy-id}
+                         repository. Accepts the suffix (e.g., "cyberia"),
+                         "dd-cyberia", or "engine-cyberia".
+  --message <message>    Commit message for --ci-push or --pwa-build (defaults
+                         to last commit of the engine repository).
+  --pwa-build            Runs the pwa-microservices-template update flow: always
+                         re-clones, syncs engine sources, installs, builds, and
+                         pushes.
+  -h, --help             display help for command
+ 
+```
   

package/README.md

@@ -16,7 +16,7 @@
 
 <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.1.2)](https://socket.dev/npm/package/underpost/overview/3.1.2) [![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) [![Socket Badge](https://socket.dev/api/badge/npm/package/underpost/3.2.0)](https://socket.dev/npm/package/underpost/overview/3.2.0) [![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>
 
@@ -60,7 +60,8 @@ npm run dev
 
 <a target="_top" href="https://www.nexodev.org/docs?cid=src">See Docs here.</a>
 
-## underpost ci/cd cli v3.1.2
+<!-- cli-index-start -->
+## underpost ci/cd cli v3.2.0
 
 ### Usage: `underpost [options] [command]`
   ```
@@ -70,6 +71,7 @@ npm run dev
 
 Commands:
   new [options] [app-name]                                   Initializes a new Underpost project, service, or configuration.
+  client [options] [deploy-id] [sub-conf] [host] [path]      Builds client assets, single replicas, and/or syncs environment ports.
   start [options] <deploy-id> [env]                          Initiates application servers, build pipelines, or other defined services based on the deployment ID.
   clone [options] <uri>                                      Clones a specified GitHub repository into the current directory.
   pull [options] <path> <uri>                                Pulls the latest changes from a specified GitHub repository.
@@ -93,10 +95,12 @@ Commands:
   monitor [options] <deploy-id> [env]                        Manages health server monitoring for specified deployments.
   ssh [options]                                              Manages SSH credentials and sessions for remote access to cluster nodes or services.
   run [options] <runner-id> [path]                           Runs specified scripts using various runners.
-  lxd [options]                                              Manages LXD containers and virtual machines.
+  lxd [options]                                              Manages LXD virtual machines as K3s nodes (control plane or workers).
   baremetal [options] [workflow-id]                          Manages baremetal server operations, including installation, database setup, commissioning, and user management.
+  release [options] [version]                                Release orchestrator for building new versions and deploying releases of the Underpost CLI.
   help [command]                                             display help for command
  
 ```
+<!-- cli-index-end -->
 
 <a target="_top" href="https://github.com/underpostnet/pwa-microservices-template/blob/master/CLI-HELP.md">See CLI Docs here.</a>

package/bin/build.js

@@ -169,21 +169,22 @@ const { DefaultConf } = await import(`../conf.${confName}.js`);
       packageJson.description = 'Cyberia Engine - Object Layer and Assets Management Microservice';
       const { CyberiaDependencies } = await import(`../src/client/components/cyberia-portal/CommonCyberiaPortal.js`);
       packageJson.dependencies = {
-        ...packageJson.dependencies,
+        ...originPackageJson.dependencies,
         ...CyberiaDependencies,
       };
-      packageJson.overrides = originPackageJson.overrides;
       fs.writeFileSync(`${basePath}/bin/index.js`, fs.readFileSync(`./bin/cyberia.js`, 'utf8'), 'utf8');
       fs.copyFileSync(`./src/api/object-layer/README.md`, `${basePath}/README.md`);
       fs.copySync(`./hardhat`, `${basePath}/hardhat`);
       fs.copySync(`./hardhat/WHITE-PAPER.md`, `${basePath}/WHITE-PAPER.md`);
-      fs.copyFileSync(`./jsdoc.${confName}.json`, `${basePath}/jsdoc.json`);
       for (const path of [
+        '/src/grpc/cyberia',
         '/src/client/ssr/pages/CyberiaServerMetrics.js',
         '/src/server/object-layer.js',
         '/src/server/atlas-sprite-sheet-generator.js',
         '/src/server/shape-generator.js',
         '/src/server/semantic-layer-generator.js',
+        '/src/server/semantic-layer-generator-floor.js',
+        '/src/server/semantic-layer-generator-skin.js',
         '/test/shape-generator.test.js',
         '/src/server/besu-genesis-generator.js',
         '/.github/workflows/hardhat.ci.yml',
@@ -203,25 +204,30 @@ const { DefaultConf } = await import(`../conf.${confName}.js`);
   fs.copySync(`./src/cli`, `${basePath}/src/cli`);
   if (!fs.existsSync(`${basePath}/images`)) fs.mkdirSync(`${basePath}/images`);
 
-  const env = process.argv.includes('development') ? 'development' : 'production';
-  const deploymentsFiles = ['proxy.yaml', 'deployment.yaml', 'secret.yaml'];
-  // remove engine-private of .dockerignore for local testing
-  for (const file of deploymentsFiles) {
-    if (fs.existsSync(`./manifests/deployment/${confName}-${env}/${file}`)) {
-      fs.copyFileSync(`./manifests/deployment/${confName}-${env}/${file}`, `${basePath}/${file}`);
-    }
-  }
-
   fs.copyFileSync(`./.github/workflows/${repoName}.ci.yml`, `${basePath}/.github/workflows/${repoName}.ci.yml`);
   fs.copyFileSync(`./.github/workflows/${repoName}.cd.yml`, `${basePath}/.github/workflows/${repoName}.cd.yml`);
 
+  if (fs.existsSync(`./jsdoc.${confName}.json`)) {
+    fs.copyFileSync(`./jsdoc.${confName}.json`, `${basePath}/jsdoc.json`);
+    fs.copyFileSync(`./jsdoc.${confName}.json`, `${basePath}/jsdoc.${confName}.json`);
+  }
+
+  if (fs.existsSync(`./manifests/deployment/${confName}-development`))
+    fs.copySync(
+      `./manifests/deployment/${confName}-development`,
+      `${basePath}/manifests/deployment/${confName}-development`,
+    );
+
   // Copy conf.<deploy-id>.js to conf.js for the respective deployment
   fs.copyFileSync(`./conf.${confName}.js`, `${basePath}/conf.js`);
   fs.copyFileSync(`./manifests/deployment/${confName}-development/proxy.yaml`, `${basePath}/proxy.yaml`);
   fs.copyFileSync(`./manifests/deployment/${confName}-development/deployment.yaml`, `${basePath}/deployment.yaml`);
+  const pvPvcPath = `./manifests/deployment/${confName}-development/pv-pvc.yaml`;
+  if (fs.existsSync(pvPvcPath)) fs.copyFileSync(pvPvcPath, `${basePath}/pv-pvc.yaml`);
 
   if (fs.existsSync(`./src/ws/${confName.split('-')[1]}`)) {
     fs.copySync(`./src/ws/${confName.split('-')[1]}`, `${basePath}/src/ws/${confName.split('-')[1]}`);
   }
+  fs.copyFileSync(`.gitignore`, `${basePath}/.gitignore`);
   shellExec(`cd ${basePath} && npm install --ignore-scripts`);
 }