@empire-builder-kit/runtime 1.0.0-beta.9 → 1.0.0-rc.1

package/src/rds-global-ca-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rds-global-ca-bundle.js","sourceRoot":"","sources":["../../../../packages/runtime/src/rds-global-ca-bundle.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,yEAAyE;AACzE,uEAAuE;AACvE,yEAAyE;AACzE,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgrFnC,CAAC"}

package/src/reliability/burn.d.ts

@@ -0,0 +1,39 @@
+import type { SloObjective } from './model.js';
+export interface ReliabilityMetricIdentity {
+    dimensions: Readonly<Record<string, string>>;
+    metricName: string;
+    namespace: string;
+    stat: 'Sum';
+}
+export interface SloBurnMetricSet {
+    bad?: ReliabilityMetricIdentity;
+    good?: ReliabilityMetricIdentity;
+    syntheticGood?: ReliabilityMetricIdentity;
+    syntheticValid?: ReliabilityMetricIdentity;
+    valid: ReliabilityMetricIdentity;
+}
+export interface SloMetricDataQuery {
+    expression?: string;
+    id: string;
+    label?: string;
+    metric?: ReliabilityMetricIdentity & {
+        period: number;
+    };
+    returnData: boolean;
+}
+export interface SloBurnAlarmWindow {
+    budgetFraction: number;
+    burnThreshold: number;
+    metricQueries: readonly SloMetricDataQuery[];
+    periodSeconds: number;
+}
+export interface SloBurnAlarmPlan {
+    allowedBadFraction: number;
+    fast: SloBurnAlarmWindow;
+    lowTrafficMode: SloObjective['lowTraffic']['mode'];
+    minimumValidEvents: SloObjective['minimumValidEvents'];
+    objectiveId: string;
+    slow: SloBurnAlarmWindow;
+    windowSeconds: number;
+}
+export declare function createSloBurnAlarmPlan(objective: SloObjective, metrics: SloBurnMetricSet): SloBurnAlarmPlan;

package/src/reliability/burn.js

@@ -0,0 +1,102 @@
+const FAST_BUDGET_FRACTION = 0.02;
+const SLOW_BUDGET_FRACTION = 0.05;
+const SECONDS_PER_DAY = 24 * 60 * 60;
+function boundedPositive(value, field) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`[runtime/reliability] \`${field}\` must be a positive finite number.`);
+    }
+    return value;
+}
+function allowedBadFraction(objective) {
+    return Number((1 - objective.target).toPrecision(12));
+}
+function metricQuery(id, metric, period) {
+    return {
+        id,
+        metric: Object.assign(Object.assign({}, metric), { dimensions: Object.assign({}, metric.dimensions), period }),
+        returnData: false,
+    };
+}
+function burnExpression(objective, metrics, minimumValidEvents) {
+    const bad = metrics.bad ? 'b' : '(v-g)';
+    const budget = allowedBadFraction(objective);
+    const observed = `((${bad})/v)/${String(budget)}`;
+    if (objective.lowTraffic.mode === 'data-insufficient') {
+        return `IF(v>=${minimumValidEvents},${observed})`;
+    }
+    return (`IF(v>=${minimumValidEvents},${observed},` +
+        `IF(sv>=1,((sv-sg)/sv)/${String(budget)}))`);
+}
+function alarmWindow(objective, metrics, input) {
+    const periodSeconds = Math.max(60, Math.ceil((input.windowSeconds * input.budgetFraction) / input.burnThreshold / 60) * 60);
+    const metricQueries = [
+        metricQuery('v', metrics.valid, periodSeconds),
+        ...(metrics.bad ? [metricQuery('b', metrics.bad, periodSeconds)] : []),
+        ...(metrics.good ? [metricQuery('g', metrics.good, periodSeconds)] : []),
+        ...(metrics.syntheticValid
+            ? [metricQuery('sv', metrics.syntheticValid, periodSeconds)]
+            : []),
+        ...(metrics.syntheticGood
+            ? [metricQuery('sg', metrics.syntheticGood, periodSeconds)]
+            : []),
+        {
+            expression: burnExpression(objective, metrics, input.minimumValidEvents),
+            id: 'burn',
+            label: `${objective.id} ${input.label} error-budget burn`,
+            returnData: true,
+        },
+    ];
+    return {
+        budgetFraction: input.budgetFraction,
+        burnThreshold: input.burnThreshold,
+        metricQueries,
+        periodSeconds,
+    };
+}
+export function createSloBurnAlarmPlan(objective, metrics) {
+    if (objective.target <= 0 || objective.target >= 1) {
+        throw new Error('[runtime/reliability] Burn alarms require an objective target between zero and one.');
+    }
+    if (Boolean(metrics.bad) === Boolean(metrics.good)) {
+        throw new Error('[runtime/reliability] Burn metrics require exactly one good-event or bad-event series.');
+    }
+    if (objective.lowTraffic.mode === 'synthetic' &&
+        (!metrics.syntheticValid || !metrics.syntheticGood)) {
+        throw new Error('[runtime/reliability] Synthetic low-traffic mode requires exact synthetic valid and good series.');
+    }
+    if (objective.lowTraffic.mode === 'data-insufficient' &&
+        (metrics.syntheticValid || metrics.syntheticGood)) {
+        throw new Error('[runtime/reliability] Data-insufficient mode must not manufacture a synthetic series.');
+    }
+    boundedPositive(objective.burn.fast, 'objective.burn.fast');
+    boundedPositive(objective.burn.slow, 'objective.burn.slow');
+    for (const [name, minimum] of Object.entries(objective.minimumValidEvents)) {
+        if (!Number.isSafeInteger(minimum) || minimum < 1) {
+            throw new Error(`[runtime/reliability] \`objective.minimumValidEvents.${name}\` must be a positive safe integer.`);
+        }
+    }
+    const windowSeconds = boundedPositive(objective.window.days, 'objective.window.days') *
+        SECONDS_PER_DAY;
+    return {
+        allowedBadFraction: allowedBadFraction(objective),
+        fast: alarmWindow(objective, metrics, {
+            budgetFraction: FAST_BUDGET_FRACTION,
+            burnThreshold: objective.burn.fast,
+            label: 'fast',
+            minimumValidEvents: objective.minimumValidEvents.fastBurnWindow,
+            windowSeconds,
+        }),
+        lowTrafficMode: objective.lowTraffic.mode,
+        minimumValidEvents: Object.assign({}, objective.minimumValidEvents),
+        objectiveId: objective.id,
+        slow: alarmWindow(objective, metrics, {
+            budgetFraction: SLOW_BUDGET_FRACTION,
+            burnThreshold: objective.burn.slow,
+            label: 'slow',
+            minimumValidEvents: objective.minimumValidEvents.slowBurnWindow,
+            windowSeconds,
+        }),
+        windowSeconds,
+    };
+}
+//# sourceMappingURL=burn.js.map

package/src/reliability/burn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"burn.js","sourceRoot":"","sources":["../../../../../packages/runtime/src/reliability/burn.ts"],"names":[],"mappings":"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"}

package/src/reliability/contract.d.ts

@@ -0,0 +1,5 @@
+import type { AlarmDefinition } from '../observability.js';
+import { type AlarmRegistrationMetadata, type RegisteredAlarmDefinition, type SliceReliabilityContract } from './model.js';
+export declare function validateReliabilityContract(input: unknown): SliceReliabilityContract;
+export declare function validateAlarmRegistrationMetadata(metadata: AlarmRegistrationMetadata): AlarmRegistrationMetadata;
+export declare function registerAlarm(alarm: AlarmDefinition, metadata: AlarmRegistrationMetadata): RegisteredAlarmDefinition;

package/src/reliability/contract.js

@@ -0,0 +1,317 @@
+import { RELIABILITY_SCHEMA_VERSION, } from './model.js';
+const IDENTIFIER_PATTERN = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+const REFERENCE_PATTERN = /^(?:docs|operations|evidence|runbook|alarm|dashboard|synthetic):[A-Za-z0-9][A-Za-z0-9._/-]{0,254}$/;
+const ISO_TIMESTAMP_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/;
+const SLI_TYPES = new Set([
+    'availability',
+    'latency',
+    'freshness',
+    'durability',
+    'correctness',
+    'deadline',
+]);
+const SLO_TIERS = new Set(['critical', 'important', 'standard']);
+const WINDOW_KINDS = new Set(['rolling', 'calendar']);
+const PROVIDERS = new Set([
+    'direct-cloudwatch-metric-math',
+    'application-signals',
+]);
+const MISSING_DATA = new Set([
+    'breaching',
+    'notBreaching',
+    'ignore',
+    'missing',
+]);
+const ALARM_SEVERITIES = new Set(['low', 'medium', 'high', 'critical']);
+function record(input, field) {
+    if (!input || typeof input !== 'object' || Array.isArray(input)) {
+        throw new Error(`[runtime/reliability] \`${field}\` must be an object.`);
+    }
+    return input;
+}
+function exactKeys(input, allowed, field) {
+    const unexpected = Object.keys(input)
+        .filter((key) => !allowed.includes(key))
+        .sort();
+    if (unexpected.length > 0) {
+        throw new Error(`[runtime/reliability] \`${field}\` contains unsupported fields: ${unexpected.join(', ')}.`);
+    }
+}
+function string(input, field, options = {}) {
+    var _a;
+    if (typeof input !== 'string') {
+        throw new Error(`[runtime/reliability] \`${field}\` must be a string.`);
+    }
+    const normalized = input.trim();
+    if (normalized.length === 0 ||
+        normalized.length > ((_a = options.max) !== null && _a !== void 0 ? _a : 512) ||
+        [...normalized].some((character) => {
+            const code = character.charCodeAt(0);
+            return code <= 31 || code === 127;
+        }) ||
+        (options.pattern && !options.pattern.test(normalized))) {
+        throw new Error(`[runtime/reliability] \`${field}\` is empty, unsafe, or outside its bounded format.`);
+    }
+    return normalized;
+}
+function identifier(input, field) {
+    return string(input, field, {
+        max: 128,
+        pattern: IDENTIFIER_PATTERN,
+    });
+}
+function reference(input, field) {
+    return string(input, field, {
+        max: 256,
+        pattern: REFERENCE_PATTERN,
+    });
+}
+function timestamp(input, field) {
+    const value = string(input, field, {
+        max: 32,
+        pattern: ISO_TIMESTAMP_PATTERN,
+    });
+    if (!Number.isFinite(Date.parse(value))) {
+        throw new Error(`[runtime/reliability] \`${field}\` must be a valid UTC timestamp.`);
+    }
+    return value;
+}
+function finiteNumber(input, field, options = {}) {
+    if (typeof input !== 'number' ||
+        !Number.isFinite(input) ||
+        (options.integer && !Number.isSafeInteger(input)) ||
+        (options.min !== undefined && input < options.min) ||
+        (options.max !== undefined && input > options.max)) {
+        throw new Error(`[runtime/reliability] \`${field}\` must be a finite${options.integer ? ' integer' : ''} within its supported range.`);
+    }
+    return input;
+}
+function stringArray(input, field, parser = string) {
+    if (!Array.isArray(input)) {
+        throw new Error(`[runtime/reliability] \`${field}\` must be an array.`);
+    }
+    const values = input.map((value, index) => parser(value, `${field}[${index}]`));
+    if (new Set(values).size !== values.length) {
+        throw new Error(`[runtime/reliability] \`${field}\` must not contain duplicates.`);
+    }
+    return values;
+}
+function parseObjective(input, index) {
+    const field = `objectives[${index}]`;
+    const value = record(input, field);
+    exactKeys(value, [
+        'allowedExclusionPolicyRef',
+        'burn',
+        'effectiveAt',
+        'feature',
+        'id',
+        'indicator',
+        'journey',
+        'lowTraffic',
+        'minimumValidEvents',
+        'owner',
+        'references',
+        'target',
+        'tier',
+        'window',
+    ], field);
+    const indicator = record(value.indicator, `${field}.indicator`);
+    exactKeys(indicator, [
+        'goodEventDefinition',
+        'metricRef',
+        'threshold',
+        'type',
+        'unit',
+        'validEventDefinition',
+    ], `${field}.indicator`);
+    if (!SLI_TYPES.has(indicator.type)) {
+        throw new Error(`[runtime/reliability] \`${field}.indicator.type\` is unsupported.`);
+    }
+    const burn = record(value.burn, `${field}.burn`);
+    exactKeys(burn, ['fast', 'slow', 'warning'], `${field}.burn`);
+    const warning = finiteNumber(burn.warning, `${field}.burn.warning`, {
+        min: 0,
+    });
+    const slow = finiteNumber(burn.slow, `${field}.burn.slow`, { min: 0 });
+    const fast = finiteNumber(burn.fast, `${field}.burn.fast`, { min: 0 });
+    if (!(warning < slow && slow < fast)) {
+        throw new Error(`[runtime/reliability] \`${field}.burn\` must satisfy warning < slow < fast.`);
+    }
+    const lowTraffic = record(value.lowTraffic, `${field}.lowTraffic`);
+    exactKeys(lowTraffic, ['mode', 'syntheticRef'], `${field}.lowTraffic`);
+    if (lowTraffic.mode !== 'data-insufficient' &&
+        lowTraffic.mode !== 'synthetic') {
+        throw new Error(`[runtime/reliability] \`${field}.lowTraffic.mode\` is unsupported.`);
+    }
+    const syntheticRef = lowTraffic.syntheticRef === undefined
+        ? undefined
+        : reference(lowTraffic.syntheticRef, `${field}.lowTraffic.syntheticRef`);
+    if ((lowTraffic.mode === 'synthetic' && !syntheticRef) ||
+        (lowTraffic.mode === 'data-insufficient' && syntheticRef)) {
+        throw new Error(`[runtime/reliability] \`${field}.lowTraffic\` must bind a synthetic only in synthetic mode.`);
+    }
+    const references = record(value.references, `${field}.references`);
+    exactKeys(references, ['alarmIds', 'dashboardRef', 'runbookRef', 'syntheticRef'], `${field}.references`);
+    const referenceSynthetic = references.syntheticRef === undefined
+        ? undefined
+        : reference(references.syntheticRef, `${field}.references.syntheticRef`);
+    if (referenceSynthetic !== syntheticRef) {
+        throw new Error(`[runtime/reliability] \`${field}\` must use one exact synthetic reference.`);
+    }
+    const window = record(value.window, `${field}.window`);
+    exactKeys(window, ['days', 'kind'], `${field}.window`);
+    if (!WINDOW_KINDS.has(window.kind)) {
+        throw new Error(`[runtime/reliability] \`${field}.window.kind\` is unsupported.`);
+    }
+    if (!SLO_TIERS.has(value.tier)) {
+        throw new Error(`[runtime/reliability] \`${field}.tier\` is unsupported.`);
+    }
+    const minimumValidEvents = record(value.minimumValidEvents, `${field}.minimumValidEvents`);
+    exactKeys(minimumValidEvents, ['diagnosticSample', 'fastBurnWindow', 'objectiveWindow', 'slowBurnWindow'], `${field}.minimumValidEvents`);
+    const parsedMinimumValidEvents = {
+        diagnosticSample: finiteNumber(minimumValidEvents['diagnosticSample'], `${field}.minimumValidEvents.diagnosticSample`, { integer: true, min: 1, max: 1000000000 }),
+        fastBurnWindow: finiteNumber(minimumValidEvents['fastBurnWindow'], `${field}.minimumValidEvents.fastBurnWindow`, { integer: true, min: 1, max: 1000000000 }),
+        objectiveWindow: finiteNumber(minimumValidEvents['objectiveWindow'], `${field}.minimumValidEvents.objectiveWindow`, { integer: true, min: 1, max: 1000000000 }),
+        slowBurnWindow: finiteNumber(minimumValidEvents['slowBurnWindow'], `${field}.minimumValidEvents.slowBurnWindow`, { integer: true, min: 1, max: 1000000000 }),
+    };
+    return {
+        allowedExclusionPolicyRef: reference(value.allowedExclusionPolicyRef, `${field}.allowedExclusionPolicyRef`),
+        burn: { fast, slow, warning },
+        effectiveAt: timestamp(value.effectiveAt, `${field}.effectiveAt`),
+        feature: identifier(value.feature, `${field}.feature`),
+        id: identifier(value.id, `${field}.id`),
+        indicator: Object.assign(Object.assign(Object.assign(Object.assign({ goodEventDefinition: string(indicator.goodEventDefinition, `${field}.indicator.goodEventDefinition`), metricRef: reference(indicator.metricRef, `${field}.indicator.metricRef`) }, (indicator.threshold === undefined
+            ? {}
+            : {
+                threshold: finiteNumber(indicator.threshold, `${field}.indicator.threshold`),
+            })), { type: indicator.type }), (indicator.unit === undefined
+            ? {}
+            : {
+                unit: string(indicator.unit, `${field}.indicator.unit`, {
+                    max: 64,
+                }),
+            })), { validEventDefinition: string(indicator.validEventDefinition, `${field}.indicator.validEventDefinition`) }),
+        journey: identifier(value.journey, `${field}.journey`),
+        lowTraffic: Object.assign({ mode: lowTraffic.mode }, (syntheticRef ? { syntheticRef } : {})),
+        minimumValidEvents: parsedMinimumValidEvents,
+        owner: identifier(value.owner, `${field}.owner`),
+        references: Object.assign({ alarmIds: stringArray(references.alarmIds, `${field}.references.alarmIds`, identifier), dashboardRef: reference(references.dashboardRef, `${field}.references.dashboardRef`), runbookRef: reference(references.runbookRef, `${field}.references.runbookRef`) }, (referenceSynthetic ? { syntheticRef: referenceSynthetic } : {})),
+        target: finiteNumber(value.target, `${field}.target`, {
+            min: Number.EPSILON,
+            max: 1,
+        }),
+        tier: value.tier,
+        window: {
+            days: finiteNumber(window.days, `${field}.window.days`, {
+                integer: true,
+                min: 1,
+                max: 90,
+            }),
+            kind: window.kind,
+        },
+    };
+}
+export function validateReliabilityContract(input) {
+    const value = record(input, 'contract');
+    exactKeys(value, [
+        'escalationRouteKey',
+        'objectives',
+        'owner',
+        'providerDecision',
+        'schemaVersion',
+        'slice',
+    ], 'contract');
+    if (value.schemaVersion !== RELIABILITY_SCHEMA_VERSION) {
+        throw new Error(`[runtime/reliability] schemaVersion must be ${RELIABILITY_SCHEMA_VERSION}.`);
+    }
+    if (!Array.isArray(value.objectives) || value.objectives.length === 0) {
+        throw new Error('[runtime/reliability] At least one SLO objective is required.');
+    }
+    const objectives = value.objectives.map(parseObjective);
+    if (new Set(objectives.map(({ id }) => id)).size !== objectives.length) {
+        throw new Error('[runtime/reliability] SLO objective IDs must be unique.');
+    }
+    const provider = record(value.providerDecision, 'providerDecision');
+    exactKeys(provider, [
+        'applicationSignalsCoverage',
+        'basis',
+        'cost',
+        'directMetricMathCoverage',
+        'reviewedAt',
+        'selected',
+    ], 'providerDecision');
+    if (!PROVIDERS.has(provider.selected)) {
+        throw new Error('[runtime/reliability] providerDecision.selected is unsupported.');
+    }
+    const cost = record(provider.cost, 'providerDecision.cost');
+    exactKeys(cost, ['currency', 'monthly', 'provenance'], 'providerDecision.cost');
+    if (cost.currency !== 'USD' || cost.provenance !== 'estimate') {
+        throw new Error('[runtime/reliability] Provider cost must be a USD estimate.');
+    }
+    return {
+        escalationRouteKey: identifier(value.escalationRouteKey, 'escalationRouteKey'),
+        objectives,
+        owner: identifier(value.owner, 'owner'),
+        providerDecision: {
+            applicationSignalsCoverage: stringArray(provider.applicationSignalsCoverage, 'providerDecision.applicationSignalsCoverage'),
+            basis: string(provider.basis, 'providerDecision.basis'),
+            cost: {
+                currency: 'USD',
+                monthly: finiteNumber(cost.monthly, 'providerDecision.cost.monthly', {
+                    min: 0,
+                }),
+                provenance: 'estimate',
+            },
+            directMetricMathCoverage: stringArray(provider.directMetricMathCoverage, 'providerDecision.directMetricMathCoverage'),
+            reviewedAt: timestamp(provider.reviewedAt, 'providerDecision.reviewedAt'),
+            selected: provider.selected,
+        },
+        schemaVersion: RELIABILITY_SCHEMA_VERSION,
+        slice: identifier(value.slice, 'slice'),
+    };
+}
+export function validateAlarmRegistrationMetadata(metadata) {
+    const value = record(metadata, 'alarm registration');
+    exactKeys(value, [
+        'businessSymptom',
+        'condition',
+        'dependencyAlarmIds',
+        'escalationRouteKey',
+        'expectedFalseNegativeRisk',
+        'expectedFalsePositiveRisk',
+        'id',
+        'missingData',
+        'owner',
+        'runbookRef',
+        'severity',
+        'testRef',
+    ], 'alarm registration');
+    if (!MISSING_DATA.has(metadata.missingData)) {
+        throw new Error('[runtime/reliability] Alarm missing-data behavior is unsupported.');
+    }
+    if (!ALARM_SEVERITIES.has(metadata.severity)) {
+        throw new Error('[runtime/reliability] Alarm registration severity is unsupported.');
+    }
+    return {
+        businessSymptom: string(metadata.businessSymptom, 'alarm registration.businessSymptom'),
+        condition: string(metadata.condition, 'alarm registration.condition'),
+        dependencyAlarmIds: stringArray(metadata.dependencyAlarmIds, 'alarm registration.dependencyAlarmIds', identifier),
+        escalationRouteKey: identifier(metadata.escalationRouteKey, 'alarm registration.escalationRouteKey'),
+        expectedFalseNegativeRisk: string(metadata.expectedFalseNegativeRisk, 'alarm registration.expectedFalseNegativeRisk'),
+        expectedFalsePositiveRisk: string(metadata.expectedFalsePositiveRisk, 'alarm registration.expectedFalsePositiveRisk'),
+        id: identifier(metadata.id, 'alarm registration.id'),
+        missingData: metadata.missingData,
+        owner: identifier(metadata.owner, 'alarm registration.owner'),
+        runbookRef: reference(metadata.runbookRef, 'alarm registration.runbookRef'),
+        severity: metadata.severity,
+        testRef: reference(metadata.testRef, 'alarm registration.testRef'),
+    };
+}
+export function registerAlarm(alarm, metadata) {
+    const registration = validateAlarmRegistrationMetadata(metadata);
+    if (registration.severity !== alarm.severity) {
+        throw new Error('[runtime/reliability] Alarm definition and registration severity must match.');
+    }
+    return Object.assign(Object.assign({}, alarm), { registration });
+}
+//# sourceMappingURL=contract.js.map

package/src/reliability/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../../../packages/runtime/src/reliability/contract.ts"],"names":[],"mappings":"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"}

package/src/reliability/incident.d.ts

@@ -0,0 +1,16 @@
+import { type ApprovalDigestInput } from '../authorization/approval.js';
+import { type DiagnosticPlan, type DiagnosticRequest, type IncidentRecord, type IncidentSeverity, type RemediationPlan, type RemediationRequest } from './model.js';
+export declare const RELIABILITY_APPROVAL_POLICY_VERSION: "reliability-v1";
+export declare function diagnosticApprovalDigestInput(approval: Omit<NonNullable<DiagnosticRequest['approval']>, 'authorization'>): ApprovalDigestInput<'reliability-diagnostic'>;
+export declare function remediationApprovalDigestInput(input: {
+    incidentRef: string;
+    plan: Pick<RemediationPlan, 'action' | 'remediationPlanDigest' | 'target'>;
+}): ApprovalDigestInput<'reliability-remediation'>;
+export declare function candidateIncidentSeverity(alarmSeverity: 'low' | 'medium' | 'high' | 'critical'): Exclude<IncidentSeverity, 'SEV-1'>;
+export declare function validateIncidentRecord(input: IncidentRecord): IncidentRecord;
+export declare function authorizeDiagnostic(request: DiagnosticRequest, options?: {
+    now?: () => Date;
+}): DiagnosticPlan;
+export declare function planRemediation(request: RemediationRequest, options?: {
+    now?: () => Date;
+}): RemediationPlan;