@gfdelarue/testkit 0.3.0

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

@@ -0,0 +1,61 @@
+import type { EngineId } from "../../domain/identifiers.js";
+export interface TestkitTypecheckOptions {
+    dir?: null | string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}
+export interface TypecheckProgram {
+    cwd: string;
+    label: string;
+    tsconfigPath: string;
+}
+export interface TypecheckProgramResult {
+    exitCode: null | number;
+    label: string;
+    ok: boolean;
+    stderr: string;
+    stdout: string;
+    tsconfigPath: string;
+}
+export interface TestkitTypecheckResult {
+    ok: true;
+    productDir: string;
+    results: TypecheckProgramResult[];
+}
+export declare class TestkitTypecheckError extends Error {
+    readonly result: TypecheckProgramResult;
+    readonly results: TypecheckProgramResult[];
+    constructor(label: string, result: TypecheckProgramResult, results: TypecheckProgramResult[]);
+}
+export type TypeScriptPathMappings = Record<string, readonly string[]>;
+export interface BuildTypecheckCompilerOptionsInput {
+    engineId?: EngineId;
+    extendsPath?: null | string;
+    extraPaths?: Readonly<TypeScriptPathMappings>;
+    libs: readonly string[];
+    rootDir?: string;
+    tsconfigPath: string;
+    types: readonly string[];
+}
+export interface TypecheckCompilerOptions {
+    allowJs?: true;
+    baseUrl: null;
+    checkJs?: false;
+    lib: readonly string[];
+    module: "ESNext";
+    moduleResolution: "Bundler";
+    noEmit: true;
+    paths: TypeScriptPathMappings;
+    rootDir?: string;
+    target: "ES2022";
+    typeRoots: readonly string[];
+    types: readonly string[];
+}
+export interface NextRuntimeTypePathsInput {
+    serviceDir: string;
+    tsconfigPath: string;
+}
+export declare function runTestkitTypecheck(options?: Readonly<TestkitTypecheckOptions>): Promise<TestkitTypecheckResult>;
+export declare function requireManagedPublicPackageIdentity(manifest: unknown, packageName: string, expectedVersion: string): void;
+export declare function buildTypecheckCompilerOptions({ engineId, tsconfigPath, extendsPath, rootDir, extraPaths, libs, types, }: Readonly<BuildTypecheckCompilerOptionsInput>): TypecheckCompilerOptions;
+export declare function nextRuntimeTypePaths({ tsconfigPath, serviceDir, }: Readonly<NextRuntimeTypePathsInput>): TypeScriptPathMappings;

package/dist/app/typecheck/index.js

@@ -0,0 +1,4 @@
+import{attachErrorDiagnostics as w}from"../../kernel/error-serialization.js";import{isPathWithin as E}from"../../process/files/paths.js";import d from"fs";import r from"path";import{createHash as S}from"crypto";import{createRequire as j}from"module";import{fileURLToPath as _}from"url";import m from"typescript";import{NODE_VITEST_PACKAGE_REQUIREMENTS as O}from"../../engines/installations/node-vitest.js";import{PLAYWRIGHT_PACKAGE_FAMILY_REQUIREMENTS as C}from"../../engines/installations/playwright.js";import{detectNextApp as A,discoverTests as $,loadConfigContext as R,resolveServiceCwd as M}from"../../config/loader/index.js";import{K6_POSTGRES_DRIVER_SPECIFIER as I,K6_POSTGRES_DRIVER_TYPE_FILE as F,K6_RUNTIME_GLOBAL_TYPE_FILE as N}from"../../engines/k6/authoring-type-paths.js";import{managedHostProcessInfrastructureError as L,runManagedHostProcess as D}from"../../process/index.js";import{CONFIGURED_STEP_TESTKIT_MODULE_DIST_PATHS as G}from"../../steps/configured-step-testkit-modules.js";import{findPlaywrightConfigFile as U}from"../../engines/playwright/runtime/config-file.js";const K=600*1e3,y=r.resolve(r.dirname(_(import.meta.url)),"..","..",".."),b=j(r.join(y,"package.json")),z={...J(["@gfdelarue/testkit","@gfdelarue/testkit/config","@gfdelarue/testkit/config/build-assets","@gfdelarue/testkit/config/next-runtime-tsconfig","@gfdelarue/testkit/config/database-steps","@gfdelarue/testkit/drizzle","@gfdelarue/testkit/env","@gfdelarue/testkit/tooling/vitest"]),"@gfdelarue/testkit/k6":["engines","k6","runtime","index.d.ts"],"@gfdelarue/testkit/playwright":["engines","playwright","runtime","index.d.ts"],"@gfdelarue/testkit/node-vitest/data":["engines","node-vitest","runtime","data","index.d.ts"],"@gfdelarue/testkit/node-vitest/contract":["engines","node-vitest","runtime","contract","index.d.ts"],"@gfdelarue/testkit/workspace":["app","inspect","index.d.ts"]};function J(e){return Object.fromEntries(e.map(n=>{const t=G[n],s=t[t.length-1];return[n,[...t.slice(0,-1),`${s}.d.ts`]]}))}export class TestkitTypecheckError extends Error{result;results;constructor(n,t,s){super(`testkit typecheck failed for ${n}`),this.result=t,this.results=s,w(this,{result:t,results:s})}}export async function runTestkitTypecheck(e={}){const n=te(e.timeoutMs),t=await R({dir:e.dir}),s=t.productDir,o=r.join(s,".testkit","_typecheck");d.mkdirSync(o,{recursive:!0});const i=[];if(t.configFile){const p=q({productDir:s,configFile:t.configFile,outputDir:o});i.push({label:"config",cwd:s,tsconfigPath:p})}const a=await $({dir:s,diagnostics:"error"}),c=a.files.map(p=>({engineId:p.engineId,path:p.path})),u=new Set(a.files.filter(p=>p.engineId==="playwright").map(p=>p.service));for(const p of t.configs){if(!u.has(p.name))continue;const k=U(M(s,p.testkit.local?.cwd));k&&c.push({engineId:"playwright",path:k})}const g=H(s,c);for(const p of g){const k=B({...p,outputDir:o,productDir:s});i.push({label:Q(p.engineId,p.scopeName),cwd:p.cwd,tsconfigPath:k})}const f=[];for(const p of i){const k=await ee(p,n,e.signal);if(f.push(k),!k.ok)throw new TestkitTypecheckError(p.label,k,f)}return{ok:!0,productDir:s,results:f}}function q({productDir:e,configFile:n,outputDir:t}){const s=r.join(t,"config.tsconfig.json"),o=P(e),i={...o?{extends:l(s,o)}:{},compilerOptions:buildTypecheckCompilerOptions({tsconfigPath:s,extendsPath:o,libs:["ES2022"],rootDir:l(s,e),types:["node"]}),files:[l(s,n)],include:[],exclude:[h(s,e,"node_modules"),h(s,e,"dist"),h(s,e,".testkit")]};return d.writeFileSync(s,`${JSON.stringify(i,null,2)}
+`),s}function B({productDir:e,cwd:n,engineId:t,extendsPath:s,files:o,outputDir:i,scopeName:a}){const c=r.join(i,`${t}.${X(a)}.tsconfig.json`),u=t==="playwright",g=u&&A(n),f={...s?{extends:l(c,s)}:{},compilerOptions:{...buildTypecheckCompilerOptions({engineId:t,tsconfigPath:c,extendsPath:s,libs:V(t),...g?{extraPaths:nextRuntimeTypePaths({tsconfigPath:c,serviceDir:n})}:{},types:W(t)}),...u?{allowJs:!0,checkJs:!1}:{}},files:[...ce(t,c),...o.map(p=>l(c,p))],include:g?[...d.existsSync(r.join(n,"next-env.d.ts"))?[l(c,r.join(n,"next-env.d.ts"))]:[],h(c,n,"tests/playwright-fixtures/**/*.ts"),h(c,n,"tests/playwright-fixtures/**/*.tsx"),h(c,n,"tests/playwright-fixtures/**/*.mts"),h(c,n,".next/types/**/*.ts"),h(c,n,".next/dev/types/**/*.ts"),h(c,e,".next-testkit/**/dist/types/**/*.ts"),h(c,e,".next-testkit/**/dist/dev/types/**/*.ts")]:[],exclude:["node_modules",".next/cache",".next/dev"]};return d.writeFileSync(c,`${JSON.stringify(f,null,2)}
+`),c}function H(e,n){const t=new Map,s=new Map;for(const o of n){const i=r.resolve(e,o.path),a=[o.engineId,i].join("\0");s.set(a,{...o,path:i})}for(const o of s.values()){const i=o.path,a=o.engineId==="playwright"?v(r.dirname(i),e,["tsconfig.playwright.json"]):null,c=a??v(r.dirname(i),e),u=c?r.dirname(c):e,g=Z(e,u),f=`${o.engineId}\0${c??""}\0${g}`,p=t.get(f);if(p){p.files.push(i);continue}t.set(f,{cwd:u,engineId:o.engineId,extendsPath:c,files:[i,...a?Y(a):[]],scopeName:g})}return[...t.values()].map(o=>({...o,files:[...new Set(o.files)].sort((i,a)=>i.localeCompare(a))})).sort((o,i)=>T(o.engineId)-T(i.engineId)||o.scopeName.localeCompare(i.scopeName))}function Y(e){const n=s=>{throw new Error(`${e}: ${m.flattenDiagnosticMessageText(s.messageText,`
+`)}`)},t=m.getParsedCommandLineOfConfigFile(e,{},{...m.sys,onUnRecoverableConfigFileDiagnostic:n});for(const s of t?.errors??[])s.code!==18002&&s.code!==18003&&n(s);return t?.fileNames??[]}function W(e){switch(e){case"k6":return["k6","xk6-sql"];case"node-vitest":case"playwright":return["node"]}}function V(e){return e==="playwright"?["ES2022","DOM","DOM.Iterable"]:["ES2022"]}function T(e){return["k6","node-vitest","playwright"].indexOf(e)}function Q(e,n){return n==="repo"?e:`${e}:${n}`}function Z(e,n){const t=r.relative(e,n);return t===""?"repo":t.split(r.sep).join("/")}function X(e){const n=e.replace(/[^a-zA-Z0-9_-]+/g,"-");if(n===e)return e;const t=S("sha256").update(e).digest("hex").slice(0,12);return`${n}-${t}`}function ee({label:e,cwd:n,tsconfigPath:t},s,o){const i=ne(n);return D({args:[...i.args,"--noEmit","-p",t],cwd:n,displayLabel:`Testkit typecheck ${e}`,env:process.env,executable:i.command,signal:o,timeoutMs:s}).then(a=>{const c=L(`Testkit typecheck ${e}`,a);if(c)throw c;return{label:e,tsconfigPath:t,ok:a.exitCode===0,exitCode:a.exitCode,stdout:a.stdout,stderr:a.stderr}})}function te(e){const n=e??K;if(!Number.isSafeInteger(n)||n<=0)throw new Error("Testkit typecheck timeout must be a positive safe integer in milliseconds");return n}function ne(e){let n=e;for(;;){const s=r.join(n,"node_modules","typescript","bin","tsc");if(d.existsSync(s))return{command:process.execPath,args:[s]};const o=r.dirname(n);if(o===n)break;n=o}const t=r.join(y,"node_modules","typescript","bin","tsc");if(d.existsSync(t))return{command:process.execPath,args:[t]};throw new Error(`TypeScript compiler not found from ${e} upward`)}function P(e,n=["tsconfig.json","tsconfig.build.json"]){for(const t of n){const s=r.join(e,t);if(d.existsSync(s))return s}return null}function v(e,n,t){const s=r.resolve(n);let o=r.resolve(e);for(;;){if(!E(s,o))return null;const i=P(o,t);if(i)return i;if(o===s)return null;const a=r.dirname(o);if(a===o)return null;o=a}}function l(e,n){const t=r.relative(r.dirname(e),n).split(r.sep).join("/");return t.startsWith("../")||r.isAbsolute(t)?t:`./${t}`}function h(e,n,t){return r.join(l(e,n),t).split(r.sep).join("/")}function se(e){const n={};for(const[t,s]of Object.entries(z))n[t]=[l(e,r.join(y,"dist",...s))];return n}const oe=Object.freeze({packages:Object.freeze(O.filter(({authoringResolution:e})=>e==="package-exports").map(({packageName:e})=>Object.freeze({name:e}))),supportedExports:"exact-manifest-exports"}),re=Object.freeze({packages:Object.freeze(C.map(({packageName:e})=>Object.freeze({name:e}))),supportedExports:"exact-manifest-exports"});function ie(e,n){const t=pe(e);if(t===null)return{};const s={},o=l(n,r.join(y,"dist","app","typecheck","unavailable.d.ts"));for(const i of t.packages){const a=ue(i.name),c=de(i.name,a);s[`${i.name}/*`]=[o];for(const u of Object.keys(c).sort()){if(u!=="."&&!u.startsWith("./")||u.includes("*"))continue;const g=u==="."?i.name:`${i.name}${u.slice(1)}`,f=fe(g,i.name,a);s[g]=[f===null?o:l(n,f)]}}return s}function ce(e,n){return e==="k6"?[l(n,r.join(y,"dist",...N))]:[]}function ae(e,n){return e==="k6"?{[I]:[l(n,r.join(y,"dist",...F))]}:{}}function pe(e){switch(e){case"node-vitest":return oe;case"playwright":return re;case"k6":case void 0:return null}}function ue(e){const n=le(e);let t;try{t=b.resolve(`${e}/package.json`)}catch(i){throw new Error(`Testkit typecheck requires managed public package ${e}`,{cause:i})}const s=d.realpathSync.native(r.dirname(t)),o=JSON.parse(d.readFileSync(r.join(s,"package.json"),"utf8"));return requireManagedPublicPackageIdentity(o,e,n),s}export function requireManagedPublicPackageIdentity(e,n,t){if(!x(e)||e.name!==n||e.version!==t)throw new Error(`Testkit managed public package has invalid identity: expected ${n}@${t}`)}function le(e){const n=JSON.parse(d.readFileSync(r.join(y,"package.json"),"utf8"));if(!x(n)||!x(n.dependencies))throw new Error("Testkit package has invalid dependency metadata");const t=n.dependencies[e];if(typeof t!="string"||!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/u.test(t))throw new Error(`Testkit managed public package ${e} must be an exact root dependency`);return t}function x(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function de(e,n){const t=JSON.parse(d.readFileSync(r.join(n,"package.json"),"utf8"));if(typeof t!="object"||t===null||Array.isArray(t)||!("name"in t)||t.name!==e||!("exports"in t)||typeof t.exports!="object"||t.exports===null||Array.isArray(t.exports))throw new Error(`Testkit managed public package has invalid exports: ${e}`);return t.exports}function fe(e,n,t){const s=m.resolveModuleName(e,r.join(y,"__testkit_managed_public_types__.ts"),{module:m.ModuleKind.ESNext,moduleResolution:m.ModuleResolutionKind.Bundler,resolveJsonModule:!0,target:m.ScriptTarget.ES2022},m.sys).resolvedModule;if(s===void 0)return null;const o=d.realpathSync.native(s.resolvedFileName);if(!E(t,o))throw new Error(`Managed public package type ${e} resolved outside ${n}`);return o}export function buildTypecheckCompilerOptions({engineId:e,tsconfigPath:n,extendsPath:t,rootDir:s,extraPaths:o={},libs:i,types:a}){const u={...t?he({tsconfigPath:n,extendsPath:t}):{},...o,...se(n),...ie(e,n),...ae(e,n)};return{baseUrl:null,lib:[...i],module:"ESNext",moduleResolution:"Bundler",noEmit:!0,...s?{rootDir:s}:{},target:"ES2022",typeRoots:ge(a,n),types:[...a],paths:u}}function ge(e,n){const t=new Set;for(const s of e){if(s==="k6"||s==="xk6-sql"){const c=r.join(y,"dist","engines","k6","runtime","ambient-types");if(!d.existsSync(r.join(c,s,"index.d.ts")))throw new Error(`Testkit typecheck requires bundled ${s} authoring types; rebuild the installed Testkit package`);t.add(c);continue}const o=me(s);let i;try{i=b.resolve(`${o}/package.json`)}catch(c){throw new Error(`Testkit typecheck requires installed type package ${o}`,{cause:c})}const a=r.dirname(i);t.add(r.dirname(a))}return[...t].map(s=>l(n,s))}function me(e){return e==="node"||e==="k6"?`@types/${e}`:e}function he({tsconfigPath:e,extendsPath:n}){const t=m.getParsedCommandLineOfConfigFile(n,{},{...m.sys,onUnRecoverableConfigFileDiagnostic:()=>{}}),s=t?.options.paths;if(!s||Object.keys(s).length===0)return{};const o=t.options.baseUrl||(typeof t.options.pathsBasePath=="string"?t.options.pathsBasePath:r.dirname(n)),i={};for(const[a,c]of Object.entries(s))i[a]=c.map(u=>l(e,r.resolve(o,u)));return i}export function nextRuntimeTypePaths({tsconfigPath:e,serviceDir:n}){const t=ye(n,[r.join("next","types.d.ts"),r.join("next","types.js")]);if(!t)return{};const s=l(e,t);return{"next/types":[s],"next/types.js":[s]}}function ye(e,n){let t=r.resolve(e);for(;;){for(const o of n){const i=r.join(t,"node_modules",o);if(d.existsSync(i))return i}const s=r.dirname(t);if(s===t)return null;t=s}}

package/dist/app/typecheck/unavailable.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/app/typecheck/unavailable.js

@@ -0,0 +1 @@
+export{};

package/dist/cli/cloud-apply-help.d.ts

@@ -0,0 +1 @@
+export declare const cloudApplyHelp = "Account command file:\n  Required envelope: schemaVersion: 1, idempotencyKey, operation, input: {}.\n  Add the scope IDs listed below. Omit unrelated scope IDs.\n  Keys use 1-128 characters without surrounding whitespace. Files are limited to 256 KiB.\n  Required input fields are listed below; optional fields are marked optional.\n\nOperations, scope, and input:\n  account.theme         no scope: theme (system|light|dark)\n  organisation.update   organisationId: name\n  invitation.create     organisationId: email, role (owner|admin|member|viewer)\n  invitation.revoke     organisationId, resourceId: {}\n  provider.create       organisationId: provider (gitea), host (HTTPS origin),\n                        displayName, oauthClientId, oauthClientSecret;\n                        optional botToken, caBundlePEM\n  provider.delete       organisationId, resourceId: {}\n  project.create        organisationId: name, provider (github|gitea), host,\n                        repository (owner/repo); optional publishDecisions (false)\n  project.publishing    projectId: enabled (boolean)\n  project.baseline      projectId: branch (empty string resets provider default)\n  project.retention     projectId: days (1-3650)\n  project.policy        projectId: policyId (string or null to inherit)\n  policy.create         organisationId: name; optional rules or sourcePolicyId\n  policy.revise         organisationId, resourceId: complete rules array\n  policy.default        organisationId, resourceId: {}\n  notification.create   projectId: kind (slack|email), displayName, target, events\n  notification.update   projectId, resourceId: enabled (boolean), events\n  notification.delete   projectId, resourceId: {}\n  notification.test     projectId, resourceId: {}; sends a test notification\n  token.create          projectId: name; requires --secret-output NEW_FILE\n  token.revoke          projectId, resourceId: {}\n\nNotification events: baseline_hold, case_opened, case_resolved; at least one.\nPolicy rules: id, kind, mode, branches, typed params. Read a policy before revising.\nFind scope and resource IDs with cloud list and cloud show.\nUse cloud session revoke ID to revoke a CLI login; token.revoke revokes a project token.\n\nExample command.json:\n  {\"schemaVersion\":1,\"idempotencyKey\":\"retention-30\",\"operation\":\"project.retention\",\n   \"projectId\":\"prj_example\",\"input\":{\"days\":30}}\n\nKeep secrets in private files. Token output never goes to stdout.\nRetry the identical command/key after a lost response; changing the command conflicts.\nIf a token was issued but saving failed, retry the same key with a new --secret-output.\nFor outcome_uncertain, inspect cloud list/show and audit history before choosing a new key.\n\nOther file formats:\n  Versioned case commands: schemaVersion: 1, projectId, idempotencyKey,\n  expectedVersion, commands. Read current versions with cloud snapshot.\n  Each case command has caseId and type: case.set_state (state: active|resolved),\n  case.classify (classification: untriaged|regression|flaky|expected|quarantined),\n  or case.link_issue (issueRepository, positive issueNumber).\n  Campaign reports with --campaign ID: schemaVersion: 1, projectId, campaignId,\n  idempotencyKey, expectedVersion, command. Command types: state.report, receipt.link,\n  finding.record, finding.update, finding.verify, finding.relate, verification.settings.update.\n  Campaign verification can load product configuration from --dir.\n  See the installed docs/testkit-cloud-boundary.md for complete case and campaign formats.";

package/dist/cli/cloud-apply-help.js

@@ -0,0 +1,56 @@
+export const cloudApplyHelp=`Account command file:
+  Required envelope: schemaVersion: 1, idempotencyKey, operation, input: {}.
+  Add the scope IDs listed below. Omit unrelated scope IDs.
+  Keys use 1-128 characters without surrounding whitespace. Files are limited to 256 KiB.
+  Required input fields are listed below; optional fields are marked optional.
+
+Operations, scope, and input:
+  account.theme         no scope: theme (system|light|dark)
+  organisation.update   organisationId: name
+  invitation.create     organisationId: email, role (owner|admin|member|viewer)
+  invitation.revoke     organisationId, resourceId: {}
+  provider.create       organisationId: provider (gitea), host (HTTPS origin),
+                        displayName, oauthClientId, oauthClientSecret;
+                        optional botToken, caBundlePEM
+  provider.delete       organisationId, resourceId: {}
+  project.create        organisationId: name, provider (github|gitea), host,
+                        repository (owner/repo); optional publishDecisions (false)
+  project.publishing    projectId: enabled (boolean)
+  project.baseline      projectId: branch (empty string resets provider default)
+  project.retention     projectId: days (1-3650)
+  project.policy        projectId: policyId (string or null to inherit)
+  policy.create         organisationId: name; optional rules or sourcePolicyId
+  policy.revise         organisationId, resourceId: complete rules array
+  policy.default        organisationId, resourceId: {}
+  notification.create   projectId: kind (slack|email), displayName, target, events
+  notification.update   projectId, resourceId: enabled (boolean), events
+  notification.delete   projectId, resourceId: {}
+  notification.test     projectId, resourceId: {}; sends a test notification
+  token.create          projectId: name; requires --secret-output NEW_FILE
+  token.revoke          projectId, resourceId: {}
+
+Notification events: baseline_hold, case_opened, case_resolved; at least one.
+Policy rules: id, kind, mode, branches, typed params. Read a policy before revising.
+Find scope and resource IDs with cloud list and cloud show.
+Use cloud session revoke ID to revoke a CLI login; token.revoke revokes a project token.
+
+Example command.json:
+  {"schemaVersion":1,"idempotencyKey":"retention-30","operation":"project.retention",
+   "projectId":"prj_example","input":{"days":30}}
+
+Keep secrets in private files. Token output never goes to stdout.
+Retry the identical command/key after a lost response; changing the command conflicts.
+If a token was issued but saving failed, retry the same key with a new --secret-output.
+For outcome_uncertain, inspect cloud list/show and audit history before choosing a new key.
+
+Other file formats:
+  Versioned case commands: schemaVersion: 1, projectId, idempotencyKey,
+  expectedVersion, commands. Read current versions with cloud snapshot.
+  Each case command has caseId and type: case.set_state (state: active|resolved),
+  case.classify (classification: untriaged|regression|flaky|expected|quarantined),
+  or case.link_issue (issueRepository, positive issueNumber).
+  Campaign reports with --campaign ID: schemaVersion: 1, projectId, campaignId,
+  idempotencyKey, expectedVersion, command. Command types: state.report, receipt.link,
+  finding.record, finding.update, finding.verify, finding.relate, verification.settings.update.
+  Campaign verification can load product configuration from --dir.
+  See the installed docs/testkit-cloud-boundary.md for complete case and campaign formats.`;

package/dist/cli/cloud-selection.d.ts

@@ -0,0 +1,2 @@
+import type { ControlOptions } from "../app/cloud/control.js";
+export declare function cloudInteraction(json: boolean): Pick<ControlOptions, "notify" | "choose">;

package/dist/cli/cloud-selection.js

@@ -0,0 +1,3 @@
+import{createInterface as c}from"node:readline/promises";export function cloudInteraction(r){return{notify:e=>process.stderr.write(`${e.replace(/\n$/u,"")}
+`),...!r&&!process.env.CI&&process.stdin.isTTY&&process.stderr.isTTY?{choose:a}:{}}}async function a(r,e){const n=c({input:process.stdin,output:process.stderr});try{e.forEach((o,i)=>process.stderr.write(`${String(i+1)}. ${o.name} (${o.id})
+`));const s=(await n.question(`Select ${r} [1-${String(e.length)}]: `)).trim(),t=/^\d+$/u.test(s)?Number(s)-1:-1;if(!Number.isSafeInteger(t)||t<0||t>=e.length)throw new Error(`Invalid ${r} selection. Select an explicit ID with a command flag.`);return e[t].id}finally{n.close()}}

package/dist/cli/command-catalog.d.ts

@@ -0,0 +1,238 @@
+import { type CommandContext as FrameworkCommandContext } from "./framework/command.js";
+export declare const commandCatalog: Readonly<{
+    artifacts: import("./framework/command.js").CommandDefinition<{
+        readonly kind: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly format: import("./framework/definitions.js").FlagDefinition<"text" | "list">;
+        readonly run: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly list: import("./framework/definitions.js").FlagDefinition<boolean>;
+        readonly verify: import("./framework/definitions.js").FlagDefinition<boolean>;
+        readonly dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly service: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, {
+        readonly file: import("./framework/definitions.js").ArgumentDefinition<string | undefined>;
+    }>;
+    cleanup: import("./framework/command.js").CommandDefinition<{
+        readonly "dry-run": import("./framework/definitions.js").FlagDefinition<boolean>;
+        readonly cache: import("./framework/definitions.js").FlagDefinition<("runtime" | "all" | "bundles")[] | undefined>;
+        readonly resources: import("./framework/definitions.js").FlagDefinition<boolean>;
+        readonly dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly service: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, undefined>;
+    "cloud campaign create": import("./framework/command.js").CommandDefinition<{
+        readonly url: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly org: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly project: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly "request-key": import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly focus: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly "target-bugs": import("./framework/definitions.js").FlagDefinition<number | undefined>;
+    }, undefined>;
+    "cloud policy preview": import("./framework/command.js").CommandDefinition<{
+        readonly url: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly org: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly file: import("./framework/definitions.js").FlagDefinition<string>;
+    }, {
+        readonly policy: import("./framework/definitions.js").ArgumentDefinition<string>;
+    }>;
+    "cloud download": import("./framework/command.js").CommandDefinition<{
+        readonly url: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly receipt: import("./framework/definitions.js").FlagDefinition<string>;
+        readonly path: import("./framework/definitions.js").FlagDefinition<string>;
+        readonly output: import("./framework/definitions.js").FlagDefinition<string>;
+    }, undefined>;
+    "cloud list": import("./framework/command.js").CommandDefinition<{
+        readonly url: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly org: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly project: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly limit: import("./framework/definitions.js").FlagDefinition<number | undefined>;
+        readonly cursor: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly receipt: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly case: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly path: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly decision: import("./framework/definitions.js").FlagDefinition<"hold" | "ineligible" | "ship" | undefined>;
+        readonly pr: import("./framework/definitions.js").FlagDefinition<number | undefined>;
+        readonly sort: import("./framework/definitions.js").FlagDefinition<"accepted_at" | undefined>;
+        readonly direction: import("./framework/definitions.js").FlagDefinition<"asc" | "desc" | undefined>;
+        readonly flaky: import("./framework/definitions.js").FlagDefinition<boolean | undefined>;
+        readonly page: import("./framework/definitions.js").FlagDefinition<number | undefined>;
+        readonly branch: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly campaign: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly "root-cause-key": import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly "issue-reference": import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly view: import("./framework/definitions.js").FlagDefinition<"all" | "counted" | "secondary" | undefined>;
+        readonly order: import("./framework/definitions.js").FlagDefinition<"verified" | "created" | undefined>;
+    }, {
+        readonly resource: import("./framework/definitions.js").ArgumentDefinition<string>;
+    }>;
+    "cloud show": import("./framework/command.js").CommandDefinition<{
+        readonly url: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly org: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly project: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly campaign: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, {
+        readonly resource: import("./framework/definitions.js").ArgumentDefinition<"run" | "performance" | "connection" | "project" | "policy" | "campaign" | "finding" | "case" | "receipt" | "account" | "organisation" | "test-file" | "project-policy">;
+        readonly id: import("./framework/definitions.js").ArgumentDefinition<string | undefined>;
+    }>;
+    "cloud project create": import("./framework/command.js").CommandDefinition<{
+        readonly url: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly org: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly name: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly repository: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly provider: import("./framework/definitions.js").FlagDefinition<"github" | "gitea" | undefined>;
+        readonly host: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly "publish-decisions": import("./framework/definitions.js").FlagDefinition<boolean>;
+        readonly "request-key": import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly browser: import("./framework/definitions.js").FlagDefinition<boolean>;
+    }, undefined>;
+    "cloud login": import("./framework/command.js").CommandDefinition<{
+        readonly url: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly browser: import("./framework/definitions.js").FlagDefinition<boolean>;
+        readonly force: import("./framework/definitions.js").FlagDefinition<boolean | undefined>;
+    }, undefined>;
+    "cloud session revoke": import("./framework/command.js").CommandDefinition<{
+        readonly url: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, {
+        readonly id: import("./framework/definitions.js").ArgumentDefinition<string>;
+    }>;
+    "cloud status": import("./framework/command.js").CommandDefinition<{
+        readonly url: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, undefined>;
+    "cloud logout": import("./framework/command.js").CommandDefinition<{
+        readonly url: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, undefined>;
+    "cloud apply": import("./framework/command.js").CommandDefinition<{
+        readonly browser: import("./framework/definitions.js").FlagDefinition<boolean>;
+        readonly "secret-output": import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly campaign: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly file: import("./framework/definitions.js").FlagDefinition<string>;
+        readonly project: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly url: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, undefined>;
+    "cloud migrate plan": import("./framework/command.js").CommandDefinition<{
+        readonly source: import("./framework/definitions.js").FlagDefinition<string>;
+        readonly registry: import("./framework/definitions.js").FlagDefinition<string>;
+        readonly regressions: import("./framework/definitions.js").FlagDefinition<string>;
+        readonly mapping: import("./framework/definitions.js").FlagDefinition<string>;
+        readonly output: import("./framework/definitions.js").FlagDefinition<string>;
+        readonly url: import("./framework/definitions.js").FlagDefinition<string>;
+        readonly project: import("./framework/definitions.js").FlagDefinition<string>;
+        readonly campaign: import("./framework/definitions.js").FlagDefinition<string>;
+    }, undefined>;
+    "cloud migrate apply": import("./framework/command.js").CommandDefinition<{
+        readonly plan: import("./framework/definitions.js").FlagDefinition<string>;
+    }, undefined>;
+    "cloud migrate reconcile": import("./framework/command.js").CommandDefinition<{
+        readonly plan: import("./framework/definitions.js").FlagDefinition<string>;
+    }, undefined>;
+    "cloud publish": import("./framework/command.js").CommandDefinition<{
+        readonly campaign: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly project: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly run: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly url: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, undefined>;
+    "cloud snapshot": import("./framework/command.js").CommandDefinition<{
+        readonly campaign: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly finding: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly findings: import("./framework/definitions.js").FlagDefinition<boolean | undefined>;
+        readonly receipts: import("./framework/definitions.js").FlagDefinition<boolean | undefined>;
+        readonly history: import("./framework/definitions.js").FlagDefinition<boolean | undefined>;
+        readonly "root-cause-key": import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly "issue-reference": import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly view: import("./framework/definitions.js").FlagDefinition<"all" | "counted" | "secondary" | undefined>;
+        readonly limit: import("./framework/definitions.js").FlagDefinition<number | undefined>;
+        readonly cursor: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly project: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly url: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, undefined>;
+    "db schema refresh": import("./framework/command.js").CommandDefinition<{
+        dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        service: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, undefined>;
+    "db schema verify": import("./framework/command.js").CommandDefinition<{
+        readonly "skip-schema-source-verify": import("./framework/definitions.js").FlagDefinition<boolean>;
+        readonly dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly service: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, undefined>;
+    destroy: import("./framework/command.js").CommandDefinition<{
+        dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        service: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, undefined>;
+    discover: import("./framework/command.js").CommandDefinition<{
+        readonly type: import("./framework/definitions.js").FlagDefinition<string[] | undefined>;
+        readonly suite: import("./framework/definitions.js").FlagDefinition<string[] | undefined>;
+        readonly file: import("./framework/definitions.js").FlagDefinition<string[] | undefined>;
+        readonly "runnable-only": import("./framework/definitions.js").FlagDefinition<boolean>;
+        readonly strict: import("./framework/definitions.js").FlagDefinition<boolean>;
+        readonly output: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly "output-mode": import("./framework/definitions.js").FlagDefinition<"verbose" | "compact">;
+        readonly dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly service: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, undefined>;
+    doctor: import("./framework/command.js").CommandDefinition<{
+        readonly dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly typecheck: import("./framework/definitions.js").FlagDefinition<boolean>;
+    }, undefined>;
+    "guard unsafe-entrypoint": import("./framework/command.js").CommandDefinition<{
+        readonly command: import("./framework/definitions.js").FlagDefinition<string>;
+        readonly use: import("./framework/definitions.js").FlagDefinition<string>;
+    }, undefined>;
+    lint: import("./framework/command.js").CommandDefinition<{
+        readonly dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, undefined>;
+    "run status": import("./framework/command.js").CommandDefinition<{
+        readonly run: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly full: import("./framework/definitions.js").FlagDefinition<boolean | undefined>;
+        readonly dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly service: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, undefined>;
+    "run stop": import("./framework/command.js").CommandDefinition<{
+        readonly run: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly all: import("./framework/definitions.js").FlagDefinition<boolean>;
+        readonly reason: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly service: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, undefined>;
+    run: import("./framework/command.js").CommandDefinition<{
+        type: import("./framework/definitions.js").FlagDefinition<string[] | undefined>;
+        suite: import("./framework/definitions.js").FlagDefinition<string[] | undefined>;
+        file: import("./framework/definitions.js").FlagDefinition<string[] | undefined>;
+        "task-concurrency": import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        workers: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        "file-timeout-seconds": import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        "allow-empty": import("./framework/definitions.js").FlagDefinition<boolean>;
+        "ignore-skip-rules": import("./framework/definitions.js").FlagDefinition<boolean>;
+        "skip-schema-source-verify": import("./framework/definitions.js").FlagDefinition<boolean>;
+        "output-mode": import("./framework/definitions.js").FlagDefinition<"debug" | "events" | "compact" | undefined>;
+        debug: import("./framework/definitions.js").FlagDefinition<boolean>;
+        dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        service: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, {
+        readonly type: import("./framework/definitions.js").ArgumentDefinition<"contract" | "data" | "ui" | "e2e" | "int" | "dal" | "load" | "all" | undefined>;
+    }>;
+    "setup playwright": import("./framework/command.js").CommandDefinition<{
+        readonly dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly force: import("./framework/definitions.js").FlagDefinition<boolean>;
+        readonly "with-deps": import("./framework/definitions.js").FlagDefinition<boolean>;
+    }, undefined>;
+    status: import("./framework/command.js").CommandDefinition<{
+        dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        service: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, undefined>;
+    stop: import("./framework/command.js").CommandDefinition<{
+        readonly reason: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly service: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, undefined>;
+    typecheck: import("./framework/command.js").CommandDefinition<{
+        readonly dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, undefined>;
+    workspace: import("./framework/command.js").CommandDefinition<{
+        readonly "target-limit": import("./framework/definitions.js").FlagDefinition<number>;
+        readonly "no-status": import("./framework/definitions.js").FlagDefinition<boolean>;
+        readonly dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+        readonly service: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    }, undefined>;
+}>;
+export type CommandId = keyof typeof commandCatalog;
+export type CommandContext<Id extends CommandId> = FrameworkCommandContext<(typeof commandCatalog)[Id]>;

package/dist/cli/command-catalog.js

@@ -0,0 +1 @@
+import{cloudListResources as o,cloudShowResources as n}from"../app/cloud/control-resources.js";import{cloudApplyHelp as a}from"./cloud-apply-help.js";import{Args as r,Flags as e}from"./framework/definitions.js";import{defineCommand as t}from"./framework/command.js";import{sharedFlags as i,runFlags as l}from"./command-flags.js";import{publicTestTypeList as c,publicTestTypeListText as s}from"../domain/test-types.js";export const commandCatalog=Object.freeze({artifacts:t({summary:"List, verify, or inspect artifacts from immutable Testkit runs",enableJsonFlag:!0,args:{file:r.string({description:"Optional test file selector",required:!1})},flags:{...i,kind:e.string({description:"Limit artifacts to one kind"}),format:e.string({description:"Output format",options:["list","text"],default:"list"}),run:e.string({description:"Read one immutable run ID instead of latest"}),list:e.boolean({description:"List retained immutable runs",default:!1}),verify:e.boolean({description:"Verify the selected run manifest and checksums",default:!1})}}),cleanup:t({summary:"Clean stale local testkit state",enableJsonFlag:!0,flags:{...i,"dry-run":e.boolean({description:"Show cleanup actions without deleting state",default:!1}),cache:e.string({description:"Clean cache state: runtime, bundles, or all",multiple:!0,options:["runtime","bundles","all"]}),resources:e.boolean({description:"Clean Testkit-owned Docker resources that are stale or orphaned",default:!1})}}),"cloud campaign create":t({summary:"Create a campaign without starting tests or investigators",enableJsonFlag:!0,flags:{url:e.string({description:"Cloud origin"}),org:e.string({description:"Organisation selector"}),project:e.string({description:"Project ID, slug, or name"}),"request-key":e.string({description:"Reuse a key to retry the same creation"}),focus:e.string({description:"Campaign focus"}),"target-bugs":e.integer({description:"Target bug count"})}}),"cloud policy preview":t({summary:"Evaluate draft policy rules against a receipt without saving",enableJsonFlag:!0,args:{policy:r.string({required:!0,description:"Policy ID"})},flags:{url:e.string({description:"Cloud origin"}),org:e.string({description:"Organisation selector"}),file:e.string({required:!0,description:"JSON file with receiptId and rules"})}}),"cloud download":t({summary:"Download and verify a receipt artifact",enableJsonFlag:!0,flags:{url:e.string({description:"Cloud origin"}),receipt:e.string({required:!0,description:"Receipt ID"}),path:e.string({required:!0,description:"Exact manifest artifact path"}),output:e.string({required:!0,description:"New destination file"})}}),"cloud list":t({summary:"List Cloud resources with their identifiers and pagination",enableJsonFlag:!0,args:{resource:r.string({required:!0,options:Object.keys(o)})},flags:{url:e.string({description:"Cloud origin"}),org:e.string({description:"Organisation ID, slug, or unambiguous name"}),project:e.string({description:"Project ID, slug, or unambiguous name"}),limit:e.integer({description:"Page size"}),cursor:e.string({description:"Opaque nextCursor from the previous page"}),receipt:e.string({description:"Receipt for artifact metadata"}),case:e.string({description:"Case ID for history"}),path:e.string({description:"Exact test file path for history"}),decision:e.string({description:"Run decision",options:["ship","hold","ineligible"]}),pr:e.integer({description:"Pull request number"}),sort:e.string({description:"Run sort",options:["accepted_at"]}),direction:e.string({description:"Run order",options:["asc","desc"]}),flaky:e.boolean({description:"Only flaky tests"}),page:e.integer({description:"Run page number"}),branch:e.string({description:"Exact run branch"}),campaign:e.string({description:"Limit findings to a campaign"}),"root-cause-key":e.string({description:"Exact finding root cause key"}),"issue-reference":e.string({description:"Exact finding issue URL"}),view:e.string({description:"Finding view",options:["all","counted","secondary"]}),order:e.string({description:"Finding order",options:["created","verified"]})}}),"cloud show":t({summary:"Inspect a Cloud resource, result, or pending connection",enableJsonFlag:!0,args:{resource:r.string({required:!0,options:n}),id:r.string({description:"Resource ID or test file path"})},flags:{url:e.string({description:"Cloud origin"}),org:e.string({description:"Organisation ID, slug, or name"}),project:e.string({description:"Project ID, slug, or name"}),campaign:e.string({description:"Campaign for a finding"})}}),"cloud project create":t({summary:"Connect a repository to Cloud and wait for any provider consent",enableJsonFlag:!0,flags:{url:e.string({description:"Cloud origin"}),org:e.string({description:"Organisation ID, slug, or name"}),name:e.string({description:"Project name; defaults to repository name"}),repository:e.string({description:"owner/repo or remote URL; defaults to Git origin"}),provider:e.string({description:"Repository provider",options:["github","gitea"]}),host:e.string({description:"Repository host"}),"publish-decisions":e.boolean({description:"Explicitly enable provider decision publishing",default:!1}),"request-key":e.string({description:"Reuse the same key to resume an uncertain creation"}),browser:e.boolean({description:"Open provider consent in the browser",allowNo:!0,default:!0})}}),"cloud login":t({summary:"Connect your Cloud account through browser approval",enableJsonFlag:!0,flags:{url:e.string({description:"Testkit Cloud origin"}),browser:e.boolean({description:"Open the approval link in your browser",allowNo:!0,default:!0}),force:e.boolean({description:"Start a new approval to switch accounts or replace a session"})}}),"cloud session revoke":t({summary:"Revoke one of your Cloud CLI sessions",enableJsonFlag:!0,args:{id:r.string({required:!0,description:"Session ID from cloud list sessions"})},flags:{url:e.string({description:"Testkit Cloud origin"})}}),"cloud status":t({summary:"Show the Cloud origin, credential source, and signed-in account",enableJsonFlag:!0,flags:{url:e.string({description:"Testkit Cloud origin"})}}),"cloud logout":t({summary:"Revoke and remove the saved Cloud account session",enableJsonFlag:!0,flags:{url:e.string({description:"Testkit Cloud origin"})}}),"cloud apply":t({summary:"Apply an idempotent, file-based mutation to Testkit Cloud",description:a,enableJsonFlag:!0,flags:{browser:e.boolean({description:"Open any required provider consent",allowNo:!0,default:!0}),"secret-output":e.string({description:"New private file for an explicitly created credential"}),campaign:e.string({description:"Apply a report to this campaign"}),dir:e.string({description:"Product directory containing optional local verification config"}),file:e.string({description:"JSON command envelope to apply",required:!0}),project:e.string({description:"Testkit Cloud project ID"}),url:e.string({description:"Testkit Cloud origin"})}}),"cloud migrate plan":t({summary:"Plan a legacy campaign migration without remote writes",enableJsonFlag:!0,flags:{source:e.string({description:"Legacy source root",required:!0}),registry:e.string({description:"Campaign registry path relative to source root",required:!0}),regressions:e.string({description:"Regression registry path relative to source root",required:!0}),mapping:e.string({description:"Mapping file, absolute or relative to source root",required:!0}),output:e.string({description:"New private output directory outside source root",required:!0}),url:e.string({description:"Testkit Cloud origin",required:!0}),project:e.string({description:"Testkit Cloud project ID",required:!0}),campaign:e.string({description:"Existing campaign ID",required:!0})}}),"cloud migrate apply":t({summary:"Apply or resume a saved legacy campaign migration",enableJsonFlag:!0,flags:{plan:e.string({description:"Saved migration plan path",required:!0})}}),"cloud migrate reconcile":t({summary:"Read back and reconcile a saved legacy campaign migration",enableJsonFlag:!0,flags:{plan:e.string({description:"Saved migration plan path",required:!0})}}),"cloud publish":t({summary:"Publish one verified immutable run bundle to Testkit Cloud",enableJsonFlag:!0,flags:{campaign:e.string({description:"Associate receipt with this campaign; requires --run"}),dir:e.string({description:"Explicit product directory"}),project:e.string({description:"Testkit Cloud project ID"}),run:e.string({description:"Immutable run ID; defaults to latest"}),url:e.string({description:"Testkit Cloud origin"})}}),"cloud snapshot":t({summary:"Read the current versioned Testkit Cloud project state",enableJsonFlag:!0,flags:{campaign:e.string({description:"Campaign ID"}),finding:e.string({description:"Finding detail within the campaign"}),findings:e.boolean({description:"Read project-wide findings"}),receipts:e.boolean({description:"Read campaign receipt history"}),history:e.boolean({description:"Read accepted campaign changes"}),"root-cause-key":e.string({description:"Exact finding root-cause key"}),"issue-reference":e.string({description:"Exact external issue URL"}),view:e.string({description:"Finding view",options:["all","counted","secondary"]}),limit:e.integer({description:"Page size, 1\u2013100; history maximum 20"}),cursor:e.string({description:"Opaque nextCursor from the preceding page"}),project:e.string({description:"Testkit Cloud project ID"}),url:e.string({description:"Testkit Cloud origin"})}}),"db schema refresh":t({summary:"Refresh a source database schema cache",enableJsonFlag:!0,flags:i}),"db schema verify":t({summary:"Verify local schema replay against the source database schema",enableJsonFlag:!0,flags:{...i,"skip-schema-source-verify":e.boolean({description:"Skip the check that local schema replay matches the source database schema",default:!1})}}),destroy:t({summary:"Destroy local testkit state",enableJsonFlag:!0,flags:i}),discover:t({summary:"Discover managed tests and report their metadata",enableJsonFlag:!0,flags:{...i,type:e.string({char:"t",multiple:!0,description:`Filter by suite type(s): ${s({includeAll:!0})}`}),suite:e.string({char:"s",multiple:!0,description:"Filter by suite selector(s)"}),file:e.string({char:"f",multiple:!0,description:"Filter by exact file path(s)"}),"runnable-only":e.boolean({description:"Show only files not skipped by repo rules",default:!1}),strict:e.boolean({description:"Fail instead of reporting discovery/config diagnostics",default:!1}),output:e.string({description:"Write machine-readable discovery JSON to a file"}),"output-mode":e.string({description:"Human-readable output mode",options:["compact","verbose"],default:"compact"})}}),doctor:t({summary:"Run built-in config, discovery, and hygiene checks",enableJsonFlag:!0,flags:{dir:e.string({description:"Product directory"}),typecheck:e.boolean({description:"Include generated TypeScript checks",default:!0,allowNo:!0})}}),"guard unsafe-entrypoint":t({summary:"Fail a local script that must be run through Testkit",flags:{command:e.string({char:"c",description:"Disabled command name shown in the error message",required:!0}),use:e.string({char:"u",description:"Replacement command shown in the error message",required:!0})}}),lint:t({summary:"Run built-in Testkit repository hygiene checks",enableJsonFlag:!0,flags:{dir:e.string({description:"Product directory"})}}),"run status":t({summary:"Show active Testkit run progress",enableJsonFlag:!0,flags:{...i,run:e.string({description:"Specific run id to show"}),full:e.boolean({description:"Include the full live status payload in JSON output"})}}),"run stop":t({summary:"Stop active Testkit run work",enableJsonFlag:!0,flags:{...i,run:e.string({description:"Specific run id to stop; defaults to the newest active run"}),all:e.boolean({description:"Stop all active runs for this product",default:!1}),reason:e.string({description:"Operator-visible reason recorded with cancelled runs and dirty slots"})}}),run:t({summary:"Run test suites",enableJsonFlag:!0,args:{type:r.string({description:`Optional suite type shortcut: ${s({includeAll:!0})}`,required:!1,options:c({includeAll:!0})})},flags:l}),"setup playwright":t({summary:"Install the managed Playwright Chromium runtime",enableJsonFlag:!0,flags:{dir:e.string({description:"Product directory"}),force:e.boolean({default:!1,description:"Force Playwright to repair the browser installation"}),"with-deps":e.boolean({default:!1,description:"Install required host dependencies with Chromium"})}}),status:t({summary:"Show local testkit state",enableJsonFlag:!0,flags:i}),stop:t({summary:"Stop all Testkit-owned runs",enableJsonFlag:!0,flags:{...i,reason:e.string({description:"Operator-visible reason recorded with cancelled runs"})}}),typecheck:t({summary:"Typecheck testkit config, helpers, and suites",enableJsonFlag:!0,flags:{dir:e.string({description:"Product directory"})}}),workspace:t({summary:"Inspect Testkit workstation data for a product",enableJsonFlag:!0,flags:{...i,"target-limit":e.integer({description:"Maximum number of quick-run target previews",default:24}),"no-status":e.boolean({description:"Skip runtime status collection",default:!1})}})});

package/dist/cli/command-flags.d.ts

@@ -0,0 +1,19 @@
+export declare const sharedFlags: {
+    dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    service: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+};
+export declare const runFlags: {
+    type: import("./framework/definitions.js").FlagDefinition<string[] | undefined>;
+    suite: import("./framework/definitions.js").FlagDefinition<string[] | undefined>;
+    file: import("./framework/definitions.js").FlagDefinition<string[] | undefined>;
+    "task-concurrency": import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    workers: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    "file-timeout-seconds": import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    "allow-empty": import("./framework/definitions.js").FlagDefinition<boolean>;
+    "ignore-skip-rules": import("./framework/definitions.js").FlagDefinition<boolean>;
+    "skip-schema-source-verify": import("./framework/definitions.js").FlagDefinition<boolean>;
+    "output-mode": import("./framework/definitions.js").FlagDefinition<"debug" | "events" | "compact" | undefined>;
+    debug: import("./framework/definitions.js").FlagDefinition<boolean>;
+    dir: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+    service: import("./framework/definitions.js").FlagDefinition<string | undefined>;
+};

package/dist/cli/command-flags.js

@@ -0,0 +1 @@
+import{publicTestTypeListText as t}from"../domain/test-types.js";import{Flags as e}from"./framework/index.js";export const sharedFlags={dir:e.string({description:"Explicit product directory"}),service:e.string({description:"Limit the operation to one service"})},runFlags={...sharedFlags,type:e.string({char:"t",multiple:!0,description:`Run specific suite type(s): ${t({includeAll:!0})}`}),suite:e.string({char:"s",multiple:!0,description:"Run specific suite(s)"}),file:e.string({char:"f",multiple:!0,description:"Run specific file(s)"}),"task-concurrency":e.string({description:"Maximum number of concurrent test tasks for the whole run"}),workers:e.string({description:"Deprecated alias for --task-concurrency; removed in 0.3.0"}),"file-timeout-seconds":e.string({description:"Per-file wall-clock timeout in seconds"}),"allow-empty":e.boolean({description:"Permit a successful run when no runnable files execute",default:!1}),"ignore-skip-rules":e.boolean({description:"Run files even if testkit.config.ts marks them skipped",default:!1}),"skip-schema-source-verify":e.boolean({description:"Skip the check that local schema replay matches the source database schema",default:!1}),"output-mode":e.string({description:"Reporter mode",options:["compact","debug","events"]}),debug:e.boolean({description:"Alias for --output-mode debug",default:!1})};

package/dist/cli/command-registry.d.ts

@@ -0,0 +1,2 @@
+import type { CommandRegistration } from "./framework/command.js";
+export declare const commandRegistry: readonly CommandRegistration[];

package/dist/cli/command-registry.js

@@ -0,0 +1 @@
+import{commandCatalog as i}from"./command-catalog.js";export const commandRegistry=Object.freeze([o("artifacts",()=>import("./commands/artifacts.js")),o("cleanup",()=>import("./commands/cleanup.js")),o("cloud apply",()=>import("./commands/cloud/apply.js")),o("cloud campaign create",()=>import("./commands/cloud/campaign/create.js")),o("cloud policy preview",()=>import("./commands/cloud/policy/preview.js")),o("cloud download",()=>import("./commands/cloud/download.js")),o("cloud list",()=>import("./commands/cloud/list.js")),o("cloud show",()=>import("./commands/cloud/show.js")),o("cloud project create",()=>import("./commands/cloud/project/create.js")),o("cloud login",()=>import("./commands/cloud/login.js")),o("cloud logout",()=>import("./commands/cloud/logout.js")),o("cloud session revoke",()=>import("./commands/cloud/session/revoke.js")),o("cloud status",()=>import("./commands/cloud/status.js")),o("cloud migrate plan",()=>import("./commands/cloud/migrate/plan.js")),o("cloud migrate apply",()=>import("./commands/cloud/migrate/apply.js")),o("cloud migrate reconcile",()=>import("./commands/cloud/migrate/reconcile.js")),o("cloud publish",()=>import("./commands/cloud/publish.js")),o("cloud snapshot",()=>import("./commands/cloud/snapshot.js")),o("db schema refresh",()=>import("./commands/db/schema/refresh.js")),o("db schema verify",()=>import("./commands/db/schema/verify.js")),o("destroy",()=>import("./commands/destroy.js")),o("discover",()=>import("./commands/discover.js")),o("doctor",()=>import("./commands/doctor.js")),o("guard unsafe-entrypoint",()=>import("./commands/guard/unsafe-entrypoint.js")),o("lint",()=>import("./commands/lint.js")),o("run status",()=>import("./commands/run/status.js")),o("run stop",()=>import("./commands/run/stop.js")),o("run",()=>import("./commands/run.js")),o("setup playwright",()=>import("./commands/setup/playwright.js")),o("status",()=>import("./commands/status.js")),o("stop",()=>import("./commands/stop.js")),o("typecheck",()=>import("./commands/typecheck.js")),o("workspace",()=>import("./commands/workspace.js"))]);function o(t,r){return Object.freeze({...i[t],id:t.split(" "),load:r})}

package/dist/cli/commands/artifacts.d.ts

@@ -0,0 +1,48 @@
+import type { CommandContext } from "../command-catalog.js";
+export default function run({ args, flags, json, log }: CommandContext<"artifacts">): {
+    ok: boolean;
+    runs: import("../../evidence/contracts.js").RunBundleSummary[];
+    count?: undefined;
+    verification?: undefined;
+    runId?: undefined;
+    artifacts?: undefined;
+} | {
+    ok: boolean;
+    count: number;
+    runs?: undefined;
+    verification?: undefined;
+    runId?: undefined;
+    artifacts?: undefined;
+} | {
+    ok: boolean;
+    verification: import("../../evidence/contracts.js").RunBundleVerification;
+    runs?: undefined;
+    count?: undefined;
+    runId?: undefined;
+    artifacts?: undefined;
+} | {
+    ok: boolean;
+    runId: string | null;
+    artifacts: {
+        file: string;
+        service: string;
+        suite: {
+            engineId: "node-vitest" | "playwright" | "k6";
+            name: string;
+            profileId: "k6-http" | "k6-dal" | "node-vitest-data" | "node-vitest-contract" | "playwright-ui";
+            testType: "contract" | "data" | "ui" | "e2e" | "int" | "dal" | "load" | "scenario";
+        };
+        ref: import("../../evidence/reporting-types.js").ReportingArtifactReference;
+        payload: import("../../evidence/reading.js").RunArtifactPayload | null;
+    }[];
+    runs?: undefined;
+    count?: undefined;
+    verification?: undefined;
+} | {
+    ok: boolean;
+    runId: string | null;
+    count: number;
+    runs?: undefined;
+    verification?: undefined;
+    artifacts?: undefined;
+};

package/dist/cli/commands/artifacts.js

@@ -0,0 +1,3 @@
+import{asUnknownRecord as c}from"../../kernel/unknown-values.js";import s from"node:fs";import{inspectArtifacts as d}from"../../app/inspect/artifacts.js";import{formatArtifactPreview as p}from"../renderers/artifact-preview.js";export default function l({args:i,flags:e,json:n,log:r}){const o=d({dir:e.dir,mode:e.list?"runs":e.verify?"verify":"artifacts",file:i.file||null,runId:e.run||null,service:e.service||null,kind:e.kind});if(o.mode==="runs"){const{runs:t}=o;if(n)return{ok:!0,runs:t};t.length===0&&r("No immutable Testkit runs found.");for(const u of t)r(`${u.runId} ${u.status||"unknown"} ${u.finishedAt||u.startedAt||"unknown-time"}`);return{ok:!0,count:t.length}}const f=o.runId;if(o.mode==="verify"){const{verification:t}=o;return t.ok||(process.exitCode=1),n?{ok:t.ok,verification:t}:(r(t.ok?`Verified ${f??"unknown"}: ${String(t.checkedFiles)} files (${t.manifestDigest??"unknown-digest"})`:`Integrity verification failed for ${f??"unknown"}: ${t.errors.join("; ")}`),{ok:t.ok,verification:t})}const{entries:a}=o;if(n)return{ok:!0,runId:f,artifacts:a.map(t=>({file:t.file.path,service:t.service.name,suite:{engineId:t.suite.engineId,name:t.suite.name,profileId:t.suite.profileId,testType:t.suite.testType},ref:t.artifactRef,payload:t.payload}))};if(e.format==="text")r(k(a));else for(const t of m(a))r(t);return{ok:!0,runId:f,count:a.length}}function m(i){if(i.length===0)return["No artifacts matched."];const e=[];for(const n of i){e.push(`${n.artifactRef.name}${n.artifactRef.kind?` [${n.artifactRef.kind}]`:""}`),n.artifactRef.summary&&e.push(`  ${n.artifactRef.summary}`);for(const r of p(n.payload,8))e.push(`  ${r}`);e.push(`  ${n.artifactRef.path}`)}return e}function k(i){return i.length===0?"No artifacts matched.":i.map(e=>h(e)).join(`
+
+`)}function h(i){if(typeof i.payload?.text=="string")return i.payload.text.trimEnd();const e=c(i.payload?.data);return typeof e?.text=="string"?e.text.trimEnd():i.artifactRef.contentType==="application/json"&&s.existsSync(i.absolutePath)?s.readFileSync(i.absolutePath,"utf8").trimEnd():JSON.stringify(i.payload?.data??i.payload??null,null,2)}

package/dist/cli/commands/cleanup.d.ts

@@ -0,0 +1,13 @@
+import type { CommandContext } from "../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"cleanup">): Promise<{
+    lines: string[];
+    bundleCleaned: import("../../engines/bundle-cache.js").BundleCleanupTarget[];
+    cleaned: import("../../environment/lifecycle.js").RunManifest[];
+    dryRun: boolean;
+    resourceCleanup: import("../../environment/maintenance.js").ResourceCleanupSummary;
+    runtimeCleaned: import("../../environment/status-runtime.js").RuntimeCleanupTarget[];
+    skippedActive: import("../../environment/lifecycle.js").RunManifest[];
+    stoppedActive: import("../../environment/lifecycle.js").RunManifest[];
+    targets: import("../../app/cleanup/index.js").CleanupTargets;
+    ok: boolean;
+}>;

package/dist/cli/commands/cleanup.js

@@ -0,0 +1 @@
+import{cleanupEnvironment as m}from"../../app/cleanup/index.js";import{formatCleanupLines as p}from"../renderers/cleanup/format.js";export default async function d({flags:r,json:o,log:t}){const{productDir:u,result:c,runSummaries:i}=await m({cache:r.cache,dir:r.dir,dryRun:r["dry-run"],resources:r.resources,service:r.service}),{automaticResourceCleanup:s,...e}=c,n=p(u,{...e,automaticResourceCleanup:s},i);if(!o)for(const a of n)t(a);return{ok:!0,...e,lines:n}}

package/dist/cli/commands/cloud/apply.d.ts

@@ -0,0 +1,5 @@
+import type { CommandContext } from "../../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"cloud apply">): Promise<{
+    ok: boolean;
+    receipt: unknown;
+}>;

package/dist/cli/commands/cloud/apply.js

@@ -0,0 +1 @@
+import{cloudInteraction as u}from"../../cloud-selection.js";import{runWithCliProcessSignal as n}from"../../process-signal.js";import{applyCloudMutationFile as c}from"../../../app/cloud/index.js";export default async function p({flags:r,json:t,log:o}){const i=await n(e=>c(r.file,{...u(t),signal:e,browser:r.browser,secretOutput:r["secret-output"],campaignId:r.campaign,productDir:r.dir,origin:r.url,projectId:r.project}));return t||o(JSON.stringify(i,null,2)),{ok:!0,receipt:i}}

package/dist/cli/commands/cloud/campaign/create.d.ts

@@ -0,0 +1,5 @@
+import type { CommandContext } from "../../../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"cloud campaign create">): Promise<{
+    ok: boolean;
+    result: unknown;
+}>;

package/dist/cli/commands/cloud/campaign/create.js

@@ -0,0 +1 @@
+import{cloudInteraction as u}from"../../../cloud-selection.js";import{createCloudCampaign as n}from"../../../../app/cloud/control-actions.js";export default async function i({flags:t,json:r,log:e}){const o=await n({...u(r),origin:t.url,organisation:t.org,project:t.project,requestKey:t["request-key"],focus:t.focus,targetBugCount:t["target-bugs"]});return r||e(JSON.stringify(o,null,2)),{ok:!0,result:o}}

package/dist/cli/commands/cloud/download.d.ts

@@ -0,0 +1,5 @@
+import type { CommandContext } from "../../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"cloud download">): Promise<{
+    ok: boolean;
+    result: unknown;
+}>;