fix: resolve CI compilation failure and professionalize documentation

Replace CacheAdapter.evictByPrefix() calls with inline prefix-based
eviction using keys() + evict(), since evictByPrefix is not yet
available in the published v26.02.06 CacheAdapter artifact.

Remove all emojis from documentation, professionalize language
(remove "new features" phrasing), and fix ASCII diagram alignment.

Author: ancongui

docs/README.md

@@ -2,7 +2,7 @@
 
 Welcome to the **fireflyframework-starter-data** starter documentation! This starter provides a standardized, production-ready foundation for building data processing microservices in the Firefly ecosystem.
 
-## 📖 What is fireflyframework-starter-data?
+## What is fireflyframework-starter-data?
 
 `fireflyframework-starter-data` is an opinionated Spring Boot starter that provides two main capabilities:
 
@@ -50,7 +50,7 @@ Python bridge package for `fireflyframework-genai` with tools, pipeline steps, a
 
 ---
 
-## 🚀 Quick Start
+## Quick Start
 
 ### Choose Your Path
 
@@ -68,14 +68,14 @@ Python bridge package for `fireflyframework-genai` with tools, pipeline steps, a
 
 ---
 
-## 📚 Documentation Structure
+## Documentation Structure
 
 ### [Data Jobs — Complete Guide](data-jobs/guide.md)
 Documentation for building orchestrated workflows (async and sync) in one place.
 
 ### [Data Enrichers](data-enrichers/README.md)
 Documentation for integrating with third-party providers:
-- **[Step-by-Step Guide](data-enrichers/enricher-microservice-guide.md)** - ⭐ Complete guide from scratch
+- **[Step-by-Step Guide](data-enrichers/enricher-microservice-guide.md)** - Complete guide from scratch
 - **[Data Enrichment Reference](data-enrichers/data-enrichment.md)** - Complete reference guide
 
 ### [Common Documentation](common/README.md)
@@ -90,16 +90,15 @@ Shared concepts, architecture, and utilities:
 - **[API Reference](common/api-reference.md)** - Complete API documentation
 - **[Examples](common/examples.md)** - Real-world usage patterns
 
-### [New Features](common/)
-Advanced capabilities added in this release:
+### [Advanced Capabilities](common/)
 - **[Data Quality Framework](common/data-quality.md)** - Rule-based validation and quality gates
 - **[Data Lineage Tracking](common/data-lineage.md)** - Provenance and audit trail
 - **[Data Transformation](common/data-transformation.md)** - Post-enrichment transformation pipelines
-- **[GenAI Bridge](common/genai-bridge.md)** - Native integration with fireflyframework-genai
+- **[GenAI Bridge](common/genai-bridge.md)** - Integration with fireflyframework-genai
 
 ---
 
-## 🎯 Common Tasks
+## Common Tasks
 
 ### Getting Started
 - **[Install the library](#installation)** - Add to your project
@@ -118,7 +117,7 @@ Advanced capabilities added in this release:
 
 ---
 
-## 📦 Installation
+## Installation
 
 ### Maven
 
@@ -152,52 +151,52 @@ Add the following to your `pom.xml`:
 
 ---
 
-## ✨ Key Features
+## Key Features
 
 ### Automatic Observability
-- ✅ **Distributed Tracing** - Micrometer integration with OpenTelemetry
-- ✅ **Metrics Collection** - Automatic metrics for all operations
-- ✅ **Health Checks** - Ready-to-use health check endpoints
-- ✅ **Comprehensive Logging** - Structured JSON logging
+- **Distributed Tracing** - Micrometer integration with OpenTelemetry
+- **Metrics Collection** - Automatic metrics for all operations
+- **Health Checks** - Ready-to-use health check endpoints
+- **Comprehensive Logging** - Structured JSON logging
 
 ### Automatic Resiliency
-- ✅ **Circuit Breaker** - Prevent cascading failures
-- ✅ **Retry Logic** - Exponential backoff with jitter
-- ✅ **Rate Limiting** - Protect external APIs
-- ✅ **Bulkhead Isolation** - Isolate failures
+- **Circuit Breaker** - Prevent cascading failures
+- **Retry Logic** - Exponential backoff with jitter
+- **Rate Limiting** - Protect external APIs
+- **Bulkhead Isolation** - Isolate failures
 
 ### Event-Driven Architecture
-- ✅ **Automatic Event Publishing** - Job and enrichment lifecycle events
-- ✅ **CQRS Integration** - Command/Query separation
-- ✅ **SAGA Support** - Distributed transaction patterns
-
-### Data Quality & Lineage
-- ✅ **Quality Gates** - Rule-based validation with fail-fast and collect-all strategies
-- ✅ **Data Lineage** - Track provenance across enrichments and transformations
-- ✅ **Transformation Pipelines** - Composable field mapping and computed fields
-
-### Enrichment Enhancements
-- ✅ **Fallback Chains** - Automatic provider failover with `@EnricherFallback`
-- ✅ **Per-Provider Resilience** - Independent circuit breaker, retry, rate limiter per provider
-- ✅ **Cost Tracking** - Per-provider call counting and cost reports
-- ✅ **Preview/Dry-Run** - Preview enrichment routing without execution
-- ✅ **SSE Streaming** - Real-time batch enrichment results via Server-Sent Events
-- ✅ **Job Timeouts** - Configurable per-stage timeout enforcement
+- **Automatic Event Publishing** - Job and enrichment lifecycle events
+- **CQRS Integration** - Command/Query separation
+- **SAGA Support** - Distributed transaction patterns
+
+### Data Quality and Lineage
+- **Quality Gates** - Rule-based validation with fail-fast and collect-all strategies
+- **Data Lineage** - Track provenance across enrichments and transformations
+- **Transformation Pipelines** - Composable field mapping and computed fields
+
+### Enrichment Capabilities
+- **Fallback Chains** - Automatic provider failover with `@EnricherFallback`
+- **Per-Provider Resilience** - Independent circuit breaker, retry, rate limiter per provider
+- **Cost Tracking** - Per-provider call counting and cost reports
+- **Preview/Dry-Run** - Preview enrichment routing without execution
+- **SSE Streaming** - Real-time batch enrichment results via Server-Sent Events
+- **Job Timeouts** - Configurable per-stage timeout enforcement
 
 ### GenAI Integration
-- ✅ **Native Bridge** - Python package for `fireflyframework-genai` integration
-- ✅ **AI Agent Tools** - Data enrichment and job management as agent tools
-- ✅ **Pipeline Steps** - Enrichment and quality gate steps for GenAI pipelines
+- **Native Bridge** - Python package for `fireflyframework-genai` integration
+- **AI Agent Tools** - Data enrichment and job management as agent tools
+- **Pipeline Steps** - Enrichment and quality gate steps for GenAI pipelines
 
 ### Developer Experience
-- ✅ **Abstract Base Classes** - Minimal boilerplate code
-- ✅ **Type-Safe APIs** - Compile-time safety
-- ✅ **Reactive Programming** - Non-blocking operations with Project Reactor
-- ✅ **Comprehensive Testing** - Test utilities and examples
+- **Abstract Base Classes** - Minimal boilerplate code
+- **Type-Safe APIs** - Compile-time safety
+- **Reactive Programming** - Non-blocking operations with Project Reactor
+- **Comprehensive Testing** - Test utilities and examples
 
 ---
 
-## 🏗️ Architecture
+## Architecture
 
 The library follows **Hexagonal Architecture** (Ports and Adapters):
 
@@ -235,7 +234,7 @@ The library follows **Hexagonal Architecture** (Ports and Adapters):
 
 ---
 
-## 📖 Documentation Index
+## Documentation Index
 
 ### By Feature
 - **[Data Jobs — Complete Guide](data-jobs/guide.md)** - Orchestrated workflows
@@ -251,7 +250,7 @@ The library follows **Hexagonal Architecture** (Ports and Adapters):
 
 ---
 
-## 🤝 Support
+## Support
 
 For questions, issues, or contributions:
 - Check the [Examples](common/examples.md) for common patterns
@@ -260,7 +259,7 @@ For questions, issues, or contributions:
 
 ---
 
-## 📝 License
+## License
 
 Copyright © 2024-2026 Firefly Software Solutions Inc. All rights reserved.
 

docs/common/README.md

@@ -2,7 +2,7 @@
 
 This section contains documentation that applies to **both Data Jobs and Data Enrichers** - shared concepts, architecture, configuration, and utilities.
 
-## 📖 What's in Common Documentation?
+## What's in Common Documentation?
 
 These topics are relevant whether you're building data jobs, data enrichers, or both:
 - Architecture and design patterns
@@ -15,7 +15,7 @@ These topics are relevant whether you're building data jobs, data enrichers, or
 
 ---
 
-## 📚 Core Documentation
+## Core Documentation
 
 ### Architecture & Design
 
@@ -28,12 +28,12 @@ These topics are relevant whether you're building data jobs, data enrichers, or
 - Component interactions
 
 **Topics covered**:
-- ✅ Dependency inversion and interface segregation
-- ✅ Pluggable adapters for different platforms
-- ✅ Reactive programming with Project Reactor
-- ✅ Event-driven architecture integration
-- ✅ CQRS pattern support
-- ✅ SAGA pattern for distributed transactions
+- Dependency inversion and interface segregation
+- Pluggable adapters for different platforms
+- Reactive programming with Project Reactor
+- Event-driven architecture integration
+- CQRS pattern support
+- SAGA pattern for distributed transactions
 
 ---
 
@@ -51,12 +51,12 @@ These topics are relevant whether you're building data jobs, data enrichers, or
 - Resiliency configuration
 
 **Topics covered**:
-- ✅ YAML configuration examples
-- ✅ Property reference
-- ✅ Environment profiles
-- ✅ Feature toggles
-- ✅ Connection configuration
-- ✅ Timeout and retry settings
+- YAML configuration examples
+- Property reference
+- Environment profiles
+- Feature toggles
+- Connection configuration
+- Timeout and retry settings
 
 ---
 
@@ -70,12 +70,12 @@ These topics are relevant whether you're building data jobs, data enrichers, or
 - Integration with monitoring systems (Prometheus, Grafana, Jaeger, Grafana Tempo)
 
 **Topics covered**:
-- ✅ Automatic tracing for all operations
-- ✅ Custom trace spans
-- ✅ Metrics for jobs and enrichments
-- ✅ Health check endpoints
-- ✅ Performance monitoring
-- ✅ Error tracking
+- Automatic tracing for all operations
+- Custom trace spans
+- Metrics for jobs and enrichments
+- Health check endpoints
+- Performance monitoring
+- Error tracking
 
 ---
 
@@ -90,11 +90,11 @@ These topics are relevant whether you're building data jobs, data enrichers, or
 - Fallback strategies
 
 **Topics covered**:
-- ✅ Resilience4j integration
-- ✅ Automatic resiliency for jobs and enrichments
-- ✅ Configuration examples
-- ✅ Custom resiliency strategies
-- ✅ Monitoring resiliency metrics
+- Resilience4j integration
+- Automatic resiliency for jobs and enrichments
+- Configuration examples
+- Custom resiliency strategies
+- Monitoring resiliency metrics
 
 ---
 
@@ -108,11 +108,11 @@ These topics are relevant whether you're building data jobs, data enrichers, or
 - Best practices
 
 **Topics covered**:
-- ✅ Automatic logging for all operations
-- ✅ Request/response logging
-- ✅ Error logging with stack traces
-- ✅ Performance logging
-- ✅ Integration with log aggregation systems (ELK, Splunk)
+- Automatic logging for all operations
+- Request/response logging
+- Error logging with stack traces
+- Performance logging
+- Integration with log aggregation systems (ELK, Splunk)
 
 ---
 
@@ -127,12 +127,12 @@ These topics are relevant whether you're building data jobs, data enrichers, or
 - Best practices
 
 **Topics covered**:
-- ✅ Testing data jobs
-- ✅ Testing data enrichers
-- ✅ Testing custom operations
-- ✅ Testing with MockWebServer
-- ✅ Testing resiliency patterns
-- ✅ Test coverage strategies
+- Testing data jobs
+- Testing data enrichers
+- Testing custom operations
+- Testing with MockWebServer
+- Testing resiliency patterns
+- Test coverage strategies
 
 ---
 
@@ -147,11 +147,11 @@ These topics are relevant whether you're building data jobs, data enrichers, or
 - Best practices
 
 **Topics covered**:
-- ✅ Setting up MapStruct
-- ✅ Creating mappers
-- ✅ Field mapping
-- ✅ Custom converters
-- ✅ Testing mappers
+- Setting up MapStruct
+- Creating mappers
+- Field mapping
+- Custom converters
+- Testing mappers
 
 ---
 
@@ -164,11 +164,11 @@ These topics are relevant whether you're building data jobs, data enrichers, or
 - OpenAPI/Swagger documentation
 
 **Topics covered**:
-- ✅ Data job endpoints
-- ✅ Data enrichment endpoints
-- ✅ Discovery endpoints
-- ✅ Health check endpoints
-- ✅ Custom operation endpoints
+- Data job endpoints
+- Data enrichment endpoints
+- Discovery endpoints
+- Health check endpoints
+- Custom operation endpoints
 
 ---
 
@@ -183,14 +183,14 @@ These topics are relevant whether you're building data jobs, data enrichers, or
 - Advanced scenarios
 
 **Topics covered**:
-- ✅ Complete working examples
-- ✅ Best practices
-- ✅ Common patterns
-- ✅ Integration scenarios
+- Complete working examples
+- Best practices
+- Common patterns
+- Integration scenarios
 
 ---
 
-## 🎯 Common Tasks
+## Common Tasks
 
 ### I want to...
 
@@ -220,14 +220,14 @@ These topics are relevant whether you're building data jobs, data enrichers, or
 
 ---
 
-## 🔗 Related Documentation
+## Related Documentation
 
 - **[Data Jobs — Complete Guide](../data-jobs/guide.md)** - For orchestrated workflows
 - **[Data Enrichers](../data-enrichers/README.md)** - For third-party provider integration
 
 ---
 
-## 📋 Document Index
+## Document Index
 
 ### Architecture & Design
 - [architecture.md](architecture.md) - Hexagonal architecture and design patterns