@copado/agentia-cli 0.91.0-alpha.0 → 0.93.0-alpha.0

package/oclif.manifest.json

@@ -3,7 +3,7 @@
     "setup": {
       "aliases": [],
       "args": {},
-      "description": "Prepare this machine and the current project for Agentia. Guides CICD 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. 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 %> --no-prompt",
@@ -152,17 +152,17 @@
       "args": {},
       "description": "Store authentication credentials securely in the system keychain",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --ai-pak <pak> --ai-domain robotic.copado.com --ai-org 42888",
-        "<%= config.bin %> <%= command.id %> --ai-pak <pak> --ai-domain robotic.copado.com --ai-org 42888 --ai-workspace 42d0b908-37b7-4565-9ec9-86eda40c9782",
-        "<%= config.bin %> <%= command.id %> --ai-pak <pak> --ai-gateway-url http://localhost:8080/organizations/42888",
+        "<%= config.bin %> <%= command.id %> --ai <pak> --ai-domain robotic.copado.com --ai-org 42888",
+        "<%= config.bin %> <%= command.id %> --ai <pak> --ai-domain robotic.copado.com --ai-org 42888 --ai-workspace 42d0b908-37b7-4565-9ec9-86eda40c9782",
+        "<%= config.bin %> <%= command.id %> --ai <pak> --ai-gateway-url http://localhost:8080/organizations/42888",
         "<%= config.bin %> <%= command.id %> --ai-workspace 42d0b908-37b7-4565-9ec9-86eda40c9782",
         "<%= config.bin %> <%= command.id %> --cicd <copado-api-key> --region na",
         "<%= config.bin %> <%= command.id %> --cicd <copado-api-key> --custom-url https://dev.api.copado.com",
         "<%= config.bin %> <%= command.id %> --cicd <copado-api-key>",
-        "<%= config.bin %> <%= command.id %> --crt-pak <pak>",
-        "<%= config.bin %> <%= command.id %> --crt-pak <pak> --crt-org <crt-org-id>",
-        "<%= config.bin %> <%= command.id %> --crt-pak <pak> --crt-domain robotic.copado.com --crt-org <crt-org-id>",
-        "<%= config.bin %> <%= command.id %> --cicd <copado-api-key> --region na --crt-pak <pak>",
+        "<%= config.bin %> <%= command.id %> --crt <pak>",
+        "<%= config.bin %> <%= command.id %> --crt <pak> --crt-org <crt-org-id>",
+        "<%= config.bin %> <%= command.id %> --crt <pak> --crt-domain robotic.copado.com --crt-org <crt-org-id>",
+        "<%= config.bin %> <%= command.id %> --cicd <copado-api-key> --region na --crt <pak>",
         "<%= config.bin %> <%= command.id %> --cicd <copado-api-key> --region na --json"
       ],
       "flags": {
@@ -174,7 +174,7 @@
           "type": "boolean"
         },
         "ai": {
-          "description": "Deprecated alias for --ai-pak (Copado AI PAK)",
+          "description": "PAK for Copado AI authentication",
           "name": "ai",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -201,13 +201,6 @@
           "multiple": false,
           "type": "option"
         },
-        "ai-pak": {
-          "description": "PAK for Copado AI authentication",
-          "name": "ai-pak",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "ai-workspace": {
           "description": "Copado AI workspace UUID to validate and store as the default",
           "name": "ai-workspace",
@@ -223,7 +216,7 @@
           "type": "option"
         },
         "crt": {
-          "description": "Deprecated alias for --crt-pak (CRT PAK)",
+          "description": "PAK for CRT authentication",
           "name": "crt",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -243,13 +236,6 @@
           "multiple": false,
           "type": "option"
         },
-        "crt-pak": {
-          "description": "PAK for CRT authentication",
-          "name": "crt-pak",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "custom-url": {
           "description": "CICD gateway base URL used instead of regional mapping",
           "name": "custom-url",
@@ -257,6 +243,12 @@
           "multiple": false,
           "type": "option"
         },
+        "local": {
+          "description": "Store authentication for the current project and user.",
+          "name": "local",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "region": {
           "description": "CICD region used to resolve the gateway endpoint",
           "name": "region",
@@ -326,6 +318,18 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "global": {
+          "description": "Remove global authentication (the default scope).",
+          "name": "global",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "local": {
+          "description": "Remove authentication for the current project and user.",
+          "name": "local",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "yes": {
           "char": "y",
           "description": "Confirm removal without prompting (required for --json)",
@@ -5207,50 +5211,6 @@
         "update.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,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "user",
-        "get.js"
-      ]
-    },
     "cicd:work:commit": {
       "aliases": [],
       "args": {
@@ -5340,7 +5300,7 @@
           "type": "option"
         },
         "full-metadata": {
-          "description": "Local commit only. Comma-separated type-prefixed metadata such as Profile:Sales_User,PermissionSet:Sales_Onboarding, stored as lastFullMetadataSelected and sent as the `cicd work push` fullMetadata list. The named metadata is committed as a complete file, so every permission it contains is applied instead of only the permissions selected with --permissions. Pass an empty value to clear it.",
+          "description": "Local commit only. Comma-separated type-prefixed metadata such as Profile:Sales_User,PermissionSet:Sales_Onboarding, stored as lastFullMetadataSelected and sent as `cicd work push` fullMetadata corrections. The named metadata is committed as a complete file, so every permission it contains is applied instead of only the permissions selected with --permissions. Pass an empty value to clear it.",
           "name": "full-metadata",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -5396,7 +5356,7 @@
           "type": "option"
         },
         "permissions": {
-          "description": "Local commit only. Comma-separated type-prefixed metadata such as CustomField:Account.SLA__c,ApexClass:AccountService, stored as lastPermissionSelected and sent as the `cicd work push` retrieveOnly list. The named metadata is not committed or deployed; it filters which permissions are updated inside the committed permission sets and profiles so other permissions are not overwritten. Pass an empty value to clear it.",
+          "description": "Local commit only. Comma-separated type-prefixed metadata such as CustomField:Account.SLA__c,ApexClass:AccountService, stored as lastPermissionSelected and sent as `cicd work push` RetrieveOnly corrections. The named metadata is not committed or deployed; it filters which permissions are updated inside the committed permission sets and profiles so other permissions are not overwritten. Pass an empty value to clear it.",
           "name": "permissions",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -5723,8 +5683,9 @@
     "cicd:work:done": {
       "aliases": [],
       "args": {},
-      "description": "Mark the current feature/<lastWorkItem> work item done and promote it to the next environment. Pushes and registers commits when the branch is ahead of origin, then calls headless work/done (Promote Action with validate=false).",
+      "description": "Alias of cicd work submit --done. Matches Copado UI Submit when promoting (not validate-only). Prefer: agentia cicd work submit --done.",
       "examples": [
+        "<%= config.bin %> cicd work submit --done",
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --skip-nested-metadata-detection",
         "<%= config.bin %> <%= command.id %> --json"
@@ -6073,7 +6034,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`. 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 lastPermissionSelected and --permissions plus the nested metadata of the changed profiles and permission sets as the retrieveOnly list, lastFullMetadataSelected and --full-metadata as the fullMetadata list, the ignored parents as removeMetadataItems and the remaining nested metadata as addMetadataItems, then merges the feature branch into the recorded dev org branch.",
+      "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`. 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",
@@ -6090,14 +6051,14 @@
           "type": "boolean"
         },
         "full-metadata": {
-          "description": "Comma-separated type-prefixed metadata such as Profile:Sales_User,PermissionSet:Sales_Onboarding, added to lastFullMetadataSelected for this push and sent as the headless push fullMetadata list. The named metadata is committed as a complete file, so it is never decomposed into nested metadata. Not stored; use `cicd work commit --full-metadata` to record it.",
+          "description": "Comma-separated type-prefixed metadata such as Profile:Sales_User,PermissionSet:Sales_Onboarding, added to lastFullMetadataSelected for this push and sent as headless push fullMetadata corrections. The named metadata is committed as a complete file, so it is never decomposed into nested metadata. Not stored; use `cicd work commit --full-metadata` to record it.",
           "name": "full-metadata",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "permissions": {
-          "description": "Comma-separated type-prefixed metadata such as CustomField:Account.SLA__c,ApexClass:AccountService, added to lastPermissionSelected for this push and sent as part of the headless push retrieveOnly list. Not stored; use `cicd work commit --permissions` to record it.",
+          "description": "Comma-separated type-prefixed metadata such as CustomField:Account.SLA__c,ApexClass:AccountService, added to lastPermissionSelected for this push and sent as headless push RetrieveOnly corrections. Not stored; use `cicd work commit --permissions` to record it.",
           "name": "permissions",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -6219,12 +6180,14 @@
     "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).",
+      "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). With --done, 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",
         "<%= config.bin %> <%= command.id %> --skip-local-tests",
         "<%= config.bin %> <%= command.id %> --skip-pull-request",
+        "<%= config.bin %> <%= command.id %> --done",
+        "<%= config.bin %> <%= command.id %> --done --skip-nested-metadata-detection",
         "<%= config.bin %> <%= command.id %> --json"
       ],
       "flags": {
@@ -6235,6 +6198,12 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "skip-nested-metadata-detection": {
+          "description": "Do not detect the nested metadata changed across the branch when pushing (also configurable via skipNestedMetadataDetection in .agentia/config.json or .agentia/config.user.json)",
+          "name": "skip-nested-metadata-detection",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "apex-test-classes": {
           "description": "Comma-separated Apex test class names passed to local quality gates as AGENTIA_APEX_TEST_CLASSES",
           "name": "apex-test-classes",
@@ -6242,15 +6211,15 @@
           "multiple": false,
           "type": "option"
         },
-        "skip-local-tests": {
-          "description": "Skip running local quality gates scripts in the project root",
-          "name": "skip-local-tests",
+        "done": {
+          "description": "Promote instead of validate-only (Copado UI Submit promote); honors --skip-nested-metadata-detection",
+          "name": "done",
           "allowNo": false,
           "type": "boolean"
         },
-        "skip-nested-metadata-detection": {
-          "description": "Do not detect the nested metadata changed across the branch when pushing (also configurable via skipNestedMetadataDetection in .agentia/config.json or .agentia/config.user.json)",
-          "name": "skip-nested-metadata-detection",
+        "skip-local-tests": {
+          "description": "Skip running local quality gates scripts in the project root",
+          "name": "skip-local-tests",
           "allowNo": false,
           "type": "boolean"
         },
@@ -13390,6 +13359,50 @@
         "unresolve.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,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "user",
+        "get.js"
+      ]
+    },
     "cicd:work:deployment-step:create": {
       "aliases": [],
       "args": {},
@@ -14106,5 +14119,5 @@
       ]
     }
   },
-  "version": "0.91.0-alpha.0"
+  "version": "0.93.0-alpha.0"
 }

package/package.json

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

package/templates/skills/agentia-cicd/SKILL.md

@@ -31,7 +31,7 @@ Prefer Agentia MCP tools when they are available and match the task. Use CLI exa
 
 - Use Salesforce record IDs or generated names read from Copado. Do not invent story names, promotion IDs, job IDs, credential IDs, or pipeline IDs.
 - Keep human output off stdout in JSON workflows. Prefer `--json`, then parse the result object.
-- For local project work, keep the tracked working tree clean before commands that require it: `work set`, `work push`, `work submit`, and `work done`.
+- For local project work, keep the tracked working tree clean before commands that require it: `work set`, `work push`, and `work submit`.
 - Treat `cicd job` as Copado CICD JobExecution. It is different from CRT `testing job`.
 - Treat `cicd work test --local` as local quality gates. It is different from CRT `testing test run`.
 - Treat `auth` credentials as keychain/API credentials and `cicd credential` records as Copado environment credentials.

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

@@ -10,7 +10,7 @@ Use this reference for `agentia cicd promotion ...`, `agentia cicd promotion con
 | --- | --- | --- |
 | `agentia cicd promotion run <promotion-id>` | Promotion ID | You already know the Promotion record and want explicit merge or merge-and-deploy control. |
 | `agentia cicd work promote [story-id] --cloud` | User Story | You want Agentia to resolve the story's Promotion before running it. |
-| `agentia cicd work done` | Active User Story branch | The story is approved and should move to the next stage through the normal work lifecycle. |
+| `agentia cicd work submit --done` | Active User Story branch | The story is approved and should move to the next stage (Copado UI Submit promote). |
 
 Prefer `work promote` when the user talks about a story. Prefer `promotion run` when the user provides a Promotion ID.
 

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

@@ -2,7 +2,7 @@
 
 # CICD Work Reference
 
-Use this reference for `agentia cicd work ...` and matching MCP tools such as `agentia_work_get`, `agentia_work_commit`, `agentia_work_push`, `agentia_work_submit`, and `agentia_work_done`.
+Use this reference for `agentia cicd work ...` and matching MCP tools such as `agentia_work_get`, `agentia_work_commit`, `agentia_work_push`, and `agentia_work_submit`.
 
 ## Workflow
 
@@ -14,9 +14,9 @@ Use this reference for `agentia cicd work ...` and matching MCP tools such as `a
    - Copado cloud metadata: `agentia cicd work commit <story-id> --cloud --metadata-name <name> --metadata-type <type> --metadata-category SFDX --json`
 5. Register local commits: `agentia cicd work push --json`
 6. Validate and submit: `agentia cicd work submit --json`
-7. Promote only on explicit approval: `agentia cicd work done --json`
+7. Promote only on explicit approval: `agentia cicd work submit --done --json`
 
-`work set`, `work push`, `work submit`, and `work done` expect a clean tracked working tree and the active story context recorded by `work set`.
+`work set`, `work push`, and `work submit` expect a clean tracked working tree and the active story context recorded by `work set`.
 
 ## Core Commands
 
@@ -30,10 +30,9 @@ Use this reference for `agentia cicd work ...` and matching MCP tools such as `a
 | `work commit` | Local or cloud commit | `--local` is default; `--cloud` calls Copado commit APIs and can poll a job. |
 | `work push` | Push local commits and register with Copado | Requires active story context and clean tree. Sends stored retrieve-only permissions. |
 | `work test --local` | Run local quality gate scripts | Runs `.agentia_quality_gates.sh` or `.agentia_quality_gates.cmd` from repo root. |
-| `work submit` | Submit for review/validation | Runs local gates unless `--skip-local-tests`; can push ahead commits. |
-| `work done` | Promote after approval | Pushes if needed, then promotes without validate-only behavior. |
+| `work submit` | Submit for review/validation or promote | Runs local gates unless `--skip-local-tests`; can push ahead commits. `--done` matches Copado UI Submit when promoting. |
 | `work promote` | Story-centric promotion run | Requires `--cloud`; use `--deploy` for merge and deploy. |
-| `work status [ID]` | Check story and related executions | Useful after submit, done, promote, or commit jobs. |
+| `work status [ID]` | Check story and related executions | Useful after submit, promote, or commit jobs. |
 | `work open [ID]` | Open story in browser | CLI-only browser helper. |
 
 ## Local Commit Path
@@ -79,6 +78,6 @@ Prefer explicit flags for standard step types. Use `--config-json`, `--file`, or
 ## Gotchas
 
 - `work test --local` is not CRT. For Robot Framework execution, use the `agentia-testing` skill.
-- `work submit` and `work done` may push ahead commits, but `work set` is still required first.
-- `work done` promotes/deploys. Do not run it unless the user explicitly asked to promote or finish the story.
+- `work submit` may push ahead commits, but `work set` is still required first.
+- `work submit --done` promotes/deploys. Do not run it unless the user explicitly asked to promote or finish the story.
 - `work delete` is destructive; read the story and confirm intent first.