Skip to main content

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 cases

Version Comparison Matrix

Featurev2.8v2.7v2.6v2.5v2.4v2.3v2.2v2.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 Coverage85%+~75%~75%~75%~75%~75%~75%~75%
Documentation
Mintlify Docs
Architecture Decision Records30 ADRs30 ADRs26 ADRs21 ADRs21 ADRs21 ADRs5 ADRs5 ADRs
Core Features
LangGraph Version0.6.100.6.100.6.100.6.100.6.100.2.280.2.280.2.28
Multi-LLM Support (LiteLLM)
OpenFGA Authorization
Pydantic VersionV2V2V2V2V2V2V1V1
Type Safety Coverage64%64%64%64%64%64%27%27%
Agentic Loop (GAVR)
Anthropic Best Practices9.8/109.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 Dashboards99999997
Prometheus Alerts20+ SLA20+ SLA20+ SLA20+ SLA20+ SLA20+ SLA20+ SLABasic

Release Highlights

Version Timeline

Migration Guides

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
Recommended Actions:
  1. Update dependencies: uv sync
  2. Run tests with new Docker infrastructure: make test-integration
  3. Review new test coverage reports
  4. Update CI/CD to use Docker Compose test environment
Breaking Changes: NoneNew Features:
  • LangGraph 0.6.10 (API compatible)
  • 100% test pass rate (437/437)
  • 21 comprehensive ADRs
Recommended Actions:
  1. Update dependencies: uv sync
  2. Run tests: make test
  3. Review new ADRs for architectural guidance
Breaking Changes: None (Pydantic V2 backward compatible)New Features:
  • Compliance storage backend (5 interfaces)
  • Pydantic V2 migration
  • Type safety enhanced (27% → 64%)
Recommended Actions:
  1. Review Pydantic V2 changes if extending models
  2. Run type checks: mypy src/
  3. Test compliance storage integration
Breaking Changes: NoneNew Features:
  • GDPR/SOC2/HIPAA compliance automation
  • SLA monitoring with 20+ Prometheus alerts
  • 2 new Grafana dashboards
Recommended Actions:
  1. Configure compliance settings in .env
  2. Import new Grafana dashboards
  3. Review Prometheus alert rules
  4. Set up data retention policies
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
Recommended Actions:
  1. Set up Keycloak if using SSO: make setup-keycloak
  2. Configure Redis for sessions
  3. Review Kubernetes deployment guides
Breaking Changes: ⚠️ Major package reorganizationImport Path Changes:
# Before (v1.x)
from config import settings
from auth import AuthMiddleware

# After (v2.x)
from mcp_server_langgraph.core.config import settings
from mcp_server_langgraph.auth.middleware import AuthMiddleware
Recommended Actions:
  1. Update all imports to new structure
  2. Review migration guide in CHANGELOG
  3. Update CI/CD pipelines
  4. Test thoroughly before deploying

Deprecation Schedule

FeatureDeprecated InRemoved InAlternative
HTTP/SSE Transportv2.0.0v2.0.0StreamableHTTP transport
Pydantic V1v2.3.0v3.0.0Pydantic 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

VersionStatusSupport UntilSecurity Fixes
v2.8.xCurrentActive✅ Yes
v2.7.xMaintenance2026-04-22✅ Yes
v2.6.xMaintenance2026-01-17✅ Yes
v2.5.xEnd of Life2025-10-20❌ No
v2.4.xEnd of Life2025-10-14❌ No
v2.3.xEnd of Life2025-04-13❌ No
v2.2.xEnd of Life2025-04-13❌ No
v2.1.xEnd of Life2025-04-12❌ No
v2.0.xEnd of Life2025-02-11❌ No
v1.xEnd of Life2025-01-10❌ No

Getting Help