@copado/agentia-cli 1.0.0-beta.8 → 1.0.0-beta.9

package/oclif.manifest.json

@@ -389,6 +389,32 @@
         "unset.js"
       ]
     },
+    "mcp:start": {
+      "aliases": [],
+      "args": {},
+      "description": "Start the local Agentia MCP server over stdio",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> # long-running stdio MCP server for Cursor and other clients"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "mcp:start",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "mcp",
+        "start.js"
+      ]
+    },
     "cicd:health-check": {
       "aliases": [],
       "args": {},
@@ -441,32 +467,6 @@
         "health-check.js"
       ]
     },
-    "mcp:start": {
-      "aliases": [],
-      "args": {},
-      "description": "Start the local Agentia MCP server over stdio",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> # long-running stdio MCP server for Cursor and other clients"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "mcp:start",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "experimental": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "mcp",
-        "start.js"
-      ]
-    },
     "plugins:install": {
       "aliases": [
         "plugins:add"
@@ -1799,7 +1799,7 @@
           "type": "option"
         },
         "timeout": {
-          "description": "Maximum seconds to wait for the job to finish (default: 3600).",
+          "description": "Maximum seconds to wait; the remote run continues after timeout (default: 3600).",
           "name": "timeout",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1926,7 +1926,7 @@
           "type": "option"
         },
         "timeout": {
-          "description": "Maximum seconds to wait for the job to finish (default: 3600).",
+          "description": "Maximum seconds to wait; the remote run continues after timeout (default: 3600).",
           "name": "timeout",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2139,7 +2139,7 @@
           "type": "option"
         },
         "timeout": {
-          "description": "Maximum seconds to wait for the job to finish (default: 3600).",
+          "description": "Maximum seconds to wait; the remote run continues after timeout (default: 3600).",
           "name": "timeout",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2213,7 +2213,7 @@
           "type": "option"
         },
         "timeout": {
-          "description": "Maximum seconds to wait for the job to finish (default: 3600).",
+          "description": "Maximum seconds to wait; the remote run continues after timeout (default: 3600).",
           "name": "timeout",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2370,7 +2370,7 @@
           "type": "option"
         },
         "timeout": {
-          "description": "Maximum seconds to wait (default: 3600).",
+          "description": "Maximum seconds to wait; the remote run continues after timeout (default: 3600).",
           "name": "timeout",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -4504,6 +4504,175 @@
         "upsert.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"
+        },
+        "change-date-from": {
+          "description": "Optional change-date-from filter (ISO datetime)",
+          "name": "change-date-from",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "change-date-to": {
+          "description": "Optional change-date-to filter (ISO datetime)",
+          "name": "change-date-to",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "metadata",
+        "list.js"
+      ]
+    },
     "cicd:job:get": {
       "aliases": [],
       "args": {
@@ -4855,14 +5024,14 @@
         "run.js"
       ]
     },
-    "cicd:metadata:list": {
+    "cicd:notification:configure": {
       "aliases": [],
       "args": {},
-      "description": "Search the metadata index for an org via the CICD gateway",
+      "description": "Configure one Slack notification subscription for the current user on a pipeline",
       "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"
+        "<%= config.bin %> <%= command.id %> --pipeline-id <pipeline-id> --event Promotion_Failed --destination-type user --destination-id U0123ABCD --subscription user",
+        "<%= config.bin %> <%= command.id %> -p <pipeline-id> --event Commit_Failed --destination-type channel --destination-id C0123ABCD --subscription all",
+        "<%= config.bin %> <%= command.id %> --pipeline-id <pipeline-id> --event \"Test_Not Started\" --destination-type user --destination-id @jane --subscription user --json"
       ],
       "flags": {
         "json": {
@@ -4872,193 +5041,24 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "avoid-source-tracking": {
-          "description": "Pass avoidSourceTracking=true to the gateway index route",
-          "name": "avoid-source-tracking",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "change-date-from": {
-          "description": "Optional change-date-from filter (ISO datetime)",
-          "name": "change-date-from",
+        "destination-id": {
+          "description": "Slack user or channel id or name",
+          "name": "destination-id",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "change-date-to": {
-          "description": "Optional change-date-to filter (ISO datetime)",
-          "name": "change-date-to",
+        "destination-type": {
+          "description": "Slack destination type",
+          "name": "destination-type",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
-          "type": "option"
-        },
-        "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,
-      "experimental": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "metadata",
-        "list.js"
-      ]
-    },
-    "cicd:notification:configure": {
-      "aliases": [],
-      "args": {},
-      "description": "Configure one Slack notification subscription for the current user on a pipeline",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --pipeline-id <pipeline-id> --event Promotion_Failed --destination-type user --destination-id U0123ABCD --subscription user",
-        "<%= config.bin %> <%= command.id %> -p <pipeline-id> --event Commit_Failed --destination-type channel --destination-id C0123ABCD --subscription all",
-        "<%= config.bin %> <%= command.id %> --pipeline-id <pipeline-id> --event \"Test_Not Started\" --destination-type user --destination-id @jane --subscription user --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "destination-id": {
-          "description": "Slack user or channel id or name",
-          "name": "destination-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "destination-type": {
-          "description": "Slack destination type",
-          "name": "destination-type",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "user",
-            "channel"
-          ],
+          "options": [
+            "user",
+            "channel"
+          ],
           "type": "option"
         },
         "event": {
@@ -7101,15 +7101,14 @@
         "update.js"
       ]
     },
-    "cicd:user:get": {
+    "cicd:template:defaults": {
       "aliases": [],
       "args": {},
-      "description": "Get a Copado user by ID (defaults to the authenticated user)",
+      "description": "Scaffold default Copado Job Template metadata without writing to Salesforce (legacy create ≈ defaults --write)",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --id me",
-        "<%= config.bin %> <%= command.id %> --id 005000000000000",
-        "<%= config.bin %> <%= command.id %> --json"
+        "<%= config.bin %> <%= command.id %> --name MyTemplate",
+        "<%= config.bin %> <%= command.id %> --name MyTemplate --api-name MyTemplate_1 --write",
+        "<%= config.bin %> <%= command.id %> --name MyTemplate --output ./copado/templates/MyTemplate_1.metadata.json --json"
       ],
       "flags": {
         "json": {
@@ -7119,18 +7118,38 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "id": {
-          "description": "User ID, or \"me\" for the authenticated user",
-          "name": "id",
-          "default": "me",
+        "api-name": {
+          "description": "Optional template API name for the scaffold (defaults to {name}_1 on the gateway)",
+          "name": "api-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Template display name used to scaffold defaults",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output": {
+          "description": "Write scaffold JSON to this path (implies a disk write)",
+          "name": "output",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "write": {
+          "description": "Write scaffold JSON to copado/templates/{apiName}.metadata.json (legacy create)",
+          "name": "write",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cicd:user:get",
+      "id": "cicd:template:defaults",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
@@ -7142,23 +7161,65 @@
         "dist",
         "commands",
         "cicd",
-        "user",
-        "get.js"
+        "template",
+        "defaults.js"
       ]
     },
-    "cicd:work:commit": {
+    "cicd:template:delete": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "User story ID (defaults to the active work item from `work set`)",
-          "name": "id",
-          "required": false
+        "api-name": {
+          "description": "Template API name",
+          "name": "api-name",
+          "required": true
         }
       },
-      "description": "Compatibility alias of cicd cloud commit. Create a Copado cloud metadata commit for a user story. Prefer: agentia cicd cloud commit.",
+      "description": "Delete a Copado Job Template by API name",
       "examples": [
-        "<%= config.bin %> cicd cloud commit --message \"Commit AccountService\" --metadata-name AccountService --metadata-type ApexClass --metadata-category SFDX --action Add",
-        "<%= config.bin %> <%= command.id %> --cloud --message \"Commit AccountService\" --metadata-name AccountService --metadata-type ApexClass --metadata-category SFDX --action Add"
+        "<%= config.bin %> <%= command.id %> MyTemplate_1",
+        "<%= config.bin %> <%= command.id %> MyTemplate_1 --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:template:delete",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "template",
+        "delete.js"
+      ]
+    },
+    "cicd:template:get": {
+      "aliases": [],
+      "args": {
+        "api-name": {
+          "description": "Template API name",
+          "name": "api-name",
+          "required": true
+        }
+      },
+      "description": "Get a Copado Job Template by API name (legacy retrieve ≈ get --write)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> MyTemplate_1",
+        "<%= config.bin %> <%= command.id %> MyTemplate_1 --write",
+        "<%= config.bin %> <%= command.id %> MyTemplate_1 --json"
       ],
       "flags": {
         "json": {
@@ -7168,13 +7229,279 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "action": {
-          "description": "Metadata action for simple flag input. Defaults to Add.",
-          "name": "action",
+        "output": {
+          "description": "Write retrieved template JSON to this path (implies a disk write)",
+          "name": "output",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "Add",
+          "type": "option"
+        },
+        "write": {
+          "description": "Write retrieved JSON to copado/templates/{apiName}.metadata.json (legacy retrieve)",
+          "name": "write",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:template:get",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "template",
+        "get.js"
+      ]
+    },
+    "cicd:template:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List Copado Job Templates",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --type all",
+        "<%= config.bin %> <%= command.id %> --name Demo --page-size 50",
+        "<%= config.bin %> <%= command.id %> --fetch-all --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "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"
+        },
+        "fetch-all": {
+          "description": "Fetch all matching templates (incompatible with --cursor on the gateway)",
+          "name": "fetch-all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "name": {
+          "description": "Filter by name substring",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "type": {
+          "description": "List Custom templates only, or all templates",
+          "name": "type",
+          "default": "custom",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "custom",
+            "all"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:template:list",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "template",
+        "list.js"
+      ]
+    },
+    "cicd:template:upsert": {
+      "aliases": [],
+      "args": {
+        "api-name": {
+          "description": "Template API name",
+          "name": "api-name",
+          "required": true
+        }
+      },
+      "description": "Create or update a Copado Job Template by API name (legacy deploy ≈ upsert reading disk or --file)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> MyTemplate_1",
+        "<%= config.bin %> <%= command.id %> MyTemplate_1 --file ./copado/templates/MyTemplate_1.metadata.json",
+        "<%= config.bin %> <%= command.id %> MyTemplate_1 --name \"My Template\" --steps-file ./steps.json --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "description": {
+          "description": "Template description",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "description": "Path to a JSON file with the full upsert payload (legacy deploy format accepted)",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Template display name (defaults to the API name argument)",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "steps-file": {
+          "description": "Path to a JSON file containing the steps array",
+          "name": "steps-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "type": {
+          "description": "Template type (for example Custom)",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "version": {
+          "description": "Template version",
+          "name": "version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "volume-options": {
+          "description": "Template volume options as a JSON string or plain string",
+          "name": "volume-options",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:template:upsert",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "template",
+        "upsert.js"
+      ]
+    },
+    "cicd:user:get": {
+      "aliases": [],
+      "args": {},
+      "description": "Get a Copado user by ID (defaults to the authenticated user)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --id me",
+        "<%= config.bin %> <%= command.id %> --id 005000000000000",
+        "<%= config.bin %> <%= command.id %> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "id": {
+          "description": "User ID, or \"me\" for the authenticated user",
+          "name": "id",
+          "default": "me",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:user:get",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "user",
+        "get.js"
+      ]
+    },
+    "cicd:work:commit": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "User story ID (defaults to the active work item from `work set`)",
+          "name": "id",
+          "required": false
+        }
+      },
+      "description": "Compatibility alias of cicd cloud commit. Create a Copado cloud metadata commit for a user story. Prefer: agentia cicd cloud commit.",
+      "examples": [
+        "<%= config.bin %> cicd cloud commit --message \"Commit AccountService\" --metadata-name AccountService --metadata-type ApexClass --metadata-category SFDX --action Add",
+        "<%= config.bin %> <%= command.id %> --cloud --message \"Commit AccountService\" --metadata-name AccountService --metadata-type ApexClass --metadata-category SFDX --action Add"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "action": {
+          "description": "Metadata action for simple flag input. Defaults to Add.",
+          "name": "action",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "Add",
             "Delete",
             "RetrieveOnly",
             "SelectiveCommit",
@@ -16456,164 +16783,14 @@
         "get.js"
       ]
     },
-    "cicd:job:log:get": {
+    "cicd:metadata:content:compare": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "JobExecution Id",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get log output for a Copado job execution step",
+      "args": {},
+      "description": "Compare metadata file content between two orgs or Git branches",
       "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,
-      "experimental": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "job",
-        "log",
-        "get.js"
-      ]
-    },
-    "cicd:job:result-file:get": {
-      "aliases": [],
-      "args": {
-        "resultId": {
-          "description": "Copado Result Id",
-          "name": "resultId",
-          "required": true
-        }
-      },
-      "description": "Get a File linked to a Copado job Result",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> <result-id> --file-id <file-id>",
-        "<%= config.bin %> <%= command.id %> <result-id> --file-id <file-id> --output-file ./result.zip",
-        "<%= config.bin %> <%= command.id %> <result-id> --file-id <file-id> --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "file-id": {
-          "description": "File Id returned by result-file list",
-          "name": "file-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "output-file": {
-          "description": "Explicit file path to receive decoded content",
-          "name": "output-file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cicd:job:result-file:get",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "experimental": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "job",
-        "result-file",
-        "get.js"
-      ]
-    },
-    "cicd:job:result-file:list": {
-      "aliases": [],
-      "args": {
-        "resultId": {
-          "description": "Copado Result Id",
-          "name": "resultId",
-          "required": true
-        }
-      },
-      "description": "List Files linked to a Copado job Result",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> <result-id>",
-        "<%= config.bin %> <%= command.id %> <result-id> --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cicd:job:result-file:list",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "experimental": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "job",
-        "result-file",
-        "list.js"
-      ]
-    },
-    "cicd:metadata:content:compare": {
-      "aliases": [],
-      "args": {},
-      "description": "Compare metadata file content between two orgs or Git branches",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --metadata-type ApexClass --api-name MyClass --pipeline-id <id> --source-org-id <id> --source-credential-id <id> --target-org-id <id>",
-        "<%= config.bin %> <%= command.id %> --metadata-type ApexClass --api-name MyClass --source REPOSITORY --source-branch feature/us-123 --target-source REPOSITORY --target-branch main",
-        "<%= config.bin %> <%= command.id %> --metadata-type ApexClass --api-name MyClass --json"
+        "<%= config.bin %> <%= command.id %> --metadata-type ApexClass --api-name MyClass --pipeline-id <id> --source-org-id <id> --source-credential-id <id> --target-org-id <id>",
+        "<%= config.bin %> <%= command.id %> --metadata-type ApexClass --api-name MyClass --source REPOSITORY --source-branch feature/us-123 --target-source REPOSITORY --target-branch main",
+        "<%= config.bin %> <%= command.id %> --metadata-type ApexClass --api-name MyClass --json"
       ],
       "flags": {
         "json": {
@@ -17387,6 +17564,156 @@
         "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,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "job",
+        "log",
+        "get.js"
+      ]
+    },
+    "cicd:job:result-file:get": {
+      "aliases": [],
+      "args": {
+        "resultId": {
+          "description": "Copado Result Id",
+          "name": "resultId",
+          "required": true
+        }
+      },
+      "description": "Get a File linked to a Copado job Result",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> <result-id> --file-id <file-id>",
+        "<%= config.bin %> <%= command.id %> <result-id> --file-id <file-id> --output-file ./result.zip",
+        "<%= config.bin %> <%= command.id %> <result-id> --file-id <file-id> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "file-id": {
+          "description": "File Id returned by result-file list",
+          "name": "file-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output-file": {
+          "description": "Explicit file path to receive decoded content",
+          "name": "output-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:job:result-file:get",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "job",
+        "result-file",
+        "get.js"
+      ]
+    },
+    "cicd:job:result-file:list": {
+      "aliases": [],
+      "args": {
+        "resultId": {
+          "description": "Copado Result Id",
+          "name": "resultId",
+          "required": true
+        }
+      },
+      "description": "List Files linked to a Copado job Result",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> <result-id>",
+        "<%= config.bin %> <%= command.id %> <result-id> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:job:result-file:list",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "job",
+        "result-file",
+        "list.js"
+      ]
+    },
     "cicd:pipeline:connection:create": {
       "aliases": [],
       "args": {},
@@ -20043,5 +20370,5 @@
       ]
     }
   },
-  "version": "1.0.0-beta.8"
+  "version": "1.0.0-beta.9"
 }