@copado/agentia-cli 0.27.0-alpha.0 → 0.29.0-alpha.0

package/README.md

@@ -22,7 +22,7 @@ $ npm install -g @copado/agentia-cli
 $ agentia COMMAND
 running command...
 $ agentia (--version)
-@copado/agentia-cli/0.27.0-alpha.0 linux-x64 node-v22.23.2
+@copado/agentia-cli/0.29.0-alpha.0 linux-x64 node-v22.23.2
 $ agentia --help [COMMAND]
 USAGE
   $ agentia COMMAND
@@ -117,6 +117,8 @@ Tools are JSON-safe and return structured results. Sensitive fields are redacted
 - Project default tools read and write local or global defaults managed by `agentia project default *`.
 - 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 promotion list`; promotion get takes a promotion Id.
 
 # License
 
@@ -174,6 +176,7 @@ Agentia CLI is distributed under the Copado End User License Agreement. See [LIC
 * [`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 setup`](#agentia-setup)
 * [`agentia user get`](#agentia-user-get)
 * [`agentia work create`](#agentia-work-create)
 * [`agentia work delete ID`](#agentia-work-delete-id)
@@ -184,6 +187,7 @@ Agentia CLI is distributed under the Copado End User License Agreement. See [LIC
 * [`agentia work set ID`](#agentia-work-set-id)
 * [`agentia work status [ID]`](#agentia-work-status-id)
 * [`agentia work submit`](#agentia-work-submit)
+* [`agentia work test`](#agentia-work-test)
 * [`agentia work update [ID]`](#agentia-work-update-id)
 
 ## `agentia auth get`
@@ -216,7 +220,7 @@ EXAMPLES
   $ agentia auth get --json
 ```
 
-_See code: [src/commands/auth/get.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/auth/get.ts)_
+_See code: [src/commands/auth/get.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/auth/get.ts)_
 
 ## `agentia auth set`
 
@@ -254,7 +258,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.27.0-alpha.0/src/commands/auth/set.ts)_
+_See code: [src/commands/auth/set.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/auth/set.ts)_
 
 ## `agentia environment auth status ID`
 
@@ -284,7 +288,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.27.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.29.0-alpha.0/src/commands/environment/auth/status.ts)_
 
 ## `agentia environment auth web login ID`
 
@@ -318,7 +322,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.27.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.29.0-alpha.0/src/commands/environment/auth/web/login.ts)_
 
 ## `agentia environment create NAME`
 
@@ -363,7 +367,7 @@ EXAMPLES
   $ agentia environment create Dev --json
 ```
 
-_See code: [src/commands/environment/create.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/environment/create.ts)_
+_See code: [src/commands/environment/create.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/environment/create.ts)_
 
 ## `agentia environment get ID`
 
@@ -388,7 +392,7 @@ EXAMPLES
   $ agentia environment get a0SKC000000CmZ2AU --json
 ```
 
-_See code: [src/commands/environment/get.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/environment/get.ts)_
+_See code: [src/commands/environment/get.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/environment/get.ts)_
 
 ## `agentia environment list`
 
@@ -396,15 +400,17 @@ List Copado environments
 
 ```
 USAGE
-  $ agentia environment list [--json] [--name <value>] [--org-id <value>] [--platform <value>] [--type
-    Production/Developer|Sandbox|Scratch Org|Custom Domain]
+  $ agentia environment list [--json] [--cursor <value>] [--page-size <value>] [--name <value>] [--org-id <value>]
+    [--platform <value>] [--type Production/Developer|Sandbox|Scratch Org|Custom Domain]
 
 FLAGS
-  --name=<value>      Filter by name
-  --org-id=<value>    Filter by Salesforce org ID
-  --platform=<value>  Filter by platform
-  --type=<option>     Environment type
-                      <options: Production/Developer|Sandbox|Scratch Org|Custom Domain>
+  --cursor=<value>     Opaque pagination cursor from a previous list response (nextCursor)
+  --name=<value>       Filter by name
+  --org-id=<value>     Filter by Salesforce org ID
+  --page-size=<value>  Number of records per page (1-200)
+  --platform=<value>   Filter by platform
+  --type=<option>      Environment type
+                       <options: Production/Developer|Sandbox|Scratch Org|Custom Domain>
 
 GLOBAL FLAGS
   --json  Format output as json.
@@ -420,7 +426,7 @@ EXAMPLES
   $ agentia environment list --json
 ```
 
-_See code: [src/commands/environment/list.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/environment/list.ts)_
+_See code: [src/commands/environment/list.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/environment/list.ts)_
 
 ## `agentia environment update ID`
 
@@ -466,7 +472,7 @@ EXAMPLES
   $ agentia environment update a0SKC000000CmZ2AU --name UAT --json
 ```
 
-_See code: [src/commands/environment/update.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/environment/update.ts)_
+_See code: [src/commands/environment/update.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/environment/update.ts)_
 
 ## `agentia help [COMMAND]`
 
@@ -511,7 +517,7 @@ EXAMPLES
   $ agentia job get <job-id> --json
 ```
 
-_See code: [src/commands/job/get.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/job/get.ts)_
+_See code: [src/commands/job/get.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/job/get.ts)_
 
 ## `agentia job kill ID`
 
@@ -536,7 +542,7 @@ EXAMPLES
   $ agentia job kill <job-id> --json
 ```
 
-_See code: [src/commands/job/kill.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/job/kill.ts)_
+_See code: [src/commands/job/kill.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/job/kill.ts)_
 
 ## `agentia job list`
 
@@ -544,18 +550,19 @@ List Copado job executions
 
 ```
 USAGE
-  $ agentia job list [--json] [--context <value>] [--id <value>] [--limit <value>] [--mine] [--name <value>]
-    [--parent <value>] [--status <value>] [--type <value>]
+  $ agentia job list [--json] [--cursor <value>] [--page-size <value>] [--context <value>] [--id <value>]
+    [--mine] [--name <value>] [--parent <value>] [--status <value>] [--type <value>]
 
 FLAGS
-  --context=<value>  Contains match on JobExecution context
-  --id=<value>       Exact JobExecution Id
-  --limit=<value>    Maximum number of jobs to return (1-200)
-  --mine             List only jobs owned by the current user
-  --name=<value>     Contains match on JobExecution name
-  --parent=<value>   Exact parent record Id
-  --status=<value>   Exact Copado job status
-  --type=<value>     Contains match on Job Template name
+  --context=<value>    Contains match on JobExecution context
+  --cursor=<value>     Opaque pagination cursor from a previous list response (nextCursor)
+  --id=<value>         Exact JobExecution Id
+  --mine               List only jobs owned by the current user
+  --name=<value>       Contains match on JobExecution name
+  --page-size=<value>  Number of records per page (1-200)
+  --parent=<value>     Exact parent record Id
+  --status=<value>     Exact Copado job status
+  --type=<value>       Contains match on Job Template name
 
 GLOBAL FLAGS
   --json  Format output as json.
@@ -566,14 +573,14 @@ DESCRIPTION
 EXAMPLES
   $ agentia job list
 
-  $ agentia job list --status "In Progress" --limit 50
+  $ agentia job list --status "In Progress" --page-size 50
 
   $ agentia job list --name JE- --type Deploy --parent <parent-id>
 
   $ agentia job list --json
 ```
 
-_See code: [src/commands/job/list.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/job/list.ts)_
+_See code: [src/commands/job/list.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/job/list.ts)_
 
 ## `agentia job log get ID`
 
@@ -603,7 +610,7 @@ EXAMPLES
   $ agentia job log get <job-id> --json
 ```
 
-_See code: [src/commands/job/log/get.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/job/log/get.ts)_
+_See code: [src/commands/job/log/get.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/job/log/get.ts)_
 
 ## `agentia job pause ID`
 
@@ -628,7 +635,7 @@ EXAMPLES
   $ agentia job pause <job-id> --json
 ```
 
-_See code: [src/commands/job/pause.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/job/pause.ts)_
+_See code: [src/commands/job/pause.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/job/pause.ts)_
 
 ## `agentia job resume ID`
 
@@ -653,7 +660,7 @@ EXAMPLES
   $ agentia job resume <job-id> --json
 ```
 
-_See code: [src/commands/job/resume.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/job/resume.ts)_
+_See code: [src/commands/job/resume.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/job/resume.ts)_
 
 ## `agentia job run ID`
 
@@ -681,7 +688,7 @@ EXAMPLES
   $ agentia job run <job-id> --restart --json
 ```
 
-_See code: [src/commands/job/run.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/job/run.ts)_
+_See code: [src/commands/job/run.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/job/run.ts)_
 
 ## `agentia mcp start`
 
@@ -700,7 +707,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.27.0-alpha.0/src/commands/mcp/start.ts)_
+_See code: [src/commands/mcp/start.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/mcp/start.ts)_
 
 ## `agentia metadata content compare`
 
@@ -743,7 +750,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.27.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.29.0-alpha.0/src/commands/metadata/content/compare.ts)_
 
 ## `agentia metadata content get`
 
@@ -784,7 +791,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.27.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.29.0-alpha.0/src/commands/metadata/content/get.ts)_
 
 ## `agentia metadata dependency list`
 
@@ -832,7 +839,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.27.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.29.0-alpha.0/src/commands/metadata/dependency/list.ts)_
 
 ## `agentia metadata index compare`
 
@@ -866,7 +873,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.27.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.29.0-alpha.0/src/commands/metadata/index/compare.ts)_
 
 ## `agentia metadata list`
 
@@ -914,7 +921,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.27.0-alpha.0/src/commands/metadata/list.ts)_
+_See code: [src/commands/metadata/list.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/metadata/list.ts)_
 
 ## `agentia metadata refresh deleted`
 
@@ -944,7 +951,7 @@ EXAMPLES
   $ agentia metadata refresh deleted --env <environment-id> --module-type vlocity --json
 ```
 
-_See code: [src/commands/metadata/refresh/deleted.ts](https://github.com/Copado/agentia-cli/blob/v0.27.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.29.0-alpha.0/src/commands/metadata/refresh/deleted.ts)_
 
 ## `agentia metadata refresh run`
 
@@ -985,7 +992,7 @@ EXAMPLES
   $ agentia metadata refresh run --env <environment-id> --all --json
 ```
 
-_See code: [src/commands/metadata/refresh/run.ts](https://github.com/Copado/agentia-cli/blob/v0.27.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.29.0-alpha.0/src/commands/metadata/refresh/run.ts)_
 
 ## `agentia metadata refresh status`
 
@@ -1015,7 +1022,7 @@ EXAMPLES
   $ agentia metadata refresh status --job-id <event-id> --json
 ```
 
-_See code: [src/commands/metadata/refresh/status.ts](https://github.com/Copado/agentia-cli/blob/v0.27.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.29.0-alpha.0/src/commands/metadata/refresh/status.ts)_
 
 ## `agentia pipeline connection list`
 
@@ -1040,7 +1047,7 @@ EXAMPLES
   $ agentia pipeline connection list --pipeline-id <pipeline-id> --json
 ```
 
-_See code: [src/commands/pipeline/connection/list.ts](https://github.com/Copado/agentia-cli/blob/v0.27.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.29.0-alpha.0/src/commands/pipeline/connection/list.ts)_
 
 ## `agentia pipeline get ID`
 
@@ -1065,7 +1072,7 @@ EXAMPLES
   $ agentia pipeline get <pipeline-id> --json
 ```
 
-_See code: [src/commands/pipeline/get.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/pipeline/get.ts)_
+_See code: [src/commands/pipeline/get.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/pipeline/get.ts)_
 
 ## `agentia pipeline list`
 
@@ -1073,7 +1080,11 @@ List Copado pipelines
 
 ```
 USAGE
-  $ agentia pipeline list [--json]
+  $ agentia pipeline list [--json] [--cursor <value>] [--page-size <value>]
+
+FLAGS
+  --cursor=<value>     Opaque pagination cursor from a previous list response (nextCursor)
+  --page-size=<value>  Number of records per page (1-200)
 
 GLOBAL FLAGS
   --json  Format output as json.
@@ -1087,7 +1098,7 @@ EXAMPLES
   $ agentia pipeline list --json
 ```
 
-_See code: [src/commands/pipeline/list.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/pipeline/list.ts)_
+_See code: [src/commands/pipeline/list.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/pipeline/list.ts)_
 
 ## `agentia plugins`
 
@@ -1415,7 +1426,7 @@ EXAMPLES
   $ agentia project default get --json
 ```
 
-_See code: [src/commands/project/default/get.ts](https://github.com/Copado/agentia-cli/blob/v0.27.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.29.0-alpha.0/src/commands/project/default/get.ts)_
 
 ## `agentia project default set`
 
@@ -1453,7 +1464,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.27.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.29.0-alpha.0/src/commands/project/default/set.ts)_
 
 ## `agentia project default unset`
 
@@ -1491,7 +1502,7 @@ EXAMPLES
   $ agentia project default unset --project --json
 ```
 
-_See code: [src/commands/project/default/unset.ts](https://github.com/Copado/agentia-cli/blob/v0.27.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.29.0-alpha.0/src/commands/project/default/unset.ts)_
 
 ## `agentia project get ID`
 
@@ -1516,7 +1527,7 @@ EXAMPLES
   $ agentia project get <project-id> --json
 ```
 
-_See code: [src/commands/project/get.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/project/get.ts)_
+_See code: [src/commands/project/get.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/project/get.ts)_
 
 ## `agentia project list`
 
@@ -1524,11 +1535,13 @@ List Copado projects
 
 ```
 USAGE
-  $ agentia project list [--json] [--mine] [--name <value>]
+  $ agentia project list [--json] [--cursor <value>] [--page-size <value>] [--mine] [--name <value>]
 
 FLAGS
-  --mine          List only projects owned by or related to the current user
-  --name=<value>  Filter by name (partial match)
+  --cursor=<value>     Opaque pagination cursor from a previous list response (nextCursor)
+  --mine               List only projects owned by or related to the current user
+  --name=<value>       Filter by name (partial match)
+  --page-size=<value>  Number of records per page (1-200)
 
 GLOBAL FLAGS
   --json  Format output as json.
@@ -1546,7 +1559,7 @@ EXAMPLES
   $ agentia project list --mine --json
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/project/list.ts)_
+_See code: [src/commands/project/list.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/project/list.ts)_
 
 ## `agentia promotion conflict get ID`
 
@@ -1577,7 +1590,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.27.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.29.0-alpha.0/src/commands/promotion/conflict/get.ts)_
 
 ## `agentia promotion conflict list`
 
@@ -1602,7 +1615,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.27.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.29.0-alpha.0/src/commands/promotion/conflict/list.ts)_
 
 ## `agentia promotion conflict resolve ID`
 
@@ -1635,7 +1648,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.27.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.29.0-alpha.0/src/commands/promotion/conflict/resolve.ts)_
 
 ## `agentia promotion conflict unresolve ID`
 
@@ -1663,7 +1676,7 @@ 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.27.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.29.0-alpha.0/src/commands/promotion/conflict/unresolve.ts)_
 
 ## `agentia promotion get ID`
 
@@ -1688,7 +1701,7 @@ EXAMPLES
   $ agentia promotion get <promotion-id> --json
 ```
 
-_See code: [src/commands/promotion/get.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/promotion/get.ts)_
+_See code: [src/commands/promotion/get.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/promotion/get.ts)_
 
 ## `agentia promotion list`
 
@@ -1696,20 +1709,21 @@ 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>] [--work-id
-    <value>]
+  $ agentia promotion list [--json] [--cursor <value>] [--page-size <value>] [--created-by-id <value>]
+    [--created-by-name <value>] [--destination-environment-id <value>] [--destination-environment-name <value>]
+    [--is-back-promotion] [--name <value>] [--pipeline-id <value>] [--pipeline-name <value>] [--project-id <value>]
+    [--project-name <value>] [--source-environment-id <value>] [--source-environment-name <value>] [--status <value>]
+    [--work-id <value>]
 
 FLAGS
   --created-by-id=<value>                 Filter by creator ID
   --created-by-name=<value>               Filter by creator name
+  --cursor=<value>                        Opaque pagination cursor from a previous list response (nextCursor)
   --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
+  --page-size=<value>                     Number of records per page (1-200)
   --pipeline-id=<value>                   Filter by pipeline ID
   --pipeline-name=<value>                 Filter by pipeline name
   --project-id=<value>                    Filter by project ID
@@ -1728,12 +1742,44 @@ DESCRIPTION
 EXAMPLES
   $ agentia promotion list
 
-  $ agentia promotion list --status Completed --project-name "My Project" --limit 50
+  $ agentia promotion list --status Completed --project-name "My Project" --page-size 50
 
   $ agentia promotion list --json
 ```
 
-_See code: [src/commands/promotion/list.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/promotion/list.ts)_
+_See code: [src/commands/promotion/list.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/promotion/list.ts)_
+
+## `agentia setup`
+
+Prepare the current git project for Agentia. Shows repository context, ensures .agentia/ is gitignored, optionally creates local quality gates and AGENTS.md, then prints next steps.
+
+```
+USAGE
+  $ agentia setup [--json] [--create-agents-md] [--create-local-quality-gates] [-n]
+
+FLAGS
+  -n, --no-prompt                   Skip interactive prompts; only run checks, notifications, and flagged actions
+      --create-agents-md            Create or update AGENTS.md and commit it (skips the prompt)
+      --create-local-quality-gates  Create sample local quality gate scripts and commit them (skips the prompt)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Prepare the current git project for Agentia. Shows repository context, ensures .agentia/ is gitignored, optionally
+  creates local quality gates and AGENTS.md, then prints next steps.
+
+EXAMPLES
+  $ agentia setup
+
+  $ agentia setup --no-prompt
+
+  $ agentia setup --create-local-quality-gates --create-agents-md --no-prompt
+
+  $ agentia setup --json
+```
+
+_See code: [src/commands/setup.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/setup.ts)_
 
 ## `agentia user get`
 
@@ -1762,7 +1808,7 @@ EXAMPLES
   $ agentia user get --json
 ```
 
-_See code: [src/commands/user/get.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/user/get.ts)_
+_See code: [src/commands/user/get.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/user/get.ts)_
 
 ## `agentia work create`
 
@@ -1817,7 +1863,7 @@ EXAMPLES
   $ agentia work create --title "My story" --json
 ```
 
-_See code: [src/commands/work/create.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/work/create.ts)_
+_See code: [src/commands/work/create.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/work/create.ts)_
 
 ## `agentia work delete ID`
 
@@ -1842,7 +1888,7 @@ EXAMPLES
   $ agentia work delete a0SKC000000CmZ2AU --json
 ```
 
-_See code: [src/commands/work/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/work/delete.ts)_
+_See code: [src/commands/work/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/work/delete.ts)_
 
 ## `agentia work done`
 
@@ -1865,7 +1911,7 @@ EXAMPLES
   $ agentia work done --json
 ```
 
-_See code: [src/commands/work/done.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/work/done.ts)_
+_See code: [src/commands/work/done.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/work/done.ts)_
 
 ## `agentia work get [ID]`
 
@@ -1892,7 +1938,7 @@ EXAMPLES
   $ agentia work get a0SKC000000CmZ2AU --json
 ```
 
-_See code: [src/commands/work/get.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/work/get.ts)_
+_See code: [src/commands/work/get.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/work/get.ts)_
 
 ## `agentia work list`
 
@@ -1900,18 +1946,20 @@ List Copado user stories
 
 ```
 USAGE
-  $ agentia work list [--json] [--assigned-to-me] [--assignee-id <value>] [--assignee-name <value>] [--name
-    <value>] [--owned-by-me] [--owner-id <value>] [--owner-name <value>] [--project-id <value>] [--project-name <value>]
-    [--status <value>] [--title <value>]
+  $ agentia work list [--json] [--cursor <value>] [--page-size <value>] [--assigned-to-me] [--assignee-id
+    <value>] [--assignee-name <value>] [--name <value>] [--owned-by-me] [--owner-id <value>] [--owner-name <value>]
+    [--project-id <value>] [--project-name <value>] [--status <value>] [--title <value>]
 
 FLAGS
   --assigned-to-me         Filter by the current user as assignee
   --assignee-id=<value>    Filter by assignee ID
   --assignee-name=<value>  Filter by assignee name
+  --cursor=<value>         Opaque pagination cursor from a previous list response (nextCursor)
   --name=<value>           Filter by name
   --owned-by-me            Filter by the current user as owner
   --owner-id=<value>       Filter by owner ID
   --owner-name=<value>     Filter by owner name
+  --page-size=<value>      Number of records per page (1-200)
   --project-id=<value>     Filter by project ID
   --project-name=<value>   Filter by project name
   --status=<value>         Filter by status
@@ -1935,7 +1983,7 @@ EXAMPLES
   $ agentia work list --json
 ```
 
-_See code: [src/commands/work/list.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/work/list.ts)_
+_See code: [src/commands/work/list.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/work/list.ts)_
 
 ## `agentia work push`
 
@@ -1958,7 +2006,7 @@ EXAMPLES
   $ agentia work push --json
 ```
 
-_See code: [src/commands/work/push.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/work/push.ts)_
+_See code: [src/commands/work/push.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/work/push.ts)_
 
 ## `agentia work set ID`
 
@@ -1990,7 +2038,7 @@ EXAMPLES
   $ agentia work set US-0001 --base-branch develop
 ```
 
-_See code: [src/commands/work/set.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/work/set.ts)_
+_See code: [src/commands/work/set.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/work/set.ts)_
 
 ## `agentia work status [ID]`
 
@@ -2018,30 +2066,66 @@ EXAMPLES
   $ agentia work status a0SKC000000CmZ2AU --json
 ```
 
-_See code: [src/commands/work/status.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/work/status.ts)_
+_See code: [src/commands/work/status.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/work/status.ts)_
 
 ## `agentia work submit`
 
-Submit the current feature/US-XXXX work item for pipeline quality gates and validation. Pushes and registers commits when the branch is ahead of origin, then calls headless work/submit (Promote Action with validate=true).
+Submit the current feature/US-XXXX work item for pipeline quality gates and validation. Runs project-root .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present, pushes and registers commits when the branch is ahead of origin, then calls headless work/submit (Promote Action with validate=true).
 
 ```
 USAGE
-  $ agentia work submit [--json]
+  $ agentia work submit [--json] [--skip-local-tests] [--skip-pull-request]
+
+FLAGS
+  --skip-local-tests   Skip running local quality gates scripts in the project root
+  --skip-pull-request  Do not open the pull request compare URL after submit (also configurable via skipPullRequest in
+                       .agentia/config.json)
 
 GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  Submit the current feature/US-XXXX work item for pipeline quality gates and validation. Pushes and registers commits
-  when the branch is ahead of origin, then calls headless work/submit (Promote Action with validate=true).
+  Submit the current feature/US-XXXX work item for pipeline quality gates and validation. Runs project-root
+  .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present, pushes and registers
+  commits when the branch is ahead of origin, then calls headless work/submit (Promote Action with validate=true).
 
 EXAMPLES
   $ agentia work submit
 
+  $ agentia work submit --skip-local-tests
+
+  $ agentia work submit --skip-pull-request
+
   $ agentia work submit --json
 ```
 
-_See code: [src/commands/work/submit.ts](https://github.com/Copado/agentia-cli/blob/v0.27.0-alpha.0/src/commands/work/submit.ts)_
+_See code: [src/commands/work/submit.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/work/submit.ts)_
+
+## `agentia work test`
+
+Run quality gates for the current work item. With --local, runs project-root .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present — the same local gates as work submit.
+
+```
+USAGE
+  $ agentia work test [--json] [--local]
+
+FLAGS
+  --local  Run local project-root quality gates scripts
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Run quality gates for the current work item. With --local, runs project-root .agentia_quality_gates.sh (macOS/Linux)
+  or .agentia_quality_gates.cmd (Windows) when present — the same local gates as work submit.
+
+EXAMPLES
+  $ agentia work test --local
+
+  $ agentia work test --local --json
+```
+
+_See code: [src/commands/work/test.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/work/test.ts)_
 
 ## `agentia work update [ID]`
 
@@ -2101,5 +2185,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.27.0-alpha.0/src/commands/work/update.ts)_
+_See code: [src/commands/work/update.ts](https://github.com/Copado/agentia-cli/blob/v0.29.0-alpha.0/src/commands/work/update.ts)_
 <!-- commandsstop -->