@spottoai/types-package 1.0.2-dev1138.1 → 1.0.2-dev1138.12

package/dist/esm/azure/financialSavingsSurfaceProjectionValidation.js

@@ -2,7 +2,9 @@ import { sha256Utf8 } from '../common/sha256.js';
 import { canonicalizeFinancialSavingsJsonValue, hasExactFinancialSavingsFields, haveSameFinancialSavingsSet, isFinancialSavingsHash, isFinancialSavingsIdentity, isFinancialSavingsIsoInstant, isFinancialSavingsMinorUnits, isFinancialSavingsRecord, sumFinancialSavingsMinorUnits, } from './financialSavingsAuthorityValidationPrimitives.js';
 import { FINANCIAL_SAVINGS_SURFACE_PROJECTION_CONTRACT_VERSION_V1, FINANCIAL_SAVINGS_SURFACE_PROJECTION_SCHEMA_VERSION_V1, } from './financialSavingsSurfaceProjection.js';
 import { isFinancialBaselinePeriodV2 } from './financialScopeBaselineValidation.js';
+import { isFinancialChargeInclusionPolicyRefV1 } from './financialChargeCompositionValidation.js';
 import { isCanonicalExactMoney } from './financialValidationPrimitives.js';
+import { composeFinancialSavingsAllocationPercentageV1 } from './financialSavingsPercentageKernel.js';
 const COST_BASES = new Set(['billed', 'amortized']);
 const ESTIMATE_LENSES = new Set(['actual-only', 'actual-plus-estimated', 'estimates-only']);
 const UNAVAILABLE_REASONS = new Set([
@@ -18,7 +20,22 @@ const MAX_ALLOCATIONS = 20000;
 export const canonicalizeFinancialSavingsSurfaceProjectionIdentityV1 = (value) => JSON.stringify(canonicalizeFinancialSavingsJsonValue({
     ...value,
     providerAccountRefs: [...value.providerAccountRefs].sort(),
-    scope: value.scope.kind === 'subscription-full' ? value.scope : { ...value.scope, recommendationIds: [...value.scope.recommendationIds].sort() },
+    ...(value.lifecycleBindings === undefined
+        ? {}
+        : {
+            lifecycleBindings: [...value.lifecycleBindings]
+                .sort((left, right) => left.resourceId.localeCompare(right.resourceId) || left.recommendationId.localeCompare(right.recommendationId))
+                .map(binding => ({ ...binding, allocationIds: [...binding.allocationIds].sort() })),
+        }),
+    scope: value.scope.kind === 'subscription-full'
+        ? value.scope
+        : value.scope.kind === 'recommendation-query'
+            ? { ...value.scope, recommendationIds: [...value.scope.recommendationIds].sort() }
+            : {
+                ...value.scope,
+                allocationIds: [...value.scope.allocationIds].sort(),
+                recommendationIds: [...value.scope.recommendationIds].sort(),
+            },
     coordinates: [...value.coordinates]
         .sort((left, right) => left.coordinateId.localeCompare(right.coordinateId))
         .map(coordinate => coordinate.status === 'unavailable'
@@ -27,7 +44,29 @@ export const canonicalizeFinancialSavingsSurfaceProjectionIdentityV1 = (value) =
             ...coordinate,
             recommendationContributions: [...coordinate.recommendationContributions]
                 .sort((left, right) => left.recommendationId.localeCompare(right.recommendationId))
-                .map(contribution => ({ ...contribution, allocationIds: [...contribution.allocationIds].sort() })),
+                .map(contribution => ({
+                ...contribution,
+                allocationIds: [...contribution.allocationIds].sort(),
+                ...(contribution.allocations === undefined
+                    ? {}
+                    : {
+                        allocations: [...contribution.allocations].sort((left, right) => left.allocationId.localeCompare(right.allocationId)),
+                    }),
+            })),
+            ...(coordinate.resourceContributions === undefined
+                ? {}
+                : {
+                    resourceContributions: [...coordinate.resourceContributions]
+                        .sort((left, right) => left.resourceId.localeCompare(right.resourceId))
+                        .map(contribution => ({
+                        ...contribution,
+                        allocationIds: [...contribution.allocationIds].sort(),
+                        denominator: {
+                            ...contribution.denominator,
+                            denominatorIds: [...contribution.denominator.denominatorIds].sort(),
+                        },
+                    })),
+                }),
             aggregate: { ...coordinate.aggregate, allocationIds: [...coordinate.aggregate.allocationIds].sort() },
         }),
 }));
@@ -38,12 +77,24 @@ const isScope = (value) => {
         return false;
     if (value.kind === 'subscription-full')
         return hasExactFinancialSavingsFields(value, ['kind']);
-    return (value.kind === 'recommendation-query' &&
+    if (value.kind === 'recommendation-query' &&
         hasExactFinancialSavingsFields(value, ['kind', 'filterFingerprint', 'recommendationIds']) &&
         isFinancialSavingsHash(value.filterFingerprint) &&
         Array.isArray(value.recommendationIds) &&
         value.recommendationIds.length <= MAX_ALLOCATIONS &&
         value.recommendationIds.every(isFinancialSavingsIdentity) &&
+        new Set(value.recommendationIds).size === value.recommendationIds.length)
+        return true;
+    return (value.kind === 'resource-query' &&
+        hasExactFinancialSavingsFields(value, ['kind', 'filterFingerprint', 'allocationIds', 'recommendationIds']) &&
+        isFinancialSavingsHash(value.filterFingerprint) &&
+        Array.isArray(value.allocationIds) &&
+        value.allocationIds.length <= MAX_ALLOCATIONS &&
+        value.allocationIds.every(isFinancialSavingsHash) &&
+        new Set(value.allocationIds).size === value.allocationIds.length &&
+        Array.isArray(value.recommendationIds) &&
+        value.recommendationIds.length <= MAX_ALLOCATIONS &&
+        value.recommendationIds.every(isFinancialSavingsIdentity) &&
         new Set(value.recommendationIds).size === value.recommendationIds.length);
 };
 const isCoordinateCommon = (value) => isFinancialSavingsHash(value.coordinateId) &&
@@ -53,9 +104,20 @@ const isCoordinateCommon = (value) => isFinancialSavingsHash(value.coordinateId)
     COST_BASES.has(value.costBasis) &&
     typeof value.estimateLens === 'string' &&
     ESTIMATE_LENSES.has(value.estimateLens) &&
+    isFinancialChargeInclusionPolicyRefV1(value.chargeInclusionPolicyRef) &&
     (value.requestedCurrencyCode === undefined || isCurrency(value.requestedCurrencyCode)) &&
     (value.currentAggregateBaselineId === undefined || isFinancialSavingsHash(value.currentAggregateBaselineId));
-const isAvailableCoordinate = (value, queryRecommendationIds) => {
+const isLifecycleBinding = (value) => isFinancialSavingsRecord(value) &&
+    hasExactFinancialSavingsFields(value, ['resourceId', 'recommendationId', 'allocationIds']) &&
+    isFinancialSavingsIdentity(value.resourceId) &&
+    isFinancialSavingsIdentity(value.recommendationId) &&
+    Array.isArray(value.allocationIds) &&
+    value.allocationIds.length > 0 &&
+    value.allocationIds.length <= MAX_ALLOCATIONS &&
+    value.allocationIds.every(isFinancialSavingsHash) &&
+    new Set(value.allocationIds).size === value.allocationIds.length;
+const isComposedCoordinate = (value, queryRecommendationIds, queryAllocationIds) => {
+    const partial = value.status === 'partial';
     if (!hasExactFinancialSavingsFields(value, [
         'status',
         'coordinateId',
@@ -63,6 +125,7 @@ const isAvailableCoordinate = (value, queryRecommendationIds) => {
         'period',
         'costBasis',
         'estimateLens',
+        'chargeInclusionPolicyRef',
         'currentAggregateBaselineId',
         'currentAggregate',
         'accountingCurrencyCode',
@@ -70,7 +133,8 @@ const isAvailableCoordinate = (value, queryRecommendationIds) => {
         'roundingMode',
         'recommendationContributions',
         'aggregate',
-    ], ['requestedCurrencyCode']) ||
+        ...(partial ? ['unavailableRecommendationIds'] : []),
+    ], ['requestedCurrencyCode', 'resourceContributions']) ||
         !isCoordinateCommon(value) ||
         !isFinancialSavingsHash(value.currentAggregateBaselineId) ||
         !isCanonicalExactMoney(value.currentAggregate) ||
@@ -90,12 +154,21 @@ const isAvailableCoordinate = (value, queryRecommendationIds) => {
         new Set(value.aggregate.allocationIds).size !== value.aggregate.allocationIds.length ||
         !isFinancialSavingsMinorUnits(value.aggregate.savingsMinorUnits))
         return false;
+    if (partial &&
+        (!Array.isArray(value.unavailableRecommendationIds) ||
+            value.unavailableRecommendationIds.length === 0 ||
+            value.unavailableRecommendationIds.length > MAX_ALLOCATIONS ||
+            !value.unavailableRecommendationIds.every(isFinancialSavingsIdentity) ||
+            new Set(value.unavailableRecommendationIds).size !== value.unavailableRecommendationIds.length ||
+            (queryRecommendationIds !== undefined && value.unavailableRecommendationIds.some(id => !queryRecommendationIds.has(id)))))
+        return false;
     const recommendationIds = new Set();
     const allocationIds = [];
     const contributionAmounts = [];
+    const allocationById = new Map();
     for (const contribution of value.recommendationContributions) {
         if (!isFinancialSavingsRecord(contribution) ||
-            !hasExactFinancialSavingsFields(contribution, ['recommendationId', 'allocationIds', 'savingsMinorUnits']) ||
+            !hasExactFinancialSavingsFields(contribution, ['recommendationId', 'allocationIds', 'savingsMinorUnits'], ['allocations']) ||
             !isFinancialSavingsIdentity(contribution.recommendationId) ||
             recommendationIds.has(contribution.recommendationId) ||
             (queryRecommendationIds !== undefined && !queryRecommendationIds.has(contribution.recommendationId)) ||
@@ -104,17 +177,99 @@ const isAvailableCoordinate = (value, queryRecommendationIds) => {
             contribution.allocationIds.length > MAX_ALLOCATIONS ||
             !contribution.allocationIds.every(isFinancialSavingsHash) ||
             new Set(contribution.allocationIds).size !== contribution.allocationIds.length ||
-            !isFinancialSavingsMinorUnits(contribution.savingsMinorUnits))
+            !isFinancialSavingsMinorUnits(contribution.savingsMinorUnits) ||
+            (queryAllocationIds !== undefined && !Array.isArray(contribution.allocations)) ||
+            (contribution.allocations !== undefined &&
+                (!Array.isArray(contribution.allocations) || contribution.allocations.length !== contribution.allocationIds.length)))
+            return false;
+        const exactAllocations = contribution.allocations;
+        if (exactAllocations === undefined) {
+            recommendationIds.add(contribution.recommendationId);
+            allocationIds.push(...contribution.allocationIds);
+            contributionAmounts.push(contribution.savingsMinorUnits);
+            continue;
+        }
+        const exactAllocationIds = [];
+        const exactAllocationAmounts = [];
+        for (const allocation of exactAllocations) {
+            if (!isFinancialSavingsRecord(allocation) ||
+                !hasExactFinancialSavingsFields(allocation, ['allocationId', 'savingsMinorUnits'], ['denominator']) ||
+                !isFinancialSavingsHash(allocation.allocationId) ||
+                (queryAllocationIds !== undefined && !queryAllocationIds.has(allocation.allocationId)) ||
+                !isFinancialSavingsMinorUnits(allocation.savingsMinorUnits) ||
+                (allocation.denominator !== undefined &&
+                    (!isFinancialSavingsRecord(allocation.denominator) ||
+                        !hasExactFinancialSavingsFields(allocation.denominator, ['denominatorId', 'amount', 'currencyCode']) ||
+                        !isFinancialSavingsHash(allocation.denominator.denominatorId) ||
+                        !isCanonicalExactMoney({
+                            amount: allocation.denominator.amount,
+                            currencyCode: allocation.denominator.currencyCode,
+                        }))))
+                return false;
+            exactAllocationIds.push(allocation.allocationId);
+            exactAllocationAmounts.push(allocation.savingsMinorUnits);
+            allocationById.set(allocation.allocationId, allocation);
+        }
+        if (new Set(exactAllocationIds).size !== exactAllocationIds.length ||
+            !haveSameFinancialSavingsSet(exactAllocationIds, contribution.allocationIds) ||
+            sumFinancialSavingsMinorUnits(exactAllocationAmounts) !== contribution.savingsMinorUnits)
             return false;
         recommendationIds.add(contribution.recommendationId);
         allocationIds.push(...contribution.allocationIds);
         contributionAmounts.push(contribution.savingsMinorUnits);
     }
+    if (value.resourceContributions !== undefined) {
+        if (!Array.isArray(value.resourceContributions) || value.resourceContributions.length > MAX_ALLOCATIONS)
+            return false;
+        const resourceIds = new Set();
+        const resourceAllocationIds = [];
+        for (const contribution of value.resourceContributions) {
+            if (!isFinancialSavingsRecord(contribution) ||
+                !hasExactFinancialSavingsFields(contribution, ['resourceId', 'allocationIds', 'savingsMinorUnits', 'denominator', 'percentage']) ||
+                !isFinancialSavingsIdentity(contribution.resourceId) ||
+                resourceIds.has(contribution.resourceId) ||
+                !Array.isArray(contribution.allocationIds) ||
+                contribution.allocationIds.length === 0 ||
+                contribution.allocationIds.length > MAX_ALLOCATIONS ||
+                !contribution.allocationIds.every(isFinancialSavingsHash) ||
+                new Set(contribution.allocationIds).size !== contribution.allocationIds.length ||
+                !isFinancialSavingsMinorUnits(contribution.savingsMinorUnits) ||
+                !isFinancialSavingsRecord(contribution.denominator) ||
+                !hasExactFinancialSavingsFields(contribution.denominator, ['denominatorIds', 'amount', 'currencyCode']) ||
+                !Array.isArray(contribution.denominator.denominatorIds) ||
+                contribution.denominator.denominatorIds.length === 0 ||
+                !contribution.denominator.denominatorIds.every(isFinancialSavingsHash) ||
+                new Set(contribution.denominator.denominatorIds).size !== contribution.denominator.denominatorIds.length ||
+                !isCanonicalExactMoney({ amount: contribution.denominator.amount, currencyCode: contribution.denominator.currencyCode }) ||
+                typeof contribution.percentage !== 'number' ||
+                !Number.isFinite(contribution.percentage) ||
+                contribution.percentage < 0)
+                return false;
+            const allocations = contribution.allocationIds.map(allocationId => allocationById.get(allocationId));
+            if (allocations.some(allocation => allocation === undefined))
+                return false;
+            const exactAllocations = allocations;
+            const composed = composeFinancialSavingsAllocationPercentageV1(exactAllocations, Number(value.minorUnitScale));
+            if (!composed ||
+                sumFinancialSavingsMinorUnits(exactAllocations.map(allocation => allocation.savingsMinorUnits)) !==
+                    contribution.savingsMinorUnits ||
+                !haveSameFinancialSavingsSet(composed.denominatorIds, contribution.denominator.denominatorIds) ||
+                composed.denominatorAmount !== contribution.denominator.amount ||
+                composed.denominatorCurrencyCode !== contribution.denominator.currencyCode ||
+                composed.percentage !== contribution.percentage)
+                return false;
+            resourceIds.add(contribution.resourceId);
+            resourceAllocationIds.push(...contribution.allocationIds);
+        }
+        if (new Set(resourceAllocationIds).size !== resourceAllocationIds.length ||
+            !haveSameFinancialSavingsSet(resourceAllocationIds, allocationIds))
+            return false;
+    }
     return (new Set(allocationIds).size === allocationIds.length &&
         haveSameFinancialSavingsSet(allocationIds, value.aggregate.allocationIds) &&
         sumFinancialSavingsMinorUnits(contributionAmounts) === value.aggregate.savingsMinorUnits);
 };
-const isUnavailableCoordinate = (value) => hasExactFinancialSavingsFields(value, ['status', 'coordinateId', 'periodRole', 'period', 'costBasis', 'estimateLens', 'unavailableReason'], ['requestedCurrencyCode', 'currentAggregateBaselineId']) &&
+const isUnavailableCoordinate = (value) => hasExactFinancialSavingsFields(value, ['status', 'coordinateId', 'periodRole', 'period', 'costBasis', 'estimateLens', 'chargeInclusionPolicyRef', 'unavailableReason'], ['requestedCurrencyCode', 'currentAggregateBaselineId']) &&
     isCoordinateCommon(value) &&
     typeof value.unavailableReason === 'string' &&
     UNAVAILABLE_REASONS.has(value.unavailableReason);
@@ -132,13 +287,15 @@ export const isFinancialSavingsSurfaceProjectionV1 = (value) => {
             'financialAuthorityId',
             'savingsAuthorityId',
             'coordinates',
-        ]) ||
+        ], ['lifecycleBindings']) ||
         value.schemaVersion !== FINANCIAL_SAVINGS_SURFACE_PROJECTION_SCHEMA_VERSION_V1 ||
         value.contractVersion !== FINANCIAL_SAVINGS_SURFACE_PROJECTION_CONTRACT_VERSION_V1 ||
         !isFinancialSavingsHash(value.projectionId) ||
-        (value.surface !== 'recommendations' && value.surface !== 'dashboard') ||
+        (value.surface !== 'recommendations' && value.surface !== 'resources' && value.surface !== 'dashboard') ||
         !isScope(value.scope) ||
         (value.surface === 'dashboard' && value.scope.kind !== 'subscription-full') ||
+        (value.surface === 'recommendations' && value.scope.kind === 'resource-query') ||
+        (value.surface === 'resources' && value.scope.kind === 'recommendation-query') ||
         value.provider !== 'azure' ||
         !Array.isArray(value.providerAccountRefs) ||
         value.providerAccountRefs.length === 0 ||
@@ -151,21 +308,50 @@ export const isFinancialSavingsSurfaceProjectionV1 = (value) => {
         !isFinancialSavingsIsoInstant(value.artifactGeneration.generatedAt) ||
         !isFinancialSavingsHash(value.financialAuthorityId) ||
         !isFinancialSavingsHash(value.savingsAuthorityId) ||
+        (value.lifecycleBindings !== undefined &&
+            (!Array.isArray(value.lifecycleBindings) ||
+                value.lifecycleBindings.length === 0 ||
+                value.lifecycleBindings.length > MAX_ALLOCATIONS ||
+                !value.lifecycleBindings.every(isLifecycleBinding))) ||
         !Array.isArray(value.coordinates) ||
         value.coordinates.length === 0 ||
         value.coordinates.length > MAX_COORDINATES)
         return false;
     const projection = value;
-    const queryRecommendationIds = projection.scope.kind === 'recommendation-query' ? new Set(projection.scope.recommendationIds) : undefined;
+    const queryRecommendationIds = projection.scope.kind === 'recommendation-query' || projection.scope.kind === 'resource-query'
+        ? new Set(projection.scope.recommendationIds)
+        : undefined;
+    const queryAllocationIds = projection.scope.kind === 'resource-query' ? new Set(projection.scope.allocationIds) : undefined;
     if (!projection.coordinates.every(coordinate => {
         if (!isFinancialSavingsRecord(coordinate))
             return false;
-        return coordinate.status === 'available'
-            ? isAvailableCoordinate(coordinate, queryRecommendationIds)
+        return coordinate.status === 'available' || coordinate.status === 'partial'
+            ? isComposedCoordinate(coordinate, queryRecommendationIds, queryAllocationIds)
             : coordinate.status === 'unavailable' && isUnavailableCoordinate(coordinate);
     }) ||
         new Set(projection.coordinates.map(coordinate => coordinate.coordinateId)).size !== projection.coordinates.length)
         return false;
+    if (projection.lifecycleBindings !== undefined) {
+        const lifecycleKeys = projection.lifecycleBindings.map(binding => `${binding.resourceId}\u0000${binding.recommendationId}`);
+        const boundAllocationIds = projection.lifecycleBindings.flatMap(binding => binding.allocationIds);
+        const projectedAllocationOwners = new Map();
+        for (const coordinate of projection.coordinates) {
+            if (coordinate.status === 'unavailable')
+                continue;
+            for (const contribution of coordinate.recommendationContributions) {
+                for (const allocationId of contribution.allocationIds) {
+                    if (projectedAllocationOwners.has(allocationId))
+                        return false;
+                    projectedAllocationOwners.set(allocationId, contribution.recommendationId);
+                }
+            }
+        }
+        if (new Set(lifecycleKeys).size !== lifecycleKeys.length ||
+            new Set(boundAllocationIds).size !== boundAllocationIds.length ||
+            boundAllocationIds.length !== projectedAllocationOwners.size ||
+            projection.lifecycleBindings.some(binding => binding.allocationIds.some(allocationId => projectedAllocationOwners.get(allocationId) !== binding.recommendationId)))
+            return false;
+    }
     const { projectionId: _projectionId, ...identity } = projection;
     return projection.projectionId === createFinancialSavingsSurfaceProjectionIdV1(identity);
 };

package/dist/esm/azure/financialScope.js

@@ -1,7 +1,11 @@
 export * from './financialScopeEvidence.js';
+export * from './financialEvidenceCoverage.js';
 export * from './financialScopeBaseline.js';
 export * from './financialScopeBaselineIdentity.js';
 export * from './financialScopeBaselineValidation.js';
+export * from './financialChargeComposition.js';
+export * from './financialChargeCompositionValidation.js';
+export * from './financialChargeCompositionKernel.js';
 export * from './financialEvidenceAssessmentValidation.js';
 export * from './financialProjection.js';
 export * from './financialProjectionValidation.js';
@@ -9,17 +13,27 @@ export * from './financialDisplayRollup.js';
 export * from './financialDisplayRollupValidation.js';
 export * from './financialAuthorityView.js';
 export * from './financialAuthorityViewValidation.js';
+export * from './financialAuthorityProjectionKernel.js';
 export * from './financialSavingsAuthority.js';
 export * from './financialSavingsAuthorityValidation.js';
 export * from './financialSavingsSurfaceProjection.js';
 export * from './financialSavingsSurfaceProjectionValidation.js';
+export * from './financialSavingsSurfaceProjectionKernel.js';
+export * from './financialSavingsPercentageKernel.js';
+export * from './financialCurrentSpendSurfaceProjection.js';
+export * from './financialCurrentSpendSurfaceProjectionValidation.js';
+export * from './financialResourceSurfaceProjection.js';
+export * from './financialResourceSurfaceProjectionValidation.js';
 export * from './financialDataflow.js';
 export * from './financialDataflowValidation.js';
+export * from './financialDataflowKernel.js';
 export * from './financialAnalytics.js';
 export * from './financialAnalyticsValidation.js';
+export * from './financialAnalyticsDisplayKernel.js';
 export * from './financialAnalyticsDelivery.js';
 export * from './financialAnalyticsDeliveryValidation.js';
 export * from './financialPolicy.js';
 export * from './financialPolicyValidation.js';
+export * from './financialPolicyKernel.js';
 export * from './financialPolicyDelivery.js';
 export * from './financialPolicyDeliveryValidation.js';

package/dist/esm/azure/financialScopeBaseline.js

@@ -1,5 +1,16 @@
 export const FINANCIAL_SCOPE_BASELINE_SCHEMA_VERSION_V2 = 2;
 export const FINANCIAL_SCOPE_BASELINE_CONTRACT_VERSION_V2 = 'financial-scope-baseline/v2';
+/**
+ * True only when the produced evidence covers the entire requested interval.
+ * Partial periods remain valid monetary evidence for display and forecasting,
+ * but must not be used as the current side of an optimization projection.
+ */
+export const isCompleteFinancialBaselinePeriodV2 = (period) => period.observed !== undefined &&
+    period.observed.startDate === period.requested.startDate &&
+    period.observed.endDateExclusive === period.requested.endDateExclusive &&
+    period.observed.dateBasis === period.requested.dateBasis &&
+    period.observed.timeZone === period.requested.timeZone &&
+    period.gaps.length === 0;
 export const FINANCIAL_SCOPE_BASELINE_UNAVAILABLE_REASONS_V2 = [
     'evidence-not-produced',
     'evidence-not-matched',
@@ -15,5 +26,6 @@ export const FINANCIAL_SCOPE_BASELINE_UNAVAILABLE_REASONS_V2 = [
     'mixed-generation',
     'member-incompatible',
     'reconciliation-failure',
+    'scope-membership-empty',
     'unsupported-scope',
 ];

package/dist/esm/azure/financialScopeBaselineIdentity.js

@@ -85,10 +85,21 @@ const canonicalComponent = (component) => ({
     ownerScopeId: component.ownerScopeId,
     chargeClassification: component.chargeClassification,
     amount: component.amount,
+    ...(component.estimateReason === undefined ? {} : { estimateReason: component.estimateReason }),
     evidenceRefIds: [...component.evidenceRefIds].sort(compareCodePoints),
     coverageIds: [...component.coverageIds].sort(compareCodePoints),
-    ...(component.quantity === undefined ? {} : { quantity: component.quantity }),
-    ...(component.effectiveRate === undefined ? {} : { effectiveRate: component.effectiveRate }),
+    ...(component.quantity === undefined
+        ? {}
+        : { quantity: { amount: component.quantity.amount, unit: component.quantity.unit } }),
+    ...(component.effectiveRate === undefined
+        ? {}
+        : {
+            effectiveRate: {
+                amount: component.effectiveRate.amount,
+                unit: component.effectiveRate.unit,
+                currencyCode: component.effectiveRate.currencyCode,
+            },
+        }),
 });
 /** Canonical UTF-8 text for a validated owner or aggregate baseline identity. */
 export const canonicalizeValidatedFinancialScopeBaselineIdentityV2 = (value) => {
@@ -116,7 +127,10 @@ export const canonicalizeValidatedFinancialScopeBaselineIdentityV2 = (value) =>
                 evidenceRefIds: [...value.accountingCurrency.evidenceRefIds].sort(compareCodePoints),
                 ...(value.accountingCurrency.fxEvidenceRefId === undefined ? {} : { fxEvidenceRefId: value.accountingCurrency.fxEvidenceRefId }),
             },
-            chargeInclusionPolicyRef: value.chargeInclusionPolicyRef,
+            chargeInclusionPolicyRef: {
+                policyId: value.chargeInclusionPolicyRef.policyId,
+                policyDigest: value.chargeInclusionPolicyRef.policyDigest,
+            },
             components: [...value.components].sort((left, right) => compareCodePoints(left.componentId, right.componentId)).map(canonicalComponent),
         });
     }
@@ -124,6 +138,12 @@ export const canonicalizeValidatedFinancialScopeBaselineIdentityV2 = (value) =>
         ...common,
         accountingCurrencyCode: value.accountingCurrencyCode,
         memberBaselineIds: [...value.memberBaselineIds].sort(compareCodePoints),
-        compatibility: value.compatibility,
+        compatibility: {
+            period: value.compatibility.period,
+            costBasis: value.compatibility.costBasis,
+            estimateLens: value.compatibility.estimateLens,
+            accountingCurrency: value.compatibility.accountingCurrency,
+            membership: value.compatibility.membership,
+        },
     });
 };

package/dist/esm/azure/financialScopeBaselineValidation.js

@@ -9,6 +9,7 @@ const MAX_SOURCE_KIND_LENGTH = 128;
 const MAX_IDENTITY_LENGTH = 256;
 const SHA256_ID = /^sha256:[0-9a-f]{64}$/;
 const DATE = /^\d{4}-\d{2}-\d{2}$/;
+const ESTIMATE_REASONS = new Set(['billing-lag', 'billing-unavailable-sponsorship', 'other']);
 const EVIDENCE_ROLES = new Set([
     'billing',
     'billing-currency-declaration',
@@ -17,6 +18,13 @@ const EVIDENCE_ROLES = new Set([
     'retail-rate',
     'commitment-quote',
     'fx-conversion',
+    'commercial-arrangement',
+    'provider-access-observation',
+    'configuration-timeline',
+    'provider-price-schedule',
+    'pricing-function',
+    'charge-inclusion-policy',
+    'settlement-revision',
     'eligibility-rule',
     'recommendation-scenario-set',
     'recommendation-lifecycle',
@@ -35,7 +43,14 @@ const OWNER_SCOPE_KINDS = new Set(['canonical-resource-owner', 'composite-resour
 const AGGREGATE_SCOPE_KINDS = new Set(['subscription-aggregate', 'portfolio-currency-group']);
 const COST_BASES = new Set(['billed', 'amortized']);
 const ESTIMATE_LENSES = new Set(['actual-only', 'actual-plus-estimated', 'estimates-only']);
-const WINDOW_KINDS = new Set(['rolling-30-days', 'calendar-month', 'provider-billing-period', 'stable-billing-window', 'daily']);
+const WINDOW_KINDS = new Set([
+    'rolling-30-days',
+    'calendar-month',
+    'provider-billing-period',
+    'stable-billing-window',
+    'analytics-history',
+    'daily',
+]);
 const SETTLEMENT_STATES = new Set(['settled', 'unsettled', 'mixed', 'unknown']);
 const CHARGE_CLASSIFICATIONS = new Set(['usage', 'purchase', 'adjustment', 'tax', 'credit', 'refund', 'residual']);
 const UNAVAILABLE_REASONS = new Set(FINANCIAL_SCOPE_BASELINE_UNAVAILABLE_REASONS_V2);
@@ -211,9 +226,9 @@ const isCommonBaseline = (value) => value.schemaVersion === FINANCIAL_SCOPE_BASE
     (value.requestedCurrencyCode === undefined || (typeof value.requestedCurrencyCode === 'string' && CURRENCY.test(value.requestedCurrencyCode))) &&
     typeof value.assessmentId === 'string' &&
     SHA256_ID.test(value.assessmentId);
-const isComponent = (value, scopeId, coverageIds, accountingCurrencyCode) => {
+const isComponent = (value, scopeId, coverageIds, accountingCurrencyCode, estimateLens) => {
     if (!isRecord(value) ||
-        !hasExactFields(value, ['componentId', 'billableIdentity', 'ownerScopeId', 'chargeClassification', 'amount', 'evidenceRefIds', 'coverageIds'], ['quantity', 'effectiveRate']) ||
+        !hasExactFields(value, ['componentId', 'billableIdentity', 'ownerScopeId', 'chargeClassification', 'amount', 'evidenceRefIds', 'coverageIds'], ['estimateReason', 'quantity', 'effectiveRate']) ||
         typeof value.componentId !== 'string' ||
         !SHA256_ID.test(value.componentId) ||
         !isBoundedIdentity(value.billableIdentity) ||
@@ -221,6 +236,8 @@ const isComponent = (value, scopeId, coverageIds, accountingCurrencyCode) => {
         typeof value.chargeClassification !== 'string' ||
         !CHARGE_CLASSIFICATIONS.has(value.chargeClassification) ||
         !isCanonicalExactMoney({ amount: value.amount, currencyCode: 'AUD' }) ||
+        (value.estimateReason !== undefined && (typeof value.estimateReason !== 'string' || !ESTIMATE_REASONS.has(value.estimateReason))) ||
+        (estimateLens === 'actual-only' && value.estimateReason !== undefined) ||
         !isHashArray(value.evidenceRefIds) ||
         !isHashArray(value.coverageIds) ||
         !value.coverageIds.every(id => coverageIds.has(id))) {
@@ -299,7 +316,7 @@ const isIdentityPreimage = (value) => {
             return false;
         }
         const coverageIds = new Set(value.period.coverage.map(item => item.coverageId));
-        return (value.components.every(component => isComponent(component, String(value.scopeId), coverageIds, String(value.accountingCurrency.currencyCode))) && new Set(value.components.map(component => component.componentId)).size === value.components.length);
+        return (value.components.every(component => isComponent(component, String(value.scopeId), coverageIds, String(value.accountingCurrency.currencyCode), value.estimateLens)) && new Set(value.components.map(component => component.componentId)).size === value.components.length);
     }
     return (value.baselineKind === 'aggregate' &&
         AGGREGATE_SCOPE_KINDS.has(String(value.scopeKind)) &&

package/dist/esm/azure/governance.js

@@ -6,6 +6,7 @@ export const TENANT_GOVERNANCE_GRAPH_SCHEMA_VERSION = '2026-05-02.tenant-graph-v
 export const GLOBAL_ADMIN_RAW_SCHEMA_VERSION = '2026-06-24.global-admin-raw-v1';
 export const PRIVILEGED_ROLE_SUMMARY_SCHEMA_VERSION = '2026-06-24.privileged-role-summary-v1';
 export const TENANT_GOVERNANCE_ACCESS_SCHEMA_VERSION = '2026-06-24.tenant-governance-access-v1';
+export const TENANT_MFA_POSTURE_SCHEMA_VERSION = '2026-08-25.tenant-mfa-posture-v1';
 export const GOVERNANCE_REPORT_PORTAL_FILE = 'governance.json.gz';
 export const GOVERNANCE_GRAPH_PORTAL_FILE = 'governance-graph.json.gz';
 export const GOVERNANCE_ACCESS_PORTAL_FILE = 'governance-access.json.gz';

package/dist/esm/azure/recommendationLifecycleOverlayValidation.js

@@ -0,0 +1,75 @@
+import { sha256Utf8 } from '../common/sha256.js';
+import { RECOMMENDATION_LIFECYCLE_OVERLAY_CONTRACT_VERSION_V2, RECOMMENDATION_LIFECYCLE_OVERLAY_SCHEMA_VERSION_V2, } from './recommendations.js';
+import { canonicalizeFinancialSavingsJsonValue, hasExactFinancialSavingsFields, isFinancialSavingsHash, isFinancialSavingsIdentity, isFinancialSavingsIsoInstant, isFinancialSavingsRecord, } from './financialSavingsAuthorityValidationPrimitives.js';
+const STATUSES = new Set(['Active', 'Prioritized', 'Dismissed', 'Archived', 'Implementing', 'Implemented', 'Failed']);
+const MAX_STATES = 50000;
+const MAX_REASONS = 64;
+const isReasonCodes = (value) => Array.isArray(value) &&
+    value.length > 0 &&
+    value.length <= MAX_REASONS &&
+    value.every(isFinancialSavingsIdentity) &&
+    new Set(value).size === value.length;
+const isLifecycleState = (value) => {
+    if (!isFinancialSavingsRecord(value) ||
+        !hasExactFinancialSavingsFields(value, ['recommendationId', 'scope', 'status', 'updatedAt', 'revision'], ['resourceId', 'statusStartAt', 'statusEndAt']) ||
+        !isFinancialSavingsIdentity(value.recommendationId) ||
+        (value.scope !== 'resource' && value.scope !== 'providerScope') ||
+        (value.scope === 'resource') !== (value.resourceId !== undefined) ||
+        (value.resourceId !== undefined && !isFinancialSavingsIdentity(value.resourceId)) ||
+        typeof value.status !== 'string' ||
+        !STATUSES.has(value.status) ||
+        (value.statusStartAt !== undefined && !isFinancialSavingsIsoInstant(value.statusStartAt)) ||
+        (value.statusEndAt !== undefined && !isFinancialSavingsIsoInstant(value.statusEndAt)) ||
+        !isFinancialSavingsIsoInstant(value.updatedAt) ||
+        !isFinancialSavingsIdentity(value.revision))
+        return false;
+    if (value.statusStartAt !== undefined && value.statusEndAt !== undefined && value.statusStartAt >= value.statusEndAt)
+        return false;
+    return value.statusStartAt === undefined || value.updatedAt >= value.statusStartAt;
+};
+const canonicalizeState = (state) => ({ ...state });
+export const canonicalizeRecommendationLifecycleOverlayIdentityV2 = (value) => JSON.stringify(canonicalizeFinancialSavingsJsonValue({
+    ...value,
+    ...(value.status === 'complete' ? {} : { reasonCodes: [...value.reasonCodes].sort() }),
+    states: [...value.states]
+        .sort((left, right) => left.recommendationId.localeCompare(right.recommendationId) ||
+        (left.resourceId ?? '').localeCompare(right.resourceId ?? ''))
+        .map(canonicalizeState),
+}));
+export const createRecommendationLifecycleOverlayIdV2 = (value) => `sha256:${sha256Utf8(canonicalizeRecommendationLifecycleOverlayIdentityV2(value))}`;
+export const isRecommendationLifecycleOverlayV2 = (value) => {
+    if (!isFinancialSavingsRecord(value) ||
+        !hasExactFinancialSavingsFields(value, [
+            'schemaVersion',
+            'contractVersion',
+            'overlayId',
+            'companyId',
+            'provider',
+            'providerScopeId',
+            'revision',
+            'generatedAt',
+            'status',
+            'states',
+        ], value.status === 'complete' ? [] : ['reasonCodes']) ||
+        value.schemaVersion !== RECOMMENDATION_LIFECYCLE_OVERLAY_SCHEMA_VERSION_V2 ||
+        value.contractVersion !== RECOMMENDATION_LIFECYCLE_OVERLAY_CONTRACT_VERSION_V2 ||
+        !isFinancialSavingsHash(value.overlayId) ||
+        !isFinancialSavingsIdentity(value.companyId) ||
+        value.provider !== 'azure' ||
+        !isFinancialSavingsIdentity(value.providerScopeId) ||
+        !isFinancialSavingsIdentity(value.revision) ||
+        !isFinancialSavingsIsoInstant(value.generatedAt) ||
+        (value.status !== 'complete' && value.status !== 'partial' && value.status !== 'unavailable') ||
+        !Array.isArray(value.states) ||
+        value.states.length > MAX_STATES ||
+        !value.states.every(isLifecycleState) ||
+        (value.status === 'unavailable' && value.states.length !== 0) ||
+        (value.status !== 'complete' && !isReasonCodes(value.reasonCodes)))
+        return false;
+    const stateKeys = value.states.map(state => `${state.scope}\u0000${state.resourceId?.toLowerCase() ?? ''}\u0000${state.recommendationId}`);
+    if (new Set(stateKeys).size !== stateKeys.length)
+        return false;
+    const overlay = value;
+    const { overlayId: _overlayId, ...identity } = overlay;
+    return overlay.overlayId === createRecommendationLifecycleOverlayIdV2(identity);
+};

package/dist/esm/azure/recommendations.js

@@ -8,3 +8,5 @@ export var RecommendationCategory;
     RecommendationCategory["OperationalExcellence"] = "OperationalExcellence";
     RecommendationCategory["OperationalExcellenceAlternative"] = "Operational Excellence";
 })(RecommendationCategory || (RecommendationCategory = {}));
+export const RECOMMENDATION_LIFECYCLE_OVERLAY_SCHEMA_VERSION_V2 = 2;
+export const RECOMMENDATION_LIFECYCLE_OVERLAY_CONTRACT_VERSION_V2 = 'recommendation-lifecycle-overlay/v2';

package/dist/esm/azure/reportDailySpend.js

@@ -0,0 +1,2 @@
+/** Maximum span of the current month and two preceding complete calendar months. */
+export const REPORT_DAILY_SPEND_MAX_DAYS = 92;