@speedkit/cli 4.27.0 → 4.27.1

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [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.1 linux-x64 node-v22.23.2
 $ sk --help [COMMAND]
 USAGE
   $ sk COMMAND
@@ -103,9 +103,9 @@ 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 [--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
@@ -122,14 +122,19 @@ FLAGS
                                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 +148,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 +261,8 @@ 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 [--workgroup <value>] [-c <value>] [-d <value>] [--excludeNoindex]
+    [--excludeSuspicious] [--explain] [--hardNavigationsOnly] [-e] [-q] [--bySet] [--minImpressions <value>]
 
 ARGUMENTS
   CUSTOMERPATH  The customer config path
@@ -270,6 +279,8 @@ FLAGS
       --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 +302,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 [--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
@@ -322,6 +333,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 +838,8 @@ 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 [--workgroup <value>] [-c <value>] [-d <value>] [--excludeNoindex]
+    [--excludeSuspicious] [--explain] [--hardNavigationsOnly] [-e] [-q] [--bySet] [--minImpressions <value>]
 
 ARGUMENTS
   CUSTOMERPATH  The customer config path
@@ -843,6 +856,8 @@ FLAGS
       --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 +879,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 [--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
@@ -895,6 +910,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,23 @@ 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>;
+        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,25 @@ 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, }, } = 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,
             isWindows: this.config.windows,
         }, new CliConfig(this.config).load()).getService();
         await service.run();

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

@@ -21,6 +21,7 @@ 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>;
+        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,7 @@ 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>;
+        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/models/cli-parameters.d.ts

@@ -38,6 +38,7 @@ export declare enum CLIParameters {
     Variation = "variation",
     VariationPath = "variationPath",
     Verbose = "verbose",
+    Workgroup = "workgroup",
     useTestConfig = "useTestConfig"
 }
 export declare enum CLIParametersChar {
@@ -136,7 +137,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 +167,18 @@ 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.
+ *
+ * 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: {
+    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

@@ -45,6 +45,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 +198,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 +236,36 @@ 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.
+ *
+ * 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.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,16 @@
 import { AthenaService } from "./athena-query-service.js";
 export declare class AthenaServiceFactory {
     private app?;
+    private workgroup?;
     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.
      */
-    constructor(app?: string);
+    constructor(app?: string, workgroup?: 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,18 @@ import { BaqendAthenaService } from "./baqend-athena-service.js";
 import { EntityManagerFactory } from "../config-api/entity-manager-factory.js";
 export class AthenaServiceFactory {
     app;
+    workgroup;
     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.
      */
-    constructor(app) {
+    constructor(app, workgroup) {
         this.app = app;
+        this.workgroup = workgroup;
     }
     async getService() {
         if (!this.service) {
@@ -33,8 +37,10 @@ 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);
         }
         if (this.app) {
             return new BaqendAthenaService(this.app, new EntityManagerFactory(), cli);

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

@@ -10,7 +10,17 @@ import { CliServiceInterface } from "../cli/index.js";
 export declare class AwsAthenaService implements AthenaService {
     private client;
     private cli;
-    constructor(client: AthenaClient, cli: CliServiceInterface);
+    /**
+     * Athena falls back to the account's default workgroup when this is unset,
+     * which is only right where the credentials are allowed to use it.
+     */
+    private workgroup?;
+    constructor(client: AthenaClient, cli: CliServiceInterface, 
+    /**
+     * Athena falls back to the account's default workgroup when this is unset,
+     * which is only right where the credentials are allowed to use it.
+     */
+    workgroup?: string);
     getResult<T>(query: string, parameters?: string[], maxAgeInMinutes?: number): Promise<T[]>;
     /** The query, from sending it off to the rows it produced. */
     private runAndFetch;

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

@@ -11,9 +11,16 @@ import { safe } from "../../helpers/safe.js";
 export class AwsAthenaService {
     client;
     cli;
-    constructor(client, cli) {
+    workgroup;
+    constructor(client, cli, 
+    /**
+     * Athena falls back to the account's default workgroup when this is unset,
+     * which is only right where the credentials are allowed to use it.
+     */
+    workgroup) {
         this.client = client;
         this.cli = cli;
+        this.workgroup = workgroup;
     }
     async getResult(query, parameters = [], maxAgeInMinutes = DEFAULT_MAX_AGE_IN_MINUTES) {
         this.cli.startAction("ATHENA:QUERY", "execute athena query");
@@ -108,6 +115,10 @@ export class AwsAthenaService {
                     MaxAgeInMinutes: maxAgeInMinutes,
                 },
             },
+            // Omitted rather than sent empty: Athena reads an absent WorkGroup as
+            // "the default one", and an empty string as a workgroup that does not
+            // exist.
+            ...(this.workgroup ? { WorkGroup: this.workgroup } : {}),
         });
         const response = await this.client.send(command);
         await this.waitOnResponse(response.QueryExecutionId);

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

@@ -14,9 +14,10 @@ function recordingCli() {
     return { calls, cli };
 }
 /** An Athena that answers every execution with the given state. */
-function clientAnswering(state, reason) {
+function clientAnswering(state, reason, sent = []) {
     return {
         send: async (command) => {
+            sent.push(command);
             if (command instanceof StartQueryExecutionCommand) {
                 return { QueryExecutionId: "query-1" };
             }
@@ -62,6 +63,24 @@ describe("AwsAthenaService", () => {
         expect(result.message).to.contain("INVALID_ARGUMENTS: nope");
         expect(calls).to.deep.equal(["start:ATHENA:QUERY", "fail:ATHENA:QUERY"]);
     });
+    it("should run in the workgroup it was given", async () => {
+        const { cli } = recordingCli();
+        const sent = [];
+        const service = new AwsAthenaService(clientAnswering("SUCCEEDED", undefined, sent), cli, "prewarming");
+        await service.getResult("select 1", [], 0);
+        const start = sent.find((command) => command instanceof StartQueryExecutionCommand);
+        expect(start.input.WorkGroup).to.equal("prewarming");
+    });
+    it("should leave the workgroup out when none was given", async () => {
+        // Athena reads an absent WorkGroup as the account default; an empty string
+        // is a workgroup that does not exist, so the key has to be gone entirely.
+        const { cli } = recordingCli();
+        const sent = [];
+        const service = new AwsAthenaService(clientAnswering("SUCCEEDED", undefined, sent), cli);
+        await service.getResult("select 1", [], 0);
+        const start = sent.find((command) => command instanceof StartQueryExecutionCommand);
+        expect(start.input).to.not.have.property("WorkGroup");
+    });
     it("should not pass a failed query off as an empty result", async () => {
         const { cli } = recordingCli();
         const service = new AwsAthenaService(clientAnswering("CANCELLED"), cli);

package/dist/services/prewarm/auto-pre-warm-factory.d.ts

@@ -6,8 +6,16 @@ export interface AutoPreWarmContext extends QueryFilterOptions {
     readonly configName: string;
     /** Device classes to warm each url in the variations it was requested in. */
     readonly device?: readonly string[];
+    /** Drop urls the origin mostly answers with a 404. */
+    readonly excludeNotFound?: boolean;
+    /** Keep only the most requested urls. */
+    readonly limit?: number;
     /** Regular expressions the pre-warmed urls have to match. */
     readonly match?: readonly string[];
+    /** Keep only urls requested at least this often in the window. */
+    readonly minHits?: number;
+    /** Athena workgroup the query runs in. */
+    readonly workgroup?: string;
     /** Variations to pair every url with, when no traffic can reveal them. */
     readonly variation?: readonly string[];
     readonly variationPath?: string;

package/dist/services/prewarm/auto-pre-warm-factory.js

@@ -34,13 +34,17 @@ export class AutoPreWarmFactory {
             days: this.context.days,
             devices: normalizeDevices(this.context.device),
             excludeNoindex: this.context.excludeNoindex,
+            excludeNotFound: this.context.excludeNotFound,
             excludeSuspicious: this.context.excludeSuspicious,
             execute: true,
             hardNavigationsOnly: this.context.hardNavigationsOnly,
             isWindows: this.context.isWindows,
+            limit: this.context.limit,
             match: this.context.match,
+            minHits: this.context.minHits,
             quiet: this.context.quiet,
             variations: this.context.variation,
+            workgroup: this.context.workgroup,
         }, this.userConfig).buildService(QueryType.prewarm);
         const app = queryService.app;
         const rows = await queryService.execute();

package/dist/services/query-builder/query-builder-factory.js

@@ -47,7 +47,7 @@ export class QueryBuilderFactory {
         // The Athena service is only needed when the query is executed directly —
         // which `--count` is, a count query being of no use as text.
         const athenaService = this.context.execute || this.context.count
-            ? await new AthenaServiceFactory(app).getService()
+            ? await new AthenaServiceFactory(app, this.context.workgroup).getService()
             : undefined;
         return new QueryBuilderService(serviceContext, parseRuleSets(speedKitConfig), cli, athenaService);
     }

package/dist/services/query-builder/query-builder-model.d.ts

@@ -33,4 +33,6 @@ export interface QueryBuilderFactoryContext extends ParameterOptions, PrewarmOpt
     readonly explain?: boolean;
     readonly isWindows?: boolean;
     readonly quiet?: boolean;
+    /** Athena workgroup to execute in, when the query is executed at all. */
+    readonly workgroup?: string;
 }

package/dist/services/query-builder/query-command.d.ts

@@ -14,6 +14,7 @@ export interface QueryCommandFlags extends ParameterOptions, Omit<PrewarmOptions
     readonly explain?: boolean;
     readonly quiet?: boolean;
     readonly variation?: readonly string[];
+    readonly workgroup?: string;
 }
 /**
  * Builds one of the config-derived queries and hands it over.

package/dist/services/query-builder/query-command.js

@@ -30,6 +30,7 @@ export async function runQuery(queryType, customerPath, flags, config) {
         minImpressions: flags.minImpressions,
         quiet: flags.quiet,
         variations: flags.variation,
+        workgroup: flags.workgroup,
     }, new CliConfig(config).load()).buildService(queryType);
     await service.run();
 }

package/oclif.manifest.json

@@ -14,9 +14,20 @@
         "$ sk auto-prewarm <customerPath> -c <configName>",
         "$ sk auto-prewarm customers/decathlon.de -c production",
         "$ sk auto-prewarm customers/decathlon.de --device desktop,mobile",
-        "$ sk auto-prewarm customers/decathlon.de -v MOBILE,DESKTOP"
+        "$ 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"
       ],
       "flags": {
+        "workgroup": {
+          "description": "Athena workgroup to run the query in, e.g. 'prewarming'. Defaults to the account's default workgroup",
+          "env": "SK_ATHENA_WORKGROUP",
+          "name": "workgroup",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "configName": {
           "char": "c",
           "description": "The costumer config name",
@@ -60,14 +71,6 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "match": {
-          "description": "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",
-          "name": "match",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
         "device": {
           "description": "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",
           "exclusive": [
@@ -98,6 +101,36 @@
           "multiple": true,
           "type": "option"
         },
+        "excludeNotFound": {
+          "description": "Leave out urls the origin answers with a 404 more often than not",
+          "name": "excludeNotFound",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Keep only the most requested urls",
+          "name": "limit",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "match": {
+          "description": "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",
+          "name": "match",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "minHits": {
+          "description": "Keep only urls requested at least this often in the window",
+          "name": "minHits",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "variationPath": {
           "char": "p",
           "description": "path to variations.csv",
@@ -1309,6 +1342,15 @@
         "$ sk query parameter customers/decathlon.de --explain"
       ],
       "flags": {
+        "workgroup": {
+          "description": "Athena workgroup to run the query in, e.g. 'prewarming'. Defaults to the account's default workgroup",
+          "env": "SK_ATHENA_WORKGROUP",
+          "name": "workgroup",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "configName": {
           "char": "c",
           "description": "The costumer config name",
@@ -1420,6 +1462,15 @@
         "$ sk query prewarm customers/decathlon.de --count"
       ],
       "flags": {
+        "workgroup": {
+          "description": "Athena workgroup to run the query in, e.g. 'prewarming'. Defaults to the account's default workgroup",
+          "env": "SK_ATHENA_WORKGROUP",
+          "name": "workgroup",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "configName": {
           "char": "c",
           "description": "The costumer config name",
@@ -1507,15 +1558,6 @@
           "multiple": true,
           "type": "option"
         },
-        "count": {
-          "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": [
-            "execute"
-          ],
-          "name": "count",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "excludeNotFound": {
           "description": "Leave out urls the origin answers with a 404 more often than not",
           "name": "excludeNotFound",
@@ -1545,6 +1587,15 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "count": {
+          "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": [
+            "execute"
+          ],
+          "name": "count",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -1564,5 +1615,5 @@
       ]
     }
   },
-  "version": "4.27.0"
+  "version": "4.27.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@speedkit/cli",
   "description": "Speed Kit CLI",
-  "version": "4.27.0",
+  "version": "4.27.1",
   "author": {
     "name": "Baqend.com",
     "email": "info@baqend.com"