@copado/agentia-cli 0.16.0-alpha.0 → 0.18.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.16.0-alpha.0 linux-x64 node-v22.23.2
+@copado/agentia-cli/0.18.0-alpha.0 linux-x64 node-v22.23.2
 $ agentia --help [COMMAND]
 USAGE
   $ agentia COMMAND
@@ -170,9 +170,13 @@ Agentia CLI is distributed under the Copado End User License Agreement. See [LIC
 * [`agentia user get`](#agentia-user-get)
 * [`agentia work create`](#agentia-work-create)
 * [`agentia work delete ID`](#agentia-work-delete-id)
-* [`agentia work get ID`](#agentia-work-get-id)
+* [`agentia work done`](#agentia-work-done)
+* [`agentia work get [ID]`](#agentia-work-get-id)
 * [`agentia work list`](#agentia-work-list)
-* [`agentia work update ID`](#agentia-work-update-id)
+* [`agentia work push`](#agentia-work-push)
+* [`agentia work set ID`](#agentia-work-set-id)
+* [`agentia work submit`](#agentia-work-submit)
+* [`agentia work update [ID]`](#agentia-work-update-id)
 
 ## `agentia auth get`
 
@@ -204,7 +208,7 @@ EXAMPLES
   $ agentia auth get --json
 ```
 
-_See code: [src/commands/auth/get.ts](https://github.com/Copado/agentia-cli/blob/v0.16.0-alpha.0/src/commands/auth/get.ts)_
+_See code: [src/commands/auth/get.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/auth/get.ts)_
 
 ## `agentia auth set`
 
@@ -242,7 +246,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.16.0-alpha.0/src/commands/auth/set.ts)_
+_See code: [src/commands/auth/set.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/auth/set.ts)_
 
 ## `agentia environment auth status ID`
 
@@ -272,7 +276,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.16.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.18.0-alpha.0/src/commands/environment/auth/status.ts)_
 
 ## `agentia environment auth web login ID`
 
@@ -306,7 +310,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.16.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.18.0-alpha.0/src/commands/environment/auth/web/login.ts)_
 
 ## `agentia environment create NAME`
 
@@ -351,7 +355,7 @@ EXAMPLES
   $ agentia environment create Dev --json
 ```
 
-_See code: [src/commands/environment/create.ts](https://github.com/Copado/agentia-cli/blob/v0.16.0-alpha.0/src/commands/environment/create.ts)_
+_See code: [src/commands/environment/create.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/environment/create.ts)_
 
 ## `agentia environment get ID`
 
@@ -376,7 +380,7 @@ EXAMPLES
   $ agentia environment get a0SKC000000CmZ2AU --json
 ```
 
-_See code: [src/commands/environment/get.ts](https://github.com/Copado/agentia-cli/blob/v0.16.0-alpha.0/src/commands/environment/get.ts)_
+_See code: [src/commands/environment/get.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/environment/get.ts)_
 
 ## `agentia environment list`
 
@@ -408,7 +412,7 @@ EXAMPLES
   $ agentia environment list --json
 ```
 
-_See code: [src/commands/environment/list.ts](https://github.com/Copado/agentia-cli/blob/v0.16.0-alpha.0/src/commands/environment/list.ts)_
+_See code: [src/commands/environment/list.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/environment/list.ts)_
 
 ## `agentia environment update ID`
 
@@ -454,7 +458,7 @@ EXAMPLES
   $ agentia environment update a0SKC000000CmZ2AU --name UAT --json
 ```
 
-_See code: [src/commands/environment/update.ts](https://github.com/Copado/agentia-cli/blob/v0.16.0-alpha.0/src/commands/environment/update.ts)_
+_See code: [src/commands/environment/update.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/environment/update.ts)_
 
 ## `agentia help [COMMAND]`
 
@@ -503,7 +507,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.16.0-alpha.0/src/commands/job/get.ts)_
+_See code: [src/commands/job/get.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/job/get.ts)_
 
 ## `agentia job kill ID`
 
@@ -532,7 +536,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.16.0-alpha.0/src/commands/job/kill.ts)_
+_See code: [src/commands/job/kill.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/job/kill.ts)_
 
 ## `agentia job list`
 
@@ -570,7 +574,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.16.0-alpha.0/src/commands/job/list.ts)_
+_See code: [src/commands/job/list.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/job/list.ts)_
 
 ## `agentia job pause ID`
 
@@ -599,7 +603,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.16.0-alpha.0/src/commands/job/pause.ts)_
+_See code: [src/commands/job/pause.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/job/pause.ts)_
 
 ## `agentia job resume ID`
 
@@ -628,7 +632,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.16.0-alpha.0/src/commands/job/resume.ts)_
+_See code: [src/commands/job/resume.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/job/resume.ts)_
 
 ## `agentia job run ID`
 
@@ -658,7 +662,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.16.0-alpha.0/src/commands/job/run.ts)_
+_See code: [src/commands/job/run.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/job/run.ts)_
 
 ## `agentia mcp start`
 
@@ -677,7 +681,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.16.0-alpha.0/src/commands/mcp/start.ts)_
+_See code: [src/commands/mcp/start.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/mcp/start.ts)_
 
 ## `agentia metadata content compare`
 
@@ -720,7 +724,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.16.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.18.0-alpha.0/src/commands/metadata/content/compare.ts)_
 
 ## `agentia metadata content get`
 
@@ -761,7 +765,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.16.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.18.0-alpha.0/src/commands/metadata/content/get.ts)_
 
 ## `agentia metadata dependency list`
 
@@ -809,7 +813,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.16.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.18.0-alpha.0/src/commands/metadata/dependency/list.ts)_
 
 ## `agentia metadata index compare`
 
@@ -843,7 +847,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.16.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.18.0-alpha.0/src/commands/metadata/index/compare.ts)_
 
 ## `agentia metadata list`
 
@@ -891,7 +895,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.16.0-alpha.0/src/commands/metadata/list.ts)_
+_See code: [src/commands/metadata/list.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/metadata/list.ts)_
 
 ## `agentia metadata refresh deleted`
 
@@ -923,7 +927,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.16.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.18.0-alpha.0/src/commands/metadata/refresh/deleted.ts)_
 
 ## `agentia metadata refresh run`
 
@@ -966,7 +970,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.16.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.18.0-alpha.0/src/commands/metadata/refresh/run.ts)_
 
 ## `agentia metadata refresh status`
 
@@ -998,7 +1002,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.16.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.18.0-alpha.0/src/commands/metadata/refresh/status.ts)_
 
 ## `agentia pipeline connection list`
 
@@ -1025,7 +1029,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.16.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.18.0-alpha.0/src/commands/pipeline/connection/list.ts)_
 
 ## `agentia pipeline get ID`
 
@@ -1054,7 +1058,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.16.0-alpha.0/src/commands/pipeline/get.ts)_
+_See code: [src/commands/pipeline/get.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/pipeline/get.ts)_
 
 ## `agentia pipeline list`
 
@@ -1080,7 +1084,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.16.0-alpha.0/src/commands/pipeline/list.ts)_
+_See code: [src/commands/pipeline/list.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/pipeline/list.ts)_
 
 ## `agentia plugins`
 
@@ -1407,7 +1411,7 @@ EXAMPLES
   $ agentia project default get --json
 ```
 
-_See code: [src/commands/project/default/get.ts](https://github.com/Copado/agentia-cli/blob/v0.16.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.18.0-alpha.0/src/commands/project/default/get.ts)_
 
 ## `agentia project default set`
 
@@ -1444,7 +1448,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.16.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.18.0-alpha.0/src/commands/project/default/set.ts)_
 
 ## `agentia project default unset`
 
@@ -1481,7 +1485,7 @@ EXAMPLES
   $ agentia project default unset --project --json
 ```
 
-_See code: [src/commands/project/default/unset.ts](https://github.com/Copado/agentia-cli/blob/v0.16.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.18.0-alpha.0/src/commands/project/default/unset.ts)_
 
 ## `agentia project list`
 
@@ -1508,7 +1512,7 @@ EXAMPLES
   $ agentia project list --mine --json
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/Copado/agentia-cli/blob/v0.16.0-alpha.0/src/commands/project/list.ts)_
+_See code: [src/commands/project/list.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/project/list.ts)_
 
 ## `agentia promotion conflict get ID`
 
@@ -1539,7 +1543,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.16.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.18.0-alpha.0/src/commands/promotion/conflict/get.ts)_
 
 ## `agentia promotion conflict list`
 
@@ -1564,7 +1568,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.16.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.18.0-alpha.0/src/commands/promotion/conflict/list.ts)_
 
 ## `agentia promotion conflict resolve ID`
 
@@ -1597,7 +1601,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.16.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.18.0-alpha.0/src/commands/promotion/conflict/resolve.ts)_
 
 ## `agentia promotion conflict unresolve ID`
 
@@ -1625,7 +1629,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.16.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.18.0-alpha.0/src/commands/promotion/conflict/unresolve.ts)_
 
 ## `agentia promotion get ID`
 
@@ -1650,7 +1654,7 @@ EXAMPLES
   $ agentia promotion get <promotion-id> --json
 ```
 
-_See code: [src/commands/promotion/get.ts](https://github.com/Copado/agentia-cli/blob/v0.16.0-alpha.0/src/commands/promotion/get.ts)_
+_See code: [src/commands/promotion/get.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/promotion/get.ts)_
 
 ## `agentia promotion list`
 
@@ -1693,7 +1697,7 @@ EXAMPLES
   $ agentia promotion list --json
 ```
 
-_See code: [src/commands/promotion/list.ts](https://github.com/Copado/agentia-cli/blob/v0.16.0-alpha.0/src/commands/promotion/list.ts)_
+_See code: [src/commands/promotion/list.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/promotion/list.ts)_
 
 ## `agentia user get`
 
@@ -1722,7 +1726,7 @@ EXAMPLES
   $ agentia user get --json
 ```
 
-_See code: [src/commands/user/get.ts](https://github.com/Copado/agentia-cli/blob/v0.16.0-alpha.0/src/commands/user/get.ts)_
+_See code: [src/commands/user/get.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/user/get.ts)_
 
 ## `agentia work create`
 
@@ -1777,7 +1781,7 @@ EXAMPLES
   $ agentia work create --title "My story" --json
 ```
 
-_See code: [src/commands/work/create.ts](https://github.com/Copado/agentia-cli/blob/v0.16.0-alpha.0/src/commands/work/create.ts)_
+_See code: [src/commands/work/create.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/work/create.ts)_
 
 ## `agentia work delete ID`
 
@@ -1802,18 +1806,41 @@ EXAMPLES
   $ agentia work delete a0SKC000000CmZ2AU --json
 ```
 
-_See code: [src/commands/work/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.16.0-alpha.0/src/commands/work/delete.ts)_
+_See code: [src/commands/work/delete.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/work/delete.ts)_
 
-## `agentia work get ID`
+## `agentia work done`
+
+Mark the current feature/US-XXXX work item done and promote it to the next environment. Pushes and registers commits when the branch is ahead of origin, then calls headless work/done (Promote Action with validate=false).
+
+```
+USAGE
+  $ agentia work done [--json]
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Mark the current feature/US-XXXX work item done and promote it to the next environment. Pushes and registers commits
+  when the branch is ahead of origin, then calls headless work/done (Promote Action with validate=false).
+
+EXAMPLES
+  $ agentia work done
+
+  $ agentia work done --json
+```
+
+_See code: [src/commands/work/done.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/work/done.ts)_
+
+## `agentia work get [ID]`
 
 Get a Copado user story by ID
 
 ```
 USAGE
-  $ agentia work get ID [--json]
+  $ agentia work get [ID] [--json]
 
 ARGUMENTS
-  ID  User story ID
+  [ID]  User story ID (defaults to the active work item from `work set`)
 
 GLOBAL FLAGS
   --json  Format output as json.
@@ -1822,12 +1849,14 @@ DESCRIPTION
   Get a Copado user story by ID
 
 EXAMPLES
+  $ agentia work get
+
   $ agentia work get a0SKC000000CmZ2AU
 
   $ agentia work get a0SKC000000CmZ2AU --json
 ```
 
-_See code: [src/commands/work/get.ts](https://github.com/Copado/agentia-cli/blob/v0.16.0-alpha.0/src/commands/work/get.ts)_
+_See code: [src/commands/work/get.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/work/get.ts)_
 
 ## `agentia work list`
 
@@ -1870,15 +1899,93 @@ EXAMPLES
   $ agentia work list --json
 ```
 
-_See code: [src/commands/work/list.ts](https://github.com/Copado/agentia-cli/blob/v0.16.0-alpha.0/src/commands/work/list.ts)_
+_See code: [src/commands/work/list.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/work/list.ts)_
+
+## `agentia work push`
 
-## `agentia work update ID`
+Push the current feature/US-XXXX branch and register commits with Copado. Requires a clean working tree and a base branch from `agentia work set`. Locks the tip commit, runs `git push origin <branch>`, then calls headless work/push.
+
+```
+USAGE
+  $ agentia work push [--json]
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Push the current feature/US-XXXX branch and register commits with Copado. Requires a clean working tree and a base
+  branch from `agentia work set`. Locks the tip commit, runs `git push origin <branch>`, then calls headless work/push.
+
+EXAMPLES
+  $ agentia work push
+
+  $ agentia work push --json
+```
+
+_See code: [src/commands/work/push.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/work/push.ts)_
+
+## `agentia work set ID`
+
+Set the active work item and prepare a local feature branch. Calls the CICD gateway work/set endpoint, requires a clean tracked working tree, fetches the work item base branch from origin, then creates or checks out feature/<user-story-name>.
+
+```
+USAGE
+  $ agentia work set ID [--json] [--base-branch <value>]
+
+ARGUMENTS
+  ID  User story ID or name
+
+FLAGS
+  --base-branch=<value>  Override the base branch returned by the work/set endpoint
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Set the active work item and prepare a local feature branch. Calls the CICD gateway work/set endpoint, requires a
+  clean tracked working tree, fetches the work item base branch from origin, then creates or checks out
+  feature/<user-story-name>.
+
+EXAMPLES
+  $ agentia work set a0SKC000000CmZ2AU
+
+  $ agentia work set US-0001 --json
+
+  $ agentia work set US-0001 --base-branch develop
+```
+
+_See code: [src/commands/work/set.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/work/set.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).
+
+```
+USAGE
+  $ agentia work submit [--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).
+
+EXAMPLES
+  $ agentia work submit
+
+  $ agentia work submit --json
+```
+
+_See code: [src/commands/work/submit.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/work/submit.ts)_
+
+## `agentia work update [ID]`
 
 Update a Copado user story by ID
 
 ```
 USAGE
-  $ agentia work update ID [--json] [--excluded-from-cbm] [--actual-points <value>] [--planned-points <value>]
+  $ agentia work update [ID] [--json] [--excluded-from-cbm] [--actual-points <value>] [--planned-points <value>]
     [--priority <value>] [--acceptance-criteria <value>] [--as-a <value>] [--assignee <value>] [--cancellation-reason
     <value>] [--close-date <value>] [--epic <value>] [--feature <value>] [--functional-requirements <value>] [--owner-id
     <value>] [--project <value>] [--record-type <value>] [--release-id <value>] [--so-that <value>] [--source-credential
@@ -1886,7 +1993,7 @@ USAGE
     [--technical-specifications <value>] [--theme <value>] [--title <value>] [--want-to <value>]
 
 ARGUMENTS
-  ID  User story ID
+  [ID]  User story ID (defaults to the active work item from `work set`)
 
 FLAGS
   --acceptance-criteria=<value>       Acceptance criteria
@@ -1923,10 +2030,12 @@ DESCRIPTION
   Update a Copado user story by ID
 
 EXAMPLES
+  $ agentia work update --title "Updated story"
+
   $ agentia work update a0SKC000000CmZ2AU --title "Updated story"
 
   $ agentia work update a0SKC000000CmZ2AU --status "In Progress" --json
 ```
 
-_See code: [src/commands/work/update.ts](https://github.com/Copado/agentia-cli/blob/v0.16.0-alpha.0/src/commands/work/update.ts)_
+_See code: [src/commands/work/update.ts](https://github.com/Copado/agentia-cli/blob/v0.18.0-alpha.0/src/commands/work/update.ts)_
 <!-- commandsstop -->

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

@@ -3,6 +3,7 @@ import { type CredentialType } from '../../lib/credential-store.js';
 export type AuthCredentialResult = {
     baseUrl?: null | string;
     label: string;
+    local?: boolean;
     masked?: string;
     set: boolean;
     type: CredentialType;
@@ -18,6 +19,7 @@ export default class AuthGet extends AgentiaCommand {
         crt: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<AuthGetResult>;
+    private buildCicdCredentialResult;
     private buildCredentialResult;
     private formatCredentialLine;
 }

package/dist/commands/auth/get.js

@@ -1,6 +1,7 @@
 import { Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../lib/agentia-command.js';
 import { ALL_CREDENTIAL_TYPES, credentialLabel, getCicdBaseUrl, getCredential, maskSecret, } from '../../lib/credential-store.js';
+import { normalizeLocalGatewayBaseUrl, readLocalGatewayConfig } from '../../lib/local-gateway-config.js';
 export default class AuthGet extends AgentiaCommand {
     static description = 'Show stored authentication credentials from the system keychain';
     static examples = [
@@ -34,21 +35,54 @@ export default class AuthGet extends AgentiaCommand {
         }
         return { credentials };
     }
-    buildCredentialResult(type) {
-        const credential = getCredential(type);
+    buildCicdCredentialResult() {
+        const localConfig = readLocalGatewayConfig();
+        const label = credentialLabel('cicd');
+        if (localConfig.enabled) {
+            const apiKey = localConfig.apiKey || getCredential('cicd');
+            if (apiKey === null || apiKey.trim().length === 0) {
+                return {
+                    baseUrl: normalizeLocalGatewayBaseUrl(localConfig.url),
+                    label,
+                    local: true,
+                    set: false,
+                    type: 'cicd',
+                };
+            }
+            return {
+                baseUrl: normalizeLocalGatewayBaseUrl(localConfig.url),
+                label,
+                local: true,
+                masked: maskSecret(apiKey),
+                set: true,
+                type: 'cicd',
+            };
+        }
+        const credential = getCredential('cicd');
         if (credential === null) {
             return {
-                label: credentialLabel(type),
+                label,
                 set: false,
-                type,
+                type: 'cicd',
             };
         }
+        return {
+            baseUrl: getCicdBaseUrl(),
+            label,
+            masked: maskSecret(credential),
+            set: true,
+            type: 'cicd',
+        };
+    }
+    buildCredentialResult(type) {
         if (type === 'cicd') {
+            return this.buildCicdCredentialResult();
+        }
+        const credential = getCredential(type);
+        if (credential === null) {
             return {
-                baseUrl: getCicdBaseUrl(),
                 label: credentialLabel(type),
-                masked: maskSecret(credential),
-                set: true,
+                set: false,
                 type,
             };
         }
@@ -61,11 +95,15 @@ export default class AuthGet extends AgentiaCommand {
     }
     formatCredentialLine(credential) {
         if (!credential.set) {
+            if (credential.type === 'cicd' && credential.local && credential.baseUrl) {
+                return `${credential.label}: not set (endpoint: ${credential.baseUrl}, local)`;
+            }
             return `${credential.label}: not set`;
         }
         if (credential.type === 'cicd') {
             const endpointLabel = credential.baseUrl === null || credential.baseUrl === undefined ? 'not set' : credential.baseUrl;
-            return `${credential.label}: ${credential.masked} (endpoint: ${endpointLabel})`;
+            const localSuffix = credential.local ? ', local' : '';
+            return `${credential.label}: ${credential.masked} (endpoint: ${endpointLabel}${localSuffix})`;
         }
         return `${credential.label}: ${credential.masked}`;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/auth/get.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/auth/get.ts"],"names":[],"mappings":"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"}

package/dist/commands/work/done.d.ts

@@ -0,0 +1,7 @@
+import { AgentiaCommand } from '../../lib/agentia-command.js';
+import { type WorkDoneResult } from '../../lib/work-types.js';
+export default class WorkDone extends AgentiaCommand {
+    static description: string;
+    static examples: string[];
+    run(): Promise<WorkDoneResult>;
+}