quantbt-engine 1.0.8__tar.gz → 1.1.0__tar.gz

{quantbt_engine-1.0.8 → quantbt_engine-1.1.0}/CHANGELOG.md

@@ -2,6 +2,53 @@
 
 All notable changes to `quantbt-engine` are documented here.
 
+## [1.1.0] - Unreleased
+
+### Changed
+
+- Renamed the governed public release line to `1.1.0` and synchronized package
+  metadata, runtime version, generated core/native contracts, lockfile, and
+  release documentation.
+- Prepared the governed public `quantbt-native==0.4.1` companion contract for
+  Linux x86_64 / CPython 3.11-3.13. The core declares an exact,
+  platform-marked dependency; unsupported platforms keep Python/Numba.
+- Added a native-first, wheel-only manylinux OIDC release workflow and a six-row
+  Ubuntu 22.04/24.04 Poetry consumer proof. The core release preflights the
+  matching public native artifact before it can publish.
+- Kept public release certification self-contained by excluding private,
+  out-of-tree Grid integration fixtures from its test shard profile.
+- Updated release, install, capability, troubleshooting, and handoff docs to
+  state that supported users receive a pre-built wheel rather than compiling
+  Rust locally.
+
+### Compatibility
+
+- No endpoint signature, execution policy, promotion threshold, or domain
+  accounting behavior changes in this packaging-only phase.
+
+## [1.0.9] - 2026-08-21
+
+### Added
+
+- Direct PyPI discovery and installation guidance in the repository README.
+- Release-preparation guidance for the governed Rust-first routes, exact
+  installed-wheel certification, and the matching core/native compatibility
+  contract.
+
+### Changed
+
+- Promoted the bounded Rust-first public policy for certified static command
+  tapes, Native Strategy IR, batch, and causal-fold workloads while preserving
+  Python authority for callbacks, reactive strategies, generic portfolio,
+  basket, arbitrage, and options routes.
+- Updated the core product registry to the `1.0.9` release line. The staged
+  `quantbt-native` companion remains unpublished and capability-gated.
+
+### Verification
+
+- Source-mirror, generated-product-contract, documentation-link, build, and
+  installed-wheel release checks are required from the final tagged commit.
+
 ## [1.0.8] - 2026-08-12
 
 ### Changed

{quantbt_engine-1.0.8/src/quantbt_engine.egg-info → quantbt_engine-1.1.0}/PKG-INFO

@@ -1,10 +1,11 @@
 Metadata-Version: 2.4
 Name: quantbt-engine
-Version: 1.0.8
+Version: 1.1.0
 Summary: Transparent, high-performance quantitative backtesting engine
 Author-email: Vu Cong Minh <vugioan11022002@gmail.com>
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/BobbyAxerol/quantbt
+Project-URL: PyPI, https://pypi.org/project/quantbt-engine/
 Project-URL: Repository, https://github.com/BobbyAxerol/quantbt
 Project-URL: Issues, https://github.com/BobbyAxerol/quantbt/issues
 Project-URL: Documentation, https://github.com/BobbyAxerol/quantbt/tree/main/docs
@@ -26,6 +27,7 @@ License-File: LICENSE
 Requires-Dist: numpy<2.3,>=2.2.6
 Requires-Dist: pandas<2.4,>=2.3.3
 Requires-Dist: numba<0.66,>=0.65.1
+Requires-Dist: quantbt-native==0.4.1; sys_platform == "linux" and platform_machine == "x86_64" and implementation_name == "cpython" and python_version >= "3.11" and python_version < "3.14"
 Provides-Extra: optimization
 Requires-Dist: optuna<4.9,>=4.8.0; extra == "optimization"
 Requires-Dist: arch<8.1,>=8.0.0; extra == "optimization"
@@ -51,6 +53,7 @@ Dynamic: license-file
 # QuantBT
 
 ![Python](https://img.shields.io/badge/python-3.11%2B-blue)
+[![PyPI](https://img.shields.io/pypi/v/quantbt-engine.svg?label=PyPI)](https://pypi.org/project/quantbt-engine/)
 ![Numba](https://img.shields.io/badge/core-numba-00A86B)
 ![Backtesting](https://img.shields.io/badge/backtesting-vectorized%20%7C%20event--driven-black)
 ![Nautilus](https://img.shields.io/badge/nautilus-optional-6f42c1)
@@ -68,6 +71,10 @@ The goal is simple: make alpha research fast enough for iteration, strict
 enough for institutional-style review, and readable enough that stakeholders can
 audit how a result was produced.
 
+QuantBT is published on [PyPI as `quantbt-engine`](https://pypi.org/project/quantbt-engine/).
+Install the current public release with `pip install --upgrade quantbt-engine`;
+the import remains `from quantbt import QuantBTEndpoint`.
+
 Current portfolio status: `native_portfolio` is the default multi-symbol
 backend. It supports long/short, market-neutral, directional, equal-weight,
 risk-parity, and beta-neutral portfolio modes, with live-equity sizing and
@@ -79,7 +86,7 @@ historical reproduction.
 - One public API for notebooks, services, portfolio research, and validation.
 - Native vectorized engines for fast sweeps and large parameter grids.
 - Native event-driven engines for market/limit orders, fills, baskets, and
-  arbitrage package execution.
+  package execution, with Rust auto-promotion limited to certified workloads.
 - Prepared service contexts for repeated signal/portfolio replays on the same
   market tape without re-normalizing pandas data each run.
 - Native portfolio engine with target weights, target notionals, target units,
@@ -115,6 +122,7 @@ bt = QuantBTEndpoint.event_driven(
     input_mode="strategy",   # strategy | orders
     profile="research",      # research | optimize | audit
     backend="auto",          # auto | python | rust
+    execution_contract="event_lifecycle_v3_next_open",
     initial_capital=20_000,
     leverage=5,
     fee_rate=0.0005,          # one-way fee per fill
@@ -133,6 +141,21 @@ event artifacts. For an upstream order planner, switch to
 backend follows the release policy; `rust` is an explicit request for the
 optional capability-gated native wheel.
 
+An arbitrary `strategy=...` callback remains a Python-authoritative route,
+including when `backend="auto"` and a local native wheel is installed. The
+current automatic Rust routes are a pre-built static V2/V3 command tape with
+at least 10,000 bars, or a bounded `NativeStrategyIR` request with at least
+2,000 bars. Inspect `result.metadata["native_event_promotion_v1"]` to see the
+resolved backend, threshold, policy rule, and fallback reason for every run.
+
+The compatibility default is the frozen
+`event_lifecycle_v2_next_bar_close` behavior. Select
+`event_lifecycle_v3_next_open` for real next-open market fills, favorable
+limit-gap improvement, adverse stop-gap execution, and conservative flagged
+stop-limit ambiguity. V3 requires an `open` column and is parity-tested across
+the Python and Rust backends. The machine-readable registry and audit fields
+are documented in [Native Event Contract Registry](docs/contracts/contract_registry.md).
+
 The strategy owns signal generation and look-ahead control. QuantBT owns the
 causal order lifecycle and accounting. Advanced users can still call
 `native_event_strategy(...)` or `native_event_lifecycle(...)` directly when a
@@ -270,7 +293,71 @@ selection semantics inside `walkforward.py`. Read
 `benchmarks/results/optimization_overhead.md` for signal, intrabar, portfolio,
 arbitrage/grid/options fallback examples and benchmark details.
 
-### Phase 46F package and dual-backend release evidence
+### Current governed Rust routes and benchmark evidence
+
+Rust is execution-authoritative only where the public request, accounting
+contract, installed-wheel parity corpus, and promotion policy have all been
+certified. The generated Stage-B policy has this deliberately narrow scope:
+
+| Route | Rust behavior with a matching companion | Public default elsewhere |
+|---|---|---|
+| Static V2/V3 `OrderCommand` tape | `auto` at 10,000+ bars | Python |
+| Bounded Native Strategy IR, batch, causal-fold scorer | `auto` at 2,000+ bars | Python |
+| `run_portfolio_target_market(...)` | explicit Rust helper | no generic endpoint promotion |
+| `run_atomic_package_market(...)` | explicit Rust helper | no generic endpoint promotion |
+| Python callback/reactive, generic portfolio/basket/arbitrage/options | not promoted | Python |
+
+The bounded Rust strategy IR covers precomputed signal targets, structural
+Grid levels, periodic DCA, and fixed bracket/OCO transitions. Python callbacks,
+reactive strategies, and generic portfolio/package/arbitrage execution remain
+Python compatibility routes by design.
+
+Phase 54B.3 also certifies two intentionally explicit Rust helpers,
+`run_portfolio_target_market(...)` and `run_atomic_package_market(...)`, for
+linear quote-settled gross-cross `target_units` and one ordered same-bar
+all-or-none market package respectively. They do not change generic endpoint
+routing or claim venue-native multi-leg execution; the bounded contract,
+parity corpus, and benchmark evidence are documented in
+[`docs/native_event_rust_full_contract.md`](docs/native_event_rust_full_contract.md).
+On the governed 2,000-bar x 8-symbol fixture, their Rust score paths measured
+3.594 ms (556,551 bars/s) for target units and 3.512 ms (569,514 bars/s) for
+the atomic package, versus Python event-oracle score paths of 33.493 ms and
+19.735 ms respectively. These are bounded direct-route measurements; audit
+report adaptation is intentionally timed and reported separately.
+
+The local five-repeat public-route evidence below passed exact Python/Rust
+canonical-trace and accounting parity before timing. It is deliberately not a
+universal Rust speed claim: static public facade time is dominated by common
+Python preparation/report adaptation, while typed IR score and shared batch
+avoid those per-scenario costs.
+
+| Workload | Bars | Rust median | Rust throughput | Python median | Python throughput |
+|---|---:|---:|---:|---:|---:|
+| Static public compact | 10,000 | 63.612 ms | 157,203 bars/s | 53.606 ms | 186,545 bars/s |
+| Static public audit | 10,000 | 6.024 s | 1,660 bars/s | 5.924 s | 1,688 bars/s |
+| Native IR score | 2,000 | 0.741 ms | 2.70M bars/s | 31.565 ms | 63,361 bars/s |
+| Native IR batch, 64 scenarios | 128,000 | 11.379 ms | 11.25M bars/s | - | - |
+| Native IR causal fold, 64 scenarios | 64,000 | 7.386 ms | 8.67M bars/s | - | - |
+
+The Rust IR score has one boundary call, zero Python callbacks, and no audit
+replay. Batch/fold execution has one boundary call and zero prepared-market
+copies per scenario; its repeated-run RSS delta was 8-16 KiB on this host. An
+audit result is intentionally a cold reporting path: its typed Rust output is
+adapted to the normal `BacktestResultV2` without rerunning execution. Full
+evidence is in
+[`phase54b2/public_routes.md`](benchmarks/native_event/results/phase54b2/public_routes.md)
+and the support boundary is in
+[`docs/native_strategy_ir.md`](docs/native_strategy_ir.md).
+
+Phase 54B.4 adds an installed-wheel release gate, rather than a new speed
+claim. It proves clean core-only fallback, exact core/native-pair handshake,
+promotion decisions, and Python/Rust accounting parity for every governed
+route. The `1.1.0` / `quantbt-native==0.4.1` release pair adds a pre-built
+Linux x86_64 CPython 3.11-3.13 companion; it is published native-first and
+proved through a public Poetry consumer matrix. See the
+[native release handoff](docs/migration/native_release_handoff.md).
+
+### Historical Phase 46F package and dual-backend release evidence
 
 The core distribution is packaged as `quantbt-engine` and imports as
 `quantbt`. Its release gate is independent from the optional experimental Rust
@@ -278,9 +365,9 @@ wheel:
 
 | Release artifact | Current status | Backend policy |
 |---|---|---|
-| `quantbt-engine==1.0.8` wheel/sdist | release-ready after local/TestPyPI approval | Python canonical; all existing endpoints remain available |
-| `quantbt-native` PyO3 wheel | experimental, not published | explicit `native_backend="rust"` only |
-| `quantbt-engine[native]` | intentionally empty | no dependency is advertised before native certification |
+| `quantbt-engine` wheel/sdist | governed core release | all existing endpoints remain available |
+| `quantbt-native` PyO3 wheel | exact Linux x86_64 CPython 3.11-3.13 companion | Stage-B `auto` only for certified static/IR/batch rows |
+| `quantbt-engine[native]` | compatibility alias | matching companion is a direct platform dependency |
 
 The committed Phase 46F rerun compares the same prepared static tape and keeps
 Python/Rust accounting parity at 100%:
@@ -352,8 +439,9 @@ and a SHA256 release manifest. The TestPyPI workflow is manual and OIDC
 protected; it must be run with an unused matching RC version/tag and reviewed
 before production PyPI publication. See
 [`docs/testpypi_release_checklist.md`](docs/testpypi_release_checklist.md).
-`quantbt-native` is intentionally excluded from this core upload, `auto`
-remains Python, and explicit Rust remains capability-gated.
+This historical `1.0.8` release evidence intentionally excluded
+`quantbt-native`; `auto` remained Python and explicit Rust remained
+capability-gated.
 
 ### Phase 48C stable event-driven facade evidence
 
@@ -387,7 +475,10 @@ The release workflow is documented in
 [`docs/release_packaging.md`](docs/release_packaging.md): build and inspect
 wheel/sdist, run clean-install and `pip check`, publish an RC to TestPyPI with
 OIDC, then publish the final core package through the protected PyPI
-environment. The exact handoff fields and artifact-hash procedure are in
+environment. The native companion scope, rollback controls, and installed-wheel
+certification handoff are in
+[`docs/migration/native_release_handoff.md`](docs/migration/native_release_handoff.md).
+The exact handoff fields and artifact-hash procedure are in
 [`docs/testpypi_release_checklist.md`](docs/testpypi_release_checklist.md).
 No long-lived token is required. Native optimization remains an
 open, domain-preserving roadmap for portfolio, arbitrage, options, vectorized,
@@ -455,8 +546,10 @@ Phase 48E also reduced the static explicit Rust score to `0.000302s`
 scalar Rust output contract and prepared command-tape reuse, so they are
 reported separately from callback execution. Rust and Python fingerprints,
 fees, positions, fills, events, rejection counters, and final equity passed.
-`backend="auto"` remains Python and `[native]` remains empty until the public
-`quantbt-native` wheel matrix is clean-install certified.
+At Phase 48E this historical benchmark had `auto` pinned to Python. The later
+Phase 54B.2 local Stage-B policy promotes only the certified static/IR/batch
+rows documented above; `[native]` remains empty until a public native-wheel
+matrix is clean-install certified.
 
 ### Phase 48E.1 native production-closure evidence
 
@@ -487,9 +580,12 @@ facade; it is not a universal Rust speed claim.
 
 Phase 48E.1 also locks typed API 0.4 step results, count-only score sinks,
 reusable SoA audit buffers, separate command/lifecycle/fill reports, compact
-validated Rust order state, and reset/compaction parity. `auto` remains Python;
-the native extra remains empty until the CPython 3.11/3.12/3.13 manylinux
-clean-install workflow passes.
+validated Rust order state, and reset/lifecycle parity. This paragraph records
+the historical pre-promotion state; the current Stage-B policy is the bounded
+static/IR/batch policy above. The `native` extra remains a compatibility alias;
+Phase 55A instead prepares a direct, platform-marked dependency for the
+CPython 3.11/3.12/3.13 Linux x86_64 wheel matrix. It becomes public only after
+the Phase 55B clean-install workflow passes.
 
 Ecosystem positioning:
 
@@ -654,13 +750,13 @@ fills, positions, account state, and performance report.
 Install the released core package:
 
 ```bash
-pip install quantbt-engine==1.0.8
+pip install --upgrade quantbt-engine
 ```
 
 Optional optimization, reports, and third-party validation:
 
 ```bash
-pip install "quantbt-engine[optimization,reports,validation]==1.0.8"
+pip install --upgrade "quantbt-engine[optimization,reports,validation]"
 ```
 
 Walk-forward parameter search specifically requires the `optimization` extra.
@@ -690,9 +786,12 @@ feature is under development:
 pip install -e /root/bobby/pool_alpha/quantbt
 ```
 
-After the release is approved, downstream services should use
-`pip install quantbt-engine==1.0.8` and keep the unchanged import
-`from quantbt import QuantBTEndpoint`.
+For reproducible deployments, pin the governed release, for example
+`pip install quantbt-engine==1.1.0`, and keep the unchanged import
+`from quantbt import QuantBTEndpoint`. On supported Linux, the exact pre-built
+native companion resolves automatically; it does not require a new import or
+endpoint API. The release order and Poetry proof are in the
+[TestPyPI release checklist](docs/testpypi_release_checklist.md).
 
 ## Quick Start
 
@@ -898,6 +997,11 @@ backend, endpoint, or strategy route to use.
 | Pair, basket, hedge-ratio package behavior | [Pair and basket guide](docs/pair_basket_guide.md) |
 | Causal WFO schedules, outer-OOS claims, and audit metadata | [Causal WFO guide](docs/walkforward_causal.md) |
 | Walk-forward methodology and anti-leakage scoring | [Walk-forward methodology](docs/walkforward_methodology_vi.md) |
+| Opt-in Rust strategy templates, batch scoring, and causal OOS batch folds | [Native strategy IR and batch](docs/native_strategy_ir.md) |
+| Python/Rust plan ownership and backend routing | [Execution-plan architecture](docs/architecture/execution-plan.md) |
+| Exact staged core/native pair and maturity matrix | [Generated native compatibility](docs/contracts/generated_product_compatibility.md) |
+| Build, clean-install, and verify local native wheels | [Native companion installation](docs/native/install.md) |
+| Workload-scoped benchmark methodology | [Benchmarking governance](docs/performance/benchmarking.md) |
 | Runnable smoke templates | [Examples index](examples/README.md) |
 
 Key examples:

{quantbt_engine-1.0.8 → quantbt_engine-1.1.0}/README.md

@@ -1,6 +1,7 @@
 # QuantBT
 
 ![Python](https://img.shields.io/badge/python-3.11%2B-blue)
+[![PyPI](https://img.shields.io/pypi/v/quantbt-engine.svg?label=PyPI)](https://pypi.org/project/quantbt-engine/)
 ![Numba](https://img.shields.io/badge/core-numba-00A86B)
 ![Backtesting](https://img.shields.io/badge/backtesting-vectorized%20%7C%20event--driven-black)
 ![Nautilus](https://img.shields.io/badge/nautilus-optional-6f42c1)
@@ -18,6 +19,10 @@ The goal is simple: make alpha research fast enough for iteration, strict
 enough for institutional-style review, and readable enough that stakeholders can
 audit how a result was produced.
 
+QuantBT is published on [PyPI as `quantbt-engine`](https://pypi.org/project/quantbt-engine/).
+Install the current public release with `pip install --upgrade quantbt-engine`;
+the import remains `from quantbt import QuantBTEndpoint`.
+
 Current portfolio status: `native_portfolio` is the default multi-symbol
 backend. It supports long/short, market-neutral, directional, equal-weight,
 risk-parity, and beta-neutral portfolio modes, with live-equity sizing and
@@ -29,7 +34,7 @@ historical reproduction.
 - One public API for notebooks, services, portfolio research, and validation.
 - Native vectorized engines for fast sweeps and large parameter grids.
 - Native event-driven engines for market/limit orders, fills, baskets, and
-  arbitrage package execution.
+  package execution, with Rust auto-promotion limited to certified workloads.
 - Prepared service contexts for repeated signal/portfolio replays on the same
   market tape without re-normalizing pandas data each run.
 - Native portfolio engine with target weights, target notionals, target units,
@@ -65,6 +70,7 @@ bt = QuantBTEndpoint.event_driven(
     input_mode="strategy",   # strategy | orders
     profile="research",      # research | optimize | audit
     backend="auto",          # auto | python | rust
+    execution_contract="event_lifecycle_v3_next_open",
     initial_capital=20_000,
     leverage=5,
     fee_rate=0.0005,          # one-way fee per fill
@@ -83,6 +89,21 @@ event artifacts. For an upstream order planner, switch to
 backend follows the release policy; `rust` is an explicit request for the
 optional capability-gated native wheel.
 
+An arbitrary `strategy=...` callback remains a Python-authoritative route,
+including when `backend="auto"` and a local native wheel is installed. The
+current automatic Rust routes are a pre-built static V2/V3 command tape with
+at least 10,000 bars, or a bounded `NativeStrategyIR` request with at least
+2,000 bars. Inspect `result.metadata["native_event_promotion_v1"]` to see the
+resolved backend, threshold, policy rule, and fallback reason for every run.
+
+The compatibility default is the frozen
+`event_lifecycle_v2_next_bar_close` behavior. Select
+`event_lifecycle_v3_next_open` for real next-open market fills, favorable
+limit-gap improvement, adverse stop-gap execution, and conservative flagged
+stop-limit ambiguity. V3 requires an `open` column and is parity-tested across
+the Python and Rust backends. The machine-readable registry and audit fields
+are documented in [Native Event Contract Registry](docs/contracts/contract_registry.md).
+
 The strategy owns signal generation and look-ahead control. QuantBT owns the
 causal order lifecycle and accounting. Advanced users can still call
 `native_event_strategy(...)` or `native_event_lifecycle(...)` directly when a
@@ -220,7 +241,71 @@ selection semantics inside `walkforward.py`. Read
 `benchmarks/results/optimization_overhead.md` for signal, intrabar, portfolio,
 arbitrage/grid/options fallback examples and benchmark details.
 
-### Phase 46F package and dual-backend release evidence
+### Current governed Rust routes and benchmark evidence
+
+Rust is execution-authoritative only where the public request, accounting
+contract, installed-wheel parity corpus, and promotion policy have all been
+certified. The generated Stage-B policy has this deliberately narrow scope:
+
+| Route | Rust behavior with a matching companion | Public default elsewhere |
+|---|---|---|
+| Static V2/V3 `OrderCommand` tape | `auto` at 10,000+ bars | Python |
+| Bounded Native Strategy IR, batch, causal-fold scorer | `auto` at 2,000+ bars | Python |
+| `run_portfolio_target_market(...)` | explicit Rust helper | no generic endpoint promotion |
+| `run_atomic_package_market(...)` | explicit Rust helper | no generic endpoint promotion |
+| Python callback/reactive, generic portfolio/basket/arbitrage/options | not promoted | Python |
+
+The bounded Rust strategy IR covers precomputed signal targets, structural
+Grid levels, periodic DCA, and fixed bracket/OCO transitions. Python callbacks,
+reactive strategies, and generic portfolio/package/arbitrage execution remain
+Python compatibility routes by design.
+
+Phase 54B.3 also certifies two intentionally explicit Rust helpers,
+`run_portfolio_target_market(...)` and `run_atomic_package_market(...)`, for
+linear quote-settled gross-cross `target_units` and one ordered same-bar
+all-or-none market package respectively. They do not change generic endpoint
+routing or claim venue-native multi-leg execution; the bounded contract,
+parity corpus, and benchmark evidence are documented in
+[`docs/native_event_rust_full_contract.md`](docs/native_event_rust_full_contract.md).
+On the governed 2,000-bar x 8-symbol fixture, their Rust score paths measured
+3.594 ms (556,551 bars/s) for target units and 3.512 ms (569,514 bars/s) for
+the atomic package, versus Python event-oracle score paths of 33.493 ms and
+19.735 ms respectively. These are bounded direct-route measurements; audit
+report adaptation is intentionally timed and reported separately.
+
+The local five-repeat public-route evidence below passed exact Python/Rust
+canonical-trace and accounting parity before timing. It is deliberately not a
+universal Rust speed claim: static public facade time is dominated by common
+Python preparation/report adaptation, while typed IR score and shared batch
+avoid those per-scenario costs.
+
+| Workload | Bars | Rust median | Rust throughput | Python median | Python throughput |
+|---|---:|---:|---:|---:|---:|
+| Static public compact | 10,000 | 63.612 ms | 157,203 bars/s | 53.606 ms | 186,545 bars/s |
+| Static public audit | 10,000 | 6.024 s | 1,660 bars/s | 5.924 s | 1,688 bars/s |
+| Native IR score | 2,000 | 0.741 ms | 2.70M bars/s | 31.565 ms | 63,361 bars/s |
+| Native IR batch, 64 scenarios | 128,000 | 11.379 ms | 11.25M bars/s | - | - |
+| Native IR causal fold, 64 scenarios | 64,000 | 7.386 ms | 8.67M bars/s | - | - |
+
+The Rust IR score has one boundary call, zero Python callbacks, and no audit
+replay. Batch/fold execution has one boundary call and zero prepared-market
+copies per scenario; its repeated-run RSS delta was 8-16 KiB on this host. An
+audit result is intentionally a cold reporting path: its typed Rust output is
+adapted to the normal `BacktestResultV2` without rerunning execution. Full
+evidence is in
+[`phase54b2/public_routes.md`](benchmarks/native_event/results/phase54b2/public_routes.md)
+and the support boundary is in
+[`docs/native_strategy_ir.md`](docs/native_strategy_ir.md).
+
+Phase 54B.4 adds an installed-wheel release gate, rather than a new speed
+claim. It proves clean core-only fallback, exact core/native-pair handshake,
+promotion decisions, and Python/Rust accounting parity for every governed
+route. The `1.1.0` / `quantbt-native==0.4.1` release pair adds a pre-built
+Linux x86_64 CPython 3.11-3.13 companion; it is published native-first and
+proved through a public Poetry consumer matrix. See the
+[native release handoff](docs/migration/native_release_handoff.md).
+
+### Historical Phase 46F package and dual-backend release evidence
 
 The core distribution is packaged as `quantbt-engine` and imports as
 `quantbt`. Its release gate is independent from the optional experimental Rust
@@ -228,9 +313,9 @@ wheel:
 
 | Release artifact | Current status | Backend policy |
 |---|---|---|
-| `quantbt-engine==1.0.8` wheel/sdist | release-ready after local/TestPyPI approval | Python canonical; all existing endpoints remain available |
-| `quantbt-native` PyO3 wheel | experimental, not published | explicit `native_backend="rust"` only |
-| `quantbt-engine[native]` | intentionally empty | no dependency is advertised before native certification |
+| `quantbt-engine` wheel/sdist | governed core release | all existing endpoints remain available |
+| `quantbt-native` PyO3 wheel | exact Linux x86_64 CPython 3.11-3.13 companion | Stage-B `auto` only for certified static/IR/batch rows |
+| `quantbt-engine[native]` | compatibility alias | matching companion is a direct platform dependency |
 
 The committed Phase 46F rerun compares the same prepared static tape and keeps
 Python/Rust accounting parity at 100%:
@@ -302,8 +387,9 @@ and a SHA256 release manifest. The TestPyPI workflow is manual and OIDC
 protected; it must be run with an unused matching RC version/tag and reviewed
 before production PyPI publication. See
 [`docs/testpypi_release_checklist.md`](docs/testpypi_release_checklist.md).
-`quantbt-native` is intentionally excluded from this core upload, `auto`
-remains Python, and explicit Rust remains capability-gated.
+This historical `1.0.8` release evidence intentionally excluded
+`quantbt-native`; `auto` remained Python and explicit Rust remained
+capability-gated.
 
 ### Phase 48C stable event-driven facade evidence
 
@@ -337,7 +423,10 @@ The release workflow is documented in
 [`docs/release_packaging.md`](docs/release_packaging.md): build and inspect
 wheel/sdist, run clean-install and `pip check`, publish an RC to TestPyPI with
 OIDC, then publish the final core package through the protected PyPI
-environment. The exact handoff fields and artifact-hash procedure are in
+environment. The native companion scope, rollback controls, and installed-wheel
+certification handoff are in
+[`docs/migration/native_release_handoff.md`](docs/migration/native_release_handoff.md).
+The exact handoff fields and artifact-hash procedure are in
 [`docs/testpypi_release_checklist.md`](docs/testpypi_release_checklist.md).
 No long-lived token is required. Native optimization remains an
 open, domain-preserving roadmap for portfolio, arbitrage, options, vectorized,
@@ -405,8 +494,10 @@ Phase 48E also reduced the static explicit Rust score to `0.000302s`
 scalar Rust output contract and prepared command-tape reuse, so they are
 reported separately from callback execution. Rust and Python fingerprints,
 fees, positions, fills, events, rejection counters, and final equity passed.
-`backend="auto"` remains Python and `[native]` remains empty until the public
-`quantbt-native` wheel matrix is clean-install certified.
+At Phase 48E this historical benchmark had `auto` pinned to Python. The later
+Phase 54B.2 local Stage-B policy promotes only the certified static/IR/batch
+rows documented above; `[native]` remains empty until a public native-wheel
+matrix is clean-install certified.
 
 ### Phase 48E.1 native production-closure evidence
 
@@ -437,9 +528,12 @@ facade; it is not a universal Rust speed claim.
 
 Phase 48E.1 also locks typed API 0.4 step results, count-only score sinks,
 reusable SoA audit buffers, separate command/lifecycle/fill reports, compact
-validated Rust order state, and reset/compaction parity. `auto` remains Python;
-the native extra remains empty until the CPython 3.11/3.12/3.13 manylinux
-clean-install workflow passes.
+validated Rust order state, and reset/lifecycle parity. This paragraph records
+the historical pre-promotion state; the current Stage-B policy is the bounded
+static/IR/batch policy above. The `native` extra remains a compatibility alias;
+Phase 55A instead prepares a direct, platform-marked dependency for the
+CPython 3.11/3.12/3.13 Linux x86_64 wheel matrix. It becomes public only after
+the Phase 55B clean-install workflow passes.
 
 Ecosystem positioning:
 
@@ -604,13 +698,13 @@ fills, positions, account state, and performance report.
 Install the released core package:
 
 ```bash
-pip install quantbt-engine==1.0.8
+pip install --upgrade quantbt-engine
 ```
 
 Optional optimization, reports, and third-party validation:
 
 ```bash
-pip install "quantbt-engine[optimization,reports,validation]==1.0.8"
+pip install --upgrade "quantbt-engine[optimization,reports,validation]"
 ```
 
 Walk-forward parameter search specifically requires the `optimization` extra.
@@ -640,9 +734,12 @@ feature is under development:
 pip install -e /root/bobby/pool_alpha/quantbt
 ```
 
-After the release is approved, downstream services should use
-`pip install quantbt-engine==1.0.8` and keep the unchanged import
-`from quantbt import QuantBTEndpoint`.
+For reproducible deployments, pin the governed release, for example
+`pip install quantbt-engine==1.1.0`, and keep the unchanged import
+`from quantbt import QuantBTEndpoint`. On supported Linux, the exact pre-built
+native companion resolves automatically; it does not require a new import or
+endpoint API. The release order and Poetry proof are in the
+[TestPyPI release checklist](docs/testpypi_release_checklist.md).
 
 ## Quick Start
 
@@ -848,6 +945,11 @@ backend, endpoint, or strategy route to use.
 | Pair, basket, hedge-ratio package behavior | [Pair and basket guide](docs/pair_basket_guide.md) |
 | Causal WFO schedules, outer-OOS claims, and audit metadata | [Causal WFO guide](docs/walkforward_causal.md) |
 | Walk-forward methodology and anti-leakage scoring | [Walk-forward methodology](docs/walkforward_methodology_vi.md) |
+| Opt-in Rust strategy templates, batch scoring, and causal OOS batch folds | [Native strategy IR and batch](docs/native_strategy_ir.md) |
+| Python/Rust plan ownership and backend routing | [Execution-plan architecture](docs/architecture/execution-plan.md) |
+| Exact staged core/native pair and maturity matrix | [Generated native compatibility](docs/contracts/generated_product_compatibility.md) |
+| Build, clean-install, and verify local native wheels | [Native companion installation](docs/native/install.md) |
+| Workload-scoped benchmark methodology | [Benchmarking governance](docs/performance/benchmarking.md) |
 | Runnable smoke templates | [Examples index](examples/README.md) |
 
 Key examples:

{quantbt_engine-1.0.8 → quantbt_engine-1.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "quantbt-engine"
-version = "1.0.8"
+version = "1.1.0"
 description = "Transparent, high-performance quantitative backtesting engine"
 readme = "README.md"
 requires-python = ">=3.11,<3.14"
@@ -36,6 +36,9 @@ dependencies = [
     "numpy>=2.2.6,<2.3",
     "pandas>=2.3.3,<2.4",
     "numba>=0.65.1,<0.66",
+    # Supported Linux consumers receive a pre-built PyO3 companion. Other
+    # platforms retain the Python/Numba core without source compilation.
+    "quantbt-native==0.4.1; sys_platform == 'linux' and platform_machine == 'x86_64' and implementation_name == 'cpython' and python_version >= '3.11' and python_version < '3.14'",
 ]
 
 [project.optional-dependencies]
@@ -54,9 +57,8 @@ viz = [
 validation = [
     "nautilus-trader>=1.230.0,<1.231; python_version >= '3.12'",
 ]
-# The API 0.4 PyO3 package is built by the native workflow but is not yet a
-# public dependency. Keep this empty until quantbt-native passes the public
-# manylinux wheel and clean-install gates.
+# Backward-compatible extra name. The bounded native companion is a direct,
+# platform-marked dependency on supported Linux, so this extra adds nothing.
 native = []
 all = [
     "optuna>=4.8.0,<4.9",
@@ -70,6 +72,7 @@ all = [
 
 [project.urls]
 Homepage = "https://github.com/BobbyAxerol/quantbt"
+PyPI = "https://pypi.org/project/quantbt-engine/"
 Repository = "https://github.com/BobbyAxerol/quantbt"
 Issues = "https://github.com/BobbyAxerol/quantbt/issues"
 Documentation = "https://github.com/BobbyAxerol/quantbt/tree/main/docs"
@@ -99,3 +102,8 @@ python_files = ["test_*.py"]
 
 [tool.uv]
 package = true
+
+[tool.uv.sources]
+# Phase 55A lock/build source. This local override is never emitted into the
+# public wheel metadata; consumers resolve the exact PyPI requirement above.
+quantbt-native = { path = "rust/native_event" }