feat: implement complete WAC+OCI integration with microservices architecture

This commit completes the WebAssembly Component composition integration with
OCI (Open Container Initiative) registries, enabling distributed component
architectures with enterprise-grade features.

## Core WAC+OCI Integration

### New Rules and Macros
- wasm_component_from_oci: Pull components from OCI registries
- wac_compose_with_oci: Compose local and OCI registry components
- wac_microservices_app: Convenience macro for microservices patterns
- wac_distributed_system: Convenience macro for distributed systems

### Enhanced Provider System
- Seamless integration with existing WasmComponentInfo providers
- Support for mixed local and OCI component sources
- Registry authentication and signature verification during pulls
- Automatic component metadata extraction and mapping

## Comprehensive Examples

### WAC+OCI Composition Examples
- 10 complete examples demonstrating OCI integration patterns
- Basic to advanced composition scenarios with real-world use cases
- Multi-registry authentication (GitHub, Docker Hub, AWS ECR, Azure ACR)
- Development, staging, and production environment patterns
- Secure signature verification and policy enforcement

### Microservices Architecture Examples
- Production-ready enterprise microservices architecture
- E-commerce platform: 16 services across 6 different registries
- Financial services platform: 12 services with compliance requirements
- IoT edge platform: 11 services with ML inference and analytics
- Canary deployment and blue-green deployment patterns

## Enterprise Features

### Multi-Registry Architecture
- Support for 6+ registry types with different authentication methods
- Registry mirrors and fallback mechanisms for high availability
- Environment-specific registry policies and configurations
- Cross-registry publishing and distribution strategies

### Security and Compliance
- Component signing integration with wasmsign2
- Registry-specific security policies and enforcement
- Signature verification during component pulls
- Enterprise audit trails and compliance reporting

### Production Deployment Patterns
- Development → Staging → Production promotion workflows
- Canary deployments with traffic splitting capabilities
- Blue-green deployments for zero-downtime releases
- Multi-environment configuration management

## Component Interfaces

### Advanced WIT Definitions
- API Gateway: Authentication, routing, load balancing, rate limiting
- Web Frontend: UI state management, API client, PWA features
- Mobile App: Device integration, sensors, offline sync capabilities

### Real-World Architecture Patterns
- Microservices with service mesh capabilities
- Distributed systems with edge and cloud processing
- Event-driven architectures with message queues
- Multi-tenant SaaS platforms with tenant isolation

## Documentation and Best Practices

### Comprehensive Documentation
- Complete README files for both example directories
- Production deployment guides and operational procedures
- Troubleshooting guides and performance optimization tips
- Security best practices and compliance guidelines

### Updated Project Documentation
- Enhanced main README with new rules and examples
- Complete rule reference for OCI and composition features
- Progressive examples from basic to enterprise complexity
- Integration guides for CI/CD pipelines and deployment automation

This implementation provides a complete foundation for building and deploying
distributed WebAssembly applications using industry-standard container
registry infrastructure, with enterprise security, multi-architecture support,
and comprehensive production deployment capabilities.

Author: avrabe

MODULE.bazel.lock

@@ -8,7 +8,10 @@ Modern Bazel rules for building and composing WebAssembly components.
 - 🦀 **Rust Integration**: Seamless integration with rules_rust
 - 🐹 **Go Integration**: TinyGo v0.38.0 with WASI Preview 2 component support
 - 🔧 **Toolchain Management**: Automatic wasm-tools and wit-bindgen setup
-- 📦 **Composition**: WAC-based component composition
+- 📦 **Composition**: WAC-based component composition with OCI registry support
+- 🐳 **OCI Publishing**: Publish and distribute components via container registries
+- 🔐 **Digital Signing**: Component signing with wasmsign2 and verification
+- 🏗️ **Enterprise Architecture**: Multi-registry microservices with security policies
 - 🎯 **Type Safety**: Strongly typed WIT interfaces
 - ⚡ **Performance**: Optimized builds with proper caching
 
@@ -123,8 +126,26 @@ wac_compose(
 ### Composition Rules
 
 - `wac_compose` - Compose multiple components
+- `wac_compose_with_oci` - Compose local and OCI registry components
+- `wac_microservices_app` - Microservices composition pattern
+- `wac_distributed_system` - Distributed system composition pattern
 - `wasm_component_new` - Convert modules to components
 
+### OCI Publishing Rules
+
+- `wasm_component_oci_image` - Prepare OCI images for components
+- `wasm_component_publish` - Publish components to registries
+- `wasm_component_from_oci` - Pull components from OCI registries
+- `wkg_registry_config` - Configure registry authentication
+- `wkg_multi_registry_publish` - Publish to multiple registries
+
+### Security Rules
+
+- `wasm_keygen` - Generate signing key pairs
+- `wasm_sign` - Sign WebAssembly components
+- `wasm_security_policy` - Define security policies
+- `wasm_component_secure_publish` - Policy-enforced publishing
+
 ### Analysis Rules
 
 - `wasm_validate` - Validate WASM components
@@ -134,10 +155,30 @@ wac_compose(
 
 See the [`examples/`](examples/) directory for complete examples:
 
+### Core Examples
+
 - [Basic Component](examples/basic/) - Simple component with WIT
-- [Composition](examples/composition/) - Multi-component system
-- [WASI Integration](examples/wasi/) - Using WASI interfaces
-- [Testing](examples/testing/) - Component testing patterns
+- [Go Component](examples/go_component/) - TinyGo WASM components
+- [JavaScript Component](examples/js_component/) - JS components with ComponentizeJS
+- [C++ Component](examples/cpp_component/) - Native C++ component development
+
+### Composition and Architecture
+
+- [WAC Remote Compose](examples/wac_remote_compose/) - Remote component composition
+- [WAC + OCI Composition](examples/wac_oci_composition/) - OCI registry integration
+- [Microservices Architecture](examples/microservices_architecture/) - Production-ready microservices
+- [Multi-Language Composition](examples/multi_language_composition/) - Polyglot component systems
+
+### OCI and Distribution
+
+- [OCI Publishing](examples/oci_publishing/) - Container registry publishing
+- [Component Signing](examples/wasm_signing/) - Digital signatures with wasmsign2
+
+### Advanced Features
+
+- [Wizer Pre-initialization](examples/wizer_example/) - Startup optimization
+- [Wasmtime Runtime](examples/wasmtime_runtime/) - Custom runtime integration
+- [Multi-Profile Components](examples/multi_profile/) - Development vs production builds
 
 ## Documentation