@runcofactor/cli 0.52.0 → 0.53.0

package/dist/{test-suite-CTACGIAZ.js → test-suite-SW25YGJV.js}

@@ -1,22 +1,22 @@
 import { createRequire as __cr } from "module"; import { fileURLToPath as __fup } from "url"; import { dirname as __dn } from "path"; const require = __cr(import.meta.url); const __filename = __fup(import.meta.url); const __dirname = __dn(__filename);
 import {
   formatTeardownLines
-} from "./chunk-Z3MDQSZG.js";
-import {
-  fetchEnvironments,
-  resolveEnvironment
-} from "./chunk-CYSPCGO6.js";
-import "./chunk-775FI436.js";
+} from "./chunk-PJFFGQSB.js";
 import {
   resolveSlackChannelIds,
   resolveTeamsChannelValues
-} from "./chunk-QA37WVF6.js";
-import "./chunk-LIEADTEF.js";
-import "./chunk-QTYUM4ZB.js";
+} from "./chunk-OQFCZERZ.js";
+import "./chunk-LJFVRJCA.js";
+import {
+  fetchEnvironments,
+  resolveEnvironment
+} from "./chunk-JEHHEMUL.js";
+import "./chunk-RVD6J6IZ.js";
+import "./chunk-EJ3ZPH5U.js";
 import "./chunk-DEK6B6LX.js";
 import {
   runRemoteTest
-} from "./chunk-EUVB6Y3C.js";
+} from "./chunk-P7L5KELH.js";
 import {
   UUID_RE,
   apiRequest,
@@ -27,25 +27,25 @@ import {
   getScalarArgValue,
   resolveCredentialId,
   resolveTestSuite
-} from "./chunk-LL6TSQWV.js";
+} from "./chunk-VKZOHJCE.js";
 import "./chunk-S3Q7MDCS.js";
 import {
   WORKFLOW_FLOW_TYPES
-} from "./chunk-76Z6E7XX.js";
+} from "./chunk-4UZN6TVT.js";
 import {
   getArgValue,
   hasFlag,
   isSuperadminToken,
   resolveConfig
-} from "./chunk-3HI6QC4V.js";
+} from "./chunk-WRBU6TX7.js";
 import {
   writeRawOutput,
   writeUntrustedText
-} from "./chunk-UEJ2HTKU.js";
+} from "./chunk-MJVUMVLO.js";
 import "./chunk-TOWZAG3I.js";
 
 // src/test-suite.ts
-import process3 from "process";
+import process4 from "process";
 
 // src/test-suite-external.ts
 import process from "process";
@@ -762,6 +762,74 @@ function fail2(message) {
   process2.exit(1);
 }
 
+// src/test-suite-catalog.ts
+import process3 from "process";
+async function handleSuitesList(argv, apiUrl, token) {
+  const jsonOutput = hasFlag(argv, "--json");
+  const res = await apiRequest(apiUrl, token, "GET", "/test-suites");
+  if (!res.ok) {
+    console.error(`Error: ${res.error ?? "Failed to list test suites"}`);
+    process3.exit(1);
+  }
+  const suites = res.data ?? [];
+  if (jsonOutput) {
+    writeRawOutput(JSON.stringify(suites, null, 2));
+    return;
+  }
+  if (suites.length === 0) {
+    console.log("No test suites found.");
+    return;
+  }
+  writeRawOutput(formatSuitesTable(suites));
+}
+async function handleSuiteCatalogGet(argv, apiUrl, token) {
+  const suiteRef = getPositionalArg(argv, ["--api-url", "--token", "--org", "--env"]);
+  if (!suiteRef) {
+    console.error("Usage: cofactor test-suite suites get <suite-id|name> [--json]");
+    process3.exit(1);
+  }
+  const suite = await resolveTestSuite(suiteRef, apiUrl, token);
+  const response = await apiRequest(
+    apiUrl,
+    token,
+    "GET",
+    `/test-suites/${encodeURIComponent(suite.id)}`
+  );
+  if (!response.ok || !response.data) {
+    console.error(`Error: ${response.error ?? "Failed to read test suite"}`);
+    process3.exit(1);
+  }
+  const detail = response.data;
+  if (hasFlag(argv, "--json")) {
+    writeRawOutput(JSON.stringify(detail, null, 2));
+    return;
+  }
+  writeRawOutput(
+    [
+      `Suite: ${detail.name}`,
+      `ID: ${detail.id}`,
+      `Default: ${detail.isDefault ? "yes" : "no"}`,
+      `Kind: ${detail.kind}`,
+      `Failure mode: ${detail.failureMode}`,
+      `Members: ${detail.members.length}`
+    ].join("\n")
+  );
+}
+function formatSuitesTable(suites) {
+  const lines = [
+    `Named suites (${suites.length}):`,
+    "",
+    "  NAME                           KIND      DEFAULT MEMBERS  LAYERS  FAILURE MODE           ID"
+  ];
+  for (const suite of suites) {
+    lines.push(
+      `  ${suite.name.padEnd(30)} ${suite.kind.padEnd(9)} ${String(suite.isDefault ? "yes" : "no").padEnd(7)} ${String(suite.workflowCount).padEnd(8)} ${String(suite.layerCount).padEnd(7)} ${suite.failureMode.padEnd(22)} ${suite.id}`
+    );
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+
 // src/test-suite.ts
 var STATUS_ICONS = {
   completed: "\u2705",
@@ -825,7 +893,7 @@ async function handleList(argv, apiUrl, token) {
   );
   if (!result.ok) {
     console.error(`Error: ${result.error ?? "Unknown error"}`);
-    process3.exit(1);
+    process4.exit(1);
   }
   if (jsonOutput) {
     writeRawOutput(JSON.stringify(result, null, 2));
@@ -856,7 +924,7 @@ async function handleGet(argv, apiUrl, token) {
   const id = argv.find((a) => !a.startsWith("-"));
   if (!id) {
     console.error("Error: Missing execution ID. Usage: canary test-suite get <executionId>");
-    process3.exit(1);
+    process4.exit(1);
   }
   const jsonOutput = hasFlag(argv, "--json");
   const failuresOnly = hasFlag(argv, "--failures-only");
@@ -868,7 +936,7 @@ async function handleGet(argv, apiUrl, token) {
   );
   if (!result.ok) {
     console.error(`Error: ${result.error ?? "Unknown error"}`);
-    process3.exit(1);
+    process4.exit(1);
   }
   if (jsonOutput) {
     const output = failuresOnly ? { ...result, testRuns: result.testRuns.filter((r) => r.status === "failed") } : result;
@@ -926,7 +994,7 @@ async function handleDiagnostics(argv, apiUrl, token) {
     console.error(
       "Error: Missing arguments. Usage: canary test-suite diagnostics <workflowId> <runId>"
     );
-    process3.exit(1);
+    process4.exit(1);
   }
   const [workflowId, runId] = positional;
   const jsonOutput = hasFlag(argv, "--json");
@@ -939,7 +1007,7 @@ async function handleDiagnostics(argv, apiUrl, token) {
   );
   if (!result.ok) {
     console.error(`Error: ${result.error ?? "Unknown error"}`);
-    process3.exit(1);
+    process4.exit(1);
   }
   if (jsonOutput) {
     writeRawOutput(JSON.stringify(result, null, 2));
@@ -1010,7 +1078,7 @@ async function handleSteps(argv, apiUrl, token) {
   const positional = argv.filter((a) => !a.startsWith("-"));
   if (positional.length < 2) {
     console.error("Error: Missing arguments. Usage: canary test-suite steps <workflowId> <runId>");
-    process3.exit(1);
+    process4.exit(1);
   }
   const [workflowId, runId] = positional;
   const jsonOutput = hasFlag(argv, "--json");
@@ -1022,7 +1090,7 @@ async function handleSteps(argv, apiUrl, token) {
   );
   if (!result.ok) {
     console.error(`Error: ${result.error ?? "Unknown error"}`);
-    process3.exit(1);
+    process4.exit(1);
   }
   if (jsonOutput) {
     writeRawOutput(JSON.stringify(result, null, 2));
@@ -1075,31 +1143,31 @@ async function resolveFlowRef(ref, apiUrl, token) {
   });
   const result = await apiRequest(apiUrl, token, "GET", `/workflows?${params}`);
   if (!result.ok) {
-    process3.stderr.write(`Error: Failed to look up flow "${ref}": ${result.error ?? "Unknown error"}
+    process4.stderr.write(`Error: Failed to look up flow "${ref}": ${result.error ?? "Unknown error"}
 `);
-    process3.exit(1);
+    process4.exit(1);
   }
   const data = result.data;
   const totalItems = result.pagination.totalItems;
   if (totalItems > data.length) {
-    process3.stderr.write(
+    process4.stderr.write(
       `Error: "${ref}" matches more than the first ${data.length} of ${totalItems} flows returned by search \u2014 can't confirm the name isn't ambiguous. Pass the flow id instead, or use a more specific name.
 `
     );
-    process3.exit(1);
+    process4.exit(1);
   }
   const matches = data.filter((w) => w.name.toLowerCase() === ref.toLowerCase());
   if (matches.length === 0) {
-    process3.stderr.write(`Error: No flow named "${ref}" found. Pass the flow id instead of the name.
+    process4.stderr.write(`Error: No flow named "${ref}" found. Pass the flow id instead of the name.
 `);
-    process3.exit(1);
+    process4.exit(1);
   }
   if (matches.length > 1) {
-    process3.stderr.write(`Error: Multiple flows are named "${ref}":
+    process4.stderr.write(`Error: Multiple flows are named "${ref}":
 `);
     for (const m of matches) console.error(`  - ${m.id}`);
     console.error("Pass the flow id instead to disambiguate.");
-    process3.exit(1);
+    process4.exit(1);
   }
   return matches[0].id;
 }
@@ -1128,68 +1196,36 @@ function buildSuiteWriteBody(argv) {
       console.error(
         `Error: --failure-mode must be "continue" or "stop_on_layer_failure" (got "${failureMode}").`
       );
-      process3.exit(1);
+      process4.exit(1);
     }
     body.failureMode = failureMode;
   }
   return body;
 }
-async function handleSuitesList(argv, apiUrl, token) {
-  const jsonOutput = hasFlag(argv, "--json");
-  const res = await apiRequest(apiUrl, token, "GET", "/test-suites");
-  if (!res.ok) {
-    console.error(`Error: ${res.error ?? "Failed to list test suites"}`);
-    process3.exit(1);
-  }
-  const suites = res.data ?? [];
-  if (jsonOutput) {
-    writeRawOutput(JSON.stringify(suites, null, 2));
-    return;
-  }
-  if (suites.length === 0) {
-    console.log("No test suites found.");
-    return;
-  }
-  writeRawOutput(formatSuitesTable(suites));
-}
-function formatSuitesTable(suites) {
-  const lines = [
-    `Named suites (${suites.length}):`,
-    "",
-    `  ${pad("NAME", 30)} ${pad("KIND", 9)} ${pad("MEMBERS", 8)} ${pad("LAYERS", 7)} ${pad("FAILURE MODE", 22)} ID`
-  ];
-  for (const s of suites) {
-    lines.push(
-      `  ${pad(s.name, 30)} ${pad(s.kind, 9)} ${pad(String(s.workflowCount), 8)} ${pad(String(s.layerCount), 7)} ${pad(s.failureMode, 22)} ${s.id}`
-    );
-  }
-  lines.push("");
-  return lines.join("\n");
-}
 async function handleSuiteCreate(argv, apiUrl, token) {
   const jsonOutput = hasFlag(argv, "--json");
   const body = buildSuiteWriteBody(argv);
   if (typeof body.name !== "string" || !body.name.trim()) {
     console.error("Error: --name is required.");
     console.error("Usage: canary test-suite create --name <name> [options]");
-    process3.exit(1);
+    process4.exit(1);
   }
   const kind = getScalarArgValue(argv, "--kind");
   if (kind !== void 0 && kind !== "native" && kind !== "external") {
     console.error(`Error: --kind must be "native" or "external" (got "${kind}").`);
-    process3.exit(1);
+    process4.exit(1);
   }
   if (hasAnyFlag(argv, UPDATE_ONLY_RUNNER_FLAGS)) {
     console.error(
       'Error: runner flags are set with "test-suite update <suite> \u2026" after the suite exists.'
     );
-    process3.exit(1);
+    process4.exit(1);
   }
   if (kind !== "external" && hasAnyFlag(argv, EXTERNAL_SUITE_FLAGS.filter((f) => f !== "--kind"))) {
     console.error(
       "Error: --provider/--source/--repo/--ref/--property/--environment/--credential/--application require --kind external."
     );
-    process3.exit(1);
+    process4.exit(1);
   }
   let repoLabel;
   if (kind === "external") {
@@ -1201,7 +1237,7 @@ async function handleSuiteCreate(argv, apiUrl, token) {
   const res = await apiRequest(apiUrl, token, "POST", "/test-suites", body);
   if (!res.ok || !res.data) {
     console.error(`Error: ${res.error ?? "Failed to create test suite"}`);
-    process3.exit(1);
+    process4.exit(1);
   }
   if (jsonOutput) {
     writeRawOutput(JSON.stringify(res.data, null, 2));
@@ -1224,11 +1260,11 @@ async function handleSuiteUpdate(argv, apiUrl, token) {
   const arg = getPositionalArg(argv, SUITE_WRITE_FLAGS);
   if (!arg) {
     console.error("Usage: canary test-suite update <id|name> [options]");
-    process3.exit(1);
+    process4.exit(1);
   }
   if (hasAnyFlag(argv, EXTERNAL_CREATE_FLAGS)) {
     console.error("Error: --kind and --provider are create-only; a suite's engine cannot change.");
-    process3.exit(1);
+    process4.exit(1);
   }
   const suite = await resolveTestSuite(arg, apiUrl, token);
   const jsonOutput = hasFlag(argv, "--json");
@@ -1237,11 +1273,11 @@ async function handleSuiteUpdate(argv, apiUrl, token) {
   if (hasAnyFlag(argv, EXTERNAL_RUNNER_FLAGS)) {
     const detail = await fetchSuiteDetail(suite.id, apiUrl, token);
     if (detail.kind !== "external" || !detail.externalRunner) {
-      process3.stderr.write(
+      process4.stderr.write(
         `Error: "${detail.name}" is a native suite; runner flags (${EXTERNAL_RUNNER_FLAGS.join(", ")}) apply to external suites only.
 `
       );
-      process3.exit(1);
+      process4.exit(1);
     }
     runnerBodies = await buildExternalRunnerBodies(argv, detail.externalRunner, apiUrl, token);
   }
@@ -1249,7 +1285,7 @@ async function handleSuiteUpdate(argv, apiUrl, token) {
     console.error(
       `Error: No fields to update. Provide at least one of: --name, --description, --failure-mode, or a runner flag (${EXTERNAL_RUNNER_FLAGS.join(", ")})`
     );
-    process3.exit(1);
+    process4.exit(1);
   }
   const { runner, applied } = await applyExternalRunnerUpdate(suite.id, runnerBodies, apiUrl, token);
   let updated;
@@ -1257,11 +1293,11 @@ async function handleSuiteUpdate(argv, apiUrl, token) {
     const res = await apiRequest(apiUrl, token, "PATCH", `/test-suites/${suite.id}`, body);
     if (!res.ok || !res.data) {
       if (applied.length > 0) {
-        process3.stderr.write(`Already applied before this failure: ${applied.join(", ")}.
+        process4.stderr.write(`Already applied before this failure: ${applied.join(", ")}.
 `);
       }
       console.error(`Error: ${res.error ?? "Failed to update test suite"}`);
-      process3.exit(1);
+      process4.exit(1);
     }
     updated = res.data;
   }
@@ -1283,20 +1319,20 @@ async function handleSuiteDelete(argv, apiUrl, token) {
   const arg = getPositionalArg(argv, SUITE_WRITE_FLAGS);
   if (!arg) {
     console.error("Usage: canary test-suite delete <id|name> [--yes]");
-    process3.exit(1);
+    process4.exit(1);
   }
   const jsonOutput = hasFlag(argv, "--json");
   const suite = await resolveTestSuite(arg, apiUrl, token);
   if (!hasFlag(argv, "--yes")) {
-    process3.stderr.write(`Refusing to delete "${suite.name}" (${suite.id}) without --yes.
+    process4.stderr.write(`Refusing to delete "${suite.name}" (${suite.id}) without --yes.
 `);
     console.error("Automations and CLI runs pointing at this suite will fail once it is deleted.");
-    process3.exit(1);
+    process4.exit(1);
   }
   const res = await apiRequest(apiUrl, token, "DELETE", `/test-suites/${suite.id}`);
   if (!res.ok || !res.data) {
     console.error(`Error: ${res.error ?? "Failed to delete test suite"}`);
-    process3.exit(1);
+    process4.exit(1);
   }
   if (jsonOutput) {
     writeRawOutput(JSON.stringify(res.data, null, 2));
@@ -1308,7 +1344,7 @@ async function fetchSuiteDetail(id, apiUrl, token) {
   const res = await apiRequest(apiUrl, token, "GET", `/test-suites/${id}`);
   if (!res.ok || !res.data) {
     console.error(`Error: ${res.error ?? "Failed to load test suite"}`);
-    process3.exit(1);
+    process4.exit(1);
   }
   return res.data;
 }
@@ -1316,7 +1352,7 @@ async function handleSuiteMembers(argv, apiUrl, token) {
   const arg = getPositionalArg(argv, SUITE_WRITE_FLAGS);
   if (!arg) {
     console.error("Usage: canary test-suite members <id|name> [--json]");
-    process3.exit(1);
+    process4.exit(1);
   }
   const suite = await resolveTestSuite(arg, apiUrl, token);
   const detail = await fetchSuiteDetail(suite.id, apiUrl, token);
@@ -1354,7 +1390,7 @@ async function handleSuiteSetMembers(argv, apiUrl, token) {
   const arg = getPositionalArg(argv, SUITE_WRITE_FLAGS);
   if (!arg) {
     console.error("Usage: canary test-suite set-members <id|name> --layer <flow[,flow...]> [options]");
-    process3.exit(1);
+    process4.exit(1);
   }
   const layerArgs = getArgValues(argv, "--layer");
   const stagingArgs = getArgValues(argv, "--staging");
@@ -1362,7 +1398,7 @@ async function handleSuiteSetMembers(argv, apiUrl, token) {
     console.error(
       "Error: Nothing to set. Provide at least one --layer <flow[,flow...]> (repeatable) and/or --staging <flow[,flow...]>."
     );
-    process3.exit(1);
+    process4.exit(1);
   }
   const suite = await resolveTestSuite(arg, apiUrl, token);
   const jsonOutput = hasFlag(argv, "--json");
@@ -1370,12 +1406,12 @@ async function handleSuiteSetMembers(argv, apiUrl, token) {
   if (!confirmed) {
     const existing = await fetchSuiteDetail(suite.id, apiUrl, token);
     if (existing.members.length > 0) {
-      process3.stderr.write(
+      process4.stderr.write(
         `Refusing to replace ${existing.members.length} existing member(s) of "${suite.name}" (${suite.id}) without --yes.
 `
       );
       console.error("set-members is a FULL REPLACE \u2014 anything not listed is removed from the suite.");
-      process3.exit(1);
+      process4.exit(1);
     }
   }
   const cache = /* @__PURE__ */ new Map();
@@ -1401,7 +1437,7 @@ async function handleSuiteSetMembers(argv, apiUrl, token) {
   );
   if (!res.ok || !res.data) {
     console.error(`Error: ${res.error ?? "Failed to set suite members"}`);
-    process3.exit(1);
+    process4.exit(1);
   }
   if (jsonOutput) {
     writeRawOutput(JSON.stringify(res.data, null, 2));
@@ -1417,6 +1453,7 @@ function printTestSuiteHelp() {
       "Sub-commands:",
       "  run [options]                            Trigger a test suite and stream results",
       "  suites [--json]                          List named suite definitions",
+      "  suites get <id|name> [--json]            Inspect a named suite",
       "  executions [options]                     List recent test suite executions",
       "  list [options]                           (deprecated \u2014 will list suite definitions in future; use executions/suites)",
       "  get <executionId> [options]              Show one execution's runs",
@@ -1447,9 +1484,10 @@ function printTestSuiteHelp() {
       "  --application <name|id>  Target a specific application (alias: --property)",
       "  --environment <name|id>  Target a specific environment (required with --env-mode force)",
       "  --env-mode <mode>     mixed (default \u2014 each flow on its preferred env) | force (pin to --environment)",
-      "  --at <sha>            With --suite: run its Sandboxes v2 environments at this full 40-character",
-      "                        commit sha instead of the default branch head (the sha must exist in the",
-      "                        application's linked GitHub repository). The result shows the pinned commit.",
+      "  --at <sha|pushId|tag>  With --suite: pin its Sandboxes v2 environments to a commit SHA (GitHub)",
+      "                        or a push id or case-sensitive tag (pushed applications).",
+      "                        Mixed GitHub and pushed suites cannot be pinned with one --at.",
+      "                        The result shows Pinned at.",
       "                        A pinned run never feeds visual baselines.",
       "  --tag <tag>           Filter workflows by tag",
       "  --name-pattern <pat>  Filter workflows by name pattern",
@@ -1570,7 +1608,7 @@ async function runTestSuite(argv) {
       if (knownValueFlags.has(arg)) {
         if (!rest[index + 1] || rest[index + 1].startsWith("-")) {
           console.error(`Error: ${arg} requires a value.`);
-          process3.exit(1);
+          process4.exit(1);
         }
         index += 1;
         continue;
@@ -1578,17 +1616,17 @@ async function runTestSuite(argv) {
       if (/^--(?:api-url|env|org|token)=/.test(arg)) continue;
       if (arg.startsWith("-")) {
         console.error(`Error: Unknown validate option: ${arg}`);
-        process3.exit(1);
+        process4.exit(1);
       }
     }
     const [directory] = testSuitePositionals(rest);
     if (!directory) {
       console.error("Usage: cofactor test-suite validate <directory>");
-      process3.exit(1);
+      process4.exit(1);
     }
     if (testSuitePositionals(rest).length !== 1) {
       console.error("Error: validate accepts exactly one directory.");
-      process3.exit(1);
+      process4.exit(1);
     }
     await validateTestSuiteDirectory(directory, { json: hasFlag(rest, "--json") });
     return;
@@ -1605,7 +1643,11 @@ async function runTestSuite(argv) {
       await handleList(rest, apiUrl, token);
       break;
     case "suites":
-      await handleSuitesList(rest, apiUrl, token);
+      if (rest[0] === "get") {
+        await handleSuiteCatalogGet(rest.slice(1), apiUrl, token);
+      } else {
+        await handleSuitesList(rest, apiUrl, token);
+      }
       break;
     case "get":
       await handleGet(rest, apiUrl, token);
@@ -1640,7 +1682,7 @@ async function runTestSuite(argv) {
     default:
       console.error(`Unknown sub-command: ${subCommand}`);
       printTestSuiteHelp();
-      process3.exit(1);
+      process4.exit(1);
   }
 }
 export {
@@ -1650,4 +1692,4 @@ export {
   handleSuitesList,
   runTestSuite
 };
-//# sourceMappingURL=test-suite-CTACGIAZ.js.map
+//# sourceMappingURL=test-suite-SW25YGJV.js.map