import { type EvidenceDigestMode } from '../../gates/stats/index.js'; import type { LabelStabilityReport } from './drift.js'; import type { BinarySliceMetrics } from './quality.js'; import type { ExecutedQualification } from './runner.js'; import type { QualificationEvidenceManifest } from './types.js'; export { VERIFIED_QUALIFICATION_INTEGRITY_SOURCES, qualificationIntegrityAllowlistProblems, type QualificationIntegrityMetadata, } from '../../gates/upstream-ceiling.js'; import { type QualificationIntegrityMetadata } from '../../gates/upstream-ceiling.js'; /** AC8 metrics serialized into the release record from the preregistered held-out evaluation. */ export interface QualificationReleaseMetrics { overall: BinarySliceMetrics; slices: Readonly>; /** Repeated-run label movement (stability). */ stability: LabelStabilityReport | null; /** Paired clean-versus-injected movement (injection sensitivity). */ injectionSensitivity: LabelStabilityReport | null; } /** Digest of the protected-artifact snapshot that the #2037/#2048 integrity metadata was computed over. */ export interface QualificationIntegritySnapshot { digest: `sha256:${string}`; artifactCount: number; } /** D30 compile/prefix cache, D03 receipt replay and D15 result cache evidence, each a verified evidence manifest. */ export declare const QUALIFICATION_CACHE_LAYERS: readonly ["compilePrefixCache", "receiptReplay", "resultCache"]; export type QualificationCacheLayer = typeof QUALIFICATION_CACHE_LAYERS[number]; export interface QualificationCacheLayerEvidence { manifest: QualificationEvidenceManifest; /** Digest returned by `writeQualificationEvidenceManifest` for this manifest. */ digest: `sha256:${string}`; } export interface QualificationReleaseInputs { commands: readonly string[]; environment: string; /** Definition, ruleset, binding, adapter, models, policy, calibration, dataset and price catalog. */ pins: Readonly>; budgets: Readonly>; actuals: Readonly>; reviewer: string | null; integrity: QualificationIntegrityMetadata; /** Separately anchored, frozen held-out evaluation; absent or failed evidence blocks promotion. */ benchmark?: { planDigest: `sha256:${string}`; trustedPlanDigest: `sha256:${string}`; decision: 'pass' | 'fail' | 'insufficient-evidence'; sampleN: number; minimumN: number; }; /** Absent metrics block promotion. */ metrics?: QualificationReleaseMetrics; /** Absent snapshot digest blocks promotion. */ integritySnapshot?: QualificationIntegritySnapshot; /** * When present, the compilePrefixCache/receiptReplay/resultCache pins are * derived from these verified manifests; a supplied pin that differs is rejected. */ cacheLayers?: Readonly>; } export type QualificationReleaseVersion = 'decision-qualification-release/v1' | 'decision-qualification-release/v2'; export interface QualificationReleaseRecord { schemaVersion: QualificationReleaseVersion; runId: string; sourceCommit: string; dirty: boolean; environment: string; commands: readonly string[]; pins: Readonly>; budgets: Readonly>; actuals: Readonly>; reviewer: string | null; suites: { caseId: string; outcome: string; evidenceHash: string | null; verified: boolean; }[]; gates: ExecutedQualification['report']['gates']; integrity: QualificationIntegrityMetadata; benchmark: QualificationReleaseInputs['benchmark'] | null; metrics: QualificationReleaseMetrics | null; integritySnapshot: QualificationIntegritySnapshot | null; cacheLayers: Record | null; decision: 'PROMOTE' | 'HOLD' | 'ROLLBACK'; digest: `sha256:${string}`; } /** * Derives the three cache-layer pins from verified evidence manifests. Each * manifest must contain only executable, passing, digest-bound evidence, and * the three layers must come from different runs. */ export declare function deriveCacheLayerPins(layers: Readonly>): Record; /** A release record cannot upgrade a HOLD/ROLLBACK from #2037/#2048 integrity. */ export declare function buildQualificationReleaseRecord(executed: ExecutedQualification, input: QualificationReleaseInputs): QualificationReleaseRecord; /** * Verifies a release record digest without rebuilding it. Canonical-only by default; * pass `{ digestModes: ['canonical', 'legacy'] }` to allowlist the versioned legacy * (`JSON.stringify`) digest for pre-migration v1 evidence. Fresh v2 records are * canonical-only: a legacy digest on v2 fields never verifies, even under an * explicit allowlist. Returns the matching mode, or null when neither matches. */ export declare function verifyQualificationReleaseDigest(record: QualificationReleaseRecord, options?: { digestModes?: readonly EvidenceDigestMode[]; }): EvidenceDigestMode | null; /** Deliberately excludes private callback details, stdout/stderr and raw captures. */ export declare function qualificationReleaseSummary(record: QualificationReleaseRecord): string; //# sourceMappingURL=release.d.ts.map