update changelog

Author: HosseinNejatiJavaremi

docs/changelog.md

@@ -2,6 +2,57 @@
 
 All notable changes to ArchiPy are documented in this changelog, organized by version.
 
+## [3.8.1] - 2025-09-04
+
+### Changed
+
+#### Dependency Updates
+- **Elasticsearch Version Bump** - Updated Elasticsearch Docker image from 9.1.2 to 9.1.3 in test configuration
+  - Enhanced test reliability with latest Elasticsearch stable version
+  - Improved test container compatibility and performance
+
+#### Code Quality Improvements
+- **Enhanced Keycloak Utils Type Safety** - Improved type handling in Keycloak utilities for gRPC metadata
+  - Fixed handling of both bytes and string metadata values in gRPC authentication
+  - Enhanced type conversion safety with proper string/bytes compatibility
+  - Improved authentication reliability across different gRPC implementations
+- **MyPy Configuration Enhancements** - Expanded MyPy overrides for better type checking coverage
+  - Added comprehensive overrides for Keycloak utilities, MinIO, Kafka, and payment gateway adapters
+  - Enhanced type checking for optional imports with proper type placeholders
+  - Improved development experience with more accurate type checking
+
+#### Library Updates
+- **Development Tools** - Updated multiple development dependencies for improved tooling
+  - Updated Ruff from 0.7.4 to 0.12.11 for enhanced linting capabilities
+  - Updated various type stubs packages for better IDE support and type checking
+  - Enhanced MkDocs Material theme from 9.6.7 to 9.6.18 for improved documentation
+- **Core Dependencies** - Updated runtime dependencies for better performance and security
+  - Updated fakeredis from 2.30.1 to 2.31.1 for improved Redis mocking
+  - Updated sentry-sdk from 2.33.0 to 2.36.0 for better error tracking
+  - Updated pymysql from 1.1.1 to 1.1.2 for enhanced MySQL compatibility
+  - Updated behave from 1.3.1 to 1.3.2 for improved BDD testing
+
+#### Documentation and Code Structure
+- **Enhanced CLAUDE.md** - Comprehensive documentation improvements for Claude Code integration
+  - Added detailed architecture overview with module descriptions
+  - Enhanced code style guidelines with Python 3.13+ requirements
+  - Improved command reference with complete development workflow
+  - Added comprehensive MyPy configuration documentation
+
+### Bug Fixes
+
+#### Type Safety
+- **Optional Import Handling** - Fixed type assignments for optional gRPC imports
+  - Resolved type compatibility issues when gRPC dependencies are not available
+  - Enhanced graceful degradation with proper type placeholders
+  - Improved development experience with better error messages
+
+#### Configuration
+- **Workflow Permissions** - Fixed potential security issues in GitHub Actions workflows
+  - Added proper permissions configuration to prevent unauthorized access
+  - Enhanced CI/CD security with explicit permission declarations
+  - Resolved code scanning alerts for workflow security best practices
+
 ## [3.8.0] - 2025-08-21
 
 ### Changed