2.1.17¶

Release Date: October 17, 2025

✨ New Features¶

GitHub Copilot & Development Automation¶

Automated Release Management Workflow 🚀¶

Component: Development Tools & Documentation

Introduced a comprehensive automated release creation system that streamlines the entire release process for the Forge platform.

Key Features:

✅ Automated Version Management - Automatic parsing and validation of semantic versioning
✅ Release Branch Creation - Automated branch creation and checkout workflow
✅ Intelligent Release Notes Generation - Analyzes commit history and generates structured release notes
✅ Pull Request Automation - Creates Azure DevOps PRs with detailed descriptions
✅ Conventional Commits Analysis - Categorizes changes by type (feat, fix, refactor, etc.)

Benefits:

🚀 Reduces release preparation time from hours to minutes
🔄 Ensures consistency in release documentation
🎯 Automates tedious manual tasks
✅ Standardizes release workflow across the team

Documentation:

Create Release Prompt (.github/prompts/create-release.prompt.md)

Azure DevOps Pull Request Automation 🔄¶

Component: Development Tools & CI/CD

Added intelligent PR creation automation with GitHub Copilot integration for standardized pull request workflows.

Key Features:

✅ Automatic Commit Analysis - Parses conventional commits and categorizes changes
✅ Template-Based PR Descriptions - Generates comprehensive PR descriptions
✅ Progress Tracking - Real-time todo list management during PR creation
✅ Azure DevOps MCP Integration - Direct API integration for PR creation

Benefits:

🚀 Automated PR description generation
🔄 Consistent PR documentation format
🎯 Reduced manual effort in code review preparation
✅ Improved team collaboration

Documentation:

Create PR Prompt (.github/prompts/create-pr.prompt.md)

Standardized Commit Message Generation 📝¶

Component: Development Tools & VS Code

Implemented GitHub Copilot-powered commit message generation using conventional commits specification.

Key Features:

✅ Conventional Commits Format - Standardized commit message structure
✅ Scope-Based Organization - Comprehensive scope definitions for all components
✅ VS Code Integration - Seamless integration with Copilot
✅ Team Standards Enforcement - Ensures consistent commit history

Benefits:

🚀 Faster commit message creation
🔄 Consistent commit history
🎯 Better change tracking and analysis
✅ Improved code review efficiency

Documentation:

Copilot Commit Message Template (.github/copilot-commit-message.md)

Visual Design¶

Updated Forge Icon Color Scheme 🎨¶

Component: Documentation & Branding

Refreshed the Forge icon colors for better visual consistency and brand alignment across all sizes.

Changes:

🔥 Flame Color: Changed from #e24329 to #ff6b35 for improved vibrancy
🔨 Anvil Color: Changed from #4b5f64 to #434343 for better contrast

Affected Icons:

forge-64x64.svg
forge-128x128.svg
forge-256x256.svg (including PNG variant)
forge-512x512.svg

Benefits:

✅ Improved visual consistency across different sizes
✅ Better contrast and readability
✅ Enhanced brand identity

🔧 Enhancements¶

Documentation¶

✅ Release Notes Organization - Restructured release notes to use version-specific folders (e.g., docs/release-notes/2.1.16/README.md) for better organization and maintainability

Project Templates¶

✅ TypeSpec Template Configuration - Updated autoUsings setting in ClassName1 test runner (test-host.ts) to improve test configuration management

Development Tools¶

✅ Azure DevOps Repository Information - Refactored repository information retrieval method in PR automation for improved reliability
✅ Prettier Configuration - Added .prettierignore to exclude prompt files and other documentation from automatic formatting
✅ VS Code Settings - Enhanced Copilot integration settings for better developer experience

🔄 Breaking Changes¶

Terraform Modules¶

Okta Business Roles Module - is_production Variable¶

Change Description:

The is_production variable in the okta-business-roles/entra_id module no longer has a default value. This change enforces explicit configuration of production environments.

Impact:

Users must now explicitly set the is_production variable when using the okta-business-roles module.

Migration Guide:

Before (implicit default):

module "okta_business_roles" {
  source = "./okta-business-roles"
  # is_production was implicitly set to default value
}

After (explicit configuration required):

module "okta_business_roles" {
  source        = "./okta-business-roles"
  is_production = true  # Must be explicitly set
}

Benefits:

✅ Prevents accidental production deployments
✅ Requires explicit environment awareness
✅ Improves deployment safety

🐛 Bug Fixes¶

No bug fixes in this release.

📚 Documentation¶

New Documentation¶

📖 Automated Release Creation Guide (.github/prompts/create-release.prompt.md) - Comprehensive guide for automated release workflow
📖 Automated PR Creation Guide (.github/prompts/create-pr.prompt.md) - Instructions for automated pull request creation
📖 Commit Message Standards (.github/copilot-commit-message.md) - Conventional commits specification and guidelines

Updated Documentation¶

📝 Release Notes Structure - Migrated to version-specific folder structure

🔧 Dependencies¶

NPM Packages¶

⬆️ @types/node - Bumped from 24.7.2 to 24.8.1 in /src/typescript

📋 Additional Notes¶

Total Commits: 12
Files Changed: 17
Contributors:
Emmitt Johnson (emmjoh@saif.com)
Platform Build Service (SAIFCorporation)

Commit Statistics by Type¶

Features: 3
Refactoring: 4
Chores: 2
Documentation: 1
Breaking Changes: 1
Dependencies: 1

Changed Components¶

GitHub/VS Code Configuration: 5 files
Documentation: 4 files
Visual Assets: 5 icon files
Terraform Modules: 2 files
TypeScript/Templates: 3 files

🚀 Upgrade Notes¶

Review Breaking Changes: If using the okta-business-roles Terraform module, ensure the is_production variable is explicitly set
Adopt New Workflows: Consider using the new automated PR and release workflows for improved efficiency
Update VS Code Settings: Review the updated .vscode/settings.json for Copilot integration improvements

For questions or support, please contact the Platform team.