explorer + ci: V2 strength GP web hookup + artifact / parity gates

Hooks the V2 strength GP up to the in-browser BOxCrete explorer and
wires up the CI gates that enforce coherence between the deployed
boxcrete model and the published model artifacts.

JS-side V2 implementation (docs/explorer):

  * docs/gp_v2_fast.mjs — pure-JS implementation of the V2 gated-kernel
    posterior, optimised for the in-browser explorer.
  * docs/feature_registry.mjs — JS port of the F5_alllog feature
    builders to keep the JS path byte-identical to the Python path.
  * docs/gp.mjs / docs/ui.mjs / docs/units.mjs — explorer integration.
  * docs/generate_mix_analyses.py — produces per-mix analysis pages
    consumed by the explorer.
  * docs/model/README.md — documents the docs/model/ artifact layout.
  * docs/model/strength.json + compositions.json + test_vectors.json —
    refreshed model artifacts produced by the V2 fit.

CI gates:

  * .github/workflows/strength-parity.yml — runs
    test_pretrained_loader_fidelity.py to guard that
    load_pretrained_strength_gp() faithfully reconstructs the deployed
    V2 strength GP from docs/model/strength_model.pt.
  * .github/workflows/model-artifacts-coherence.yml — guards that the
    published docs/model/ artifacts match the boxcrete fit output
    (catches stale artifacts after model code changes). Uses a
    cross-architecture-portable numerical drift check
    (experiments/check_artifacts_drift.py) instead of byte-level
    git diff.
  * .github/workflows/notebooks.yml + tests.yml — Python version
    bumps to match pyproject.toml's requires-python = ">=3.11" and
    BOXCRETE_SMOKE_TEST=1 env wiring for the notebook matrix.

Regen pipeline (invoked by the artifacts-coherence gate):

  * experiments/regenerate_all_artifacts.sh — orchestrator.
  * experiments/regenerate_strength_json.py — Python regen of
    strength.json + test_vectors.json from a fresh V2 fit.
  * experiments/augment_test_vectors_with_gwp_cost.mjs — adds GWP /
    cost columns via the JS predictors.
  * experiments/regenerate_compositions_strength_predictions.mjs —
    regen of the static Pareto scatter dots.

CI helpers:

  * experiments/check_artifacts_drift.py — numerical drift check.
  * experiments/run_notebook_with_progress.py — cell-by-cell timing
    helper used as a fast-fail step before nbconvert.
  * experiments/measure_fit_stability.py — empirical run-to-run fit
    determinism measurement (used during precision debugging).

JS-side regression tests:

  * test/test_js_strength_v2.mjs — V2 posterior parity (Python vs JS).
  * test/test_js_physical_constraints.mjs — JS-side f(x, t=0) = 0 guard.
  * test/test_lengthscales_v2.mjs — JS-side lengthscale parity.
  * test/test_curve_monotonicity.mjs — strength-curve monotonicity.
  * test/test_data_freshness.mjs — guards that test_vectors.json is
    derived from the same data the deployed model was fit on.
  * test/test_js_ui_smoke.mjs — explorer UI smoke test.

Author: SebastianAment

.github/workflows/e2e.yml

@@ -6,15 +6,15 @@ name: E2E (Playwright)
 
 on:
   push:
-    branches: [main]
+    branches: [main, master]
     paths:
       - 'docs/**'
       - 'test/e2e/**'
       - 'playwright.config.ts'
       - 'package.json'
       - '.github/workflows/e2e.yml'
   pull_request:
-    branches: [main]
+    branches: [main, master]
     paths:
       - 'docs/**'
       - 'test/e2e/**'
@@ -46,7 +46,7 @@ jobs:
         project: [desktop, mobile]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - uses: actions/setup-node@v4
         with:
@@ -58,7 +58,7 @@ jobs:
 
       - name: Cache Playwright browsers
         id: pw-cache
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: ~/.cache/ms-playwright
           key: playwright-${{ runner.os }}-${{ hashFiles('package-lock.json') }}

.github/workflows/js-sync.yml

@@ -1,5 +1,12 @@
-# Verifies that the JavaScript GP implementation matches Python reference predictions.
-# Catches drift if model parameters or JS code are changed without re-syncing.
+# Runs the full JS-side test suite that pairs with the Python boxcrete
+# package: Python ↔ JS predictor parity, V2 posterior parity, JS-side
+# physical-constraint guards, lengthscale parity, curve monotonicity,
+# data-freshness check, units, and explorer UI smoke.
+#
+# Catches drift between the Python fit (boxcrete) and the in-browser
+# JavaScript GP (docs/gp*.mjs + docs/model/*.json artifacts) — if the
+# model, JS code, or model artifacts change without re-syncing the JS
+# port and the test_vectors.json baseline, this workflow fails.
 
 name: JS Model Sync
 
@@ -14,14 +21,42 @@ on:
     branches: [main, master]
     paths:
       - 'docs/gp.mjs'
+      - 'docs/gp_v2_fast.mjs'
+      - 'docs/feature_registry.mjs'
+      - 'docs/units.mjs'
       - 'docs/model/**'
       - 'test/test_js_gp.mjs'
+      - 'test/test_js_strength_v2.mjs'
+      - 'test/test_js_predictor_parity.mjs'
+      - 'test/test_js_physical_constraints.mjs'
+      - 'test/test_js_ui_smoke.mjs'
+      - 'test/test_js_units.mjs'
+      - 'test/test_lengthscales_v2.mjs'
+      - 'test/test_js_feature_parity.mjs'
+      - 'test/fixtures/feature_parity_fixture.json'
+      - 'test/test_curve_monotonicity.mjs'
+      - 'test/test_data_freshness.mjs'
+      - '.github/workflows/js-sync.yml'
   pull_request:
     branches: [main, master]
     paths:
       - 'docs/gp.mjs'
+      - 'docs/gp_v2_fast.mjs'
+      - 'docs/feature_registry.mjs'
+      - 'docs/units.mjs'
       - 'docs/model/**'
       - 'test/test_js_gp.mjs'
+      - 'test/test_js_strength_v2.mjs'
+      - 'test/test_js_predictor_parity.mjs'
+      - 'test/test_js_physical_constraints.mjs'
+      - 'test/test_js_ui_smoke.mjs'
+      - 'test/test_js_units.mjs'
+      - 'test/test_lengthscales_v2.mjs'
+      - 'test/test_js_feature_parity.mjs'
+      - 'test/fixtures/feature_parity_fixture.json'
+      - 'test/test_curve_monotonicity.mjs'
+      - 'test/test_data_freshness.mjs'
+      - '.github/workflows/js-sync.yml'
 
 env:
   FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
@@ -30,11 +65,41 @@ jobs:
   js-model-sync:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - uses: actions/setup-node@v4
         with:
           node-version: '20'
 
-      - name: Run JS GP sync test
+      # Run each JS test individually rather than via a globbing wrapper
+      # so a single test failure surfaces with its own step in the CI UI
+      # (easy to skim "which test broke" without scrolling logs).
+      - name: Python ↔ JS GP equivalence (test_vectors.json)
         run: node test/test_js_gp.mjs
+
+      - name: JS ↔ Python feature builder parity
+        run: node test/test_js_feature_parity.mjs
+
+      - name: V2 posterior parity (Python vs JS)
+        run: node test/test_js_strength_v2.mjs
+
+      - name: Single-vs-batch JS predictor contract
+        run: node test/test_js_predictor_parity.mjs
+
+      - name: JS-side f(x, t=0) = 0 physical-constraint guard
+        run: node test/test_js_physical_constraints.mjs
+
+      - name: Explorer UI smoke
+        run: node test/test_js_ui_smoke.mjs
+
+      - name: JS unit conversions
+        run: node test/test_js_units.mjs
+
+      - name: JS-side lengthscale parity / identifiability
+        run: node test/test_lengthscales_v2.mjs
+
+      - name: JS-side strength-curve monotonicity
+        run: node test/test_curve_monotonicity.mjs
+
+      - name: Data-freshness (compositions.json vs live JS GP)
+        run: node test/test_data_freshness.mjs

.github/workflows/lighthouse.yml

@@ -6,13 +6,13 @@ name: Lighthouse CI
 
 on:
   push:
-    branches: [main]
+    branches: [main, master]
     paths:
       - 'docs/**'
       - 'lighthouserc.json'
       - '.github/workflows/lighthouse.yml'
   pull_request:
-    branches: [main]
+    branches: [main, master]
     paths:
       - 'docs/**'
       - 'lighthouserc.json'
@@ -31,7 +31,7 @@ jobs:
     timeout-minutes: 15
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - uses: actions/setup-node@v4
         with:

.github/workflows/model-artifacts-coherence.yml

@@ -0,0 +1,111 @@
+# Verifies that docs/model/*.json artifacts are coherent with the
+# Python V2 strength GP fit. Runs the regen pipeline and asserts no
+# diff — any uncommitted drift in strength.json / test_vectors.json /
+# compositions.json (e.g., from a manual edit, a partial regen, or
+# upstream model code that wasn't followed by a regen run) fails CI.
+#
+# See docs/model/README.md for the artifact schema + regen workflow.
+
+name: Model Artifacts Coherence
+
+permissions:
+  contents: read
+
+on:
+  push:
+    branches: [main, master]
+    paths:
+      - 'boxcrete/strength_model.py'
+      - 'boxcrete/kernels.py'
+      - 'boxcrete/likelihoods.py'
+      - 'boxcrete/priors.py'
+      - 'boxcrete/features.py'
+      - 'boxcrete/utils.py'
+      - 'boxcrete/__init__.py'
+      - 'data/**'
+      - 'experiments/regenerate_strength_json.py'
+      - 'experiments/regenerate_compositions_strength_predictions.mjs'
+      - 'experiments/augment_test_vectors_with_gwp_cost.mjs'
+      - 'experiments/regenerate_all_artifacts.sh'
+      - 'docs/model/**'
+      - 'docs/feature_registry.mjs'
+      - 'docs/gp.mjs'
+      - 'docs/gp_v2_fast.mjs'
+      - '.github/workflows/model-artifacts-coherence.yml'
+  pull_request:
+    branches: [main, master]
+    paths:
+      - 'boxcrete/strength_model.py'
+      - 'boxcrete/kernels.py'
+      - 'boxcrete/likelihoods.py'
+      - 'boxcrete/priors.py'
+      - 'boxcrete/features.py'
+      - 'boxcrete/utils.py'
+      - 'boxcrete/__init__.py'
+      - 'data/**'
+      - 'experiments/regenerate_strength_json.py'
+      - 'experiments/regenerate_compositions_strength_predictions.mjs'
+      - 'experiments/augment_test_vectors_with_gwp_cost.mjs'
+      - 'experiments/regenerate_all_artifacts.sh'
+      - 'docs/model/**'
+      - 'docs/feature_registry.mjs'
+      - 'docs/gp.mjs'
+      - 'docs/gp_v2_fast.mjs'
+      - '.github/workflows/model-artifacts-coherence.yml'
+  workflow_dispatch: {}
+
+jobs:
+  regen-idempotency:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: '3.12'
+          cache: 'pip'
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install Python deps
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .
+
+      - name: Save committed docs/model/ for later comparison
+        # Snapshot the JSON artifacts BEFORE regen overwrites them, so
+        # the post-regen comparison can diff against the committed copy.
+        # We snapshot only the JSONs (not the .pt) because cross-arch
+        # determinism on binary state_dicts requires bit-equality which
+        # we can't expect from a multi-modal MLL fit; the JSON-level
+        # checks cover the same coverage surface (lengthscales +
+        # prediction surface) via experiments/check_artifacts_drift.py.
+        run: |
+          mkdir -p /tmp/committed_docs_model
+          cp docs/model/strength.json /tmp/committed_docs_model/
+          cp docs/model/test_vectors.json /tmp/committed_docs_model/
+          cp docs/model/compositions.json /tmp/committed_docs_model/
+
+      - name: Run regen pipeline
+        run: bash experiments/regenerate_all_artifacts.sh
+
+      - name: Assert artifacts agree with committed copy within tolerance
+        # Replaces the legacy ``git diff --exit-code docs/model/`` check,
+        # which was over-strict: it required bit-equality of JSON output
+        # across architectures, but the V2 strength GP fit goes through
+        # scipy's L-BFGS-B against a multi-modal MLL surface, and
+        # different CPU architectures land in different local optima
+        # (Apple Silicon via qemu-emulated amd64 vs GitHub-runner native
+        # x86_64 produce ~2x different lengthscales while predicting
+        # nearly the same surface). The new check tolerates this
+        # cross-architecture basin divergence (10x ratio band on
+        # internal hyperparameters) while still catching the original
+        # failure mode (a stale export typically shifts predictions
+        # by 100s of psi at OOT compositions). See the docstring of
+        # ``experiments/check_artifacts_drift.py`` for the full rationale.
+        run: |
+          python experiments/check_artifacts_drift.py \
+            --committed-dir /tmp/committed_docs_model \
+            --fresh-dir docs/model