Add application file

README.md

@@ -14,9 +14,10 @@ pinned: false
 
 A self-hosted web lab that puts decision models on the same decisions and compares their answers, confidence and speed:
 
-- **Three models from the Hugging Face Hub**, in this order:
+- **Four models from the Hugging Face Hub**, in this order:
   - **LightDec_Arthur**: [Falconsai/LightDec_Arthur](https://huggingface.co/Falconsai/LightDec_Arthur), the byte-level Arthur model (about 12M parameters). Only its `config.json` and `model.safetensors` are downloaded; the code that runs it ships with DecisionLab, copied verbatim from the arthur_v0_8_0 notebook.
   - **LightDec_V2**: [Falconsai/LightDec_V2](https://huggingface.co/Falconsai/LightDec_V2), FalconDec on the Ettin-150M encoder (about 160M parameters). Its `falcondec_modeling.py` runs only if its sha256 is on the allowlist; otherwise its card shows the hash and how to trust it.
+  - **Enterprise Reflux Laya V2.1**: [yasserrmd/enterprise-reflux-laya-v21](https://huggingface.co/yasserrmd/enterprise-reflux-laya-v21), a Laya fine-tune for ranking enterprise actions (ModernBERT-large, like Laya), loaded with the same `laya` runtime. Its model card marks it a research prototype, not for production.
   - **Laya**: [convaiinnovations/laya](https://huggingface.co/convaiinnovations/laya), by Convai Innovations, ModernBERT-large, 421M parameters, Apache-2.0.
 - **Every model in the `models` folder**, added after those and marked "(local)":
   - **LightDec (FalconDec) models**: a folder with a `falcondec_config.json`, named from that config.
@@ -52,7 +53,7 @@ docker build -t decisionlab .
 docker run -d --name DecisionLab -p 9910:9910 -v decisionlab-hf:/data/hf -v "${PWD}\models:/models:ro" decisionlab
 ```
 
-The first start downloads the three Hub models (about 1.2 GB) into the `decisionlab-hf` volume. The page shows each model's loading progress, and later starts load from the cache in seconds.
+The first start downloads the four Hub models (about 2 GB) into the `decisionlab-hf` volume. The page shows each model's loading progress, and later starts load from the cache in seconds.
 
 ### NVIDIA GPU
 
@@ -80,11 +81,11 @@ cd <your-space>
 git lfs install
 # copy the contents of this DecisionLab folder into it (not the folder itself), then:
 git add .
-git commit -m "DecisionLab 2.1.2"
+git commit -m "DecisionLab 2.2.0"
 git push
 ```
 
-The Space downloads the three Hub models on first start. Model folders you put in `models/` are loaded too; their weights go through Git LFS (`.gitattributes`).
+The Space downloads the four Hub models on first start. Model folders you put in `models/` are loaded too; their weights go through Git LFS (`.gitattributes`).
 
 Call it from Python:
 
@@ -111,6 +112,7 @@ The plain HTTP API works on the Space too, at `https://<your-user>-<your-space>.
 | `LIGHTDEC_VARIANT` | `fp16` | `fp16` (each model folder itself) or `int8` (its `compact-int8` subfolder, dequantised on load), for every discovered model |
 | `LIGHTDEC_ARTHUR_REPO` | `Falconsai/LightDec_Arthur` | Hub repo shown as LightDec_Arthur |
 | `LIGHTDEC_V2_REPO` | `Falconsai/LightDec_V2` | Hub repo shown as LightDec_V2 |
+| `REFLUX_LAYA_REPO` | `yasserrmd/enterprise-reflux-laya-v21` | Hub repo shown as Enterprise Reflux Laya V2.1 (a Laya checkpoint) |
 | `LAYA_REPO` | `convaiinnovations/laya` | Laya checkpoint loaded with `laya.load()` |
 | `LAYA_FALLBACK_REPO` | – | Optional second Laya repo, tried if the first fails |
 | `LOAD_ORDER` | comparison order | Which models to load at start, in order, by key (see `/api/status`) |

app/main.py

@@ -27,7 +27,7 @@ MAX_BODY_BYTES = int(os.getenv("MAX_BODY_BYTES", str(256 * 1024)))
 DECIDE_SLOTS = Gate(int(os.getenv("MAX_PENDING_DECIDES", "4")))      # DL-SA-004
 
 # DL-SA-007: no /docs, /redoc or /openapi.json
-VERSION = "2.1.2"
+VERSION = "2.2.0"
 PAGE = stamp_assets((STATIC / "index.html").read_text(encoding="utf-8"), VERSION)
 
 

app/registry.py

@@ -1,8 +1,9 @@
 """Which models DecisionLab compares.
 
-First the operator's three Hugging Face models, in this order (ruling 2026-09-28):
+First the operator's Hugging Face models, in this order (rulings 2026-09-28 and 2026-09-30):
   LightDec_Arthur  Falconsai/LightDec_Arthur  (Arthur; code ships with DecisionLab)
   LightDec_V2      Falconsai/LightDec_V2      (FalconDec; its modeling code must be on the allowlist)
+  Enterprise Reflux Laya V2.1  yasserrmd/enterprise-reflux-laya-v21  (a Laya fine-tune; loaded with laya 0.3.20)
   Laya             convaiinnovations/laya
 Then every model folder found in the models directory, named "... (local)".
 
@@ -83,19 +84,21 @@ def discover(models_dir: str) -> list[tuple[Path, str]]:
 
 
 def model_specs(env: Mapping[str, str]) -> list[dict]:
-    """One dict per model, in the order the UI shows them: the three Hub models, then the models folder."""
+    """One dict per model, in the order the UI shows them: the four Hub models, then the models folder."""
     variant = _variant(env, "LIGHTDEC_VARIANT")
     specs = [
         {"key": "lightdec_arthur", "name": "LightDec_Arthur", "kind": "arthur", "side": PALETTE[0], "source": "hub",
          "repo": env.get("LIGHTDEC_ARTHUR_REPO") or "Falconsai/LightDec_Arthur"},
         {"key": "lightdec_v2", "name": "LightDec_V2", "kind": "lightdec", "side": PALETTE[1], "source": "hub",
          "repo": env.get("LIGHTDEC_V2_REPO") or "Falconsai/LightDec_V2", "revision": None, "variant": variant},
+        {"key": "enterprise_reflux_laya_v21", "name": "Enterprise Reflux Laya V2.1", "kind": "laya", "side": PALETTE[2],
+         "repo": env.get("REFLUX_LAYA_REPO") or "yasserrmd/enterprise-reflux-laya-v21", "fallback_repo": ""},
         {"key": "laya", "name": "Laya", "kind": "laya", "side": "laya",
          "repo": env.get("LAYA_REPO") or "convaiinnovations/laya",
          "fallback_repo": env.get("LAYA_FALLBACK_REPO", "")},
     ]
     used = {s["key"] for s in specs}
-    for i, (folder, kind) in enumerate(discover(env.get("MODELS_DIR") or DEFAULT_MODELS_DIR), start=2):
+    for i, (folder, kind) in enumerate(discover(env.get("MODELS_DIR") or DEFAULT_MODELS_DIR), start=3):
         key, n = _slug(folder.name), 2
         while key in used:
             key, n = f"{_slug(folder.name)}_{n}", n + 1

app/static/index.html

@@ -42,7 +42,7 @@
     <header class="section-head">
       <p class="step">00 / setup</p>
       <h2 data-n-models="{N} models load when the lab starts">Models load when the lab starts</h2>
-      <p class="section-note">The first start downloads LightDec_Arthur, LightDec_V2 and Laya from Hugging Face (about 1.2 GB) into the cache volume. Every LightDec (FalconDec) and Arthur model in the local <code>models</code> folder is found at start-up and loaded from there. Nothing you type leaves this server.</p>
+      <p class="section-note">The first start downloads LightDec_Arthur, LightDec_V2, Enterprise Reflux Laya V2.1 and Laya from Hugging Face (about 2 GB) into the cache volume. Every LightDec (FalconDec) and Arthur model in the local <code>models</code> folder is found at start-up and loaded from there. Nothing you type leaves this server.</p>
       <p class="section-note" id="models-found"></p>
     </header>
     <div class="models" id="models">
@@ -196,6 +196,7 @@
         <h3>The models</h3>
         <p><a href="https://huggingface.co/Falconsai/LightDec_Arthur" target="_blank" rel="noopener noreferrer">LightDec_Arthur</a>: byte-level Arthur model, about 12M parameters; the code that runs it ships with DecisionLab.</p>
         <p><a href="https://huggingface.co/Falconsai/LightDec_V2" target="_blank" rel="noopener noreferrer">LightDec_V2</a>: FalconDec on the Ettin-150M encoder, 2,048-token window, Apache-2.0.</p>
+        <p><a href="https://huggingface.co/yasserrmd/enterprise-reflux-laya-v21" target="_blank" rel="noopener noreferrer">Enterprise Reflux Laya V2.1</a>: a fine-tune of Laya for ranking enterprise actions, by Mohamed Yasser; its model card marks it a research prototype, not for production.</p>
         <p><a href="https://huggingface.co/convaiinnovations/laya" target="_blank" rel="noopener noreferrer">Laya</a>: by Convai Innovations, ModernBERT-large, Apache-2.0.</p>
         <p>Models in the mounted <code>models</code> folder are added after these, marked "(local)": a LightDec folder has a <code>falcondec_config.json</code>, an Arthur folder a <code>config.json</code> and <code>model.safetensors</code>.</p>
         <p>None of the models writes text. Each only ranks the options you give it.</p>

docker-compose.yml

@@ -16,6 +16,7 @@ services:
       # The three Hub models (shown in this order, then any models in ./models, marked "(local)"):
       LIGHTDEC_ARTHUR_REPO: Falconsai/LightDec_Arthur
       LIGHTDEC_V2_REPO: Falconsai/LightDec_V2
+      REFLUX_LAYA_REPO: yasserrmd/enterprise-reflux-laya-v21
       LAYA_REPO: convaiinnovations/laya
       MODELS_DIR: /models               # LightDec and Arthur folders in ./models (mounted below) are added too
       LIGHTDEC_VARIANT: fp16            # fp16 | int8 (compact-int8 folder), for every LightDec model

tests/test_api.py

@@ -29,12 +29,15 @@ class DecideEndpointTest(unittest.TestCase):
         from pathlib import Path
         from app.registry import discover
         st = self.main.status()
-        self.assertEqual(st["order"][:3], ["lightdec_arthur", "lightdec_v2", "laya"])
-        self.assertEqual([st["models"][k]["name"] for k in st["order"][:3]], ["LightDec_Arthur", "LightDec_V2", "Laya"])
-        self.assertEqual([st["models"][k]["repo"] for k in st["order"][:3]],
-                         ["Falconsai/LightDec_Arthur", "Falconsai/LightDec_V2", "convaiinnovations/laya"])
+        hub = ["lightdec_arthur", "lightdec_v2", "enterprise_reflux_laya_v21", "laya"]
+        self.assertEqual(st["order"][:4], hub)
+        self.assertEqual([st["models"][k]["name"] for k in hub],
+                         ["LightDec_Arthur", "LightDec_V2", "Enterprise Reflux Laya V2.1", "Laya"])
+        self.assertEqual([st["models"][k]["repo"] for k in hub],
+                         ["Falconsai/LightDec_Arthur", "Falconsai/LightDec_V2", "yasserrmd/enterprise-reflux-laya-v21",
+                          "convaiinnovations/laya"])
         found = [folder.name for folder, _ in discover(os.environ.get("MODELS_DIR") or "/models")]
-        self.assertEqual([Path(st["models"][k]["path"]).name for k in st["order"][3:]], found)
+        self.assertEqual([Path(st["models"][k]["path"]).name for k in st["order"][4:]], found)
 
     def test_importing_the_app_raises_no_deprecation_warning_of_its_own(self):
         import subprocess

tests/test_links.py

@@ -26,9 +26,10 @@ class ExternalLinksTest(unittest.TestCase):
     def test_links_the_script_builds(self):
         self.check("app.js")
 
-    def test_page_credits_the_three_models(self):
+    def test_page_credits_the_hub_models(self):
         html = (STATIC / "index.html").read_text(encoding="utf-8")
-        for repo in ("Falconsai/LightDec_Arthur", "Falconsai/LightDec_V2", "convaiinnovations/laya"):
+        for repo in ("Falconsai/LightDec_Arthur", "Falconsai/LightDec_V2", "yasserrmd/enterprise-reflux-laya-v21",
+                     "convaiinnovations/laya"):
             with self.subTest(repo=repo):
                 self.assertIn(f'href="https://huggingface.co/{repo}"', html)
         self.assertNotIn("laya-v796", html)

tests/test_registry.py

@@ -6,7 +6,7 @@ from pathlib import Path
 
 from app.registry import load_order, model_specs, resolve_local_dir
 
-HUB_KEYS = ["lightdec_arthur", "lightdec_v2", "laya"]
+HUB_KEYS = ["lightdec_arthur", "lightdec_v2", "enterprise_reflux_laya_v21", "laya"]
 
 
 def folder_models(specs):
@@ -33,16 +33,17 @@ class DiscoveryTest(unittest.TestCase):
         make_model(self.root, "LightDec_V2_Long-v1.0.0", {"name": "LightDec_V2_Long", "version": "1.0.0"})
         make_model(self.root, "LightDec-v1.0.2", {"name": "LightDec", "version": "1.0.2"})
         specs = model_specs(self.env)
-        self.assertEqual([s["key"] for s in specs[:3]], HUB_KEYS)
+        self.assertEqual([s["key"] for s in specs[:4]], HUB_KEYS)
         self.assertEqual([s["path"] for s in folder_models(specs)],
                          [str(self.root / "LightDec-v1.0.2"), str(self.root / "LightDec_V2_Long-v1.0.0")])
-        self.assertEqual(specs[2]["kind"], "laya")
+        self.assertEqual(specs[3]["kind"], "laya")
 
     def test_names_come_from_each_config(self):
         make_model(self.root, "a", {"name": "LightDec", "version": "1.0.2"})
         make_model(self.root, "b", {"name": "LightDec_V2_Long", "version": "1.0.0"})
         self.assertEqual([s["name"] for s in model_specs(self.env)],
-                         ["LightDec_Arthur", "LightDec_V2", "Laya", "LightDec 1.0.2 (local)", "LightDec_V2_Long 1.0.0 (local)"])
+                         ["LightDec_Arthur", "LightDec_V2", "Enterprise Reflux Laya V2.1", "Laya",
+                          "LightDec 1.0.2 (local)", "LightDec_V2_Long 1.0.0 (local)"])
 
     def test_unreadable_config_falls_back_to_the_folder_name(self):
         make_model(self.root, "Broken-Model", raw="{not json")
@@ -72,9 +73,9 @@ class DiscoveryTest(unittest.TestCase):
         for i in range(6):
             make_model(self.root, f"m{i}", {})
         sides = [s["side"] for s in model_specs(self.env)]
-        self.assertEqual(len(sides), 9)
-        self.assertEqual(len(set(sides)), 9)
-        self.assertEqual(sides[2], "laya")
+        self.assertEqual(len(sides), 10)
+        self.assertEqual(len(set(sides)), 9)                                # 8 palette colours + Laya
+        self.assertEqual(sides[3], "laya")
 
     def test_discovered_models_are_local_lightdec_backends(self):
         make_model(self.root, "m", {})
@@ -93,13 +94,13 @@ class DiscoveryTest(unittest.TestCase):
         self.assertEqual(str(ctx.exception), "LIGHTDEC_VARIANT must be fp16 or int8 (got 'fp8').")
 
     def test_laya_settings(self):
-        laya = model_specs(dict(self.env, LAYA_REPO="me/laya", LAYA_FALLBACK_REPO=""))[2]
+        laya = model_specs(dict(self.env, LAYA_REPO="me/laya", LAYA_FALLBACK_REPO=""))[3]
         self.assertEqual((laya["name"], laya["repo"], laya["fallback_repo"]), ("Laya", "me/laya", ""))
-        laya = model_specs(self.env)[2]
+        laya = model_specs(self.env)[3]
         self.assertEqual((laya["repo"], laya["fallback_repo"]), ("convaiinnovations/laya", ""))
 
     def test_default_models_directory_is_slash_models(self):
-        self.assertEqual([s["key"] for s in model_specs({"MODELS_DIR": ""})][:3], HUB_KEYS)   # empty setting falls back to /models
+        self.assertEqual([s["key"] for s in model_specs({"MODELS_DIR": ""})][:4], HUB_KEYS)   # empty setting falls back to /models
 
 
 class LoadOrderTest(unittest.TestCase):
@@ -226,9 +227,9 @@ class ArthurDiscoveryTest(unittest.TestCase):
         self.arthur("arthur-base")
         make_model(self.root, "LightDec-v1.0.2", {"name": "LightDec", "version": "1.0.2"})
         specs = model_specs(self.env)
-        self.assertEqual([(s["key"], s["kind"], s["name"]) for s in specs][3:],
+        self.assertEqual([(s["key"], s["kind"], s["name"]) for s in specs][4:],
                          [("lightdec_v1_0_2", "lightdec", "LightDec 1.0.2 (local)"), ("arthur_base", "arthur", "Arthur base (local)")])
-        self.assertEqual(specs[4]["path"], str(self.root / "arthur-base"))
+        self.assertEqual(specs[5]["path"], str(self.root / "arthur-base"))
 
     def test_pretrained_run_is_named_so(self):
         self.arthur("arthur-base-pt", dict(ARTHUR_CFG, pretrain={"epochs": 1}))
@@ -249,7 +250,7 @@ class ArthurDiscoveryTest(unittest.TestCase):
     def test_colours_continue_across_kinds(self):
         self.arthur("b-arthur")
         make_model(self.root, "a-lightdec", {})
-        self.assertEqual([s["side"] for s in model_specs(self.env)], ["c0", "c1", "laya", "c2", "c3"])
+        self.assertEqual([s["side"] for s in model_specs(self.env)], ["c0", "c1", "c2", "laya", "c3", "c4"])
 
 
 class HubModelsTest(unittest.TestCase):
@@ -262,14 +263,24 @@ class HubModelsTest(unittest.TestCase):
         self.assertEqual([(s["key"], s["name"], s["repo"]) for s in self.specs],
                          [("lightdec_arthur", "LightDec_Arthur", "Falconsai/LightDec_Arthur"),
                           ("lightdec_v2", "LightDec_V2", "Falconsai/LightDec_V2"),
+                          ("enterprise_reflux_laya_v21", "Enterprise Reflux Laya V2.1", "yasserrmd/enterprise-reflux-laya-v21"),
                           ("laya", "Laya", "convaiinnovations/laya")])
 
     def test_kinds_and_sources(self):
         self.assertEqual([(s["kind"], s.get("source")) for s in self.specs],
-                         [("arthur", "hub"), ("lightdec", "hub"), ("laya", None)])
+                         [("arthur", "hub"), ("lightdec", "hub"), ("laya", None), ("laya", None)])
+
+    def test_reflux_is_a_laya_checkpoint_with_no_fallback_and_its_own_colour(self):
+        reflux = self.specs[2]
+        self.assertEqual((reflux["kind"], reflux["fallback_repo"]), ("laya", ""))
+        self.assertEqual(len({s["side"] for s in self.specs}), 4)
+
+    def test_reflux_repo_can_be_overridden(self):
+        specs = model_specs({"MODELS_DIR": "/x", "REFLUX_LAYA_REPO": "me/reflux"})
+        self.assertEqual(specs[2]["repo"], "me/reflux")
 
     def test_laya_has_no_fallback(self):
-        self.assertEqual(self.specs[2]["fallback_repo"], "")
+        self.assertEqual(self.specs[3]["fallback_repo"], "")
 
     def test_hub_repos_can_be_overridden(self):
         specs = model_specs({"MODELS_DIR": "/x", "LIGHTDEC_ARTHUR_REPO": "me/a", "LIGHTDEC_V2_REPO": "me/b"})
@@ -279,7 +290,7 @@ class HubModelsTest(unittest.TestCase):
         with tempfile.TemporaryDirectory() as d:
             make_model(Path(d), "LightDec_V2", {"name": "LightDec_V2_Long", "version": "1.0.0"})
             specs = model_specs({"MODELS_DIR": d})
-        self.assertEqual([(s["key"], s["name"]) for s in specs][3:], [("lightdec_v2_2", "LightDec_V2_Long 1.0.0 (local)")])
+        self.assertEqual([(s["key"], s["name"]) for s in specs][4:], [("lightdec_v2_2", "LightDec_V2_Long 1.0.0 (local)")])
 
 
 from app.registry import warmup_enabled