Update workflow

Author: johnsamuelwrites

.github/workflows/deploy.yml

@@ -43,7 +43,7 @@ jobs:
         run: |
           mkdir -p public/generated
           python -m multilingualprogramming compile src/automate_universel.ml > public/generated/automate_universel.py
-          python -m multilingualprogramming build-wasm-bundle src/automate_packed_wasm.ml --out-dir public/generated/automate_packed --wasm-target browser
+          python -m multilingualprogramming build-wasm-bundle src/automate_packed_wasm.ml --out-dir public/generated/automate_packed
           cp public/generated/automate_packed/host_shim.js public/generated/automate_packed/host_shim.mjs
 
       - name: Verifier les artefacts de compilation
@@ -62,6 +62,7 @@ jobs:
 
       - 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

.github/workflows/monitor-multilingual.yml

@@ -73,7 +73,7 @@ jobs:
         run: |
           mkdir -p public/generated
           python -m multilingualprogramming compile src/automate_universel.ml > public/generated/automate_universel.py
-          python -m multilingualprogramming build-wasm-bundle src/automate_packed_wasm.ml --out-dir public/generated/automate_packed --wasm-target browser
+          python -m multilingualprogramming build-wasm-bundle src/automate_packed_wasm.ml --out-dir public/generated/automate_packed
           cp public/generated/automate_packed/host_shim.js public/generated/automate_packed/host_shim.mjs
 
       - name: Verifier la syntaxe JavaScript
@@ -85,6 +85,7 @@ jobs:
 
       - 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

.gitignore

@@ -16,6 +16,7 @@ Thumbs.db
 
 # Python/cache helpers
 __pycache__/
+**/__pycache__/
 *.py[cod]
 *$py.class
 .pytest_cache/
@@ -28,14 +29,15 @@ __pycache__/
 /tmp/
 /coverage/
 
+# Generated Multilingual/WASM artifacts.
+# GitHub Actions regenerates these before publishing Pages.
+/public/generated/automate_packed/
+/public/generated/automate_universel/
+/public/generated/automate_universel.py
+
 # Logs
 *.log
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 pnpm-debug.log*
-
-# Keep deployable static artifacts for GitHub Pages.
-# public/generated contains the Multilingual/WASM browser bundle.
-!public/generated/
-!public/generated/**

README.md

@@ -59,11 +59,21 @@ https://<owner>.github.io/Automaginarium/
 
 See `docs/github-pages.md` for deployment notes.
 
+Useful docs:
+
+- `docs/quickstart.md`
+- `docs/create-universe.md`
+- `docs/gallery.md`
+- `docs/stage4-runtime.md`
+- `docs/release-checklist.md`
+
 The repository also includes GitHub Actions workflows:
 
 - `.github/workflows/deploy.yml` compiles the French Multilingual sources, validates the browser/WASM runtime, prepares a static Pages artifact, and deploys on pushes to `main`.
 - `.github/workflows/monitor-multilingual.yml` runs scheduled compatibility checks against pinned, latest, and upstream `multilingualprogramming` builds.
 
+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:
 
 ```bash
@@ -84,6 +94,12 @@ Stage 5 adds the preset gallery and static deployment checks:
 node tests/stage5-static.js
 ```
 
+Stage 6 strengthens Multilingual ownership by testing the generated Python produced from the French core:
+
+```bash
+python tests/stage6_french_core.py
+```
+
 ## Attribution
 
 Automaginarium is a successor to Cellcosmos and intentionally reuses its project ideas and visual direction. The initial browser metrics and rendering approach are derived from Cellcosmos concepts:

docs/create-universe.md

@@ -0,0 +1,53 @@
+# Create A Universe
+
+A universe is a JSON object. The most important fields are:
+
+- `alphabet_entree`: values read from each neighborhood
+- `alphabet_sortie`: values produced by the transition rule
+- `taille_voisinage`: neighborhood width, usually 3, 5, or 7
+- `nombre_canaux_sortie`: how many values each transition returns
+- `mode_regle`: `table`, `totalistique`, or `aleatoire`
+- `table_transition`: explicit rule table when using `table`
+- `etat_initial`: seed pattern
+
+Example:
+
+```json
+{
+  "nom": "Mini univers",
+  "alphabet_entree": [0, 1],
+  "alphabet_sortie": [0, 1],
+  "taille_voisinage": 3,
+  "nombre_canaux_sortie": 1,
+  "mode_regle": "table",
+  "table_transition": {
+    "[1,1,1]": [0],
+    "[1,1,0]": [1],
+    "[1,0,1]": [1],
+    "[1,0,0]": [0],
+    "[0,1,1]": [1],
+    "[0,1,0]": [1],
+    "[0,0,1]": [1],
+    "[0,0,0]": [0]
+  },
+  "largeur": 101,
+  "hauteur": 80,
+  "etat_initial": { "mode": "centre" }
+}
+```
+
+Rule keys are JSON arrays encoded as strings. This is deliberate: `"[\"a\",\"aa\"]"` is unambiguous, while a concatenated key such as `"aaa"` is not.
+
+## Multi-Channel Output
+
+The first output channel becomes the next state. Later channels can affect rendering. For example:
+
+```json
+"[0,1,0]": [1, 3]
+```
+
+Here `1` drives evolution and `3` can drive color.
+
+## French Multilingual Ownership
+
+The canonical model lives in `src/automate_universel.ml`. The browser-friendly numeric WASM bridge lives in `src/automate_packed_wasm.ml`. JavaScript should stay focused on JSON loading, UI events, and canvas rendering.

docs/github-pages.md

@@ -6,31 +6,37 @@ Recommended repository settings:
 
 1. Open repository settings on GitHub.
 2. Go to **Pages**.
-3. Set **Source** to `Deploy from a branch`.
-4. Select the main branch and `/ (root)`.
+3. Set **Source** to `GitHub Actions`.
 5. Save.
 
-The root `index.html` redirects to `public/index.html`, where the application runs. This keeps the repository structure explicit while still making the GitHub Pages root URL usable.
+The root `index.html` redirects to `public/index.html`, where the application runs. The workflow builds generated Multilingual/WASM artifacts at deploy time and uploads a complete Pages artifact.
 
-Files that must be committed for Pages:
+Source files that must be committed for Pages:
 
 - `public/index.html`
 - `public/app.mjs`
 - `public/automate-core.js`
 - `public/style.css`
-- `public/generated/automate_packed/module.wasm`
-- `public/generated/automate_packed/*.js`
-- `public/generated/automate_packed/*.mjs`
+- `public/generated/automate_packed_runtime.mjs`
 - `examples/*.json`
+- `src/*.ml`
+- `.github/workflows/deploy.yml`
+
+Generated files that should not be committed:
+
+- `public/generated/automate_packed/`
+- `public/generated/automate_universel.py`
 
 The `.nojekyll` file disables Jekyll processing so GitHub Pages serves static generated assets as-is.
 
 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
 ```
 
 Then serve locally from the repository root:

docs/quickstart.md

@@ -0,0 +1,38 @@
+# Quickstart
+
+Automaginarium runs as a static site.
+
+```powershell
+python -m http.server 8788
+```
+
+Open:
+
+```text
+http://localhost:8788/
+```
+
+From there:
+
+1. Pick a preset from the gallery.
+2. Change the alphabet, neighborhood size, or initial state.
+3. Choose a rule generator.
+4. Click **Generer** or **Appliquer**.
+5. Export the result as PNG or JSON.
+
+No application server is required. The generated Multilingual/WASM bundle is served from `public/generated/`.
+
+## Rebuild Generated Artifacts
+
+```powershell
+.\scripts\build-stage4.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
+```

docs/release-checklist.md

@@ -0,0 +1,51 @@
+# Release Checklist
+
+Before publishing a release:
+
+1. Rebuild generated artifacts.
+
+   ```powershell
+   .\scripts\build-stage4.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
+   ```
+
+3. Serve the repository root.
+
+   ```powershell
+   python -m http.server 8788
+   ```
+
+4. Open `http://localhost:8788/`.
+
+5. Browser-check:
+
+   - gallery thumbnails render
+   - all presets load
+   - Wolfram/random/symmetric/totalistic generation works
+   - JSON import/export works
+   - PNG export works
+   - browser console has no missing `module.wasm` or preset JSON errors
+
+6. Push to GitHub and verify Actions.
+
+7. Confirm GitHub Pages serves:
+
+   - root URL
+   - `public/generated/automate_packed/module.wasm`
+   - `examples/*.json`
+
+8. Confirm generated files are not staged:
+
+   ```powershell
+   git status --short --ignored
+   ```
+
+   `public/generated/automate_packed/` and `public/generated/automate_universel.py` should remain ignored locally.

docs/stage4-runtime.md

@@ -21,6 +21,12 @@ public/generated/automate_packed/
 public/generated/automate_universel.py
 ```
 
+These generated files are intentionally ignored by Git and regenerated by GitHub Actions before deployment. The committed runtime loader is:
+
+```text
+public/generated/automate_packed_runtime.mjs
+```
+
 The browser loads `public/generated/automate_packed_runtime.mjs`, which instantiates `module.wasm` and installs `window.AutomaginariumPacked`. `public/automate-core.js` then calls generated Multilingual/WASM exports for narrow numeric primitives such as Wolfram and totalistic outputs, while retaining JavaScript fallback behavior for rich JSON table orchestration.
 
 Regenerate artifacts with:
@@ -30,3 +36,5 @@ Regenerate artifacts with:
 ```
 
 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`.

public/automate-core.js

@@ -25,8 +25,9 @@ function normaliserConfiguration(configuration) {
     ? configuration.alphabet_sortie
     : alphabetEntree;
   let tailleVoisinage = Number(configuration.taille_voisinage || 3);
-  if (tailleVoisinage < 1) tailleVoisinage = 1;
-  if (tailleVoisinage % 2 === 0) tailleVoisinage += 1;
+  tailleVoisinage = Math.trunc(callPacked("taille_voisinage_normalisee", [tailleVoisinage], (
+    tailleVoisinage < 1 ? 1 : (tailleVoisinage % 2 === 0 ? tailleVoisinage + 1 : tailleVoisinage)
+  )));
   return {
     nom: configuration.nom || "Univers sans nom",
     alphabet_entree: alphabetEntree,
@@ -170,6 +171,26 @@ function callPacked(name, args, fallback) {
   return fallback;
 }
 
+function codeVoisinageNumerique(voisinage, tailleAlphabet) {
+  if (!voisinage.every((value) => Number.isInteger(Number(value)))) return null;
+  const values = voisinage.map(Number);
+  if (values.length === 3) {
+    return Math.trunc(callPacked(
+      "code_voisinage_3_base",
+      [values[0], values[1], values[2], tailleAlphabet],
+      values.reduce((code, value) => code * tailleAlphabet + value, 0),
+    ));
+  }
+  if (values.length === 5) {
+    return Math.trunc(callPacked(
+      "code_voisinage_5_base",
+      [values[0], values[1], values[2], values[3], values[4], tailleAlphabet],
+      values.reduce((code, value) => code * tailleAlphabet + value, 0),
+    ));
+  }
+  return values.reduce((code, value) => code * tailleAlphabet + value, 0);
+}
+
 function toutesClesVoisinage(alphabet, taille) {
   const keys = [];
   function visit(prefix, depth) {
@@ -223,4 +244,5 @@ window.AutomaginariumCore = {
   cleVoisinage,
   toutesClesVoisinage,
   validerConfiguration,
+  codeVoisinageNumerique,
 };