@speedkit/cli 4.27.0 → 4.27.2

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [4.27.2](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v4.27.1...v4.27.2) (2026-09-11)
+
+
+### Bug Fixes
+
+* query define awsCatalog via --catalog, disable spinners while CI or not a tty ([e949dbb](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/e949dbbaf73521267e03c4c043b393e76e174ece))
+
+## [4.27.1](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v4.27.0...v4.27.1) (2026-09-11)
+
+
+### Bug Fixes
+
+* transfer flags from query:prewarm to auto-prewarm ([0dc4179](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/0dc41795018edd86fdad4215e66218be28b91654))
+
 # [4.27.0](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v4.26.0...v4.27.0) (2026-09-11)
 
 

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @speedkit/cli
 $ sk COMMAND
 running command...
 $ sk (--version)
-@speedkit/cli/4.27.0 linux-x64 node-v22.23.2
+@speedkit/cli/4.27.2 linux-x64 node-v22.23.2
 $ sk --help [COMMAND]
 USAGE
   $ sk COMMAND
@@ -103,9 +103,10 @@ Build and execute the prewarm query for a customer config and start a prewarm jo
 
 ```
 USAGE
-  $ sk auto-prewarm CUSTOMERPATH [-c <value>] [-d <value>] [--excludeNoindex] [--excludeSuspicious] [--explain]
-    [--hardNavigationsOnly] [--match <value>...] [-p <value> | [--device desktop|mobile|tablet... | -v <value>...] | ]
-    [-k] [-q] [--verbose]
+  $ sk auto-prewarm CUSTOMERPATH [--catalog <value>] [--workgroup <value>] [-c <value>] [-d <value>]
+    [--excludeNoindex] [--excludeSuspicious] [--explain] [--hardNavigationsOnly] [--excludeNotFound] [--limit <value>]
+    [--match <value>...] [--minHits <value>] [-p <value> | [--device desktop|mobile|tablet... | -v <value>...] | ] [-k]
+    [-q] [--verbose]
 
 ARGUMENTS
   CUSTOMERPATH  The customer config path
@@ -118,18 +119,25 @@ FLAGS
   -q, --quiet                  less output non interactive
   -v, --variation=<value>...   Pair every url of the list with each of these variations. For the custom variations no
                                traffic can reveal, e.g. 'desktop-pdp-a,mobile-pdp-a'
+      --catalog=<value>        [default: live, env: SK_ATHENA_CATALOG] Athena data catalog holding the rum tables. Names
+                               the catalog both in the query and in the context it runs in, so the two always agree
       --device=<option>...     Split the list by device class, so every url is warmed in the variations it was actually
                                requested in. A class not named is left out
                                <options: desktop|mobile|tablet>
       --excludeNoindex         Exclude page impressions of pages marked noindex
+      --excludeNotFound        Leave out urls the origin answers with a 404 more often than not
       --excludeSuspicious      Exclude page impressions Speed Kit classified as suspicious
       --explain                Account for every rule the query leaves out, reduces or approximates
       --hardNavigationsOnly    Exclude soft (SPA) navigations
+      --limit=<value>          Keep only the most requested urls
       --match=<value>...       Keep only urls whose path matches this regular expression, e.g. '^/p/'. The path is
                                matched with its query string, the way a version 1 pathname rule matches it, so
                                '[?&]size=' works too. Repeat the flag to keep the urls matching any of several patterns,
                                and start a pattern with (?i) to match case-insensitively
+      --minHits=<value>        Keep only urls requested at least this often in the window
       --verbose                Log information about failed requests
+      --workgroup=<value>      [env: SK_ATHENA_WORKGROUP] Athena workgroup to run the query in, e.g. 'prewarming'.
+                               Defaults to the account's default workgroup
 
 DESCRIPTION
   Build and execute the prewarm query for a customer config and start a prewarm job from the resulting URLs — no CSV
@@ -143,6 +151,10 @@ EXAMPLES
   $ sk auto-prewarm customers/decathlon.de --device desktop,mobile
 
   $ sk auto-prewarm customers/decathlon.de -v MOBILE,DESKTOP
+
+  $ sk auto-prewarm customers/decathlon.de --limit 5000 --minHits 5
+
+  $ sk auto-prewarm customers/decathlon.de --workgroup prewarming
 ```
 
 ## `sk autocomplete [SHELL]`
@@ -252,8 +264,9 @@ Build a parameter query that can be executed in Athena
 
 ```
 USAGE
-  $ sk build-parameter-query CUSTOMERPATH [-c <value>] [-d <value>] [--excludeNoindex] [--excludeSuspicious] [--explain]
-    [--hardNavigationsOnly] [-e] [-q] [--bySet] [--minImpressions <value>]
+  $ sk build-parameter-query CUSTOMERPATH [--catalog <value>] [--workgroup <value>] [-c <value>] [-d <value>]
+    [--excludeNoindex] [--excludeSuspicious] [--explain] [--hardNavigationsOnly] [-e] [-q] [--bySet] [--minImpressions
+    <value>]
 
 ARGUMENTS
   CUSTOMERPATH  The customer config path
@@ -265,11 +278,16 @@ FLAGS
   -q, --quiet                   Output only the raw query without clipboard copy or styling
       --bySet                   Rank whole sets of parameters instead of single parameters, to see which ones travel
                                 together
+      --catalog=<value>         [default: live, env: SK_ATHENA_CATALOG] Athena data catalog holding the rum tables.
+                                Names the catalog both in the query and in the context it runs in, so the two always
+                                agree
       --excludeNoindex          Exclude page impressions of pages marked noindex
       --excludeSuspicious       Exclude page impressions Speed Kit classified as suspicious
       --explain                 Account for every rule the query leaves out, reduces or approximates
       --hardNavigationsOnly     Exclude soft (SPA) navigations
       --minImpressions=<value>  Leave out parameters seen on fewer page impressions than this
+      --workgroup=<value>       [env: SK_ATHENA_WORKGROUP] Athena workgroup to run the query in, e.g. 'prewarming'.
+                                Defaults to the account's default workgroup
 
 DESCRIPTION
   Build a parameter query that can be executed in Athena
@@ -291,9 +309,9 @@ Build a prewarm query that can be executed in Athena
 
 ```
 USAGE
-  $ sk build-prewarm-query CUSTOMERPATH [-c <value>] [-d <value>] [--excludeNoindex] [--excludeSuspicious] [--explain]
-    [--hardNavigationsOnly] [-q] [--device desktop|mobile|tablet... | -v <value>...] [--count | -e] [--excludeNotFound]
-    [--limit <value>] [--match <value>...] [--minHits <value>]
+  $ sk build-prewarm-query CUSTOMERPATH [--catalog <value>] [--workgroup <value>] [-c <value>] [-d <value>]
+    [--excludeNoindex] [--excludeSuspicious] [--explain] [--hardNavigationsOnly] [-q] [--device desktop|mobile|tablet...
+    | -v <value>...] [--excludeNotFound] [--limit <value>] [--match <value>...] [--minHits <value>] [--count | -e]
 
 ARGUMENTS
   CUSTOMERPATH  The customer config path
@@ -305,6 +323,8 @@ FLAGS
   -q, --quiet                 Output only the raw query without clipboard copy or styling
   -v, --variation=<value>...  Pair every url of the list with each of these variations. For the custom variations no
                               traffic can reveal, e.g. 'desktop-pdp-a,mobile-pdp-a'
+      --catalog=<value>       [default: live, env: SK_ATHENA_CATALOG] Athena data catalog holding the rum tables. Names
+                              the catalog both in the query and in the context it runs in, so the two always agree
       --count                 Run the query and report how large the list is instead of what is in it: urls, the
                               impressions they stand for, and a row per variation where the list carries variations.
                               Every other flag still applies, so this counts the list the same command would produce
@@ -322,6 +342,8 @@ FLAGS
                               '[?&]size=' works too. Repeat the flag to keep the urls matching any of several patterns,
                               and start a pattern with (?i) to match case-insensitively
       --minHits=<value>       Keep only urls requested at least this often in the window
+      --workgroup=<value>     [env: SK_ATHENA_WORKGROUP] Athena workgroup to run the query in, e.g. 'prewarming'.
+                              Defaults to the account's default workgroup
 
 DESCRIPTION
   Build a prewarm query that can be executed in Athena
@@ -825,8 +847,9 @@ Build a parameter query that can be executed in Athena
 
 ```
 USAGE
-  $ sk query parameter CUSTOMERPATH [-c <value>] [-d <value>] [--excludeNoindex] [--excludeSuspicious] [--explain]
-    [--hardNavigationsOnly] [-e] [-q] [--bySet] [--minImpressions <value>]
+  $ sk query parameter CUSTOMERPATH [--catalog <value>] [--workgroup <value>] [-c <value>] [-d <value>]
+    [--excludeNoindex] [--excludeSuspicious] [--explain] [--hardNavigationsOnly] [-e] [-q] [--bySet] [--minImpressions
+    <value>]
 
 ARGUMENTS
   CUSTOMERPATH  The customer config path
@@ -838,11 +861,16 @@ FLAGS
   -q, --quiet                   Output only the raw query without clipboard copy or styling
       --bySet                   Rank whole sets of parameters instead of single parameters, to see which ones travel
                                 together
+      --catalog=<value>         [default: live, env: SK_ATHENA_CATALOG] Athena data catalog holding the rum tables.
+                                Names the catalog both in the query and in the context it runs in, so the two always
+                                agree
       --excludeNoindex          Exclude page impressions of pages marked noindex
       --excludeSuspicious       Exclude page impressions Speed Kit classified as suspicious
       --explain                 Account for every rule the query leaves out, reduces or approximates
       --hardNavigationsOnly     Exclude soft (SPA) navigations
       --minImpressions=<value>  Leave out parameters seen on fewer page impressions than this
+      --workgroup=<value>       [env: SK_ATHENA_WORKGROUP] Athena workgroup to run the query in, e.g. 'prewarming'.
+                                Defaults to the account's default workgroup
 
 DESCRIPTION
   Build a parameter query that can be executed in Athena
@@ -864,9 +892,9 @@ Build a prewarm query that can be executed in Athena
 
 ```
 USAGE
-  $ sk query prewarm CUSTOMERPATH [-c <value>] [-d <value>] [--excludeNoindex] [--excludeSuspicious] [--explain]
-    [--hardNavigationsOnly] [-q] [--device desktop|mobile|tablet... | -v <value>...] [--count | -e] [--excludeNotFound]
-    [--limit <value>] [--match <value>...] [--minHits <value>]
+  $ sk query prewarm CUSTOMERPATH [--catalog <value>] [--workgroup <value>] [-c <value>] [-d <value>]
+    [--excludeNoindex] [--excludeSuspicious] [--explain] [--hardNavigationsOnly] [-q] [--device desktop|mobile|tablet...
+    | -v <value>...] [--excludeNotFound] [--limit <value>] [--match <value>...] [--minHits <value>] [--count | -e]
 
 ARGUMENTS
   CUSTOMERPATH  The customer config path
@@ -878,6 +906,8 @@ FLAGS
   -q, --quiet                 Output only the raw query without clipboard copy or styling
   -v, --variation=<value>...  Pair every url of the list with each of these variations. For the custom variations no
                               traffic can reveal, e.g. 'desktop-pdp-a,mobile-pdp-a'
+      --catalog=<value>       [default: live, env: SK_ATHENA_CATALOG] Athena data catalog holding the rum tables. Names
+                              the catalog both in the query and in the context it runs in, so the two always agree
       --count                 Run the query and report how large the list is instead of what is in it: urls, the
                               impressions they stand for, and a row per variation where the list carries variations.
                               Every other flag still applies, so this counts the list the same command would produce
@@ -895,6 +925,8 @@ FLAGS
                               '[?&]size=' works too. Repeat the flag to keep the urls matching any of several patterns,
                               and start a pattern with (?i) to match case-insensitively
       --minHits=<value>       Keep only urls requested at least this often in the window
+      --workgroup=<value>     [env: SK_ATHENA_WORKGROUP] Athena workgroup to run the query in, e.g. 'prewarming'.
+                              Defaults to the account's default workgroup
 
 DESCRIPTION
   Build a prewarm query that can be executed in Athena

package/dist/commands/auto-prewarm.d.ts

@@ -8,19 +8,24 @@ export default class AutoPrewarm extends Command {
     static description: string;
     static examples: string[];
     static flags: {
-        match: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
-        device: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
-        variation: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
         variationPath: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         keepParameterSorting: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        excludeNotFound: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        match: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        minHits: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        device: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        variation: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
         excludeNoindex: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         excludeSuspicious: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         explain: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         hardNavigationsOnly: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         days: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         configName: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        catalog: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        workgroup: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/auto-prewarm.js

@@ -1,5 +1,5 @@
 import { Command, Flags } from "@oclif/core";
-import { CLI_CONFIG_NAME, CLI_CUSTOMER_CONFIG, CLI_QUERY_DAYS, CLI_QUERY_FILTERS, CLI_QUERY_PREWARM, CLI_QUERY_VARIATIONS, CLIParameters, CLIParametersChar, CLIParametersExample, } from "../models/cli-parameters.js";
+import { CLI_ATHENA, CLI_CONFIG_NAME, CLI_CUSTOMER_CONFIG, CLI_QUERY_DAYS, CLI_QUERY_FILTERS, CLI_QUERY_PREWARM_LIST, CLIParameters, CLIParametersChar, CLIParametersExample, } from "../models/cli-parameters.js";
 import { CliConfig } from "../helpers/cli-config.js";
 import { AutoPreWarmFactory } from "../services/prewarm/index.js";
 export default class AutoPrewarm extends Command {
@@ -10,16 +10,20 @@ export default class AutoPrewarm extends Command {
         `$ sk auto-prewarm ${CLIParametersExample.CustomerPath} -${CLIParametersChar.ConfigName} ${CLIParametersExample.ConfigName}`,
         `$ sk auto-prewarm ${CLIParametersExample.CustomerPath} --${CLIParameters.Device} ${CLIParametersExample.Devices}`,
         `$ sk auto-prewarm ${CLIParametersExample.CustomerPath} -${CLIParametersChar.Variation} ${CLIParametersExample.Variations}`,
+        `$ sk auto-prewarm ${CLIParametersExample.CustomerPath} --${CLIParameters.Limit} 5000 --${CLIParameters.MinHits} 5`,
+        `$ sk auto-prewarm ${CLIParametersExample.CustomerPath} --${CLIParameters.Workgroup} prewarming`,
     ];
     static flags = {
+        ...CLI_ATHENA,
         ...CLI_CONFIG_NAME,
         ...CLI_QUERY_DAYS,
         ...CLI_QUERY_FILTERS,
-        // The same narrowing and the same splitting the query command offers; the
-        // rest of the pre-warm flags shape a list this command does not write.
-        [CLIParameters.Match]: CLI_QUERY_PREWARM[CLIParameters.Match],
-        [CLIParameters.Device]: CLI_QUERY_VARIATIONS[CLIParameters.Device],
-        [CLIParameters.Variation]: CLI_QUERY_VARIATIONS[CLIParameters.Variation],
+        // Every flag that shapes the pre-warm list, not a subset of them: this
+        // command builds the same query `sk query prewarm` does, and a list it
+        // could not narrow the same way could not be counted by that command
+        // either — the two would describe different runs. `--count` is not among
+        // them: this command warms the list rather than reporting its size.
+        ...CLI_QUERY_PREWARM_LIST,
         // A variations file says what `--variation` says, read from disk.
         [CLIParameters.VariationPath]: Flags.file({
             char: CLIParametersChar.VariationPath,
@@ -42,21 +46,26 @@ export default class AutoPrewarm extends Command {
         }),
     };
     async run() {
-        const { args: { customerPath }, flags: { configName, days, device, excludeNoindex, excludeSuspicious, hardNavigationsOnly, keepParameterSorting, match, quiet, variation, variationPath, verbose, }, } = await this.parse(AutoPrewarm);
+        const { args: { customerPath }, flags: { configName, days, device, excludeNoindex, excludeNotFound, excludeSuspicious, hardNavigationsOnly, keepParameterSorting, limit, match, minHits, quiet, variation, variationPath, verbose, workgroup, catalog, }, } = await this.parse(AutoPrewarm);
         const service = await new AutoPreWarmFactory({
             customerPath,
             configName,
             days,
             device,
             excludeNoindex,
+            excludeNotFound,
             excludeSuspicious,
             hardNavigationsOnly,
+            limit,
             match,
+            minHits,
             variation,
             variationPath,
             sortParameters: !keepParameterSorting,
             quiet,
             verbose,
+            workgroup,
+            catalog,
             isWindows: this.config.windows,
         }, new CliConfig(this.config).load()).getService();
         await service.run();

package/dist/commands/query/parameter.d.ts

@@ -21,6 +21,8 @@ export default class QueryParameter extends Command {
         hardNavigationsOnly: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         days: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         configName: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        catalog: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        workgroup: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/query/parameter.js

@@ -1,5 +1,5 @@
 import { Command } from "@oclif/core";
-import { CLI_CONFIG_NAME, CLI_CUSTOMER_CONFIG, CLI_QUERY_DAYS, CLI_QUERY_FILTERS, CLI_QUERY_OUTPUT, CLI_QUERY_PARAMETER, CLIParameters, CLIParametersChar, CLIParametersExample, } from "../../models/cli-parameters.js";
+import { CLI_ATHENA, CLI_CONFIG_NAME, CLI_CUSTOMER_CONFIG, CLI_QUERY_DAYS, CLI_QUERY_FILTERS, CLI_QUERY_OUTPUT, CLI_QUERY_PARAMETER, CLIParameters, CLIParametersChar, CLIParametersExample, } from "../../models/cli-parameters.js";
 import { QueryType } from "../../services/query-builder/query-builder-model.js";
 import { runQuery } from "../../services/query-builder/query-command.js";
 export default class QueryParameter extends Command {
@@ -14,6 +14,7 @@ export default class QueryParameter extends Command {
         `$ sk query parameter ${CLIParametersExample.CustomerPath} --${CLIParameters.Explain}`,
     ];
     static flags = {
+        ...CLI_ATHENA,
         ...CLI_CONFIG_NAME,
         ...CLI_QUERY_DAYS,
         ...CLI_QUERY_FILTERS,

package/dist/commands/query/prewarm.d.ts

@@ -26,6 +26,8 @@ export default class QueryPrewarm extends Command {
         hardNavigationsOnly: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         days: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         configName: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        catalog: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        workgroup: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/query/prewarm.js

@@ -1,5 +1,5 @@
 import { Command } from "@oclif/core";
-import { CLI_CONFIG_NAME, CLI_CUSTOMER_CONFIG, CLI_QUERY_DAYS, CLI_QUERY_FILTERS, CLI_QUERY_OUTPUT, CLI_QUERY_PREWARM, CLIParameters, CLIParametersChar, CLIParametersExample, } from "../../models/cli-parameters.js";
+import { CLI_ATHENA, CLI_CONFIG_NAME, CLI_CUSTOMER_CONFIG, CLI_QUERY_DAYS, CLI_QUERY_FILTERS, CLI_QUERY_OUTPUT, CLI_QUERY_PREWARM, CLIParameters, CLIParametersChar, CLIParametersExample, } from "../../models/cli-parameters.js";
 import { QueryType } from "../../services/query-builder/query-builder-model.js";
 import { runQuery } from "../../services/query-builder/query-command.js";
 export default class QueryPrewarm extends Command {
@@ -18,6 +18,7 @@ export default class QueryPrewarm extends Command {
         `$ sk query prewarm ${CLIParametersExample.CustomerPath} --${CLIParameters.Count}`,
     ];
     static flags = {
+        ...CLI_ATHENA,
         ...CLI_CONFIG_NAME,
         ...CLI_QUERY_DAYS,
         ...CLI_QUERY_FILTERS,

package/dist/helpers/clipboard.d.ts

@@ -14,6 +14,12 @@
  * behind a timeout, so no clipboard tool can ever be the reason a command
  * appears to do nothing.
  *
+ * `clipboardy` is loaded here rather than at module scope so that importing
+ * anything that can copy does not drag it in. It pulls a dependency that some
+ * Node/loader combinations refuse to resolve, which made every module on this
+ * path impossible to import from a test — and a clipboard that cannot load is
+ * already the case this function answers with `false`.
+ *
  * @returns whether the text reached the clipboard.
  */
 export declare function copyToClipboard(text: string): Promise<boolean>;

package/dist/helpers/clipboard.js

@@ -1,5 +1,4 @@
 import { spawn } from "node:child_process";
-import clipboardy from "clipboardy";
 /** How long a clipboard tool may take before the CLI stops waiting for it. */
 const TIMEOUT_IN_MS = 2000;
 /**
@@ -18,6 +17,12 @@ const TIMEOUT_IN_MS = 2000;
  * behind a timeout, so no clipboard tool can ever be the reason a command
  * appears to do nothing.
  *
+ * `clipboardy` is loaded here rather than at module scope so that importing
+ * anything that can copy does not drag it in. It pulls a dependency that some
+ * Node/loader combinations refuse to resolve, which made every module on this
+ * path impossible to import from a test — and a clipboard that cannot load is
+ * already the case this function answers with `false`.
+ *
  * @returns whether the text reached the clipboard.
  */
 export async function copyToClipboard(text) {
@@ -28,6 +33,7 @@ export async function copyToClipboard(text) {
         }
     }
     try {
+        const { default: clipboardy } = await import("clipboardy");
         return await withTimeout(clipboardy.write(text).then(() => true));
     }
     catch {

package/dist/models/cli-parameters.d.ts

@@ -3,6 +3,7 @@ export declare enum CLIParameters {
     Artifacts = "artifacts",
     ConfigName = "configName",
     ContentTypes = "contentTypes",
+    Catalog = "catalog",
     Cookies = "cookies",
     Count = "count",
     CreateTests = "CreateTests",
@@ -38,6 +39,7 @@ export declare enum CLIParameters {
     Variation = "variation",
     VariationPath = "variationPath",
     Verbose = "verbose",
+    Workgroup = "workgroup",
     useTestConfig = "useTestConfig"
 }
 export declare enum CLIParametersChar {
@@ -136,7 +138,27 @@ export declare const CLI_QUERY_VARIATIONS: {
     device: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
     variation: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
 };
-/** What the pre-warm query keeps of a long tail that is mostly seen once. */
+/**
+ * What the pre-warm query keeps of a long tail that is mostly seen once.
+ *
+ * Every flag here shapes the list itself, so a command that builds that list
+ * takes all of them — `sk auto-prewarm` included, or a count could describe a
+ * list the pre-warmer would never produce.
+ */
+export declare const CLI_QUERY_PREWARM_LIST: {
+    excludeNotFound: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    match: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+    minHits: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    device: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+    variation: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+};
+/**
+ * The pre-warm query flags in full: the list-shaping ones plus `--count`, which
+ * reports the list's size instead of returning it. Only a command that can
+ * answer with a count takes this one — `sk auto-prewarm` warms the list, so it
+ * takes {@link CLI_QUERY_PREWARM_LIST} instead.
+ */
 export declare const CLI_QUERY_PREWARM: {
     count: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     excludeNotFound: import("@oclif/core/interfaces").BooleanFlag<boolean>;
@@ -146,6 +168,23 @@ export declare const CLI_QUERY_PREWARM: {
     device: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
     variation: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
 };
+/**
+ * Where a query that is executed actually runs.
+ *
+ * The catalog is the account's, not the query's: our own logins reach the rum
+ * tables under `live`, while a role scoped to one account reaches the same
+ * tables under `AwsDataCatalog`. `SK_ATHENA_CATALOG` lets a CI job say so once.
+ *
+ * Athena resolves the account's default workgroup when none is named, which is
+ * only right where the credentials are allowed to use it — a role scoped to one
+ * workgroup is refused on any other, and the result location is a workgroup
+ * setting too. `SK_ATHENA_WORKGROUP` lets a CI job set it once for every
+ * command in the job.
+ */
+export declare const CLI_ATHENA: {
+    catalog: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    workgroup: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+};
 /** How the parameter query presents what it found. */
 export declare const CLI_QUERY_PARAMETER: {
     bySet: import("@oclif/core/interfaces").BooleanFlag<boolean>;

package/dist/models/cli-parameters.js

@@ -4,12 +4,14 @@ import { Args, Flags } from "@oclif/core";
 // library.
 import { parseMatchPattern } from "../services/query-builder/rules/match-pattern.js";
 import { DEVICE_VARIATIONS } from "../services/query-builder/queries/device.js";
+import { DEFAULT_ATHENA_CATALOG } from "../services/athena/athena-service-model.js";
 export var CLIParameters;
 (function (CLIParameters) {
     CLIParameters["AppName"] = "app";
     CLIParameters["Artifacts"] = "artifacts";
     CLIParameters["ConfigName"] = "configName";
     CLIParameters["ContentTypes"] = "contentTypes";
+    CLIParameters["Catalog"] = "catalog";
     CLIParameters["Cookies"] = "cookies";
     CLIParameters["Count"] = "count";
     CLIParameters["CreateTests"] = "CreateTests";
@@ -45,6 +47,7 @@ export var CLIParameters;
     CLIParameters["Variation"] = "variation";
     CLIParameters["VariationPath"] = "variationPath";
     CLIParameters["Verbose"] = "verbose";
+    CLIParameters["Workgroup"] = "workgroup";
     CLIParameters["useTestConfig"] = "useTestConfig";
 })(CLIParameters || (CLIParameters = {}));
 /* eslint-disable @typescript-eslint/no-duplicate-enum-values */
@@ -197,14 +200,15 @@ export const CLI_QUERY_VARIATIONS = {
         required: false,
     }),
 };
-/** What the pre-warm query keeps of a long tail that is mostly seen once. */
-export const CLI_QUERY_PREWARM = {
+/**
+ * What the pre-warm query keeps of a long tail that is mostly seen once.
+ *
+ * Every flag here shapes the list itself, so a command that builds that list
+ * takes all of them — `sk auto-prewarm` included, or a count could describe a
+ * list the pre-warmer would never produce.
+ */
+export const CLI_QUERY_PREWARM_LIST = {
     ...CLI_QUERY_VARIATIONS,
-    [CLIParameters.Count]: Flags.boolean({
-        default: false,
-        description: "Run the query and report how large the list is instead of what is in it: urls, the impressions they stand for, and a row per variation where the list carries variations. Every other flag still applies, so this counts the list the same command would produce",
-        exclusive: [CLIParameters.Execute],
-    }),
     [CLIParameters.ExcludeNotFound]: Flags.boolean({
         default: false,
         description: "Leave out urls the origin answers with a 404 more often than not",
@@ -234,6 +238,46 @@ export const CLI_QUERY_PREWARM = {
         required: false,
     }),
 };
+/**
+ * The pre-warm query flags in full: the list-shaping ones plus `--count`, which
+ * reports the list's size instead of returning it. Only a command that can
+ * answer with a count takes this one — `sk auto-prewarm` warms the list, so it
+ * takes {@link CLI_QUERY_PREWARM_LIST} instead.
+ */
+export const CLI_QUERY_PREWARM = {
+    ...CLI_QUERY_PREWARM_LIST,
+    [CLIParameters.Count]: Flags.boolean({
+        default: false,
+        description: "Run the query and report how large the list is instead of what is in it: urls, the impressions they stand for, and a row per variation where the list carries variations. Every other flag still applies, so this counts the list the same command would produce",
+        exclusive: [CLIParameters.Execute],
+    }),
+};
+/**
+ * Where a query that is executed actually runs.
+ *
+ * The catalog is the account's, not the query's: our own logins reach the rum
+ * tables under `live`, while a role scoped to one account reaches the same
+ * tables under `AwsDataCatalog`. `SK_ATHENA_CATALOG` lets a CI job say so once.
+ *
+ * Athena resolves the account's default workgroup when none is named, which is
+ * only right where the credentials are allowed to use it — a role scoped to one
+ * workgroup is refused on any other, and the result location is a workgroup
+ * setting too. `SK_ATHENA_WORKGROUP` lets a CI job set it once for every
+ * command in the job.
+ */
+export const CLI_ATHENA = {
+    [CLIParameters.Catalog]: Flags.string({
+        default: DEFAULT_ATHENA_CATALOG,
+        description: "Athena data catalog holding the rum tables. Names the catalog both in the query and in the context it runs in, so the two always agree",
+        env: "SK_ATHENA_CATALOG",
+        required: false,
+    }),
+    [CLIParameters.Workgroup]: Flags.string({
+        description: "Athena workgroup to run the query in, e.g. 'prewarming'. Defaults to the account's default workgroup",
+        env: "SK_ATHENA_WORKGROUP",
+        required: false,
+    }),
+};
 /** How the parameter query presents what it found. */
 export const CLI_QUERY_PARAMETER = {
     [CLIParameters.BySet]: Flags.boolean({

package/dist/services/athena/athena-service-factory.d.ts

@@ -1,13 +1,20 @@
 import { AthenaService } from "./athena-query-service.js";
 export declare class AthenaServiceFactory {
     private app?;
+    private workgroup?;
+    private catalog?;
     service?: AthenaService;
     /**
      * @param app - the app to query. Enables the Baqend native query path (app
      * token only) as a fallback when no AWS login is present. Without it, only
      * the AWS path is available.
+     * @param workgroup - Athena workgroup for the AWS path. The Baqend path has
+     * no such notion, so it is ignored there.
+     * @param catalog - the data catalog the tables live in. The Baqend path is
+     * told so it can recognise the prefix, not so it can use it: the server
+     * resolves the catalog itself.
      */
-    constructor(app?: string);
+    constructor(app?: string, workgroup?: string, catalog?: string);
     getService(): Promise<AthenaService>;
     /**
      * Prefer direct AWS Athena whenever AWS credentials are present — they

package/dist/services/athena/athena-service-factory.js

@@ -8,14 +8,23 @@ import { BaqendAthenaService } from "./baqend-athena-service.js";
 import { EntityManagerFactory } from "../config-api/entity-manager-factory.js";
 export class AthenaServiceFactory {
     app;
+    workgroup;
+    catalog;
     service;
     /**
      * @param app - the app to query. Enables the Baqend native query path (app
      * token only) as a fallback when no AWS login is present. Without it, only
      * the AWS path is available.
+     * @param workgroup - Athena workgroup for the AWS path. The Baqend path has
+     * no such notion, so it is ignored there.
+     * @param catalog - the data catalog the tables live in. The Baqend path is
+     * told so it can recognise the prefix, not so it can use it: the server
+     * resolves the catalog itself.
      */
-    constructor(app) {
+    constructor(app, workgroup, catalog) {
         this.app = app;
+        this.workgroup = workgroup;
+        this.catalog = catalog;
     }
     async getService() {
         if (!this.service) {
@@ -33,11 +42,13 @@ export class AthenaServiceFactory {
         const cli = new CliServiceFactory().getService();
         const client = await this.tryGetAthenaClient();
         if (client) {
-            cli.comment("Using AWS credentials for Athena queries.");
-            return new AwsAthenaService(client, cli);
+            cli.comment(this.workgroup
+                ? `Using AWS credentials for Athena queries, workgroup ${this.workgroup}.`
+                : "Using AWS credentials for Athena queries.");
+            return new AwsAthenaService(client, cli, this.workgroup, this.catalog);
         }
         if (this.app) {
-            return new BaqendAthenaService(this.app, new EntityManagerFactory(), cli);
+            return new BaqendAthenaService(this.app, new EntityManagerFactory(), cli, this.catalog);
         }
         throw new FetchCredentialsError("Cannot send Athena queries: no AWS credentials found and no app given for the Baqend API.");
     }

package/dist/services/athena/athena-service-model.d.ts

@@ -1,4 +1,21 @@
 export declare const DEFAULT_MAX_AGE_IN_MINUTES = 60;
+/**
+ * The Athena data catalog holding the Speed Kit tables.
+ *
+ * Which catalog that is depends on the credentials: the name below is the one
+ * our own logins see, while a role scoped to one account reaches the same
+ * tables under `AwsDataCatalog`. It is therefore a default, not a constant —
+ * see the `--catalog` flag.
+ */
+export declare const DEFAULT_ATHENA_CATALOG = "live";
+/**
+ * The catalog to use, given what a caller asked for.
+ *
+ * A blank name is the default rather than an error: it reaches here from an
+ * unset environment variable in a CI file as easily as from a typo, and a
+ * query that reads `from .rum.pi` is no way to report it.
+ */
+export declare function athenaCatalog(catalog?: string): string;
 export declare const ATHENA_CONFIG: {
     region: string;
 };