@copado/agentia-cli 1.0.0-beta.1 → 1.0.0-beta.4

package/oclif.manifest.json

@@ -1,5 +1,35 @@
 {
   "commands": {
+    "runtime": {
+      "aliases": [],
+      "args": {},
+      "description": "Start a stdio NDJSON runtime for in-process Agentia command invokes",
+      "flags": {
+        "idle-ms": {
+          "description": "Exit after this many idle milliseconds with no in-flight requests",
+          "name": "idle-ms",
+          "default": 600000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "runtime",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "runtime.js"
+      ]
+    },
     "setup": {
       "aliases": [],
       "args": {},
@@ -324,6 +354,57 @@
         "unset.js"
       ]
     },
+    "cicd:health-check": {
+      "aliases": [],
+      "args": {},
+      "description": "Run organization-scoped governance health checks",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --json",
+        "<%= config.bin %> <%= command.id %> --git-sizer",
+        "<%= config.bin %> <%= command.id %> --git-sizer --path /path/to/clone"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "git-sizer": {
+          "description": "Also analyze a local Git clone with git-sizer",
+          "name": "git-sizer",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "path": {
+          "dependsOn": [
+            "git-sizer"
+          ],
+          "description": "Local Git clone for --git-sizer. Defaults to the current directory.",
+          "name": "path",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:health-check",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "health-check.js"
+      ]
+    },
     "mcp:start": {
       "aliases": [],
       "args": {},
@@ -1772,14 +1853,21 @@
         "update.js"
       ]
     },
-    "cicd:credential:create": {
+    "cicd:cloud:commit": {
       "aliases": [],
-      "args": {},
-      "description": "Create a Copado environment credential",
+      "args": {
+        "id": {
+          "description": "User story ID (defaults to the active work item from `work set`)",
+          "name": "id",
+          "required": false
+        }
+      },
+      "description": "Create a Copado cloud metadata commit for a user story. Preflights the story, submits POST /release/commit, and polls the job monitor by default. For local Git work, use git add/commit then `cicd work publish`. Permission and full-metadata selections belong on `cicd work publish`.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\"",
-        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\" --default",
-        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\" --json"
+        "<%= config.bin %> <%= command.id %> --message \"Commit AccountService\" --metadata-name AccountService --metadata-type ApexClass --metadata-category SFDX --action Add",
+        "<%= config.bin %> <%= command.id %> a07XXXXXXXXXXXXXXX --message \"Update Aura files\" --metadata-name accountEditor --metadata-type AuraDefinitionBundle --metadata-category SFDX --action SelectiveCommit --selection accountEditor/accountEditor.cmp --selection accountEditor/accountEditorController.js",
+        "<%= config.bin %> <%= command.id %> --file commit-request.json  # {\"message\":\"Commit AccountService\",\"changes\":[{\"a\":\"Add\",\"c\":\"SFDX\",\"n\":\"AccountService\",\"t\":\"ApexClass\"}]}",
+        "cat commit-request.json | <%= config.bin %> <%= command.id %> --stdin --json"
       ],
       "flags": {
         "json": {
@@ -1789,67 +1877,127 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "default": {
-          "description": "Mark this credential as the environment default",
-          "name": "default",
+        "action": {
+          "description": "Metadata action for simple flag input. Defaults to Add.",
+          "name": "action",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "Add",
+            "Delete",
+            "RetrieveOnly",
+            "SelectiveCommit",
+            "Full"
+          ],
+          "type": "option"
+        },
+        "base-branch": {
+          "description": "Optional base branch to include in the commit request.",
+          "name": "base-branch",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cloud": {
+          "description": "Ignored. Cloud is implied by cicd cloud commit.",
+          "hidden": true,
+          "name": "cloud",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "commit-id": {
+          "description": "Existing local Git commit identifier to register when --no-execute-commit is used.",
+          "name": "commit-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "execute-commit": {
+          "description": "Execute the Copado commit job. Use --no-execute-commit only with --commit-id.",
+          "name": "execute-commit",
           "allowNo": true,
           "type": "boolean"
         },
-        "environmentid": {
-          "description": "Copado environment ID",
-          "name": "environmentid",
-          "required": true,
+        "file": {
+          "char": "f",
+          "description": "Path to a JSON commit request body.",
+          "name": "file",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "Credential name",
-          "name": "name",
-          "required": true,
+        "message": {
+          "char": "m",
+          "description": "Commit message. Required unless provided by JSON input.",
+          "name": "message",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cicd:credential:create",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "credential",
-        "create.js"
-      ]
-    },
-    "cicd:credential:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List credentials for a Copado environment",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --environmentid <environment-id>",
-        "<%= config.bin %> <%= command.id %> --environmentid \"Dev Sandbox\"",
-        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
+        },
+        "metadata-category": {
+          "description": "Metadata category for simple input. Maps to change field c. For Salesforce metadata, always set SFDX so Copado stores c:SFDX. Omitting it omits c, and SFDX deploy steps log \"Salesforce changes not found.\" and skip the deploy while the job can still report Successful.",
+          "name": "metadata-category",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metadata-message": {
+          "description": "Optional per-change message for simple flag input.",
+          "name": "metadata-message",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metadata-name": {
+          "description": "Metadata full name for simple flag input.",
+          "name": "metadata-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metadata-raw-json": {
+          "description": "Optional raw metadata JSON value for simple flag input.",
+          "name": "metadata-raw-json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metadata-type": {
+          "description": "Metadata type for simple flag input, for example ApexClass.",
+          "name": "metadata-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "recreate-feature-branch": {
+          "description": "Ask Copado to recreate the feature branch before committing.",
+          "name": "recreate-feature-branch",
           "allowNo": false,
           "type": "boolean"
         },
-        "environmentid": {
-          "description": "Copado environment ID",
-          "name": "environmentid",
-          "required": true,
+        "selection": {
+          "description": "Selected file inside a bundle for SelectiveCommit. Can be provided multiple times.",
+          "name": "selection",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "stdin": {
+          "description": "Read a JSON commit request body from stdin.",
+          "name": "stdin",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "wait": {
+          "description": "Poll the commit job to a terminal status when a jobExecution Id is returned.",
+          "name": "wait",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "wait-timeout": {
+          "description": "Maximum seconds to wait for the commit job.",
+          "name": "wait-timeout",
+          "default": 300,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1857,7 +2005,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:credential:list",
+      "id": "cicd:cloud:commit",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -1868,24 +2016,24 @@
         "dist",
         "commands",
         "cicd",
-        "credential",
-        "list.js"
+        "cloud",
+        "commit.js"
       ]
     },
-    "cicd:credential:update": {
+    "cicd:cloud:promote": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Copado credential ID",
+          "description": "User Story ID (defaults to the active work item from `work set`)",
           "name": "id",
-          "required": true
+          "required": false
         }
       },
-      "description": "Update a Copado environment credential by ID",
+      "description": "Promote the explicit or active User Story through its Copado Promotion. Selects promote-only unless --deploy is passed.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --name \"CI User\"",
-        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --default",
-        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --no-default --json"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> a07XXXXXXXXXXXXXXX --promotion-id a0BXXXXXXXXXXXXXXX",
+        "<%= config.bin %> <%= command.id %> --deploy --json"
       ],
       "flags": {
         "json": {
@@ -1895,21 +2043,223 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "default": {
-          "description": "Mark this credential as the environment default",
-          "name": "default",
-          "allowNo": true,
+        "cloud": {
+          "description": "Ignored. Cloud is implied by cicd cloud promote.",
+          "hidden": true,
+          "name": "cloud",
+          "allowNo": false,
           "type": "boolean"
         },
-        "environmentid": {
-          "description": "Copado environment ID",
-          "name": "environmentid",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
+        "deploy": {
+          "description": "Use merge_and_deploy instead of promote-only merge.",
+          "name": "deploy",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "deployment-step-id": {
+          "description": "Ordered deployment-step Salesforce ID. Can be provided multiple times with --deploy.",
+          "name": "deployment-step-id",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "ignored-metadata-json": {
+          "description": "JSON array to persist through ignored-metadata before starting the promotion.",
+          "name": "ignored-metadata-json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "promotion-id": {
+          "description": "Explicit 18-character Promotion ID when the User Story belongs to multiple promotions.",
+          "name": "promotion-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "recreate-promotion-branch": {
+          "description": "Recreate the promotion branch before execution. Requires confirmation or --yes.",
+          "name": "recreate-promotion-branch",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "wait": {
+          "description": "Poll promotion and deployment executions to terminal status.",
+          "name": "wait",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "wait-timeout": {
+          "description": "Maximum total seconds to wait for promotion and deployment executions.",
+          "name": "wait-timeout",
+          "default": 900,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Confirm promotion branch recreation without prompting.",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:cloud:promote",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "cloud",
+        "promote.js"
+      ]
+    },
+    "cicd:credential:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a Copado environment credential",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\"",
+        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\" --default",
+        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\" --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "default": {
+          "description": "Mark this credential as the environment default",
+          "name": "default",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "environmentid": {
+          "description": "Copado environment ID",
+          "name": "environmentid",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Credential name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:credential:create",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "credential",
+        "create.js"
+      ]
+    },
+    "cicd:credential:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List credentials for a Copado environment",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --environmentid <environment-id>",
+        "<%= config.bin %> <%= command.id %> --environmentid \"Dev Sandbox\"",
+        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "environmentid": {
+          "description": "Copado environment ID",
+          "name": "environmentid",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:credential:list",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "credential",
+        "list.js"
+      ]
+    },
+    "cicd:credential:update": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Copado credential ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update a Copado environment credential by ID",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --name \"CI User\"",
+        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --default",
+        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --no-default --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "default": {
+          "description": "Mark this credential as the environment default",
+          "name": "default",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "environmentid": {
+          "description": "Copado environment ID",
+          "name": "environmentid",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
           "description": "Credential name",
           "name": "name",
           "hasDynamicHelp": false,
@@ -4631,9 +4981,9 @@
           "required": true
         }
       },
-      "description": "Create a Copado Git repository",
+      "description": "Create a Copado Git repository shell",
       "examples": [
-        "<%= config.bin %> <%= command.id %> my-repo --source-format DX --provider Github --uri https://github.com/org/repo.git",
+        "<%= config.bin %> <%= command.id %> my-repo --source-format DX --provider Github",
         "<%= config.bin %> <%= command.id %> my-repo --source-format DX --provider GitLab --json"
       ],
       "flags": {
@@ -4656,97 +5006,33 @@
           "allowNo": true,
           "type": "boolean"
         },
-        "auth-type": {
-          "description": "Repository authentication type",
-          "name": "auth-type",
+        "provider": {
+          "description": "Git repository provider",
+          "name": "provider",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "HTTPS"
+            "Github",
+            "Bitbucket",
+            "GitLab",
+            "Azure",
+            "Microsoft Team Service",
+            "Copado Version Control",
+            "Others"
           ],
           "type": "option"
         },
-        "branch-base-url": {
-          "description": "Base URL for repository branch links",
-          "name": "branch-base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "commit-base-url": {
-          "description": "Base URL for repository commit links",
-          "name": "commit-base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "extra-headers": {
-          "description": "Additional authentication headers. Prefer environment-specific credential storage when available.",
-          "name": "extra-headers",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "password": {
-          "description": "Repository password or token. This can be visible in shell history.",
-          "name": "password",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "pull-request-base-url": {
-          "description": "Base URL for repository pull request links",
-          "name": "pull-request-base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "tag-base-url": {
-          "description": "Base URL for repository tag links",
-          "name": "tag-base-url",
+        "source-format": {
+          "description": "Git repository source format (default: DX)",
+          "name": "source-format",
+          "default": "DX",
           "hasDynamicHelp": false,
           "multiple": false,
-          "type": "option"
-        },
-        "uri": {
-          "description": "Repository clone URI",
-          "name": "uri",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "username": {
-          "description": "Repository username",
-          "name": "username",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "provider": {
-          "description": "Git repository provider",
-          "name": "provider",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "Github",
-            "Bitbucket",
-            "GitLab",
-            "Microsoft Team Service",
-            "Copado Version Control",
-            "Others"
-          ],
-          "type": "option"
-        },
-        "source-format": {
-          "description": "Git repository source format",
-          "name": "source-format",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "DX"
-          ],
+          "options": [
+            "Metadata",
+            "DX"
+          ],
           "type": "option"
         }
       },
@@ -4896,6 +5182,7 @@
             "Github",
             "Bitbucket",
             "GitLab",
+            "Azure",
             "Microsoft Team Service",
             "Copado Version Control",
             "Others"
@@ -4908,6 +5195,7 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
+            "Metadata",
             "DX"
           ],
           "type": "option"
@@ -4979,10 +5267,10 @@
           "required": true
         }
       },
-      "description": "Reset a Copado Git repository",
+      "description": "Reset a Copado Git repository and its authentication configuration",
       "examples": [
-        "<%= config.bin %> <%= command.id %> repo-001",
-        "<%= config.bin %> <%= command.id %> repo-001 --json"
+        "<%= config.bin %> <%= command.id %> repo-001 --yes",
+        "<%= config.bin %> <%= command.id %> repo-001 --yes --json"
       ],
       "flags": {
         "json": {
@@ -4991,6 +5279,13 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Confirm reset without prompting",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -5022,7 +5317,7 @@
       "description": "Update a Copado Git repository by ID",
       "examples": [
         "<%= config.bin %> <%= command.id %> repo-001 --uri https://github.com/org/repo.git",
-        "<%= config.bin %> <%= command.id %> repo-001 --clear-password",
+        "<%= config.bin %> <%= command.id %> repo-001 --clear-uri",
         "<%= config.bin %> <%= command.id %> repo-001 --provider GitLab --json"
       ],
       "flags": {
@@ -5057,18 +5352,6 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "clear-extra-headers": {
-          "description": "Clear additional repository headers",
-          "name": "clear-extra-headers",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "clear-password": {
-          "description": "Clear the repository password or token",
-          "name": "clear-password",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "clear-pull-request-base-url": {
           "description": "Clear the repository pull request base URL",
           "name": "clear-pull-request-base-url",
@@ -5087,22 +5370,6 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "clear-username": {
-          "description": "Clear the repository username",
-          "name": "clear-username",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "auth-type": {
-          "description": "Repository authentication type",
-          "name": "auth-type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "HTTPS"
-          ],
-          "type": "option"
-        },
         "branch-base-url": {
           "description": "Base URL for repository branch links",
           "name": "branch-base-url",
@@ -5117,20 +5384,6 @@
           "multiple": false,
           "type": "option"
         },
-        "extra-headers": {
-          "description": "Additional authentication headers. Prefer environment-specific credential storage when available.",
-          "name": "extra-headers",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "password": {
-          "description": "Repository password or token. This can be visible in shell history.",
-          "name": "password",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "pull-request-base-url": {
           "description": "Base URL for repository pull request links",
           "name": "pull-request-base-url",
@@ -5152,13 +5405,6 @@
           "multiple": false,
           "type": "option"
         },
-        "username": {
-          "description": "Repository username",
-          "name": "username",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "name": {
           "description": "Repository name",
           "name": "name",
@@ -5175,6 +5421,7 @@
             "Github",
             "Bitbucket",
             "GitLab",
+            "Azure",
             "Microsoft Team Service",
             "Copado Version Control",
             "Others"
@@ -5187,6 +5434,7 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
+            "Metadata",
             "DX"
           ],
           "type": "option"
@@ -5585,12 +5833,10 @@
           "required": false
         }
       },
-      "description": "Create a Copado cloud metadata commit for a user story. Requires --cloud: preflights the story, submits POST /release/commit, and polls the job monitor by default. For local Git work, use git add/commit then `cicd work publish`. Permission and full-metadata selections belong on `cicd work publish`.",
+      "description": "Compatibility alias of cicd cloud commit. Create a Copado cloud metadata commit for a user story. Prefer: agentia cicd cloud commit.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --cloud --message \"Commit AccountService\" --metadata-name AccountService --metadata-type ApexClass --metadata-category SFDX --action Add",
-        "<%= config.bin %> <%= command.id %> a07XXXXXXXXXXXXXXX --cloud --message \"Update Aura files\" --metadata-name accountEditor --metadata-type AuraDefinitionBundle --metadata-category SFDX --action SelectiveCommit --selection accountEditor/accountEditor.cmp --selection accountEditor/accountEditorController.js",
-        "<%= config.bin %> <%= command.id %> --cloud --file commit-request.json  # {\"message\":\"Commit AccountService\",\"changes\":[{\"a\":\"Add\",\"c\":\"SFDX\",\"n\":\"AccountService\",\"t\":\"ApexClass\"}]}",
-        "cat commit-request.json | <%= config.bin %> <%= command.id %> --cloud --stdin --json"
+        "<%= config.bin %> cicd cloud commit --message \"Commit AccountService\" --metadata-name AccountService --metadata-type ApexClass --metadata-category SFDX --action Add",
+        "<%= config.bin %> <%= command.id %> --cloud --message \"Commit AccountService\" --metadata-name AccountService --metadata-type ApexClass --metadata-category SFDX --action Add"
       ],
       "flags": {
         "json": {
@@ -5622,7 +5868,8 @@
           "type": "option"
         },
         "cloud": {
-          "description": "Create a Copado cloud metadata commit (POST /release/commit). Required. For local Git work, use git commit then `cicd work publish`.",
+          "description": "Ignored. Cloud is implied by cicd cloud commit.",
+          "hidden": true,
           "name": "cloud",
           "allowNo": false,
           "type": "boolean"
@@ -5726,6 +5973,7 @@
         }
       },
       "hasDynamicHelp": false,
+      "hidden": true,
       "hiddenAliases": [],
       "id": "cicd:work:commit",
       "pluginAlias": "@copado/agentia-cli",
@@ -6039,6 +6287,102 @@
         "done.js"
       ]
     },
+    "cicd:work:environment-sync": {
+      "aliases": [],
+      "args": {},
+      "description": "Sync committed metadata from the next environment onto the destination environment (or current feature branch). Back-promotes every user story behind the destination environment from the next environment branch. GET user stories ahead and behind. If none are behind, log that and stop. Otherwise create a back-promotion and POST those behind stories onto the promotion. Resolves the next-environment Git branch from --destination-environment or --dev-org-branch (the dest pipeline connection destinationBranch, or that destination environment's outbound branch). Merges origin/<next-env> with --no-ff --no-commit, restores every other path from HEAD, commits the guessed pathspecs, and pushes the dest org branch (and the feature branch when HEAD starts with feature/). If guessed pathspecs still conflict, PATCH the back-promotion status to Merge Conflict, resolve the files, and re-run with --promotion and --continue. The promotion destination environment supplies the dest org branch and the next-env branch. To discard a conflicted merge, re-run with --promotion and --abort (runs git merge --abort and sets the back-promotion status to Draft). After a successful sync, PATCH the back-promotion status to Completed.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --destination-environment=dev1",
+        "<%= config.bin %> <%= command.id %> --dev-org-branch=dev1-sfp",
+        "<%= config.bin %> <%= command.id %> --promotion=P29334 --continue",
+        "<%= config.bin %> <%= command.id %> --promotion=P29334 --abort",
+        "<%= config.bin %> <%= command.id %> --destination-environment=dev1 --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "abort": {
+          "description": "Abort an in-progress merge (`git merge --abort`) and set the back-promotion status to Draft. Requires --promotion. Exclusive with --continue.",
+          "exclusive": [
+            "continue"
+          ],
+          "name": "abort",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "continue": {
+          "description": "Finish after merge conflicts. If the merge is still in progress (conflicts fixed and staged, but not committed), commits it; if you already committed, continues from there through the remaining git steps.",
+          "exclusive": [
+            "abort"
+          ],
+          "name": "continue",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "destination-credential": {
+          "description": "Credential ID posted as destinationCredentialId when creating the back-promotion. Copado requires a credential on the next/source environment (PRO-033 if a dest/dev credential is sent) and then stores the dest/dev credential. Defaults to that source environment defaultCredential, otherwise the first source credential.",
+          "name": "destination-credential",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "destination-environment": {
+          "description": "Destination org environment name or Id. Resolves to that environment's pipeline connection Git branch.",
+          "exclusive": [
+            "dev-org-branch"
+          ],
+          "name": "destination-environment",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dev-org-branch": {
+          "description": "Destination org Git branch. Defaults to lastDevOrgBranch from `cicd work set`.",
+          "exclusive": [
+            "destination-environment"
+          ],
+          "name": "dev-org-branch",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "pipeline-id": {
+          "description": "Pipeline ID. Defaults to the active work item from `cicd work set`.",
+          "name": "pipeline-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "promotion": {
+          "description": "Back-promotion Id or name to PATCH when this run stops on merge conflicts, finishes successfully, continues, or aborts. Included in the conflict continue and abort commands. Defaults to the back-promotion created in this run.",
+          "name": "promotion",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:work:environment-sync",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "work",
+        "environment-sync.js"
+      ]
+    },
     "cicd:work:get": {
       "aliases": [],
       "args": {
@@ -6052,7 +6396,9 @@
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU",
-        "<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU --json"
+        "<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU --json",
+        "<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU --user-stories-ahead-behind",
+        "<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU --user-stories-ahead-behind --json"
       ],
       "flags": {
         "json": {
@@ -6061,6 +6407,12 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
+        },
+        "user-stories-ahead-behind": {
+          "description": "When the user story has a pipeline and source environment, compare user stories ahead of and behind the next pipeline environment",
+          "name": "user-stories-ahead-behind",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -6250,17 +6602,23 @@
     "cicd:work:promote": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "User Story ID (defaults to the active work item from `work set`)",
-          "name": "id",
+        "userStoryIds": {
+          "description": "User story ID. Pass more than one to merge those feature branches in order. Omit when using --promotion with --continue or --abort.",
+          "multiple": true,
+          "name": "userStoryIds",
           "required": false
         }
       },
-      "description": "Promote the explicit or active User Story through its Copado Promotion. Requires --cloud and selects promote-only unless --deploy is passed.",
+      "description": "Experimental: skips Quality Gates. Requires enableLocalPromote true in .agentia/config.json. Create a promotion for one or more user stories and merge each feature/<name> branch into promotion/<promotionName>. The promotion branch is created from the destination environment branch. Without --backpromote, the stories promote forward from their source environment to the next pipeline environment. With --backpromote, pass --destination-branch. The destination environment is the pipeline environment whose connection branch matches that name, and the source is the next environment above it. Story merges stop at the first conflict and the promotion status is set to Merge Conflict. Resolve those files, then re-run with --promotion=<name-or-id> --continue to commit the merge, merge any remaining stories, and finish the promotion. To discard a conflicted merge, re-run with --promotion=<name-or-id> --abort (runs git merge --abort and sets the promotion status to Draft). That continue command repeats --validate or --deploy and --sf-alias when the original command used them. After every story merges, the promotion branch is pushed. Without --validate or --deploy, the promotion status is set to Completed. With --validate or --deploy, --sf-alias is required. The command writes a temporary package.xml and postdestructivechanges.xml from the promotion metadata and runs sf project deploy start --test-level NoTestRun -o <alias>. --validate adds --dry-run, does not merge the destination branch, and sets the promotion status to Validated. --deploy merges the promotion branch into the destination branch and sets the promotion status to Completed only after that deployment succeeds. User story records are not updated.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --cloud",
-        "<%= config.bin %> <%= command.id %> a07XXXXXXXXXXXXXXX --cloud --promotion-id a0BXXXXXXXXXXXXXXX",
-        "<%= config.bin %> <%= command.id %> --cloud --deploy --json"
+        "<%= config.bin %> <%= command.id %> a16P7000006By3pIAC",
+        "<%= config.bin %> <%= command.id %> a16P7000006By3pIAC a16P7000006By4qIAC",
+        "<%= config.bin %> <%= command.id %> a16P7000006By3pIAC --backpromote --destination-branch dev1-sfp",
+        "<%= config.bin %> <%= command.id %> a16P7000006By3pIAC --validate --sf-alias destOrg",
+        "<%= config.bin %> <%= command.id %> a16P7000006By3pIAC --deploy --sf-alias destOrg",
+        "<%= config.bin %> <%= command.id %> --promotion=P29354 --continue",
+        "<%= config.bin %> <%= command.id %> --promotion=P29354 --abort",
+        "<%= config.bin %> <%= command.id %> a16P7000006By3pIAC --json"
       ],
       "flags": {
         "json": {
@@ -6270,63 +6628,76 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "cloud": {
-          "description": "Use the Copado cloud promotion API. Required for this command.",
-          "name": "cloud",
+        "abort": {
+          "description": "Abort an in-progress merge (`git merge --abort`) and set the promotion status to Draft. Requires --promotion. Exclusive with --continue.",
+          "exclusive": [
+            "continue"
+          ],
+          "name": "abort",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "backpromote": {
+          "description": "Create a back promotion. Requires --destination-branch. Omit to promote forward to the next pipeline environment.",
+          "name": "backpromote",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "continue": {
+          "description": "Commit a resolved merge on promotion/<name> and finish the remaining story merges. Requires --promotion.",
+          "exclusive": [
+            "abort"
+          ],
+          "name": "continue",
           "allowNo": false,
           "type": "boolean"
         },
         "deploy": {
-          "description": "Use merge_and_deploy instead of promote-only merge.",
+          "description": "Deploy the promotion metadata with sf project deploy start, then merge the promotion branch into the destination branch and set the promotion status to Completed. Requires --sf-alias.",
+          "exclusive": [
+            "validate"
+          ],
           "name": "deploy",
           "allowNo": false,
           "type": "boolean"
         },
-        "deployment-step-id": {
-          "description": "Ordered deployment-step Salesforce ID. Can be provided multiple times with --deploy.",
-          "name": "deployment-step-id",
+        "destination-branch": {
+          "dependsOn": [
+            "backpromote"
+          ],
+          "description": "Destination environment Git branch for --backpromote. The destination environment is the pipeline environment whose connection branch matches this name.",
+          "name": "destination-branch",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "ignored-metadata-json": {
-          "description": "JSON array to persist through ignored-metadata before starting the promotion.",
-          "name": "ignored-metadata-json",
+        "destination-credential": {
+          "description": "Credential ID posted as destinationCredentialId. Defaults to the destination environment default credential for a forward promotion, or the next/source environment default credential for --backpromote.",
+          "name": "destination-credential",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "promotion-id": {
-          "description": "Explicit 18-character Promotion ID when the User Story belongs to multiple promotions.",
-          "name": "promotion-id",
+        "promotion": {
+          "description": "Promotion Id or name for --continue after a merge conflict, or for --abort.",
+          "name": "promotion",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "recreate-promotion-branch": {
-          "description": "Recreate the promotion branch before execution. Requires confirmation or --yes.",
-          "name": "recreate-promotion-branch",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "wait": {
-          "description": "Poll promotion and deployment executions to terminal status.",
-          "name": "wait",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "wait-timeout": {
-          "description": "Maximum total seconds to wait for promotion and deployment executions.",
-          "name": "wait-timeout",
-          "default": 900,
+        "sf-alias": {
+          "description": "Salesforce org alias or username for --validate or --deploy. Passed to sf project deploy start -o.",
+          "name": "sf-alias",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "char": "y",
-          "description": "Confirm promotion branch recreation without prompting.",
-          "name": "yes",
+        "validate": {
+          "description": "Validate the promotion metadata with sf project deploy start --dry-run. Does not merge the destination branch. Sets the promotion status to Validated. Requires --sf-alias.",
+          "exclusive": [
+            "deploy"
+          ],
+          "name": "validate",
           "allowNo": false,
           "type": "boolean"
         }
@@ -6470,7 +6841,7 @@
           "required": false
         }
       },
-      "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, fetches the feature branch when it exists on origin, then creates or checks out feature/<user-story-name> from the remote feature branch when present, otherwise from the base branch. A gateway warning prints the message, skips git, and leaves local work context unchanged. After work/set returns, compares the Story source credential with the CICD project default: warns when the default or Story credential is missing, and warns without changing the Story when they differ (shows the current credential and environment; use work update to change it). With --none, clears every last* key from `.agentia/config.user.json` and checks out the previous lastBaseBranch when present, else main, else master, else stays put.",
+      "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, fetches the feature branch when it exists on origin, then creates or checks out feature/<user-story-name> from the remote feature branch when present, otherwise from the base branch. A gateway warning prints the message, skips git, clears lastBaseBranch/lastDevOrgBranch/lastPullRequestBaseUrl, and records lastWorkItemId/lastWorkItem/lastWorkItemTitle from the returned work item. After work/set returns, compares the Story source credential with the CICD project default: warns when the default or Story credential is missing, and warns without changing the Story when they differ (shows the current credential and environment; use work update to change it). With --none, clears every last* key from `.agentia/config.user.json` and checks out the previous lastBaseBranch when present, else main, else master, else stays put.",
       "examples": [
         "<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU",
         "<%= config.bin %> <%= command.id %> US-0001 --json",
@@ -6567,7 +6938,7 @@
     "cicd:work:submit": {
       "aliases": [],
       "args": {},
-      "description": "Submit the current feature/<lastWorkItem> 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). When the last pending related job template name contains Commit, waits up to 5 minutes for that job before submitting. With --done or --deploy, matches Copado UI Submit when promoting (validate=false / headless work/done). cicd work done is a compatibility alias of this command with --done.",
+      "description": "Submit the current feature/<lastWorkItem> 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). When the last pending related job template name contains Commit, waits up to 5 minutes for that job before submitting. Before submit or promote, counts user stories ahead and behind between the source environment and the next pipeline environment, and warns when stories behind might cause promotion conflicts (advising `agentia cicd work environment-sync`). With --done or --deploy, matches Copado UI Submit when promoting (validate=false / headless work/done). cicd work done is a compatibility alias of this command with --done.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --apex-test-classes=MyTest,OtherTest",
@@ -9687,13 +10058,18 @@
         "upload.js"
       ]
     },
-    "testing:project:create": {
+    "testing:live:continue": {
       "aliases": [],
-      "args": {},
-      "description": "Create a Copado Robotic Testing project",
+      "args": {
+        "job-id": {
+          "description": "Optional CRT job/test ID guard.",
+          "name": "job-id",
+          "required": false
+        }
+      },
+      "description": "Continue paused Robot execution in the active CRT live session",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --name \"QA Tests\"",
-        "<%= config.bin %> <%= command.id %> --name \"QA Tests\" --description \"Smoke suite\" --json"
+        "<%= config.bin %> <%= command.id %> --project <project-id>"
       ],
       "flags": {
         "json": {
@@ -9703,284 +10079,18 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "dashboard-id": {
-          "description": "Optional CRT dashboard ID.",
-          "name": "dashboard-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "description": "Project description.",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "executor": {
-          "description": "Project execution backend.",
-          "name": "executor",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "jenkins",
-            "kubernetes"
-          ],
-          "type": "option"
-        },
-        "name": {
-          "description": "Project name.",
-          "name": "name",
+        "project": {
+          "char": "p",
+          "description": "CRT project ID.",
+          "name": "project",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "type": {
-          "description": "CRT project type.",
-          "name": "type",
-          "default": "ta",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "ta",
-            "rpa"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "testing:project:create",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "testing",
-        "project",
-        "create.js"
-      ]
-    },
-    "testing:project:delete": {
-      "aliases": [],
-      "args": {
-        "id": {
-          "description": "CRT project ID.",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Delete a Copado Robotic Testing project",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> <project-id> --yes",
-        "<%= config.bin %> <%= command.id %> <project-id> --yes --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Skip the destructive confirmation prompt.",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "testing:project:delete",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "testing",
-        "project",
-        "delete.js"
-      ]
-    },
-    "testing:project:get": {
-      "aliases": [],
-      "args": {
-        "id": {
-          "description": "CRT project ID.",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get a Copado Robotic Testing project from the project list",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> <project-id>",
-        "<%= config.bin %> <%= command.id %> <project-id> --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "testing:project:get",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "testing",
-        "project",
-        "get.js"
-      ]
-    },
-    "testing:project:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List Copado Robotic Testing projects",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --name \"QA Tests\" --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "name": {
-          "description": "Exact project name to match client-side.",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "testing:project:list",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "testing",
-        "project",
-        "list.js"
-      ]
-    },
-    "testing:project:update": {
-      "aliases": [],
-      "args": {
-        "id": {
-          "description": "CRT project ID.",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Update a Copado Robotic Testing project",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> <project-id> --name \"QA Updated\"",
-        "<%= config.bin %> <%= command.id %> <project-id> --description \"Regression suites\" --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "description": {
-          "description": "New project description.",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "New project name.",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "testing:project:update",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "testing",
-        "project",
-        "update.js"
-      ]
-    },
-    "testing:live:continue": {
-      "aliases": [],
-      "args": {
-        "job-id": {
-          "description": "Optional CRT job/test ID guard.",
-          "name": "job-id",
-          "required": false
-        }
-      },
-      "description": "Continue paused Robot execution in the active CRT live session",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --project <project-id>"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "project": {
-          "char": "p",
-          "description": "CRT project ID.",
-          "name": "project",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "session-id": {
-          "description": "Guard that must match the locally active CRT live session.",
-          "name": "session-id",
+        "session-id": {
+          "description": "Guard that must match the locally active CRT live session.",
+          "name": "session-id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -10808,19 +10918,304 @@
         "status.js"
       ]
     },
-    "testing:live:stop": {
+    "testing:live:stop": {
+      "aliases": [],
+      "args": {
+        "job-id": {
+          "description": "Optional CRT job/test ID guard.",
+          "name": "job-id",
+          "required": false
+        }
+      },
+      "description": "Stop the active Copado Robotic Testing live session",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --project <project-id>",
+        "<%= config.bin %> <%= command.id %> <job-id> --project <project-id> --yes --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "project": {
+          "char": "p",
+          "description": "CRT project ID.",
+          "name": "project",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "session-id": {
+          "description": "Guard that must match the locally active CRT live session.",
+          "name": "session-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Confirm live session shutdown.",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "testing:live:stop",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "testing",
+        "live",
+        "stop.js"
+      ]
+    },
+    "testing:live:view": {
+      "aliases": [],
+      "args": {},
+      "description": "Open the authenticated CRT run/session page without putting viewer secrets in the URL",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --project <project-id>",
+        "<%= config.bin %> <%= command.id %> --project <project-id> --no-open --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "interactive": {
+          "description": "Request interactive viewer controls when available.",
+          "name": "interactive",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-open": {
+          "description": "Return the nonsecret URL without opening a browser.",
+          "name": "no-open",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "project": {
+          "char": "p",
+          "description": "CRT project ID.",
+          "name": "project",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "session-id": {
+          "description": "Guard that must match the active CRT live session.",
+          "name": "session-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "testing:live:view",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "testing",
+        "live",
+        "view.js"
+      ]
+    },
+    "testing:project:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a Copado Robotic Testing project",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --name \"QA Tests\"",
+        "<%= config.bin %> <%= command.id %> --name \"QA Tests\" --description \"Smoke suite\" --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dashboard-id": {
+          "description": "Optional CRT dashboard ID.",
+          "name": "dashboard-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "Project description.",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "executor": {
+          "description": "Project execution backend.",
+          "name": "executor",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "jenkins",
+            "kubernetes"
+          ],
+          "type": "option"
+        },
+        "name": {
+          "description": "Project name.",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "type": {
+          "description": "CRT project type.",
+          "name": "type",
+          "default": "ta",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ta",
+            "rpa"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "testing:project:create",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "testing",
+        "project",
+        "create.js"
+      ]
+    },
+    "testing:project:delete": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "CRT project ID.",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Delete a Copado Robotic Testing project",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> <project-id> --yes",
+        "<%= config.bin %> <%= command.id %> <project-id> --yes --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip the destructive confirmation prompt.",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "testing:project:delete",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "testing",
+        "project",
+        "delete.js"
+      ]
+    },
+    "testing:project:get": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "CRT project ID.",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a Copado Robotic Testing project from the project list",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> <project-id>",
+        "<%= config.bin %> <%= command.id %> <project-id> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "testing:project:get",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "testing",
+        "project",
+        "get.js"
+      ]
+    },
+    "testing:project:list": {
       "aliases": [],
-      "args": {
-        "job-id": {
-          "description": "Optional CRT job/test ID guard.",
-          "name": "job-id",
-          "required": false
-        }
-      },
-      "description": "Stop the active Copado Robotic Testing live session",
+      "args": {},
+      "description": "List Copado Robotic Testing projects",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --project <project-id>",
-        "<%= config.bin %> <%= command.id %> <job-id> --project <project-id> --yes --json"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --name \"QA Tests\" --json"
       ],
       "flags": {
         "json": {
@@ -10830,33 +11225,17 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "project": {
-          "char": "p",
-          "description": "CRT project ID.",
-          "name": "project",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "session-id": {
-          "description": "Guard that must match the locally active CRT live session.",
-          "name": "session-id",
+        "name": {
+          "description": "Exact project name to match client-side.",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Confirm live session shutdown.",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "testing:live:stop",
+      "id": "testing:project:list",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -10867,17 +11246,23 @@
         "dist",
         "commands",
         "testing",
-        "live",
-        "stop.js"
+        "project",
+        "list.js"
       ]
     },
-    "testing:live:view": {
+    "testing:project:update": {
       "aliases": [],
-      "args": {},
-      "description": "Open the authenticated CRT run/session page without putting viewer secrets in the URL",
+      "args": {
+        "id": {
+          "description": "CRT project ID.",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update a Copado Robotic Testing project",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --project <project-id>",
-        "<%= config.bin %> <%= command.id %> --project <project-id> --no-open --json"
+        "<%= config.bin %> <%= command.id %> <project-id> --name \"QA Updated\"",
+        "<%= config.bin %> <%= command.id %> <project-id> --description \"Regression suites\" --json"
       ],
       "flags": {
         "json": {
@@ -10887,30 +11272,16 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "interactive": {
-          "description": "Request interactive viewer controls when available.",
-          "name": "interactive",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "no-open": {
-          "description": "Return the nonsecret URL without opening a browser.",
-          "name": "no-open",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "project": {
-          "char": "p",
-          "description": "CRT project ID.",
-          "name": "project",
-          "required": true,
+        "description": {
+          "description": "New project description.",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "session-id": {
-          "description": "Guard that must match the active CRT live session.",
-          "name": "session-id",
+        "name": {
+          "description": "New project name.",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -10918,7 +11289,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "testing:live:view",
+      "id": "testing:project:update",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -10929,8 +11300,8 @@
         "dist",
         "commands",
         "testing",
-        "live",
-        "view.js"
+        "project",
+        "update.js"
       ]
     },
     "testing:robot:create": {
@@ -16774,6 +17145,49 @@
         "update.js"
       ]
     },
+    "cicd:repository:auth:setup": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Copado Git repository ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Interactively configure repository authentication; OAuth is selected by default",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "overwrite": {
+          "description": "Replace an existing HTTPS or SSH credential",
+          "name": "overwrite",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:repository:auth:setup",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "repository",
+        "auth",
+        "setup.js"
+      ]
+    },
     "cicd:work:deployment-step:create": {
       "aliases": [],
       "args": {},
@@ -17954,7 +18368,154 @@
         "log",
         "get.js"
       ]
+    },
+    "cicd:repository:auth:https:configure": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Copado Git repository ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Configure HTTPS authentication. Use a personal access token as the password when required by the provider.",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "input-stdin": {
+          "description": "Read the complete HTTPS authentication JSON payload from stdin",
+          "name": "input-stdin",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "overwrite": {
+          "description": "Replace an existing validated HTTPS credential",
+          "name": "overwrite",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:repository:auth:https:configure",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "repository",
+        "auth",
+        "https",
+        "configure.js"
+      ]
+    },
+    "cicd:repository:auth:oauth:login": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Copado Git repository ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Authenticate a repository through browser OAuth and select a remote repository",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "port": {
+          "description": "Local callback port (default: scan 8080-8090)",
+          "name": "port",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "timeout": {
+          "description": "Seconds to wait for browser authentication",
+          "name": "timeout",
+          "default": 300,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:repository:auth:oauth:login",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "repository",
+        "auth",
+        "oauth",
+        "login.js"
+      ]
+    },
+    "cicd:repository:auth:ssh:configure": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Copado Git repository ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Generate SSH authentication and a public key. Add the key to your Git provider as a deploy, access, or SSH key.",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "overwrite": {
+          "description": "Replace an existing SSH key after confirmation",
+          "name": "overwrite",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:repository:auth:ssh:configure",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "repository",
+        "auth",
+        "ssh",
+        "configure.js"
+      ]
     }
   },
-  "version": "1.0.0-beta.1"
+  "version": "1.0.0-beta.4"
 }