underpost 3.1.2 → 3.1.3

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

@@ -10,6 +10,14 @@ on:
         description: 'Changelog message for the build'
         required: false
         default: ''
+      deploy_conf_id:
+        description: 'Engine conf ID to dispatch after build (e.g., engine-core, engine-cyberia)'
+        required: false
+        default: ''
+      deploy_type:
+        description: 'Deployment type for the engine conf CD (sync-and-deploy or init)'
+        required: false
+        default: ''
 permissions:
   contents: write
   packages: write
@@ -83,5 +91,11 @@ jobs:
           git add .
           git config user.name 'underpostnet'
           git config user.email 'fcoverdugoa@underpost.net'
-          underpost cmt . ci package-pwa-microservices-template-ghpkg "$LAST_COMMIT_MESSAGE"
+          COMMIT_MSG="$LAST_COMMIT_MESSAGE"
+          DEPLOY_CONF_ID="${{ github.event.inputs.deploy_conf_id }}"
+          DEPLOY_TYPE="${{ github.event.inputs.deploy_type }}"
+          if [ -n "$DEPLOY_CONF_ID" ] && [ -n "$DEPLOY_TYPE" ]; then
+            COMMIT_MSG=$(printf '%s\n[cd:%s:%s]' "$COMMIT_MSG" "$DEPLOY_CONF_ID" "$DEPLOY_TYPE")
+          fi
+          underpost cmt . ci package-pwa-microservices-template-ghpkg "$COMMIT_MSG"
           underpost push . underpostnet/pwa-microservices-template

package/CHANGELOG.md

@@ -1,6 +1,47 @@
 # Changelog
 
-## 2026-03-15
+## 2026-03-17
+
+### cli-run
+
+- feat: Add 'pid-info' and 'background' methods to enhance process management in CLI ([30afedf4d](https://github.com/underpostnet/engine/commit/30afedf4d17aca20d91f5ad065d979bd42951741))
+
+### server-start
+
+- feat: Add option to skip pulling base code in build process and update configuration for error handling ([3f8d7b09b](https://github.com/underpostnet/engine/commit/3f8d7b09b70270de9b0213b74d9683aad125d732))
+
+### github-actions
+
+- feat: Update CI workflows to improve commit message handling and deployment conditions ([2a4884a1e](https://github.com/underpostnet/engine/commit/2a4884a1e3cbf04eeb4999b1ff38e2c8b4cf41cc))
+- feat: Add deploy_type option to CI workflows and enhance changelog message propagation ([d222753ec](https://github.com/underpostnet/engine/commit/d222753ec66cbb1ce3cccc54d7eebea3f144e8b8))
+
+### docs
+
+- feat: Update changelog, CLI help, and documentation with new commands and options ([124c8b2af](https://github.com/underpostnet/engine/commit/124c8b2aff6aae21b57abeca66281cdfba3aaaf8))
+- feat: Update CLI documentation and enhance README with versioning and command index ([e6eb668d4](https://github.com/underpostnet/engine/commit/e6eb668d4007dc828f1b946c36ea369aaea6e2d4))
+- feat: Enhance documentation configuration and remove obsolete options in build processes ([3437e1488](https://github.com/underpostnet/engine/commit/3437e14884d54202c8a0bbdcef47edfa03528fb7))
+
+### client-underpost
+
+- feat: Refactor styles in RichText and CssUnderpost components for improved typography ([ee1d12335](https://github.com/underpostnet/engine/commit/ee1d123354afb0826ef5f942a07feeeb6eb40c7b))
+
+### client-core
+
+- feat: Update links to open in the top frame and enhance iframe sandboxing ([8ec50df8d](https://github.com/underpostnet/engine/commit/8ec50df8d2eaaf210254930351a783c1d4409d5d))
+
+### cli-client
+
+- feat: Add sync-conf command and enhance build options for client assets ([ad8b96242](https://github.com/underpostnet/engine/commit/ad8b96242431b9a23b3cf3b4345294938552784f))
+
+### swagger
+
+- fix: update security middleware to ensure correct CSP headers for Swagger UI ([ef7dd5243](https://github.com/underpostnet/engine/commit/ef7dd52434191f4f910a7192007ebca5af16932b))
+
+### scripts
+
+- Add missing package installation command in ports-ls.sh ([e13253366](https://github.com/underpostnet/engine/commit/e13253366f5dfd029f2a12e031b5f995efb269ac))
+
+## New release v:3.1.2 (2026-03-15)
 
 ### cli-run
 

package/CLI-HELP.md

@@ -1,4 +1,4 @@
-## underpost ci/cd cli v3.1.2
+## underpost ci/cd cli v3.1.3
 
 ### Usage: `underpost [options] [command]`
   ```
@@ -92,6 +92,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 +121,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
  
 ```
@@ -854,7 +859,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-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,secret,underpost-config,gpu-env,tf-gpu-test,deploy-job.
   path                                            The input value, identifier, or path for the operation.
 
 Options:
@@ -918,6 +923,7 @@ 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").
   -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.1.3)](https://socket.dev/npm/package/underpost/overview/3.1.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,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.1.3
 
 ### 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,11 @@ 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.
   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/deploy.js

@@ -187,6 +187,7 @@ try {
           const deployPackage = JSON.parse(fs.readFileSync(filePah, 'utf8'));
           deployPackage.dependencies = originPackage.dependencies;
           deployPackage.devDependencies = originPackage.devDependencies;
+          deployPackage.overrides = originPackage.overrides;
           fs.writeFileSync(filePah, JSON.stringify(deployPackage, null, 4), 'utf8');
         }
       }
@@ -708,71 +709,6 @@ nvidia/gpu-operator \
       break;
     }
 
-    case 'udpate-version-files': {
-      const oldNpmVersion = process.argv[3];
-      const oldNodeVersion = process.argv[4];
-      const oldNodeMajorVersion = oldNodeVersion.split('.')[0];
-      const nodeVersion = shellExec(`node --version`, { stdout: true }).trim().replace('v', '');
-      const newNodeMajorVersion = nodeVersion.split('.')[0];
-      const npmVersion = shellExec(`npm --version`, { stdout: true }).trim();
-
-      fs.writeFileSync(
-        `README.md`,
-        fs
-          .readFileSync(`README.md`, 'utf8')
-          .replaceAll(oldNodeVersion, nodeVersion)
-          .replaceAll(oldNpmVersion, npmVersion),
-      );
-      fs.writeFileSync(
-        `src/client/public/nexodev/docs/references/Getting started.md`,
-        fs
-          .readFileSync(`src/client/public/nexodev/docs/references/Getting started.md`, 'utf8')
-          .replaceAll(oldNodeVersion, nodeVersion)
-          .replaceAll(oldNpmVersion, npmVersion),
-      );
-
-      const workflowFiles = [
-        `./.github/workflows/coverall.ci.yml`,
-
-        `./.github/workflows/engine-core.ci.yml`,
-
-        `./.github/workflows/engine-cyberia.ci.yml`,
-
-        `./.github/workflows/engine-lampp.ci.yml`,
-
-        `./.github/workflows/engine-test.ci.yml`,
-
-        `./.github/workflows/ghpkg.ci.yml`,
-
-        `./.github/workflows/npmpkg.ci.yml`,
-
-        `./.github/workflows/publish.ci.yml`,
-
-        `./.github/workflows/pwa-microservices-template-page.cd.yml`,
-
-        `./.github/workflows/pwa-microservices-template-test.ci.yml`,
-
-        `./.github/workflows/test-api-rest.cd.yml`,
-
-        `./src/runtime/lampp/Dockerfile`,
-
-        `./Dockerfile`,
-      ];
-
-      workflowFiles.forEach((file) => {
-        fs.writeFileSync(
-          file,
-          fs
-            .readFileSync(file, 'utf8')
-            .replaceAll(oldNodeMajorVersion + '.x', newNodeMajorVersion + '.x')
-            .replaceAll(oldNodeVersion, nodeVersion)
-            .replaceAll(oldNpmVersion, npmVersion),
-        );
-      });
-      pbcopy(`nvm alias default v${nodeVersion}`);
-      break;
-    }
-
     case 'tls': {
       fs.mkdirSync(`./engine-private/ssl/localhost`, { recursive: true });
       const targetDir = `./engine-private/ssl/${process.argv[3] ? process.argv[3] : 'localhost'}`;
@@ -854,6 +790,34 @@ nvidia/gpu-operator \
       break;
     }
 
+    case 'sync-conf': {
+      const originPackageJson = JSON.parse(fs.readFileSync(`./package.json`, 'utf8'));
+      for (const deployId of ['dd-cron'].concat(
+        fs.readFileSync(`./engine-private/deploy/dd.router`, 'utf8').split(','),
+      )) {
+        for (const file of fs.readdirSync(`./engine-private/conf/${deployId}/`)) {
+          const deployPackage = JSON.parse(fs.readFileSync(`./engine-private/conf/${deployId}/package.json`, 'utf8'));
+          deployPackage.overrides = originPackageJson.overrides;
+          fs.writeFileSync(
+            `./engine-private/conf/${deployId}/package.json`,
+            JSON.stringify(deployPackage, null, 4),
+            'utf8',
+          );
+          if (file.startsWith('conf.server') && file.endsWith('.json')) {
+            const filePath = `./engine-private/conf/${deployId}/${file}`;
+            const confObj = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+            for (const host of Object.keys(confObj)) {
+              for (const path of Object.keys(confObj[host])) {
+              }
+            }
+            fs.writeFileSync(filePath, JSON.stringify(confObj, null, 4), 'utf8');
+            logger.info(`sync-conf`, { deployId, file });
+          }
+        }
+      }
+      break;
+    }
+
     case 'cyberia': {
       const { CyberiaDependencies } = await import(`../src/client/components/cyberia-portal/CommonCyberiaPortal.js`);
       for (const dep of Object.keys(CyberiaDependencies)) {
@@ -863,43 +827,6 @@ nvidia/gpu-operator \
       break;
     }
 
-    case 'cyberia-hardhat': {
-      shellExec(`cd ./hardhat && npm install --include=dev`);
-      break;
-    }
-
-    case 'cyberia-docs': {
-      // Copy custom cyberia jsdoc to project root for docs build
-      const cyberiaJsDocPath = `./jsdoc.dd-cyberia.json`;
-      if (fs.existsSync(cyberiaJsDocPath)) {
-        logger.info('copying custom cyberia jsdoc.json to project root');
-        fs.copySync(cyberiaJsDocPath, `./jsdoc.json`);
-      }
-
-      // Generate hardhat coverage report for docs inclusion
-      if (fs.existsSync(`./hardhat/package.json`)) {
-        logger.info('generating hardhat coverage report for cyberia docs');
-        try {
-          shellExec(`cd ./hardhat && NODE_ENV=development npx hardhat coverage`);
-        } catch (e) {
-          logger.warn('hardhat coverage generation failed, continuing', e.message);
-        }
-      }
-
-      // Prepare cyberia docs references directory with hardhat README and WHITE-PAPER
-      const cyberiaDocsRefsDir = `./src/client/public/cyberia/docs/references`;
-      fs.mkdirSync(cyberiaDocsRefsDir, { recursive: true });
-      if (fs.existsSync(`./hardhat/README.md`)) {
-        fs.copySync(`./hardhat/README.md`, `${cyberiaDocsRefsDir}/Hardhat Module.md`);
-        logger.info('copied hardhat README.md to cyberia docs references');
-      }
-      if (fs.existsSync(`./hardhat/WHITE-PAPER.md`)) {
-        fs.copySync(`./hardhat/WHITE-PAPER.md`, `${cyberiaDocsRefsDir}/White Paper.md`);
-        logger.info('copied hardhat WHITE-PAPER.md to cyberia docs references');
-      }
-      break;
-    }
-
     case 'pw': {
       const help = `node bin/deploy pw <script-path> <from-path-in-pod> [to-path-on-local]`;
       const scriptPath = process.argv[3];

package/conf.js

@@ -156,7 +156,7 @@ const DefaultConf = /**/ {
   ssr: {
     Default: {
       head: ['Seo', 'Pwa', 'Css', 'DefaultScripts', 'Production'],
-      body: ['CacheControl', 'DefaultSplashScreen'],
+      body: ['CacheControl', 'DefaultSplashScreen', '404', '500', 'SwaggerDarkMode'],
       mailer: { userVerifyEmail: 'DefaultVerifyEmail', userRecoverEmail: 'DefaultRecoverEmail' },
       offline: [
         { path: '/offline', title: 'No Network Connection', client: 'NoNetworkConnection', head: [], body: [] },
@@ -172,11 +172,6 @@ const DefaultConf = /**/ {
         runtime: 'nodejs',
         apis: ['default', 'core', 'user', 'test', 'file', 'document'],
         origins: [],
-        minifyBuild: false,
-        iconsBuild: false,
-        liteBuild: true,
-        docsBuild: false,
-        offlineBuild: false,
         ws: 'core',
         peer: true,
         proxy: [80, 443],
@@ -214,8 +209,6 @@ const DefaultConf = /**/ {
         runtime: 'nodejs',
         apis: [],
         origins: [],
-        minifyBuild: false,
-        liteBuild: true,
         proxy: [80, 443],
       },
     },

package/jsdoc.json

@@ -22,7 +22,7 @@
       "search": true,
       "title": "Nexodev - ERP, CRM Development & Cloud DevOps Services",
       "homepageTitle": "Docs",
-      "favicon": "./public/www.nexodev.org/",
+      "favicon": "./public/www.nexodev.org/favicon.ico",
       "displayModuleHeader": true,
       "includeFilesListInHomepage": true,
       "sections": ["Namespaces", "Tutorials"],

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.1.2
+              image: underpost/underpost-engine:v3.1.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.1.2
+              image: underpost/underpost-engine:v3.1.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.1.2
+          image: localhost/rockylinux9-underpost:v3.1.3
           #          resources:
           #            requests:
           #              memory: "124Ki"
@@ -100,7 +100,7 @@ spec:
     spec:
       containers:
         - name: dd-default-development-green
-          image: localhost/rockylinux9-underpost:v3.1.2
+          image: localhost/rockylinux9-underpost:v3.1.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.1.2
+          image: localhost/rockylinux9-underpost:v3.1.3
 
           command:
             - /bin/sh
@@ -103,7 +103,7 @@ spec:
     spec:
       containers:
         - name: dd-test-development-green
-          image: localhost/rockylinux9-underpost:v3.1.2
+          image: localhost/rockylinux9-underpost:v3.1.3
 
           command:
             - /bin/sh

package/package.json

@@ -2,10 +2,10 @@
     "type": "module",
     "main": "src/index.js",
     "name": "underpost",
-    "version": "3.1.2",
+    "version": "3.1.3",
     "description": "pwa api rest template",
     "scripts": {
-        "start": "node --max-old-space-size=8192 src/server",
+        "start": "node --max-old-space-size=8192 src/server dd-core",
         "build": "node bin client",
         "test": "NODE_ENV=test c8 mocha",
         "dev": "NODE_ENV=development nodemon src/server",

package/scripts/ports-ls.sh

@@ -3,6 +3,8 @@ set -euo pipefail
 
 BASHRC="$HOME/.bashrc"
 
+sudo dnf install -y iproute lsof nmap-ncat net-tools procps-ng
+
 # Check whether a "ports" function is already defined
 if grep -Eq '^\s*(function\s+ports|ports\s*\(\))' "$BASHRC"; then
   echo "The 'ports' function already exists in $BASHRC. Nothing was changed."

package/src/cli/index.js

@@ -45,6 +45,9 @@ program
   .argument('[path]', 'Comma-separated paths to filter the build.', '')
   .option('--sync-env-port', 'Sync environment port assignments across all deploy IDs')
   .option('--single-replica', 'Build single replica folders instead of full client')
+  .option('--build-zip', 'Create zip files of the builds')
+  .option('--lite-build', 'Skip full build (default is full build)')
+  .option('--icons-build', 'Build icons')
   .description('Builds client assets, single replicas, and/or syncs environment ports.')
   .action(Underpost.repo.client);
 
@@ -58,6 +61,7 @@ program
   .option('--run', 'Starts application servers and monitors their health.')
   .option('--build', 'Triggers the client-side application build process.')
   .option('--underpost-quickly-install', 'Uses Underpost Quickly Install for dependency installation.')
+  .option('--skip-pull-base', 'Skips cloning repositories, uses current workspace code directly.')
   .action(Underpost.start.callback)
   .description('Initiates application servers, build pipelines, or other defined services based on the deployment ID.');
 
@@ -622,6 +626,10 @@ program
     'Sets the maximum number of status check attempts (default: 600).',
   )
   .option('--dry-run', 'Preview operations without executing them.')
+  .option(
+    '--from-n-commit <n>',
+    'Number of commits back to use for message propagation in template-deploy (default: 1, last commit only).',
+  )
   .option(
     '--create-job-now',
     'After applying cron manifests, immediately create a Job from each CronJob (forwarded to cron runner).',

package/src/cli/repository.js

@@ -144,8 +144,6 @@ class UnderpostRepository {
       }
 
       if (options.changelog !== undefined || options.changelogBuild) {
-        const ciIntegrationPrefix = 'ci(package-pwa-microservices-';
-        const ciIntegrationVersionPrefix = 'New release v:';
         const releaseMatch = 'New release v:';
         // Helper: parse [<tag>] commits into grouped sections
         const buildSectionChangelog = (commits) => {
@@ -273,39 +271,13 @@ class UnderpostRepository {
           fs.writeFileSync(changelogPath, `# Changelog\n\n${changelog}`);
           logger.info('CHANGELOG.md built at', changelogPath);
         } else {
-          // --changelog [latest-n]: print changelog of last N commits or since last release
+          // --changelog [latest-n]: print changelog of last N commits (default: 1)
           const hasExplicitCount =
             options.changelog !== undefined && options.changelog !== true && !isNaN(parseInt(options.changelog));
-          const scanLimit = hasExplicitCount ? parseInt(options.changelog) : 500;
+          const scanLimit = hasExplicitCount ? parseInt(options.changelog) : 1;
           const allCommits = fetchHistory(scanLimit);
 
-          let commits;
-          if (!hasExplicitCount) {
-            let boundaryIndex = -1;
-
-            // New boundary: deploy hash stored in config via `underpost config set LAST_CI_DEPLOY_HASH`
-            const lastDeployHash = shellExec('underpost config get LAST_CI_DEPLOY_HASH --plain', {
-              stdout: true,
-              silent: true,
-              disableLog: true,
-            }).trim();
-            if (lastDeployHash && lastDeployHash !== 'undefined' && lastDeployHash !== 'null') {
-              boundaryIndex = allCommits.findIndex((c) => c.fullHash === lastDeployHash || c.hash === lastDeployHash);
-            }
-
-            // Fallback: old CI integration commit boundary
-            if (boundaryIndex < 0) {
-              boundaryIndex = allCommits.findIndex(
-                (c) => c.message.startsWith(ciIntegrationPrefix) && !c.message.match(ciIntegrationVersionPrefix),
-              );
-            }
-
-            commits = boundaryIndex >= 0 ? allCommits.slice(0, boundaryIndex) : allCommits;
-          } else {
-            commits = allCommits;
-          }
-
-          const sections = buildVersionSections(commits);
+          const sections = buildVersionSections(allCommits);
           let changelog = renderSections(sections);
           console.log(changelog || `No changelog entries found.\n`);
         }
@@ -624,6 +596,9 @@ class UnderpostRepository {
      * @param {object} [options] - Build options.
      * @param {boolean} [options.syncEnvPort=false] - If true, syncs environment port assignments across all deploy IDs.
      * @param {boolean} [options.singleReplica=false] - If true, builds single replica folders instead of full client.
+     * @param {boolean} [options.buildZip=false] - If true, creates zip files of the builds.
+     * @param {boolean} [options.liteBuild=false] - If true, skips full build (default is full build).
+     * @param {boolean} [options.iconsBuild=false] - If true, builds icons.
      * @returns {Promise<boolean>} A promise that resolves when the build is complete.
      * @memberof UnderpostRepository
      */
@@ -635,6 +610,9 @@ class UnderpostRepository {
       options = {
         syncEnvPort: false,
         singleReplica: false,
+        buildZip: false,
+        liteBuild: false,
+        iconsBuild: false,
       },
     ) {
       return new Promise(async (resolve, reject) => {
@@ -784,8 +762,6 @@ class UnderpostRepository {
                 if (argHost.length && argPath.length && (!argHost.includes(host) || !argPath.includes(path))) {
                   delete serverConf[host][path];
                 } else {
-                  serverConf[host][path].liteBuild = false;
-                  serverConf[host][path].minifyBuild = process.env.NODE_ENV === 'production' ? true : false;
                   if (serverConf[host][path].singleReplica && serverConf[host][path].replicas) {
                     singleReplicaHosts.push({ host, path });
                     deployIdSingleReplicas = deployIdSingleReplicas.concat(
@@ -797,10 +773,11 @@ class UnderpostRepository {
                 }
               }
             }
-
-            if (confFilePath) fs.writeFileSync(confFilePath, JSON.stringify(serverConf, null, 4), 'utf-8');
-
-            await buildClient();
+            await buildClient({
+              buildZip: options.buildZip || false,
+              fullBuild: options.liteBuild ? false : true,
+              iconsBuild: options.iconsBuild || false,
+            });
             for (const replicaDeployId of deployIdSingleReplicas) await Underpost.repo.client(replicaDeployId);
 
             return resolve(true);
@@ -1207,6 +1184,29 @@ Prevent build private config repo.`,
       }
       logger.info('Dispatched workflow', `${repo} -> ${workflowFile}`, inputs.job ? `(job: ${inputs.job})` : '');
     },
+
+    /**
+     * Sanitizes a markdown changelog string into a compact message format.
+     * Strips date headers, converts section tags to `[tag]` prefixes, removes bullet markers and special characters.
+     * @param {string} message - The raw markdown changelog output.
+     * @returns {string} The sanitized single-line or multi-line compact message.
+     * @memberof UnderpostRepository
+     */
+    sanitizeChangelogMessage(message) {
+      if (!message) return '';
+      return message
+        .replace(/^##\s+\d{4}-\d{2}-\d{2}\s*/gm, '')
+        .replace(/^###\s+(\S+)\s*/gm, '[$1] ')
+        .replace(/^- /gm, '')
+        .replaceAll('"', '')
+        .replaceAll('`', '')
+        .split('\n')
+        .map((l) => l.trim())
+        .filter(Boolean)
+        .join('\n')
+        .trim()
+        .replaceAll('] - ', '] ');
+    },
   };
 }