@shopify/cli-kit 0.0.0-snapshot-20260722210655 → 0.0.0-snapshot-20260723175937

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shopify/cli-kit",
-  "version": "0.0.0-snapshot-20260722210655",
+  "version": "0.0.0-snapshot-20260723175937",
   "private": false,
   "description": "A set of utilities, interfaces, and models that are common across all the platform features",
   "keywords": [

package/dist/public/node/skills.d.ts

@@ -1,42 +0,0 @@
-import { LocalStorage } from './local-storage.js';
-import { ConfSchema } from '../../private/node/conf-store.js';
-/**
- * Options for {@link installShopifySkillInBackground}.
- */
-export interface InstallShopifySkillInBackgroundOptions {
-    /** The command being run, used to avoid recursive installs from `skill` commands. */
-    currentCommand: string;
-    /** The process argv, used to re-invoke the current CLI binary. */
-    argv?: string[];
-    /** The process environment. */
-    env?: NodeJS.ProcessEnv;
-    /** The cli-kit local storage, injectable for testing. */
-    config?: LocalStorage<ConfSchema>;
-    /** The user's home directory, injectable for testing. */
-    homeDir?: string;
-}
-/**
- * Checks whether the Shopify skill for coding agents is installed globally.
- *
- * The skills CLI installs universal skills under `~/.agents/skills` (older versions)
- * or `$XDG_CONFIG_HOME/agents/skills` (newer versions), so both locations are checked.
- *
- * @param env - The process environment.
- * @param homeDir - The user's home directory.
- * @returns Whether the Shopify skill is installed in any known global location.
- */
-export declare function shopifySkillIsInstalled(env?: NodeJS.ProcessEnv, homeDir?: string): boolean;
-/**
- * Installs the Shopify skill for coding agents by running `shopify skill install`
- * in a detached background process, so the current command is never delayed.
- *
- * The install is attempted at most once per day until it succeeds. Once the skill
- * is detected as installed, a completion flag is recorded and the check becomes a
- * no-op forever, so deliberately uninstalling the skill won't trigger a re-install.
- *
- * Skipped for `skill` commands (to avoid recursion), in CI, in unit tests, in
- * development mode, and when `SHOPIFY_CLI_NO_SKILL_AUTO_INSTALL` is set.
- *
- * @param options - See {@link InstallShopifySkillInBackgroundOptions}.
- */
-export declare function installShopifySkillInBackground(options: InstallShopifySkillInBackgroundOptions): Promise<void>;

package/dist/public/node/skills.js

@@ -1,76 +0,0 @@
-import { homeDirectory, isDevelopment } from './context/local.js';
-import { isTruthy } from './context/utilities.js';
-import { fileExistsSync } from './fs.js';
-import { outputDebug } from './output.js';
-import { joinPath } from './path.js';
-import { exec } from './system.js';
-import { getSkillAutoInstallCompleted, setSkillAutoInstallCompleted, runAtMinimumInterval, } from '../../private/node/conf-store.js';
-/**
- * Checks whether the Shopify skill for coding agents is installed globally.
- *
- * The skills CLI installs universal skills under `~/.agents/skills` (older versions)
- * or `$XDG_CONFIG_HOME/agents/skills` (newer versions), so both locations are checked.
- *
- * @param env - The process environment.
- * @param homeDir - The user's home directory.
- * @returns Whether the Shopify skill is installed in any known global location.
- */
-export function shopifySkillIsInstalled(env = process.env, homeDir = homeDirectory()) {
-    const configHome = env.XDG_CONFIG_HOME ?? joinPath(homeDir, '.config');
-    const skillDirectories = [
-        joinPath(homeDir, '.agents', 'skills', 'shopify'),
-        joinPath(configHome, 'agents', 'skills', 'shopify'),
-    ];
-    return skillDirectories.some(fileExistsSync);
-}
-/**
- * Installs the Shopify skill for coding agents by running `shopify skill install`
- * in a detached background process, so the current command is never delayed.
- *
- * The install is attempted at most once per day until it succeeds. Once the skill
- * is detected as installed, a completion flag is recorded and the check becomes a
- * no-op forever, so deliberately uninstalling the skill won't trigger a re-install.
- *
- * Skipped for `skill` commands (to avoid recursion), in CI, in unit tests, in
- * development mode, and when `SHOPIFY_CLI_NO_SKILL_AUTO_INSTALL` is set.
- *
- * @param options - See {@link InstallShopifySkillInBackgroundOptions}.
- */
-export async function installShopifySkillInBackground(options) {
-    const { currentCommand, argv = process.argv, env = process.env, config, homeDir } = options;
-    if (skipSkillAutoInstall(currentCommand, env))
-        return;
-    if (getSkillAutoInstallCompleted(config))
-        return;
-    if (shopifySkillIsInstalled(env, homeDir)) {
-        setSkillAutoInstallCompleted(config);
-        return;
-    }
-    const nodeBinary = argv[0];
-    const shopifyBinary = argv[1];
-    if (!nodeBinary || !shopifyBinary)
-        return;
-    // Retry at most once per day until the skill install succeeds. The timestamp is
-    // recorded when the background process is spawned, not when it finishes, so a
-    // failed install is retried on the first command run a day later.
-    await runAtMinimumInterval('skill-auto-install', { days: 1 }, async () => {
-        // Run the Shopify command the same way as the current execution, detached
-        // from the current process so the CLI can exit before the install finishes.
-        // eslint-disable-next-line no-void
-        void exec(nodeBinary, [shopifyBinary, 'skill', 'install'], {
-            background: true,
-            env: { ...env, SHOPIFY_CLI_NO_ANALYTICS: '1' },
-            externalErrorHandler: async (error) => {
-                outputDebug(`Failed to install the Shopify skill in background: ${error.message}`);
-            },
-        });
-    }, config);
-}
-function skipSkillAutoInstall(currentCommand, env) {
-    return (currentCommand.startsWith('skill') ||
-        isTruthy(env.CI) ||
-        isTruthy(env.SHOPIFY_UNIT_TEST) ||
-        isTruthy(env.SHOPIFY_CLI_NO_SKILL_AUTO_INSTALL) ||
-        isDevelopment(env));
-}
-//# sourceMappingURL=skills.js.map

package/dist/public/node/skills.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/public/node/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,oBAAoB,CAAA;AAC/D,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAA;AAC/C,OAAO,EAAC,cAAc,EAAC,MAAM,SAAS,CAAA;AACtC,OAAO,EAAC,WAAW,EAAC,MAAM,aAAa,CAAA;AACvC,OAAO,EAAC,QAAQ,EAAC,MAAM,WAAW,CAAA;AAClC,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,OAAO,EAEL,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,kCAAkC,CAAA;AAsBzC;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAyB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,EAAE;IACrG,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe,IAAI,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IACtE,MAAM,gBAAgB,GAAG;QACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC;QACjD,QAAQ,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC;KACpD,CAAA;IACD,OAAO,gBAAgB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;AAC9C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,OAA+C;IACnG,MAAM,EAAC,cAAc,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAC,GAAG,OAAO,CAAA;IAEzF,IAAI,oBAAoB,CAAC,cAAc,EAAE,GAAG,CAAC;QAAE,OAAM;IACrD,IAAI,4BAA4B,CAAC,MAAM,CAAC;QAAE,OAAM;IAChD,IAAI,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC;QAC1C,4BAA4B,CAAC,MAAM,CAAC,CAAA;QACpC,OAAM;IACR,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IAC1B,MAAM,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IAC7B,IAAI,CAAC,UAAU,IAAI,CAAC,aAAa;QAAE,OAAM;IAEzC,gFAAgF;IAChF,8EAA8E;IAC9E,kEAAkE;IAClE,MAAM,oBAAoB,CACxB,oBAAoB,EACpB,EAAC,IAAI,EAAE,CAAC,EAAC,EACT,KAAK,IAAI,EAAE;QACT,0EAA0E;QAC1E,4EAA4E;QAC5E,mCAAmC;QACnC,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE;YACzD,UAAU,EAAE,IAAI;YAChB,GAAG,EAAE,EAAC,GAAG,GAAG,EAAE,wBAAwB,EAAE,GAAG,EAAC;YAC5C,oBAAoB,EAAE,KAAK,EAAE,KAAc,EAAE,EAAE;gBAC7C,WAAW,CAAC,sDAAuD,KAAe,CAAC,OAAO,EAAE,CAAC,CAAA;YAC/F,CAAC;SACF,CAAC,CAAA;IACJ,CAAC,EACD,MAAM,CACP,CAAA;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,cAAsB,EAAE,GAAsB;IAC1E,OAAO,CACL,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC;QAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAChB,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC/B,QAAQ,CAAC,GAAG,CAAC,iCAAiC,CAAC;QAC/C,aAAa,CAAC,GAAG,CAAC,CACnB,CAAA;AACH,CAAC","sourcesContent":["import {homeDirectory, isDevelopment} from './context/local.js'\nimport {isTruthy} from './context/utilities.js'\nimport {fileExistsSync} from './fs.js'\nimport {outputDebug} from './output.js'\nimport {joinPath} from './path.js'\nimport {exec} from './system.js'\nimport {LocalStorage} from './local-storage.js'\nimport {\n  ConfSchema,\n  getSkillAutoInstallCompleted,\n  setSkillAutoInstallCompleted,\n  runAtMinimumInterval,\n} from '../../private/node/conf-store.js'\n\n/**\n * Options for {@link installShopifySkillInBackground}.\n */\nexport interface InstallShopifySkillInBackgroundOptions {\n  /** The command being run, used to avoid recursive installs from `skill` commands. */\n  currentCommand: string\n\n  /** The process argv, used to re-invoke the current CLI binary. */\n  argv?: string[]\n\n  /** The process environment. */\n  env?: NodeJS.ProcessEnv\n\n  /** The cli-kit local storage, injectable for testing. */\n  config?: LocalStorage<ConfSchema>\n\n  /** The user's home directory, injectable for testing. */\n  homeDir?: string\n}\n\n/**\n * Checks whether the Shopify skill for coding agents is installed globally.\n *\n * The skills CLI installs universal skills under `~/.agents/skills` (older versions)\n * or `$XDG_CONFIG_HOME/agents/skills` (newer versions), so both locations are checked.\n *\n * @param env - The process environment.\n * @param homeDir - The user's home directory.\n * @returns Whether the Shopify skill is installed in any known global location.\n */\nexport function shopifySkillIsInstalled(env: NodeJS.ProcessEnv = process.env, homeDir = homeDirectory()): boolean {\n  const configHome = env.XDG_CONFIG_HOME ?? joinPath(homeDir, '.config')\n  const skillDirectories = [\n    joinPath(homeDir, '.agents', 'skills', 'shopify'),\n    joinPath(configHome, 'agents', 'skills', 'shopify'),\n  ]\n  return skillDirectories.some(fileExistsSync)\n}\n\n/**\n * Installs the Shopify skill for coding agents by running `shopify skill install`\n * in a detached background process, so the current command is never delayed.\n *\n * The install is attempted at most once per day until it succeeds. Once the skill\n * is detected as installed, a completion flag is recorded and the check becomes a\n * no-op forever, so deliberately uninstalling the skill won't trigger a re-install.\n *\n * Skipped for `skill` commands (to avoid recursion), in CI, in unit tests, in\n * development mode, and when `SHOPIFY_CLI_NO_SKILL_AUTO_INSTALL` is set.\n *\n * @param options - See {@link InstallShopifySkillInBackgroundOptions}.\n */\nexport async function installShopifySkillInBackground(options: InstallShopifySkillInBackgroundOptions): Promise<void> {\n  const {currentCommand, argv = process.argv, env = process.env, config, homeDir} = options\n\n  if (skipSkillAutoInstall(currentCommand, env)) return\n  if (getSkillAutoInstallCompleted(config)) return\n  if (shopifySkillIsInstalled(env, homeDir)) {\n    setSkillAutoInstallCompleted(config)\n    return\n  }\n\n  const nodeBinary = argv[0]\n  const shopifyBinary = argv[1]\n  if (!nodeBinary || !shopifyBinary) return\n\n  // Retry at most once per day until the skill install succeeds. The timestamp is\n  // recorded when the background process is spawned, not when it finishes, so a\n  // failed install is retried on the first command run a day later.\n  await runAtMinimumInterval(\n    'skill-auto-install',\n    {days: 1},\n    async () => {\n      // Run the Shopify command the same way as the current execution, detached\n      // from the current process so the CLI can exit before the install finishes.\n      // eslint-disable-next-line no-void\n      void exec(nodeBinary, [shopifyBinary, 'skill', 'install'], {\n        background: true,\n        env: {...env, SHOPIFY_CLI_NO_ANALYTICS: '1'},\n        externalErrorHandler: async (error: unknown) => {\n          outputDebug(`Failed to install the Shopify skill in background: ${(error as Error).message}`)\n        },\n      })\n    },\n    config,\n  )\n}\n\nfunction skipSkillAutoInstall(currentCommand: string, env: NodeJS.ProcessEnv): boolean {\n  return (\n    currentCommand.startsWith('skill') ||\n    isTruthy(env.CI) ||\n    isTruthy(env.SHOPIFY_UNIT_TEST) ||\n    isTruthy(env.SHOPIFY_CLI_NO_SKILL_AUTO_INSTALL) ||\n    isDevelopment(env)\n  )\n}\n"]}