@gfdelarue/testkit 0.4.4 → 0.5.0

package/dist/app/db-schema/refresh.d.ts

@@ -1,17 +0,0 @@
-import type { SourceSchemaDumpResolution } from "../../database/source-url.js";
-import { type ConfiguredStepReporter } from "../../steps/index.js";
-import { type SchemaOperationOptions } from "./prepare.js";
-export type DatabaseSchemaRefreshOptions = SchemaOperationOptions;
-export interface DatabaseSchemaRefreshResult {
-    cacheKey: string;
-    cacheKind: string;
-    envName: null | string;
-    ok: true;
-    outputLabel: string;
-    outputPath: string;
-    productDir: string;
-    reusedExistingRefresh: boolean;
-    service: string;
-    sourceUrl: SourceSchemaDumpResolution["metadata"] | null;
-}
-export declare function executeDatabaseSchemaRefresh(options: Readonly<DatabaseSchemaRefreshOptions>, reporter: ConfiguredStepReporter): Promise<DatabaseSchemaRefreshResult>;

package/dist/app/db-schema/verify.d.ts

@@ -1,11 +0,0 @@
-import { type ConfiguredStepReporter } from "../../steps/index.js";
-import { type SchemaOperationOptions } from "./prepare.js";
-export interface DatabaseSchemaVerifyOptions extends SchemaOperationOptions {
-    "skip-schema-source-verify"?: boolean;
-}
-export interface DatabaseSchemaVerifyResult {
-    ok: true;
-    productDir: string;
-    service: string;
-}
-export declare function executeDatabaseSchemaVerify(options: Readonly<DatabaseSchemaVerifyOptions>, reporter: ConfiguredStepReporter): Promise<DatabaseSchemaVerifyResult>;

package/dist/app/destroy/index.d.ts

@@ -1,16 +0,0 @@
-import { type NormalizedServiceConfig } from "../../config/loader/index.js";
-export interface DestroyOptions {
-    destroyOwnedResources?: boolean;
-}
-export declare function destroy(productDir: string, configs: readonly Readonly<NormalizedServiceConfig>[], options?: Readonly<DestroyOptions>): Promise<void>;
-export declare function destroyEnvironment(options: Readonly<{
-    dir?: string;
-    service?: string;
-}>): Promise<{
-    ok: true;
-    productDir: string;
-    results: Array<{
-        destroyed: true;
-        name: string;
-    }>;
-}>;

package/dist/app/discover/index.d.ts

@@ -1,8 +0,0 @@
-import { type DiscoverTestsOptions, type DiscoveryResult } from "../../config/loader/index.js";
-export interface DiscoverOperationResult extends DiscoveryResult {
-    outputLabel: null | string;
-}
-export declare function executeDiscoverOperation(options: Readonly<Omit<DiscoverTestsOptions, "file"> & {
-    file?: readonly string[];
-    output?: string;
-}>, cwd?: string): Promise<DiscoverOperationResult>;

package/dist/app/doctor/index.d.ts

@@ -1,17 +0,0 @@
-import { type LintViolation } from "../lint/index.js";
-export interface DoctorOptions {
-    dir?: string;
-    typecheck?: boolean;
-}
-export interface DoctorCheck {
-    code: "config-load" | "discovery" | "lint" | "typecheck";
-    details?: LintViolation[] | unknown[];
-    level: "fail" | "pass";
-    message: string;
-}
-export interface DoctorResult {
-    checks: DoctorCheck[];
-    ok: boolean;
-    productDir: string;
-}
-export declare function runDoctor(options?: DoctorOptions): Promise<DoctorResult>;

package/dist/app/file-selection.d.ts

@@ -1 +0,0 @@
-export declare function resolveRequestedFiles(fileNames: unknown, productDir: unknown, invocationCwd?: unknown): string[];

package/dist/app/inspect/artifacts.d.ts

@@ -1,30 +0,0 @@
-export declare function inspectArtifacts(options: Readonly<{
-    dir?: string;
-    mode: "runs" | "verify" | "artifacts";
-    file: string | null;
-    runId: string | null;
-    service: string | null;
-    kind?: string;
-    includePayload?: boolean;
-}>): {
-    mode: "runs";
-    runs: import("../../evidence/contracts.js").RunBundleSummary[];
-    verification?: undefined;
-    runId?: undefined;
-    entries?: undefined;
-} | {
-    runs?: undefined;
-    mode: "verify";
-    runId: string | null;
-    verification: import("../../evidence/contracts.js").RunBundleVerification;
-    entries?: undefined;
-} | {
-    runs?: undefined;
-    verification?: undefined;
-    mode: "artifacts";
-    runId: string | null;
-    entries: import("../../evidence/reading.js").CollectedArtifactEntry[];
-};
-export type ArtifactInspectionEntry = Extract<ReturnType<typeof inspectArtifacts>, {
-    mode: "artifacts";
-}>["entries"][number];

package/dist/app/inspect/index.d.ts

@@ -1,112 +0,0 @@
-export { formatTestTypeLabel } from "../../domain/test-types.js";
-import type { RunArtifactSuite } from "../../evidence/index.js";
-import { type EngineId, type RunnerProfileId } from "../../domain/identifiers.js";
-import { type DiscoveryDiagnostic, type DiscoveryResult, type DiscoverySummary } from "../../config/loader/index.js";
-import type { StatusModel } from "../status/model.js";
-export { discoverTests, fileDisplayName, formatDisplayName, testTypeContract } from "../../config/loader/index.js";
-export type { DiscoverTestsOptions, DiscoveryDiagnostic, DiscoveryFile, DiscoveryResult, DiscoveryService, DiscoverySuite, DiscoverySummary, DiscoveryTestContract, DiscoveryTestType, RuntimeIsolationPolicy, } from "../../config/loader/index.js";
-export { listRunBundles, loadRunBundleArtifact, loadRunBundleManifest, verifyRunBundle } from "../../evidence/index.js";
-export type { RunBundleVerification } from "../../evidence/index.js";
-declare const WORKSPACE_SCHEMA_VERSION: 2;
-export type WorkspaceTargetKind = "file" | "project" | "suite";
-export type WorkspaceTargetSource = "discovery" | "latest" | "live";
-export type WorkspaceRunSource = "latest" | "live";
-export interface WorkspaceTargetRef {
-    detail: string;
-    engineId?: null | EngineId;
-    filePath?: string;
-    id: string;
-    kind: WorkspaceTargetKind;
-    label: string;
-    profileId?: null | RunnerProfileId;
-    runnable: boolean;
-    service?: null | string;
-    source: WorkspaceTargetSource;
-    status?: null | string;
-    suiteName?: null | string;
-    testType?: null | RunArtifactSuite["testType"];
-}
-export interface WorkspaceRunSummary {
-    durationMs: null | number;
-    files: {
-        failed: number;
-        notRun: number;
-        passed: number;
-        skipped: number;
-        total: number;
-    };
-    generatedAt: null | string;
-    id: null | string;
-    services: {
-        failed: number;
-        passed: number;
-        skipped: number;
-        total: number;
-    };
-    source: WorkspaceRunSource;
-    startedAt: null | string;
-    status: string;
-    suites: {
-        completed: number;
-        failed: number;
-        passed: number;
-        skipped: number;
-        total: number;
-    };
-    types: string[];
-}
-export interface WorkspaceRuntimeGraphStatus {
-    currentRuntimeDirCount: number;
-    desired: StatusModel["runtimeGraphs"][number]["desired"];
-    exists: boolean;
-    name: string;
-    orphan: boolean;
-    runtimeDirCount: number;
-    staleRuntimeDirCount: number;
-}
-export interface WorkspaceServiceStatus {
-    caches: StatusModel["caches"];
-    hasState: boolean;
-    name: string;
-    product: StatusModel["product"];
-    runtimeGraphs: WorkspaceRuntimeGraphStatus[];
-    runs: {
-        active: number;
-        stale: number;
-        total: number;
-    };
-    warnings: string[];
-}
-export interface WorkspaceStatus {
-    ok: boolean;
-    results: WorkspaceServiceStatus[];
-}
-export interface WorkspaceInspection {
-    activity: {
-        activeRuns: number;
-        staleRuns: number;
-    };
-    discovery: {
-        configFile: null | string;
-        diagnostics: DiscoveryDiagnostic[];
-        summary: DiscoverySummary;
-    } | null;
-    generatedAt: string;
-    product: DiscoveryResult["product"];
-    runs: {
-        latest: WorkspaceRunSummary | null;
-        live: WorkspaceRunSummary | null;
-    };
-    schemaVersion: typeof WORKSPACE_SCHEMA_VERSION;
-    source: "testkit-workspace";
-    status: WorkspaceStatus;
-    targets: WorkspaceTargetRef[];
-    warnings: string[];
-}
-export interface InspectWorkspaceOptions {
-    dir?: string;
-    service?: null | string;
-    status?: boolean;
-    targetLimit?: number;
-}
-export declare function inspectWorkspace(options?: Readonly<InspectWorkspaceOptions>): Promise<WorkspaceInspection>;

package/dist/app/lint/index.d.ts

@@ -1,28 +0,0 @@
-interface LintOperationFlags {
-    dir?: string;
-}
-export declare function executeLintOperation(flags?: LintOperationFlags): Promise<LintResult>;
-import { type LintOptionsInput, type NormalizedLintOptions } from "./options.js";
-import { type LintFinding } from "./shared.js";
-export interface RunLintOptions extends LintOptionsInput {
-    dir?: string;
-}
-export interface RunLintForConfigOptions {
-    dir?: string;
-}
-export type LintViolation = LintFinding;
-export interface LintSummary {
-    files: number;
-    testkitFiles: number;
-    violations: number;
-}
-export interface LintResult {
-    ok: boolean;
-    productDir: string;
-    summary: LintSummary;
-    violations: LintViolation[];
-}
-export declare function runLint(options?: RunLintOptions): Promise<LintResult>;
-export declare function runLintForConfig(config: unknown, options?: RunLintForConfigOptions): Promise<LintResult>;
-export declare function normalizeLintConfig(config?: unknown): NormalizedLintOptions;
-export {};

package/dist/app/lint/native.d.ts

@@ -1,10 +0,0 @@
-import { type NormalizedLintOptions } from "./options.js";
-import { type LintFinding } from "./shared.js";
-interface LintProjectInput {
-    productDir: string;
-    files: readonly string[];
-    trackedFiles: readonly string[] | null;
-    options: NormalizedLintOptions;
-}
-export declare function lintProject({ productDir, files, trackedFiles, options, }: LintProjectInput): Promise<LintFinding[]>;
-export {};

package/dist/app/lint/options.d.ts

@@ -1,67 +0,0 @@
-export interface LintRulePolicy {
-    allowed?: string[];
-    enabled: boolean;
-    exclude: string[];
-    include: string[];
-    ruleId: string;
-    ruleName: LintRuleName;
-    trackedOnly?: boolean;
-}
-export interface LintRuleOptionsInput {
-    allowed?: readonly string[];
-    enabled?: boolean;
-    exclude?: readonly string[];
-    include?: readonly string[];
-    trackedOnly?: boolean;
-}
-export type LintRuleInput = boolean | LintRuleOptionsInput;
-export interface LintOptionsInput {
-    rules?: Partial<Record<LintRuleName, LintRuleInput>>;
-    ui?: {
-        maxLines?: number;
-        maxTests?: number;
-    };
-}
-export interface NormalizedLintOptions {
-    rules: LintRulePolicies;
-    ui: {
-        maxLines: number;
-        maxTests: number;
-    };
-}
-export declare const LINT_RULE_NAMES: readonly ["engineImports", "uiSpecShape", "dalParallelSafety", "dataSuiteContract", "configImports", "testkitBoundary", "unitTestBoundaries"];
-export type LintRuleName = (typeof LINT_RULE_NAMES)[number];
-export type LintRulePolicies = Record<LintRuleName, LintRulePolicy>;
-export declare function isLintRuleName(value: string): value is LintRuleName;
-export declare const RULES: {
-    readonly engineImports: {
-        readonly ruleId: "engine-imports";
-        readonly defaultEnabled: true;
-    };
-    readonly uiSpecShape: {
-        readonly ruleId: "ui-spec-shape";
-        readonly defaultEnabled: true;
-    };
-    readonly dalParallelSafety: {
-        readonly ruleId: "dal-parallel-safety";
-        readonly defaultEnabled: true;
-    };
-    readonly dataSuiteContract: {
-        readonly ruleId: "data-suite-contract";
-        readonly defaultEnabled: true;
-    };
-    readonly configImports: {
-        readonly ruleId: "config-imports";
-        readonly defaultEnabled: true;
-    };
-    readonly testkitBoundary: {
-        readonly ruleId: "testkit-boundary";
-        readonly defaultEnabled: false;
-    };
-    readonly unitTestBoundaries: {
-        readonly ruleId: "unit-test-boundaries";
-        readonly defaultEnabled: false;
-    };
-};
-export declare function normalizeLintConfig(config?: unknown): NormalizedLintOptions;
-export declare function normalizeLintOptions(options?: LintOptionsInput): NormalizedLintOptions;

package/dist/app/lint/policy.d.ts

@@ -1,21 +0,0 @@
-import type { TSESLint, TSESTree } from "@typescript-eslint/utils";
-import type { NormalizedLintOptions } from "./options.js";
-export type PolicyContext = TSESLint.RuleContext<"violation", []>;
-export type Report = (node: TSESTree.Node, kind: string, target: string, message: string) => void;
-export interface LiteralFact {
-    field: string;
-    value: string;
-    file: string;
-    line: number;
-    snippet: string;
-}
-export interface PolicyInput {
-    context: PolicyContext;
-    file: string;
-    report: Report;
-    options: NormalizedLintOptions;
-    literals: LiteralFact[];
-}
-export declare function stringValue(node: TSESTree.Node | null | undefined): string | null;
-export declare function memberName(node: TSESTree.MemberExpression): string | null;
-export declare function binding(context: PolicyContext, node: TSESTree.Identifier): TSESLint.Scope.Variable | null;

package/dist/app/lint/rules/data.d.ts

@@ -1,3 +0,0 @@
-import type { TSESLint } from "@typescript-eslint/utils";
-import { type PolicyInput } from "../policy.js";
-export declare function createDataPolicy({ context, file, report }: PolicyInput): TSESLint.RuleListener;

package/dist/app/lint/rules/engine-imports.d.ts

@@ -1,3 +0,0 @@
-import type { TSESLint } from "@typescript-eslint/utils";
-import { type PolicyInput } from "../policy.js";
-export declare function createEngineImportPolicy({ context, file, report }: PolicyInput): TSESLint.RuleListener;

package/dist/app/lint/rules/syntax.d.ts

@@ -1,4 +0,0 @@
-import type { TSESLint } from "@typescript-eslint/utils";
-import type { LintRuleName } from "../options.js";
-import { type PolicyInput } from "../policy.js";
-export declare function createSyntaxPolicy(name: LintRuleName, { file, context, report, options, literals }: PolicyInput, files: readonly string[]): TSESLint.RuleListener;

package/dist/app/lint/rules/unit.d.ts

@@ -1,3 +0,0 @@
-import type { TSESLint } from "@typescript-eslint/utils";
-import { type PolicyInput } from "../policy.js";
-export declare function createUnitPolicy({ file, report }: PolicyInput): TSESLint.RuleListener;

package/dist/app/lint/shared.d.ts

@@ -1,36 +0,0 @@
-export interface LintFindingInput {
-    file: string;
-    kind?: string;
-    line?: number;
-    message: string;
-    ruleId: string;
-    ruleName: string;
-    snippet?: string | null;
-    target?: string;
-}
-export interface LintFinding {
-    file: string;
-    kind: string;
-    line: number;
-    message: string;
-    ruleId: string;
-    ruleName: string;
-    snippet?: string;
-    target: string;
-}
-export declare const DEFAULT_EXCLUDED_DIRS: string[];
-export declare const SOURCE_PATTERNS: string[];
-export declare const SOURCE_IGNORES: string[];
-export declare const DEFAULT_TESTKIT_BOUNDARY_ALLOWED: string[];
-export declare function collectCurrentFiles(productDir: string, gitAvailable: boolean): Promise<string[]>;
-export declare function collectTrackedFiles(productDir: string): Promise<string[] | null>;
-export declare function normalizePath(value: string): string;
-export declare function isObjectRecord(value: unknown): value is Record<string, unknown>;
-export declare function isSourceLikePath(file: string): boolean;
-export declare function isTypeScriptLikePath(file: string): boolean;
-export declare function isTestkitSuitePath(file: string): boolean;
-export declare function isExcludedRelativePath(file: string): boolean;
-export declare function matchesAnyPathPattern(file: string, patterns: readonly string[]): boolean;
-export declare function compareFindings(left: LintFinding, right: LintFinding): number;
-export declare function normalizeFinding(finding: LintFindingInput): LintFinding;
-export declare function findingKey(finding: Readonly<LintFinding>): string;

package/dist/app/package-inspection.d.ts

@@ -1,20 +0,0 @@
-export interface PackageVersionInspectionOptions {
-    binUrl?: string | URL;
-    currentPackageRoot?: string;
-    cwd?: string;
-    dir?: string | null;
-}
-export interface PackageVersionMismatch {
-    currentPackageRoot: string;
-    currentVersion: string;
-    declaredSpec: string | null;
-    productDir: string;
-    productPackageRoot: string | null;
-    productVersion: string | null;
-}
-export declare function testkitIdentity(): {
-    description: string;
-    name: string;
-    version: string;
-};
-export declare function inspectPackageVersionDrift(options?: Readonly<PackageVersionInspectionOptions>): PackageVersionMismatch | null;

package/dist/app/run/endpoint-readiness.d.ts

@@ -1,43 +0,0 @@
-import { type EndpointReadinessAttempt } from "../../process/readiness.js";
-import type { NormalizedFailureDetail } from "./failure-details.js";
-export interface EndpointReadinessOptions {
-    attemptTimeoutMs?: number | string;
-    mode?: string;
-    retryDelayMs?: number | string;
-    timeoutMs?: number | string;
-}
-export interface EndpointReadinessLifecycle {
-    isStopRequested(): boolean;
-}
-export interface EndpointReadinessInput {
-    baseUrl: string;
-    env?: NodeJS.ProcessEnv;
-    lifecycle?: EndpointReadinessLifecycle | null;
-    options?: Readonly<EndpointReadinessOptions>;
-    serviceName?: string | null;
-    signal?: AbortSignal;
-}
-export interface EndpointReadinessFailureDetail extends NormalizedFailureDetail {
-    classification: "infra";
-    endpoint: string;
-    key: "http_endpoint_readiness";
-    kind: "http_endpoint_readiness";
-    message: string;
-    service: string | null;
-    title: "HTTP endpoint readiness failed";
-}
-export interface EndpointReadinessSuccess {
-    attempts: EndpointReadinessAttempt[];
-    ok: true;
-    skipped: boolean;
-}
-export interface EndpointReadinessFailure {
-    attempts: EndpointReadinessAttempt[];
-    failureDetails: EndpointReadinessFailureDetail[];
-    ok: false;
-    reason: string;
-    skipped: false;
-}
-export type EndpointReadinessResult = EndpointReadinessFailure | EndpointReadinessSuccess;
-export declare function shouldRunEndpointReadinessPreflight(baseUrl: string, options?: Readonly<EndpointReadinessOptions>, env?: NodeJS.ProcessEnv): boolean;
-export declare function waitForEndpointReadinessPreflight({ baseUrl, serviceName, lifecycle, options, env, signal, }: Readonly<EndpointReadinessInput>): Promise<EndpointReadinessResult>;

package/dist/app/run/endpoint-readiness.js

@@ -1 +0,0 @@
-import{connectEndpoint as E}from"../../process/readiness.js";const P=new Set(["localhost","127.0.0.1","::1"]);export function shouldRunEndpointReadinessPreflight(t,e={},n=process.env){const r=(e.mode||n.TESTKIT_HTTP_ENDPOINT_PREFLIGHT||"auto").trim().toLowerCase();if(["0","false","off","never","disabled"].includes(r))return!1;if(["1","true","on","always","force"].includes(r))return!0;const o=d(t);return!!(o&&!P.has(l(o.host)))}export async function waitForEndpointReadinessPreflight({baseUrl:t,serviceName:e,lifecycle:n=null,options:r={},env:o=process.env,signal:i}){if(!shouldRunEndpointReadinessPreflight(t,r,o))return{ok:!0,skipped:!0,attempts:[]};const s=d(t);if(!s)return T({baseUrl:t,serviceName:e,attempts:[],reason:`HTTP endpoint readiness could not parse ${t||"unknown endpoint"}`});const f=c(r.timeoutMs??o.TESTKIT_HTTP_ENDPOINT_PREFLIGHT_TIMEOUT_MS,3e4),m=c(r.attemptTimeoutMs??o.TESTKIT_HTTP_ENDPOINT_PREFLIGHT_ATTEMPT_TIMEOUT_MS,5e3),_=c(r.retryDelayMs??o.TESTKIT_HTTP_ENDPOINT_PREFLIGHT_RETRY_DELAY_MS,500),u=Date.now()+f,a=[];for(;Date.now()<u;){if(n?.isStopRequested()||i?.aborted)return T({baseUrl:t,serviceName:e,attempts:a,reason:`testkit run interrupted before HTTP endpoint readiness completed for ${t}`});const h=Math.max(1,u-Date.now()),p=await E(s,Math.min(m,h),i);if(a.push(p),p.ok)return{ok:!0,skipped:!1,attempts:a};await w(Math.min(_,Math.max(0,u-Date.now())),i)}return T({baseUrl:t,serviceName:e,attempts:a,reason:`HTTP endpoint for ${e||"unknown"} was not reachable at ${t}`})}function T({baseUrl:t,serviceName:e,attempts:n,reason:r}){const o=n.map(s=>s.error).filter(s=>!!s).slice(-3).join("; "),i=o?`${r}. Last connection failure(s): ${o}`:r;return{ok:!1,skipped:!1,reason:i,attempts:n,failureDetails:[{count:1,kind:"http_endpoint_readiness",key:"http_endpoint_readiness",title:"HTTP endpoint readiness failed",classification:"infra",message:i,service:e||null,endpoint:t}]}}function d(t){try{const e=new URL(t);if(!["http:","https:"].includes(e.protocol))return null;const n=Number(e.port||(e.protocol==="https:"?443:80));return!Number.isInteger(n)||n<=0||n>65535?null:{host:l(e.hostname),port:n}}catch{return null}}function c(t,e){const n=Number(t);return Number.isInteger(n)&&n>0?n:e}function l(t){return t.trim().toLowerCase().replace(/^\[(.*)\]$/u,"$1")}function w(t,e){return e?.aborted?Promise.resolve():new Promise(n=>{const r=setTimeout(o,t);function o(){clearTimeout(r),e?.removeEventListener("abort",o),n()}e?.addEventListener("abort",o,{once:!0})})}

package/dist/app/run/engine-evidence-persistence.d.ts

@@ -1,39 +0,0 @@
-import { type FileEvidenceBudget } from "../../evidence/file-evidence.js";
-import type { EngineEvidence } from "../../engines/api/index.js";
-import { type PersistedArtifactReference } from "../../evidence/index.js";
-import type { ScheduledTask } from "./scheduler/index.js";
-type EvidenceCategory = "artifacts" | "logs" | "metrics" | "native";
-type EvidencePersistenceMode = "observed" | "reconcile";
-export interface EvidenceLedger {
-    readonly countsByCategory: Readonly<Record<EvidenceCategory, Map<string, number>>>;
-    readonly fileEvidence: {
-        maximumBytes: number;
-        persistedBytes: number;
-    };
-}
-interface PersistEvidenceOptions {
-    artifactRoot: string;
-    evidence: EngineEvidence;
-    productDir: string;
-    scope: "invocation" | "task";
-    task: ScheduledTask;
-    fileEvidenceBudget?: FileEvidenceBudget;
-}
-export declare const MAX_ENGINE_FILE_EVIDENCE_BYTES: number;
-interface EvidencePersistenceContext {
-    artifactRoot: string;
-    errors: Error[];
-    ledger: EvidenceLedger;
-    mode: EvidencePersistenceMode;
-    productDir: string;
-    references: PersistedArtifactReference[];
-    scope: "invocation" | "task";
-    task: ScheduledTask;
-}
-export declare function persistEngineEvidence({ artifactRoot, evidence, productDir, scope, task, fileEvidenceBudget, }: Readonly<PersistEvidenceOptions>): PersistedArtifactReference[];
-export declare function persistTrackedEngineEvidence(evidence: Readonly<EngineEvidence>, context: EvidencePersistenceContext): void;
-export declare function createEvidenceLedger(maximumFileEvidenceBytes?: number): EvidenceLedger;
-export declare function requireTaskArtifacts(referencesByTaskId: ReadonlyMap<string, PersistedArtifactReference[]>, taskId: string): PersistedArtifactReference[];
-export declare function requireTaskEvidenceLedger(ledgersByTaskId: ReadonlyMap<string, EvidenceLedger>, taskId: string): EvidenceLedger;
-export declare function contextualError(message: string, cause: unknown): Error;
-export {};

package/dist/app/run/engine-execution-cleanup.d.ts

@@ -1,8 +0,0 @@
-import type { EngineTaskExecutionOutcome } from "./engine-execution.js";
-import type { EngineExecutionCleanupFailure } from "./engine-execution-failures.js";
-export interface PreparedNodeSetupCleanup {
-    cleanup: () => Promise<void>;
-    taskId: string;
-}
-export declare function cleanupPreparedNodeSetups(cleanupStack: readonly Readonly<PreparedNodeSetupCleanup>[]): Promise<EngineExecutionCleanupFailure[]>;
-export declare function applyConsumerNodeSetupCleanupFailures(completedOutcomesByTaskId: Map<string, EngineTaskExecutionOutcome>, cleanupFailures: readonly Readonly<EngineExecutionCleanupFailure>[]): void;

package/dist/app/run/engine-execution-cleanup.js

@@ -1 +0,0 @@
-import{getRuntimeNodeSetupCleanupFailures as i}from"./setup/runtime-node-setup.js";export async function cleanupPreparedNodeSetups(e){const s=[];for(const{cleanup:u,taskId:n}of[...e].reverse())try{await u()}catch(t){const r=i(t);r.length===0?s.push({error:l(t),owner:"testkit",taskId:n}):s.push(...r.map(o=>({...o,taskId:n})))}return s}export function applyConsumerNodeSetupCleanupFailures(e,s){const u=new Map;for(const n of s){if(n.owner!=="consumer")continue;const t=u.get(n.taskId)??[];t.push(n.error),u.set(n.taskId,t)}for(const[n,t]of u){const r=e.get(n);if(r===void 0)continue;const o=`Runtime node setup consumer cleanup failed: ${t.map(a=>a.message).join("; ")}`;e.set(n,{...r,error:r.error===null?o:`${r.error}; ${o}`,failureDetails:[...r.failureDetails,...t.map(c)],reason:null,status:"failed"})}}function c(e){return{actual:{owner:"consumer"},classification:"product",count:1,key:"runtime_node_setup_consumer_cleanup_failed",kind:"runtime-node-setup-cleanup",message:e.message,...e.stack===void 0?{}:{stack:e.stack},title:"Runtime node setup consumer cleanup failed"}}function l(e){return e instanceof Error?e:new Error(String(e))}

package/dist/app/run/engine-execution-failures.d.ts

@@ -1,41 +0,0 @@
-import { type EngineFailureClassification } from "../../engines/api/index.js";
-import type { PersistedArtifactReference } from "../../evidence/index.js";
-import type { EngineTaskExecutionOutcome } from "./engine-execution.js";
-import type { RuntimeNodeSetupCleanupOwner } from "./setup/runtime-node-setup-protocol.js";
-export type EngineExecutionRuntimeImpact = "fail-graph" | "invalidate-lease" | "none";
-export interface EngineExecutionBridgeDisposition {
-    readonly classification: EngineFailureClassification | undefined;
-    readonly notifyRuntimeError: boolean;
-    readonly runtimeImpact: EngineExecutionRuntimeImpact;
-    readonly status: "cancelled" | "failed" | "not_run";
-}
-export interface EngineExecutionCleanupFailure {
-    readonly error: Error;
-    readonly owner: RuntimeNodeSetupCleanupOwner;
-    readonly taskId: string;
-}
-export declare const ENGINE_REPORTER_CALLBACK_CANCELLED_CODE = "TESTKIT_ENGINE_REPORTER_CALLBACK_CANCELLED";
-export declare class EngineExecutionBridgeError extends Error {
-    readonly artifactReferencesByTaskId: ReadonlyMap<string, readonly PersistedArtifactReference[]>;
-    readonly completedOutcomesByTaskId: ReadonlyMap<string, EngineTaskExecutionOutcome>;
-    readonly disposition: EngineExecutionBridgeDisposition;
-    readonly failingTaskId: null | string;
-    readonly cause: unknown;
-    constructor(message: string, cause: unknown, disposition: Readonly<EngineExecutionBridgeDisposition>, artifactReferencesByTaskId: ReadonlyMap<string, readonly PersistedArtifactReference[]>, completedOutcomesByTaskId?: ReadonlyMap<string, EngineTaskExecutionOutcome>, failingTaskId?: null | string);
-}
-export declare class EngineExecutionReporterCallbackError extends Error {
-    readonly cancelled: boolean;
-    readonly cause: unknown;
-    constructor(phase: "taskFinished" | "taskStarted", cause: unknown);
-}
-export declare function executeManagedEngineRequest<Request, Result>(manager: Readonly<{
-    execute(request: Readonly<Request>): Promise<Result>;
-}>, request: Readonly<Request>): Promise<Result>;
-export declare function buildBridgeError(operationErrors: readonly Error[], cleanupFailures: readonly Readonly<EngineExecutionCleanupFailure>[], disposition: Readonly<EngineExecutionBridgeDisposition>, artifactReferencesByTaskId: ReadonlyMap<string, readonly PersistedArtifactReference[]>, completedOutcomesByTaskId: ReadonlyMap<string, EngineTaskExecutionOutcome>, activeTaskId: null | string): EngineExecutionBridgeError;
-export declare function resolveBridgeDisposition(operationErrors: readonly Error[], cleanupFailures: readonly Readonly<EngineExecutionCleanupFailure>[], observedInfraOperationFailure: boolean, activeFailureDisposition: Readonly<EngineExecutionBridgeDisposition>): EngineExecutionBridgeDisposition;
-export declare function managerFailureBridgeDisposition(parentSignal: AbortSignal, invocationSignal: AbortSignal, error: unknown): EngineExecutionBridgeDisposition;
-export declare function runtimeNodeSetupBridgeDisposition(error: unknown): EngineExecutionBridgeDisposition;
-export declare function cancelledBridgeDisposition(): EngineExecutionBridgeDisposition;
-export declare function infraBridgeDisposition(runtimeImpact?: EngineExecutionRuntimeImpact): EngineExecutionBridgeDisposition;
-export declare function reporterBridgeDisposition(runtimeImpact?: EngineExecutionRuntimeImpact): EngineExecutionBridgeDisposition;
-export declare function productBridgeDisposition(runtimeImpact?: EngineExecutionRuntimeImpact): EngineExecutionBridgeDisposition;

package/dist/app/run/engine-execution-observer.d.ts

@@ -1,21 +0,0 @@
-import type { EngineExecutionObserver, EngineTaskOutcome } from "../../engines/api/index.js";
-import type { PersistedArtifactReference } from "../../evidence/index.js";
-import { type EvidenceLedger } from "./engine-evidence-persistence.js";
-import type { EngineExecutableTask, EngineTaskExecutionOutcome } from "./engine-execution.js";
-import type { ScheduledTask } from "./scheduler/index.js";
-interface CreateEngineExecutionObserverOptions {
-    readonly artifactReferencesByTaskId: ReadonlyMap<string, PersistedArtifactReference[]>;
-    readonly completedOutcomesByTaskId: Map<string, EngineTaskExecutionOutcome>;
-    readonly errors: Error[];
-    readonly executableTask: EngineExecutableTask;
-    readonly invocationEvidenceLedger: EvidenceLedger;
-    readonly productDir: string;
-    readonly taskBatchIndex: number;
-    readonly taskEvidenceLedgers: ReadonlyMap<string, EvidenceLedger>;
-    readonly tasks: readonly ScheduledTask[];
-    readonly tasksById: ReadonlyMap<string, ScheduledTask>;
-    readonly workspaceArtifactDirectory: string;
-}
-type MapObservedOutcome = (outcome: Readonly<EngineTaskOutcome>, task: ScheduledTask, artifacts: PersistedArtifactReference[], executableTask: EngineExecutableTask, batchIndex: number) => EngineTaskExecutionOutcome;
-export declare function createEngineExecutionObserver({ artifactReferencesByTaskId, completedOutcomesByTaskId, errors, executableTask, invocationEvidenceLedger, productDir, taskBatchIndex, taskEvidenceLedgers, tasks, tasksById, workspaceArtifactDirectory, }: Readonly<CreateEngineExecutionObserverOptions>, mapOutcome: MapObservedOutcome): EngineExecutionObserver;
-export {};

package/dist/app/run/engine-execution-reporting.d.ts

@@ -1,17 +0,0 @@
-export declare const DEFAULT_ENGINE_REPORTER_CALLBACK_TIMEOUT_MS = 5000;
-export interface EngineReporterCallbackBoundary {
-    readonly signal?: AbortSignal;
-    readonly timeoutMs: number;
-}
-export declare class EngineReporterCallbackTimeoutError extends Error {
-    readonly timeoutMs: number;
-    constructor(label: string, timeoutMs: number);
-}
-export declare class EngineReporterCallbackCancelledError extends Error {
-    readonly code = "TESTKIT_ENGINE_REPORTER_CALLBACK_CANCELLED";
-    readonly cause: unknown;
-    constructor(label: string, cause: unknown);
-}
-export declare function invokeBoundedReporterCallback(label: string, callback: () => unknown, boundary: Readonly<EngineReporterCallbackBoundary>): Promise<void>;
-export declare function invokeEngineReporterCallback(phase: "taskFinished" | "taskStarted", callback: () => unknown, boundary: Readonly<EngineReporterCallbackBoundary>): Promise<void>;
-export declare function captureEngineReporterCallback(errors: Error[], phase: "taskFinished" | "taskStarted", callback: () => unknown, boundary: Readonly<EngineReporterCallbackBoundary>): Promise<void>;