import { type QualificationGateArtifactFlag } from './gate-evidence.js'; import { type QualificationPrivacyCapture } from './privacy.js'; import type { EvidenceOutcome, QualificationEvidenceManifest, QualificationReport, QualificationRunManifest } from './types.js'; export interface QualificationExecutionResult { outcome: Exclude; details?: unknown; } export interface QualificationExecutionContext { caseId: string; runId: string; signal: AbortSignal; } export type QualificationCaseExecutor = (context: QualificationExecutionContext) => QualificationExecutionResult | Promise; export type QualificationEvidenceCheck = (context: Omit) => boolean | Promise; export interface QualificationExecutionPlan { manifest: Omit; artifactRoot: string; executors: Readonly>; /** * Checks for auxiliary flags and blocking findings only. A check named after * a derived gate flag (see `DERIVED_GATE_EVIDENCE`) is never invoked. */ evidenceChecks?: Readonly>; /** * Source files for artifact-backed gate flags (G3 split plan and calibration, * G5 load result, G6 reviewer decision). Each is validated, copied into the * run directory and digest-pinned; a flag without a valid artifact is false. */ gateArtifacts?: Readonly>>; timeoutMs?: number; concurrency?: number; maxArtifactBytes?: number; /** Explicitly select public aggregate fields for persistence. Raw executor details are private by default. */ sanitizeDetails?: (details: unknown, caseId: string) => unknown; /** Synthetic canaries never leave the process, including through selected public details. */ privacyCanaries?: readonly string[]; /** Captured output surfaces; required for the G2 privacy flag. Empty observations must be explicit. */ privacyCaptures?: readonly QualificationPrivacyCapture[]; } export interface ArtifactVerification { caseId: string; verified: boolean; reason?: 'missing' | 'unsafe-path' | 'not-file' | 'too-large' | 'digest-mismatch' | 'invalid-artifact'; } export interface GateArtifactVerification { flag: string; verified: boolean; reason?: 'unknown-flag' | 'unsafe-path' | 'not-file' | 'too-large' | 'digest-mismatch' | 'invalid-artifact' | 'missing'; } export interface ExecutedQualification { manifest: QualificationRunManifest; verification: ArtifactVerification[]; gateVerification: GateArtifactVerification[]; report: QualificationReport; } export type QualificationGoldenSources = Readonly>; /** Named master-test-plan suites plus the M01-M11 amendment IDs. */ export declare const QUALIFICATION_EVIDENCE_ID: RegExp; /** Executes cases and gate checks; neither evidence outcomes nor flags are accepted from the caller. */ export declare function executeQualificationPlan(plan: QualificationExecutionPlan): Promise; /** Re-reads gate artifacts from the artifact root and re-validates their content against the run. */ export declare function verifyQualificationGateArtifacts(manifest: QualificationRunManifest, artifactRoot: string, maxArtifactBytes?: number): Promise; /** * Derives `privacy-scan-clean` for an executed run from surfaces captured * around the whole run (see `captureQualificationLifetime`). The value comes * from the scanner, as with `privacyCaptures`; it is never taken from the caller. */ export declare function withQualificationPrivacyScan(manifest: QualificationRunManifest, captures: readonly QualificationPrivacyCapture[], canaries: readonly string[]): QualificationRunManifest; /** * Builds D11's evidence linkage only from runner-produced artifacts that still * verify and checked-in source goldens that can be independently hashed. */ export declare function createQualificationEvidenceManifest(manifest: QualificationRunManifest, artifactRoot: string, sourceRoot: string, sources: QualificationGoldenSources): Promise; /** Persists the evidence linkage beside the runner artifacts for CI/release collection. */ export declare function writeQualificationEvidenceManifest(manifest: QualificationRunManifest, artifactRoot: string, sourceRoot: string, sources: QualificationGoldenSources): Promise<{ manifest: QualificationEvidenceManifest; artifact: string; digest: `sha256:${string}`; }>; /** Re-reads artifacts and verifies containment, file type, content, and exact SHA-256. */ export declare function verifyQualificationArtifacts(manifest: QualificationRunManifest, artifactRoot: string, maxArtifactBytes?: number): Promise; /** Promotion-capable evaluation that fails closed when any artifact cannot be independently verified. */ export declare function evaluateExecutedQualification(manifest: QualificationRunManifest, artifactRoot: string, maxArtifactBytes?: number): Promise; /** Executes, persists, verifies, and evaluates in one promotion-capable pipeline. */ export declare function executeAndEvaluateQualification(plan: QualificationExecutionPlan): Promise; //# sourceMappingURL=runner.d.ts.map