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:

<!-- 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

🔧 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 - Guidelines for maintaining consistency across documentation with template references
📖 Entra ID Migration Instructions - Comprehensive migration guide for Entra ID configuration in Forge v3

Updated Documentation¶

📝 npm Package Update Instructions - Clarified npm package upgrade process for platform migration
📝 Frontend Package Migration Guide - Added comprehensive guidance for frontend package migration in Forge v3
📝 Forge v2 to v3 Migration Guide - Enhanced clarity and completeness of migration instructions
📝 Migration Guidance - 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