hereya-cli 0.92.2 → 0.93.0

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g hereya-cli
 $ hereya COMMAND
 running command...
 $ hereya (--version)
-hereya-cli/0.92.2 linux-x64 node-v24.14.1
+hereya-cli/0.93.0 linux-x64 node-v24.14.1
 $ hereya --help [COMMAND]
 USAGE
   $ hereya COMMAND
@@ -50,6 +50,7 @@ USAGE
 * [`hereya devenv install`](#hereya-devenv-install)
 * [`hereya devenv project init PROJECT`](#hereya-devenv-project-init-project)
 * [`hereya devenv project uninit PROJECT`](#hereya-devenv-project-uninit-project)
+* [`hereya devenv sleep`](#hereya-devenv-sleep)
 * [`hereya devenv ssh`](#hereya-devenv-ssh)
 * [`hereya devenv uninstall`](#hereya-devenv-uninstall)
 * [`hereya doc PACKAGE`](#hereya-doc-package)
@@ -128,7 +129,7 @@ EXAMPLES
   $ hereya add cloudy/docker_postgres
 ```
 
-_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/add/index.ts)_
+_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/add/index.ts)_
 
 ## `hereya app deploy NAME`
 
@@ -162,7 +163,7 @@ EXAMPLES
   $ hereya app deploy my-org/my-app -w prod -p organizationId=org-123
 ```
 
-_See code: [src/commands/app/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/app/deploy/index.ts)_
+_See code: [src/commands/app/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/app/deploy/index.ts)_
 
 ## `hereya app deployments NAME`
 
@@ -182,7 +183,7 @@ EXAMPLES
   $ hereya app deployments my-org/my-app
 ```
 
-_See code: [src/commands/app/deployments/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/app/deployments/index.ts)_
+_See code: [src/commands/app/deployments/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/app/deployments/index.ts)_
 
 ## `hereya app destroy NAME`
 
@@ -211,7 +212,7 @@ EXAMPLES
   $ hereya app destroy my-org/my-app -w my-workspace
 ```
 
-_See code: [src/commands/app/destroy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/app/destroy/index.ts)_
+_See code: [src/commands/app/destroy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/app/destroy/index.ts)_
 
 ## `hereya app env NAME [KEY]`
 
@@ -237,7 +238,7 @@ EXAMPLES
   $ hereya app env my-org/my-app -w my-workspace DATABASE_URL
 ```
 
-_See code: [src/commands/app/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/app/env/index.ts)_
+_See code: [src/commands/app/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/app/env/index.ts)_
 
 ## `hereya app list`
 
@@ -254,7 +255,7 @@ EXAMPLES
   $ hereya app list
 ```
 
-_See code: [src/commands/app/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/app/list/index.ts)_
+_See code: [src/commands/app/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/app/list/index.ts)_
 
 ## `hereya app new DIRNAME`
 
@@ -280,7 +281,7 @@ EXAMPLES
   $ hereya app new ./my-app -n my-org/my-app --description "An ai-app-builder app"
 ```
 
-_See code: [src/commands/app/new/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/app/new/index.ts)_
+_See code: [src/commands/app/new/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/app/new/index.ts)_
 
 ## `hereya app status NAME`
 
@@ -303,7 +304,7 @@ EXAMPLES
   $ hereya app status my-org/my-app -w my-workspace
 ```
 
-_See code: [src/commands/app/status/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/app/status/index.ts)_
+_See code: [src/commands/app/status/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/app/status/index.ts)_
 
 ## `hereya bootstrap INFRASTRUCTURETYPE`
 
@@ -328,7 +329,7 @@ EXAMPLES
   $ hereya bootstrap local
 ```
 
-_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/bootstrap/index.ts)_
+_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/bootstrap/index.ts)_
 
 ## `hereya clone PROJECT`
 
@@ -353,7 +354,7 @@ EXAMPLES
   $ hereya clone myProject --chdir=./myProject
 ```
 
-_See code: [src/commands/clone/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/clone/index.ts)_
+_See code: [src/commands/clone/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/clone/index.ts)_
 
 ## `hereya config export-backend [FILE]`
 
@@ -375,7 +376,7 @@ EXAMPLES
   $ hereya config export-backend ./path/to/export.json
 ```
 
-_See code: [src/commands/config/export-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/config/export-backend/index.ts)_
+_See code: [src/commands/config/export-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/config/export-backend/index.ts)_
 
 ## `hereya config get-backend`
 
@@ -392,7 +393,7 @@ EXAMPLES
   $ hereya config get-backend
 ```
 
-_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/config/get-backend/index.ts)_
+_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/config/get-backend/index.ts)_
 
 ## `hereya config import-backend FILE`
 
@@ -412,7 +413,7 @@ EXAMPLES
   $ hereya config import-backend ./path/to/cloud-backend.json
 ```
 
-_See code: [src/commands/config/import-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/config/import-backend/index.ts)_
+_See code: [src/commands/config/import-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/config/import-backend/index.ts)_
 
 ## `hereya config use-backend TYPE`
 
@@ -434,7 +435,7 @@ EXAMPLES
   $ hereya config use-backend local
 ```
 
-_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/config/use-backend/index.ts)_
+_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/config/use-backend/index.ts)_
 
 ## `hereya delete-state`
 
@@ -460,7 +461,7 @@ EXAMPLES
   $ hereya delete-state --workspace staging
 ```
 
-_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/delete-state/index.ts)_
+_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/delete-state/index.ts)_
 
 ## `hereya deploy`
 
@@ -486,7 +487,7 @@ EXAMPLES
   $ hereya deploy
 ```
 
-_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/deploy/index.ts)_
+_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/deploy/index.ts)_
 
 ## `hereya devenv config`
 
@@ -506,7 +507,7 @@ EXAMPLES
   $ hereya devenv config -w my-workspace
 ```
 
-_See code: [src/commands/devenv/config/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/devenv/config/index.ts)_
+_See code: [src/commands/devenv/config/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/devenv/config/index.ts)_
 
 ## `hereya devenv install`
 
@@ -531,7 +532,7 @@ EXAMPLES
   $ hereya devenv install -w my-workspace -p instanceType=t3.large
 ```
 
-_See code: [src/commands/devenv/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/devenv/install/index.ts)_
+_See code: [src/commands/devenv/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/devenv/install/index.ts)_
 
 ## `hereya devenv project init PROJECT`
 
@@ -563,7 +564,7 @@ EXAMPLES
   $ hereya devenv project init my-app -w my-workspace -t acme/node-starter -p region=us-east-1
 ```
 
-_See code: [src/commands/devenv/project/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/devenv/project/init/index.ts)_
+_See code: [src/commands/devenv/project/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/devenv/project/init/index.ts)_
 
 ## `hereya devenv project uninit PROJECT`
 
@@ -589,7 +590,28 @@ EXAMPLES
   $ hereya devenv project uninit my-app -w my-workspace --force
 ```
 
-_See code: [src/commands/devenv/project/uninit/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/devenv/project/uninit/index.ts)_
+_See code: [src/commands/devenv/project/uninit/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/devenv/project/uninit/index.ts)_
+
+## `hereya devenv sleep`
+
+Stop the dev environment instance for a workspace (lifecycle=on-demand only).
+
+```
+USAGE
+  $ hereya devenv sleep -w <value> [--debug]
+
+FLAGS
+  -w, --workspace=<value>  (required) name of the workspace whose dev environment should be stopped
+      --debug              enable debug mode
+
+DESCRIPTION
+  Stop the dev environment instance for a workspace (lifecycle=on-demand only).
+
+EXAMPLES
+  $ hereya devenv sleep -w my-workspace
+```
+
+_See code: [src/commands/devenv/sleep/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/devenv/sleep/index.ts)_
 
 ## `hereya devenv ssh`
 
@@ -609,7 +631,7 @@ EXAMPLES
   $ hereya devenv ssh -w my-workspace
 ```
 
-_See code: [src/commands/devenv/ssh/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/devenv/ssh/index.ts)_
+_See code: [src/commands/devenv/ssh/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/devenv/ssh/index.ts)_
 
 ## `hereya devenv uninstall`
 
@@ -630,7 +652,7 @@ EXAMPLES
   $ hereya devenv uninstall -w my-workspace
 ```
 
-_See code: [src/commands/devenv/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/devenv/uninstall/index.ts)_
+_See code: [src/commands/devenv/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/devenv/uninstall/index.ts)_
 
 ## `hereya doc PACKAGE`
 
@@ -663,7 +685,7 @@ EXAMPLES
   $ hereya doc my-package --no-doc
 ```
 
-_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/doc/index.ts)_
+_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/doc/index.ts)_
 
 ## `hereya docker run IMAGE`
 
@@ -694,7 +716,7 @@ EXAMPLES
   $ hereya docker run myapp:latest -- --rm -v ./data:/data
 ```
 
-_See code: [src/commands/docker/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/docker/run/index.ts)_
+_See code: [src/commands/docker/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/docker/run/index.ts)_
 
 ## `hereya down`
 
@@ -721,7 +743,7 @@ EXAMPLES
   $ hereya down
 ```
 
-_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/down/index.ts)_
+_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/down/index.ts)_
 
 ## `hereya env [NAME]`
 
@@ -752,7 +774,7 @@ EXAMPLES
   $ hereya env -w dev -l
 ```
 
-_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/env/index.ts)_
+_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/env/index.ts)_
 
 ## `hereya env set [NAME]`
 
@@ -779,7 +801,7 @@ EXAMPLES
   $ hereya env set FOO -v bar -w dev
 ```
 
-_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/env/set/index.ts)_
+_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/env/set/index.ts)_
 
 ## `hereya executor start`
 
@@ -813,7 +835,7 @@ EXAMPLES
   HEREYA_TOKEN=<token> HEREYA_CLOUD_URL=https://my-cloud.example.com hereya executor start -w my-workspace
 ```
 
-_See code: [src/commands/executor/start/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/executor/start/index.ts)_
+_See code: [src/commands/executor/start/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/executor/start/index.ts)_
 
 ## `hereya flow add PACKAGE`
 
@@ -851,7 +873,7 @@ EXAMPLES
   $ hereya flow add cloudy/docker_postgres -p DB_NAME=mydb -p DB_USER=admin
 ```
 
-_See code: [src/commands/flow/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/flow/add/index.ts)_
+_See code: [src/commands/flow/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/flow/add/index.ts)_
 
 ## `hereya flow docker run IMAGE`
 
@@ -881,7 +903,7 @@ EXAMPLES
   $ hereya flow docker run --pin myapp:latest -- --rm
 ```
 
-_See code: [src/commands/flow/docker/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/flow/docker/run/index.ts)_
+_See code: [src/commands/flow/docker/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/flow/docker/run/index.ts)_
 
 ## `hereya flow down`
 
@@ -915,7 +937,7 @@ EXAMPLES
   $ hereya flow down --pin
 ```
 
-_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/flow/down/index.ts)_
+_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/flow/down/index.ts)_
 
 ## `hereya flow env [NAME]`
 
@@ -949,7 +971,7 @@ EXAMPLES
   $ hereya flow env -l
 ```
 
-_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/flow/env/index.ts)_
+_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/flow/env/index.ts)_
 
 ## `hereya flow provid PACKAGE`
 
@@ -978,7 +1000,7 @@ EXAMPLES
   $ hereya flow provid hereya/postgres --pin
 ```
 
-_See code: [src/commands/flow/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/flow/provid/index.ts)_
+_See code: [src/commands/flow/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/flow/provid/index.ts)_
 
 ## `hereya flow remove PACKAGE`
 
@@ -1008,7 +1030,7 @@ EXAMPLES
   $ hereya flow remove cloudy/docker_postgres --profile staging
 ```
 
-_See code: [src/commands/flow/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/flow/remove/index.ts)_
+_See code: [src/commands/flow/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/flow/remove/index.ts)_
 
 ## `hereya flow run CMD`
 
@@ -1037,7 +1059,7 @@ EXAMPLES
   $ hereya flow run --pin -- npm test
 ```
 
-_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/flow/run/index.ts)_
+_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/flow/run/index.ts)_
 
 ## `hereya flow up`
 
@@ -1071,7 +1093,7 @@ EXAMPLES
   $ hereya flow up --pin
 ```
 
-_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/flow/up/index.ts)_
+_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/flow/up/index.ts)_
 
 ## `hereya help [COMMAND]`
 
@@ -1128,7 +1150,7 @@ EXAMPLES
   $ hereya import org/my-package -f state.tfstate -w my-workspace
 ```
 
-_See code: [src/commands/import/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/import/index.ts)_
+_See code: [src/commands/import/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/import/index.ts)_
 
 ## `hereya import-repo PROJECT`
 
@@ -1158,7 +1180,7 @@ EXAMPLES
   $ hereya import-repo myProject -w=dev -r=https://github.com/acme/api --clone --chdir=./api
 ```
 
-_See code: [src/commands/import-repo/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/import-repo/index.ts)_
+_See code: [src/commands/import-repo/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/import-repo/index.ts)_
 
 ## `hereya init PROJECT`
 
@@ -1192,7 +1214,7 @@ EXAMPLES
   $ hereya init myProject -w=dev -t=acme/node-starter -d=prod -p region=us-east-1
 ```
 
-_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/init/index.ts)_
+_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/init/index.ts)_
 
 ## `hereya list`
 
@@ -1209,7 +1231,7 @@ EXAMPLES
   $ hereya list
 ```
 
-_See code: [src/commands/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/list/index.ts)_
+_See code: [src/commands/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/list/index.ts)_
 
 ## `hereya login [URL]`
 
@@ -1238,7 +1260,7 @@ EXAMPLES
   $ hereya login --token=your-token https://cloud.hereya.dev
 ```
 
-_See code: [src/commands/login/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/login/index.ts)_
+_See code: [src/commands/login/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/login/index.ts)_
 
 ## `hereya logout`
 
@@ -1255,7 +1277,7 @@ EXAMPLES
   $ hereya logout
 ```
 
-_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/logout/index.ts)_
+_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/logout/index.ts)_
 
 ## `hereya provid PACKAGE`
 
@@ -1283,7 +1305,7 @@ EXAMPLES
   $ hereya provid hereya/postgres --workspace staging
 ```
 
-_See code: [src/commands/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/provid/index.ts)_
+_See code: [src/commands/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/provid/index.ts)_
 
 ## `hereya publish`
 
@@ -1306,7 +1328,7 @@ EXAMPLES
   $ hereya publish --chdir=/path/to/package
 ```
 
-_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/publish/index.ts)_
+_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/publish/index.ts)_
 
 ## `hereya remove PACKAGE`
 
@@ -1334,7 +1356,7 @@ EXAMPLES
   $ hereya remove cloudy/docker_postgres
 ```
 
-_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/remove/index.ts)_
+_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/remove/index.ts)_
 
 ## `hereya run CMD`
 
@@ -1360,7 +1382,7 @@ EXAMPLES
   $ hereya run -w uat -- node index.js
 ```
 
-_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/run/index.ts)_
+_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/run/index.ts)_
 
 ## `hereya search QUERY`
 
@@ -1391,7 +1413,7 @@ EXAMPLES
   $ hereya search database --json
 ```
 
-_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/search/index.ts)_
+_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/search/index.ts)_
 
 ## `hereya unbootstrap INFRASTRUCTURETYPE`
 
@@ -1416,7 +1438,7 @@ EXAMPLES
   $ hereya unbootstrap local
 ```
 
-_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/unbootstrap/index.ts)_
+_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/unbootstrap/index.ts)_
 
 ## `hereya undeploy`
 
@@ -1442,7 +1464,7 @@ EXAMPLES
   $ hereya undeploy
 ```
 
-_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/undeploy/index.ts)_
+_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/undeploy/index.ts)_
 
 ## `hereya uninit PROJECT`
 
@@ -1470,7 +1492,7 @@ EXAMPLES
   $ hereya uninit myProject -w dev -p prodWorkspace=prod
 ```
 
-_See code: [src/commands/uninit/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/uninit/index.ts)_
+_See code: [src/commands/uninit/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/uninit/index.ts)_
 
 ## `hereya up`
 
@@ -1497,7 +1519,7 @@ EXAMPLES
   $ hereya up
 ```
 
-_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/up/index.ts)_
+_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/up/index.ts)_
 
 ## `hereya update [VERSION]`
 
@@ -1519,7 +1541,7 @@ EXAMPLES
   $ hereya update 0.75.0
 ```
 
-_See code: [src/commands/update/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/update/index.ts)_
+_See code: [src/commands/update/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/update/index.ts)_
 
 ## `hereya workspace create NAME`
 
@@ -1544,7 +1566,7 @@ EXAMPLES
   $ hereya workspace create dev
 ```
 
-_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/workspace/create/index.ts)_
+_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/workspace/create/index.ts)_
 
 ## `hereya workspace delete NAME`
 
@@ -1564,7 +1586,7 @@ EXAMPLES
   $ hereya workspace delete dev
 ```
 
-_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/workspace/delete/index.ts)_
+_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/workspace/delete/index.ts)_
 
 ## `hereya workspace env [NAME]`
 
@@ -1590,7 +1612,7 @@ EXAMPLES
   $ hereya workspace env myEnv -w dev
 ```
 
-_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/workspace/env/index.ts)_
+_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/workspace/env/index.ts)_
 
 ## `hereya workspace env set`
 
@@ -1614,7 +1636,7 @@ EXAMPLES
   $ hereya workspace env set -w my-workspace -n myVar -v my-value -i aws -s
 ```
 
-_See code: [src/commands/workspace/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/workspace/env/set/index.ts)_
+_See code: [src/commands/workspace/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/workspace/env/set/index.ts)_
 
 ## `hereya workspace env unset`
 
@@ -1635,7 +1657,7 @@ EXAMPLES
   $ hereya workspace env unset -w my-workspace -n myVar
 ```
 
-_See code: [src/commands/workspace/env/unset/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/workspace/env/unset/index.ts)_
+_See code: [src/commands/workspace/env/unset/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/workspace/env/unset/index.ts)_
 
 ## `hereya workspace executor install`
 
@@ -1662,7 +1684,7 @@ DESCRIPTION
   - ephemeral: ASG scaled to 0 with a broker Lambda + OIDC for on-demand wake.
 ```
 
-_See code: [src/commands/workspace/executor/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/workspace/executor/install/index.ts)_
+_See code: [src/commands/workspace/executor/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/workspace/executor/install/index.ts)_
 
 ## `hereya workspace executor token`
 
@@ -1679,7 +1701,7 @@ DESCRIPTION
   Generate a workspace-scoped executor token for the remote executor
 ```
 
-_See code: [src/commands/workspace/executor/token/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/workspace/executor/token/index.ts)_
+_See code: [src/commands/workspace/executor/token/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/workspace/executor/token/index.ts)_
 
 ## `hereya workspace executor uninstall`
 
@@ -1703,7 +1725,7 @@ DESCRIPTION
   controls log output.
 ```
 
-_See code: [src/commands/workspace/executor/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/workspace/executor/uninstall/index.ts)_
+_See code: [src/commands/workspace/executor/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/workspace/executor/uninstall/index.ts)_
 
 ## `hereya workspace install PACKAGE`
 
@@ -1730,7 +1752,7 @@ EXAMPLES
   $ hereya workspace install hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/workspace/install/index.ts)_
+_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/workspace/install/index.ts)_
 
 ## `hereya workspace list`
 
@@ -1754,7 +1776,7 @@ EXAMPLES
   $ hereya workspace list --org personal
 ```
 
-_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/workspace/list/index.ts)_
+_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/workspace/list/index.ts)_
 
 ## `hereya workspace set-profile PROFILE`
 
@@ -1778,7 +1800,7 @@ EXAMPLES
   $ hereya workspace set-profile prod-profile -w production
 ```
 
-_See code: [src/commands/workspace/set-profile/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/workspace/set-profile/index.ts)_
+_See code: [src/commands/workspace/set-profile/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/workspace/set-profile/index.ts)_
 
 ## `hereya workspace uninstall PACKAGE`
 
@@ -1805,5 +1827,5 @@ EXAMPLES
   $ hereya workspace uninstall hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.92.2/src/commands/workspace/uninstall/index.ts)_
+_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.93.0/src/commands/workspace/uninstall/index.ts)_
 <!-- commandsstop -->

package/dist/commands/devenv/sleep/index.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@oclif/core';
+export default class DevenvSleep extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        workspace: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/devenv/sleep/index.js

@@ -0,0 +1,77 @@
+import { Command, Flags } from '@oclif/core';
+import { Listr, ListrLogger, ListrLogLevels } from 'listr2';
+import { getBackend } from '../../../backend/index.js';
+import { getExecutorForWorkspace } from '../../../executor/context.js';
+import { getLogPath, isDebug, setDebug } from '../../../lib/log.js';
+export default class DevenvSleep extends Command {
+    static description = 'Stop the dev environment instance for a workspace (lifecycle=on-demand only).';
+    static examples = ['<%= config.bin %> <%= command.id %> -w my-workspace'];
+    static flags = {
+        debug: Flags.boolean({
+            default: false,
+            description: 'enable debug mode',
+        }),
+        workspace: Flags.string({
+            char: 'w',
+            description: 'name of the workspace whose dev environment should be stopped',
+            required: true,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(DevenvSleep);
+        setDebug(flags.debug);
+        const myLogger = new ListrLogger({ useIcons: false });
+        const task = new Listr([
+            {
+                async task(ctx, task) {
+                    return task.newListr([
+                        {
+                            async task(ctx) {
+                                const backend = await getBackend();
+                                const getWorkspaceEnvOutput = await backend.getWorkspaceEnv({ workspace: flags.workspace });
+                                if (!getWorkspaceEnvOutput.success) {
+                                    throw new Error(getWorkspaceEnvOutput.reason);
+                                }
+                                const executor$ = await getExecutorForWorkspace(flags.workspace);
+                                if (!executor$.success) {
+                                    throw new Error(executor$.reason);
+                                }
+                                const { executor } = executor$;
+                                const env = await executor.resolveEnvValues({ env: getWorkspaceEnvOutput.env });
+                                if (!env.devEnvWakeUrl) {
+                                    throw new Error(`Workspace ${flags.workspace} was not provisioned with lifecycle=on-demand; nothing to sleep.`);
+                                }
+                                ctx.wakeUrl = env.devEnvWakeUrl;
+                                ctx.wakeToken = env.devEnvWakeToken;
+                            },
+                            title: `Loading workspace ${flags.workspace}`,
+                        },
+                        {
+                            async task(ctx) {
+                                const response = await fetch(`${ctx.wakeUrl}/sleep`, {
+                                    headers: { Authorization: `Bearer ${ctx.wakeToken}` },
+                                    method: 'POST',
+                                });
+                                if (!response.ok) {
+                                    const body = await response.text().catch(() => '');
+                                    throw new Error(`broker /sleep returned ${response.status}: ${body}`);
+                                }
+                            },
+                            title: 'Stopping dev environment',
+                        },
+                    ]);
+                },
+                title: `Putting dev environment to sleep for workspace ${flags.workspace}`,
+            },
+        ], { concurrent: false, rendererOptions: { collapseSubtasks: !isDebug() } });
+        try {
+            await task.run();
+            myLogger.log(ListrLogLevels.COMPLETED, 'Dev environment is now stopping');
+        }
+        catch (error) {
+            this.error(`${error.message}
+
+See ${getLogPath()} for more details`);
+        }
+    }
+}

package/dist/commands/devenv/ssh/index.d.ts

@@ -7,4 +7,7 @@ export default class DevenvSsh extends Command {
     };
     run(): Promise<void>;
     protected spawnSsh(args: string[]): Promise<void>;
+    private fetchStatus;
+    private postWake;
+    private wakeAndPoll;
 }

package/dist/commands/devenv/ssh/index.js

@@ -1,4 +1,5 @@
 import { Command, Flags } from '@oclif/core';
+import { Listr } from 'listr2';
 import { spawnSync } from 'node:child_process';
 import { randomUUID } from 'node:crypto';
 import fs from 'node:fs/promises';
@@ -6,7 +7,21 @@ import os from 'node:os';
 import path from 'node:path';
 import { getBackend } from '../../../backend/index.js';
 import { getExecutorForWorkspace } from '../../../executor/context.js';
+import { getLogPath } from '../../../lib/log.js';
 import { setKeyFilePermissions } from '../../../lib/ssh-utils.js';
+// Polling cadence and overall timeout for the wake broker. Overridable via env
+// vars purely to keep tests fast — the defaults are the production values.
+function getWakePollIntervalMs() {
+    return Number(process.env.HEREYA_WAKE_POLL_INTERVAL_MS) || 4000;
+}
+function getWakeTimeoutMs() {
+    return Number(process.env.HEREYA_WAKE_TIMEOUT_MS) || 90_000;
+}
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
 export default class DevenvSsh extends Command {
     static description = 'SSH into a dev environment instance.';
     static examples = [
@@ -34,13 +49,26 @@ export default class DevenvSsh extends Command {
         }
         const { executor } = executor$;
         env = await executor.resolveEnvValues({ env });
-        const sshHost = env.devEnvSshHost;
+        let sshHost = env.devEnvSshHost;
         const sshPrivateKey = env.devEnvSshPrivateKey;
         const sshUser = env.devEnvSshUser;
         const sshHostDns = env.devEnvSshHostDns;
+        const wakeUrl = env.devEnvWakeUrl;
+        const wakeToken = env.devEnvWakeToken;
         if (!sshHost || !sshPrivateKey || !sshUser) {
             this.error('devEnvSshHost, devEnvSshPrivateKey, and devEnvSshUser must be set in the workspace environment');
         }
+        if (wakeUrl && wakeToken) {
+            try {
+                const wakeResult = await this.wakeAndPoll(wakeUrl, wakeToken);
+                // Override sshHost with the freshly-resolved IP from the broker
+                sshHost = wakeResult.host;
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.error(`Failed to wake dev environment: ${message}. See ${getLogPath()} for details.`);
+            }
+        }
         const host = sshHostDns || sshHost;
         const tempKeyPath = path.join(os.tmpdir(), `hereya-ssh-${randomUUID()}`);
         try {
@@ -70,4 +98,64 @@ export default class DevenvSsh extends Command {
         }
         return Promise.resolve();
     }
+    async fetchStatus(wakeUrl, wakeToken) {
+        const response = await fetch(`${wakeUrl}/status`, {
+            headers: { Authorization: `Bearer ${wakeToken}` },
+            method: 'GET',
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => '');
+            throw new Error(`broker /status returned ${response.status}: ${body}`);
+        }
+        return response.json();
+    }
+    async postWake(wakeUrl, wakeToken) {
+        const response = await fetch(`${wakeUrl}/wake`, {
+            headers: { Authorization: `Bearer ${wakeToken}` },
+            method: 'POST',
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => '');
+            throw new Error(`broker /wake returned ${response.status}: ${body}`);
+        }
+        return response.json();
+    }
+    async wakeAndPoll(wakeUrl, wakeToken) {
+        let resultHost = '';
+        const pollIntervalMs = getWakePollIntervalMs();
+        const timeoutMs = getWakeTimeoutMs();
+        const task = new Listr([
+            {
+                task: async () => {
+                    const initial = await this.fetchStatus(wakeUrl, wakeToken);
+                    if (initial.state === 'running' && initial.host) {
+                        resultHost = initial.host;
+                        return;
+                    }
+                    await this.postWake(wakeUrl, wakeToken);
+                    const start = Date.now();
+                    let done = false;
+                    while (!done) {
+                        if (Date.now() - start >= timeoutMs) {
+                            throw new Error(`timed out waiting for dev environment to start after ${timeoutMs / 1000}s`);
+                        }
+                        // eslint-disable-next-line no-await-in-loop
+                        await sleep(pollIntervalMs);
+                        // eslint-disable-next-line no-await-in-loop
+                        const status = await this.fetchStatus(wakeUrl, wakeToken);
+                        if (status.state === 'running' && status.host) {
+                            resultHost = status.host;
+                            done = true;
+                        }
+                    }
+                },
+                title: 'Waking dev environment',
+            },
+        ], { concurrent: false });
+        await task.run();
+        if (!resultHost) {
+            throw new Error('broker did not return a host after wake');
+        }
+        return { host: resultHost };
+    }
 }

package/oclif.manifest.json

@@ -170,13 +170,12 @@
         "index.js"
       ]
     },
-    "delete-state": {
+    "deploy": {
       "aliases": [],
       "args": {},
-      "description": "Delete the remote state of a project for a given workspace",
+      "description": "Deploy a hereya project using the project deployment package",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -w dev",
-        "<%= config.bin %> <%= command.id %> --workspace staging"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "chdir": {
@@ -187,9 +186,21 @@
           "multiple": false,
           "type": "option"
         },
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "local": {
+          "description": "force local execution (skip remote executor)",
+          "name": "local",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "workspace": {
           "char": "w",
-          "description": "workspace name",
+          "description": "name of the workspace to deploy the packages for",
           "name": "workspace",
           "required": true,
           "hasDynamicHelp": false,
@@ -199,7 +210,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "delete-state",
+      "id": "deploy",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -209,16 +220,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "delete-state",
+        "deploy",
         "index.js"
       ]
     },
-    "deploy": {
+    "delete-state": {
       "aliases": [],
       "args": {},
-      "description": "Deploy a hereya project using the project deployment package",
+      "description": "Delete the remote state of a project for a given workspace",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %> -w dev",
+        "<%= config.bin %> <%= command.id %> --workspace staging"
       ],
       "flags": {
         "chdir": {
@@ -229,21 +241,9 @@
           "multiple": false,
           "type": "option"
         },
-        "debug": {
-          "description": "enable debug mode",
-          "name": "debug",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "local": {
-          "description": "force local execution (skip remote executor)",
-          "name": "local",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to deploy the packages for",
+          "description": "workspace name",
           "name": "workspace",
           "required": true,
           "hasDynamicHelp": false,
@@ -253,7 +253,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "deploy",
+      "id": "delete-state",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -263,7 +263,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "deploy",
+        "delete-state",
         "index.js"
       ]
     },
@@ -1540,38 +1540,6 @@
         "index.js"
       ]
     },
-    "config:export-backend": {
-      "aliases": [],
-      "args": {
-        "file": {
-          "description": "Path to save the export file. Defaults to cloud-backend.json in current directory",
-          "name": "file",
-          "required": false
-        }
-      },
-      "description": "Export the cloud backend configuration to a file",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> ./path/to/export.json"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "config:export-backend",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "config",
-        "export-backend",
-        "index.js"
-      ]
-    },
     "app:status": {
       "aliases": [],
       "args": {
@@ -1613,6 +1581,38 @@
         "index.js"
       ]
     },
+    "config:export-backend": {
+      "aliases": [],
+      "args": {
+        "file": {
+          "description": "Path to save the export file. Defaults to cloud-backend.json in current directory",
+          "name": "file",
+          "required": false
+        }
+      },
+      "description": "Export the cloud backend configuration to a file",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> ./path/to/export.json"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "config:export-backend",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "config",
+        "export-backend",
+        "index.js"
+      ]
+    },
     "config:get-backend": {
       "aliases": [],
       "args": {},
@@ -1802,6 +1802,47 @@
         "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": {},
@@ -3320,5 +3361,5 @@
       ]
     }
   },
-  "version": "0.92.2"
+  "version": "0.93.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hereya-cli",
   "description": "Infrastructure as Package",
-  "version": "0.92.2",
+  "version": "0.93.0",
   "author": "Hereya Developers",
   "bin": {
     "hereya": "./bin/run.js"