@qawolf/cli 1.2.0 → 1.3.0

package/dist/cli.js

@@ -134044,7 +134044,7 @@ var require_snapshot_utils = __commonJS((exports, module) => {
 // node_modules/undici/lib/mock/snapshot-recorder.js
 var require_snapshot_recorder = __commonJS((exports, module) => {
   var { writeFile, readFile, mkdir } = __require("node:fs/promises");
-  var { dirname: dirname10, resolve: resolve9 } = __require("node:path");
+  var { dirname: dirname11, resolve: resolve9 } = __require("node:path");
   var { setTimeout: setTimeout3, clearTimeout: clearTimeout2 } = __require("node:timers");
   var { InvalidArgumentError: InvalidArgumentError3, UndiciError } = require_errors6();
   var { hashId, isUrlExcludedFactory, normalizeHeaders, createHeaderFilters } = require_snapshot_utils();
@@ -134239,7 +134239,7 @@ var require_snapshot_recorder = __commonJS((exports, module) => {
         throw new InvalidArgumentError3("Snapshot path is required");
       }
       const resolvedPath = resolve9(path4);
-      await mkdir(dirname10(resolvedPath), { recursive: true });
+      await mkdir(dirname11(resolvedPath), { recursive: true });
       const data2 = Array.from(this.#snapshots.entries()).map(([hash2, snapshot]) => ({
         hash: hash2,
         snapshot
@@ -155273,6 +155273,10 @@ var flowsMessages = {
   title: "Flows",
   remoteTitle: "Remote Flows",
   flowCount: (count) => pluralize(count, "flow"),
+  list: {
+    remoteRequiresEnv: "--remote requires --env <env> to pick the environment to list",
+    flagsRequireRemote: "--env and --include-drafts require --remote"
+  },
   pull: {
     downloadingBundle: "Downloading flows bundle",
     fetchingEnvVars: "Fetching environment variables",
@@ -170022,7 +170026,8 @@ async function validateApiKey(deps) {
 }
 // src/shell/logger.ts
 var import_pino = __toESM(require_pino(), 1);
-import { join as join4 } from "node:path";
+import { mkdirSync as mkdirSync2, openSync } from "node:fs";
+import { dirname, join as join4 } from "node:path";
 function defaultLogPath() {
   return join4(envPaths("qawolf", { suffix: "" }).log, "cli.log");
 }
@@ -170036,7 +170041,8 @@ function resolveStderrLevel(env2, verbose) {
 }
 function createLoggingSystem(opts) {
   const { stderrLevel, logPath } = opts;
-  const dest = import_pino.default.destination({ dest: logPath, mkdir: true, sync: false });
+  mkdirSync2(dirname(logPath), { recursive: true });
+  const dest = import_pino.default.destination({ fd: openSync(logPath, "a"), sync: false });
   const fileLogger = import_pino.default({ level: "debug" }, dest);
   const levelNums = {
     trace: 10,
@@ -171158,45 +171164,6 @@ async function getIdentity(apiKey, deps) {
   return { ok: true, data: parsed.data };
 }
 
-// src/shell/platform/getRemoteFlows.ts
-var remoteFlowSchema = exports_external.object({
-  executionTarget: exports_external.union([exports_external.string(), exports_external.record(exports_external.string(), exports_external.unknown())]),
-  id: exports_external.string(),
-  name: exports_external.string(),
-  path: exports_external.string(),
-  tags: exports_external.array(exports_external.string())
-});
-var remoteFlowsResponseSchema = exports_external.object({
-  flows: exports_external.array(remoteFlowSchema)
-});
-async function getRemoteFlows(apiKey, deps) {
-  const url2 = `${deps.baseUrl}/api/v0/flows?includeDrafts=false`;
-  let response;
-  try {
-    response = await deps.fetch(url2, {
-      headers: { Authorization: `Bearer ${apiKey}` },
-      signal: AbortSignal.timeout(15000)
-    });
-  } catch (error51) {
-    return { ok: false, error: { kind: "network", cause: toError(error51) } };
-  }
-  if (!response.ok) {
-    const body = await response.text().catch(() => "");
-    return {
-      ok: false,
-      error: { kind: "http", status: response.status, body }
-    };
-  }
-  const json2 = await response.json().catch(() => {
-    return;
-  });
-  const parsed = remoteFlowsResponseSchema.safeParse(json2);
-  if (!parsed.success) {
-    return { ok: false, error: { kind: "parse", cause: parsed.error } };
-  }
-  return { ok: true, data: parsed.data };
-}
-
 // src/shell/platform/types.ts
 var environmentListItemSchema = exports_external.object({
   envId: exports_external.string(),
@@ -171250,10 +171217,10 @@ async function listTeamStorageFiles(trpc, args, deps) {
 }
 
 // src/shell/platform/teamStorageAssets.ts
-import { dirname as dirname2, join as join8 } from "node:path";
+import { dirname as dirname3, join as join8 } from "node:path";
 
 // src/shell/platform/teamStorageAssetManifest.ts
-import { dirname } from "node:path";
+import { dirname as dirname2 } from "node:path";
 var assetManifestSchema = exports_external.object({
   version: exports_external.literal(1),
   files: exports_external.array(exports_external.object({
@@ -171297,7 +171264,7 @@ async function writeAssetManifest(assetsAbs, files, fs2) {
     }))
   };
   const path2 = assetManifestPath(assetsAbs);
-  await fs2.mkdir(dirname(path2), { recursive: true });
+  await fs2.mkdir(dirname2(path2), { recursive: true });
   await fs2.writeFile(path2, `${JSON.stringify(manifest, undefined, 2)}
 `);
 }
@@ -171463,7 +171430,7 @@ async function writeAssetSnapshot(args) {
   await args.deps.fs.mkdir(args.tmpAssets, { recursive: true });
   for (const { file: file2, relativePath } of args.safeFiles) {
     const dest = join8(args.tmpAssets, relativePath);
-    await args.deps.fs.mkdir(dirname2(dest), { recursive: true });
+    await args.deps.fs.mkdir(dirname3(dest), { recursive: true });
     if (args.reusable.has(relativePath)) {
       await args.deps.fs.copyFile(join8(args.assetsAbs, relativePath), dest);
       continue;
@@ -171502,14 +171469,6 @@ function createPlatformClient(apiKey, deps) {
         sleep: deps.sleep
       });
     },
-    async getRemoteFlows() {
-      return requestWithRetry({
-        call: () => getRemoteFlows(apiKey, deps),
-        backoffMs: requestBackoffMs2,
-        describe: (err) => describeRequestError(err, deps.baseUrl, "flows"),
-        sleep: deps.sleep
-      });
-    },
     getFlowsBundleUrl: getFlowsBundleUrlImpl,
     callPublicApi: makeCallPublicApiMethod(trpc, deps, requestBackoffMs2),
     async getEnvVars(envId) {
@@ -173630,7 +173589,7 @@ function registerAuthCommand(program2, signals) {
 // package.json
 var package_default = {
   name: "@qawolf/cli",
-  version: "1.2.0",
+  version: "1.3.0",
   description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   keywords: [
     "automation",
@@ -173690,7 +173649,7 @@ var package_default = {
     "@napi-rs/keyring": "1.3.0",
     "@oxc-node/core": "0.1.0",
     "@playwright/test": "1.60.0",
-    "@qawolf/api-contracts": "0.1.0",
+    "@qawolf/api-contracts": "0.2.0",
     "@qawolf/emails": "1.1.1",
     "@qawolf/flow-targets": "1.0.0",
     "@qawolf/flows": "0.1.1",
@@ -174217,13 +174176,13 @@ function renderResults(ui, results) {
 }
 
 // src/domains/flows/ensureDeps.ts
-import { dirname as dirname3, join as join10 } from "node:path";
+import { dirname as dirname4, join as join10 } from "node:path";
 function findEnvDir(flowPath, fs2) {
-  let dir = dirname3(flowPath);
+  let dir = dirname4(flowPath);
   while (true) {
     if (fs2.existsSync(join10(dir, "package.json")))
       return dir;
-    const parent = dirname3(dir);
+    const parent = dirname4(dir);
     if (parent === dir)
       return;
     dir = parent;
@@ -174256,7 +174215,7 @@ import { fileURLToPath } from "url";
 
 // node_modules/fdir/dist/index.mjs
 import { createRequire as createRequire2 } from "module";
-import { basename, dirname as dirname4, normalize as normalize2, relative as relative2, resolve, sep as sep3 } from "path";
+import { basename, dirname as dirname5, normalize as normalize2, relative as relative2, resolve, sep as sep3 } from "path";
 import * as nativeFs from "fs";
 var __require2 = /* @__PURE__ */ createRequire2(import.meta.url);
 function cleanPath(path2) {
@@ -174420,7 +174379,7 @@ function build$2(options, isSynchronous) {
 function isRecursive(path2, resolved, state) {
   if (state.options.useRealPaths)
     return isRecursiveUsingRealPaths(resolved, state);
-  let parent = dirname4(path2);
+  let parent = dirname5(path2);
   let depth = 1;
   while (parent !== state.root && depth < 2) {
     const resolvedPath = state.symlinks.get(parent);
@@ -174428,7 +174387,7 @@ function isRecursive(path2, resolved, state) {
     if (isSameRoot)
       depth++;
     else
-      parent = dirname4(parent);
+      parent = dirname5(parent);
   }
   state.symlinks.set(path2, resolved);
   return depth > 1;
@@ -174624,7 +174583,7 @@ var Walker = class {
           } else {
             resolvedPath = useRealPaths ? resolvedPath : path2;
             const filename = basename(resolvedPath);
-            const directoryPath$1 = normalizePath(dirname4(resolvedPath), this.state.options);
+            const directoryPath$1 = normalizePath(dirname5(resolvedPath), this.state.options);
             resolvedPath = this.joinPath(filename, directoryPath$1);
             this.pushFile(resolvedPath, files, this.state.counts, filters);
           }
@@ -175702,14 +175661,80 @@ function handleFlowsList(ctx, pattern) {
 
 // src/domains/flows/listRemote.ts
 var import_picomatch2 = __toESM(require_picomatch2(), 1);
-async function flowsListRemote(ctx, pattern) {
-  const result = await ctx.platform.getRemoteFlows();
+
+// node_modules/@qawolf/api-contracts/dist/v1/ids.js
+var defaultIdSchemas = {
+  environment: exports_external.string().min(1).describe("The id of the environment."),
+  flow: exports_external.string().min(1).describe("The id of the flow."),
+  run: exports_external.string().min(1).describe("The id of the run.")
+};
+
+// node_modules/@qawolf/api-contracts/dist/v1/flow/index.js
+var makeListFlowsContract = (ids) => {
+  const input = exports_external.object({
+    environmentId: ids.environment,
+    includeDrafts: exports_external.boolean().default(false).describe("Include draft flows in the listing.")
+  });
+  const executionTarget = exports_external.union([exports_external.string().min(1), exports_external.record(exports_external.string(), exports_external.unknown())]).describe("The target the flow executes against, as a preset or object.");
+  const output = exports_external.object({
+    flows: exports_external.array(exports_external.object({
+      executionTarget,
+      flowId: ids.flow,
+      name: exports_external.string(),
+      path: exports_external.string().describe("The flow file path, relative to the repo."),
+      tags: exports_external.array(exports_external.string())
+    }))
+  });
+  return {
+    description: "List the flows of an environment at its latest reconciled commit.",
+    input,
+    kind: "read",
+    name: "flow.list",
+    output
+  };
+};
+
+// node_modules/@qawolf/api-contracts/dist/v1/run/index.js
+var makeCreateRunContract = (ids) => {
+  const input = exports_external.object({
+    environmentId: ids.environment,
+    environmentVariables: exports_external.record(exports_external.string(), exports_external.string()).optional(),
+    flowIds: exports_external.array(ids.flow).min(1),
+    ignoreRules: exports_external.boolean().default(false)
+  });
+  const output = exports_external.object({ runId: ids.run });
+  return {
+    description: "Create a run for selected flows in an environment.",
+    input,
+    kind: "write",
+    name: "run.create",
+    output
+  };
+};
+
+// node_modules/@qawolf/api-contracts/dist/v1/index.js
+var makeContractsV1 = (ids) => ({
+  flow: {
+    list: makeListFlowsContract(ids)
+  },
+  run: {
+    create: makeCreateRunContract(ids)
+  }
+});
+var publicContractsV1 = makeContractsV1(defaultIdSchemas);
+
+// src/domains/flows/listRemote.ts
+async function flowsListRemote(ctx, pattern, options) {
+  const result = await ctx.platform.callPublicApi(publicContractsV1.flow.list, {
+    environmentId: options.env,
+    includeDrafts: options.includeDrafts
+  });
   if (!result.ok) {
     return { error: result.error };
   }
   const matches = pattern ? import_picomatch2.default(pattern) : undefined;
   const items = result.value.flows.filter((f2) => !matches || matches(f2.path)).map((f2) => ({
-    id: f2.id,
+    flowId: f2.flowId,
     file: f2.path,
     name: f2.name,
     tags: f2.tags,
@@ -175739,7 +175764,7 @@ async function flowsListRemote(ctx, pattern) {
 }
 
 // src/domains/flows/pull/handler.ts
-import { dirname as dirname6, join as join23, resolve as resolve7 } from "node:path";
+import { dirname as dirname7, join as join23, resolve as resolve7 } from "node:path";
 
 // src/shell/manifest/io.ts
 import { createHash as createHash2 } from "node:crypto";
@@ -176130,7 +176155,7 @@ async function writeEnvFile(envDir, vars, fs2 = makeDefaultFs()) {
 }
 
 // src/domains/flows/pull/extract.ts
-import { dirname as dirname5, resolve as resolve6 } from "node:path";
+import { dirname as dirname6, resolve as resolve6 } from "node:path";
 import { createGunzip } from "node:zlib";
 
 // node_modules/tar/dist/esm/index.min.js
@@ -179394,7 +179419,7 @@ async function handleEntry(args) {
     total: args.getTotal()
   });
   args.addTotal(size);
-  args.fs.mkdirSync(dirname5(target), { recursive: true });
+  args.fs.mkdirSync(dirname6(target), { recursive: true });
   const chunks = [];
   await new Promise((res, rej) => {
     entry.on("data", (chunk) => chunks.push(chunk));
@@ -179498,7 +179523,7 @@ async function handleFlowsPull(ctx, opts, deps) {
     return { error: validation.error };
   }
   const destAbs = resolve7(opts.out ?? join23(".qawolf", opts.env));
-  const assetsAbs = join23(dirname6(destAbs), "assets");
+  const assetsAbs = join23(dirname7(destAbs), "assets");
   await resolvedDeps.fs.mkdir(assetsAbs, { recursive: true });
   const yes = opts.yes ?? false;
   let archive;
@@ -180034,7 +180059,7 @@ async function defaultRunWebFlowDeps(cwd = process.cwd(), signals) {
 
 // src/domains/runtimeEnv/prepareRunDir.ts
 import { createHash as createHash3 } from "node:crypto";
-import { basename as basename4, dirname as dirname9, join as join28, resolve as resolve8, sep as sep4 } from "node:path";
+import { basename as basename4, dirname as dirname10, join as join28, resolve as resolve8, sep as sep4 } from "node:path";
 
 // src/shell/copyDir.ts
 import { cp, readdir as readdir2 } from "node:fs/promises";
@@ -180075,7 +180100,7 @@ async function readPackageJson(pkgPath, fs3) {
 }
 
 // src/domains/runtimeEnv/innerHop.ts
-import { dirname as dirname7, join as join26 } from "node:path";
+import { dirname as dirname8, join as join26 } from "node:path";
 
 // src/domains/runtimeEnv/symlinkDir.ts
 import { symlink } from "node:fs/promises";
@@ -180094,7 +180119,7 @@ async function populateInnerHop(args) {
     const segments = name.split("/");
     const target = join26(innerModules, ...segments);
     if (segments.length > 1) {
-      await fs3.mkdir(dirname7(target), { recursive: true });
+      await fs3.mkdir(dirname8(target), { recursive: true });
     }
     await createDirSymlink(join26(managedModules, ...segments), target);
   }
@@ -180102,7 +180127,7 @@ async function populateInnerHop(args) {
 
 // src/domains/runtimeEnv/outerHop.ts
 import { lstat } from "node:fs/promises";
-import { dirname as dirname8, join as join27 } from "node:path";
+import { dirname as dirname9, join as join27 } from "node:path";
 var executorPackageNames = new Set(pinnedPackages.map((p3) => p3.name));
 async function populateOuterHop(args) {
   const { projectDir, runDir, fs: fs3 } = args;
@@ -180133,7 +180158,7 @@ async function findSatisfyingNodeModulesDir(startDir, depNames, fs3) {
         return { satisfying: candidate, rejected };
       rejected.push({ dir: candidate, missing });
     }
-    const parent = dirname8(dir);
+    const parent = dirname9(dir);
     if (parent === dir)
       return { satisfying: undefined, rejected };
     dir = parent;
@@ -180221,7 +180246,7 @@ async function stageFlowFiles(args) {
   }
   if (files.length > 1) {
     return Promise.all(files.map(async (f3) => {
-      const dirHash = createHash3("sha256").update(dirname9(f3)).digest("hex").slice(0, 8);
+      const dirHash = createHash3("sha256").update(dirname10(f3)).digest("hex").slice(0, 8);
       const subDir = join28(execDir, dirHash);
       await fs3.mkdir(subDir, { recursive: true });
       const dest = join28(subDir, basename4(f3));
@@ -180834,12 +180859,12 @@ Install Android Studio and open Tools > SDK Manager.`);
 }
 
 // src/shell/manifest/lookup.ts
-import { basename as basename5, dirname as dirname10, relative as relative6 } from "node:path";
+import { basename as basename5, dirname as dirname11, relative as relative6 } from "node:path";
 async function findFlowStamp(flowAbsPath) {
   let envDir;
-  let current = dirname10(flowAbsPath);
-  while (current !== dirname10(current)) {
-    const parent2 = dirname10(current);
+  let current = dirname11(flowAbsPath);
+  while (current !== dirname11(current)) {
+    const parent2 = dirname11(current);
     if (basename5(parent2) === ".qawolf") {
       envDir = current;
       break;
@@ -181646,7 +181671,7 @@ async function runWebFlow({
 }
 
 // src/shell/embeddedWorkerCli.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
 import { basename as basename6, join as join32 } from "node:path";
 var embeddedCliPathEnv = "QAWOLF_EMBEDDED_CLI_PATH";
 function extractEmbeddedWorkerCli() {
@@ -181657,7 +181682,7 @@ function extractEmbeddedWorkerCli() {
   const dest = join32(dir, basename6(assetPath));
   if (existsSync3(dest))
     return dest;
-  mkdirSync2(dir, { recursive: true });
+  mkdirSync3(dir, { recursive: true });
   writeFileSync2(dest, readFileSync2(assetPath));
   return dest;
 }
@@ -181807,7 +181832,7 @@ function makePooledDispatch(resolvedDir) {
 }
 
 // src/commands/flows/buildRunReporter.ts
-import { dirname as dirname11 } from "node:path";
+import { dirname as dirname12 } from "node:path";
 
 // src/shell/reporter/createConsoleReporter.ts
 import { styleText as styleText3 } from "node:util";
@@ -182035,7 +182060,7 @@ function buildRunReporter(flags, deps) {
   const junit = createJUnitReporter({
     outputPath: resolveJUnitOutputPath(flags.junit, flags.outputDir),
     writeFile: (path9, content) => {
-      deps.fs.mkdirSync(dirname11(path9), { recursive: true });
+      deps.fs.mkdirSync(dirname12(path9), { recursive: true });
       deps.fs.writeFileSync(path9, content);
     },
     stderr
@@ -182321,8 +182346,8 @@ var listExamples = `
 Examples:
   $ qawolf flows list
   $ qawolf flows list "flows/checkout/**"
-  $ qawolf flows list --remote
-  $ qawolf flows list "**/checkout/**" --remote`;
+  $ qawolf flows list --remote --env staging
+  $ qawolf flows list "**/checkout/**" --remote --env staging --include-drafts`;
 var pullExamples = `
 Examples:
   $ qawolf flows pull --env staging
@@ -182334,9 +182359,23 @@ function registerFlowsCommand(program2, signals) {
   registerRunWorkerCommand(flows, signals);
   declareCommandKind(flows.command("list [pattern]"), "local", {
     kindNote: "read with --remote"
-  }).description("List flows matching [pattern] from the local project, or from QA Wolf with --remote").option("--remote", "List flows from the QA Wolf platform instead of the local project", false).addHelpText("after", listExamples).action((pattern, opts, command) => {
+  }).description("List flows matching [pattern] from the local project, or from a QA Wolf environment with --remote").option("--remote", "List flows from the QA Wolf platform instead of the local project", false).option("--env <env>", "Environment to list flows from (required with --remote)").option("--include-drafts", "Include draft flows in the listing (requires --remote)", false).addHelpText("after", listExamples).action((pattern, opts, command) => {
     if (opts.remote) {
-      return withAuthContext(signals, (ctx) => flowsListRemote(ctx, pattern))(opts, command);
+      const env3 = opts.env;
+      if (env3 === undefined) {
+        return withContext(signals, async () => ({
+          error: flowsMessages.list.remoteRequiresEnv
+        }))(opts, command);
+      }
+      return withAuthContext(signals, (ctx) => flowsListRemote(ctx, pattern, {
+        env: env3,
+        includeDrafts: opts.includeDrafts
+      }))(opts, command);
+    }
+    if (opts.env !== undefined || opts.includeDrafts) {
+      return withContext(signals, async () => ({
+        error: flowsMessages.list.flagsRequireRemote
+      }))(opts, command);
     }
     return withContext(signals, (ctx) => handleFlowsList(ctx, pattern))(opts, command);
   });
@@ -182346,7 +182385,7 @@ function registerFlowsCommand(program2, signals) {
 }
 
 // src/domains/init/init.ts
-import { dirname as dirname12, join as join36, relative as relative7 } from "node:path";
+import { dirname as dirname13, join as join36, relative as relative7 } from "node:path";
 
 // src/domains/init/templates.ts
 var qawolfConfigTs = `export default {
@@ -182405,7 +182444,7 @@ async function writeWithPrompt(ctx, filePath, content, yes, deps) {
       return;
     }
   }
-  await deps.fs.mkdir(dirname12(filePath), { recursive: true });
+  await deps.fs.mkdir(dirname13(filePath), { recursive: true });
   await deps.fs.writeFile(filePath, content);
   ctx.ui.step(initMessages.createdFile(relPath));
 }
@@ -182779,39 +182818,6 @@ Examples:
   });
 }
 
-// node_modules/@qawolf/api-contracts/dist/v1/ids.js
-var defaultIdSchemas = {
-  environment: exports_external.string().min(1).describe("The id of the environment."),
-  flow: exports_external.string().min(1).describe("The id of the flow."),
-  run: exports_external.string().min(1).describe("The id of the run.")
-};
-
-// node_modules/@qawolf/api-contracts/dist/v1/run/index.js
-var makeCreateRunContract = (ids) => {
-  const input = exports_external.object({
-    environmentId: ids.environment,
-    environmentVariables: exports_external.record(exports_external.string(), exports_external.string()).optional(),
-    flowIds: exports_external.array(ids.flow).min(1),
-    ignoreRules: exports_external.boolean().default(false)
-  });
-  const output = exports_external.object({ runId: ids.run });
-  return {
-    description: "Create a run for selected flows in an environment.",
-    input,
-    kind: "write",
-    name: "run.create",
-    output
-  };
-};
-
-// node_modules/@qawolf/api-contracts/dist/v1/index.js
-var makeContractsV1 = (ids) => ({
-  run: {
-    create: makeCreateRunContract(ids)
-  }
-});
-var publicContractsV1 = makeContractsV1(defaultIdSchemas);
-
 // src/core/publicApi/flagSpecs.ts
 var kebabCase = (field) => field.replace(/[A-Z]/g, (char) => `-${char.toLowerCase()}`);
 function flagKind(schema) {
@@ -182908,8 +182914,16 @@ function buildSpec(contract, path9) {
     contract
   };
 }
-function buildCommandSpecs(tree) {
-  const walk3 = (node2, path9) => Object.entries(node2).flatMap(([key, value]) => isContract(value) ? [buildSpec(value, [...path9, key])] : walk3(value, [...path9, key]));
+function buildCommandSpecs(tree, options = {}) {
+  const skip = options.skipContractNames;
+  const walk3 = (node2, path9) => Object.entries(node2).flatMap(([key, value]) => {
+    const childPath = [...path9, key];
+    if (!isContract(value))
+      return walk3(value, childPath);
+    if (skip?.has(childPath.join(".")))
+      return [];
+    return [buildSpec(value, childPath)];
+  });
   return walk3(tree, []);
 }
 
@@ -182980,6 +182994,7 @@ async function handlePublicApiCommand(ctx, spec, options) {
 var groupDescriptions = {
   run: "Trigger and manage QA Wolf runs on the platform"
 };
+var handWrittenContractNames = new Set(["flow.list"]);
 function resolveGroup(parent2, segment) {
   const existing = parent2.commands.find((command) => command.name() === segment);
   return existing ?? parent2.command(segment).description(groupDescriptions[segment] ?? `QA Wolf public API ${segment} commands`);
@@ -183005,7 +183020,9 @@ function registerSpec(program2, signals, spec, authDeps) {
   command.action((options, leaf) => withAuthContext(signals, (ctx) => handlePublicApiCommand(ctx, spec, options), authDeps ?? {})(options, leaf));
 }
 function registerPublicApiCommands(program2, signals, options = {}) {
-  const specs = buildCommandSpecs(options.contracts ?? publicContractsV1);
+  const specs = buildCommandSpecs(options.contracts ?? publicContractsV1, {
+    skipContractNames: handWrittenContractNames
+  });
   for (const spec of specs) {
     registerSpec(program2, signals, spec, options.authDeps);
   }
@@ -183046,4 +183063,4 @@ createProgram({ signals }).parseAsync().catch(() => {
     process.exitCode = 1;
 }).finally(() => flushAndExit(typeof process.exitCode === "number" ? process.exitCode : 0));
 
-//# debugId=2C8E0221ECEF946764756E2164756E21
+//# debugId=64AB4032821CC8E864756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qawolf/cli",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   "keywords": [
     "automation",
@@ -60,7 +60,7 @@
     "@napi-rs/keyring": "1.3.0",
     "@oxc-node/core": "0.1.0",
     "@playwright/test": "1.60.0",
-    "@qawolf/api-contracts": "0.1.0",
+    "@qawolf/api-contracts": "0.2.0",
     "@qawolf/emails": "1.1.1",
     "@qawolf/flow-targets": "1.0.0",
     "@qawolf/flows": "0.1.1",

package/skills/qawolf-cli/SKILL.md

@@ -41,7 +41,7 @@ write on timeout: it may have reached the server the first time.
 | `qawolf auth logout`      | local                      | Remove stored credentials                                                                                              |
 | `qawolf auth whoami`      | read                       | Show authentication status                                                                                             |
 | `qawolf doctor`           | local                      | Diagnose problems running flows locally                                                                                |
-| `qawolf flows list`       | local (read with --remote) | List flows matching [pattern] from the local project, or from QA Wolf with --remote                                    |
+| `qawolf flows list`       | local (read with --remote) | List flows matching [pattern] from the local project, or from a QA Wolf environment with --remote                      |
 | `qawolf flows pull`       | read                       | Download an environment's flows into the local .qawolf/<env>/ cache                                                    |
 | `qawolf flows run`        | local (read with --env)    | Run flows matching [pattern], or every flow when omitted; with --env, pull missing flows from that QA Wolf environment |
 | `qawolf init`             | local                      | Scaffold a QA Wolf project in the current directory                                                                    |