@qawolf/cli 1.19.2 → 1.20.1

package/dist/cli.js

@@ -8514,7 +8514,7 @@ var require_BufferList = __commonJS((exports, module) => {
       this.head = this.tail = null;
       this.length = 0;
     };
-    BufferList.prototype.join = function join36(s3) {
+    BufferList.prototype.join = function join38(s3) {
       if (this.length === 0)
         return "";
       var p3 = this.head;
@@ -20220,8 +20220,8 @@ var require_readdir_glob = __commonJS((exports, module) => {
         useStat = true;
       }
       const filename = dir + "/" + name;
-      const relative6 = filename.slice(1);
-      const absolute = path3 + "/" + relative6;
+      const relative8 = filename.slice(1);
+      const absolute = path3 + "/" + relative8;
       let stats = null;
       if (useStat || followSymlinks) {
         stats = await stat2(absolute, followSymlinks);
@@ -20233,12 +20233,12 @@ var require_readdir_glob = __commonJS((exports, module) => {
         stats = { isDirectory: () => false };
       }
       if (stats.isDirectory()) {
-        if (!shouldSkip(relative6)) {
-          yield { relative: relative6, absolute, stats };
+        if (!shouldSkip(relative8)) {
+          yield { relative: relative8, absolute, stats };
           yield* exploreWalkAsync(filename, path3, followSymlinks, useStat, shouldSkip, false);
         }
       } else {
-        yield { relative: relative6, absolute, stats };
+        yield { relative: relative8, absolute, stats };
       }
     }
   }
@@ -20303,11 +20303,11 @@ var require_readdir_glob = __commonJS((exports, module) => {
       }
       setTimeout(() => this._next(), 0);
     }
-    _shouldSkipDirectory(relative6) {
-      return this.skipMatchers.some((m4) => m4.match(relative6));
+    _shouldSkipDirectory(relative8) {
+      return this.skipMatchers.some((m4) => m4.match(relative8));
     }
-    _fileMatches(relative6, isDirectory) {
-      const file2 = relative6 + (isDirectory ? "/" : "");
+    _fileMatches(relative8, isDirectory) {
+      const file2 = relative8 + (isDirectory ? "/" : "");
       return (this.matchers.length === 0 || this.matchers.some((m4) => m4.match(file2))) && !this.ignoreMatchers.some((m4) => m4.match(file2)) && (!this.options.nodir || !isDirectory);
     }
     _next() {
@@ -20316,16 +20316,16 @@ var require_readdir_glob = __commonJS((exports, module) => {
           if (!obj.done) {
             const isDirectory = obj.value.stats.isDirectory();
             if (this._fileMatches(obj.value.relative, isDirectory)) {
-              let relative6 = obj.value.relative;
+              let relative8 = obj.value.relative;
               let absolute = obj.value.absolute;
               if (this.options.mark && isDirectory) {
-                relative6 += "/";
+                relative8 += "/";
                 absolute += "/";
               }
               if (this.options.stat) {
-                this.emit("match", { relative: relative6, absolute, stat: obj.value.stats });
+                this.emit("match", { relative: relative8, absolute, stat: obj.value.stats });
               } else {
-                this.emit("match", { relative: relative6, absolute });
+                this.emit("match", { relative: relative8, absolute });
               }
             }
             this._next(this.iterator);
@@ -23182,7 +23182,7 @@ var require_BufferList2 = __commonJS((exports, module) => {
       this.head = this.tail = null;
       this.length = 0;
     };
-    BufferList.prototype.join = function join36(s3) {
+    BufferList.prototype.join = function join38(s3) {
       if (this.length === 0)
         return "";
       var p3 = this.head;
@@ -36236,7 +36236,7 @@ var require_commonjs4 = __commonJS((exports) => {
   var TYPEMASK = 1023;
   var entToType = (s3) => s3.isFile() ? IFREG : s3.isDirectory() ? IFDIR : s3.isSymbolicLink() ? IFLNK : s3.isCharacterDevice() ? IFCHR : s3.isBlockDevice() ? IFBLK : s3.isSocket() ? IFSOCK : s3.isFIFO() ? IFIFO : UNKNOWN;
   var normalizeCache = new Map;
-  var normalize3 = (s3) => {
+  var normalize4 = (s3) => {
     const c3 = normalizeCache.get(s3);
     if (c3)
       return c3;
@@ -36249,7 +36249,7 @@ var require_commonjs4 = __commonJS((exports) => {
     const c3 = normalizeNocaseCache.get(s3);
     if (c3)
       return c3;
-    const n2 = normalize3(s3.toLowerCase());
+    const n2 = normalize4(s3.toLowerCase());
     normalizeNocaseCache.set(s3, n2);
     return n2;
   };
@@ -36370,7 +36370,7 @@ var require_commonjs4 = __commonJS((exports) => {
     }
     constructor(name, type = UNKNOWN, root, roots, nocase, children, opts) {
       this.name = name;
-      this.#matchName = nocase ? normalizeNocase(name) : normalize3(name);
+      this.#matchName = nocase ? normalizeNocase(name) : normalize4(name);
       this.#type = type & TYPEMASK;
       this.nocase = nocase;
       this.roots = roots;
@@ -36431,7 +36431,7 @@ var require_commonjs4 = __commonJS((exports) => {
         return this.parent || this;
       }
       const children = this.children();
-      const name = this.nocase ? normalizeNocase(pathPart) : normalize3(pathPart);
+      const name = this.nocase ? normalizeNocase(pathPart) : normalize4(pathPart);
       for (const p3 of children) {
         if (p3.#matchName === name) {
           return p3;
@@ -36568,7 +36568,7 @@ var require_commonjs4 = __commonJS((exports) => {
       return !!(this.#type & ENOENT);
     }
     isNamed(n2) {
-      return !this.nocase ? this.#matchName === normalize3(n2) : this.#matchName === normalizeNocase(n2);
+      return !this.nocase ? this.#matchName === normalize4(n2) : this.#matchName === normalizeNocase(n2);
     }
     async readlink() {
       const target = this.#linkTarget;
@@ -36695,7 +36695,7 @@ var require_commonjs4 = __commonJS((exports) => {
     #readdirMaybePromoteChild(e, c3) {
       for (let p3 = c3.provisional;p3 < c3.length; p3++) {
         const pchild = c3[p3];
-        const name = this.nocase ? normalizeNocase(e.name) : normalize3(e.name);
+        const name = this.nocase ? normalizeNocase(e.name) : normalize4(e.name);
         if (name !== pchild.#matchName) {
           continue;
         }
@@ -37688,10 +37688,10 @@ var require_ignore = __commonJS((exports) => {
     ignored(p3) {
       const fullpath = p3.fullpath();
       const fullpaths = `${fullpath}/`;
-      const relative6 = p3.relative() || ".";
-      const relatives = `${relative6}/`;
+      const relative8 = p3.relative() || ".";
+      const relatives = `${relative8}/`;
       for (const m4 of this.relative) {
-        if (m4.match(relative6) || m4.match(relatives))
+        if (m4.match(relative8) || m4.match(relatives))
           return true;
       }
       for (const m4 of this.absolute) {
@@ -37702,9 +37702,9 @@ var require_ignore = __commonJS((exports) => {
     }
     childrenIgnored(p3) {
       const fullpath = p3.fullpath() + "/";
-      const relative6 = (p3.relative() || ".") + "/";
+      const relative8 = (p3.relative() || ".") + "/";
       for (const m4 of this.relativeChildren) {
-        if (m4.match(relative6))
+        if (m4.match(relative8))
           return true;
       }
       for (const m4 of this.absoluteChildren) {
@@ -101117,10 +101117,10 @@ function compareDocumentPosition(nodeA, nodeB) {
 function uniqueSort(nodes) {
   nodes = nodes.filter((node2, i2, arr) => !arr.includes(node2, i2 + 1));
   nodes.sort((a3, b4) => {
-    const relative6 = compareDocumentPosition(a3, b4);
-    if (relative6 & DocumentPosition.PRECEDING) {
+    const relative8 = compareDocumentPosition(a3, b4);
+    if (relative8 & DocumentPosition.PRECEDING) {
       return -1;
-    } else if (relative6 & DocumentPosition.FOLLOWING) {
+    } else if (relative8 & DocumentPosition.FOLLOWING) {
       return 1;
     }
     return 0;
@@ -134710,7 +134710,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: dirname12, resolve: resolve10 } = __require("node:path");
+  var { dirname: dirname13, resolve: resolve10 } = __require("node:path");
   var { setTimeout: setTimeout3, clearTimeout: clearTimeout2 } = __require("node:timers");
   var { InvalidArgumentError: InvalidArgumentError3, UndiciError } = require_errors7();
   var { hashId, isUrlExcludedFactory, normalizeHeaders, createHeaderFilters } = require_snapshot_utils();
@@ -134905,7 +134905,7 @@ var require_snapshot_recorder = __commonJS((exports, module) => {
         throw new InvalidArgumentError3("Snapshot path is required");
       }
       const resolvedPath = resolve10(path4);
-      await mkdir(dirname12(resolvedPath), { recursive: true });
+      await mkdir(dirname13(resolvedPath), { recursive: true });
       const data2 = Array.from(this.#snapshots.entries()).map(([hash2, snapshot]) => ({
         hash: hash2,
         snapshot
@@ -160719,11 +160719,11 @@ m2: ${this.mapper2.__debugToString().split(`
           return height2 + 1;
         }
         function computeColumnWidths(height2) {
-          const columns2 = fill(Array(height2), 0);
+          const columns = fill(Array(height2), 0);
           for (const node2 of nodes) {
-            columns2[node2.level] = Math.max(columns2[node2.level], node2.text.length);
+            columns[node2.level] = Math.max(columns[node2.level], node2.text.length);
           }
-          return columns2;
+          return columns;
         }
         function computeLanes(node2, lane) {
           if (node2.lane === -1) {
@@ -165092,11 +165092,11 @@ ${lanes.join(`
         return toComponents;
       }
       const components = toComponents.slice(start);
-      const relative8 = [];
+      const relative10 = [];
       for (;start < fromComponents.length; start++) {
-        relative8.push("..");
+        relative10.push("..");
       }
-      return ["", ...relative8, ...components];
+      return ["", ...relative10, ...components];
     }
     function getRelativePathFromDirectory(fromDirectory, to2, getCanonicalFileNameOrIgnoreCase) {
       Debug.assert(getRootLength(fromDirectory) > 0 === getRootLength(to2) > 0, "Paths must either both be absolute or both be relative");
@@ -202471,9 +202471,9 @@ ${lanes.join(`
           if (!startsWithDirectory(target, realPathDirectory, getCanonicalFileName)) {
             return;
           }
-          const relative8 = getRelativePathFromDirectory(realPathDirectory, target, getCanonicalFileName);
+          const relative10 = getRelativePathFromDirectory(realPathDirectory, target, getCanonicalFileName);
           for (const symlinkDirectory of symlinkDirectories) {
-            const option = resolvePath(symlinkDirectory, relative8);
+            const option = resolvePath(symlinkDirectory, relative10);
             const result2 = cb(option, target === referenceRedirect);
             shouldFilterIgnoredPaths = true;
             if (result2)
@@ -264788,10 +264788,10 @@ ${lanes.join(`
       }
       function getDefaultLibFilePriority(a3) {
         if (containsPath(defaultLibraryPath, a3.fileName, false)) {
-          const basename7 = getBaseFileName(a3.fileName);
-          if (basename7 === "lib.d.ts" || basename7 === "lib.es6.d.ts")
+          const basename8 = getBaseFileName(a3.fileName);
+          if (basename8 === "lib.d.ts" || basename8 === "lib.es6.d.ts")
             return 0;
-          const name = removeSuffix(removePrefix(basename7, "lib."), ".d.ts");
+          const name = removeSuffix(removePrefix(basename8, "lib."), ".d.ts");
           const index2 = libs.indexOf(name);
           if (index2 !== -1)
             return index2 + 1;
@@ -317475,8 +317475,8 @@ ${options.prefix}` : `
           }
         };
         for (const file2 of files) {
-          const basename7 = getBaseFileName(file2);
-          if (basename7 === "package.json" || basename7 === "bower.json") {
+          const basename8 = getBaseFileName(file2);
+          if (basename8 === "package.json" || basename8 === "bower.json") {
             createProjectWatcher(file2, "FileWatcher");
             continue;
           }
@@ -320363,8 +320363,8 @@ All files are: ${JSON.stringify(names)}`, "Err");
           const fileOrDirectoryPath = removeIgnoredPath(this.toPath(fileOrDirectory));
           if (!fileOrDirectoryPath)
             return;
-          const basename7 = getBaseFileName(fileOrDirectoryPath);
-          if (((_a6 = result.affectedModuleSpecifierCacheProjects) == null ? undefined : _a6.size) && (basename7 === "package.json" || basename7 === "node_modules")) {
+          const basename8 = getBaseFileName(fileOrDirectoryPath);
+          if (((_a6 = result.affectedModuleSpecifierCacheProjects) == null ? undefined : _a6.size) && (basename8 === "package.json" || basename8 === "node_modules")) {
             result.affectedModuleSpecifierCacheProjects.forEach((project) => {
               var _a22;
               (_a22 = project.getModuleSpecifierCache()) == null || _a22.clear();
@@ -325953,6 +325953,7 @@ var environmentsMessages = {
   resolvedAlias: (ref, id) => `Environment ${ref} resolved to ${id}.`,
   couldNotResolve: (ref, detail) => `Could not resolve environment ${ref}: ${detail} If ${ref} is an alias, note that aliases require a team API key.`,
   aborted: "Aborted; no environment selected.",
+  usingPulledEnv: (env) => `Could not reach the platform to resolve environment ${env}; using the copy pulled into .qawolf/${env}.`,
   tooManyPages: (pages) => `Stopped listing environments after ${pages} pages. Pass --env explicitly.`
 };
 // src/core/pluralize.ts
@@ -325967,7 +325968,23 @@ var flowsMessages = {
   flowCount: (count) => pluralize(count, "flow"),
   list: {
     remoteRequiresEnv: "--remote requires an environment. Pass --env <env> or set QAWOLF_ENVIRONMENT.",
-    flagsRequireRemote: "--env and --include-drafts require --remote"
+    draftsRequireRemote: "--include-drafts requires --remote"
+  },
+  selectors: {
+    tagsNotCached: "No cached tags found. Run 'qawolf flows pull --env <env>' to cache them, or pass --remote to read tags from the platform.",
+    tagsUnavailable: (env) => `Could not reach the platform and no tags are cached for environment '${env}'. Run 'qawolf flows pull --env ${env}' while online.`,
+    usingCachedTags: (fetchedAt) => `Could not reach the platform. Using tags cached at ${fetchedAt}; tag names were not validated.`,
+    unknownTag: (name, suggestion) => suggestion === undefined ? `No tag named '${name}' on this team. Run 'qawolf tag list' to see available tags.` : `No tag named '${name}' on this team. Did you mean '${suggestion}'?`,
+    unknownPulledEnv: (name, pulled, suggestion) => {
+      const known = pulled.length === 0 ? "No environments have been pulled yet." : `Pulled environments: ${pulled.join(", ")}.`;
+      const hint = suggestion === undefined ? "" : ` Did you mean '${suggestion}'?`;
+      return `No pulled environment named '${name}'.${hint} ${known}`;
+    },
+    allEnvsWithEnv: "--all-envs has no effect with --env: the run is already scoped to that environment.",
+    allEnvsWithoutTag: "--all-envs has no effect without --tag: a pattern run already includes every environment.",
+    chooseEnv: "Which environment should these flows run against?",
+    ambiguousEnvs: (labels) => `The selection matches flows in several pulled environments: ${labels.join(", ")}. Pass --env <name> to choose one, or --all-envs to run every match.`,
+    noFlowsSelected: (selectors) => `No flows matched tags ${selectors.tags.join(", ")}.`
   },
   run: {
     requiresEnv: "An environment is required. Pass --env <env> or set QAWOLF_ENVIRONMENT."
@@ -325976,6 +325993,7 @@ var flowsMessages = {
     requiresEnv: "An environment is required. Pass --env <env> or set QAWOLF_ENVIRONMENT.",
     downloadingBundle: "Downloading flows bundle",
     fetchingEnvVars: "Fetching environment variables",
+    fetchingTags: "Fetching flow tags",
     downloadComplete: "Downloaded flows bundle and environment variables",
     needsYesError: "Re-run with --yes to overwrite locally-modified files",
     aborted: "Aborted; no changes.",
@@ -341138,10 +341156,12 @@ async function requestWithRetry(args) {
     const retryable = result.error.kind === "network" || result.error.kind === "timeout";
     if (backoff === undefined || !retryable) {
       const mayHaveArrived = result.error.kind !== "http";
+      const unreachable = result.error.kind === "network" || result.error.kind === "timeout";
       return {
         ok: false,
         ...args.describe(result.error),
-        ...mayHaveArrived ? { mayHaveArrived } : {}
+        ...mayHaveArrived ? { mayHaveArrived } : {},
+        ...unreachable ? { unreachable } : {}
       };
     }
     await sleep2(backoff);
@@ -346136,7 +346156,7 @@ function startUpdateCheck(deps) {
 // package.json
 var package_default = {
   name: "@qawolf/cli",
-  version: "1.19.2",
+  version: "1.20.1",
   description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   keywords: [
     "automation",
@@ -348625,9 +348645,280 @@ Examples:
   });
 }
 
+// src/domains/runner/runFlagParsers.ts
+function parseInteger(name, options = {}) {
+  return (value) => {
+    const n2 = Number.parseInt(value, 10);
+    if (!Number.isFinite(n2) || String(n2) !== value) {
+      throw new InvalidArgumentError(`${name} must be an integer`);
+    }
+    if (options.min !== undefined && n2 < options.min) {
+      throw new InvalidArgumentError(`${name} must be >= ${options.min}`);
+    }
+    return n2;
+  };
+}
+function parseEnum(name, values) {
+  return (value) => {
+    if (!values.includes(value)) {
+      throw new InvalidArgumentError(`${name} must be one of: ${values.join(", ")}`);
+    }
+    return value;
+  };
+}
+function collectValue(value, previous) {
+  return [...previous, value];
+}
+
+// src/shell/manifest/pulledEnv.ts
+import { join as join22 } from "node:path";
+
+// src/shell/manifest/io.ts
+import { createHash as createHash2 } from "node:crypto";
+import { join as join21 } from "node:path";
+var manifestFilename = ".manifest.json";
+var flowEntrySchema = exports_external.object({
+  path: exports_external.string(),
+  contentHash: exports_external.string(),
+  tags: exports_external.array(exports_external.string()).optional()
+});
+var manifestSchema = exports_external.object({
+  envId: exports_external.string(),
+  envSlug: exports_external.string().optional(),
+  envName: exports_external.string().optional(),
+  fetchedAt: exports_external.string(),
+  envVarsFetchedAt: exports_external.string().optional(),
+  cliFlowsVersion: exports_external.string(),
+  qawolfCommitSha: exports_external.string().optional(),
+  qawolfCommittedAt: exports_external.string().optional(),
+  tagsFetchedAt: exports_external.string().optional(),
+  flows: exports_external.array(flowEntrySchema)
+});
+async function readManifest(envDir, fs3 = makeDefaultFs()) {
+  let raw;
+  try {
+    raw = await fs3.readFile(join21(envDir, manifestFilename));
+  } catch (err) {
+    if (isNoEntError(err))
+      return "missing";
+    throw err;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return "malformed";
+  }
+  const result = manifestSchema.safeParse(parsed);
+  if (!result.success)
+    return "malformed";
+  return {
+    envId: result.data.envId,
+    envSlug: result.data.envSlug,
+    envName: result.data.envName,
+    fetchedAt: result.data.fetchedAt,
+    envVarsFetchedAt: result.data.envVarsFetchedAt,
+    cliFlowsVersion: result.data.cliFlowsVersion,
+    qawolfCommitSha: result.data.qawolfCommitSha,
+    qawolfCommittedAt: result.data.qawolfCommittedAt,
+    tagsFetchedAt: result.data.tagsFetchedAt,
+    flows: result.data.flows.map((flow) => ({
+      path: flow.path,
+      contentHash: flow.contentHash,
+      tags: flow.tags
+    }))
+  };
+}
+async function writeManifest(envDir, manifest, fs3 = makeDefaultFs()) {
+  const body = JSON.stringify(manifest, undefined, 2);
+  await fs3.writeFile(join21(envDir, manifestFilename), `${body}
+`);
+}
+function hashFile(absPath, fs3 = makeDefaultFs()) {
+  return new Promise((resolve5, reject) => {
+    const hash2 = createHash2("sha256");
+    const stream = fs3.createReadStream(absPath);
+    stream.on("data", (chunk) => hash2.update(chunk));
+    stream.on("end", () => resolve5(hash2.digest("hex")));
+    stream.on("error", reject);
+  });
+}
+
+// src/shell/manifest/pulledEnv.ts
+async function findPulledEnv(ref, cwd, fs3 = makeDefaultFs()) {
+  for (const envDir of await listPulledEnvDirs(cwd, fs3)) {
+    const manifest = await readManifest(envDir, fs3);
+    if (typeof manifest === "string")
+      continue;
+    if (manifest.envId === ref || manifest.envSlug === ref || manifest.envName === ref) {
+      return { dir: envDir, envId: manifest.envId };
+    }
+  }
+  return;
+}
+async function listPulledEnvDirs(cwd, fs3 = makeDefaultFs()) {
+  const root = join22(cwd, ".qawolf");
+  let entries;
+  try {
+    entries = await fs3.readdirWithTypes(root);
+  } catch (err) {
+    if (isNoEntError(err))
+      return [];
+    throw err;
+  }
+  const dirs = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory())
+      continue;
+    const envDir = join22(root, entry.name);
+    const manifest = await readManifest(envDir, fs3);
+    if (typeof manifest === "string")
+      continue;
+    dirs.push(envDir);
+  }
+  return dirs;
+}
+
 // src/domains/flows/list.ts
 import path2 from "node:path";
 
+// src/core/flowSelectors.ts
+function hasSelectors(selectors) {
+  return selectors.tags.length > 0;
+}
+function matchesSelectors(flow, selectors) {
+  if (selectors.tags.length === 0)
+    return true;
+  return selectors.tags.some((tag) => flow.tags?.includes(tag));
+}
+
+// src/core/repoRelativePath.ts
+import { basename as basename3, dirname as dirname6, relative as relative3 } from "node:path";
+var toPosix = (path2) => path2.replaceAll("\\", "/");
+function findPulledEnvDir(flowAbsPath) {
+  let current = dirname6(flowAbsPath);
+  while (current !== dirname6(current)) {
+    const parent = dirname6(current);
+    if (basename3(parent) === ".qawolf")
+      return current;
+    current = parent;
+  }
+  return;
+}
+function toRepoRelativePath(flowAbsPath, cwd) {
+  const envDir = findPulledEnvDir(flowAbsPath);
+  return toPosix(relative3(envDir ?? cwd, flowAbsPath));
+}
+
+// src/domains/flows/envLabels.ts
+function envLabelFor(file2, labels) {
+  const dir = findPulledEnvDir(file2);
+  return dir === undefined ? undefined : labels.get(dir);
+}
+async function readEnvLabels(files, readEnvLabel) {
+  const dirs = new Set(files.map(findPulledEnvDir).filter((dir) => dir !== undefined));
+  const labels = new Map;
+  for (const dir of dirs)
+    labels.set(dir, await readEnvLabel(dir));
+  return labels;
+}
+
+// src/core/suggestNearMiss.ts
+function normalize3(value) {
+  return value.toLowerCase().replace(/[-_\s]+/g, " ").trim();
+}
+function editDistance(a2, b2) {
+  let row = Array.from({ length: b2.length + 1 }, (_3, j) => j);
+  for (let i2 = 1;i2 <= a2.length; i2 += 1) {
+    const next = [i2];
+    for (let j = 1;j <= b2.length; j += 1) {
+      const substitution = (row[j - 1] ?? 0) + (a2[i2 - 1] === b2[j - 1] ? 0 : 1);
+      const deletion = (row[j] ?? 0) + 1;
+      const insertion = (next[j - 1] ?? 0) + 1;
+      next.push(Math.min(substitution, deletion, insertion));
+    }
+    row = next;
+  }
+  return row[b2.length] ?? 0;
+}
+function distanceBudget(length) {
+  return length >= 4 ? 2 : 1;
+}
+function suggestNearMiss(input, candidates) {
+  if (candidates.includes(input))
+    return;
+  const sorted = [...candidates].sort();
+  const normalizedInput = normalize3(input);
+  const presentationMatch = sorted.find((candidate) => normalize3(candidate) === normalizedInput);
+  if (presentationMatch !== undefined)
+    return presentationMatch;
+  let best;
+  let bestDistance = Number.POSITIVE_INFINITY;
+  for (const candidate of sorted) {
+    const distance = editDistance(normalizedInput, normalize3(candidate));
+    if (distance < bestDistance) {
+      bestDistance = distance;
+      best = candidate;
+    }
+  }
+  return bestDistance <= distanceBudget(normalizedInput.length) ? best : undefined;
+}
+
+// src/domains/flows/selectPulledEnv.ts
+async function selectPulledEnv(args) {
+  const found = await args.findPulledEnv(args.ref);
+  if (found !== undefined) {
+    return {
+      kind: "selected",
+      files: args.files.filter((file2) => findPulledEnvDir(file2) === found.dir)
+    };
+  }
+  const dirs = await args.listPulledEnvDirs();
+  const labels = (await Promise.all(dirs.map((dir) => args.readEnvLabel(dir)))).sort();
+  return {
+    kind: "unknown",
+    result: {
+      error: flowsMessages.selectors.unknownPulledEnv(args.ref, labels, suggestNearMiss(args.ref, labels)),
+      exitCode: exitCodes.invalidArgs
+    }
+  };
+}
+
+// src/domains/flows/explainEmptySelection.ts
+function explainEmptySelection(selectors, knownTags) {
+  if (knownTags !== undefined) {
+    const unknownTag = selectors.tags.find((tag) => !knownTags.includes(tag));
+    if (unknownTag !== undefined) {
+      return flowsMessages.selectors.unknownTag(unknownTag, suggestNearMiss(unknownTag, knownTags));
+    }
+  }
+  return flowsMessages.selectors.noFlowsSelected(selectors);
+}
+
+// src/domains/flows/selectorGuards.ts
+function tagsNotCachedResult(selectors, cachedTags) {
+  if (!hasSelectors(selectors) || cachedTags.size > 0)
+    return;
+  return {
+    error: flowsMessages.selectors.tagsNotCached,
+    exitCode: exitCodes.network
+  };
+}
+function tagsUnavailableResult(envId) {
+  return {
+    error: flowsMessages.selectors.tagsUnavailable(envId),
+    exitCode: exitCodes.network
+  };
+}
+async function emptySelectionResult(selectors, matched, fetchKnownTags) {
+  if (matched > 0 || !hasSelectors(selectors))
+    return;
+  return {
+    error: explainEmptySelection(selectors, await fetchKnownTags?.()),
+    exitCode: exitCodes.invalidArgs
+  };
+}
+
 // src/core/renderTable.ts
 var ansiBold = "\x1B[1m";
 var ansiReset = "\x1B[0m";
@@ -348648,29 +348939,75 @@ function renderTable(options) {
 }
 
 // src/domains/flows/renderListTable.ts
-var columns = [
-  { header: "name", value: (row) => row.name },
-  { header: "target", value: (row) => row.target },
-  { header: "file", value: (row) => row.file }
-];
+var nameColumn = {
+  header: "name",
+  value: (row) => row.name
+};
+var targetColumn = {
+  header: "target",
+  value: (row) => row.target
+};
+var envColumn = {
+  header: "env",
+  value: (row) => row.env ?? ""
+};
+var tagsColumn = {
+  header: "tags",
+  value: (row) => (row.tags ?? []).join(", ")
+};
+var fileColumn = {
+  header: "file",
+  value: (row) => row.file
+};
 function renderListTable(rows, boldHeader) {
+  const someTagged = rows.some((row) => (row.tags ?? []).length > 0);
+  const severalEnvs = new Set(rows.map((row) => row.env)).size > 1;
+  const columns = [
+    nameColumn,
+    targetColumn,
+    ...severalEnvs ? [envColumn] : [],
+    ...someTagged ? [tagsColumn] : [],
+    fileColumn
+  ];
   return renderTable({ boldHeader, columns, rows });
 }
 
 // src/domains/flows/list.ts
-async function flowsList(ctx, pattern, deps) {
+async function flowsList(ctx, pattern, deps, selectors = { tags: [] }) {
   const patterns = pattern ? [pattern] : [];
-  const files = await deps.expandPatterns(patterns, deps.cwd);
-  const items = [];
+  let files = await deps.expandPatterns(patterns, deps.cwd);
+  if (selectors.env !== undefined) {
+    const selection = await selectPulledEnv({
+      files,
+      ref: selectors.env,
+      findPulledEnv: deps.findPulledEnv,
+      listPulledEnvDirs: deps.listPulledEnvDirs,
+      readEnvLabel: deps.readEnvLabel
+    });
+    if (selection.kind === "unknown")
+      return selection.result;
+    files = selection.files;
+  }
+  const cachedTags = await deps.readCachedTags(files);
+  const envLabels = await readEnvLabels(files, deps.readEnvLabel);
+  const notCached = tagsNotCachedResult(selectors, cachedTags);
+  if (notCached !== undefined)
+    return notCached;
+  const all = [];
   for await (const { file: file2, ...meta3 } of batchMap(files, async (f2) => ({ file: f2, ...await deps.peekFlowMeta(f2) }), flowBatchSize)) {
-    items.push({
+    all.push({
       file: path2.relative(deps.cwd, file2),
       name: meta3.name ?? flowBasename(file2),
-      tags: [],
+      env: envLabelFor(file2, envLabels),
+      tags: cachedTags.get(file2),
       target: meta3.target,
       browser: meta3.target ? targetToBrowser(meta3.target) : undefined
     });
   }
+  const items = all.filter((item) => matchesSelectors(item, selectors));
+  const empty2 = await emptySelectionResult(selectors, items.length, undefined);
+  if (empty2 !== undefined)
+    return empty2;
   if (ctx.ui.mode === "json") {
     ctx.ui.json(items);
     return;
@@ -348682,6 +349019,8 @@ async function flowsList(ctx, pattern, deps) {
   const rows = items.map((it) => ({
     name: it.name,
     target: it.target ?? "",
+    env: it.env,
+    tags: it.tags,
     file: it.file
   }));
   if (ctx.ui.mode === "agent") {
@@ -348693,17 +349032,91 @@ async function flowsList(ctx, pattern, deps) {
   ctx.ui.write(renderListTable(rows, true));
   ctx.ui.outro(flowsMessages.flowCount(items.length));
 }
-function handleFlowsList(ctx, pattern) {
+
+// src/domains/flows/readCachedTags.ts
+import { relative as relative4 } from "node:path";
+async function readCachedTags(files, fs3 = makeDefaultFs()) {
+  const filesByEnvDir = new Map;
+  for (const file2 of files) {
+    const envDir = findPulledEnvDir(file2);
+    if (envDir === undefined)
+      continue;
+    const group = filesByEnvDir.get(envDir);
+    if (group)
+      group.push(file2);
+    else
+      filesByEnvDir.set(envDir, [file2]);
+  }
+  const tagsByFile = new Map;
+  for (const [envDir, envFiles] of filesByEnvDir) {
+    const manifest = await readManifest(envDir, fs3);
+    if (typeof manifest === "string")
+      continue;
+    if (manifest.tagsFetchedAt === undefined)
+      continue;
+    const entryByPath = new Map(manifest.flows.map((f2) => [toPosix(f2.path), f2]));
+    for (const file2 of envFiles) {
+      const tags = entryByPath.get(toPosix(relative4(envDir, file2)))?.tags;
+      if (tags !== undefined)
+        tagsByFile.set(file2, tags);
+    }
+  }
+  return tagsByFile;
+}
+
+// src/domains/flows/readEnvLabel.ts
+import { basename as basename4 } from "node:path";
+async function readEnvLabel(envDir, fs3 = makeDefaultFs()) {
+  const manifest = await readManifest(envDir, fs3);
+  if (typeof manifest === "string")
+    return basename4(envDir);
+  return manifest.envSlug ?? manifest.envName ?? basename4(envDir);
+}
+
+// src/domains/flows/listDefaults.ts
+function handleFlowsList(ctx, pattern, selectors) {
   const { fs: fs3 } = ctx;
   return flowsList(ctx, pattern, {
     cwd: process.cwd(),
     expandPatterns: (patterns, cwd) => expandPatterns(patterns, cwd, undefined, fs3),
-    peekFlowMeta: makePeekFlowMeta(fs3)
-  });
+    peekFlowMeta: makePeekFlowMeta(fs3),
+    readCachedTags: (files) => readCachedTags(files, fs3),
+    readEnvLabel: (envDir) => readEnvLabel(envDir, fs3),
+    findPulledEnv: (ref) => findPulledEnv(ref, process.cwd(), fs3),
+    listPulledEnvDirs: () => listPulledEnvDirs(process.cwd(), fs3)
+  }, selectors);
 }
 
 // src/domains/flows/listRemote.ts
 var import_picomatch2 = __toESM(require_picomatch2(), 1);
+
+// src/domains/flows/fetchKnownTags.ts
+var pageSize = 100;
+var maxPages = 20;
+async function fetchKnownTags(ctx) {
+  const names = [];
+  let cursor3;
+  try {
+    for (let page = 0;page < maxPages; page += 1) {
+      const result = await ctx.platformClient.callPublicApi(publicContractsV1.tag.list, {
+        includeFlowIds: false,
+        limit: pageSize,
+        ...cursor3 === undefined ? {} : { cursor: cursor3 }
+      });
+      if (!result.ok)
+        return;
+      names.push(...result.value.tags.map((tag) => tag.name));
+      cursor3 = result.value.nextCursor;
+      if (cursor3 === undefined)
+        return names;
+    }
+  } catch {
+    return;
+  }
+  return;
+}
+
+// src/domains/flows/listRemote.ts
 async function flowsListRemote(ctx, pattern, options) {
   const result = await ctx.platformClient.callPublicApi(publicContractsV1.flow.list, {
     environmentId: options.env,
@@ -348712,7 +349125,7 @@ async function flowsListRemote(ctx, pattern, options) {
   if (!result.ok)
     return failureFields(result);
   const matches = pattern ? import_picomatch2.default(pattern) : undefined;
-  const items = result.value.flows.filter((f2) => !matches || matches(f2.path)).map((f2) => ({
+  const all = result.value.flows.filter((f2) => !matches || matches(f2.path)).map((f2) => ({
     flowId: f2.flowId,
     file: f2.path,
     name: f2.name,
@@ -348720,6 +349133,11 @@ async function flowsListRemote(ctx, pattern, options) {
     target: typeof f2.executionTarget === "string" ? f2.executionTarget : JSON.stringify(f2.executionTarget),
     url: f2.url
   }));
+  const selectors = { tags: options.tags };
+  const items = all.filter((item) => matchesSelectors(item, selectors));
+  const empty2 = await emptySelectionResult(selectors, items.length, () => fetchKnownTags(ctx));
+  if (empty2 !== undefined)
+    return empty2;
   if (ctx.ui.mode === "json") {
     ctx.ui.json(items);
     return;
@@ -348731,6 +349149,8 @@ async function flowsListRemote(ctx, pattern, options) {
   const rows = items.map((it) => ({
     name: it.name,
     target: it.target,
+    env: undefined,
+    tags: it.tags,
     file: it.file
   }));
   if (ctx.ui.mode === "agent") {
@@ -348744,77 +349164,29 @@ async function flowsListRemote(ctx, pattern, options) {
 }
 
 // src/domains/flows/pull/handler.ts
-import { dirname as dirname7, join as join25, resolve as resolve8 } from "node:path";
+import { dirname as dirname8, join as join27, resolve as resolve8 } from "node:path";
 
-// src/shell/manifest/io.ts
-import { createHash as createHash2 } from "node:crypto";
-import { join as join21 } from "node:path";
-var manifestFilename = ".manifest.json";
-var flowEntrySchema = exports_external.object({
-  path: exports_external.string(),
-  contentHash: exports_external.string()
-});
-var manifestSchema = exports_external.object({
-  envId: exports_external.string(),
-  envSlug: exports_external.string().optional(),
-  fetchedAt: exports_external.string(),
-  envVarsFetchedAt: exports_external.string().optional(),
-  cliFlowsVersion: exports_external.string(),
-  qawolfCommitSha: exports_external.string().optional(),
-  qawolfCommittedAt: exports_external.string().optional(),
-  flows: exports_external.array(flowEntrySchema)
-});
-async function readManifest(envDir, fs3 = makeDefaultFs()) {
-  let raw;
-  try {
-    raw = await fs3.readFile(join21(envDir, manifestFilename));
-  } catch (err) {
-    if (isNoEntError(err))
-      return "missing";
-    throw err;
-  }
-  let parsed;
+// src/domains/flows/pull/fetchPhase.ts
+async function fetchTags(ctx, envId) {
   try {
-    parsed = JSON.parse(raw);
+    const result = await ctx.platformClient.callPublicApi(publicContractsV1.flow.list, { environmentId: envId, includeDrafts: true });
+    if (!result.ok)
+      return;
+    return {
+      fetchedAt: new Date,
+      byPath: new Map(result.value.flows.map((f2) => [f2.path, [...f2.tags]]))
+    };
   } catch {
-    return "malformed";
+    return;
   }
-  const result = manifestSchema.safeParse(parsed);
-  if (!result.success)
-    return "malformed";
-  return {
-    envId: result.data.envId,
-    envSlug: result.data.envSlug,
-    fetchedAt: result.data.fetchedAt,
-    envVarsFetchedAt: result.data.envVarsFetchedAt,
-    cliFlowsVersion: result.data.cliFlowsVersion,
-    qawolfCommitSha: result.data.qawolfCommitSha,
-    qawolfCommittedAt: result.data.qawolfCommittedAt,
-    flows: result.data.flows
-  };
-}
-async function writeManifest(envDir, manifest, fs3 = makeDefaultFs()) {
-  const body = JSON.stringify(manifest, undefined, 2);
-  await fs3.writeFile(join21(envDir, manifestFilename), `${body}
-`);
 }
-function hashFile(absPath, fs3 = makeDefaultFs()) {
-  return new Promise((resolve5, reject) => {
-    const hash2 = createHash2("sha256");
-    const stream = fs3.createReadStream(absPath);
-    stream.on("data", (chunk) => hash2.update(chunk));
-    stream.on("end", () => resolve5(hash2.digest("hex")));
-    stream.on("error", reject);
-  });
-}
-
-// src/domains/flows/pull/fetchPhase.ts
 async function fetchBundleAndEnvVars(ctx, envId) {
   const { platformClient } = ctx;
   let tmpArchive;
   let bundleFetchedAt;
   let envVars;
   let envVarsFetchedAt;
+  let tags;
   await ctx.ui.withProgress([
     {
       message: flowsMessages.pull.downloadingBundle,
@@ -348835,19 +349207,25 @@ async function fetchBundleAndEnvVars(ctx, envId) {
         envVars = result.value;
         envVarsFetchedAt = new Date;
       }
+    },
+    {
+      message: flowsMessages.pull.fetchingTags,
+      task: async () => {
+        tags = await fetchTags(ctx, envId);
+      }
     }
   ], flowsMessages.pull.downloadComplete);
   if (tmpArchive === undefined || bundleFetchedAt === undefined || envVars === undefined || envVarsFetchedAt === undefined) {
     throw new Error("Unexpected state: the bundle and env vars were not fetched. " + "This is a bug - please report it at https://github.com/qawolf/cli/issues");
   }
-  return { tmpArchive, bundleFetchedAt, envVars, envVarsFetchedAt };
+  return { tmpArchive, bundleFetchedAt, envVars, envVarsFetchedAt, tags };
 }
 
 // src/domains/flows/pull/safety.ts
 import { resolve as resolve6 } from "node:path";
 
 // src/domains/flows/pull/entryPath.ts
-import { isAbsolute as isAbsolute3, posix as posix2, relative as relative3, resolve as resolve5 } from "node:path";
+import { isAbsolute as isAbsolute3, posix as posix2, relative as relative5, resolve as resolve5 } from "node:path";
 function validateEntryPath(name, destResolved) {
   if (!name)
     throw new Error("empty entry name");
@@ -348859,7 +349237,7 @@ function validateEntryPath(name, destResolved) {
     throw new Error(`path traversal: entry escapes destination (${name})`);
   }
   const target = resolve5(destResolved, name);
-  const rel = relative3(destResolved, target);
+  const rel = relative5(destResolved, target);
   if (rel.startsWith("..") || isAbsolute3(rel)) {
     throw new Error(`path traversal: entry resolves outside destination (${name})`);
   }
@@ -348929,8 +349307,28 @@ async function checkSafety(args) {
   return promptOverwriteIfModified({ ...args, manifest: existing });
 }
 
+// src/domains/flows/pull/reportPull.ts
+import { join as join23 } from "node:path";
+function reportPullResult(ui, args) {
+  if (ui.mode !== "json")
+    return;
+  ui.output({
+    env: args.env,
+    envDir: args.stage.envDir,
+    assetsDir: args.assetsAbs,
+    fetchedAt: args.fetchedAt.toISOString(),
+    flowCount: args.stage.flowCount,
+    envVarCount: args.stage.envVarCount,
+    flowsWithTeamStorageRefs: args.stage.flowsWithTeamStorageRefs,
+    assetDownloadedCount: args.assets.downloadedCount,
+    assetReusedCount: args.assets.reusedCount,
+    assetSkippedCount: args.assets.skippedCount,
+    manifestPath: join23(args.stage.envDir, manifestFilename)
+  }, "");
+}
+
 // src/domains/flows/pull/bundle.ts
-import { join as join22, relative as relative4 } from "node:path";
+import { join as join24, relative as relative6 } from "node:path";
 async function flattenSingleWrapper(dir, fs3 = makeDefaultFs()) {
   const entries = await fs3.readdir(dir);
   if (entries.length !== 1)
@@ -348938,12 +349336,12 @@ async function flattenSingleWrapper(dir, fs3 = makeDefaultFs()) {
   const innerName = entries[0];
   if (!innerName)
     return;
-  const inner = join22(dir, innerName);
+  const inner = join24(dir, innerName);
   const innerStat = await fs3.stat(inner);
   if (!innerStat.isDirectory())
     return;
   for (const e of await fs3.readdir(inner)) {
-    await fs3.rename(join22(inner, e), join22(dir, e));
+    await fs3.rename(join24(inner, e), join24(dir, e));
   }
   const leftovers = await fs3.readdir(inner);
   if (leftovers.length > 0) {
@@ -348961,17 +349359,20 @@ var flowExtensions = [".flow.ts", ".flow.js"];
 async function buildManifest(args, fs3 = makeDefaultFs()) {
   const flowPaths = await walkForFlows(args.bundleDir, fs3);
   const flows = await Promise.all(flowPaths.map(async (rel) => ({
-    path: rel,
-    contentHash: await hashFile(join22(args.bundleDir, rel), fs3)
+    path: toPosix(rel),
+    contentHash: await hashFile(join24(args.bundleDir, rel), fs3),
+    tags: args.tags?.byPath.get(toPosix(rel))
   })));
   return {
     envId: args.envId,
-    envSlug: undefined,
+    envSlug: args.envSlug,
+    envName: args.envName,
     fetchedAt: args.now.toISOString(),
     envVarsFetchedAt: args.envVarsFetchedAt?.toISOString(),
     cliFlowsVersion: args.cliFlowsVersion,
     qawolfCommitSha: extractQawolfCommitSha(args.wrapperName),
     qawolfCommittedAt: args.qawolfCommittedAt,
+    tagsFetchedAt: args.tags?.fetchedAt.toISOString(),
     flows
   };
 }
@@ -348983,11 +349384,11 @@ async function walkForFlows(root, fs3) {
 async function walk(current, root, out, fs3) {
   const entries = await fs3.readdirWithTypes(current);
   for (const e of entries) {
-    const abs = join22(current, e.name);
+    const abs = join24(current, e.name);
     if (e.isDirectory()) {
       await walk(abs, root, out, fs3);
     } else if (e.isFile() && flowExtensions.some((ext) => e.name.endsWith(ext))) {
-      out.push(relative4(root, abs));
+      out.push(relative6(root, abs));
     }
   }
 }
@@ -348996,11 +349397,11 @@ async function sampleQawolfCommittedAt(bundleDir, fs3 = makeDefaultFs()) {
   const sample = flowPaths[0];
   if (!sample)
     return;
-  return (await fs3.stat(join22(bundleDir, sample))).mtime.toISOString();
+  return (await fs3.stat(join24(bundleDir, sample))).mtime.toISOString();
 }
 
 // src/domains/flows/pull/applyTeamStorageRewrite.ts
-import { join as join23, relative as relative5 } from "node:path";
+import { join as join25, relative as relative7 } from "node:path";
 
 // src/domains/flows/pull/rewriteTeamStorage.ts
 var runnerMountPrefix = "/home/wolf/team-storage/";
@@ -349036,7 +349437,7 @@ function isFlowFile(name) {
 async function walk2(dir, out, fs3) {
   const entries = await fs3.readdirWithTypes(dir);
   for (const e of entries) {
-    const abs = join23(dir, e.name);
+    const abs = join25(dir, e.name);
     if (e.isDirectory()) {
       await walk2(abs, out, fs3);
     } else if (e.isFile() && isSourceFile(e.name)) {
@@ -349055,7 +349456,7 @@ async function applyTeamStorageRewrite(rootDir, fs3 = makeDefaultFs()) {
       await fs3.writeFile(file2, finalSource);
     }
     if (isFlowFile(file2) && finalSource.includes("process.env.TEAM_STORAGE_DIR")) {
-      return relative5(rootDir, file2);
+      return relative7(rootDir, file2);
     }
     return;
   }));
@@ -349064,7 +349465,7 @@ async function applyTeamStorageRewrite(rootDir, fs3 = makeDefaultFs()) {
 }
 
 // src/domains/flows/pull/envVars.ts
-import { join as join24 } from "node:path";
+import { join as join26 } from "node:path";
 
 // src/core/dotenv.ts
 var bareKeyPattern = /^[A-Za-z_][A-Za-z0-9_]*$/;
@@ -349129,13 +349530,13 @@ function unquote(escaped) {
 async function writeEnvFile(envDir, vars, fs3 = makeDefaultFs()) {
   if (Object.keys(vars).length === 0)
     return;
-  await fs3.writeFile(join24(envDir, ".env"), serializeDotenv(vars), {
+  await fs3.writeFile(join26(envDir, ".env"), serializeDotenv(vars), {
     mode: 384
   });
 }
 
 // src/domains/flows/pull/extract.ts
-import { dirname as dirname6, resolve as resolve7 } from "node:path";
+import { dirname as dirname7, resolve as resolve7 } from "node:path";
 import { createGunzip } from "node:zlib";
 
 // node_modules/tar/dist/esm/index.min.js
@@ -352452,7 +352853,7 @@ async function handleEntry(args) {
     total: args.getTotal()
   });
   args.addTotal(size);
-  args.fs.mkdirSync(dirname6(target), { recursive: true });
+  args.fs.mkdirSync(dirname7(target), { recursive: true });
   const chunks = [];
   await new Promise((res, rej) => {
     entry.on("data", (chunk) => chunks.push(chunk));
@@ -352510,6 +352911,9 @@ async function stageBundle(args, fs4 = makeDefaultFs()) {
     await writeEnvFile(tmpDir, effectiveEnvVars, fs4);
     const manifest = await buildManifest({
       envId: args.envId,
+      tags: args.tags ?? await carriedTags(args.destAbs, fs4),
+      envSlug: args.envSlug,
+      envName: args.envName,
       bundleDir: tmpDir,
       cliFlowsVersion: args.cliFlowsVersion,
       now: args.now,
@@ -352543,6 +352947,19 @@ async function stageBundle(args, fs4 = makeDefaultFs()) {
     throw err;
   }
 }
+async function carriedTags(envDir, fs4) {
+  const previous = await readManifest(envDir, fs4);
+  if (typeof previous === "string")
+    return;
+  if (previous.tagsFetchedAt === undefined)
+    return;
+  const byPath = new Map;
+  for (const flow of previous.flows) {
+    if (flow.tags !== undefined)
+      byPath.set(toPosix(flow.path), [...flow.tags]);
+  }
+  return { fetchedAt: new Date(previous.tagsFetchedAt), byPath };
+}
 
 // src/domains/flows/pull/handler.ts
 async function handleFlowsPull(ctx, opts, deps) {
@@ -352555,8 +352972,8 @@ async function handleFlowsPull(ctx, opts, deps) {
     ctx.ui.error(validation.error);
     return { error: validation.error };
   }
-  const destAbs = resolve8(opts.out ?? join25(".qawolf", opts.env));
-  const assetsAbs = join25(dirname7(destAbs), "assets");
+  const destAbs = resolve8(opts.out ?? join27(".qawolf", opts.env));
+  const assetsAbs = join27(dirname8(destAbs), "assets");
   await resolvedDeps.fs.mkdir(assetsAbs, { recursive: true });
   const yes = opts.yes ?? false;
   let archive;
@@ -352589,10 +353006,13 @@ async function handleFlowsPull(ctx, opts, deps) {
           destAbs,
           assetsAbs,
           envId: opts.env,
+          envSlug: opts.envSlug,
+          envName: opts.envName,
           cliFlowsVersion: resolvedDeps.flowsVersion,
           now: fetched.bundleFetchedAt,
           envVars: fetched.envVars,
-          envVarsFetchedAt: fetched.envVarsFetchedAt
+          envVarsFetchedAt: fetched.envVarsFetchedAt,
+          tags: fetched.tags
         }, resolvedDeps.fs)
       },
       {
@@ -352612,21 +353032,13 @@ async function handleFlowsPull(ctx, opts, deps) {
       assetReusedCount: results[1].reusedCount,
       assetSkippedCount: results[1].skippedCount
     }, assetsAbs));
-    if (ctx.ui.mode === "json") {
-      ctx.ui.output({
-        env: opts.env,
-        envDir: result.envDir,
-        assetsDir: assetsAbs,
-        fetchedAt: fetched.bundleFetchedAt.toISOString(),
-        flowCount: result.flowCount,
-        envVarCount: result.envVarCount,
-        flowsWithTeamStorageRefs: result.flowsWithTeamStorageRefs,
-        assetDownloadedCount: assetResult.downloadedCount,
-        assetReusedCount: assetResult.reusedCount,
-        assetSkippedCount: assetResult.skippedCount,
-        manifestPath: join25(result.envDir, manifestFilename)
-      }, "");
-    }
+    reportPullResult(ctx.ui, {
+      env: opts.env,
+      assetsAbs,
+      fetchedAt: fetched.bundleFetchedAt,
+      stage: result,
+      assets: assetResult
+    });
   } finally {
     if (archive !== undefined)
       await resolvedDeps.fs.unlink(archive).catch(() => {});
@@ -352637,16 +353049,25 @@ async function handleFlowsPull(ctx, opts, deps) {
 var findContract = publicContractsV1.environment.find;
 async function pickEnvironment(deps) {
   const fetched = await fetchAllEnvironments(deps.platformClient);
-  if (!fetched.ok)
-    return { ...failureFields(fetched), kind: "error" };
+  if (!fetched.ok) {
+    return {
+      ...failureFields(fetched),
+      kind: "error",
+      unreachable: fetched.unreachable === true
+    };
+  }
   const environments = fetched.environments;
   if (environments.length === 0) {
-    return { kind: "error", error: environmentsMessages.noEnvironments };
+    return {
+      kind: "error",
+      error: environmentsMessages.noEnvironments,
+      unreachable: false
+    };
   }
   const sole = environments.length === 1 ? environments[0] : undefined;
   if (sole) {
     deps.ui.info(environmentsMessages.usingEnvironment(sole.name));
-    return { kind: "resolved", env: sole.id };
+    return resolvedFrom(sole);
   }
   const narrowed = await narrowByKind(deps.ui, environments);
   if (narrowed === "cancelled")
@@ -352654,7 +353075,7 @@ async function pickEnvironment(deps) {
   const soleOfKind = narrowed.length === 1 ? narrowed[0] : undefined;
   if (soleOfKind) {
     deps.ui.info(environmentsMessages.usingEnvironment(soleOfKind.name));
-    return { kind: "resolved", env: soleOfKind.id };
+    return resolvedFrom(soleOfKind);
   }
   const picked = await deps.ui.select(environmentsMessages.whichEnvironment, narrowed.map((e) => ({
     value: e.id,
@@ -352664,7 +353085,16 @@ async function pickEnvironment(deps) {
   if (!picked.ok)
     return { kind: "cancelled" };
   deps.ui.info(environmentsMessages.exportHint(picked.value));
-  return { kind: "resolved", env: picked.value };
+  const chosen = narrowed.find((e) => e.id === picked.value);
+  return chosen ? resolvedFrom(chosen) : { kind: "resolved", env: picked.value };
+}
+function resolvedFrom(environment) {
+  return {
+    kind: "resolved",
+    env: environment.id,
+    slug: environment.alias ?? undefined,
+    name: environment.name
+  };
 }
 async function narrowByKind(ui2, environments) {
   const byKind = (kind) => environments.filter((e) => e.kind === kind);
@@ -352689,11 +353119,11 @@ async function narrowByKind(ui2, environments) {
     return "cancelled";
   return picked.value === "static" ? statics : previews;
 }
-var maxPages = 10;
+var maxPages2 = 10;
 async function fetchAllEnvironments(platformClient) {
   const environments = [];
   let cursor3;
-  for (let page = 0;page < maxPages; page += 1) {
+  for (let page = 0;page < maxPages2; page += 1) {
     const result = await platformClient.callPublicApi(findContract, {
       limit: 100,
       cursor: cursor3
@@ -352705,7 +353135,7 @@ async function fetchAllEnvironments(platformClient) {
     if (cursor3 === undefined)
       return { ok: true, environments };
   }
-  return { ok: false, error: environmentsMessages.tooManyPages(maxPages) };
+  return { ok: false, error: environmentsMessages.tooManyPages(maxPages2) };
 }
 
 // src/domains/environments/resolveEnvironment.ts
@@ -352721,7 +353151,7 @@ async function resolveEnvironment(deps, opts) {
     return resolveRef2(deps, fromEnvVar);
   }
   if (deps.ui.mode !== "human") {
-    return { kind: "error", error: opts.requiredMessage };
+    return { kind: "error", error: opts.requiredMessage, unreachable: false };
   }
   return pickEnvironment(deps);
 }
@@ -352733,16 +353163,27 @@ async function resolveRef2(deps, ref) {
     return {
       ...failureFields(result),
       kind: "error",
-      error: environmentsMessages.couldNotResolve(ref, result.error)
+      error: environmentsMessages.couldNotResolve(ref, result.error),
+      unreachable: result.unreachable === true
     };
   }
   if (result.value.id !== ref) {
     deps.ui.info(environmentsMessages.resolvedAlias(ref, result.value.id));
   }
-  return { kind: "resolved", env: result.value.id };
+  return {
+    kind: "resolved",
+    env: result.value.id,
+    slug: result.value.alias ?? undefined,
+    name: result.value.name
+  };
 }
 
 // src/commands/flows/withResolvedEnv.ts
+async function pulledEnvFallback(outcome, explicit, offlineFallback) {
+  if (!outcome.unreachable)
+    return;
+  return offlineFallback?.(explicit);
+}
 function withResolvedEnv(signals, args, fn) {
   return (opts, command) => {
     const pickerNeeded = !args.explicit?.trim() && !(process.env["QAWOLF_ENVIRONMENT"] ?? "").trim();
@@ -352765,9 +353206,17 @@ function withResolvedEnv(signals, args, fn) {
         return;
       }
       if (outcome.kind === "error") {
+        const pulled = await pulledEnvFallback(outcome, args.explicit, args.offlineFallback);
+        if (pulled !== undefined) {
+          ctx.ui.warn(environmentsMessages.usingPulledEnv(pulled));
+          return fn(ctx, pulled, { slug: undefined, name: undefined });
+        }
         return failureFields(outcome);
       }
-      return fn(ctx, outcome.env);
+      return fn(ctx, outcome.env, {
+        slug: outcome.slug,
+        name: outcome.name
+      });
     })(opts, command);
   };
 }
@@ -352780,30 +353229,37 @@ Examples:
   $ qawolf flows pull --env staging --yes`;
 function registerFlowsPullCommand(flows, signals) {
   declareCommandKind(flows.command("pull"), "read").description("Download an environment's flows into the local .qawolf/<env>/ cache").option("--env <env>", "Environment to pull from (UUID or kebab-case slug); defaults to QAWOLF_ENVIRONMENT, or an interactive picker").option("--out <path>", "Destination directory (defaults to .qawolf/<env>/)").option("--yes", "Overwrite locally-modified files without prompting", false).addHelpText("after", pullExamples).action((opts, command) => {
-    return withResolvedEnv(signals, { explicit: opts.env, requiredMessage: flowsMessages.pull.requiresEnv }, (ctx, env2) => handleFlowsPull(ctx, { ...opts, env: env2 }))(opts, command);
+    return withResolvedEnv(signals, { explicit: opts.env, requiredMessage: flowsMessages.pull.requiresEnv }, (ctx, env2, identity) => handleFlowsPull(ctx, {
+      ...opts,
+      env: env2,
+      envSlug: identity.slug,
+      envName: identity.name
+    }))(opts, command);
   });
 }
 
-// src/domains/runner/runFlagParsers.ts
-function parseInteger(name, options = {}) {
-  return (value) => {
-    const n2 = Number.parseInt(value, 10);
-    if (!Number.isFinite(n2) || String(n2) !== value) {
-      throw new InvalidArgumentError(`${name} must be an integer`);
-    }
-    if (options.min !== undefined && n2 < options.min) {
-      throw new InvalidArgumentError(`${name} must be >= ${options.min}`);
-    }
-    return n2;
-  };
+// src/commands/flows/runArtifactOptions.ts
+var videoModes = ["on", "off", "retain-on-failure"];
+var traceModes = ["on", "off", "retain-on-failure"];
+var harModes = ["on", "off", "retain-on-failure"];
+var harContentModes = ["full", "omit"];
+var videoDefault = "off";
+var traceDefault = "off";
+var harDefault = "off";
+var harContentDefault = "omit";
+function addRunArtifactOptions(command) {
+  return command.option("--video <mode>", "Record video: on | off | retain-on-failure", parseEnum("--video", videoModes), videoDefault).option("--trace <mode>", "Record Playwright trace: on | off | retain-on-failure", parseEnum("--trace", traceModes), traceDefault).option("--har <mode>", "Record HAR network log: on | off | retain-on-failure", parseEnum("--har", harModes), harDefault).option("--har-content <mode>", "HAR response bodies: omit | full (full uses more memory)", parseEnum("--har-content", harContentModes), harContentDefault).option("--output-dir <path>", "Directory for run artifacts (videos, traces, HAR)", defaultOutputDir).option("--junit [path]", "Write a JUnit XML report (default: <output-dir>/junit-report.xml)");
 }
-function parseEnum(name, values) {
-  return (value) => {
-    if (!values.includes(value)) {
-      throw new InvalidArgumentError(`${name} must be one of: ${values.join(", ")}`);
-    }
-    return value;
-  };
+
+// src/domains/flows/allEnvsWarning.ts
+function allEnvsNoEffectWarning(args) {
+  if (!args.allEnvs)
+    return;
+  if (args.env !== undefined)
+    return flowsMessages.selectors.allEnvsWithEnv;
+  if (args.tags.length === 0)
+    return flowsMessages.selectors.allEnvsWithoutTag;
+  return;
 }
 
 // src/core/patternArgs.ts
@@ -352811,6 +353267,44 @@ function buildPatternArgs(pattern) {
   return pattern ? [pattern] : [];
 }
 
+// src/domains/flows/resolveEnvChoice.ts
+var allValue = "all";
+async function resolveEnvChoice(args) {
+  const byEnv = new Map;
+  for (const file2 of args.files) {
+    const key = findPulledEnvDir(file2) ?? "";
+    const group = byEnv.get(key);
+    if (group)
+      group.push(file2);
+    else
+      byEnv.set(key, [file2]);
+  }
+  const envDirs = [...byEnv.keys()].filter((key) => key !== "");
+  if (envDirs.length <= 1 || args.allEnvs) {
+    return { kind: "proceed", files: [...args.files] };
+  }
+  const labels = await Promise.all(envDirs.map(async (dir) => ({ dir, label: await args.readLabel(dir) })));
+  if (args.mode !== "human") {
+    return {
+      kind: "error",
+      error: flowsMessages.selectors.ambiguousEnvs(labels.map((l2) => l2.label))
+    };
+  }
+  const picked = await args.select(flowsMessages.selectors.chooseEnv, [
+    ...labels.map(({ dir, label }) => ({ value: dir, label })),
+    { value: allValue, label: "All" }
+  ]);
+  if (!picked.ok)
+    return { kind: "cancelled" };
+  if (picked.value === allValue) {
+    return { kind: "proceed", files: [...args.files] };
+  }
+  return {
+    kind: "proceed",
+    files: [...byEnv.get("") ?? [], ...byEnv.get(picked.value) ?? []]
+  };
+}
+
 // src/core/flowFailureHint.ts
 function flowFailureHint(errText, projectDir) {
   const missingPackage = extractMissingPackage(errText);
@@ -353354,15 +353848,15 @@ async function defaultRunWebFlowDeps(envDir = process.cwd(), signals) {
 
 // src/domains/runtimeEnv/prepareRunDir.ts
 import { createHash as createHash4 } from "node:crypto";
-import { join as join33, resolve as resolve9 } from "node:path";
+import { join as join35, resolve as resolve9 } from "node:path";
 
 // src/domains/runtimeEnv/execSubpathImports.ts
-import { join as join26 } from "node:path";
+import { join as join28 } from "node:path";
 var flowSubpathImports = { "#playwright": "playwright" };
 var packageJsonSchema = exports_external.looseObject({ imports: exports_external.record(exports_external.string(), exports_external.unknown()).catch({}) }).catch({ imports: {} });
 async function writeExecSubpathImports(args) {
   const { execDir, fs: fs4 } = args;
-  const pkgPath = join26(execDir, "package.json");
+  const pkgPath = join28(execDir, "package.json");
   const pkg = packageJsonSchema.parse(await readPackageJson(pkgPath, fs4));
   const merged = { ...pkg, imports: { ...pkg.imports, ...flowSubpathImports } };
   await fs4.writeFile(pkgPath, JSON.stringify(merged, undefined, 2));
@@ -353384,10 +353878,10 @@ async function readPackageJson(pkgPath, fs4) {
 }
 
 // src/domains/runtimeEnv/innerHop.ts
-import { join as join28 } from "node:path";
+import { join as join30 } from "node:path";
 
 // src/domains/runtimeEnv/linkPinnedPackages.ts
-import { dirname as dirname8, join as join27 } from "node:path";
+import { dirname as dirname9, join as join29 } from "node:path";
 
 // src/domains/runtimeEnv/symlinkDir.ts
 import { symlink } from "node:fs/promises";
@@ -353399,16 +353893,16 @@ async function createDirSymlink(source, target) {
 // src/domains/runtimeEnv/linkPinnedPackages.ts
 async function linkPinnedPackages(args) {
   const { depsRoot, nodeModulesDir, fs: fs4 } = args;
-  const managedModules = join27(depsRoot, "node_modules");
+  const managedModules = join29(depsRoot, "node_modules");
   await fs4.mkdir(nodeModulesDir, { recursive: true });
   for (const { name } of pinnedPackages) {
     const segments = name.split("/");
-    const target = join27(nodeModulesDir, ...segments);
+    const target = join29(nodeModulesDir, ...segments);
     if (segments.length > 1) {
-      await fs4.mkdir(dirname8(target), { recursive: true });
+      await fs4.mkdir(dirname9(target), { recursive: true });
     }
     await fs4.rm(target, { recursive: true, force: true });
-    await createDirSymlink(join27(managedModules, ...segments), target);
+    await createDirSymlink(join29(managedModules, ...segments), target);
   }
 }
 
@@ -353417,18 +353911,18 @@ async function populateInnerHop(args) {
   const { depsRoot, execDir, fs: fs4 } = args;
   await linkPinnedPackages({
     depsRoot,
-    nodeModulesDir: join28(execDir, "node_modules"),
+    nodeModulesDir: join30(execDir, "node_modules"),
     fs: fs4
   });
 }
 
 // src/domains/runtimeEnv/outerHop.ts
 import { lstat as lstat2 } from "node:fs/promises";
-import { dirname as dirname10, join as join30 } from "node:path";
+import { dirname as dirname11, join as join32 } from "node:path";
 
 // src/domains/runtimeEnv/carryOverPackages.ts
 import { lstat } from "node:fs/promises";
-import { dirname as dirname9, join as join29 } from "node:path";
+import { dirname as dirname10, join as join31 } from "node:path";
 
 // src/domains/runtimeEnv/carryOverPlan.ts
 var executorPackageNames = new Set(pinnedPackages.map((p3) => p3.name));
@@ -353450,12 +353944,12 @@ async function carryOverPackages(args) {
   const linked = [];
   for (const name of names) {
     const segments = name.split("/");
-    const target = join29(nodeModulesDir, ...segments);
+    const target = join31(nodeModulesDir, ...segments);
     if (await pathOccupied(target))
       continue;
     if (segments.length > 1)
-      await fs4.mkdir(dirname9(target), { recursive: true });
-    await createDirSymlink(join29(projectModulesDir, ...segments), target);
+      await fs4.mkdir(dirname10(target), { recursive: true });
+    await createDirSymlink(join31(projectModulesDir, ...segments), target);
     linked.push(name);
   }
   return linked;
@@ -353478,18 +353972,18 @@ async function listPackageNames(dir, fs4) {
   const names = [];
   for (const entry of entries) {
     if (!entry.startsWith("@")) {
-      if (fs4.existsSync(join29(dir, entry, "package.json")))
+      if (fs4.existsSync(join31(dir, entry, "package.json")))
         names.push(entry);
       continue;
     }
     let scoped;
     try {
-      scoped = await fs4.readdir(join29(dir, entry));
+      scoped = await fs4.readdir(join31(dir, entry));
     } catch {
       continue;
     }
     for (const inner of scoped) {
-      if (fs4.existsSync(join29(dir, entry, inner, "package.json"))) {
+      if (fs4.existsSync(join31(dir, entry, inner, "package.json"))) {
         names.push(`${entry}/${inner}`);
       }
     }
@@ -353507,7 +354001,7 @@ async function populateOuterHop(args) {
   const depNames = Object.keys(installableDeps);
   const { satisfying, rejected } = await findSatisfyingNodeModulesDir(projectDir, depNames, fs4);
   if (satisfying !== undefined) {
-    await createDirSymlink(satisfying, join30(runDir, "node_modules"));
+    await createDirSymlink(satisfying, join32(runDir, "node_modules"));
     return { mode: "symlink", nodeModulesDir: satisfying };
   }
   if (depNames.length === 0)
@@ -353516,12 +354010,12 @@ async function populateOuterHop(args) {
   await installOuterDeps(runDir, installableDeps, fs4, args.install ?? spawnNpmInstall);
   await linkPinnedPackages({
     depsRoot: args.depsRoot,
-    nodeModulesDir: join30(runDir, "node_modules"),
+    nodeModulesDir: join32(runDir, "node_modules"),
     fs: fs4
   });
   const carriedOver = await carryOverPackages({
-    projectModulesDir: join30(projectDir, "node_modules"),
-    nodeModulesDir: join30(runDir, "node_modules"),
+    projectModulesDir: join32(projectDir, "node_modules"),
+    nodeModulesDir: join32(runDir, "node_modules"),
     fs: fs4
   });
   return { mode: "install", depCount: depNames.length, rejected, carriedOver };
@@ -353530,15 +354024,15 @@ async function findSatisfyingNodeModulesDir(startDir, depNames, fs4) {
   const rejected = [];
   let dir = startDir;
   while (true) {
-    const candidate = join30(dir, "node_modules");
+    const candidate = join32(dir, "node_modules");
     const stats = await lstatSafe(candidate);
     if (stats !== undefined && stats.isDirectory() && !stats.isSymbolicLink()) {
-      const missing = depNames.filter((name) => !fs4.existsSync(join30(candidate, name, "package.json")));
+      const missing = depNames.filter((name) => !fs4.existsSync(join32(candidate, name, "package.json")));
       if (missing.length === 0)
         return { satisfying: candidate, rejected };
       rejected.push({ dir: candidate, missing });
     }
-    const parent = dirname10(dir);
+    const parent = dirname11(dir);
     if (parent === dir)
       return { satisfying: undefined, rejected };
     dir = parent;
@@ -353554,7 +354048,7 @@ async function lstatSafe(path3) {
 async function readInstallableDeps(projectDir, fs4) {
   let content;
   try {
-    content = await fs4.readFile(join30(projectDir, "package.json"));
+    content = await fs4.readFile(join32(projectDir, "package.json"));
   } catch {
     return {};
   }
@@ -353572,8 +354066,8 @@ async function readInstallableDeps(projectDir, fs4) {
   return Object.fromEntries(Object.entries(rawDeps).filter(([name]) => !executorPackageNames2.has(name)).filter((entry) => typeof entry[1] === "string"));
 }
 async function installOuterDeps(runDir, deps, fs4, install) {
-  await fs4.writeFile(join30(runDir, "package.json"), JSON.stringify({ name: "qawolf-run", private: true, dependencies: deps }, undefined, 2));
-  await fs4.writeFile(join30(runDir, ".npmrc"), `@qawolf:registry=https://registry.npmjs.org/
+  await fs4.writeFile(join32(runDir, "package.json"), JSON.stringify({ name: "qawolf-run", private: true, dependencies: deps }, undefined, 2));
+  await fs4.writeFile(join32(runDir, ".npmrc"), `@qawolf:registry=https://registry.npmjs.org/
 `);
   const result = await install(runDir);
   if (result.exitCode !== 0) {
@@ -353583,16 +354077,16 @@ async function installOuterDeps(runDir, deps, fs4, install) {
 
 // src/domains/runtimeEnv/stageFlowFiles.ts
 import { createHash as createHash3 } from "node:crypto";
-import { basename as basename4, dirname as dirname11, join as join32, sep as sep4 } from "node:path";
+import { basename as basename6, dirname as dirname12, join as join34, sep as sep4 } from "node:path";
 
 // src/shell/copyDir.ts
 import { cp, readdir as readdir2 } from "node:fs/promises";
-import { basename as basename3, join as join31 } from "node:path";
+import { basename as basename5, join as join33 } from "node:path";
 async function copyDirExcluding(source, destination, excludedNames) {
   const entries = await readdir2(source, { withFileTypes: true });
-  await Promise.all(entries.filter((entry) => !excludedNames.has(entry.name)).map((entry) => cp(join31(source, entry.name), join31(destination, entry.name), {
+  await Promise.all(entries.filter((entry) => !excludedNames.has(entry.name)).map((entry) => cp(join33(source, entry.name), join33(destination, entry.name), {
     recursive: true,
-    filter: (path3) => !excludedNames.has(basename3(path3))
+    filter: (path3) => !excludedNames.has(basename5(path3))
   })));
 }
 
@@ -353607,14 +354101,14 @@ async function stageFlowFiles(args) {
   if (files.length > 1) {
     return Promise.all(files.map((f3) => stageOneFile(f3, execDir, fs4)));
   }
-  await Promise.all(files.map((f3) => fs4.copyFile(f3, join32(execDir, basename4(f3)))));
-  return files.map((f3) => join32(execDir, basename4(f3)));
+  await Promise.all(files.map((f3) => fs4.copyFile(f3, join34(execDir, basename6(f3)))));
+  return files.map((f3) => join34(execDir, basename6(f3)));
 }
 async function stageOneFile(file2, execDir, fs4) {
-  const dirHash = createHash3("sha256").update(dirname11(file2)).digest("hex").slice(0, 8);
-  const subDir = join32(execDir, dirHash);
+  const dirHash = createHash3("sha256").update(dirname12(file2)).digest("hex").slice(0, 8);
+  const subDir = join34(execDir, dirHash);
   await fs4.mkdir(subDir, { recursive: true });
-  const dest = join32(subDir, basename4(file2));
+  const dest = join34(subDir, basename6(file2));
   await fs4.copyFile(file2, dest);
   return dest;
 }
@@ -353622,7 +354116,7 @@ function remapPath(file2, projectDir, execDir) {
   if (file2 === projectDir)
     return execDir;
   if (file2.startsWith(projectDir + sep4)) {
-    return join32(execDir, file2.slice(projectDir.length + 1));
+    return join34(execDir, file2.slice(projectDir.length + 1));
   }
   return;
 }
@@ -353632,10 +354126,10 @@ async function prepareRunDir(args) {
   const { files, projectDir, depsRoot, runRoot } = args;
   const fs4 = args.fs ?? makeDefaultFs();
   const runId = buildRunId(projectDir, files);
-  const runDir = join33(runRoot, runId);
+  const runDir = join35(runRoot, runId);
   await fs4.rm(runDir, { recursive: true, force: true });
   await fs4.mkdir(runDir, { recursive: true });
-  const execDir = join33(runDir, "exec");
+  const execDir = join35(runDir, "exec");
   await fs4.mkdir(execDir, { recursive: true });
   await populateInnerHop({ depsRoot, execDir, fs: fs4 });
   const stagedFiles = await stageFlowFiles({ files, projectDir, execDir, fs: fs4 });
@@ -353666,17 +354160,17 @@ function buildRunId(projectDir, files) {
 }
 
 // src/shell/testkit.ts
-import { join as join34 } from "node:path";
+import { join as join36 } from "node:path";
 function notAvailableLocally(name) {
   throw new Error(runnerMessages.notAvailableLocally(name));
 }
 async function loadSdkDeps(cwd) {
-  const testkitDir = join34(cwd, "node_modules", "@qawolf", "testkit");
+  const testkitDir = join36(cwd, "node_modules", "@qawolf", "testkit");
   try {
     const clientMod = await importFromPath(resolveFromEnvDir(cwd, "@qawolf/testkit/client"));
     if (typeof clientMod.createTestkitClient !== "function")
       throw new Error("createTestkitClient is not a function");
-    const scopeMod = await importFromPath(join34(testkitDir, "dist", "clientScope.js"));
+    const scopeMod = await importFromPath(join36(testkitDir, "dist", "clientScope.js"));
     if (typeof scopeMod.configureTestkitClient !== "function")
       throw new Error("configureTestkitClient is not a function");
     return {
@@ -353734,9 +354228,9 @@ async function registerLazyEmailsClient(getInbox, cwd, deps) {
 }
 
 // src/commands/flows/envVarDeps.ts
-import { join as join35 } from "node:path";
+import { join as join37 } from "node:path";
 function envFilePath(envDir) {
-  return join35(envDir, ".env");
+  return join37(envDir, ".env");
 }
 async function readEnv(envDir, fs4) {
   try {
@@ -353840,8 +354334,27 @@ async function createFlowRuntimeDeps({
   };
 }
 
+// src/domains/flows/selectRunByTag.ts
+async function selectRunByTag(args) {
+  if (!hasSelectors(args.selectors))
+    return { ok: true, files: args.files };
+  const cachedTags = await args.readCachedTags(args.files);
+  const notCached = tagsNotCachedResult(args.selectors, cachedTags);
+  if (notCached !== undefined)
+    return { ok: false, result: notCached };
+  const matched = args.files.filter((file2) => matchesSelectors({ tags: cachedTags.get(file2) }, args.selectors));
+  if (matched.length === 0) {
+    return {
+      ok: false,
+      result: args.noMatch(explainEmptySelection(args.selectors))
+    };
+  }
+  const choice = await args.chooseEnv(matched);
+  return "proceed" in choice ? { ok: true, files: choice.proceed } : { ok: false, result: choice.stop };
+}
+
 // src/commands/flows/runStagedFlows.ts
-import { join as join39 } from "node:path";
+import { join as join41 } from "node:path";
 
 // src/shell/appium/createAppiumServer.ts
 import { existsSync as existsSync2 } from "node:fs";
@@ -354206,25 +354719,16 @@ Install Android Studio and open Tools > SDK Manager.`);
 }
 
 // src/shell/manifest/lookup.ts
-import { basename as basename5, dirname as dirname12, relative as relative6 } from "node:path";
+import { relative as relative8 } from "node:path";
 async function findFlowStamp(flowAbsPath) {
-  let envDir;
-  let current = dirname12(flowAbsPath);
-  while (current !== dirname12(current)) {
-    const parent2 = dirname12(current);
-    if (basename5(parent2) === ".qawolf") {
-      envDir = current;
-      break;
-    }
-    current = parent2;
-  }
+  const envDir = findPulledEnvDir(flowAbsPath);
   if (!envDir)
     return;
   const manifest = await readManifest(envDir);
   if (typeof manifest === "string")
     return;
-  const relPath = relative6(envDir, flowAbsPath);
-  const entry = manifest.flows.find((f3) => f3.path === relPath);
+  const relPath = toPosix(relative8(envDir, flowAbsPath));
+  const entry = manifest.flows.find((f3) => toPosix(f3.path) === relPath);
   if (!entry)
     return;
   return {
@@ -355143,14 +355647,14 @@ async function runWebFlow({
 
 // src/shell/embeddedWorkerCli.ts
 import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
-import { basename as basename6, join as join36 } from "node:path";
+import { basename as basename7, join as join38 } from "node:path";
 var embeddedCliPathEnv = "QAWOLF_EMBEDDED_CLI_PATH";
 function extractEmbeddedWorkerCli() {
   const assetPath = process.env[embeddedCliPathEnv];
   if (assetPath === undefined || assetPath === "")
     return;
-  const dir = join36(getDataDir(), "worker");
-  const dest = join36(dir, basename6(assetPath));
+  const dir = join38(getDataDir(), "worker");
+  const dest = join38(dir, basename7(assetPath));
   if (existsSync3(dest))
     return dest;
   mkdirSync3(dir, { recursive: true });
@@ -355388,7 +355892,7 @@ ${styleText3("dim", "─".repeat(width))}
   };
 }
 // src/shell/reporter/createJUnitReporter.ts
-import { join as join37 } from "node:path";
+import { join as join39 } from "node:path";
 
 // src/shell/reporter/junitXml.ts
 function escapeXml(str) {
@@ -355427,7 +355931,7 @@ ${suites}`;
 
 // src/shell/reporter/createJUnitReporter.ts
 function resolveJUnitOutputPath(junit, outputDir) {
-  return typeof junit === "string" && junit.trim() !== "" ? junit : join37(outputDir, "junit-report.xml");
+  return typeof junit === "string" && junit.trim() !== "" ? junit : join39(outputDir, "junit-report.xml");
 }
 function createJUnitReporter(deps) {
   const flows = [];
@@ -355518,11 +356022,11 @@ function buildFlowsRunDeps(args) {
 
 // src/commands/flows/loadEnvFile.ts
 import { readFile } from "node:fs/promises";
-import { join as join38 } from "node:path";
+import { join as join40 } from "node:path";
 async function loadEnvFile(envDir) {
   let content;
   try {
-    content = await readFile(join38(envDir, ".env"), "utf8");
+    content = await readFile(join40(envDir, ".env"), "utf8");
   } catch (err) {
     if (isNoEntError(err))
       return;
@@ -355567,7 +356071,7 @@ async function runStagedFlows(args) {
     for (const candidate of staged.outerHop.rejected) {
       log31.debug(runnerMessages.outerHopCandidateRejected(candidate.dir, candidate.missing));
     }
-    const ownModules = projectDir === undefined ? undefined : join39(projectDir, "node_modules");
+    const ownModules = projectDir === undefined ? undefined : join41(projectDir, "node_modules");
     const own = staged.outerHop.rejected.find((c3) => c3.dir === ownModules);
     if (own !== undefined) {
       ctx.ui.warn(runnerMessages.outerHopFallbackNotice(own.dir, own.missing));
@@ -355613,7 +356117,7 @@ function makeDefaultDeps2(fs9) {
     flowsRun
   };
 }
-async function handleFlowsRun(ctx, pattern, flags, deps) {
+async function handleFlowsRun(ctx, pattern, flags, deps, selectors = { tags: [] }, allEnvs = false) {
   const resolvedDeps = deps ?? makeDefaultDeps2(ctx.fs);
   const cwd = process.cwd();
   const expandedFiles = await resolvedDeps.expandPatterns(buildPatternArgs(pattern), cwd, ctx.log("flows"));
@@ -355625,20 +356129,133 @@ async function handleFlowsRun(ctx, pattern, flags, deps) {
       notice: runnerMessages.noFlowsMatched
     });
   }
+  const selected = await selectRunByTag({
+    files: expandedFiles,
+    selectors,
+    readCachedTags: (files) => readCachedTags(files, ctx.fs),
+    chooseEnv: (files) => chooseEnv(ctx, files, allEnvs),
+    noMatch: (error51) => noMatchResult(ctx, {
+      allowNoMatch: flags.allowNoMatch,
+      error: error51,
+      notice: runnerMessages.noFlowsMatched
+    })
+  });
+  if (!selected.ok)
+    return selected.result;
   return runStagedFlows({
     ctx,
-    files: expandedFiles,
+    files: selected.files,
     flags,
     deps: resolvedDeps
   });
 }
+async function chooseEnv(ctx, files, allEnvs) {
+  const choice = await resolveEnvChoice({
+    files,
+    allEnvs,
+    mode: ctx.ui.mode,
+    select: ctx.ui.select,
+    readLabel: (dir) => readEnvLabel(dir, ctx.fs)
+  });
+  if (choice.kind === "proceed")
+    return { proceed: choice.files };
+  if (choice.kind === "cancelled") {
+    ctx.ui.info(environmentsMessages.aborted);
+    return { stop: undefined };
+  }
+  return { stop: { error: choice.error, exitCode: exitCodes.invalidArgs } };
+}
+
+// src/commands/flows/hybridRunDefaults.ts
+import { join as join42, resolve as resolve10 } from "node:path";
+
+// src/core/selectFlowFiles.ts
+function selectFlowFiles(args) {
+  if (!hasSelectors(args.selectors)) {
+    return { kind: "selected", files: [...args.files] };
+  }
+  const matched = args.files.filter((file2) => matchesSelectors({ tags: args.tagsByPath?.get(toRepoRelativePath(file2, args.cwd)) }, args.selectors));
+  if (matched.length === 0)
+    return { kind: "empty" };
+  return { kind: "selected", files: matched };
+}
+
+// src/domains/flows/applyFlowSelectors.ts
+async function applyFlowSelectors(args) {
+  if (!hasSelectors(args.selectors)) {
+    return { ok: true, files: [...args.files] };
+  }
+  const resolution = await args.resolveTags();
+  if (resolution.kind === "unavailable") {
+    return { ok: false, result: tagsUnavailableResult(args.envId) };
+  }
+  if (resolution.kind === "cached") {
+    args.warn(flowsMessages.selectors.usingCachedTags(resolution.fetchedAt));
+  }
+  const selection = selectFlowFiles({
+    files: args.files,
+    cwd: args.cwd,
+    selectors: args.selectors,
+    tagsByPath: resolution.byPath
+  });
+  if (selection.kind === "selected") {
+    return { ok: true, files: selection.files };
+  }
+  return {
+    ok: false,
+    result: args.onEmpty(explainEmptySelection(args.selectors, await args.fetchKnownTags()))
+  };
+}
+
+// src/domains/flows/resolveTags.ts
+async function fetchLive(ctx, envId) {
+  try {
+    const result = await ctx.platformClient.callPublicApi(publicContractsV1.flow.list, { environmentId: envId, includeDrafts: true });
+    if (!result.ok)
+      return;
+    return new Map(result.value.flows.map((f3) => [f3.path, f3.tags]));
+  } catch {
+    return;
+  }
+}
+async function readCache(envDir, fs9) {
+  const manifest = await readManifest(envDir, fs9);
+  if (typeof manifest === "string")
+    return;
+  if (manifest.tagsFetchedAt === undefined)
+    return;
+  const byPath = new Map;
+  for (const flow of manifest.flows) {
+    if (flow.tags !== undefined)
+      byPath.set(toPosix(flow.path), flow.tags);
+  }
+  return { byPath, fetchedAt: manifest.tagsFetchedAt };
+}
+async function resolveTags(ctx, envId, envDir, fs9 = makeDefaultFs()) {
+  const live = await fetchLive(ctx, envId);
+  if (live)
+    return { kind: "live", byPath: live };
+  const cached2 = await readCache(envDir, fs9);
+  if (cached2) {
+    return {
+      kind: "cached",
+      byPath: cached2.byPath,
+      fetchedAt: cached2.fetchedAt
+    };
+  }
+  return { kind: "unavailable" };
+}
 
 // src/commands/flows/hybridRunDefaults.ts
-import { join as join40, resolve as resolve10 } from "node:path";
 function makeDefaultHybridDeps(fs9) {
   return {
     expandPatterns: (patterns, cwd, logger) => expandPatterns(patterns, cwd, logger, fs9),
-    pullEnv: (ctx, envId) => handleFlowsPull(ctx, { env: envId, yes: true }),
+    pullEnv: (ctx, envId, identity) => handleFlowsPull(ctx, {
+      env: envId,
+      yes: true,
+      envSlug: identity.slug,
+      envName: identity.name
+    }),
     resolveDepsRoot: (args) => resolveDepsRoot({ ...args, fs: fs9 }),
     prepareRunDir: (args) => prepareRunDir({ ...args, fs: fs9 }),
     configureTestkit,
@@ -355647,18 +356264,20 @@ function makeDefaultHybridDeps(fs9) {
     createFlowRuntimeDeps
   };
 }
-async function handleHybridFlowsRun(ctx, pattern, flags, deps) {
-  const resolvedDeps = deps ?? makeDefaultHybridDeps(ctx.fs);
+async function handleHybridFlowsRun(ctx, pattern, flags, options = {}) {
+  const identity = options.identity ?? { slug: undefined, name: undefined };
+  const selectors = options.selectors ?? { tags: [] };
+  const resolvedDeps = options.deps ?? makeDefaultHybridDeps(ctx.fs);
   const validation = validateEnvId(flags.env);
   if (validation !== "ok") {
     return { error: validation.error, exitCode: 2 };
   }
-  const envDir = resolve10(join40(".qawolf", flags.env));
+  const envDir = resolve10(join42(".qawolf", flags.env));
   const patternArgs = buildPatternArgs(pattern);
   const globFlows = () => resolvedDeps.expandPatterns(patternArgs, envDir, ctx.log("flows"));
   let files = await globFlows();
   if (files.length === 0) {
-    const pullResult = await resolvedDeps.pullEnv(ctx, flags.env);
+    const pullResult = await resolvedDeps.pullEnv(ctx, flags.env, identity);
     if (pullResult !== undefined)
       return pullResult;
     files = await globFlows();
@@ -355670,36 +356289,73 @@ async function handleHybridFlowsRun(ctx, pattern, flags, deps) {
       });
     }
   }
-  return runStagedFlows({ ctx, files, flags, envDir, deps: resolvedDeps });
+  const selection = await applyFlowSelectors({
+    files,
+    cwd: envDir,
+    selectors,
+    envId: flags.env,
+    warn: (message) => ctx.ui.warn(message),
+    resolveTags: () => resolveTags(ctx, flags.env, envDir, ctx.fs),
+    fetchKnownTags: () => fetchKnownTags(ctx),
+    onEmpty: (error51) => noMatchResult(ctx, {
+      allowNoMatch: flags.allowNoMatch,
+      error: error51,
+      notice: runnerMessages.noFlowsMatched
+    })
+  });
+  if (!selection.ok)
+    return selection.result;
+  return runStagedFlows({
+    ctx,
+    files: selection.files,
+    flags,
+    envDir,
+    deps: resolvedDeps
+  });
+}
+
+// src/commands/flows/runAction.ts
+function makeFlowsRunAction(signals) {
+  return (pattern, opts, command) => {
+    const selectors = { tags: opts.tag };
+    const allEnvsWarning = allEnvsNoEffectWarning({
+      allEnvs: opts.allEnvs ?? false,
+      env: opts.env,
+      tags: opts.tag
+    });
+    if (opts.env !== undefined) {
+      return withResolvedEnv(signals, {
+        explicit: opts.env,
+        requiredMessage: flowsMessages.run.requiresEnv,
+        offlineFallback: async (explicit) => explicit === undefined ? undefined : (await findPulledEnv(explicit, process.cwd()))?.envId
+      }, (ctx, env3, identity) => {
+        if (allEnvsWarning !== undefined)
+          ctx.ui.warn(allEnvsWarning);
+        return handleHybridFlowsRun(ctx, pattern, { ...opts, env: env3 }, { identity, selectors });
+      })(opts, command);
+    }
+    return withContext(signals, (ctx) => {
+      if (allEnvsWarning !== undefined)
+        ctx.ui.warn(allEnvsWarning);
+      return handleFlowsRun(ctx, pattern, opts, undefined, selectors, opts.allEnvs);
+    })(opts, command);
+  };
 }
 
 // src/commands/flows/run.register.ts
-var videoModes = ["on", "off", "retain-on-failure"];
-var traceModes = ["on", "off", "retain-on-failure"];
-var harModes = ["on", "off", "retain-on-failure"];
-var harContentModes = ["full", "omit"];
-var videoDefault = "off";
-var traceDefault = "off";
-var harDefault = "off";
-var harContentDefault = "omit";
 var runExamples = `
 Examples:
   $ qawolf flows run
   $ qawolf flows run "flows/checkout/**"
   $ qawolf flows run --retries 2 --video retain-on-failure
+  $ qawolf flows run --tag auth
+  $ qawolf flows run --tag auth --env staging
   $ qawolf flows run checkout --env staging --headed`;
 function registerFlowsRunCommand(flows, signals) {
-  declareCommandKind(flows.command("run [pattern]"), "local", {
+  const command = declareCommandKind(flows.command("run [pattern]"), "local", {
     kindNote: "read with --env"
-  }).description("Run flows matching [pattern], or every flow when omitted; with --env, pull missing flows from that QA Wolf environment").option("--retries <n>", "Retry each failing flow up to this many times", parseInteger("--retries", { min: 0 }), 0).option("--bail", "Stop the run after the first failure", false).option("--workers <n>", "Parallel worker count for web flows", parseInteger("--workers", { min: 1 }), 1).option("--timeout <ms>", "Default timeout for actions and assertions, in milliseconds", parseInteger("--timeout", { min: 0 }), 30000).option("--video <mode>", "Record video: on | off | retain-on-failure", parseEnum("--video", videoModes), videoDefault).option("--trace <mode>", "Record Playwright trace: on | off | retain-on-failure", parseEnum("--trace", traceModes), traceDefault).option("--har <mode>", "Record HAR network log: on | off | retain-on-failure", parseEnum("--har", harModes), harDefault).option("--har-content <mode>", "HAR response bodies: omit | full (full uses more memory)", parseEnum("--har-content", harContentModes), harContentDefault).option("--output-dir <path>", "Directory for run artifacts (videos, traces, HAR)", defaultOutputDir).option("--junit [path]", "Write a JUnit XML report (default: <output-dir>/junit-report.xml)").option("--headed", "Show the browser window instead of headless", false).option("--env <env>", "Pull and run a flow from this environment (UUID or slug) if not cached locally").option("--deps <dir>", "Use this prepared dependency directory instead of auto-installing the runtime; or set QAWOLF_RUNTIME_DIR to relocate the managed runtime").option("--allow-no-match", "Exit 0 instead of 2 when the pattern selects no runnable flow", false).option("--no-browser-deps", "Skip installing OS-level browser dependencies (Linux --with-deps, which needs root); requires the system libraries to already be present").addHelpText("after", runExamples).action((pattern, opts, command) => {
-    if (opts.env !== undefined) {
-      return withResolvedEnv(signals, {
-        explicit: opts.env,
-        requiredMessage: flowsMessages.run.requiresEnv
-      }, (ctx, env3) => handleHybridFlowsRun(ctx, pattern, { ...opts, env: env3 }))(opts, command);
-    }
-    return withContext(signals, (ctx) => handleFlowsRun(ctx, pattern, opts))(opts, command);
-  });
+  }).description("Run flows matching [pattern], or every flow when omitted; with --env, pull missing flows from that QA Wolf environment").option("--retries <n>", "Retry each failing flow up to this many times", parseInteger("--retries", { min: 0 }), 0).option("--bail", "Stop the run after the first failure", false).option("--workers <n>", "Parallel worker count for web flows", parseInteger("--workers", { min: 1 }), 1).option("--timeout <ms>", "Default timeout for actions and assertions, in milliseconds", parseInteger("--timeout", { min: 0 }), 30000);
+  addRunArtifactOptions(command).option("--headed", "Show the browser window instead of headless", false).option("--env <env>", "Pull and run a flow from this environment (UUID or slug) if not cached locally").option("--deps <dir>", "Use this prepared dependency directory instead of auto-installing the runtime; or set QAWOLF_RUNTIME_DIR to relocate the managed runtime").option("--allow-no-match", "Exit 0 instead of 2 when the pattern selects no runnable flow", false).option("--no-browser-deps", "Skip installing OS-level browser dependencies (Linux --with-deps, which needs root); requires the system libraries to already be present").option("--tag <name>", "Only run flows carrying this tag; repeat for several. Without --env, matches against tags cached by the last pull", collectValue, []).option("--all-envs", "When a tag matches flows in several pulled environments, run every match instead of choosing one", false).addHelpText("after", runExamples).action(makeFlowsRunAction(signals));
 }
 
 // src/domains/runner/executeWorkerFlow.ts
@@ -355772,6 +356428,9 @@ Examples:
   $ qawolf flows list
   $ qawolf flows list "flows/checkout/**"
   $ qawolf flows list --remote --env staging
+  $ qawolf flows list --tag auth
+  $ qawolf flows list --env staging --tag auth
+  $ qawolf flows list --remote --env staging --tag auth --tag smoke
   $ qawolf flows list "**/checkout/**" --remote --env staging --include-drafts`;
 function registerFlowsCommand(program2, signals) {
   const flows = program2.command("flows").description("Manage and run QA Wolf flows");
@@ -355779,33 +356438,35 @@ 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 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 (with --remote; defaults to QAWOLF_ENVIRONMENT, or an interactive picker)").option("--include-drafts", "Include draft flows in the listing (requires --remote)", 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: a QA Wolf environment with --remote, otherwise a pulled one by slug or id").option("--include-drafts", "Include draft flows in the listing (requires --remote)", false).option("--tag <name>", "Only list flows carrying this tag; repeat for several. Without --remote, matches against tags cached by the last pull", collectValue, []).addHelpText("after", listExamples).action((pattern, opts, command) => {
+    const tags = opts.tag;
     if (opts.remote) {
       return withResolvedEnv(signals, {
         explicit: opts.env,
         requiredMessage: flowsMessages.list.remoteRequiresEnv
       }, (ctx, env3) => flowsListRemote(ctx, pattern, {
         env: env3,
-        includeDrafts: opts.includeDrafts
+        includeDrafts: opts.includeDrafts,
+        tags
       }))(opts, command);
     }
-    if (opts.env !== undefined || opts.includeDrafts) {
+    if (opts.includeDrafts) {
       return withContext(signals, async () => ({
-        error: flowsMessages.list.flagsRequireRemote
+        error: flowsMessages.list.draftsRequireRemote
       }))(opts, command);
     }
-    return withContext(signals, (ctx) => handleFlowsList(ctx, pattern))(opts, command);
+    return withContext(signals, (ctx) => handleFlowsList(ctx, pattern, { tags, env: opts.env }))(opts, command);
   });
   registerFlowsPullCommand(flows, signals);
 }
 
 // src/domains/init/init.ts
-import { dirname as dirname14, join as join42, relative as relative7 } from "node:path";
+import { dirname as dirname14, join as join44, relative as relative9 } from "node:path";
 
 // src/domains/init/ensurePackageJson.ts
-import { join as join41 } from "node:path";
+import { join as join43 } from "node:path";
 async function ensurePackageJson(ctx, yes, deps) {
-  const pkgPath = join41(deps.cwd, "package.json");
+  const pkgPath = join43(deps.cwd, "package.json");
   if (!await deps.fs.pathExists(pkgPath)) {
     const confirmed2 = await ctx.ui.confirm(initMessages.createPackageJsonPrompt, { yes });
     if (!confirmed2.ok || !confirmed2.value) {
@@ -355931,9 +356592,9 @@ function makeDefaultInitDeps() {
 async function handleInit(ctx, opts, deps = makeDefaultInitDeps()) {
   ctx.ui.gap();
   ctx.ui.intro(initMessages.title);
-  const configPath = join42(deps.cwd, "qawolf.config.ts");
-  const flowPath = join42(deps.cwd, "src", "flows", "example.flow.ts");
-  const gitignorePath = join42(deps.cwd, ".qawolf", ".gitignore");
+  const configPath = join44(deps.cwd, "qawolf.config.ts");
+  const flowPath = join44(deps.cwd, "src", "flows", "example.flow.ts");
+  const gitignorePath = join44(deps.cwd, ".qawolf", ".gitignore");
   await writeWithPrompt(ctx, configPath, qawolfConfigTs, opts.yes, deps);
   await writeWithPrompt(ctx, flowPath, exampleFlowTs, opts.yes, deps);
   await writeWithPrompt(ctx, gitignorePath, qawolfGitignore, opts.yes, deps);
@@ -355941,7 +356602,7 @@ async function handleInit(ctx, opts, deps = makeDefaultInitDeps()) {
   ctx.ui.outro(initMessages.outro);
 }
 async function writeWithPrompt(ctx, filePath, content, yes, deps) {
-  const relPath = relative7(deps.cwd, filePath);
+  const relPath = relative9(deps.cwd, filePath);
   if (await deps.fs.pathExists(filePath)) {
     const confirmed = await ctx.ui.confirm(initMessages.overwritePrompt(relPath), {
       yes,
@@ -355971,7 +356632,7 @@ Examples:
 import { parseExecutionTarget as parseExecutionTarget4 } from "@qawolf/flow-targets";
 
 // src/domains/install/android/avd.ts
-import { join as join43 } from "node:path";
+import { join as join45 } from "node:path";
 async function installAvds(ctx, specs, deps) {
   const sdkManagerPath = sdkManagerBin(deps.androidHome, deps.platform);
   const avdManagerPath = avdManagerBin(deps.androidHome, deps.platform);
@@ -355981,7 +356642,7 @@ async function installAvds(ctx, specs, deps) {
   if (versionResult.exitCode !== 0) {
     throw new Error(installMessages.android.sdkmanagerNotFound(sdkManagerPath));
   }
-  const licenseFile = join43(deps.androidHome, "licenses", "android-sdk-license");
+  const licenseFile = join45(deps.androidHome, "licenses", "android-sdk-license");
   if (deps.checkExists(licenseFile)) {
     ctx.ui.info(installMessages.android.licensesAlreadyAccepted);
   } else {
@@ -355996,7 +356657,7 @@ async function installAvds(ctx, specs, deps) {
   for (const spec of specs) {
     if (installedImages.has(spec.systemImage))
       continue;
-    const systemImg = join43(deps.androidHome, ...spec.systemImage.split(";"), "system.img");
+    const systemImg = join45(deps.androidHome, ...spec.systemImage.split(";"), "system.img");
     if (deps.checkExists(systemImg)) {
       ctx.ui.info(installMessages.android.systemImageAlreadyInstalled(spec.systemImage));
       installedImages.add(spec.systemImage);
@@ -356882,7 +357543,7 @@ function describeFailure(failureReason) {
 }
 
 // src/shell/interactiveRunner/collectRunFiles.ts
-import { join as join45 } from "node:path";
+import { join as join47 } from "node:path";
 
 // src/core/interactiveRunner/getImports.ts
 function getImports(options) {
@@ -356921,7 +357582,7 @@ function isPathAlias(importPath, paths) {
 }
 
 // src/core/interactiveRunner/resolveImportPath.ts
-import { dirname as dirname15, join as join44, normalize as normalize3 } from "node:path/posix";
+import { dirname as dirname15, join as join46, normalize as normalize4 } from "node:path/posix";
 
 // src/core/interactiveRunner/tsconfigPaths.ts
 function isRecord5(value) {
@@ -356974,7 +357635,7 @@ function candidatesForExplicitExtension(options) {
 }
 function resolveImportPath(options) {
   const aliasTarget = resolvePathAlias(options.importPath, options.tsconfigPaths);
-  const resolvedPath = aliasTarget === undefined ? normalize3(join44(dirname15(options.importingFilePath), options.importPath)) : normalize3(aliasTarget);
+  const resolvedPath = aliasTarget === undefined ? normalize4(join46(dirname15(options.importingFilePath), options.importPath)) : normalize4(aliasTarget);
   const hasExplicitExtension = supportedExtensions.some((extension) => options.importPath.endsWith(extension));
   const candidates = hasExplicitExtension ? candidatesForExplicitExtension({
     importPath: options.importPath,
@@ -356998,7 +357659,7 @@ function resolveImportPath(options) {
 var tsconfigPath = "tsconfig.json";
 async function collectRunFiles(options) {
   const held = await listShippablePaths(options);
-  const readFile2 = (path9) => options.fs.readFile(join45(options.cwd, path9));
+  const readFile2 = (path9) => options.fs.readFile(join47(options.cwd, path9));
   const tsconfigContent = held.has(tsconfigPath) ? await readFile2(tsconfigPath).catch(() => {
     return;
   }) : undefined;
@@ -357081,7 +357742,7 @@ function makeRunnerId() {
 }
 
 // src/shell/interactiveRunner/runFilesManifest.ts
-import { join as join46 } from "node:path";
+import { join as join48 } from "node:path";
 var manifestFileName = "runner-files.json";
 var manifestSchema2 = exports_external.object({
   files: exports_external.array(exports_external.object({ contentHash: exports_external.string(), path: exports_external.string() })),
@@ -357089,8 +357750,8 @@ var manifestSchema2 = exports_external.object({
   version: exports_external.literal(1)
 });
 function makeRunFilesManifestStore(options) {
-  const directory = join46(options.cwd, qawolfDir);
-  const path9 = join46(directory, manifestFileName);
+  const directory = join48(options.cwd, qawolfDir);
+  const path9 = join48(directory, manifestFileName);
   let pendingWrites = 0;
   return {
     async read() {
@@ -357120,7 +357781,7 @@ function parseJson(text3) {
 }
 
 // src/shell/interactiveRunner/runnerStore.ts
-import { join as join47 } from "node:path";
+import { join as join49 } from "node:path";
 var storeFileName = "runner.json";
 var runnersDirName = "runners";
 var storedRunnerSchema = exports_external.object({
@@ -357139,11 +357800,11 @@ function parseJson2(text3) {
 }
 var pendingWrites = 0;
 function makeRunnerStore(options) {
-  const directory = join47(options.cwd, qawolfDir);
-  const path9 = join47(directory, storeFileName);
-  const runnersDir = join47(directory, runnersDirName);
+  const directory = join49(options.cwd, qawolfDir);
+  const path9 = join49(directory, storeFileName);
+  const runnersDir = join49(directory, runnersDirName);
   const nextPendingPath = (target) => `${target}.${process.pid}.${++pendingWrites}.tmp`;
-  const runnerPath = (runnerId) => join47(runnersDir, `${encodeURIComponent(runnerId)}.json`);
+  const runnerPath = (runnerId) => join49(runnersDir, `${encodeURIComponent(runnerId)}.json`);
   const writeAtomically = async (target, contents2) => {
     const pendingPath = nextPendingPath(target);
     await options.fs.writeFile(pendingPath, `${JSON.stringify(contents2, undefined, 2)}
@@ -357180,7 +357841,7 @@ function makeRunnerStore(options) {
     readDefaultRunnerId,
     async readRunners() {
       const runners = await Promise.all((await readRunnerFileNames()).map(async (name) => {
-        const contents2 = await options.fs.readFile(join47(runnersDir, name)).catch(() => {
+        const contents2 = await options.fs.readFile(join49(runnersDir, name)).catch(() => {
           return;
         });
         if (contents2 === undefined)
@@ -357199,7 +357860,7 @@ function makeRunnerStore(options) {
       await Promise.all(runnerIds.map((runnerId) => options.fs.rm(runnerPath(runnerId), { force: true })));
       const names = await readRunnerFileNames();
       await Promise.all(names.map(async (name) => {
-        const runnerFile = join47(runnersDir, name);
+        const runnerFile = join49(runnersDir, name);
         const contents2 = await options.fs.readFile(runnerFile).catch(() => {
           return;
         });
@@ -357283,7 +357944,7 @@ function registerRunnerHighlightSelectorCommand(runner, signals) {
 }
 
 // src/domains/interactiveRunner/importPackage.ts
-import { join as join48 } from "node:path";
+import { join as join50 } from "node:path";
 
 // src/core/interactiveRunner/npmDependencies.ts
 var sectionsInPrecedenceOrder = ["dependencies", "devDependencies"];
@@ -357324,7 +357985,7 @@ function readNpmDependencies(packageJsonContent) {
 // src/domains/interactiveRunner/importPackage.ts
 var defaultPackageVersion = "latest";
 async function handleRunnerImportPackage(ctx, options, deps) {
-  const content = await deps.readFile(join48(deps.cwd, runPackageJsonPath)).catch(() => {
+  const content = await deps.readFile(join50(deps.cwd, runPackageJsonPath)).catch(() => {
     return;
   });
   if (content === undefined) {
@@ -357662,10 +358323,10 @@ function registerRunnerInspectCommands(runner, signals) {
 }
 
 // src/core/interactiveRunner/runFiles.ts
-import { isAbsolute as isAbsolute5, relative as relative8, resolve as resolve11, sep as sep5 } from "node:path";
+import { isAbsolute as isAbsolute5, relative as relative10, resolve as resolve11, sep as sep5 } from "node:path";
 function toCollectedPath(cwd, path9) {
   const absolute = isAbsolute5(path9) ? path9 : resolve11(cwd, path9);
-  return relative8(cwd, absolute).split(sep5).join("/");
+  return relative10(cwd, absolute).split(sep5).join("/");
 }
 var namedLargestFileCount = 3;
 function largestFiles(files) {
@@ -358106,7 +358767,7 @@ async function handleRunnerLaunch(ctx, options, deps) {
 }
 
 // src/domains/interactiveRunner/list.ts
-var columns2 = [
+var columns = [
   { header: "id", value: (row) => row.id },
   { header: "family", value: (row) => row.runnerName ?? "" },
   { header: "default", value: (row) => row.isDefault ? "yes" : "" }
@@ -358164,12 +358825,12 @@ async function handleRunnerList(ctx, deps) {
     return;
   }
   if (ctx.ui.mode === "agent") {
-    ctx.ui.write(renderTable({ boldHeader: false, columns: columns2, rows: items }));
+    ctx.ui.write(renderTable({ boldHeader: false, columns, rows: items }));
     return;
   }
   ctx.ui.gap();
   ctx.ui.intro(interactiveRunnerMessages.title);
-  ctx.ui.write(renderTable({ boldHeader: true, columns: columns2, rows: items }));
+  ctx.ui.write(renderTable({ boldHeader: true, columns, rows: items }));
   ctx.ui.outro(interactiveRunnerMessages.runnerCount(items.length));
 }
 
@@ -359030,4 +359691,4 @@ createProgram({ signals }).parseAsync().catch(() => {
     process.exitCode = 1;
 }).finally(() => flushAndExit(typeof process.exitCode === "number" ? process.exitCode : 0));
 
-//# debugId=3E751EC68D3A12B564756E2164756E21
+//# debugId=50C554904C1768A664756E2164756E21