@empire-builder-kit/nx 1.0.0-beta.9 → 1.0.0-rc.2

package/src/performance/unit-cost.js

@@ -0,0 +1,364 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUnitCostObservation = createUnitCostObservation;
+exports.evaluateUnitCostTrends = evaluateUnitCostTrends;
+exports.unitCostLiveEvidenceStatus = unitCostLiveEvidenceStatus;
+const deterministic_order_js_1 = require("../deterministic-order.js");
+const safe_reference_1 = require("@empire-builder-kit/runtime/safe-reference");
+const model_js_1 = require("./model.js");
+const cost_collection_js_1 = require("./cost-collection.js");
+function invalid(pointer, message) {
+    return new model_js_1.PerformanceContractError('performance-evidence-invalid', pointer, message);
+}
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function onlyKeys(value, keys, pointer) {
+    if (!record(value))
+        throw invalid(pointer, 'must be an object');
+    for (const key of Object.keys(value)) {
+        if (!keys.includes(key)) {
+            throw invalid(`${pointer}/${key}`, 'is not part of the v1 contract');
+        }
+    }
+}
+function reference(value, pointer) {
+    if (!(0, safe_reference_1.isBoundedSafeReference)(value, 'performance-evidence')) {
+        throw invalid(pointer, 'must be one bounded non-sensitive reference');
+    }
+    return value;
+}
+function release(value, pointer) {
+    onlyKeys(value, ['candidateDigest', 'releaseId', 'releaseMaterialDigest', 'sourceCommit'], pointer);
+    (0, model_js_1.assertDigest)(value.candidateDigest, `${pointer}/candidateDigest`);
+    (0, model_js_1.assertDigest)(value.releaseMaterialDigest, `${pointer}/releaseMaterialDigest`);
+    (0, model_js_1.assertFullCommit)(value.sourceCommit, `${pointer}/sourceCommit`);
+    reference(value.releaseId, `${pointer}/releaseId`);
+    return value;
+}
+function releasesEqual(left, right) {
+    return (left.candidateDigest === right.candidateDigest &&
+        left.releaseId === right.releaseId &&
+        left.releaseMaterialDigest === right.releaseMaterialDigest &&
+        left.sourceCommit === right.sourceCommit);
+}
+function capability(value, pointer) {
+    onlyKeys(value, ['anomalyIncreasePercent', 'id', 'ownerRouteRef', 'unit'], pointer);
+    reference(value.id, `${pointer}/id`);
+    reference(value.ownerRouteRef, `${pointer}/ownerRouteRef`);
+    reference(value.unit, `${pointer}/unit`);
+    if (typeof value.anomalyIncreasePercent !== 'number' ||
+        !Number.isFinite(value.anomalyIncreasePercent) ||
+        value.anomalyIncreasePercent <= 0 ||
+        value.anomalyIncreasePercent > 1_000) {
+        throw invalid(`${pointer}/anomalyIncreasePercent`, 'must be a finite percentage from greater than zero through 1000');
+    }
+    return value;
+}
+function unsignedObservation(input) {
+    onlyKeys(input, [
+        'aggregate',
+        'billing',
+        'capabilityId',
+        'environment',
+        'kind',
+        'release',
+        'schemaVersion',
+        'unit',
+    ], 'observation');
+    onlyKeys(input.aggregate, ['aggregateId', 'count', 'evidenceDigest'], 'observation/aggregate');
+    onlyKeys(input.billing, [
+        'allocatedCostUsd',
+        'allocationId',
+        'evidenceDigest',
+        'period',
+        'provider',
+    ], 'observation/billing');
+    onlyKeys(input.billing.period, ['end', 'start'], 'observation/billing/period');
+    onlyKeys(input.environment, ['accountFingerprint', 'region', 'slice', 'stage', 'workspace'], 'observation/environment');
+    if (input.kind !== 'ebk-unit-cost-observation' || input.schemaVersion !== 1) {
+        throw invalid('observation', 'must identify the v1 unit-cost observation');
+    }
+    reference(input.capabilityId, 'observation/capabilityId');
+    reference(input.unit, 'observation/unit');
+    reference(input.aggregate.aggregateId, 'observation/aggregate/aggregateId');
+    reference(input.billing.allocationId, 'observation/billing/allocationId');
+    for (const key of [
+        'accountFingerprint',
+        'region',
+        'slice',
+        'stage',
+        'workspace',
+    ]) {
+        reference(input.environment[key], `observation/environment/${key}`);
+    }
+    if (!Number.isSafeInteger(input.aggregate.count) ||
+        input.aggregate.count <= 0) {
+        throw invalid('observation/aggregate/count', 'must be a positive aggregate count');
+    }
+    if (typeof input.billing.allocatedCostUsd !== 'number' ||
+        !Number.isFinite(input.billing.allocatedCostUsd) ||
+        input.billing.allocatedCostUsd <= 0) {
+        throw invalid('observation/billing/allocatedCostUsd', 'must be a finite positive allocated cost');
+    }
+    (0, model_js_1.assertDigest)(input.aggregate.evidenceDigest, 'observation/aggregate/evidenceDigest');
+    (0, model_js_1.assertDigest)(input.billing.evidenceDigest, 'observation/billing/evidenceDigest');
+    if (input.billing.provider !== 'aws-billing-actual' ||
+        !(0, model_js_1.isIsoInstant)(input.billing.period.start) ||
+        !(0, model_js_1.isIsoInstant)(input.billing.period.end) ||
+        Date.parse(input.billing.period.end) <=
+            Date.parse(input.billing.period.start)) {
+        throw invalid('observation/billing', 'must identify one closed AWS billing-actual period');
+    }
+    release(input.release, 'observation/release');
+    return input;
+}
+function createUnitCostObservation(input) {
+    const unsigned = unsignedObservation(input);
+    return { ...unsigned, materialDigest: (0, model_js_1.performanceDigest)(unsigned) };
+}
+function validateObservation(value, pointer) {
+    onlyKeys(value, [
+        'aggregate',
+        'billing',
+        'capabilityId',
+        'environment',
+        'kind',
+        'materialDigest',
+        'release',
+        'schemaVersion',
+        'unit',
+    ], pointer);
+    const { materialDigest, ...candidate } = value;
+    (0, model_js_1.assertDigest)(materialDigest, `${pointer}/materialDigest`);
+    const expected = createUnitCostObservation(candidate);
+    if (expected.materialDigest !== materialDigest) {
+        throw invalid(pointer, 'material digest does not match observation bytes');
+    }
+    return expected;
+}
+function assertObservationCohort(observations, pointer) {
+    const anchor = observations[0];
+    if (!anchor || observations.length !== 2) {
+        throw invalid(pointer, 'must contain exactly two capability observations');
+    }
+    for (const observation of observations.slice(1)) {
+        if ((0, model_js_1.performanceDigest)(observation.environment) !==
+            (0, model_js_1.performanceDigest)(anchor.environment) ||
+            (0, model_js_1.performanceDigest)(observation.billing.period) !==
+                (0, model_js_1.performanceDigest)(anchor.billing.period) ||
+            observation.billing.evidenceDigest !== anchor.billing.evidenceDigest ||
+            observation.billing.provider !== anchor.billing.provider ||
+            !releasesEqual(observation.release, anchor.release)) {
+            throw invalid(pointer, 'must share one exact environment, billing period, billing observation, and release');
+        }
+    }
+    return anchor;
+}
+function assertObservationMatchesBillingEvidence(observation, evidence, pointer) {
+    if ((0, model_js_1.performanceDigest)(observation.environment) !==
+        (0, model_js_1.performanceDigest)(evidence.environment) ||
+        (0, model_js_1.performanceDigest)(observation.billing.period) !==
+            (0, model_js_1.performanceDigest)(evidence.period) ||
+        !releasesEqual(observation.release, evidence.release) ||
+        observation.billing.evidenceDigest !== evidence.materialDigest) {
+        throw invalid(pointer, 'must bind the exact validated billing environment, period, release, and evidence');
+    }
+    const allocationMatches = evidence.allocations.filter(({ allocationId }) => allocationId === observation.billing.allocationId);
+    const allocation = allocationMatches[0];
+    if (allocationMatches.length !== 1 ||
+        !allocation ||
+        allocation.capabilityId !== observation.capabilityId ||
+        allocation.allocatedCostUsd !== observation.billing.allocatedCostUsd) {
+        throw invalid(`${pointer}/billing`, 'must reference one exact capability allocation and allocated amount from billing evidence');
+    }
+    const aggregateMatches = evidence.aggregateCounts.filter(({ aggregateId }) => aggregateId === observation.aggregate.aggregateId);
+    const aggregate = aggregateMatches[0];
+    if (aggregateMatches.length !== 1 ||
+        !aggregate ||
+        aggregate.capabilityId !== observation.capabilityId ||
+        aggregate.count !== observation.aggregate.count ||
+        aggregate.evidenceDigest !== observation.aggregate.evidenceDigest) {
+        throw invalid(`${pointer}/aggregate`, 'must reference one exact capability count from aggregate evidence');
+    }
+}
+function assertEvidenceCoversCohort(evidence, observations, pointer) {
+    const observedCapabilities = observations
+        .map(({ capabilityId }) => capabilityId)
+        .sort();
+    const allocatedCapabilities = evidence.allocations
+        .map(({ capabilityId }) => capabilityId)
+        .sort();
+    const aggregateCapabilities = evidence.aggregateCounts
+        .map(({ capabilityId }) => capabilityId)
+        .sort();
+    if (JSON.stringify(observedCapabilities) !==
+        JSON.stringify(allocatedCapabilities) ||
+        JSON.stringify(observedCapabilities) !==
+            JSON.stringify(aggregateCapabilities)) {
+        throw invalid(pointer, 'billing allocations, aggregate counts, and observations must cover the same exact capabilities');
+    }
+    for (const [index, observation] of observations.entries()) {
+        assertObservationMatchesBillingEvidence(observation, evidence, `${pointer}/${index}`);
+    }
+}
+/**
+ * Joins delayed AWS billing actuals to aggregate business counts. It consumes
+ * two independently produced observation periods for exactly two useful
+ * capabilities; it never estimates or manufactures either input.
+ */
+function evaluateUnitCostTrends(input) {
+    const policy = (0, model_js_1.validatePerformancePolicy)(input.policy);
+    if (!(0, model_js_1.isIsoInstant)(input.evaluatedAt)) {
+        throw invalid('evaluatedAt', 'must be an ISO instant');
+    }
+    (0, model_js_1.assertDigest)(input.expectedBaselineBillingEvidenceDigest, 'expectedBaselineBillingEvidenceDigest');
+    (0, model_js_1.assertDigest)(input.expectedCurrentBillingEvidenceDigest, 'expectedCurrentBillingEvidenceDigest');
+    release(input.expectedBaselineRelease, 'expectedBaselineRelease');
+    release(input.expectedCurrentRelease, 'expectedCurrentRelease');
+    if (!Array.isArray(input.capabilities) ||
+        input.capabilities.length !== 2 ||
+        new Set(input.capabilities.map(({ id }) => id)).size !== 2) {
+        throw invalid('capabilities', 'must define exactly two distinct useful unit-cost capabilities');
+    }
+    const capabilities = input.capabilities.map((value, index) => capability(value, `capabilities/${index}`));
+    const policyRefs = [...policy.cost.unitCostRefs].sort();
+    const capabilityRefs = capabilities.map(({ id }) => id).sort();
+    if (JSON.stringify(policyRefs) !== JSON.stringify(capabilityRefs)) {
+        throw invalid('capabilities', 'must match the exact two unit-cost references in the performance policy');
+    }
+    if (!Array.isArray(input.current) || !Array.isArray(input.baseline)) {
+        throw invalid('observations', 'current and baseline must be arrays');
+    }
+    const current = input.current.map((value, index) => validateObservation(value, `current/${index}`));
+    const baseline = input.baseline.map((value, index) => validateObservation(value, `baseline/${index}`));
+    const currentBillingEvidence = (0, cost_collection_js_1.validateAwsBillingActualEvidence)(input.currentBillingEvidence);
+    const baselineBillingEvidence = (0, cost_collection_js_1.validateAwsBillingActualEvidence)(input.baselineBillingEvidence);
+    const currentCohort = assertObservationCohort(current, 'current');
+    const baselineCohort = assertObservationCohort(baseline, 'baseline');
+    assertEvidenceCoversCohort(currentBillingEvidence, current, 'current');
+    assertEvidenceCoversCohort(baselineBillingEvidence, baseline, 'baseline');
+    if ((0, model_js_1.performanceDigest)(currentCohort.environment) !==
+        (0, model_js_1.performanceDigest)(baselineCohort.environment)) {
+        throw invalid('observations/environment', 'baseline and current must identify the same account, Region, stage, workspace, and Slice');
+    }
+    if (baselineBillingEvidence.materialDigest !==
+        input.expectedBaselineBillingEvidenceDigest ||
+        !releasesEqual(baselineBillingEvidence.release, input.expectedBaselineRelease)) {
+        throw invalid('baselineBillingEvidence', 'must bind the independently expected billing evidence digest and exact release');
+    }
+    if (currentBillingEvidence.materialDigest !==
+        input.expectedCurrentBillingEvidenceDigest ||
+        !releasesEqual(currentBillingEvidence.release, input.expectedCurrentRelease)) {
+        throw invalid('currentBillingEvidence', 'must bind the expected billing evidence digest and exact release');
+    }
+    if (Date.parse(currentBillingEvidence.collectedAt) >
+        Date.parse(input.evaluatedAt) ||
+        Date.parse(baselineBillingEvidence.collectedAt) >
+            Date.parse(input.evaluatedAt)) {
+        throw invalid('billingEvidence/collectedAt', 'billing evidence cannot be collected after its evaluation time');
+    }
+    const trends = capabilities
+        .map((definition) => {
+        const currentMatches = current.filter(({ capabilityId }) => capabilityId === definition.id);
+        const baselineMatches = baseline.filter(({ capabilityId }) => capabilityId === definition.id);
+        const currentObservation = currentMatches[0];
+        const baselineObservation = baselineMatches[0];
+        if (currentMatches.length !== 1 ||
+            baselineMatches.length !== 1 ||
+            !currentObservation ||
+            !baselineObservation) {
+            throw invalid(`observations/${definition.id}`, 'requires exactly one current and one baseline observation');
+        }
+        for (const [label, observation] of [
+            ['current', currentObservation],
+            ['baseline', baselineObservation],
+        ]) {
+            if (observation.environment.slice !== policy.slice ||
+                observation.unit !== definition.unit) {
+                throw invalid(`${label}/${definition.id}`, 'Slice and unit must match the exact policy capability');
+            }
+            if (Date.parse(observation.billing.period.end) >
+                Date.parse(input.evaluatedAt)) {
+                throw invalid(`${label}/${definition.id}/billing/period`, 'billing period must be closed before evaluation');
+            }
+        }
+        if (baselineObservation.billing.evidenceDigest !==
+            input.expectedBaselineBillingEvidenceDigest ||
+            !releasesEqual(baselineObservation.release, input.expectedBaselineRelease)) {
+            throw invalid(`baseline/${definition.id}`, 'must bind the independently expected baseline release, source commit, and billing observation');
+        }
+        if (currentObservation.billing.evidenceDigest !==
+            input.expectedCurrentBillingEvidenceDigest ||
+            !releasesEqual(currentObservation.release, input.expectedCurrentRelease) ||
+            Date.parse(currentObservation.billing.period.start) <
+                Date.parse(baselineObservation.billing.period.end)) {
+            throw invalid(`current/${definition.id}`, 'must bind the exact expected release, source commit, billing observation, and a period after baseline');
+        }
+        const currentUnitCost = currentObservation.billing.allocatedCostUsd /
+            currentObservation.aggregate.count;
+        const baselineUnitCost = baselineObservation.billing.allocatedCostUsd /
+            baselineObservation.aggregate.count;
+        const changePercent = Number((((currentUnitCost - baselineUnitCost) / baselineUnitCost) *
+            100).toFixed(9));
+        return {
+            anomaly: changePercent >= definition.anomalyIncreasePercent
+                ? 'increased'
+                : changePercent < 0
+                    ? 'decreased'
+                    : 'within-threshold',
+            baseline: {
+                aggregateEvidenceDigest: baselineObservation.aggregate.evidenceDigest,
+                aggregateId: baselineObservation.aggregate.aggregateId,
+                allocatedCostUsd: baselineObservation.billing.allocatedCostUsd,
+                allocationId: baselineObservation.billing.allocationId,
+                billingEvidenceDigest: baselineObservation.billing.evidenceDigest,
+                count: baselineObservation.aggregate.count,
+                release: baselineObservation.release,
+                unitCostUsd: baselineUnitCost,
+            },
+            capabilityId: definition.id,
+            changePercent,
+            current: {
+                aggregateEvidenceDigest: currentObservation.aggregate.evidenceDigest,
+                aggregateId: currentObservation.aggregate.aggregateId,
+                allocatedCostUsd: currentObservation.billing.allocatedCostUsd,
+                allocationId: currentObservation.billing.allocationId,
+                billingEvidenceDigest: currentObservation.billing.evidenceDigest,
+                count: currentObservation.aggregate.count,
+                release: currentObservation.release,
+                unitCostUsd: currentUnitCost,
+            },
+            ownerRouteRef: definition.ownerRouteRef,
+            thresholdPercent: definition.anomalyIncreasePercent,
+            unit: definition.unit,
+        };
+    })
+        .sort((left, right) => (0, deterministic_order_js_1.compareUtf16)(left.capabilityId, right.capabilityId));
+    const unsigned = {
+        baselineBillingEvidenceDigest: input.expectedBaselineBillingEvidenceDigest,
+        currentBillingEvidenceDigest: input.expectedCurrentBillingEvidenceDigest,
+        evaluatedAt: input.evaluatedAt,
+        expectedBaselineRelease: input.expectedBaselineRelease,
+        expectedRelease: input.expectedCurrentRelease,
+        kind: 'ebk-unit-cost-trend-report',
+        outcome: trends.some(({ anomaly }) => anomaly === 'increased')
+            ? 'attention-required'
+            : 'passed',
+        schemaVersion: 1,
+        slice: policy.slice,
+        trends,
+    };
+    return { ...unsigned, materialDigest: (0, model_js_1.performanceDigest)(unsigned) };
+}
+function unitCostLiveEvidenceStatus(policy) {
+    return {
+        capabilities: policy.cost.unitCostRefs.map((id) => ({
+            id,
+            status: 'requires-closed-aws-billing-and-aggregate-counts',
+        })),
+        kind: 'ebk-unit-cost-live-evidence-status',
+        status: 'incomplete',
+    };
+}
+//# sourceMappingURL=unit-cost.js.map

package/src/performance/unit-cost.js.map

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

package/src/release/index.d.ts

@@ -0,0 +1,4 @@
+export * from './lifecycle.js';
+export * from './manifest.js';
+export * from './rollout.js';
+export * from './source-authority.js';

package/src/release/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lifecycle.js"), exports);
+tslib_1.__exportStar(require("./manifest.js"), exports);
+tslib_1.__exportStar(require("./rollout.js"), exports);
+tslib_1.__exportStar(require("./source-authority.js"), exports);
+//# sourceMappingURL=index.js.map

package/src/release/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/nx/src/release/index.ts"],"names":[],"mappings":";;;AAAA,yDAA+B;AAC/B,wDAA8B;AAC9B,uDAA6B;AAC7B,gEAAsC"}

package/src/release/lifecycle.d.ts

@@ -0,0 +1,132 @@
+import { type ReleaseManifestV1 } from './manifest.js';
+import { type InfrastructureRiskClass } from '../infrastructure-change/model.js';
+export declare const RELEASE_LIFECYCLE_STATES: readonly ["built", "staging-deployed", "staging-verified", "production-authorized", "production-deployed", "production-verified", "rolled-back", "superseded", "retired"];
+export type ReleaseLifecycleState = (typeof RELEASE_LIFECYCLE_STATES)[number];
+export interface ProtectedStageDeploymentEvidence {
+    accountFingerprint: string;
+    artifacts: readonly {
+        classification: 'stage-neutral' | 'stage-specific';
+        evidenceDigest: string;
+        evidenceKind: 'captured-digest' | 'sst-plan-residual';
+        name: string;
+        workload: 'web' | 'lambda' | 'service' | 'job';
+    }[];
+    authorizationDigest: string;
+    configurationDigest: string;
+    convergenceDigest: string;
+    infrastructureAggregateRisk: InfrastructureRiskClass;
+    infrastructurePlanDigest: string;
+    infrastructureRiskClasses: readonly InfrastructureRiskClass[];
+    region: string;
+    stage: 'staging' | 'production';
+}
+export interface ReleaseLifecycleEvent {
+    actor: string;
+    at: string;
+    deployment?: ProtectedStageDeploymentEvidence;
+    evidenceDigest: string;
+    state: ReleaseLifecycleState;
+    workflow: string;
+}
+export interface ReleaseLifecycleRecord {
+    events: readonly ReleaseLifecycleEvent[];
+    kind: 'release-lifecycle-record';
+    releaseMaterialDigest: string;
+    releaseId: string;
+    schemaVersion: 1;
+    state: ReleaseLifecycleState;
+}
+export interface ProtectedReleaseWorkflow {
+    actor: string;
+    approvedMainCommit: string;
+    environment: 'production';
+    oidc: true;
+    reason: string;
+    sourceCommit: string;
+    workflow: string;
+}
+export interface ProtectedProductionAuthorization {
+    actor: string;
+    approvedMainCommit: string;
+    environment: 'production';
+    oidc: true;
+    sourceCommit: string;
+    state: 'production-authorized' | 'production-deployed' | 'production-verified';
+    workflow: string;
+}
+export interface ReleaseRecoveryCompatibilityEvidence {
+    active: {
+        candidateDigest: string;
+        releaseId: string;
+        releaseMaterialDigest: string;
+        sourceCommit: string;
+    };
+    compatibility: Readonly<Record<'api' | 'database' | 'events', {
+        classification: 'compatible' | 'incompatible' | 'unknown';
+        evidenceDigest: string;
+        kind: string;
+    }>>;
+    kind: 'release-recovery-compatibility-evidence';
+    schemaVersion: 1;
+    target: {
+        candidateDigest: string;
+        releaseId: string;
+        releaseMaterialDigest: string;
+        sourceCommit: string;
+    };
+}
+export interface ReleaseRecoveryCompatibilityArtifact {
+    bytes: Uint8Array;
+    report: {
+        activeReportDigest: string;
+        activeSourceCommit: string;
+        classification: 'compatible' | 'incompatible' | 'unknown';
+        kind: string;
+        schemaVersion: 1;
+        targetReportDigest: string;
+        targetSourceCommit: string;
+    };
+}
+export interface ReleaseRecoveryPlan {
+    activeReleaseId: string;
+    activeCandidateDigest: string;
+    actor: string;
+    compatibilityEvidenceDigest: string;
+    kind: 'release-recovery-plan';
+    protectedMutationCommit: string;
+    reason: string;
+    strategy: 'protected-revert' | 'immutable-redeploy' | 'roll-forward';
+    targetArtifactDigests: readonly string[];
+    targetCandidateDigest: string;
+    targetMaterialDigest: string;
+    targetReleaseId: string;
+    targetSourceCommit: string;
+    workflow: string;
+}
+export type ReleaseLifecycleFailureClassification = 'release-lifecycle-transition-invalid' | 'release-lifecycle-evidence-invalid' | 'release-production-authorization-invalid' | 'release-recovery-active-unverified' | 'release-recovery-workflow-invalid' | 'release-recovery-target-unverified' | 'release-recovery-incompatible';
+export declare class ReleaseLifecycleError extends Error {
+    readonly classification: ReleaseLifecycleFailureClassification;
+    constructor(classification: ReleaseLifecycleFailureClassification, message: string);
+}
+export declare function createReleaseLifecycle(manifest: ReleaseManifestV1, evidence: Omit<ReleaseLifecycleEvent, 'at' | 'state'>): ReleaseLifecycleRecord;
+export declare function advanceReleaseLifecycle(record: ReleaseLifecycleRecord, event: ReleaseLifecycleEvent): ReleaseLifecycleRecord;
+export declare function validateProtectedProductionAuthorization(input: ProtectedProductionAuthorization): ProtectedProductionAuthorization;
+export declare function validateReleaseRecoveryCompatibilityArtifacts(input: {
+    active: ReleaseManifestV1;
+    artifacts: Readonly<Record<'api' | 'database' | 'events', ReleaseRecoveryCompatibilityArtifact>>;
+    evidence: ReleaseRecoveryCompatibilityEvidence;
+    target: ReleaseManifestV1;
+}): ReleaseRecoveryCompatibilityEvidence;
+/**
+ * Restricts recovery to a recorded manifest and a protected workflow on the
+ * approved main tip. Database/API/event incompatibility always fails closed.
+ */
+export declare function planReleaseRecovery(input: {
+    active: ReleaseManifestV1;
+    activeLifecycle: ReleaseLifecycleRecord;
+    compatibilityEvidenceBytes: Uint8Array;
+    strategy: ReleaseRecoveryPlan['strategy'];
+    target: ReleaseManifestV1;
+    targetLifecycle: ReleaseLifecycleRecord;
+    workflow: ProtectedReleaseWorkflow;
+}): ReleaseRecoveryPlan;