@copado/agentia-cli 0.11.0-alpha.0 → 0.14.0-alpha.0

package/README.md

@@ -1,46 +1,43 @@
-@copado/agentia-cli
-=================
+# @copado/agentia-cli
 
 Command-line interface for Agentia headless Copado workflows (auth, environments, jobs, pipelines, metadata, and local MCP).
 
-
 [![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
 [![Version](https://img.shields.io/npm/v/%40copado%2Fagentia-cli.svg)](https://www.npmjs.com/package/@copado/agentia-cli)
 [![Downloads/week](https://img.shields.io/npm/dw/%40copado%2Fagentia-cli.svg)](https://www.npmjs.com/package/@copado/agentia-cli)
 
-
 <!-- toc -->
+* [@copado/agentia-cli](#copadoagentia-cli)
 * [Usage](#usage)
-* [Integration Testing](#integration-testing)
 * [Local MCP Server](#local-mcp-server)
 * [License](#license)
 * [Commands](#commands)
 <!-- tocstop -->
+
 # Usage
+
 <!-- usage -->
 ```sh-session
 $ npm install -g @copado/agentia-cli
 $ agentia COMMAND
 running command...
 $ agentia (--version)
-@copado/agentia-cli/0.11.0-alpha.0 linux-x64 node-v22.23.2
+@copado/agentia-cli/0.14.0-alpha.0 linux-x64 node-v22.23.2
 $ agentia --help [COMMAND]
 USAGE
   $ agentia COMMAND
 ...
 ```
 <!-- usagestop -->
-# Integration Testing
 
-Live metadata integration tests are opt-in. They use the CICD API key and endpoint already stored with `agentia auth set`, plus local Test14 IDs from `.env.integration`.
+Store CICD credentials before calling gateway-backed commands:
 
 ```sh-session
-$ agentia auth set --cicd <api-key> --custom-url https://test.api.copado.com
-$ cp .env.integration.example .env.integration
-$ npm run test:integration
+$ agentia auth set --cicd <api-key> --region na
+$ agentia auth get
 ```
 
-Fill `.env.integration` with the pipeline, org, credential, platform, metadata type, and API name values for the component you want to exercise. Do not commit `.env.integration`.
+Contributor setup, local gateway mode, and integration testing are documented in [DEVELOPMENT.md](DEVELOPMENT.md).
 
 # Local MCP Server
 
@@ -48,17 +45,16 @@ Agentia can run as a local Model Context Protocol (MCP) server over stdio. MCP-c
 
 ## Prerequisites
 
-1. Install or link the CLI so `agentia` is available:
+1. Install the CLI so `agentia` is available:
 
 ```sh-session
 $ npm install -g @copado/agentia-cli
-$ npm run build && npm link
 ```
 
 2. Store CICD credentials. The MCP server reuses the same keychain-backed auth as the CLI:
 
 ```sh-session
-$ agentia auth set --cicd <api-key> --custom-url https://test.api.copado.com
+$ agentia auth set --cicd <api-key> --region na
 $ agentia auth get
 ```
 
@@ -92,39 +88,20 @@ Add an MCP server entry that launches Agentia:
 }
 ```
 
-If Cursor cannot resolve `agentia` on `PATH`, use the absolute binary from this repo:
-
-```json
-{
-  "mcpServers": {
-    "agentia": {
-      "command": "/absolute/path/to/agentia-headless/cli/bin/run.js",
-      "args": ["mcp", "start"]
-    }
-  }
-}
-```
-
 After saving the config, reload MCP servers in Cursor. The Agentia tools should appear in the MCP tool list.
 
-For local development, rebuild after code changes so Cursor picks up the latest `dist` output:
-
-```sh-session
-$ npm run build
-```
-
 ## Available tools
 
 Tools are JSON-safe and return structured results. Sensitive fields are redacted.
 
-| Topic | Tools |
-| --- | --- |
-| Environment | `agentia_environment_list`, `agentia_environment_get`, `agentia_environment_create`, `agentia_environment_update` |
-| Job | `agentia_job_list`, `agentia_job_get`, `agentia_job_run`, `agentia_job_resume`, `agentia_job_kill`, `agentia_job_pause` |
-| Pipeline | `agentia_pipeline_list`, `agentia_pipeline_get`, `agentia_pipeline_connection_list` |
-| Project | `agentia_project_list`, `agentia_project_default_get`, `agentia_project_default_set`, `agentia_project_default_unset` |
-| User | `agentia_user_get` |
-| Metadata | `agentia_metadata_list`, `agentia_metadata_content_get`, `agentia_metadata_content_compare`, `agentia_metadata_index_compare`, `agentia_metadata_dependency_list` |
+| Topic       | Tools                                                                                                                                                             |
+| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Environment | `agentia_environment_list`, `agentia_environment_get`, `agentia_environment_create`, `agentia_environment_update`                                                 |
+| Job         | `agentia_job_list`, `agentia_job_get`, `agentia_job_run`, `agentia_job_resume`, `agentia_job_kill`, `agentia_job_pause`                                           |
+| Pipeline    | `agentia_pipeline_list`, `agentia_pipeline_get`, `agentia_pipeline_connection_list`                                                                               |
+| Project     | `agentia_project_list`, `agentia_project_default_get`, `agentia_project_default_set`, `agentia_project_default_unset`                                             |
+| User        | `agentia_user_get`                                                                                                                                                |
+| Metadata    | `agentia_metadata_list`, `agentia_metadata_content_get`, `agentia_metadata_content_compare`, `agentia_metadata_index_compare`, `agentia_metadata_dependency_list` |
 
 ### Notes for common tools
 
@@ -136,21 +113,12 @@ 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.
 
-## Verify locally
-
-Unit coverage for MCP registration and redaction:
-
-```sh-session
-$ npm test -- --grep 'mcp'
-```
-
-Live smoke check through Cursor: call `agentia_environment_list` or `agentia_project_default_get` after auth is configured. For pipeline and metadata tools, use Test14 IDs from your local `.env.integration`.
-
 # License
 
 Agentia CLI is distributed under the Copado End User License Agreement. See [LICENSE.md](LICENSE.md) for the full license terms.
 
 # Commands
+
 <!-- commands -->
 * [`agentia auth get`](#agentia-auth-get)
 * [`agentia auth set`](#agentia-auth-set)
@@ -197,6 +165,8 @@ Agentia CLI is distributed under the Copado End User License Agreement. See [LIC
 * [`agentia promotion conflict list`](#agentia-promotion-conflict-list)
 * [`agentia promotion conflict resolve ID`](#agentia-promotion-conflict-resolve-id)
 * [`agentia promotion conflict unresolve ID`](#agentia-promotion-conflict-unresolve-id)
+* [`agentia promotion get ID`](#agentia-promotion-get-id)
+* [`agentia promotion list`](#agentia-promotion-list)
 * [`agentia user get`](#agentia-user-get)
 * [`agentia work create`](#agentia-work-create)
 * [`agentia work delete ID`](#agentia-work-delete-id)
@@ -234,7 +204,7 @@ EXAMPLES
   $ agentia auth get --json
 ```
 
-_See code: [src/commands/auth/get.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/auth/get.ts)_
+_See code: [src/commands/auth/get.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/auth/get.ts)_
 
 ## `agentia auth set`
 
@@ -272,7 +242,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.11.0-alpha.0/src/commands/auth/set.ts)_
+_See code: [src/commands/auth/set.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/auth/set.ts)_
 
 ## `agentia environment auth status ID`
 
@@ -302,7 +272,7 @@ EXAMPLES
   $ agentia environment auth status <environment-id> --json
 ```
 
-_See code: [src/commands/environment/auth/status.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/environment/auth/status.ts)_
+_See code: [src/commands/environment/auth/status.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/environment/auth/status.ts)_
 
 ## `agentia environment auth web login ID`
 
@@ -336,7 +306,7 @@ EXAMPLES
   $ agentia environment auth web login <environment-id> --json
 ```
 
-_See code: [src/commands/environment/auth/web/login.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/environment/auth/web/login.ts)_
+_See code: [src/commands/environment/auth/web/login.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/environment/auth/web/login.ts)_
 
 ## `agentia environment create NAME`
 
@@ -381,7 +351,7 @@ EXAMPLES
   $ agentia environment create Dev --json
 ```
 
-_See code: [src/commands/environment/create.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/environment/create.ts)_
+_See code: [src/commands/environment/create.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/environment/create.ts)_
 
 ## `agentia environment get ID`
 
@@ -406,7 +376,7 @@ EXAMPLES
   $ agentia environment get a0SKC000000CmZ2AU --json
 ```
 
-_See code: [src/commands/environment/get.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/environment/get.ts)_
+_See code: [src/commands/environment/get.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/environment/get.ts)_
 
 ## `agentia environment list`
 
@@ -438,7 +408,7 @@ EXAMPLES
   $ agentia environment list --json
 ```
 
-_See code: [src/commands/environment/list.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/environment/list.ts)_
+_See code: [src/commands/environment/list.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/environment/list.ts)_
 
 ## `agentia environment update ID`
 
@@ -484,7 +454,7 @@ EXAMPLES
   $ agentia environment update a0SKC000000CmZ2AU --name UAT --json
 ```
 
-_See code: [src/commands/environment/update.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/environment/update.ts)_
+_See code: [src/commands/environment/update.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/environment/update.ts)_
 
 ## `agentia help [COMMAND]`
 
@@ -533,7 +503,7 @@ EXAMPLES
   $ agentia job get <job-id> --user-id <id> --organization-id <id> --json
 ```
 
-_See code: [src/commands/job/get.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/job/get.ts)_
+_See code: [src/commands/job/get.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/job/get.ts)_
 
 ## `agentia job kill ID`
 
@@ -562,7 +532,7 @@ EXAMPLES
   $ agentia job kill <job-id> --user-id <id> --organization-id <id> --json
 ```
 
-_See code: [src/commands/job/kill.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/job/kill.ts)_
+_See code: [src/commands/job/kill.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/job/kill.ts)_
 
 ## `agentia job list`
 
@@ -600,7 +570,7 @@ EXAMPLES
   $ agentia job list --user-id <id> --organization-id <id> --json
 ```
 
-_See code: [src/commands/job/list.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/job/list.ts)_
+_See code: [src/commands/job/list.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/job/list.ts)_
 
 ## `agentia job pause ID`
 
@@ -629,7 +599,7 @@ EXAMPLES
   $ agentia job pause <job-id> --user-id <id> --organization-id <id> --json
 ```
 
-_See code: [src/commands/job/pause.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/job/pause.ts)_
+_See code: [src/commands/job/pause.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/job/pause.ts)_
 
 ## `agentia job resume ID`
 
@@ -658,7 +628,7 @@ EXAMPLES
   $ agentia job resume <job-id> --user-id <id> --organization-id <id> --json
 ```
 
-_See code: [src/commands/job/resume.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/job/resume.ts)_
+_See code: [src/commands/job/resume.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/job/resume.ts)_
 
 ## `agentia job run ID`
 
@@ -688,7 +658,7 @@ EXAMPLES
   $ agentia job run <job-id> --user-id <id> --organization-id <id> --restart --json
 ```
 
-_See code: [src/commands/job/run.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/job/run.ts)_
+_See code: [src/commands/job/run.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/job/run.ts)_
 
 ## `agentia mcp start`
 
@@ -707,7 +677,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.11.0-alpha.0/src/commands/mcp/start.ts)_
+_See code: [src/commands/mcp/start.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/mcp/start.ts)_
 
 ## `agentia metadata content compare`
 
@@ -750,7 +720,7 @@ EXAMPLES
   $ agentia metadata content compare --metadata-type ApexClass --api-name MyClass --json
 ```
 
-_See code: [src/commands/metadata/content/compare.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/metadata/content/compare.ts)_
+_See code: [src/commands/metadata/content/compare.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/metadata/content/compare.ts)_
 
 ## `agentia metadata content get`
 
@@ -791,7 +761,7 @@ EXAMPLES
   $ agentia metadata content get --file requests.json --json
 ```
 
-_See code: [src/commands/metadata/content/get.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/metadata/content/get.ts)_
+_See code: [src/commands/metadata/content/get.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/metadata/content/get.ts)_
 
 ## `agentia metadata dependency list`
 
@@ -839,7 +809,7 @@ EXAMPLES
   $ agentia 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/metadata/dependency/list.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/metadata/dependency/list.ts)_
+_See code: [src/commands/metadata/dependency/list.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/metadata/dependency/list.ts)_
 
 ## `agentia metadata index compare`
 
@@ -873,7 +843,7 @@ EXAMPLES
   $ agentia metadata index compare --comparison-mode MIX --json
 ```
 
-_See code: [src/commands/metadata/index/compare.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/metadata/index/compare.ts)_
+_See code: [src/commands/metadata/index/compare.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/metadata/index/compare.ts)_
 
 ## `agentia metadata list`
 
@@ -921,7 +891,7 @@ EXAMPLES
   $ agentia metadata list --source NewAndChanged --find-managed-packages --json
 ```
 
-_See code: [src/commands/metadata/list.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/metadata/list.ts)_
+_See code: [src/commands/metadata/list.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/metadata/list.ts)_
 
 ## `agentia metadata refresh deleted`
 
@@ -953,7 +923,7 @@ EXAMPLES
   $ agentia metadata refresh deleted --env <environment-id> --user-id <id> --organization-id <id> --module-type vlocity --json
 ```
 
-_See code: [src/commands/metadata/refresh/deleted.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/metadata/refresh/deleted.ts)_
+_See code: [src/commands/metadata/refresh/deleted.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/metadata/refresh/deleted.ts)_
 
 ## `agentia metadata refresh run`
 
@@ -996,7 +966,7 @@ EXAMPLES
   $ agentia metadata refresh run --env <environment-id> --user-id <id> --organization-id <id> --all --json
 ```
 
-_See code: [src/commands/metadata/refresh/run.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/metadata/refresh/run.ts)_
+_See code: [src/commands/metadata/refresh/run.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/metadata/refresh/run.ts)_
 
 ## `agentia metadata refresh status`
 
@@ -1028,7 +998,7 @@ EXAMPLES
   $ agentia metadata refresh status --job-id <event-id> --user-id <id> --organization-id <id> --json
 ```
 
-_See code: [src/commands/metadata/refresh/status.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/metadata/refresh/status.ts)_
+_See code: [src/commands/metadata/refresh/status.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/metadata/refresh/status.ts)_
 
 ## `agentia pipeline connection list`
 
@@ -1055,7 +1025,7 @@ EXAMPLES
   $ agentia pipeline connection list --pipeline-id <pipeline-id> --user-id <id> --organization-id <id> --json
 ```
 
-_See code: [src/commands/pipeline/connection/list.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/pipeline/connection/list.ts)_
+_See code: [src/commands/pipeline/connection/list.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/pipeline/connection/list.ts)_
 
 ## `agentia pipeline get ID`
 
@@ -1084,7 +1054,7 @@ EXAMPLES
   $ agentia pipeline get <pipeline-id> --user-id <id> --organization-id <id> --json
 ```
 
-_See code: [src/commands/pipeline/get.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/pipeline/get.ts)_
+_See code: [src/commands/pipeline/get.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/pipeline/get.ts)_
 
 ## `agentia pipeline list`
 
@@ -1110,7 +1080,7 @@ EXAMPLES
   $ agentia pipeline list --user-id <id> --organization-id <id> --json
 ```
 
-_See code: [src/commands/pipeline/list.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/pipeline/list.ts)_
+_See code: [src/commands/pipeline/list.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/pipeline/list.ts)_
 
 ## `agentia plugins`
 
@@ -1437,7 +1407,7 @@ EXAMPLES
   $ agentia project default get --json
 ```
 
-_See code: [src/commands/project/default/get.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/project/default/get.ts)_
+_See code: [src/commands/project/default/get.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/project/default/get.ts)_
 
 ## `agentia project default set`
 
@@ -1474,7 +1444,7 @@ EXAMPLES
   $ agentia project default set --project my-project --json
 ```
 
-_See code: [src/commands/project/default/set.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/project/default/set.ts)_
+_See code: [src/commands/project/default/set.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/project/default/set.ts)_
 
 ## `agentia project default unset`
 
@@ -1511,7 +1481,7 @@ EXAMPLES
   $ agentia project default unset --project --json
 ```
 
-_See code: [src/commands/project/default/unset.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/project/default/unset.ts)_
+_See code: [src/commands/project/default/unset.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/project/default/unset.ts)_
 
 ## `agentia project list`
 
@@ -1538,7 +1508,7 @@ EXAMPLES
   $ agentia project list --mine --json
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/project/list.ts)_
+_See code: [src/commands/project/list.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/project/list.ts)_
 
 ## `agentia promotion conflict get ID`
 
@@ -1569,7 +1539,7 @@ EXAMPLES
   $ agentia promotion conflict get <conflict-id> -p <promotion-id> --json
 ```
 
-_See code: [src/commands/promotion/conflict/get.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/promotion/conflict/get.ts)_
+_See code: [src/commands/promotion/conflict/get.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/promotion/conflict/get.ts)_
 
 ## `agentia promotion conflict list`
 
@@ -1594,7 +1564,7 @@ EXAMPLES
   $ agentia promotion conflict list -p <promotion-id> --json
 ```
 
-_See code: [src/commands/promotion/conflict/list.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/promotion/conflict/list.ts)_
+_See code: [src/commands/promotion/conflict/list.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/promotion/conflict/list.ts)_
 
 ## `agentia promotion conflict resolve ID`
 
@@ -1627,7 +1597,7 @@ EXAMPLES
   $ agentia promotion conflict resolve <conflict-id> -p <promotion-id> --mode auto --json
 ```
 
-_See code: [src/commands/promotion/conflict/resolve.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/promotion/conflict/resolve.ts)_
+_See code: [src/commands/promotion/conflict/resolve.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/promotion/conflict/resolve.ts)_
 
 ## `agentia promotion conflict unresolve ID`
 
@@ -1655,7 +1625,75 @@ EXAMPLES
   $ agentia promotion conflict unresolve <conflict-id> -p <promotion-id> --json
 ```
 
-_See code: [src/commands/promotion/conflict/unresolve.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/promotion/conflict/unresolve.ts)_
+_See code: [src/commands/promotion/conflict/unresolve.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/promotion/conflict/unresolve.ts)_
+
+## `agentia promotion get ID`
+
+Get a Copado promotion by ID
+
+```
+USAGE
+  $ agentia promotion get ID [--json]
+
+ARGUMENTS
+  ID  Copado promotion ID
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Get a Copado promotion by ID
+
+EXAMPLES
+  $ agentia promotion get <promotion-id>
+
+  $ agentia promotion get <promotion-id> --json
+```
+
+_See code: [src/commands/promotion/get.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/promotion/get.ts)_
+
+## `agentia promotion list`
+
+List Copado promotions
+
+```
+USAGE
+  $ agentia promotion list [--json] [--created-by-id <value>] [--created-by-name <value>]
+    [--destination-environment-id <value>] [--destination-environment-name <value>] [--is-back-promotion] [--limit
+    <value>] [--name <value>] [--pipeline-id <value>] [--pipeline-name <value>] [--project-id <value>] [--project-name
+    <value>] [--source-environment-id <value>] [--source-environment-name <value>] [--status <value>]
+
+FLAGS
+  --created-by-id=<value>                 Filter by creator ID
+  --created-by-name=<value>               Filter by creator name
+  --destination-environment-id=<value>    Filter by destination environment ID
+  --destination-environment-name=<value>  Filter by destination environment name
+  --[no-]is-back-promotion                Filter by back promotion
+  --limit=<value>                         Maximum number of promotions to return (1-200)
+  --name=<value>                          Filter by name
+  --pipeline-id=<value>                   Filter by pipeline ID
+  --pipeline-name=<value>                 Filter by pipeline name
+  --project-id=<value>                    Filter by project ID
+  --project-name=<value>                  Filter by project name
+  --source-environment-id=<value>         Filter by source environment ID
+  --source-environment-name=<value>       Filter by source environment name
+  --status=<value>                        Filter by status
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List Copado promotions
+
+EXAMPLES
+  $ agentia promotion list
+
+  $ agentia promotion list --status Completed --project-name "My Project" --limit 50
+
+  $ agentia promotion list --json
+```
+
+_See code: [src/commands/promotion/list.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/promotion/list.ts)_
 
 ## `agentia user get`
 
@@ -1684,7 +1722,7 @@ EXAMPLES
   $ agentia user get --json
 ```
 
-_See code: [src/commands/user/get.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/user/get.ts)_
+_See code: [src/commands/user/get.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/user/get.ts)_
 
 ## `agentia work create`
 
@@ -1739,7 +1777,7 @@ EXAMPLES
   $ agentia work create --title "My story" --json
 ```
 
-_See code: [src/commands/work/create.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/work/create.ts)_
+_See code: [src/commands/work/create.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/work/create.ts)_
 
 ## `agentia work delete ID`
 
@@ -1764,7 +1802,7 @@ EXAMPLES
   $ agentia work delete a0SKC000000CmZ2AU --json
 ```
 
-_See code: [src/commands/work/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/work/delete.ts)_
+_See code: [src/commands/work/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/work/delete.ts)_
 
 ## `agentia work get ID`
 
@@ -1789,7 +1827,7 @@ EXAMPLES
   $ agentia work get a0SKC000000CmZ2AU --json
 ```
 
-_See code: [src/commands/work/get.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/work/get.ts)_
+_See code: [src/commands/work/get.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/work/get.ts)_
 
 ## `agentia work list`
 
@@ -1832,7 +1870,7 @@ EXAMPLES
   $ agentia work list --json
 ```
 
-_See code: [src/commands/work/list.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/work/list.ts)_
+_See code: [src/commands/work/list.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/work/list.ts)_
 
 ## `agentia work update ID`
 
@@ -1890,5 +1928,5 @@ EXAMPLES
   $ agentia work update a0SKC000000CmZ2AU --status "In Progress" --json
 ```
 
-_See code: [src/commands/work/update.ts](https://github.com/Copado/agentia-cli/blob/v0.11.0-alpha.0/src/commands/work/update.ts)_
+_See code: [src/commands/work/update.ts](https://github.com/Copado/agentia-cli/blob/v0.14.0-alpha.0/src/commands/work/update.ts)_
 <!-- commandsstop -->

package/dist/commands/promotion/get.d.ts

@@ -0,0 +1,10 @@
+import { AgentiaCommand } from '../../lib/agentia-command.js';
+import { type PromotionDetail } from '../../lib/promotion-types.js';
+export default class PromotionGet extends AgentiaCommand {
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<PromotionDetail>;
+}

package/dist/commands/promotion/get.js

@@ -0,0 +1,31 @@
+import { Args } from '@oclif/core';
+import { AgentiaCommand } from '../../lib/agentia-command.js';
+import { CicdGateway } from '../../lib/cicd-gateway.js';
+import { formatPromotionDetail, normalizePromotionDetail, promotionEndpoint, } from '../../lib/promotion-types.js';
+export default class PromotionGet extends AgentiaCommand {
+    static args = {
+        id: Args.string({
+            description: 'Copado promotion ID',
+            name: 'id',
+            required: true,
+        }),
+    };
+    static description = 'Get a Copado promotion by ID';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> <promotion-id>',
+        '<%= config.bin %> <%= command.id %> <promotion-id> --json',
+    ];
+    async run() {
+        const { args } = await this.parse(PromotionGet);
+        const response = await this.withSpinner('Fetching promotion', () => CicdGateway.call({
+            endpoint: promotionEndpoint(args.id),
+            method: 'GET',
+        }));
+        const promotion = normalizePromotionDetail(response);
+        this.display(() => {
+            this.log(formatPromotionDetail(promotion));
+        });
+        return promotion;
+    }
+}
+//# sourceMappingURL=get.js.map

package/dist/commands/promotion/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/promotion/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,OAAO,EAAC,cAAc,EAAC,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAC,WAAW,EAAC,MAAM,2BAA2B,CAAA;AACrD,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EAGxB,iBAAiB,GAClB,MAAM,8BAA8B,CAAA;AAErC,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,cAAc;IACtD,MAAM,CAAU,IAAI,GAAG;QACrB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC;YACd,WAAW,EAAE,qBAAqB;YAClC,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAA;IACD,MAAM,CAAU,WAAW,GAAG,8BAA8B,CAAA;IAC5D,MAAM,CAAU,QAAQ,GAAG;QACzB,oDAAoD;QACpD,2DAA2D;KAC5D,CAAA;IAEM,KAAK,CAAC,GAAG;QACd,MAAM,EAAC,IAAI,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;QAE7C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,oBAAoB,EAAE,GAAG,EAAE,CACjE,WAAW,CAAC,IAAI,CAA4C;YAC1D,QAAQ,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,EAAE,KAAK;SACd,CAAC,CACH,CAAA;QACD,MAAM,SAAS,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAA;QAEpD,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YAChB,IAAI,CAAC,GAAG,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAA;QAC5C,CAAC,CAAC,CAAA;QAEF,OAAO,SAAS,CAAA;IAClB,CAAC"}

package/dist/commands/promotion/list.d.ts

@@ -0,0 +1,30 @@
+import { AgentiaCommand } from '../../lib/agentia-command.js';
+import { type Promotion } from '../../lib/promotion-types.js';
+export declare const PROMOTION_TABLE_DISPLAY_LIMIT = 100;
+export declare function selectPromotionsForTableDisplay(promotions: Promotion[]): {
+    displayed: Promotion[];
+    total: number;
+    truncated: boolean;
+};
+export declare function formatPromotionTableTruncationMessage(total: number): string;
+export default class PromotionList extends AgentiaCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        readonly 'created-by-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'created-by-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'destination-environment-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'destination-environment-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'is-back-promotion': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        readonly limit: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'pipeline-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'pipeline-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'project-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'source-environment-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'source-environment-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<Promotion[]>;
+}