Add API and Hub/Marketplace protocol examples, update main README

Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>

Author: Copilot

README.md

@@ -34,14 +34,24 @@ ObjectStack is a metadata-driven platform built on three foundational protocols:
 
 - **Getting Started:**
   - [Introduction](./content/docs/introduction/) - Core concepts and architecture
-  - [Quick Start Examples](./examples/) - CRM, Todo, and plugin examples
+  - [📚 Examples Catalog](./examples/README.md) - **Comprehensive examples for all protocols**
+  - [Quick Start: Todo App](./examples/todo/) - Simplest complete example
+  - [Quick Start: Basic Examples](./examples/basic/) - Protocol-by-protocol examples
 
 - **Protocol References:**
-  - [Protocol Reference](./content/docs/references/) - All 70 protocol specifications
+  - [Protocol Reference](./content/docs/references/) - All 70+ protocol specifications
   - [ObjectQL](./content/docs/objectql/) - Data layer documentation
   - [ObjectUI](./content/docs/objectui/) - UI layer documentation
   - [ObjectOS](./content/docs/objectos/) - System layer documentation
 
+- **Examples by Use Case:**
+  - [CRM Example](./examples/crm/) - Full-featured enterprise CRM
+  - [AI Examples](./examples/) - AI Sales, Support, Analyst, Codegen
+  - [Integration Examples](./examples/basic/integration-connectors-example.ts) - External system connectors
+  - [System Examples](./examples/basic/system-protocols-example.ts) - Production-grade patterns
+  - [API Examples](./examples/basic/api-protocols-example.ts) - GraphQL, OData, WebSocket
+  - [Hub Examples](./examples/basic/hub-marketplace-example.ts) - Marketplace & Plugins
+
 - **Development:**
   - [Architecture Guide](./ARCHITECTURE.md) - Complete architecture overview
   - [MicroKernel Architecture](./content/docs/developers/micro-kernel.mdx) - Plugin architecture guide

examples/basic/README.md

@@ -182,6 +182,54 @@ Shows advanced system protocols for production applications:
 - Security and encryption
 - Distributed systems patterns
 
+### Logger & Debugging
+**File:** [`logger-example.ts`](./logger-example.ts)
+
+Demonstrates structured logging patterns for production applications.
+
+**Key Concepts:**
+- Structured logging with metadata
+- Log levels and filtering
+- Context propagation
+- Performance logging
+
+### API Protocols (Advanced)
+**File:** [`api-protocols-example.ts`](./api-protocols-example.ts)
+
+Demonstrates advanced API protocols beyond REST:
+- GraphQL API (Schema, Resolvers, Subscriptions)
+- OData API (Query capabilities, Metadata)
+- WebSocket/Realtime API (Pub/Sub, Live queries)
+- Batch Operations (Bulk create/update/delete)
+- API Rate Limiting & Versioning
+
+**Key Concepts:**
+- Flexible query languages (GraphQL, OData)
+- Real-time communication (WebSocket)
+- Subscription patterns
+- Batch processing for efficiency
+- Query complexity and cost analysis
+- API security and throttling
+
+### Hub & Marketplace
+**File:** [`hub-marketplace-example.ts`](./hub-marketplace-example.ts)
+
+Shows the ObjectStack ecosystem and plugin marketplace:
+- Plugin Registry (Publishing and discovery)
+- Marketplace (Commercial distribution)
+- Licensing (Subscription and perpetual)
+- Multi-tenancy (Tenant isolation)
+- Spaces (Team workspaces)
+- Composer (Visual app builder)
+
+**Key Concepts:**
+- Plugin ecosystem management
+- SaaS subscription models
+- Tenant data isolation
+- No-code/low-code platforms
+- Commercial software distribution
+- Enterprise features (SSO, custom domains)
+
 ## 🎯 Usage
 
 These examples are TypeScript files in a proper package that can be: