Skip to content

[stable/5.0] Release only the tested Version Packages head, and only the versions a push changed - #9168

Merged
craigmichaelmartin merged 1 commit into
stable/5.0from
release-publish-pushed-versions-5.0
Nov 18, 2026
Merged

craigmichaelmartin merged 1 commit into
stable/5.0from
release-publish-pushed-versions-5.0

Conversation

@craigmichaelmartin

Copy link
Copy Markdown
Contributor

WHY are these changes introduced?

Backport of #9165 to stable/5.0. Each line publishes with its own copy of the release workflow, so this line needs the same rules as main.

WHAT is this pull request doing?

Brings .github/workflows/release.yml and .github/workflows/release-qa-package.yml to their #9165 versions. Pushes to this line then publish only from the merge of its Version Packages pull request, and only when the merged files equal that pull request's tested head. A push publishes only the versions it changed, and Version Packages refuses a version npm already has.

How to manually test your changes?

Compare the two files with main's: git diff origin/main -- .github/workflows/release.yml .github/workflows/release-qa-package.yml shows no differences.

🤖 Generated with Claude Code

…a push changed

Backport of the main change, so this line publishes with the same rules: only from the merge of
its Version Packages pull request whose files equal the tested head, only the versions the push
changed, and never a version npm already has. Adds the manual workflow that builds a release
tarball for testing.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@craigmichaelmartin
craigmichaelmartin requested a review from a team as a code owner November 18, 2026 18:19
@craigmichaelmartin
craigmichaelmartin merged commit 8e6cf1f into stable/5.0 Nov 18, 2026
10 of 23 checks passed
@craigmichaelmartin
craigmichaelmartin deleted the release-publish-pushed-versions-5.0 branch November 18, 2026 18:19
@github-actions github-actions Bot added the no-changelog This PR doesn't include a changeset entry. Is an internal only change not relevant to end users. label Nov 18, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Differences in type declarations

We detected differences in the type declarations generated by Typescript for this branch compared to the baseline ('main' branch). Please, review them to ensure they are backward-compatible. Here are some important things to keep in mind:

  • Some seemingly private modules might be re-exported through public modules.
  • If the branch is behind main you might see odd diffs, rebase main into this branch.

New type declarations

We found no new type declarations in this PR

Existing type declarations

packages/cli-kit/dist/public/common/command-events.d.ts
@@ -1,4 +1,4 @@
-import { z } from 'zod/v3';
+import { z } from 'zod';
 /** Schema for a diagnostic emitted while a command executes. */
 export declare const commandDiagnosticEventSchema: z.ZodObject<{
     type: z.ZodLiteral<"diagnostic">;
packages/cli-kit/dist/public/common/json-output-schema.d.ts
@@ -1,5 +1,4 @@
-import { z } from 'zod/v3';
-export declare const jsonOutputStoreDomainSchema: z.ZodString;
+import { z } from 'zod';
 /** UTC instants in CLI-owned JSON use whole seconds and the Z timezone marker. */
 export declare const jsonOutputTimestampSchema: z.ZodString;
 /**
packages/cli-kit/dist/public/common/version.d.ts
@@ -1 +1 @@
-export declare const CLI_KIT_VERSION = "5.0.0";
\ No newline at end of file
+export declare const CLI_KIT_VERSION = "5.0.2";
\ No newline at end of file
packages/cli-kit/dist/private/node/api.d.ts
@@ -1,24 +1,14 @@
 import { Headers } from 'form-data';
-import { ClientError } from 'graphql-request';
 export type API = 'admin' | 'storefront-renderer' | 'partners' | 'business-platform' | 'app-management';
 export declare const allAPIs: API[];
-interface CommonRetryBehaviour {
-    recordCommandRetries?: boolean;
-    /**
-     * Retry, with backoff, requests that fail with a transient server-side error: a GraphQL
-     * `INTERNAL_SERVER_ERROR` (usually on an HTTP 200) or an HTTP 502, 503, 504 or 520 to 524.
-     *
-     * Only enable this for requests that are safe to repeat. GraphQL requests only honour it for
-     * queries; mutations are never retried on these errors.
-     */
-    retryTransientServerErrors?: boolean;
-}
-export type NetworkRetryBehaviour = ({
+export type NetworkRetryBehaviour = {
     useNetworkLevelRetry: true;
     maxRetryTimeMs: number;
-} & CommonRetryBehaviour) | ({
+    recordCommandRetries?: boolean;
+} | {
     useNetworkLevelRetry: false;
-} & CommonRetryBehaviour);
+    recordCommandRetries?: boolean;
+};
 type RequestOptions<T> = {
     request: () => Promise<T>;
     url: string;
@@ -62,15 +52,6 @@ export declare function isNetworkError(error: unknown): boolean;
  * @returns A boolean indicating if the request was aborted.
  */
 export declare function isAbortedFetchError(error: unknown): boolean;
-/**
- * Checks whether an error is a transient server-side failure that is likely to succeed if retried:
- * a GraphQL `INTERNAL_SERVER_ERROR` (Shopify APIs usually return it on an HTTP 200), or an HTTP
- * 502, 503, 504 or 520 to 524.
- *
- * @param error - The error to check.
- * @returns Whether the error is a transient server-side failure.
- */
-export declare function isTransientServerError(error: unknown): error is ClientError;
 export declare function simpleRequestWithDebugLog<T extends {
     headers: Headers;
     status: number;
packages/cli-kit/dist/private/node/conf-store.d.ts
@@ -73,7 +73,7 @@ export declare function cacheStore(key: ExportedKey, value: string, config?: Loc
 /**
  * Fetch from cache if already populated, otherwise return undefined.
  * @param key - The key to use for the cache.
- * @returns The cache element.
+ * @returns The chache element.
  */
 export declare function cacheRetrieve(key: ExportedKey, config?: LocalStorage<ConfSchema>): CacheValue<string> | undefined;
 export declare function cacheClear(config?: LocalStorage<ConfSchema>): void;
packages/cli-kit/dist/private/node/constants.d.ts
@@ -8,7 +8,6 @@ export declare const environmentVariables: {
     env: string;
     noAnalytics: string;
     optOutInstrumentation: string;
-    doNotTrack: string;
     serviceAccountToken: string;
     appAutomationToken: string;
     partnersToken: string;
packages/cli-kit/dist/private/node/dev-instance-output.d.ts
@@ -2,18 +2,18 @@ import { zod } from '../../public/node/schema.js';
 import { Writable, type WritableOptions } from 'stream';
 export declare const devInstanceLogOutputSchema: import("../../public/node/json-output-schema.js").JsonOutputSchema<zod.ZodObject<{
     timestamp: zod.ZodString;
-    source: zod.ZodOptional<zod.ZodString>;
+    source: zod.ZodString;
     level: zod.ZodOptional<zod.ZodEnum<["debug", "info", "warning", "error"]>>;
     message: zod.ZodString;
 }, "strict", zod.ZodTypeAny, {
+    source: string;
     message: string;
     timestamp: string;
-    source?: string | undefined;
     level?: "info" | "error" | "debug" | "warning" | undefined;
 }, {
+    source: string;
     message: string;
     timestamp: string;
-    source?: string | undefined;
     level?: "info" | "error" | "debug" | "warning" | undefined;
 }>>;
 /** One line of a dev instance's JSON Lines log. */
@@ -30,7 +30,7 @@ export declare function createDevInstanceOutput({ logFile, logOutput, isActive,
         timestamp?: string;
     }) => Promise<void>;
     tee: (target: Writable, { source, stringWritesAreMessages }: {
-        source?: string;
+        source: string;
         stringWritesAreMessages?: boolean;
     }) => DevInstanceOutput;
     flush: () => Promise<PromiseSettledResult<void>[]>;
packages/cli-kit/dist/private/node/output-context.d.ts
@@ -2,8 +2,6 @@ export interface ConcurrentOutputContext {
     outputPrefix?: string;
     /** Controls ANSI stripping for terminal output. JSON diagnostics are always unstyled. */
     stripAnsi?: boolean;
-    /** Captures console messages before the terminal renderer handles them. */
-    consoleWarn?: (message: string) => void;
 }
 export declare function useConcurrentOutputContext<T>(context: ConcurrentOutputContext, callback: () => T): T;
 /** Returns the source and styling context for the current output write. */
packages/cli-kit/dist/public/node/base-command.d.ts
@@ -13,7 +13,7 @@ export interface NonTTYFlagRequirement {
 declare abstract class BaseCommand extends Command {
     static baseFlags: FlagInput<{}>;
     static descriptionWithMarkdown?: string;
-    static jsonOutputSchema?: JsonOutputSchema;
+    static get jsonOutputSchema(): JsonOutputSchema | undefined;
     static get requiresSyncAnalytics(): boolean;
     static nonTTYFlagRequirements(_flags: FlagOutput): NonTTYFlagRequirement[];
     static descriptionForHelp(): string | undefined;
@@ -39,8 +39,6 @@ declare abstract class BaseCommand extends Command {
     }>;
     protected runWithParsedOutput<T>(flags: FlagOutput, execute: () => T): T;
     protected environmentsFilename(): string | undefined;
-    /** Filters configuration flags before they are applied, validated, or reported. */
-    protected filterEnvironmentFlags(environment: FlagOutput): FlagOutput;
     protected parseEnvironmentFlags<TFlags extends FlagOutput, TGlobalFlags extends FlagOutput, TArgs extends ArgOutput>(environment: JsonMap, options: Input<TFlags, TGlobalFlags, TArgs>, explicitFlags: FlagOutput): Promise<FlagOutput>;
     protected validateNonTTYFlags(flags: FlagOutput): void;
     protected failMissingNonTTYFlags(flags: FlagOutput, requiredFlags: string[]): void;
packages/cli-kit/dist/public/node/command-events.d.ts
@@ -8,13 +8,13 @@ export { commandEventOutputMode, emitCommandEvent, runWithCommandEvents, type Co
  * @returns The result of the command lifecycle.
  */
 export declare function runWithCommandEventsForCommand<TResult>(argv: string[], execute: () => TResult): TResult;
-export declare const commandEventOutputSchema: import("./json-output-schema.js").JsonOutputSchema<import("zod/v3").ZodDiscriminatedUnion<"type", [import("zod/v3").ZodObject<{
-    type: import("zod/v3").ZodLiteral<"diagnostic">;
-    timestamp: import("zod/v3").ZodString;
-    level: import("zod/v3").ZodEnum<["debug", "info", "warning", "error"]>;
-    message: import("zod/v3").ZodString;
-    code: import("zod/v3").ZodOptional<import("zod/v3").ZodString>;
-}, "strict", import("zod/v3").ZodTypeAny, {
+export declare const commandEventOutputSchema: import("./json-output-schema.js").JsonOutputSchema<import("zod").ZodDiscriminatedUnion<"type", [import("zod").ZodObject<{
+    type: import("zod").ZodLiteral<"diagnostic">;
+    timestamp: import("zod").ZodString;
+    level: import("zod").ZodEnum<["debug", "info", "warning", "error"]>;
+    message: import("zod").ZodString;
+    code: import("zod").ZodOptional<import("zod").ZodString>;
+}, "strict", import("zod").ZodTypeAny, {
     type: "diagnostic";
     message: string;
     timestamp: string;
@@ -26,15 +26,15 @@ export declare const commandEventOutputSchema: import("./json-output-schema.js")
     timestamp: string;
     level: "info" | "error" | "debug" | "warning";
     code?: string | undefined;
-}>, import("zod/v3").ZodObject<{
-    type: import("zod/v3").ZodLiteral<"progress">;
-    timestamp: import("zod/v3").ZodString;
-    status: import("zod/v3").ZodEnum<["started", "updated", "retrying", "completed", "failed"]>;
-    operation: import("zod/v3").ZodString;
-    message: import("zod/v3").ZodOptional<import("zod/v3").ZodString>;
-    current: import("zod/v3").ZodOptional<import("zod/v3").ZodNumber>;
-    total: import("zod/v3").ZodOptional<import("zod/v3").ZodNumber>;
-}, "strict", import("zod/v3").ZodTypeAny, {
+}>, import("zod").ZodObject<{
+    type: import("zod").ZodLiteral<"progress">;
+    timestamp: import("zod").ZodString;
+    status: import("zod").ZodEnum<["started", "updated", "retrying", "completed", "failed"]>;
+    operation: import("zod").ZodString;
+    message: import("zod").ZodOptional<import("zod").ZodString>;
+    current: import("zod").ZodOptional<import("zod").ZodNumber>;
+    total: import("zod").ZodOptional<import("zod").ZodNumber>;
+}, "strict", import("zod").ZodTypeAny, {
     type: "progress";
     status: "started" | "updated" | "retrying" | "completed" | "failed";
     timestamp: string;
packages/cli-kit/dist/public/node/dev-instance.d.ts
@@ -80,8 +80,7 @@ export interface DevInstance {
      * The returned stream forwards the original bytes to `target` unchanged.
      */
     tee: (target: Writable, options: {
-        /** Omit the source field when the stream does not need to distinguish producers. */
-        source?: string;
+        source: string;
         /** Treat each string write as a complete message. Byte writes remain buffered into lines. */
         stringWritesAreMessages?: boolean;
     }) => Writable;
packages/cli-kit/dist/public/node/is-global.d.ts
@@ -12,13 +12,6 @@ export declare function currentProcessIsGlobal(argv?: string[]): boolean;
  * @param packageManager - The package manager to use.
  */
 export declare function installGlobalShopifyCLI(packageManager: PackageManager): Promise<void>;
-/**
- * Returns the Homebrew formula that installed the running CLI.
- *
- * @param env - Environment variables set by the Homebrew wrapper.
- * @returns The wrapper's formula name, or the unversioned formula for older installs.
- */
-export declare function getHomebrewCLIFormula(env?: NodeJS.ProcessEnv): string;
 export interface InstallGlobalCLIPromptResult {
     install: boolean;
     alreadyInstalled: boolean;
packages/cli-kit/dist/public/node/json-output-schema.d.ts
@@ -1,6 +1,6 @@
 import { zodToJsonSchema } from 'zod-to-json-schema';
-import type { ZodTypeAny, z } from 'zod/v3';
-export { formatJsonOutputTimestamp, jsonOutputTimestampSchema, jsonOutputStoreDomainSchema, } from '../common/json-output-schema.js';
+import type { ZodTypeAny, z } from 'zod';
+export { formatJsonOutputTimestamp, jsonOutputTimestampSchema } from '../common/json-output-schema.js';
 interface JsonOutputSchemaDefinition<TSchema extends ZodTypeAny = ZodTypeAny> {
     readonly name: string;
     readonly schema: TSchema;
packages/cli-kit/dist/public/node/node-package-manager.d.ts
@@ -137,16 +137,13 @@ export declare function usesWorkspaces(appDirectory: string): Promise<boolean>;
  * @param currentVersion - The current version.
  * @param cacheExpiryInHours - If the last check was done more than this amount of hours ago, it will
  * refresh the cache. Defaults to always refreshing.
- * @param versionRange - An optional semver range that limits the versions considered.
  * @returns A promise that resolves with a more recent version or undefined if there's no more recent version.
  */
-export declare function checkForNewVersion(dependency: string, currentVersion: string, { cacheExpiryInHours, versionRange }?: {
+export declare function checkForNewVersion(dependency: string, currentVersion: string, { cacheExpiryInHours }?: {
     cacheExpiryInHours?: number | undefined;
-    versionRange?: string;
 }): Promise<string | undefined>;
 /**
  * Given an NPM dependency, it checks if there's a cached more recent version, and if there is, it returns its value.
- * For Shopify CLI, reads only fresh entries from the registry resolved by an earlier version lookup.
  * @param dependency - The dependency name (e.g. react)
  * @param currentVersion - The current version.
  * @returns A more recent version or undefined if there's no more recent version.
packages/cli-kit/dist/public/node/notifications-system.d.ts
@@ -172,7 +172,7 @@ export declare function showNotificationsIfNeeded(currentSurfaces?: string[], en
  */
 export declare function getNotifications(): Promise<Notifications>;
 /**
- * Fetch notifications from the CDN and cache them.
+ * Fetch notifications from the CDN and chache them.
  *
  * @returns A string with the notifications.
  */
packages/cli-kit/dist/public/node/schema.d.ts
@@ -1,5 +1,5 @@
-import { ZodObject, z } from 'zod/v3';
-export { z as zod } from 'zod/v3';
+import { ZodObject, z } from 'zod';
+export { z as zod } from 'zod';
 /**
  * Type alias for a zod object schema that produces a given shape once parsed.
  */
packages/cli-kit/dist/public/node/upgrade.d.ts
@@ -5,11 +5,9 @@ export { getAutoUpgradeEnabled, setAutoUpgradeEnabled };
  * Utility function for generating an install command for the user to run
  * to install an updated version of Shopify CLI.
  *
- * @param version - The version or dist-tag to install. Homebrew can't
- * install a specific version, so it always upgrades to the formula's current version.
  * @returns A string with the command to run, or undefined if the package manager cannot be determined.
  */
-export declare function cliInstallCommand(version: string): string | undefined;
+export declare function cliInstallCommand(): string | undefined;
 /**
  * Options for {@link runCLIUpgrade}.
  */
@@ -21,13 +19,6 @@ export interface RunCLIUpgradeOptions {
      * their `package.json` / lockfile in the background.
      */
     autoupgrade?: boolean;
-    /**
-     * The exact version to install. The auto-upgrade hook passes the version it already
-     * vetted, such as one that isn't a major version change, so the install can't drift to
-     * whatever `latest` points at by the time the package manager runs. When omitted, the
-     * CLI installs `latest`.
-     */
-    version?: string;
 }
 /**
  * Runs the CLI upgrade using the appropriate package manager.
@@ -45,7 +36,7 @@ export declare function runCLIUpgrade(options?: RunCLIUpgradeOptions): Promise<v
  */
 export declare function upgradeCLI(options?: RunCLIUpgradeOptions): Promise<UpgradeResult>;
 /**
- * Reads a fresh cached stable release in the current major, or skips automatic upgrades.
+ * Returns the version to auto-upgrade to, or undefined if auto-upgrade should be skipped.
  * Auto-upgrade is enabled by default and can be disabled via `setAutoUpgradeEnabled(false)`.
  * Also skips for CI, pre-release versions, or when no newer version is available.
  *
@@ -65,9 +56,9 @@ export declare function versionToAutoUpgrade(): string | undefined;
  */
 export declare function hasBlockingAutoUpgradeNotification(): Promise<boolean>;
 /**
- * Shows a daily notice for a new major, independently of automatic same-major upgrades.
- * When auto-upgrade is disabled, also shows notices for minor and patch releases.
- * Skipped in CI and for pre-release versions.
+ * Shows a daily upgrade-available warning for users who have not enabled auto-upgrade.
+ * Skipped in CI and for pre-release versions. When auto-upgrade is enabled this is a no-op
+ * because the postrun hook will handle the upgrade directly.
  */
 export declare function warnIfUpgradeAvailable(): Promise<void>;
 /**
packages/cli-kit/dist/public/node/version.d.ts
@@ -8,16 +8,9 @@ export declare function localCLIVersion(directory: string): Promise<string | und
 /**
  * Returns the version of the globally installed CLI, only if it's greater than 3.59.0 (when the global CLI was introduced).
  *
- * @param binary - The CLI command to locate and run.
  * @returns The version of the CLI if it is globally installed or undefined.
  */
-export declare function globalCLIVersion(binary?: string): Promise<string | undefined>;
-/**
- * Refreshes Homebrew metadata and returns the stable version of the running CLI's formula.
- *
- * @returns The available version, or undefined when the refresh fails or takes too long, or the formula cannot be read.
- */
-export declare function availableHomebrewCLIVersion(): Promise<string | undefined>;
+export declare function globalCLIVersion(): Promise<string | undefined>;
 /**
  * Returns true if the given version is a pre-release version.
  * Meaning is a `nightly`, `snapshot`, or `experimental` version.
packages/cli-kit/dist/private/node/analytics/graphql-error-codes.d.ts
@@ -36,11 +36,4 @@ export declare function isPermissionCode(code: string | undefined): boolean;
  * @param errors - The `errors` value from a GraphQL response.
  * @returns True when a rate-limit code is present in any error.
  */
-export declare function hasRateLimitCode(errors: unknown): boolean;
-/**
- * Whether any GraphQL error carries a transient server-side failure code.
- *
- * @param errors - The `errors` value from a GraphQL response.
- * @returns True when a transient server code is present in any error.
- */
-export declare function hasTransientServerCode(errors: unknown): boolean;
\ No newline at end of file
+export declare function hasRateLimitCode(errors: unknown): boolean;
\ No newline at end of file
packages/cli-kit/dist/private/node/api/status-checks.d.ts
@@ -2,6 +2,6 @@
  * Checks whether an HTTP status indicates a gateway-level failure.
  *
  * @param status - The HTTP status to check.
- * @returns Whether the status is 502, 503, 504, or a Cloudflare edge error from 520 to 524.
+ * @returns Whether the status is 502, 503, or 504.
  */
 export declare function isGatewayErrorStatus(status: number | undefined): boolean;
\ No newline at end of file
packages/cli-kit/dist/public/node/context/local.d.ts
@@ -52,7 +52,7 @@ export declare function isUnitTest(env?: NodeJS.ProcessEnv): boolean;
  * Returns true if reporting analytics is enabled.
  *
  * @param env - The environment variables from the environment of the current process.
- * @returns True unless SHOPIFY_CLI_NO_ANALYTICS, OPT_OUT_INSTRUMENTATION or DO_NOT_TRACK is truthy, or debug mode is enabled.
+ * @returns True unless SHOPIFY_CLI_NO_ANALYTICS or OPT_OUT_INSTRUMENTATION is truthy, or debug mode is enabled.
  */
 export declare function analyticsDisabled(env?: NodeJS.ProcessEnv): boolean;
 /**
packages/cli-kit/dist/public/node/error/types.d.ts
@@ -1,5 +1,5 @@
 import type { JsonAbortErrorSchema, JsonBugErrorSchema, JsonErrorCustomSectionSchema, JsonErrorSchema, JsonExternalErrorSchema, jsonErrorOutputSchema } from './schema.js';
-import type { z } from 'zod/v3';
+import type { z } from 'zod';
 export type JsonErrorCustomSection = z.infer<typeof JsonErrorCustomSectionSchema>;
 export type JsonAbortError = z.infer<typeof JsonAbortErrorSchema>;
 export type JsonBugError = z.infer<typeof JsonBugErrorSchema>;
packages/cli-kit/dist/public/node/graphiql/server.d.ts
@@ -27,14 +27,13 @@ export declare function resolveGraphiQLKey(providedKey: string | undefined, apiS
  * - `getToken` may return a cached token; the proxy calls it for every request.
  * - `refreshToken` (optional) is invoked when the upstream Admin API returns 401.
  * When omitted, the proxy falls back to calling `getToken` again on 401.
- * - Both operations receive a cancellation signal to pass to token requests.
  *
  * Implementations must throw `TokenRefreshError` (or any thrown error) when the
  * token cannot be obtained; the proxy renders the unauthorized template in that case.
  */
 export interface TokenProvider {
-    getToken: (signal?: AbortSignal) => Promise<string>;
-    refreshToken?: (signal?: AbortSignal) => Promise<string>;
+    getToken: () => Promise<string>;
+    refreshToken?: () => Promise<string>;
 }
 /**
  * Optional app-specific context, used to render the app pill and scopes note in the
@@ -66,10 +65,6 @@ export interface SetupGraphiQLServerOptions {
      * interactive UI.
      */
     protectMutations?: boolean;
-    /** Called for request failures that leave the server available for subsequent requests. */
-    onRequestError?: (message: string) => void;
-    /** Routes diagnostics through command events and leaves readiness output to the session. */
-    json?: boolean;
 }
 export declare const MUTATIONS_BLOCKED_MESSAGE = "Mutations are disabled. Re-run with --allow-mutations to enable mutations.";
 /**
packages/cli-kit/dist/public/node/graphiql/session.d.ts
@@ -22,7 +22,6 @@ export interface RunGraphiQLSessionOptions {
     additionalReadyMessages?: OutputMessage[];
     abortSignal?: AbortSignal;
     stdout?: Writable;
-    outputFormat?: 'text' | 'json';
 }
 /**
  * Generates a random key suitable for authenticating a single local GraphiQL session.
packages/cli-kit/dist/public/node/hooks/postrun.d.ts
@@ -22,9 +22,8 @@ export declare function postRunHookHasCompleted(): boolean;
 export declare function waitForPostRunHookAndExit(): void;
 export declare const hook: Hook.Postrun;
 /**
- * Checks release notices and auto-upgrades the CLI after a command completes.
- * Notices have their own daily limit. Upgrade attempts run once per day unless forced
- * via SHOPIFY_CLI_FORCE_AUTO_UPGRADE.
+ * Auto-upgrades the CLI after a command completes, if a newer version is available.
+ * The entire flow is rate-limited to once per day unless forced via SHOPIFY_CLI_FORCE_AUTO_UPGRADE.
  *
  * @returns Resolves when the upgrade attempt (or fallback warning) is complete.
  */
packages/cli-kit/dist/public/node/hooks/prerun.d.ts
@@ -11,7 +11,7 @@ export declare function parseCommandContent(cmdInfo: {
     pluginAlias?: string;
 }): CommandContent;
 /**
- * Starts a shared background lookup for release notices, manual-upgrade hints and automatic upgrades.
- * The postrun hook reads fresh cached versions without waiting for an in-flight lookup.
+ * Triggers a background check for a newer CLI version (non-blocking).
+ * The result is cached and consumed by the postrun hook for auto-upgrade.
  */
 export declare function checkForNewVersionInBackground(): Promise<void>;
\ No newline at end of file
packages/cli-kit/dist/public/node/upgrade/output.d.ts
@@ -1,4 +1,3 @@
-import { type ExecOptions } from '../system.js';
 import { Writable } from 'node:stream';
 /**
  * Keeps package-manager output off the result channel in JSON mode.
@@ -14,6 +13,5 @@ export declare function upgradeOutputStreams(): {
  *
  * @param command - The package-manager executable.
  * @param args - The install arguments.
- * @param options - Environment overrides for the package manager.
  */
-export declare function execUpgradeCommand(command: string, args: string[], options?: Pick<ExecOptions, 'env'>): Promise<void>;
\ No newline at end of file
+export declare function execUpgradeCommand(command: string, args: string[]): Promise<void>;
\ No newline at end of file
packages/cli-kit/dist/public/node/upgrade/types.d.ts
@@ -51,11 +51,11 @@ export declare const upgradeJsonOutputSchema: import("../json-output-schema.js")
     scope: zod.ZodEnum<["global", "local"]>;
 }, "strict", zod.ZodTypeAny, {
     status: "skipped";
-    reason: "development" | "local-autoupgrade" | "dependency-not-found";
     scope: "local" | "global";
+    reason: "development" | "local-autoupgrade" | "dependency-not-found";
 }, {
     status: "skipped";
-    reason: "development" | "local-autoupgrade" | "dependency-not-found";
     scope: "local" | "global";
+    reason: "development" | "local-autoupgrade" | "dependency-not-found";
 }>]>>;
 export type UpgradeResult = InferJsonOutputSchema<typeof upgradeJsonOutputSchema>;
\ No newline at end of file

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

no-changelog This PR doesn't include a changeset entry. Is an internal only change not relevant to end users.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant