@speedkit/cli 4.26.0 → 4.27.0

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+# [4.27.0](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v4.26.0...v4.27.0) (2026-09-11)
+
+
+### Features
+
+* **prewarm:** add --count to check how many urls will get prewarmed ([551b5e6](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/551b5e60f220e0046b7e8d755ca561679a2baefc))
+* **prewarm:** carry the variation in the list instead of crossing it ([1679a2c](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/1679a2cdad3764b64a92bae2690299d0ca3f0d4e))
+* **querybuilder:** add --match flag to narrow the prewarm list ([d59bcd5](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/d59bcd5c1690b7141e429e0b79eff1bc791dc29e))
+* **querybuilder:** recreate querybuilder ([9304097](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/93040978433a3e2b7ec6ad66a746606b8776e308))
+
 # [4.26.0](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v4.25.2...v4.26.0) (2026-09-09)
 
 

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @speedkit/cli
 $ sk COMMAND
 running command...
 $ sk (--version)
-@speedkit/cli/4.26.0 linux-x64 node-v22.23.2
+@speedkit/cli/4.27.0 linux-x64 node-v22.23.2
 $ sk --help [COMMAND]
 USAGE
   $ sk COMMAND
@@ -92,6 +92,8 @@ By either...
 * [`sk param-diff PAGEURL`](#sk-param-diff-pageurl)
 * [`sk prewarm APP PATH`](#sk-prewarm-app-path)
 * [`sk pull CUSTOMERPATH`](#sk-pull-customerpath)
+* [`sk query parameter CUSTOMERPATH`](#sk-query-parameter-customerpath)
+* [`sk query prewarm CUSTOMERPATH`](#sk-query-prewarm-customerpath)
 * [`sk revalidate APP`](#sk-revalidate-app)
 * [`sk wpt-launcher URLS TESTID`](#sk-wpt-launcher-urls-testid)
 
@@ -101,17 +103,32 @@ Build and execute the prewarm query for a customer config and start a prewarm jo
 
 ```
 USAGE
-  $ sk auto-prewarm CUSTOMERPATH [-c <value>] [-p <value> | -v <value>] [-k] [-q] [--verbose]
+  $ 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]
 
 ARGUMENTS
   CUSTOMERPATH  The customer config path
 
 FLAGS
   -c, --configName=<value>     [default: production] The costumer config name
+  -d, --days=<value>           Number of days the query looks back
   -k, --keepParameterSorting   Prevents alphabetical sorting of the URL parameters
   -p, --variationPath=<value>  path to variations.csv
   -q, --quiet                  less output non interactive
-  -v, --variation=<value>      [default: default]
+  -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'
+      --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
+      --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
+      --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
       --verbose                Log information about failed requests
 
 DESCRIPTION
@@ -123,6 +140,8 @@ EXAMPLES
 
   $ 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
 ```
 
@@ -233,21 +252,37 @@ Build a parameter query that can be executed in Athena
 
 ```
 USAGE
-  $ sk build-parameter-query CUSTOMERPATH [-c <value>]
+  $ sk build-parameter-query CUSTOMERPATH [-c <value>] [-d <value>] [--excludeNoindex] [--excludeSuspicious] [--explain]
+    [--hardNavigationsOnly] [-e] [-q] [--bySet] [--minImpressions <value>]
 
 ARGUMENTS
   CUSTOMERPATH  The customer config path
 
 FLAGS
-  -c, --configName=<value>  [default: production] The costumer config name
+  -c, --configName=<value>      [default: production] The costumer config name
+  -d, --days=<value>            Number of days the query looks back
+  -e, --execute                 Execute the query directly and write the result to a <app>-<date>-<query>.csv file
+  -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
+      --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
 
 DESCRIPTION
   Build a parameter query that can be executed in Athena
 
+ALIASES
+  $ sk build-parameter-query
+
 EXAMPLES
-  $ sk build-parameter-query <customerPath> -c <configName>
+  $ sk query parameter <customerPath> -c <configName>
+
+  $ sk query parameter customers/decathlon.de -c production
 
-  $ sk build-parameter-query customers/decathlon.de -c production
+  $ sk query parameter customers/decathlon.de --explain
 ```
 
 ## `sk build-prewarm-query CUSTOMERPATH`
@@ -256,23 +291,58 @@ Build a prewarm query that can be executed in Athena
 
 ```
 USAGE
-  $ sk build-prewarm-query CUSTOMERPATH [-c <value>] [-q] [-e]
+  $ 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>]
 
 ARGUMENTS
   CUSTOMERPATH  The customer config path
 
 FLAGS
-  -c, --configName=<value>  [default: production] The costumer config name
-  -e, --execute             Execute the query directly and write the result to a <app>-<date>-prewarm.csv file
-  -q, --quiet               Output only the raw query without clipboard copy or styling
+  -c, --configName=<value>    [default: production] The costumer config name
+  -d, --days=<value>          Number of days the query looks back
+  -e, --execute               Execute the query directly and write the result to a <app>-<date>-<query>.csv file
+  -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'
+      --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
+      --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
 
 DESCRIPTION
   Build a prewarm query that can be executed in Athena
 
+ALIASES
+  $ sk build-prewarm-query
+
 EXAMPLES
-  $ sk build-prewarm-query <customerPath> -c <configName>
+  $ sk query prewarm <customerPath> -c <configName>
+
+  $ sk query prewarm customers/decathlon.de -c production
+
+  $ sk query prewarm customers/decathlon.de --explain
+
+  $ sk query prewarm customers/decathlon.de --match '^/p/'
 
-  $ sk build-prewarm-query customers/decathlon.de -c production
+  $ sk query prewarm customers/decathlon.de --device desktop,mobile
+
+  $ sk query prewarm customers/decathlon.de -v MOBILE,DESKTOP
+
+  $ sk query prewarm customers/decathlon.de --count
 ```
 
 ## `sk config edit`
@@ -516,7 +586,7 @@ Generate a pop config for the given app
 
 ```
 USAGE
-  $ sk generate-pop-config APP [-c <value>] [-d] [-p <value>] [-t <value>] [-r] [-s]
+  $ sk generate-pop-config APP [--days <value>] [-c <value>] [-d] [-p <value>] [-t <value>] [-r] [-s]
 
 ARGUMENTS
   APP  The customers appName
@@ -530,6 +600,7 @@ FLAGS
   -s, --force-shield           Force a shield based prewarming config.
   -t, --traffic-share=<value>  [default: 5] The minimum traffic share in percent a pop must have to be actually
                                prewarmed.
+      --days=<value>           Number of days the query looks back
 
 DESCRIPTION
   Generate a pop config for the given app
@@ -700,7 +771,8 @@ FLAGS
   -k, --keepParameterSorting   Prevents alphabetical sorting of the URL parameters
   -p, --variationPath=<value>  path to variations.csv
   -q, --quiet                  less output non interactive
-  -v, --variation=<value>      [default: default]
+  -v, --variation=<value>      Warm every url of the list in each of these variations, e.g. 'desktop,mobile'. Ignored
+                               for a list that names a variation itself
       --verbose                Log information about failed requests
 
 DESCRIPTION
@@ -747,6 +819,105 @@ EXAMPLES
   $ sk pull customers/decathlon.de -c production
 ```
 
+## `sk query parameter CUSTOMERPATH`
+
+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>]
+
+ARGUMENTS
+  CUSTOMERPATH  The customer config path
+
+FLAGS
+  -c, --configName=<value>      [default: production] The costumer config name
+  -d, --days=<value>            Number of days the query looks back
+  -e, --execute                 Execute the query directly and write the result to a <app>-<date>-<query>.csv file
+  -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
+      --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
+
+DESCRIPTION
+  Build a parameter query that can be executed in Athena
+
+ALIASES
+  $ sk build-parameter-query
+
+EXAMPLES
+  $ sk query parameter <customerPath> -c <configName>
+
+  $ sk query parameter customers/decathlon.de -c production
+
+  $ sk query parameter customers/decathlon.de --explain
+```
+
+## `sk query prewarm CUSTOMERPATH`
+
+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>]
+
+ARGUMENTS
+  CUSTOMERPATH  The customer config path
+
+FLAGS
+  -c, --configName=<value>    [default: production] The costumer config name
+  -d, --days=<value>          Number of days the query looks back
+  -e, --execute               Execute the query directly and write the result to a <app>-<date>-<query>.csv file
+  -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'
+      --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
+      --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
+
+DESCRIPTION
+  Build a prewarm query that can be executed in Athena
+
+ALIASES
+  $ sk build-prewarm-query
+
+EXAMPLES
+  $ sk query prewarm <customerPath> -c <configName>
+
+  $ sk query prewarm customers/decathlon.de -c production
+
+  $ sk query prewarm customers/decathlon.de --explain
+
+  $ sk query prewarm customers/decathlon.de --match '^/p/'
+
+  $ sk query prewarm customers/decathlon.de --device desktop,mobile
+
+  $ sk query prewarm customers/decathlon.de -v MOBILE,DESKTOP
+
+  $ sk query prewarm customers/decathlon.de --count
+```
+
 ## `sk revalidate APP`
 
 Purge or refresh cached assets by prefix and query. Run it after a config that narrows scope goes live, so returning visitors stop receiving the cached HTML.

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

@@ -8,11 +8,18 @@ export default class AutoPrewarm extends Command {
     static description: string;
     static examples: string[];
     static flags: {
-        variation: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        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>;
+        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>;
     };
     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, CLIParameters, CLIParametersChar, CLIParametersExample, } from "../models/cli-parameters.js";
+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 { CliConfig } from "../helpers/cli-config.js";
 import { AutoPreWarmFactory } from "../services/prewarm/index.js";
 export default class AutoPrewarm extends Command {
@@ -8,18 +8,23 @@ export default class AutoPrewarm extends Command {
     static examples = [
         `$ sk auto-prewarm <${CLIParameters.CustomerPath}> -${CLIParametersChar.ConfigName} <${CLIParameters.ConfigName}>`,
         `$ 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}`,
     ];
     static flags = {
         ...CLI_CONFIG_NAME,
-        [CLIParameters.Variation]: Flags.string({
-            char: CLIParametersChar.Variation,
-            default: "default",
-        }),
+        ...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],
+        // A variations file says what `--variation` says, read from disk.
         [CLIParameters.VariationPath]: Flags.file({
             char: CLIParametersChar.VariationPath,
-            exclusive: [CLIParameters.Variation],
             description: "path to variations.csv",
+            exclusive: [CLIParameters.Device, CLIParameters.Variation],
         }),
         [CLIParameters.KeepParameterSorting]: Flags.boolean({
             char: CLIParametersChar.KeepParameterSorting,
@@ -37,10 +42,16 @@ export default class AutoPrewarm extends Command {
         }),
     };
     async run() {
-        const { args: { customerPath }, flags: { configName, variation, variationPath, keepParameterSorting, quiet, verbose, }, } = await this.parse(AutoPrewarm);
+        const { args: { customerPath }, flags: { configName, days, device, excludeNoindex, excludeSuspicious, hardNavigationsOnly, keepParameterSorting, match, quiet, variation, variationPath, verbose, }, } = await this.parse(AutoPrewarm);
         const service = await new AutoPreWarmFactory({
             customerPath,
             configName,
+            days,
+            device,
+            excludeNoindex,
+            excludeSuspicious,
+            hardNavigationsOnly,
+            match,
             variation,
             variationPath,
             sortParameters: !keepParameterSorting,

package/dist/commands/generate-pop-config.d.ts

@@ -6,6 +6,7 @@ export default class GeneratePopConfig extends Command {
     static description: string;
     static examples: string[];
     static flags: {
+        days: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         coverage: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         deploy: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         "pop-limit": import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/generate-pop-config.js

@@ -1,7 +1,7 @@
 import { Args, Command, Flags } from "@oclif/core";
 import { account } from "baqend/cli";
 import { readLocalFile } from "../helpers/file-helper.js";
-import { CLIParameters } from "../models/cli-parameters.js";
+import { CLI_QUERY_DAYS_DESCRIPTION, CLIParameters, } from "../models/cli-parameters.js";
 import { CliServiceFactory } from "../services/cli/index.js";
 import ConfigApiService from "../services/config-api-service.js";
 import { PopConfigFactory, } from "../services/pop-config/index.js";
@@ -88,6 +88,12 @@ export default class GeneratePopConfig extends Command {
         "$ sk generate-pop-config --coverage 95 --pop-limit 6 --traffic-share 2 --deploy appName",
     ];
     static flags = {
+        // No short flag: `-d` belongs to `--deploy` on this command.
+        [CLIParameters.Days]: Flags.integer({
+            description: CLI_QUERY_DAYS_DESCRIPTION,
+            min: 1,
+            required: false,
+        }),
         coverage: Flags.integer({
             char: "c",
             default: 95,
@@ -150,10 +156,10 @@ export default class GeneratePopConfig extends Command {
         }
     }
     async run() {
-        const { args: { app }, flags: { coverage, deploy, "pop-limit": popLimit, "traffic-share": minimalShare, "use-rum": useRum, "force-shield": forceShield, }, } = await this.parse(GeneratePopConfig);
+        const { args: { app }, flags: { coverage, deploy, days, "pop-limit": popLimit, "traffic-share": minimalShare, "use-rum": useRum, "force-shield": forceShield, }, } = await this.parse(GeneratePopConfig);
         // @todo refactor businessCode from this command to src/pop-config/pop-config-service
         const popConfigService = await new PopConfigFactory().getService(app);
-        const result = await popConfigService.getUsedPopsPerOrigin(app, useRum);
+        const result = await popConfigService.getUsedPopsPerOrigin(app, useRum, days);
         const originStats = this.generateOriginStats(result)
             .filter((stats) => {
             if (stats.hits < 100)

package/dist/commands/prewarm.js

@@ -16,9 +16,11 @@ export default class Prewarm extends Command {
         }),
     };
     static flags = {
+        // No default: the list may already name a variation per url, and only a
+        // flag the caller really gave should be reported as ignored then.
         [CLIParameters.Variation]: Flags.string({
             char: CLIParametersChar.Variation,
-            default: "default",
+            description: "Warm every url of the list in each of these variations, e.g. 'desktop,mobile'. Ignored for a list that names a variation itself",
         }),
         [CLIParameters.VariationPath]: Flags.file({
             char: CLIParametersChar.VariationPath,

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

@@ -0,0 +1,26 @@
+import { Command } from "@oclif/core";
+export default class QueryParameter extends Command {
+    static args: {
+        customerPath: import("@oclif/core/interfaces").Arg<string, {
+            exists?: boolean;
+        }>;
+    };
+    /** The command was `sk build-parameter-query` before it moved under `query`. */
+    static aliases: string[];
+    static deprecateAliases: boolean;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        bySet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        minImpressions: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        execute: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        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>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/query/parameter.js

@@ -0,0 +1,27 @@
+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 { QueryType } from "../../services/query-builder/query-builder-model.js";
+import { runQuery } from "../../services/query-builder/query-command.js";
+export default class QueryParameter extends Command {
+    static args = CLI_CUSTOMER_CONFIG;
+    /** The command was `sk build-parameter-query` before it moved under `query`. */
+    static aliases = ["build-parameter-query"];
+    static deprecateAliases = true;
+    static description = "Build a parameter query that can be executed in Athena";
+    static examples = [
+        `$ sk query parameter <${CLIParameters.CustomerPath}> -${CLIParametersChar.ConfigName} <${CLIParameters.ConfigName}>`,
+        `$ sk query parameter ${CLIParametersExample.CustomerPath} -${CLIParametersChar.ConfigName} ${CLIParametersExample.ConfigName}`,
+        `$ sk query parameter ${CLIParametersExample.CustomerPath} --${CLIParameters.Explain}`,
+    ];
+    static flags = {
+        ...CLI_CONFIG_NAME,
+        ...CLI_QUERY_DAYS,
+        ...CLI_QUERY_FILTERS,
+        ...CLI_QUERY_OUTPUT,
+        ...CLI_QUERY_PARAMETER,
+    };
+    async run() {
+        const { args: { customerPath }, flags, } = await this.parse(QueryParameter);
+        await runQuery(QueryType.parameter, customerPath, flags, this.config);
+    }
+}

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

@@ -0,0 +1,31 @@
+import { Command } from "@oclif/core";
+export default class QueryPrewarm extends Command {
+    static args: {
+        customerPath: import("@oclif/core/interfaces").Arg<string, {
+            exists?: boolean;
+        }>;
+    };
+    /** The command was `sk build-prewarm-query` before it moved under `query`. */
+    static aliases: string[];
+    static deprecateAliases: boolean;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        count: 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>;
+        execute: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        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>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/query/prewarm.js

@@ -0,0 +1,31 @@
+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 { QueryType } from "../../services/query-builder/query-builder-model.js";
+import { runQuery } from "../../services/query-builder/query-command.js";
+export default class QueryPrewarm extends Command {
+    static args = CLI_CUSTOMER_CONFIG;
+    /** The command was `sk build-prewarm-query` before it moved under `query`. */
+    static aliases = ["build-prewarm-query"];
+    static deprecateAliases = true;
+    static description = "Build a prewarm query that can be executed in Athena";
+    static examples = [
+        `$ sk query prewarm <${CLIParameters.CustomerPath}> -${CLIParametersChar.ConfigName} <${CLIParameters.ConfigName}>`,
+        `$ sk query prewarm ${CLIParametersExample.CustomerPath} -${CLIParametersChar.ConfigName} ${CLIParametersExample.ConfigName}`,
+        `$ sk query prewarm ${CLIParametersExample.CustomerPath} --${CLIParameters.Explain}`,
+        `$ sk query prewarm ${CLIParametersExample.CustomerPath} --${CLIParameters.Match} '${CLIParametersExample.Match}'`,
+        `$ sk query prewarm ${CLIParametersExample.CustomerPath} --${CLIParameters.Device} ${CLIParametersExample.Devices}`,
+        `$ sk query prewarm ${CLIParametersExample.CustomerPath} -${CLIParametersChar.Variation} ${CLIParametersExample.Variations}`,
+        `$ sk query prewarm ${CLIParametersExample.CustomerPath} --${CLIParameters.Count}`,
+    ];
+    static flags = {
+        ...CLI_CONFIG_NAME,
+        ...CLI_QUERY_DAYS,
+        ...CLI_QUERY_FILTERS,
+        ...CLI_QUERY_OUTPUT,
+        ...CLI_QUERY_PREWARM,
+    };
+    async run() {
+        const { args: { customerPath }, flags, } = await this.parse(QueryPrewarm);
+        await runQuery(QueryType.prewarm, customerPath, flags, this.config);
+    }
+}

package/dist/helpers/clipboard.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Puts text on the system clipboard, and never holds up the CLI.
+ *
+ * `clipboardy.writeSync` cannot be used on Wayland. It runs `wl-copy` through
+ * `execaSync`, and `wl-copy` has to *stay alive* to own the selection — there
+ * is no clipboard daemon on Wayland, the source process serves the data. It
+ * forks into the background but inherits the pipes `execa` created, so the
+ * synchronous wait never returns: the command hangs after the work is done,
+ * with the output still unwritten, until the user interrupts it.
+ *
+ * On Wayland the tool is therefore started the way it wants to be — detached,
+ * with its output going nowhere, and unreferenced so Node can exit while it
+ * keeps serving the clipboard. Everywhere else `clipboardy` is used as before,
+ * behind a timeout, so no clipboard tool can ever be the reason a command
+ * appears to do nothing.
+ *
+ * @returns whether the text reached the clipboard.
+ */
+export declare function copyToClipboard(text: string): Promise<boolean>;