# 2.1.20

**Release Date:** October 24, 2025

---

## ✨ New Features

### NuGet Packages

#### Retry Policy for Oracle DB Connections 🔄

**Package:** `SAIF.Platform.EntityFramework`

Added comprehensive retry policy for Oracle Database connections, enabling applications to handle transient connection failures gracefully.

**Key Features:**

- ✅ **Default Error Handling** - Retries on error 12570 (cannot open database connection) by default
- ✅ **Extensible Configuration** - Allows applications to add custom error codes for retry handling
- ✅ **Easy Integration** - Simple extension method for adding Oracle context with custom execution strategy

**Benefits:**

- 🚀 Improved reliability for applications connecting to Oracle databases
- 🔄 Reduced application failures from transient network issues
- 🎯 Flexible configuration for application-specific retry requirements

**Example:**

```csharp
// Create a custom execution strategy with additional error codes
public class MyExecutionStrategy : OracleExecutionStrategy
{
    public MyExecutionStrategy(ExecutionStrategyDependencies dependencies)
        : base(dependencies, [12345, 67890])  // Add custom error codes
    {
    }
}

// Use in your builder configuration
builder
    .AddOracleDbContext<PremiumAuditContext, MyExecutionStrategy>();
```

**Documentation:**

- [Entity Framework Documentation](../reference/tools/entity-framework.md)

---

## 🔧 Enhancements

### Documentation

- ✅ **Dependency Updates** - Updated Aspire packages to 9.5.2 with improved reliability and performance
- ✅ **Okta Authentication** - Refined trusted server resource count logic for better scaling
- ✅ **Gitignore** - Added additional patterns for better repository cleanliness

---

## 📚 Documentation

### New Documentation

- 📖 Change Management Presentation - Comprehensive guide on Forge platform adoption with user personas, support requirements, and success metrics

### Updated Documentation

- 📝 Forge Overview Diagram - New visual representation of the Forge platform architecture showing key components and services
- 📝 Forge Services Diagram - Detailed service architecture diagram
- 📝 Presentations - Removed outdated sections and added comprehensive change management guide

---

## 🔄 Breaking Changes

None in this release ✅

---

## 📋 Additional Notes

- **Total commits:** 6 (includes merged PRs and documentation updates)
- **Files changed:** 9
- **Contributors:** Aaron Morgulis, Brian Sheridan, Emmitt Johnson

---

### Support

- 📧 Teams Support Channel: [Support](https://teams.microsoft.com/l/channel/19%3Acb611810fb0b42b080cfff5590bdd51c%40thread.tacv2/Support?groupId=514d2dac-2d62-48ce-bf99-0fa0ce39469c&tenantId=a86cb8ed-369b-4df5-ace5-43811f6e08cf)

---