@copado/agentia-cli 0.56.0-alpha.0 → 0.57.0-alpha.0

package/oclif.manifest.json

@@ -2173,6 +2173,160 @@
         "update.js"
       ]
     },
+    "cicd:metadata:list": {
+      "aliases": [],
+      "args": {},
+      "description": "Search the metadata index for an org via the CICD gateway",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --pipeline-id <id> --source-org-id <id> --source-credential-id <id>",
+        "<%= config.bin %> <%= command.id %> --source Changed --metadata-types ApexClass --limit 100 --pipeline-id <id> --source-org-id <id> --source-credential-id <id>",
+        "<%= config.bin %> <%= command.id %> --source NewAndChanged --find-managed-packages --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "avoid-source-tracking": {
+          "description": "Pass avoidSourceTracking=true to the gateway index route",
+          "name": "avoid-source-tracking",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "filter-type": {
+          "description": "Optional metadata type name filter, for example ApexClass",
+          "name": "filter-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "find-managed-packages": {
+          "description": "Include managed package metadata in the search",
+          "name": "find-managed-packages",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Maximum number of records to return",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metadata-types": {
+          "description": "Optional comma-separated metadata types to include",
+          "name": "metadata-types",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "modified-by": {
+          "description": "Filter by last modified user",
+          "name": "modified-by",
+          "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"
+        },
+        "order-direction": {
+          "description": "Sort direction for last modified date",
+          "name": "order-direction",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ASC",
+            "DESC"
+          ],
+          "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"
+        },
+        "source": {
+          "description": "Index source filter",
+          "name": "source",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "All",
+            "Changed",
+            "Deleted",
+            "New",
+            "NewAndChanged",
+            "PreviouslyCommitted"
+          ],
+          "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"
+        },
+        "target-org-id": {
+          "description": "Optional target org Id",
+          "name": "target-org-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:metadata:list",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "metadata",
+        "list.js"
+      ]
+    },
     "cicd:job:get": {
       "aliases": [],
       "args": {
@@ -2491,172 +2645,18 @@
           "helpGroup": "GLOBAL",
           "name": "json",
           "allowNo": false,
-          "type": "boolean"
-        },
-        "restart": {
-          "description": "Restart the job run (gateway compatibility flag)",
-          "name": "restart",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cicd:job:run",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "job",
-        "run.js"
-      ]
-    },
-    "cicd:metadata:list": {
-      "aliases": [],
-      "args": {},
-      "description": "Search the metadata index for an org via the CICD gateway",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --pipeline-id <id> --source-org-id <id> --source-credential-id <id>",
-        "<%= config.bin %> <%= command.id %> --source Changed --metadata-types ApexClass --limit 100 --pipeline-id <id> --source-org-id <id> --source-credential-id <id>",
-        "<%= config.bin %> <%= command.id %> --source NewAndChanged --find-managed-packages --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "avoid-source-tracking": {
-          "description": "Pass avoidSourceTracking=true to the gateway index route",
-          "name": "avoid-source-tracking",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "filter-type": {
-          "description": "Optional metadata type name filter, for example ApexClass",
-          "name": "filter-type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "find-managed-packages": {
-          "description": "Include managed package metadata in the search",
-          "name": "find-managed-packages",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "limit": {
-          "description": "Maximum number of records to return",
-          "name": "limit",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "metadata-types": {
-          "description": "Optional comma-separated metadata types to include",
-          "name": "metadata-types",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "modified-by": {
-          "description": "Filter by last modified user",
-          "name": "modified-by",
-          "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"
-        },
-        "order-direction": {
-          "description": "Sort direction for last modified date",
-          "name": "order-direction",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "ASC",
-            "DESC"
-          ],
-          "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"
-        },
-        "source": {
-          "description": "Index source filter",
-          "name": "source",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "All",
-            "Changed",
-            "Deleted",
-            "New",
-            "NewAndChanged",
-            "PreviouslyCommitted"
-          ],
-          "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"
-        },
-        "target-org-id": {
-          "description": "Optional target org Id",
-          "name": "target-org-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+          "type": "boolean"
+        },
+        "restart": {
+          "description": "Restart the job run (gateway compatibility flag)",
+          "name": "restart",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:metadata:list",
+      "id": "cicd:job:run",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -2667,8 +2667,8 @@
         "dist",
         "commands",
         "cicd",
-        "metadata",
-        "list.js"
+        "job",
+        "run.js"
       ]
     },
     "cicd:pipeline:get": {
@@ -3169,6 +3169,106 @@
         "open.js"
       ]
     },
+    "cicd:promotion:run": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "18-character Salesforce Promotion ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Preflight, start, and optionally wait for a Copado promotion execution. Use --resume to continue an existing failed or conflict-resolved execution without starting a duplicate promotion.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> a0BXXXXXXXXXXXXXXX --operation merge",
+        "<%= config.bin %> <%= command.id %> a0BXXXXXXXXXXXXXXX --operation merge_and_deploy --json",
+        "<%= config.bin %> <%= command.id %> a0BXXXXXXXXXXXXXXX --resume a4NXXXXXXXXXXXXXXX"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "deployment-step-id": {
+          "description": "Ordered deployment-step Salesforce ID. Can be provided multiple times.",
+          "name": "deployment-step-id",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "ignored-metadata-json": {
+          "description": "JSON array to persist through ignored-metadata before starting the promotion.",
+          "name": "ignored-metadata-json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "operation": {
+          "description": "Promotion operation. Required unless --resume is used.",
+          "name": "operation",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "merge",
+            "merge_and_deploy"
+          ],
+          "type": "option"
+        },
+        "recreate-promotion-branch": {
+          "description": "Recreate the promotion branch before execution. Requires confirmation or --yes.",
+          "name": "recreate-promotion-branch",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "resume": {
+          "description": "Resume this existing JobExecution ID instead of calling the promotion run endpoint.",
+          "name": "resume",
+          "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"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Confirm promotion branch recreation without prompting.",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:promotion:run",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "promotion",
+        "run.js"
+      ]
+    },
     "cicd:repository:create": {
       "aliases": [],
       "args": {
@@ -4425,6 +4525,107 @@
         "open.js"
       ]
     },
+    "cicd:work:promote": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "User Story ID (defaults to the active work item from `work set`)",
+          "name": "id",
+          "required": false
+        }
+      },
+      "description": "Promote the explicit or active User Story through its Copado Promotion. Requires --cloud and selects promote-only unless --deploy is passed.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --cloud",
+        "<%= config.bin %> <%= command.id %> a07XXXXXXXXXXXXXXX --cloud --promotion-id a0BXXXXXXXXXXXXXXX",
+        "<%= config.bin %> <%= command.id %> --cloud --deploy --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "cloud": {
+          "description": "Use the Copado cloud promotion API. Required for this command.",
+          "name": "cloud",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "deploy": {
+          "description": "Use merge_and_deploy instead of promote-only merge.",
+          "name": "deploy",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "deployment-step-id": {
+          "description": "Ordered deployment-step Salesforce ID. Can be provided multiple times with --deploy.",
+          "name": "deployment-step-id",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "ignored-metadata-json": {
+          "description": "JSON array to persist through ignored-metadata before starting the promotion.",
+          "name": "ignored-metadata-json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "promotion-id": {
+          "description": "Explicit 18-character Promotion ID when the User Story belongs to multiple promotions.",
+          "name": "promotion-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "recreate-promotion-branch": {
+          "description": "Recreate the promotion branch before execution. Requires confirmation or --yes.",
+          "name": "recreate-promotion-branch",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "wait": {
+          "description": "Poll promotion and deployment executions to terminal status.",
+          "name": "wait",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "wait-timeout": {
+          "description": "Maximum total seconds to wait for promotion and deployment executions.",
+          "name": "wait-timeout",
+          "default": 900,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Confirm promotion branch recreation without prompting.",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:work:promote",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "work",
+        "promote.js"
+      ]
+    },
     "cicd:work:push": {
       "aliases": [],
       "args": {},
@@ -7984,55 +8185,6 @@
         "status.js"
       ]
     },
-    "cicd:job:log:get": {
-      "aliases": [],
-      "args": {
-        "id": {
-          "description": "JobExecution Id",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get log output for a Copado job execution step",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> <job-id>",
-        "<%= config.bin %> <%= command.id %> <job-id> --step <step-id>",
-        "<%= config.bin %> <%= command.id %> <job-id> --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "step": {
-          "description": "Job step Id (defaults to the first step with a result Id)",
-          "name": "step",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cicd:job:log:get",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "job",
-        "log",
-        "get.js"
-      ]
-    },
     "cicd:metadata:content:compare": {
       "aliases": [],
       "args": {},
@@ -8807,6 +8959,55 @@
         "status.js"
       ]
     },
+    "cicd:job:log:get": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "JobExecution Id",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get log output for a Copado job execution step",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> <job-id>",
+        "<%= config.bin %> <%= command.id %> <job-id> --step <step-id>",
+        "<%= config.bin %> <%= command.id %> <job-id> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "step": {
+          "description": "Job step Id (defaults to the first step with a result Id)",
+          "name": "step",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:job:log:get",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "job",
+        "log",
+        "get.js"
+      ]
+    },
     "cicd:pipeline:connection:list": {
       "aliases": [],
       "args": {},
@@ -9419,5 +9620,5 @@
       ]
     }
   },
-  "version": "0.56.0-alpha.0"
+  "version": "0.57.0-alpha.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@copado/agentia-cli",
   "description": "Command-line interface for Agentia",
-  "version": "0.56.0-alpha.0",
+  "version": "0.57.0-alpha.0",
   "author": "Copado Solutions",
   "bin": {
     "agentia": "./bin/run.js"