cyberia 3.0.1 → 3.0.2

package/bin/cyberia.js

@@ -1,28 +1,52 @@
 #! /usr/bin/env node
 
+/**
+ * Cyberia Online CLI for object layer management.
+ * Provides commands for importing, viewing, and managing object layer assets,
+ * render frames, and atlas sprite sheets from the command line.
+ *
+ * Delegates shared object layer creation logic to {@link ObjectLayerEngine} in
+ * `src/server/object-layer.js` to keep a single source of truth shared with
+ * the REST API service layer.
+ *
+ * @module bin/cyberia.js
+ * @namespace CyberiaCLI
+ */
+
 import dotenv from 'dotenv';
 import { Command } from 'commander';
 import fs from 'fs-extra';
-import { shellExec, shellCd } from '../src/server/process.js';
+import { shellExec } from '../src/server/process.js';
 import { loggerFactory } from '../src/server/logger.js';
 import { DataBaseProvider } from '../src/db/DataBaseProvider.js';
 import {
+  ObjectLayerEngine,
   pngDirectoryIteratorByObjectLayerType,
   getKeyFramesDirectionsFromNumberFolderDirection,
-  processAndPushFrame,
   buildImgFromTile,
-  generateRandomStats,
   itemTypes,
 } from '../src/server/object-layer.js';
 import { AtlasSpriteSheetGenerator } from '../src/server/atlas-sprite-sheet-generator.js';
+import {
+  generateFrame,
+  generateMultiFrame,
+  lookupSemantic,
+  semanticRegistry,
+} from '../src/server/semantic-layer-generator.js';
+import { IpfsClient } from '../src/server/ipfs-client.js';
+import { createPinRecord } from '../src/api/ipfs/ipfs.service.js';
 import { program as underpostProgram } from '../src/cli/index.js';
 import crypto from 'crypto';
-import stringify from 'fast-json-stable-stringify';
+import nodePath from 'path';
 import Underpost from '../src/index.js';
+
+/** @type {Function} */
 const logger = loggerFactory(import.meta);
+
 try {
   const program = new Command();
 
+  /** @type {string} */
   const version = Underpost.version;
 
   program
@@ -42,11 +66,40 @@ try {
     .option('--show-atlas-sprite-sheet', 'Show consolidated atlas sprite sheet PNG for given item-id')
     .option('--import [object-layer-type]', 'Commas separated object layer types e.g. skin,floors')
     .option('--show-frame [direction-frame]', 'View object layer frame for given item-id e.g. 08_0 (default: 08_0)')
+    .option('--generate', 'Generate procedural object layers from semantic item-id (e.g. floor-desert)')
+    .option('--count <count>', 'Shape element count multiplier for --generate (default: 3)', parseFloat)
+    .option('--seed <seed>', 'Deterministic seed string for --generate (e.g. fx-42)')
+    .option('--frame-index <frameIndex>', 'Starting frame index for --generate (default: 0)', parseInt)
+    .option('--frame-count <frameCount>', 'Number of frames to generate for --generate (default: 1)', parseInt)
+    .option('--density <density>', 'Density factor 0..1 for --generate (default: 0.5)', parseFloat)
     .option('--env-path <env-path>', 'Env path e.g. ./engine-private/conf/dd-cyberia/.env.development')
     .option('--mongo-host <mongo-host>', 'Mongo host override')
     .option('--storage-file-path <storage-file-path>', 'Storage file path override')
     .option('--drop', 'Drop existing data before importing')
     .action(
+      /**
+       * Main action handler for the `ol` command.
+       * Manages object layer import, frame viewing, atlas generation, and atlas display.
+       *
+       * @param {string|undefined} itemId - Optional item ID argument.
+       * @param {Object} options - Command options parsed by Commander.
+       * @param {boolean|string} options.import - Object layer types to import (e.g., 'all', 'skin,floor') or `false`.
+       * @param {boolean|string} options.showFrame - Direction-frame string (e.g., '08_0') or `true` for default.
+       * @param {string} options.envPath - Path to the `.env` file.
+       * @param {string} options.mongoHost - MongoDB host override.
+       * @param {string} options.storageFilePath - Path to a storage filter JSON file.
+       * @param {boolean|string} options.toAtlasSpriteSheet - Atlas dimension or `true` for auto-calc.
+       * @param {boolean} options.showAtlasSpriteSheet - Whether to display the atlas sprite sheet.
+       * @param {boolean} options.drop - Whether to drop existing data before importing.
+       * @param {boolean} options.generate - Whether to run procedural generation for the item-id.
+       * @param {number} options.count - Shape element count multiplier for generation.
+       * @param {string} options.seed - Deterministic seed string for generation.
+       * @param {number} options.frameIndex - Starting frame index for generation.
+       * @param {number} options.frameCount - Number of frames to generate.
+       * @param {number} options.density - Density factor 0..1 for generation.
+       * @returns {Promise<void>}
+       * @memberof CyberiaCLI
+       */
       async (
         itemId,
         options = {
@@ -57,13 +110,22 @@ try {
           storageFilePath: '',
           toAtlasSpriteSheet: '',
           showAtlasSpriteSheet: false,
+          generate: false,
+          count: 3,
+          seed: '',
+          frameIndex: 0,
+          frameCount: 1,
+          density: 0.5,
         },
       ) => {
         if (!options.envPath) options.envPath = `./.env`;
         if (fs.existsSync(options.envPath)) dotenv.config({ path: options.envPath, override: true });
 
+        /** @type {string} */
         const deployId = process.env.DEFAULT_DEPLOY_ID;
+        /** @type {string} */
         const host = process.env.DEFAULT_DEPLOY_HOST;
+        /** @type {string} */
         const path = process.env.DEFAULT_DEPLOY_PATH;
 
         const confServerPath = `./engine-private/conf/${deployId}/conf.server.json`;
@@ -81,16 +143,20 @@ try {
         });
 
         await DataBaseProvider.load({
-          apis: ['object-layer', 'object-layer-render-frames', 'atlas-sprite-sheet', 'file'],
+          apis: ['object-layer', 'object-layer-render-frames', 'atlas-sprite-sheet', 'file', 'ipfs'],
           host,
           path,
           db,
         });
 
+        /** @type {import('mongoose').Model} */
         const ObjectLayer = DataBaseProvider.instance[`${host}${path}`].mongoose.models.ObjectLayer;
+        /** @type {import('mongoose').Model} */
         const ObjectLayerRenderFrames =
           DataBaseProvider.instance[`${host}${path}`].mongoose.models.ObjectLayerRenderFrames;
+        /** @type {import('mongoose').Model} */
         const AtlasSpriteSheet = DataBaseProvider.instance[`${host}${path}`].mongoose.models.AtlasSpriteSheet;
+        /** @type {import('mongoose').Model} */
         const File = DataBaseProvider.instance[`${host}${path}`].mongoose.models.File;
 
         if (options.drop) {
@@ -99,90 +165,140 @@ try {
           shellExec(`cd src/client/public/cyberia && underpost run clean .`);
         }
 
+        /** @type {Object|null} */
         const storage = options.storageFilePath ? JSON.parse(fs.readFileSync(options.storageFilePath, 'utf8')) : null;
 
-        const objectLayers = {};
-
+        // ── Handle --import ──────────────────────────────────────────────
         if (options.import) {
-          const argItemTypes = options.import === 'all' ? Object.keys(itemTypes) : options.import.split(',');
+          /** @type {boolean} */
+          const isImportAll = options.import === 'all';
+
+          /** @type {string[]} */
+          const argItemTypes = isImportAll ? Object.keys(itemTypes) : options.import.split(',');
+
+          /**
+           * Accumulated object layer data keyed by objectLayerId.
+           * @type {Object<string, import('../src/server/object-layer.js').ObjectLayerData>}
+           */
+          const objectLayers = {};
+
           for (const argItemType of argItemTypes) {
             await pngDirectoryIteratorByObjectLayerType(
               argItemType,
-              async ({ path, objectLayerType, objectLayerId, direction, frame }) => {
+              async ({ path: framePath, objectLayerType, objectLayerId, direction, frame }) => {
                 if (
                   storage &&
                   !storage[`src/client/public/cyberia/assets/${objectLayerType}/${objectLayerId}/08/0.png`]
                 )
                   return;
-                console.log(path, { objectLayerType, objectLayerId, direction, frame });
+
+                console.log(framePath, { objectLayerType, objectLayerId, direction, frame });
+
+                // On first encounter of an objectLayerId, build its data from the asset directory
                 if (!objectLayers[objectLayerId]) {
-                  const metadataPath = `./src/client/public/cyberia/assets/${objectLayerType}/${objectLayerId}/metadata.json`;
-                  const metadata = fs.existsSync(metadataPath)
-                    ? JSON.parse(fs.readFileSync(metadataPath, 'utf8'))
-                    : null;
-
-                  if (metadata) {
-                    // Use metadata from file but ensure objectLayerRenderFramesData is initialized
-                    objectLayers[objectLayerId] = metadata;
-
-                    // Ensure data.seed exists (required field)
-                    if (!objectLayers[objectLayerId].data.seed) {
-                      objectLayers[objectLayerId].data.seed = crypto.randomUUID();
-                    }
-
-                    // Ensure objectLayerRenderFramesData exists
-                    if (!objectLayers[objectLayerId].objectLayerRenderFramesData) {
-                      objectLayers[objectLayerId].objectLayerRenderFramesData = {
-                        frames: {},
-                        colors: [],
-                        frame_duration: metadata.data?.render?.frame_duration || 250,
-                        is_stateless: metadata.data?.render?.is_stateless || false,
-                      };
-                    }
-                  } else {
-                    // Create default structure
-                    objectLayers[objectLayerId] = {
-                      data: {
-                        item: {
-                          id: objectLayerId,
-                          type: objectLayerType,
-                          description: '',
-                          activable: true,
-                        },
-                        stats: generateRandomStats(),
-                        seed: crypto.randomUUID(),
-                      },
-                      objectLayerRenderFramesData: {
-                        frames: {},
-                        colors: [],
-                        frame_duration: 250,
-                        is_stateless: false,
-                      },
-                    };
-                  }
+                  const folder = `./src/client/public/cyberia/assets/${objectLayerType}/${objectLayerId}`;
+                  const { objectLayerRenderFramesData, objectLayerData } =
+                    await ObjectLayerEngine.buildObjectLayerDataFromDirectory({
+                      folder,
+                      objectLayerType,
+                      objectLayerId,
+                    });
+
+                  objectLayers[objectLayerId] = {
+                    ...objectLayerData,
+                    objectLayerRenderFramesData,
+                    _processed: true,
+                  };
                 }
-                await processAndPushFrame(objectLayers[objectLayerId].objectLayerRenderFramesData, path, direction);
               },
             );
           }
-          for (const objectLayerId of Object.keys(objectLayers)) {
-            // Create ObjectLayerRenderFrames document
-            const objectLayerRenderFramesDoc = await new ObjectLayerRenderFrames(
-              objectLayers[objectLayerId].objectLayerRenderFramesData,
-            ).save();
 
-            // Update ObjectLayer with reference to render frames (top-level, not in data)
-            objectLayers[objectLayerId].objectLayerRenderFramesId = objectLayerRenderFramesDoc._id;
-
-            // Generate SHA256 hash using fast-json-stable-stringify (seed is part of data)
-            objectLayers[objectLayerId].sha256 = crypto
-              .createHash('sha256')
-              .update(stringify(objectLayers[objectLayerId].data))
-              .digest('hex');
+          for (const objectLayerId of Object.keys(objectLayers)) {
+            const entry = objectLayers[objectLayerId];
+
+            // Skip atlas generation when importing all object layers at once (bulk import).
+            // Individual imports or explicit --to-atlas-sprite-sheet calls will still generate atlases.
+            const shouldGenerateAtlas = !isImportAll;
+
+            if (shouldGenerateAtlas) {
+              // Use the centralized createObjectLayerDocuments which handles atlas generation
+              // Since we're in CLI context without a full Express req/res, we build a minimal
+              // atlas generation flow using AtlasSpriteSheetGenerator directly after creation.
+              const { objectLayer } = await ObjectLayerEngine.createObjectLayerDocuments({
+                ObjectLayer,
+                ObjectLayerRenderFrames,
+                objectLayerRenderFramesData: entry.objectLayerRenderFramesData,
+                objectLayerData: { data: entry.data },
+                createOptions: {
+                  generateAtlas: false,
+                },
+              });
+
+              // Generate atlas sprite sheet for individual imports
+              try {
+                const itemKey = objectLayer.data.item.id;
+                const populatedObjectLayer = await ObjectLayer.findById(objectLayer._id).populate(
+                  'objectLayerRenderFramesId',
+                );
+
+                const { buffer, metadata } = await AtlasSpriteSheetGenerator.generateAtlas(
+                  populatedObjectLayer.objectLayerRenderFramesId,
+                  itemKey,
+                  20,
+                );
+
+                const fileDoc = await new File({
+                  name: `${itemKey}-atlas.png`,
+                  data: buffer,
+                  size: buffer.length,
+                  mimetype: 'image/png',
+                  md5: crypto.createHash('md5').update(buffer).digest('hex'),
+                }).save();
+
+                let atlasDoc = await AtlasSpriteSheet.findOne({ 'metadata.itemKey': itemKey });
+
+                if (atlasDoc) {
+                  atlasDoc.fileId = fileDoc._id;
+                  atlasDoc.metadata = metadata;
+                  await atlasDoc.save();
+                  logger.info(`Updated existing AtlasSpriteSheet document: ${atlasDoc._id}`);
+                } else {
+                  atlasDoc = await new AtlasSpriteSheet({
+                    fileId: fileDoc._id,
+                    metadata,
+                  }).save();
+                  logger.info(`Created new AtlasSpriteSheet document: ${atlasDoc._id}`);
+                }
 
-            console.log(await ObjectLayer.create(objectLayers[objectLayerId]));
+                populatedObjectLayer.atlasSpriteSheetId = atlasDoc._id;
+                await populatedObjectLayer.save();
+
+                logger.info(`Atlas sprite sheet completed for item: ${itemKey}`);
+              } catch (atlasError) {
+                logger.error(`Failed to generate atlas for ${objectLayerId}:`, atlasError);
+              }
+
+              console.log(objectLayer);
+            } else {
+              // --import all: create documents without atlas generation
+              const { objectLayer } = await ObjectLayerEngine.createObjectLayerDocuments({
+                ObjectLayer,
+                ObjectLayerRenderFrames,
+                objectLayerRenderFramesData: entry.objectLayerRenderFramesData,
+                objectLayerData: { data: entry.data },
+                createOptions: {
+                  generateAtlas: false,
+                },
+              });
+
+              logger.info(`ObjectLayer created (atlas skipped for bulk import): ${objectLayerId}`);
+              console.log(objectLayer);
+            }
           }
         }
+
+        // ── Handle --show-frame ──────────────────────────────────────────
         if (options.showFrame !== undefined) {
           if (!itemId) {
             logger.error('item-id is required for --show-frame');
@@ -190,8 +306,10 @@ try {
           }
 
           // Parse direction and frame (default: 08_0)
+          /** @type {string} */
           const showFrameInput = options.showFrame === true ? '08_0' : options.showFrame;
           const [direction, frameIndex] = showFrameInput.split('_');
+          /** @type {number} */
           const frameIndexNum = parseInt(frameIndex) || 0;
 
           logger.info(`Showing frame for item: ${itemId}, direction: ${direction}, frame: ${frameIndexNum}`);
@@ -250,10 +368,11 @@ try {
           shellExec(`firefox ${outputPath}`);
         }
 
-        // Handle --to-atlas-sprite-sheet
+        // ── Handle --to-atlas-sprite-sheet ───────────────────────────────
         if (options.toAtlasSpriteSheet !== undefined) {
           // If toAtlasSpriteSheet is true (flag without value), use null for auto-calc
           // If it's a string/number, parse it as integer
+          /** @type {number|null} */
           const maxAtlasDim = options.toAtlasSpriteSheet === true ? null : parseInt(options.toAtlasSpriteSheet) || null;
 
           if (!itemId) {
@@ -262,6 +381,7 @@ try {
           }
 
           if (maxAtlasDim) {
+            /** @type {string} */
             const sizeRecommendation =
               maxAtlasDim < 2048
                 ? ' (Warning: May be too small for all frames)'
@@ -299,6 +419,7 @@ try {
             maxAtlasDim,
           );
 
+          /** @type {number} */
           const frameCount = Object.values(metadata.frames).reduce((sum, frames) => sum + frames.length, 0);
           logger.info(
             `Atlas generated: ${metadata.atlasWidth}x${metadata.atlasHeight} pixels (${frameCount} frames packed)`,
@@ -340,7 +461,7 @@ try {
           logger.info(`Atlas sprite sheet completed for item: ${itemKey}`);
         }
 
-        // Handle --show-atlas-sprite-sheet
+        // ── Handle --show-atlas-sprite-sheet ─────────────────────────────
         if (options.showAtlasSpriteSheet) {
           if (!itemId) {
             logger.error('item-id is required for --show-atlas-sprite-sheet');
@@ -384,6 +505,199 @@ try {
           );
         }
 
+        // ── Handle --generate ────────────────────────────────────────────
+        if (options.generate) {
+          if (!itemId) {
+            logger.error(
+              'item-id is required for --generate (e.g. floor-desert, floor-grass, floor-water, floor-stone, floor-lava)',
+            );
+            logger.info('Available semantic prefixes: ' + Object.keys(semanticRegistry).join(', '));
+            process.exit(1);
+          }
+
+          const descriptor = lookupSemantic(itemId);
+          if (!descriptor) {
+            logger.error(`No semantic descriptor found for item-id "${itemId}".`);
+            logger.info('Available semantic prefixes: ' + Object.keys(semanticRegistry).join(', '));
+            process.exit(1);
+          }
+
+          const genSeed = options.seed || `gen-${crypto.randomUUID().slice(0, 8)}`;
+          const genCount = options.count || 3;
+          const genFrameIndex = options.frameIndex || 0;
+          const genFrameCount = options.frameCount || 1;
+          const genDensity = options.density != null ? options.density : 0.5;
+
+          // Append a random suffix to make the item-id unique per run
+          const randStr = crypto.randomUUID().slice(0, 8);
+          const uniqueItemId = `${itemId}-${randStr}`;
+
+          logger.info('Generating procedural object layers', {
+            itemId: uniqueItemId,
+            basePrefix: itemId,
+            seed: genSeed,
+            count: genCount,
+            startFrame: genFrameIndex,
+            frameCount: genFrameCount,
+            density: genDensity,
+            semanticTags: descriptor.semanticTags,
+            itemType: descriptor.itemType,
+            layers: Object.keys(descriptor.layers),
+          });
+
+          // 1. Generate multi-frame result (deterministic, temporally coherent)
+          //    Pass the base itemId for semantic lookup, but override the stored
+          //    item.id with uniqueItemId so every run produces a distinct asset.
+          const multiFrameResult = generateMultiFrame({
+            itemId,
+            seed: genSeed,
+            frameCount: genFrameCount,
+            startFrame: genFrameIndex,
+            count: genCount,
+            density: genDensity,
+          });
+
+          // Overwrite the item id in the generated data with the unique variant
+          multiFrameResult.objectLayerData.data.item.id = uniqueItemId;
+
+          logger.info(
+            `Generated ${multiFrameResult.frameCount} frame(s) with ${multiFrameResult.objectLayerRenderFramesData.colors.length} unique colors`,
+          );
+
+          // 2. Write static asset PNGs to both source and public directories
+          const srcBasePath = './src/client/public/cyberia/';
+          const publicBasePath = `./public/${host}${path}`;
+          const writtenFiles = await ObjectLayerEngine.writeStaticFrameAssets({
+            basePaths: [srcBasePath, publicBasePath],
+            itemType: descriptor.itemType,
+            itemId: uniqueItemId,
+            objectLayerRenderFramesData: multiFrameResult.objectLayerRenderFramesData,
+            objectLayerData: multiFrameResult.objectLayerData,
+            cellPixelDim: 20,
+          });
+
+          logger.info(`Wrote ${writtenFiles.length} asset file(s):`);
+          for (const f of writtenFiles) {
+            logger.info(`  → ${f}`);
+          }
+
+          // 3. Persist to MongoDB (ObjectLayerRenderFrames + ObjectLayer)
+          const { objectLayer } = await ObjectLayerEngine.createObjectLayerDocuments({
+            ObjectLayer,
+            ObjectLayerRenderFrames,
+            objectLayerRenderFramesData: multiFrameResult.objectLayerRenderFramesData,
+            objectLayerData: multiFrameResult.objectLayerData,
+            createOptions: {
+              generateAtlas: false,
+            },
+          });
+
+          logger.info(`ObjectLayer persisted to MongoDB: ${objectLayer._id} (item: ${objectLayer.data.item.id})`);
+
+          // 4. Generate atlas sprite sheet + pin to IPFS
+          let atlasCid = '';
+          try {
+            const atlasItemKey = objectLayer.data.item.id;
+            const populatedObjectLayer = await ObjectLayer.findById(objectLayer._id).populate(
+              'objectLayerRenderFramesId',
+            );
+
+            const { buffer, metadata } = await AtlasSpriteSheetGenerator.generateAtlas(
+              populatedObjectLayer.objectLayerRenderFramesId,
+              atlasItemKey,
+              20,
+            );
+
+            // Save atlas file to File collection
+            const fileDoc = await new File({
+              name: `${atlasItemKey}-atlas.png`,
+              data: buffer,
+              size: buffer.length,
+              mimetype: 'image/png',
+              md5: crypto.createHash('md5').update(buffer).digest('hex'),
+            }).save();
+
+            // Pin atlas PNG to IPFS + copy into MFS
+            try {
+              const ipfsResult = await IpfsClient.addBufferToIpfs(
+                buffer,
+                `${atlasItemKey}_atlas_sprite_sheet.png`,
+                `/object-layer/${atlasItemKey}/${atlasItemKey}_atlas_sprite_sheet.png`,
+              );
+              if (ipfsResult) {
+                atlasCid = ipfsResult.cid;
+                logger.info(`Atlas sprite sheet pinned to IPFS – CID: ${atlasCid}`);
+              }
+            } catch (ipfsError) {
+              logger.warn('Failed to add atlas sprite sheet to IPFS:', ipfsError.message);
+            }
+
+            // Upsert AtlasSpriteSheet document (with CID)
+            let atlasDoc = await AtlasSpriteSheet.findOne({ 'metadata.itemKey': atlasItemKey });
+            if (atlasDoc) {
+              atlasDoc.fileId = fileDoc._id;
+              atlasDoc.cid = atlasCid;
+              atlasDoc.metadata = metadata;
+              await atlasDoc.save();
+              logger.info(`Updated existing AtlasSpriteSheet document: ${atlasDoc._id}`);
+            } else {
+              atlasDoc = await new AtlasSpriteSheet({
+                fileId: fileDoc._id,
+                cid: atlasCid,
+                metadata,
+              }).save();
+              logger.info(`Created new AtlasSpriteSheet document: ${atlasDoc._id}`);
+            }
+
+            // Link atlas to ObjectLayer and set data.atlasSpriteSheetCid
+            populatedObjectLayer.atlasSpriteSheetId = atlasDoc._id;
+            populatedObjectLayer.data.atlasSpriteSheetCid = atlasCid;
+            populatedObjectLayer.markModified('data.atlasSpriteSheetCid');
+            await populatedObjectLayer.save();
+
+            // Also write atlas PNG to both static asset directories
+            for (const bp of [srcBasePath, publicBasePath]) {
+              const atlasOutputDir = nodePath.join(bp, 'assets', descriptor.itemType, uniqueItemId);
+              await fs.ensureDir(atlasOutputDir);
+              const atlasOutputPath = nodePath.join(atlasOutputDir, `${atlasItemKey}-atlas.png`);
+              await fs.writeFile(atlasOutputPath, buffer);
+              logger.info(
+                `Atlas sprite sheet generated: ${metadata.atlasWidth}x${metadata.atlasHeight} → ${atlasOutputPath}`,
+              );
+            }
+          } catch (atlasError) {
+            logger.error(`Failed to generate atlas for ${uniqueItemId}:`, atlasError);
+          }
+
+          // 5. Compute final SHA-256, pin OL data JSON to IPFS, create pin records
+          try {
+            const finalObjectLayer = await ObjectLayer.findById(objectLayer._id).populate('objectLayerRenderFramesId');
+            const finalized = await ObjectLayerEngine.computeAndSaveFinalSha256({
+              objectLayer: finalObjectLayer,
+              ipfsClient: IpfsClient,
+              createPinRecord,
+              userId: undefined, // CLI context has no authenticated user
+              options: { host, path },
+            });
+            logger.info(`Final SHA-256: ${finalized.sha256}`);
+            if (finalized.cid) {
+              logger.info(`ObjectLayer data pinned to IPFS – CID: ${finalized.cid}`);
+            }
+          } catch (finalizeError) {
+            logger.error('Failed to finalize SHA-256 / IPFS:', finalizeError);
+          }
+
+          logger.info(`✓ Generation complete for "${uniqueItemId}" (seed: ${genSeed}, frames: ${genFrameCount})`);
+
+          // Log per-layer summary
+          if (multiFrameResult.frames.length > 0) {
+            const firstFrame = multiFrameResult.frames[0];
+            for (const layer of firstFrame.layers) {
+              logger.info(`  Layer "${layer.layerKey}" (${layer.layerId}): ${layer.keys.length} element(s)`);
+            }
+          }
+        }
+
         await DataBaseProvider.instance[`${host}${path}`].mongoose.close();
       },
     )

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);