hereya-cli 0.102.0 → 0.103.0

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g hereya-cli
 $ hereya COMMAND
 running command...
 $ hereya (--version)
-hereya-cli/0.102.0 linux-x64 node-v24.18.0
+hereya-cli/0.103.0 linux-x64 node-v24.18.0
 $ hereya --help [COMMAND]
 USAGE
   $ hereya COMMAND
@@ -131,7 +131,7 @@ EXAMPLES
   $ hereya add cloudy/docker_postgres
 ```
 
-_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/add/index.ts)_
+_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/add/index.ts)_
 
 ## `hereya app deploy NAME`
 
@@ -165,7 +165,7 @@ EXAMPLES
   $ hereya app deploy my-org/my-app -w prod -p organizationId=org-123
 ```
 
-_See code: [src/commands/app/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/app/deploy/index.ts)_
+_See code: [src/commands/app/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/app/deploy/index.ts)_
 
 ## `hereya app deployments NAME`
 
@@ -185,7 +185,7 @@ EXAMPLES
   $ hereya app deployments my-org/my-app
 ```
 
-_See code: [src/commands/app/deployments/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/app/deployments/index.ts)_
+_See code: [src/commands/app/deployments/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/app/deployments/index.ts)_
 
 ## `hereya app destroy NAME`
 
@@ -214,7 +214,7 @@ EXAMPLES
   $ hereya app destroy my-org/my-app -w my-workspace
 ```
 
-_See code: [src/commands/app/destroy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/app/destroy/index.ts)_
+_See code: [src/commands/app/destroy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/app/destroy/index.ts)_
 
 ## `hereya app env NAME [KEY]`
 
@@ -240,7 +240,7 @@ EXAMPLES
   $ hereya app env my-org/my-app -w my-workspace DATABASE_URL
 ```
 
-_See code: [src/commands/app/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/app/env/index.ts)_
+_See code: [src/commands/app/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/app/env/index.ts)_
 
 ## `hereya app list`
 
@@ -257,7 +257,7 @@ EXAMPLES
   $ hereya app list
 ```
 
-_See code: [src/commands/app/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/app/list/index.ts)_
+_See code: [src/commands/app/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/app/list/index.ts)_
 
 ## `hereya app new DIRNAME`
 
@@ -283,7 +283,7 @@ EXAMPLES
   $ hereya app new ./my-app -n my-org/my-app --description "An ai-app-builder app"
 ```
 
-_See code: [src/commands/app/new/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/app/new/index.ts)_
+_See code: [src/commands/app/new/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/app/new/index.ts)_
 
 ## `hereya app status NAME`
 
@@ -306,7 +306,7 @@ EXAMPLES
   $ hereya app status my-org/my-app -w my-workspace
 ```
 
-_See code: [src/commands/app/status/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/app/status/index.ts)_
+_See code: [src/commands/app/status/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/app/status/index.ts)_
 
 ## `hereya bootstrap INFRASTRUCTURETYPE`
 
@@ -331,7 +331,7 @@ EXAMPLES
   $ hereya bootstrap local
 ```
 
-_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/bootstrap/index.ts)_
+_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/bootstrap/index.ts)_
 
 ## `hereya clone PROJECT`
 
@@ -356,7 +356,7 @@ EXAMPLES
   $ hereya clone myProject --chdir=./myProject
 ```
 
-_See code: [src/commands/clone/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/clone/index.ts)_
+_See code: [src/commands/clone/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/clone/index.ts)_
 
 ## `hereya config export-backend [FILE]`
 
@@ -378,7 +378,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.102.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.103.0/src/commands/config/export-backend/index.ts)_
 
 ## `hereya config get-backend`
 
@@ -395,7 +395,7 @@ EXAMPLES
   $ hereya config get-backend
 ```
 
-_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.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.103.0/src/commands/config/get-backend/index.ts)_
 
 ## `hereya config import-backend FILE`
 
@@ -415,7 +415,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.102.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.103.0/src/commands/config/import-backend/index.ts)_
 
 ## `hereya config use-backend TYPE`
 
@@ -437,7 +437,7 @@ EXAMPLES
   $ hereya config use-backend local
 ```
 
-_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.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.103.0/src/commands/config/use-backend/index.ts)_
 
 ## `hereya delete-state`
 
@@ -463,7 +463,7 @@ EXAMPLES
   $ hereya delete-state --workspace staging
 ```
 
-_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/delete-state/index.ts)_
+_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/delete-state/index.ts)_
 
 ## `hereya deploy`
 
@@ -489,7 +489,7 @@ EXAMPLES
   $ hereya deploy
 ```
 
-_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/deploy/index.ts)_
+_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/deploy/index.ts)_
 
 ## `hereya devenv config`
 
@@ -510,7 +510,7 @@ EXAMPLES
   $ hereya devenv config -w my-workspace
 ```
 
-_See code: [src/commands/devenv/config/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/devenv/config/index.ts)_
+_See code: [src/commands/devenv/config/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/devenv/config/index.ts)_
 
 ## `hereya devenv install`
 
@@ -537,7 +537,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.102.0/src/commands/devenv/install/index.ts)_
+_See code: [src/commands/devenv/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/devenv/install/index.ts)_
 
 ## `hereya devenv project init PROJECT`
 
@@ -569,7 +569,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.102.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.103.0/src/commands/devenv/project/init/index.ts)_
 
 ## `hereya devenv project uninit PROJECT`
 
@@ -595,7 +595,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.102.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.103.0/src/commands/devenv/project/uninit/index.ts)_
 
 ## `hereya devenv sleep`
 
@@ -616,7 +616,7 @@ EXAMPLES
   $ hereya devenv sleep -w my-workspace
 ```
 
-_See code: [src/commands/devenv/sleep/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/devenv/sleep/index.ts)_
+_See code: [src/commands/devenv/sleep/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/devenv/sleep/index.ts)_
 
 ## `hereya devenv ssh`
 
@@ -636,7 +636,7 @@ EXAMPLES
   $ hereya devenv ssh -w my-workspace
 ```
 
-_See code: [src/commands/devenv/ssh/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/devenv/ssh/index.ts)_
+_See code: [src/commands/devenv/ssh/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/devenv/ssh/index.ts)_
 
 ## `hereya devenv uninstall`
 
@@ -657,7 +657,7 @@ EXAMPLES
   $ hereya devenv uninstall -w my-workspace
 ```
 
-_See code: [src/commands/devenv/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/devenv/uninstall/index.ts)_
+_See code: [src/commands/devenv/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/devenv/uninstall/index.ts)_
 
 ## `hereya doc PACKAGE`
 
@@ -690,7 +690,7 @@ EXAMPLES
   $ hereya doc my-package --no-doc
 ```
 
-_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/doc/index.ts)_
+_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/doc/index.ts)_
 
 ## `hereya docker run IMAGE`
 
@@ -721,7 +721,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.102.0/src/commands/docker/run/index.ts)_
+_See code: [src/commands/docker/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/docker/run/index.ts)_
 
 ## `hereya down`
 
@@ -748,7 +748,7 @@ EXAMPLES
   $ hereya down
 ```
 
-_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/down/index.ts)_
+_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/down/index.ts)_
 
 ## `hereya env [NAME]`
 
@@ -779,7 +779,7 @@ EXAMPLES
   $ hereya env -w dev -l
 ```
 
-_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/env/index.ts)_
+_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/env/index.ts)_
 
 ## `hereya env set [NAME]`
 
@@ -806,7 +806,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.102.0/src/commands/env/set/index.ts)_
+_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/env/set/index.ts)_
 
 ## `hereya executor start`
 
@@ -840,7 +840,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.102.0/src/commands/executor/start/index.ts)_
+_See code: [src/commands/executor/start/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/executor/start/index.ts)_
 
 ## `hereya flow add PACKAGE`
 
@@ -878,7 +878,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.102.0/src/commands/flow/add/index.ts)_
+_See code: [src/commands/flow/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/flow/add/index.ts)_
 
 ## `hereya flow docker run IMAGE`
 
@@ -908,7 +908,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.102.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.103.0/src/commands/flow/docker/run/index.ts)_
 
 ## `hereya flow down`
 
@@ -942,7 +942,7 @@ EXAMPLES
   $ hereya flow down --pin
 ```
 
-_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/flow/down/index.ts)_
+_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/flow/down/index.ts)_
 
 ## `hereya flow env [NAME]`
 
@@ -976,7 +976,7 @@ EXAMPLES
   $ hereya flow env -l
 ```
 
-_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/flow/env/index.ts)_
+_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/flow/env/index.ts)_
 
 ## `hereya flow provid PACKAGE`
 
@@ -1005,7 +1005,7 @@ EXAMPLES
   $ hereya flow provid hereya/postgres --pin
 ```
 
-_See code: [src/commands/flow/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/flow/provid/index.ts)_
+_See code: [src/commands/flow/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/flow/provid/index.ts)_
 
 ## `hereya flow remove PACKAGE`
 
@@ -1035,7 +1035,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.102.0/src/commands/flow/remove/index.ts)_
+_See code: [src/commands/flow/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/flow/remove/index.ts)_
 
 ## `hereya flow run CMD`
 
@@ -1064,7 +1064,7 @@ EXAMPLES
   $ hereya flow run --pin -- npm test
 ```
 
-_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/flow/run/index.ts)_
+_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/flow/run/index.ts)_
 
 ## `hereya flow up`
 
@@ -1098,7 +1098,7 @@ EXAMPLES
   $ hereya flow up --pin
 ```
 
-_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/flow/up/index.ts)_
+_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/flow/up/index.ts)_
 
 ## `hereya help [COMMAND]`
 
@@ -1155,7 +1155,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.102.0/src/commands/import/index.ts)_
+_See code: [src/commands/import/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/import/index.ts)_
 
 ## `hereya import-repo PROJECT`
 
@@ -1185,7 +1185,7 @@ EXAMPLES
   $ hereya import-repo myProject -w=dev -r=https://github.com/acme/api --clone --chdir=./api
 ```
 
-_See code: [src/commands/import-repo/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/import-repo/index.ts)_
+_See code: [src/commands/import-repo/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/import-repo/index.ts)_
 
 ## `hereya init PROJECT`
 
@@ -1219,30 +1219,35 @@ 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.102.0/src/commands/init/index.ts)_
+_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/init/index.ts)_
 
 ## `hereya job cancel JOBID`
 
-Cancel a pending remote executor job. Only pending jobs can be cancelled.
+Cancel a remote executor job. Pending jobs and running jobs with a stale executor heartbeat (stuck executor) are cancellable by default; use --force to cancel a job that is actively running.
 
 ```
 USAGE
-  $ hereya job cancel JOBID -w <value>
+  $ hereya job cancel JOBID -w <value> [-f]
 
 ARGUMENTS
   JOBID  id of the remote executor job to cancel
 
 FLAGS
+  -f, --force              cancel even if the job appears to be actively running; does NOT stop the executor's in-flight
+                           work
   -w, --workspace=<value>  (required) name of the workspace the job belongs to
 
 DESCRIPTION
-  Cancel a pending remote executor job. Only pending jobs can be cancelled.
+  Cancel a remote executor job. Pending jobs and running jobs with a stale executor heartbeat (stuck executor) are
+  cancellable by default; use --force to cancel a job that is actively running.
 
 EXAMPLES
   $ hereya job cancel my-job-id -w my-workspace
+
+  $ hereya job cancel my-job-id -w my-workspace --force
 ```
 
-_See code: [src/commands/job/cancel/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/job/cancel/index.ts)_
+_See code: [src/commands/job/cancel/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/job/cancel/index.ts)_
 
 ## `hereya job list`
 
@@ -1268,7 +1273,7 @@ EXAMPLES
   $ hereya job list -w my-workspace --status pending --limit 10
 ```
 
-_See code: [src/commands/job/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/job/list/index.ts)_
+_See code: [src/commands/job/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/job/list/index.ts)_
 
 ## `hereya list`
 
@@ -1285,7 +1290,7 @@ EXAMPLES
   $ hereya list
 ```
 
-_See code: [src/commands/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/list/index.ts)_
+_See code: [src/commands/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/list/index.ts)_
 
 ## `hereya login [URL]`
 
@@ -1314,7 +1319,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.102.0/src/commands/login/index.ts)_
+_See code: [src/commands/login/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/login/index.ts)_
 
 ## `hereya logout`
 
@@ -1331,7 +1336,7 @@ EXAMPLES
   $ hereya logout
 ```
 
-_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/logout/index.ts)_
+_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/logout/index.ts)_
 
 ## `hereya provid PACKAGE`
 
@@ -1359,7 +1364,7 @@ EXAMPLES
   $ hereya provid hereya/postgres --workspace staging
 ```
 
-_See code: [src/commands/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/provid/index.ts)_
+_See code: [src/commands/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/provid/index.ts)_
 
 ## `hereya publish`
 
@@ -1382,7 +1387,7 @@ EXAMPLES
   $ hereya publish --chdir=/path/to/package
 ```
 
-_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/publish/index.ts)_
+_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/publish/index.ts)_
 
 ## `hereya remove PACKAGE`
 
@@ -1410,7 +1415,7 @@ EXAMPLES
   $ hereya remove cloudy/docker_postgres
 ```
 
-_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/remove/index.ts)_
+_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/remove/index.ts)_
 
 ## `hereya run CMD`
 
@@ -1436,7 +1441,7 @@ EXAMPLES
   $ hereya run -w uat -- node index.js
 ```
 
-_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/run/index.ts)_
+_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/run/index.ts)_
 
 ## `hereya search QUERY`
 
@@ -1467,7 +1472,7 @@ EXAMPLES
   $ hereya search database --json
 ```
 
-_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/search/index.ts)_
+_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/search/index.ts)_
 
 ## `hereya unbootstrap INFRASTRUCTURETYPE`
 
@@ -1492,7 +1497,7 @@ EXAMPLES
   $ hereya unbootstrap local
 ```
 
-_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/unbootstrap/index.ts)_
+_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/unbootstrap/index.ts)_
 
 ## `hereya undeploy`
 
@@ -1518,7 +1523,7 @@ EXAMPLES
   $ hereya undeploy
 ```
 
-_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/undeploy/index.ts)_
+_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/undeploy/index.ts)_
 
 ## `hereya uninit PROJECT`
 
@@ -1546,7 +1551,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.102.0/src/commands/uninit/index.ts)_
+_See code: [src/commands/uninit/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/uninit/index.ts)_
 
 ## `hereya up`
 
@@ -1573,7 +1578,7 @@ EXAMPLES
   $ hereya up
 ```
 
-_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/up/index.ts)_
+_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/up/index.ts)_
 
 ## `hereya update [VERSION]`
 
@@ -1595,7 +1600,7 @@ EXAMPLES
   $ hereya update 0.75.0
 ```
 
-_See code: [src/commands/update/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/update/index.ts)_
+_See code: [src/commands/update/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/update/index.ts)_
 
 ## `hereya workspace create NAME`
 
@@ -1620,7 +1625,7 @@ EXAMPLES
   $ hereya workspace create dev
 ```
 
-_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/workspace/create/index.ts)_
+_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/workspace/create/index.ts)_
 
 ## `hereya workspace delete NAME`
 
@@ -1640,7 +1645,7 @@ EXAMPLES
   $ hereya workspace delete dev
 ```
 
-_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/workspace/delete/index.ts)_
+_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/workspace/delete/index.ts)_
 
 ## `hereya workspace env [NAME]`
 
@@ -1666,7 +1671,7 @@ EXAMPLES
   $ hereya workspace env myEnv -w dev
 ```
 
-_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/workspace/env/index.ts)_
+_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/workspace/env/index.ts)_
 
 ## `hereya workspace env set`
 
@@ -1690,7 +1695,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.102.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.103.0/src/commands/workspace/env/set/index.ts)_
 
 ## `hereya workspace env unset`
 
@@ -1711,7 +1716,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.102.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.103.0/src/commands/workspace/env/unset/index.ts)_
 
 ## `hereya workspace executor install`
 
@@ -1740,7 +1745,7 @@ DESCRIPTION
   - always-on: a long-lived EC2 polls hereya-cloud 24/7 (legacy).
 ```
 
-_See code: [src/commands/workspace/executor/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.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.103.0/src/commands/workspace/executor/install/index.ts)_
 
 ## `hereya workspace executor token`
 
@@ -1757,7 +1762,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.102.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.103.0/src/commands/workspace/executor/token/index.ts)_
 
 ## `hereya workspace executor uninstall`
 
@@ -1781,7 +1786,7 @@ DESCRIPTION
   controls log output.
 ```
 
-_See code: [src/commands/workspace/executor/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.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.103.0/src/commands/workspace/executor/uninstall/index.ts)_
 
 ## `hereya workspace install PACKAGE`
 
@@ -1808,7 +1813,7 @@ EXAMPLES
   $ hereya workspace install hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/workspace/install/index.ts)_
+_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/workspace/install/index.ts)_
 
 ## `hereya workspace list`
 
@@ -1832,7 +1837,7 @@ EXAMPLES
   $ hereya workspace list --org personal
 ```
 
-_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/workspace/list/index.ts)_
+_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/workspace/list/index.ts)_
 
 ## `hereya workspace set-profile PROFILE`
 
@@ -1856,7 +1861,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.102.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.103.0/src/commands/workspace/set-profile/index.ts)_
 
 ## `hereya workspace uninstall PACKAGE`
 
@@ -1883,5 +1888,5 @@ EXAMPLES
   $ hereya workspace uninstall hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.102.0/src/commands/workspace/uninstall/index.ts)_
+_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.103.0/src/commands/workspace/uninstall/index.ts)_
 <!-- commandsstop -->

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

@@ -1,8 +1,11 @@
 import { CloudHttpConfig } from './utils.js';
 export declare function cancelExecutorJob(config: CloudHttpConfig, input: {
+    force?: boolean;
     jobId: string;
     workspace: string;
 }): Promise<{
+    active?: boolean;
+    heartbeatAgeSeconds?: number;
     reason: string;
     status?: string;
     success: false;

package/dist/backend/cloud/cloud-backend/executor-jobs.js

@@ -1,12 +1,15 @@
 import { safeResponseJson } from './utils.js';
 export async function cancelExecutorJob(config, input) {
     const response = await fetch(`${config.url}/api/workspaces/${encodeURIComponent(input.workspace)}/jobs/${encodeURIComponent(input.jobId)}/cancel`, {
-        headers: { 'Authorization': `Bearer ${config.accessToken}` },
+        body: JSON.stringify({ force: input.force === true }),
+        headers: { 'Authorization': `Bearer ${config.accessToken}`, 'Content-Type': 'application/json' },
         method: 'POST',
     });
     if (!response.ok) {
         const error = await safeResponseJson(response);
         return {
+            active: error.active,
+            heartbeatAgeSeconds: error.heartbeatAgeSeconds,
             reason: error.error || `Failed to cancel job (status ${response.status})`,
             status: error.status,
             success: false,

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

@@ -28,9 +28,12 @@ export declare class CloudBackend implements Backend {
     constructor(config: CloudBackendConfig);
     addPackageToWorkspace(input: Parameters<typeof packagesWorkspace.addPackageToWorkspace>[1]): Promise<import("../common.js").AddPackageToWorkspaceOutput>;
     cancelExecutorJob(input: {
+        force?: boolean;
         jobId: string;
         workspace: string;
     }): Promise<{
+        active?: boolean;
+        heartbeatAgeSeconds?: number;
         reason: string;
         status?: string;
         success: false;

package/dist/commands/job/cancel/index.d.ts

@@ -6,6 +6,7 @@ export default class JobCancel extends Command {
     static description: string;
     static examples: string[];
     static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         workspace: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;

package/dist/commands/job/cancel/index.js

@@ -5,9 +5,17 @@ export default class JobCancel extends Command {
     static args = {
         jobId: Args.string({ description: 'id of the remote executor job to cancel', required: true }),
     };
-    static description = 'Cancel a pending remote executor job. Only pending jobs can be cancelled.';
-    static examples = ['<%= config.bin %> <%= command.id %> my-job-id -w my-workspace'];
+    static description = 'Cancel a remote executor job. Pending jobs and running jobs with a stale executor heartbeat (stuck executor) are cancellable by default; use --force to cancel a job that is actively running.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> my-job-id -w my-workspace',
+        '<%= config.bin %> <%= command.id %> my-job-id -w my-workspace --force',
+    ];
     static flags = {
+        force: Flags.boolean({
+            char: 'f',
+            default: false,
+            description: "cancel even if the job appears to be actively running; does NOT stop the executor's in-flight work",
+        }),
         workspace: Flags.string({
             char: 'w',
             description: 'name of the workspace the job belongs to',
@@ -21,10 +29,17 @@ export default class JobCancel extends Command {
             this.error('Cancelling executor jobs requires the cloud backend. Run `hereya login` first.');
         }
         const cloudBackend = backend;
-        const result = await cloudBackend.cancelExecutorJob({ jobId: args.jobId, workspace: flags.workspace });
+        const result = await cloudBackend.cancelExecutorJob({
+            force: flags.force,
+            jobId: args.jobId,
+            workspace: flags.workspace,
+        });
         if (!result.success) {
             const detail = result.status && !result.reason.includes(result.status) ? ` (current status: ${result.status})` : '';
-            this.error(`Failed to cancel job ${args.jobId}: ${result.reason}${detail}`);
+            const forceHint = result.active && !flags.force
+                ? "\nRetry with --force to cancel anyway (the executor's in-flight work will NOT be stopped)."
+                : '';
+            this.error(`Failed to cancel job ${args.jobId}: ${result.reason}${detail}${forceHint}`);
         }
         this.log(`Job ${args.jobId} cancelled.`);
     }

package/oclif.manifest.json

@@ -2402,61 +2402,6 @@
         "index.js"
       ]
     },
-    "flow:remove": {
-      "aliases": [],
-      "args": {
-        "package": {
-          "description": "Remove a previously added package.",
-          "name": "package",
-          "required": true
-        }
-      },
-      "description": "Remove a package from the project in a git branch-based workspace",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres",
-        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres --profile staging"
-      ],
-      "flags": {
-        "chdir": {
-          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n        Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR environment variable.\n      ",
-          "name": "chdir",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "debug": {
-          "description": "enable debug mode",
-          "name": "debug",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "profile": {
-          "description": "profile to use for the workspace (will be appended to workspace name)",
-          "name": "profile",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "flow:remove",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "flow",
-        "remove",
-        "index.js"
-      ]
-    },
     "flow:run": {
       "aliases": [],
       "args": {
@@ -2597,11 +2542,19 @@
           "required": true
         }
       },
-      "description": "Cancel a pending remote executor job. Only pending jobs can be cancelled.",
+      "description": "Cancel a remote executor job. Pending jobs and running jobs with a stale executor heartbeat (stuck executor) are cancellable by default; use --force to cancel a job that is actively running.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> my-job-id -w my-workspace"
+        "<%= config.bin %> <%= command.id %> my-job-id -w my-workspace",
+        "<%= config.bin %> <%= command.id %> my-job-id -w my-workspace --force"
       ],
       "flags": {
+        "force": {
+          "char": "f",
+          "description": "cancel even if the job appears to be actively running; does NOT stop the executor's in-flight work",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "workspace": {
           "char": "w",
           "description": "name of the workspace the job belongs to",
@@ -3039,6 +2992,61 @@
         "index.js"
       ]
     },
+    "flow:remove": {
+      "aliases": [],
+      "args": {
+        "package": {
+          "description": "Remove a previously added package.",
+          "name": "package",
+          "required": true
+        }
+      },
+      "description": "Remove a package from the project in a git branch-based workspace",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres",
+        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres --profile staging"
+      ],
+      "flags": {
+        "chdir": {
+          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n        Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR environment variable.\n      ",
+          "name": "chdir",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "profile": {
+          "description": "profile to use for the workspace (will be appended to workspace name)",
+          "name": "profile",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "flow:remove",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flow",
+        "remove",
+        "index.js"
+      ]
+    },
     "devenv:project:init": {
       "aliases": [],
       "args": {
@@ -3306,51 +3314,6 @@
         "index.js"
       ]
     },
-    "workspace:env:unset": {
-      "aliases": [],
-      "args": {},
-      "description": "unset an env var for a workspace",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> -w my-workspace -n myVar"
-      ],
-      "flags": {
-        "name": {
-          "char": "n",
-          "description": "name of the env var to unset",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "workspace": {
-          "char": "w",
-          "description": "name of the workspace to unset an env var for",
-          "name": "workspace",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "workspace:env:unset",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "workspace",
-        "env",
-        "unset",
-        "index.js"
-      ]
-    },
     "workspace:executor:install": {
       "aliases": [],
       "args": {},
@@ -3507,7 +3470,52 @@
         "uninstall",
         "index.js"
       ]
+    },
+    "workspace:env:unset": {
+      "aliases": [],
+      "args": {},
+      "description": "unset an env var for a workspace",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -w my-workspace -n myVar"
+      ],
+      "flags": {
+        "name": {
+          "char": "n",
+          "description": "name of the env var to unset",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "name of the workspace to unset an env var for",
+          "name": "workspace",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "workspace:env:unset",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "workspace",
+        "env",
+        "unset",
+        "index.js"
+      ]
     }
   },
-  "version": "0.102.0"
+  "version": "0.103.0"
 }

package/package.json

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