# 3.0.3

**Release Date:** December 18, 2025

---

## ✨ New Features

### Foundry Applications

#### Modernized Foundry Applications with Aspire 13.1.0

**Components:** aspire-playwright, aspire-wiremockcli, devtunnels-simple-webhook, event-orchestration, events-with-cosmos

The foundry applications have been modernized with centralized package management and upgraded to Aspire 13.1.0 (stable release).

**Key Improvements:**

- ✅ **Centralized Package Management** - Migrate to Directory.Build.props and Directory.Packages.props for consistent dependency versioning
- ✅ **Aspire 13.1.0 Upgrade** - Stable version with performance improvements and new features
- ✅ **Modern Solution Format** - All solution files migrated from .sln to .slnx format
- ✅ **Latest Dependencies** - Updated SAIF Platform packages (3.0.2), Azure packages, and Entity Framework Core 10.0.1

**Benefits:**

- 🚀 Reduced build complexity and maintenance burden
- 🔄 Standardized dependency management across all applications
- ✨ Access to latest Aspire features and improvements
- 📦 Centralized versioning prevents dependency mismatches

**Example:**

```xml
<!-- Directory.Packages.props -->
<ItemGroup>
  <PackageVersion Include="Microsoft.AspNetCore.Components" Version="10.0.0" />
  <PackageVersion Include="Aspire.Hosting" Version="13.1.0" />
</ItemGroup>
```

**Documentation:**

- [Foundry Applications Guide](../foundry/index.md)

---

## 🔧 Enhancements

### CLI Tools

- ✅ **Forge Workflow Prompts** - Enhanced CLI workflow prompts for improved clarity and conciseness
- ✅ **DevOps Engineer Agent Configuration** - Updated agent model for better consistency and prompt handling
- ✅ **Migration Guidance** - Enhanced migration guidance for Forge v2 to v3 with improved clarity and completeness

### Templates & Configuration

- ✅ **Template Naming Conventions** - Standardized naming conventions in configuration files (appRoles → app_roles, projectId → project_id)
- ✅ **Terraform Configuration Updates** - Updated generated Terraform files to reflect naming convention changes
- ✅ **Migration Documentation** - Updated npm package update instructions and frontend package migration guidance

### Dependencies

- ✅ **System.IdentityModel.Tokens.Jwt 8.15.0** - Enhanced ECDSA support and improved log sanitization for security
- ✅ **Microsoft.VisualStudio.Services.InteractiveClient 19.225.1** - Updated Azure DevOps interactive client

---

## 🐛 Bug Fixes

- 🐛 **Documentation** - Fixed broken emojis in security documentation headers
- 🐛 **Snapshot Updates** - Updated test snapshots to reflect current output
- 🐛 **Duende.IdentityModel** - Downgraded to version 7.1.0 for compatibility

---

## 📚 Documentation

### New Documentation

- 📖 [Template Cross-Referencing Guidelines](../about/contributing/design-system.md) - Guidelines for maintaining consistency across documentation with template references
- 📖 [Entra ID Migration Instructions](../guides/migration/forge-v2-to-v3.md) - Comprehensive migration guide for Entra ID configuration in Forge v3

### Updated Documentation

- 📝 [npm Package Update Instructions](../guides/migration/forge-v2-to-v3.md) - Clarified npm package upgrade process for platform migration
- 📝 [Frontend Package Migration Guide](../guides/migration/forge-v2-to-v3.md) - Added comprehensive guidance for frontend package migration in Forge v3
- 📝 [Forge v2 to v3 Migration Guide](../guides/migration/forge-v2-to-v3.md) - Enhanced clarity and completeness of migration instructions
- 📝 [Migration Guidance](../guides/migration/forge-v2-to-v3.md) - Updated to allow for patch releases (3.0.0+) instead of exact versions for improved flexibility

---

## 🔄 Breaking Changes

**None in this release** ✅

All changes maintain backward compatibility with existing Forge 3.0 deployments.

---

## 📋 Additional Notes

- **Total commits:** 17
- **Files changed:** 28
- **Contributors:** Emmitt Johnson, Brian Sheridan, Platform Build Service

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

---