Feat/cluster live demo

.gitignore

@@ -386,3 +386,8 @@ testing/e2e/logs/
 
 # Local reports from the toolkit-pr-review-v2 skill (never committed)
 /REVIEW_*.md
+
+# Helm chart artifacts (never committed)
+*.tgz
+Chart.lock
+

Cargo.toml

@@ -51,6 +51,7 @@ debug = true
 [workspace]
 members = [
     "apps/cf-gears-example-server",
+    "apps/platform-host",
     "tools/gts-analyze",
     "tools/xtask",
     "libs/toolkit",
@@ -110,10 +111,8 @@ members = [
     "examples/toolkit/users-info/users-info-sdk",
     "examples/toolkit/users-info/users-info",
     "examples/toolkit/users-info/users-info-server",
-    "examples/oop-gears/calculator-gateway/calculator-gateway-sdk",
-    "examples/oop-gears/calculator-gateway/calculator-gateway",
-    "examples/oop-gears/calculator/calculator-sdk",
-    "examples/oop-gears/calculator/calculator",
+    "examples/toolkit/hello/hello",
+    "examples/toolkit/cluster-consumer/cluster-consumer",
     "examples/cf-gears-fips-probe",
     "gears/system/types-registry/types-registry-sdk",
     "gears/system/types-registry/types-registry",

Makefile

@@ -24,7 +24,7 @@ COMMA := ,
 EXAMPLE_SERVER_BIN ?= cf-gears-example-server
 EXAMPLE_SERVER_DEBUG_BINARY ?= target/debug/$(EXAMPLE_SERVER_BIN)
 EXAMPLE_SERVER_MANIFEST ?= apps/cf-gears-example-server/Cargo.toml
-EXAMPLE_SERVER_FEATURE_EXCLUDES ?= default fips k8s otel oop-example timescaledb-usage-collector
+EXAMPLE_SERVER_FEATURE_EXCLUDES ?= default fips k8s otel timescaledb-usage-collector
 EXAMPLE_SERVER_ALL_FEATURES := $(strip $(shell cargo gears ls features --manifest $(EXAMPLE_SERVER_MANIFEST) 2>/dev/null))
 EXAMPLE_SERVER_FEATURES ?= $(subst $(SPACE),$(COMMA),$(filter-out $(EXAMPLE_SERVER_FEATURE_EXCLUDES),$(EXAMPLE_SERVER_ALL_FEATURES)))
 EXAMPLE_SERVER_FEATURE_ARGS ?= $(if $(EXAMPLE_SERVER_FEATURES),--features $(EXAMPLE_SERVER_FEATURES),)
@@ -905,7 +905,7 @@ bench-db-longhaul: bench-pg-longhaul bench-mysql-longhaul bench-mariadb-longhaul
 
 # -------- E2E tests --------
 
-.PHONY: e2e e2e-local e2e-local-smoke e2e-mini-chat e2e-docker e2e-docker-smoke e2e-tr-authz e2e-usage-collector
+.PHONY: e2e e2e-local e2e-local-smoke e2e-mini-chat e2e-docker e2e-docker-smoke e2e-tr-authz e2e-usage-collector e2e-oop oop-smoke
 
 E2E_TARGET ?=
 # E2E selectors for `make e2e-local`:
@@ -984,6 +984,30 @@ e2e-usage-collector:
 	$(call print_target_banner)
 	$(MAKE) e2e-local SUITE=usage-collector
 
+# Out-of-process (loopback) E2E: boots platform-host + OoP gears as local
+# processes (no Kubernetes) and asserts the cross-process seams. Self-managed:
+# its conftest builds the binaries and owns the process lifecycle, so it runs
+# pytest directly (not via run_e2e.py). timeout_func_only keeps the per-test
+# timeout from counting the heavy fixture setup (build + boot + route sync).
+OOP_E2E_DIR ?= testing/e2e/suites/oop
+OOP_E2E_TIMEOUT ?= 60
+## Run the out-of-process (loopback, no-k8s) E2E suite
+e2e-oop: py-env
+	$(call print_target_banner)
+	cargo build -p cf-gears-platform-host --bin platform-host
+	cargo build -p hello --features oop_module --bin hello-oop
+	cargo build -p cf-api-contracts --features oop_module --bin api-contracts-oop
+	cargo build -p cf-api-contracts-consumer --features oop_module --bin api-contracts-consumer-oop
+	cargo build -p cf-gears-cluster --bin cluster-oop
+	cargo build -p cluster-consumer --features oop_module --bin cluster-consumer-oop
+	$(PYTHON) -m pytest $(OOP_E2E_DIR) -c testing/e2e/pytest.ini \
+		-o timeout_func_only=true --timeout=$(OOP_E2E_TIMEOUT) -vv
+
+## Run the scripted Profile-3 (Kubernetes) OoP demo smoke test (see deploy/oop-smoke.sh --help)
+oop-smoke:
+	$(call print_target_banner)
+	deploy/oop-smoke.sh $(OOP_SMOKE_ARGS)
+
 # -------- Code coverage --------
 
 .PHONY: coverage coverage-unit coverage-e2e-local check-prereq-e2e-local
@@ -1233,12 +1257,6 @@ fips:
 	$(call print_target_banner)
 	cargo run --bin cf-gears-example-server --features fips,static-authn,static-authz,single-tenant,static-credstore,otel -- --config config/quickstart.yaml run
 
-## Run server with out-of-process example gear
-oop-example:
-	$(call print_target_banner)
-	cargo build -p calculator --features oop_gear
-	cargo run --bin cf-gears-example-server --features oop-example,users-info-example,static-authn,static-authz,static-tenants,static-credstore -- --config config/quickstart.yaml run
-
 # Run all quality checks
 check: fmt cfs-validate clippy lychee security dylint gts-docs test
 	$(call print_target_banner)

apps/cf-gears-example-server/Cargo.toml

@@ -22,7 +22,6 @@ credstore = ["dep:credstore"]
 # FIPS-140-3: use the AWS-LC FIPS-validated crypto module for all cryptographic operations
 fips = ["toolkit/fips", "oagw", "api_egress?/fips"]
 users-info-example = ["dep:users-info"]
-oop-example = ["dep:calculator-gateway", "dep:calculator"]
 single-tenant = ["dep:single-tenant-tr-plugin"]
 static-tenants = ["dep:static-tr-plugin"]
 static-authn = ["dep:static-authn-plugin"]
@@ -119,8 +118,6 @@ bss_pricing = { package = "cf-gears-bss-pricing", path = "../../gears/bss/pricin
 
 # Optional example module
 users-info = { path = "../../examples/toolkit/users-info/users-info", optional = true }
-calculator-gateway = { path = "../../examples/oop-gears/calculator-gateway/calculator-gateway", optional = true }
-calculator = { path = "../../examples/oop-gears/calculator/calculator", optional = true }
 
 [dev-dependencies]
 tempfile = { workspace = true }