@underpostnet/cyberia 3.3.0 → 3.3.73

package/src/grpc/cyberia/grpc-server.js

@@ -13,7 +13,7 @@ import * as grpc from '@grpc/grpc-js';
 import * as protoLoader from '@grpc/proto-loader';
 import path from 'path';
 import { fileURLToPath } from 'url';
-import { loggerFactory } from '../../server/logger.js';
+import { loggerFactory } from '../../server/ops/logger.js';
 import {
   buildFallbackConfig,
   buildFallbackInstanceConfig,

package/src/index.js

@@ -5,23 +5,28 @@
  */
 
 import UnderpostBaremetal from './cli/baremetal.js';
+import UnderpostApp from './cli/app.js';
+import UnderpostClient from './cli/client.js';
+import UnderpostHost from './cli/host.js';
 import UnderpostCloudInit from './cli/cloud-init.js';
 import UnderpostKickStart from './cli/kickstart.js';
 import UnderpostCluster from './cli/cluster.js';
 import UnderpostDB from './cli/db.js';
 import UnderpostDeploy from './cli/deploy.js';
 import UnderpostDockerCompose from './cli/docker-compose.js';
+import UnderpostEvent from './cli/event.js';
 import UnderpostKubectl from './cli/kubectl.js';
-import UnderpostRootEnv from './cli/env.js';
 import UnderpostFileStorage from './cli/fs.js';
 import UnderpostIPFS from './cli/ipfs.js';
 import UnderpostImage from './cli/image.js';
 import UnderpostLxd from './cli/lxd.js';
 import UnderpostMonitor from './cli/monitor.js';
+import UnderpostPackage from './cli/package.js';
 import UnderpostRepository from './cli/repository.js';
 import UnderpostRun from './cli/run.js';
 import UnderpostSecret from './cli/secrets.js';
 import UnderpostSSH from './cli/ssh.js';
+import UnderpostState from './cli/state.js';
 import UnderpostStatic from './cli/static.js';
 import UnderpostTest from './cli/test.js';
 import UnderpostRelease from './cli/release.js';
@@ -29,11 +34,11 @@ import UnderpostSystemProvisionig from './cli/system.js';
 import UnderpostVultr from './cli/vultr.js';
 import UnderpostWireguard from './cli/wireguard.js';
 
-import UnderpostDns from './server/dns.js';
-import UnderpostBackup from './server/backup.js';
-import UnderpostCron from './server/cron.js';
-import UnderpostStartUp from './server/start.js';
-import UnderpostTLS from './server/tls.js';
+import UnderpostDns from './server/network/dns.js';
+import UnderpostBackup from './server/storage/backup.js';
+import UnderpostCron from './server/ops/cron.js';
+import UnderpostStartUp from './server/runtime/start.js';
+import UnderpostTLS from './server/network/tls.js';
 
 /**
  * Underpost main module methods
@@ -47,7 +52,7 @@ class Underpost {
    * @type {String}
    * @memberof Underpost
    */
-  static version = 'v3.3.0';
+  static version = 'v3.3.73';
 
   /**
    * Required Node.js major version
@@ -67,24 +72,14 @@ class Underpost {
     return UnderpostRepository.API;
   }
   /**
-   * Root Env cli API
+   * Client build cli API
    * @static
-   * @type {UnderpostRootEnv.API}
+   * @type {UnderpostClient.API}
    * @memberof Underpost
    */
-  static get env() {
-    return UnderpostRootEnv.API;
+  static get client() {
+    return UnderpostClient.API;
   }
-  /**
-   * Test cli API
-   * @static
-   * @type {UnderpostTest.API}
-   * @memberof Underpost
-   */
-  static get test() {
-    return UnderpostTest.API;
-  }
-
   /**
    * Static cli API
    * @static
@@ -119,6 +114,33 @@ class Underpost {
    * @type {UnderpostSecret.API}
    * @memberof Underpost
    */
+  static get host() {
+    return UnderpostHost.API;
+  }
+  /**
+   * App deployment environment domain cli API
+   * @static
+   * @type {UnderpostApp.API}
+   * @memberof Underpost
+   */
+  static get app() {
+    return UnderpostApp.API;
+  }
+  /**
+   * Workload secret store domain cli API
+   * @static
+   * @type {UnderpostSecret.API}
+   * @memberof Underpost
+   */
+  static get state() {
+    return UnderpostState.API;
+  }
+  /**
+   * Workload secret store domain cli API
+   * @static
+   * @type {UnderpostSecret.API}
+   * @memberof Underpost
+   */
   static get secret() {
     return UnderpostSecret.API;
   }
@@ -185,6 +207,15 @@ class Underpost {
   static get monitor() {
     return UnderpostMonitor.API;
   }
+  /**
+   * Operational event dispatcher cli API
+   * @static
+   * @type {UnderpostEvent.API}
+   * @memberof Underpost
+   */
+  static get event() {
+    return UnderpostEvent.API;
+  }
   /**
    * SSH cli API
    * @static
@@ -333,6 +364,26 @@ class Underpost {
   static get release() {
     return UnderpostRelease.API;
   }
+
+  /**
+   * Test runner cli API
+   * @static
+   * @type {UnderpostTest.API}
+   * @memberof Underpost
+   */
+  static get test() {
+    return UnderpostTest.API;
+  }
+
+  /**
+   * Deploy package manifest cli API
+   * @static
+   * @type {UnderpostPackage.API}
+   * @memberof Underpost
+   */
+  static get package() {
+    return UnderpostPackage.API;
+  }
 }
 
 if (!process.version || !process.version.startsWith(`${Underpost.majorNodejsVersion}.`))
@@ -354,20 +405,25 @@ export {
   UnderpostDB,
   UnderpostDeploy,
   UnderpostDockerCompose,
+  UnderpostEvent,
   UnderpostKubectl,
-  UnderpostRootEnv,
   UnderpostFileStorage,
   UnderpostImage,
   UnderpostStatic,
+  UnderpostTest,
   UnderpostLxd,
   UnderpostKickStart,
   UnderpostIPFS,
   UnderpostMonitor,
+  UnderpostPackage,
+  UnderpostApp,
+  UnderpostClient,
+  UnderpostHost,
   UnderpostRepository,
   UnderpostRun,
   UnderpostSecret,
   UnderpostSSH,
-  UnderpostTest,
+  UnderpostState,
   UnderpostDns,
   UnderpostBackup,
   UnderpostCron,

package/src/mailer/EmailRender.js

@@ -98,8 +98,8 @@ class EmailRenderService {
     for (const templateKey of Object.keys(options.templates)) {
       const ssrEmailComponent = options.templates[templateKey];
       // Note: ssrFactory is assumed to load and return a functional component/function
-      const SrrComponent = await ssrFactory(`./src/client/ssr/mailer/${ssrEmailComponent}.js`);
-      templates[templateKey] = SrrComponent(this, options);
+      const SSRComponent = await ssrFactory(`./src/client/ssr/mailer/${ssrEmailComponent}.js`);
+      templates[templateKey] = SSRComponent(this, options);
     }
     return templates;
   }

package/src/mailer/MailerInterceptor.js

@@ -0,0 +1,87 @@
+import { MailerProvider } from './MailerProvider.js';
+
+/**
+ * General-purpose capture of everything {@link MailerProviderService#send}
+ * delivers, built on the provider's send middleware.
+ *
+ * Assertions about mail are otherwise only possible against a real inbox. The
+ * interceptor records the delivery context and the transport result of each
+ * send, which is what lets a caller wait for a specific message and know
+ * whether the transport actually accepted it.
+ *
+ * @module src/mailer/MailerInterceptor.js
+ * @namespace MailerInterceptor
+ */
+
+/**
+ * @typedef {object} InterceptedMail
+ * @property {string} id - Mailer instance the message was sent through.
+ * @property {object} sendOptions - Nodemailer options as the transport received them.
+ * @property {object|undefined} info - Transport result; `undefined` when delivery failed.
+ * @property {boolean} accepted - Whether the transport accepted the message.
+ * @property {string} at - ISO timestamp of the delivery attempt.
+ * @memberof MailerInterceptor
+ */
+
+/**
+ * @method mailerInterceptorFactory
+ * @description Installs a send interceptor and returns its recorder.
+ *
+ * The interceptor is transparent: it forwards every send to the transport and
+ * records the outcome. `suppress` holds the message instead, for callers that
+ * must exercise the send path without delivering.
+ *
+ * @param {object} [params]
+ * @param {import('./MailerProvider.js').MailerProvider} [params.provider] - Provider to intercept.
+ * @param {function(object): boolean} [params.filter] - Records only the contexts it accepts.
+ * @param {boolean} [params.suppress=false] - Record without handing the message to the transport.
+ * @returns {{messages: Array<InterceptedMail>, waitFor: function, close: function(): void}} Recorder.
+ * @memberof MailerInterceptor
+ */
+const mailerInterceptorFactory = ({ provider = MailerProvider, filter, suppress = false } = {}) => {
+  const messages = [];
+
+  const dispose = provider.use(async (context, next) => {
+    const matched = !filter || filter(context);
+    const info = matched && suppress ? { messageId: `suppressed:${Date.now()}`, suppressed: true } : await next();
+    if (matched)
+      messages.push({
+        id: context.id,
+        sendOptions: context.sendOptions,
+        info,
+        accepted: Boolean(info),
+        at: new Date().toISOString(),
+      });
+    return info;
+  });
+
+  return {
+    messages,
+
+    /**
+     * Resolves with the first recorded message matching `predicate`.
+     *
+     * Polls rather than resolving on registration, because a send started
+     * before the caller began waiting must still satisfy the wait.
+     *
+     * @param {function(InterceptedMail): boolean} predicate - Match to wait for.
+     * @param {object} [options]
+     * @param {number} [options.timeoutMs=60000] - Maximum wait.
+     * @param {number} [options.intervalMs=250] - Poll interval.
+     * @returns {Promise<InterceptedMail|undefined>} The match, or `undefined` on timeout.
+     */
+    async waitFor(predicate, { timeoutMs = 60000, intervalMs = 250 } = {}) {
+      const deadline = Date.now() + timeoutMs;
+      do {
+        const match = messages.find(predicate);
+        if (match) return match;
+        await new Promise((resolve) => setTimeout(resolve, intervalMs));
+      } while (Date.now() < deadline);
+      return messages.find(predicate);
+    },
+
+    close: dispose,
+  };
+};
+
+export { mailerInterceptorFactory };

package/src/mailer/MailerProvider.js

@@ -1,5 +1,5 @@
 import nodemailer from 'nodemailer';
-import { loggerFactory } from '../server/logger.js';
+import { loggerFactory } from '../server/ops/logger.js';
 import { EmailRender } from './EmailRender.js';
 
 /**
@@ -45,6 +45,12 @@ class MailerProviderService {
    */
   #instance = {};
 
+  /**
+   * Registered send middlewares, in the order they wrap a delivery.
+   * @type {Array<function(object, function(): Promise<object|undefined>): Promise<object|undefined>>}
+   */
+  #middlewares = [];
+
   /**
    * Retrieves the internal instance storage for direct access (used for backward compatibility).
    * @returns {object.<string, object>} The internal mailer instance map.
@@ -53,6 +59,28 @@ class MailerProviderService {
     return this.#instance;
   }
 
+  /**
+   * Registers a send middleware.
+   *
+   * Middlewares wrap every {@link MailerProviderService#send}, in registration
+   * order, and receive the delivery context plus the `next` continuation that
+   * yields the transport result. A middleware that never calls `next` suppresses
+   * the delivery, which is what makes this usable both for cross-cutting
+   * concerns (auditing, rate limiting) and for capturing mail in a test run.
+   *
+   * @param {function(object, function(): Promise<object|undefined>): Promise<object|undefined>} middleware -
+   * Receives `({ id, sendOptions, sender }, next)`.
+   * @returns {function(): void} Disposer that unregisters the middleware.
+   */
+  use(middleware) {
+    if (typeof middleware !== 'function') throw new Error('[mailer] a send middleware must be a function');
+    this.#middlewares.push(middleware);
+    return () => {
+      const index = this.#middlewares.indexOf(middleware);
+      if (index !== -1) this.#middlewares.splice(index, 1);
+    };
+  }
+
   /**
    * Loads and initializes a new mailer provider instance using Nodemailer.
    * The created instance is stored internally and includes the transporter and rendered templates.
@@ -145,6 +173,24 @@ class MailerProviderService {
     }
   }
 
+  /**
+   * Closes a loaded instance's transport and forgets it.
+   *
+   * A transport holds an open socket, which keeps a one-shot process alive long
+   * after its work is done. Callers that load an instance for a single delivery
+   * release it here; a long-running server keeps its instances loaded instead.
+   *
+   * @param {string} id - Mailer instance id.
+   * @returns {boolean} True when an instance was closed.
+   */
+  close(id) {
+    const instance = this.#instance[id];
+    if (!instance) return false;
+    if (typeof instance.transporter?.close === 'function') instance.transporter.close();
+    delete this.#instance[id];
+    return true;
+  }
+
   /**
    * Sends an email using a previously loaded transporter instance.
    *
@@ -189,12 +235,10 @@ class MailerProviderService {
 
       if (!sendOptions.from) sendOptions.from = `${instance.sender.name} <${instance.sender.email}>`;
 
-      // send mail with defined transport object
-      const info = await instance.transporter.sendMail(sendOptions);
-
-      // logger.info('Message sent', info);
+      const context = { id, sendOptions, sender: instance.sender };
+      const deliver = () => instance.transporter.sendMail(sendOptions);
 
-      return info;
+      return await this.#middlewares.reduceRight((next, middleware) => () => middleware(context, next), deliver)();
     } catch (error) {
       logger.error(error, error.stack);
       return undefined;

package/src/projects/cyberia/atlas-sprite-sheet-generator.js

@@ -9,7 +9,7 @@ import fs from 'fs-extra';
 import path from 'path';
 import sharp from 'sharp';
 import { Jimp, rgbaToInt } from 'jimp';
-import { loggerFactory } from '../../server/logger.js';
+import { loggerFactory } from '../../server/ops/logger.js';
 
 const logger = loggerFactory(import.meta);
 

package/src/projects/cyberia/besu-genesis-generator.js

@@ -17,9 +17,9 @@ import crypto from 'crypto';
 import fs from 'fs-extra';
 import path from 'path';
 import { keccak256 as ethersKeccak256 } from 'ethers';
-import { loggerFactory } from '../../server/logger.js';
-import { shellExec } from '../../server/process.js';
-import { crictlCommandFactory } from '../../server/cri.js';
+import { loggerFactory } from '../../server/ops/logger.js';
+import { shellExec } from '../../server/runtime/process.js';
+import { crictlCommandFactory } from '../../server/ops/cri.js';
 
 const logger = loggerFactory(import.meta);
 

package/src/projects/cyberia/catalog-cyberia.js

@@ -2,7 +2,7 @@
  * Cyberia CLI content catalog.
  *
  * A per-deploy product catalog: pure data, loaded dynamically by deploy id via
- * {@link module:src/server/catalog} so the base build and template assembly never
+ * {@link module:src/server/build/catalog.js} so the base build and template assembly never
  * statically depend on it. Exports the uniform product-catalog shape:
  *
  *   - `sourceMoves`       — public `[src, dest]` pairs moved into the engine tree before a build.
@@ -13,12 +13,51 @@
  *   - `copies`            — `[src, dest]` pairs copied into the template during assembly (like moves but copied instead of moved).
  *   - `keywords`          — npm keywords for the standalone product CLI package.
  *   - `description`       — npm description for the standalone product CLI package.
+ *   - `packageName`       — npm name of the product package; the deploy id without `dd-` otherwise.
+ *   - `packageBin`        — bin map of the standalone product CLI.
+ *   - `packageDependencies` — runtime dependencies this product adds to the engine's.
+ *   - `packageScripts`    — npm scripts this product adds to the engine's.
+ *
+ * The `package*` fields are the single declaration of what this product's manifests carry:
+ * every generated manifest — the deploy's `engine-private/conf/<id>/package.json`, the product
+ * repository's, and the published instance copy — is built from them by
+ * {@link module:src/server/build/package.js}. Nothing else may name them.
  *
  * @module src/projects/cyberia/catalog-cyberia.js
  * @namespace CyberiaCatalog
  */
 
+const DEPLOY_ID = 'dd-cyberia';
+const DOCKER_COMPOSE_ID = 'cyberia';
+
+const dockerScript = (action, flags = '') =>
+  `node bin docker-compose --${action}${flags} --deploy-id ${DEPLOY_ID} --docker-compose-id ${DOCKER_COMPOSE_ID}`;
+
 export default {
+  packageName: 'cyberia',
+  // Pod bootstraps link this product checkout over the image CLI before continuing.
+  packageBin: { cyberia: 'bin/index.js', underpost: 'bin/index.js' },
+  // Native-dependency pin list: versions stay reproducible across CI and production deploys.
+  packageDependencies: {
+    'adm-zip': '^0.6.0',
+    'maxrects-packer': '^2.7.3',
+    pngjs: '^7.0.0',
+    jimp: '^1.6.0',
+    sharp: '^0.35.3',
+    ethers: '~6.16.0',
+  },
+  packageScripts: {
+    'docker:generate': dockerScript('generate'),
+    'docker:up': dockerScript('up'),
+    'docker:up:build': dockerScript('up', ' --build'),
+    'docker:down': dockerScript('down'),
+    'docker:down:volumes': dockerScript('down', ' --volumes'),
+    'docker:restart': dockerScript('restart'),
+    'docker:pull': dockerScript('pull'),
+    'docker:logs': dockerScript('logs'),
+    'docker:status': dockerScript('status'),
+    'docker:reset': dockerScript('reset'),
+  },
   sourceMoves: [],
   privateConfPaths: [
     /** INSTANCE_CODES */
@@ -26,6 +65,7 @@ export default {
     'cyberia-instances/amethyst-strata-expansion',
     'cyberia-sagas/amethyst-strata-expansion.json',
     'cyberia-instances/FOREST',
+    'cyberia-instances/TEST',
 
     /** INSTANCE_CODES */
   ],
@@ -33,8 +73,7 @@ export default {
     '/src/grpc/cyberia',
     '/src/client/ssr/views/CyberiaServerMetrics.js',
     '/src/client/ssr/views/Cyberia404.js',
-    '/test/cyberia-instance-conf-defaults.test.js',
-    '/test/shape-generator.test.js',
+    '/test/integration/app/cyberia',
     '/src/projects/cyberia',
     '/src/runtime/cyberia-server',
     '/src/runtime/cyberia-client',
@@ -49,7 +88,13 @@ export default {
     '/.github/workflows/cyberia-client.cd.yml',
     '/.github/workflows/cyberia-server.cd.yml',
     '/.github/workflows/coverall.cyberia.ci.yml',
-    '/scripts/coverall-test-cyberia.sh',
+    '/bin/cyberia.js',
+    '/hardhat',
+    // The deploy scripts `run-workflow build-manifest` mirrors into each generated instance
+    // repository. The base template drops the whole `deploy/` tree, so the product CLI only has
+    // them if it packages them here.
+    '/deploy/cyberia-client',
+    '/deploy/cyberia-server',
   ],
   stripPaths: [
     './src/projects/cyberia',
@@ -57,14 +102,12 @@ export default {
     './src/runtime/cyberia-server',
     './src/runtime/cyberia-client',
     './src/runtime/engine-cyberia',
-    './test/cyberia-instance-conf-defaults.test.js',
-    './test/cyberia-load.test.js',
-    './test/object-layer-item-id.test.js',
-    './test/shape-generator.test.js',
+    './test/integration/app/cyberia',
     './src/client/public/cyberia-docs',
-    './scripts/coverall-test-cyberia.sh',
-    'bin/cyberia.js',
+    './bin/cyberia.js',
     './hardhat',
+    './deploy/cyberia-client',
+    './deploy/cyberia-server',
   ],
   moves: [],
   copies: [

package/src/projects/cyberia/gemini-client.js

@@ -14,7 +14,7 @@
  */
 
 import axios from 'axios';
-import { loggerFactory } from '../../server/logger.js';
+import { loggerFactory } from '../../server/ops/logger.js';
 
 const logger = loggerFactory(import.meta);
 

package/src/projects/cyberia/generate-saga.js

@@ -18,7 +18,7 @@ import fs from 'fs-extra';
 import nodePath from 'path';
 import crypto from 'crypto';
 import { GeminiClient } from './gemini-client.js';
-import { loggerFactory } from '../../server/logger.js';
+import { loggerFactory } from '../../server/ops/logger.js';
 
 const logger = loggerFactory(import.meta);
 

package/src/projects/cyberia/hot-reload-trigger.js

@@ -24,7 +24,7 @@
  */
 
 import * as grpc from '@grpc/grpc-js';
-import { loggerFactory } from '../../server/logger.js';
+import { loggerFactory } from '../../server/ops/logger.js';
 
 const logger = loggerFactory(import.meta);
 

package/src/projects/cyberia/instance-data.js

@@ -16,7 +16,7 @@
 
 import crypto from 'crypto';
 import { DataBaseProviderService } from '../../db/DataBaseProvider.js';
-import { loggerFactory } from '../../server/logger.js';
+import { loggerFactory } from '../../server/ops/logger.js';
 import {
   CYBERIA_INSTANCE_CONF_DEFAULTS as FALLBACK_CONFIG_DEFAULTS,
   DEFAULT_DEAD_ITEM_ID,

package/src/projects/cyberia/ipfs-client.js

@@ -11,7 +11,7 @@
  * @namespace IpfsClient
  */
 import stringify from 'fast-json-stable-stringify';
-import { loggerFactory } from '../../server/logger.js';
+import { loggerFactory } from '../../server/ops/logger.js';
 import Underpost from '../../index.js';
 const logger = loggerFactory(import.meta);
 const DEFAULT_IPFS_HTTP_TIMEOUT_MS = Number(process.env.IPFS_HTTP_TIMEOUT_MS || 10000);
@@ -48,21 +48,21 @@ const fetchWithTimeout = async (url, options = {}, { kind = 'kubo', label = url
  */
 const getIpfsApiUrl = () =>
   process.env.IPFS_API_URL ||
-  `http://${process.env.NODE_ENV === 'development' && !Underpost.env.isInsideContainer() ? 'localhost' : 'ipfs-cluster'}:5001`;
+  `http://${process.env.NODE_ENV === 'development' && !Underpost.state.isInsideContainer() ? 'localhost' : 'ipfs-cluster'}:5001`;
 /**
  * Base URL of the IPFS Cluster REST API (port 9094).
  * @returns {string}
  */
 const getClusterApiUrl = () =>
   process.env.IPFS_CLUSTER_API_URL ||
-  `http://${process.env.NODE_ENV === 'development' && !Underpost.env.isInsideContainer() ? 'localhost' : 'ipfs-cluster'}:9094`;
+  `http://${process.env.NODE_ENV === 'development' && !Underpost.state.isInsideContainer() ? 'localhost' : 'ipfs-cluster'}:9094`;
 /**
  * Base URL of the IPFS HTTP Gateway (port 8080).
  * @returns {string}
  */
 const getGatewayUrl = () =>
   process.env.IPFS_GATEWAY_URL ||
-  `http://${process.env.NODE_ENV === 'development' && !Underpost.env.isInsideContainer() ? 'localhost' : 'ipfs-cluster'}:8080`;
+  `http://${process.env.NODE_ENV === 'development' && !Underpost.state.isInsideContainer() ? 'localhost' : 'ipfs-cluster'}:8080`;
 // ─────────────────────────────────────────────────────────
 //  Core: add content
 // ─────────────────────────────────────────────────────────

package/src/projects/cyberia/map-preview-generator.js

@@ -21,7 +21,7 @@
 import crypto from 'crypto';
 import fs from 'fs-extra';
 import sharp from 'sharp';
-import { loggerFactory } from '../../server/logger.js';
+import { loggerFactory } from '../../server/ops/logger.js';
 import {
   ENTITY_TYPE_TO_ITEM_TYPES,
   getDefaultCyberiaItemById,

package/src/projects/cyberia/object-layer.js

@@ -17,7 +17,7 @@ import {
   getKeyframeDirectionsByCode,
   OBJECT_LAYER_DIRECTION_NAME_TO_CODE,
 } from '../../client/components/cyberia/SharedDefaultsCyberia.js';
-import { loggerFactory } from '../../server/logger.js';
+import { loggerFactory } from '../../server/ops/logger.js';
 
 const logger = loggerFactory(import.meta);
 

package/src/projects/cyberia/semantic-layer-generator.js

@@ -19,7 +19,7 @@
 import crypto from 'crypto';
 
 import { createRng, seedToInt, createNoise2D, generateShape, listShapes } from './shape-generator.js';
-import { loggerFactory } from '../../server/logger.js';
+import { loggerFactory } from '../../server/ops/logger.js';
 
 import { registerFloorSemantics } from './semantic-layer-generator-floor.js';
 import { registerSkinSemantics } from './semantic-layer-generator-skin.js';

package/src/projects/underpost/catalog-underpost.js

@@ -28,6 +28,14 @@ const TEMPLATE_RESTORE_PATHS = [
   './manifests/deployment/dd-default-development',
 ];
 
+/**
+ * Template checkout entries a rebuild keeps. Everything else is reconstructed from
+ * the engine tree, so a file the engine no longer produces cannot survive a build.
+ * @constant {string[]}
+ * @memberof UnderpostCatalog
+ */
+const TEMPLATE_PRESERVED_ENTRIES = ['.git', 'node_modules'];
+
 /**
  * npm keywords for the standalone Underpost platform / template package.
  * @constant {string[]}
@@ -60,4 +68,4 @@ const TEMPLATE_KEYWORDS = [
 const TEMPLATE_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.';
 
-export { TEMPLATE_RESTORE_PATHS, TEMPLATE_KEYWORDS, TEMPLATE_DESCRIPTION };
+export { TEMPLATE_RESTORE_PATHS, TEMPLATE_PRESERVED_ENTRIES, TEMPLATE_KEYWORDS, TEMPLATE_DESCRIPTION };

package/src/proxy.js

@@ -1,12 +1,9 @@
 'use strict';
 
-// https://nodejs.org/api
-// https://expressjs.com/en/4x/api.html
-
-import { loggerFactory } from './server/logger.js';
-import { buildProxy } from './server/proxy.js';
-import { ProcessController } from './server/process.js';
-import { Config } from './server/conf.js';
+import { loggerFactory } from './server/ops/logger.js';
+import { buildProxy } from './server/network/proxy.js';
+import { ProcessController } from './server/runtime/process.js';
+import { Config } from './server/runtime/conf.js';
 
 await Config.build(process.argv[2], process.argv[3], process.argv[4]);