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

package/oclif.manifest.json

@@ -2020,168 +2020,6 @@
         "update.js"
       ]
     },
-    "cicd:credential:create": {
-      "aliases": [],
-      "args": {},
-      "description": "Create a Copado environment credential",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\"",
-        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\" --default",
-        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\" --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "default": {
-          "description": "Mark this credential as the environment default",
-          "name": "default",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "environmentid": {
-          "description": "Copado environment ID",
-          "name": "environmentid",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "Credential name",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cicd:credential:create",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "credential",
-        "create.js"
-      ]
-    },
-    "cicd:credential:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List credentials for a Copado environment",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --environmentid <environment-id>",
-        "<%= config.bin %> <%= command.id %> --environmentid \"Dev Sandbox\"",
-        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "environmentid": {
-          "description": "Copado environment ID",
-          "name": "environmentid",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cicd:credential:list",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "credential",
-        "list.js"
-      ]
-    },
-    "cicd:credential:update": {
-      "aliases": [],
-      "args": {
-        "id": {
-          "description": "Copado credential ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Update a Copado environment credential by ID",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --name \"CI User\"",
-        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --default",
-        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --no-default --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "default": {
-          "description": "Mark this credential as the environment default",
-          "name": "default",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "environmentid": {
-          "description": "Copado environment ID",
-          "name": "environmentid",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "Credential name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cicd:credential:update",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "credential",
-        "update.js"
-      ]
-    },
     "cicd:environment:create": {
       "aliases": [],
       "args": {
@@ -2593,6 +2431,168 @@
         "update.js"
       ]
     },
+    "cicd:credential:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a Copado environment credential",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\"",
+        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\" --default",
+        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --name \"CI User\" --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "default": {
+          "description": "Mark this credential as the environment default",
+          "name": "default",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "environmentid": {
+          "description": "Copado environment ID",
+          "name": "environmentid",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Credential name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:credential:create",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "credential",
+        "create.js"
+      ]
+    },
+    "cicd:credential:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List credentials for a Copado environment",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --environmentid <environment-id>",
+        "<%= config.bin %> <%= command.id %> --environmentid \"Dev Sandbox\"",
+        "<%= config.bin %> <%= command.id %> --environmentid <environment-id> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "environmentid": {
+          "description": "Copado environment ID",
+          "name": "environmentid",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:credential:list",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "credential",
+        "list.js"
+      ]
+    },
+    "cicd:credential:update": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Copado credential ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update a Copado environment credential by ID",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --name \"CI User\"",
+        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --default",
+        "<%= config.bin %> <%= command.id %> <credential-id> --environmentid <environment-id> --no-default --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "default": {
+          "description": "Mark this credential as the environment default",
+          "name": "default",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "environmentid": {
+          "description": "Copado environment ID",
+          "name": "environmentid",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Credential name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:credential:update",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "credential",
+        "update.js"
+      ]
+    },
     "cicd:function:defaults": {
       "aliases": [],
       "args": {},
@@ -5922,14 +5922,14 @@
           "type": "option"
         },
         "source-credential": {
-          "description": "Source credential ID",
+          "description": "Source credential ID. When set, sourceEnvironment is sent as null so Salesforce assigns the environment from the credential.",
           "name": "source-credential",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "source-environment": {
-          "description": "Source environment ID",
+          "description": "Source environment ID. Ignored when --source-credential is also set.",
           "name": "source-environment",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -6396,7 +6396,7 @@
     "cicd:work:push": {
       "aliases": [],
       "args": {},
-      "description": "Push the current feature/<lastWorkItem> branch and register commits with Copado. Requires a clean working tree, base branch, and dev org branch from `.agentia/config.user.json`. When there are no commits since the base branch, or origin already has HEAD, fails with \"No changes to push\" unless `--permissions` and/or `--full-metadata` is set, in which case it creates an empty commit so a tip commit id exists. Applies Copado environment-variable then yaml replacements when needed, commits both as a single follow-up commit, locks the tip commit, runs `git push origin <branch>`, reports the nested metadata changed across the branch, such as the CustomField behind a profile field-permission edit, plus the parent components it would ignore, calls headless work/push with one changeListUpdate list of Action:MetadataType:MetadataName corrections: lastPermissionSelected and --permissions plus the nested metadata of the changed profiles and permission sets as RetrieveOnly, lastFullMetadataSelected and --full-metadata plus brand-new nested parent files as fullMetadata, the ignored parents as unchanged, the nested metadata deleted on the branch as Del, and the remaining nested metadata as Add, then merges the feature branch into the recorded dev org branch. The changed profiles and permission sets themselves are never sent as corrections, so they stay in the change list and deploy only the permissions their RetrieveOnly entries select. Brand-new nested parent files are an exception: they are sent as fullMetadata so the complete file travels.",
+      "description": "Push the current feature/<lastWorkItem> branch and register commits with Copado. Requires a clean working tree, base branch, and dev org branch from `.agentia/config.user.json`. Fetches origin/<lastBaseBranch>, then registers only commits in origin/<lastBaseBranch>..HEAD and diffs nested parent XML at merge-base(origin/<lastBaseBranch>, HEAD) versus HEAD, so origin/base-only history is ignored. When there are no commits since origin/<lastBaseBranch>, or origin already has HEAD, fails with \"No changes to push\" unless `--permissions` and/or `--full-metadata` is set, in which case it creates an empty commit so a tip commit id exists. Applies Copado environment-variable then yaml replacements when needed, commits both as a single follow-up commit, locks the tip commit, runs `git push origin <branch>`, reports the nested metadata changed across the branch, such as the CustomField behind a profile field-permission edit, plus the parent components it would ignore, calls headless work/push with one changeListUpdate list of Action:MetadataType:MetadataName corrections: lastPermissionSelected and --permissions plus the nested metadata of the changed profiles and permission sets as RetrieveOnly, lastFullMetadataSelected and --full-metadata plus brand-new nested parent files as fullMetadata, the ignored parents as unchanged, the nested metadata deleted on the branch as Del, and the remaining nested metadata as Add, then merges the feature branch into the recorded dev org branch. The changed profiles and permission sets themselves are never sent as corrections, so they stay in the change list and deploy only the permissions their RetrieveOnly entries select. Brand-new nested parent files are an exception: they are sent as fullMetadata so the complete file travels.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --permissions CustomField:Account.SLA__c,ApexClass:AccountService",
@@ -6459,7 +6459,7 @@
           "required": false
         }
       },
-      "description": "Set the active work item and prepare a local feature branch. Calls the CICD gateway work/set endpoint, requires a clean tracked working tree, fetches the work item base branch from origin, then creates or checks out feature/<user-story-name>. After work/set returns, compares the Story source credential with the CICD project default: warns when the default or Story credential is missing, and updates the Story when they differ. With --none, clears every last* key from `.agentia/config.user.json` and checks out the previous lastBaseBranch when present, else main, else master, else stays put.",
+      "description": "Set the active work item and prepare a local feature branch. Calls the CICD gateway work/set endpoint, requires a clean tracked working tree, fetches the work item base branch from origin, then creates or checks out feature/<user-story-name>. After work/set returns, compares the Story source credential with the CICD project default: warns when the default or Story credential is missing, and warns without changing the Story when they differ (shows the current credential and environment; use work update to change it). With --none, clears every last* key from `.agentia/config.user.json` and checks out the previous lastBaseBranch when present, else main, else master, else stays put.",
       "examples": [
         "<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU",
         "<%= config.bin %> <%= command.id %> US-0001 --json",
@@ -6820,14 +6820,14 @@
           "type": "option"
         },
         "source-credential": {
-          "description": "Source credential ID",
+          "description": "Source credential ID. When set, sourceEnvironment is sent as null so Salesforce assigns the environment from the credential.",
           "name": "source-credential",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "source-environment": {
-          "description": "Source environment ID",
+          "description": "Source environment ID. Ignored when --source-credential is also set.",
           "name": "source-environment",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -17793,5 +17793,5 @@
       ]
     }
   },
-  "version": "0.114.0-alpha.0"
+  "version": "0.116.0-alpha.0"
 }

package/package.json

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

package/templates/skills/agentia-cicd/references/work.md

@@ -13,7 +13,7 @@ Local and cloud work are separate delivery paths. Do not continue a cloud commit
 Use this path when the change exists in the local repository:
 
 1. Discover and inspect: `agentia cicd work list --assigned-to-me --json`, then `agentia cicd work get <id-or-name> --json`.
-2. Activate: `agentia cicd work set <id-or-name> --json`. This fetches the configured base branch, checks out `feature/<story-name>`, and records the story, base branch, dev org branch, and pull-request context in `.agentia/config.user.json`. Use `--base-branch <branch>` only when intentionally overriding the Pipeline default.
+2. Activate: `agentia cicd work set <id-or-name> --json`. This fetches the configured base branch, checks out `feature/<story-name>`, and records the story, base branch, dev org branch, and pull-request context in `.agentia/config.user.json`. Use `--base-branch <branch>` only when intentionally overriding the Pipeline default. If the Story source credential differs from the project default, work set warns with the current credential and environment and does not PATCH; use `agentia cicd work update <id> --source-credential <credential-id>` to change it.
 3. Implement and stage new files with `git add`. Commit with Git, or use `agentia cicd work commit --local --all --json` when Agentia should also remember permission, full-metadata, or Apex-test selections. `--local` is the default, and `--all` includes tracked changes only.
 4. Run project-owned gates: `agentia cicd work test --json`. This runs `.agentia_quality_gates.sh` or `.agentia_quality_gates.cmd` from the repository root when present. `--local` is the default; `--cloud` is reserved and not implemented yet.
 5. Register and synchronize: `agentia cicd work push --json`. A plain `git push` does not register a Copado Commit or merge the feature branch into the recorded dev org branch.
@@ -21,7 +21,7 @@ Use this path when the change exists in the local repository:
 7. Only with explicit approval to promote and deploy, run `agentia cicd work submit --done --json`. `work done` is a compatibility alias.
 8. Check asynchronous results with `agentia cicd work status [id-or-name] --json`.
 
-`work set`, `work push`, and `work submit` require a clean tracked working tree. `work push` also requires the exact `feature/<story-name>` branch, recorded `lastBaseBranch` and `lastDevOrgBranch`, and at least one commit in `lastBaseBranch..HEAD`. `work submit` permits an empty commit range only for a Story with a Salesforce Data Set or Data Template deployment step.
+`work set`, `work push`, and `work submit` require a clean tracked working tree. `work push` also requires the exact `feature/<story-name>` branch, recorded `lastBaseBranch` and `lastDevOrgBranch`, and at least one commit in `origin/<lastBaseBranch>..HEAD`. `work submit` fetches `origin/<lastBaseBranch>` and permits an empty commit range only for a Story with a Salesforce Data Set or Data Template deployment step.
 
 ### Copado Cloud Flow
 
@@ -40,9 +40,9 @@ Cloud commit checks Story readiness and source credentials before submission. Av
 | --- | --- | --- |
 | `work list` | Find candidate stories | Use `--assigned-to-me`, `--status`, `--project-name`, `--name`, pagination flags. |
 | `work get [ID]` | Read story details | ID is optional after `work set`. Human output redacts OAuth signatures; JSON preserves structured fields. |
-| `work create` | Create a story | Use `--title`, project/team/assignee/theme fields, specs, and short acceptance criteria. |
-| `work update [ID]` | Mutate story fields or status | ID is optional after `work set`. Acceptance criteria must be fewer than 255 chars. |
-| `work set ID` | Mark active and prepare branch | Fetches base branch, creates/checks out `feature/<story-name>`, stores local context. `--none` clears every `last*` key and checks out `lastBaseBranch`, else `main`, else `master`. |
+| `work create` | Create a story | Use `--title`, project/team/assignee/theme fields, specs, and short acceptance criteria. `--source-credential` sends `sourceEnvironment` as null so Salesforce assigns the environment. |
+| `work update [ID]` | Mutate story fields or status | ID is optional after `work set`. Acceptance criteria must be fewer than 255 chars. `--source-credential` sends `sourceEnvironment` as null. |
+| `work set ID` | Mark active and prepare branch | Fetches base branch, creates/checks out `feature/<story-name>`, stores local context. Warns without PATCHing when the Story credential differs from the project default; use `work update --source-credential` to change it. `--none` clears every `last*` key and checks out `lastBaseBranch`, else `main`, else `master`. |
 | `work commit` | Local or cloud commit | The flag sets are disjoint. `--local` is default and performs no gateway call; `--cloud` calls Copado commit APIs and polls by default. |
 | `work push` | Push local commits and register with Copado | Requires active story context and clean tree. Sends stored retrieve-only permissions. |
 | `work test` | Run local quality gate scripts | `--local` is default. Runs `.agentia_quality_gates.sh` or `.agentia_quality_gates.cmd` from repo root. `--cloud` is not implemented yet. |