Version History

Complete history of SmartRAG releases with detailed change information.

Version 2.3.0 - 2025-09-16

Latest Release

This is the current stable release with Google Speech-to-Text integration and enhanced developer experience.

Added

Google Speech-to-Text Integration: Enterprise-grade speech recognition with Google Cloud AI
Enhanced Language Support: 100+ languages including Turkish, English, and global languages
Real-time Audio Processing: Advanced speech-to-text conversion with confidence scoring
Detailed Transcription Results: Segment-level transcription with timestamps and confidence metrics
Automatic Format Detection: Support for MP3, WAV, M4A, AAC, OGG, FLAC, WMA formats
Intelligent Audio Processing: Smart audio stream validation and error handling
Performance Optimized: Efficient audio processing with minimal memory footprint
Structured Audio Output: Converts audio content to searchable, queryable knowledge base
Comprehensive XML Documentation: Complete API documentation for all public classes and methods

Improved

Audio Processing Pipeline: Enhanced audio processing with Google Cloud AI
Configuration Management: Updated all configuration files to use GoogleSpeechConfig
Error Handling: Enhanced error handling for audio transcription operations
Documentation: Updated all language versions with Google Speech-to-Text examples
Code Quality: Zero warnings policy compliance with SOLID/DRY principles
Security: Fixed CodeQL high severity vulnerability with log injection protection

Documentation

Audio Processing: Comprehensive audio processing feature documentation
Multi-language Support: Updated all language versions (EN, TR, DE, RU) with examples
API Documentation: Complete XML documentation for all public APIs
Developer Experience: Better developer experience with detailed audio processing examples

Version 2.2.0 - 2025-09-15

Previous Release

Previous stable release with enhanced OCR documentation and visibility improvements.

Enhanced OCR Documentation: Comprehensive documentation showcasing OCR capabilities with real-world use cases
Improved README: Detailed image processing features highlighting Tesseract 5.2.0 + SkiaSharp integration
Use Case Examples: Added detailed examples for scanned documents, receipts, and image content processing
Package Metadata: Updated project URLs and release notes for better user experience
Documentation Structure: Enhanced documentation showcasing OCR as key differentiator
User Guidance: Improved guidance for image-based document processing workflows
WebP Support: Highlighted WebP to PNG conversion and multi-language OCR support
Developer Experience: Better visibility of image processing features for developers

Version 2.1.0 - 2025-09-05

Previous Release

Previous stable release with automatic session management and conversation history.

Automatic Session Management: No more manual session ID handling required
Persistent Conversation History: Conversations survive application restarts
New Conversation Commands: /new, /reset, /clear for conversation control
Enhanced API: Backward-compatible with optional startNewConversation parameter
Storage Integration: Works seamlessly with all providers (Redis, SQLite, FileSystem, InMemory)
Format Consistency: Standardized conversation format across all storage providers
Thread Safety: Enhanced concurrent access handling for conversation operations
Platform Agnostic: Maintains compatibility with all .NET environments
Documentation Updates: All language versions (EN, TR, DE, RU) updated with real examples
100% Compliance: All established rules maintained with zero warnings policy

Version 2.0.0 - 2025-08-27

Previous Release

Previous stable release with .NET Standard 2.0/2.1 migration.

.NET Standard 2.0/2.1: Compatibility with .NET Framework 4.6.1+, .NET Core 2.0+, .NET 5+
Maximum Compatibility: Support for legacy and enterprise .NET applications
Framework Change: Migration from .NET 9.0 to .NET Standard
Package Dependencies: Updated package versions for compatibility

Version 1.1.0 - 2025-08-22

Previous Release

Previous stable release with Excel support and enhanced features.

Added

💬 Conversation History: Automatic session-based conversation management with context awareness
Session Management: Unique session IDs for maintaining conversation context across multiple questions
Intelligent Context Truncation: Smart conversation history truncation to maintain optimal performance
Storage Integration: Conversation data storage using configured storage providers (Redis, SQLite, etc.)
Enhanced API: Updated GenerateRagAnswerAsync method with sessionId parameter
Real Examples: Updated all documentation examples to use actual implementation code

Improved

Documentation Reality: All examples now match actual codebase implementation
Multi-language Support: Updated all language versions (EN, TR, DE, RU) with conversation features
API Consistency: Ensured all API examples use real SearchController and SearchRequest models
Code Quality: Applied Zero Warnings Policy with 0 errors, 0 warnings, 0 messages

Fixed

Documentation Accuracy: Removed all fictional examples and replaced with real implementation
Build Compliance: Achieved 100% compliance with SOLID and DRY principles
Magic Numbers: Converted all magic numbers to named constants
Logging Standards: Implemented LoggerMessage delegates for all conversation operations

Version 1.1.0 - 2025-08-22

Added

Excel File Support: Added Excel file parsing (.xlsx, .xls) with EPPlus 8.1.0 integration
Enhanced Retry Logic: Improved Anthropic API retry mechanism for HTTP 529 (Overloaded) errors
Content Validation: Enhanced document content validation
Excel Documentation: Comprehensive Excel format documentation

Version 1.0.3 - 2025-08-20

Added

Multi-language Support: Added comprehensive documentation in English, Turkish, German, and Russian
GitHub Pages: Complete documentation site with modern Bootstrap design
Enhanced Examples: Added comprehensive code examples and tutorials
Troubleshooting Guide: Detailed troubleshooting and debugging information
Contributing Guidelines: Complete contribution guide with coding standards

Improved

Documentation: Complete rewrite with modern design and better organization
Code Examples: More realistic and comprehensive examples
API Reference: Detailed API documentation with usage patterns
Configuration Guide: Enhanced configuration options and best practices

Fixed

Type Conflicts: Resolved conflicts between Qdrant, OpenXML, and other libraries
Global Usings: Implemented GlobalUsings for all projects to reduce code duplication
Build Issues: Fixed various compilation and build warnings

Version 1.0.2 - 2025-08-19

Added

Global Usings: Implemented GlobalUsings for SmartRAG core library
Type Resolution: Added explicit type resolution for conflicting types
Enhanced Logging: Improved logging with LoggerMessage delegates

Improved

Code Organization: Better #region organization and SOLID principles
Performance: Optimized document processing and storage operations
Error Handling: Enhanced error handling and exception management

Fixed

Build Warnings: Resolved all compiler warnings and messages
Type Conflicts: Fixed conflicts between external library types
Memory Leaks: Improved resource disposal and memory management

Version 1.0.1 - 2025-08-17

Added

Test Project: Added comprehensive xUnit test suite
Example Web API: Complete example web application
Documentation: Initial documentation structure

Improved

Code Quality: Applied SOLID and DRY principles
Error Handling: Better exception handling and validation
Logging: Structured logging throughout the application

Fixed

Minor Bugs: Various bug fixes and improvements
Performance: Optimized document processing
Security: Enhanced input validation and sanitization

Version 1.0.0 - 2025-08-15

Initial Release

Core RAG Functionality: Document processing, embedding generation, and semantic search
AI Provider Support: OpenAI, Anthropic, Azure OpenAI, and Gemini integration
Storage Providers: Qdrant, Redis, SQLite, In-Memory, and File System support
Document Formats: PDF, Word, Excel, and text document processing
.NET 8 Support: Full compatibility with .NET 8 LTS
Dependency Injection: Native .NET dependency injection support
Async/Await: Full asynchronous operation support
Extensible Architecture: Plugin-based provider system

Versioning

SmartRAG follows Semantic Versioning (SemVer):

MAJOR: Incompatible API changes
MINOR: New functionality in a backwards compatible manner
PATCH: Backwards compatible bug fixes

Release Schedule

Major Releases: Every 6-12 months with significant new features
Minor Releases: Every 2-3 months with new functionality
Patch Releases: As needed for critical bug fixes

Breaking Changes

Important breaking changes between versions.

Good News

No breaking changes between versions 1.0.0 and 1.2.0. All updates are backward compatible.

Migration Guides

All version updates from 1.0.0 to 1.2.0 are fully backward compatible. No migration is required.

New Conversation History Feature

To use the new conversation history feature, simply add a SessionId parameter to your existing API calls:

// Before (still works)
var response = await _documentSearchService.GenerateRagAnswerAsync(query, maxResults);

// After (with conversation history)
var response = await _documentSearchService.GenerateRagAnswerAsync(query, sessionId, maxResults);

Support Policy

Our commitment to supporting different versions of SmartRAG.

Current Version: Full support and bug fixes
Previous Version: Security updates and critical bug fixes only
Older Versions: No support

Roadmap

Upcoming features and future plans for SmartRAG.

Upcoming Features (1.3.0)

Advanced Chunking: Intelligent document chunking strategies
Custom Embeddings: Support for custom embedding models
Batch Processing: Improved batch document processing
Performance Monitoring: Built-in performance metrics and monitoring
Cloud Integration: Enhanced cloud provider support

Future Plans (2.0.0)

Multi-modal Support: Image and audio document processing
Advanced Search: Semantic search with context awareness
Real-time Updates: Live document indexing and search
Distributed Processing: Support for distributed deployments
Advanced Analytics: Document usage and search analytics

Contributing to Changelog

When contributing to SmartRAG, please update the changelog:

Add your changes to the appropriate section
Use consistent formatting following the existing style
Group changes by type (Added, Improved, Fixed, etc.)
Provide clear descriptions of what changed
Include breaking changes in a separate section

Changelog Entry Format

### Added
- **Feature Name**: Brief description of the new feature

### Improved
- **Component Name**: Description of improvements made

### Fixed
- **Issue Description**: Description of the bug fix

Need Help?

If you need assistance with version updates: