@copado/agentia-cli 1.0.0-beta.8 → 1.0.0-rc.0

package/oclif.manifest.json

@@ -57,10 +57,12 @@
     "update": {
       "aliases": [],
       "args": {},
-      "description": "Update the globally installed Agentia CLI to the newest beta release",
+      "description": "Update the globally installed Agentia CLI to the newest release for the selected channel",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --check",
+        "<%= config.bin %> <%= command.id %> --channel latest --check",
+        "<%= config.bin %> <%= command.id %> --channel rc",
         "<%= config.bin %> <%= command.id %> --check --json"
       ],
       "flags": {
@@ -71,6 +73,17 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "channel": {
+          "description": "npm dist-tag to check (rc or latest). Omit to auto-select: prerelease installs compare rc and latest; stable installs use latest only.",
+          "name": "channel",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "rc",
+            "latest"
+          ],
+          "type": "option"
+        },
         "check": {
           "description": "Check for an update without installing it",
           "name": "check",
@@ -1799,7 +1812,7 @@
           "type": "option"
         },
         "timeout": {
-          "description": "Maximum seconds to wait for the job to finish (default: 3600).",
+          "description": "Maximum seconds to wait; the remote run continues after timeout (default: 3600).",
           "name": "timeout",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1926,7 +1939,7 @@
           "type": "option"
         },
         "timeout": {
-          "description": "Maximum seconds to wait for the job to finish (default: 3600).",
+          "description": "Maximum seconds to wait; the remote run continues after timeout (default: 3600).",
           "name": "timeout",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2139,7 +2152,7 @@
           "type": "option"
         },
         "timeout": {
-          "description": "Maximum seconds to wait for the job to finish (default: 3600).",
+          "description": "Maximum seconds to wait; the remote run continues after timeout (default: 3600).",
           "name": "timeout",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2213,7 +2226,7 @@
           "type": "option"
         },
         "timeout": {
-          "description": "Maximum seconds to wait for the job to finish (default: 3600).",
+          "description": "Maximum seconds to wait; the remote run continues after timeout (default: 3600).",
           "name": "timeout",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2370,7 +2383,7 @@
           "type": "option"
         },
         "timeout": {
-          "description": "Maximum seconds to wait (default: 3600).",
+          "description": "Maximum seconds to wait; the remote run continues after timeout (default: 3600).",
           "name": "timeout",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -7101,15 +7114,14 @@
         "update.js"
       ]
     },
-    "cicd:user:get": {
+    "cicd:template:defaults": {
       "aliases": [],
       "args": {},
-      "description": "Get a Copado user by ID (defaults to the authenticated user)",
+      "description": "Scaffold default Copado Job Template metadata without writing to Salesforce (legacy create ≈ defaults --write)",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --id me",
-        "<%= config.bin %> <%= command.id %> --id 005000000000000",
-        "<%= config.bin %> <%= command.id %> --json"
+        "<%= config.bin %> <%= command.id %> --name MyTemplate",
+        "<%= config.bin %> <%= command.id %> --name MyTemplate --api-name MyTemplate_1 --write",
+        "<%= config.bin %> <%= command.id %> --name MyTemplate --output ./copado/templates/MyTemplate_1.metadata.json --json"
       ],
       "flags": {
         "json": {
@@ -7119,18 +7131,38 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "id": {
-          "description": "User ID, or \"me\" for the authenticated user",
-          "name": "id",
-          "default": "me",
+        "api-name": {
+          "description": "Optional template API name for the scaffold (defaults to {name}_1 on the gateway)",
+          "name": "api-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Template display name used to scaffold defaults",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output": {
+          "description": "Write scaffold JSON to this path (implies a disk write)",
+          "name": "output",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "write": {
+          "description": "Write scaffold JSON to copado/templates/{apiName}.metadata.json (legacy create)",
+          "name": "write",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:user:get",
+      "id": "cicd:template:defaults",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -7142,23 +7174,23 @@
         "dist",
         "commands",
         "cicd",
-        "user",
-        "get.js"
+        "template",
+        "defaults.js"
       ]
     },
-    "cicd:work:commit": {
+    "cicd:template:delete": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "User story ID (defaults to the active work item from `work set`)",
-          "name": "id",
-          "required": false
+        "api-name": {
+          "description": "Template API name",
+          "name": "api-name",
+          "required": true
         }
       },
-      "description": "Compatibility alias of cicd cloud commit. Create a Copado cloud metadata commit for a user story. Prefer: agentia cicd cloud commit.",
+      "description": "Delete a Copado Job Template by API name",
       "examples": [
-        "<%= 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"
+        "<%= config.bin %> <%= command.id %> MyTemplate_1",
+        "<%= config.bin %> <%= command.id %> MyTemplate_1 --json"
       ],
       "flags": {
         "json": {
@@ -7167,137 +7199,66 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        },
-        "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",
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:template:delete",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "template",
+        "delete.js"
+      ]
+    },
+    "cicd:template:get": {
+      "aliases": [],
+      "args": {
+        "api-name": {
+          "description": "Template API name",
+          "name": "api-name",
+          "required": true
+        }
+      },
+      "description": "Get a Copado Job Template by API name (legacy retrieve ≈ get --write)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> MyTemplate_1",
+        "<%= config.bin %> <%= command.id %> MyTemplate_1 --write",
+        "<%= config.bin %> <%= command.id %> MyTemplate_1 --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
           "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"
-        },
-        "file": {
-          "char": "f",
-          "description": "Path to a JSON commit request body.",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "message": {
-          "char": "m",
-          "description": "Commit message. Required unless provided by JSON input.",
-          "name": "message",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "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",
+        "output": {
+          "description": "Write retrieved template JSON to this path (implies a disk write)",
+          "name": "output",
           "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"
-        },
-        "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",
+        "write": {
+          "description": "Write retrieved JSON to copado/templates/{apiName}.metadata.json (legacy retrieve)",
+          "name": "write",
           "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"
         }
       },
       "hasDynamicHelp": false,
-      "hidden": true,
       "hiddenAliases": [],
-      "id": "cicd:work:commit",
+      "id": "cicd:template:get",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -7309,17 +7270,19 @@
         "dist",
         "commands",
         "cicd",
-        "work",
-        "commit.js"
+        "template",
+        "get.js"
       ]
     },
-    "cicd:work:create": {
+    "cicd:template:list": {
       "aliases": [],
       "args": {},
-      "description": "Create a Copado user story",
+      "description": "List Copado Job Templates",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --title \"My story\" --status Draft",
-        "<%= config.bin %> <%= command.id %> --title \"My story\" --json"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --type all",
+        "<%= config.bin %> <%= command.id %> --name Demo --page-size 50",
+        "<%= config.bin %> <%= command.id %> --fetch-all --json"
       ],
       "flags": {
         "json": {
@@ -7329,43 +7292,470 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "excluded-from-cbm": {
-          "description": "Exclude from CBM",
-          "name": "excluded-from-cbm",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "actual-points": {
-          "description": "Actual points",
-          "name": "actual-points",
+        "cursor": {
+          "description": "Opaque pagination cursor from a previous list response (nextCursor)",
+          "name": "cursor",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "planned-points": {
-          "description": "Planned points",
-          "name": "planned-points",
+        "page-size": {
+          "description": "Number of records per page (1-200)",
+          "name": "page-size",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "priority": {
-          "description": "Priority",
-          "name": "priority",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "fetch-all": {
+          "description": "Fetch all matching templates (incompatible with --cursor on the gateway)",
+          "name": "fetch-all",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "acceptance-criteria": {
-          "description": "Acceptance criteria (maximum 255 characters)",
-          "name": "acceptance-criteria",
+        "name": {
+          "description": "Filter by name substring",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "as-a": {
-          "description": "User story \"as a\" clause (maximum 255 characters)",
-          "name": "as-a",
+        "type": {
+          "description": "List Custom templates only, or all templates",
+          "name": "type",
+          "default": "custom",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "custom",
+            "all"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:template:list",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "template",
+        "list.js"
+      ]
+    },
+    "cicd:template:upsert": {
+      "aliases": [],
+      "args": {
+        "api-name": {
+          "description": "Template API name",
+          "name": "api-name",
+          "required": true
+        }
+      },
+      "description": "Create or update a Copado Job Template by API name (legacy deploy ≈ upsert reading disk or --file)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> MyTemplate_1",
+        "<%= config.bin %> <%= command.id %> MyTemplate_1 --file ./copado/templates/MyTemplate_1.metadata.json",
+        "<%= config.bin %> <%= command.id %> MyTemplate_1 --name \"My Template\" --steps-file ./steps.json --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "description": {
+          "description": "Template description",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "description": "Path to a JSON file with the full upsert payload (legacy deploy format accepted)",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Template display name (defaults to the API name argument)",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "steps-file": {
+          "description": "Path to a JSON file containing the steps array",
+          "name": "steps-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "type": {
+          "description": "Template type (for example Custom)",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "version": {
+          "description": "Template version",
+          "name": "version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "volume-options": {
+          "description": "Template volume options as a JSON string or plain string",
+          "name": "volume-options",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:template:upsert",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "template",
+        "upsert.js"
+      ]
+    },
+    "cicd:user:get": {
+      "aliases": [],
+      "args": {},
+      "description": "Get a Copado user by ID (defaults to the authenticated user)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --id me",
+        "<%= config.bin %> <%= command.id %> --id 005000000000000",
+        "<%= config.bin %> <%= command.id %> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "id": {
+          "description": "User ID, or \"me\" for the authenticated user",
+          "name": "id",
+          "default": "me",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:user:get",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "user",
+        "get.js"
+      ]
+    },
+    "cicd:work:ahead-behind": {
+      "aliases": [],
+      "args": {
+        "environment": {
+          "description": "Copado environment Id or name (defaults to the configured project default environment)",
+          "name": "environment",
+          "required": false
+        }
+      },
+      "description": "Compare user stories ahead of and behind the next pipeline environment. Resolves the project (and its pipeline) from the project default or --project, finds the unique next environment from pipeline connections for the given or default environment, then GET /agentia/headless/work/user-stories-ahead-behind.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> dev1",
+        "<%= config.bin %> <%= command.id %> a0E... --project a0w...",
+        "<%= config.bin %> <%= command.id %> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "project": {
+          "description": "Copado project Id (defaults to the configured project default)",
+          "name": "project",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:work:ahead-behind",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "work",
+        "ahead-behind.js"
+      ]
+    },
+    "cicd:work:commit": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "User story ID (defaults to the active work item from `work set`)",
+          "name": "id",
+          "required": false
+        }
+      },
+      "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 %> 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": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "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"
+        },
+        "file": {
+          "char": "f",
+          "description": "Path to a JSON commit request body.",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "message": {
+          "char": "m",
+          "description": "Commit message. Required unless provided by JSON input.",
+          "name": "message",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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"
+        },
+        "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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "cicd:work:commit",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "work",
+        "commit.js"
+      ]
+    },
+    "cicd:work:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a Copado user story",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --title \"My story\" --status Draft",
+        "<%= config.bin %> <%= command.id %> --title \"My story\" --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "excluded-from-cbm": {
+          "description": "Exclude from CBM",
+          "name": "excluded-from-cbm",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "actual-points": {
+          "description": "Actual points",
+          "name": "actual-points",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "planned-points": {
+          "description": "Planned points",
+          "name": "planned-points",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "priority": {
+          "description": "Priority",
+          "name": "priority",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "acceptance-criteria": {
+          "description": "Acceptance criteria (maximum 255 characters)",
+          "name": "acceptance-criteria",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "as-a": {
+          "description": "User story \"as a\" clause (maximum 255 characters)",
+          "name": "as-a",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -7616,7 +8006,7 @@
     "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.",
+      "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. On git/merge failure (including conflicts) and after a successful --continue, uploads the captured command transcript as a Salesforce File on the back-promotion (`Environment Sync Logs <name-or-id> <datetime>.txt`) via `/agentia/headless/file/upload`. HTTP 404 is ignored until that endpoint is rolled out; other upload failures are warned and do not change the environment-sync outcome.",
       "examples": [
         "<%= config.bin %> <%= command.id %> --destination-environment=dev1",
         "<%= config.bin %> <%= command.id %> --dev-org-branch=dev1-sfp",
@@ -8053,7 +8443,7 @@
     "cicd:work:publish": {
       "aliases": [],
       "args": {},
-      "description": "Publish the current feature/<lastWorkItem> branch and register commits with Copado. Requires a clean working tree, base branch, and dev org branch from `.agentia/config.user.json`. Fetches origin/<lastBaseBranch>, then registers only commits in origin/<lastBaseBranch>..HEAD and diffs nested parent XML at merge-base(origin/<lastBaseBranch>, HEAD) versus HEAD, so origin/base-only history is ignored. When there are no commits since origin/<lastBaseBranch>, or origin already has HEAD, fails with \"No changes to publish\" unless `--permissions` and/or `--full-metadata` is set, in which case it creates an empty commit so a tip commit id exists. Applies Copado environment-variable then yaml replacements to the added and modified files in origin/<lastBaseBranch>..HEAD (passed to the jars as `--include`; yaml `-b` is the feature branch, matching Copado Commit), commits both as a single follow-up commit, locks the tip commit, runs `git push origin <branch>`, reports the nested metadata changed across the branch, such as the CustomField behind a profile field-permission edit, plus the parent components it would ignore, calls headless work/push with one changeListUpdate list of Action:MetadataType:MetadataName corrections: lastPermissionSelected and --permissions plus the nested metadata of the changed profiles and permission sets as RetrieveOnly, lastFullMetadataSelected and --full-metadata plus brand-new nested parent files as fullMetadata, the ignored parents as unchanged, the nested metadata deleted on the branch as Del, and the remaining nested metadata as Add, then merges the feature branch into the recorded dev org branch. The changed profiles and permission sets themselves are never sent as corrections, so they stay in the change list and deploy only the permissions their RetrieveOnly entries select. Brand-new nested parent files are an exception: they are sent as fullMetadata so the complete file travels. `--dry-run` runs commit collection, replacements, and nested detection, logs the changeListUpdate that would be sent, skips empty/replacement commits, tip lock, git push, headless register, and dev-org sync, then restores only the tracked files dirtied by replacements (untracked files are left alone). `cicd work push` is a compatibility alias of this command.",
+      "description": "Publish the current feature/<lastWorkItem> branch and register commits with Copado. Requires a clean working tree, base branch, and dev org branch from `.agentia/config.user.json`. Fetches origin/<lastBaseBranch>, then registers only commits in origin/<lastBaseBranch>..HEAD and diffs nested parent XML at merge-base(origin/<lastBaseBranch>, HEAD) versus HEAD, so origin/base-only history is ignored. When there are no commits since origin/<lastBaseBranch>, or origin already has HEAD, fails with \"No changes to publish\" unless `--permissions` and/or `--full-metadata` is set, in which case it creates an empty commit so a tip commit id exists. Applies Copado environment-variable then yaml replacements to the added and modified files in origin/<lastBaseBranch>..HEAD (passed to the jars as `--include`; yaml `-b` is the feature branch, matching Copado Commit), commits both as a single follow-up commit, locks the tip commit, runs `git push origin <branch>`, reports the nested metadata changed across the branch, such as the CustomField behind a profile field-permission edit, plus the parent components it would ignore, calls headless work/push with one changeListUpdate list of Action:MetadataType:MetadataName corrections: lastPermissionSelected and --permissions plus the nested metadata of the changed profiles and permission sets as RetrieveOnly, lastFullMetadataSelected and --full-metadata plus brand-new nested parent files as fullMetadata, the ignored parents as unchanged, the nested metadata deleted on the branch as Del, and the remaining nested metadata as Add, then merges the feature branch into the recorded dev org branch. The changed profiles and permission sets themselves are never sent as corrections, so they stay in the change list and deploy only the permissions their RetrieveOnly entries select. Brand-new nested parent files are an exception: they are sent as fullMetadata so the complete file travels. After a successful register, uploads the captured command output as a Salesforce File on the user story (`Local Commit Logs <commitId> <datetime>.txt`) via `/agentia/headless/file/upload`. HTTP 404 is ignored until that endpoint is rolled out; other upload failures are warned and do not fail the publish. `--dry-run` runs commit collection, replacements, and nested detection, logs the changeListUpdate that would be sent, skips empty/replacement commits, tip lock, git push, headless register, log upload, and dev-org sync, then restores only the tracked files dirtied by replacements (untracked files are left alone). `cicd work push` is a compatibility alias of this command.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --dry-run",
@@ -8286,7 +8676,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. 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.",
+      "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`). After a successful submit or promote, uploads the captured command output as a Salesforce File on the user story (`Local Commit Logs <commitId> <datetime>.txt`) via `/agentia/headless/file/upload`. HTTP 404 is ignored until that endpoint is rolled out; other upload failures are warned and do not fail the command. 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",
@@ -16775,159 +17165,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "file": {
-          "description": "Path to a JSON file with an array of metadata content requests",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file-name": {
-          "description": "Optional metadata file name",
-          "name": "file-name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "metadata-type": {
-          "description": "Metadata type, for example ApexClass",
-          "name": "metadata-type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "output-file": {
-          "description": "Write decoded content from the first result to this file path",
-          "name": "output-file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "pipeline-id": {
-          "description": "Pipeline Id",
-          "name": "pipeline-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "result-id": {
-          "description": "Optional result Id from a prior metadata operation",
-          "name": "result-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "show": {
-          "description": "Print decoded metadata content to stdout after retrieval",
-          "name": "show",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "source": {
-          "description": "Content source",
-          "name": "source",
-          "default": "ENVIRONMENT",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "ENVIRONMENT",
-            "REPOSITORY",
-            "GIT_MIRROR",
-            "ORG_CACHE"
-          ],
-          "type": "option"
-        },
-        "source-credential-id": {
-          "description": "Source org credential Id",
-          "name": "source-credential-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "source-org-id": {
-          "description": "Source org Id",
-          "name": "source-org-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cicd:metadata:content:get",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "experimental": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "metadata",
-        "content",
-        "get.js"
-      ]
-    },
-    "cicd:metadata:dependency:list": {
-      "aliases": [],
-      "args": {},
-      "description": "Retrieve metadata dependencies via the CICD gateway",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --metadata-name MyClass --metadata-type ApexClass --pipeline-id <id> --source-org-id <id> --source-credential-id <id>",
-        "cat request.json | <%= config.bin %> <%= command.id %> --stdin",
-        "<%= config.bin %> <%= command.id %> --from-changes --base-ref origin/main --retrieve-mode all --pipeline-id <id> --source-org-id <id> --source-credential-id <id>"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "base-ref": {
-          "description": "Base Git ref used with --from-changes",
-          "name": "base-ref",
-          "default": "origin/main",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file": {
-          "char": "f",
-          "description": "Path to a JSON dependency request body",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "from-changes": {
-          "description": "Build metadata selections from committed branch changes and staged index files",
-          "name": "from-changes",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "metadata-category": {
-          "description": "Optional metadata category",
-          "name": "metadata-category",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "metadata-name": {
-          "description": "Metadata component name",
-          "name": "metadata-name",
+        },
+        "file": {
+          "description": "Path to a JSON file with an array of metadata content requests",
+          "name": "file",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "metadata-raw-json": {
-          "description": "Optional raw metadata JSON for the selection",
-          "name": "metadata-raw-json",
+        "file-name": {
+          "description": "Optional metadata file name",
+          "name": "file-name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -16939,15 +17187,11 @@
           "multiple": false,
           "type": "option"
         },
-        "module-type": {
-          "description": "Optional addon module type",
-          "name": "module-type",
+        "output-file": {
+          "description": "Write decoded content from the first result to this file path",
+          "name": "output-file",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "vlocity",
-            "data_cloud"
-          ],
           "type": "option"
         },
         "pipeline-id": {
@@ -16957,20 +17201,6 @@
           "multiple": false,
           "type": "option"
         },
-        "platform-experience": {
-          "description": "Gateway platform experience header",
-          "name": "platform-experience",
-          "default": "salesforce",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "salesforce",
-            "sfdx",
-            "metacache",
-            "db"
-          ],
-          "type": "option"
-        },
         "result-id": {
           "description": "Optional result Id from a prior metadata operation",
           "name": "result-id",
@@ -16978,14 +17208,23 @@
           "multiple": false,
           "type": "option"
         },
-        "retrieve-mode": {
-          "description": "Dependency retrieve mode",
-          "name": "retrieve-mode",
+        "show": {
+          "description": "Print decoded metadata content to stdout after retrieval",
+          "name": "show",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "source": {
+          "description": "Content source",
+          "name": "source",
+          "default": "ENVIRONMENT",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "all",
-            "diff_only"
+            "ENVIRONMENT",
+            "REPOSITORY",
+            "GIT_MIRROR",
+            "ORG_CACHE"
           ],
           "type": "option"
         },
@@ -17002,24 +17241,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "stdin": {
-          "description": "Read a JSON dependency request body from stdin",
-          "name": "stdin",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "target-org-id": {
-          "description": "Target org Id",
-          "name": "target-org-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:metadata:dependency:list",
+      "id": "cicd:metadata:content:get",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -17032,8 +17258,8 @@
         "commands",
         "cicd",
         "metadata",
-        "dependency",
-        "list.js"
+        "content",
+        "get.js"
       ]
     },
     "cicd:metadata:index:compare": {
@@ -18325,6 +18551,98 @@
         "unset.js"
       ]
     },
+    "cicd:promotion:job-step:update": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Promotion job step ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update a promotion manual task",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> <job-step-id> --promotion <promotion-id> --status Complete",
+        "<%= config.bin %> <%= command.id %> <job-step-id> -p <promotion-name> --task-comments \"Completed by QA\"",
+        "<%= config.bin %> <%= command.id %> <job-step-id> -p <promotion-id> --assignee-id 005... --assignee-name \"Jane Doe\" --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "assignee-id": {
+          "description": "Salesforce user ID assigned to the manual task",
+          "name": "assignee-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "assignee-name": {
+          "description": "Name of the user assigned to the manual task",
+          "name": "assignee-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "promotion": {
+          "char": "p",
+          "description": "Copado promotion ID or name",
+          "name": "promotion",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "status": {
+          "description": "Manual task status",
+          "name": "status",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "Complete",
+            "Incomplete",
+            "Pending"
+          ],
+          "type": "option"
+        },
+        "task-comments": {
+          "description": "Manual task comments",
+          "name": "task-comments",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "task-description": {
+          "description": "Manual task description",
+          "name": "task-description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:promotion:job-step:update",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "promotion",
+        "job-step",
+        "update.js"
+      ]
+    },
     "cicd:promotion:conflict:get": {
       "aliases": [],
       "args": {
@@ -18551,21 +18869,16 @@
         "unresolve.js"
       ]
     },
-    "cicd:promotion:job-step:update": {
+    "cicd:repository:auth:setup": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Promotion job step ID",
+          "description": "Copado Git repository ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Update a promotion manual task",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> <job-step-id> --promotion <promotion-id> --status Complete",
-        "<%= config.bin %> <%= command.id %> <job-step-id> -p <promotion-name> --task-comments \"Completed by QA\"",
-        "<%= config.bin %> <%= command.id %> <job-step-id> -p <promotion-id> --assignee-id 005... --assignee-name \"Jane Doe\" --json"
-      ],
+      "description": "Interactively configure repository authentication; OAuth is selected by default",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -18574,59 +18887,16 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "assignee-id": {
-          "description": "Salesforce user ID assigned to the manual task",
-          "name": "assignee-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "assignee-name": {
-          "description": "Name of the user assigned to the manual task",
-          "name": "assignee-name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "promotion": {
-          "char": "p",
-          "description": "Copado promotion ID or name",
-          "name": "promotion",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "status": {
-          "description": "Manual task status",
-          "name": "status",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "Complete",
-            "Incomplete",
-            "Pending"
-          ],
-          "type": "option"
-        },
-        "task-comments": {
-          "description": "Manual task comments",
-          "name": "task-comments",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "task-description": {
-          "description": "Manual task description",
-          "name": "task-description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "overwrite": {
+          "description": "Replace an existing HTTPS or SSH credential",
+          "name": "overwrite",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:promotion:job-step:update",
+      "id": "cicd:repository:auth:setup",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -18638,21 +18908,22 @@
         "dist",
         "commands",
         "cicd",
-        "promotion",
-        "job-step",
-        "update.js"
+        "repository",
+        "auth",
+        "setup.js"
       ]
     },
-    "cicd:repository:auth:setup": {
+    "cicd:work:test:apex": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Copado Git repository ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Interactively configure repository authentication; OAuth is selected by default",
+      "args": {},
+      "description": "Run specified Apex test classes via Salesforce CLI (`sf apex run test`) with code coverage. Usually run from project-root local quality gates (`.agentia_quality_gates.sh` / `.agentia_quality_gates.cmd`) when those scripts are configured. When `--apex-test-classes` is omitted or empty, logs that no Apex tests were specified and exits without running Salesforce CLI. Failed runs save `.agentia/apex.tests.<user-story>.json`; successful runs delete that file. `--rerun-failed-apex-tests` runs the previously failed classes (optionally filtered by `--apex-test-classes`). Prints the test-run summary when the run passes, or failing tests with their messages and stack traces when it fails. Exits with the same process exit code as Salesforce CLI (`sf`), including 100 when Apex tests fail.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -t HelloWorldTest",
+        "<%= config.bin %> <%= command.id %> --apex-test-classes=MyTest,OtherTest",
+        "<%= config.bin %> <%= command.id %> -t MyTest,OtherTest -w 10 --json",
+        "<%= config.bin %> <%= command.id %> -t \"$AGENTIA_APEX_TEST_CLASSES\"",
+        "<%= config.bin %> <%= command.id %> --rerun-failed-apex-tests"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -18661,16 +18932,33 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "overwrite": {
-          "description": "Replace an existing HTTPS or SSH credential",
-          "name": "overwrite",
+        "apex-test-classes": {
+          "char": "t",
+          "description": "Comma-separated Apex test class names to run. Omit or leave empty to skip without running Salesforce CLI.",
+          "name": "apex-test-classes",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "rerun-failed-apex-tests": {
+          "description": "Rerun Apex classes saved from the last failure for this user story (`.agentia/apex.tests.<user-story>.json`). Combined with --apex-test-classes, only matching failed classes run.",
+          "name": "rerun-failed-apex-tests",
           "allowNo": false,
           "type": "boolean"
+        },
+        "wait": {
+          "char": "w",
+          "description": "Minutes to wait for Salesforce CLI Apex test results",
+          "name": "wait",
+          "default": 60,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:repository:auth:setup",
+      "id": "cicd:work:test:apex",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -18682,9 +18970,9 @@
         "dist",
         "commands",
         "cicd",
-        "repository",
-        "auth",
-        "setup.js"
+        "work",
+        "test",
+        "apex.js"
       ]
     },
     "cicd:work:deployment-step:create": {
@@ -19293,68 +19581,6 @@
         "update.js"
       ]
     },
-    "cicd:work:test:apex": {
-      "aliases": [],
-      "args": {},
-      "description": "Run specified Apex test classes via Salesforce CLI (`sf apex run test`) with code coverage. Usually run from project-root local quality gates (`.agentia_quality_gates.sh` / `.agentia_quality_gates.cmd`) when those scripts are configured. When `--apex-test-classes` is omitted or empty, logs that no Apex tests were specified and exits without running Salesforce CLI. Failed runs save `.agentia/apex.tests.<user-story>.json`; successful runs delete that file. `--rerun-failed-apex-tests` runs the previously failed classes (optionally filtered by `--apex-test-classes`). Prints the test-run summary when the run passes, or failing tests with their messages and stack traces when it fails. Exits with the same process exit code as Salesforce CLI (`sf`), including 100 when Apex tests fail.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> -t HelloWorldTest",
-        "<%= config.bin %> <%= command.id %> --apex-test-classes=MyTest,OtherTest",
-        "<%= config.bin %> <%= command.id %> -t MyTest,OtherTest -w 10 --json",
-        "<%= config.bin %> <%= command.id %> -t \"$AGENTIA_APEX_TEST_CLASSES\"",
-        "<%= config.bin %> <%= command.id %> --rerun-failed-apex-tests"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "apex-test-classes": {
-          "char": "t",
-          "description": "Comma-separated Apex test class names to run. Omit or leave empty to skip without running Salesforce CLI.",
-          "name": "apex-test-classes",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "rerun-failed-apex-tests": {
-          "description": "Rerun Apex classes saved from the last failure for this user story (`.agentia/apex.tests.<user-story>.json`). Combined with --apex-test-classes, only matching failed classes run.",
-          "name": "rerun-failed-apex-tests",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "wait": {
-          "char": "w",
-          "description": "Minutes to wait for Salesforce CLI Apex test results",
-          "name": "wait",
-          "default": 60,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cicd:work:test:apex",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "experimental": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "work",
-        "test",
-        "apex.js"
-      ]
-    },
     "testing:job:schedule:get": {
       "aliases": [],
       "args": {
@@ -19892,6 +20118,170 @@
         "get.js"
       ]
     },
+    "cicd:metadata:dependency:list": {
+      "aliases": [],
+      "args": {},
+      "description": "Retrieve metadata dependencies via the CICD gateway",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --metadata-name MyClass --metadata-type ApexClass --pipeline-id <id> --source-org-id <id> --source-credential-id <id>",
+        "cat request.json | <%= config.bin %> <%= command.id %> --stdin",
+        "<%= config.bin %> <%= command.id %> --from-changes --base-ref origin/main --retrieve-mode all --pipeline-id <id> --source-org-id <id> --source-credential-id <id>"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-ref": {
+          "description": "Base Git ref used with --from-changes",
+          "name": "base-ref",
+          "default": "origin/main",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "char": "f",
+          "description": "Path to a JSON dependency request body",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "from-changes": {
+          "description": "Build metadata selections from committed branch changes and staged index files",
+          "name": "from-changes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "metadata-category": {
+          "description": "Optional metadata category",
+          "name": "metadata-category",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metadata-name": {
+          "description": "Metadata component name",
+          "name": "metadata-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metadata-raw-json": {
+          "description": "Optional raw metadata JSON for the selection",
+          "name": "metadata-raw-json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metadata-type": {
+          "description": "Metadata type, for example ApexClass",
+          "name": "metadata-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "module-type": {
+          "description": "Optional addon module type",
+          "name": "module-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "vlocity",
+            "data_cloud"
+          ],
+          "type": "option"
+        },
+        "pipeline-id": {
+          "description": "Pipeline Id",
+          "name": "pipeline-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "platform-experience": {
+          "description": "Gateway platform experience header",
+          "name": "platform-experience",
+          "default": "salesforce",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "salesforce",
+            "sfdx",
+            "metacache",
+            "db"
+          ],
+          "type": "option"
+        },
+        "result-id": {
+          "description": "Optional result Id from a prior metadata operation",
+          "name": "result-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "retrieve-mode": {
+          "description": "Dependency retrieve mode",
+          "name": "retrieve-mode",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "all",
+            "diff_only"
+          ],
+          "type": "option"
+        },
+        "source-credential-id": {
+          "description": "Source org credential Id",
+          "name": "source-credential-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "source-org-id": {
+          "description": "Source org Id",
+          "name": "source-org-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stdin": {
+          "description": "Read a JSON dependency request body from stdin",
+          "name": "stdin",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "target-org-id": {
+          "description": "Target org Id",
+          "name": "target-org-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:metadata:dependency:list",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "metadata",
+        "dependency",
+        "list.js"
+      ]
+    },
     "cicd:repository:auth:https:configure": {
       "aliases": [],
       "args": {
@@ -20043,5 +20433,5 @@
       ]
     }
   },
-  "version": "1.0.0-beta.8"
+  "version": "1.0.0-rc.0"
 }