@copado/agentia-cli 1.1.0 → 1.3.0

package/CHANGELOG.md

@@ -4,18 +4,87 @@ All published sections are mapped to immutable npm publication metadata. New use
 
 ## [Unreleased]
 
+## [1.3.0] - 2026-11-03
+
+### Added
+
+- Experimental `agentia help-agent`, `agentia support`, and `agentia help --agent` start the same multi-turn Copado support conversation without an eager CICD credential preflight. Responses render as SSE deltas arrive. Every request obtains a fresh non-persisted HMAC, refreshes bounded runtime/recent-command context and dominant CLI/IDE/MCP usage, and sends a redacted digest of up to six successful prior messages. The system prompt asks one brief question when tooling or local-versus-cloud operations cannot be determined.
+- `agentia history list` and `agentia history clear` inspect or remove owner-private temporary history. Command history retains at most 100 sanitized CLI/IDE summaries or metadata-only MCP summaries. Successful Help Agent turn pairs are separately redacted, capped at 4 KiB per message, and retained for a rolling 24 hours/100 pairs without restoring them into later chats; `history clear --yes` deletes both stores.
+- Named CICD connections: `agentia auth set --cicd <key> --connection <name> [--kind sandbox|production]` stores an alternate Copado API key and endpoint without changing the active/default connection. Use `--cicd-connection <name>` only on `agentia cicd ...` commands (or `AGENTIA_CICD_CONNECTION`, or MCP `cicdConnection` on CICD tools) for that invocation only—not on `ai`, `adv`, `testing`, or `auth`. Production-tagged connections require confirmation (CLI), `--yes`, or `AGENTIA_CICD_ALLOW_PRODUCTION=true` (required for MCP). Combining a named connection with `AGENTIA_CICD_API_KEY` / `AGENTIA_CICD_BASE_URL` errors instead of silently choosing one. `auth get` lists named connections with masked keys; `auth unset --connection` removes one.
+- `cicd promotion queue list` and `cicd promotion queue remove` (MCP `agentia_promotion_queue_list`, `agentia_promotion_queue_remove`) show and clear the job queue of a promotion; removal requires the Manage Queue permission and `--yes` for headless runs.
+- `agentia testing browser view` provisions a session-scoped CRT user parameter (`agentia_cli_lt_<sessionId>`) for the web noVNC viewer and includes `projectId` and `orgId` in the `/browser/session/<sessionId>` viewer URL; `testing browser stop` deletes the parameter on teardown.
+- `agentia testing browser execute --stdin` reads Robot Framework lines or suite content from standard input; `testing browser history` adds `--lines-only`, `--keyword`, `--include-failed`, and `--job` while preserving 4-space Robot Framework argument separators and redacting `TypeSecret` values; `testing browser inspect --dom --json` returns raw DOM in JSON without requiring `--output`; and `testing browser recorder` adds `--force` and `--json`.
+- `agentia-testing` skill pack adds `references/browser-testing.md`, `references/flow-automation.md`, `references/qweb.md`, and `references/qforce.md`.
+
+### Changed
+
+- `cicd cloud promote` creates a forward Draft promotion for the User Story and adds it when no promotion contains the story, then runs it, instead of failing and requiring you to create the promotion by hand.
+- Rename `agentia testing live` commands to `agentia testing browser` (`start|stop|status|execute|inspect|screenshot|reports|set-options|history|view|recorder`) with hidden deprecated `testing live ...` CLI aliases, and replace `agentia_testing_live_*` MCP tools with `agentia_testing_browser_*`.
+
+### Removed
+
+- Remove unused `testing live continue` and `testing live interrupt` commands and their `agentia_testing_live_continue` / `agentia_testing_live_interrupt` MCP tools.
+
+### Fixed
+
+- MCP server and `testing job runs` commands failed to load in 1.2.0 packaged builds.
+
+## [1.2.0] - 2026-10-28
+
+### Added
+
+- `cicd metadata dependency list --path` (and MCP `agentia_metadata_dependency_list` `path`) resolves one or more local Salesforce source file paths into metadata selections via the existing SDR path helpers, then runs the same dependency gateway request with `localPaths` enrichment. Mutually exclusive with `--file`, `--stdin`, and `--from-changes`.
+- `cicd metadata dependency list` (and MCP `agentia_metadata_dependency_list`) resolves omitted `--pipeline-id`, `--source-credential-id`, `--source-org-id`, and `--platform-experience` from the active work item, then from project defaults for pipeline/credential/org. Platform falls back to `sfdx` when still unset. `--target-org-id` is never inferred.
+- 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.
+- `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.
+- `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.
+- `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.
+- `agentia cicd extension-configuration list|get|open` reads Copado extension configurations and opens them in the browser, with matching MCP list/get tools.
+- `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.
+- `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`.
+
+### Changed
+
+- `cicd metadata dependency list` human output is a single table with parent (evaluated metadata), relation (`used by` / `dependant`), name, type, and compare status field (status column omitted when absent, for example without a target org). Agentia metadata skill templates document `--path`, context defaults, and when to prefer the Copado dependency graph over Org Intelligence `find_references`.
+- Project Cursor rule `skill-management` (scoped to `src/commands`, `src/lib`, and `templates/skills`) requires updating `templates/skills` (and syncing installed skill copies) whenever CLI/MCP or agent workflow contracts change.
+- 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.
+- `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.
+- `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.
+- 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.
+- 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`.
+- `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.
+- `cicd work publish` (and `cicd work push`) sends nested metadata deletions in `changeListUpdate` as `Delete` instead of `Del`, matching the gateway action name.
+- `agentia setup` no longer asks for skill folders after declining skills when `AGENTS.md` still has a legacy Agentia section.
+- `agentia setup` `--skip-auth` help and descriptions mention Claude Code MCP alongside Cursor.
+- `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.
+- `cicd credential list` with optional `--name` and cursor pagination instead of requiring `--environmentid`.
+- `cicd credential update` and MCP `agentia_credential_update` no longer require an environment ID; they resolve environment and org type from the credential.
+- `cicd environment open` opens environments only; use `cicd credential open` for credentials.
+- `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.
+- 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.
+- `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'`.
+
+### Fixed
+
+- `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.
+- 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.
+- `cicd work deployment-step create` and its interactive wizard no longer accept or prompt for a queue name on Manual Task steps.
+
 ## [1.1.0] - 2026-10-21
 
 ### Added
 
 - `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.
 - `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.
+- `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`).
+- `cicd work environment-sync` stores `lastEnvironmentSyncName` so `--continue` / `--abort` can omit `--promotion`; cleared on successful sync, abort, and every `cicd work set`.
 
 ### Changed
 
 - `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`.
 - `agentia setup` asks before removing a legacy Agentia managed section from an existing `AGENTS.md`, and leaves the rest of that file unchanged.
 - `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.
+- `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.
 
 ### Fixed