@spottoai/types-package 1.0.2-beta.42 → 1.0.2-beta.421

package/dist/portfolio/portfolioOperations.d.ts

@@ -0,0 +1,174 @@
+export type PortfolioDataStatus = 'complete' | 'partial' | 'unavailable';
+export type PortfolioSortDirection = 'asc' | 'desc';
+export interface PortfolioCustomerReference {
+    companyId: string;
+    companyName: string;
+}
+export interface PortfolioDataFailure {
+    companyId: string;
+    cloudAccountId?: string;
+    subscriptionId?: string;
+    source: 'accounts' | 'budgets' | 'commitments' | 'cost' | 'credentials' | 'data-protection' | 'governance' | 'hierarchy' | 'recommendations' | 'reporting' | 'resource-health' | 'perimeter' | 'security' | 'service-retirements' | 'subscriptions';
+    code: string;
+}
+export interface PortfolioDataCoverage {
+    status: PortfolioDataStatus;
+    requestedCustomers: number;
+    loadedCustomers: number;
+    requestedSubscriptions: number;
+    loadedSubscriptions: number;
+    observedAt?: string;
+    failures: PortfolioDataFailure[];
+}
+export interface PortfolioPageResponse<TItem, TSummary> {
+    items: TItem[];
+    summary: TSummary;
+    coverage: PortfolioDataCoverage;
+    page: number;
+    pageSize: number;
+    totalRows: number;
+    totalPages: number;
+    /** Rows retained by the bounded projection and available to page through. */
+    retainedRows?: number;
+    /** True when totalRows is larger than the retained result set. */
+    truncated?: boolean;
+}
+export type PortfolioCustomerSortField = 'customerName' | 'subscriptionCount' | 'readySubscriptionCount' | 'cloudAccountCount' | 'averageSecureScore' | 'averageAdvisorScore' | 'lastUpdated';
+export interface PortfolioCustomerRow extends PortfolioCustomerReference {
+    subscriptionDataAvailable: boolean;
+    subscriptionCount: number;
+    readySubscriptionCount: number;
+    notReadySubscriptionCount: number;
+    cloudAccountCount: number;
+    averageSecureScore?: number;
+    averageAdvisorScore?: number;
+    lastUpdated?: string;
+}
+export interface PortfolioCustomerSummary {
+    availableCompanies: number;
+    subscriptions: number;
+    readySubscriptions: number;
+    cloudAccounts: number;
+}
+export type PortfolioBudgetStatus = 'healthy' | 'at-risk' | 'over-budget';
+export type PortfolioBudgetSortField = 'customerName' | 'subscriptionName' | 'budgetName' | 'status' | 'actualPercent' | 'forecastPercent' | 'endDate';
+export interface PortfolioBudgetRow {
+    id: string;
+    companyId: string;
+    customerName: string;
+    subscriptionId: string;
+    subscriptionName: string;
+    budgetName: string;
+    currency: string;
+    currencySymbol?: string;
+    amount: number;
+    currentSpend: number;
+    forecastedSpend: number;
+    actualPercent: number;
+    forecastPercent: number;
+    status: PortfolioBudgetStatus;
+    startDate: string;
+    endDate: string;
+}
+export interface PortfolioBudgetSummary {
+    totalBudgets: number;
+    overBudget: number;
+    atRisk: number;
+    forecastOverBudget: number;
+}
+export type PortfolioSowApprovalStatus = 'approved' | 'unapproved';
+export type PortfolioSowSortField = 'customerName' | 'fileName' | 'issuedAt' | 'approvalStatus' | 'approvedAt';
+export interface PortfolioSowRow {
+    id: string;
+    companyId: string;
+    customerName: string;
+    fileName: string;
+    issuedAt: string;
+    issuedBy?: string;
+    reportPeriod?: string;
+    approvalStatus: PortfolioSowApprovalStatus;
+    approvedAt?: string;
+    approvedBy?: string;
+}
+export interface PortfolioSowSummary {
+    totalIssued: number;
+    approved: number;
+    unapproved: number;
+    issuedThisMonth: number;
+}
+export type PortfolioReportType = 'sdm' | 'sow';
+export type PortfolioReportSortField = 'companyName' | 'fileName' | 'reportType' | 'createdAt' | 'reportPeriod';
+export interface PortfolioReportRow {
+    id: string;
+    companyId: string;
+    companyName: string;
+    reportType: PortfolioReportType;
+    fileName: string;
+    createdAt: string;
+    createdBy?: string;
+    templateId?: string;
+    templateRevision?: number;
+    schemaVersion: number;
+    sourceDataTimestamp?: string;
+    reportPeriod?: string;
+}
+export interface PortfolioReportSummary {
+    totalReports: number;
+    statementsOfWork: number;
+    sdmReports: number;
+    companiesWithReports: number;
+}
+export interface UpdatePortfolioSowApprovalRequest {
+    approvalStatus: PortfolioSowApprovalStatus;
+}
+export type PortfolioMonthEndStatus = 'complete' | 'incomplete' | 'unavailable';
+export type PortfolioMonthEndSortField = 'customerName' | 'status' | 'issuedAt' | 'reportPeriod';
+export interface PortfolioMonthEndRow {
+    id: string;
+    companyId: string;
+    customerName: string;
+    reportPeriod: string;
+    status: PortfolioMonthEndStatus;
+    draftId?: string;
+    issuedReportId?: string;
+    issuedAt?: string;
+    updatedAt?: string;
+}
+export interface PortfolioMonthEndSummary {
+    totalCustomers: number;
+    complete: number;
+    incomplete: number;
+    unavailable: number;
+}
+export type PortfolioExpiryKind = 'service-principal' | 'cloud-account-credential' | 'application-secret' | 'application-certificate' | 'key-vault-secret' | 'key-vault-key' | 'key-vault-certificate' | 'reservation' | 'savings-plan' | 'service-retirement' | 'service-expiry';
+export type PortfolioExpiryStatus = 'expired' | 'expiring' | 'active';
+export type PortfolioExpirySortField = 'customerName' | 'kind' | 'name' | 'expiryDate' | 'daysToExpiry';
+export interface PortfolioExpiryRow {
+    id: string;
+    companyId: string;
+    customerName: string;
+    subscriptionId?: string;
+    subscriptionName?: string;
+    kind: PortfolioExpiryKind;
+    name: string;
+    expiryDate: string;
+    daysToExpiry: number;
+    status: PortfolioExpiryStatus;
+    sourceUrl?: string;
+}
+export interface PortfolioExpirySummary {
+    total: number;
+    expired: number;
+    expiringWithin30Days: number;
+    expiringWithin90Days: number;
+}
+export type PortfolioExceptionKind = 'attention' | 'risk' | 'service-opportunity';
+export type PortfolioAttentionSortField = 'companyName' | 'severity' | 'title' | 'dueAt';
+export interface PortfolioAttentionSummary {
+    total: number;
+    critical: number;
+    high: number;
+    medium: number;
+    low: number;
+}
+//# sourceMappingURL=portfolioOperations.d.ts.map

package/dist/portfolio/portfolioOperations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portfolioOperations.d.ts","sourceRoot":"","sources":["../../src/portfolio/portfolioOperations.ts"],"names":[],"mappings":"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"}

package/dist/portfolio/portfolioOperations.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=portfolioOperations.js.map

package/dist/portfolio/portfolioOperations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portfolioOperations.js","sourceRoot":"","sources":["../../src/portfolio/portfolioOperations.ts"],"names":[],"mappings":""}

package/dist/portfolio/portfolioProjections.d.ts

@@ -0,0 +1,460 @@
+import type { PortfolioBudgetRow, PortfolioDataCoverage, PortfolioDataStatus, PortfolioAttentionSummary, PortfolioExpiryRow, PortfolioMonthEndRow, PortfolioReportSummary, PortfolioReportRow, PortfolioSowRow } from './portfolioOperations';
+export declare const PORTFOLIO_PROJECTION_PREVIOUS_SCHEMA_VERSION: "2026-07-26";
+export declare const PORTFOLIO_PROJECTION_SCHEMA_VERSION: "2026-08-02";
+export declare const PORTFOLIO_PROJECTION_COMPATIBLE_SCHEMA_VERSIONS: readonly ["2026-07-26", "2026-08-02"];
+export declare const PORTFOLIO_PROJECTION_DETAIL_LIMIT = 60;
+/** Legacy fixed-shard count used to read compatible manifests published before byte-bounded packing. */
+export declare const PORTFOLIO_PROJECTION_DETAIL_SHARD_COUNT = 16;
+/** Publishers target small detail artifacts and start a new shard before either target is crossed. */
+export declare const PORTFOLIO_PROJECTION_DETAIL_TARGET_COMPRESSED_BYTES: number;
+export declare const PORTFOLIO_PROJECTION_DETAIL_TARGET_DECODED_BYTES: number;
+/** Aggregate decoded payload budget for a single Worker projection read. */
+export declare const PORTFOLIO_PROJECTION_MAX_REQUEST_DECODED_BYTES: number;
+export declare const PORTFOLIO_PROJECTION_MAX_COMPRESSED_BYTES: number;
+export declare const PORTFOLIO_PROJECTION_MAX_DECODED_BYTES: number;
+export declare const PORTFOLIO_CLOUD_ACCOUNT_SUMMARY_SCHEMA_VERSION: "2026-08-13";
+export type PortfolioProjectionSchemaVersion = (typeof PORTFOLIO_PROJECTION_COMPATIBLE_SCHEMA_VERSIONS)[number];
+export type PortfolioProjectionScopeType = 'company-self' | 'company-hierarchy';
+export type PortfolioProjectionGroup = 'cloud' | 'delivery';
+export type PortfolioProjectionPrimaryArtifactKind = 'estate' | 'insights' | 'operations' | 'delivery';
+export type PortfolioProjectionArtifactKind = PortfolioProjectionPrimaryArtifactKind | 'details';
+export type PortfolioProjectionBuildStatus = 'complete' | 'partial';
+export type PortfolioProjectionFreshnessStatus = 'current' | 'stale' | 'expired' | 'unavailable';
+export type PortfolioCurrencyStatus = 'single' | 'mixed' | 'unavailable';
+export type PortfolioCloudProvider = 'azure' | 'aws' | 'gcp' | 'other' | 'unknown';
+export type PortfolioEnvironment = 'Production' | 'Non-Production' | 'Mixed' | 'Unknown';
+export type PortfolioOperationalStatus = 'healthy' | 'needs-attention' | 'critical' | 'not-assessed';
+export type PortfolioAttentionSeverity = 'critical' | 'high' | 'medium' | 'low';
+export type PortfolioAttentionDomain = 'security' | 'reliability' | 'finops' | 'expiry' | 'reporting' | 'service-opportunity' | 'sync';
+export interface PortfolioCurrencyAmount {
+    currency: string;
+    amount: number;
+}
+export interface PortfolioCurrencyCoverage {
+    status: PortfolioCurrencyStatus;
+    currencies: string[];
+    missingValueCount: number;
+}
+export interface PortfolioProjectionFailure {
+    source: 'accounts' | 'budgets' | 'commitments' | 'cost' | 'credentials' | 'data-protection' | 'governance' | 'hierarchy' | 'recommendations' | 'reporting' | 'resource-health' | 'perimeter' | 'security' | 'service-retirements' | 'subscriptions';
+    code: string;
+    companyId?: string;
+    cloudAccountId?: string;
+    subscriptionId?: string;
+    retryable?: boolean;
+}
+export interface PortfolioProjectionCounts {
+    descendantCompanies: number;
+    contributingCompanies: number;
+    cloudAccounts: number;
+    subscriptions: number;
+    readySubscriptions: number;
+}
+export interface PortfolioProjectionCoverage {
+    status: PortfolioProjectionBuildStatus;
+    expectedCompanies: number;
+    loadedCompanies: number;
+    expectedCloudAccounts: number;
+    loadedCloudAccounts: number;
+    expectedSubscriptions: number;
+    loadedSubscriptions: number;
+    failures: PortfolioProjectionFailure[];
+}
+export interface PortfolioProjectionMetadata {
+    schemaVersion: PortfolioProjectionSchemaVersion;
+    scopeCompanyId: string;
+    scopeType: PortfolioProjectionScopeType;
+    generationId: string;
+    generatedAt: string;
+    sourceObservedAt?: string;
+    freshness: PortfolioProjectionFreshnessStatus;
+    hierarchyRootCompanyId: string;
+    hierarchyVersion?: string;
+    inputDigest: string;
+    counts: PortfolioProjectionCounts;
+    coverage: PortfolioProjectionCoverage;
+    currencyCoverage: PortfolioCurrencyCoverage;
+}
+export interface PortfolioProjectionArtifactDescriptor {
+    kind: PortfolioProjectionArtifactKind;
+    /** Present only when kind is `details`; zero-based within that manifest's packed shard set. */
+    shardIndex?: number;
+    /** Present only when kind is `details`; total packed shards in the manifest. */
+    shardCount?: number;
+    /** Company contributions present in this detail shard. Used for authorization-relevant reads. */
+    companyIds?: string[];
+    path: string;
+    contentHash: string;
+    byteSize: number;
+    compressedByteSize?: number;
+    rowCount: number;
+}
+export interface PortfolioProjectionManifest {
+    schemaVersion: PortfolioProjectionSchemaVersion;
+    group: PortfolioProjectionGroup;
+    scopeCompanyId: string;
+    scopeType: PortfolioProjectionScopeType;
+    generationId: string;
+    generatedAt: string;
+    sourceObservedAt?: string;
+    hierarchyRootCompanyId: string;
+    hierarchyVersion?: string;
+    /** Digest of canonical account membership for bounded reconciliation without reading every account summary. */
+    sourceMembershipDigest?: string;
+    inputGenerationIds: string[];
+    inputDigest: string;
+    buildStatus: PortfolioProjectionBuildStatus;
+    artifacts: PortfolioProjectionArtifactDescriptor[];
+    coverage: PortfolioProjectionCoverage;
+    freshness: PortfolioProjectionFreshnessStatus;
+    warnings: string[];
+}
+export interface PortfolioBoundedSection<TItem> {
+    items: TItem[];
+    totalCount: number;
+    limit: number;
+    truncated: boolean;
+}
+export interface PortfolioRetainedSectionMetadata {
+    totalCount: number;
+    retainedCount: number;
+    limit: number;
+    truncated: boolean;
+}
+export interface PortfolioCloudAccountRow {
+    id: string;
+    companyId: string;
+    companyName: string;
+    cloudAccountId: string;
+    cloudAccountName: string;
+    provider: PortfolioCloudProvider;
+    providerAccountId?: string;
+    environment: PortfolioEnvironment;
+    subscriptionCount: number;
+    loadedSubscriptionCount?: number;
+    readySubscriptionCount: number;
+    notReadySubscriptionCount: number;
+    subscriptionCoverage: 'complete' | 'partial' | 'unavailable';
+    currency?: string;
+    currencies?: string[];
+    currencyStatus: PortfolioCurrencyStatus;
+    syncStatus: PortfolioOperationalStatus;
+    latestCompletedAt?: string;
+    sourceObservedAt?: string;
+    secureScore?: number;
+    advisorScore?: number;
+    recommendationCount: number;
+    mustDoCount: number;
+    budgetStatus?: 'healthy' | 'at-risk' | 'over-budget' | 'unavailable';
+    commitmentCoveragePercent?: number;
+    spend: PortfolioCurrencyAmount[];
+    savingsOpportunity: PortfolioCurrencyAmount[];
+    navigationCompanyId: string;
+}
+export interface PortfolioEstateCompanyContribution {
+    companyId: string;
+    companyName: string;
+    parentCompanyId?: string;
+    rootCompanyId: string;
+    accounts: PortfolioCloudAccountRow[];
+    /** Full account count and retained-detail metadata for compact hierarchy artifacts. */
+    accountRetention?: PortfolioRetainedSectionMetadata;
+    expectedCloudAccounts: number;
+    expectedSubscriptions: number;
+    /** Loaded totals remain available when detailed account rows are compacted. */
+    loadedCloudAccounts?: number;
+    loadedSubscriptions?: number;
+    readySubscriptions?: number;
+    failures: PortfolioProjectionFailure[];
+}
+export interface PortfolioEstateProjection {
+    metadata: PortfolioProjectionMetadata;
+    accounts: PortfolioCloudAccountRow[];
+    /** Full account count and retained-detail metadata for the top-level account list. */
+    accountRetention?: PortfolioRetainedSectionMetadata;
+    companyContributions: PortfolioEstateCompanyContribution[];
+}
+export interface PortfolioInsightEvidence {
+    source: string;
+    sourceId?: string;
+    observedAt?: string;
+    value?: number;
+    unit?: string;
+    currency?: string;
+}
+export interface PortfolioAttentionItem {
+    id: string;
+    companyId: string;
+    companyName: string;
+    cloudAccountId?: string;
+    subscriptionId?: string;
+    domain: PortfolioAttentionDomain;
+    severity: PortfolioAttentionSeverity;
+    title: string;
+    description: string;
+    dueAt?: string;
+    observedAt?: string;
+    navigationPath?: string;
+    evidence: PortfolioInsightEvidence[];
+}
+export interface PortfolioRecommendationSummary {
+    total: number;
+    mustDo: number;
+    highImpact: number;
+    affectedResources: number;
+    affectedSubscriptions: number;
+    savingsOpportunity: PortfolioCurrencyAmount[];
+}
+export interface PortfolioOperationalPostureSummary {
+    activeServiceHealthEvents: number;
+    unavailableResources: number;
+    degradedResources: number;
+    failedBackups: number;
+    staleBackups: number;
+    highRiskGovernanceFindings: number;
+    perimeterExposureFindings: number;
+    /** Optional only while the immediately preceding projection schema remains readable. */
+    coverage?: {
+        serviceHealth: PortfolioDataStatus;
+        resourceHealth: PortfolioDataStatus;
+        dataProtection: PortfolioDataStatus;
+        governance: PortfolioDataStatus;
+        perimeter: PortfolioDataStatus;
+    };
+}
+export interface PortfolioInsightsCompanyContribution {
+    companyId: string;
+    companyName: string;
+    status: PortfolioOperationalStatus;
+    recommendationSummary: PortfolioRecommendationSummary;
+    operationalPosture: PortfolioOperationalPostureSummary;
+    secureScoreWeightedTotal: number;
+    secureScoreWeight: number;
+    advisorScoreWeightedTotal: number;
+    advisorScoreWeight: number;
+    attention: PortfolioAttentionItem[];
+    risks: PortfolioAttentionItem[];
+    serviceOpportunities: PortfolioAttentionItem[];
+    /** Optional only for compatibility with the immediately preceding projection schema. */
+    attentionRetention?: PortfolioRetainedSectionMetadata;
+    riskRetention?: PortfolioRetainedSectionMetadata;
+    serviceOpportunityRetention?: PortfolioRetainedSectionMetadata;
+    attentionSummary?: PortfolioAttentionSummary;
+    riskSummary?: PortfolioAttentionSummary;
+    serviceOpportunitySummary?: PortfolioAttentionSummary;
+    failures: PortfolioProjectionFailure[];
+}
+export interface PortfolioInsightsProjection {
+    metadata: PortfolioProjectionMetadata;
+    recommendationSummary: PortfolioRecommendationSummary;
+    operationalPosture: PortfolioOperationalPostureSummary;
+    attention: PortfolioBoundedSection<PortfolioAttentionItem>;
+    risks: PortfolioBoundedSection<PortfolioAttentionItem>;
+    serviceOpportunities: PortfolioBoundedSection<PortfolioAttentionItem>;
+    companyContributions: PortfolioInsightsCompanyContribution[];
+}
+export interface PortfolioFinopsSummary {
+    spendActual: PortfolioCurrencyAmount[];
+    spendPreviousPeriod: PortfolioCurrencyAmount[];
+    savingsOpportunity: PortfolioCurrencyAmount[];
+    totalBudgets: number;
+    overBudget: number;
+    forecastOverBudget: number;
+    atRisk: number;
+    costAnomalies: number;
+    /** Optional only while the immediately preceding projection schema remains readable. */
+    coverage?: {
+        spend: PortfolioDataStatus;
+        budgets: PortfolioDataStatus;
+        costAnomalies: PortfolioDataStatus;
+        commitments: PortfolioDataStatus;
+    };
+}
+export interface PortfolioExpiryTotals {
+    total: number;
+    expired: number;
+    expiringWithin30Days: number;
+    expiringWithin90Days: number;
+}
+export interface PortfolioOperationsCompanyContribution {
+    companyId: string;
+    companyName: string;
+    finops: PortfolioFinopsSummary;
+    expiryTotals: PortfolioExpiryTotals;
+    budgets: PortfolioBudgetRow[];
+    expiries: PortfolioExpiryRow[];
+    attention: PortfolioAttentionItem[];
+    budgetRetention?: PortfolioRetainedSectionMetadata;
+    expiryRetention?: PortfolioRetainedSectionMetadata;
+    attentionRetention?: PortfolioRetainedSectionMetadata;
+    attentionSummary?: PortfolioAttentionSummary;
+    failures: PortfolioProjectionFailure[];
+}
+export interface PortfolioOperationsProjection {
+    metadata: PortfolioProjectionMetadata;
+    finops: PortfolioFinopsSummary;
+    expiryTotals: PortfolioExpiryTotals;
+    budgets: PortfolioBoundedSection<PortfolioBudgetRow>;
+    expiries: PortfolioBoundedSection<PortfolioExpiryRow>;
+    attention: PortfolioBoundedSection<PortfolioAttentionItem>;
+    companyContributions: PortfolioOperationsCompanyContribution[];
+}
+export interface PortfolioCloudAccountSummaryMetadata {
+    schemaVersion: typeof PORTFOLIO_CLOUD_ACCOUNT_SUMMARY_SCHEMA_VERSION;
+    companyId: string;
+    cloudAccountId: string;
+    provider: PortfolioCloudProvider;
+    providerAccountId?: string;
+    tenantRunId: string;
+    sourceRunStartedAt?: string;
+    generationId: string;
+    generatedAt: string;
+    sourceObservedAt?: string;
+    inputDigest: string;
+    inputSubscriptionIds: string[];
+    inputGenerationIds?: string[];
+    expectedSubscriptions: number;
+    loadedSubscriptions: number;
+    coverage: PortfolioProjectionBuildStatus;
+    freshness: PortfolioProjectionFreshnessStatus;
+    failures: PortfolioProjectionFailure[];
+    currencyCoverage: PortfolioCurrencyCoverage;
+}
+export interface PortfolioCloudAccountSummary {
+    metadata: PortfolioCloudAccountSummaryMetadata;
+    estate: PortfolioEstateCompanyContribution;
+    insights: PortfolioInsightsCompanyContribution;
+    operations: PortfolioOperationsCompanyContribution;
+}
+export interface PortfolioCloudAccountSummaryArtifactDescriptor {
+    kind: 'summary';
+    path: string;
+    contentHash: string;
+    byteSize: number;
+    compressedByteSize?: number;
+    rowCount: number;
+}
+export interface PortfolioCloudAccountSummaryManifest {
+    schemaVersion: typeof PORTFOLIO_CLOUD_ACCOUNT_SUMMARY_SCHEMA_VERSION;
+    group: 'cloud-account';
+    companyId: string;
+    cloudAccountId: string;
+    provider: PortfolioCloudProvider;
+    providerAccountId?: string;
+    tenantRunId: string;
+    sourceRunStartedAt?: string;
+    generationId: string;
+    generatedAt: string;
+    sourceObservedAt?: string;
+    inputDigest: string;
+    inputSubscriptionIds: string[];
+    inputGenerationIds?: string[];
+    buildStatus: PortfolioProjectionBuildStatus;
+    freshness: PortfolioProjectionFreshnessStatus;
+    failures: PortfolioProjectionFailure[];
+    artifact: PortfolioCloudAccountSummaryArtifactDescriptor;
+    warnings: string[];
+}
+export interface PortfolioDeliverySummary {
+    totalIssuedSows: number;
+    approvedSows: number;
+    unapprovedSows: number;
+    issuedThisMonth: number;
+    monthEndComplete: number;
+    monthEndIncomplete: number;
+    monthEndUnavailable: number;
+}
+export interface PortfolioDeliveryCompanyContribution {
+    companyId: string;
+    companyName: string;
+    summary: PortfolioDeliverySummary;
+    reports: PortfolioReportRow[];
+    sows: PortfolioSowRow[];
+    monthEnd: PortfolioMonthEndRow[];
+    attention: PortfolioAttentionItem[];
+    reportRetention?: PortfolioRetainedSectionMetadata;
+    sowRetention?: PortfolioRetainedSectionMetadata;
+    monthEndRetention?: PortfolioRetainedSectionMetadata;
+    attentionRetention?: PortfolioRetainedSectionMetadata;
+    reportSummary?: PortfolioReportSummary;
+    attentionSummary?: PortfolioAttentionSummary;
+    failures: PortfolioProjectionFailure[];
+}
+export interface PortfolioDeliveryProjection {
+    metadata: PortfolioProjectionMetadata;
+    summary: PortfolioDeliverySummary;
+    reports: PortfolioBoundedSection<PortfolioReportRow>;
+    sows: PortfolioBoundedSection<PortfolioSowRow>;
+    monthEnd: PortfolioBoundedSection<PortfolioMonthEndRow>;
+    attention: PortfolioBoundedSection<PortfolioAttentionItem>;
+    companyContributions: PortfolioDeliveryCompanyContribution[];
+}
+export interface PortfolioCloudProjectionDetailShard {
+    schemaVersion: PortfolioProjectionSchemaVersion;
+    group: 'cloud';
+    scopeCompanyId: string;
+    generationId: string;
+    shardIndex: number;
+    shardCount: number;
+    companyIds: string[];
+    estate: PortfolioEstateCompanyContribution[];
+    insights: PortfolioInsightsCompanyContribution[];
+    operations: PortfolioOperationsCompanyContribution[];
+}
+export interface PortfolioDeliveryProjectionDetailShard {
+    schemaVersion: PortfolioProjectionSchemaVersion;
+    group: 'delivery';
+    scopeCompanyId: string;
+    generationId: string;
+    shardIndex: number;
+    shardCount: number;
+    companyIds: string[];
+    delivery: PortfolioDeliveryCompanyContribution[];
+}
+export type PortfolioProjectionDetailShard = PortfolioCloudProjectionDetailShard | PortfolioDeliveryProjectionDetailShard;
+export interface PortfolioManagementSummary {
+    companiesHealthy: number;
+    companiesNeedingAttention: number;
+    companiesCritical: number;
+    companiesNotAssessed: number;
+    budgetsOver: number;
+    budgetsForecastOver: number;
+    risks: number;
+    /** Full-scope count of companies with at least one active recommendation risk. */
+    companiesWithRisks?: number;
+    /** Full-scope count of companies with at least one active Critical or High recommendation risk. */
+    companiesWithHighRisks?: number;
+    actionsDueWithin30Days: number;
+    reportingDue: number;
+}
+export interface PortfolioCompanyHealthRow {
+    companyId: string;
+    companyName: string;
+    status: PortfolioOperationalStatus;
+    coverage: PortfolioDataStatus;
+    primaryAttention?: PortfolioAttentionItem;
+}
+export interface PortfolioOverviewResponse {
+    scopeCompanyId: string;
+    generatedAt: string;
+    management: PortfolioManagementSummary;
+    /** Optional only while clients may receive the immediately preceding projection schema. */
+    companies?: PortfolioBoundedSection<PortfolioCompanyHealthRow>;
+    accounts: PortfolioBoundedSection<PortfolioCloudAccountRow>;
+    attention: PortfolioBoundedSection<PortfolioAttentionItem>;
+    risks: PortfolioBoundedSection<PortfolioAttentionItem>;
+    serviceOpportunities: PortfolioBoundedSection<PortfolioAttentionItem>;
+    recommendations: PortfolioRecommendationSummary;
+    operationalPosture: PortfolioOperationalPostureSummary;
+    finops: PortfolioFinopsSummary;
+    delivery: PortfolioDeliverySummary;
+    coverage: PortfolioDataCoverage;
+    sourceFreshness: Array<{
+        source: PortfolioProjectionPrimaryArtifactKind;
+        status: PortfolioProjectionFreshnessStatus;
+        generatedAt?: string;
+        sourceObservedAt?: string;
+    }>;
+    currencyCoverage: PortfolioCurrencyCoverage;
+}
+//# sourceMappingURL=portfolioProjections.d.ts.map