@spottoai/types-package 1.0.2-beta.36 → 1.0.2-beta.360

package/dist/esm/azure/billingPlots.js

@@ -0,0 +1,187 @@
+/**
+ * Billing cost analysis types for Azure cost visualization.
+ */
+import { isArtifactOwnershipBinding, } from '../common/artifactEvidence.js';
+import { containsForbiddenArtifactControlData } from '../common/artifactControlData.js';
+import { isArtifactRevisionVector } from '../common/artifactEvidenceValidation.js';
+import { isBillingCompletedArtifactPublicationDecision, isBillingPartialArtifactPublicationDecision, } from './billingArtifactEvidence.js';
+const BILLING_DOCUMENT_STATES = new Set(['current', 'stale', 'partial', 'fallback', 'complete-empty']);
+const SHA256_PATTERN = /^[a-f0-9]{64}$/;
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const isNonEmptyString = (value) => typeof value === 'string' && value.trim() === value && value.length > 0;
+const isFiniteNumber = (value) => typeof value === 'number' && Number.isFinite(value);
+const isOptionalFiniteNumber = (value) => value === undefined || isFiniteNumber(value);
+const isNullableFiniteNumber = (value) => value === null || isFiniteNumber(value);
+const isNonNegativeInteger = (value) => Number.isSafeInteger(value) && Number(value) >= 0;
+const isPositiveInteger = (value) => Number.isSafeInteger(value) && Number(value) > 0;
+const isStringArray = (value) => Array.isArray(value) && value.every(isNonEmptyString);
+const hasControlCharacters = (value) => Array.from(value).some(character => character.charCodeAt(0) < 32 || character.charCodeAt(0) === 127);
+const isPathSegment = (value) => isNonEmptyString(value) && !/[\\/?#%]/.test(value) && !hasControlCharacters(value) && value !== '.' && value !== '..';
+const publicationDecisionReferencesDigest = (value, digest) => isRecord(value) && Array.isArray(value.dependencies) && value.dependencies.some(dependency => isRecord(dependency) && dependency.digest === digest);
+const isTrend = (value) => isRecord(value) && isNonEmptyString(value.method) && isFiniteNumber(value.slope) && isFiniteNumber(value.intercept);
+const isDailyPoint = (value) => isRecord(value) &&
+    isNonEmptyString(value.date) &&
+    isFiniteNumber(value.timestamp) &&
+    isFiniteNumber(value.cost) &&
+    typeof value.isAnomaly === 'boolean' &&
+    isNonNegativeInteger(value.anomalyVotes) &&
+    isOptionalFiniteNumber(value.trendCost) &&
+    (value.anomalyMethods === undefined || isStringArray(value.anomalyMethods));
+const isForecastPoint = (value) => isRecord(value) &&
+    isNonEmptyString(value.date) &&
+    isFiniteNumber(value.timestamp) &&
+    isFiniteNumber(value.cost) &&
+    isOptionalFiniteNumber(value.trendCost);
+const isMonthlyPoint = (value) => isRecord(value) &&
+    /^\d{4}-\d{2}$/.test(String(value.month)) &&
+    isFiniteNumber(value.startDate) &&
+    isFiniteNumber(value.endDate) &&
+    isFiniteNumber(value.cost) &&
+    isFiniteNumber(value.averageDailyCost) &&
+    isNonNegativeInteger(value.anomalyCount) &&
+    isOptionalFiniteNumber(value.trendCost) &&
+    (value.anomalyDates === undefined || (Array.isArray(value.anomalyDates) && value.anomalyDates.every(isFiniteNumber)));
+const hasCommonChartViewFields = (value) => isFiniteNumber(value.startDate) &&
+    isFiniteNumber(value.endDate) &&
+    isFiniteNumber(value.averageDailyCost) &&
+    isFiniteNumber(value.totalCost) &&
+    (value.trend === undefined || isTrend(value.trend));
+const isChartView = (value) => {
+    if (!isRecord(value) || (value.trend !== undefined && !isTrend(value.trend)))
+        return false;
+    if (value.forecastMethod !== undefined) {
+        return (value.aggregation === 'daily' &&
+            isNonEmptyString(value.forecastMethod) &&
+            [value.startDate, value.endDate, value.actualTotalCost, value.forecastRemaining, value.forecastMonthTotal].every(isFiniteNumber) &&
+            Array.isArray(value.actualPoints) &&
+            value.actualPoints.every(isDailyPoint) &&
+            Array.isArray(value.forecastPoints) &&
+            value.forecastPoints.every(isForecastPoint) &&
+            Array.isArray(value.fittedPoints) &&
+            value.fittedPoints.every(isForecastPoint));
+    }
+    if (!hasCommonChartViewFields(value) || !Array.isArray(value.points))
+        return false;
+    if (value.aggregation === 'daily')
+        return value.points.every(isDailyPoint);
+    if (value.aggregation === 'monthly')
+        return value.points.every(isMonthlyPoint);
+    return false;
+};
+const isChartData = (value) => {
+    if (!isRecord(value) || !isPositiveInteger(value.schemaVersion) || !isNonEmptyString(value.source))
+        return false;
+    if (!isRecord(value.dataWindow) ||
+        !isFiniteNumber(value.dataWindow.startDate) ||
+        !isFiniteNumber(value.dataWindow.endDate) ||
+        !isNonNegativeInteger(value.dataWindow.pointCount)) {
+        return false;
+    }
+    if (!isRecord(value.views) || !Object.values(value.views).every(view => view === undefined || isChartView(view)))
+        return false;
+    if (!isRecord(value.detectors) || !isFiniteNumber(value.detectors.threshold) || !Array.isArray(value.detectors.methods))
+        return false;
+    return value.detectors.methods.every(method => isRecord(method) &&
+        isNonEmptyString(method.name) &&
+        (method.status === undefined || isNonEmptyString(method.status)) &&
+        (method.error === undefined || method.error === null || typeof method.error === 'string') &&
+        Array.isArray(method.triggeredDates) &&
+        method.triggeredDates.every(isFiniteNumber));
+};
+const isDriverResource = (value) => isRecord(value) &&
+    isNonEmptyString(value.name) &&
+    (value.resourceScope === undefined || isNonEmptyString(value.resourceScope)) &&
+    (value.resourceId === undefined || isNonEmptyString(value.resourceId)) &&
+    (value.isSubscriptionLevel === undefined || typeof value.isSubscriptionLevel === 'boolean') &&
+    isFiniteNumber(value.cost) &&
+    isNullableFiniteNumber(value.baseline) &&
+    isFiniteNumber(value.delta) &&
+    isNullableFiniteNumber(value.percentChange) &&
+    typeof value.isNew === 'boolean' &&
+    isNonEmptyString(value.summary);
+const isAnomaly = (value) => {
+    if (!isRecord(value) || !isFiniteNumber(value.date) || !isNonEmptyString(value.summary) || !isNonEmptyString(value.confidence))
+        return false;
+    if (!isStringArray(value.notes) || !isRecord(value.impact) || !Array.isArray(value.drivers))
+        return false;
+    const impact = value.impact;
+    const impactRequired = ['cost', 'delta', 'monthToDateCost'];
+    const impactNullable = [
+        'baseline7Day',
+        'baseline30Day',
+        'percentChange',
+        'previousDayCost',
+        'previousDayDelta',
+        'monthToDateBaseline',
+        'monthToDateDelta',
+        'monthToDatePercentChange',
+    ];
+    if (!impactRequired.every(field => isFiniteNumber(impact[field])) || !impactNullable.every(field => isNullableFiniteNumber(impact[field]))) {
+        return false;
+    }
+    return value.drivers.every(driver => isRecord(driver) &&
+        isNonEmptyString(driver.type) &&
+        isNonEmptyString(driver.name) &&
+        isNonEmptyString(driver.summary) &&
+        isFiniteNumber(driver.cost) &&
+        isFiniteNumber(driver.delta) &&
+        isNullableFiniteNumber(driver.baseline) &&
+        isNullableFiniteNumber(driver.percentChange) &&
+        isFiniteNumber(driver.shareOfImpactPercent) &&
+        typeof driver.isNew === 'boolean' &&
+        Array.isArray(driver.resources) &&
+        driver.resources.every(isDriverResource));
+};
+const hasValidMetadataEvidenceState = (state, evidence, billingGenerationId, inputManifestDigest, chartData, anomalies) => {
+    if (state === 'partial')
+        return isBillingPartialArtifactPublicationDecision(evidence, billingGenerationId, inputManifestDigest);
+    if (!isBillingCompletedArtifactPublicationDecision(evidence, billingGenerationId, inputManifestDigest))
+        return false;
+    if (state !== 'complete-empty')
+        return true;
+    const billingHistory = evidence.dependencies.find(dependency => dependency.name === 'billing-history');
+    const dataWindow = chartData.dataWindow;
+    const views = chartData.views;
+    return (billingHistory?.emptyEvidence === 'complete-empty' &&
+        billingHistory.acceptedRowCount === 0 &&
+        isNonEmptyString(billingHistory.emptyProofRef) &&
+        isRecord(dataWindow) &&
+        dataWindow.pointCount === 0 &&
+        isRecord(views) &&
+        Object.values(views).every(view => view === undefined) &&
+        anomalies.length === 0);
+};
+/** Dependency-free validator for customer-readable V2 billing metadata. */
+export const isBillingCostAnalysisMetadataV2 = (value) => {
+    if (!isRecord(value) || containsForbiddenArtifactControlData(value) || value.schemaVersion !== 2)
+        return false;
+    if (Object.prototype.hasOwnProperty.call(value, 'outputManifestDigest'))
+        return false;
+    if (!isPathSegment(value.subscriptionId) || !isPathSegment(value.billingGenerationId))
+        return false;
+    if (!isArtifactOwnershipBinding(value.ownership) || value.ownership.provider !== 'azure' || value.ownership.accountId !== value.subscriptionId)
+        return false;
+    if (!isArtifactRevisionVector(value.revision) || value.ownership.ownershipEpochRevision !== value.revision.ownershipEpochRevision) {
+        return false;
+    }
+    if (typeof value.artifactState !== 'string' || !BILLING_DOCUMENT_STATES.has(value.artifactState))
+        return false;
+    if (typeof value.inputManifestDigest !== 'string' || !SHA256_PATTERN.test(value.inputManifestDigest))
+        return false;
+    if (typeof value.outputBindingDigest !== 'string' || !SHA256_PATTERN.test(value.outputBindingDigest))
+        return false;
+    if (value.outputBindingDigest === value.inputManifestDigest ||
+        publicationDecisionReferencesDigest(value.artifactEvidence, value.outputBindingDigest)) {
+        return false;
+    }
+    if (!isChartData(value.chartData) || !Array.isArray(value.anomalies) || !value.anomalies.every(isAnomaly))
+        return false;
+    if (!hasValidMetadataEvidenceState(value.artifactState, value.artifactEvidence, value.billingGenerationId, value.inputManifestDigest, value.chartData, value.anomalies)) {
+        return false;
+    }
+    if (!isNonEmptyString(value.currencyCode) || !isNonEmptyString(value.currencySymbol))
+        return false;
+    if (value.forecastMethod !== undefined && !isNonEmptyString(value.forecastMethod))
+        return false;
+    return [value.forecastMonthTotal, value.forecastRemaining, value.forecastPeriodEnd].every(isOptionalFiniteNumber);
+};

package/dist/esm/azure/budgets.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/commitmentsPlanning.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/common.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/configs.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/costComposition.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/dataProtection.js

@@ -0,0 +1,5 @@
+export const DATA_PROTECTION_SCHEMA_VERSION = '2026-06-24';
+export const DATA_PROTECTION_SOURCE = 'Spotto.DataProtectionPosture';
+export const DATA_PROTECTION_PORTAL_FILE = 'data-protection.json.gz';
+export const DATA_PROTECTION_BACKUP_COST_DIAGNOSTICS_FILE = 'data-protection/backup-costs.json.gz';
+export const DATA_PROTECTION_BILLING_SOURCE_FILE = 'history/billing/cost-last-30-days.json';

package/dist/esm/azure/governance.js

@@ -0,0 +1,14 @@
+export const GOVERNANCE_REPORT_SCHEMA_VERSION = '2026-05-01.slim-v1';
+export const GOVERNANCE_GRAPH_SCHEMA_VERSION = '2026-05-02.graph-v1';
+export const GOVERNANCE_ACCESS_SCHEMA_VERSION = '2026-05-14.identity-access-v2';
+export const TENANT_GOVERNANCE_REPORT_SCHEMA_VERSION = '2026-05-02.tenant-slim-v1';
+export const TENANT_GOVERNANCE_GRAPH_SCHEMA_VERSION = '2026-05-02.tenant-graph-v1';
+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 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';
+export const TENANT_GOVERNANCE_REPORT_PORTAL_FILE = 'governance.json.gz';
+export const TENANT_GOVERNANCE_GRAPH_PORTAL_FILE = 'governance-graph.json.gz';
+export const TENANT_GOVERNANCE_ACCESS_PORTAL_FILE = 'governance-access.json.gz';

package/dist/esm/azure/licensing.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/metrics.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/payloads.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/portalArtifacts.js

@@ -0,0 +1 @@
+export const AZURE_PORTAL_ARTIFACT_SCHEMA_VERSION = 1;

package/dist/esm/azure/prices.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/publicIpAddresses.js

@@ -0,0 +1,2 @@
+export const PUBLIC_IP_ADDRESSES_SCHEMA_VERSION = '2026-05-02.public-ip-addresses-v1';
+export const PUBLIC_IP_ADDRESSES_PORTAL_FILE = 'public-ip-addresses.json';

package/dist/esm/azure/recommendationAudit.js

@@ -0,0 +1,16 @@
+export const RecommendationAuditRowKinds = {
+    resourceTarget: 'resource-view:target',
+    subscriptionTarget: 'scope-view:target',
+    resourceProviderScopeFeed: 'resource-view:providerScope-feed',
+    subscriptionProviderScopeFeed: 'scope-view:providerScope-feed',
+};
+export const RecommendationWorkflowAuditEventTypes = {
+    assigned: 'WorkflowAssigned',
+    laneChanged: 'WorkflowLaneChanged',
+    blocked: 'WorkflowBlocked',
+    unblocked: 'WorkflowUnblocked',
+    returnedToSuggestions: 'ReturnedToSuggestions',
+    repaired: 'WorkflowRepaired',
+    sourceChanged: 'WorkflowSourceChanged',
+};
+export const RECOMMENDATION_WORKFLOW_AUDIT_DETAILS_SCHEMA_VERSION = 1;

package/dist/esm/azure/recommendationState.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/recommendationTracks.js

@@ -0,0 +1,40 @@
+export const SystemTrackIds = {
+    resourceHygiene: 'resource-hygiene',
+    capacityRightsizing: 'capacity-rightsizing',
+    securityPosture: 'security-posture',
+    patchingLifecycle: 'patching-lifecycle',
+    commitmentsLicensing: 'commitments-licensing',
+    backupRecovery: 'backup-recovery',
+    perimeterExposure: 'perimeter-exposure',
+    identityPrivilege: 'identity-privilege',
+    governanceOwnership: 'governance-ownership',
+    spendExceptions: 'spend-exceptions',
+};
+export const RecommendationFocusModes = {
+    all: 'all',
+    finops: 'finops',
+    securityGovernance: 'securityGovernance',
+    operationalHealth: 'operationalHealth',
+    optimizationDelivery: 'optimizationDelivery',
+    serviceDelivery: 'serviceDelivery',
+};
+export const RecommendationTrackFacets = {
+    orphaned: 'orphaned',
+    unattached: 'unattached',
+    idle: 'idle',
+    underutilized: 'underutilized',
+    unprotected: 'unprotected',
+    staleBackup: 'stale-backup',
+    expiring: 'expiring',
+    unpatched: 'unpatched',
+    unsupported: 'unsupported',
+    publicIngress: 'public-ingress',
+    overprivileged: 'overprivileged',
+    missingOwnership: 'missing-ownership',
+    missingTags: 'missing-tags',
+    costAnomaly: 'cost-anomaly',
+};
+export const SystemTrackCardGranularities = {
+    recommendation: 'recommendation',
+    resource: 'resource',
+};

package/dist/esm/azure/recommendationWorkflow.js

@@ -0,0 +1,13 @@
+export const RecommendationWorkflowLanes = {
+    prioritized: 'prioritized',
+    todo: 'todo',
+    inProgress: 'in-progress',
+    blocked: 'blocked',
+    completed: 'completed',
+};
+export const RecommendationWorkflowSelectionModes = {
+    allAffected: 'all-affected',
+    selectedSubset: 'selected-subset',
+    subscriptionWide: 'subscription-wide',
+};
+export const RECOMMENDATION_WORKFLOW_REPAIR_PAGE_LIMIT = 250;

package/dist/esm/azure/recommendations.js

@@ -0,0 +1,10 @@
+export var RecommendationCategory;
+(function (RecommendationCategory) {
+    RecommendationCategory["Cost"] = "Cost";
+    RecommendationCategory["Performance"] = "Performance";
+    RecommendationCategory["Reliability"] = "Reliability";
+    RecommendationCategory["Security"] = "Security";
+    RecommendationCategory["Compliance"] = "Compliance";
+    RecommendationCategory["OperationalExcellence"] = "OperationalExcellence";
+    RecommendationCategory["OperationalExcellenceAlternative"] = "Operational Excellence";
+})(RecommendationCategory || (RecommendationCategory = {}));

package/dist/esm/azure/regulatoryCompliance.js

@@ -0,0 +1,6 @@
+export const REGULATORY_COMPLIANCE_REPORT_SCHEMA_VERSION = '2026-07-29.regulatory-compliance-v1';
+export const REGULATORY_COMPLIANCE_ASSIGNMENT_DETAIL_SCHEMA_VERSION = '2026-07-29.regulatory-compliance-assignment-v1';
+export const POLICY_EXEMPTION_COMMAND_SCHEMA_VERSION = '2026-07-29.policy-exemption-command-v1';
+export const REGULATORY_COMPLIANCE_PORTAL_FILE = 'regulatory-compliance.json.gz';
+export const REGULATORY_COMPLIANCE_ASSIGNMENT_DETAIL_DIRECTORY = 'regulatory-compliance/assignments';
+export const REGULATORY_COMPLIANCE_NOTE_TARGET_TYPES = ['assignment', 'control', 'policy'];

package/dist/esm/azure/relationships.js

@@ -0,0 +1,2 @@
+export const RELATIONSHIP_GRAPH_MANIFEST_SCHEMA_VERSION = 1;
+export const RELATIONSHIP_GRAPH_INDEX_SCHEMA_VERSION = 1;

package/dist/esm/azure/reportingTemplates.js

@@ -0,0 +1 @@
+export const REPORTING_TEMPLATE_REPORT_TYPES = ['sdm', 'sow', 'review-checklist', 'architecture-assessment'];

package/dist/esm/azure/reports.js

@@ -0,0 +1,12 @@
+/** Specific reason types for cost changes */
+export var ChangeReasonType;
+(function (ChangeReasonType) {
+    ChangeReasonType["NEW_RESOURCE"] = "new_resource";
+    ChangeReasonType["REMOVED_RESOURCE"] = "removed_resource";
+    ChangeReasonType["QUANTITY_INCREASE"] = "quantity_increase";
+    ChangeReasonType["QUANTITY_DECREASE"] = "quantity_decrease";
+    ChangeReasonType["RATE_CHANGE"] = "rate_change";
+    ChangeReasonType["SKU_CHANGE"] = "sku_change";
+    ChangeReasonType["NEW_METER"] = "new_meter";
+    ChangeReasonType["REMOVED_METER"] = "removed_meter";
+})(ChangeReasonType || (ChangeReasonType = {}));

package/dist/esm/azure/resourceHealth.js

@@ -0,0 +1,12 @@
+export const RESOURCE_HEALTH_EVENTS_FILE_NAME = 'microsoft.resourcehealth-events.json';
+export const RESOURCE_HEALTH_EVENTS_IMPACTED_RESOURCES_FILE_NAME = 'microsoft.resourcehealth-events-impactedresources.json';
+export const RESOURCE_HEALTH_AVAILABILITY_STATUSES_FILE_NAME = 'microsoft.resourcehealth-availabilitystatuses.json';
+export const RESOURCE_HEALTH_EVENTS_PORTAL_FILE_NAME = 'health-events.json';
+export const RESOURCE_HEALTH_AVAILABILITY_STATUSES_PORTAL_FILE_NAME = 'health-availability-statuses.json';
+export const RESOURCE_HEALTH_INDEX_FILE_NAME = 'history/resource-health/index.json';
+export const AZURE_RESOURCE_HEALTH_EVENTS_SOURCE = 'Microsoft.ResourceHealth/events';
+export const AZURE_RESOURCE_HEALTH_IMPACTED_RESOURCES_SOURCE = 'Microsoft.ResourceHealth/events/impactedResources';
+export const AZURE_RESOURCE_HEALTH_AVAILABILITY_STATUSES_SOURCE = 'Microsoft.ResourceHealth/availabilityStatuses';
+export const RESOURCE_HEALTH_EVENTS_SOURCE = AZURE_RESOURCE_HEALTH_EVENTS_SOURCE;
+export const RESOURCE_HEALTH_EVENTS_IMPACTED_RESOURCES_SOURCE = AZURE_RESOURCE_HEALTH_IMPACTED_RESOURCES_SOURCE;
+export const RESOURCE_HEALTH_AVAILABILITY_STATUSES_SOURCE = AZURE_RESOURCE_HEALTH_AVAILABILITY_STATUSES_SOURCE;

package/dist/esm/azure/resourceOptimization.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/resources.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/reviewChecklist.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/secureScore.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/security.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/serviceRetirement.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/serviceRetirementState.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/serviceRetirementWorkManagement.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/storage-inventory.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/subscriptions.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/azure/views.js

@@ -0,0 +1,181 @@
+import { allowedArtifactReferenceField, containsForbiddenArtifactControlData, } from '../common/artifactControlData.js';
+import { isArtifactOwnershipBinding, isArtifactPublicationDecision, isEnforceableArtifactOwnershipBinding, } from '../common/artifactEvidence.js';
+import { isArtifactRevisionVector, isStrictLogicalArtifactReference } from '../common/artifactEvidenceValidation.js';
+const isNonEmptyString = (value) => typeof value === 'string' && value.trim().length > 0;
+const isCanonicalIsoTimestamp = (value) => {
+    if (!isNonEmptyString(value))
+        return false;
+    const timestamp = Date.parse(value);
+    return Number.isFinite(timestamp) && new Date(timestamp).toISOString() === value;
+};
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const isLogicalManifestPath = (value) => {
+    if (!isNonEmptyString(value))
+        return false;
+    if (value.startsWith('/') || value.includes('://') || value.includes('?') || value.includes('#') || value.includes('\\'))
+        return false;
+    const segments = value.split('/');
+    return segments.length >= 2 && segments.every(segment => segment.length > 0 && segment !== '.' && segment !== '..');
+};
+const isViewSetSurfaceReference = (value) => isRecord(value) && isNonEmptyString(value.runId) && isLogicalManifestPath(value.manifestPath) && isCanonicalIsoTimestamp(value.completedAt);
+/** Dependency-free rejection boundary for customer-readable cross-surface pointers. */
+export const isCompletedAzureViewSetV1 = (value) => {
+    if (!isRecord(value))
+        return false;
+    if (value.schemaVersion !== 1 || value.status !== 'completed')
+        return false;
+    if (!isNonEmptyString(value.subscriptionId) || !isNonEmptyString(value.publicationId) || !isCanonicalIsoTimestamp(value.completedAt)) {
+        return false;
+    }
+    if (!isViewSetSurfaceReference(value.portal) || !isViewSetSurfaceReference(value.plugin))
+        return false;
+    if (!isRecord(value.economics))
+        return false;
+    return isNonEmptyString(value.economics.generationId) && isNonEmptyString(value.economics.fingerprint);
+};
+const VIEW_CONTENT_ENCODINGS = new Set(['identity', 'gzip']);
+const SHA256_PATTERN = /^[a-f0-9]{64}$/;
+const hasControlCharacters = (value) => Array.from(value).some(character => character.charCodeAt(0) < 32 || character.charCodeAt(0) === 127);
+const isStrictNonEmptyString = (value) => typeof value === 'string' && value.trim() === value && value.length > 0 && !hasControlCharacters(value);
+const isPositiveSafeInteger = (value) => Number.isSafeInteger(value) && Number(value) > 0;
+const isNonNegativeSafeInteger = (value) => Number.isSafeInteger(value) && Number(value) >= 0;
+const isSha256 = (value) => typeof value === 'string' && SHA256_PATTERN.test(value);
+const allowedViewArtifactPaths = (artifacts) => Array.isArray(artifacts) ? artifacts.flatMap(artifact => allowedArtifactReferenceField(artifact, 'path')) : [];
+const isSafePathSegment = (value) => isStrictNonEmptyString(value) && !/[\\/?#%]/.test(value) && value !== '.' && value !== '..';
+const isStrictCanonicalIsoTimestamp = (value) => {
+    if (!isStrictNonEmptyString(value))
+        return false;
+    const timestamp = Date.parse(value);
+    return Number.isFinite(timestamp) && new Date(timestamp).toISOString() === value;
+};
+const isEnforceableAzureOwnershipBinding = (value) => isEnforceableArtifactOwnershipBinding(value) && value.provider === 'azure';
+const hasMatchingViewOwnership = (subscriptionId, ownership, revision, enforceable) => {
+    if (!isSafePathSegment(subscriptionId) || !isArtifactRevisionVector(revision))
+        return false;
+    if (!isArtifactOwnershipBinding(ownership))
+        return false;
+    if (enforceable && !isEnforceableArtifactOwnershipBinding(ownership))
+        return false;
+    if (ownership.provider !== 'azure' || ownership.accountId !== subscriptionId)
+        return false;
+    return ownership.ownershipEpochRevision === revision.ownershipEpochRevision;
+};
+const isViewArtifactDescriptor = (value, runId) => isRecord(value) &&
+    isStrictLogicalArtifactReference(value.path) &&
+    value.path.startsWith(`runs/${runId}/`) &&
+    value.path.length > `runs/${runId}/`.length &&
+    isStrictNonEmptyString(value.name) &&
+    value.mediaType === 'application/json' &&
+    typeof value.contentEncoding === 'string' &&
+    VIEW_CONTENT_ENCODINGS.has(value.contentEncoding) &&
+    isNonNegativeSafeInteger(value.byteLength) &&
+    isSha256(value.sha256);
+const hasRequiredViewDependencies = (decision) => {
+    const dependencies = new Map(decision.dependencies.map(dependency => [dependency.name, dependency]));
+    const billing = dependencies.get('billing');
+    const economics = dependencies.get('economics');
+    if (!billing || !economics)
+        return false;
+    for (const dependency of [billing, economics]) {
+        if (dependency.publication === 'completed' && (!isStrictNonEmptyString(dependency.generationId) || !isSha256(dependency.digest))) {
+            return false;
+        }
+    }
+    const completedDependencies = new Set(decision.dependencies.filter(dependency => dependency.publication === 'completed').map(dependency => dependency.name));
+    return decision.claims.every(claim => claim.publication !== 'completed' || claim.requiredDependencies.every(dependency => completedDependencies.has(dependency)));
+};
+/** Validates an evidence-aware completed portal or plugin generation manifest. */
+export const isCompletedViewManifestV3 = (value) => {
+    if (!isRecord(value) || containsForbiddenArtifactControlData(value, allowedViewArtifactPaths(value.artifacts)))
+        return false;
+    if (value.schemaVersion !== 3 || value.status !== 'completed')
+        return false;
+    if (!isSafePathSegment(value.runId) || !hasMatchingViewOwnership(value.subscriptionId, value.ownership, value.revision, false))
+        return false;
+    if (!isRecord(value.artifactGeneration) ||
+        value.artifactGeneration.runId !== value.runId ||
+        !isStrictCanonicalIsoTimestamp(value.artifactGeneration.generatedAt)) {
+        return false;
+    }
+    if (!Array.isArray(value.artifacts) || value.artifacts.length === 0)
+        return false;
+    if (!value.artifacts.every(artifact => isViewArtifactDescriptor(artifact, value.runId)))
+        return false;
+    if (new Set(value.artifacts.map(artifact => artifact.path)).size !== value.artifacts.length ||
+        new Set(value.artifacts.map(artifact => artifact.name)).size !== value.artifacts.length) {
+        return false;
+    }
+    if (!isPositiveSafeInteger(value.requestedArtifactCount) ||
+        value.requestedArtifactCount !== value.artifacts.length ||
+        !isNonNegativeSafeInteger(value.requestedResourceCount) ||
+        value.failedArtifactCount !== 0 ||
+        value.failedResourceCount !== 0 ||
+        !isSha256(value.compositeDependencyDigest) ||
+        !isStrictCanonicalIsoTimestamp(value.completedAt)) {
+        return false;
+    }
+    return isArtifactPublicationDecision(value.publicationDecision) && hasRequiredViewDependencies(value.publicationDecision);
+};
+const hasSameOwnership = (left, right) => left.provider === right.provider &&
+    left.tenantId === right.tenantId &&
+    left.companyId === right.companyId &&
+    left.cloudAccountId === right.cloudAccountId &&
+    left.accountId === right.accountId &&
+    left.ownershipEpochRevision === right.ownershipEpochRevision;
+const hasSameRevision = (left, right) => left.ownershipEpochRevision === right.ownershipEpochRevision &&
+    left.sourceRevision === right.sourceRevision &&
+    left.policyRevision === right.policyRevision;
+const isViewSetV2SurfaceReference = (value, surface, subscriptionId, ownership, revision, compositeDependencyDigest) => {
+    if (!isRecord(value) || !isSafePathSegment(value.runId))
+        return false;
+    const expectedManifestName = surface === 'portal' ? 'completed-view-manifest.json' : 'completed-plugin-generation.json';
+    if (value.manifestPath !== `runs/${value.runId}/${expectedManifestName}` || !isStrictLogicalArtifactReference(value.manifestPath))
+        return false;
+    if (!isEnforceableAzureOwnershipBinding(value.ownership) || !isArtifactRevisionVector(value.revision))
+        return false;
+    if (!hasMatchingViewOwnership(subscriptionId, value.ownership, value.revision, true))
+        return false;
+    if (!hasSameOwnership(ownership, value.ownership) || !hasSameRevision(revision, value.revision))
+        return false;
+    return (isSha256(value.manifestDigest) &&
+        value.compositeDependencyDigest === compositeDependencyDigest &&
+        isStrictCanonicalIsoTimestamp(value.completedAt));
+};
+const hasMatchingSurfaceDependency = (decision, name, surface) => {
+    const dependency = decision.dependencies.find(candidate => candidate.name === name);
+    return (dependency !== undefined &&
+        dependency.required &&
+        dependency.publication === 'completed' &&
+        dependency.generationId === surface.runId &&
+        dependency.digest === surface.manifestDigest);
+};
+/** Validates the promoted pointer for an evidence-enforced portal/plugin view pair. */
+export const isCompletedAzureViewSetV2 = (value) => {
+    const allowedReferences = isRecord(value)
+        ? [...allowedArtifactReferenceField(value.portal, 'manifestPath'), ...allowedArtifactReferenceField(value.plugin, 'manifestPath')]
+        : [];
+    if (!isRecord(value) || containsForbiddenArtifactControlData(value, allowedReferences))
+        return false;
+    if (value.schemaVersion !== 2 || value.status !== 'completed')
+        return false;
+    if (!isSafePathSegment(value.subscriptionId) ||
+        !isStrictNonEmptyString(value.publicationId) ||
+        !isEnforceableAzureOwnershipBinding(value.ownership) ||
+        !isArtifactRevisionVector(value.revision) ||
+        !hasMatchingViewOwnership(value.subscriptionId, value.ownership, value.revision, true)) {
+        return false;
+    }
+    if (!isSha256(value.compositeDependencyDigest) || !isStrictCanonicalIsoTimestamp(value.completedAt))
+        return false;
+    if (!isViewSetV2SurfaceReference(value.portal, 'portal', value.subscriptionId, value.ownership, value.revision, value.compositeDependencyDigest) ||
+        !isViewSetV2SurfaceReference(value.plugin, 'plugin', value.subscriptionId, value.ownership, value.revision, value.compositeDependencyDigest)) {
+        return false;
+    }
+    const laterSurfaceCompletedAt = Date.parse(value.portal.completedAt) >= Date.parse(value.plugin.completedAt) ? value.portal.completedAt : value.plugin.completedAt;
+    if (value.completedAt !== laterSurfaceCompletedAt)
+        return false;
+    return (isArtifactPublicationDecision(value.publicationDecision) &&
+        value.publicationDecision.publication === 'completed' &&
+        hasMatchingSurfaceDependency(value.publicationDecision, 'portal', value.portal) &&
+        hasMatchingSurfaceDependency(value.publicationDecision, 'plugin', value.plugin));
+};

package/dist/esm/azure/workManagement.js

@@ -0,0 +1,4 @@
+export const WORK_ITEM_LANES = ['prioritized', 'todo', 'in-progress', 'completed'];
+export const DEFAULT_WORK_BOARD_ID = 'kanban';
+export const WORK_ITEM_EXTERNAL_TICKET_PROVIDERS = ['jira', 'halo', 'connectwise', 'autotask', 'azuredevops', 'github'];
+export const WORK_ITEM_SHARE_CHANNELS = ['email', ...WORK_ITEM_EXTERNAL_TICKET_PROVIDERS];