hereya-cli 0.74.0 → 0.76.0

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g hereya-cli
 $ hereya COMMAND
 running command...
 $ hereya (--version)
-hereya-cli/0.74.0 linux-x64 node-v24.14.0
+hereya-cli/0.76.0 linux-x64 node-v24.14.0
 $ hereya --help [COMMAND]
 USAGE
   $ hereya COMMAND
@@ -72,6 +72,7 @@ USAGE
 * [`hereya undeploy`](#hereya-undeploy)
 * [`hereya uninit PROJECT`](#hereya-uninit-project)
 * [`hereya up`](#hereya-up)
+* [`hereya update [VERSION]`](#hereya-update-version)
 * [`hereya workspace create NAME`](#hereya-workspace-create-name)
 * [`hereya workspace delete NAME`](#hereya-workspace-delete-name)
 * [`hereya workspace env [NAME]`](#hereya-workspace-env-name)
@@ -117,7 +118,7 @@ EXAMPLES
   $ hereya add cloudy/docker_postgres
 ```
 
-_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/add/index.ts)_
+_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/add/index.ts)_
 
 ## `hereya bootstrap INFRASTRUCTURETYPE`
 
@@ -142,7 +143,7 @@ EXAMPLES
   $ hereya bootstrap local
 ```
 
-_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/bootstrap/index.ts)_
+_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/bootstrap/index.ts)_
 
 ## `hereya config export-backend [FILE]`
 
@@ -164,7 +165,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.74.0/src/commands/config/export-backend/index.ts)_
+_See code: [src/commands/config/export-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/config/export-backend/index.ts)_
 
 ## `hereya config get-backend`
 
@@ -181,7 +182,7 @@ EXAMPLES
   $ hereya config get-backend
 ```
 
-_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/config/get-backend/index.ts)_
+_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/config/get-backend/index.ts)_
 
 ## `hereya config import-backend FILE`
 
@@ -201,7 +202,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.74.0/src/commands/config/import-backend/index.ts)_
+_See code: [src/commands/config/import-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/config/import-backend/index.ts)_
 
 ## `hereya config use-backend TYPE`
 
@@ -223,7 +224,7 @@ EXAMPLES
   $ hereya config use-backend local
 ```
 
-_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/config/use-backend/index.ts)_
+_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/config/use-backend/index.ts)_
 
 ## `hereya delete-state`
 
@@ -249,7 +250,7 @@ EXAMPLES
   $ hereya delete-state --workspace staging
 ```
 
-_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/delete-state/index.ts)_
+_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/delete-state/index.ts)_
 
 ## `hereya deploy`
 
@@ -257,7 +258,7 @@ Deploy a hereya project using the project deployment package
 
 ```
 USAGE
-  $ hereya deploy -w <value> [--chdir <value>] [--debug]
+  $ hereya deploy -w <value> [--chdir <value>] [--debug] [--local]
 
 FLAGS
   -w, --workspace=<value>  (required) name of the workspace to deploy the packages for
@@ -266,6 +267,7 @@ FLAGS
                            Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR
                            environment variable.
       --debug              enable debug mode
+      --local              force local execution (skip remote executor)
 
 DESCRIPTION
   Deploy a hereya project using the project deployment package
@@ -274,7 +276,7 @@ EXAMPLES
   $ hereya deploy
 ```
 
-_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/deploy/index.ts)_
+_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/deploy/index.ts)_
 
 ## `hereya devenv config`
 
@@ -294,7 +296,7 @@ EXAMPLES
   $ hereya devenv config -w my-workspace
 ```
 
-_See code: [src/commands/devenv/config/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/devenv/config/index.ts)_
+_See code: [src/commands/devenv/config/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/devenv/config/index.ts)_
 
 ## `hereya devenv install`
 
@@ -319,7 +321,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.74.0/src/commands/devenv/install/index.ts)_
+_See code: [src/commands/devenv/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/devenv/install/index.ts)_
 
 ## `hereya devenv project init PROJECT`
 
@@ -351,7 +353,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.74.0/src/commands/devenv/project/init/index.ts)_
+_See code: [src/commands/devenv/project/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/devenv/project/init/index.ts)_
 
 ## `hereya devenv project uninit PROJECT`
 
@@ -377,7 +379,7 @@ 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.74.0/src/commands/devenv/project/uninit/index.ts)_
+_See code: [src/commands/devenv/project/uninit/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/devenv/project/uninit/index.ts)_
 
 ## `hereya devenv ssh`
 
@@ -397,7 +399,7 @@ EXAMPLES
   $ hereya devenv ssh -w my-workspace
 ```
 
-_See code: [src/commands/devenv/ssh/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/devenv/ssh/index.ts)_
+_See code: [src/commands/devenv/ssh/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/devenv/ssh/index.ts)_
 
 ## `hereya devenv uninstall`
 
@@ -418,7 +420,7 @@ EXAMPLES
   $ hereya devenv uninstall -w my-workspace
 ```
 
-_See code: [src/commands/devenv/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/devenv/uninstall/index.ts)_
+_See code: [src/commands/devenv/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/devenv/uninstall/index.ts)_
 
 ## `hereya doc PACKAGE`
 
@@ -451,7 +453,7 @@ EXAMPLES
   $ hereya doc my-package --no-doc
 ```
 
-_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/doc/index.ts)_
+_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/doc/index.ts)_
 
 ## `hereya docker run IMAGE`
 
@@ -482,7 +484,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.74.0/src/commands/docker/run/index.ts)_
+_See code: [src/commands/docker/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/docker/run/index.ts)_
 
 ## `hereya down`
 
@@ -509,7 +511,7 @@ EXAMPLES
   $ hereya down
 ```
 
-_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/down/index.ts)_
+_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/down/index.ts)_
 
 ## `hereya env [NAME]`
 
@@ -540,7 +542,7 @@ EXAMPLES
   $ hereya env -w dev -l
 ```
 
-_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/env/index.ts)_
+_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/env/index.ts)_
 
 ## `hereya env set [NAME]`
 
@@ -567,7 +569,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.74.0/src/commands/env/set/index.ts)_
+_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/env/set/index.ts)_
 
 ## `hereya executor start`
 
@@ -600,7 +602,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.74.0/src/commands/executor/start/index.ts)_
+_See code: [src/commands/executor/start/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/executor/start/index.ts)_
 
 ## `hereya flow add PACKAGE`
 
@@ -638,7 +640,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.74.0/src/commands/flow/add/index.ts)_
+_See code: [src/commands/flow/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/flow/add/index.ts)_
 
 ## `hereya flow docker run IMAGE`
 
@@ -668,7 +670,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.74.0/src/commands/flow/docker/run/index.ts)_
+_See code: [src/commands/flow/docker/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/flow/docker/run/index.ts)_
 
 ## `hereya flow down`
 
@@ -702,7 +704,7 @@ EXAMPLES
   $ hereya flow down --pin
 ```
 
-_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/flow/down/index.ts)_
+_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/flow/down/index.ts)_
 
 ## `hereya flow env [NAME]`
 
@@ -736,7 +738,7 @@ EXAMPLES
   $ hereya flow env -l
 ```
 
-_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/flow/env/index.ts)_
+_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/flow/env/index.ts)_
 
 ## `hereya flow provid PACKAGE`
 
@@ -765,7 +767,7 @@ EXAMPLES
   $ hereya flow provid hereya/postgres --pin
 ```
 
-_See code: [src/commands/flow/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/flow/provid/index.ts)_
+_See code: [src/commands/flow/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/flow/provid/index.ts)_
 
 ## `hereya flow remove PACKAGE`
 
@@ -795,7 +797,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.74.0/src/commands/flow/remove/index.ts)_
+_See code: [src/commands/flow/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/flow/remove/index.ts)_
 
 ## `hereya flow run CMD`
 
@@ -824,7 +826,7 @@ EXAMPLES
   $ hereya flow run --pin -- npm test
 ```
 
-_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/flow/run/index.ts)_
+_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/flow/run/index.ts)_
 
 ## `hereya flow up`
 
@@ -858,7 +860,7 @@ EXAMPLES
   $ hereya flow up --pin
 ```
 
-_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/flow/up/index.ts)_
+_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/flow/up/index.ts)_
 
 ## `hereya help [COMMAND]`
 
@@ -915,7 +917,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.74.0/src/commands/import/index.ts)_
+_See code: [src/commands/import/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/import/index.ts)_
 
 ## `hereya init PROJECT`
 
@@ -949,7 +951,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.74.0/src/commands/init/index.ts)_
+_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/init/index.ts)_
 
 ## `hereya login [URL]`
 
@@ -978,7 +980,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.74.0/src/commands/login/index.ts)_
+_See code: [src/commands/login/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/login/index.ts)_
 
 ## `hereya logout`
 
@@ -995,7 +997,7 @@ EXAMPLES
   $ hereya logout
 ```
 
-_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/logout/index.ts)_
+_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/logout/index.ts)_
 
 ## `hereya provid PACKAGE`
 
@@ -1023,7 +1025,7 @@ EXAMPLES
   $ hereya provid hereya/postgres --workspace staging
 ```
 
-_See code: [src/commands/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/provid/index.ts)_
+_See code: [src/commands/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/provid/index.ts)_
 
 ## `hereya publish`
 
@@ -1046,7 +1048,7 @@ EXAMPLES
   $ hereya publish --chdir=/path/to/package
 ```
 
-_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/publish/index.ts)_
+_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/publish/index.ts)_
 
 ## `hereya remove PACKAGE`
 
@@ -1074,7 +1076,7 @@ EXAMPLES
   $ hereya remove cloudy/docker_postgres
 ```
 
-_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/remove/index.ts)_
+_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/remove/index.ts)_
 
 ## `hereya run CMD`
 
@@ -1100,7 +1102,7 @@ EXAMPLES
   $ hereya run -w uat -- node index.js
 ```
 
-_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/run/index.ts)_
+_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/run/index.ts)_
 
 ## `hereya search QUERY`
 
@@ -1131,7 +1133,7 @@ EXAMPLES
   $ hereya search database --json
 ```
 
-_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/search/index.ts)_
+_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/search/index.ts)_
 
 ## `hereya unbootstrap INFRASTRUCTURETYPE`
 
@@ -1156,7 +1158,7 @@ EXAMPLES
   $ hereya unbootstrap local
 ```
 
-_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/unbootstrap/index.ts)_
+_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/unbootstrap/index.ts)_
 
 ## `hereya undeploy`
 
@@ -1164,7 +1166,7 @@ Undeploy a hereya project by removing all resources.
 
 ```
 USAGE
-  $ hereya undeploy -w <value> [--chdir <value>] [--debug]
+  $ hereya undeploy -w <value> [--chdir <value>] [--debug] [--local]
 
 FLAGS
   -w, --workspace=<value>  (required) name of the workspace to undeploy the packages for
@@ -1173,6 +1175,7 @@ FLAGS
                            Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR
                            environment variable.
       --debug              enable debug mode
+      --local              force local execution (skip remote executor)
 
 DESCRIPTION
   Undeploy a hereya project by removing all resources.
@@ -1181,7 +1184,7 @@ EXAMPLES
   $ hereya undeploy
 ```
 
-_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/undeploy/index.ts)_
+_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/undeploy/index.ts)_
 
 ## `hereya uninit PROJECT`
 
@@ -1209,7 +1212,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.74.0/src/commands/uninit/index.ts)_
+_See code: [src/commands/uninit/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/uninit/index.ts)_
 
 ## `hereya up`
 
@@ -1236,7 +1239,29 @@ EXAMPLES
   $ hereya up
 ```
 
-_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/up/index.ts)_
+_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/up/index.ts)_
+
+## `hereya update [VERSION]`
+
+Update hereya CLI to the latest or a specific version.
+
+```
+USAGE
+  $ hereya update [VERSION]
+
+ARGUMENTS
+  VERSION  [default: latest] version to update to
+
+DESCRIPTION
+  Update hereya CLI to the latest or a specific version.
+
+EXAMPLES
+  $ hereya update
+
+  $ hereya update 0.75.0
+```
+
+_See code: [src/commands/update/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/update/index.ts)_
 
 ## `hereya workspace create NAME`
 
@@ -1261,7 +1286,7 @@ EXAMPLES
   $ hereya workspace create dev
 ```
 
-_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/workspace/create/index.ts)_
+_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/workspace/create/index.ts)_
 
 ## `hereya workspace delete NAME`
 
@@ -1281,7 +1306,7 @@ EXAMPLES
   $ hereya workspace delete dev
 ```
 
-_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/workspace/delete/index.ts)_
+_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/workspace/delete/index.ts)_
 
 ## `hereya workspace env [NAME]`
 
@@ -1307,7 +1332,7 @@ EXAMPLES
   $ hereya workspace env myEnv -w dev
 ```
 
-_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/workspace/env/index.ts)_
+_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/workspace/env/index.ts)_
 
 ## `hereya workspace env set`
 
@@ -1331,7 +1356,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.74.0/src/commands/workspace/env/set/index.ts)_
+_See code: [src/commands/workspace/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/workspace/env/set/index.ts)_
 
 ## `hereya workspace env unset`
 
@@ -1352,7 +1377,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.74.0/src/commands/workspace/env/unset/index.ts)_
+_See code: [src/commands/workspace/env/unset/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/workspace/env/unset/index.ts)_
 
 ## `hereya workspace executor install`
 
@@ -1371,7 +1396,7 @@ DESCRIPTION
   Install a remote executor into a workspace
 ```
 
-_See code: [src/commands/workspace/executor/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/workspace/executor/install/index.ts)_
+_See code: [src/commands/workspace/executor/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/workspace/executor/install/index.ts)_
 
 ## `hereya workspace executor token`
 
@@ -1388,7 +1413,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.74.0/src/commands/workspace/executor/token/index.ts)_
+_See code: [src/commands/workspace/executor/token/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/workspace/executor/token/index.ts)_
 
 ## `hereya workspace executor uninstall`
 
@@ -1406,7 +1431,7 @@ DESCRIPTION
   Uninstall the remote executor from a workspace
 ```
 
-_See code: [src/commands/workspace/executor/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/workspace/executor/uninstall/index.ts)_
+_See code: [src/commands/workspace/executor/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/workspace/executor/uninstall/index.ts)_
 
 ## `hereya workspace install PACKAGE`
 
@@ -1433,7 +1458,7 @@ EXAMPLES
   $ hereya workspace install hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/workspace/install/index.ts)_
+_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/workspace/install/index.ts)_
 
 ## `hereya workspace list`
 
@@ -1457,7 +1482,7 @@ EXAMPLES
   $ hereya workspace list --org personal
 ```
 
-_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/workspace/list/index.ts)_
+_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/workspace/list/index.ts)_
 
 ## `hereya workspace set-profile PROFILE`
 
@@ -1481,7 +1506,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.74.0/src/commands/workspace/set-profile/index.ts)_
+_See code: [src/commands/workspace/set-profile/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/workspace/set-profile/index.ts)_
 
 ## `hereya workspace uninstall PACKAGE`
 
@@ -1508,5 +1533,5 @@ EXAMPLES
   $ hereya workspace uninstall hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.74.0/src/commands/workspace/uninstall/index.ts)_
+_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.76.0/src/commands/workspace/uninstall/index.ts)_
 <!-- commandsstop -->

package/dist/backend/cloud/cloud-backend.d.ts

@@ -84,7 +84,7 @@ export declare class CloudBackend implements Backend {
     setEnvVar(input: SetEnvVarInput): Promise<SetEnvVarOutput>;
     submitExecutorJob(input: {
         payload: object;
-        type: 'destroy' | 'provision' | 'resolve-env';
+        type: 'deploy' | 'destroy' | 'provision' | 'resolve-env' | 'undeploy';
         workspace: string;
     }): Promise<{
         jobId: string;

package/dist/commands/deploy/index.d.ts

@@ -5,7 +5,9 @@ export default class Deploy extends Command {
     static flags: {
         chdir: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         workspace: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
+    private deployRemotely;
 }

package/dist/commands/deploy/index.js

@@ -1,14 +1,19 @@
 import { Command, Flags } from '@oclif/core';
 import { getRendererClass, Listr, ListrLogger, ListrLogLevels } from 'listr2';
 import path from 'node:path';
+import { CloudBackend } from '../../backend/cloud/cloud-backend.js';
+import { getCloudCredentials, loadBackendConfig } from '../../backend/config.js';
 import { getBackend } from '../../backend/index.js';
 import { getExecutor } from '../../executor/index.js';
 import { getConfigManager } from '../../lib/config/index.js';
 import { getEnvManager } from '../../lib/env/index.js';
+import { gitUtils } from '../../lib/git-utils.js';
 import { getLogger, getLogPath, isDebug, setDebug } from '../../lib/log.js';
 import { getParameterManager } from '../../lib/parameter/index.js';
 import { getProfileFromWorkspace } from '../../lib/profile-utils.js';
-import { delay } from '../../lib/shell.js';
+import { pollExecutorJob } from '../../lib/remote-job-utils.js';
+import { delay, runShell } from '../../lib/shell.js';
+import { resolveWorkspaceName } from '../../lib/workspace-utils.js';
 import { validateDeploymentWorkspace } from '../../lib/workspace-validation.js';
 export default class Deploy extends Command {
     static description = 'Deploy a hereya project using the project deployment package';
@@ -26,6 +31,10 @@ export default class Deploy extends Command {
             default: false,
             description: 'enable debug mode',
         }),
+        local: Flags.boolean({
+            default: false,
+            description: 'force local execution (skip remote executor)',
+        }),
         workspace: Flags.string({
             char: 'w',
             description: 'name of the workspace to deploy the packages for',
@@ -48,6 +57,24 @@ export default class Deploy extends Command {
         if (!validation.isValid) {
             this.error(validation.message);
         }
+        const forceLocal = flags.local || process.env.HEREYA_LOCAL_EXECUTION === 'true';
+        if (!forceLocal) {
+            // Check remote deployment conditions
+            const resolvedWorkspaceName = resolveWorkspaceName(flags.workspace, loadConfigOutput.config.project);
+            const workspace$ = await backend.getWorkspace(resolvedWorkspaceName);
+            const metadata$ = await backend.getProjectMetadata?.({ project: loadConfigOutput.config.project });
+            const hasRemoteGit = metadata$?.found && metadata$.metadata.env?.hereyaGitRemoteUrl;
+            const hasRemoteExecutor = workspace$.found && !workspace$.hasError && workspace$.workspace.hasExecutor;
+            if (hasRemoteExecutor && hasRemoteGit) {
+                await this.deployRemotely({
+                    gitBranch: await gitUtils.getCurrentGitBranch(projectRootDir),
+                    project: loadConfigOutput.config.project,
+                    projectRootDir,
+                    workspace: flags.workspace,
+                });
+                return;
+            }
+        }
         const myLogger = new ListrLogger({ useIcons: false });
         const task = new Listr([
             {
@@ -73,6 +100,14 @@ export default class Deploy extends Command {
                 },
                 title: 'Loading project config',
             },
+            {
+                skip: (ctx) => !ctx.configOutput.config.preDeployCommand,
+                async task(ctx) {
+                    const command = ctx.configOutput.config.preDeployCommand;
+                    await runShell('sh', ['-c', command], { directory: projectRootDir });
+                },
+                title: 'Running pre-deploy command',
+            },
             {
                 async task(ctx) {
                     const backend = await getBackend();
@@ -415,4 +450,58 @@ export default class Deploy extends Command {
 See ${getLogPath()} for more details`);
         }
     }
+    async deployRemotely(input) {
+        const myLogger = new ListrLogger({ useIcons: false });
+        // 1. Ensure clean working tree
+        const cleanCheck = await gitUtils.ensureCleanAndPushed({ cwd: input.projectRootDir });
+        if (!cleanCheck.clean) {
+            this.error(cleanCheck.reason);
+        }
+        myLogger.log(ListrLogLevels.STARTED, `Deploying to ${input.workspace} via remote executor (branch: ${input.gitBranch})`);
+        // 2. Get cloud backend for job submission
+        const backendConfig = await loadBackendConfig();
+        if (!backendConfig.cloud) {
+            this.error('Remote deployment requires cloud backend. Run `hereya login` first.');
+        }
+        const credentials = await getCloudCredentials(backendConfig.cloud.clientId);
+        if (!credentials) {
+            this.error('Cloud credentials not found. Run `hereya login` first.');
+        }
+        const resolvedWorkspaceName = resolveWorkspaceName(input.workspace, input.project);
+        const cloudBackend = new CloudBackend({
+            accessToken: credentials.accessToken,
+            clientId: backendConfig.cloud.clientId,
+            refreshToken: credentials.refreshToken,
+            url: backendConfig.cloud.url,
+        });
+        // 3. Submit deploy job
+        const submitResult = await cloudBackend.submitExecutorJob({
+            payload: {
+                gitBranch: input.gitBranch,
+                project: input.project,
+                workspace: input.workspace,
+            },
+            type: 'deploy',
+            workspace: resolvedWorkspaceName,
+        });
+        if (!submitResult.success) {
+            this.error(`Failed to submit remote deploy job: ${submitResult.reason}`);
+        }
+        // 4. Poll for results
+        const logger = {
+            debug: (msg) => myLogger.log(ListrLogLevels.OUTPUT, msg),
+            error: (msg) => myLogger.log(ListrLogLevels.OUTPUT, msg),
+            info: (msg) => myLogger.log(ListrLogLevels.OUTPUT, msg),
+        };
+        const pollResult = await pollExecutorJob({
+            cloudBackend,
+            jobId: submitResult.jobId,
+            logger,
+            workspace: resolvedWorkspaceName,
+        });
+        if (!pollResult.success) {
+            this.error(pollResult.reason);
+        }
+        myLogger.log(ListrLogLevels.COMPLETED, 'Remote deployment completed successfully');
+    }
 }

package/dist/commands/undeploy/index.d.ts

@@ -5,7 +5,9 @@ export default class Undeploy extends Command {
     static flags: {
         chdir: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         workspace: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
+    private undeployRemotely;
 }

package/dist/commands/undeploy/index.js

@@ -1,14 +1,19 @@
 import { Command, Flags } from '@oclif/core';
 import { getRendererClass, Listr, ListrLogger, ListrLogLevels } from 'listr2';
 import path from 'node:path';
+import { CloudBackend } from '../../backend/cloud/cloud-backend.js';
+import { getCloudCredentials, loadBackendConfig } from '../../backend/config.js';
 import { getBackend } from '../../backend/index.js';
 import { getExecutor } from '../../executor/index.js';
 import { getConfigManager } from '../../lib/config/index.js';
 import { getEnvManager } from '../../lib/env/index.js';
+import { gitUtils } from '../../lib/git-utils.js';
 import { getLogger, getLogPath, isDebug, setDebug } from '../../lib/log.js';
 import { getParameterManager } from '../../lib/parameter/index.js';
 import { getProfileFromWorkspace } from '../../lib/profile-utils.js';
+import { pollExecutorJob } from '../../lib/remote-job-utils.js';
 import { delay } from '../../lib/shell.js';
+import { resolveWorkspaceName } from '../../lib/workspace-utils.js';
 import { validateDeploymentWorkspace } from '../../lib/workspace-validation.js';
 export default class Undeploy extends Command {
     static description = 'Undeploy a hereya project by removing all resources.';
@@ -26,6 +31,10 @@ export default class Undeploy extends Command {
             default: false,
             description: 'enable debug mode',
         }),
+        local: Flags.boolean({
+            default: false,
+            description: 'force local execution (skip remote executor)',
+        }),
         workspace: Flags.string({
             char: 'w',
             description: 'name of the workspace to undeploy the packages for',
@@ -48,6 +57,24 @@ export default class Undeploy extends Command {
         if (!validation.isValid) {
             this.error(validation.message);
         }
+        const forceLocal = flags.local || process.env.HEREYA_LOCAL_EXECUTION === 'true';
+        if (!forceLocal) {
+            // Check remote undeployment conditions
+            const resolvedWorkspaceName = resolveWorkspaceName(flags.workspace, loadConfigOutput.config.project);
+            const workspace$ = await backend.getWorkspace(resolvedWorkspaceName);
+            const metadata$ = await backend.getProjectMetadata?.({ project: loadConfigOutput.config.project });
+            const hasRemoteGit = metadata$?.found && metadata$.metadata.env?.hereyaGitRemoteUrl;
+            const hasRemoteExecutor = workspace$.found && !workspace$.hasError && workspace$.workspace.hasExecutor;
+            if (hasRemoteExecutor && hasRemoteGit) {
+                await this.undeployRemotely({
+                    gitBranch: await gitUtils.getCurrentGitBranch(projectRootDir),
+                    project: loadConfigOutput.config.project,
+                    projectRootDir,
+                    workspace: flags.workspace,
+                });
+                return;
+            }
+        }
         const myLogger = new ListrLogger({ useIcons: false });
         const task = new Listr([
             {
@@ -277,4 +304,58 @@ export default class Undeploy extends Command {
 See ${getLogPath()} for more details`);
         }
     }
+    async undeployRemotely(input) {
+        const myLogger = new ListrLogger({ useIcons: false });
+        // 1. Ensure clean working tree
+        const cleanCheck = await gitUtils.ensureCleanAndPushed({ cwd: input.projectRootDir });
+        if (!cleanCheck.clean) {
+            this.error(cleanCheck.reason);
+        }
+        myLogger.log(ListrLogLevels.STARTED, `Undeploying ${input.workspace} via remote executor (branch: ${input.gitBranch})`);
+        // 2. Get cloud backend for job submission
+        const backendConfig = await loadBackendConfig();
+        if (!backendConfig.cloud) {
+            this.error('Remote undeployment requires cloud backend. Run `hereya login` first.');
+        }
+        const credentials = await getCloudCredentials(backendConfig.cloud.clientId);
+        if (!credentials) {
+            this.error('Cloud credentials not found. Run `hereya login` first.');
+        }
+        const resolvedWorkspaceName = resolveWorkspaceName(input.workspace, input.project);
+        const cloudBackend = new CloudBackend({
+            accessToken: credentials.accessToken,
+            clientId: backendConfig.cloud.clientId,
+            refreshToken: credentials.refreshToken,
+            url: backendConfig.cloud.url,
+        });
+        // 3. Submit undeploy job
+        const submitResult = await cloudBackend.submitExecutorJob({
+            payload: {
+                gitBranch: input.gitBranch,
+                project: input.project,
+                workspace: input.workspace,
+            },
+            type: 'undeploy',
+            workspace: resolvedWorkspaceName,
+        });
+        if (!submitResult.success) {
+            this.error(`Failed to submit remote undeploy job: ${submitResult.reason}`);
+        }
+        // 4. Poll for results
+        const logger = {
+            debug: (msg) => myLogger.log(ListrLogLevels.OUTPUT, msg),
+            error: (msg) => myLogger.log(ListrLogLevels.OUTPUT, msg),
+            info: (msg) => myLogger.log(ListrLogLevels.OUTPUT, msg),
+        };
+        const pollResult = await pollExecutorJob({
+            cloudBackend,
+            jobId: submitResult.jobId,
+            logger,
+            workspace: resolvedWorkspaceName,
+        });
+        if (!pollResult.success) {
+            this.error(pollResult.reason);
+        }
+        myLogger.log(ListrLogLevels.COMPLETED, 'Remote undeployment completed successfully');
+    }
 }

package/dist/commands/update/index.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@oclif/core';
+export default class Update extends Command {
+    static args: {
+        version: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/update/index.js

@@ -0,0 +1,38 @@
+import { Args, Command } from '@oclif/core';
+import { shellUtils } from '../../lib/shell.js';
+export default class Update extends Command {
+    static args = {
+        version: Args.string({
+            default: 'latest',
+            description: 'version to update to',
+            required: false,
+        }),
+    };
+    static description = 'Update hereya CLI to the latest or a specific version.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> 0.75.0',
+    ];
+    async run() {
+        const { args } = await this.parse(Update);
+        const target = args.version;
+        const currentVersion = this.config.version;
+        this.log(`Current version: ${currentVersion}`);
+        this.log(`Updating to ${target}...`);
+        try {
+            await shellUtils.runShell('npm', ['install', '-g', `hereya-cli@${target}`]);
+            // Get the new version after install
+            const { stdout } = await shellUtils.runShell('hereya', ['--version']);
+            const newVersion = stdout.trim();
+            if (newVersion === currentVersion && target === 'latest') {
+                this.log(`Already at the latest version (${currentVersion}).`);
+            }
+            else {
+                this.log(`Updated to ${newVersion}.`);
+            }
+        }
+        catch (error) {
+            this.error(`Failed to update: ${error.message}`);
+        }
+    }
+}

package/dist/executor/remote.js

@@ -1,3 +1,4 @@
+import { pollExecutorJob } from '../lib/remote-job-utils.js';
 import { LocalExecutor } from './local.js';
 export class RemoteExecutor {
     cloudBackend;
@@ -70,51 +71,16 @@ export class RemoteExecutor {
             return { reason: `Failed to submit remote executor job: ${submitResult.reason}`, success: false };
         }
         const { jobId } = submitResult;
-        input.logger?.info?.(`Remote executor job submitted (${jobId}). Waiting for result...`);
-        // Poll for result
-        const timeout = 10 * 60 * 1000; // 10 minutes
-        const startTime = Date.now();
-        let lastLogLength = 0;
-        let lastStatus = 'pending';
-        while (Date.now() - startTime < timeout) {
-            // eslint-disable-next-line no-await-in-loop
-            const statusResult = await this.cloudBackend.getExecutorJobStatus({
-                jobId,
-                lastStatus,
-                poll: true,
-                workspace: this.workspace,
-            });
-            if (!statusResult.success) {
-                return { reason: `Failed to get job status: ${statusResult.reason}`, success: false };
-            }
-            const { job } = statusResult;
-            lastStatus = job.status;
-            // Forward new logs
-            if (job.logs && job.logs.length > lastLogLength) {
-                const newLogs = job.logs.slice(lastLogLength);
-                if (newLogs.trim()) {
-                    input.logger?.info?.(newLogs);
-                }
-                lastLogLength = job.logs.length;
-            }
-            // Check if job is done
-            if (job.status === 'completed') {
-                if (job.result) {
-                    return job.result;
-                }
-                return { reason: 'Job completed but no result returned', success: false };
-            }
-            if (job.status === 'failed') {
-                const reason = job.result?.reason || 'Remote executor job failed';
-                return { reason, success: false };
-            }
-            // Small delay between polls (server-side long polling handles most of the wait)
-            // eslint-disable-next-line no-await-in-loop
-            await new Promise(resolve => {
-                setTimeout(resolve, 1000);
-            });
+        const pollResult = await pollExecutorJob({
+            cloudBackend: this.cloudBackend,
+            jobId,
+            logger: input.logger,
+            workspace: this.workspace,
+        });
+        if (!pollResult.success) {
+            return { reason: pollResult.reason, success: false };
         }
-        return { reason: 'Remote executor job timed out after 10 minutes', success: false };
+        return pollResult.result;
     }
     async resolveEnvRemotely(env, markSecret) {
         const submitResult = await this.cloudBackend.submitExecutorJob({

package/dist/lib/config/common.d.ts

@@ -35,6 +35,7 @@ export interface Config {
             version: string;
         };
     };
+    preDeployCommand?: string;
     project: string;
     workspace: string;
 }

package/dist/lib/git-utils.d.ts

@@ -3,6 +3,18 @@ export declare const gitUtils: {
      * Clones a git repository using the hereya credential helper.
      */
     cloneWithCredentialHelper(input: CloneWithCredentialHelperInput): Promise<CloneOutput>;
+    /**
+     * Checks that the working tree is clean and all commits are pushed.
+     * Returns { clean: true } if ready, or { clean: false, reason } with an explanation.
+     */
+    ensureCleanAndPushed(input: {
+        cwd?: string;
+    }): Promise<{
+        clean: false;
+        reason: string;
+    } | {
+        clean: true;
+    }>;
     /**
      * Gets the current git branch name.
      * @param cwd The working directory to execute git command in

package/dist/lib/git-utils.js

@@ -7,6 +7,33 @@ export const gitUtils = {
     async cloneWithCredentialHelper(input) {
         return cloneWithCredentialHelper(input);
     },
+    /**
+     * Checks that the working tree is clean and all commits are pushed.
+     * Returns { clean: true } if ready, or { clean: false, reason } with an explanation.
+     */
+    async ensureCleanAndPushed(input) {
+        // Check for uncommitted/unstaged changes
+        try {
+            const { stdout: status } = await runShell('git', ['status', '--porcelain'], { directory: input.cwd });
+            if (status.trim()) {
+                return { clean: false, reason: 'Uncommitted changes detected. Commit and push before deploying.' };
+            }
+        }
+        catch (error) {
+            return { clean: false, reason: `Failed to check git status: ${error.message}` };
+        }
+        // Check for unpushed commits
+        try {
+            const { stdout: unpushed } = await runShell('git', ['log', '@{u}..', '--oneline'], { directory: input.cwd });
+            if (unpushed.trim()) {
+                return { clean: false, reason: 'Unpushed commits detected. Push before deploying.' };
+            }
+        }
+        catch {
+            // If no upstream is set, we can't check — that's fine for local-only repos
+        }
+        return { clean: true };
+    },
     /**
      * Gets the current git branch name.
      * @param cwd The working directory to execute git command in

package/dist/lib/remote-job-utils.d.ts

@@ -0,0 +1,16 @@
+import { CloudBackend } from '../backend/cloud/cloud-backend.js';
+import { Logger } from './log.js';
+export type PollJobResult = {
+    reason: string;
+    success: false;
+} | {
+    result: any;
+    success: true;
+};
+export declare function pollExecutorJob(input: {
+    cloudBackend: CloudBackend;
+    jobId: string;
+    logger?: Logger;
+    timeoutMs?: number;
+    workspace: string;
+}): Promise<PollJobResult>;

package/dist/lib/remote-job-utils.js

@@ -0,0 +1,45 @@
+export async function pollExecutorJob(input) {
+    const { cloudBackend, jobId, logger, workspace } = input;
+    const timeout = input.timeoutMs ?? 10 * 60 * 1000;
+    logger?.info?.(`Remote executor job submitted (${jobId}). Waiting for result...`);
+    const startTime = Date.now();
+    let lastLogLength = 0;
+    let lastStatus = 'pending';
+    while (Date.now() - startTime < timeout) {
+        // eslint-disable-next-line no-await-in-loop
+        const statusResult = await cloudBackend.getExecutorJobStatus({
+            jobId,
+            lastStatus,
+            poll: true,
+            workspace,
+        });
+        if (!statusResult.success) {
+            return { reason: `Failed to get job status: ${statusResult.reason}`, success: false };
+        }
+        const { job } = statusResult;
+        lastStatus = job.status;
+        if (job.logs && job.logs.length > lastLogLength) {
+            const newLogs = job.logs.slice(lastLogLength);
+            if (newLogs.trim()) {
+                logger?.info?.(newLogs);
+            }
+            lastLogLength = job.logs.length;
+        }
+        if (job.status === 'completed') {
+            if (job.result) {
+                return { result: job.result, success: true };
+            }
+            return { reason: 'Job completed but no result returned', success: false };
+        }
+        if (job.status === 'failed') {
+            const reason = job.result?.reason || 'Remote executor job failed';
+            return { reason, success: false };
+        }
+        // Small delay between polls (server-side long polling handles most of the wait)
+        // eslint-disable-next-line no-await-in-loop
+        await new Promise(resolve => {
+            setTimeout(resolve, 1000);
+        });
+    }
+    return { reason: `Remote executor job timed out after ${Math.round(timeout / 60_000)} minutes`, success: false };
+}

package/dist/lib/shell.d.ts

@@ -13,4 +13,7 @@ export declare function runShell(cmd: string, args: string[], options?: RunShell
     stderr: string;
     stdout: string;
 }>;
+export declare const shellUtils: {
+    runShell: typeof runShell;
+};
 export declare function delay(ms: number): Promise<unknown> | undefined;

package/dist/lib/shell.js

@@ -57,6 +57,10 @@ export async function runShell(cmd, args, options = {}) {
         });
     });
 }
+// Stubbable wrapper around runShell for use in tests.
+export const shellUtils = {
+    runShell,
+};
 export function delay(ms) {
     if (process.env.NODE_ENV === 'test') {
         return;

package/oclif.manifest.json

@@ -102,34 +102,6 @@
         "index.js"
       ]
     },
-    "credential-helper": {
-      "aliases": [],
-      "args": {
-        "operation": {
-          "description": "Git credential operation (get, store, erase)",
-          "name": "operation",
-          "required": true
-        }
-      },
-      "description": "Git credential helper for hereya-managed repositories",
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hidden": true,
-      "hiddenAliases": [],
-      "id": "credential-helper",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "credential-helper",
-        "index.js"
-      ]
-    },
     "delete-state": {
       "aliases": [],
       "args": {},
@@ -173,6 +145,34 @@
         "index.js"
       ]
     },
+    "credential-helper": {
+      "aliases": [],
+      "args": {
+        "operation": {
+          "description": "Git credential operation (get, store, erase)",
+          "name": "operation",
+          "required": true
+        }
+      },
+      "description": "Git credential helper for hereya-managed repositories",
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "credential-helper",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "credential-helper",
+        "index.js"
+      ]
+    },
     "deploy": {
       "aliases": [],
       "args": {},
@@ -195,6 +195,12 @@
           "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",
@@ -929,6 +935,12 @@
           "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 undeploy the packages for",
@@ -1077,6 +1089,38 @@
         "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"
+      ]
+    },
     "config:export-backend": {
       "aliases": [],
       "args": {
@@ -2773,5 +2817,5 @@
       ]
     }
   },
-  "version": "0.74.0"
+  "version": "0.76.0"
 }

package/package.json

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