Rename files

Author: johnsamuelwrites

.github/workflows/deploy.yml

@@ -53,15 +53,16 @@ jobs:
         run: |
           node --check public/automate-core.js
           node --check public/app.mjs
+          node --check public/ui.mjs
           node --check public/generated/automate_packed_runtime.mjs
           node --check public/generated/automate_packed/host_shim.mjs
 
       - name: Valider le moteur et le WASM
         run: |
-          python tests/stage6_french_core.py
-          node tests/stage3-smoke.js
-          node tests/stage4-wasm.mjs
-          node tests/stage5-static.js
+          python tests/french_core_smoke.py
+          node tests/core_smoke.js
+          node tests/packed_runtime_smoke.mjs
+          node tests/static_site_smoke.js
 
       - name: Verifier la structure GitHub Pages
         run: |

.github/workflows/monitor-multilingual.yml

@@ -76,15 +76,16 @@ jobs:
         run: |
           node --check public/automate-core.js
           node --check public/app.mjs
+          node --check public/ui.mjs
           node --check public/generated/automate_packed_runtime.mjs
           node --check public/generated/automate_packed/host_shim.mjs
 
       - name: Valider le moteur et le WASM
         run: |
-          python tests/stage6_french_core.py
-          node tests/stage3-smoke.js
-          node tests/stage4-wasm.mjs
-          node tests/stage5-static.js
+          python tests/french_core_smoke.py
+          node tests/core_smoke.js
+          node tests/packed_runtime_smoke.mjs
+          node tests/static_site_smoke.js
 
       - name: Upload metadata artifact
         if: always()

README.md

@@ -2,7 +2,7 @@
 
 Automaginarium is a configurable universe generator for cellular automata. It extends the spirit of [Cellcosmos](https://github.com/multilingualprogramming/cellcosmos): instead of exploring only the 256 elementary Wolfram rules, it opens the rule space itself.
 
-The project is designed to demonstrate the expressive power of the Multilingual programming language. The canonical automata concepts are written in French Multilingual source, while JavaScript is kept as a browser layer for loading JSON configurations, drawing to canvas, and wiring interface events.
+The project is designed to demonstrate the expressive power of the Multilingual programming language. The canonical automata concepts are written in French Multilingual source, while JavaScript is kept as a thin browser layer for loading JSON configurations, drawing to canvas, and wiring only the essential interface events.
 
 ## Vision
 
@@ -27,17 +27,18 @@ docs/       Migration notes, architecture, tutorials
 scripts/    Future build helpers for Multilingual/WASM compilation
 ```
 
-## Current Stage
+## Current Shape
 
-This is the Stage 2 working skeleton. It includes:
+The repository currently includes:
 
 - a canonical French Multilingual core in `src/automate_universel.ml`
 - a small JavaScript adapter in `public/automate-core.js` that mirrors the current core until the Multilingual/WASM build pipeline is wired
-- a canvas UI in `public/app.js`
+- a canvas UI in `public/app.mjs`
+- a small progressive-enhancement layer in `public/ui.mjs`
 - copied Cellcosmos heritage references in `public/metrics.js` and `src/cellcosmos_primitives_heritage.ml`
 - example configurations and a JSON schema in `examples/`
 - migration and architecture documentation in `docs/`
-- Stage 3 canonical rule keys using JSON-array strings such as `"[0,1,0]"`
+- canonical rule keys using JSON-array strings such as `"[0,1,0]"`
 
 ## Run The Demo
 
@@ -64,7 +65,7 @@ Useful docs:
 - `docs/quickstart.md`
 - `docs/create-universe.md`
 - `docs/gallery.md`
-- `docs/stage4-runtime.md`
+- `docs/packed-runtime.md`
 - `docs/release-checklist.md`
 
 The repository also includes GitHub Actions workflows:
@@ -74,30 +75,30 @@ The repository also includes GitHub Actions workflows:
 
 Generated Multilingual/WASM outputs under `public/generated/automate_packed/` are intentionally ignored. GitHub Actions regenerates them before publishing Pages.
 
-Stage 3 also adds smoke tests:
+Smoke tests include:
 
 ```bash
-node tests/stage3-smoke.js
+node tests/core_smoke.js
 multilingual compile src/automate_universel.ml
 ```
 
-Stage 4 adds a generated runtime bridge:
+The packed runtime bridge is refreshed with:
 
 ```powershell
-.\scripts\build-stage4.ps1
-node tests/stage4-wasm.mjs
+.\scripts\build-packed-runtime.ps1
+node tests/packed_runtime_smoke.mjs
 ```
 
-Stage 5 adds the preset gallery and static deployment checks:
+Static deployment checks run with:
 
 ```bash
-node tests/stage5-static.js
+node tests/static_site_smoke.js
 ```
 
-Stage 6 strengthens Multilingual ownership by testing the generated Python produced from the French core:
+The generated Python produced from the French core is checked with:
 
 ```bash
-python tests/stage6_french_core.py
+python tests/french_core_smoke.py
 ```
 
 ## Attribution
@@ -113,7 +114,7 @@ Where source code is directly adapted, comments identify Cellcosmos as the origi
 
 ## Next Migration Steps
 
-1. Compile `src/automate_universel.ml` through the Multilingual toolchain to WebAssembly or generated JavaScript.
-2. Replace `public/automate-core.js` with generated calls into the French core.
-3. Bring over isolated Cellcosmos features: metrics, gallery thumbnails, sharing, PNG export refinements, and selected Matter Lab interactions.
+1. Compile more of `src/automate_universel.ml` through the Multilingual toolchain to WebAssembly or generated JavaScript.
+2. Replace more of `public/automate-core.js` with generated calls into the French core.
+3. Keep trimming browser-side helpers that do not strengthen the multilingual model.
 4. Add more generated rule spaces: totalistic, symmetric, genetic, stochastic, and multi-channel examples.

docs/architecture.md

@@ -6,14 +6,15 @@ Automaginarium is split into four layers:
 examples/*.json              declarative universes
 src/automate_universel.ml    canonical French Multilingual automata core
 public/automate-core.js      temporary browser adapter mirroring the core
-public/app.js                DOM events, canvas drawing, preset loading
+public/app.mjs               DOM events, canvas drawing, preset loading
+public/ui.mjs                small progressive-enhancement UI bridge
 ```
 
 The intended stable boundary is the configuration object. The UI should not know Wolfram-specific details except where it offers a preset shortcut.
 
-Stage 3 uses canonical JSON-array rule keys, for example `"[0,1,0]"`, rather than concatenated keys such as `"010"`. The browser adapter still accepts older Cellcosmos-style keys as a compatibility fallback.
+Canonical JSON-array rule keys use forms such as `"[0,1,0]"`, rather than concatenated keys such as `"010"`. The browser adapter still accepts older Cellcosmos-style keys as a compatibility fallback.
 
-Stage 4 adds a generated Multilingual/WASM bridge. The full French core remains the canonical configuration and evolution model, while `src/automate_packed_wasm.ml` exposes a narrow numeric ABI for browser calls. The browser prefers `window.AutomaginariumPacked` when available and falls back to JavaScript only where rich JSON orchestration is still needed.
+The packed Multilingual/WASM bridge keeps the full French core as the canonical configuration and evolution model, while `src/automate_packed_wasm.ml` exposes a narrow numeric ABI for browser calls. The browser prefers `window.AutomaginariumPacked` when available and falls back to JavaScript only where rich JSON orchestration is still needed.
 
 ## Reuse From Cellcosmos
 

docs/gallery.md

@@ -1,6 +1,6 @@
 # Preset Gallery
 
-Stage 5 adds a browser-rendered preset gallery. Each gallery tile is generated from the same Automaginarium configuration model used by the main canvas.
+The browser-rendered preset gallery uses the same Automaginarium configuration model as the main canvas.
 
 Current preset families:
 
@@ -16,5 +16,5 @@ The gallery intentionally uses real generated thumbnails rather than static imag
 The static check is:
 
 ```powershell
-node tests\stage5-static.js
+node tests\static_site_smoke.js
 ```

docs/github-pages.md

@@ -15,6 +15,7 @@ Source files that must be committed for Pages:
 
 - `public/index.html`
 - `public/app.mjs`
+- `public/ui.mjs`
 - `public/automate-core.js`
 - `public/style.css`
 - `public/generated/automate_packed_runtime.mjs`
@@ -32,11 +33,11 @@ The `.nojekyll` file disables Jekyll processing so GitHub Pages serves static ge
 Before publishing, run:
 
 ```powershell
-.\scripts\build-stage4.ps1
-python tests\stage6_french_core.py
-node tests\stage3-smoke.js
-node tests\stage4-wasm.mjs
-node tests\stage5-static.js
+.\scripts\build-packed-runtime.ps1
+python tests\french_core_smoke.py
+node tests\core_smoke.js
+node tests\packed_runtime_smoke.mjs
+node tests\static_site_smoke.js
 ```
 
 Then serve locally from the repository root:

docs/migration-plan.md

@@ -23,7 +23,7 @@
 
 ## Stage 4 - Minimal JavaScript
 
-- keep `public/app.js` focused on DOM, canvas, fetch, and events
+- keep `public/app.mjs` focused on DOM, canvas, fetch, and events
 - keep rule logic behind `window.AutomaginariumCore` or WASM exports
 - migrate Cellcosmos share URLs and gallery generation only after the core boundary is stable
 

docs/stage4-runtime.md docs/packed-runtime.mddocs/stage4-runtime.md renamed to docs/packed-runtime.md

@@ -1,6 +1,6 @@
-# Stage 4 Runtime Bridge
+# Packed Runtime Bridge
 
-Stage 4 introduces a generated runtime path from French Multilingual into the browser.
+The packed runtime introduces a generated path from French Multilingual into the browser.
 
 The rich canonical engine remains:
 
@@ -32,9 +32,9 @@ The browser loads `public/generated/automate_packed_runtime.mjs`, which instanti
 Regenerate artifacts with:
 
 ```powershell
-.\scripts\build-stage4.ps1
+.\scripts\build-packed-runtime.ps1
 ```
 
 Current limitation: the full JSON/dictionary/list-rich core compiles to generated Python but does not yet produce a browser WASM bundle with the current Multilingual WAT backend. The narrow ABI module is the deliberate bridge until richer data lowering is available.
 
-The generated rich core is now exercised by `tests/stage6_french_core.py`, so CI verifies behavior that comes directly from `src/automate_universel.ml`.
+The generated rich core is exercised by `tests/french_core_smoke.py`, so CI verifies behavior that comes directly from `src/automate_universel.ml`.

docs/quickstart.md

@@ -25,14 +25,14 @@ No application server is required. The generated Multilingual/WASM bundle is ser
 ## Rebuild Generated Artifacts
 
 ```powershell
-.\scripts\build-stage4.ps1
+.\scripts\build-packed-runtime.ps1
 ```
 
 Then run:
 
 ```powershell
-python tests\stage6_french_core.py
-node tests\stage3-smoke.js
-node tests\stage4-wasm.mjs
-node tests\stage5-static.js
+python tests\french_core_smoke.py
+node tests\core_smoke.js
+node tests\packed_runtime_smoke.mjs
+node tests\static_site_smoke.js
 ```

docs/release-checklist.md

@@ -5,16 +5,16 @@ Before publishing a release:
 1. Rebuild generated artifacts.
 
    ```powershell
-   .\scripts\build-stage4.ps1
+   .\scripts\build-packed-runtime.ps1
    ```
 
 2. Run all local tests.
 
    ```powershell
-   python tests\stage6_french_core.py
-   node tests\stage3-smoke.js
-   node tests\stage4-wasm.mjs
-   node tests\stage5-static.js
+   python tests\french_core_smoke.py
+   node tests\core_smoke.js
+   node tests\packed_runtime_smoke.mjs
+   node tests\static_site_smoke.js
    ```
 
 3. Serve the repository root.