hereya-cli 0.100.5 → 0.101.0

package/oclif.manifest.json

@@ -1096,102 +1096,6 @@
         "index.js"
       ]
     },
-    "up": {
-      "aliases": [],
-      "args": {},
-      "description": "Provision all packages in the project.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>"
-      ],
-      "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"
-        },
-        "select": {
-          "char": "s",
-          "description": "select the packages to provision",
-          "name": "select",
-          "default": [],
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "workspace": {
-          "char": "w",
-          "description": "name of the workspace to install the packages for",
-          "name": "workspace",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "up",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "up",
-        "index.js"
-      ]
-    },
-    "update": {
-      "aliases": [],
-      "args": {
-        "version": {
-          "default": "latest",
-          "description": "version to update to",
-          "name": "version",
-          "required": false
-        }
-      },
-      "description": "Update hereya CLI to the latest or a specific version.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> 0.75.0"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "update",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "update",
-        "index.js"
-      ]
-    },
     "uninit": {
       "aliases": [],
       "args": {
@@ -1250,57 +1154,49 @@
         "index.js"
       ]
     },
-    "app:deploy": {
+    "up": {
       "aliases": [],
-      "args": {
-        "name": {
-          "description": "app name in org/name format",
-          "name": "name",
-          "required": true
-        }
-      },
-      "description": "Deploy a hereya-app to a workspace.",
+      "args": {},
+      "description": "Provision all packages in the project.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> my-org/my-app -w my-workspace",
-        "<%= config.bin %> <%= command.id %> my-org/my-app -w prod --version 1.2.0",
-        "<%= config.bin %> <%= command.id %> my-org/my-app -w prod -p organizationId=org-123"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "chdir": {
-          "description": "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.",
+          "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"
         },
-        "local": {
-          "description": "force local execution (skip remote executor)",
-          "name": "local",
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
           "allowNo": false,
           "type": "boolean"
         },
-        "parameter": {
-          "char": "p",
-          "description": "parameter for the app deployment, in the form of key=value (repeatable)",
-          "name": "parameter",
+        "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"
         },
-        "version": {
-          "description": "specific app version to deploy (defaults to latest)",
-          "name": "version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to deploy the app to",
+          "description": "name of the workspace to install the packages for",
           "name": "workspace",
-          "required": true,
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1308,7 +1204,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "app:deploy",
+      "id": "up",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -1318,8 +1214,39 @@
       "relativePath": [
         "dist",
         "commands",
-        "app",
-        "deploy",
+        "up",
+        "index.js"
+      ]
+    },
+    "update": {
+      "aliases": [],
+      "args": {
+        "version": {
+          "default": "latest",
+          "description": "version to update to",
+          "name": "version",
+          "required": false
+        }
+      },
+      "description": "Update hereya CLI to the latest or a specific version.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> 0.75.0"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "update",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "update",
         "index.js"
       ]
     },
@@ -1701,46 +1628,57 @@
         "index.js"
       ]
     },
-    "docker:run": {
+    "app:deploy": {
       "aliases": [],
       "args": {
-        "image": {
-          "description": "Docker image to run",
-          "name": "image",
+        "name": {
+          "description": "app name in org/name format",
+          "name": "name",
           "required": true
         }
       },
-      "description": "Run a Docker container with hereya env vars injected as -e flags.",
+      "description": "Deploy a hereya-app to a workspace.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> myapp:latest",
-        "<%= config.bin %> <%= command.id %> -w staging myapp:latest",
-        "<%= config.bin %> <%= command.id %> -p 3000 myapp:latest",
-        "<%= config.bin %> <%= command.id %> myapp:latest -- --rm -v ./data:/data"
+        "<%= config.bin %> <%= command.id %> my-org/my-app -w my-workspace",
+        "<%= config.bin %> <%= command.id %> my-org/my-app -w prod --version 1.2.0",
+        "<%= config.bin %> <%= command.id %> my-org/my-app -w prod -p organizationId=org-123"
       ],
       "flags": {
         "chdir": {
-          "description": "directory to run command in",
+          "description": "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.",
           "name": "chdir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "port": {
+        "local": {
+          "description": "force local execution (skip remote executor)",
+          "name": "local",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "parameter": {
           "char": "p",
-          "description": "port to forward and set as PORT env var (default: 8080)",
-          "name": "port",
-          "required": false,
-          "default": 8080,
+          "description": "parameter for the app deployment, in the form of key=value (repeatable)",
+          "name": "parameter",
+          "default": [],
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "version": {
+          "description": "specific app version to deploy (defaults to latest)",
+          "name": "version",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to use",
+          "description": "name of the workspace to deploy the app to",
           "name": "workspace",
-          "required": false,
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1748,57 +1686,149 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "docker:run",
+      "id": "app:deploy",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "docker",
-        "run",
+        "app",
+        "deploy",
         "index.js"
       ]
     },
-    "env:set": {
+    "devenv:config": {
       "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": "Configure SSH for a dev environment and display connection details. On-demand devenvs use a ProxyCommand that wakes the instance on first connection.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> FOO -v bar",
-        "<%= config.bin %> <%= command.id %> FOO -v bar -w dev"
+        "<%= config.bin %> <%= command.id %> -w my-workspace"
       ],
       "flags": {
-        "chdir": {
-          "description": "project root directory",
-          "name": "chdir",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
+        "workspace": {
+          "char": "w",
+          "description": "name of the workspace to configure SSH for",
+          "name": "workspace",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "devenv:config",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "devenv",
+        "config",
+        "index.js"
+      ]
+    },
+    "devenv:install": {
+      "aliases": [],
+      "args": {},
+      "description": "Provision a remote dev environment on a workspace.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -w my-workspace -p instanceType=t3.large"
+      ],
+      "flags": {
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "on-behalf-of": {
+          "description": "email of an org member to install the devenv for; the baked Hereya token will carry their identity (requires OWNER or ADMIN role)",
+          "name": "on-behalf-of",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
           "type": "option"
         },
-        "value": {
+        "parameter": {
+          "char": "p",
+          "description": "parameter for the package, in the form of 'key=value'. Can be specified multiple times.",
+          "name": "parameter",
+          "default": [],
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "parameter-file": {
+          "char": "f",
+          "description": "path to a file containing parameters for the package",
+          "name": "parameter-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "version": {
           "char": "v",
-          "description": "value of the environment variable",
-          "name": "value",
+          "description": "version of the dev environment package",
+          "name": "version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "name of the workspace to provision the dev environment on",
+          "name": "workspace",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "devenv:install",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "devenv",
+        "install",
+        "index.js"
+      ]
+    },
+    "devenv:sleep": {
+      "aliases": [],
+      "args": {},
+      "description": "Stop the dev environment instance for a workspace (lifecycle=on-demand only).",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -w my-workspace"
+      ],
+      "flags": {
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
         },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to print the env vars for",
+          "description": "name of the workspace whose dev environment should be stopped",
           "name": "workspace",
-          "required": false,
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1806,7 +1836,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "env:set",
+      "id": "devenv:sleep",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -1816,53 +1846,159 @@
       "relativePath": [
         "dist",
         "commands",
-        "env",
-        "set",
+        "devenv",
+        "sleep",
         "index.js"
       ]
     },
-    "flow:add": {
+    "devenv:ssh": {
+      "aliases": [],
+      "args": {},
+      "description": "SSH into a dev environment instance.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -w my-workspace"
+      ],
+      "flags": {
+        "workspace": {
+          "char": "w",
+          "description": "name of the workspace to SSH into",
+          "name": "workspace",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "devenv:ssh",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "devenv",
+        "ssh",
+        "index.js"
+      ]
+    },
+    "devenv:ssh-proxy": {
+      "aliases": [],
+      "args": {},
+      "description": "Internal: SSH ProxyCommand for on-demand devenvs (wake + connect).",
+      "flags": {
+        "workspace": {
+          "char": "w",
+          "description": "name of the workspace to proxy SSH for",
+          "name": "workspace",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "devenv:ssh-proxy",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "devenv",
+        "ssh-proxy",
+        "index.js"
+      ]
+    },
+    "devenv:uninstall": {
+      "aliases": [],
+      "args": {},
+      "description": "Destroy and remove the dev environment from a workspace.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -w my-workspace"
+      ],
+      "flags": {
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "name of the workspace to remove the dev environment from",
+          "name": "workspace",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "devenv:uninstall",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "devenv",
+        "uninstall",
+        "index.js"
+      ]
+    },
+    "docker:run": {
       "aliases": [],
       "args": {
-        "package": {
-          "description": "\n        The package to add, specified as a GitHub repository in the format owner/repository.\n        To change the registry URL, set the HEREYA_REGISTRY_URL environment variable, so that it points to $HEREYA_REGISTRY_URL/owner/repository.\n        For local packages, use the format local/path/to/package where path/to/package is the path to the package on your local machine.\n      ",
-          "name": "package",
+        "image": {
+          "description": "Docker image to run",
+          "name": "image",
           "required": true
         }
       },
-      "description": "Add a package to the project in a git branch-based workspace",
+      "description": "Run a Docker container with hereya env vars injected as -e flags.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres",
-        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres --profile staging",
-        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres -p DB_NAME=mydb -p DB_USER=admin"
+        "<%= config.bin %> <%= command.id %> myapp:latest",
+        "<%= config.bin %> <%= command.id %> -w staging myapp:latest",
+        "<%= config.bin %> <%= command.id %> -p 3000 myapp:latest",
+        "<%= config.bin %> <%= command.id %> myapp:latest -- --rm -v ./data:/data"
       ],
       "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"
-        },
-        "parameter": {
+        "port": {
           "char": "p",
-          "description": "parameter for the package, in the form of 'key=value'. Can be specified multiple times.",
-          "name": "parameter",
-          "default": [],
+          "description": "port to forward and set as PORT env var (default: 8080)",
+          "name": "port",
+          "required": false,
+          "default": 8080,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "profile": {
-          "description": "profile to use for the workspace (will be appended to workspace name)",
-          "name": "profile",
+        "workspace": {
+          "char": "w",
+          "description": "name of the workspace to use",
+          "name": "workspace",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1871,7 +2007,65 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:add",
+      "id": "docker:run",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "docker",
+        "run",
+        "index.js"
+      ]
+    },
+    "env:set": {
+      "aliases": [],
+      "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 %> FOO -v bar",
+        "<%= config.bin %> <%= command.id %> FOO -v bar -w dev"
+      ],
+      "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,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "name of the workspace to print the env vars for",
+          "name": "workspace",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "env:set",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -1881,8 +2075,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "flow",
-        "add",
+        "env",
+        "set",
         "index.js"
       ]
     },
@@ -1929,7 +2123,72 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "executor:start",
+      "id": "executor:start",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "executor",
+        "start",
+        "index.js"
+      ]
+    },
+    "flow:add": {
+      "aliases": [],
+      "args": {
+        "package": {
+          "description": "\n        The package to add, specified as a GitHub repository in the format owner/repository.\n        To change the registry URL, set the HEREYA_REGISTRY_URL environment variable, so that it points to $HEREYA_REGISTRY_URL/owner/repository.\n        For local packages, use the format local/path/to/package where path/to/package is the path to the package on your local machine.\n      ",
+          "name": "package",
+          "required": true
+        }
+      },
+      "description": "Add a package to the project in a git branch-based workspace",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres",
+        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres --profile staging",
+        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres -p DB_NAME=mydb -p DB_USER=admin"
+      ],
+      "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"
+        },
+        "parameter": {
+          "char": "p",
+          "description": "parameter for the package, in the form of 'key=value'. Can be specified multiple times.",
+          "name": "parameter",
+          "default": [],
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "profile": {
+          "description": "profile to use for the workspace (will be appended to workspace name)",
+          "name": "profile",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "flow:add",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -1939,8 +2198,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "executor",
-        "start",
+        "flow",
+        "add",
         "index.js"
       ]
     },
@@ -2329,48 +2588,23 @@
         "index.js"
       ]
     },
-    "workspace:create": {
+    "workspace:delete": {
       "aliases": [],
       "args": {
         "name": {
-          "description": "name of the workspace to create",
+          "description": "name of the workspace to delete",
           "name": "name",
           "required": true
         }
       },
-      "description": "Create a new workspace if it does not exist.",
+      "description": "Delete a workspace if it exists.",
       "examples": [
         "<%= config.bin %> <%= command.id %> dev"
       ],
-      "flags": {
-        "deployment": {
-          "char": "d",
-          "description": "mark workspace as a deployment workspace",
-          "name": "deployment",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "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"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:create",
+      "id": "workspace:delete",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -2381,7 +2615,7 @@
         "dist",
         "commands",
         "workspace",
-        "create",
+        "delete",
         "index.js"
       ]
     },
@@ -2435,37 +2669,6 @@
         "index.js"
       ]
     },
-    "workspace:delete": {
-      "aliases": [],
-      "args": {
-        "name": {
-          "description": "name of the workspace to delete",
-          "name": "name",
-          "required": true
-        }
-      },
-      "description": "Delete a workspace if it exists.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> dev"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "workspace:delete",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "workspace",
-        "delete",
-        "index.js"
-      ]
-    },
     "workspace:install": {
       "aliases": [],
       "args": {
@@ -2680,169 +2883,40 @@
         "index.js"
       ]
     },
-    "devenv:config": {
+    "workspace:create": {
       "aliases": [],
-      "args": {},
-      "description": "Configure SSH for a dev environment and display connection details. On-demand devenvs use a ProxyCommand that wakes the instance on first connection.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> -w my-workspace"
-      ],
-      "flags": {
-        "workspace": {
-          "char": "w",
-          "description": "name of the workspace to configure SSH for",
-          "name": "workspace",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+      "args": {
+        "name": {
+          "description": "name of the workspace to create",
+          "name": "name",
+          "required": true
         }
       },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "devenv:config",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "devenv",
-        "config",
-        "index.js"
-      ]
-    },
-    "devenv:install": {
-      "aliases": [],
-      "args": {},
-      "description": "Provision a remote dev environment on a workspace.",
+      "description": "Create a new workspace if it does not exist.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -w my-workspace -p instanceType=t3.large"
+        "<%= config.bin %> <%= command.id %> dev"
       ],
       "flags": {
-        "debug": {
-          "description": "enable debug mode",
-          "name": "debug",
+        "deployment": {
+          "char": "d",
+          "description": "mark workspace as a deployment workspace",
+          "name": "deployment",
+          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
-        "on-behalf-of": {
-          "description": "email of an org member to install the devenv for; the baked Hereya token will carry their identity (requires OWNER or ADMIN role)",
-          "name": "on-behalf-of",
+        "mirror": {
+          "description": "workspace to mirror",
+          "name": "mirror",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "parameter": {
-          "char": "p",
-          "description": "parameter for the package, in the form of 'key=value'. Can be specified multiple times.",
-          "name": "parameter",
-          "default": [],
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "parameter-file": {
-          "char": "f",
-          "description": "path to a file containing parameters for the package",
-          "name": "parameter-file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "version": {
-          "char": "v",
-          "description": "version of the dev environment package",
-          "name": "version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "workspace": {
-          "char": "w",
-          "description": "name of the workspace to provision the dev environment on",
-          "name": "workspace",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "devenv:install",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "devenv",
-        "install",
-        "index.js"
-      ]
-    },
-    "devenv:sleep": {
-      "aliases": [],
-      "args": {},
-      "description": "Stop the dev environment instance for a workspace (lifecycle=on-demand only).",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> -w my-workspace"
-      ],
-      "flags": {
-        "debug": {
-          "description": "enable debug mode",
-          "name": "debug",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "workspace": {
-          "char": "w",
-          "description": "name of the workspace whose dev environment should be stopped",
-          "name": "workspace",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "devenv:sleep",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "devenv",
-        "sleep",
-        "index.js"
-      ]
-    },
-    "devenv:ssh": {
-      "aliases": [],
-      "args": {},
-      "description": "SSH into a dev environment instance.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> -w my-workspace"
-      ],
-      "flags": {
-        "workspace": {
-          "char": "w",
-          "description": "name of the workspace to SSH into",
-          "name": "workspace",
-          "required": true,
+        "profile": {
+          "description": "workspace profile to set (cloud backend only)",
+          "name": "profile",
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2850,7 +2924,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devenv:ssh",
+      "id": "workspace:create",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -2860,19 +2934,36 @@
       "relativePath": [
         "dist",
         "commands",
-        "devenv",
-        "ssh",
+        "workspace",
+        "create",
         "index.js"
       ]
     },
-    "devenv:ssh-proxy": {
+    "devenv:project:uninit": {
       "aliases": [],
-      "args": {},
-      "description": "Internal: SSH ProxyCommand for on-demand devenvs (wake + connect).",
+      "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 to proxy SSH for",
+          "description": "name of the workspace",
           "name": "workspace",
           "required": true,
           "hasDynamicHelp": false,
@@ -2881,9 +2972,8 @@
         }
       },
       "hasDynamicHelp": false,
-      "hidden": true,
       "hiddenAliases": [],
-      "id": "devenv:ssh-proxy",
+      "id": "devenv:project:uninit",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -2894,27 +2984,65 @@
         "dist",
         "commands",
         "devenv",
-        "ssh-proxy",
+        "project",
+        "uninit",
         "index.js"
       ]
     },
-    "devenv:uninstall": {
+    "devenv:project:init": {
       "aliases": [],
-      "args": {},
-      "description": "Destroy and remove the dev environment from a workspace.",
+      "args": {
+        "project": {
+          "description": "project name",
+          "name": "project",
+          "required": true
+        }
+      },
+      "description": "Initialize a project on a remote dev environment.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -w my-workspace"
+        "<%= config.bin %> <%= command.id %> my-app -w my-workspace",
+        "<%= config.bin %> <%= command.id %> my-app -w my-workspace -t acme/node-starter",
+        "<%= config.bin %> <%= command.id %> my-app -w my-workspace -t acme/node-starter -p region=us-east-1"
       ],
       "flags": {
-        "debug": {
-          "description": "enable debug mode",
-          "name": "debug",
+        "deploy-workspace": {
+          "char": "d",
+          "description": "workspace used for deployment (required when using a template)",
+          "name": "deploy-workspace",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "force": {
+          "char": "f",
+          "description": "continue even if folder already exists",
+          "name": "force",
           "allowNo": false,
           "type": "boolean"
         },
+        "parameter": {
+          "char": "p",
+          "description": "parameter for the template, in the form of 'key=value'. Can be specified multiple times.",
+          "name": "parameter",
+          "required": false,
+          "default": [],
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "template": {
+          "char": "t",
+          "description": "template package to scaffold the project from",
+          "name": "template",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to remove the dev environment from",
+          "description": "name of the workspace",
           "name": "workspace",
           "required": true,
           "hasDynamicHelp": false,
@@ -2924,7 +3052,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devenv:uninstall",
+      "id": "devenv:project:init",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -2935,7 +3063,8 @@
         "dist",
         "commands",
         "devenv",
-        "uninstall",
+        "project",
+        "init",
         "index.js"
       ]
     },
@@ -3122,39 +3251,6 @@
         "index.js"
       ]
     },
-    "workspace:executor:token": {
-      "aliases": [],
-      "args": {},
-      "description": "Generate a workspace-scoped executor token for the remote executor",
-      "flags": {
-        "workspace": {
-          "char": "w",
-          "description": "name of the workspace",
-          "name": "workspace",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "workspace:executor:token",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "workspace",
-        "executor",
-        "token",
-        "index.js"
-      ]
-    },
     "workspace:executor:install": {
       "aliases": [],
       "args": {},
@@ -3228,29 +3324,11 @@
         "index.js"
       ]
     },
-    "workspace:executor:uninstall": {
+    "workspace:executor:token": {
       "aliases": [],
       "args": {},
-      "description": "Uninstall the remote executor from a workspace.\n\nBoth modes (always-on and ephemeral) are backed by the same package\n(hereya/remote-executor-aws). The --mode flag is informational only and\ncontrols log output.",
+      "description": "Generate a workspace-scoped executor token for the remote executor",
       "flags": {
-        "debug": {
-          "description": "enable debug mode",
-          "name": "debug",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "mode": {
-          "description": "executor mode used at install time (informational only)",
-          "name": "mode",
-          "default": "always-on",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "ephemeral",
-            "always-on"
-          ],
-          "type": "option"
-        },
         "workspace": {
           "char": "w",
           "description": "name of the workspace",
@@ -3263,7 +3341,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:executor:uninstall",
+      "id": "workspace:executor:token",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -3275,110 +3353,32 @@
         "commands",
         "workspace",
         "executor",
-        "uninstall",
+        "token",
         "index.js"
       ]
     },
-    "devenv:project:init": {
+    "workspace:executor:uninstall": {
       "aliases": [],
-      "args": {
-        "project": {
-          "description": "project name",
-          "name": "project",
-          "required": true
-        }
-      },
-      "description": "Initialize 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 -t acme/node-starter",
-        "<%= config.bin %> <%= command.id %> my-app -w my-workspace -t acme/node-starter -p region=us-east-1"
-      ],
+      "args": {},
+      "description": "Uninstall the remote executor from a workspace.\n\nBoth modes (always-on and ephemeral) are backed by the same package\n(hereya/remote-executor-aws). The --mode flag is informational only and\ncontrols log output.",
       "flags": {
-        "deploy-workspace": {
-          "char": "d",
-          "description": "workspace used for deployment (required when using a template)",
-          "name": "deploy-workspace",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "force": {
-          "char": "f",
-          "description": "continue even if folder already exists",
-          "name": "force",
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
           "allowNo": false,
           "type": "boolean"
         },
-        "parameter": {
-          "char": "p",
-          "description": "parameter for the template, in the form of 'key=value'. Can be specified multiple times.",
-          "name": "parameter",
-          "required": false,
-          "default": [],
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "template": {
-          "char": "t",
-          "description": "template package to scaffold the project from",
-          "name": "template",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "workspace": {
-          "char": "w",
-          "description": "name of the workspace",
-          "name": "workspace",
-          "required": true,
+        "mode": {
+          "description": "executor mode used at install time (informational only)",
+          "name": "mode",
+          "default": "always-on",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "ephemeral",
+            "always-on"
+          ],
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "devenv:project:init",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "devenv",
-        "project",
-        "init",
-        "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",
@@ -3392,7 +3392,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devenv:project:uninit",
+      "id": "workspace:executor:uninstall",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -3402,12 +3402,12 @@
       "relativePath": [
         "dist",
         "commands",
-        "devenv",
-        "project",
-        "uninit",
+        "workspace",
+        "executor",
+        "uninstall",
         "index.js"
       ]
     }
   },
-  "version": "0.100.5"
+  "version": "0.101.0"
 }