hereya-cli 0.86.2 → 0.87.0

package/oclif.manifest.json

@@ -455,6 +455,50 @@
         "index.js"
       ]
     },
+    "git": {
+      "aliases": [],
+      "args": {},
+      "description": "Run an arbitrary git command with the hereya credential helper available. Wraps `git <args...>`, propagating an ephemeral `--token` to the credential-helper grandchild via `HEREYA_EPHEMERAL_TOKEN`. After a successful `clone`, also wires the cloned repo to use the hereya credential helper for future `push`/`pull`/`fetch` operations. Use `--` to separate hereya flags from git flags so e.g. `--depth` reaches git instead of being parsed by oclif.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --token <token> -- push",
+        "<%= config.bin %> <%= command.id %> --token <token> -- pull --rebase",
+        "<%= config.bin %> <%= command.id %> --token <token> -- clone https://github.com/owner/repo my-dir",
+        "<%= config.bin %> <%= command.id %> -- log --oneline -10"
+      ],
+      "flags": {
+        "chdir": {
+          "description": "directory to run git in (cwd of the spawned git process)",
+          "name": "chdir",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Propagated to the git credential-helper grandchild via the HEREYA_EPHEMERAL_TOKEN env var. Takes precedence over the HEREYA_TOKEN environment variable.",
+          "name": "token",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "git",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "git",
+        "index.js"
+      ]
+    },
     "import": {
       "aliases": [],
       "args": {
@@ -707,26 +751,35 @@
         "index.js"
       ]
     },
-    "publish": {
+    "provid": {
       "aliases": [],
-      "args": {},
-      "description": "Publish a package to the Hereya registry",
+      "args": {
+        "package": {
+          "description": "Package name (e.g., hereya/postgres)",
+          "name": "package",
+          "required": true
+        }
+      },
+      "description": "Display the provisioning ID for a package",
       "examples": [
-        "$ hereya publish",
-        "$ hereya publish --chdir=/path/to/package"
+        "<%= config.bin %> <%= command.id %> hereya/postgres",
+        "<%= config.bin %> <%= command.id %> hereya/postgres -w dev",
+        "<%= config.bin %> <%= command.id %> hereya/postgres --workspace staging"
       ],
       "flags": {
         "chdir": {
-          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n      ",
+          "char": "C",
+          "description": "Project root directory",
           "name": "chdir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
+        "workspace": {
+          "char": "w",
+          "description": "Name of the workspace",
+          "name": "workspace",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -735,7 +788,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "publish",
+      "id": "provid",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -745,39 +798,30 @@
       "relativePath": [
         "dist",
         "commands",
-        "publish",
+        "provid",
         "index.js"
       ]
     },
-    "provid": {
+    "publish": {
       "aliases": [],
-      "args": {
-        "package": {
-          "description": "Package name (e.g., hereya/postgres)",
-          "name": "package",
-          "required": true
-        }
-      },
-      "description": "Display the provisioning ID for a package",
+      "args": {},
+      "description": "Publish a package to the Hereya registry",
       "examples": [
-        "<%= config.bin %> <%= command.id %> hereya/postgres",
-        "<%= config.bin %> <%= command.id %> hereya/postgres -w dev",
-        "<%= config.bin %> <%= command.id %> hereya/postgres --workspace staging"
+        "$ hereya publish",
+        "$ hereya publish --chdir=/path/to/package"
       ],
       "flags": {
         "chdir": {
-          "char": "C",
-          "description": "Project root directory",
+          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n      ",
           "name": "chdir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "workspace": {
-          "char": "w",
-          "description": "Name of the workspace",
-          "name": "workspace",
+        "token": {
+          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
+          "name": "token",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -786,7 +830,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "provid",
+      "id": "publish",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -796,7 +840,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "provid",
+        "publish",
         "index.js"
       ]
     },
@@ -1079,43 +1123,57 @@
         "index.js"
       ]
     },
-    "uninit": {
+    "up": {
       "aliases": [],
-      "args": {
-        "project": {
-          "description": "project name",
-          "name": "project",
-          "required": true
-        }
-      },
-      "description": "Destroy template infrastructure and uninitialize a project.",
+      "args": {},
+      "description": "Provision all packages in the project.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> myProject -w dev",
-        "<%= config.bin %> <%= command.id %> myProject -w dev -p prodWorkspace=prod"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "chdir": {
-          "description": "directory to run command in",
+          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n        Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR environment variable.\n      ",
           "name": "chdir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "parameter": {
-          "char": "p",
-          "description": "parameter for the template, in the form of 'key=value'. Overrides saved parameters.",
-          "name": "parameter",
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "deploy": {
+          "description": "provision deployment companion packages",
+          "name": "deploy",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "select": {
+          "char": "s",
+          "description": "select the packages to provision",
+          "name": "select",
           "default": [],
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
+        "token": {
+          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
+          "name": "token",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "workspace": {
           "char": "w",
-          "description": "workspace used during init",
+          "description": "name of the workspace to install the packages for",
           "name": "workspace",
-          "required": true,
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1123,7 +1181,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "uninit",
+      "id": "up",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -1133,61 +1191,47 @@
       "relativePath": [
         "dist",
         "commands",
-        "uninit",
+        "up",
         "index.js"
       ]
     },
-    "up": {
+    "uninit": {
       "aliases": [],
-      "args": {},
-      "description": "Provision all packages in the project.",
+      "args": {
+        "project": {
+          "description": "project name",
+          "name": "project",
+          "required": true
+        }
+      },
+      "description": "Destroy template infrastructure and uninitialize a project.",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %> myProject -w dev",
+        "<%= config.bin %> <%= command.id %> myProject -w dev -p prodWorkspace=prod"
       ],
       "flags": {
         "chdir": {
-          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n        Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR environment variable.\n      ",
+          "description": "directory to run command in",
           "name": "chdir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "debug": {
-          "description": "enable debug mode",
-          "name": "debug",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "deploy": {
-          "description": "provision deployment companion packages",
-          "name": "deploy",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "select": {
-          "char": "s",
-          "description": "select the packages to provision",
-          "name": "select",
+        "parameter": {
+          "char": "p",
+          "description": "parameter for the template, in the form of 'key=value'. Overrides saved parameters.",
+          "name": "parameter",
           "default": [],
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to install the packages for",
+          "description": "workspace used during init",
           "name": "workspace",
-          "required": false,
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1195,7 +1239,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "up",
+      "id": "uninit",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -1205,7 +1249,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "up",
+        "uninit",
         "index.js"
       ]
     },
@@ -1622,31 +1666,6 @@
         "index.js"
       ]
     },
-    "config:get-backend": {
-      "aliases": [],
-      "args": {},
-      "description": "get the current backend type",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "config:get-backend",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "config",
-        "get-backend",
-        "index.js"
-      ]
-    },
     "config:export-backend": {
       "aliases": [],
       "args": {
@@ -1679,24 +1698,17 @@
         "index.js"
       ]
     },
-    "config:use-backend": {
+    "config:get-backend": {
       "aliases": [],
-      "args": {
-        "type": {
-          "description": "type of backend to use. Possible values: s3, local",
-          "name": "type",
-          "required": true
-        }
-      },
-      "description": "set the current backend type",
+      "args": {},
+      "description": "get the current backend type",
       "examples": [
-        "<%= config.bin %> <%= command.id %> s3",
-        "<%= config.bin %> <%= command.id %> local"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:use-backend",
+      "id": "config:get-backend",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -1707,7 +1719,7 @@
         "dist",
         "commands",
         "config",
-        "use-backend",
+        "get-backend",
         "index.js"
       ]
     },
@@ -1742,14 +1754,46 @@
         "index.js"
       ]
     },
-    "devenv:config": {
+    "config:use-backend": {
       "aliases": [],
-      "args": {},
-      "description": "Configure SSH for a dev environment and display connection details.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> -w my-workspace"
-      ],
-      "flags": {
+      "args": {
+        "type": {
+          "description": "type of backend to use. Possible values: s3, local",
+          "name": "type",
+          "required": true
+        }
+      },
+      "description": "set the current backend type",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> s3",
+        "<%= config.bin %> <%= command.id %> local"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "config:use-backend",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "config",
+        "use-backend",
+        "index.js"
+      ]
+    },
+    "devenv:config": {
+      "aliases": [],
+      "args": {},
+      "description": "Configure SSH for a dev environment and display connection details.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -w my-workspace"
+      ],
+      "flags": {
         "workspace": {
           "char": "w",
           "description": "name of the workspace to configure SSH for",
@@ -1981,31 +2025,42 @@
         "index.js"
       ]
     },
-    "executor:start": {
+    "env:set": {
       "aliases": [],
-      "args": {},
-      "description": "Start the remote executor process (polls for jobs from hereya cloud).\n\nJobs are executed in parallel up to the concurrency limit (default: 10). Use --concurrency to adjust.\n\nSet the HEREYA_TOKEN environment variable to authenticate without running `hereya login`.\nSet the HEREYA_CLOUD_URL environment variable to target a specific hereya cloud instance (defaults to https://cloud.hereya.dev).",
+      "args": {
+        "name": {
+          "description": "name of the environment variable to set",
+          "name": "name"
+        }
+      },
+      "description": "Set an user-defined environment variable for the project",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -w my-workspace",
-        "<%= config.bin %> <%= command.id %> -w my-workspace --concurrency 5",
-        "HEREYA_TOKEN=<token> <%= config.bin %> <%= command.id %> -w my-workspace",
-        "HEREYA_TOKEN=<token> HEREYA_CLOUD_URL=https://my-cloud.example.com <%= config.bin %> <%= command.id %> -w my-workspace"
+        "<%= config.bin %> <%= command.id %> FOO -v bar",
+        "<%= config.bin %> <%= command.id %> FOO -v bar -w dev"
       ],
       "flags": {
-        "concurrency": {
-          "char": "c",
-          "description": "maximum number of parallel jobs",
-          "name": "concurrency",
-          "default": 10,
+        "chdir": {
+          "description": "project root directory",
+          "name": "chdir",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "value": {
+          "char": "v",
+          "description": "value of the environment variable",
+          "name": "value",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to poll jobs for",
+          "description": "name of the workspace to print the env vars for",
           "name": "workspace",
-          "required": true,
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2013,7 +2068,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "executor:start",
+      "id": "env:set",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -2023,47 +2078,36 @@
       "relativePath": [
         "dist",
         "commands",
-        "executor",
-        "start",
+        "env",
+        "set",
         "index.js"
       ]
     },
-    "env:set": {
+    "executor:start": {
       "aliases": [],
-      "args": {
-        "name": {
-          "description": "name of the environment variable to set",
-          "name": "name"
-        }
-      },
-      "description": "Set an user-defined environment variable for the project",
+      "args": {},
+      "description": "Start the remote executor process (polls for jobs from hereya cloud).\n\nJobs are executed in parallel up to the concurrency limit (default: 10). Use --concurrency to adjust.\n\nSet the HEREYA_TOKEN environment variable to authenticate without running `hereya login`.\nSet the HEREYA_CLOUD_URL environment variable to target a specific hereya cloud instance (defaults to https://cloud.hereya.dev).",
       "examples": [
-        "<%= config.bin %> <%= command.id %> FOO -v bar",
-        "<%= config.bin %> <%= command.id %> FOO -v bar -w dev"
+        "<%= config.bin %> <%= command.id %> -w my-workspace",
+        "<%= config.bin %> <%= command.id %> -w my-workspace --concurrency 5",
+        "HEREYA_TOKEN=<token> <%= config.bin %> <%= command.id %> -w my-workspace",
+        "HEREYA_TOKEN=<token> HEREYA_CLOUD_URL=https://my-cloud.example.com <%= config.bin %> <%= command.id %> -w my-workspace"
       ],
       "flags": {
-        "chdir": {
-          "description": "project root directory",
-          "name": "chdir",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "value": {
-          "char": "v",
-          "description": "value of the environment variable",
-          "name": "value",
-          "required": true,
+        "concurrency": {
+          "char": "c",
+          "description": "maximum number of parallel jobs",
+          "name": "concurrency",
+          "default": 10,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to print the env vars for",
+          "description": "name of the workspace to poll jobs for",
           "name": "workspace",
-          "required": false,
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2071,7 +2115,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "env:set",
+      "id": "executor:start",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -2081,8 +2125,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "env",
-        "set",
+        "executor",
+        "start",
         "index.js"
       ]
     },
@@ -2225,40 +2269,49 @@
         "index.js"
       ]
     },
-    "flow:provid": {
+    "flow:env": {
       "aliases": [],
       "args": {
-        "package": {
-          "description": "Package name (e.g., hereya/postgres)",
-          "name": "package",
-          "required": true
+        "name": {
+          "description": "name of the env to display",
+          "name": "name",
+          "required": false
         }
       },
-      "description": "Display the provisioning ID for a package in a git branch-based workspace",
+      "description": "Print project environment variables for a git branch-based workspace",
       "examples": [
-        "<%= config.bin %> <%= command.id %> hereya/postgres",
-        "<%= config.bin %> <%= command.id %> hereya/postgres --profile staging",
-        "<%= config.bin %> <%= command.id %> hereya/postgres --pin"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> myEnv",
+        "<%= config.bin %> <%= command.id %> --profile staging",
+        "<%= config.bin %> <%= command.id %> --pin",
+        "<%= config.bin %> <%= command.id %> -l"
       ],
       "flags": {
         "chdir": {
-          "char": "C",
-          "description": "Project root directory",
+          "description": "project root directory",
           "name": "chdir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "list": {
+          "char": "l",
+          "description": "list only the env vars without values",
+          "name": "list",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
         "pin": {
-          "description": "Append git commit SHA to workspace name for commit-specific isolation",
+          "description": "append git commit SHA to workspace name for commit-specific isolation",
           "name": "pin",
           "required": false,
           "allowNo": false,
           "type": "boolean"
         },
         "profile": {
-          "description": "Profile to use for the workspace (will be appended to workspace name)",
+          "description": "profile to use for the workspace (will be appended to workspace name)",
           "name": "profile",
           "required": false,
           "hasDynamicHelp": false,
@@ -2268,7 +2321,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:provid",
+      "id": "flow:env",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -2279,53 +2332,44 @@
         "dist",
         "commands",
         "flow",
-        "provid",
+        "env",
         "index.js"
       ]
     },
-    "flow:env": {
+    "flow:provid": {
       "aliases": [],
       "args": {
-        "name": {
-          "description": "name of the env to display",
-          "name": "name",
-          "required": false
+        "package": {
+          "description": "Package name (e.g., hereya/postgres)",
+          "name": "package",
+          "required": true
         }
       },
-      "description": "Print project environment variables for a git branch-based workspace",
+      "description": "Display the provisioning ID for a package in a git branch-based workspace",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> myEnv",
-        "<%= config.bin %> <%= command.id %> --profile staging",
-        "<%= config.bin %> <%= command.id %> --pin",
-        "<%= config.bin %> <%= command.id %> -l"
+        "<%= config.bin %> <%= command.id %> hereya/postgres",
+        "<%= config.bin %> <%= command.id %> hereya/postgres --profile staging",
+        "<%= config.bin %> <%= command.id %> hereya/postgres --pin"
       ],
       "flags": {
         "chdir": {
-          "description": "project root directory",
+          "char": "C",
+          "description": "Project root directory",
           "name": "chdir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "list": {
-          "char": "l",
-          "description": "list only the env vars without values",
-          "name": "list",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
         "pin": {
-          "description": "append git commit SHA to workspace name for commit-specific isolation",
+          "description": "Append git commit SHA to workspace name for commit-specific isolation",
           "name": "pin",
           "required": false,
           "allowNo": false,
           "type": "boolean"
         },
         "profile": {
-          "description": "profile to use for the workspace (will be appended to workspace name)",
+          "description": "Profile to use for the workspace (will be appended to workspace name)",
           "name": "profile",
           "required": false,
           "hasDynamicHelp": false,
@@ -2335,7 +2379,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:env",
+      "id": "flow:provid",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -2346,7 +2390,7 @@
         "dist",
         "commands",
         "flow",
-        "env",
+        "provid",
         "index.js"
       ]
     },
@@ -2462,97 +2506,41 @@
         "index.js"
       ]
     },
-    "workspace:create": {
+    "flow:up": {
       "aliases": [],
-      "args": {
-        "name": {
-          "description": "name of the workspace to create",
-          "name": "name",
-          "required": true
-        }
-      },
-      "description": "Create a new workspace if it does not exist.",
+      "args": {},
+      "description": "Create a git branch-based workspace and provision all packages",
       "examples": [
-        "<%= config.bin %> <%= command.id %> dev"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --debug",
+        "<%= config.bin %> <%= command.id %> --profile staging",
+        "<%= config.bin %> <%= command.id %> --pin"
       ],
       "flags": {
-        "deployment": {
-          "char": "d",
-          "description": "mark workspace as a deployment workspace",
-          "name": "deployment",
+        "chdir": {
+          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n        Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR environment variable.\n      ",
+          "name": "chdir",
           "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
           "allowNo": false,
           "type": "boolean"
         },
-        "mirror": {
-          "description": "workspace to mirror",
-          "name": "mirror",
+        "deploy": {
+          "description": "provision deployment companion packages",
+          "name": "deploy",
           "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+          "allowNo": false,
+          "type": "boolean"
         },
-        "profile": {
-          "description": "workspace profile to set (cloud backend only)",
-          "name": "profile",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "workspace:create",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "workspace",
-        "create",
-        "index.js"
-      ]
-    },
-    "flow:up": {
-      "aliases": [],
-      "args": {},
-      "description": "Create a git branch-based workspace and provision all packages",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --debug",
-        "<%= config.bin %> <%= command.id %> --profile staging",
-        "<%= config.bin %> <%= command.id %> --pin"
-      ],
-      "flags": {
-        "chdir": {
-          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n        Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR environment variable.\n      ",
-          "name": "chdir",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "debug": {
-          "description": "enable debug mode",
-          "name": "debug",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "deploy": {
-          "description": "provision deployment companion packages",
-          "name": "deploy",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "pin": {
-          "description": "append git commit SHA to workspace name for commit-specific isolation",
-          "name": "pin",
+        "pin": {
+          "description": "append git commit SHA to workspace name for commit-specific isolation",
+          "name": "pin",
           "required": false,
           "allowNo": false,
           "type": "boolean"
@@ -2592,34 +2580,40 @@
         "index.js"
       ]
     },
-    "workspace:env": {
+    "workspace:create": {
       "aliases": [],
       "args": {
         "name": {
-          "description": "name of the env to display",
+          "description": "name of the workspace to create",
           "name": "name",
-          "required": false
+          "required": true
         }
       },
-      "description": "Print workspace env vars.",
+      "description": "Create a new workspace if it does not exist.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -w dev",
-        "<%= config.bin %> <%= command.id %> myEnv -w dev"
+        "<%= config.bin %> <%= command.id %> dev"
       ],
       "flags": {
-        "list": {
-          "char": "l",
-          "description": "list only the env vars without values",
-          "name": "list",
+        "deployment": {
+          "char": "d",
+          "description": "mark workspace as a deployment workspace",
+          "name": "deployment",
           "required": false,
           "allowNo": false,
           "type": "boolean"
         },
-        "workspace": {
-          "char": "w",
-          "description": "name of the workspace to print env vars for",
-          "name": "workspace",
-          "required": true,
+        "mirror": {
+          "description": "workspace to mirror",
+          "name": "mirror",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "profile": {
+          "description": "workspace profile to set (cloud backend only)",
+          "name": "profile",
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2627,7 +2621,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:env",
+      "id": "workspace:create",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -2638,7 +2632,7 @@
         "dist",
         "commands",
         "workspace",
-        "env",
+        "create",
         "index.js"
       ]
     },
@@ -2673,6 +2667,56 @@
         "index.js"
       ]
     },
+    "workspace:env": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "name of the env to display",
+          "name": "name",
+          "required": false
+        }
+      },
+      "description": "Print workspace env vars.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -w dev",
+        "<%= config.bin %> <%= command.id %> myEnv -w dev"
+      ],
+      "flags": {
+        "list": {
+          "char": "l",
+          "description": "list only the env vars without values",
+          "name": "list",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "name of the workspace to print env vars for",
+          "name": "workspace",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "workspace:env",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "workspace",
+        "env",
+        "index.js"
+      ]
+    },
     "workspace:install": {
       "aliases": [],
       "args": {
@@ -2966,6 +3010,56 @@
         "index.js"
       ]
     },
+    "devenv:project:uninit": {
+      "aliases": [],
+      "args": {
+        "project": {
+          "description": "project name",
+          "name": "project",
+          "required": true
+        }
+      },
+      "description": "Uninitialize a project on a remote dev environment.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> my-app -w my-workspace",
+        "<%= config.bin %> <%= command.id %> my-app -w my-workspace --force"
+      ],
+      "flags": {
+        "force": {
+          "char": "f",
+          "description": "also remove the project directory after uninit",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "name of the workspace",
+          "name": "workspace",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "devenv:project:uninit",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "devenv",
+        "project",
+        "uninit",
+        "index.js"
+      ]
+    },
     "flow:docker:run": {
       "aliases": [],
       "args": {
@@ -3034,56 +3128,6 @@
         "index.js"
       ]
     },
-    "devenv:project:uninit": {
-      "aliases": [],
-      "args": {
-        "project": {
-          "description": "project name",
-          "name": "project",
-          "required": true
-        }
-      },
-      "description": "Uninitialize a project on a remote dev environment.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> my-app -w my-workspace",
-        "<%= config.bin %> <%= command.id %> my-app -w my-workspace --force"
-      ],
-      "flags": {
-        "force": {
-          "char": "f",
-          "description": "also remove the project directory after uninit",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "workspace": {
-          "char": "w",
-          "description": "name of the workspace",
-          "name": "workspace",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "devenv:project:uninit",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "devenv",
-        "project",
-        "uninit",
-        "index.js"
-      ]
-    },
     "workspace:env:set": {
       "aliases": [],
       "args": {},
@@ -3154,26 +3198,35 @@
         "index.js"
       ]
     },
-    "workspace:env:unset": {
+    "workspace:executor:install": {
       "aliases": [],
       "args": {},
-      "description": "unset an env var for a workspace",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> -w my-workspace -n myVar"
-      ],
+      "description": "Install a remote executor into a workspace",
       "flags": {
-        "name": {
-          "char": "n",
-          "description": "name of the env var to unset",
-          "name": "name",
-          "required": true,
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "char": "f",
+          "description": "force reinstall even if executor is already installed",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "token": {
+          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
+          "name": "token",
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to unset an env var for",
+          "description": "name of the workspace",
           "name": "workspace",
           "required": true,
           "hasDynamicHelp": false,
@@ -3183,7 +3236,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:env:unset",
+      "id": "workspace:executor:install",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -3194,27 +3247,31 @@
         "dist",
         "commands",
         "workspace",
-        "env",
-        "unset",
+        "executor",
+        "install",
         "index.js"
       ]
     },
-    "workspace:executor:token": {
+    "workspace:env:unset": {
       "aliases": [],
       "args": {},
-      "description": "Generate a workspace-scoped executor token for the remote executor",
+      "description": "unset an env var for a workspace",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -w my-workspace -n myVar"
+      ],
       "flags": {
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
+        "name": {
+          "char": "n",
+          "description": "name of the env var to unset",
+          "name": "name",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace",
+          "description": "name of the workspace to unset an env var for",
           "name": "workspace",
           "required": true,
           "hasDynamicHelp": false,
@@ -3224,7 +3281,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:executor:token",
+      "id": "workspace:env:unset",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -3235,29 +3292,16 @@
         "dist",
         "commands",
         "workspace",
-        "executor",
-        "token",
+        "env",
+        "unset",
         "index.js"
       ]
     },
-    "workspace:executor:install": {
+    "workspace:executor:token": {
       "aliases": [],
       "args": {},
-      "description": "Install a remote executor into a workspace",
+      "description": "Generate a workspace-scoped executor token for the remote executor",
       "flags": {
-        "debug": {
-          "description": "enable debug mode",
-          "name": "debug",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "force": {
-          "char": "f",
-          "description": "force reinstall even if executor is already installed",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "token": {
           "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
           "name": "token",
@@ -3278,7 +3322,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:executor:install",
+      "id": "workspace:executor:token",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -3290,7 +3334,7 @@
         "commands",
         "workspace",
         "executor",
-        "install",
+        "token",
         "index.js"
       ]
     },
@@ -3342,5 +3386,5 @@
       ]
     }
   },
-  "version": "0.86.2"
+  "version": "0.87.0"
 }