FOCUS 1.3 and 1.4 support across the toolkit

[flanakin]

Summary

Add FOCUS 1.3 (ratified December 2025) and FOCUS 1.4 (working draft, targeting June 2026) support across the FinOps toolkit. Implementation follows the hub schema versioning procedure, which couples each new FOCUS minor version to a new hub schema version (v1_3, v1_4).

Child issue #2104 captured the original 1.3 request and remains the source of context for the Contract Commitment dataset and ContractApplied column. This issue extends that to also cover 1.4 and tracks the full delivery plan.

Plugin updates are tracked separately in #2119.

Out of scope: regenerating the FOCUS conformance reports, updating Cost Management export schemas, and updating FocusCost_*.json open-data metadata. Those activities run only against official Microsoft Cost Management FOCUS releases, not as part of adding hub support.

Branch strategy

• Umbrella branch: flanakin/focus14 (off origin/dev).
• Each phase below lands as a feature branch off flanakin/focus14, reviewed via PR back into flanakin/focus14. Final merge of flanakin/focus14 into dev.

Scope summary

FOCUS 1.2 → 1.3 (compatible)

• 8 new Cost and Usage columns: AllocatedMethodId, AllocatedMethodDetails, AllocatedResourceId, AllocatedResourceName, AllocatedTags, ContractApplied, ServiceProviderName, HostProviderName
• New Contract Commitment dataset (14 mandatory columns)
• Deprecates ProviderName and PublisherName (still present in 1.3)

FOCUS 1.3 → 1.4 (incompatible — working draft)

• Removes deprecated ProviderName and PublisherName
• Expands Contract Commitment dataset by 14 columns (lifecycle, payment terms, applicability, etc.)
• New Invoice dataset (deferred until spec stabilizes)

Plan / checklist

Scoping (complete)

• Step 1 — Inventory all FOCUS references in the toolkit
• Step 2 — Classify Cost Management vs FinOps hubs ownership
• Step 3 — Identify FOCUS metadata gaps in hubs vs Cost Management
• Step 4 — Confirm the existing "add a new FOCUS version" procedure
• Step 5 — Extract 1.2 → 1.3 → 1.4 spec deltas

Implementation phases

• Phase 0 — Refresh hub upgrade-procedure docs and data-model.md preview convention. (FOCUS 1.4 phase 0: refresh hub upgrade procedure docs #2121, PR Refresh FinOps hub upgrade procedure for multi-version FOCUS adoption #2123)
• Phase 1 — IngestionSetup_v1_3.kql + Costs_raw extension for FOCUS 1.3 columns. (FOCUS 1.4 phase 1: add FOCUS 1.3 ingestion (IngestionSetup_v1_3.kql) #2124, PR Add FOCUS 1.3 ingestion (IngestionSetup_v1_3.kql) #2126)
• Phase 2 — HubSetup_v1_3.kql and Latest aliases retargeted to v1_3. (FOCUS 1.4 phase 2: add FOCUS 1.3 hub functions (HubSetup_v1_3.kql) #2127, PR Add FOCUS 1.3 hub functions (HubSetup_v1_3.kql) #2128)
• Phase 3 — ContractCommitment dataset end-to-end (raw, transform, final, hub function, Latest alias). (FOCUS 1.4 phase 3: add ContractCommitment dataset #2129, PR Add ContractCommitment dataset #2130)
• Phase 4 — IngestionSetup_v1_4.kql (preview): drops ProviderName/PublisherName from Costs, expands ContractCommitment by 14 columns. (FOCUS 1.4 phase 4: add FOCUS 1.4-preview ingestion #2131, PR Add FOCUS 1.4-preview ingestion (IngestionSetup_v1_4.kql) #2132)
• Phase 5 — HubSetup_v1_4.kql (preview); Latest aliases stay pinned to v1_3 GA. (FOCUS 1.4 phase 5: add FOCUS 1.4-preview hub functions #2133, PR Add FOCUS 1.4-preview hub functions (HubSetup_v1_4.kql) #2134)
• Phase 6 — Plugin updates for FOCUS 1.3 / 1.4 (tracked separately in Update Claude Code plugin skill files for FOCUS 1.3 / 1.4 #2119).
• Phase 7 — Pester tests for new versioned functions; update changelog.

Removed from scope

• Phase 1 (originally): multi-version conformance tooling — closed as FOCUS 1.4 phase 1: extend Build-FocusConformance for multi-version + hubs report #2122. Conformance reports are generated only against official Microsoft Cost Management FOCUS releases.
• Cost Management export schema updates — same reason.
• Open-data FocusCost_*.json metadata — these files describe Cost Management exports (DataGenerator: Microsoft) and are therefore out of scope.

References

• FOCUS 1.3 announcement
• FOCUS specification
• Hub developer docs — adding a FOCUS version
• Original FOCUS 1.3 request: Feature: FOCUS 1.3 Ingestion and Hub Support (ContractCommitment + ContractApplied) #2104
• Plugin updates: Update Claude Code plugin skill files for FOCUS 1.3 / 1.4 #2119