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

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

**After (explicit configuration required):**

```hcl
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

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

---

**For questions or support, please contact the Platform team.**