# 3.0.1

**Release Date:** December 17, 2025

---

## 📚 Documentation

### Updated Documentation

- 📝 [Forge v2 to v3 Migration Guide](../guides/migration/forge-v2-to-v3.md) - Comprehensive updates with agent-assisted workflow recommendations
  - Added detailed prerequisites for dotnet-outdated tool installation and usage
  - Expanded package update verification section with concrete examples using `dotnet package search`
  - Clarified Aspire 13 breaking changes (AddNpmApp → AddJavaScriptApp)
  - Added comprehensive Terraform variable casing documentation with PowerShell find-and-replace commands
  - Included task management section for creating trackable migration tasks
  - Enhanced instructions for infrastructure restructuring (infra/app → infra/api)

- 📝 [Database Oracle Guide](../guides/development/data/database-oracle.md) - Updated file path references to match Forge 3.0 structure

- 📝 [Settings and Secrets Guide](../guides/development/settings-and-secrets.md) - Corrected settings.yml file paths for API configuration (infra/api/settings.yml)

---

## 🔧 Enhancements

### NuGet Packages

- ✅ **SAIF.Platform.Aspire.Hosting** - Simplified AddApi method implementation for better maintainability

- ✅ **SAIF.DevTools.CLI** - Improved configuration loading to resolve paths relative to CLI executable directory, enhancing reliability across different execution contexts

### Project Templates

- ✅ **Multiple Templates** - Replaced `Path.Combine` with `Path.Join` for file path operations across all template resource builders, improving cross-platform compatibility

---

## 🐛 Bug Fixes

### NuGet Packages

- 🐛 **SAIF.Platform.Aspire.Hosting.Keycloak** - Corrected business roles file path to match Forge 3.0 folder structure (`infra/auth/ext/user/`)

---

## 🔄 Breaking Changes

**None in this release** ✅

---

## 📋 Additional Notes

- Total commits: 13
- Files changed: 31
- Insertions: 482
- Deletions: 217
- Contributors: 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)

---