Skip to content

HarnessRouter Community Edition: the self-hosted, Apache-2.0 edition of the unified interface for agent harnesses. Run Codex, Claude Code, Hermes, PI, DSH, and more through one API, with sessions, streaming, files, cancellation, and failure handling. Implements the Unified Harness Protocol (UHP), an open standard. Your keys, your infrastructure.

docs(tests): a red local gateway run is an environment gap, not a broken branch

richard-epsillaee74325809a5
diff --git a/gateway/tests/test_pricing_visibility.py b/gateway/tests/test_pricing_visibility.py
index 877e18bb..be30de2a 100644
--- a/gateway/tests/test_pricing_visibility.py
+++ b/gateway/tests/test_pricing_visibility.py
@@ -4,6 +4,12 @@ On the hosted deployment the price endpoint refused with 403 for months. The ref
as "keep the stale table", the table had never been populated, every _price_of() answered 0.0, and
the console showed 0 credits per session while the harvest billed the real amount. Nothing looked
broken anywhere. These pin the three states apart.
+
+NOTE ON RUNNING THESE: gateway tests import app.py, which needs hashlib.scrypt. macOS system
+python does not have it, so a local run here fails at COLLECTION with an AttributeError that has
+nothing to do with the code under test. Run them in a container (docker exec <c> sh -lc 'cd
+/app/gateway && python3 -m pytest') or let CI be the gate — CI pins the interpreter this tree
+targets. A red local run is not evidence of a broken branch.
"""
import pathlib
import sys
diff --git a/gateway/tests/test_servable_models.py b/gateway/tests/test_servable_models.py
index e4ec1a9f..ddc6ab6f 100644
--- a/gateway/tests/test_servable_models.py
+++ b/gateway/tests/test_servable_models.py
@@ -8,6 +8,12 @@ provider-level rather than per-model. The vendor tables ARE per-model and delibe
Both halves of the union below are load-bearing, and each was learned by breaking it:
* chain only — greys out models an org runs daily through an explicit integration mapping.
* map only — the original bug: a chain-served org gets its entire catalog offered.
+
+NOTE ON RUNNING THESE: gateway tests import app.py, which needs hashlib.scrypt. macOS system
+python does not have it, so a local run here fails at COLLECTION with an AttributeError that has
+nothing to do with the code under test. Run them in a container (docker exec <c> sh -lc 'cd
+/app/gateway && python3 -m pytest') or let CI be the gate — CI pins the interpreter this tree
+targets. A red local run is not evidence of a broken branch.
"""
import pathlib
import sys
diff --git a/gateway/tests/test_session_file_fallback.py b/gateway/tests/test_session_file_fallback.py
index 9e2c737e..197aa218 100644
--- a/gateway/tests/test_session_file_fallback.py
+++ b/gateway/tests/test_session_file_fallback.py
@@ -6,6 +6,12 @@ by-path route read only the live directory, so one session could LIST dashboard.
the same breath — and the dashboard kit, which fetches by path, told the user "no dashboard has
been built for this conversation" about a dashboard that existed. Seen live on a 12-day-old
session on the public VM.
+
+NOTE ON RUNNING THESE: gateway tests import app.py, which needs hashlib.scrypt. macOS system
+python does not have it, so a local run here fails at COLLECTION with an AttributeError that has
+nothing to do with the code under test. Run them in a container (docker exec <c> sh -lc 'cd
+/app/gateway && python3 -m pytest') or let CI be the gate — CI pins the interpreter this tree
+targets. A red local run is not evidence of a broken branch.
"""
import pathlib
import sys