feat(core): add shared request timing collector and middleware

.claude/commands/check-ci.md

@@ -1,8 +1,10 @@
-Run the full CI gate checks locally before pushing. Run all four commands sequentially and report any failures:
+Run the full CI gate checks locally before pushing. Run all six commands sequentially and report any failures:
 
 1. `cargo fmt --all -- --check`
 2. `cargo clippy --workspace --all-targets --all-features -- -D warnings`
 3. `cargo test --workspace --all-targets`
-4. `cargo check --workspace --all-targets --features "fastly cloudflare"`
+4. `cargo test -p edgezero-core --doc`
+5. `cargo check --workspace --all-targets --features "fastly cloudflare spin"`
+6. `cargo check -p edgezero-adapter-spin --target wasm32-wasip2 --features spin`
 
 If any step fails, show the errors and suggest fixes. Do not proceed to the next step until the current one passes.

.github/workflows/test.yml

@@ -112,6 +112,10 @@ jobs:
         if: matrix.suite == 'workspace'
         run: cargo test --workspace --all-targets
 
+      - name: Core doctests
+        if: matrix.suite == 'workspace'
+        run: cargo test -p edgezero-core --doc
+
       - name: Run EdgeZero CLI tests
         if: matrix.suite == 'cli'
         run: cargo test -p edgezero-cli --all-targets

CLAUDE.md

@@ -40,6 +40,9 @@ scripts/                      # Build/deploy/test helper scripts
 # Full workspace test (primary CI command)
 cargo test --workspace --all-targets
 
+# Core doctests (not included by --all-targets)
+cargo test -p edgezero-core --doc
+
 # Test a specific crate
 cargo test -p edgezero-core
 cargo test -p edgezero-adapter-fastly
@@ -186,8 +189,9 @@ Every PR must pass:
 1. `cargo fmt --all -- --check`
 2. `cargo clippy --workspace --all-targets --all-features -- -D warnings`
 3. `cargo test --workspace --all-targets`
-4. `cargo check --workspace --all-targets --features "fastly cloudflare spin"`
-5. `cargo check -p edgezero-adapter-spin --target wasm32-wasip2 --features spin`
+4. `cargo test -p edgezero-core --doc`
+5. `cargo check --workspace --all-targets --features "fastly cloudflare spin"`
+6. `cargo check -p edgezero-adapter-spin --target wasm32-wasip2 --features spin`
 
 Docs CI additionally runs ESLint + Prettier on the `docs/` directory.
 
@@ -283,7 +287,7 @@ Custom commands live in `.claude/commands/`:
 
 | Command           | Purpose                                            |
 | ----------------- | -------------------------------------------------- |
-| `/check-ci`       | Run all 4 CI gate checks locally                   |
+| `/check-ci`       | Run all 6 CI gate checks locally                   |
 | `/test-all`       | Run full workspace test suite                      |
 | `/test-crate`     | Run tests for a specific crate                     |
 | `/review-changes` | Staff-engineer-level review of uncommitted changes |

crates/edgezero-adapter-cloudflare/tests/contract.rs

@@ -517,4 +517,23 @@ mod tests {
         let body = response.text().await.expect("text");
         assert_eq!(body, "no");
     }
+
+    #[wasm_bindgen_test::wasm_bindgen_test]
+    fn request_timing_clock_handle_and_attachment_work_on_runtime() {
+        super::request_timing_tests::clock_handle_and_attachment_work_on_runtime();
+    }
+
+    #[wasm_bindgen_test::wasm_bindgen_test]
+    fn request_timing_clock_advances_in_browser_harness() {
+        use worker::Date;
+
+        let deadline = Date::now().as_millis().saturating_add(2_000_u64);
+        super::request_timing_tests::clock_advances_on_local_runtime(|| {
+            Date::now().as_millis() >= deadline
+        });
+    }
 }
+
+#[cfg(test)]
+#[path = "../../edgezero-core/tests/support/request_timing.rs"]
+mod request_timing_tests;

crates/edgezero-adapter-fastly/tests/contract.rs

@@ -248,4 +248,23 @@ mod tests {
         assert_eq!(response.get_status(), FastlyStatus::OK);
         assert_eq!(response.take_body_bytes(), b"hello from fastly test");
     }
+
+    #[test]
+    fn request_timing_clock_handle_and_attachment_work_on_runtime() {
+        super::request_timing_tests::clock_handle_and_attachment_work_on_runtime();
+    }
+
+    #[test]
+    fn request_timing_clock_advances_in_viceroy_harness() {
+        use std::time::{Duration, SystemTime};
+
+        let deadline = SystemTime::now() + Duration::from_secs(2);
+        super::request_timing_tests::clock_advances_on_local_runtime(|| {
+            SystemTime::now() >= deadline
+        });
+    }
 }
+
+#[cfg(test)]
+#[path = "../../edgezero-core/tests/support/request_timing.rs"]
+mod request_timing_tests;

crates/edgezero-adapter-spin/tests/contract.rs

@@ -544,4 +544,23 @@ mod tests {
             "no secret handle yields the no-handle marker"
         );
     }
+
+    #[test]
+    fn request_timing_clock_handle_and_attachment_work_on_runtime() {
+        super::request_timing_tests::clock_handle_and_attachment_work_on_runtime();
+    }
+
+    #[test]
+    fn request_timing_clock_advances_in_wasmtime_harness() {
+        use std::time::{Duration, SystemTime};
+
+        let deadline = SystemTime::now() + Duration::from_secs(2);
+        super::request_timing_tests::clock_advances_on_local_runtime(|| {
+            SystemTime::now() >= deadline
+        });
+    }
 }
+
+#[cfg(test)]
+#[path = "../../edgezero-core/tests/support/request_timing.rs"]
+mod request_timing_tests;

crates/edgezero-cli/tests/ci_gate_docs.rs

@@ -0,0 +1,35 @@
+//! Keep the local check command aligned with the documented CI gates.
+
+#[cfg(test)]
+mod tests {
+    fn gate_commands(markdown: &str) -> Vec<&str> {
+        markdown
+            .lines()
+            .filter_map(|line| line.split_once(". `")?.1.strip_suffix('`'))
+            .collect()
+    }
+
+    #[test]
+    fn local_check_command_matches_documented_ci_gates() {
+        let conventions = include_str!("../../../CLAUDE.md");
+        let command = include_str!("../../../.claude/commands/check-ci.md");
+        let gates = conventions
+            .split_once("## CI Gates\n")
+            .unwrap()
+            .1
+            .split_once("\n## ")
+            .unwrap()
+            .0;
+        let expected = gate_commands(gates);
+        assert_eq!(expected.len(), 6);
+        assert_eq!(gate_commands(command), expected);
+        assert!(command.starts_with(
+            "Run the full CI gate checks locally before pushing. Run all six commands sequentially"
+        ));
+        let command_row = conventions
+            .lines()
+            .find(|line| line.starts_with("| `/check-ci`"))
+            .unwrap();
+        assert!(command_row.contains("Run all 6 CI gate checks locally"));
+    }
+}

crates/edgezero-core/src/lib.rs

@@ -34,6 +34,7 @@ pub mod manifest;
 pub mod middleware;
 pub mod params;
 pub mod proxy;
+pub mod request_timing;
 pub mod responder;
 pub mod response;
 pub mod router;