@speedkit/cli 4.20.5 → 4.22.0

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+# [4.22.0](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v4.21.0...v4.22.0) (2026-08-20)
+
+
+### Bug Fixes
+
+* **customer-config:** contract-check against the CLI's variable inventory ([7ebd2d2](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/7ebd2d28331a59dc3754fa1f6cd859f978febf6c))
+
+
+### Features
+
+* **customer-config:** --mode flag picks the template set ([b471e8b](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/b471e8b8c6de32babfd26f69688409cae04288ae))
+* **customer-config:** graduate an existing pre-PoC config ([28af5e2](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/28af5e2d06c8c9571da3d72563ae229b12f27d56))
+* **customer-config:** pre-poc mode asks only what the baseline needs ([35cbcbd](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/35cbcbd698144ac82dd275dcf63a0e62b03dba24))
+* **customer-config:** render wizard templates from sk-onboarding ([266cbe3](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/266cbe3c68f5e4aafa431e2fa4a5f9311c3e28c9))
+
+# [4.21.0](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v4.20.5...v4.21.0) (2026-08-14)
+
+
+### Features
+
+* implement extensionManagement ([17e65b7](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/17e65b72c8e7791ba1174dd7c948daffe4a9b9cc))
+
 ## [4.20.5](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v4.20.4...v4.20.5) (2026-08-10)
 
 

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @speedkit/cli
 $ sk COMMAND
 running command...
 $ sk (--version)
-@speedkit/cli/4.20.5 linux-x64 node-v22.23.2
+@speedkit/cli/4.22.0 linux-x64 node-v22.23.2
 $ sk --help [COMMAND]
 USAGE
   $ sk COMMAND
@@ -78,6 +78,10 @@ By either...
 * [`sk deploy CUSTOMERPATH`](#sk-deploy-customerpath)
 * [`sk diff-url-parameters PAGEURL`](#sk-diff-url-parameters-pageurl)
 * [`sk document-handler CUSTOMERPATH`](#sk-document-handler-customerpath)
+* [`sk extension add [REF]`](#sk-extension-add-ref)
+* [`sk extension list`](#sk-extension-list)
+* [`sk extension remove [REF]`](#sk-extension-remove-ref)
+* [`sk extension update`](#sk-extension-update)
 * [`sk find-pops APP`](#sk-find-pops-app)
 * [`sk generate-customer-config`](#sk-generate-customer-config)
 * [`sk generate-pop-config APP`](#sk-generate-pop-config-app)
@@ -381,6 +385,78 @@ EXAMPLES
   $ sk deploy customers/decathlon.de -c production
 ```
 
+## `sk extension add [REF]`
+
+Install a Chrome extension into the onboarding browser by Web Store link or id
+
+```
+USAGE
+  $ sk extension add [REF]
+
+ARGUMENTS
+  [REF]  Chrome Web Store link or extension id
+
+DESCRIPTION
+  Install a Chrome extension into the onboarding browser by Web Store link or id
+
+EXAMPLES
+  $ sk extension add fmkadmapgofadopljbjfkapdkoienihi
+
+  $ sk extension add https://chromewebstore.google.com/detail/react-developer-tools/fmkadmapgofadopljbjfkapdkoienihi
+
+  $ sk extension add
+```
+
+## `sk extension list`
+
+List Chrome extensions managed by the setup wizard
+
+```
+USAGE
+  $ sk extension list
+
+DESCRIPTION
+  List Chrome extensions managed by the setup wizard
+
+EXAMPLES
+  $ sk extension list
+```
+
+## `sk extension remove [REF]`
+
+Remove a managed Chrome extension
+
+```
+USAGE
+  $ sk extension remove [REF]
+
+ARGUMENTS
+  [REF]  Chrome Web Store link or extension id
+
+DESCRIPTION
+  Remove a managed Chrome extension
+
+EXAMPLES
+  $ sk extension remove
+
+  $ sk extension remove <id>
+```
+
+## `sk extension update`
+
+Check managed Chrome extensions for updates and install them
+
+```
+USAGE
+  $ sk extension update
+
+DESCRIPTION
+  Check managed Chrome extensions for updates and install them
+
+EXAMPLES
+  $ sk extension update
+```
+
 ## `sk find-pops APP`
 
 Get IPs for all fastly PoPs
@@ -410,13 +486,18 @@ Generates a customer config guided by a wizard 🧙‍
 
 ```
 USAGE
-  $ sk generate-customer-config [-a <value>] [-d <value>]
+  $ sk generate-customer-config [-a <value>] [-d <value>] [--templates <value>] [--mode customer-config|pre-poc]
 
 FLAGS
   -a, --app=<value>                 The SK app name which is also being used the config output directory name
                                     (kebab-case)
   -d, --customersDirectory=<value>  Name of the sk-onboarding directory where all customer configs are being stored
                                     (default: "customers")
+      --mode=<option>               [default: customer-config] Which config to scaffold: the full acceleration config,
+                                    or the tracking-only pre-PoC config
+                                    <options: customer-config|pre-poc>
+      --templates=<value>           Path to the templates/ root (default: the sk-onboarding checkout the CLI runs in, or
+                                    the sk-onboarding repo on GitLab when run standalone)
 
 DESCRIPTION
   Generates a customer config guided by a wizard 🧙‍

package/dist/commands/extension/add.d.ts

@@ -0,0 +1,9 @@
+import { Command } from "@oclif/core";
+export default class ExtensionAdd extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        ref: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/extension/add.js

@@ -0,0 +1,41 @@
+import { Args, Command } from "@oclif/core";
+import { CliServiceFactory } from "../../services/cli/index.js";
+import { SetupServiceFactory } from "../../services/setup/index.js";
+export default class ExtensionAdd extends Command {
+    static description = "Install a Chrome extension into the onboarding browser by Web Store link or id";
+    static examples = [
+        "$ sk extension add fmkadmapgofadopljbjfkapdkoienihi",
+        "$ sk extension add https://chromewebstore.google.com/detail/react-developer-tools/fmkadmapgofadopljbjfkapdkoienihi",
+        "$ sk extension add",
+    ];
+    static args = {
+        ref: Args.string({
+            name: "ref",
+            required: false,
+            description: "Chrome Web Store link or extension id",
+        }),
+    };
+    async run() {
+        const { args } = await this.parse(ExtensionAdd);
+        const cli = new CliServiceFactory().getService();
+        const { extensions } = new SetupServiceFactory(this.config).getService();
+        let ref = args.ref;
+        if (!ref) {
+            ref = await cli.prompt("Paste a Chrome Web Store link or extension id", {
+                defaultAnswer: "",
+            });
+        }
+        if (!ref?.trim()) {
+            cli.writeWarning("No extension provided.");
+            return;
+        }
+        cli.writeWarning("Only add extensions you trust — they are loaded into the onboarding browser.");
+        try {
+            const ext = await extensions.addFromInput(ref);
+            cli.writeSuccess(`Installed ${ext.name} ${ext.version}`);
+        }
+        catch (error) {
+            cli.writeError(`Could not install extension: ${error?.message ?? error}`);
+        }
+    }
+}

package/dist/commands/extension/list.d.ts

@@ -0,0 +1,6 @@
+import { Command } from "@oclif/core";
+export default class ExtensionList extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/extension/list.js

@@ -0,0 +1,27 @@
+import { Command } from "@oclif/core";
+import { CliServiceFactory } from "../../services/cli/index.js";
+import { SetupServiceFactory } from "../../services/setup/index.js";
+export default class ExtensionList extends Command {
+    static description = "List Chrome extensions managed by the setup wizard";
+    static examples = ["$ sk extension list"];
+    async run() {
+        const cli = new CliServiceFactory().getService();
+        const { extensions } = new SetupServiceFactory(this.config).getService();
+        const list = extensions.list();
+        if (list.length === 0) {
+            cli.writeWarning("No managed extensions installed.");
+            return;
+        }
+        cli.table(list.map((ext) => ({
+            name: ext.name,
+            version: ext.version,
+            id: ext.id,
+            path: ext.path,
+        })), {
+            name: { header: "Name" },
+            version: { header: "Version" },
+            id: { header: "Id" },
+            path: { header: "Path" },
+        });
+    }
+}

package/dist/commands/extension/remove.d.ts

@@ -0,0 +1,9 @@
+import { Command } from "@oclif/core";
+export default class ExtensionRemove extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        ref: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/extension/remove.js

@@ -0,0 +1,38 @@
+import { Args, Command } from "@oclif/core";
+import { CliServiceFactory } from "../../services/cli/index.js";
+import { parseExtensionId, SetupServiceFactory, } from "../../services/setup/index.js";
+export default class ExtensionRemove extends Command {
+    static description = "Remove a managed Chrome extension";
+    static examples = ["$ sk extension remove", "$ sk extension remove <id>"];
+    static args = {
+        ref: Args.string({
+            name: "ref",
+            required: false,
+            description: "Chrome Web Store link or extension id",
+        }),
+    };
+    async run() {
+        const { args } = await this.parse(ExtensionRemove);
+        const cli = new CliServiceFactory().getService();
+        const { extensions } = new SetupServiceFactory(this.config).getService();
+        const list = extensions.list();
+        if (list.length === 0) {
+            cli.writeWarning("No managed extensions to remove.");
+            return;
+        }
+        let id = args.ref ? parseExtensionId(args.ref) : null;
+        if (!id) {
+            id = await cli.select("Which extension should be removed?", list.map((ext) => ({
+                name: `${ext.name} (${ext.version})`,
+                value: ext.id,
+            })));
+        }
+        const removed = await extensions.remove(id);
+        if (removed) {
+            cli.writeSuccess(`Removed extension ${id}`);
+        }
+        else {
+            cli.writeWarning(`Extension not found: ${id}`);
+        }
+    }
+}

package/dist/commands/extension/update.d.ts

@@ -0,0 +1,6 @@
+import { Command } from "@oclif/core";
+export default class ExtensionUpdate extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/extension/update.js

@@ -0,0 +1,20 @@
+import { Command } from "@oclif/core";
+import { CliServiceFactory } from "../../services/cli/index.js";
+import { SetupServiceFactory } from "../../services/setup/index.js";
+export default class ExtensionUpdate extends Command {
+    static description = "Check managed Chrome extensions for updates and install them";
+    static examples = ["$ sk extension update"];
+    async run() {
+        const cli = new CliServiceFactory().getService();
+        const { extensions } = new SetupServiceFactory(this.config).getService();
+        const list = extensions.list();
+        if (list.length === 0) {
+            cli.writeWarning("No managed extensions to update.");
+            return;
+        }
+        cli.startAction("EXT:CHECK", "Checking extensions for updates…");
+        cli.endAction("EXT:CHECK");
+        await extensions.updateAll();
+        cli.writeSuccess("Extension update check complete.");
+    }
+}

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

@@ -5,6 +5,8 @@ export default class GenerateCustomerConfig extends Command {
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         customersDirectory: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        templates: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        mode: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

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

@@ -16,10 +16,18 @@ export default class GenerateCustomerConfig extends Command {
             char: CLIParametersChar.CustomersDirectory,
             description: `Name of the sk-onboarding directory where all customer configs are being stored (default: "${CLIParametersExample.CustomersDirectory}")`,
         }),
+        templates: Flags.string({
+            description: "Path to the templates/ root (default: the sk-onboarding checkout the CLI runs in, or the sk-onboarding repo on GitLab when run standalone)",
+        }),
+        mode: Flags.string({
+            options: ["customer-config", "pre-poc"],
+            default: "customer-config",
+            description: "Which config to scaffold: the full acceleration config, or the tracking-only pre-PoC config",
+        }),
     };
     async run() {
-        const { flags: { app, customersDirectory }, } = await this.parse(GenerateCustomerConfig);
-        const context = new CustomerConfigServiceContext(app, customersDirectory);
+        const { flags: { app, customersDirectory, templates, mode }, } = await this.parse(GenerateCustomerConfig);
+        const context = new CustomerConfigServiceContext(app, customersDirectory, templates, mode);
         const customerConfigService = await new CustomerConfigServiceFactory(context).buildService();
         await customerConfigService.generateConfig();
     }

package/dist/helpers/cli-config.d.ts

@@ -1,4 +1,13 @@
 import { Config } from "@oclif/core";
+/** A Chrome extension installed via the setup wizard and tracked for updates. */
+export interface ManagedExtension {
+    /** Chrome Web Store extension id */
+    id: string;
+    name: string;
+    version: string;
+    /** absolute path to the unpacked extension directory */
+    path: string;
+}
 export interface UserCliConfig {
     chromeExtensionPaths: string;
     chromePath: string;
@@ -14,6 +23,8 @@ export interface UserCliConfig {
     browserAutoUpdate: boolean;
     updateReminderDays: number;
     lastBrowserUpdateCheck: string;
+    managedChromeExtensions: ManagedExtension[];
+    lastExtensionUpdateCheck: string;
     firstRunCompleted: boolean;
     tempFolder: string;
     runtimeConfig: Config;

package/dist/helpers/cli-config.js

@@ -36,6 +36,8 @@ export class CliConfig {
         browserAutoUpdate: false,
         updateReminderDays: 3,
         lastBrowserUpdateCheck: "",
+        managedChromeExtensions: [],
+        lastExtensionUpdateCheck: "",
         firstRunCompleted: false,
         tempFolder: "/tmp",
         runtimeConfig: {},
@@ -74,6 +76,8 @@ export class CliConfig {
             browserAutoUpdate: false,
             updateReminderDays: 3,
             lastBrowserUpdateCheck: "",
+            managedChromeExtensions: [],
+            lastExtensionUpdateCheck: "",
             firstRunCompleted: false,
         };
     }

package/dist/helpers/cli-config.spec.js

@@ -67,4 +67,17 @@ describe("CliConfig save/load", () => {
         const reloaded = new CliConfig(fakeOclifConfig(dir)).load();
         expect(reloaded.browserAutoUpdate).to.equal(false);
     });
+    it("round-trips the managedChromeExtensions array", () => {
+        const cfg = new CliConfig(fakeOclifConfig(dir));
+        cfg.load();
+        cfg.save({
+            managedChromeExtensions: [
+                { id: "abc", name: "Ext", version: "1.0.0", path: "/tmp/ext/abc" },
+            ],
+        });
+        const reloaded = new CliConfig(fakeOclifConfig(dir)).load();
+        expect(reloaded.managedChromeExtensions).to.have.length(1);
+        expect(reloaded.managedChromeExtensions[0].id).to.equal("abc");
+        expect(reloaded.managedChromeExtensions[0].version).to.equal("1.0.0");
+    });
 });

package/dist/hooks/init/first-run.js

@@ -28,6 +28,7 @@ const hook = async function (opts) {
         }
         const service = new SetupServiceFactory(config).getService();
         await service.remindBrowserUpdate();
+        await service.remindExtensionUpdates();
     }
     catch {
         // never block a command because of setup housekeeping

package/dist/services/customer-config/customer-config-service-context.d.ts

@@ -1,5 +1,13 @@
 export declare class CustomerConfigServiceContext {
     appName: string;
     customersDirectory: string;
-    constructor(appName?: string, customersDirectory?: string);
+    /** Explicit templates/ root; overrides checkout detection and the remote fetch. */
+    templatesPath?: string;
+    /** Template set = wizard mode: "customer-config" (default) or "pre-poc". */
+    mode: string;
+    constructor(appName?: string, customersDirectory?: string, 
+    /** Explicit templates/ root; overrides checkout detection and the remote fetch. */
+    templatesPath?: string, 
+    /** Template set = wizard mode: "customer-config" (default) or "pre-poc". */
+    mode?: string);
 }

package/dist/services/customer-config/customer-config-service-context.js

@@ -2,10 +2,20 @@ import { CLIParametersExample } from "../../models/cli-parameters.js";
 export class CustomerConfigServiceContext {
     appName;
     customersDirectory;
-    constructor(appName = "", customersDirectory = CLIParametersExample.CustomersDirectory) {
+    templatesPath;
+    mode;
+    constructor(appName = "", customersDirectory = CLIParametersExample.CustomersDirectory, 
+    /** Explicit templates/ root; overrides checkout detection and the remote fetch. */
+    templatesPath, 
+    /** Template set = wizard mode: "customer-config" (default) or "pre-poc". */
+    mode = "customer-config") {
         this.appName = appName;
         this.customersDirectory = customersDirectory;
+        this.templatesPath = templatesPath;
+        this.mode = mode;
         this.appName = appName;
         this.customersDirectory = customersDirectory;
+        this.templatesPath = templatesPath;
+        this.mode = mode;
     }
 }

package/dist/services/customer-config/customer-config-service-model.d.ts

@@ -59,3 +59,9 @@ export interface CustomerConfigSettings {
     isPlentymarkets?: boolean;
     addDowntimeDetection?: boolean;
 }
+/**
+ * Every variable this CLI can hand to the wizard templates — the template
+ * manifest in sk-onboarding must be a subset. Extend this together with
+ * `CustomerConfigSettings` when the wizard gains a question.
+ */
+export declare const TEMPLATE_VARIABLES: readonly string[];

package/dist/services/customer-config/customer-config-service-model.js

@@ -32,3 +32,39 @@ export var EnvironmentType;
     EnvironmentType["STAGING"] = "staging";
     EnvironmentType["TEST"] = "test";
 })(EnvironmentType || (EnvironmentType = {}));
+/**
+ * Every variable this CLI can hand to the wizard templates — the template
+ * manifest in sk-onboarding must be a subset. Extend this together with
+ * `CustomerConfigSettings` when the wizard gains a question.
+ */
+export const TEMPLATE_VARIABLES = [
+    "appName",
+    "production.host",
+    "production.forceInstall",
+    "staging.host",
+    "staging.forceInstall",
+    "activateScopedDeployments",
+    "subRouteScope",
+    "includeServiceWorker",
+    "activateImageOptimisation",
+    "removeLazyLoading",
+    "addSSR",
+    "addSSRInnerShadowDomSupport",
+    "addDeviceDetection",
+    "useGATracking",
+    "useScrapingBee",
+    "withGoogleOptimize",
+    "activateCfRocketLoaderPlugin",
+    "hasSoftNavigations",
+    "convertSoftToHardNavigations",
+    "handleUsercentrics",
+    "isPOV",
+    "useDisabledSitesApproach",
+    "shopSystemName",
+    "isShopify",
+    "isShopware",
+    "isSalesforce",
+    "isOxid",
+    "isPlentymarkets",
+    "addDowntimeDetection",
+];

package/dist/services/customer-config/customer-config-service.d.ts

@@ -10,15 +10,20 @@ export declare class CustomerConfigService {
     private set appName(value);
     private set outputDirPath(value);
     private get outputDirPath();
-    private templates;
+    /** Set from the "Downtime Detection" feature answer in the wizard. */
+    private includeDowntimeDetection;
     constructor(context: CustomerConfigServiceContext, cli: CliService);
     private getOutputDirPath;
-    private getHandlebarsOutputFileName;
+    private getOutputFileName;
     private getPathWithChangedDir;
     private isDirNotEmpty;
     private chooseNewOutputDirectoryName;
+    /** A pre-PoC config marks itself via splitTestId "pre_poc" in config_SpeedKit.js. */
+    private isPrePocConfig;
+    /** Parks every config_* file as *_pre-poc (suffix before the extension). */
+    private renamePrePocFiles;
     private selectOutputDirectory;
-    private compileHandlebarsFiles;
+    private compileTemplateFiles;
     private getEnvironmentConfig;
     private shouldFileBeOverwritten;
     private getConfigSettings;