@gfdelarue/testkit 0.4.4 → 0.5.0

package/dist/environment/services.d.ts

@@ -1,48 +0,0 @@
-import { type SupervisedProcessHandle, type SupervisedProcessReady } from "../process/index.js";
-import { type ToolchainResolvedReporter } from "../toolchains/index.js";
-import { type RuntimeServiceConfig } from "./template.js";
-import { type OutputLineHandler } from "../process/index.js";
-import type { RunLogRegistry } from "../evidence/logs.js";
-type LocalServiceConfig = RuntimeServiceConfig & {
-    runtimeLabel: string;
-    stateDir: string;
-    testkit: RuntimeServiceConfig["testkit"] & {
-        local: NonNullable<RuntimeServiceConfig["testkit"]["local"]> & {
-            readyTimeoutMs?: number;
-            shutdownTimeoutMs?: number;
-        };
-    };
-};
-export type ResolvedServiceConfig = RuntimeServiceConfig & {
-    runtimeLabel: string;
-    stateDir: string;
-};
-export interface LocalServiceLifecycle {
-    isStopRequested(): unknown;
-    registerService(config: LocalServiceConfig, supervisor: SupervisedProcessHandle, ownership: SupervisedProcessReady, cwd: string): unknown;
-    requestStop(reason?: unknown): unknown;
-    signal: AbortSignal;
-    unregisterService(supervisorPid: number): unknown;
-}
-export interface LocalServiceReporter extends ToolchainResolvedReporter<LocalServiceConfig> {
-    localServiceStarting?: (config: LocalServiceConfig, command: string) => unknown;
-    outputMode?: string;
-    writeDebugLine?: OutputLineHandler;
-}
-export interface StartLocalServicesOptions {
-    extraEnv?: NodeJS.ProcessEnv | null;
-    logRegistry?: RunLogRegistry | null;
-    reporter?: LocalServiceReporter | null;
-}
-export interface StartedLocalService {
-    completionMonitor: Promise<Error | null>;
-    expectCompletion(): void;
-    name: string;
-    outputDrains: Promise<void>[];
-    ownership: SupervisedProcessReady;
-    supervisor: SupervisedProcessHandle;
-}
-export declare function startLocalServices(runtimeConfigs: readonly ResolvedServiceConfig[], lifecycle: LocalServiceLifecycle, options?: Readonly<StartLocalServicesOptions>): Promise<StartedLocalService[]>;
-export declare function startLocalService(config: LocalServiceConfig, lifecycle: LocalServiceLifecycle, options?: Readonly<StartLocalServicesOptions>): Promise<StartedLocalService>;
-export declare function stopLocalServices(started: readonly StartedLocalService[], lifecycle: LocalServiceLifecycle | null | undefined): Promise<void>;
-export {};

package/dist/environment/state.d.ts

@@ -1,18 +0,0 @@
-import type { RuntimeGraph } from "./planning-types.js";
-export type GraphMetadataInput = Pick<RuntimeGraph, "dirName" | "instanceCount" | "key" | "maxConcurrentTasks" | "portNamespaceIndex" | "portNamespaceStride" | "runtimeNames" | "targetNames">;
-export interface GraphMetadata extends Record<string, unknown> {
-    dirName?: null | string;
-    instanceCount?: null | number;
-    key?: null | string;
-    maxConcurrentTasks?: null | number;
-    portNamespaceIndex?: null | number;
-    portNamespaceStride?: null | number;
-    runtimeNames?: string[];
-    runtimeServices?: string[];
-    targetServices?: string[];
-}
-export declare function findRuntimeStateDirs(rootDir: string, isDatabaseStateDir: (directory: string) => boolean): string[];
-export declare function findGraphDirsForService(productDir: string, serviceName: string): string[];
-export declare function writeGraphMetadata(graphDir: string, graph: Readonly<GraphMetadataInput>): void;
-export declare function readGraphMetadata(graphDir: string): GraphMetadata | null;
-export declare function normalizePathSeparators(filePath: string): string;

package/dist/environment/status-runtime.d.ts

@@ -1,53 +0,0 @@
-import type { DesiredRuntimeGraph } from "./planning-types.js";
-export interface RuntimeDirectoryStatus {
-    id: string;
-    path: string;
-}
-export interface StaleRuntimeDirectoryStatus extends RuntimeDirectoryStatus {
-    active: boolean;
-}
-export interface DesiredRuntimeGraphStatus {
-    instanceCount: number;
-    runtimeIds: string[];
-    runtimeServices: string[];
-    targetServices: string[];
-}
-export interface ActualRuntimeGraphStatus {
-    runtimeServices: string[];
-    targetServices: string[];
-}
-export interface RuntimeGraphStatus {
-    actual: ActualRuntimeGraphStatus | null;
-    currentRuntimeDirs: RuntimeDirectoryStatus[];
-    desired: DesiredRuntimeGraphStatus | null;
-    exists: boolean;
-    name: string;
-    orphan: boolean;
-    path: string;
-    runtimeDirCount: number;
-    staleRuntimeDirs: StaleRuntimeDirectoryStatus[];
-}
-export interface RunStatusEntry {
-    pid?: number;
-    ports: string[];
-    runId: unknown;
-    startedAt: null | string;
-    status: "active" | "stale";
-}
-export interface RunStatus {
-    active: number;
-    runs: RunStatusEntry[];
-    stale: number;
-    total: number;
-}
-export interface RuntimeCleanupTarget {
-    graph: string;
-    path: string;
-    runtimeId: string;
-}
-export interface RuntimeGraphStatusOptions {
-    desiredGraphs?: readonly DesiredRuntimeGraph[];
-    serviceName?: null | string;
-}
-export declare function collectRuntimeGraphStatus(productDir: string, { desiredGraphs, serviceName }?: Readonly<RuntimeGraphStatusOptions>): RuntimeGraphStatus[];
-export declare function collectRunStatus(productDir: string): RunStatus;

package/dist/environment/template.d.ts

@@ -1,180 +0,0 @@
-import type { RuntimeSocket } from "../process/runtime-socket.js";
-import { type NormalizedDatabaseConfig, type NormalizedRuntimeConfig } from "../config/loader/index.js";
-import { type ExecutionEnvironmentConfig, type ExecutionEnvironmentLocalConfig, type ExecutionEnvironmentTestkitConfig, type ExecutionTemplateContextValues, type RuntimeUrlMapping } from "../steps/index.js";
-import { readDatabaseInfo } from "../database/state.js";
-type RuntimeIdentifier = number | string;
-type StringMap = ReadonlyMap<string, string>;
-interface RuntimeLocalConfig extends ExecutionEnvironmentLocalConfig {
-    baseUrl: string;
-    cwd?: string;
-    port?: number;
-    readyUrl?: false | null | string;
-    shutdownTimeoutMs?: number;
-    start: string;
-}
-interface RuntimeServiceTestkitConfig extends ExecutionEnvironmentTestkitConfig {
-    database?: NormalizedDatabaseConfig | null;
-    local?: RuntimeLocalConfig | null;
-    runtime: NormalizedRuntimeConfig;
-}
-export interface RuntimeServiceConfig extends ExecutionEnvironmentConfig {
-    testkit: RuntimeServiceTestkitConfig;
-}
-export interface RuntimePortNamespace {
-    index?: unknown;
-    portOffset?: unknown;
-    stride?: unknown;
-}
-export interface RuntimeInstanceResolutionOptions {
-    externalEndpoints?: Readonly<Record<string, null | string | undefined>>;
-    graphDirName?: null | string;
-    portNamespaceIndex?: number;
-    portNamespaceStride?: number;
-    portOffset?: number;
-    privateEndpoints?: Readonly<Record<string, null | string | undefined>>;
-    publicEndpoints?: Readonly<Record<string, null | string | undefined>>;
-    publicHost?: null | string;
-    serviceContextEndpoints?: Readonly<Record<string, null | string | undefined>>;
-}
-interface RuntimeUrlResolutionContext extends ExecutionTemplateContextValues {
-    portMap: ReadonlyMap<string, number>;
-}
-export declare function resolveRuntimeInstanceConfigs<T extends RuntimeServiceConfig>(runtimeConfigs: readonly T[], runtimeId: string, runtimeDir: string, options?: RuntimeInstanceResolutionOptions): (T & {
-    stateDir: string;
-    runtimeId: string;
-    runtimeLabel: string;
-    testkit: {
-        mode?: string;
-        serviceEnv?: Readonly<Record<string, string>>;
-        ui?: unknown;
-        database: import("../config/loader/database-materialization.js").MaterializedDatabaseConfig<{
-            image?: string;
-            password?: string;
-            user?: string;
-            binding: import("../config/loader/execution-model.js").DatabaseBinding;
-            maxConnections: number | undefined;
-            reservedConnections: number | undefined;
-            reset: boolean;
-            roles: import("../config/authoring/index.js").DatabaseRoleConfig[];
-            runtimeConnections: number | undefined;
-            serviceName: string;
-            sourceSchema: import("../config/loader/database.js").NormalizedSourceSchemaConfig | null;
-            template: import("../config/loader/database.js").NormalizedDatabaseTemplateConfig;
-        }> | undefined;
-        prepareDir: string;
-        templateContext: {
-            runtimeId: string;
-            runtimeLabel: string;
-            runtimeDir: string;
-            productDir: string;
-            serviceName: string;
-            serviceCwd: string;
-            serviceStateDir: string;
-            prepareDir: string;
-            portMap: ReadonlyMap<string, number>;
-            baseUrlByService: StringMap;
-            readyUrlByService: StringMap;
-            publicBaseUrlByService: StringMap;
-            privateBaseUrlByService: StringMap;
-            serviceContextUrlByService: StringMap;
-            publicHost: string | null;
-            stateDirByService: StringMap;
-            urlMappings: readonly RuntimeUrlMapping[];
-            leaseId: null;
-            leaseDir: null;
-            databaseBindingsReader: typeof readDatabaseInfo;
-        };
-        runtime: {
-            build: import("../steps/build-config.js").NormalizedBuildConfig | null;
-            instances: number;
-            maxConcurrentTasks: number;
-            toolchain: import("../toolchains/index.js").NormalizedRuntimeToolchain | null;
-            prepare: import("../steps/build-config.js").NormalizedBuildPrepareConfig;
-        };
-        local: {
-            shutdownTimeoutMs?: number;
-            start: string;
-            cwd: string | undefined;
-            port: number | undefined;
-            baseUrl: string | undefined;
-            readyUrl: string | undefined;
-            env: {
-                [x: string]: string;
-            };
-        } | undefined;
-    };
-})[];
-export declare function buildPortMap(runtimeConfigs: readonly RuntimeServiceConfig[], runtimeId: RuntimeIdentifier, namespace?: RuntimePortNamespace): Map<string, number>;
-export declare function resolveRuntimeConfig<T extends RuntimeServiceConfig>(config: T, runtimeId: string, runtimeLabel: string, runtimeDir: string, portMap: ReadonlyMap<string, number>, baseUrlByService: StringMap, readyUrlByService: StringMap, publicBaseUrlByService: StringMap, privateBaseUrlByService: StringMap, serviceContextUrlByService: StringMap, publicHost: null | string, stateDirByService: StringMap, urlMappings: readonly RuntimeUrlMapping[]): T & {
-    stateDir: string;
-    runtimeId: string;
-    runtimeLabel: string;
-    testkit: {
-        mode?: string;
-        serviceEnv?: Readonly<Record<string, string>>;
-        ui?: unknown;
-        database: import("../config/loader/database-materialization.js").MaterializedDatabaseConfig<{
-            image?: string;
-            password?: string;
-            user?: string;
-            binding: import("../config/loader/execution-model.js").DatabaseBinding;
-            maxConnections: number | undefined;
-            reservedConnections: number | undefined;
-            reset: boolean;
-            roles: import("../config/authoring/index.js").DatabaseRoleConfig[];
-            runtimeConnections: number | undefined;
-            serviceName: string;
-            sourceSchema: import("../config/loader/database.js").NormalizedSourceSchemaConfig | null;
-            template: import("../config/loader/database.js").NormalizedDatabaseTemplateConfig;
-        }> | undefined;
-        prepareDir: string;
-        templateContext: {
-            runtimeId: string;
-            runtimeLabel: string;
-            runtimeDir: string;
-            productDir: string;
-            serviceName: string;
-            serviceCwd: string;
-            serviceStateDir: string;
-            prepareDir: string;
-            portMap: ReadonlyMap<string, number>;
-            baseUrlByService: StringMap;
-            readyUrlByService: StringMap;
-            publicBaseUrlByService: StringMap;
-            privateBaseUrlByService: StringMap;
-            serviceContextUrlByService: StringMap;
-            publicHost: string | null;
-            stateDirByService: StringMap;
-            urlMappings: readonly RuntimeUrlMapping[];
-            leaseId: null;
-            leaseDir: null;
-            databaseBindingsReader: typeof readDatabaseInfo;
-        };
-        runtime: {
-            build: import("../steps/build-config.js").NormalizedBuildConfig | null;
-            instances: number;
-            maxConcurrentTasks: number;
-            toolchain: import("../toolchains/index.js").NormalizedRuntimeToolchain | null;
-            prepare: import("../steps/build-config.js").NormalizedBuildPrepareConfig;
-        };
-        local: {
-            shutdownTimeoutMs?: number;
-            start: string;
-            cwd: string | undefined;
-            port: number | undefined;
-            baseUrl: string | undefined;
-            readyUrl: string | undefined;
-            env: {
-                [x: string]: string;
-            };
-        } | undefined;
-    };
-};
-export declare function resolveServiceStateDir(runtimeDir: string, config: Pick<ExecutionEnvironmentConfig, "name">): string;
-export declare function resolveServicePrepareDir(runtimeDir: string, config: Pick<ExecutionEnvironmentConfig, "name">): string;
-export declare function resolveRuntimeUrl(rawUrl: string, serviceName: string, runtimeId: string, context: RuntimeUrlResolutionContext): string;
-export declare function rewriteUrlPort(rawUrl: string, port: number): string;
-export declare function numericPortFromUrl(rawUrl: string): number | null;
-export declare function socketFromUrl(rawUrl: string): RuntimeSocket | null;
-export declare function normalizeSocketHost(hostname: string): string;
-export {};

package/dist/evidence/artifact-config.d.ts

@@ -1,14 +0,0 @@
-export interface NormalizedArtifactRetentionConfig {
-    maxRuns: number | null;
-    maxAgeDays: number | null;
-    preserveSuites: string[];
-}
-export interface NormalizedArtifactPublicationConfig {
-    directory: string;
-    required: boolean;
-}
-export interface NormalizedArtifactArchiveConfig {
-    retention: NormalizedArtifactRetentionConfig;
-    publication: NormalizedArtifactPublicationConfig | null;
-}
-export declare function normalizeArtifactArchiveConfig(config?: unknown): NormalizedArtifactArchiveConfig;

package/dist/evidence/artifact-validation.d.ts

@@ -1,5 +0,0 @@
-export { requireObjectRecord, isObjectRecord, requireStringArray as normalizeStringArray } from "./read-fields.js";
-export type UnknownRecord = Record<string, unknown>;
-export declare function isUnknownArray(value: unknown): value is unknown[];
-export declare function readOptionalProperty(value: UnknownRecord | undefined, key: string): unknown;
-export declare function normalizeOptionalNonEmptyString(value: unknown, label: string): string | null;

package/dist/evidence/artifacts.d.ts

@@ -1,75 +0,0 @@
-import type { RunArtifactDocument } from "./reporting-types.js";
-import { type EngineJsonValue } from "../engines/api/index.js";
-import { type EngineId, type PublicTestType, type RunnerProfileId } from "../domain/identifiers.js";
-import { type NormalizedArtifactArchiveConfig } from "./artifact-config.js";
-import { applyRunBundleRetention, publishRunBundle, sealRunBundle, type RunBundleArtifact, type SealRunBundleOptions } from "./bundles.js";
-import { type Timings, type TimingUpdate } from "./timing.js";
-import type { ReportingArtifactReference } from "./reporting-types.js";
-import { type SecureFileCopyResult } from "./secure-file-copy.js";
-export type WrittenRunArtifact<Artifact extends RunArtifactDocument> = Omit<Artifact, "archive"> & RunBundleArtifact;
-export interface WriteRunArtifactOptions extends Omit<SealRunBundleOptions, "archiveConfig" | "declaredEnvironmentKeys"> {
-    archiveConfig?: NormalizedArtifactArchiveConfig | null;
-    declaredEnvironmentKeys?: readonly string[];
-}
-export interface WriteRunArtifactDependencies {
-    applyRunBundleRetention?: typeof applyRunBundleRetention;
-    publishRunBundle?: typeof publishRunBundle;
-    sealRunBundle?: typeof sealRunBundle;
-    writeLatestProjection?: (filePath: string, value: unknown) => void;
-}
-export interface InterruptLiveRunArtifactOptions {
-    finishedAt?: Date | number | string;
-    reason?: string;
-    runId?: null | string;
-    status?: string;
-}
-export interface ArtifactTask {
-    engineId: EngineId;
-    file?: null | string;
-    id: number | string;
-    profileId: RunnerProfileId;
-    serviceName?: null | string;
-    suiteKey?: null | string;
-    suiteName?: null | string;
-    testType: PublicTestType;
-}
-export interface PersistedArtifactReference extends ReportingArtifactReference {
-    contentType: string;
-    kind: null | string;
-    summary: null | string;
-}
-interface RuntimeArtifactInput {
-    contentType?: null | string;
-    data?: EngineJsonValue;
-    emittedAt?: null | string;
-    kind?: null | string;
-    name: string;
-    summary?: null | string;
-}
-interface FileArtifactInput {
-    contentType?: null | string;
-    kind?: null | string;
-    name?: null | string;
-    path: string;
-    summary?: null | string;
-}
-interface TaskOutputArtifactInput extends Partial<Omit<RuntimeArtifactInput, "data">> {
-    stream?: null | string;
-    text: string;
-}
-export interface PersistTaskFileArtifactsOptions {
-    copyResults?: SecureFileCopyResult[];
-    maxBytes?: number;
-    sizeLimitDescription?: string;
-    sourceRoot?: string;
-}
-export declare function writeRunArtifact<Artifact extends RunArtifactDocument>(productDir: string, artifact: Artifact, options?: WriteRunArtifactOptions, dependencies?: Readonly<WriteRunArtifactDependencies>): WrittenRunArtifact<Artifact>;
-export declare function writeLiveRunArtifact(productDir: string, artifact: RunArtifactDocument): void;
-export declare function finalizeLiveRunArtifact(productDir: string, options?: InterruptLiveRunArtifactOptions): boolean;
-export declare function resetResultArtifacts(productDir: string): void;
-export declare function persistTaskArtifacts(productDir: string, task: Readonly<ArtifactTask>, emittedArtifacts: readonly RuntimeArtifactInput[]): PersistedArtifactReference[];
-export declare function persistTaskFileArtifacts(productDir: string, task: Readonly<ArtifactTask>, fileArtifacts: readonly FileArtifactInput[], options?: Readonly<PersistTaskFileArtifactsOptions>): PersistedArtifactReference[];
-export declare function persistTaskOutputArtifacts(productDir: string, task: Readonly<ArtifactTask>, outputs: readonly TaskOutputArtifactInput[]): PersistedArtifactReference[];
-export declare function loadTimings(productDir: string): Timings;
-export declare function saveTimings(productDir: string, timings: Timings, updates: readonly TimingUpdate[]): void;
-export {};

package/dist/evidence/bundles.d.ts

@@ -1,27 +0,0 @@
-import type { RunArtifactDocument } from "./reporting-types.js";
-import type { NormalizedArtifactPublicationConfig, NormalizedArtifactRetentionConfig } from "./artifact-config.js";
-import { type RunBundleArtifact, type RunBundleCleanup, type RunBundleManifest, type RunBundlePublication, type RunBundleRetentionDecision, type RunBundleSummary, type RunBundleVerification, type SealRunBundleOptions } from "./contracts.js";
-export type { RunBundleArchive, RunBundleArtifact, RunBundleCleanup, RunBundleLatestProjection, RunBundleManifest, RunBundleManifestEntry, RunBundlePublication, RunBundleRedaction, RunBundleRetentionDecision, RunBundleStorage, RunBundleSummary, RunBundleVerification, SealRunBundleOptions, } from "./contracts.js";
-interface PublicationReceiptInput extends RunBundlePublication {
-    bytesUploaded: number;
-}
-export interface RunBundleSealDependencies {
-    cleanupActiveRunResults?: (resultsDir: string) => RunBundleCleanup;
-}
-export interface RunBundleRetentionDependencies {
-    removeObject?: (objectPath: string) => void;
-    removeRunBundle?: (bundlePath: string) => void;
-}
-export interface RunBundlePublicationDependencies {
-    writePublicationReceipt?: (productDir: string, runId: string, receipt: PublicationReceiptInput) => RunBundlePublication;
-}
-export declare function sealRunBundle(productDir: string, artifact: RunArtifactDocument, options?: SealRunBundleOptions, dependencies?: Readonly<RunBundleSealDependencies>): RunBundleArtifact;
-export declare function loadVerifiedRunBundleArtifactIfExists(productDir: string, runId: unknown): RunBundleArtifact | null;
-export declare function loadRunBundleArtifact(productDir: string, runId: unknown): RunBundleArtifact;
-export declare function loadRunBundleManifest(productDir: string, runId: unknown): RunBundleManifest;
-export declare function listRunBundles(productDir: string, options?: {
-    file?: null | string;
-}): RunBundleSummary[];
-export declare function verifyRunBundle(productDir: string, runId: unknown): RunBundleVerification;
-export declare function publishRunBundle(productDir: string, runId: unknown, publication: NormalizedArtifactPublicationConfig | null, dependencies?: Readonly<RunBundlePublicationDependencies>): RunBundlePublication;
-export declare function applyRunBundleRetention(productDir: string, currentRunId: unknown, retention?: Partial<NormalizedArtifactRetentionConfig>, dependencies?: Readonly<RunBundleRetentionDependencies>): RunBundleRetentionDecision;

package/dist/evidence/ci-provenance.d.ts

@@ -1,9 +0,0 @@
-export type CiProvider = "github" | "gitlab" | "other";
-export interface CiProvenance {
-    readonly actor: string | null;
-    readonly eventName: string | null;
-    readonly provider: CiProvider | null;
-    readonly runId: string | null;
-    readonly runUrl: string | null;
-}
-export declare function resolveCiProvenance(env: Readonly<NodeJS.ProcessEnv>): CiProvenance;

package/dist/evidence/contracts.d.ts

@@ -1,154 +0,0 @@
-import type { CiProvenance } from "./ci-provenance.js";
-import type { NormalizedArtifactArchiveConfig } from "./artifact-config.js";
-import type { RunArtifactDocument } from "./reporting-types.js";
-export declare const BUNDLE_SCHEMA_VERSION = 2;
-export type RunBundleSchemaVersion = typeof BUNDLE_SCHEMA_VERSION;
-export declare const PROVENANCE_SCHEMA_VERSION = 3;
-export type ProvenanceSchemaVersion = typeof PROVENANCE_SCHEMA_VERSION;
-export declare const RETENTION_DECISION_SCHEMA_VERSION = 1;
-export type RunBundleRetentionDecisionSchemaVersion = typeof RETENTION_DECISION_SCHEMA_VERSION;
-export declare const OBJECTS_DIRNAME = "objects";
-export declare const RUNS_DIRNAME = "runs";
-export type UnknownRecord = Record<string, unknown>;
-export interface RunBundleStorage extends UnknownRecord {
-    deduplicatedBytes: number;
-    fileCount: number;
-    logicalBytes: number;
-    objectBytesWritten: number;
-}
-export interface RunBundleRedaction extends UnknownRecord {
-    filesRedacted: number;
-    policyVersion: number;
-    replacements: number;
-    sensitiveEnvironmentKeys: string[];
-    status: string;
-    structuredReplacements?: number;
-    textualFilesScanned: number;
-    valuesStored: boolean;
-}
-export interface RunBundlePublication extends UnknownRecord {
-    bundleBytes?: number;
-    bytesUploaded?: number;
-    configured?: boolean;
-    error?: string;
-    manifestDigest?: null | string;
-    required?: boolean;
-    reused?: boolean;
-    status: "complete" | "failed" | "not_configured" | "pending";
-    target?: null | string;
-}
-export interface RunBundleGarbageCollection {
-    failures: RunBundleGarbageCollectionFailure[];
-    reclaimedBytes: number;
-    removedObjects: number;
-    status: "complete" | "failed" | "not_started";
-}
-export interface RunBundleGarbageCollectionFailure {
-    error: string;
-    path: string;
-}
-export interface RunBundleCleanup {
-    error?: string;
-    status: "complete" | "failed";
-}
-export interface RunBundleLatestProjection {
-    error?: string;
-    path: string;
-    status: "complete" | "failed";
-}
-export interface RunBundleRemoval {
-    reasons: ("max_age" | "max_runs")[];
-    runId: string;
-}
-export interface RunBundleRemovalError extends RunBundleRemoval {
-    error: string;
-    path: string;
-    removed: boolean;
-}
-export interface RunBundleRetentionLedger {
-    error?: string;
-    path: string;
-    status: "complete" | "failed" | "not_started";
-}
-export interface RunBundleRetentionDecision extends UnknownRecord {
-    currentRunId: string;
-    decidedAt: string;
-    error?: string;
-    garbageCollection: RunBundleGarbageCollection;
-    ledger?: RunBundleRetentionLedger;
-    policy: {
-        maxAgeDays: null | number;
-        maxRuns: null | number;
-        preserveSuites: string[];
-    };
-    protectedRunIds: string[];
-    removed: RunBundleRemoval[];
-    removalErrors: RunBundleRemovalError[];
-    schemaVersion: RunBundleRetentionDecisionSchemaVersion;
-    status: "complete" | "failed";
-}
-export interface RunBundleArchive extends UnknownRecord {
-    canonicalRunPath: string;
-    cleanup?: RunBundleCleanup;
-    integrity: "sha256";
-    latest?: RunBundleLatestProjection;
-    manifestDigest?: string;
-    manifestPath: string;
-    provenancePath: string;
-    publication: RunBundlePublication;
-    redaction: RunBundleRedaction;
-    retention?: RunBundleRetentionDecision;
-    runId: string;
-    schemaVersion: RunBundleSchemaVersion;
-    status: "complete";
-    storage?: RunBundleStorage;
-}
-export interface RunBundleArtifact extends RunArtifactDocument {
-    archive: RunBundleArchive;
-    finalizationFailure?: RunArtifactDocument["finalizationFailure"];
-}
-export interface RunBundleManifestEntry extends UnknownRecord {
-    bytes: number;
-    path: string;
-    sha256: string;
-}
-export interface RunBundleManifest extends UnknownRecord {
-    algorithm: "sha256";
-    createdAt: string;
-    digest: string;
-    files: RunBundleManifestEntry[];
-    redaction: RunBundleRedaction;
-    runId: string;
-    schemaVersion: RunBundleSchemaVersion;
-    storage: RunBundleStorage;
-}
-export interface RunBundleSummary {
-    canonicalRunPath: null | string;
-    finishedAt: null | string;
-    manifestDigest: null | string;
-    runId: string;
-    startedAt: null | string;
-    status: null | string;
-}
-export interface RunBundleVerification {
-    checkedFiles: number;
-    errors: string[];
-    manifestDigest?: null | string;
-    ok: boolean;
-    runId: string;
-    storage?: null | RunBundleStorage;
-}
-export interface SealRunBundleOptions {
-    archiveConfig?: Partial<NormalizedArtifactArchiveConfig>;
-    declaredEnvironmentKeys?: readonly string[];
-    env?: NodeJS.ProcessEnv;
-}
-export interface RunBundleProvenance extends UnknownRecord {
-    schemaVersion: ProvenanceSchemaVersion;
-    runId: string;
-    ci: CiProvenance;
-    source: UnknownRecord;
-    runtime: UnknownRecord;
-    scenario: UnknownRecord;
-    redaction: RunBundleRedaction;
-}

package/dist/evidence/file-evidence.d.ts

@@ -1,23 +0,0 @@
-import { type ArtifactTask, type PersistedArtifactReference } from "./artifacts.js";
-export interface FileEvidenceInput {
-    readonly path: string;
-    readonly name: string;
-    readonly kind: string;
-    readonly contentType?: string;
-    readonly summary?: string;
-    readonly data?: unknown;
-    readonly metadata?: unknown;
-}
-export interface FileEvidenceBudget {
-    consume(sizeBytes: number): void;
-    maximumBytes(): number;
-    remainingBytes(): number;
-}
-export declare function fileEvidenceBudgetError(maximumBytes: number): Error;
-export declare function persistFileEvidence({ artifactRoot, artifacts, productDir, task, fileEvidenceBudget, }: Readonly<{
-    artifactRoot: string;
-    artifacts: readonly FileEvidenceInput[];
-    productDir: string;
-    task: Readonly<ArtifactTask>;
-    fileEvidenceBudget?: FileEvidenceBudget;
-}>): PersistedArtifactReference[];

package/dist/evidence/finalization.d.ts

@@ -1,9 +0,0 @@
-export interface CommittedRunFinalization {
-    artifactStatus: "failed" | "interrupted" | "passed";
-    interruptReason: null | string;
-}
-export interface RunFinalizationInterruption {
-    interruptReason: null | string;
-    interrupted: boolean;
-}
-export declare function resolveCommittedRunFinalization(artifactStatus: "failed" | "passed", interruption: Readonly<RunFinalizationInterruption>): CommittedRunFinalization;

package/dist/evidence/index.d.ts

@@ -1,8 +0,0 @@
-export { normalizeArtifactArchiveConfig, type NormalizedArtifactArchiveConfig, type NormalizedArtifactPublicationConfig, type NormalizedArtifactRetentionConfig, } from "./artifact-config.js";
-export { finalizeLiveRunArtifact, loadTimings, persistTaskArtifacts, persistTaskFileArtifacts, persistTaskOutputArtifacts, resetResultArtifacts, saveTimings, writeLiveRunArtifact, writeRunArtifact, type ArtifactTask, type PersistedArtifactReference, type WriteRunArtifactOptions, } from "./artifacts.js";
-export { applyRunBundleRetention, listRunBundles, loadRunBundleArtifact, loadRunBundleManifest, loadVerifiedRunBundleArtifactIfExists, publishRunBundle, sealRunBundle, verifyRunBundle, type RunBundleVerification, } from "./bundles.js";
-export { collectArtifactEntries, loadCurrentRunArtifact, loadLatestRunArtifact, loadRunArtifact, type CollectedArtifactEntry, type RunArtifactFileSubject, type RunArtifactPayload, } from "./reading.js";
-export { DEFAULT_REPORTED_ARCHIVE_CONFIG, type BuildLiveRunArtifactOptions, type BuildRunArtifactOptions, type ReportedRunArtifact, type ReportedRunService, type ReportingArtifactReference, type ReportingDiagnostic, type ReportingExecution, type ReportingFailureDetail, type ReportingFailureLocation, type ReportingFailureRequest, type ReportingFailureResponse, type ReportingFileSummary, type ReportingMetadata, type ReportingOperationTiming, type ReportingOperationTimingInput, type ReportingRecord, type ReportingRuntimeBatch, type ReportingRuntimeReset, type ReportingServiceLogReference, type ReportingServiceSummary, type ReportingSetupLogReference, type ReportingSetupOperation, type ReportingSuiteSelector, type ReportingSuiteSummary, type RunArtifactDocument, type RunArtifactFile, type RunArtifactRun, type RunArtifactService, type RunArtifactSuite, type RunArtifactSummary, type RunServiceResult, } from "./reporting-types.js";
-export { copyRegularFileSecurely, MAX_PERSISTED_FILE_ARTIFACT_BYTES, type SecureFileCopyOptions, type SecureFileCopyResult, } from "./secure-file-copy.js";
-export { collectTestkitStorageInventory } from "./storage-inventory.js";
-export { type Timings, type TimingUpdate } from "./timing.js";