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

package/oclif.manifest.json

@@ -33,11 +33,19 @@
     "setup": {
       "aliases": [],
       "args": {},
-      "description": "Prepare this machine and the current project for Agentia. Guides CICD, AI, and CRT authentication, Cursor MCP, local quality gates, and AGENTS.md. Git is optional: .gitignore is updated only inside a repository, and generated files are not committed.",
+      "description": "Prepare this machine and the current project for Agentia. Guides CICD, AI, and CRT authentication, Cursor MCP, local quality gates, and AGENTS.md. Use --skip-auth to skip authentication and continue with Cursor MCP and project setup. Git is optional: .gitignore is updated only inside a repository, and generated files are not committed.",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --skip-auth"
       ],
-      "flags": {},
+      "flags": {
+        "skip-auth": {
+          "description": "Skip CICD, AI, and CRT authentication; continue with Cursor MCP and project setup",
+          "name": "skip-auth",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
       "id": "setup",
@@ -57,10 +65,12 @@
     "update": {
       "aliases": [],
       "args": {},
-      "description": "Update the globally installed Agentia CLI to the newest beta release",
+      "description": "Update the globally installed Agentia CLI to the newest release for the selected channel",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --check",
+        "<%= config.bin %> <%= command.id %> --channel latest --check",
+        "<%= config.bin %> <%= command.id %> --channel rc",
         "<%= config.bin %> <%= command.id %> --check --json"
       ],
       "flags": {
@@ -71,8 +81,19 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "channel": {
+          "description": "npm dist-tag to check or install (rc or latest). Also saves that channel as the preferred update channel when an install runs. Omit to auto-select from the stored preference or install type: prerelease installs and an rc preference compare rc and latest; stable installs with a latest preference (or no preference) use latest only.",
+          "name": "channel",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "rc",
+            "latest"
+          ],
+          "type": "option"
+        },
         "check": {
-          "description": "Check for an update without installing it",
+          "description": "Check for an update without installing it or changing the preferred channel",
           "name": "check",
           "allowNo": false,
           "type": "boolean"
@@ -389,32 +410,6 @@
         "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": {},
@@ -467,6 +462,32 @@
         "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"
@@ -4504,175 +4525,6 @@
         "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": {
@@ -5024,14 +4876,14 @@
         "run.js"
       ]
     },
-    "cicd:notification:configure": {
+    "cicd:metadata:list": {
       "aliases": [],
       "args": {},
-      "description": "Configure one Slack notification subscription for the current user on a pipeline",
+      "description": "Search the metadata index for an org via the CICD gateway",
       "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 <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": {
@@ -5041,13 +4893,182 @@
           "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"
+        "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"
+      ],
+      "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",
@@ -7473,6 +7494,56 @@
         "get.js"
       ]
     },
+    "cicd:work:ahead-behind": {
+      "aliases": [],
+      "args": {
+        "environment": {
+          "description": "Copado environment Id or name (defaults to the configured project default environment)",
+          "name": "environment",
+          "required": false
+        }
+      },
+      "description": "Compare user stories ahead of and behind the next pipeline environment. Resolves the project (and its pipeline) from the project default or --project, finds the unique next environment from pipeline connections for the given or default environment, then GET /agentia/headless/work/user-stories-ahead-behind.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> dev1",
+        "<%= config.bin %> <%= command.id %> a0E... --project a0w...",
+        "<%= config.bin %> <%= command.id %> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "project": {
+          "description": "Copado project Id (defaults to the configured project default)",
+          "name": "project",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:work:ahead-behind",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "work",
+        "ahead-behind.js"
+      ]
+    },
     "cicd:work:commit": {
       "aliases": [],
       "args": {
@@ -7943,7 +8014,7 @@
     "cicd:work:environment-sync": {
       "aliases": [],
       "args": {},
-      "description": "Sync committed metadata from the next environment onto the destination environment (or current feature branch). Back-promotes every user story behind the destination environment from the next environment branch. GET user stories ahead and behind. If none are behind, log that and stop. Otherwise create a back-promotion and POST those behind stories onto the promotion. Resolves the next-environment Git branch from --destination-environment or --dev-org-branch (the dest pipeline connection destinationBranch, or that destination environment's outbound branch). Merges origin/<next-env> with --no-ff --no-commit, restores every other path from HEAD, commits the guessed pathspecs, and pushes the dest org branch (and the feature branch when HEAD starts with feature/). If guessed pathspecs still conflict, PATCH the back-promotion status to Merge Conflict, resolve the files, and re-run with --promotion and --continue. The promotion destination environment supplies the dest org branch and the next-env branch. To discard a conflicted merge, re-run with --promotion and --abort (runs git merge --abort and sets the back-promotion status to Draft). After a successful sync, PATCH the back-promotion status to Completed.",
+      "description": "Sync committed metadata from the next environment onto the destination environment (or current feature branch). Back-promotes every user story behind the destination environment from the next environment branch. GET user stories ahead and behind. If none are behind, log that and stop. Otherwise create a back-promotion and POST those behind stories onto the promotion. Resolves the next-environment Git branch from --destination-environment or --dev-org-branch (the dest pipeline connection destinationBranch, or that destination environment's outbound branch). Merges origin/<next-env> with --no-ff --no-commit, restores every other path from HEAD, commits the guessed pathspecs, and pushes the dest org branch (and the feature branch when HEAD starts with feature/). If guessed pathspecs still conflict, PATCH the back-promotion status to Merge Conflict, resolve the files, and re-run with --promotion and --continue. The promotion destination environment supplies the dest org branch and the next-env branch. To discard a conflicted merge, re-run with --promotion and --abort (runs git merge --abort and sets the back-promotion status to Draft). After a successful sync, PATCH the back-promotion status to Completed. On git/merge failure (including conflicts) and after a successful --continue, uploads the captured command transcript as a Salesforce File on the back-promotion (`Environment Sync Logs <name-or-id> <datetime>.txt`) via `/agentia/headless/file/upload`. HTTP 404 is ignored until that endpoint is rolled out; other upload failures are warned and do not change the environment-sync outcome.",
       "examples": [
         "<%= config.bin %> <%= command.id %> --destination-environment=dev1",
         "<%= config.bin %> <%= command.id %> --dev-org-branch=dev1-sfp",
@@ -8380,7 +8451,7 @@
     "cicd:work:publish": {
       "aliases": [],
       "args": {},
-      "description": "Publish the current feature/<lastWorkItem> branch and register commits with Copado. Requires a clean working tree, base branch, and dev org branch from `.agentia/config.user.json`. Fetches origin/<lastBaseBranch>, then registers only commits in origin/<lastBaseBranch>..HEAD and diffs nested parent XML at merge-base(origin/<lastBaseBranch>, HEAD) versus HEAD, so origin/base-only history is ignored. When there are no commits since origin/<lastBaseBranch>, or origin already has HEAD, fails with \"No changes to publish\" unless `--permissions` and/or `--full-metadata` is set, in which case it creates an empty commit so a tip commit id exists. Applies Copado environment-variable then yaml replacements to the added and modified files in origin/<lastBaseBranch>..HEAD (passed to the jars as `--include`; yaml `-b` is the feature branch, matching Copado Commit), commits both as a single follow-up commit, locks the tip commit, runs `git push origin <branch>`, reports the nested metadata changed across the branch, such as the CustomField behind a profile field-permission edit, plus the parent components it would ignore, calls headless work/push with one changeListUpdate list of Action:MetadataType:MetadataName corrections: lastPermissionSelected and --permissions plus the nested metadata of the changed profiles and permission sets as RetrieveOnly, lastFullMetadataSelected and --full-metadata plus brand-new nested parent files as fullMetadata, the ignored parents as unchanged, the nested metadata deleted on the branch as Del, and the remaining nested metadata as Add, then merges the feature branch into the recorded dev org branch. The changed profiles and permission sets themselves are never sent as corrections, so they stay in the change list and deploy only the permissions their RetrieveOnly entries select. Brand-new nested parent files are an exception: they are sent as fullMetadata so the complete file travels. `--dry-run` runs commit collection, replacements, and nested detection, logs the changeListUpdate that would be sent, skips empty/replacement commits, tip lock, git push, headless register, and dev-org sync, then restores only the tracked files dirtied by replacements (untracked files are left alone). `cicd work push` is a compatibility alias of this command.",
+      "description": "Publish the current feature/<lastWorkItem> branch and register commits with Copado. Requires a clean working tree, base branch, and dev org branch from `.agentia/config.user.json`. Fetches origin/<lastBaseBranch>, then registers only commits in origin/<lastBaseBranch>..HEAD and diffs nested parent XML at merge-base(origin/<lastBaseBranch>, HEAD) versus HEAD, so origin/base-only history is ignored. When there are no commits since origin/<lastBaseBranch>, or origin already has HEAD, fails with \"No changes to publish\" unless `--permissions` and/or `--full-metadata` is set, in which case it creates an empty commit so a tip commit id exists. Applies Copado environment-variable then yaml replacements to the added and modified files in origin/<lastBaseBranch>..HEAD (passed to the jars as `--include`; yaml `-b` is the feature branch, matching Copado Commit), commits both as a single follow-up commit, locks the tip commit, runs `git push origin <branch>`, reports the nested metadata changed across the branch, such as the CustomField behind a profile field-permission edit, plus the parent components it would ignore, calls headless work/push with one changeListUpdate list of Action:MetadataType:MetadataName corrections: lastPermissionSelected and --permissions plus the nested metadata of the changed profiles and permission sets as RetrieveOnly, lastFullMetadataSelected and --full-metadata plus brand-new nested parent files as fullMetadata, the ignored parents as unchanged, the nested metadata deleted on the branch as Del, and the remaining nested metadata as Add, then merges the feature branch into the recorded dev org branch. The changed profiles and permission sets themselves are never sent as corrections, so they stay in the change list and deploy only the permissions their RetrieveOnly entries select. Brand-new nested parent files are an exception: they are sent as fullMetadata so the complete file travels. After a successful register, uploads the captured command output as a Salesforce File on the user story (`Local Commit Logs <commitId> <datetime>.txt`) via `/agentia/headless/file/upload`. HTTP 404 is ignored until that endpoint is rolled out; other upload failures are warned and do not fail the publish. `--dry-run` runs commit collection, replacements, and nested detection, logs the changeListUpdate that would be sent, skips empty/replacement commits, tip lock, git push, headless register, log upload, and dev-org sync, then restores only the tracked files dirtied by replacements (untracked files are left alone). `cicd work push` is a compatibility alias of this command.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --dry-run",
@@ -8613,7 +8684,7 @@
     "cicd:work:submit": {
       "aliases": [],
       "args": {},
-      "description": "Submit the current feature/<lastWorkItem> work item for pipeline quality gates and validation. Runs project-root .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present, pushes and registers commits when the branch is ahead of origin, then calls headless work/submit (Promote Action with validate=true). When the last pending related job template name contains Commit, waits up to 5 minutes for that job before submitting. Before submit or promote, counts user stories ahead and behind between the source environment and the next pipeline environment, and warns when stories behind might cause promotion conflicts (advising `agentia cicd work environment-sync`). With --done or --deploy, matches Copado UI Submit when promoting (validate=false / headless work/done). cicd work done is a compatibility alias of this command with --done.",
+      "description": "Submit the current feature/<lastWorkItem> work item for pipeline quality gates and validation. Runs project-root .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present, pushes and registers commits when the branch is ahead of origin, then calls headless work/submit (Promote Action with validate=true). When the last pending related job template name contains Commit, waits up to 5 minutes for that job before submitting. Before submit or promote, counts user stories ahead and behind between the source environment and the next pipeline environment, and warns when stories behind might cause promotion conflicts (advising `agentia cicd work environment-sync`). After a successful submit or promote, uploads the captured command output as a Salesforce File on the user story (`Local Commit Logs <commitId> <datetime>.txt`) via `/agentia/headless/file/upload`. HTTP 404 is ignored until that endpoint is rolled out; other upload failures are warned and do not fail the command. With --done or --deploy, matches Copado UI Submit when promoting (validate=false / headless work/done). cicd work done is a compatibility alias of this command with --done.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --apex-test-classes=MyTest,OtherTest",
@@ -16783,14 +16854,20 @@
         "get.js"
       ]
     },
-    "cicd:metadata:content:compare": {
+    "cicd:job:log:get": {
       "aliases": [],
-      "args": {},
-      "description": "Compare metadata file content between two orgs or Git branches",
+      "args": {
+        "id": {
+          "description": "JobExecution Id",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get log output for a Copado job execution step",
       "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 %> <job-id>",
+        "<%= config.bin %> <%= command.id %> <job-id> --step <step-id>",
+        "<%= config.bin %> <%= command.id %> <job-id> --json"
       ],
       "flags": {
         "json": {
@@ -16800,31 +16877,175 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "api-name": {
-          "description": "Metadata API name",
-          "name": "api-name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file-name": {
-          "description": "Optional metadata file name",
-          "name": "file-name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "metadata-type": {
-          "description": "Metadata type, for example ApexClass",
-          "name": "metadata-type",
-          "required": true,
+        "step": {
+          "description": "Job step Id (defaults to the first step with a result Id)",
+          "name": "step",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "pipeline-id": {
-          "description": "Pipeline Id",
+        }
+      },
+      "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"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "api-name": {
+          "description": "Metadata API name",
+          "name": "api-name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file-name": {
+          "description": "Optional metadata file name",
+          "name": "file-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metadata-type": {
+          "description": "Metadata type, for example ApexClass",
+          "name": "metadata-type",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "pipeline-id": {
+          "description": "Pipeline Id",
           "name": "pipeline-id",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -17564,156 +17785,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,
-      "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": {},
@@ -20370,5 +20441,5 @@
       ]
     }
   },
-  "version": "1.0.0-beta.9"
+  "version": "1.0.0"
 }