Skip to content

Commit d43ce90

Browse files
committed
docs: fix stale example counts and 0.3-era status text
- EXAMPLES.md: archived count 30 → 29 (the 30th ls entry is archived/README.md, not an example); ALL 50 → 53 heading; category counts (feature-specific 11, type showcases 1); drop the empty performance-testing section heading; replace the 0.3-era KEY ACHIEVEMENTS block and stale verification blockquote with current lane framing - README.md: drop the stale '43 build on the 2026-07-28 default' exact count (×2) — reworded to lane framing with a pointer to EXAMPLES.md
1 parent d16a223 commit d43ce90

2 files changed

Lines changed: 15 additions & 20 deletions

File tree

EXAMPLES.md

Lines changed: 13 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -168,22 +168,17 @@ cargo run -p tasks-e2e-inmemory-server
168168
cargo run -p tasks-e2e-inmemory-client -- --url http://127.0.0.1:8080/mcp
169169
```
170170

171-
## 📖 **TYPE SHOWCASES** (4 examples) - Print-Only Demonstrations
171+
## 📖 **TYPE SHOWCASES** (1 example) - Print-Only Demonstrations
172172

173173
These examples demonstrate MCP 2025-11-25 type construction without starting a server:
174174

175175
| Example | Type | Status | Description | Types Demonstrated |
176176
|---------|------|--------|-------------|-------------------|
177177
| **icon-showcase** | Demo | ✅ VALIDATED | Icon support | `Icon` struct on tools, resources, prompts |
178178

179-
## 📚 **PERFORMANCE TESTING** (1 example) - Benchmarks
180-
181-
| Example | Type | Status | Description | Purpose |
182-
|---------|------|--------|-------------|---------|
183-
184179
## 🚨 **COMPREHENSIVE VALIDATION RESULTS**
185180

186-
### **ALL 50 ACTIVE EXAMPLES COMPILE UNDER THEIR LANE'S CI GATES**
181+
### **ALL 53 ACTIVE EXAMPLES COMPILE UNDER THEIR LANE'S CI GATES**
187182
**0.4.0 branch (MCP 2026-07-28 default, 2025-11-25 opt-in) — last reconciled 2026-06-12.**
188183
The per-example functional verification ledger lives in
189184
`docs/plans/2026-07-28-examples-review.md`; the 2026-06-12 migrate slice
@@ -192,28 +187,28 @@ re-verified its six examples live on the wire.
192187
- **Getting Started** - 5 examples (all tool creation levels)
193188
- **Session Storage** - 3 examples (SQLite, PostgreSQL, DynamoDB)
194189
- **Resource Servers** - 6 examples (session-aware resources)
195-
- **Feature-Specific** - 8 examples (prompts, sampling, elicitation, etc.)
190+
- **Feature-Specific** - 11 examples (prompts, sampling, elicitation, MRTR, origin policy, header binding, etc.)
196191
- **Advanced/Composite** - audit-trail, pagination, icon showcase
197192
- **Session & State** - stateful-server + session-aware-resource-server (2025-pinned) and the storage-backend trio
198-
- **Client Examples** - 7 examples (client-server communication — see the pairs table above)
193+
- **Client Examples** - see the pairs table above (9 pairing rows)
199194
- **AWS Lambda** - 4 examples (server, streaming, client, authorizer)
200195
- **Tool Creation & Schemas** - 6 examples (macro patterns + output schemas)
201196
- **Middleware** - 4 examples (auth, logging, rate-limiting, Lambda auth)
202197
- **Tasks** - 3 examples (MCP 2025-11-25 task lifecycle)
203198
- **Type Showcases** - 4 examples (print-only type demonstrations)
204-
- **Performance Testing** - 1 example (benchmarks)
205199

206-
> 50 examples functionally verified (Start → Initialize → Execute or Run → Check Output).
207-
> 2 skipped (external deps: PostgreSQL, DynamoDB). 2 blocked by client library bug (OPTIONS preflight).
208-
> 4 Lambda/performance examples compile-verified only. See `EXAMPLE_VERIFICATION_LOG.md`.
200+
> Lane-by-lane compilation is enforced by CI (`scripts/ci-gates.sh all`); the
201+
> 2026-06-12 disposition slices live-verified every migrated and new example.
202+
> Historical per-example verification notes: `EXAMPLE_VERIFICATION_LOG.md`
203+
> (0.3-era snapshot).
209204
210-
### 🎯 **KEY ACHIEVEMENTS**
211-
- **Session-Aware Resources**: All resources support SessionContext
212-
- **Full MCP 2025-11-25 Compliance**: Complete specification implementation
213-
- **Zero Breaking Changes**: All existing examples continue to work
205+
### 🎯 **CURRENT STATE**
206+
- **2026-07-28 default lane**: stateless core (per-request `_meta`, POST-only, `subscriptions/listen`, MRTR)
207+
- **2025-11-25 opt-in lane**: stateful session examples pinned per-manifest, feeding the regression gates
208+
- **Live-verified**: migrated and new examples were verified by running them and executing their own printed commands
214209

215210
### 📊 **Statistics**
216-
- **Total Examples**: 53 active (30 archived in `examples/archived/`)
211+
- **Total Examples**: 53 active (29 archived in `examples/archived/`)
217212
- **Session-Aware Resources**: 6 examples demonstrating session context integration
218213
- **Client-Server Pairs**: 9 pairing-table rows validating communication patterns
219214
- **Task Support**: 3 examples demonstrating MCP 2025-11-25 task lifecycle (InMemory storage)

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ A comprehensive Rust framework for building Model Context Protocol (MCP) servers
2424
## ✨ Key Highlights
2525

2626
- **🏗️ 15 Framework Crates**: Complete MCP ecosystem with core framework, client library, task storage, and serverless support
27-
- **📚 Comprehensive Examples**: Real-world business applications and framework demonstrations (43 build on the 2026-07-28 default; a small 2025-11-25 regression set is pinned to the opt-in)
27+
- **📚 Comprehensive Examples**: Real-world business applications and framework demonstrations (most build on the 2026-07-28 default lane; a 2025-11-25 regression set is pinned to the opt-in, and client-using examples are built by explicit CI steps — see EXAMPLES.md)
2828
- **🧪 Framework-Native Test Suite**: Core framework tests, SessionContext integration tests, and framework-native integration tests
2929
- **⚡ Multiple Development Patterns**: Derive macros, function attributes, declarative macros, and manual implementation
3030
- **🌐 Transport Flexibility**: Streamable HTTP via StreamableHttpHandler with SSE streaming (stdio planned)
@@ -1238,7 +1238,7 @@ This project is licensed under the MIT OR Apache-2.0 License - see the LICENSE f
12381238

12391239
### 🎯 Current Framework State
12401240
- **MCP 2026-07-28 adoption (this branch)**: default build targets the 2026-07-28 stateless core; 2025-11-25 remains fully supported as the opt-in stateful line
1241-
- **Examples Validated**: 43 examples build on the 2026-07-28 default; a small 2025-11-25 regression set is pinned to the opt-in
1241+
- **Examples Validated**: 53 active examples compile under their lane's CI gates (2026-07-28 default lane plus the pinned 2025-11-25 regression set — see EXAMPLES.md)
12421242
- **SSE Streaming Verified**: Real-time notifications and session-aware logging working correctly
12431243
- **Beta Status**: Active development with API stability considerations before 1.0.0
12441244

0 commit comments

Comments
 (0)