luisleo526 · Oct 10, 2026 · Oct 10, 2026 · Oct 10, 2026 · Oct 10, 2026 · Oct 10, 2026
diff --git a/.github/workflows/gate.yml b/.github/workflows/gate.yml
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
@@ -63,15 +63,17 @@ jobs:
             echo 'docs_only=false' >> "$GITHUB_OUTPUT"
           fi
 
+  # Engine-less job. It runs a SINGLE interpreter: the skip gate's `default`
+  # allowance counts were measured on python 3.12, and a count that moves with
+  # the interpreter would make the gate's drift signal meaningless.
+  # The engine-building twin of this job lives in gate.yml, where the blocking
+  # aggregation can `needs:` it (a `needs:` cannot name a job in another
+  # workflow); it is not run here.
   pytest:
     needs: preflight-docs
     if: needs.preflight-docs.outputs.docs_only != 'true'
     runs-on: ubuntu-latest
     timeout-minutes: 30
-    strategy:
-      fail-fast: false
-      matrix:
-        python-version: ["3.11", "3.12", "3.13", "3.14"]
     env:
       PYTHONHASHSEED: "0"
     steps:
@@ -82,8 +84,23 @@ jobs:
           persist-credentials: false
       - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065
         with:
-          python-version: ${{ matrix.python-version }}
+          python-version: "3.12"
       - name: Install with dev extras
         run: python -m pip install -e ".[dev]"
-      - name: Run test suite
-        run: python -m pytest -q
+      - name: Assert the compile-environment skip gate is enabled
+        run: |
+          python - <<'PY'
+          import os
+          import sys
+          value = os.environ.get("PINEFORGE_SKIP_GATE", "").strip().lower()
+          if value == "off":
+              sys.stderr.write("PINEFORGE_SKIP_GATE=off is not allowed in CI: the skip gate must run\n")
+              sys.exit(1)
+          PY
+      - name: "Run test suite (single interpreter: the default allowance was measured on 3.12)"
+        run: |
+          set -eo pipefail
+          python -m pytest -q -rs 2>&1 | tee pytest.log
+          # Anchored to line start: the gate emits a leading empty line, since
+          # pytest's -q progress line (".....[100%]") can lack a trailing newline.
+          grep -q '^skip gate OK (default-deny)' pytest.log
diff --git a/tests/ci_env_skip_allowance.json b/tests/ci_env_skip_allowance.json
diff --git a/tests/conftest.py b/tests/conftest.py
@@ -0,0 +1,22 @@
+"""pytest configuration for the pineforge-codegen test suite.
+
+Loads the compile-environment skip gate (:mod:`tests.skip_gate`), which fails
+the session at the end when a skipped test's exact reason is not listed in
+``tests/ci_env_skip_allowance.json`` (or its count differs).  Without this a
+machine with no engine library, Eigen or clang skips every test that compiles
+an emitted translation unit, pytest exits 0, and the suite looks green while a
+third of it never ran.
+
+The gate is ON by default; ``PINEFORGE_SKIP_GATE=off`` disables it, and the CI
+workflow asserts that the variable is not set, so the gate cannot be turned off
+silently.
+"""
+
+from __future__ import annotations
+
+from tests import skip_gate
+
+# Re-exported so pytest registers the session-end hook from this conftest.
+from tests.skip_gate import pytest_sessionfinish  # noqa: F401
+
+__all__ = ["pytest_sessionfinish", "skip_gate"]
diff --git a/tests/gate-corpus/ok/validation__order-process-on-close-false-01.pine b/tests/gate-corpus/ok/validation__order-process-on-close-false-01.pine
@@ -14,7 +14,7 @@
 // exit on EMA cross-under. ≥10 cycles over 36k bars.
 //
 // TV setup: 15m chart, ETH-USDT-USDT, same window as
-// data/ohlcv_ETH-USDT-USDT_15m.csv. Manual TV capture later.
+// data/ohlcv_ETH-USDT-USDT_15m.csv. TradingView strategy report for this window.
 //@version=6
 strategy("PF process-orders 01 - on_close=false", shorttitle="POC_p01_FALSE", overlay=true,
      initial_capital=1000000, currency=currency.USD,

diff --git a/tests/gate-corpus/ok/validation__order-process-on-close-true-01.pine b/tests/gate-corpus/ok/validation__order-process-on-close-true-01.pine
@@ -15,7 +15,7 @@
 // bars.
 //
 // TV setup: 15m chart, ETH-USDT-USDT, same window as
-// data/ohlcv_ETH-USDT-USDT_15m.csv. Manual TV capture later.
+// data/ohlcv_ETH-USDT-USDT_15m.csv. TradingView strategy report for this window.
 //@version=6
 strategy("PF process-orders 02 - on_close=true", shorttitle="POC_p02_TRUE", overlay=true,
      initial_capital=1000000, currency=currency.USD,

diff --git a/tests/gate-corpus/ok/validation__pyramid-cash-fractional-commission-01.pine b/tests/gate-corpus/ok/validation__pyramid-cash-fractional-commission-01.pine
@@ -16,7 +16,7 @@
 // (hour==23, minute==45) closes all. ≥10 cycles over 36k bars.
 //
 // TV setup: 15m chart, ETH-USDT-USDT, same window as
-// data/ohlcv_ETH-USDT-USDT_15m.csv. Manual TV capture later.
+// data/ohlcv_ETH-USDT-USDT_15m.csv. TradingView strategy report for this window.
 //@version=6
 strategy("PF Pyramid carry 02 - cash fractional", shorttitle="PYR_p02_CASH", overlay=true,
      initial_capital=1000000, currency=currency.USD,

diff --git a/tests/gate-corpus/ok/validation__pyramid-deferred-flip-close-all-01.pine b/tests/gate-corpus/ok/validation__pyramid-deferred-flip-close-all-01.pine
@@ -18,7 +18,7 @@
 // next bar after the flat reset.
 //
 // TV setup: 15m chart, ETH-USDT-USDT, same window as
-// data/ohlcv_ETH-USDT-USDT_15m.csv. Manual TV capture later.
+// data/ohlcv_ETH-USDT-USDT_15m.csv. TradingView strategy report for this window.
 //@version=6
 strategy("PF Pyramid carry 01 - deferred flip", shorttitle="PYR_p01_FLIP", overlay=true,
      initial_capital=1000000, currency=currency.USD,