@copado/agentia-cli 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (196) hide show
  1. package/CHANGELOG.md +40 -0
  2. package/README.md +2370 -1850
  3. package/dist/commands/ai/agent/ask.js +4 -4
  4. package/dist/commands/ai/agent/chat.js +4 -4
  5. package/dist/commands/cicd/credential/auth/status.js +38 -0
  6. package/dist/commands/cicd/credential/auth/web/login.js +54 -0
  7. package/dist/commands/cicd/credential/list.js +13 -17
  8. package/dist/commands/cicd/credential/open.js +30 -0
  9. package/dist/commands/cicd/credential/update.js +9 -12
  10. package/dist/commands/cicd/environment/auth/status.js +34 -13
  11. package/dist/commands/cicd/environment/auth/web/login.js +20 -4
  12. package/dist/commands/cicd/environment/open.js +6 -22
  13. package/dist/commands/cicd/extension-configuration/get.js +24 -0
  14. package/dist/commands/cicd/extension-configuration/list.js +49 -0
  15. package/dist/commands/cicd/extension-configuration/open.js +38 -0
  16. package/dist/commands/cicd/metadata/content/get.js +1 -1
  17. package/dist/commands/cicd/metadata/dependency/list.js +2 -2
  18. package/dist/commands/cicd/metadata/explore.js +81 -0
  19. package/dist/commands/cicd/metadata/list.js +3 -3
  20. package/dist/commands/cicd/metadata/refresh/deleted.js +1 -1
  21. package/dist/commands/cicd/metadata/refresh/run.js +2 -2
  22. package/dist/commands/cicd/metadata/refresh/status.js +2 -2
  23. package/dist/commands/cicd/pipeline/automation/activate.js +39 -0
  24. package/dist/commands/cicd/pipeline/automation/create.js +33 -0
  25. package/dist/commands/cicd/pipeline/automation/deactivate.js +39 -0
  26. package/dist/commands/cicd/pipeline/automation/delete.js +45 -0
  27. package/dist/commands/cicd/pipeline/automation/get.js +32 -0
  28. package/dist/commands/cicd/pipeline/automation/list.js +38 -0
  29. package/dist/commands/cicd/pipeline/automation/open.js +38 -0
  30. package/dist/commands/cicd/pipeline/automation/update.js +38 -0
  31. package/dist/commands/cicd/pipeline/quality-gate/activate.js +39 -0
  32. package/dist/commands/cicd/pipeline/quality-gate/create.js +34 -0
  33. package/dist/commands/cicd/pipeline/quality-gate/deactivate.js +39 -0
  34. package/dist/commands/cicd/pipeline/quality-gate/delete.js +45 -0
  35. package/dist/commands/cicd/pipeline/quality-gate/get.js +32 -0
  36. package/dist/commands/cicd/pipeline/quality-gate/list.js +34 -0
  37. package/dist/commands/cicd/pipeline/quality-gate/open.js +38 -0
  38. package/dist/commands/cicd/pipeline/quality-gate/update.js +38 -0
  39. package/dist/commands/cicd/work/create.js +1 -0
  40. package/dist/commands/cicd/work/environment-sync.js +8 -7
  41. package/dist/commands/cicd/work/set.js +6 -4
  42. package/dist/commands/cicd/work/submit.js +3 -2
  43. package/dist/commands/cicd/work/update.js +1 -0
  44. package/dist/commands/plugins/install.js +2 -5
  45. package/dist/commands/setup/skills/create.js +28 -2
  46. package/dist/commands/setup/skills/list.js +55 -0
  47. package/dist/commands/setup/skills/update.js +36 -3
  48. package/dist/commands/setup.js +3 -3
  49. package/dist/commands/testing/data-table/create.js +1 -2
  50. package/dist/commands/testing/data-table/delete.js +1 -2
  51. package/dist/commands/testing/data-table/export.js +2 -6
  52. package/dist/commands/testing/data-table/get.js +2 -4
  53. package/dist/commands/testing/data-table/list.js +1 -2
  54. package/dist/commands/testing/data-table/update.js +3 -4
  55. package/dist/commands/testing/job/create.js +26 -22
  56. package/dist/commands/testing/job/delete.js +2 -2
  57. package/dist/commands/testing/job/files/download.js +73 -0
  58. package/dist/commands/testing/job/files/list.js +43 -0
  59. package/dist/commands/testing/job/{upload.js → files/upload.js} +13 -9
  60. package/dist/commands/testing/job/get.js +2 -2
  61. package/dist/commands/testing/job/list.js +1 -1
  62. package/dist/commands/testing/job/refs.js +4 -4
  63. package/dist/commands/testing/job/run.js +134 -1
  64. package/dist/commands/testing/{build → job/runs}/abort.js +10 -8
  65. package/dist/commands/testing/job/runs/get.js +42 -0
  66. package/dist/commands/testing/{build → job/runs}/list.js +19 -10
  67. package/dist/commands/testing/{logs.js → job/runs/logs.js} +9 -6
  68. package/dist/commands/testing/{build → job/runs}/search.js +9 -7
  69. package/dist/commands/testing/job/schedule/get.js +5 -11
  70. package/dist/commands/testing/job/schedule/remove.js +3 -3
  71. package/dist/commands/testing/job/schedule/set.js +3 -3
  72. package/dist/commands/testing/job/update.js +22 -65
  73. package/dist/commands/testing/live/continue.js +5 -10
  74. package/dist/commands/testing/live/execute.js +3 -3
  75. package/dist/commands/testing/live/history.js +7 -2
  76. package/dist/commands/testing/live/inspect.js +5 -4
  77. package/dist/commands/testing/live/interrupt.js +5 -10
  78. package/dist/commands/testing/live/recorder.js +23 -115
  79. package/dist/commands/testing/live/reports.js +3 -3
  80. package/dist/commands/testing/live/screenshot.js +3 -3
  81. package/dist/commands/testing/live/set-options.js +11 -4
  82. package/dist/commands/testing/live/start.js +9 -4
  83. package/dist/commands/testing/live/status.js +2 -5
  84. package/dist/commands/testing/live/stop.js +3 -5
  85. package/dist/commands/testing/live/view.js +2 -2
  86. package/dist/commands/testing/project/create.js +1 -17
  87. package/dist/commands/testing/project/get.js +0 -1
  88. package/dist/commands/testing/project/list.js +2 -2
  89. package/dist/commands/testing/project/permission/set.js +3 -7
  90. package/dist/commands/testing/project/permission/update.js +2 -2
  91. package/dist/commands/testing/robot/create.js +22 -25
  92. package/dist/commands/testing/robot/get.js +1 -1
  93. package/dist/commands/testing/robot/list.js +3 -3
  94. package/dist/commands/testing/robot/update.js +3 -3
  95. package/dist/commands/testing/user-parameter/create.js +3 -9
  96. package/dist/commands/testing/user-parameter/update.js +1 -7
  97. package/dist/commands/testing/variable/create.js +4 -9
  98. package/dist/commands/testing/variable/list.js +3 -3
  99. package/dist/commands/testing/variable/update.js +5 -12
  100. package/dist/help.js +17 -0
  101. package/dist/lib/ai-types.js +2 -1
  102. package/dist/lib/claude-mcp-config.js +15 -0
  103. package/dist/lib/credential-sync.js +1 -2
  104. package/dist/lib/defaults-store.js +4 -1
  105. package/dist/lib/environment-auth-status.js +2 -1
  106. package/dist/lib/environment-auth.js +2 -1
  107. package/dist/lib/environment-credential-flags.js +3 -1
  108. package/dist/lib/environment-credential-operations.js +8 -2
  109. package/dist/lib/environment-types.js +3 -1
  110. package/dist/lib/extension-configuration-ops.js +4 -0
  111. package/dist/lib/extension-configuration-sanitize.js +7 -0
  112. package/dist/lib/extension-configuration-types.js +8 -0
  113. package/dist/lib/http-proxy.js +13 -0
  114. package/dist/lib/mcp/ai-tools.js +3 -3
  115. package/dist/lib/mcp/command-id.js +2 -0
  116. package/dist/lib/mcp/pipeline-automation-quality-tools.js +452 -0
  117. package/dist/lib/mcp/server.js +70 -1
  118. package/dist/lib/mcp/testing-live-tools.js +24 -13
  119. package/dist/lib/mcp/testing-tools.js +239 -550
  120. package/dist/lib/mcp/tool-annotations.js +27 -18
  121. package/dist/lib/mcp/tools.js +117 -32
  122. package/dist/lib/mcp/work-tools.js +18 -4
  123. package/dist/lib/metadata-explore.js +8 -0
  124. package/dist/lib/network-error.js +8 -0
  125. package/dist/lib/pipeline-automation-flags.js +12 -0
  126. package/dist/lib/pipeline-automation-ops.js +9 -0
  127. package/dist/lib/pipeline-automation-types.js +18 -0
  128. package/dist/lib/pipeline-lifecycle-id.js +3 -0
  129. package/dist/lib/pipeline-quality-gate-flags.js +12 -0
  130. package/dist/lib/pipeline-quality-gate-ops.js +9 -0
  131. package/dist/lib/pipeline-quality-gate-types.js +17 -0
  132. package/dist/lib/plugin-host/ai.js +2 -1
  133. package/dist/lib/plugin-skills.js +22 -0
  134. package/dist/lib/plugin-trust/gate.js +1 -2
  135. package/dist/lib/project-root.js +3 -1
  136. package/dist/lib/runtime.js +1 -1
  137. package/dist/lib/salesforce-tooling-check.js +6 -0
  138. package/dist/lib/skill-packs.js +7 -0
  139. package/dist/lib/testing-archive.js +9 -0
  140. package/dist/lib/testing-data-table.js +39 -0
  141. package/dist/lib/testing-execution.js +22 -0
  142. package/dist/lib/testing-flags.js +6 -2
  143. package/dist/lib/testing-gateway.js +4 -1
  144. package/dist/lib/testing-live-command.js +3 -1
  145. package/dist/lib/testing-live-operations.js +7 -1
  146. package/dist/lib/testing-live-recorder.js +3 -1
  147. package/dist/lib/testing-live-state.js +8 -1
  148. package/dist/lib/testing-operations.js +6 -21
  149. package/dist/lib/testing-sanitization.js +2 -1
  150. package/dist/lib/testing-secret-input.js +2 -1
  151. package/dist/lib/testing-types.js +24 -3
  152. package/dist/lib/work-environment-sync.js +3 -1
  153. package/dist/lib/work-flags.js +6 -1
  154. package/dist/lib/work-local-development-flow.js +4 -0
  155. package/dist/lib/work-submit-wait.js +3 -1
  156. package/oclif.manifest.json +6609 -6895
  157. package/package.json +35 -2
  158. package/templates/skills/agentia-ai/SKILL.md +3 -4
  159. package/templates/skills/agentia-ai/references/ai-agents.md +2 -2
  160. package/templates/skills/agentia-cicd/SKILL.md +7 -4
  161. package/templates/skills/agentia-cicd/references/environments-and-credentials.md +19 -13
  162. package/templates/skills/agentia-cicd/references/extensions.md +3 -0
  163. package/templates/skills/agentia-cicd/references/pipelines.md +36 -2
  164. package/templates/skills/agentia-cicd/references/work.md +20 -5
  165. package/templates/skills/agentia-metadata/SKILL.md +140 -0
  166. package/templates/skills/agentia-metadata/references/metadata-explore.md +142 -0
  167. package/templates/skills/agentia-testing/SKILL.md +3 -3
  168. package/templates/skills/agentia-testing/references/tests.md +14 -14
  169. package/dist/commands/testing/build/get.js +0 -38
  170. package/dist/commands/testing/build/latest.js +0 -40
  171. package/dist/commands/testing/build/logs.js +0 -47
  172. package/dist/commands/testing/build/run.js +0 -26
  173. package/dist/commands/testing/create.js +0 -2
  174. package/dist/commands/testing/job/download.js +0 -54
  175. package/dist/commands/testing/job/files.js +0 -34
  176. package/dist/commands/testing/run.js +0 -26
  177. package/dist/commands/testing/status.js +0 -45
  178. package/dist/commands/testing/test/create.js +0 -2
  179. package/dist/commands/testing/test/logs.js +0 -2
  180. package/dist/commands/testing/test/run.js +0 -26
  181. package/dist/commands/testing/test/status.js +0 -2
  182. package/dist/commands/testing/test/update.js +0 -2
  183. package/dist/commands/testing/update.js +0 -65
  184. package/dist/lib/testing-data-command.js +0 -8
  185. package/dist/lib/testing-data-core.js +0 -20
  186. package/dist/lib/testing-data-export.js +0 -6
  187. package/dist/lib/testing-data-import.js +0 -6
  188. package/dist/lib/testing-data-io.js +0 -12
  189. package/dist/lib/testing-data-operations.js +0 -10
  190. package/dist/lib/testing-data-types.js +0 -4
  191. package/dist/lib/testing-live-endpoints.js +0 -6
  192. package/dist/lib/testing-live-history.js +0 -7
  193. package/dist/lib/testing-run-command.js +0 -3
  194. package/dist/lib/testing-schedule.js +0 -5
  195. package/dist/lib/testing-session.js +0 -5
  196. package/dist/lib/testing-watch.js +0 -4
package/CHANGELOG.md CHANGED
@@ -4,18 +4,58 @@ All published sections are mapped to immutable npm publication metadata. New use
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ ## [1.2.0] - 2026-10-28
8
+
9
+ ### Added
10
+
11
+ - Automatic proxy support: Agentia honors `HTTPS_PROXY`, `HTTP_PROXY`, `NO_PROXY`, and npm-style proxy environment variables on CICD, AI, CRT, Pipelines Advanced, version check, plugin trust, and CRT live WebSocket traffic, with proxy-aware transport errors and masked proxy credentials in debug output.
12
+ - `cicd work get`, `cicd work create`, and `cicd work update` (and MCP `agentia_work_get`, `agentia_work_create`, `agentia_work_update`) support subscriber User Story `customFields`: get surfaces the gateway read DTOs in human and `--json` output; create/update accept writes via repeatable `--custom-field ApiName=value`, and MCP accepts the same data as a `customFields` array.
13
+ - `cicd metadata explore` (experimental; MCP `agentia_metadata_explore`) explores Salesforce metadata through Org Intelligence. `agentia setup` can install the `agentia-metadata` skill for agent workflows.
14
+ - `agentia cicd pipeline automation` and `agentia cicd pipeline quality-gate` manage Copado pipeline automation rules and quality gates (list, get, create, update, delete, activate, deactivate, open), with matching MCP tools.
15
+ - `agentia cicd extension-configuration list|get|open` reads Copado extension configurations and opens them in the browser, with matching MCP list/get tools.
16
+ - `agentia setup` writes Claude Code project `.mcp.json` and enables the `agentia` server in `.claude/settings.local.json`, using `AGENTIA_PROJECT_ROOT=${CLAUDE_PROJECT_DIR:-}` so Claude expands the project directory at runtime.
17
+ - `cicd credential open`, `cicd credential auth status`, and `cicd credential auth web login` operate on a credential ID without requiring an environment ID. MCP adds `agentia_credential_auth_status`.
18
+
19
+ ### Changed
20
+
21
+ - Consolidate Copado Robotic Testing job definitions, files, and runs under `agentia testing job`: `testing job create|update|run|list|get|delete|refs`, `testing job files list|upload|download`, `testing job runs list|search|get|logs|abort`, and `testing job schedule get|set|remove`. Older `testing create|update|status|logs|run`, `testing test ...`, `testing build ...`, and `testing job files|upload|download` forms remain as hidden deprecated aliases that print a migration warning.
22
+ - `testing job run` now waits for a terminal CRT build result and streams sanitized Robot Framework logs by default in human output (printing `Run ID:` and a `Run is queued...` progress indicator while queued, treating `finished` as a transitional status during polling, and exiting nonzero when the run does not succeed unless `--no-exit-code` is set). Use `--no-wait` to return once queued (`--wait-for-result` is a deprecated alias for `--wait`), or `--no-stream-logs` to show a spinner instead; `--datatable` batch runs never wait, `--save-artifacts` and `--xunit` require waiting, and `--json` never streams.
23
+ - `testing job runs get` fetches the full build record in human output so the summary includes xUnit test totals, while `--json` continues to return the compact record unless `--full` is passed.
24
+ - Rename CRT file and run MCP tools to `agentia_testing_job_files_list`, `agentia_testing_job_files_upload`, `agentia_testing_job_files_download`, `agentia_testing_job_runs_list`, `agentia_testing_job_runs_get`, `agentia_testing_job_runs_search`, `agentia_testing_job_runs_logs`, and `agentia_testing_job_runs_abort`, and remove duplicate `agentia_testing_build_*`, `agentia_testing_create|update|run|status|logs`, and `agentia_testing_job_files|upload|download` tools.
25
+ - Remove `testing job run --watch`. `testing project create` always creates project type `ta` and no longer accepts `--type`, `--executor`, or `--dashboard-id`. Job create and update use `--show-video-params` / `--no-show-video-params` in place of `--hide-video-params`.
26
+ - `agentia_testing_job_run` still does not wait unless `waitForResult` or `streamLogs` is set, and it rejects those options on data-driven runs. The CLI waits by default and skips waiting for `--datatable` batches.
27
+ - `cicd work publish` (and `cicd work push`) sends nested metadata deletions in `changeListUpdate` as `Delete` instead of `Del`, matching the gateway action name.
28
+ - `agentia setup` no longer asks for skill folders after declining skills when `AGENTS.md` still has a legacy Agentia section.
29
+ - `agentia setup` `--skip-auth` help and descriptions mention Claude Code MCP alongside Cursor.
30
+ - `agentia setup` prints a yellow, non-blocking warning when the Salesforce CLI (`sf`) or the recommended Salesforce Skills are not installed, with the `sf` install command and links to the Copado docs and the Salesforce Skills site.
31
+ - `cicd credential list` with optional `--name` and cursor pagination instead of requiring `--environmentid`.
32
+ - `cicd credential update` and MCP `agentia_credential_update` no longer require an environment ID; they resolve environment and org type from the credential.
33
+ - `cicd environment open` opens environments only; use `cicd credential open` for credentials.
34
+ - `cicd environment auth status` and `cicd environment auth web login` (and MCP `agentia_environment_auth_status`) accept `--credentialid` / `credentialId` without an environment ID and resolve the environment from the credential.
35
+ - Installed plugins can contribute agent skills through an `agentia:contribute` hook. `agentia setup skills list` shows what plugins offer and why invalid skills are skipped, interactive `setup skills create` lets you tick plugin skills (none preselected), `setup skills create|update --plugin <name>` installs them headless, and `setup skills update` refreshes plugin skills already in the project and warns about skills whose plugin was removed; `setup skills update --prune` deletes those orphaned plugin skills. Plugin skills are Markdown only and validated before install.
36
+ - `agentia ai agent ask|chat` and MCP `agentia_ai_ask` default to the Orchestrate agent, which routes work to the right specialist; `--agent` is optional and still accepts `plan`, `build`, `test`, `release`, `operate`, or `knowledge`. The plugin SDK `host.ai.ask` follows the same default; plugins that need the previous behavior pass `agent: 'knowledge'`.
37
+
38
+ ### Fixed
39
+
40
+ - `cicd work set` (and MCP `agentia_work_set`) no longer warns about a missing CICD project default credential when the User Story already has a source credential. When the Story is unbound, the warning points at `work update --source-credential` instead of implying that setting a project default alone binds the Story.
41
+ - TLS and other network transport failures during CICD, AI, CRT, and Pipelines Advanced auth, setup, discovery, and gateway requests now surface the OpenSSL or errno code with a clear network/certificate diagnosis instead of a generic “credentials could not be validated” message. Issuer and self-signed certificate failures include the `NODE_USE_SYSTEM_CA=1` workaround.
42
+ - `cicd work deployment-step create` and its interactive wizard no longer accept or prompt for a queue name on Manual Task steps.
43
+
7
44
  ## [1.1.0] - 2026-10-21
8
45
 
9
46
  ### Added
10
47
 
11
48
  - `agentia cicd extension create|validate|package|publish|install|uninstall` packages Copado CICD extensions as git-hosted bundles (`copado/extension_manifest.json`, functions, job templates, optional `force-app`), publishes annotated semver tags (including `--local` offline tags), installs from a git URL or local path, and uninstalls by deleting listed assets. Function and job-template file upserts pass through unknown custom fields.
12
49
  - `cicd work get` accepts `--committed-metadata` (MCP `committedMetadata`) to fetch Copado committed metadata for the user story in parallel and include it in human and `--json` output.
50
+ - `agentia cicd work --help` and `cicd work set|publish|submit --help` document the local development flow (`set` → commit → `test` → `publish` → `submit` → optional `environment-sync` → `submit --done`).
51
+ - `cicd work environment-sync` stores `lastEnvironmentSyncName` so `--continue` / `--abort` can omit `--promotion`; cleared on successful sync, abort, and every `cicd work set`.
13
52
 
14
53
  ### Changed
15
54
 
16
55
  - `agentia setup` and `agentia setup skills create|update` install target-specific Agentia routing artifacts (Cursor rules, a Claude routing skill, or a portable routing skill) instead of synchronizing customer root `AGENTS.md`.
17
56
  - `agentia setup` asks before removing a legacy Agentia managed section from an existing `AGENTS.md`, and leaves the rest of that file unchanged.
18
57
  - `cicd cloud commit` (and the hidden `cicd work commit` alias) requires a metadata category: `--metadata-category` for simple flag input, and `c` / `category` on each change for JSON/`--file`/`--stdin` and MCP. Use `SFDX` for Salesforce metadata.
58
+ - `cicd work submit` / `--done` / `--deploy` (and MCP equivalents) stop before calling the gateway when the related Commit job ends in `Error` or `Failed`, instead of continuing into an empty Draft promotion.
19
59
 
20
60
  ### Fixed
21
61