@copado/agentia-cli 0.85.0-alpha.0 → 0.87.0-alpha.0

package/oclif.manifest.json

@@ -3255,6 +3255,118 @@
         "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",
+          "name": "destination-type",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "user",
+            "channel"
+          ],
+          "type": "option"
+        },
+        "event": {
+          "description": "Notification event",
+          "name": "event",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "Promotion_Success",
+            "Promotion_Failed",
+            "Promotion_Conflict",
+            "Failed_Promotion_Creation",
+            "Deploy_Success",
+            "Deploy_Failed",
+            "Commit_Failed",
+            "Successful_Snapshot",
+            "Failed_Snapshot",
+            "ManualTask_Assigned",
+            "Test_Success",
+            "Test_Failed",
+            "Test_Cancelled",
+            "Test_Not Started",
+            "Quality_Gate_Success",
+            "Quality_Gate_Failed",
+            "Quality_Gate_Cancelled",
+            "Quality_Gate_Not Started",
+            "Create_Package_Success",
+            "Create_Package_Failure",
+            "Generate_Package_Version_Success",
+            "Generate_Package_Version_Failure",
+            "Import_Package_Success",
+            "Import_Package_Failure",
+            "Publish_Package_Success",
+            "Publish_Package_Failure"
+          ],
+          "type": "option"
+        },
+        "pipeline-id": {
+          "char": "p",
+          "description": "Copado pipeline Salesforce Id",
+          "name": "pipeline-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "subscription": {
+          "description": "Notification audience for this event",
+          "name": "subscription",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "user",
+            "all"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:notification:configure",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "notification",
+        "configure.js"
+      ]
+    },
     "cicd:pipeline:create": {
       "aliases": [],
       "args": {
@@ -6294,6 +6406,164 @@
         "update.js"
       ]
     },
+    "setup:skills:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create portable Markdown-only Agentia CLI skills in this project without overwriting managed files",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --cicd --target agents --no-prompt",
+        "<%= config.bin %> <%= command.id %> --testing --ai --target cursor --no-prompt",
+        "<%= config.bin %> <%= command.id %> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "ai": {
+          "description": "Create the Copado AI agent skill pack",
+          "name": "ai",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "cicd": {
+          "description": "Create the Copado CICD skill pack",
+          "name": "cicd",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "description": "Replace conflicting unmanaged Agentia skill files",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-prompt": {
+          "char": "n",
+          "description": "Skip interactive prompts; defaults the target to .agents/skills when --target is omitted",
+          "name": "no-prompt",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "target": {
+          "description": "Project skill root to write",
+          "name": "target",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "agents",
+            "cursor",
+            "claude"
+          ],
+          "type": "option"
+        },
+        "testing": {
+          "description": "Create the Copado Robotic Testing skill pack",
+          "name": "testing",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "setup:skills:create",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "setup",
+        "skills",
+        "create.js"
+      ]
+    },
+    "setup:skills:update": {
+      "aliases": [],
+      "args": {},
+      "description": "Update Agentia-managed Markdown skill files and restore missing files in this project",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --ai --target cursor --no-prompt",
+        "<%= config.bin %> <%= command.id %> --cicd --testing --target agents --no-prompt",
+        "<%= config.bin %> <%= command.id %> --force --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "ai": {
+          "description": "Update the Copado AI agent skill pack",
+          "name": "ai",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "cicd": {
+          "description": "Update the Copado CICD skill pack",
+          "name": "cicd",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "description": "Replace conflicting unmanaged Agentia skill files",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-prompt": {
+          "char": "n",
+          "description": "Skip interactive prompts; defaults the target to .agents/skills when --target is omitted",
+          "name": "no-prompt",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "target": {
+          "description": "Project skill root to write",
+          "name": "target",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "agents",
+            "cursor",
+            "claude"
+          ],
+          "type": "option"
+        },
+        "testing": {
+          "description": "Update the Copado Robotic Testing skill pack",
+          "name": "testing",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "setup:skills:update",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "setup",
+        "skills",
+        "update.js"
+      ]
+    },
     "testing:build:abort": {
       "aliases": [],
       "args": {
@@ -9355,102 +9625,6 @@
         "list.js"
       ]
     },
-    "cicd:data:commit:create": {
-      "aliases": [],
-      "args": {},
-      "description": "Create a data commit for a user story",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --file commit.json",
-        "<%= config.bin %> <%= command.id %> --stdin --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "file": {
-          "char": "f",
-          "description": "Path to a JSON file body",
-          "exclusive": [
-            "stdin"
-          ],
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stdin": {
-          "description": "Read the JSON body from stdin",
-          "exclusive": [
-            "file"
-          ],
-          "name": "stdin",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cicd:data:commit:create",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "data",
-        "commit",
-        "create.js"
-      ]
-    },
-    "cicd:data:commit:list": {
-      "aliases": [],
-      "args": {
-        "userStoryId": {
-          "description": "User story Id",
-          "name": "userStoryId",
-          "required": true
-        }
-      },
-      "description": "List data commits for a user story",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> a16P7000006AyU5IAK",
-        "<%= config.bin %> <%= command.id %> a16P7000006AyU5IAK --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cicd:data:commit:list",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "data",
-        "commit",
-        "list.js"
-      ]
-    },
     "cicd:data:dataset-file:content": {
       "aliases": [],
       "args": {
@@ -12754,6 +12928,102 @@
         "unresolve.js"
       ]
     },
+    "cicd:data:commit:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a data commit for a user story",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --file commit.json",
+        "<%= config.bin %> <%= command.id %> --stdin --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "file": {
+          "char": "f",
+          "description": "Path to a JSON file body",
+          "exclusive": [
+            "stdin"
+          ],
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stdin": {
+          "description": "Read the JSON body from stdin",
+          "exclusive": [
+            "file"
+          ],
+          "name": "stdin",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:data:commit:create",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "data",
+        "commit",
+        "create.js"
+      ]
+    },
+    "cicd:data:commit:list": {
+      "aliases": [],
+      "args": {
+        "userStoryId": {
+          "description": "User story Id",
+          "name": "userStoryId",
+          "required": true
+        }
+      },
+      "description": "List data commits for a user story",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> a16P7000006AyU5IAK",
+        "<%= config.bin %> <%= command.id %> a16P7000006AyU5IAK --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:data:commit:list",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "data",
+        "commit",
+        "list.js"
+      ]
+    },
     "cicd:work:deployment-step:create": {
       "aliases": [],
       "args": {},
@@ -13470,5 +13740,5 @@
       ]
     }
   },
-  "version": "0.85.0-alpha.0"
+  "version": "0.87.0-alpha.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@copado/agentia-cli",
   "description": "Command-line interface for Agentia",
-  "version": "0.85.0-alpha.0",
+  "version": "0.87.0-alpha.0",
   "author": "Copado Solutions",
   "bin": {
     "agentia": "./bin/run.js"
@@ -44,6 +44,7 @@
     "./bin",
     "./dist",
     "./oclif.manifest.json",
+    "./templates",
     "./vendor/java"
   ],
   "homepage": "https://github.com/Copado/agentia-cli",
@@ -180,9 +181,18 @@
       "cicd:promotion:conflict": {
         "description": "Manage Copado promotion conflicts"
       },
+      "cicd:notification": {
+        "description": "Configure Copado notification subscriptions"
+      },
       "mcp": {
         "description": "Start a local Model Context Protocol server for MCP-compatible clients"
       },
+      "setup": {
+        "description": "Prepare Agentia local project assets"
+      },
+      "setup:skills": {
+        "description": "Create and update Agentia Agent Skills"
+      },
       "testing": {
         "description": "Manage Copado Robotic Testing projects, tests, runs, logs, and variables"
       }

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

@@ -0,0 +1,34 @@
+---
+name: agentia-ai
+description: Use this skill when prompting Copado AI agents through the Agentia CLI or MCP, including `agentia ai agent ask`, `agentia ai agent chat`, Plan, Build, Test, Release, Operate, Knowledge, workspace, dialogue, user story, Salesforce org, and component context.
+---
+
+<!-- Agentia managed skill file: agentia setup skills -->
+
+# Agentia AI
+
+Use this skill to ask Copado AI agents through Agentia with the right agent selector, workspace context, and output mode.
+
+Prefer the `agentia_ai_ask` MCP tool when it is available for single-turn prompts. Use CLI examples as the fallback. Use `agentia ai agent chat` only for interactive terminal sessions.
+
+## Start Here
+
+1. Confirm AI auth with `agentia auth get --ai --json`, or provide `--pat`, `--domain`, `--org`, and optional `--gateway-url`.
+2. Choose exactly one agent selector for `ask`: `--plan`, `--build`, `--test`, `--release`, `--operate`, or `--knowledge`.
+3. Add useful context flags when available: `--workspace`, `--dialogue`, `--user-story`, `--sf-org`, and `--component`.
+4. Use `--json` for automation. Use `--no-stream` when the caller needs a buffered response.
+
+## Reference
+
+- Copado AI agent prompts, chat sessions, workspace context, MCP parity, and gotchas: [references/ai-agents.md](references/ai-agents.md)
+
+## General Rules
+
+- Keep prompts specific and include IDs or names read from Copado or the local project.
+- Use the Knowledge agent for Copado AI Knowledge grounding and product questions.
+- Use the Plan, Build, Test, Release, and Operate agents according to the lifecycle intent.
+- Do not paste PATs or secrets into prompts.
+
+## Report Back
+
+Report the selected AI agent, workspace/dialogue identifiers when returned, whether the response was streamed or buffered, and any follow-up action. Do not include secrets.

package/templates/skills/agentia-ai/references/ai-agents.md

@@ -0,0 +1,70 @@
+<!-- Agentia managed skill file: agentia setup skills -->
+
+# AI Agents Reference
+
+Use this reference for `agentia ai agent ask`, `agentia ai agent chat`, and the matching `agentia_ai_ask` MCP tool.
+
+## Authentication And Context
+
+Configure AI once:
+
+```sh
+agentia auth set --ai --ai-domain <domain> --ai-org <organization-id> --ai-workspace <workspace-id>
+agentia auth get --ai --json
+```
+
+Per-command overrides include `--pat`, `--domain`, `--org`, `--workspace`, `--gateway-url`, and `--timeout`. Do not print PAT values.
+
+## Agent Selectors
+
+| Selector | Use For |
+| --- | --- |
+| `--plan` | Break requirements into delivery plans and acceptance criteria. |
+| `--build` | Implementation guidance, code-level questions, and construction tasks. |
+| `--test` | Test strategy, regression selection, and test troubleshooting. |
+| `--release` | Release, promotion, packaging, and deployment questions. |
+| `--operate` | Operational diagnostics, monitoring, and runbook style questions. |
+| `--knowledge` | Copado AI Knowledge grounding, product documentation, personas, and troubleshooting. |
+| `--orchestrate` | Chat-only orchestration mode for interactive sessions. |
+
+Choose one selector that matches the user's intent. `ask` requires a prompt with `-p` or `--prompt`; `chat` is TTY-only and prompts interactively.
+
+## Single-Turn Ask
+
+Use `ask` for automation and agent-to-agent workflows:
+
+```sh
+agentia ai agent ask --plan -p "Break this user story into implementation steps" --json
+agentia ai agent ask --knowledge -p "Summarize Copado guidance for data template sync" --no-stream --json
+agentia ai agent ask --build --user-story US-1042 --component AccountService -p "Review the implementation approach" --json
+```
+
+MCP `agentia_ai_ask` mirrors the buffered JSON-safe ask flow. It does not provide interactive chat.
+
+## Interactive Chat
+
+Use `chat` only when a human is present in a terminal:
+
+```sh
+agentia ai agent chat --build --user-story US-1042
+agentia ai agent chat --orchestrate --workspace <workspace-id>
+```
+
+Chat creates or reuses one dialogue for the session and supports session slash commands. It is not suitable for headless JSON workflows.
+
+## Workspace And Quota Helpers
+
+Use these adjacent commands when the prompt workflow needs context setup:
+
+| Command | Use For |
+| --- | --- |
+| `ai workspace list|get|create|update` | Inspect or manage Copado AI workspaces. |
+| `ai workspace member list|invite` | Inspect or invite workspace members. |
+| `ai quota get` | Check organization quota before large AI activity. |
+
+## Gotchas
+
+- `--workspace` selects the workspace; `--dialogue` reuses a conversation inside that workspace.
+- `--user-story`, `--sf-org`, and `--component` enrich prompt context but do not replace a clear prompt.
+- Streaming is human-friendly. For tools, CI, or follow-up parsing, use `--json` and consider `--no-stream`.
+- `chat` has no MCP equivalent and should not be used in non-interactive shells.

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

@@ -0,0 +1,41 @@
+---
+name: agentia-cicd
+description: Use this skill when managing Copado CICD work with the Agentia CLI or Agentia MCP tools: user stories, work commit/push/submit/done, promotion runs and conflicts, job executions, environments, credentials, pipelines, stages, and release data templates. Use it whenever the user asks an agent to operate Copado CICD from a terminal, IDE, or headless workflow.
+---
+
+<!-- Agentia managed skill file: agentia setup skills -->
+
+# Agentia CICD
+
+Use this skill to operate Copado CICD through Agentia without guessing command order, IDs, or JSON fields.
+
+Prefer Agentia MCP tools when they are available and match the task. Use CLI examples as the fallback, and add `--json` whenever the result will be parsed or reused.
+
+## Start Here
+
+1. Confirm `agentia auth get --cicd --json` is configured, or that the current process supplies `AGENTIA_CICD_API_KEY` and `AGENTIA_CICD_BASE_URL`.
+2. Identify the domain below and read only the matching reference file.
+3. Before mutating data, read the target record first with the matching `get`, `list`, or `status` command.
+4. Never print credentials, PATs, OAuth signatures, or unmasked environment variables.
+
+## References
+
+- User stories, local commits, cloud commits, push, submit, done, quality gates, and deployment steps: [references/work.md](references/work.md)
+- Promotion lookup, run, resume, merge conflicts, and story-centric promotion: [references/promotions.md](references/promotions.md)
+- Copado JobExecution lookup, actions, logs, and monitoring: [references/jobs.md](references/jobs.md)
+- Copado environments, environment credentials, and browser authentication: [references/environments-and-credentials.md](references/environments-and-credentials.md)
+- Pipelines, environment connections, stages, and stage connections: [references/pipelines.md](references/pipelines.md)
+- Release data templates, records, matching, sync, dataset files, and data commits: [references/data.md](references/data.md)
+
+## General Rules
+
+- 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`.
+- 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.
+
+## Report Back
+
+When you finish a CICD operation, report the command path used, target IDs or names, final status, whether JSON was used, and any remaining manual action. Do not include secrets.