Add glob pattern support for --environment flag

Theme users with many similarly-named environments (e.g. us-production, eu-production, int-production) currently must specify each one individually with -e. This adds glob pattern support so they can use patterns like --environment "*-production" to target multiple environments at once.

The implementation expands glob patterns at a single point in base-command's resultWithEnvironment(), before the single/multi environment routing logic. This avoids needing downstream consumers like theme-command to handle expansion themselves.

Key design decisions:

- Uses minimatch (already a dependency) for pattern matching

- Extracts shared TOML parsing into private decodeEnvironments() to avoid duplication between loadEnvironment() and the new getEnvironmentNames()

- Expansion happens early so originalResult.flags.environment gets real names, not glob patterns

- Deduplicates across multiple patterns via Set

- Warns per-pattern when no environments match

Closes https://github.com/Shopify/cli/issues/6481

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: graygilmore

.changeset/glob-environment-patterns.md

@@ -0,0 +1,8 @@
+---
+'@shopify/cli-kit': patch
+'@shopify/theme': patch
+---
+
+Add glob pattern support for the `--environment` flag. You can now use patterns
+like `--environment "*-production"` to target multiple environments at once.
+Wrap glob patterns in quotes to prevent shell expansion.

docs-shopify.dev/commands/interfaces/theme-check.interface.ts

@@ -16,7 +16,7 @@ export interface themecheck {
   '-C, --config <value>'?: string
 
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Supports glob patterns (e.g. "*-production"). Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string

docs-shopify.dev/commands/interfaces/theme-console.interface.ts

@@ -1,7 +1,7 @@
 // This is an autogenerated file. Don't edit this file manually.
 export interface themeconsole {
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Supports glob patterns (e.g. "*-production"). Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string

docs-shopify.dev/commands/interfaces/theme-delete.interface.ts

@@ -7,7 +7,7 @@ export interface themedelete {
   '-d, --development'?: ''
 
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Supports glob patterns (e.g. "*-production"). Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string

docs-shopify.dev/commands/interfaces/theme-dev.interface.ts

@@ -7,7 +7,7 @@ export interface themedev {
   '-a, --allow-live'?: ''
 
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Supports glob patterns (e.g. "*-production"). Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string

docs-shopify.dev/commands/interfaces/theme-duplicate.interface.ts

@@ -1,7 +1,7 @@
 // This is an autogenerated file. Don't edit this file manually.
 export interface themeduplicate {
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Supports glob patterns (e.g. "*-production"). Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string

docs-shopify.dev/commands/interfaces/theme-info.interface.ts

@@ -7,7 +7,7 @@ export interface themeinfo {
   '-d, --development'?: ''
 
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Supports glob patterns (e.g. "*-production"). Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string

docs-shopify.dev/commands/interfaces/theme-list.interface.ts

@@ -1,7 +1,7 @@
 // This is an autogenerated file. Don't edit this file manually.
 export interface themelist {
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Supports glob patterns (e.g. "*-production"). Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string

docs-shopify.dev/commands/interfaces/theme-metafields-pull.interface.ts

@@ -1,7 +1,7 @@
 // This is an autogenerated file. Don't edit this file manually.
 export interface thememetafieldspull {
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Supports glob patterns (e.g. "*-production"). Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string

docs-shopify.dev/commands/interfaces/theme-open.interface.ts

@@ -13,7 +13,7 @@ export interface themeopen {
   '-E, --editor'?: ''
 
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Supports glob patterns (e.g. "*-production"). Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string