fix(examples): swap-rename the streamable clients + EXAMPLES.md staleness

Maintainer-requested rename: the plain `streamable-http-client` name now
belongs to the 2026 client (the bilingual, default-lane, spec-negotiating
one — spec-neutral name per the naming rule's neutral-token exception);
the old hand-parsed 2025 client is `streamable-http-client-2025-11-25`
(full date). All reference sites updated (workspace members, ci-gates.sh,
ci.yml, label comments in client-initialise-report + lambda-mcp-client,
EXAMPLES.md, self-references). Pair RE-VERIFIED LIVE under the new names
against minimal-server.

Codex review fixes (EXAMPLES.md):
- Header: "58 examples" → 55 active (counted from disk) + archived/ note.
- Verified line: the 2026-02-26 "phases 1-5 functionally verified
  (v0.3.0, MCP 2025-11-25)" claim predates the 2026 cutover and no longer
  applies as stated — now says compile-verified under each lane's CI
  gates, with functional re-verification tracked in the examples review.
- "Client Examples - 5" → 7 (matches the pairs table).
- Footer status: v0.3.0/2025-compliance → 0.4.0 branch, 2026-07-28
  default + 2025-11-25 opt-in, pointing at the spec-compliance driver.
- Pairing invariant tightened: streamable-http-client-2025-11-25 names
  client-initialise-server as its specific peer (alternatives noted).
- Progress demo honestly labeled API-shape-only (echo emits no progress
  events) in the source docs and the pairs table.

Gates: scripts/ci-gates.sh all → ALL GATES PASSED.

Author: hortovanyi

.github/workflows/ci.yml

@@ -69,7 +69,7 @@ jobs:
       - name: Bilingual client (not in default-members)
         run: cargo test -p turul-mcp-client
       - name: 2026 client example (pairs with minimal-server)
-        run: cargo build -p streamable-http-client-2026-07-28
+        run: cargo build -p streamable-http-client
 
   opt-in-2025:
     name: Opt-in lane (2025-11-25)

Cargo.toml

@@ -74,7 +74,7 @@ members = [
   "examples/session-logging-proof-test",
   "examples/session-management-compliance-test",
   "examples/streamable-http-client",
-  "examples/streamable-http-client-2026-07-28",
+  "examples/streamable-http-client-2025-11-25",
 
   # AWS/Lambda authorizer examples
   "examples/lambda-authorizer",

EXAMPLES.md

@@ -1,9 +1,12 @@
 # MCP Framework Examples
 
-This document provides a comprehensive overview of all **58 examples** in the MCP Framework, organized by learning progression from basic concepts to advanced implementations.
+This document provides a comprehensive overview of all **55 active examples** in the MCP Framework (plus `examples/archived/`), organized by learning progression from basic concepts to advanced implementations.
 
-**✅ All examples compile and phases 1-5 functionally verified (Compile → Start → Initialize → Execute)**
-**Last verified**: 2026-02-26 (v0.3.0, MCP 2025-11-25)
+**✅ All active examples compile under their lane's CI gates** (2026-07-28 default lane
++ per-manifest 2025-11-25 pins). Per-example functional re-verification against the
+2026 stateless core is tracked in `docs/plans/2026-07-28-examples-review.md` — the
+2026-02-26 "phases 1-5" sweep predates the 2026 cutover and no longer applies as stated.
+**Last verified**: 2026-06-12 (v0.4.0 branch — MCP 2026-07-28 default, 2025-11-25 opt-in)
 
 ## Client ↔ Server Example Pairs
 
@@ -12,8 +15,8 @@ lane** — run the server first, then point the client at it.
 
 | Client example | Lane | Corresponding server | Notes |
 |---|---|---|---|
-| `streamable-http-client-2026-07-28` | **2026-07-28** | `minimal-server` (port 8641) | The canonical 2026 stateless pair: `connect()` negotiation, discover retention, `call_tool`, request-scoped progress |
-| `streamable-http-client` | 2025-11-25 | any 2025-pinned server (e.g. `client-initialise-server`) | Hand-parsed 2025 POST SSE framing |
+| `streamable-http-client` | **2026-07-28** | `minimal-server` (port 8641) | The canonical 2026 stateless pair: `connect()` negotiation, discover retention, `call_tool`, and the request-scoped progress API (shape demo — `echo` emits no progress events) |
+| `streamable-http-client-2025-11-25` | 2025-11-25 | `client-initialise-server` (alternatives: any 2025-pinned server) | Hand-parsed 2025 POST SSE framing |
 | `client-initialise-report` | 2025-11-25 (wire-pinned) | `client-initialise-server` | Raw-wire lifecycle compliance probe |
 | `session-management-compliance-test` | 2025-11-25 (wire-pinned) | `client-initialise-server` | Session-contract regression client |
 | `logging-test-client` | 2025-11-25 | `logging-test-server` | `logging/setLevel` wire contract |
@@ -107,7 +110,8 @@ cargo run --example minimal-server
 |---------|------|--------|-------------|---------|
 | **client-initialise-server** | Server | ✅ VALIDATED | Client connectivity test server | MCP session initialization testing |
 | **client-initialise-report** | Client | ✅ VALIDATED | MCP client implementation | Tests server initialization |
-| **streamable-http-client** | Client | ✅ VALIDATED | Streamable HTTP client | MCP 2025-11-25 streaming demo |
+| **streamable-http-client** | Client | ✅ VALIDATED | 2026-07-28 stateless client (pairs with minimal-server) | connect() negotiation, discover retention, request-scoped progress API |
+| **streamable-http-client-2025-11-25** | Client | ✅ VALIDATED | Hand-parsed 2025 Streamable HTTP client | MCP 2025-11-25 streaming demo |
 | **logging-test-client** | Client | ✅ VALIDATED | Logging client | Tests logging functionality |
 | **session-management-compliance-test** | Combined | ✅ VALIDATED | Session compliance testing | MCP session spec compliance |
 
@@ -194,7 +198,7 @@ These examples demonstrate MCP 2025-11-25 type construction without starting a s
 - **Feature-Specific** - 8 examples (prompts, sampling, elicitation, etc.)
 - **Advanced/Composite** - 5 examples (comprehensive, alerts, audit, logging)
 - **Session & State** - 4 examples (stateful operations, logging)
-- **Client Examples** - 5 examples (client-server communication)
+- **Client Examples** - 7 examples (client-server communication — see the pairs table above)
 - **AWS Lambda** - 4 examples (server, streaming, client, authorizer)
 - **Tool Creation & Schemas** - 6 examples (macro patterns + output schemas)
 - **Middleware** - 4 examples (auth, logging, rate-limiting, Lambda auth)
@@ -247,4 +251,4 @@ cargo run --features dynamodb --example simple-dynamodb-session
 
 ---
 
-**📋 Framework Status**: v0.3.0 — Full MCP 2025-11-25 compliance including tasks, icons, sampling tools, and URL elicitation.
+**📋 Framework Status**: 0.4.0 branch (`feat/turul-mcp-protocol-2026-07-28`) — MCP 2026-07-28 stateless core by default with the 2025-11-25 stateful line as a per-manifest opt-in. Registered spec-gap status lives in `docs/plans/2026-07-28-spec-compliance.md`.

examples/client-initialise-report/Cargo.toml

@@ -1,7 +1,7 @@
 # 2025-11-25-ONLY by design: this raw-wire probe (no turul protocol deps)
 # hardcodes the 2025 lifecycle — initialize → notifications/initialized →
 # Mcp-Session-Id — and pairs with client-initialise-server (2025-pinned).
-# For the 2026 stateless pair see streamable-http-client-2026-07-28 +
+# For the 2026 stateless pair see streamable-http-client +
 # minimal-server.
 [package]
 name = "client-initialise-report"

examples/client-initialise-report/src/main.rs

@@ -3,7 +3,7 @@
 //! Raw-wire probe of the 2025-11-25 stateful lifecycle: `initialize` →
 //! `notifications/initialized` → `Mcp-Session-Id` on every request. Pairs
 //! with `client-initialise-server` (2025-pinned). The 2026-07-28 stateless
-//! pair is `streamable-http-client-2026-07-28` + `minimal-server`.
+//! pair is `streamable-http-client` + `minimal-server`.
 
 //! # MCP Initialize Session Report Client
 //!

examples/lambda-mcp-client/Cargo.toml

@@ -1,7 +1,7 @@
 # Test client for lambda-mcp-server, which is PINNED to the 2025-11-25
 # stateful lane — the bilingual McpClient inside negotiates down to 2025
 # against it (initialize handshake + Mcp-Session-Id). For the 2026 stateless
-# client pattern see streamable-http-client-2026-07-28.
+# client pattern see streamable-http-client.
 [package]
 name = "lambda-turul-mcp-client"
 version = "0.4.0"

examples/streamable-http-client-2025-11-25/Cargo.toml

@@ -0,0 +1,23 @@
+[package]
+name = "streamable-http-client-2025-11-25"
+version = "0.4.0"
+edition.workspace = true
+description = "MCP 2025-11-25 Streamable HTTP client example with multi-threaded SSE processing"
+
+# 2025-11-25 regression example; framework deps pinned to the 2025 opt-in
+# independent of the workspace 2026 default.
+[dependencies]
+turul-mcp-client = { workspace = true }
+turul-mcp-protocol = { path = "../../crates/turul-mcp-protocol", version = "0.4.0", default-features = false, features = ["protocol-2025-11-25"] }
+tokio = { workspace = true }
+anyhow = { workspace = true }
+serde_json = { workspace = true }
+tracing = { workspace = true }
+tracing-subscriber = { workspace = true }
+clap = { workspace = true }
+reqwest = { workspace = true }
+futures = { workspace = true }
+[[bin]]
+name = "streamable-http-client-2025-11-25"
+path = "src/main.rs"
+test = false