@copado/agentia-cli 1.0.0-beta.7 → 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,30 +467,73 @@
         "health-check.js"
       ]
     },
-    "mcp:start": {
-      "aliases": [],
-      "args": {},
-      "description": "Start the local Agentia MCP server over stdio",
+    "plugins:install": {
+      "aliases": [
+        "plugins:add"
+      ],
+      "args": {
+        "plugin": {
+          "description": "npm package name (optionally with @tag) or git URL.",
+          "name": "plugin",
+          "required": true
+        }
+      },
+      "description": "Install plugins with npm after checking them against the Agentia plugin catalog.\n\nOfficial and Verified plugins install without a prompt. Community, unlisted, and git URL plugins ask first. Use --allow-unverified when there is no terminal or with --json.\n\nA revoked version, or an npm tarball that differs from the hash in the catalog, is always refused. If the catalog cannot be reached, the command warns and the install continues.",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> # long-running stdio MCP server for Cursor and other clients"
+        "<%= config.bin %> <%= command.id %> @acme/agentia-plugin-x",
+        "<%= config.bin %> <%= command.id %> @acme/agentia-plugin-x@1.2.0 --allow-unverified --json"
       ],
-      "flags": {},
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "allow-unverified": {
+          "description": "Install plugins that are not Official or Verified without asking. Never overrides a revoked or mismatched version.",
+          "name": "allow-unverified",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "char": "f",
+          "description": "Force npm to fetch remote resources even if a local copy exists.",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "silent": {
+          "char": "s",
+          "description": "Silence npm output.",
+          "name": "silent",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show verbose npm output.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "mcp:start",
+      "id": "plugins:install",
       "pluginAlias": "@copado/agentia-cli",
       "pluginName": "@copado/agentia-cli",
       "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
+      "strict": false,
+      "enableJsonFlag": true,
       "experimental": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "mcp",
-        "start.js"
+        "plugins",
+        "install.js"
       ]
     },
     "testing:create": {
@@ -1730,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,
@@ -1857,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,
@@ -2070,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,
@@ -2144,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,
@@ -2301,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,
@@ -4435,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": {
@@ -4786,183 +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"
-      ],
-      "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: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"
+        "<%= 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": {
@@ -7032,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": {
@@ -7050,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",
@@ -7073,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": {
@@ -7099,23 +7229,289 @@
           "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",
-            "Delete",
-            "RetrieveOnly",
-            "SelectiveCommit",
-            "Full"
-          ],
           "type": "option"
         },
-        "base-branch": {
-          "description": "Optional base branch to include in the commit request.",
-          "name": "base-branch",
+        "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",
+            "Full"
+          ],
+          "type": "option"
+        },
+        "base-branch": {
+          "description": "Optional base branch to include in the commit request.",
+          "name": "base-branch",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -16387,157 +16783,7 @@
         "get.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:metadata:content:compare": {
+    "cicd:metadata:content:compare": {
       "aliases": [],
       "args": {},
       "description": "Compare metadata file content between two orgs or Git branches",
@@ -17318,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": {},
@@ -19974,5 +20370,5 @@
       ]
     }
   },
-  "version": "1.0.0-beta.7"
+  "version": "1.0.0-beta.9"
 }