npm - @copado/agentia-cli - Versions diffs - 0.56.0-alpha.0 → 0.57.0-alpha.0 - Mend

@copado/agentia-cli 0.56.0-alpha.0 → 0.57.0-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (18) hide show

package/README.md +206 -117
package/dist/commands/cicd/promotion/run.d.ts +23 -0
package/dist/commands/cicd/promotion/run.js +137 -0
package/dist/commands/cicd/promotion/run.js.map +1 -0
package/dist/commands/cicd/work/promote.d.ts +25 -0
package/dist/commands/cicd/work/promote.js +141 -0
package/dist/commands/cicd/work/promote.js.map +1 -0
package/dist/lib/mcp/tools.d.ts +43 -0
package/dist/lib/mcp/tools.js +73 -0
package/dist/lib/mcp/tools.js.map +1 -1
package/dist/lib/mcp/work-tools.d.ts +29 -0
package/dist/lib/mcp/work-tools.js +62 -0
package/dist/lib/mcp/work-tools.js.map +1 -1
package/dist/lib/promotion-run.d.ts +105 -0
package/dist/lib/promotion-run.js +481 -0
package/dist/lib/promotion-run.js.map +1 -0
package/oclif.manifest.json +415 -214
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -22,7 +22,7 @@ $ npm install -g @copado/agentia-cli@alpha --registry https://registry.npmjs.org
 $ agentia COMMAND
 running command...
 $ agentia (--version)
-@copado/agentia-cli/0.56.0-alpha.0 linux-x64 node-v22.23.2
+@copado/agentia-cli/0.57.0-alpha.0 linux-x64 node-v22.23.2
 $ agentia --help [COMMAND]
 USAGE
   $ agentia COMMAND
@@ -116,9 +116,9 @@ Tools are JSON-safe and return structured results. Sensitive fields are redacted
 | Pipeline    | `agentia_pipeline_list`, `agentia_pipeline_get`, `agentia_pipeline_connection_list`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
 | Project     | `agentia_project_list`, `agentia_project_get`, `agentia_project_default_get`, `agentia_project_default_set`, `agentia_project_default_unset`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | Repository  | `agentia_repository_list`, `agentia_repository_get`, `agentia_repository_create`, `agentia_repository_update`, `agentia_repository_delete`, `agentia_repository_reset`, `agentia_repository_validate`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| Promotion   | `agentia_promotion_list`, `agentia_promotion_get`, `agentia_promotion_conflict_list`, `agentia_promotion_conflict_get`, `agentia_promotion_conflict_resolve`, `agentia_promotion_conflict_unresolve`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| Promotion   | `agentia_promotion_list`, `agentia_promotion_get`, `agentia_promotion_run`, `agentia_promotion_conflict_list`, `agentia_promotion_conflict_get`, `agentia_promotion_conflict_resolve`, `agentia_promotion_conflict_unresolve`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | User        | `agentia_user_get`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| Work        | `agentia_work_list`, `agentia_work_get`, `agentia_work_create`, `agentia_work_update`, `agentia_work_delete`, `agentia_work_set`, `agentia_work_status`, `agentia_work_commit`, `agentia_work_push`, `agentia_work_test`, `agentia_work_submit`, `agentia_work_done`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| Work        | `agentia_work_list`, `agentia_work_get`, `agentia_work_create`, `agentia_work_update`, `agentia_work_delete`, `agentia_work_set`, `agentia_work_status`, `agentia_work_commit`, `agentia_work_promote`, `agentia_work_push`, `agentia_work_test`, `agentia_work_submit`, `agentia_work_done`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
 | Metadata    | `agentia_metadata_list`, `agentia_metadata_content_get`, `agentia_metadata_content_compare`, `agentia_metadata_index_compare`, `agentia_metadata_dependency_list`, `agentia_metadata_refresh_run`, `agentia_metadata_refresh_status`, `agentia_metadata_refresh_deleted`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
 | Testing     | `agentia_testing_project_list`, `agentia_testing_project_get`, `agentia_testing_project_create`, `agentia_testing_project_delete`, `agentia_testing_robot_list`, `agentia_testing_robot_get`, `agentia_testing_robot_create`, `agentia_testing_robot_delete`, `agentia_testing_job_list`, `agentia_testing_job_get`, `agentia_testing_job_create`, `agentia_testing_job_run`, `agentia_testing_job_update`, `agentia_testing_job_delete`, `agentia_testing_job_files`, `agentia_testing_job_upload`, `agentia_testing_job_download`, `agentia_testing_build_run`, `agentia_testing_build_list`, `agentia_testing_build_logs`, `agentia_testing_build_abort`, `agentia_testing_variable_list`, `agentia_testing_variable_create`, `agentia_testing_variable_update`, `agentia_testing_variable_delete`, `agentia_testing_create`, `agentia_testing_update`, `agentia_testing_run`, `agentia_testing_status`, `agentia_testing_logs` |
@@ -135,7 +135,7 @@ Tools are JSON-safe and return structured results. Sensitive fields are redacted
 - User get defaults `id` to `me` for the authenticated user.
 - Environment create/update tools mirror the corresponding CLI commands and only send fields you provide.
 - Work set/push/submit/done tools mirror the CLI workflow: `set` prepares `feature/<user-story-name>`, then `push` / `submit` / `done` operate on the current feature branch with the same clean-tree and base-branch requirements.
-- Promotion list accepts the same filters as `agentia cicd promotion list`; promotion get takes a promotion Id.
+- Promotion list accepts the same filters as `agentia cicd promotion list`; promotion get takes a Promotion ID. `agentia_promotion_run` and `agentia_work_promote` reuse the CLI preflight, run/resume, ordered deployment-step, and bounded polling behavior.
 ## CRT Git-backed jobs
@@ -242,6 +242,7 @@ Agentia CLI is distributed under the Copado End User License Agreement. See [LIC
 * [`agentia cicd promotion get ID`](#agentia-cicd-promotion-get-id)
 * [`agentia cicd promotion list`](#agentia-cicd-promotion-list)
 * [`agentia cicd promotion open ID`](#agentia-cicd-promotion-open-id)
+* [`agentia cicd promotion run ID`](#agentia-cicd-promotion-run-id)
 * [`agentia cicd repository create NAME`](#agentia-cicd-repository-create-name)
 * [`agentia cicd repository delete ID`](#agentia-cicd-repository-delete-id)
 * [`agentia cicd repository get ID`](#agentia-cicd-repository-get-id)
@@ -257,6 +258,7 @@ Agentia CLI is distributed under the Copado End User License Agreement. See [LIC
 * [`agentia cicd work get [ID]`](#agentia-cicd-work-get-id)
 * [`agentia cicd work list`](#agentia-cicd-work-list)
 * [`agentia cicd work open [ID]`](#agentia-cicd-work-open-id)
+* [`agentia cicd work promote [ID]`](#agentia-cicd-work-promote-id)
 * [`agentia cicd work push`](#agentia-cicd-work-push)
 * [`agentia cicd work set ID`](#agentia-cicd-work-set-id)
 * [`agentia cicd work status [ID]`](#agentia-cicd-work-status-id)
@@ -364,7 +366,7 @@ EXAMPLES
   $ agentia ai agent ask --knowledge -p "Summarize our deployment guidance"
 ```
-_See code: [src/commands/ai/agent/ask.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/ai/agent/ask.ts)_
+_See code: [src/commands/ai/agent/ask.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/ai/agent/ask.ts)_
 ## `agentia ai agent chat`
@@ -410,7 +412,7 @@ EXAMPLES
   $ agentia ai agent chat --orchestrate --workspace 42d0b908-37b7-4565-9ec9-86eda40c9782
 ```
-_See code: [src/commands/ai/agent/chat.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/ai/agent/chat.ts)_
+_See code: [src/commands/ai/agent/chat.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/ai/agent/chat.ts)_
 ## `agentia ai quota get`
@@ -442,7 +444,7 @@ EXAMPLES
   $ agentia ai quota get --domain robotic.copado.com --org 42888 --json
 ```
-_See code: [src/commands/ai/quota/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/ai/quota/get.ts)_
+_See code: [src/commands/ai/quota/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/ai/quota/get.ts)_
 ## `agentia ai workspace create`
@@ -483,7 +485,7 @@ EXAMPLES
   $ agentia ai workspace create --name "Agentia CLI" --description "CLI workspace" --capability Reasoning --capability CustomKnowledge
 ```
-_See code: [src/commands/ai/workspace/create.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/ai/workspace/create.ts)_
+_See code: [src/commands/ai/workspace/create.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/ai/workspace/create.ts)_
 ## `agentia ai workspace get ID`
@@ -518,7 +520,7 @@ EXAMPLES
   $ agentia ai workspace get 42d0b908-37b7-4565-9ec9-86eda40c9782 --json
 ```
-_See code: [src/commands/ai/workspace/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/ai/workspace/get.ts)_
+_See code: [src/commands/ai/workspace/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/ai/workspace/get.ts)_
 ## `agentia ai workspace list`
@@ -550,7 +552,7 @@ EXAMPLES
   $ agentia ai workspace list --domain robotic.copado.com --org 42888 --json
 ```
-_See code: [src/commands/ai/workspace/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/ai/workspace/list.ts)_
+_See code: [src/commands/ai/workspace/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/ai/workspace/list.ts)_
 ## `agentia ai workspace member invite WORKSPACE`
@@ -588,7 +590,7 @@ EXAMPLES
   $ agentia ai workspace member invite 42d0b908-37b7-4565-9ec9-86eda40c9782 --user-id 12345 --permission Manage --json
 ```
-_See code: [src/commands/ai/workspace/member/invite.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/ai/workspace/member/invite.ts)_
+_See code: [src/commands/ai/workspace/member/invite.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/ai/workspace/member/invite.ts)_
 ## `agentia ai workspace member list WORKSPACE`
@@ -623,7 +625,7 @@ EXAMPLES
   $ agentia ai workspace member list 42d0b908-37b7-4565-9ec9-86eda40c9782 --json
 ```
-_See code: [src/commands/ai/workspace/member/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/ai/workspace/member/list.ts)_
+_See code: [src/commands/ai/workspace/member/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/ai/workspace/member/list.ts)_
 ## `agentia ai workspace update ID`
@@ -670,7 +672,7 @@ EXAMPLES
   $ agentia ai workspace update 42d0b908-37b7-4565-9ec9-86eda40c9782 --capability Reasoning --capability CustomKnowledge
 ```
-_See code: [src/commands/ai/workspace/update.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/ai/workspace/update.ts)_
+_See code: [src/commands/ai/workspace/update.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/ai/workspace/update.ts)_
 ## `agentia auth get`
@@ -705,7 +707,7 @@ EXAMPLES
   $ agentia auth get --json
 ```
-_See code: [src/commands/auth/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/auth/get.ts)_
+_See code: [src/commands/auth/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/auth/get.ts)_
 ## `agentia auth set`
@@ -764,7 +766,7 @@ EXAMPLES
   $ agentia auth set --cicd <copado-api-key> --region na --json
 ```
-_See code: [src/commands/auth/set.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/auth/set.ts)_
+_See code: [src/commands/auth/set.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/auth/set.ts)_
 ## `agentia auth unset`
@@ -800,7 +802,7 @@ EXAMPLES
   $ agentia auth unset --json --yes
 ```
-_See code: [src/commands/auth/unset.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/auth/unset.ts)_
+_See code: [src/commands/auth/unset.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/auth/unset.ts)_
 ## `agentia cicd credential create`
@@ -829,7 +831,7 @@ EXAMPLES
   $ agentia cicd credential create --environmentid <environment-id> --name "CI User" --json
 ```
-_See code: [src/commands/cicd/credential/create.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/credential/create.ts)_
+_See code: [src/commands/cicd/credential/create.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/credential/create.ts)_
 ## `agentia cicd credential update ID`
@@ -861,7 +863,7 @@ EXAMPLES
   $ agentia cicd credential update <credential-id> --environmentid <environment-id> --no-default --json
 ```
-_See code: [src/commands/cicd/credential/update.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/credential/update.ts)_
+_See code: [src/commands/cicd/credential/update.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/credential/update.ts)_
 ## `agentia cicd environment auth status ID`
@@ -891,7 +893,7 @@ EXAMPLES
   $ agentia cicd environment auth status <environment-id> --json
 ```
-_See code: [src/commands/cicd/environment/auth/status.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/environment/auth/status.ts)_
+_See code: [src/commands/cicd/environment/auth/status.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/environment/auth/status.ts)_
 ## `agentia cicd environment auth web login ID`
@@ -925,7 +927,7 @@ EXAMPLES
   $ agentia cicd environment auth web login <environment-id> --json
 ```
-_See code: [src/commands/cicd/environment/auth/web/login.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/environment/auth/web/login.ts)_
+_See code: [src/commands/cicd/environment/auth/web/login.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/environment/auth/web/login.ts)_
 ## `agentia cicd environment create NAME`
@@ -970,7 +972,7 @@ EXAMPLES
   $ agentia cicd environment create Dev --json
 ```
-_See code: [src/commands/cicd/environment/create.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/environment/create.ts)_
+_See code: [src/commands/cicd/environment/create.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/environment/create.ts)_
 ## `agentia cicd environment get ID`
@@ -995,7 +997,7 @@ EXAMPLES
   $ agentia cicd environment get a0SKC000000CmZ2AU --json
 ```
-_See code: [src/commands/cicd/environment/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/environment/get.ts)_
+_See code: [src/commands/cicd/environment/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/environment/get.ts)_
 ## `agentia cicd environment list`
@@ -1029,7 +1031,7 @@ EXAMPLES
   $ agentia cicd environment list --json
 ```
-_See code: [src/commands/cicd/environment/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/environment/list.ts)_
+_See code: [src/commands/cicd/environment/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/environment/list.ts)_
 ## `agentia cicd environment open [ID]`
@@ -1061,7 +1063,7 @@ EXAMPLES
   $ agentia cicd environment open a0SKC000000CmZ2AU --credentialid <credential-id> --json
 ```
-_See code: [src/commands/cicd/environment/open.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/environment/open.ts)_
+_See code: [src/commands/cicd/environment/open.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/environment/open.ts)_
 ## `agentia cicd environment update ID`
@@ -1107,7 +1109,7 @@ EXAMPLES
   $ agentia cicd environment update a0SKC000000CmZ2AU --name UAT --json
 ```
-_See code: [src/commands/cicd/environment/update.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/environment/update.ts)_
+_See code: [src/commands/cicd/environment/update.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/environment/update.ts)_
 ## `agentia cicd job get ID`
@@ -1132,7 +1134,7 @@ EXAMPLES
   $ agentia cicd job get <job-id> --json
 ```
-_See code: [src/commands/cicd/job/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/job/get.ts)_
+_See code: [src/commands/cicd/job/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/job/get.ts)_
 ## `agentia cicd job kill ID`
@@ -1157,7 +1159,7 @@ EXAMPLES
   $ agentia cicd job kill <job-id> --json
 ```
-_See code: [src/commands/cicd/job/kill.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/job/kill.ts)_
+_See code: [src/commands/cicd/job/kill.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/job/kill.ts)_
 ## `agentia cicd job list`
@@ -1195,7 +1197,7 @@ EXAMPLES
   $ agentia cicd job list --json
 ```
-_See code: [src/commands/cicd/job/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/job/list.ts)_
+_See code: [src/commands/cicd/job/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/job/list.ts)_
 ## `agentia cicd job log get ID`
@@ -1225,7 +1227,7 @@ EXAMPLES
   $ agentia cicd job log get <job-id> --json
 ```
-_See code: [src/commands/cicd/job/log/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/job/log/get.ts)_
+_See code: [src/commands/cicd/job/log/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/job/log/get.ts)_
 ## `agentia cicd job open ID`
@@ -1250,7 +1252,7 @@ EXAMPLES
   $ agentia cicd job open <job-id> --json
 ```
-_See code: [src/commands/cicd/job/open.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/job/open.ts)_
+_See code: [src/commands/cicd/job/open.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/job/open.ts)_
 ## `agentia cicd job pause ID`
@@ -1275,7 +1277,7 @@ EXAMPLES
   $ agentia cicd job pause <job-id> --json
 ```
-_See code: [src/commands/cicd/job/pause.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/job/pause.ts)_
+_See code: [src/commands/cicd/job/pause.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/job/pause.ts)_
 ## `agentia cicd job resume ID`
@@ -1300,7 +1302,7 @@ EXAMPLES
   $ agentia cicd job resume <job-id> --json
 ```
-_See code: [src/commands/cicd/job/resume.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/job/resume.ts)_
+_See code: [src/commands/cicd/job/resume.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/job/resume.ts)_
 ## `agentia cicd job run ID`
@@ -1328,7 +1330,7 @@ EXAMPLES
   $ agentia cicd job run <job-id> --restart --json
 ```
-_See code: [src/commands/cicd/job/run.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/job/run.ts)_
+_See code: [src/commands/cicd/job/run.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/job/run.ts)_
 ## `agentia cicd metadata content compare`
@@ -1371,7 +1373,7 @@ EXAMPLES
   $ agentia cicd metadata content compare --metadata-type ApexClass --api-name MyClass --json
 ```
-_See code: [src/commands/cicd/metadata/content/compare.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/metadata/content/compare.ts)_
+_See code: [src/commands/cicd/metadata/content/compare.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/metadata/content/compare.ts)_
 ## `agentia cicd metadata content get`
@@ -1412,7 +1414,7 @@ EXAMPLES
   $ agentia cicd metadata content get --file requests.json --json
 ```
-_See code: [src/commands/cicd/metadata/content/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/metadata/content/get.ts)_
+_See code: [src/commands/cicd/metadata/content/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/metadata/content/get.ts)_
 ## `agentia cicd metadata dependency list`
@@ -1460,7 +1462,7 @@ EXAMPLES
   $ agentia cicd metadata dependency list --from-changes --base-ref origin/main --retrieve-mode all --pipeline-id <id> --source-org-id <id> --source-credential-id <id>
 ```
-_See code: [src/commands/cicd/metadata/dependency/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/metadata/dependency/list.ts)_
+_See code: [src/commands/cicd/metadata/dependency/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/metadata/dependency/list.ts)_
 ## `agentia cicd metadata index compare`
@@ -1494,7 +1496,7 @@ EXAMPLES
   $ agentia cicd metadata index compare --comparison-mode MIX --json
 ```
-_See code: [src/commands/cicd/metadata/index/compare.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/metadata/index/compare.ts)_
+_See code: [src/commands/cicd/metadata/index/compare.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/metadata/index/compare.ts)_
 ## `agentia cicd metadata list`
@@ -1542,7 +1544,7 @@ EXAMPLES
   $ agentia cicd metadata list --source NewAndChanged --find-managed-packages --json
 ```
-_See code: [src/commands/cicd/metadata/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/metadata/list.ts)_
+_See code: [src/commands/cicd/metadata/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/metadata/list.ts)_
 ## `agentia cicd metadata refresh deleted`
@@ -1572,7 +1574,7 @@ EXAMPLES
   $ agentia cicd metadata refresh deleted --env <environment-id> --module-type vlocity --json
 ```
-_See code: [src/commands/cicd/metadata/refresh/deleted.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/metadata/refresh/deleted.ts)_
+_See code: [src/commands/cicd/metadata/refresh/deleted.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/metadata/refresh/deleted.ts)_
 ## `agentia cicd metadata refresh run`
@@ -1613,7 +1615,7 @@ EXAMPLES
   $ agentia cicd metadata refresh run --env <environment-id> --all --json
 ```
-_See code: [src/commands/cicd/metadata/refresh/run.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/metadata/refresh/run.ts)_
+_See code: [src/commands/cicd/metadata/refresh/run.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/metadata/refresh/run.ts)_
 ## `agentia cicd metadata refresh status`
@@ -1643,7 +1645,7 @@ EXAMPLES
   $ agentia cicd metadata refresh status --job-id <event-id> --json
 ```
-_See code: [src/commands/cicd/metadata/refresh/status.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/metadata/refresh/status.ts)_
+_See code: [src/commands/cicd/metadata/refresh/status.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/metadata/refresh/status.ts)_
 ## `agentia cicd pipeline connection list`
@@ -1668,7 +1670,7 @@ EXAMPLES
   $ agentia cicd pipeline connection list --pipeline-id <pipeline-id> --json
 ```
-_See code: [src/commands/cicd/pipeline/connection/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/pipeline/connection/list.ts)_
+_See code: [src/commands/cicd/pipeline/connection/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/pipeline/connection/list.ts)_
 ## `agentia cicd pipeline get ID`
@@ -1693,7 +1695,7 @@ EXAMPLES
   $ agentia cicd pipeline get <pipeline-id> --json
 ```
-_See code: [src/commands/cicd/pipeline/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/pipeline/get.ts)_
+_See code: [src/commands/cicd/pipeline/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/pipeline/get.ts)_
 ## `agentia cicd pipeline list`
@@ -1719,7 +1721,7 @@ EXAMPLES
   $ agentia cicd pipeline list --json
 ```
-_See code: [src/commands/cicd/pipeline/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/pipeline/list.ts)_
+_See code: [src/commands/cicd/pipeline/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/pipeline/list.ts)_
 ## `agentia cicd pipeline open ID`
@@ -1744,7 +1746,7 @@ EXAMPLES
   $ agentia cicd pipeline open <pipeline-id> --json
 ```
-_See code: [src/commands/cicd/pipeline/open.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/pipeline/open.ts)_
+_See code: [src/commands/cicd/pipeline/open.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/pipeline/open.ts)_
 ## `agentia cicd project default get`
@@ -1782,7 +1784,7 @@ EXAMPLES
   $ agentia cicd project default get --json
 ```
-_See code: [src/commands/cicd/project/default/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/project/default/get.ts)_
+_See code: [src/commands/cicd/project/default/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/project/default/get.ts)_
 ## `agentia cicd project default set`
@@ -1820,7 +1822,7 @@ EXAMPLES
   $ agentia cicd project default set --project my-project --json
 ```
-_See code: [src/commands/cicd/project/default/set.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/project/default/set.ts)_
+_See code: [src/commands/cicd/project/default/set.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/project/default/set.ts)_
 ## `agentia cicd project default unset`
@@ -1858,7 +1860,7 @@ EXAMPLES
   $ agentia cicd project default unset --project --json
 ```
-_See code: [src/commands/cicd/project/default/unset.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/project/default/unset.ts)_
+_See code: [src/commands/cicd/project/default/unset.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/project/default/unset.ts)_
 ## `agentia cicd project get ID`
@@ -1883,7 +1885,7 @@ EXAMPLES
   $ agentia cicd project get <project-id> --json
 ```
-_See code: [src/commands/cicd/project/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/project/get.ts)_
+_See code: [src/commands/cicd/project/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/project/get.ts)_
 ## `agentia cicd project list`
@@ -1915,7 +1917,7 @@ EXAMPLES
   $ agentia cicd project list --mine --json
 ```
-_See code: [src/commands/cicd/project/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/project/list.ts)_
+_See code: [src/commands/cicd/project/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/project/list.ts)_
 ## `agentia cicd project open [ID]`
@@ -1942,7 +1944,7 @@ EXAMPLES
   $ agentia cicd project open a0wKC000000CmZ2AU --json
 ```
-_See code: [src/commands/cicd/project/open.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/project/open.ts)_
+_See code: [src/commands/cicd/project/open.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/project/open.ts)_
 ## `agentia cicd promotion conflict get ID`
@@ -1973,7 +1975,7 @@ EXAMPLES
   $ agentia cicd promotion conflict get <conflict-id> -p <promotion-id> --json
 ```
-_See code: [src/commands/cicd/promotion/conflict/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/promotion/conflict/get.ts)_
+_See code: [src/commands/cicd/promotion/conflict/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/promotion/conflict/get.ts)_
 ## `agentia cicd promotion conflict list`
@@ -1998,7 +2000,7 @@ EXAMPLES
   $ agentia cicd promotion conflict list -p <promotion-id> --json
 ```
-_See code: [src/commands/cicd/promotion/conflict/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/promotion/conflict/list.ts)_
+_See code: [src/commands/cicd/promotion/conflict/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/promotion/conflict/list.ts)_
 ## `agentia cicd promotion conflict resolve ID`
@@ -2031,7 +2033,7 @@ EXAMPLES
   $ agentia cicd promotion conflict resolve <conflict-id> -p <promotion-id> --mode auto --json
 ```
-_See code: [src/commands/cicd/promotion/conflict/resolve.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/promotion/conflict/resolve.ts)_
+_See code: [src/commands/cicd/promotion/conflict/resolve.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/promotion/conflict/resolve.ts)_
 ## `agentia cicd promotion conflict unresolve ID`
@@ -2059,7 +2061,7 @@ EXAMPLES
   $ agentia cicd promotion conflict unresolve <conflict-id> -p <promotion-id> --json
 ```
-_See code: [src/commands/cicd/promotion/conflict/unresolve.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/promotion/conflict/unresolve.ts)_
+_See code: [src/commands/cicd/promotion/conflict/unresolve.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/promotion/conflict/unresolve.ts)_
 ## `agentia cicd promotion get ID`
@@ -2084,7 +2086,7 @@ EXAMPLES
   $ agentia cicd promotion get <promotion-id> --json
 ```
-_See code: [src/commands/cicd/promotion/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/promotion/get.ts)_
+_See code: [src/commands/cicd/promotion/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/promotion/get.ts)_
 ## `agentia cicd promotion list`
@@ -2130,7 +2132,7 @@ EXAMPLES
   $ agentia cicd promotion list --json
 ```
-_See code: [src/commands/cicd/promotion/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/promotion/list.ts)_
+_See code: [src/commands/cicd/promotion/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/promotion/list.ts)_
 ## `agentia cicd promotion open ID`
@@ -2155,7 +2157,50 @@ EXAMPLES
   $ agentia cicd promotion open <promotion-id> --json
 ```
-_See code: [src/commands/cicd/promotion/open.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/promotion/open.ts)_
+_See code: [src/commands/cicd/promotion/open.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/promotion/open.ts)_
+## `agentia cicd promotion run ID`
+Preflight, start, and optionally wait for a Copado promotion execution. Use --resume to continue an existing failed or conflict-resolved execution without starting a duplicate promotion.
+```
+USAGE
+  $ agentia cicd promotion run ID [--json] [--deployment-step-id <value>...] [--ignored-metadata-json <value>]
+    [--operation merge|merge_and_deploy] [--recreate-promotion-branch] [--resume <value>] [--wait] [--wait-timeout
+    <value>] [-y]
+ARGUMENTS
+  ID  18-character Salesforce Promotion ID
+FLAGS
+  -y, --yes                            Confirm promotion branch recreation without prompting.
+      --deployment-step-id=<value>...  Ordered deployment-step Salesforce ID. Can be provided multiple times.
+      --ignored-metadata-json=<value>  JSON array to persist through ignored-metadata before starting the promotion.
+      --operation=<option>             Promotion operation. Required unless --resume is used.
+                                       <options: merge|merge_and_deploy>
+      --recreate-promotion-branch      Recreate the promotion branch before execution. Requires confirmation or --yes.
+      --resume=<value>                 Resume this existing JobExecution ID instead of calling the promotion run
+                                       endpoint.
+      --[no-]wait                      Poll promotion and deployment executions to terminal status.
+      --wait-timeout=<value>           [default: 900] Maximum total seconds to wait for promotion and deployment
+                                       executions.
+GLOBAL FLAGS
+  --json  Format output as json.
+DESCRIPTION
+  Preflight, start, and optionally wait for a Copado promotion execution. Use --resume to continue an existing failed or
+  conflict-resolved execution without starting a duplicate promotion.
+EXAMPLES
+  $ agentia cicd promotion run a0BXXXXXXXXXXXXXXX --operation merge
+  $ agentia cicd promotion run a0BXXXXXXXXXXXXXXX --operation merge_and_deploy --json
+  $ agentia cicd promotion run a0BXXXXXXXXXXXXXXX --resume a4NXXXXXXXXXXXXXXX
+```
+_See code: [src/commands/cicd/promotion/run.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/promotion/run.ts)_
 ## `agentia cicd repository create NAME`
@@ -2203,7 +2248,7 @@ EXAMPLES
   $ agentia cicd repository create my-repo --source-format DX --provider Gitlab --json
 ```
-_See code: [src/commands/cicd/repository/create.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/repository/create.ts)_
+_See code: [src/commands/cicd/repository/create.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/repository/create.ts)_
 ## `agentia cicd repository delete ID`
@@ -2228,7 +2273,7 @@ EXAMPLES
   $ agentia cicd repository delete repo-001 --json
 ```
-_See code: [src/commands/cicd/repository/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/repository/delete.ts)_
+_See code: [src/commands/cicd/repository/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/repository/delete.ts)_
 ## `agentia cicd repository get ID`
@@ -2253,7 +2298,7 @@ EXAMPLES
   $ agentia cicd repository get repo-001 --json
 ```
-_See code: [src/commands/cicd/repository/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/repository/get.ts)_
+_See code: [src/commands/cicd/repository/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/repository/get.ts)_
 ## `agentia cicd repository list`
@@ -2275,7 +2320,7 @@ EXAMPLES
   $ agentia cicd repository list --json
 ```
-_See code: [src/commands/cicd/repository/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/repository/list.ts)_
+_See code: [src/commands/cicd/repository/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/repository/list.ts)_
 ## `agentia cicd repository reset ID`
@@ -2300,7 +2345,7 @@ EXAMPLES
   $ agentia cicd repository reset repo-001 --json
 ```
-_See code: [src/commands/cicd/repository/reset.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/repository/reset.ts)_
+_See code: [src/commands/cicd/repository/reset.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/repository/reset.ts)_
 ## `agentia cicd repository update ID`
@@ -2361,7 +2406,7 @@ EXAMPLES
   $ agentia cicd repository update repo-001 --provider Gitlab --json
 ```
-_See code: [src/commands/cicd/repository/update.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/repository/update.ts)_
+_See code: [src/commands/cicd/repository/update.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/repository/update.ts)_
 ## `agentia cicd repository validate ID`
@@ -2386,7 +2431,7 @@ EXAMPLES
   $ agentia cicd repository validate repo-001 --json
 ```
-_See code: [src/commands/cicd/repository/validate.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/repository/validate.ts)_
+_See code: [src/commands/cicd/repository/validate.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/repository/validate.ts)_
 ## `agentia cicd user get`
@@ -2415,7 +2460,7 @@ EXAMPLES
   $ agentia cicd user get --json
 ```
-_See code: [src/commands/cicd/user/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/user/get.ts)_
+_See code: [src/commands/cicd/user/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/user/get.ts)_
 ## `agentia cicd work commit [ID]`
@@ -2470,7 +2515,7 @@ EXAMPLES
   cat commit-request.json | agentia cicd work commit --cloud --stdin --json
 ```
-_See code: [src/commands/cicd/work/commit.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/work/commit.ts)_
+_See code: [src/commands/cicd/work/commit.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/work/commit.ts)_
 ## `agentia cicd work create`
@@ -2525,7 +2570,7 @@ EXAMPLES
   $ agentia cicd work create --title "My story" --json
 ```
-_See code: [src/commands/cicd/work/create.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/work/create.ts)_
+_See code: [src/commands/cicd/work/create.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/work/create.ts)_
 ## `agentia cicd work delete ID`
@@ -2550,7 +2595,7 @@ EXAMPLES
   $ agentia cicd work delete a0SKC000000CmZ2AU --json
 ```
-_See code: [src/commands/cicd/work/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/work/delete.ts)_
+_See code: [src/commands/cicd/work/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/work/delete.ts)_
 ## `agentia cicd work done`
@@ -2573,7 +2618,7 @@ EXAMPLES
   $ agentia cicd work done --json
 ```
-_See code: [src/commands/cicd/work/done.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/work/done.ts)_
+_See code: [src/commands/cicd/work/done.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/work/done.ts)_
 ## `agentia cicd work get [ID]`
@@ -2600,7 +2645,7 @@ EXAMPLES
   $ agentia cicd work get a0SKC000000CmZ2AU --json
 ```
-_See code: [src/commands/cicd/work/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/work/get.ts)_
+_See code: [src/commands/cicd/work/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/work/get.ts)_
 ## `agentia cicd work list`
@@ -2645,7 +2690,7 @@ EXAMPLES
   $ agentia cicd work list --json
 ```
-_See code: [src/commands/cicd/work/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/work/list.ts)_
+_See code: [src/commands/cicd/work/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/work/list.ts)_
 ## `agentia cicd work open [ID]`
@@ -2672,7 +2717,51 @@ EXAMPLES
   $ agentia cicd work open a0SKC000000CmZ2AU --json
 ```
-_See code: [src/commands/cicd/work/open.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/work/open.ts)_
+_See code: [src/commands/cicd/work/open.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/work/open.ts)_
+## `agentia cicd work promote [ID]`
+Promote the explicit or active User Story through its Copado Promotion. Requires --cloud and selects promote-only unless --deploy is passed.
+```
+USAGE
+  $ agentia cicd work promote [ID] [--json] [--cloud] [--deploy] [--deployment-step-id <value>...]
+    [--ignored-metadata-json <value>] [--promotion-id <value>] [--recreate-promotion-branch] [--wait] [--wait-timeout
+    <value>] [-y]
+ARGUMENTS
+  [ID]  User Story ID (defaults to the active work item from `work set`)
+FLAGS
+  -y, --yes                            Confirm promotion branch recreation without prompting.
+      --cloud                          Use the Copado cloud promotion API. Required for this command.
+      --deploy                         Use merge_and_deploy instead of promote-only merge.
+      --deployment-step-id=<value>...  Ordered deployment-step Salesforce ID. Can be provided multiple times with
+                                       --deploy.
+      --ignored-metadata-json=<value>  JSON array to persist through ignored-metadata before starting the promotion.
+      --promotion-id=<value>           Explicit 18-character Promotion ID when the User Story belongs to multiple
+                                       promotions.
+      --recreate-promotion-branch      Recreate the promotion branch before execution. Requires confirmation or --yes.
+      --[no-]wait                      Poll promotion and deployment executions to terminal status.
+      --wait-timeout=<value>           [default: 900] Maximum total seconds to wait for promotion and deployment
+                                       executions.
+GLOBAL FLAGS
+  --json  Format output as json.
+DESCRIPTION
+  Promote the explicit or active User Story through its Copado Promotion. Requires --cloud and selects promote-only
+  unless --deploy is passed.
+EXAMPLES
+  $ agentia cicd work promote --cloud
+  $ agentia cicd work promote a07XXXXXXXXXXXXXXX --cloud --promotion-id a0BXXXXXXXXXXXXXXX
+  $ agentia cicd work promote --cloud --deploy --json
+```
+_See code: [src/commands/cicd/work/promote.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/work/promote.ts)_
 ## `agentia cicd work push`
@@ -2696,7 +2785,7 @@ EXAMPLES
   $ agentia cicd work push --json
 ```
-_See code: [src/commands/cicd/work/push.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/work/push.ts)_
+_See code: [src/commands/cicd/work/push.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/work/push.ts)_
 ## `agentia cicd work set ID`
@@ -2728,7 +2817,7 @@ EXAMPLES
   $ agentia cicd work set US-0001 --base-branch develop
 ```
-_See code: [src/commands/cicd/work/set.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/work/set.ts)_
+_See code: [src/commands/cicd/work/set.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/work/set.ts)_
 ## `agentia cicd work status [ID]`
@@ -2756,7 +2845,7 @@ EXAMPLES
   $ agentia cicd work status a0SKC000000CmZ2AU --json
 ```
-_See code: [src/commands/cicd/work/status.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/work/status.ts)_
+_See code: [src/commands/cicd/work/status.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/work/status.ts)_
 ## `agentia cicd work submit`
@@ -2793,7 +2882,7 @@ EXAMPLES
   $ agentia cicd work submit --json
 ```
-_See code: [src/commands/cicd/work/submit.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/work/submit.ts)_
+_See code: [src/commands/cicd/work/submit.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/work/submit.ts)_
 ## `agentia cicd work test`
@@ -2823,7 +2912,7 @@ EXAMPLES
   $ agentia cicd work test --local --json
 ```
-_See code: [src/commands/cicd/work/test.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/work/test.ts)_
+_See code: [src/commands/cicd/work/test.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/work/test.ts)_
 ## `agentia cicd work update [ID]`
@@ -2883,7 +2972,7 @@ EXAMPLES
   $ agentia cicd work update a0SKC000000CmZ2AU --status "In Progress" --json
 ```
-_See code: [src/commands/cicd/work/update.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/cicd/work/update.ts)_
+_See code: [src/commands/cicd/work/update.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/cicd/work/update.ts)_
 ## `agentia help [COMMAND]`
@@ -2922,7 +3011,7 @@ EXAMPLES
   $ agentia mcp start # long-running stdio MCP server for Cursor and other clients
 ```
-_See code: [src/commands/mcp/start.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/mcp/start.ts)_
+_See code: [src/commands/mcp/start.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/mcp/start.ts)_
 ## `agentia plugins`
@@ -3245,7 +3334,7 @@ EXAMPLES
   $ agentia setup --json
 ```
-_See code: [src/commands/setup.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/setup.ts)_
+_See code: [src/commands/setup.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/setup.ts)_
 ## `agentia testing build abort ID`
@@ -3277,7 +3366,7 @@ EXAMPLES
   $ agentia testing build abort <build-id> --project <project-id> --job <job-id> --json
 ```
-_See code: [src/commands/testing/build/abort.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/build/abort.ts)_
+_See code: [src/commands/testing/build/abort.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/build/abort.ts)_
 ## `agentia testing build list`
@@ -3311,7 +3400,7 @@ EXAMPLES
   $ agentia testing build list --project <project-id> --job <job-id> --status succeeded --json
 ```
-_See code: [src/commands/testing/build/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/build/list.ts)_
+_See code: [src/commands/testing/build/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/build/list.ts)_
 ## `agentia testing build logs ID`
@@ -3345,7 +3434,7 @@ EXAMPLES
   $ agentia testing build logs <build-id> --project <project-id> --job <job-id> --output log.html --json
 ```
-_See code: [src/commands/testing/build/logs.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/build/logs.ts)_
+_See code: [src/commands/testing/build/logs.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/build/logs.ts)_
 ## `agentia testing build run ID`
@@ -3393,7 +3482,7 @@ EXAMPLES
   $ agentia testing build run <job-id> --project <project-id> --json
 ```
-_See code: [src/commands/testing/build/run.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/build/run.ts)_
+_See code: [src/commands/testing/build/run.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/build/run.ts)_
 ## `agentia testing create`
@@ -3427,7 +3516,7 @@ EXAMPLES
   $ agentia testing create --project <project-id> --robot <robot-id> --name "Smoke" --dir tests --json
 ```
-_See code: [src/commands/testing/create.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/create.ts)_
+_See code: [src/commands/testing/create.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/create.ts)_
 ## `agentia testing job create`
@@ -3479,7 +3568,7 @@ EXAMPLES
   $ agentia testing job create --project <project-id> --robot <robot-id> --name "Smoke" --git-url https://github.com/acme/crt-tests.git --git-branch main
 ```
-_See code: [src/commands/testing/job/create.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/job/create.ts)_
+_See code: [src/commands/testing/job/create.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/job/create.ts)_
 ## `agentia testing job delete ID`
@@ -3510,7 +3599,7 @@ EXAMPLES
   $ agentia testing job delete <job-id> --project <project-id> --json
 ```
-_See code: [src/commands/testing/job/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/job/delete.ts)_
+_See code: [src/commands/testing/job/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/job/delete.ts)_
 ## `agentia testing job download ID`
@@ -3545,7 +3634,7 @@ EXAMPLES
   $ agentia testing job download <job-id> --project <project-id> --file tests.robot --output-dir ./crt-files --json
 ```
-_See code: [src/commands/testing/job/download.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/job/download.ts)_
+_See code: [src/commands/testing/job/download.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/job/download.ts)_
 ## `agentia testing job files ID`
@@ -3576,7 +3665,7 @@ EXAMPLES
   $ agentia testing job files <job-id> --project <project-id> --json
 ```
-_See code: [src/commands/testing/job/files.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/job/files.ts)_
+_See code: [src/commands/testing/job/files.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/job/files.ts)_
 ## `agentia testing job get ID`
@@ -3607,7 +3696,7 @@ EXAMPLES
   $ agentia testing job get <job-id> --project <project-id> --json
 ```
-_See code: [src/commands/testing/job/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/job/get.ts)_
+_See code: [src/commands/testing/job/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/job/get.ts)_
 ## `agentia testing job list`
@@ -3636,7 +3725,7 @@ EXAMPLES
   $ agentia testing job list --project <project-id> --name "Smoke" --json
 ```
-_See code: [src/commands/testing/job/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/job/list.ts)_
+_See code: [src/commands/testing/job/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/job/list.ts)_
 ## `agentia testing job run ID`
@@ -3684,7 +3773,7 @@ EXAMPLES
   $ agentia testing job run <job-id> --project <project-id> --json
 ```
-_See code: [src/commands/testing/job/run.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/job/run.ts)_
+_See code: [src/commands/testing/job/run.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/job/run.ts)_
 ## `agentia testing job update ID`
@@ -3756,7 +3845,7 @@ EXAMPLES
   $ agentia testing job update <job-id> --project <project-id> --timeout 10m --parallel-mode enabled --json
 ```
-_See code: [src/commands/testing/job/update.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/job/update.ts)_
+_See code: [src/commands/testing/job/update.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/job/update.ts)_
 ## `agentia testing job upload ID`
@@ -3795,7 +3884,7 @@ EXAMPLES
   $ agentia testing job upload <job-id> --project <project-id> --replace local.robot:tests.robot --remove old.robot --json
 ```
-_See code: [src/commands/testing/job/upload.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/job/upload.ts)_
+_See code: [src/commands/testing/job/upload.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/job/upload.ts)_
 ## `agentia testing logs ID`
@@ -3829,7 +3918,7 @@ EXAMPLES
   $ agentia testing logs <build-id> --project <project-id> --job <job-id> --output log.html --json
 ```
-_See code: [src/commands/testing/logs.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/logs.ts)_
+_See code: [src/commands/testing/logs.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/logs.ts)_
 ## `agentia testing project create`
@@ -3859,7 +3948,7 @@ EXAMPLES
   $ agentia testing project create --name "QA Tests" --description "Smoke suite" --json
 ```
-_See code: [src/commands/testing/project/create.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/project/create.ts)_
+_See code: [src/commands/testing/project/create.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/project/create.ts)_
 ## `agentia testing project delete ID`
@@ -3889,7 +3978,7 @@ EXAMPLES
   $ agentia testing project delete <project-id> --json
 ```
-_See code: [src/commands/testing/project/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/project/delete.ts)_
+_See code: [src/commands/testing/project/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/project/delete.ts)_
 ## `agentia testing project get ID`
@@ -3919,7 +4008,7 @@ EXAMPLES
   $ agentia testing project get <project-id> --json
 ```
-_See code: [src/commands/testing/project/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/project/get.ts)_
+_See code: [src/commands/testing/project/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/project/get.ts)_
 ## `agentia testing project list`
@@ -3947,7 +4036,7 @@ EXAMPLES
   $ agentia testing project list --name "QA Tests" --json
 ```
-_See code: [src/commands/testing/project/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/project/list.ts)_
+_See code: [src/commands/testing/project/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/project/list.ts)_
 ## `agentia testing robot create`
@@ -3983,7 +4072,7 @@ EXAMPLES
   $ agentia testing robot create --project <project-id> --name "QConnect Robot" --kind QConnect --json
 ```
-_See code: [src/commands/testing/robot/create.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/robot/create.ts)_
+_See code: [src/commands/testing/robot/create.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/robot/create.ts)_
 ## `agentia testing robot delete ID`
@@ -4014,7 +4103,7 @@ EXAMPLES
   $ agentia testing robot delete <robot-id> --project <project-id> --json
 ```
-_See code: [src/commands/testing/robot/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/robot/delete.ts)_
+_See code: [src/commands/testing/robot/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/robot/delete.ts)_
 ## `agentia testing robot get ID`
@@ -4045,7 +4134,7 @@ EXAMPLES
   $ agentia testing robot get <robot-id> --project <project-id> --json
 ```
-_See code: [src/commands/testing/robot/get.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/robot/get.ts)_
+_See code: [src/commands/testing/robot/get.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/robot/get.ts)_
 ## `agentia testing robot list`
@@ -4073,7 +4162,7 @@ EXAMPLES
   $ agentia testing robot list --project <project-id> --json
 ```
-_See code: [src/commands/testing/robot/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/robot/list.ts)_
+_See code: [src/commands/testing/robot/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/robot/list.ts)_
 ## `agentia testing run ID`
@@ -4121,7 +4210,7 @@ EXAMPLES
   $ agentia testing run <job-id> --project <project-id> --json
 ```
-_See code: [src/commands/testing/run.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/run.ts)_
+_See code: [src/commands/testing/run.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/run.ts)_
 ## `agentia testing status`
@@ -4155,7 +4244,7 @@ EXAMPLES
   $ agentia testing status --project <project-id> --job <job-id> --status executing --json
 ```
-_See code: [src/commands/testing/status.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/status.ts)_
+_See code: [src/commands/testing/status.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/status.ts)_
 ## `agentia testing test create`
@@ -4189,7 +4278,7 @@ EXAMPLES
   $ agentia testing test create --project <project-id> --robot <robot-id> --name "Smoke" --dir tests --json
 ```
-_See code: [src/commands/testing/test/create.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/test/create.ts)_
+_See code: [src/commands/testing/test/create.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/test/create.ts)_
 ## `agentia testing test logs ID`
@@ -4223,7 +4312,7 @@ EXAMPLES
   $ agentia testing test logs <build-id> --project <project-id> --job <job-id> --output log.html --json
 ```
-_See code: [src/commands/testing/test/logs.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/test/logs.ts)_
+_See code: [src/commands/testing/test/logs.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/test/logs.ts)_
 ## `agentia testing test run ID`
@@ -4272,7 +4361,7 @@ EXAMPLES
   $ agentia testing test run <job-id> --project <project-id> --json
 ```
-_See code: [src/commands/testing/test/run.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/test/run.ts)_
+_See code: [src/commands/testing/test/run.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/test/run.ts)_
 ## `agentia testing test status`
@@ -4306,7 +4395,7 @@ EXAMPLES
   $ agentia testing test status --project <project-id> --job <job-id> --status executing --json
 ```
-_See code: [src/commands/testing/test/status.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/test/status.ts)_
+_See code: [src/commands/testing/test/status.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/test/status.ts)_
 ## `agentia testing test update ID`
@@ -4345,7 +4434,7 @@ EXAMPLES
   $ agentia testing test update <job-id> --project <project-id> --add new.robot --remove old.robot --json
 ```
-_See code: [src/commands/testing/test/update.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/test/update.ts)_
+_See code: [src/commands/testing/test/update.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/test/update.ts)_
 ## `agentia testing update ID`
@@ -4384,7 +4473,7 @@ EXAMPLES
   $ agentia testing update <job-id> --project <project-id> --add new.robot --remove old.robot --json
 ```
-_See code: [src/commands/testing/update.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/update.ts)_
+_See code: [src/commands/testing/update.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/update.ts)_
 ## `agentia testing variable create`
@@ -4423,7 +4512,7 @@ EXAMPLES
   $ agentia testing variable create --project <project-id> --key TOKEN --value secret --sensitive --json
 ```
-_See code: [src/commands/testing/variable/create.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/variable/create.ts)_
+_See code: [src/commands/testing/variable/create.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/variable/create.ts)_
 ## `agentia testing variable delete ID`
@@ -4454,7 +4543,7 @@ EXAMPLES
   $ agentia testing variable delete <variable-id> --project <project-id> --json
 ```
-_See code: [src/commands/testing/variable/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/variable/delete.ts)_
+_See code: [src/commands/testing/variable/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/variable/delete.ts)_
 ## `agentia testing variable list`
@@ -4485,7 +4574,7 @@ EXAMPLES
   $ agentia testing variable list --project <project-id> --job <job-id> --json
 ```
-_See code: [src/commands/testing/variable/list.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/variable/list.ts)_
+_See code: [src/commands/testing/variable/list.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/variable/list.ts)_
 ## `agentia testing variable update ID`
@@ -4524,7 +4613,7 @@ EXAMPLES
   $ agentia testing variable update <variable-id> --project <project-id> --not-sensitive --json
 ```
-_See code: [src/commands/testing/variable/update.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/testing/variable/update.ts)_
+_See code: [src/commands/testing/variable/update.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/testing/variable/update.ts)_
 ## `agentia update`
@@ -4551,5 +4640,5 @@ EXAMPLES
   $ agentia update --check --json
 ```
-_See code: [src/commands/update.ts](https://github.com/Copado/agentia-cli/blob/v0.56.0-alpha.0/src/commands/update.ts)_
+_See code: [src/commands/update.ts](https://github.com/Copado/agentia-cli/blob/v0.57.0-alpha.0/src/commands/update.ts)_
 <!-- commandsstop -->