local mode

Author: fffonion

pd-edge/README.md

@@ -280,6 +280,7 @@ Run the built-in framework to benchmark these scenarios:
 
 Detailed report with charts: [`docs/HTTP_PROXY_PERF_REPORT_2026-03-14.md`](docs/HTTP_PROXY_PERF_REPORT_2026-03-14.md)
 Generic `proxy::forward` experiment report: [`docs/HTTP_PROXY_PERF_REPORT_2026-03-15.md`](docs/HTTP_PROXY_PERF_REPORT_2026-03-15.md)
+Perf methodology and baseline rules: [`docs/HTTP_PROXY_PERF_METHODOLOGY.md`](docs/HTTP_PROXY_PERF_METHODOLOGY.md)
 
 Harness A standard comparisons run with VM fuel disabled by default. Pass `--vm-fuel <UNITS>` to turn it on.
 
@@ -309,6 +310,12 @@ cargo run -p pd-edge --example http_proxy_perf_framework --release -- \
   --json-out target/http_proxy_perf_mode_threading.json
 ```
 
+Important:
+
+- Baseline-relative percentages must use the matched baseline from the same run batch.
+- Do not compare a scenario from one rerun against a baseline row copied from another rerun.
+- If you repeat runs, compute each run's ratio first and then aggregate the ratios.
+
 Fuel-impact latency sweep (proxy harness, scenario `no_host_calls_program`):
 
 ```bash

pd-edge/examples/http_proxy_perf_framework.rs

@@ -682,13 +682,15 @@ impl Default for BenchConfig {
 #[serde(rename_all = "snake_case")]
 enum VmExecutionModeArg {
     Async,
+    Local,
     Threading,
 }
 
 impl VmExecutionModeArg {
     fn as_flag_value(self) -> &'static str {
         match self {
             VmExecutionModeArg::Async => "async",
+            VmExecutionModeArg::Local => "local",
             VmExecutionModeArg::Threading => "threading",
         }
     }
@@ -698,11 +700,12 @@ fn parse_vm_execution_mode_arg(value: &str) -> Result<VmExecutionModeArg, String
     let normalized = value.trim().to_ascii_lowercase();
     match normalized.as_str() {
         "async" => Ok(VmExecutionModeArg::Async),
+        "local" | "inline" | "current-task" | "current_task" => Ok(VmExecutionModeArg::Local),
         "threading" | "blocking" | "spawn-blocking" | "spawn_blocking" => {
             Ok(VmExecutionModeArg::Threading)
         }
         _ => Err(format!(
-            "invalid --vm-execution-mode: {value} (expected async|threading)"
+            "invalid --vm-execution-mode: {value} (expected async|local|threading)"
         )),
     }
 }
@@ -3794,7 +3797,7 @@ Options:\n\
   --vm-fuel <UNITS>                 Enable cooperative VM fuel slices (default: disabled)\n\
   --no-vm-fuel                      Disable VM fuel slices\n\
   --vm-fuel-check-interval <OPS>    Fuel check interval for proxy VM (default: 32)\n\
-  --vm-execution-mode <MODE>        Proxy VM execution mode: async|threading (default: async)\n\
+  --vm-execution-mode <MODE>        Proxy VM execution mode: async|local|threading (default: async)\n\
   --fuel-latency-sweep              Run latency sweeps for fuel and fuel-check-interval (defaults to scenario no_host_calls_program)\n\
   --fuel-latency-fuels <CSV>        CSV list for fuel sweep; must be > 0 (default starts at 1)\n\
   --fuel-latency-check-intervals <CSV> CSV list for check-interval sweep; must be > 0 (default starts at 1)\n\