declare const TRACE_ARTIFACT_MANIFEST_SCHEMA_VERSION: "0.1"; /** Experimental reporter framework identifier for local CI artifacts. */ type TraceReporterFramework = "vitest" | "jest" | "manual"; /** Experimental reporter test status normalized across supported test runners. */ type TraceTestStatus = "passed" | "failed" | "skipped" | "todo"; /** Experimental reporter artifact kind used in artifact manifests. */ type TraceArtifactKind = "trace" | "report" | "eval" | "redaction" | "summary" | "evidence"; /** Experimental reporter artifact file format used in artifact manifests. */ type TraceArtifactFormat = "json" | "jsonl" | "md" | "html"; /** Experimental redaction profile marker recorded with reporter artifacts. */ type TraceArtifactRedactionProfile = "local" | "share" | "strict"; /** Experimental reporter diagnostic severity. */ type TraceReporterDiagnosticSeverity = "info" | "warning" | "error"; /** Experimental reporter diagnostic code for safe, non-throwing reporter helpers. */ type TraceReporterDiagnosticCode = "invalid_artifact_path" | "artifact_path_escape" | "artifact_path_empty" | "artifact_path_absolute" | "reporter_failure"; /** Experimental diagnostic emitted by reporter helpers instead of throwing. */ interface TraceReporterDiagnostic { code: TraceReporterDiagnosticCode; severity: TraceReporterDiagnosticSeverity; message: string; target?: string; } /** Experimental manifest artifact entry shared by framework reporters. */ interface TraceArtifact { kind: TraceArtifactKind; path: string; format: TraceArtifactFormat; redactionProfile: TraceArtifactRedactionProfile; title?: string; sizeBytes?: number; diagnostics?: TraceReporterDiagnostic[]; } /** Experimental normalized test result entry shared by framework reporters. */ interface TraceTestResult { testId: string; name: string; file?: string; status: TraceTestStatus; durationMs?: number; tracePath?: string; artifacts?: TraceArtifact[]; diagnostics?: TraceReporterDiagnostic[]; } /** Experimental reporter artifact manifest shared by framework reporters. */ interface TraceArtifactManifest { schemaVersion: typeof TRACE_ARTIFACT_MANIFEST_SCHEMA_VERSION; generatedAt: string; framework: TraceReporterFramework; results: TraceTestResult[]; artifacts: TraceArtifact[]; diagnostics: TraceReporterDiagnostic[]; } /** Experimental options for deterministic reporter artifact manifest creation. */ interface CreateTraceArtifactManifestOptions { framework: TraceReporterFramework; generatedAt: string; results: TraceTestResult[]; artifacts?: TraceArtifact[]; diagnostics?: TraceReporterDiagnostic[]; } /** Experimental options for deriving a safe reporter artifact path. */ interface CreateReporterArtifactPathOptions { outputDir: string; testId: string; name: string; kind: TraceArtifactKind; format: TraceArtifactFormat; file?: string; } /** Experimental result from reporter artifact path validation/resolution. */ interface ReporterArtifactPathResult { ok: boolean; outputDir: string; relativePath?: string; absolutePath?: string; diagnostics: TraceReporterDiagnostic[]; } interface ValidateReporterArtifactPathOptions { outputDir: string; relativePath: string; } /** Experimental helper that creates a deterministic reporter artifact manifest. */ declare function createTraceArtifactManifest(options: CreateTraceArtifactManifestOptions): TraceArtifactManifest; /** Experimental helper that creates a safe, deterministic artifact path for a test. */ declare function createReporterArtifactPath(options: CreateReporterArtifactPathOptions): ReporterArtifactPathResult; /** Experimental helper that validates an artifact path stays inside outputDir. */ declare function validateReporterArtifactPath(options: ValidateReporterArtifactPathOptions): ReporterArtifactPathResult; /** Experimental helper that converts an unknown reporter failure into a diagnostic. */ declare function createReporterFailureDiagnostic(error: unknown, target?: string): TraceReporterDiagnostic; /** * Standard Evidence v2 filenames for CI failure packages (same shape as `bundle`). * Success remains quiet by default — callers should emit these only on failure. */ declare const EVIDENCE_CI_ARTIFACT_FILES: readonly ["evidence.html", "evidence.json", "check-results.json", "trace.jsonl"]; type EvidenceCiArtifactFile = (typeof EVIDENCE_CI_ARTIFACT_FILES)[number]; /** * Experimental helper: TraceArtifact entries for a standard Evidence v2 CI package. */ declare function createEvidenceCiArtifacts(options: { redactionProfile?: TraceArtifactRedactionProfile; /** Optional subdirectory under the test artifact folder (POSIX). */ relativeDir?: string; }): TraceArtifact[]; export { type CreateReporterArtifactPathOptions, type CreateTraceArtifactManifestOptions, EVIDENCE_CI_ARTIFACT_FILES, type EvidenceCiArtifactFile, type ReporterArtifactPathResult, TRACE_ARTIFACT_MANIFEST_SCHEMA_VERSION, type TraceArtifact, type TraceArtifactFormat, type TraceArtifactKind, type TraceArtifactManifest, type TraceArtifactRedactionProfile, type TraceReporterDiagnostic, type TraceReporterDiagnosticCode, type TraceReporterDiagnosticSeverity, type TraceReporterFramework, type TraceTestResult, type TraceTestStatus, type ValidateReporterArtifactPathOptions, createEvidenceCiArtifacts, createReporterArtifactPath, createReporterFailureDiagnostic, createTraceArtifactManifest, validateReporterArtifactPath };