@restormel/testing-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Allotment Technology Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/bin/testing.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=testing.d.ts.map

package/dist/bin/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/bin/testing.ts"],"names":[],"mappings":""}

package/dist/bin/testing.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { runCli } from "../dispatch.js";
+const code = await runCli(process.argv.slice(2));
+process.exitCode = code;
+//# sourceMappingURL=testing.js.map

package/dist/bin/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../src/bin/testing.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC"}

package/dist/dispatch.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Run the CLI and return a process exit code (does not call `process.exit`).
+ */
+export declare function runCli(argv: string[]): Promise<number>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAiNA;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA6C5D"}

package/dist/dispatch.js

@@ -0,0 +1,205 @@
+import { access, constants, mkdir, writeFile } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { formatConfigErrors, loadConfigFromFile } from "@restormel/testing-config";
+import { keysAdapterOptionsFromProcessEnv } from "@restormel/testing-keys-adapter";
+import { formatRunSummary, PRE_RUN_FAILURE_JSON, readRunArtifacts, writeRunReportBundle, } from "@restormel/testing-report";
+import { runLocalSuite } from "@restormel/testing-runner";
+import { runDoctor } from "./doctor.js";
+import { EXIT_FAILED, EXIT_OK, EXIT_USAGE } from "./exit-codes.js";
+import { printCommandHelp, printGlobalHelp } from "./help.js";
+import { parseArgs } from "./parse-args.js";
+import { STARTER_CONFIG_YAML } from "./starter-config.js";
+import { cliPackageVersion } from "./version.js";
+function programLabel() {
+    const exe = process.argv[1];
+    if (!exe)
+        return "testing";
+    const base = basename(exe, ".js");
+    return base === "restormel-testing" ? "restormel-testing" : "testing";
+}
+async function cmdInit(opts) {
+    if (opts.print) {
+        process.stdout.write(STARTER_CONFIG_YAML);
+        return EXIT_OK;
+    }
+    if (!opts.force) {
+        try {
+            await access(opts.config, constants.F_OK);
+            console.error(`${programLabel()} init: file already exists: ${opts.config}`);
+            console.error(`Use --force to overwrite, or --print to view the template.`);
+            return EXIT_USAGE;
+        }
+        catch {
+            /* absent */
+        }
+    }
+    await mkdir(dirname(opts.config), { recursive: true });
+    await writeFile(opts.config, STARTER_CONFIG_YAML, "utf8");
+    console.log(`Wrote ${opts.config}`);
+    return EXIT_OK;
+}
+async function cmdValidate(opts) {
+    const loaded = await loadConfigFromFile(opts.config);
+    if (!loaded.ok) {
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: false, errors: loaded.errors }, null, 2));
+        }
+        else {
+            console.error(formatConfigErrors(loaded.errors));
+        }
+        return EXIT_USAGE;
+    }
+    if (opts.json) {
+        console.log(JSON.stringify({
+            ok: true,
+            schema_version: loaded.config.schemaVersion,
+            config_path: opts.config,
+        }, null, 2));
+    }
+    else {
+        console.log(`Valid ${opts.config} (schema_version ${loaded.config.schemaVersion})`);
+    }
+    return EXIT_OK;
+}
+function defaultArtifactDir() {
+    const slug = new Date().toISOString().replace(/[:.]/g, "-");
+    return join(process.cwd(), ".restormel-testing", "runs", `run-${slug}`);
+}
+async function cmdRun(opts) {
+    const artifactDir = opts.artifactDir ?? defaultArtifactDir();
+    await mkdir(artifactDir, { recursive: true });
+    const keysAdapterOptions = keysAdapterOptionsFromProcessEnv();
+    const result = await runLocalSuite({
+        configPath: opts.config,
+        suiteId: opts.suite,
+        environmentId: opts.environmentId,
+        targetUrlOverride: opts.targetUrl,
+        commitSha: opts.commitSha,
+        repository: opts.repository,
+        trigger: opts.trigger,
+        artifactDir,
+        headless: opts.headless,
+        goalIds: opts.goalIds,
+        keysAdapterOptions,
+    });
+    if (!result.ok) {
+        const failureDoc = {
+            ok: false,
+            phase: "pre_run",
+            errors: result.errors,
+        };
+        await writeFile(join(artifactDir, PRE_RUN_FAILURE_JSON), JSON.stringify(failureDoc, null, 2), "utf8");
+        if (opts.json) {
+            console.log(JSON.stringify({
+                ok: false,
+                errors: result.errors,
+                artifact_dir: artifactDir,
+                partial_artifacts: [PRE_RUN_FAILURE_JSON],
+            }, null, 2));
+        }
+        else {
+            console.error(result.errors.join("\n"));
+            console.error(`Partial artefacts: ${artifactDir} (${PRE_RUN_FAILURE_JSON})`);
+        }
+        for (const w of result.warnings)
+            console.warn(w);
+        return EXIT_USAGE;
+    }
+    const run = result.run;
+    if (!run) {
+        console.error("Internal error: missing run record.");
+        return EXIT_FAILED;
+    }
+    const program = programLabel();
+    let reproduceRun = `${program} run --suite ${opts.suite} --config ${opts.config}`;
+    if (opts.environmentId !== undefined)
+        reproduceRun += ` --environment ${opts.environmentId}`;
+    if (opts.goalIds !== undefined && opts.goalIds.length > 0) {
+        reproduceRun += ` --goal ${opts.goalIds.join(",")}`;
+    }
+    await writeRunReportBundle(artifactDir, {
+        run,
+        traces: result.traces,
+        warnings: result.warnings.length ? result.warnings : undefined,
+        suite: result.suiteMeta,
+        reproduction: {
+            report_command: `${program} report ${artifactDir}`,
+            notes: `Re-run suite: ${reproduceRun}`.trim(),
+        },
+    });
+    for (const w of result.warnings)
+        console.warn(w);
+    if (opts.json) {
+        console.log(JSON.stringify({
+            ok: true,
+            verdict: run.verdict,
+            run_id: run.id,
+            artifact_dir: artifactDir,
+            suite_id: run.suiteId,
+            environment_id: run.environmentId,
+        }, null, 2));
+    }
+    else {
+        console.log(formatRunSummary(run));
+        console.log(`\nArtefacts: ${artifactDir}\n  (run.json, traces.json, report.json, summary.md, github-summary.md, junit.xml)`);
+    }
+    if (run.verdict !== "passed") {
+        return EXIT_FAILED;
+    }
+    return EXIT_OK;
+}
+async function cmdReport(opts) {
+    const loaded = await readRunArtifacts(opts.path);
+    if (!("run" in loaded)) {
+        console.error(loaded.message);
+        return EXIT_USAGE;
+    }
+    console.log(formatRunSummary(loaded.run));
+    if (loaded.warnings.length > 0) {
+        console.warn("Warnings from run:");
+        for (const w of loaded.warnings)
+            console.warn(`  ${w}`);
+    }
+    return EXIT_OK;
+}
+/**
+ * Run the CLI and return a process exit code (does not call `process.exit`).
+ */
+export async function runCli(argv) {
+    const program = programLabel();
+    const parsed = parseArgs(argv);
+    if (parsed.kind === "help") {
+        if (parsed.topic !== undefined) {
+            const ok = printCommandHelp(program, parsed.topic);
+            return ok ? EXIT_OK : EXIT_USAGE;
+        }
+        printGlobalHelp(program);
+        return EXIT_OK;
+    }
+    if (parsed.kind === "version") {
+        console.log(cliPackageVersion());
+        return EXIT_OK;
+    }
+    if (parsed.kind === "error") {
+        console.error(`${program}: ${parsed.message}`);
+        console.error(`Run '${program} --help' for usage.`);
+        return EXIT_USAGE;
+    }
+    if (parsed.kind === "init") {
+        return cmdInit(parsed);
+    }
+    if (parsed.kind === "validate") {
+        return cmdValidate(parsed);
+    }
+    if (parsed.kind === "run") {
+        return cmdRun(parsed);
+    }
+    if (parsed.kind === "report") {
+        return cmdReport(parsed);
+    }
+    if (parsed.kind === "doctor") {
+        return runDoctor({ config: parsed.config });
+    }
+    return EXIT_USAGE;
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/dispatch.js.map

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

package/dist/doctor.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Minimal prerequisite checks (no secret values printed).
+ * Exit 0 = OK, 2 = hard failure (Node / browser / missing config file).
+ */
+export declare function runDoctor(opts: {
+    config?: string;
+}): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA0C1E"}

package/dist/doctor.js

@@ -0,0 +1,46 @@
+import { access, constants } from "node:fs/promises";
+import { chromium } from "playwright";
+/**
+ * Minimal prerequisite checks (no secret values printed).
+ * Exit 0 = OK, 2 = hard failure (Node / browser / missing config file).
+ */
+export async function runDoctor(opts) {
+    const major = Number.parseInt(process.versions.node.split(".")[0] ?? "0", 10);
+    if (Number.isNaN(major) || major < 20) {
+        console.error(`doctor: Node 20+ required (got ${process.version})`);
+        return 2;
+    }
+    console.log(`doctor: Node ${process.version} OK`);
+    if (opts.config !== undefined) {
+        try {
+            await access(opts.config, constants.R_OK);
+            console.log(`doctor: config readable (${opts.config})`);
+        }
+        catch {
+            console.error(`doctor: config not readable: ${opts.config}`);
+            return 2;
+        }
+    }
+    try {
+        const exe = chromium.executablePath();
+        console.log(`doctor: Playwright Chromium executable OK`);
+        console.log(`  ${exe}`);
+    }
+    catch {
+        console.error("doctor: Playwright Chromium not installed — run:\n  pnpm --filter @restormel/testing-browser-playwright exec playwright install chromium");
+        return 2;
+    }
+    const keysBase = process.env.RESTORMEL_KEYS_API_BASE_URL?.trim();
+    const fallback = process.env.RESTORMEL_TESTING_OPENAI_FALLBACK?.trim() === "1";
+    if (keysBase) {
+        console.log("doctor: RESTORMEL_KEYS_API_BASE_URL is set (value not shown)");
+    }
+    else if (fallback) {
+        console.log("doctor: RESTORMEL_TESTING_OPENAI_FALLBACK=1 (OpenAI env fallback may be used for judges)");
+    }
+    else {
+        console.log("doctor: Keys HTTP not set — goals with judge_rubric need RESTORMEL_KEYS_API_BASE_URL or RESTORMEL_TESTING_OPENAI_FALLBACK=1");
+    }
+    return 0;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAyB;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9E,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACtC,OAAO,CAAC,KAAK,CAAC,kCAAkC,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC;QACpE,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,CAAC,OAAO,KAAK,CAAC,CAAC;IAElD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,gCAAgC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7D,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CACX,0IAA0I,CAC3I,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,IAAI,EAAE,CAAC;IACjE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iCAAiC,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC;IAC/E,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;IAC9E,CAAC;SAAM,IAAI,QAAQ,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,0FAA0F,CAAC,CAAC;IAC1G,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CACT,6HAA6H,CAC9H,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/exit-codes.d.ts

@@ -0,0 +1,10 @@
+/** Normal success. */
+export declare const EXIT_OK = 0;
+/**
+ * Run finished but suite did not pass (failed / indeterminate), or unexpected runtime failure.
+ * Use in CI to fail the job when tests fail.
+ */
+export declare const EXIT_FAILED = 1;
+/** Invalid usage, missing arguments, missing files, or invalid config (validate / init guardrails). */
+export declare const EXIT_USAGE = 2;
+//# sourceMappingURL=exit-codes.d.ts.map

package/dist/exit-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../src/exit-codes.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,eAAO,MAAM,OAAO,IAAI,CAAC;AAEzB;;;GAGG;AACH,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B,uGAAuG;AACvG,eAAO,MAAM,UAAU,IAAI,CAAC"}

package/dist/exit-codes.js

@@ -0,0 +1,10 @@
+/** Normal success. */
+export const EXIT_OK = 0;
+/**
+ * Run finished but suite did not pass (failed / indeterminate), or unexpected runtime failure.
+ * Use in CI to fail the job when tests fail.
+ */
+export const EXIT_FAILED = 1;
+/** Invalid usage, missing arguments, missing files, or invalid config (validate / init guardrails). */
+export const EXIT_USAGE = 2;
+//# sourceMappingURL=exit-codes.js.map

package/dist/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../src/exit-codes.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC;AAEzB;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAE7B,uGAAuG;AACvG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC"}

package/dist/help.d.ts

@@ -0,0 +1,4 @@
+export declare function printGlobalHelp(program: string): void;
+/** @returns false if topic is unknown */
+export declare function printCommandHelp(program: string, topic: string): boolean;
+//# sourceMappingURL=help.d.ts.map

package/dist/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAiCrD;AAED,yCAAyC;AACzC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CA0ExE"}

package/dist/help.js

@@ -0,0 +1,107 @@
+const KNOWN_TOPICS = new Set(["init", "validate", "run", "report", "doctor"]);
+export function printGlobalHelp(program) {
+    console.log(`${program} — Restormel / Testing CLI
+
+Usage:
+  ${program} <command> [options]
+
+Commands:
+  init       Write a starter config file (or print it with --print)
+  validate   Check that a config file parses and satisfies the schema
+  run        Execute a browser suite locally and write report artefacts
+  report     Print a human summary from a previous run directory
+  doctor     Check Node, optional config file, Playwright Chromium, Keys env hints
+
+Global options:
+  -h, --help       Show help (optionally: ${program} help <command>)
+  -v, --version    Print CLI version
+
+Examples:
+  ${program} init
+  ${program} validate --config restormel-testing.yaml
+  ${program} validate --config restormel-testing.yaml --json
+  ${program} run --suite web-critical --config restormel-testing.yaml
+  ${program} run --suite web-critical --goal smoke,login --config restormel-testing.yaml
+  ${program} report .restormel-testing/runs/run-2026-04-07
+  ${program} doctor --config restormel-testing.yaml
+
+Environment (Keys / judges — values never printed):
+  RESTORMEL_KEYS_API_BASE_URL     Keys HTTP API origin (optional)
+  RESTORMEL_KEYS_API_TOKEN_ENV    Name of env var with Keys API bearer (default RESTORMEL_KEYS_API_TOKEN)
+  RESTORMEL_TESTING_OPENAI_FALLBACK   Set to 1 for documented OPENAI_API_KEY fallback when Keys unset
+
+See docs/config-reference-mvp.md for supported YAML, CLI --json behaviour, and judge_rubric notes.
+`);
+}
+/** @returns false if topic is unknown */
+export function printCommandHelp(program, topic) {
+    const t = topic.toLowerCase();
+    if (!KNOWN_TOPICS.has(t)) {
+        console.error(`Unknown help topic: ${topic}`);
+        console.error(`Try: ${program} help init | validate | run | report | doctor`);
+        return false;
+    }
+    if (t === "init") {
+        console.log(`${program} init [options]
+
+Write 'restormel-testing.yaml' (or another path via --config) with a minimal valid example.
+
+Options:
+  -c, --config <path>   Output file (default: restormel-testing.yaml)
+      --print           Print to stdout instead of writing a file
+      --force           Overwrite an existing file
+`);
+        return true;
+    }
+    if (t === "validate") {
+        console.log(`${program} validate [options]
+
+Validate configuration. Exits 0 if valid, non-zero if not.
+
+Options:
+  -c, --config <path>   Config file (default: restormel-testing.yaml)
+      --json              Print { ok, schema_version } or { ok: false, errors } to stdout
+`);
+        return true;
+    }
+    if (t === "run") {
+        console.log(`${program} run --suite <name> [options]
+
+Run a suite. Writes JSON artefacts under --artifact-dir (default: timestamped dir under .restormel-testing/runs/).
+
+Exit codes: 0 passed, 1 suite failed or indeterminate, 2 config or usage error.
+
+Options:
+      --suite <name>        Suite id from the config (required)
+      --goal <ids>          Comma-separated goal ids (subset of suite; repeatable)
+  -c, --config <path>       Config file (default: restormel-testing.yaml)
+      --environment, --env <id>  Environment id (default: suite's environment)
+      --target-url <url>    Override base URL (e.g. preview deploy; no credentials in URL)
+      --commit-sha <sha>    Record in run metadata
+      --repository <slug> Record in run metadata (e.g. org/name)
+      --artifact-dir <dir>  Directory for screenshots + run.json + traces.json
+      --headed              Run browser non-headless (local debugging)
+      --ci                  Mark trigger as 'ci' in the run record
+      --json                Print JSON to stdout. On success: verdict, run_id, artifact_dir. On pre-run failure (before RunRecord): ok false, errors, artifact_dir, partial_artifacts (includes pre-run-failure.json in the run directory)
+`);
+        return true;
+    }
+    if (t === "doctor") {
+        console.log(`${program} doctor [options]
+
+Check Node 20+, optional config readability, Playwright Chromium install, and whether Keys-related env vars are set (names only).
+
+Options:
+  -c, --config <path>   If set, file must exist and be readable
+
+Exit: 0 OK, 2 prerequisite failure
+`);
+        return true;
+    }
+    console.log(`${program} report <path>
+
+Print a summary from a run artefact directory (containing run.json) or a direct path to run.json.
+`);
+    return true;
+}
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE9E,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO;;;IAGpB,OAAO;;;;;;;;;;4CAUiC,OAAO;;;;IAI/C,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;;;;;;;;CAQV,CAAC,CAAC;AACH,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,KAAa;IAC7D,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC9B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,KAAK,CAAC,QAAQ,OAAO,+CAA+C,CAAC,CAAC;QAC9E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO;;;;;;;;CAQzB,CAAC,CAAC;QACC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO;;;;;;;CAOzB,CAAC,CAAC;QACC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO;;;;;;;;;;;;;;;;;;CAkBzB,CAAC,CAAC;QACC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO;;;;;;;;CAQzB,CAAC,CAAC;QACC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO;;;CAGvB,CAAC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/parse-args.d.ts

@@ -0,0 +1,42 @@
+export type ParsedCli = {
+    kind: "help";
+    topic?: string;
+} | {
+    kind: "version";
+} | {
+    kind: "init";
+    config: string;
+    print: boolean;
+    force: boolean;
+} | {
+    kind: "validate";
+    config: string;
+    json: boolean;
+} | {
+    kind: "run";
+    suite: string;
+    config: string;
+    environmentId?: string;
+    targetUrl?: string;
+    commitSha?: string;
+    repository?: string;
+    artifactDir?: string;
+    headless: boolean;
+    trigger: "local" | "ci";
+    goalIds?: string[];
+    json: boolean;
+} | {
+    kind: "report";
+    path: string;
+} | {
+    kind: "doctor";
+    config?: string;
+} | {
+    kind: "error";
+    message: string;
+};
+/**
+ * Parse argv with `process.argv.slice(2)` (no `node`, no executable).
+ */
+export declare function parseArgs(argv: string[]): ParsedCli;
+//# sourceMappingURL=parse-args.d.ts.map

package/dist/parse-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.d.ts","sourceRoot":"","sources":["../src/parse-args.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACnD;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;CACf,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAsNvC;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAoCnD"}

package/dist/parse-args.js

@@ -0,0 +1,241 @@
+function parseInitArgs(args) {
+    let config = "restormel-testing.yaml";
+    let print = false;
+    let force = false;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--print") {
+            print = true;
+            continue;
+        }
+        if (a === "--force") {
+            force = true;
+            continue;
+        }
+        if (a === "--config" || a === "-c") {
+            const v = args[++i];
+            if (!v || v.startsWith("-")) {
+                return { kind: "error", message: "init: --config requires a file path" };
+            }
+            config = v;
+            continue;
+        }
+        if (a === "-h" || a === "--help") {
+            return { kind: "help", topic: "init" };
+        }
+        return { kind: "error", message: `init: unexpected argument: ${a}` };
+    }
+    return { kind: "init", config, print, force };
+}
+function parseValidateArgs(args) {
+    let config = "restormel-testing.yaml";
+    let json = false;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--json") {
+            json = true;
+            continue;
+        }
+        if (a === "--config" || a === "-c") {
+            const v = args[++i];
+            if (!v || v.startsWith("-")) {
+                return { kind: "error", message: "validate: --config requires a file path" };
+            }
+            config = v;
+            continue;
+        }
+        if (a === "-h" || a === "--help") {
+            return { kind: "help", topic: "validate" };
+        }
+        return { kind: "error", message: `validate: unexpected argument: ${a}` };
+    }
+    return { kind: "validate", config, json };
+}
+function parseRunArgs(args) {
+    let suite;
+    let config = "restormel-testing.yaml";
+    let environmentId;
+    let targetUrl;
+    let commitSha;
+    let repository;
+    let artifactDir;
+    let headless = true;
+    let trigger = "local";
+    const goalIds = [];
+    let json = false;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--suite") {
+            const v = args[++i];
+            if (!v || v.startsWith("-")) {
+                return { kind: "error", message: "run: --suite requires a value" };
+            }
+            suite = v;
+            continue;
+        }
+        if (a === "--goal") {
+            const v = args[++i];
+            if (!v || v.startsWith("-")) {
+                return { kind: "error", message: "run: --goal requires a value" };
+            }
+            for (const part of v.split(",")) {
+                const id = part.trim();
+                if (id.length > 0)
+                    goalIds.push(id);
+            }
+            continue;
+        }
+        if (a === "--environment" || a === "--env") {
+            const v = args[++i];
+            if (!v || v.startsWith("-")) {
+                return { kind: "error", message: "run: --environment requires a value" };
+            }
+            environmentId = v;
+            continue;
+        }
+        if (a === "--target-url") {
+            const v = args[++i];
+            if (!v || v.startsWith("-")) {
+                return { kind: "error", message: "run: --target-url requires a value" };
+            }
+            targetUrl = v;
+            continue;
+        }
+        if (a === "--commit-sha") {
+            const v = args[++i];
+            if (!v || v.startsWith("-")) {
+                return { kind: "error", message: "run: --commit-sha requires a value" };
+            }
+            commitSha = v;
+            continue;
+        }
+        if (a === "--repository") {
+            const v = args[++i];
+            if (!v || v.startsWith("-")) {
+                return { kind: "error", message: "run: --repository requires a value" };
+            }
+            repository = v;
+            continue;
+        }
+        if (a === "--config" || a === "-c") {
+            const v = args[++i];
+            if (!v || v.startsWith("-")) {
+                return { kind: "error", message: "run: --config requires a file path" };
+            }
+            config = v;
+            continue;
+        }
+        if (a === "--artifact-dir") {
+            const v = args[++i];
+            if (!v || v.startsWith("-")) {
+                return { kind: "error", message: "run: --artifact-dir requires a directory path" };
+            }
+            artifactDir = v;
+            continue;
+        }
+        if (a === "--headed") {
+            headless = false;
+            continue;
+        }
+        if (a === "--ci") {
+            trigger = "ci";
+            continue;
+        }
+        if (a === "--json") {
+            json = true;
+            continue;
+        }
+        if (a === "-h" || a === "--help") {
+            return { kind: "help", topic: "run" };
+        }
+        return { kind: "error", message: `run: unexpected argument: ${a}` };
+    }
+    if (!suite) {
+        return { kind: "error", message: "run: --suite <name> is required" };
+    }
+    return {
+        kind: "run",
+        suite,
+        config,
+        environmentId,
+        targetUrl,
+        commitSha,
+        repository,
+        artifactDir,
+        headless,
+        trigger,
+        goalIds: goalIds.length > 0 ? goalIds : undefined,
+        json,
+    };
+}
+function parseReportArgs(args) {
+    const rest = [...args];
+    for (let i = 0; i < rest.length; i++) {
+        if (rest[i] === "-h" || rest[i] === "--help") {
+            return { kind: "help", topic: "report" };
+        }
+    }
+    const pos = rest.filter((a) => !a.startsWith("-"));
+    if (pos.length === 0) {
+        return { kind: "error", message: "report: requires a path to a run directory or run.json" };
+    }
+    if (pos.length > 1) {
+        return { kind: "error", message: "report: too many arguments" };
+    }
+    return { kind: "report", path: pos[0] };
+}
+function parseDoctorArgs(args) {
+    let config;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--config" || a === "-c") {
+            const v = args[++i];
+            if (!v || v.startsWith("-")) {
+                return { kind: "error", message: "doctor: --config requires a file path" };
+            }
+            config = v;
+            continue;
+        }
+        if (a === "-h" || a === "--help") {
+            return { kind: "help", topic: "doctor" };
+        }
+        return { kind: "error", message: `doctor: unexpected argument: ${a}` };
+    }
+    return { kind: "doctor", config };
+}
+/**
+ * Parse argv with `process.argv.slice(2)` (no `node`, no executable).
+ */
+export function parseArgs(argv) {
+    if (argv.length === 0) {
+        return { kind: "help" };
+    }
+    const first = argv[0];
+    if (first === "-h" || first === "--help") {
+        return { kind: "help", topic: argv[1] };
+    }
+    if (first === "--version" || first === "-v") {
+        return { kind: "version" };
+    }
+    if (first === "help") {
+        return { kind: "help", topic: argv[1] };
+    }
+    const rest = argv.slice(1);
+    if (first === "init") {
+        return parseInitArgs(rest);
+    }
+    if (first === "validate") {
+        return parseValidateArgs(rest);
+    }
+    if (first === "run") {
+        return parseRunArgs(rest);
+    }
+    if (first === "report") {
+        return parseReportArgs(rest);
+    }
+    if (first === "doctor") {
+        return parseDoctorArgs(rest);
+    }
+    return { kind: "error", message: `Unknown command: ${first}` };
+}
+//# sourceMappingURL=parse-args.js.map

package/dist/parse-args.js.map

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

package/dist/starter-config.d.ts

@@ -0,0 +1,3 @@
+/** Minimal valid `restormel-testing` document (schema v1). */
+export declare const STARTER_CONFIG_YAML = "schema_version: \"1\"\n\n# Optional global Keys logical refs (opaque; never put API keys here):\n# keys:\n#   llm_primary: ref:restormel-keys:llm/primary\n\nenvironments:\n  local:\n    base_url: https://example.com\n\nsuites:\n  - id: example\n    environment: local\n    goals:\n      - id: smoke\n        type: browser\n        description: Replace with a real user-visible outcome for your app\n        success_criteria:\n          text_present:\n            - Example Domain\n";
+//# sourceMappingURL=starter-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"starter-config.d.ts","sourceRoot":"","sources":["../src/starter-config.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,seAoB/B,CAAC"}

package/dist/starter-config.js

@@ -0,0 +1,23 @@
+/** Minimal valid `restormel-testing` document (schema v1). */
+export const STARTER_CONFIG_YAML = `schema_version: "1"
+
+# Optional global Keys logical refs (opaque; never put API keys here):
+# keys:
+#   llm_primary: ref:restormel-keys:llm/primary
+
+environments:
+  local:
+    base_url: https://example.com
+
+suites:
+  - id: example
+    environment: local
+    goals:
+      - id: smoke
+        type: browser
+        description: Replace with a real user-visible outcome for your app
+        success_criteria:
+          text_present:
+            - Example Domain
+`;
+//# sourceMappingURL=starter-config.js.map

package/dist/starter-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter-config.js","sourceRoot":"","sources":["../src/starter-config.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBlC,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+/** CLI package version (from `packages/cli/package.json`). */
+export declare function cliPackageVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAMA,8DAA8D;AAC9D,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C"}

package/dist/version.js

@@ -0,0 +1,10 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const dir = dirname(fileURLToPath(import.meta.url));
+/** CLI package version (from `packages/cli/package.json`). */
+export function cliPackageVersion() {
+    const raw = readFileSync(join(dir, "..", "package.json"), "utf8");
+    return JSON.parse(raw).version;
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEpD,8DAA8D;AAC9D,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;IAClE,OAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC,OAAO,CAAC;AAC1D,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@restormel/testing-cli",
+  "version": "0.1.0",
+  "description": "Restormel / Testing CLI (init, validate, run, report).",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Allotment-Technology-Ltd/restormel-testing.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/Allotment-Technology-Ltd/restormel-testing/issues"
+  },
+  "homepage": "https://github.com/Allotment-Technology-Ltd/restormel-testing/tree/main/packages/cli#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "testing": "./dist/bin/testing.js",
+    "restormel-testing": "./dist/bin/testing.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "playwright": "^1.49.0",
+    "@restormel/testing-keys-adapter": "0.1.0",
+    "@restormel/testing-report": "0.1.0",
+    "@restormel/testing-runner": "0.1.0",
+    "@restormel/testing-config": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.json",
+    "typecheck": "tsc -b tsconfig.json"
+  }
+}