Add x_RecommendationCategory and x_RecommendationSubcategory enrichments to v1_4 Recommendations

docs-mslearn/toolkit/changelog.md

@@ -3,7 +3,7 @@ title: FinOps toolkit changelog
 description: Review the latest features and enhancements in the FinOps toolkit, including updates to FinOps hubs, Power BI reports, and more.
 author: MSBrett
 ms.author: brettwil
-ms.date: 04/29/2026
+ms.date: 06/24/2026
 ms.topic: reference
 ms.service: finops
 ms.subservice: finops-toolkit
@@ -31,6 +31,18 @@ The following section lists features and enhancements that are currently in deve
   - Added Claude Code plugin with skills for FinOps hubs and Azure Cost Management ([#2043](https://github.com/microsoft/finops-toolkit/pull/2043)).
   - Added 4 agents (CFO, FinOps practitioner, database query, hubs agent), 5 commands (`/ftk-hubs-connect`, `/ftk-hubs-healthCheck`, `/ftk-mom-report`, `/ftk-ytd-report`, `/ftk-cost-optimization`), and an output style.
   - Linked to the existing KQL query catalog in `src/queries/` from the plugin.
+- **Changed**
+  - Updated plugin skill files to reflect FOCUS 1.4 hub schema, the new `ContractCommitments()`, `BillingPeriods()`, and `InvoiceDetails()` functions, and the removal of `ProviderName` / `PublisherName` ([#2120](https://github.com/microsoft/finops-toolkit/issues/2120)).
+
+### FinOps hubs v15.0.0
+
+- **Added**
+  - Added FOCUS 1.4 hub schema (`v1_4`). New cost and usage columns: `AllocatedMethodId`, `AllocatedMethodDetails`, `AllocatedResourceId`, `AllocatedResourceName`, `AllocatedTags`, `ContractApplied`, `ServiceProviderName`, `HostProviderName`, `CommitmentProgramEligibilityDetails`, `InvoiceDetailId`, and 12 `ContractCommitment*` per-row columns (`ContractCommitmentBenefitCategory`, `ContractCommitmentCreated`, `ContractCommitmentDiscountPercentage`, `ContractCommitmentDurationType`, `ContractCommitmentFulfillmentInterval`, `ContractCommitmentLastUpdated`, `ContractCommitmentLifecycleStatus`, `ContractCommitmentModel`, `ContractCommitmentOfferCategory`, `ContractCommitmentPaymentInterval`, `ContractCommitmentPaymentModel`, `ContractCommitmentPaymentUpfrontPercentage`). Removes deprecated `ProviderName` and `PublisherName` from the schema (raw tables keep them for back compat). Three new supplemental datasets: `ContractCommitments` (28 columns), `BillingPeriods` (6 columns), and `InvoiceDetails` (22 columns) ([#2120](https://github.com/microsoft/finops-toolkit/issues/2120)).
+  - Added unversioned `ContractCommitments()`, `BillingPeriods()`, and `InvoiceDetails()` functions aliasing to their `_v1_4` counterparts.
+  - Added `x_RecommendationCategory` and `x_RecommendationSubcategory` enrichment columns to the `Recommendations` dataset, normalized to a fixed hub taxonomy (Cost, Operational Excellence, Performance, Reliability, Security). See [data model](hubs/data-model.md#recommendations-managed-dataset) for the allowed values.
+- **Changed**
+  - Retargeted unversioned `Costs()`, `Prices()`, `CommitmentDiscountUsage()`, `Recommendations()`, and `Transactions()` aliases to their `_v1_4` counterparts.
+  - Refreshed the canonical "add a new FOCUS version" procedure in [src/templates/finops-hub/docs/README.md](https://github.com/microsoft/finops-toolkit/tree/dev/src/templates/finops-hub/docs/README.md) with multi-version-cycle, plugin, and changelog steps.
 
 ### Bicep Registry module pending updates
 

docs-mslearn/toolkit/hubs/data-model.md

@@ -3,7 +3,7 @@ title: FinOps hubs data model
 description: Learn about the tables and functions available in FinOps hubs to build your own queries, reports, and dashboards.
 author: flanakin
 ms.author: micflan
-ms.date: 04/01/2026
+ms.date: 06/24/2026
 ms.topic: reference
 ms.service: finops
 ms.subservice: finops-toolkit
@@ -736,7 +736,8 @@ Columns in the **Recommendations** managed dataset include:
 | x_EffectiveCostBefore       | Real     | Source: Microsoft EA+MCA 2023-05-01.                          |
 | x_EffectiveCostSavings      | Real     | Source: Microsoft EA+MCA 2023-05-01.                          |
 | x_IngestionTime             | Datetime | Source: Hubs add-on.                                          |
-| x_RecommendationCategory    | String   | Source: Hubs recommendations.                                 |
+| x_RecommendationCategory    | String   | Source: Hubs recommendations. Normalized to the hub taxonomy. |
+| x_RecommendationSubcategory | String   | Source: Hubs add-on. Normalized to the hub taxonomy.          |
 | x_RecommendationDate        | Datetime | Source: Microsoft EA+MCA 2023-05-01.                          |
 | x_RecommendationDescription | String   | Source: Hubs add-on.                                          |
 | x_RecommendationDetails     | Dynamic  | Contains source-specific metadata. See notes below the table. |
@@ -749,6 +750,56 @@ Columns in the **Recommendations** managed dataset include:
 
 The **x_RecommendationDetails** column is a dynamic object that contains source-specific metadata. For Cost Management reservation recommendations, it includes commitment discount details like scope, term, SKU, and region. For hubs recommendations, it includes the recommendation provider, solution, type ID, resource type, and any additional properties from the query.
 
+The **x_RecommendationCategory** and **x_RecommendationSubcategory** columns classify each recommendation against a fixed hub taxonomy so reports can group across providers consistently. Source data is normalized on ingestion: source category values (for example, Azure Advisor's `HighAvailability` → `Reliability`) are mapped to the allowed values below. Unmapped category values become an empty string and unmapped subcategory values become `Other`.
+
+Allowed **x_RecommendationCategory** values: `Cost`, `Operational Excellence`, `Performance`, `Reliability`, `Security`.
+
+Allowed **x_RecommendationSubcategory** values, grouped by parent category:
+
+- Cost
+  - Autoscaling
+  - Commitment Discount Coverage
+  - Commitment Discount Utilization
+  - Idle Resources (includes unused capacity and orphaned resources)
+  - Low Utilization
+  - Negotiated Discount Enablement
+  - Region Placement
+  - Right-Sizing
+  - Scheduling
+  - Service Selection and Architecture
+  - SKU Modernization
+  - Spot Eligibility
+- Operational Excellence
+  - Automation and Process
+  - Best Practices
+  - Governance and Policy
+  - Observability
+  - Operational Hygiene
+  - Quotas and Limits
+  - Resource Consistency
+- Performance
+  - Performance Tuning
+  - Resource Configuration
+  - Resource Sizing
+  - Scaling and Capacity
+  - Throughput and Latency
+  - Workload Placement
+- Reliability
+  - Backup Configuration
+  - Capacity
+  - Disaster Recovery
+  - High Availability
+  - Service Retirement
+  - Zone Resiliency
+- Security
+  - Compliance Alignment
+  - Data Protection
+  - Identity & Access
+  - Network Security
+  - Threat Detection
+  - Vulnerability Exposure
+- Other (fallback when no specific subcategory applies)
+
 <br>
 
 ## Regions table