hereya-cli 0.73.4 → 0.75.0

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g hereya-cli
 $ hereya COMMAND
 running command...
 $ hereya (--version)
-hereya-cli/0.73.4 linux-x64 node-v24.14.0
+hereya-cli/0.75.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.73.4/src/commands/add/index.ts)_
+_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.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.73.4/src/commands/bootstrap/index.ts)_
+_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.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.73.4/src/commands/config/export-backend/index.ts)_
+_See code: [src/commands/config/export-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.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.73.4/src/commands/config/get-backend/index.ts)_
+_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.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.73.4/src/commands/config/import-backend/index.ts)_
+_See code: [src/commands/config/import-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.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.73.4/src/commands/config/use-backend/index.ts)_
+_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.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.73.4/src/commands/delete-state/index.ts)_
+_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/delete-state/index.ts)_
 
 ## `hereya deploy`
 
@@ -274,7 +275,7 @@ EXAMPLES
   $ hereya deploy
 ```
 
-_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/deploy/index.ts)_
+_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/deploy/index.ts)_
 
 ## `hereya devenv config`
 
@@ -294,7 +295,7 @@ EXAMPLES
   $ hereya devenv config -w my-workspace
 ```
 
-_See code: [src/commands/devenv/config/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/devenv/config/index.ts)_
+_See code: [src/commands/devenv/config/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/devenv/config/index.ts)_
 
 ## `hereya devenv install`
 
@@ -319,7 +320,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.73.4/src/commands/devenv/install/index.ts)_
+_See code: [src/commands/devenv/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/devenv/install/index.ts)_
 
 ## `hereya devenv project init PROJECT`
 
@@ -327,17 +328,18 @@ Initialize a project on a remote dev environment.
 
 ```
 USAGE
-  $ hereya devenv project init PROJECT -w <value> [-f] [-p <value>...] [-t <value>]
+  $ hereya devenv project init PROJECT -w <value> [-d <value>] [-f] [-p <value>...] [-t <value>]
 
 ARGUMENTS
   PROJECT  project name
 
 FLAGS
-  -f, --force                 continue even if folder already exists
-  -p, --parameter=<value>...  [default: ] parameter for the template, in the form of 'key=value'. Can be specified
-                              multiple times.
-  -t, --template=<value>      template package to scaffold the project from
-  -w, --workspace=<value>     (required) name of the workspace
+  -d, --deploy-workspace=<value>  workspace used for deployment (required when using a template)
+  -f, --force                     continue even if folder already exists
+  -p, --parameter=<value>...      [default: ] parameter for the template, in the form of 'key=value'. Can be specified
+                                  multiple times.
+  -t, --template=<value>          template package to scaffold the project from
+  -w, --workspace=<value>         (required) name of the workspace
 
 DESCRIPTION
   Initialize a project on a remote dev environment.
@@ -350,7 +352,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.73.4/src/commands/devenv/project/init/index.ts)_
+_See code: [src/commands/devenv/project/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/devenv/project/init/index.ts)_
 
 ## `hereya devenv project uninit PROJECT`
 
@@ -376,7 +378,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.73.4/src/commands/devenv/project/uninit/index.ts)_
+_See code: [src/commands/devenv/project/uninit/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/devenv/project/uninit/index.ts)_
 
 ## `hereya devenv ssh`
 
@@ -396,7 +398,7 @@ EXAMPLES
   $ hereya devenv ssh -w my-workspace
 ```
 
-_See code: [src/commands/devenv/ssh/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/devenv/ssh/index.ts)_
+_See code: [src/commands/devenv/ssh/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/devenv/ssh/index.ts)_
 
 ## `hereya devenv uninstall`
 
@@ -417,7 +419,7 @@ EXAMPLES
   $ hereya devenv uninstall -w my-workspace
 ```
 
-_See code: [src/commands/devenv/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/devenv/uninstall/index.ts)_
+_See code: [src/commands/devenv/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/devenv/uninstall/index.ts)_
 
 ## `hereya doc PACKAGE`
 
@@ -450,7 +452,7 @@ EXAMPLES
   $ hereya doc my-package --no-doc
 ```
 
-_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/doc/index.ts)_
+_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/doc/index.ts)_
 
 ## `hereya docker run IMAGE`
 
@@ -481,7 +483,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.73.4/src/commands/docker/run/index.ts)_
+_See code: [src/commands/docker/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/docker/run/index.ts)_
 
 ## `hereya down`
 
@@ -508,7 +510,7 @@ EXAMPLES
   $ hereya down
 ```
 
-_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/down/index.ts)_
+_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/down/index.ts)_
 
 ## `hereya env [NAME]`
 
@@ -539,7 +541,7 @@ EXAMPLES
   $ hereya env -w dev -l
 ```
 
-_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/env/index.ts)_
+_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/env/index.ts)_
 
 ## `hereya env set [NAME]`
 
@@ -566,7 +568,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.73.4/src/commands/env/set/index.ts)_
+_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/env/set/index.ts)_
 
 ## `hereya executor start`
 
@@ -599,7 +601,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.73.4/src/commands/executor/start/index.ts)_
+_See code: [src/commands/executor/start/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/executor/start/index.ts)_
 
 ## `hereya flow add PACKAGE`
 
@@ -637,7 +639,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.73.4/src/commands/flow/add/index.ts)_
+_See code: [src/commands/flow/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/flow/add/index.ts)_
 
 ## `hereya flow docker run IMAGE`
 
@@ -667,7 +669,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.73.4/src/commands/flow/docker/run/index.ts)_
+_See code: [src/commands/flow/docker/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/flow/docker/run/index.ts)_
 
 ## `hereya flow down`
 
@@ -701,7 +703,7 @@ EXAMPLES
   $ hereya flow down --pin
 ```
 
-_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/flow/down/index.ts)_
+_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/flow/down/index.ts)_
 
 ## `hereya flow env [NAME]`
 
@@ -735,7 +737,7 @@ EXAMPLES
   $ hereya flow env -l
 ```
 
-_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/flow/env/index.ts)_
+_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/flow/env/index.ts)_
 
 ## `hereya flow provid PACKAGE`
 
@@ -764,7 +766,7 @@ EXAMPLES
   $ hereya flow provid hereya/postgres --pin
 ```
 
-_See code: [src/commands/flow/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/flow/provid/index.ts)_
+_See code: [src/commands/flow/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/flow/provid/index.ts)_
 
 ## `hereya flow remove PACKAGE`
 
@@ -794,7 +796,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.73.4/src/commands/flow/remove/index.ts)_
+_See code: [src/commands/flow/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/flow/remove/index.ts)_
 
 ## `hereya flow run CMD`
 
@@ -823,7 +825,7 @@ EXAMPLES
   $ hereya flow run --pin -- npm test
 ```
 
-_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/flow/run/index.ts)_
+_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/flow/run/index.ts)_
 
 ## `hereya flow up`
 
@@ -857,7 +859,7 @@ EXAMPLES
   $ hereya flow up --pin
 ```
 
-_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/flow/up/index.ts)_
+_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/flow/up/index.ts)_
 
 ## `hereya help [COMMAND]`
 
@@ -914,7 +916,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.73.4/src/commands/import/index.ts)_
+_See code: [src/commands/import/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/import/index.ts)_
 
 ## `hereya init PROJECT`
 
@@ -922,17 +924,18 @@ Initialize hereya in a project directory.
 
 ```
 USAGE
-  $ hereya init PROJECT -w <value> [--chdir <value>] [-p <value>...] [-t <value>]
+  $ hereya init PROJECT -w <value> [--chdir <value>] [-d <value>] [-p <value>...] [-t <value>]
 
 ARGUMENTS
   PROJECT  project name
 
 FLAGS
-  -p, --parameter=<value>...  [default: ] template parameter, in the form of 'key=value'. Can be specified multiple
-                              times.
-  -t, --template=<value>      template package name (e.g. owner/repo)
-  -w, --workspace=<value>     (required) workspace to set as default
-      --chdir=<value>         directory to run command in
+  -d, --deploy-workspace=<value>  workspace used for deployment (required when using a template)
+  -p, --parameter=<value>...      [default: ] template parameter, in the form of 'key=value'. Can be specified multiple
+                                  times.
+  -t, --template=<value>          template package name (e.g. owner/repo)
+  -w, --workspace=<value>         (required) workspace to set as default
+      --chdir=<value>             directory to run command in
 
 DESCRIPTION
   Initialize hereya in a project directory.
@@ -942,12 +945,12 @@ EXAMPLES
 
   $ hereya init myProject -w=defaultWorkspace --chdir=./myProject
 
-  $ hereya init myProject -w=dev -t=acme/node-starter
+  $ hereya init myProject -w=dev -t=acme/node-starter -d=prod
 
-  $ hereya init myProject -w=dev -t=acme/node-starter -p region=us-east-1
+  $ 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.73.4/src/commands/init/index.ts)_
+_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/init/index.ts)_
 
 ## `hereya login [URL]`
 
@@ -976,7 +979,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.73.4/src/commands/login/index.ts)_
+_See code: [src/commands/login/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/login/index.ts)_
 
 ## `hereya logout`
 
@@ -993,7 +996,7 @@ EXAMPLES
   $ hereya logout
 ```
 
-_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/logout/index.ts)_
+_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/logout/index.ts)_
 
 ## `hereya provid PACKAGE`
 
@@ -1021,7 +1024,7 @@ EXAMPLES
   $ hereya provid hereya/postgres --workspace staging
 ```
 
-_See code: [src/commands/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/provid/index.ts)_
+_See code: [src/commands/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/provid/index.ts)_
 
 ## `hereya publish`
 
@@ -1044,7 +1047,7 @@ EXAMPLES
   $ hereya publish --chdir=/path/to/package
 ```
 
-_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/publish/index.ts)_
+_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/publish/index.ts)_
 
 ## `hereya remove PACKAGE`
 
@@ -1072,7 +1075,7 @@ EXAMPLES
   $ hereya remove cloudy/docker_postgres
 ```
 
-_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/remove/index.ts)_
+_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/remove/index.ts)_
 
 ## `hereya run CMD`
 
@@ -1098,7 +1101,7 @@ EXAMPLES
   $ hereya run -w uat -- node index.js
 ```
 
-_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/run/index.ts)_
+_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/run/index.ts)_
 
 ## `hereya search QUERY`
 
@@ -1129,7 +1132,7 @@ EXAMPLES
   $ hereya search database --json
 ```
 
-_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/search/index.ts)_
+_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/search/index.ts)_
 
 ## `hereya unbootstrap INFRASTRUCTURETYPE`
 
@@ -1154,7 +1157,7 @@ EXAMPLES
   $ hereya unbootstrap local
 ```
 
-_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/unbootstrap/index.ts)_
+_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/unbootstrap/index.ts)_
 
 ## `hereya undeploy`
 
@@ -1179,7 +1182,7 @@ EXAMPLES
   $ hereya undeploy
 ```
 
-_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/undeploy/index.ts)_
+_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/undeploy/index.ts)_
 
 ## `hereya uninit PROJECT`
 
@@ -1207,7 +1210,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.73.4/src/commands/uninit/index.ts)_
+_See code: [src/commands/uninit/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/uninit/index.ts)_
 
 ## `hereya up`
 
@@ -1234,7 +1237,29 @@ EXAMPLES
   $ hereya up
 ```
 
-_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/up/index.ts)_
+_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.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.75.0/src/commands/update/index.ts)_
 
 ## `hereya workspace create NAME`
 
@@ -1259,7 +1284,7 @@ EXAMPLES
   $ hereya workspace create dev
 ```
 
-_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/workspace/create/index.ts)_
+_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/workspace/create/index.ts)_
 
 ## `hereya workspace delete NAME`
 
@@ -1279,7 +1304,7 @@ EXAMPLES
   $ hereya workspace delete dev
 ```
 
-_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/workspace/delete/index.ts)_
+_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/workspace/delete/index.ts)_
 
 ## `hereya workspace env [NAME]`
 
@@ -1305,7 +1330,7 @@ EXAMPLES
   $ hereya workspace env myEnv -w dev
 ```
 
-_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/workspace/env/index.ts)_
+_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/workspace/env/index.ts)_
 
 ## `hereya workspace env set`
 
@@ -1329,7 +1354,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.73.4/src/commands/workspace/env/set/index.ts)_
+_See code: [src/commands/workspace/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/workspace/env/set/index.ts)_
 
 ## `hereya workspace env unset`
 
@@ -1350,7 +1375,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.73.4/src/commands/workspace/env/unset/index.ts)_
+_See code: [src/commands/workspace/env/unset/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/workspace/env/unset/index.ts)_
 
 ## `hereya workspace executor install`
 
@@ -1369,7 +1394,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.73.4/src/commands/workspace/executor/install/index.ts)_
+_See code: [src/commands/workspace/executor/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/workspace/executor/install/index.ts)_
 
 ## `hereya workspace executor token`
 
@@ -1386,7 +1411,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.73.4/src/commands/workspace/executor/token/index.ts)_
+_See code: [src/commands/workspace/executor/token/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/workspace/executor/token/index.ts)_
 
 ## `hereya workspace executor uninstall`
 
@@ -1404,7 +1429,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.73.4/src/commands/workspace/executor/uninstall/index.ts)_
+_See code: [src/commands/workspace/executor/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/workspace/executor/uninstall/index.ts)_
 
 ## `hereya workspace install PACKAGE`
 
@@ -1431,7 +1456,7 @@ EXAMPLES
   $ hereya workspace install hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/workspace/install/index.ts)_
+_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/workspace/install/index.ts)_
 
 ## `hereya workspace list`
 
@@ -1455,7 +1480,7 @@ EXAMPLES
   $ hereya workspace list --org personal
 ```
 
-_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/workspace/list/index.ts)_
+_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/workspace/list/index.ts)_
 
 ## `hereya workspace set-profile PROFILE`
 
@@ -1479,7 +1504,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.73.4/src/commands/workspace/set-profile/index.ts)_
+_See code: [src/commands/workspace/set-profile/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/workspace/set-profile/index.ts)_
 
 ## `hereya workspace uninstall PACKAGE`
 
@@ -1506,5 +1531,5 @@ EXAMPLES
   $ hereya workspace uninstall hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.73.4/src/commands/workspace/uninstall/index.ts)_
+_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.75.0/src/commands/workspace/uninstall/index.ts)_
 <!-- commandsstop -->

package/dist/commands/devenv/project/init/index.d.ts

@@ -6,6 +6,7 @@ export default class DevenvProjectInit extends Command {
     static description: string;
     static examples: string[];
     static flags: {
+        'deploy-workspace': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         parameter: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         template: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/devenv/project/init/index.js

@@ -21,6 +21,11 @@ export default class DevenvProjectInit extends Command {
         '<%= config.bin %> <%= command.id %> my-app -w my-workspace -t acme/node-starter -p region=us-east-1',
     ];
     static flags = {
+        'deploy-workspace': Flags.string({
+            char: 'd',
+            description: 'workspace used for deployment (required when using a template)',
+            required: false,
+        }),
         force: Flags.boolean({
             char: 'f',
             default: false,
@@ -48,6 +53,10 @@ export default class DevenvProjectInit extends Command {
         const { args, flags } = await this.parse(DevenvProjectInit);
         const { project } = args;
         const { force, parameter, template, workspace } = flags;
+        const deployWorkspace = flags['deploy-workspace'];
+        if (template && !deployWorkspace) {
+            this.error('The --deploy-workspace (-d) flag is required when using a template.');
+        }
         const backend = await getBackend();
         const getWorkspaceEnvOutput = await backend.getWorkspaceEnv({ workspace });
         if (!getWorkspaceEnvOutput.success) {
@@ -73,13 +82,14 @@ export default class DevenvProjectInit extends Command {
             await fs.writeFile(tempKeyPath, sshPrivateKey);
             await setKeyFilePermissions(tempKeyPath);
             const templateFlag = template ? ` -t ${template}` : '';
+            const deployFlag = deployWorkspace ? ` -d ${deployWorkspace}` : '';
             const paramFlags = (parameter ?? []).map((p) => ` -p ${p}`).join('');
             let remoteScript;
             if (template) {
                 // With template: hereya init creates dir via git clone, no need for mkdir
                 remoteScript = force
-                    ? `cd ~ && hereya init ${project} -w ${workspace}${templateFlag}${paramFlags}`
-                    : `if [ -d ~/${project} ]; then echo "ERROR: Folder ~/${project} already exists. Use --force to continue." && exit 1; fi && cd ~ && hereya init ${project} -w ${workspace}${templateFlag}${paramFlags}`;
+                    ? `cd ~ && hereya init ${project} -w ${workspace}${templateFlag}${deployFlag}${paramFlags}`
+                    : `if [ -d ~/${project} ]; then echo "ERROR: Folder ~/${project} already exists. Use --force to continue." && exit 1; fi && cd ~ && hereya init ${project} -w ${workspace}${templateFlag}${deployFlag}${paramFlags}`;
             }
             else {
                 // Without template: existing behavior (mkdir + cd + init)

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

@@ -7,6 +7,7 @@ export default class Init extends Command {
     static examples: string[];
     static flags: {
         chdir: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'deploy-workspace': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         parameter: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
         template: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         workspace: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/init/index.js

@@ -17,14 +17,19 @@ export default class Init extends Command {
     static examples = [
         '<%= config.bin %> <%= command.id %> myProject -w=defaultWorkspace',
         '<%= config.bin %> <%= command.id %> myProject -w=defaultWorkspace --chdir=./myProject',
-        '<%= config.bin %> <%= command.id %> myProject -w=dev -t=acme/node-starter',
-        '<%= config.bin %> <%= command.id %> myProject -w=dev -t=acme/node-starter -p region=us-east-1',
+        '<%= config.bin %> <%= command.id %> myProject -w=dev -t=acme/node-starter -d=prod',
+        '<%= config.bin %> <%= command.id %> myProject -w=dev -t=acme/node-starter -d=prod -p region=us-east-1',
     ];
     static flags = {
         chdir: Flags.string({
             description: 'directory to run command in',
             required: false,
         }),
+        'deploy-workspace': Flags.string({
+            char: 'd',
+            description: 'workspace used for deployment (required when using a template)',
+            required: false,
+        }),
         parameter: Flags.string({
             char: 'p',
             default: [],
@@ -47,6 +52,9 @@ export default class Init extends Command {
         const projectRootDir = flags.chdir || process.env.HEREYA_PROJECT_ROOT_DIR;
         // Template flow
         if (flags.template) {
+            if (!flags['deploy-workspace']) {
+                this.error('The --deploy-workspace (-d) flag is required when using a template.');
+            }
             const targetDir = projectRootDir || path.join(process.cwd(), args.project.replaceAll('/', '-'));
             if (fs.existsSync(targetDir)) {
                 this.error(`Directory ${targetDir} already exists.`);
@@ -68,6 +76,7 @@ export default class Init extends Command {
                         const tokenResult = await hereyaTokenUtils.generateHereyaToken(`Template: ${args.project}`);
                         ctx.parameters = {
                             ...userParams,
+                            deployWorkspace: flags['deploy-workspace'],
                             projectName: args.project,
                             workspace: flags.workspace,
                             ...(tokenResult ? { hereyaCloudUrl: tokenResult.cloudUrl, hereyaToken: tokenResult.token } : {}),

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/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

@@ -1,44 +1,5 @@
 {
   "commands": {
-    "bootstrap": {
-      "aliases": [],
-      "args": {
-        "infrastructureType": {
-          "description": "infrastructure to bootstrap. Options are local, aws",
-          "name": "infrastructureType",
-          "required": true
-        }
-      },
-      "description": "Install necessary resources for hereya operations in an infrastructure.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> aws",
-        "<%= config.bin %> <%= command.id %> local"
-      ],
-      "flags": {
-        "force": {
-          "char": "f",
-          "description": "redeploy hereya resources if already deployed",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "bootstrap",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "bootstrap",
-        "index.js"
-      ]
-    },
     "add": {
       "aliases": [],
       "args": {
@@ -102,6 +63,45 @@
         "index.js"
       ]
     },
+    "bootstrap": {
+      "aliases": [],
+      "args": {
+        "infrastructureType": {
+          "description": "infrastructure to bootstrap. Options are local, aws",
+          "name": "infrastructureType",
+          "required": true
+        }
+      },
+      "description": "Install necessary resources for hereya operations in an infrastructure.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> aws",
+        "<%= config.bin %> <%= command.id %> local"
+      ],
+      "flags": {
+        "force": {
+          "char": "f",
+          "description": "redeploy hereya resources if already deployed",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "bootstrap",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "bootstrap",
+        "index.js"
+      ]
+    },
     "credential-helper": {
       "aliases": [],
       "args": {
@@ -130,12 +130,13 @@
         "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": {
@@ -146,15 +147,9 @@
           "multiple": false,
           "type": "option"
         },
-        "debug": {
-          "description": "enable debug mode",
-          "name": "debug",
-          "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,
@@ -164,7 +159,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "deploy",
+      "id": "delete-state",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -174,17 +169,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "deploy",
+        "delete-state",
         "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": {
@@ -195,9 +189,15 @@
           "multiple": false,
           "type": "option"
         },
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
+          "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,
@@ -207,7 +207,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "delete-state",
+      "id": "deploy",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -217,7 +217,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "delete-state",
+        "deploy",
         "index.js"
       ]
     },
@@ -488,8 +488,8 @@
       "examples": [
         "<%= config.bin %> <%= command.id %> myProject -w=defaultWorkspace",
         "<%= config.bin %> <%= command.id %> myProject -w=defaultWorkspace --chdir=./myProject",
-        "<%= config.bin %> <%= command.id %> myProject -w=dev -t=acme/node-starter",
-        "<%= config.bin %> <%= command.id %> myProject -w=dev -t=acme/node-starter -p region=us-east-1"
+        "<%= config.bin %> <%= command.id %> myProject -w=dev -t=acme/node-starter -d=prod",
+        "<%= config.bin %> <%= command.id %> myProject -w=dev -t=acme/node-starter -d=prod -p region=us-east-1"
       ],
       "flags": {
         "chdir": {
@@ -500,6 +500,15 @@
           "multiple": false,
           "type": "option"
         },
+        "deploy-workspace": {
+          "char": "d",
+          "description": "workspace used for deployment (required when using a template)",
+          "name": "deploy-workspace",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "parameter": {
           "char": "p",
           "description": "template parameter, in the form of 'key=value'. Can be specified multiple times.",
@@ -1068,6 +1077,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": {
@@ -2349,6 +2390,15 @@
         "<%= config.bin %> <%= command.id %> my-app -w my-workspace -t acme/node-starter -p region=us-east-1"
       ],
       "flags": {
+        "deploy-workspace": {
+          "char": "d",
+          "description": "workspace used for deployment (required when using a template)",
+          "name": "deploy-workspace",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "force": {
           "char": "f",
           "description": "continue even if folder already exists",
@@ -2755,5 +2805,5 @@
       ]
     }
   },
-  "version": "0.73.4"
+  "version": "0.75.0"
 }

package/package.json

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