@underpostnet/underpost 3.0.1 → 3.0.3

package/CLI-HELP.md

@@ -1,4 +1,4 @@
-## underpost ci/cd cli v3.0.1
+## underpost ci/cd cli v3.0.3
 
 ### Usage: `underpost [options] [command]`
   ```
@@ -379,8 +379,6 @@ Options:
   --dedicated-gpu                      Initializes the cluster with dedicated
                                        GPU base resources and environment
                                        settings.
-  --full                               Initializes the cluster with all
-                                       available statefulsets and services.
   --ns-use <ns-name>                   Switches the current Kubernetes context
                                        to the specified namespace (creates if
                                        it doesn't exist).
@@ -835,7 +833,7 @@ Options:
 Runs specified scripts using various runners.
 
 Arguments:
-  runner-id                                       The runner ID to run. Options: dev-cluster,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,release-cmt,deploy-test,sync-replica,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-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,release-cmt,deploy-test,sync-replica,tf-vae-test,spark-template,rmi,kill,secret,underpost-config,gpu-env,tf-gpu-test,deploy-job.
   path                                            The input value, identifier, or path for the operation.
 
 Options:
@@ -901,6 +899,7 @@ Options:
   --monitor-status-max-attempts <attempts>        Sets the maximum number of status check attempts (default: 600).
   --dry-run                                       Preview operations without executing them.
   --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").
   -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.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.0.1)](https://socket.dev/npm/package/underpost/overview/3.0.1) [![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.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.0.3)](https://socket.dev/npm/package/underpost/overview/3.0.3) [![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,7 @@ npm run dev
 
 <a target="_top" href="https://www.nexodev.org/docs?cid=src">See Docs here.</a>
 
-## underpost ci/cd cli v3.0.1
+## underpost ci/cd cli v3.0.3
 
 ### Usage: `underpost [options] [command]`
   ```

package/bin/build.js

@@ -172,6 +172,7 @@ const { DefaultConf } = await import(`../conf.${confName}.js`);
         ...packageJson.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`);
@@ -180,6 +181,9 @@ const { DefaultConf } = await import(`../conf.${confName}.js`);
         '/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',
+        '/test/shape-generator.test.js',
       ])
         fs.copySync(`.${path}`, `${basePath}${path}`);
 
@@ -216,4 +220,5 @@ const { DefaultConf } = await import(`../conf.${confName}.js`);
   if (fs.existsSync(`./src/ws/${confName.split('-')[1]}`)) {
     fs.copySync(`./src/ws/${confName.split('-')[1]}`, `${basePath}/src/ws/${confName.split('-')[1]}`);
   }
+  shellExec(`cd ${basePath} && npm install --ignore-scripts`);
 }

package/bin/deploy.js

@@ -374,7 +374,9 @@ try {
       shellExec(`node bin run kill 4002`);
       shellExec(`node bin run kill 4003`);
       shellExec(`npm run update-template`);
-      shellExec(`cd ../pwa-microservices-template && npm install`);
+      shellExec(
+        `cd ../pwa-microservices-template && npm install && echo "\nENABLE_FILE_LOGS=true" >> .env.development`,
+      );
       shellExec(`cd ../pwa-microservices-template && npm run build && timeout 5s npm run dev`, {
         async: true,
       });
@@ -509,33 +511,23 @@ ${shellExec(`git log | grep Author: | sort -u`, { stdout: true }).split(`\n`).jo
       // https://besu.hyperledger.org/
       // https://github.com/hyperledger/besu/archive/refs/tags/24.9.1.tar.gz
 
-      switch (process.platform) {
-        case 'linux':
-          {
-            shellCd(`..`);
-
-            // Download the Linux binary
-            shellExec(`wget https://github.com/hyperledger/besu/releases/download/24.9.1/besu-24.9.1.tar.gz`);
+      shellCd(`..`);
 
-            // Unzip the file:
-            shellExec(`tar -xvzf besu-24.9.1.tar.gz`);
+      // Download the Linux binary
+      shellExec(`wget https://github.com/hyperledger/besu/releases/download/24.9.1/besu-24.9.1.tar.gz`);
 
-            shellCd(`besu-24.9.1`);
+      // Unzip the file:
+      shellExec(`tar -xvzf besu-24.9.1.tar.gz`);
 
-            shellExec(`bin/besu --help`);
+      shellCd(`besu-24.9.1`);
 
-            // Set env path
-            // export PATH=$PATH:/home/dd/besu-24.9.1/bin
+      shellExec(`bin/besu --help`);
 
-            // Open src
-            // shellExec(`sudo code /home/dd/besu-24.9.1 --user-data-dir="/root/.vscode-root" --no-sandbox`);
-          }
-
-          break;
+      // Set env path
+      // export PATH=$PATH:/home/dd/besu-24.9.1/bin
 
-        default:
-          break;
-      }
+      // Open src
+      // shellExec(`sudo code /home/dd/besu-24.9.1 --user-data-dir="/root/.vscode-root" --no-sandbox`);
 
       break;
     }
@@ -977,10 +969,10 @@ nvidia/gpu-operator \
             `${key}`.toUpperCase().match('MAC')
               ? 'changethis'
               : isNaN(parseFloat(privateEnv[key]))
-              ? `${privateEnv[key]}`.match(`@`)
-                ? 'admin@default.net'
-                : 'changethis'
-              : privateEnv[key];
+                ? `${privateEnv[key]}`.match(`@`)
+                  ? 'admin@default.net'
+                  : 'changethis'
+                : privateEnv[key];
         }
         return env;
       };

package/bin/file.js

@@ -97,6 +97,9 @@ try {
           './manifests/deployment/dd-template-development',
           './src/server/object-layer.js',
           './src/server/atlas-sprite-sheet-generator.js',
+          './src/server/shape-generator.js',
+          './src/server/semantic-layer-generator.js',
+          './test/shape-generator.test.js',
           'bin/cyberia.js',
         ]) {
           if (fs.existsSync(deletePath)) fs.removeSync('../pwa-microservices-template/' + deletePath);

package/manifests/cronjobs/dd-cron/dd-cron-backup.yaml

@@ -23,7 +23,7 @@ spec:
         spec:
           containers:
             - name: dd-cron-backup
-              image: underpost/underpost-engine:v3.0.1
+              image: underpost/underpost-engine:v3.0.3
               command:
                 - /bin/sh
                 - -c

package/manifests/cronjobs/dd-cron/dd-cron-dns.yaml

@@ -23,7 +23,7 @@ spec:
         spec:
           containers:
             - name: dd-cron-dns
-              image: underpost/underpost-engine:v3.0.1
+              image: underpost/underpost-engine:v3.0.3
               command:
                 - /bin/sh
                 - -c

package/manifests/deployment/dd-default-development/deployment.yaml

@@ -17,7 +17,7 @@ spec:
     spec:
       containers:
         - name: dd-default-development-blue
-          image: localhost/rockylinux9-underpost:v3.0.1
+          image: localhost/rockylinux9-underpost:v3.0.3
           #          resources:
           #            requests:
           #              memory: "124Ki"
@@ -100,7 +100,7 @@ spec:
     spec:
       containers:
         - name: dd-default-development-green
-          image: localhost/rockylinux9-underpost:v3.0.1
+          image: localhost/rockylinux9-underpost:v3.0.3
           #          resources:
           #            requests:
           #              memory: "124Ki"

package/manifests/deployment/dd-test-development/deployment.yaml

@@ -18,7 +18,7 @@ spec:
     spec:
       containers:
         - name: dd-test-development-blue
-          image: localhost/rockylinux9-underpost:v3.0.1
+          image: localhost/rockylinux9-underpost:v3.0.3
 
           command:
             - /bin/sh
@@ -103,7 +103,7 @@ spec:
     spec:
       containers:
         - name: dd-test-development-green
-          image: localhost/rockylinux9-underpost:v3.0.1
+          image: localhost/rockylinux9-underpost:v3.0.3
 
           command:
             - /bin/sh

package/manifests/ipfs/configmap.yaml

@@ -16,6 +16,13 @@ data:
       ipfs-cluster-service init
     fi
 
+    # Bind cluster APIs to 0.0.0.0 so they are reachable from other pods.
+    # By default ipfs-cluster listens on 127.0.0.1 for REST (9094),
+    # Proxy (9095) and Pinning Service (9097).
+    sed -i 's|/ip4/127\.0\.0\.1/tcp/9094|/ip4/0.0.0.0/tcp/9094|g' /data/ipfs-cluster/service.json
+    sed -i 's|/ip4/127\.0\.0\.1/tcp/9095|/ip4/0.0.0.0/tcp/9095|g' /data/ipfs-cluster/service.json
+    sed -i 's|/ip4/127\.0\.0\.1/tcp/9097|/ip4/0.0.0.0/tcp/9097|g' /data/ipfs-cluster/service.json
+
     PEER_HOSTNAME=$(cat /proc/sys/kernel/hostname)
 
     if echo "${PEER_HOSTNAME}" | grep -q "^ipfs-cluster-0"; then

package/package.json

@@ -2,7 +2,7 @@
     "type": "module",
     "main": "src/index.js",
     "name": "@underpostnet/underpost",
-    "version": "3.0.1",
+    "version": "3.0.3",
     "description": "pwa api rest template",
     "scripts": {
         "start": "env-cmd -f .env.production node --max-old-space-size=8192 src/server",
@@ -111,6 +111,10 @@
     },
     "overrides": {
         "minimatch": "^10.2.2",
-        "glob": "^11.0.0"
+        "glob": "^11.0.0",
+        "diff": ">=8.0.3",
+        "js-yaml": ">=3.14.2",
+        "debug": ">=4.3.6",
+        "serialize-javascript": ">=7.0.3"
     }
 }

package/src/api/file/file.controller.js

@@ -19,22 +19,12 @@ const FileController = {
   },
   get: async (req, res, options) => {
     try {
+      res.setHeader('Access-Control-Allow-Origin', '*');
+      res.setHeader('Cross-Origin-Resource-Policy', 'cross-origin');
       const result = await FileService.get(req, res, options);
       if (result instanceof Buffer) {
-        if (
-          process.env.NODE_ENV === 'development' ||
-          req.hostname === options.host ||
-          (options.origins && options.origins.find((o) => o.match(req.hostname)))
-        ) {
-          res.set('Cross-Origin-Resource-Policy', 'cross-origin');
-          return res.status(200).end(result);
-        }
-        return res.status(403).json({
-          status: 'error',
-          message: 'Forbidden',
-        });
+        return res.status(200).end(result);
       }
-
       return res.status(200).json({
         status: 'success',
         data: result,

package/src/api/file/file.ref.json

@@ -5,27 +5,6 @@
       "logo": true
     }
   },
-  {
-    "api": "cyberia-biome",
-    "model": {
-      "fileId": true,
-      "topLevelColorFileId": true
-    }
-  },
-  {
-    "api": "cyberia-tile",
-    "model": {
-      "fileId": true
-    }
-  },
-  {
-    "api": "cyberia-world",
-    "model": {
-      "adjacentFace": {
-        "fileId": true
-      }
-    }
-  },
   {
     "api": "document",
     "model": {

package/src/cli/cluster.js

@@ -37,7 +37,6 @@ class UnderpostCluster {
      * @param {boolean} [options.postgresql=false] - Deploy PostgreSQL.
      * @param {boolean} [options.valkey=false] - Deploy Valkey.
      * @param {boolean} [options.ipfs=false] - Deploy ipfs-cluster statefulset.
-     * @param {boolean} [options.full=false] - Deploy a full set of common components.
      * @param {boolean} [options.info=false] - Display extensive Kubernetes cluster information.
      * @param {boolean} [options.certManager=false] - Deploy Cert-Manager for certificate management.
      * @param {boolean} [options.listPods=false] - List Kubernetes pods.
@@ -75,7 +74,6 @@ class UnderpostCluster {
         postgresql: false,
         valkey: false,
         ipfs: false,
-        full: false,
         info: false,
         certManager: false,
         listPods: false,
@@ -102,26 +100,22 @@ class UnderpostCluster {
         replicas: '',
       },
     ) {
-      // Handles initial host setup (installing docker, podman, kind, kubeadm, helm)
-      if (options.initHost === true) return Underpost.cluster.initHost();
+      if (options.initHost) return Underpost.cluster.initHost();
 
-      // Handles initial host setup (installing docker, podman, kind, kubeadm, helm)
-      if (options.uninstallHost === true) return Underpost.cluster.uninstallHost();
+      if (options.uninstallHost) return Underpost.cluster.uninstallHost();
 
-      // Applies general host configuration (SELinux, containerd, sysctl)
-      if (options.config === true) return Underpost.cluster.config();
+      if (options.config) return Underpost.cluster.config();
 
-      // Sets up kubectl configuration for the current user
-      if (options.chown === true) return Underpost.cluster.chown();
+      if (options.chown) return Underpost.cluster.chown();
 
       const npmRoot = getNpmRootPath();
-      const underpostRoot = options?.dev === true ? '.' : `${npmRoot}/underpost`;
+      const underpostRoot = options.dev ? '.' : `${npmRoot}/underpost`;
 
-      if (options.listPods === true) return console.table(Underpost.deploy.get(podName ?? undefined));
+      if (options.listPods) return console.table(Underpost.deploy.get(podName ?? undefined));
       // Set default namespace if not specified
       if (!options.namespace) options.namespace = 'default';
 
-      if (options.nsUse && typeof options.nsUse === 'string') {
+      if (options.nsUse) {
         // Verify if namespace exists, create if not
         const namespaceExists = shellExec(`kubectl get namespace ${options.nsUse} --ignore-not-found -o name`, {
           stdout: true,
@@ -142,8 +136,8 @@ class UnderpostCluster {
       }
 
       // Reset Kubernetes cluster components (Kind/Kubeadm/K3s) and container runtimes
-      if (options.reset === true) {
-        const clusterType = options.k3s === true ? 'k3s' : options.kubeadm === true ? 'kubeadm' : 'kind';
+      if (options.reset) {
+        const clusterType = options.k3s ? 'k3s' : options.kubeadm ? 'kubeadm' : 'kind';
         return await Underpost.cluster.safeReset({
           underpostRoot,
           removeVolumeHostPaths: options.removeVolumeHostPaths,
@@ -160,7 +154,7 @@ class UnderpostCluster {
       // --- Kubeadm/Kind/K3s Cluster Initialization ---
       if (!alreadyKubeadmCluster && !alreadyKindCluster && !alreadyK3sCluster) {
         Underpost.cluster.config();
-        if (options.k3s === true) {
+        if (options.k3s) {
           logger.info('Initializing K3s control plane...');
           // Install K3s
           logger.info('Installing K3s...');
@@ -172,7 +166,7 @@ class UnderpostCluster {
           logger.info('Waiting for K3s to be ready...');
           shellExec(`sudo systemctl is-active --wait k3s || sudo systemctl wait --for=active k3s.service`);
           logger.info('K3s service is active.');
-        } else if (options.kubeadm === true) {
+        } else if (options.kubeadm) {
           logger.info('Initializing Kubeadm control plane...');
           // Set default values if not provided
           const podNetworkCidr = options.podNetworkCidr || '192.168.0.0/16';
@@ -208,7 +202,7 @@ class UnderpostCluster {
           logger.info('Initializing Kind cluster...');
           shellExec(
             `cd ${underpostRoot}/manifests && kind create cluster --config kind-config${
-              options?.dev === true ? '-dev' : ''
+              options.dev ? '-dev' : ''
             }.yaml`,
           );
           Underpost.cluster.chown('kind'); // Pass 'kind' to chown
@@ -218,14 +212,12 @@ class UnderpostCluster {
       // --- Optional Component Deployments (Databases, Ingress, Cert-Manager) ---
       // These deployments happen after the base cluster is up.
 
-      if (options.full === true || options.dedicatedGpu === true) {
+      if (options.dedicatedGpu) {
         shellExec(`node ${underpostRoot}/bin/deploy nvidia-gpu-operator`);
-        shellExec(
-          `node ${underpostRoot}/bin/deploy kubeflow-spark-operator${options.kubeadm === true ? ' kubeadm' : ''}`,
-        );
+        shellExec(`node ${underpostRoot}/bin/deploy kubeflow-spark-operator${options.kubeadm ? ' kubeadm' : ''}`);
       }
 
-      if (options.grafana === true) {
+      if (options.grafana) {
         shellExec(`kubectl delete deployment grafana -n ${options.namespace} --ignore-not-found`);
         shellExec(`kubectl apply -k ${underpostRoot}/manifests/grafana -n ${options.namespace}`);
         const yaml = `${fs
@@ -238,7 +230,7 @@ EOF
 `);
       }
 
-      if (options.prom && typeof options.prom === 'string') {
+      if (options.prom) {
         shellExec(`kubectl delete deployment prometheus --ignore-not-found`);
         shellExec(`kubectl delete configmap prometheus-config --ignore-not-found`);
         shellExec(`kubectl delete service prometheus --ignore-not-found`);
@@ -257,8 +249,8 @@ EOF
 `);
       }
 
-      if (options.full === true || options.valkey === true) {
-        if (options.pullImage === true) Underpost.cluster.pullImage('valkey/valkey:latest', options);
+      if (options.valkey) {
+        if (options.pullImage) Underpost.cluster.pullImage('valkey/valkey:latest', options);
         shellExec(`kubectl delete statefulset valkey-service -n ${options.namespace} --ignore-not-found`);
         shellExec(`kubectl apply -k ${underpostRoot}/manifests/valkey -n ${options.namespace}`);
         await Underpost.test.statusMonitor('valkey-service', 'Running', 'pods', 1000, 60 * 10);
@@ -266,17 +258,17 @@ EOF
       if (options.ipfs) {
         await Underpost.ipfs.deploy(options, underpostRoot);
       }
-      if (options.full === true || options.mariadb === true) {
+      if (options.mariadb) {
         shellExec(
           `sudo kubectl create secret generic mariadb-secret --from-file=username=/home/dd/engine/engine-private/mariadb-username --from-file=password=/home/dd/engine/engine-private/mariadb-password --dry-run=client -o yaml | kubectl apply -f - -n ${options.namespace}`,
         );
         shellExec(`kubectl delete statefulset mariadb-statefulset -n ${options.namespace} --ignore-not-found`);
 
-        if (options.pullImage === true) Underpost.cluster.pullImage('mariadb:latest', options);
+        if (options.pullImage) Underpost.cluster.pullImage('mariadb:latest', options);
         shellExec(`kubectl apply -f ${underpostRoot}/manifests/mariadb/storage-class.yaml -n ${options.namespace}`);
         shellExec(`kubectl apply -k ${underpostRoot}/manifests/mariadb -n ${options.namespace}`);
       }
-      if (options.full === true || options.mysql === true) {
+      if (options.mysql) {
         shellExec(
           `sudo kubectl create secret generic mysql-secret --from-file=username=/home/dd/engine/engine-private/mysql-username --from-file=password=/home/dd/engine/engine-private/mysql-password --dry-run=client -o yaml | kubectl apply -f - -n ${options.namespace}`,
         );
@@ -285,15 +277,15 @@ EOF
         shellExec(`sudo chown -R $(whoami):$(whoami) /mnt/data`);
         shellExec(`kubectl apply -k ${underpostRoot}/manifests/mysql -n ${options.namespace}`);
       }
-      if (options.full === true || options.postgresql === true) {
-        if (options.pullImage === true) Underpost.cluster.pullImage('postgres:latest', options);
+      if (options.postgresql) {
+        if (options.pullImage) Underpost.cluster.pullImage('postgres:latest', options);
         shellExec(
           `sudo kubectl create secret generic postgres-secret --from-file=password=/home/dd/engine/engine-private/postgresql-password --dry-run=client -o yaml | kubectl apply -f - -n ${options.namespace}`,
         );
         shellExec(`kubectl apply -k ${underpostRoot}/manifests/postgresql -n ${options.namespace}`);
       }
-      if (options.mongodb4 === true) {
-        if (options.pullImage === true) Underpost.cluster.pullImage('mongo:4.4', options);
+      if (options.mongodb4) {
+        if (options.pullImage) Underpost.cluster.pullImage('mongo:4.4', options);
         shellExec(`kubectl apply -k ${underpostRoot}/manifests/mongodb-4.4 -n ${options.namespace}`);
 
         const deploymentName = 'mongodb-deployment';
@@ -314,8 +306,8 @@ EOF
         --eval 'rs.initiate(${JSON.stringify(mongoConfig)})'`,
           );
         }
-      } else if (options.full === true || options.mongodb === true) {
-        if (options.pullImage === true) Underpost.cluster.pullImage('mongo:latest', options);
+      } else if (options.mongodb) {
+        if (options.pullImage) Underpost.cluster.pullImage('mongo:latest', options);
         shellExec(
           `sudo kubectl create secret generic mongodb-keyfile --from-file=/home/dd/engine/engine-private/mongodb-keyfile --dry-run=client -o yaml | kubectl apply -f - -n ${options.namespace}`,
         );
@@ -344,11 +336,11 @@ EOF
         }
       }
 
-      if (options.full === true || options.contour === true) {
+      if (options.contour) {
         shellExec(
           `kubectl apply -f https://cdn.jsdelivr.net/gh/projectcontour/contour@release-1.33/examples/render/contour.yaml`,
         );
-        if (options.kubeadm === true) {
+        if (options.kubeadm) {
           // Envoy service might need NodePort for kubeadm
           shellExec(
             `sudo kubectl apply -f ${underpostRoot}/manifests/envoy-service-nodeport.yaml -n ${options.namespace}`,
@@ -358,7 +350,7 @@ EOF
         // so a specific NodePort service might not be needed or can be configured differently.
       }
 
-      if (options.full === true || options.certManager === true) {
+      if (options.certManager) {
         if (!Underpost.deploy.get('cert-manager').find((p) => p.STATUS === 'Running')) {
           shellExec(`helm repo add jetstack https://charts.jetstack.io --force-update`);
           shellExec(

package/src/cli/index.js

@@ -218,7 +218,6 @@ program
   .option('--contour', 'Initializes the cluster with Project Contour base HTTPProxy and Envoy.')
   .option('--cert-manager', "Initializes the cluster with a Let's Encrypt production ClusterIssuer.")
   .option('--dedicated-gpu', 'Initializes the cluster with dedicated GPU base resources and environment settings.')
-  .option('--full', 'Initializes the cluster with all available statefulsets and services.')
   .option(
     '--ns-use <ns-name>',
     "Switches the current Kubernetes context to the specified namespace (creates if it doesn't exist).",
@@ -613,6 +612,12 @@ program
     '--create-job-now',
     'After applying cron manifests, immediately create a Job from each CronJob (forwarded to cron runner).',
   )
+  .option(
+    '--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").',
+  )
   .description('Runs specified scripts using various runners.')
   .action(Underpost.run.callback);
 

package/src/cli/run.js

@@ -32,7 +32,6 @@ const logger = loggerFactory(import.meta);
  * @property {string} podName - The name of the pod to run.
  * @property {string} nodeName - The name of the node to run.
  * @property {number} port - Custom port to use.
- * @property {boolean} etcHosts - Whether to modify /etc/hosts.
  * @property {string} volumeHostPath - The host path for the volume.
  * @property {string} volumeMountPath - The mount path for the volume.
  * @property {string} imageName - The name of the image to run.
@@ -85,9 +84,12 @@ const logger = loggerFactory(import.meta);
  * @property {string} monitorStatusKindType - The monitor status kind type option.
  * @property {string} monitorStatusDeltaMs - The monitor status delta in milliseconds.
  * @property {string} monitorStatusMaxAttempts - The maximum number of attempts for monitor status.
+ * @property {boolean} logs - Whether to enable logs.
  * @property {boolean} dryRun - Whether to perform a dry run.
  * @property {boolean} createJobNow - Whether to create the job immediately.
- * @property {boolean} logs - Whether to enable logs.
+ * @property {string|Array<{ip: string, hostnames: string[]}>} hostAliases - Adds entries to the Pod /etc/hosts via Kubernetes hostAliases.
+ *   As a string (CLI): semicolon-separated entries of "ip=hostname1,hostname2" (e.g., "127.0.0.1=foo.local,bar.local;10.1.2.3=foo.remote").
+ *   As an array (programmatic): objects with `ip` and `hostnames` fields (e.g., [{ ip: "127.0.0.1", hostnames: ["foo.local"] }]).
  * @memberof UnderpostRun
  */
 const DEFAULT_OPTION = {
@@ -150,6 +152,7 @@ const DEFAULT_OPTION = {
   logs: false,
   dryRun: false,
   createJobNow: false,
+  hostAliases: '',
 };
 
 /**
@@ -217,6 +220,20 @@ class UnderpostRun {
       }
     },
 
+    /**
+     * @method ipfs-expose
+     * @description Exposes IPFS Cluster services on specified ports for local access.
+     * @type {Function}
+     * @memberof UnderpostRun
+     */
+    'ipfs-expose': (path, options = DEFAULT_OPTION) => {
+      const ports = [5001, 9094, 8080];
+      for (const port of ports)
+        shellExec(`node bin deploy --expose ipfs-cluster --expose-port ${port} --disable-update-underpost-config`, {
+          async: true,
+        });
+    },
+
     /**
      * @method metadata
      * @description Generates metadata for the specified path after exposing the development cluster.
@@ -1826,6 +1843,30 @@ EOF
       const imagePullPolicy = options.imagePullPolicy || 'IfNotPresent';
       const hostNetwork = options.hostNetwork ? options.hostNetwork : '';
       const apiVersion = options.apiVersion || 'v1';
+      // Parse hostAliases option:
+      //   - string from CLI: "ip1=host1,host2;ip2=host3,host4"
+      //   - array from programmatic callers: [{ ip: "127.0.0.1", hostnames: ["foo.local"] }]
+      const hostAliases = options.hostAliases
+        ? Array.isArray(options.hostAliases)
+          ? options.hostAliases
+          : options.hostAliases
+              .split(';')
+              .filter((entry) => entry.trim())
+              .map((entry) => {
+                const [ip, hostnamesStr] = entry.split('=');
+                const hostnames = hostnamesStr ? hostnamesStr.split(',').map((h) => h.trim()) : [];
+                return { ip: ip.trim(), hostnames };
+              })
+        : [];
+      const hostAliasesYaml =
+        hostAliases.length > 0
+          ? `  hostAliases:\n${hostAliases
+              .map(
+                (alias) =>
+                  `  - ip: "${alias.ip}"\n    hostnames:\n${alias.hostnames.map((h) => `    - "${h}"`).join('\n')}`,
+              )
+              .join('\n')}`
+          : '';
       const labels = options.labels
         ? options.labels
             .split(',')
@@ -1856,6 +1897,7 @@ spec:
   restartPolicy: ${restartPolicy}
 ${runtimeClassName ? `  runtimeClassName: ${runtimeClassName}` : ''}
 ${hostNetwork ? `  hostNetwork: ${hostNetwork}` : ''}
+${hostAliasesYaml}
   containers:
     - name: ${containerName}
       image: ${imageName}

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

@@ -27,8 +27,8 @@ const LoadingAnimation = {
                 ? subThemeManager.darkColor
                 : `#66e400`
               : subThemeManager.lightColor
-              ? subThemeManager.lightColor
-              : `#157e00`};"
+                ? subThemeManager.lightColor
+                : `#157e00`};"
           ></div>
         `,
       );
@@ -131,7 +131,6 @@ const LoadingAnimation = {
     if (!backgroundContainer) backgroundContainer = '.ssr-background';
     if (s(backgroundContainer)) {
       s(backgroundContainer).style.display = 'none';
-      if (s(`.main-body-btn-container`)) s(`.main-body-btn-container`).classList.remove('hide');
       if (callBack) callBack();
     }
   },