@gfdelarue/testkit 0.3.0

package/dist/cli/index.js

@@ -0,0 +1 @@
+import{testkitIdentity as r}from"../app/package-inspection.js";import{commandRegistry as e}from"./command-registry.js";import{normalizeCliArgs as o}from"./entrypoint.js";import{executeCliArguments as n}from"./framework/index.js";export async function executeCli(t,i={}){await n(t,{...i,identity:r(),registrations:e})}export async function run(t=process.argv){await executeCli(o(t.slice(2)))}

package/dist/cli/json-errors.d.ts

@@ -0,0 +1,3 @@
+import { type SerializedError } from "../kernel/error-serialization.js";
+export declare function serializeCliError(error: unknown): SerializedError;
+export declare function writeStandardOutput(value: string): Promise<void>;

package/dist/cli/json-errors.js

@@ -0,0 +1 @@
+import{serializeError as i}from"../kernel/error-serialization.js";export function serializeCliError(t){return i(t)}export function writeStandardOutput(t){return new Promise((r,n)=>{const e=o=>{o?c(o,"EPIPE")?r():n(o):(process.stdout.off("error",e),r())};process.stdout.once("error",e),process.stdout.write(t,e)})}function s(t){return typeof t=="object"&&t!==null||typeof t=="function"}function c(t,r){return s(t)&&Reflect.get(t,"code")===r}

package/dist/cli/operations/db/schema/refresh/operation.d.ts

@@ -0,0 +1,6 @@
+import { type DatabaseSchemaRefreshOptions as ApplicationOptions, type DatabaseSchemaRefreshResult } from "../../../../../app/db-schema/refresh.js";
+export type { DatabaseSchemaRefreshResult } from "../../../../../app/db-schema/refresh.js";
+export interface DatabaseSchemaRefreshOptions extends ApplicationOptions {
+    debug?: boolean;
+}
+export declare function executeDatabaseSchemaRefreshOperation(options?: Readonly<DatabaseSchemaRefreshOptions>): Promise<DatabaseSchemaRefreshResult>;

package/dist/cli/operations/db/schema/refresh/operation.js

@@ -0,0 +1 @@
+import{executeDatabaseSchemaRefresh as r}from"../../../../../app/db-schema/refresh.js";import{createTextStepProgressReporter as t}from"../../../../renderers/run/text-reporter.js";export function executeDatabaseSchemaRefreshOperation(e={}){return r(e,t({debug:e.debug}))}

package/dist/cli/operations/db/schema/verify/operation.d.ts

@@ -0,0 +1,6 @@
+import { type DatabaseSchemaVerifyOptions as ApplicationOptions, type DatabaseSchemaVerifyResult } from "../../../../../app/db-schema/verify.js";
+export type { DatabaseSchemaVerifyResult } from "../../../../../app/db-schema/verify.js";
+export interface DatabaseSchemaVerifyOptions extends ApplicationOptions {
+    debug?: boolean;
+}
+export declare function executeDatabaseSchemaVerifyOperation(options?: Readonly<DatabaseSchemaVerifyOptions>): Promise<DatabaseSchemaVerifyResult>;

package/dist/cli/operations/db/schema/verify/operation.js

@@ -0,0 +1 @@
+import{executeDatabaseSchemaVerify as r}from"../../../../../app/db-schema/verify.js";import{createTextStepProgressReporter as t}from"../../../../renderers/run/text-reporter.js";export function executeDatabaseSchemaVerifyOperation(e={}){return r(e,t({debug:e.debug}))}

package/dist/cli/operations/run/operation.d.ts

@@ -0,0 +1,24 @@
+import type { RunRequest } from "../../../app/run/request.js";
+export interface RunTerminalStream {
+    columns?: number;
+    write(text: string): unknown;
+}
+export interface ExecuteRunRequestOptions {
+    debug?: boolean;
+    json?: boolean;
+    outputMode?: string;
+    terminal?: {
+        stderr?: RunTerminalStream;
+        stdout?: RunTerminalStream;
+    };
+}
+export type RunOutputMode = "compact" | "debug" | "events" | "json";
+export declare function executeRunRequest(request: Readonly<RunRequest>, { outputMode: requestedMode, json, debug, terminal, }?: Readonly<ExecuteRunRequestOptions>): Promise<{
+    exitCode: number;
+    failure?: import("../../../kernel/error-serialization.js").SerializedError;
+    results: import("../../../app/run/results.js").FinalizedServiceResult[];
+    runArtifact: import("../../../app/run/run-finalization.js").FinalizedRunArtifacts["runArtifact"];
+    outputMode: RunOutputMode;
+    runId: string;
+}>;
+export declare function resolveRunOutputMode(requestedMode: string, json: boolean, debug: boolean): RunOutputMode;

package/dist/cli/operations/run/operation.js

@@ -0,0 +1,2 @@
+import{runAll as a}from"../../../app/run/orchestrator.js";import{createRunTextListener as p}from"../../renderers/run/text-reporter.js";import{createRunEventsListener as l}from"../../renderers/run/events.js";export async function executeRunRequest(t,{outputMode:o="compact",json:e=!1,debug:c=!1,terminal:i={}}={}){const u=i.stdout||process.stdout,n=resolveRunOutputMode(o,e,c),f=n==="json"?()=>{}:n==="events"?l({stdout:u}):p({outputMode:n,stdout:u}),r=await a(t.configs,t.typeValues,t.suiteSelectors,{debug:n==="debug",onEvent:f,...t.runOptions},t.allConfigs),s=r.runArtifact.archive.runId;return(n==="compact"||n==="debug")&&u.write(`Run ID: ${s}
+`),{outputMode:n,runId:s,...r}}export function resolveRunOutputMode(t,o,e){return o?"json":e?"debug":t==="debug"||t==="events"||t==="json"?t:"compact"}

package/dist/cli/process-signal.d.ts

@@ -0,0 +1 @@
+export declare function runWithCliProcessSignal<Result>(operation: (signal: AbortSignal) => Promise<Result>): Promise<Result>;

package/dist/cli/process-signal.js

@@ -0,0 +1 @@
+export async function runWithCliProcessSignal(s){const o=new AbortController,n={pendingSignal:null},r=()=>{e("SIGINT")},t=()=>{e("SIGTERM")},e=i=>{n.pendingSignal??=i,o.abort(new Error(`Testkit CLI interrupted by ${i}`))};process.on("SIGINT",r),process.on("SIGTERM",t);try{return await s(o.signal)}finally{process.off("SIGINT",r),process.off("SIGTERM",t),n.pendingSignal&&process.kill(process.pid,n.pendingSignal)}}

package/dist/cli/renderers/artifact-preview.d.ts

@@ -0,0 +1,4 @@
+import type { ArtifactInspectionEntry } from "../../app/inspect/artifacts.js";
+type RunArtifactPayload = NonNullable<ArtifactInspectionEntry["payload"]>;
+export declare function formatArtifactPreview(payload: RunArtifactPayload | null, maxLines?: number): string[];
+export {};

package/dist/cli/renderers/artifact-preview.js

@@ -0,0 +1 @@
+import{asUnknownRecord as u,isUnknownRecord as d,optionalString as n}from"../../kernel/unknown-values.js";export function formatArtifactPreview(t,r=6){if(!t)return["artifact payload missing"];const s=u(t.data);if(t.kind==="testkit.data-flow")return k(t,r);if(t.kind==="testkit.data-flow.report"||t.contentType==="text/markdown")return(t.text??n(s?.text)??"").split(/\r?\n/).filter(i=>i.trim().length>0).slice(0,r);if(t.kind==="testkit.http-traces")return w(t,r);if(t.contentType==="text/plain"&&(typeof s?.text=="string"||typeof t.text=="string"))return(n(s?.text)??t.text??"").split(/\r?\n/).filter(i=>i.trim().length>0).slice(0,r);const o=t.data===void 0?t:t.data;return JSON.stringify(o,null,2).split(/\r?\n/).slice(0,r)}function k(t,r){const s=u(t.data),o=s?.kind==="testkit.data-flow"?s:t,e=[],i=n(o.summaryText);i&&e.push(i);for(const c of p(o.scenarios)){const a=n(c.status)??"unknown",f=n(c.name)??"scenario";e.push(`${a.toUpperCase()} ${f}`);for(const m of p(c.budgetFailures)){const g=n(m.message);g&&e.push(`Budget: ${g}`)}}return e.slice(0,r)}function w(t,r){const s=p(u(t.data)?.traces),o=[];for(const e of s.slice(0,r)){const i=u(e.response),c=n(e.method)??"?",a=n(e.path)??"?",f=n(e.requestId),m=h(i?.status)??"?";o.push(`${c} ${a} -> ${String(m)}${f?` [${f}]`:""}`)}return o}function p(t){return Array.isArray(t)?t.filter(d):[]}function h(t){return typeof t=="string"||typeof t=="number"&&Number.isFinite(t)?t:null}

package/dist/cli/renderers/cleanup/format.d.ts

@@ -0,0 +1,14 @@
+type ResourceCleanupSummary = MaintenanceCleanupResult["resourceCleanup"];
+import type { CleanupRunSummaries, MaintenanceCleanupResult } from "../../../app/cleanup/index.js";
+type DatabaseResourceCleanupEntry = ResourceCleanupSummary["targets"][number];
+export declare function formatCleanupLines(productDir: string, summary: Readonly<MaintenanceCleanupResult>, runSummaries: CleanupRunSummaries): string[];
+export declare function selectReportedDatabaseResourceCleanupEntries(cleanup: Readonly<ResourceCleanupSummary>, dryRun: boolean): DatabaseResourceCleanupEntry[];
+export declare function formatDatabaseResourceCleanupLine(entry: Readonly<DatabaseResourceCleanupEntry>, dryRun?: boolean): string;
+export declare function dockerContainerSummary(container: Readonly<{
+    name: string;
+    running: boolean;
+}>): string;
+export declare function dockerVolumeSummary(volume: Readonly<{
+    name: string;
+}>): string;
+export {};

package/dist/cli/renderers/cleanup/format.js

@@ -0,0 +1 @@
+import c from"path";export function formatCleanupLines(e,t,n){const{dryRun:s,targets:u,resourceCleanup:p,automaticResourceCleanup:a}=t,r=[],i=new Set(n.stoppedActive.map(o=>o.runId));for(const o of n.cleaned)i.has(o.runId)||r.push(`${s?"Would clean":"Cleaned"} stale run ${o.summary}`);for(const o of n.stoppedActive)r.push(`Stopped and cleaned active run ${o.summary}`);for(const o of n.skippedActive)r.push(`Active run still present: ${o.summary}`);for(const o of u.runtime)r.push(`${s?"Would remove":"Removed"} stale runtime ${o.graph}/${o.runtimeId}`);f(r,{productDir:e,targets:u.bundles,label:"bundle cache file",dryRun:s});for(const o of a.flatMap(d=>selectReportedDatabaseResourceCleanupEntries(d,!1)))r.push(formatDatabaseResourceCleanupLine(o,s));for(const o of selectReportedDatabaseResourceCleanupEntries(p,s))r.push(formatDatabaseResourceCleanupLine(o,s));return r.length===0?["No stale runs to clean."]:r}export function selectReportedDatabaseResourceCleanupEntries(e,t){return t?[...e.targets]:[...e.removed,...e.stopped??[],...e.skipped??[]]}function l(e,t){return c.relative(e,t).split(c.sep).join("/")}function f(e,{productDir:t,targets:n,label:s,dryRun:u}){if(n.length===0)return;const p=u?"Would remove":"Removed";e.push(`${p} ${n.length.toString()} ${s}${n.length===1?"":"s"}.`);for(const a of n.slice(0,10))e.push(`  ${l(t,a.path)}`);if(n.length>10){const a=n.length-10;e.push(`  ... ${a.toString()} more ${s}${a===1?"":"s"}`)}}export function formatDatabaseResourceCleanupLine(e,t=!1){if(e.action==="skip")return`Skipped database resource ${e.resourceType==="volume"?`volume ${dockerVolumeSummary(e)}`:dockerContainerSummary(e)} reason=${e.reason} intended=${e.intendedAction??"unknown"} selected=${e.selectionReason??"unknown"}`;const n=e.action==="stop",s=t?n?"Would stop":"Would remove":n?"Stopped":"Removed",u=e.resourceType==="volume"?`volume ${dockerVolumeSummary(e)}`:dockerContainerSummary(e);return`${s} database resource ${u} reason=${e.reason}`}export function dockerContainerSummary(e){const t=e.running?"running":"stopped";return`${e.name} (${t})`}export function dockerVolumeSummary(e){return e.name}

package/dist/cli/renderers/db-schema/text.d.ts

@@ -0,0 +1,4 @@
+import type { DatabaseSchemaRefreshResult } from "../../operations/db/schema/refresh/operation.js";
+import type { DatabaseSchemaVerifyResult } from "../../operations/db/schema/verify/operation.js";
+export declare function renderDatabaseSchemaRefreshResult(result: Readonly<DatabaseSchemaRefreshResult>): string[];
+export declare function renderDatabaseSchemaVerifyResult(result: Readonly<DatabaseSchemaVerifyResult>): string[];

package/dist/cli/renderers/db-schema/text.js

@@ -0,0 +1 @@
+export function renderDatabaseSchemaRefreshResult(e){const r=[`Refreshed ${e.outputLabel}`];return e.cacheKey&&r.push(`Cache key ${e.cacheKey}`),e.sourceUrl?.rewritten&&e.sourceUrl.originalClassification==="neon-pooler"&&r.push("Source schema URL uses Neon pooler; Testkit used the direct endpoint for pg_dump."),e.reusedExistingRefresh&&r.push("Another Testkit process refreshed this source schema cache first; reused that result."),r}export function renderDatabaseSchemaVerifyResult(e){return[`Verified source schema for ${e.service}`]}

package/dist/cli/renderers/destroy/text.d.ts

@@ -0,0 +1,4 @@
+import type { destroyEnvironment } from "../../../app/destroy/index.js";
+export type DestroyOperationResult = Awaited<ReturnType<typeof destroyEnvironment>>;
+export type DestroyedServiceResult = DestroyOperationResult["results"][number];
+export declare function renderDestroyResult(result: Readonly<DestroyOperationResult> | readonly Readonly<DestroyedServiceResult>[]): string[];

package/dist/cli/renderers/destroy/text.js

@@ -0,0 +1 @@
+export function renderDestroyResult(r){return(t(r)?r.results:r).map(e=>`Destroyed ${e.name}`)}function t(r){return!Array.isArray(r)}

package/dist/cli/renderers/discover/report.d.ts

@@ -0,0 +1,7 @@
+import type { DiscoverOperationResult } from "../../../app/discover/index.js";
+type DiscoveryResult = Omit<DiscoverOperationResult, "outputLabel">;
+export interface DiscoveryReportOptions {
+    outputMode?: string;
+}
+export declare function buildDiscoveryReportLines(result: Readonly<DiscoveryResult>, options?: Readonly<DiscoveryReportOptions>): string[];
+export {};

package/dist/cli/renderers/discover/report.js

@@ -0,0 +1 @@
+import{TEST_TYPE_ORDER as P,formatTestTypeLabel as _}from"../../../domain/test-types.js";import{bold as w,colorDiagnosticSeverity as D,colorHeading as m,colorService as I,colorTypeBadge as j,muted as h,statusLabel as M}from"../../terminal/colors.js";const E=P,y="\u251C\u2500\u2500 ",S="\u2514\u2500\u2500 ",R="\u2502   ",b="    ";export function buildDiscoveryReportLines(s,e={}){return(e.outputMode||"compact")==="verbose"?H(s):A(s)}function A(s){const e=[];e.push(`${o(m("Summary"))} ${String(s.summary.files)} files \xB7 ${String(s.summary.activeFiles)} active \xB7 ${String(s.summary.skippedFiles)} skipped \xB7 ${String(s.summary.suites)} suites \xB7 ${String(s.summary.services)} services`),B(e,s.diagnostics);const t=Y(s.suites),n=G(s.files);for(const i of s.services){e.push(""),e.push(`${o(I(i.name))} ${o(h(`(${String(i.fileCount)} files${i.dependsOn.length>0?` \xB7 depends on ${i.dependsOn.join(", ")}`:""})`))}`);const p=t.get(i.name)||new Map,c=J([...p.keys()]);for(let r=0;r<c.length;r+=1){const l=c[r],v=r===c.length-1,F=v?S:y,T=v?b:R,d=p.get(l)||[];e.push(`${F}${o(j(l.toUpperCase()))} ${_(l)}`);for(let a=0;a<d.length;a+=1){const u=d[a],C=a===d.length-1,O=C?S:y,x=C?b:R;e.push(`${T}${O}${o(w(u.groupLabel))} ${o(h(`(${String(u.fileCount)} files \xB7 ${u.engineId} \xB7 ${u.profileId})`))}`);const $=n.get(u.id)||[];for(let f=0;f<$.length;f+=1){const g=$[f],N=f===$.length-1?S:y,k=g.skipped?`${o(M("SKIP"))} ${g.skipReason||""}`:"";e.push(`${T}${x}${N}${g.displayName}${k?`  ${k}`:""}`)}}}}return e}function H(s){const e=[];e.push(`${o(m("Summary"))} ${JSON.stringify(s.summary)}`),s.configFile&&e.push(`config ${s.configFile}`),B(e,s.diagnostics);for(const t of s.services){e.push(""),e.push(o(I(t.name))),e.push(`  cwd ${t.localCwd}`),t.dependsOn.length>0&&e.push(`  dependsOn ${t.dependsOn.join(", ")}`),e.push(`  files ${String(t.fileCount)} \xB7 active ${String(t.activeFileCount)} \xB7 skipped ${String(t.skippedFileCount)}`);const n=s.suites.filter(i=>i.service===t.name).sort(L);for(const i of n){e.push(`  suite ${i.testType}:${i.name} engine=${i.engineId} profile=${i.profileId} ${o(h(`${String(i.fileCount)} files`))}`),i.locks.length>0&&e.push(`    locks ${i.locks.join(", ")}`);for(const p of s.files.filter(c=>c.service===t.name&&c.suiteName===i.name&&c.testType===i.testType&&c.engineId===i.engineId&&c.profileId===i.profileId))e.push(`    ${p.displayName}`),e.push(`      path ${p.path}`),e.push(`      id ${p.id}`),e.push(`      status ${p.skipped?"skipped":"active"}`),p.skipReason&&e.push(`      skipReason ${p.skipReason}`),p.locks.length>0&&e.push(`      locks ${p.locks.join(", ")}`)}}return e}function B(s,e=[]){if(e.length!==0){s.push(""),s.push(o(m("Diagnostics")));for(const t of e){const n=t.path?` ${t.path}`:"";s.push(`  ${o(D(t.severity))} ${t.code}${n}`),s.push(`    ${t.message}`)}}}function Y(s){const e=new Map;for(const t of s){let n=e.get(t.service);n||(n=new Map,e.set(t.service,n));const i=n.get(t.testType)||[];i.push(t),n.set(t.testType,i.sort(L))}return e}function G(s){const e=new Map;for(const t of s){const n=[t.service,t.testType,t.engineId,t.profileId,t.suiteName].join("|"),i=e.get(n)||[];i.push(t),e.set(n,i.sort(K))}return e}function J(s){return[...s].sort((e,t)=>E.indexOf(e)-E.indexOf(t))}function L(s,e){return s.groupLabel.localeCompare(e.groupLabel)||s.name.localeCompare(e.name)}function K(s,e){return s.displayName.localeCompare(e.displayName)||s.path.localeCompare(e.path)}function o(s){return String(s)}

package/dist/cli/renderers/discover/text.d.ts

@@ -0,0 +1,3 @@
+import type { DiscoverOperationResult } from "../../../app/discover/index.js";
+import { type DiscoveryReportOptions } from "./report.js";
+export declare function renderDiscoverResult(result: Readonly<DiscoverOperationResult>, options?: Readonly<DiscoveryReportOptions>): string[];

package/dist/cli/renderers/discover/text.js

@@ -0,0 +1 @@
+import{buildDiscoveryReportLines as u}from"./report.js";export function renderDiscoverResult(o,e={}){const t=u(o,{outputMode:e.outputMode||"compact"});return o.outputLabel&&t.push(`Wrote ${o.outputLabel}`),t}

package/dist/cli/renderers/doctor/text.d.ts

@@ -0,0 +1,2 @@
+import type { DoctorResult } from "../../../app/doctor/index.js";
+export declare function renderDoctorResult(result: Readonly<DoctorResult>): string[];

package/dist/cli/renderers/doctor/text.js

@@ -0,0 +1 @@
+export function renderDoctorResult(e){const n=[`testkit doctor ${e.ok?"passed":"failed"} for ${e.productDir}`];for(const t of e.checks){n.push(`${t.level.toUpperCase()} ${t.code} ${t.message}`);for(const o of t.details?.slice(0,5)??[]){const r=s(o);r&&n.push(r)}}return n}function s(e){if(!i(e)||typeof e.ruleId!="string")return null;const n=typeof e.file=="string"?e.file:"unknown",t=typeof e.line=="number"?String(e.line):"?",o=typeof e.message=="string"?e.message:"";return`  ${e.ruleId} ${n}:${t} ${o}`}function i(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}

package/dist/cli/renderers/lint/text.d.ts

@@ -0,0 +1,2 @@
+import type { LintResult } from "../../../app/lint/index.js";
+export declare function renderLintResult(result: Readonly<LintResult>): string[];

package/dist/cli/renderers/lint/text.js

@@ -0,0 +1 @@
+export function renderLintResult(t){const n=[`testkit lint ${t.ok?"passed":"failed"} for ${t.productDir}`,`Checked ${String(t.summary.files)} source file(s), ${String(t.summary.testkitFiles)} testkit suite file(s).`];if(t.violations.length===0)return n;n.push(`Found ${String(t.summary.violations)} violation(s).`,"");for(const i of t.violations){const e=i.line?`${i.file}:${String(i.line)}`:i.file;n.push(`${e} ${i.ruleId}: ${i.message}`),i.snippet&&n.push(`  ${i.snippet}`)}return n}

package/dist/cli/renderers/run/events.d.ts

@@ -0,0 +1,8 @@
+import type { RunEventListener } from "../../../app/run/run-events.js";
+export interface RunEventOutputStream {
+    write(text: string): void;
+}
+export interface RunEventsListenerOptions {
+    stdout?: RunEventOutputStream;
+}
+export declare function createRunEventsListener(options?: Readonly<RunEventsListenerOptions>): RunEventListener;

package/dist/cli/renderers/run/events.js

@@ -0,0 +1,2 @@
+export function createRunEventsListener(e={}){const{stdout:a=process.stdout}=e;function s(r,u){const i=JSON.stringify({...u,type:r});if(typeof i!="string")throw new Error(`Unable to serialize run event ${r}`);a.write(`${i}
+`)}return r=>{switch(r.type){case"run.service_plans":s(r.type,{services:r.services});return;case"run.total_files":s(r.type,{total:r.total});return;case"run.phase_started":s(r.type,{label:r.label});return;case"run.toolchain_resolved":s(r.type,{service:r.service,runtimeLabel:r.runtimeLabel,summary:r.summary});return;case"run.setup_finished":s(r.type,{service:r.operation.serviceName,stage:r.operation.stage,status:r.operation.status,summary:r.operation.summary||null,durationMs:r.operation.durationMs??null,error:r.operation.error||null});return;case"run.operation_finished":case"run.operation_progress":case"run.operation_started":s(r.type,{operation:r.operation});return;case"run.local_service_starting":s(r.type,{service:r.service,runtimeLabel:r.runtimeLabel,command:r.command});return;case"run.service_skipped":s(r.type,{service:r.service,reason:r.reason});return;case"run.task_planned_skip":s(r.type,{service:r.service,file:r.file,testType:r.testType,engineId:r.engineId,profileId:r.profileId,reason:r.reason});return;case"run.task_started":s(r.type,{service:r.service,file:r.file,suite:r.suite,testType:r.testType,engineId:r.engineId,profileId:r.profileId});return;case"run.task_finished":s(r.type,{service:r.service,file:r.file,suite:r.suite,testType:r.testType,engineId:r.engineId,profileId:r.profileId,outcome:r.outcome});return;case"run.runtime_error":s(r.type,{service:r.service,file:r.file,message:r.message});return;case"run.debug":s(r.type,{line:r.line});return;case"run.summary":s(r.type,{results:r.results,durationMs:r.durationMs,runStatus:r.runStatus});return;case"run.warning":return}}}

package/dist/cli/renderers/run/failure.d.ts

@@ -0,0 +1,8 @@
+import type { WorkerReportedOutcome } from "../../../app/run/worker-loop.js";
+import type { BatchableTask } from "../../../app/run/task-batches.js";
+export type FailureRenderTask = Pick<BatchableTask, "engineId" | "file" | "profileId" | "serviceName" | "testType">;
+export type FailureRenderOutcome = Partial<Pick<WorkerReportedOutcome, "blockedByRuntime" | "error" | "failureDetails" | "infraFailed" | "reason">>;
+export interface RenderFailureBlockOptions {
+    width?: number;
+}
+export declare function renderFailureBlock(task: Readonly<FailureRenderTask>, outcome: Readonly<FailureRenderOutcome>, { width }?: Readonly<RenderFailureBlockOptions>): string[];

package/dist/cli/renderers/run/failure.js

@@ -0,0 +1 @@
+import{buildFailurePresentation as o}from"./formatting.js";import{renderIndentedBlock as a}from"../../terminal/layout.js";export function renderFailureBlock(e,r,{width:l=100}={}){const t={service:e.serviceName,testType:e.testType,engineId:e.engineId,profileId:e.profileId,path:e.file,blockedByRuntime:r.blockedByRuntime,error:r.error??null,failureDetails:r.failureDetails??[],infraFailed:r.infraFailed,reason:r.reason??null,suiteError:null},i=o(t),n=[];i.primary&&n.push(...a(i.primary,{width:l,indent:"    "}));for(const d of i.details)n.push(...a(d,{width:l,indent:"    "}));return n}

package/dist/cli/renderers/run/formatting.d.ts

@@ -0,0 +1,79 @@
+import type { TaskFailureDetail } from "../../../app/run/failure-details.js";
+import type { EngineId, PublicTestType, RunnerProfileId } from "../../../domain/identifiers.js";
+interface ServiceNameInput {
+    name: string;
+}
+interface ServiceSummaryInput {
+    completedSuiteCount: number;
+    failedSuiteCount: number;
+    notRunFileCount: number;
+    passedFileCount: number;
+    skippedFileCount: number;
+    skippedSuiteCount: number;
+    suiteCount: number;
+    totalFileCount: number;
+}
+export interface DebugRunServiceSuiteInput {
+    durationMs: number;
+    error: null | string;
+    failed: boolean;
+    failedFiles: readonly string[];
+    name: string;
+    testType: string;
+}
+export interface DebugRunServiceInput extends ServiceNameInput, ServiceSummaryInput {
+    durationMs: number;
+    errors: readonly string[];
+    failed: boolean;
+    infraFailed?: boolean;
+    skipped: boolean;
+    suites: readonly DebugRunServiceSuiteInput[];
+}
+export interface RunSummaryServiceInput {
+    blockedByRuntime?: boolean;
+    errors: readonly string[];
+    failed: boolean;
+    failedFileCount: number;
+    infraFailed?: boolean;
+    notRunFileCount: number;
+    passedFileCount: number;
+    skipped: boolean;
+    skippedFileCount: number;
+    totalFileCount: number;
+}
+export interface FailurePresentationFileSummary {
+    blockedByRuntime?: boolean;
+    error?: null | string;
+    infraFailed?: boolean;
+    reason?: null | string;
+    engineId: EngineId;
+    failureDetails?: readonly TaskFailureDetail[];
+    path: string;
+    profileId: RunnerProfileId;
+    service: string;
+    suiteError?: null | string;
+    testType: PublicTestType;
+}
+export interface FailurePresentation {
+    details: string[];
+    primary: string;
+}
+export interface RunSummaryData {
+    blockedByRuntimeServices: number;
+    duration: string;
+    failed: number;
+    failedServices: number;
+    files: number;
+    infraFailedServices: number;
+    notRun: number;
+    passed: number;
+    result: "FAILED" | "PASSED";
+    serviceErrors: number;
+    skipped: number;
+    totalServices: number;
+}
+export declare function formatDuration(durationMs: number): string;
+export declare function buildRunSummaryData(results: readonly RunSummaryServiceInput[], durationMs: number, runStatus?: null | string): RunSummaryData;
+export declare function buildDebugRunSummaryLines(results: readonly DebugRunServiceInput[], durationMs: number, runStatus?: null | string): string[];
+export declare function buildFailurePresentation(fileSummary: FailurePresentationFileSummary): FailurePresentation;
+export {};

package/dist/cli/renderers/run/formatting.js

@@ -0,0 +1 @@
+import{sanitizeErrorMessage as p}from"../../../kernel/error-serialization.js";export function formatDuration(e){const t=Math.max(0,Math.round(e/1e3)),i=Math.floor(t/60),n=t%60;return i===0?`${String(n)}s`:`${String(i)}m ${String(n).padStart(2,"0")}s`}function q(e){const t=e.skippedSuiteCount||0,i=e.completedSuiteCount-e.failedSuiteCount-t,n=e.suiteCount-e.completedSuiteCount;let s=`${String(i)}/${String(e.suiteCount)} suites passed`;return(e.totalFileCount||0)>0&&(s+=`, ${String(e.passedFileCount)}/${String(e.totalFileCount)} files passed`),t>0?s+=`, ${String(t)} ${S(t,"suite","suites")} skipped`:(e.skippedFileCount||0)>0&&(s+=`, ${String(e.skippedFileCount)} ${S(e.skippedFileCount,"file","files")} skipped`),n>0?s+=`, ${String(n)} ${S(n,"suite","suites")} not run`:(e.notRunFileCount||0)>0&&(s+=`, ${String(e.notRunFileCount)} ${S(e.notRunFileCount,"file","files")} not run`),s}function A(e){return e.reduce((t,i)=>Math.max(t,i.name.length),4)}export function buildRunSummaryData(e,t,i=null){const n=I(e),s=w(e);return{result:i==="failed"||i==="interrupted"||n.failedServices>0||n.infraFailedServices>0?"FAILED":"PASSED",totalServices:n.totalServices,failedServices:n.failedServices,infraFailedServices:n.infraFailedServices,blockedByRuntimeServices:n.blockedByRuntimeServices,passed:n.passedFiles,failed:n.failedFiles,skipped:n.skippedFiles,notRun:n.notRunFiles,files:n.totalFiles,duration:formatDuration(t),serviceErrors:s}}export function buildDebugRunSummaryLines(e,t,i=null){const n=e.length,s=e.filter(r=>!r.skipped),d=e.filter(r=>r.skipped),c=s.filter(r=>r.failed),u=s.filter(r=>r.infraFailed),f=s.filter(r=>!r.failed&&!r.infraFailed),C=s.reduce((r,o)=>r+o.suiteCount,0),R=s.reduce((r,o)=>r+o.completedSuiteCount,0),F=s.reduce((r,o)=>r+(o.skippedSuiteCount||0),0),y=s.reduce((r,o)=>r+o.failedSuiteCount,0),E=R-y-F,k=s.reduce((r,o)=>r+(o.totalFileCount||0),0),b=s.reduce((r,o)=>r+(o.passedFileCount||0),0),m=s.reduce((r,o)=>r+(o.skippedFileCount||0),0),a=["","\u2550\u2550 Summary \u2550\u2550",[`services ${String(f.length)}/${String(s.length)} passed`,`suites ${String(E)}/${String(C)} passed`,k>0?`files ${String(b)}/${String(k)} passed`:null,F>0?`suites ${String(F)} skipped`:null,m>0?`files ${String(m)} skipped`:null,d.length>0?`${String(d.length)} skipped`:null,`duration ${formatDuration(t)}`].filter(Boolean).join("  \xB7  ")];for(const r of e){const o=z(r)?"SKIP":r.failed?"FAIL":r.infraFailed?"INFRA":"PASS",D=r.skipped?"no matching suites":q(r);if(a.push(`${o.padEnd(4)} ${r.name.padEnd(A(e))}  ${D}  \xB7  ${formatDuration(r.durationMs)}`),!(!r.failed&&!r.infraFailed)){for(const l of r.suites.filter($=>$.failed)){const $=l.failedFiles.length>0?`  (${l.failedFiles.join(", ")})`:"";a.push(`  - ${l.testType}:${l.name}${$} \xB7 ${formatDuration(l.durationMs)}`),l.error&&a.push(`    ${l.error}`)}for(const l of r.errors)a.push(`  - worker error: ${l}`)}}return i==="failed"||i==="interrupted"||c.length>0||u.length>0?(a.push("",c.length===0&&u.length===0?"Result: FAILED (run gate)":`Result: FAILED (${P({failedServices:c.length,infraFailedServices:u.length,totalServices:n})})`),a):(a.push("","Result: PASSED"),a)}export function buildFailurePresentation(e){const t=x(e.failureDetails||[]),i=t[0]||null,n=t.map(u=>p((u.message||u.title).trim())),s=[],d=L(i);d&&s.push(d);const c=j(i);c&&s.push(c);for(const u of t.slice(1)){const f=h(u.message||u.title,220);f&&!s.includes(f)&&s.push(f)}return{primary:h(M(e,{error:e.suiteError||null},i,n),240),details:s}}function I(e){const t=e.filter(i=>!i.skipped);return{totalServices:e.length,failedServices:t.filter(i=>i.failed).length,infraFailedServices:t.filter(i=>i.infraFailed).length,blockedByRuntimeServices:t.filter(i=>i.blockedByRuntime).length,totalFiles:t.reduce((i,n)=>i+(n.totalFileCount||0),0),passedFiles:t.reduce((i,n)=>i+(n.passedFileCount||0),0),failedFiles:t.reduce((i,n)=>i+(n.failedFileCount||0),0),skippedFiles:t.reduce((i,n)=>i+(n.skippedFileCount||0),0),notRunFiles:t.reduce((i,n)=>i+(n.notRunFileCount||0),0)}}function P(e){const t=[`${String(e.failedServices)}/${String(e.totalServices)} services failed`];return(e.infraFailedServices||0)>0&&t.push(`${String(e.infraFailedServices)} infra-blocked`),t.join(", ")}function M(e,t,i,n){if(i?.message)return p(i.message.trim());const s=p(e.error||"");return s&&!B(s)?s:n.length>0?n[0]:s||p(t.error||"Failed")}function x(e){return[...e].sort((t,i)=>v(t)-v(i)||(t.key||"").localeCompare(i.key||""))}function v(e){return e.kind==="http-assertion"?1:e.request&&e.response?2:e.location||e.stack?3:e.message?4:5}function L(e){const t=g(e?.response,"bodyPreview");return t?`response: ${h(t,220)}`:null}function j(e){const t=e?.request,i=g(t,"method"),n=g(t,"path");if(!i||!n)return null;const s=g(t,"requestId");return s?`logs: requestId=${s}`:`request: ${i} ${n}`}function B(e){return/k6 thresholds failed:/.test(e)}function h(e,t=180){return e.replace(/\s+/g," ").trim().slice(0,t)}function w(e){return e.reduce((t,i)=>t+i.errors.length,0)}function S(e,t,i){return e===1?t:i}function z(e){return e.skipped?!0:!e.failed&&(e.skippedSuiteCount||0)>0&&(e.skippedSuiteCount||0)===e.suiteCount&&(e.notRunFileCount||0)===0}function N(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function g(e,t){if(!N(e))return null;const i=e[t];return typeof i=="string"&&i.length>0?i:null}

package/dist/cli/renderers/run/status.d.ts

@@ -0,0 +1,6 @@
+import { type RenderableRunStatus } from "../../../app/status/runs.js";
+export interface FormatStatusOperationOptions {
+    nameSeparator?: string;
+}
+export declare function renderRunStatusLines(result: Readonly<RenderableRunStatus>): string[];
+export declare function formatStatusOperation(operation?: unknown, { nameSeparator }?: Readonly<FormatStatusOperationOptions>): string;

package/dist/cli/renderers/run/status.js

@@ -0,0 +1 @@
+import{describeLiveArtifactState as c,latestOperation as l}from"../../../app/status/runs.js";import{formatOperationSummary as m}from"../../../domain/operation-display.js";import{asUnknownRecord as a,displayString as p}from"../../../kernel/unknown-values.js";export function renderRunStatusLines(s){const t=["Testkit Run Status",`  product: ${s.productDir}`],r=s.runs??[];if(r.length===0)t.push("  local runs: none");else{t.push("  local runs:");for(const n of r)t.push(`    ${String(n.runId)}: ${n.active?"active":n.terminal?"terminal":"stale"} pid=${String(n.pid)} status=${n.status||"unknown"}`)}const o=a(s.live),i=o?a(o.operation):null,e=o?a(o.timings):null,u=l(i?[i]:e?.operations??[]);if(o){const n=c({...s,live:o});t.push("  live artifact:"),t.push(`    run: ${n.runId} status=${n.status}`),n.reason&&t.push(`    reason: ${n.reason}`),u&&t.push(`    operation: ${formatStatusOperation(u)}`)}return t}export function formatStatusOperation(s={},{nameSeparator:t=""}={}){const r=a(s)??{},o=m(r),i=p(r.name,"operation"),e=p(r.status,"unknown");return`${i}${t} ${e}${o?` - ${o}`:""}`}

package/dist/cli/renderers/run/text-reporter.d.ts

@@ -0,0 +1,19 @@
+import type { RunEventListener } from "../../../app/run/run-events.js";
+import type { executeDatabaseSchemaRefresh } from "../../../app/db-schema/refresh.js";
+type StepProgressReporter = Parameters<typeof executeDatabaseSchemaRefresh>[1];
+export type RunTextOutputMode = "compact" | "debug";
+export interface RunTextOutputStream {
+    columns?: number;
+    write(text: string): void;
+}
+export interface RunTextListenerOptions {
+    outputMode?: RunTextOutputMode;
+    stdout?: RunTextOutputStream;
+}
+export declare function createRunTextListener(options?: Readonly<RunTextListenerOptions>): RunEventListener;
+export interface TextStepProgressReporterOptions {
+    debug?: boolean;
+    stdout?: RunTextOutputStream;
+}
+export declare function createTextStepProgressReporter(options?: Readonly<TextStepProgressReporterOptions>): StepProgressReporter;
+export {};

package/dist/cli/renderers/run/text-reporter.js

@@ -0,0 +1,23 @@
+import k from"node:path";import{buildDebugRunSummaryLines as L,buildRunSummaryData as I,formatDuration as m}from"./formatting.js";import{formatOperationSummary as F,isNeutralOperationStatus as T,isSuccessfulOperationStatus as M,operationStatusLabel as O}from"../../../domain/operation-display.js";import{boldRed as p,colorSectionLine as P,dim as c,statusLabel as o}from"../../terminal/colors.js";import{getTerminalWidth as A}from"../../terminal/layout.js";import{renderFailureBlock as D}from"./failure.js";export function createRunTextListener(t={}){const{outputMode:s="compact",stdout:e=process.stdout}=t;let u=0,n=0;return r=>{switch(r.type){case"run.total_files":n=r.total;return;case"run.debug":e.write(`${r.line}
+`);return;case"run.phase_started":f(s,e,r.label);return;case"run.toolchain_resolved":$(s,e,r.service,r.runtimeLabel,r.summary);return;case"run.setup_finished":g(s,e,r.operation);return;case"run.operation_started":case"run.operation_progress":if(!h(s,r.operation))return;e.write(`${o("RUN")} INFRA ${w(r.operation)}
+`);return;case"run.operation_finished":{if(!h(s,r.operation,{finished:!0}))return;const i=O(r.operation.status);e.write(`${o(i)} INFRA ${w(r.operation)}
+`);return}case"run.local_service_starting":if(s!=="debug")return;e.write(`Starting ${r.runtimeLabel}:${r.service}: ${r.command}
+`);return;case"run.service_skipped":e.write(`${o("SKIP")} ${r.service} ${r.reason}
+`);return;case"run.task_planned_skip":e.write(`${o("SKIP")} ${r.service} ${r.testType} ${S(r.file)} ${c("0s")} ${l(r.reason||"skipped")}
+`);return;case"run.task_started":if(s!=="debug")return;e.write(`${o("RUN")} ${r.targetName} ${r.testType} ${r.file}
+`);return;case"run.task_finished":{u+=1;const i=r.outcome,a=i.status==="not_run"?"NOT RUN":i.status==="skipped"||i.status==="cancelled"||i.status==="interrupted"?"SKIP":i.status==="failed"?"FAIL":"PASS",d=m(i.durationMs||0),y=i.status==="not_run"||i.status==="cancelled"||i.status==="interrupted"?` ${c(l(i.reason||"not run"))}`:"",_=s==="compact"&&n>0?`${c(`[${String(u)}/${String(n)}]`)} `:"";if(e.write(`${_}${o(a)} ${r.service} ${r.testType} ${S(r.file)} ${c(d)}${y}
+`),a==="FAIL"){const R=D({engineId:r.engineId,file:r.file,profileId:r.profileId,serviceName:r.service,testType:r.testType},i,{width:A(e,100)});for(const N of R)e.write(`${N}
+`)}return}case"run.runtime_error":e.write(`${o("FAIL")} ${r.service} runtime error
+`),e.write(`    ${p(l(r.message||"runtime error"))}
+`);return;case"run.summary":U(s,e,r.results,r.durationMs,r.runStatus);return;case"run.service_plans":case"run.warning":return}}}export function createTextStepProgressReporter(t={}){const{debug:s=!1,stdout:e=process.stdout}=t,u=s?"debug":"compact";return{outputMode:u,phaseStarted(n){f(u,e,n)},setupOperationFinished(n){n&&g(u,e,n)},toolchainResolved(n,r){$(u,e,n.name,n.runtimeLabel||n.name,r.summary)},writeDebugLine(n=""){e.write(`${n}
+`)}}}function f(t,s,e){t==="debug"&&s.write(`
+\u2500\u2500 ${e} \u2500\u2500
+`)}function $(t,s,e,u,n){t==="debug"&&s.write(`[testkit] ${u}:${e} toolchain ${n}
+`)}function g(t,s,e){if(e.status==="cached")return;const u=m(e.durationMs||0);if(e.status==="failed"){const n=l(e.error||e.summary||e.stage);s.write(`${o("FAIL")} SETUP ${e.serviceName} ${e.stage} ${c(u)} ${p(n)}
+`);return}if(t==="compact"&&x(e)&&(e.durationMs||0)>=5e3){const n=l(e.summary||e.stage);s.write(`${o("RUN")} SETUP ${e.serviceName} ${n} ${c(u)}
+`)}}function U(t,s,e,u,n){if(t==="debug"){const a=L(e,u,n);s.write(`
+`);for(const d of a)s.write(`${P(d)}
+`);return}const r=I(e,u,n),i=[["Result",r.result],["Passed",String(r.passed)],["Failed",String(r.failed)],["Skipped",String(r.skipped)],["Not run",String(r.notRun)],["Files",String(r.files)]];r.serviceErrors>0&&i.push(["Runtime errors",String(r.serviceErrors)]),i.push(["Duration",r.duration]),s.write(`
+`),s.write(`Summary
+`);for(const[a,d]of i)s.write(`${a}: ${d}
+`)}function l(t){return(t??"").replace(/\s+/g," ").trim().slice(0,180)}function S(t){return t.split(k.sep).join("/")}function x(t){return t.kind==="database-template"||t.kind==="runtime-prepare"}function h(t,s,{finished:e=!1}={}){return t==="debug"?!0:K(s)?e?M(s.status)?(s.durationMs||0)>=5e3:!T(s.status):!0:!1}function K(t){return t.kind==="runtime"}function w(t){const s=t.scope??{},e=E(t.name||t.kind||"operation"),u=b(s.serviceName),n=b(s.graphKey),r=[u?`service=${u}`:"",n?`graph=${n}`:""].filter(Boolean).join(" "),i=l(F(t)),a=t.durationMs==null?j(t.startedAt):m(t.durationMs||0);return[e,r?c(r):"",i?l(i):"",a?c(a):""].filter(Boolean).join(" ")}function b(t){return typeof t=="string"?t:""}function E(t){return t.replace(/^testkit\./,"").replaceAll("_","-")}function j(t){const s=Date.parse(t||"");return Number.isFinite(s)?m(Math.max(0,Date.now()-s)):""}

package/dist/cli/renderers/status/text.d.ts

@@ -0,0 +1,2 @@
+import type { StatusModel } from "../../../app/status/model.js";
+export declare function renderStatusResult(result: StatusModel | null | undefined): string[];

package/dist/cli/renderers/status/text.js

@@ -0,0 +1 @@
+const u=String;export function renderStatusResult(n){if(!n)return[];const e=[`Testkit Status: ${n.name||n.product.selectedService||"service"}`,"","Product",`  dir: ${n.product.dir||"unknown"}`,`  config: ${n.product.configFile||"none"}`,`  services: ${s(n.product.services)}`,`  dependencies: ${s(n.product.dependencies)}`,"","Runs",`  active: ${n.runs.active.toString()}`,`  stale: ${n.runs.stale.toString()}`];for(const t of n.runs.runs.slice(0,5)){const i=t.ports.length>0?` ports=${t.ports.join(",")}`:"";e.push(`  ${u(t.runId)}: ${t.status} pid=${u(t.pid)}${i}`)}if(n.runs.runs.length>5){const t=n.runs.runs.length-5;e.push(`  ... ${t.toString()} more run${t===1?"":"s"}`)}if(e.push("","Runtime Graphs"),n.runtimeGraphs.length===0)e.push("  none");else for(const t of n.runtimeGraphs){const i=t.orphan?" orphan":"";e.push(`  ${t.name}${i}`),e.push(`    desired instances: ${t.desired?.instanceCount.toString()??"none"}`),e.push(`    runtime dirs: ${t.runtimeDirCount.toString()}`),e.push(`    current: ${a(t.currentRuntimeDirs.map(o=>o.id))}`),e.push(`    stale: ${a(t.staleRuntimeDirs.map(o=>o.id))}`),e.push(`    runtime services: ${s(t.desired?.runtimeServices||t.actual?.runtimeServices||[])}`),e.push(`    target services: ${s(t.desired?.targetServices||t.actual?.targetServices||[])}`)}const r=n.caches.bundles;if(e.push("","Caches","  bundles",`    size: ${c(r.sizeBytes)}`,`    files: ${r.fileCount.toString()}`,`    source files: ${r.sourceFileCount.toString()}`,`    duplicated sources: ${r.duplicatedSourceCount.toString()}`,`    inline sourcemaps: ${p(r)}`,`    manifest entries: ${r.manifest.entryCount.toString()}`,`    unmanaged files: ${r.unmanagedFileCount.toString()}`),n.warnings.length>0){e.push("","Warnings");for(const t of n.warnings)e.push(`  - ${t}`)}return n.hasState||e.push("","No state \u2014 run tests first."),e}function s(n){const e=n.filter(Boolean);return e.length>0?e.join(", "):"none"}function a(n){return n.length===0?"none":n.length===1?n[0]:`${n[0]}..${n[n.length-1]}`}function c(n){const e=n||0;if(e<1024)return`${e.toString()}B`;const r=["KB","MB","GB","TB"];let t=e/1024,i=0;for(;t>=1024&&i<r.length-1;)t/=1024,i+=1;return`${t>=10?t.toFixed(0):t.toFixed(1)}${r[i]}`}function p(n){return n.sourcemapFileCount==null?n.sourcemapStatus:n.sourcemapStatus!=="present"&&n.sourcemapStatus!=="none"?`${n.sourcemapFileCount.toString()} (${n.sourcemapStatus})`:n.sourcemapFileCount.toString()}

package/dist/cli/renderers/stop/text.d.ts

@@ -0,0 +1,7 @@
+import type { stopProductRuns } from "../../../app/stop/index.js";
+export declare function renderStoppedRuns({ productDir, stoppedRuns }: Awaited<ReturnType<typeof stopProductRuns>>): {
+    ok: true;
+    productDir: string;
+    stoppedRuns: import("../../../environment/run-stopping.js").StoppedRun[];
+    lines: string[];
+};

package/dist/cli/renderers/stop/text.js

@@ -0,0 +1 @@
+export function renderStoppedRuns({productDir:r,stoppedRuns:i}){return{ok:!0,productDir:r,stoppedRuns:i,lines:i.length===0?["No active Testkit runs found."]:i.map(n=>`Stopped run ${n.runId}${n.pid?` pid=${String(n.pid)}`:""}.`)}}

package/dist/cli/renderers/typecheck/text.d.ts

@@ -0,0 +1,2 @@
+import type { TestkitTypecheckResult } from "../../../app/typecheck/index.js";
+export declare function renderTypecheckResult(result: Readonly<TestkitTypecheckResult>): string[];

package/dist/cli/renderers/typecheck/text.js

@@ -0,0 +1 @@
+export function renderTypecheckResult(e){const t=[`Typechecked ${String(e.results.length)} testkit program(s) in ${e.productDir}`];for(const n of e.results)t.push(`PASS ${n.label} ${n.tsconfigPath}`);return t}

package/dist/cli/terminal/colors.d.ts

@@ -0,0 +1,10 @@
+export declare function statusLabel(status: string): string;
+export declare function dim(text: string): string;
+export declare function bold(text: string): string;
+export declare function boldRed(text: string): string;
+export declare function muted(text: string): string;
+export declare function colorHeading(text: string): string;
+export declare function colorService(text: string): string;
+export declare function colorTypeBadge(type: string): string;
+export declare function colorDiagnosticSeverity(severity: string): string;
+export declare function colorSectionLine(line: string): string;

package/dist/cli/terminal/colors.js

@@ -0,0 +1 @@
+import{createColors as o}from"picocolors";const e=o(!!(process.stdout.isTTY||process.env.FORCE_COLOR));export function statusLabel(r){return r==="PASS"?e.green("PASS"):r==="FAIL"?e.red("FAIL"):r==="SKIP"?e.yellow("SKIP"):r==="NOT RUN"?e.yellow("NOT RUN"):r==="RUN"?e.cyan("RUN"):r}export function dim(r){return e.dim(r)}export function bold(r){return e.bold(r)}export function boldRed(r){return e.bold(e.red(r))}export function muted(r){return e.dim(r)}export function colorHeading(r){return e.bold(r)}export function colorService(r){return e.cyan(e.bold(r))}export function colorTypeBadge(r){return r==="INT"?e.blue(r):r==="E2E"?e.magenta(r):r==="DAL"?e.green(r):r==="LOAD"?e.cyan(r):r==="PW"?e.blue(e.bold(r)):r}export function colorDiagnosticSeverity(r){return r==="error"?e.red(e.bold("ERR")):r==="warning"?e.yellow(e.bold("WARN")):e.dim("INFO")}export function colorSectionLine(r){return r==="Case store issues:"||r==="Diagnosis:"?e.bold(r):/^Summary: /.test(r)?r.replace("Summary:",e.bold("Summary:")):/^Result: PASSED\b/.test(r)?r.replace("PASSED",e.green("PASSED")):/^Result: FAILED\b/.test(r)?r.replace("FAILED",e.red("FAILED")):r}

package/dist/cli/terminal/layout.d.ts

@@ -0,0 +1,11 @@
+export interface TerminalWidthSource {
+    columns?: unknown;
+}
+export interface RenderIndentedBlockOptions {
+    indent?: string;
+    width: number;
+}
+export declare function getTerminalWidth(stream?: Readonly<TerminalWidthSource>, fallback?: number): number;
+export declare function measureWidth(text: string): number;
+export declare function wrapText(text: string, width: number): string[];
+export declare function renderIndentedBlock(text: string, { width, indent }: Readonly<RenderIndentedBlockOptions>): string[];

package/dist/cli/terminal/layout.js

@@ -0,0 +1,2 @@
+import u from"string-width";import s from"wrap-ansi";export function getTerminalWidth(r=process.stdout,t=100){const n=Number(r.columns);return Number.isFinite(n)&&n>0?n:t}export function measureWidth(r){return u(r)}export function wrapText(r,t){return t<=0?[r]:s(r,t,{hard:!0,trim:!1,wordWrap:!0}).split(`
+`)}export function renderIndentedBlock(r,{width:t,indent:n="    "}){const e=measureWidth(n),o=Math.max(12,t-e);return wrapText(r,o).map(i=>`${n}${i}`)}

package/dist/cli/version-drift.d.ts

@@ -0,0 +1,25 @@
+export interface CliVersionDriftOptions {
+    binUrl?: string | URL;
+    currentPackageRoot?: string;
+    cwd?: string;
+}
+export interface CliVersionMismatch {
+    code: "testkit_cli_version_mismatch";
+    current: {
+        packageRoot: string;
+        version: string;
+    };
+    hint: string;
+    message: string;
+    product: {
+        declaredSpec: string | null;
+        dir: string;
+        packageRoot: string | null;
+        version: string | null;
+    };
+}
+export declare function checkCliVersionDrift(args: readonly string[], options?: Readonly<CliVersionDriftOptions>): CliVersionMismatch | null;
+export declare function emitCliVersionDriftAndExit(mismatch: CliVersionMismatch | null | undefined, { json, }?: Readonly<{
+    json?: boolean;
+}>): boolean;
+export declare function isJsonMode(args?: readonly string[]): boolean;

package/dist/cli/version-drift.js

@@ -0,0 +1,7 @@
+import{inspectPackageVersionDrift as a}from"../app/package-inspection.js";export function checkCliVersionDrift(t,e={}){if(S(t))return null;const r=a({...e,binUrl:e.binUrl||import.meta.url,dir:g(t)});return r?p({...r,args:t}):null}export function emitCliVersionDriftAndExit(t,{json:e=!1}={}){if(!t)return!1;const r=f;return e?r.writeStandardOutput(`${JSON.stringify({error:t},null,2)}
+`):(r.writeStandardError(`${t.message}
+`),r.writeStandardError(`Current binary: @gfdelarue/testkit ${t.current.version} (${t.current.packageRoot})
+`),t.product.version&&t.product.packageRoot&&r.writeStandardError(`Product install: @gfdelarue/testkit ${t.product.version} (${t.product.packageRoot})
+`),t.product.declaredSpec&&r.writeStandardError(`Product declaration: ${t.product.declaredSpec}
+`),r.writeStandardError(`Run: ${t.hint}
+`)),r.setExitCode(1),!0}export function isJsonMode(t=[]){return o(t).includes("--json")}const f=Object.freeze({setExitCode(t){process.exitCode=t},writeStandardError(t){process.stderr.write(t)},writeStandardOutput(t){process.stdout.write(t)}});function p({productDir:t,currentPackageRoot:e,currentVersion:r,productPackageRoot:n,productVersion:i,declaredSpec:s,args:d}){const c=n?"./node_modules/.bin/testkit":"npm exec testkit --",l=`cd ${u(t)} && ${c} ${$(k(d))}`.trim();return{code:"testkit_cli_version_mismatch",message:`Testkit CLI version mismatch for ${t}`,current:{version:r,packageRoot:e},product:{dir:t,version:i,packageRoot:n,declaredSpec:s||null},hint:l}}function S(t=[]){const e=t[0];return!!(!e||e==="--help"||e==="-h"||e==="--version"||e==="-v"||e==="help"||e==="cloud"&&["login","status","session","logout","list","show","project","campaign","policy","download","snapshot"].includes(t[1]??""))}function k(t=[]){const e=[];for(let r=0;r<t.length;r+=1){const n=t[r];if(n==="--"){e.push(...t.slice(r));break}if(n==="--dir"){const i=t.at(r+1);i!==void 0&&i!=="--"&&(r+=1);continue}n.startsWith("--dir=")||e.push(n)}return e}function g(t){const e=o(t);for(let r=0;r<e.length;r+=1){const n=e[r];if(n==="--dir"){const i=e.at(r+1);return i&&(i==="-"||!i.startsWith("-"))?i:null}if(n.startsWith("--dir="))return n.slice(6)||null}return null}function o(t){const e=t.indexOf("--");return e<0?t:t.slice(0,e)}function $(t=[]){return t.map(u).join(" ")}function u(t){const e=t;return/^[A-Za-z0-9_./:=@+-]+$/u.test(e)?e:`'${e.replace(/'/g,"'\\''")}'`}

package/dist/cloud/account.d.ts

@@ -0,0 +1,34 @@
+export declare function cloudOrigin(value: string): string;
+export declare function isCloudAccountToken(value: unknown): value is string;
+export interface AccountSession {
+    user: {
+        id: string;
+        email: string;
+        name: string;
+    };
+    expiresAt: string;
+    maximumExpiresAt: string;
+}
+export interface LoginRequest {
+    deviceCode: string;
+    userCode: string;
+    verificationUrl: string;
+    expiresIn: number;
+    interval: number;
+}
+export declare class CloudAccountClient {
+    private readonly token?;
+    readonly origin: string;
+    constructor(origin: string, token?: string | undefined);
+    downloadArtifact(url: URL, target: string, expected: {
+        bytes: number;
+        sha256: string;
+    }): Promise<void>;
+    login(): Promise<LoginRequest>;
+    poll(deviceCode: string): Promise<AccountSession>;
+    session(): Promise<AccountSession>;
+    refresh(): Promise<AccountSession>;
+    revoke(deviceCode: string): Promise<void>;
+    request(method: string, target: string, input?: unknown): Promise<unknown>;
+}
+export declare function parseSession(value: unknown): AccountSession;

package/dist/cloud/account.js

@@ -0,0 +1 @@
+import{downloadVerifiedArtifact as p}from"./download.js";import{request as u,invalidResponse as i}from"./transport.js";import{parseResponse as c}from"./client.js";import{isUnknownRecord as a}from"../kernel/unknown-values.js";export function cloudOrigin(t){const e=new URL(t);if(!["https:","http:"].includes(e.protocol)||e.username||e.password||e.pathname!=="/"||e.search||e.hash)throw new Error("Testkit Cloud URL must be an HTTP or HTTPS origin without credentials, a path, query, or fragment");if(e.protocol==="http:"&&!["localhost","127.0.0.1","[::1]"].includes(e.hostname))throw new Error("Testkit Cloud account credentials require HTTPS except on localhost");return e.origin}export function isCloudAccountToken(t){return typeof t=="string"&&/^tkc_cli_[A-Za-z0-9_-]{43}$/.test(t)}export class CloudAccountClient{token;origin;constructor(e,r){this.token=r,this.origin=cloudOrigin(e)}async downloadArtifact(e,r,s){if(e.origin!==this.origin||e.username||e.password)throw i("Cloud request URL");await p(e,this.token??"",r,s)}async login(){const e=await this.request("POST","/api/v1/auth/cli",{});if(!a(e)||!isCloudAccountToken(e.deviceCode)||typeof e.userCode!="string"||!/^[A-Z2-7]{4}-[A-Z2-7]{4}-[A-Z2-7]{4}$/.test(e.userCode)||typeof e.verificationUrl!="string"||typeof e.expiresIn!="number"||!Number.isInteger(e.expiresIn)||e.expiresIn<1||e.expiresIn>1800||typeof e.interval!="number"||!Number.isInteger(e.interval)||e.interval<1||e.interval>60)throw i("CLI login request");let r;try{r=new URL(e.verificationUrl)}catch{throw i("CLI approval URL")}if(r.origin!==this.origin||r.username||r.password||r.pathname!=="/cli/authorize"||r.searchParams.get("code")!==e.userCode)throw i("CLI approval URL");return{deviceCode:e.deviceCode,userCode:e.userCode,verificationUrl:r.href,expiresIn:e.expiresIn,interval:e.interval}}async poll(e){return parseSession(await this.request("POST","/api/v1/auth/cli/poll",{deviceCode:e}))}async session(){return parseSession(await this.request("GET","/api/v1/auth/cli/session"))}async refresh(){return parseSession(await this.request("POST","/api/v1/auth/cli/refresh",{}))}async revoke(e){await this.request("POST","/api/v1/auth/cli/revoke",{deviceCode:e})}async request(e,r,s){const o=new URL(r,this.origin);if(o.origin!==this.origin||o.username||o.password)throw i("Cloud request URL");const n=s===void 0?null:Buffer.from(JSON.stringify(s));return c(await u({method:e,url:o,body:n,timeoutMs:3e4,maxResponseBytes:4*1024*1024,headers:{Accept:"application/json","User-Agent":"testkit",...this.token?{Authorization:`Bearer ${this.token}`}:{},...n?{"Content-Type":"application/json","Content-Length":String(n.length)}:{}}}))}}export function parseSession(t){if(!a(t)||!a(t.user)||typeof t.user.id!="string"||!t.user.id||typeof t.user.email!="string"||!t.user.email||typeof t.user.name!="string"||typeof t.expiresAt!="string"||!Number.isFinite(Date.parse(t.expiresAt))||typeof t.maximumExpiresAt!="string"||!Number.isFinite(Date.parse(t.maximumExpiresAt)))throw i("CLI session");return{user:{id:t.user.id,email:t.user.email,name:t.user.name},expiresAt:t.expiresAt,maximumExpiresAt:t.maximumExpiresAt}}

package/dist/cloud/archive-contract.d.ts

@@ -0,0 +1 @@
+export declare const MAX_CLOUD_ARCHIVE_BYTES: number;

package/dist/cloud/archive-contract.js

@@ -0,0 +1 @@
+export const MAX_CLOUD_ARCHIVE_BYTES=2164260864;

package/dist/cloud/archive.d.ts

@@ -0,0 +1,12 @@
+import type { RunBundleManifest, RunBundleUploadFile } from "../evidence/contracts.js";
+import type { HistoricalManifest } from "./historical-contract.js";
+export interface UploadArchiveSource {
+    manifest: RunBundleManifest | HistoricalManifest;
+    files: readonly Pick<RunBundleUploadFile, "path" | "absolutePath" | "bytes" | "sha256">[];
+}
+export declare function withUploadArchive<Result>(source: UploadArchiveSource, maxBytes: number, upload: (file: string, bytes: number) => Promise<Result>): Promise<Result>;
+/** Write one verified ZIP to a caller-owned, previously absent path. */
+export declare function writeUploadArchive(source: UploadArchiveSource, maxBytes: number, target: string, serializeManifest?: (manifest: UploadArchiveSource["manifest"]) => string): Promise<{
+    bytes: number;
+    sha256: string;
+}>;

package/dist/cloud/archive.js

@@ -0,0 +1 @@
+import O from"node:crypto";import t from"node:fs";import E from"node:path";import{Readable as L,Transform as x}from"node:stream";import{finished as T,pipeline as $}from"node:stream/promises";import{ZipFile as F}from"yazl";import{makeTempDir as R,removeTempDir as V}from"../process/files/temp-dir.js";export async function withUploadArchive(l,u,d){const c=R("testkit-cloud-"),p=E.join(c,"archive.zip");try{const o=await writeUploadArchive(l,u,p);return await d(p,o.bytes)}finally{V(c)}}export async function writeUploadArchive(l,u,d,c=JSON.stringify){const p=t.openSync(d,"wx",384),o=new F;let a,m,S=!1,y=0;const v=O.createHash("sha256"),f=new x({transform(i,e,h){y+=i.length,v.update(i),h(y>u?new Error("Cloud archive exceeds upload size limit"):null,i)}});o.on("error",i=>f.destroy(i));const w=$(o.outputStream,f,t.createWriteStream(d,{fd:p}));w.catch(()=>{});try{const i={mtime:new Date("1980-01-01T00:00:00Z"),forceDosTimestamp:!0,mode:33152};o.addBuffer(Buffer.from(c(l.manifest)),"manifest.json",i);for(const e of l.files)o.addReadStreamLazy(`files/${e.path}`,{...i,size:e.bytes},h=>{let s;try{const n=t.lstatSync(e.absolutePath);if(!n.isFile()||n.isSymbolicLink()||n.size!==e.bytes)throw new Error(`Verified bundle file changed before upload: ${e.path}`);s=t.openSync(e.absolutePath,t.constants.O_RDONLY|t.constants.O_NOFOLLOW);const b=t.fstatSync(s);if(b.ino!==n.ino||b.dev!==n.dev||b.size!==e.bytes)throw new Error(`Verified bundle file changed before upload: ${e.path}`);const z=O.createHash("sha256");let g=0;m=new x({transform(r,_,D){g+=r.length,z.update(r),D(g>e.bytes?new Error(`Verified bundle file changed during upload: ${e.path}`):null,r)},flush(r){r(g!==e.bytes||z.digest("hex")!==e.sha256?new Error(`Verified bundle file changed during upload: ${e.path}`):null)}}),m.on("error",r=>f.destroy(r)),a=t.createReadStream(e.absolutePath,{fd:s}),s=void 0,a.on("error",r=>f.destroy(r)),h(null,a.pipe(m))}catch(n){s!==void 0&&t.closeSync(s),h(n,L.from([]))}});return o.end(),await w,S=!0,{bytes:y,sha256:v.digest("hex")}}finally{a?.destroy(),a&&await T(a).catch(()=>{}),m?.destroy(),f.destroy(),await w.catch(()=>{}),S||t.rmSync(d,{force:!0})}}