@gfdelarue/testkit 0.4.5 → 0.6.0

package/dist/evidence/logs.d.ts

@@ -1,31 +0,0 @@
-import type { ReportingServiceLogReference, ReportingSetupLogReference } from "./index.js";
-export interface RunLogServiceConfig {
-    name: string;
-    runtimeLabel?: string | null;
-}
-export interface ServiceLogRecord extends ServiceLogReference {
-    write(chunk: string): void;
-}
-export interface SetupLogRecord extends ServiceLogRecord {
-    stage: string;
-}
-export interface ServiceLogReference extends ReportingServiceLogReference {
-    path: string;
-    runtimeLabel: string;
-    serviceName: string;
-}
-export interface SetupLogReference extends ReportingSetupLogReference {
-    path: string;
-    runtimeLabel: string;
-    serviceName: string;
-    stage: string;
-}
-export interface RunLogRegistry {
-    append(record: ServiceLogRecord | SetupLogRecord | null | undefined, streamName: string, line: unknown): void;
-    closeAll(): Promise<void>;
-    ensureServiceLogRecord(config: Readonly<RunLogServiceConfig>): ServiceLogRecord;
-    ensureSetupLogRecord(config: Readonly<RunLogServiceConfig>, stage: string): SetupLogRecord;
-    listServiceLogs(): ServiceLogReference[];
-    listSetupLogs(): SetupLogReference[];
-}
-export declare function createRunLogRegistry(productDir: string): RunLogRegistry;

package/dist/evidence/operation-timings.d.ts

@@ -1,60 +0,0 @@
-import type { ReportingOperationTimingInput, ReportingRecord } from "./index.js";
-export interface OperationTiming extends ReportingOperationTimingInput {
-    durationMs: number | null;
-    error: string | null;
-    finishedAt: string | null;
-    id: string;
-    kind: string;
-    logRefs: unknown[];
-    message: string | null;
-    metadata: ReportingRecord;
-    name: string;
-    parentId: string | null;
-    scope: ReportingRecord;
-    source: string;
-    startedAt: string;
-    status: string;
-    summary: string | null;
-    updatedAt: string | null;
-}
-export interface OperationTimingSpan extends OperationTiming {
-    _startedMonotonicMs: number;
-}
-export interface OperationTimingStartOptions {
-    kind?: string;
-    metadata?: ReportingRecord | null;
-    name: string;
-    parentId?: string | null;
-    scope?: ReportingRecord | null;
-    source?: string;
-    summary?: string | null;
-}
-export interface OperationTimingUpdateOptions {
-    logRefs?: unknown[] | null;
-    message?: string | null;
-    metadata?: ReportingRecord | null;
-    summary?: string | null;
-}
-export interface OperationTimingFinishOptions {
-    error?: unknown;
-    metadata?: ReportingRecord | null;
-    status?: string;
-    summary?: string | null;
-}
-export type OperationTimingTarget = OperationTimingSpan | string;
-export type OperationTimingChangeHandler = (changedOperations: OperationTiming[], allOperations: OperationTiming[]) => void;
-export interface CreateOperationTimingRegistryOptions {
-    onChange?: OperationTimingChangeHandler | null;
-}
-export interface OperationTimingRegistry {
-    countOperations(): number;
-    finish(target: OperationTimingTarget | null | undefined, options?: OperationTimingFinishOptions): OperationTiming | null;
-    listOperations(): OperationTiming[];
-    record(operation?: ReportingOperationTimingInput): OperationTiming;
-    start(options: OperationTimingStartOptions): OperationTimingSpan;
-    update(target: OperationTimingTarget | null | undefined, options?: OperationTimingUpdateOptions): OperationTiming | null;
-}
-type TimedOperation = (span?: OperationTimingSpan) => unknown;
-export declare function createOperationTimingRegistry({ onChange, }?: CreateOperationTimingRegistryOptions): OperationTimingRegistry;
-export declare function timeOperation<Operation extends TimedOperation>(registry: OperationTimingRegistry | null | undefined, options: OperationTimingStartOptions, operation: Operation): Promise<Awaited<ReturnType<Operation>>>;
-export {};

package/dist/evidence/read-bundle.d.ts

@@ -1,4 +0,0 @@
-import { type RunBundleArtifact, type RunBundleManifest } from "./contracts.js";
-export declare function readRunBundleArtifact(productDir: string, runId: string): RunBundleArtifact;
-export declare function parseRunBundleArtifact(value: unknown, label: string, expectedRunId?: string): RunBundleArtifact;
-export declare function parseRunBundleManifest(value: unknown, label: string, expectedRunId?: string): RunBundleManifest;

package/dist/evidence/read-fields.d.ts

@@ -1,21 +0,0 @@
-type UnknownRecord = Record<string, unknown>;
-export declare function requireObjectRecord(value: unknown, label: string): UnknownRecord;
-export declare function requireUnknownArray(value: unknown, label: string): unknown[];
-export declare function requireString(value: unknown, label: string): string;
-export declare function requireResultsReferencePath(value: unknown, label: string): string;
-export declare function optionalStringValue(value: unknown, label: string): string | undefined;
-export declare function optionalNullableStringValue(value: unknown, label: string): null | string | undefined;
-export declare function requireNumber(value: unknown, label: string): number;
-export declare function optionalNumberOrStringValue(value: unknown, label: string): number | string | undefined;
-export declare function optionalNullableNumberValue(value: unknown, label: string): null | number | undefined;
-export declare function requireExactString(value: unknown, label: string, expected: string): string;
-export declare function requireSha256(value: unknown, label: string): string;
-export declare function requireManifestRelativePath(value: unknown, label: string): string;
-export declare function requireNonNegativeNumber(value: unknown, label: string): number;
-export declare function requireNonNegativeInteger(value: unknown, label: string): number;
-export declare function optionalNonNegativeNumber(value: unknown, label: string): number | undefined;
-export declare function optionalNullableNumber(value: unknown, label: string): null | number;
-export declare function requireBoolean(value: unknown, label: string): boolean;
-export declare function optionalBoolean(value: unknown, label: string): boolean | undefined;
-export declare function requireStringArray(value: unknown, label: string): string[];
-export {};

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

@@ -1,2 +0,0 @@
-import { type RunBundleProvenance } from "./contracts.js";
-export declare function readRunProvenance(value: unknown, label: string, expectedRunId: string): RunBundleProvenance;

package/dist/evidence/read-redaction.d.ts

@@ -1,2 +0,0 @@
-import type { RunBundleRedaction } from "./contracts.js";
-export declare function readBundleRedaction(value: unknown, label: string): RunBundleRedaction;

package/dist/evidence/read-retention.d.ts

@@ -1,2 +0,0 @@
-import { type RunBundleRetentionDecision } from "./contracts.js";
-export declare function readRetentionDecision(value: unknown, label: string): RunBundleRetentionDecision;

package/dist/evidence/read-run.d.ts

@@ -1,2 +0,0 @@
-import type { RunArtifactDocument } from "./reporting-types.js";
-export declare function readRunDocument(value: unknown, label: string): RunArtifactDocument;

package/dist/evidence/reading.d.ts

@@ -1,28 +0,0 @@
-import { type EngineRuntimeArtifactPayload } from "../engines/api/index.js";
-import type { ReportingArtifactReference, RunArtifactDocument, RunArtifactFile, RunArtifactService, RunArtifactSuite } from "./reporting-types.js";
-type UnknownRecord = Record<string, unknown>;
-export interface RunArtifactFileSubject {
-    file: RunArtifactFile;
-    service: RunArtifactService;
-    suite: RunArtifactSuite;
-}
-export interface RunArtifactPayload extends UnknownRecord {
-    contentType?: null | EngineRuntimeArtifactPayload["contentType"];
-    data?: EngineRuntimeArtifactPayload["data"];
-    emittedAt?: EngineRuntimeArtifactPayload["emittedAt"];
-    kind?: null | EngineRuntimeArtifactPayload["kind"];
-    name?: null | EngineRuntimeArtifactPayload["name"];
-    summary?: null | EngineRuntimeArtifactPayload["summary"];
-    text?: string;
-}
-export interface CollectedArtifactEntry extends RunArtifactFileSubject {
-    absolutePath: string;
-    artifactRef: ReportingArtifactReference;
-    payload: RunArtifactPayload | null;
-}
-export declare function loadLatestRunArtifact(productDir: string): RunArtifactDocument;
-export declare function loadCurrentRunArtifact(productDir: string): RunArtifactDocument;
-export declare function loadRunArtifact(productDir: string, runId?: null | string): RunArtifactDocument;
-export declare function resolveFileSubject(runArtifact: RunArtifactDocument, selector?: null | string, serviceFilter?: null | string): RunArtifactFileSubject;
-export declare function collectArtifactEntries(productDir: string, runArtifact: RunArtifactDocument, selector?: null | string, serviceFilter?: null | string, kindFilter?: string, includePayload?: boolean): CollectedArtifactEntry[];
-export {};

package/dist/evidence/reporting-types.d.ts

@@ -1,349 +0,0 @@
-import type { NormalizedArtifactArchiveConfig } from "./artifact-config.js";
-import type { EngineId, PublicTestType, RunnerProfileId } from "../domain/identifiers.js";
-import type { SerializedError } from "../kernel/error-serialization.js";
-export type ReportingRecord = Record<string, unknown>;
-export interface ReportingFailureRequest extends ReportingRecord {
-    method?: string;
-    path?: string;
-    requestId?: string;
-}
-export interface ReportingFailureResponse extends ReportingRecord {
-    bodyPreview?: string;
-    contentType?: string;
-    status?: number | string;
-}
-export interface ReportingFailureLocation extends ReportingRecord {
-    column?: number;
-    line?: number;
-    path?: string;
-}
-export interface ReportingFailureDetail extends ReportingRecord {
-    key?: string;
-    kind?: string;
-    location?: ReportingFailureLocation;
-    message?: string;
-    request?: ReportingFailureRequest;
-    response?: ReportingFailureResponse;
-    stack?: string;
-    title: string;
-}
-export interface ReportingArtifactReference extends ReportingRecord {
-    contentType?: null | string;
-    kind?: null | string;
-    name: string;
-    path: string;
-    summary?: null | string;
-}
-export interface ReportingRuntimeBatch extends ReportingRecord {
-    fileCount?: number;
-    files?: string[];
-    id?: string;
-    index?: number;
-}
-export interface ReportingRuntimeReset extends ReportingRecord {
-    position?: string;
-    reason?: string;
-    runtimeIsolation?: string;
-    trigger?: string;
-}
-export interface RunArtifactFile extends ReportingRecord {
-    artifacts?: ReportingArtifactReference[];
-    blockedByRuntime?: boolean;
-    durationMs?: null | number;
-    error?: null | string;
-    failed?: boolean;
-    failureDetails?: ReportingFailureDetail[];
-    infraFailed?: boolean;
-    path: string;
-    reason?: null | string;
-    runtimeBatch?: null | ReportingRuntimeBatch;
-    runtimeIsolation?: null | string;
-    runtimeResets?: ReportingRuntimeReset[];
-    status: string;
-}
-export interface ReportingDiagnostic extends ReportingRecord {
-    code: string;
-    message: string;
-    service?: string;
-    suite?: string;
-}
-export interface RunArtifactSuite extends ReportingRecord {
-    completedFileCount?: number;
-    diagnostics?: ReportingDiagnostic[];
-    engineId: EngineId;
-    failed?: boolean;
-    failedFileCount?: number;
-    fileCount?: number;
-    files?: RunArtifactFile[];
-    name: string;
-    passedFileCount?: number;
-    profileId: RunnerProfileId;
-    skippedFileCount?: number;
-    testType: PublicTestType | "scenario";
-}
-export interface RunServiceResult extends ReportingRecord {
-    failed: boolean;
-    name: string;
-    skipped: boolean;
-    suites: RunArtifactSuite[];
-    blockedByRuntime?: boolean;
-    completedFileCount: number;
-    completedSuiteCount: number;
-    dbBackend?: null | string;
-    diagnostics?: ReportingDiagnostic[];
-    durationMs: number;
-    errorDetails?: ReportingRecord[];
-    errors: string[];
-    failedFileCount: number;
-    failedSuiteCount: number;
-    infraFailed?: boolean;
-    notRunFileCount: number;
-    passedFileCount: number;
-    skippedFileCount: number;
-    skippedSuiteCount: number;
-    suiteCount: number;
-    totalFileCount: number;
-    totalTaskDurationMs: number;
-}
-export interface RunArtifactService extends ReportingRecord {
-    name: string;
-    suites: RunArtifactSuite[];
-}
-export interface ReportedRunService extends RunServiceResult {
-    blockedByRuntime: boolean;
-    infraFailed: boolean;
-}
-export interface ReportingServiceLogReference extends ReportingRecord {
-    path: string;
-    runtimeLabel: string;
-    serviceName: string;
-}
-export interface ReportingEnvironmentServiceAttempt extends ReportingRecord {
-    outcome: string;
-    port: number;
-}
-export interface ReportingEnvironmentService extends ReportingRecord {
-    attempts: ReportingEnvironmentServiceAttempt[];
-    baseUrl: string;
-    port: number;
-    readyUrl: null | string;
-    runtimeLabel: string;
-    serviceName: string;
-}
-export interface ReportingSetupLogReference extends ReportingRecord {
-    path: string;
-    runtimeLabel?: string;
-    serviceName?: string;
-    stage?: string;
-}
-export interface ReportingSetupOperation extends ReportingRecord {
-    durationMs?: null | number;
-    error?: null | string;
-    logRef?: null | ReportingSetupLogReference;
-    serviceName: string;
-    stage: string;
-    startedAt?: string;
-    status: string;
-    summary?: null | string;
-}
-export interface ReportingOperationTimingInput extends ReportingRecord {
-    durationMs?: null | number;
-    error?: null | string;
-    finishedAt?: null | string;
-    id?: null | string;
-    kind?: string;
-    logRefs?: unknown[];
-    message?: null | string;
-    metadata?: ReportingRecord;
-    name?: string;
-    parentId?: null | string;
-    scope?: ReportingRecord;
-    source?: string;
-    startedAt?: null | string;
-    status?: string;
-    summary?: null | string;
-    updatedAt?: null | string;
-}
-export interface ReportingOperationTiming extends ReportingRecord {
-    durationMs: null | number;
-    error: null | string;
-    finishedAt: null | string;
-    id: null | string;
-    kind: string;
-    logRefs: unknown[];
-    message: null | string;
-    metadata: ReportingRecord;
-    name: string;
-    parentId: null | string;
-    scope: ReportingRecord;
-    source: string;
-    startedAt: null | string;
-    status: string;
-    summary: null | string;
-    updatedAt: null | string;
-}
-export interface ReportingGitRepository {
-    host: string;
-    name: string;
-    owner: string;
-}
-export interface ReportingRunGitMetadata extends ReportingRecord {
-    branch: null | string;
-    commitSha: null | string;
-    dirty: boolean;
-    pullRequest: null | number;
-    pullRequestHeadSha: null | string;
-    repository: null | ReportingGitRepository;
-}
-export interface ReportingMetadata {
-    git: ReportingRecord & {
-        branch?: null | string;
-        commitSha?: null | string;
-        dirty?: boolean;
-        pullRequest?: null | number;
-        pullRequestHeadSha?: null | string;
-        repository?: null | ReportingGitRepository;
-    };
-    host?: ReportingRecord;
-    testkitVersion: string;
-}
-export interface ReportingExecution {
-    fileTimeoutSeconds: number;
-    taskConcurrency: number;
-}
-export interface ReportingSuiteSelector extends ReportingRecord {
-    raw: string;
-}
-export interface RunArtifactRun extends ReportingRecord {
-    durationMs?: null | number;
-    types?: string[];
-    finishedAt: null | string;
-    id: null | string;
-    startedAt: string;
-    status: string;
-}
-export interface RunArtifactDocument extends ReportingRecord {
-    generatedAt?: string;
-    summary?: RunArtifactSummary;
-    schemaVersion: 19;
-    archive?: ReportingRecord;
-    environment?: {
-        services?: ReportingEnvironmentService[];
-    };
-    finalizationFailure?: SerializedError;
-    logs?: {
-        services?: ReportingServiceLogReference[];
-        setup?: ReportingSetupLogReference[];
-    };
-    run: RunArtifactRun;
-    services: RunArtifactService[];
-    setup?: {
-        operations?: ReportingSetupOperation[];
-    };
-}
-export interface ReportedRunArtifact extends RunArtifactDocument {
-    archive: {
-        declaredEnvironmentKeys: string[];
-        request: NormalizedArtifactArchiveConfig;
-    };
-    environment: {
-        services: ReportingEnvironmentService[];
-    };
-    generatedAt: string;
-    git: ReportingRunGitMetadata;
-    logs: {
-        services: ReportingServiceLogReference[];
-        setup: ReportingSetupLogReference[];
-    };
-    product: {
-        directory: string;
-        name: string;
-    };
-    run: RunArtifactRun & {
-        dbBackend: null | string;
-        durationMs: null | number;
-        fileNames: string[];
-        fileTimeoutSeconds: number;
-        runtimeInstanceCount: number;
-        runtimeStats: unknown[];
-        serviceFilter: null | string;
-        suiteSelectors: string[];
-        testkitVersion: string;
-        types: string[];
-        workerCount: number;
-        workers: number;
-    };
-    schemaVersion: 19;
-    services: ReportedRunService[];
-    setup: {
-        operations: ReportingSetupOperation[];
-    };
-    source: "testkit";
-    summary: RunArtifactSummary;
-    timings: {
-        operations: ReportingOperationTiming[];
-    };
-}
-export interface ReportingServiceSummary {
-    blockedByRuntime: number;
-    failed: number;
-    infraFailed: number;
-    passed: number;
-    skipped: number;
-    total: number;
-}
-export interface ReportingSuiteSummary {
-    completed: number;
-    failed: number;
-    passed: number;
-    skipped: number;
-    total: number;
-}
-export interface ReportingFileSummary {
-    blockedByRuntime: number;
-    cancelled: number;
-    failed: number;
-    infraFailed: number;
-    interrupted: number;
-    notRun: number;
-    passed: number;
-    skipped: number;
-    total: number;
-}
-export interface RunArtifactSummary extends ReportingRecord {
-    diagnostics?: ReportingDiagnostic[];
-    files: ReportingFileSummary;
-    services: ReportingServiceSummary;
-    suites: ReportingSuiteSummary;
-}
-export interface BuildRunArtifactOptions {
-    archiveConfig?: NormalizedArtifactArchiveConfig | null;
-    declaredEnvironmentKeys?: readonly string[];
-    environmentServices?: readonly ReportingEnvironmentService[];
-    execution: ReportingExecution;
-    fileNames: readonly string[];
-    finishedAt: null | number;
-    metadata: ReportingMetadata;
-    operationTimings?: readonly ReportingOperationTimingInput[];
-    planning?: null | ReportingRecord;
-    productDir: string;
-    results: readonly RunServiceResult[];
-    runId?: null | string;
-    runInterruptReason?: null | string;
-    runStatus?: null | string;
-    runtimeInstanceCount: number;
-    runtimeStats?: readonly unknown[];
-    serviceFilter: null | string;
-    serviceLogs?: readonly ReportingServiceLogReference[];
-    setupLogs?: readonly ReportingSetupLogReference[];
-    setupOperations?: readonly ReportingSetupOperation[];
-    startedAt: number;
-    suiteSelectors: readonly ReportingSuiteSelector[];
-    summarizeDbBackend: (results: readonly RunServiceResult[]) => unknown;
-    typeValues: readonly string[];
-    workerCount: number;
-}
-export type BuildLiveRunArtifactOptions = Omit<BuildRunArtifactOptions, "finishedAt" | "runStatus"> & {
-    updatedAt: number;
-};
-export declare const DEFAULT_REPORTED_ARCHIVE_CONFIG: NormalizedArtifactArchiveConfig;

package/dist/evidence/reporting.d.ts

@@ -1,3 +0,0 @@
-import { type BuildLiveRunArtifactOptions, type BuildRunArtifactOptions, type ReportedRunArtifact } from "./reporting-types.js";
-export declare function buildRunArtifact({ productDir, runId, results, startedAt, finishedAt, execution, workerCount, runtimeInstanceCount, runtimeStats, typeValues, suiteSelectors, fileNames, serviceFilter, planning, archiveConfig, declaredEnvironmentKeys, metadata, summarizeDbBackend, environmentServices, serviceLogs, setupLogs, setupOperations, operationTimings, runInterruptReason, runStatus, }: BuildRunArtifactOptions): ReportedRunArtifact;
-export declare function buildLiveRunArtifact({ productDir, runId, results, startedAt, updatedAt, execution, workerCount, runtimeInstanceCount, runtimeStats, typeValues, suiteSelectors, fileNames, serviceFilter, planning, archiveConfig, declaredEnvironmentKeys, metadata, summarizeDbBackend, environmentServices, serviceLogs, setupLogs, setupOperations, operationTimings, }: BuildLiveRunArtifactOptions): ReportedRunArtifact;

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

@@ -1,24 +0,0 @@
-export declare const MAX_PERSISTED_FILE_ARTIFACT_BYTES: number;
-export interface SecureFileCopyOptions {
-    /**
-     * Test and narrower-call-site seam. Values may lower, but never raise, the
-     * product-wide artifact ceiling.
-     */
-    maxBytes?: number;
-    /** Invoked after the source handle and its identity have been verified. */
-    onSourceOpened?: () => void;
-    /** Describes a narrowed caller-owned byte limit in diagnostics. */
-    sizeLimitDescription?: string;
-    /** When present, the source's canonical path must remain below this root. */
-    sourceRoot?: string;
-}
-export interface SecureFileCopyResult {
-    readonly canonicalSourcePath: string;
-    readonly sizeBytes: number;
-}
-/**
- * Copies one regular file through a single verified source handle. The source
- * must remain the same file for the whole read, and a failed copy never leaves
- * a partial destination behind.
- */
-export declare function copyRegularFileSecurely(sourcePath: string, destinationPath: string, options?: Readonly<SecureFileCopyOptions>): SecureFileCopyResult;

package/dist/evidence/setup-progress.d.ts

@@ -1,63 +0,0 @@
-export interface StepServiceIdentity {
-    name: string;
-    runtimeLabel?: string | null;
-}
-export interface StepLogRecord {
-    path: string;
-    stage: string;
-    write(chunk: string): void;
-}
-export interface StepLogRegistry {
-    ensureSetupLogRecord(config: Readonly<StepServiceIdentity>, stage: string): StepLogRecord;
-}
-export type SetupOperationLogRegistry = StepLogRegistry;
-export interface SetupOperationLogReference {
-    [key: string]: unknown;
-    path: string;
-    stage: string;
-}
-export interface SetupOperationStartInput {
-    config: Readonly<StepServiceIdentity>;
-    kind?: string;
-    parentId?: string | null;
-    recordLog?: boolean;
-    stage: string;
-    summary?: string | null;
-}
-export type SetupOperationCachedInput = Omit<SetupOperationStartInput, "recordLog">;
-export interface SetupOperationFinishInput {
-    error?: unknown;
-    status?: string;
-    summary?: string | null;
-}
-export interface SetupOperationSnapshot {
-    [key: string]: unknown;
-    durationMs: number | null;
-    error: string | null;
-    finishedAt: string | null;
-    id: string;
-    kind: string;
-    logRef: SetupOperationLogReference | null;
-    parentId: string | null;
-    runtimeLabel: string;
-    serviceName: string;
-    stage: string;
-    startedAt: string;
-    status: string;
-    summary: string | null;
-}
-export interface SetupOperationHandle extends SetupOperationSnapshot {
-    _logRecord: StepLogRecord | null;
-}
-export interface SetupOperationRegistry {
-    finish(target: string | SetupOperationHandle | null | undefined, result?: Readonly<SetupOperationFinishInput>): SetupOperationHandle | null;
-    listOperations(): SetupOperationSnapshot[];
-    recordCached(input: Readonly<SetupOperationCachedInput>): SetupOperationHandle;
-    start(input: Readonly<SetupOperationStartInput>): SetupOperationHandle;
-}
-export type SetupOperationChangeHandler = (operations: readonly SetupOperationSnapshot[]) => void;
-export interface CreateSetupOperationRegistryOptions {
-    logRegistry?: SetupOperationLogRegistry | null;
-    onChange?: SetupOperationChangeHandler | null;
-}
-export declare function createSetupOperationRegistry({ logRegistry, onChange, }?: Readonly<CreateSetupOperationRegistryOptions>): SetupOperationRegistry;

package/dist/evidence/step-output.d.ts

@@ -1,16 +0,0 @@
-import type { StepLogRecord } from "./setup-progress.js";
-export interface CaptureStepOutputOptions {
-    livePrefix?: string | null;
-    liveWriter?: ((line: string) => void) | null;
-    logRecord?: StepLogRecord | null;
-}
-interface CapturedStepResult {
-    exitCode: number | null;
-    shortMessage?: string;
-    stdout: string;
-    stderr: string;
-}
-export declare function awaitCapturedResult(result: Readonly<CapturedStepResult>, { livePrefix, liveWriter, logRecord }?: Readonly<CaptureStepOutputOptions>): void;
-export declare function writeCapturedLine(logRecord: StepLogRecord | null, streamName: string, line: string): void;
-export declare function formatCapturedFailure(shortMessage: unknown, stdoutValue: unknown, stderrValue: unknown, fallback: string): string;
-export {};

package/dist/evidence/storage-inventory.d.ts

@@ -1,27 +0,0 @@
-export type TestkitStorageClassification = "content_addressed_evidence" | "duplicate_representation" | "evidence_lifecycle_metadata" | "per_run_scratch" | "retained_run_evidence" | "testkit_state";
-export interface TestkitStoragePathClassification {
-    classification: TestkitStorageClassification;
-    duplicateOf?: string;
-    reason: string;
-}
-export interface TestkitStorageEntry extends TestkitStoragePathClassification {
-    bytes: number;
-    linkCount: number;
-    path: string;
-    unique: boolean;
-}
-export interface TestkitStorageInventory {
-    duplicateRepresentations: TestkitStorageEntry[];
-    largestFileLimit: number;
-    largestFiles: TestkitStorageEntry[];
-    root: string;
-    totalFiles: number;
-    totalLogicalBytes: number;
-    totalUniqueBytes: number;
-}
-export interface TestkitStorageInventoryOptions {
-    largestFileLimit?: number;
-    rootRelativePath?: string;
-}
-export declare function collectTestkitStorageInventory(productDir: string, options?: Readonly<TestkitStorageInventoryOptions>): TestkitStorageInventory;
-export declare function classifyTestkitStoragePath(relativePath: unknown): TestkitStoragePathClassification;

package/dist/evidence/storage.d.ts

@@ -1,25 +0,0 @@
-import crypto from "crypto";
-import type { RunArtifactDocument } from "./reporting-types.js";
-import { type RunBundleArtifact, type UnknownRecord } from "./contracts.js";
-export declare function readJsonFile(filePath: string): unknown;
-export declare function runIncludesFile(artifact: RunBundleArtifact, selector: string): boolean;
-export declare function requireRunId(artifact: RunArtifactDocument): string;
-export declare function normalizeRunId(runId: unknown): string;
-export declare function walkFiles(root: string): string[];
-export declare function treeBytes(root: string): number;
-export declare function writeBufferAtomic(filePath: string, buffer: Buffer): void;
-export declare function writeJson(filePath: string, value: unknown): void;
-export declare function hashFile(filePath: string): string;
-export declare function sha256(value: crypto.BinaryLike): string;
-export declare function stableJson(value: unknown): string;
-export declare function objectRecords(value: unknown): UnknownRecord[];
-export declare function resolveRunBundleDirectory(productDir: string, runId: string): string;
-export declare function resolveRunsRoot(productDir: string, create: boolean): string;
-export declare function requirePublicationPathOutsideResults(productDir: string, candidatePath: string): void;
-export declare function resolveManifestEntryPath(bundleDir: string, relativePath: string): string;
-export declare function optionalStringArray(value: unknown): string[];
-export declare function optionalUnknownArray(value: unknown): unknown[];
-export declare function errorMessage(error: unknown): string;
-export declare function bundleRelativePath(runId: string, child: string): string;
-export declare function resultsRoot(productDir: string): string;
-export declare function sanitizeSegment(value: string): string;