feat(causal): webserver bench with a planted, known-answer bottleneck

examples/causal_bench.rs (required-features smarm-causal): the Phase 2
RFC 007 test case — a real urus server replacing the synthetic demo as
validation workload.

Shape: 16 plain-OS-thread clients hammer GET /order/:id over blocking
loopback keep-alive TCP (OS threads can't absorb injected virtual delay
— the established trick, so only server code is delayable). The handler
calls a single store actor (crud's once-cell pattern, serialization
structural) burning 400µs of calibrated *work* under
causal_site!("store") — work-shaped, not timed, or injection reads as a
no-op. 50µs handler render lands under the enclosing pipeline site.

Known answer: store serialized + saturated => ceiling 2500 rps; speedup
p => x1/(1-p): +33% @25, +100% @50. The five lib sites are tens of µs
and parallel across conns => ~0. Verdict mirrors the demo: store @25 >
+15%, others < +10%, SKIPPED under 4 cores; magnitudes trusted to ~±15%
per the smarm-side validation notes, ranking is the hard check.

1-core sandbox smoke (verdict SKIPPED but numbers indicative): store
+26.2% @25 / +74.0% @50, all other sites within ±2%. Unlike the demo
this workload keeps its bottleneck structure on one core — everything
but the store is IO-parked — and the theory shortfall there is plain
core contention (render/parse share the store's CPU), which the 24-core
sweep should close.

This commit is contained in:

Claude

2026-07-13 08:59:49 +00:00

parent ecaddc579a

commit 288b52d89c

2 changed files with 326 additions and 0 deletions

									
										Cargo.toml
									
		+4
		
												View File
												
				@@ -26,6 +26,10 @@ phoenix      = ["channels", "dep:serde", "dep:serde_json"]

				serde      = { version = "1", features = ["derive"] }

				serde_json = "1"

				[[example]]

				name = "causal_bench"

				required-features = ["smarm-causal"]

				[profile.dev]

				panic = "unwind"