@gfdelarue/testkit 0.3.0

package/dist/evidence/contracts.d.ts

@@ -0,0 +1,162 @@
+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 RunBundleUploadFile extends RunBundleManifestEntry {
+    absolutePath: string;
+}
+export interface VerifiedRunBundleUpload {
+    files: RunBundleUploadFile[];
+    manifest: RunBundleManifest;
+    runId: string;
+}
+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/contracts.js

@@ -0,0 +1 @@
+export const BUNDLE_SCHEMA_VERSION=2,PROVENANCE_SCHEMA_VERSION=3,RETENTION_DECISION_SCHEMA_VERSION=1,OBJECTS_DIRNAME="objects",RUNS_DIRNAME="runs";

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

@@ -0,0 +1,23 @@
+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/file-evidence.js

@@ -0,0 +1 @@
+import u from"node:path";import{persistTaskFileArtifacts as y}from"./artifacts.js";export function fileEvidenceBudgetError(i){return new Error(`Engine file evidence exceeds the ${i.toString()} byte per-task or per-invocation budget`)}export function persistFileEvidence({artifactRoot:i,artifacts:s,productDir:m,task:a,fileEvidenceBudget:n}){return s.map((e,d)=>{if(!u.isAbsolute(e.path))throw new Error(`Engine evidence artifact[${d.toString()}] path must be absolute`);const t=n?.remainingBytes();if(t!==void 0&&t<=0)throw fileEvidenceBudgetError(n?.maximumBytes()??0);const r=[],[p]=y(m,a,[{contentType:e.contentType??null,kind:e.kind,name:e.name,path:e.path,summary:e.summary??null}],{copyResults:r,...t===void 0?{}:{maxBytes:t},...n===void 0?{}:{sizeLimitDescription:`remaining engine file-evidence aggregate budget within the ${n.maximumBytes().toString()} byte per-task or per-invocation limit`},sourceRoot:i}),o=r.at(0);if(o===void 0)throw new Error("Engine file evidence copy did not report its size");return n?.consume(o.sizeBytes),{...p,...e.data===void 0?{}:{data:e.data},...e.metadata===void 0?{}:{metadata:e.metadata}}})}

package/dist/evidence/finalization.d.ts

@@ -0,0 +1,9 @@
+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/finalization.js

@@ -0,0 +1 @@
+export function resolveCommittedRunFinalization(e,t){return t.interrupted?{artifactStatus:"interrupted",interruptReason:t.interruptReason}:{artifactStatus:e,interruptReason:null}}

package/dist/evidence/index.d.ts

@@ -0,0 +1,8 @@
+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, prepareVerifiedRunBundleUpload, publishRunBundle, sealRunBundle, verifyRunBundle, type RunBundleVerification, type VerifiedRunBundleUpload, } 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";

package/dist/evidence/index.js

@@ -0,0 +1 @@
+export{normalizeArtifactArchiveConfig}from"./artifact-config.js";export{finalizeLiveRunArtifact,loadTimings,persistTaskArtifacts,persistTaskFileArtifacts,persistTaskOutputArtifacts,resetResultArtifacts,saveTimings,writeLiveRunArtifact,writeRunArtifact}from"./artifacts.js";export{applyRunBundleRetention,listRunBundles,loadRunBundleArtifact,loadRunBundleManifest,loadVerifiedRunBundleArtifactIfExists,prepareVerifiedRunBundleUpload,publishRunBundle,sealRunBundle,verifyRunBundle}from"./bundles.js";export{collectArtifactEntries,loadCurrentRunArtifact,loadLatestRunArtifact,loadRunArtifact}from"./reading.js";export{DEFAULT_REPORTED_ARCHIVE_CONFIG}from"./reporting-types.js";export{copyRegularFileSecurely,MAX_PERSISTED_FILE_ARTIFACT_BYTES}from"./secure-file-copy.js";export{collectTestkitStorageInventory}from"./storage-inventory.js";export{}from"./timing.js";

package/dist/evidence/logs.d.ts

@@ -0,0 +1,31 @@
+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/logs.js

@@ -0,0 +1,2 @@
+import p from"fs";import i from"path";const S="logs",N="setup";export function createRunLogRegistry(r){const m=new Map,s=new Map,n=new Set;function L(e){const t=i.join(r,e.path);p.mkdirSync(i.dirname(t),{recursive:!0});const a=p.createWriteStream(t,{fd:p.openSync(t,"a"),flags:"a"});return n.add(a),{...e,write(o){a.write(o)}}}return{ensureServiceLogRecord(e){const t=`${e.runtimeLabel||e.name}:${e.name}`,a=m.get(t);if(a)return a;const o=`${l(e.runtimeLabel||e.name)}__${l(e.name)}.log`,c=i.join(".testkit","results",S,o),u=L({serviceName:e.name,runtimeLabel:e.runtimeLabel||e.name,path:b(c)});return m.set(t,u),u},ensureSetupLogRecord(e,t){const a=`${e.runtimeLabel||e.name}:${e.name}:${t}`,o=s.get(a);if(o)return o;const c=`${l(e.runtimeLabel||e.name)}__${l(e.name)}__${l(t)}.log`,u=i.join(".testkit","results",N,c),v=L({serviceName:e.name,runtimeLabel:e.runtimeLabel||e.name,stage:t,path:b(u)});return s.set(a,v),v},append(e,t,a){!e||typeof a!="string"||e.write(`${new Date().toISOString()} [${t}] ${a}
+`)},listServiceLogs(){return[...m.values()].map(e=>({serviceName:e.serviceName,runtimeLabel:e.runtimeLabel,path:e.path})).sort((e,t)=>e.serviceName.localeCompare(t.serviceName)||e.runtimeLabel.localeCompare(t.runtimeLabel))},listSetupLogs(){return[...s.values()].map(e=>({serviceName:e.serviceName,runtimeLabel:e.runtimeLabel,stage:e.stage,path:e.path})).sort((e,t)=>e.serviceName.localeCompare(t.serviceName)||e.runtimeLabel.localeCompare(t.runtimeLabel)||e.stage.localeCompare(t.stage))},async closeAll(){await Promise.all([...n].map(e=>$(e)))}}}function l(r){return r.trim().toLowerCase().replace(/[^a-z0-9._-]+/g,"-").replace(/^-+|-+$/g,"")||"log"}function b(r){return r.split(i.sep).join("/")}function $(r){return!r||r.destroyed||r.closed?Promise.resolve():new Promise(m=>{let s=!1;const n=()=>{s||(s=!0,r.off("close",n),r.off("error",n),m())};r.once("close",n),r.once("error",n),r.end()})}

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

@@ -0,0 +1,60 @@
+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/operation-timings.js

@@ -0,0 +1 @@
+import{performance as y}from"node:perf_hooks";import{attachErrorOperation as R}from"../kernel/error-serialization.js";import{formatOperationSummary as b}from"../domain/operation-display.js";const g=String;export function createOperationTimingRegistry({onChange:t=null}={}){const r=[],i=new Map;let f=1;function d(e=[]){if(!t)return;const a=[],u=new Set;for(const s of e)!s||u.has(s.id)||(u.add(s.id),a.push(p(s)));t(a,I())}function l({name:e,kind:a="operation",source:u="testkit",summary:s=null,scope:o=null,parentId:n=null,metadata:m=null}){const c={id:`operation-${g(f++)}`,source:u,name:k(e),kind:a,summary:s,scope:h(o),parentId:n,status:"running",startedAt:new Date().toISOString(),updatedAt:null,finishedAt:null,durationMs:null,error:null,message:null,logRefs:[],metadata:h(m),_startedMonotonicMs:y.now()};return r.push(c),i.set(c.id,c),d([c,...A(c)]),c}function w(e,{summary:a,message:u,metadata:s=null,logRefs:o=null}={}){const n=typeof e=="string"?i.get(e):e;return n?(n.updatedAt=new Date().toISOString(),a!==void 0&&(n.summary=a),u!==void 0&&(n.message=u),s!==null&&(n.metadata={...n.metadata,...h(s)}),o!==null&&(n.logRefs=M(o)),d([n,...A(n)]),p(n)):null}function O(e,{status:a="passed",summary:u,error:s=null,metadata:o=null}={}){const n=typeof e=="string"?i.get(e):e;return n?(n.finishedAt=new Date().toISOString(),n.updatedAt=n.finishedAt,n.durationMs=Math.max(0,Math.round(y.now()-n._startedMonotonicMs)),n.status=a,u!==void 0&&(n.summary=u),s!==null&&(n.error=g(s)),o!==null&&(n.metadata={...n.metadata,...h(o)}),d([n,...A(n)]),p(n)):null}function $(e={}){const a=x(e,f++),u=i.get(a.id);return u?(Object.assign(u,a),d([u,...A(u)]),p(u)):(r.push(a),i.set(a.id,a),d([a,...A(a)]),p(a))}function I(){return r.map(e=>p(e))}return{start:l,update:w,finish:O,record:$,listOperations:I,countOperations(){return r.length}};function A(e){if(!e.parentId)return[];const a=[],u=new Date().toISOString();let s=i.get(e.parentId);const o=new Set([e.id]);for(;s&&s.status==="running"&&!o.has(s.id);){o.add(s.id),s.updatedAt=u;const n=e.status||"unknown",m=n==="running"?"activeChild":"lastChild";s.message=z(e),s.metadata={...s.metadata,[`${m}OperationId`]:e.id,[`${m}OperationName`]:e.name,[`${m}OperationKind`]:e.kind,[`${m}OperationStatus`]:n,[`${m}OperationSummary`]:e.summary||""},a.push(s),s=s.parentId?i.get(s.parentId):void 0}return a}}export async function timeOperation(t,r,i){if(!t)return i();const f=t.start(r);try{const d=await i(f);return t.finish(f,{status:"passed"}),d}catch(d){const l=t.finish(f,{status:"failed",error:N(d)});throw R(d,l),d}}function x(t,r){const i=S(t.startedAt)||new Date().toISOString(),f=t.status||"passed",d=f==="running"?null:S(t.finishedAt)||i,l=t.durationMs,w=Number(l),O=l!=null&&Number.isFinite(w)?Math.max(0,Math.round(w)):d?Math.max(0,Date.parse(d)-Date.parse(i)):null;return{id:t.id||`operation-${g(r)}`,source:t.source||"testkit",name:k(t.name),kind:t.kind||"operation",summary:t.summary||null,scope:h(t.scope),parentId:t.parentId||null,status:f,startedAt:i,updatedAt:S(t.updatedAt)||null,finishedAt:d,durationMs:O,error:t.error||null,message:t.message||null,logRefs:M(t.logRefs),metadata:h(t.metadata),_startedMonotonicMs:y.now()-(O||0)}}function p(t){return{id:t.id,source:t.source,name:t.name,kind:t.kind,summary:t.summary,scope:t.scope,parentId:t.parentId,status:t.status,startedAt:t.startedAt,updatedAt:t.updatedAt,finishedAt:t.finishedAt,durationMs:t.durationMs,error:t.error,message:t.message,logRefs:M(t.logRefs),metadata:t.metadata}}function k(t){const r=g(t||"").trim();if(!r)throw new Error("operation timing name is required");return r}function h(t){return D(t)?{...t}:{}}function M(t){return Array.isArray(t)?t.map(r=>D(r)?{...r}:r):[]}function z(t){const r=b(t),i=typeof r=="string"?r:"";return i?`${t.name} ${t.status||"unknown"} - ${i}`:`${t.name} ${t.status||"unknown"}`}function S(t){const r=Date.parse(t||"");return Number.isFinite(r)?new Date(r).toISOString():null}function D(t){return t!==null&&typeof t=="object"&&!Array.isArray(t)}function N(t){return(typeof t!="object"||t===null)&&typeof t!="function"?g(t):Reflect.get(t,"message")||g(t)}

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

@@ -0,0 +1,4 @@
+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-bundle.js

@@ -0,0 +1 @@
+import I from"fs";import C from"path";import{BUNDLE_SCHEMA_VERSION as E}from"./contracts.js";import{readRunDocument as M}from"./read-run.js";import{readRetentionDecision as U}from"./read-retention.js";import{readBundleRedaction as v}from"./read-redaction.js";import{requireObjectRecord as c,requireString as o,optionalStringValue as $,requireSha256 as p,requireExactString as g,optionalNonNegativeNumber as R,optionalBoolean as w,optionalNullableStringValue as P,requireUnknownArray as W,requireNonNegativeInteger as h,requireManifestRelativePath as _}from"./read-fields.js";import{resolveRunBundleDirectory as k,readJsonFile as O,requireRunId as x,normalizeRunId as S,bundleRelativePath as y}from"./storage.js";export function readRunBundleArtifact(r,t){const e=k(r,t),n=C.join(e,"run.json");if(!I.existsSync(n))throw new Error(`No immutable Testkit run bundle found for ${t}`);return parseRunBundleArtifact(O(n),n,t)}export function parseRunBundleArtifact(r,t,e){const n=M(r,t),i=x(n);if(e!==void 0&&i!==e)throw new Error(`${t}.run id must match requested run id "${e}"`);if(n.archive===void 0)throw new Error(`${t} must contain an archive object`);const s=z(n.archive,`${t}.archive`,i);return{...n,archive:s}}function z(r,t,e){const n=c(r,t),i=o(n.integrity,`${t}.integrity`);if(i!=="sha256")throw new Error(`${t}.integrity must be "sha256"`);const s=o(n.status,`${t}.status`);if(s!=="complete")throw new Error(`${t}.status must be "complete"`);const u=$(n.manifestDigest,`${t}.manifestDigest`);u!==void 0&&p(u,`${t}.manifestDigest`);const f=n.storage===void 0?void 0:q(n.storage,`${t}.storage`),m=n.retention===void 0?void 0:U(n.retention,`${t}.retention`),a=S(o(n.runId,`${t}.runId`));if(a!==e)throw new Error(`${t}.runId must match run id "${e}"`);const d=D(n.schemaVersion,`${t}.schemaVersion`),V=g(n.canonicalRunPath,`${t}.canonicalRunPath`,y(a,"run.json")),N=g(n.manifestPath,`${t}.manifestPath`,y(a,"manifest.json")),A=g(n.provenancePath,`${t}.provenancePath`,y(a,"provenance.json"));if(n.cleanup!==void 0&&j(n.cleanup,`${t}.cleanup`),n.latest!==void 0){const B=c(n.latest,`${t}.latest`);j(B,`${t}.latest`),o(B.path,`${t}.latest.path`)}return{...n,canonicalRunPath:V,integrity:i,manifestPath:N,provenancePath:A,publication:F(n.publication,`${t}.publication`),redaction:v(n.redaction,`${t}.redaction`),runId:a,schemaVersion:d,status:s,...u===void 0?{}:{manifestDigest:u},...f===void 0?{}:{storage:f},...m===void 0?{}:{retention:m}}}function F(r,t){const e=c(r,t),n=o(e.status,`${t}.status`);if(n!=="complete"&&n!=="failed"&&n!=="not_configured"&&n!=="pending")throw new Error(`${t}.status is not supported`);return R(e.bundleBytes,`${t}.bundleBytes`),R(e.bytesUploaded,`${t}.bytesUploaded`),w(e.configured,`${t}.configured`),$(e.error,`${t}.error`),P(e.manifestDigest,`${t}.manifestDigest`),w(e.required,`${t}.required`),w(e.reused,`${t}.reused`),P(e.target,`${t}.target`),{...e,status:n}}export function parseRunBundleManifest(r,t,e){const n=c(r,t),i=o(n.algorithm,`${t}.algorithm`);if(i!=="sha256")throw new Error(`${t}.algorithm must be "sha256"`);const s=[],u=new Set;for(const[m,a]of W(n.files,`${t}.files`).entries()){const d=H(a,`${t}.files[${String(m)}]`);if(u.has(d.path))throw new Error(`${t}.files contains duplicate path "${d.path}"`);u.add(d.path),s.push(d)}const f=S(o(n.runId,`${t}.runId`));if(e!==void 0&&f!==e)throw new Error(`${t}.runId must match requested run id "${e}"`);return{...n,algorithm:i,createdAt:o(n.createdAt,`${t}.createdAt`),digest:p(n.digest,`${t}.digest`),files:s,redaction:v(n.redaction,`${t}.redaction`),runId:f,schemaVersion:D(n.schemaVersion,`${t}.schemaVersion`),storage:q(n.storage,`${t}.storage`)}}function H(r,t){const e=c(r,t);return{...e,bytes:h(e.bytes,`${t}.bytes`),path:_(e.path,`${t}.path`),sha256:p(e.sha256,`${t}.sha256`)}}function q(r,t){const e=c(r,t);return{...e,deduplicatedBytes:h(e.deduplicatedBytes,`${t}.deduplicatedBytes`),fileCount:h(e.fileCount,`${t}.fileCount`),logicalBytes:h(e.logicalBytes,`${t}.logicalBytes`),objectBytesWritten:h(e.objectBytesWritten,`${t}.objectBytesWritten`)}}function D(r,t){if(r!==E)throw new Error(`${t} must be ${String(E)}`);return r}function j(r,t){const e=c(r,t),n=e.status;if(n!=="complete"&&n!=="failed")throw new Error(`${t}.status must be "complete" or "failed"`);return{status:n,error:$(e.error,`${t}.error`)}}

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

@@ -0,0 +1,22 @@
+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 isObjectRecord(value: unknown): value is UnknownRecord;
+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-fields.js

@@ -0,0 +1 @@
+import i from"path";export function requireObjectRecord(r,n){if(!isObjectRecord(r))throw new Error(`${n} must be an object`);return r}export function requireUnknownArray(r,n){if(!Array.isArray(r))throw new Error(`${n} must be an array`);return r}export function requireString(r,n){if(typeof r!="string"||r.length===0)throw new Error(`${n} must be a non-empty string`);return r}export function requireResultsReferencePath(r,n){const e=requireString(r,n),t=e.split("/");if(i.isAbsolute(e)||i.win32.isAbsolute(e)||e.includes("\\")||e.includes("\0")||i.posix.normalize(e)!==e||t.some(o=>o==="."||o==="..")||!e.startsWith(".testkit/results/"))throw new Error(`${n} must be a normalized relative path within .testkit/results`);return e}export function optionalStringValue(r,n){if(r!==void 0){if(typeof r!="string")throw new Error(`${n} must be a string`);return r}}export function optionalNullableStringValue(r,n){if(r!==void 0){if(r===null)return null;if(typeof r!="string")throw new Error(`${n} must be a string or null`);return r}}export function requireNumber(r,n){if(typeof r!="number"||!Number.isFinite(r))throw new Error(`${n} must be a finite number`);return r}export function optionalNumberOrStringValue(r,n){if(r!==void 0)return typeof r=="string"?r:requireNumber(r,n)}export function optionalNullableNumberValue(r,n){if(r!==void 0)return r===null?null:requireNumber(r,n)}export function isObjectRecord(r){return typeof r=="object"&&r!==null&&!Array.isArray(r)}export function requireExactString(r,n,e){const t=requireString(r,n);if(t!==e)throw new Error(`${n} must be "${e}"`);return t}export function requireSha256(r,n){const e=requireString(r,n);if(!/^[a-f0-9]{64}$/u.test(e))throw new Error(`${n} must be a lowercase SHA-256 digest`);return e}export function requireManifestRelativePath(r,n){const e=requireString(r,n),t=e.split("/");if(i.isAbsolute(e)||i.win32.isAbsolute(e)||e.includes("\\")||e.includes("\0")||i.posix.normalize(e)!==e||t.some(o=>o==="."||o===".."))throw new Error(`${n} must be a normalized relative bundle path`);return e}export function requireNonNegativeNumber(r,n){if(typeof r!="number"||!Number.isFinite(r)||r<0)throw new Error(`${n} must be a non-negative number`);return r}export function requireNonNegativeInteger(r,n){const e=requireNonNegativeNumber(r,n);if(!Number.isInteger(e))throw new Error(`${n} must be a non-negative integer`);return e}export function optionalNonNegativeNumber(r,n){if(r!==void 0)return requireNonNegativeNumber(r,n)}export function optionalNullableNumber(r,n){return r==null?null:requireNonNegativeNumber(r,n)}export function requireBoolean(r,n){if(typeof r!="boolean")throw new Error(`${n} must be a boolean`);return r}export function optionalBoolean(r,n){if(r!==void 0)return requireBoolean(r,n)}export function requireStringArray(r,n){if(!Array.isArray(r))throw new Error(`${n} must be an array of strings`);const e=[];for(const t of r){if(typeof t!="string")throw new Error(`${n} must be an array of strings`);e.push(t)}return e}

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

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

package/dist/evidence/read-provenance.js

@@ -0,0 +1 @@
+import{PROVENANCE_SCHEMA_VERSION as c}from"./contracts.js";import{requireObjectRecord as e,requireString as m,optionalNullableStringValue as t}from"./read-fields.js";import{readBundleRedaction as $}from"./read-redaction.js";export function readRunProvenance(d,r,u){const n=e(d,r);if(n.schemaVersion!==c)throw new Error(`${r}.schemaVersion must be ${String(c)}`);const s=m(n.runId,`${r}.runId`);if(s!==u)throw new Error(`${r}.runId must match requested run id "${u}"`);const o=e(n.ci,`${r}.ci`),i=o.provider;if(i!==null&&i!=="github"&&i!=="gitlab"&&i!=="other")throw new Error(`${r}.ci.provider is not supported`);return{...n,schemaVersion:c,runId:s,ci:{provider:i,actor:t(o.actor,`${r}.ci.actor`)??null,eventName:t(o.eventName,`${r}.ci.eventName`)??null,runId:t(o.runId,`${r}.ci.runId`)??null,runUrl:t(o.runUrl,`${r}.ci.runUrl`)??null},source:e(n.source,`${r}.source`),runtime:e(n.runtime,`${r}.runtime`),scenario:e(n.scenario,`${r}.scenario`),redaction:$(n.redaction,`${r}.redaction`)}}

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

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

package/dist/evidence/read-redaction.js

@@ -0,0 +1 @@
+import{requireObjectRecord as i,optionalNonNegativeNumber as o,requireNonNegativeNumber as n,requireStringArray as u,requireString as c,requireBoolean as d}from"./read-fields.js";export function readBundleRedaction(s,e){const t=i(s,e),r=o(t.structuredReplacements,`${e}.structuredReplacements`);return{...t,filesRedacted:n(t.filesRedacted,`${e}.filesRedacted`),policyVersion:n(t.policyVersion,`${e}.policyVersion`),replacements:n(t.replacements,`${e}.replacements`),sensitiveEnvironmentKeys:u(t.sensitiveEnvironmentKeys,`${e}.sensitiveEnvironmentKeys`),status:c(t.status,`${e}.status`),textualFilesScanned:n(t.textualFilesScanned,`${e}.textualFilesScanned`),valuesStored:d(t.valuesStored,`${e}.valuesStored`),...r===void 0?{}:{structuredReplacements:r}}}

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

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

package/dist/evidence/read-retention.js

@@ -0,0 +1 @@
+import{RETENTION_DECISION_SCHEMA_VERSION as R}from"./contracts.js";import{requireObjectRecord as a,requireString as t,optionalStringValue as h,requireUnknownArray as $,requireBoolean as w,requireNonNegativeNumber as y,optionalNullableNumber as S,requireStringArray as f}from"./read-fields.js";export function readRetentionDecision(s,r){const e=a(s,r),u=t(e.status,`${r}.status`);if(u!=="complete"&&u!=="failed")throw new Error(`${r}.status must be "complete" or "failed"`);const c=h(e.error,`${r}.error`),o=a(e.policy,`${r}.policy`),g=a(e.garbageCollection,`${r}.garbageCollection`),p=e.ledger===void 0?void 0:a(e.ledger,`${r}.ledger`),I=$(e.removed,`${r}.removed`).map((d,m)=>E(d,`${r}.removed[${String(m)}]`)),C=$(e.removalErrors,`${r}.removalErrors`).map((d,m)=>{const n=`${r}.removalErrors[${String(m)}]`,i=a(d,n);return{...E(i,n),error:t(i.error,`${n}.error`),path:t(i.path,`${n}.path`),removed:w(i.removed,`${n}.removed`)}}),x=$(g.failures,`${r}.garbageCollection.failures`).map((d,m)=>{const n=`${r}.garbageCollection.failures[${String(m)}]`,i=a(d,n);return{error:t(i.error,`${n}.error`),path:t(i.path,`${n}.path`)}}),v=h(p?.error,`${r}.ledger.error`);return{...e,currentRunId:t(e.currentRunId,`${r}.currentRunId`),decidedAt:t(e.decidedAt,`${r}.decidedAt`),garbageCollection:{failures:x,reclaimedBytes:y(g.reclaimedBytes,`${r}.garbageCollection.reclaimedBytes`),removedObjects:y(g.removedObjects,`${r}.garbageCollection.removedObjects`),status:l(g.status,`${r}.garbageCollection.status`)},...p===void 0?{}:{ledger:{path:t(p.path,`${r}.ledger.path`),status:l(p.status,`${r}.ledger.status`),...v===void 0?{}:{error:v}}},policy:{maxAgeDays:S(o.maxAgeDays,`${r}.policy.maxAgeDays`),maxRuns:S(o.maxRuns,`${r}.policy.maxRuns`),preserveSuites:f(o.preserveSuites,`${r}.policy.preserveSuites`)},protectedRunIds:f(e.protectedRunIds,`${r}.protectedRunIds`),removed:I,removalErrors:C,schemaVersion:A(e.schemaVersion,`${r}.schemaVersion`),status:u,...c===void 0?{}:{error:c}}}function E(s,r){const e=a(s,r),u=f(e.reasons,`${r}.reasons`);if(u.some(o=>o!=="max_age"&&o!=="max_runs"))throw new Error(`${r}.reasons contains an unsupported value`);const c=[];for(const o of u)(o==="max_age"||o==="max_runs")&&c.push(o);return{reasons:c,runId:t(e.runId,`${r}.runId`)}}function l(s,r){const e=t(s,r);if(e!=="complete"&&e!=="failed"&&e!=="not_started")throw new Error(`${r} must be "complete", "failed", or "not_started"`);return e}function A(s,r){if(s!==R)throw new Error(`${r} must be ${String(R)}`);return s}

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

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

package/dist/evidence/read-run.js

@@ -0,0 +1 @@
+import{isEngineId as w,isPublicTestType as q,isRunnerProfileId as S}from"../domain/identifiers.js";import{isEngineProfileIdentity as T}from"../engines/catalog.js";import{requireObjectRecord as r,requireNumber as m,requireStringArray as B,optionalBoolean as y,optionalNonNegativeNumber as p,isObjectRecord as E,requireUnknownArray as h,requireString as c,requireResultsReferencePath as k,optionalStringValue as s,optionalNullableStringValue as a,optionalNumberOrStringValue as L,optionalNullableNumberValue as v}from"./read-fields.js";export function readRunDocument(n,t){const e=r(n,t);if(e.schemaVersion!==19)throw new Error(`${t}.schemaVersion must be 19`);const i=M(e.run,`${t}.run`),o=f(e.services,`${t}.services`,P)??[];e.archive!==void 0&&r(e.archive,`${t}.archive`),e.finalizationFailure!==void 0&&X(e.finalizationFailure,`${t}.finalizationFailure`),s(e.generatedAt,`${t}.generatedAt`);const d=K(e.summary,`${t}.summary`),u=e.logs===void 0?void 0:x(e.logs,`${t}.logs`),g=e.setup===void 0?void 0:V(e.setup,`${t}.setup`);return{...e,schemaVersion:19,...d===void 0?{}:{summary:d},run:i,services:o,...u===void 0?{}:{logs:u},...g===void 0?{}:{setup:g}}}function M(n,t){const e=r(n,t);return v(e.durationMs,`${t}.durationMs`),f(e.types,`${t}.types`,c),{...e,finishedAt:a(e.finishedAt,`${t}.finishedAt`)??null,id:a(e.id,`${t}.id`)??null,startedAt:c(e.startedAt,`${t}.startedAt`),status:c(e.status,`${t}.status`)}}function x(n,t){const e=r(n,t),i=f(e.services,`${t}.services`,H),o=f(e.setup,`${t}.setup`,F);return{...e,...i===void 0?{}:{services:i},...o===void 0?{}:{setup:o}}}function V(n,t){const e=r(n,t),i=f(e.operations,`${t}.operations`,J);return{...e,...i===void 0?{}:{operations:i}}}function P(n,t){const e=r(n,t),i=f(e.suites,`${t}.suites`,D)??[];return{...e,name:c(e.name,`${t}.name`),suites:i}}function D(n,t){const e=r(n,t);if(e.testType!=="scenario"&&!q(e.testType))throw new Error(`${t}.testType must be a public test type`);if(!w(e.engineId))throw new Error(`${t}.engineId must be a supported engine id`);if(!S(e.profileId))throw new Error(`${t}.profileId must be a supported runner profile id`);if(!(e.testType==="scenario"?e.engineId==="k6"&&e.profileId==="k6-http":T(e)))throw new Error(`${t}.profileId does not match ${e.engineId}/${e.testType}`);const o=f(e.files,`${t}.files`,O);return y(e.failed,`${t}.failed`),A(e.diagnostics,`${t}.diagnostics`),p(e.completedFileCount,`${t}.completedFileCount`),p(e.failedFileCount,`${t}.failedFileCount`),p(e.fileCount,`${t}.fileCount`),p(e.passedFileCount,`${t}.passedFileCount`),p(e.skippedFileCount,`${t}.skippedFileCount`),{...e,files:o,name:c(e.name,`${t}.name`),testType:e.testType,engineId:e.engineId,profileId:e.profileId}}function O(n,t){const e=r(n,t),i=f(e.artifacts,`${t}.artifacts`,j),o=f(e.failureDetails,`${t}.failureDetails`,z);return y(e.blockedByRuntime,`${t}.blockedByRuntime`),y(e.failed,`${t}.failed`),y(e.infraFailed,`${t}.infraFailed`),a(e.reason,`${t}.reason`),a(e.runtimeIsolation,`${t}.runtimeIsolation`),e.runtimeBatch!=null&&Q(e.runtimeBatch,`${t}.runtimeBatch`),f(e.runtimeResets,`${t}.runtimeResets`,W),{...e,error:a(e.error,`${t}.error`),artifacts:i,durationMs:v(e.durationMs,`${t}.durationMs`),failureDetails:o,path:c(e.path,`${t}.path`),status:c(e.status,`${t}.status`)}}function j(n,t){const e=r(n,t);return{...e,contentType:a(e.contentType,`${t}.contentType`),kind:a(e.kind,`${t}.kind`),summary:a(e.summary,`${t}.summary`),name:c(e.name,`${t}.name`),path:k(e.path,`${t}.path`)}}function z(n,t){const e=r(n,t),i=e.request===void 0?void 0:U(e.request,`${t}.request`),o=e.response===void 0?void 0:G(e.response,`${t}.response`),d=e.location===void 0?void 0:r(e.location,`${t}.location`);return d!==void 0&&(s(d.path,`${t}.location.path`),d.line!==void 0&&m(d.line,`${t}.location.line`),d.column!==void 0&&m(d.column,`${t}.location.column`)),{...e,key:s(e.key,`${t}.key`),kind:s(e.kind,`${t}.kind`),message:s(e.message,`${t}.message`),stack:s(e.stack,`${t}.stack`),location:d,request:i,response:o,title:c(e.title,`${t}.title`)}}function U(n,t){const e=r(n,t);return{...e,method:s(e.method,`${t}.method`),path:s(e.path,`${t}.path`),requestId:s(e.requestId,`${t}.requestId`)}}function G(n,t){const e=r(n,t);return{...e,bodyPreview:s(e.bodyPreview,`${t}.bodyPreview`),contentType:s(e.contentType,`${t}.contentType`),status:L(e.status,`${t}.status`)}}function H(n,t){const e=r(n,t);return{...e,path:k(e.path,`${t}.path`),runtimeLabel:c(e.runtimeLabel,`${t}.runtimeLabel`),serviceName:c(e.serviceName,`${t}.serviceName`)}}function J(n,t){const e=r(n,t),i=e.logRef==null?e.logRef:F(e.logRef,`${t}.logRef`);return{...e,durationMs:v(e.durationMs,`${t}.durationMs`),error:a(e.error,`${t}.error`),summary:a(e.summary,`${t}.summary`),logRef:i,serviceName:c(e.serviceName,`${t}.serviceName`),stage:c(e.stage,`${t}.stage`),startedAt:s(e.startedAt,`${t}.startedAt`),status:c(e.status,`${t}.status`)}}function F(n,t){const e=r(n,t);return s(e.runtimeLabel,`${t}.runtimeLabel`),s(e.serviceName,`${t}.serviceName`),s(e.stage,`${t}.stage`),{...e,path:k(e.path,`${t}.path`)}}function K(n,t){if(n===void 0)return;const e=r(n,t),i=e.files===void 0?{}:r(e.files,`${t}.files`),o=e.services===void 0?{}:r(e.services,`${t}.services`),d=e.suites===void 0?{}:r(e.suites,`${t}.suites`),u=(g,I,N)=>{const $=g[I];if($===void 0)return 0;if(typeof $!="number"||!Number.isFinite($)||$<0)throw new Error(`${t}.${N}.${I} must be a non-negative finite number`);return $};return A(e.diagnostics,`${t}.diagnostics`),{...e,files:{blockedByRuntime:u(i,"blockedByRuntime","files"),cancelled:u(i,"cancelled","files"),failed:u(i,"failed","files"),infraFailed:u(i,"infraFailed","files"),interrupted:u(i,"interrupted","files"),notRun:u(i,"notRun","files"),passed:u(i,"passed","files"),skipped:u(i,"skipped","files"),total:u(i,"total","files")},services:{blockedByRuntime:u(o,"blockedByRuntime","services"),failed:u(o,"failed","services"),infraFailed:u(o,"infraFailed","services"),passed:u(o,"passed","services"),skipped:u(o,"skipped","services"),total:u(o,"total","services")},suites:{completed:u(d,"completed","suites"),failed:u(d,"failed","suites"),passed:u(d,"passed","suites"),skipped:u(d,"skipped","suites"),total:u(d,"total","suites")}}}function A(n,t){if(n!==void 0)return h(n,t).map((e,i)=>{const o=`${t}[${String(i)}]`,d=r(e,o);return{...d,code:c(d.code,`${o}.code`),message:c(d.message,`${o}.message`),service:s(d.service,`${o}.service`),suite:s(d.suite,`${o}.suite`)}})}function Q(n,t){const e=r(n,t);return{...e,id:s(e.id,`${t}.id`),fileCount:p(e.fileCount,`${t}.fileCount`),index:p(e.index,`${t}.index`),files:e.files===void 0?void 0:B(e.files,`${t}.files`)}}function W(n,t){const e=r(n,t);return{...e,position:s(e.position,`${t}.position`),reason:s(e.reason,`${t}.reason`),runtimeIsolation:s(e.runtimeIsolation,`${t}.runtimeIsolation`),trigger:s(e.trigger,`${t}.trigger`)}}function X(n,t){const e=r(n,t),i=e.operation===void 0?void 0:r(e.operation,`${t}.operation`);return{...e,name:c(e.name,`${t}.name`),message:c(e.message,`${t}.message`),code:s(e.code,`${t}.code`),stack:s(e.stack,`${t}.stack`),phase:s(e.phase,`${t}.phase`),exitCode:e.exitCode===void 0?void 0:m(e.exitCode,`${t}.exitCode`),status:e.status===void 0?void 0:m(e.status,`${t}.status`),diagnostics:e.diagnostics===void 0?void 0:R(e.diagnostics,`${t}.diagnostics`),operation:i===void 0?void 0:{...i,id:s(i.id,`${t}.operation.id`),source:c(i.source,`${t}.operation.source`),name:c(i.name,`${t}.operation.name`),kind:c(i.kind,`${t}.operation.kind`),summary:s(i.summary,`${t}.operation.summary`),status:s(i.status,`${t}.operation.status`),error:s(i.error,`${t}.operation.error`),scope:R(i.scope,`${t}.operation.scope`)}}}function R(n,t){return Object.fromEntries(Object.entries(r(n,t)).map(([e,i])=>[e,C(i,`${t}.${e}`)]))}function C(n,t){return n===null||typeof n=="string"||typeof n=="boolean"?n:Array.isArray(n)?h(n,t).map((e,i)=>C(e,`${t}[${String(i)}]`)):E(n)?R(n,t):m(n,t)}function f(n,t,e){return n===void 0?void 0:h(n,t).map((i,o)=>e(i,`${t}[${String(o)}]`))}

package/dist/evidence/reading.d.ts

@@ -0,0 +1,28 @@
+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): CollectedArtifactEntry[];
+export {};

package/dist/evidence/reading.js

@@ -0,0 +1 @@
+import u from"fs";import l from"path";import{normalizeEngineJsonValue as w}from"../engines/api/index.js";import{readJsonFile as m,normalizePath as $}from"./storage.js";import{loadRunBundleArtifact as v}from"./bundles.js";import{readRunDocument as d}from"./read-run.js";import{requireObjectRecord as k,requireResultsReferencePath as P,optionalStringValue as h,optionalNullableStringValue as c}from"./read-fields.js";export function loadLatestRunArtifact(r){const t=l.join(r,".testkit","results","latest.json");if(!u.existsSync(t))throw new Error(`No run artifact found at ${l.relative(r,t)}`);return d(m(t),t)}export function loadCurrentRunArtifact(r){const t=l.join(r,".testkit","results","live.json");return u.existsSync(t)?d(m(t),t):loadLatestRunArtifact(r)}export function loadRunArtifact(r,t=null){return t?v(r,t):loadLatestRunArtifact(r)}export function resolveFileSubject(r,t=null,e=null){const n=p(r,e);if(n.length===0)throw new Error("No file results were found in the latest run artifact.");if(!t)return n.find(s=>s.file.status==="failed")||n[0];const i=$(t),o=n.filter(s=>s.file.path===i);if(o.length===1)return o[0];if(o.length>1)throw new Error(`Multiple files matched "${t}". Re-run with --service to disambiguate.`);const a=n.filter(s=>s.file.path.endsWith(`/${i}`));if(a.length===1)return a[0];throw a.length>1?new Error(`Multiple files matched "${t}". Re-run with --service to disambiguate.`):new Error(`No file matched "${t}".`)}export function collectArtifactEntries(r,t,e=null,n=null){const i=e?[resolveFileSubject(t,e,n)]:p(t,n),o=[];for(const a of i)for(const s of a.file.artifacts||[]){const f=A(r,s.path,`artifact "${s.name}" path`),x=u.existsSync(f)?S(f,s):null;o.push({...a,artifactRef:s,absolutePath:f,payload:x})}return o}function S(r,t){const e=u.readFileSync(r,"utf8"),n=t.contentType||"";if(n==="text/markdown"||n==="text/plain")return{contentType:n,kind:t.kind||null,name:t.name||null,summary:t.summary||null,text:e};try{const i=JSON.parse(e);return g(i,r)}catch{return{contentType:n||"text/plain",kind:t.kind||null,name:t.name||null,summary:t.summary||null,text:e}}}function p(r,t=null){const e=[];for(const n of r.services)if(!(t&&n.name!==t))for(const i of n.suites)for(const o of i.files||[])e.push({service:n,suite:i,file:o});return e}function g(r,t){const e=k(r,t),n=h(e.emittedAt,`${t}.emittedAt`);return{...e,contentType:c(e.contentType,`${t}.contentType`),...e.data===void 0?{}:{data:w(e.data,`${t}.data`)},...n===void 0?{}:{emittedAt:n},kind:c(e.kind,`${t}.kind`),name:c(e.name,`${t}.name`),summary:c(e.summary,`${t}.summary`),text:h(e.text,`${t}.text`)}}function A(r,t,e){const n=P(t,e),i=l.resolve(r,".testkit","results"),o=l.resolve(r,n);if(y(i,o,e),u.existsSync(o)){const a=u.realpathSync(i),s=u.realpathSync(o);y(a,s,e)}return o}function y(r,t,e){const n=l.relative(r,t);if(n.length===0||n===".."||n.startsWith(`..${l.sep}`)||l.isAbsolute(n))throw new Error(`${e} must resolve within .testkit/results`)}