feat: refresh benchmark coverage and harden CI tooling

Refresh the benchmark and performance surface across the repo. This updates the benchmark wrappers and helper scripts, regenerates the checked-in benchmark and perf-contract artifacts, and folds in the related roadmap, compatibility, and example notebook changes that belong with this performance-focused pass.

Harden the Python CI and local pre-push flow so the same checks pass reliably in both places. The workflow and pre-push script now use module-safe uv typecheck invocations, the Python test environment installs the optional MCP dependency needed by the MCP server tests, and one-off root benchmark outputs are ignored to keep the repo clean.

Align local tooling with the current project configuration by updating the Ruff pre-commit hook, tightening the API typing and MCP server helpers, and refreshing the lockfile to pick up the audited PyJWT fix while preserving the rest of the staged source changes.

scripts/build_api_manifest.py

@@ -32,7 +32,9 @@ def _load_api_info_module(root: Path, module_path: Path):
     python_root = str(root / "python")
     if python_root not in sys.path:
         sys.path.insert(0, python_root)
-    spec = importlib.util.spec_from_file_location("ferro_ta_tools_api_info", module_path)
+    spec = importlib.util.spec_from_file_location(
+        "ferro_ta_tools_api_info", module_path
+    )
     if spec is None or spec.loader is None:
         raise RuntimeError(f"Could not load module spec from {module_path}")
     module = importlib.util.module_from_spec(spec)
@@ -217,7 +219,9 @@ def _safe_git_head(root: Path) -> str | None:
     return value or None
 
 
-def build_manifest(root: Path, include_runtime_metadata: bool = False) -> dict[str, Any]:
+def build_manifest(
+    root: Path, include_runtime_metadata: bool = False
+) -> dict[str, Any]:
     python_api = _extract_python_api(root)
     rust_core = _extract_core_exports(root)
     wasm_exports = _extract_wasm_exports(root)
@@ -279,7 +283,9 @@ def main() -> None:
     output_path = (root / args.output).resolve()
     output_path.parent.mkdir(parents=True, exist_ok=True)
 
-    manifest = build_manifest(root, include_runtime_metadata=args.include_runtime_metadata)
+    manifest = build_manifest(
+        root, include_runtime_metadata=args.include_runtime_metadata
+    )
     output_path.write_text(json.dumps(manifest, indent=2) + "\n", encoding="utf-8")
     print(f"Wrote API manifest to {output_path}")
 

scripts/bump_version.py

@@ -15,7 +15,6 @@ import re
 from dataclasses import dataclass
 from pathlib import Path
 
-
 ROOT = Path(__file__).resolve().parent.parent
 SEMVER_RE = re.compile(r"^\d+\.\d+\.\d+$")
 

scripts/pre_push_checks.sh

@@ -66,8 +66,8 @@ ensure_python_env() {
   fi
 
   need_cmd uv
-  run_cmd uv sync --extra dev --extra docs
-  run_cmd uv run --extra dev --extra docs maturin develop --release
+  run_cmd uv sync --extra dev --extra docs --extra mcp
+  run_cmd uv run --extra dev --extra docs --extra mcp maturin develop --release
   python_env_ready=1
 }
 
@@ -110,13 +110,13 @@ run_python_lint() {
 
 run_python_typecheck() {
   need_cmd uv
-  run_cmd uv run --with mypy --with numpy mypy python/ferro_ta --ignore-missing-imports --no-error-summary
-  run_cmd uv run --with pyright pyright python/ferro_ta
+  run_cmd uv run --with mypy --with numpy python -m mypy python/ferro_ta --ignore-missing-imports --no-error-summary
+  run_cmd uv run --with pyright python -m pyright python/ferro_ta
 }
 
 run_python_test() {
   ensure_python_env
-  run_cmd uv run --extra dev --with pytest-cov pytest tests/unit/ tests/integration/ -v --cov=ferro_ta --cov-report=term-missing --cov-fail-under=65
+  run_cmd uv run --extra dev --extra mcp --with pytest-cov pytest tests/unit/ tests/integration/ -v --cov=ferro_ta --cov-report=term-missing --cov-fail-under=65
 }
 
 run_docs() {