cyberia 3.0.1 → 3.0.2

package/.github/workflows/engine-cyberia.cd.yml

@@ -59,6 +59,7 @@ jobs:
             echo "Starting remote sync and deploy"
             cd /home/dd/engine
             sudo -n -- /bin/bash -lc "node bin run pull"
+            sudo -n -- /bin/bash -lc "npm run test"
             sudo -n -- /bin/bash -lc "node bin run sync --kubeadm --deploy-id-cron-jobs none --timeout-response 300000ms dd-cyberia,1,,localhost/rockylinux9-underpost:v2.98.3 --cmd 'npm install -g npm@11.2.0,npm install -g underpost,underpost secret underpost --create-from-file /etc/config/.env.production,underpost start --build --run dd-cyberia production'"
   init:
     if: github.repository == 'underpostnet/engine' && startsWith(github.event.head_commit.message, 'cd(ssh-init-engine-cyberia)')

package/CHANGELOG.md

@@ -1,6 +1,61 @@
 # Changelog
 
-## 2026-02-23
+## 2026-03-02
+
+### engine-cyberia
+
+- Add test in engine-cyberia cd workflow ([642d7e36](https://github.com/underpostnet/engine/commit/642d7e36155b6db5dbd36e19767dd95f146ceaf5))
+- Add build dd-cyberia shape generator exclusive module files ([188f563a](https://github.com/underpostnet/engine/commit/188f563a61d7f6bf36bef93cdd18d4e1304f9747))
+- Fix ObjectLayerEngineViewer return to list button click ([aeaead6f](https://github.com/underpostnet/engine/commit/aeaead6f5c67a03449c63c584976e9a73ccc953d))
+- Improve static generations assets in object layer generation CLI ([06694d92](https://github.com/underpostnet/engine/commit/06694d92ea1ad849e745f561b8ec9a48bfa66056))
+- Implements deterministic object layer generation CLI ([f70c9841](https://github.com/underpostnet/engine/commit/f70c9841ef2efc9187c87427cc465505487766db))
+- Implement shape generator module ([5741a38b](https://github.com/underpostnet/engine/commit/5741a38bcfb8c1c4e0ef5053a2a6a73ff50a3879))
+- Fix remove of ag grid table delete object layer delete logic ([e98953cd](https://github.com/underpostnet/engine/commit/e98953cd29767ca44c2362997f0af40cd538371b))
+- Centralize Object Layer Logic and add js docs ([ff8eefed](https://github.com/underpostnet/engine/commit/ff8eefed08349a1e3390379f760c0d9eb20aecca))
+- ObjectLayer Engine Viewer Enhancements ([0ee052e5](https://github.com/underpostnet/engine/commit/0ee052e5231f7b55576595a817742970c90cd056))
+- Add metada json editor of object layers ([abe7448f](https://github.com/underpostnet/engine/commit/abe7448f5ed7429ba1f5c5d01ed94c5c70323638))
+- Remove helia pyntype logic ([2b443d1c](https://github.com/underpostnet/engine/commit/2b443d1c0ed2261e27d5be54903c9a37cff29dd5))
+- Object Layer Deletion Cleanup IPFS ([a2dcdf23](https://github.com/underpostnet/engine/commit/a2dcdf238c32d5b5237f0650232aca0c0823f044))
+- Add Public GET Access for File Object Atlas ([826317fe](https://github.com/underpostnet/engine/commit/826317fe21dfd0b77196ef343b31461c45b5eb72))
+- Allow Cross-Origin on GET methods file, object-layer, and atlas-sprite-sheet api. ([6801839c](https://github.com/underpostnet/engine/commit/6801839cc461dbec6ca205b035ea844415779e85))
+- Add DISABLE_API_RATE_LIMIT env option ([ae72885c](https://github.com/underpostnet/engine/commit/ae72885c1178846067db52b62455d804dbe4eeba))
+
+### client-core
+
+- Fix main-body-btn-container hide logic ([221f8bfc](https://github.com/underpostnet/engine/commit/221f8bfc262048e1ca226f66f0dfab9891db3fd5))
+
+### runtime-express
+
+- Fix express rate limit trust proxy ([ed19e729](https://github.com/underpostnet/engine/commit/ed19e729eafb59d46504fb1ebe89e4bd91c05d7e))
+
+### cli-cluster
+
+- Remove unused full flag ([13df39f5](https://github.com/underpostnet/engine/commit/13df39f508d65b61378ccfca4f7bfc427dcf5fa5))
+
+### ipfs
+
+- Add ipfs client stable json stringify in addJsonToIpfs method ([c2aaf56a](https://github.com/underpostnet/engine/commit/c2aaf56a4bfc4f06147818ec5681567e27967f41))
+- Fix config map IPFS Cluster daemon bind ([7e6df963](https://github.com/underpostnet/engine/commit/7e6df963ba6da1fdc96ac5b6ab844a789901f61b))
+- server ipfs client and object layer atlas sprite sheet ipfs integration ([781e35c4](https://github.com/underpostnet/engine/commit/781e35c4903380df9e7dce7cf5d9275387a46029))
+- Implement ipfs api user-pin and client component service ([1b12e8df](https://github.com/underpostnet/engine/commit/1b12e8df6af21e1dd2edc156e176072f25c9a433))
+
+### cli-run
+
+- Implements expose-ipfs runner ([765772b8](https://github.com/underpostnet/engine/commit/765772b8fb1e7b397560464d1dc6dea0b70a9b7f))
+
+### engine-core
+
+- Clean up legacy logic and json file model ref ([b4c62a2c](https://github.com/underpostnet/engine/commit/b4c62a2cfe4fea0212be644ce333464a81056f6f))
+
+### bin-build
+
+- Add missing       packagejson overrides on dd-cyberia build repository workflow ([7ece9ed5](https://github.com/underpostnet/engine/commit/7ece9ed5500e83a1baedc4d78fd889bca6ecac3c))
+
+## New release v:3.0.1 (2026-02-22)
+
+### engine-core
+
+- Remove ENABLE_FILE_LOGS to default dev adn test env ([727486dc](https://github.com/underpostnet/engine/commit/727486dc4030921c9d1f6a7035eb1a240569fa74))
 
 ### gitlab
 

package/CLI-HELP.md

@@ -1,4 +1,4 @@
-## underpost ci/cd cli v3.0.1
+## underpost ci/cd cli v3.0.2
 
 ### 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:

package/README.md

@@ -24,12 +24,14 @@ Key features:
 
 - Walks the asset directory structure and processes PNG/GIF files.
 - Produces `frame_matrix` and `map_color` arrays from images.
+- **Procedurally generates object layers** from semantic item-id descriptors with deterministic seeds and temporal coherence.
 - Saves processed objects to the `ObjectLayer` model with top-level references to `ObjectLayerRenderFrames`.
 - Creates separate `ObjectLayerRenderFrames` documents for render data.
 - Links ObjectLayers to AtlasSpriteSheet documents via top-level `atlasSpriteSheetId`.
 - Generates unique UUID v4 seeds (via `crypto.randomUUID()`) for SHA256 hash uniqueness.
 - Generates SHA256 hash using `fast-json-stable-stringify` for deterministic serialization.
 - Reconstructs PNG frames from stored tile data for debugging.
+- Writes static asset PNGs, atlas sprite sheets, and metadata to the conventional directory structure.
 
 ## Getting Started
 
@@ -68,6 +70,104 @@ cyberia ol --import skin,floor
 cyberia ol --import all
 ```
 
+### Procedural generation with `--generate`
+
+Produces semantically consistent object layers with controlled, reproducible variation and short-term temporal coherence (consecutive frames stay visually consistent). Uses the parametric shape generator and object layer engine under the hood.
+
+```bash
+# Generate a desert floor tile (single frame, auto seed)
+cyberia ol floor-desert --generate
+
+# Full control: 3 frames, explicit seed, density
+cyberia ol floor-desert --generate --count 3 --seed fx-42 --frame-index 0 --frame-count 3 --density 0.5
+
+# Grass terrain, sparse, 5 frames
+cyberia ol floor-grass --generate --seed meadow-7 --frame-count 5 --density 0.3
+
+# Water surface, dense, high element count
+cyberia ol floor-water --generate --seed ocean-1 --count 5 --density 0.8 --frame-count 4
+
+# Stone cobblestone
+cyberia ol floor-stone --generate --seed cobble-99 --count 4 --density 0.6
+
+# Lava flow, 3-frame animation
+cyberia ol floor-lava --generate --seed magma-3 --frame-count 3 --density 0.7
+```
+
+**`--generate` options:**
+
+| Option | Default | Description |
+|---|---|---|
+| `--seed <str>` | auto UUID | Deterministic seed string. Same seed → same output. |
+| `--count <n>` | `3` | Shape element count multiplier per layer. |
+| `--frame-index <n>` | `0` | Starting frame index. |
+| `--frame-count <n>` | `1` | Number of consecutive frames to generate. |
+| `--density <f>` | `0.5` | Overall density factor (`0`–`1`). Lower = sparser. |
+
+**Available semantic item-id prefixes:**
+
+| Prefix | Type | Tags | Palette |
+|---|---|---|---|
+| `floor-desert` | floor | sand, dune, arid | warm ochres, sand tones |
+| `floor-grass` | floor | grass, meadow, earth | greens, earth browns |
+| `floor-water` | floor | water, ocean, wave | blues, foam whites |
+| `floor-stone` | floor | stone, rock, cobble | greys, warm/cool stone |
+| `floor-lava` | floor | lava, magma, fire | reds, oranges, dark crust |
+| `skin-*` | skin | character, body | skin tones, clothing darks |
+
+#### How generation works
+
+Each item-id maps to a **semantic descriptor** that provides `semanticTags`, `paletteHints`, `preferredShapes`, and named **layer specs** (e.g. `base`, `dunes`, `rocks`, `tufts` for `floor-desert`).
+
+**Seed derivation** — deterministic at every level:
+
+```
+layerSeed  = hash(seed + ':' + itemId + ':' + layerKey)
+frameSeed  = hash(layerSeed + ':' + frameIndex)
+```
+
+**Temporal coherence** — shape topology (which shapes, how many, where) is locked to `layerSeed` and never changes between frames. Only smooth, low-frequency noise perturbations (position jitter, slight rotation/scale wobble) are derived from `frameSeed`, so frame N and N+1 differ by ~2% of cells.
+
+**Layer naming** — every generated layer gets an id: `<itemId>-<layerKey>` (e.g. `floor-desert-dunes`).
+
+**Generation pipeline per layer:**
+
+1. Pick generator type (`noise-field` for base fills, `shape` for element placement).
+2. Select palette colors deterministically from `paletteHints` with per-element `colorShift`.
+3. For shape layers: pick shape via weighted `preferredShapes`, compute stable base transform `(x, y, scale, rotation)`, apply frame-level smooth noise.
+4. Stamp shapes onto a 24×24 grid via `intCoords` rasterization from the parametric shape generator.
+5. Composite all layers into a final `frame_matrix` + unified `colors` palette.
+
+**Variability factors per layer:**
+`scaleVariance`, `rotationVariance`, `colorShift`, `jitter`, `noiseLevel`, `detailLevel`, `sparsity` — small, deterministic variations that keep each generation unique but semantically coherent.
+
+#### What `--generate` persists
+
+The full pipeline runs automatically:
+
+1. **Static assets** — PNGs written to `./src/client/public/cyberia/assets/{type}/{itemId}/{dirCode}/{frame}.png` + `metadata.json`.
+2. **MongoDB** — `ObjectLayerRenderFrames` + `ObjectLayer` documents created with SHA-256 hash.
+3. **Atlas sprite sheet** — generated, saved to `File` + `AtlasSpriteSheet` collections, and linked via `atlasSpriteSheetId`.
+
+#### Reproducibility example
+
+Running the same command twice produces byte-identical output:
+
+```bash
+# Run 1
+cyberia ol floor-desert --generate --seed fx-42 --count 3 --frame-count 2
+
+# Run 2 (identical output)
+cyberia ol floor-desert --generate --seed fx-42 --count 3 --frame-count 2
+```
+
+Different seeds produce different but semantically consistent results:
+
+```bash
+cyberia ol floor-desert --generate --seed fx-42   # variant A
+cyberia ol floor-desert --generate --seed fx-99   # variant B (same style, different arrangement)
+```
+
 ## Visualize a processed frame
 
 Reconstructs and opens a PNG from the database-stored frame data. Requires item-id as the first positional argument, followed by direction and frame index in the format `[direction]_[frameIndex]`.
@@ -178,6 +278,45 @@ cyberia ol anon --to-atlas-sprite-sheet
 cyberia ol anon --show-atlas-sprite-sheet
 ```
 
+### Procedural Generation Pipeline
+
+Generate an object layer entirely from a semantic descriptor — no source PNGs needed:
+
+```bash
+# 1. Generate a 3-frame desert floor with explicit seed
+cyberia ol floor-desert --generate --seed fx-42 --frame-count 3 --density 0.5
+
+# 2. Inspect the generated frame
+cyberia ol floor-desert --show-frame 08_0
+
+# 3. View the auto-generated atlas
+cyberia ol floor-desert --show-atlas-sprite-sheet
+```
+
+### Batch Procedural Generation
+
+Generate a full tileset family with consistent seeds:
+
+```bash
+cyberia ol floor-desert --generate --seed world-1 --frame-count 3
+cyberia ol floor-grass  --generate --seed world-1 --frame-count 3
+cyberia ol floor-water  --generate --seed world-1 --frame-count 4
+cyberia ol floor-stone  --generate --seed world-1 --frame-count 2
+cyberia ol floor-lava   --generate --seed world-1 --frame-count 3
+```
+
+### Exploring Seed Variations
+
+```bash
+# Same item, different seeds — compare visual output
+cyberia ol floor-desert --generate --seed alpha  --frame-count 1
+cyberia ol floor-desert --generate --seed beta   --frame-count 1
+cyberia ol floor-desert --generate --seed gamma  --frame-count 1
+
+# Inspect each
+cyberia ol floor-desert --show-frame 08_0
+```
+
 ### Debugging Asset Issues
 
 ```bash

package/bin/build.js

@@ -181,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}`);
 
@@ -217,4 +220,6 @@ 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`);
+  shellExec(`cd ${basePath} && npm run fix`);
 }