@copado/agentia-cli 1.3.0 → 1.4.0

package/oclif.manifest.json

@@ -2447,11 +2447,11 @@
           "required": false
         }
       },
-      "description": "Create a Copado cloud metadata commit for a user story.\nPreflights the story, submits POST /release/commit, and polls the job monitor by default.\nFor local Git work, use git add/commit then `cicd work publish`. Permission and full-metadata selections belong on `cicd work publish`.\n\nNOTE: Do not use this command along with local development (git operations, cicd work push/submit).",
+      "description": "Create a Copado cloud metadata commit for a user story.\nPreflights the story, submits POST /release/commit, and polls the job monitor by default.\nSimple --metadata-* flags commit exactly one component. Use --file or --stdin with a changes[] array for multiple components.\nFor local Git work, use git add/commit then `cicd work publish`. Permission and full-metadata selections belong on `cicd work publish`.\n\nNOTE: Do not use this command along with local development (git operations, cicd work push/submit).",
       "examples": [
         "<%= 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\"}]}",
+        "<%= config.bin %> <%= command.id %> --file commit-request.json  # {\"message\":\"Commit metadata\",\"changes\":[{\"a\":\"Add\",\"c\":\"SFDX\",\"n\":\"AccountService\",\"t\":\"ApexClass\"},{\"a\":\"Add\",\"c\":\"SFDX\",\"n\":\"AccountTrigger\",\"t\":\"ApexTrigger\"}]}",
         "cat commit-request.json | <%= config.bin %> <%= command.id %> --stdin --json"
       ],
       "flags": {
@@ -2513,7 +2513,7 @@
         },
         "file": {
           "char": "f",
-          "description": "Path to a JSON commit request body.",
+          "description": "Path to a JSON commit request with message and changes[] (one object per metadata component).",
           "name": "file",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2576,7 +2576,7 @@
           "type": "option"
         },
         "stdin": {
-          "description": "Read a JSON commit request body from stdin.",
+          "description": "Read a JSON commit request with message and changes[] from stdin.",
           "name": "stdin",
           "allowNo": false,
           "type": "boolean"
@@ -2673,7 +2673,7 @@
           "type": "option"
         },
         "promotion-id": {
-          "description": "Explicit 18-character Promotion ID when the User Story belongs to multiple promotions.",
+          "description": "Explicit 18-character Promotion ID when the User Story belongs to multiple promotions. Used as is; never creates a promotion.",
           "name": "promotion-id",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -6777,19 +6777,19 @@
         "run.js"
       ]
     },
-    "cicd:repository:create": {
+    "cicd:promotion:status": {
       "aliases": [],
       "args": {
-        "name": {
-          "description": "Name of the Copado Git repository to create",
-          "name": "name",
+        "id": {
+          "description": "Copado promotion ID",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Create a Copado Git repository shell",
+      "description": "Show actionable status for a Copado promotion: user stories, current job step, queue summary, and whether a Manual Task or queue item needs attention.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> my-repo --source-format DX --provider Github",
-        "<%= config.bin %> <%= command.id %> my-repo --source-format DX --provider GitLab --json"
+        "<%= config.bin %> <%= command.id %> <promotion-id>",
+        "<%= config.bin %> <%= command.id %> <promotion-id> --json"
       ],
       "flags": {
         "json": {
@@ -6806,52 +6806,74 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "allow-functions-git-cache": {
-          "description": "Allow Functions Git cache for this repository",
-          "name": "allow-functions-git-cache",
-          "allowNo": true,
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:promotion:status",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "promotion",
+        "status.js"
+      ]
+    },
+    "cicd:stage:create": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Stage name",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Create a Copado stage",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> Build",
+        "<%= config.bin %> <%= command.id %> Test --meta-stage Test"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
           "type": "boolean"
         },
-        "copado-tunnel-enabled": {
-          "description": "Enable Copado tunnel for this repository",
-          "name": "copado-tunnel-enabled",
-          "allowNo": true,
-          "type": "boolean"
+        "cicd-connection": {
+          "description": "Named CICD connection for this invocation only (see agentia auth set --connection). Does not change stored default auth.",
+          "name": "cicd-connection",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "provider": {
-          "description": "Git repository provider",
-          "name": "provider",
-          "required": true,
+        "meta-stage": {
+          "description": "Meta stage (common values: Build, Test, Production; custom values are allowed)",
+          "name": "meta-stage",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "Github",
-            "Bitbucket",
-            "GitLab",
-            "Azure",
-            "Microsoft Team Service",
-            "Copado Version Control",
-            "Others"
-          ],
           "type": "option"
         },
-        "source-format": {
-          "description": "Git repository source format (default: DX)",
-          "name": "source-format",
-          "default": "DX",
+        "name": {
+          "description": "Stage name",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "Metadata",
-            "DX"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:repository:create",
+      "id": "cicd:stage:create",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -6863,23 +6885,23 @@
         "dist",
         "commands",
         "cicd",
-        "repository",
+        "stage",
         "create.js"
       ]
     },
-    "cicd:repository:delete": {
+    "cicd:stage:delete": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Copado Git repository ID",
+          "description": "Stage ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Delete a Copado Git repository by ID",
+      "description": "Delete a Copado stage",
       "examples": [
-        "<%= config.bin %> <%= command.id %> repo-001",
-        "<%= config.bin %> <%= command.id %> repo-001 --json"
+        "<%= config.bin %> <%= command.id %> <stage-id>",
+        "<%= config.bin %> <%= command.id %> <stage-id> --yes --json"
       ],
       "flags": {
         "json": {
@@ -6896,11 +6918,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Confirm deletion without prompting",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:repository:delete",
+      "id": "cicd:stage:delete",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -6912,23 +6941,23 @@
         "dist",
         "commands",
         "cicd",
-        "repository",
+        "stage",
         "delete.js"
       ]
     },
-    "cicd:repository:get": {
+    "cicd:stage:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Copado Git repository ID",
+          "description": "Stage ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a Copado Git repository by ID",
+      "description": "Get a Copado stage",
       "examples": [
-        "<%= config.bin %> <%= command.id %> repo-001",
-        "<%= config.bin %> <%= command.id %> repo-001 --json"
+        "<%= config.bin %> <%= command.id %> <stage-id>",
+        "<%= config.bin %> <%= command.id %> <stage-id> --json"
       ],
       "flags": {
         "json": {
@@ -6949,7 +6978,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:repository:get",
+      "id": "cicd:stage:get",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -6961,20 +6990,17 @@
         "dist",
         "commands",
         "cicd",
-        "repository",
+        "stage",
         "get.js"
       ]
     },
-    "cicd:repository:list": {
+    "cicd:stage:list": {
       "aliases": [],
       "args": {},
-      "description": "List Copado Git repositories",
+      "description": "List Copado stages",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --page-size 50",
-        "<%= config.bin %> <%= command.id %> --cursor NEXT --json",
-        "<%= config.bin %> <%= command.id %> --name copado-demo --provider Github",
-        "<%= config.bin %> <%= command.id %> --source-format DX --json"
+        "<%= config.bin %> <%= command.id %> --json"
       ],
       "flags": {
         "json": {
@@ -7005,45 +7031,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "name": {
-          "description": "Filter by name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "provider": {
-          "description": "Filter by Git repository provider",
-          "name": "provider",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "Github",
-            "Bitbucket",
-            "GitLab",
-            "Azure",
-            "Microsoft Team Service",
-            "Copado Version Control",
-            "Others"
-          ],
-          "type": "option"
-        },
-        "source-format": {
-          "description": "Filter by Git repository source format",
-          "name": "source-format",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "Metadata",
-            "DX"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:repository:list",
+      "id": "cicd:stage:list",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -7055,23 +7047,23 @@
         "dist",
         "commands",
         "cicd",
-        "repository",
+        "stage",
         "list.js"
       ]
     },
-    "cicd:repository:open": {
+    "cicd:stage:open": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Copado Git repository ID",
+          "description": "Stage ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Open a Copado Git repository in the browser",
+      "description": "Open a Copado stage in the browser",
       "examples": [
-        "<%= config.bin %> <%= command.id %> <repository-id>",
-        "<%= config.bin %> <%= command.id %> <repository-id> --json"
+        "<%= config.bin %> <%= command.id %> <stage-id>",
+        "<%= config.bin %> <%= command.id %> <stage-id> --json"
       ],
       "flags": {
         "json": {
@@ -7092,7 +7084,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:repository:open",
+      "id": "cicd:stage:open",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -7104,23 +7096,23 @@
         "dist",
         "commands",
         "cicd",
-        "repository",
+        "stage",
         "open.js"
       ]
     },
-    "cicd:repository:reset": {
+    "cicd:stage:update": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Copado Git repository ID",
+          "description": "Stage ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Reset a Copado Git repository and its authentication configuration",
+      "description": "Update a Copado stage",
       "examples": [
-        "<%= config.bin %> <%= command.id %> repo-001 --yes",
-        "<%= config.bin %> <%= command.id %> repo-001 --yes --json"
+        "<%= config.bin %> <%= command.id %> <stage-id> --name QA",
+        "<%= config.bin %> <%= command.id %> <stage-id> --meta-stage Test"
       ],
       "flags": {
         "json": {
@@ -7138,17 +7130,24 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "char": "y",
-          "description": "Confirm reset without prompting",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
+        "meta-stage": {
+          "description": "Meta stage (common values: Build, Test, Production; custom values are allowed)",
+          "name": "meta-stage",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Stage name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:repository:reset",
+      "id": "cicd:stage:update",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -7160,24 +7159,23 @@
         "dist",
         "commands",
         "cicd",
-        "repository",
-        "reset.js"
+        "stage",
+        "update.js"
       ]
     },
-    "cicd:repository:update": {
+    "cicd:repository:create": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Copado Git repository ID",
-          "name": "id",
+        "name": {
+          "description": "Name of the Copado Git repository to create",
+          "name": "name",
           "required": true
         }
       },
-      "description": "Update a Copado Git repository by ID",
+      "description": "Create a Copado Git repository shell",
       "examples": [
-        "<%= config.bin %> <%= command.id %> repo-001 --uri https://github.com/org/repo.git",
-        "<%= config.bin %> <%= command.id %> repo-001 --clear-uri",
-        "<%= config.bin %> <%= command.id %> repo-001 --provider GitLab --json"
+        "<%= config.bin %> <%= command.id %> my-repo --source-format DX --provider Github",
+        "<%= config.bin %> <%= command.id %> my-repo --source-format DX --provider GitLab --json"
       ],
       "flags": {
         "json": {
@@ -7207,81 +7205,10 @@
           "allowNo": true,
           "type": "boolean"
         },
-        "clear-branch-base-url": {
-          "description": "Clear the repository branch base URL",
-          "name": "clear-branch-base-url",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "clear-commit-base-url": {
-          "description": "Clear the repository commit base URL",
-          "name": "clear-commit-base-url",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "clear-pull-request-base-url": {
-          "description": "Clear the repository pull request base URL",
-          "name": "clear-pull-request-base-url",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "clear-tag-base-url": {
-          "description": "Clear the repository tag base URL",
-          "name": "clear-tag-base-url",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "clear-uri": {
-          "description": "Clear the repository clone URI",
-          "name": "clear-uri",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "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"
-        },
-        "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",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "uri": {
-          "description": "Repository clone URI",
-          "name": "uri",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "Repository name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "provider": {
           "description": "Git repository provider",
           "name": "provider",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
@@ -7296,8 +7223,9 @@
           "type": "option"
         },
         "source-format": {
-          "description": "Git repository source format",
+          "description": "Git repository source format (default: DX)",
           "name": "source-format",
+          "default": "DX",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
@@ -7309,7 +7237,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:repository:update",
+      "id": "cicd:repository:create",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -7322,10 +7250,10 @@
         "commands",
         "cicd",
         "repository",
-        "update.js"
+        "create.js"
       ]
     },
-    "cicd:repository:validate": {
+    "cicd:repository:delete": {
       "aliases": [],
       "args": {
         "id": {
@@ -7334,7 +7262,7 @@
           "required": true
         }
       },
-      "description": "Validate Copado Git repository authentication",
+      "description": "Delete a Copado Git repository by ID",
       "examples": [
         "<%= config.bin %> <%= command.id %> repo-001",
         "<%= config.bin %> <%= command.id %> repo-001 --json"
@@ -7358,7 +7286,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:repository:validate",
+      "id": "cicd:repository:delete",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -7371,22 +7299,68 @@
         "commands",
         "cicd",
         "repository",
-        "validate.js"
+        "delete.js"
       ]
     },
-    "cicd:stage:create": {
+    "cicd:repository:get": {
       "aliases": [],
       "args": {
-        "name": {
-          "description": "Stage name",
-          "name": "name",
+        "id": {
+          "description": "Copado Git repository ID",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Create a Copado stage",
+      "description": "Get a Copado Git repository by ID",
       "examples": [
-        "<%= config.bin %> <%= command.id %> Build",
-        "<%= config.bin %> <%= command.id %> Test --meta-stage Test"
+        "<%= config.bin %> <%= command.id %> repo-001",
+        "<%= config.bin %> <%= command.id %> repo-001 --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "cicd-connection": {
+          "description": "Named CICD connection for this invocation only (see agentia auth set --connection). Does not change stored default auth.",
+          "name": "cicd-connection",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:repository:get",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "repository",
+        "get.js"
+      ]
+    },
+    "cicd:repository:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List Copado Git repositories",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --page-size 50",
+        "<%= config.bin %> <%= command.id %> --cursor NEXT --json",
+        "<%= config.bin %> <%= command.id %> --name copado-demo --provider Github",
+        "<%= config.bin %> <%= command.id %> --source-format DX --json"
       ],
       "flags": {
         "json": {
@@ -7404,24 +7378,58 @@
           "multiple": false,
           "type": "option"
         },
-        "meta-stage": {
-          "description": "Meta stage (common values: Build, Test, Production; custom values are allowed)",
-          "name": "meta-stage",
+        "cursor": {
+          "description": "Opaque pagination cursor from a previous list response (nextCursor)",
+          "name": "cursor",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Number of records per page (1-200)",
+          "name": "page-size",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "name": {
-          "description": "Stage name",
+          "description": "Filter by name",
           "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "provider": {
+          "description": "Filter by Git repository provider",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "Github",
+            "Bitbucket",
+            "GitLab",
+            "Azure",
+            "Microsoft Team Service",
+            "Copado Version Control",
+            "Others"
+          ],
+          "type": "option"
+        },
+        "source-format": {
+          "description": "Filter by Git repository source format",
+          "name": "source-format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "Metadata",
+            "DX"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:stage:create",
+      "id": "cicd:repository:list",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -7433,23 +7441,23 @@
         "dist",
         "commands",
         "cicd",
-        "stage",
-        "create.js"
+        "repository",
+        "list.js"
       ]
     },
-    "cicd:stage:delete": {
+    "cicd:repository:open": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Stage ID",
+          "description": "Copado Git repository ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Delete a Copado stage",
+      "description": "Open a Copado Git repository in the browser",
       "examples": [
-        "<%= config.bin %> <%= command.id %> <stage-id>",
-        "<%= config.bin %> <%= command.id %> <stage-id> --yes --json"
+        "<%= config.bin %> <%= command.id %> <repository-id>",
+        "<%= config.bin %> <%= command.id %> <repository-id> --json"
       ],
       "flags": {
         "json": {
@@ -7466,18 +7474,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Confirm deletion without prompting",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:stage:delete",
+      "id": "cicd:repository:open",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -7489,23 +7490,23 @@
         "dist",
         "commands",
         "cicd",
-        "stage",
-        "delete.js"
+        "repository",
+        "open.js"
       ]
     },
-    "cicd:stage:get": {
+    "cicd:repository:reset": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Stage ID",
+          "description": "Copado Git repository ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a Copado stage",
+      "description": "Reset a Copado Git repository and its authentication configuration",
       "examples": [
-        "<%= config.bin %> <%= command.id %> <stage-id>",
-        "<%= config.bin %> <%= command.id %> <stage-id> --json"
+        "<%= config.bin %> <%= command.id %> repo-001 --yes",
+        "<%= config.bin %> <%= command.id %> repo-001 --yes --json"
       ],
       "flags": {
         "json": {
@@ -7522,11 +7523,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Confirm reset without prompting",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:stage:get",
+      "id": "cicd:repository:reset",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -7538,17 +7546,24 @@
         "dist",
         "commands",
         "cicd",
-        "stage",
-        "get.js"
+        "repository",
+        "reset.js"
       ]
     },
-    "cicd:stage:list": {
+    "cicd:repository:update": {
       "aliases": [],
-      "args": {},
-      "description": "List Copado stages",
+      "args": {
+        "id": {
+          "description": "Copado Git repository ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update a Copado Git repository by ID",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --json"
+        "<%= config.bin %> <%= command.id %> repo-001 --uri https://github.com/org/repo.git",
+        "<%= config.bin %> <%= command.id %> repo-001 --clear-uri",
+        "<%= config.bin %> <%= command.id %> repo-001 --provider GitLab --json"
       ],
       "flags": {
         "json": {
@@ -7558,81 +7573,129 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "cicd-connection": {
-          "description": "Named CICD connection for this invocation only (see agentia auth set --connection). Does not change stored default auth.",
-          "name": "cicd-connection",
-          "required": false,
+        "cicd-connection": {
+          "description": "Named CICD connection for this invocation only (see agentia auth set --connection). Does not change stored default auth.",
+          "name": "cicd-connection",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "allow-functions-git-cache": {
+          "description": "Allow Functions Git cache for this repository",
+          "name": "allow-functions-git-cache",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "copado-tunnel-enabled": {
+          "description": "Enable Copado tunnel for this repository",
+          "name": "copado-tunnel-enabled",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "clear-branch-base-url": {
+          "description": "Clear the repository branch base URL",
+          "name": "clear-branch-base-url",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "clear-commit-base-url": {
+          "description": "Clear the repository commit base URL",
+          "name": "clear-commit-base-url",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "clear-pull-request-base-url": {
+          "description": "Clear the repository pull request base URL",
+          "name": "clear-pull-request-base-url",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "clear-tag-base-url": {
+          "description": "Clear the repository tag base URL",
+          "name": "clear-tag-base-url",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "clear-uri": {
+          "description": "Clear the repository clone URI",
+          "name": "clear-uri",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "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"
         },
-        "cursor": {
-          "description": "Opaque pagination cursor from a previous list response (nextCursor)",
-          "name": "cursor",
+        "pull-request-base-url": {
+          "description": "Base URL for repository pull request links",
+          "name": "pull-request-base-url",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "page-size": {
-          "description": "Number of records per page (1-200)",
-          "name": "page-size",
+        "tag-base-url": {
+          "description": "Base URL for repository tag links",
+          "name": "tag-base-url",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cicd:stage:list",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "experimental": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "stage",
-        "list.js"
-      ]
-    },
-    "cicd:stage:open": {
-      "aliases": [],
-      "args": {
-        "id": {
-          "description": "Stage ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Open a Copado stage in the browser",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> <stage-id>",
-        "<%= config.bin %> <%= command.id %> <stage-id> --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
         },
-        "cicd-connection": {
-          "description": "Named CICD connection for this invocation only (see agentia auth set --connection). Does not change stored default auth.",
-          "name": "cicd-connection",
-          "required": false,
+        "uri": {
+          "description": "Repository clone URI",
+          "name": "uri",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Repository name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "provider": {
+          "description": "Git repository provider",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "Github",
+            "Bitbucket",
+            "GitLab",
+            "Azure",
+            "Microsoft Team Service",
+            "Copado Version Control",
+            "Others"
+          ],
+          "type": "option"
+        },
+        "source-format": {
+          "description": "Git repository source format",
+          "name": "source-format",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "Metadata",
+            "DX"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:stage:open",
+      "id": "cicd:repository:update",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -7644,23 +7707,23 @@
         "dist",
         "commands",
         "cicd",
-        "stage",
-        "open.js"
+        "repository",
+        "update.js"
       ]
     },
-    "cicd:stage:update": {
+    "cicd:repository:validate": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Stage ID",
+          "description": "Copado Git repository ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Update a Copado stage",
+      "description": "Validate Copado Git repository authentication",
       "examples": [
-        "<%= config.bin %> <%= command.id %> <stage-id> --name QA",
-        "<%= config.bin %> <%= command.id %> <stage-id> --meta-stage Test"
+        "<%= config.bin %> <%= command.id %> repo-001",
+        "<%= config.bin %> <%= command.id %> repo-001 --json"
       ],
       "flags": {
         "json": {
@@ -7677,25 +7740,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "meta-stage": {
-          "description": "Meta stage (common values: Build, Test, Production; custom values are allowed)",
-          "name": "meta-stage",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "Stage name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:stage:update",
+      "id": "cicd:repository:validate",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -7707,8 +7756,8 @@
         "dist",
         "commands",
         "cicd",
-        "stage",
-        "update.js"
+        "repository",
+        "validate.js"
       ]
     },
     "cicd:template:defaults": {
@@ -8262,7 +8311,7 @@
         },
         "file": {
           "char": "f",
-          "description": "Path to a JSON commit request body.",
+          "description": "Path to a JSON commit request with message and changes[] (one object per metadata component).",
           "name": "file",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -8325,7 +8374,7 @@
           "type": "option"
         },
         "stdin": {
-          "description": "Read a JSON commit request body from stdin.",
+          "description": "Read a JSON commit request with message and changes[] from stdin.",
           "name": "stdin",
           "allowNo": false,
           "type": "boolean"
@@ -8494,7 +8543,7 @@
           "type": "option"
         },
         "record-type": {
-          "description": "Record type",
+          "description": "Record type DeveloperName",
           "name": "record-type",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -8600,12 +8649,12 @@
       "aliases": [],
       "args": {
         "id": {
-          "description": "User story ID",
+          "description": "User story ID or name",
           "name": "id",
           "required": true
         }
       },
-      "description": "Delete a Copado user story by ID",
+      "description": "Delete a Copado user story by ID or name",
       "examples": [
         "<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU",
         "<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU --json"
@@ -8699,13 +8748,16 @@
     "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, store lastEnvironmentSyncName, resolve the files, and re-run with --continue (optional --promotion). The promotion destination environment supplies the dest org branch and the next-env branch. To discard a conflicted merge, re-run with --abort (optional --promotion); runs git merge --abort and sets the back-promotion status to Draft. After a successful sync, PATCH the back-promotion status to Completed and clear lastEnvironmentSyncName. 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.",
+      "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. On a feature branch, requires published commits first: stops when HEAD is ahead of origin/<feature> and suggests `cicd work publish`. GET user stories ahead and behind. If none are behind, log that and stop. Otherwise create a back-promotion via POST /agentia/headless/work/promote-action (PromoteAction with execute flags false) including those behind stories. 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). Creates promotion/<promotionName> from the dest org branch, merges origin/<next-env> pathspecs into that promotion branch (--no-ff --no-commit, restores non-pathspec paths), commits, merges the promotion branch into the dest org branch, and pushes both refs. If the run started on a feature branch, checks out that branch's changed files (vs lastBaseBranch) from the dest org, commits updates when needed, and tells you to re-check and publish again. If guessed pathspecs still conflict, PATCH the back-promotion status to Merge Conflict, store lastEnvironmentSyncName, resolve the files on promotion/<name>, and re-run with --continue (optional --promotion). To discard a conflicted merge, re-run with --abort (optional --promotion); runs git merge --abort and POST /agentia/headless/work/promote-action/complete with status Cancelled. After a successful sync, when --deployment resolves to local, runs `sf project deploy start --ignore-conflicts` against --sf-alias (Add-only changes), then POST /agentia/headless/work/promote-action/complete with status Completed and the resolved deployment (none|local|cloud; auto chooses local when every change is Add and --sf-alias is set, otherwise cloud). By default polls the cloud deployment JobExecution to a terminal status when deployment is cloud (--no-wait to skip). 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",
         "<%= config.bin %> <%= command.id %> --continue",
         "<%= config.bin %> <%= command.id %> --abort",
         "<%= config.bin %> <%= command.id %> --promotion=P29334 --continue",
+        "<%= config.bin %> <%= command.id %> --destination-environment=dev1 --deployment=local --sf-alias=dev1",
+        "<%= config.bin %> <%= command.id %> --destination-environment=dev1 --deployment=cloud",
+        "<%= config.bin %> <%= command.id %> --destination-environment=dev1 --no-wait",
         "<%= config.bin %> <%= command.id %> --destination-environment=dev1 --json"
       ],
       "flags": {
@@ -8725,7 +8777,7 @@
           "type": "option"
         },
         "abort": {
-          "description": "Abort an in-progress merge (`git merge --abort`) and set the back-promotion status to Draft. Uses --promotion or lastEnvironmentSyncName. Exclusive with --continue.",
+          "description": "Abort an in-progress merge (`git merge --abort`) and cancel the back-promotion via promote-action/complete. Uses --promotion or lastEnvironmentSyncName. Exclusive with --continue.",
           "exclusive": [
             "continue"
           ],
@@ -8742,8 +8794,22 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "deployment": {
+          "description": "How promote-action/complete handles deployment after a successful sync: none (leave deployment job untouched), local (sf project deploy start --ignore-conflicts then mark deployment JobExecution Successful; Add-only changes; requires --sf-alias), cloud (start PromotionDeployAction), or auto (local when every change is Add and --sf-alias is set, otherwise cloud). Sent to the gateway as none|local|cloud (never auto).",
+          "name": "deployment",
+          "default": "auto",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "none",
+            "local",
+            "cloud",
+            "auto"
+          ],
+          "type": "option"
+        },
         "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.",
+          "description": "Credential ID recorded on the environment-sync result as destinationCredentialId. Defaults to the next/source environment defaultCredential, otherwise the first source credential. PromoteAction resolves deployment credentials itself.",
           "name": "destination-credential",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -8782,6 +8848,27 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "sf-alias": {
+          "description": "Salesforce CLI org alias or username for local deployment (`sf project deploy start -o`). Required with --deployment=local; with --deployment=auto enables local when changes are Add-only.",
+          "name": "sf-alias",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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"
         }
       },
       "hasDynamicHelp": false,
@@ -8792,7 +8879,7 @@
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
-      "experimental": false,
+      "experimental": true,
       "isESM": true,
       "relativePath": [
         "dist",
@@ -8806,12 +8893,12 @@
       "aliases": [],
       "args": {
         "id": {
-          "description": "User story ID (defaults to the active work item from `work set`)",
+          "description": "User story ID or name (defaults to the active work item from `work set`)",
           "name": "id",
           "required": false
         }
       },
-      "description": "Get a Copado user story by ID",
+      "description": "Get a Copado user story by ID or name",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU",
@@ -9536,11 +9623,12 @@
     "cicd:work:test": {
       "aliases": [],
       "args": {},
-      "description": "Run quality gates for the current work item. With --local (the default) it runs project-root .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present. When no project script exists it warns, runs the stock Agentia setup sample from a temporary file, then deletes that file. With --cloud it runs remote Copado quality gates (not implemented yet).",
+      "description": "Run quality gates for the current work item. Runs the project-root .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows); when none exists it warns and runs the stock Agentia sample from a temporary file. Every gate runs by default. Use --gate <id> (repeatable or comma-separated) to select gates; the selection is exported as AGENTIA_GATES. Standard ids are apex, lint and lwc; scripts declare gates with `# agentia-gate: <id> - <description>` comments (see --list-gates). `--gate apex` alone skips the script, runs the Apex tests directly and uploads the result to the work item (nested inside a script it does not upload; the outer run reports). With --cloud it runs remote Copado quality gates (not implemented yet).",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --local --apex-test-classes=MyTest,OtherTest",
-        "<%= config.bin %> <%= command.id %> --local --rerun-failed-apex-tests",
+        "<%= config.bin %> <%= command.id %> --gate lint --gate lwc",
+        "<%= config.bin %> <%= command.id %> --gate apex --apex-test-classes=MyTest,OtherTest",
+        "<%= config.bin %> <%= command.id %> --list-gates",
         "<%= config.bin %> <%= command.id %> -e SKIP_LWC_TESTS=1 -e TOOL_API_KEY=secret",
         "<%= config.bin %> <%= command.id %> --json",
         "<%= config.bin %> <%= command.id %> --cloud"
@@ -9561,6 +9649,16 @@
           "multiple": false,
           "type": "option"
         },
+        "all": {
+          "description": "Run every gate in the quality-gates script (the default when no --gate is given).",
+          "exclusive": [
+            "gate",
+            "list-gates"
+          ],
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "apex-test-classes": {
           "description": "Comma-separated Apex test class names passed to local quality gates as AGENTIA_APEX_TEST_CLASSES",
           "name": "apex-test-classes",
@@ -9582,6 +9680,23 @@
           "multiple": true,
           "type": "option"
         },
+        "gate": {
+          "description": "Run only this gate id (for example apex, lint, lwc or a custom id declared in the script). Repeatable or comma-separated. Exported to the script as AGENTIA_GATES.",
+          "exclusive": [
+            "all",
+            "list-gates"
+          ],
+          "name": "gate",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "list-gates": {
+          "description": "List the gates declared in the quality-gates script (or the stock sample) and exit.",
+          "name": "list-gates",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "local": {
           "description": "Run local project-root quality gates scripts. Used by default when --cloud is omitted.",
           "name": "local",
@@ -9589,10 +9704,19 @@
           "type": "boolean"
         },
         "rerun-failed-apex-tests": {
-          "description": "Pass AGENTIA_APEX_RERUN_FAILED=--rerun-failed-apex-tests to local quality gates so sample scripts forward that flag to work test apex.",
+          "description": "Pass AGENTIA_APEX_RERUN_FAILED=--rerun-failed-apex-tests to local quality gates so sample scripts forward that flag to the apex gate.",
           "name": "rerun-failed-apex-tests",
           "allowNo": false,
           "type": "boolean"
+        },
+        "wait": {
+          "char": "w",
+          "description": "Minutes to wait for Apex test results (only with --gate apex alone).",
+          "name": "wait",
+          "default": 60,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -9617,12 +9741,12 @@
       "aliases": [],
       "args": {
         "id": {
-          "description": "User story ID (defaults to the active work item from `work set`)",
+          "description": "User story ID or name (defaults to the active work item from `work set`)",
           "name": "id",
           "required": false
         }
       },
-      "description": "Update a Copado user story by ID",
+      "description": "Update a Copado user story by ID or name",
       "examples": [
         "<%= config.bin %> <%= command.id %> --title \"Updated story\"",
         "<%= config.bin %> <%= command.id %> --custom-field JIRA_Key__c=CICD-1",
@@ -9750,7 +9874,7 @@
           "type": "option"
         },
         "record-type": {
-          "description": "Record type",
+          "description": "Record type DeveloperName",
           "name": "record-type",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -10463,73 +10587,6 @@
         "recorder.js"
       ]
     },
-    "testing:browser:reports": {
-      "aliases": [],
-      "args": {
-        "job-id": {
-          "description": "CRT job ID.",
-          "name": "job-id",
-          "required": false
-        }
-      },
-      "deprecateAliases": true,
-      "description": "List or save report artifacts from an active CRT browser session",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --project <project-id>",
-        "<%= config.bin %> <%= command.id %> --project <project-id> --output-dir ./reports"
-      ],
-      "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": "Active CRT browser session ID.",
-          "name": "session-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "output-dir": {
-          "description": "Directory for log.html, report.html, and output.xml.",
-          "name": "output-dir",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [
-        "testing:live:reports"
-      ],
-      "id": "testing:browser:reports",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "experimental": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "testing",
-        "browser",
-        "reports.js"
-      ]
-    },
     "testing:browser:screenshot": {
       "aliases": [],
       "args": {
@@ -15977,7 +16034,7 @@
           "type": "option"
         },
         "file-id": {
-          "description": "File Id returned by result-file list",
+          "description": "fileId (068...) returned by result-file list; a contentDocumentId (069...) is resolved automatically",
           "name": "file-id",
           "required": true,
           "hasDynamicHelp": false,
@@ -20579,7 +20636,7 @@
     "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.",
+      "description": "Legacy alias of `work test --gate apex`; prefer that form (it is what the sample quality-gate scripts call). Run specified Apex test classes via Salesforce CLI (`sf apex run test`) with code coverage. 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",
@@ -20628,6 +20685,7 @@
         }
       },
       "hasDynamicHelp": false,
+      "hidden": true,
       "hiddenAliases": [],
       "id": "cicd:work:test:apex",
       "pluginAlias": "@copado/agentia-cli",
@@ -22220,5 +22278,5 @@
       ]
     }
   },
-  "version": "1.3.0"
+  "version": "1.4.0"
 }