Iteration 41: align parent source pins with base, CTP and Gateway

.github/workflows/docs.yml

@@ -16,6 +16,7 @@ on:
       - 'bt_api_py/**'
       - 'scripts/generate_exchange_support_docs.py'
       - 'scripts/ci/check_docs_contract.py'
+      - 'scripts/ci/base_source_pin.py'
   pull_request:
     paths:
       - 'docs/**'
@@ -30,6 +31,7 @@ on:
       - 'bt_api_py/**'
       - 'scripts/generate_exchange_support_docs.py'
       - 'scripts/ci/check_docs_contract.py'
+      - 'scripts/ci/base_source_pin.py'
   workflow_dispatch:
 
 permissions:
@@ -47,6 +49,9 @@ jobs:
         with:
           fetch-depth: 0
 
+      - name: Checkout pinned base source
+        run: git submodule update --init --depth 1 -- bt_api/bt_api_base
+
       - uses: actions/setup-python@v6
         with:
           python-version: '3.11'
@@ -58,9 +63,17 @@ jobs:
       - name: Install doc dependencies
         run: python -m pip install --upgrade pip -r docs/requirements.txt
 
+      - name: Build and install parent-pinned base wheel
+        run: >-
+          python scripts/ci/base_source_pin.py
+          --wheel-dir "${{ runner.temp }}/bt_api_base_wheelhouse"
+
       - name: Install package (needed by mkdocstrings)
         run: python -m pip install -e .
 
+      - name: Check installed dependencies
+        run: python -m pip check
+
       - name: Check generated docs are current
         run: python scripts/generate_exchange_support_docs.py --check
 

.github/workflows/reusable-compat-matrix.yml

@@ -35,12 +35,20 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
+      - name: Checkout pinned base source
+        run: git submodule update --init --depth 1 -- bt_api/bt_api_base
+
       - uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
           cache: pip
           cache-dependency-path: pyproject.toml
 
+      - name: Build and install parent-pinned base wheel
+        run: >-
+          python scripts/ci/base_source_pin.py
+          --wheel-dir "${{ runner.temp }}/bt_api_base_wheelhouse"
+
       - name: Install build tools (Linux)
         if: runner.os == 'Linux'
         run: sudo apt-get update && sudo apt-get install -y build-essential
@@ -50,6 +58,9 @@ jobs:
           python -m pip install --upgrade pip
           pip install -e ".[dev]"
 
+      - name: Check installed dependencies
+        run: python -m pip check
+
       - name: Run cross-platform compatibility smoke suite
         env:
           SKIP_LIVE_TESTS: "true"

.github/workflows/tests.yml

@@ -45,12 +45,20 @@ jobs:
           cache: pip
           cache-dependency-path: pyproject.toml
 
+      - name: Build and install parent-pinned base wheel
+        run: >-
+          python scripts/ci/base_source_pin.py
+          --wheel-dir "${{ runner.temp }}/bt_api_base_wheelhouse"
+
       - name: Install package + quality tools
         run: |
           python -m pip install --upgrade pip
           pip install -e ".[dev]"
           pip install bandit pip-audit
 
+      - name: Check installed dependencies
+        run: python -m pip check
+
       - name: Ruff lint check
         run: ruff check bt_api_py tests --output-format=github
 
@@ -159,8 +167,6 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 45
     needs: quality
-    env:
-      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
 
     defaults:
       run:
@@ -177,15 +183,38 @@ jobs:
           cache: pip
           cache-dependency-path: pyproject.toml
 
+      - name: Build and install parent-pinned base wheel
+        run: >-
+          python scripts/ci/base_source_pin.py
+          --wheel-dir "${{ runner.temp }}/bt_api_base_wheelhouse"
+          --github-env "$GITHUB_ENV"
+
       - name: Install build tools
         run: sudo apt-get update && sudo apt-get install -y build-essential
 
+      - name: Build and install parent-pinned CTP source wheel
+        run: >-
+          python scripts/ci/ctp_source_pin.py
+          --wheel-dir "${{ runner.temp }}/bt_api_ctp_wheelhouse"
+          --github-env "$GITHUB_ENV"
+
       - name: Install package + dev deps
         run: |
           python -m pip install --upgrade pip
           # Unmarked contract cases exercise the declared reference adapters.
           pip install -e ".[dev,security,core-reference]" -r requirements-ci-core-reference.txt
 
+      - name: Verify parent-pinned CTP wheel receipt
+        run: python scripts/ci/ctp_source_pin.py --verify-installed
+
+      - name: Check installed dependencies
+        run: python -m pip check
+
+      - name: Check CTP native extension load
+        run: >-
+          python -c "from bt_api_ctp.ctp._ctp_base import get_ctp_import_error,
+          is_ctp_native_loaded; assert is_ctp_native_loaded(), get_ctp_import_error()"
+
       - name: Run baseline suite with coverage gate
         env:
           SKIP_LIVE_TESTS: "true"
@@ -229,8 +258,13 @@ jobs:
           test -s htmlcov/index.html
 
       - name: Upload coverage to Codecov
-        if: always() && env.CODECOV_TOKEN != ''
+        if: >-
+          always() &&
+          (github.event_name != 'pull_request' ||
+          github.event.pull_request.head.repo.full_name == github.repository)
         uses: codecov/codecov-action@v6
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           files: ./coverage-full.xml
@@ -258,6 +292,9 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
+      - name: Checkout parent-pinned base source
+        run: git submodule update --init --depth 1 -- bt_api/bt_api_base
+
       - uses: actions/setup-python@v6
         with:
           python-version: "3.11"

bt_api_py/configs/exchange-bundles.toml

@@ -29,5 +29,5 @@ certification = "experimental"
 package = "bt_api_ctp"
 plugin = "ctp"
 exchange = "CTP___FUTURE"
-min_version = "2.0.2"
+min_version = "2.0.3"
 certification = "experimental"

bt_api_py/forwarding/router.py

@@ -24,9 +24,7 @@
 _VALID_SIDES = frozenset({"buy", "sell"})
 _VALID_ORDER_TYPES = frozenset({"limit", "market"})
 _MAX_CACHED_ACKS = 10_000
-_TRADING_DISABLED_REASON = (
-    "forwarding trading is disabled; provider write was not attempted"
-)
+_TRADING_DISABLED_REASON = "forwarding trading is disabled; provider write was not attempted"
 
 
 @dataclass(frozen=True)

docs/acceptance/2026-09-19-quality-ratchet.json

@@ -1,6 +1,6 @@
 {
   "schema_version": 1,
-  "generated_at": "2026-09-19T17:21:53.591707+00:00",
+  "generated_at": "2026-09-28T14:02:47.687472+00:00",
   "ruff_version": "ruff 0.16.2",
   "scope": [
     "bt_api_py",
@@ -15,13 +15,16 @@
     "bt_api/bt_api_ctp/src",
     "bt_api/bt_api_dydx/src",
     "bt_api/bt_api_gateio/src",
+    "bt_api/bt_api_gateway/src",
     "bt_api/bt_api_htx/src",
     "bt_api/bt_api_hyperliquid/src",
     "bt_api/bt_api_ib_web/src",
     "bt_api/bt_api_kraken/src",
     "bt_api/bt_api_mexc/src",
+    "bt_api/bt_api_monitor/src",
     "bt_api/bt_api_mt5/src",
     "bt_api/bt_api_okx/src",
+    "bt_api/bt_api_risk/src",
     "bt_api/bt_api_base/tests",
     "bt_api/bt_api_binance/tests",
     "bt_api/bt_api_bitget/tests",
@@ -30,13 +33,16 @@
     "bt_api/bt_api_ctp/tests",
     "bt_api/bt_api_dydx/tests",
     "bt_api/bt_api_gateio/tests",
+    "bt_api/bt_api_gateway/tests",
     "bt_api/bt_api_htx/tests",
     "bt_api/bt_api_hyperliquid/tests",
     "bt_api/bt_api_ib_web/tests",
     "bt_api/bt_api_kraken/tests",
     "bt_api/bt_api_mexc/tests",
+    "bt_api/bt_api_monitor/tests",
     "bt_api/bt_api_mt5/tests",
-    "bt_api/bt_api_okx/tests"
+    "bt_api/bt_api_okx/tests",
+    "bt_api/bt_api_risk/tests"
   ],
   "ruff": {
     "total": 10,

docs/acceptance/2026-09-20-format-ratchet.json

@@ -14,14 +14,18 @@
     "bt_api_coinbase",
     "bt_api_ctp",
     "bt_api_dydx",
+    "bt_api_execution",
     "bt_api_gateio",
+    "bt_api_gateway",
     "bt_api_htx",
     "bt_api_hyperliquid",
     "bt_api_ib_web",
     "bt_api_kraken",
     "bt_api_mexc",
+    "bt_api_monitor",
     "bt_api_mt5",
-    "bt_api_okx"
+    "bt_api_okx",
+    "bt_api_risk"
   ],
   "format": {
     "total": 451,
@@ -33,14 +37,18 @@
       "bt_api_coinbase": 23,
       "bt_api_ctp": 25,
       "bt_api_dydx": 20,
+      "bt_api_execution": 0,
       "bt_api_gateio": 25,
+      "bt_api_gateway": 0,
       "bt_api_htx": 23,
       "bt_api_hyperliquid": 23,
       "bt_api_ib_web": 40,
       "bt_api_kraken": 7,
       "bt_api_mexc": 12,
+      "bt_api_monitor": 0,
       "bt_api_mt5": 7,
-      "bt_api_okx": 85
+      "bt_api_okx": 85,
+      "bt_api_risk": 0
     }
   },
   "notes": "Submodule format ratchet baseline. Per-module counts may only decrease; use --update after improvements or --force-update for an intentional rebaseline."

pyproject.toml

@@ -13,7 +13,7 @@ authors = [
     {name = "cloudQuant", email = "yunjinqi@gmail.com"},
 ]
 dependencies = [
-    "bt_api_base>=0.15.4",
+    "bt_api_base>=0.15.5",
     "numpy>=1.26.0",
     "python-dotenv>=1.0.0",
     "requests>=2.31.0",
@@ -303,5 +303,5 @@ all = [
 ]
 core-reference = [
     "bt_api_binance>=2.0.0",
-    "bt_api_ctp>=2.0.2,<3.0",
+    "bt_api_ctp>=2.0.3,<3.0",
 ]