Current Version
Latest Release: v2.8.0 (2025-10-22) Highlights: Test Coverage +35% (85%+ overall), Docker-based integration testing infrastructure, 61 new comprehensive test casesVersion Comparison Matrix
| Feature | v2.8 | v2.7 | v2.6 | v2.5 | v2.4 | v2.3 | v2.2 | v2.1 |
|---|---|---|---|---|---|---|---|---|
| Authentication & Sessions | ||||||||
| Keycloak SSO Integration | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Redis Session Management | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Session Store Architecture | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Provider Pattern | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Compliance & Security | ||||||||
| GDPR Data Subject Rights | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| SOC 2 Automation | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| HIPAA Technical Safeguards | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| SLA Monitoring (99.9%) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| Data Retention Policies | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| Compliance Storage Backend | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
| Testing & Quality | ||||||||
| Unit Tests (498+) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Integration Tests | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Docker Integration Tests | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| 100% Test Pass Rate | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
| Property-Based Testing | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Contract Testing | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Test Coverage | 85%+ | ~75% | ~75% | ~75% | ~75% | ~75% | ~75% | ~75% |
| Documentation | ||||||||
| Mintlify Docs | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Architecture Decision Records | 30 ADRs | 30 ADRs | 26 ADRs | 21 ADRs | 21 ADRs | 21 ADRs | 5 ADRs | 5 ADRs |
| Core Features | ||||||||
| LangGraph Version | 0.6.10 | 0.6.10 | 0.6.10 | 0.6.10 | 0.6.10 | 0.2.28 | 0.2.28 | 0.2.28 |
| Multi-LLM Support (LiteLLM) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| OpenFGA Authorization | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Pydantic Version | V2 | V2 | V2 | V2 | V2 | V2 | V1 | V1 |
| Type Safety Coverage | 64% | 64% | 64% | 64% | 64% | 64% | 27% | 27% |
| Agentic Loop (GAVR) | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Anthropic Best Practices | 9.8/10 | 9.8/10 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Secrets Management | ||||||||
| Infisical Integration | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Infisical Docker Builds | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| 5 Installation Options | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| Deployment | ||||||||
| Kubernetes/Helm/Kustomize | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Multi-Cloud (GKE/EKS/AKS) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Docker Compose | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Observability | ||||||||
| OpenTelemetry + LangSmith | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Grafana Dashboards | 9 | 9 | 9 | 9 | 9 | 9 | 9 | 7 |
| Prometheus Alerts | 20+ SLA | 20+ SLA | 20+ SLA | 20+ SLA | 20+ SLA | 20+ SLA | 20+ SLA | Basic |
Release Highlights
v2.8.0 - Test Coverage Boost
Test coverage +35% (85%+) + Infrastructure improvements
v2.7.0 - Agentic AI Ready
Agentic loop + Anthropic best practices (9.8/10)
v2.6.0 - CI/CD Hardening
CI/CD fixes + Documentation improvements
v2.5.0 - Integration Testing
Docker integration tests + Infisical builds
v2.4.0 - LangGraph Upgrade
LangGraph 0.6.10 + 100% test pass rate
v2.3.0 - Type Safety
Storage backend + Pydantic V2
v2.2.0 - Enterprise Compliance
GDPR/SOC2/HIPAA compliance automation
v2.1.0 - Production Ready
Keycloak SSO + Production hardening
v2.0.0 - Major Restructure
Package reorganization (breaking)
Version Timeline
Migration Guides
v2.7.0 → v2.8.0 (Latest)
v2.7.0 → v2.8.0 (Latest)
Breaking Changes: NoneNew Features:
- Test coverage improvements (+35% overall, now 85%+)
- Docker Compose test environment (Qdrant, Redis, PostgreSQL)
- 61 new comprehensive test cases
- 25 previously-skipped tests now enabled
- Update dependencies:
uv sync - Run tests with new Docker infrastructure:
make test-integration - Review new test coverage reports
- Update CI/CD to use Docker Compose test environment
v2.3.0 → v2.4.0
v2.3.0 → v2.4.0
Breaking Changes: NoneNew Features:
- LangGraph 0.6.10 (API compatible)
- 100% test pass rate (437/437)
- 21 comprehensive ADRs
- Update dependencies:
uv sync - Run tests:
make test - Review new ADRs for architectural guidance
v2.2.0 → v2.3.0
v2.2.0 → v2.3.0
Breaking Changes: None (Pydantic V2 backward compatible)New Features:
- Compliance storage backend (5 interfaces)
- Pydantic V2 migration
- Type safety enhanced (27% → 64%)
- Review Pydantic V2 changes if extending models
- Run type checks:
mypy src/ - Test compliance storage integration
v2.1.0 → v2.2.0
v2.1.0 → v2.2.0
Breaking Changes: NoneNew Features:
- GDPR/SOC2/HIPAA compliance automation
- SLA monitoring with 20+ Prometheus alerts
- 2 new Grafana dashboards
- Configure compliance settings in
.env - Import new Grafana dashboards
- Review Prometheus alert rules
- Set up data retention policies
v2.0.0 → v2.1.0
v2.0.0 → v2.1.0
Breaking Changes: None (v2.0.0 was the breaking change)New Features:
- Keycloak SSO integration
- Redis session management
- Kubernetes/Helm deployment infrastructure
- 43 MDX documentation files
- Set up Keycloak if using SSO:
make setup-keycloak - Configure Redis for sessions
- Review Kubernetes deployment guides
v1.x → v2.0.0
v1.x → v2.0.0
Breaking Changes: ⚠️ Major package reorganizationImport Path Changes:Recommended Actions:
- Update all imports to new structure
- Review migration guide in CHANGELOG
- Update CI/CD pipelines
- Test thoroughly before deploying
Deprecation Schedule
| Feature | Deprecated In | Removed In | Alternative |
|---|---|---|---|
| HTTP/SSE Transport | v2.0.0 | v2.0.0 | StreamableHTTP transport |
| Pydantic V1 | v2.3.0 | v3.0.0 | Pydantic V2 models |
Semantic Versioning
This project follows Semantic Versioning 2.0.0:- MAJOR (v2.x.x): Breaking changes (import paths, API changes)
- MINOR (vx.Y.x): New features (backward compatible)
- PATCH (vx.x.Z): Bug fixes (backward compatible)
Support Policy
| Version | Status | Support Until | Security Fixes |
|---|---|---|---|
| v2.8.x | Current | Active | ✅ Yes |
| v2.7.x | Maintenance | 2026-04-22 | ✅ Yes |
| v2.6.x | Maintenance | 2026-01-17 | ✅ Yes |
| v2.5.x | End of Life | 2025-10-20 | ❌ No |
| v2.4.x | End of Life | 2025-10-14 | ❌ No |
| v2.3.x | End of Life | 2025-04-13 | ❌ No |
| v2.2.x | End of Life | 2025-04-13 | ❌ No |
| v2.1.x | End of Life | 2025-04-12 | ❌ No |
| v2.0.x | End of Life | 2025-02-11 | ❌ No |
| v1.x | End of Life | 2025-01-10 | ❌ No |