@copado/agentia-cli 0.116.0-alpha.0 → 0.118.0-alpha.0

package/oclif.manifest.json

@@ -2020,6 +2020,168 @@
         "update.js"
       ]
     },
+    "cicd:credential:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a Copado environment credential",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\"",
+        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\" --default",
+        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\" --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "default": {
+          "description": "Mark this credential as the environment default",
+          "name": "default",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "environmentid": {
+          "description": "Copado environment ID",
+          "name": "environmentid",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Credential name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:credential:create",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "credential",
+        "create.js"
+      ]
+    },
+    "cicd:credential:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List credentials for a Copado environment",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --environmentid <environment-id>",
+        "<%= config.bin %> <%= command.id %> --environmentid \"Dev Sandbox\"",
+        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "environmentid": {
+          "description": "Copado environment ID",
+          "name": "environmentid",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:credential:list",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "credential",
+        "list.js"
+      ]
+    },
+    "cicd:credential:update": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Copado credential ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update a Copado environment credential by ID",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --name \"CI User\"",
+        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --default",
+        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --no-default --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "default": {
+          "description": "Mark this credential as the environment default",
+          "name": "default",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "environmentid": {
+          "description": "Copado environment ID",
+          "name": "environmentid",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Credential name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:credential:update",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "credential",
+        "update.js"
+      ]
+    },
     "cicd:environment:create": {
       "aliases": [],
       "args": {
@@ -2431,168 +2593,6 @@
         "update.js"
       ]
     },
-    "cicd:credential:create": {
-      "aliases": [],
-      "args": {},
-      "description": "Create a Copado environment credential",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\"",
-        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\" --default",
-        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\" --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "default": {
-          "description": "Mark this credential as the environment default",
-          "name": "default",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "environmentid": {
-          "description": "Copado environment ID",
-          "name": "environmentid",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "Credential name",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cicd:credential:create",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "credential",
-        "create.js"
-      ]
-    },
-    "cicd:credential:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List credentials for a Copado environment",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --environmentid <environment-id>",
-        "<%= config.bin %> <%= command.id %> --environmentid \"Dev Sandbox\"",
-        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "environmentid": {
-          "description": "Copado environment ID",
-          "name": "environmentid",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cicd:credential:list",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "credential",
-        "list.js"
-      ]
-    },
-    "cicd:credential:update": {
-      "aliases": [],
-      "args": {
-        "id": {
-          "description": "Copado credential ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Update a Copado environment credential by ID",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --name \"CI User\"",
-        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --default",
-        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --no-default --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "default": {
-          "description": "Mark this credential as the environment default",
-          "name": "default",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "environmentid": {
-          "description": "Copado environment ID",
-          "name": "environmentid",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "Credential name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cicd:credential:update",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "credential",
-        "update.js"
-      ]
-    },
     "cicd:function:defaults": {
       "aliases": [],
       "args": {},
@@ -5582,11 +5582,8 @@
           "required": false
         }
       },
-      "description": "Commit user story work locally or through the Copado cloud commit API. With --local (the default) it runs a plain git commit and records the Copado selections lastPermissionSelected, lastFullMetadataSelected, and lastApexTestClassesSelected in .agentia/config.user.json for `cicd work push`. With --cloud it preflights the story, submits POST /release/commit, and polls the job monitor by default.",
+      "description": "Create a Copado cloud metadata commit for a user story. Requires --cloud: preflights the story, submits POST /release/commit, and polls the job monitor by default. For local Git work, use git add/commit then `cicd work publish`. Permission and full-metadata selections belong on `cicd work publish`.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --local --all",
-        "<%= config.bin %> <%= command.id %> --local -a -m \"US-0000001 add account service\" --permissions CustomField:Account.SLA__c,ApexClass:AccountService --apex-test-classes MyTest,OtherTest",
-        "<%= config.bin %> <%= command.id %> --local -a -m \"US-0000001 full onboarding permission set\" --full-metadata PermissionSet:Sales_Onboarding",
         "<%= config.bin %> <%= command.id %> --cloud --message \"Commit AccountService\" --metadata-name AccountService --metadata-type ApexClass --metadata-category SFDX --action Add",
         "<%= config.bin %> <%= command.id %> a07XXXXXXXXXXXXXXX --cloud --message \"Update Aura files\" --metadata-name accountEditor --metadata-type AuraDefinitionBundle --metadata-category SFDX --action SelectiveCommit --selection accountEditor/accountEditor.cmp --selection accountEditor/accountEditorController.js",
         "cat commit-request.json | <%= config.bin %> <%= command.id %> --cloud --stdin --json"
@@ -5613,20 +5610,6 @@
           ],
           "type": "option"
         },
-        "all": {
-          "char": "a",
-          "description": "Local commit only. Stage every tracked modification before committing, like `git commit -a`.",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "apex-test-classes": {
-          "description": "Local commit only. Comma-separated Apex test class names stored as lastApexTestClassesSelected for `cicd work push`. Pass an empty value to clear it.",
-          "name": "apex-test-classes",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "base-branch": {
           "description": "Optional base branch to include in the commit request.",
           "name": "base-branch",
@@ -5635,7 +5618,7 @@
           "type": "option"
         },
         "cloud": {
-          "description": "Use the Copado cloud commit API instead of a local git commit.",
+          "description": "Create a Copado cloud metadata commit (POST /release/commit). Required. For local Git work, use git commit then `cicd work publish`.",
           "name": "cloud",
           "allowNo": false,
           "type": "boolean"
@@ -5661,22 +5644,9 @@
           "multiple": false,
           "type": "option"
         },
-        "full-metadata": {
-          "description": "Local commit only. Comma-separated type-prefixed metadata such as Profile:Sales_User,PermissionSet:Sales_Onboarding, stored as lastFullMetadataSelected and sent as `cicd work push` fullMetadata corrections. The named metadata is committed as a complete file, so every permission it contains is applied instead of only the permissions selected with --permissions. Pass an empty value to clear it.",
-          "name": "full-metadata",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "local": {
-          "description": "Run a local git commit and record Copado selections. Used by default when --cloud is omitted.",
-          "name": "local",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "message": {
           "char": "m",
-          "description": "Commit message. Defaults to \"<lastWorkItem> <lastWorkItemTitle>\" for a local commit; required for a cloud commit unless provided by JSON input.",
+          "description": "Commit message. Required unless provided by JSON input.",
           "name": "message",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -5717,13 +5687,6 @@
           "multiple": false,
           "type": "option"
         },
-        "permissions": {
-          "description": "Local commit only. Comma-separated type-prefixed metadata such as CustomField:Account.SLA__c,ApexClass:AccountService, stored as lastPermissionSelected and sent as `cicd work push` RetrieveOnly corrections. The named metadata is not committed or deployed; it filters which permissions are updated inside the committed permission sets and profiles so other permissions are not overwritten. Pass an empty value to clear it.",
-          "name": "permissions",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "platform-experience": {
           "description": "Initial platform-experience header for preflight. The preflight response wins for commit.",
           "name": "platform-experience",
@@ -6393,10 +6356,10 @@
         "promote.js"
       ]
     },
-    "cicd:work:push": {
+    "cicd:work:publish": {
       "aliases": [],
       "args": {},
-      "description": "Push 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 push\" 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 when needed, 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.",
+      "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 when needed, 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. `cicd work push` is a compatibility alias of this command.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --permissions CustomField:Account.SLA__c,ApexClass:AccountService",
@@ -6413,14 +6376,70 @@
           "type": "boolean"
         },
         "full-metadata": {
-          "description": "Comma-separated type-prefixed metadata such as Profile:Sales_User,PermissionSet:Sales_Onboarding, added to lastFullMetadataSelected for this push and sent as headless push fullMetadata corrections. The named metadata is committed as a complete file, so it is never decomposed into nested metadata. Not stored; use `cicd work commit --full-metadata` to record it.",
+          "description": "Comma-separated type-prefixed metadata such as Profile:Sales_User,PermissionSet:Sales_Onboarding, added for this publish and sent as headless push fullMetadata corrections. The named metadata is committed as a complete file, so it is never decomposed into nested metadata. Not stored.",
           "name": "full-metadata",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "permissions": {
-          "description": "Comma-separated type-prefixed metadata such as CustomField:Account.SLA__c,ApexClass:AccountService, added to lastPermissionSelected for this push and sent as headless push RetrieveOnly corrections. Not stored; use `cicd work commit --permissions` to record it.",
+          "description": "Comma-separated type-prefixed metadata such as CustomField:Account.SLA__c,ApexClass:AccountService, added for this publish and sent as headless push RetrieveOnly corrections. Not stored.",
+          "name": "permissions",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "skip-nested-metadata-detection": {
+          "description": "Do not detect the nested metadata changed across the branch (also configurable via skipNestedMetadataDetection in .agentia/config.json or .agentia/config.user.json)",
+          "name": "skip-nested-metadata-detection",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:work:publish",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "work",
+        "publish.js"
+      ]
+    },
+    "cicd:work:push": {
+      "aliases": [],
+      "args": {},
+      "description": "Alias of cicd work publish. Publishes the current feature/<lastWorkItem> branch and registers commits with Copado. Prefer: agentia cicd work publish.",
+      "examples": [
+        "<%= config.bin %> cicd work publish",
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --skip-nested-metadata-detection",
+        "<%= config.bin %> <%= command.id %> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "full-metadata": {
+          "description": "Comma-separated type-prefixed metadata such as Profile:Sales_User,PermissionSet:Sales_Onboarding, added for this publish and sent as headless push fullMetadata corrections. The named metadata is committed as a complete file, so it is never decomposed into nested metadata. Not stored.",
+          "name": "full-metadata",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "permissions": {
+          "description": "Comma-separated type-prefixed metadata such as CustomField:Account.SLA__c,ApexClass:AccountService, added for this publish and sent as headless push RetrieveOnly corrections. Not stored.",
           "name": "permissions",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -6459,7 +6478,7 @@
           "required": false
         }
       },
-      "description": "Set the active work item and prepare a local feature branch. Calls the CICD gateway work/set endpoint, requires a clean tracked working tree, fetches the work item base branch from origin, then creates or checks out feature/<user-story-name>. After work/set returns, compares the Story source credential with the CICD project default: warns when the default or Story credential is missing, and warns without changing the Story when they differ (shows the current credential and environment; use work update to change it). With --none, clears every last* key from `.agentia/config.user.json` and checks out the previous lastBaseBranch when present, else main, else master, else stays put.",
+      "description": "Set the active work item and prepare a local feature branch. Calls the CICD gateway work/set endpoint, requires a clean tracked working tree, fetches the work item base branch from origin, then creates or checks out feature/<user-story-name>. A gateway warning prints the message, skips git, and leaves local work context unchanged. After work/set returns, compares the Story source credential with the CICD project default: warns when the default or Story credential is missing, and warns without changing the Story when they differ (shows the current credential and environment; use work update to change it). With --none, clears every last* key from `.agentia/config.user.json` and checks out the previous lastBaseBranch when present, else main, else master, else stays put.",
       "examples": [
         "<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU",
         "<%= config.bin %> <%= command.id %> US-0001 --json",
@@ -6514,7 +6533,7 @@
           "required": false
         }
       },
-      "description": "Get status for a work item, including related job executions and local branch metadata. Uses the given user story ID/name, or the last work item from `agentia cicd work set`. Use --metadata-list-only to retrieve only local branch metadata without an API call.",
+      "description": "Get status for a work item, including related job executions. Includes local branch metadata when lastBaseBranch is recorded by `work set`. Uses the given user story ID/name, or the last work item from `agentia cicd work set`. Use --metadata-list-only to retrieve only local branch metadata without an API call.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> US-0001",
@@ -6556,13 +6575,14 @@
     "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). With --done, 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). 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",
         "<%= config.bin %> <%= command.id %> --skip-local-tests",
         "<%= config.bin %> <%= command.id %> --skip-pull-request",
         "<%= config.bin %> <%= command.id %> --done",
+        "<%= config.bin %> <%= command.id %> --deploy",
         "<%= config.bin %> <%= command.id %> --done --skip-nested-metadata-detection",
         "<%= config.bin %> <%= command.id %> --json"
       ],
@@ -6587,8 +6607,14 @@
           "multiple": false,
           "type": "option"
         },
+        "deploy": {
+          "description": "Alias of --done: promote instead of validate-only (Copado UI Submit promote)",
+          "name": "deploy",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "done": {
-          "description": "Promote instead of validate-only (Copado UI Submit promote); honors --skip-nested-metadata-detection",
+          "description": "Promote instead of validate-only (Copado UI Submit promote); honors --skip-nested-metadata-detection. --deploy is an alias of --done.",
           "name": "done",
           "allowNo": false,
           "type": "boolean"
@@ -6626,7 +6652,7 @@
     "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 — the same local gates as work submit. With --cloud it runs remote Copado quality gates (not implemented yet).",
+      "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).",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --local --apex-test-classes=MyTest,OtherTest",
@@ -17264,6 +17290,60 @@
         "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. Prints the test-run summary when the run passes, or failing tests with their messages and stack traces when it fails.",
+      "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"
+      ],
+      "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",
+          "name": "apex-test-classes",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "work",
+        "test",
+        "apex.js"
+      ]
+    },
     "testing:job:schedule:get": {
       "aliases": [],
       "args": {
@@ -17793,5 +17873,5 @@
       ]
     }
   },
-  "version": "0.116.0-alpha.0"
+  "version": "0.118.0-alpha.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@copado/agentia-cli",
   "description": "Command-line interface for Agentia",
-  "version": "0.116.0-alpha.0",
+  "version": "0.118.0-alpha.0",
   "author": "Copado Solutions",
   "bin": {
     "agentia": "./bin/run.js"
@@ -191,6 +191,9 @@
       "cicd:work:deployment-step": {
         "description": "Manage user story deployment steps"
       },
+      "cicd:work:test": {
+        "description": "Run quality gates and Apex tests for a work item"
+      },
       "cicd:promotion": {
         "description": "Manage Copado promotions"
       },