@spottoai/types-package 1.0.2-beta.427 → 1.0.2-beta.429

package/dist/common/utilizationStories.d.ts

@@ -0,0 +1,516 @@
+/**
+ * Utilization stories: shared contracts for per-resource utilization profiles, the compact
+ * `utilizationSignal` carried on portal resource rows, the per-subscription story artifacts
+ * (`azure-portal/subscriptions/{id}/stories/{storyKey}.json`), the bounded story samples embedded
+ * in the subscription report evidence pack, and the cloud-engine config schemas that drive them.
+ *
+ * Provider-neutral (`provider` on every profile); depends only on other `common/` modules.
+ * Spec: `Specs/reporting/utilization-stories-types-package.md` (parent: core `specs/reporting/utilization-stories.md`).
+ *
+ * Producer: cloud-engine (`UtilizationProfileBuilder`, `StoryAccumulator`). Consumers: api (story routes), ui
+ * (story pages, report sections), report evidence pack (`reporting.stories`).
+ *
+ * All contracts are additive: consumers must tolerate unknown fields, and every optional field may be absent on
+ * artifacts produced by older engine versions.
+ */
+import type { MetricStats } from './metricStats';
+import type { ReportBoundedRows } from './boundedRows';
+export type Provider = 'azure' | 'aws';
+export type MetricRole = 'primary' | 'secondary' | 'context';
+export type DimensionPolicy = 'average' | 'sum' | 'max' | 'split';
+export type MetricVisual = 'sparkline' | 'trend' | 'capacity-bar' | 'mix-bar' | 'event-strip';
+export type BilledOn = 'allocated' | 'used' | 'included';
+/** One daily-bucketed metric series over the evidence window, ready for a sparkline or trend visual. */
+export interface MetricSparkline {
+    /** Generic profile key: "cpu", "memory", "dtu", "ru", "capacity", "usedCapacity", "transactions", ... */
+    key: string;
+    /** Provider metric name behind the key. */
+    metricName: string;
+    role: MetricRole;
+    visual: MetricVisual;
+    unit: string;
+    /** Resolved at build time; null when no sensible axis maximum exists. */
+    axisMax: number | null;
+    axisMaxSource?: 'config' | 'capacity' | 'observed';
+    /** Capacity metrics only. */
+    billedOn?: BilledOn;
+    dimensions?: {
+        policy: DimensionPolicy;
+        name?: string;
+        value?: string;
+        seriesCount: number;
+    };
+    /** ISO date (UTC) of bucket 0. */
+    start: string;
+    bucket: 'P1D';
+    /** `windowDays` entries; null = no samples that day. */
+    avg: (number | null)[];
+    p95: (number | null)[];
+    max: (number | null)[];
+    stats: MetricStats;
+    sourcePoints: number;
+}
+export interface CapacityDescriptor {
+    sku: string | null;
+    tier: string | null;
+    units: number | null;
+    /** "vCPU" | "vCore" | "DTU" | "instances" | "RU/s" | "units" | "nodes" | ... */
+    unitName: string;
+    memoryGB?: number | null;
+    scaleMode: 'fixed' | 'autoscale' | 'serverless';
+    /** Display label, e.g. "4 vCPU · 32 GB RAM". */
+    label: string;
+}
+export type RunMode = 'stop-start' | 'auto-pause' | 'scale-to-zero' | 'always-on';
+export type SizingVerdict = 'oversized' | 'undersized' | 'busy' | 'rebalance' | 'mostly-off' | 'idle' | 'no-telemetry' | 'fits' | 'unknown';
+export type ScheduleFit = 'good' | 'fair' | 'low' | 'done' | 'insufficient-data' | 'not-applicable';
+export type ScheduleAction = 'stop' | 'pause' | 'scale';
+export type TelemetryStatus = 'collected' | 'partial' | 'no-series' | 'unavailable';
+/**
+ * How the running/stopped signal was derived. `metric-presence` alone cannot distinguish a stopped resource from a
+ * collection gap, so it must be corroborated (see `RunningProfile.corroboration`) before it may drive a schedule fit
+ * or a `mostly-off` verdict.
+ */
+export type RunningBasis = 'power-state' | 'billing-hours' | 'metric-presence';
+export interface RunningProfile {
+    signalMetric: string;
+    basis: RunningBasis;
+    /**
+     * Independent sources (never the basis itself) whose daily running hours agree with `daily` within the engine's
+     * tolerance. Empty when none. Guard rule: `scheduleFit` in good|fair|low and `verdict` = mostly-off require
+     * `basis !== 'metric-presence'` or a corroboration entry other than `metric-presence`, plus
+     * `evidenceWindow.telemetry === 'collected'`; otherwise the engine emits `insufficient-data` / `unknown`.
+     */
+    corroboration: RunningBasis[];
+    /** Share of each day's expected samples that carried a value (or, for power-state/billing bases, the running share). */
+    daily: (number | null)[];
+    share: number | null;
+    weekly?: {
+        timezone: string;
+        /** 7 x 24 */
+        running: (number | null)[][];
+        /** 7 x 24, mean of the primary metric while running. */
+        usage: (number | null)[][];
+        businessHours: {
+            runningShare: number | null;
+            usageMean: number | null;
+        };
+        offHours: {
+            runningShare: number | null;
+            usageMean: number | null;
+        };
+    };
+}
+export interface CommitmentCoverage {
+    coveragePercent: number | null;
+    benefitTypes: ('reservation' | 'savings-plan')[];
+    benefitNames: string[];
+    coveredCost: number | null;
+    uncoveredCost: number | null;
+    windowStart: string;
+    windowEnd: string;
+}
+export interface EvidenceWindow {
+    windowStart: string;
+    windowEnd: string;
+    days: number;
+    sampleCount: number;
+    telemetry: TelemetryStatus;
+    confidence: 'high' | 'medium' | 'low';
+}
+export interface VerdictReason {
+    rule: string;
+    values: Record<string, number | null>;
+}
+export interface UtilizationProfile {
+    provider: Provider;
+    /** "compute" | "database" | "storage" | "networking" | "integration" | "analytics" | ... */
+    family: string;
+    capacity: CapacityDescriptor;
+    runMode: RunMode;
+    metrics: MetricSparkline[];
+    running?: RunningProfile;
+    verdict: SizingVerdict;
+    verdictReasons: VerdictReason[];
+    /** Corroborating stable keys, e.g. "cpu-low", "advisor-rightsize". */
+    evidence: string[];
+    scheduleFit: ScheduleFit;
+    scheduleAction?: ScheduleAction;
+    coverage?: CommitmentCoverage;
+    /** Derived from billing config (pool, plan, scale set, cluster). */
+    ownerResourceId?: string;
+    evidenceWindow: EvidenceWindow;
+    /** `${resourceId}|${verdict}` */
+    fingerprint: string;
+}
+/** Compact form carried on portal `resources.json` rows and used by list views. */
+export interface UtilizationSignal {
+    verdict: SizingVerdict;
+    scheduleFit: ScheduleFit;
+    primary: {
+        key: string;
+        p95: number | null;
+        sparkline: (number | null)[];
+    };
+    secondary?: {
+        key: string;
+        p95: number | null;
+        sparkline: (number | null)[];
+    };
+    coverage?: Pick<CommitmentCoverage, 'coveragePercent' | 'benefitTypes'>;
+    betterSku?: SkuOptionSummary;
+    telemetry: TelemetryStatus;
+}
+export type SkuOptionKind = 'same-shape' | 'fits-usage' | 'trade-off' | 'cross-platform';
+export interface SkuOption {
+    kind: SkuOptionKind;
+    /** e.g. "Standard_E8as_v4" */
+    sku: string;
+    /** e.g. "E8as v4" */
+    label: string;
+    capacity?: {
+        units: number | null;
+        memoryGB?: number | null;
+    };
+    monthlyCost: number | null;
+    currency: string;
+    savingsPercent: number | null;
+    savingsMonthly: number | null;
+    /** Provider capability keys, e.g. "maxDataDiskCount". */
+    lostCapabilities: string[];
+    confidence?: 'high' | 'medium' | 'low';
+}
+export interface SkuOptionSummary {
+    kind: SkuOptionKind;
+    label: string;
+    savingsPercent: number | null;
+}
+export type CapabilityState = 'enabled' | 'disabled' | 'partial' | 'unknown' | 'not-applicable';
+export interface ProtectionCapability {
+    /**
+     * "backup" | "replication" | "placement" | "disk-redundancy" | "patching" | "snapshots" | "geo-replication" |
+     * "pitr-retention" | "long-term-retention" | "zone-redundancy" | "backup-storage-redundancy" | "redundancy" |
+     * "soft-delete" | "versioning" | "point-in-time-restore" | "immutability" | "multi-region" | "continuous-backup" |
+     * "purge-protection" | ...
+     */
+    key: string;
+    state: CapabilityState;
+    required: boolean;
+    label: string;
+    details?: Record<string, string | number | boolean | null>;
+    costIfEnabled?: number | null;
+    evidence: {
+        source: string;
+        observedAt?: string | null;
+    };
+}
+export interface ProtectionProfile {
+    provider: Provider;
+    capabilities: ProtectionCapability[];
+    missingRequired: string[];
+    slaPercent?: number | null;
+}
+export type StoryKey = 'oversized-resources' | 'right-sku' | 'schedule-candidates' | 'resilience-recovery' | 'hybrid-benefit' | 'commitments';
+export declare const STORY_KEYS: readonly StoryKey[];
+export type StoryCellKind = 'text' | 'number' | 'money' | 'percent' | 'mark' | 'dot' | 'sparkline' | 'dual' | 'capacity-bar' | 'mix-bar' | 'event-strip' | 'weekly-grid';
+export type SeriesRole = 'primary' | 'secondary';
+export type StatusTone = 'good' | 'warn' | 'bad' | 'neutral' | 'muted';
+export interface TextCell {
+    kind: 'text';
+    value: string | null;
+    /** Optional second line, e.g. "4 vCPU · 32 GB RAM" under a SKU. */
+    detail?: string | null;
+}
+export interface NumberCell {
+    kind: 'number';
+    value: number | null;
+    unit?: string;
+    decimals?: number;
+}
+export interface MoneyCell {
+    kind: 'money';
+    value: number | null;
+    currency: string;
+}
+export interface PercentCell {
+    kind: 'percent';
+    value: number | null;
+}
+/** One-word verdict / rating with an icon and tone; `state` is the stable enum value behind the label. */
+export interface MarkCell {
+    kind: 'mark';
+    state: string;
+    label: string;
+    tone: StatusTone;
+    icon?: string;
+    hint?: string;
+}
+/** A single indicator dot, e.g. "better SKU available". */
+export interface DotCell {
+    kind: 'dot';
+    present: boolean;
+    tone: StatusTone;
+    label?: string;
+    hint?: string;
+}
+export interface SparklineCell {
+    kind: 'sparkline';
+    role: SeriesRole;
+    /** Daily values for the window; null = no samples that day. */
+    values: (number | null)[];
+    axisMax: number | null;
+    unit: string;
+    p95: number | null;
+    label: string;
+}
+/** Primary and secondary series merged into one column at narrow layouts. */
+export interface DualCell {
+    kind: 'dual';
+    primary: SparklineCell;
+    secondary: SparklineCell | null;
+}
+export interface CapacityBarCell {
+    kind: 'capacity-bar';
+    used: number | null;
+    total: number | null;
+    unit: string;
+    label: string;
+}
+export interface MixBarCell {
+    kind: 'mix-bar';
+    parts: {
+        key: string;
+        label: string;
+        value: number;
+    }[];
+    unit: string;
+    total: number;
+}
+export interface EventStripCell {
+    kind: 'event-strip';
+    events: ('ok' | 'failed' | null)[];
+    /** ISO date (UTC) of event 0. */
+    start: string;
+    label?: string;
+}
+export interface WeeklyGridCell {
+    kind: 'weekly-grid';
+    timezone: string;
+    /** 7 x 24 running share. */
+    running: (number | null)[][];
+    businessHoursShare: number | null;
+    offHoursShare: number | null;
+}
+export type StoryCell = TextCell | NumberCell | MoneyCell | PercentCell | MarkCell | DotCell | SparklineCell | DualCell | CapacityBarCell | MixBarCell | EventStripCell | WeeklyGridCell;
+export interface StoryRowBase {
+    resourceId: string;
+    name: string;
+    type: string;
+    location: string;
+    subscriptionId: string;
+    tenantId: string;
+    companyId: string;
+    currency: string;
+    spend30d: number | null;
+    savingsMax: number | null;
+    ownerResourceId?: string;
+    fingerprint: string;
+    /** One entry per column key of the owning section; kinds match `StoryColumn.cell`. */
+    cells: Record<string, StoryCell>;
+}
+export interface OversizedResourceRow extends StoryRowBase {
+    profile: UtilizationProfile;
+    betterSku?: SkuOptionSummary;
+}
+export interface RightSkuRow extends StoryRowBase {
+    current: SkuOption;
+    options: SkuOption[];
+    verdict: 'modernise' | 'downsize' | 'consider' | 'keep';
+    usage: {
+        primaryP95: number | null;
+        secondaryP95: number | null;
+        telemetry: TelemetryStatus;
+    };
+}
+export interface ScheduleCandidateRow extends StoryRowBase {
+    /** `profile.running.weekly` is always present on schedule candidates. */
+    profile: UtilizationProfile;
+    action: ScheduleAction;
+}
+export interface ResilienceRow extends StoryRowBase {
+    protection: ProtectionProfile;
+    backupRuns?: ('ok' | 'failed' | null)[];
+    lastRecoveryPointAt?: string | null;
+    uptimeDays?: number | null;
+    activeHealthEvents?: number;
+}
+export interface HybridBenefitRow extends StoryRowBase {
+    productFamily: string;
+    serviceModel: string;
+    edition: string | null;
+    vCpuCount: number | null;
+    configurationStatus: string;
+    technicalEligibilityStatus: string;
+    coverageStatus: string;
+    entitlementStatus: string;
+    decision: {
+        status: string;
+        headline: string;
+        paybackMonths: number | null;
+        confidence: string;
+    };
+    reasonCodes: string[];
+    licenceObservedStableDays: number | null;
+}
+export interface CommitmentRow extends StoryRowBase {
+    coverage: CommitmentCoverage;
+    utilization?: {
+        primaryKey: string;
+        p95: number | null;
+    };
+}
+export interface StoryRowByKey {
+    'oversized-resources': OversizedResourceRow;
+    'right-sku': RightSkuRow;
+    'schedule-candidates': ScheduleCandidateRow;
+    'resilience-recovery': ResilienceRow;
+    'hybrid-benefit': HybridBenefitRow;
+    commitments: CommitmentRow;
+}
+export declare const STORY_LIMITS: {
+    readonly sectionRows: 1000;
+    readonly sampleRows: 50;
+    readonly windowDays: 30;
+    readonly weeklyGridDays: 7;
+    readonly weeklyGridHours: 24;
+    /** Story fingerprints retained per monthly history period (all stories together). */
+    readonly historyFingerprints: 2000;
+};
+/** Reuses ReportBoundedRows<T> (totalCount / rows / omittedCount) from reportEvidence.ts. */
+export interface StorySection<TRow> extends ReportBoundedRows<TRow> {
+    resourceType: string;
+    family: string;
+    columns: StoryColumn[];
+}
+/**
+ * Column definition for the generic story table. `cell` names the renderer; `priority` drives the responsive
+ * tiers (1 always shown ... 5 first to drop); `roleClass` drives layout width and the primary/secondary merge:
+ * a section that has a `sec` column also carries a `dual` column, shown instead of `prim` + `sec` at narrow tiers.
+ */
+export interface StoryColumn {
+    key: string;
+    label: string;
+    cell: StoryCellKind;
+    priority: 1 | 2 | 3 | 4 | 5;
+    roleClass?: 'res' | 'prim' | 'sec' | 'nums' | 'cap' | 'read' | 'cost' | 'save' | 'dual';
+    hint?: string;
+}
+export interface StorySummary {
+    counts: Record<string, number>;
+    spend: Record<string, number>;
+    currency: string;
+    note?: string;
+}
+export interface StoryArtifact<TRow = unknown> {
+    storyKey: StoryKey;
+    scope: {
+        companyId: string;
+        tenantId: string;
+        subscriptionId: string;
+        displayName: string;
+        currency: string;
+    };
+    generation: {
+        sourceRunId: string;
+        generatedAt: string;
+    };
+    window: {
+        start: string;
+        end: string;
+        days: number;
+        timezone: string;
+    };
+    summary: StorySummary;
+    sections: StorySection<TRow>[];
+}
+/**
+ * Compact identity of one published story row, retained per monthly history period so a later report can say
+ * whether a row was previously reported (`previouslyReported`) and how its saving moved. Selected across all six
+ * stories by `savingsMax` desc, `storyKey` asc, `resourceId` asc and bounded by `STORY_LIMITS.historyFingerprints`.
+ */
+export interface StoryFingerprint {
+    storyKey: StoryKey;
+    resourceId: string;
+    /** The row's `fingerprint` (`${resourceId}|${verdict}` and story-specific variants). */
+    fingerprint: string;
+    savingsMax: number | null;
+}
+export interface StorySample<TRow = unknown> {
+    summary: StorySummary;
+    /** At most STORY_LIMITS.sampleRows rows per section. */
+    sections: StorySection<TRow>[];
+}
+export type ReportingStories = Partial<Record<StoryKey, StorySample>>;
+export interface UtilizationProfileConfig {
+    version: 1;
+    defaults: {
+        windowDays: number;
+        bucket: 'P1D';
+        weeklyProfile: boolean;
+        verdictRules: Record<string, string>;
+    };
+    /** Keyed by lowercase resource type. */
+    profiles: Record<string, UtilizationProfileEntry>;
+}
+export interface UtilizationProfileEntry {
+    family: string;
+    producer?: 'parser' | 'strategy';
+    /** jsonata over the resource */
+    capacityLabel?: string;
+    runMode: RunMode;
+    /** metric key */
+    runningSignal?: string | null;
+    scheduleFit?: boolean | ScheduleAction;
+    variants?: {
+        when: string;
+        metrics: UtilizationMetricEntry[];
+        verdictRules?: Record<string, string>;
+    }[];
+    metrics?: UtilizationMetricEntry[];
+    verdictRules?: Record<string, string>;
+    skuAlternatives?: {
+        source: string;
+        capabilityKeys?: string[];
+    };
+}
+export interface UtilizationMetricEntry {
+    key: string;
+    metricName: string;
+    collection?: string;
+    role: MetricRole;
+    visual?: MetricVisual;
+    unit?: string;
+    axisMax?: number;
+    axisMaxExpression?: string;
+    billedOn?: BilledOn;
+    transform?: string;
+    requires?: string;
+    when?: string;
+    dimensions?: {
+        policy: DimensionPolicy;
+        name?: string;
+    };
+    priority?: 1 | 2 | 3 | 4 | 5;
+}
+export interface ResilienceProfileConfig {
+    version: 1;
+    profiles: Record<string, {
+        capabilities: {
+            key: string;
+            required: boolean;
+            source: string;
+            sla?: string;
+        }[];
+    }>;
+}
+//# sourceMappingURL=utilizationStories.d.ts.map

package/dist/common/utilizationStories.d.ts.map

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

package/dist/common/utilizationStories.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STORY_LIMITS = exports.STORY_KEYS = void 0;
+exports.STORY_KEYS = [
+    'oversized-resources',
+    'right-sku',
+    'schedule-candidates',
+    'resilience-recovery',
+    'hybrid-benefit',
+    'commitments',
+];
+exports.STORY_LIMITS = {
+    sectionRows: 1000,
+    sampleRows: 50,
+    windowDays: 30,
+    weeklyGridDays: 7,
+    weeklyGridHours: 24,
+    /** Story fingerprints retained per monthly history period (all stories together). */
+    historyFingerprints: 2000,
+};
+//# sourceMappingURL=utilizationStories.js.map

package/dist/common/utilizationStories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilizationStories.js","sourceRoot":"","sources":["../../src/common/utilizationStories.ts"],"names":[],"mappings":";;;AA6Ma,QAAA,UAAU,GAAwB;IAC7C,qBAAqB;IACrB,WAAW;IACX,qBAAqB;IACrB,qBAAqB;IACrB,gBAAgB;IAChB,aAAa;CACd,CAAC;AAyLW,QAAA,YAAY,GAAG;IAC1B,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,EAAE;IACd,UAAU,EAAE,EAAE;IACd,cAAc,EAAE,CAAC;IACjB,eAAe,EAAE,EAAE;IACnB,qFAAqF;IACrF,mBAAmB,EAAE,IAAI;CACjB,CAAC"}

package/dist/common/utilizationStoriesValidation.d.ts

@@ -0,0 +1,48 @@
+import type { ReportBoundedRows } from './boundedRows';
+import { type CapacityDescriptor, type CommitmentCoverage, type CommitmentRow, type EvidenceWindow, type HybridBenefitRow, type MetricSparkline, type OversizedResourceRow, type ProtectionCapability, type ProtectionProfile, type ReportingStories, type ResilienceProfileConfig, type ResilienceRow, type RightSkuRow, type RunningProfile, type ScheduleCandidateRow, type SkuOption, type SkuOptionSummary, type StoryArtifact, type StoryCell, type StoryColumn, type StoryFingerprint, type StoryKey, type StoryRowBase, type StorySample, type StorySection, type StorySummary, type UtilizationMetricEntry, type UtilizationProfile, type UtilizationProfileConfig, type UtilizationProfileEntry, type UtilizationSignal } from './utilizationStories';
+export declare const isMetricSparkline: (value: unknown, days?: number) => value is MetricSparkline;
+export declare const isCapacityDescriptor: (value: unknown) => value is CapacityDescriptor;
+export declare const isRunningProfile: (value: unknown, days?: number) => value is RunningProfile;
+/** A running signal derived from metric presence alone is not evidence of stopped time; it needs an independent source. */
+export declare const isCorroboratedRunningProfile: (value: RunningProfile) => boolean;
+export declare const isCommitmentCoverage: (value: unknown) => value is CommitmentCoverage;
+export declare const isEvidenceWindow: (value: unknown) => value is EvidenceWindow;
+export declare const isSkuOptionSummary: (value: unknown) => value is SkuOptionSummary;
+export declare const isSkuOption: (value: unknown) => value is SkuOption;
+export declare const isUtilizationProfile: (value: unknown, days?: number) => value is UtilizationProfile;
+export declare const isUtilizationSignal: (value: unknown) => value is UtilizationSignal;
+export declare const isProtectionCapability: (value: unknown) => value is ProtectionCapability;
+export declare const isProtectionProfile: (value: unknown) => value is ProtectionProfile;
+export declare const isStoryCell: (value: unknown) => value is StoryCell;
+export declare const isStoryColumn: (value: unknown) => value is StoryColumn;
+/** Every column has a cell on the row, and the cell's kind matches the column's renderer. */
+export declare const hasCellsForColumns: (row: StoryRowBase, columns: StoryColumn[]) => boolean;
+export declare const isOversizedResourceRow: (value: unknown, days?: number) => value is OversizedResourceRow;
+export declare const isRightSkuRow: (value: unknown) => value is RightSkuRow;
+/** Schedule candidates always carry a corroborated weekly running profile. */
+export declare const isScheduleCandidateRow: (value: unknown, days?: number) => value is ScheduleCandidateRow;
+export declare const isResilienceRow: (value: unknown) => value is ResilienceRow;
+export declare const isHybridBenefitRow: (value: unknown) => value is HybridBenefitRow;
+export declare const isCommitmentRow: (value: unknown) => value is CommitmentRow;
+/** Row guard for a story key; unknown keys reject every row. */
+export declare const storyRowGuard: (storyKey: string, days?: number) => ((row: unknown) => row is StoryRowBase);
+export declare const isStorySummary: (value: unknown) => value is StorySummary;
+export declare const isStorySection: (value: unknown, storyKey: string, limit: number, days?: number) => value is StorySection<StoryRowBase>;
+/** Every row of an artifact belongs to the artifact's scope; a row from another company, tenant or subscription is rejected. */
+export declare const isRowInScope: (row: StoryRowBase, scope: {
+    companyId: string;
+    tenantId: string;
+    subscriptionId: string;
+}) => boolean;
+export declare const isStoryArtifact: (value: unknown, storyKey?: StoryKey) => value is StoryArtifact<StoryRowBase>;
+/** Bounded sample embedded in the evidence pack; rows are validated for `storyKey`, window days are not known here. */
+export declare const isStorySample: (value: unknown, storyKey: StoryKey) => value is StorySample<StoryRowBase>;
+export declare const isStoryFingerprint: (value: unknown) => value is StoryFingerprint;
+/** Bounded, de-duplicated (storyKey + fingerprint) fingerprint rows for one history period. */
+export declare const isStoryFingerprintRows: (value: unknown) => value is ReportBoundedRows<StoryFingerprint>;
+export declare const isReportingStories: (value: unknown) => value is ReportingStories;
+export declare const isUtilizationMetricEntry: (value: unknown) => value is UtilizationMetricEntry;
+export declare const isUtilizationProfileEntry: (value: unknown) => value is UtilizationProfileEntry;
+export declare const isUtilizationProfileConfig: (value: unknown) => value is UtilizationProfileConfig;
+export declare const isResilienceProfileConfig: (value: unknown) => value is ResilienceProfileConfig;
+//# sourceMappingURL=utilizationStoriesValidation.d.ts.map

package/dist/common/utilizationStoriesValidation.d.ts.map

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