@lovrozagar/oat 0.10.0 → 0.12.0

package/dist/cli.js

@@ -1,61 +1,106 @@
 #!/usr/bin/env node
+import { EXIT, exitCode } from "./runtime/exit.js";
 import { createWriteStream, writeFileSync } from "node:fs";
 import { mkdir, writeFile } from "node:fs/promises";
 import { dirname, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { interpolate, loadConfig } from "./config/load.js";
+import { configProblems } from "./config/validate.js";
 import { report } from "./report/console.js";
 import { renderMatrixGraph, renderMatrixHtml } from "./report/matrix.js";
 import { ISSUE_REPRO_DIR, renderConsole, renderJson, renderMarkdown, renderRepros } from "./report/render.js";
 import { createProgressPump, createStderrProgress, formatProgressJsonl, formatProgressLine, formatProgressTsv, PROGRESS_GLOSSARY, PROGRESS_TSV_HEADER, } from "./runtime/progress.js";
 import { resolveSaveExchanges } from "./runtime/exchanges.js";
-import { allocateRunDir, DEFAULT_RUNS_ROOT } from "./runtime/runs.js";
+import { allocateRunDir, DEFAULT_RUNS_ROOT, publishLatest } from "./runtime/runs.js";
 import { authStepOperationIds, planScope, resolveTargetScope, ScopeError } from "./runtime/scope.js";
 import { renderTeardown } from "./runtime/teardown.js";
 import { buildModel } from "./spec/graph.js";
 import { dereference, loadSpec } from "./spec/load.js";
-export const KNOWN_FLAGS = new Set([
-    "help",
-    "config",
-    "spec",
-    "base-url",
-    "only",
-    "ops",
-    "profile",
-    "seed",
-    "out",
-    "keep-fixtures",
-    "max-in-flight",
-    "quiet",
-    "untagged",
-    "backend",
-    "dialect",
-    "fuzz",
-    "precision",
-    "max-defects",
-    "json",
-    "parser",
-    "save-exchanges",
-    "no-save-exchanges",
-]);
+/** Every flag, once: whether it takes a value, and what kind. Parsing and help both read this. */
+export const FLAGS = {
+    backend: { kind: "value" },
+    "base-url": { kind: "value" },
+    config: { kind: "value" },
+    defects: { kind: "value" },
+    dialect: { kind: "value" },
+    fuzz: { kind: "optional-value", number: "positive" },
+    "fuzz-seed": { kind: "value", number: "positive" },
+    help: { kind: "boolean" },
+    jobs: { kind: "value", number: "positive" },
+    json: { kind: "boolean" },
+    "keep-fixtures": { kind: "boolean" },
+    "max-defects": { kind: "value", number: "positive" },
+    "max-in-flight": { kind: "value", number: "positive" },
+    "no-save-exchanges": { kind: "boolean" },
+    only: { kind: "value" },
+    ops: { kind: "value" },
+    out: { kind: "value" },
+    parser: { kind: "boolean" },
+    precision: { kind: "optional-value", number: "positive" },
+    profile: { kind: "value" },
+    quiet: { kind: "boolean" },
+    "save-exchanges": { kind: "boolean" },
+    seed: { kind: "value", number: "integer" },
+    "skip-backend": { kind: "value" },
+    spec: { kind: "value" },
+    untagged: { kind: "boolean" },
+};
+export const KNOWN_FLAGS = new Set(Object.keys(FLAGS));
+/**
+ * `oat <command> [--flag value | --flag=value | --switch] …`. A value flag must have its value;
+ * a switch takes none; a numeric value must be one. The first problem is returned as `error`
+ * rather than guessed around: `--max-in-flight -1` once hung a run, `--seed abc` seeded strings
+ * with `NaN`, and a flag followed by another flag silently became `true`.
+ */
 export function parseArgs(argv) {
-    const [command = "help", ...rest] = argv;
+    const leadingFlag = argv[0]?.startsWith("--") === true;
+    const command = leadingFlag ? "help" : (argv[0] ?? "help");
+    const rest = leadingFlag ? argv : argv.slice(1);
     const flags = {};
+    let error;
+    const fail = (message) => {
+        error ??= message;
+    };
     for (let i = 0; i < rest.length; i++) {
         const token = rest[i];
         if (token === undefined || !token.startsWith("--"))
             continue;
-        const key = token.slice(2);
+        const equals = token.indexOf("=");
+        const key = equals === -1 ? token.slice(2) : token.slice(2, equals);
+        const inline = equals === -1 ? undefined : token.slice(equals + 1);
+        const spec = FLAGS[key];
         const next = rest[i + 1];
-        if (next !== undefined && !next.startsWith("--")) {
-            flags[key] = next;
+        const nextIsValue = next !== undefined && !next.startsWith("--");
+        let value;
+        if (spec === undefined || spec.kind === "boolean") {
+            if (inline !== undefined && spec !== undefined)
+                fail(`--${key} takes no value`);
+            value = inline ?? true;
+        }
+        else if (inline !== undefined) {
+            value = inline;
+        }
+        else if (nextIsValue) {
+            value = next;
             i++;
         }
+        else if (spec.kind === "optional-value") {
+            value = true;
+        }
         else {
-            flags[key] = true;
+            fail(`--${key} needs a value`);
+            value = true;
         }
+        if (spec?.number !== undefined && typeof value === "string") {
+            const parsed = Number(value);
+            const integer = value.trim() !== "" && Number.isSafeInteger(parsed);
+            if (!integer || (spec.number === "positive" && parsed < 1)) {
+                fail(`--${key} must be ${spec.number === "positive" ? "a positive" : "an"} integer, got "${value}"`);
+            }
+        }
+        flags[key] = value;
     }
-    return { command, flags };
+    return error === undefined ? { command, flags } : { command, error, flags };
 }
 export function unknownFlag(flags) {
     for (const key of Object.keys(flags)) {
@@ -94,6 +139,9 @@ Flags
   --precision [n]  vary cohort data against a correct backend; any finding is a false positive
   --max-defects    most defects per combination (default: 4)
   --seed           fuzz seed, so a failing combination replays exactly
+  --fuzz-seed      seed for the combination smoke pass of a full conformance run (default: 1)
+  --jobs           conformance legs run at once, each on its own thread (default: CPUs − 1, at most 4)
+  --skip-backend   comma-separated backends a full conformance run may leave out when unreachable
   --json       machine-readable output, for plan and doctor
 `;
 function str(flags, key) {
@@ -107,19 +155,28 @@ function list(flags, key) {
         .filter(Boolean);
 }
 /**
- * Exit code for a finished run. Root causes fail it, not raw findings: gaps and blocked entries
- * are information. A targeted run also fails unless every target held — under `--ops` a target
- * nothing graded must not read as a pass.
+ * A config file, loaded, checked and interpolated — or the first reason it cannot be used. Every
+ * one of these is the caller's to fix, so the command exits 2 with nothing sent.
  */
-export function exitCode(result) {
-    if (result.network?.incomplete === true)
-        return 1;
-    if (result.findings.some((f) => f.verdict !== "COVERAGE_GAP" && f.verdict !== "BLOCKED"))
-        return 1;
-    if (result.scope.mode === "targeted" && result.scope.operations.some((op) => op.status !== "held"))
-        return 1;
-    return 0;
+async function readConfig(path, forRun) {
+    let loaded;
+    try {
+        loaded = await loadConfig(path);
+    }
+    catch (error) {
+        return { problem: (error instanceof Error ? error.message : String(error)).replace(/^oat: /, "") };
+    }
+    const problems = configProblems(loaded, { forRun });
+    if (problems.length > 0)
+        return { problem: `${path} is not a valid config:\n  ${problems.join("\n  ")}` };
+    try {
+        return { config: interpolate(loaded) };
+    }
+    catch (error) {
+        return { problem: (error instanceof Error ? error.message : String(error)).replace(/^oat: /, "") };
+    }
 }
+export { EXIT, exitCode } from "./runtime/exit.js";
 async function commandRun(flags) {
     const configPath = str(flags, "config");
     if (configPath === undefined) {
@@ -127,7 +184,12 @@ async function commandRun(flags) {
         return 2;
     }
     const { run } = await import("./runtime/run.js");
-    const config = interpolate(await loadConfig(configPath));
+    const read = await readConfig(configPath, true);
+    if ("problem" in read) {
+        process.stderr.write(`oat: ${read.problem}\n`);
+        return EXIT.usage;
+    }
+    const config = read.config;
     const baseUrl = str(flags, "base-url") ?? config.baseUrl;
     const seedFlag = str(flags, "seed");
     const only = list(flags, "only") ?? config.only?.filter((name) => name.trim() !== "");
@@ -176,9 +238,23 @@ async function commandRun(flags) {
         stderrProgress?.emit(snap);
         fileProgress.emit(snap);
     };
+    /* Ctrl-C stops testing, not the run: what oat created is still removed and the partial report
+     * is still written. A second signal means "now", and exits without either. */
+    const stop = new AbortController();
+    const onSignal = (signal) => {
+        if (stop.signal.aborted) {
+            process.stderr.write(`\noat: ${signal} again — exiting without teardown\n`);
+            process.exit(130);
+        }
+        process.stderr.write(`\noat: ${signal} — stopping, removing what this run created (again to exit now)\n`);
+        stop.abort();
+    };
+    process.on("SIGINT", onSignal);
+    process.on("SIGTERM", onSignal);
     let result;
     try {
         result = await run({
+            signal: stop.signal,
             baseUrl,
             principals,
             spec: config.spec,
@@ -195,6 +271,7 @@ async function commandRun(flags) {
             ...(config.rateLimits === undefined ? {} : { rateLimits: config.rateLimits }),
             ...(config.origins === undefined ? {} : { origins: config.origins }),
             ...(config.outOfBand === undefined ? {} : { outOfBand: config.outOfBand }),
+            ...(config.payloads === undefined ? {} : { payloads: config.payloads }),
             ...(config.query === undefined ? {} : { query: config.query }),
             ...(config.entities === undefined ? {} : { entities: config.entities }),
             keepFixtures: flags["keep-fixtures"] === true || config.keepFixtures === true,
@@ -212,6 +289,8 @@ async function commandRun(flags) {
         return 2;
     }
     finally {
+        process.off("SIGINT", onSignal);
+        process.off("SIGTERM", onSignal);
         stderrProgress?.stop();
         fileProgress.stop();
         progressLog.end();
@@ -221,6 +300,9 @@ async function commandRun(flags) {
     const durationMs = performance.now() - began;
     const input = {
         baseUrl,
+        checkNotes: result.checkNotes,
+        checkTimings: result.checkTimings,
+        checksOutOfScope: result.checksOutOfScope,
         checksRun: result.checksRun,
         checksSkipped: result.checksSkipped,
         checksSuppressed: result.checksSuppressed,
@@ -264,22 +346,53 @@ async function commandRun(flags) {
     if (result.network?.incomplete === true) {
         process.stdout.write(`  network: ${result.network.kind} — run incomplete\n`);
     }
+    await publishLatest(allocated);
     process.stdout.write(`  latest: ${allocated.latest}\n\n`);
     return exitCode(result);
 }
 export async function main() {
-    const { command, flags } = parseArgs(process.argv.slice(2));
+    const { command, error: flagError, flags } = parseArgs(process.argv.slice(2));
     const unknown = unknownFlag(flags);
     if (unknown !== undefined) {
         process.stderr.write(`oat: unknown flag "--${unknown}"\n\n${USAGE}`);
         return 2;
     }
+    if (flagError !== undefined) {
+        process.stderr.write(`oat: ${flagError}\n\n${USAGE}`);
+        return EXIT.usage;
+    }
     if (command === "help" || flags.help === true) {
         process.stdout.write(USAGE);
         return 0;
     }
     if (command === "conformance") {
-        const { postgresAvailable, renderParserSuite, renderSuite, runExampleSpecSuite, runTagUnlockSuite, runParserSuite, runPayloadCatalogSuite, runCoverageReportSuite, runSeedContractSuite, runEffectsSuite, runTenantScopeSuite, runSuite, sqliteAvailable, d1Available, } = await import("./conformance/suite.js");
+        const { defectsFor, passAnswer, postgresAvailable, renderParserSuite, renderUnproven, runExampleSpecSuite, runTagUnlockSuite, runParserSuite, runPayloadCatalogSuite, runCoverageReportSuite, runSeedContractSuite, runEffectsSuite, runTenantScopeSuite, sqliteAvailable, d1Available, } = await import("./conformance/suite.js");
+        /* A typo in a selector must stop the run, not widen it: an unknown backend once ran every
+         * backend, and an unknown dialect silently filtered out the defects it could not express. */
+        const { DIALECTS } = await import("./reference/dialect.js");
+        const { isDefectName } = await import("./reference/defects.js");
+        const backendFlag = str(flags, "backend");
+        const backendNames = ["memory", "sqlite", "postgres", "d1"];
+        if (backendFlag !== undefined && !backendNames.includes(backendFlag)) {
+            process.stderr.write(`oat: unknown --backend "${backendFlag}" — expected ${backendNames.join(", ")}\n`);
+            return 2;
+        }
+        const dialectFlag = str(flags, "dialect");
+        if (dialectFlag !== undefined && !Object.hasOwn(DIALECTS, dialectFlag)) {
+            process.stderr.write(`oat: unknown --dialect "${dialectFlag}" — expected ${Object.keys(DIALECTS).join(", ")}\n`);
+            return 2;
+        }
+        const onlyFlag = str(flags, "only")?.split(",").filter(Boolean);
+        const unknownDefects = (onlyFlag ?? []).filter((name) => !isDefectName(name));
+        if (flags.only === true || (onlyFlag !== undefined && onlyFlag.length === 0)) {
+            process.stderr.write("oat: --only needs a comma-separated list of defect names\n");
+            return 2;
+        }
+        if (unknownDefects.length > 0) {
+            process.stderr.write(`oat: --only names no defect: ${unknownDefects.join(", ")}\n`);
+            return 2;
+        }
+        const { createPool, defaultJobs } = await import("./conformance/pool.js");
         const { runFeatureGateSuite } = await import("./conformance/feature-gate.js");
         const { runRateLimitSuite } = await import("./conformance/rate-limit.js");
         const { runUniqueSuite } = await import("./conformance/unique.js");
@@ -291,9 +404,14 @@ export async function main() {
         const example = renderParserSuite(await runExampleSpecSuite());
         process.stdout.write(example.text);
         parser.failures += example.failures;
-        const unlocks = renderParserSuite(await runTagUnlockSuite());
-        process.stdout.write(unlocks.text);
-        parser.failures += unlocks.failures;
+        /* The defect matrix makes the two runs the tag-unlock claims are judged from; only a run
+         * that stops before the matrix makes them here. */
+        const beforeMatrix = flags.parser === true || flags.precision !== undefined || flags.fuzz !== undefined;
+        if (beforeMatrix) {
+            const unlocks = renderParserSuite(await runTagUnlockSuite());
+            process.stdout.write(unlocks.text);
+            parser.failures += unlocks.failures;
+        }
         const coverage = renderParserSuite(runCoverageReportSuite());
         process.stdout.write(coverage.text);
         parser.failures += coverage.failures;
@@ -385,18 +503,110 @@ export async function main() {
             ]
             : backends.map((backend) => ({ backend, dialect: dialect ?? "postgrest" }));
         let failures = parser.failures;
-        for (const pass of passes) {
-            process.stdout.write(`\n  ── ${pass.backend} · ${pass.dialect} ${"─".repeat(46)}\n`);
-            const result = renderSuite(await runSuite(only, pass.backend, pass.dialect), pass.dialect);
-            process.stdout.write(result.text);
-            failures += result.failures;
+        const proven = new Set();
+        const jobsFlag = str(flags, "jobs");
+        const jobs = jobsFlag === undefined ? defaultJobs() : Number.parseInt(jobsFlag, 10);
+        if (!Number.isSafeInteger(jobs) || jobs < 1) {
+            process.stderr.write("oat: --jobs must be a positive integer\n");
+            return 2;
+        }
+        /* Every leg is queued at once and printed in order as its turn comes. */
+        const pool = createPool(jobs);
+        const withShapes = requested === undefined || requested === "memory";
+        /* A leg goes out as its baselines and its defects in chunks, so a long leg spreads across
+         * the pool; its results come back in order and are rendered here. */
+        const LEG_CHUNK = 6;
+        const passAnswers = passes.map(async (pass) => {
+            const defects = defectsFor(pass.backend, pass.dialect, only);
+            const chunks = Array.from({ length: Math.ceil(defects.length / LEG_CHUNK) }, (_, index) => defects.slice(index * LEG_CHUNK, (index + 1) * LEG_CHUNK));
+            const answers = await Promise.all([
+                pool.run({ backend: pass.backend, dialect: pass.dialect, kind: "baselines" }),
+                ...chunks.map((chunk) => pool.run({ backend: pass.backend, dialect: pass.dialect, defects: chunk, kind: "defects" })),
+            ]);
+            const results = answers.flatMap((answer) => (answer.kind === "leg" ? answer.results : []));
+            return { kind: "pass", ...passAnswer(results, pass.backend, pass.dialect) };
+        });
+        const shapeAnswer = withShapes ? pool.run({ kind: "shapes" }) : undefined;
+        /* `--ops` recall needs each defect's full run, which the default pass has just made; only
+         * the targeted half is sent, spread across the pool. */
+        const fullRun = only === undefined && requested === undefined && dialect === undefined;
+        const defaultPass = passes.findIndex((pass) => pass.backend === "memory" && pass.dialect === "postgrest");
+        const scopeAnswers = !fullRun || defaultPass === -1
+            ? undefined
+            : passAnswers[defaultPass]?.then(async (answer) => {
+                const { DEFECTS } = await import("./reference/defects.js");
+                const names = Object.keys(DEFECTS);
+                const known = answer.kind === "pass" ? answer.primaryOps : {};
+                const chunks = Array.from({ length: jobs }, (_, lane) => names.filter((_name, index) => index % jobs === lane)).filter((chunk) => chunk.length > 0);
+                return Promise.all(chunks.map((defects) => pool.run({ defects, kind: "scope", known })));
+            });
+        const recallAnswers = shapeAnswer === undefined || only !== undefined
+            ? undefined
+            : shapeAnswer.then((answer) => Promise.all((answer.kind === "cases" ? answer.cases : []).map((shape) => pool.run({ kind: "recall", shapes: [shape] }))));
+        try {
+            for (const [index, pass] of passes.entries()) {
+                process.stdout.write(`\n  ── ${pass.backend} · ${pass.dialect} ${"─".repeat(46)}\n`);
+                const result = await passAnswers[index];
+                if (result?.kind !== "pass")
+                    continue;
+                process.stdout.write(result.text);
+                failures += result.failures;
+                for (const id of result.proven)
+                    proven.add(id);
+            }
+            /* Only a complete run can say a check was never proven; a filtered one never tried. */
+            if (fullRun) {
+                const unproven = renderUnproven(proven);
+                process.stdout.write(unproven.text);
+                failures += unproven.failures;
+            }
+            const defaultAnswer = defaultPass === -1 ? undefined : await passAnswers[defaultPass];
+            const unlocks = renderParserSuite(await runTagUnlockSuite(defaultAnswer?.kind === "pass" ? defaultAnswer.baselines : undefined));
+            process.stdout.write(unlocks.text);
+            failures += unlocks.failures;
+            if (scopeAnswers !== undefined) {
+                const scopeResults = (await scopeAnswers).flatMap((answer) => (answer.kind === "results" ? answer.results : []));
+                const scope = renderParserSuite(scopeResults);
+                process.stdout.write(scope.text);
+                failures += scope.failures;
+            }
+            /* The opposite question to the defect matrix: whether oat stays quiet on a correct backend
+             * shaped unlike the one it was written against. One engine is enough — a shape varies the
+             * API, not the storage. */
+            if (shapeAnswer !== undefined) {
+                const { renderShapeSuite } = await import("./conformance/shapes.js");
+                process.stdout.write(`\n  ── shapes · memory ${"─".repeat(46)}\n`);
+                const shapeCases = await shapeAnswer;
+                const shapes = renderShapeSuite(shapeCases.kind === "cases" ? shapeCases.cases : []);
+                process.stdout.write(shapes.text);
+                failures += shapes.failures;
+                if (recallAnswers !== undefined) {
+                    process.stdout.write(`\n  ── recall behind shapes · memory ${"─".repeat(32)}\n`);
+                    const recallCases = (await recallAnswers).flatMap((answer) => (answer.kind === "cases" ? answer.cases : []));
+                    const recall = renderShapeSuite(recallCases, true);
+                    process.stdout.write(recall.text);
+                    failures += recall.failures;
+                }
+            }
+        }
+        finally {
+            await pool.close();
         }
         if (requested === undefined && skipped.length > 0) {
+            /* An engine that is not there is not a pass: the SQL-only defects and every engine
+             * difference go untested. Leaving one out has to be asked for by name. */
+            const allowed = new Set(str(flags, "skip-backend")?.split(",") ?? []);
             for (const backend of skipped) {
                 const why = backend === "sqlite"
                     ? "node:sqlite unavailable (Node 22 needs --experimental-sqlite)"
                     : "no Postgres server reachable on the default connection";
-                process.stdout.write(`  note: ${backend} backend skipped — ${why}\n`);
+                if (allowed.has(backend)) {
+                    process.stdout.write(`  note: ${backend} backend skipped as asked — ${why}\n`);
+                }
+                else {
+                    failures += 1;
+                    process.stdout.write(`  ✗ ${backend} backend unavailable — ${why}. Start it, or pass --skip-backend ${backend}\n`);
+                }
             }
             process.stdout.write("\n");
         }
@@ -407,7 +617,15 @@ export async function main() {
              * probe writing into a constrained field — was invisible to the one-at-a-time matrix. */
             const { renderFuzz, runFuzz } = await import("./conformance/fuzz.js");
             process.stdout.write(`\n  ── combinations ${"─".repeat(46)}\n`);
-            const smoke = renderFuzz(await runFuzz({ backend: "memory", cases: 40, maxDefects: 6, seed: 1 }));
+            /* A fixed seed tests the same 40 combinations forever. CI passes a fresh one per run and
+             * the seed is printed, so any failure it finds replays exactly. */
+            const fuzzSeed = Number.parseInt(str(flags, "fuzz-seed") ?? "1", 10);
+            if (!Number.isSafeInteger(fuzzSeed) || fuzzSeed < 1) {
+                process.stderr.write("oat: --fuzz-seed must be a positive integer\n");
+                return 2;
+            }
+            process.stdout.write(`  fuzz seed ${fuzzSeed} — replay with --fuzz 40 --max-defects 6 --seed ${fuzzSeed}\n`);
+            const smoke = renderFuzz(await runFuzz({ backend: "memory", cases: 40, maxDefects: 6, seed: fuzzSeed }));
             process.stdout.write(smoke.text);
             failures += smoke.failures;
         }
@@ -460,13 +678,19 @@ export async function main() {
         return commandRun(flags);
     const specFlag = str(flags, "spec");
     const configPath = str(flags, "config");
-    const loaded = configPath === undefined ? undefined : await loadConfig(configPath);
+    const read = configPath === undefined ? undefined : await readConfig(configPath, false);
+    if (read !== undefined && "problem" in read) {
+        process.stderr.write(`oat: ${read.problem}\n`);
+        return EXIT.usage;
+    }
+    const loaded = read?.config;
     const specSource = specFlag ?? loaded?.spec;
     if (specSource === undefined) {
         process.stderr.write("oat: --spec (or --config) is required\n\n" + USAGE);
         return 2;
     }
-    const raw = await loadSpec(specSource, str(flags, "base-url"));
+    /* A relative spec resolves against the config's base URL, as it does for `run`. */
+    const raw = await loadSpec(specSource, str(flags, "base-url") ?? loaded?.baseUrl);
     const { doc, externalRefs } = dereference(raw);
     const model = buildModel(doc);
     try {
@@ -500,7 +724,7 @@ export async function main() {
             return 0;
         }
         case "doctor": {
-            const config = configPath === undefined ? undefined : interpolate(await loadConfig(configPath));
+            const config = loaded;
             const output = report.doctor(model, externalRefs, flags.json === true, config === undefined
                 ? undefined
                 : {
@@ -521,7 +745,7 @@ export function start() {
         process.exitCode = code;
     }, (error) => {
         process.stderr.write(`oat: ${error instanceof Error ? error.message : String(error)}\n`);
-        process.exitCode = 1;
+        process.exitCode = EXIT.failed;
     });
 }
 /* `node dist/cli.js …` is the test/CI entry. `bin/oat.js` calls start() itself because

package/dist/config/define-config.d.ts

@@ -361,6 +361,8 @@ export interface RateLimitSpec {
      */
     category?: string;
 }
+/** How much of the string payload catalog a run sends. */
+export type PayloadPolicy = "full" | "per-write-path";
 export interface OatConfig {
     /** OpenAPI document — an http(s) URL or a filesystem path. JSON or YAML. */
     spec: string;
@@ -387,6 +389,12 @@ export interface OatConfig {
      * Defaults: `{ attempts: 6, initialMs: 200, maxMs: 3000 }` (~9s worst case).
      */
     outOfBand?: OutOfBandConfig;
+    /**
+     * How much of the 159-case string payload catalog to send. `"per-write-path"` (the default)
+     * sends all of it once per distinct write path — request media type and field type — and a
+     * representative family of each kind elsewhere; `"full"` sends all of it to every field.
+     */
+    payloads?: PayloadPolicy;
     /** Path parameters oat cannot create. Also declarable in-spec via `x-root`. */
     roots?: Record<string, string>;
     /** Fixture generation derives from this, so a failing run is exactly reproducible. */

package/dist/config/define-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-config.d.ts","sourceRoot":"","sources":["../../src/config/define-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"define-config.d.ts","sourceRoot":"","sources":["../../src/config/define-config.ts"],"names":[],"mappings":"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"}

package/dist/config/define-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"define-config.js","sourceRoot":"","sources":["../../src/config/define-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwIH,MAAM,UAAU,UAAU,CAAC,IAAmB;IAC7C,OAAO,UAAU,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,CAAA;AACrF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAmB;IAC7C,OAAO,OAAO,IAAI,IAAI,CAAA;AACvB,CAAC;AAkWD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,MAAiB;IAC7C,OAAO,MAAM,CAAA;AACd,CAAC"}
+{"version":3,"file":"define-config.js","sourceRoot":"","sources":["../../src/config/define-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwIH,MAAM,UAAU,UAAU,CAAC,IAAmB;IAC7C,OAAO,UAAU,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,CAAA;AACrF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAmB;IAC7C,OAAO,OAAO,IAAI,IAAI,CAAA;AACvB,CAAC;AA2WD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,MAAiB;IAC7C,OAAO,MAAM,CAAA;AACd,CAAC"}

package/dist/config/validate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The config, checked before anything runs.
+ *
+ * A misspelled key used to be ignored and a wrong type used to flow into the run — a
+ * `maxInFlight` of `"8"` silently became the default, a `cohortSize` of `0` seeded nothing. Each
+ * problem names the key path and what it should be, and the CLI exits 2 without sending a request.
+ */
+/** Every problem with `config`, by key path. `run` needs a spec, a base URL and a principal. */
+export declare function configProblems(config: unknown, options?: {
+    forRun?: boolean;
+}): string[];
+//# sourceMappingURL=validate.d.ts.map

package/dist/config/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/config/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwFH,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,EAAE,CAO5F"}