hereya-cli 0.100.4 → 0.100.5

package/oclif.manifest.json

@@ -63,33 +63,32 @@
         "index.js"
       ]
     },
-    "clone": {
+    "bootstrap": {
       "aliases": [],
       "args": {
-        "project": {
-          "description": "project name",
-          "name": "project",
+        "infrastructureType": {
+          "description": "infrastructure to bootstrap. Options are local, aws",
+          "name": "infrastructureType",
           "required": true
         }
       },
-      "description": "Clone an existing template-based project to the local machine.",
+      "description": "Install necessary resources for hereya operations in an infrastructure.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> myProject",
-        "<%= config.bin %> <%= command.id %> myProject --chdir=./myProject"
+        "<%= config.bin %> <%= command.id %> aws",
+        "<%= config.bin %> <%= command.id %> local"
       ],
       "flags": {
-        "chdir": {
-          "description": "directory to clone into",
-          "name": "chdir",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "force": {
+          "char": "f",
+          "description": "redeploy hereya resources if already deployed",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "clone",
+      "id": "bootstrap",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -99,36 +98,37 @@
       "relativePath": [
         "dist",
         "commands",
-        "clone",
+        "bootstrap",
         "index.js"
       ]
     },
-    "bootstrap": {
+    "clone": {
       "aliases": [],
       "args": {
-        "infrastructureType": {
-          "description": "infrastructure to bootstrap. Options are local, aws",
-          "name": "infrastructureType",
+        "project": {
+          "description": "project name",
+          "name": "project",
           "required": true
         }
       },
-      "description": "Install necessary resources for hereya operations in an infrastructure.",
+      "description": "Clone an existing template-based project to the local machine.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> aws",
-        "<%= config.bin %> <%= command.id %> local"
+        "<%= config.bin %> <%= command.id %> myProject",
+        "<%= config.bin %> <%= command.id %> myProject --chdir=./myProject"
       ],
       "flags": {
-        "force": {
-          "char": "f",
-          "description": "redeploy hereya resources if already deployed",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
+        "chdir": {
+          "description": "directory to clone into",
+          "name": "chdir",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "bootstrap",
+      "id": "clone",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -138,7 +138,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "bootstrap",
+        "clone",
         "index.js"
       ]
     },
@@ -1096,64 +1096,6 @@
         "index.js"
       ]
     },
-    "uninit": {
-      "aliases": [],
-      "args": {
-        "project": {
-          "description": "project name",
-          "name": "project",
-          "required": true
-        }
-      },
-      "description": "Destroy template infrastructure and uninitialize a project.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> myProject -w dev",
-        "<%= config.bin %> <%= command.id %> myProject -w dev -p prodWorkspace=prod"
-      ],
-      "flags": {
-        "chdir": {
-          "description": "directory to run command in",
-          "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",
-          "default": [],
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "workspace": {
-          "char": "w",
-          "description": "workspace used during init",
-          "name": "workspace",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "uninit",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "uninit",
-        "index.js"
-      ]
-    },
     "up": {
       "aliases": [],
       "args": {},
@@ -1250,6 +1192,64 @@
         "index.js"
       ]
     },
+    "uninit": {
+      "aliases": [],
+      "args": {
+        "project": {
+          "description": "project name",
+          "name": "project",
+          "required": true
+        }
+      },
+      "description": "Destroy template infrastructure and uninitialize a project.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> myProject -w dev",
+        "<%= config.bin %> <%= command.id %> myProject -w dev -p prodWorkspace=prod"
+      ],
+      "flags": {
+        "chdir": {
+          "description": "directory to run command in",
+          "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",
+          "default": [],
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "workspace used during init",
+          "name": "workspace",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "uninit",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "uninit",
+        "index.js"
+      ]
+    },
     "app:deploy": {
       "aliases": [],
       "args": {
@@ -1701,19 +1701,46 @@
         "index.js"
       ]
     },
-    "devenv:config": {
+    "docker:run": {
       "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.",
+      "args": {
+        "image": {
+          "description": "Docker image to run",
+          "name": "image",
+          "required": true
+        }
+      },
+      "description": "Run a Docker container with hereya env vars injected as -e flags.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -w my-workspace"
+        "<%= 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": "directory to run command in",
+          "name": "chdir",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "port": {
+          "char": "p",
+          "description": "port to forward and set as PORT env var (default: 8080)",
+          "name": "port",
+          "required": false,
+          "default": 8080,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to configure SSH for",
+          "description": "name of the workspace to use",
           "name": "workspace",
-          "required": true,
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1721,223 +1748,57 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devenv:config",
+      "id": "docker:run",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "devenv",
-        "config",
+        "docker",
+        "run",
         "index.js"
       ]
     },
-    "devenv:install": {
+    "env:set": {
       "aliases": [],
-      "args": {},
-      "description": "Provision a remote dev environment on a workspace.",
+      "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 -p instanceType=t3.large"
+        "<%= config.bin %> <%= command.id %> FOO -v bar",
+        "<%= config.bin %> <%= command.id %> FOO -v bar -w dev"
       ],
       "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",
+        "chdir": {
+          "description": "project root directory",
+          "name": "chdir",
           "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": {
+        "value": {
           "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,
-          "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",
+          "description": "value of the environment variable",
+          "name": "value",
           "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",
+          "description": "name of the workspace to print the env vars for",
           "name": "workspace",
-          "required": true,
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1945,7 +1806,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devenv:uninstall",
+      "id": "env:set",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -1955,50 +1816,53 @@
       "relativePath": [
         "dist",
         "commands",
-        "devenv",
-        "uninstall",
+        "env",
+        "set",
         "index.js"
       ]
     },
-    "docker:run": {
+    "flow:add": {
       "aliases": [],
       "args": {
-        "image": {
-          "description": "Docker image to run",
-          "name": "image",
+        "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": "Run a Docker container with hereya env vars injected as -e flags.",
+      "description": "Add a package to the project in a git branch-based 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 %> 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": "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"
         },
-        "port": {
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
+          "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 package, in the form of 'key=value'. Can be specified multiple times.",
+          "name": "parameter",
+          "default": [],
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "workspace": {
-          "char": "w",
-          "description": "name of the workspace to use",
-          "name": "workspace",
+        "profile": {
+          "description": "profile to use for the workspace (will be appended to workspace name)",
+          "name": "profile",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2007,18 +1871,18 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "docker:run",
+      "id": "flow:add",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "docker",
-        "run",
+        "flow",
+        "add",
         "index.js"
       ]
     },
@@ -2030,157 +1894,34 @@
         "<%= 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": {
-        "concurrency": {
-          "char": "c",
-          "description": "maximum number of parallel jobs",
-          "name": "concurrency",
-          "default": 10,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "idleTimeout": {
-          "aliases": [
-            "idle-timeout"
-          ],
-          "char": "i",
-          "description": "seconds idle before exit; omit to keep running indefinitely",
-          "name": "idleTimeout",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "workspace": {
-          "char": "w",
-          "description": "name of the workspace to poll jobs for",
-          "name": "workspace",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "executor:start",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "executor",
-        "start",
-        "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",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "env",
-        "set",
-        "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,
+        "HEREYA_TOKEN=<token> HEREYA_CLOUD_URL=https://my-cloud.example.com <%= config.bin %> <%= command.id %> -w my-workspace"
+      ],
+      "flags": {
+        "concurrency": {
+          "char": "c",
+          "description": "maximum number of parallel jobs",
+          "name": "concurrency",
+          "default": 10,
           "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": [],
+        "idleTimeout": {
+          "aliases": [
+            "idle-timeout"
+          ],
+          "char": "i",
+          "description": "seconds idle before exit; omit to keep running indefinitely",
+          "name": "idleTimeout",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "profile": {
-          "description": "profile to use for the workspace (will be appended to workspace name)",
-          "name": "profile",
-          "required": false,
+        "workspace": {
+          "char": "w",
+          "description": "name of the workspace to poll jobs for",
+          "name": "workspace",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2188,7 +1929,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:add",
+      "id": "executor:start",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -2198,8 +1939,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "flow",
-        "add",
+        "executor",
+        "start",
         "index.js"
       ]
     },
@@ -2644,37 +2385,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:env": {
       "aliases": [],
       "args": {
@@ -2725,6 +2435,37 @@
         "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": {
@@ -2939,60 +2680,199 @@
         "index.js"
       ]
     },
-    "devenv:project:init": {
+    "devenv:config": {
       "aliases": [],
-      "args": {
-        "project": {
-          "description": "project name",
-          "name": "project",
-          "required": true
+      "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"
         }
       },
-      "description": "Initialize a project on a remote dev environment.",
+      "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 %> 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"
+        "<%= config.bin %> <%= command.id %> -w my-workspace -p instanceType=t3.large"
       ],
       "flags": {
-        "deploy-workspace": {
-          "char": "d",
-          "description": "workspace used for deployment (required when using a template)",
-          "name": "deploy-workspace",
+        "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"
         },
-        "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.",
+          "description": "parameter for the package, 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,
+        "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,
           "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",
+          "description": "name of the workspace to proxy SSH for",
           "name": "workspace",
           "required": true,
           "hasDynamicHelp": false,
@@ -3001,8 +2881,9 @@
         }
       },
       "hasDynamicHelp": false,
+      "hidden": true,
       "hiddenAliases": [],
-      "id": "devenv:project:init",
+      "id": "devenv:ssh-proxy",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -3013,36 +2894,27 @@
         "dist",
         "commands",
         "devenv",
-        "project",
-        "init",
+        "ssh-proxy",
         "index.js"
       ]
     },
-    "devenv:project:uninit": {
+    "devenv:uninstall": {
       "aliases": [],
-      "args": {
-        "project": {
-          "description": "project name",
-          "name": "project",
-          "required": true
-        }
-      },
-      "description": "Uninitialize a project on a remote dev environment.",
+      "args": {},
+      "description": "Destroy and remove the dev environment from a workspace.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> my-app -w my-workspace",
-        "<%= config.bin %> <%= command.id %> my-app -w my-workspace --force"
+        "<%= config.bin %> <%= command.id %> -w my-workspace"
       ],
       "flags": {
-        "force": {
-          "char": "f",
-          "description": "also remove the project directory after uninit",
-          "name": "force",
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
           "allowNo": false,
           "type": "boolean"
         },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace",
+          "description": "name of the workspace to remove the dev environment from",
           "name": "workspace",
           "required": true,
           "hasDynamicHelp": false,
@@ -3052,7 +2924,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devenv:project:uninit",
+      "id": "devenv:uninstall",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -3063,8 +2935,7 @@
         "dist",
         "commands",
         "devenv",
-        "project",
-        "uninit",
+        "uninstall",
         "index.js"
       ]
     },
@@ -3251,6 +3122,39 @@
         "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": {},
@@ -3324,11 +3228,29 @@
         "index.js"
       ]
     },
-    "workspace:executor:token": {
+    "workspace:executor:uninstall": {
       "aliases": [],
       "args": {},
-      "description": "Generate a workspace-scoped executor token for the remote executor",
+      "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": {
+        "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",
@@ -3341,7 +3263,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:executor:token",
+      "id": "workspace:executor:uninstall",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -3353,31 +3275,59 @@
         "commands",
         "workspace",
         "executor",
-        "token",
+        "uninstall",
         "index.js"
       ]
     },
-    "workspace:executor:uninstall": {
+    "devenv:project:init": {
       "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.",
+      "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"
+      ],
       "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"
         },
-        "mode": {
-          "description": "executor mode used at install time (informational only)",
-          "name": "mode",
-          "default": "always-on",
+        "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,
-          "options": [
-            "ephemeral",
-            "always-on"
-          ],
           "type": "option"
         },
         "workspace": {
@@ -3392,7 +3342,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:executor:uninstall",
+      "id": "devenv:project:init",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -3402,12 +3352,62 @@
       "relativePath": [
         "dist",
         "commands",
-        "workspace",
-        "executor",
-        "uninstall",
+        "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",
+          "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"
       ]
     }
   },
-  "version": "0.100.4"
+  "version": "0.100.5"
 }