---
title: "Changelog 3.8.1"
description: "Release notes for ArchiPy 3.8.1"
---

# 3.8.1 — 2025-09-04

[← 3.9.0](3.9.0.md) | [3.8.0 →](3.8.0.md) | [↑ 3.x series](index.md)

## 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
