Release Notes — v0.5.0¶
Release Date: 2026-05-19
TaipanStack v0.5.0 focuses on security hardening for security guards and JWT token parsing, structural typing cleanups across result modules, and significant QA optimizations. The entire test suite was consolidated and refactored for absolute robustness, maintaining a strict 100% genuine code and branch coverage across the project with a leaner 1,241 passing tests.
🛡️ Security¶
- Fix (High) — Path Traversal Guard Hardening: Fixed path traversal guard crashes and null byte injection vectors in security guards, validated via new property-based fuzz tests (PR #741).
- Fix (High) — JWT Fuzzing Hardening: Hardened JWT encode and decode functions against malformed inputs and data types via property-based fuzzing (PR #775).
- Fix (Medium) — Project Name Validator: Fixed an
IndexErrorraised when validating empty project name strings (PR #768).
🌊 Resilience¶
- Fix — Resilience Orchestrator Double Wrapping: Fixed double-wrapping of
Resultobjects inResilienceOrchestratorexecution flows (PR #767). - Hardening — Circuit Breaker Configuration: Frozen
CircuitBreakerConfigusing Pydantic frozen model configurations to prevent runtime type mutations during chaos testing (PR #778). - Hardening — Rate Limiter Resilience: Hardened the rate limiter against token type mutation under daily micro-chaos tests (PR #771).
⚡ Refactoring & Typing¶
- Type Guards — Result Monad Structural Typing: Enforced strict
isinstancetype guards forResultmonads to resolve Mypy type-narrowing warnings (PR #746, PR #763, PR #777). - Complexity Refactor: Reduced cyclomatic complexity in both resilience and bridge modules to improve codebase maintainability (PR #770).
- Imports Cleanup: Standardized test absolute imports to refer to the canonical
taipanstacknamespace instead ofsrc.taipanstack(PR #765). - Consolidation: Streamlined dependency files and consolidated CI/CD, dependency, and linting configurations (PR #764).
✅ QA & Testing¶
- Test Suite Refactoring & Optimization: Refactored the test suite for absolute robustness, removing legacy coverage files and introducing focused edge-case tests, resulting in 1,241 passing tests while preserving 100% verified genuine coverage (PR #773, PR #781, PR #782).
- Coverage Requirement Elevation: Elevated the test coverage requirement to a strict 100% genuine branch coverage across the entire project (PR #764) and removed redundant coverage exclusions (PR #769).
- Result Module Fallbacks: Improved coverage of fallback branches in core result module operations (PR #772).
⚙️ CI/CD & Infrastructure¶
- Pipeline Standardization: Optimized, cleaned up, and standardized CI/CD pipelines to ensure zero-bypass execution (PR #779).
📚 Documentation¶
- Bug Report Template: Updated the GitHub bug report template to reference the current version info (PR #774).
- Release Synchronization: Synchronized project version and release notes across all documentation portals (PR #766, PR #780).